From 81fb86626e96c779f892bc7273391cf4820f37a7 Mon Sep 17 00:00:00 2001 From: Victor Vobis Date: Mon, 23 Feb 2026 12:45:51 +0000 Subject: [PATCH] Fixing CORS issues --- env/bin/Activate.ps1 | 247 + env/bin/activate | 76 + env/bin/activate.csh | 27 + env/bin/activate.fish | 69 + env/bin/pip | 8 + env/bin/pip3 | 8 + env/bin/pip3.12 | 8 + env/bin/pygmentize | 8 + env/bin/python | 1 + env/bin/python3 | 1 + env/bin/python3.12 | 1 + .../INSTALLER | 1 + .../aiohappyeyeballs-2.6.1.dist-info/LICENSE | 279 + .../aiohappyeyeballs-2.6.1.dist-info/METADATA | 123 + .../aiohappyeyeballs-2.6.1.dist-info/RECORD | 16 + .../aiohappyeyeballs-2.6.1.dist-info/WHEEL | 4 + .../aiohappyeyeballs/__init__.py | 14 + .../aiohappyeyeballs/_staggered.py | 207 + .../site-packages/aiohappyeyeballs/impl.py | 259 + .../site-packages/aiohappyeyeballs/py.typed | 0 .../site-packages/aiohappyeyeballs/types.py | 17 + .../site-packages/aiohappyeyeballs/utils.py | 97 + .../aiohttp-3.13.3.dist-info/INSTALLER | 1 + .../aiohttp-3.13.3.dist-info/METADATA | 262 + .../aiohttp-3.13.3.dist-info/RECORD | 139 + .../aiohttp-3.13.3.dist-info/REQUESTED | 0 .../aiohttp-3.13.3.dist-info/WHEEL | 5 + .../licenses/LICENSE.txt | 13 + .../licenses/vendor/llhttp/LICENSE | 22 + .../aiohttp-3.13.3.dist-info/top_level.txt | 1 + .../aiohttp/.hash/_cparser.pxd.hash | 1 + .../aiohttp/.hash/_find_header.pxd.hash | 1 + .../aiohttp/.hash/_http_parser.pyx.hash | 1 + .../aiohttp/.hash/_http_writer.pyx.hash | 1 + .../site-packages/aiohttp/.hash/hdrs.py.hash | 1 + .../site-packages/aiohttp/__init__.py | 278 + .../site-packages/aiohttp/_cookie_helpers.py | 338 + .../site-packages/aiohttp/_cparser.pxd | 158 + .../site-packages/aiohttp/_find_header.pxd | 2 + .../site-packages/aiohttp/_headers.pxi | 83 + ...tp_parser.cpython-312-x86_64-linux-musl.so | Bin 0 -> 2110720 bytes .../site-packages/aiohttp/_http_parser.pyx | 835 ++ ...tp_writer.cpython-312-x86_64-linux-musl.so | Bin 0 -> 397960 bytes .../site-packages/aiohttp/_http_writer.pyx | 162 + .../aiohttp/_websocket/.hash/mask.pxd.hash | 1 + .../aiohttp/_websocket/.hash/mask.pyx.hash | 1 + .../_websocket/.hash/reader_c.pxd.hash | 1 + .../aiohttp/_websocket/__init__.py | 1 + .../aiohttp/_websocket/helpers.py | 147 + .../mask.cpython-312-x86_64-linux-musl.so | Bin 0 -> 204904 bytes .../site-packages/aiohttp/_websocket/mask.pxd | 3 + .../site-packages/aiohttp/_websocket/mask.pyx | 48 + .../aiohttp/_websocket/models.py | 84 + .../aiohttp/_websocket/reader.py | 31 + .../reader_c.cpython-312-x86_64-linux-musl.so | Bin 0 -> 1289680 bytes .../aiohttp/_websocket/reader_c.pxd | 110 + .../aiohttp/_websocket/reader_c.py | 478 + .../aiohttp/_websocket/reader_py.py | 478 + .../aiohttp/_websocket/writer.py | 262 + .../python3.12/site-packages/aiohttp/abc.py | 268 + .../site-packages/aiohttp/base_protocol.py | 100 + .../site-packages/aiohttp/client.py | 1635 +++ .../aiohttp/client_exceptions.py | 421 + .../aiohttp/client_middleware_digest_auth.py | 480 + .../aiohttp/client_middlewares.py | 55 + .../site-packages/aiohttp/client_proto.py | 359 + .../site-packages/aiohttp/client_reqrep.py | 1536 +++ .../site-packages/aiohttp/client_ws.py | 428 + .../aiohttp/compression_utils.py | 348 + .../site-packages/aiohttp/connector.py | 1842 ++++ .../site-packages/aiohttp/cookiejar.py | 522 + .../site-packages/aiohttp/formdata.py | 179 + .../python3.12/site-packages/aiohttp/hdrs.py | 121 + .../site-packages/aiohttp/helpers.py | 986 ++ .../python3.12/site-packages/aiohttp/http.py | 72 + .../site-packages/aiohttp/http_exceptions.py | 116 + .../site-packages/aiohttp/http_parser.py | 1086 ++ .../site-packages/aiohttp/http_websocket.py | 36 + .../site-packages/aiohttp/http_writer.py | 378 + .../python3.12/site-packages/aiohttp/log.py | 8 + .../site-packages/aiohttp/multipart.py | 1152 +++ .../site-packages/aiohttp/payload.py | 1120 +++ .../site-packages/aiohttp/payload_streamer.py | 78 + .../python3.12/site-packages/aiohttp/py.typed | 1 + .../site-packages/aiohttp/pytest_plugin.py | 444 + .../site-packages/aiohttp/resolver.py | 274 + .../site-packages/aiohttp/streams.py | 758 ++ .../site-packages/aiohttp/tcp_helpers.py | 37 + .../site-packages/aiohttp/test_utils.py | 774 ++ .../site-packages/aiohttp/tracing.py | 455 + .../site-packages/aiohttp/typedefs.py | 69 + .../python3.12/site-packages/aiohttp/web.py | 592 ++ .../site-packages/aiohttp/web_app.py | 620 ++ .../site-packages/aiohttp/web_exceptions.py | 452 + .../site-packages/aiohttp/web_fileresponse.py | 418 + .../site-packages/aiohttp/web_log.py | 216 + .../site-packages/aiohttp/web_middlewares.py | 121 + .../site-packages/aiohttp/web_protocol.py | 792 ++ .../site-packages/aiohttp/web_request.py | 914 ++ .../site-packages/aiohttp/web_response.py | 856 ++ .../site-packages/aiohttp/web_routedef.py | 214 + .../site-packages/aiohttp/web_runner.py | 399 + .../site-packages/aiohttp/web_server.py | 84 + .../aiohttp/web_urldispatcher.py | 1305 +++ .../site-packages/aiohttp/web_ws.py | 631 ++ .../site-packages/aiohttp/worker.py | 255 + .../aiosignal-1.4.0.dist-info/INSTALLER | 1 + .../aiosignal-1.4.0.dist-info/METADATA | 112 + .../aiosignal-1.4.0.dist-info/RECORD | 9 + .../aiosignal-1.4.0.dist-info/WHEEL | 5 + .../licenses/LICENSE | 201 + .../aiosignal-1.4.0.dist-info/top_level.txt | 1 + .../site-packages/aiosignal/__init__.py | 59 + .../site-packages/aiosignal/py.typed | 0 .../python3.12/site-packages/attr/__init__.py | 104 + .../site-packages/attr/__init__.pyi | 389 + env/lib/python3.12/site-packages/attr/_cmp.py | 160 + .../python3.12/site-packages/attr/_cmp.pyi | 13 + .../python3.12/site-packages/attr/_compat.py | 99 + .../python3.12/site-packages/attr/_config.py | 31 + .../python3.12/site-packages/attr/_funcs.py | 497 + .../python3.12/site-packages/attr/_make.py | 3362 +++++++ .../site-packages/attr/_next_gen.py | 674 ++ .../site-packages/attr/_typing_compat.pyi | 15 + .../site-packages/attr/_version_info.py | 89 + .../site-packages/attr/_version_info.pyi | 9 + .../site-packages/attr/converters.py | 162 + .../site-packages/attr/converters.pyi | 19 + .../site-packages/attr/exceptions.py | 95 + .../site-packages/attr/exceptions.pyi | 17 + .../python3.12/site-packages/attr/filters.py | 72 + .../python3.12/site-packages/attr/filters.pyi | 6 + .../python3.12/site-packages/attr/py.typed | 0 .../python3.12/site-packages/attr/setters.py | 79 + .../python3.12/site-packages/attr/setters.pyi | 20 + .../site-packages/attr/validators.py | 748 ++ .../site-packages/attr/validators.pyi | 140 + .../attrs-25.4.0.dist-info/INSTALLER | 1 + .../attrs-25.4.0.dist-info/METADATA | 235 + .../attrs-25.4.0.dist-info/RECORD | 55 + .../attrs-25.4.0.dist-info/WHEEL | 4 + .../attrs-25.4.0.dist-info/licenses/LICENSE | 21 + .../site-packages/attrs/__init__.py | 72 + .../site-packages/attrs/__init__.pyi | 314 + .../site-packages/attrs/converters.py | 3 + .../site-packages/attrs/exceptions.py | 3 + .../python3.12/site-packages/attrs/filters.py | 3 + .../python3.12/site-packages/attrs/py.typed | 0 .../python3.12/site-packages/attrs/setters.py | 3 + .../site-packages/attrs/validators.py | 3 + .../backcall-0.2.0.dist-info/INSTALLER | 1 + .../backcall-0.2.0.dist-info/LICENSE | 27 + .../backcall-0.2.0.dist-info/METADATA | 55 + .../backcall-0.2.0.dist-info/RECORD | 11 + .../backcall-0.2.0.dist-info/WHEEL | 5 + .../site-packages/backcall/__init__.py | 7 + .../site-packages/backcall/_signatures.py | 819 ++ .../site-packages/backcall/backcall.py | 109 + .../docopt-0.6.2.dist-info/INSTALLER | 1 + .../docopt-0.6.2.dist-info/METADATA | 476 + .../docopt-0.6.2.dist-info/RECORD | 8 + .../docopt-0.6.2.dist-info/WHEEL | 6 + .../licenses/LICENSE-MIT | 19 + .../docopt-0.6.2.dist-info/top_level.txt | 1 + env/lib/python3.12/site-packages/docopt.py | 579 ++ .../fastjsonschema-2.21.2.dist-info/INSTALLER | 1 + .../fastjsonschema-2.21.2.dist-info/METADATA | 63 + .../fastjsonschema-2.21.2.dist-info/RECORD | 27 + .../fastjsonschema-2.21.2.dist-info/WHEEL | 5 + .../licenses/AUTHORS | 11 + .../licenses/LICENSE | 27 + .../top_level.txt | 1 + .../site-packages/fastjsonschema/__init__.py | 277 + .../site-packages/fastjsonschema/__main__.py | 19 + .../site-packages/fastjsonschema/draft04.py | 618 ++ .../site-packages/fastjsonschema/draft06.py | 188 + .../site-packages/fastjsonschema/draft07.py | 116 + .../fastjsonschema/exceptions.py | 51 + .../site-packages/fastjsonschema/generator.py | 353 + .../site-packages/fastjsonschema/indent.py | 28 + .../fastjsonschema/ref_resolver.py | 178 + .../site-packages/fastjsonschema/version.py | 1 + .../frozenlist-1.8.0.dist-info/INSTALLER | 1 + .../frozenlist-1.8.0.dist-info/METADATA | 672 ++ .../frozenlist-1.8.0.dist-info/RECORD | 12 + .../frozenlist-1.8.0.dist-info/WHEEL | 5 + .../licenses/LICENSE | 201 + .../frozenlist-1.8.0.dist-info/top_level.txt | 1 + .../site-packages/frozenlist/__init__.py | 86 + .../site-packages/frozenlist/__init__.pyi | 47 + ...rozenlist.cpython-312-x86_64-linux-musl.so | Bin 0 -> 585104 bytes .../site-packages/frozenlist/_frozenlist.pyx | 148 + .../site-packages/frozenlist/py.typed | 1 + .../idna-3.11.dist-info/INSTALLER | 1 + .../idna-3.11.dist-info/METADATA | 209 + .../site-packages/idna-3.11.dist-info/RECORD | 22 + .../site-packages/idna-3.11.dist-info/WHEEL | 4 + .../idna-3.11.dist-info/licenses/LICENSE.md | 31 + .../python3.12/site-packages/idna/__init__.py | 45 + .../python3.12/site-packages/idna/codec.py | 122 + .../python3.12/site-packages/idna/compat.py | 15 + env/lib/python3.12/site-packages/idna/core.py | 437 + .../python3.12/site-packages/idna/idnadata.py | 4309 ++++++++ .../site-packages/idna/intranges.py | 57 + .../site-packages/idna/package_data.py | 1 + .../python3.12/site-packages/idna/py.typed | 0 .../site-packages/idna/uts46data.py | 8841 +++++++++++++++++ .../multidict-6.7.1.dist-info/INSTALLER | 1 + .../multidict-6.7.1.dist-info/METADATA | 149 + .../multidict-6.7.1.dist-info/RECORD | 16 + .../multidict-6.7.1.dist-info/WHEEL | 5 + .../licenses/LICENSE | 13 + .../multidict-6.7.1.dist-info/top_level.txt | 1 + .../site-packages/multidict/__init__.py | 60 + .../site-packages/multidict/_abc.py | 73 + .../site-packages/multidict/_compat.py | 15 + ...multidict.cpython-312-x86_64-linux-musl.so | Bin 0 -> 608848 bytes .../site-packages/multidict/_multidict_py.py | 1242 +++ .../site-packages/multidict/py.typed | 1 + .../DESCRIPTION.rst | 27 + .../pickleshare-0.7.5.dist-info/INSTALLER | 1 + .../pickleshare-0.7.5.dist-info/METADATA | 43 + .../pickleshare-0.7.5.dist-info/RECORD | 9 + .../pickleshare-0.7.5.dist-info/WHEEL | 6 + .../pickleshare-0.7.5.dist-info/metadata.json | 1 + .../pickleshare-0.7.5.dist-info/top_level.txt | 1 + .../python3.12/site-packages/pickleshare.py | 352 + .../pip-25.0.1.dist-info/AUTHORS.txt | 806 ++ .../pip-25.0.1.dist-info/INSTALLER | 1 + .../pip-25.0.1.dist-info/LICENSE.txt | 20 + .../pip-25.0.1.dist-info/METADATA | 90 + .../site-packages/pip-25.0.1.dist-info/RECORD | 854 ++ .../pip-25.0.1.dist-info/REQUESTED | 0 .../site-packages/pip-25.0.1.dist-info/WHEEL | 5 + .../pip-25.0.1.dist-info/entry_points.txt | 3 + .../pip-25.0.1.dist-info/top_level.txt | 1 + .../python3.12/site-packages/pip/__init__.py | 13 + .../python3.12/site-packages/pip/__main__.py | 24 + .../site-packages/pip/__pip-runner__.py | 50 + .../site-packages/pip/_internal/__init__.py | 18 + .../site-packages/pip/_internal/build_env.py | 322 + .../site-packages/pip/_internal/cache.py | 290 + .../pip/_internal/cli/__init__.py | 4 + .../pip/_internal/cli/autocompletion.py | 176 + .../pip/_internal/cli/base_command.py | 240 + .../pip/_internal/cli/cmdoptions.py | 1075 ++ .../pip/_internal/cli/command_context.py | 27 + .../pip/_internal/cli/index_command.py | 171 + .../site-packages/pip/_internal/cli/main.py | 80 + .../pip/_internal/cli/main_parser.py | 134 + .../site-packages/pip/_internal/cli/parser.py | 294 + .../pip/_internal/cli/progress_bars.py | 94 + .../pip/_internal/cli/req_command.py | 329 + .../pip/_internal/cli/spinners.py | 159 + .../pip/_internal/cli/status_codes.py | 6 + .../pip/_internal/commands/__init__.py | 132 + .../pip/_internal/commands/cache.py | 228 + .../pip/_internal/commands/check.py | 67 + .../pip/_internal/commands/completion.py | 130 + .../pip/_internal/commands/configuration.py | 280 + .../pip/_internal/commands/debug.py | 201 + .../pip/_internal/commands/download.py | 146 + .../pip/_internal/commands/freeze.py | 109 + .../pip/_internal/commands/hash.py | 59 + .../pip/_internal/commands/help.py | 41 + .../pip/_internal/commands/index.py | 139 + .../pip/_internal/commands/inspect.py | 92 + .../pip/_internal/commands/install.py | 784 ++ .../pip/_internal/commands/list.py | 375 + .../pip/_internal/commands/search.py | 172 + .../pip/_internal/commands/show.py | 224 + .../pip/_internal/commands/uninstall.py | 114 + .../pip/_internal/commands/wheel.py | 182 + .../pip/_internal/configuration.py | 383 + .../pip/_internal/distributions/__init__.py | 21 + .../pip/_internal/distributions/base.py | 53 + .../pip/_internal/distributions/installed.py | 29 + .../pip/_internal/distributions/sdist.py | 158 + .../pip/_internal/distributions/wheel.py | 42 + .../site-packages/pip/_internal/exceptions.py | 809 ++ .../pip/_internal/index/__init__.py | 2 + .../pip/_internal/index/collector.py | 494 + .../pip/_internal/index/package_finder.py | 1029 ++ .../pip/_internal/index/sources.py | 284 + .../pip/_internal/locations/__init__.py | 456 + .../pip/_internal/locations/_distutils.py | 172 + .../pip/_internal/locations/_sysconfig.py | 214 + .../pip/_internal/locations/base.py | 81 + .../site-packages/pip/_internal/main.py | 12 + .../pip/_internal/metadata/__init__.py | 128 + .../pip/_internal/metadata/_json.py | 86 + .../pip/_internal/metadata/base.py | 688 ++ .../_internal/metadata/importlib/__init__.py | 6 + .../_internal/metadata/importlib/_compat.py | 85 + .../_internal/metadata/importlib/_dists.py | 228 + .../pip/_internal/metadata/importlib/_envs.py | 189 + .../pip/_internal/metadata/pkg_resources.py | 301 + .../pip/_internal/models/__init__.py | 2 + .../pip/_internal/models/candidate.py | 25 + .../pip/_internal/models/direct_url.py | 224 + .../pip/_internal/models/format_control.py | 78 + .../pip/_internal/models/index.py | 28 + .../_internal/models/installation_report.py | 56 + .../pip/_internal/models/link.py | 604 ++ .../pip/_internal/models/scheme.py | 25 + .../pip/_internal/models/search_scope.py | 127 + .../pip/_internal/models/selection_prefs.py | 53 + .../pip/_internal/models/target_python.py | 121 + .../pip/_internal/models/wheel.py | 118 + .../pip/_internal/network/__init__.py | 2 + .../pip/_internal/network/auth.py | 566 ++ .../pip/_internal/network/cache.py | 118 + .../pip/_internal/network/download.py | 187 + .../pip/_internal/network/lazy_wheel.py | 210 + .../pip/_internal/network/session.py | 523 + .../pip/_internal/network/utils.py | 98 + .../pip/_internal/network/xmlrpc.py | 62 + .../pip/_internal/operations/__init__.py | 0 .../_internal/operations/build/__init__.py | 0 .../operations/build/build_tracker.py | 138 + .../_internal/operations/build/metadata.py | 39 + .../operations/build/metadata_editable.py | 42 + .../operations/build/metadata_legacy.py | 74 + .../pip/_internal/operations/build/wheel.py | 37 + .../operations/build/wheel_editable.py | 46 + .../operations/build/wheel_legacy.py | 102 + .../pip/_internal/operations/check.py | 181 + .../pip/_internal/operations/freeze.py | 256 + .../_internal/operations/install/__init__.py | 2 + .../operations/install/editable_legacy.py | 47 + .../pip/_internal/operations/install/wheel.py | 741 ++ .../pip/_internal/operations/prepare.py | 732 ++ .../site-packages/pip/_internal/pyproject.py | 185 + .../pip/_internal/req/__init__.py | 90 + .../pip/_internal/req/constructors.py | 560 ++ .../pip/_internal/req/req_file.py | 623 ++ .../pip/_internal/req/req_install.py | 934 ++ .../pip/_internal/req/req_set.py | 82 + .../pip/_internal/req/req_uninstall.py | 633 ++ .../pip/_internal/resolution/__init__.py | 0 .../pip/_internal/resolution/base.py | 20 + .../_internal/resolution/legacy/__init__.py | 0 .../_internal/resolution/legacy/resolver.py | 597 ++ .../resolution/resolvelib/__init__.py | 0 .../_internal/resolution/resolvelib/base.py | 139 + .../resolution/resolvelib/candidates.py | 574 ++ .../resolution/resolvelib/factory.py | 823 ++ .../resolution/resolvelib/found_candidates.py | 174 + .../resolution/resolvelib/provider.py | 258 + .../resolution/resolvelib/reporter.py | 81 + .../resolution/resolvelib/requirements.py | 245 + .../resolution/resolvelib/resolver.py | 317 + .../pip/_internal/self_outdated_check.py | 252 + .../pip/_internal/utils/__init__.py | 0 .../pip/_internal/utils/_jaraco_text.py | 109 + .../site-packages/pip/_internal/utils/_log.py | 38 + .../pip/_internal/utils/appdirs.py | 52 + .../pip/_internal/utils/compat.py | 79 + .../pip/_internal/utils/compatibility_tags.py | 188 + .../pip/_internal/utils/datetime.py | 11 + .../pip/_internal/utils/deprecation.py | 124 + .../pip/_internal/utils/direct_url_helpers.py | 87 + .../pip/_internal/utils/egg_link.py | 80 + .../pip/_internal/utils/entrypoints.py | 84 + .../pip/_internal/utils/filesystem.py | 149 + .../pip/_internal/utils/filetypes.py | 27 + .../pip/_internal/utils/glibc.py | 101 + .../pip/_internal/utils/hashes.py | 147 + .../pip/_internal/utils/logging.py | 354 + .../site-packages/pip/_internal/utils/misc.py | 773 ++ .../pip/_internal/utils/packaging.py | 58 + .../pip/_internal/utils/retry.py | 42 + .../pip/_internal/utils/setuptools_build.py | 146 + .../pip/_internal/utils/subprocess.py | 245 + .../pip/_internal/utils/temp_dir.py | 296 + .../pip/_internal/utils/unpacking.py | 337 + .../site-packages/pip/_internal/utils/urls.py | 55 + .../pip/_internal/utils/virtualenv.py | 104 + .../pip/_internal/utils/wheel.py | 134 + .../pip/_internal/vcs/__init__.py | 15 + .../site-packages/pip/_internal/vcs/bazaar.py | 112 + .../site-packages/pip/_internal/vcs/git.py | 527 + .../pip/_internal/vcs/mercurial.py | 163 + .../pip/_internal/vcs/subversion.py | 324 + .../pip/_internal/vcs/versioncontrol.py | 688 ++ .../pip/_internal/wheel_builder.py | 354 + .../site-packages/pip/_vendor/__init__.py | 116 + .../pip/_vendor/cachecontrol/__init__.py | 29 + .../pip/_vendor/cachecontrol/_cmd.py | 70 + .../pip/_vendor/cachecontrol/adapter.py | 161 + .../pip/_vendor/cachecontrol/cache.py | 75 + .../_vendor/cachecontrol/caches/__init__.py | 8 + .../_vendor/cachecontrol/caches/file_cache.py | 182 + .../cachecontrol/caches/redis_cache.py | 48 + .../pip/_vendor/cachecontrol/controller.py | 500 + .../pip/_vendor/cachecontrol/filewrapper.py | 119 + .../pip/_vendor/cachecontrol/heuristics.py | 157 + .../pip/_vendor/cachecontrol/py.typed | 0 .../pip/_vendor/cachecontrol/serialize.py | 146 + .../pip/_vendor/cachecontrol/wrapper.py | 43 + .../pip/_vendor/certifi/__init__.py | 4 + .../pip/_vendor/certifi/__main__.py | 12 + .../pip/_vendor/certifi/cacert.pem | 4929 +++++++++ .../site-packages/pip/_vendor/certifi/core.py | 114 + .../pip/_vendor/certifi/py.typed | 0 .../pip/_vendor/distlib/__init__.py | 33 + .../pip/_vendor/distlib/compat.py | 1137 +++ .../pip/_vendor/distlib/database.py | 1329 +++ .../pip/_vendor/distlib/index.py | 508 + .../pip/_vendor/distlib/locators.py | 1295 +++ .../pip/_vendor/distlib/manifest.py | 384 + .../pip/_vendor/distlib/markers.py | 162 + .../pip/_vendor/distlib/metadata.py | 1031 ++ .../pip/_vendor/distlib/resources.py | 358 + .../pip/_vendor/distlib/scripts.py | 447 + .../site-packages/pip/_vendor/distlib/t32.exe | Bin 0 -> 97792 bytes .../pip/_vendor/distlib/t64-arm.exe | Bin 0 -> 182784 bytes .../site-packages/pip/_vendor/distlib/t64.exe | Bin 0 -> 108032 bytes .../site-packages/pip/_vendor/distlib/util.py | 1984 ++++ .../pip/_vendor/distlib/version.py | 750 ++ .../site-packages/pip/_vendor/distlib/w32.exe | Bin 0 -> 91648 bytes .../pip/_vendor/distlib/w64-arm.exe | Bin 0 -> 168448 bytes .../site-packages/pip/_vendor/distlib/w64.exe | Bin 0 -> 101888 bytes .../pip/_vendor/distlib/wheel.py | 1100 ++ .../pip/_vendor/distro/__init__.py | 54 + .../pip/_vendor/distro/__main__.py | 4 + .../pip/_vendor/distro/distro.py | 1403 +++ .../site-packages/pip/_vendor/distro/py.typed | 0 .../pip/_vendor/idna/__init__.py | 45 + .../site-packages/pip/_vendor/idna/codec.py | 122 + .../site-packages/pip/_vendor/idna/compat.py | 15 + .../site-packages/pip/_vendor/idna/core.py | 437 + .../pip/_vendor/idna/idnadata.py | 4243 ++++++++ .../pip/_vendor/idna/intranges.py | 57 + .../pip/_vendor/idna/package_data.py | 1 + .../site-packages/pip/_vendor/idna/py.typed | 0 .../pip/_vendor/idna/uts46data.py | 8681 ++++++++++++++++ .../pip/_vendor/msgpack/__init__.py | 55 + .../pip/_vendor/msgpack/exceptions.py | 48 + .../site-packages/pip/_vendor/msgpack/ext.py | 170 + .../pip/_vendor/msgpack/fallback.py | 929 ++ .../pip/_vendor/packaging/__init__.py | 15 + .../pip/_vendor/packaging/_elffile.py | 110 + .../pip/_vendor/packaging/_manylinux.py | 263 + .../pip/_vendor/packaging/_musllinux.py | 85 + .../pip/_vendor/packaging/_parser.py | 354 + .../pip/_vendor/packaging/_structures.py | 61 + .../pip/_vendor/packaging/_tokenizer.py | 194 + .../_vendor/packaging/licenses/__init__.py | 145 + .../pip/_vendor/packaging/licenses/_spdx.py | 759 ++ .../pip/_vendor/packaging/markers.py | 331 + .../pip/_vendor/packaging/metadata.py | 863 ++ .../pip/_vendor/packaging/py.typed | 0 .../pip/_vendor/packaging/requirements.py | 91 + .../pip/_vendor/packaging/specifiers.py | 1020 ++ .../pip/_vendor/packaging/tags.py | 617 ++ .../pip/_vendor/packaging/utils.py | 163 + .../pip/_vendor/packaging/version.py | 582 ++ .../pip/_vendor/pkg_resources/__init__.py | 3676 +++++++ .../pip/_vendor/platformdirs/__init__.py | 631 ++ .../pip/_vendor/platformdirs/__main__.py | 55 + .../pip/_vendor/platformdirs/android.py | 249 + .../pip/_vendor/platformdirs/api.py | 298 + .../pip/_vendor/platformdirs/macos.py | 144 + .../pip/_vendor/platformdirs/py.typed | 0 .../pip/_vendor/platformdirs/unix.py | 269 + .../pip/_vendor/platformdirs/version.py | 16 + .../pip/_vendor/platformdirs/windows.py | 272 + .../pip/_vendor/pygments/__init__.py | 82 + .../pip/_vendor/pygments/__main__.py | 17 + .../pip/_vendor/pygments/cmdline.py | 668 ++ .../pip/_vendor/pygments/console.py | 70 + .../pip/_vendor/pygments/filter.py | 70 + .../pip/_vendor/pygments/filters/__init__.py | 940 ++ .../pip/_vendor/pygments/formatter.py | 129 + .../_vendor/pygments/formatters/__init__.py | 157 + .../_vendor/pygments/formatters/_mapping.py | 23 + .../pip/_vendor/pygments/formatters/bbcode.py | 108 + .../pip/_vendor/pygments/formatters/groff.py | 170 + .../pip/_vendor/pygments/formatters/html.py | 987 ++ .../pip/_vendor/pygments/formatters/img.py | 685 ++ .../pip/_vendor/pygments/formatters/irc.py | 154 + .../pip/_vendor/pygments/formatters/latex.py | 518 + .../pip/_vendor/pygments/formatters/other.py | 160 + .../pygments/formatters/pangomarkup.py | 83 + .../pip/_vendor/pygments/formatters/rtf.py | 349 + .../pip/_vendor/pygments/formatters/svg.py | 185 + .../_vendor/pygments/formatters/terminal.py | 127 + .../pygments/formatters/terminal256.py | 338 + .../pip/_vendor/pygments/lexer.py | 963 ++ .../pip/_vendor/pygments/lexers/__init__.py | 362 + .../pip/_vendor/pygments/lexers/_mapping.py | 589 ++ .../pip/_vendor/pygments/lexers/python.py | 1198 +++ .../pip/_vendor/pygments/modeline.py | 43 + .../pip/_vendor/pygments/plugin.py | 72 + .../pip/_vendor/pygments/regexopt.py | 91 + .../pip/_vendor/pygments/scanner.py | 104 + .../pip/_vendor/pygments/sphinxext.py | 247 + .../pip/_vendor/pygments/style.py | 203 + .../pip/_vendor/pygments/styles/__init__.py | 61 + .../pip/_vendor/pygments/styles/_mapping.py | 54 + .../pip/_vendor/pygments/token.py | 214 + .../pip/_vendor/pygments/unistring.py | 153 + .../pip/_vendor/pygments/util.py | 324 + .../pip/_vendor/pyproject_hooks/__init__.py | 31 + .../pip/_vendor/pyproject_hooks/_impl.py | 410 + .../pyproject_hooks/_in_process/__init__.py | 21 + .../_in_process/_in_process.py | 389 + .../pip/_vendor/pyproject_hooks/py.typed | 0 .../pip/_vendor/requests/__init__.py | 179 + .../pip/_vendor/requests/__version__.py | 14 + .../pip/_vendor/requests/_internal_utils.py | 50 + .../pip/_vendor/requests/adapters.py | 719 ++ .../site-packages/pip/_vendor/requests/api.py | 157 + .../pip/_vendor/requests/auth.py | 314 + .../pip/_vendor/requests/certs.py | 17 + .../pip/_vendor/requests/compat.py | 78 + .../pip/_vendor/requests/cookies.py | 561 ++ .../pip/_vendor/requests/exceptions.py | 151 + .../pip/_vendor/requests/help.py | 127 + .../pip/_vendor/requests/hooks.py | 33 + .../pip/_vendor/requests/models.py | 1037 ++ .../pip/_vendor/requests/packages.py | 25 + .../pip/_vendor/requests/sessions.py | 831 ++ .../pip/_vendor/requests/status_codes.py | 128 + .../pip/_vendor/requests/structures.py | 99 + .../pip/_vendor/requests/utils.py | 1096 ++ .../pip/_vendor/resolvelib/__init__.py | 26 + .../pip/_vendor/resolvelib/compat/__init__.py | 0 .../resolvelib/compat/collections_abc.py | 6 + .../pip/_vendor/resolvelib/providers.py | 133 + .../pip/_vendor/resolvelib/py.typed | 0 .../pip/_vendor/resolvelib/reporters.py | 43 + .../pip/_vendor/resolvelib/resolvers.py | 547 + .../pip/_vendor/resolvelib/structs.py | 170 + .../pip/_vendor/rich/__init__.py | 177 + .../pip/_vendor/rich/__main__.py | 273 + .../pip/_vendor/rich/_cell_widths.py | 454 + .../pip/_vendor/rich/_emoji_codes.py | 3610 +++++++ .../pip/_vendor/rich/_emoji_replace.py | 32 + .../pip/_vendor/rich/_export_format.py | 76 + .../pip/_vendor/rich/_extension.py | 10 + .../site-packages/pip/_vendor/rich/_fileno.py | 24 + .../pip/_vendor/rich/_inspect.py | 268 + .../pip/_vendor/rich/_log_render.py | 94 + .../site-packages/pip/_vendor/rich/_loop.py | 43 + .../pip/_vendor/rich/_null_file.py | 69 + .../pip/_vendor/rich/_palettes.py | 309 + .../site-packages/pip/_vendor/rich/_pick.py | 17 + .../site-packages/pip/_vendor/rich/_ratio.py | 159 + .../pip/_vendor/rich/_spinners.py | 482 + .../site-packages/pip/_vendor/rich/_stack.py | 16 + .../site-packages/pip/_vendor/rich/_timer.py | 19 + .../pip/_vendor/rich/_win32_console.py | 661 ++ .../pip/_vendor/rich/_windows.py | 71 + .../pip/_vendor/rich/_windows_renderer.py | 56 + .../site-packages/pip/_vendor/rich/_wrap.py | 93 + .../site-packages/pip/_vendor/rich/abc.py | 33 + .../site-packages/pip/_vendor/rich/align.py | 312 + .../site-packages/pip/_vendor/rich/ansi.py | 241 + .../site-packages/pip/_vendor/rich/bar.py | 93 + .../site-packages/pip/_vendor/rich/box.py | 480 + .../site-packages/pip/_vendor/rich/cells.py | 174 + .../site-packages/pip/_vendor/rich/color.py | 621 ++ .../pip/_vendor/rich/color_triplet.py | 38 + .../site-packages/pip/_vendor/rich/columns.py | 187 + .../site-packages/pip/_vendor/rich/console.py | 2661 +++++ .../pip/_vendor/rich/constrain.py | 37 + .../pip/_vendor/rich/containers.py | 167 + .../site-packages/pip/_vendor/rich/control.py | 225 + .../pip/_vendor/rich/default_styles.py | 191 + .../pip/_vendor/rich/diagnose.py | 37 + .../site-packages/pip/_vendor/rich/emoji.py | 96 + .../site-packages/pip/_vendor/rich/errors.py | 34 + .../pip/_vendor/rich/file_proxy.py | 57 + .../pip/_vendor/rich/filesize.py | 88 + .../pip/_vendor/rich/highlighter.py | 232 + .../site-packages/pip/_vendor/rich/json.py | 139 + .../site-packages/pip/_vendor/rich/jupyter.py | 101 + .../site-packages/pip/_vendor/rich/layout.py | 442 + .../site-packages/pip/_vendor/rich/live.py | 375 + .../pip/_vendor/rich/live_render.py | 112 + .../site-packages/pip/_vendor/rich/logging.py | 297 + .../site-packages/pip/_vendor/rich/markup.py | 251 + .../site-packages/pip/_vendor/rich/measure.py | 151 + .../site-packages/pip/_vendor/rich/padding.py | 141 + .../site-packages/pip/_vendor/rich/pager.py | 34 + .../site-packages/pip/_vendor/rich/palette.py | 100 + .../site-packages/pip/_vendor/rich/panel.py | 318 + .../site-packages/pip/_vendor/rich/pretty.py | 1016 ++ .../pip/_vendor/rich/progress.py | 1715 ++++ .../pip/_vendor/rich/progress_bar.py | 223 + .../site-packages/pip/_vendor/rich/prompt.py | 400 + .../pip/_vendor/rich/protocol.py | 42 + .../site-packages/pip/_vendor/rich/py.typed | 0 .../site-packages/pip/_vendor/rich/region.py | 10 + .../site-packages/pip/_vendor/rich/repr.py | 149 + .../site-packages/pip/_vendor/rich/rule.py | 130 + .../site-packages/pip/_vendor/rich/scope.py | 86 + .../site-packages/pip/_vendor/rich/screen.py | 54 + .../site-packages/pip/_vendor/rich/segment.py | 752 ++ .../site-packages/pip/_vendor/rich/spinner.py | 138 + .../site-packages/pip/_vendor/rich/status.py | 131 + .../site-packages/pip/_vendor/rich/style.py | 796 ++ .../site-packages/pip/_vendor/rich/styled.py | 42 + .../site-packages/pip/_vendor/rich/syntax.py | 966 ++ .../site-packages/pip/_vendor/rich/table.py | 1007 ++ .../pip/_vendor/rich/terminal_theme.py | 153 + .../site-packages/pip/_vendor/rich/text.py | 1361 +++ .../site-packages/pip/_vendor/rich/theme.py | 115 + .../site-packages/pip/_vendor/rich/themes.py | 5 + .../pip/_vendor/rich/traceback.py | 797 ++ .../site-packages/pip/_vendor/rich/tree.py | 257 + .../pip/_vendor/tomli/__init__.py | 8 + .../pip/_vendor/tomli/_parser.py | 770 ++ .../site-packages/pip/_vendor/tomli/_re.py | 112 + .../site-packages/pip/_vendor/tomli/_types.py | 10 + .../site-packages/pip/_vendor/tomli/py.typed | 1 + .../pip/_vendor/truststore/__init__.py | 36 + .../pip/_vendor/truststore/_api.py | 316 + .../pip/_vendor/truststore/_macos.py | 571 ++ .../pip/_vendor/truststore/_openssl.py | 66 + .../pip/_vendor/truststore/_ssl_constants.py | 31 + .../pip/_vendor/truststore/_windows.py | 567 ++ .../pip/_vendor/truststore/py.typed | 0 .../pip/_vendor/typing_extensions.py | 3641 +++++++ .../pip/_vendor/urllib3/__init__.py | 102 + .../pip/_vendor/urllib3/_collections.py | 355 + .../pip/_vendor/urllib3/_version.py | 2 + .../pip/_vendor/urllib3/connection.py | 572 ++ .../pip/_vendor/urllib3/connectionpool.py | 1140 +++ .../pip/_vendor/urllib3/contrib/__init__.py | 0 .../urllib3/contrib/_appengine_environ.py | 36 + .../contrib/_securetransport/__init__.py | 0 .../contrib/_securetransport/bindings.py | 519 + .../contrib/_securetransport/low_level.py | 397 + .../pip/_vendor/urllib3/contrib/appengine.py | 314 + .../pip/_vendor/urllib3/contrib/ntlmpool.py | 130 + .../pip/_vendor/urllib3/contrib/pyopenssl.py | 518 + .../urllib3/contrib/securetransport.py | 920 ++ .../pip/_vendor/urllib3/contrib/socks.py | 216 + .../pip/_vendor/urllib3/exceptions.py | 323 + .../pip/_vendor/urllib3/fields.py | 274 + .../pip/_vendor/urllib3/filepost.py | 98 + .../pip/_vendor/urllib3/packages/__init__.py | 0 .../urllib3/packages/backports/__init__.py | 0 .../urllib3/packages/backports/makefile.py | 51 + .../packages/backports/weakref_finalize.py | 155 + .../pip/_vendor/urllib3/packages/six.py | 1076 ++ .../pip/_vendor/urllib3/poolmanager.py | 540 + .../pip/_vendor/urllib3/request.py | 191 + .../pip/_vendor/urllib3/response.py | 879 ++ .../pip/_vendor/urllib3/util/__init__.py | 49 + .../pip/_vendor/urllib3/util/connection.py | 149 + .../pip/_vendor/urllib3/util/proxy.py | 57 + .../pip/_vendor/urllib3/util/queue.py | 22 + .../pip/_vendor/urllib3/util/request.py | 137 + .../pip/_vendor/urllib3/util/response.py | 107 + .../pip/_vendor/urllib3/util/retry.py | 622 ++ .../pip/_vendor/urllib3/util/ssl_.py | 504 + .../urllib3/util/ssl_match_hostname.py | 159 + .../pip/_vendor/urllib3/util/ssltransport.py | 221 + .../pip/_vendor/urllib3/util/timeout.py | 271 + .../pip/_vendor/urllib3/util/url.py | 435 + .../pip/_vendor/urllib3/util/wait.py | 152 + .../site-packages/pip/_vendor/vendor.txt | 18 + env/lib/python3.12/site-packages/pip/py.typed | 4 + .../platformdirs-4.9.2.dist-info/METADATA | 100 + .../platformdirs-4.9.2.dist-info/RECORD | 14 + .../platformdirs-4.9.2.dist-info/WHEEL | 4 + .../licenses/LICENSE | 21 + .../site-packages/platformdirs/__init__.py | 857 ++ .../site-packages/platformdirs/__main__.py | 61 + .../site-packages/platformdirs/_xdg.py | 143 + .../site-packages/platformdirs/android.py | 273 + .../site-packages/platformdirs/api.py | 394 + .../site-packages/platformdirs/macos.py | 187 + .../site-packages/platformdirs/py.typed | 0 .../site-packages/platformdirs/unix.py | 293 + .../site-packages/platformdirs/version.py | 34 + .../site-packages/platformdirs/windows.py | 369 + .../propcache-0.4.1.dist-info/INSTALLER | 1 + .../propcache-0.4.1.dist-info/METADATA | 443 + .../propcache-0.4.1.dist-info/RECORD | 18 + .../propcache-0.4.1.dist-info/WHEEL | 5 + .../licenses/LICENSE | 202 + .../propcache-0.4.1.dist-info/licenses/NOTICE | 13 + .../propcache-0.4.1.dist-info/top_level.txt | 1 + .../site-packages/propcache/__init__.py | 32 + .../site-packages/propcache/_helpers.py | 39 + ...helpers_c.cpython-312-x86_64-linux-musl.so | Bin 0 -> 553056 bytes .../site-packages/propcache/_helpers_c.pyx | 103 + .../site-packages/propcache/_helpers_py.py | 62 + .../python3.12/site-packages/propcache/api.py | 8 + .../site-packages/propcache/py.typed | 1 + .../ptyprocess-0.7.0.dist-info/INSTALLER | 1 + .../ptyprocess-0.7.0.dist-info/LICENSE | 16 + .../ptyprocess-0.7.0.dist-info/METADATA | 37 + .../ptyprocess-0.7.0.dist-info/RECORD | 13 + .../ptyprocess-0.7.0.dist-info/WHEEL | 5 + .../site-packages/ptyprocess/__init__.py | 4 + .../site-packages/ptyprocess/_fork_pty.py | 78 + .../site-packages/ptyprocess/ptyprocess.py | 842 ++ .../site-packages/ptyprocess/util.py | 71 + .../pure_eval-0.2.3.dist-info/INSTALLER | 1 + .../pure_eval-0.2.3.dist-info/LICENSE.txt | 21 + .../pure_eval-0.2.3.dist-info/METADATA | 227 + .../pure_eval-0.2.3.dist-info/RECORD | 17 + .../pure_eval-0.2.3.dist-info/WHEEL | 5 + .../pure_eval-0.2.3.dist-info/top_level.txt | 1 + .../site-packages/pure_eval/__init__.py | 17 + .../site-packages/pure_eval/core.py | 449 + .../pure_eval/my_getattr_static.py | 140 + .../site-packages/pure_eval/py.typed | 1 + .../site-packages/pure_eval/utils.py | 206 + .../site-packages/pure_eval/version.py | 1 + .../pygments-2.19.2.dist-info/INSTALLER | 1 + .../pygments-2.19.2.dist-info/METADATA | 58 + .../pygments-2.19.2.dist-info/RECORD | 684 ++ .../pygments-2.19.2.dist-info/WHEEL | 4 + .../entry_points.txt | 2 + .../licenses/AUTHORS | 291 + .../licenses/LICENSE | 25 + .../site-packages/pygments/__init__.py | 82 + .../site-packages/pygments/__main__.py | 17 + .../site-packages/pygments/cmdline.py | 668 ++ .../site-packages/pygments/console.py | 70 + .../site-packages/pygments/filter.py | 70 + .../pygments/filters/__init__.py | 940 ++ .../site-packages/pygments/formatter.py | 129 + .../pygments/formatters/__init__.py | 157 + .../pygments/formatters/_mapping.py | 23 + .../pygments/formatters/bbcode.py | 108 + .../pygments/formatters/groff.py | 170 + .../site-packages/pygments/formatters/html.py | 995 ++ .../site-packages/pygments/formatters/img.py | 686 ++ .../site-packages/pygments/formatters/irc.py | 154 + .../pygments/formatters/latex.py | 518 + .../pygments/formatters/other.py | 160 + .../pygments/formatters/pangomarkup.py | 83 + .../site-packages/pygments/formatters/rtf.py | 349 + .../site-packages/pygments/formatters/svg.py | 185 + .../pygments/formatters/terminal.py | 127 + .../pygments/formatters/terminal256.py | 338 + .../site-packages/pygments/lexer.py | 961 ++ .../site-packages/pygments/lexers/__init__.py | 362 + .../pygments/lexers/_ada_builtins.py | 103 + .../pygments/lexers/_asy_builtins.py | 1644 +++ .../pygments/lexers/_cl_builtins.py | 231 + .../pygments/lexers/_cocoa_builtins.py | 75 + .../pygments/lexers/_csound_builtins.py | 1780 ++++ .../pygments/lexers/_css_builtins.py | 558 ++ .../pygments/lexers/_googlesql_builtins.py | 918 ++ .../pygments/lexers/_julia_builtins.py | 411 + .../pygments/lexers/_lasso_builtins.py | 5326 ++++++++++ .../pygments/lexers/_lilypond_builtins.py | 4932 +++++++++ .../pygments/lexers/_lua_builtins.py | 285 + .../pygments/lexers/_luau_builtins.py | 62 + .../site-packages/pygments/lexers/_mapping.py | 602 ++ .../pygments/lexers/_mql_builtins.py | 1171 +++ .../pygments/lexers/_mysql_builtins.py | 1335 +++ .../pygments/lexers/_openedge_builtins.py | 2600 +++++ .../pygments/lexers/_php_builtins.py | 3325 +++++++ .../pygments/lexers/_postgres_builtins.py | 739 ++ .../pygments/lexers/_qlik_builtins.py | 666 ++ .../pygments/lexers/_scheme_builtins.py | 1609 +++ .../pygments/lexers/_scilab_builtins.py | 3093 ++++++ .../pygments/lexers/_sourcemod_builtins.py | 1151 +++ .../pygments/lexers/_sql_builtins.py | 106 + .../pygments/lexers/_stan_builtins.py | 648 ++ .../pygments/lexers/_stata_builtins.py | 457 + .../pygments/lexers/_tsql_builtins.py | 1003 ++ .../pygments/lexers/_usd_builtins.py | 112 + .../pygments/lexers/_vbscript_builtins.py | 279 + .../pygments/lexers/_vim_builtins.py | 1938 ++++ .../pygments/lexers/actionscript.py | 243 + .../site-packages/pygments/lexers/ada.py | 144 + .../site-packages/pygments/lexers/agile.py | 25 + .../site-packages/pygments/lexers/algebra.py | 299 + .../site-packages/pygments/lexers/ambient.py | 75 + .../site-packages/pygments/lexers/amdgpu.py | 54 + .../site-packages/pygments/lexers/ampl.py | 87 + .../site-packages/pygments/lexers/apdlexer.py | 593 ++ .../site-packages/pygments/lexers/apl.py | 103 + .../pygments/lexers/archetype.py | 315 + .../site-packages/pygments/lexers/arrow.py | 116 + .../site-packages/pygments/lexers/arturo.py | 249 + .../site-packages/pygments/lexers/asc.py | 55 + .../site-packages/pygments/lexers/asm.py | 1051 ++ .../site-packages/pygments/lexers/asn1.py | 178 + .../pygments/lexers/automation.py | 379 + .../site-packages/pygments/lexers/bare.py | 101 + .../site-packages/pygments/lexers/basic.py | 656 ++ .../site-packages/pygments/lexers/bdd.py | 57 + .../site-packages/pygments/lexers/berry.py | 99 + .../site-packages/pygments/lexers/bibtex.py | 159 + .../pygments/lexers/blueprint.py | 173 + .../site-packages/pygments/lexers/boa.py | 97 + .../site-packages/pygments/lexers/bqn.py | 112 + .../site-packages/pygments/lexers/business.py | 625 ++ .../site-packages/pygments/lexers/c_cpp.py | 414 + .../site-packages/pygments/lexers/c_like.py | 738 ++ .../pygments/lexers/capnproto.py | 74 + .../site-packages/pygments/lexers/carbon.py | 95 + .../site-packages/pygments/lexers/cddl.py | 172 + .../site-packages/pygments/lexers/chapel.py | 139 + .../site-packages/pygments/lexers/clean.py | 180 + .../site-packages/pygments/lexers/codeql.py | 80 + .../site-packages/pygments/lexers/comal.py | 81 + .../site-packages/pygments/lexers/compiled.py | 35 + .../site-packages/pygments/lexers/configs.py | 1433 +++ .../site-packages/pygments/lexers/console.py | 114 + .../site-packages/pygments/lexers/cplint.py | 43 + .../site-packages/pygments/lexers/crystal.py | 364 + .../site-packages/pygments/lexers/csound.py | 466 + .../site-packages/pygments/lexers/css.py | 602 ++ .../site-packages/pygments/lexers/d.py | 259 + .../site-packages/pygments/lexers/dalvik.py | 126 + .../site-packages/pygments/lexers/data.py | 763 ++ .../site-packages/pygments/lexers/dax.py | 135 + .../pygments/lexers/devicetree.py | 108 + .../site-packages/pygments/lexers/diff.py | 169 + .../site-packages/pygments/lexers/dns.py | 109 + .../site-packages/pygments/lexers/dotnet.py | 873 ++ .../site-packages/pygments/lexers/dsls.py | 970 ++ .../site-packages/pygments/lexers/dylan.py | 279 + .../site-packages/pygments/lexers/ecl.py | 144 + .../site-packages/pygments/lexers/eiffel.py | 68 + .../site-packages/pygments/lexers/elm.py | 123 + .../site-packages/pygments/lexers/elpi.py | 175 + .../site-packages/pygments/lexers/email.py | 132 + .../site-packages/pygments/lexers/erlang.py | 526 + .../site-packages/pygments/lexers/esoteric.py | 300 + .../site-packages/pygments/lexers/ezhil.py | 76 + .../site-packages/pygments/lexers/factor.py | 363 + .../site-packages/pygments/lexers/fantom.py | 251 + .../site-packages/pygments/lexers/felix.py | 275 + .../site-packages/pygments/lexers/fift.py | 68 + .../pygments/lexers/floscript.py | 81 + .../site-packages/pygments/lexers/forth.py | 178 + .../site-packages/pygments/lexers/fortran.py | 212 + .../site-packages/pygments/lexers/foxpro.py | 427 + .../site-packages/pygments/lexers/freefem.py | 893 ++ .../site-packages/pygments/lexers/func.py | 110 + .../pygments/lexers/functional.py | 21 + .../site-packages/pygments/lexers/futhark.py | 105 + .../pygments/lexers/gcodelexer.py | 35 + .../site-packages/pygments/lexers/gdscript.py | 189 + .../site-packages/pygments/lexers/gleam.py | 74 + .../site-packages/pygments/lexers/go.py | 97 + .../pygments/lexers/grammar_notation.py | 262 + .../site-packages/pygments/lexers/graph.py | 108 + .../site-packages/pygments/lexers/graphics.py | 794 ++ .../site-packages/pygments/lexers/graphql.py | 176 + .../site-packages/pygments/lexers/graphviz.py | 58 + .../site-packages/pygments/lexers/gsql.py | 103 + .../site-packages/pygments/lexers/hare.py | 73 + .../site-packages/pygments/lexers/haskell.py | 866 ++ .../site-packages/pygments/lexers/haxe.py | 935 ++ .../site-packages/pygments/lexers/hdl.py | 466 + .../site-packages/pygments/lexers/hexdump.py | 102 + .../site-packages/pygments/lexers/html.py | 670 ++ .../site-packages/pygments/lexers/idl.py | 284 + .../site-packages/pygments/lexers/igor.py | 435 + .../site-packages/pygments/lexers/inferno.py | 95 + .../pygments/lexers/installers.py | 352 + .../pygments/lexers/int_fiction.py | 1370 +++ .../site-packages/pygments/lexers/iolang.py | 61 + .../site-packages/pygments/lexers/j.py | 151 + .../pygments/lexers/javascript.py | 1591 +++ .../site-packages/pygments/lexers/jmespath.py | 69 + .../site-packages/pygments/lexers/jslt.py | 94 + .../site-packages/pygments/lexers/json5.py | 83 + .../site-packages/pygments/lexers/jsonnet.py | 169 + .../site-packages/pygments/lexers/jsx.py | 100 + .../site-packages/pygments/lexers/julia.py | 294 + .../site-packages/pygments/lexers/jvm.py | 1802 ++++ .../site-packages/pygments/lexers/kuin.py | 332 + .../site-packages/pygments/lexers/kusto.py | 93 + .../site-packages/pygments/lexers/ldap.py | 155 + .../site-packages/pygments/lexers/lean.py | 241 + .../site-packages/pygments/lexers/lilypond.py | 225 + .../site-packages/pygments/lexers/lisp.py | 3146 ++++++ .../pygments/lexers/macaulay2.py | 1814 ++++ .../site-packages/pygments/lexers/make.py | 212 + .../site-packages/pygments/lexers/maple.py | 291 + .../site-packages/pygments/lexers/markup.py | 1654 +++ .../site-packages/pygments/lexers/math.py | 21 + .../site-packages/pygments/lexers/matlab.py | 3307 ++++++ .../site-packages/pygments/lexers/maxima.py | 84 + .../site-packages/pygments/lexers/meson.py | 139 + .../site-packages/pygments/lexers/mime.py | 210 + .../pygments/lexers/minecraft.py | 391 + .../site-packages/pygments/lexers/mips.py | 130 + .../site-packages/pygments/lexers/ml.py | 958 ++ .../site-packages/pygments/lexers/modeling.py | 366 + .../site-packages/pygments/lexers/modula2.py | 1579 +++ .../site-packages/pygments/lexers/mojo.py | 707 ++ .../site-packages/pygments/lexers/monte.py | 203 + .../site-packages/pygments/lexers/mosel.py | 447 + .../site-packages/pygments/lexers/ncl.py | 894 ++ .../site-packages/pygments/lexers/nimrod.py | 199 + .../site-packages/pygments/lexers/nit.py | 63 + .../site-packages/pygments/lexers/nix.py | 144 + .../site-packages/pygments/lexers/numbair.py | 63 + .../site-packages/pygments/lexers/oberon.py | 120 + .../pygments/lexers/objective.py | 513 + .../site-packages/pygments/lexers/ooc.py | 84 + .../site-packages/pygments/lexers/openscad.py | 96 + .../site-packages/pygments/lexers/other.py | 41 + .../site-packages/pygments/lexers/parasail.py | 78 + .../site-packages/pygments/lexers/parsers.py | 798 ++ .../site-packages/pygments/lexers/pascal.py | 644 ++ .../site-packages/pygments/lexers/pawn.py | 202 + .../site-packages/pygments/lexers/pddl.py | 82 + .../site-packages/pygments/lexers/perl.py | 733 ++ .../site-packages/pygments/lexers/phix.py | 363 + .../site-packages/pygments/lexers/php.py | 334 + .../pygments/lexers/pointless.py | 70 + .../site-packages/pygments/lexers/pony.py | 93 + .../site-packages/pygments/lexers/praat.py | 303 + .../site-packages/pygments/lexers/procfile.py | 41 + .../site-packages/pygments/lexers/prolog.py | 318 + .../site-packages/pygments/lexers/promql.py | 176 + .../site-packages/pygments/lexers/prql.py | 251 + .../site-packages/pygments/lexers/ptx.py | 119 + .../site-packages/pygments/lexers/python.py | 1201 +++ .../site-packages/pygments/lexers/q.py | 187 + .../site-packages/pygments/lexers/qlik.py | 117 + .../site-packages/pygments/lexers/qvt.py | 153 + .../site-packages/pygments/lexers/r.py | 196 + .../site-packages/pygments/lexers/rdf.py | 468 + .../site-packages/pygments/lexers/rebol.py | 419 + .../site-packages/pygments/lexers/rego.py | 57 + .../site-packages/pygments/lexers/resource.py | 83 + .../site-packages/pygments/lexers/ride.py | 138 + .../site-packages/pygments/lexers/rita.py | 42 + .../site-packages/pygments/lexers/rnc.py | 66 + .../site-packages/pygments/lexers/roboconf.py | 81 + .../pygments/lexers/robotframework.py | 551 + .../site-packages/pygments/lexers/ruby.py | 518 + .../site-packages/pygments/lexers/rust.py | 222 + .../site-packages/pygments/lexers/sas.py | 227 + .../site-packages/pygments/lexers/savi.py | 171 + .../site-packages/pygments/lexers/scdoc.py | 85 + .../pygments/lexers/scripting.py | 1616 +++ .../site-packages/pygments/lexers/sgf.py | 59 + .../site-packages/pygments/lexers/shell.py | 902 ++ .../site-packages/pygments/lexers/sieve.py | 78 + .../site-packages/pygments/lexers/slash.py | 183 + .../pygments/lexers/smalltalk.py | 194 + .../site-packages/pygments/lexers/smithy.py | 77 + .../site-packages/pygments/lexers/smv.py | 78 + .../site-packages/pygments/lexers/snobol.py | 82 + .../site-packages/pygments/lexers/solidity.py | 87 + .../site-packages/pygments/lexers/soong.py | 78 + .../site-packages/pygments/lexers/sophia.py | 102 + .../site-packages/pygments/lexers/special.py | 122 + .../site-packages/pygments/lexers/spice.py | 70 + .../site-packages/pygments/lexers/sql.py | 1109 +++ .../site-packages/pygments/lexers/srcinfo.py | 62 + .../site-packages/pygments/lexers/stata.py | 170 + .../pygments/lexers/supercollider.py | 94 + .../site-packages/pygments/lexers/tablegen.py | 177 + .../site-packages/pygments/lexers/tact.py | 303 + .../site-packages/pygments/lexers/tal.py | 77 + .../site-packages/pygments/lexers/tcl.py | 148 + .../site-packages/pygments/lexers/teal.py | 88 + .../pygments/lexers/templates.py | 2355 +++++ .../site-packages/pygments/lexers/teraterm.py | 325 + .../site-packages/pygments/lexers/testing.py | 209 + .../site-packages/pygments/lexers/text.py | 27 + .../site-packages/pygments/lexers/textedit.py | 205 + .../site-packages/pygments/lexers/textfmts.py | 436 + .../site-packages/pygments/lexers/theorem.py | 410 + .../site-packages/pygments/lexers/thingsdb.py | 140 + .../site-packages/pygments/lexers/tlb.py | 59 + .../site-packages/pygments/lexers/tls.py | 54 + .../site-packages/pygments/lexers/tnt.py | 270 + .../pygments/lexers/trafficscript.py | 51 + .../pygments/lexers/typoscript.py | 216 + .../site-packages/pygments/lexers/typst.py | 160 + .../site-packages/pygments/lexers/ul4.py | 309 + .../site-packages/pygments/lexers/unicon.py | 413 + .../site-packages/pygments/lexers/urbi.py | 145 + .../site-packages/pygments/lexers/usd.py | 85 + .../site-packages/pygments/lexers/varnish.py | 189 + .../pygments/lexers/verification.py | 113 + .../site-packages/pygments/lexers/verifpal.py | 65 + .../site-packages/pygments/lexers/vip.py | 150 + .../site-packages/pygments/lexers/vyper.py | 140 + .../site-packages/pygments/lexers/web.py | 24 + .../pygments/lexers/webassembly.py | 119 + .../site-packages/pygments/lexers/webidl.py | 298 + .../site-packages/pygments/lexers/webmisc.py | 1006 ++ .../site-packages/pygments/lexers/wgsl.py | 406 + .../site-packages/pygments/lexers/whiley.py | 115 + .../site-packages/pygments/lexers/wowtoc.py | 120 + .../site-packages/pygments/lexers/wren.py | 98 + .../site-packages/pygments/lexers/x10.py | 66 + .../site-packages/pygments/lexers/xorg.py | 38 + .../site-packages/pygments/lexers/yang.py | 103 + .../site-packages/pygments/lexers/yara.py | 69 + .../site-packages/pygments/lexers/zig.py | 125 + .../site-packages/pygments/modeline.py | 43 + .../site-packages/pygments/plugin.py | 72 + .../site-packages/pygments/regexopt.py | 91 + .../site-packages/pygments/scanner.py | 104 + .../site-packages/pygments/sphinxext.py | 247 + .../site-packages/pygments/style.py | 203 + .../site-packages/pygments/styles/__init__.py | 61 + .../site-packages/pygments/styles/_mapping.py | 54 + .../site-packages/pygments/styles/abap.py | 32 + .../site-packages/pygments/styles/algol.py | 65 + .../site-packages/pygments/styles/algol_nu.py | 65 + .../site-packages/pygments/styles/arduino.py | 100 + .../site-packages/pygments/styles/autumn.py | 67 + .../site-packages/pygments/styles/borland.py | 53 + .../site-packages/pygments/styles/bw.py | 52 + .../site-packages/pygments/styles/coffee.py | 80 + .../site-packages/pygments/styles/colorful.py | 83 + .../site-packages/pygments/styles/default.py | 76 + .../site-packages/pygments/styles/dracula.py | 90 + .../site-packages/pygments/styles/emacs.py | 75 + .../site-packages/pygments/styles/friendly.py | 76 + .../pygments/styles/friendly_grayscale.py | 80 + .../site-packages/pygments/styles/fruity.py | 47 + .../site-packages/pygments/styles/gh_dark.py | 113 + .../site-packages/pygments/styles/gruvbox.py | 118 + .../site-packages/pygments/styles/igor.py | 32 + .../site-packages/pygments/styles/inkpot.py | 72 + .../pygments/styles/lightbulb.py | 110 + .../site-packages/pygments/styles/lilypond.py | 62 + .../site-packages/pygments/styles/lovelace.py | 100 + .../site-packages/pygments/styles/manni.py | 79 + .../site-packages/pygments/styles/material.py | 124 + .../site-packages/pygments/styles/monokai.py | 112 + .../site-packages/pygments/styles/murphy.py | 82 + .../site-packages/pygments/styles/native.py | 70 + .../site-packages/pygments/styles/nord.py | 156 + .../site-packages/pygments/styles/onedark.py | 63 + .../pygments/styles/paraiso_dark.py | 124 + .../pygments/styles/paraiso_light.py | 124 + .../site-packages/pygments/styles/pastie.py | 78 + .../site-packages/pygments/styles/perldoc.py | 73 + .../pygments/styles/rainbow_dash.py | 95 + .../site-packages/pygments/styles/rrt.py | 40 + .../site-packages/pygments/styles/sas.py | 46 + .../pygments/styles/solarized.py | 144 + .../pygments/styles/staroffice.py | 31 + .../pygments/styles/stata_dark.py | 42 + .../pygments/styles/stata_light.py | 42 + .../site-packages/pygments/styles/tango.py | 143 + .../site-packages/pygments/styles/trac.py | 66 + .../site-packages/pygments/styles/vim.py | 67 + .../site-packages/pygments/styles/vs.py | 41 + .../site-packages/pygments/styles/xcode.py | 53 + .../site-packages/pygments/styles/zenburn.py | 83 + .../site-packages/pygments/token.py | 214 + .../site-packages/pygments/unistring.py | 153 + .../python3.12/site-packages/pygments/util.py | 324 + .../pyzmq-27.1.0.dist-info/INSTALLER | 1 + .../pyzmq-27.1.0.dist-info/METADATA | 139 + .../pyzmq-27.1.0.dist-info/RECORD | 166 + .../pyzmq-27.1.0.dist-info/WHEEL | 5 + .../licenses/LICENSE.md | 30 + .../licenses/licenses/LICENSE.libsodium.txt | 18 + .../licenses/licenses/LICENSE.tornado.txt | 202 + .../licenses/licenses/LICENSE.zeromq.txt | 373 + .../pyzmq.libs/libgcc_s-0cd532bd.so.1 | Bin 0 -> 181737 bytes .../pyzmq.libs/libsodium-8c37ebe2.so.26.2.0 | Bin 0 -> 1205673 bytes .../pyzmq.libs/libstdc++-5d72f927.so.6.0.33 | Bin 0 -> 3562401 bytes .../pyzmq.libs/libzmq-bea72b92.so.5.2.5 | Bin 0 -> 965585 bytes .../rpds.libs/libgcc_s-98a1ef30.so.1 | Bin 0 -> 433441 bytes .../python3.12/site-packages/rpds/__init__.py | 5 + .../site-packages/rpds/__init__.pyi | 79 + .../python3.12/site-packages/rpds/py.typed | 0 .../rpds.cpython-312-x86_64-linux-musl.so | Bin 0 -> 1035209 bytes .../rpds_py-0.30.0.dist-info/INSTALLER | 1 + .../rpds_py-0.30.0.dist-info/METADATA | 99 + .../rpds_py-0.30.0.dist-info/RECORD | 11 + .../rpds_py-0.30.0.dist-info/WHEEL | 4 + .../rpds_py-0.30.0.dist-info/licenses/LICENSE | 19 + .../six-1.17.0.dist-info/INSTALLER | 1 + .../six-1.17.0.dist-info/LICENSE | 18 + .../six-1.17.0.dist-info/METADATA | 43 + .../site-packages/six-1.17.0.dist-info/RECORD | 8 + .../site-packages/six-1.17.0.dist-info/WHEEL | 6 + .../six-1.17.0.dist-info/top_level.txt | 1 + env/lib/python3.12/site-packages/six.py | 1003 ++ .../soupsieve-2.8.3.dist-info/INSTALLER | 1 + .../soupsieve-2.8.3.dist-info/METADATA | 115 + .../soupsieve-2.8.3.dist-info/RECORD | 20 + .../soupsieve-2.8.3.dist-info/WHEEL | 4 + .../licenses/LICENSE.md | 21 + .../site-packages/soupsieve/__init__.py | 168 + .../site-packages/soupsieve/__meta__.py | 197 + .../site-packages/soupsieve/css_match.py | 1654 +++ .../site-packages/soupsieve/css_parser.py | 1318 +++ .../site-packages/soupsieve/css_types.py | 407 + .../site-packages/soupsieve/pretty.py | 148 + .../site-packages/soupsieve/py.typed | 0 .../site-packages/soupsieve/util.py | 117 + .../tinycss2-1.4.0.dist-info/INSTALLER | 1 + .../tinycss2-1.4.0.dist-info/LICENSE | 29 + .../tinycss2-1.4.0.dist-info/METADATA | 65 + .../tinycss2-1.4.0.dist-info/RECORD | 23 + .../tinycss2-1.4.0.dist-info/WHEEL | 4 + .../site-packages/tinycss2/__init__.py | 18 + .../python3.12/site-packages/tinycss2/ast.py | 874 ++ .../site-packages/tinycss2/bytes.py | 113 + .../site-packages/tinycss2/color3.py | 337 + .../site-packages/tinycss2/color4.py | 474 + .../python3.12/site-packages/tinycss2/nth.py | 100 + .../site-packages/tinycss2/parser.py | 528 + .../site-packages/tinycss2/serializer.py | 140 + .../site-packages/tinycss2/tokenizer.py | 419 + .../tornado-6.5.4.dist-info/INSTALLER | 1 + .../tornado-6.5.4.dist-info/METADATA | 84 + .../tornado-6.5.4.dist-info/RECORD | 171 + .../tornado-6.5.4.dist-info/WHEEL | 5 + .../tornado-6.5.4.dist-info/licenses/LICENSE | 202 + .../tornado-6.5.4.dist-info/top_level.txt | 1 + .../site-packages/tornado/__init__.py | 67 + .../site-packages/tornado/__init__.pyi | 33 + .../site-packages/tornado/_locale_data.py | 80 + .../python3.12/site-packages/tornado/auth.py | 1235 +++ .../site-packages/tornado/autoreload.py | 350 + .../site-packages/tornado/concurrent.py | 275 + .../site-packages/tornado/curl_httpclient.py | 590 ++ .../site-packages/tornado/escape.py | 401 + .../python3.12/site-packages/tornado/gen.py | 903 ++ .../site-packages/tornado/http1connection.py | 889 ++ .../site-packages/tornado/httpclient.py | 790 ++ .../site-packages/tornado/httpserver.py | 410 + .../site-packages/tornado/httputil.py | 1296 +++ .../site-packages/tornado/ioloop.py | 986 ++ .../site-packages/tornado/iostream.py | 1617 +++ .../site-packages/tornado/locale.py | 587 ++ .../python3.12/site-packages/tornado/locks.py | 570 ++ .../python3.12/site-packages/tornado/log.py | 343 + .../site-packages/tornado/netutil.py | 670 ++ .../site-packages/tornado/options.py | 745 ++ .../tornado/platform/__init__.py | 0 .../site-packages/tornado/platform/asyncio.py | 753 ++ .../tornado/platform/caresresolver.py | 94 + .../site-packages/tornado/platform/twisted.py | 64 + .../site-packages/tornado/process.py | 371 + .../python3.12/site-packages/tornado/py.typed | 0 .../site-packages/tornado/queues.py | 422 + .../site-packages/tornado/routing.py | 728 ++ .../tornado/simple_httpclient.py | 702 ++ .../site-packages/tornado/speedups.abi3.so | Bin 0 -> 20592 bytes .../site-packages/tornado/speedups.pyi | 1 + .../site-packages/tornado/tcpclient.py | 332 + .../site-packages/tornado/tcpserver.py | 390 + .../site-packages/tornado/template.py | 1045 ++ .../site-packages/tornado/test/__init__.py | 0 .../site-packages/tornado/test/__main__.py | 11 + .../tornado/test/asyncio_test.py | 298 + .../site-packages/tornado/test/auth_test.py | 608 ++ .../tornado/test/autoreload_test.py | 268 + .../tornado/test/circlerefs_test.py | 217 + .../tornado/test/concurrent_test.py | 231 + .../tornado/test/csv_translations/fr_FR.csv | 1 + .../tornado/test/curl_httpclient_test.py | 125 + .../site-packages/tornado/test/escape_test.py | 324 + .../site-packages/tornado/test/gen_test.py | 1123 +++ .../fr_FR/LC_MESSAGES/tornado_test.mo | Bin 0 -> 665 bytes .../fr_FR/LC_MESSAGES/tornado_test.po | 47 + .../tornado/test/http1connection_test.py | 61 + .../tornado/test/httpclient_test.py | 957 ++ .../tornado/test/httpserver_test.py | 1535 +++ .../tornado/test/httputil_test.py | 711 ++ .../site-packages/tornado/test/import_test.py | 68 + .../site-packages/tornado/test/ioloop_test.py | 812 ++ .../tornado/test/iostream_test.py | 1421 +++ .../site-packages/tornado/test/locale_test.py | 159 + .../site-packages/tornado/test/locks_test.py | 535 + .../site-packages/tornado/test/log_test.py | 233 + .../tornado/test/netutil_test.py | 210 + .../tornado/test/options_test.cfg | 7 + .../tornado/test/options_test.py | 328 + .../tornado/test/options_test_types.cfg | 12 + .../tornado/test/options_test_types_str.cfg | 9 + .../tornado/test/process_test.py | 264 + .../site-packages/tornado/test/queues_test.py | 431 + .../tornado/test/resolve_test_helper.py | 10 + .../tornado/test/routing_test.py | 276 + .../site-packages/tornado/test/runtests.py | 223 + .../tornado/test/simple_httpclient_test.py | 866 ++ .../tornado/test/static/dir/index.html | 1 + .../tornado/test/static/robots.txt | 2 + .../tornado/test/static/sample.xml | 23 + .../tornado/test/static/sample.xml.bz2 | Bin 0 -> 285 bytes .../tornado/test/static/sample.xml.gz | Bin 0 -> 264 bytes .../site-packages/tornado/test/static_foo.txt | 2 + .../tornado/test/tcpclient_test.py | 434 + .../tornado/test/tcpserver_test.py | 230 + .../tornado/test/template_test.py | 528 + .../tornado/test/templates/utf8.html | 1 + .../site-packages/tornado/test/test.crt | 18 + .../site-packages/tornado/test/test.key | 28 + .../tornado/test/testing_test.py | 340 + .../tornado/test/twisted_test.py | 70 + .../site-packages/tornado/test/util.py | 126 + .../site-packages/tornado/test/util_test.py | 373 + .../site-packages/tornado/test/web_test.py | 3352 +++++++ .../tornado/test/websocket_test.py | 989 ++ .../site-packages/tornado/test/wsgi_test.py | 116 + .../site-packages/tornado/testing.py | 866 ++ .../python3.12/site-packages/tornado/util.py | 445 + .../python3.12/site-packages/tornado/web.py | 3803 +++++++ .../site-packages/tornado/websocket.py | 1725 ++++ .../python3.12/site-packages/tornado/wsgi.py | 268 + .../traitlets-5.14.3.dist-info/INSTALLER | 1 + .../traitlets-5.14.3.dist-info/METADATA | 282 + .../traitlets-5.14.3.dist-info/RECORD | 54 + .../traitlets-5.14.3.dist-info/WHEEL | 4 + .../licenses/LICENSE | 30 + .../site-packages/traitlets/__init__.py | 35 + .../site-packages/traitlets/_version.py | 19 + .../traitlets/config/__init__.py | 20 + .../traitlets/config/application.py | 1129 +++ .../traitlets/config/argcomplete_config.py | 220 + .../traitlets/config/configurable.py | 600 ++ .../site-packages/traitlets/config/loader.py | 1179 +++ .../site-packages/traitlets/config/manager.py | 84 + .../traitlets/config/sphinxdoc.py | 164 + .../python3.12/site-packages/traitlets/log.py | 31 + .../site-packages/traitlets/py.typed | 0 .../site-packages/traitlets/tests/__init__.py | 0 .../traitlets/tests/test_traitlets.py | 59 + .../site-packages/traitlets/tests/utils.py | 42 + .../site-packages/traitlets/traitlets.py | 4312 ++++++++ .../site-packages/traitlets/utils/__init__.py | 91 + .../site-packages/traitlets/utils/bunch.py | 29 + .../traitlets/utils/decorators.py | 86 + .../traitlets/utils/descriptions.py | 182 + .../traitlets/utils/getargspec.py | 51 + .../traitlets/utils/importstring.py | 41 + .../traitlets/utils/nested_update.py | 41 + .../site-packages/traitlets/utils/sentinel.py | 24 + .../site-packages/traitlets/utils/text.py | 40 + .../site-packages/traitlets/utils/warnings.py | 64 + .../INSTALLER | 1 + .../METADATA | 72 + .../typing_extensions-4.15.0.dist-info/RECORD | 7 + .../typing_extensions-4.15.0.dist-info/WHEEL | 4 + .../licenses/LICENSE | 279 + .../site-packages/typing_extensions.py | 4317 ++++++++ .../urllib3-2.6.3.dist-info/INSTALLER | 1 + .../urllib3-2.6.3.dist-info/METADATA | 164 + .../urllib3-2.6.3.dist-info/RECORD | 79 + .../urllib3-2.6.3.dist-info/WHEEL | 4 + .../licenses/LICENSE.txt | 21 + .../site-packages/urllib3/__init__.py | 211 + .../site-packages/urllib3/_base_connection.py | 165 + .../site-packages/urllib3/_collections.py | 487 + .../site-packages/urllib3/_request_methods.py | 278 + .../site-packages/urllib3/_version.py | 34 + .../site-packages/urllib3/connection.py | 1099 ++ .../site-packages/urllib3/connectionpool.py | 1178 +++ .../site-packages/urllib3/contrib/__init__.py | 0 .../urllib3/contrib/emscripten/__init__.py | 17 + .../urllib3/contrib/emscripten/connection.py | 260 + .../emscripten/emscripten_fetch_worker.js | 110 + .../urllib3/contrib/emscripten/fetch.py | 726 ++ .../urllib3/contrib/emscripten/request.py | 22 + .../urllib3/contrib/emscripten/response.py | 277 + .../urllib3/contrib/pyopenssl.py | 564 ++ .../site-packages/urllib3/contrib/socks.py | 228 + .../site-packages/urllib3/exceptions.py | 335 + .../site-packages/urllib3/fields.py | 341 + .../site-packages/urllib3/filepost.py | 89 + .../site-packages/urllib3/http2/__init__.py | 53 + .../site-packages/urllib3/http2/connection.py | 356 + .../site-packages/urllib3/http2/probe.py | 87 + .../site-packages/urllib3/poolmanager.py | 651 ++ .../python3.12/site-packages/urllib3/py.typed | 2 + .../site-packages/urllib3/response.py | 1480 +++ .../site-packages/urllib3/util/__init__.py | 42 + .../site-packages/urllib3/util/connection.py | 137 + .../site-packages/urllib3/util/proxy.py | 43 + .../site-packages/urllib3/util/request.py | 263 + .../site-packages/urllib3/util/response.py | 101 + .../site-packages/urllib3/util/retry.py | 549 + .../site-packages/urllib3/util/ssl_.py | 527 + .../urllib3/util/ssl_match_hostname.py | 159 + .../urllib3/util/ssltransport.py | 271 + .../site-packages/urllib3/util/timeout.py | 275 + .../site-packages/urllib3/util/url.py | 469 + .../site-packages/urllib3/util/util.py | 42 + .../site-packages/urllib3/util/wait.py | 124 + .../wcwidth-0.6.0.dist-info/INSTALLER | 1 + .../wcwidth-0.6.0.dist-info/METADATA | 776 ++ .../wcwidth-0.6.0.dist-info/RECORD | 36 + .../wcwidth-0.6.0.dist-info/WHEEL | 4 + .../wcwidth-0.6.0.dist-info/licenses/LICENSE | 27 + .../site-packages/wcwidth/__init__.py | 43 + .../site-packages/wcwidth/bisearch.py | 29 + .../site-packages/wcwidth/control_codes.py | 46 + .../site-packages/wcwidth/escape_sequences.py | 69 + .../site-packages/wcwidth/grapheme.py | 428 + .../python3.12/site-packages/wcwidth/py.typed | 0 .../site-packages/wcwidth/sgr_state.py | 338 + .../site-packages/wcwidth/table_ambiguous.py | 189 + .../site-packages/wcwidth/table_grapheme.py | 2294 +++++ .../site-packages/wcwidth/table_mc.py | 206 + .../site-packages/wcwidth/table_vs16.py | 126 + .../site-packages/wcwidth/table_wide.py | 138 + .../site-packages/wcwidth/table_zero.py | 350 + .../site-packages/wcwidth/textwrap.py | 656 ++ .../site-packages/wcwidth/unicode_versions.py | 21 + .../site-packages/wcwidth/wcwidth.py | 1030 ++ .../DESCRIPTION.rst | 27 + .../webencodings-0.5.1.dist-info/INSTALLER | 1 + .../webencodings-0.5.1.dist-info/METADATA | 52 + .../webencodings-0.5.1.dist-info/RECORD | 17 + .../webencodings-0.5.1.dist-info/WHEEL | 6 + .../metadata.json | 1 + .../top_level.txt | 1 + .../site-packages/webencodings/__init__.py | 342 + .../site-packages/webencodings/labels.py | 231 + .../site-packages/webencodings/mklabels.py | 59 + .../site-packages/webencodings/tests.py | 153 + .../webencodings/x_user_defined.py | 325 + .../yarl-1.22.0.dist-info/INSTALLER | 1 + .../yarl-1.22.0.dist-info/METADATA | 2478 +++++ .../yarl-1.22.0.dist-info/RECORD | 26 + .../site-packages/yarl-1.22.0.dist-info/WHEEL | 5 + .../yarl-1.22.0.dist-info/licenses/LICENSE | 202 + .../yarl-1.22.0.dist-info/licenses/NOTICE | 13 + .../yarl-1.22.0.dist-info/top_level.txt | 1 + .../python3.12/site-packages/yarl/__init__.py | 14 + .../python3.12/site-packages/yarl/_parse.py | 203 + .../python3.12/site-packages/yarl/_path.py | 41 + .../python3.12/site-packages/yarl/_query.py | 121 + .../python3.12/site-packages/yarl/_quoters.py | 33 + .../python3.12/site-packages/yarl/_quoting.py | 19 + ...quoting_c.cpython-312-x86_64-linux-musl.so | Bin 0 -> 838448 bytes .../site-packages/yarl/_quoting_c.pyx | 451 + .../site-packages/yarl/_quoting_py.py | 213 + env/lib/python3.12/site-packages/yarl/_url.py | 1622 +++ .../python3.12/site-packages/yarl/py.typed | 1 + .../python3.12/site-packages/zmq/__init__.pxd | 1 + .../python3.12/site-packages/zmq/__init__.py | 97 + .../python3.12/site-packages/zmq/__init__.pyi | 28 + .../python3.12/site-packages/zmq/_future.py | 737 ++ .../python3.12/site-packages/zmq/_future.pyi | 95 + .../python3.12/site-packages/zmq/_typing.py | 11 + .../python3.12/site-packages/zmq/asyncio.py | 224 + .../site-packages/zmq/auth/__init__.py | 13 + .../site-packages/zmq/auth/asyncio.py | 66 + .../python3.12/site-packages/zmq/auth/base.py | 445 + .../site-packages/zmq/auth/certs.py | 140 + .../site-packages/zmq/auth/ioloop.py | 48 + .../site-packages/zmq/auth/thread.py | 139 + .../site-packages/zmq/backend/__init__.py | 34 + .../site-packages/zmq/backend/__init__.pyi | 123 + .../site-packages/zmq/backend/cffi/README.md | 1 + .../zmq/backend/cffi/__init__.py | 38 + .../site-packages/zmq/backend/cffi/_cdefs.h | 98 + .../zmq/backend/cffi/_cffi_src.c | 50 + .../site-packages/zmq/backend/cffi/_poll.py | 92 + .../site-packages/zmq/backend/cffi/context.py | 77 + .../site-packages/zmq/backend/cffi/devices.py | 59 + .../site-packages/zmq/backend/cffi/error.py | 16 + .../site-packages/zmq/backend/cffi/message.py | 225 + .../site-packages/zmq/backend/cffi/socket.py | 435 + .../site-packages/zmq/backend/cffi/utils.py | 80 + .../zmq/backend/cython/__init__.pxd | 1 + .../zmq/backend/cython/__init__.py | 15 + .../zmq/backend/cython/_externs.pxd | 13 + .../zmq/backend/cython/_zmq.abi3.so | Bin 0 -> 262705 bytes .../site-packages/zmq/backend/cython/_zmq.pxd | 52 + .../site-packages/zmq/backend/cython/_zmq.py | 2048 ++++ .../zmq/backend/cython/constant_enums.pxi | 250 + .../zmq/backend/cython/libzmq.pxd | 128 + .../site-packages/zmq/backend/select.py | 41 + .../python3.12/site-packages/zmq/constants.py | 974 ++ .../site-packages/zmq/decorators.py | 190 + .../site-packages/zmq/devices/__init__.py | 30 + .../site-packages/zmq/devices/basedevice.py | 310 + .../zmq/devices/monitoredqueue.py | 51 + .../zmq/devices/monitoredqueuedevice.py | 60 + .../site-packages/zmq/devices/proxydevice.py | 104 + .../zmq/devices/proxysteerabledevice.py | 106 + env/lib/python3.12/site-packages/zmq/error.py | 229 + .../site-packages/zmq/eventloop/__init__.py | 5 + .../zmq/eventloop/_deprecated.py | 212 + .../site-packages/zmq/eventloop/future.py | 104 + .../site-packages/zmq/eventloop/ioloop.py | 37 + .../site-packages/zmq/eventloop/zmqstream.py | 688 ++ .../site-packages/zmq/green/__init__.py | 48 + .../site-packages/zmq/green/core.py | 334 + .../site-packages/zmq/green/device.py | 34 + .../zmq/green/eventloop/__init__.py | 3 + .../zmq/green/eventloop/ioloop.py | 1 + .../zmq/green/eventloop/zmqstream.py | 11 + .../site-packages/zmq/green/poll.py | 101 + .../site-packages/zmq/log/__init__.py | 0 .../site-packages/zmq/log/__main__.py | 135 + .../site-packages/zmq/log/handlers.py | 232 + env/lib/python3.12/site-packages/zmq/py.typed | 0 .../site-packages/zmq/ssh/__init__.py | 1 + .../site-packages/zmq/ssh/forward.py | 95 + .../site-packages/zmq/ssh/tunnel.py | 430 + .../site-packages/zmq/sugar/__init__.py | 39 + .../site-packages/zmq/sugar/__init__.pyi | 10 + .../site-packages/zmq/sugar/attrsettr.py | 79 + .../site-packages/zmq/sugar/context.py | 420 + .../site-packages/zmq/sugar/frame.py | 134 + .../site-packages/zmq/sugar/poll.py | 172 + .../site-packages/zmq/sugar/socket.py | 1125 +++ .../site-packages/zmq/sugar/stopwatch.py | 36 + .../site-packages/zmq/sugar/tracker.py | 116 + .../site-packages/zmq/sugar/version.py | 67 + .../site-packages/zmq/tests/__init__.py | 262 + .../site-packages/zmq/utils/__init__.py | 0 .../site-packages/zmq/utils/garbage.py | 213 + .../site-packages/zmq/utils/getpid_compat.h | 7 + .../site-packages/zmq/utils/interop.py | 29 + .../site-packages/zmq/utils/ipcmaxlen.h | 27 + .../site-packages/zmq/utils/jsonapi.py | 38 + .../site-packages/zmq/utils/monitor.py | 128 + .../site-packages/zmq/utils/mutex.h | 84 + .../zmq/utils/pyversion_compat.h | 12 + .../site-packages/zmq/utils/strtypes.py | 62 + .../site-packages/zmq/utils/win32.py | 130 + .../python3.12/site-packages/zmq/utils/z85.py | 58 + .../site-packages/zmq/utils/zmq_compat.h | 100 + env/lib64 | 1 + env/pyvenv.cfg | 5 + logs/access.log | 1984 ++++ logs/error.log | 100 + nginx.conf | 26 +- site/minirt.html | 2 +- site/minishell.html | 2 +- start_app.sh | 2 +- 1440 files changed, 438852 insertions(+), 8 deletions(-) create mode 100644 env/bin/Activate.ps1 create mode 100644 env/bin/activate create mode 100644 env/bin/activate.csh create mode 100644 env/bin/activate.fish create mode 100755 env/bin/pip create mode 100755 env/bin/pip3 create mode 100755 env/bin/pip3.12 create mode 100755 env/bin/pygmentize create mode 120000 env/bin/python create mode 120000 env/bin/python3 create mode 120000 env/bin/python3.12 create mode 100644 env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/LICENSE create mode 100644 env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/aiohappyeyeballs/__init__.py create mode 100644 env/lib/python3.12/site-packages/aiohappyeyeballs/_staggered.py create mode 100644 env/lib/python3.12/site-packages/aiohappyeyeballs/impl.py create mode 100644 env/lib/python3.12/site-packages/aiohappyeyeballs/py.typed create mode 100644 env/lib/python3.12/site-packages/aiohappyeyeballs/types.py create mode 100644 env/lib/python3.12/site-packages/aiohappyeyeballs/utils.py create mode 100644 env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/REQUESTED create mode 100644 env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/licenses/LICENSE.txt create mode 100644 env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/licenses/vendor/llhttp/LICENSE create mode 100644 env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/aiohttp/.hash/_cparser.pxd.hash create mode 100644 env/lib/python3.12/site-packages/aiohttp/.hash/_find_header.pxd.hash create mode 100644 env/lib/python3.12/site-packages/aiohttp/.hash/_http_parser.pyx.hash create mode 100644 env/lib/python3.12/site-packages/aiohttp/.hash/_http_writer.pyx.hash create mode 100644 env/lib/python3.12/site-packages/aiohttp/.hash/hdrs.py.hash create mode 100644 env/lib/python3.12/site-packages/aiohttp/__init__.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/_cookie_helpers.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/_cparser.pxd create mode 100644 env/lib/python3.12/site-packages/aiohttp/_find_header.pxd create mode 100644 env/lib/python3.12/site-packages/aiohttp/_headers.pxi create mode 100755 env/lib/python3.12/site-packages/aiohttp/_http_parser.cpython-312-x86_64-linux-musl.so create mode 100644 env/lib/python3.12/site-packages/aiohttp/_http_parser.pyx create mode 100755 env/lib/python3.12/site-packages/aiohttp/_http_writer.cpython-312-x86_64-linux-musl.so create mode 100644 env/lib/python3.12/site-packages/aiohttp/_http_writer.pyx create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/.hash/mask.pxd.hash create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/.hash/mask.pyx.hash create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/.hash/reader_c.pxd.hash create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/__init__.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/helpers.py create mode 100755 env/lib/python3.12/site-packages/aiohttp/_websocket/mask.cpython-312-x86_64-linux-musl.so create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/mask.pxd create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/mask.pyx create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/models.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/reader.py create mode 100755 env/lib/python3.12/site-packages/aiohttp/_websocket/reader_c.cpython-312-x86_64-linux-musl.so create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/reader_c.pxd create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/reader_c.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/reader_py.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/_websocket/writer.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/abc.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/base_protocol.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/client.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/client_exceptions.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/client_middleware_digest_auth.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/client_middlewares.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/client_proto.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/client_reqrep.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/client_ws.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/compression_utils.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/connector.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/cookiejar.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/formdata.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/hdrs.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/helpers.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/http.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/http_exceptions.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/http_parser.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/http_websocket.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/http_writer.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/log.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/multipart.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/payload.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/payload_streamer.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/py.typed create mode 100644 env/lib/python3.12/site-packages/aiohttp/pytest_plugin.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/resolver.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/streams.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/tcp_helpers.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/test_utils.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/tracing.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/typedefs.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_app.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_exceptions.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_fileresponse.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_log.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_middlewares.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_protocol.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_request.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_response.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_routedef.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_runner.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_server.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_urldispatcher.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/web_ws.py create mode 100644 env/lib/python3.12/site-packages/aiohttp/worker.py create mode 100644 env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/aiosignal/__init__.py create mode 100644 env/lib/python3.12/site-packages/aiosignal/py.typed create mode 100644 env/lib/python3.12/site-packages/attr/__init__.py create mode 100644 env/lib/python3.12/site-packages/attr/__init__.pyi create mode 100644 env/lib/python3.12/site-packages/attr/_cmp.py create mode 100644 env/lib/python3.12/site-packages/attr/_cmp.pyi create mode 100644 env/lib/python3.12/site-packages/attr/_compat.py create mode 100644 env/lib/python3.12/site-packages/attr/_config.py create mode 100644 env/lib/python3.12/site-packages/attr/_funcs.py create mode 100644 env/lib/python3.12/site-packages/attr/_make.py create mode 100644 env/lib/python3.12/site-packages/attr/_next_gen.py create mode 100644 env/lib/python3.12/site-packages/attr/_typing_compat.pyi create mode 100644 env/lib/python3.12/site-packages/attr/_version_info.py create mode 100644 env/lib/python3.12/site-packages/attr/_version_info.pyi create mode 100644 env/lib/python3.12/site-packages/attr/converters.py create mode 100644 env/lib/python3.12/site-packages/attr/converters.pyi create mode 100644 env/lib/python3.12/site-packages/attr/exceptions.py create mode 100644 env/lib/python3.12/site-packages/attr/exceptions.pyi create mode 100644 env/lib/python3.12/site-packages/attr/filters.py create mode 100644 env/lib/python3.12/site-packages/attr/filters.pyi create mode 100644 env/lib/python3.12/site-packages/attr/py.typed create mode 100644 env/lib/python3.12/site-packages/attr/setters.py create mode 100644 env/lib/python3.12/site-packages/attr/setters.pyi create mode 100644 env/lib/python3.12/site-packages/attr/validators.py create mode 100644 env/lib/python3.12/site-packages/attr/validators.pyi create mode 100644 env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/attrs/__init__.py create mode 100644 env/lib/python3.12/site-packages/attrs/__init__.pyi create mode 100644 env/lib/python3.12/site-packages/attrs/converters.py create mode 100644 env/lib/python3.12/site-packages/attrs/exceptions.py create mode 100644 env/lib/python3.12/site-packages/attrs/filters.py create mode 100644 env/lib/python3.12/site-packages/attrs/py.typed create mode 100644 env/lib/python3.12/site-packages/attrs/setters.py create mode 100644 env/lib/python3.12/site-packages/attrs/validators.py create mode 100644 env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/LICENSE create mode 100644 env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/backcall/__init__.py create mode 100644 env/lib/python3.12/site-packages/backcall/_signatures.py create mode 100644 env/lib/python3.12/site-packages/backcall/backcall.py create mode 100644 env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/licenses/LICENSE-MIT create mode 100644 env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/docopt.py create mode 100644 env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/licenses/AUTHORS create mode 100644 env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/fastjsonschema/__init__.py create mode 100644 env/lib/python3.12/site-packages/fastjsonschema/__main__.py create mode 100644 env/lib/python3.12/site-packages/fastjsonschema/draft04.py create mode 100644 env/lib/python3.12/site-packages/fastjsonschema/draft06.py create mode 100644 env/lib/python3.12/site-packages/fastjsonschema/draft07.py create mode 100644 env/lib/python3.12/site-packages/fastjsonschema/exceptions.py create mode 100644 env/lib/python3.12/site-packages/fastjsonschema/generator.py create mode 100644 env/lib/python3.12/site-packages/fastjsonschema/indent.py create mode 100644 env/lib/python3.12/site-packages/fastjsonschema/ref_resolver.py create mode 100644 env/lib/python3.12/site-packages/fastjsonschema/version.py create mode 100644 env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/frozenlist/__init__.py create mode 100644 env/lib/python3.12/site-packages/frozenlist/__init__.pyi create mode 100755 env/lib/python3.12/site-packages/frozenlist/_frozenlist.cpython-312-x86_64-linux-musl.so create mode 100644 env/lib/python3.12/site-packages/frozenlist/_frozenlist.pyx create mode 100644 env/lib/python3.12/site-packages/frozenlist/py.typed create mode 100644 env/lib/python3.12/site-packages/idna-3.11.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/idna-3.11.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/idna-3.11.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/idna-3.11.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/idna-3.11.dist-info/licenses/LICENSE.md create mode 100644 env/lib/python3.12/site-packages/idna/__init__.py create mode 100644 env/lib/python3.12/site-packages/idna/codec.py create mode 100644 env/lib/python3.12/site-packages/idna/compat.py create mode 100644 env/lib/python3.12/site-packages/idna/core.py create mode 100644 env/lib/python3.12/site-packages/idna/idnadata.py create mode 100644 env/lib/python3.12/site-packages/idna/intranges.py create mode 100644 env/lib/python3.12/site-packages/idna/package_data.py create mode 100644 env/lib/python3.12/site-packages/idna/py.typed create mode 100644 env/lib/python3.12/site-packages/idna/uts46data.py create mode 100644 env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/multidict/__init__.py create mode 100644 env/lib/python3.12/site-packages/multidict/_abc.py create mode 100644 env/lib/python3.12/site-packages/multidict/_compat.py create mode 100755 env/lib/python3.12/site-packages/multidict/_multidict.cpython-312-x86_64-linux-musl.so create mode 100644 env/lib/python3.12/site-packages/multidict/_multidict_py.py create mode 100644 env/lib/python3.12/site-packages/multidict/py.typed create mode 100644 env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/DESCRIPTION.rst create mode 100644 env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/metadata.json create mode 100644 env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/pickleshare.py create mode 100644 env/lib/python3.12/site-packages/pip-25.0.1.dist-info/AUTHORS.txt create mode 100644 env/lib/python3.12/site-packages/pip-25.0.1.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/pip-25.0.1.dist-info/LICENSE.txt create mode 100644 env/lib/python3.12/site-packages/pip-25.0.1.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/pip-25.0.1.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/pip-25.0.1.dist-info/REQUESTED create mode 100644 env/lib/python3.12/site-packages/pip-25.0.1.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/pip-25.0.1.dist-info/entry_points.txt create mode 100644 env/lib/python3.12/site-packages/pip-25.0.1.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/pip/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/__main__.py create mode 100644 env/lib/python3.12/site-packages/pip/__pip-runner__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/build_env.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cache.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/autocompletion.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/base_command.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/cmdoptions.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/command_context.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/index_command.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/main.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/main_parser.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/parser.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/progress_bars.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/req_command.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/spinners.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/cli/status_codes.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/cache.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/check.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/completion.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/configuration.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/debug.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/download.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/freeze.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/hash.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/help.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/index.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/inspect.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/install.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/list.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/search.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/show.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/uninstall.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/commands/wheel.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/configuration.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/distributions/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/distributions/base.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/distributions/installed.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/distributions/sdist.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/distributions/wheel.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/exceptions.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/index/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/index/collector.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/index/package_finder.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/index/sources.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/locations/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/locations/_distutils.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/locations/_sysconfig.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/locations/base.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/main.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/metadata/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/metadata/_json.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/metadata/base.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_compat.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_dists.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_envs.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/metadata/pkg_resources.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/models/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/models/candidate.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/models/direct_url.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/models/format_control.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/models/index.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/models/installation_report.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/models/link.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/models/scheme.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/models/search_scope.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/models/selection_prefs.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/models/target_python.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/models/wheel.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/network/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/network/auth.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/network/cache.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/network/download.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/network/lazy_wheel.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/network/session.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/network/utils.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/network/xmlrpc.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/build/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/build/build_tracker.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/build/metadata.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_editable.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_legacy.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/build/wheel.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_editable.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_legacy.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/check.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/freeze.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/install/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/install/editable_legacy.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/install/wheel.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/operations/prepare.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/pyproject.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/req/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/req/constructors.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/req/req_file.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/req/req_install.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/req/req_set.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/req/req_uninstall.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/base.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/legacy/resolver.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/base.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/candidates.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/factory.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/provider.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/reporter.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/requirements.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/resolver.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/self_outdated_check.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/_jaraco_text.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/_log.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/appdirs.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/compat.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/compatibility_tags.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/datetime.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/deprecation.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/direct_url_helpers.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/egg_link.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/entrypoints.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/filesystem.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/filetypes.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/glibc.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/hashes.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/logging.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/misc.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/packaging.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/retry.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/setuptools_build.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/subprocess.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/temp_dir.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/unpacking.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/urls.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/virtualenv.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/utils/wheel.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/vcs/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/vcs/bazaar.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/vcs/git.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/vcs/mercurial.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/vcs/subversion.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/vcs/versioncontrol.py create mode 100644 env/lib/python3.12/site-packages/pip/_internal/wheel_builder.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/_cmd.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/adapter.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/cache.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/file_cache.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/controller.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/filewrapper.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/heuristics.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/py.typed create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/serialize.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/wrapper.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/certifi/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/certifi/__main__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/certifi/cacert.pem create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/certifi/core.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/certifi/py.typed create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/compat.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/database.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/index.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/locators.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/manifest.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/markers.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/metadata.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/resources.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/scripts.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/t32.exe create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/t64-arm.exe create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/t64.exe create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/util.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/version.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/w32.exe create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/w64-arm.exe create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/w64.exe create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distlib/wheel.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distro/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distro/__main__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distro/distro.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/distro/py.typed create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/idna/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/idna/codec.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/idna/compat.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/idna/core.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/idna/idnadata.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/idna/intranges.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/idna/package_data.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/idna/py.typed create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/idna/uts46data.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/msgpack/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/msgpack/exceptions.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/msgpack/ext.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/msgpack/fallback.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/_elffile.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/_manylinux.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/_musllinux.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/_parser.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/_structures.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/_tokenizer.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/_spdx.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/markers.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/metadata.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/py.typed create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/requirements.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/specifiers.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/tags.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/utils.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/packaging/version.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/platformdirs/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/platformdirs/__main__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/platformdirs/android.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/platformdirs/api.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/platformdirs/macos.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/platformdirs/py.typed create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/platformdirs/unix.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/platformdirs/version.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/platformdirs/windows.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/__main__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/cmdline.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/console.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/filter.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatter.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/_mapping.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/bbcode.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/groff.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/html.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/img.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/irc.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/latex.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/other.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/pangomarkup.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/rtf.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/svg.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/terminal.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/terminal256.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/lexer.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/lexers/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/lexers/_mapping.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/lexers/python.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/modeline.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/plugin.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/regexopt.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/scanner.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/sphinxext.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/style.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/styles/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/styles/_mapping.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/token.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/unistring.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pygments/util.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/_impl.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/_in_process/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/py.typed create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/__version__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/_internal_utils.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/adapters.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/api.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/auth.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/certs.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/compat.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/cookies.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/exceptions.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/help.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/hooks.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/models.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/packages.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/sessions.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/status_codes.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/structures.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/requests/utils.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/resolvelib/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/resolvelib/compat/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/resolvelib/compat/collections_abc.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/resolvelib/providers.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/resolvelib/py.typed create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/resolvelib/reporters.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/resolvelib/resolvers.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/resolvelib/structs.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/__main__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_cell_widths.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_emoji_codes.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_emoji_replace.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_export_format.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_extension.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_fileno.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_inspect.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_log_render.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_loop.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_null_file.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_palettes.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_pick.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_ratio.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_spinners.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_stack.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_timer.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_win32_console.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_windows.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_windows_renderer.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/_wrap.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/abc.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/align.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/ansi.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/bar.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/box.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/cells.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/color.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/color_triplet.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/columns.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/console.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/constrain.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/containers.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/control.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/default_styles.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/diagnose.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/emoji.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/errors.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/file_proxy.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/filesize.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/highlighter.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/json.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/jupyter.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/layout.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/live.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/live_render.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/logging.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/markup.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/measure.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/padding.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/pager.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/palette.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/panel.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/pretty.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/progress.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/progress_bar.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/prompt.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/protocol.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/py.typed create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/region.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/repr.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/rule.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/scope.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/screen.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/segment.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/spinner.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/status.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/style.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/styled.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/syntax.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/table.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/terminal_theme.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/text.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/theme.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/themes.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/traceback.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/rich/tree.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/tomli/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/tomli/_parser.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/tomli/_re.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/tomli/_types.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/tomli/py.typed create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/truststore/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/truststore/_api.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/truststore/_macos.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/truststore/_openssl.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/truststore/_ssl_constants.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/truststore/_windows.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/truststore/py.typed create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/typing_extensions.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/_collections.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/_version.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/connection.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/connectionpool.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/appengine.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/securetransport.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/socks.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/exceptions.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/fields.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/filepost.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/weakref_finalize.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/six.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/poolmanager.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/request.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/response.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__init__.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/connection.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/proxy.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/queue.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/request.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/response.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/retry.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssltransport.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/timeout.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/url.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/wait.py create mode 100644 env/lib/python3.12/site-packages/pip/_vendor/vendor.txt create mode 100644 env/lib/python3.12/site-packages/pip/py.typed create mode 100644 env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/platformdirs/__init__.py create mode 100644 env/lib/python3.12/site-packages/platformdirs/__main__.py create mode 100644 env/lib/python3.12/site-packages/platformdirs/_xdg.py create mode 100644 env/lib/python3.12/site-packages/platformdirs/android.py create mode 100644 env/lib/python3.12/site-packages/platformdirs/api.py create mode 100644 env/lib/python3.12/site-packages/platformdirs/macos.py create mode 100644 env/lib/python3.12/site-packages/platformdirs/py.typed create mode 100644 env/lib/python3.12/site-packages/platformdirs/unix.py create mode 100644 env/lib/python3.12/site-packages/platformdirs/version.py create mode 100644 env/lib/python3.12/site-packages/platformdirs/windows.py create mode 100644 env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/licenses/NOTICE create mode 100644 env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/propcache/__init__.py create mode 100644 env/lib/python3.12/site-packages/propcache/_helpers.py create mode 100755 env/lib/python3.12/site-packages/propcache/_helpers_c.cpython-312-x86_64-linux-musl.so create mode 100644 env/lib/python3.12/site-packages/propcache/_helpers_c.pyx create mode 100644 env/lib/python3.12/site-packages/propcache/_helpers_py.py create mode 100644 env/lib/python3.12/site-packages/propcache/api.py create mode 100644 env/lib/python3.12/site-packages/propcache/py.typed create mode 100644 env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/LICENSE create mode 100644 env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/ptyprocess/__init__.py create mode 100644 env/lib/python3.12/site-packages/ptyprocess/_fork_pty.py create mode 100644 env/lib/python3.12/site-packages/ptyprocess/ptyprocess.py create mode 100644 env/lib/python3.12/site-packages/ptyprocess/util.py create mode 100644 env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/LICENSE.txt create mode 100644 env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/pure_eval/__init__.py create mode 100644 env/lib/python3.12/site-packages/pure_eval/core.py create mode 100644 env/lib/python3.12/site-packages/pure_eval/my_getattr_static.py create mode 100644 env/lib/python3.12/site-packages/pure_eval/py.typed create mode 100644 env/lib/python3.12/site-packages/pure_eval/utils.py create mode 100644 env/lib/python3.12/site-packages/pure_eval/version.py create mode 100644 env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/entry_points.txt create mode 100644 env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/licenses/AUTHORS create mode 100644 env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/pygments/__init__.py create mode 100644 env/lib/python3.12/site-packages/pygments/__main__.py create mode 100644 env/lib/python3.12/site-packages/pygments/cmdline.py create mode 100644 env/lib/python3.12/site-packages/pygments/console.py create mode 100644 env/lib/python3.12/site-packages/pygments/filter.py create mode 100644 env/lib/python3.12/site-packages/pygments/filters/__init__.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatter.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/__init__.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/_mapping.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/bbcode.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/groff.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/html.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/img.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/irc.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/latex.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/other.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/pangomarkup.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/rtf.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/svg.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/terminal.py create mode 100644 env/lib/python3.12/site-packages/pygments/formatters/terminal256.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexer.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/__init__.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_ada_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_asy_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_cl_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_cocoa_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_csound_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_css_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_googlesql_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_julia_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_lasso_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_lilypond_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_lua_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_luau_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_mapping.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_mql_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_mysql_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_openedge_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_php_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_postgres_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_qlik_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_scheme_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_scilab_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_sourcemod_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_sql_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_stan_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_stata_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_tsql_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_usd_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_vbscript_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/_vim_builtins.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/actionscript.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ada.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/agile.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/algebra.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ambient.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/amdgpu.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ampl.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/apdlexer.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/apl.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/archetype.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/arrow.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/arturo.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/asc.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/asm.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/asn1.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/automation.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/bare.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/basic.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/bdd.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/berry.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/bibtex.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/blueprint.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/boa.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/bqn.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/business.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/c_cpp.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/c_like.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/capnproto.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/carbon.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/cddl.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/chapel.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/clean.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/codeql.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/comal.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/compiled.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/configs.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/console.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/cplint.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/crystal.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/csound.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/css.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/d.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/dalvik.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/data.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/dax.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/devicetree.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/diff.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/dns.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/dotnet.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/dsls.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/dylan.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ecl.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/eiffel.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/elm.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/elpi.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/email.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/erlang.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/esoteric.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ezhil.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/factor.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/fantom.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/felix.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/fift.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/floscript.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/forth.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/fortran.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/foxpro.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/freefem.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/func.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/functional.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/futhark.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/gcodelexer.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/gdscript.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/gleam.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/go.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/grammar_notation.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/graph.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/graphics.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/graphql.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/graphviz.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/gsql.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/hare.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/haskell.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/haxe.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/hdl.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/hexdump.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/html.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/idl.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/igor.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/inferno.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/installers.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/int_fiction.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/iolang.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/j.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/javascript.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/jmespath.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/jslt.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/json5.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/jsonnet.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/jsx.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/julia.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/jvm.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/kuin.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/kusto.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ldap.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/lean.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/lilypond.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/lisp.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/macaulay2.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/make.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/maple.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/markup.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/math.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/matlab.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/maxima.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/meson.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/mime.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/minecraft.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/mips.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ml.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/modeling.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/modula2.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/mojo.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/monte.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/mosel.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ncl.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/nimrod.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/nit.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/nix.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/numbair.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/oberon.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/objective.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ooc.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/openscad.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/other.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/parasail.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/parsers.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/pascal.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/pawn.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/pddl.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/perl.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/phix.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/php.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/pointless.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/pony.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/praat.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/procfile.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/prolog.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/promql.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/prql.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ptx.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/python.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/q.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/qlik.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/qvt.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/r.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/rdf.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/rebol.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/rego.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/resource.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ride.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/rita.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/rnc.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/roboconf.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/robotframework.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ruby.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/rust.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/sas.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/savi.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/scdoc.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/scripting.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/sgf.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/shell.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/sieve.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/slash.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/smalltalk.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/smithy.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/smv.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/snobol.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/solidity.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/soong.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/sophia.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/special.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/spice.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/sql.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/srcinfo.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/stata.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/supercollider.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/tablegen.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/tact.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/tal.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/tcl.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/teal.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/templates.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/teraterm.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/testing.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/text.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/textedit.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/textfmts.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/theorem.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/thingsdb.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/tlb.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/tls.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/tnt.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/trafficscript.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/typoscript.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/typst.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/ul4.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/unicon.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/urbi.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/usd.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/varnish.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/verification.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/verifpal.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/vip.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/vyper.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/web.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/webassembly.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/webidl.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/webmisc.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/wgsl.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/whiley.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/wowtoc.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/wren.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/x10.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/xorg.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/yang.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/yara.py create mode 100644 env/lib/python3.12/site-packages/pygments/lexers/zig.py create mode 100644 env/lib/python3.12/site-packages/pygments/modeline.py create mode 100644 env/lib/python3.12/site-packages/pygments/plugin.py create mode 100644 env/lib/python3.12/site-packages/pygments/regexopt.py create mode 100644 env/lib/python3.12/site-packages/pygments/scanner.py create mode 100644 env/lib/python3.12/site-packages/pygments/sphinxext.py create mode 100644 env/lib/python3.12/site-packages/pygments/style.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/__init__.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/_mapping.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/abap.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/algol.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/algol_nu.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/arduino.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/autumn.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/borland.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/bw.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/coffee.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/colorful.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/default.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/dracula.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/emacs.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/friendly.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/friendly_grayscale.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/fruity.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/gh_dark.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/gruvbox.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/igor.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/inkpot.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/lightbulb.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/lilypond.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/lovelace.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/manni.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/material.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/monokai.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/murphy.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/native.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/nord.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/onedark.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/paraiso_dark.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/paraiso_light.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/pastie.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/perldoc.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/rainbow_dash.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/rrt.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/sas.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/solarized.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/staroffice.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/stata_dark.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/stata_light.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/tango.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/trac.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/vim.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/vs.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/xcode.py create mode 100644 env/lib/python3.12/site-packages/pygments/styles/zenburn.py create mode 100644 env/lib/python3.12/site-packages/pygments/token.py create mode 100644 env/lib/python3.12/site-packages/pygments/unistring.py create mode 100644 env/lib/python3.12/site-packages/pygments/util.py create mode 100644 env/lib/python3.12/site-packages/pyzmq-27.1.0.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/pyzmq-27.1.0.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/pyzmq-27.1.0.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/pyzmq-27.1.0.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/pyzmq-27.1.0.dist-info/licenses/LICENSE.md create mode 100644 env/lib/python3.12/site-packages/pyzmq-27.1.0.dist-info/licenses/licenses/LICENSE.libsodium.txt create mode 100644 env/lib/python3.12/site-packages/pyzmq-27.1.0.dist-info/licenses/licenses/LICENSE.tornado.txt create mode 100644 env/lib/python3.12/site-packages/pyzmq-27.1.0.dist-info/licenses/licenses/LICENSE.zeromq.txt create mode 100644 env/lib/python3.12/site-packages/pyzmq.libs/libgcc_s-0cd532bd.so.1 create mode 100755 env/lib/python3.12/site-packages/pyzmq.libs/libsodium-8c37ebe2.so.26.2.0 create mode 100755 env/lib/python3.12/site-packages/pyzmq.libs/libstdc++-5d72f927.so.6.0.33 create mode 100755 env/lib/python3.12/site-packages/pyzmq.libs/libzmq-bea72b92.so.5.2.5 create mode 100755 env/lib/python3.12/site-packages/rpds.libs/libgcc_s-98a1ef30.so.1 create mode 100644 env/lib/python3.12/site-packages/rpds/__init__.py create mode 100644 env/lib/python3.12/site-packages/rpds/__init__.pyi create mode 100644 env/lib/python3.12/site-packages/rpds/py.typed create mode 100755 env/lib/python3.12/site-packages/rpds/rpds.cpython-312-x86_64-linux-musl.so create mode 100644 env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/six-1.17.0.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/six-1.17.0.dist-info/LICENSE create mode 100644 env/lib/python3.12/site-packages/six-1.17.0.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/six-1.17.0.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/six-1.17.0.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/six-1.17.0.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/six.py create mode 100644 env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/licenses/LICENSE.md create mode 100644 env/lib/python3.12/site-packages/soupsieve/__init__.py create mode 100644 env/lib/python3.12/site-packages/soupsieve/__meta__.py create mode 100644 env/lib/python3.12/site-packages/soupsieve/css_match.py create mode 100644 env/lib/python3.12/site-packages/soupsieve/css_parser.py create mode 100644 env/lib/python3.12/site-packages/soupsieve/css_types.py create mode 100644 env/lib/python3.12/site-packages/soupsieve/pretty.py create mode 100644 env/lib/python3.12/site-packages/soupsieve/py.typed create mode 100644 env/lib/python3.12/site-packages/soupsieve/util.py create mode 100644 env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/LICENSE create mode 100644 env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/tinycss2/__init__.py create mode 100644 env/lib/python3.12/site-packages/tinycss2/ast.py create mode 100644 env/lib/python3.12/site-packages/tinycss2/bytes.py create mode 100644 env/lib/python3.12/site-packages/tinycss2/color3.py create mode 100644 env/lib/python3.12/site-packages/tinycss2/color4.py create mode 100644 env/lib/python3.12/site-packages/tinycss2/nth.py create mode 100644 env/lib/python3.12/site-packages/tinycss2/parser.py create mode 100644 env/lib/python3.12/site-packages/tinycss2/serializer.py create mode 100644 env/lib/python3.12/site-packages/tinycss2/tokenizer.py create mode 100644 env/lib/python3.12/site-packages/tornado-6.5.4.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/tornado-6.5.4.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/tornado-6.5.4.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/tornado-6.5.4.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/tornado-6.5.4.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/tornado-6.5.4.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/tornado/__init__.py create mode 100644 env/lib/python3.12/site-packages/tornado/__init__.pyi create mode 100644 env/lib/python3.12/site-packages/tornado/_locale_data.py create mode 100644 env/lib/python3.12/site-packages/tornado/auth.py create mode 100644 env/lib/python3.12/site-packages/tornado/autoreload.py create mode 100644 env/lib/python3.12/site-packages/tornado/concurrent.py create mode 100644 env/lib/python3.12/site-packages/tornado/curl_httpclient.py create mode 100644 env/lib/python3.12/site-packages/tornado/escape.py create mode 100644 env/lib/python3.12/site-packages/tornado/gen.py create mode 100644 env/lib/python3.12/site-packages/tornado/http1connection.py create mode 100644 env/lib/python3.12/site-packages/tornado/httpclient.py create mode 100644 env/lib/python3.12/site-packages/tornado/httpserver.py create mode 100644 env/lib/python3.12/site-packages/tornado/httputil.py create mode 100644 env/lib/python3.12/site-packages/tornado/ioloop.py create mode 100644 env/lib/python3.12/site-packages/tornado/iostream.py create mode 100644 env/lib/python3.12/site-packages/tornado/locale.py create mode 100644 env/lib/python3.12/site-packages/tornado/locks.py create mode 100644 env/lib/python3.12/site-packages/tornado/log.py create mode 100644 env/lib/python3.12/site-packages/tornado/netutil.py create mode 100644 env/lib/python3.12/site-packages/tornado/options.py create mode 100644 env/lib/python3.12/site-packages/tornado/platform/__init__.py create mode 100644 env/lib/python3.12/site-packages/tornado/platform/asyncio.py create mode 100644 env/lib/python3.12/site-packages/tornado/platform/caresresolver.py create mode 100644 env/lib/python3.12/site-packages/tornado/platform/twisted.py create mode 100644 env/lib/python3.12/site-packages/tornado/process.py create mode 100644 env/lib/python3.12/site-packages/tornado/py.typed create mode 100644 env/lib/python3.12/site-packages/tornado/queues.py create mode 100644 env/lib/python3.12/site-packages/tornado/routing.py create mode 100644 env/lib/python3.12/site-packages/tornado/simple_httpclient.py create mode 100755 env/lib/python3.12/site-packages/tornado/speedups.abi3.so create mode 100644 env/lib/python3.12/site-packages/tornado/speedups.pyi create mode 100644 env/lib/python3.12/site-packages/tornado/tcpclient.py create mode 100644 env/lib/python3.12/site-packages/tornado/tcpserver.py create mode 100644 env/lib/python3.12/site-packages/tornado/template.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/__init__.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/__main__.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/asyncio_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/auth_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/autoreload_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/circlerefs_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/concurrent_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/csv_translations/fr_FR.csv create mode 100644 env/lib/python3.12/site-packages/tornado/test/curl_httpclient_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/escape_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/gen_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/gettext_translations/fr_FR/LC_MESSAGES/tornado_test.mo create mode 100644 env/lib/python3.12/site-packages/tornado/test/gettext_translations/fr_FR/LC_MESSAGES/tornado_test.po create mode 100644 env/lib/python3.12/site-packages/tornado/test/http1connection_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/httpclient_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/httpserver_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/httputil_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/import_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/ioloop_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/iostream_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/locale_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/locks_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/log_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/netutil_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/options_test.cfg create mode 100644 env/lib/python3.12/site-packages/tornado/test/options_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/options_test_types.cfg create mode 100644 env/lib/python3.12/site-packages/tornado/test/options_test_types_str.cfg create mode 100644 env/lib/python3.12/site-packages/tornado/test/process_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/queues_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/resolve_test_helper.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/routing_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/runtests.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/simple_httpclient_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/static/dir/index.html create mode 100644 env/lib/python3.12/site-packages/tornado/test/static/robots.txt create mode 100644 env/lib/python3.12/site-packages/tornado/test/static/sample.xml create mode 100644 env/lib/python3.12/site-packages/tornado/test/static/sample.xml.bz2 create mode 100644 env/lib/python3.12/site-packages/tornado/test/static/sample.xml.gz create mode 100644 env/lib/python3.12/site-packages/tornado/test/static_foo.txt create mode 100644 env/lib/python3.12/site-packages/tornado/test/tcpclient_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/tcpserver_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/template_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/templates/utf8.html create mode 100644 env/lib/python3.12/site-packages/tornado/test/test.crt create mode 100644 env/lib/python3.12/site-packages/tornado/test/test.key create mode 100644 env/lib/python3.12/site-packages/tornado/test/testing_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/twisted_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/util.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/util_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/web_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/websocket_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/test/wsgi_test.py create mode 100644 env/lib/python3.12/site-packages/tornado/testing.py create mode 100644 env/lib/python3.12/site-packages/tornado/util.py create mode 100644 env/lib/python3.12/site-packages/tornado/web.py create mode 100644 env/lib/python3.12/site-packages/tornado/websocket.py create mode 100644 env/lib/python3.12/site-packages/tornado/wsgi.py create mode 100644 env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/traitlets/__init__.py create mode 100644 env/lib/python3.12/site-packages/traitlets/_version.py create mode 100644 env/lib/python3.12/site-packages/traitlets/config/__init__.py create mode 100644 env/lib/python3.12/site-packages/traitlets/config/application.py create mode 100644 env/lib/python3.12/site-packages/traitlets/config/argcomplete_config.py create mode 100644 env/lib/python3.12/site-packages/traitlets/config/configurable.py create mode 100644 env/lib/python3.12/site-packages/traitlets/config/loader.py create mode 100644 env/lib/python3.12/site-packages/traitlets/config/manager.py create mode 100644 env/lib/python3.12/site-packages/traitlets/config/sphinxdoc.py create mode 100644 env/lib/python3.12/site-packages/traitlets/log.py create mode 100644 env/lib/python3.12/site-packages/traitlets/py.typed create mode 100644 env/lib/python3.12/site-packages/traitlets/tests/__init__.py create mode 100644 env/lib/python3.12/site-packages/traitlets/tests/test_traitlets.py create mode 100644 env/lib/python3.12/site-packages/traitlets/tests/utils.py create mode 100644 env/lib/python3.12/site-packages/traitlets/traitlets.py create mode 100644 env/lib/python3.12/site-packages/traitlets/utils/__init__.py create mode 100644 env/lib/python3.12/site-packages/traitlets/utils/bunch.py create mode 100644 env/lib/python3.12/site-packages/traitlets/utils/decorators.py create mode 100644 env/lib/python3.12/site-packages/traitlets/utils/descriptions.py create mode 100644 env/lib/python3.12/site-packages/traitlets/utils/getargspec.py create mode 100644 env/lib/python3.12/site-packages/traitlets/utils/importstring.py create mode 100644 env/lib/python3.12/site-packages/traitlets/utils/nested_update.py create mode 100644 env/lib/python3.12/site-packages/traitlets/utils/sentinel.py create mode 100644 env/lib/python3.12/site-packages/traitlets/utils/text.py create mode 100644 env/lib/python3.12/site-packages/traitlets/utils/warnings.py create mode 100644 env/lib/python3.12/site-packages/typing_extensions-4.15.0.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/typing_extensions-4.15.0.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/typing_extensions-4.15.0.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/typing_extensions-4.15.0.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/typing_extensions-4.15.0.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/typing_extensions.py create mode 100644 env/lib/python3.12/site-packages/urllib3-2.6.3.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/urllib3-2.6.3.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/urllib3-2.6.3.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/urllib3-2.6.3.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/urllib3-2.6.3.dist-info/licenses/LICENSE.txt create mode 100644 env/lib/python3.12/site-packages/urllib3/__init__.py create mode 100644 env/lib/python3.12/site-packages/urllib3/_base_connection.py create mode 100644 env/lib/python3.12/site-packages/urllib3/_collections.py create mode 100644 env/lib/python3.12/site-packages/urllib3/_request_methods.py create mode 100644 env/lib/python3.12/site-packages/urllib3/_version.py create mode 100644 env/lib/python3.12/site-packages/urllib3/connection.py create mode 100644 env/lib/python3.12/site-packages/urllib3/connectionpool.py create mode 100644 env/lib/python3.12/site-packages/urllib3/contrib/__init__.py create mode 100644 env/lib/python3.12/site-packages/urllib3/contrib/emscripten/__init__.py create mode 100644 env/lib/python3.12/site-packages/urllib3/contrib/emscripten/connection.py create mode 100644 env/lib/python3.12/site-packages/urllib3/contrib/emscripten/emscripten_fetch_worker.js create mode 100644 env/lib/python3.12/site-packages/urllib3/contrib/emscripten/fetch.py create mode 100644 env/lib/python3.12/site-packages/urllib3/contrib/emscripten/request.py create mode 100644 env/lib/python3.12/site-packages/urllib3/contrib/emscripten/response.py create mode 100644 env/lib/python3.12/site-packages/urllib3/contrib/pyopenssl.py create mode 100644 env/lib/python3.12/site-packages/urllib3/contrib/socks.py create mode 100644 env/lib/python3.12/site-packages/urllib3/exceptions.py create mode 100644 env/lib/python3.12/site-packages/urllib3/fields.py create mode 100644 env/lib/python3.12/site-packages/urllib3/filepost.py create mode 100644 env/lib/python3.12/site-packages/urllib3/http2/__init__.py create mode 100644 env/lib/python3.12/site-packages/urllib3/http2/connection.py create mode 100644 env/lib/python3.12/site-packages/urllib3/http2/probe.py create mode 100644 env/lib/python3.12/site-packages/urllib3/poolmanager.py create mode 100644 env/lib/python3.12/site-packages/urllib3/py.typed create mode 100644 env/lib/python3.12/site-packages/urllib3/response.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/__init__.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/connection.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/proxy.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/request.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/response.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/retry.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/ssl_.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/ssl_match_hostname.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/ssltransport.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/timeout.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/url.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/util.py create mode 100644 env/lib/python3.12/site-packages/urllib3/util/wait.py create mode 100644 env/lib/python3.12/site-packages/wcwidth-0.6.0.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/wcwidth-0.6.0.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/wcwidth-0.6.0.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/wcwidth-0.6.0.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/wcwidth-0.6.0.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/wcwidth/__init__.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/bisearch.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/control_codes.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/escape_sequences.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/grapheme.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/py.typed create mode 100644 env/lib/python3.12/site-packages/wcwidth/sgr_state.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/table_ambiguous.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/table_grapheme.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/table_mc.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/table_vs16.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/table_wide.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/table_zero.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/textwrap.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/unicode_versions.py create mode 100644 env/lib/python3.12/site-packages/wcwidth/wcwidth.py create mode 100644 env/lib/python3.12/site-packages/webencodings-0.5.1.dist-info/DESCRIPTION.rst create mode 100644 env/lib/python3.12/site-packages/webencodings-0.5.1.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/webencodings-0.5.1.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/webencodings-0.5.1.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/webencodings-0.5.1.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/webencodings-0.5.1.dist-info/metadata.json create mode 100644 env/lib/python3.12/site-packages/webencodings-0.5.1.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/webencodings/__init__.py create mode 100644 env/lib/python3.12/site-packages/webencodings/labels.py create mode 100644 env/lib/python3.12/site-packages/webencodings/mklabels.py create mode 100644 env/lib/python3.12/site-packages/webencodings/tests.py create mode 100644 env/lib/python3.12/site-packages/webencodings/x_user_defined.py create mode 100644 env/lib/python3.12/site-packages/yarl-1.22.0.dist-info/INSTALLER create mode 100644 env/lib/python3.12/site-packages/yarl-1.22.0.dist-info/METADATA create mode 100644 env/lib/python3.12/site-packages/yarl-1.22.0.dist-info/RECORD create mode 100644 env/lib/python3.12/site-packages/yarl-1.22.0.dist-info/WHEEL create mode 100644 env/lib/python3.12/site-packages/yarl-1.22.0.dist-info/licenses/LICENSE create mode 100644 env/lib/python3.12/site-packages/yarl-1.22.0.dist-info/licenses/NOTICE create mode 100644 env/lib/python3.12/site-packages/yarl-1.22.0.dist-info/top_level.txt create mode 100644 env/lib/python3.12/site-packages/yarl/__init__.py create mode 100644 env/lib/python3.12/site-packages/yarl/_parse.py create mode 100644 env/lib/python3.12/site-packages/yarl/_path.py create mode 100644 env/lib/python3.12/site-packages/yarl/_query.py create mode 100644 env/lib/python3.12/site-packages/yarl/_quoters.py create mode 100644 env/lib/python3.12/site-packages/yarl/_quoting.py create mode 100755 env/lib/python3.12/site-packages/yarl/_quoting_c.cpython-312-x86_64-linux-musl.so create mode 100644 env/lib/python3.12/site-packages/yarl/_quoting_c.pyx create mode 100644 env/lib/python3.12/site-packages/yarl/_quoting_py.py create mode 100644 env/lib/python3.12/site-packages/yarl/_url.py create mode 100644 env/lib/python3.12/site-packages/yarl/py.typed create mode 100644 env/lib/python3.12/site-packages/zmq/__init__.pxd create mode 100644 env/lib/python3.12/site-packages/zmq/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/__init__.pyi create mode 100644 env/lib/python3.12/site-packages/zmq/_future.py create mode 100644 env/lib/python3.12/site-packages/zmq/_future.pyi create mode 100644 env/lib/python3.12/site-packages/zmq/_typing.py create mode 100644 env/lib/python3.12/site-packages/zmq/asyncio.py create mode 100644 env/lib/python3.12/site-packages/zmq/auth/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/auth/asyncio.py create mode 100644 env/lib/python3.12/site-packages/zmq/auth/base.py create mode 100644 env/lib/python3.12/site-packages/zmq/auth/certs.py create mode 100644 env/lib/python3.12/site-packages/zmq/auth/ioloop.py create mode 100644 env/lib/python3.12/site-packages/zmq/auth/thread.py create mode 100644 env/lib/python3.12/site-packages/zmq/backend/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/backend/__init__.pyi create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cffi/README.md create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cffi/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cffi/_cdefs.h create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cffi/_cffi_src.c create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cffi/_poll.py create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cffi/context.py create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cffi/devices.py create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cffi/error.py create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cffi/message.py create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cffi/socket.py create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cffi/utils.py create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cython/__init__.pxd create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cython/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cython/_externs.pxd create mode 100755 env/lib/python3.12/site-packages/zmq/backend/cython/_zmq.abi3.so create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cython/_zmq.pxd create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cython/_zmq.py create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cython/constant_enums.pxi create mode 100644 env/lib/python3.12/site-packages/zmq/backend/cython/libzmq.pxd create mode 100644 env/lib/python3.12/site-packages/zmq/backend/select.py create mode 100644 env/lib/python3.12/site-packages/zmq/constants.py create mode 100644 env/lib/python3.12/site-packages/zmq/decorators.py create mode 100644 env/lib/python3.12/site-packages/zmq/devices/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/devices/basedevice.py create mode 100644 env/lib/python3.12/site-packages/zmq/devices/monitoredqueue.py create mode 100644 env/lib/python3.12/site-packages/zmq/devices/monitoredqueuedevice.py create mode 100644 env/lib/python3.12/site-packages/zmq/devices/proxydevice.py create mode 100644 env/lib/python3.12/site-packages/zmq/devices/proxysteerabledevice.py create mode 100644 env/lib/python3.12/site-packages/zmq/error.py create mode 100644 env/lib/python3.12/site-packages/zmq/eventloop/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/eventloop/_deprecated.py create mode 100644 env/lib/python3.12/site-packages/zmq/eventloop/future.py create mode 100644 env/lib/python3.12/site-packages/zmq/eventloop/ioloop.py create mode 100644 env/lib/python3.12/site-packages/zmq/eventloop/zmqstream.py create mode 100644 env/lib/python3.12/site-packages/zmq/green/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/green/core.py create mode 100644 env/lib/python3.12/site-packages/zmq/green/device.py create mode 100644 env/lib/python3.12/site-packages/zmq/green/eventloop/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/green/eventloop/ioloop.py create mode 100644 env/lib/python3.12/site-packages/zmq/green/eventloop/zmqstream.py create mode 100644 env/lib/python3.12/site-packages/zmq/green/poll.py create mode 100644 env/lib/python3.12/site-packages/zmq/log/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/log/__main__.py create mode 100644 env/lib/python3.12/site-packages/zmq/log/handlers.py create mode 100644 env/lib/python3.12/site-packages/zmq/py.typed create mode 100644 env/lib/python3.12/site-packages/zmq/ssh/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/ssh/forward.py create mode 100644 env/lib/python3.12/site-packages/zmq/ssh/tunnel.py create mode 100644 env/lib/python3.12/site-packages/zmq/sugar/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/sugar/__init__.pyi create mode 100644 env/lib/python3.12/site-packages/zmq/sugar/attrsettr.py create mode 100644 env/lib/python3.12/site-packages/zmq/sugar/context.py create mode 100644 env/lib/python3.12/site-packages/zmq/sugar/frame.py create mode 100644 env/lib/python3.12/site-packages/zmq/sugar/poll.py create mode 100644 env/lib/python3.12/site-packages/zmq/sugar/socket.py create mode 100644 env/lib/python3.12/site-packages/zmq/sugar/stopwatch.py create mode 100644 env/lib/python3.12/site-packages/zmq/sugar/tracker.py create mode 100644 env/lib/python3.12/site-packages/zmq/sugar/version.py create mode 100644 env/lib/python3.12/site-packages/zmq/tests/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/utils/__init__.py create mode 100644 env/lib/python3.12/site-packages/zmq/utils/garbage.py create mode 100644 env/lib/python3.12/site-packages/zmq/utils/getpid_compat.h create mode 100644 env/lib/python3.12/site-packages/zmq/utils/interop.py create mode 100644 env/lib/python3.12/site-packages/zmq/utils/ipcmaxlen.h create mode 100644 env/lib/python3.12/site-packages/zmq/utils/jsonapi.py create mode 100644 env/lib/python3.12/site-packages/zmq/utils/monitor.py create mode 100644 env/lib/python3.12/site-packages/zmq/utils/mutex.h create mode 100644 env/lib/python3.12/site-packages/zmq/utils/pyversion_compat.h create mode 100644 env/lib/python3.12/site-packages/zmq/utils/strtypes.py create mode 100644 env/lib/python3.12/site-packages/zmq/utils/win32.py create mode 100644 env/lib/python3.12/site-packages/zmq/utils/z85.py create mode 100644 env/lib/python3.12/site-packages/zmq/utils/zmq_compat.h create mode 120000 env/lib64 create mode 100644 env/pyvenv.cfg create mode 100644 logs/access.log create mode 100644 logs/error.log diff --git a/env/bin/Activate.ps1 b/env/bin/Activate.ps1 new file mode 100644 index 0000000..b49d77b --- /dev/null +++ b/env/bin/Activate.ps1 @@ -0,0 +1,247 @@ +<# +.Synopsis +Activate a Python virtual environment for the current PowerShell session. + +.Description +Pushes the python executable for a virtual environment to the front of the +$Env:PATH environment variable and sets the prompt to signify that you are +in a Python virtual environment. Makes use of the command line switches as +well as the `pyvenv.cfg` file values present in the virtual environment. + +.Parameter VenvDir +Path to the directory that contains the virtual environment to activate. The +default value for this is the parent of the directory that the Activate.ps1 +script is located within. + +.Parameter Prompt +The prompt prefix to display when this virtual environment is activated. By +default, this prompt is the name of the virtual environment folder (VenvDir) +surrounded by parentheses and followed by a single space (ie. '(.venv) '). + +.Example +Activate.ps1 +Activates the Python virtual environment that contains the Activate.ps1 script. + +.Example +Activate.ps1 -Verbose +Activates the Python virtual environment that contains the Activate.ps1 script, +and shows extra information about the activation as it executes. + +.Example +Activate.ps1 -VenvDir C:\Users\MyUser\Common\.venv +Activates the Python virtual environment located in the specified location. + +.Example +Activate.ps1 -Prompt "MyPython" +Activates the Python virtual environment that contains the Activate.ps1 script, +and prefixes the current prompt with the specified string (surrounded in +parentheses) while the virtual environment is active. + +.Notes +On Windows, it may be required to enable this Activate.ps1 script by setting the +execution policy for the user. You can do this by issuing the following PowerShell +command: + +PS C:\> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser + +For more information on Execution Policies: +https://go.microsoft.com/fwlink/?LinkID=135170 + +#> +Param( + [Parameter(Mandatory = $false)] + [String] + $VenvDir, + [Parameter(Mandatory = $false)] + [String] + $Prompt +) + +<# Function declarations --------------------------------------------------- #> + +<# +.Synopsis +Remove all shell session elements added by the Activate script, including the +addition of the virtual environment's Python executable from the beginning of +the PATH variable. + +.Parameter NonDestructive +If present, do not remove this function from the global namespace for the +session. + +#> +function global:deactivate ([switch]$NonDestructive) { + # Revert to original values + + # The prior prompt: + if (Test-Path -Path Function:_OLD_VIRTUAL_PROMPT) { + Copy-Item -Path Function:_OLD_VIRTUAL_PROMPT -Destination Function:prompt + Remove-Item -Path Function:_OLD_VIRTUAL_PROMPT + } + + # The prior PYTHONHOME: + if (Test-Path -Path Env:_OLD_VIRTUAL_PYTHONHOME) { + Copy-Item -Path Env:_OLD_VIRTUAL_PYTHONHOME -Destination Env:PYTHONHOME + Remove-Item -Path Env:_OLD_VIRTUAL_PYTHONHOME + } + + # The prior PATH: + if (Test-Path -Path Env:_OLD_VIRTUAL_PATH) { + Copy-Item -Path Env:_OLD_VIRTUAL_PATH -Destination Env:PATH + Remove-Item -Path Env:_OLD_VIRTUAL_PATH + } + + # Just remove the VIRTUAL_ENV altogether: + if (Test-Path -Path Env:VIRTUAL_ENV) { + Remove-Item -Path env:VIRTUAL_ENV + } + + # Just remove VIRTUAL_ENV_PROMPT altogether. + if (Test-Path -Path Env:VIRTUAL_ENV_PROMPT) { + Remove-Item -Path env:VIRTUAL_ENV_PROMPT + } + + # Just remove the _PYTHON_VENV_PROMPT_PREFIX altogether: + if (Get-Variable -Name "_PYTHON_VENV_PROMPT_PREFIX" -ErrorAction SilentlyContinue) { + Remove-Variable -Name _PYTHON_VENV_PROMPT_PREFIX -Scope Global -Force + } + + # Leave deactivate function in the global namespace if requested: + if (-not $NonDestructive) { + Remove-Item -Path function:deactivate + } +} + +<# +.Description +Get-PyVenvConfig parses the values from the pyvenv.cfg file located in the +given folder, and returns them in a map. + +For each line in the pyvenv.cfg file, if that line can be parsed into exactly +two strings separated by `=` (with any amount of whitespace surrounding the =) +then it is considered a `key = value` line. The left hand string is the key, +the right hand is the value. + +If the value starts with a `'` or a `"` then the first and last character is +stripped from the value before being captured. + +.Parameter ConfigDir +Path to the directory that contains the `pyvenv.cfg` file. +#> +function Get-PyVenvConfig( + [String] + $ConfigDir +) { + Write-Verbose "Given ConfigDir=$ConfigDir, obtain values in pyvenv.cfg" + + # Ensure the file exists, and issue a warning if it doesn't (but still allow the function to continue). + $pyvenvConfigPath = Join-Path -Resolve -Path $ConfigDir -ChildPath 'pyvenv.cfg' -ErrorAction Continue + + # An empty map will be returned if no config file is found. + $pyvenvConfig = @{ } + + if ($pyvenvConfigPath) { + + Write-Verbose "File exists, parse `key = value` lines" + $pyvenvConfigContent = Get-Content -Path $pyvenvConfigPath + + $pyvenvConfigContent | ForEach-Object { + $keyval = $PSItem -split "\s*=\s*", 2 + if ($keyval[0] -and $keyval[1]) { + $val = $keyval[1] + + # Remove extraneous quotations around a string value. + if ("'""".Contains($val.Substring(0, 1))) { + $val = $val.Substring(1, $val.Length - 2) + } + + $pyvenvConfig[$keyval[0]] = $val + Write-Verbose "Adding Key: '$($keyval[0])'='$val'" + } + } + } + return $pyvenvConfig +} + + +<# Begin Activate script --------------------------------------------------- #> + +# Determine the containing directory of this script +$VenvExecPath = Split-Path -Parent $MyInvocation.MyCommand.Definition +$VenvExecDir = Get-Item -Path $VenvExecPath + +Write-Verbose "Activation script is located in path: '$VenvExecPath'" +Write-Verbose "VenvExecDir Fullname: '$($VenvExecDir.FullName)" +Write-Verbose "VenvExecDir Name: '$($VenvExecDir.Name)" + +# Set values required in priority: CmdLine, ConfigFile, Default +# First, get the location of the virtual environment, it might not be +# VenvExecDir if specified on the command line. +if ($VenvDir) { + Write-Verbose "VenvDir given as parameter, using '$VenvDir' to determine values" +} +else { + Write-Verbose "VenvDir not given as a parameter, using parent directory name as VenvDir." + $VenvDir = $VenvExecDir.Parent.FullName.TrimEnd("\\/") + Write-Verbose "VenvDir=$VenvDir" +} + +# Next, read the `pyvenv.cfg` file to determine any required value such +# as `prompt`. +$pyvenvCfg = Get-PyVenvConfig -ConfigDir $VenvDir + +# Next, set the prompt from the command line, or the config file, or +# just use the name of the virtual environment folder. +if ($Prompt) { + Write-Verbose "Prompt specified as argument, using '$Prompt'" +} +else { + Write-Verbose "Prompt not specified as argument to script, checking pyvenv.cfg value" + if ($pyvenvCfg -and $pyvenvCfg['prompt']) { + Write-Verbose " Setting based on value in pyvenv.cfg='$($pyvenvCfg['prompt'])'" + $Prompt = $pyvenvCfg['prompt']; + } + else { + Write-Verbose " Setting prompt based on parent's directory's name. (Is the directory name passed to venv module when creating the virtual environment)" + Write-Verbose " Got leaf-name of $VenvDir='$(Split-Path -Path $venvDir -Leaf)'" + $Prompt = Split-Path -Path $venvDir -Leaf + } +} + +Write-Verbose "Prompt = '$Prompt'" +Write-Verbose "VenvDir='$VenvDir'" + +# Deactivate any currently active virtual environment, but leave the +# deactivate function in place. +deactivate -nondestructive + +# Now set the environment variable VIRTUAL_ENV, used by many tools to determine +# that there is an activated venv. +$env:VIRTUAL_ENV = $VenvDir + +if (-not $Env:VIRTUAL_ENV_DISABLE_PROMPT) { + + Write-Verbose "Setting prompt to '$Prompt'" + + # Set the prompt to include the env name + # Make sure _OLD_VIRTUAL_PROMPT is global + function global:_OLD_VIRTUAL_PROMPT { "" } + Copy-Item -Path function:prompt -Destination function:_OLD_VIRTUAL_PROMPT + New-Variable -Name _PYTHON_VENV_PROMPT_PREFIX -Description "Python virtual environment prompt prefix" -Scope Global -Option ReadOnly -Visibility Public -Value $Prompt + + function global:prompt { + Write-Host -NoNewline -ForegroundColor Green "($_PYTHON_VENV_PROMPT_PREFIX) " + _OLD_VIRTUAL_PROMPT + } + $env:VIRTUAL_ENV_PROMPT = $Prompt +} + +# Clear PYTHONHOME +if (Test-Path -Path Env:PYTHONHOME) { + Copy-Item -Path Env:PYTHONHOME -Destination Env:_OLD_VIRTUAL_PYTHONHOME + Remove-Item -Path Env:PYTHONHOME +} + +# Add the venv to the PATH +Copy-Item -Path Env:PATH -Destination Env:_OLD_VIRTUAL_PATH +$Env:PATH = "$VenvExecDir$([System.IO.Path]::PathSeparator)$Env:PATH" diff --git a/env/bin/activate b/env/bin/activate new file mode 100644 index 0000000..aecc333 --- /dev/null +++ b/env/bin/activate @@ -0,0 +1,76 @@ +# This file must be used with "source bin/activate" *from bash* +# You cannot run it directly + +deactivate () { + # reset old environment variables + if [ -n "${_OLD_VIRTUAL_PATH:-}" ] ; then + PATH="${_OLD_VIRTUAL_PATH:-}" + export PATH + unset _OLD_VIRTUAL_PATH + fi + if [ -n "${_OLD_VIRTUAL_PYTHONHOME:-}" ] ; then + PYTHONHOME="${_OLD_VIRTUAL_PYTHONHOME:-}" + export PYTHONHOME + unset _OLD_VIRTUAL_PYTHONHOME + fi + + # Call hash to forget past locations. Without forgetting + # past locations the $PATH changes we made may not be respected. + # See "man bash" for more details. hash is usually a builtin of your shell + hash -r 2> /dev/null + + if [ -n "${_OLD_VIRTUAL_PS1:-}" ] ; then + PS1="${_OLD_VIRTUAL_PS1:-}" + export PS1 + unset _OLD_VIRTUAL_PS1 + fi + + unset VIRTUAL_ENV + unset VIRTUAL_ENV_PROMPT + if [ ! "${1:-}" = "nondestructive" ] ; then + # Self destruct! + unset -f deactivate + fi +} + +# unset irrelevant variables +deactivate nondestructive + +# on Windows, a path can contain colons and backslashes and has to be converted: +case "$(uname)" in + CYGWIN*|MSYS*|MINGW*) + # transform D:\path\to\venv to /d/path/to/venv on MSYS and MINGW + # and to /cygdrive/d/path/to/venv on Cygwin + VIRTUAL_ENV=$(cygpath /home/website/website/env) + export VIRTUAL_ENV + ;; + *) + # use the path as-is + export VIRTUAL_ENV=/home/website/website/env + ;; +esac + +_OLD_VIRTUAL_PATH="$PATH" +PATH="$VIRTUAL_ENV/"bin":$PATH" +export PATH + +VIRTUAL_ENV_PROMPT='(env) ' +export VIRTUAL_ENV_PROMPT + +# unset PYTHONHOME if set +# this will fail if PYTHONHOME is set to the empty string (which is bad anyway) +# could use `if (set -u; : $PYTHONHOME) ;` in bash +if [ -n "${PYTHONHOME:-}" ] ; then + _OLD_VIRTUAL_PYTHONHOME="${PYTHONHOME:-}" + unset PYTHONHOME +fi + +if [ -z "${VIRTUAL_ENV_DISABLE_PROMPT:-}" ] ; then + _OLD_VIRTUAL_PS1="${PS1:-}" + PS1="("'(env) '") ${PS1:-}" + export PS1 +fi + +# Call hash to forget past commands. Without forgetting +# past commands the $PATH changes we made may not be respected +hash -r 2> /dev/null diff --git a/env/bin/activate.csh b/env/bin/activate.csh new file mode 100644 index 0000000..f69fc84 --- /dev/null +++ b/env/bin/activate.csh @@ -0,0 +1,27 @@ +# This file must be used with "source bin/activate.csh" *from csh*. +# You cannot run it directly. + +# Created by Davide Di Blasi . +# Ported to Python 3.3 venv by Andrew Svetlov + +alias deactivate 'test $?_OLD_VIRTUAL_PATH != 0 && setenv PATH "$_OLD_VIRTUAL_PATH" && unset _OLD_VIRTUAL_PATH; rehash; test $?_OLD_VIRTUAL_PROMPT != 0 && set prompt="$_OLD_VIRTUAL_PROMPT" && unset _OLD_VIRTUAL_PROMPT; unsetenv VIRTUAL_ENV; unsetenv VIRTUAL_ENV_PROMPT; test "\!:*" != "nondestructive" && unalias deactivate' + +# Unset irrelevant variables. +deactivate nondestructive + +setenv VIRTUAL_ENV /home/website/website/env + +set _OLD_VIRTUAL_PATH="$PATH" +setenv PATH "$VIRTUAL_ENV/"bin":$PATH" + + +set _OLD_VIRTUAL_PROMPT="$prompt" + +if (! "$?VIRTUAL_ENV_DISABLE_PROMPT") then + set prompt = '(env) '"$prompt" + setenv VIRTUAL_ENV_PROMPT '(env) ' +endif + +alias pydoc python -m pydoc + +rehash diff --git a/env/bin/activate.fish b/env/bin/activate.fish new file mode 100644 index 0000000..dea0eff --- /dev/null +++ b/env/bin/activate.fish @@ -0,0 +1,69 @@ +# This file must be used with "source /bin/activate.fish" *from fish* +# (https://fishshell.com/). You cannot run it directly. + +function deactivate -d "Exit virtual environment and return to normal shell environment" + # reset old environment variables + if test -n "$_OLD_VIRTUAL_PATH" + set -gx PATH $_OLD_VIRTUAL_PATH + set -e _OLD_VIRTUAL_PATH + end + if test -n "$_OLD_VIRTUAL_PYTHONHOME" + set -gx PYTHONHOME $_OLD_VIRTUAL_PYTHONHOME + set -e _OLD_VIRTUAL_PYTHONHOME + end + + if test -n "$_OLD_FISH_PROMPT_OVERRIDE" + set -e _OLD_FISH_PROMPT_OVERRIDE + # prevents error when using nested fish instances (Issue #93858) + if functions -q _old_fish_prompt + functions -e fish_prompt + functions -c _old_fish_prompt fish_prompt + functions -e _old_fish_prompt + end + end + + set -e VIRTUAL_ENV + set -e VIRTUAL_ENV_PROMPT + if test "$argv[1]" != "nondestructive" + # Self-destruct! + functions -e deactivate + end +end + +# Unset irrelevant variables. +deactivate nondestructive + +set -gx VIRTUAL_ENV /home/website/website/env + +set -gx _OLD_VIRTUAL_PATH $PATH +set -gx PATH "$VIRTUAL_ENV/"bin $PATH + +# Unset PYTHONHOME if set. +if set -q PYTHONHOME + set -gx _OLD_VIRTUAL_PYTHONHOME $PYTHONHOME + set -e PYTHONHOME +end + +if test -z "$VIRTUAL_ENV_DISABLE_PROMPT" + # fish uses a function instead of an env var to generate the prompt. + + # Save the current fish_prompt function as the function _old_fish_prompt. + functions -c fish_prompt _old_fish_prompt + + # With the original prompt function renamed, we can override with our own. + function fish_prompt + # Save the return status of the last command. + set -l old_status $status + + # Output the venv prompt; color taken from the blue of the Python logo. + printf "%s%s%s" (set_color 4B8BBE) '(env) ' (set_color normal) + + # Restore the return status of the previous command. + echo "exit $old_status" | . + # Output the original/"old" prompt. + _old_fish_prompt + end + + set -gx _OLD_FISH_PROMPT_OVERRIDE "$VIRTUAL_ENV" + set -gx VIRTUAL_ENV_PROMPT '(env) ' +end diff --git a/env/bin/pip b/env/bin/pip new file mode 100755 index 0000000..7d7669b --- /dev/null +++ b/env/bin/pip @@ -0,0 +1,8 @@ +#!/home/website/website/env/bin/python3 +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/env/bin/pip3 b/env/bin/pip3 new file mode 100755 index 0000000..7d7669b --- /dev/null +++ b/env/bin/pip3 @@ -0,0 +1,8 @@ +#!/home/website/website/env/bin/python3 +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/env/bin/pip3.12 b/env/bin/pip3.12 new file mode 100755 index 0000000..7d7669b --- /dev/null +++ b/env/bin/pip3.12 @@ -0,0 +1,8 @@ +#!/home/website/website/env/bin/python3 +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/env/bin/pygmentize b/env/bin/pygmentize new file mode 100755 index 0000000..c388434 --- /dev/null +++ b/env/bin/pygmentize @@ -0,0 +1,8 @@ +#!/home/website/website/env/bin/python3 +# -*- coding: utf-8 -*- +import re +import sys +from pygments.cmdline import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/env/bin/python b/env/bin/python new file mode 120000 index 0000000..b8a0adb --- /dev/null +++ b/env/bin/python @@ -0,0 +1 @@ +python3 \ No newline at end of file diff --git a/env/bin/python3 b/env/bin/python3 new file mode 120000 index 0000000..ae65fda --- /dev/null +++ b/env/bin/python3 @@ -0,0 +1 @@ +/usr/bin/python3 \ No newline at end of file diff --git a/env/bin/python3.12 b/env/bin/python3.12 new file mode 120000 index 0000000..b8a0adb --- /dev/null +++ b/env/bin/python3.12 @@ -0,0 +1 @@ +python3 \ No newline at end of file diff --git a/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/INSTALLER b/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/LICENSE b/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/LICENSE new file mode 100644 index 0000000..f26bcf4 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/LICENSE @@ -0,0 +1,279 @@ +A. HISTORY OF THE SOFTWARE +========================== + +Python was created in the early 1990s by Guido van Rossum at Stichting +Mathematisch Centrum (CWI, see https://www.cwi.nl) in the Netherlands +as a successor of a language called ABC. Guido remains Python's +principal author, although it includes many contributions from others. + +In 1995, Guido continued his work on Python at the Corporation for +National Research Initiatives (CNRI, see https://www.cnri.reston.va.us) +in Reston, Virginia where he released several versions of the +software. + +In May 2000, Guido and the Python core development team moved to +BeOpen.com to form the BeOpen PythonLabs team. In October of the same +year, the PythonLabs team moved to Digital Creations, which became +Zope Corporation. In 2001, the Python Software Foundation (PSF, see +https://www.python.org/psf/) was formed, a non-profit organization +created specifically to own Python-related Intellectual Property. +Zope Corporation was a sponsoring member of the PSF. + +All Python releases are Open Source (see https://opensource.org for +the Open Source Definition). Historically, most, but not all, Python +releases have also been GPL-compatible; the table below summarizes +the various releases. + + Release Derived Year Owner GPL- + from compatible? (1) + + 0.9.0 thru 1.2 1991-1995 CWI yes + 1.3 thru 1.5.2 1.2 1995-1999 CNRI yes + 1.6 1.5.2 2000 CNRI no + 2.0 1.6 2000 BeOpen.com no + 1.6.1 1.6 2001 CNRI yes (2) + 2.1 2.0+1.6.1 2001 PSF no + 2.0.1 2.0+1.6.1 2001 PSF yes + 2.1.1 2.1+2.0.1 2001 PSF yes + 2.1.2 2.1.1 2002 PSF yes + 2.1.3 2.1.2 2002 PSF yes + 2.2 and above 2.1.1 2001-now PSF yes + +Footnotes: + +(1) GPL-compatible doesn't mean that we're distributing Python under + the GPL. All Python licenses, unlike the GPL, let you distribute + a modified version without making your changes open source. The + GPL-compatible licenses make it possible to combine Python with + other software that is released under the GPL; the others don't. + +(2) According to Richard Stallman, 1.6.1 is not GPL-compatible, + because its license has a choice of law clause. According to + CNRI, however, Stallman's lawyer has told CNRI's lawyer that 1.6.1 + is "not incompatible" with the GPL. + +Thanks to the many outside volunteers who have worked under Guido's +direction to make these releases possible. + + +B. TERMS AND CONDITIONS FOR ACCESSING OR OTHERWISE USING PYTHON +=============================================================== + +Python software and documentation are licensed under the +Python Software Foundation License Version 2. + +Starting with Python 3.8.6, examples, recipes, and other code in +the documentation are dual licensed under the PSF License Version 2 +and the Zero-Clause BSD license. + +Some software incorporated into Python is under different licenses. +The licenses are listed with code falling under that license. + + +PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2 +-------------------------------------------- + +1. This LICENSE AGREEMENT is between the Python Software Foundation +("PSF"), and the Individual or Organization ("Licensee") accessing and +otherwise using this software ("Python") in source or binary form and +its associated documentation. + +2. Subject to the terms and conditions of this License Agreement, PSF hereby +grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce, +analyze, test, perform and/or display publicly, prepare derivative works, +distribute, and otherwise use Python alone or in any derivative version, +provided, however, that PSF's License Agreement and PSF's notice of copyright, +i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, +2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Python Software Foundation; +All Rights Reserved" are retained in Python alone or in any derivative version +prepared by Licensee. + +3. In the event Licensee prepares a derivative work that is based on +or incorporates Python or any part thereof, and wants to make +the derivative work available to others as provided herein, then +Licensee hereby agrees to include in any such work a brief summary of +the changes made to Python. + +4. PSF is making Python available to Licensee on an "AS IS" +basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR +IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT +INFRINGE ANY THIRD PARTY RIGHTS. + +5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON +FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS +A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON, +OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. + +6. This License Agreement will automatically terminate upon a material +breach of its terms and conditions. + +7. Nothing in this License Agreement shall be deemed to create any +relationship of agency, partnership, or joint venture between PSF and +Licensee. This License Agreement does not grant permission to use PSF +trademarks or trade name in a trademark sense to endorse or promote +products or services of Licensee, or any third party. + +8. By copying, installing or otherwise using Python, Licensee +agrees to be bound by the terms and conditions of this License +Agreement. + + +BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0 +------------------------------------------- + +BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1 + +1. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an +office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the +Individual or Organization ("Licensee") accessing and otherwise using +this software in source or binary form and its associated +documentation ("the Software"). + +2. Subject to the terms and conditions of this BeOpen Python License +Agreement, BeOpen hereby grants Licensee a non-exclusive, +royalty-free, world-wide license to reproduce, analyze, test, perform +and/or display publicly, prepare derivative works, distribute, and +otherwise use the Software alone or in any derivative version, +provided, however, that the BeOpen Python License is retained in the +Software, alone or in any derivative version prepared by Licensee. + +3. BeOpen is making the Software available to Licensee on an "AS IS" +basis. BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR +IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT +INFRINGE ANY THIRD PARTY RIGHTS. + +4. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE +SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS +AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY +DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. + +5. This License Agreement will automatically terminate upon a material +breach of its terms and conditions. + +6. This License Agreement shall be governed by and interpreted in all +respects by the law of the State of California, excluding conflict of +law provisions. Nothing in this License Agreement shall be deemed to +create any relationship of agency, partnership, or joint venture +between BeOpen and Licensee. This License Agreement does not grant +permission to use BeOpen trademarks or trade names in a trademark +sense to endorse or promote products or services of Licensee, or any +third party. As an exception, the "BeOpen Python" logos available at +http://www.pythonlabs.com/logos.html may be used according to the +permissions granted on that web page. + +7. By copying, installing or otherwise using the software, Licensee +agrees to be bound by the terms and conditions of this License +Agreement. + + +CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1 +--------------------------------------- + +1. This LICENSE AGREEMENT is between the Corporation for National +Research Initiatives, having an office at 1895 Preston White Drive, +Reston, VA 20191 ("CNRI"), and the Individual or Organization +("Licensee") accessing and otherwise using Python 1.6.1 software in +source or binary form and its associated documentation. + +2. Subject to the terms and conditions of this License Agreement, CNRI +hereby grants Licensee a nonexclusive, royalty-free, world-wide +license to reproduce, analyze, test, perform and/or display publicly, +prepare derivative works, distribute, and otherwise use Python 1.6.1 +alone or in any derivative version, provided, however, that CNRI's +License Agreement and CNRI's notice of copyright, i.e., "Copyright (c) +1995-2001 Corporation for National Research Initiatives; All Rights +Reserved" are retained in Python 1.6.1 alone or in any derivative +version prepared by Licensee. Alternately, in lieu of CNRI's License +Agreement, Licensee may substitute the following text (omitting the +quotes): "Python 1.6.1 is made available subject to the terms and +conditions in CNRI's License Agreement. This Agreement together with +Python 1.6.1 may be located on the internet using the following +unique, persistent identifier (known as a handle): 1895.22/1013. This +Agreement may also be obtained from a proxy server on the internet +using the following URL: http://hdl.handle.net/1895.22/1013". + +3. In the event Licensee prepares a derivative work that is based on +or incorporates Python 1.6.1 or any part thereof, and wants to make +the derivative work available to others as provided herein, then +Licensee hereby agrees to include in any such work a brief summary of +the changes made to Python 1.6.1. + +4. CNRI is making Python 1.6.1 available to Licensee on an "AS IS" +basis. CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR +IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT +INFRINGE ANY THIRD PARTY RIGHTS. + +5. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON +1.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS +A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1, +OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. + +6. This License Agreement will automatically terminate upon a material +breach of its terms and conditions. + +7. This License Agreement shall be governed by the federal +intellectual property law of the United States, including without +limitation the federal copyright law, and, to the extent such +U.S. federal law does not apply, by the law of the Commonwealth of +Virginia, excluding Virginia's conflict of law provisions. +Notwithstanding the foregoing, with regard to derivative works based +on Python 1.6.1 that incorporate non-separable material that was +previously distributed under the GNU General Public License (GPL), the +law of the Commonwealth of Virginia shall govern this License +Agreement only as to issues arising under or with respect to +Paragraphs 4, 5, and 7 of this License Agreement. Nothing in this +License Agreement shall be deemed to create any relationship of +agency, partnership, or joint venture between CNRI and Licensee. This +License Agreement does not grant permission to use CNRI trademarks or +trade name in a trademark sense to endorse or promote products or +services of Licensee, or any third party. + +8. By clicking on the "ACCEPT" button where indicated, or by copying, +installing or otherwise using Python 1.6.1, Licensee agrees to be +bound by the terms and conditions of this License Agreement. + + ACCEPT + + +CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2 +-------------------------------------------------- + +Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam, +The Netherlands. 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 Stichting Mathematisch +Centrum or CWI not be used in advertising or publicity pertaining to +distribution of the software without specific, written prior +permission. + +STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO +THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND +FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM 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. + +ZERO-CLAUSE BSD LICENSE FOR CODE IN THE PYTHON DOCUMENTATION +---------------------------------------------------------------------- + +Permission to use, copy, modify, and/or distribute this software for any +purpose with or without fee is hereby granted. + +THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH +REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY +AND FITNESS. IN NO EVENT SHALL THE AUTHOR 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. diff --git a/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/METADATA b/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/METADATA new file mode 100644 index 0000000..c632040 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/METADATA @@ -0,0 +1,123 @@ +Metadata-Version: 2.3 +Name: aiohappyeyeballs +Version: 2.6.1 +Summary: Happy Eyeballs for asyncio +License: PSF-2.0 +Author: J. Nick Koston +Author-email: nick@koston.org +Requires-Python: >=3.9 +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: Natural Language :: English +Classifier: Operating System :: OS Independent +Classifier: Topic :: Software Development :: Libraries +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: License :: OSI Approved :: Python Software Foundation License +Project-URL: Bug Tracker, https://github.com/aio-libs/aiohappyeyeballs/issues +Project-URL: Changelog, https://github.com/aio-libs/aiohappyeyeballs/blob/main/CHANGELOG.md +Project-URL: Documentation, https://aiohappyeyeballs.readthedocs.io +Project-URL: Repository, https://github.com/aio-libs/aiohappyeyeballs +Description-Content-Type: text/markdown + +# aiohappyeyeballs + +

+ + CI Status + + + Documentation Status + + + Test coverage percentage + +

+

+ + Poetry + + + Ruff + + + pre-commit + +

+

+ + PyPI Version + + Supported Python versions + License +

+ +--- + +**Documentation**: https://aiohappyeyeballs.readthedocs.io + +**Source Code**: https://github.com/aio-libs/aiohappyeyeballs + +--- + +[Happy Eyeballs](https://en.wikipedia.org/wiki/Happy_Eyeballs) +([RFC 8305](https://www.rfc-editor.org/rfc/rfc8305.html)) + +## Use case + +This library exists to allow connecting with +[Happy Eyeballs](https://en.wikipedia.org/wiki/Happy_Eyeballs) +([RFC 8305](https://www.rfc-editor.org/rfc/rfc8305.html)) +when you +already have a list of addrinfo and not a DNS name. + +The stdlib version of `loop.create_connection()` +will only work when you pass in an unresolved name which +is not a good fit when using DNS caching or resolving +names via another method such as `zeroconf`. + +## Installation + +Install this via pip (or your favourite package manager): + +`pip install aiohappyeyeballs` + +## License + +[aiohappyeyeballs is licensed under the same terms as cpython itself.](https://github.com/python/cpython/blob/main/LICENSE) + +## Example usage + +```python + +addr_infos = await loop.getaddrinfo("example.org", 80) + +socket = await start_connection(addr_infos) +socket = await start_connection(addr_infos, local_addr_infos=local_addr_infos, happy_eyeballs_delay=0.2) + +transport, protocol = await loop.create_connection( + MyProtocol, sock=socket, ...) + +# Remove the first address for each family from addr_info +pop_addr_infos_interleave(addr_info, 1) + +# Remove all matching address from addr_info +remove_addr_infos(addr_info, "dead::beef::") + +# Convert a local_addr to local_addr_infos +local_addr_infos = addr_to_addr_infos(("127.0.0.1",0)) +``` + +## Credits + +This package contains code from cpython and is licensed under the same terms as cpython itself. + +This package was created with +[Copier](https://copier.readthedocs.io/) and the +[browniebroke/pypackage-template](https://github.com/browniebroke/pypackage-template) +project template. + diff --git a/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/RECORD b/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/RECORD new file mode 100644 index 0000000..9e0e202 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/RECORD @@ -0,0 +1,16 @@ +aiohappyeyeballs-2.6.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +aiohappyeyeballs-2.6.1.dist-info/LICENSE,sha256=Oy-B_iHRgcSZxZolbI4ZaEVdZonSaaqFNzv7avQdo78,13936 +aiohappyeyeballs-2.6.1.dist-info/METADATA,sha256=NSXlhJwAfi380eEjAo7BQ4P_TVal9xi0qkyZWibMsVM,5915 +aiohappyeyeballs-2.6.1.dist-info/RECORD,, +aiohappyeyeballs-2.6.1.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88 +aiohappyeyeballs/__init__.py,sha256=x7kktHEtaD9quBcWDJPuLeKyjuVAI-Jj14S9B_5hcTs,361 +aiohappyeyeballs/__pycache__/__init__.cpython-312.pyc,, +aiohappyeyeballs/__pycache__/_staggered.cpython-312.pyc,, +aiohappyeyeballs/__pycache__/impl.cpython-312.pyc,, +aiohappyeyeballs/__pycache__/types.cpython-312.pyc,, +aiohappyeyeballs/__pycache__/utils.cpython-312.pyc,, +aiohappyeyeballs/_staggered.py,sha256=edfVowFx-P-ywJjIEF3MdPtEMVODujV6CeMYr65otac,6900 +aiohappyeyeballs/impl.py,sha256=Dlcm2mTJ28ucrGnxkb_fo9CZzLAkOOBizOt7dreBbXE,9681 +aiohappyeyeballs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiohappyeyeballs/types.py,sha256=YZJIAnyoV4Dz0WFtlaf_OyE4EW7Xus1z7aIfNI6tDDQ,425 +aiohappyeyeballs/utils.py,sha256=on9GxIR0LhEfZu8P6Twi9hepX9zDanuZM20MWsb3xlQ,3028 diff --git a/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/WHEEL b/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/WHEEL new file mode 100644 index 0000000..0582547 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohappyeyeballs-2.6.1.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: poetry-core 2.1.1 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/env/lib/python3.12/site-packages/aiohappyeyeballs/__init__.py b/env/lib/python3.12/site-packages/aiohappyeyeballs/__init__.py new file mode 100644 index 0000000..71c689c --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohappyeyeballs/__init__.py @@ -0,0 +1,14 @@ +__version__ = "2.6.1" + +from .impl import start_connection +from .types import AddrInfoType, SocketFactoryType +from .utils import addr_to_addr_infos, pop_addr_infos_interleave, remove_addr_infos + +__all__ = ( + "AddrInfoType", + "SocketFactoryType", + "addr_to_addr_infos", + "pop_addr_infos_interleave", + "remove_addr_infos", + "start_connection", +) diff --git a/env/lib/python3.12/site-packages/aiohappyeyeballs/_staggered.py b/env/lib/python3.12/site-packages/aiohappyeyeballs/_staggered.py new file mode 100644 index 0000000..9a4ba72 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohappyeyeballs/_staggered.py @@ -0,0 +1,207 @@ +import asyncio +import contextlib + +# PY3.9: Import Callable from typing until we drop Python 3.9 support +# https://github.com/python/cpython/issues/87131 +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Iterable, + List, + Optional, + Set, + Tuple, + TypeVar, + Union, +) + +_T = TypeVar("_T") + +RE_RAISE_EXCEPTIONS = (SystemExit, KeyboardInterrupt) + + +def _set_result(wait_next: "asyncio.Future[None]") -> None: + """Set the result of a future if it is not already done.""" + if not wait_next.done(): + wait_next.set_result(None) + + +async def _wait_one( + futures: "Iterable[asyncio.Future[Any]]", + loop: asyncio.AbstractEventLoop, +) -> _T: + """Wait for the first future to complete.""" + wait_next = loop.create_future() + + def _on_completion(fut: "asyncio.Future[Any]") -> None: + if not wait_next.done(): + wait_next.set_result(fut) + + for f in futures: + f.add_done_callback(_on_completion) + + try: + return await wait_next + finally: + for f in futures: + f.remove_done_callback(_on_completion) + + +async def staggered_race( + coro_fns: Iterable[Callable[[], Awaitable[_T]]], + delay: Optional[float], + *, + loop: Optional[asyncio.AbstractEventLoop] = None, +) -> Tuple[Optional[_T], Optional[int], List[Optional[BaseException]]]: + """ + Run coroutines with staggered start times and take the first to finish. + + This method takes an iterable of coroutine functions. The first one is + started immediately. From then on, whenever the immediately preceding one + fails (raises an exception), or when *delay* seconds has passed, the next + coroutine is started. This continues until one of the coroutines complete + successfully, in which case all others are cancelled, or until all + coroutines fail. + + The coroutines provided should be well-behaved in the following way: + + * They should only ``return`` if completed successfully. + + * They should always raise an exception if they did not complete + successfully. In particular, if they handle cancellation, they should + probably reraise, like this:: + + try: + # do work + except asyncio.CancelledError: + # undo partially completed work + raise + + Args: + ---- + coro_fns: an iterable of coroutine functions, i.e. callables that + return a coroutine object when called. Use ``functools.partial`` or + lambdas to pass arguments. + + delay: amount of time, in seconds, between starting coroutines. If + ``None``, the coroutines will run sequentially. + + loop: the event loop to use. If ``None``, the running loop is used. + + Returns: + ------- + tuple *(winner_result, winner_index, exceptions)* where + + - *winner_result*: the result of the winning coroutine, or ``None`` + if no coroutines won. + + - *winner_index*: the index of the winning coroutine in + ``coro_fns``, or ``None`` if no coroutines won. If the winning + coroutine may return None on success, *winner_index* can be used + to definitively determine whether any coroutine won. + + - *exceptions*: list of exceptions returned by the coroutines. + ``len(exceptions)`` is equal to the number of coroutines actually + started, and the order is the same as in ``coro_fns``. The winning + coroutine's entry is ``None``. + + """ + loop = loop or asyncio.get_running_loop() + exceptions: List[Optional[BaseException]] = [] + tasks: Set[asyncio.Task[Optional[Tuple[_T, int]]]] = set() + + async def run_one_coro( + coro_fn: Callable[[], Awaitable[_T]], + this_index: int, + start_next: "asyncio.Future[None]", + ) -> Optional[Tuple[_T, int]]: + """ + Run a single coroutine. + + If the coroutine fails, set the exception in the exceptions list and + start the next coroutine by setting the result of the start_next. + + If the coroutine succeeds, return the result and the index of the + coroutine in the coro_fns list. + + If SystemExit or KeyboardInterrupt is raised, re-raise it. + """ + try: + result = await coro_fn() + except RE_RAISE_EXCEPTIONS: + raise + except BaseException as e: + exceptions[this_index] = e + _set_result(start_next) # Kickstart the next coroutine + return None + + return result, this_index + + start_next_timer: Optional[asyncio.TimerHandle] = None + start_next: Optional[asyncio.Future[None]] + task: asyncio.Task[Optional[Tuple[_T, int]]] + done: Union[asyncio.Future[None], asyncio.Task[Optional[Tuple[_T, int]]]] + coro_iter = iter(coro_fns) + this_index = -1 + try: + while True: + if coro_fn := next(coro_iter, None): + this_index += 1 + exceptions.append(None) + start_next = loop.create_future() + task = loop.create_task(run_one_coro(coro_fn, this_index, start_next)) + tasks.add(task) + start_next_timer = ( + loop.call_later(delay, _set_result, start_next) if delay else None + ) + elif not tasks: + # We exhausted the coro_fns list and no tasks are running + # so we have no winner and all coroutines failed. + break + + while tasks or start_next: + done = await _wait_one( + (*tasks, start_next) if start_next else tasks, loop + ) + if done is start_next: + # The current task has failed or the timer has expired + # so we need to start the next task. + start_next = None + if start_next_timer: + start_next_timer.cancel() + start_next_timer = None + + # Break out of the task waiting loop to start the next + # task. + break + + if TYPE_CHECKING: + assert isinstance(done, asyncio.Task) + + tasks.remove(done) + if winner := done.result(): + return *winner, exceptions + finally: + # We either have: + # - a winner + # - all tasks failed + # - a KeyboardInterrupt or SystemExit. + + # + # If the timer is still running, cancel it. + # + if start_next_timer: + start_next_timer.cancel() + + # + # If there are any tasks left, cancel them and than + # wait them so they fill the exceptions list. + # + for task in tasks: + task.cancel() + with contextlib.suppress(asyncio.CancelledError): + await task + + return None, None, exceptions diff --git a/env/lib/python3.12/site-packages/aiohappyeyeballs/impl.py b/env/lib/python3.12/site-packages/aiohappyeyeballs/impl.py new file mode 100644 index 0000000..8f3919a --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohappyeyeballs/impl.py @@ -0,0 +1,259 @@ +"""Base implementation.""" + +import asyncio +import collections +import contextlib +import functools +import itertools +import socket +from typing import List, Optional, Sequence, Set, Union + +from . import _staggered +from .types import AddrInfoType, SocketFactoryType + + +async def start_connection( + addr_infos: Sequence[AddrInfoType], + *, + local_addr_infos: Optional[Sequence[AddrInfoType]] = None, + happy_eyeballs_delay: Optional[float] = None, + interleave: Optional[int] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + socket_factory: Optional[SocketFactoryType] = None, +) -> socket.socket: + """ + Connect to a TCP server. + + Create a socket connection to a specified destination. The + destination is specified as a list of AddrInfoType tuples as + returned from getaddrinfo(). + + The arguments are, in order: + + * ``family``: the address family, e.g. ``socket.AF_INET`` or + ``socket.AF_INET6``. + * ``type``: the socket type, e.g. ``socket.SOCK_STREAM`` or + ``socket.SOCK_DGRAM``. + * ``proto``: the protocol, e.g. ``socket.IPPROTO_TCP`` or + ``socket.IPPROTO_UDP``. + * ``canonname``: the canonical name of the address, e.g. + ``"www.python.org"``. + * ``sockaddr``: the socket address + + This method is a coroutine which will try to establish the connection + in the background. When successful, the coroutine returns a + socket. + + The expected use case is to use this method in conjunction with + loop.create_connection() to establish a connection to a server:: + + socket = await start_connection(addr_infos) + transport, protocol = await loop.create_connection( + MyProtocol, sock=socket, ...) + """ + if not (current_loop := loop): + current_loop = asyncio.get_running_loop() + + single_addr_info = len(addr_infos) == 1 + + if happy_eyeballs_delay is not None and interleave is None: + # If using happy eyeballs, default to interleave addresses by family + interleave = 1 + + if interleave and not single_addr_info: + addr_infos = _interleave_addrinfos(addr_infos, interleave) + + sock: Optional[socket.socket] = None + # uvloop can raise RuntimeError instead of OSError + exceptions: List[List[Union[OSError, RuntimeError]]] = [] + if happy_eyeballs_delay is None or single_addr_info: + # not using happy eyeballs + for addrinfo in addr_infos: + try: + sock = await _connect_sock( + current_loop, + exceptions, + addrinfo, + local_addr_infos, + None, + socket_factory, + ) + break + except (RuntimeError, OSError): + continue + else: # using happy eyeballs + open_sockets: Set[socket.socket] = set() + try: + sock, _, _ = await _staggered.staggered_race( + ( + functools.partial( + _connect_sock, + current_loop, + exceptions, + addrinfo, + local_addr_infos, + open_sockets, + socket_factory, + ) + for addrinfo in addr_infos + ), + happy_eyeballs_delay, + ) + finally: + # If we have a winner, staggered_race will + # cancel the other tasks, however there is a + # small race window where any of the other tasks + # can be done before they are cancelled which + # will leave the socket open. To avoid this problem + # we pass a set to _connect_sock to keep track of + # the open sockets and close them here if there + # are any "runner up" sockets. + for s in open_sockets: + if s is not sock: + with contextlib.suppress(OSError): + s.close() + open_sockets = None # type: ignore[assignment] + + if sock is None: + all_exceptions = [exc for sub in exceptions for exc in sub] + try: + first_exception = all_exceptions[0] + if len(all_exceptions) == 1: + raise first_exception + else: + # If they all have the same str(), raise one. + model = str(first_exception) + if all(str(exc) == model for exc in all_exceptions): + raise first_exception + # Raise a combined exception so the user can see all + # the various error messages. + msg = "Multiple exceptions: {}".format( + ", ".join(str(exc) for exc in all_exceptions) + ) + # If the errno is the same for all exceptions, raise + # an OSError with that errno. + if isinstance(first_exception, OSError): + first_errno = first_exception.errno + if all( + isinstance(exc, OSError) and exc.errno == first_errno + for exc in all_exceptions + ): + raise OSError(first_errno, msg) + elif isinstance(first_exception, RuntimeError) and all( + isinstance(exc, RuntimeError) for exc in all_exceptions + ): + raise RuntimeError(msg) + # We have a mix of OSError and RuntimeError + # so we have to pick which one to raise. + # and we raise OSError for compatibility + raise OSError(msg) + finally: + all_exceptions = None # type: ignore[assignment] + exceptions = None # type: ignore[assignment] + + return sock + + +async def _connect_sock( + loop: asyncio.AbstractEventLoop, + exceptions: List[List[Union[OSError, RuntimeError]]], + addr_info: AddrInfoType, + local_addr_infos: Optional[Sequence[AddrInfoType]] = None, + open_sockets: Optional[Set[socket.socket]] = None, + socket_factory: Optional[SocketFactoryType] = None, +) -> socket.socket: + """ + Create, bind and connect one socket. + + If open_sockets is passed, add the socket to the set of open sockets. + Any failure caught here will remove the socket from the set and close it. + + Callers can use this set to close any sockets that are not the winner + of all staggered tasks in the result there are runner up sockets aka + multiple winners. + """ + my_exceptions: List[Union[OSError, RuntimeError]] = [] + exceptions.append(my_exceptions) + family, type_, proto, _, address = addr_info + sock = None + try: + if socket_factory is not None: + sock = socket_factory(addr_info) + else: + sock = socket.socket(family=family, type=type_, proto=proto) + if open_sockets is not None: + open_sockets.add(sock) + sock.setblocking(False) + if local_addr_infos is not None: + for lfamily, _, _, _, laddr in local_addr_infos: + # skip local addresses of different family + if lfamily != family: + continue + try: + sock.bind(laddr) + break + except OSError as exc: + msg = ( + f"error while attempting to bind on " + f"address {laddr!r}: " + f"{(exc.strerror or '').lower()}" + ) + exc = OSError(exc.errno, msg) + my_exceptions.append(exc) + else: # all bind attempts failed + if my_exceptions: + raise my_exceptions.pop() + else: + raise OSError(f"no matching local address with {family=} found") + await loop.sock_connect(sock, address) + return sock + except (RuntimeError, OSError) as exc: + my_exceptions.append(exc) + if sock is not None: + if open_sockets is not None: + open_sockets.remove(sock) + try: + sock.close() + except OSError as e: + my_exceptions.append(e) + raise + raise + except: + if sock is not None: + if open_sockets is not None: + open_sockets.remove(sock) + try: + sock.close() + except OSError as e: + my_exceptions.append(e) + raise + raise + finally: + exceptions = my_exceptions = None # type: ignore[assignment] + + +def _interleave_addrinfos( + addrinfos: Sequence[AddrInfoType], first_address_family_count: int = 1 +) -> List[AddrInfoType]: + """Interleave list of addrinfo tuples by family.""" + # Group addresses by family + addrinfos_by_family: collections.OrderedDict[int, List[AddrInfoType]] = ( + collections.OrderedDict() + ) + for addr in addrinfos: + family = addr[0] + if family not in addrinfos_by_family: + addrinfos_by_family[family] = [] + addrinfos_by_family[family].append(addr) + addrinfos_lists = list(addrinfos_by_family.values()) + + reordered: List[AddrInfoType] = [] + if first_address_family_count > 1: + reordered.extend(addrinfos_lists[0][: first_address_family_count - 1]) + del addrinfos_lists[0][: first_address_family_count - 1] + reordered.extend( + a + for a in itertools.chain.from_iterable(itertools.zip_longest(*addrinfos_lists)) + if a is not None + ) + return reordered diff --git a/env/lib/python3.12/site-packages/aiohappyeyeballs/py.typed b/env/lib/python3.12/site-packages/aiohappyeyeballs/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/aiohappyeyeballs/types.py b/env/lib/python3.12/site-packages/aiohappyeyeballs/types.py new file mode 100644 index 0000000..e8c7507 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohappyeyeballs/types.py @@ -0,0 +1,17 @@ +"""Types for aiohappyeyeballs.""" + +import socket + +# PY3.9: Import Callable from typing until we drop Python 3.9 support +# https://github.com/python/cpython/issues/87131 +from typing import Callable, Tuple, Union + +AddrInfoType = Tuple[ + Union[int, socket.AddressFamily], + Union[int, socket.SocketKind], + int, + str, + Tuple, # type: ignore[type-arg] +] + +SocketFactoryType = Callable[[AddrInfoType], socket.socket] diff --git a/env/lib/python3.12/site-packages/aiohappyeyeballs/utils.py b/env/lib/python3.12/site-packages/aiohappyeyeballs/utils.py new file mode 100644 index 0000000..ea29adb --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohappyeyeballs/utils.py @@ -0,0 +1,97 @@ +"""Utility functions for aiohappyeyeballs.""" + +import ipaddress +import socket +from typing import Dict, List, Optional, Tuple, Union + +from .types import AddrInfoType + + +def addr_to_addr_infos( + addr: Optional[ + Union[Tuple[str, int, int, int], Tuple[str, int, int], Tuple[str, int]] + ], +) -> Optional[List[AddrInfoType]]: + """Convert an address tuple to a list of addr_info tuples.""" + if addr is None: + return None + host = addr[0] + port = addr[1] + is_ipv6 = ":" in host + if is_ipv6: + flowinfo = 0 + scopeid = 0 + addr_len = len(addr) + if addr_len >= 4: + scopeid = addr[3] # type: ignore[misc] + if addr_len >= 3: + flowinfo = addr[2] # type: ignore[misc] + addr = (host, port, flowinfo, scopeid) + family = socket.AF_INET6 + else: + addr = (host, port) + family = socket.AF_INET + return [(family, socket.SOCK_STREAM, socket.IPPROTO_TCP, "", addr)] + + +def pop_addr_infos_interleave( + addr_infos: List[AddrInfoType], interleave: Optional[int] = None +) -> None: + """ + Pop addr_info from the list of addr_infos by family up to interleave times. + + The interleave parameter is used to know how many addr_infos for + each family should be popped of the top of the list. + """ + seen: Dict[int, int] = {} + if interleave is None: + interleave = 1 + to_remove: List[AddrInfoType] = [] + for addr_info in addr_infos: + family = addr_info[0] + if family not in seen: + seen[family] = 0 + if seen[family] < interleave: + to_remove.append(addr_info) + seen[family] += 1 + for addr_info in to_remove: + addr_infos.remove(addr_info) + + +def _addr_tuple_to_ip_address( + addr: Union[Tuple[str, int], Tuple[str, int, int, int]], +) -> Union[ + Tuple[ipaddress.IPv4Address, int], Tuple[ipaddress.IPv6Address, int, int, int] +]: + """Convert an address tuple to an IPv4Address.""" + return (ipaddress.ip_address(addr[0]), *addr[1:]) + + +def remove_addr_infos( + addr_infos: List[AddrInfoType], + addr: Union[Tuple[str, int], Tuple[str, int, int, int]], +) -> None: + """ + Remove an address from the list of addr_infos. + + The addr value is typically the return value of + sock.getpeername(). + """ + bad_addrs_infos: List[AddrInfoType] = [] + for addr_info in addr_infos: + if addr_info[-1] == addr: + bad_addrs_infos.append(addr_info) + if bad_addrs_infos: + for bad_addr_info in bad_addrs_infos: + addr_infos.remove(bad_addr_info) + return + # Slow path in case addr is formatted differently + match_addr = _addr_tuple_to_ip_address(addr) + for addr_info in addr_infos: + if match_addr == _addr_tuple_to_ip_address(addr_info[-1]): + bad_addrs_infos.append(addr_info) + if bad_addrs_infos: + for bad_addr_info in bad_addrs_infos: + addr_infos.remove(bad_addr_info) + return + raise ValueError(f"Address {addr} not found in addr_infos") diff --git a/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/INSTALLER b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/METADATA b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/METADATA new file mode 100644 index 0000000..078765d --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/METADATA @@ -0,0 +1,262 @@ +Metadata-Version: 2.4 +Name: aiohttp +Version: 3.13.3 +Summary: Async http client/server framework (asyncio) +Maintainer-email: aiohttp team +License: Apache-2.0 AND MIT +Project-URL: Homepage, https://github.com/aio-libs/aiohttp +Project-URL: Chat: Matrix, https://matrix.to/#/#aio-libs:matrix.org +Project-URL: Chat: Matrix Space, https://matrix.to/#/#aio-libs-space:matrix.org +Project-URL: CI: GitHub Actions, https://github.com/aio-libs/aiohttp/actions?query=workflow%3ACI +Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/aiohttp +Project-URL: Docs: Changelog, https://docs.aiohttp.org/en/stable/changes.html +Project-URL: Docs: RTD, https://docs.aiohttp.org +Project-URL: GitHub: issues, https://github.com/aio-libs/aiohttp/issues +Project-URL: GitHub: repo, https://github.com/aio-libs/aiohttp +Classifier: Development Status :: 5 - Production/Stable +Classifier: Framework :: AsyncIO +Classifier: Intended Audience :: Developers +Classifier: Operating System :: POSIX +Classifier: Operating System :: MacOS :: MacOS X +Classifier: Operating System :: Microsoft :: Windows +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Programming Language :: Python :: 3.14 +Classifier: Topic :: Internet :: WWW/HTTP +Requires-Python: >=3.9 +Description-Content-Type: text/x-rst +License-File: LICENSE.txt +License-File: vendor/llhttp/LICENSE +Requires-Dist: aiohappyeyeballs>=2.5.0 +Requires-Dist: aiosignal>=1.4.0 +Requires-Dist: async-timeout<6.0,>=4.0; python_version < "3.11" +Requires-Dist: attrs>=17.3.0 +Requires-Dist: frozenlist>=1.1.1 +Requires-Dist: multidict<7.0,>=4.5 +Requires-Dist: propcache>=0.2.0 +Requires-Dist: yarl<2.0,>=1.17.0 +Provides-Extra: speedups +Requires-Dist: aiodns>=3.3.0; extra == "speedups" +Requires-Dist: Brotli>=1.2; platform_python_implementation == "CPython" and extra == "speedups" +Requires-Dist: brotlicffi>=1.2; platform_python_implementation != "CPython" and extra == "speedups" +Requires-Dist: backports.zstd; (platform_python_implementation == "CPython" and python_version < "3.14") and extra == "speedups" +Dynamic: license-file + +================================== +Async http client/server framework +================================== + +.. image:: https://raw.githubusercontent.com/aio-libs/aiohttp/master/docs/aiohttp-plain.svg + :height: 64px + :width: 64px + :alt: aiohttp logo + +| + +.. image:: https://github.com/aio-libs/aiohttp/workflows/CI/badge.svg + :target: https://github.com/aio-libs/aiohttp/actions?query=workflow%3ACI + :alt: GitHub Actions status for master branch + +.. image:: https://codecov.io/gh/aio-libs/aiohttp/branch/master/graph/badge.svg + :target: https://codecov.io/gh/aio-libs/aiohttp + :alt: codecov.io status for master branch + +.. image:: https://badge.fury.io/py/aiohttp.svg + :target: https://pypi.org/project/aiohttp + :alt: Latest PyPI package version + +.. image:: https://img.shields.io/pypi/dm/aiohttp + :target: https://pypistats.org/packages/aiohttp + :alt: Downloads count + +.. image:: https://readthedocs.org/projects/aiohttp/badge/?version=latest + :target: https://docs.aiohttp.org/ + :alt: Latest Read The Docs + +.. image:: https://img.shields.io/endpoint?url=https://codspeed.io/badge.json + :target: https://codspeed.io/aio-libs/aiohttp + :alt: Codspeed.io status for aiohttp + + +Key Features +============ + +- Supports both client and server side of HTTP protocol. +- Supports both client and server Web-Sockets out-of-the-box and avoids + Callback Hell. +- Provides Web-server with middleware and pluggable routing. + + +Getting started +=============== + +Client +------ + +To get something from the web: + +.. code-block:: python + + import aiohttp + import asyncio + + async def main(): + + async with aiohttp.ClientSession() as session: + async with session.get('http://python.org') as response: + + print("Status:", response.status) + print("Content-type:", response.headers['content-type']) + + html = await response.text() + print("Body:", html[:15], "...") + + asyncio.run(main()) + +This prints: + +.. code-block:: + + Status: 200 + Content-type: text/html; charset=utf-8 + Body: ... + +Coming from `requests `_ ? Read `why we need so many lines `_. + +Server +------ + +An example using a simple server: + +.. code-block:: python + + # examples/server_simple.py + from aiohttp import web + + async def handle(request): + name = request.match_info.get('name', "Anonymous") + text = "Hello, " + name + return web.Response(text=text) + + async def wshandle(request): + ws = web.WebSocketResponse() + await ws.prepare(request) + + async for msg in ws: + if msg.type == web.WSMsgType.text: + await ws.send_str("Hello, {}".format(msg.data)) + elif msg.type == web.WSMsgType.binary: + await ws.send_bytes(msg.data) + elif msg.type == web.WSMsgType.close: + break + + return ws + + + app = web.Application() + app.add_routes([web.get('/', handle), + web.get('/echo', wshandle), + web.get('/{name}', handle)]) + + if __name__ == '__main__': + web.run_app(app) + + +Documentation +============= + +https://aiohttp.readthedocs.io/ + + +Demos +===== + +https://github.com/aio-libs/aiohttp-demos + + +External links +============== + +* `Third party libraries + `_ +* `Built with aiohttp + `_ +* `Powered by aiohttp + `_ + +Feel free to make a Pull Request for adding your link to these pages! + + +Communication channels +====================== + +*aio-libs Discussions*: https://github.com/aio-libs/aiohttp/discussions + +*Matrix*: `#aio-libs:matrix.org `_ + +We support `Stack Overflow +`_. +Please add *aiohttp* tag to your question there. + +Requirements +============ + +- attrs_ +- multidict_ +- yarl_ +- frozenlist_ + +Optionally you may install the aiodns_ library (highly recommended for sake of speed). + +.. _aiodns: https://pypi.python.org/pypi/aiodns +.. _attrs: https://github.com/python-attrs/attrs +.. _multidict: https://pypi.python.org/pypi/multidict +.. _frozenlist: https://pypi.org/project/frozenlist/ +.. _yarl: https://pypi.python.org/pypi/yarl +.. _async-timeout: https://pypi.python.org/pypi/async_timeout + +License +======= + +``aiohttp`` is offered under the Apache 2 license. + + +Keepsafe +======== + +The aiohttp community would like to thank Keepsafe +(https://www.getkeepsafe.com) for its support in the early days of +the project. + + +Source code +=========== + +The latest developer version is available in a GitHub repository: +https://github.com/aio-libs/aiohttp + +Benchmarks +========== + +If you are interested in efficiency, the AsyncIO community maintains a +list of benchmarks on the official wiki: +https://github.com/python/asyncio/wiki/Benchmarks + +-------- + +.. image:: https://img.shields.io/matrix/aio-libs:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat + :target: https://matrix.to/#/%23aio-libs:matrix.org + :alt: Matrix Room — #aio-libs:matrix.org + +.. image:: https://img.shields.io/matrix/aio-libs-space:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs-space%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat + :target: https://matrix.to/#/%23aio-libs-space:matrix.org + :alt: Matrix Space — #aio-libs-space:matrix.org + +.. image:: https://insights.linuxfoundation.org/api/badge/health-score?project=aiohttp + :target: https://insights.linuxfoundation.org/project/aiohttp + :alt: LFX Health Score diff --git a/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/RECORD b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/RECORD new file mode 100644 index 0000000..6a0c93f --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/RECORD @@ -0,0 +1,139 @@ +aiohttp-3.13.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +aiohttp-3.13.3.dist-info/METADATA,sha256=CQROZCStho-eb7xiFIuAzj30JuupEU_jHpYDFiG_HhM,8145 +aiohttp-3.13.3.dist-info/RECORD,, +aiohttp-3.13.3.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiohttp-3.13.3.dist-info/WHEEL,sha256=AwHYJA1Do1jwgPIoLQR4DiHSeYY_vU6Ht9Vljq5Yt_M,112 +aiohttp-3.13.3.dist-info/licenses/LICENSE.txt,sha256=n4DQ2311WpQdtFchcsJw7L2PCCuiFd3QlZhZQu2Uqes,588 +aiohttp-3.13.3.dist-info/licenses/vendor/llhttp/LICENSE,sha256=68qFTgE0zSVtZzYnwgSZ9CV363S6zwi58ltianPJEnc,1105 +aiohttp-3.13.3.dist-info/top_level.txt,sha256=iv-JIaacmTl-hSho3QmphcKnbRRYx1st47yjz_178Ro,8 +aiohttp/.hash/_cparser.pxd.hash,sha256=pjs-sEXNw_eijXGAedwG-BHnlFp8B7sOCgUagIWaU2A,121 +aiohttp/.hash/_find_header.pxd.hash,sha256=_mbpD6vM-CVCKq3ulUvsOAz5Wdo88wrDzfpOsMQaMNA,125 +aiohttp/.hash/_http_parser.pyx.hash,sha256=RKkD9x-EhXksvXrpCaTNWYtffb52urLvuTnxbTN2Lmw,125 +aiohttp/.hash/_http_writer.pyx.hash,sha256=9txOh7t7c3y-vLmiuEY5dltmXvEo0CYyU4U853yyv9E,125 +aiohttp/.hash/hdrs.py.hash,sha256=v6IaKbsxjsdQxBzhb5AjP0x_9G3rUe84D7avf7AI4cs,116 +aiohttp/__init__.py,sha256=QWssFaD-DaFFcwP36lLUQzRmlSZ5KxivJBU-yg5C1wg,8302 +aiohttp/__pycache__/__init__.cpython-312.pyc,, +aiohttp/__pycache__/_cookie_helpers.cpython-312.pyc,, +aiohttp/__pycache__/abc.cpython-312.pyc,, +aiohttp/__pycache__/base_protocol.cpython-312.pyc,, +aiohttp/__pycache__/client.cpython-312.pyc,, +aiohttp/__pycache__/client_exceptions.cpython-312.pyc,, +aiohttp/__pycache__/client_middleware_digest_auth.cpython-312.pyc,, +aiohttp/__pycache__/client_middlewares.cpython-312.pyc,, +aiohttp/__pycache__/client_proto.cpython-312.pyc,, +aiohttp/__pycache__/client_reqrep.cpython-312.pyc,, +aiohttp/__pycache__/client_ws.cpython-312.pyc,, +aiohttp/__pycache__/compression_utils.cpython-312.pyc,, +aiohttp/__pycache__/connector.cpython-312.pyc,, +aiohttp/__pycache__/cookiejar.cpython-312.pyc,, +aiohttp/__pycache__/formdata.cpython-312.pyc,, +aiohttp/__pycache__/hdrs.cpython-312.pyc,, +aiohttp/__pycache__/helpers.cpython-312.pyc,, +aiohttp/__pycache__/http.cpython-312.pyc,, +aiohttp/__pycache__/http_exceptions.cpython-312.pyc,, +aiohttp/__pycache__/http_parser.cpython-312.pyc,, +aiohttp/__pycache__/http_websocket.cpython-312.pyc,, +aiohttp/__pycache__/http_writer.cpython-312.pyc,, +aiohttp/__pycache__/log.cpython-312.pyc,, +aiohttp/__pycache__/multipart.cpython-312.pyc,, +aiohttp/__pycache__/payload.cpython-312.pyc,, +aiohttp/__pycache__/payload_streamer.cpython-312.pyc,, +aiohttp/__pycache__/pytest_plugin.cpython-312.pyc,, +aiohttp/__pycache__/resolver.cpython-312.pyc,, +aiohttp/__pycache__/streams.cpython-312.pyc,, +aiohttp/__pycache__/tcp_helpers.cpython-312.pyc,, +aiohttp/__pycache__/test_utils.cpython-312.pyc,, +aiohttp/__pycache__/tracing.cpython-312.pyc,, +aiohttp/__pycache__/typedefs.cpython-312.pyc,, +aiohttp/__pycache__/web.cpython-312.pyc,, +aiohttp/__pycache__/web_app.cpython-312.pyc,, +aiohttp/__pycache__/web_exceptions.cpython-312.pyc,, +aiohttp/__pycache__/web_fileresponse.cpython-312.pyc,, +aiohttp/__pycache__/web_log.cpython-312.pyc,, +aiohttp/__pycache__/web_middlewares.cpython-312.pyc,, +aiohttp/__pycache__/web_protocol.cpython-312.pyc,, +aiohttp/__pycache__/web_request.cpython-312.pyc,, +aiohttp/__pycache__/web_response.cpython-312.pyc,, +aiohttp/__pycache__/web_routedef.cpython-312.pyc,, +aiohttp/__pycache__/web_runner.cpython-312.pyc,, +aiohttp/__pycache__/web_server.cpython-312.pyc,, +aiohttp/__pycache__/web_urldispatcher.cpython-312.pyc,, +aiohttp/__pycache__/web_ws.cpython-312.pyc,, +aiohttp/__pycache__/worker.cpython-312.pyc,, +aiohttp/_cookie_helpers.py,sha256=_p7y-B8OCAk7FLjByiuwFIpDLGuNoJn3_vixzymAFnE,13659 +aiohttp/_cparser.pxd,sha256=UnbUYCHg4NdXfgyRVYAMv2KTLWClB4P-xCrvtj_r7ew,4295 +aiohttp/_find_header.pxd,sha256=0GfwFCPN2zxEKTO1_MA5sYq2UfzsG8kcV3aTqvwlz3g,68 +aiohttp/_headers.pxi,sha256=n701k28dVPjwRnx5j6LpJhLTfj7dqu2vJt7f0O60Oyg,2007 +aiohttp/_http_parser.cpython-312-x86_64-linux-musl.so,sha256=8R_oCxz22f25Zhfas7txCJ9nFYNGNpmirWwCTD7ilv0,2110720 +aiohttp/_http_parser.pyx,sha256=-YI8YIY4uKd_7Bwr0o3FwEPwjHdexZ5-Ji3XS067c4Q,28261 +aiohttp/_http_writer.cpython-312-x86_64-linux-musl.so,sha256=rUAyGyLsuKB4PTOkVlHsP6_SUbodJJTrVHHUt7f_mPI,397960 +aiohttp/_http_writer.pyx,sha256=VlFEBM6HoVv8a0AAJtc6JwFlsv2-cDE8-gB94p3dfhQ,4664 +aiohttp/_websocket/.hash/mask.pxd.hash,sha256=Y0zBddk_ck3pi9-BFzMcpkcvCKvwvZ4GTtZFb9u1nxQ,128 +aiohttp/_websocket/.hash/mask.pyx.hash,sha256=90owpXYM8_kIma4KUcOxhWSk-Uv4NVMBoCYeFM1B3d0,128 +aiohttp/_websocket/.hash/reader_c.pxd.hash,sha256=5xf3oobk6vx4xbJm-xtZ1_QufB8fYFtLQV2MNdqUc1w,132 +aiohttp/_websocket/__init__.py,sha256=Mar3R9_vBN_Ea4lsW7iTAVXD7OKswKPGqF5xgSyt77k,44 +aiohttp/_websocket/__pycache__/__init__.cpython-312.pyc,, +aiohttp/_websocket/__pycache__/helpers.cpython-312.pyc,, +aiohttp/_websocket/__pycache__/models.cpython-312.pyc,, +aiohttp/_websocket/__pycache__/reader.cpython-312.pyc,, +aiohttp/_websocket/__pycache__/reader_c.cpython-312.pyc,, +aiohttp/_websocket/__pycache__/reader_py.cpython-312.pyc,, +aiohttp/_websocket/__pycache__/writer.cpython-312.pyc,, +aiohttp/_websocket/helpers.py,sha256=P-XLv8IUaihKzDenVUqfKU5DJbWE5HvG8uhvUZK8Ic4,5038 +aiohttp/_websocket/mask.cpython-312-x86_64-linux-musl.so,sha256=1nChf3rNfwKWzbz2j7-0blX8FOdwP7z1_mTLFFYdyOY,204904 +aiohttp/_websocket/mask.pxd,sha256=sBmZ1Amym9kW4Ge8lj1fLZ7mPPya4LzLdpkQExQXv5M,112 +aiohttp/_websocket/mask.pyx,sha256=BHjOtV0O0w7xp9p0LNADRJvGmgfPn9sGeJvSs0fL__4,1397 +aiohttp/_websocket/models.py,sha256=XAzjs_8JYszWXIgZ6R3ZRrF-tX9Q_6LiD49WRYojopM,2121 +aiohttp/_websocket/reader.py,sha256=eC4qS0c5sOeQ2ebAHLaBpIaTVFaSKX79pY2xvh3Pqyw,1030 +aiohttp/_websocket/reader_c.cpython-312-x86_64-linux-musl.so,sha256=h_i8D0vlOhVe8wgh-LE7MoWvVVdbytlMCX3BTsljI1I,1289680 +aiohttp/_websocket/reader_c.pxd,sha256=nl_njtDrzlQU0rjgGGjZDB-swguE0tX_bCPobkShVa4,2625 +aiohttp/_websocket/reader_c.py,sha256=V5YtZ2gj2BjE2Q-W9sR_MdAl1VAm1pB7ZjozVJcOpbg,18868 +aiohttp/_websocket/reader_py.py,sha256=V5YtZ2gj2BjE2Q-W9sR_MdAl1VAm1pB7ZjozVJcOpbg,18868 +aiohttp/_websocket/writer.py,sha256=2OvSktPmNh_g20h1cXJt2Xu8u6IvswnPjdur7OwBbJk,11261 +aiohttp/abc.py,sha256=M66F4S6m00bIEn7y4ha_XLTMDmVQ9dPihfOVB0pGfOo,7149 +aiohttp/base_protocol.py,sha256=Tp8cxUPQvv9kUPk3w6lAzk6d2MAzV3scwI_3Go3C47c,3025 +aiohttp/client.py,sha256=fOQfwcIUL1NGAVRV4DDj6-wipBzeD8KZpmzhO-LLKp4,58357 +aiohttp/client_exceptions.py,sha256=uyKbxI2peZhKl7lELBMx3UeusNkfpemPWpGFq0r6JeM,11367 +aiohttp/client_middleware_digest_auth.py,sha256=G5JM9YtzL9AWklz6NP28xEOBeAvrAZgDzU657JqO4qs,17627 +aiohttp/client_middlewares.py,sha256=kP5N9CMzQPMGPIEydeVUiLUTLsw8Vl8Gr4qAWYdu3vM,1918 +aiohttp/client_proto.py,sha256=56_WtLStZGBFPYKzgEgY6v24JkhV1y6JEmmuxeJT2So,12110 +aiohttp/client_reqrep.py,sha256=eEREDrZ0M8ZFTt1wjHduR-P8_sm40K65gNz-iMGYask,53391 +aiohttp/client_ws.py,sha256=1CIjIXwyzOMIYw6AjUES4-qUwbyVHW1seJKQfg_Rta8,15109 +aiohttp/compression_utils.py,sha256=hJ2LXhN2OWukFHm5b78TJFGKcAiL2kthi9Sf5PRYO-U,11738 +aiohttp/connector.py,sha256=vT22BNuCDtbadE1Uq7HC7zpOWCHMxI4n3PtCz7zZZkw,69004 +aiohttp/cookiejar.py,sha256=e28ZMQwJ5P0vbPX1OX4Se7-k3zeGvocFEqzGhwpG53k,18922 +aiohttp/formdata.py,sha256=xqYMbUo1qoLYPuzY92XeR4pyEe-w-DNcToARDF3GUhA,6384 +aiohttp/hdrs.py,sha256=2rj5MyA-6yRdYPhW5UKkW4iNWhEAlGIOSBH5D4FmKNE,5111 +aiohttp/helpers.py,sha256=Q1307PCEnWz4RP8crUw8dk58c0YF2Ei3JywkKfRxz5E,30629 +aiohttp/http.py,sha256=8o8j8xH70OWjnfTWA9V44NR785QPxEPrUtzMXiAVpwc,1842 +aiohttp/http_exceptions.py,sha256=BjIxD4LtrQgytqoR5lOI9zAttNmSygRgksUsMRy7sss,3069 +aiohttp/http_parser.py,sha256=z6djZDOUs7hdPzplTEsAVyz0of-rQAwT7xz8OpXhnuY,38177 +aiohttp/http_websocket.py,sha256=8VXFKw6KQUEmPg48GtRMB37v0gTK7A0inoxXuDxMZEc,842 +aiohttp/http_writer.py,sha256=fbRtKPYSqRbtAdr_gqpjF2-4sI1ESL8dPDF-xY_mAMY,12446 +aiohttp/log.py,sha256=BbNKx9e3VMIm0xYjZI0IcBBoS7wjdeIeSaiJE7-qK2g,325 +aiohttp/multipart.py,sha256=326npYdWxYI3raoRfmpBeUV_ef3-LRn8sV9WqcIOoPk,40482 +aiohttp/payload.py,sha256=O6nsYNULL7AeM2cyJ6TYX73ncVnL5xJwt5AegxwMKqw,40874 +aiohttp/payload_streamer.py,sha256=ZzEYyfzcjGWkVkK3XR2pBthSCSIykYvY3Wr5cGQ2eTc,2211 +aiohttp/py.typed,sha256=sow9soTwP9T_gEAQSVh7Gb8855h04Nwmhs2We-JRgZM,7 +aiohttp/pytest_plugin.py,sha256=z4XwqmsKdyJCKxbGiA5kFf90zcedvomqk4RqjZbhKNk,12901 +aiohttp/resolver.py,sha256=gsrfUpFf8iHlcHfJvY-1fiBHW3PRvRVNb5lNZBg3zlY,10031 +aiohttp/streams.py,sha256=rlwL7ek6CkMMYil_e_EokWv26uHmtzi3lKqlnLNrXCc,23666 +aiohttp/tcp_helpers.py,sha256=BSadqVWaBpMFDRWnhaaR941N9MiDZ7bdTrxgCb0CW-M,961 +aiohttp/test_utils.py,sha256=ZJSzZWjC76KSbtwddTKcP6vHpUl_ozfAf3F93ewmHRU,23016 +aiohttp/tracing.py,sha256=-6aaW6l0J9uJD45LzR4cijYH0j62pt0U_nn_aVzFku4,14558 +aiohttp/typedefs.py,sha256=wUlqwe9Mw9W8jT3HsYJcYk00qP3EMPz3nTkYXmeNN48,1657 +aiohttp/web.py,sha256=JzSNmejg5G6YeFAnkIgZfytqbU86sNu844yYKmoUpqs,17852 +aiohttp/web_app.py,sha256=lGU_aAMN-h3wy-LTTHi6SeKH8ydt1G51BXcCspgD5ZA,19452 +aiohttp/web_exceptions.py,sha256=7nIuiwhZ39vJJ9KrWqArA5QcWbUdqkz2CLwEpJapeN8,10360 +aiohttp/web_fileresponse.py,sha256=Xzau8EMrWNrFg3u46h4UEteg93G4zYq94CU6vy0HiqE,16362 +aiohttp/web_log.py,sha256=rX5D7xLOX2B6BMdiZ-chme_KfJfW5IXEoFwLfkfkajs,7865 +aiohttp/web_middlewares.py,sha256=sFI0AgeNjdyAjuz92QtMIpngmJSOxrqe2Jfbs4BNUu0,4165 +aiohttp/web_protocol.py,sha256=6s9dMzmaqW77bzM1T111uGNSLFo6gNmfDg7XzYnA8xk,27010 +aiohttp/web_request.py,sha256=KqrOp6AeWB5e6tKrG55Lo7Zbwq49DxdrKniuW2t2u04,29849 +aiohttp/web_response.py,sha256=PKcziNU4LmftXqKVvoRMrAbOeVClpSN-iznHsiWezmU,29341 +aiohttp/web_routedef.py,sha256=VT1GAx6BrawoDh5RwBwBu5wSABSqgWwAe74AUCyZAEo,6110 +aiohttp/web_runner.py,sha256=v1G1nKiOOQgFnTSR4IMc6I9ReEFDMaHtMLvO_roDM-A,11786 +aiohttp/web_server.py,sha256=-9WDKUAiR9ll-rSdwXSqG6YjaoW79d1R4y0BGSqgUMA,2888 +aiohttp/web_urldispatcher.py,sha256=JM-TlriKCNbTLNL43Ra9sdZ0zChxZmIEYQM6ZpbyjI4,44290 +aiohttp/web_ws.py,sha256=lItgmyatkXh0M6EY7JoZnSZkUl6R0wv8B88X4ILqQbU,22739 +aiohttp/worker.py,sha256=zT0iWN5Xze194bO6_VjHou0x7lR_k0MviN6Kadnk22g,8152 diff --git a/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/REQUESTED b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/REQUESTED new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/WHEEL b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/WHEEL new file mode 100644 index 0000000..5b148ea --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (80.9.0) +Root-Is-Purelib: false +Tag: cp312-cp312-musllinux_1_2_x86_64 + diff --git a/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/licenses/LICENSE.txt b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/licenses/LICENSE.txt new file mode 100644 index 0000000..e497a32 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/licenses/LICENSE.txt @@ -0,0 +1,13 @@ + Copyright aio-libs contributors. + + 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. diff --git a/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/licenses/vendor/llhttp/LICENSE b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/licenses/vendor/llhttp/LICENSE new file mode 100644 index 0000000..6c1512d --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/licenses/vendor/llhttp/LICENSE @@ -0,0 +1,22 @@ +This software is licensed under the MIT License. + +Copyright Fedor Indutny, 2018. + +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/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/top_level.txt b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/top_level.txt new file mode 100644 index 0000000..ee4ba4f --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp-3.13.3.dist-info/top_level.txt @@ -0,0 +1 @@ +aiohttp diff --git a/env/lib/python3.12/site-packages/aiohttp/.hash/_cparser.pxd.hash b/env/lib/python3.12/site-packages/aiohttp/.hash/_cparser.pxd.hash new file mode 100644 index 0000000..3f5cd0e --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/.hash/_cparser.pxd.hash @@ -0,0 +1 @@ +5276d46021e0e0d7577e0c9155800cbf62932d60a50783fec42aefb63febedec /home/runner/work/aiohttp/aiohttp/aiohttp/_cparser.pxd diff --git a/env/lib/python3.12/site-packages/aiohttp/.hash/_find_header.pxd.hash b/env/lib/python3.12/site-packages/aiohttp/.hash/_find_header.pxd.hash new file mode 100644 index 0000000..f006c2d --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/.hash/_find_header.pxd.hash @@ -0,0 +1 @@ +d067f01423cddb3c442933b5fcc039b18ab651fcec1bc91c577693aafc25cf78 /home/runner/work/aiohttp/aiohttp/aiohttp/_find_header.pxd diff --git a/env/lib/python3.12/site-packages/aiohttp/.hash/_http_parser.pyx.hash b/env/lib/python3.12/site-packages/aiohttp/.hash/_http_parser.pyx.hash new file mode 100644 index 0000000..1099b5e --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/.hash/_http_parser.pyx.hash @@ -0,0 +1 @@ +f9823c608638b8a77fec1c2bd28dc5c043f08c775ec59e7e262dd74b4ebb7384 /home/runner/work/aiohttp/aiohttp/aiohttp/_http_parser.pyx diff --git a/env/lib/python3.12/site-packages/aiohttp/.hash/_http_writer.pyx.hash b/env/lib/python3.12/site-packages/aiohttp/.hash/_http_writer.pyx.hash new file mode 100644 index 0000000..ad351fe --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/.hash/_http_writer.pyx.hash @@ -0,0 +1 @@ +56514404ce87a15bfc6b400026d73a270165b2fdbe70313cfa007de29ddd7e14 /home/runner/work/aiohttp/aiohttp/aiohttp/_http_writer.pyx diff --git a/env/lib/python3.12/site-packages/aiohttp/.hash/hdrs.py.hash b/env/lib/python3.12/site-packages/aiohttp/.hash/hdrs.py.hash new file mode 100644 index 0000000..c8d5524 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/.hash/hdrs.py.hash @@ -0,0 +1 @@ +dab8f933203eeb245d60f856e542a45b888d5a110094620e4811f90f816628d1 /home/runner/work/aiohttp/aiohttp/aiohttp/hdrs.py diff --git a/env/lib/python3.12/site-packages/aiohttp/__init__.py b/env/lib/python3.12/site-packages/aiohttp/__init__.py new file mode 100644 index 0000000..357baf0 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/__init__.py @@ -0,0 +1,278 @@ +__version__ = "3.13.3" + +from typing import TYPE_CHECKING, Tuple + +from . import hdrs as hdrs +from .client import ( + BaseConnector, + ClientConnectionError, + ClientConnectionResetError, + ClientConnectorCertificateError, + ClientConnectorDNSError, + ClientConnectorError, + ClientConnectorSSLError, + ClientError, + ClientHttpProxyError, + ClientOSError, + ClientPayloadError, + ClientProxyConnectionError, + ClientRequest, + ClientResponse, + ClientResponseError, + ClientSession, + ClientSSLError, + ClientTimeout, + ClientWebSocketResponse, + ClientWSTimeout, + ConnectionTimeoutError, + ContentTypeError, + Fingerprint, + InvalidURL, + InvalidUrlClientError, + InvalidUrlRedirectClientError, + NamedPipeConnector, + NonHttpUrlClientError, + NonHttpUrlRedirectClientError, + RedirectClientError, + RequestInfo, + ServerConnectionError, + ServerDisconnectedError, + ServerFingerprintMismatch, + ServerTimeoutError, + SocketTimeoutError, + TCPConnector, + TooManyRedirects, + UnixConnector, + WSMessageTypeError, + WSServerHandshakeError, + request, +) +from .client_middleware_digest_auth import DigestAuthMiddleware +from .client_middlewares import ClientHandlerType, ClientMiddlewareType +from .compression_utils import set_zlib_backend +from .connector import ( + AddrInfoType as AddrInfoType, + SocketFactoryType as SocketFactoryType, +) +from .cookiejar import CookieJar as CookieJar, DummyCookieJar as DummyCookieJar +from .formdata import FormData as FormData +from .helpers import BasicAuth, ChainMapProxy, ETag +from .http import ( + HttpVersion as HttpVersion, + HttpVersion10 as HttpVersion10, + HttpVersion11 as HttpVersion11, + WebSocketError as WebSocketError, + WSCloseCode as WSCloseCode, + WSMessage as WSMessage, + WSMsgType as WSMsgType, +) +from .multipart import ( + BadContentDispositionHeader as BadContentDispositionHeader, + BadContentDispositionParam as BadContentDispositionParam, + BodyPartReader as BodyPartReader, + MultipartReader as MultipartReader, + MultipartWriter as MultipartWriter, + content_disposition_filename as content_disposition_filename, + parse_content_disposition as parse_content_disposition, +) +from .payload import ( + PAYLOAD_REGISTRY as PAYLOAD_REGISTRY, + AsyncIterablePayload as AsyncIterablePayload, + BufferedReaderPayload as BufferedReaderPayload, + BytesIOPayload as BytesIOPayload, + BytesPayload as BytesPayload, + IOBasePayload as IOBasePayload, + JsonPayload as JsonPayload, + Payload as Payload, + StringIOPayload as StringIOPayload, + StringPayload as StringPayload, + TextIOPayload as TextIOPayload, + get_payload as get_payload, + payload_type as payload_type, +) +from .payload_streamer import streamer as streamer +from .resolver import ( + AsyncResolver as AsyncResolver, + DefaultResolver as DefaultResolver, + ThreadedResolver as ThreadedResolver, +) +from .streams import ( + EMPTY_PAYLOAD as EMPTY_PAYLOAD, + DataQueue as DataQueue, + EofStream as EofStream, + FlowControlDataQueue as FlowControlDataQueue, + StreamReader as StreamReader, +) +from .tracing import ( + TraceConfig as TraceConfig, + TraceConnectionCreateEndParams as TraceConnectionCreateEndParams, + TraceConnectionCreateStartParams as TraceConnectionCreateStartParams, + TraceConnectionQueuedEndParams as TraceConnectionQueuedEndParams, + TraceConnectionQueuedStartParams as TraceConnectionQueuedStartParams, + TraceConnectionReuseconnParams as TraceConnectionReuseconnParams, + TraceDnsCacheHitParams as TraceDnsCacheHitParams, + TraceDnsCacheMissParams as TraceDnsCacheMissParams, + TraceDnsResolveHostEndParams as TraceDnsResolveHostEndParams, + TraceDnsResolveHostStartParams as TraceDnsResolveHostStartParams, + TraceRequestChunkSentParams as TraceRequestChunkSentParams, + TraceRequestEndParams as TraceRequestEndParams, + TraceRequestExceptionParams as TraceRequestExceptionParams, + TraceRequestHeadersSentParams as TraceRequestHeadersSentParams, + TraceRequestRedirectParams as TraceRequestRedirectParams, + TraceRequestStartParams as TraceRequestStartParams, + TraceResponseChunkReceivedParams as TraceResponseChunkReceivedParams, +) + +if TYPE_CHECKING: + # At runtime these are lazy-loaded at the bottom of the file. + from .worker import ( + GunicornUVLoopWebWorker as GunicornUVLoopWebWorker, + GunicornWebWorker as GunicornWebWorker, + ) + +__all__: Tuple[str, ...] = ( + "hdrs", + # client + "AddrInfoType", + "BaseConnector", + "ClientConnectionError", + "ClientConnectionResetError", + "ClientConnectorCertificateError", + "ClientConnectorDNSError", + "ClientConnectorError", + "ClientConnectorSSLError", + "ClientError", + "ClientHttpProxyError", + "ClientOSError", + "ClientPayloadError", + "ClientProxyConnectionError", + "ClientResponse", + "ClientRequest", + "ClientResponseError", + "ClientSSLError", + "ClientSession", + "ClientTimeout", + "ClientWebSocketResponse", + "ClientWSTimeout", + "ConnectionTimeoutError", + "ContentTypeError", + "Fingerprint", + "FlowControlDataQueue", + "InvalidURL", + "InvalidUrlClientError", + "InvalidUrlRedirectClientError", + "NonHttpUrlClientError", + "NonHttpUrlRedirectClientError", + "RedirectClientError", + "RequestInfo", + "ServerConnectionError", + "ServerDisconnectedError", + "ServerFingerprintMismatch", + "ServerTimeoutError", + "SocketFactoryType", + "SocketTimeoutError", + "TCPConnector", + "TooManyRedirects", + "UnixConnector", + "NamedPipeConnector", + "WSServerHandshakeError", + "request", + # client_middleware + "ClientMiddlewareType", + "ClientHandlerType", + # cookiejar + "CookieJar", + "DummyCookieJar", + # formdata + "FormData", + # helpers + "BasicAuth", + "ChainMapProxy", + "DigestAuthMiddleware", + "ETag", + "set_zlib_backend", + # http + "HttpVersion", + "HttpVersion10", + "HttpVersion11", + "WSMsgType", + "WSCloseCode", + "WSMessage", + "WebSocketError", + # multipart + "BadContentDispositionHeader", + "BadContentDispositionParam", + "BodyPartReader", + "MultipartReader", + "MultipartWriter", + "content_disposition_filename", + "parse_content_disposition", + # payload + "AsyncIterablePayload", + "BufferedReaderPayload", + "BytesIOPayload", + "BytesPayload", + "IOBasePayload", + "JsonPayload", + "PAYLOAD_REGISTRY", + "Payload", + "StringIOPayload", + "StringPayload", + "TextIOPayload", + "get_payload", + "payload_type", + # payload_streamer + "streamer", + # resolver + "AsyncResolver", + "DefaultResolver", + "ThreadedResolver", + # streams + "DataQueue", + "EMPTY_PAYLOAD", + "EofStream", + "StreamReader", + # tracing + "TraceConfig", + "TraceConnectionCreateEndParams", + "TraceConnectionCreateStartParams", + "TraceConnectionQueuedEndParams", + "TraceConnectionQueuedStartParams", + "TraceConnectionReuseconnParams", + "TraceDnsCacheHitParams", + "TraceDnsCacheMissParams", + "TraceDnsResolveHostEndParams", + "TraceDnsResolveHostStartParams", + "TraceRequestChunkSentParams", + "TraceRequestEndParams", + "TraceRequestExceptionParams", + "TraceRequestHeadersSentParams", + "TraceRequestRedirectParams", + "TraceRequestStartParams", + "TraceResponseChunkReceivedParams", + # workers (imported lazily with __getattr__) + "GunicornUVLoopWebWorker", + "GunicornWebWorker", + "WSMessageTypeError", +) + + +def __dir__() -> Tuple[str, ...]: + return __all__ + ("__doc__",) + + +def __getattr__(name: str) -> object: + global GunicornUVLoopWebWorker, GunicornWebWorker + + # Importing gunicorn takes a long time (>100ms), so only import if actually needed. + if name in ("GunicornUVLoopWebWorker", "GunicornWebWorker"): + try: + from .worker import GunicornUVLoopWebWorker as guv, GunicornWebWorker as gw + except ImportError: + return None + + GunicornUVLoopWebWorker = guv # type: ignore[misc] + GunicornWebWorker = gw # type: ignore[misc] + return guv if name == "GunicornUVLoopWebWorker" else gw + + raise AttributeError(f"module {__name__} has no attribute {name}") diff --git a/env/lib/python3.12/site-packages/aiohttp/_cookie_helpers.py b/env/lib/python3.12/site-packages/aiohttp/_cookie_helpers.py new file mode 100644 index 0000000..10e2e0e --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_cookie_helpers.py @@ -0,0 +1,338 @@ +""" +Internal cookie handling helpers. + +This module contains internal utilities for cookie parsing and manipulation. +These are not part of the public API and may change without notice. +""" + +import re +from http.cookies import Morsel +from typing import List, Optional, Sequence, Tuple, cast + +from .log import internal_logger + +__all__ = ( + "parse_set_cookie_headers", + "parse_cookie_header", + "preserve_morsel_with_coded_value", +) + +# Cookie parsing constants +# Allow more characters in cookie names to handle real-world cookies +# that don't strictly follow RFC standards (fixes #2683) +# RFC 6265 defines cookie-name token as per RFC 2616 Section 2.2, +# but many servers send cookies with characters like {} [] () etc. +# This makes the cookie parser more tolerant of real-world cookies +# while still providing some validation to catch obviously malformed names. +_COOKIE_NAME_RE = re.compile(r"^[!#$%&\'()*+\-./0-9:<=>?@A-Z\[\]^_`a-z{|}~]+$") +_COOKIE_KNOWN_ATTRS = frozenset( # AKA Morsel._reserved + ( + "path", + "domain", + "max-age", + "expires", + "secure", + "httponly", + "samesite", + "partitioned", + "version", + "comment", + ) +) +_COOKIE_BOOL_ATTRS = frozenset( # AKA Morsel._flags + ("secure", "httponly", "partitioned") +) + +# SimpleCookie's pattern for parsing cookies with relaxed validation +# Based on http.cookies pattern but extended to allow more characters in cookie names +# to handle real-world cookies (fixes #2683) +_COOKIE_PATTERN = re.compile( + r""" + \s* # Optional whitespace at start of cookie + (?P # Start of group 'key' + # aiohttp has extended to include [] for compatibility with real-world cookies + [\w\d!#%&'~_`><@,:/\$\*\+\-\.\^\|\)\(\?\}\{\[\]]+ # Any word of at least one letter + ) # End of group 'key' + ( # Optional group: there may not be a value. + \s*=\s* # Equal Sign + (?P # Start of group 'val' + "(?:[^\\"]|\\.)*" # Any double-quoted string (properly closed) + | # or + "[^";]* # Unmatched opening quote (differs from SimpleCookie - issue #7993) + | # or + # Special case for "expires" attr - RFC 822, RFC 850, RFC 1036, RFC 1123 + (\w{3,6}day|\w{3}),\s # Day of the week or abbreviated day (with comma) + [\w\d\s-]{9,11}\s[\d:]{8}\s # Date and time in specific format + (GMT|[+-]\d{4}) # Timezone: GMT or RFC 2822 offset like -0000, +0100 + # NOTE: RFC 2822 timezone support is an aiohttp extension + # for issue #4493 - SimpleCookie does NOT support this + | # or + # ANSI C asctime() format: "Wed Jun 9 10:18:14 2021" + # NOTE: This is an aiohttp extension for issue #4327 - SimpleCookie does NOT support this format + \w{3}\s+\w{3}\s+[\s\d]\d\s+\d{2}:\d{2}:\d{2}\s+\d{4} + | # or + [\w\d!#%&'~_`><@,:/\$\*\+\-\.\^\|\)\(\?\}\{\=\[\]]* # Any word or empty string + ) # End of group 'val' + )? # End of optional value group + \s* # Any number of spaces. + (\s+|;|$) # Ending either at space, semicolon, or EOS. + """, + re.VERBOSE | re.ASCII, +) + + +def preserve_morsel_with_coded_value(cookie: Morsel[str]) -> Morsel[str]: + """ + Preserve a Morsel's coded_value exactly as received from the server. + + This function ensures that cookie encoding is preserved exactly as sent by + the server, which is critical for compatibility with old servers that have + strict requirements about cookie formats. + + This addresses the issue described in https://github.com/aio-libs/aiohttp/pull/1453 + where Python's SimpleCookie would re-encode cookies, breaking authentication + with certain servers. + + Args: + cookie: A Morsel object from SimpleCookie + + Returns: + A Morsel object with preserved coded_value + + """ + mrsl_val = cast("Morsel[str]", cookie.get(cookie.key, Morsel())) + # We use __setstate__ instead of the public set() API because it allows us to + # bypass validation and set already validated state. This is more stable than + # setting protected attributes directly and unlikely to change since it would + # break pickling. + mrsl_val.__setstate__( # type: ignore[attr-defined] + {"key": cookie.key, "value": cookie.value, "coded_value": cookie.coded_value} + ) + return mrsl_val + + +_unquote_sub = re.compile(r"\\(?:([0-3][0-7][0-7])|(.))").sub + + +def _unquote_replace(m: re.Match[str]) -> str: + """ + Replace function for _unquote_sub regex substitution. + + Handles escaped characters in cookie values: + - Octal sequences are converted to their character representation + - Other escaped characters are unescaped by removing the backslash + """ + if m[1]: + return chr(int(m[1], 8)) + return m[2] + + +def _unquote(value: str) -> str: + """ + Unquote a cookie value. + + Vendored from http.cookies._unquote to ensure compatibility. + + Note: The original implementation checked for None, but we've removed + that check since all callers already ensure the value is not None. + """ + # If there aren't any doublequotes, + # then there can't be any special characters. See RFC 2109. + if len(value) < 2: + return value + if value[0] != '"' or value[-1] != '"': + return value + + # We have to assume that we must decode this string. + # Down to work. + + # Remove the "s + value = value[1:-1] + + # Check for special sequences. Examples: + # \012 --> \n + # \" --> " + # + return _unquote_sub(_unquote_replace, value) + + +def parse_cookie_header(header: str) -> List[Tuple[str, Morsel[str]]]: + """ + Parse a Cookie header according to RFC 6265 Section 5.4. + + Cookie headers contain only name-value pairs separated by semicolons. + There are no attributes in Cookie headers - even names that match + attribute names (like 'path' or 'secure') should be treated as cookies. + + This parser uses the same regex-based approach as parse_set_cookie_headers + to properly handle quoted values that may contain semicolons. When the + regex fails to match a malformed cookie, it falls back to simple parsing + to ensure subsequent cookies are not lost + https://github.com/aio-libs/aiohttp/issues/11632 + + Args: + header: The Cookie header value to parse + + Returns: + List of (name, Morsel) tuples for compatibility with SimpleCookie.update() + """ + if not header: + return [] + + cookies: List[Tuple[str, Morsel[str]]] = [] + morsel: Morsel[str] + i = 0 + n = len(header) + + invalid_names = [] + while i < n: + # Use the same pattern as parse_set_cookie_headers to find cookies + match = _COOKIE_PATTERN.match(header, i) + if not match: + # Fallback for malformed cookies https://github.com/aio-libs/aiohttp/issues/11632 + # Find next semicolon to skip or attempt simple key=value parsing + next_semi = header.find(";", i) + eq_pos = header.find("=", i) + + # Try to extract key=value if '=' comes before ';' + if eq_pos != -1 and (next_semi == -1 or eq_pos < next_semi): + end_pos = next_semi if next_semi != -1 else n + key = header[i:eq_pos].strip() + value = header[eq_pos + 1 : end_pos].strip() + + # Validate the name (same as regex path) + if not _COOKIE_NAME_RE.match(key): + invalid_names.append(key) + else: + morsel = Morsel() + morsel.__setstate__( # type: ignore[attr-defined] + {"key": key, "value": _unquote(value), "coded_value": value} + ) + cookies.append((key, morsel)) + + # Move to next cookie or end + i = next_semi + 1 if next_semi != -1 else n + continue + + key = match.group("key") + value = match.group("val") or "" + i = match.end(0) + + # Validate the name + if not key or not _COOKIE_NAME_RE.match(key): + invalid_names.append(key) + continue + + # Create new morsel + morsel = Morsel() + # Preserve the original value as coded_value (with quotes if present) + # We use __setstate__ instead of the public set() API because it allows us to + # bypass validation and set already validated state. This is more stable than + # setting protected attributes directly and unlikely to change since it would + # break pickling. + morsel.__setstate__( # type: ignore[attr-defined] + {"key": key, "value": _unquote(value), "coded_value": value} + ) + + cookies.append((key, morsel)) + + if invalid_names: + internal_logger.debug( + "Cannot load cookie. Illegal cookie names: %r", invalid_names + ) + + return cookies + + +def parse_set_cookie_headers(headers: Sequence[str]) -> List[Tuple[str, Morsel[str]]]: + """ + Parse cookie headers using a vendored version of SimpleCookie parsing. + + This implementation is based on SimpleCookie.__parse_string to ensure + compatibility with how SimpleCookie parses cookies, including handling + of malformed cookies with missing semicolons. + + This function is used for both Cookie and Set-Cookie headers in order to be + forgiving. Ideally we would have followed RFC 6265 Section 5.2 (for Cookie + headers) and RFC 6265 Section 4.2.1 (for Set-Cookie headers), but the + real world data makes it impossible since we need to be a bit more forgiving. + + NOTE: This implementation differs from SimpleCookie in handling unmatched quotes. + SimpleCookie will stop parsing when it encounters a cookie value with an unmatched + quote (e.g., 'cookie="value'), causing subsequent cookies to be silently dropped. + This implementation handles unmatched quotes more gracefully to prevent cookie loss. + See https://github.com/aio-libs/aiohttp/issues/7993 + """ + parsed_cookies: List[Tuple[str, Morsel[str]]] = [] + + for header in headers: + if not header: + continue + + # Parse cookie string using SimpleCookie's algorithm + i = 0 + n = len(header) + current_morsel: Optional[Morsel[str]] = None + morsel_seen = False + + while 0 <= i < n: + # Start looking for a cookie + match = _COOKIE_PATTERN.match(header, i) + if not match: + # No more cookies + break + + key, value = match.group("key"), match.group("val") + i = match.end(0) + lower_key = key.lower() + + if key[0] == "$": + if not morsel_seen: + # We ignore attributes which pertain to the cookie + # mechanism as a whole, such as "$Version". + continue + # Process as attribute + if current_morsel is not None: + attr_lower_key = lower_key[1:] + if attr_lower_key in _COOKIE_KNOWN_ATTRS: + current_morsel[attr_lower_key] = value or "" + elif lower_key in _COOKIE_KNOWN_ATTRS: + if not morsel_seen: + # Invalid cookie string - attribute before cookie + break + if lower_key in _COOKIE_BOOL_ATTRS: + # Boolean attribute with any value should be True + if current_morsel is not None and current_morsel.isReservedKey(key): + current_morsel[lower_key] = True + elif value is None: + # Invalid cookie string - non-boolean attribute without value + break + elif current_morsel is not None: + # Regular attribute with value + current_morsel[lower_key] = _unquote(value) + elif value is not None: + # This is a cookie name=value pair + # Validate the name + if key in _COOKIE_KNOWN_ATTRS or not _COOKIE_NAME_RE.match(key): + internal_logger.warning( + "Can not load cookies: Illegal cookie name %r", key + ) + current_morsel = None + else: + # Create new morsel + current_morsel = Morsel() + # Preserve the original value as coded_value (with quotes if present) + # We use __setstate__ instead of the public set() API because it allows us to + # bypass validation and set already validated state. This is more stable than + # setting protected attributes directly and unlikely to change since it would + # break pickling. + current_morsel.__setstate__( # type: ignore[attr-defined] + {"key": key, "value": _unquote(value), "coded_value": value} + ) + parsed_cookies.append((key, current_morsel)) + morsel_seen = True + else: + # Invalid cookie string - no value for non-attribute + break + + return parsed_cookies diff --git a/env/lib/python3.12/site-packages/aiohttp/_cparser.pxd b/env/lib/python3.12/site-packages/aiohttp/_cparser.pxd new file mode 100644 index 0000000..1b3be6d --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_cparser.pxd @@ -0,0 +1,158 @@ +from libc.stdint cimport int32_t, uint8_t, uint16_t, uint64_t + + +cdef extern from "llhttp.h": + + struct llhttp__internal_s: + int32_t _index + void* _span_pos0 + void* _span_cb0 + int32_t error + const char* reason + const char* error_pos + void* data + void* _current + uint64_t content_length + uint8_t type + uint8_t method + uint8_t http_major + uint8_t http_minor + uint8_t header_state + uint8_t lenient_flags + uint8_t upgrade + uint8_t finish + uint16_t flags + uint16_t status_code + void* settings + + ctypedef llhttp__internal_s llhttp__internal_t + ctypedef llhttp__internal_t llhttp_t + + ctypedef int (*llhttp_data_cb)(llhttp_t*, const char *at, size_t length) except -1 + ctypedef int (*llhttp_cb)(llhttp_t*) except -1 + + struct llhttp_settings_s: + llhttp_cb on_message_begin + llhttp_data_cb on_url + llhttp_data_cb on_status + llhttp_data_cb on_header_field + llhttp_data_cb on_header_value + llhttp_cb on_headers_complete + llhttp_data_cb on_body + llhttp_cb on_message_complete + llhttp_cb on_chunk_header + llhttp_cb on_chunk_complete + + llhttp_cb on_url_complete + llhttp_cb on_status_complete + llhttp_cb on_header_field_complete + llhttp_cb on_header_value_complete + + ctypedef llhttp_settings_s llhttp_settings_t + + enum llhttp_errno: + HPE_OK, + HPE_INTERNAL, + HPE_STRICT, + HPE_LF_EXPECTED, + HPE_UNEXPECTED_CONTENT_LENGTH, + HPE_CLOSED_CONNECTION, + HPE_INVALID_METHOD, + HPE_INVALID_URL, + HPE_INVALID_CONSTANT, + HPE_INVALID_VERSION, + HPE_INVALID_HEADER_TOKEN, + HPE_INVALID_CONTENT_LENGTH, + HPE_INVALID_CHUNK_SIZE, + HPE_INVALID_STATUS, + HPE_INVALID_EOF_STATE, + HPE_INVALID_TRANSFER_ENCODING, + HPE_CB_MESSAGE_BEGIN, + HPE_CB_HEADERS_COMPLETE, + HPE_CB_MESSAGE_COMPLETE, + HPE_CB_CHUNK_HEADER, + HPE_CB_CHUNK_COMPLETE, + HPE_PAUSED, + HPE_PAUSED_UPGRADE, + HPE_USER + + ctypedef llhttp_errno llhttp_errno_t + + enum llhttp_flags: + F_CHUNKED, + F_CONTENT_LENGTH + + enum llhttp_type: + HTTP_REQUEST, + HTTP_RESPONSE, + HTTP_BOTH + + enum llhttp_method: + HTTP_DELETE, + HTTP_GET, + HTTP_HEAD, + HTTP_POST, + HTTP_PUT, + HTTP_CONNECT, + HTTP_OPTIONS, + HTTP_TRACE, + HTTP_COPY, + HTTP_LOCK, + HTTP_MKCOL, + HTTP_MOVE, + HTTP_PROPFIND, + HTTP_PROPPATCH, + HTTP_SEARCH, + HTTP_UNLOCK, + HTTP_BIND, + HTTP_REBIND, + HTTP_UNBIND, + HTTP_ACL, + HTTP_REPORT, + HTTP_MKACTIVITY, + HTTP_CHECKOUT, + HTTP_MERGE, + HTTP_MSEARCH, + HTTP_NOTIFY, + HTTP_SUBSCRIBE, + HTTP_UNSUBSCRIBE, + HTTP_PATCH, + HTTP_PURGE, + HTTP_MKCALENDAR, + HTTP_LINK, + HTTP_UNLINK, + HTTP_SOURCE, + HTTP_PRI, + HTTP_DESCRIBE, + HTTP_ANNOUNCE, + HTTP_SETUP, + HTTP_PLAY, + HTTP_PAUSE, + HTTP_TEARDOWN, + HTTP_GET_PARAMETER, + HTTP_SET_PARAMETER, + HTTP_REDIRECT, + HTTP_RECORD, + HTTP_FLUSH + + ctypedef llhttp_method llhttp_method_t; + + void llhttp_settings_init(llhttp_settings_t* settings) + void llhttp_init(llhttp_t* parser, llhttp_type type, + const llhttp_settings_t* settings) + + llhttp_errno_t llhttp_execute(llhttp_t* parser, const char* data, size_t len) + + int llhttp_should_keep_alive(const llhttp_t* parser) + + void llhttp_resume_after_upgrade(llhttp_t* parser) + + llhttp_errno_t llhttp_get_errno(const llhttp_t* parser) + const char* llhttp_get_error_reason(const llhttp_t* parser) + const char* llhttp_get_error_pos(const llhttp_t* parser) + + const char* llhttp_method_name(llhttp_method_t method) + + void llhttp_set_lenient_headers(llhttp_t* parser, int enabled) + void llhttp_set_lenient_optional_cr_before_lf(llhttp_t* parser, int enabled) + void llhttp_set_lenient_spaces_after_chunk_size(llhttp_t* parser, int enabled) diff --git a/env/lib/python3.12/site-packages/aiohttp/_find_header.pxd b/env/lib/python3.12/site-packages/aiohttp/_find_header.pxd new file mode 100644 index 0000000..37a6c37 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_find_header.pxd @@ -0,0 +1,2 @@ +cdef extern from "_find_header.h": + int find_header(char *, int) diff --git a/env/lib/python3.12/site-packages/aiohttp/_headers.pxi b/env/lib/python3.12/site-packages/aiohttp/_headers.pxi new file mode 100644 index 0000000..3744721 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_headers.pxi @@ -0,0 +1,83 @@ +# The file is autogenerated from aiohttp/hdrs.py +# Run ./tools/gen.py to update it after the origin changing. + +from . import hdrs +cdef tuple headers = ( + hdrs.ACCEPT, + hdrs.ACCEPT_CHARSET, + hdrs.ACCEPT_ENCODING, + hdrs.ACCEPT_LANGUAGE, + hdrs.ACCEPT_RANGES, + hdrs.ACCESS_CONTROL_ALLOW_CREDENTIALS, + hdrs.ACCESS_CONTROL_ALLOW_HEADERS, + hdrs.ACCESS_CONTROL_ALLOW_METHODS, + hdrs.ACCESS_CONTROL_ALLOW_ORIGIN, + hdrs.ACCESS_CONTROL_EXPOSE_HEADERS, + hdrs.ACCESS_CONTROL_MAX_AGE, + hdrs.ACCESS_CONTROL_REQUEST_HEADERS, + hdrs.ACCESS_CONTROL_REQUEST_METHOD, + hdrs.AGE, + hdrs.ALLOW, + hdrs.AUTHORIZATION, + hdrs.CACHE_CONTROL, + hdrs.CONNECTION, + hdrs.CONTENT_DISPOSITION, + hdrs.CONTENT_ENCODING, + hdrs.CONTENT_LANGUAGE, + hdrs.CONTENT_LENGTH, + hdrs.CONTENT_LOCATION, + hdrs.CONTENT_MD5, + hdrs.CONTENT_RANGE, + hdrs.CONTENT_TRANSFER_ENCODING, + hdrs.CONTENT_TYPE, + hdrs.COOKIE, + hdrs.DATE, + hdrs.DESTINATION, + hdrs.DIGEST, + hdrs.ETAG, + hdrs.EXPECT, + hdrs.EXPIRES, + hdrs.FORWARDED, + hdrs.FROM, + hdrs.HOST, + hdrs.IF_MATCH, + hdrs.IF_MODIFIED_SINCE, + hdrs.IF_NONE_MATCH, + hdrs.IF_RANGE, + hdrs.IF_UNMODIFIED_SINCE, + hdrs.KEEP_ALIVE, + hdrs.LAST_EVENT_ID, + hdrs.LAST_MODIFIED, + hdrs.LINK, + hdrs.LOCATION, + hdrs.MAX_FORWARDS, + hdrs.ORIGIN, + hdrs.PRAGMA, + hdrs.PROXY_AUTHENTICATE, + hdrs.PROXY_AUTHORIZATION, + hdrs.RANGE, + hdrs.REFERER, + hdrs.RETRY_AFTER, + hdrs.SEC_WEBSOCKET_ACCEPT, + hdrs.SEC_WEBSOCKET_EXTENSIONS, + hdrs.SEC_WEBSOCKET_KEY, + hdrs.SEC_WEBSOCKET_KEY1, + hdrs.SEC_WEBSOCKET_PROTOCOL, + hdrs.SEC_WEBSOCKET_VERSION, + hdrs.SERVER, + hdrs.SET_COOKIE, + hdrs.TE, + hdrs.TRAILER, + hdrs.TRANSFER_ENCODING, + hdrs.URI, + hdrs.UPGRADE, + hdrs.USER_AGENT, + hdrs.VARY, + hdrs.VIA, + hdrs.WWW_AUTHENTICATE, + hdrs.WANT_DIGEST, + hdrs.WARNING, + hdrs.X_FORWARDED_FOR, + hdrs.X_FORWARDED_HOST, + hdrs.X_FORWARDED_PROTO, +) diff --git a/env/lib/python3.12/site-packages/aiohttp/_http_parser.cpython-312-x86_64-linux-musl.so b/env/lib/python3.12/site-packages/aiohttp/_http_parser.cpython-312-x86_64-linux-musl.so new file mode 100755 index 0000000000000000000000000000000000000000..5bb764e491c2ec798cbb1219451f4b8551ab19ca GIT binary patch literal 2110720 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 z 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℘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%0AA)3GQ1~$L=w)R8_C@OuK*+jC*>K>W%x85ix(r6c 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 z

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štVwY>gV{Hx?c76Z$E=y@y*NijsM}A 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

dE2Wx;B$x4<1~}L$I8-!UR#SCYWBjly-2WC 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%0DeRLHSXGYa)S=cfUHX8@DfbrNWa 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

E2nzX1P$+*c!h*i^&$xb?~yYxkqXuJTeIbi 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∓CbjQ27a4Zn;h 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

ZKp7FQC(RA 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 gzogRF;deC6Kg`ek!|L^=Kl!#^Np_2qz i).decode('ascii')) + + +cdef inline str http_method_str(int i): + if i < METHODS_COUNT: + return _http_method[i] + else: + return "" + +cdef inline object find_header(bytes raw_header): + cdef Py_ssize_t size + cdef char *buf + cdef int idx + PyBytes_AsStringAndSize(raw_header, &buf, &size) + idx = _find_header.find_header(buf, size) + if idx == -1: + return raw_header.decode('utf-8', 'surrogateescape') + return headers[idx] + + +@cython.freelist(DEFAULT_FREELIST_SIZE) +cdef class RawRequestMessage: + cdef readonly str method + cdef readonly str path + cdef readonly object version # HttpVersion + cdef readonly object headers # CIMultiDict + cdef readonly object raw_headers # tuple + cdef readonly object should_close + cdef readonly object compression + cdef readonly object upgrade + cdef readonly object chunked + cdef readonly object url # yarl.URL + + def __init__(self, method, path, version, headers, raw_headers, + should_close, compression, upgrade, chunked, url): + self.method = method + self.path = path + self.version = version + self.headers = headers + self.raw_headers = raw_headers + self.should_close = should_close + self.compression = compression + self.upgrade = upgrade + self.chunked = chunked + self.url = url + + def __repr__(self): + info = [] + info.append(("method", self.method)) + info.append(("path", self.path)) + info.append(("version", self.version)) + info.append(("headers", self.headers)) + info.append(("raw_headers", self.raw_headers)) + info.append(("should_close", self.should_close)) + info.append(("compression", self.compression)) + info.append(("upgrade", self.upgrade)) + info.append(("chunked", self.chunked)) + info.append(("url", self.url)) + sinfo = ', '.join(name + '=' + repr(val) for name, val in info) + return '' + + def _replace(self, **dct): + cdef RawRequestMessage ret + ret = _new_request_message(self.method, + self.path, + self.version, + self.headers, + self.raw_headers, + self.should_close, + self.compression, + self.upgrade, + self.chunked, + self.url) + if "method" in dct: + ret.method = dct["method"] + if "path" in dct: + ret.path = dct["path"] + if "version" in dct: + ret.version = dct["version"] + if "headers" in dct: + ret.headers = dct["headers"] + if "raw_headers" in dct: + ret.raw_headers = dct["raw_headers"] + if "should_close" in dct: + ret.should_close = dct["should_close"] + if "compression" in dct: + ret.compression = dct["compression"] + if "upgrade" in dct: + ret.upgrade = dct["upgrade"] + if "chunked" in dct: + ret.chunked = dct["chunked"] + if "url" in dct: + ret.url = dct["url"] + return ret + +cdef _new_request_message(str method, + str path, + object version, + object headers, + object raw_headers, + bint should_close, + object compression, + bint upgrade, + bint chunked, + object url): + cdef RawRequestMessage ret + ret = RawRequestMessage.__new__(RawRequestMessage) + ret.method = method + ret.path = path + ret.version = version + ret.headers = headers + ret.raw_headers = raw_headers + ret.should_close = should_close + ret.compression = compression + ret.upgrade = upgrade + ret.chunked = chunked + ret.url = url + return ret + + +@cython.freelist(DEFAULT_FREELIST_SIZE) +cdef class RawResponseMessage: + cdef readonly object version # HttpVersion + cdef readonly int code + cdef readonly str reason + cdef readonly object headers # CIMultiDict + cdef readonly object raw_headers # tuple + cdef readonly object should_close + cdef readonly object compression + cdef readonly object upgrade + cdef readonly object chunked + + def __init__(self, version, code, reason, headers, raw_headers, + should_close, compression, upgrade, chunked): + self.version = version + self.code = code + self.reason = reason + self.headers = headers + self.raw_headers = raw_headers + self.should_close = should_close + self.compression = compression + self.upgrade = upgrade + self.chunked = chunked + + def __repr__(self): + info = [] + info.append(("version", self.version)) + info.append(("code", self.code)) + info.append(("reason", self.reason)) + info.append(("headers", self.headers)) + info.append(("raw_headers", self.raw_headers)) + info.append(("should_close", self.should_close)) + info.append(("compression", self.compression)) + info.append(("upgrade", self.upgrade)) + info.append(("chunked", self.chunked)) + sinfo = ', '.join(name + '=' + repr(val) for name, val in info) + return '' + + +cdef _new_response_message(object version, + int code, + str reason, + object headers, + object raw_headers, + bint should_close, + object compression, + bint upgrade, + bint chunked): + cdef RawResponseMessage ret + ret = RawResponseMessage.__new__(RawResponseMessage) + ret.version = version + ret.code = code + ret.reason = reason + ret.headers = headers + ret.raw_headers = raw_headers + ret.should_close = should_close + ret.compression = compression + ret.upgrade = upgrade + ret.chunked = chunked + return ret + + +@cython.internal +cdef class HttpParser: + + cdef: + cparser.llhttp_t* _cparser + cparser.llhttp_settings_t* _csettings + + bytes _raw_name + object _name + bytes _raw_value + bint _has_value + + object _protocol + object _loop + object _timer + + size_t _max_line_size + size_t _max_field_size + size_t _max_headers + bint _response_with_body + bint _read_until_eof + + bint _started + object _url + bytearray _buf + str _path + str _reason + list _headers + list _raw_headers + bint _upgraded + list _messages + object _payload + bint _payload_error + object _payload_exception + object _last_error + bint _auto_decompress + int _limit + + str _content_encoding + + Py_buffer py_buf + + def __cinit__(self): + self._cparser = \ + PyMem_Malloc(sizeof(cparser.llhttp_t)) + if self._cparser is NULL: + raise MemoryError() + + self._csettings = \ + PyMem_Malloc(sizeof(cparser.llhttp_settings_t)) + if self._csettings is NULL: + raise MemoryError() + + def __dealloc__(self): + PyMem_Free(self._cparser) + PyMem_Free(self._csettings) + + cdef _init( + self, cparser.llhttp_type mode, + object protocol, object loop, int limit, + object timer=None, + size_t max_line_size=8190, size_t max_headers=32768, + size_t max_field_size=8190, payload_exception=None, + bint response_with_body=True, bint read_until_eof=False, + bint auto_decompress=True, + ): + cparser.llhttp_settings_init(self._csettings) + cparser.llhttp_init(self._cparser, mode, self._csettings) + self._cparser.data = self + self._cparser.content_length = 0 + + self._protocol = protocol + self._loop = loop + self._timer = timer + + self._buf = bytearray() + self._payload = None + self._payload_error = 0 + self._payload_exception = payload_exception + self._messages = [] + + self._raw_name = EMPTY_BYTES + self._raw_value = EMPTY_BYTES + self._has_value = False + + self._max_line_size = max_line_size + self._max_headers = max_headers + self._max_field_size = max_field_size + self._response_with_body = response_with_body + self._read_until_eof = read_until_eof + self._upgraded = False + self._auto_decompress = auto_decompress + self._content_encoding = None + + self._csettings.on_url = cb_on_url + self._csettings.on_status = cb_on_status + self._csettings.on_header_field = cb_on_header_field + self._csettings.on_header_value = cb_on_header_value + self._csettings.on_headers_complete = cb_on_headers_complete + self._csettings.on_body = cb_on_body + self._csettings.on_message_begin = cb_on_message_begin + self._csettings.on_message_complete = cb_on_message_complete + self._csettings.on_chunk_header = cb_on_chunk_header + self._csettings.on_chunk_complete = cb_on_chunk_complete + + self._last_error = None + self._limit = limit + + cdef _process_header(self): + cdef str value + if self._raw_name is not EMPTY_BYTES: + name = find_header(self._raw_name) + value = self._raw_value.decode('utf-8', 'surrogateescape') + + self._headers.append((name, value)) + + if name is CONTENT_ENCODING: + self._content_encoding = value + + self._has_value = False + self._raw_headers.append((self._raw_name, self._raw_value)) + self._raw_name = EMPTY_BYTES + self._raw_value = EMPTY_BYTES + + cdef _on_header_field(self, char* at, size_t length): + if self._has_value: + self._process_header() + + if self._raw_name is EMPTY_BYTES: + self._raw_name = at[:length] + else: + self._raw_name += at[:length] + + cdef _on_header_value(self, char* at, size_t length): + if self._raw_value is EMPTY_BYTES: + self._raw_value = at[:length] + else: + self._raw_value += at[:length] + self._has_value = True + + cdef _on_headers_complete(self): + self._process_header() + + should_close = not cparser.llhttp_should_keep_alive(self._cparser) + upgrade = self._cparser.upgrade + chunked = self._cparser.flags & cparser.F_CHUNKED + + raw_headers = tuple(self._raw_headers) + headers = CIMultiDictProxy(CIMultiDict(self._headers)) + + if self._cparser.type == cparser.HTTP_REQUEST: + h_upg = headers.get("upgrade", "") + allowed = upgrade and h_upg.isascii() and h_upg.lower() in ALLOWED_UPGRADES + if allowed or self._cparser.method == cparser.HTTP_CONNECT: + self._upgraded = True + else: + if upgrade and self._cparser.status_code == 101: + self._upgraded = True + + # do not support old websocket spec + if SEC_WEBSOCKET_KEY1 in headers: + raise InvalidHeader(SEC_WEBSOCKET_KEY1) + + encoding = None + enc = self._content_encoding + if enc is not None: + self._content_encoding = None + if enc.isascii() and enc.lower() in {"gzip", "deflate", "br", "zstd"}: + encoding = enc + + if self._cparser.type == cparser.HTTP_REQUEST: + method = http_method_str(self._cparser.method) + msg = _new_request_message( + method, self._path, + self.http_version(), headers, raw_headers, + should_close, encoding, upgrade, chunked, self._url) + else: + msg = _new_response_message( + self.http_version(), self._cparser.status_code, self._reason, + headers, raw_headers, should_close, encoding, + upgrade, chunked) + + if ( + ULLONG_MAX > self._cparser.content_length > 0 or chunked or + self._cparser.method == cparser.HTTP_CONNECT or + (self._cparser.status_code >= 199 and + self._cparser.content_length == 0 and + self._read_until_eof) + ): + payload = StreamReader( + self._protocol, timer=self._timer, loop=self._loop, + limit=self._limit) + else: + payload = EMPTY_PAYLOAD + + self._payload = payload + if encoding is not None and self._auto_decompress: + self._payload = DeflateBuffer(payload, encoding) + + if not self._response_with_body: + payload = EMPTY_PAYLOAD + + self._messages.append((msg, payload)) + + cdef _on_message_complete(self): + self._payload.feed_eof() + self._payload = None + + cdef _on_chunk_header(self): + self._payload.begin_http_chunk_receiving() + + cdef _on_chunk_complete(self): + self._payload.end_http_chunk_receiving() + + cdef object _on_status_complete(self): + pass + + cdef inline http_version(self): + cdef cparser.llhttp_t* parser = self._cparser + + if parser.http_major == 1: + if parser.http_minor == 0: + return HttpVersion10 + elif parser.http_minor == 1: + return HttpVersion11 + + return HttpVersion(parser.http_major, parser.http_minor) + + ### Public API ### + + def feed_eof(self): + cdef bytes desc + + if self._payload is not None: + if self._cparser.flags & cparser.F_CHUNKED: + raise TransferEncodingError( + "Not enough data to satisfy transfer length header.") + elif self._cparser.flags & cparser.F_CONTENT_LENGTH: + raise ContentLengthError( + "Not enough data to satisfy content length header.") + elif cparser.llhttp_get_errno(self._cparser) != cparser.HPE_OK: + desc = cparser.llhttp_get_error_reason(self._cparser) + raise PayloadEncodingError(desc.decode('latin-1')) + else: + self._payload.feed_eof() + elif self._started: + self._on_headers_complete() + if self._messages: + return self._messages[-1][0] + + def feed_data(self, data): + cdef: + size_t data_len + size_t nb + cdef cparser.llhttp_errno_t errno + + PyObject_GetBuffer(data, &self.py_buf, PyBUF_SIMPLE) + data_len = self.py_buf.len + + errno = cparser.llhttp_execute( + self._cparser, + self.py_buf.buf, + data_len) + + if errno is cparser.HPE_PAUSED_UPGRADE: + cparser.llhttp_resume_after_upgrade(self._cparser) + + nb = cparser.llhttp_get_error_pos(self._cparser) - self.py_buf.buf + + PyBuffer_Release(&self.py_buf) + + if errno not in (cparser.HPE_OK, cparser.HPE_PAUSED_UPGRADE): + if self._payload_error == 0: + if self._last_error is not None: + ex = self._last_error + self._last_error = None + else: + after = cparser.llhttp_get_error_pos(self._cparser) + before = data[:after - self.py_buf.buf] + after_b = after.split(b"\r\n", 1)[0] + before = before.rsplit(b"\r\n", 1)[-1] + data = before + after_b + pointer = " " * (len(repr(before))-1) + "^" + ex = parser_error_from_errno(self._cparser, data, pointer) + self._payload = None + raise ex + + if self._messages: + messages = self._messages + self._messages = [] + else: + messages = () + + if self._upgraded: + return messages, True, data[nb:] + else: + return messages, False, b"" + + def set_upgraded(self, val): + self._upgraded = val + + +cdef class HttpRequestParser(HttpParser): + + def __init__( + self, protocol, loop, int limit, timer=None, + size_t max_line_size=8190, size_t max_headers=32768, + size_t max_field_size=8190, payload_exception=None, + bint response_with_body=True, bint read_until_eof=False, + bint auto_decompress=True, + ): + self._init(cparser.HTTP_REQUEST, protocol, loop, limit, timer, + max_line_size, max_headers, max_field_size, + payload_exception, response_with_body, read_until_eof, + auto_decompress) + + cdef object _on_status_complete(self): + cdef int idx1, idx2 + if not self._buf: + return + self._path = self._buf.decode('utf-8', 'surrogateescape') + try: + idx3 = len(self._path) + if self._cparser.method == cparser.HTTP_CONNECT: + # authority-form, + # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.3 + self._url = URL.build(authority=self._path, encoded=True) + elif idx3 > 1 and self._path[0] == '/': + # origin-form, + # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.1 + idx1 = self._path.find("?") + if idx1 == -1: + query = "" + idx2 = self._path.find("#") + if idx2 == -1: + path = self._path + fragment = "" + else: + path = self._path[0: idx2] + fragment = self._path[idx2+1:] + + else: + path = self._path[0:idx1] + idx1 += 1 + idx2 = self._path.find("#", idx1+1) + if idx2 == -1: + query = self._path[idx1:] + fragment = "" + else: + query = self._path[idx1: idx2] + fragment = self._path[idx2+1:] + + self._url = URL.build( + path=path, + query_string=query, + fragment=fragment, + encoded=True, + ) + else: + # absolute-form for proxy maybe, + # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.2 + self._url = URL(self._path, encoded=True) + finally: + PyByteArray_Resize(self._buf, 0) + + +cdef class HttpResponseParser(HttpParser): + + def __init__( + self, protocol, loop, int limit, timer=None, + size_t max_line_size=8190, size_t max_headers=32768, + size_t max_field_size=8190, payload_exception=None, + bint response_with_body=True, bint read_until_eof=False, + bint auto_decompress=True + ): + self._init(cparser.HTTP_RESPONSE, protocol, loop, limit, timer, + max_line_size, max_headers, max_field_size, + payload_exception, response_with_body, read_until_eof, + auto_decompress) + # Use strict parsing on dev mode, so users are warned about broken servers. + if not DEBUG: + cparser.llhttp_set_lenient_headers(self._cparser, 1) + cparser.llhttp_set_lenient_optional_cr_before_lf(self._cparser, 1) + cparser.llhttp_set_lenient_spaces_after_chunk_size(self._cparser, 1) + + cdef object _on_status_complete(self): + if self._buf: + self._reason = self._buf.decode('utf-8', 'surrogateescape') + PyByteArray_Resize(self._buf, 0) + else: + self._reason = self._reason or '' + +cdef int cb_on_message_begin(cparser.llhttp_t* parser) except -1: + cdef HttpParser pyparser = parser.data + + pyparser._started = True + pyparser._headers = [] + pyparser._raw_headers = [] + PyByteArray_Resize(pyparser._buf, 0) + pyparser._path = None + pyparser._reason = None + return 0 + + +cdef int cb_on_url(cparser.llhttp_t* parser, + const char *at, size_t length) except -1: + cdef HttpParser pyparser = parser.data + try: + if length > pyparser._max_line_size: + raise LineTooLong( + 'Status line is too long', pyparser._max_line_size, length) + extend(pyparser._buf, at, length) + except BaseException as ex: + pyparser._last_error = ex + return -1 + else: + return 0 + + +cdef int cb_on_status(cparser.llhttp_t* parser, + const char *at, size_t length) except -1: + cdef HttpParser pyparser = parser.data + cdef str reason + try: + if length > pyparser._max_line_size: + raise LineTooLong( + 'Status line is too long', pyparser._max_line_size, length) + extend(pyparser._buf, at, length) + except BaseException as ex: + pyparser._last_error = ex + return -1 + else: + return 0 + + +cdef int cb_on_header_field(cparser.llhttp_t* parser, + const char *at, size_t length) except -1: + cdef HttpParser pyparser = parser.data + cdef Py_ssize_t size + try: + pyparser._on_status_complete() + size = len(pyparser._raw_name) + length + if size > pyparser._max_field_size: + raise LineTooLong( + 'Header name is too long', pyparser._max_field_size, size) + pyparser._on_header_field(at, length) + except BaseException as ex: + pyparser._last_error = ex + return -1 + else: + return 0 + + +cdef int cb_on_header_value(cparser.llhttp_t* parser, + const char *at, size_t length) except -1: + cdef HttpParser pyparser = parser.data + cdef Py_ssize_t size + try: + size = len(pyparser._raw_value) + length + if size > pyparser._max_field_size: + raise LineTooLong( + 'Header value is too long', pyparser._max_field_size, size) + pyparser._on_header_value(at, length) + except BaseException as ex: + pyparser._last_error = ex + return -1 + else: + return 0 + + +cdef int cb_on_headers_complete(cparser.llhttp_t* parser) except -1: + cdef HttpParser pyparser = parser.data + try: + pyparser._on_status_complete() + pyparser._on_headers_complete() + except BaseException as exc: + pyparser._last_error = exc + return -1 + else: + if pyparser._upgraded or pyparser._cparser.method == cparser.HTTP_CONNECT: + return 2 + else: + return 0 + + +cdef int cb_on_body(cparser.llhttp_t* parser, + const char *at, size_t length) except -1: + cdef HttpParser pyparser = parser.data + cdef bytes body = at[:length] + try: + pyparser._payload.feed_data(body, length) + except BaseException as underlying_exc: + reraised_exc = underlying_exc + if pyparser._payload_exception is not None: + reraised_exc = pyparser._payload_exception(str(underlying_exc)) + + set_exception(pyparser._payload, reraised_exc, underlying_exc) + + pyparser._payload_error = 1 + return -1 + else: + return 0 + + +cdef int cb_on_message_complete(cparser.llhttp_t* parser) except -1: + cdef HttpParser pyparser = parser.data + try: + pyparser._started = False + pyparser._on_message_complete() + except BaseException as exc: + pyparser._last_error = exc + return -1 + else: + return 0 + + +cdef int cb_on_chunk_header(cparser.llhttp_t* parser) except -1: + cdef HttpParser pyparser = parser.data + try: + pyparser._on_chunk_header() + except BaseException as exc: + pyparser._last_error = exc + return -1 + else: + return 0 + + +cdef int cb_on_chunk_complete(cparser.llhttp_t* parser) except -1: + cdef HttpParser pyparser = parser.data + try: + pyparser._on_chunk_complete() + except BaseException as exc: + pyparser._last_error = exc + return -1 + else: + return 0 + + +cdef parser_error_from_errno(cparser.llhttp_t* parser, data, pointer): + cdef cparser.llhttp_errno_t errno = cparser.llhttp_get_errno(parser) + cdef bytes desc = cparser.llhttp_get_error_reason(parser) + + err_msg = "{}:\n\n {!r}\n {}".format(desc.decode("latin-1"), data, pointer) + + if errno in {cparser.HPE_CB_MESSAGE_BEGIN, + cparser.HPE_CB_HEADERS_COMPLETE, + cparser.HPE_CB_MESSAGE_COMPLETE, + cparser.HPE_CB_CHUNK_HEADER, + cparser.HPE_CB_CHUNK_COMPLETE, + cparser.HPE_INVALID_CONSTANT, + cparser.HPE_INVALID_HEADER_TOKEN, + cparser.HPE_INVALID_CONTENT_LENGTH, + cparser.HPE_INVALID_CHUNK_SIZE, + cparser.HPE_INVALID_EOF_STATE, + cparser.HPE_INVALID_TRANSFER_ENCODING}: + return BadHttpMessage(err_msg) + elif errno == cparser.HPE_INVALID_METHOD: + return BadHttpMethod(error=err_msg) + elif errno in {cparser.HPE_INVALID_STATUS, + cparser.HPE_INVALID_VERSION}: + return BadStatusLine(error=err_msg) + elif errno == cparser.HPE_INVALID_URL: + return InvalidURLError(err_msg) + + return BadHttpMessage(err_msg) diff --git a/env/lib/python3.12/site-packages/aiohttp/_http_writer.cpython-312-x86_64-linux-musl.so b/env/lib/python3.12/site-packages/aiohttp/_http_writer.cpython-312-x86_64-linux-musl.so new file mode 100755 index 0000000000000000000000000000000000000000..c59a7fef7c0a0f9fe7d3b701f89da349ec7eddf7 GIT binary patch literal 397960 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%0At@jro9L~2G!dNxay~4s+5xZ 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 literal 0 HcmV?d00001 diff --git a/env/lib/python3.12/site-packages/aiohttp/_http_writer.pyx b/env/lib/python3.12/site-packages/aiohttp/_http_writer.pyx new file mode 100644 index 0000000..7989c18 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_http_writer.pyx @@ -0,0 +1,162 @@ +from cpython.bytes cimport PyBytes_FromStringAndSize +from cpython.exc cimport PyErr_NoMemory +from cpython.mem cimport PyMem_Free, PyMem_Malloc, PyMem_Realloc +from cpython.object cimport PyObject_Str +from libc.stdint cimport uint8_t, uint64_t +from libc.string cimport memcpy + +from multidict import istr + +DEF BUF_SIZE = 16 * 1024 # 16KiB + +cdef object _istr = istr + + +# ----------------- writer --------------------------- + +cdef struct Writer: + char *buf + Py_ssize_t size + Py_ssize_t pos + bint heap_allocated + +cdef inline void _init_writer(Writer* writer, char *buf): + writer.buf = buf + writer.size = BUF_SIZE + writer.pos = 0 + writer.heap_allocated = 0 + + +cdef inline void _release_writer(Writer* writer): + if writer.heap_allocated: + PyMem_Free(writer.buf) + + +cdef inline int _write_byte(Writer* writer, uint8_t ch): + cdef char * buf + cdef Py_ssize_t size + + if writer.pos == writer.size: + # reallocate + size = writer.size + BUF_SIZE + if not writer.heap_allocated: + buf = PyMem_Malloc(size) + if buf == NULL: + PyErr_NoMemory() + return -1 + memcpy(buf, writer.buf, writer.size) + else: + buf = PyMem_Realloc(writer.buf, size) + if buf == NULL: + PyErr_NoMemory() + return -1 + writer.buf = buf + writer.size = size + writer.heap_allocated = 1 + writer.buf[writer.pos] = ch + writer.pos += 1 + return 0 + + +cdef inline int _write_utf8(Writer* writer, Py_UCS4 symbol): + cdef uint64_t utf = symbol + + if utf < 0x80: + return _write_byte(writer, utf) + elif utf < 0x800: + if _write_byte(writer, (0xc0 | (utf >> 6))) < 0: + return -1 + return _write_byte(writer, (0x80 | (utf & 0x3f))) + elif 0xD800 <= utf <= 0xDFFF: + # surogate pair, ignored + return 0 + elif utf < 0x10000: + if _write_byte(writer, (0xe0 | (utf >> 12))) < 0: + return -1 + if _write_byte(writer, (0x80 | ((utf >> 6) & 0x3f))) < 0: + return -1 + return _write_byte(writer, (0x80 | (utf & 0x3f))) + elif utf > 0x10FFFF: + # symbol is too large + return 0 + else: + if _write_byte(writer, (0xf0 | (utf >> 18))) < 0: + return -1 + if _write_byte(writer, + (0x80 | ((utf >> 12) & 0x3f))) < 0: + return -1 + if _write_byte(writer, + (0x80 | ((utf >> 6) & 0x3f))) < 0: + return -1 + return _write_byte(writer, (0x80 | (utf & 0x3f))) + + +cdef inline int _write_str(Writer* writer, str s): + cdef Py_UCS4 ch + for ch in s: + if _write_utf8(writer, ch) < 0: + return -1 + + +cdef inline int _write_str_raise_on_nlcr(Writer* writer, object s): + cdef Py_UCS4 ch + cdef str out_str + if type(s) is str: + out_str = s + elif type(s) is _istr: + out_str = PyObject_Str(s) + elif not isinstance(s, str): + raise TypeError("Cannot serialize non-str key {!r}".format(s)) + else: + out_str = str(s) + + for ch in out_str: + if ch == 0x0D or ch == 0x0A: + raise ValueError( + "Newline or carriage return detected in headers. " + "Potential header injection attack." + ) + if _write_utf8(writer, ch) < 0: + return -1 + + +# --------------- _serialize_headers ---------------------- + +def _serialize_headers(str status_line, headers): + cdef Writer writer + cdef object key + cdef object val + cdef char buf[BUF_SIZE] + + _init_writer(&writer, buf) + + try: + if _write_str(&writer, status_line) < 0: + raise + if _write_byte(&writer, b'\r') < 0: + raise + if _write_byte(&writer, b'\n') < 0: + raise + + for key, val in headers.items(): + if _write_str_raise_on_nlcr(&writer, key) < 0: + raise + if _write_byte(&writer, b':') < 0: + raise + if _write_byte(&writer, b' ') < 0: + raise + if _write_str_raise_on_nlcr(&writer, val) < 0: + raise + if _write_byte(&writer, b'\r') < 0: + raise + if _write_byte(&writer, b'\n') < 0: + raise + + if _write_byte(&writer, b'\r') < 0: + raise + if _write_byte(&writer, b'\n') < 0: + raise + + return PyBytes_FromStringAndSize(writer.buf, writer.pos) + finally: + _release_writer(&writer) diff --git a/env/lib/python3.12/site-packages/aiohttp/_websocket/.hash/mask.pxd.hash b/env/lib/python3.12/site-packages/aiohttp/_websocket/.hash/mask.pxd.hash new file mode 100644 index 0000000..eadfed3 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_websocket/.hash/mask.pxd.hash @@ -0,0 +1 @@ +b01999d409b29bd916e067bc963d5f2d9ee63cfc9ae0bccb769910131417bf93 /home/runner/work/aiohttp/aiohttp/aiohttp/_websocket/mask.pxd diff --git a/env/lib/python3.12/site-packages/aiohttp/_websocket/.hash/mask.pyx.hash b/env/lib/python3.12/site-packages/aiohttp/_websocket/.hash/mask.pyx.hash new file mode 100644 index 0000000..5cd7ae6 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_websocket/.hash/mask.pyx.hash @@ -0,0 +1 @@ +0478ceb55d0ed30ef1a7da742cd003449bc69a07cf9fdb06789bd2b347cbfffe /home/runner/work/aiohttp/aiohttp/aiohttp/_websocket/mask.pyx diff --git a/env/lib/python3.12/site-packages/aiohttp/_websocket/.hash/reader_c.pxd.hash b/env/lib/python3.12/site-packages/aiohttp/_websocket/.hash/reader_c.pxd.hash new file mode 100644 index 0000000..f2feb6a --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_websocket/.hash/reader_c.pxd.hash @@ -0,0 +1 @@ +9e5fe78ed0ebce5414d2b8e01868d90c1facc20b84d2d5ff6c23e86e44a155ae /home/runner/work/aiohttp/aiohttp/aiohttp/_websocket/reader_c.pxd diff --git a/env/lib/python3.12/site-packages/aiohttp/_websocket/__init__.py b/env/lib/python3.12/site-packages/aiohttp/_websocket/__init__.py new file mode 100644 index 0000000..836257c --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_websocket/__init__.py @@ -0,0 +1 @@ +"""WebSocket protocol versions 13 and 8.""" diff --git a/env/lib/python3.12/site-packages/aiohttp/_websocket/helpers.py b/env/lib/python3.12/site-packages/aiohttp/_websocket/helpers.py new file mode 100644 index 0000000..0bb58df --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_websocket/helpers.py @@ -0,0 +1,147 @@ +"""Helpers for WebSocket protocol versions 13 and 8.""" + +import functools +import re +from struct import Struct +from typing import TYPE_CHECKING, Final, List, Optional, Pattern, Tuple + +from ..helpers import NO_EXTENSIONS +from .models import WSHandshakeError + +UNPACK_LEN3 = Struct("!Q").unpack_from +UNPACK_CLOSE_CODE = Struct("!H").unpack +PACK_LEN1 = Struct("!BB").pack +PACK_LEN2 = Struct("!BBH").pack +PACK_LEN3 = Struct("!BBQ").pack +PACK_CLOSE_CODE = Struct("!H").pack +PACK_RANDBITS = Struct("!L").pack +MSG_SIZE: Final[int] = 2**14 +MASK_LEN: Final[int] = 4 + +WS_KEY: Final[bytes] = b"258EAFA5-E914-47DA-95CA-C5AB0DC85B11" + + +# Used by _websocket_mask_python +@functools.lru_cache +def _xor_table() -> List[bytes]: + return [bytes(a ^ b for a in range(256)) for b in range(256)] + + +def _websocket_mask_python(mask: bytes, data: bytearray) -> None: + """Websocket masking function. + + `mask` is a `bytes` object of length 4; `data` is a `bytearray` + object of any length. The contents of `data` are masked with `mask`, + as specified in section 5.3 of RFC 6455. + + Note that this function mutates the `data` argument. + + This pure-python implementation may be replaced by an optimized + version when available. + + """ + assert isinstance(data, bytearray), data + assert len(mask) == 4, mask + + if data: + _XOR_TABLE = _xor_table() + a, b, c, d = (_XOR_TABLE[n] for n in mask) + data[::4] = data[::4].translate(a) + data[1::4] = data[1::4].translate(b) + data[2::4] = data[2::4].translate(c) + data[3::4] = data[3::4].translate(d) + + +if TYPE_CHECKING or NO_EXTENSIONS: # pragma: no cover + websocket_mask = _websocket_mask_python +else: + try: + from .mask import _websocket_mask_cython # type: ignore[import-not-found] + + websocket_mask = _websocket_mask_cython + except ImportError: # pragma: no cover + websocket_mask = _websocket_mask_python + + +_WS_EXT_RE: Final[Pattern[str]] = re.compile( + r"^(?:;\s*(?:" + r"(server_no_context_takeover)|" + r"(client_no_context_takeover)|" + r"(server_max_window_bits(?:=(\d+))?)|" + r"(client_max_window_bits(?:=(\d+))?)))*$" +) + +_WS_EXT_RE_SPLIT: Final[Pattern[str]] = re.compile(r"permessage-deflate([^,]+)?") + + +def ws_ext_parse(extstr: Optional[str], isserver: bool = False) -> Tuple[int, bool]: + if not extstr: + return 0, False + + compress = 0 + notakeover = False + for ext in _WS_EXT_RE_SPLIT.finditer(extstr): + defext = ext.group(1) + # Return compress = 15 when get `permessage-deflate` + if not defext: + compress = 15 + break + match = _WS_EXT_RE.match(defext) + if match: + compress = 15 + if isserver: + # Server never fail to detect compress handshake. + # Server does not need to send max wbit to client + if match.group(4): + compress = int(match.group(4)) + # Group3 must match if group4 matches + # Compress wbit 8 does not support in zlib + # If compress level not support, + # CONTINUE to next extension + if compress > 15 or compress < 9: + compress = 0 + continue + if match.group(1): + notakeover = True + # Ignore regex group 5 & 6 for client_max_window_bits + break + else: + if match.group(6): + compress = int(match.group(6)) + # Group5 must match if group6 matches + # Compress wbit 8 does not support in zlib + # If compress level not support, + # FAIL the parse progress + if compress > 15 or compress < 9: + raise WSHandshakeError("Invalid window size") + if match.group(2): + notakeover = True + # Ignore regex group 5 & 6 for client_max_window_bits + break + # Return Fail if client side and not match + elif not isserver: + raise WSHandshakeError("Extension for deflate not supported" + ext.group(1)) + + return compress, notakeover + + +def ws_ext_gen( + compress: int = 15, isserver: bool = False, server_notakeover: bool = False +) -> str: + # client_notakeover=False not used for server + # compress wbit 8 does not support in zlib + if compress < 9 or compress > 15: + raise ValueError( + "Compress wbits must between 9 and 15, zlib does not support wbits=8" + ) + enabledext = ["permessage-deflate"] + if not isserver: + enabledext.append("client_max_window_bits") + + if compress < 15: + enabledext.append("server_max_window_bits=" + str(compress)) + if server_notakeover: + enabledext.append("server_no_context_takeover") + # if client_notakeover: + # enabledext.append('client_no_context_takeover') + return "; ".join(enabledext) diff --git a/env/lib/python3.12/site-packages/aiohttp/_websocket/mask.cpython-312-x86_64-linux-musl.so b/env/lib/python3.12/site-packages/aiohttp/_websocket/mask.cpython-312-x86_64-linux-musl.so new file mode 100755 index 0000000000000000000000000000000000000000..a71b27ff3f2f5f188820eccacfade653f5127d72 GIT binary patch literal 204904 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 + mask_buf = PyBytes_AsString(mask) + uint32_msk = (mask_buf)[0] + + # TODO: align in_data ptr to achieve even faster speeds + # does it need in python ?! malloc() always aligns to sizeof(long) bytes + + if sizeof(size_t) >= 8: + uint64_msk = uint32_msk + uint64_msk = (uint64_msk << 32) | uint32_msk + + while data_len >= 8: + (in_buf)[0] ^= uint64_msk + in_buf += 8 + data_len -= 8 + + + while data_len >= 4: + (in_buf)[0] ^= uint32_msk + in_buf += 4 + data_len -= 4 + + for i in range(0, data_len): + in_buf[i] ^= mask_buf[i] diff --git a/env/lib/python3.12/site-packages/aiohttp/_websocket/models.py b/env/lib/python3.12/site-packages/aiohttp/_websocket/models.py new file mode 100644 index 0000000..7e89b96 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_websocket/models.py @@ -0,0 +1,84 @@ +"""Models for WebSocket protocol versions 13 and 8.""" + +import json +from enum import IntEnum +from typing import Any, Callable, Final, NamedTuple, Optional, cast + +WS_DEFLATE_TRAILING: Final[bytes] = bytes([0x00, 0x00, 0xFF, 0xFF]) + + +class WSCloseCode(IntEnum): + OK = 1000 + GOING_AWAY = 1001 + PROTOCOL_ERROR = 1002 + UNSUPPORTED_DATA = 1003 + ABNORMAL_CLOSURE = 1006 + INVALID_TEXT = 1007 + POLICY_VIOLATION = 1008 + MESSAGE_TOO_BIG = 1009 + MANDATORY_EXTENSION = 1010 + INTERNAL_ERROR = 1011 + SERVICE_RESTART = 1012 + TRY_AGAIN_LATER = 1013 + BAD_GATEWAY = 1014 + + +class WSMsgType(IntEnum): + # websocket spec types + CONTINUATION = 0x0 + TEXT = 0x1 + BINARY = 0x2 + PING = 0x9 + PONG = 0xA + CLOSE = 0x8 + + # aiohttp specific types + CLOSING = 0x100 + CLOSED = 0x101 + ERROR = 0x102 + + text = TEXT + binary = BINARY + ping = PING + pong = PONG + close = CLOSE + closing = CLOSING + closed = CLOSED + error = ERROR + + +class WSMessage(NamedTuple): + type: WSMsgType + # To type correctly, this would need some kind of tagged union for each type. + data: Any + extra: Optional[str] + + def json(self, *, loads: Callable[[Any], Any] = json.loads) -> Any: + """Return parsed JSON data. + + .. versionadded:: 0.22 + """ + return loads(self.data) + + +# Constructing the tuple directly to avoid the overhead of +# the lambda and arg processing since NamedTuples are constructed +# with a run time built lambda +# https://github.com/python/cpython/blob/d83fcf8371f2f33c7797bc8f5423a8bca8c46e5c/Lib/collections/__init__.py#L441 +WS_CLOSED_MESSAGE = tuple.__new__(WSMessage, (WSMsgType.CLOSED, None, None)) +WS_CLOSING_MESSAGE = tuple.__new__(WSMessage, (WSMsgType.CLOSING, None, None)) + + +class WebSocketError(Exception): + """WebSocket protocol parser error.""" + + def __init__(self, code: int, message: str) -> None: + self.code = code + super().__init__(code, message) + + def __str__(self) -> str: + return cast(str, self.args[1]) + + +class WSHandshakeError(Exception): + """WebSocket protocol handshake error.""" diff --git a/env/lib/python3.12/site-packages/aiohttp/_websocket/reader.py b/env/lib/python3.12/site-packages/aiohttp/_websocket/reader.py new file mode 100644 index 0000000..23f3226 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_websocket/reader.py @@ -0,0 +1,31 @@ +"""Reader for WebSocket protocol versions 13 and 8.""" + +from typing import TYPE_CHECKING + +from ..helpers import NO_EXTENSIONS + +if TYPE_CHECKING or NO_EXTENSIONS: # pragma: no cover + from .reader_py import ( + WebSocketDataQueue as WebSocketDataQueuePython, + WebSocketReader as WebSocketReaderPython, + ) + + WebSocketReader = WebSocketReaderPython + WebSocketDataQueue = WebSocketDataQueuePython +else: + try: + from .reader_c import ( # type: ignore[import-not-found] + WebSocketDataQueue as WebSocketDataQueueCython, + WebSocketReader as WebSocketReaderCython, + ) + + WebSocketReader = WebSocketReaderCython + WebSocketDataQueue = WebSocketDataQueueCython + except ImportError: # pragma: no cover + from .reader_py import ( + WebSocketDataQueue as WebSocketDataQueuePython, + WebSocketReader as WebSocketReaderPython, + ) + + WebSocketReader = WebSocketReaderPython + WebSocketDataQueue = WebSocketDataQueuePython diff --git a/env/lib/python3.12/site-packages/aiohttp/_websocket/reader_c.cpython-312-x86_64-linux-musl.so b/env/lib/python3.12/site-packages/aiohttp/_websocket/reader_c.cpython-312-x86_64-linux-musl.so new file mode 100755 index 0000000000000000000000000000000000000000..d11be823cefd458319dadecbca7718ba9b4edd7e GIT binary patch literal 1289680 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 z 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 z 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 w>#HGAJ2eY5!8cz0a^`{o{# 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

{+@~%pR?y9_>JbQoT(+DX!a`*#G?`sec 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 JX#rZ^ None: + self._size = 0 + self._protocol = protocol + self._limit = limit * 2 + self._loop = loop + self._eof = False + self._waiter: Optional[asyncio.Future[None]] = None + self._exception: Union[BaseException, None] = None + self._buffer: Deque[Tuple[WSMessage, int]] = deque() + self._get_buffer = self._buffer.popleft + self._put_buffer = self._buffer.append + + def is_eof(self) -> bool: + return self._eof + + def exception(self) -> Optional[BaseException]: + return self._exception + + def set_exception( + self, + exc: BaseException, + exc_cause: builtins.BaseException = _EXC_SENTINEL, + ) -> None: + self._eof = True + self._exception = exc + if (waiter := self._waiter) is not None: + self._waiter = None + set_exception(waiter, exc, exc_cause) + + def _release_waiter(self) -> None: + if (waiter := self._waiter) is None: + return + self._waiter = None + if not waiter.done(): + waiter.set_result(None) + + def feed_eof(self) -> None: + self._eof = True + self._release_waiter() + self._exception = None # Break cyclic references + + def feed_data(self, data: "WSMessage", size: "cython_int") -> None: + self._size += size + self._put_buffer((data, size)) + self._release_waiter() + if self._size > self._limit and not self._protocol._reading_paused: + self._protocol.pause_reading() + + async def read(self) -> WSMessage: + if not self._buffer and not self._eof: + assert not self._waiter + self._waiter = self._loop.create_future() + try: + await self._waiter + except (asyncio.CancelledError, asyncio.TimeoutError): + self._waiter = None + raise + return self._read_from_buffer() + + def _read_from_buffer(self) -> WSMessage: + if self._buffer: + data, size = self._get_buffer() + self._size -= size + if self._size < self._limit and self._protocol._reading_paused: + self._protocol.resume_reading() + return data + if self._exception is not None: + raise self._exception + raise EofStream + + +class WebSocketReader: + def __init__( + self, queue: WebSocketDataQueue, max_msg_size: int, compress: bool = True + ) -> None: + self.queue = queue + self._max_msg_size = max_msg_size + + self._exc: Optional[Exception] = None + self._partial = bytearray() + self._state = READ_HEADER + + self._opcode: int = OP_CODE_NOT_SET + self._frame_fin = False + self._frame_opcode: int = OP_CODE_NOT_SET + self._payload_fragments: list[bytes] = [] + self._frame_payload_len = 0 + + self._tail: bytes = b"" + self._has_mask = False + self._frame_mask: Optional[bytes] = None + self._payload_bytes_to_read = 0 + self._payload_len_flag = 0 + self._compressed: int = COMPRESSED_NOT_SET + self._decompressobj: Optional[ZLibDecompressor] = None + self._compress = compress + + def feed_eof(self) -> None: + self.queue.feed_eof() + + # data can be bytearray on Windows because proactor event loop uses bytearray + # and asyncio types this to Union[bytes, bytearray, memoryview] so we need + # coerce data to bytes if it is not + def feed_data( + self, data: Union[bytes, bytearray, memoryview] + ) -> Tuple[bool, bytes]: + if type(data) is not bytes: + data = bytes(data) + + if self._exc is not None: + return True, data + + try: + self._feed_data(data) + except Exception as exc: + self._exc = exc + set_exception(self.queue, exc) + return EMPTY_FRAME_ERROR + + return EMPTY_FRAME + + def _handle_frame( + self, + fin: bool, + opcode: Union[int, cython_int], # Union intended: Cython pxd uses C int + payload: Union[bytes, bytearray], + compressed: Union[int, cython_int], # Union intended: Cython pxd uses C int + ) -> None: + msg: WSMessage + if opcode in {OP_CODE_TEXT, OP_CODE_BINARY, OP_CODE_CONTINUATION}: + # Validate continuation frames before processing + if opcode == OP_CODE_CONTINUATION and self._opcode == OP_CODE_NOT_SET: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Continuation frame for non started message", + ) + + # load text/binary + if not fin: + # got partial frame payload + if opcode != OP_CODE_CONTINUATION: + self._opcode = opcode + self._partial += payload + if self._max_msg_size and len(self._partial) >= self._max_msg_size: + raise WebSocketError( + WSCloseCode.MESSAGE_TOO_BIG, + f"Message size {len(self._partial)} " + f"exceeds limit {self._max_msg_size}", + ) + return + + has_partial = bool(self._partial) + if opcode == OP_CODE_CONTINUATION: + opcode = self._opcode + self._opcode = OP_CODE_NOT_SET + # previous frame was non finished + # we should get continuation opcode + elif has_partial: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "The opcode in non-fin frame is expected " + f"to be zero, got {opcode!r}", + ) + + assembled_payload: Union[bytes, bytearray] + if has_partial: + assembled_payload = self._partial + payload + self._partial.clear() + else: + assembled_payload = payload + + if self._max_msg_size and len(assembled_payload) >= self._max_msg_size: + raise WebSocketError( + WSCloseCode.MESSAGE_TOO_BIG, + f"Message size {len(assembled_payload)} " + f"exceeds limit {self._max_msg_size}", + ) + + # Decompress process must to be done after all packets + # received. + if compressed: + if not self._decompressobj: + self._decompressobj = ZLibDecompressor(suppress_deflate_header=True) + # XXX: It's possible that the zlib backend (isal is known to + # do this, maybe others too?) will return max_length bytes, + # but internally buffer more data such that the payload is + # >max_length, so we return one extra byte and if we're able + # to do that, then the message is too big. + payload_merged = self._decompressobj.decompress_sync( + assembled_payload + WS_DEFLATE_TRAILING, + ( + self._max_msg_size + 1 + if self._max_msg_size + else self._max_msg_size + ), + ) + if self._max_msg_size and len(payload_merged) > self._max_msg_size: + raise WebSocketError( + WSCloseCode.MESSAGE_TOO_BIG, + f"Decompressed message exceeds size limit {self._max_msg_size}", + ) + elif type(assembled_payload) is bytes: + payload_merged = assembled_payload + else: + payload_merged = bytes(assembled_payload) + + if opcode == OP_CODE_TEXT: + try: + text = payload_merged.decode("utf-8") + except UnicodeDecodeError as exc: + raise WebSocketError( + WSCloseCode.INVALID_TEXT, "Invalid UTF-8 text message" + ) from exc + + # XXX: The Text and Binary messages here can be a performance + # bottleneck, so we use tuple.__new__ to improve performance. + # This is not type safe, but many tests should fail in + # test_client_ws_functional.py if this is wrong. + self.queue.feed_data( + TUPLE_NEW(WSMessage, (WS_MSG_TYPE_TEXT, text, "")), + len(payload_merged), + ) + else: + self.queue.feed_data( + TUPLE_NEW(WSMessage, (WS_MSG_TYPE_BINARY, payload_merged, "")), + len(payload_merged), + ) + elif opcode == OP_CODE_CLOSE: + if len(payload) >= 2: + close_code = UNPACK_CLOSE_CODE(payload[:2])[0] + if close_code < 3000 and close_code not in ALLOWED_CLOSE_CODES: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + f"Invalid close code: {close_code}", + ) + try: + close_message = payload[2:].decode("utf-8") + except UnicodeDecodeError as exc: + raise WebSocketError( + WSCloseCode.INVALID_TEXT, "Invalid UTF-8 text message" + ) from exc + msg = TUPLE_NEW(WSMessage, (WSMsgType.CLOSE, close_code, close_message)) + elif payload: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + f"Invalid close frame: {fin} {opcode} {payload!r}", + ) + else: + msg = TUPLE_NEW(WSMessage, (WSMsgType.CLOSE, 0, "")) + + self.queue.feed_data(msg, 0) + elif opcode == OP_CODE_PING: + msg = TUPLE_NEW(WSMessage, (WSMsgType.PING, payload, "")) + self.queue.feed_data(msg, len(payload)) + elif opcode == OP_CODE_PONG: + msg = TUPLE_NEW(WSMessage, (WSMsgType.PONG, payload, "")) + self.queue.feed_data(msg, len(payload)) + else: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, f"Unexpected opcode={opcode!r}" + ) + + def _feed_data(self, data: bytes) -> None: + """Return the next frame from the socket.""" + if self._tail: + data, self._tail = self._tail + data, b"" + + start_pos: int = 0 + data_len = len(data) + data_cstr = data + + while True: + # read header + if self._state == READ_HEADER: + if data_len - start_pos < 2: + break + first_byte = data_cstr[start_pos] + second_byte = data_cstr[start_pos + 1] + start_pos += 2 + + fin = (first_byte >> 7) & 1 + rsv1 = (first_byte >> 6) & 1 + rsv2 = (first_byte >> 5) & 1 + rsv3 = (first_byte >> 4) & 1 + opcode = first_byte & 0xF + + # frame-fin = %x0 ; more frames of this message follow + # / %x1 ; final frame of this message + # frame-rsv1 = %x0 ; + # 1 bit, MUST be 0 unless negotiated otherwise + # frame-rsv2 = %x0 ; + # 1 bit, MUST be 0 unless negotiated otherwise + # frame-rsv3 = %x0 ; + # 1 bit, MUST be 0 unless negotiated otherwise + # + # Remove rsv1 from this test for deflate development + if rsv2 or rsv3 or (rsv1 and not self._compress): + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Received frame with non-zero reserved bits", + ) + + if opcode > 0x7 and fin == 0: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Received fragmented control frame", + ) + + has_mask = (second_byte >> 7) & 1 + length = second_byte & 0x7F + + # Control frames MUST have a payload + # length of 125 bytes or less + if opcode > 0x7 and length > 125: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Control frame payload cannot be larger than 125 bytes", + ) + + # Set compress status if last package is FIN + # OR set compress status if this is first fragment + # Raise error if not first fragment with rsv1 = 0x1 + if self._frame_fin or self._compressed == COMPRESSED_NOT_SET: + self._compressed = COMPRESSED_TRUE if rsv1 else COMPRESSED_FALSE + elif rsv1: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Received frame with non-zero reserved bits", + ) + + self._frame_fin = bool(fin) + self._frame_opcode = opcode + self._has_mask = bool(has_mask) + self._payload_len_flag = length + self._state = READ_PAYLOAD_LENGTH + + # read payload length + if self._state == READ_PAYLOAD_LENGTH: + len_flag = self._payload_len_flag + if len_flag == 126: + if data_len - start_pos < 2: + break + first_byte = data_cstr[start_pos] + second_byte = data_cstr[start_pos + 1] + start_pos += 2 + self._payload_bytes_to_read = first_byte << 8 | second_byte + elif len_flag > 126: + if data_len - start_pos < 8: + break + self._payload_bytes_to_read = UNPACK_LEN3(data, start_pos)[0] + start_pos += 8 + else: + self._payload_bytes_to_read = len_flag + + self._state = READ_PAYLOAD_MASK if self._has_mask else READ_PAYLOAD + + # read payload mask + if self._state == READ_PAYLOAD_MASK: + if data_len - start_pos < 4: + break + self._frame_mask = data_cstr[start_pos : start_pos + 4] + start_pos += 4 + self._state = READ_PAYLOAD + + if self._state == READ_PAYLOAD: + chunk_len = data_len - start_pos + if self._payload_bytes_to_read >= chunk_len: + f_end_pos = data_len + self._payload_bytes_to_read -= chunk_len + else: + f_end_pos = start_pos + self._payload_bytes_to_read + self._payload_bytes_to_read = 0 + + had_fragments = self._frame_payload_len + self._frame_payload_len += f_end_pos - start_pos + f_start_pos = start_pos + start_pos = f_end_pos + + if self._payload_bytes_to_read != 0: + # If we don't have a complete frame, we need to save the + # data for the next call to feed_data. + self._payload_fragments.append(data_cstr[f_start_pos:f_end_pos]) + break + + payload: Union[bytes, bytearray] + if had_fragments: + # We have to join the payload fragments get the payload + self._payload_fragments.append(data_cstr[f_start_pos:f_end_pos]) + if self._has_mask: + assert self._frame_mask is not None + payload_bytearray = bytearray(b"".join(self._payload_fragments)) + websocket_mask(self._frame_mask, payload_bytearray) + payload = payload_bytearray + else: + payload = b"".join(self._payload_fragments) + self._payload_fragments.clear() + elif self._has_mask: + assert self._frame_mask is not None + payload_bytearray = data_cstr[f_start_pos:f_end_pos] # type: ignore[assignment] + if type(payload_bytearray) is not bytearray: # pragma: no branch + # Cython will do the conversion for us + # but we need to do it for Python and we + # will always get here in Python + payload_bytearray = bytearray(payload_bytearray) + websocket_mask(self._frame_mask, payload_bytearray) + payload = payload_bytearray + else: + payload = data_cstr[f_start_pos:f_end_pos] + + self._handle_frame( + self._frame_fin, self._frame_opcode, payload, self._compressed + ) + self._frame_payload_len = 0 + self._state = READ_HEADER + + # XXX: Cython needs slices to be bounded, so we can't omit the slice end here. + self._tail = data_cstr[start_pos:data_len] if start_pos < data_len else b"" diff --git a/env/lib/python3.12/site-packages/aiohttp/_websocket/reader_py.py b/env/lib/python3.12/site-packages/aiohttp/_websocket/reader_py.py new file mode 100644 index 0000000..5166d7e --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_websocket/reader_py.py @@ -0,0 +1,478 @@ +"""Reader for WebSocket protocol versions 13 and 8.""" + +import asyncio +import builtins +from collections import deque +from typing import Deque, Final, Optional, Set, Tuple, Union + +from ..base_protocol import BaseProtocol +from ..compression_utils import ZLibDecompressor +from ..helpers import _EXC_SENTINEL, set_exception +from ..streams import EofStream +from .helpers import UNPACK_CLOSE_CODE, UNPACK_LEN3, websocket_mask +from .models import ( + WS_DEFLATE_TRAILING, + WebSocketError, + WSCloseCode, + WSMessage, + WSMsgType, +) + +ALLOWED_CLOSE_CODES: Final[Set[int]] = {int(i) for i in WSCloseCode} + +# States for the reader, used to parse the WebSocket frame +# integer values are used so they can be cythonized +READ_HEADER = 1 +READ_PAYLOAD_LENGTH = 2 +READ_PAYLOAD_MASK = 3 +READ_PAYLOAD = 4 + +WS_MSG_TYPE_BINARY = WSMsgType.BINARY +WS_MSG_TYPE_TEXT = WSMsgType.TEXT + +# WSMsgType values unpacked so they can by cythonized to ints +OP_CODE_NOT_SET = -1 +OP_CODE_CONTINUATION = WSMsgType.CONTINUATION.value +OP_CODE_TEXT = WSMsgType.TEXT.value +OP_CODE_BINARY = WSMsgType.BINARY.value +OP_CODE_CLOSE = WSMsgType.CLOSE.value +OP_CODE_PING = WSMsgType.PING.value +OP_CODE_PONG = WSMsgType.PONG.value + +EMPTY_FRAME_ERROR = (True, b"") +EMPTY_FRAME = (False, b"") + +COMPRESSED_NOT_SET = -1 +COMPRESSED_FALSE = 0 +COMPRESSED_TRUE = 1 + +TUPLE_NEW = tuple.__new__ + +cython_int = int # Typed to int in Python, but cython with use a signed int in the pxd + + +class WebSocketDataQueue: + """WebSocketDataQueue resumes and pauses an underlying stream. + + It is a destination for WebSocket data. + """ + + def __init__( + self, protocol: BaseProtocol, limit: int, *, loop: asyncio.AbstractEventLoop + ) -> None: + self._size = 0 + self._protocol = protocol + self._limit = limit * 2 + self._loop = loop + self._eof = False + self._waiter: Optional[asyncio.Future[None]] = None + self._exception: Union[BaseException, None] = None + self._buffer: Deque[Tuple[WSMessage, int]] = deque() + self._get_buffer = self._buffer.popleft + self._put_buffer = self._buffer.append + + def is_eof(self) -> bool: + return self._eof + + def exception(self) -> Optional[BaseException]: + return self._exception + + def set_exception( + self, + exc: BaseException, + exc_cause: builtins.BaseException = _EXC_SENTINEL, + ) -> None: + self._eof = True + self._exception = exc + if (waiter := self._waiter) is not None: + self._waiter = None + set_exception(waiter, exc, exc_cause) + + def _release_waiter(self) -> None: + if (waiter := self._waiter) is None: + return + self._waiter = None + if not waiter.done(): + waiter.set_result(None) + + def feed_eof(self) -> None: + self._eof = True + self._release_waiter() + self._exception = None # Break cyclic references + + def feed_data(self, data: "WSMessage", size: "cython_int") -> None: + self._size += size + self._put_buffer((data, size)) + self._release_waiter() + if self._size > self._limit and not self._protocol._reading_paused: + self._protocol.pause_reading() + + async def read(self) -> WSMessage: + if not self._buffer and not self._eof: + assert not self._waiter + self._waiter = self._loop.create_future() + try: + await self._waiter + except (asyncio.CancelledError, asyncio.TimeoutError): + self._waiter = None + raise + return self._read_from_buffer() + + def _read_from_buffer(self) -> WSMessage: + if self._buffer: + data, size = self._get_buffer() + self._size -= size + if self._size < self._limit and self._protocol._reading_paused: + self._protocol.resume_reading() + return data + if self._exception is not None: + raise self._exception + raise EofStream + + +class WebSocketReader: + def __init__( + self, queue: WebSocketDataQueue, max_msg_size: int, compress: bool = True + ) -> None: + self.queue = queue + self._max_msg_size = max_msg_size + + self._exc: Optional[Exception] = None + self._partial = bytearray() + self._state = READ_HEADER + + self._opcode: int = OP_CODE_NOT_SET + self._frame_fin = False + self._frame_opcode: int = OP_CODE_NOT_SET + self._payload_fragments: list[bytes] = [] + self._frame_payload_len = 0 + + self._tail: bytes = b"" + self._has_mask = False + self._frame_mask: Optional[bytes] = None + self._payload_bytes_to_read = 0 + self._payload_len_flag = 0 + self._compressed: int = COMPRESSED_NOT_SET + self._decompressobj: Optional[ZLibDecompressor] = None + self._compress = compress + + def feed_eof(self) -> None: + self.queue.feed_eof() + + # data can be bytearray on Windows because proactor event loop uses bytearray + # and asyncio types this to Union[bytes, bytearray, memoryview] so we need + # coerce data to bytes if it is not + def feed_data( + self, data: Union[bytes, bytearray, memoryview] + ) -> Tuple[bool, bytes]: + if type(data) is not bytes: + data = bytes(data) + + if self._exc is not None: + return True, data + + try: + self._feed_data(data) + except Exception as exc: + self._exc = exc + set_exception(self.queue, exc) + return EMPTY_FRAME_ERROR + + return EMPTY_FRAME + + def _handle_frame( + self, + fin: bool, + opcode: Union[int, cython_int], # Union intended: Cython pxd uses C int + payload: Union[bytes, bytearray], + compressed: Union[int, cython_int], # Union intended: Cython pxd uses C int + ) -> None: + msg: WSMessage + if opcode in {OP_CODE_TEXT, OP_CODE_BINARY, OP_CODE_CONTINUATION}: + # Validate continuation frames before processing + if opcode == OP_CODE_CONTINUATION and self._opcode == OP_CODE_NOT_SET: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Continuation frame for non started message", + ) + + # load text/binary + if not fin: + # got partial frame payload + if opcode != OP_CODE_CONTINUATION: + self._opcode = opcode + self._partial += payload + if self._max_msg_size and len(self._partial) >= self._max_msg_size: + raise WebSocketError( + WSCloseCode.MESSAGE_TOO_BIG, + f"Message size {len(self._partial)} " + f"exceeds limit {self._max_msg_size}", + ) + return + + has_partial = bool(self._partial) + if opcode == OP_CODE_CONTINUATION: + opcode = self._opcode + self._opcode = OP_CODE_NOT_SET + # previous frame was non finished + # we should get continuation opcode + elif has_partial: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "The opcode in non-fin frame is expected " + f"to be zero, got {opcode!r}", + ) + + assembled_payload: Union[bytes, bytearray] + if has_partial: + assembled_payload = self._partial + payload + self._partial.clear() + else: + assembled_payload = payload + + if self._max_msg_size and len(assembled_payload) >= self._max_msg_size: + raise WebSocketError( + WSCloseCode.MESSAGE_TOO_BIG, + f"Message size {len(assembled_payload)} " + f"exceeds limit {self._max_msg_size}", + ) + + # Decompress process must to be done after all packets + # received. + if compressed: + if not self._decompressobj: + self._decompressobj = ZLibDecompressor(suppress_deflate_header=True) + # XXX: It's possible that the zlib backend (isal is known to + # do this, maybe others too?) will return max_length bytes, + # but internally buffer more data such that the payload is + # >max_length, so we return one extra byte and if we're able + # to do that, then the message is too big. + payload_merged = self._decompressobj.decompress_sync( + assembled_payload + WS_DEFLATE_TRAILING, + ( + self._max_msg_size + 1 + if self._max_msg_size + else self._max_msg_size + ), + ) + if self._max_msg_size and len(payload_merged) > self._max_msg_size: + raise WebSocketError( + WSCloseCode.MESSAGE_TOO_BIG, + f"Decompressed message exceeds size limit {self._max_msg_size}", + ) + elif type(assembled_payload) is bytes: + payload_merged = assembled_payload + else: + payload_merged = bytes(assembled_payload) + + if opcode == OP_CODE_TEXT: + try: + text = payload_merged.decode("utf-8") + except UnicodeDecodeError as exc: + raise WebSocketError( + WSCloseCode.INVALID_TEXT, "Invalid UTF-8 text message" + ) from exc + + # XXX: The Text and Binary messages here can be a performance + # bottleneck, so we use tuple.__new__ to improve performance. + # This is not type safe, but many tests should fail in + # test_client_ws_functional.py if this is wrong. + self.queue.feed_data( + TUPLE_NEW(WSMessage, (WS_MSG_TYPE_TEXT, text, "")), + len(payload_merged), + ) + else: + self.queue.feed_data( + TUPLE_NEW(WSMessage, (WS_MSG_TYPE_BINARY, payload_merged, "")), + len(payload_merged), + ) + elif opcode == OP_CODE_CLOSE: + if len(payload) >= 2: + close_code = UNPACK_CLOSE_CODE(payload[:2])[0] + if close_code < 3000 and close_code not in ALLOWED_CLOSE_CODES: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + f"Invalid close code: {close_code}", + ) + try: + close_message = payload[2:].decode("utf-8") + except UnicodeDecodeError as exc: + raise WebSocketError( + WSCloseCode.INVALID_TEXT, "Invalid UTF-8 text message" + ) from exc + msg = TUPLE_NEW(WSMessage, (WSMsgType.CLOSE, close_code, close_message)) + elif payload: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + f"Invalid close frame: {fin} {opcode} {payload!r}", + ) + else: + msg = TUPLE_NEW(WSMessage, (WSMsgType.CLOSE, 0, "")) + + self.queue.feed_data(msg, 0) + elif opcode == OP_CODE_PING: + msg = TUPLE_NEW(WSMessage, (WSMsgType.PING, payload, "")) + self.queue.feed_data(msg, len(payload)) + elif opcode == OP_CODE_PONG: + msg = TUPLE_NEW(WSMessage, (WSMsgType.PONG, payload, "")) + self.queue.feed_data(msg, len(payload)) + else: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, f"Unexpected opcode={opcode!r}" + ) + + def _feed_data(self, data: bytes) -> None: + """Return the next frame from the socket.""" + if self._tail: + data, self._tail = self._tail + data, b"" + + start_pos: int = 0 + data_len = len(data) + data_cstr = data + + while True: + # read header + if self._state == READ_HEADER: + if data_len - start_pos < 2: + break + first_byte = data_cstr[start_pos] + second_byte = data_cstr[start_pos + 1] + start_pos += 2 + + fin = (first_byte >> 7) & 1 + rsv1 = (first_byte >> 6) & 1 + rsv2 = (first_byte >> 5) & 1 + rsv3 = (first_byte >> 4) & 1 + opcode = first_byte & 0xF + + # frame-fin = %x0 ; more frames of this message follow + # / %x1 ; final frame of this message + # frame-rsv1 = %x0 ; + # 1 bit, MUST be 0 unless negotiated otherwise + # frame-rsv2 = %x0 ; + # 1 bit, MUST be 0 unless negotiated otherwise + # frame-rsv3 = %x0 ; + # 1 bit, MUST be 0 unless negotiated otherwise + # + # Remove rsv1 from this test for deflate development + if rsv2 or rsv3 or (rsv1 and not self._compress): + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Received frame with non-zero reserved bits", + ) + + if opcode > 0x7 and fin == 0: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Received fragmented control frame", + ) + + has_mask = (second_byte >> 7) & 1 + length = second_byte & 0x7F + + # Control frames MUST have a payload + # length of 125 bytes or less + if opcode > 0x7 and length > 125: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Control frame payload cannot be larger than 125 bytes", + ) + + # Set compress status if last package is FIN + # OR set compress status if this is first fragment + # Raise error if not first fragment with rsv1 = 0x1 + if self._frame_fin or self._compressed == COMPRESSED_NOT_SET: + self._compressed = COMPRESSED_TRUE if rsv1 else COMPRESSED_FALSE + elif rsv1: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Received frame with non-zero reserved bits", + ) + + self._frame_fin = bool(fin) + self._frame_opcode = opcode + self._has_mask = bool(has_mask) + self._payload_len_flag = length + self._state = READ_PAYLOAD_LENGTH + + # read payload length + if self._state == READ_PAYLOAD_LENGTH: + len_flag = self._payload_len_flag + if len_flag == 126: + if data_len - start_pos < 2: + break + first_byte = data_cstr[start_pos] + second_byte = data_cstr[start_pos + 1] + start_pos += 2 + self._payload_bytes_to_read = first_byte << 8 | second_byte + elif len_flag > 126: + if data_len - start_pos < 8: + break + self._payload_bytes_to_read = UNPACK_LEN3(data, start_pos)[0] + start_pos += 8 + else: + self._payload_bytes_to_read = len_flag + + self._state = READ_PAYLOAD_MASK if self._has_mask else READ_PAYLOAD + + # read payload mask + if self._state == READ_PAYLOAD_MASK: + if data_len - start_pos < 4: + break + self._frame_mask = data_cstr[start_pos : start_pos + 4] + start_pos += 4 + self._state = READ_PAYLOAD + + if self._state == READ_PAYLOAD: + chunk_len = data_len - start_pos + if self._payload_bytes_to_read >= chunk_len: + f_end_pos = data_len + self._payload_bytes_to_read -= chunk_len + else: + f_end_pos = start_pos + self._payload_bytes_to_read + self._payload_bytes_to_read = 0 + + had_fragments = self._frame_payload_len + self._frame_payload_len += f_end_pos - start_pos + f_start_pos = start_pos + start_pos = f_end_pos + + if self._payload_bytes_to_read != 0: + # If we don't have a complete frame, we need to save the + # data for the next call to feed_data. + self._payload_fragments.append(data_cstr[f_start_pos:f_end_pos]) + break + + payload: Union[bytes, bytearray] + if had_fragments: + # We have to join the payload fragments get the payload + self._payload_fragments.append(data_cstr[f_start_pos:f_end_pos]) + if self._has_mask: + assert self._frame_mask is not None + payload_bytearray = bytearray(b"".join(self._payload_fragments)) + websocket_mask(self._frame_mask, payload_bytearray) + payload = payload_bytearray + else: + payload = b"".join(self._payload_fragments) + self._payload_fragments.clear() + elif self._has_mask: + assert self._frame_mask is not None + payload_bytearray = data_cstr[f_start_pos:f_end_pos] # type: ignore[assignment] + if type(payload_bytearray) is not bytearray: # pragma: no branch + # Cython will do the conversion for us + # but we need to do it for Python and we + # will always get here in Python + payload_bytearray = bytearray(payload_bytearray) + websocket_mask(self._frame_mask, payload_bytearray) + payload = payload_bytearray + else: + payload = data_cstr[f_start_pos:f_end_pos] + + self._handle_frame( + self._frame_fin, self._frame_opcode, payload, self._compressed + ) + self._frame_payload_len = 0 + self._state = READ_HEADER + + # XXX: Cython needs slices to be bounded, so we can't omit the slice end here. + self._tail = data_cstr[start_pos:data_len] if start_pos < data_len else b"" diff --git a/env/lib/python3.12/site-packages/aiohttp/_websocket/writer.py b/env/lib/python3.12/site-packages/aiohttp/_websocket/writer.py new file mode 100644 index 0000000..9604202 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/_websocket/writer.py @@ -0,0 +1,262 @@ +"""WebSocket protocol versions 13 and 8.""" + +import asyncio +import random +import sys +from functools import partial +from typing import Final, Optional, Set, Union + +from ..base_protocol import BaseProtocol +from ..client_exceptions import ClientConnectionResetError +from ..compression_utils import ZLibBackend, ZLibCompressor +from .helpers import ( + MASK_LEN, + MSG_SIZE, + PACK_CLOSE_CODE, + PACK_LEN1, + PACK_LEN2, + PACK_LEN3, + PACK_RANDBITS, + websocket_mask, +) +from .models import WS_DEFLATE_TRAILING, WSMsgType + +DEFAULT_LIMIT: Final[int] = 2**16 + +# WebSocket opcode boundary: opcodes 0-7 are data frames, 8-15 are control frames +# Control frames (ping, pong, close) are never compressed +WS_CONTROL_FRAME_OPCODE: Final[int] = 8 + +# For websockets, keeping latency low is extremely important as implementations +# generally expect to be able to send and receive messages quickly. We use a +# larger chunk size to reduce the number of executor calls and avoid task +# creation overhead, since both are significant sources of latency when chunks +# are small. A size of 16KiB was chosen as a balance between avoiding task +# overhead and not blocking the event loop too long with synchronous compression. + +WEBSOCKET_MAX_SYNC_CHUNK_SIZE = 16 * 1024 + + +class WebSocketWriter: + """WebSocket writer. + + The writer is responsible for sending messages to the client. It is + created by the protocol when a connection is established. The writer + should avoid implementing any application logic and should only be + concerned with the low-level details of the WebSocket protocol. + """ + + def __init__( + self, + protocol: BaseProtocol, + transport: asyncio.Transport, + *, + use_mask: bool = False, + limit: int = DEFAULT_LIMIT, + random: random.Random = random.Random(), + compress: int = 0, + notakeover: bool = False, + ) -> None: + """Initialize a WebSocket writer.""" + self.protocol = protocol + self.transport = transport + self.use_mask = use_mask + self.get_random_bits = partial(random.getrandbits, 32) + self.compress = compress + self.notakeover = notakeover + self._closing = False + self._limit = limit + self._output_size = 0 + self._compressobj: Optional[ZLibCompressor] = None + self._send_lock = asyncio.Lock() + self._background_tasks: Set[asyncio.Task[None]] = set() + + async def send_frame( + self, message: bytes, opcode: int, compress: Optional[int] = None + ) -> None: + """Send a frame over the websocket with message as its payload.""" + if self._closing and not (opcode & WSMsgType.CLOSE): + raise ClientConnectionResetError("Cannot write to closing transport") + + if not (compress or self.compress) or opcode >= WS_CONTROL_FRAME_OPCODE: + # Non-compressed frames don't need lock or shield + self._write_websocket_frame(message, opcode, 0) + elif len(message) <= WEBSOCKET_MAX_SYNC_CHUNK_SIZE: + # Small compressed payloads - compress synchronously in event loop + # We need the lock even though sync compression has no await points. + # This prevents small frames from interleaving with large frames that + # compress in the executor, avoiding compressor state corruption. + async with self._send_lock: + self._send_compressed_frame_sync(message, opcode, compress) + else: + # Large compressed frames need shield to prevent corruption + # For large compressed frames, the entire compress+send + # operation must be atomic. If cancelled after compression but + # before send, the compressor state would be advanced but data + # not sent, corrupting subsequent frames. + # Create a task to shield from cancellation + # The lock is acquired inside the shielded task so the entire + # operation (lock + compress + send) completes atomically. + # Use eager_start on Python 3.12+ to avoid scheduling overhead + loop = asyncio.get_running_loop() + coro = self._send_compressed_frame_async_locked(message, opcode, compress) + if sys.version_info >= (3, 12): + send_task = asyncio.Task(coro, loop=loop, eager_start=True) + else: + send_task = loop.create_task(coro) + # Keep a strong reference to prevent garbage collection + self._background_tasks.add(send_task) + send_task.add_done_callback(self._background_tasks.discard) + await asyncio.shield(send_task) + + # It is safe to return control to the event loop when using compression + # after this point as we have already sent or buffered all the data. + # Once we have written output_size up to the limit, we call the + # drain helper which waits for the transport to be ready to accept + # more data. This is a flow control mechanism to prevent the buffer + # from growing too large. The drain helper will return right away + # if the writer is not paused. + if self._output_size > self._limit: + self._output_size = 0 + if self.protocol._paused: + await self.protocol._drain_helper() + + def _write_websocket_frame(self, message: bytes, opcode: int, rsv: int) -> None: + """ + Write a websocket frame to the transport. + + This method handles frame header construction, masking, and writing to transport. + It does not handle compression or flow control - those are the responsibility + of the caller. + """ + msg_length = len(message) + + use_mask = self.use_mask + mask_bit = 0x80 if use_mask else 0 + + # Depending on the message length, the header is assembled differently. + # The first byte is reserved for the opcode and the RSV bits. + first_byte = 0x80 | rsv | opcode + if msg_length < 126: + header = PACK_LEN1(first_byte, msg_length | mask_bit) + header_len = 2 + elif msg_length < 65536: + header = PACK_LEN2(first_byte, 126 | mask_bit, msg_length) + header_len = 4 + else: + header = PACK_LEN3(first_byte, 127 | mask_bit, msg_length) + header_len = 10 + + if self.transport.is_closing(): + raise ClientConnectionResetError("Cannot write to closing transport") + + # https://datatracker.ietf.org/doc/html/rfc6455#section-5.3 + # If we are using a mask, we need to generate it randomly + # and apply it to the message before sending it. A mask is + # a 32-bit value that is applied to the message using a + # bitwise XOR operation. It is used to prevent certain types + # of attacks on the websocket protocol. The mask is only used + # when aiohttp is acting as a client. Servers do not use a mask. + if use_mask: + mask = PACK_RANDBITS(self.get_random_bits()) + message = bytearray(message) + websocket_mask(mask, message) + self.transport.write(header + mask + message) + self._output_size += MASK_LEN + elif msg_length > MSG_SIZE: + self.transport.write(header) + self.transport.write(message) + else: + self.transport.write(header + message) + + self._output_size += header_len + msg_length + + def _get_compressor(self, compress: Optional[int]) -> ZLibCompressor: + """Get or create a compressor object for the given compression level.""" + if compress: + # Do not set self._compress if compressing is for this frame + return ZLibCompressor( + level=ZLibBackend.Z_BEST_SPEED, + wbits=-compress, + max_sync_chunk_size=WEBSOCKET_MAX_SYNC_CHUNK_SIZE, + ) + if not self._compressobj: + self._compressobj = ZLibCompressor( + level=ZLibBackend.Z_BEST_SPEED, + wbits=-self.compress, + max_sync_chunk_size=WEBSOCKET_MAX_SYNC_CHUNK_SIZE, + ) + return self._compressobj + + def _send_compressed_frame_sync( + self, message: bytes, opcode: int, compress: Optional[int] + ) -> None: + """ + Synchronous send for small compressed frames. + + This is used for small compressed payloads that compress synchronously in the event loop. + Since there are no await points, this is inherently cancellation-safe. + """ + # RSV are the reserved bits in the frame header. They are used to + # indicate that the frame is using an extension. + # https://datatracker.ietf.org/doc/html/rfc6455#section-5.2 + compressobj = self._get_compressor(compress) + # (0x40) RSV1 is set for compressed frames + # https://datatracker.ietf.org/doc/html/rfc7692#section-7.2.3.1 + self._write_websocket_frame( + ( + compressobj.compress_sync(message) + + compressobj.flush( + ZLibBackend.Z_FULL_FLUSH + if self.notakeover + else ZLibBackend.Z_SYNC_FLUSH + ) + ).removesuffix(WS_DEFLATE_TRAILING), + opcode, + 0x40, + ) + + async def _send_compressed_frame_async_locked( + self, message: bytes, opcode: int, compress: Optional[int] + ) -> None: + """ + Async send for large compressed frames with lock. + + Acquires the lock and compresses large payloads asynchronously in + the executor. The lock is held for the entire operation to ensure + the compressor state is not corrupted by concurrent sends. + + MUST be run shielded from cancellation. If cancelled after + compression but before sending, the compressor state would be + advanced but data not sent, corrupting subsequent frames. + """ + async with self._send_lock: + # RSV are the reserved bits in the frame header. They are used to + # indicate that the frame is using an extension. + # https://datatracker.ietf.org/doc/html/rfc6455#section-5.2 + compressobj = self._get_compressor(compress) + # (0x40) RSV1 is set for compressed frames + # https://datatracker.ietf.org/doc/html/rfc7692#section-7.2.3.1 + self._write_websocket_frame( + ( + await compressobj.compress(message) + + compressobj.flush( + ZLibBackend.Z_FULL_FLUSH + if self.notakeover + else ZLibBackend.Z_SYNC_FLUSH + ) + ).removesuffix(WS_DEFLATE_TRAILING), + opcode, + 0x40, + ) + + async def close(self, code: int = 1000, message: Union[bytes, str] = b"") -> None: + """Close the websocket, sending the specified code and message.""" + if isinstance(message, str): + message = message.encode("utf-8") + try: + await self.send_frame( + PACK_CLOSE_CODE(code) + message, opcode=WSMsgType.CLOSE + ) + finally: + self._closing = True diff --git a/env/lib/python3.12/site-packages/aiohttp/abc.py b/env/lib/python3.12/site-packages/aiohttp/abc.py new file mode 100644 index 0000000..faf0957 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/abc.py @@ -0,0 +1,268 @@ +import asyncio +import logging +import socket +from abc import ABC, abstractmethod +from collections.abc import Sized +from http.cookies import BaseCookie, Morsel +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Dict, + Generator, + Iterable, + List, + Optional, + Sequence, + Tuple, + TypedDict, + Union, +) + +from multidict import CIMultiDict +from yarl import URL + +from ._cookie_helpers import parse_set_cookie_headers +from .typedefs import LooseCookies + +if TYPE_CHECKING: + from .web_app import Application + from .web_exceptions import HTTPException + from .web_request import BaseRequest, Request + from .web_response import StreamResponse +else: + BaseRequest = Request = Application = StreamResponse = None + HTTPException = None + + +class AbstractRouter(ABC): + def __init__(self) -> None: + self._frozen = False + + def post_init(self, app: Application) -> None: + """Post init stage. + + Not an abstract method for sake of backward compatibility, + but if the router wants to be aware of the application + it can override this. + """ + + @property + def frozen(self) -> bool: + return self._frozen + + def freeze(self) -> None: + """Freeze router.""" + self._frozen = True + + @abstractmethod + async def resolve(self, request: Request) -> "AbstractMatchInfo": + """Return MATCH_INFO for given request""" + + +class AbstractMatchInfo(ABC): + + __slots__ = () + + @property # pragma: no branch + @abstractmethod + def handler(self) -> Callable[[Request], Awaitable[StreamResponse]]: + """Execute matched request handler""" + + @property + @abstractmethod + def expect_handler( + self, + ) -> Callable[[Request], Awaitable[Optional[StreamResponse]]]: + """Expect handler for 100-continue processing""" + + @property # pragma: no branch + @abstractmethod + def http_exception(self) -> Optional[HTTPException]: + """HTTPException instance raised on router's resolving, or None""" + + @abstractmethod # pragma: no branch + def get_info(self) -> Dict[str, Any]: + """Return a dict with additional info useful for introspection""" + + @property # pragma: no branch + @abstractmethod + def apps(self) -> Tuple[Application, ...]: + """Stack of nested applications. + + Top level application is left-most element. + + """ + + @abstractmethod + def add_app(self, app: Application) -> None: + """Add application to the nested apps stack.""" + + @abstractmethod + def freeze(self) -> None: + """Freeze the match info. + + The method is called after route resolution. + + After the call .add_app() is forbidden. + + """ + + +class AbstractView(ABC): + """Abstract class based view.""" + + def __init__(self, request: Request) -> None: + self._request = request + + @property + def request(self) -> Request: + """Request instance.""" + return self._request + + @abstractmethod + def __await__(self) -> Generator[None, None, StreamResponse]: + """Execute the view handler.""" + + +class ResolveResult(TypedDict): + """Resolve result. + + This is the result returned from an AbstractResolver's + resolve method. + + :param hostname: The hostname that was provided. + :param host: The IP address that was resolved. + :param port: The port that was resolved. + :param family: The address family that was resolved. + :param proto: The protocol that was resolved. + :param flags: The flags that were resolved. + """ + + hostname: str + host: str + port: int + family: int + proto: int + flags: int + + +class AbstractResolver(ABC): + """Abstract DNS resolver.""" + + @abstractmethod + async def resolve( + self, host: str, port: int = 0, family: socket.AddressFamily = socket.AF_INET + ) -> List[ResolveResult]: + """Return IP address for given hostname""" + + @abstractmethod + async def close(self) -> None: + """Release resolver""" + + +if TYPE_CHECKING: + IterableBase = Iterable[Morsel[str]] +else: + IterableBase = Iterable + + +ClearCookiePredicate = Callable[["Morsel[str]"], bool] + + +class AbstractCookieJar(Sized, IterableBase): + """Abstract Cookie Jar.""" + + def __init__(self, *, loop: Optional[asyncio.AbstractEventLoop] = None) -> None: + self._loop = loop or asyncio.get_running_loop() + + @property + @abstractmethod + def quote_cookie(self) -> bool: + """Return True if cookies should be quoted.""" + + @abstractmethod + def clear(self, predicate: Optional[ClearCookiePredicate] = None) -> None: + """Clear all cookies if no predicate is passed.""" + + @abstractmethod + def clear_domain(self, domain: str) -> None: + """Clear all cookies for domain and all subdomains.""" + + @abstractmethod + def update_cookies(self, cookies: LooseCookies, response_url: URL = URL()) -> None: + """Update cookies.""" + + def update_cookies_from_headers( + self, headers: Sequence[str], response_url: URL + ) -> None: + """Update cookies from raw Set-Cookie headers.""" + if headers and (cookies_to_update := parse_set_cookie_headers(headers)): + self.update_cookies(cookies_to_update, response_url) + + @abstractmethod + def filter_cookies(self, request_url: URL) -> "BaseCookie[str]": + """Return the jar's cookies filtered by their attributes.""" + + +class AbstractStreamWriter(ABC): + """Abstract stream writer.""" + + buffer_size: int = 0 + output_size: int = 0 + length: Optional[int] = 0 + + @abstractmethod + async def write(self, chunk: Union[bytes, bytearray, memoryview]) -> None: + """Write chunk into stream.""" + + @abstractmethod + async def write_eof(self, chunk: bytes = b"") -> None: + """Write last chunk.""" + + @abstractmethod + async def drain(self) -> None: + """Flush the write buffer.""" + + @abstractmethod + def enable_compression( + self, encoding: str = "deflate", strategy: Optional[int] = None + ) -> None: + """Enable HTTP body compression""" + + @abstractmethod + def enable_chunking(self) -> None: + """Enable HTTP chunked mode""" + + @abstractmethod + async def write_headers( + self, status_line: str, headers: "CIMultiDict[str]" + ) -> None: + """Write HTTP headers""" + + def send_headers(self) -> None: + """Force sending buffered headers if not already sent. + + Required only if write_headers() buffers headers instead of sending immediately. + For backwards compatibility, this method does nothing by default. + """ + + +class AbstractAccessLogger(ABC): + """Abstract writer to access log.""" + + __slots__ = ("logger", "log_format") + + def __init__(self, logger: logging.Logger, log_format: str) -> None: + self.logger = logger + self.log_format = log_format + + @abstractmethod + def log(self, request: BaseRequest, response: StreamResponse, time: float) -> None: + """Emit log to logger.""" + + @property + def enabled(self) -> bool: + """Check if logger is enabled.""" + return True diff --git a/env/lib/python3.12/site-packages/aiohttp/base_protocol.py b/env/lib/python3.12/site-packages/aiohttp/base_protocol.py new file mode 100644 index 0000000..b0a67ed --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/base_protocol.py @@ -0,0 +1,100 @@ +import asyncio +from typing import Optional, cast + +from .client_exceptions import ClientConnectionResetError +from .helpers import set_exception +from .tcp_helpers import tcp_nodelay + + +class BaseProtocol(asyncio.Protocol): + __slots__ = ( + "_loop", + "_paused", + "_drain_waiter", + "_connection_lost", + "_reading_paused", + "transport", + ) + + def __init__(self, loop: asyncio.AbstractEventLoop) -> None: + self._loop: asyncio.AbstractEventLoop = loop + self._paused = False + self._drain_waiter: Optional[asyncio.Future[None]] = None + self._reading_paused = False + + self.transport: Optional[asyncio.Transport] = None + + @property + def connected(self) -> bool: + """Return True if the connection is open.""" + return self.transport is not None + + @property + def writing_paused(self) -> bool: + return self._paused + + def pause_writing(self) -> None: + assert not self._paused + self._paused = True + + def resume_writing(self) -> None: + assert self._paused + self._paused = False + + waiter = self._drain_waiter + if waiter is not None: + self._drain_waiter = None + if not waiter.done(): + waiter.set_result(None) + + def pause_reading(self) -> None: + if not self._reading_paused and self.transport is not None: + try: + self.transport.pause_reading() + except (AttributeError, NotImplementedError, RuntimeError): + pass + self._reading_paused = True + + def resume_reading(self) -> None: + if self._reading_paused and self.transport is not None: + try: + self.transport.resume_reading() + except (AttributeError, NotImplementedError, RuntimeError): + pass + self._reading_paused = False + + def connection_made(self, transport: asyncio.BaseTransport) -> None: + tr = cast(asyncio.Transport, transport) + tcp_nodelay(tr, True) + self.transport = tr + + def connection_lost(self, exc: Optional[BaseException]) -> None: + # Wake up the writer if currently paused. + self.transport = None + if not self._paused: + return + waiter = self._drain_waiter + if waiter is None: + return + self._drain_waiter = None + if waiter.done(): + return + if exc is None: + waiter.set_result(None) + else: + set_exception( + waiter, + ConnectionError("Connection lost"), + exc, + ) + + async def _drain_helper(self) -> None: + if self.transport is None: + raise ClientConnectionResetError("Connection lost") + if not self._paused: + return + waiter = self._drain_waiter + if waiter is None: + waiter = self._loop.create_future() + self._drain_waiter = waiter + await asyncio.shield(waiter) diff --git a/env/lib/python3.12/site-packages/aiohttp/client.py b/env/lib/python3.12/site-packages/aiohttp/client.py new file mode 100644 index 0000000..bc4ee17 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/client.py @@ -0,0 +1,1635 @@ +"""HTTP Client for asyncio.""" + +import asyncio +import base64 +import hashlib +import json +import os +import sys +import traceback +import warnings +from contextlib import suppress +from types import TracebackType +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Coroutine, + Final, + FrozenSet, + Generator, + Generic, + Iterable, + List, + Mapping, + Optional, + Sequence, + Set, + Tuple, + Type, + TypedDict, + TypeVar, + Union, +) + +import attr +from multidict import CIMultiDict, MultiDict, MultiDictProxy, istr +from yarl import URL + +from . import hdrs, http, payload +from ._websocket.reader import WebSocketDataQueue +from .abc import AbstractCookieJar +from .client_exceptions import ( + ClientConnectionError, + ClientConnectionResetError, + ClientConnectorCertificateError, + ClientConnectorDNSError, + ClientConnectorError, + ClientConnectorSSLError, + ClientError, + ClientHttpProxyError, + ClientOSError, + ClientPayloadError, + ClientProxyConnectionError, + ClientResponseError, + ClientSSLError, + ConnectionTimeoutError, + ContentTypeError, + InvalidURL, + InvalidUrlClientError, + InvalidUrlRedirectClientError, + NonHttpUrlClientError, + NonHttpUrlRedirectClientError, + RedirectClientError, + ServerConnectionError, + ServerDisconnectedError, + ServerFingerprintMismatch, + ServerTimeoutError, + SocketTimeoutError, + TooManyRedirects, + WSMessageTypeError, + WSServerHandshakeError, +) +from .client_middlewares import ClientMiddlewareType, build_client_middlewares +from .client_reqrep import ( + ClientRequest as ClientRequest, + ClientResponse as ClientResponse, + Fingerprint as Fingerprint, + RequestInfo as RequestInfo, + _merge_ssl_params, +) +from .client_ws import ( + DEFAULT_WS_CLIENT_TIMEOUT, + ClientWebSocketResponse as ClientWebSocketResponse, + ClientWSTimeout as ClientWSTimeout, +) +from .connector import ( + HTTP_AND_EMPTY_SCHEMA_SET, + BaseConnector as BaseConnector, + NamedPipeConnector as NamedPipeConnector, + TCPConnector as TCPConnector, + UnixConnector as UnixConnector, +) +from .cookiejar import CookieJar +from .helpers import ( + _SENTINEL, + DEBUG, + EMPTY_BODY_METHODS, + BasicAuth, + TimeoutHandle, + basicauth_from_netrc, + get_env_proxy_for_url, + netrc_from_env, + sentinel, + strip_auth_from_url, +) +from .http import WS_KEY, HttpVersion, WebSocketReader, WebSocketWriter +from .http_websocket import WSHandshakeError, ws_ext_gen, ws_ext_parse +from .tracing import Trace, TraceConfig +from .typedefs import JSONEncoder, LooseCookies, LooseHeaders, Query, StrOrURL + +__all__ = ( + # client_exceptions + "ClientConnectionError", + "ClientConnectionResetError", + "ClientConnectorCertificateError", + "ClientConnectorDNSError", + "ClientConnectorError", + "ClientConnectorSSLError", + "ClientError", + "ClientHttpProxyError", + "ClientOSError", + "ClientPayloadError", + "ClientProxyConnectionError", + "ClientResponseError", + "ClientSSLError", + "ConnectionTimeoutError", + "ContentTypeError", + "InvalidURL", + "InvalidUrlClientError", + "RedirectClientError", + "NonHttpUrlClientError", + "InvalidUrlRedirectClientError", + "NonHttpUrlRedirectClientError", + "ServerConnectionError", + "ServerDisconnectedError", + "ServerFingerprintMismatch", + "ServerTimeoutError", + "SocketTimeoutError", + "TooManyRedirects", + "WSServerHandshakeError", + # client_reqrep + "ClientRequest", + "ClientResponse", + "Fingerprint", + "RequestInfo", + # connector + "BaseConnector", + "TCPConnector", + "UnixConnector", + "NamedPipeConnector", + # client_ws + "ClientWebSocketResponse", + # client + "ClientSession", + "ClientTimeout", + "ClientWSTimeout", + "request", + "WSMessageTypeError", +) + + +if TYPE_CHECKING: + from ssl import SSLContext +else: + SSLContext = None + +if sys.version_info >= (3, 11) and TYPE_CHECKING: + from typing import Unpack + + +class _RequestOptions(TypedDict, total=False): + params: Query + data: Any + json: Any + cookies: Union[LooseCookies, None] + headers: Union[LooseHeaders, None] + skip_auto_headers: Union[Iterable[str], None] + auth: Union[BasicAuth, None] + allow_redirects: bool + max_redirects: int + compress: Union[str, bool, None] + chunked: Union[bool, None] + expect100: bool + raise_for_status: Union[None, bool, Callable[[ClientResponse], Awaitable[None]]] + read_until_eof: bool + proxy: Union[StrOrURL, None] + proxy_auth: Union[BasicAuth, None] + timeout: "Union[ClientTimeout, _SENTINEL, None]" + ssl: Union[SSLContext, bool, Fingerprint] + server_hostname: Union[str, None] + proxy_headers: Union[LooseHeaders, None] + trace_request_ctx: Union[Mapping[str, Any], None] + read_bufsize: Union[int, None] + auto_decompress: Union[bool, None] + max_line_size: Union[int, None] + max_field_size: Union[int, None] + middlewares: Optional[Sequence[ClientMiddlewareType]] + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class ClientTimeout: + total: Optional[float] = None + connect: Optional[float] = None + sock_read: Optional[float] = None + sock_connect: Optional[float] = None + ceil_threshold: float = 5 + + # pool_queue_timeout: Optional[float] = None + # dns_resolution_timeout: Optional[float] = None + # socket_connect_timeout: Optional[float] = None + # connection_acquiring_timeout: Optional[float] = None + # new_connection_timeout: Optional[float] = None + # http_header_timeout: Optional[float] = None + # response_body_timeout: Optional[float] = None + + # to create a timeout specific for a single request, either + # - create a completely new one to overwrite the default + # - or use http://www.attrs.org/en/stable/api.html#attr.evolve + # to overwrite the defaults + + +# 5 Minute default read timeout +DEFAULT_TIMEOUT: Final[ClientTimeout] = ClientTimeout(total=5 * 60, sock_connect=30) + +# https://www.rfc-editor.org/rfc/rfc9110#section-9.2.2 +IDEMPOTENT_METHODS = frozenset({"GET", "HEAD", "OPTIONS", "TRACE", "PUT", "DELETE"}) + +_RetType = TypeVar("_RetType", ClientResponse, ClientWebSocketResponse) +_CharsetResolver = Callable[[ClientResponse, bytes], str] + + +class ClientSession: + """First-class interface for making HTTP requests.""" + + ATTRS = frozenset( + [ + "_base_url", + "_base_url_origin", + "_source_traceback", + "_connector", + "_loop", + "_cookie_jar", + "_connector_owner", + "_default_auth", + "_version", + "_json_serialize", + "_requote_redirect_url", + "_timeout", + "_raise_for_status", + "_auto_decompress", + "_trust_env", + "_default_headers", + "_skip_auto_headers", + "_request_class", + "_response_class", + "_ws_response_class", + "_trace_configs", + "_read_bufsize", + "_max_line_size", + "_max_field_size", + "_resolve_charset", + "_default_proxy", + "_default_proxy_auth", + "_retry_connection", + "_middlewares", + "requote_redirect_url", + ] + ) + + _source_traceback: Optional[traceback.StackSummary] = None + _connector: Optional[BaseConnector] = None + + def __init__( + self, + base_url: Optional[StrOrURL] = None, + *, + connector: Optional[BaseConnector] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + cookies: Optional[LooseCookies] = None, + headers: Optional[LooseHeaders] = None, + proxy: Optional[StrOrURL] = None, + proxy_auth: Optional[BasicAuth] = None, + skip_auto_headers: Optional[Iterable[str]] = None, + auth: Optional[BasicAuth] = None, + json_serialize: JSONEncoder = json.dumps, + request_class: Type[ClientRequest] = ClientRequest, + response_class: Type[ClientResponse] = ClientResponse, + ws_response_class: Type[ClientWebSocketResponse] = ClientWebSocketResponse, + version: HttpVersion = http.HttpVersion11, + cookie_jar: Optional[AbstractCookieJar] = None, + connector_owner: bool = True, + raise_for_status: Union[ + bool, Callable[[ClientResponse], Awaitable[None]] + ] = False, + read_timeout: Union[float, _SENTINEL] = sentinel, + conn_timeout: Optional[float] = None, + timeout: Union[object, ClientTimeout] = sentinel, + auto_decompress: bool = True, + trust_env: bool = False, + requote_redirect_url: bool = True, + trace_configs: Optional[List[TraceConfig]] = None, + read_bufsize: int = 2**16, + max_line_size: int = 8190, + max_field_size: int = 8190, + fallback_charset_resolver: _CharsetResolver = lambda r, b: "utf-8", + middlewares: Sequence[ClientMiddlewareType] = (), + ssl_shutdown_timeout: Union[_SENTINEL, None, float] = sentinel, + ) -> None: + # We initialise _connector to None immediately, as it's referenced in __del__() + # and could cause issues if an exception occurs during initialisation. + self._connector: Optional[BaseConnector] = None + + if loop is None: + if connector is not None: + loop = connector._loop + + loop = loop or asyncio.get_running_loop() + + if base_url is None or isinstance(base_url, URL): + self._base_url: Optional[URL] = base_url + self._base_url_origin = None if base_url is None else base_url.origin() + else: + self._base_url = URL(base_url) + self._base_url_origin = self._base_url.origin() + assert self._base_url.absolute, "Only absolute URLs are supported" + if self._base_url is not None and not self._base_url.path.endswith("/"): + raise ValueError("base_url must have a trailing '/'") + + if timeout is sentinel or timeout is None: + self._timeout = DEFAULT_TIMEOUT + if read_timeout is not sentinel: + warnings.warn( + "read_timeout is deprecated, use timeout argument instead", + DeprecationWarning, + stacklevel=2, + ) + self._timeout = attr.evolve(self._timeout, total=read_timeout) + if conn_timeout is not None: + self._timeout = attr.evolve(self._timeout, connect=conn_timeout) + warnings.warn( + "conn_timeout is deprecated, use timeout argument instead", + DeprecationWarning, + stacklevel=2, + ) + else: + if not isinstance(timeout, ClientTimeout): + raise ValueError( + f"timeout parameter cannot be of {type(timeout)} type, " + "please use 'timeout=ClientTimeout(...)'", + ) + self._timeout = timeout + if read_timeout is not sentinel: + raise ValueError( + "read_timeout and timeout parameters " + "conflict, please setup " + "timeout.read" + ) + if conn_timeout is not None: + raise ValueError( + "conn_timeout and timeout parameters " + "conflict, please setup " + "timeout.connect" + ) + + if ssl_shutdown_timeout is not sentinel: + warnings.warn( + "The ssl_shutdown_timeout parameter is deprecated and will be removed in aiohttp 4.0", + DeprecationWarning, + stacklevel=2, + ) + + if connector is None: + connector = TCPConnector( + loop=loop, ssl_shutdown_timeout=ssl_shutdown_timeout + ) + + if connector._loop is not loop: + raise RuntimeError("Session and connector has to use same event loop") + + self._loop = loop + + if loop.get_debug(): + self._source_traceback = traceback.extract_stack(sys._getframe(1)) + + if cookie_jar is None: + cookie_jar = CookieJar(loop=loop) + self._cookie_jar = cookie_jar + + if cookies: + self._cookie_jar.update_cookies(cookies) + + self._connector = connector + self._connector_owner = connector_owner + self._default_auth = auth + self._version = version + self._json_serialize = json_serialize + self._raise_for_status = raise_for_status + self._auto_decompress = auto_decompress + self._trust_env = trust_env + self._requote_redirect_url = requote_redirect_url + self._read_bufsize = read_bufsize + self._max_line_size = max_line_size + self._max_field_size = max_field_size + + # Convert to list of tuples + if headers: + real_headers: CIMultiDict[str] = CIMultiDict(headers) + else: + real_headers = CIMultiDict() + self._default_headers: CIMultiDict[str] = real_headers + if skip_auto_headers is not None: + self._skip_auto_headers = frozenset(istr(i) for i in skip_auto_headers) + else: + self._skip_auto_headers = frozenset() + + self._request_class = request_class + self._response_class = response_class + self._ws_response_class = ws_response_class + + self._trace_configs = trace_configs or [] + for trace_config in self._trace_configs: + trace_config.freeze() + + self._resolve_charset = fallback_charset_resolver + + self._default_proxy = proxy + self._default_proxy_auth = proxy_auth + self._retry_connection: bool = True + self._middlewares = middlewares + + def __init_subclass__(cls: Type["ClientSession"]) -> None: + warnings.warn( + "Inheritance class {} from ClientSession " + "is discouraged".format(cls.__name__), + DeprecationWarning, + stacklevel=2, + ) + + if DEBUG: + + def __setattr__(self, name: str, val: Any) -> None: + if name not in self.ATTRS: + warnings.warn( + "Setting custom ClientSession.{} attribute " + "is discouraged".format(name), + DeprecationWarning, + stacklevel=2, + ) + super().__setattr__(name, val) + + def __del__(self, _warnings: Any = warnings) -> None: + if not self.closed: + kwargs = {"source": self} + _warnings.warn( + f"Unclosed client session {self!r}", ResourceWarning, **kwargs + ) + context = {"client_session": self, "message": "Unclosed client session"} + if self._source_traceback is not None: + context["source_traceback"] = self._source_traceback + self._loop.call_exception_handler(context) + + if sys.version_info >= (3, 11) and TYPE_CHECKING: + + def request( + self, + method: str, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + else: + + def request( + self, method: str, url: StrOrURL, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP request.""" + return _RequestContextManager(self._request(method, url, **kwargs)) + + def _build_url(self, str_or_url: StrOrURL) -> URL: + url = URL(str_or_url) + if self._base_url and not url.absolute: + return self._base_url.join(url) + return url + + async def _request( + self, + method: str, + str_or_url: StrOrURL, + *, + params: Query = None, + data: Any = None, + json: Any = None, + cookies: Optional[LooseCookies] = None, + headers: Optional[LooseHeaders] = None, + skip_auto_headers: Optional[Iterable[str]] = None, + auth: Optional[BasicAuth] = None, + allow_redirects: bool = True, + max_redirects: int = 10, + compress: Union[str, bool, None] = None, + chunked: Optional[bool] = None, + expect100: bool = False, + raise_for_status: Union[ + None, bool, Callable[[ClientResponse], Awaitable[None]] + ] = None, + read_until_eof: bool = True, + proxy: Optional[StrOrURL] = None, + proxy_auth: Optional[BasicAuth] = None, + timeout: Union[ClientTimeout, _SENTINEL] = sentinel, + verify_ssl: Optional[bool] = None, + fingerprint: Optional[bytes] = None, + ssl_context: Optional[SSLContext] = None, + ssl: Union[SSLContext, bool, Fingerprint] = True, + server_hostname: Optional[str] = None, + proxy_headers: Optional[LooseHeaders] = None, + trace_request_ctx: Optional[Mapping[str, Any]] = None, + read_bufsize: Optional[int] = None, + auto_decompress: Optional[bool] = None, + max_line_size: Optional[int] = None, + max_field_size: Optional[int] = None, + middlewares: Optional[Sequence[ClientMiddlewareType]] = None, + ) -> ClientResponse: + + # NOTE: timeout clamps existing connect and read timeouts. We cannot + # set the default to None because we need to detect if the user wants + # to use the existing timeouts by setting timeout to None. + + if self.closed: + raise RuntimeError("Session is closed") + + ssl = _merge_ssl_params(ssl, verify_ssl, ssl_context, fingerprint) + + if data is not None and json is not None: + raise ValueError( + "data and json parameters can not be used at the same time" + ) + elif json is not None: + data = payload.JsonPayload(json, dumps=self._json_serialize) + + if not isinstance(chunked, bool) and chunked is not None: + warnings.warn("Chunk size is deprecated #1615", DeprecationWarning) + + redirects = 0 + history: List[ClientResponse] = [] + version = self._version + params = params or {} + + # Merge with default headers and transform to CIMultiDict + headers = self._prepare_headers(headers) + + try: + url = self._build_url(str_or_url) + except ValueError as e: + raise InvalidUrlClientError(str_or_url) from e + + assert self._connector is not None + if url.scheme not in self._connector.allowed_protocol_schema_set: + raise NonHttpUrlClientError(url) + + skip_headers: Optional[Iterable[istr]] + if skip_auto_headers is not None: + skip_headers = { + istr(i) for i in skip_auto_headers + } | self._skip_auto_headers + elif self._skip_auto_headers: + skip_headers = self._skip_auto_headers + else: + skip_headers = None + + if proxy is None: + proxy = self._default_proxy + if proxy_auth is None: + proxy_auth = self._default_proxy_auth + + if proxy is None: + proxy_headers = None + else: + proxy_headers = self._prepare_headers(proxy_headers) + try: + proxy = URL(proxy) + except ValueError as e: + raise InvalidURL(proxy) from e + + if timeout is sentinel: + real_timeout: ClientTimeout = self._timeout + else: + if not isinstance(timeout, ClientTimeout): + real_timeout = ClientTimeout(total=timeout) + else: + real_timeout = timeout + # timeout is cumulative for all request operations + # (request, redirects, responses, data consuming) + tm = TimeoutHandle( + self._loop, real_timeout.total, ceil_threshold=real_timeout.ceil_threshold + ) + handle = tm.start() + + if read_bufsize is None: + read_bufsize = self._read_bufsize + + if auto_decompress is None: + auto_decompress = self._auto_decompress + + if max_line_size is None: + max_line_size = self._max_line_size + + if max_field_size is None: + max_field_size = self._max_field_size + + traces = [ + Trace( + self, + trace_config, + trace_config.trace_config_ctx(trace_request_ctx=trace_request_ctx), + ) + for trace_config in self._trace_configs + ] + + for trace in traces: + await trace.send_request_start(method, url.update_query(params), headers) + + timer = tm.timer() + try: + with timer: + # https://www.rfc-editor.org/rfc/rfc9112.html#name-retrying-requests + retry_persistent_connection = ( + self._retry_connection and method in IDEMPOTENT_METHODS + ) + while True: + url, auth_from_url = strip_auth_from_url(url) + if not url.raw_host: + # NOTE: Bail early, otherwise, causes `InvalidURL` through + # NOTE: `self._request_class()` below. + err_exc_cls = ( + InvalidUrlRedirectClientError + if redirects + else InvalidUrlClientError + ) + raise err_exc_cls(url) + # If `auth` was passed for an already authenticated URL, + # disallow only if this is the initial URL; this is to avoid issues + # with sketchy redirects that are not the caller's responsibility + if not history and (auth and auth_from_url): + raise ValueError( + "Cannot combine AUTH argument with " + "credentials encoded in URL" + ) + + # Override the auth with the one from the URL only if we + # have no auth, or if we got an auth from a redirect URL + if auth is None or (history and auth_from_url is not None): + auth = auth_from_url + + if ( + auth is None + and self._default_auth + and ( + not self._base_url or self._base_url_origin == url.origin() + ) + ): + auth = self._default_auth + + # Try netrc if auth is still None and trust_env is enabled. + if auth is None and self._trust_env and url.host is not None: + auth = await self._loop.run_in_executor( + None, self._get_netrc_auth, url.host + ) + + # It would be confusing if we support explicit + # Authorization header with auth argument + if ( + headers is not None + and auth is not None + and hdrs.AUTHORIZATION in headers + ): + raise ValueError( + "Cannot combine AUTHORIZATION header " + "with AUTH argument or credentials " + "encoded in URL" + ) + + all_cookies = self._cookie_jar.filter_cookies(url) + + if cookies is not None: + tmp_cookie_jar = CookieJar( + quote_cookie=self._cookie_jar.quote_cookie + ) + tmp_cookie_jar.update_cookies(cookies) + req_cookies = tmp_cookie_jar.filter_cookies(url) + if req_cookies: + all_cookies.load(req_cookies) + + proxy_: Optional[URL] = None + if proxy is not None: + proxy_ = URL(proxy) + elif self._trust_env: + with suppress(LookupError): + proxy_, proxy_auth = await asyncio.to_thread( + get_env_proxy_for_url, url + ) + + req = self._request_class( + method, + url, + params=params, + headers=headers, + skip_auto_headers=skip_headers, + data=data, + cookies=all_cookies, + auth=auth, + version=version, + compress=compress, + chunked=chunked, + expect100=expect100, + loop=self._loop, + response_class=self._response_class, + proxy=proxy_, + proxy_auth=proxy_auth, + timer=timer, + session=self, + ssl=ssl if ssl is not None else True, + server_hostname=server_hostname, + proxy_headers=proxy_headers, + traces=traces, + trust_env=self.trust_env, + ) + + async def _connect_and_send_request( + req: ClientRequest, + ) -> ClientResponse: + # connection timeout + assert self._connector is not None + try: + conn = await self._connector.connect( + req, traces=traces, timeout=real_timeout + ) + except asyncio.TimeoutError as exc: + raise ConnectionTimeoutError( + f"Connection timeout to host {req.url}" + ) from exc + + assert conn.protocol is not None + conn.protocol.set_response_params( + timer=timer, + skip_payload=req.method in EMPTY_BODY_METHODS, + read_until_eof=read_until_eof, + auto_decompress=auto_decompress, + read_timeout=real_timeout.sock_read, + read_bufsize=read_bufsize, + timeout_ceil_threshold=self._connector._timeout_ceil_threshold, + max_line_size=max_line_size, + max_field_size=max_field_size, + ) + try: + resp = await req.send(conn) + try: + await resp.start(conn) + except BaseException: + resp.close() + raise + except BaseException: + conn.close() + raise + return resp + + # Apply middleware (if any) - per-request middleware overrides session middleware + effective_middlewares = ( + self._middlewares if middlewares is None else middlewares + ) + + if effective_middlewares: + handler = build_client_middlewares( + _connect_and_send_request, effective_middlewares + ) + else: + handler = _connect_and_send_request + + try: + resp = await handler(req) + # Client connector errors should not be retried + except ( + ConnectionTimeoutError, + ClientConnectorError, + ClientConnectorCertificateError, + ClientConnectorSSLError, + ): + raise + except (ClientOSError, ServerDisconnectedError): + if retry_persistent_connection: + retry_persistent_connection = False + continue + raise + except ClientError: + raise + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + raise ClientOSError(*exc.args) from exc + + # Update cookies from raw headers to preserve duplicates + if resp._raw_cookie_headers: + self._cookie_jar.update_cookies_from_headers( + resp._raw_cookie_headers, resp.url + ) + + # redirects + if resp.status in (301, 302, 303, 307, 308) and allow_redirects: + + for trace in traces: + await trace.send_request_redirect( + method, url.update_query(params), headers, resp + ) + + redirects += 1 + history.append(resp) + if max_redirects and redirects >= max_redirects: + if req._body is not None: + await req._body.close() + resp.close() + raise TooManyRedirects( + history[0].request_info, tuple(history) + ) + + # For 301 and 302, mimic IE, now changed in RFC + # https://github.com/kennethreitz/requests/pull/269 + if (resp.status == 303 and resp.method != hdrs.METH_HEAD) or ( + resp.status in (301, 302) and resp.method == hdrs.METH_POST + ): + method = hdrs.METH_GET + data = None + if headers.get(hdrs.CONTENT_LENGTH): + headers.pop(hdrs.CONTENT_LENGTH) + else: + # For 307/308, always preserve the request body + # For 301/302 with non-POST methods, preserve the request body + # https://www.rfc-editor.org/rfc/rfc9110#section-15.4.3-3.1 + # Use the existing payload to avoid recreating it from a potentially consumed file + data = req._body + + r_url = resp.headers.get(hdrs.LOCATION) or resp.headers.get( + hdrs.URI + ) + if r_url is None: + # see github.com/aio-libs/aiohttp/issues/2022 + break + else: + # reading from correct redirection + # response is forbidden + resp.release() + + try: + parsed_redirect_url = URL( + r_url, encoded=not self._requote_redirect_url + ) + except ValueError as e: + if req._body is not None: + await req._body.close() + resp.close() + raise InvalidUrlRedirectClientError( + r_url, + "Server attempted redirecting to a location that does not look like a URL", + ) from e + + scheme = parsed_redirect_url.scheme + if scheme not in HTTP_AND_EMPTY_SCHEMA_SET: + if req._body is not None: + await req._body.close() + resp.close() + raise NonHttpUrlRedirectClientError(r_url) + elif not scheme: + parsed_redirect_url = url.join(parsed_redirect_url) + + try: + redirect_origin = parsed_redirect_url.origin() + except ValueError as origin_val_err: + if req._body is not None: + await req._body.close() + resp.close() + raise InvalidUrlRedirectClientError( + parsed_redirect_url, + "Invalid redirect URL origin", + ) from origin_val_err + + if url.origin() != redirect_origin: + auth = None + headers.pop(hdrs.AUTHORIZATION, None) + + url = parsed_redirect_url + params = {} + resp.release() + continue + + break + + if req._body is not None: + await req._body.close() + # check response status + if raise_for_status is None: + raise_for_status = self._raise_for_status + + if raise_for_status is None: + pass + elif callable(raise_for_status): + await raise_for_status(resp) + elif raise_for_status: + resp.raise_for_status() + + # register connection + if handle is not None: + if resp.connection is not None: + resp.connection.add_callback(handle.cancel) + else: + handle.cancel() + + resp._history = tuple(history) + + for trace in traces: + await trace.send_request_end( + method, url.update_query(params), headers, resp + ) + return resp + + except BaseException as e: + # cleanup timer + tm.close() + if handle: + handle.cancel() + handle = None + + for trace in traces: + await trace.send_request_exception( + method, url.update_query(params), headers, e + ) + raise + + def ws_connect( + self, + url: StrOrURL, + *, + method: str = hdrs.METH_GET, + protocols: Iterable[str] = (), + timeout: Union[ClientWSTimeout, _SENTINEL] = sentinel, + receive_timeout: Optional[float] = None, + autoclose: bool = True, + autoping: bool = True, + heartbeat: Optional[float] = None, + auth: Optional[BasicAuth] = None, + origin: Optional[str] = None, + params: Query = None, + headers: Optional[LooseHeaders] = None, + proxy: Optional[StrOrURL] = None, + proxy_auth: Optional[BasicAuth] = None, + ssl: Union[SSLContext, bool, Fingerprint] = True, + verify_ssl: Optional[bool] = None, + fingerprint: Optional[bytes] = None, + ssl_context: Optional[SSLContext] = None, + server_hostname: Optional[str] = None, + proxy_headers: Optional[LooseHeaders] = None, + compress: int = 0, + max_msg_size: int = 4 * 1024 * 1024, + ) -> "_WSRequestContextManager": + """Initiate websocket connection.""" + return _WSRequestContextManager( + self._ws_connect( + url, + method=method, + protocols=protocols, + timeout=timeout, + receive_timeout=receive_timeout, + autoclose=autoclose, + autoping=autoping, + heartbeat=heartbeat, + auth=auth, + origin=origin, + params=params, + headers=headers, + proxy=proxy, + proxy_auth=proxy_auth, + ssl=ssl, + verify_ssl=verify_ssl, + fingerprint=fingerprint, + ssl_context=ssl_context, + server_hostname=server_hostname, + proxy_headers=proxy_headers, + compress=compress, + max_msg_size=max_msg_size, + ) + ) + + async def _ws_connect( + self, + url: StrOrURL, + *, + method: str = hdrs.METH_GET, + protocols: Iterable[str] = (), + timeout: Union[ClientWSTimeout, _SENTINEL] = sentinel, + receive_timeout: Optional[float] = None, + autoclose: bool = True, + autoping: bool = True, + heartbeat: Optional[float] = None, + auth: Optional[BasicAuth] = None, + origin: Optional[str] = None, + params: Query = None, + headers: Optional[LooseHeaders] = None, + proxy: Optional[StrOrURL] = None, + proxy_auth: Optional[BasicAuth] = None, + ssl: Union[SSLContext, bool, Fingerprint] = True, + verify_ssl: Optional[bool] = None, + fingerprint: Optional[bytes] = None, + ssl_context: Optional[SSLContext] = None, + server_hostname: Optional[str] = None, + proxy_headers: Optional[LooseHeaders] = None, + compress: int = 0, + max_msg_size: int = 4 * 1024 * 1024, + ) -> ClientWebSocketResponse: + if timeout is not sentinel: + if isinstance(timeout, ClientWSTimeout): + ws_timeout = timeout + else: + warnings.warn( + "parameter 'timeout' of type 'float' " + "is deprecated, please use " + "'timeout=ClientWSTimeout(ws_close=...)'", + DeprecationWarning, + stacklevel=2, + ) + ws_timeout = ClientWSTimeout(ws_close=timeout) + else: + ws_timeout = DEFAULT_WS_CLIENT_TIMEOUT + if receive_timeout is not None: + warnings.warn( + "float parameter 'receive_timeout' " + "is deprecated, please use parameter " + "'timeout=ClientWSTimeout(ws_receive=...)'", + DeprecationWarning, + stacklevel=2, + ) + ws_timeout = attr.evolve(ws_timeout, ws_receive=receive_timeout) + + if headers is None: + real_headers: CIMultiDict[str] = CIMultiDict() + else: + real_headers = CIMultiDict(headers) + + default_headers = { + hdrs.UPGRADE: "websocket", + hdrs.CONNECTION: "Upgrade", + hdrs.SEC_WEBSOCKET_VERSION: "13", + } + + for key, value in default_headers.items(): + real_headers.setdefault(key, value) + + sec_key = base64.b64encode(os.urandom(16)) + real_headers[hdrs.SEC_WEBSOCKET_KEY] = sec_key.decode() + + if protocols: + real_headers[hdrs.SEC_WEBSOCKET_PROTOCOL] = ",".join(protocols) + if origin is not None: + real_headers[hdrs.ORIGIN] = origin + if compress: + extstr = ws_ext_gen(compress=compress) + real_headers[hdrs.SEC_WEBSOCKET_EXTENSIONS] = extstr + + # For the sake of backward compatibility, if user passes in None, convert it to True + if ssl is None: + warnings.warn( + "ssl=None is deprecated, please use ssl=True", + DeprecationWarning, + stacklevel=2, + ) + ssl = True + ssl = _merge_ssl_params(ssl, verify_ssl, ssl_context, fingerprint) + + # send request + resp = await self.request( + method, + url, + params=params, + headers=real_headers, + read_until_eof=False, + auth=auth, + proxy=proxy, + proxy_auth=proxy_auth, + ssl=ssl, + server_hostname=server_hostname, + proxy_headers=proxy_headers, + ) + + try: + # check handshake + if resp.status != 101: + raise WSServerHandshakeError( + resp.request_info, + resp.history, + message="Invalid response status", + status=resp.status, + headers=resp.headers, + ) + + if resp.headers.get(hdrs.UPGRADE, "").lower() != "websocket": + raise WSServerHandshakeError( + resp.request_info, + resp.history, + message="Invalid upgrade header", + status=resp.status, + headers=resp.headers, + ) + + if resp.headers.get(hdrs.CONNECTION, "").lower() != "upgrade": + raise WSServerHandshakeError( + resp.request_info, + resp.history, + message="Invalid connection header", + status=resp.status, + headers=resp.headers, + ) + + # key calculation + r_key = resp.headers.get(hdrs.SEC_WEBSOCKET_ACCEPT, "") + match = base64.b64encode(hashlib.sha1(sec_key + WS_KEY).digest()).decode() + if r_key != match: + raise WSServerHandshakeError( + resp.request_info, + resp.history, + message="Invalid challenge response", + status=resp.status, + headers=resp.headers, + ) + + # websocket protocol + protocol = None + if protocols and hdrs.SEC_WEBSOCKET_PROTOCOL in resp.headers: + resp_protocols = [ + proto.strip() + for proto in resp.headers[hdrs.SEC_WEBSOCKET_PROTOCOL].split(",") + ] + + for proto in resp_protocols: + if proto in protocols: + protocol = proto + break + + # websocket compress + notakeover = False + if compress: + compress_hdrs = resp.headers.get(hdrs.SEC_WEBSOCKET_EXTENSIONS) + if compress_hdrs: + try: + compress, notakeover = ws_ext_parse(compress_hdrs) + except WSHandshakeError as exc: + raise WSServerHandshakeError( + resp.request_info, + resp.history, + message=exc.args[0], + status=resp.status, + headers=resp.headers, + ) from exc + else: + compress = 0 + notakeover = False + + conn = resp.connection + assert conn is not None + conn_proto = conn.protocol + assert conn_proto is not None + + # For WS connection the read_timeout must be either receive_timeout or greater + # None == no timeout, i.e. infinite timeout, so None is the max timeout possible + if ws_timeout.ws_receive is None: + # Reset regardless + conn_proto.read_timeout = None + elif conn_proto.read_timeout is not None: + conn_proto.read_timeout = max( + ws_timeout.ws_receive, conn_proto.read_timeout + ) + + transport = conn.transport + assert transport is not None + reader = WebSocketDataQueue(conn_proto, 2**16, loop=self._loop) + conn_proto.set_parser(WebSocketReader(reader, max_msg_size), reader) + writer = WebSocketWriter( + conn_proto, + transport, + use_mask=True, + compress=compress, + notakeover=notakeover, + ) + except BaseException: + resp.close() + raise + else: + return self._ws_response_class( + reader, + writer, + protocol, + resp, + ws_timeout, + autoclose, + autoping, + self._loop, + heartbeat=heartbeat, + compress=compress, + client_notakeover=notakeover, + ) + + def _prepare_headers(self, headers: Optional[LooseHeaders]) -> "CIMultiDict[str]": + """Add default headers and transform it to CIMultiDict""" + # Convert headers to MultiDict + result = CIMultiDict(self._default_headers) + if headers: + if not isinstance(headers, (MultiDictProxy, MultiDict)): + headers = CIMultiDict(headers) + added_names: Set[str] = set() + for key, value in headers.items(): + if key in added_names: + result.add(key, value) + else: + result[key] = value + added_names.add(key) + return result + + def _get_netrc_auth(self, host: str) -> Optional[BasicAuth]: + """ + Get auth from netrc for the given host. + + This method is designed to be called in an executor to avoid + blocking I/O in the event loop. + """ + netrc_obj = netrc_from_env() + try: + return basicauth_from_netrc(netrc_obj, host) + except LookupError: + return None + + if sys.version_info >= (3, 11) and TYPE_CHECKING: + + def get( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + def options( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + def head( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + def post( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + def put( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + def patch( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + def delete( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + else: + + def get( + self, url: StrOrURL, *, allow_redirects: bool = True, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP GET request.""" + return _RequestContextManager( + self._request( + hdrs.METH_GET, url, allow_redirects=allow_redirects, **kwargs + ) + ) + + def options( + self, url: StrOrURL, *, allow_redirects: bool = True, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP OPTIONS request.""" + return _RequestContextManager( + self._request( + hdrs.METH_OPTIONS, url, allow_redirects=allow_redirects, **kwargs + ) + ) + + def head( + self, url: StrOrURL, *, allow_redirects: bool = False, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP HEAD request.""" + return _RequestContextManager( + self._request( + hdrs.METH_HEAD, url, allow_redirects=allow_redirects, **kwargs + ) + ) + + def post( + self, url: StrOrURL, *, data: Any = None, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP POST request.""" + return _RequestContextManager( + self._request(hdrs.METH_POST, url, data=data, **kwargs) + ) + + def put( + self, url: StrOrURL, *, data: Any = None, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP PUT request.""" + return _RequestContextManager( + self._request(hdrs.METH_PUT, url, data=data, **kwargs) + ) + + def patch( + self, url: StrOrURL, *, data: Any = None, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP PATCH request.""" + return _RequestContextManager( + self._request(hdrs.METH_PATCH, url, data=data, **kwargs) + ) + + def delete(self, url: StrOrURL, **kwargs: Any) -> "_RequestContextManager": + """Perform HTTP DELETE request.""" + return _RequestContextManager( + self._request(hdrs.METH_DELETE, url, **kwargs) + ) + + async def close(self) -> None: + """Close underlying connector. + + Release all acquired resources. + """ + if not self.closed: + if self._connector is not None and self._connector_owner: + await self._connector.close() + self._connector = None + + @property + def closed(self) -> bool: + """Is client session closed. + + A readonly property. + """ + return self._connector is None or self._connector.closed + + @property + def connector(self) -> Optional[BaseConnector]: + """Connector instance used for the session.""" + return self._connector + + @property + def cookie_jar(self) -> AbstractCookieJar: + """The session cookies.""" + return self._cookie_jar + + @property + def version(self) -> Tuple[int, int]: + """The session HTTP protocol version.""" + return self._version + + @property + def requote_redirect_url(self) -> bool: + """Do URL requoting on redirection handling.""" + return self._requote_redirect_url + + @requote_redirect_url.setter + def requote_redirect_url(self, val: bool) -> None: + """Do URL requoting on redirection handling.""" + warnings.warn( + "session.requote_redirect_url modification is deprecated #2778", + DeprecationWarning, + stacklevel=2, + ) + self._requote_redirect_url = val + + @property + def loop(self) -> asyncio.AbstractEventLoop: + """Session's loop.""" + warnings.warn( + "client.loop property is deprecated", DeprecationWarning, stacklevel=2 + ) + return self._loop + + @property + def timeout(self) -> ClientTimeout: + """Timeout for the session.""" + return self._timeout + + @property + def headers(self) -> "CIMultiDict[str]": + """The default headers of the client session.""" + return self._default_headers + + @property + def skip_auto_headers(self) -> FrozenSet[istr]: + """Headers for which autogeneration should be skipped""" + return self._skip_auto_headers + + @property + def auth(self) -> Optional[BasicAuth]: + """An object that represents HTTP Basic Authorization""" + return self._default_auth + + @property + def json_serialize(self) -> JSONEncoder: + """Json serializer callable""" + return self._json_serialize + + @property + def connector_owner(self) -> bool: + """Should connector be closed on session closing""" + return self._connector_owner + + @property + def raise_for_status( + self, + ) -> Union[bool, Callable[[ClientResponse], Awaitable[None]]]: + """Should `ClientResponse.raise_for_status()` be called for each response.""" + return self._raise_for_status + + @property + def auto_decompress(self) -> bool: + """Should the body response be automatically decompressed.""" + return self._auto_decompress + + @property + def trust_env(self) -> bool: + """ + Should proxies information from environment or netrc be trusted. + + Information is from HTTP_PROXY / HTTPS_PROXY environment variables + or ~/.netrc file if present. + """ + return self._trust_env + + @property + def trace_configs(self) -> List[TraceConfig]: + """A list of TraceConfig instances used for client tracing""" + return self._trace_configs + + def detach(self) -> None: + """Detach connector from session without closing the former. + + Session is switched to closed state anyway. + """ + self._connector = None + + def __enter__(self) -> None: + raise TypeError("Use async with instead") + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + # __exit__ should exist in pair with __enter__ but never executed + pass # pragma: no cover + + async def __aenter__(self) -> "ClientSession": + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + await self.close() + + +class _BaseRequestContextManager(Coroutine[Any, Any, _RetType], Generic[_RetType]): + + __slots__ = ("_coro", "_resp") + + def __init__(self, coro: Coroutine["asyncio.Future[Any]", None, _RetType]) -> None: + self._coro: Coroutine["asyncio.Future[Any]", None, _RetType] = coro + + def send(self, arg: None) -> "asyncio.Future[Any]": + return self._coro.send(arg) + + def throw(self, *args: Any, **kwargs: Any) -> "asyncio.Future[Any]": + return self._coro.throw(*args, **kwargs) + + def close(self) -> None: + return self._coro.close() + + def __await__(self) -> Generator[Any, None, _RetType]: + ret = self._coro.__await__() + return ret + + def __iter__(self) -> Generator[Any, None, _RetType]: + return self.__await__() + + async def __aenter__(self) -> _RetType: + self._resp: _RetType = await self._coro + return await self._resp.__aenter__() + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc: Optional[BaseException], + tb: Optional[TracebackType], + ) -> None: + await self._resp.__aexit__(exc_type, exc, tb) + + +_RequestContextManager = _BaseRequestContextManager[ClientResponse] +_WSRequestContextManager = _BaseRequestContextManager[ClientWebSocketResponse] + + +class _SessionRequestContextManager: + + __slots__ = ("_coro", "_resp", "_session") + + def __init__( + self, + coro: Coroutine["asyncio.Future[Any]", None, ClientResponse], + session: ClientSession, + ) -> None: + self._coro = coro + self._resp: Optional[ClientResponse] = None + self._session = session + + async def __aenter__(self) -> ClientResponse: + try: + self._resp = await self._coro + except BaseException: + await self._session.close() + raise + else: + return self._resp + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc: Optional[BaseException], + tb: Optional[TracebackType], + ) -> None: + assert self._resp is not None + self._resp.close() + await self._session.close() + + +if sys.version_info >= (3, 11) and TYPE_CHECKING: + + def request( + method: str, + url: StrOrURL, + *, + version: HttpVersion = http.HttpVersion11, + connector: Optional[BaseConnector] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + **kwargs: Unpack[_RequestOptions], + ) -> _SessionRequestContextManager: ... + +else: + + def request( + method: str, + url: StrOrURL, + *, + version: HttpVersion = http.HttpVersion11, + connector: Optional[BaseConnector] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + **kwargs: Any, + ) -> _SessionRequestContextManager: + """Constructs and sends a request. + + Returns response object. + method - HTTP method + url - request url + params - (optional) Dictionary or bytes to be sent in the query + string of the new request + data - (optional) Dictionary, bytes, or file-like object to + send in the body of the request + json - (optional) Any json compatible python object + headers - (optional) Dictionary of HTTP Headers to send with + the request + cookies - (optional) Dict object to send with the request + auth - (optional) BasicAuth named tuple represent HTTP Basic Auth + auth - aiohttp.helpers.BasicAuth + allow_redirects - (optional) If set to False, do not follow + redirects + version - Request HTTP version. + compress - Set to True if request has to be compressed + with deflate encoding. + chunked - Set to chunk size for chunked transfer encoding. + expect100 - Expect 100-continue response from server. + connector - BaseConnector sub-class instance to support + connection pooling. + read_until_eof - Read response until eof if response + does not have Content-Length header. + loop - Optional event loop. + timeout - Optional ClientTimeout settings structure, 5min + total timeout by default. + Usage:: + >>> import aiohttp + >>> async with aiohttp.request('GET', 'http://python.org/') as resp: + ... print(resp) + ... data = await resp.read() + + """ + connector_owner = False + if connector is None: + connector_owner = True + connector = TCPConnector(loop=loop, force_close=True) + + session = ClientSession( + loop=loop, + cookies=kwargs.pop("cookies", None), + version=version, + timeout=kwargs.pop("timeout", sentinel), + connector=connector, + connector_owner=connector_owner, + ) + + return _SessionRequestContextManager( + session._request(method, url, **kwargs), + session, + ) diff --git a/env/lib/python3.12/site-packages/aiohttp/client_exceptions.py b/env/lib/python3.12/site-packages/aiohttp/client_exceptions.py new file mode 100644 index 0000000..1d298e9 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/client_exceptions.py @@ -0,0 +1,421 @@ +"""HTTP related errors.""" + +import asyncio +import warnings +from typing import TYPE_CHECKING, Optional, Tuple, Union + +from multidict import MultiMapping + +from .typedefs import StrOrURL + +if TYPE_CHECKING: + import ssl + + SSLContext = ssl.SSLContext +else: + try: + import ssl + + SSLContext = ssl.SSLContext + except ImportError: # pragma: no cover + ssl = SSLContext = None # type: ignore[assignment] + +if TYPE_CHECKING: + from .client_reqrep import ClientResponse, ConnectionKey, Fingerprint, RequestInfo + from .http_parser import RawResponseMessage +else: + RequestInfo = ClientResponse = ConnectionKey = RawResponseMessage = None + +__all__ = ( + "ClientError", + "ClientConnectionError", + "ClientConnectionResetError", + "ClientOSError", + "ClientConnectorError", + "ClientProxyConnectionError", + "ClientSSLError", + "ClientConnectorDNSError", + "ClientConnectorSSLError", + "ClientConnectorCertificateError", + "ConnectionTimeoutError", + "SocketTimeoutError", + "ServerConnectionError", + "ServerTimeoutError", + "ServerDisconnectedError", + "ServerFingerprintMismatch", + "ClientResponseError", + "ClientHttpProxyError", + "WSServerHandshakeError", + "ContentTypeError", + "ClientPayloadError", + "InvalidURL", + "InvalidUrlClientError", + "RedirectClientError", + "NonHttpUrlClientError", + "InvalidUrlRedirectClientError", + "NonHttpUrlRedirectClientError", + "WSMessageTypeError", +) + + +class ClientError(Exception): + """Base class for client connection errors.""" + + +class ClientResponseError(ClientError): + """Base class for exceptions that occur after getting a response. + + request_info: An instance of RequestInfo. + history: A sequence of responses, if redirects occurred. + status: HTTP status code. + message: Error message. + headers: Response headers. + """ + + def __init__( + self, + request_info: RequestInfo, + history: Tuple[ClientResponse, ...], + *, + code: Optional[int] = None, + status: Optional[int] = None, + message: str = "", + headers: Optional[MultiMapping[str]] = None, + ) -> None: + self.request_info = request_info + if code is not None: + if status is not None: + raise ValueError( + "Both code and status arguments are provided; " + "code is deprecated, use status instead" + ) + warnings.warn( + "code argument is deprecated, use status instead", + DeprecationWarning, + stacklevel=2, + ) + if status is not None: + self.status = status + elif code is not None: + self.status = code + else: + self.status = 0 + self.message = message + self.headers = headers + self.history = history + self.args = (request_info, history) + + def __str__(self) -> str: + return "{}, message={!r}, url={!r}".format( + self.status, + self.message, + str(self.request_info.real_url), + ) + + def __repr__(self) -> str: + args = f"{self.request_info!r}, {self.history!r}" + if self.status != 0: + args += f", status={self.status!r}" + if self.message != "": + args += f", message={self.message!r}" + if self.headers is not None: + args += f", headers={self.headers!r}" + return f"{type(self).__name__}({args})" + + @property + def code(self) -> int: + warnings.warn( + "code property is deprecated, use status instead", + DeprecationWarning, + stacklevel=2, + ) + return self.status + + @code.setter + def code(self, value: int) -> None: + warnings.warn( + "code property is deprecated, use status instead", + DeprecationWarning, + stacklevel=2, + ) + self.status = value + + +class ContentTypeError(ClientResponseError): + """ContentType found is not valid.""" + + +class WSServerHandshakeError(ClientResponseError): + """websocket server handshake error.""" + + +class ClientHttpProxyError(ClientResponseError): + """HTTP proxy error. + + Raised in :class:`aiohttp.connector.TCPConnector` if + proxy responds with status other than ``200 OK`` + on ``CONNECT`` request. + """ + + +class TooManyRedirects(ClientResponseError): + """Client was redirected too many times.""" + + +class ClientConnectionError(ClientError): + """Base class for client socket errors.""" + + +class ClientConnectionResetError(ClientConnectionError, ConnectionResetError): + """ConnectionResetError""" + + +class ClientOSError(ClientConnectionError, OSError): + """OSError error.""" + + +class ClientConnectorError(ClientOSError): + """Client connector error. + + Raised in :class:`aiohttp.connector.TCPConnector` if + a connection can not be established. + """ + + def __init__(self, connection_key: ConnectionKey, os_error: OSError) -> None: + self._conn_key = connection_key + self._os_error = os_error + super().__init__(os_error.errno, os_error.strerror) + self.args = (connection_key, os_error) + + @property + def os_error(self) -> OSError: + return self._os_error + + @property + def host(self) -> str: + return self._conn_key.host + + @property + def port(self) -> Optional[int]: + return self._conn_key.port + + @property + def ssl(self) -> Union[SSLContext, bool, "Fingerprint"]: + return self._conn_key.ssl + + def __str__(self) -> str: + return "Cannot connect to host {0.host}:{0.port} ssl:{1} [{2}]".format( + self, "default" if self.ssl is True else self.ssl, self.strerror + ) + + # OSError.__reduce__ does too much black magick + __reduce__ = BaseException.__reduce__ + + +class ClientConnectorDNSError(ClientConnectorError): + """DNS resolution failed during client connection. + + Raised in :class:`aiohttp.connector.TCPConnector` if + DNS resolution fails. + """ + + +class ClientProxyConnectionError(ClientConnectorError): + """Proxy connection error. + + Raised in :class:`aiohttp.connector.TCPConnector` if + connection to proxy can not be established. + """ + + +class UnixClientConnectorError(ClientConnectorError): + """Unix connector error. + + Raised in :py:class:`aiohttp.connector.UnixConnector` + if connection to unix socket can not be established. + """ + + def __init__( + self, path: str, connection_key: ConnectionKey, os_error: OSError + ) -> None: + self._path = path + super().__init__(connection_key, os_error) + + @property + def path(self) -> str: + return self._path + + def __str__(self) -> str: + return "Cannot connect to unix socket {0.path} ssl:{1} [{2}]".format( + self, "default" if self.ssl is True else self.ssl, self.strerror + ) + + +class ServerConnectionError(ClientConnectionError): + """Server connection errors.""" + + +class ServerDisconnectedError(ServerConnectionError): + """Server disconnected.""" + + def __init__(self, message: Union[RawResponseMessage, str, None] = None) -> None: + if message is None: + message = "Server disconnected" + + self.args = (message,) + self.message = message + + +class ServerTimeoutError(ServerConnectionError, asyncio.TimeoutError): + """Server timeout error.""" + + +class ConnectionTimeoutError(ServerTimeoutError): + """Connection timeout error.""" + + +class SocketTimeoutError(ServerTimeoutError): + """Socket timeout error.""" + + +class ServerFingerprintMismatch(ServerConnectionError): + """SSL certificate does not match expected fingerprint.""" + + def __init__(self, expected: bytes, got: bytes, host: str, port: int) -> None: + self.expected = expected + self.got = got + self.host = host + self.port = port + self.args = (expected, got, host, port) + + def __repr__(self) -> str: + return "<{} expected={!r} got={!r} host={!r} port={!r}>".format( + self.__class__.__name__, self.expected, self.got, self.host, self.port + ) + + +class ClientPayloadError(ClientError): + """Response payload error.""" + + +class InvalidURL(ClientError, ValueError): + """Invalid URL. + + URL used for fetching is malformed, e.g. it doesn't contains host + part. + """ + + # Derive from ValueError for backward compatibility + + def __init__(self, url: StrOrURL, description: Union[str, None] = None) -> None: + # The type of url is not yarl.URL because the exception can be raised + # on URL(url) call + self._url = url + self._description = description + + if description: + super().__init__(url, description) + else: + super().__init__(url) + + @property + def url(self) -> StrOrURL: + return self._url + + @property + def description(self) -> "str | None": + return self._description + + def __repr__(self) -> str: + return f"<{self.__class__.__name__} {self}>" + + def __str__(self) -> str: + if self._description: + return f"{self._url} - {self._description}" + return str(self._url) + + +class InvalidUrlClientError(InvalidURL): + """Invalid URL client error.""" + + +class RedirectClientError(ClientError): + """Client redirect error.""" + + +class NonHttpUrlClientError(ClientError): + """Non http URL client error.""" + + +class InvalidUrlRedirectClientError(InvalidUrlClientError, RedirectClientError): + """Invalid URL redirect client error.""" + + +class NonHttpUrlRedirectClientError(NonHttpUrlClientError, RedirectClientError): + """Non http URL redirect client error.""" + + +class ClientSSLError(ClientConnectorError): + """Base error for ssl.*Errors.""" + + +if ssl is not None: + cert_errors = (ssl.CertificateError,) + cert_errors_bases = ( + ClientSSLError, + ssl.CertificateError, + ) + + ssl_errors = (ssl.SSLError,) + ssl_error_bases = (ClientSSLError, ssl.SSLError) +else: # pragma: no cover + cert_errors = tuple() + cert_errors_bases = ( + ClientSSLError, + ValueError, + ) + + ssl_errors = tuple() + ssl_error_bases = (ClientSSLError,) + + +class ClientConnectorSSLError(*ssl_error_bases): # type: ignore[misc] + """Response ssl error.""" + + +class ClientConnectorCertificateError(*cert_errors_bases): # type: ignore[misc] + """Response certificate error.""" + + def __init__( + self, connection_key: ConnectionKey, certificate_error: Exception + ) -> None: + self._conn_key = connection_key + self._certificate_error = certificate_error + self.args = (connection_key, certificate_error) + + @property + def certificate_error(self) -> Exception: + return self._certificate_error + + @property + def host(self) -> str: + return self._conn_key.host + + @property + def port(self) -> Optional[int]: + return self._conn_key.port + + @property + def ssl(self) -> bool: + return self._conn_key.is_ssl + + def __str__(self) -> str: + return ( + "Cannot connect to host {0.host}:{0.port} ssl:{0.ssl} " + "[{0.certificate_error.__class__.__name__}: " + "{0.certificate_error.args}]".format(self) + ) + + +class WSMessageTypeError(TypeError): + """WebSocket message type is not valid.""" diff --git a/env/lib/python3.12/site-packages/aiohttp/client_middleware_digest_auth.py b/env/lib/python3.12/site-packages/aiohttp/client_middleware_digest_auth.py new file mode 100644 index 0000000..5aab5ac --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/client_middleware_digest_auth.py @@ -0,0 +1,480 @@ +""" +Digest authentication middleware for aiohttp client. + +This middleware implements HTTP Digest Authentication according to RFC 7616, +providing a more secure alternative to Basic Authentication. It supports all +standard hash algorithms including MD5, SHA, SHA-256, SHA-512 and their session +variants, as well as both 'auth' and 'auth-int' quality of protection (qop) options. +""" + +import hashlib +import os +import re +import sys +import time +from typing import ( + Callable, + Dict, + Final, + FrozenSet, + List, + Literal, + Tuple, + TypedDict, + Union, +) + +from yarl import URL + +from . import hdrs +from .client_exceptions import ClientError +from .client_middlewares import ClientHandlerType +from .client_reqrep import ClientRequest, ClientResponse +from .payload import Payload + + +class DigestAuthChallenge(TypedDict, total=False): + realm: str + nonce: str + qop: str + algorithm: str + opaque: str + domain: str + stale: str + + +DigestFunctions: Dict[str, Callable[[bytes], "hashlib._Hash"]] = { + "MD5": hashlib.md5, + "MD5-SESS": hashlib.md5, + "SHA": hashlib.sha1, + "SHA-SESS": hashlib.sha1, + "SHA256": hashlib.sha256, + "SHA256-SESS": hashlib.sha256, + "SHA-256": hashlib.sha256, + "SHA-256-SESS": hashlib.sha256, + "SHA512": hashlib.sha512, + "SHA512-SESS": hashlib.sha512, + "SHA-512": hashlib.sha512, + "SHA-512-SESS": hashlib.sha512, +} + + +# Compile the regex pattern once at module level for performance +_HEADER_PAIRS_PATTERN = re.compile( + r'(?:^|\s|,\s*)(\w+)\s*=\s*(?:"((?:[^"\\]|\\.)*)"|([^\s,]+))' + if sys.version_info < (3, 11) + else r'(?:^|\s|,\s*)((?>\w+))\s*=\s*(?:"((?:[^"\\]|\\.)*)"|([^\s,]+))' + # +------------|--------|--|-|-|--|----|------|----|--||-----|-> Match valid start/sep + # +--------|--|-|-|--|----|------|----|--||-----|-> alphanumeric key (atomic + # | | | | | | | | || | group reduces backtracking) + # +--|-|-|--|----|------|----|--||-----|-> maybe whitespace + # | | | | | | | || | + # +-|-|--|----|------|----|--||-----|-> = (delimiter) + # +-|--|----|------|----|--||-----|-> maybe whitespace + # | | | | | || | + # +--|----|------|----|--||-----|-> group quoted or unquoted + # | | | | || | + # +----|------|----|--||-----|-> if quoted... + # +------|----|--||-----|-> anything but " or \ + # +----|--||-----|-> escaped characters allowed + # +--||-----|-> or can be empty string + # || | + # +|-----|-> if unquoted... + # +-----|-> anything but , or + # +-> at least one char req'd +) + + +# RFC 7616: Challenge parameters to extract +CHALLENGE_FIELDS: Final[ + Tuple[ + Literal["realm", "nonce", "qop", "algorithm", "opaque", "domain", "stale"], ... + ] +] = ( + "realm", + "nonce", + "qop", + "algorithm", + "opaque", + "domain", + "stale", +) + +# Supported digest authentication algorithms +# Use a tuple of sorted keys for predictable documentation and error messages +SUPPORTED_ALGORITHMS: Final[Tuple[str, ...]] = tuple(sorted(DigestFunctions.keys())) + +# RFC 7616: Fields that require quoting in the Digest auth header +# These fields must be enclosed in double quotes in the Authorization header. +# Algorithm, qop, and nc are never quoted per RFC specifications. +# This frozen set is used by the template-based header construction to +# automatically determine which fields need quotes. +QUOTED_AUTH_FIELDS: Final[FrozenSet[str]] = frozenset( + {"username", "realm", "nonce", "uri", "response", "opaque", "cnonce"} +) + + +def escape_quotes(value: str) -> str: + """Escape double quotes for HTTP header values.""" + return value.replace('"', '\\"') + + +def unescape_quotes(value: str) -> str: + """Unescape double quotes in HTTP header values.""" + return value.replace('\\"', '"') + + +def parse_header_pairs(header: str) -> Dict[str, str]: + """ + Parse key-value pairs from WWW-Authenticate or similar HTTP headers. + + This function handles the complex format of WWW-Authenticate header values, + supporting both quoted and unquoted values, proper handling of commas in + quoted values, and whitespace variations per RFC 7616. + + Examples of supported formats: + - key1="value1", key2=value2 + - key1 = "value1" , key2="value, with, commas" + - key1=value1,key2="value2" + - realm="example.com", nonce="12345", qop="auth" + + Args: + header: The header value string to parse + + Returns: + Dictionary mapping parameter names to their values + """ + return { + stripped_key: unescape_quotes(quoted_val) if quoted_val else unquoted_val + for key, quoted_val, unquoted_val in _HEADER_PAIRS_PATTERN.findall(header) + if (stripped_key := key.strip()) + } + + +class DigestAuthMiddleware: + """ + HTTP digest authentication middleware for aiohttp client. + + This middleware intercepts 401 Unauthorized responses containing a Digest + authentication challenge, calculates the appropriate digest credentials, + and automatically retries the request with the proper Authorization header. + + Features: + - Handles all aspects of Digest authentication handshake automatically + - Supports all standard hash algorithms: + - MD5, MD5-SESS + - SHA, SHA-SESS + - SHA256, SHA256-SESS, SHA-256, SHA-256-SESS + - SHA512, SHA512-SESS, SHA-512, SHA-512-SESS + - Supports 'auth' and 'auth-int' quality of protection modes + - Properly handles quoted strings and parameter parsing + - Includes replay attack protection with client nonce count tracking + - Supports preemptive authentication per RFC 7616 Section 3.6 + + Standards compliance: + - RFC 7616: HTTP Digest Access Authentication (primary reference) + - RFC 2617: HTTP Authentication (deprecated by RFC 7616) + - RFC 1945: Section 11.1 (username restrictions) + + Implementation notes: + The core digest calculation is inspired by the implementation in + https://github.com/requests/requests/blob/v2.18.4/requests/auth.py + with added support for modern digest auth features and error handling. + """ + + def __init__( + self, + login: str, + password: str, + preemptive: bool = True, + ) -> None: + if login is None: + raise ValueError("None is not allowed as login value") + + if password is None: + raise ValueError("None is not allowed as password value") + + if ":" in login: + raise ValueError('A ":" is not allowed in username (RFC 1945#section-11.1)') + + self._login_str: Final[str] = login + self._login_bytes: Final[bytes] = login.encode("utf-8") + self._password_bytes: Final[bytes] = password.encode("utf-8") + + self._last_nonce_bytes = b"" + self._nonce_count = 0 + self._challenge: DigestAuthChallenge = {} + self._preemptive: bool = preemptive + # Set of URLs defining the protection space + self._protection_space: List[str] = [] + + async def _encode( + self, method: str, url: URL, body: Union[Payload, Literal[b""]] + ) -> str: + """ + Build digest authorization header for the current challenge. + + Args: + method: The HTTP method (GET, POST, etc.) + url: The request URL + body: The request body (used for qop=auth-int) + + Returns: + A fully formatted Digest authorization header string + + Raises: + ClientError: If the challenge is missing required parameters or + contains unsupported values + + """ + challenge = self._challenge + if "realm" not in challenge: + raise ClientError( + "Malformed Digest auth challenge: Missing 'realm' parameter" + ) + + if "nonce" not in challenge: + raise ClientError( + "Malformed Digest auth challenge: Missing 'nonce' parameter" + ) + + # Empty realm values are allowed per RFC 7616 (SHOULD, not MUST, contain host name) + realm = challenge["realm"] + nonce = challenge["nonce"] + + # Empty nonce values are not allowed as they are security-critical for replay protection + if not nonce: + raise ClientError( + "Security issue: Digest auth challenge contains empty 'nonce' value" + ) + + qop_raw = challenge.get("qop", "") + # Preserve original algorithm case for response while using uppercase for processing + algorithm_original = challenge.get("algorithm", "MD5") + algorithm = algorithm_original.upper() + opaque = challenge.get("opaque", "") + + # Convert string values to bytes once + nonce_bytes = nonce.encode("utf-8") + realm_bytes = realm.encode("utf-8") + path = URL(url).path_qs + + # Process QoP + qop = "" + qop_bytes = b"" + if qop_raw: + valid_qops = {"auth", "auth-int"}.intersection( + {q.strip() for q in qop_raw.split(",") if q.strip()} + ) + if not valid_qops: + raise ClientError( + f"Digest auth error: Unsupported Quality of Protection (qop) value(s): {qop_raw}" + ) + + qop = "auth-int" if "auth-int" in valid_qops else "auth" + qop_bytes = qop.encode("utf-8") + + if algorithm not in DigestFunctions: + raise ClientError( + f"Digest auth error: Unsupported hash algorithm: {algorithm}. " + f"Supported algorithms: {', '.join(SUPPORTED_ALGORITHMS)}" + ) + hash_fn: Final = DigestFunctions[algorithm] + + def H(x: bytes) -> bytes: + """RFC 7616 Section 3: Hash function H(data) = hex(hash(data)).""" + return hash_fn(x).hexdigest().encode() + + def KD(s: bytes, d: bytes) -> bytes: + """RFC 7616 Section 3: KD(secret, data) = H(concat(secret, ":", data)).""" + return H(b":".join((s, d))) + + # Calculate A1 and A2 + A1 = b":".join((self._login_bytes, realm_bytes, self._password_bytes)) + A2 = f"{method.upper()}:{path}".encode() + if qop == "auth-int": + if isinstance(body, Payload): # will always be empty bytes unless Payload + entity_bytes = await body.as_bytes() # Get bytes from Payload + else: + entity_bytes = body + entity_hash = H(entity_bytes) + A2 = b":".join((A2, entity_hash)) + + HA1 = H(A1) + HA2 = H(A2) + + # Nonce count handling + if nonce_bytes == self._last_nonce_bytes: + self._nonce_count += 1 + else: + self._nonce_count = 1 + + self._last_nonce_bytes = nonce_bytes + ncvalue = f"{self._nonce_count:08x}" + ncvalue_bytes = ncvalue.encode("utf-8") + + # Generate client nonce + cnonce = hashlib.sha1( + b"".join( + [ + str(self._nonce_count).encode("utf-8"), + nonce_bytes, + time.ctime().encode("utf-8"), + os.urandom(8), + ] + ) + ).hexdigest()[:16] + cnonce_bytes = cnonce.encode("utf-8") + + # Special handling for session-based algorithms + if algorithm.upper().endswith("-SESS"): + HA1 = H(b":".join((HA1, nonce_bytes, cnonce_bytes))) + + # Calculate the response digest + if qop: + noncebit = b":".join( + (nonce_bytes, ncvalue_bytes, cnonce_bytes, qop_bytes, HA2) + ) + response_digest = KD(HA1, noncebit) + else: + response_digest = KD(HA1, b":".join((nonce_bytes, HA2))) + + # Define a dict mapping of header fields to their values + # Group fields into always-present, optional, and qop-dependent + header_fields = { + # Always present fields + "username": escape_quotes(self._login_str), + "realm": escape_quotes(realm), + "nonce": escape_quotes(nonce), + "uri": path, + "response": response_digest.decode(), + "algorithm": algorithm_original, + } + + # Optional fields + if opaque: + header_fields["opaque"] = escape_quotes(opaque) + + # QoP-dependent fields + if qop: + header_fields["qop"] = qop + header_fields["nc"] = ncvalue + header_fields["cnonce"] = cnonce + + # Build header using templates for each field type + pairs: List[str] = [] + for field, value in header_fields.items(): + if field in QUOTED_AUTH_FIELDS: + pairs.append(f'{field}="{value}"') + else: + pairs.append(f"{field}={value}") + + return f"Digest {', '.join(pairs)}" + + def _in_protection_space(self, url: URL) -> bool: + """ + Check if the given URL is within the current protection space. + + According to RFC 7616, a URI is in the protection space if any URI + in the protection space is a prefix of it (after both have been made absolute). + """ + request_str = str(url) + for space_str in self._protection_space: + # Check if request starts with space URL + if not request_str.startswith(space_str): + continue + # Exact match or space ends with / (proper directory prefix) + if len(request_str) == len(space_str) or space_str[-1] == "/": + return True + # Check next char is / to ensure proper path boundary + if request_str[len(space_str)] == "/": + return True + return False + + def _authenticate(self, response: ClientResponse) -> bool: + """ + Takes the given response and tries digest-auth, if needed. + + Returns true if the original request must be resent. + """ + if response.status != 401: + return False + + auth_header = response.headers.get("www-authenticate", "") + if not auth_header: + return False # No authentication header present + + method, sep, headers = auth_header.partition(" ") + if not sep: + # No space found in www-authenticate header + return False # Malformed auth header, missing scheme separator + + if method.lower() != "digest": + # Not a digest auth challenge (could be Basic, Bearer, etc.) + return False + + if not headers: + # We have a digest scheme but no parameters + return False # Malformed digest header, missing parameters + + # We have a digest auth header with content + if not (header_pairs := parse_header_pairs(headers)): + # Failed to parse any key-value pairs + return False # Malformed digest header, no valid parameters + + # Extract challenge parameters + self._challenge = {} + for field in CHALLENGE_FIELDS: + if value := header_pairs.get(field): + self._challenge[field] = value + + # Update protection space based on domain parameter or default to origin + origin = response.url.origin() + + if domain := self._challenge.get("domain"): + # Parse space-separated list of URIs + self._protection_space = [] + for uri in domain.split(): + # Remove quotes if present + uri = uri.strip('"') + if uri.startswith("/"): + # Path-absolute, relative to origin + self._protection_space.append(str(origin.join(URL(uri)))) + else: + # Absolute URI + self._protection_space.append(str(URL(uri))) + else: + # No domain specified, protection space is entire origin + self._protection_space = [str(origin)] + + # Return True only if we found at least one challenge parameter + return bool(self._challenge) + + async def __call__( + self, request: ClientRequest, handler: ClientHandlerType + ) -> ClientResponse: + """Run the digest auth middleware.""" + response = None + for retry_count in range(2): + # Apply authorization header if: + # 1. This is a retry after 401 (retry_count > 0), OR + # 2. Preemptive auth is enabled AND we have a challenge AND the URL is in protection space + if retry_count > 0 or ( + self._preemptive + and self._challenge + and self._in_protection_space(request.url) + ): + request.headers[hdrs.AUTHORIZATION] = await self._encode( + request.method, request.url, request.body + ) + + # Send the request + response = await handler(request) + + # Check if we need to authenticate + if not self._authenticate(response): + break + + # At this point, response is guaranteed to be defined + assert response is not None + return response diff --git a/env/lib/python3.12/site-packages/aiohttp/client_middlewares.py b/env/lib/python3.12/site-packages/aiohttp/client_middlewares.py new file mode 100644 index 0000000..3ca2cb2 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/client_middlewares.py @@ -0,0 +1,55 @@ +"""Client middleware support.""" + +from collections.abc import Awaitable, Callable, Sequence + +from .client_reqrep import ClientRequest, ClientResponse + +__all__ = ("ClientMiddlewareType", "ClientHandlerType", "build_client_middlewares") + +# Type alias for client request handlers - functions that process requests and return responses +ClientHandlerType = Callable[[ClientRequest], Awaitable[ClientResponse]] + +# Type for client middleware - similar to server but uses ClientRequest/ClientResponse +ClientMiddlewareType = Callable[ + [ClientRequest, ClientHandlerType], Awaitable[ClientResponse] +] + + +def build_client_middlewares( + handler: ClientHandlerType, + middlewares: Sequence[ClientMiddlewareType], +) -> ClientHandlerType: + """ + Apply middlewares to request handler. + + The middlewares are applied in reverse order, so the first middleware + in the list wraps all subsequent middlewares and the handler. + + This implementation avoids using partial/update_wrapper to minimize overhead + and doesn't cache to avoid holding references to stateful middleware. + """ + # Optimize for single middleware case + if len(middlewares) == 1: + middleware = middlewares[0] + + async def single_middleware_handler(req: ClientRequest) -> ClientResponse: + return await middleware(req, handler) + + return single_middleware_handler + + # Build the chain for multiple middlewares + current_handler = handler + + for middleware in reversed(middlewares): + # Create a new closure that captures the current state + def make_wrapper( + mw: ClientMiddlewareType, next_h: ClientHandlerType + ) -> ClientHandlerType: + async def wrapped(req: ClientRequest) -> ClientResponse: + return await mw(req, next_h) + + return wrapped + + current_handler = make_wrapper(middleware, current_handler) + + return current_handler diff --git a/env/lib/python3.12/site-packages/aiohttp/client_proto.py b/env/lib/python3.12/site-packages/aiohttp/client_proto.py new file mode 100644 index 0000000..e2fb1ce --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/client_proto.py @@ -0,0 +1,359 @@ +import asyncio +from contextlib import suppress +from typing import Any, Optional, Tuple, Union + +from .base_protocol import BaseProtocol +from .client_exceptions import ( + ClientConnectionError, + ClientOSError, + ClientPayloadError, + ServerDisconnectedError, + SocketTimeoutError, +) +from .helpers import ( + _EXC_SENTINEL, + EMPTY_BODY_STATUS_CODES, + BaseTimerContext, + set_exception, + set_result, +) +from .http import HttpResponseParser, RawResponseMessage +from .http_exceptions import HttpProcessingError +from .streams import EMPTY_PAYLOAD, DataQueue, StreamReader + + +class ResponseHandler(BaseProtocol, DataQueue[Tuple[RawResponseMessage, StreamReader]]): + """Helper class to adapt between Protocol and StreamReader.""" + + def __init__(self, loop: asyncio.AbstractEventLoop) -> None: + BaseProtocol.__init__(self, loop=loop) + DataQueue.__init__(self, loop) + + self._should_close = False + + self._payload: Optional[StreamReader] = None + self._skip_payload = False + self._payload_parser = None + + self._timer = None + + self._tail = b"" + self._upgraded = False + self._parser: Optional[HttpResponseParser] = None + + self._read_timeout: Optional[float] = None + self._read_timeout_handle: Optional[asyncio.TimerHandle] = None + + self._timeout_ceil_threshold: Optional[float] = 5 + + self._closed: Union[None, asyncio.Future[None]] = None + self._connection_lost_called = False + + @property + def closed(self) -> Union[None, asyncio.Future[None]]: + """Future that is set when the connection is closed. + + This property returns a Future that will be completed when the connection + is closed. The Future is created lazily on first access to avoid creating + futures that will never be awaited. + + Returns: + - A Future[None] if the connection is still open or was closed after + this property was accessed + - None if connection_lost() was already called before this property + was ever accessed (indicating no one is waiting for the closure) + """ + if self._closed is None and not self._connection_lost_called: + self._closed = self._loop.create_future() + return self._closed + + @property + def upgraded(self) -> bool: + return self._upgraded + + @property + def should_close(self) -> bool: + return bool( + self._should_close + or (self._payload is not None and not self._payload.is_eof()) + or self._upgraded + or self._exception is not None + or self._payload_parser is not None + or self._buffer + or self._tail + ) + + def force_close(self) -> None: + self._should_close = True + + def close(self) -> None: + self._exception = None # Break cyclic references + transport = self.transport + if transport is not None: + transport.close() + self.transport = None + self._payload = None + self._drop_timeout() + + def abort(self) -> None: + self._exception = None # Break cyclic references + transport = self.transport + if transport is not None: + transport.abort() + self.transport = None + self._payload = None + self._drop_timeout() + + def is_connected(self) -> bool: + return self.transport is not None and not self.transport.is_closing() + + def connection_lost(self, exc: Optional[BaseException]) -> None: + self._connection_lost_called = True + self._drop_timeout() + + original_connection_error = exc + reraised_exc = original_connection_error + + connection_closed_cleanly = original_connection_error is None + + if self._closed is not None: + # If someone is waiting for the closed future, + # we should set it to None or an exception. If + # self._closed is None, it means that + # connection_lost() was called already + # or nobody is waiting for it. + if connection_closed_cleanly: + set_result(self._closed, None) + else: + assert original_connection_error is not None + set_exception( + self._closed, + ClientConnectionError( + f"Connection lost: {original_connection_error !s}", + ), + original_connection_error, + ) + + if self._payload_parser is not None: + with suppress(Exception): # FIXME: log this somehow? + self._payload_parser.feed_eof() + + uncompleted = None + if self._parser is not None: + try: + uncompleted = self._parser.feed_eof() + except Exception as underlying_exc: + if self._payload is not None: + client_payload_exc_msg = ( + f"Response payload is not completed: {underlying_exc !r}" + ) + if not connection_closed_cleanly: + client_payload_exc_msg = ( + f"{client_payload_exc_msg !s}. " + f"{original_connection_error !r}" + ) + set_exception( + self._payload, + ClientPayloadError(client_payload_exc_msg), + underlying_exc, + ) + + if not self.is_eof(): + if isinstance(original_connection_error, OSError): + reraised_exc = ClientOSError(*original_connection_error.args) + if connection_closed_cleanly: + reraised_exc = ServerDisconnectedError(uncompleted) + # assigns self._should_close to True as side effect, + # we do it anyway below + underlying_non_eof_exc = ( + _EXC_SENTINEL + if connection_closed_cleanly + else original_connection_error + ) + assert underlying_non_eof_exc is not None + assert reraised_exc is not None + self.set_exception(reraised_exc, underlying_non_eof_exc) + + self._should_close = True + self._parser = None + self._payload = None + self._payload_parser = None + self._reading_paused = False + + super().connection_lost(reraised_exc) + + def eof_received(self) -> None: + # should call parser.feed_eof() most likely + self._drop_timeout() + + def pause_reading(self) -> None: + super().pause_reading() + self._drop_timeout() + + def resume_reading(self) -> None: + super().resume_reading() + self._reschedule_timeout() + + def set_exception( + self, + exc: BaseException, + exc_cause: BaseException = _EXC_SENTINEL, + ) -> None: + self._should_close = True + self._drop_timeout() + super().set_exception(exc, exc_cause) + + def set_parser(self, parser: Any, payload: Any) -> None: + # TODO: actual types are: + # parser: WebSocketReader + # payload: WebSocketDataQueue + # but they are not generi enough + # Need an ABC for both types + self._payload = payload + self._payload_parser = parser + + self._drop_timeout() + + if self._tail: + data, self._tail = self._tail, b"" + self.data_received(data) + + def set_response_params( + self, + *, + timer: Optional[BaseTimerContext] = None, + skip_payload: bool = False, + read_until_eof: bool = False, + auto_decompress: bool = True, + read_timeout: Optional[float] = None, + read_bufsize: int = 2**16, + timeout_ceil_threshold: float = 5, + max_line_size: int = 8190, + max_field_size: int = 8190, + ) -> None: + self._skip_payload = skip_payload + + self._read_timeout = read_timeout + + self._timeout_ceil_threshold = timeout_ceil_threshold + + self._parser = HttpResponseParser( + self, + self._loop, + read_bufsize, + timer=timer, + payload_exception=ClientPayloadError, + response_with_body=not skip_payload, + read_until_eof=read_until_eof, + auto_decompress=auto_decompress, + max_line_size=max_line_size, + max_field_size=max_field_size, + ) + + if self._tail: + data, self._tail = self._tail, b"" + self.data_received(data) + + def _drop_timeout(self) -> None: + if self._read_timeout_handle is not None: + self._read_timeout_handle.cancel() + self._read_timeout_handle = None + + def _reschedule_timeout(self) -> None: + timeout = self._read_timeout + if self._read_timeout_handle is not None: + self._read_timeout_handle.cancel() + + if timeout: + self._read_timeout_handle = self._loop.call_later( + timeout, self._on_read_timeout + ) + else: + self._read_timeout_handle = None + + def start_timeout(self) -> None: + self._reschedule_timeout() + + @property + def read_timeout(self) -> Optional[float]: + return self._read_timeout + + @read_timeout.setter + def read_timeout(self, read_timeout: Optional[float]) -> None: + self._read_timeout = read_timeout + + def _on_read_timeout(self) -> None: + exc = SocketTimeoutError("Timeout on reading data from socket") + self.set_exception(exc) + if self._payload is not None: + set_exception(self._payload, exc) + + def data_received(self, data: bytes) -> None: + self._reschedule_timeout() + + if not data: + return + + # custom payload parser - currently always WebSocketReader + if self._payload_parser is not None: + eof, tail = self._payload_parser.feed_data(data) + if eof: + self._payload = None + self._payload_parser = None + + if tail: + self.data_received(tail) + return + + if self._upgraded or self._parser is None: + # i.e. websocket connection, websocket parser is not set yet + self._tail += data + return + + # parse http messages + try: + messages, upgraded, tail = self._parser.feed_data(data) + except BaseException as underlying_exc: + if self.transport is not None: + # connection.release() could be called BEFORE + # data_received(), the transport is already + # closed in this case + self.transport.close() + # should_close is True after the call + if isinstance(underlying_exc, HttpProcessingError): + exc = HttpProcessingError( + code=underlying_exc.code, + message=underlying_exc.message, + headers=underlying_exc.headers, + ) + else: + exc = HttpProcessingError() + self.set_exception(exc, underlying_exc) + return + + self._upgraded = upgraded + + payload: Optional[StreamReader] = None + for message, payload in messages: + if message.should_close: + self._should_close = True + + self._payload = payload + + if self._skip_payload or message.code in EMPTY_BODY_STATUS_CODES: + self.feed_data((message, EMPTY_PAYLOAD), 0) + else: + self.feed_data((message, payload), 0) + + if payload is not None: + # new message(s) was processed + # register timeout handler unsubscribing + # either on end-of-stream or immediately for + # EMPTY_PAYLOAD + if payload is not EMPTY_PAYLOAD: + payload.on_eof(self._drop_timeout) + else: + self._drop_timeout() + + if upgraded and tail: + self.data_received(tail) diff --git a/env/lib/python3.12/site-packages/aiohttp/client_reqrep.py b/env/lib/python3.12/site-packages/aiohttp/client_reqrep.py new file mode 100644 index 0000000..a9e0795 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/client_reqrep.py @@ -0,0 +1,1536 @@ +import asyncio +import codecs +import contextlib +import functools +import io +import re +import sys +import traceback +import warnings +from collections.abc import Mapping +from hashlib import md5, sha1, sha256 +from http.cookies import Morsel, SimpleCookie +from types import MappingProxyType, TracebackType +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + Iterable, + List, + Literal, + NamedTuple, + Optional, + Tuple, + Type, + Union, +) + +import attr +from multidict import CIMultiDict, CIMultiDictProxy, MultiDict, MultiDictProxy +from yarl import URL + +from . import hdrs, helpers, http, multipart, payload +from ._cookie_helpers import ( + parse_cookie_header, + parse_set_cookie_headers, + preserve_morsel_with_coded_value, +) +from .abc import AbstractStreamWriter +from .client_exceptions import ( + ClientConnectionError, + ClientOSError, + ClientResponseError, + ContentTypeError, + InvalidURL, + ServerFingerprintMismatch, +) +from .compression_utils import HAS_BROTLI, HAS_ZSTD +from .formdata import FormData +from .helpers import ( + _SENTINEL, + BaseTimerContext, + BasicAuth, + HeadersMixin, + TimerNoop, + noop, + reify, + sentinel, + set_exception, + set_result, +) +from .http import ( + SERVER_SOFTWARE, + HttpVersion, + HttpVersion10, + HttpVersion11, + StreamWriter, +) +from .streams import StreamReader +from .typedefs import ( + DEFAULT_JSON_DECODER, + JSONDecoder, + LooseCookies, + LooseHeaders, + Query, + RawHeaders, +) + +if TYPE_CHECKING: + import ssl + from ssl import SSLContext +else: + try: + import ssl + from ssl import SSLContext + except ImportError: # pragma: no cover + ssl = None # type: ignore[assignment] + SSLContext = object # type: ignore[misc,assignment] + + +__all__ = ("ClientRequest", "ClientResponse", "RequestInfo", "Fingerprint") + + +if TYPE_CHECKING: + from .client import ClientSession + from .connector import Connection + from .tracing import Trace + + +_CONNECTION_CLOSED_EXCEPTION = ClientConnectionError("Connection closed") +_CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]") +json_re = re.compile(r"^application/(?:[\w.+-]+?\+)?json") + + +def _gen_default_accept_encoding() -> str: + encodings = [ + "gzip", + "deflate", + ] + if HAS_BROTLI: + encodings.append("br") + if HAS_ZSTD: + encodings.append("zstd") + return ", ".join(encodings) + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class ContentDisposition: + type: Optional[str] + parameters: "MappingProxyType[str, str]" + filename: Optional[str] + + +class _RequestInfo(NamedTuple): + url: URL + method: str + headers: "CIMultiDictProxy[str]" + real_url: URL + + +class RequestInfo(_RequestInfo): + + def __new__( + cls, + url: URL, + method: str, + headers: "CIMultiDictProxy[str]", + real_url: Union[URL, _SENTINEL] = sentinel, + ) -> "RequestInfo": + """Create a new RequestInfo instance. + + For backwards compatibility, the real_url parameter is optional. + """ + return tuple.__new__( + cls, (url, method, headers, url if real_url is sentinel else real_url) + ) + + +class Fingerprint: + HASHFUNC_BY_DIGESTLEN = { + 16: md5, + 20: sha1, + 32: sha256, + } + + def __init__(self, fingerprint: bytes) -> None: + digestlen = len(fingerprint) + hashfunc = self.HASHFUNC_BY_DIGESTLEN.get(digestlen) + if not hashfunc: + raise ValueError("fingerprint has invalid length") + elif hashfunc is md5 or hashfunc is sha1: + raise ValueError("md5 and sha1 are insecure and not supported. Use sha256.") + self._hashfunc = hashfunc + self._fingerprint = fingerprint + + @property + def fingerprint(self) -> bytes: + return self._fingerprint + + def check(self, transport: asyncio.Transport) -> None: + if not transport.get_extra_info("sslcontext"): + return + sslobj = transport.get_extra_info("ssl_object") + cert = sslobj.getpeercert(binary_form=True) + got = self._hashfunc(cert).digest() + if got != self._fingerprint: + host, port, *_ = transport.get_extra_info("peername") + raise ServerFingerprintMismatch(self._fingerprint, got, host, port) + + +if ssl is not None: + SSL_ALLOWED_TYPES = (ssl.SSLContext, bool, Fingerprint, type(None)) +else: # pragma: no cover + SSL_ALLOWED_TYPES = (bool, type(None)) + + +def _merge_ssl_params( + ssl: Union["SSLContext", bool, Fingerprint], + verify_ssl: Optional[bool], + ssl_context: Optional["SSLContext"], + fingerprint: Optional[bytes], +) -> Union["SSLContext", bool, Fingerprint]: + if ssl is None: + ssl = True # Double check for backwards compatibility + if verify_ssl is not None and not verify_ssl: + warnings.warn( + "verify_ssl is deprecated, use ssl=False instead", + DeprecationWarning, + stacklevel=3, + ) + if ssl is not True: + raise ValueError( + "verify_ssl, ssl_context, fingerprint and ssl " + "parameters are mutually exclusive" + ) + else: + ssl = False + if ssl_context is not None: + warnings.warn( + "ssl_context is deprecated, use ssl=context instead", + DeprecationWarning, + stacklevel=3, + ) + if ssl is not True: + raise ValueError( + "verify_ssl, ssl_context, fingerprint and ssl " + "parameters are mutually exclusive" + ) + else: + ssl = ssl_context + if fingerprint is not None: + warnings.warn( + "fingerprint is deprecated, use ssl=Fingerprint(fingerprint) instead", + DeprecationWarning, + stacklevel=3, + ) + if ssl is not True: + raise ValueError( + "verify_ssl, ssl_context, fingerprint and ssl " + "parameters are mutually exclusive" + ) + else: + ssl = Fingerprint(fingerprint) + if not isinstance(ssl, SSL_ALLOWED_TYPES): + raise TypeError( + "ssl should be SSLContext, bool, Fingerprint or None, " + "got {!r} instead.".format(ssl) + ) + return ssl + + +_SSL_SCHEMES = frozenset(("https", "wss")) + + +# ConnectionKey is a NamedTuple because it is used as a key in a dict +# and a set in the connector. Since a NamedTuple is a tuple it uses +# the fast native tuple __hash__ and __eq__ implementation in CPython. +class ConnectionKey(NamedTuple): + # the key should contain an information about used proxy / TLS + # to prevent reusing wrong connections from a pool + host: str + port: Optional[int] + is_ssl: bool + ssl: Union[SSLContext, bool, Fingerprint] + proxy: Optional[URL] + proxy_auth: Optional[BasicAuth] + proxy_headers_hash: Optional[int] # hash(CIMultiDict) + + +def _is_expected_content_type( + response_content_type: str, expected_content_type: str +) -> bool: + if expected_content_type == "application/json": + return json_re.match(response_content_type) is not None + return expected_content_type in response_content_type + + +def _warn_if_unclosed_payload(payload: payload.Payload, stacklevel: int = 2) -> None: + """Warn if the payload is not closed. + + Callers must check that the body is a Payload before calling this method. + + Args: + payload: The payload to check + stacklevel: Stack level for the warning (default 2 for direct callers) + """ + if not payload.autoclose and not payload.consumed: + warnings.warn( + "The previous request body contains unclosed resources. " + "Use await request.update_body() instead of setting request.body " + "directly to properly close resources and avoid leaks.", + ResourceWarning, + stacklevel=stacklevel, + ) + + +class ClientResponse(HeadersMixin): + + # Some of these attributes are None when created, + # but will be set by the start() method. + # As the end user will likely never see the None values, we cheat the types below. + # from the Status-Line of the response + version: Optional[HttpVersion] = None # HTTP-Version + status: int = None # type: ignore[assignment] # Status-Code + reason: Optional[str] = None # Reason-Phrase + + content: StreamReader = None # type: ignore[assignment] # Payload stream + _body: Optional[bytes] = None + _headers: CIMultiDictProxy[str] = None # type: ignore[assignment] + _history: Tuple["ClientResponse", ...] = () + _raw_headers: RawHeaders = None # type: ignore[assignment] + + _connection: Optional["Connection"] = None # current connection + _cookies: Optional[SimpleCookie] = None + _raw_cookie_headers: Optional[Tuple[str, ...]] = None + _continue: Optional["asyncio.Future[bool]"] = None + _source_traceback: Optional[traceback.StackSummary] = None + _session: Optional["ClientSession"] = None + # set up by ClientRequest after ClientResponse object creation + # post-init stage allows to not change ctor signature + _closed = True # to allow __del__ for non-initialized properly response + _released = False + _in_context = False + + _resolve_charset: Callable[["ClientResponse", bytes], str] = lambda *_: "utf-8" + + __writer: Optional["asyncio.Task[None]"] = None + + def __init__( + self, + method: str, + url: URL, + *, + writer: "Optional[asyncio.Task[None]]", + continue100: Optional["asyncio.Future[bool]"], + timer: BaseTimerContext, + request_info: RequestInfo, + traces: List["Trace"], + loop: asyncio.AbstractEventLoop, + session: "ClientSession", + ) -> None: + # URL forbids subclasses, so a simple type check is enough. + assert type(url) is URL + + self.method = method + + self._real_url = url + self._url = url.with_fragment(None) if url.raw_fragment else url + if writer is not None: + self._writer = writer + if continue100 is not None: + self._continue = continue100 + self._request_info = request_info + self._timer = timer if timer is not None else TimerNoop() + self._cache: Dict[str, Any] = {} + self._traces = traces + self._loop = loop + # Save reference to _resolve_charset, so that get_encoding() will still + # work after the response has finished reading the body. + # TODO: Fix session=None in tests (see ClientRequest.__init__). + if session is not None: + # store a reference to session #1985 + self._session = session + self._resolve_charset = session._resolve_charset + if loop.get_debug(): + self._source_traceback = traceback.extract_stack(sys._getframe(1)) + + def __reset_writer(self, _: object = None) -> None: + self.__writer = None + + @property + def _writer(self) -> Optional["asyncio.Task[None]"]: + """The writer task for streaming data. + + _writer is only provided for backwards compatibility + for subclasses that may need to access it. + """ + return self.__writer + + @_writer.setter + def _writer(self, writer: Optional["asyncio.Task[None]"]) -> None: + """Set the writer task for streaming data.""" + if self.__writer is not None: + self.__writer.remove_done_callback(self.__reset_writer) + self.__writer = writer + if writer is None: + return + if writer.done(): + # The writer is already done, so we can clear it immediately. + self.__writer = None + else: + writer.add_done_callback(self.__reset_writer) + + @property + def cookies(self) -> SimpleCookie: + if self._cookies is None: + if self._raw_cookie_headers is not None: + # Parse cookies for response.cookies (SimpleCookie for backward compatibility) + cookies = SimpleCookie() + # Use parse_set_cookie_headers for more lenient parsing that handles + # malformed cookies better than SimpleCookie.load + cookies.update(parse_set_cookie_headers(self._raw_cookie_headers)) + self._cookies = cookies + else: + self._cookies = SimpleCookie() + return self._cookies + + @cookies.setter + def cookies(self, cookies: SimpleCookie) -> None: + self._cookies = cookies + # Generate raw cookie headers from the SimpleCookie + if cookies: + self._raw_cookie_headers = tuple( + morsel.OutputString() for morsel in cookies.values() + ) + else: + self._raw_cookie_headers = None + + @reify + def url(self) -> URL: + return self._url + + @reify + def url_obj(self) -> URL: + warnings.warn("Deprecated, use .url #1654", DeprecationWarning, stacklevel=2) + return self._url + + @reify + def real_url(self) -> URL: + return self._real_url + + @reify + def host(self) -> str: + assert self._url.host is not None + return self._url.host + + @reify + def headers(self) -> "CIMultiDictProxy[str]": + return self._headers + + @reify + def raw_headers(self) -> RawHeaders: + return self._raw_headers + + @reify + def request_info(self) -> RequestInfo: + return self._request_info + + @reify + def content_disposition(self) -> Optional[ContentDisposition]: + raw = self._headers.get(hdrs.CONTENT_DISPOSITION) + if raw is None: + return None + disposition_type, params_dct = multipart.parse_content_disposition(raw) + params = MappingProxyType(params_dct) + filename = multipart.content_disposition_filename(params) + return ContentDisposition(disposition_type, params, filename) + + def __del__(self, _warnings: Any = warnings) -> None: + if self._closed: + return + + if self._connection is not None: + self._connection.release() + self._cleanup_writer() + + if self._loop.get_debug(): + kwargs = {"source": self} + _warnings.warn(f"Unclosed response {self!r}", ResourceWarning, **kwargs) + context = {"client_response": self, "message": "Unclosed response"} + if self._source_traceback: + context["source_traceback"] = self._source_traceback + self._loop.call_exception_handler(context) + + def __repr__(self) -> str: + out = io.StringIO() + ascii_encodable_url = str(self.url) + if self.reason: + ascii_encodable_reason = self.reason.encode( + "ascii", "backslashreplace" + ).decode("ascii") + else: + ascii_encodable_reason = "None" + print( + "".format( + ascii_encodable_url, self.status, ascii_encodable_reason + ), + file=out, + ) + print(self.headers, file=out) + return out.getvalue() + + @property + def connection(self) -> Optional["Connection"]: + return self._connection + + @reify + def history(self) -> Tuple["ClientResponse", ...]: + """A sequence of of responses, if redirects occurred.""" + return self._history + + @reify + def links(self) -> "MultiDictProxy[MultiDictProxy[Union[str, URL]]]": + links_str = ", ".join(self.headers.getall("link", [])) + + if not links_str: + return MultiDictProxy(MultiDict()) + + links: MultiDict[MultiDictProxy[Union[str, URL]]] = MultiDict() + + for val in re.split(r",(?=\s*<)", links_str): + match = re.match(r"\s*<(.*)>(.*)", val) + if match is None: # pragma: no cover + # the check exists to suppress mypy error + continue + url, params_str = match.groups() + params = params_str.split(";")[1:] + + link: MultiDict[Union[str, URL]] = MultiDict() + + for param in params: + match = re.match(r"^\s*(\S*)\s*=\s*(['\"]?)(.*?)(\2)\s*$", param, re.M) + if match is None: # pragma: no cover + # the check exists to suppress mypy error + continue + key, _, value, _ = match.groups() + + link.add(key, value) + + key = link.get("rel", url) + + link.add("url", self.url.join(URL(url))) + + links.add(str(key), MultiDictProxy(link)) + + return MultiDictProxy(links) + + async def start(self, connection: "Connection") -> "ClientResponse": + """Start response processing.""" + self._closed = False + self._protocol = connection.protocol + self._connection = connection + + with self._timer: + while True: + # read response + try: + protocol = self._protocol + message, payload = await protocol.read() # type: ignore[union-attr] + except http.HttpProcessingError as exc: + raise ClientResponseError( + self.request_info, + self.history, + status=exc.code, + message=exc.message, + headers=exc.headers, + ) from exc + + if message.code < 100 or message.code > 199 or message.code == 101: + break + + if self._continue is not None: + set_result(self._continue, True) + self._continue = None + + # payload eof handler + payload.on_eof(self._response_eof) + + # response status + self.version = message.version + self.status = message.code + self.reason = message.reason + + # headers + self._headers = message.headers # type is CIMultiDictProxy + self._raw_headers = message.raw_headers # type is Tuple[bytes, bytes] + + # payload + self.content = payload + + # cookies + if cookie_hdrs := self.headers.getall(hdrs.SET_COOKIE, ()): + # Store raw cookie headers for CookieJar + self._raw_cookie_headers = tuple(cookie_hdrs) + return self + + def _response_eof(self) -> None: + if self._closed: + return + + # protocol could be None because connection could be detached + protocol = self._connection and self._connection.protocol + if protocol is not None and protocol.upgraded: + return + + self._closed = True + self._cleanup_writer() + self._release_connection() + + @property + def closed(self) -> bool: + return self._closed + + def close(self) -> None: + if not self._released: + self._notify_content() + + self._closed = True + if self._loop is None or self._loop.is_closed(): + return + + self._cleanup_writer() + if self._connection is not None: + self._connection.close() + self._connection = None + + def release(self) -> Any: + if not self._released: + self._notify_content() + + self._closed = True + + self._cleanup_writer() + self._release_connection() + return noop() + + @property + def ok(self) -> bool: + """Returns ``True`` if ``status`` is less than ``400``, ``False`` if not. + + This is **not** a check for ``200 OK`` but a check that the response + status is under 400. + """ + return 400 > self.status + + def raise_for_status(self) -> None: + if not self.ok: + # reason should always be not None for a started response + assert self.reason is not None + + # If we're in a context we can rely on __aexit__() to release as the + # exception propagates. + if not self._in_context: + self.release() + + raise ClientResponseError( + self.request_info, + self.history, + status=self.status, + message=self.reason, + headers=self.headers, + ) + + def _release_connection(self) -> None: + if self._connection is not None: + if self.__writer is None: + self._connection.release() + self._connection = None + else: + self.__writer.add_done_callback(lambda f: self._release_connection()) + + async def _wait_released(self) -> None: + if self.__writer is not None: + try: + await self.__writer + except asyncio.CancelledError: + if ( + sys.version_info >= (3, 11) + and (task := asyncio.current_task()) + and task.cancelling() + ): + raise + self._release_connection() + + def _cleanup_writer(self) -> None: + if self.__writer is not None: + self.__writer.cancel() + self._session = None + + def _notify_content(self) -> None: + content = self.content + if content and content.exception() is None: + set_exception(content, _CONNECTION_CLOSED_EXCEPTION) + self._released = True + + async def wait_for_close(self) -> None: + if self.__writer is not None: + try: + await self.__writer + except asyncio.CancelledError: + if ( + sys.version_info >= (3, 11) + and (task := asyncio.current_task()) + and task.cancelling() + ): + raise + self.release() + + async def read(self) -> bytes: + """Read response payload.""" + if self._body is None: + try: + self._body = await self.content.read() + for trace in self._traces: + await trace.send_response_chunk_received( + self.method, self.url, self._body + ) + except BaseException: + self.close() + raise + elif self._released: # Response explicitly released + raise ClientConnectionError("Connection closed") + + protocol = self._connection and self._connection.protocol + if protocol is None or not protocol.upgraded: + await self._wait_released() # Underlying connection released + return self._body + + def get_encoding(self) -> str: + ctype = self.headers.get(hdrs.CONTENT_TYPE, "").lower() + mimetype = helpers.parse_mimetype(ctype) + + encoding = mimetype.parameters.get("charset") + if encoding: + with contextlib.suppress(LookupError, ValueError): + return codecs.lookup(encoding).name + + if mimetype.type == "application" and ( + mimetype.subtype == "json" or mimetype.subtype == "rdap" + ): + # RFC 7159 states that the default encoding is UTF-8. + # RFC 7483 defines application/rdap+json + return "utf-8" + + if self._body is None: + raise RuntimeError( + "Cannot compute fallback encoding of a not yet read body" + ) + + return self._resolve_charset(self, self._body) + + async def text(self, encoding: Optional[str] = None, errors: str = "strict") -> str: + """Read response payload and decode.""" + if self._body is None: + await self.read() + + if encoding is None: + encoding = self.get_encoding() + + return self._body.decode(encoding, errors=errors) # type: ignore[union-attr] + + async def json( + self, + *, + encoding: Optional[str] = None, + loads: JSONDecoder = DEFAULT_JSON_DECODER, + content_type: Optional[str] = "application/json", + ) -> Any: + """Read and decodes JSON response.""" + if self._body is None: + await self.read() + + if content_type: + ctype = self.headers.get(hdrs.CONTENT_TYPE, "").lower() + if not _is_expected_content_type(ctype, content_type): + raise ContentTypeError( + self.request_info, + self.history, + status=self.status, + message=( + "Attempt to decode JSON with unexpected mimetype: %s" % ctype + ), + headers=self.headers, + ) + + stripped = self._body.strip() # type: ignore[union-attr] + if not stripped: + return None + + if encoding is None: + encoding = self.get_encoding() + + return loads(stripped.decode(encoding)) + + async def __aenter__(self) -> "ClientResponse": + self._in_context = True + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + self._in_context = False + # similar to _RequestContextManager, we do not need to check + # for exceptions, response object can close connection + # if state is broken + self.release() + await self.wait_for_close() + + +class ClientRequest: + GET_METHODS = { + hdrs.METH_GET, + hdrs.METH_HEAD, + hdrs.METH_OPTIONS, + hdrs.METH_TRACE, + } + POST_METHODS = {hdrs.METH_PATCH, hdrs.METH_POST, hdrs.METH_PUT} + ALL_METHODS = GET_METHODS.union(POST_METHODS).union({hdrs.METH_DELETE}) + + DEFAULT_HEADERS = { + hdrs.ACCEPT: "*/*", + hdrs.ACCEPT_ENCODING: _gen_default_accept_encoding(), + } + + # Type of body depends on PAYLOAD_REGISTRY, which is dynamic. + _body: Union[None, payload.Payload] = None + auth = None + response = None + + __writer: Optional["asyncio.Task[None]"] = None # async task for streaming data + + # These class defaults help create_autospec() work correctly. + # If autospec is improved in future, maybe these can be removed. + url = URL() + method = "GET" + + _continue = None # waiter future for '100 Continue' response + + _skip_auto_headers: Optional["CIMultiDict[None]"] = None + + # N.B. + # Adding __del__ method with self._writer closing doesn't make sense + # because _writer is instance method, thus it keeps a reference to self. + # Until writer has finished finalizer will not be called. + + def __init__( + self, + method: str, + url: URL, + *, + params: Query = None, + headers: Optional[LooseHeaders] = None, + skip_auto_headers: Optional[Iterable[str]] = None, + data: Any = None, + cookies: Optional[LooseCookies] = None, + auth: Optional[BasicAuth] = None, + version: http.HttpVersion = http.HttpVersion11, + compress: Union[str, bool, None] = None, + chunked: Optional[bool] = None, + expect100: bool = False, + loop: Optional[asyncio.AbstractEventLoop] = None, + response_class: Optional[Type["ClientResponse"]] = None, + proxy: Optional[URL] = None, + proxy_auth: Optional[BasicAuth] = None, + timer: Optional[BaseTimerContext] = None, + session: Optional["ClientSession"] = None, + ssl: Union[SSLContext, bool, Fingerprint] = True, + proxy_headers: Optional[LooseHeaders] = None, + traces: Optional[List["Trace"]] = None, + trust_env: bool = False, + server_hostname: Optional[str] = None, + ): + if loop is None: + loop = asyncio.get_event_loop() + if match := _CONTAINS_CONTROL_CHAR_RE.search(method): + raise ValueError( + f"Method cannot contain non-token characters {method!r} " + f"(found at least {match.group()!r})" + ) + # URL forbids subclasses, so a simple type check is enough. + assert type(url) is URL, url + if proxy is not None: + assert type(proxy) is URL, proxy + # FIXME: session is None in tests only, need to fix tests + # assert session is not None + if TYPE_CHECKING: + assert session is not None + self._session = session + if params: + url = url.extend_query(params) + self.original_url = url + self.url = url.with_fragment(None) if url.raw_fragment else url + self.method = method.upper() + self.chunked = chunked + self.compress = compress + self.loop = loop + self.length = None + if response_class is None: + real_response_class = ClientResponse + else: + real_response_class = response_class + self.response_class: Type[ClientResponse] = real_response_class + self._timer = timer if timer is not None else TimerNoop() + self._ssl = ssl if ssl is not None else True + self.server_hostname = server_hostname + + if loop.get_debug(): + self._source_traceback = traceback.extract_stack(sys._getframe(1)) + + self.update_version(version) + self.update_host(url) + self.update_headers(headers) + self.update_auto_headers(skip_auto_headers) + self.update_cookies(cookies) + self.update_content_encoding(data) + self.update_auth(auth, trust_env) + self.update_proxy(proxy, proxy_auth, proxy_headers) + + self.update_body_from_data(data) + if data is not None or self.method not in self.GET_METHODS: + self.update_transfer_encoding() + self.update_expect_continue(expect100) + self._traces = [] if traces is None else traces + + def __reset_writer(self, _: object = None) -> None: + self.__writer = None + + def _get_content_length(self) -> Optional[int]: + """Extract and validate Content-Length header value. + + Returns parsed Content-Length value or None if not set. + Raises ValueError if header exists but cannot be parsed as an integer. + """ + if hdrs.CONTENT_LENGTH not in self.headers: + return None + + content_length_hdr = self.headers[hdrs.CONTENT_LENGTH] + try: + return int(content_length_hdr) + except ValueError: + raise ValueError( + f"Invalid Content-Length header: {content_length_hdr}" + ) from None + + @property + def skip_auto_headers(self) -> CIMultiDict[None]: + return self._skip_auto_headers or CIMultiDict() + + @property + def _writer(self) -> Optional["asyncio.Task[None]"]: + return self.__writer + + @_writer.setter + def _writer(self, writer: "asyncio.Task[None]") -> None: + if self.__writer is not None: + self.__writer.remove_done_callback(self.__reset_writer) + self.__writer = writer + writer.add_done_callback(self.__reset_writer) + + def is_ssl(self) -> bool: + return self.url.scheme in _SSL_SCHEMES + + @property + def ssl(self) -> Union["SSLContext", bool, Fingerprint]: + return self._ssl + + @property + def connection_key(self) -> ConnectionKey: + if proxy_headers := self.proxy_headers: + h: Optional[int] = hash(tuple(proxy_headers.items())) + else: + h = None + url = self.url + return tuple.__new__( + ConnectionKey, + ( + url.raw_host or "", + url.port, + url.scheme in _SSL_SCHEMES, + self._ssl, + self.proxy, + self.proxy_auth, + h, + ), + ) + + @property + def host(self) -> str: + ret = self.url.raw_host + assert ret is not None + return ret + + @property + def port(self) -> Optional[int]: + return self.url.port + + @property + def body(self) -> Union[payload.Payload, Literal[b""]]: + """Request body.""" + # empty body is represented as bytes for backwards compatibility + return self._body or b"" + + @body.setter + def body(self, value: Any) -> None: + """Set request body with warning for non-autoclose payloads. + + WARNING: This setter must be called from within an event loop and is not + thread-safe. Setting body outside of an event loop may raise RuntimeError + when closing file-based payloads. + + DEPRECATED: Direct assignment to body is deprecated and will be removed + in a future version. Use await update_body() instead for proper resource + management. + """ + # Close existing payload if present + if self._body is not None: + # Warn if the payload needs manual closing + # stacklevel=3: user code -> body setter -> _warn_if_unclosed_payload + _warn_if_unclosed_payload(self._body, stacklevel=3) + # NOTE: In the future, when we remove sync close support, + # this setter will need to be removed and only the async + # update_body() method will be available. For now, we call + # _close() for backwards compatibility. + self._body._close() + self._update_body(value) + + @property + def request_info(self) -> RequestInfo: + headers: CIMultiDictProxy[str] = CIMultiDictProxy(self.headers) + # These are created on every request, so we use a NamedTuple + # for performance reasons. We don't use the RequestInfo.__new__ + # method because it has a different signature which is provided + # for backwards compatibility only. + return tuple.__new__( + RequestInfo, (self.url, self.method, headers, self.original_url) + ) + + @property + def session(self) -> "ClientSession": + """Return the ClientSession instance. + + This property provides access to the ClientSession that initiated + this request, allowing middleware to make additional requests + using the same session. + """ + return self._session + + def update_host(self, url: URL) -> None: + """Update destination host, port and connection type (ssl).""" + # get host/port + if not url.raw_host: + raise InvalidURL(url) + + # basic auth info + if url.raw_user or url.raw_password: + self.auth = helpers.BasicAuth(url.user or "", url.password or "") + + def update_version(self, version: Union[http.HttpVersion, str]) -> None: + """Convert request version to two elements tuple. + + parser HTTP version '1.1' => (1, 1) + """ + if isinstance(version, str): + v = [part.strip() for part in version.split(".", 1)] + try: + version = http.HttpVersion(int(v[0]), int(v[1])) + except ValueError: + raise ValueError( + f"Can not parse http version number: {version}" + ) from None + self.version = version + + def update_headers(self, headers: Optional[LooseHeaders]) -> None: + """Update request headers.""" + self.headers: CIMultiDict[str] = CIMultiDict() + + # Build the host header + host = self.url.host_port_subcomponent + + # host_port_subcomponent is None when the URL is a relative URL. + # but we know we do not have a relative URL here. + assert host is not None + self.headers[hdrs.HOST] = host + + if not headers: + return + + if isinstance(headers, (dict, MultiDictProxy, MultiDict)): + headers = headers.items() + + for key, value in headers: # type: ignore[misc] + # A special case for Host header + if key in hdrs.HOST_ALL: + self.headers[key] = value + else: + self.headers.add(key, value) + + def update_auto_headers(self, skip_auto_headers: Optional[Iterable[str]]) -> None: + if skip_auto_headers is not None: + self._skip_auto_headers = CIMultiDict( + (hdr, None) for hdr in sorted(skip_auto_headers) + ) + used_headers = self.headers.copy() + used_headers.extend(self._skip_auto_headers) # type: ignore[arg-type] + else: + # Fast path when there are no headers to skip + # which is the most common case. + used_headers = self.headers + + for hdr, val in self.DEFAULT_HEADERS.items(): + if hdr not in used_headers: + self.headers[hdr] = val + + if hdrs.USER_AGENT not in used_headers: + self.headers[hdrs.USER_AGENT] = SERVER_SOFTWARE + + def update_cookies(self, cookies: Optional[LooseCookies]) -> None: + """Update request cookies header.""" + if not cookies: + return + + c = SimpleCookie() + if hdrs.COOKIE in self.headers: + # parse_cookie_header for RFC 6265 compliant Cookie header parsing + c.update(parse_cookie_header(self.headers.get(hdrs.COOKIE, ""))) + del self.headers[hdrs.COOKIE] + + if isinstance(cookies, Mapping): + iter_cookies = cookies.items() + else: + iter_cookies = cookies # type: ignore[assignment] + for name, value in iter_cookies: + if isinstance(value, Morsel): + # Use helper to preserve coded_value exactly as sent by server + c[name] = preserve_morsel_with_coded_value(value) + else: + c[name] = value # type: ignore[assignment] + + self.headers[hdrs.COOKIE] = c.output(header="", sep=";").strip() + + def update_content_encoding(self, data: Any) -> None: + """Set request content encoding.""" + if not data: + # Don't compress an empty body. + self.compress = None + return + + if self.headers.get(hdrs.CONTENT_ENCODING): + if self.compress: + raise ValueError( + "compress can not be set if Content-Encoding header is set" + ) + elif self.compress: + if not isinstance(self.compress, str): + self.compress = "deflate" + self.headers[hdrs.CONTENT_ENCODING] = self.compress + self.chunked = True # enable chunked, no need to deal with length + + def update_transfer_encoding(self) -> None: + """Analyze transfer-encoding header.""" + te = self.headers.get(hdrs.TRANSFER_ENCODING, "").lower() + + if "chunked" in te: + if self.chunked: + raise ValueError( + "chunked can not be set " + 'if "Transfer-Encoding: chunked" header is set' + ) + + elif self.chunked: + if hdrs.CONTENT_LENGTH in self.headers: + raise ValueError( + "chunked can not be set if Content-Length header is set" + ) + + self.headers[hdrs.TRANSFER_ENCODING] = "chunked" + + def update_auth(self, auth: Optional[BasicAuth], trust_env: bool = False) -> None: + """Set basic auth.""" + if auth is None: + auth = self.auth + if auth is None: + return + + if not isinstance(auth, helpers.BasicAuth): + raise TypeError("BasicAuth() tuple is required instead") + + self.headers[hdrs.AUTHORIZATION] = auth.encode() + + def update_body_from_data(self, body: Any, _stacklevel: int = 3) -> None: + """Update request body from data.""" + if self._body is not None: + _warn_if_unclosed_payload(self._body, stacklevel=_stacklevel) + + if body is None: + self._body = None + # Set Content-Length to 0 when body is None for methods that expect a body + if ( + self.method not in self.GET_METHODS + and not self.chunked + and hdrs.CONTENT_LENGTH not in self.headers + ): + self.headers[hdrs.CONTENT_LENGTH] = "0" + return + + # FormData + maybe_payload = body() if isinstance(body, FormData) else body + + try: + body_payload = payload.PAYLOAD_REGISTRY.get(maybe_payload, disposition=None) + except payload.LookupError: + body_payload = FormData(maybe_payload)() # type: ignore[arg-type] + + self._body = body_payload + # enable chunked encoding if needed + if not self.chunked and hdrs.CONTENT_LENGTH not in self.headers: + if (size := body_payload.size) is not None: + self.headers[hdrs.CONTENT_LENGTH] = str(size) + else: + self.chunked = True + + # copy payload headers + assert body_payload.headers + headers = self.headers + skip_headers = self._skip_auto_headers + for key, value in body_payload.headers.items(): + if key in headers or (skip_headers is not None and key in skip_headers): + continue + headers[key] = value + + def _update_body(self, body: Any) -> None: + """Update request body after its already been set.""" + # Remove existing Content-Length header since body is changing + if hdrs.CONTENT_LENGTH in self.headers: + del self.headers[hdrs.CONTENT_LENGTH] + + # Remove existing Transfer-Encoding header to avoid conflicts + if self.chunked and hdrs.TRANSFER_ENCODING in self.headers: + del self.headers[hdrs.TRANSFER_ENCODING] + + # Now update the body using the existing method + # Called from _update_body, add 1 to stacklevel from caller + self.update_body_from_data(body, _stacklevel=4) + + # Update transfer encoding headers if needed (same logic as __init__) + if body is not None or self.method not in self.GET_METHODS: + self.update_transfer_encoding() + + async def update_body(self, body: Any) -> None: + """ + Update request body and close previous payload if needed. + + This method safely updates the request body by first closing any existing + payload to prevent resource leaks, then setting the new body. + + IMPORTANT: Always use this method instead of setting request.body directly. + Direct assignment to request.body will leak resources if the previous body + contains file handles, streams, or other resources that need cleanup. + + Args: + body: The new body content. Can be: + - bytes/bytearray: Raw binary data + - str: Text data (will be encoded using charset from Content-Type) + - FormData: Form data that will be encoded as multipart/form-data + - Payload: A pre-configured payload object + - AsyncIterable: An async iterable of bytes chunks + - File-like object: Will be read and sent as binary data + - None: Clears the body + + Usage: + # CORRECT: Use update_body + await request.update_body(b"new request data") + + # WRONG: Don't set body directly + # request.body = b"new request data" # This will leak resources! + + # Update with form data + form_data = FormData() + form_data.add_field('field', 'value') + await request.update_body(form_data) + + # Clear body + await request.update_body(None) + + Note: + This method is async because it may need to close file handles or + other resources associated with the previous payload. Always await + this method to ensure proper cleanup. + + Warning: + Setting request.body directly is highly discouraged and can lead to: + - Resource leaks (unclosed file handles, streams) + - Memory leaks (unreleased buffers) + - Unexpected behavior with streaming payloads + + It is not recommended to change the payload type in middleware. If the + body was already set (e.g., as bytes), it's best to keep the same type + rather than converting it (e.g., to str) as this may result in unexpected + behavior. + + See Also: + - update_body_from_data: Synchronous body update without cleanup + - body property: Direct body access (STRONGLY DISCOURAGED) + + """ + # Close existing payload if it exists and needs closing + if self._body is not None: + await self._body.close() + self._update_body(body) + + def update_expect_continue(self, expect: bool = False) -> None: + if expect: + self.headers[hdrs.EXPECT] = "100-continue" + elif ( + hdrs.EXPECT in self.headers + and self.headers[hdrs.EXPECT].lower() == "100-continue" + ): + expect = True + + if expect: + self._continue = self.loop.create_future() + + def update_proxy( + self, + proxy: Optional[URL], + proxy_auth: Optional[BasicAuth], + proxy_headers: Optional[LooseHeaders], + ) -> None: + self.proxy = proxy + if proxy is None: + self.proxy_auth = None + self.proxy_headers = None + return + + if proxy_auth and not isinstance(proxy_auth, helpers.BasicAuth): + raise ValueError("proxy_auth must be None or BasicAuth() tuple") + self.proxy_auth = proxy_auth + + if proxy_headers is not None and not isinstance( + proxy_headers, (MultiDict, MultiDictProxy) + ): + proxy_headers = CIMultiDict(proxy_headers) + self.proxy_headers = proxy_headers + + async def write_bytes( + self, + writer: AbstractStreamWriter, + conn: "Connection", + content_length: Optional[int] = None, + ) -> None: + """ + Write the request body to the connection stream. + + This method handles writing different types of request bodies: + 1. Payload objects (using their specialized write_with_length method) + 2. Bytes/bytearray objects + 3. Iterable body content + + Args: + writer: The stream writer to write the body to + conn: The connection being used for this request + content_length: Optional maximum number of bytes to write from the body + (None means write the entire body) + + The method properly handles: + - Waiting for 100-Continue responses if required + - Content length constraints for chunked encoding + - Error handling for network issues, cancellation, and other exceptions + - Signaling EOF and timeout management + + Raises: + ClientOSError: When there's an OS-level error writing the body + ClientConnectionError: When there's a general connection error + asyncio.CancelledError: When the operation is cancelled + + """ + # 100 response + if self._continue is not None: + # Force headers to be sent before waiting for 100-continue + writer.send_headers() + await writer.drain() + await self._continue + + protocol = conn.protocol + assert protocol is not None + try: + # This should be a rare case but the + # self._body can be set to None while + # the task is being started or we wait above + # for the 100-continue response. + # The more likely case is we have an empty + # payload, but 100-continue is still expected. + if self._body is not None: + await self._body.write_with_length(writer, content_length) + except OSError as underlying_exc: + reraised_exc = underlying_exc + + # Distinguish between timeout and other OS errors for better error reporting + exc_is_not_timeout = underlying_exc.errno is not None or not isinstance( + underlying_exc, asyncio.TimeoutError + ) + if exc_is_not_timeout: + reraised_exc = ClientOSError( + underlying_exc.errno, + f"Can not write request body for {self.url !s}", + ) + + set_exception(protocol, reraised_exc, underlying_exc) + except asyncio.CancelledError: + # Body hasn't been fully sent, so connection can't be reused + conn.close() + raise + except Exception as underlying_exc: + set_exception( + protocol, + ClientConnectionError( + "Failed to send bytes into the underlying connection " + f"{conn !s}: {underlying_exc!r}", + ), + underlying_exc, + ) + else: + # Successfully wrote the body, signal EOF and start response timeout + await writer.write_eof() + protocol.start_timeout() + + async def send(self, conn: "Connection") -> "ClientResponse": + # Specify request target: + # - CONNECT request must send authority form URI + # - not CONNECT proxy must send absolute form URI + # - most common is origin form URI + if self.method == hdrs.METH_CONNECT: + connect_host = self.url.host_subcomponent + assert connect_host is not None + path = f"{connect_host}:{self.url.port}" + elif self.proxy and not self.is_ssl(): + path = str(self.url) + else: + path = self.url.raw_path_qs + + protocol = conn.protocol + assert protocol is not None + writer = StreamWriter( + protocol, + self.loop, + on_chunk_sent=( + functools.partial(self._on_chunk_request_sent, self.method, self.url) + if self._traces + else None + ), + on_headers_sent=( + functools.partial(self._on_headers_request_sent, self.method, self.url) + if self._traces + else None + ), + ) + + if self.compress: + writer.enable_compression(self.compress) # type: ignore[arg-type] + + if self.chunked is not None: + writer.enable_chunking() + + # set default content-type + if ( + self.method in self.POST_METHODS + and ( + self._skip_auto_headers is None + or hdrs.CONTENT_TYPE not in self._skip_auto_headers + ) + and hdrs.CONTENT_TYPE not in self.headers + ): + self.headers[hdrs.CONTENT_TYPE] = "application/octet-stream" + + v = self.version + if hdrs.CONNECTION not in self.headers: + if conn._connector.force_close: + if v == HttpVersion11: + self.headers[hdrs.CONNECTION] = "close" + elif v == HttpVersion10: + self.headers[hdrs.CONNECTION] = "keep-alive" + + # status + headers + status_line = f"{self.method} {path} HTTP/{v.major}.{v.minor}" + + # Buffer headers for potential coalescing with body + await writer.write_headers(status_line, self.headers) + + task: Optional["asyncio.Task[None]"] + if self._body or self._continue is not None or protocol.writing_paused: + coro = self.write_bytes(writer, conn, self._get_content_length()) + if sys.version_info >= (3, 12): + # Optimization for Python 3.12, try to write + # bytes immediately to avoid having to schedule + # the task on the event loop. + task = asyncio.Task(coro, loop=self.loop, eager_start=True) + else: + task = self.loop.create_task(coro) + if task.done(): + task = None + else: + self._writer = task + else: + # We have nothing to write because + # - there is no body + # - the protocol does not have writing paused + # - we are not waiting for a 100-continue response + protocol.start_timeout() + writer.set_eof() + task = None + response_class = self.response_class + assert response_class is not None + self.response = response_class( + self.method, + self.original_url, + writer=task, + continue100=self._continue, + timer=self._timer, + request_info=self.request_info, + traces=self._traces, + loop=self.loop, + session=self._session, + ) + return self.response + + async def close(self) -> None: + if self.__writer is not None: + try: + await self.__writer + except asyncio.CancelledError: + if ( + sys.version_info >= (3, 11) + and (task := asyncio.current_task()) + and task.cancelling() + ): + raise + + def terminate(self) -> None: + if self.__writer is not None: + if not self.loop.is_closed(): + self.__writer.cancel() + self.__writer.remove_done_callback(self.__reset_writer) + self.__writer = None + + async def _on_chunk_request_sent(self, method: str, url: URL, chunk: bytes) -> None: + for trace in self._traces: + await trace.send_request_chunk_sent(method, url, chunk) + + async def _on_headers_request_sent( + self, method: str, url: URL, headers: "CIMultiDict[str]" + ) -> None: + for trace in self._traces: + await trace.send_request_headers(method, url, headers) diff --git a/env/lib/python3.12/site-packages/aiohttp/client_ws.py b/env/lib/python3.12/site-packages/aiohttp/client_ws.py new file mode 100644 index 0000000..daa57d1 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/client_ws.py @@ -0,0 +1,428 @@ +"""WebSocket client for asyncio.""" + +import asyncio +import sys +from types import TracebackType +from typing import Any, Optional, Type, cast + +import attr + +from ._websocket.reader import WebSocketDataQueue +from .client_exceptions import ClientError, ServerTimeoutError, WSMessageTypeError +from .client_reqrep import ClientResponse +from .helpers import calculate_timeout_when, set_result +from .http import ( + WS_CLOSED_MESSAGE, + WS_CLOSING_MESSAGE, + WebSocketError, + WSCloseCode, + WSMessage, + WSMsgType, +) +from .http_websocket import _INTERNAL_RECEIVE_TYPES, WebSocketWriter +from .streams import EofStream +from .typedefs import ( + DEFAULT_JSON_DECODER, + DEFAULT_JSON_ENCODER, + JSONDecoder, + JSONEncoder, +) + +if sys.version_info >= (3, 11): + import asyncio as async_timeout +else: + import async_timeout + + +@attr.s(frozen=True, slots=True) +class ClientWSTimeout: + ws_receive = attr.ib(type=Optional[float], default=None) + ws_close = attr.ib(type=Optional[float], default=None) + + +DEFAULT_WS_CLIENT_TIMEOUT = ClientWSTimeout(ws_receive=None, ws_close=10.0) + + +class ClientWebSocketResponse: + def __init__( + self, + reader: WebSocketDataQueue, + writer: WebSocketWriter, + protocol: Optional[str], + response: ClientResponse, + timeout: ClientWSTimeout, + autoclose: bool, + autoping: bool, + loop: asyncio.AbstractEventLoop, + *, + heartbeat: Optional[float] = None, + compress: int = 0, + client_notakeover: bool = False, + ) -> None: + self._response = response + self._conn = response.connection + + self._writer = writer + self._reader = reader + self._protocol = protocol + self._closed = False + self._closing = False + self._close_code: Optional[int] = None + self._timeout = timeout + self._autoclose = autoclose + self._autoping = autoping + self._heartbeat = heartbeat + self._heartbeat_cb: Optional[asyncio.TimerHandle] = None + self._heartbeat_when: float = 0.0 + if heartbeat is not None: + self._pong_heartbeat = heartbeat / 2.0 + self._pong_response_cb: Optional[asyncio.TimerHandle] = None + self._loop = loop + self._waiting: bool = False + self._close_wait: Optional[asyncio.Future[None]] = None + self._exception: Optional[BaseException] = None + self._compress = compress + self._client_notakeover = client_notakeover + self._ping_task: Optional[asyncio.Task[None]] = None + + self._reset_heartbeat() + + def _cancel_heartbeat(self) -> None: + self._cancel_pong_response_cb() + if self._heartbeat_cb is not None: + self._heartbeat_cb.cancel() + self._heartbeat_cb = None + if self._ping_task is not None: + self._ping_task.cancel() + self._ping_task = None + + def _cancel_pong_response_cb(self) -> None: + if self._pong_response_cb is not None: + self._pong_response_cb.cancel() + self._pong_response_cb = None + + def _reset_heartbeat(self) -> None: + if self._heartbeat is None: + return + self._cancel_pong_response_cb() + loop = self._loop + assert loop is not None + conn = self._conn + timeout_ceil_threshold = ( + conn._connector._timeout_ceil_threshold if conn is not None else 5 + ) + now = loop.time() + when = calculate_timeout_when(now, self._heartbeat, timeout_ceil_threshold) + self._heartbeat_when = when + if self._heartbeat_cb is None: + # We do not cancel the previous heartbeat_cb here because + # it generates a significant amount of TimerHandle churn + # which causes asyncio to rebuild the heap frequently. + # Instead _send_heartbeat() will reschedule the next + # heartbeat if it fires too early. + self._heartbeat_cb = loop.call_at(when, self._send_heartbeat) + + def _send_heartbeat(self) -> None: + self._heartbeat_cb = None + loop = self._loop + now = loop.time() + if now < self._heartbeat_when: + # Heartbeat fired too early, reschedule + self._heartbeat_cb = loop.call_at( + self._heartbeat_when, self._send_heartbeat + ) + return + + conn = self._conn + timeout_ceil_threshold = ( + conn._connector._timeout_ceil_threshold if conn is not None else 5 + ) + when = calculate_timeout_when(now, self._pong_heartbeat, timeout_ceil_threshold) + self._cancel_pong_response_cb() + self._pong_response_cb = loop.call_at(when, self._pong_not_received) + + coro = self._writer.send_frame(b"", WSMsgType.PING) + if sys.version_info >= (3, 12): + # Optimization for Python 3.12, try to send the ping + # immediately to avoid having to schedule + # the task on the event loop. + ping_task = asyncio.Task(coro, loop=loop, eager_start=True) + else: + ping_task = loop.create_task(coro) + + if not ping_task.done(): + self._ping_task = ping_task + ping_task.add_done_callback(self._ping_task_done) + else: + self._ping_task_done(ping_task) + + def _ping_task_done(self, task: "asyncio.Task[None]") -> None: + """Callback for when the ping task completes.""" + if not task.cancelled() and (exc := task.exception()): + self._handle_ping_pong_exception(exc) + self._ping_task = None + + def _pong_not_received(self) -> None: + self._handle_ping_pong_exception( + ServerTimeoutError(f"No PONG received after {self._pong_heartbeat} seconds") + ) + + def _handle_ping_pong_exception(self, exc: BaseException) -> None: + """Handle exceptions raised during ping/pong processing.""" + if self._closed: + return + self._set_closed() + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + self._exception = exc + self._response.close() + if self._waiting and not self._closing: + self._reader.feed_data(WSMessage(WSMsgType.ERROR, exc, None), 0) + + def _set_closed(self) -> None: + """Set the connection to closed. + + Cancel any heartbeat timers and set the closed flag. + """ + self._closed = True + self._cancel_heartbeat() + + def _set_closing(self) -> None: + """Set the connection to closing. + + Cancel any heartbeat timers and set the closing flag. + """ + self._closing = True + self._cancel_heartbeat() + + @property + def closed(self) -> bool: + return self._closed + + @property + def close_code(self) -> Optional[int]: + return self._close_code + + @property + def protocol(self) -> Optional[str]: + return self._protocol + + @property + def compress(self) -> int: + return self._compress + + @property + def client_notakeover(self) -> bool: + return self._client_notakeover + + def get_extra_info(self, name: str, default: Any = None) -> Any: + """extra info from connection transport""" + conn = self._response.connection + if conn is None: + return default + transport = conn.transport + if transport is None: + return default + return transport.get_extra_info(name, default) + + def exception(self) -> Optional[BaseException]: + return self._exception + + async def ping(self, message: bytes = b"") -> None: + await self._writer.send_frame(message, WSMsgType.PING) + + async def pong(self, message: bytes = b"") -> None: + await self._writer.send_frame(message, WSMsgType.PONG) + + async def send_frame( + self, message: bytes, opcode: WSMsgType, compress: Optional[int] = None + ) -> None: + """Send a frame over the websocket.""" + await self._writer.send_frame(message, opcode, compress) + + async def send_str(self, data: str, compress: Optional[int] = None) -> None: + if not isinstance(data, str): + raise TypeError("data argument must be str (%r)" % type(data)) + await self._writer.send_frame( + data.encode("utf-8"), WSMsgType.TEXT, compress=compress + ) + + async def send_bytes(self, data: bytes, compress: Optional[int] = None) -> None: + if not isinstance(data, (bytes, bytearray, memoryview)): + raise TypeError("data argument must be byte-ish (%r)" % type(data)) + await self._writer.send_frame(data, WSMsgType.BINARY, compress=compress) + + async def send_json( + self, + data: Any, + compress: Optional[int] = None, + *, + dumps: JSONEncoder = DEFAULT_JSON_ENCODER, + ) -> None: + await self.send_str(dumps(data), compress=compress) + + async def close(self, *, code: int = WSCloseCode.OK, message: bytes = b"") -> bool: + # we need to break `receive()` cycle first, + # `close()` may be called from different task + if self._waiting and not self._closing: + assert self._loop is not None + self._close_wait = self._loop.create_future() + self._set_closing() + self._reader.feed_data(WS_CLOSING_MESSAGE, 0) + await self._close_wait + + if self._closed: + return False + + self._set_closed() + try: + await self._writer.close(code, message) + except asyncio.CancelledError: + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + self._response.close() + raise + except Exception as exc: + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + self._exception = exc + self._response.close() + return True + + if self._close_code: + self._response.close() + return True + + while True: + try: + async with async_timeout.timeout(self._timeout.ws_close): + msg = await self._reader.read() + except asyncio.CancelledError: + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + self._response.close() + raise + except Exception as exc: + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + self._exception = exc + self._response.close() + return True + + if msg.type is WSMsgType.CLOSE: + self._close_code = msg.data + self._response.close() + return True + + async def receive(self, timeout: Optional[float] = None) -> WSMessage: + receive_timeout = timeout or self._timeout.ws_receive + + while True: + if self._waiting: + raise RuntimeError("Concurrent call to receive() is not allowed") + + if self._closed: + return WS_CLOSED_MESSAGE + elif self._closing: + await self.close() + return WS_CLOSED_MESSAGE + + try: + self._waiting = True + try: + if receive_timeout: + # Entering the context manager and creating + # Timeout() object can take almost 50% of the + # run time in this loop so we avoid it if + # there is no read timeout. + async with async_timeout.timeout(receive_timeout): + msg = await self._reader.read() + else: + msg = await self._reader.read() + self._reset_heartbeat() + finally: + self._waiting = False + if self._close_wait: + set_result(self._close_wait, None) + except (asyncio.CancelledError, asyncio.TimeoutError): + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + raise + except EofStream: + self._close_code = WSCloseCode.OK + await self.close() + return WSMessage(WSMsgType.CLOSED, None, None) + except ClientError: + # Likely ServerDisconnectedError when connection is lost + self._set_closed() + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + return WS_CLOSED_MESSAGE + except WebSocketError as exc: + self._close_code = exc.code + await self.close(code=exc.code) + return WSMessage(WSMsgType.ERROR, exc, None) + except Exception as exc: + self._exception = exc + self._set_closing() + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + await self.close() + return WSMessage(WSMsgType.ERROR, exc, None) + + if msg.type not in _INTERNAL_RECEIVE_TYPES: + # If its not a close/closing/ping/pong message + # we can return it immediately + return msg + + if msg.type is WSMsgType.CLOSE: + self._set_closing() + self._close_code = msg.data + if not self._closed and self._autoclose: + await self.close() + elif msg.type is WSMsgType.CLOSING: + self._set_closing() + elif msg.type is WSMsgType.PING and self._autoping: + await self.pong(msg.data) + continue + elif msg.type is WSMsgType.PONG and self._autoping: + continue + + return msg + + async def receive_str(self, *, timeout: Optional[float] = None) -> str: + msg = await self.receive(timeout) + if msg.type is not WSMsgType.TEXT: + raise WSMessageTypeError( + f"Received message {msg.type}:{msg.data!r} is not WSMsgType.TEXT" + ) + return cast(str, msg.data) + + async def receive_bytes(self, *, timeout: Optional[float] = None) -> bytes: + msg = await self.receive(timeout) + if msg.type is not WSMsgType.BINARY: + raise WSMessageTypeError( + f"Received message {msg.type}:{msg.data!r} is not WSMsgType.BINARY" + ) + return cast(bytes, msg.data) + + async def receive_json( + self, + *, + loads: JSONDecoder = DEFAULT_JSON_DECODER, + timeout: Optional[float] = None, + ) -> Any: + data = await self.receive_str(timeout=timeout) + return loads(data) + + def __aiter__(self) -> "ClientWebSocketResponse": + return self + + async def __anext__(self) -> WSMessage: + msg = await self.receive() + if msg.type in (WSMsgType.CLOSE, WSMsgType.CLOSING, WSMsgType.CLOSED): + raise StopAsyncIteration + return msg + + async def __aenter__(self) -> "ClientWebSocketResponse": + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + await self.close() diff --git a/env/lib/python3.12/site-packages/aiohttp/compression_utils.py b/env/lib/python3.12/site-packages/aiohttp/compression_utils.py new file mode 100644 index 0000000..e478d24 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/compression_utils.py @@ -0,0 +1,348 @@ +import asyncio +import sys +import zlib +from abc import ABC, abstractmethod +from concurrent.futures import Executor +from typing import Any, Final, Optional, Protocol, TypedDict, cast + +if sys.version_info >= (3, 12): + from collections.abc import Buffer +else: + from typing import Union + + Buffer = Union[bytes, bytearray, "memoryview[int]", "memoryview[bytes]"] + +try: + try: + import brotlicffi as brotli + except ImportError: + import brotli + + HAS_BROTLI = True +except ImportError: # pragma: no cover + HAS_BROTLI = False + +try: + if sys.version_info >= (3, 14): + from compression.zstd import ZstdDecompressor # noqa: I900 + else: # TODO(PY314): Remove mentions of backports.zstd across codebase + from backports.zstd import ZstdDecompressor + + HAS_ZSTD = True +except ImportError: + HAS_ZSTD = False + + +MAX_SYNC_CHUNK_SIZE = 4096 +DEFAULT_MAX_DECOMPRESS_SIZE = 2**25 # 32MiB + +# Unlimited decompression constants - different libraries use different conventions +ZLIB_MAX_LENGTH_UNLIMITED = 0 # zlib uses 0 to mean unlimited +ZSTD_MAX_LENGTH_UNLIMITED = -1 # zstd uses -1 to mean unlimited + + +class ZLibCompressObjProtocol(Protocol): + def compress(self, data: Buffer) -> bytes: ... + def flush(self, mode: int = ..., /) -> bytes: ... + + +class ZLibDecompressObjProtocol(Protocol): + def decompress(self, data: Buffer, max_length: int = ...) -> bytes: ... + def flush(self, length: int = ..., /) -> bytes: ... + + @property + def eof(self) -> bool: ... + + +class ZLibBackendProtocol(Protocol): + MAX_WBITS: int + Z_FULL_FLUSH: int + Z_SYNC_FLUSH: int + Z_BEST_SPEED: int + Z_FINISH: int + + def compressobj( + self, + level: int = ..., + method: int = ..., + wbits: int = ..., + memLevel: int = ..., + strategy: int = ..., + zdict: Optional[Buffer] = ..., + ) -> ZLibCompressObjProtocol: ... + def decompressobj( + self, wbits: int = ..., zdict: Buffer = ... + ) -> ZLibDecompressObjProtocol: ... + + def compress( + self, data: Buffer, /, level: int = ..., wbits: int = ... + ) -> bytes: ... + def decompress( + self, data: Buffer, /, wbits: int = ..., bufsize: int = ... + ) -> bytes: ... + + +class CompressObjArgs(TypedDict, total=False): + wbits: int + strategy: int + level: int + + +class ZLibBackendWrapper: + def __init__(self, _zlib_backend: ZLibBackendProtocol): + self._zlib_backend: ZLibBackendProtocol = _zlib_backend + + @property + def name(self) -> str: + return getattr(self._zlib_backend, "__name__", "undefined") + + @property + def MAX_WBITS(self) -> int: + return self._zlib_backend.MAX_WBITS + + @property + def Z_FULL_FLUSH(self) -> int: + return self._zlib_backend.Z_FULL_FLUSH + + @property + def Z_SYNC_FLUSH(self) -> int: + return self._zlib_backend.Z_SYNC_FLUSH + + @property + def Z_BEST_SPEED(self) -> int: + return self._zlib_backend.Z_BEST_SPEED + + @property + def Z_FINISH(self) -> int: + return self._zlib_backend.Z_FINISH + + def compressobj(self, *args: Any, **kwargs: Any) -> ZLibCompressObjProtocol: + return self._zlib_backend.compressobj(*args, **kwargs) + + def decompressobj(self, *args: Any, **kwargs: Any) -> ZLibDecompressObjProtocol: + return self._zlib_backend.decompressobj(*args, **kwargs) + + def compress(self, data: Buffer, *args: Any, **kwargs: Any) -> bytes: + return self._zlib_backend.compress(data, *args, **kwargs) + + def decompress(self, data: Buffer, *args: Any, **kwargs: Any) -> bytes: + return self._zlib_backend.decompress(data, *args, **kwargs) + + # Everything not explicitly listed in the Protocol we just pass through + def __getattr__(self, attrname: str) -> Any: + return getattr(self._zlib_backend, attrname) + + +ZLibBackend: ZLibBackendWrapper = ZLibBackendWrapper(zlib) + + +def set_zlib_backend(new_zlib_backend: ZLibBackendProtocol) -> None: + ZLibBackend._zlib_backend = new_zlib_backend + + +def encoding_to_mode( + encoding: Optional[str] = None, + suppress_deflate_header: bool = False, +) -> int: + if encoding == "gzip": + return 16 + ZLibBackend.MAX_WBITS + + return -ZLibBackend.MAX_WBITS if suppress_deflate_header else ZLibBackend.MAX_WBITS + + +class DecompressionBaseHandler(ABC): + def __init__( + self, + executor: Optional[Executor] = None, + max_sync_chunk_size: Optional[int] = MAX_SYNC_CHUNK_SIZE, + ): + """Base class for decompression handlers.""" + self._executor = executor + self._max_sync_chunk_size = max_sync_chunk_size + + @abstractmethod + def decompress_sync( + self, data: bytes, max_length: int = ZLIB_MAX_LENGTH_UNLIMITED + ) -> bytes: + """Decompress the given data.""" + + async def decompress( + self, data: bytes, max_length: int = ZLIB_MAX_LENGTH_UNLIMITED + ) -> bytes: + """Decompress the given data.""" + if ( + self._max_sync_chunk_size is not None + and len(data) > self._max_sync_chunk_size + ): + return await asyncio.get_event_loop().run_in_executor( + self._executor, self.decompress_sync, data, max_length + ) + return self.decompress_sync(data, max_length) + + +class ZLibCompressor: + def __init__( + self, + encoding: Optional[str] = None, + suppress_deflate_header: bool = False, + level: Optional[int] = None, + wbits: Optional[int] = None, + strategy: Optional[int] = None, + executor: Optional[Executor] = None, + max_sync_chunk_size: Optional[int] = MAX_SYNC_CHUNK_SIZE, + ): + self._executor = executor + self._max_sync_chunk_size = max_sync_chunk_size + self._mode = ( + encoding_to_mode(encoding, suppress_deflate_header) + if wbits is None + else wbits + ) + self._zlib_backend: Final = ZLibBackendWrapper(ZLibBackend._zlib_backend) + + kwargs: CompressObjArgs = {} + kwargs["wbits"] = self._mode + if strategy is not None: + kwargs["strategy"] = strategy + if level is not None: + kwargs["level"] = level + self._compressor = self._zlib_backend.compressobj(**kwargs) + + def compress_sync(self, data: bytes) -> bytes: + return self._compressor.compress(data) + + async def compress(self, data: bytes) -> bytes: + """Compress the data and returned the compressed bytes. + + Note that flush() must be called after the last call to compress() + + If the data size is large than the max_sync_chunk_size, the compression + will be done in the executor. Otherwise, the compression will be done + in the event loop. + + **WARNING: This method is NOT cancellation-safe when used with flush().** + If this operation is cancelled, the compressor state may be corrupted. + The connection MUST be closed after cancellation to avoid data corruption + in subsequent compress operations. + + For cancellation-safe compression (e.g., WebSocket), the caller MUST wrap + compress() + flush() + send operations in a shield and lock to ensure atomicity. + """ + # For large payloads, offload compression to executor to avoid blocking event loop + should_use_executor = ( + self._max_sync_chunk_size is not None + and len(data) > self._max_sync_chunk_size + ) + if should_use_executor: + return await asyncio.get_running_loop().run_in_executor( + self._executor, self._compressor.compress, data + ) + return self.compress_sync(data) + + def flush(self, mode: Optional[int] = None) -> bytes: + """Flush the compressor synchronously. + + **WARNING: This method is NOT cancellation-safe when called after compress().** + The flush() operation accesses shared compressor state. If compress() was + cancelled, calling flush() may result in corrupted data. The connection MUST + be closed after compress() cancellation. + + For cancellation-safe compression (e.g., WebSocket), the caller MUST wrap + compress() + flush() + send operations in a shield and lock to ensure atomicity. + """ + return self._compressor.flush( + mode if mode is not None else self._zlib_backend.Z_FINISH + ) + + +class ZLibDecompressor(DecompressionBaseHandler): + def __init__( + self, + encoding: Optional[str] = None, + suppress_deflate_header: bool = False, + executor: Optional[Executor] = None, + max_sync_chunk_size: Optional[int] = MAX_SYNC_CHUNK_SIZE, + ): + super().__init__(executor=executor, max_sync_chunk_size=max_sync_chunk_size) + self._mode = encoding_to_mode(encoding, suppress_deflate_header) + self._zlib_backend: Final = ZLibBackendWrapper(ZLibBackend._zlib_backend) + self._decompressor = self._zlib_backend.decompressobj(wbits=self._mode) + + def decompress_sync( + self, data: Buffer, max_length: int = ZLIB_MAX_LENGTH_UNLIMITED + ) -> bytes: + return self._decompressor.decompress(data, max_length) + + def flush(self, length: int = 0) -> bytes: + return ( + self._decompressor.flush(length) + if length > 0 + else self._decompressor.flush() + ) + + @property + def eof(self) -> bool: + return self._decompressor.eof + + +class BrotliDecompressor(DecompressionBaseHandler): + # 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, + executor: Optional[Executor] = None, + max_sync_chunk_size: Optional[int] = MAX_SYNC_CHUNK_SIZE, + ) -> None: + """Decompress data using the Brotli library.""" + if not HAS_BROTLI: + raise RuntimeError( + "The brotli decompression is not available. " + "Please install `Brotli` module" + ) + self._obj = brotli.Decompressor() + super().__init__(executor=executor, max_sync_chunk_size=max_sync_chunk_size) + + def decompress_sync( + self, data: Buffer, max_length: int = ZLIB_MAX_LENGTH_UNLIMITED + ) -> bytes: + """Decompress the given data.""" + if hasattr(self._obj, "decompress"): + return cast(bytes, self._obj.decompress(data, max_length)) + return cast(bytes, self._obj.process(data, max_length)) + + def flush(self) -> bytes: + """Flush the decompressor.""" + if hasattr(self._obj, "flush"): + return cast(bytes, self._obj.flush()) + return b"" + + +class ZSTDDecompressor(DecompressionBaseHandler): + def __init__( + self, + executor: Optional[Executor] = None, + max_sync_chunk_size: Optional[int] = MAX_SYNC_CHUNK_SIZE, + ) -> None: + if not HAS_ZSTD: + raise RuntimeError( + "The zstd decompression is not available. " + "Please install `backports.zstd` module" + ) + self._obj = ZstdDecompressor() + super().__init__(executor=executor, max_sync_chunk_size=max_sync_chunk_size) + + def decompress_sync( + self, data: bytes, max_length: int = ZLIB_MAX_LENGTH_UNLIMITED + ) -> bytes: + # zstd uses -1 for unlimited, while zlib uses 0 for unlimited + # Convert the zlib convention (0=unlimited) to zstd convention (-1=unlimited) + zstd_max_length = ( + ZSTD_MAX_LENGTH_UNLIMITED + if max_length == ZLIB_MAX_LENGTH_UNLIMITED + else max_length + ) + return self._obj.decompress(data, zstd_max_length) + + def flush(self) -> bytes: + return b"" diff --git a/env/lib/python3.12/site-packages/aiohttp/connector.py b/env/lib/python3.12/site-packages/aiohttp/connector.py new file mode 100644 index 0000000..290a424 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/connector.py @@ -0,0 +1,1842 @@ +import asyncio +import functools +import random +import socket +import sys +import traceback +import warnings +from collections import OrderedDict, defaultdict, deque +from contextlib import suppress +from http import HTTPStatus +from itertools import chain, cycle, islice +from time import monotonic +from types import TracebackType +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + DefaultDict, + Deque, + Dict, + Iterator, + List, + Literal, + Optional, + Sequence, + Set, + Tuple, + Type, + Union, + cast, +) + +import aiohappyeyeballs +from aiohappyeyeballs import AddrInfoType, SocketFactoryType + +from . import hdrs, helpers +from .abc import AbstractResolver, ResolveResult +from .client_exceptions import ( + ClientConnectionError, + ClientConnectorCertificateError, + ClientConnectorDNSError, + ClientConnectorError, + ClientConnectorSSLError, + ClientHttpProxyError, + ClientProxyConnectionError, + ServerFingerprintMismatch, + UnixClientConnectorError, + cert_errors, + ssl_errors, +) +from .client_proto import ResponseHandler +from .client_reqrep import ClientRequest, Fingerprint, _merge_ssl_params +from .helpers import ( + _SENTINEL, + ceil_timeout, + is_ip_address, + noop, + sentinel, + set_exception, + set_result, +) +from .log import client_logger +from .resolver import DefaultResolver + +if sys.version_info >= (3, 12): + from collections.abc import Buffer +else: + Buffer = Union[bytes, bytearray, "memoryview[int]", "memoryview[bytes]"] + +if TYPE_CHECKING: + import ssl + + SSLContext = ssl.SSLContext +else: + try: + import ssl + + SSLContext = ssl.SSLContext + except ImportError: # pragma: no cover + ssl = None # type: ignore[assignment] + SSLContext = object # type: ignore[misc,assignment] + +EMPTY_SCHEMA_SET = frozenset({""}) +HTTP_SCHEMA_SET = frozenset({"http", "https"}) +WS_SCHEMA_SET = frozenset({"ws", "wss"}) + +HTTP_AND_EMPTY_SCHEMA_SET = HTTP_SCHEMA_SET | EMPTY_SCHEMA_SET +HIGH_LEVEL_SCHEMA_SET = HTTP_AND_EMPTY_SCHEMA_SET | WS_SCHEMA_SET + +NEEDS_CLEANUP_CLOSED = (3, 13, 0) <= sys.version_info < ( + 3, + 13, + 1, +) or sys.version_info < (3, 12, 7) +# Cleanup closed is no longer needed after https://github.com/python/cpython/pull/118960 +# which first appeared in Python 3.12.7 and 3.13.1 + + +__all__ = ( + "BaseConnector", + "TCPConnector", + "UnixConnector", + "NamedPipeConnector", + "AddrInfoType", + "SocketFactoryType", +) + + +if TYPE_CHECKING: + from .client import ClientTimeout + from .client_reqrep import ConnectionKey + from .tracing import Trace + + +class _DeprecationWaiter: + __slots__ = ("_awaitable", "_awaited") + + def __init__(self, awaitable: Awaitable[Any]) -> None: + self._awaitable = awaitable + self._awaited = False + + def __await__(self) -> Any: + self._awaited = True + return self._awaitable.__await__() + + def __del__(self) -> None: + if not self._awaited: + warnings.warn( + "Connector.close() is a coroutine, " + "please use await connector.close()", + DeprecationWarning, + ) + + +async def _wait_for_close(waiters: List[Awaitable[object]]) -> None: + """Wait for all waiters to finish closing.""" + results = await asyncio.gather(*waiters, return_exceptions=True) + for res in results: + if isinstance(res, Exception): + client_logger.debug("Error while closing connector: %r", res) + + +class Connection: + + _source_traceback = None + + def __init__( + self, + connector: "BaseConnector", + key: "ConnectionKey", + protocol: ResponseHandler, + loop: asyncio.AbstractEventLoop, + ) -> None: + self._key = key + self._connector = connector + self._loop = loop + self._protocol: Optional[ResponseHandler] = protocol + self._callbacks: List[Callable[[], None]] = [] + + if loop.get_debug(): + self._source_traceback = traceback.extract_stack(sys._getframe(1)) + + def __repr__(self) -> str: + return f"Connection<{self._key}>" + + def __del__(self, _warnings: Any = warnings) -> None: + if self._protocol is not None: + kwargs = {"source": self} + _warnings.warn(f"Unclosed connection {self!r}", ResourceWarning, **kwargs) + if self._loop.is_closed(): + return + + self._connector._release(self._key, self._protocol, should_close=True) + + context = {"client_connection": self, "message": "Unclosed connection"} + if self._source_traceback is not None: + context["source_traceback"] = self._source_traceback + self._loop.call_exception_handler(context) + + def __bool__(self) -> Literal[True]: + """Force subclasses to not be falsy, to make checks simpler.""" + return True + + @property + def loop(self) -> asyncio.AbstractEventLoop: + warnings.warn( + "connector.loop property is deprecated", DeprecationWarning, stacklevel=2 + ) + return self._loop + + @property + def transport(self) -> Optional[asyncio.Transport]: + if self._protocol is None: + return None + return self._protocol.transport + + @property + def protocol(self) -> Optional[ResponseHandler]: + return self._protocol + + def add_callback(self, callback: Callable[[], None]) -> None: + if callback is not None: + self._callbacks.append(callback) + + def _notify_release(self) -> None: + callbacks, self._callbacks = self._callbacks[:], [] + + for cb in callbacks: + with suppress(Exception): + cb() + + def close(self) -> None: + self._notify_release() + + if self._protocol is not None: + self._connector._release(self._key, self._protocol, should_close=True) + self._protocol = None + + def release(self) -> None: + self._notify_release() + + if self._protocol is not None: + self._connector._release(self._key, self._protocol) + self._protocol = None + + @property + def closed(self) -> bool: + return self._protocol is None or not self._protocol.is_connected() + + +class _ConnectTunnelConnection(Connection): + """Special connection wrapper for CONNECT tunnels that must never be pooled. + + This connection wraps the proxy connection that will be upgraded with TLS. + It must never be released to the pool because: + 1. Its 'closed' future will never complete, causing session.close() to hang + 2. It represents an intermediate state, not a reusable connection + 3. The real connection (with TLS) will be created separately + """ + + def release(self) -> None: + """Do nothing - don't pool or close the connection. + + These connections are an intermediate state during the CONNECT tunnel + setup and will be cleaned up naturally after the TLS upgrade. If they + were to be pooled, they would never be properly closed, causing + session.close() to wait forever for their 'closed' future. + """ + + +class _TransportPlaceholder: + """placeholder for BaseConnector.connect function""" + + __slots__ = ("closed", "transport") + + def __init__(self, closed_future: asyncio.Future[Optional[Exception]]) -> None: + """Initialize a placeholder for a transport.""" + self.closed = closed_future + self.transport = None + + def close(self) -> None: + """Close the placeholder.""" + + def abort(self) -> None: + """Abort the placeholder (does nothing).""" + + +class BaseConnector: + """Base connector class. + + keepalive_timeout - (optional) Keep-alive timeout. + force_close - Set to True to force close and do reconnect + after each request (and between redirects). + limit - The total number of simultaneous connections. + limit_per_host - Number of simultaneous connections to one host. + enable_cleanup_closed - Enables clean-up closed ssl transports. + Disabled by default. + timeout_ceil_threshold - Trigger ceiling of timeout values when + it's above timeout_ceil_threshold. + loop - Optional event loop. + """ + + _closed = True # prevent AttributeError in __del__ if ctor was failed + _source_traceback = None + + # abort transport after 2 seconds (cleanup broken connections) + _cleanup_closed_period = 2.0 + + allowed_protocol_schema_set = HIGH_LEVEL_SCHEMA_SET + + def __init__( + self, + *, + keepalive_timeout: Union[object, None, float] = sentinel, + force_close: bool = False, + limit: int = 100, + limit_per_host: int = 0, + enable_cleanup_closed: bool = False, + loop: Optional[asyncio.AbstractEventLoop] = None, + timeout_ceil_threshold: float = 5, + ) -> None: + + if force_close: + if keepalive_timeout is not None and keepalive_timeout is not sentinel: + raise ValueError( + "keepalive_timeout cannot be set if force_close is True" + ) + else: + if keepalive_timeout is sentinel: + keepalive_timeout = 15.0 + + loop = loop or asyncio.get_running_loop() + self._timeout_ceil_threshold = timeout_ceil_threshold + + self._closed = False + if loop.get_debug(): + self._source_traceback = traceback.extract_stack(sys._getframe(1)) + + # Connection pool of reusable connections. + # We use a deque to store connections because it has O(1) popleft() + # and O(1) append() operations to implement a FIFO queue. + self._conns: DefaultDict[ + ConnectionKey, Deque[Tuple[ResponseHandler, float]] + ] = defaultdict(deque) + self._limit = limit + self._limit_per_host = limit_per_host + self._acquired: Set[ResponseHandler] = set() + self._acquired_per_host: DefaultDict[ConnectionKey, Set[ResponseHandler]] = ( + defaultdict(set) + ) + self._keepalive_timeout = cast(float, keepalive_timeout) + self._force_close = force_close + + # {host_key: FIFO list of waiters} + # The FIFO is implemented with an OrderedDict with None keys because + # python does not have an ordered set. + self._waiters: DefaultDict[ + ConnectionKey, OrderedDict[asyncio.Future[None], None] + ] = defaultdict(OrderedDict) + + self._loop = loop + self._factory = functools.partial(ResponseHandler, loop=loop) + + # start keep-alive connection cleanup task + self._cleanup_handle: Optional[asyncio.TimerHandle] = None + + # start cleanup closed transports task + self._cleanup_closed_handle: Optional[asyncio.TimerHandle] = None + + if enable_cleanup_closed and not NEEDS_CLEANUP_CLOSED: + warnings.warn( + "enable_cleanup_closed ignored because " + "https://github.com/python/cpython/pull/118960 is fixed " + f"in Python version {sys.version_info}", + DeprecationWarning, + stacklevel=2, + ) + enable_cleanup_closed = False + + self._cleanup_closed_disabled = not enable_cleanup_closed + self._cleanup_closed_transports: List[Optional[asyncio.Transport]] = [] + self._placeholder_future: asyncio.Future[Optional[Exception]] = ( + loop.create_future() + ) + self._placeholder_future.set_result(None) + self._cleanup_closed() + + def __del__(self, _warnings: Any = warnings) -> None: + if self._closed: + return + if not self._conns: + return + + conns = [repr(c) for c in self._conns.values()] + + self._close() + + kwargs = {"source": self} + _warnings.warn(f"Unclosed connector {self!r}", ResourceWarning, **kwargs) + context = { + "connector": self, + "connections": conns, + "message": "Unclosed connector", + } + if self._source_traceback is not None: + context["source_traceback"] = self._source_traceback + self._loop.call_exception_handler(context) + + def __enter__(self) -> "BaseConnector": + warnings.warn( + '"with Connector():" is deprecated, ' + 'use "async with Connector():" instead', + DeprecationWarning, + ) + return self + + def __exit__(self, *exc: Any) -> None: + self._close() + + async def __aenter__(self) -> "BaseConnector": + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]] = None, + exc_value: Optional[BaseException] = None, + exc_traceback: Optional[TracebackType] = None, + ) -> None: + await self.close() + + @property + def force_close(self) -> bool: + """Ultimately close connection on releasing if True.""" + return self._force_close + + @property + def limit(self) -> int: + """The total number for simultaneous connections. + + If limit is 0 the connector has no limit. + The default limit size is 100. + """ + return self._limit + + @property + def limit_per_host(self) -> int: + """The limit for simultaneous connections to the same endpoint. + + Endpoints are the same if they are have equal + (host, port, is_ssl) triple. + """ + return self._limit_per_host + + def _cleanup(self) -> None: + """Cleanup unused transports.""" + if self._cleanup_handle: + self._cleanup_handle.cancel() + # _cleanup_handle should be unset, otherwise _release() will not + # recreate it ever! + self._cleanup_handle = None + + now = monotonic() + timeout = self._keepalive_timeout + + if self._conns: + connections = defaultdict(deque) + deadline = now - timeout + for key, conns in self._conns.items(): + alive: Deque[Tuple[ResponseHandler, float]] = deque() + for proto, use_time in conns: + if proto.is_connected() and use_time - deadline >= 0: + alive.append((proto, use_time)) + continue + transport = proto.transport + proto.close() + if not self._cleanup_closed_disabled and key.is_ssl: + self._cleanup_closed_transports.append(transport) + + if alive: + connections[key] = alive + + self._conns = connections + + if self._conns: + self._cleanup_handle = helpers.weakref_handle( + self, + "_cleanup", + timeout, + self._loop, + timeout_ceil_threshold=self._timeout_ceil_threshold, + ) + + def _cleanup_closed(self) -> None: + """Double confirmation for transport close. + + Some broken ssl servers may leave socket open without proper close. + """ + if self._cleanup_closed_handle: + self._cleanup_closed_handle.cancel() + + for transport in self._cleanup_closed_transports: + if transport is not None: + transport.abort() + + self._cleanup_closed_transports = [] + + if not self._cleanup_closed_disabled: + self._cleanup_closed_handle = helpers.weakref_handle( + self, + "_cleanup_closed", + self._cleanup_closed_period, + self._loop, + timeout_ceil_threshold=self._timeout_ceil_threshold, + ) + + def close(self, *, abort_ssl: bool = False) -> Awaitable[None]: + """Close all opened transports. + + :param abort_ssl: If True, SSL connections will be aborted immediately + without performing the shutdown handshake. This provides + faster cleanup at the cost of less graceful disconnection. + """ + if not (waiters := self._close(abort_ssl=abort_ssl)): + # If there are no connections to close, we can return a noop + # awaitable to avoid scheduling a task on the event loop. + return _DeprecationWaiter(noop()) + coro = _wait_for_close(waiters) + if sys.version_info >= (3, 12): + # Optimization for Python 3.12, try to close connections + # immediately to avoid having to schedule the task on the event loop. + task = asyncio.Task(coro, loop=self._loop, eager_start=True) + else: + task = self._loop.create_task(coro) + return _DeprecationWaiter(task) + + def _close(self, *, abort_ssl: bool = False) -> List[Awaitable[object]]: + waiters: List[Awaitable[object]] = [] + + if self._closed: + return waiters + + self._closed = True + + try: + if self._loop.is_closed(): + return waiters + + # cancel cleanup task + if self._cleanup_handle: + self._cleanup_handle.cancel() + + # cancel cleanup close task + if self._cleanup_closed_handle: + self._cleanup_closed_handle.cancel() + + for data in self._conns.values(): + for proto, _ in data: + if ( + abort_ssl + and proto.transport + and proto.transport.get_extra_info("sslcontext") is not None + ): + proto.abort() + else: + proto.close() + if closed := proto.closed: + waiters.append(closed) + + for proto in self._acquired: + if ( + abort_ssl + and proto.transport + and proto.transport.get_extra_info("sslcontext") is not None + ): + proto.abort() + else: + proto.close() + if closed := proto.closed: + waiters.append(closed) + + for transport in self._cleanup_closed_transports: + if transport is not None: + transport.abort() + + return waiters + + finally: + self._conns.clear() + self._acquired.clear() + for keyed_waiters in self._waiters.values(): + for keyed_waiter in keyed_waiters: + keyed_waiter.cancel() + self._waiters.clear() + self._cleanup_handle = None + self._cleanup_closed_transports.clear() + self._cleanup_closed_handle = None + + @property + def closed(self) -> bool: + """Is connector closed. + + A readonly property. + """ + return self._closed + + def _available_connections(self, key: "ConnectionKey") -> int: + """ + Return number of available connections. + + The limit, limit_per_host and the connection key are taken into account. + + If it returns less than 1 means that there are no connections + available. + """ + # check total available connections + # If there are no limits, this will always return 1 + total_remain = 1 + + if self._limit and (total_remain := self._limit - len(self._acquired)) <= 0: + return total_remain + + # check limit per host + if host_remain := self._limit_per_host: + if acquired := self._acquired_per_host.get(key): + host_remain -= len(acquired) + if total_remain > host_remain: + return host_remain + + return total_remain + + def _update_proxy_auth_header_and_build_proxy_req( + self, req: ClientRequest + ) -> ClientRequest: + """Set Proxy-Authorization header for non-SSL proxy requests and builds the proxy request for SSL proxy requests.""" + url = req.proxy + assert url is not None + headers: Dict[str, str] = {} + if req.proxy_headers is not None: + headers = req.proxy_headers # type: ignore[assignment] + headers[hdrs.HOST] = req.headers[hdrs.HOST] + proxy_req = ClientRequest( + hdrs.METH_GET, + url, + headers=headers, + auth=req.proxy_auth, + loop=self._loop, + ssl=req.ssl, + ) + auth = proxy_req.headers.pop(hdrs.AUTHORIZATION, None) + if auth is not None: + if not req.is_ssl(): + req.headers[hdrs.PROXY_AUTHORIZATION] = auth + else: + proxy_req.headers[hdrs.PROXY_AUTHORIZATION] = auth + return proxy_req + + async def connect( + self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout" + ) -> Connection: + """Get from pool or create new connection.""" + key = req.connection_key + if (conn := await self._get(key, traces)) is not None: + # If we do not have to wait and we can get a connection from the pool + # we can avoid the timeout ceil logic and directly return the connection + if req.proxy: + self._update_proxy_auth_header_and_build_proxy_req(req) + return conn + + async with ceil_timeout(timeout.connect, timeout.ceil_threshold): + if self._available_connections(key) <= 0: + await self._wait_for_available_connection(key, traces) + if (conn := await self._get(key, traces)) is not None: + if req.proxy: + self._update_proxy_auth_header_and_build_proxy_req(req) + return conn + + placeholder = cast( + ResponseHandler, _TransportPlaceholder(self._placeholder_future) + ) + self._acquired.add(placeholder) + if self._limit_per_host: + self._acquired_per_host[key].add(placeholder) + + try: + # Traces are done inside the try block to ensure that the + # that the placeholder is still cleaned up if an exception + # is raised. + if traces: + for trace in traces: + await trace.send_connection_create_start() + proto = await self._create_connection(req, traces, timeout) + if traces: + for trace in traces: + await trace.send_connection_create_end() + except BaseException: + self._release_acquired(key, placeholder) + raise + else: + if self._closed: + proto.close() + raise ClientConnectionError("Connector is closed.") + + # The connection was successfully created, drop the placeholder + # and add the real connection to the acquired set. There should + # be no awaits after the proto is added to the acquired set + # to ensure that the connection is not left in the acquired set + # on cancellation. + self._acquired.remove(placeholder) + self._acquired.add(proto) + if self._limit_per_host: + acquired_per_host = self._acquired_per_host[key] + acquired_per_host.remove(placeholder) + acquired_per_host.add(proto) + return Connection(self, key, proto, self._loop) + + async def _wait_for_available_connection( + self, key: "ConnectionKey", traces: List["Trace"] + ) -> None: + """Wait for an available connection slot.""" + # We loop here because there is a race between + # the connection limit check and the connection + # being acquired. If the connection is acquired + # between the check and the await statement, we + # need to loop again to check if the connection + # slot is still available. + attempts = 0 + while True: + fut: asyncio.Future[None] = self._loop.create_future() + keyed_waiters = self._waiters[key] + keyed_waiters[fut] = None + if attempts: + # If we have waited before, we need to move the waiter + # to the front of the queue as otherwise we might get + # starved and hit the timeout. + keyed_waiters.move_to_end(fut, last=False) + + try: + # Traces happen in the try block to ensure that the + # the waiter is still cleaned up if an exception is raised. + if traces: + for trace in traces: + await trace.send_connection_queued_start() + await fut + if traces: + for trace in traces: + await trace.send_connection_queued_end() + finally: + # pop the waiter from the queue if its still + # there and not already removed by _release_waiter + keyed_waiters.pop(fut, None) + if not self._waiters.get(key, True): + del self._waiters[key] + + if self._available_connections(key) > 0: + break + attempts += 1 + + async def _get( + self, key: "ConnectionKey", traces: List["Trace"] + ) -> Optional[Connection]: + """Get next reusable connection for the key or None. + + The connection will be marked as acquired. + """ + if (conns := self._conns.get(key)) is None: + return None + + t1 = monotonic() + while conns: + proto, t0 = conns.popleft() + # We will we reuse the connection if its connected and + # the keepalive timeout has not been exceeded + if proto.is_connected() and t1 - t0 <= self._keepalive_timeout: + if not conns: + # The very last connection was reclaimed: drop the key + del self._conns[key] + self._acquired.add(proto) + if self._limit_per_host: + self._acquired_per_host[key].add(proto) + if traces: + for trace in traces: + try: + await trace.send_connection_reuseconn() + except BaseException: + self._release_acquired(key, proto) + raise + return Connection(self, key, proto, self._loop) + + # Connection cannot be reused, close it + transport = proto.transport + proto.close() + # only for SSL transports + if not self._cleanup_closed_disabled and key.is_ssl: + self._cleanup_closed_transports.append(transport) + + # No more connections: drop the key + del self._conns[key] + return None + + def _release_waiter(self) -> None: + """ + Iterates over all waiters until one to be released is found. + + The one to be released is not finished and + belongs to a host that has available connections. + """ + if not self._waiters: + return + + # Having the dict keys ordered this avoids to iterate + # at the same order at each call. + queues = list(self._waiters) + random.shuffle(queues) + + for key in queues: + if self._available_connections(key) < 1: + continue + + waiters = self._waiters[key] + while waiters: + waiter, _ = waiters.popitem(last=False) + if not waiter.done(): + waiter.set_result(None) + return + + def _release_acquired(self, key: "ConnectionKey", proto: ResponseHandler) -> None: + """Release acquired connection.""" + if self._closed: + # acquired connection is already released on connector closing + return + + self._acquired.discard(proto) + if self._limit_per_host and (conns := self._acquired_per_host.get(key)): + conns.discard(proto) + if not conns: + del self._acquired_per_host[key] + self._release_waiter() + + def _release( + self, + key: "ConnectionKey", + protocol: ResponseHandler, + *, + should_close: bool = False, + ) -> None: + if self._closed: + # acquired connection is already released on connector closing + return + + self._release_acquired(key, protocol) + + if self._force_close or should_close or protocol.should_close: + transport = protocol.transport + protocol.close() + + if key.is_ssl and not self._cleanup_closed_disabled: + self._cleanup_closed_transports.append(transport) + return + + self._conns[key].append((protocol, monotonic())) + + if self._cleanup_handle is None: + self._cleanup_handle = helpers.weakref_handle( + self, + "_cleanup", + self._keepalive_timeout, + self._loop, + timeout_ceil_threshold=self._timeout_ceil_threshold, + ) + + async def _create_connection( + self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout" + ) -> ResponseHandler: + raise NotImplementedError() + + +class _DNSCacheTable: + def __init__(self, ttl: Optional[float] = None) -> None: + self._addrs_rr: Dict[Tuple[str, int], Tuple[Iterator[ResolveResult], int]] = {} + self._timestamps: Dict[Tuple[str, int], float] = {} + self._ttl = ttl + + def __contains__(self, host: object) -> bool: + return host in self._addrs_rr + + def add(self, key: Tuple[str, int], addrs: List[ResolveResult]) -> None: + self._addrs_rr[key] = (cycle(addrs), len(addrs)) + + if self._ttl is not None: + self._timestamps[key] = monotonic() + + def remove(self, key: Tuple[str, int]) -> None: + self._addrs_rr.pop(key, None) + + if self._ttl is not None: + self._timestamps.pop(key, None) + + def clear(self) -> None: + self._addrs_rr.clear() + self._timestamps.clear() + + def next_addrs(self, key: Tuple[str, int]) -> List[ResolveResult]: + loop, length = self._addrs_rr[key] + addrs = list(islice(loop, length)) + # Consume one more element to shift internal state of `cycle` + next(loop) + return addrs + + def expired(self, key: Tuple[str, int]) -> bool: + if self._ttl is None: + return False + + return self._timestamps[key] + self._ttl < monotonic() + + +def _make_ssl_context(verified: bool) -> SSLContext: + """Create SSL context. + + This method is not async-friendly and should be called from a thread + because it will load certificates from disk and do other blocking I/O. + """ + if ssl is None: + # No ssl support + return None + if verified: + sslcontext = ssl.create_default_context() + else: + sslcontext = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT) + sslcontext.options |= ssl.OP_NO_SSLv2 + sslcontext.options |= ssl.OP_NO_SSLv3 + sslcontext.check_hostname = False + sslcontext.verify_mode = ssl.CERT_NONE + sslcontext.options |= ssl.OP_NO_COMPRESSION + sslcontext.set_default_verify_paths() + sslcontext.set_alpn_protocols(("http/1.1",)) + return sslcontext + + +# The default SSLContext objects are created at import time +# since they do blocking I/O to load certificates from disk, +# and imports should always be done before the event loop starts +# or in a thread. +_SSL_CONTEXT_VERIFIED = _make_ssl_context(True) +_SSL_CONTEXT_UNVERIFIED = _make_ssl_context(False) + + +class TCPConnector(BaseConnector): + """TCP connector. + + verify_ssl - Set to True to check ssl certifications. + fingerprint - Pass the binary sha256 + digest of the expected certificate in DER format to verify + that the certificate the server presents matches. See also + https://en.wikipedia.org/wiki/HTTP_Public_Key_Pinning + resolver - Enable DNS lookups and use this + resolver + use_dns_cache - Use memory cache for DNS lookups. + ttl_dns_cache - Max seconds having cached a DNS entry, None forever. + family - socket address family + local_addr - local tuple of (host, port) to bind socket to + + keepalive_timeout - (optional) Keep-alive timeout. + force_close - Set to True to force close and do reconnect + after each request (and between redirects). + limit - The total number of simultaneous connections. + limit_per_host - Number of simultaneous connections to one host. + enable_cleanup_closed - Enables clean-up closed ssl transports. + Disabled by default. + happy_eyeballs_delay - This is the “Connection Attempt Delay” + as defined in RFC 8305. To disable + the happy eyeballs algorithm, set to None. + interleave - “First Address Family Count” as defined in RFC 8305 + loop - Optional event loop. + socket_factory - A SocketFactoryType function that, if supplied, + will be used to create sockets given an + AddrInfoType. + ssl_shutdown_timeout - DEPRECATED. Will be removed in aiohttp 4.0. + Grace period for SSL shutdown handshake on TLS + connections. Default is 0 seconds (immediate abort). + This parameter allowed for a clean SSL shutdown by + notifying the remote peer of connection closure, + while avoiding excessive delays during connector cleanup. + Note: Only takes effect on Python 3.11+. + """ + + allowed_protocol_schema_set = HIGH_LEVEL_SCHEMA_SET | frozenset({"tcp"}) + + def __init__( + self, + *, + verify_ssl: bool = True, + fingerprint: Optional[bytes] = None, + use_dns_cache: bool = True, + ttl_dns_cache: Optional[int] = 10, + family: socket.AddressFamily = socket.AddressFamily.AF_UNSPEC, + ssl_context: Optional[SSLContext] = None, + ssl: Union[bool, Fingerprint, SSLContext] = True, + local_addr: Optional[Tuple[str, int]] = None, + resolver: Optional[AbstractResolver] = None, + keepalive_timeout: Union[None, float, object] = sentinel, + force_close: bool = False, + limit: int = 100, + limit_per_host: int = 0, + enable_cleanup_closed: bool = False, + loop: Optional[asyncio.AbstractEventLoop] = None, + timeout_ceil_threshold: float = 5, + happy_eyeballs_delay: Optional[float] = 0.25, + interleave: Optional[int] = None, + socket_factory: Optional[SocketFactoryType] = None, + ssl_shutdown_timeout: Union[_SENTINEL, None, float] = sentinel, + ): + super().__init__( + keepalive_timeout=keepalive_timeout, + force_close=force_close, + limit=limit, + limit_per_host=limit_per_host, + enable_cleanup_closed=enable_cleanup_closed, + loop=loop, + timeout_ceil_threshold=timeout_ceil_threshold, + ) + + self._ssl = _merge_ssl_params(ssl, verify_ssl, ssl_context, fingerprint) + + self._resolver: AbstractResolver + if resolver is None: + self._resolver = DefaultResolver(loop=self._loop) + self._resolver_owner = True + else: + self._resolver = resolver + self._resolver_owner = False + + self._use_dns_cache = use_dns_cache + self._cached_hosts = _DNSCacheTable(ttl=ttl_dns_cache) + self._throttle_dns_futures: Dict[ + Tuple[str, int], Set["asyncio.Future[None]"] + ] = {} + self._family = family + self._local_addr_infos = aiohappyeyeballs.addr_to_addr_infos(local_addr) + self._happy_eyeballs_delay = happy_eyeballs_delay + self._interleave = interleave + self._resolve_host_tasks: Set["asyncio.Task[List[ResolveResult]]"] = set() + self._socket_factory = socket_factory + self._ssl_shutdown_timeout: Optional[float] + # Handle ssl_shutdown_timeout with warning for Python < 3.11 + if ssl_shutdown_timeout is sentinel: + self._ssl_shutdown_timeout = 0 + else: + # Deprecation warning for ssl_shutdown_timeout parameter + warnings.warn( + "The ssl_shutdown_timeout parameter is deprecated and will be removed in aiohttp 4.0", + DeprecationWarning, + stacklevel=2, + ) + if ( + sys.version_info < (3, 11) + and ssl_shutdown_timeout is not None + and ssl_shutdown_timeout != 0 + ): + warnings.warn( + f"ssl_shutdown_timeout={ssl_shutdown_timeout} is ignored on Python < 3.11; " + "only ssl_shutdown_timeout=0 is supported. The timeout will be ignored.", + RuntimeWarning, + stacklevel=2, + ) + self._ssl_shutdown_timeout = ssl_shutdown_timeout + + def _close(self, *, abort_ssl: bool = False) -> List[Awaitable[object]]: + """Close all ongoing DNS calls.""" + for fut in chain.from_iterable(self._throttle_dns_futures.values()): + fut.cancel() + + waiters = super()._close(abort_ssl=abort_ssl) + + for t in self._resolve_host_tasks: + t.cancel() + waiters.append(t) + + return waiters + + async def close(self, *, abort_ssl: bool = False) -> None: + """ + Close all opened transports. + + :param abort_ssl: If True, SSL connections will be aborted immediately + without performing the shutdown handshake. If False (default), + the behavior is determined by ssl_shutdown_timeout: + - If ssl_shutdown_timeout=0: connections are aborted + - If ssl_shutdown_timeout>0: graceful shutdown is performed + """ + if self._resolver_owner: + await self._resolver.close() + # Use abort_ssl param if explicitly set, otherwise use ssl_shutdown_timeout default + await super().close(abort_ssl=abort_ssl or self._ssl_shutdown_timeout == 0) + + @property + def family(self) -> int: + """Socket family like AF_INET.""" + return self._family + + @property + def use_dns_cache(self) -> bool: + """True if local DNS caching is enabled.""" + return self._use_dns_cache + + def clear_dns_cache( + self, host: Optional[str] = None, port: Optional[int] = None + ) -> None: + """Remove specified host/port or clear all dns local cache.""" + if host is not None and port is not None: + self._cached_hosts.remove((host, port)) + elif host is not None or port is not None: + raise ValueError("either both host and port or none of them are allowed") + else: + self._cached_hosts.clear() + + async def _resolve_host( + self, host: str, port: int, traces: Optional[Sequence["Trace"]] = None + ) -> List[ResolveResult]: + """Resolve host and return list of addresses.""" + if is_ip_address(host): + return [ + { + "hostname": host, + "host": host, + "port": port, + "family": self._family, + "proto": 0, + "flags": 0, + } + ] + + if not self._use_dns_cache: + + if traces: + for trace in traces: + await trace.send_dns_resolvehost_start(host) + + res = await self._resolver.resolve(host, port, family=self._family) + + if traces: + for trace in traces: + await trace.send_dns_resolvehost_end(host) + + return res + + key = (host, port) + if key in self._cached_hosts and not self._cached_hosts.expired(key): + # get result early, before any await (#4014) + result = self._cached_hosts.next_addrs(key) + + if traces: + for trace in traces: + await trace.send_dns_cache_hit(host) + return result + + futures: Set["asyncio.Future[None]"] + # + # If multiple connectors are resolving the same host, we wait + # for the first one to resolve and then use the result for all of them. + # We use a throttle to ensure that we only resolve the host once + # and then use the result for all the waiters. + # + if key in self._throttle_dns_futures: + # get futures early, before any await (#4014) + futures = self._throttle_dns_futures[key] + future: asyncio.Future[None] = self._loop.create_future() + futures.add(future) + if traces: + for trace in traces: + await trace.send_dns_cache_hit(host) + try: + await future + finally: + futures.discard(future) + return self._cached_hosts.next_addrs(key) + + # update dict early, before any await (#4014) + self._throttle_dns_futures[key] = futures = set() + # In this case we need to create a task to ensure that we can shield + # the task from cancellation as cancelling this lookup should not cancel + # the underlying lookup or else the cancel event will get broadcast to + # all the waiters across all connections. + # + coro = self._resolve_host_with_throttle(key, host, port, futures, traces) + loop = asyncio.get_running_loop() + if sys.version_info >= (3, 12): + # Optimization for Python 3.12, try to send immediately + resolved_host_task = asyncio.Task(coro, loop=loop, eager_start=True) + else: + resolved_host_task = loop.create_task(coro) + + if not resolved_host_task.done(): + self._resolve_host_tasks.add(resolved_host_task) + resolved_host_task.add_done_callback(self._resolve_host_tasks.discard) + + try: + return await asyncio.shield(resolved_host_task) + except asyncio.CancelledError: + + def drop_exception(fut: "asyncio.Future[List[ResolveResult]]") -> None: + with suppress(Exception, asyncio.CancelledError): + fut.result() + + resolved_host_task.add_done_callback(drop_exception) + raise + + async def _resolve_host_with_throttle( + self, + key: Tuple[str, int], + host: str, + port: int, + futures: Set["asyncio.Future[None]"], + traces: Optional[Sequence["Trace"]], + ) -> List[ResolveResult]: + """Resolve host and set result for all waiters. + + This method must be run in a task and shielded from cancellation + to avoid cancelling the underlying lookup. + """ + try: + if traces: + for trace in traces: + await trace.send_dns_cache_miss(host) + + for trace in traces: + await trace.send_dns_resolvehost_start(host) + + addrs = await self._resolver.resolve(host, port, family=self._family) + if traces: + for trace in traces: + await trace.send_dns_resolvehost_end(host) + + self._cached_hosts.add(key, addrs) + for fut in futures: + set_result(fut, None) + except BaseException as e: + # any DNS exception is set for the waiters to raise the same exception. + # This coro is always run in task that is shielded from cancellation so + # we should never be propagating cancellation here. + for fut in futures: + set_exception(fut, e) + raise + finally: + self._throttle_dns_futures.pop(key) + + return self._cached_hosts.next_addrs(key) + + async def _create_connection( + self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout" + ) -> ResponseHandler: + """Create connection. + + Has same keyword arguments as BaseEventLoop.create_connection. + """ + if req.proxy: + _, proto = await self._create_proxy_connection(req, traces, timeout) + else: + _, proto = await self._create_direct_connection(req, traces, timeout) + + return proto + + def _get_ssl_context(self, req: ClientRequest) -> Optional[SSLContext]: + """Logic to get the correct SSL context + + 0. if req.ssl is false, return None + + 1. if ssl_context is specified in req, use it + 2. if _ssl_context is specified in self, use it + 3. otherwise: + 1. if verify_ssl is not specified in req, use self.ssl_context + (will generate a default context according to self.verify_ssl) + 2. if verify_ssl is True in req, generate a default SSL context + 3. if verify_ssl is False in req, generate a SSL context that + won't verify + """ + if not req.is_ssl(): + return None + + if ssl is None: # pragma: no cover + raise RuntimeError("SSL is not supported.") + sslcontext = req.ssl + if isinstance(sslcontext, ssl.SSLContext): + return sslcontext + if sslcontext is not True: + # not verified or fingerprinted + return _SSL_CONTEXT_UNVERIFIED + sslcontext = self._ssl + if isinstance(sslcontext, ssl.SSLContext): + return sslcontext + if sslcontext is not True: + # not verified or fingerprinted + return _SSL_CONTEXT_UNVERIFIED + return _SSL_CONTEXT_VERIFIED + + def _get_fingerprint(self, req: ClientRequest) -> Optional["Fingerprint"]: + ret = req.ssl + if isinstance(ret, Fingerprint): + return ret + ret = self._ssl + if isinstance(ret, Fingerprint): + return ret + return None + + async def _wrap_create_connection( + self, + *args: Any, + addr_infos: List[AddrInfoType], + req: ClientRequest, + timeout: "ClientTimeout", + client_error: Type[Exception] = ClientConnectorError, + **kwargs: Any, + ) -> Tuple[asyncio.Transport, ResponseHandler]: + try: + async with ceil_timeout( + timeout.sock_connect, ceil_threshold=timeout.ceil_threshold + ): + sock = await aiohappyeyeballs.start_connection( + addr_infos=addr_infos, + local_addr_infos=self._local_addr_infos, + happy_eyeballs_delay=self._happy_eyeballs_delay, + interleave=self._interleave, + loop=self._loop, + socket_factory=self._socket_factory, + ) + # Add ssl_shutdown_timeout for Python 3.11+ when SSL is used + if ( + kwargs.get("ssl") + and self._ssl_shutdown_timeout + and sys.version_info >= (3, 11) + ): + kwargs["ssl_shutdown_timeout"] = self._ssl_shutdown_timeout + return await self._loop.create_connection(*args, **kwargs, sock=sock) + except cert_errors as exc: + raise ClientConnectorCertificateError(req.connection_key, exc) from exc + except ssl_errors as exc: + raise ClientConnectorSSLError(req.connection_key, exc) from exc + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + raise client_error(req.connection_key, exc) from exc + + async def _wrap_existing_connection( + self, + *args: Any, + req: ClientRequest, + timeout: "ClientTimeout", + client_error: Type[Exception] = ClientConnectorError, + **kwargs: Any, + ) -> Tuple[asyncio.Transport, ResponseHandler]: + try: + async with ceil_timeout( + timeout.sock_connect, ceil_threshold=timeout.ceil_threshold + ): + return await self._loop.create_connection(*args, **kwargs) + except cert_errors as exc: + raise ClientConnectorCertificateError(req.connection_key, exc) from exc + except ssl_errors as exc: + raise ClientConnectorSSLError(req.connection_key, exc) from exc + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + raise client_error(req.connection_key, exc) from exc + + def _fail_on_no_start_tls(self, req: "ClientRequest") -> None: + """Raise a :py:exc:`RuntimeError` on missing ``start_tls()``. + + It is necessary for TLS-in-TLS so that it is possible to + send HTTPS queries through HTTPS proxies. + + This doesn't affect regular HTTP requests, though. + """ + if not req.is_ssl(): + return + + proxy_url = req.proxy + assert proxy_url is not None + if proxy_url.scheme != "https": + return + + self._check_loop_for_start_tls() + + def _check_loop_for_start_tls(self) -> None: + try: + self._loop.start_tls + except AttributeError as attr_exc: + raise RuntimeError( + "An HTTPS request is being sent through an HTTPS proxy. " + "This needs support for TLS in TLS but it is not implemented " + "in your runtime for the stdlib asyncio.\n\n" + "Please upgrade to Python 3.11 or higher. For more details, " + "please see:\n" + "* https://bugs.python.org/issue37179\n" + "* https://github.com/python/cpython/pull/28073\n" + "* https://docs.aiohttp.org/en/stable/" + "client_advanced.html#proxy-support\n" + "* https://github.com/aio-libs/aiohttp/discussions/6044\n", + ) from attr_exc + + def _loop_supports_start_tls(self) -> bool: + try: + self._check_loop_for_start_tls() + except RuntimeError: + return False + else: + return True + + def _warn_about_tls_in_tls( + self, + underlying_transport: asyncio.Transport, + req: ClientRequest, + ) -> None: + """Issue a warning if the requested URL has HTTPS scheme.""" + if req.request_info.url.scheme != "https": + return + + # Check if uvloop is being used, which supports TLS in TLS, + # otherwise assume that asyncio's native transport is being used. + if type(underlying_transport).__module__.startswith("uvloop"): + return + + # Support in asyncio was added in Python 3.11 (bpo-44011) + asyncio_supports_tls_in_tls = sys.version_info >= (3, 11) or getattr( + underlying_transport, + "_start_tls_compatible", + False, + ) + + if asyncio_supports_tls_in_tls: + return + + warnings.warn( + "An HTTPS request is being sent through an HTTPS proxy. " + "This support for TLS in TLS is known to be disabled " + "in the stdlib asyncio (Python <3.11). This is why you'll probably see " + "an error in the log below.\n\n" + "It is possible to enable it via monkeypatching. " + "For more details, see:\n" + "* https://bugs.python.org/issue37179\n" + "* https://github.com/python/cpython/pull/28073\n\n" + "You can temporarily patch this as follows:\n" + "* https://docs.aiohttp.org/en/stable/client_advanced.html#proxy-support\n" + "* https://github.com/aio-libs/aiohttp/discussions/6044\n", + RuntimeWarning, + source=self, + # Why `4`? At least 3 of the calls in the stack originate + # from the methods in this class. + stacklevel=3, + ) + + async def _start_tls_connection( + self, + underlying_transport: asyncio.Transport, + req: ClientRequest, + timeout: "ClientTimeout", + client_error: Type[Exception] = ClientConnectorError, + ) -> Tuple[asyncio.BaseTransport, ResponseHandler]: + """Wrap the raw TCP transport with TLS.""" + tls_proto = self._factory() # Create a brand new proto for TLS + sslcontext = self._get_ssl_context(req) + if TYPE_CHECKING: + # _start_tls_connection is unreachable in the current code path + # if sslcontext is None. + assert sslcontext is not None + + try: + async with ceil_timeout( + timeout.sock_connect, ceil_threshold=timeout.ceil_threshold + ): + try: + # ssl_shutdown_timeout is only available in Python 3.11+ + if sys.version_info >= (3, 11) and self._ssl_shutdown_timeout: + tls_transport = await self._loop.start_tls( + underlying_transport, + tls_proto, + sslcontext, + server_hostname=req.server_hostname or req.host, + ssl_handshake_timeout=timeout.total, + ssl_shutdown_timeout=self._ssl_shutdown_timeout, + ) + else: + tls_transport = await self._loop.start_tls( + underlying_transport, + tls_proto, + sslcontext, + server_hostname=req.server_hostname or req.host, + ssl_handshake_timeout=timeout.total, + ) + except BaseException: + # We need to close the underlying transport since + # `start_tls()` probably failed before it had a + # chance to do this: + if self._ssl_shutdown_timeout == 0: + underlying_transport.abort() + else: + underlying_transport.close() + raise + if isinstance(tls_transport, asyncio.Transport): + fingerprint = self._get_fingerprint(req) + if fingerprint: + try: + fingerprint.check(tls_transport) + except ServerFingerprintMismatch: + tls_transport.close() + if not self._cleanup_closed_disabled: + self._cleanup_closed_transports.append(tls_transport) + raise + except cert_errors as exc: + raise ClientConnectorCertificateError(req.connection_key, exc) from exc + except ssl_errors as exc: + raise ClientConnectorSSLError(req.connection_key, exc) from exc + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + raise client_error(req.connection_key, exc) from exc + except TypeError as type_err: + # Example cause looks like this: + # TypeError: transport is not supported by start_tls() + + raise ClientConnectionError( + "Cannot initialize a TLS-in-TLS connection to host " + f"{req.host!s}:{req.port:d} through an underlying connection " + f"to an HTTPS proxy {req.proxy!s} ssl:{req.ssl or 'default'} " + f"[{type_err!s}]" + ) from type_err + else: + if tls_transport is None: + msg = "Failed to start TLS (possibly caused by closing transport)" + raise client_error(req.connection_key, OSError(msg)) + tls_proto.connection_made( + tls_transport + ) # Kick the state machine of the new TLS protocol + + return tls_transport, tls_proto + + def _convert_hosts_to_addr_infos( + self, hosts: List[ResolveResult] + ) -> List[AddrInfoType]: + """Converts the list of hosts to a list of addr_infos. + + The list of hosts is the result of a DNS lookup. The list of + addr_infos is the result of a call to `socket.getaddrinfo()`. + """ + addr_infos: List[AddrInfoType] = [] + for hinfo in hosts: + host = hinfo["host"] + is_ipv6 = ":" in host + family = socket.AF_INET6 if is_ipv6 else socket.AF_INET + if self._family and self._family != family: + continue + addr = (host, hinfo["port"], 0, 0) if is_ipv6 else (host, hinfo["port"]) + addr_infos.append( + (family, socket.SOCK_STREAM, socket.IPPROTO_TCP, "", addr) + ) + return addr_infos + + async def _create_direct_connection( + self, + req: ClientRequest, + traces: List["Trace"], + timeout: "ClientTimeout", + *, + client_error: Type[Exception] = ClientConnectorError, + ) -> Tuple[asyncio.Transport, ResponseHandler]: + sslcontext = self._get_ssl_context(req) + fingerprint = self._get_fingerprint(req) + + host = req.url.raw_host + assert host is not None + # Replace multiple trailing dots with a single one. + # A trailing dot is only present for fully-qualified domain names. + # See https://github.com/aio-libs/aiohttp/pull/7364. + if host.endswith(".."): + host = host.rstrip(".") + "." + port = req.port + assert port is not None + try: + # Cancelling this lookup should not cancel the underlying lookup + # or else the cancel event will get broadcast to all the waiters + # across all connections. + hosts = await self._resolve_host(host, port, traces=traces) + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + # in case of proxy it is not ClientProxyConnectionError + # it is problem of resolving proxy ip itself + raise ClientConnectorDNSError(req.connection_key, exc) from exc + + last_exc: Optional[Exception] = None + addr_infos = self._convert_hosts_to_addr_infos(hosts) + while addr_infos: + # Strip trailing dots, certificates contain FQDN without dots. + # See https://github.com/aio-libs/aiohttp/issues/3636 + server_hostname = ( + (req.server_hostname or host).rstrip(".") if sslcontext else None + ) + + try: + transp, proto = await self._wrap_create_connection( + self._factory, + timeout=timeout, + ssl=sslcontext, + addr_infos=addr_infos, + server_hostname=server_hostname, + req=req, + client_error=client_error, + ) + except (ClientConnectorError, asyncio.TimeoutError) as exc: + last_exc = exc + aiohappyeyeballs.pop_addr_infos_interleave(addr_infos, self._interleave) + continue + + if req.is_ssl() and fingerprint: + try: + fingerprint.check(transp) + except ServerFingerprintMismatch as exc: + transp.close() + if not self._cleanup_closed_disabled: + self._cleanup_closed_transports.append(transp) + last_exc = exc + # Remove the bad peer from the list of addr_infos + sock: socket.socket = transp.get_extra_info("socket") + bad_peer = sock.getpeername() + aiohappyeyeballs.remove_addr_infos(addr_infos, bad_peer) + continue + + return transp, proto + else: + assert last_exc is not None + raise last_exc + + async def _create_proxy_connection( + self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout" + ) -> Tuple[asyncio.BaseTransport, ResponseHandler]: + self._fail_on_no_start_tls(req) + runtime_has_start_tls = self._loop_supports_start_tls() + proxy_req = self._update_proxy_auth_header_and_build_proxy_req(req) + + # create connection to proxy server + transport, proto = await self._create_direct_connection( + proxy_req, [], timeout, client_error=ClientProxyConnectionError + ) + + if req.is_ssl(): + if runtime_has_start_tls: + self._warn_about_tls_in_tls(transport, req) + + # For HTTPS requests over HTTP proxy + # we must notify proxy to tunnel connection + # so we send CONNECT command: + # CONNECT www.python.org:443 HTTP/1.1 + # Host: www.python.org + # + # next we must do TLS handshake and so on + # to do this we must wrap raw socket into secure one + # asyncio handles this perfectly + proxy_req.method = hdrs.METH_CONNECT + proxy_req.url = req.url + key = req.connection_key._replace( + proxy=None, proxy_auth=None, proxy_headers_hash=None + ) + conn = _ConnectTunnelConnection(self, key, proto, self._loop) + proxy_resp = await proxy_req.send(conn) + try: + protocol = conn._protocol + assert protocol is not None + + # read_until_eof=True will ensure the connection isn't closed + # once the response is received and processed allowing + # START_TLS to work on the connection below. + protocol.set_response_params( + read_until_eof=runtime_has_start_tls, + timeout_ceil_threshold=self._timeout_ceil_threshold, + ) + resp = await proxy_resp.start(conn) + except BaseException: + proxy_resp.close() + conn.close() + raise + else: + conn._protocol = None + try: + if resp.status != 200: + message = resp.reason + if message is None: + message = HTTPStatus(resp.status).phrase + raise ClientHttpProxyError( + proxy_resp.request_info, + resp.history, + status=resp.status, + message=message, + headers=resp.headers, + ) + if not runtime_has_start_tls: + rawsock = transport.get_extra_info("socket", default=None) + if rawsock is None: + raise RuntimeError( + "Transport does not expose socket instance" + ) + # Duplicate the socket, so now we can close proxy transport + rawsock = rawsock.dup() + except BaseException: + # It shouldn't be closed in `finally` because it's fed to + # `loop.start_tls()` and the docs say not to touch it after + # passing there. + transport.close() + raise + finally: + if not runtime_has_start_tls: + transport.close() + + if not runtime_has_start_tls: + # HTTP proxy with support for upgrade to HTTPS + sslcontext = self._get_ssl_context(req) + return await self._wrap_existing_connection( + self._factory, + timeout=timeout, + ssl=sslcontext, + sock=rawsock, + server_hostname=req.host, + req=req, + ) + + return await self._start_tls_connection( + # Access the old transport for the last time before it's + # closed and forgotten forever: + transport, + req=req, + timeout=timeout, + ) + finally: + proxy_resp.close() + + return transport, proto + + +class UnixConnector(BaseConnector): + """Unix socket connector. + + path - Unix socket path. + keepalive_timeout - (optional) Keep-alive timeout. + force_close - Set to True to force close and do reconnect + after each request (and between redirects). + limit - The total number of simultaneous connections. + limit_per_host - Number of simultaneous connections to one host. + loop - Optional event loop. + """ + + allowed_protocol_schema_set = HIGH_LEVEL_SCHEMA_SET | frozenset({"unix"}) + + def __init__( + self, + path: str, + force_close: bool = False, + keepalive_timeout: Union[object, float, None] = sentinel, + limit: int = 100, + limit_per_host: int = 0, + loop: Optional[asyncio.AbstractEventLoop] = None, + ) -> None: + super().__init__( + force_close=force_close, + keepalive_timeout=keepalive_timeout, + limit=limit, + limit_per_host=limit_per_host, + loop=loop, + ) + self._path = path + + @property + def path(self) -> str: + """Path to unix socket.""" + return self._path + + async def _create_connection( + self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout" + ) -> ResponseHandler: + try: + async with ceil_timeout( + timeout.sock_connect, ceil_threshold=timeout.ceil_threshold + ): + _, proto = await self._loop.create_unix_connection( + self._factory, self._path + ) + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + raise UnixClientConnectorError(self.path, req.connection_key, exc) from exc + + return proto + + +class NamedPipeConnector(BaseConnector): + """Named pipe connector. + + Only supported by the proactor event loop. + See also: https://docs.python.org/3/library/asyncio-eventloop.html + + path - Windows named pipe path. + keepalive_timeout - (optional) Keep-alive timeout. + force_close - Set to True to force close and do reconnect + after each request (and between redirects). + limit - The total number of simultaneous connections. + limit_per_host - Number of simultaneous connections to one host. + loop - Optional event loop. + """ + + allowed_protocol_schema_set = HIGH_LEVEL_SCHEMA_SET | frozenset({"npipe"}) + + def __init__( + self, + path: str, + force_close: bool = False, + keepalive_timeout: Union[object, float, None] = sentinel, + limit: int = 100, + limit_per_host: int = 0, + loop: Optional[asyncio.AbstractEventLoop] = None, + ) -> None: + super().__init__( + force_close=force_close, + keepalive_timeout=keepalive_timeout, + limit=limit, + limit_per_host=limit_per_host, + loop=loop, + ) + if not isinstance( + self._loop, + asyncio.ProactorEventLoop, # type: ignore[attr-defined] + ): + raise RuntimeError( + "Named Pipes only available in proactor loop under windows" + ) + self._path = path + + @property + def path(self) -> str: + """Path to the named pipe.""" + return self._path + + async def _create_connection( + self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout" + ) -> ResponseHandler: + try: + async with ceil_timeout( + timeout.sock_connect, ceil_threshold=timeout.ceil_threshold + ): + _, proto = await self._loop.create_pipe_connection( # type: ignore[attr-defined] + self._factory, self._path + ) + # the drain is required so that the connection_made is called + # and transport is set otherwise it is not set before the + # `assert conn.transport is not None` + # in client.py's _request method + await asyncio.sleep(0) + # other option is to manually set transport like + # `proto.transport = trans` + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + raise ClientConnectorError(req.connection_key, exc) from exc + + return cast(ResponseHandler, proto) diff --git a/env/lib/python3.12/site-packages/aiohttp/cookiejar.py b/env/lib/python3.12/site-packages/aiohttp/cookiejar.py new file mode 100644 index 0000000..193648d --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/cookiejar.py @@ -0,0 +1,522 @@ +import asyncio +import calendar +import contextlib +import datetime +import heapq +import itertools +import os # noqa +import pathlib +import pickle +import re +import time +import warnings +from collections import defaultdict +from collections.abc import Mapping +from http.cookies import BaseCookie, Morsel, SimpleCookie +from typing import ( + DefaultDict, + Dict, + Iterable, + Iterator, + List, + Optional, + Set, + Tuple, + Union, +) + +from yarl import URL + +from ._cookie_helpers import preserve_morsel_with_coded_value +from .abc import AbstractCookieJar, ClearCookiePredicate +from .helpers import is_ip_address +from .typedefs import LooseCookies, PathLike, StrOrURL + +__all__ = ("CookieJar", "DummyCookieJar") + + +CookieItem = Union[str, "Morsel[str]"] + +# We cache these string methods here as their use is in performance critical code. +_FORMAT_PATH = "{}/{}".format +_FORMAT_DOMAIN_REVERSED = "{1}.{0}".format + +# The minimum number of scheduled cookie expirations before we start cleaning up +# the expiration heap. This is a performance optimization to avoid cleaning up the +# heap too often when there are only a few scheduled expirations. +_MIN_SCHEDULED_COOKIE_EXPIRATION = 100 +_SIMPLE_COOKIE = SimpleCookie() + + +class CookieJar(AbstractCookieJar): + """Implements cookie storage adhering to RFC 6265.""" + + DATE_TOKENS_RE = re.compile( + r"[\x09\x20-\x2F\x3B-\x40\x5B-\x60\x7B-\x7E]*" + r"(?P[\x00-\x08\x0A-\x1F\d:a-zA-Z\x7F-\xFF]+)" + ) + + DATE_HMS_TIME_RE = re.compile(r"(\d{1,2}):(\d{1,2}):(\d{1,2})") + + DATE_DAY_OF_MONTH_RE = re.compile(r"(\d{1,2})") + + DATE_MONTH_RE = re.compile( + "(jan)|(feb)|(mar)|(apr)|(may)|(jun)|(jul)|(aug)|(sep)|(oct)|(nov)|(dec)", + re.I, + ) + + DATE_YEAR_RE = re.compile(r"(\d{2,4})") + + # calendar.timegm() fails for timestamps after datetime.datetime.max + # Minus one as a loss of precision occurs when timestamp() is called. + MAX_TIME = ( + int(datetime.datetime.max.replace(tzinfo=datetime.timezone.utc).timestamp()) - 1 + ) + try: + calendar.timegm(time.gmtime(MAX_TIME)) + except (OSError, ValueError): + # Hit the maximum representable time on Windows + # https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/localtime-localtime32-localtime64 + # Throws ValueError on PyPy 3.9, OSError elsewhere + MAX_TIME = calendar.timegm((3000, 12, 31, 23, 59, 59, -1, -1, -1)) + except OverflowError: + # #4515: datetime.max may not be representable on 32-bit platforms + MAX_TIME = 2**31 - 1 + # Avoid minuses in the future, 3x faster + SUB_MAX_TIME = MAX_TIME - 1 + + def __init__( + self, + *, + unsafe: bool = False, + quote_cookie: bool = True, + treat_as_secure_origin: Union[StrOrURL, List[StrOrURL], None] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + ) -> None: + super().__init__(loop=loop) + self._cookies: DefaultDict[Tuple[str, str], SimpleCookie] = defaultdict( + SimpleCookie + ) + self._morsel_cache: DefaultDict[Tuple[str, str], Dict[str, Morsel[str]]] = ( + defaultdict(dict) + ) + self._host_only_cookies: Set[Tuple[str, str]] = set() + self._unsafe = unsafe + self._quote_cookie = quote_cookie + if treat_as_secure_origin is None: + treat_as_secure_origin = [] + elif isinstance(treat_as_secure_origin, URL): + treat_as_secure_origin = [treat_as_secure_origin.origin()] + elif isinstance(treat_as_secure_origin, str): + treat_as_secure_origin = [URL(treat_as_secure_origin).origin()] + else: + treat_as_secure_origin = [ + URL(url).origin() if isinstance(url, str) else url.origin() + for url in treat_as_secure_origin + ] + self._treat_as_secure_origin = treat_as_secure_origin + self._expire_heap: List[Tuple[float, Tuple[str, str, str]]] = [] + self._expirations: Dict[Tuple[str, str, str], float] = {} + + @property + def quote_cookie(self) -> bool: + return self._quote_cookie + + def save(self, file_path: PathLike) -> None: + file_path = pathlib.Path(file_path) + with file_path.open(mode="wb") as f: + pickle.dump(self._cookies, f, pickle.HIGHEST_PROTOCOL) + + def load(self, file_path: PathLike) -> None: + file_path = pathlib.Path(file_path) + with file_path.open(mode="rb") as f: + self._cookies = pickle.load(f) + + def clear(self, predicate: Optional[ClearCookiePredicate] = None) -> None: + if predicate is None: + self._expire_heap.clear() + self._cookies.clear() + self._morsel_cache.clear() + self._host_only_cookies.clear() + self._expirations.clear() + return + + now = time.time() + to_del = [ + key + for (domain, path), cookie in self._cookies.items() + for name, morsel in cookie.items() + if ( + (key := (domain, path, name)) in self._expirations + and self._expirations[key] <= now + ) + or predicate(morsel) + ] + if to_del: + self._delete_cookies(to_del) + + def clear_domain(self, domain: str) -> None: + self.clear(lambda x: self._is_domain_match(domain, x["domain"])) + + def __iter__(self) -> "Iterator[Morsel[str]]": + self._do_expiration() + for val in self._cookies.values(): + yield from val.values() + + def __len__(self) -> int: + """Return number of cookies. + + This function does not iterate self to avoid unnecessary expiration + checks. + """ + return sum(len(cookie.values()) for cookie in self._cookies.values()) + + def _do_expiration(self) -> None: + """Remove expired cookies.""" + if not (expire_heap_len := len(self._expire_heap)): + return + + # If the expiration heap grows larger than the number expirations + # times two, we clean it up to avoid keeping expired entries in + # the heap and consuming memory. We guard this with a minimum + # threshold to avoid cleaning up the heap too often when there are + # only a few scheduled expirations. + if ( + expire_heap_len > _MIN_SCHEDULED_COOKIE_EXPIRATION + and expire_heap_len > len(self._expirations) * 2 + ): + # Remove any expired entries from the expiration heap + # that do not match the expiration time in the expirations + # as it means the cookie has been re-added to the heap + # with a different expiration time. + self._expire_heap = [ + entry + for entry in self._expire_heap + if self._expirations.get(entry[1]) == entry[0] + ] + heapq.heapify(self._expire_heap) + + now = time.time() + to_del: List[Tuple[str, str, str]] = [] + # Find any expired cookies and add them to the to-delete list + while self._expire_heap: + when, cookie_key = self._expire_heap[0] + if when > now: + break + heapq.heappop(self._expire_heap) + # Check if the cookie hasn't been re-added to the heap + # with a different expiration time as it will be removed + # later when it reaches the top of the heap and its + # expiration time is met. + if self._expirations.get(cookie_key) == when: + to_del.append(cookie_key) + + if to_del: + self._delete_cookies(to_del) + + def _delete_cookies(self, to_del: List[Tuple[str, str, str]]) -> None: + for domain, path, name in to_del: + self._host_only_cookies.discard((domain, name)) + self._cookies[(domain, path)].pop(name, None) + self._morsel_cache[(domain, path)].pop(name, None) + self._expirations.pop((domain, path, name), None) + + def _expire_cookie(self, when: float, domain: str, path: str, name: str) -> None: + cookie_key = (domain, path, name) + if self._expirations.get(cookie_key) == when: + # Avoid adding duplicates to the heap + return + heapq.heappush(self._expire_heap, (when, cookie_key)) + self._expirations[cookie_key] = when + + def update_cookies(self, cookies: LooseCookies, response_url: URL = URL()) -> None: + """Update cookies.""" + hostname = response_url.raw_host + + if not self._unsafe and is_ip_address(hostname): + # Don't accept cookies from IPs + return + + if isinstance(cookies, Mapping): + cookies = cookies.items() + + for name, cookie in cookies: + if not isinstance(cookie, Morsel): + tmp = SimpleCookie() + tmp[name] = cookie # type: ignore[assignment] + cookie = tmp[name] + + domain = cookie["domain"] + + # ignore domains with trailing dots + if domain and domain[-1] == ".": + domain = "" + del cookie["domain"] + + if not domain and hostname is not None: + # Set the cookie's domain to the response hostname + # and set its host-only-flag + self._host_only_cookies.add((hostname, name)) + domain = cookie["domain"] = hostname + + if domain and domain[0] == ".": + # Remove leading dot + domain = domain[1:] + cookie["domain"] = domain + + if hostname and not self._is_domain_match(domain, hostname): + # Setting cookies for different domains is not allowed + continue + + path = cookie["path"] + if not path or path[0] != "/": + # Set the cookie's path to the response path + path = response_url.path + if not path.startswith("/"): + path = "/" + else: + # Cut everything from the last slash to the end + path = "/" + path[1 : path.rfind("/")] + cookie["path"] = path + path = path.rstrip("/") + + if max_age := cookie["max-age"]: + try: + delta_seconds = int(max_age) + max_age_expiration = min(time.time() + delta_seconds, self.MAX_TIME) + self._expire_cookie(max_age_expiration, domain, path, name) + except ValueError: + cookie["max-age"] = "" + + elif expires := cookie["expires"]: + if expire_time := self._parse_date(expires): + self._expire_cookie(expire_time, domain, path, name) + else: + cookie["expires"] = "" + + key = (domain, path) + if self._cookies[key].get(name) != cookie: + # Don't blow away the cache if the same + # cookie gets set again + self._cookies[key][name] = cookie + self._morsel_cache[key].pop(name, None) + + self._do_expiration() + + def filter_cookies(self, request_url: URL = URL()) -> "BaseCookie[str]": + """Returns this jar's cookies filtered by their attributes.""" + # We always use BaseCookie now since all + # cookies set on on filtered are fully constructed + # Morsels, not just names and values. + filtered: BaseCookie[str] = BaseCookie() + if not self._cookies: + # Skip do_expiration() if there are no cookies. + return filtered + self._do_expiration() + if not self._cookies: + # Skip rest of function if no non-expired cookies. + return filtered + if type(request_url) is not URL: + warnings.warn( + "filter_cookies expects yarl.URL instances only," + f"and will stop working in 4.x, got {type(request_url)}", + DeprecationWarning, + stacklevel=2, + ) + request_url = URL(request_url) + hostname = request_url.raw_host or "" + + is_not_secure = request_url.scheme not in ("https", "wss") + if is_not_secure and self._treat_as_secure_origin: + request_origin = URL() + with contextlib.suppress(ValueError): + request_origin = request_url.origin() + is_not_secure = request_origin not in self._treat_as_secure_origin + + # Send shared cookie + key = ("", "") + for c in self._cookies[key].values(): + # Check cache first + if c.key in self._morsel_cache[key]: + filtered[c.key] = self._morsel_cache[key][c.key] + continue + + # Build and cache the morsel + mrsl_val = self._build_morsel(c) + self._morsel_cache[key][c.key] = mrsl_val + filtered[c.key] = mrsl_val + + if is_ip_address(hostname): + if not self._unsafe: + return filtered + domains: Iterable[str] = (hostname,) + else: + # Get all the subdomains that might match a cookie (e.g. "foo.bar.com", "bar.com", "com") + domains = itertools.accumulate( + reversed(hostname.split(".")), _FORMAT_DOMAIN_REVERSED + ) + + # Get all the path prefixes that might match a cookie (e.g. "", "/foo", "/foo/bar") + paths = itertools.accumulate(request_url.path.split("/"), _FORMAT_PATH) + # Create every combination of (domain, path) pairs. + pairs = itertools.product(domains, paths) + + path_len = len(request_url.path) + # Point 2: https://www.rfc-editor.org/rfc/rfc6265.html#section-5.4 + for p in pairs: + if p not in self._cookies: + continue + for name, cookie in self._cookies[p].items(): + domain = cookie["domain"] + + if (domain, name) in self._host_only_cookies and domain != hostname: + continue + + # Skip edge case when the cookie has a trailing slash but request doesn't. + if len(cookie["path"]) > path_len: + continue + + if is_not_secure and cookie["secure"]: + continue + + # We already built the Morsel so reuse it here + if name in self._morsel_cache[p]: + filtered[name] = self._morsel_cache[p][name] + continue + + # Build and cache the morsel + mrsl_val = self._build_morsel(cookie) + self._morsel_cache[p][name] = mrsl_val + filtered[name] = mrsl_val + + return filtered + + def _build_morsel(self, cookie: Morsel[str]) -> Morsel[str]: + """Build a morsel for sending, respecting quote_cookie setting.""" + if self._quote_cookie and cookie.coded_value and cookie.coded_value[0] == '"': + return preserve_morsel_with_coded_value(cookie) + morsel: Morsel[str] = Morsel() + if self._quote_cookie: + value, coded_value = _SIMPLE_COOKIE.value_encode(cookie.value) + else: + coded_value = value = cookie.value + # We use __setstate__ instead of the public set() API because it allows us to + # bypass validation and set already validated state. This is more stable than + # setting protected attributes directly and unlikely to change since it would + # break pickling. + morsel.__setstate__({"key": cookie.key, "value": value, "coded_value": coded_value}) # type: ignore[attr-defined] + return morsel + + @staticmethod + def _is_domain_match(domain: str, hostname: str) -> bool: + """Implements domain matching adhering to RFC 6265.""" + if hostname == domain: + return True + + if not hostname.endswith(domain): + return False + + non_matching = hostname[: -len(domain)] + + if not non_matching.endswith("."): + return False + + return not is_ip_address(hostname) + + @classmethod + def _parse_date(cls, date_str: str) -> Optional[int]: + """Implements date string parsing adhering to RFC 6265.""" + if not date_str: + return None + + found_time = False + found_day = False + found_month = False + found_year = False + + hour = minute = second = 0 + day = 0 + month = 0 + year = 0 + + for token_match in cls.DATE_TOKENS_RE.finditer(date_str): + + token = token_match.group("token") + + if not found_time: + time_match = cls.DATE_HMS_TIME_RE.match(token) + if time_match: + found_time = True + hour, minute, second = (int(s) for s in time_match.groups()) + continue + + if not found_day: + day_match = cls.DATE_DAY_OF_MONTH_RE.match(token) + if day_match: + found_day = True + day = int(day_match.group()) + continue + + if not found_month: + month_match = cls.DATE_MONTH_RE.match(token) + if month_match: + found_month = True + assert month_match.lastindex is not None + month = month_match.lastindex + continue + + if not found_year: + year_match = cls.DATE_YEAR_RE.match(token) + if year_match: + found_year = True + year = int(year_match.group()) + + if 70 <= year <= 99: + year += 1900 + elif 0 <= year <= 69: + year += 2000 + + if False in (found_day, found_month, found_year, found_time): + return None + + if not 1 <= day <= 31: + return None + + if year < 1601 or hour > 23 or minute > 59 or second > 59: + return None + + return calendar.timegm((year, month, day, hour, minute, second, -1, -1, -1)) + + +class DummyCookieJar(AbstractCookieJar): + """Implements a dummy cookie storage. + + It can be used with the ClientSession when no cookie processing is needed. + + """ + + def __init__(self, *, loop: Optional[asyncio.AbstractEventLoop] = None) -> None: + super().__init__(loop=loop) + + def __iter__(self) -> "Iterator[Morsel[str]]": + while False: + yield None + + def __len__(self) -> int: + return 0 + + @property + def quote_cookie(self) -> bool: + return True + + def clear(self, predicate: Optional[ClearCookiePredicate] = None) -> None: + pass + + def clear_domain(self, domain: str) -> None: + pass + + def update_cookies(self, cookies: LooseCookies, response_url: URL = URL()) -> None: + pass + + def filter_cookies(self, request_url: URL) -> "BaseCookie[str]": + return SimpleCookie() diff --git a/env/lib/python3.12/site-packages/aiohttp/formdata.py b/env/lib/python3.12/site-packages/aiohttp/formdata.py new file mode 100644 index 0000000..a5a4f60 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/formdata.py @@ -0,0 +1,179 @@ +import io +import warnings +from typing import Any, Iterable, List, Optional +from urllib.parse import urlencode + +from multidict import MultiDict, MultiDictProxy + +from . import hdrs, multipart, payload +from .helpers import guess_filename +from .payload import Payload + +__all__ = ("FormData",) + + +class FormData: + """Helper class for form body generation. + + Supports multipart/form-data and application/x-www-form-urlencoded. + """ + + def __init__( + self, + fields: Iterable[Any] = (), + quote_fields: bool = True, + charset: Optional[str] = None, + *, + default_to_multipart: bool = False, + ) -> None: + self._writer = multipart.MultipartWriter("form-data") + self._fields: List[Any] = [] + self._is_multipart = default_to_multipart + self._quote_fields = quote_fields + self._charset = charset + + if isinstance(fields, dict): + fields = list(fields.items()) + elif not isinstance(fields, (list, tuple)): + fields = (fields,) + self.add_fields(*fields) + + @property + def is_multipart(self) -> bool: + return self._is_multipart + + def add_field( + self, + name: str, + value: Any, + *, + content_type: Optional[str] = None, + filename: Optional[str] = None, + content_transfer_encoding: Optional[str] = None, + ) -> None: + + if isinstance(value, io.IOBase): + self._is_multipart = True + elif isinstance(value, (bytes, bytearray, memoryview)): + msg = ( + "In v4, passing bytes will no longer create a file field. " + "Please explicitly use the filename parameter or pass a BytesIO object." + ) + if filename is None and content_transfer_encoding is None: + warnings.warn(msg, DeprecationWarning) + filename = name + + type_options: MultiDict[str] = MultiDict({"name": name}) + if filename is not None and not isinstance(filename, str): + raise TypeError("filename must be an instance of str. Got: %s" % filename) + if filename is None and isinstance(value, io.IOBase): + filename = guess_filename(value, name) + if filename is not None: + type_options["filename"] = filename + self._is_multipart = True + + headers = {} + if content_type is not None: + if not isinstance(content_type, str): + raise TypeError( + "content_type must be an instance of str. Got: %s" % content_type + ) + headers[hdrs.CONTENT_TYPE] = content_type + self._is_multipart = True + if content_transfer_encoding is not None: + if not isinstance(content_transfer_encoding, str): + raise TypeError( + "content_transfer_encoding must be an instance" + " of str. Got: %s" % content_transfer_encoding + ) + msg = ( + "content_transfer_encoding is deprecated. " + "To maintain compatibility with v4 please pass a BytesPayload." + ) + warnings.warn(msg, DeprecationWarning) + self._is_multipart = True + + self._fields.append((type_options, headers, value)) + + def add_fields(self, *fields: Any) -> None: + to_add = list(fields) + + while to_add: + rec = to_add.pop(0) + + if isinstance(rec, io.IOBase): + k = guess_filename(rec, "unknown") + self.add_field(k, rec) # type: ignore[arg-type] + + elif isinstance(rec, (MultiDictProxy, MultiDict)): + to_add.extend(rec.items()) + + elif isinstance(rec, (list, tuple)) and len(rec) == 2: + k, fp = rec + self.add_field(k, fp) + + else: + raise TypeError( + "Only io.IOBase, multidict and (name, file) " + "pairs allowed, use .add_field() for passing " + "more complex parameters, got {!r}".format(rec) + ) + + def _gen_form_urlencoded(self) -> payload.BytesPayload: + # form data (x-www-form-urlencoded) + data = [] + for type_options, _, value in self._fields: + data.append((type_options["name"], value)) + + charset = self._charset if self._charset is not None else "utf-8" + + if charset == "utf-8": + content_type = "application/x-www-form-urlencoded" + else: + content_type = "application/x-www-form-urlencoded; charset=%s" % charset + + return payload.BytesPayload( + urlencode(data, doseq=True, encoding=charset).encode(), + content_type=content_type, + ) + + def _gen_form_data(self) -> multipart.MultipartWriter: + """Encode a list of fields using the multipart/form-data MIME format""" + for dispparams, headers, value in self._fields: + try: + if hdrs.CONTENT_TYPE in headers: + part = payload.get_payload( + value, + content_type=headers[hdrs.CONTENT_TYPE], + headers=headers, + encoding=self._charset, + ) + else: + part = payload.get_payload( + value, headers=headers, encoding=self._charset + ) + except Exception as exc: + raise TypeError( + "Can not serialize value type: %r\n " + "headers: %r\n value: %r" % (type(value), headers, value) + ) from exc + + if dispparams: + part.set_content_disposition( + "form-data", quote_fields=self._quote_fields, **dispparams + ) + # FIXME cgi.FieldStorage doesn't likes body parts with + # Content-Length which were sent via chunked transfer encoding + assert part.headers is not None + part.headers.popall(hdrs.CONTENT_LENGTH, None) + + self._writer.append_payload(part) + + self._fields.clear() + return self._writer + + def __call__(self) -> Payload: + if self._is_multipart: + return self._gen_form_data() + else: + return self._gen_form_urlencoded() diff --git a/env/lib/python3.12/site-packages/aiohttp/hdrs.py b/env/lib/python3.12/site-packages/aiohttp/hdrs.py new file mode 100644 index 0000000..c8d6b35 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/hdrs.py @@ -0,0 +1,121 @@ +"""HTTP Headers constants.""" + +# After changing the file content call ./tools/gen.py +# to regenerate the headers parser +import itertools +from typing import Final, Set + +from multidict import istr + +METH_ANY: Final[str] = "*" +METH_CONNECT: Final[str] = "CONNECT" +METH_HEAD: Final[str] = "HEAD" +METH_GET: Final[str] = "GET" +METH_DELETE: Final[str] = "DELETE" +METH_OPTIONS: Final[str] = "OPTIONS" +METH_PATCH: Final[str] = "PATCH" +METH_POST: Final[str] = "POST" +METH_PUT: Final[str] = "PUT" +METH_TRACE: Final[str] = "TRACE" + +METH_ALL: Final[Set[str]] = { + METH_CONNECT, + METH_HEAD, + METH_GET, + METH_DELETE, + METH_OPTIONS, + METH_PATCH, + METH_POST, + METH_PUT, + METH_TRACE, +} + +ACCEPT: Final[istr] = istr("Accept") +ACCEPT_CHARSET: Final[istr] = istr("Accept-Charset") +ACCEPT_ENCODING: Final[istr] = istr("Accept-Encoding") +ACCEPT_LANGUAGE: Final[istr] = istr("Accept-Language") +ACCEPT_RANGES: Final[istr] = istr("Accept-Ranges") +ACCESS_CONTROL_MAX_AGE: Final[istr] = istr("Access-Control-Max-Age") +ACCESS_CONTROL_ALLOW_CREDENTIALS: Final[istr] = istr("Access-Control-Allow-Credentials") +ACCESS_CONTROL_ALLOW_HEADERS: Final[istr] = istr("Access-Control-Allow-Headers") +ACCESS_CONTROL_ALLOW_METHODS: Final[istr] = istr("Access-Control-Allow-Methods") +ACCESS_CONTROL_ALLOW_ORIGIN: Final[istr] = istr("Access-Control-Allow-Origin") +ACCESS_CONTROL_EXPOSE_HEADERS: Final[istr] = istr("Access-Control-Expose-Headers") +ACCESS_CONTROL_REQUEST_HEADERS: Final[istr] = istr("Access-Control-Request-Headers") +ACCESS_CONTROL_REQUEST_METHOD: Final[istr] = istr("Access-Control-Request-Method") +AGE: Final[istr] = istr("Age") +ALLOW: Final[istr] = istr("Allow") +AUTHORIZATION: Final[istr] = istr("Authorization") +CACHE_CONTROL: Final[istr] = istr("Cache-Control") +CONNECTION: Final[istr] = istr("Connection") +CONTENT_DISPOSITION: Final[istr] = istr("Content-Disposition") +CONTENT_ENCODING: Final[istr] = istr("Content-Encoding") +CONTENT_LANGUAGE: Final[istr] = istr("Content-Language") +CONTENT_LENGTH: Final[istr] = istr("Content-Length") +CONTENT_LOCATION: Final[istr] = istr("Content-Location") +CONTENT_MD5: Final[istr] = istr("Content-MD5") +CONTENT_RANGE: Final[istr] = istr("Content-Range") +CONTENT_TRANSFER_ENCODING: Final[istr] = istr("Content-Transfer-Encoding") +CONTENT_TYPE: Final[istr] = istr("Content-Type") +COOKIE: Final[istr] = istr("Cookie") +DATE: Final[istr] = istr("Date") +DESTINATION: Final[istr] = istr("Destination") +DIGEST: Final[istr] = istr("Digest") +ETAG: Final[istr] = istr("Etag") +EXPECT: Final[istr] = istr("Expect") +EXPIRES: Final[istr] = istr("Expires") +FORWARDED: Final[istr] = istr("Forwarded") +FROM: Final[istr] = istr("From") +HOST: Final[istr] = istr("Host") +IF_MATCH: Final[istr] = istr("If-Match") +IF_MODIFIED_SINCE: Final[istr] = istr("If-Modified-Since") +IF_NONE_MATCH: Final[istr] = istr("If-None-Match") +IF_RANGE: Final[istr] = istr("If-Range") +IF_UNMODIFIED_SINCE: Final[istr] = istr("If-Unmodified-Since") +KEEP_ALIVE: Final[istr] = istr("Keep-Alive") +LAST_EVENT_ID: Final[istr] = istr("Last-Event-ID") +LAST_MODIFIED: Final[istr] = istr("Last-Modified") +LINK: Final[istr] = istr("Link") +LOCATION: Final[istr] = istr("Location") +MAX_FORWARDS: Final[istr] = istr("Max-Forwards") +ORIGIN: Final[istr] = istr("Origin") +PRAGMA: Final[istr] = istr("Pragma") +PROXY_AUTHENTICATE: Final[istr] = istr("Proxy-Authenticate") +PROXY_AUTHORIZATION: Final[istr] = istr("Proxy-Authorization") +RANGE: Final[istr] = istr("Range") +REFERER: Final[istr] = istr("Referer") +RETRY_AFTER: Final[istr] = istr("Retry-After") +SEC_WEBSOCKET_ACCEPT: Final[istr] = istr("Sec-WebSocket-Accept") +SEC_WEBSOCKET_VERSION: Final[istr] = istr("Sec-WebSocket-Version") +SEC_WEBSOCKET_PROTOCOL: Final[istr] = istr("Sec-WebSocket-Protocol") +SEC_WEBSOCKET_EXTENSIONS: Final[istr] = istr("Sec-WebSocket-Extensions") +SEC_WEBSOCKET_KEY: Final[istr] = istr("Sec-WebSocket-Key") +SEC_WEBSOCKET_KEY1: Final[istr] = istr("Sec-WebSocket-Key1") +SERVER: Final[istr] = istr("Server") +SET_COOKIE: Final[istr] = istr("Set-Cookie") +TE: Final[istr] = istr("TE") +TRAILER: Final[istr] = istr("Trailer") +TRANSFER_ENCODING: Final[istr] = istr("Transfer-Encoding") +UPGRADE: Final[istr] = istr("Upgrade") +URI: Final[istr] = istr("URI") +USER_AGENT: Final[istr] = istr("User-Agent") +VARY: Final[istr] = istr("Vary") +VIA: Final[istr] = istr("Via") +WANT_DIGEST: Final[istr] = istr("Want-Digest") +WARNING: Final[istr] = istr("Warning") +WWW_AUTHENTICATE: Final[istr] = istr("WWW-Authenticate") +X_FORWARDED_FOR: Final[istr] = istr("X-Forwarded-For") +X_FORWARDED_HOST: Final[istr] = istr("X-Forwarded-Host") +X_FORWARDED_PROTO: Final[istr] = istr("X-Forwarded-Proto") + +# These are the upper/lower case variants of the headers/methods +# Example: {'hOst', 'host', 'HoST', 'HOSt', 'hOsT', 'HosT', 'hoSt', ...} +METH_HEAD_ALL: Final = frozenset( + map("".join, itertools.product(*zip(METH_HEAD.upper(), METH_HEAD.lower()))) +) +METH_CONNECT_ALL: Final = frozenset( + map("".join, itertools.product(*zip(METH_CONNECT.upper(), METH_CONNECT.lower()))) +) +HOST_ALL: Final = frozenset( + map("".join, itertools.product(*zip(HOST.upper(), HOST.lower()))) +) diff --git a/env/lib/python3.12/site-packages/aiohttp/helpers.py b/env/lib/python3.12/site-packages/aiohttp/helpers.py new file mode 100644 index 0000000..dfab987 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/helpers.py @@ -0,0 +1,986 @@ +"""Various helper functions""" + +import asyncio +import base64 +import binascii +import contextlib +import datetime +import enum +import functools +import inspect +import netrc +import os +import platform +import re +import sys +import time +import weakref +from collections import namedtuple +from contextlib import suppress +from email.message import EmailMessage +from email.parser import HeaderParser +from email.policy import HTTP +from email.utils import parsedate +from math import ceil +from pathlib import Path +from types import MappingProxyType, TracebackType +from typing import ( + Any, + Callable, + ContextManager, + Dict, + Generator, + Generic, + Iterable, + Iterator, + List, + Mapping, + Optional, + Protocol, + Tuple, + Type, + TypeVar, + Union, + get_args, + overload, +) +from urllib.parse import quote +from urllib.request import getproxies, proxy_bypass + +import attr +from multidict import MultiDict, MultiDictProxy, MultiMapping +from propcache.api import under_cached_property as reify +from yarl import URL + +from . import hdrs +from .log import client_logger + +if sys.version_info >= (3, 11): + import asyncio as async_timeout +else: + import async_timeout + +__all__ = ("BasicAuth", "ChainMapProxy", "ETag", "reify") + +IS_MACOS = platform.system() == "Darwin" +IS_WINDOWS = platform.system() == "Windows" + +PY_310 = sys.version_info >= (3, 10) +PY_311 = sys.version_info >= (3, 11) + + +_T = TypeVar("_T") +_S = TypeVar("_S") + +_SENTINEL = enum.Enum("_SENTINEL", "sentinel") +sentinel = _SENTINEL.sentinel + +NO_EXTENSIONS = bool(os.environ.get("AIOHTTP_NO_EXTENSIONS")) + +# https://datatracker.ietf.org/doc/html/rfc9112#section-6.3-2.1 +EMPTY_BODY_STATUS_CODES = frozenset((204, 304, *range(100, 200))) +# https://datatracker.ietf.org/doc/html/rfc9112#section-6.3-2.1 +# https://datatracker.ietf.org/doc/html/rfc9112#section-6.3-2.2 +EMPTY_BODY_METHODS = hdrs.METH_HEAD_ALL + +DEBUG = sys.flags.dev_mode or ( + not sys.flags.ignore_environment and bool(os.environ.get("PYTHONASYNCIODEBUG")) +) + + +CHAR = {chr(i) for i in range(0, 128)} +CTL = {chr(i) for i in range(0, 32)} | { + chr(127), +} +SEPARATORS = { + "(", + ")", + "<", + ">", + "@", + ",", + ";", + ":", + "\\", + '"', + "/", + "[", + "]", + "?", + "=", + "{", + "}", + " ", + chr(9), +} +TOKEN = CHAR ^ CTL ^ SEPARATORS + + +class noop: + def __await__(self) -> Generator[None, None, None]: + yield + + +class BasicAuth(namedtuple("BasicAuth", ["login", "password", "encoding"])): + """Http basic authentication helper.""" + + def __new__( + cls, login: str, password: str = "", encoding: str = "latin1" + ) -> "BasicAuth": + if login is None: + raise ValueError("None is not allowed as login value") + + if password is None: + raise ValueError("None is not allowed as password value") + + if ":" in login: + raise ValueError('A ":" is not allowed in login (RFC 1945#section-11.1)') + + return super().__new__(cls, login, password, encoding) + + @classmethod + def decode(cls, auth_header: str, encoding: str = "latin1") -> "BasicAuth": + """Create a BasicAuth object from an Authorization HTTP header.""" + try: + auth_type, encoded_credentials = auth_header.split(" ", 1) + except ValueError: + raise ValueError("Could not parse authorization header.") + + if auth_type.lower() != "basic": + raise ValueError("Unknown authorization method %s" % auth_type) + + try: + decoded = base64.b64decode( + encoded_credentials.encode("ascii"), validate=True + ).decode(encoding) + except binascii.Error: + raise ValueError("Invalid base64 encoding.") + + try: + # RFC 2617 HTTP Authentication + # https://www.ietf.org/rfc/rfc2617.txt + # the colon must be present, but the username and password may be + # otherwise blank. + username, password = decoded.split(":", 1) + except ValueError: + raise ValueError("Invalid credentials.") + + return cls(username, password, encoding=encoding) + + @classmethod + def from_url(cls, url: URL, *, encoding: str = "latin1") -> Optional["BasicAuth"]: + """Create BasicAuth from url.""" + if not isinstance(url, URL): + raise TypeError("url should be yarl.URL instance") + # Check raw_user and raw_password first as yarl is likely + # to already have these values parsed from the netloc in the cache. + if url.raw_user is None and url.raw_password is None: + return None + return cls(url.user or "", url.password or "", encoding=encoding) + + def encode(self) -> str: + """Encode credentials.""" + creds = (f"{self.login}:{self.password}").encode(self.encoding) + return "Basic %s" % base64.b64encode(creds).decode(self.encoding) + + +def strip_auth_from_url(url: URL) -> Tuple[URL, Optional[BasicAuth]]: + """Remove user and password from URL if present and return BasicAuth object.""" + # Check raw_user and raw_password first as yarl is likely + # to already have these values parsed from the netloc in the cache. + if url.raw_user is None and url.raw_password is None: + return url, None + return url.with_user(None), BasicAuth(url.user or "", url.password or "") + + +def netrc_from_env() -> Optional[netrc.netrc]: + """Load netrc from file. + + Attempt to load it from the path specified by the env-var + NETRC or in the default location in the user's home directory. + + Returns None if it couldn't be found or fails to parse. + """ + netrc_env = os.environ.get("NETRC") + + if netrc_env is not None: + netrc_path = Path(netrc_env) + else: + try: + home_dir = Path.home() + except RuntimeError as e: # pragma: no cover + # if pathlib can't resolve home, it may raise a RuntimeError + client_logger.debug( + "Could not resolve home directory when " + "trying to look for .netrc file: %s", + e, + ) + return None + + netrc_path = home_dir / ("_netrc" if IS_WINDOWS else ".netrc") + + try: + return netrc.netrc(str(netrc_path)) + except netrc.NetrcParseError as e: + client_logger.warning("Could not parse .netrc file: %s", e) + except OSError as e: + netrc_exists = False + with contextlib.suppress(OSError): + netrc_exists = netrc_path.is_file() + # we couldn't read the file (doesn't exist, permissions, etc.) + if netrc_env or netrc_exists: + # only warn if the environment wanted us to load it, + # or it appears like the default file does actually exist + client_logger.warning("Could not read .netrc file: %s", e) + + return None + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class ProxyInfo: + proxy: URL + proxy_auth: Optional[BasicAuth] + + +def basicauth_from_netrc(netrc_obj: Optional[netrc.netrc], host: str) -> BasicAuth: + """ + Return :py:class:`~aiohttp.BasicAuth` credentials for ``host`` from ``netrc_obj``. + + :raises LookupError: if ``netrc_obj`` is :py:data:`None` or if no + entry is found for the ``host``. + """ + if netrc_obj is None: + raise LookupError("No .netrc file found") + auth_from_netrc = netrc_obj.authenticators(host) + + if auth_from_netrc is None: + raise LookupError(f"No entry for {host!s} found in the `.netrc` file.") + login, account, password = auth_from_netrc + + # TODO(PY311): username = login or account + # Up to python 3.10, account could be None if not specified, + # and login will be empty string if not specified. From 3.11, + # login and account will be empty string if not specified. + username = login if (login or account is None) else account + + # TODO(PY311): Remove this, as password will be empty string + # if not specified + if password is None: + password = "" + + return BasicAuth(username, password) + + +def proxies_from_env() -> Dict[str, ProxyInfo]: + proxy_urls = { + k: URL(v) + for k, v in getproxies().items() + if k in ("http", "https", "ws", "wss") + } + netrc_obj = netrc_from_env() + stripped = {k: strip_auth_from_url(v) for k, v in proxy_urls.items()} + ret = {} + for proto, val in stripped.items(): + proxy, auth = val + if proxy.scheme in ("https", "wss"): + client_logger.warning( + "%s proxies %s are not supported, ignoring", proxy.scheme.upper(), proxy + ) + continue + if netrc_obj and auth is None: + if proxy.host is not None: + try: + auth = basicauth_from_netrc(netrc_obj, proxy.host) + except LookupError: + auth = None + ret[proto] = ProxyInfo(proxy, auth) + return ret + + +def get_env_proxy_for_url(url: URL) -> Tuple[URL, Optional[BasicAuth]]: + """Get a permitted proxy for the given URL from the env.""" + if url.host is not None and proxy_bypass(url.host): + raise LookupError(f"Proxying is disallowed for `{url.host!r}`") + + proxies_in_env = proxies_from_env() + try: + proxy_info = proxies_in_env[url.scheme] + except KeyError: + raise LookupError(f"No proxies found for `{url!s}` in the env") + else: + return proxy_info.proxy, proxy_info.proxy_auth + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class MimeType: + type: str + subtype: str + suffix: str + parameters: "MultiDictProxy[str]" + + +@functools.lru_cache(maxsize=56) +def parse_mimetype(mimetype: str) -> MimeType: + """Parses a MIME type into its components. + + mimetype is a MIME type string. + + Returns a MimeType object. + + Example: + + >>> parse_mimetype('text/html; charset=utf-8') + MimeType(type='text', subtype='html', suffix='', + parameters={'charset': 'utf-8'}) + + """ + if not mimetype: + return MimeType( + type="", subtype="", suffix="", parameters=MultiDictProxy(MultiDict()) + ) + + parts = mimetype.split(";") + params: MultiDict[str] = MultiDict() + for item in parts[1:]: + if not item: + continue + key, _, value = item.partition("=") + params.add(key.lower().strip(), value.strip(' "')) + + fulltype = parts[0].strip().lower() + if fulltype == "*": + fulltype = "*/*" + + mtype, _, stype = fulltype.partition("/") + stype, _, suffix = stype.partition("+") + + return MimeType( + type=mtype, subtype=stype, suffix=suffix, parameters=MultiDictProxy(params) + ) + + +class EnsureOctetStream(EmailMessage): + def __init__(self) -> None: + super().__init__() + # https://www.rfc-editor.org/rfc/rfc9110#section-8.3-5 + self.set_default_type("application/octet-stream") + + def get_content_type(self) -> str: + """Re-implementation from Message + + Returns application/octet-stream in place of plain/text when + value is wrong. + + The way this class is used guarantees that content-type will + be present so simplify the checks wrt to the base implementation. + """ + value = self.get("content-type", "").lower() + + # Based on the implementation of _splitparam in the standard library + ctype, _, _ = value.partition(";") + ctype = ctype.strip() + if ctype.count("/") != 1: + return self.get_default_type() + return ctype + + +@functools.lru_cache(maxsize=56) +def parse_content_type(raw: str) -> Tuple[str, MappingProxyType[str, str]]: + """Parse Content-Type header. + + Returns a tuple of the parsed content type and a + MappingProxyType of parameters. The default returned value + is `application/octet-stream` + """ + msg = HeaderParser(EnsureOctetStream, policy=HTTP).parsestr(f"Content-Type: {raw}") + content_type = msg.get_content_type() + params = msg.get_params(()) + content_dict = dict(params[1:]) # First element is content type again + return content_type, MappingProxyType(content_dict) + + +def guess_filename(obj: Any, default: Optional[str] = None) -> Optional[str]: + name = getattr(obj, "name", None) + if name and isinstance(name, str) and name[0] != "<" and name[-1] != ">": + return Path(name).name + return default + + +not_qtext_re = re.compile(r"[^\041\043-\133\135-\176]") +QCONTENT = {chr(i) for i in range(0x20, 0x7F)} | {"\t"} + + +def quoted_string(content: str) -> str: + """Return 7-bit content as quoted-string. + + Format content into a quoted-string as defined in RFC5322 for + Internet Message Format. Notice that this is not the 8-bit HTTP + format, but the 7-bit email format. Content must be in usascii or + a ValueError is raised. + """ + if not (QCONTENT > set(content)): + raise ValueError(f"bad content for quoted-string {content!r}") + return not_qtext_re.sub(lambda x: "\\" + x.group(0), content) + + +def content_disposition_header( + disptype: str, quote_fields: bool = True, _charset: str = "utf-8", **params: str +) -> str: + """Sets ``Content-Disposition`` header for MIME. + + This is the MIME payload Content-Disposition header from RFC 2183 + and RFC 7579 section 4.2, not the HTTP Content-Disposition from + RFC 6266. + + disptype is a disposition type: inline, attachment, form-data. + Should be valid extension token (see RFC 2183) + + quote_fields performs value quoting to 7-bit MIME headers + according to RFC 7578. Set to quote_fields to False if recipient + can take 8-bit file names and field values. + + _charset specifies the charset to use when quote_fields is True. + + params is a dict with disposition params. + """ + if not disptype or not (TOKEN > set(disptype)): + raise ValueError(f"bad content disposition type {disptype!r}") + + value = disptype + if params: + lparams = [] + for key, val in params.items(): + if not key or not (TOKEN > set(key)): + raise ValueError(f"bad content disposition parameter {key!r}={val!r}") + if quote_fields: + if key.lower() == "filename": + qval = quote(val, "", encoding=_charset) + lparams.append((key, '"%s"' % qval)) + else: + try: + qval = quoted_string(val) + except ValueError: + qval = "".join( + (_charset, "''", quote(val, "", encoding=_charset)) + ) + lparams.append((key + "*", qval)) + else: + lparams.append((key, '"%s"' % qval)) + else: + qval = val.replace("\\", "\\\\").replace('"', '\\"') + lparams.append((key, '"%s"' % qval)) + sparams = "; ".join("=".join(pair) for pair in lparams) + value = "; ".join((value, sparams)) + return value + + +def is_ip_address(host: Optional[str]) -> bool: + """Check if host looks like an IP Address. + + This check is only meant as a heuristic to ensure that + a host is not a domain name. + """ + if not host: + return False + # For a host to be an ipv4 address, it must be all numeric. + # The host must contain a colon to be an IPv6 address. + return ":" in host or host.replace(".", "").isdigit() + + +_cached_current_datetime: Optional[int] = None +_cached_formatted_datetime = "" + + +def rfc822_formatted_time() -> str: + global _cached_current_datetime + global _cached_formatted_datetime + + now = int(time.time()) + if now != _cached_current_datetime: + # Weekday and month names for HTTP date/time formatting; + # always English! + # Tuples are constants stored in codeobject! + _weekdayname = ("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun") + _monthname = ( + "", # Dummy so we can use 1-based month numbers + "Jan", + "Feb", + "Mar", + "Apr", + "May", + "Jun", + "Jul", + "Aug", + "Sep", + "Oct", + "Nov", + "Dec", + ) + + year, month, day, hh, mm, ss, wd, *tail = time.gmtime(now) + _cached_formatted_datetime = "%s, %02d %3s %4d %02d:%02d:%02d GMT" % ( + _weekdayname[wd], + day, + _monthname[month], + year, + hh, + mm, + ss, + ) + _cached_current_datetime = now + return _cached_formatted_datetime + + +def _weakref_handle(info: "Tuple[weakref.ref[object], str]") -> None: + ref, name = info + ob = ref() + if ob is not None: + with suppress(Exception): + getattr(ob, name)() + + +def weakref_handle( + ob: object, + name: str, + timeout: float, + loop: asyncio.AbstractEventLoop, + timeout_ceil_threshold: float = 5, +) -> Optional[asyncio.TimerHandle]: + if timeout is not None and timeout > 0: + when = loop.time() + timeout + if timeout >= timeout_ceil_threshold: + when = ceil(when) + + return loop.call_at(when, _weakref_handle, (weakref.ref(ob), name)) + return None + + +def call_later( + cb: Callable[[], Any], + timeout: float, + loop: asyncio.AbstractEventLoop, + timeout_ceil_threshold: float = 5, +) -> Optional[asyncio.TimerHandle]: + if timeout is None or timeout <= 0: + return None + now = loop.time() + when = calculate_timeout_when(now, timeout, timeout_ceil_threshold) + return loop.call_at(when, cb) + + +def calculate_timeout_when( + loop_time: float, + timeout: float, + timeout_ceiling_threshold: float, +) -> float: + """Calculate when to execute a timeout.""" + when = loop_time + timeout + if timeout > timeout_ceiling_threshold: + return ceil(when) + return when + + +class TimeoutHandle: + """Timeout handle""" + + __slots__ = ("_timeout", "_loop", "_ceil_threshold", "_callbacks") + + def __init__( + self, + loop: asyncio.AbstractEventLoop, + timeout: Optional[float], + ceil_threshold: float = 5, + ) -> None: + self._timeout = timeout + self._loop = loop + self._ceil_threshold = ceil_threshold + self._callbacks: List[ + Tuple[Callable[..., None], Tuple[Any, ...], Dict[str, Any]] + ] = [] + + def register( + self, callback: Callable[..., None], *args: Any, **kwargs: Any + ) -> None: + self._callbacks.append((callback, args, kwargs)) + + def close(self) -> None: + self._callbacks.clear() + + def start(self) -> Optional[asyncio.TimerHandle]: + timeout = self._timeout + if timeout is not None and timeout > 0: + when = self._loop.time() + timeout + if timeout >= self._ceil_threshold: + when = ceil(when) + return self._loop.call_at(when, self.__call__) + else: + return None + + def timer(self) -> "BaseTimerContext": + if self._timeout is not None and self._timeout > 0: + timer = TimerContext(self._loop) + self.register(timer.timeout) + return timer + else: + return TimerNoop() + + def __call__(self) -> None: + for cb, args, kwargs in self._callbacks: + with suppress(Exception): + cb(*args, **kwargs) + + self._callbacks.clear() + + +class BaseTimerContext(ContextManager["BaseTimerContext"]): + + __slots__ = () + + def assert_timeout(self) -> None: + """Raise TimeoutError if timeout has been exceeded.""" + + +class TimerNoop(BaseTimerContext): + + __slots__ = () + + def __enter__(self) -> BaseTimerContext: + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + return + + +class TimerContext(BaseTimerContext): + """Low resolution timeout context manager""" + + __slots__ = ("_loop", "_tasks", "_cancelled", "_cancelling") + + def __init__(self, loop: asyncio.AbstractEventLoop) -> None: + self._loop = loop + self._tasks: List[asyncio.Task[Any]] = [] + self._cancelled = False + self._cancelling = 0 + + def assert_timeout(self) -> None: + """Raise TimeoutError if timer has already been cancelled.""" + if self._cancelled: + raise asyncio.TimeoutError from None + + def __enter__(self) -> BaseTimerContext: + task = asyncio.current_task(loop=self._loop) + if task is None: + raise RuntimeError("Timeout context manager should be used inside a task") + + if sys.version_info >= (3, 11): + # Remember if the task was already cancelling + # so when we __exit__ we can decide if we should + # raise asyncio.TimeoutError or let the cancellation propagate + self._cancelling = task.cancelling() + + if self._cancelled: + raise asyncio.TimeoutError from None + + self._tasks.append(task) + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> Optional[bool]: + enter_task: Optional[asyncio.Task[Any]] = None + if self._tasks: + enter_task = self._tasks.pop() + + if exc_type is asyncio.CancelledError and self._cancelled: + assert enter_task is not None + # The timeout was hit, and the task was cancelled + # so we need to uncancel the last task that entered the context manager + # since the cancellation should not leak out of the context manager + if sys.version_info >= (3, 11): + # If the task was already cancelling don't raise + # asyncio.TimeoutError and instead return None + # to allow the cancellation to propagate + if enter_task.uncancel() > self._cancelling: + return None + raise asyncio.TimeoutError from exc_val + return None + + def timeout(self) -> None: + if not self._cancelled: + for task in set(self._tasks): + task.cancel() + + self._cancelled = True + + +def ceil_timeout( + delay: Optional[float], ceil_threshold: float = 5 +) -> async_timeout.Timeout: + if delay is None or delay <= 0: + return async_timeout.timeout(None) + + loop = asyncio.get_running_loop() + now = loop.time() + when = now + delay + if delay > ceil_threshold: + when = ceil(when) + return async_timeout.timeout_at(when) + + +class HeadersMixin: + """Mixin for handling headers.""" + + ATTRS = frozenset(["_content_type", "_content_dict", "_stored_content_type"]) + + _headers: MultiMapping[str] + _content_type: Optional[str] = None + _content_dict: Optional[Dict[str, str]] = None + _stored_content_type: Union[str, None, _SENTINEL] = sentinel + + def _parse_content_type(self, raw: Optional[str]) -> None: + self._stored_content_type = raw + if raw is None: + # default value according to RFC 2616 + self._content_type = "application/octet-stream" + self._content_dict = {} + else: + content_type, content_mapping_proxy = parse_content_type(raw) + self._content_type = content_type + # _content_dict needs to be mutable so we can update it + self._content_dict = content_mapping_proxy.copy() + + @property + def content_type(self) -> str: + """The value of content part for Content-Type HTTP header.""" + raw = self._headers.get(hdrs.CONTENT_TYPE) + if self._stored_content_type != raw: + self._parse_content_type(raw) + assert self._content_type is not None + return self._content_type + + @property + def charset(self) -> Optional[str]: + """The value of charset part for Content-Type HTTP header.""" + raw = self._headers.get(hdrs.CONTENT_TYPE) + if self._stored_content_type != raw: + self._parse_content_type(raw) + assert self._content_dict is not None + return self._content_dict.get("charset") + + @property + def content_length(self) -> Optional[int]: + """The value of Content-Length HTTP header.""" + content_length = self._headers.get(hdrs.CONTENT_LENGTH) + return None if content_length is None else int(content_length) + + +def set_result(fut: "asyncio.Future[_T]", result: _T) -> None: + if not fut.done(): + fut.set_result(result) + + +_EXC_SENTINEL = BaseException() + + +class ErrorableProtocol(Protocol): + def set_exception( + self, + exc: BaseException, + exc_cause: BaseException = ..., + ) -> None: ... # pragma: no cover + + +def set_exception( + fut: "asyncio.Future[_T] | ErrorableProtocol", + exc: BaseException, + exc_cause: BaseException = _EXC_SENTINEL, +) -> None: + """Set future exception. + + If the future is marked as complete, this function is a no-op. + + :param exc_cause: An exception that is a direct cause of ``exc``. + Only set if provided. + """ + if asyncio.isfuture(fut) and fut.done(): + return + + exc_is_sentinel = exc_cause is _EXC_SENTINEL + exc_causes_itself = exc is exc_cause + if not exc_is_sentinel and not exc_causes_itself: + exc.__cause__ = exc_cause + + fut.set_exception(exc) + + +@functools.total_ordering +class AppKey(Generic[_T]): + """Keys for static typing support in Application.""" + + __slots__ = ("_name", "_t", "__orig_class__") + + # This may be set by Python when instantiating with a generic type. We need to + # support this, in order to support types that are not concrete classes, + # like Iterable, which can't be passed as the second parameter to __init__. + __orig_class__: Type[object] + + def __init__(self, name: str, t: Optional[Type[_T]] = None): + # Prefix with module name to help deduplicate key names. + frame = inspect.currentframe() + while frame: + if frame.f_code.co_name == "": + module: str = frame.f_globals["__name__"] + break + frame = frame.f_back + + self._name = module + "." + name + self._t = t + + def __lt__(self, other: object) -> bool: + if isinstance(other, AppKey): + return self._name < other._name + return True # Order AppKey above other types. + + def __repr__(self) -> str: + t = self._t + if t is None: + with suppress(AttributeError): + # Set to type arg. + t = get_args(self.__orig_class__)[0] + + if t is None: + t_repr = "<>" + elif isinstance(t, type): + if t.__module__ == "builtins": + t_repr = t.__qualname__ + else: + t_repr = f"{t.__module__}.{t.__qualname__}" + else: + t_repr = repr(t) + return f"" + + +class ChainMapProxy(Mapping[Union[str, AppKey[Any]], Any]): + __slots__ = ("_maps",) + + def __init__(self, maps: Iterable[Mapping[Union[str, AppKey[Any]], Any]]) -> None: + self._maps = tuple(maps) + + def __init_subclass__(cls) -> None: + raise TypeError( + "Inheritance class {} from ChainMapProxy " + "is forbidden".format(cls.__name__) + ) + + @overload # type: ignore[override] + def __getitem__(self, key: AppKey[_T]) -> _T: ... + + @overload + def __getitem__(self, key: str) -> Any: ... + + def __getitem__(self, key: Union[str, AppKey[_T]]) -> Any: + for mapping in self._maps: + try: + return mapping[key] + except KeyError: + pass + raise KeyError(key) + + @overload # type: ignore[override] + def get(self, key: AppKey[_T], default: _S) -> Union[_T, _S]: ... + + @overload + def get(self, key: AppKey[_T], default: None = ...) -> Optional[_T]: ... + + @overload + def get(self, key: str, default: Any = ...) -> Any: ... + + def get(self, key: Union[str, AppKey[_T]], default: Any = None) -> Any: + try: + return self[key] + except KeyError: + return default + + def __len__(self) -> int: + # reuses stored hash values if possible + return len(set().union(*self._maps)) + + def __iter__(self) -> Iterator[Union[str, AppKey[Any]]]: + d: Dict[Union[str, AppKey[Any]], Any] = {} + for mapping in reversed(self._maps): + # reuses stored hash values if possible + d.update(mapping) + return iter(d) + + def __contains__(self, key: object) -> bool: + return any(key in m for m in self._maps) + + def __bool__(self) -> bool: + return any(self._maps) + + def __repr__(self) -> str: + content = ", ".join(map(repr, self._maps)) + return f"ChainMapProxy({content})" + + +# https://tools.ietf.org/html/rfc7232#section-2.3 +_ETAGC = r"[!\x23-\x7E\x80-\xff]+" +_ETAGC_RE = re.compile(_ETAGC) +_QUOTED_ETAG = rf'(W/)?"({_ETAGC})"' +QUOTED_ETAG_RE = re.compile(_QUOTED_ETAG) +LIST_QUOTED_ETAG_RE = re.compile(rf"({_QUOTED_ETAG})(?:\s*,\s*|$)|(.)") + +ETAG_ANY = "*" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class ETag: + value: str + is_weak: bool = False + + +def validate_etag_value(value: str) -> None: + if value != ETAG_ANY and not _ETAGC_RE.fullmatch(value): + raise ValueError( + f"Value {value!r} is not a valid etag. Maybe it contains '\"'?" + ) + + +def parse_http_date(date_str: Optional[str]) -> Optional[datetime.datetime]: + """Process a date string, return a datetime object""" + if date_str is not None: + timetuple = parsedate(date_str) + if timetuple is not None: + with suppress(ValueError): + return datetime.datetime(*timetuple[:6], tzinfo=datetime.timezone.utc) + return None + + +@functools.lru_cache +def must_be_empty_body(method: str, code: int) -> bool: + """Check if a request must return an empty body.""" + return ( + code in EMPTY_BODY_STATUS_CODES + or method in EMPTY_BODY_METHODS + or (200 <= code < 300 and method in hdrs.METH_CONNECT_ALL) + ) + + +def should_remove_content_length(method: str, code: int) -> bool: + """Check if a Content-Length header should be removed. + + This should always be a subset of must_be_empty_body + """ + # https://www.rfc-editor.org/rfc/rfc9110.html#section-8.6-8 + # https://www.rfc-editor.org/rfc/rfc9110.html#section-15.4.5-4 + return code in EMPTY_BODY_STATUS_CODES or ( + 200 <= code < 300 and method in hdrs.METH_CONNECT_ALL + ) diff --git a/env/lib/python3.12/site-packages/aiohttp/http.py b/env/lib/python3.12/site-packages/aiohttp/http.py new file mode 100644 index 0000000..a1feae2 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/http.py @@ -0,0 +1,72 @@ +import sys +from http import HTTPStatus +from typing import Mapping, Tuple + +from . import __version__ +from .http_exceptions import HttpProcessingError as HttpProcessingError +from .http_parser import ( + HeadersParser as HeadersParser, + HttpParser as HttpParser, + HttpRequestParser as HttpRequestParser, + HttpResponseParser as HttpResponseParser, + RawRequestMessage as RawRequestMessage, + RawResponseMessage as RawResponseMessage, +) +from .http_websocket import ( + WS_CLOSED_MESSAGE as WS_CLOSED_MESSAGE, + WS_CLOSING_MESSAGE as WS_CLOSING_MESSAGE, + WS_KEY as WS_KEY, + WebSocketError as WebSocketError, + WebSocketReader as WebSocketReader, + WebSocketWriter as WebSocketWriter, + WSCloseCode as WSCloseCode, + WSMessage as WSMessage, + WSMsgType as WSMsgType, + ws_ext_gen as ws_ext_gen, + ws_ext_parse as ws_ext_parse, +) +from .http_writer import ( + HttpVersion as HttpVersion, + HttpVersion10 as HttpVersion10, + HttpVersion11 as HttpVersion11, + StreamWriter as StreamWriter, +) + +__all__ = ( + "HttpProcessingError", + "RESPONSES", + "SERVER_SOFTWARE", + # .http_writer + "StreamWriter", + "HttpVersion", + "HttpVersion10", + "HttpVersion11", + # .http_parser + "HeadersParser", + "HttpParser", + "HttpRequestParser", + "HttpResponseParser", + "RawRequestMessage", + "RawResponseMessage", + # .http_websocket + "WS_CLOSED_MESSAGE", + "WS_CLOSING_MESSAGE", + "WS_KEY", + "WebSocketReader", + "WebSocketWriter", + "ws_ext_gen", + "ws_ext_parse", + "WSMessage", + "WebSocketError", + "WSMsgType", + "WSCloseCode", +) + + +SERVER_SOFTWARE: str = "Python/{0[0]}.{0[1]} aiohttp/{1}".format( + sys.version_info, __version__ +) + +RESPONSES: Mapping[int, Tuple[str, str]] = { + v: (v.phrase, v.description) for v in HTTPStatus.__members__.values() +} diff --git a/env/lib/python3.12/site-packages/aiohttp/http_exceptions.py b/env/lib/python3.12/site-packages/aiohttp/http_exceptions.py new file mode 100644 index 0000000..0b5867c --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/http_exceptions.py @@ -0,0 +1,116 @@ +"""Low-level http related exceptions.""" + +from textwrap import indent +from typing import Optional, Union + +from .typedefs import _CIMultiDict + +__all__ = ("HttpProcessingError",) + + +class HttpProcessingError(Exception): + """HTTP error. + + Shortcut for raising HTTP errors with custom code, message and headers. + + code: HTTP Error code. + message: (optional) Error message. + headers: (optional) Headers to be sent in response, a list of pairs + """ + + code = 0 + message = "" + headers = None + + def __init__( + self, + *, + code: Optional[int] = None, + message: str = "", + headers: Optional[_CIMultiDict] = None, + ) -> None: + if code is not None: + self.code = code + self.headers = headers + self.message = message + + def __str__(self) -> str: + msg = indent(self.message, " ") + return f"{self.code}, message:\n{msg}" + + def __repr__(self) -> str: + return f"<{self.__class__.__name__}: {self.code}, message={self.message!r}>" + + +class BadHttpMessage(HttpProcessingError): + + code = 400 + message = "Bad Request" + + def __init__(self, message: str, *, headers: Optional[_CIMultiDict] = None) -> None: + super().__init__(message=message, headers=headers) + self.args = (message,) + + +class HttpBadRequest(BadHttpMessage): + + code = 400 + message = "Bad Request" + + +class PayloadEncodingError(BadHttpMessage): + """Base class for payload errors""" + + +class ContentEncodingError(PayloadEncodingError): + """Content encoding error.""" + + +class TransferEncodingError(PayloadEncodingError): + """transfer encoding error.""" + + +class ContentLengthError(PayloadEncodingError): + """Not enough data to satisfy content length header.""" + + +class DecompressSizeError(PayloadEncodingError): + """Decompressed size exceeds the configured limit.""" + + +class LineTooLong(BadHttpMessage): + def __init__( + self, line: str, limit: str = "Unknown", actual_size: str = "Unknown" + ) -> None: + super().__init__( + f"Got more than {limit} bytes ({actual_size}) when reading {line}." + ) + self.args = (line, limit, actual_size) + + +class InvalidHeader(BadHttpMessage): + def __init__(self, hdr: Union[bytes, str]) -> None: + hdr_s = hdr.decode(errors="backslashreplace") if isinstance(hdr, bytes) else hdr + super().__init__(f"Invalid HTTP header: {hdr!r}") + self.hdr = hdr_s + self.args = (hdr,) + + +class BadStatusLine(BadHttpMessage): + def __init__(self, line: str = "", error: Optional[str] = None) -> None: + if not isinstance(line, str): + line = repr(line) + super().__init__(error or f"Bad status line {line!r}") + self.args = (line,) + self.line = line + + +class BadHttpMethod(BadStatusLine): + """Invalid HTTP method in status line.""" + + def __init__(self, line: str = "", error: Optional[str] = None) -> None: + super().__init__(line, error or f"Bad HTTP method in status line {line!r}") + + +class InvalidURLError(BadHttpMessage): + pass diff --git a/env/lib/python3.12/site-packages/aiohttp/http_parser.py b/env/lib/python3.12/site-packages/aiohttp/http_parser.py new file mode 100644 index 0000000..393e76a --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/http_parser.py @@ -0,0 +1,1086 @@ +import abc +import asyncio +import re +import string +from contextlib import suppress +from enum import IntEnum +from typing import ( + Any, + ClassVar, + Final, + Generic, + List, + Literal, + NamedTuple, + Optional, + Pattern, + Set, + Tuple, + Type, + TypeVar, + Union, +) + +from multidict import CIMultiDict, CIMultiDictProxy, istr +from yarl import URL + +from . import hdrs +from .base_protocol import BaseProtocol +from .compression_utils import ( + DEFAULT_MAX_DECOMPRESS_SIZE, + HAS_BROTLI, + HAS_ZSTD, + BrotliDecompressor, + ZLibDecompressor, + ZSTDDecompressor, +) +from .helpers import ( + _EXC_SENTINEL, + DEBUG, + EMPTY_BODY_METHODS, + EMPTY_BODY_STATUS_CODES, + NO_EXTENSIONS, + BaseTimerContext, + set_exception, +) +from .http_exceptions import ( + BadHttpMessage, + BadHttpMethod, + BadStatusLine, + ContentEncodingError, + ContentLengthError, + DecompressSizeError, + InvalidHeader, + InvalidURLError, + LineTooLong, + TransferEncodingError, +) +from .http_writer import HttpVersion, HttpVersion10 +from .streams import EMPTY_PAYLOAD, StreamReader +from .typedefs import RawHeaders + +__all__ = ( + "HeadersParser", + "HttpParser", + "HttpRequestParser", + "HttpResponseParser", + "RawRequestMessage", + "RawResponseMessage", +) + +_SEP = Literal[b"\r\n", b"\n"] + +ASCIISET: Final[Set[str]] = set(string.printable) + +# See https://www.rfc-editor.org/rfc/rfc9110.html#name-overview +# and https://www.rfc-editor.org/rfc/rfc9110.html#name-tokens +# +# method = token +# tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." / +# "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA +# token = 1*tchar +_TCHAR_SPECIALS: Final[str] = re.escape("!#$%&'*+-.^_`|~") +TOKENRE: Final[Pattern[str]] = re.compile(f"[0-9A-Za-z{_TCHAR_SPECIALS}]+") +VERSRE: Final[Pattern[str]] = re.compile(r"HTTP/(\d)\.(\d)", re.ASCII) +DIGITS: Final[Pattern[str]] = re.compile(r"\d+", re.ASCII) +HEXDIGITS: Final[Pattern[bytes]] = re.compile(rb"[0-9a-fA-F]+") + + +class RawRequestMessage(NamedTuple): + method: str + path: str + version: HttpVersion + headers: "CIMultiDictProxy[str]" + raw_headers: RawHeaders + should_close: bool + compression: Optional[str] + upgrade: bool + chunked: bool + url: URL + + +class RawResponseMessage(NamedTuple): + version: HttpVersion + code: int + reason: str + headers: CIMultiDictProxy[str] + raw_headers: RawHeaders + should_close: bool + compression: Optional[str] + upgrade: bool + chunked: bool + + +_MsgT = TypeVar("_MsgT", RawRequestMessage, RawResponseMessage) + + +class ParseState(IntEnum): + + PARSE_NONE = 0 + PARSE_LENGTH = 1 + PARSE_CHUNKED = 2 + PARSE_UNTIL_EOF = 3 + + +class ChunkState(IntEnum): + PARSE_CHUNKED_SIZE = 0 + PARSE_CHUNKED_CHUNK = 1 + PARSE_CHUNKED_CHUNK_EOF = 2 + PARSE_MAYBE_TRAILERS = 3 + PARSE_TRAILERS = 4 + + +class HeadersParser: + def __init__( + self, + max_line_size: int = 8190, + max_headers: int = 32768, + max_field_size: int = 8190, + lax: bool = False, + ) -> None: + self.max_line_size = max_line_size + self.max_headers = max_headers + self.max_field_size = max_field_size + self._lax = lax + + def parse_headers( + self, lines: List[bytes] + ) -> Tuple["CIMultiDictProxy[str]", RawHeaders]: + headers: CIMultiDict[str] = CIMultiDict() + # note: "raw" does not mean inclusion of OWS before/after the field value + raw_headers = [] + + lines_idx = 0 + line = lines[lines_idx] + line_count = len(lines) + + while line: + # Parse initial header name : value pair. + try: + bname, bvalue = line.split(b":", 1) + except ValueError: + raise InvalidHeader(line) from None + + if len(bname) == 0: + raise InvalidHeader(bname) + + # https://www.rfc-editor.org/rfc/rfc9112.html#section-5.1-2 + if {bname[0], bname[-1]} & {32, 9}: # {" ", "\t"} + raise InvalidHeader(line) + + bvalue = bvalue.lstrip(b" \t") + if len(bname) > self.max_field_size: + raise LineTooLong( + "request header name {}".format( + bname.decode("utf8", "backslashreplace") + ), + str(self.max_field_size), + str(len(bname)), + ) + name = bname.decode("utf-8", "surrogateescape") + if not TOKENRE.fullmatch(name): + raise InvalidHeader(bname) + + header_length = len(bvalue) + + # next line + lines_idx += 1 + line = lines[lines_idx] + + # consume continuation lines + continuation = self._lax and line and line[0] in (32, 9) # (' ', '\t') + + # Deprecated: https://www.rfc-editor.org/rfc/rfc9112.html#name-obsolete-line-folding + if continuation: + bvalue_lst = [bvalue] + while continuation: + header_length += len(line) + if header_length > self.max_field_size: + raise LineTooLong( + "request header field {}".format( + bname.decode("utf8", "backslashreplace") + ), + str(self.max_field_size), + str(header_length), + ) + bvalue_lst.append(line) + + # next line + lines_idx += 1 + if lines_idx < line_count: + line = lines[lines_idx] + if line: + continuation = line[0] in (32, 9) # (' ', '\t') + else: + line = b"" + break + bvalue = b"".join(bvalue_lst) + else: + if header_length > self.max_field_size: + raise LineTooLong( + "request header field {}".format( + bname.decode("utf8", "backslashreplace") + ), + str(self.max_field_size), + str(header_length), + ) + + bvalue = bvalue.strip(b" \t") + value = bvalue.decode("utf-8", "surrogateescape") + + # https://www.rfc-editor.org/rfc/rfc9110.html#section-5.5-5 + if "\n" in value or "\r" in value or "\x00" in value: + raise InvalidHeader(bvalue) + + headers.add(name, value) + raw_headers.append((bname, bvalue)) + + return (CIMultiDictProxy(headers), tuple(raw_headers)) + + +def _is_supported_upgrade(headers: CIMultiDictProxy[str]) -> bool: + """Check if the upgrade header is supported.""" + u = headers.get(hdrs.UPGRADE, "") + # .lower() can transform non-ascii characters. + return u.isascii() and u.lower() in {"tcp", "websocket"} + + +class HttpParser(abc.ABC, Generic[_MsgT]): + lax: ClassVar[bool] = False + + def __init__( + self, + protocol: Optional[BaseProtocol] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + limit: int = 2**16, + max_line_size: int = 8190, + max_headers: int = 32768, + max_field_size: int = 8190, + timer: Optional[BaseTimerContext] = None, + code: Optional[int] = None, + method: Optional[str] = None, + payload_exception: Optional[Type[BaseException]] = None, + response_with_body: bool = True, + read_until_eof: bool = False, + auto_decompress: bool = True, + ) -> None: + self.protocol = protocol + self.loop = loop + self.max_line_size = max_line_size + self.max_headers = max_headers + self.max_field_size = max_field_size + self.timer = timer + self.code = code + self.method = method + self.payload_exception = payload_exception + self.response_with_body = response_with_body + self.read_until_eof = read_until_eof + + self._lines: List[bytes] = [] + self._tail = b"" + self._upgraded = False + self._payload = None + self._payload_parser: Optional[HttpPayloadParser] = None + self._auto_decompress = auto_decompress + self._limit = limit + self._headers_parser = HeadersParser( + max_line_size, max_headers, max_field_size, self.lax + ) + + @abc.abstractmethod + def parse_message(self, lines: List[bytes]) -> _MsgT: ... + + @abc.abstractmethod + def _is_chunked_te(self, te: str) -> bool: ... + + def feed_eof(self) -> Optional[_MsgT]: + if self._payload_parser is not None: + self._payload_parser.feed_eof() + self._payload_parser = None + else: + # try to extract partial message + if self._tail: + self._lines.append(self._tail) + + if self._lines: + if self._lines[-1] != "\r\n": + self._lines.append(b"") + with suppress(Exception): + return self.parse_message(self._lines) + return None + + def feed_data( + self, + data: bytes, + SEP: _SEP = b"\r\n", + EMPTY: bytes = b"", + CONTENT_LENGTH: istr = hdrs.CONTENT_LENGTH, + METH_CONNECT: str = hdrs.METH_CONNECT, + SEC_WEBSOCKET_KEY1: istr = hdrs.SEC_WEBSOCKET_KEY1, + ) -> Tuple[List[Tuple[_MsgT, StreamReader]], bool, bytes]: + + messages = [] + + if self._tail: + data, self._tail = self._tail + data, b"" + + data_len = len(data) + start_pos = 0 + loop = self.loop + + should_close = False + while start_pos < data_len: + + # read HTTP message (request/response line + headers), \r\n\r\n + # and split by lines + if self._payload_parser is None and not self._upgraded: + pos = data.find(SEP, start_pos) + # consume \r\n + if pos == start_pos and not self._lines: + start_pos = pos + len(SEP) + continue + + if pos >= start_pos: + if should_close: + raise BadHttpMessage("Data after `Connection: close`") + + # line found + line = data[start_pos:pos] + if SEP == b"\n": # For lax response parsing + line = line.rstrip(b"\r") + self._lines.append(line) + start_pos = pos + len(SEP) + + # \r\n\r\n found + if self._lines[-1] == EMPTY: + try: + msg: _MsgT = self.parse_message(self._lines) + finally: + self._lines.clear() + + def get_content_length() -> Optional[int]: + # payload length + length_hdr = msg.headers.get(CONTENT_LENGTH) + if length_hdr is None: + return None + + # Shouldn't allow +/- or other number formats. + # https://www.rfc-editor.org/rfc/rfc9110#section-8.6-2 + # msg.headers is already stripped of leading/trailing wsp + if not DIGITS.fullmatch(length_hdr): + raise InvalidHeader(CONTENT_LENGTH) + + return int(length_hdr) + + length = get_content_length() + # do not support old websocket spec + if SEC_WEBSOCKET_KEY1 in msg.headers: + raise InvalidHeader(SEC_WEBSOCKET_KEY1) + + self._upgraded = msg.upgrade and _is_supported_upgrade( + msg.headers + ) + + method = getattr(msg, "method", self.method) + # code is only present on responses + code = getattr(msg, "code", 0) + + assert self.protocol is not None + # calculate payload + empty_body = code in EMPTY_BODY_STATUS_CODES or bool( + method and method in EMPTY_BODY_METHODS + ) + if not empty_body and ( + ((length is not None and length > 0) or msg.chunked) + and not self._upgraded + ): + payload = StreamReader( + self.protocol, + timer=self.timer, + loop=loop, + limit=self._limit, + ) + payload_parser = HttpPayloadParser( + payload, + length=length, + chunked=msg.chunked, + method=method, + compression=msg.compression, + code=self.code, + response_with_body=self.response_with_body, + auto_decompress=self._auto_decompress, + lax=self.lax, + headers_parser=self._headers_parser, + ) + if not payload_parser.done: + self._payload_parser = payload_parser + elif method == METH_CONNECT: + assert isinstance(msg, RawRequestMessage) + payload = StreamReader( + self.protocol, + timer=self.timer, + loop=loop, + limit=self._limit, + ) + self._upgraded = True + self._payload_parser = HttpPayloadParser( + payload, + method=msg.method, + compression=msg.compression, + auto_decompress=self._auto_decompress, + lax=self.lax, + headers_parser=self._headers_parser, + ) + elif not empty_body and length is None and self.read_until_eof: + payload = StreamReader( + self.protocol, + timer=self.timer, + loop=loop, + limit=self._limit, + ) + payload_parser = HttpPayloadParser( + payload, + length=length, + chunked=msg.chunked, + method=method, + compression=msg.compression, + code=self.code, + response_with_body=self.response_with_body, + auto_decompress=self._auto_decompress, + lax=self.lax, + headers_parser=self._headers_parser, + ) + if not payload_parser.done: + self._payload_parser = payload_parser + else: + payload = EMPTY_PAYLOAD + + messages.append((msg, payload)) + should_close = msg.should_close + else: + self._tail = data[start_pos:] + data = EMPTY + break + + # no parser, just store + elif self._payload_parser is None and self._upgraded: + assert not self._lines + break + + # feed payload + elif data and start_pos < data_len: + assert not self._lines + assert self._payload_parser is not None + try: + eof, data = self._payload_parser.feed_data(data[start_pos:], SEP) + except BaseException as underlying_exc: + reraised_exc = underlying_exc + if self.payload_exception is not None: + reraised_exc = self.payload_exception(str(underlying_exc)) + + set_exception( + self._payload_parser.payload, + reraised_exc, + underlying_exc, + ) + + eof = True + data = b"" + if isinstance( + underlying_exc, (InvalidHeader, TransferEncodingError) + ): + raise + + if eof: + start_pos = 0 + data_len = len(data) + self._payload_parser = None + continue + else: + break + + if data and start_pos < data_len: + data = data[start_pos:] + else: + data = EMPTY + + return messages, self._upgraded, data + + def parse_headers( + self, lines: List[bytes] + ) -> Tuple[ + "CIMultiDictProxy[str]", RawHeaders, Optional[bool], Optional[str], bool, bool + ]: + """Parses RFC 5322 headers from a stream. + + Line continuations are supported. Returns list of header name + and value pairs. Header name is in upper case. + """ + headers, raw_headers = self._headers_parser.parse_headers(lines) + close_conn = None + encoding = None + upgrade = False + chunked = False + + # https://www.rfc-editor.org/rfc/rfc9110.html#section-5.5-6 + # https://www.rfc-editor.org/rfc/rfc9110.html#name-collected-abnf + singletons = ( + hdrs.CONTENT_LENGTH, + hdrs.CONTENT_LOCATION, + hdrs.CONTENT_RANGE, + hdrs.CONTENT_TYPE, + hdrs.ETAG, + hdrs.HOST, + hdrs.MAX_FORWARDS, + hdrs.SERVER, + hdrs.TRANSFER_ENCODING, + hdrs.USER_AGENT, + ) + bad_hdr = next((h for h in singletons if len(headers.getall(h, ())) > 1), None) + if bad_hdr is not None: + raise BadHttpMessage(f"Duplicate '{bad_hdr}' header found.") + + # keep-alive + conn = headers.get(hdrs.CONNECTION) + if conn: + v = conn.lower() + if v == "close": + close_conn = True + elif v == "keep-alive": + close_conn = False + # https://www.rfc-editor.org/rfc/rfc9110.html#name-101-switching-protocols + elif v == "upgrade" and headers.get(hdrs.UPGRADE): + upgrade = True + + # encoding + enc = headers.get(hdrs.CONTENT_ENCODING, "") + if enc.isascii() and enc.lower() in {"gzip", "deflate", "br", "zstd"}: + encoding = enc + + # chunking + te = headers.get(hdrs.TRANSFER_ENCODING) + if te is not None: + if self._is_chunked_te(te): + chunked = True + + if hdrs.CONTENT_LENGTH in headers: + raise BadHttpMessage( + "Transfer-Encoding can't be present with Content-Length", + ) + + return (headers, raw_headers, close_conn, encoding, upgrade, chunked) + + def set_upgraded(self, val: bool) -> None: + """Set connection upgraded (to websocket) mode. + + :param bool val: new state. + """ + self._upgraded = val + + +class HttpRequestParser(HttpParser[RawRequestMessage]): + """Read request status line. + + Exception .http_exceptions.BadStatusLine + could be raised in case of any errors in status line. + Returns RawRequestMessage. + """ + + def parse_message(self, lines: List[bytes]) -> RawRequestMessage: + # request line + line = lines[0].decode("utf-8", "surrogateescape") + try: + method, path, version = line.split(" ", maxsplit=2) + except ValueError: + raise BadHttpMethod(line) from None + + if len(path) > self.max_line_size: + raise LineTooLong( + "Status line is too long", str(self.max_line_size), str(len(path)) + ) + + # method + if not TOKENRE.fullmatch(method): + raise BadHttpMethod(method) + + # version + match = VERSRE.fullmatch(version) + if match is None: + raise BadStatusLine(line) + version_o = HttpVersion(int(match.group(1)), int(match.group(2))) + + if method == "CONNECT": + # authority-form, + # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.3 + url = URL.build(authority=path, encoded=True) + elif path.startswith("/"): + # origin-form, + # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.1 + path_part, _hash_separator, url_fragment = path.partition("#") + path_part, _question_mark_separator, qs_part = path_part.partition("?") + + # NOTE: `yarl.URL.build()` is used to mimic what the Cython-based + # NOTE: parser does, otherwise it results into the same + # NOTE: HTTP Request-Line input producing different + # NOTE: `yarl.URL()` objects + url = URL.build( + path=path_part, + query_string=qs_part, + fragment=url_fragment, + encoded=True, + ) + elif path == "*" and method == "OPTIONS": + # asterisk-form, + url = URL(path, encoded=True) + else: + # absolute-form for proxy maybe, + # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.2 + url = URL(path, encoded=True) + if url.scheme == "": + # not absolute-form + raise InvalidURLError( + path.encode(errors="surrogateescape").decode("latin1") + ) + + # read headers + ( + headers, + raw_headers, + close, + compression, + upgrade, + chunked, + ) = self.parse_headers(lines[1:]) + + if close is None: # then the headers weren't set in the request + if version_o <= HttpVersion10: # HTTP 1.0 must asks to not close + close = True + else: # HTTP 1.1 must ask to close. + close = False + + return RawRequestMessage( + method, + path, + version_o, + headers, + raw_headers, + close, + compression, + upgrade, + chunked, + url, + ) + + def _is_chunked_te(self, te: str) -> bool: + te = te.rsplit(",", maxsplit=1)[-1].strip(" \t") + # .lower() transforms some non-ascii chars, so must check first. + if te.isascii() and te.lower() == "chunked": + return True + # https://www.rfc-editor.org/rfc/rfc9112#section-6.3-2.4.3 + raise BadHttpMessage("Request has invalid `Transfer-Encoding`") + + +class HttpResponseParser(HttpParser[RawResponseMessage]): + """Read response status line and headers. + + BadStatusLine could be raised in case of any errors in status line. + Returns RawResponseMessage. + """ + + # Lax mode should only be enabled on response parser. + lax = not DEBUG + + def feed_data( + self, + data: bytes, + SEP: Optional[_SEP] = None, + *args: Any, + **kwargs: Any, + ) -> Tuple[List[Tuple[RawResponseMessage, StreamReader]], bool, bytes]: + if SEP is None: + SEP = b"\r\n" if DEBUG else b"\n" + return super().feed_data(data, SEP, *args, **kwargs) + + def parse_message(self, lines: List[bytes]) -> RawResponseMessage: + line = lines[0].decode("utf-8", "surrogateescape") + try: + version, status = line.split(maxsplit=1) + except ValueError: + raise BadStatusLine(line) from None + + try: + status, reason = status.split(maxsplit=1) + except ValueError: + status = status.strip() + reason = "" + + if len(reason) > self.max_line_size: + raise LineTooLong( + "Status line is too long", str(self.max_line_size), str(len(reason)) + ) + + # version + match = VERSRE.fullmatch(version) + if match is None: + raise BadStatusLine(line) + version_o = HttpVersion(int(match.group(1)), int(match.group(2))) + + # The status code is a three-digit ASCII number, no padding + if len(status) != 3 or not DIGITS.fullmatch(status): + raise BadStatusLine(line) + status_i = int(status) + + # read headers + ( + headers, + raw_headers, + close, + compression, + upgrade, + chunked, + ) = self.parse_headers(lines[1:]) + + if close is None: + if version_o <= HttpVersion10: + close = True + # https://www.rfc-editor.org/rfc/rfc9112.html#name-message-body-length + elif 100 <= status_i < 200 or status_i in {204, 304}: + close = False + elif hdrs.CONTENT_LENGTH in headers or hdrs.TRANSFER_ENCODING in headers: + close = False + else: + # https://www.rfc-editor.org/rfc/rfc9112.html#section-6.3-2.8 + close = True + + return RawResponseMessage( + version_o, + status_i, + reason.strip(), + headers, + raw_headers, + close, + compression, + upgrade, + chunked, + ) + + def _is_chunked_te(self, te: str) -> bool: + # https://www.rfc-editor.org/rfc/rfc9112#section-6.3-2.4.2 + return te.rsplit(",", maxsplit=1)[-1].strip(" \t").lower() == "chunked" + + +class HttpPayloadParser: + def __init__( + self, + payload: StreamReader, + length: Optional[int] = None, + chunked: bool = False, + compression: Optional[str] = None, + code: Optional[int] = None, + method: Optional[str] = None, + response_with_body: bool = True, + auto_decompress: bool = True, + lax: bool = False, + *, + headers_parser: HeadersParser, + ) -> None: + self._length = 0 + self._type = ParseState.PARSE_UNTIL_EOF + self._chunk = ChunkState.PARSE_CHUNKED_SIZE + self._chunk_size = 0 + self._chunk_tail = b"" + self._auto_decompress = auto_decompress + self._lax = lax + self._headers_parser = headers_parser + self._trailer_lines: list[bytes] = [] + self.done = False + + # payload decompression wrapper + if response_with_body and compression and self._auto_decompress: + real_payload: Union[StreamReader, DeflateBuffer] = DeflateBuffer( + payload, compression + ) + else: + real_payload = payload + + # payload parser + if not response_with_body: + # don't parse payload if it's not expected to be received + self._type = ParseState.PARSE_NONE + real_payload.feed_eof() + self.done = True + elif chunked: + self._type = ParseState.PARSE_CHUNKED + elif length is not None: + self._type = ParseState.PARSE_LENGTH + self._length = length + if self._length == 0: + real_payload.feed_eof() + self.done = True + + self.payload = real_payload + + def feed_eof(self) -> None: + if self._type == ParseState.PARSE_UNTIL_EOF: + self.payload.feed_eof() + elif self._type == ParseState.PARSE_LENGTH: + raise ContentLengthError( + "Not enough data to satisfy content length header." + ) + elif self._type == ParseState.PARSE_CHUNKED: + raise TransferEncodingError( + "Not enough data to satisfy transfer length header." + ) + + def feed_data( + self, chunk: bytes, SEP: _SEP = b"\r\n", CHUNK_EXT: bytes = b";" + ) -> Tuple[bool, bytes]: + # Read specified amount of bytes + if self._type == ParseState.PARSE_LENGTH: + required = self._length + chunk_len = len(chunk) + + if required >= chunk_len: + self._length = required - chunk_len + self.payload.feed_data(chunk, chunk_len) + if self._length == 0: + self.payload.feed_eof() + return True, b"" + else: + self._length = 0 + self.payload.feed_data(chunk[:required], required) + self.payload.feed_eof() + return True, chunk[required:] + + # Chunked transfer encoding parser + elif self._type == ParseState.PARSE_CHUNKED: + if self._chunk_tail: + chunk = self._chunk_tail + chunk + self._chunk_tail = b"" + + while chunk: + + # read next chunk size + if self._chunk == ChunkState.PARSE_CHUNKED_SIZE: + pos = chunk.find(SEP) + if pos >= 0: + i = chunk.find(CHUNK_EXT, 0, pos) + if i >= 0: + size_b = chunk[:i] # strip chunk-extensions + # Verify no LF in the chunk-extension + if b"\n" in (ext := chunk[i:pos]): + exc = TransferEncodingError( + f"Unexpected LF in chunk-extension: {ext!r}" + ) + set_exception(self.payload, exc) + raise exc + else: + size_b = chunk[:pos] + + if self._lax: # Allow whitespace in lax mode. + size_b = size_b.strip() + + if not re.fullmatch(HEXDIGITS, size_b): + exc = TransferEncodingError( + chunk[:pos].decode("ascii", "surrogateescape") + ) + set_exception(self.payload, exc) + raise exc + size = int(bytes(size_b), 16) + + chunk = chunk[pos + len(SEP) :] + if size == 0: # eof marker + self._chunk = ChunkState.PARSE_TRAILERS + if self._lax and chunk.startswith(b"\r"): + chunk = chunk[1:] + else: + self._chunk = ChunkState.PARSE_CHUNKED_CHUNK + self._chunk_size = size + self.payload.begin_http_chunk_receiving() + else: + self._chunk_tail = chunk + return False, b"" + + # read chunk and feed buffer + if self._chunk == ChunkState.PARSE_CHUNKED_CHUNK: + required = self._chunk_size + chunk_len = len(chunk) + + if required > chunk_len: + self._chunk_size = required - chunk_len + self.payload.feed_data(chunk, chunk_len) + return False, b"" + else: + self._chunk_size = 0 + self.payload.feed_data(chunk[:required], required) + chunk = chunk[required:] + self._chunk = ChunkState.PARSE_CHUNKED_CHUNK_EOF + self.payload.end_http_chunk_receiving() + + # toss the CRLF at the end of the chunk + if self._chunk == ChunkState.PARSE_CHUNKED_CHUNK_EOF: + if self._lax and chunk.startswith(b"\r"): + chunk = chunk[1:] + if chunk[: len(SEP)] == SEP: + chunk = chunk[len(SEP) :] + self._chunk = ChunkState.PARSE_CHUNKED_SIZE + else: + self._chunk_tail = chunk + return False, b"" + + if self._chunk == ChunkState.PARSE_TRAILERS: + pos = chunk.find(SEP) + if pos < 0: # No line found + self._chunk_tail = chunk + return False, b"" + + line = chunk[:pos] + chunk = chunk[pos + len(SEP) :] + if SEP == b"\n": # For lax response parsing + line = line.rstrip(b"\r") + self._trailer_lines.append(line) + + # \r\n\r\n found, end of stream + if self._trailer_lines[-1] == b"": + # Headers and trailers are defined the same way, + # so we reuse the HeadersParser here. + try: + trailers, raw_trailers = self._headers_parser.parse_headers( + self._trailer_lines + ) + finally: + self._trailer_lines.clear() + self.payload.feed_eof() + return True, chunk + + # Read all bytes until eof + elif self._type == ParseState.PARSE_UNTIL_EOF: + self.payload.feed_data(chunk, len(chunk)) + + return False, b"" + + +class DeflateBuffer: + """DeflateStream decompress stream and feed data into specified stream.""" + + decompressor: Any + + def __init__( + self, + out: StreamReader, + encoding: Optional[str], + max_decompress_size: int = DEFAULT_MAX_DECOMPRESS_SIZE, + ) -> None: + self.out = out + self.size = 0 + out.total_compressed_bytes = self.size + self.encoding = encoding + self._started_decoding = False + + self.decompressor: Union[BrotliDecompressor, ZLibDecompressor, ZSTDDecompressor] + if encoding == "br": + if not HAS_BROTLI: # pragma: no cover + raise ContentEncodingError( + "Can not decode content-encoding: brotli (br). " + "Please install `Brotli`" + ) + self.decompressor = BrotliDecompressor() + elif encoding == "zstd": + if not HAS_ZSTD: + raise ContentEncodingError( + "Can not decode content-encoding: zstandard (zstd). " + "Please install `backports.zstd`" + ) + self.decompressor = ZSTDDecompressor() + else: + self.decompressor = ZLibDecompressor(encoding=encoding) + + self._max_decompress_size = max_decompress_size + + def set_exception( + self, + exc: BaseException, + exc_cause: BaseException = _EXC_SENTINEL, + ) -> None: + set_exception(self.out, exc, exc_cause) + + def feed_data(self, chunk: bytes, size: int) -> None: + if not size: + return + + self.size += size + self.out.total_compressed_bytes = self.size + + # RFC1950 + # bits 0..3 = CM = 0b1000 = 8 = "deflate" + # bits 4..7 = CINFO = 1..7 = windows size. + if ( + not self._started_decoding + and self.encoding == "deflate" + and chunk[0] & 0xF != 8 + ): + # Change the decoder to decompress incorrectly compressed data + # Actually we should issue a warning about non-RFC-compliant data. + self.decompressor = ZLibDecompressor( + encoding=self.encoding, suppress_deflate_header=True + ) + + try: + # Decompress with limit + 1 so we can detect if output exceeds limit + chunk = self.decompressor.decompress_sync( + chunk, max_length=self._max_decompress_size + 1 + ) + except Exception: + raise ContentEncodingError( + "Can not decode content-encoding: %s" % self.encoding + ) + + self._started_decoding = True + + # Check if decompression limit was exceeded + if len(chunk) > self._max_decompress_size: + raise DecompressSizeError( + "Decompressed data exceeds the configured limit of %d bytes" + % self._max_decompress_size + ) + + if chunk: + self.out.feed_data(chunk, len(chunk)) + + def feed_eof(self) -> None: + chunk = self.decompressor.flush() + + if chunk or self.size > 0: + self.out.feed_data(chunk, len(chunk)) + if self.encoding == "deflate" and not self.decompressor.eof: + raise ContentEncodingError("deflate") + + self.out.feed_eof() + + def begin_http_chunk_receiving(self) -> None: + self.out.begin_http_chunk_receiving() + + def end_http_chunk_receiving(self) -> None: + self.out.end_http_chunk_receiving() + + +HttpRequestParserPy = HttpRequestParser +HttpResponseParserPy = HttpResponseParser +RawRequestMessagePy = RawRequestMessage +RawResponseMessagePy = RawResponseMessage + +try: + if not NO_EXTENSIONS: + from ._http_parser import ( # type: ignore[import-not-found,no-redef] + HttpRequestParser, + HttpResponseParser, + RawRequestMessage, + RawResponseMessage, + ) + + HttpRequestParserC = HttpRequestParser + HttpResponseParserC = HttpResponseParser + RawRequestMessageC = RawRequestMessage + RawResponseMessageC = RawResponseMessage +except ImportError: # pragma: no cover + pass diff --git a/env/lib/python3.12/site-packages/aiohttp/http_websocket.py b/env/lib/python3.12/site-packages/aiohttp/http_websocket.py new file mode 100644 index 0000000..6b4b30e --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/http_websocket.py @@ -0,0 +1,36 @@ +"""WebSocket protocol versions 13 and 8.""" + +from ._websocket.helpers import WS_KEY, ws_ext_gen, ws_ext_parse +from ._websocket.models import ( + WS_CLOSED_MESSAGE, + WS_CLOSING_MESSAGE, + WebSocketError, + WSCloseCode, + WSHandshakeError, + WSMessage, + WSMsgType, +) +from ._websocket.reader import WebSocketReader +from ._websocket.writer import WebSocketWriter + +# Messages that the WebSocketResponse.receive needs to handle internally +_INTERNAL_RECEIVE_TYPES = frozenset( + (WSMsgType.CLOSE, WSMsgType.CLOSING, WSMsgType.PING, WSMsgType.PONG) +) + + +__all__ = ( + "WS_CLOSED_MESSAGE", + "WS_CLOSING_MESSAGE", + "WS_KEY", + "WebSocketReader", + "WebSocketWriter", + "WSMessage", + "WebSocketError", + "WSMsgType", + "WSCloseCode", + "ws_ext_gen", + "ws_ext_parse", + "WSHandshakeError", + "WSMessage", +) diff --git a/env/lib/python3.12/site-packages/aiohttp/http_writer.py b/env/lib/python3.12/site-packages/aiohttp/http_writer.py new file mode 100644 index 0000000..a140b21 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/http_writer.py @@ -0,0 +1,378 @@ +"""Http related parsers and protocol.""" + +import asyncio +import sys +from typing import ( # noqa + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Iterable, + List, + NamedTuple, + Optional, + Union, +) + +from multidict import CIMultiDict + +from .abc import AbstractStreamWriter +from .base_protocol import BaseProtocol +from .client_exceptions import ClientConnectionResetError +from .compression_utils import ZLibCompressor +from .helpers import NO_EXTENSIONS + +__all__ = ("StreamWriter", "HttpVersion", "HttpVersion10", "HttpVersion11") + + +MIN_PAYLOAD_FOR_WRITELINES = 2048 +IS_PY313_BEFORE_313_2 = (3, 13, 0) <= sys.version_info < (3, 13, 2) +IS_PY_BEFORE_312_9 = sys.version_info < (3, 12, 9) +SKIP_WRITELINES = IS_PY313_BEFORE_313_2 or IS_PY_BEFORE_312_9 +# writelines is not safe for use +# on Python 3.12+ until 3.12.9 +# on Python 3.13+ until 3.13.2 +# and on older versions it not any faster than write +# CVE-2024-12254: https://github.com/python/cpython/pull/127656 + + +class HttpVersion(NamedTuple): + major: int + minor: int + + +HttpVersion10 = HttpVersion(1, 0) +HttpVersion11 = HttpVersion(1, 1) + + +_T_OnChunkSent = Optional[Callable[[bytes], Awaitable[None]]] +_T_OnHeadersSent = Optional[Callable[["CIMultiDict[str]"], Awaitable[None]]] + + +class StreamWriter(AbstractStreamWriter): + + length: Optional[int] = None + chunked: bool = False + _eof: bool = False + _compress: Optional[ZLibCompressor] = None + + def __init__( + self, + protocol: BaseProtocol, + loop: asyncio.AbstractEventLoop, + on_chunk_sent: _T_OnChunkSent = None, + on_headers_sent: _T_OnHeadersSent = None, + ) -> None: + self._protocol = protocol + self.loop = loop + self._on_chunk_sent: _T_OnChunkSent = on_chunk_sent + self._on_headers_sent: _T_OnHeadersSent = on_headers_sent + self._headers_buf: Optional[bytes] = None + self._headers_written: bool = False + + @property + def transport(self) -> Optional[asyncio.Transport]: + return self._protocol.transport + + @property + def protocol(self) -> BaseProtocol: + return self._protocol + + def enable_chunking(self) -> None: + self.chunked = True + + def enable_compression( + self, encoding: str = "deflate", strategy: Optional[int] = None + ) -> None: + self._compress = ZLibCompressor(encoding=encoding, strategy=strategy) + + def _write(self, chunk: Union[bytes, bytearray, memoryview]) -> None: + size = len(chunk) + self.buffer_size += size + self.output_size += size + transport = self._protocol.transport + if transport is None or transport.is_closing(): + raise ClientConnectionResetError("Cannot write to closing transport") + transport.write(chunk) + + def _writelines(self, chunks: Iterable[bytes]) -> None: + size = 0 + for chunk in chunks: + size += len(chunk) + self.buffer_size += size + self.output_size += size + transport = self._protocol.transport + if transport is None or transport.is_closing(): + raise ClientConnectionResetError("Cannot write to closing transport") + if SKIP_WRITELINES or size < MIN_PAYLOAD_FOR_WRITELINES: + transport.write(b"".join(chunks)) + else: + transport.writelines(chunks) + + def _write_chunked_payload( + self, chunk: Union[bytes, bytearray, "memoryview[int]", "memoryview[bytes]"] + ) -> None: + """Write a chunk with proper chunked encoding.""" + chunk_len_pre = f"{len(chunk):x}\r\n".encode("ascii") + self._writelines((chunk_len_pre, chunk, b"\r\n")) + + def _send_headers_with_payload( + self, + chunk: Union[bytes, bytearray, "memoryview[int]", "memoryview[bytes]"], + is_eof: bool, + ) -> None: + """Send buffered headers with payload, coalescing into single write.""" + # Mark headers as written + self._headers_written = True + headers_buf = self._headers_buf + self._headers_buf = None + + if TYPE_CHECKING: + # Safe because callers (write() and write_eof()) only invoke this method + # after checking that self._headers_buf is truthy + assert headers_buf is not None + + if not self.chunked: + # Non-chunked: coalesce headers with body + if chunk: + self._writelines((headers_buf, chunk)) + else: + self._write(headers_buf) + return + + # Coalesce headers with chunked data + if chunk: + chunk_len_pre = f"{len(chunk):x}\r\n".encode("ascii") + if is_eof: + self._writelines((headers_buf, chunk_len_pre, chunk, b"\r\n0\r\n\r\n")) + else: + self._writelines((headers_buf, chunk_len_pre, chunk, b"\r\n")) + elif is_eof: + self._writelines((headers_buf, b"0\r\n\r\n")) + else: + self._write(headers_buf) + + async def write( + self, + chunk: Union[bytes, bytearray, memoryview], + *, + drain: bool = True, + LIMIT: int = 0x10000, + ) -> None: + """ + Writes chunk of data to a stream. + + write_eof() indicates end of stream. + writer can't be used after write_eof() method being called. + write() return drain future. + """ + if self._on_chunk_sent is not None: + await self._on_chunk_sent(chunk) + + if isinstance(chunk, memoryview): + if chunk.nbytes != len(chunk): + # just reshape it + chunk = chunk.cast("c") + + if self._compress is not None: + chunk = await self._compress.compress(chunk) + if not chunk: + return + + if self.length is not None: + chunk_len = len(chunk) + if self.length >= chunk_len: + self.length = self.length - chunk_len + else: + chunk = chunk[: self.length] + self.length = 0 + if not chunk: + return + + # Handle buffered headers for small payload optimization + if self._headers_buf and not self._headers_written: + self._send_headers_with_payload(chunk, False) + if drain and self.buffer_size > LIMIT: + self.buffer_size = 0 + await self.drain() + return + + if chunk: + if self.chunked: + self._write_chunked_payload(chunk) + else: + self._write(chunk) + + if drain and self.buffer_size > LIMIT: + self.buffer_size = 0 + await self.drain() + + async def write_headers( + self, status_line: str, headers: "CIMultiDict[str]" + ) -> None: + """Write headers to the stream.""" + if self._on_headers_sent is not None: + await self._on_headers_sent(headers) + # status + headers + buf = _serialize_headers(status_line, headers) + self._headers_written = False + self._headers_buf = buf + + def send_headers(self) -> None: + """Force sending buffered headers if not already sent.""" + if not self._headers_buf or self._headers_written: + return + + self._headers_written = True + headers_buf = self._headers_buf + self._headers_buf = None + + if TYPE_CHECKING: + # Safe because we only enter this block when self._headers_buf is truthy + assert headers_buf is not None + + self._write(headers_buf) + + def set_eof(self) -> None: + """Indicate that the message is complete.""" + if self._eof: + return + + # If headers haven't been sent yet, send them now + # This handles the case where there's no body at all + if self._headers_buf and not self._headers_written: + self._headers_written = True + headers_buf = self._headers_buf + self._headers_buf = None + + if TYPE_CHECKING: + # Safe because we only enter this block when self._headers_buf is truthy + assert headers_buf is not None + + # Combine headers and chunked EOF marker in a single write + if self.chunked: + self._writelines((headers_buf, b"0\r\n\r\n")) + else: + self._write(headers_buf) + elif self.chunked and self._headers_written: + # Headers already sent, just send the final chunk marker + self._write(b"0\r\n\r\n") + + self._eof = True + + async def write_eof(self, chunk: bytes = b"") -> None: + if self._eof: + return + + if chunk and self._on_chunk_sent is not None: + await self._on_chunk_sent(chunk) + + # Handle body/compression + if self._compress: + chunks: List[bytes] = [] + chunks_len = 0 + if chunk and (compressed_chunk := await self._compress.compress(chunk)): + chunks_len = len(compressed_chunk) + chunks.append(compressed_chunk) + + flush_chunk = self._compress.flush() + chunks_len += len(flush_chunk) + chunks.append(flush_chunk) + assert chunks_len + + # Send buffered headers with compressed data if not yet sent + if self._headers_buf and not self._headers_written: + self._headers_written = True + headers_buf = self._headers_buf + self._headers_buf = None + + if self.chunked: + # Coalesce headers with compressed chunked data + chunk_len_pre = f"{chunks_len:x}\r\n".encode("ascii") + self._writelines( + (headers_buf, chunk_len_pre, *chunks, b"\r\n0\r\n\r\n") + ) + else: + # Coalesce headers with compressed data + self._writelines((headers_buf, *chunks)) + await self.drain() + self._eof = True + return + + # Headers already sent, just write compressed data + if self.chunked: + chunk_len_pre = f"{chunks_len:x}\r\n".encode("ascii") + self._writelines((chunk_len_pre, *chunks, b"\r\n0\r\n\r\n")) + elif len(chunks) > 1: + self._writelines(chunks) + else: + self._write(chunks[0]) + await self.drain() + self._eof = True + return + + # No compression - send buffered headers if not yet sent + if self._headers_buf and not self._headers_written: + # Use helper to send headers with payload + self._send_headers_with_payload(chunk, True) + await self.drain() + self._eof = True + return + + # Handle remaining body + if self.chunked: + if chunk: + # Write final chunk with EOF marker + self._writelines( + (f"{len(chunk):x}\r\n".encode("ascii"), chunk, b"\r\n0\r\n\r\n") + ) + else: + self._write(b"0\r\n\r\n") + await self.drain() + self._eof = True + return + + if chunk: + self._write(chunk) + await self.drain() + + self._eof = True + + async def drain(self) -> None: + """Flush the write buffer. + + The intended use is to write + + await w.write(data) + await w.drain() + """ + protocol = self._protocol + if protocol.transport is not None and protocol._paused: + await protocol._drain_helper() + + +def _safe_header(string: str) -> str: + if "\r" in string or "\n" in string: + raise ValueError( + "Newline or carriage return detected in headers. " + "Potential header injection attack." + ) + return string + + +def _py_serialize_headers(status_line: str, headers: "CIMultiDict[str]") -> bytes: + headers_gen = (_safe_header(k) + ": " + _safe_header(v) for k, v in headers.items()) + line = status_line + "\r\n" + "\r\n".join(headers_gen) + "\r\n\r\n" + return line.encode("utf-8") + + +_serialize_headers = _py_serialize_headers + +try: + import aiohttp._http_writer as _http_writer # type: ignore[import-not-found] + + _c_serialize_headers = _http_writer._serialize_headers + if not NO_EXTENSIONS: + _serialize_headers = _c_serialize_headers +except ImportError: + pass diff --git a/env/lib/python3.12/site-packages/aiohttp/log.py b/env/lib/python3.12/site-packages/aiohttp/log.py new file mode 100644 index 0000000..3cecea2 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/log.py @@ -0,0 +1,8 @@ +import logging + +access_logger = logging.getLogger("aiohttp.access") +client_logger = logging.getLogger("aiohttp.client") +internal_logger = logging.getLogger("aiohttp.internal") +server_logger = logging.getLogger("aiohttp.server") +web_logger = logging.getLogger("aiohttp.web") +ws_logger = logging.getLogger("aiohttp.websocket") diff --git a/env/lib/python3.12/site-packages/aiohttp/multipart.py b/env/lib/python3.12/site-packages/aiohttp/multipart.py new file mode 100644 index 0000000..9c37f0b --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/multipart.py @@ -0,0 +1,1152 @@ +import base64 +import binascii +import json +import re +import sys +import uuid +import warnings +from collections import deque +from collections.abc import Mapping, Sequence +from types import TracebackType +from typing import ( + TYPE_CHECKING, + Any, + Deque, + Dict, + Iterator, + List, + Optional, + Tuple, + Type, + Union, + cast, +) +from urllib.parse import parse_qsl, unquote, urlencode + +from multidict import CIMultiDict, CIMultiDictProxy + +from .abc import AbstractStreamWriter +from .compression_utils import ( + DEFAULT_MAX_DECOMPRESS_SIZE, + ZLibCompressor, + ZLibDecompressor, +) +from .hdrs import ( + CONTENT_DISPOSITION, + CONTENT_ENCODING, + CONTENT_LENGTH, + CONTENT_TRANSFER_ENCODING, + CONTENT_TYPE, +) +from .helpers import CHAR, TOKEN, parse_mimetype, reify +from .http import HeadersParser +from .log import internal_logger +from .payload import ( + JsonPayload, + LookupError, + Order, + Payload, + StringPayload, + get_payload, + payload_type, +) +from .streams import StreamReader + +if sys.version_info >= (3, 11): + from typing import Self +else: + from typing import TypeVar + + Self = TypeVar("Self", bound="BodyPartReader") + +__all__ = ( + "MultipartReader", + "MultipartWriter", + "BodyPartReader", + "BadContentDispositionHeader", + "BadContentDispositionParam", + "parse_content_disposition", + "content_disposition_filename", +) + + +if TYPE_CHECKING: + from .client_reqrep import ClientResponse + + +class BadContentDispositionHeader(RuntimeWarning): + pass + + +class BadContentDispositionParam(RuntimeWarning): + pass + + +def parse_content_disposition( + header: Optional[str], +) -> Tuple[Optional[str], Dict[str, str]]: + def is_token(string: str) -> bool: + return bool(string) and TOKEN >= set(string) + + def is_quoted(string: str) -> bool: + return string[0] == string[-1] == '"' + + def is_rfc5987(string: str) -> bool: + return is_token(string) and string.count("'") == 2 + + def is_extended_param(string: str) -> bool: + return string.endswith("*") + + def is_continuous_param(string: str) -> bool: + pos = string.find("*") + 1 + if not pos: + return False + substring = string[pos:-1] if string.endswith("*") else string[pos:] + return substring.isdigit() + + def unescape(text: str, *, chars: str = "".join(map(re.escape, CHAR))) -> str: + return re.sub(f"\\\\([{chars}])", "\\1", text) + + if not header: + return None, {} + + disptype, *parts = header.split(";") + if not is_token(disptype): + warnings.warn(BadContentDispositionHeader(header)) + return None, {} + + params: Dict[str, str] = {} + while parts: + item = parts.pop(0) + + if not item: # To handle trailing semicolons + warnings.warn(BadContentDispositionHeader(header)) + continue + + if "=" not in item: + warnings.warn(BadContentDispositionHeader(header)) + return None, {} + + key, value = item.split("=", 1) + key = key.lower().strip() + value = value.lstrip() + + if key in params: + warnings.warn(BadContentDispositionHeader(header)) + return None, {} + + if not is_token(key): + warnings.warn(BadContentDispositionParam(item)) + continue + + elif is_continuous_param(key): + if is_quoted(value): + value = unescape(value[1:-1]) + elif not is_token(value): + warnings.warn(BadContentDispositionParam(item)) + continue + + elif is_extended_param(key): + if is_rfc5987(value): + encoding, _, value = value.split("'", 2) + encoding = encoding or "utf-8" + else: + warnings.warn(BadContentDispositionParam(item)) + continue + + try: + value = unquote(value, encoding, "strict") + except UnicodeDecodeError: # pragma: nocover + warnings.warn(BadContentDispositionParam(item)) + continue + + else: + failed = True + if is_quoted(value): + failed = False + value = unescape(value[1:-1].lstrip("\\/")) + elif is_token(value): + failed = False + elif parts: + # maybe just ; in filename, in any case this is just + # one case fix, for proper fix we need to redesign parser + _value = f"{value};{parts[0]}" + if is_quoted(_value): + parts.pop(0) + value = unescape(_value[1:-1].lstrip("\\/")) + failed = False + + if failed: + warnings.warn(BadContentDispositionHeader(header)) + return None, {} + + params[key] = value + + return disptype.lower(), params + + +def content_disposition_filename( + params: Mapping[str, str], name: str = "filename" +) -> Optional[str]: + name_suf = "%s*" % name + if not params: + return None + elif name_suf in params: + return params[name_suf] + elif name in params: + return params[name] + else: + parts = [] + fnparams = sorted( + (key, value) for key, value in params.items() if key.startswith(name_suf) + ) + for num, (key, value) in enumerate(fnparams): + _, tail = key.split("*", 1) + if tail.endswith("*"): + tail = tail[:-1] + if tail == str(num): + parts.append(value) + else: + break + if not parts: + return None + value = "".join(parts) + if "'" in value: + encoding, _, value = value.split("'", 2) + encoding = encoding or "utf-8" + return unquote(value, encoding, "strict") + return value + + +class MultipartResponseWrapper: + """Wrapper around the MultipartReader. + + It takes care about + underlying connection and close it when it needs in. + """ + + def __init__( + self, + resp: "ClientResponse", + stream: "MultipartReader", + ) -> None: + self.resp = resp + self.stream = stream + + def __aiter__(self) -> "MultipartResponseWrapper": + return self + + async def __anext__( + self, + ) -> Union["MultipartReader", "BodyPartReader"]: + part = await self.next() + if part is None: + raise StopAsyncIteration + return part + + def at_eof(self) -> bool: + """Returns True when all response data had been read.""" + return self.resp.content.at_eof() + + async def next( + self, + ) -> Optional[Union["MultipartReader", "BodyPartReader"]]: + """Emits next multipart reader object.""" + item = await self.stream.next() + if self.stream.at_eof(): + await self.release() + return item + + async def release(self) -> None: + """Release the connection gracefully. + + All remaining content is read to the void. + """ + await self.resp.release() + + +class BodyPartReader: + """Multipart reader for single body part.""" + + chunk_size = 8192 + + def __init__( + self, + boundary: bytes, + headers: "CIMultiDictProxy[str]", + content: StreamReader, + *, + subtype: str = "mixed", + default_charset: Optional[str] = None, + max_decompress_size: int = DEFAULT_MAX_DECOMPRESS_SIZE, + ) -> None: + self.headers = headers + self._boundary = boundary + self._boundary_len = len(boundary) + 2 # Boundary + \r\n + self._content = content + self._default_charset = default_charset + self._at_eof = False + self._is_form_data = subtype == "form-data" + # https://datatracker.ietf.org/doc/html/rfc7578#section-4.8 + length = None if self._is_form_data else self.headers.get(CONTENT_LENGTH, None) + self._length = int(length) if length is not None else None + self._read_bytes = 0 + self._unread: Deque[bytes] = deque() + self._prev_chunk: Optional[bytes] = None + self._content_eof = 0 + self._cache: Dict[str, Any] = {} + self._max_decompress_size = max_decompress_size + + def __aiter__(self: Self) -> Self: + return self + + async def __anext__(self) -> bytes: + part = await self.next() + if part is None: + raise StopAsyncIteration + return part + + async def next(self) -> Optional[bytes]: + item = await self.read() + if not item: + return None + return item + + async def read(self, *, decode: bool = False) -> bytes: + """Reads body part data. + + decode: Decodes data following by encoding + method from Content-Encoding header. If it missed + data remains untouched + """ + if self._at_eof: + return b"" + data = bytearray() + while not self._at_eof: + data.extend(await self.read_chunk(self.chunk_size)) + if decode: + return await self.decode(data) + return data + + async def read_chunk(self, size: int = chunk_size) -> bytes: + """Reads body part content chunk of the specified size. + + size: chunk size + """ + if self._at_eof: + return b"" + if self._length: + chunk = await self._read_chunk_from_length(size) + else: + chunk = await self._read_chunk_from_stream(size) + + # For the case of base64 data, we must read a fragment of size with a + # remainder of 0 by dividing by 4 for string without symbols \n or \r + encoding = self.headers.get(CONTENT_TRANSFER_ENCODING) + if encoding and encoding.lower() == "base64": + stripped_chunk = b"".join(chunk.split()) + remainder = len(stripped_chunk) % 4 + + while remainder != 0 and not self.at_eof(): + over_chunk_size = 4 - remainder + over_chunk = b"" + + if self._prev_chunk: + over_chunk = self._prev_chunk[:over_chunk_size] + self._prev_chunk = self._prev_chunk[len(over_chunk) :] + + if len(over_chunk) != over_chunk_size: + over_chunk += await self._content.read(4 - len(over_chunk)) + + if not over_chunk: + self._at_eof = True + + stripped_chunk += b"".join(over_chunk.split()) + chunk += over_chunk + remainder = len(stripped_chunk) % 4 + + self._read_bytes += len(chunk) + if self._read_bytes == self._length: + self._at_eof = True + if self._at_eof and await self._content.readline() != b"\r\n": + raise ValueError("Reader did not read all the data or it is malformed") + return chunk + + async def _read_chunk_from_length(self, size: int) -> bytes: + # Reads body part content chunk of the specified size. + # The body part must has Content-Length header with proper value. + assert self._length is not None, "Content-Length required for chunked read" + chunk_size = min(size, self._length - self._read_bytes) + chunk = await self._content.read(chunk_size) + if self._content.at_eof(): + self._at_eof = True + return chunk + + async def _read_chunk_from_stream(self, size: int) -> bytes: + # Reads content chunk of body part with unknown length. + # The Content-Length header for body part is not necessary. + assert ( + size >= self._boundary_len + ), "Chunk size must be greater or equal than boundary length + 2" + first_chunk = self._prev_chunk is None + if first_chunk: + # We need to re-add the CRLF that got removed from headers parsing. + self._prev_chunk = b"\r\n" + await self._content.read(size) + + chunk = b"" + # content.read() may return less than size, so we need to loop to ensure + # we have enough data to detect the boundary. + while len(chunk) < self._boundary_len: + chunk += await self._content.read(size) + self._content_eof += int(self._content.at_eof()) + if self._content_eof > 2: + raise ValueError("Reading after EOF") + if self._content_eof: + break + if len(chunk) > size: + self._content.unread_data(chunk[size:]) + chunk = chunk[:size] + + assert self._prev_chunk is not None + window = self._prev_chunk + chunk + sub = b"\r\n" + self._boundary + if first_chunk: + idx = window.find(sub) + else: + idx = window.find(sub, max(0, len(self._prev_chunk) - len(sub))) + if idx >= 0: + # pushing boundary back to content + with warnings.catch_warnings(): + warnings.filterwarnings("ignore", category=DeprecationWarning) + self._content.unread_data(window[idx:]) + self._prev_chunk = self._prev_chunk[:idx] + chunk = window[len(self._prev_chunk) : idx] + if not chunk: + self._at_eof = True + result = self._prev_chunk[2 if first_chunk else 0 :] # Strip initial CRLF + self._prev_chunk = chunk + return result + + async def readline(self) -> bytes: + """Reads body part by line by line.""" + if self._at_eof: + return b"" + + if self._unread: + line = self._unread.popleft() + else: + line = await self._content.readline() + + if line.startswith(self._boundary): + # the very last boundary may not come with \r\n, + # so set single rules for everyone + sline = line.rstrip(b"\r\n") + boundary = self._boundary + last_boundary = self._boundary + b"--" + # ensure that we read exactly the boundary, not something alike + if sline == boundary or sline == last_boundary: + self._at_eof = True + self._unread.append(line) + return b"" + else: + next_line = await self._content.readline() + if next_line.startswith(self._boundary): + line = line[:-2] # strip CRLF but only once + self._unread.append(next_line) + + return line + + async def release(self) -> None: + """Like read(), but reads all the data to the void.""" + if self._at_eof: + return + while not self._at_eof: + await self.read_chunk(self.chunk_size) + + async def text(self, *, encoding: Optional[str] = None) -> str: + """Like read(), but assumes that body part contains text data.""" + data = await self.read(decode=True) + # see https://www.w3.org/TR/html5/forms.html#multipart/form-data-encoding-algorithm + # and https://dvcs.w3.org/hg/xhr/raw-file/tip/Overview.html#dom-xmlhttprequest-send + encoding = encoding or self.get_charset(default="utf-8") + return data.decode(encoding) + + async def json(self, *, encoding: Optional[str] = None) -> Optional[Dict[str, Any]]: + """Like read(), but assumes that body parts contains JSON data.""" + data = await self.read(decode=True) + if not data: + return None + encoding = encoding or self.get_charset(default="utf-8") + return cast(Dict[str, Any], json.loads(data.decode(encoding))) + + async def form(self, *, encoding: Optional[str] = None) -> List[Tuple[str, str]]: + """Like read(), but assumes that body parts contain form urlencoded data.""" + data = await self.read(decode=True) + if not data: + return [] + if encoding is not None: + real_encoding = encoding + else: + real_encoding = self.get_charset(default="utf-8") + try: + decoded_data = data.rstrip().decode(real_encoding) + except UnicodeDecodeError: + raise ValueError("data cannot be decoded with %s encoding" % real_encoding) + + return parse_qsl( + decoded_data, + keep_blank_values=True, + encoding=real_encoding, + ) + + def at_eof(self) -> bool: + """Returns True if the boundary was reached or False otherwise.""" + return self._at_eof + + async def decode(self, data: bytes) -> bytes: + """Decodes data. + + Decoding is done according the specified Content-Encoding + or Content-Transfer-Encoding headers value. + """ + if CONTENT_TRANSFER_ENCODING in self.headers: + data = self._decode_content_transfer(data) + # https://datatracker.ietf.org/doc/html/rfc7578#section-4.8 + if not self._is_form_data and CONTENT_ENCODING in self.headers: + return await self._decode_content(data) + return data + + async def _decode_content(self, data: bytes) -> bytes: + encoding = self.headers.get(CONTENT_ENCODING, "").lower() + if encoding == "identity": + return data + if encoding in {"deflate", "gzip"}: + return await ZLibDecompressor( + encoding=encoding, + suppress_deflate_header=True, + ).decompress(data, max_length=self._max_decompress_size) + + raise RuntimeError(f"unknown content encoding: {encoding}") + + def _decode_content_transfer(self, data: bytes) -> bytes: + encoding = self.headers.get(CONTENT_TRANSFER_ENCODING, "").lower() + + if encoding == "base64": + return base64.b64decode(data) + elif encoding == "quoted-printable": + return binascii.a2b_qp(data) + elif encoding in ("binary", "8bit", "7bit"): + return data + else: + raise RuntimeError(f"unknown content transfer encoding: {encoding}") + + def get_charset(self, default: str) -> str: + """Returns charset parameter from Content-Type header or default.""" + ctype = self.headers.get(CONTENT_TYPE, "") + mimetype = parse_mimetype(ctype) + return mimetype.parameters.get("charset", self._default_charset or default) + + @reify + def name(self) -> Optional[str]: + """Returns name specified in Content-Disposition header. + + If the header is missing or malformed, returns None. + """ + _, params = parse_content_disposition(self.headers.get(CONTENT_DISPOSITION)) + return content_disposition_filename(params, "name") + + @reify + def filename(self) -> Optional[str]: + """Returns filename specified in Content-Disposition header. + + Returns None if the header is missing or malformed. + """ + _, params = parse_content_disposition(self.headers.get(CONTENT_DISPOSITION)) + return content_disposition_filename(params, "filename") + + +@payload_type(BodyPartReader, order=Order.try_first) +class BodyPartReaderPayload(Payload): + _value: BodyPartReader + # _autoclose = False (inherited) - Streaming reader that may have resources + + def __init__(self, value: BodyPartReader, *args: Any, **kwargs: Any) -> None: + super().__init__(value, *args, **kwargs) + + params: Dict[str, str] = {} + if value.name is not None: + params["name"] = value.name + if value.filename is not None: + params["filename"] = value.filename + + if params: + self.set_content_disposition("attachment", True, **params) + + def decode(self, encoding: str = "utf-8", errors: str = "strict") -> str: + raise TypeError("Unable to decode.") + + async def as_bytes(self, encoding: str = "utf-8", errors: str = "strict") -> bytes: + """Raises TypeError as body parts should be consumed via write(). + + This is intentional: BodyPartReader payloads are designed for streaming + large data (potentially gigabytes) and must be consumed only once via + the write() method to avoid memory exhaustion. They cannot be buffered + in memory for reuse. + """ + raise TypeError("Unable to read body part as bytes. Use write() to consume.") + + async def write(self, writer: AbstractStreamWriter) -> None: + field = self._value + chunk = await field.read_chunk(size=2**16) + while chunk: + await writer.write(await field.decode(chunk)) + chunk = await field.read_chunk(size=2**16) + + +class MultipartReader: + """Multipart body reader.""" + + #: Response wrapper, used when multipart readers constructs from response. + response_wrapper_cls = MultipartResponseWrapper + #: Multipart reader class, used to handle multipart/* body parts. + #: None points to type(self) + multipart_reader_cls: Optional[Type["MultipartReader"]] = None + #: Body part reader class for non multipart/* content types. + part_reader_cls = BodyPartReader + + def __init__(self, headers: Mapping[str, str], content: StreamReader) -> None: + self._mimetype = parse_mimetype(headers[CONTENT_TYPE]) + assert self._mimetype.type == "multipart", "multipart/* content type expected" + if "boundary" not in self._mimetype.parameters: + raise ValueError( + "boundary missed for Content-Type: %s" % headers[CONTENT_TYPE] + ) + + self.headers = headers + self._boundary = ("--" + self._get_boundary()).encode() + self._content = content + self._default_charset: Optional[str] = None + self._last_part: Optional[Union["MultipartReader", BodyPartReader]] = None + self._at_eof = False + self._at_bof = True + self._unread: List[bytes] = [] + + def __aiter__(self: Self) -> Self: + return self + + async def __anext__( + self, + ) -> Optional[Union["MultipartReader", BodyPartReader]]: + part = await self.next() + if part is None: + raise StopAsyncIteration + return part + + @classmethod + def from_response( + cls, + response: "ClientResponse", + ) -> MultipartResponseWrapper: + """Constructs reader instance from HTTP response. + + :param response: :class:`~aiohttp.client.ClientResponse` instance + """ + obj = cls.response_wrapper_cls( + response, cls(response.headers, response.content) + ) + return obj + + def at_eof(self) -> bool: + """Returns True if the final boundary was reached, false otherwise.""" + return self._at_eof + + async def next( + self, + ) -> Optional[Union["MultipartReader", BodyPartReader]]: + """Emits the next multipart body part.""" + # So, if we're at BOF, we need to skip till the boundary. + if self._at_eof: + return None + await self._maybe_release_last_part() + if self._at_bof: + await self._read_until_first_boundary() + self._at_bof = False + else: + await self._read_boundary() + if self._at_eof: # we just read the last boundary, nothing to do there + return None + + part = await self.fetch_next_part() + # https://datatracker.ietf.org/doc/html/rfc7578#section-4.6 + if ( + self._last_part is None + and self._mimetype.subtype == "form-data" + and isinstance(part, BodyPartReader) + ): + _, params = parse_content_disposition(part.headers.get(CONTENT_DISPOSITION)) + if params.get("name") == "_charset_": + # Longest encoding in https://encoding.spec.whatwg.org/encodings.json + # is 19 characters, so 32 should be more than enough for any valid encoding. + charset = await part.read_chunk(32) + if len(charset) > 31: + raise RuntimeError("Invalid default charset") + self._default_charset = charset.strip().decode() + part = await self.fetch_next_part() + self._last_part = part + return self._last_part + + async def release(self) -> None: + """Reads all the body parts to the void till the final boundary.""" + while not self._at_eof: + item = await self.next() + if item is None: + break + await item.release() + + async def fetch_next_part( + self, + ) -> Union["MultipartReader", BodyPartReader]: + """Returns the next body part reader.""" + headers = await self._read_headers() + return self._get_part_reader(headers) + + def _get_part_reader( + self, + headers: "CIMultiDictProxy[str]", + ) -> Union["MultipartReader", BodyPartReader]: + """Dispatches the response by the `Content-Type` header. + + Returns a suitable reader instance. + + :param dict headers: Response headers + """ + ctype = headers.get(CONTENT_TYPE, "") + mimetype = parse_mimetype(ctype) + + if mimetype.type == "multipart": + if self.multipart_reader_cls is None: + return type(self)(headers, self._content) + return self.multipart_reader_cls(headers, self._content) + else: + return self.part_reader_cls( + self._boundary, + headers, + self._content, + subtype=self._mimetype.subtype, + default_charset=self._default_charset, + ) + + def _get_boundary(self) -> str: + boundary = self._mimetype.parameters["boundary"] + if len(boundary) > 70: + raise ValueError("boundary %r is too long (70 chars max)" % boundary) + + return boundary + + async def _readline(self) -> bytes: + if self._unread: + return self._unread.pop() + return await self._content.readline() + + async def _read_until_first_boundary(self) -> None: + while True: + chunk = await self._readline() + if chunk == b"": + raise ValueError( + "Could not find starting boundary %r" % (self._boundary) + ) + chunk = chunk.rstrip() + if chunk == self._boundary: + return + elif chunk == self._boundary + b"--": + self._at_eof = True + return + + async def _read_boundary(self) -> None: + chunk = (await self._readline()).rstrip() + if chunk == self._boundary: + pass + elif chunk == self._boundary + b"--": + self._at_eof = True + epilogue = await self._readline() + next_line = await self._readline() + + # the epilogue is expected and then either the end of input or the + # parent multipart boundary, if the parent boundary is found then + # it should be marked as unread and handed to the parent for + # processing + if next_line[:2] == b"--": + self._unread.append(next_line) + # otherwise the request is likely missing an epilogue and both + # lines should be passed to the parent for processing + # (this handles the old behavior gracefully) + else: + self._unread.extend([next_line, epilogue]) + else: + raise ValueError(f"Invalid boundary {chunk!r}, expected {self._boundary!r}") + + async def _read_headers(self) -> "CIMultiDictProxy[str]": + lines = [] + while True: + chunk = await self._content.readline() + chunk = chunk.rstrip(b"\r\n") + lines.append(chunk) + if not chunk: + break + parser = HeadersParser() + headers, raw_headers = parser.parse_headers(lines) + return headers + + async def _maybe_release_last_part(self) -> None: + """Ensures that the last read body part is read completely.""" + if self._last_part is not None: + if not self._last_part.at_eof(): + await self._last_part.release() + self._unread.extend(self._last_part._unread) + self._last_part = None + + +_Part = Tuple[Payload, str, str] + + +class MultipartWriter(Payload): + """Multipart body writer.""" + + _value: None + # _consumed = False (inherited) - Can be encoded multiple times + _autoclose = True # No file handles, just collects parts in memory + + def __init__(self, subtype: str = "mixed", boundary: Optional[str] = None) -> None: + boundary = boundary if boundary is not None else uuid.uuid4().hex + # The underlying Payload API demands a str (utf-8), not bytes, + # so we need to ensure we don't lose anything during conversion. + # As a result, require the boundary to be ASCII only. + # In both situations. + + try: + self._boundary = boundary.encode("ascii") + except UnicodeEncodeError: + raise ValueError("boundary should contain ASCII only chars") from None + ctype = f"multipart/{subtype}; boundary={self._boundary_value}" + + super().__init__(None, content_type=ctype) + + self._parts: List[_Part] = [] + self._is_form_data = subtype == "form-data" + + def __enter__(self) -> "MultipartWriter": + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + pass + + def __iter__(self) -> Iterator[_Part]: + return iter(self._parts) + + def __len__(self) -> int: + return len(self._parts) + + def __bool__(self) -> bool: + return True + + _valid_tchar_regex = re.compile(rb"\A[!#$%&'*+\-.^_`|~\w]+\Z") + _invalid_qdtext_char_regex = re.compile(rb"[\x00-\x08\x0A-\x1F\x7F]") + + @property + def _boundary_value(self) -> str: + """Wrap boundary parameter value in quotes, if necessary. + + Reads self.boundary and returns a unicode string. + """ + # Refer to RFCs 7231, 7230, 5234. + # + # parameter = token "=" ( token / quoted-string ) + # token = 1*tchar + # quoted-string = DQUOTE *( qdtext / quoted-pair ) DQUOTE + # qdtext = HTAB / SP / %x21 / %x23-5B / %x5D-7E / obs-text + # obs-text = %x80-FF + # quoted-pair = "\" ( HTAB / SP / VCHAR / obs-text ) + # tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" + # / "+" / "-" / "." / "^" / "_" / "`" / "|" / "~" + # / DIGIT / ALPHA + # ; any VCHAR, except delimiters + # VCHAR = %x21-7E + value = self._boundary + if re.match(self._valid_tchar_regex, value): + return value.decode("ascii") # cannot fail + + if re.search(self._invalid_qdtext_char_regex, value): + raise ValueError("boundary value contains invalid characters") + + # escape %x5C and %x22 + quoted_value_content = value.replace(b"\\", b"\\\\") + quoted_value_content = quoted_value_content.replace(b'"', b'\\"') + + return '"' + quoted_value_content.decode("ascii") + '"' + + @property + def boundary(self) -> str: + return self._boundary.decode("ascii") + + def append(self, obj: Any, headers: Optional[Mapping[str, str]] = None) -> Payload: + if headers is None: + headers = CIMultiDict() + + if isinstance(obj, Payload): + obj.headers.update(headers) + return self.append_payload(obj) + else: + try: + payload = get_payload(obj, headers=headers) + except LookupError: + raise TypeError("Cannot create payload from %r" % obj) + else: + return self.append_payload(payload) + + def append_payload(self, payload: Payload) -> Payload: + """Adds a new body part to multipart writer.""" + encoding: Optional[str] = None + te_encoding: Optional[str] = None + if self._is_form_data: + # https://datatracker.ietf.org/doc/html/rfc7578#section-4.7 + # https://datatracker.ietf.org/doc/html/rfc7578#section-4.8 + assert ( + not {CONTENT_ENCODING, CONTENT_LENGTH, CONTENT_TRANSFER_ENCODING} + & payload.headers.keys() + ) + # Set default Content-Disposition in case user doesn't create one + if CONTENT_DISPOSITION not in payload.headers: + name = f"section-{len(self._parts)}" + payload.set_content_disposition("form-data", name=name) + else: + # compression + encoding = payload.headers.get(CONTENT_ENCODING, "").lower() + if encoding and encoding not in ("deflate", "gzip", "identity"): + raise RuntimeError(f"unknown content encoding: {encoding}") + if encoding == "identity": + encoding = None + + # te encoding + te_encoding = payload.headers.get(CONTENT_TRANSFER_ENCODING, "").lower() + if te_encoding not in ("", "base64", "quoted-printable", "binary"): + raise RuntimeError(f"unknown content transfer encoding: {te_encoding}") + if te_encoding == "binary": + te_encoding = None + + # size + size = payload.size + if size is not None and not (encoding or te_encoding): + payload.headers[CONTENT_LENGTH] = str(size) + + self._parts.append((payload, encoding, te_encoding)) # type: ignore[arg-type] + return payload + + def append_json( + self, obj: Any, headers: Optional[Mapping[str, str]] = None + ) -> Payload: + """Helper to append JSON part.""" + if headers is None: + headers = CIMultiDict() + + return self.append_payload(JsonPayload(obj, headers=headers)) + + def append_form( + self, + obj: Union[Sequence[Tuple[str, str]], Mapping[str, str]], + headers: Optional[Mapping[str, str]] = None, + ) -> Payload: + """Helper to append form urlencoded part.""" + assert isinstance(obj, (Sequence, Mapping)) + + if headers is None: + headers = CIMultiDict() + + if isinstance(obj, Mapping): + obj = list(obj.items()) + data = urlencode(obj, doseq=True) + + return self.append_payload( + StringPayload( + data, headers=headers, content_type="application/x-www-form-urlencoded" + ) + ) + + @property + def size(self) -> Optional[int]: + """Size of the payload.""" + total = 0 + for part, encoding, te_encoding in self._parts: + part_size = part.size + if encoding or te_encoding or part_size is None: + return None + + total += int( + 2 + + len(self._boundary) + + 2 + + part_size # b'--'+self._boundary+b'\r\n' + + len(part._binary_headers) + + 2 # b'\r\n' + ) + + total += 2 + len(self._boundary) + 4 # b'--'+self._boundary+b'--\r\n' + return total + + def decode(self, encoding: str = "utf-8", errors: str = "strict") -> str: + """Return string representation of the multipart data. + + WARNING: This method may do blocking I/O if parts contain file payloads. + It should not be called in the event loop. Use as_bytes().decode() instead. + """ + return "".join( + "--" + + self.boundary + + "\r\n" + + part._binary_headers.decode(encoding, errors) + + part.decode() + for part, _e, _te in self._parts + ) + + async def as_bytes(self, encoding: str = "utf-8", errors: str = "strict") -> bytes: + """Return bytes representation of the multipart data. + + This method is async-safe and calls as_bytes on underlying payloads. + """ + parts: List[bytes] = [] + + # Process each part + for part, _e, _te in self._parts: + # Add boundary + parts.append(b"--" + self._boundary + b"\r\n") + + # Add headers + parts.append(part._binary_headers) + + # Add payload content using as_bytes for async safety + part_bytes = await part.as_bytes(encoding, errors) + parts.append(part_bytes) + + # Add trailing CRLF + parts.append(b"\r\n") + + # Add closing boundary + parts.append(b"--" + self._boundary + b"--\r\n") + + return b"".join(parts) + + async def write( + self, writer: AbstractStreamWriter, close_boundary: bool = True + ) -> None: + """Write body.""" + for part, encoding, te_encoding in self._parts: + if self._is_form_data: + # https://datatracker.ietf.org/doc/html/rfc7578#section-4.2 + assert CONTENT_DISPOSITION in part.headers + assert "name=" in part.headers[CONTENT_DISPOSITION] + + await writer.write(b"--" + self._boundary + b"\r\n") + await writer.write(part._binary_headers) + + if encoding or te_encoding: + w = MultipartPayloadWriter(writer) + if encoding: + w.enable_compression(encoding) + if te_encoding: + w.enable_encoding(te_encoding) + await part.write(w) # type: ignore[arg-type] + await w.write_eof() + else: + await part.write(writer) + + await writer.write(b"\r\n") + + if close_boundary: + await writer.write(b"--" + self._boundary + b"--\r\n") + + async def close(self) -> None: + """ + Close all part payloads that need explicit closing. + + IMPORTANT: This method must not await anything that might not finish + immediately, as it may be called during cleanup/cancellation. Schedule + any long-running operations without awaiting them. + """ + if self._consumed: + return + self._consumed = True + + # Close all parts that need explicit closing + # We catch and log exceptions to ensure all parts get a chance to close + # we do not use asyncio.gather() here because we are not allowed + # to suspend given we may be called during cleanup + for idx, (part, _, _) in enumerate(self._parts): + if not part.autoclose and not part.consumed: + try: + await part.close() + except Exception as exc: + internal_logger.error( + "Failed to close multipart part %d: %s", idx, exc, exc_info=True + ) + + +class MultipartPayloadWriter: + def __init__(self, writer: AbstractStreamWriter) -> None: + self._writer = writer + self._encoding: Optional[str] = None + self._compress: Optional[ZLibCompressor] = None + self._encoding_buffer: Optional[bytearray] = None + + def enable_encoding(self, encoding: str) -> None: + if encoding == "base64": + self._encoding = encoding + self._encoding_buffer = bytearray() + elif encoding == "quoted-printable": + self._encoding = "quoted-printable" + + def enable_compression( + self, encoding: str = "deflate", strategy: Optional[int] = None + ) -> None: + self._compress = ZLibCompressor( + encoding=encoding, + suppress_deflate_header=True, + strategy=strategy, + ) + + async def write_eof(self) -> None: + if self._compress is not None: + chunk = self._compress.flush() + if chunk: + self._compress = None + await self.write(chunk) + + if self._encoding == "base64": + if self._encoding_buffer: + await self._writer.write(base64.b64encode(self._encoding_buffer)) + + async def write(self, chunk: bytes) -> None: + if self._compress is not None: + if chunk: + chunk = await self._compress.compress(chunk) + if not chunk: + return + + if self._encoding == "base64": + buf = self._encoding_buffer + assert buf is not None + buf.extend(chunk) + + if buf: + div, mod = divmod(len(buf), 3) + enc_chunk, self._encoding_buffer = (buf[: div * 3], buf[div * 3 :]) + if enc_chunk: + b64chunk = base64.b64encode(enc_chunk) + await self._writer.write(b64chunk) + elif self._encoding == "quoted-printable": + await self._writer.write(binascii.b2a_qp(chunk)) + else: + await self._writer.write(chunk) diff --git a/env/lib/python3.12/site-packages/aiohttp/payload.py b/env/lib/python3.12/site-packages/aiohttp/payload.py new file mode 100644 index 0000000..5b88fa0 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/payload.py @@ -0,0 +1,1120 @@ +import asyncio +import enum +import io +import json +import mimetypes +import os +import sys +import warnings +from abc import ABC, abstractmethod +from collections.abc import Iterable +from itertools import chain +from typing import ( + IO, + TYPE_CHECKING, + Any, + Dict, + Final, + List, + Optional, + Set, + TextIO, + Tuple, + Type, + Union, +) + +from multidict import CIMultiDict + +from . import hdrs +from .abc import AbstractStreamWriter +from .helpers import ( + _SENTINEL, + content_disposition_header, + guess_filename, + parse_mimetype, + sentinel, +) +from .streams import StreamReader +from .typedefs import JSONEncoder, _CIMultiDict + +__all__ = ( + "PAYLOAD_REGISTRY", + "get_payload", + "payload_type", + "Payload", + "BytesPayload", + "StringPayload", + "IOBasePayload", + "BytesIOPayload", + "BufferedReaderPayload", + "TextIOPayload", + "StringIOPayload", + "JsonPayload", + "AsyncIterablePayload", +) + +TOO_LARGE_BYTES_BODY: Final[int] = 2**20 # 1 MB +READ_SIZE: Final[int] = 2**16 # 64 KB +_CLOSE_FUTURES: Set[asyncio.Future[None]] = set() + + +class LookupError(Exception): + """Raised when no payload factory is found for the given data type.""" + + +class Order(str, enum.Enum): + normal = "normal" + try_first = "try_first" + try_last = "try_last" + + +def get_payload(data: Any, *args: Any, **kwargs: Any) -> "Payload": + return PAYLOAD_REGISTRY.get(data, *args, **kwargs) + + +def register_payload( + factory: Type["Payload"], type: Any, *, order: Order = Order.normal +) -> None: + PAYLOAD_REGISTRY.register(factory, type, order=order) + + +class payload_type: + def __init__(self, type: Any, *, order: Order = Order.normal) -> None: + self.type = type + self.order = order + + def __call__(self, factory: Type["Payload"]) -> Type["Payload"]: + register_payload(factory, self.type, order=self.order) + return factory + + +PayloadType = Type["Payload"] +_PayloadRegistryItem = Tuple[PayloadType, Any] + + +class PayloadRegistry: + """Payload registry. + + note: we need zope.interface for more efficient adapter search + """ + + __slots__ = ("_first", "_normal", "_last", "_normal_lookup") + + def __init__(self) -> None: + self._first: List[_PayloadRegistryItem] = [] + self._normal: List[_PayloadRegistryItem] = [] + self._last: List[_PayloadRegistryItem] = [] + self._normal_lookup: Dict[Any, PayloadType] = {} + + def get( + self, + data: Any, + *args: Any, + _CHAIN: "Type[chain[_PayloadRegistryItem]]" = chain, + **kwargs: Any, + ) -> "Payload": + if self._first: + for factory, type_ in self._first: + if isinstance(data, type_): + return factory(data, *args, **kwargs) + # Try the fast lookup first + if lookup_factory := self._normal_lookup.get(type(data)): + return lookup_factory(data, *args, **kwargs) + # Bail early if its already a Payload + if isinstance(data, Payload): + return data + # Fallback to the slower linear search + for factory, type_ in _CHAIN(self._normal, self._last): + if isinstance(data, type_): + return factory(data, *args, **kwargs) + raise LookupError() + + def register( + self, factory: PayloadType, type: Any, *, order: Order = Order.normal + ) -> None: + if order is Order.try_first: + self._first.append((factory, type)) + elif order is Order.normal: + self._normal.append((factory, type)) + if isinstance(type, Iterable): + for t in type: + self._normal_lookup[t] = factory + else: + self._normal_lookup[type] = factory + elif order is Order.try_last: + self._last.append((factory, type)) + else: + raise ValueError(f"Unsupported order {order!r}") + + +class Payload(ABC): + + _default_content_type: str = "application/octet-stream" + _size: Optional[int] = None + _consumed: bool = False # Default: payload has not been consumed yet + _autoclose: bool = False # Default: assume resource needs explicit closing + + def __init__( + self, + value: Any, + headers: Optional[ + Union[_CIMultiDict, Dict[str, str], Iterable[Tuple[str, str]]] + ] = None, + content_type: Union[str, None, _SENTINEL] = sentinel, + filename: Optional[str] = None, + encoding: Optional[str] = None, + **kwargs: Any, + ) -> None: + self._encoding = encoding + self._filename = filename + self._headers: _CIMultiDict = CIMultiDict() + self._value = value + if content_type is not sentinel and content_type is not None: + self._headers[hdrs.CONTENT_TYPE] = content_type + elif self._filename is not None: + if sys.version_info >= (3, 13): + guesser = mimetypes.guess_file_type + else: + guesser = mimetypes.guess_type + content_type = guesser(self._filename)[0] + if content_type is None: + content_type = self._default_content_type + self._headers[hdrs.CONTENT_TYPE] = content_type + else: + self._headers[hdrs.CONTENT_TYPE] = self._default_content_type + if headers: + self._headers.update(headers) + + @property + def size(self) -> Optional[int]: + """Size of the payload in bytes. + + Returns the number of bytes that will be transmitted when the payload + is written. For string payloads, this is the size after encoding to bytes, + not the length of the string. + """ + return self._size + + @property + def filename(self) -> Optional[str]: + """Filename of the payload.""" + return self._filename + + @property + def headers(self) -> _CIMultiDict: + """Custom item headers""" + return self._headers + + @property + def _binary_headers(self) -> bytes: + return ( + "".join([k + ": " + v + "\r\n" for k, v in self.headers.items()]).encode( + "utf-8" + ) + + b"\r\n" + ) + + @property + def encoding(self) -> Optional[str]: + """Payload encoding""" + return self._encoding + + @property + def content_type(self) -> str: + """Content type""" + return self._headers[hdrs.CONTENT_TYPE] + + @property + def consumed(self) -> bool: + """Whether the payload has been consumed and cannot be reused.""" + return self._consumed + + @property + def autoclose(self) -> bool: + """ + Whether the payload can close itself automatically. + + Returns True if the payload has no file handles or resources that need + explicit closing. If False, callers must await close() to release resources. + """ + return self._autoclose + + def set_content_disposition( + self, + disptype: str, + quote_fields: bool = True, + _charset: str = "utf-8", + **params: Any, + ) -> None: + """Sets ``Content-Disposition`` header.""" + self._headers[hdrs.CONTENT_DISPOSITION] = content_disposition_header( + disptype, quote_fields=quote_fields, _charset=_charset, **params + ) + + @abstractmethod + def decode(self, encoding: str = "utf-8", errors: str = "strict") -> str: + """ + Return string representation of the value. + + This is named decode() to allow compatibility with bytes objects. + """ + + @abstractmethod + async def write(self, writer: AbstractStreamWriter) -> None: + """ + Write payload to the writer stream. + + Args: + writer: An AbstractStreamWriter instance that handles the actual writing + + This is a legacy method that writes the entire payload without length constraints. + + Important: + For new implementations, use write_with_length() instead of this method. + This method is maintained for backwards compatibility and will eventually + delegate to write_with_length(writer, None) in all implementations. + + All payload subclasses must override this method for backwards compatibility, + but new code should use write_with_length for more flexibility and control. + + """ + + # write_with_length is new in aiohttp 3.12 + # it should be overridden by subclasses + async def write_with_length( + self, writer: AbstractStreamWriter, content_length: Optional[int] + ) -> None: + """ + Write payload with a specific content length constraint. + + Args: + writer: An AbstractStreamWriter instance that handles the actual writing + content_length: Maximum number of bytes to write (None for unlimited) + + This method allows writing payload content with a specific length constraint, + which is particularly useful for HTTP responses with Content-Length header. + + Note: + This is the base implementation that provides backwards compatibility + for subclasses that don't override this method. Specific payload types + should override this method to implement proper length-constrained writing. + + """ + # Backwards compatibility for subclasses that don't override this method + # and for the default implementation + await self.write(writer) + + async def as_bytes(self, encoding: str = "utf-8", errors: str = "strict") -> bytes: + """ + Return bytes representation of the value. + + This is a convenience method that calls decode() and encodes the result + to bytes using the specified encoding. + """ + # Use instance encoding if available, otherwise use parameter + actual_encoding = self._encoding or encoding + return self.decode(actual_encoding, errors).encode(actual_encoding) + + def _close(self) -> None: + """ + Async safe synchronous close operations for backwards compatibility. + + This method exists only for backwards compatibility with code that + needs to clean up payloads synchronously. In the future, we will + drop this method and only support the async close() method. + + WARNING: This method must be safe to call from within the event loop + without blocking. Subclasses should not perform any blocking I/O here. + + WARNING: This method must be called from within an event loop for + certain payload types (e.g., IOBasePayload). Calling it outside an + event loop may raise RuntimeError. + """ + # This is a no-op by default, but subclasses can override it + # for non-blocking cleanup operations. + + async def close(self) -> None: + """ + Close the payload if it holds any resources. + + IMPORTANT: This method must not await anything that might not finish + immediately, as it may be called during cleanup/cancellation. Schedule + any long-running operations without awaiting them. + + In the future, this will be the only close method supported. + """ + self._close() + + +class BytesPayload(Payload): + _value: bytes + # _consumed = False (inherited) - Bytes are immutable and can be reused + _autoclose = True # No file handle, just bytes in memory + + def __init__( + self, value: Union[bytes, bytearray, memoryview], *args: Any, **kwargs: Any + ) -> None: + if "content_type" not in kwargs: + kwargs["content_type"] = "application/octet-stream" + + super().__init__(value, *args, **kwargs) + + if isinstance(value, memoryview): + self._size = value.nbytes + elif isinstance(value, (bytes, bytearray)): + self._size = len(value) + else: + raise TypeError(f"value argument must be byte-ish, not {type(value)!r}") + + if self._size > TOO_LARGE_BYTES_BODY: + kwargs = {"source": self} + warnings.warn( + "Sending a large body directly with raw bytes might" + " lock the event loop. You should probably pass an " + "io.BytesIO object instead", + ResourceWarning, + **kwargs, + ) + + def decode(self, encoding: str = "utf-8", errors: str = "strict") -> str: + return self._value.decode(encoding, errors) + + async def as_bytes(self, encoding: str = "utf-8", errors: str = "strict") -> bytes: + """ + Return bytes representation of the value. + + This method returns the raw bytes content of the payload. + It is equivalent to accessing the _value attribute directly. + """ + return self._value + + async def write(self, writer: AbstractStreamWriter) -> None: + """ + Write the entire bytes payload to the writer stream. + + Args: + writer: An AbstractStreamWriter instance that handles the actual writing + + This method writes the entire bytes content without any length constraint. + + Note: + For new implementations that need length control, use write_with_length(). + This method is maintained for backwards compatibility and is equivalent + to write_with_length(writer, None). + + """ + await writer.write(self._value) + + async def write_with_length( + self, writer: AbstractStreamWriter, content_length: Optional[int] + ) -> None: + """ + Write bytes payload with a specific content length constraint. + + Args: + writer: An AbstractStreamWriter instance that handles the actual writing + content_length: Maximum number of bytes to write (None for unlimited) + + This method writes either the entire byte sequence or a slice of it + up to the specified content_length. For BytesPayload, this operation + is performed efficiently using array slicing. + + """ + if content_length is not None: + await writer.write(self._value[:content_length]) + else: + await writer.write(self._value) + + +class StringPayload(BytesPayload): + def __init__( + self, + value: str, + *args: Any, + encoding: Optional[str] = None, + content_type: Optional[str] = None, + **kwargs: Any, + ) -> None: + + if encoding is None: + if content_type is None: + real_encoding = "utf-8" + content_type = "text/plain; charset=utf-8" + else: + mimetype = parse_mimetype(content_type) + real_encoding = mimetype.parameters.get("charset", "utf-8") + else: + if content_type is None: + content_type = "text/plain; charset=%s" % encoding + real_encoding = encoding + + super().__init__( + value.encode(real_encoding), + encoding=real_encoding, + content_type=content_type, + *args, + **kwargs, + ) + + +class StringIOPayload(StringPayload): + def __init__(self, value: IO[str], *args: Any, **kwargs: Any) -> None: + super().__init__(value.read(), *args, **kwargs) + + +class IOBasePayload(Payload): + _value: io.IOBase + # _consumed = False (inherited) - File can be re-read from the same position + _start_position: Optional[int] = None + # _autoclose = False (inherited) - Has file handle that needs explicit closing + + def __init__( + self, value: IO[Any], disposition: str = "attachment", *args: Any, **kwargs: Any + ) -> None: + if "filename" not in kwargs: + kwargs["filename"] = guess_filename(value) + + super().__init__(value, *args, **kwargs) + + if self._filename is not None and disposition is not None: + if hdrs.CONTENT_DISPOSITION not in self.headers: + self.set_content_disposition(disposition, filename=self._filename) + + def _set_or_restore_start_position(self) -> None: + """Set or restore the start position of the file-like object.""" + if self._start_position is None: + try: + self._start_position = self._value.tell() + except (OSError, AttributeError): + self._consumed = True # Cannot seek, mark as consumed + return + try: + self._value.seek(self._start_position) + except (OSError, AttributeError): + # Failed to seek back - mark as consumed since we've already read + self._consumed = True + + def _read_and_available_len( + self, remaining_content_len: Optional[int] + ) -> Tuple[Optional[int], bytes]: + """ + Read the file-like object and return both its total size and the first chunk. + + Args: + remaining_content_len: Optional limit on how many bytes to read in this operation. + If None, READ_SIZE will be used as the default chunk size. + + Returns: + A tuple containing: + - The total size of the remaining unread content (None if size cannot be determined) + - The first chunk of bytes read from the file object + + This method is optimized to perform both size calculation and initial read + in a single operation, which is executed in a single executor job to minimize + context switches and file operations when streaming content. + + """ + self._set_or_restore_start_position() + size = self.size # Call size only once since it does I/O + return size, self._value.read( + min(READ_SIZE, size or READ_SIZE, remaining_content_len or READ_SIZE) + ) + + def _read(self, remaining_content_len: Optional[int]) -> bytes: + """ + Read a chunk of data from the file-like object. + + Args: + remaining_content_len: Optional maximum number of bytes to read. + If None, READ_SIZE will be used as the default chunk size. + + Returns: + A chunk of bytes read from the file object, respecting the + remaining_content_len limit if specified. + + This method is used for subsequent reads during streaming after + the initial _read_and_available_len call has been made. + + """ + return self._value.read(remaining_content_len or READ_SIZE) # type: ignore[no-any-return] + + @property + def size(self) -> Optional[int]: + """ + Size of the payload in bytes. + + Returns the total size of the payload content from the initial position. + This ensures consistent Content-Length for requests, including 307/308 redirects + where the same payload instance is reused. + + Returns None if the size cannot be determined (e.g., for unseekable streams). + """ + try: + # Store the start position on first access. + # This is critical when the same payload instance is reused (e.g., 307/308 + # redirects). Without storing the initial position, after the payload is + # read once, the file position would be at EOF, which would cause the + # size calculation to return 0 (file_size - EOF position). + # By storing the start position, we ensure the size calculation always + # returns the correct total size for any subsequent use. + if self._start_position is None: + self._start_position = self._value.tell() + + # Return the total size from the start position + # This ensures Content-Length is correct even after reading + return os.fstat(self._value.fileno()).st_size - self._start_position + except (AttributeError, OSError): + return None + + async def write(self, writer: AbstractStreamWriter) -> None: + """ + Write the entire file-like payload to the writer stream. + + Args: + writer: An AbstractStreamWriter instance that handles the actual writing + + This method writes the entire file content without any length constraint. + It delegates to write_with_length() with no length limit for implementation + consistency. + + Note: + For new implementations that need length control, use write_with_length() directly. + This method is maintained for backwards compatibility with existing code. + + """ + await self.write_with_length(writer, None) + + async def write_with_length( + self, writer: AbstractStreamWriter, content_length: Optional[int] + ) -> None: + """ + Write file-like payload with a specific content length constraint. + + Args: + writer: An AbstractStreamWriter instance that handles the actual writing + content_length: Maximum number of bytes to write (None for unlimited) + + This method implements optimized streaming of file content with length constraints: + + 1. File reading is performed in a thread pool to avoid blocking the event loop + 2. Content is read and written in chunks to maintain memory efficiency + 3. Writing stops when either: + - All available file content has been written (when size is known) + - The specified content_length has been reached + 4. File resources are properly closed even if the operation is cancelled + + The implementation carefully handles both known-size and unknown-size payloads, + as well as constrained and unconstrained content lengths. + + """ + loop = asyncio.get_running_loop() + total_written_len = 0 + remaining_content_len = content_length + + # Get initial data and available length + available_len, chunk = await loop.run_in_executor( + None, self._read_and_available_len, remaining_content_len + ) + # Process data chunks until done + while chunk: + chunk_len = len(chunk) + + # Write data with or without length constraint + if remaining_content_len is None: + await writer.write(chunk) + else: + await writer.write(chunk[:remaining_content_len]) + remaining_content_len -= chunk_len + + total_written_len += chunk_len + + # Check if we're done writing + if self._should_stop_writing( + available_len, total_written_len, remaining_content_len + ): + return + + # Read next chunk + chunk = await loop.run_in_executor( + None, + self._read, + ( + min(READ_SIZE, remaining_content_len) + if remaining_content_len is not None + else READ_SIZE + ), + ) + + def _should_stop_writing( + self, + available_len: Optional[int], + total_written_len: int, + remaining_content_len: Optional[int], + ) -> bool: + """ + Determine if we should stop writing data. + + Args: + available_len: Known size of the payload if available (None if unknown) + total_written_len: Number of bytes already written + remaining_content_len: Remaining bytes to be written for content-length limited responses + + Returns: + True if we should stop writing data, based on either: + - Having written all available data (when size is known) + - Having written all requested content (when content-length is specified) + + """ + return (available_len is not None and total_written_len >= available_len) or ( + remaining_content_len is not None and remaining_content_len <= 0 + ) + + def _close(self) -> None: + """ + Async safe synchronous close operations for backwards compatibility. + + This method exists only for backwards + compatibility. Use the async close() method instead. + + WARNING: This method MUST be called from within an event loop. + Calling it outside an event loop will raise RuntimeError. + """ + # Skip if already consumed + if self._consumed: + return + self._consumed = True # Mark as consumed to prevent further writes + # Schedule file closing without awaiting to prevent cancellation issues + loop = asyncio.get_running_loop() + close_future = loop.run_in_executor(None, self._value.close) + # Hold a strong reference to the future to prevent it from being + # garbage collected before it completes. + _CLOSE_FUTURES.add(close_future) + close_future.add_done_callback(_CLOSE_FUTURES.remove) + + async def close(self) -> None: + """ + Close the payload if it holds any resources. + + IMPORTANT: This method must not await anything that might not finish + immediately, as it may be called during cleanup/cancellation. Schedule + any long-running operations without awaiting them. + """ + self._close() + + def decode(self, encoding: str = "utf-8", errors: str = "strict") -> str: + """ + Return string representation of the value. + + WARNING: This method does blocking I/O and should not be called in the event loop. + """ + return self._read_all().decode(encoding, errors) + + def _read_all(self) -> bytes: + """Read the entire file-like object and return its content as bytes.""" + self._set_or_restore_start_position() + # Use readlines() to ensure we get all content + return b"".join(self._value.readlines()) + + async def as_bytes(self, encoding: str = "utf-8", errors: str = "strict") -> bytes: + """ + Return bytes representation of the value. + + This method reads the entire file content and returns it as bytes. + It is equivalent to reading the file-like object directly. + The file reading is performed in an executor to avoid blocking the event loop. + """ + loop = asyncio.get_running_loop() + return await loop.run_in_executor(None, self._read_all) + + +class TextIOPayload(IOBasePayload): + _value: io.TextIOBase + # _autoclose = False (inherited) - Has text file handle that needs explicit closing + + def __init__( + self, + value: TextIO, + *args: Any, + encoding: Optional[str] = None, + content_type: Optional[str] = None, + **kwargs: Any, + ) -> None: + + if encoding is None: + if content_type is None: + encoding = "utf-8" + content_type = "text/plain; charset=utf-8" + else: + mimetype = parse_mimetype(content_type) + encoding = mimetype.parameters.get("charset", "utf-8") + else: + if content_type is None: + content_type = "text/plain; charset=%s" % encoding + + super().__init__( + value, + content_type=content_type, + encoding=encoding, + *args, + **kwargs, + ) + + def _read_and_available_len( + self, remaining_content_len: Optional[int] + ) -> Tuple[Optional[int], bytes]: + """ + Read the text file-like object and return both its total size and the first chunk. + + Args: + remaining_content_len: Optional limit on how many bytes to read in this operation. + If None, READ_SIZE will be used as the default chunk size. + + Returns: + A tuple containing: + - The total size of the remaining unread content (None if size cannot be determined) + - The first chunk of bytes read from the file object, encoded using the payload's encoding + + This method is optimized to perform both size calculation and initial read + in a single operation, which is executed in a single executor job to minimize + context switches and file operations when streaming content. + + Note: + TextIOPayload handles encoding of the text content before writing it + to the stream. If no encoding is specified, UTF-8 is used as the default. + + """ + self._set_or_restore_start_position() + size = self.size + chunk = self._value.read( + min(READ_SIZE, size or READ_SIZE, remaining_content_len or READ_SIZE) + ) + return size, chunk.encode(self._encoding) if self._encoding else chunk.encode() + + def _read(self, remaining_content_len: Optional[int]) -> bytes: + """ + Read a chunk of data from the text file-like object. + + Args: + remaining_content_len: Optional maximum number of bytes to read. + If None, READ_SIZE will be used as the default chunk size. + + Returns: + A chunk of bytes read from the file object and encoded using the payload's + encoding. The data is automatically converted from text to bytes. + + This method is used for subsequent reads during streaming after + the initial _read_and_available_len call has been made. It properly + handles text encoding, converting the text content to bytes using + the specified encoding (or UTF-8 if none was provided). + + """ + chunk = self._value.read(remaining_content_len or READ_SIZE) + return chunk.encode(self._encoding) if self._encoding else chunk.encode() + + def decode(self, encoding: str = "utf-8", errors: str = "strict") -> str: + """ + Return string representation of the value. + + WARNING: This method does blocking I/O and should not be called in the event loop. + """ + self._set_or_restore_start_position() + return self._value.read() + + async def as_bytes(self, encoding: str = "utf-8", errors: str = "strict") -> bytes: + """ + Return bytes representation of the value. + + This method reads the entire text file content and returns it as bytes. + It encodes the text content using the specified encoding. + The file reading is performed in an executor to avoid blocking the event loop. + """ + loop = asyncio.get_running_loop() + + # Use instance encoding if available, otherwise use parameter + actual_encoding = self._encoding or encoding + + def _read_and_encode() -> bytes: + self._set_or_restore_start_position() + # TextIO read() always returns the full content + return self._value.read().encode(actual_encoding, errors) + + return await loop.run_in_executor(None, _read_and_encode) + + +class BytesIOPayload(IOBasePayload): + _value: io.BytesIO + _size: int # Always initialized in __init__ + _autoclose = True # BytesIO is in-memory, safe to auto-close + + def __init__(self, value: io.BytesIO, *args: Any, **kwargs: Any) -> None: + super().__init__(value, *args, **kwargs) + # Calculate size once during initialization + self._size = len(self._value.getbuffer()) - self._value.tell() + + @property + def size(self) -> int: + """Size of the payload in bytes. + + Returns the number of bytes in the BytesIO buffer that will be transmitted. + This is calculated once during initialization for efficiency. + """ + return self._size + + def decode(self, encoding: str = "utf-8", errors: str = "strict") -> str: + self._set_or_restore_start_position() + return self._value.read().decode(encoding, errors) + + async def write(self, writer: AbstractStreamWriter) -> None: + return await self.write_with_length(writer, None) + + async def write_with_length( + self, writer: AbstractStreamWriter, content_length: Optional[int] + ) -> None: + """ + Write BytesIO payload with a specific content length constraint. + + Args: + writer: An AbstractStreamWriter instance that handles the actual writing + content_length: Maximum number of bytes to write (None for unlimited) + + This implementation is specifically optimized for BytesIO objects: + + 1. Reads content in chunks to maintain memory efficiency + 2. Yields control back to the event loop periodically to prevent blocking + when dealing with large BytesIO objects + 3. Respects content_length constraints when specified + 4. Properly cleans up by closing the BytesIO object when done or on error + + The periodic yielding to the event loop is important for maintaining + responsiveness when processing large in-memory buffers. + + """ + self._set_or_restore_start_position() + loop_count = 0 + remaining_bytes = content_length + while chunk := self._value.read(READ_SIZE): + if loop_count > 0: + # Avoid blocking the event loop + # if they pass a large BytesIO object + # and we are not in the first iteration + # of the loop + await asyncio.sleep(0) + if remaining_bytes is None: + await writer.write(chunk) + else: + await writer.write(chunk[:remaining_bytes]) + remaining_bytes -= len(chunk) + if remaining_bytes <= 0: + return + loop_count += 1 + + async def as_bytes(self, encoding: str = "utf-8", errors: str = "strict") -> bytes: + """ + Return bytes representation of the value. + + This method reads the entire BytesIO content and returns it as bytes. + It is equivalent to accessing the _value attribute directly. + """ + self._set_or_restore_start_position() + return self._value.read() + + async def close(self) -> None: + """ + Close the BytesIO payload. + + This does nothing since BytesIO is in-memory and does not require explicit closing. + """ + + +class BufferedReaderPayload(IOBasePayload): + _value: io.BufferedIOBase + # _autoclose = False (inherited) - Has buffered file handle that needs explicit closing + + def decode(self, encoding: str = "utf-8", errors: str = "strict") -> str: + self._set_or_restore_start_position() + return self._value.read().decode(encoding, errors) + + +class JsonPayload(BytesPayload): + def __init__( + self, + value: Any, + encoding: str = "utf-8", + content_type: str = "application/json", + dumps: JSONEncoder = json.dumps, + *args: Any, + **kwargs: Any, + ) -> None: + + super().__init__( + dumps(value).encode(encoding), + content_type=content_type, + encoding=encoding, + *args, + **kwargs, + ) + + +if TYPE_CHECKING: + from typing import AsyncIterable, AsyncIterator + + _AsyncIterator = AsyncIterator[bytes] + _AsyncIterable = AsyncIterable[bytes] +else: + from collections.abc import AsyncIterable, AsyncIterator + + _AsyncIterator = AsyncIterator + _AsyncIterable = AsyncIterable + + +class AsyncIterablePayload(Payload): + + _iter: Optional[_AsyncIterator] = None + _value: _AsyncIterable + _cached_chunks: Optional[List[bytes]] = None + # _consumed stays False to allow reuse with cached content + _autoclose = True # Iterator doesn't need explicit closing + + def __init__(self, value: _AsyncIterable, *args: Any, **kwargs: Any) -> None: + if not isinstance(value, AsyncIterable): + raise TypeError( + "value argument must support " + "collections.abc.AsyncIterable interface, " + "got {!r}".format(type(value)) + ) + + if "content_type" not in kwargs: + kwargs["content_type"] = "application/octet-stream" + + super().__init__(value, *args, **kwargs) + + self._iter = value.__aiter__() + + async def write(self, writer: AbstractStreamWriter) -> None: + """ + Write the entire async iterable payload to the writer stream. + + Args: + writer: An AbstractStreamWriter instance that handles the actual writing + + This method iterates through the async iterable and writes each chunk + to the writer without any length constraint. + + Note: + For new implementations that need length control, use write_with_length() directly. + This method is maintained for backwards compatibility with existing code. + + """ + await self.write_with_length(writer, None) + + async def write_with_length( + self, writer: AbstractStreamWriter, content_length: Optional[int] + ) -> None: + """ + Write async iterable payload with a specific content length constraint. + + Args: + writer: An AbstractStreamWriter instance that handles the actual writing + content_length: Maximum number of bytes to write (None for unlimited) + + This implementation handles streaming of async iterable content with length constraints: + + 1. If cached chunks are available, writes from them + 2. Otherwise iterates through the async iterable one chunk at a time + 3. Respects content_length constraints when specified + 4. Does NOT generate cache - that's done by as_bytes() + + """ + # If we have cached chunks, use them + if self._cached_chunks is not None: + remaining_bytes = content_length + for chunk in self._cached_chunks: + if remaining_bytes is None: + await writer.write(chunk) + elif remaining_bytes > 0: + await writer.write(chunk[:remaining_bytes]) + remaining_bytes -= len(chunk) + else: + break + return + + # If iterator is exhausted and we don't have cached chunks, nothing to write + if self._iter is None: + return + + # Stream from the iterator + remaining_bytes = content_length + + try: + while True: + if sys.version_info >= (3, 10): + chunk = await anext(self._iter) + else: + chunk = await self._iter.__anext__() + if remaining_bytes is None: + await writer.write(chunk) + # If we have a content length limit + elif remaining_bytes > 0: + await writer.write(chunk[:remaining_bytes]) + remaining_bytes -= len(chunk) + # We still want to exhaust the iterator even + # if we have reached the content length limit + # since the file handle may not get closed by + # the iterator if we don't do this + except StopAsyncIteration: + # Iterator is exhausted + self._iter = None + self._consumed = True # Mark as consumed when streamed without caching + + def decode(self, encoding: str = "utf-8", errors: str = "strict") -> str: + """Decode the payload content as a string if cached chunks are available.""" + if self._cached_chunks is not None: + return b"".join(self._cached_chunks).decode(encoding, errors) + raise TypeError("Unable to decode - content not cached. Call as_bytes() first.") + + async def as_bytes(self, encoding: str = "utf-8", errors: str = "strict") -> bytes: + """ + Return bytes representation of the value. + + This method reads the entire async iterable content and returns it as bytes. + It generates and caches the chunks for future reuse. + """ + # If we have cached chunks, return them joined + if self._cached_chunks is not None: + return b"".join(self._cached_chunks) + + # If iterator is exhausted and no cache, return empty + if self._iter is None: + return b"" + + # Read all chunks and cache them + chunks: List[bytes] = [] + async for chunk in self._iter: + chunks.append(chunk) + + # Iterator is exhausted, cache the chunks + self._iter = None + self._cached_chunks = chunks + # Keep _consumed as False to allow reuse with cached chunks + + return b"".join(chunks) + + +class StreamReaderPayload(AsyncIterablePayload): + def __init__(self, value: StreamReader, *args: Any, **kwargs: Any) -> None: + super().__init__(value.iter_any(), *args, **kwargs) + + +PAYLOAD_REGISTRY = PayloadRegistry() +PAYLOAD_REGISTRY.register(BytesPayload, (bytes, bytearray, memoryview)) +PAYLOAD_REGISTRY.register(StringPayload, str) +PAYLOAD_REGISTRY.register(StringIOPayload, io.StringIO) +PAYLOAD_REGISTRY.register(TextIOPayload, io.TextIOBase) +PAYLOAD_REGISTRY.register(BytesIOPayload, io.BytesIO) +PAYLOAD_REGISTRY.register(BufferedReaderPayload, (io.BufferedReader, io.BufferedRandom)) +PAYLOAD_REGISTRY.register(IOBasePayload, io.IOBase) +PAYLOAD_REGISTRY.register(StreamReaderPayload, StreamReader) +# try_last for giving a chance to more specialized async interables like +# multipart.BodyPartReaderPayload override the default +PAYLOAD_REGISTRY.register(AsyncIterablePayload, AsyncIterable, order=Order.try_last) diff --git a/env/lib/python3.12/site-packages/aiohttp/payload_streamer.py b/env/lib/python3.12/site-packages/aiohttp/payload_streamer.py new file mode 100644 index 0000000..831fdc0 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/payload_streamer.py @@ -0,0 +1,78 @@ +""" +Payload implementation for coroutines as data provider. + +As a simple case, you can upload data from file:: + + @aiohttp.streamer + async def file_sender(writer, file_name=None): + with open(file_name, 'rb') as f: + chunk = f.read(2**16) + while chunk: + await writer.write(chunk) + + chunk = f.read(2**16) + +Then you can use `file_sender` like this: + + async with session.post('http://httpbin.org/post', + data=file_sender(file_name='huge_file')) as resp: + print(await resp.text()) + +..note:: Coroutine must accept `writer` as first argument + +""" + +import types +import warnings +from typing import Any, Awaitable, Callable, Dict, Tuple + +from .abc import AbstractStreamWriter +from .payload import Payload, payload_type + +__all__ = ("streamer",) + + +class _stream_wrapper: + def __init__( + self, + coro: Callable[..., Awaitable[None]], + args: Tuple[Any, ...], + kwargs: Dict[str, Any], + ) -> None: + self.coro = types.coroutine(coro) + self.args = args + self.kwargs = kwargs + + async def __call__(self, writer: AbstractStreamWriter) -> None: + await self.coro(writer, *self.args, **self.kwargs) + + +class streamer: + def __init__(self, coro: Callable[..., Awaitable[None]]) -> None: + warnings.warn( + "@streamer is deprecated, use async generators instead", + DeprecationWarning, + stacklevel=2, + ) + self.coro = coro + + def __call__(self, *args: Any, **kwargs: Any) -> _stream_wrapper: + return _stream_wrapper(self.coro, args, kwargs) + + +@payload_type(_stream_wrapper) +class StreamWrapperPayload(Payload): + async def write(self, writer: AbstractStreamWriter) -> None: + await self._value(writer) + + def decode(self, encoding: str = "utf-8", errors: str = "strict") -> str: + raise TypeError("Unable to decode.") + + +@payload_type(streamer) +class StreamPayload(StreamWrapperPayload): + def __init__(self, value: Any, *args: Any, **kwargs: Any) -> None: + super().__init__(value(), *args, **kwargs) + + async def write(self, writer: AbstractStreamWriter) -> None: + await self._value(writer) diff --git a/env/lib/python3.12/site-packages/aiohttp/py.typed b/env/lib/python3.12/site-packages/aiohttp/py.typed new file mode 100644 index 0000000..f5642f7 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/py.typed @@ -0,0 +1 @@ +Marker diff --git a/env/lib/python3.12/site-packages/aiohttp/pytest_plugin.py b/env/lib/python3.12/site-packages/aiohttp/pytest_plugin.py new file mode 100644 index 0000000..7d59fe8 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/pytest_plugin.py @@ -0,0 +1,444 @@ +import asyncio +import contextlib +import inspect +import warnings +from typing import ( + Any, + Awaitable, + Callable, + Dict, + Iterator, + Optional, + Protocol, + Union, + overload, +) + +import pytest + +from .test_utils import ( + BaseTestServer, + RawTestServer, + TestClient, + TestServer, + loop_context, + setup_test_loop, + teardown_test_loop, + unused_port as _unused_port, +) +from .web import Application, BaseRequest, Request +from .web_protocol import _RequestHandler + +try: + import uvloop +except ImportError: # pragma: no cover + uvloop = None # type: ignore[assignment] + + +class AiohttpClient(Protocol): + @overload + async def __call__( + self, + __param: Application, + *, + server_kwargs: Optional[Dict[str, Any]] = None, + **kwargs: Any, + ) -> TestClient[Request, Application]: ... + @overload + async def __call__( + self, + __param: BaseTestServer, + *, + server_kwargs: Optional[Dict[str, Any]] = None, + **kwargs: Any, + ) -> TestClient[BaseRequest, None]: ... + + +class AiohttpServer(Protocol): + def __call__( + self, app: Application, *, port: Optional[int] = None, **kwargs: Any + ) -> Awaitable[TestServer]: ... + + +class AiohttpRawServer(Protocol): + def __call__( + self, handler: _RequestHandler, *, port: Optional[int] = None, **kwargs: Any + ) -> Awaitable[RawTestServer]: ... + + +def pytest_addoption(parser): # type: ignore[no-untyped-def] + parser.addoption( + "--aiohttp-fast", + action="store_true", + default=False, + help="run tests faster by disabling extra checks", + ) + parser.addoption( + "--aiohttp-loop", + action="store", + default="pyloop", + help="run tests with specific loop: pyloop, uvloop or all", + ) + parser.addoption( + "--aiohttp-enable-loop-debug", + action="store_true", + default=False, + help="enable event loop debug mode", + ) + + +def pytest_fixture_setup(fixturedef): # type: ignore[no-untyped-def] + """Set up pytest fixture. + + Allow fixtures to be coroutines. Run coroutine fixtures in an event loop. + """ + func = fixturedef.func + + if inspect.isasyncgenfunction(func): + # async generator fixture + is_async_gen = True + elif inspect.iscoroutinefunction(func): + # regular async fixture + is_async_gen = False + else: + # not an async fixture, nothing to do + return + + strip_request = False + if "request" not in fixturedef.argnames: + fixturedef.argnames += ("request",) + strip_request = True + + def wrapper(*args, **kwargs): # type: ignore[no-untyped-def] + request = kwargs["request"] + if strip_request: + del kwargs["request"] + + # if neither the fixture nor the test use the 'loop' fixture, + # 'getfixturevalue' will fail because the test is not parameterized + # (this can be removed someday if 'loop' is no longer parameterized) + if "loop" not in request.fixturenames: + raise Exception( + "Asynchronous fixtures must depend on the 'loop' fixture or " + "be used in tests depending from it." + ) + + _loop = request.getfixturevalue("loop") + + if is_async_gen: + # for async generators, we need to advance the generator once, + # then advance it again in a finalizer + gen = func(*args, **kwargs) + + def finalizer(): # type: ignore[no-untyped-def] + try: + return _loop.run_until_complete(gen.__anext__()) + except StopAsyncIteration: + pass + + request.addfinalizer(finalizer) + return _loop.run_until_complete(gen.__anext__()) + else: + return _loop.run_until_complete(func(*args, **kwargs)) + + fixturedef.func = wrapper + + +@pytest.fixture +def fast(request): # type: ignore[no-untyped-def] + """--fast config option""" + return request.config.getoption("--aiohttp-fast") + + +@pytest.fixture +def loop_debug(request): # type: ignore[no-untyped-def] + """--enable-loop-debug config option""" + return request.config.getoption("--aiohttp-enable-loop-debug") + + +@contextlib.contextmanager +def _runtime_warning_context(): # type: ignore[no-untyped-def] + """Context manager which checks for RuntimeWarnings. + + This exists specifically to + avoid "coroutine 'X' was never awaited" warnings being missed. + + If RuntimeWarnings occur in the context a RuntimeError is raised. + """ + with warnings.catch_warnings(record=True) as _warnings: + yield + rw = [ + "{w.filename}:{w.lineno}:{w.message}".format(w=w) + for w in _warnings + if w.category == RuntimeWarning + ] + if rw: + raise RuntimeError( + "{} Runtime Warning{},\n{}".format( + len(rw), "" if len(rw) == 1 else "s", "\n".join(rw) + ) + ) + + +@contextlib.contextmanager +def _passthrough_loop_context(loop, fast=False): # type: ignore[no-untyped-def] + """Passthrough loop context. + + Sets up and tears down a loop unless one is passed in via the loop + argument when it's passed straight through. + """ + if loop: + # loop already exists, pass it straight through + yield loop + else: + # this shadows loop_context's standard behavior + loop = setup_test_loop() + yield loop + teardown_test_loop(loop, fast=fast) + + +def pytest_pycollect_makeitem(collector, name, obj): # type: ignore[no-untyped-def] + """Fix pytest collecting for coroutines.""" + if collector.funcnamefilter(name) and inspect.iscoroutinefunction(obj): + return list(collector._genfunctions(name, obj)) + + +def pytest_pyfunc_call(pyfuncitem): # type: ignore[no-untyped-def] + """Run coroutines in an event loop instead of a normal function call.""" + fast = pyfuncitem.config.getoption("--aiohttp-fast") + if inspect.iscoroutinefunction(pyfuncitem.function): + existing_loop = ( + pyfuncitem.funcargs.get("proactor_loop") + or pyfuncitem.funcargs.get("selector_loop") + or pyfuncitem.funcargs.get("uvloop_loop") + or pyfuncitem.funcargs.get("loop", None) + ) + + with _runtime_warning_context(): + with _passthrough_loop_context(existing_loop, fast=fast) as _loop: + testargs = { + arg: pyfuncitem.funcargs[arg] + for arg in pyfuncitem._fixtureinfo.argnames + } + _loop.run_until_complete(pyfuncitem.obj(**testargs)) + + return True + + +def pytest_generate_tests(metafunc): # type: ignore[no-untyped-def] + if "loop_factory" not in metafunc.fixturenames: + return + + loops = metafunc.config.option.aiohttp_loop + avail_factories: dict[str, Callable[[], asyncio.AbstractEventLoop]] + avail_factories = {"pyloop": asyncio.new_event_loop} + + if uvloop is not None: # pragma: no cover + avail_factories["uvloop"] = uvloop.new_event_loop + + if loops == "all": + loops = "pyloop,uvloop?" + + factories = {} # type: ignore[var-annotated] + for name in loops.split(","): + required = not name.endswith("?") + name = name.strip(" ?") + if name not in avail_factories: # pragma: no cover + if required: + raise ValueError( + "Unknown loop '%s', available loops: %s" + % (name, list(factories.keys())) + ) + else: + continue + factories[name] = avail_factories[name] + metafunc.parametrize( + "loop_factory", list(factories.values()), ids=list(factories.keys()) + ) + + +@pytest.fixture +def loop( + loop_factory: Callable[[], asyncio.AbstractEventLoop], + fast: bool, + loop_debug: bool, +) -> Iterator[asyncio.AbstractEventLoop]: + """Return an instance of the event loop.""" + with loop_context(loop_factory, fast=fast) as _loop: + if loop_debug: + _loop.set_debug(True) # pragma: no cover + asyncio.set_event_loop(_loop) + yield _loop + + +@pytest.fixture +def proactor_loop() -> Iterator[asyncio.AbstractEventLoop]: + factory = asyncio.ProactorEventLoop # type: ignore[attr-defined] + + with loop_context(factory) as _loop: + asyncio.set_event_loop(_loop) + yield _loop + + +@pytest.fixture +def unused_port(aiohttp_unused_port: Callable[[], int]) -> Callable[[], int]: + warnings.warn( + "Deprecated, use aiohttp_unused_port fixture instead", + DeprecationWarning, + stacklevel=2, + ) + return aiohttp_unused_port + + +@pytest.fixture +def aiohttp_unused_port() -> Callable[[], int]: + """Return a port that is unused on the current host.""" + return _unused_port + + +@pytest.fixture +def aiohttp_server(loop: asyncio.AbstractEventLoop) -> Iterator[AiohttpServer]: + """Factory to create a TestServer instance, given an app. + + aiohttp_server(app, **kwargs) + """ + servers = [] + + async def go( + app: Application, + *, + host: str = "127.0.0.1", + port: Optional[int] = None, + **kwargs: Any, + ) -> TestServer: + server = TestServer(app, host=host, port=port) + await server.start_server(loop=loop, **kwargs) + servers.append(server) + return server + + yield go + + async def finalize() -> None: + while servers: + await servers.pop().close() + + loop.run_until_complete(finalize()) + + +@pytest.fixture +def test_server(aiohttp_server): # type: ignore[no-untyped-def] # pragma: no cover + warnings.warn( + "Deprecated, use aiohttp_server fixture instead", + DeprecationWarning, + stacklevel=2, + ) + return aiohttp_server + + +@pytest.fixture +def aiohttp_raw_server(loop: asyncio.AbstractEventLoop) -> Iterator[AiohttpRawServer]: + """Factory to create a RawTestServer instance, given a web handler. + + aiohttp_raw_server(handler, **kwargs) + """ + servers = [] + + async def go( + handler: _RequestHandler, *, port: Optional[int] = None, **kwargs: Any + ) -> RawTestServer: + server = RawTestServer(handler, port=port) + await server.start_server(loop=loop, **kwargs) + servers.append(server) + return server + + yield go + + async def finalize() -> None: + while servers: + await servers.pop().close() + + loop.run_until_complete(finalize()) + + +@pytest.fixture +def raw_test_server( # type: ignore[no-untyped-def] # pragma: no cover + aiohttp_raw_server, +): + warnings.warn( + "Deprecated, use aiohttp_raw_server fixture instead", + DeprecationWarning, + stacklevel=2, + ) + return aiohttp_raw_server + + +@pytest.fixture +def aiohttp_client(loop: asyncio.AbstractEventLoop) -> Iterator[AiohttpClient]: + """Factory to create a TestClient instance. + + aiohttp_client(app, **kwargs) + aiohttp_client(server, **kwargs) + aiohttp_client(raw_server, **kwargs) + """ + clients = [] + + @overload + async def go( + __param: Application, + *, + server_kwargs: Optional[Dict[str, Any]] = None, + **kwargs: Any, + ) -> TestClient[Request, Application]: ... + + @overload + async def go( + __param: BaseTestServer, + *, + server_kwargs: Optional[Dict[str, Any]] = None, + **kwargs: Any, + ) -> TestClient[BaseRequest, None]: ... + + async def go( + __param: Union[Application, BaseTestServer], + *args: Any, + server_kwargs: Optional[Dict[str, Any]] = None, + **kwargs: Any, + ) -> TestClient[Any, Any]: + if isinstance(__param, Callable) and not isinstance( # type: ignore[arg-type] + __param, (Application, BaseTestServer) + ): + __param = __param(loop, *args, **kwargs) + kwargs = {} + else: + assert not args, "args should be empty" + + if isinstance(__param, Application): + server_kwargs = server_kwargs or {} + server = TestServer(__param, loop=loop, **server_kwargs) + client = TestClient(server, loop=loop, **kwargs) + elif isinstance(__param, BaseTestServer): + client = TestClient(__param, loop=loop, **kwargs) + else: + raise ValueError("Unknown argument type: %r" % type(__param)) + + await client.start_server() + clients.append(client) + return client + + yield go + + async def finalize() -> None: + while clients: + await clients.pop().close() + + loop.run_until_complete(finalize()) + + +@pytest.fixture +def test_client(aiohttp_client): # type: ignore[no-untyped-def] # pragma: no cover + warnings.warn( + "Deprecated, use aiohttp_client fixture instead", + DeprecationWarning, + stacklevel=2, + ) + return aiohttp_client diff --git a/env/lib/python3.12/site-packages/aiohttp/resolver.py b/env/lib/python3.12/site-packages/aiohttp/resolver.py new file mode 100644 index 0000000..b20e567 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/resolver.py @@ -0,0 +1,274 @@ +import asyncio +import socket +import weakref +from typing import Any, Dict, Final, List, Optional, Tuple, Type, Union + +from .abc import AbstractResolver, ResolveResult + +__all__ = ("ThreadedResolver", "AsyncResolver", "DefaultResolver") + + +try: + import aiodns + + aiodns_default = hasattr(aiodns.DNSResolver, "getaddrinfo") +except ImportError: # pragma: no cover + aiodns = None # type: ignore[assignment] + aiodns_default = False + + +_NUMERIC_SOCKET_FLAGS = socket.AI_NUMERICHOST | socket.AI_NUMERICSERV +_NAME_SOCKET_FLAGS = socket.NI_NUMERICHOST | socket.NI_NUMERICSERV +_AI_ADDRCONFIG = socket.AI_ADDRCONFIG +if hasattr(socket, "AI_MASK"): + _AI_ADDRCONFIG &= socket.AI_MASK + + +class ThreadedResolver(AbstractResolver): + """Threaded resolver. + + Uses an Executor for synchronous getaddrinfo() calls. + concurrent.futures.ThreadPoolExecutor is used by default. + """ + + def __init__(self, loop: Optional[asyncio.AbstractEventLoop] = None) -> None: + self._loop = loop or asyncio.get_running_loop() + + async def resolve( + self, host: str, port: int = 0, family: socket.AddressFamily = socket.AF_INET + ) -> List[ResolveResult]: + infos = await self._loop.getaddrinfo( + host, + port, + type=socket.SOCK_STREAM, + family=family, + flags=_AI_ADDRCONFIG, + ) + + hosts: List[ResolveResult] = [] + for family, _, proto, _, address in infos: + if family == socket.AF_INET6: + if len(address) < 3: + # IPv6 is not supported by Python build, + # or IPv6 is not enabled in the host + continue + if address[3]: + # This is essential for link-local IPv6 addresses. + # LL IPv6 is a VERY rare case. Strictly speaking, we should use + # getnameinfo() unconditionally, but performance makes sense. + resolved_host, _port = await self._loop.getnameinfo( + address, _NAME_SOCKET_FLAGS + ) + port = int(_port) + else: + resolved_host, port = address[:2] + else: # IPv4 + assert family == socket.AF_INET + resolved_host, port = address # type: ignore[misc] + hosts.append( + ResolveResult( + hostname=host, + host=resolved_host, + port=port, + family=family, + proto=proto, + flags=_NUMERIC_SOCKET_FLAGS, + ) + ) + + return hosts + + async def close(self) -> None: + pass + + +class AsyncResolver(AbstractResolver): + """Use the `aiodns` package to make asynchronous DNS lookups""" + + def __init__( + self, + loop: Optional[asyncio.AbstractEventLoop] = None, + *args: Any, + **kwargs: Any, + ) -> None: + if aiodns is None: + raise RuntimeError("Resolver requires aiodns library") + + self._loop = loop or asyncio.get_running_loop() + self._manager: Optional[_DNSResolverManager] = None + # If custom args are provided, create a dedicated resolver instance + # This means each AsyncResolver with custom args gets its own + # aiodns.DNSResolver instance + if args or kwargs: + self._resolver = aiodns.DNSResolver(*args, **kwargs) + return + # Use the shared resolver from the manager for default arguments + self._manager = _DNSResolverManager() + self._resolver = self._manager.get_resolver(self, self._loop) + + if not hasattr(self._resolver, "gethostbyname"): + # aiodns 1.1 is not available, fallback to DNSResolver.query + self.resolve = self._resolve_with_query # type: ignore + + async def resolve( + self, host: str, port: int = 0, family: socket.AddressFamily = socket.AF_INET + ) -> List[ResolveResult]: + try: + resp = await self._resolver.getaddrinfo( + host, + port=port, + type=socket.SOCK_STREAM, + family=family, + flags=_AI_ADDRCONFIG, + ) + except aiodns.error.DNSError as exc: + msg = exc.args[1] if len(exc.args) >= 1 else "DNS lookup failed" + raise OSError(None, msg) from exc + hosts: List[ResolveResult] = [] + for node in resp.nodes: + address: Union[Tuple[bytes, int], Tuple[bytes, int, int, int]] = node.addr + family = node.family + if family == socket.AF_INET6: + if len(address) > 3 and address[3]: + # This is essential for link-local IPv6 addresses. + # LL IPv6 is a VERY rare case. Strictly speaking, we should use + # getnameinfo() unconditionally, but performance makes sense. + result = await self._resolver.getnameinfo( + (address[0].decode("ascii"), *address[1:]), + _NAME_SOCKET_FLAGS, + ) + resolved_host = result.node + else: + resolved_host = address[0].decode("ascii") + port = address[1] + else: # IPv4 + assert family == socket.AF_INET + resolved_host = address[0].decode("ascii") + port = address[1] + hosts.append( + ResolveResult( + hostname=host, + host=resolved_host, + port=port, + family=family, + proto=0, + flags=_NUMERIC_SOCKET_FLAGS, + ) + ) + + if not hosts: + raise OSError(None, "DNS lookup failed") + + return hosts + + async def _resolve_with_query( + self, host: str, port: int = 0, family: int = socket.AF_INET + ) -> List[Dict[str, Any]]: + qtype: Final = "AAAA" if family == socket.AF_INET6 else "A" + + try: + resp = await self._resolver.query(host, qtype) + except aiodns.error.DNSError as exc: + msg = exc.args[1] if len(exc.args) >= 1 else "DNS lookup failed" + raise OSError(None, msg) from exc + + hosts = [] + for rr in resp: + hosts.append( + { + "hostname": host, + "host": rr.host, + "port": port, + "family": family, + "proto": 0, + "flags": socket.AI_NUMERICHOST, + } + ) + + if not hosts: + raise OSError(None, "DNS lookup failed") + + return hosts + + async def close(self) -> None: + if self._manager: + # Release the resolver from the manager if using the shared resolver + self._manager.release_resolver(self, self._loop) + self._manager = None # Clear reference to manager + self._resolver = None # type: ignore[assignment] # Clear reference to resolver + return + # Otherwise cancel our dedicated resolver + if self._resolver is not None: + self._resolver.cancel() + self._resolver = None # type: ignore[assignment] # Clear reference + + +class _DNSResolverManager: + """Manager for aiodns.DNSResolver objects. + + This class manages shared aiodns.DNSResolver instances + with no custom arguments across different event loops. + """ + + _instance: Optional["_DNSResolverManager"] = None + + def __new__(cls) -> "_DNSResolverManager": + if cls._instance is None: + cls._instance = super().__new__(cls) + cls._instance._init() + return cls._instance + + def _init(self) -> None: + # Use WeakKeyDictionary to allow event loops to be garbage collected + self._loop_data: weakref.WeakKeyDictionary[ + asyncio.AbstractEventLoop, + tuple["aiodns.DNSResolver", weakref.WeakSet["AsyncResolver"]], + ] = weakref.WeakKeyDictionary() + + def get_resolver( + self, client: "AsyncResolver", loop: asyncio.AbstractEventLoop + ) -> "aiodns.DNSResolver": + """Get or create the shared aiodns.DNSResolver instance for a specific event loop. + + Args: + client: The AsyncResolver instance requesting the resolver. + This is required to track resolver usage. + loop: The event loop to use for the resolver. + """ + # Create a new resolver and client set for this loop if it doesn't exist + if loop not in self._loop_data: + resolver = aiodns.DNSResolver(loop=loop) + client_set: weakref.WeakSet["AsyncResolver"] = weakref.WeakSet() + self._loop_data[loop] = (resolver, client_set) + else: + # Get the existing resolver and client set + resolver, client_set = self._loop_data[loop] + + # Register this client with the loop + client_set.add(client) + return resolver + + def release_resolver( + self, client: "AsyncResolver", loop: asyncio.AbstractEventLoop + ) -> None: + """Release the resolver for an AsyncResolver client when it's closed. + + Args: + client: The AsyncResolver instance to release. + loop: The event loop the resolver was using. + """ + # Remove client from its loop's tracking + current_loop_data = self._loop_data.get(loop) + if current_loop_data is None: + return + resolver, client_set = current_loop_data + client_set.discard(client) + # If no more clients for this loop, cancel and remove its resolver + if not client_set: + if resolver is not None: + resolver.cancel() + del self._loop_data[loop] + + +_DefaultType = Type[Union[AsyncResolver, ThreadedResolver]] +DefaultResolver: _DefaultType = AsyncResolver if aiodns_default else ThreadedResolver diff --git a/env/lib/python3.12/site-packages/aiohttp/streams.py b/env/lib/python3.12/site-packages/aiohttp/streams.py new file mode 100644 index 0000000..6cc74fc --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/streams.py @@ -0,0 +1,758 @@ +import asyncio +import collections +import warnings +from typing import ( + Awaitable, + Callable, + Deque, + Final, + Generic, + List, + Optional, + Tuple, + TypeVar, +) + +from .base_protocol import BaseProtocol +from .helpers import ( + _EXC_SENTINEL, + BaseTimerContext, + TimerNoop, + set_exception, + set_result, +) +from .log import internal_logger + +__all__ = ( + "EMPTY_PAYLOAD", + "EofStream", + "StreamReader", + "DataQueue", +) + +_T = TypeVar("_T") + + +class EofStream(Exception): + """eof stream indication.""" + + +class AsyncStreamIterator(Generic[_T]): + + __slots__ = ("read_func",) + + def __init__(self, read_func: Callable[[], Awaitable[_T]]) -> None: + self.read_func = read_func + + def __aiter__(self) -> "AsyncStreamIterator[_T]": + return self + + async def __anext__(self) -> _T: + try: + rv = await self.read_func() + except EofStream: + raise StopAsyncIteration + if rv == b"": + raise StopAsyncIteration + return rv + + +class ChunkTupleAsyncStreamIterator: + + __slots__ = ("_stream",) + + def __init__(self, stream: "StreamReader") -> None: + self._stream = stream + + def __aiter__(self) -> "ChunkTupleAsyncStreamIterator": + return self + + async def __anext__(self) -> Tuple[bytes, bool]: + rv = await self._stream.readchunk() + if rv == (b"", False): + raise StopAsyncIteration + return rv + + +class AsyncStreamReaderMixin: + + __slots__ = () + + def __aiter__(self) -> AsyncStreamIterator[bytes]: + return AsyncStreamIterator(self.readline) # type: ignore[attr-defined] + + def iter_chunked(self, n: int) -> AsyncStreamIterator[bytes]: + """Returns an asynchronous iterator that yields chunks of size n.""" + return AsyncStreamIterator(lambda: self.read(n)) # type: ignore[attr-defined] + + def iter_any(self) -> AsyncStreamIterator[bytes]: + """Yield all available data as soon as it is received.""" + return AsyncStreamIterator(self.readany) # type: ignore[attr-defined] + + def iter_chunks(self) -> ChunkTupleAsyncStreamIterator: + """Yield chunks of data as they are received by the server. + + The yielded objects are tuples + of (bytes, bool) as returned by the StreamReader.readchunk method. + """ + return ChunkTupleAsyncStreamIterator(self) # type: ignore[arg-type] + + +class StreamReader(AsyncStreamReaderMixin): + """An enhancement of asyncio.StreamReader. + + Supports asynchronous iteration by line, chunk or as available:: + + async for line in reader: + ... + async for chunk in reader.iter_chunked(1024): + ... + async for slice in reader.iter_any(): + ... + + """ + + __slots__ = ( + "_protocol", + "_low_water", + "_high_water", + "_low_water_chunks", + "_high_water_chunks", + "_loop", + "_size", + "_cursor", + "_http_chunk_splits", + "_buffer", + "_buffer_offset", + "_eof", + "_waiter", + "_eof_waiter", + "_exception", + "_timer", + "_eof_callbacks", + "_eof_counter", + "total_bytes", + "total_compressed_bytes", + ) + + def __init__( + self, + protocol: BaseProtocol, + limit: int, + *, + timer: Optional[BaseTimerContext] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + ) -> None: + self._protocol = protocol + self._low_water = limit + self._high_water = limit * 2 + if loop is None: + loop = asyncio.get_event_loop() + # Ensure high_water_chunks >= 3 so it's always > low_water_chunks. + self._high_water_chunks = max(3, limit // 4) + # Use max(2, ...) because there's always at least 1 chunk split remaining + # (the current position), so we need low_water >= 2 to allow resume. + self._low_water_chunks = max(2, self._high_water_chunks // 2) + self._loop = loop + self._size = 0 + self._cursor = 0 + self._http_chunk_splits: Optional[Deque[int]] = None + self._buffer: Deque[bytes] = collections.deque() + self._buffer_offset = 0 + self._eof = False + self._waiter: Optional[asyncio.Future[None]] = None + self._eof_waiter: Optional[asyncio.Future[None]] = None + self._exception: Optional[BaseException] = None + self._timer = TimerNoop() if timer is None else timer + self._eof_callbacks: List[Callable[[], None]] = [] + self._eof_counter = 0 + self.total_bytes = 0 + self.total_compressed_bytes: Optional[int] = None + + def __repr__(self) -> str: + info = [self.__class__.__name__] + if self._size: + info.append("%d bytes" % self._size) + if self._eof: + info.append("eof") + if self._low_water != 2**16: # default limit + info.append("low=%d high=%d" % (self._low_water, self._high_water)) + if self._waiter: + info.append("w=%r" % self._waiter) + if self._exception: + info.append("e=%r" % self._exception) + return "<%s>" % " ".join(info) + + def get_read_buffer_limits(self) -> Tuple[int, int]: + return (self._low_water, self._high_water) + + def exception(self) -> Optional[BaseException]: + return self._exception + + def set_exception( + self, + exc: BaseException, + exc_cause: BaseException = _EXC_SENTINEL, + ) -> None: + self._exception = exc + self._eof_callbacks.clear() + + waiter = self._waiter + if waiter is not None: + self._waiter = None + set_exception(waiter, exc, exc_cause) + + waiter = self._eof_waiter + if waiter is not None: + self._eof_waiter = None + set_exception(waiter, exc, exc_cause) + + def on_eof(self, callback: Callable[[], None]) -> None: + if self._eof: + try: + callback() + except Exception: + internal_logger.exception("Exception in eof callback") + else: + self._eof_callbacks.append(callback) + + def feed_eof(self) -> None: + self._eof = True + + waiter = self._waiter + if waiter is not None: + self._waiter = None + set_result(waiter, None) + + waiter = self._eof_waiter + if waiter is not None: + self._eof_waiter = None + set_result(waiter, None) + + if self._protocol._reading_paused: + self._protocol.resume_reading() + + for cb in self._eof_callbacks: + try: + cb() + except Exception: + internal_logger.exception("Exception in eof callback") + + self._eof_callbacks.clear() + + def is_eof(self) -> bool: + """Return True if 'feed_eof' was called.""" + return self._eof + + def at_eof(self) -> bool: + """Return True if the buffer is empty and 'feed_eof' was called.""" + return self._eof and not self._buffer + + async def wait_eof(self) -> None: + if self._eof: + return + + assert self._eof_waiter is None + self._eof_waiter = self._loop.create_future() + try: + await self._eof_waiter + finally: + self._eof_waiter = None + + @property + def total_raw_bytes(self) -> int: + if self.total_compressed_bytes is None: + return self.total_bytes + return self.total_compressed_bytes + + def unread_data(self, data: bytes) -> None: + """rollback reading some data from stream, inserting it to buffer head.""" + warnings.warn( + "unread_data() is deprecated " + "and will be removed in future releases (#3260)", + DeprecationWarning, + stacklevel=2, + ) + if not data: + return + + if self._buffer_offset: + self._buffer[0] = self._buffer[0][self._buffer_offset :] + self._buffer_offset = 0 + self._size += len(data) + self._cursor -= len(data) + self._buffer.appendleft(data) + self._eof_counter = 0 + + # TODO: size is ignored, remove the param later + def feed_data(self, data: bytes, size: int = 0) -> None: + assert not self._eof, "feed_data after feed_eof" + + if not data: + return + + data_len = len(data) + self._size += data_len + self._buffer.append(data) + self.total_bytes += data_len + + waiter = self._waiter + if waiter is not None: + self._waiter = None + set_result(waiter, None) + + if self._size > self._high_water and not self._protocol._reading_paused: + self._protocol.pause_reading() + + def begin_http_chunk_receiving(self) -> None: + if self._http_chunk_splits is None: + if self.total_bytes: + raise RuntimeError( + "Called begin_http_chunk_receiving when some data was already fed" + ) + self._http_chunk_splits = collections.deque() + + def end_http_chunk_receiving(self) -> None: + if self._http_chunk_splits is None: + raise RuntimeError( + "Called end_chunk_receiving without calling " + "begin_chunk_receiving first" + ) + + # self._http_chunk_splits contains logical byte offsets from start of + # the body transfer. Each offset is the offset of the end of a chunk. + # "Logical" means bytes, accessible for a user. + # If no chunks containing logical data were received, current position + # is difinitely zero. + pos = self._http_chunk_splits[-1] if self._http_chunk_splits else 0 + + if self.total_bytes == pos: + # We should not add empty chunks here. So we check for that. + # Note, when chunked + gzip is used, we can receive a chunk + # of compressed data, but that data may not be enough for gzip FSM + # to yield any uncompressed data. That's why current position may + # not change after receiving a chunk. + return + + self._http_chunk_splits.append(self.total_bytes) + + # If we get too many small chunks before self._high_water is reached, then any + # .read() call becomes computationally expensive, and could block the event loop + # for too long, hence an additional self._high_water_chunks here. + if ( + len(self._http_chunk_splits) > self._high_water_chunks + and not self._protocol._reading_paused + ): + self._protocol.pause_reading() + + # wake up readchunk when end of http chunk received + waiter = self._waiter + if waiter is not None: + self._waiter = None + set_result(waiter, None) + + async def _wait(self, func_name: str) -> None: + if not self._protocol.connected: + raise RuntimeError("Connection closed.") + + # StreamReader uses a future to link the protocol feed_data() method + # to a read coroutine. Running two read coroutines at the same time + # would have an unexpected behaviour. It would not possible to know + # which coroutine would get the next data. + if self._waiter is not None: + raise RuntimeError( + "%s() called while another coroutine is " + "already waiting for incoming data" % func_name + ) + + waiter = self._waiter = self._loop.create_future() + try: + with self._timer: + await waiter + finally: + self._waiter = None + + async def readline(self) -> bytes: + return await self.readuntil() + + async def readuntil(self, separator: bytes = b"\n") -> bytes: + seplen = len(separator) + if seplen == 0: + raise ValueError("Separator should be at least one-byte string") + + if self._exception is not None: + raise self._exception + + chunk = b"" + chunk_size = 0 + not_enough = True + + while not_enough: + while self._buffer and not_enough: + offset = self._buffer_offset + ichar = self._buffer[0].find(separator, offset) + 1 + # Read from current offset to found separator or to the end. + data = self._read_nowait_chunk( + ichar - offset + seplen - 1 if ichar else -1 + ) + chunk += data + chunk_size += len(data) + if ichar: + not_enough = False + + if chunk_size > self._high_water: + raise ValueError("Chunk too big") + + if self._eof: + break + + if not_enough: + await self._wait("readuntil") + + return chunk + + async def read(self, n: int = -1) -> bytes: + if self._exception is not None: + raise self._exception + + # migration problem; with DataQueue you have to catch + # EofStream exception, so common way is to run payload.read() inside + # infinite loop. what can cause real infinite loop with StreamReader + # lets keep this code one major release. + if __debug__: + if self._eof and not self._buffer: + self._eof_counter = getattr(self, "_eof_counter", 0) + 1 + if self._eof_counter > 5: + internal_logger.warning( + "Multiple access to StreamReader in eof state, " + "might be infinite loop.", + stack_info=True, + ) + + if not n: + return b"" + + if n < 0: + # This used to just loop creating a new waiter hoping to + # collect everything in self._buffer, but that would + # deadlock if the subprocess sends more than self.limit + # bytes. So just call self.readany() until EOF. + blocks = [] + while True: + block = await self.readany() + if not block: + break + blocks.append(block) + return b"".join(blocks) + + # TODO: should be `if` instead of `while` + # because waiter maybe triggered on chunk end, + # without feeding any data + while not self._buffer and not self._eof: + await self._wait("read") + + return self._read_nowait(n) + + async def readany(self) -> bytes: + if self._exception is not None: + raise self._exception + + # TODO: should be `if` instead of `while` + # because waiter maybe triggered on chunk end, + # without feeding any data + while not self._buffer and not self._eof: + await self._wait("readany") + + return self._read_nowait(-1) + + async def readchunk(self) -> Tuple[bytes, bool]: + """Returns a tuple of (data, end_of_http_chunk). + + When chunked transfer + encoding is used, end_of_http_chunk is a boolean indicating if the end + of the data corresponds to the end of a HTTP chunk , otherwise it is + always False. + """ + while True: + if self._exception is not None: + raise self._exception + + while self._http_chunk_splits: + pos = self._http_chunk_splits.popleft() + if pos == self._cursor: + return (b"", True) + if pos > self._cursor: + return (self._read_nowait(pos - self._cursor), True) + internal_logger.warning( + "Skipping HTTP chunk end due to data " + "consumption beyond chunk boundary" + ) + + if self._buffer: + return (self._read_nowait_chunk(-1), False) + # return (self._read_nowait(-1), False) + + if self._eof: + # Special case for signifying EOF. + # (b'', True) is not a final return value actually. + return (b"", False) + + await self._wait("readchunk") + + async def readexactly(self, n: int) -> bytes: + if self._exception is not None: + raise self._exception + + blocks: List[bytes] = [] + while n > 0: + block = await self.read(n) + if not block: + partial = b"".join(blocks) + raise asyncio.IncompleteReadError(partial, len(partial) + n) + blocks.append(block) + n -= len(block) + + return b"".join(blocks) + + def read_nowait(self, n: int = -1) -> bytes: + # default was changed to be consistent with .read(-1) + # + # I believe the most users don't know about the method and + # they are not affected. + if self._exception is not None: + raise self._exception + + if self._waiter and not self._waiter.done(): + raise RuntimeError( + "Called while some coroutine is waiting for incoming data." + ) + + return self._read_nowait(n) + + def _read_nowait_chunk(self, n: int) -> bytes: + first_buffer = self._buffer[0] + offset = self._buffer_offset + if n != -1 and len(first_buffer) - offset > n: + data = first_buffer[offset : offset + n] + self._buffer_offset += n + + elif offset: + self._buffer.popleft() + data = first_buffer[offset:] + self._buffer_offset = 0 + + else: + data = self._buffer.popleft() + + data_len = len(data) + self._size -= data_len + self._cursor += data_len + + chunk_splits = self._http_chunk_splits + # Prevent memory leak: drop useless chunk splits + while chunk_splits and chunk_splits[0] < self._cursor: + chunk_splits.popleft() + + if ( + self._protocol._reading_paused + and self._size < self._low_water + and ( + self._http_chunk_splits is None + or len(self._http_chunk_splits) < self._low_water_chunks + ) + ): + self._protocol.resume_reading() + return data + + def _read_nowait(self, n: int) -> bytes: + """Read not more than n bytes, or whole buffer if n == -1""" + self._timer.assert_timeout() + + chunks = [] + while self._buffer: + chunk = self._read_nowait_chunk(n) + chunks.append(chunk) + if n != -1: + n -= len(chunk) + if n == 0: + break + + return b"".join(chunks) if chunks else b"" + + +class EmptyStreamReader(StreamReader): # lgtm [py/missing-call-to-init] + + __slots__ = ("_read_eof_chunk",) + + def __init__(self) -> None: + self._read_eof_chunk = False + self.total_bytes = 0 + + def __repr__(self) -> str: + return "<%s>" % self.__class__.__name__ + + def exception(self) -> Optional[BaseException]: + return None + + def set_exception( + self, + exc: BaseException, + exc_cause: BaseException = _EXC_SENTINEL, + ) -> None: + pass + + def on_eof(self, callback: Callable[[], None]) -> None: + try: + callback() + except Exception: + internal_logger.exception("Exception in eof callback") + + def feed_eof(self) -> None: + pass + + def is_eof(self) -> bool: + return True + + def at_eof(self) -> bool: + return True + + async def wait_eof(self) -> None: + return + + def feed_data(self, data: bytes, n: int = 0) -> None: + pass + + async def readline(self) -> bytes: + return b"" + + async def read(self, n: int = -1) -> bytes: + return b"" + + # TODO add async def readuntil + + async def readany(self) -> bytes: + return b"" + + async def readchunk(self) -> Tuple[bytes, bool]: + if not self._read_eof_chunk: + self._read_eof_chunk = True + return (b"", False) + + return (b"", True) + + async def readexactly(self, n: int) -> bytes: + raise asyncio.IncompleteReadError(b"", n) + + def read_nowait(self, n: int = -1) -> bytes: + return b"" + + +EMPTY_PAYLOAD: Final[StreamReader] = EmptyStreamReader() + + +class DataQueue(Generic[_T]): + """DataQueue is a general-purpose blocking queue with one reader.""" + + def __init__(self, loop: asyncio.AbstractEventLoop) -> None: + self._loop = loop + self._eof = False + self._waiter: Optional[asyncio.Future[None]] = None + self._exception: Optional[BaseException] = None + self._buffer: Deque[Tuple[_T, int]] = collections.deque() + + def __len__(self) -> int: + return len(self._buffer) + + def is_eof(self) -> bool: + return self._eof + + def at_eof(self) -> bool: + return self._eof and not self._buffer + + def exception(self) -> Optional[BaseException]: + return self._exception + + def set_exception( + self, + exc: BaseException, + exc_cause: BaseException = _EXC_SENTINEL, + ) -> None: + self._eof = True + self._exception = exc + if (waiter := self._waiter) is not None: + self._waiter = None + set_exception(waiter, exc, exc_cause) + + def feed_data(self, data: _T, size: int = 0) -> None: + self._buffer.append((data, size)) + if (waiter := self._waiter) is not None: + self._waiter = None + set_result(waiter, None) + + def feed_eof(self) -> None: + self._eof = True + if (waiter := self._waiter) is not None: + self._waiter = None + set_result(waiter, None) + + async def read(self) -> _T: + if not self._buffer and not self._eof: + assert not self._waiter + self._waiter = self._loop.create_future() + try: + await self._waiter + except (asyncio.CancelledError, asyncio.TimeoutError): + self._waiter = None + raise + if self._buffer: + data, _ = self._buffer.popleft() + return data + if self._exception is not None: + raise self._exception + raise EofStream + + def __aiter__(self) -> AsyncStreamIterator[_T]: + return AsyncStreamIterator(self.read) + + +class FlowControlDataQueue(DataQueue[_T]): + """FlowControlDataQueue resumes and pauses an underlying stream. + + It is a destination for parsed data. + + This class is deprecated and will be removed in version 4.0. + """ + + def __init__( + self, protocol: BaseProtocol, limit: int, *, loop: asyncio.AbstractEventLoop + ) -> None: + super().__init__(loop=loop) + self._size = 0 + self._protocol = protocol + self._limit = limit * 2 + + def feed_data(self, data: _T, size: int = 0) -> None: + super().feed_data(data, size) + self._size += size + + if self._size > self._limit and not self._protocol._reading_paused: + self._protocol.pause_reading() + + async def read(self) -> _T: + if not self._buffer and not self._eof: + assert not self._waiter + self._waiter = self._loop.create_future() + try: + await self._waiter + except (asyncio.CancelledError, asyncio.TimeoutError): + self._waiter = None + raise + if self._buffer: + data, size = self._buffer.popleft() + self._size -= size + if self._size < self._limit and self._protocol._reading_paused: + self._protocol.resume_reading() + return data + if self._exception is not None: + raise self._exception + raise EofStream diff --git a/env/lib/python3.12/site-packages/aiohttp/tcp_helpers.py b/env/lib/python3.12/site-packages/aiohttp/tcp_helpers.py new file mode 100644 index 0000000..88b2442 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/tcp_helpers.py @@ -0,0 +1,37 @@ +"""Helper methods to tune a TCP connection""" + +import asyncio +import socket +from contextlib import suppress +from typing import Optional # noqa + +__all__ = ("tcp_keepalive", "tcp_nodelay") + + +if hasattr(socket, "SO_KEEPALIVE"): + + def tcp_keepalive(transport: asyncio.Transport) -> None: + sock = transport.get_extra_info("socket") + if sock is not None: + sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1) + +else: + + def tcp_keepalive(transport: asyncio.Transport) -> None: # pragma: no cover + pass + + +def tcp_nodelay(transport: asyncio.Transport, value: bool) -> None: + sock = transport.get_extra_info("socket") + + if sock is None: + return + + if sock.family not in (socket.AF_INET, socket.AF_INET6): + return + + value = bool(value) + + # socket may be closed already, on windows OSError get raised + with suppress(OSError): + sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, value) diff --git a/env/lib/python3.12/site-packages/aiohttp/test_utils.py b/env/lib/python3.12/site-packages/aiohttp/test_utils.py new file mode 100644 index 0000000..87c3142 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/test_utils.py @@ -0,0 +1,774 @@ +"""Utilities shared by tests.""" + +import asyncio +import contextlib +import gc +import inspect +import ipaddress +import os +import socket +import sys +import warnings +from abc import ABC, abstractmethod +from types import TracebackType +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Generic, + Iterator, + List, + Optional, + Type, + TypeVar, + cast, + overload, +) +from unittest import IsolatedAsyncioTestCase, mock + +from aiosignal import Signal +from multidict import CIMultiDict, CIMultiDictProxy +from yarl import URL + +import aiohttp +from aiohttp.client import ( + _RequestContextManager, + _RequestOptions, + _WSRequestContextManager, +) + +from . import ClientSession, hdrs +from .abc import AbstractCookieJar +from .client_reqrep import ClientResponse +from .client_ws import ClientWebSocketResponse +from .helpers import sentinel +from .http import HttpVersion, RawRequestMessage +from .streams import EMPTY_PAYLOAD, StreamReader +from .typedefs import StrOrURL +from .web import ( + Application, + AppRunner, + BaseRequest, + BaseRunner, + Request, + Server, + ServerRunner, + SockSite, + UrlMappingMatchInfo, +) +from .web_protocol import _RequestHandler + +if TYPE_CHECKING: + from ssl import SSLContext +else: + SSLContext = None + +if sys.version_info >= (3, 11) and TYPE_CHECKING: + from typing import Unpack + +if sys.version_info >= (3, 11): + from typing import Self +else: + Self = Any + +_ApplicationNone = TypeVar("_ApplicationNone", Application, None) +_Request = TypeVar("_Request", bound=BaseRequest) + +REUSE_ADDRESS = os.name == "posix" and sys.platform != "cygwin" + + +def get_unused_port_socket( + host: str, family: socket.AddressFamily = socket.AF_INET +) -> socket.socket: + return get_port_socket(host, 0, family) + + +def get_port_socket( + host: str, port: int, family: socket.AddressFamily +) -> socket.socket: + s = socket.socket(family, socket.SOCK_STREAM) + if REUSE_ADDRESS: + # Windows has different semantics for SO_REUSEADDR, + # so don't set it. Ref: + # https://docs.microsoft.com/en-us/windows/win32/winsock/using-so-reuseaddr-and-so-exclusiveaddruse + s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) + s.bind((host, port)) + return s + + +def unused_port() -> int: + """Return a port that is unused on the current host.""" + with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s: + s.bind(("127.0.0.1", 0)) + return cast(int, s.getsockname()[1]) + + +class BaseTestServer(ABC): + __test__ = False + + def __init__( + self, + *, + scheme: str = "", + loop: Optional[asyncio.AbstractEventLoop] = None, + host: str = "127.0.0.1", + port: Optional[int] = None, + skip_url_asserts: bool = False, + socket_factory: Callable[ + [str, int, socket.AddressFamily], socket.socket + ] = get_port_socket, + **kwargs: Any, + ) -> None: + self._loop = loop + self.runner: Optional[BaseRunner] = None + self._root: Optional[URL] = None + self.host = host + self.port = port + self._closed = False + self.scheme = scheme + self.skip_url_asserts = skip_url_asserts + self.socket_factory = socket_factory + + async def start_server( + self, loop: Optional[asyncio.AbstractEventLoop] = None, **kwargs: Any + ) -> None: + if self.runner: + return + self._loop = loop + self._ssl = kwargs.pop("ssl", None) + self.runner = await self._make_runner(handler_cancellation=True, **kwargs) + await self.runner.setup() + if not self.port: + self.port = 0 + absolute_host = self.host + try: + version = ipaddress.ip_address(self.host).version + except ValueError: + version = 4 + if version == 6: + absolute_host = f"[{self.host}]" + family = socket.AF_INET6 if version == 6 else socket.AF_INET + _sock = self.socket_factory(self.host, self.port, family) + self.host, self.port = _sock.getsockname()[:2] + site = SockSite(self.runner, sock=_sock, ssl_context=self._ssl) + await site.start() + server = site._server + assert server is not None + sockets = server.sockets # type: ignore[attr-defined] + assert sockets is not None + self.port = sockets[0].getsockname()[1] + if not self.scheme: + self.scheme = "https" if self._ssl else "http" + self._root = URL(f"{self.scheme}://{absolute_host}:{self.port}") + + @abstractmethod # pragma: no cover + async def _make_runner(self, **kwargs: Any) -> BaseRunner: + pass + + def make_url(self, path: StrOrURL) -> URL: + assert self._root is not None + url = URL(path) + if not self.skip_url_asserts: + assert not url.absolute + return self._root.join(url) + else: + return URL(str(self._root) + str(path)) + + @property + def started(self) -> bool: + return self.runner is not None + + @property + def closed(self) -> bool: + return self._closed + + @property + def handler(self) -> Server: + # for backward compatibility + # web.Server instance + runner = self.runner + assert runner is not None + assert runner.server is not None + return runner.server + + async def close(self) -> None: + """Close all fixtures created by the test client. + + After that point, the TestClient is no longer usable. + + This is an idempotent function: running close multiple times + will not have any additional effects. + + close is also run when the object is garbage collected, and on + exit when used as a context manager. + + """ + if self.started and not self.closed: + assert self.runner is not None + await self.runner.cleanup() + self._root = None + self.port = None + self._closed = True + + def __enter__(self) -> None: + raise TypeError("Use async with instead") + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_value: Optional[BaseException], + traceback: Optional[TracebackType], + ) -> None: + # __exit__ should exist in pair with __enter__ but never executed + pass # pragma: no cover + + async def __aenter__(self) -> "BaseTestServer": + await self.start_server(loop=self._loop) + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc_value: Optional[BaseException], + traceback: Optional[TracebackType], + ) -> None: + await self.close() + + +class TestServer(BaseTestServer): + def __init__( + self, + app: Application, + *, + scheme: str = "", + host: str = "127.0.0.1", + port: Optional[int] = None, + **kwargs: Any, + ): + self.app = app + super().__init__(scheme=scheme, host=host, port=port, **kwargs) + + async def _make_runner(self, **kwargs: Any) -> BaseRunner: + return AppRunner(self.app, **kwargs) + + +class RawTestServer(BaseTestServer): + def __init__( + self, + handler: _RequestHandler, + *, + scheme: str = "", + host: str = "127.0.0.1", + port: Optional[int] = None, + **kwargs: Any, + ) -> None: + self._handler = handler + super().__init__(scheme=scheme, host=host, port=port, **kwargs) + + async def _make_runner(self, debug: bool = True, **kwargs: Any) -> ServerRunner: + srv = Server(self._handler, loop=self._loop, debug=debug, **kwargs) + return ServerRunner(srv, debug=debug, **kwargs) + + +class TestClient(Generic[_Request, _ApplicationNone]): + """ + A test client implementation. + + To write functional tests for aiohttp based servers. + + """ + + __test__ = False + + @overload + def __init__( + self: "TestClient[Request, Application]", + server: TestServer, + *, + cookie_jar: Optional[AbstractCookieJar] = None, + **kwargs: Any, + ) -> None: ... + @overload + def __init__( + self: "TestClient[_Request, None]", + server: BaseTestServer, + *, + cookie_jar: Optional[AbstractCookieJar] = None, + **kwargs: Any, + ) -> None: ... + def __init__( + self, + server: BaseTestServer, + *, + cookie_jar: Optional[AbstractCookieJar] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + **kwargs: Any, + ) -> None: + if not isinstance(server, BaseTestServer): + raise TypeError( + "server must be TestServer instance, found type: %r" % type(server) + ) + self._server = server + self._loop = loop + if cookie_jar is None: + cookie_jar = aiohttp.CookieJar(unsafe=True, loop=loop) + self._session = ClientSession(loop=loop, cookie_jar=cookie_jar, **kwargs) + self._session._retry_connection = False + self._closed = False + self._responses: List[ClientResponse] = [] + self._websockets: List[ClientWebSocketResponse] = [] + + async def start_server(self) -> None: + await self._server.start_server(loop=self._loop) + + @property + def host(self) -> str: + return self._server.host + + @property + def port(self) -> Optional[int]: + return self._server.port + + @property + def server(self) -> BaseTestServer: + return self._server + + @property + def app(self) -> _ApplicationNone: + return getattr(self._server, "app", None) # type: ignore[return-value] + + @property + def session(self) -> ClientSession: + """An internal aiohttp.ClientSession. + + Unlike the methods on the TestClient, client session requests + do not automatically include the host in the url queried, and + will require an absolute path to the resource. + + """ + return self._session + + def make_url(self, path: StrOrURL) -> URL: + return self._server.make_url(path) + + async def _request( + self, method: str, path: StrOrURL, **kwargs: Any + ) -> ClientResponse: + resp = await self._session.request(method, self.make_url(path), **kwargs) + # save it to close later + self._responses.append(resp) + return resp + + if sys.version_info >= (3, 11) and TYPE_CHECKING: + + def request( + self, method: str, path: StrOrURL, **kwargs: Unpack[_RequestOptions] + ) -> _RequestContextManager: ... + + def get( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + def options( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + def head( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + def post( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + def put( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + def patch( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + def delete( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + else: + + def request( + self, method: str, path: StrOrURL, **kwargs: Any + ) -> _RequestContextManager: + """Routes a request to tested http server. + + The interface is identical to aiohttp.ClientSession.request, + except the loop kwarg is overridden by the instance used by the + test server. + + """ + return _RequestContextManager(self._request(method, path, **kwargs)) + + def get(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP GET request.""" + return _RequestContextManager(self._request(hdrs.METH_GET, path, **kwargs)) + + def post(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP POST request.""" + return _RequestContextManager(self._request(hdrs.METH_POST, path, **kwargs)) + + def options(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP OPTIONS request.""" + return _RequestContextManager( + self._request(hdrs.METH_OPTIONS, path, **kwargs) + ) + + def head(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP HEAD request.""" + return _RequestContextManager(self._request(hdrs.METH_HEAD, path, **kwargs)) + + def put(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP PUT request.""" + return _RequestContextManager(self._request(hdrs.METH_PUT, path, **kwargs)) + + def patch(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP PATCH request.""" + return _RequestContextManager( + self._request(hdrs.METH_PATCH, path, **kwargs) + ) + + def delete(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP PATCH request.""" + return _RequestContextManager( + self._request(hdrs.METH_DELETE, path, **kwargs) + ) + + def ws_connect(self, path: StrOrURL, **kwargs: Any) -> _WSRequestContextManager: + """Initiate websocket connection. + + The api corresponds to aiohttp.ClientSession.ws_connect. + + """ + return _WSRequestContextManager(self._ws_connect(path, **kwargs)) + + async def _ws_connect( + self, path: StrOrURL, **kwargs: Any + ) -> ClientWebSocketResponse: + ws = await self._session.ws_connect(self.make_url(path), **kwargs) + self._websockets.append(ws) + return ws + + async def close(self) -> None: + """Close all fixtures created by the test client. + + After that point, the TestClient is no longer usable. + + This is an idempotent function: running close multiple times + will not have any additional effects. + + close is also run on exit when used as a(n) (asynchronous) + context manager. + + """ + if not self._closed: + for resp in self._responses: + resp.close() + for ws in self._websockets: + await ws.close() + await self._session.close() + await self._server.close() + self._closed = True + + def __enter__(self) -> None: + raise TypeError("Use async with instead") + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc: Optional[BaseException], + tb: Optional[TracebackType], + ) -> None: + # __exit__ should exist in pair with __enter__ but never executed + pass # pragma: no cover + + async def __aenter__(self) -> Self: + await self.start_server() + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc: Optional[BaseException], + tb: Optional[TracebackType], + ) -> None: + await self.close() + + +class AioHTTPTestCase(IsolatedAsyncioTestCase): + """A base class to allow for unittest web applications using aiohttp. + + Provides the following: + + * self.client (aiohttp.test_utils.TestClient): an aiohttp test client. + * self.loop (asyncio.BaseEventLoop): the event loop in which the + application and server are running. + * self.app (aiohttp.web.Application): the application returned by + self.get_application() + + Note that the TestClient's methods are asynchronous: you have to + execute function on the test client using asynchronous methods. + """ + + async def get_application(self) -> Application: + """Get application. + + This method should be overridden + to return the aiohttp.web.Application + object to test. + """ + return self.get_app() + + def get_app(self) -> Application: + """Obsolete method used to constructing web application. + + Use .get_application() coroutine instead. + """ + raise RuntimeError("Did you forget to define get_application()?") + + async def asyncSetUp(self) -> None: + self.loop = asyncio.get_running_loop() + return await self.setUpAsync() + + async def setUpAsync(self) -> None: + self.app = await self.get_application() + self.server = await self.get_server(self.app) + self.client = await self.get_client(self.server) + + await self.client.start_server() + + async def asyncTearDown(self) -> None: + return await self.tearDownAsync() + + async def tearDownAsync(self) -> None: + await self.client.close() + + async def get_server(self, app: Application) -> TestServer: + """Return a TestServer instance.""" + return TestServer(app, loop=self.loop) + + async def get_client(self, server: TestServer) -> TestClient[Request, Application]: + """Return a TestClient instance.""" + return TestClient(server, loop=self.loop) + + +def unittest_run_loop(func: Any, *args: Any, **kwargs: Any) -> Any: + """ + A decorator dedicated to use with asynchronous AioHTTPTestCase test methods. + + In 3.8+, this does nothing. + """ + warnings.warn( + "Decorator `@unittest_run_loop` is no longer needed in aiohttp 3.8+", + DeprecationWarning, + stacklevel=2, + ) + return func + + +_LOOP_FACTORY = Callable[[], asyncio.AbstractEventLoop] + + +@contextlib.contextmanager +def loop_context( + loop_factory: _LOOP_FACTORY = asyncio.new_event_loop, fast: bool = False +) -> Iterator[asyncio.AbstractEventLoop]: + """A contextmanager that creates an event_loop, for test purposes. + + Handles the creation and cleanup of a test loop. + """ + loop = setup_test_loop(loop_factory) + yield loop + teardown_test_loop(loop, fast=fast) + + +def setup_test_loop( + loop_factory: _LOOP_FACTORY = asyncio.new_event_loop, +) -> asyncio.AbstractEventLoop: + """Create and return an asyncio.BaseEventLoop instance. + + The caller should also call teardown_test_loop, + once they are done with the loop. + """ + loop = loop_factory() + asyncio.set_event_loop(loop) + return loop + + +def teardown_test_loop(loop: asyncio.AbstractEventLoop, fast: bool = False) -> None: + """Teardown and cleanup an event_loop created by setup_test_loop.""" + closed = loop.is_closed() + if not closed: + loop.call_soon(loop.stop) + loop.run_forever() + loop.close() + + if not fast: + gc.collect() + + asyncio.set_event_loop(None) + + +def _create_app_mock() -> mock.MagicMock: + def get_dict(app: Any, key: str) -> Any: + return app.__app_dict[key] + + def set_dict(app: Any, key: str, value: Any) -> None: + app.__app_dict[key] = value + + app = mock.MagicMock(spec=Application) + app.__app_dict = {} + app.__getitem__ = get_dict + app.__setitem__ = set_dict + + app._debug = False + app.on_response_prepare = Signal(app) + app.on_response_prepare.freeze() + return app + + +def _create_transport(sslcontext: Optional[SSLContext] = None) -> mock.Mock: + transport = mock.Mock() + + def get_extra_info(key: str) -> Optional[SSLContext]: + if key == "sslcontext": + return sslcontext + else: + return None + + transport.get_extra_info.side_effect = get_extra_info + return transport + + +def make_mocked_request( + method: str, + path: str, + headers: Any = None, + *, + match_info: Any = sentinel, + version: HttpVersion = HttpVersion(1, 1), + closing: bool = False, + app: Any = None, + writer: Any = sentinel, + protocol: Any = sentinel, + transport: Any = sentinel, + payload: StreamReader = EMPTY_PAYLOAD, + sslcontext: Optional[SSLContext] = None, + client_max_size: int = 1024**2, + loop: Any = ..., +) -> Request: + """Creates mocked web.Request testing purposes. + + Useful in unit tests, when spinning full web server is overkill or + specific conditions and errors are hard to trigger. + """ + task = mock.Mock() + if loop is ...: + # no loop passed, try to get the current one if + # its is running as we need a real loop to create + # executor jobs to be able to do testing + # with a real executor + try: + loop = asyncio.get_running_loop() + except RuntimeError: + loop = mock.Mock() + loop.create_future.return_value = () + + if version < HttpVersion(1, 1): + closing = True + + if headers: + headers = CIMultiDictProxy(CIMultiDict(headers)) + raw_hdrs = tuple( + (k.encode("utf-8"), v.encode("utf-8")) for k, v in headers.items() + ) + else: + headers = CIMultiDictProxy(CIMultiDict()) + raw_hdrs = () + + chunked = "chunked" in headers.get(hdrs.TRANSFER_ENCODING, "").lower() + + message = RawRequestMessage( + method, + path, + version, + headers, + raw_hdrs, + closing, + None, + False, + chunked, + URL(path), + ) + if app is None: + app = _create_app_mock() + + if transport is sentinel: + transport = _create_transport(sslcontext) + + if protocol is sentinel: + protocol = mock.Mock() + protocol.transport = transport + type(protocol).peername = mock.PropertyMock( + return_value=transport.get_extra_info("peername") + ) + type(protocol).ssl_context = mock.PropertyMock(return_value=sslcontext) + + if writer is sentinel: + writer = mock.Mock() + writer.write_headers = make_mocked_coro(None) + writer.write = make_mocked_coro(None) + writer.write_eof = make_mocked_coro(None) + writer.drain = make_mocked_coro(None) + writer.transport = transport + + protocol.transport = transport + protocol.writer = writer + + req = Request( + message, payload, protocol, writer, task, loop, client_max_size=client_max_size + ) + + match_info = UrlMappingMatchInfo( + {} if match_info is sentinel else match_info, mock.Mock() + ) + match_info.add_app(app) + req._match_info = match_info + + return req + + +def make_mocked_coro( + return_value: Any = sentinel, raise_exception: Any = sentinel +) -> Any: + """Creates a coroutine mock.""" + + async def mock_coro(*args: Any, **kwargs: Any) -> Any: + if raise_exception is not sentinel: + raise raise_exception + if not inspect.isawaitable(return_value): + return return_value + await return_value + + return mock.Mock(wraps=mock_coro) diff --git a/env/lib/python3.12/site-packages/aiohttp/tracing.py b/env/lib/python3.12/site-packages/aiohttp/tracing.py new file mode 100644 index 0000000..568fa7f --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/tracing.py @@ -0,0 +1,455 @@ +from types import SimpleNamespace +from typing import TYPE_CHECKING, Mapping, Optional, Type, TypeVar + +import attr +from aiosignal import Signal +from multidict import CIMultiDict +from yarl import URL + +from .client_reqrep import ClientResponse + +if TYPE_CHECKING: + from .client import ClientSession + + _ParamT_contra = TypeVar("_ParamT_contra", contravariant=True) + _TracingSignal = Signal[ClientSession, SimpleNamespace, _ParamT_contra] + + +__all__ = ( + "TraceConfig", + "TraceRequestStartParams", + "TraceRequestEndParams", + "TraceRequestExceptionParams", + "TraceConnectionQueuedStartParams", + "TraceConnectionQueuedEndParams", + "TraceConnectionCreateStartParams", + "TraceConnectionCreateEndParams", + "TraceConnectionReuseconnParams", + "TraceDnsResolveHostStartParams", + "TraceDnsResolveHostEndParams", + "TraceDnsCacheHitParams", + "TraceDnsCacheMissParams", + "TraceRequestRedirectParams", + "TraceRequestChunkSentParams", + "TraceResponseChunkReceivedParams", + "TraceRequestHeadersSentParams", +) + + +class TraceConfig: + """First-class used to trace requests launched via ClientSession objects.""" + + def __init__( + self, trace_config_ctx_factory: Type[SimpleNamespace] = SimpleNamespace + ) -> None: + self._on_request_start: _TracingSignal[TraceRequestStartParams] = Signal(self) + self._on_request_chunk_sent: _TracingSignal[TraceRequestChunkSentParams] = ( + Signal(self) + ) + self._on_response_chunk_received: _TracingSignal[ + TraceResponseChunkReceivedParams + ] = Signal(self) + self._on_request_end: _TracingSignal[TraceRequestEndParams] = Signal(self) + self._on_request_exception: _TracingSignal[TraceRequestExceptionParams] = ( + Signal(self) + ) + self._on_request_redirect: _TracingSignal[TraceRequestRedirectParams] = Signal( + self + ) + self._on_connection_queued_start: _TracingSignal[ + TraceConnectionQueuedStartParams + ] = Signal(self) + self._on_connection_queued_end: _TracingSignal[ + TraceConnectionQueuedEndParams + ] = Signal(self) + self._on_connection_create_start: _TracingSignal[ + TraceConnectionCreateStartParams + ] = Signal(self) + self._on_connection_create_end: _TracingSignal[ + TraceConnectionCreateEndParams + ] = Signal(self) + self._on_connection_reuseconn: _TracingSignal[ + TraceConnectionReuseconnParams + ] = Signal(self) + self._on_dns_resolvehost_start: _TracingSignal[ + TraceDnsResolveHostStartParams + ] = Signal(self) + self._on_dns_resolvehost_end: _TracingSignal[TraceDnsResolveHostEndParams] = ( + Signal(self) + ) + self._on_dns_cache_hit: _TracingSignal[TraceDnsCacheHitParams] = Signal(self) + self._on_dns_cache_miss: _TracingSignal[TraceDnsCacheMissParams] = Signal(self) + self._on_request_headers_sent: _TracingSignal[TraceRequestHeadersSentParams] = ( + Signal(self) + ) + + self._trace_config_ctx_factory = trace_config_ctx_factory + + def trace_config_ctx( + self, trace_request_ctx: Optional[Mapping[str, str]] = None + ) -> SimpleNamespace: + """Return a new trace_config_ctx instance""" + return self._trace_config_ctx_factory(trace_request_ctx=trace_request_ctx) + + def freeze(self) -> None: + self._on_request_start.freeze() + self._on_request_chunk_sent.freeze() + self._on_response_chunk_received.freeze() + self._on_request_end.freeze() + self._on_request_exception.freeze() + self._on_request_redirect.freeze() + self._on_connection_queued_start.freeze() + self._on_connection_queued_end.freeze() + self._on_connection_create_start.freeze() + self._on_connection_create_end.freeze() + self._on_connection_reuseconn.freeze() + self._on_dns_resolvehost_start.freeze() + self._on_dns_resolvehost_end.freeze() + self._on_dns_cache_hit.freeze() + self._on_dns_cache_miss.freeze() + self._on_request_headers_sent.freeze() + + @property + def on_request_start(self) -> "_TracingSignal[TraceRequestStartParams]": + return self._on_request_start + + @property + def on_request_chunk_sent( + self, + ) -> "_TracingSignal[TraceRequestChunkSentParams]": + return self._on_request_chunk_sent + + @property + def on_response_chunk_received( + self, + ) -> "_TracingSignal[TraceResponseChunkReceivedParams]": + return self._on_response_chunk_received + + @property + def on_request_end(self) -> "_TracingSignal[TraceRequestEndParams]": + return self._on_request_end + + @property + def on_request_exception( + self, + ) -> "_TracingSignal[TraceRequestExceptionParams]": + return self._on_request_exception + + @property + def on_request_redirect( + self, + ) -> "_TracingSignal[TraceRequestRedirectParams]": + return self._on_request_redirect + + @property + def on_connection_queued_start( + self, + ) -> "_TracingSignal[TraceConnectionQueuedStartParams]": + return self._on_connection_queued_start + + @property + def on_connection_queued_end( + self, + ) -> "_TracingSignal[TraceConnectionQueuedEndParams]": + return self._on_connection_queued_end + + @property + def on_connection_create_start( + self, + ) -> "_TracingSignal[TraceConnectionCreateStartParams]": + return self._on_connection_create_start + + @property + def on_connection_create_end( + self, + ) -> "_TracingSignal[TraceConnectionCreateEndParams]": + return self._on_connection_create_end + + @property + def on_connection_reuseconn( + self, + ) -> "_TracingSignal[TraceConnectionReuseconnParams]": + return self._on_connection_reuseconn + + @property + def on_dns_resolvehost_start( + self, + ) -> "_TracingSignal[TraceDnsResolveHostStartParams]": + return self._on_dns_resolvehost_start + + @property + def on_dns_resolvehost_end( + self, + ) -> "_TracingSignal[TraceDnsResolveHostEndParams]": + return self._on_dns_resolvehost_end + + @property + def on_dns_cache_hit(self) -> "_TracingSignal[TraceDnsCacheHitParams]": + return self._on_dns_cache_hit + + @property + def on_dns_cache_miss(self) -> "_TracingSignal[TraceDnsCacheMissParams]": + return self._on_dns_cache_miss + + @property + def on_request_headers_sent( + self, + ) -> "_TracingSignal[TraceRequestHeadersSentParams]": + return self._on_request_headers_sent + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceRequestStartParams: + """Parameters sent by the `on_request_start` signal""" + + method: str + url: URL + headers: "CIMultiDict[str]" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceRequestChunkSentParams: + """Parameters sent by the `on_request_chunk_sent` signal""" + + method: str + url: URL + chunk: bytes + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceResponseChunkReceivedParams: + """Parameters sent by the `on_response_chunk_received` signal""" + + method: str + url: URL + chunk: bytes + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceRequestEndParams: + """Parameters sent by the `on_request_end` signal""" + + method: str + url: URL + headers: "CIMultiDict[str]" + response: ClientResponse + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceRequestExceptionParams: + """Parameters sent by the `on_request_exception` signal""" + + method: str + url: URL + headers: "CIMultiDict[str]" + exception: BaseException + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceRequestRedirectParams: + """Parameters sent by the `on_request_redirect` signal""" + + method: str + url: URL + headers: "CIMultiDict[str]" + response: ClientResponse + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceConnectionQueuedStartParams: + """Parameters sent by the `on_connection_queued_start` signal""" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceConnectionQueuedEndParams: + """Parameters sent by the `on_connection_queued_end` signal""" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceConnectionCreateStartParams: + """Parameters sent by the `on_connection_create_start` signal""" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceConnectionCreateEndParams: + """Parameters sent by the `on_connection_create_end` signal""" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceConnectionReuseconnParams: + """Parameters sent by the `on_connection_reuseconn` signal""" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceDnsResolveHostStartParams: + """Parameters sent by the `on_dns_resolvehost_start` signal""" + + host: str + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceDnsResolveHostEndParams: + """Parameters sent by the `on_dns_resolvehost_end` signal""" + + host: str + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceDnsCacheHitParams: + """Parameters sent by the `on_dns_cache_hit` signal""" + + host: str + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceDnsCacheMissParams: + """Parameters sent by the `on_dns_cache_miss` signal""" + + host: str + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceRequestHeadersSentParams: + """Parameters sent by the `on_request_headers_sent` signal""" + + method: str + url: URL + headers: "CIMultiDict[str]" + + +class Trace: + """Internal dependency holder class. + + Used to keep together the main dependencies used + at the moment of send a signal. + """ + + def __init__( + self, + session: "ClientSession", + trace_config: TraceConfig, + trace_config_ctx: SimpleNamespace, + ) -> None: + self._trace_config = trace_config + self._trace_config_ctx = trace_config_ctx + self._session = session + + async def send_request_start( + self, method: str, url: URL, headers: "CIMultiDict[str]" + ) -> None: + return await self._trace_config.on_request_start.send( + self._session, + self._trace_config_ctx, + TraceRequestStartParams(method, url, headers), + ) + + async def send_request_chunk_sent( + self, method: str, url: URL, chunk: bytes + ) -> None: + return await self._trace_config.on_request_chunk_sent.send( + self._session, + self._trace_config_ctx, + TraceRequestChunkSentParams(method, url, chunk), + ) + + async def send_response_chunk_received( + self, method: str, url: URL, chunk: bytes + ) -> None: + return await self._trace_config.on_response_chunk_received.send( + self._session, + self._trace_config_ctx, + TraceResponseChunkReceivedParams(method, url, chunk), + ) + + async def send_request_end( + self, + method: str, + url: URL, + headers: "CIMultiDict[str]", + response: ClientResponse, + ) -> None: + return await self._trace_config.on_request_end.send( + self._session, + self._trace_config_ctx, + TraceRequestEndParams(method, url, headers, response), + ) + + async def send_request_exception( + self, + method: str, + url: URL, + headers: "CIMultiDict[str]", + exception: BaseException, + ) -> None: + return await self._trace_config.on_request_exception.send( + self._session, + self._trace_config_ctx, + TraceRequestExceptionParams(method, url, headers, exception), + ) + + async def send_request_redirect( + self, + method: str, + url: URL, + headers: "CIMultiDict[str]", + response: ClientResponse, + ) -> None: + return await self._trace_config._on_request_redirect.send( + self._session, + self._trace_config_ctx, + TraceRequestRedirectParams(method, url, headers, response), + ) + + async def send_connection_queued_start(self) -> None: + return await self._trace_config.on_connection_queued_start.send( + self._session, self._trace_config_ctx, TraceConnectionQueuedStartParams() + ) + + async def send_connection_queued_end(self) -> None: + return await self._trace_config.on_connection_queued_end.send( + self._session, self._trace_config_ctx, TraceConnectionQueuedEndParams() + ) + + async def send_connection_create_start(self) -> None: + return await self._trace_config.on_connection_create_start.send( + self._session, self._trace_config_ctx, TraceConnectionCreateStartParams() + ) + + async def send_connection_create_end(self) -> None: + return await self._trace_config.on_connection_create_end.send( + self._session, self._trace_config_ctx, TraceConnectionCreateEndParams() + ) + + async def send_connection_reuseconn(self) -> None: + return await self._trace_config.on_connection_reuseconn.send( + self._session, self._trace_config_ctx, TraceConnectionReuseconnParams() + ) + + async def send_dns_resolvehost_start(self, host: str) -> None: + return await self._trace_config.on_dns_resolvehost_start.send( + self._session, self._trace_config_ctx, TraceDnsResolveHostStartParams(host) + ) + + async def send_dns_resolvehost_end(self, host: str) -> None: + return await self._trace_config.on_dns_resolvehost_end.send( + self._session, self._trace_config_ctx, TraceDnsResolveHostEndParams(host) + ) + + async def send_dns_cache_hit(self, host: str) -> None: + return await self._trace_config.on_dns_cache_hit.send( + self._session, self._trace_config_ctx, TraceDnsCacheHitParams(host) + ) + + async def send_dns_cache_miss(self, host: str) -> None: + return await self._trace_config.on_dns_cache_miss.send( + self._session, self._trace_config_ctx, TraceDnsCacheMissParams(host) + ) + + async def send_request_headers( + self, method: str, url: URL, headers: "CIMultiDict[str]" + ) -> None: + return await self._trace_config._on_request_headers_sent.send( + self._session, + self._trace_config_ctx, + TraceRequestHeadersSentParams(method, url, headers), + ) diff --git a/env/lib/python3.12/site-packages/aiohttp/typedefs.py b/env/lib/python3.12/site-packages/aiohttp/typedefs.py new file mode 100644 index 0000000..cc8c082 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/typedefs.py @@ -0,0 +1,69 @@ +import json +import os +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Iterable, + Mapping, + Protocol, + Tuple, + Union, +) + +from multidict import CIMultiDict, CIMultiDictProxy, MultiDict, MultiDictProxy, istr +from yarl import URL, Query as _Query + +Query = _Query + +DEFAULT_JSON_ENCODER = json.dumps +DEFAULT_JSON_DECODER = json.loads + +if TYPE_CHECKING: + _CIMultiDict = CIMultiDict[str] + _CIMultiDictProxy = CIMultiDictProxy[str] + _MultiDict = MultiDict[str] + _MultiDictProxy = MultiDictProxy[str] + from http.cookies import BaseCookie, Morsel + + from .web import Request, StreamResponse +else: + _CIMultiDict = CIMultiDict + _CIMultiDictProxy = CIMultiDictProxy + _MultiDict = MultiDict + _MultiDictProxy = MultiDictProxy + +Byteish = Union[bytes, bytearray, memoryview] +JSONEncoder = Callable[[Any], str] +JSONDecoder = Callable[[str], Any] +LooseHeaders = Union[ + Mapping[str, str], + Mapping[istr, str], + _CIMultiDict, + _CIMultiDictProxy, + Iterable[Tuple[Union[str, istr], str]], +] +RawHeaders = Tuple[Tuple[bytes, bytes], ...] +StrOrURL = Union[str, URL] + +LooseCookiesMappings = Mapping[str, Union[str, "BaseCookie[str]", "Morsel[Any]"]] +LooseCookiesIterables = Iterable[ + Tuple[str, Union[str, "BaseCookie[str]", "Morsel[Any]"]] +] +LooseCookies = Union[ + LooseCookiesMappings, + LooseCookiesIterables, + "BaseCookie[str]", +] + +Handler = Callable[["Request"], Awaitable["StreamResponse"]] + + +class Middleware(Protocol): + def __call__( + self, request: "Request", handler: Handler + ) -> Awaitable["StreamResponse"]: ... + + +PathLike = Union[str, "os.PathLike[str]"] diff --git a/env/lib/python3.12/site-packages/aiohttp/web.py b/env/lib/python3.12/site-packages/aiohttp/web.py new file mode 100644 index 0000000..5a1fc96 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web.py @@ -0,0 +1,592 @@ +import asyncio +import logging +import os +import socket +import sys +import warnings +from argparse import ArgumentParser +from collections.abc import Iterable +from contextlib import suppress +from importlib import import_module +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Iterable as TypingIterable, + List, + Optional, + Set, + Type, + Union, + cast, +) + +from .abc import AbstractAccessLogger +from .helpers import AppKey as AppKey +from .log import access_logger +from .typedefs import PathLike +from .web_app import Application as Application, CleanupError as CleanupError +from .web_exceptions import ( + HTTPAccepted as HTTPAccepted, + HTTPBadGateway as HTTPBadGateway, + HTTPBadRequest as HTTPBadRequest, + HTTPClientError as HTTPClientError, + HTTPConflict as HTTPConflict, + HTTPCreated as HTTPCreated, + HTTPError as HTTPError, + HTTPException as HTTPException, + HTTPExpectationFailed as HTTPExpectationFailed, + HTTPFailedDependency as HTTPFailedDependency, + HTTPForbidden as HTTPForbidden, + HTTPFound as HTTPFound, + HTTPGatewayTimeout as HTTPGatewayTimeout, + HTTPGone as HTTPGone, + HTTPInsufficientStorage as HTTPInsufficientStorage, + HTTPInternalServerError as HTTPInternalServerError, + HTTPLengthRequired as HTTPLengthRequired, + HTTPMethodNotAllowed as HTTPMethodNotAllowed, + HTTPMisdirectedRequest as HTTPMisdirectedRequest, + HTTPMove as HTTPMove, + HTTPMovedPermanently as HTTPMovedPermanently, + HTTPMultipleChoices as HTTPMultipleChoices, + HTTPNetworkAuthenticationRequired as HTTPNetworkAuthenticationRequired, + HTTPNoContent as HTTPNoContent, + HTTPNonAuthoritativeInformation as HTTPNonAuthoritativeInformation, + HTTPNotAcceptable as HTTPNotAcceptable, + HTTPNotExtended as HTTPNotExtended, + HTTPNotFound as HTTPNotFound, + HTTPNotImplemented as HTTPNotImplemented, + HTTPNotModified as HTTPNotModified, + HTTPOk as HTTPOk, + HTTPPartialContent as HTTPPartialContent, + HTTPPaymentRequired as HTTPPaymentRequired, + HTTPPermanentRedirect as HTTPPermanentRedirect, + HTTPPreconditionFailed as HTTPPreconditionFailed, + HTTPPreconditionRequired as HTTPPreconditionRequired, + HTTPProxyAuthenticationRequired as HTTPProxyAuthenticationRequired, + HTTPRedirection as HTTPRedirection, + HTTPRequestEntityTooLarge as HTTPRequestEntityTooLarge, + HTTPRequestHeaderFieldsTooLarge as HTTPRequestHeaderFieldsTooLarge, + HTTPRequestRangeNotSatisfiable as HTTPRequestRangeNotSatisfiable, + HTTPRequestTimeout as HTTPRequestTimeout, + HTTPRequestURITooLong as HTTPRequestURITooLong, + HTTPResetContent as HTTPResetContent, + HTTPSeeOther as HTTPSeeOther, + HTTPServerError as HTTPServerError, + HTTPServiceUnavailable as HTTPServiceUnavailable, + HTTPSuccessful as HTTPSuccessful, + HTTPTemporaryRedirect as HTTPTemporaryRedirect, + HTTPTooManyRequests as HTTPTooManyRequests, + HTTPUnauthorized as HTTPUnauthorized, + HTTPUnavailableForLegalReasons as HTTPUnavailableForLegalReasons, + HTTPUnprocessableEntity as HTTPUnprocessableEntity, + HTTPUnsupportedMediaType as HTTPUnsupportedMediaType, + HTTPUpgradeRequired as HTTPUpgradeRequired, + HTTPUseProxy as HTTPUseProxy, + HTTPVariantAlsoNegotiates as HTTPVariantAlsoNegotiates, + HTTPVersionNotSupported as HTTPVersionNotSupported, + NotAppKeyWarning as NotAppKeyWarning, +) +from .web_fileresponse import FileResponse as FileResponse +from .web_log import AccessLogger +from .web_middlewares import ( + middleware as middleware, + normalize_path_middleware as normalize_path_middleware, +) +from .web_protocol import ( + PayloadAccessError as PayloadAccessError, + RequestHandler as RequestHandler, + RequestPayloadError as RequestPayloadError, +) +from .web_request import ( + BaseRequest as BaseRequest, + FileField as FileField, + Request as Request, +) +from .web_response import ( + ContentCoding as ContentCoding, + Response as Response, + StreamResponse as StreamResponse, + json_response as json_response, +) +from .web_routedef import ( + AbstractRouteDef as AbstractRouteDef, + RouteDef as RouteDef, + RouteTableDef as RouteTableDef, + StaticDef as StaticDef, + delete as delete, + get as get, + head as head, + options as options, + patch as patch, + post as post, + put as put, + route as route, + static as static, + view as view, +) +from .web_runner import ( + AppRunner as AppRunner, + BaseRunner as BaseRunner, + BaseSite as BaseSite, + GracefulExit as GracefulExit, + NamedPipeSite as NamedPipeSite, + ServerRunner as ServerRunner, + SockSite as SockSite, + TCPSite as TCPSite, + UnixSite as UnixSite, +) +from .web_server import Server as Server +from .web_urldispatcher import ( + AbstractResource as AbstractResource, + AbstractRoute as AbstractRoute, + DynamicResource as DynamicResource, + PlainResource as PlainResource, + PrefixedSubAppResource as PrefixedSubAppResource, + Resource as Resource, + ResourceRoute as ResourceRoute, + StaticResource as StaticResource, + UrlDispatcher as UrlDispatcher, + UrlMappingMatchInfo as UrlMappingMatchInfo, + View as View, +) +from .web_ws import ( + WebSocketReady as WebSocketReady, + WebSocketResponse as WebSocketResponse, + WSMsgType as WSMsgType, +) + +__all__ = ( + # web_app + "AppKey", + "Application", + "CleanupError", + # web_exceptions + "NotAppKeyWarning", + "HTTPAccepted", + "HTTPBadGateway", + "HTTPBadRequest", + "HTTPClientError", + "HTTPConflict", + "HTTPCreated", + "HTTPError", + "HTTPException", + "HTTPExpectationFailed", + "HTTPFailedDependency", + "HTTPForbidden", + "HTTPFound", + "HTTPGatewayTimeout", + "HTTPGone", + "HTTPInsufficientStorage", + "HTTPInternalServerError", + "HTTPLengthRequired", + "HTTPMethodNotAllowed", + "HTTPMisdirectedRequest", + "HTTPMove", + "HTTPMovedPermanently", + "HTTPMultipleChoices", + "HTTPNetworkAuthenticationRequired", + "HTTPNoContent", + "HTTPNonAuthoritativeInformation", + "HTTPNotAcceptable", + "HTTPNotExtended", + "HTTPNotFound", + "HTTPNotImplemented", + "HTTPNotModified", + "HTTPOk", + "HTTPPartialContent", + "HTTPPaymentRequired", + "HTTPPermanentRedirect", + "HTTPPreconditionFailed", + "HTTPPreconditionRequired", + "HTTPProxyAuthenticationRequired", + "HTTPRedirection", + "HTTPRequestEntityTooLarge", + "HTTPRequestHeaderFieldsTooLarge", + "HTTPRequestRangeNotSatisfiable", + "HTTPRequestTimeout", + "HTTPRequestURITooLong", + "HTTPResetContent", + "HTTPSeeOther", + "HTTPServerError", + "HTTPServiceUnavailable", + "HTTPSuccessful", + "HTTPTemporaryRedirect", + "HTTPTooManyRequests", + "HTTPUnauthorized", + "HTTPUnavailableForLegalReasons", + "HTTPUnprocessableEntity", + "HTTPUnsupportedMediaType", + "HTTPUpgradeRequired", + "HTTPUseProxy", + "HTTPVariantAlsoNegotiates", + "HTTPVersionNotSupported", + # web_fileresponse + "FileResponse", + # web_middlewares + "middleware", + "normalize_path_middleware", + # web_protocol + "PayloadAccessError", + "RequestHandler", + "RequestPayloadError", + # web_request + "BaseRequest", + "FileField", + "Request", + # web_response + "ContentCoding", + "Response", + "StreamResponse", + "json_response", + # web_routedef + "AbstractRouteDef", + "RouteDef", + "RouteTableDef", + "StaticDef", + "delete", + "get", + "head", + "options", + "patch", + "post", + "put", + "route", + "static", + "view", + # web_runner + "AppRunner", + "BaseRunner", + "BaseSite", + "GracefulExit", + "ServerRunner", + "SockSite", + "TCPSite", + "UnixSite", + "NamedPipeSite", + # web_server + "Server", + # web_urldispatcher + "AbstractResource", + "AbstractRoute", + "DynamicResource", + "PlainResource", + "PrefixedSubAppResource", + "Resource", + "ResourceRoute", + "StaticResource", + "UrlDispatcher", + "UrlMappingMatchInfo", + "View", + # web_ws + "WebSocketReady", + "WebSocketResponse", + "WSMsgType", + # web + "run_app", +) + + +if TYPE_CHECKING: + from ssl import SSLContext +else: + try: + from ssl import SSLContext + except ImportError: # pragma: no cover + SSLContext = object # type: ignore[misc,assignment] + +# Only display warning when using -Wdefault, -We, -X dev or similar. +warnings.filterwarnings("ignore", category=NotAppKeyWarning, append=True) + +HostSequence = TypingIterable[str] + + +async def _run_app( + app: Union[Application, Awaitable[Application]], + *, + host: Optional[Union[str, HostSequence]] = None, + port: Optional[int] = None, + path: Union[PathLike, TypingIterable[PathLike], None] = None, + sock: Optional[Union[socket.socket, TypingIterable[socket.socket]]] = None, + ssl_context: Optional[SSLContext] = None, + print: Optional[Callable[..., None]] = print, + backlog: int = 128, + reuse_address: Optional[bool] = None, + reuse_port: Optional[bool] = None, + **kwargs: Any, # TODO(PY311): Use Unpack +) -> None: + # An internal function to actually do all dirty job for application running + if asyncio.iscoroutine(app): + app = await app + + app = cast(Application, app) + + runner = AppRunner(app, **kwargs) + + await runner.setup() + + sites: List[BaseSite] = [] + + try: + if host is not None: + if isinstance(host, str): + sites.append( + TCPSite( + runner, + host, + port, + ssl_context=ssl_context, + backlog=backlog, + reuse_address=reuse_address, + reuse_port=reuse_port, + ) + ) + else: + for h in host: + sites.append( + TCPSite( + runner, + h, + port, + ssl_context=ssl_context, + backlog=backlog, + reuse_address=reuse_address, + reuse_port=reuse_port, + ) + ) + elif path is None and sock is None or port is not None: + sites.append( + TCPSite( + runner, + port=port, + ssl_context=ssl_context, + backlog=backlog, + reuse_address=reuse_address, + reuse_port=reuse_port, + ) + ) + + if path is not None: + if isinstance(path, (str, os.PathLike)): + sites.append( + UnixSite( + runner, + path, + ssl_context=ssl_context, + backlog=backlog, + ) + ) + else: + for p in path: + sites.append( + UnixSite( + runner, + p, + ssl_context=ssl_context, + backlog=backlog, + ) + ) + + if sock is not None: + if not isinstance(sock, Iterable): + sites.append( + SockSite( + runner, + sock, + ssl_context=ssl_context, + backlog=backlog, + ) + ) + else: + for s in sock: + sites.append( + SockSite( + runner, + s, + ssl_context=ssl_context, + backlog=backlog, + ) + ) + for site in sites: + await site.start() + + if print: # pragma: no branch + names = sorted(str(s.name) for s in runner.sites) + print( + "======== Running on {} ========\n" + "(Press CTRL+C to quit)".format(", ".join(names)) + ) + + # sleep forever by 1 hour intervals, + while True: + await asyncio.sleep(3600) + finally: + await runner.cleanup() + + +def _cancel_tasks( + to_cancel: Set["asyncio.Task[Any]"], loop: asyncio.AbstractEventLoop +) -> None: + if not to_cancel: + return + + for task in to_cancel: + task.cancel() + + loop.run_until_complete(asyncio.gather(*to_cancel, return_exceptions=True)) + + for task in to_cancel: + if task.cancelled(): + continue + if task.exception() is not None: + loop.call_exception_handler( + { + "message": "unhandled exception during asyncio.run() shutdown", + "exception": task.exception(), + "task": task, + } + ) + + +def run_app( + app: Union[Application, Awaitable[Application]], + *, + host: Optional[Union[str, HostSequence]] = None, + port: Optional[int] = None, + path: Union[PathLike, TypingIterable[PathLike], None] = None, + sock: Optional[Union[socket.socket, TypingIterable[socket.socket]]] = None, + shutdown_timeout: float = 60.0, + keepalive_timeout: float = 75.0, + ssl_context: Optional[SSLContext] = None, + print: Optional[Callable[..., None]] = print, + backlog: int = 128, + access_log_class: Type[AbstractAccessLogger] = AccessLogger, + access_log_format: str = AccessLogger.LOG_FORMAT, + access_log: Optional[logging.Logger] = access_logger, + handle_signals: bool = True, + reuse_address: Optional[bool] = None, + reuse_port: Optional[bool] = None, + handler_cancellation: bool = False, + loop: Optional[asyncio.AbstractEventLoop] = None, + **kwargs: Any, +) -> None: + """Run an app locally""" + if loop is None: + loop = asyncio.new_event_loop() + + # Configure if and only if in debugging mode and using the default logger + if loop.get_debug() and access_log and access_log.name == "aiohttp.access": + if access_log.level == logging.NOTSET: + access_log.setLevel(logging.DEBUG) + if not access_log.hasHandlers(): + access_log.addHandler(logging.StreamHandler()) + + main_task = loop.create_task( + _run_app( + app, + host=host, + port=port, + path=path, + sock=sock, + shutdown_timeout=shutdown_timeout, + keepalive_timeout=keepalive_timeout, + ssl_context=ssl_context, + print=print, + backlog=backlog, + access_log_class=access_log_class, + access_log_format=access_log_format, + access_log=access_log, + handle_signals=handle_signals, + reuse_address=reuse_address, + reuse_port=reuse_port, + handler_cancellation=handler_cancellation, + **kwargs, + ) + ) + + try: + asyncio.set_event_loop(loop) + loop.run_until_complete(main_task) + except (GracefulExit, KeyboardInterrupt): # pragma: no cover + pass + finally: + try: + main_task.cancel() + with suppress(asyncio.CancelledError): + loop.run_until_complete(main_task) + finally: + _cancel_tasks(asyncio.all_tasks(loop), loop) + loop.run_until_complete(loop.shutdown_asyncgens()) + loop.close() + + +def main(argv: List[str]) -> None: + arg_parser = ArgumentParser( + description="aiohttp.web Application server", prog="aiohttp.web" + ) + arg_parser.add_argument( + "entry_func", + help=( + "Callable returning the `aiohttp.web.Application` instance to " + "run. Should be specified in the 'module:function' syntax." + ), + metavar="entry-func", + ) + arg_parser.add_argument( + "-H", + "--hostname", + help="TCP/IP hostname to serve on (default: localhost)", + default=None, + ) + arg_parser.add_argument( + "-P", + "--port", + help="TCP/IP port to serve on (default: %(default)r)", + type=int, + default=8080, + ) + arg_parser.add_argument( + "-U", + "--path", + help="Unix file system path to serve on. Can be combined with hostname " + "to serve on both Unix and TCP.", + ) + args, extra_argv = arg_parser.parse_known_args(argv) + + # Import logic + mod_str, _, func_str = args.entry_func.partition(":") + if not func_str or not mod_str: + arg_parser.error("'entry-func' not in 'module:function' syntax") + if mod_str.startswith("."): + arg_parser.error("relative module names not supported") + try: + module = import_module(mod_str) + except ImportError as ex: + arg_parser.error(f"unable to import {mod_str}: {ex}") + try: + func = getattr(module, func_str) + except AttributeError: + arg_parser.error(f"module {mod_str!r} has no attribute {func_str!r}") + + # Compatibility logic + if args.path is not None and not hasattr(socket, "AF_UNIX"): + arg_parser.error( + "file system paths not supported by your operating environment" + ) + + logging.basicConfig(level=logging.DEBUG) + + if args.path and args.hostname is None: + host = port = None + else: + host = args.hostname or "localhost" + port = args.port + + app = func(extra_argv) + run_app(app, host=host, port=port, path=args.path) + arg_parser.exit(message="Stopped\n") + + +if __name__ == "__main__": # pragma: no branch + main(sys.argv[1:]) # pragma: no cover diff --git a/env/lib/python3.12/site-packages/aiohttp/web_app.py b/env/lib/python3.12/site-packages/aiohttp/web_app.py new file mode 100644 index 0000000..619c008 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_app.py @@ -0,0 +1,620 @@ +import asyncio +import logging +import warnings +from functools import lru_cache, partial, update_wrapper +from typing import ( + TYPE_CHECKING, + Any, + AsyncIterator, + Awaitable, + Callable, + Dict, + Iterable, + Iterator, + List, + Mapping, + MutableMapping, + Optional, + Sequence, + Tuple, + Type, + TypeVar, + Union, + cast, + overload, +) + +from aiosignal import Signal +from frozenlist import FrozenList + +from . import hdrs +from .abc import ( + AbstractAccessLogger, + AbstractMatchInfo, + AbstractRouter, + AbstractStreamWriter, +) +from .helpers import DEBUG, AppKey +from .http_parser import RawRequestMessage +from .log import web_logger +from .streams import StreamReader +from .typedefs import Handler, Middleware +from .web_exceptions import NotAppKeyWarning +from .web_log import AccessLogger +from .web_middlewares import _fix_request_current_app +from .web_protocol import RequestHandler +from .web_request import Request +from .web_response import StreamResponse +from .web_routedef import AbstractRouteDef +from .web_server import Server +from .web_urldispatcher import ( + AbstractResource, + AbstractRoute, + Domain, + MaskDomain, + MatchedSubAppResource, + PrefixedSubAppResource, + SystemRoute, + UrlDispatcher, +) + +__all__ = ("Application", "CleanupError") + + +if TYPE_CHECKING: + _AppSignal = Signal["Application"] + _RespPrepareSignal = Signal[Request, StreamResponse] + _Middlewares = FrozenList[Middleware] + _MiddlewaresHandlers = Optional[Sequence[Tuple[Middleware, bool]]] + _Subapps = List["Application"] +else: + # No type checker mode, skip types + _AppSignal = Signal + _RespPrepareSignal = Signal + _Middlewares = FrozenList + _MiddlewaresHandlers = Optional[Sequence] + _Subapps = List + +_T = TypeVar("_T") +_U = TypeVar("_U") +_Resource = TypeVar("_Resource", bound=AbstractResource) + + +def _build_middlewares( + handler: Handler, apps: Tuple["Application", ...] +) -> Callable[[Request], Awaitable[StreamResponse]]: + """Apply middlewares to handler.""" + for app in apps[::-1]: + for m, _ in app._middlewares_handlers: # type: ignore[union-attr] + handler = update_wrapper(partial(m, handler=handler), handler) + return handler + + +_cached_build_middleware = lru_cache(maxsize=1024)(_build_middlewares) + + +class Application(MutableMapping[Union[str, AppKey[Any]], Any]): + ATTRS = frozenset( + [ + "logger", + "_debug", + "_router", + "_loop", + "_handler_args", + "_middlewares", + "_middlewares_handlers", + "_has_legacy_middlewares", + "_run_middlewares", + "_state", + "_frozen", + "_pre_frozen", + "_subapps", + "_on_response_prepare", + "_on_startup", + "_on_shutdown", + "_on_cleanup", + "_client_max_size", + "_cleanup_ctx", + ] + ) + + def __init__( + self, + *, + logger: logging.Logger = web_logger, + router: Optional[UrlDispatcher] = None, + middlewares: Iterable[Middleware] = (), + handler_args: Optional[Mapping[str, Any]] = None, + client_max_size: int = 1024**2, + loop: Optional[asyncio.AbstractEventLoop] = None, + debug: Any = ..., # mypy doesn't support ellipsis + ) -> None: + if router is None: + router = UrlDispatcher() + else: + warnings.warn( + "router argument is deprecated", DeprecationWarning, stacklevel=2 + ) + assert isinstance(router, AbstractRouter), router + + if loop is not None: + warnings.warn( + "loop argument is deprecated", DeprecationWarning, stacklevel=2 + ) + + if debug is not ...: + warnings.warn( + "debug argument is deprecated", DeprecationWarning, stacklevel=2 + ) + self._debug = debug + self._router: UrlDispatcher = router + self._loop = loop + self._handler_args = handler_args + self.logger = logger + + self._middlewares: _Middlewares = FrozenList(middlewares) + + # initialized on freezing + self._middlewares_handlers: _MiddlewaresHandlers = None + # initialized on freezing + self._run_middlewares: Optional[bool] = None + self._has_legacy_middlewares: bool = True + + self._state: Dict[Union[AppKey[Any], str], object] = {} + self._frozen = False + self._pre_frozen = False + self._subapps: _Subapps = [] + + self._on_response_prepare: _RespPrepareSignal = Signal(self) + self._on_startup: _AppSignal = Signal(self) + self._on_shutdown: _AppSignal = Signal(self) + self._on_cleanup: _AppSignal = Signal(self) + self._cleanup_ctx = CleanupContext() + self._on_startup.append(self._cleanup_ctx._on_startup) + self._on_cleanup.append(self._cleanup_ctx._on_cleanup) + self._client_max_size = client_max_size + + def __init_subclass__(cls: Type["Application"]) -> None: + warnings.warn( + "Inheritance class {} from web.Application " + "is discouraged".format(cls.__name__), + DeprecationWarning, + stacklevel=3, + ) + + if DEBUG: # pragma: no cover + + def __setattr__(self, name: str, val: Any) -> None: + if name not in self.ATTRS: + warnings.warn( + "Setting custom web.Application.{} attribute " + "is discouraged".format(name), + DeprecationWarning, + stacklevel=2, + ) + super().__setattr__(name, val) + + # MutableMapping API + + def __eq__(self, other: object) -> bool: + return self is other + + @overload # type: ignore[override] + def __getitem__(self, key: AppKey[_T]) -> _T: ... + + @overload + def __getitem__(self, key: str) -> Any: ... + + def __getitem__(self, key: Union[str, AppKey[_T]]) -> Any: + return self._state[key] + + def _check_frozen(self) -> None: + if self._frozen: + warnings.warn( + "Changing state of started or joined application is deprecated", + DeprecationWarning, + stacklevel=3, + ) + + @overload # type: ignore[override] + def __setitem__(self, key: AppKey[_T], value: _T) -> None: ... + + @overload + def __setitem__(self, key: str, value: Any) -> None: ... + + def __setitem__(self, key: Union[str, AppKey[_T]], value: Any) -> None: + self._check_frozen() + if not isinstance(key, AppKey): + warnings.warn( + "It is recommended to use web.AppKey instances for keys.\n" + + "https://docs.aiohttp.org/en/stable/web_advanced.html" + + "#application-s-config", + category=NotAppKeyWarning, + stacklevel=2, + ) + self._state[key] = value + + def __delitem__(self, key: Union[str, AppKey[_T]]) -> None: + self._check_frozen() + del self._state[key] + + def __len__(self) -> int: + return len(self._state) + + def __iter__(self) -> Iterator[Union[str, AppKey[Any]]]: + return iter(self._state) + + def __hash__(self) -> int: + return id(self) + + @overload # type: ignore[override] + def get(self, key: AppKey[_T], default: None = ...) -> Optional[_T]: ... + + @overload + def get(self, key: AppKey[_T], default: _U) -> Union[_T, _U]: ... + + @overload + def get(self, key: str, default: Any = ...) -> Any: ... + + def get(self, key: Union[str, AppKey[_T]], default: Any = None) -> Any: + return self._state.get(key, default) + + ######## + @property + def loop(self) -> asyncio.AbstractEventLoop: + # Technically the loop can be None + # but we mask it by explicit type cast + # to provide more convenient type annotation + warnings.warn("loop property is deprecated", DeprecationWarning, stacklevel=2) + return cast(asyncio.AbstractEventLoop, self._loop) + + def _set_loop(self, loop: Optional[asyncio.AbstractEventLoop]) -> None: + if loop is None: + loop = asyncio.get_event_loop() + if self._loop is not None and self._loop is not loop: + raise RuntimeError( + "web.Application instance initialized with different loop" + ) + + self._loop = loop + + # set loop debug + if self._debug is ...: + self._debug = loop.get_debug() + + # set loop to sub applications + for subapp in self._subapps: + subapp._set_loop(loop) + + @property + def pre_frozen(self) -> bool: + return self._pre_frozen + + def pre_freeze(self) -> None: + if self._pre_frozen: + return + + self._pre_frozen = True + self._middlewares.freeze() + self._router.freeze() + self._on_response_prepare.freeze() + self._cleanup_ctx.freeze() + self._on_startup.freeze() + self._on_shutdown.freeze() + self._on_cleanup.freeze() + self._middlewares_handlers = tuple(self._prepare_middleware()) + self._has_legacy_middlewares = any( + not new_style for _, new_style in self._middlewares_handlers + ) + + # If current app and any subapp do not have middlewares avoid run all + # of the code footprint that it implies, which have a middleware + # hardcoded per app that sets up the current_app attribute. If no + # middlewares are configured the handler will receive the proper + # current_app without needing all of this code. + self._run_middlewares = True if self.middlewares else False + + for subapp in self._subapps: + subapp.pre_freeze() + self._run_middlewares = self._run_middlewares or subapp._run_middlewares + + @property + def frozen(self) -> bool: + return self._frozen + + def freeze(self) -> None: + if self._frozen: + return + + self.pre_freeze() + self._frozen = True + for subapp in self._subapps: + subapp.freeze() + + @property + def debug(self) -> bool: + warnings.warn("debug property is deprecated", DeprecationWarning, stacklevel=2) + return self._debug # type: ignore[no-any-return] + + def _reg_subapp_signals(self, subapp: "Application") -> None: + def reg_handler(signame: str) -> None: + subsig = getattr(subapp, signame) + + async def handler(app: "Application") -> None: + await subsig.send(subapp) + + appsig = getattr(self, signame) + appsig.append(handler) + + reg_handler("on_startup") + reg_handler("on_shutdown") + reg_handler("on_cleanup") + + def add_subapp(self, prefix: str, subapp: "Application") -> PrefixedSubAppResource: + if not isinstance(prefix, str): + raise TypeError("Prefix must be str") + prefix = prefix.rstrip("/") + if not prefix: + raise ValueError("Prefix cannot be empty") + factory = partial(PrefixedSubAppResource, prefix, subapp) + return self._add_subapp(factory, subapp) + + def _add_subapp( + self, resource_factory: Callable[[], _Resource], subapp: "Application" + ) -> _Resource: + if self.frozen: + raise RuntimeError("Cannot add sub application to frozen application") + if subapp.frozen: + raise RuntimeError("Cannot add frozen application") + resource = resource_factory() + self.router.register_resource(resource) + self._reg_subapp_signals(subapp) + self._subapps.append(subapp) + subapp.pre_freeze() + if self._loop is not None: + subapp._set_loop(self._loop) + return resource + + def add_domain(self, domain: str, subapp: "Application") -> MatchedSubAppResource: + if not isinstance(domain, str): + raise TypeError("Domain must be str") + elif "*" in domain: + rule: Domain = MaskDomain(domain) + else: + rule = Domain(domain) + factory = partial(MatchedSubAppResource, rule, subapp) + return self._add_subapp(factory, subapp) + + def add_routes(self, routes: Iterable[AbstractRouteDef]) -> List[AbstractRoute]: + return self.router.add_routes(routes) + + @property + def on_response_prepare(self) -> _RespPrepareSignal: + return self._on_response_prepare + + @property + def on_startup(self) -> _AppSignal: + return self._on_startup + + @property + def on_shutdown(self) -> _AppSignal: + return self._on_shutdown + + @property + def on_cleanup(self) -> _AppSignal: + return self._on_cleanup + + @property + def cleanup_ctx(self) -> "CleanupContext": + return self._cleanup_ctx + + @property + def router(self) -> UrlDispatcher: + return self._router + + @property + def middlewares(self) -> _Middlewares: + return self._middlewares + + def _make_handler( + self, + *, + loop: Optional[asyncio.AbstractEventLoop] = None, + access_log_class: Type[AbstractAccessLogger] = AccessLogger, + **kwargs: Any, + ) -> Server: + + if not issubclass(access_log_class, AbstractAccessLogger): + raise TypeError( + "access_log_class must be subclass of " + "aiohttp.abc.AbstractAccessLogger, got {}".format(access_log_class) + ) + + self._set_loop(loop) + self.freeze() + + kwargs["debug"] = self._debug + kwargs["access_log_class"] = access_log_class + if self._handler_args: + for k, v in self._handler_args.items(): + kwargs[k] = v + + return Server( + self._handle, # type: ignore[arg-type] + request_factory=self._make_request, + loop=self._loop, + **kwargs, + ) + + def make_handler( + self, + *, + loop: Optional[asyncio.AbstractEventLoop] = None, + access_log_class: Type[AbstractAccessLogger] = AccessLogger, + **kwargs: Any, + ) -> Server: + + warnings.warn( + "Application.make_handler(...) is deprecated, use AppRunner API instead", + DeprecationWarning, + stacklevel=2, + ) + + return self._make_handler( + loop=loop, access_log_class=access_log_class, **kwargs + ) + + async def startup(self) -> None: + """Causes on_startup signal + + Should be called in the event loop along with the request handler. + """ + await self.on_startup.send(self) + + async def shutdown(self) -> None: + """Causes on_shutdown signal + + Should be called before cleanup() + """ + await self.on_shutdown.send(self) + + async def cleanup(self) -> None: + """Causes on_cleanup signal + + Should be called after shutdown() + """ + if self.on_cleanup.frozen: + await self.on_cleanup.send(self) + else: + # If an exception occurs in startup, ensure cleanup contexts are completed. + await self._cleanup_ctx._on_cleanup(self) + + def _make_request( + self, + message: RawRequestMessage, + payload: StreamReader, + protocol: RequestHandler, + writer: AbstractStreamWriter, + task: "asyncio.Task[None]", + _cls: Type[Request] = Request, + ) -> Request: + if TYPE_CHECKING: + assert self._loop is not None + return _cls( + message, + payload, + protocol, + writer, + task, + self._loop, + client_max_size=self._client_max_size, + ) + + def _prepare_middleware(self) -> Iterator[Tuple[Middleware, bool]]: + for m in reversed(self._middlewares): + if getattr(m, "__middleware_version__", None) == 1: + yield m, True + else: + warnings.warn( + f'old-style middleware "{m!r}" deprecated, see #2252', + DeprecationWarning, + stacklevel=2, + ) + yield m, False + + yield _fix_request_current_app(self), True + + async def _handle(self, request: Request) -> StreamResponse: + loop = asyncio.get_event_loop() + debug = loop.get_debug() + match_info = await self._router.resolve(request) + if debug: # pragma: no cover + if not isinstance(match_info, AbstractMatchInfo): + raise TypeError( + "match_info should be AbstractMatchInfo " + "instance, not {!r}".format(match_info) + ) + match_info.add_app(self) + + match_info.freeze() + + request._match_info = match_info + + if request.headers.get(hdrs.EXPECT): + resp = await match_info.expect_handler(request) + await request.writer.drain() + if resp is not None: + return resp + + handler = match_info.handler + + if self._run_middlewares: + # If its a SystemRoute, don't cache building the middlewares since + # they are constructed for every MatchInfoError as a new handler + # is made each time. + if not self._has_legacy_middlewares and not isinstance( + match_info.route, SystemRoute + ): + handler = _cached_build_middleware(handler, match_info.apps) + else: + for app in match_info.apps[::-1]: + for m, new_style in app._middlewares_handlers: # type: ignore[union-attr] + if new_style: + handler = update_wrapper( + partial(m, handler=handler), handler + ) + else: + handler = await m(app, handler) # type: ignore[arg-type,assignment] + + return await handler(request) + + def __call__(self) -> "Application": + """gunicorn compatibility""" + return self + + def __repr__(self) -> str: + return f"" + + def __bool__(self) -> bool: + return True + + +class CleanupError(RuntimeError): + @property + def exceptions(self) -> List[BaseException]: + return cast(List[BaseException], self.args[1]) + + +if TYPE_CHECKING: + _CleanupContextBase = FrozenList[Callable[[Application], AsyncIterator[None]]] +else: + _CleanupContextBase = FrozenList + + +class CleanupContext(_CleanupContextBase): + def __init__(self) -> None: + super().__init__() + self._exits: List[AsyncIterator[None]] = [] + + async def _on_startup(self, app: Application) -> None: + for cb in self: + it = cb(app).__aiter__() + await it.__anext__() + self._exits.append(it) + + async def _on_cleanup(self, app: Application) -> None: + errors = [] + for it in reversed(self._exits): + try: + await it.__anext__() + except StopAsyncIteration: + pass + except (Exception, asyncio.CancelledError) as exc: + errors.append(exc) + else: + errors.append(RuntimeError(f"{it!r} has more than one 'yield'")) + if errors: + if len(errors) == 1: + raise errors[0] + else: + raise CleanupError("Multiple errors on cleanup stage", errors) diff --git a/env/lib/python3.12/site-packages/aiohttp/web_exceptions.py b/env/lib/python3.12/site-packages/aiohttp/web_exceptions.py new file mode 100644 index 0000000..ee2c1e7 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_exceptions.py @@ -0,0 +1,452 @@ +import warnings +from typing import Any, Dict, Iterable, List, Optional, Set # noqa + +from yarl import URL + +from .typedefs import LooseHeaders, StrOrURL +from .web_response import Response + +__all__ = ( + "HTTPException", + "HTTPError", + "HTTPRedirection", + "HTTPSuccessful", + "HTTPOk", + "HTTPCreated", + "HTTPAccepted", + "HTTPNonAuthoritativeInformation", + "HTTPNoContent", + "HTTPResetContent", + "HTTPPartialContent", + "HTTPMove", + "HTTPMultipleChoices", + "HTTPMovedPermanently", + "HTTPFound", + "HTTPSeeOther", + "HTTPNotModified", + "HTTPUseProxy", + "HTTPTemporaryRedirect", + "HTTPPermanentRedirect", + "HTTPClientError", + "HTTPBadRequest", + "HTTPUnauthorized", + "HTTPPaymentRequired", + "HTTPForbidden", + "HTTPNotFound", + "HTTPMethodNotAllowed", + "HTTPNotAcceptable", + "HTTPProxyAuthenticationRequired", + "HTTPRequestTimeout", + "HTTPConflict", + "HTTPGone", + "HTTPLengthRequired", + "HTTPPreconditionFailed", + "HTTPRequestEntityTooLarge", + "HTTPRequestURITooLong", + "HTTPUnsupportedMediaType", + "HTTPRequestRangeNotSatisfiable", + "HTTPExpectationFailed", + "HTTPMisdirectedRequest", + "HTTPUnprocessableEntity", + "HTTPFailedDependency", + "HTTPUpgradeRequired", + "HTTPPreconditionRequired", + "HTTPTooManyRequests", + "HTTPRequestHeaderFieldsTooLarge", + "HTTPUnavailableForLegalReasons", + "HTTPServerError", + "HTTPInternalServerError", + "HTTPNotImplemented", + "HTTPBadGateway", + "HTTPServiceUnavailable", + "HTTPGatewayTimeout", + "HTTPVersionNotSupported", + "HTTPVariantAlsoNegotiates", + "HTTPInsufficientStorage", + "HTTPNotExtended", + "HTTPNetworkAuthenticationRequired", +) + + +class NotAppKeyWarning(UserWarning): + """Warning when not using AppKey in Application.""" + + +############################################################ +# HTTP Exceptions +############################################################ + + +class HTTPException(Response, Exception): + + # You should set in subclasses: + # status = 200 + + status_code = -1 + empty_body = False + + __http_exception__ = True + + def __init__( + self, + *, + headers: Optional[LooseHeaders] = None, + reason: Optional[str] = None, + body: Any = None, + text: Optional[str] = None, + content_type: Optional[str] = None, + ) -> None: + if body is not None: + warnings.warn( + "body argument is deprecated for http web exceptions", + DeprecationWarning, + ) + Response.__init__( + self, + status=self.status_code, + headers=headers, + reason=reason, + body=body, + text=text, + content_type=content_type, + ) + Exception.__init__(self, self.reason) + if self.body is None and not self.empty_body: + self.text = f"{self.status}: {self.reason}" + + def __bool__(self) -> bool: + return True + + +class HTTPError(HTTPException): + """Base class for exceptions with status codes in the 400s and 500s.""" + + +class HTTPRedirection(HTTPException): + """Base class for exceptions with status codes in the 300s.""" + + +class HTTPSuccessful(HTTPException): + """Base class for exceptions with status codes in the 200s.""" + + +class HTTPOk(HTTPSuccessful): + status_code = 200 + + +class HTTPCreated(HTTPSuccessful): + status_code = 201 + + +class HTTPAccepted(HTTPSuccessful): + status_code = 202 + + +class HTTPNonAuthoritativeInformation(HTTPSuccessful): + status_code = 203 + + +class HTTPNoContent(HTTPSuccessful): + status_code = 204 + empty_body = True + + +class HTTPResetContent(HTTPSuccessful): + status_code = 205 + empty_body = True + + +class HTTPPartialContent(HTTPSuccessful): + status_code = 206 + + +############################################################ +# 3xx redirection +############################################################ + + +class HTTPMove(HTTPRedirection): + def __init__( + self, + location: StrOrURL, + *, + headers: Optional[LooseHeaders] = None, + reason: Optional[str] = None, + body: Any = None, + text: Optional[str] = None, + content_type: Optional[str] = None, + ) -> None: + if not location: + raise ValueError("HTTP redirects need a location to redirect to.") + super().__init__( + headers=headers, + reason=reason, + body=body, + text=text, + content_type=content_type, + ) + self.headers["Location"] = str(URL(location)) + self.location = location + + +class HTTPMultipleChoices(HTTPMove): + status_code = 300 + + +class HTTPMovedPermanently(HTTPMove): + status_code = 301 + + +class HTTPFound(HTTPMove): + status_code = 302 + + +# This one is safe after a POST (the redirected location will be +# retrieved with GET): +class HTTPSeeOther(HTTPMove): + status_code = 303 + + +class HTTPNotModified(HTTPRedirection): + # FIXME: this should include a date or etag header + status_code = 304 + empty_body = True + + +class HTTPUseProxy(HTTPMove): + # Not a move, but looks a little like one + status_code = 305 + + +class HTTPTemporaryRedirect(HTTPMove): + status_code = 307 + + +class HTTPPermanentRedirect(HTTPMove): + status_code = 308 + + +############################################################ +# 4xx client error +############################################################ + + +class HTTPClientError(HTTPError): + pass + + +class HTTPBadRequest(HTTPClientError): + status_code = 400 + + +class HTTPUnauthorized(HTTPClientError): + status_code = 401 + + +class HTTPPaymentRequired(HTTPClientError): + status_code = 402 + + +class HTTPForbidden(HTTPClientError): + status_code = 403 + + +class HTTPNotFound(HTTPClientError): + status_code = 404 + + +class HTTPMethodNotAllowed(HTTPClientError): + status_code = 405 + + def __init__( + self, + method: str, + allowed_methods: Iterable[str], + *, + headers: Optional[LooseHeaders] = None, + reason: Optional[str] = None, + body: Any = None, + text: Optional[str] = None, + content_type: Optional[str] = None, + ) -> None: + allow = ",".join(sorted(allowed_methods)) + super().__init__( + headers=headers, + reason=reason, + body=body, + text=text, + content_type=content_type, + ) + self.headers["Allow"] = allow + self.allowed_methods: Set[str] = set(allowed_methods) + self.method = method.upper() + + +class HTTPNotAcceptable(HTTPClientError): + status_code = 406 + + +class HTTPProxyAuthenticationRequired(HTTPClientError): + status_code = 407 + + +class HTTPRequestTimeout(HTTPClientError): + status_code = 408 + + +class HTTPConflict(HTTPClientError): + status_code = 409 + + +class HTTPGone(HTTPClientError): + status_code = 410 + + +class HTTPLengthRequired(HTTPClientError): + status_code = 411 + + +class HTTPPreconditionFailed(HTTPClientError): + status_code = 412 + + +class HTTPRequestEntityTooLarge(HTTPClientError): + status_code = 413 + + def __init__(self, max_size: float, actual_size: float, **kwargs: Any) -> None: + kwargs.setdefault( + "text", + "Maximum request body size {} exceeded, " + "actual body size {}".format(max_size, actual_size), + ) + super().__init__(**kwargs) + + +class HTTPRequestURITooLong(HTTPClientError): + status_code = 414 + + +class HTTPUnsupportedMediaType(HTTPClientError): + status_code = 415 + + +class HTTPRequestRangeNotSatisfiable(HTTPClientError): + status_code = 416 + + +class HTTPExpectationFailed(HTTPClientError): + status_code = 417 + + +class HTTPMisdirectedRequest(HTTPClientError): + status_code = 421 + + +class HTTPUnprocessableEntity(HTTPClientError): + status_code = 422 + + +class HTTPFailedDependency(HTTPClientError): + status_code = 424 + + +class HTTPUpgradeRequired(HTTPClientError): + status_code = 426 + + +class HTTPPreconditionRequired(HTTPClientError): + status_code = 428 + + +class HTTPTooManyRequests(HTTPClientError): + status_code = 429 + + +class HTTPRequestHeaderFieldsTooLarge(HTTPClientError): + status_code = 431 + + +class HTTPUnavailableForLegalReasons(HTTPClientError): + status_code = 451 + + def __init__( + self, + link: Optional[StrOrURL], + *, + headers: Optional[LooseHeaders] = None, + reason: Optional[str] = None, + body: Any = None, + text: Optional[str] = None, + content_type: Optional[str] = None, + ) -> None: + super().__init__( + headers=headers, + reason=reason, + body=body, + text=text, + content_type=content_type, + ) + self._link = None + if link: + self._link = URL(link) + self.headers["Link"] = f'<{str(self._link)}>; rel="blocked-by"' + + @property + def link(self) -> Optional[URL]: + return self._link + + +############################################################ +# 5xx Server Error +############################################################ +# Response status codes beginning with the digit "5" indicate cases in +# which the server is aware that it has erred or is incapable of +# performing the request. Except when responding to a HEAD request, the +# server SHOULD include an entity containing an explanation of the error +# situation, and whether it is a temporary or permanent condition. User +# agents SHOULD display any included entity to the user. These response +# codes are applicable to any request method. + + +class HTTPServerError(HTTPError): + pass + + +class HTTPInternalServerError(HTTPServerError): + status_code = 500 + + +class HTTPNotImplemented(HTTPServerError): + status_code = 501 + + +class HTTPBadGateway(HTTPServerError): + status_code = 502 + + +class HTTPServiceUnavailable(HTTPServerError): + status_code = 503 + + +class HTTPGatewayTimeout(HTTPServerError): + status_code = 504 + + +class HTTPVersionNotSupported(HTTPServerError): + status_code = 505 + + +class HTTPVariantAlsoNegotiates(HTTPServerError): + status_code = 506 + + +class HTTPInsufficientStorage(HTTPServerError): + status_code = 507 + + +class HTTPNotExtended(HTTPServerError): + status_code = 510 + + +class HTTPNetworkAuthenticationRequired(HTTPServerError): + status_code = 511 diff --git a/env/lib/python3.12/site-packages/aiohttp/web_fileresponse.py b/env/lib/python3.12/site-packages/aiohttp/web_fileresponse.py new file mode 100644 index 0000000..26484b9 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_fileresponse.py @@ -0,0 +1,418 @@ +import asyncio +import io +import os +import pathlib +import sys +from contextlib import suppress +from enum import Enum, auto +from mimetypes import MimeTypes +from stat import S_ISREG +from types import MappingProxyType +from typing import ( # noqa + IO, + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Final, + Iterator, + List, + Optional, + Set, + Tuple, + Union, + cast, +) + +from . import hdrs +from .abc import AbstractStreamWriter +from .helpers import ETAG_ANY, ETag, must_be_empty_body +from .typedefs import LooseHeaders, PathLike +from .web_exceptions import ( + HTTPForbidden, + HTTPNotFound, + HTTPNotModified, + HTTPPartialContent, + HTTPPreconditionFailed, + HTTPRequestRangeNotSatisfiable, +) +from .web_response import StreamResponse + +__all__ = ("FileResponse",) + +if TYPE_CHECKING: + from .web_request import BaseRequest + + +_T_OnChunkSent = Optional[Callable[[bytes], Awaitable[None]]] + + +NOSENDFILE: Final[bool] = bool(os.environ.get("AIOHTTP_NOSENDFILE")) + +CONTENT_TYPES: Final[MimeTypes] = MimeTypes() + +# File extension to IANA encodings map that will be checked in the order defined. +ENCODING_EXTENSIONS = MappingProxyType( + {ext: CONTENT_TYPES.encodings_map[ext] for ext in (".br", ".gz")} +) + +FALLBACK_CONTENT_TYPE = "application/octet-stream" + +# Provide additional MIME type/extension pairs to be recognized. +# https://en.wikipedia.org/wiki/List_of_archive_formats#Compression_only +ADDITIONAL_CONTENT_TYPES = MappingProxyType( + { + "application/gzip": ".gz", + "application/x-brotli": ".br", + "application/x-bzip2": ".bz2", + "application/x-compress": ".Z", + "application/x-xz": ".xz", + } +) + + +class _FileResponseResult(Enum): + """The result of the file response.""" + + SEND_FILE = auto() # Ie a regular file to send + NOT_ACCEPTABLE = auto() # Ie a socket, or non-regular file + PRE_CONDITION_FAILED = auto() # Ie If-Match or If-None-Match failed + NOT_MODIFIED = auto() # 304 Not Modified + + +# Add custom pairs and clear the encodings map so guess_type ignores them. +CONTENT_TYPES.encodings_map.clear() +for content_type, extension in ADDITIONAL_CONTENT_TYPES.items(): + CONTENT_TYPES.add_type(content_type, extension) + + +_CLOSE_FUTURES: Set[asyncio.Future[None]] = set() + + +class FileResponse(StreamResponse): + """A response object can be used to send files.""" + + def __init__( + self, + path: PathLike, + chunk_size: int = 256 * 1024, + status: int = 200, + reason: Optional[str] = None, + headers: Optional[LooseHeaders] = None, + ) -> None: + super().__init__(status=status, reason=reason, headers=headers) + + self._path = pathlib.Path(path) + self._chunk_size = chunk_size + + def _seek_and_read(self, fobj: IO[Any], offset: int, chunk_size: int) -> bytes: + fobj.seek(offset) + return fobj.read(chunk_size) # type: ignore[no-any-return] + + async def _sendfile_fallback( + self, writer: AbstractStreamWriter, fobj: IO[Any], offset: int, count: int + ) -> AbstractStreamWriter: + # To keep memory usage low,fobj is transferred in chunks + # controlled by the constructor's chunk_size argument. + + chunk_size = self._chunk_size + loop = asyncio.get_event_loop() + chunk = await loop.run_in_executor( + None, self._seek_and_read, fobj, offset, chunk_size + ) + while chunk: + await writer.write(chunk) + count = count - chunk_size + if count <= 0: + break + chunk = await loop.run_in_executor(None, fobj.read, min(chunk_size, count)) + + await writer.drain() + return writer + + async def _sendfile( + self, request: "BaseRequest", fobj: IO[Any], offset: int, count: int + ) -> AbstractStreamWriter: + writer = await super().prepare(request) + assert writer is not None + + if NOSENDFILE or self.compression: + return await self._sendfile_fallback(writer, fobj, offset, count) + + loop = request._loop + transport = request.transport + assert transport is not None + + try: + await loop.sendfile(transport, fobj, offset, count) + except NotImplementedError: + return await self._sendfile_fallback(writer, fobj, offset, count) + + await super().write_eof() + return writer + + @staticmethod + def _etag_match(etag_value: str, etags: Tuple[ETag, ...], *, weak: bool) -> bool: + if len(etags) == 1 and etags[0].value == ETAG_ANY: + return True + return any( + etag.value == etag_value for etag in etags if weak or not etag.is_weak + ) + + async def _not_modified( + self, request: "BaseRequest", etag_value: str, last_modified: float + ) -> Optional[AbstractStreamWriter]: + self.set_status(HTTPNotModified.status_code) + self._length_check = False + self.etag = etag_value + self.last_modified = last_modified + # Delete any Content-Length headers provided by user. HTTP 304 + # should always have empty response body + return await super().prepare(request) + + async def _precondition_failed( + self, request: "BaseRequest" + ) -> Optional[AbstractStreamWriter]: + self.set_status(HTTPPreconditionFailed.status_code) + self.content_length = 0 + return await super().prepare(request) + + def _make_response( + self, request: "BaseRequest", accept_encoding: str + ) -> Tuple[ + _FileResponseResult, Optional[io.BufferedReader], os.stat_result, Optional[str] + ]: + """Return the response result, io object, stat result, and encoding. + + If an uncompressed file is returned, the encoding is set to + :py:data:`None`. + + This method should be called from a thread executor + since it calls os.stat which may block. + """ + file_path, st, file_encoding = self._get_file_path_stat_encoding( + accept_encoding + ) + if not file_path: + return _FileResponseResult.NOT_ACCEPTABLE, None, st, None + + etag_value = f"{st.st_mtime_ns:x}-{st.st_size:x}" + + # https://www.rfc-editor.org/rfc/rfc9110#section-13.1.1-2 + if (ifmatch := request.if_match) is not None and not self._etag_match( + etag_value, ifmatch, weak=False + ): + return _FileResponseResult.PRE_CONDITION_FAILED, None, st, file_encoding + + if ( + (unmodsince := request.if_unmodified_since) is not None + and ifmatch is None + and st.st_mtime > unmodsince.timestamp() + ): + return _FileResponseResult.PRE_CONDITION_FAILED, None, st, file_encoding + + # https://www.rfc-editor.org/rfc/rfc9110#section-13.1.2-2 + if (ifnonematch := request.if_none_match) is not None and self._etag_match( + etag_value, ifnonematch, weak=True + ): + return _FileResponseResult.NOT_MODIFIED, None, st, file_encoding + + if ( + (modsince := request.if_modified_since) is not None + and ifnonematch is None + and st.st_mtime <= modsince.timestamp() + ): + return _FileResponseResult.NOT_MODIFIED, None, st, file_encoding + + fobj = file_path.open("rb") + with suppress(OSError): + # fstat() may not be available on all platforms + # Once we open the file, we want the fstat() to ensure + # the file has not changed between the first stat() + # and the open(). + st = os.stat(fobj.fileno()) + return _FileResponseResult.SEND_FILE, fobj, st, file_encoding + + def _get_file_path_stat_encoding( + self, accept_encoding: str + ) -> Tuple[Optional[pathlib.Path], os.stat_result, Optional[str]]: + file_path = self._path + for file_extension, file_encoding in ENCODING_EXTENSIONS.items(): + if file_encoding not in accept_encoding: + continue + + compressed_path = file_path.with_suffix(file_path.suffix + file_extension) + with suppress(OSError): + # Do not follow symlinks and ignore any non-regular files. + st = compressed_path.lstat() + if S_ISREG(st.st_mode): + return compressed_path, st, file_encoding + + # Fallback to the uncompressed file + st = file_path.stat() + return file_path if S_ISREG(st.st_mode) else None, st, None + + async def prepare(self, request: "BaseRequest") -> Optional[AbstractStreamWriter]: + loop = asyncio.get_running_loop() + # Encoding comparisons should be case-insensitive + # https://www.rfc-editor.org/rfc/rfc9110#section-8.4.1 + accept_encoding = request.headers.get(hdrs.ACCEPT_ENCODING, "").lower() + try: + response_result, fobj, st, file_encoding = await loop.run_in_executor( + None, self._make_response, request, accept_encoding + ) + except PermissionError: + self.set_status(HTTPForbidden.status_code) + return await super().prepare(request) + except OSError: + # Most likely to be FileNotFoundError or OSError for circular + # symlinks in python >= 3.13, so respond with 404. + self.set_status(HTTPNotFound.status_code) + return await super().prepare(request) + + # Forbid special files like sockets, pipes, devices, etc. + if response_result is _FileResponseResult.NOT_ACCEPTABLE: + self.set_status(HTTPForbidden.status_code) + return await super().prepare(request) + + if response_result is _FileResponseResult.PRE_CONDITION_FAILED: + return await self._precondition_failed(request) + + if response_result is _FileResponseResult.NOT_MODIFIED: + etag_value = f"{st.st_mtime_ns:x}-{st.st_size:x}" + last_modified = st.st_mtime + return await self._not_modified(request, etag_value, last_modified) + + assert fobj is not None + try: + return await self._prepare_open_file(request, fobj, st, file_encoding) + finally: + # We do not await here because we do not want to wait + # for the executor to finish before returning the response + # so the connection can begin servicing another request + # as soon as possible. + close_future = loop.run_in_executor(None, fobj.close) + # Hold a strong reference to the future to prevent it from being + # garbage collected before it completes. + _CLOSE_FUTURES.add(close_future) + close_future.add_done_callback(_CLOSE_FUTURES.remove) + + async def _prepare_open_file( + self, + request: "BaseRequest", + fobj: io.BufferedReader, + st: os.stat_result, + file_encoding: Optional[str], + ) -> Optional[AbstractStreamWriter]: + status = self._status + file_size: int = st.st_size + file_mtime: float = st.st_mtime + count: int = file_size + start: Optional[int] = None + + if (ifrange := request.if_range) is None or file_mtime <= ifrange.timestamp(): + # If-Range header check: + # condition = cached date >= last modification date + # return 206 if True else 200. + # if False: + # Range header would not be processed, return 200 + # if True but Range header missing + # return 200 + try: + rng = request.http_range + start = rng.start + end: Optional[int] = rng.stop + except ValueError: + # https://tools.ietf.org/html/rfc7233: + # A server generating a 416 (Range Not Satisfiable) response to + # a byte-range request SHOULD send a Content-Range header field + # with an unsatisfied-range value. + # The complete-length in a 416 response indicates the current + # length of the selected representation. + # + # Will do the same below. Many servers ignore this and do not + # send a Content-Range header with HTTP 416 + self._headers[hdrs.CONTENT_RANGE] = f"bytes */{file_size}" + self.set_status(HTTPRequestRangeNotSatisfiable.status_code) + return await super().prepare(request) + + # If a range request has been made, convert start, end slice + # notation into file pointer offset and count + if start is not None: + if start < 0 and end is None: # return tail of file + start += file_size + if start < 0: + # if Range:bytes=-1000 in request header but file size + # is only 200, there would be trouble without this + start = 0 + count = file_size - start + else: + # rfc7233:If the last-byte-pos value is + # absent, or if the value is greater than or equal to + # the current length of the representation data, + # the byte range is interpreted as the remainder + # of the representation (i.e., the server replaces the + # value of last-byte-pos with a value that is one less than + # the current length of the selected representation). + count = ( + min(end if end is not None else file_size, file_size) - start + ) + + if start >= file_size: + # HTTP 416 should be returned in this case. + # + # According to https://tools.ietf.org/html/rfc7233: + # If a valid byte-range-set includes at least one + # byte-range-spec with a first-byte-pos that is less than + # the current length of the representation, or at least one + # suffix-byte-range-spec with a non-zero suffix-length, + # then the byte-range-set is satisfiable. Otherwise, the + # byte-range-set is unsatisfiable. + self._headers[hdrs.CONTENT_RANGE] = f"bytes */{file_size}" + self.set_status(HTTPRequestRangeNotSatisfiable.status_code) + return await super().prepare(request) + + status = HTTPPartialContent.status_code + # Even though you are sending the whole file, you should still + # return a HTTP 206 for a Range request. + self.set_status(status) + + # If the Content-Type header is not already set, guess it based on the + # extension of the request path. The encoding returned by guess_type + # can be ignored since the map was cleared above. + if hdrs.CONTENT_TYPE not in self._headers: + if sys.version_info >= (3, 13): + guesser = CONTENT_TYPES.guess_file_type + else: + guesser = CONTENT_TYPES.guess_type + self.content_type = guesser(self._path)[0] or FALLBACK_CONTENT_TYPE + + if file_encoding: + self._headers[hdrs.CONTENT_ENCODING] = file_encoding + self._headers[hdrs.VARY] = hdrs.ACCEPT_ENCODING + # Disable compression if we are already sending + # a compressed file since we don't want to double + # compress. + self._compression = False + + self.etag = f"{st.st_mtime_ns:x}-{st.st_size:x}" + self.last_modified = file_mtime + self.content_length = count + + self._headers[hdrs.ACCEPT_RANGES] = "bytes" + + if status == HTTPPartialContent.status_code: + real_start = start + assert real_start is not None + self._headers[hdrs.CONTENT_RANGE] = "bytes {}-{}/{}".format( + real_start, real_start + count - 1, file_size + ) + + # If we are sending 0 bytes calling sendfile() will throw a ValueError + if count == 0 or must_be_empty_body(request.method, status): + return await super().prepare(request) + + # be aware that start could be None or int=0 here. + offset = start or 0 + + return await self._sendfile(request, fobj, offset, count) diff --git a/env/lib/python3.12/site-packages/aiohttp/web_log.py b/env/lib/python3.12/site-packages/aiohttp/web_log.py new file mode 100644 index 0000000..d5ea2be --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_log.py @@ -0,0 +1,216 @@ +import datetime +import functools +import logging +import os +import re +import time as time_mod +from collections import namedtuple +from typing import Any, Callable, Dict, Iterable, List, Tuple # noqa + +from .abc import AbstractAccessLogger +from .web_request import BaseRequest +from .web_response import StreamResponse + +KeyMethod = namedtuple("KeyMethod", "key method") + + +class AccessLogger(AbstractAccessLogger): + """Helper object to log access. + + Usage: + log = logging.getLogger("spam") + log_format = "%a %{User-Agent}i" + access_logger = AccessLogger(log, log_format) + access_logger.log(request, response, time) + + Format: + %% The percent sign + %a Remote IP-address (IP-address of proxy if using reverse proxy) + %t Time when the request was started to process + %P The process ID of the child that serviced the request + %r First line of request + %s Response status code + %b Size of response in bytes, including HTTP headers + %T Time taken to serve the request, in seconds + %Tf Time taken to serve the request, in seconds with floating fraction + in .06f format + %D Time taken to serve the request, in microseconds + %{FOO}i request.headers['FOO'] + %{FOO}o response.headers['FOO'] + %{FOO}e os.environ['FOO'] + + """ + + LOG_FORMAT_MAP = { + "a": "remote_address", + "t": "request_start_time", + "P": "process_id", + "r": "first_request_line", + "s": "response_status", + "b": "response_size", + "T": "request_time", + "Tf": "request_time_frac", + "D": "request_time_micro", + "i": "request_header", + "o": "response_header", + } + + LOG_FORMAT = '%a %t "%r" %s %b "%{Referer}i" "%{User-Agent}i"' + FORMAT_RE = re.compile(r"%(\{([A-Za-z0-9\-_]+)\}([ioe])|[atPrsbOD]|Tf?)") + CLEANUP_RE = re.compile(r"(%[^s])") + _FORMAT_CACHE: Dict[str, Tuple[str, List[KeyMethod]]] = {} + + def __init__(self, logger: logging.Logger, log_format: str = LOG_FORMAT) -> None: + """Initialise the logger. + + logger is a logger object to be used for logging. + log_format is a string with apache compatible log format description. + + """ + super().__init__(logger, log_format=log_format) + + _compiled_format = AccessLogger._FORMAT_CACHE.get(log_format) + if not _compiled_format: + _compiled_format = self.compile_format(log_format) + AccessLogger._FORMAT_CACHE[log_format] = _compiled_format + + self._log_format, self._methods = _compiled_format + + def compile_format(self, log_format: str) -> Tuple[str, List[KeyMethod]]: + """Translate log_format into form usable by modulo formatting + + All known atoms will be replaced with %s + Also methods for formatting of those atoms will be added to + _methods in appropriate order + + For example we have log_format = "%a %t" + This format will be translated to "%s %s" + Also contents of _methods will be + [self._format_a, self._format_t] + These method will be called and results will be passed + to translated string format. + + Each _format_* method receive 'args' which is list of arguments + given to self.log + + Exceptions are _format_e, _format_i and _format_o methods which + also receive key name (by functools.partial) + + """ + # list of (key, method) tuples, we don't use an OrderedDict as users + # can repeat the same key more than once + methods = list() + + for atom in self.FORMAT_RE.findall(log_format): + if atom[1] == "": + format_key1 = self.LOG_FORMAT_MAP[atom[0]] + m = getattr(AccessLogger, "_format_%s" % atom[0]) + key_method = KeyMethod(format_key1, m) + else: + format_key2 = (self.LOG_FORMAT_MAP[atom[2]], atom[1]) + m = getattr(AccessLogger, "_format_%s" % atom[2]) + key_method = KeyMethod(format_key2, functools.partial(m, atom[1])) + + methods.append(key_method) + + log_format = self.FORMAT_RE.sub(r"%s", log_format) + log_format = self.CLEANUP_RE.sub(r"%\1", log_format) + return log_format, methods + + @staticmethod + def _format_i( + key: str, request: BaseRequest, response: StreamResponse, time: float + ) -> str: + if request is None: + return "(no headers)" + + # suboptimal, make istr(key) once + return request.headers.get(key, "-") + + @staticmethod + def _format_o( + key: str, request: BaseRequest, response: StreamResponse, time: float + ) -> str: + # suboptimal, make istr(key) once + return response.headers.get(key, "-") + + @staticmethod + def _format_a(request: BaseRequest, response: StreamResponse, time: float) -> str: + if request is None: + return "-" + ip = request.remote + return ip if ip is not None else "-" + + @staticmethod + def _format_t(request: BaseRequest, response: StreamResponse, time: float) -> str: + tz = datetime.timezone(datetime.timedelta(seconds=-time_mod.timezone)) + now = datetime.datetime.now(tz) + start_time = now - datetime.timedelta(seconds=time) + return start_time.strftime("[%d/%b/%Y:%H:%M:%S %z]") + + @staticmethod + def _format_P(request: BaseRequest, response: StreamResponse, time: float) -> str: + return "<%s>" % os.getpid() + + @staticmethod + def _format_r(request: BaseRequest, response: StreamResponse, time: float) -> str: + if request is None: + return "-" + return "{} {} HTTP/{}.{}".format( + request.method, + request.path_qs, + request.version.major, + request.version.minor, + ) + + @staticmethod + def _format_s(request: BaseRequest, response: StreamResponse, time: float) -> int: + return response.status + + @staticmethod + def _format_b(request: BaseRequest, response: StreamResponse, time: float) -> int: + return response.body_length + + @staticmethod + def _format_T(request: BaseRequest, response: StreamResponse, time: float) -> str: + return str(round(time)) + + @staticmethod + def _format_Tf(request: BaseRequest, response: StreamResponse, time: float) -> str: + return "%06f" % time + + @staticmethod + def _format_D(request: BaseRequest, response: StreamResponse, time: float) -> str: + return str(round(time * 1000000)) + + def _format_line( + self, request: BaseRequest, response: StreamResponse, time: float + ) -> Iterable[Tuple[str, Callable[[BaseRequest, StreamResponse, float], str]]]: + return [(key, method(request, response, time)) for key, method in self._methods] + + @property + def enabled(self) -> bool: + """Check if logger is enabled.""" + # Avoid formatting the log line if it will not be emitted. + return self.logger.isEnabledFor(logging.INFO) + + def log(self, request: BaseRequest, response: StreamResponse, time: float) -> None: + try: + fmt_info = self._format_line(request, response, time) + + values = list() + extra = dict() + for key, value in fmt_info: + values.append(value) + + if key.__class__ is str: + extra[key] = value + else: + k1, k2 = key # type: ignore[misc] + dct = extra.get(k1, {}) # type: ignore[var-annotated,has-type] + dct[k2] = value # type: ignore[index,has-type] + extra[k1] = dct # type: ignore[has-type,assignment] + + self.logger.info(self._log_format % tuple(values), extra=extra) + except Exception: + self.logger.exception("Error in logging") diff --git a/env/lib/python3.12/site-packages/aiohttp/web_middlewares.py b/env/lib/python3.12/site-packages/aiohttp/web_middlewares.py new file mode 100644 index 0000000..2f1f5f5 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_middlewares.py @@ -0,0 +1,121 @@ +import re +from typing import TYPE_CHECKING, Tuple, Type, TypeVar + +from .typedefs import Handler, Middleware +from .web_exceptions import HTTPMove, HTTPPermanentRedirect +from .web_request import Request +from .web_response import StreamResponse +from .web_urldispatcher import SystemRoute + +__all__ = ( + "middleware", + "normalize_path_middleware", +) + +if TYPE_CHECKING: + from .web_app import Application + +_Func = TypeVar("_Func") + + +async def _check_request_resolves(request: Request, path: str) -> Tuple[bool, Request]: + alt_request = request.clone(rel_url=path) + + match_info = await request.app.router.resolve(alt_request) + alt_request._match_info = match_info + + if match_info.http_exception is None: + return True, alt_request + + return False, request + + +def middleware(f: _Func) -> _Func: + f.__middleware_version__ = 1 # type: ignore[attr-defined] + return f + + +def normalize_path_middleware( + *, + append_slash: bool = True, + remove_slash: bool = False, + merge_slashes: bool = True, + redirect_class: Type[HTTPMove] = HTTPPermanentRedirect, +) -> Middleware: + """Factory for producing a middleware that normalizes the path of a request. + + Normalizing means: + - Add or remove a trailing slash to the path. + - Double slashes are replaced by one. + + The middleware returns as soon as it finds a path that resolves + correctly. The order if both merge and append/remove are enabled is + 1) merge slashes + 2) append/remove slash + 3) both merge slashes and append/remove slash. + If the path resolves with at least one of those conditions, it will + redirect to the new path. + + Only one of `append_slash` and `remove_slash` can be enabled. If both + are `True` the factory will raise an assertion error + + If `append_slash` is `True` the middleware will append a slash when + needed. If a resource is defined with trailing slash and the request + comes without it, it will append it automatically. + + If `remove_slash` is `True`, `append_slash` must be `False`. When enabled + the middleware will remove trailing slashes and redirect if the resource + is defined + + If merge_slashes is True, merge multiple consecutive slashes in the + path into one. + """ + correct_configuration = not (append_slash and remove_slash) + assert correct_configuration, "Cannot both remove and append slash" + + @middleware + async def impl(request: Request, handler: Handler) -> StreamResponse: + if isinstance(request.match_info.route, SystemRoute): + paths_to_check = [] + if "?" in request.raw_path: + path, query = request.raw_path.split("?", 1) + query = "?" + query + else: + query = "" + path = request.raw_path + + if merge_slashes: + paths_to_check.append(re.sub("//+", "/", path)) + if append_slash and not request.path.endswith("/"): + paths_to_check.append(path + "/") + if remove_slash and request.path.endswith("/"): + paths_to_check.append(path[:-1]) + if merge_slashes and append_slash: + paths_to_check.append(re.sub("//+", "/", path + "/")) + if merge_slashes and remove_slash: + merged_slashes = re.sub("//+", "/", path) + paths_to_check.append(merged_slashes[:-1]) + + for path in paths_to_check: + path = re.sub("^//+", "/", path) # SECURITY: GHSA-v6wp-4m6f-gcjg + resolves, request = await _check_request_resolves(request, path) + if resolves: + raise redirect_class(request.raw_path + query) + + return await handler(request) + + return impl + + +def _fix_request_current_app(app: "Application") -> Middleware: + @middleware + async def impl(request: Request, handler: Handler) -> StreamResponse: + match_info = request.match_info + prev = match_info.current_app + match_info.current_app = app + try: + return await handler(request) + finally: + match_info.current_app = prev + + return impl diff --git a/env/lib/python3.12/site-packages/aiohttp/web_protocol.py b/env/lib/python3.12/site-packages/aiohttp/web_protocol.py new file mode 100644 index 0000000..1bd344a --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_protocol.py @@ -0,0 +1,792 @@ +import asyncio +import asyncio.streams +import sys +import traceback +import warnings +from collections import deque +from contextlib import suppress +from html import escape as html_escape +from http import HTTPStatus +from logging import Logger +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Deque, + Optional, + Sequence, + Tuple, + Type, + Union, + cast, +) + +import attr +import yarl +from propcache import under_cached_property + +from .abc import AbstractAccessLogger, AbstractStreamWriter +from .base_protocol import BaseProtocol +from .helpers import ceil_timeout +from .http import ( + HttpProcessingError, + HttpRequestParser, + HttpVersion10, + RawRequestMessage, + StreamWriter, +) +from .http_exceptions import BadHttpMethod +from .log import access_logger, server_logger +from .streams import EMPTY_PAYLOAD, StreamReader +from .tcp_helpers import tcp_keepalive +from .web_exceptions import HTTPException, HTTPInternalServerError +from .web_log import AccessLogger +from .web_request import BaseRequest +from .web_response import Response, StreamResponse + +__all__ = ("RequestHandler", "RequestPayloadError", "PayloadAccessError") + +if TYPE_CHECKING: + import ssl + + from .web_server import Server + + +_RequestFactory = Callable[ + [ + RawRequestMessage, + StreamReader, + "RequestHandler", + AbstractStreamWriter, + "asyncio.Task[None]", + ], + BaseRequest, +] + +_RequestHandler = Callable[[BaseRequest], Awaitable[StreamResponse]] + +ERROR = RawRequestMessage( + "UNKNOWN", + "/", + HttpVersion10, + {}, # type: ignore[arg-type] + {}, # type: ignore[arg-type] + True, + None, + False, + False, + yarl.URL("/"), +) + + +class RequestPayloadError(Exception): + """Payload parsing error.""" + + +class PayloadAccessError(Exception): + """Payload was accessed after response was sent.""" + + +_PAYLOAD_ACCESS_ERROR = PayloadAccessError() + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class _ErrInfo: + status: int + exc: BaseException + message: str + + +_MsgType = Tuple[Union[RawRequestMessage, _ErrInfo], StreamReader] + + +class RequestHandler(BaseProtocol): + """HTTP protocol implementation. + + RequestHandler handles incoming HTTP request. It reads request line, + request headers and request payload and calls handle_request() method. + By default it always returns with 404 response. + + RequestHandler handles errors in incoming request, like bad + status line, bad headers or incomplete payload. If any error occurs, + connection gets closed. + + keepalive_timeout -- number of seconds before closing + keep-alive connection + + tcp_keepalive -- TCP keep-alive is on, default is on + + debug -- enable debug mode + + logger -- custom logger object + + access_log_class -- custom class for access_logger + + access_log -- custom logging object + + access_log_format -- access log format string + + loop -- Optional event loop + + max_line_size -- Optional maximum header line size + + max_field_size -- Optional maximum header field size + + max_headers -- Optional maximum header size + + timeout_ceil_threshold -- Optional value to specify + threshold to ceil() timeout + values + + """ + + __slots__ = ( + "_request_count", + "_keepalive", + "_manager", + "_request_handler", + "_request_factory", + "_tcp_keepalive", + "_next_keepalive_close_time", + "_keepalive_handle", + "_keepalive_timeout", + "_lingering_time", + "_messages", + "_message_tail", + "_handler_waiter", + "_waiter", + "_task_handler", + "_upgrade", + "_payload_parser", + "_request_parser", + "_reading_paused", + "logger", + "debug", + "access_log", + "access_logger", + "_close", + "_force_close", + "_current_request", + "_timeout_ceil_threshold", + "_request_in_progress", + "_logging_enabled", + "_cache", + ) + + def __init__( + self, + manager: "Server", + *, + loop: asyncio.AbstractEventLoop, + # Default should be high enough that it's likely longer than a reverse proxy. + keepalive_timeout: float = 3630, + tcp_keepalive: bool = True, + logger: Logger = server_logger, + access_log_class: Type[AbstractAccessLogger] = AccessLogger, + access_log: Logger = access_logger, + access_log_format: str = AccessLogger.LOG_FORMAT, + debug: bool = False, + max_line_size: int = 8190, + max_headers: int = 32768, + max_field_size: int = 8190, + lingering_time: float = 10.0, + read_bufsize: int = 2**16, + auto_decompress: bool = True, + timeout_ceil_threshold: float = 5, + ): + super().__init__(loop) + + # _request_count is the number of requests processed with the same connection. + self._request_count = 0 + self._keepalive = False + self._current_request: Optional[BaseRequest] = None + self._manager: Optional[Server] = manager + self._request_handler: Optional[_RequestHandler] = manager.request_handler + self._request_factory: Optional[_RequestFactory] = manager.request_factory + + self._tcp_keepalive = tcp_keepalive + # placeholder to be replaced on keepalive timeout setup + self._next_keepalive_close_time = 0.0 + self._keepalive_handle: Optional[asyncio.Handle] = None + self._keepalive_timeout = keepalive_timeout + self._lingering_time = float(lingering_time) + + self._messages: Deque[_MsgType] = deque() + self._message_tail = b"" + + self._waiter: Optional[asyncio.Future[None]] = None + self._handler_waiter: Optional[asyncio.Future[None]] = None + self._task_handler: Optional[asyncio.Task[None]] = None + + self._upgrade = False + self._payload_parser: Any = None + self._request_parser: Optional[HttpRequestParser] = HttpRequestParser( + self, + loop, + read_bufsize, + max_line_size=max_line_size, + max_field_size=max_field_size, + max_headers=max_headers, + payload_exception=RequestPayloadError, + auto_decompress=auto_decompress, + ) + + self._timeout_ceil_threshold: float = 5 + try: + self._timeout_ceil_threshold = float(timeout_ceil_threshold) + except (TypeError, ValueError): + pass + + self.logger = logger + self.debug = debug + self.access_log = access_log + if access_log: + self.access_logger: Optional[AbstractAccessLogger] = access_log_class( + access_log, access_log_format + ) + self._logging_enabled = self.access_logger.enabled + else: + self.access_logger = None + self._logging_enabled = False + + self._close = False + self._force_close = False + self._request_in_progress = False + self._cache: dict[str, Any] = {} + + def __repr__(self) -> str: + return "<{} {}>".format( + self.__class__.__name__, + "connected" if self.transport is not None else "disconnected", + ) + + @under_cached_property + def ssl_context(self) -> Optional["ssl.SSLContext"]: + """Return SSLContext if available.""" + return ( + None + if self.transport is None + else self.transport.get_extra_info("sslcontext") + ) + + @under_cached_property + def peername( + self, + ) -> Optional[Union[str, Tuple[str, int, int, int], Tuple[str, int]]]: + """Return peername if available.""" + return ( + None + if self.transport is None + else self.transport.get_extra_info("peername") + ) + + @property + def keepalive_timeout(self) -> float: + return self._keepalive_timeout + + async def shutdown(self, timeout: Optional[float] = 15.0) -> None: + """Do worker process exit preparations. + + We need to clean up everything and stop accepting requests. + It is especially important for keep-alive connections. + """ + self._force_close = True + + if self._keepalive_handle is not None: + self._keepalive_handle.cancel() + + # Wait for graceful handler completion + if self._request_in_progress: + # The future is only created when we are shutting + # down while the handler is still processing a request + # to avoid creating a future for every request. + self._handler_waiter = self._loop.create_future() + try: + async with ceil_timeout(timeout): + await self._handler_waiter + except (asyncio.CancelledError, asyncio.TimeoutError): + self._handler_waiter = None + if ( + sys.version_info >= (3, 11) + and (task := asyncio.current_task()) + and task.cancelling() + ): + raise + # Then cancel handler and wait + try: + async with ceil_timeout(timeout): + if self._current_request is not None: + self._current_request._cancel(asyncio.CancelledError()) + + if self._task_handler is not None and not self._task_handler.done(): + await asyncio.shield(self._task_handler) + except (asyncio.CancelledError, asyncio.TimeoutError): + if ( + sys.version_info >= (3, 11) + and (task := asyncio.current_task()) + and task.cancelling() + ): + raise + + # force-close non-idle handler + if self._task_handler is not None: + self._task_handler.cancel() + + self.force_close() + + def connection_made(self, transport: asyncio.BaseTransport) -> None: + super().connection_made(transport) + + real_transport = cast(asyncio.Transport, transport) + if self._tcp_keepalive: + tcp_keepalive(real_transport) + + assert self._manager is not None + self._manager.connection_made(self, real_transport) + + loop = self._loop + if sys.version_info >= (3, 12): + task = asyncio.Task(self.start(), loop=loop, eager_start=True) + else: + task = loop.create_task(self.start()) + self._task_handler = task + + def connection_lost(self, exc: Optional[BaseException]) -> None: + if self._manager is None: + return + self._manager.connection_lost(self, exc) + + # Grab value before setting _manager to None. + handler_cancellation = self._manager.handler_cancellation + + self.force_close() + super().connection_lost(exc) + self._manager = None + self._request_factory = None + self._request_handler = None + self._request_parser = None + + if self._keepalive_handle is not None: + self._keepalive_handle.cancel() + + if self._current_request is not None: + if exc is None: + exc = ConnectionResetError("Connection lost") + self._current_request._cancel(exc) + + if handler_cancellation and self._task_handler is not None: + self._task_handler.cancel() + + self._task_handler = None + + if self._payload_parser is not None: + self._payload_parser.feed_eof() + self._payload_parser = None + + def set_parser(self, parser: Any) -> None: + # Actual type is WebReader + assert self._payload_parser is None + + self._payload_parser = parser + + if self._message_tail: + self._payload_parser.feed_data(self._message_tail) + self._message_tail = b"" + + def eof_received(self) -> None: + pass + + def data_received(self, data: bytes) -> None: + if self._force_close or self._close: + return + # parse http messages + messages: Sequence[_MsgType] + if self._payload_parser is None and not self._upgrade: + assert self._request_parser is not None + try: + messages, upgraded, tail = self._request_parser.feed_data(data) + except HttpProcessingError as exc: + messages = [ + (_ErrInfo(status=400, exc=exc, message=exc.message), EMPTY_PAYLOAD) + ] + upgraded = False + tail = b"" + + for msg, payload in messages or (): + self._request_count += 1 + self._messages.append((msg, payload)) + + waiter = self._waiter + if messages and waiter is not None and not waiter.done(): + # don't set result twice + waiter.set_result(None) + + self._upgrade = upgraded + if upgraded and tail: + self._message_tail = tail + + # no parser, just store + elif self._payload_parser is None and self._upgrade and data: + self._message_tail += data + + # feed payload + elif data: + eof, tail = self._payload_parser.feed_data(data) + if eof: + self.close() + + def keep_alive(self, val: bool) -> None: + """Set keep-alive connection mode. + + :param bool val: new state. + """ + self._keepalive = val + if self._keepalive_handle: + self._keepalive_handle.cancel() + self._keepalive_handle = None + + def close(self) -> None: + """Close connection. + + Stop accepting new pipelining messages and close + connection when handlers done processing messages. + """ + self._close = True + if self._waiter: + self._waiter.cancel() + + def force_close(self) -> None: + """Forcefully close connection.""" + self._force_close = True + if self._waiter: + self._waiter.cancel() + if self.transport is not None: + self.transport.close() + self.transport = None + + def log_access( + self, request: BaseRequest, response: StreamResponse, time: Optional[float] + ) -> None: + if self._logging_enabled and self.access_logger is not None: + if TYPE_CHECKING: + assert time is not None + self.access_logger.log(request, response, self._loop.time() - time) + + def log_debug(self, *args: Any, **kw: Any) -> None: + if self.debug: + self.logger.debug(*args, **kw) + + def log_exception(self, *args: Any, **kw: Any) -> None: + self.logger.exception(*args, **kw) + + def _process_keepalive(self) -> None: + self._keepalive_handle = None + if self._force_close or not self._keepalive: + return + + loop = self._loop + now = loop.time() + close_time = self._next_keepalive_close_time + if now < close_time: + # Keep alive close check fired too early, reschedule + self._keepalive_handle = loop.call_at(close_time, self._process_keepalive) + return + + # handler in idle state + if self._waiter and not self._waiter.done(): + self.force_close() + + async def _handle_request( + self, + request: BaseRequest, + start_time: Optional[float], + request_handler: Callable[[BaseRequest], Awaitable[StreamResponse]], + ) -> Tuple[StreamResponse, bool]: + self._request_in_progress = True + try: + try: + self._current_request = request + resp = await request_handler(request) + finally: + self._current_request = None + except HTTPException as exc: + resp = exc + resp, reset = await self.finish_response(request, resp, start_time) + except asyncio.CancelledError: + raise + except asyncio.TimeoutError as exc: + self.log_debug("Request handler timed out.", exc_info=exc) + resp = self.handle_error(request, 504) + resp, reset = await self.finish_response(request, resp, start_time) + except Exception as exc: + resp = self.handle_error(request, 500, exc) + resp, reset = await self.finish_response(request, resp, start_time) + else: + # Deprecation warning (See #2415) + if getattr(resp, "__http_exception__", False): + warnings.warn( + "returning HTTPException object is deprecated " + "(#2415) and will be removed, " + "please raise the exception instead", + DeprecationWarning, + ) + + resp, reset = await self.finish_response(request, resp, start_time) + finally: + self._request_in_progress = False + if self._handler_waiter is not None: + self._handler_waiter.set_result(None) + + return resp, reset + + async def start(self) -> None: + """Process incoming request. + + It reads request line, request headers and request payload, then + calls handle_request() method. Subclass has to override + handle_request(). start() handles various exceptions in request + or response handling. Connection is being closed always unless + keep_alive(True) specified. + """ + loop = self._loop + manager = self._manager + assert manager is not None + keepalive_timeout = self._keepalive_timeout + resp = None + assert self._request_factory is not None + assert self._request_handler is not None + + while not self._force_close: + if not self._messages: + try: + # wait for next request + self._waiter = loop.create_future() + await self._waiter + finally: + self._waiter = None + + message, payload = self._messages.popleft() + + # time is only fetched if logging is enabled as otherwise + # its thrown away and never used. + start = loop.time() if self._logging_enabled else None + + manager.requests_count += 1 + writer = StreamWriter(self, loop) + if isinstance(message, _ErrInfo): + # make request_factory work + request_handler = self._make_error_handler(message) + message = ERROR + else: + request_handler = self._request_handler + + # Important don't hold a reference to the current task + # as on traceback it will prevent the task from being + # collected and will cause a memory leak. + request = self._request_factory( + message, + payload, + self, + writer, + self._task_handler or asyncio.current_task(loop), # type: ignore[arg-type] + ) + try: + # a new task is used for copy context vars (#3406) + coro = self._handle_request(request, start, request_handler) + if sys.version_info >= (3, 12): + task = asyncio.Task(coro, loop=loop, eager_start=True) + else: + task = loop.create_task(coro) + try: + resp, reset = await task + except ConnectionError: + self.log_debug("Ignored premature client disconnection") + break + + # Drop the processed task from asyncio.Task.all_tasks() early + del task + if reset: + self.log_debug("Ignored premature client disconnection 2") + break + + # notify server about keep-alive + self._keepalive = bool(resp.keep_alive) + + # check payload + if not payload.is_eof(): + lingering_time = self._lingering_time + if not self._force_close and lingering_time: + self.log_debug( + "Start lingering close timer for %s sec.", lingering_time + ) + + now = loop.time() + end_t = now + lingering_time + + try: + while not payload.is_eof() and now < end_t: + async with ceil_timeout(end_t - now): + # read and ignore + await payload.readany() + now = loop.time() + except (asyncio.CancelledError, asyncio.TimeoutError): + if ( + sys.version_info >= (3, 11) + and (t := asyncio.current_task()) + and t.cancelling() + ): + raise + + # if payload still uncompleted + if not payload.is_eof() and not self._force_close: + self.log_debug("Uncompleted request.") + self.close() + + payload.set_exception(_PAYLOAD_ACCESS_ERROR) + + except asyncio.CancelledError: + self.log_debug("Ignored premature client disconnection") + self.force_close() + raise + except Exception as exc: + self.log_exception("Unhandled exception", exc_info=exc) + self.force_close() + except BaseException: + self.force_close() + raise + finally: + request._task = None # type: ignore[assignment] # Break reference cycle in case of exception + if self.transport is None and resp is not None: + self.log_debug("Ignored premature client disconnection.") + + if self._keepalive and not self._close and not self._force_close: + # start keep-alive timer + close_time = loop.time() + keepalive_timeout + self._next_keepalive_close_time = close_time + if self._keepalive_handle is None: + self._keepalive_handle = loop.call_at( + close_time, self._process_keepalive + ) + else: + break + + # remove handler, close transport if no handlers left + if not self._force_close: + self._task_handler = None + if self.transport is not None: + self.transport.close() + + async def finish_response( + self, request: BaseRequest, resp: StreamResponse, start_time: Optional[float] + ) -> Tuple[StreamResponse, bool]: + """Prepare the response and write_eof, then log access. + + This has to + be called within the context of any exception so the access logger + can get exception information. Returns True if the client disconnects + prematurely. + """ + request._finish() + if self._request_parser is not None: + self._request_parser.set_upgraded(False) + self._upgrade = False + if self._message_tail: + self._request_parser.feed_data(self._message_tail) + self._message_tail = b"" + try: + prepare_meth = resp.prepare + except AttributeError: + if resp is None: + self.log_exception("Missing return statement on request handler") + else: + self.log_exception( + "Web-handler should return a response instance, " + "got {!r}".format(resp) + ) + exc = HTTPInternalServerError() + resp = Response( + status=exc.status, reason=exc.reason, text=exc.text, headers=exc.headers + ) + prepare_meth = resp.prepare + try: + await prepare_meth(request) + await resp.write_eof() + except ConnectionError: + self.log_access(request, resp, start_time) + return resp, True + + self.log_access(request, resp, start_time) + return resp, False + + def handle_error( + self, + request: BaseRequest, + status: int = 500, + exc: Optional[BaseException] = None, + message: Optional[str] = None, + ) -> StreamResponse: + """Handle errors. + + Returns HTTP response with specific status code. Logs additional + information. It always closes current connection. + """ + if self._request_count == 1 and isinstance(exc, BadHttpMethod): + # BadHttpMethod is common when a client sends non-HTTP + # or encrypted traffic to an HTTP port. This is expected + # to happen when connected to the public internet so we log + # it at the debug level as to not fill logs with noise. + self.logger.debug( + "Error handling request from %s", request.remote, exc_info=exc + ) + else: + self.log_exception( + "Error handling request from %s", request.remote, exc_info=exc + ) + + # some data already got sent, connection is broken + if request.writer.output_size > 0: + raise ConnectionError( + "Response is sent already, cannot send another response " + "with the error message" + ) + + ct = "text/plain" + if status == HTTPStatus.INTERNAL_SERVER_ERROR: + title = "{0.value} {0.phrase}".format(HTTPStatus.INTERNAL_SERVER_ERROR) + msg = HTTPStatus.INTERNAL_SERVER_ERROR.description + tb = None + if self.debug: + with suppress(Exception): + tb = traceback.format_exc() + + if "text/html" in request.headers.get("Accept", ""): + if tb: + tb = html_escape(tb) + msg = f"

Traceback:

\n
{tb}
" + message = ( + "" + "{title}" + "\n

{title}

" + "\n{msg}\n\n" + ).format(title=title, msg=msg) + ct = "text/html" + else: + if tb: + msg = tb + message = title + "\n\n" + msg + + resp = Response(status=status, text=message, content_type=ct) + resp.force_close() + + return resp + + def _make_error_handler( + self, err_info: _ErrInfo + ) -> Callable[[BaseRequest], Awaitable[StreamResponse]]: + async def handler(request: BaseRequest) -> StreamResponse: + return self.handle_error( + request, err_info.status, err_info.exc, err_info.message + ) + + return handler diff --git a/env/lib/python3.12/site-packages/aiohttp/web_request.py b/env/lib/python3.12/site-packages/aiohttp/web_request.py new file mode 100644 index 0000000..0eafcd6 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_request.py @@ -0,0 +1,914 @@ +import asyncio +import datetime +import io +import re +import socket +import string +import tempfile +import types +import warnings +from types import MappingProxyType +from typing import ( + TYPE_CHECKING, + Any, + Dict, + Final, + Iterator, + Mapping, + MutableMapping, + Optional, + Pattern, + Tuple, + Union, + cast, +) +from urllib.parse import parse_qsl + +import attr +from multidict import ( + CIMultiDict, + CIMultiDictProxy, + MultiDict, + MultiDictProxy, + MultiMapping, +) +from yarl import URL + +from . import hdrs +from ._cookie_helpers import parse_cookie_header +from .abc import AbstractStreamWriter +from .helpers import ( + _SENTINEL, + DEBUG, + ETAG_ANY, + LIST_QUOTED_ETAG_RE, + ChainMapProxy, + ETag, + HeadersMixin, + parse_http_date, + reify, + sentinel, + set_exception, +) +from .http_parser import RawRequestMessage +from .http_writer import HttpVersion +from .multipart import BodyPartReader, MultipartReader +from .streams import EmptyStreamReader, StreamReader +from .typedefs import ( + DEFAULT_JSON_DECODER, + JSONDecoder, + LooseHeaders, + RawHeaders, + StrOrURL, +) +from .web_exceptions import HTTPRequestEntityTooLarge +from .web_response import StreamResponse + +__all__ = ("BaseRequest", "FileField", "Request") + + +if TYPE_CHECKING: + from .web_app import Application + from .web_protocol import RequestHandler + from .web_urldispatcher import UrlMappingMatchInfo + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class FileField: + name: str + filename: str + file: io.BufferedReader + content_type: str + headers: CIMultiDictProxy[str] + + +_TCHAR: Final[str] = string.digits + string.ascii_letters + r"!#$%&'*+.^_`|~-" +# '-' at the end to prevent interpretation as range in a char class + +_TOKEN: Final[str] = rf"[{_TCHAR}]+" + +_QDTEXT: Final[str] = r"[{}]".format( + r"".join(chr(c) for c in (0x09, 0x20, 0x21) + tuple(range(0x23, 0x7F))) +) +# qdtext includes 0x5C to escape 0x5D ('\]') +# qdtext excludes obs-text (because obsoleted, and encoding not specified) + +_QUOTED_PAIR: Final[str] = r"\\[\t !-~]" + +_QUOTED_STRING: Final[str] = r'"(?:{quoted_pair}|{qdtext})*"'.format( + qdtext=_QDTEXT, quoted_pair=_QUOTED_PAIR +) + +_FORWARDED_PAIR: Final[str] = ( + r"({token})=({token}|{quoted_string})(:\d{{1,4}})?".format( + token=_TOKEN, quoted_string=_QUOTED_STRING + ) +) + +_QUOTED_PAIR_REPLACE_RE: Final[Pattern[str]] = re.compile(r"\\([\t !-~])") +# same pattern as _QUOTED_PAIR but contains a capture group + +_FORWARDED_PAIR_RE: Final[Pattern[str]] = re.compile(_FORWARDED_PAIR) + +############################################################ +# HTTP Request +############################################################ + + +class BaseRequest(MutableMapping[str, Any], HeadersMixin): + + POST_METHODS = { + hdrs.METH_PATCH, + hdrs.METH_POST, + hdrs.METH_PUT, + hdrs.METH_TRACE, + hdrs.METH_DELETE, + } + + ATTRS = HeadersMixin.ATTRS | frozenset( + [ + "_message", + "_protocol", + "_payload_writer", + "_payload", + "_headers", + "_method", + "_version", + "_rel_url", + "_post", + "_read_bytes", + "_state", + "_cache", + "_task", + "_client_max_size", + "_loop", + "_transport_sslcontext", + "_transport_peername", + ] + ) + _post: Optional[MultiDictProxy[Union[str, bytes, FileField]]] = None + _read_bytes: Optional[bytes] = None + + def __init__( + self, + message: RawRequestMessage, + payload: StreamReader, + protocol: "RequestHandler", + payload_writer: AbstractStreamWriter, + task: "asyncio.Task[None]", + loop: asyncio.AbstractEventLoop, + *, + client_max_size: int = 1024**2, + state: Optional[Dict[str, Any]] = None, + scheme: Optional[str] = None, + host: Optional[str] = None, + remote: Optional[str] = None, + ) -> None: + self._message = message + self._protocol = protocol + self._payload_writer = payload_writer + + self._payload = payload + self._headers: CIMultiDictProxy[str] = message.headers + self._method = message.method + self._version = message.version + self._cache: Dict[str, Any] = {} + url = message.url + if url.absolute: + if scheme is not None: + url = url.with_scheme(scheme) + if host is not None: + url = url.with_host(host) + # absolute URL is given, + # override auto-calculating url, host, and scheme + # all other properties should be good + self._cache["url"] = url + self._cache["host"] = url.host + self._cache["scheme"] = url.scheme + self._rel_url = url.relative() + else: + self._rel_url = url + if scheme is not None: + self._cache["scheme"] = scheme + if host is not None: + self._cache["host"] = host + + self._state = {} if state is None else state + self._task = task + self._client_max_size = client_max_size + self._loop = loop + + self._transport_sslcontext = protocol.ssl_context + self._transport_peername = protocol.peername + + if remote is not None: + self._cache["remote"] = remote + + def clone( + self, + *, + method: Union[str, _SENTINEL] = sentinel, + rel_url: Union[StrOrURL, _SENTINEL] = sentinel, + headers: Union[LooseHeaders, _SENTINEL] = sentinel, + scheme: Union[str, _SENTINEL] = sentinel, + host: Union[str, _SENTINEL] = sentinel, + remote: Union[str, _SENTINEL] = sentinel, + client_max_size: Union[int, _SENTINEL] = sentinel, + ) -> "BaseRequest": + """Clone itself with replacement some attributes. + + Creates and returns a new instance of Request object. If no parameters + are given, an exact copy is returned. If a parameter is not passed, it + will reuse the one from the current request object. + """ + if self._read_bytes: + raise RuntimeError("Cannot clone request after reading its content") + + dct: Dict[str, Any] = {} + if method is not sentinel: + dct["method"] = method + if rel_url is not sentinel: + new_url: URL = URL(rel_url) + dct["url"] = new_url + dct["path"] = str(new_url) + if headers is not sentinel: + # a copy semantic + dct["headers"] = CIMultiDictProxy(CIMultiDict(headers)) + dct["raw_headers"] = tuple( + (k.encode("utf-8"), v.encode("utf-8")) + for k, v in dct["headers"].items() + ) + + message = self._message._replace(**dct) + + kwargs = {} + if scheme is not sentinel: + kwargs["scheme"] = scheme + if host is not sentinel: + kwargs["host"] = host + if remote is not sentinel: + kwargs["remote"] = remote + if client_max_size is sentinel: + client_max_size = self._client_max_size + + return self.__class__( + message, + self._payload, + self._protocol, + self._payload_writer, + self._task, + self._loop, + client_max_size=client_max_size, + state=self._state.copy(), + **kwargs, + ) + + @property + def task(self) -> "asyncio.Task[None]": + return self._task + + @property + def protocol(self) -> "RequestHandler": + return self._protocol + + @property + def transport(self) -> Optional[asyncio.Transport]: + if self._protocol is None: + return None + return self._protocol.transport + + @property + def writer(self) -> AbstractStreamWriter: + return self._payload_writer + + @property + def client_max_size(self) -> int: + return self._client_max_size + + @reify + def message(self) -> RawRequestMessage: + warnings.warn("Request.message is deprecated", DeprecationWarning, stacklevel=3) + return self._message + + @reify + def rel_url(self) -> URL: + return self._rel_url + + @reify + def loop(self) -> asyncio.AbstractEventLoop: + warnings.warn( + "request.loop property is deprecated", DeprecationWarning, stacklevel=2 + ) + return self._loop + + # MutableMapping API + + def __getitem__(self, key: str) -> Any: + return self._state[key] + + def __setitem__(self, key: str, value: Any) -> None: + self._state[key] = value + + def __delitem__(self, key: str) -> None: + del self._state[key] + + def __len__(self) -> int: + return len(self._state) + + def __iter__(self) -> Iterator[str]: + return iter(self._state) + + ######## + + @reify + def secure(self) -> bool: + """A bool indicating if the request is handled with SSL.""" + return self.scheme == "https" + + @reify + def forwarded(self) -> Tuple[Mapping[str, str], ...]: + """A tuple containing all parsed Forwarded header(s). + + Makes an effort to parse Forwarded headers as specified by RFC 7239: + + - It adds one (immutable) dictionary per Forwarded 'field-value', ie + per proxy. The element corresponds to the data in the Forwarded + field-value added by the first proxy encountered by the client. Each + subsequent item corresponds to those added by later proxies. + - It checks that every value has valid syntax in general as specified + in section 4: either a 'token' or a 'quoted-string'. + - It un-escapes found escape sequences. + - It does NOT validate 'by' and 'for' contents as specified in section + 6. + - It does NOT validate 'host' contents (Host ABNF). + - It does NOT validate 'proto' contents for valid URI scheme names. + + Returns a tuple containing one or more immutable dicts + """ + elems = [] + for field_value in self._message.headers.getall(hdrs.FORWARDED, ()): + length = len(field_value) + pos = 0 + need_separator = False + elem: Dict[str, str] = {} + elems.append(types.MappingProxyType(elem)) + while 0 <= pos < length: + match = _FORWARDED_PAIR_RE.match(field_value, pos) + if match is not None: # got a valid forwarded-pair + if need_separator: + # bad syntax here, skip to next comma + pos = field_value.find(",", pos) + else: + name, value, port = match.groups() + if value[0] == '"': + # quoted string: remove quotes and unescape + value = _QUOTED_PAIR_REPLACE_RE.sub(r"\1", value[1:-1]) + if port: + value += port + elem[name.lower()] = value + pos += len(match.group(0)) + need_separator = True + elif field_value[pos] == ",": # next forwarded-element + need_separator = False + elem = {} + elems.append(types.MappingProxyType(elem)) + pos += 1 + elif field_value[pos] == ";": # next forwarded-pair + need_separator = False + pos += 1 + elif field_value[pos] in " \t": + # Allow whitespace even between forwarded-pairs, though + # RFC 7239 doesn't. This simplifies code and is in line + # with Postel's law. + pos += 1 + else: + # bad syntax here, skip to next comma + pos = field_value.find(",", pos) + return tuple(elems) + + @reify + def scheme(self) -> str: + """A string representing the scheme of the request. + + Hostname is resolved in this order: + + - overridden value by .clone(scheme=new_scheme) call. + - type of connection to peer: HTTPS if socket is SSL, HTTP otherwise. + + 'http' or 'https'. + """ + if self._transport_sslcontext: + return "https" + else: + return "http" + + @reify + def method(self) -> str: + """Read only property for getting HTTP method. + + The value is upper-cased str like 'GET', 'POST', 'PUT' etc. + """ + return self._method + + @reify + def version(self) -> HttpVersion: + """Read only property for getting HTTP version of request. + + Returns aiohttp.protocol.HttpVersion instance. + """ + return self._version + + @reify + def host(self) -> str: + """Hostname of the request. + + Hostname is resolved in this order: + + - overridden value by .clone(host=new_host) call. + - HOST HTTP header + - socket.getfqdn() value + + For example, 'example.com' or 'localhost:8080'. + + For historical reasons, the port number may be included. + """ + host = self._message.headers.get(hdrs.HOST) + if host is not None: + return host + return socket.getfqdn() + + @reify + def remote(self) -> Optional[str]: + """Remote IP of client initiated HTTP request. + + The IP is resolved in this order: + + - overridden value by .clone(remote=new_remote) call. + - peername of opened socket + """ + if self._transport_peername is None: + return None + if isinstance(self._transport_peername, (list, tuple)): + return str(self._transport_peername[0]) + return str(self._transport_peername) + + @reify + def url(self) -> URL: + """The full URL of the request.""" + # authority is used here because it may include the port number + # and we want yarl to parse it correctly + return URL.build(scheme=self.scheme, authority=self.host).join(self._rel_url) + + @reify + def path(self) -> str: + """The URL including *PATH INFO* without the host or scheme. + + E.g., ``/app/blog`` + """ + return self._rel_url.path + + @reify + def path_qs(self) -> str: + """The URL including PATH_INFO and the query string. + + E.g, /app/blog?id=10 + """ + return str(self._rel_url) + + @reify + def raw_path(self) -> str: + """The URL including raw *PATH INFO* without the host or scheme. + + Warning, the path is unquoted and may contains non valid URL characters + + E.g., ``/my%2Fpath%7Cwith%21some%25strange%24characters`` + """ + return self._message.path + + @reify + def query(self) -> "MultiMapping[str]": + """A multidict with all the variables in the query string.""" + return self._rel_url.query + + @reify + def query_string(self) -> str: + """The query string in the URL. + + E.g., id=10 + """ + return self._rel_url.query_string + + @reify + def headers(self) -> CIMultiDictProxy[str]: + """A case-insensitive multidict proxy with all headers.""" + return self._headers + + @reify + def raw_headers(self) -> RawHeaders: + """A sequence of pairs for all headers.""" + return self._message.raw_headers + + @reify + def if_modified_since(self) -> Optional[datetime.datetime]: + """The value of If-Modified-Since HTTP header, or None. + + This header is represented as a `datetime` object. + """ + return parse_http_date(self.headers.get(hdrs.IF_MODIFIED_SINCE)) + + @reify + def if_unmodified_since(self) -> Optional[datetime.datetime]: + """The value of If-Unmodified-Since HTTP header, or None. + + This header is represented as a `datetime` object. + """ + return parse_http_date(self.headers.get(hdrs.IF_UNMODIFIED_SINCE)) + + @staticmethod + def _etag_values(etag_header: str) -> Iterator[ETag]: + """Extract `ETag` objects from raw header.""" + if etag_header == ETAG_ANY: + yield ETag( + is_weak=False, + value=ETAG_ANY, + ) + else: + for match in LIST_QUOTED_ETAG_RE.finditer(etag_header): + is_weak, value, garbage = match.group(2, 3, 4) + # Any symbol captured by 4th group means + # that the following sequence is invalid. + if garbage: + break + + yield ETag( + is_weak=bool(is_weak), + value=value, + ) + + @classmethod + def _if_match_or_none_impl( + cls, header_value: Optional[str] + ) -> Optional[Tuple[ETag, ...]]: + if not header_value: + return None + + return tuple(cls._etag_values(header_value)) + + @reify + def if_match(self) -> Optional[Tuple[ETag, ...]]: + """The value of If-Match HTTP header, or None. + + This header is represented as a `tuple` of `ETag` objects. + """ + return self._if_match_or_none_impl(self.headers.get(hdrs.IF_MATCH)) + + @reify + def if_none_match(self) -> Optional[Tuple[ETag, ...]]: + """The value of If-None-Match HTTP header, or None. + + This header is represented as a `tuple` of `ETag` objects. + """ + return self._if_match_or_none_impl(self.headers.get(hdrs.IF_NONE_MATCH)) + + @reify + def if_range(self) -> Optional[datetime.datetime]: + """The value of If-Range HTTP header, or None. + + This header is represented as a `datetime` object. + """ + return parse_http_date(self.headers.get(hdrs.IF_RANGE)) + + @reify + def keep_alive(self) -> bool: + """Is keepalive enabled by client?""" + return not self._message.should_close + + @reify + def cookies(self) -> Mapping[str, str]: + """Return request cookies. + + A read-only dictionary-like object. + """ + # Use parse_cookie_header for RFC 6265 compliant Cookie header parsing + # that accepts special characters in cookie names (fixes #2683) + parsed = parse_cookie_header(self.headers.get(hdrs.COOKIE, "")) + # Extract values from Morsel objects + return MappingProxyType({name: morsel.value for name, morsel in parsed}) + + @reify + def http_range(self) -> slice: + """The content of Range HTTP header. + + Return a slice instance. + + """ + rng = self._headers.get(hdrs.RANGE) + start, end = None, None + if rng is not None: + try: + pattern = r"^bytes=(\d*)-(\d*)$" + start, end = re.findall(pattern, rng, re.ASCII)[0] + except IndexError: # pattern was not found in header + raise ValueError("range not in acceptable format") + + end = int(end) if end else None + start = int(start) if start else None + + if start is None and end is not None: + # end with no start is to return tail of content + start = -end + end = None + + if start is not None and end is not None: + # end is inclusive in range header, exclusive for slice + end += 1 + + if start >= end: + raise ValueError("start cannot be after end") + + if start is end is None: # No valid range supplied + raise ValueError("No start or end of range specified") + + return slice(start, end, 1) + + @reify + def content(self) -> StreamReader: + """Return raw payload stream.""" + return self._payload + + @property + def has_body(self) -> bool: + """Return True if request's HTTP BODY can be read, False otherwise.""" + warnings.warn( + "Deprecated, use .can_read_body #2005", DeprecationWarning, stacklevel=2 + ) + return not self._payload.at_eof() + + @property + def can_read_body(self) -> bool: + """Return True if request's HTTP BODY can be read, False otherwise.""" + return not self._payload.at_eof() + + @reify + def body_exists(self) -> bool: + """Return True if request has HTTP BODY, False otherwise.""" + return type(self._payload) is not EmptyStreamReader + + async def release(self) -> None: + """Release request. + + Eat unread part of HTTP BODY if present. + """ + while not self._payload.at_eof(): + await self._payload.readany() + + async def read(self) -> bytes: + """Read request body if present. + + Returns bytes object with full request content. + """ + if self._read_bytes is None: + body = bytearray() + while True: + chunk = await self._payload.readany() + body.extend(chunk) + if self._client_max_size: + body_size = len(body) + if body_size >= self._client_max_size: + raise HTTPRequestEntityTooLarge( + max_size=self._client_max_size, actual_size=body_size + ) + if not chunk: + break + self._read_bytes = bytes(body) + return self._read_bytes + + async def text(self) -> str: + """Return BODY as text using encoding from .charset.""" + bytes_body = await self.read() + encoding = self.charset or "utf-8" + return bytes_body.decode(encoding) + + async def json(self, *, loads: JSONDecoder = DEFAULT_JSON_DECODER) -> Any: + """Return BODY as JSON.""" + body = await self.text() + return loads(body) + + async def multipart(self) -> MultipartReader: + """Return async iterator to process BODY as multipart.""" + return MultipartReader(self._headers, self._payload) + + async def post(self) -> "MultiDictProxy[Union[str, bytes, FileField]]": + """Return POST parameters.""" + if self._post is not None: + return self._post + if self._method not in self.POST_METHODS: + self._post = MultiDictProxy(MultiDict()) + return self._post + + content_type = self.content_type + if content_type not in ( + "", + "application/x-www-form-urlencoded", + "multipart/form-data", + ): + self._post = MultiDictProxy(MultiDict()) + return self._post + + out: MultiDict[Union[str, bytes, FileField]] = MultiDict() + + if content_type == "multipart/form-data": + multipart = await self.multipart() + max_size = self._client_max_size + + size = 0 + while (field := await multipart.next()) is not None: + field_ct = field.headers.get(hdrs.CONTENT_TYPE) + + if isinstance(field, BodyPartReader): + if field.name is None: + raise ValueError("Multipart field missing name.") + + # Note that according to RFC 7578, the Content-Type header + # is optional, even for files, so we can't assume it's + # present. + # https://tools.ietf.org/html/rfc7578#section-4.4 + if field.filename: + # store file in temp file + tmp = await self._loop.run_in_executor( + None, tempfile.TemporaryFile + ) + chunk = await field.read_chunk(size=2**16) + while chunk: + chunk = await field.decode(chunk) + await self._loop.run_in_executor(None, tmp.write, chunk) + size += len(chunk) + if 0 < max_size < size: + await self._loop.run_in_executor(None, tmp.close) + raise HTTPRequestEntityTooLarge( + max_size=max_size, actual_size=size + ) + chunk = await field.read_chunk(size=2**16) + await self._loop.run_in_executor(None, tmp.seek, 0) + + if field_ct is None: + field_ct = "application/octet-stream" + + ff = FileField( + field.name, + field.filename, + cast(io.BufferedReader, tmp), + field_ct, + field.headers, + ) + out.add(field.name, ff) + else: + # deal with ordinary data + value = await field.read(decode=True) + if field_ct is None or field_ct.startswith("text/"): + charset = field.get_charset(default="utf-8") + out.add(field.name, value.decode(charset)) + else: + out.add(field.name, value) + size += len(value) + if 0 < max_size < size: + raise HTTPRequestEntityTooLarge( + max_size=max_size, actual_size=size + ) + else: + raise ValueError( + "To decode nested multipart you need to use custom reader", + ) + else: + data = await self.read() + if data: + charset = self.charset or "utf-8" + out.extend( + parse_qsl( + data.rstrip().decode(charset), + keep_blank_values=True, + encoding=charset, + ) + ) + + self._post = MultiDictProxy(out) + return self._post + + def get_extra_info(self, name: str, default: Any = None) -> Any: + """Extra info from protocol transport""" + protocol = self._protocol + if protocol is None: + return default + + transport = protocol.transport + if transport is None: + return default + + return transport.get_extra_info(name, default) + + def __repr__(self) -> str: + ascii_encodable_path = self.path.encode("ascii", "backslashreplace").decode( + "ascii" + ) + return "<{} {} {} >".format( + self.__class__.__name__, self._method, ascii_encodable_path + ) + + def __eq__(self, other: object) -> bool: + return id(self) == id(other) + + def __bool__(self) -> bool: + return True + + async def _prepare_hook(self, response: StreamResponse) -> None: + return + + def _cancel(self, exc: BaseException) -> None: + set_exception(self._payload, exc) + + def _finish(self) -> None: + if self._post is None or self.content_type != "multipart/form-data": + return + + # NOTE: Release file descriptors for the + # NOTE: `tempfile.Temporaryfile`-created `_io.BufferedRandom` + # NOTE: instances of files sent within multipart request body + # NOTE: via HTTP POST request. + for file_name, file_field_object in self._post.items(): + if isinstance(file_field_object, FileField): + file_field_object.file.close() + + +class Request(BaseRequest): + + ATTRS = BaseRequest.ATTRS | frozenset(["_match_info"]) + + _match_info: Optional["UrlMappingMatchInfo"] = None + + if DEBUG: + + def __setattr__(self, name: str, val: Any) -> None: + if name not in self.ATTRS: + warnings.warn( + "Setting custom {}.{} attribute " + "is discouraged".format(self.__class__.__name__, name), + DeprecationWarning, + stacklevel=2, + ) + super().__setattr__(name, val) + + def clone( + self, + *, + method: Union[str, _SENTINEL] = sentinel, + rel_url: Union[StrOrURL, _SENTINEL] = sentinel, + headers: Union[LooseHeaders, _SENTINEL] = sentinel, + scheme: Union[str, _SENTINEL] = sentinel, + host: Union[str, _SENTINEL] = sentinel, + remote: Union[str, _SENTINEL] = sentinel, + client_max_size: Union[int, _SENTINEL] = sentinel, + ) -> "Request": + ret = super().clone( + method=method, + rel_url=rel_url, + headers=headers, + scheme=scheme, + host=host, + remote=remote, + client_max_size=client_max_size, + ) + new_ret = cast(Request, ret) + new_ret._match_info = self._match_info + return new_ret + + @reify + def match_info(self) -> "UrlMappingMatchInfo": + """Result of route resolving.""" + match_info = self._match_info + assert match_info is not None + return match_info + + @property + def app(self) -> "Application": + """Application instance.""" + match_info = self._match_info + assert match_info is not None + return match_info.current_app + + @property + def config_dict(self) -> ChainMapProxy: + match_info = self._match_info + assert match_info is not None + lst = match_info.apps + app = self.app + idx = lst.index(app) + sublist = list(reversed(lst[: idx + 1])) + return ChainMapProxy(sublist) + + async def _prepare_hook(self, response: StreamResponse) -> None: + match_info = self._match_info + if match_info is None: + return + for app in match_info._apps: + if on_response_prepare := app.on_response_prepare: + await on_response_prepare.send(self, response) diff --git a/env/lib/python3.12/site-packages/aiohttp/web_response.py b/env/lib/python3.12/site-packages/aiohttp/web_response.py new file mode 100644 index 0000000..e5f8b6c --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_response.py @@ -0,0 +1,856 @@ +import asyncio +import collections.abc +import datetime +import enum +import json +import math +import time +import warnings +from concurrent.futures import Executor +from http import HTTPStatus +from http.cookies import SimpleCookie +from typing import ( + TYPE_CHECKING, + Any, + Dict, + Iterator, + MutableMapping, + Optional, + Union, + cast, +) + +from multidict import CIMultiDict, istr + +from . import hdrs, payload +from .abc import AbstractStreamWriter +from .compression_utils import ZLibCompressor +from .helpers import ( + ETAG_ANY, + QUOTED_ETAG_RE, + ETag, + HeadersMixin, + must_be_empty_body, + parse_http_date, + rfc822_formatted_time, + sentinel, + should_remove_content_length, + validate_etag_value, +) +from .http import SERVER_SOFTWARE, HttpVersion10, HttpVersion11 +from .payload import Payload +from .typedefs import JSONEncoder, LooseHeaders + +REASON_PHRASES = {http_status.value: http_status.phrase for http_status in HTTPStatus} +LARGE_BODY_SIZE = 1024**2 + +__all__ = ("ContentCoding", "StreamResponse", "Response", "json_response") + + +if TYPE_CHECKING: + from .web_request import BaseRequest + + BaseClass = MutableMapping[str, Any] +else: + BaseClass = collections.abc.MutableMapping + + +# TODO(py311): Convert to StrEnum for wider use +class ContentCoding(enum.Enum): + # The content codings that we have support for. + # + # Additional registered codings are listed at: + # https://www.iana.org/assignments/http-parameters/http-parameters.xhtml#content-coding + deflate = "deflate" + gzip = "gzip" + identity = "identity" + + +CONTENT_CODINGS = {coding.value: coding for coding in ContentCoding} + +############################################################ +# HTTP Response classes +############################################################ + + +class StreamResponse(BaseClass, HeadersMixin): + + _body: Union[None, bytes, bytearray, Payload] + _length_check = True + _body = None + _keep_alive: Optional[bool] = None + _chunked: bool = False + _compression: bool = False + _compression_strategy: Optional[int] = None + _compression_force: Optional[ContentCoding] = None + _req: Optional["BaseRequest"] = None + _payload_writer: Optional[AbstractStreamWriter] = None + _eof_sent: bool = False + _must_be_empty_body: Optional[bool] = None + _body_length = 0 + _cookies: Optional[SimpleCookie] = None + _send_headers_immediately = True + + def __init__( + self, + *, + status: int = 200, + reason: Optional[str] = None, + headers: Optional[LooseHeaders] = None, + _real_headers: Optional[CIMultiDict[str]] = None, + ) -> None: + """Initialize a new stream response object. + + _real_headers is an internal parameter used to pass a pre-populated + headers object. It is used by the `Response` class to avoid copying + the headers when creating a new response object. It is not intended + to be used by external code. + """ + self._state: Dict[str, Any] = {} + + if _real_headers is not None: + self._headers = _real_headers + elif headers is not None: + self._headers: CIMultiDict[str] = CIMultiDict(headers) + else: + self._headers = CIMultiDict() + + self._set_status(status, reason) + + @property + def prepared(self) -> bool: + return self._eof_sent or self._payload_writer is not None + + @property + def task(self) -> "Optional[asyncio.Task[None]]": + if self._req: + return self._req.task + else: + return None + + @property + def status(self) -> int: + return self._status + + @property + def chunked(self) -> bool: + return self._chunked + + @property + def compression(self) -> bool: + return self._compression + + @property + def reason(self) -> str: + return self._reason + + def set_status( + self, + status: int, + reason: Optional[str] = None, + ) -> None: + assert ( + not self.prepared + ), "Cannot change the response status code after the headers have been sent" + self._set_status(status, reason) + + def _set_status(self, status: int, reason: Optional[str]) -> None: + self._status = int(status) + if reason is None: + reason = REASON_PHRASES.get(self._status, "") + elif "\n" in reason: + raise ValueError("Reason cannot contain \\n") + self._reason = reason + + @property + def keep_alive(self) -> Optional[bool]: + return self._keep_alive + + def force_close(self) -> None: + self._keep_alive = False + + @property + def body_length(self) -> int: + return self._body_length + + @property + def output_length(self) -> int: + warnings.warn("output_length is deprecated", DeprecationWarning) + assert self._payload_writer + return self._payload_writer.buffer_size + + def enable_chunked_encoding(self, chunk_size: Optional[int] = None) -> None: + """Enables automatic chunked transfer encoding.""" + if hdrs.CONTENT_LENGTH in self._headers: + raise RuntimeError( + "You can't enable chunked encoding when a content length is set" + ) + if chunk_size is not None: + warnings.warn("Chunk size is deprecated #1615", DeprecationWarning) + self._chunked = True + + def enable_compression( + self, + force: Optional[Union[bool, ContentCoding]] = None, + strategy: Optional[int] = None, + ) -> None: + """Enables response compression encoding.""" + # Backwards compatibility for when force was a bool <0.17. + if isinstance(force, bool): + force = ContentCoding.deflate if force else ContentCoding.identity + warnings.warn( + "Using boolean for force is deprecated #3318", DeprecationWarning + ) + elif force is not None: + assert isinstance( + force, ContentCoding + ), "force should one of None, bool or ContentEncoding" + + self._compression = True + self._compression_force = force + self._compression_strategy = strategy + + @property + def headers(self) -> "CIMultiDict[str]": + return self._headers + + @property + def cookies(self) -> SimpleCookie: + if self._cookies is None: + self._cookies = SimpleCookie() + return self._cookies + + def set_cookie( + self, + name: str, + value: str, + *, + expires: Optional[str] = None, + domain: Optional[str] = None, + max_age: Optional[Union[int, str]] = None, + path: str = "/", + secure: Optional[bool] = None, + httponly: Optional[bool] = None, + version: Optional[str] = None, + samesite: Optional[str] = None, + partitioned: Optional[bool] = None, + ) -> None: + """Set or update response cookie. + + Sets new cookie or updates existent with new value. + Also updates only those params which are not None. + """ + if self._cookies is None: + self._cookies = SimpleCookie() + + self._cookies[name] = value + c = self._cookies[name] + + if expires is not None: + c["expires"] = expires + elif c.get("expires") == "Thu, 01 Jan 1970 00:00:00 GMT": + del c["expires"] + + if domain is not None: + c["domain"] = domain + + if max_age is not None: + c["max-age"] = str(max_age) + elif "max-age" in c: + del c["max-age"] + + c["path"] = path + + if secure is not None: + c["secure"] = secure + if httponly is not None: + c["httponly"] = httponly + if version is not None: + c["version"] = version + if samesite is not None: + c["samesite"] = samesite + + if partitioned is not None: + c["partitioned"] = partitioned + + def del_cookie( + self, + name: str, + *, + domain: Optional[str] = None, + path: str = "/", + secure: Optional[bool] = None, + httponly: Optional[bool] = None, + samesite: Optional[str] = None, + ) -> None: + """Delete cookie. + + Creates new empty expired cookie. + """ + # TODO: do we need domain/path here? + if self._cookies is not None: + self._cookies.pop(name, None) + self.set_cookie( + name, + "", + max_age=0, + expires="Thu, 01 Jan 1970 00:00:00 GMT", + domain=domain, + path=path, + secure=secure, + httponly=httponly, + samesite=samesite, + ) + + @property + def content_length(self) -> Optional[int]: + # Just a placeholder for adding setter + return super().content_length + + @content_length.setter + def content_length(self, value: Optional[int]) -> None: + if value is not None: + value = int(value) + if self._chunked: + raise RuntimeError( + "You can't set content length when chunked encoding is enable" + ) + self._headers[hdrs.CONTENT_LENGTH] = str(value) + else: + self._headers.pop(hdrs.CONTENT_LENGTH, None) + + @property + def content_type(self) -> str: + # Just a placeholder for adding setter + return super().content_type + + @content_type.setter + def content_type(self, value: str) -> None: + self.content_type # read header values if needed + self._content_type = str(value) + self._generate_content_type_header() + + @property + def charset(self) -> Optional[str]: + # Just a placeholder for adding setter + return super().charset + + @charset.setter + def charset(self, value: Optional[str]) -> None: + ctype = self.content_type # read header values if needed + if ctype == "application/octet-stream": + raise RuntimeError( + "Setting charset for application/octet-stream " + "doesn't make sense, setup content_type first" + ) + assert self._content_dict is not None + if value is None: + self._content_dict.pop("charset", None) + else: + self._content_dict["charset"] = str(value).lower() + self._generate_content_type_header() + + @property + def last_modified(self) -> Optional[datetime.datetime]: + """The value of Last-Modified HTTP header, or None. + + This header is represented as a `datetime` object. + """ + return parse_http_date(self._headers.get(hdrs.LAST_MODIFIED)) + + @last_modified.setter + def last_modified( + self, value: Optional[Union[int, float, datetime.datetime, str]] + ) -> None: + if value is None: + self._headers.pop(hdrs.LAST_MODIFIED, None) + elif isinstance(value, (int, float)): + self._headers[hdrs.LAST_MODIFIED] = time.strftime( + "%a, %d %b %Y %H:%M:%S GMT", time.gmtime(math.ceil(value)) + ) + elif isinstance(value, datetime.datetime): + self._headers[hdrs.LAST_MODIFIED] = time.strftime( + "%a, %d %b %Y %H:%M:%S GMT", value.utctimetuple() + ) + elif isinstance(value, str): + self._headers[hdrs.LAST_MODIFIED] = value + else: + msg = f"Unsupported type for last_modified: {type(value).__name__}" + raise TypeError(msg) + + @property + def etag(self) -> Optional[ETag]: + quoted_value = self._headers.get(hdrs.ETAG) + if not quoted_value: + return None + elif quoted_value == ETAG_ANY: + return ETag(value=ETAG_ANY) + match = QUOTED_ETAG_RE.fullmatch(quoted_value) + if not match: + return None + is_weak, value = match.group(1, 2) + return ETag( + is_weak=bool(is_weak), + value=value, + ) + + @etag.setter + def etag(self, value: Optional[Union[ETag, str]]) -> None: + if value is None: + self._headers.pop(hdrs.ETAG, None) + elif (isinstance(value, str) and value == ETAG_ANY) or ( + isinstance(value, ETag) and value.value == ETAG_ANY + ): + self._headers[hdrs.ETAG] = ETAG_ANY + elif isinstance(value, str): + validate_etag_value(value) + self._headers[hdrs.ETAG] = f'"{value}"' + elif isinstance(value, ETag) and isinstance(value.value, str): + validate_etag_value(value.value) + hdr_value = f'W/"{value.value}"' if value.is_weak else f'"{value.value}"' + self._headers[hdrs.ETAG] = hdr_value + else: + raise ValueError( + f"Unsupported etag type: {type(value)}. " + f"etag must be str, ETag or None" + ) + + def _generate_content_type_header( + self, CONTENT_TYPE: istr = hdrs.CONTENT_TYPE + ) -> None: + assert self._content_dict is not None + assert self._content_type is not None + params = "; ".join(f"{k}={v}" for k, v in self._content_dict.items()) + if params: + ctype = self._content_type + "; " + params + else: + ctype = self._content_type + self._headers[CONTENT_TYPE] = ctype + + async def _do_start_compression(self, coding: ContentCoding) -> None: + if coding is ContentCoding.identity: + return + assert self._payload_writer is not None + self._headers[hdrs.CONTENT_ENCODING] = coding.value + self._payload_writer.enable_compression( + coding.value, self._compression_strategy + ) + # Compressed payload may have different content length, + # remove the header + self._headers.popall(hdrs.CONTENT_LENGTH, None) + + async def _start_compression(self, request: "BaseRequest") -> None: + if self._compression_force: + await self._do_start_compression(self._compression_force) + return + # Encoding comparisons should be case-insensitive + # https://www.rfc-editor.org/rfc/rfc9110#section-8.4.1 + accept_encoding = request.headers.get(hdrs.ACCEPT_ENCODING, "").lower() + for value, coding in CONTENT_CODINGS.items(): + if value in accept_encoding: + await self._do_start_compression(coding) + return + + async def prepare(self, request: "BaseRequest") -> Optional[AbstractStreamWriter]: + if self._eof_sent: + return None + if self._payload_writer is not None: + return self._payload_writer + self._must_be_empty_body = must_be_empty_body(request.method, self.status) + return await self._start(request) + + async def _start(self, request: "BaseRequest") -> AbstractStreamWriter: + self._req = request + writer = self._payload_writer = request._payload_writer + + await self._prepare_headers() + await request._prepare_hook(self) + await self._write_headers() + + return writer + + async def _prepare_headers(self) -> None: + request = self._req + assert request is not None + writer = self._payload_writer + assert writer is not None + keep_alive = self._keep_alive + if keep_alive is None: + keep_alive = request.keep_alive + self._keep_alive = keep_alive + + version = request.version + + headers = self._headers + if self._cookies: + for cookie in self._cookies.values(): + value = cookie.output(header="")[1:] + headers.add(hdrs.SET_COOKIE, value) + + if self._compression: + await self._start_compression(request) + + if self._chunked: + if version != HttpVersion11: + raise RuntimeError( + "Using chunked encoding is forbidden " + "for HTTP/{0.major}.{0.minor}".format(request.version) + ) + if not self._must_be_empty_body: + writer.enable_chunking() + headers[hdrs.TRANSFER_ENCODING] = "chunked" + elif self._length_check: # Disabled for WebSockets + writer.length = self.content_length + if writer.length is None: + if version >= HttpVersion11: + if not self._must_be_empty_body: + writer.enable_chunking() + headers[hdrs.TRANSFER_ENCODING] = "chunked" + elif not self._must_be_empty_body: + keep_alive = False + + # HTTP 1.1: https://tools.ietf.org/html/rfc7230#section-3.3.2 + # HTTP 1.0: https://tools.ietf.org/html/rfc1945#section-10.4 + if self._must_be_empty_body: + if hdrs.CONTENT_LENGTH in headers and should_remove_content_length( + request.method, self.status + ): + del headers[hdrs.CONTENT_LENGTH] + # https://datatracker.ietf.org/doc/html/rfc9112#section-6.1-10 + # https://datatracker.ietf.org/doc/html/rfc9112#section-6.1-13 + if hdrs.TRANSFER_ENCODING in headers: + del headers[hdrs.TRANSFER_ENCODING] + elif (writer.length if self._length_check else self.content_length) != 0: + # https://www.rfc-editor.org/rfc/rfc9110#section-8.3-5 + headers.setdefault(hdrs.CONTENT_TYPE, "application/octet-stream") + headers.setdefault(hdrs.DATE, rfc822_formatted_time()) + headers.setdefault(hdrs.SERVER, SERVER_SOFTWARE) + + # connection header + if hdrs.CONNECTION not in headers: + if keep_alive: + if version == HttpVersion10: + headers[hdrs.CONNECTION] = "keep-alive" + elif version == HttpVersion11: + headers[hdrs.CONNECTION] = "close" + + async def _write_headers(self) -> None: + request = self._req + assert request is not None + writer = self._payload_writer + assert writer is not None + # status line + version = request.version + status_line = f"HTTP/{version[0]}.{version[1]} {self._status} {self._reason}" + await writer.write_headers(status_line, self._headers) + # Send headers immediately if not opted into buffering + if self._send_headers_immediately: + writer.send_headers() + + async def write(self, data: Union[bytes, bytearray, memoryview]) -> None: + assert isinstance( + data, (bytes, bytearray, memoryview) + ), "data argument must be byte-ish (%r)" % type(data) + + if self._eof_sent: + raise RuntimeError("Cannot call write() after write_eof()") + if self._payload_writer is None: + raise RuntimeError("Cannot call write() before prepare()") + + await self._payload_writer.write(data) + + async def drain(self) -> None: + assert not self._eof_sent, "EOF has already been sent" + assert self._payload_writer is not None, "Response has not been started" + warnings.warn( + "drain method is deprecated, use await resp.write()", + DeprecationWarning, + stacklevel=2, + ) + await self._payload_writer.drain() + + async def write_eof(self, data: bytes = b"") -> None: + assert isinstance( + data, (bytes, bytearray, memoryview) + ), "data argument must be byte-ish (%r)" % type(data) + + if self._eof_sent: + return + + assert self._payload_writer is not None, "Response has not been started" + + await self._payload_writer.write_eof(data) + self._eof_sent = True + self._req = None + self._body_length = self._payload_writer.output_size + self._payload_writer = None + + def __repr__(self) -> str: + if self._eof_sent: + info = "eof" + elif self.prepared: + assert self._req is not None + info = f"{self._req.method} {self._req.path} " + else: + info = "not prepared" + return f"<{self.__class__.__name__} {self.reason} {info}>" + + def __getitem__(self, key: str) -> Any: + return self._state[key] + + def __setitem__(self, key: str, value: Any) -> None: + self._state[key] = value + + def __delitem__(self, key: str) -> None: + del self._state[key] + + def __len__(self) -> int: + return len(self._state) + + def __iter__(self) -> Iterator[str]: + return iter(self._state) + + def __hash__(self) -> int: + return hash(id(self)) + + def __eq__(self, other: object) -> bool: + return self is other + + def __bool__(self) -> bool: + return True + + +class Response(StreamResponse): + + _compressed_body: Optional[bytes] = None + _send_headers_immediately = False + + def __init__( + self, + *, + body: Any = None, + status: int = 200, + reason: Optional[str] = None, + text: Optional[str] = None, + headers: Optional[LooseHeaders] = None, + content_type: Optional[str] = None, + charset: Optional[str] = None, + zlib_executor_size: Optional[int] = None, + zlib_executor: Optional[Executor] = None, + ) -> None: + if body is not None and text is not None: + raise ValueError("body and text are not allowed together") + + if headers is None: + real_headers: CIMultiDict[str] = CIMultiDict() + else: + real_headers = CIMultiDict(headers) + + if content_type is not None and "charset" in content_type: + raise ValueError("charset must not be in content_type argument") + + if text is not None: + if hdrs.CONTENT_TYPE in real_headers: + if content_type or charset: + raise ValueError( + "passing both Content-Type header and " + "content_type or charset params " + "is forbidden" + ) + else: + # fast path for filling headers + if not isinstance(text, str): + raise TypeError("text argument must be str (%r)" % type(text)) + if content_type is None: + content_type = "text/plain" + if charset is None: + charset = "utf-8" + real_headers[hdrs.CONTENT_TYPE] = content_type + "; charset=" + charset + body = text.encode(charset) + text = None + elif hdrs.CONTENT_TYPE in real_headers: + if content_type is not None or charset is not None: + raise ValueError( + "passing both Content-Type header and " + "content_type or charset params " + "is forbidden" + ) + elif content_type is not None: + if charset is not None: + content_type += "; charset=" + charset + real_headers[hdrs.CONTENT_TYPE] = content_type + + super().__init__(status=status, reason=reason, _real_headers=real_headers) + + if text is not None: + self.text = text + else: + self.body = body + + self._zlib_executor_size = zlib_executor_size + self._zlib_executor = zlib_executor + + @property + def body(self) -> Optional[Union[bytes, Payload]]: + return self._body + + @body.setter + def body(self, body: Any) -> None: + if body is None: + self._body = None + elif isinstance(body, (bytes, bytearray)): + self._body = body + else: + try: + self._body = body = payload.PAYLOAD_REGISTRY.get(body) + except payload.LookupError: + raise ValueError("Unsupported body type %r" % type(body)) + + headers = self._headers + + # set content-type + if hdrs.CONTENT_TYPE not in headers: + headers[hdrs.CONTENT_TYPE] = body.content_type + + # copy payload headers + if body.headers: + for key, value in body.headers.items(): + if key not in headers: + headers[key] = value + + self._compressed_body = None + + @property + def text(self) -> Optional[str]: + if self._body is None: + return None + # Note: When _body is a Payload (e.g. FilePayload), this may do blocking I/O + # This is generally safe as most common payloads (BytesPayload, StringPayload) + # don't do blocking I/O, but be careful with file-based payloads + return self._body.decode(self.charset or "utf-8") + + @text.setter + def text(self, text: str) -> None: + assert text is None or isinstance( + text, str + ), "text argument must be str (%r)" % type(text) + + if self.content_type == "application/octet-stream": + self.content_type = "text/plain" + if self.charset is None: + self.charset = "utf-8" + + self._body = text.encode(self.charset) + self._compressed_body = None + + @property + def content_length(self) -> Optional[int]: + if self._chunked: + return None + + if hdrs.CONTENT_LENGTH in self._headers: + return int(self._headers[hdrs.CONTENT_LENGTH]) + + if self._compressed_body is not None: + # Return length of the compressed body + return len(self._compressed_body) + elif isinstance(self._body, Payload): + # A payload without content length, or a compressed payload + return None + elif self._body is not None: + return len(self._body) + else: + return 0 + + @content_length.setter + def content_length(self, value: Optional[int]) -> None: + raise RuntimeError("Content length is set automatically") + + async def write_eof(self, data: bytes = b"") -> None: + if self._eof_sent: + return + if self._compressed_body is None: + body: Optional[Union[bytes, Payload]] = self._body + else: + body = self._compressed_body + assert not data, f"data arg is not supported, got {data!r}" + assert self._req is not None + assert self._payload_writer is not None + if body is None or self._must_be_empty_body: + await super().write_eof() + elif isinstance(self._body, Payload): + await self._body.write(self._payload_writer) + await self._body.close() + await super().write_eof() + else: + await super().write_eof(cast(bytes, body)) + + async def _start(self, request: "BaseRequest") -> AbstractStreamWriter: + if hdrs.CONTENT_LENGTH in self._headers: + if should_remove_content_length(request.method, self.status): + del self._headers[hdrs.CONTENT_LENGTH] + elif not self._chunked: + if isinstance(self._body, Payload): + if (size := self._body.size) is not None: + self._headers[hdrs.CONTENT_LENGTH] = str(size) + else: + body_len = len(self._body) if self._body else "0" + # https://www.rfc-editor.org/rfc/rfc9110.html#section-8.6-7 + if body_len != "0" or ( + self.status != 304 and request.method not in hdrs.METH_HEAD_ALL + ): + self._headers[hdrs.CONTENT_LENGTH] = str(body_len) + + return await super()._start(request) + + async def _do_start_compression(self, coding: ContentCoding) -> None: + if self._chunked or isinstance(self._body, Payload): + return await super()._do_start_compression(coding) + if coding is ContentCoding.identity: + return + # Instead of using _payload_writer.enable_compression, + # compress the whole body + compressor = ZLibCompressor( + encoding=coding.value, + max_sync_chunk_size=self._zlib_executor_size, + executor=self._zlib_executor, + ) + assert self._body is not None + if self._zlib_executor_size is None and len(self._body) > LARGE_BODY_SIZE: + warnings.warn( + "Synchronous compression of large response bodies " + f"({len(self._body)} bytes) might block the async event loop. " + "Consider providing a custom value to zlib_executor_size/" + "zlib_executor response properties or disabling compression on it." + ) + self._compressed_body = ( + await compressor.compress(self._body) + compressor.flush() + ) + self._headers[hdrs.CONTENT_ENCODING] = coding.value + self._headers[hdrs.CONTENT_LENGTH] = str(len(self._compressed_body)) + + +def json_response( + data: Any = sentinel, + *, + text: Optional[str] = None, + body: Optional[bytes] = None, + status: int = 200, + reason: Optional[str] = None, + headers: Optional[LooseHeaders] = None, + content_type: str = "application/json", + dumps: JSONEncoder = json.dumps, +) -> Response: + if data is not sentinel: + if text or body: + raise ValueError("only one of data, text, or body should be specified") + else: + text = dumps(data) + return Response( + text=text, + body=body, + status=status, + reason=reason, + headers=headers, + content_type=content_type, + ) diff --git a/env/lib/python3.12/site-packages/aiohttp/web_routedef.py b/env/lib/python3.12/site-packages/aiohttp/web_routedef.py new file mode 100644 index 0000000..f51b6cd --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_routedef.py @@ -0,0 +1,214 @@ +import abc +import os # noqa +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + Iterator, + List, + Optional, + Sequence, + Type, + Union, + overload, +) + +import attr + +from . import hdrs +from .abc import AbstractView +from .typedefs import Handler, PathLike + +if TYPE_CHECKING: + from .web_request import Request + from .web_response import StreamResponse + from .web_urldispatcher import AbstractRoute, UrlDispatcher +else: + Request = StreamResponse = UrlDispatcher = AbstractRoute = None + + +__all__ = ( + "AbstractRouteDef", + "RouteDef", + "StaticDef", + "RouteTableDef", + "head", + "options", + "get", + "post", + "patch", + "put", + "delete", + "route", + "view", + "static", +) + + +class AbstractRouteDef(abc.ABC): + @abc.abstractmethod + def register(self, router: UrlDispatcher) -> List[AbstractRoute]: + pass # pragma: no cover + + +_HandlerType = Union[Type[AbstractView], Handler] + + +@attr.s(auto_attribs=True, frozen=True, repr=False, slots=True) +class RouteDef(AbstractRouteDef): + method: str + path: str + handler: _HandlerType + kwargs: Dict[str, Any] + + def __repr__(self) -> str: + info = [] + for name, value in sorted(self.kwargs.items()): + info.append(f", {name}={value!r}") + return " {handler.__name__!r}{info}>".format( + method=self.method, path=self.path, handler=self.handler, info="".join(info) + ) + + def register(self, router: UrlDispatcher) -> List[AbstractRoute]: + if self.method in hdrs.METH_ALL: + reg = getattr(router, "add_" + self.method.lower()) + return [reg(self.path, self.handler, **self.kwargs)] + else: + return [ + router.add_route(self.method, self.path, self.handler, **self.kwargs) + ] + + +@attr.s(auto_attribs=True, frozen=True, repr=False, slots=True) +class StaticDef(AbstractRouteDef): + prefix: str + path: PathLike + kwargs: Dict[str, Any] + + def __repr__(self) -> str: + info = [] + for name, value in sorted(self.kwargs.items()): + info.append(f", {name}={value!r}") + return " {path}{info}>".format( + prefix=self.prefix, path=self.path, info="".join(info) + ) + + def register(self, router: UrlDispatcher) -> List[AbstractRoute]: + resource = router.add_static(self.prefix, self.path, **self.kwargs) + routes = resource.get_info().get("routes", {}) + return list(routes.values()) + + +def route(method: str, path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return RouteDef(method, path, handler, kwargs) + + +def head(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return route(hdrs.METH_HEAD, path, handler, **kwargs) + + +def options(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return route(hdrs.METH_OPTIONS, path, handler, **kwargs) + + +def get( + path: str, + handler: _HandlerType, + *, + name: Optional[str] = None, + allow_head: bool = True, + **kwargs: Any, +) -> RouteDef: + return route( + hdrs.METH_GET, path, handler, name=name, allow_head=allow_head, **kwargs + ) + + +def post(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return route(hdrs.METH_POST, path, handler, **kwargs) + + +def put(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return route(hdrs.METH_PUT, path, handler, **kwargs) + + +def patch(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return route(hdrs.METH_PATCH, path, handler, **kwargs) + + +def delete(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return route(hdrs.METH_DELETE, path, handler, **kwargs) + + +def view(path: str, handler: Type[AbstractView], **kwargs: Any) -> RouteDef: + return route(hdrs.METH_ANY, path, handler, **kwargs) + + +def static(prefix: str, path: PathLike, **kwargs: Any) -> StaticDef: + return StaticDef(prefix, path, kwargs) + + +_Deco = Callable[[_HandlerType], _HandlerType] + + +class RouteTableDef(Sequence[AbstractRouteDef]): + """Route definition table""" + + def __init__(self) -> None: + self._items: List[AbstractRouteDef] = [] + + def __repr__(self) -> str: + return f"" + + @overload + def __getitem__(self, index: int) -> AbstractRouteDef: ... + + @overload + def __getitem__(self, index: slice) -> List[AbstractRouteDef]: ... + + def __getitem__(self, index): # type: ignore[no-untyped-def] + return self._items[index] + + def __iter__(self) -> Iterator[AbstractRouteDef]: + return iter(self._items) + + def __len__(self) -> int: + return len(self._items) + + def __contains__(self, item: object) -> bool: + return item in self._items + + def route(self, method: str, path: str, **kwargs: Any) -> _Deco: + def inner(handler: _HandlerType) -> _HandlerType: + self._items.append(RouteDef(method, path, handler, kwargs)) + return handler + + return inner + + def head(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_HEAD, path, **kwargs) + + def get(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_GET, path, **kwargs) + + def post(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_POST, path, **kwargs) + + def put(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_PUT, path, **kwargs) + + def patch(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_PATCH, path, **kwargs) + + def delete(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_DELETE, path, **kwargs) + + def options(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_OPTIONS, path, **kwargs) + + def view(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_ANY, path, **kwargs) + + def static(self, prefix: str, path: PathLike, **kwargs: Any) -> None: + self._items.append(StaticDef(prefix, path, kwargs)) diff --git a/env/lib/python3.12/site-packages/aiohttp/web_runner.py b/env/lib/python3.12/site-packages/aiohttp/web_runner.py new file mode 100644 index 0000000..bcfec72 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_runner.py @@ -0,0 +1,399 @@ +import asyncio +import signal +import socket +import warnings +from abc import ABC, abstractmethod +from typing import TYPE_CHECKING, Any, List, Optional, Set + +from yarl import URL + +from .typedefs import PathLike +from .web_app import Application +from .web_server import Server + +if TYPE_CHECKING: + from ssl import SSLContext +else: + try: + from ssl import SSLContext + except ImportError: # pragma: no cover + SSLContext = object # type: ignore[misc,assignment] + +__all__ = ( + "BaseSite", + "TCPSite", + "UnixSite", + "NamedPipeSite", + "SockSite", + "BaseRunner", + "AppRunner", + "ServerRunner", + "GracefulExit", +) + + +class GracefulExit(SystemExit): + code = 1 + + +def _raise_graceful_exit() -> None: + raise GracefulExit() + + +class BaseSite(ABC): + __slots__ = ("_runner", "_ssl_context", "_backlog", "_server") + + def __init__( + self, + runner: "BaseRunner", + *, + shutdown_timeout: float = 60.0, + ssl_context: Optional[SSLContext] = None, + backlog: int = 128, + ) -> None: + if runner.server is None: + raise RuntimeError("Call runner.setup() before making a site") + if shutdown_timeout != 60.0: + msg = "shutdown_timeout should be set on BaseRunner" + warnings.warn(msg, DeprecationWarning, stacklevel=2) + runner._shutdown_timeout = shutdown_timeout + self._runner = runner + self._ssl_context = ssl_context + self._backlog = backlog + self._server: Optional[asyncio.AbstractServer] = None + + @property + @abstractmethod + def name(self) -> str: + pass # pragma: no cover + + @abstractmethod + async def start(self) -> None: + self._runner._reg_site(self) + + async def stop(self) -> None: + self._runner._check_site(self) + if self._server is not None: # Maybe not started yet + self._server.close() + + self._runner._unreg_site(self) + + +class TCPSite(BaseSite): + __slots__ = ("_host", "_port", "_reuse_address", "_reuse_port") + + def __init__( + self, + runner: "BaseRunner", + host: Optional[str] = None, + port: Optional[int] = None, + *, + shutdown_timeout: float = 60.0, + ssl_context: Optional[SSLContext] = None, + backlog: int = 128, + reuse_address: Optional[bool] = None, + reuse_port: Optional[bool] = None, + ) -> None: + super().__init__( + runner, + shutdown_timeout=shutdown_timeout, + ssl_context=ssl_context, + backlog=backlog, + ) + self._host = host + if port is None: + port = 8443 if self._ssl_context else 8080 + self._port = port + self._reuse_address = reuse_address + self._reuse_port = reuse_port + + @property + def name(self) -> str: + scheme = "https" if self._ssl_context else "http" + host = "0.0.0.0" if not self._host else self._host + return str(URL.build(scheme=scheme, host=host, port=self._port)) + + async def start(self) -> None: + await super().start() + loop = asyncio.get_event_loop() + server = self._runner.server + assert server is not None + self._server = await loop.create_server( + server, + self._host, + self._port, + ssl=self._ssl_context, + backlog=self._backlog, + reuse_address=self._reuse_address, + reuse_port=self._reuse_port, + ) + + +class UnixSite(BaseSite): + __slots__ = ("_path",) + + def __init__( + self, + runner: "BaseRunner", + path: PathLike, + *, + shutdown_timeout: float = 60.0, + ssl_context: Optional[SSLContext] = None, + backlog: int = 128, + ) -> None: + super().__init__( + runner, + shutdown_timeout=shutdown_timeout, + ssl_context=ssl_context, + backlog=backlog, + ) + self._path = path + + @property + def name(self) -> str: + scheme = "https" if self._ssl_context else "http" + return f"{scheme}://unix:{self._path}:" + + async def start(self) -> None: + await super().start() + loop = asyncio.get_event_loop() + server = self._runner.server + assert server is not None + self._server = await loop.create_unix_server( + server, + self._path, + ssl=self._ssl_context, + backlog=self._backlog, + ) + + +class NamedPipeSite(BaseSite): + __slots__ = ("_path",) + + def __init__( + self, runner: "BaseRunner", path: str, *, shutdown_timeout: float = 60.0 + ) -> None: + loop = asyncio.get_event_loop() + if not isinstance( + loop, asyncio.ProactorEventLoop # type: ignore[attr-defined] + ): + raise RuntimeError( + "Named Pipes only available in proactor loop under windows" + ) + super().__init__(runner, shutdown_timeout=shutdown_timeout) + self._path = path + + @property + def name(self) -> str: + return self._path + + async def start(self) -> None: + await super().start() + loop = asyncio.get_event_loop() + server = self._runner.server + assert server is not None + _server = await loop.start_serving_pipe( # type: ignore[attr-defined] + server, self._path + ) + self._server = _server[0] + + +class SockSite(BaseSite): + __slots__ = ("_sock", "_name") + + def __init__( + self, + runner: "BaseRunner", + sock: socket.socket, + *, + shutdown_timeout: float = 60.0, + ssl_context: Optional[SSLContext] = None, + backlog: int = 128, + ) -> None: + super().__init__( + runner, + shutdown_timeout=shutdown_timeout, + ssl_context=ssl_context, + backlog=backlog, + ) + self._sock = sock + scheme = "https" if self._ssl_context else "http" + if hasattr(socket, "AF_UNIX") and sock.family == socket.AF_UNIX: + name = f"{scheme}://unix:{sock.getsockname()}:" + else: + host, port = sock.getsockname()[:2] + name = str(URL.build(scheme=scheme, host=host, port=port)) + self._name = name + + @property + def name(self) -> str: + return self._name + + async def start(self) -> None: + await super().start() + loop = asyncio.get_event_loop() + server = self._runner.server + assert server is not None + self._server = await loop.create_server( + server, sock=self._sock, ssl=self._ssl_context, backlog=self._backlog + ) + + +class BaseRunner(ABC): + __slots__ = ("_handle_signals", "_kwargs", "_server", "_sites", "_shutdown_timeout") + + def __init__( + self, + *, + handle_signals: bool = False, + shutdown_timeout: float = 60.0, + **kwargs: Any, + ) -> None: + self._handle_signals = handle_signals + self._kwargs = kwargs + self._server: Optional[Server] = None + self._sites: List[BaseSite] = [] + self._shutdown_timeout = shutdown_timeout + + @property + def server(self) -> Optional[Server]: + return self._server + + @property + def addresses(self) -> List[Any]: + ret: List[Any] = [] + for site in self._sites: + server = site._server + if server is not None: + sockets = server.sockets # type: ignore[attr-defined] + if sockets is not None: + for sock in sockets: + ret.append(sock.getsockname()) + return ret + + @property + def sites(self) -> Set[BaseSite]: + return set(self._sites) + + async def setup(self) -> None: + loop = asyncio.get_event_loop() + + if self._handle_signals: + try: + loop.add_signal_handler(signal.SIGINT, _raise_graceful_exit) + loop.add_signal_handler(signal.SIGTERM, _raise_graceful_exit) + except NotImplementedError: # pragma: no cover + # add_signal_handler is not implemented on Windows + pass + + self._server = await self._make_server() + + @abstractmethod + async def shutdown(self) -> None: + """Call any shutdown hooks to help server close gracefully.""" + + async def cleanup(self) -> None: + # The loop over sites is intentional, an exception on gather() + # leaves self._sites in unpredictable state. + # The loop guaranties that a site is either deleted on success or + # still present on failure + for site in list(self._sites): + await site.stop() + + if self._server: # If setup succeeded + # Yield to event loop to ensure incoming requests prior to stopping the sites + # have all started to be handled before we proceed to close idle connections. + await asyncio.sleep(0) + self._server.pre_shutdown() + await self.shutdown() + await self._server.shutdown(self._shutdown_timeout) + await self._cleanup_server() + + self._server = None + if self._handle_signals: + loop = asyncio.get_running_loop() + try: + loop.remove_signal_handler(signal.SIGINT) + loop.remove_signal_handler(signal.SIGTERM) + except NotImplementedError: # pragma: no cover + # remove_signal_handler is not implemented on Windows + pass + + @abstractmethod + async def _make_server(self) -> Server: + pass # pragma: no cover + + @abstractmethod + async def _cleanup_server(self) -> None: + pass # pragma: no cover + + def _reg_site(self, site: BaseSite) -> None: + if site in self._sites: + raise RuntimeError(f"Site {site} is already registered in runner {self}") + self._sites.append(site) + + def _check_site(self, site: BaseSite) -> None: + if site not in self._sites: + raise RuntimeError(f"Site {site} is not registered in runner {self}") + + def _unreg_site(self, site: BaseSite) -> None: + if site not in self._sites: + raise RuntimeError(f"Site {site} is not registered in runner {self}") + self._sites.remove(site) + + +class ServerRunner(BaseRunner): + """Low-level web server runner""" + + __slots__ = ("_web_server",) + + def __init__( + self, web_server: Server, *, handle_signals: bool = False, **kwargs: Any + ) -> None: + super().__init__(handle_signals=handle_signals, **kwargs) + self._web_server = web_server + + async def shutdown(self) -> None: + pass + + async def _make_server(self) -> Server: + return self._web_server + + async def _cleanup_server(self) -> None: + pass + + +class AppRunner(BaseRunner): + """Web Application runner""" + + __slots__ = ("_app",) + + def __init__( + self, app: Application, *, handle_signals: bool = False, **kwargs: Any + ) -> None: + super().__init__(handle_signals=handle_signals, **kwargs) + if not isinstance(app, Application): + raise TypeError( + "The first argument should be web.Application " + "instance, got {!r}".format(app) + ) + self._app = app + + @property + def app(self) -> Application: + return self._app + + async def shutdown(self) -> None: + await self._app.shutdown() + + async def _make_server(self) -> Server: + loop = asyncio.get_event_loop() + self._app._set_loop(loop) + self._app.on_startup.freeze() + await self._app.startup() + self._app.freeze() + + return self._app._make_handler(loop=loop, **self._kwargs) + + async def _cleanup_server(self) -> None: + await self._app.cleanup() diff --git a/env/lib/python3.12/site-packages/aiohttp/web_server.py b/env/lib/python3.12/site-packages/aiohttp/web_server.py new file mode 100644 index 0000000..328aca1 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_server.py @@ -0,0 +1,84 @@ +"""Low level HTTP server.""" + +import asyncio +from typing import Any, Awaitable, Callable, Dict, List, Optional # noqa + +from .abc import AbstractStreamWriter +from .http_parser import RawRequestMessage +from .streams import StreamReader +from .web_protocol import RequestHandler, _RequestFactory, _RequestHandler +from .web_request import BaseRequest + +__all__ = ("Server",) + + +class Server: + def __init__( + self, + handler: _RequestHandler, + *, + request_factory: Optional[_RequestFactory] = None, + handler_cancellation: bool = False, + loop: Optional[asyncio.AbstractEventLoop] = None, + **kwargs: Any, + ) -> None: + self._loop = loop or asyncio.get_running_loop() + self._connections: Dict[RequestHandler, asyncio.Transport] = {} + self._kwargs = kwargs + # requests_count is the number of requests being processed by the server + # for the lifetime of the server. + self.requests_count = 0 + self.request_handler = handler + self.request_factory = request_factory or self._make_request + self.handler_cancellation = handler_cancellation + + @property + def connections(self) -> List[RequestHandler]: + return list(self._connections.keys()) + + def connection_made( + self, handler: RequestHandler, transport: asyncio.Transport + ) -> None: + self._connections[handler] = transport + + def connection_lost( + self, handler: RequestHandler, exc: Optional[BaseException] = None + ) -> None: + if handler in self._connections: + if handler._task_handler: + handler._task_handler.add_done_callback( + lambda f: self._connections.pop(handler, None) + ) + else: + del self._connections[handler] + + def _make_request( + self, + message: RawRequestMessage, + payload: StreamReader, + protocol: RequestHandler, + writer: AbstractStreamWriter, + task: "asyncio.Task[None]", + ) -> BaseRequest: + return BaseRequest(message, payload, protocol, writer, task, self._loop) + + def pre_shutdown(self) -> None: + for conn in self._connections: + conn.close() + + async def shutdown(self, timeout: Optional[float] = None) -> None: + coros = (conn.shutdown(timeout) for conn in self._connections) + await asyncio.gather(*coros) + self._connections.clear() + + def __call__(self) -> RequestHandler: + try: + return RequestHandler(self, loop=self._loop, **self._kwargs) + except TypeError: + # Failsafe creation: remove all custom handler_args + kwargs = { + k: v + for k, v in self._kwargs.items() + if k in ["debug", "access_log_class"] + } + return RequestHandler(self, loop=self._loop, **kwargs) diff --git a/env/lib/python3.12/site-packages/aiohttp/web_urldispatcher.py b/env/lib/python3.12/site-packages/aiohttp/web_urldispatcher.py new file mode 100644 index 0000000..cfa57a3 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_urldispatcher.py @@ -0,0 +1,1305 @@ +import abc +import asyncio +import base64 +import functools +import hashlib +import html +import inspect +import keyword +import os +import platform +import re +import sys +import warnings +from functools import wraps +from pathlib import Path +from types import MappingProxyType +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Container, + Dict, + Final, + Generator, + Iterable, + Iterator, + List, + Mapping, + NoReturn, + Optional, + Pattern, + Set, + Sized, + Tuple, + Type, + TypedDict, + Union, + cast, +) + +from yarl import URL, __version__ as yarl_version + +from . import hdrs +from .abc import AbstractMatchInfo, AbstractRouter, AbstractView +from .helpers import DEBUG +from .http import HttpVersion11 +from .typedefs import Handler, PathLike +from .web_exceptions import ( + HTTPException, + HTTPExpectationFailed, + HTTPForbidden, + HTTPMethodNotAllowed, + HTTPNotFound, +) +from .web_fileresponse import FileResponse +from .web_request import Request +from .web_response import Response, StreamResponse +from .web_routedef import AbstractRouteDef + +__all__ = ( + "UrlDispatcher", + "UrlMappingMatchInfo", + "AbstractResource", + "Resource", + "PlainResource", + "DynamicResource", + "AbstractRoute", + "ResourceRoute", + "StaticResource", + "View", +) + + +if TYPE_CHECKING: + from .web_app import Application + + BaseDict = Dict[str, str] +else: + BaseDict = dict + +CIRCULAR_SYMLINK_ERROR = ( + (OSError,) + if sys.version_info < (3, 10) and sys.platform.startswith("win32") + else (RuntimeError,) if sys.version_info < (3, 13) else () +) + +YARL_VERSION: Final[Tuple[int, ...]] = tuple(map(int, yarl_version.split(".")[:2])) + +HTTP_METHOD_RE: Final[Pattern[str]] = re.compile( + r"^[0-9A-Za-z!#\$%&'\*\+\-\.\^_`\|~]+$" +) +ROUTE_RE: Final[Pattern[str]] = re.compile( + r"(\{[_a-zA-Z][^{}]*(?:\{[^{}]*\}[^{}]*)*\})" +) +PATH_SEP: Final[str] = re.escape("/") + +IS_WINDOWS: Final[bool] = platform.system() == "Windows" + +_ExpectHandler = Callable[[Request], Awaitable[Optional[StreamResponse]]] +_Resolve = Tuple[Optional["UrlMappingMatchInfo"], Set[str]] + +html_escape = functools.partial(html.escape, quote=True) + + +class _InfoDict(TypedDict, total=False): + path: str + + formatter: str + pattern: Pattern[str] + + directory: Path + prefix: str + routes: Mapping[str, "AbstractRoute"] + + app: "Application" + + domain: str + + rule: "AbstractRuleMatching" + + http_exception: HTTPException + + +class AbstractResource(Sized, Iterable["AbstractRoute"]): + def __init__(self, *, name: Optional[str] = None) -> None: + self._name = name + + @property + def name(self) -> Optional[str]: + return self._name + + @property + @abc.abstractmethod + def canonical(self) -> str: + """Exposes the resource's canonical path. + + For example '/foo/bar/{name}' + + """ + + @abc.abstractmethod # pragma: no branch + def url_for(self, **kwargs: str) -> URL: + """Construct url for resource with additional params.""" + + @abc.abstractmethod # pragma: no branch + async def resolve(self, request: Request) -> _Resolve: + """Resolve resource. + + Return (UrlMappingMatchInfo, allowed_methods) pair. + """ + + @abc.abstractmethod + def add_prefix(self, prefix: str) -> None: + """Add a prefix to processed URLs. + + Required for subapplications support. + """ + + @abc.abstractmethod + def get_info(self) -> _InfoDict: + """Return a dict with additional info useful for introspection""" + + def freeze(self) -> None: + pass + + @abc.abstractmethod + def raw_match(self, path: str) -> bool: + """Perform a raw match against path""" + + +class AbstractRoute(abc.ABC): + def __init__( + self, + method: str, + handler: Union[Handler, Type[AbstractView]], + *, + expect_handler: Optional[_ExpectHandler] = None, + resource: Optional[AbstractResource] = None, + ) -> None: + + if expect_handler is None: + expect_handler = _default_expect_handler + + assert inspect.iscoroutinefunction(expect_handler) or ( + sys.version_info < (3, 14) and asyncio.iscoroutinefunction(expect_handler) + ), f"Coroutine is expected, got {expect_handler!r}" + + method = method.upper() + if not HTTP_METHOD_RE.match(method): + raise ValueError(f"{method} is not allowed HTTP method") + + assert callable(handler), handler + if inspect.iscoroutinefunction(handler) or ( + sys.version_info < (3, 14) and asyncio.iscoroutinefunction(handler) + ): + pass + elif inspect.isgeneratorfunction(handler): + if TYPE_CHECKING: + assert False + warnings.warn( + "Bare generators are deprecated, use @coroutine wrapper", + DeprecationWarning, + ) + elif isinstance(handler, type) and issubclass(handler, AbstractView): + pass + else: + warnings.warn( + "Bare functions are deprecated, use async ones", DeprecationWarning + ) + + @wraps(handler) + async def handler_wrapper(request: Request) -> StreamResponse: + result = old_handler(request) # type: ignore[call-arg] + if asyncio.iscoroutine(result): + result = await result + assert isinstance(result, StreamResponse) + return result + + old_handler = handler + handler = handler_wrapper + + self._method = method + self._handler = handler + self._expect_handler = expect_handler + self._resource = resource + + @property + def method(self) -> str: + return self._method + + @property + def handler(self) -> Handler: + return self._handler + + @property + @abc.abstractmethod + def name(self) -> Optional[str]: + """Optional route's name, always equals to resource's name.""" + + @property + def resource(self) -> Optional[AbstractResource]: + return self._resource + + @abc.abstractmethod + def get_info(self) -> _InfoDict: + """Return a dict with additional info useful for introspection""" + + @abc.abstractmethod # pragma: no branch + def url_for(self, *args: str, **kwargs: str) -> URL: + """Construct url for route with additional params.""" + + async def handle_expect_header(self, request: Request) -> Optional[StreamResponse]: + return await self._expect_handler(request) + + +class UrlMappingMatchInfo(BaseDict, AbstractMatchInfo): + + __slots__ = ("_route", "_apps", "_current_app", "_frozen") + + def __init__(self, match_dict: Dict[str, str], route: AbstractRoute) -> None: + super().__init__(match_dict) + self._route = route + self._apps: List[Application] = [] + self._current_app: Optional[Application] = None + self._frozen = False + + @property + def handler(self) -> Handler: + return self._route.handler + + @property + def route(self) -> AbstractRoute: + return self._route + + @property + def expect_handler(self) -> _ExpectHandler: + return self._route.handle_expect_header + + @property + def http_exception(self) -> Optional[HTTPException]: + return None + + def get_info(self) -> _InfoDict: # type: ignore[override] + return self._route.get_info() + + @property + def apps(self) -> Tuple["Application", ...]: + return tuple(self._apps) + + def add_app(self, app: "Application") -> None: + if self._frozen: + raise RuntimeError("Cannot change apps stack after .freeze() call") + if self._current_app is None: + self._current_app = app + self._apps.insert(0, app) + + @property + def current_app(self) -> "Application": + app = self._current_app + assert app is not None + return app + + @current_app.setter + def current_app(self, app: "Application") -> None: + if DEBUG: # pragma: no cover + if app not in self._apps: + raise RuntimeError( + "Expected one of the following apps {!r}, got {!r}".format( + self._apps, app + ) + ) + self._current_app = app + + def freeze(self) -> None: + self._frozen = True + + def __repr__(self) -> str: + return f"" + + +class MatchInfoError(UrlMappingMatchInfo): + + __slots__ = ("_exception",) + + def __init__(self, http_exception: HTTPException) -> None: + self._exception = http_exception + super().__init__({}, SystemRoute(self._exception)) + + @property + def http_exception(self) -> HTTPException: + return self._exception + + def __repr__(self) -> str: + return "".format( + self._exception.status, self._exception.reason + ) + + +async def _default_expect_handler(request: Request) -> None: + """Default handler for Expect header. + + Just send "100 Continue" to client. + raise HTTPExpectationFailed if value of header is not "100-continue" + """ + expect = request.headers.get(hdrs.EXPECT, "") + if request.version == HttpVersion11: + if expect.lower() == "100-continue": + await request.writer.write(b"HTTP/1.1 100 Continue\r\n\r\n") + # Reset output_size as we haven't started the main body yet. + request.writer.output_size = 0 + else: + raise HTTPExpectationFailed(text="Unknown Expect: %s" % expect) + + +class Resource(AbstractResource): + def __init__(self, *, name: Optional[str] = None) -> None: + super().__init__(name=name) + self._routes: Dict[str, ResourceRoute] = {} + self._any_route: Optional[ResourceRoute] = None + self._allowed_methods: Set[str] = set() + + def add_route( + self, + method: str, + handler: Union[Type[AbstractView], Handler], + *, + expect_handler: Optional[_ExpectHandler] = None, + ) -> "ResourceRoute": + if route := self._routes.get(method, self._any_route): + raise RuntimeError( + "Added route will never be executed, " + f"method {route.method} is already " + "registered" + ) + + route_obj = ResourceRoute(method, handler, self, expect_handler=expect_handler) + self.register_route(route_obj) + return route_obj + + def register_route(self, route: "ResourceRoute") -> None: + assert isinstance( + route, ResourceRoute + ), f"Instance of Route class is required, got {route!r}" + if route.method == hdrs.METH_ANY: + self._any_route = route + self._allowed_methods.add(route.method) + self._routes[route.method] = route + + async def resolve(self, request: Request) -> _Resolve: + if (match_dict := self._match(request.rel_url.path_safe)) is None: + return None, set() + if route := self._routes.get(request.method, self._any_route): + return UrlMappingMatchInfo(match_dict, route), self._allowed_methods + return None, self._allowed_methods + + @abc.abstractmethod + def _match(self, path: str) -> Optional[Dict[str, str]]: + pass # pragma: no cover + + def __len__(self) -> int: + return len(self._routes) + + def __iter__(self) -> Iterator["ResourceRoute"]: + return iter(self._routes.values()) + + # TODO: implement all abstract methods + + +class PlainResource(Resource): + def __init__(self, path: str, *, name: Optional[str] = None) -> None: + super().__init__(name=name) + assert not path or path.startswith("/") + self._path = path + + @property + def canonical(self) -> str: + return self._path + + def freeze(self) -> None: + if not self._path: + self._path = "/" + + def add_prefix(self, prefix: str) -> None: + assert prefix.startswith("/") + assert not prefix.endswith("/") + assert len(prefix) > 1 + self._path = prefix + self._path + + def _match(self, path: str) -> Optional[Dict[str, str]]: + # string comparison is about 10 times faster than regexp matching + if self._path == path: + return {} + return None + + def raw_match(self, path: str) -> bool: + return self._path == path + + def get_info(self) -> _InfoDict: + return {"path": self._path} + + def url_for(self) -> URL: # type: ignore[override] + return URL.build(path=self._path, encoded=True) + + def __repr__(self) -> str: + name = "'" + self.name + "' " if self.name is not None else "" + return f"" + + +class DynamicResource(Resource): + + DYN = re.compile(r"\{(?P[_a-zA-Z][_a-zA-Z0-9]*)\}") + DYN_WITH_RE = re.compile(r"\{(?P[_a-zA-Z][_a-zA-Z0-9]*):(?P.+)\}") + GOOD = r"[^{}/]+" + + def __init__(self, path: str, *, name: Optional[str] = None) -> None: + super().__init__(name=name) + self._orig_path = path + pattern = "" + formatter = "" + for part in ROUTE_RE.split(path): + match = self.DYN.fullmatch(part) + if match: + pattern += "(?P<{}>{})".format(match.group("var"), self.GOOD) + formatter += "{" + match.group("var") + "}" + continue + + match = self.DYN_WITH_RE.fullmatch(part) + if match: + pattern += "(?P<{var}>{re})".format(**match.groupdict()) + formatter += "{" + match.group("var") + "}" + continue + + if "{" in part or "}" in part: + raise ValueError(f"Invalid path '{path}'['{part}']") + + part = _requote_path(part) + formatter += part + pattern += re.escape(part) + + try: + compiled = re.compile(pattern) + except re.error as exc: + raise ValueError(f"Bad pattern '{pattern}': {exc}") from None + assert compiled.pattern.startswith(PATH_SEP) + assert formatter.startswith("/") + self._pattern = compiled + self._formatter = formatter + + @property + def canonical(self) -> str: + return self._formatter + + def add_prefix(self, prefix: str) -> None: + assert prefix.startswith("/") + assert not prefix.endswith("/") + assert len(prefix) > 1 + self._pattern = re.compile(re.escape(prefix) + self._pattern.pattern) + self._formatter = prefix + self._formatter + + def _match(self, path: str) -> Optional[Dict[str, str]]: + match = self._pattern.fullmatch(path) + if match is None: + return None + return { + key: _unquote_path_safe(value) for key, value in match.groupdict().items() + } + + def raw_match(self, path: str) -> bool: + return self._orig_path == path + + def get_info(self) -> _InfoDict: + return {"formatter": self._formatter, "pattern": self._pattern} + + def url_for(self, **parts: str) -> URL: + url = self._formatter.format_map({k: _quote_path(v) for k, v in parts.items()}) + return URL.build(path=url, encoded=True) + + def __repr__(self) -> str: + name = "'" + self.name + "' " if self.name is not None else "" + return "".format( + name=name, formatter=self._formatter + ) + + +class PrefixResource(AbstractResource): + def __init__(self, prefix: str, *, name: Optional[str] = None) -> None: + assert not prefix or prefix.startswith("/"), prefix + assert prefix in ("", "/") or not prefix.endswith("/"), prefix + super().__init__(name=name) + self._prefix = _requote_path(prefix) + self._prefix2 = self._prefix + "/" + + @property + def canonical(self) -> str: + return self._prefix + + def add_prefix(self, prefix: str) -> None: + assert prefix.startswith("/") + assert not prefix.endswith("/") + assert len(prefix) > 1 + self._prefix = prefix + self._prefix + self._prefix2 = self._prefix + "/" + + def raw_match(self, prefix: str) -> bool: + return False + + # TODO: impl missing abstract methods + + +class StaticResource(PrefixResource): + VERSION_KEY = "v" + + def __init__( + self, + prefix: str, + directory: PathLike, + *, + name: Optional[str] = None, + expect_handler: Optional[_ExpectHandler] = None, + chunk_size: int = 256 * 1024, + show_index: bool = False, + follow_symlinks: bool = False, + append_version: bool = False, + ) -> None: + super().__init__(prefix, name=name) + try: + directory = Path(directory).expanduser().resolve(strict=True) + except FileNotFoundError as error: + raise ValueError(f"'{directory}' does not exist") from error + if not directory.is_dir(): + raise ValueError(f"'{directory}' is not a directory") + self._directory = directory + self._show_index = show_index + self._chunk_size = chunk_size + self._follow_symlinks = follow_symlinks + self._expect_handler = expect_handler + self._append_version = append_version + + self._routes = { + "GET": ResourceRoute( + "GET", self._handle, self, expect_handler=expect_handler + ), + "HEAD": ResourceRoute( + "HEAD", self._handle, self, expect_handler=expect_handler + ), + } + self._allowed_methods = set(self._routes) + + def url_for( # type: ignore[override] + self, + *, + filename: PathLike, + append_version: Optional[bool] = None, + ) -> URL: + if append_version is None: + append_version = self._append_version + filename = str(filename).lstrip("/") + + url = URL.build(path=self._prefix, encoded=True) + # filename is not encoded + if YARL_VERSION < (1, 6): + url = url / filename.replace("%", "%25") + else: + url = url / filename + + if append_version: + unresolved_path = self._directory.joinpath(filename) + try: + if self._follow_symlinks: + normalized_path = Path(os.path.normpath(unresolved_path)) + normalized_path.relative_to(self._directory) + filepath = normalized_path.resolve() + else: + filepath = unresolved_path.resolve() + filepath.relative_to(self._directory) + except (ValueError, FileNotFoundError): + # ValueError for case when path point to symlink + # with follow_symlinks is False + return url # relatively safe + if filepath.is_file(): + # TODO cache file content + # with file watcher for cache invalidation + with filepath.open("rb") as f: + file_bytes = f.read() + h = self._get_file_hash(file_bytes) + url = url.with_query({self.VERSION_KEY: h}) + return url + return url + + @staticmethod + def _get_file_hash(byte_array: bytes) -> str: + m = hashlib.sha256() # todo sha256 can be configurable param + m.update(byte_array) + b64 = base64.urlsafe_b64encode(m.digest()) + return b64.decode("ascii") + + def get_info(self) -> _InfoDict: + return { + "directory": self._directory, + "prefix": self._prefix, + "routes": self._routes, + } + + def set_options_route(self, handler: Handler) -> None: + if "OPTIONS" in self._routes: + raise RuntimeError("OPTIONS route was set already") + self._routes["OPTIONS"] = ResourceRoute( + "OPTIONS", handler, self, expect_handler=self._expect_handler + ) + self._allowed_methods.add("OPTIONS") + + async def resolve(self, request: Request) -> _Resolve: + path = request.rel_url.path_safe + method = request.method + # We normalise here to avoid matches that traverse below the static root. + # e.g. /static/../../../../home/user/webapp/static/ + norm_path = os.path.normpath(path) + if IS_WINDOWS: + norm_path = norm_path.replace("\\", "/") + if not norm_path.startswith(self._prefix2) and norm_path != self._prefix: + return None, set() + + allowed_methods = self._allowed_methods + if method not in allowed_methods: + return None, allowed_methods + + match_dict = {"filename": _unquote_path_safe(path[len(self._prefix) + 1 :])} + return (UrlMappingMatchInfo(match_dict, self._routes[method]), allowed_methods) + + def __len__(self) -> int: + return len(self._routes) + + def __iter__(self) -> Iterator[AbstractRoute]: + return iter(self._routes.values()) + + async def _handle(self, request: Request) -> StreamResponse: + filename = request.match_info["filename"] + unresolved_path = self._directory.joinpath(filename) + loop = asyncio.get_running_loop() + return await loop.run_in_executor( + None, self._resolve_path_to_response, unresolved_path + ) + + def _resolve_path_to_response(self, unresolved_path: Path) -> StreamResponse: + """Take the unresolved path and query the file system to form a response.""" + # Check for access outside the root directory. For follow symlinks, URI + # cannot traverse out, but symlinks can. Otherwise, no access outside + # root is permitted. + try: + if self._follow_symlinks: + normalized_path = Path(os.path.normpath(unresolved_path)) + normalized_path.relative_to(self._directory) + file_path = normalized_path.resolve() + else: + file_path = unresolved_path.resolve() + file_path.relative_to(self._directory) + except (ValueError, *CIRCULAR_SYMLINK_ERROR) as error: + # ValueError is raised for the relative check. Circular symlinks + # raise here on resolving for python < 3.13. + raise HTTPNotFound() from error + + # if path is a directory, return the contents if permitted. Note the + # directory check will raise if a segment is not readable. + try: + if file_path.is_dir(): + if self._show_index: + return Response( + text=self._directory_as_html(file_path), + content_type="text/html", + ) + else: + raise HTTPForbidden() + except PermissionError as error: + raise HTTPForbidden() from error + + # Return the file response, which handles all other checks. + return FileResponse(file_path, chunk_size=self._chunk_size) + + def _directory_as_html(self, dir_path: Path) -> str: + """returns directory's index as html.""" + assert dir_path.is_dir() + + relative_path_to_dir = dir_path.relative_to(self._directory).as_posix() + index_of = f"Index of /{html_escape(relative_path_to_dir)}" + h1 = f"

{index_of}

" + + index_list = [] + dir_index = dir_path.iterdir() + for _file in sorted(dir_index): + # show file url as relative to static path + rel_path = _file.relative_to(self._directory).as_posix() + quoted_file_url = _quote_path(f"{self._prefix}/{rel_path}") + + # if file is a directory, add '/' to the end of the name + if _file.is_dir(): + file_name = f"{_file.name}/" + else: + file_name = _file.name + + index_list.append( + f'' + ) + ul = "
    \n{}\n
".format("\n".join(index_list)) + body = f"\n{h1}\n{ul}\n" + + head_str = f"\n{index_of}\n" + html = f"\n{head_str}\n{body}\n" + + return html + + def __repr__(self) -> str: + name = "'" + self.name + "'" if self.name is not None else "" + return " {directory!r}>".format( + name=name, path=self._prefix, directory=self._directory + ) + + +class PrefixedSubAppResource(PrefixResource): + def __init__(self, prefix: str, app: "Application") -> None: + super().__init__(prefix) + self._app = app + self._add_prefix_to_resources(prefix) + + def add_prefix(self, prefix: str) -> None: + super().add_prefix(prefix) + self._add_prefix_to_resources(prefix) + + def _add_prefix_to_resources(self, prefix: str) -> None: + router = self._app.router + for resource in router.resources(): + # Since the canonical path of a resource is about + # to change, we need to unindex it and then reindex + router.unindex_resource(resource) + resource.add_prefix(prefix) + router.index_resource(resource) + + def url_for(self, *args: str, **kwargs: str) -> URL: + raise RuntimeError(".url_for() is not supported by sub-application root") + + def get_info(self) -> _InfoDict: + return {"app": self._app, "prefix": self._prefix} + + async def resolve(self, request: Request) -> _Resolve: + match_info = await self._app.router.resolve(request) + match_info.add_app(self._app) + if isinstance(match_info.http_exception, HTTPMethodNotAllowed): + methods = match_info.http_exception.allowed_methods + else: + methods = set() + return match_info, methods + + def __len__(self) -> int: + return len(self._app.router.routes()) + + def __iter__(self) -> Iterator[AbstractRoute]: + return iter(self._app.router.routes()) + + def __repr__(self) -> str: + return " {app!r}>".format( + prefix=self._prefix, app=self._app + ) + + +class AbstractRuleMatching(abc.ABC): + @abc.abstractmethod # pragma: no branch + async def match(self, request: Request) -> bool: + """Return bool if the request satisfies the criteria""" + + @abc.abstractmethod # pragma: no branch + def get_info(self) -> _InfoDict: + """Return a dict with additional info useful for introspection""" + + @property + @abc.abstractmethod # pragma: no branch + def canonical(self) -> str: + """Return a str""" + + +class Domain(AbstractRuleMatching): + re_part = re.compile(r"(?!-)[a-z\d-]{1,63}(? None: + super().__init__() + self._domain = self.validation(domain) + + @property + def canonical(self) -> str: + return self._domain + + def validation(self, domain: str) -> str: + if not isinstance(domain, str): + raise TypeError("Domain must be str") + domain = domain.rstrip(".").lower() + if not domain: + raise ValueError("Domain cannot be empty") + elif "://" in domain: + raise ValueError("Scheme not supported") + url = URL("http://" + domain) + assert url.raw_host is not None + if not all(self.re_part.fullmatch(x) for x in url.raw_host.split(".")): + raise ValueError("Domain not valid") + if url.port == 80: + return url.raw_host + return f"{url.raw_host}:{url.port}" + + async def match(self, request: Request) -> bool: + host = request.headers.get(hdrs.HOST) + if not host: + return False + return self.match_domain(host) + + def match_domain(self, host: str) -> bool: + return host.lower() == self._domain + + def get_info(self) -> _InfoDict: + return {"domain": self._domain} + + +class MaskDomain(Domain): + re_part = re.compile(r"(?!-)[a-z\d\*-]{1,63}(? None: + super().__init__(domain) + mask = self._domain.replace(".", r"\.").replace("*", ".*") + self._mask = re.compile(mask) + + @property + def canonical(self) -> str: + return self._mask.pattern + + def match_domain(self, host: str) -> bool: + return self._mask.fullmatch(host) is not None + + +class MatchedSubAppResource(PrefixedSubAppResource): + def __init__(self, rule: AbstractRuleMatching, app: "Application") -> None: + AbstractResource.__init__(self) + self._prefix = "" + self._app = app + self._rule = rule + + @property + def canonical(self) -> str: + return self._rule.canonical + + def get_info(self) -> _InfoDict: + return {"app": self._app, "rule": self._rule} + + async def resolve(self, request: Request) -> _Resolve: + if not await self._rule.match(request): + return None, set() + match_info = await self._app.router.resolve(request) + match_info.add_app(self._app) + if isinstance(match_info.http_exception, HTTPMethodNotAllowed): + methods = match_info.http_exception.allowed_methods + else: + methods = set() + return match_info, methods + + def __repr__(self) -> str: + return f" {self._app!r}>" + + +class ResourceRoute(AbstractRoute): + """A route with resource""" + + def __init__( + self, + method: str, + handler: Union[Handler, Type[AbstractView]], + resource: AbstractResource, + *, + expect_handler: Optional[_ExpectHandler] = None, + ) -> None: + super().__init__( + method, handler, expect_handler=expect_handler, resource=resource + ) + + def __repr__(self) -> str: + return " {handler!r}".format( + method=self.method, resource=self._resource, handler=self.handler + ) + + @property + def name(self) -> Optional[str]: + if self._resource is None: + return None + return self._resource.name + + def url_for(self, *args: str, **kwargs: str) -> URL: + """Construct url for route with additional params.""" + assert self._resource is not None + return self._resource.url_for(*args, **kwargs) + + def get_info(self) -> _InfoDict: + assert self._resource is not None + return self._resource.get_info() + + +class SystemRoute(AbstractRoute): + def __init__(self, http_exception: HTTPException) -> None: + super().__init__(hdrs.METH_ANY, self._handle) + self._http_exception = http_exception + + def url_for(self, *args: str, **kwargs: str) -> URL: + raise RuntimeError(".url_for() is not allowed for SystemRoute") + + @property + def name(self) -> Optional[str]: + return None + + def get_info(self) -> _InfoDict: + return {"http_exception": self._http_exception} + + async def _handle(self, request: Request) -> StreamResponse: + raise self._http_exception + + @property + def status(self) -> int: + return self._http_exception.status + + @property + def reason(self) -> str: + return self._http_exception.reason + + def __repr__(self) -> str: + return "".format(self=self) + + +class View(AbstractView): + async def _iter(self) -> StreamResponse: + if self.request.method not in hdrs.METH_ALL: + self._raise_allowed_methods() + method: Optional[Callable[[], Awaitable[StreamResponse]]] + method = getattr(self, self.request.method.lower(), None) + if method is None: + self._raise_allowed_methods() + ret = await method() + assert isinstance(ret, StreamResponse) + return ret + + def __await__(self) -> Generator[None, None, StreamResponse]: + return self._iter().__await__() + + def _raise_allowed_methods(self) -> NoReturn: + allowed_methods = {m for m in hdrs.METH_ALL if hasattr(self, m.lower())} + raise HTTPMethodNotAllowed(self.request.method, allowed_methods) + + +class ResourcesView(Sized, Iterable[AbstractResource], Container[AbstractResource]): + def __init__(self, resources: List[AbstractResource]) -> None: + self._resources = resources + + def __len__(self) -> int: + return len(self._resources) + + def __iter__(self) -> Iterator[AbstractResource]: + yield from self._resources + + def __contains__(self, resource: object) -> bool: + return resource in self._resources + + +class RoutesView(Sized, Iterable[AbstractRoute], Container[AbstractRoute]): + def __init__(self, resources: List[AbstractResource]): + self._routes: List[AbstractRoute] = [] + for resource in resources: + for route in resource: + self._routes.append(route) + + def __len__(self) -> int: + return len(self._routes) + + def __iter__(self) -> Iterator[AbstractRoute]: + yield from self._routes + + def __contains__(self, route: object) -> bool: + return route in self._routes + + +class UrlDispatcher(AbstractRouter, Mapping[str, AbstractResource]): + + NAME_SPLIT_RE = re.compile(r"[.:-]") + + def __init__(self) -> None: + super().__init__() + self._resources: List[AbstractResource] = [] + self._named_resources: Dict[str, AbstractResource] = {} + self._resource_index: dict[str, list[AbstractResource]] = {} + self._matched_sub_app_resources: List[MatchedSubAppResource] = [] + + async def resolve(self, request: Request) -> UrlMappingMatchInfo: + resource_index = self._resource_index + allowed_methods: Set[str] = set() + + # MatchedSubAppResource is primarily used to match on domain names + # (though custom rules could match on other things). This means that + # the traversal algorithm below can't be applied, and that we likely + # need to check these first so a sub app that defines the same path + # as a parent app will get priority if there's a domain match. + # + # For most cases we do not expect there to be many of these since + # currently they are only added by `.add_domain()`. + for resource in self._matched_sub_app_resources: + match_dict, allowed = await resource.resolve(request) + if match_dict is not None: + return match_dict + else: + allowed_methods |= allowed + + # Walk the url parts looking for candidates. We walk the url backwards + # to ensure the most explicit match is found first. If there are multiple + # candidates for a given url part because there are multiple resources + # registered for the same canonical path, we resolve them in a linear + # fashion to ensure registration order is respected. + url_part = request.rel_url.path_safe + while url_part: + for candidate in resource_index.get(url_part, ()): + match_dict, allowed = await candidate.resolve(request) + if match_dict is not None: + return match_dict + else: + allowed_methods |= allowed + if url_part == "/": + break + url_part = url_part.rpartition("/")[0] or "/" + + if allowed_methods: + return MatchInfoError(HTTPMethodNotAllowed(request.method, allowed_methods)) + + return MatchInfoError(HTTPNotFound()) + + def __iter__(self) -> Iterator[str]: + return iter(self._named_resources) + + def __len__(self) -> int: + return len(self._named_resources) + + def __contains__(self, resource: object) -> bool: + return resource in self._named_resources + + def __getitem__(self, name: str) -> AbstractResource: + return self._named_resources[name] + + def resources(self) -> ResourcesView: + return ResourcesView(self._resources) + + def routes(self) -> RoutesView: + return RoutesView(self._resources) + + def named_resources(self) -> Mapping[str, AbstractResource]: + return MappingProxyType(self._named_resources) + + def register_resource(self, resource: AbstractResource) -> None: + assert isinstance( + resource, AbstractResource + ), f"Instance of AbstractResource class is required, got {resource!r}" + if self.frozen: + raise RuntimeError("Cannot register a resource into frozen router.") + + name = resource.name + + if name is not None: + parts = self.NAME_SPLIT_RE.split(name) + for part in parts: + if keyword.iskeyword(part): + raise ValueError( + f"Incorrect route name {name!r}, " + "python keywords cannot be used " + "for route name" + ) + if not part.isidentifier(): + raise ValueError( + "Incorrect route name {!r}, " + "the name should be a sequence of " + "python identifiers separated " + "by dash, dot or column".format(name) + ) + if name in self._named_resources: + raise ValueError( + "Duplicate {!r}, " + "already handled by {!r}".format(name, self._named_resources[name]) + ) + self._named_resources[name] = resource + self._resources.append(resource) + + if isinstance(resource, MatchedSubAppResource): + # We cannot index match sub-app resources because they have match rules + self._matched_sub_app_resources.append(resource) + else: + self.index_resource(resource) + + def _get_resource_index_key(self, resource: AbstractResource) -> str: + """Return a key to index the resource in the resource index.""" + if "{" in (index_key := resource.canonical): + # strip at the first { to allow for variables, and than + # rpartition at / to allow for variable parts in the path + # For example if the canonical path is `/core/locations{tail:.*}` + # the index key will be `/core` since index is based on the + # url parts split by `/` + index_key = index_key.partition("{")[0].rpartition("/")[0] + return index_key.rstrip("/") or "/" + + def index_resource(self, resource: AbstractResource) -> None: + """Add a resource to the resource index.""" + resource_key = self._get_resource_index_key(resource) + # There may be multiple resources for a canonical path + # so we keep them in a list to ensure that registration + # order is respected. + self._resource_index.setdefault(resource_key, []).append(resource) + + def unindex_resource(self, resource: AbstractResource) -> None: + """Remove a resource from the resource index.""" + resource_key = self._get_resource_index_key(resource) + self._resource_index[resource_key].remove(resource) + + def add_resource(self, path: str, *, name: Optional[str] = None) -> Resource: + if path and not path.startswith("/"): + raise ValueError("path should be started with / or be empty") + # Reuse last added resource if path and name are the same + if self._resources: + resource = self._resources[-1] + if resource.name == name and resource.raw_match(path): + return cast(Resource, resource) + if not ("{" in path or "}" in path or ROUTE_RE.search(path)): + resource = PlainResource(path, name=name) + self.register_resource(resource) + return resource + resource = DynamicResource(path, name=name) + self.register_resource(resource) + return resource + + def add_route( + self, + method: str, + path: str, + handler: Union[Handler, Type[AbstractView]], + *, + name: Optional[str] = None, + expect_handler: Optional[_ExpectHandler] = None, + ) -> AbstractRoute: + resource = self.add_resource(path, name=name) + return resource.add_route(method, handler, expect_handler=expect_handler) + + def add_static( + self, + prefix: str, + path: PathLike, + *, + name: Optional[str] = None, + expect_handler: Optional[_ExpectHandler] = None, + chunk_size: int = 256 * 1024, + show_index: bool = False, + follow_symlinks: bool = False, + append_version: bool = False, + ) -> AbstractResource: + """Add static files view. + + prefix - url prefix + path - folder with files + + """ + assert prefix.startswith("/") + if prefix.endswith("/"): + prefix = prefix[:-1] + resource = StaticResource( + prefix, + path, + name=name, + expect_handler=expect_handler, + chunk_size=chunk_size, + show_index=show_index, + follow_symlinks=follow_symlinks, + append_version=append_version, + ) + self.register_resource(resource) + return resource + + def add_head(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute: + """Shortcut for add_route with method HEAD.""" + return self.add_route(hdrs.METH_HEAD, path, handler, **kwargs) + + def add_options(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute: + """Shortcut for add_route with method OPTIONS.""" + return self.add_route(hdrs.METH_OPTIONS, path, handler, **kwargs) + + def add_get( + self, + path: str, + handler: Handler, + *, + name: Optional[str] = None, + allow_head: bool = True, + **kwargs: Any, + ) -> AbstractRoute: + """Shortcut for add_route with method GET. + + If allow_head is true, another + route is added allowing head requests to the same endpoint. + """ + resource = self.add_resource(path, name=name) + if allow_head: + resource.add_route(hdrs.METH_HEAD, handler, **kwargs) + return resource.add_route(hdrs.METH_GET, handler, **kwargs) + + def add_post(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute: + """Shortcut for add_route with method POST.""" + return self.add_route(hdrs.METH_POST, path, handler, **kwargs) + + def add_put(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute: + """Shortcut for add_route with method PUT.""" + return self.add_route(hdrs.METH_PUT, path, handler, **kwargs) + + def add_patch(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute: + """Shortcut for add_route with method PATCH.""" + return self.add_route(hdrs.METH_PATCH, path, handler, **kwargs) + + def add_delete(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute: + """Shortcut for add_route with method DELETE.""" + return self.add_route(hdrs.METH_DELETE, path, handler, **kwargs) + + def add_view( + self, path: str, handler: Type[AbstractView], **kwargs: Any + ) -> AbstractRoute: + """Shortcut for add_route with ANY methods for a class-based view.""" + return self.add_route(hdrs.METH_ANY, path, handler, **kwargs) + + def freeze(self) -> None: + super().freeze() + for resource in self._resources: + resource.freeze() + + def add_routes(self, routes: Iterable[AbstractRouteDef]) -> List[AbstractRoute]: + """Append routes to route table. + + Parameter should be a sequence of RouteDef objects. + + Returns a list of registered AbstractRoute instances. + """ + registered_routes = [] + for route_def in routes: + registered_routes.extend(route_def.register(self)) + return registered_routes + + +def _quote_path(value: str) -> str: + if YARL_VERSION < (1, 6): + value = value.replace("%", "%25") + return URL.build(path=value, encoded=False).raw_path + + +def _unquote_path_safe(value: str) -> str: + if "%" not in value: + return value + return value.replace("%2F", "/").replace("%25", "%") + + +def _requote_path(value: str) -> str: + # Quote non-ascii characters and other characters which must be quoted, + # but preserve existing %-sequences. + result = _quote_path(value) + if "%" in value: + result = result.replace("%25", "%") + return result diff --git a/env/lib/python3.12/site-packages/aiohttp/web_ws.py b/env/lib/python3.12/site-packages/aiohttp/web_ws.py new file mode 100644 index 0000000..575f9a3 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/web_ws.py @@ -0,0 +1,631 @@ +import asyncio +import base64 +import binascii +import hashlib +import json +import sys +from typing import Any, Final, Iterable, Optional, Tuple, Union, cast + +import attr +from multidict import CIMultiDict + +from . import hdrs +from ._websocket.reader import WebSocketDataQueue +from ._websocket.writer import DEFAULT_LIMIT +from .abc import AbstractStreamWriter +from .client_exceptions import WSMessageTypeError +from .helpers import calculate_timeout_when, set_exception, set_result +from .http import ( + WS_CLOSED_MESSAGE, + WS_CLOSING_MESSAGE, + WS_KEY, + WebSocketError, + WebSocketReader, + WebSocketWriter, + WSCloseCode, + WSMessage, + WSMsgType as WSMsgType, + ws_ext_gen, + ws_ext_parse, +) +from .http_websocket import _INTERNAL_RECEIVE_TYPES +from .log import ws_logger +from .streams import EofStream +from .typedefs import JSONDecoder, JSONEncoder +from .web_exceptions import HTTPBadRequest, HTTPException +from .web_request import BaseRequest +from .web_response import StreamResponse + +if sys.version_info >= (3, 11): + import asyncio as async_timeout +else: + import async_timeout + +__all__ = ( + "WebSocketResponse", + "WebSocketReady", + "WSMsgType", +) + +THRESHOLD_CONNLOST_ACCESS: Final[int] = 5 + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class WebSocketReady: + ok: bool + protocol: Optional[str] + + def __bool__(self) -> bool: + return self.ok + + +class WebSocketResponse(StreamResponse): + + _length_check: bool = False + _ws_protocol: Optional[str] = None + _writer: Optional[WebSocketWriter] = None + _reader: Optional[WebSocketDataQueue] = None + _closed: bool = False + _closing: bool = False + _conn_lost: int = 0 + _close_code: Optional[int] = None + _loop: Optional[asyncio.AbstractEventLoop] = None + _waiting: bool = False + _close_wait: Optional[asyncio.Future[None]] = None + _exception: Optional[BaseException] = None + _heartbeat_when: float = 0.0 + _heartbeat_cb: Optional[asyncio.TimerHandle] = None + _pong_response_cb: Optional[asyncio.TimerHandle] = None + _ping_task: Optional[asyncio.Task[None]] = None + + def __init__( + self, + *, + timeout: float = 10.0, + receive_timeout: Optional[float] = None, + autoclose: bool = True, + autoping: bool = True, + heartbeat: Optional[float] = None, + protocols: Iterable[str] = (), + compress: bool = True, + max_msg_size: int = 4 * 1024 * 1024, + writer_limit: int = DEFAULT_LIMIT, + ) -> None: + super().__init__(status=101) + self._protocols = protocols + self._timeout = timeout + self._receive_timeout = receive_timeout + self._autoclose = autoclose + self._autoping = autoping + self._heartbeat = heartbeat + if heartbeat is not None: + self._pong_heartbeat = heartbeat / 2.0 + self._compress: Union[bool, int] = compress + self._max_msg_size = max_msg_size + self._writer_limit = writer_limit + + def _cancel_heartbeat(self) -> None: + self._cancel_pong_response_cb() + if self._heartbeat_cb is not None: + self._heartbeat_cb.cancel() + self._heartbeat_cb = None + if self._ping_task is not None: + self._ping_task.cancel() + self._ping_task = None + + def _cancel_pong_response_cb(self) -> None: + if self._pong_response_cb is not None: + self._pong_response_cb.cancel() + self._pong_response_cb = None + + def _reset_heartbeat(self) -> None: + if self._heartbeat is None: + return + self._cancel_pong_response_cb() + req = self._req + timeout_ceil_threshold = ( + req._protocol._timeout_ceil_threshold if req is not None else 5 + ) + loop = self._loop + assert loop is not None + now = loop.time() + when = calculate_timeout_when(now, self._heartbeat, timeout_ceil_threshold) + self._heartbeat_when = when + if self._heartbeat_cb is None: + # We do not cancel the previous heartbeat_cb here because + # it generates a significant amount of TimerHandle churn + # which causes asyncio to rebuild the heap frequently. + # Instead _send_heartbeat() will reschedule the next + # heartbeat if it fires too early. + self._heartbeat_cb = loop.call_at(when, self._send_heartbeat) + + def _send_heartbeat(self) -> None: + self._heartbeat_cb = None + loop = self._loop + assert loop is not None and self._writer is not None + now = loop.time() + if now < self._heartbeat_when: + # Heartbeat fired too early, reschedule + self._heartbeat_cb = loop.call_at( + self._heartbeat_when, self._send_heartbeat + ) + return + + req = self._req + timeout_ceil_threshold = ( + req._protocol._timeout_ceil_threshold if req is not None else 5 + ) + when = calculate_timeout_when(now, self._pong_heartbeat, timeout_ceil_threshold) + self._cancel_pong_response_cb() + self._pong_response_cb = loop.call_at(when, self._pong_not_received) + + coro = self._writer.send_frame(b"", WSMsgType.PING) + if sys.version_info >= (3, 12): + # Optimization for Python 3.12, try to send the ping + # immediately to avoid having to schedule + # the task on the event loop. + ping_task = asyncio.Task(coro, loop=loop, eager_start=True) + else: + ping_task = loop.create_task(coro) + + if not ping_task.done(): + self._ping_task = ping_task + ping_task.add_done_callback(self._ping_task_done) + else: + self._ping_task_done(ping_task) + + def _ping_task_done(self, task: "asyncio.Task[None]") -> None: + """Callback for when the ping task completes.""" + if not task.cancelled() and (exc := task.exception()): + self._handle_ping_pong_exception(exc) + self._ping_task = None + + def _pong_not_received(self) -> None: + if self._req is not None and self._req.transport is not None: + self._handle_ping_pong_exception( + asyncio.TimeoutError( + f"No PONG received after {self._pong_heartbeat} seconds" + ) + ) + + def _handle_ping_pong_exception(self, exc: BaseException) -> None: + """Handle exceptions raised during ping/pong processing.""" + if self._closed: + return + self._set_closed() + self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE) + self._exception = exc + if self._waiting and not self._closing and self._reader is not None: + self._reader.feed_data(WSMessage(WSMsgType.ERROR, exc, None), 0) + + def _set_closed(self) -> None: + """Set the connection to closed. + + Cancel any heartbeat timers and set the closed flag. + """ + self._closed = True + self._cancel_heartbeat() + + async def prepare(self, request: BaseRequest) -> AbstractStreamWriter: + # make pre-check to don't hide it by do_handshake() exceptions + if self._payload_writer is not None: + return self._payload_writer + + protocol, writer = self._pre_start(request) + payload_writer = await super().prepare(request) + assert payload_writer is not None + self._post_start(request, protocol, writer) + await payload_writer.drain() + return payload_writer + + def _handshake( + self, request: BaseRequest + ) -> Tuple["CIMultiDict[str]", Optional[str], int, bool]: + headers = request.headers + if "websocket" != headers.get(hdrs.UPGRADE, "").lower().strip(): + raise HTTPBadRequest( + text=( + "No WebSocket UPGRADE hdr: {}\n Can " + '"Upgrade" only to "WebSocket".' + ).format(headers.get(hdrs.UPGRADE)) + ) + + if "upgrade" not in headers.get(hdrs.CONNECTION, "").lower(): + raise HTTPBadRequest( + text="No CONNECTION upgrade hdr: {}".format( + headers.get(hdrs.CONNECTION) + ) + ) + + # find common sub-protocol between client and server + protocol: Optional[str] = None + if hdrs.SEC_WEBSOCKET_PROTOCOL in headers: + req_protocols = [ + str(proto.strip()) + for proto in headers[hdrs.SEC_WEBSOCKET_PROTOCOL].split(",") + ] + + for proto in req_protocols: + if proto in self._protocols: + protocol = proto + break + else: + # No overlap found: Return no protocol as per spec + ws_logger.warning( + "%s: Client protocols %r don’t overlap server-known ones %r", + request.remote, + req_protocols, + self._protocols, + ) + + # check supported version + version = headers.get(hdrs.SEC_WEBSOCKET_VERSION, "") + if version not in ("13", "8", "7"): + raise HTTPBadRequest(text=f"Unsupported version: {version}") + + # check client handshake for validity + key = headers.get(hdrs.SEC_WEBSOCKET_KEY) + try: + if not key or len(base64.b64decode(key)) != 16: + raise HTTPBadRequest(text=f"Handshake error: {key!r}") + except binascii.Error: + raise HTTPBadRequest(text=f"Handshake error: {key!r}") from None + + accept_val = base64.b64encode( + hashlib.sha1(key.encode() + WS_KEY).digest() + ).decode() + response_headers = CIMultiDict( + { + hdrs.UPGRADE: "websocket", + hdrs.CONNECTION: "upgrade", + hdrs.SEC_WEBSOCKET_ACCEPT: accept_val, + } + ) + + notakeover = False + compress = 0 + if self._compress: + extensions = headers.get(hdrs.SEC_WEBSOCKET_EXTENSIONS) + # Server side always get return with no exception. + # If something happened, just drop compress extension + compress, notakeover = ws_ext_parse(extensions, isserver=True) + if compress: + enabledext = ws_ext_gen( + compress=compress, isserver=True, server_notakeover=notakeover + ) + response_headers[hdrs.SEC_WEBSOCKET_EXTENSIONS] = enabledext + + if protocol: + response_headers[hdrs.SEC_WEBSOCKET_PROTOCOL] = protocol + return ( + response_headers, + protocol, + compress, + notakeover, + ) + + def _pre_start(self, request: BaseRequest) -> Tuple[Optional[str], WebSocketWriter]: + self._loop = request._loop + + headers, protocol, compress, notakeover = self._handshake(request) + + self.set_status(101) + self.headers.update(headers) + self.force_close() + self._compress = compress + transport = request._protocol.transport + assert transport is not None + writer = WebSocketWriter( + request._protocol, + transport, + compress=compress, + notakeover=notakeover, + limit=self._writer_limit, + ) + + return protocol, writer + + def _post_start( + self, request: BaseRequest, protocol: Optional[str], writer: WebSocketWriter + ) -> None: + self._ws_protocol = protocol + self._writer = writer + + self._reset_heartbeat() + + loop = self._loop + assert loop is not None + self._reader = WebSocketDataQueue(request._protocol, 2**16, loop=loop) + request.protocol.set_parser( + WebSocketReader( + self._reader, self._max_msg_size, compress=bool(self._compress) + ) + ) + # disable HTTP keepalive for WebSocket + request.protocol.keep_alive(False) + + def can_prepare(self, request: BaseRequest) -> WebSocketReady: + if self._writer is not None: + raise RuntimeError("Already started") + try: + _, protocol, _, _ = self._handshake(request) + except HTTPException: + return WebSocketReady(False, None) + else: + return WebSocketReady(True, protocol) + + @property + def prepared(self) -> bool: + return self._writer is not None + + @property + def closed(self) -> bool: + return self._closed + + @property + def close_code(self) -> Optional[int]: + return self._close_code + + @property + def ws_protocol(self) -> Optional[str]: + return self._ws_protocol + + @property + def compress(self) -> Union[int, bool]: + return self._compress + + def get_extra_info(self, name: str, default: Any = None) -> Any: + """Get optional transport information. + + If no value associated with ``name`` is found, ``default`` is returned. + """ + writer = self._writer + if writer is None: + return default + transport = writer.transport + if transport is None: + return default + return transport.get_extra_info(name, default) + + def exception(self) -> Optional[BaseException]: + return self._exception + + async def ping(self, message: bytes = b"") -> None: + if self._writer is None: + raise RuntimeError("Call .prepare() first") + await self._writer.send_frame(message, WSMsgType.PING) + + async def pong(self, message: bytes = b"") -> None: + # unsolicited pong + if self._writer is None: + raise RuntimeError("Call .prepare() first") + await self._writer.send_frame(message, WSMsgType.PONG) + + async def send_frame( + self, message: bytes, opcode: WSMsgType, compress: Optional[int] = None + ) -> None: + """Send a frame over the websocket.""" + if self._writer is None: + raise RuntimeError("Call .prepare() first") + await self._writer.send_frame(message, opcode, compress) + + async def send_str(self, data: str, compress: Optional[int] = None) -> None: + if self._writer is None: + raise RuntimeError("Call .prepare() first") + if not isinstance(data, str): + raise TypeError("data argument must be str (%r)" % type(data)) + await self._writer.send_frame( + data.encode("utf-8"), WSMsgType.TEXT, compress=compress + ) + + async def send_bytes(self, data: bytes, compress: Optional[int] = None) -> None: + if self._writer is None: + raise RuntimeError("Call .prepare() first") + if not isinstance(data, (bytes, bytearray, memoryview)): + raise TypeError("data argument must be byte-ish (%r)" % type(data)) + await self._writer.send_frame(data, WSMsgType.BINARY, compress=compress) + + async def send_json( + self, + data: Any, + compress: Optional[int] = None, + *, + dumps: JSONEncoder = json.dumps, + ) -> None: + await self.send_str(dumps(data), compress=compress) + + async def write_eof(self) -> None: # type: ignore[override] + if self._eof_sent: + return + if self._payload_writer is None: + raise RuntimeError("Response has not been started") + + await self.close() + self._eof_sent = True + + async def close( + self, *, code: int = WSCloseCode.OK, message: bytes = b"", drain: bool = True + ) -> bool: + """Close websocket connection.""" + if self._writer is None: + raise RuntimeError("Call .prepare() first") + + if self._closed: + return False + self._set_closed() + + try: + await self._writer.close(code, message) + writer = self._payload_writer + assert writer is not None + if drain: + await writer.drain() + except (asyncio.CancelledError, asyncio.TimeoutError): + self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE) + raise + except Exception as exc: + self._exception = exc + self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE) + return True + + reader = self._reader + assert reader is not None + # we need to break `receive()` cycle before we can call + # `reader.read()` as `close()` may be called from different task + if self._waiting: + assert self._loop is not None + assert self._close_wait is None + self._close_wait = self._loop.create_future() + reader.feed_data(WS_CLOSING_MESSAGE, 0) + await self._close_wait + + if self._closing: + self._close_transport() + return True + + try: + async with async_timeout.timeout(self._timeout): + while True: + msg = await reader.read() + if msg.type is WSMsgType.CLOSE: + self._set_code_close_transport(msg.data) + return True + except asyncio.CancelledError: + self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE) + raise + except Exception as exc: + self._exception = exc + self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE) + return True + + def _set_closing(self, code: WSCloseCode) -> None: + """Set the close code and mark the connection as closing.""" + self._closing = True + self._close_code = code + self._cancel_heartbeat() + + def _set_code_close_transport(self, code: WSCloseCode) -> None: + """Set the close code and close the transport.""" + self._close_code = code + self._close_transport() + + def _close_transport(self) -> None: + """Close the transport.""" + if self._req is not None and self._req.transport is not None: + self._req.transport.close() + + async def receive(self, timeout: Optional[float] = None) -> WSMessage: + if self._reader is None: + raise RuntimeError("Call .prepare() first") + + receive_timeout = timeout or self._receive_timeout + while True: + if self._waiting: + raise RuntimeError("Concurrent call to receive() is not allowed") + + if self._closed: + self._conn_lost += 1 + if self._conn_lost >= THRESHOLD_CONNLOST_ACCESS: + raise RuntimeError("WebSocket connection is closed.") + return WS_CLOSED_MESSAGE + elif self._closing: + return WS_CLOSING_MESSAGE + + try: + self._waiting = True + try: + if receive_timeout: + # Entering the context manager and creating + # Timeout() object can take almost 50% of the + # run time in this loop so we avoid it if + # there is no read timeout. + async with async_timeout.timeout(receive_timeout): + msg = await self._reader.read() + else: + msg = await self._reader.read() + self._reset_heartbeat() + finally: + self._waiting = False + if self._close_wait: + set_result(self._close_wait, None) + except asyncio.TimeoutError: + raise + except EofStream: + self._close_code = WSCloseCode.OK + await self.close() + return WSMessage(WSMsgType.CLOSED, None, None) + except WebSocketError as exc: + self._close_code = exc.code + await self.close(code=exc.code) + return WSMessage(WSMsgType.ERROR, exc, None) + except Exception as exc: + self._exception = exc + self._set_closing(WSCloseCode.ABNORMAL_CLOSURE) + await self.close() + return WSMessage(WSMsgType.ERROR, exc, None) + + if msg.type not in _INTERNAL_RECEIVE_TYPES: + # If its not a close/closing/ping/pong message + # we can return it immediately + return msg + + if msg.type is WSMsgType.CLOSE: + self._set_closing(msg.data) + # Could be closed while awaiting reader. + if not self._closed and self._autoclose: + # The client is likely going to close the + # connection out from under us so we do not + # want to drain any pending writes as it will + # likely result writing to a broken pipe. + await self.close(drain=False) + elif msg.type is WSMsgType.CLOSING: + self._set_closing(WSCloseCode.OK) + elif msg.type is WSMsgType.PING and self._autoping: + await self.pong(msg.data) + continue + elif msg.type is WSMsgType.PONG and self._autoping: + continue + + return msg + + async def receive_str(self, *, timeout: Optional[float] = None) -> str: + msg = await self.receive(timeout) + if msg.type is not WSMsgType.TEXT: + raise WSMessageTypeError( + f"Received message {msg.type}:{msg.data!r} is not WSMsgType.TEXT" + ) + return cast(str, msg.data) + + async def receive_bytes(self, *, timeout: Optional[float] = None) -> bytes: + msg = await self.receive(timeout) + if msg.type is not WSMsgType.BINARY: + raise WSMessageTypeError( + f"Received message {msg.type}:{msg.data!r} is not WSMsgType.BINARY" + ) + return cast(bytes, msg.data) + + async def receive_json( + self, *, loads: JSONDecoder = json.loads, timeout: Optional[float] = None + ) -> Any: + data = await self.receive_str(timeout=timeout) + return loads(data) + + async def write(self, data: bytes) -> None: + raise RuntimeError("Cannot call .write() for websocket") + + def __aiter__(self) -> "WebSocketResponse": + return self + + async def __anext__(self) -> WSMessage: + msg = await self.receive() + if msg.type in (WSMsgType.CLOSE, WSMsgType.CLOSING, WSMsgType.CLOSED): + raise StopAsyncIteration + return msg + + def _cancel(self, exc: BaseException) -> None: + # web_protocol calls this from connection_lost + # or when the server is shutting down. + self._closing = True + self._cancel_heartbeat() + if self._reader is not None: + set_exception(self._reader, exc) diff --git a/env/lib/python3.12/site-packages/aiohttp/worker.py b/env/lib/python3.12/site-packages/aiohttp/worker.py new file mode 100644 index 0000000..f7281bf --- /dev/null +++ b/env/lib/python3.12/site-packages/aiohttp/worker.py @@ -0,0 +1,255 @@ +"""Async gunicorn worker for aiohttp.web""" + +import asyncio +import inspect +import os +import re +import signal +import sys +from types import FrameType +from typing import TYPE_CHECKING, Any, Optional + +from gunicorn.config import AccessLogFormat as GunicornAccessLogFormat +from gunicorn.workers import base + +from aiohttp import web + +from .helpers import set_result +from .web_app import Application +from .web_log import AccessLogger + +if TYPE_CHECKING: + import ssl + + SSLContext = ssl.SSLContext +else: + try: + import ssl + + SSLContext = ssl.SSLContext + except ImportError: # pragma: no cover + ssl = None # type: ignore[assignment] + SSLContext = object # type: ignore[misc,assignment] + + +__all__ = ("GunicornWebWorker", "GunicornUVLoopWebWorker") + + +class GunicornWebWorker(base.Worker): # type: ignore[misc,no-any-unimported] + + DEFAULT_AIOHTTP_LOG_FORMAT = AccessLogger.LOG_FORMAT + DEFAULT_GUNICORN_LOG_FORMAT = GunicornAccessLogFormat.default + + def __init__(self, *args: Any, **kw: Any) -> None: # pragma: no cover + super().__init__(*args, **kw) + + self._task: Optional[asyncio.Task[None]] = None + self.exit_code = 0 + self._notify_waiter: Optional[asyncio.Future[bool]] = None + + def init_process(self) -> None: + # create new event_loop after fork + asyncio.get_event_loop().close() + + self.loop = asyncio.new_event_loop() + asyncio.set_event_loop(self.loop) + + super().init_process() + + def run(self) -> None: + self._task = self.loop.create_task(self._run()) + + try: # ignore all finalization problems + self.loop.run_until_complete(self._task) + except Exception: + self.log.exception("Exception in gunicorn worker") + self.loop.run_until_complete(self.loop.shutdown_asyncgens()) + self.loop.close() + + sys.exit(self.exit_code) + + async def _run(self) -> None: + runner = None + if isinstance(self.wsgi, Application): + app = self.wsgi + elif inspect.iscoroutinefunction(self.wsgi) or ( + sys.version_info < (3, 14) and asyncio.iscoroutinefunction(self.wsgi) + ): + wsgi = await self.wsgi() + if isinstance(wsgi, web.AppRunner): + runner = wsgi + app = runner.app + else: + app = wsgi + else: + raise RuntimeError( + "wsgi app should be either Application or " + "async function returning Application, got {}".format(self.wsgi) + ) + + if runner is None: + access_log = self.log.access_log if self.cfg.accesslog else None + runner = web.AppRunner( + app, + logger=self.log, + keepalive_timeout=self.cfg.keepalive, + access_log=access_log, + access_log_format=self._get_valid_log_format( + self.cfg.access_log_format + ), + shutdown_timeout=self.cfg.graceful_timeout / 100 * 95, + ) + await runner.setup() + + ctx = self._create_ssl_context(self.cfg) if self.cfg.is_ssl else None + + runner = runner + assert runner is not None + server = runner.server + assert server is not None + for sock in self.sockets: + site = web.SockSite( + runner, + sock, + ssl_context=ctx, + ) + await site.start() + + # If our parent changed then we shut down. + pid = os.getpid() + try: + while self.alive: # type: ignore[has-type] + self.notify() + + cnt = server.requests_count + if self.max_requests and cnt > self.max_requests: + self.alive = False + self.log.info("Max requests, shutting down: %s", self) + + elif pid == os.getpid() and self.ppid != os.getppid(): + self.alive = False + self.log.info("Parent changed, shutting down: %s", self) + else: + await self._wait_next_notify() + except BaseException: + pass + + await runner.cleanup() + + def _wait_next_notify(self) -> "asyncio.Future[bool]": + self._notify_waiter_done() + + loop = self.loop + assert loop is not None + self._notify_waiter = waiter = loop.create_future() + self.loop.call_later(1.0, self._notify_waiter_done, waiter) + + return waiter + + def _notify_waiter_done( + self, waiter: Optional["asyncio.Future[bool]"] = None + ) -> None: + if waiter is None: + waiter = self._notify_waiter + if waiter is not None: + set_result(waiter, True) + + if waiter is self._notify_waiter: + self._notify_waiter = None + + def init_signals(self) -> None: + # Set up signals through the event loop API. + + self.loop.add_signal_handler( + signal.SIGQUIT, self.handle_quit, signal.SIGQUIT, None + ) + + self.loop.add_signal_handler( + signal.SIGTERM, self.handle_exit, signal.SIGTERM, None + ) + + self.loop.add_signal_handler( + signal.SIGINT, self.handle_quit, signal.SIGINT, None + ) + + self.loop.add_signal_handler( + signal.SIGWINCH, self.handle_winch, signal.SIGWINCH, None + ) + + self.loop.add_signal_handler( + signal.SIGUSR1, self.handle_usr1, signal.SIGUSR1, None + ) + + self.loop.add_signal_handler( + signal.SIGABRT, self.handle_abort, signal.SIGABRT, None + ) + + # Don't let SIGTERM and SIGUSR1 disturb active requests + # by interrupting system calls + signal.siginterrupt(signal.SIGTERM, False) + signal.siginterrupt(signal.SIGUSR1, False) + # Reset signals so Gunicorn doesn't swallow subprocess return codes + # See: https://github.com/aio-libs/aiohttp/issues/6130 + + def handle_quit(self, sig: int, frame: Optional[FrameType]) -> None: + self.alive = False + + # worker_int callback + self.cfg.worker_int(self) + + # wakeup closing process + self._notify_waiter_done() + + def handle_abort(self, sig: int, frame: Optional[FrameType]) -> None: + self.alive = False + self.exit_code = 1 + self.cfg.worker_abort(self) + sys.exit(1) + + @staticmethod + def _create_ssl_context(cfg: Any) -> "SSLContext": + """Creates SSLContext instance for usage in asyncio.create_server. + + See ssl.SSLSocket.__init__ for more details. + """ + if ssl is None: # pragma: no cover + raise RuntimeError("SSL is not supported.") + + ctx = ssl.SSLContext(cfg.ssl_version) + ctx.load_cert_chain(cfg.certfile, cfg.keyfile) + ctx.verify_mode = cfg.cert_reqs + if cfg.ca_certs: + ctx.load_verify_locations(cfg.ca_certs) + if cfg.ciphers: + ctx.set_ciphers(cfg.ciphers) + return ctx + + def _get_valid_log_format(self, source_format: str) -> str: + if source_format == self.DEFAULT_GUNICORN_LOG_FORMAT: + return self.DEFAULT_AIOHTTP_LOG_FORMAT + elif re.search(r"%\([^\)]+\)", source_format): + raise ValueError( + "Gunicorn's style options in form of `%(name)s` are not " + "supported for the log formatting. Please use aiohttp's " + "format specification to configure access log formatting: " + "http://docs.aiohttp.org/en/stable/logging.html" + "#format-specification" + ) + else: + return source_format + + +class GunicornUVLoopWebWorker(GunicornWebWorker): + def init_process(self) -> None: + import uvloop + + # Close any existing event loop before setting a + # new policy. + asyncio.get_event_loop().close() + + # Setup uvloop policy, so that every + # asyncio.get_event_loop() will create an instance + # of uvloop event loop. + asyncio.set_event_loop_policy(uvloop.EventLoopPolicy()) + + super().init_process() diff --git a/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/INSTALLER b/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/METADATA b/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/METADATA new file mode 100644 index 0000000..03a6f0f --- /dev/null +++ b/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/METADATA @@ -0,0 +1,112 @@ +Metadata-Version: 2.4 +Name: aiosignal +Version: 1.4.0 +Summary: aiosignal: a list of registered asynchronous callbacks +Home-page: https://github.com/aio-libs/aiosignal +Maintainer: aiohttp team +Maintainer-email: team@aiohttp.org +License: Apache 2.0 +Project-URL: Chat: Gitter, https://gitter.im/aio-libs/Lobby +Project-URL: CI: GitHub Actions, https://github.com/aio-libs/aiosignal/actions +Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/aiosignal +Project-URL: Docs: RTD, https://docs.aiosignal.org +Project-URL: GitHub: issues, https://github.com/aio-libs/aiosignal/issues +Project-URL: GitHub: repo, https://github.com/aio-libs/aiosignal +Classifier: License :: OSI Approved :: Apache Software License +Classifier: Intended Audience :: Developers +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Development Status :: 5 - Production/Stable +Classifier: Operating System :: POSIX +Classifier: Operating System :: MacOS :: MacOS X +Classifier: Operating System :: Microsoft :: Windows +Classifier: Framework :: AsyncIO +Requires-Python: >=3.9 +Description-Content-Type: text/x-rst +License-File: LICENSE +Requires-Dist: frozenlist>=1.1.0 +Requires-Dist: typing-extensions>=4.2; python_version < "3.13" +Dynamic: license-file + +========= +aiosignal +========= + +.. image:: https://github.com/aio-libs/aiosignal/workflows/CI/badge.svg + :target: https://github.com/aio-libs/aiosignal/actions?query=workflow%3ACI + :alt: GitHub status for master branch + +.. image:: https://codecov.io/gh/aio-libs/aiosignal/branch/master/graph/badge.svg?flag=pytest + :target: https://codecov.io/gh/aio-libs/aiosignal?flags[0]=pytest + :alt: codecov.io status for master branch + +.. image:: https://badge.fury.io/py/aiosignal.svg + :target: https://pypi.org/project/aiosignal + :alt: Latest PyPI package version + +.. image:: https://readthedocs.org/projects/aiosignal/badge/?version=latest + :target: https://aiosignal.readthedocs.io/ + :alt: Latest Read The Docs + +.. image:: https://img.shields.io/discourse/topics?server=https%3A%2F%2Faio-libs.discourse.group%2F + :target: https://aio-libs.discourse.group/ + :alt: Discourse group for io-libs + +.. image:: https://badges.gitter.im/Join%20Chat.svg + :target: https://gitter.im/aio-libs/Lobby + :alt: Chat on Gitter + +Introduction +============ + +A project to manage callbacks in `asyncio` projects. + +``Signal`` is a list of registered asynchronous callbacks. + +The signal's life-cycle has two stages: after creation its content +could be filled by using standard list operations: ``sig.append()`` +etc. + +After you call ``sig.freeze()`` the signal is *frozen*: adding, removing +and dropping callbacks is forbidden. + +The only available operation is calling the previously registered +callbacks by using ``await sig.send(data)``. + +For concrete usage examples see the `Signals + +section of the `Web Server Advanced +` chapter of the `aiohttp +documentation`_. + + +Installation +------------ + +:: + + $ pip install aiosignal + + +Documentation +============= + +https://aiosignal.readthedocs.io/ + +License +======= + +``aiosignal`` is offered under the Apache 2 license. + +Source code +=========== + +The project is hosted on GitHub_ + +Please file an issue in the `bug tracker +`_ if you have found a bug +or have some suggestions to improve the library. + +.. _GitHub: https://github.com/aio-libs/aiosignal +.. _aiohttp documentation: https://docs.aiohttp.org/ diff --git a/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/RECORD b/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/RECORD new file mode 100644 index 0000000..df5ca06 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/RECORD @@ -0,0 +1,9 @@ +aiosignal-1.4.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +aiosignal-1.4.0.dist-info/METADATA,sha256=CSR-8dqLxpZyjUcTDnAuQwf299EB1sSFv_nzpxznAI0,3662 +aiosignal-1.4.0.dist-info/RECORD,, +aiosignal-1.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91 +aiosignal-1.4.0.dist-info/licenses/LICENSE,sha256=b9UkPpLdf5jsacesN3co50kFcJ_1J6W_mNbQJjwE9bY,11332 +aiosignal-1.4.0.dist-info/top_level.txt,sha256=z45aNOKGDdrI1roqZY3BGXQ22kJFPHBmVdwtLYLtXC0,10 +aiosignal/__init__.py,sha256=TIkmUG9HTBt4dfq2nISYBiZiRB2xwvFtEZydLP0HPL4,1537 +aiosignal/__pycache__/__init__.cpython-312.pyc,, +aiosignal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 diff --git a/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/WHEEL b/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/WHEEL new file mode 100644 index 0000000..e7fa31b --- /dev/null +++ b/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (80.9.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/licenses/LICENSE b/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/licenses/LICENSE new file mode 100644 index 0000000..7082a2d --- /dev/null +++ b/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/licenses/LICENSE @@ -0,0 +1,201 @@ +Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2013-2019 Nikolay Kim and Andrew Svetlov + + 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. diff --git a/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/top_level.txt b/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/top_level.txt new file mode 100644 index 0000000..ac6df3a --- /dev/null +++ b/env/lib/python3.12/site-packages/aiosignal-1.4.0.dist-info/top_level.txt @@ -0,0 +1 @@ +aiosignal diff --git a/env/lib/python3.12/site-packages/aiosignal/__init__.py b/env/lib/python3.12/site-packages/aiosignal/__init__.py new file mode 100644 index 0000000..5ede009 --- /dev/null +++ b/env/lib/python3.12/site-packages/aiosignal/__init__.py @@ -0,0 +1,59 @@ +import sys +from typing import Any, Awaitable, Callable, TypeVar + +from frozenlist import FrozenList + +if sys.version_info >= (3, 11): + from typing import Unpack +else: + from typing_extensions import Unpack + +if sys.version_info >= (3, 13): + from typing import TypeVarTuple +else: + from typing_extensions import TypeVarTuple + +_T = TypeVar("_T") +_Ts = TypeVarTuple("_Ts", default=Unpack[tuple[()]]) + +__version__ = "1.4.0" + +__all__ = ("Signal",) + + +class Signal(FrozenList[Callable[[Unpack[_Ts]], Awaitable[object]]]): + """Coroutine-based signal implementation. + + To connect a callback to a signal, use any list method. + + Signals are fired using the send() coroutine, which takes named + arguments. + """ + + __slots__ = ("_owner",) + + def __init__(self, owner: object): + super().__init__() + self._owner = owner + + def __repr__(self) -> str: + return "".format( + self._owner, self.frozen, list(self) + ) + + async def send(self, *args: Unpack[_Ts], **kwargs: Any) -> None: + """ + Sends data to all registered receivers. + """ + if not self.frozen: + raise RuntimeError("Cannot send non-frozen signal.") + + for receiver in self: + await receiver(*args, **kwargs) + + def __call__( + self, func: Callable[[Unpack[_Ts]], Awaitable[_T]] + ) -> Callable[[Unpack[_Ts]], Awaitable[_T]]: + """Decorator to add a function to this Signal.""" + self.append(func) + return func diff --git a/env/lib/python3.12/site-packages/aiosignal/py.typed b/env/lib/python3.12/site-packages/aiosignal/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/attr/__init__.py b/env/lib/python3.12/site-packages/attr/__init__.py new file mode 100644 index 0000000..5c6e065 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/__init__.py @@ -0,0 +1,104 @@ +# SPDX-License-Identifier: MIT + +""" +Classes Without Boilerplate +""" + +from functools import partial +from typing import Callable, Literal, Protocol + +from . import converters, exceptions, filters, setters, validators +from ._cmp import cmp_using +from ._config import get_run_validators, set_run_validators +from ._funcs import asdict, assoc, astuple, has, resolve_types +from ._make import ( + NOTHING, + Attribute, + Converter, + Factory, + _Nothing, + attrib, + attrs, + evolve, + fields, + fields_dict, + make_class, + validate, +) +from ._next_gen import define, field, frozen, mutable +from ._version_info import VersionInfo + + +s = attributes = attrs +ib = attr = attrib +dataclass = partial(attrs, auto_attribs=True) # happy Easter ;) + + +class AttrsInstance(Protocol): + pass + + +NothingType = Literal[_Nothing.NOTHING] + +__all__ = [ + "NOTHING", + "Attribute", + "AttrsInstance", + "Converter", + "Factory", + "NothingType", + "asdict", + "assoc", + "astuple", + "attr", + "attrib", + "attributes", + "attrs", + "cmp_using", + "converters", + "define", + "evolve", + "exceptions", + "field", + "fields", + "fields_dict", + "filters", + "frozen", + "get_run_validators", + "has", + "ib", + "make_class", + "mutable", + "resolve_types", + "s", + "set_run_validators", + "setters", + "validate", + "validators", +] + + +def _make_getattr(mod_name: str) -> Callable: + """ + Create a metadata proxy for packaging information that uses *mod_name* in + its warnings and errors. + """ + + def __getattr__(name: str) -> str: + if name not in ("__version__", "__version_info__"): + msg = f"module {mod_name} has no attribute {name}" + raise AttributeError(msg) + + from importlib.metadata import metadata + + meta = metadata("attrs") + + if name == "__version_info__": + return VersionInfo._from_version_string(meta["version"]) + + return meta["version"] + + return __getattr__ + + +__getattr__ = _make_getattr(__name__) diff --git a/env/lib/python3.12/site-packages/attr/__init__.pyi b/env/lib/python3.12/site-packages/attr/__init__.pyi new file mode 100644 index 0000000..8d78fa1 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/__init__.pyi @@ -0,0 +1,389 @@ +import enum +import sys + +from typing import ( + Any, + Callable, + Generic, + Literal, + Mapping, + Protocol, + Sequence, + TypeVar, + overload, +) + +# `import X as X` is required to make these public +from . import converters as converters +from . import exceptions as exceptions +from . import filters as filters +from . import setters as setters +from . import validators as validators +from ._cmp import cmp_using as cmp_using +from ._typing_compat import AttrsInstance_ +from ._version_info import VersionInfo +from attrs import ( + define as define, + field as field, + mutable as mutable, + frozen as frozen, + _EqOrderType, + _ValidatorType, + _ConverterType, + _ReprArgType, + _OnSetAttrType, + _OnSetAttrArgType, + _FieldTransformer, + _ValidatorArgType, +) + +if sys.version_info >= (3, 10): + from typing import TypeGuard, TypeAlias +else: + from typing_extensions import TypeGuard, TypeAlias + +if sys.version_info >= (3, 11): + from typing import dataclass_transform +else: + from typing_extensions import dataclass_transform + +__version__: str +__version_info__: VersionInfo +__title__: str +__description__: str +__url__: str +__uri__: str +__author__: str +__email__: str +__license__: str +__copyright__: str + +_T = TypeVar("_T") +_C = TypeVar("_C", bound=type) + +_FilterType = Callable[["Attribute[_T]", _T], bool] + +# We subclass this here to keep the protocol's qualified name clean. +class AttrsInstance(AttrsInstance_, Protocol): + pass + +_A = TypeVar("_A", bound=type[AttrsInstance]) + +class _Nothing(enum.Enum): + NOTHING = enum.auto() + +NOTHING = _Nothing.NOTHING +NothingType: TypeAlias = Literal[_Nothing.NOTHING] + +# NOTE: Factory lies about its return type to make this possible: +# `x: List[int] # = Factory(list)` +# Work around mypy issue #4554 in the common case by using an overload. + +@overload +def Factory(factory: Callable[[], _T]) -> _T: ... +@overload +def Factory( + factory: Callable[[Any], _T], + takes_self: Literal[True], +) -> _T: ... +@overload +def Factory( + factory: Callable[[], _T], + takes_self: Literal[False], +) -> _T: ... + +In = TypeVar("In") +Out = TypeVar("Out") + +class Converter(Generic[In, Out]): + @overload + def __init__(self, converter: Callable[[In], Out]) -> None: ... + @overload + def __init__( + self, + converter: Callable[[In, AttrsInstance, Attribute], Out], + *, + takes_self: Literal[True], + takes_field: Literal[True], + ) -> None: ... + @overload + def __init__( + self, + converter: Callable[[In, Attribute], Out], + *, + takes_field: Literal[True], + ) -> None: ... + @overload + def __init__( + self, + converter: Callable[[In, AttrsInstance], Out], + *, + takes_self: Literal[True], + ) -> None: ... + +class Attribute(Generic[_T]): + name: str + default: _T | None + validator: _ValidatorType[_T] | None + repr: _ReprArgType + cmp: _EqOrderType + eq: _EqOrderType + order: _EqOrderType + hash: bool | None + init: bool + converter: Converter | None + metadata: dict[Any, Any] + type: type[_T] | None + kw_only: bool + on_setattr: _OnSetAttrType + alias: str | None + + def evolve(self, **changes: Any) -> "Attribute[Any]": ... + +# NOTE: We had several choices for the annotation to use for type arg: +# 1) Type[_T] +# - Pros: Handles simple cases correctly +# - Cons: Might produce less informative errors in the case of conflicting +# TypeVars e.g. `attr.ib(default='bad', type=int)` +# 2) Callable[..., _T] +# - Pros: Better error messages than #1 for conflicting TypeVars +# - Cons: Terrible error messages for validator checks. +# e.g. attr.ib(type=int, validator=validate_str) +# -> error: Cannot infer function type argument +# 3) type (and do all of the work in the mypy plugin) +# - Pros: Simple here, and we could customize the plugin with our own errors. +# - Cons: Would need to write mypy plugin code to handle all the cases. +# We chose option #1. + +# `attr` lies about its return type to make the following possible: +# attr() -> Any +# attr(8) -> int +# attr(validator=) -> Whatever the callable expects. +# This makes this type of assignments possible: +# x: int = attr(8) +# +# This form catches explicit None or no default but with no other arguments +# returns Any. +@overload +def attrib( + default: None = ..., + validator: None = ..., + repr: _ReprArgType = ..., + cmp: _EqOrderType | None = ..., + hash: bool | None = ..., + init: bool = ..., + metadata: Mapping[Any, Any] | None = ..., + type: None = ..., + converter: None = ..., + factory: None = ..., + kw_only: bool | None = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + alias: str | None = ..., +) -> Any: ... + +# This form catches an explicit None or no default and infers the type from the +# other arguments. +@overload +def attrib( + default: None = ..., + validator: _ValidatorArgType[_T] | None = ..., + repr: _ReprArgType = ..., + cmp: _EqOrderType | None = ..., + hash: bool | None = ..., + init: bool = ..., + metadata: Mapping[Any, Any] | None = ..., + type: type[_T] | None = ..., + converter: _ConverterType + | list[_ConverterType] + | tuple[_ConverterType] + | None = ..., + factory: Callable[[], _T] | None = ..., + kw_only: bool | None = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + alias: str | None = ..., +) -> _T: ... + +# This form catches an explicit default argument. +@overload +def attrib( + default: _T, + validator: _ValidatorArgType[_T] | None = ..., + repr: _ReprArgType = ..., + cmp: _EqOrderType | None = ..., + hash: bool | None = ..., + init: bool = ..., + metadata: Mapping[Any, Any] | None = ..., + type: type[_T] | None = ..., + converter: _ConverterType + | list[_ConverterType] + | tuple[_ConverterType] + | None = ..., + factory: Callable[[], _T] | None = ..., + kw_only: bool | None = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + alias: str | None = ..., +) -> _T: ... + +# This form covers type=non-Type: e.g. forward references (str), Any +@overload +def attrib( + default: _T | None = ..., + validator: _ValidatorArgType[_T] | None = ..., + repr: _ReprArgType = ..., + cmp: _EqOrderType | None = ..., + hash: bool | None = ..., + init: bool = ..., + metadata: Mapping[Any, Any] | None = ..., + type: object = ..., + converter: _ConverterType + | list[_ConverterType] + | tuple[_ConverterType] + | None = ..., + factory: Callable[[], _T] | None = ..., + kw_only: bool | None = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + alias: str | None = ..., +) -> Any: ... +@overload +@dataclass_transform(order_default=True, field_specifiers=(attrib, field)) +def attrs( + maybe_cls: _C, + these: dict[str, Any] | None = ..., + repr_ns: str | None = ..., + repr: bool = ..., + cmp: _EqOrderType | None = ..., + hash: bool | None = ..., + init: bool = ..., + slots: bool = ..., + frozen: bool = ..., + weakref_slot: bool = ..., + str: bool = ..., + auto_attribs: bool = ..., + kw_only: bool = ..., + cache_hash: bool = ..., + auto_exc: bool = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + auto_detect: bool = ..., + collect_by_mro: bool = ..., + getstate_setstate: bool | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + field_transformer: _FieldTransformer | None = ..., + match_args: bool = ..., + unsafe_hash: bool | None = ..., +) -> _C: ... +@overload +@dataclass_transform(order_default=True, field_specifiers=(attrib, field)) +def attrs( + maybe_cls: None = ..., + these: dict[str, Any] | None = ..., + repr_ns: str | None = ..., + repr: bool = ..., + cmp: _EqOrderType | None = ..., + hash: bool | None = ..., + init: bool = ..., + slots: bool = ..., + frozen: bool = ..., + weakref_slot: bool = ..., + str: bool = ..., + auto_attribs: bool = ..., + kw_only: bool = ..., + cache_hash: bool = ..., + auto_exc: bool = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + auto_detect: bool = ..., + collect_by_mro: bool = ..., + getstate_setstate: bool | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + field_transformer: _FieldTransformer | None = ..., + match_args: bool = ..., + unsafe_hash: bool | None = ..., +) -> Callable[[_C], _C]: ... +def fields(cls: type[AttrsInstance]) -> Any: ... +def fields_dict(cls: type[AttrsInstance]) -> dict[str, Attribute[Any]]: ... +def validate(inst: AttrsInstance) -> None: ... +def resolve_types( + cls: _A, + globalns: dict[str, Any] | None = ..., + localns: dict[str, Any] | None = ..., + attribs: list[Attribute[Any]] | None = ..., + include_extras: bool = ..., +) -> _A: ... + +# TODO: add support for returning a proper attrs class from the mypy plugin +# we use Any instead of _CountingAttr so that e.g. `make_class('Foo', +# [attr.ib()])` is valid +def make_class( + name: str, + attrs: list[str] | tuple[str, ...] | dict[str, Any], + bases: tuple[type, ...] = ..., + class_body: dict[str, Any] | None = ..., + repr_ns: str | None = ..., + repr: bool = ..., + cmp: _EqOrderType | None = ..., + hash: bool | None = ..., + init: bool = ..., + slots: bool = ..., + frozen: bool = ..., + weakref_slot: bool = ..., + str: bool = ..., + auto_attribs: bool = ..., + kw_only: bool = ..., + cache_hash: bool = ..., + auto_exc: bool = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + collect_by_mro: bool = ..., + on_setattr: _OnSetAttrArgType | None = ..., + field_transformer: _FieldTransformer | None = ..., +) -> type: ... + +# _funcs -- + +# TODO: add support for returning TypedDict from the mypy plugin +# FIXME: asdict/astuple do not honor their factory args. Waiting on one of +# these: +# https://github.com/python/mypy/issues/4236 +# https://github.com/python/typing/issues/253 +# XXX: remember to fix attrs.asdict/astuple too! +def asdict( + inst: AttrsInstance, + recurse: bool = ..., + filter: _FilterType[Any] | None = ..., + dict_factory: type[Mapping[Any, Any]] = ..., + retain_collection_types: bool = ..., + value_serializer: Callable[[type, Attribute[Any], Any], Any] | None = ..., + tuple_keys: bool | None = ..., +) -> dict[str, Any]: ... + +# TODO: add support for returning NamedTuple from the mypy plugin +def astuple( + inst: AttrsInstance, + recurse: bool = ..., + filter: _FilterType[Any] | None = ..., + tuple_factory: type[Sequence[Any]] = ..., + retain_collection_types: bool = ..., +) -> tuple[Any, ...]: ... +def has(cls: type) -> TypeGuard[type[AttrsInstance]]: ... +def assoc(inst: _T, **changes: Any) -> _T: ... +def evolve(inst: _T, **changes: Any) -> _T: ... + +# _config -- + +def set_run_validators(run: bool) -> None: ... +def get_run_validators() -> bool: ... + +# aliases -- + +s = attributes = attrs +ib = attr = attrib +dataclass = attrs # Technically, partial(attrs, auto_attribs=True) ;) diff --git a/env/lib/python3.12/site-packages/attr/_cmp.py b/env/lib/python3.12/site-packages/attr/_cmp.py new file mode 100644 index 0000000..09bab49 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/_cmp.py @@ -0,0 +1,160 @@ +# SPDX-License-Identifier: MIT + + +import functools +import types + +from ._make import __ne__ + + +_operation_names = {"eq": "==", "lt": "<", "le": "<=", "gt": ">", "ge": ">="} + + +def cmp_using( + eq=None, + lt=None, + le=None, + gt=None, + ge=None, + require_same_type=True, + class_name="Comparable", +): + """ + Create a class that can be passed into `attrs.field`'s ``eq``, ``order``, + and ``cmp`` arguments to customize field comparison. + + The resulting class will have a full set of ordering methods if at least + one of ``{lt, le, gt, ge}`` and ``eq`` are provided. + + Args: + eq (typing.Callable | None): + Callable used to evaluate equality of two objects. + + lt (typing.Callable | None): + Callable used to evaluate whether one object is less than another + object. + + le (typing.Callable | None): + Callable used to evaluate whether one object is less than or equal + to another object. + + gt (typing.Callable | None): + Callable used to evaluate whether one object is greater than + another object. + + ge (typing.Callable | None): + Callable used to evaluate whether one object is greater than or + equal to another object. + + require_same_type (bool): + When `True`, equality and ordering methods will return + `NotImplemented` if objects are not of the same type. + + class_name (str | None): Name of class. Defaults to "Comparable". + + See `comparison` for more details. + + .. versionadded:: 21.1.0 + """ + + body = { + "__slots__": ["value"], + "__init__": _make_init(), + "_requirements": [], + "_is_comparable_to": _is_comparable_to, + } + + # Add operations. + num_order_functions = 0 + has_eq_function = False + + if eq is not None: + has_eq_function = True + body["__eq__"] = _make_operator("eq", eq) + body["__ne__"] = __ne__ + + if lt is not None: + num_order_functions += 1 + body["__lt__"] = _make_operator("lt", lt) + + if le is not None: + num_order_functions += 1 + body["__le__"] = _make_operator("le", le) + + if gt is not None: + num_order_functions += 1 + body["__gt__"] = _make_operator("gt", gt) + + if ge is not None: + num_order_functions += 1 + body["__ge__"] = _make_operator("ge", ge) + + type_ = types.new_class( + class_name, (object,), {}, lambda ns: ns.update(body) + ) + + # Add same type requirement. + if require_same_type: + type_._requirements.append(_check_same_type) + + # Add total ordering if at least one operation was defined. + if 0 < num_order_functions < 4: + if not has_eq_function: + # functools.total_ordering requires __eq__ to be defined, + # so raise early error here to keep a nice stack. + msg = "eq must be define is order to complete ordering from lt, le, gt, ge." + raise ValueError(msg) + type_ = functools.total_ordering(type_) + + return type_ + + +def _make_init(): + """ + Create __init__ method. + """ + + def __init__(self, value): + """ + Initialize object with *value*. + """ + self.value = value + + return __init__ + + +def _make_operator(name, func): + """ + Create operator method. + """ + + def method(self, other): + if not self._is_comparable_to(other): + return NotImplemented + + result = func(self.value, other.value) + if result is NotImplemented: + return NotImplemented + + return result + + method.__name__ = f"__{name}__" + method.__doc__ = ( + f"Return a {_operation_names[name]} b. Computed by attrs." + ) + + return method + + +def _is_comparable_to(self, other): + """ + Check whether `other` is comparable to `self`. + """ + return all(func(self, other) for func in self._requirements) + + +def _check_same_type(self, other): + """ + Return True if *self* and *other* are of the same type, False otherwise. + """ + return other.value.__class__ is self.value.__class__ diff --git a/env/lib/python3.12/site-packages/attr/_cmp.pyi b/env/lib/python3.12/site-packages/attr/_cmp.pyi new file mode 100644 index 0000000..cc7893b --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/_cmp.pyi @@ -0,0 +1,13 @@ +from typing import Any, Callable + +_CompareWithType = Callable[[Any, Any], bool] + +def cmp_using( + eq: _CompareWithType | None = ..., + lt: _CompareWithType | None = ..., + le: _CompareWithType | None = ..., + gt: _CompareWithType | None = ..., + ge: _CompareWithType | None = ..., + require_same_type: bool = ..., + class_name: str = ..., +) -> type: ... diff --git a/env/lib/python3.12/site-packages/attr/_compat.py b/env/lib/python3.12/site-packages/attr/_compat.py new file mode 100644 index 0000000..bc68ed9 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/_compat.py @@ -0,0 +1,99 @@ +# SPDX-License-Identifier: MIT + +import inspect +import platform +import sys +import threading + +from collections.abc import Mapping, Sequence # noqa: F401 +from typing import _GenericAlias + + +PYPY = platform.python_implementation() == "PyPy" +PY_3_10_PLUS = sys.version_info[:2] >= (3, 10) +PY_3_11_PLUS = sys.version_info[:2] >= (3, 11) +PY_3_12_PLUS = sys.version_info[:2] >= (3, 12) +PY_3_13_PLUS = sys.version_info[:2] >= (3, 13) +PY_3_14_PLUS = sys.version_info[:2] >= (3, 14) + + +if PY_3_14_PLUS: + import annotationlib + + # We request forward-ref annotations to not break in the presence of + # forward references. + + def _get_annotations(cls): + return annotationlib.get_annotations( + cls, format=annotationlib.Format.FORWARDREF + ) + +else: + + def _get_annotations(cls): + """ + Get annotations for *cls*. + """ + return cls.__dict__.get("__annotations__", {}) + + +class _AnnotationExtractor: + """ + Extract type annotations from a callable, returning None whenever there + is none. + """ + + __slots__ = ["sig"] + + def __init__(self, callable): + try: + self.sig = inspect.signature(callable) + except (ValueError, TypeError): # inspect failed + self.sig = None + + def get_first_param_type(self): + """ + Return the type annotation of the first argument if it's not empty. + """ + if not self.sig: + return None + + params = list(self.sig.parameters.values()) + if params and params[0].annotation is not inspect.Parameter.empty: + return params[0].annotation + + return None + + def get_return_type(self): + """ + Return the return type if it's not empty. + """ + if ( + self.sig + and self.sig.return_annotation is not inspect.Signature.empty + ): + return self.sig.return_annotation + + return None + + +# Thread-local global to track attrs instances which are already being repr'd. +# This is needed because there is no other (thread-safe) way to pass info +# about the instances that are already being repr'd through the call stack +# in order to ensure we don't perform infinite recursion. +# +# For instance, if an instance contains a dict which contains that instance, +# we need to know that we're already repr'ing the outside instance from within +# the dict's repr() call. +# +# This lives here rather than in _make.py so that the functions in _make.py +# don't have a direct reference to the thread-local in their globals dict. +# If they have such a reference, it breaks cloudpickle. +repr_context = threading.local() + + +def get_generic_base(cl): + """If this is a generic class (A[str]), return the generic base for it.""" + if cl.__class__ is _GenericAlias: + return cl.__origin__ + return None diff --git a/env/lib/python3.12/site-packages/attr/_config.py b/env/lib/python3.12/site-packages/attr/_config.py new file mode 100644 index 0000000..4b25772 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/_config.py @@ -0,0 +1,31 @@ +# SPDX-License-Identifier: MIT + +__all__ = ["get_run_validators", "set_run_validators"] + +_run_validators = True + + +def set_run_validators(run): + """ + Set whether or not validators are run. By default, they are run. + + .. deprecated:: 21.3.0 It will not be removed, but it also will not be + moved to new ``attrs`` namespace. Use `attrs.validators.set_disabled()` + instead. + """ + if not isinstance(run, bool): + msg = "'run' must be bool." + raise TypeError(msg) + global _run_validators + _run_validators = run + + +def get_run_validators(): + """ + Return whether or not validators are run. + + .. deprecated:: 21.3.0 It will not be removed, but it also will not be + moved to new ``attrs`` namespace. Use `attrs.validators.get_disabled()` + instead. + """ + return _run_validators diff --git a/env/lib/python3.12/site-packages/attr/_funcs.py b/env/lib/python3.12/site-packages/attr/_funcs.py new file mode 100644 index 0000000..1adb500 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/_funcs.py @@ -0,0 +1,497 @@ +# SPDX-License-Identifier: MIT + + +import copy + +from ._compat import get_generic_base +from ._make import _OBJ_SETATTR, NOTHING, fields +from .exceptions import AttrsAttributeNotFoundError + + +_ATOMIC_TYPES = frozenset( + { + type(None), + bool, + int, + float, + str, + complex, + bytes, + type(...), + type, + range, + property, + } +) + + +def asdict( + inst, + recurse=True, + filter=None, + dict_factory=dict, + retain_collection_types=False, + value_serializer=None, +): + """ + Return the *attrs* attribute values of *inst* as a dict. + + Optionally recurse into other *attrs*-decorated classes. + + Args: + inst: Instance of an *attrs*-decorated class. + + recurse (bool): Recurse into classes that are also *attrs*-decorated. + + filter (~typing.Callable): + A callable whose return code determines whether an attribute or + element is included (`True`) or dropped (`False`). Is called with + the `attrs.Attribute` as the first argument and the value as the + second argument. + + dict_factory (~typing.Callable): + A callable to produce dictionaries from. For example, to produce + ordered dictionaries instead of normal Python dictionaries, pass in + ``collections.OrderedDict``. + + retain_collection_types (bool): + Do not convert to `list` when encountering an attribute whose type + is `tuple` or `set`. Only meaningful if *recurse* is `True`. + + value_serializer (typing.Callable | None): + A hook that is called for every attribute or dict key/value. It + receives the current instance, field and value and must return the + (updated) value. The hook is run *after* the optional *filter* has + been applied. + + Returns: + Return type of *dict_factory*. + + Raises: + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class. + + .. versionadded:: 16.0.0 *dict_factory* + .. versionadded:: 16.1.0 *retain_collection_types* + .. versionadded:: 20.3.0 *value_serializer* + .. versionadded:: 21.3.0 + If a dict has a collection for a key, it is serialized as a tuple. + """ + attrs = fields(inst.__class__) + rv = dict_factory() + for a in attrs: + v = getattr(inst, a.name) + if filter is not None and not filter(a, v): + continue + + if value_serializer is not None: + v = value_serializer(inst, a, v) + + if recurse is True: + value_type = type(v) + if value_type in _ATOMIC_TYPES: + rv[a.name] = v + elif has(value_type): + rv[a.name] = asdict( + v, + recurse=True, + filter=filter, + dict_factory=dict_factory, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ) + elif issubclass(value_type, (tuple, list, set, frozenset)): + cf = value_type if retain_collection_types is True else list + items = [ + _asdict_anything( + i, + is_key=False, + filter=filter, + dict_factory=dict_factory, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ) + for i in v + ] + try: + rv[a.name] = cf(items) + except TypeError: + if not issubclass(cf, tuple): + raise + # Workaround for TypeError: cf.__new__() missing 1 required + # positional argument (which appears, for a namedturle) + rv[a.name] = cf(*items) + elif issubclass(value_type, dict): + df = dict_factory + rv[a.name] = df( + ( + _asdict_anything( + kk, + is_key=True, + filter=filter, + dict_factory=df, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ), + _asdict_anything( + vv, + is_key=False, + filter=filter, + dict_factory=df, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ), + ) + for kk, vv in v.items() + ) + else: + rv[a.name] = v + else: + rv[a.name] = v + return rv + + +def _asdict_anything( + val, + is_key, + filter, + dict_factory, + retain_collection_types, + value_serializer, +): + """ + ``asdict`` only works on attrs instances, this works on anything. + """ + val_type = type(val) + if val_type in _ATOMIC_TYPES: + rv = val + if value_serializer is not None: + rv = value_serializer(None, None, rv) + elif getattr(val_type, "__attrs_attrs__", None) is not None: + # Attrs class. + rv = asdict( + val, + recurse=True, + filter=filter, + dict_factory=dict_factory, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ) + elif issubclass(val_type, (tuple, list, set, frozenset)): + if retain_collection_types is True: + cf = val.__class__ + elif is_key: + cf = tuple + else: + cf = list + + rv = cf( + [ + _asdict_anything( + i, + is_key=False, + filter=filter, + dict_factory=dict_factory, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ) + for i in val + ] + ) + elif issubclass(val_type, dict): + df = dict_factory + rv = df( + ( + _asdict_anything( + kk, + is_key=True, + filter=filter, + dict_factory=df, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ), + _asdict_anything( + vv, + is_key=False, + filter=filter, + dict_factory=df, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ), + ) + for kk, vv in val.items() + ) + else: + rv = val + if value_serializer is not None: + rv = value_serializer(None, None, rv) + + return rv + + +def astuple( + inst, + recurse=True, + filter=None, + tuple_factory=tuple, + retain_collection_types=False, +): + """ + Return the *attrs* attribute values of *inst* as a tuple. + + Optionally recurse into other *attrs*-decorated classes. + + Args: + inst: Instance of an *attrs*-decorated class. + + recurse (bool): + Recurse into classes that are also *attrs*-decorated. + + filter (~typing.Callable): + A callable whose return code determines whether an attribute or + element is included (`True`) or dropped (`False`). Is called with + the `attrs.Attribute` as the first argument and the value as the + second argument. + + tuple_factory (~typing.Callable): + A callable to produce tuples from. For example, to produce lists + instead of tuples. + + retain_collection_types (bool): + Do not convert to `list` or `dict` when encountering an attribute + which type is `tuple`, `dict` or `set`. Only meaningful if + *recurse* is `True`. + + Returns: + Return type of *tuple_factory* + + Raises: + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class. + + .. versionadded:: 16.2.0 + """ + attrs = fields(inst.__class__) + rv = [] + retain = retain_collection_types # Very long. :/ + for a in attrs: + v = getattr(inst, a.name) + if filter is not None and not filter(a, v): + continue + value_type = type(v) + if recurse is True: + if value_type in _ATOMIC_TYPES: + rv.append(v) + elif has(value_type): + rv.append( + astuple( + v, + recurse=True, + filter=filter, + tuple_factory=tuple_factory, + retain_collection_types=retain, + ) + ) + elif issubclass(value_type, (tuple, list, set, frozenset)): + cf = v.__class__ if retain is True else list + items = [ + ( + astuple( + j, + recurse=True, + filter=filter, + tuple_factory=tuple_factory, + retain_collection_types=retain, + ) + if has(j.__class__) + else j + ) + for j in v + ] + try: + rv.append(cf(items)) + except TypeError: + if not issubclass(cf, tuple): + raise + # Workaround for TypeError: cf.__new__() missing 1 required + # positional argument (which appears, for a namedturle) + rv.append(cf(*items)) + elif issubclass(value_type, dict): + df = value_type if retain is True else dict + rv.append( + df( + ( + ( + astuple( + kk, + tuple_factory=tuple_factory, + retain_collection_types=retain, + ) + if has(kk.__class__) + else kk + ), + ( + astuple( + vv, + tuple_factory=tuple_factory, + retain_collection_types=retain, + ) + if has(vv.__class__) + else vv + ), + ) + for kk, vv in v.items() + ) + ) + else: + rv.append(v) + else: + rv.append(v) + + return rv if tuple_factory is list else tuple_factory(rv) + + +def has(cls): + """ + Check whether *cls* is a class with *attrs* attributes. + + Args: + cls (type): Class to introspect. + + Raises: + TypeError: If *cls* is not a class. + + Returns: + bool: + """ + attrs = getattr(cls, "__attrs_attrs__", None) + if attrs is not None: + return True + + # No attrs, maybe it's a specialized generic (A[str])? + generic_base = get_generic_base(cls) + if generic_base is not None: + generic_attrs = getattr(generic_base, "__attrs_attrs__", None) + if generic_attrs is not None: + # Stick it on here for speed next time. + cls.__attrs_attrs__ = generic_attrs + return generic_attrs is not None + return False + + +def assoc(inst, **changes): + """ + Copy *inst* and apply *changes*. + + This is different from `evolve` that applies the changes to the arguments + that create the new instance. + + `evolve`'s behavior is preferable, but there are `edge cases`_ where it + doesn't work. Therefore `assoc` is deprecated, but will not be removed. + + .. _`edge cases`: https://github.com/python-attrs/attrs/issues/251 + + Args: + inst: Instance of a class with *attrs* attributes. + + changes: Keyword changes in the new copy. + + Returns: + A copy of inst with *changes* incorporated. + + Raises: + attrs.exceptions.AttrsAttributeNotFoundError: + If *attr_name* couldn't be found on *cls*. + + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class. + + .. deprecated:: 17.1.0 + Use `attrs.evolve` instead if you can. This function will not be + removed du to the slightly different approach compared to + `attrs.evolve`, though. + """ + new = copy.copy(inst) + attrs = fields(inst.__class__) + for k, v in changes.items(): + a = getattr(attrs, k, NOTHING) + if a is NOTHING: + msg = f"{k} is not an attrs attribute on {new.__class__}." + raise AttrsAttributeNotFoundError(msg) + _OBJ_SETATTR(new, k, v) + return new + + +def resolve_types( + cls, globalns=None, localns=None, attribs=None, include_extras=True +): + """ + Resolve any strings and forward annotations in type annotations. + + This is only required if you need concrete types in :class:`Attribute`'s + *type* field. In other words, you don't need to resolve your types if you + only use them for static type checking. + + With no arguments, names will be looked up in the module in which the class + was created. If this is not what you want, for example, if the name only + exists inside a method, you may pass *globalns* or *localns* to specify + other dictionaries in which to look up these names. See the docs of + `typing.get_type_hints` for more details. + + Args: + cls (type): Class to resolve. + + globalns (dict | None): Dictionary containing global variables. + + localns (dict | None): Dictionary containing local variables. + + attribs (list | None): + List of attribs for the given class. This is necessary when calling + from inside a ``field_transformer`` since *cls* is not an *attrs* + class yet. + + include_extras (bool): + Resolve more accurately, if possible. Pass ``include_extras`` to + ``typing.get_hints``, if supported by the typing module. On + supported Python versions (3.9+), this resolves the types more + accurately. + + Raises: + TypeError: If *cls* is not a class. + + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class and you didn't pass any attribs. + + NameError: If types cannot be resolved because of missing variables. + + Returns: + *cls* so you can use this function also as a class decorator. Please + note that you have to apply it **after** `attrs.define`. That means the + decorator has to come in the line **before** `attrs.define`. + + .. versionadded:: 20.1.0 + .. versionadded:: 21.1.0 *attribs* + .. versionadded:: 23.1.0 *include_extras* + """ + # Since calling get_type_hints is expensive we cache whether we've + # done it already. + if getattr(cls, "__attrs_types_resolved__", None) != cls: + import typing + + kwargs = { + "globalns": globalns, + "localns": localns, + "include_extras": include_extras, + } + + hints = typing.get_type_hints(cls, **kwargs) + for field in fields(cls) if attribs is None else attribs: + if field.name in hints: + # Since fields have been frozen we must work around it. + _OBJ_SETATTR(field, "type", hints[field.name]) + # We store the class we resolved so that subclasses know they haven't + # been resolved. + cls.__attrs_types_resolved__ = cls + + # Return the class so you can use it as a decorator too. + return cls diff --git a/env/lib/python3.12/site-packages/attr/_make.py b/env/lib/python3.12/site-packages/attr/_make.py new file mode 100644 index 0000000..d24d9ba --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/_make.py @@ -0,0 +1,3362 @@ +# SPDX-License-Identifier: MIT + +from __future__ import annotations + +import abc +import contextlib +import copy +import enum +import inspect +import itertools +import linecache +import sys +import types +import unicodedata +import weakref + +from collections.abc import Callable, Mapping +from functools import cached_property +from typing import Any, NamedTuple, TypeVar + +# We need to import _compat itself in addition to the _compat members to avoid +# having the thread-local in the globals here. +from . import _compat, _config, setters +from ._compat import ( + PY_3_10_PLUS, + PY_3_11_PLUS, + PY_3_13_PLUS, + _AnnotationExtractor, + _get_annotations, + get_generic_base, +) +from .exceptions import ( + DefaultAlreadySetError, + FrozenInstanceError, + NotAnAttrsClassError, + UnannotatedAttributeError, +) + + +# This is used at least twice, so cache it here. +_OBJ_SETATTR = object.__setattr__ +_INIT_FACTORY_PAT = "__attr_factory_%s" +_CLASSVAR_PREFIXES = ( + "typing.ClassVar", + "t.ClassVar", + "ClassVar", + "typing_extensions.ClassVar", +) +# we don't use a double-underscore prefix because that triggers +# name mangling when trying to create a slot for the field +# (when slots=True) +_HASH_CACHE_FIELD = "_attrs_cached_hash" + +_EMPTY_METADATA_SINGLETON = types.MappingProxyType({}) + +# Unique object for unequivocal getattr() defaults. +_SENTINEL = object() + +_DEFAULT_ON_SETATTR = setters.pipe(setters.convert, setters.validate) + + +class _Nothing(enum.Enum): + """ + Sentinel to indicate the lack of a value when `None` is ambiguous. + + If extending attrs, you can use ``typing.Literal[NOTHING]`` to show + that a value may be ``NOTHING``. + + .. versionchanged:: 21.1.0 ``bool(NOTHING)`` is now False. + .. versionchanged:: 22.2.0 ``NOTHING`` is now an ``enum.Enum`` variant. + """ + + NOTHING = enum.auto() + + def __repr__(self): + return "NOTHING" + + def __bool__(self): + return False + + +NOTHING = _Nothing.NOTHING +""" +Sentinel to indicate the lack of a value when `None` is ambiguous. + +When using in 3rd party code, use `attrs.NothingType` for type annotations. +""" + + +class _CacheHashWrapper(int): + """ + An integer subclass that pickles / copies as None + + This is used for non-slots classes with ``cache_hash=True``, to avoid + serializing a potentially (even likely) invalid hash value. Since `None` + is the default value for uncalculated hashes, whenever this is copied, + the copy's value for the hash should automatically reset. + + See GH #613 for more details. + """ + + def __reduce__(self, _none_constructor=type(None), _args=()): # noqa: B008 + return _none_constructor, _args + + +def attrib( + default=NOTHING, + validator=None, + repr=True, + cmp=None, + hash=None, + init=True, + metadata=None, + type=None, + converter=None, + factory=None, + kw_only=None, + eq=None, + order=None, + on_setattr=None, + alias=None, +): + """ + Create a new field / attribute on a class. + + Identical to `attrs.field`, except it's not keyword-only. + + Consider using `attrs.field` in new code (``attr.ib`` will *never* go away, + though). + + .. warning:: + + Does **nothing** unless the class is also decorated with + `attr.s` (or similar)! + + + .. versionadded:: 15.2.0 *convert* + .. versionadded:: 16.3.0 *metadata* + .. versionchanged:: 17.1.0 *validator* can be a ``list`` now. + .. versionchanged:: 17.1.0 + *hash* is `None` and therefore mirrors *eq* by default. + .. versionadded:: 17.3.0 *type* + .. deprecated:: 17.4.0 *convert* + .. versionadded:: 17.4.0 + *converter* as a replacement for the deprecated *convert* to achieve + consistency with other noun-based arguments. + .. versionadded:: 18.1.0 + ``factory=f`` is syntactic sugar for ``default=attr.Factory(f)``. + .. versionadded:: 18.2.0 *kw_only* + .. versionchanged:: 19.2.0 *convert* keyword argument removed. + .. versionchanged:: 19.2.0 *repr* also accepts a custom callable. + .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01. + .. versionadded:: 19.2.0 *eq* and *order* + .. versionadded:: 20.1.0 *on_setattr* + .. versionchanged:: 20.3.0 *kw_only* backported to Python 2 + .. versionchanged:: 21.1.0 + *eq*, *order*, and *cmp* also accept a custom callable + .. versionchanged:: 21.1.0 *cmp* undeprecated + .. versionadded:: 22.2.0 *alias* + .. versionchanged:: 25.4.0 + *kw_only* can now be None, and its default is also changed from False to + None. + """ + eq, eq_key, order, order_key = _determine_attrib_eq_order( + cmp, eq, order, True + ) + + if hash is not None and hash is not True and hash is not False: + msg = "Invalid value for hash. Must be True, False, or None." + raise TypeError(msg) + + if factory is not None: + if default is not NOTHING: + msg = ( + "The `default` and `factory` arguments are mutually exclusive." + ) + raise ValueError(msg) + if not callable(factory): + msg = "The `factory` argument must be a callable." + raise ValueError(msg) + default = Factory(factory) + + if metadata is None: + metadata = {} + + # Apply syntactic sugar by auto-wrapping. + if isinstance(on_setattr, (list, tuple)): + on_setattr = setters.pipe(*on_setattr) + + if validator and isinstance(validator, (list, tuple)): + validator = and_(*validator) + + if converter and isinstance(converter, (list, tuple)): + converter = pipe(*converter) + + return _CountingAttr( + default=default, + validator=validator, + repr=repr, + cmp=None, + hash=hash, + init=init, + converter=converter, + metadata=metadata, + type=type, + kw_only=kw_only, + eq=eq, + eq_key=eq_key, + order=order, + order_key=order_key, + on_setattr=on_setattr, + alias=alias, + ) + + +def _compile_and_eval( + script: str, + globs: dict[str, Any] | None, + locs: Mapping[str, object] | None = None, + filename: str = "", +) -> None: + """ + Evaluate the script with the given global (globs) and local (locs) + variables. + """ + bytecode = compile(script, filename, "exec") + eval(bytecode, globs, locs) + + +def _linecache_and_compile( + script: str, + filename: str, + globs: dict[str, Any] | None, + locals: Mapping[str, object] | None = None, +) -> dict[str, Any]: + """ + Cache the script with _linecache_, compile it and return the _locals_. + """ + + locs = {} if locals is None else locals + + # In order of debuggers like PDB being able to step through the code, + # we add a fake linecache entry. + count = 1 + base_filename = filename + while True: + linecache_tuple = ( + len(script), + None, + script.splitlines(True), + filename, + ) + old_val = linecache.cache.setdefault(filename, linecache_tuple) + if old_val == linecache_tuple: + break + + filename = f"{base_filename[:-1]}-{count}>" + count += 1 + + _compile_and_eval(script, globs, locs, filename) + + return locs + + +def _make_attr_tuple_class(cls_name: str, attr_names: list[str]) -> type: + """ + Create a tuple subclass to hold `Attribute`s for an `attrs` class. + + The subclass is a bare tuple with properties for names. + + class MyClassAttributes(tuple): + __slots__ = () + x = property(itemgetter(0)) + """ + attr_class_name = f"{cls_name}Attributes" + body = {} + for i, attr_name in enumerate(attr_names): + + def getter(self, i=i): + return self[i] + + body[attr_name] = property(getter) + return type(attr_class_name, (tuple,), body) + + +# Tuple class for extracted attributes from a class definition. +# `base_attrs` is a subset of `attrs`. +class _Attributes(NamedTuple): + attrs: type + base_attrs: list[Attribute] + base_attrs_map: dict[str, type] + + +def _is_class_var(annot): + """ + Check whether *annot* is a typing.ClassVar. + + The string comparison hack is used to avoid evaluating all string + annotations which would put attrs-based classes at a performance + disadvantage compared to plain old classes. + """ + annot = str(annot) + + # Annotation can be quoted. + if annot.startswith(("'", '"')) and annot.endswith(("'", '"')): + annot = annot[1:-1] + + return annot.startswith(_CLASSVAR_PREFIXES) + + +def _has_own_attribute(cls, attrib_name): + """ + Check whether *cls* defines *attrib_name* (and doesn't just inherit it). + """ + return attrib_name in cls.__dict__ + + +def _collect_base_attrs( + cls, taken_attr_names +) -> tuple[list[Attribute], dict[str, type]]: + """ + Collect attr.ibs from base classes of *cls*, except *taken_attr_names*. + """ + base_attrs = [] + base_attr_map = {} # A dictionary of base attrs to their classes. + + # Traverse the MRO and collect attributes. + for base_cls in reversed(cls.__mro__[1:-1]): + for a in getattr(base_cls, "__attrs_attrs__", []): + if a.inherited or a.name in taken_attr_names: + continue + + a = a.evolve(inherited=True) # noqa: PLW2901 + base_attrs.append(a) + base_attr_map[a.name] = base_cls + + # For each name, only keep the freshest definition i.e. the furthest at the + # back. base_attr_map is fine because it gets overwritten with every new + # instance. + filtered = [] + seen = set() + for a in reversed(base_attrs): + if a.name in seen: + continue + filtered.insert(0, a) + seen.add(a.name) + + return filtered, base_attr_map + + +def _collect_base_attrs_broken(cls, taken_attr_names): + """ + Collect attr.ibs from base classes of *cls*, except *taken_attr_names*. + + N.B. *taken_attr_names* will be mutated. + + Adhere to the old incorrect behavior. + + Notably it collects from the front and considers inherited attributes which + leads to the buggy behavior reported in #428. + """ + base_attrs = [] + base_attr_map = {} # A dictionary of base attrs to their classes. + + # Traverse the MRO and collect attributes. + for base_cls in cls.__mro__[1:-1]: + for a in getattr(base_cls, "__attrs_attrs__", []): + if a.name in taken_attr_names: + continue + + a = a.evolve(inherited=True) # noqa: PLW2901 + taken_attr_names.add(a.name) + base_attrs.append(a) + base_attr_map[a.name] = base_cls + + return base_attrs, base_attr_map + + +def _transform_attrs( + cls, + these, + auto_attribs, + kw_only, + collect_by_mro, + field_transformer, +) -> _Attributes: + """ + Transform all `_CountingAttr`s on a class into `Attribute`s. + + If *these* is passed, use that and don't look for them on the class. + + If *collect_by_mro* is True, collect them in the correct MRO order, + otherwise use the old -- incorrect -- order. See #428. + + Return an `_Attributes`. + """ + cd = cls.__dict__ + anns = _get_annotations(cls) + + if these is not None: + ca_list = list(these.items()) + elif auto_attribs is True: + ca_names = { + name + for name, attr in cd.items() + if attr.__class__ is _CountingAttr + } + ca_list = [] + annot_names = set() + for attr_name, type in anns.items(): + if _is_class_var(type): + continue + annot_names.add(attr_name) + a = cd.get(attr_name, NOTHING) + + if a.__class__ is not _CountingAttr: + a = attrib(a) + ca_list.append((attr_name, a)) + + unannotated = ca_names - annot_names + if unannotated: + raise UnannotatedAttributeError( + "The following `attr.ib`s lack a type annotation: " + + ", ".join( + sorted(unannotated, key=lambda n: cd.get(n).counter) + ) + + "." + ) + else: + ca_list = sorted( + ( + (name, attr) + for name, attr in cd.items() + if attr.__class__ is _CountingAttr + ), + key=lambda e: e[1].counter, + ) + + fca = Attribute.from_counting_attr + no = ClassProps.KeywordOnly.NO + own_attrs = [ + fca( + attr_name, + ca, + kw_only is not no, + anns.get(attr_name), + ) + for attr_name, ca in ca_list + ] + + if collect_by_mro: + base_attrs, base_attr_map = _collect_base_attrs( + cls, {a.name for a in own_attrs} + ) + else: + base_attrs, base_attr_map = _collect_base_attrs_broken( + cls, {a.name for a in own_attrs} + ) + + if kw_only is ClassProps.KeywordOnly.FORCE: + own_attrs = [a.evolve(kw_only=True) for a in own_attrs] + base_attrs = [a.evolve(kw_only=True) for a in base_attrs] + + attrs = base_attrs + own_attrs + + if field_transformer is not None: + attrs = tuple(field_transformer(cls, attrs)) + + # Check attr order after executing the field_transformer. + # Mandatory vs non-mandatory attr order only matters when they are part of + # the __init__ signature and when they aren't kw_only (which are moved to + # the end and can be mandatory or non-mandatory in any order, as they will + # be specified as keyword args anyway). Check the order of those attrs: + had_default = False + for a in (a for a in attrs if a.init is not False and a.kw_only is False): + if had_default is True and a.default is NOTHING: + msg = f"No mandatory attributes allowed after an attribute with a default value or factory. Attribute in question: {a!r}" + raise ValueError(msg) + + if had_default is False and a.default is not NOTHING: + had_default = True + + # Resolve default field alias after executing field_transformer. + # This allows field_transformer to differentiate between explicit vs + # default aliases and supply their own defaults. + for a in attrs: + if not a.alias: + # Evolve is very slow, so we hold our nose and do it dirty. + _OBJ_SETATTR.__get__(a)("alias", _default_init_alias_for(a.name)) + + # Create AttrsClass *after* applying the field_transformer since it may + # add or remove attributes! + attr_names = [a.name for a in attrs] + AttrsClass = _make_attr_tuple_class(cls.__name__, attr_names) + + return _Attributes(AttrsClass(attrs), base_attrs, base_attr_map) + + +def _make_cached_property_getattr(cached_properties, original_getattr, cls): + lines = [ + # Wrapped to get `__class__` into closure cell for super() + # (It will be replaced with the newly constructed class after construction). + "def wrapper(_cls):", + " __class__ = _cls", + " def __getattr__(self, item, cached_properties=cached_properties, original_getattr=original_getattr, _cached_setattr_get=_cached_setattr_get):", + " func = cached_properties.get(item)", + " if func is not None:", + " result = func(self)", + " _setter = _cached_setattr_get(self)", + " _setter(item, result)", + " return result", + ] + if original_getattr is not None: + lines.append( + " return original_getattr(self, item)", + ) + else: + lines.extend( + [ + " try:", + " return super().__getattribute__(item)", + " except AttributeError:", + " if not hasattr(super(), '__getattr__'):", + " raise", + " return super().__getattr__(item)", + " original_error = f\"'{self.__class__.__name__}' object has no attribute '{item}'\"", + " raise AttributeError(original_error)", + ] + ) + + lines.extend( + [ + " return __getattr__", + "__getattr__ = wrapper(_cls)", + ] + ) + + unique_filename = _generate_unique_filename(cls, "getattr") + + glob = { + "cached_properties": cached_properties, + "_cached_setattr_get": _OBJ_SETATTR.__get__, + "original_getattr": original_getattr, + } + + return _linecache_and_compile( + "\n".join(lines), unique_filename, glob, locals={"_cls": cls} + )["__getattr__"] + + +def _frozen_setattrs(self, name, value): + """ + Attached to frozen classes as __setattr__. + """ + if isinstance(self, BaseException) and name in ( + "__cause__", + "__context__", + "__traceback__", + "__suppress_context__", + "__notes__", + ): + BaseException.__setattr__(self, name, value) + return + + raise FrozenInstanceError + + +def _frozen_delattrs(self, name): + """ + Attached to frozen classes as __delattr__. + """ + if isinstance(self, BaseException) and name in ("__notes__",): + BaseException.__delattr__(self, name) + return + + raise FrozenInstanceError + + +def evolve(*args, **changes): + """ + Create a new instance, based on the first positional argument with + *changes* applied. + + .. tip:: + + On Python 3.13 and later, you can also use `copy.replace` instead. + + Args: + + inst: + Instance of a class with *attrs* attributes. *inst* must be passed + as a positional argument. + + changes: + Keyword changes in the new copy. + + Returns: + A copy of inst with *changes* incorporated. + + Raises: + TypeError: + If *attr_name* couldn't be found in the class ``__init__``. + + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class. + + .. versionadded:: 17.1.0 + .. deprecated:: 23.1.0 + It is now deprecated to pass the instance using the keyword argument + *inst*. It will raise a warning until at least April 2024, after which + it will become an error. Always pass the instance as a positional + argument. + .. versionchanged:: 24.1.0 + *inst* can't be passed as a keyword argument anymore. + """ + try: + (inst,) = args + except ValueError: + msg = ( + f"evolve() takes 1 positional argument, but {len(args)} were given" + ) + raise TypeError(msg) from None + + cls = inst.__class__ + attrs = fields(cls) + for a in attrs: + if not a.init: + continue + attr_name = a.name # To deal with private attributes. + init_name = a.alias + if init_name not in changes: + changes[init_name] = getattr(inst, attr_name) + + return cls(**changes) + + +class _ClassBuilder: + """ + Iteratively build *one* class. + """ + + __slots__ = ( + "_add_method_dunders", + "_attr_names", + "_attrs", + "_base_attr_map", + "_base_names", + "_cache_hash", + "_cls", + "_cls_dict", + "_delete_attribs", + "_frozen", + "_has_custom_setattr", + "_has_post_init", + "_has_pre_init", + "_is_exc", + "_on_setattr", + "_pre_init_has_args", + "_repr_added", + "_script_snippets", + "_slots", + "_weakref_slot", + "_wrote_own_setattr", + ) + + def __init__( + self, + cls: type, + these, + auto_attribs: bool, + props: ClassProps, + has_custom_setattr: bool, + ): + attrs, base_attrs, base_map = _transform_attrs( + cls, + these, + auto_attribs, + props.kw_only, + props.collected_fields_by_mro, + props.field_transformer, + ) + + self._cls = cls + self._cls_dict = dict(cls.__dict__) if props.is_slotted else {} + self._attrs = attrs + self._base_names = {a.name for a in base_attrs} + self._base_attr_map = base_map + self._attr_names = tuple(a.name for a in attrs) + self._slots = props.is_slotted + self._frozen = props.is_frozen + self._weakref_slot = props.has_weakref_slot + self._cache_hash = ( + props.hashability is ClassProps.Hashability.HASHABLE_CACHED + ) + self._has_pre_init = bool(getattr(cls, "__attrs_pre_init__", False)) + self._pre_init_has_args = False + if self._has_pre_init: + # Check if the pre init method has more arguments than just `self` + # We want to pass arguments if pre init expects arguments + pre_init_func = cls.__attrs_pre_init__ + pre_init_signature = inspect.signature(pre_init_func) + self._pre_init_has_args = len(pre_init_signature.parameters) > 1 + self._has_post_init = bool(getattr(cls, "__attrs_post_init__", False)) + self._delete_attribs = not bool(these) + self._is_exc = props.is_exception + self._on_setattr = props.on_setattr_hook + + self._has_custom_setattr = has_custom_setattr + self._wrote_own_setattr = False + + self._cls_dict["__attrs_attrs__"] = self._attrs + self._cls_dict["__attrs_props__"] = props + + if props.is_frozen: + self._cls_dict["__setattr__"] = _frozen_setattrs + self._cls_dict["__delattr__"] = _frozen_delattrs + + self._wrote_own_setattr = True + elif self._on_setattr in ( + _DEFAULT_ON_SETATTR, + setters.validate, + setters.convert, + ): + has_validator = has_converter = False + for a in attrs: + if a.validator is not None: + has_validator = True + if a.converter is not None: + has_converter = True + + if has_validator and has_converter: + break + if ( + ( + self._on_setattr == _DEFAULT_ON_SETATTR + and not (has_validator or has_converter) + ) + or (self._on_setattr == setters.validate and not has_validator) + or (self._on_setattr == setters.convert and not has_converter) + ): + # If class-level on_setattr is set to convert + validate, but + # there's no field to convert or validate, pretend like there's + # no on_setattr. + self._on_setattr = None + + if props.added_pickling: + ( + self._cls_dict["__getstate__"], + self._cls_dict["__setstate__"], + ) = self._make_getstate_setstate() + + # tuples of script, globs, hook + self._script_snippets: list[ + tuple[str, dict, Callable[[dict, dict], Any]] + ] = [] + self._repr_added = False + + # We want to only do this check once; in 99.9% of cases these + # exist. + if not hasattr(self._cls, "__module__") or not hasattr( + self._cls, "__qualname__" + ): + self._add_method_dunders = self._add_method_dunders_safe + else: + self._add_method_dunders = self._add_method_dunders_unsafe + + def __repr__(self): + return f"<_ClassBuilder(cls={self._cls.__name__})>" + + def _eval_snippets(self) -> None: + """ + Evaluate any registered snippets in one go. + """ + script = "\n".join([snippet[0] for snippet in self._script_snippets]) + globs = {} + for _, snippet_globs, _ in self._script_snippets: + globs.update(snippet_globs) + + locs = _linecache_and_compile( + script, + _generate_unique_filename(self._cls, "methods"), + globs, + ) + + for _, _, hook in self._script_snippets: + hook(self._cls_dict, locs) + + def build_class(self): + """ + Finalize class based on the accumulated configuration. + + Builder cannot be used after calling this method. + """ + self._eval_snippets() + if self._slots is True: + cls = self._create_slots_class() + self._cls.__attrs_base_of_slotted__ = weakref.ref(cls) + else: + cls = self._patch_original_class() + if PY_3_10_PLUS: + cls = abc.update_abstractmethods(cls) + + # The method gets only called if it's not inherited from a base class. + # _has_own_attribute does NOT work properly for classmethods. + if ( + getattr(cls, "__attrs_init_subclass__", None) + and "__attrs_init_subclass__" not in cls.__dict__ + ): + cls.__attrs_init_subclass__() + + return cls + + def _patch_original_class(self): + """ + Apply accumulated methods and return the class. + """ + cls = self._cls + base_names = self._base_names + + # Clean class of attribute definitions (`attr.ib()`s). + if self._delete_attribs: + for name in self._attr_names: + if ( + name not in base_names + and getattr(cls, name, _SENTINEL) is not _SENTINEL + ): + # An AttributeError can happen if a base class defines a + # class variable and we want to set an attribute with the + # same name by using only a type annotation. + with contextlib.suppress(AttributeError): + delattr(cls, name) + + # Attach our dunder methods. + for name, value in self._cls_dict.items(): + setattr(cls, name, value) + + # If we've inherited an attrs __setattr__ and don't write our own, + # reset it to object's. + if not self._wrote_own_setattr and getattr( + cls, "__attrs_own_setattr__", False + ): + cls.__attrs_own_setattr__ = False + + if not self._has_custom_setattr: + cls.__setattr__ = _OBJ_SETATTR + + return cls + + def _create_slots_class(self): + """ + Build and return a new class with a `__slots__` attribute. + """ + cd = { + k: v + for k, v in self._cls_dict.items() + if k not in (*tuple(self._attr_names), "__dict__", "__weakref__") + } + + # 3.14.0rc2+ + if hasattr(sys, "_clear_type_descriptors"): + sys._clear_type_descriptors(self._cls) + + # If our class doesn't have its own implementation of __setattr__ + # (either from the user or by us), check the bases, if one of them has + # an attrs-made __setattr__, that needs to be reset. We don't walk the + # MRO because we only care about our immediate base classes. + # XXX: This can be confused by subclassing a slotted attrs class with + # XXX: a non-attrs class and subclass the resulting class with an attrs + # XXX: class. See `test_slotted_confused` for details. For now that's + # XXX: OK with us. + if not self._wrote_own_setattr: + cd["__attrs_own_setattr__"] = False + + if not self._has_custom_setattr: + for base_cls in self._cls.__bases__: + if base_cls.__dict__.get("__attrs_own_setattr__", False): + cd["__setattr__"] = _OBJ_SETATTR + break + + # Traverse the MRO to collect existing slots + # and check for an existing __weakref__. + existing_slots = {} + weakref_inherited = False + for base_cls in self._cls.__mro__[1:-1]: + if base_cls.__dict__.get("__weakref__", None) is not None: + weakref_inherited = True + existing_slots.update( + { + name: getattr(base_cls, name) + for name in getattr(base_cls, "__slots__", []) + } + ) + + base_names = set(self._base_names) + + names = self._attr_names + if ( + self._weakref_slot + and "__weakref__" not in getattr(self._cls, "__slots__", ()) + and "__weakref__" not in names + and not weakref_inherited + ): + names += ("__weakref__",) + + cached_properties = { + name: cached_prop.func + for name, cached_prop in cd.items() + if isinstance(cached_prop, cached_property) + } + + # Collect methods with a `__class__` reference that are shadowed in the new class. + # To know to update them. + additional_closure_functions_to_update = [] + if cached_properties: + class_annotations = _get_annotations(self._cls) + for name, func in cached_properties.items(): + # Add cached properties to names for slotting. + names += (name,) + # Clear out function from class to avoid clashing. + del cd[name] + additional_closure_functions_to_update.append(func) + annotation = inspect.signature(func).return_annotation + if annotation is not inspect.Parameter.empty: + class_annotations[name] = annotation + + original_getattr = cd.get("__getattr__") + if original_getattr is not None: + additional_closure_functions_to_update.append(original_getattr) + + cd["__getattr__"] = _make_cached_property_getattr( + cached_properties, original_getattr, self._cls + ) + + # We only add the names of attributes that aren't inherited. + # Setting __slots__ to inherited attributes wastes memory. + slot_names = [name for name in names if name not in base_names] + + # There are slots for attributes from current class + # that are defined in parent classes. + # As their descriptors may be overridden by a child class, + # we collect them here and update the class dict + reused_slots = { + slot: slot_descriptor + for slot, slot_descriptor in existing_slots.items() + if slot in slot_names + } + slot_names = [name for name in slot_names if name not in reused_slots] + cd.update(reused_slots) + if self._cache_hash: + slot_names.append(_HASH_CACHE_FIELD) + + cd["__slots__"] = tuple(slot_names) + + cd["__qualname__"] = self._cls.__qualname__ + + # Create new class based on old class and our methods. + cls = type(self._cls)(self._cls.__name__, self._cls.__bases__, cd) + + # The following is a fix for + # . + # If a method mentions `__class__` or uses the no-arg super(), the + # compiler will bake a reference to the class in the method itself + # as `method.__closure__`. Since we replace the class with a + # clone, we rewrite these references so it keeps working. + for item in itertools.chain( + cls.__dict__.values(), additional_closure_functions_to_update + ): + if isinstance(item, (classmethod, staticmethod)): + # Class- and staticmethods hide their functions inside. + # These might need to be rewritten as well. + closure_cells = getattr(item.__func__, "__closure__", None) + elif isinstance(item, property): + # Workaround for property `super()` shortcut (PY3-only). + # There is no universal way for other descriptors. + closure_cells = getattr(item.fget, "__closure__", None) + else: + closure_cells = getattr(item, "__closure__", None) + + if not closure_cells: # Catch None or the empty list. + continue + for cell in closure_cells: + try: + match = cell.cell_contents is self._cls + except ValueError: # noqa: PERF203 + # ValueError: Cell is empty + pass + else: + if match: + cell.cell_contents = cls + return cls + + def add_repr(self, ns): + script, globs = _make_repr_script(self._attrs, ns) + + def _attach_repr(cls_dict, globs): + cls_dict["__repr__"] = self._add_method_dunders(globs["__repr__"]) + + self._script_snippets.append((script, globs, _attach_repr)) + self._repr_added = True + return self + + def add_str(self): + if not self._repr_added: + msg = "__str__ can only be generated if a __repr__ exists." + raise ValueError(msg) + + def __str__(self): + return self.__repr__() + + self._cls_dict["__str__"] = self._add_method_dunders(__str__) + return self + + def _make_getstate_setstate(self): + """ + Create custom __setstate__ and __getstate__ methods. + """ + # __weakref__ is not writable. + state_attr_names = tuple( + an for an in self._attr_names if an != "__weakref__" + ) + + def slots_getstate(self): + """ + Automatically created by attrs. + """ + return {name: getattr(self, name) for name in state_attr_names} + + hash_caching_enabled = self._cache_hash + + def slots_setstate(self, state): + """ + Automatically created by attrs. + """ + __bound_setattr = _OBJ_SETATTR.__get__(self) + if isinstance(state, tuple): + # Backward compatibility with attrs instances pickled with + # attrs versions before v22.2.0 which stored tuples. + for name, value in zip(state_attr_names, state): + __bound_setattr(name, value) + else: + for name in state_attr_names: + if name in state: + __bound_setattr(name, state[name]) + + # The hash code cache is not included when the object is + # serialized, but it still needs to be initialized to None to + # indicate that the first call to __hash__ should be a cache + # miss. + if hash_caching_enabled: + __bound_setattr(_HASH_CACHE_FIELD, None) + + return slots_getstate, slots_setstate + + def make_unhashable(self): + self._cls_dict["__hash__"] = None + return self + + def add_hash(self): + script, globs = _make_hash_script( + self._cls, + self._attrs, + frozen=self._frozen, + cache_hash=self._cache_hash, + ) + + def attach_hash(cls_dict: dict, locs: dict) -> None: + cls_dict["__hash__"] = self._add_method_dunders(locs["__hash__"]) + + self._script_snippets.append((script, globs, attach_hash)) + + return self + + def add_init(self): + script, globs, annotations = _make_init_script( + self._cls, + self._attrs, + self._has_pre_init, + self._pre_init_has_args, + self._has_post_init, + self._frozen, + self._slots, + self._cache_hash, + self._base_attr_map, + self._is_exc, + self._on_setattr, + attrs_init=False, + ) + + def _attach_init(cls_dict, globs): + init = globs["__init__"] + init.__annotations__ = annotations + cls_dict["__init__"] = self._add_method_dunders(init) + + self._script_snippets.append((script, globs, _attach_init)) + + return self + + def add_replace(self): + self._cls_dict["__replace__"] = self._add_method_dunders( + lambda self, **changes: evolve(self, **changes) + ) + return self + + def add_match_args(self): + self._cls_dict["__match_args__"] = tuple( + field.name + for field in self._attrs + if field.init and not field.kw_only + ) + + def add_attrs_init(self): + script, globs, annotations = _make_init_script( + self._cls, + self._attrs, + self._has_pre_init, + self._pre_init_has_args, + self._has_post_init, + self._frozen, + self._slots, + self._cache_hash, + self._base_attr_map, + self._is_exc, + self._on_setattr, + attrs_init=True, + ) + + def _attach_attrs_init(cls_dict, globs): + init = globs["__attrs_init__"] + init.__annotations__ = annotations + cls_dict["__attrs_init__"] = self._add_method_dunders(init) + + self._script_snippets.append((script, globs, _attach_attrs_init)) + + return self + + def add_eq(self): + cd = self._cls_dict + + script, globs = _make_eq_script(self._attrs) + + def _attach_eq(cls_dict, globs): + cls_dict["__eq__"] = self._add_method_dunders(globs["__eq__"]) + + self._script_snippets.append((script, globs, _attach_eq)) + + cd["__ne__"] = __ne__ + + return self + + def add_order(self): + cd = self._cls_dict + + cd["__lt__"], cd["__le__"], cd["__gt__"], cd["__ge__"] = ( + self._add_method_dunders(meth) + for meth in _make_order(self._cls, self._attrs) + ) + + return self + + def add_setattr(self): + sa_attrs = {} + for a in self._attrs: + on_setattr = a.on_setattr or self._on_setattr + if on_setattr and on_setattr is not setters.NO_OP: + sa_attrs[a.name] = a, on_setattr + + if not sa_attrs: + return self + + if self._has_custom_setattr: + # We need to write a __setattr__ but there already is one! + msg = "Can't combine custom __setattr__ with on_setattr hooks." + raise ValueError(msg) + + # docstring comes from _add_method_dunders + def __setattr__(self, name, val): + try: + a, hook = sa_attrs[name] + except KeyError: + nval = val + else: + nval = hook(self, a, val) + + _OBJ_SETATTR(self, name, nval) + + self._cls_dict["__attrs_own_setattr__"] = True + self._cls_dict["__setattr__"] = self._add_method_dunders(__setattr__) + self._wrote_own_setattr = True + + return self + + def _add_method_dunders_unsafe(self, method: Callable) -> Callable: + """ + Add __module__ and __qualname__ to a *method*. + """ + method.__module__ = self._cls.__module__ + + method.__qualname__ = f"{self._cls.__qualname__}.{method.__name__}" + + method.__doc__ = ( + f"Method generated by attrs for class {self._cls.__qualname__}." + ) + + return method + + def _add_method_dunders_safe(self, method: Callable) -> Callable: + """ + Add __module__ and __qualname__ to a *method* if possible. + """ + with contextlib.suppress(AttributeError): + method.__module__ = self._cls.__module__ + + with contextlib.suppress(AttributeError): + method.__qualname__ = f"{self._cls.__qualname__}.{method.__name__}" + + with contextlib.suppress(AttributeError): + method.__doc__ = f"Method generated by attrs for class {self._cls.__qualname__}." + + return method + + +def _determine_attrs_eq_order(cmp, eq, order, default_eq): + """ + Validate the combination of *cmp*, *eq*, and *order*. Derive the effective + values of eq and order. If *eq* is None, set it to *default_eq*. + """ + if cmp is not None and any((eq is not None, order is not None)): + msg = "Don't mix `cmp` with `eq' and `order`." + raise ValueError(msg) + + # cmp takes precedence due to bw-compatibility. + if cmp is not None: + return cmp, cmp + + # If left None, equality is set to the specified default and ordering + # mirrors equality. + if eq is None: + eq = default_eq + + if order is None: + order = eq + + if eq is False and order is True: + msg = "`order` can only be True if `eq` is True too." + raise ValueError(msg) + + return eq, order + + +def _determine_attrib_eq_order(cmp, eq, order, default_eq): + """ + Validate the combination of *cmp*, *eq*, and *order*. Derive the effective + values of eq and order. If *eq* is None, set it to *default_eq*. + """ + if cmp is not None and any((eq is not None, order is not None)): + msg = "Don't mix `cmp` with `eq' and `order`." + raise ValueError(msg) + + def decide_callable_or_boolean(value): + """ + Decide whether a key function is used. + """ + if callable(value): + value, key = True, value + else: + key = None + return value, key + + # cmp takes precedence due to bw-compatibility. + if cmp is not None: + cmp, cmp_key = decide_callable_or_boolean(cmp) + return cmp, cmp_key, cmp, cmp_key + + # If left None, equality is set to the specified default and ordering + # mirrors equality. + if eq is None: + eq, eq_key = default_eq, None + else: + eq, eq_key = decide_callable_or_boolean(eq) + + if order is None: + order, order_key = eq, eq_key + else: + order, order_key = decide_callable_or_boolean(order) + + if eq is False and order is True: + msg = "`order` can only be True if `eq` is True too." + raise ValueError(msg) + + return eq, eq_key, order, order_key + + +def _determine_whether_to_implement( + cls, flag, auto_detect, dunders, default=True +): + """ + Check whether we should implement a set of methods for *cls*. + + *flag* is the argument passed into @attr.s like 'init', *auto_detect* the + same as passed into @attr.s and *dunders* is a tuple of attribute names + whose presence signal that the user has implemented it themselves. + + Return *default* if no reason for either for or against is found. + """ + if flag is True or flag is False: + return flag + + if flag is None and auto_detect is False: + return default + + # Logically, flag is None and auto_detect is True here. + for dunder in dunders: + if _has_own_attribute(cls, dunder): + return False + + return default + + +def attrs( + maybe_cls=None, + these=None, + repr_ns=None, + repr=None, + cmp=None, + hash=None, + init=None, + slots=False, + frozen=False, + weakref_slot=True, + str=False, + auto_attribs=False, + kw_only=False, + cache_hash=False, + auto_exc=False, + eq=None, + order=None, + auto_detect=False, + collect_by_mro=False, + getstate_setstate=None, + on_setattr=None, + field_transformer=None, + match_args=True, + unsafe_hash=None, + force_kw_only=True, +): + r""" + A class decorator that adds :term:`dunder methods` according to the + specified attributes using `attr.ib` or the *these* argument. + + Consider using `attrs.define` / `attrs.frozen` in new code (``attr.s`` will + *never* go away, though). + + Args: + repr_ns (str): + When using nested classes, there was no way in Python 2 to + automatically detect that. This argument allows to set a custom + name for a more meaningful ``repr`` output. This argument is + pointless in Python 3 and is therefore deprecated. + + .. caution:: + Refer to `attrs.define` for the rest of the parameters, but note that they + can have different defaults. + + Notably, leaving *on_setattr* as `None` will **not** add any hooks. + + .. versionadded:: 16.0.0 *slots* + .. versionadded:: 16.1.0 *frozen* + .. versionadded:: 16.3.0 *str* + .. versionadded:: 16.3.0 Support for ``__attrs_post_init__``. + .. versionchanged:: 17.1.0 + *hash* supports `None` as value which is also the default now. + .. versionadded:: 17.3.0 *auto_attribs* + .. versionchanged:: 18.1.0 + If *these* is passed, no attributes are deleted from the class body. + .. versionchanged:: 18.1.0 If *these* is ordered, the order is retained. + .. versionadded:: 18.2.0 *weakref_slot* + .. deprecated:: 18.2.0 + ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now raise a + `DeprecationWarning` if the classes compared are subclasses of + each other. ``__eq`` and ``__ne__`` never tried to compared subclasses + to each other. + .. versionchanged:: 19.2.0 + ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now do not consider + subclasses comparable anymore. + .. versionadded:: 18.2.0 *kw_only* + .. versionadded:: 18.2.0 *cache_hash* + .. versionadded:: 19.1.0 *auto_exc* + .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01. + .. versionadded:: 19.2.0 *eq* and *order* + .. versionadded:: 20.1.0 *auto_detect* + .. versionadded:: 20.1.0 *collect_by_mro* + .. versionadded:: 20.1.0 *getstate_setstate* + .. versionadded:: 20.1.0 *on_setattr* + .. versionadded:: 20.3.0 *field_transformer* + .. versionchanged:: 21.1.0 + ``init=False`` injects ``__attrs_init__`` + .. versionchanged:: 21.1.0 Support for ``__attrs_pre_init__`` + .. versionchanged:: 21.1.0 *cmp* undeprecated + .. versionadded:: 21.3.0 *match_args* + .. versionadded:: 22.2.0 + *unsafe_hash* as an alias for *hash* (for :pep:`681` compliance). + .. deprecated:: 24.1.0 *repr_ns* + .. versionchanged:: 24.1.0 + Instances are not compared as tuples of attributes anymore, but using a + big ``and`` condition. This is faster and has more correct behavior for + uncomparable values like `math.nan`. + .. versionadded:: 24.1.0 + If a class has an *inherited* classmethod called + ``__attrs_init_subclass__``, it is executed after the class is created. + .. deprecated:: 24.1.0 *hash* is deprecated in favor of *unsafe_hash*. + .. versionchanged:: 25.4.0 + *kw_only* now only applies to attributes defined in the current class, + and respects attribute-level ``kw_only=False`` settings. + .. versionadded:: 25.4.0 *force_kw_only* + """ + if repr_ns is not None: + import warnings + + warnings.warn( + DeprecationWarning( + "The `repr_ns` argument is deprecated and will be removed in or after August 2025." + ), + stacklevel=2, + ) + + eq_, order_ = _determine_attrs_eq_order(cmp, eq, order, None) + + # unsafe_hash takes precedence due to PEP 681. + if unsafe_hash is not None: + hash = unsafe_hash + + if isinstance(on_setattr, (list, tuple)): + on_setattr = setters.pipe(*on_setattr) + + def wrap(cls): + nonlocal hash + is_frozen = frozen or _has_frozen_base_class(cls) + is_exc = auto_exc is True and issubclass(cls, BaseException) + has_own_setattr = auto_detect and _has_own_attribute( + cls, "__setattr__" + ) + + if has_own_setattr and is_frozen: + msg = "Can't freeze a class with a custom __setattr__." + raise ValueError(msg) + + eq = not is_exc and _determine_whether_to_implement( + cls, eq_, auto_detect, ("__eq__", "__ne__") + ) + + Hashability = ClassProps.Hashability + + if is_exc: + hashability = Hashability.LEAVE_ALONE + elif hash is True: + hashability = ( + Hashability.HASHABLE_CACHED + if cache_hash + else Hashability.HASHABLE + ) + elif hash is False: + hashability = Hashability.LEAVE_ALONE + elif hash is None: + if auto_detect is True and _has_own_attribute(cls, "__hash__"): + hashability = Hashability.LEAVE_ALONE + elif eq is True and is_frozen is True: + hashability = ( + Hashability.HASHABLE_CACHED + if cache_hash + else Hashability.HASHABLE + ) + elif eq is False: + hashability = Hashability.LEAVE_ALONE + else: + hashability = Hashability.UNHASHABLE + else: + msg = "Invalid value for hash. Must be True, False, or None." + raise TypeError(msg) + + KeywordOnly = ClassProps.KeywordOnly + if kw_only: + kwo = KeywordOnly.FORCE if force_kw_only else KeywordOnly.YES + else: + kwo = KeywordOnly.NO + + props = ClassProps( + is_exception=is_exc, + is_frozen=is_frozen, + is_slotted=slots, + collected_fields_by_mro=collect_by_mro, + added_init=_determine_whether_to_implement( + cls, init, auto_detect, ("__init__",) + ), + added_repr=_determine_whether_to_implement( + cls, repr, auto_detect, ("__repr__",) + ), + added_eq=eq, + added_ordering=not is_exc + and _determine_whether_to_implement( + cls, + order_, + auto_detect, + ("__lt__", "__le__", "__gt__", "__ge__"), + ), + hashability=hashability, + added_match_args=match_args, + kw_only=kwo, + has_weakref_slot=weakref_slot, + added_str=str, + added_pickling=_determine_whether_to_implement( + cls, + getstate_setstate, + auto_detect, + ("__getstate__", "__setstate__"), + default=slots, + ), + on_setattr_hook=on_setattr, + field_transformer=field_transformer, + ) + + if not props.is_hashable and cache_hash: + msg = "Invalid value for cache_hash. To use hash caching, hashing must be either explicitly or implicitly enabled." + raise TypeError(msg) + + builder = _ClassBuilder( + cls, + these, + auto_attribs=auto_attribs, + props=props, + has_custom_setattr=has_own_setattr, + ) + + if props.added_repr: + builder.add_repr(repr_ns) + + if props.added_str: + builder.add_str() + + if props.added_eq: + builder.add_eq() + if props.added_ordering: + builder.add_order() + + if not frozen: + builder.add_setattr() + + if props.is_hashable: + builder.add_hash() + elif props.hashability is Hashability.UNHASHABLE: + builder.make_unhashable() + + if props.added_init: + builder.add_init() + else: + builder.add_attrs_init() + if cache_hash: + msg = "Invalid value for cache_hash. To use hash caching, init must be True." + raise TypeError(msg) + + if PY_3_13_PLUS and not _has_own_attribute(cls, "__replace__"): + builder.add_replace() + + if ( + PY_3_10_PLUS + and match_args + and not _has_own_attribute(cls, "__match_args__") + ): + builder.add_match_args() + + return builder.build_class() + + # maybe_cls's type depends on the usage of the decorator. It's a class + # if it's used as `@attrs` but `None` if used as `@attrs()`. + if maybe_cls is None: + return wrap + + return wrap(maybe_cls) + + +_attrs = attrs +""" +Internal alias so we can use it in functions that take an argument called +*attrs*. +""" + + +def _has_frozen_base_class(cls): + """ + Check whether *cls* has a frozen ancestor by looking at its + __setattr__. + """ + return cls.__setattr__ is _frozen_setattrs + + +def _generate_unique_filename(cls: type, func_name: str) -> str: + """ + Create a "filename" suitable for a function being generated. + """ + return ( + f"" + ) + + +def _make_hash_script( + cls: type, attrs: list[Attribute], frozen: bool, cache_hash: bool +) -> tuple[str, dict]: + attrs = tuple( + a for a in attrs if a.hash is True or (a.hash is None and a.eq is True) + ) + + tab = " " + + type_hash = hash(_generate_unique_filename(cls, "hash")) + # If eq is custom generated, we need to include the functions in globs + globs = {} + + hash_def = "def __hash__(self" + hash_func = "hash((" + closing_braces = "))" + if not cache_hash: + hash_def += "):" + else: + hash_def += ", *" + + hash_def += ", _cache_wrapper=__import__('attr._make')._make._CacheHashWrapper):" + hash_func = "_cache_wrapper(" + hash_func + closing_braces += ")" + + method_lines = [hash_def] + + def append_hash_computation_lines(prefix, indent): + """ + Generate the code for actually computing the hash code. + Below this will either be returned directly or used to compute + a value which is then cached, depending on the value of cache_hash + """ + + method_lines.extend( + [ + indent + prefix + hash_func, + indent + f" {type_hash},", + ] + ) + + for a in attrs: + if a.eq_key: + cmp_name = f"_{a.name}_key" + globs[cmp_name] = a.eq_key + method_lines.append( + indent + f" {cmp_name}(self.{a.name})," + ) + else: + method_lines.append(indent + f" self.{a.name},") + + method_lines.append(indent + " " + closing_braces) + + if cache_hash: + method_lines.append(tab + f"if self.{_HASH_CACHE_FIELD} is None:") + if frozen: + append_hash_computation_lines( + f"object.__setattr__(self, '{_HASH_CACHE_FIELD}', ", tab * 2 + ) + method_lines.append(tab * 2 + ")") # close __setattr__ + else: + append_hash_computation_lines( + f"self.{_HASH_CACHE_FIELD} = ", tab * 2 + ) + method_lines.append(tab + f"return self.{_HASH_CACHE_FIELD}") + else: + append_hash_computation_lines("return ", tab) + + script = "\n".join(method_lines) + return script, globs + + +def _add_hash(cls: type, attrs: list[Attribute]): + """ + Add a hash method to *cls*. + """ + script, globs = _make_hash_script( + cls, attrs, frozen=False, cache_hash=False + ) + _compile_and_eval( + script, globs, filename=_generate_unique_filename(cls, "__hash__") + ) + cls.__hash__ = globs["__hash__"] + return cls + + +def __ne__(self, other): + """ + Check equality and either forward a NotImplemented or + return the result negated. + """ + result = self.__eq__(other) + if result is NotImplemented: + return NotImplemented + + return not result + + +def _make_eq_script(attrs: list) -> tuple[str, dict]: + """ + Create __eq__ method for *cls* with *attrs*. + """ + attrs = [a for a in attrs if a.eq] + + lines = [ + "def __eq__(self, other):", + " if other.__class__ is not self.__class__:", + " return NotImplemented", + ] + + globs = {} + if attrs: + lines.append(" return (") + for a in attrs: + if a.eq_key: + cmp_name = f"_{a.name}_key" + # Add the key function to the global namespace + # of the evaluated function. + globs[cmp_name] = a.eq_key + lines.append( + f" {cmp_name}(self.{a.name}) == {cmp_name}(other.{a.name})" + ) + else: + lines.append(f" self.{a.name} == other.{a.name}") + if a is not attrs[-1]: + lines[-1] = f"{lines[-1]} and" + lines.append(" )") + else: + lines.append(" return True") + + script = "\n".join(lines) + + return script, globs + + +def _make_order(cls, attrs): + """ + Create ordering methods for *cls* with *attrs*. + """ + attrs = [a for a in attrs if a.order] + + def attrs_to_tuple(obj): + """ + Save us some typing. + """ + return tuple( + key(value) if key else value + for value, key in ( + (getattr(obj, a.name), a.order_key) for a in attrs + ) + ) + + def __lt__(self, other): + """ + Automatically created by attrs. + """ + if other.__class__ is self.__class__: + return attrs_to_tuple(self) < attrs_to_tuple(other) + + return NotImplemented + + def __le__(self, other): + """ + Automatically created by attrs. + """ + if other.__class__ is self.__class__: + return attrs_to_tuple(self) <= attrs_to_tuple(other) + + return NotImplemented + + def __gt__(self, other): + """ + Automatically created by attrs. + """ + if other.__class__ is self.__class__: + return attrs_to_tuple(self) > attrs_to_tuple(other) + + return NotImplemented + + def __ge__(self, other): + """ + Automatically created by attrs. + """ + if other.__class__ is self.__class__: + return attrs_to_tuple(self) >= attrs_to_tuple(other) + + return NotImplemented + + return __lt__, __le__, __gt__, __ge__ + + +def _add_eq(cls, attrs=None): + """ + Add equality methods to *cls* with *attrs*. + """ + if attrs is None: + attrs = cls.__attrs_attrs__ + + script, globs = _make_eq_script(attrs) + _compile_and_eval( + script, globs, filename=_generate_unique_filename(cls, "__eq__") + ) + cls.__eq__ = globs["__eq__"] + cls.__ne__ = __ne__ + + return cls + + +def _make_repr_script(attrs, ns) -> tuple[str, dict]: + """ + Create the source and globs for a __repr__ and return it. + """ + # Figure out which attributes to include, and which function to use to + # format them. The a.repr value can be either bool or a custom + # callable. + attr_names_with_reprs = tuple( + (a.name, (repr if a.repr is True else a.repr), a.init) + for a in attrs + if a.repr is not False + ) + globs = { + name + "_repr": r for name, r, _ in attr_names_with_reprs if r != repr + } + globs["_compat"] = _compat + globs["AttributeError"] = AttributeError + globs["NOTHING"] = NOTHING + attribute_fragments = [] + for name, r, i in attr_names_with_reprs: + accessor = ( + "self." + name if i else 'getattr(self, "' + name + '", NOTHING)' + ) + fragment = ( + "%s={%s!r}" % (name, accessor) + if r == repr + else "%s={%s_repr(%s)}" % (name, name, accessor) + ) + attribute_fragments.append(fragment) + repr_fragment = ", ".join(attribute_fragments) + + if ns is None: + cls_name_fragment = '{self.__class__.__qualname__.rsplit(">.", 1)[-1]}' + else: + cls_name_fragment = ns + ".{self.__class__.__name__}" + + lines = [ + "def __repr__(self):", + " try:", + " already_repring = _compat.repr_context.already_repring", + " except AttributeError:", + " already_repring = {id(self),}", + " _compat.repr_context.already_repring = already_repring", + " else:", + " if id(self) in already_repring:", + " return '...'", + " else:", + " already_repring.add(id(self))", + " try:", + f" return f'{cls_name_fragment}({repr_fragment})'", + " finally:", + " already_repring.remove(id(self))", + ] + + return "\n".join(lines), globs + + +def _add_repr(cls, ns=None, attrs=None): + """ + Add a repr method to *cls*. + """ + if attrs is None: + attrs = cls.__attrs_attrs__ + + script, globs = _make_repr_script(attrs, ns) + _compile_and_eval( + script, globs, filename=_generate_unique_filename(cls, "__repr__") + ) + cls.__repr__ = globs["__repr__"] + return cls + + +def fields(cls): + """ + Return the tuple of *attrs* attributes for a class. + + The tuple also allows accessing the fields by their names (see below for + examples). + + Args: + cls (type): Class to introspect. + + Raises: + TypeError: If *cls* is not a class. + + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class. + + Returns: + tuple (with name accessors) of `attrs.Attribute` + + .. versionchanged:: 16.2.0 Returned tuple allows accessing the fields + by name. + .. versionchanged:: 23.1.0 Add support for generic classes. + """ + generic_base = get_generic_base(cls) + + if generic_base is None and not isinstance(cls, type): + msg = "Passed object must be a class." + raise TypeError(msg) + + attrs = getattr(cls, "__attrs_attrs__", None) + + if attrs is None: + if generic_base is not None: + attrs = getattr(generic_base, "__attrs_attrs__", None) + if attrs is not None: + # Even though this is global state, stick it on here to speed + # it up. We rely on `cls` being cached for this to be + # efficient. + cls.__attrs_attrs__ = attrs + return attrs + msg = f"{cls!r} is not an attrs-decorated class." + raise NotAnAttrsClassError(msg) + + return attrs + + +def fields_dict(cls): + """ + Return an ordered dictionary of *attrs* attributes for a class, whose keys + are the attribute names. + + Args: + cls (type): Class to introspect. + + Raises: + TypeError: If *cls* is not a class. + + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class. + + Returns: + dict[str, attrs.Attribute]: Dict of attribute name to definition + + .. versionadded:: 18.1.0 + """ + if not isinstance(cls, type): + msg = "Passed object must be a class." + raise TypeError(msg) + attrs = getattr(cls, "__attrs_attrs__", None) + if attrs is None: + msg = f"{cls!r} is not an attrs-decorated class." + raise NotAnAttrsClassError(msg) + return {a.name: a for a in attrs} + + +def validate(inst): + """ + Validate all attributes on *inst* that have a validator. + + Leaves all exceptions through. + + Args: + inst: Instance of a class with *attrs* attributes. + """ + if _config._run_validators is False: + return + + for a in fields(inst.__class__): + v = a.validator + if v is not None: + v(inst, a, getattr(inst, a.name)) + + +def _is_slot_attr(a_name, base_attr_map): + """ + Check if the attribute name comes from a slot class. + """ + cls = base_attr_map.get(a_name) + return cls and "__slots__" in cls.__dict__ + + +def _make_init_script( + cls, + attrs, + pre_init, + pre_init_has_args, + post_init, + frozen, + slots, + cache_hash, + base_attr_map, + is_exc, + cls_on_setattr, + attrs_init, +) -> tuple[str, dict, dict]: + has_cls_on_setattr = ( + cls_on_setattr is not None and cls_on_setattr is not setters.NO_OP + ) + + if frozen and has_cls_on_setattr: + msg = "Frozen classes can't use on_setattr." + raise ValueError(msg) + + needs_cached_setattr = cache_hash or frozen + filtered_attrs = [] + attr_dict = {} + for a in attrs: + if not a.init and a.default is NOTHING: + continue + + filtered_attrs.append(a) + attr_dict[a.name] = a + + if a.on_setattr is not None: + if frozen is True: + msg = "Frozen classes can't use on_setattr." + raise ValueError(msg) + + needs_cached_setattr = True + elif has_cls_on_setattr and a.on_setattr is not setters.NO_OP: + needs_cached_setattr = True + + script, globs, annotations = _attrs_to_init_script( + filtered_attrs, + frozen, + slots, + pre_init, + pre_init_has_args, + post_init, + cache_hash, + base_attr_map, + is_exc, + needs_cached_setattr, + has_cls_on_setattr, + "__attrs_init__" if attrs_init else "__init__", + ) + if cls.__module__ in sys.modules: + # This makes typing.get_type_hints(CLS.__init__) resolve string types. + globs.update(sys.modules[cls.__module__].__dict__) + + globs.update({"NOTHING": NOTHING, "attr_dict": attr_dict}) + + if needs_cached_setattr: + # Save the lookup overhead in __init__ if we need to circumvent + # setattr hooks. + globs["_cached_setattr_get"] = _OBJ_SETATTR.__get__ + + return script, globs, annotations + + +def _setattr(attr_name: str, value_var: str, has_on_setattr: bool) -> str: + """ + Use the cached object.setattr to set *attr_name* to *value_var*. + """ + return f"_setattr('{attr_name}', {value_var})" + + +def _setattr_with_converter( + attr_name: str, value_var: str, has_on_setattr: bool, converter: Converter +) -> str: + """ + Use the cached object.setattr to set *attr_name* to *value_var*, but run + its converter first. + """ + return f"_setattr('{attr_name}', {converter._fmt_converter_call(attr_name, value_var)})" + + +def _assign(attr_name: str, value: str, has_on_setattr: bool) -> str: + """ + Unless *attr_name* has an on_setattr hook, use normal assignment. Otherwise + relegate to _setattr. + """ + if has_on_setattr: + return _setattr(attr_name, value, True) + + return f"self.{attr_name} = {value}" + + +def _assign_with_converter( + attr_name: str, value_var: str, has_on_setattr: bool, converter: Converter +) -> str: + """ + Unless *attr_name* has an on_setattr hook, use normal assignment after + conversion. Otherwise relegate to _setattr_with_converter. + """ + if has_on_setattr: + return _setattr_with_converter(attr_name, value_var, True, converter) + + return f"self.{attr_name} = {converter._fmt_converter_call(attr_name, value_var)}" + + +def _determine_setters( + frozen: bool, slots: bool, base_attr_map: dict[str, type] +): + """ + Determine the correct setter functions based on whether a class is frozen + and/or slotted. + """ + if frozen is True: + if slots is True: + return (), _setattr, _setattr_with_converter + + # Dict frozen classes assign directly to __dict__. + # But only if the attribute doesn't come from an ancestor slot + # class. + # Note _inst_dict will be used again below if cache_hash is True + + def fmt_setter( + attr_name: str, value_var: str, has_on_setattr: bool + ) -> str: + if _is_slot_attr(attr_name, base_attr_map): + return _setattr(attr_name, value_var, has_on_setattr) + + return f"_inst_dict['{attr_name}'] = {value_var}" + + def fmt_setter_with_converter( + attr_name: str, + value_var: str, + has_on_setattr: bool, + converter: Converter, + ) -> str: + if has_on_setattr or _is_slot_attr(attr_name, base_attr_map): + return _setattr_with_converter( + attr_name, value_var, has_on_setattr, converter + ) + + return f"_inst_dict['{attr_name}'] = {converter._fmt_converter_call(attr_name, value_var)}" + + return ( + ("_inst_dict = self.__dict__",), + fmt_setter, + fmt_setter_with_converter, + ) + + # Not frozen -- we can just assign directly. + return (), _assign, _assign_with_converter + + +def _attrs_to_init_script( + attrs: list[Attribute], + is_frozen: bool, + is_slotted: bool, + call_pre_init: bool, + pre_init_has_args: bool, + call_post_init: bool, + does_cache_hash: bool, + base_attr_map: dict[str, type], + is_exc: bool, + needs_cached_setattr: bool, + has_cls_on_setattr: bool, + method_name: str, +) -> tuple[str, dict, dict]: + """ + Return a script of an initializer for *attrs*, a dict of globals, and + annotations for the initializer. + + The globals are required by the generated script. + """ + lines = ["self.__attrs_pre_init__()"] if call_pre_init else [] + + if needs_cached_setattr: + lines.append( + # Circumvent the __setattr__ descriptor to save one lookup per + # assignment. Note _setattr will be used again below if + # does_cache_hash is True. + "_setattr = _cached_setattr_get(self)" + ) + + extra_lines, fmt_setter, fmt_setter_with_converter = _determine_setters( + is_frozen, is_slotted, base_attr_map + ) + lines.extend(extra_lines) + + args = [] # Parameters in the definition of __init__ + pre_init_args = [] # Parameters in the call to __attrs_pre_init__ + kw_only_args = [] # Used for both 'args' and 'pre_init_args' above + attrs_to_validate = [] + + # This is a dictionary of names to validator and converter callables. + # Injecting this into __init__ globals lets us avoid lookups. + names_for_globals = {} + annotations = {"return": None} + + for a in attrs: + if a.validator: + attrs_to_validate.append(a) + + attr_name = a.name + has_on_setattr = a.on_setattr is not None or ( + a.on_setattr is not setters.NO_OP and has_cls_on_setattr + ) + # a.alias is set to maybe-mangled attr_name in _ClassBuilder if not + # explicitly provided + arg_name = a.alias + + has_factory = isinstance(a.default, Factory) + maybe_self = "self" if has_factory and a.default.takes_self else "" + + if a.converter is not None and not isinstance(a.converter, Converter): + converter = Converter(a.converter) + else: + converter = a.converter + + if a.init is False: + if has_factory: + init_factory_name = _INIT_FACTORY_PAT % (a.name,) + if converter is not None: + lines.append( + fmt_setter_with_converter( + attr_name, + init_factory_name + f"({maybe_self})", + has_on_setattr, + converter, + ) + ) + names_for_globals[converter._get_global_name(a.name)] = ( + converter.converter + ) + else: + lines.append( + fmt_setter( + attr_name, + init_factory_name + f"({maybe_self})", + has_on_setattr, + ) + ) + names_for_globals[init_factory_name] = a.default.factory + elif converter is not None: + lines.append( + fmt_setter_with_converter( + attr_name, + f"attr_dict['{attr_name}'].default", + has_on_setattr, + converter, + ) + ) + names_for_globals[converter._get_global_name(a.name)] = ( + converter.converter + ) + else: + lines.append( + fmt_setter( + attr_name, + f"attr_dict['{attr_name}'].default", + has_on_setattr, + ) + ) + elif a.default is not NOTHING and not has_factory: + arg = f"{arg_name}=attr_dict['{attr_name}'].default" + if a.kw_only: + kw_only_args.append(arg) + else: + args.append(arg) + pre_init_args.append(arg_name) + + if converter is not None: + lines.append( + fmt_setter_with_converter( + attr_name, arg_name, has_on_setattr, converter + ) + ) + names_for_globals[converter._get_global_name(a.name)] = ( + converter.converter + ) + else: + lines.append(fmt_setter(attr_name, arg_name, has_on_setattr)) + + elif has_factory: + arg = f"{arg_name}=NOTHING" + if a.kw_only: + kw_only_args.append(arg) + else: + args.append(arg) + pre_init_args.append(arg_name) + lines.append(f"if {arg_name} is not NOTHING:") + + init_factory_name = _INIT_FACTORY_PAT % (a.name,) + if converter is not None: + lines.append( + " " + + fmt_setter_with_converter( + attr_name, arg_name, has_on_setattr, converter + ) + ) + lines.append("else:") + lines.append( + " " + + fmt_setter_with_converter( + attr_name, + init_factory_name + "(" + maybe_self + ")", + has_on_setattr, + converter, + ) + ) + names_for_globals[converter._get_global_name(a.name)] = ( + converter.converter + ) + else: + lines.append( + " " + fmt_setter(attr_name, arg_name, has_on_setattr) + ) + lines.append("else:") + lines.append( + " " + + fmt_setter( + attr_name, + init_factory_name + "(" + maybe_self + ")", + has_on_setattr, + ) + ) + names_for_globals[init_factory_name] = a.default.factory + else: + if a.kw_only: + kw_only_args.append(arg_name) + else: + args.append(arg_name) + pre_init_args.append(arg_name) + + if converter is not None: + lines.append( + fmt_setter_with_converter( + attr_name, arg_name, has_on_setattr, converter + ) + ) + names_for_globals[converter._get_global_name(a.name)] = ( + converter.converter + ) + else: + lines.append(fmt_setter(attr_name, arg_name, has_on_setattr)) + + if a.init is True: + if a.type is not None and converter is None: + annotations[arg_name] = a.type + elif converter is not None and converter._first_param_type: + # Use the type from the converter if present. + annotations[arg_name] = converter._first_param_type + + if attrs_to_validate: # we can skip this if there are no validators. + names_for_globals["_config"] = _config + lines.append("if _config._run_validators is True:") + for a in attrs_to_validate: + val_name = "__attr_validator_" + a.name + attr_name = "__attr_" + a.name + lines.append(f" {val_name}(self, {attr_name}, self.{a.name})") + names_for_globals[val_name] = a.validator + names_for_globals[attr_name] = a + + if call_post_init: + lines.append("self.__attrs_post_init__()") + + # Because this is set only after __attrs_post_init__ is called, a crash + # will result if post-init tries to access the hash code. This seemed + # preferable to setting this beforehand, in which case alteration to field + # values during post-init combined with post-init accessing the hash code + # would result in silent bugs. + if does_cache_hash: + if is_frozen: + if is_slotted: + init_hash_cache = f"_setattr('{_HASH_CACHE_FIELD}', None)" + else: + init_hash_cache = f"_inst_dict['{_HASH_CACHE_FIELD}'] = None" + else: + init_hash_cache = f"self.{_HASH_CACHE_FIELD} = None" + lines.append(init_hash_cache) + + # For exceptions we rely on BaseException.__init__ for proper + # initialization. + if is_exc: + vals = ",".join(f"self.{a.name}" for a in attrs if a.init) + + lines.append(f"BaseException.__init__(self, {vals})") + + args = ", ".join(args) + pre_init_args = ", ".join(pre_init_args) + if kw_only_args: + # leading comma & kw_only args + args += f"{', ' if args else ''}*, {', '.join(kw_only_args)}" + pre_init_kw_only_args = ", ".join( + [ + f"{kw_arg_name}={kw_arg_name}" + # We need to remove the defaults from the kw_only_args. + for kw_arg_name in (kwa.split("=")[0] for kwa in kw_only_args) + ] + ) + pre_init_args += ", " if pre_init_args else "" + pre_init_args += pre_init_kw_only_args + + if call_pre_init and pre_init_has_args: + # If pre init method has arguments, pass the values given to __init__. + lines[0] = f"self.__attrs_pre_init__({pre_init_args})" + + # Python <3.12 doesn't allow backslashes in f-strings. + NL = "\n " + return ( + f"""def {method_name}(self, {args}): + {NL.join(lines) if lines else "pass"} +""", + names_for_globals, + annotations, + ) + + +def _default_init_alias_for(name: str) -> str: + """ + The default __init__ parameter name for a field. + + This performs private-name adjustment via leading-unscore stripping, + and is the default value of Attribute.alias if not provided. + """ + + return name.lstrip("_") + + +class Attribute: + """ + *Read-only* representation of an attribute. + + .. warning:: + + You should never instantiate this class yourself. + + The class has *all* arguments of `attr.ib` (except for ``factory`` which is + only syntactic sugar for ``default=Factory(...)`` plus the following: + + - ``name`` (`str`): The name of the attribute. + - ``alias`` (`str`): The __init__ parameter name of the attribute, after + any explicit overrides and default private-attribute-name handling. + - ``inherited`` (`bool`): Whether or not that attribute has been inherited + from a base class. + - ``eq_key`` and ``order_key`` (`typing.Callable` or `None`): The + callables that are used for comparing and ordering objects by this + attribute, respectively. These are set by passing a callable to + `attr.ib`'s ``eq``, ``order``, or ``cmp`` arguments. See also + :ref:`comparison customization `. + + Instances of this class are frequently used for introspection purposes + like: + + - `fields` returns a tuple of them. + - Validators get them passed as the first argument. + - The :ref:`field transformer ` hook receives a list of + them. + - The ``alias`` property exposes the __init__ parameter name of the field, + with any overrides and default private-attribute handling applied. + + + .. versionadded:: 20.1.0 *inherited* + .. versionadded:: 20.1.0 *on_setattr* + .. versionchanged:: 20.2.0 *inherited* is not taken into account for + equality checks and hashing anymore. + .. versionadded:: 21.1.0 *eq_key* and *order_key* + .. versionadded:: 22.2.0 *alias* + + For the full version history of the fields, see `attr.ib`. + """ + + # These slots must NOT be reordered because we use them later for + # instantiation. + __slots__ = ( # noqa: RUF023 + "name", + "default", + "validator", + "repr", + "eq", + "eq_key", + "order", + "order_key", + "hash", + "init", + "metadata", + "type", + "converter", + "kw_only", + "inherited", + "on_setattr", + "alias", + ) + + def __init__( + self, + name, + default, + validator, + repr, + cmp, # XXX: unused, remove along with other cmp code. + hash, + init, + inherited, + metadata=None, + type=None, + converter=None, + kw_only=False, + eq=None, + eq_key=None, + order=None, + order_key=None, + on_setattr=None, + alias=None, + ): + eq, eq_key, order, order_key = _determine_attrib_eq_order( + cmp, eq_key or eq, order_key or order, True + ) + + # Cache this descriptor here to speed things up later. + bound_setattr = _OBJ_SETATTR.__get__(self) + + # Despite the big red warning, people *do* instantiate `Attribute` + # themselves. + bound_setattr("name", name) + bound_setattr("default", default) + bound_setattr("validator", validator) + bound_setattr("repr", repr) + bound_setattr("eq", eq) + bound_setattr("eq_key", eq_key) + bound_setattr("order", order) + bound_setattr("order_key", order_key) + bound_setattr("hash", hash) + bound_setattr("init", init) + bound_setattr("converter", converter) + bound_setattr( + "metadata", + ( + types.MappingProxyType(dict(metadata)) # Shallow copy + if metadata + else _EMPTY_METADATA_SINGLETON + ), + ) + bound_setattr("type", type) + bound_setattr("kw_only", kw_only) + bound_setattr("inherited", inherited) + bound_setattr("on_setattr", on_setattr) + bound_setattr("alias", alias) + + def __setattr__(self, name, value): + raise FrozenInstanceError + + @classmethod + def from_counting_attr( + cls, name: str, ca: _CountingAttr, kw_only: bool, type=None + ): + # The 'kw_only' argument is the class-level setting, and is used if the + # attribute itself does not explicitly set 'kw_only'. + # type holds the annotated value. deal with conflicts: + if type is None: + type = ca.type + elif ca.type is not None: + msg = f"Type annotation and type argument cannot both be present for '{name}'." + raise ValueError(msg) + return cls( + name, + ca._default, + ca._validator, + ca.repr, + None, + ca.hash, + ca.init, + False, + ca.metadata, + type, + ca.converter, + kw_only if ca.kw_only is None else ca.kw_only, + ca.eq, + ca.eq_key, + ca.order, + ca.order_key, + ca.on_setattr, + ca.alias, + ) + + # Don't use attrs.evolve since fields(Attribute) doesn't work + def evolve(self, **changes): + """ + Copy *self* and apply *changes*. + + This works similarly to `attrs.evolve` but that function does not work + with :class:`attrs.Attribute`. + + It is mainly meant to be used for `transform-fields`. + + .. versionadded:: 20.3.0 + """ + new = copy.copy(self) + + new._setattrs(changes.items()) + + return new + + # Don't use _add_pickle since fields(Attribute) doesn't work + def __getstate__(self): + """ + Play nice with pickle. + """ + return tuple( + getattr(self, name) if name != "metadata" else dict(self.metadata) + for name in self.__slots__ + ) + + def __setstate__(self, state): + """ + Play nice with pickle. + """ + self._setattrs(zip(self.__slots__, state)) + + def _setattrs(self, name_values_pairs): + bound_setattr = _OBJ_SETATTR.__get__(self) + for name, value in name_values_pairs: + if name != "metadata": + bound_setattr(name, value) + else: + bound_setattr( + name, + ( + types.MappingProxyType(dict(value)) + if value + else _EMPTY_METADATA_SINGLETON + ), + ) + + +_a = [ + Attribute( + name=name, + default=NOTHING, + validator=None, + repr=True, + cmp=None, + eq=True, + order=False, + hash=(name != "metadata"), + init=True, + inherited=False, + alias=_default_init_alias_for(name), + ) + for name in Attribute.__slots__ +] + +Attribute = _add_hash( + _add_eq( + _add_repr(Attribute, attrs=_a), + attrs=[a for a in _a if a.name != "inherited"], + ), + attrs=[a for a in _a if a.hash and a.name != "inherited"], +) + + +class _CountingAttr: + """ + Intermediate representation of attributes that uses a counter to preserve + the order in which the attributes have been defined. + + *Internal* data structure of the attrs library. Running into is most + likely the result of a bug like a forgotten `@attr.s` decorator. + """ + + __slots__ = ( + "_default", + "_validator", + "alias", + "converter", + "counter", + "eq", + "eq_key", + "hash", + "init", + "kw_only", + "metadata", + "on_setattr", + "order", + "order_key", + "repr", + "type", + ) + __attrs_attrs__ = ( + *tuple( + Attribute( + name=name, + alias=_default_init_alias_for(name), + default=NOTHING, + validator=None, + repr=True, + cmp=None, + hash=True, + init=True, + kw_only=False, + eq=True, + eq_key=None, + order=False, + order_key=None, + inherited=False, + on_setattr=None, + ) + for name in ( + "counter", + "_default", + "repr", + "eq", + "order", + "hash", + "init", + "on_setattr", + "alias", + ) + ), + Attribute( + name="metadata", + alias="metadata", + default=None, + validator=None, + repr=True, + cmp=None, + hash=False, + init=True, + kw_only=False, + eq=True, + eq_key=None, + order=False, + order_key=None, + inherited=False, + on_setattr=None, + ), + ) + cls_counter = 0 + + def __init__( + self, + default, + validator, + repr, + cmp, + hash, + init, + converter, + metadata, + type, + kw_only, + eq, + eq_key, + order, + order_key, + on_setattr, + alias, + ): + _CountingAttr.cls_counter += 1 + self.counter = _CountingAttr.cls_counter + self._default = default + self._validator = validator + self.converter = converter + self.repr = repr + self.eq = eq + self.eq_key = eq_key + self.order = order + self.order_key = order_key + self.hash = hash + self.init = init + self.metadata = metadata + self.type = type + self.kw_only = kw_only + self.on_setattr = on_setattr + self.alias = alias + + def validator(self, meth): + """ + Decorator that adds *meth* to the list of validators. + + Returns *meth* unchanged. + + .. versionadded:: 17.1.0 + """ + if self._validator is None: + self._validator = meth + else: + self._validator = and_(self._validator, meth) + return meth + + def default(self, meth): + """ + Decorator that allows to set the default for an attribute. + + Returns *meth* unchanged. + + Raises: + DefaultAlreadySetError: If default has been set before. + + .. versionadded:: 17.1.0 + """ + if self._default is not NOTHING: + raise DefaultAlreadySetError + + self._default = Factory(meth, takes_self=True) + + return meth + + +_CountingAttr = _add_eq(_add_repr(_CountingAttr)) + + +class ClassProps: + """ + Effective class properties as derived from parameters to `attr.s()` or + `define()` decorators. + + This is the same data structure that *attrs* uses internally to decide how + to construct the final class. + + Warning: + + This feature is currently **experimental** and is not covered by our + strict backwards-compatibility guarantees. + + + Attributes: + is_exception (bool): + Whether the class is treated as an exception class. + + is_slotted (bool): + Whether the class is `slotted `. + + has_weakref_slot (bool): + Whether the class has a slot for weak references. + + is_frozen (bool): + Whether the class is frozen. + + kw_only (KeywordOnly): + Whether / how the class enforces keyword-only arguments on the + ``__init__`` method. + + collected_fields_by_mro (bool): + Whether the class fields were collected by method resolution order. + That is, correctly but unlike `dataclasses`. + + added_init (bool): + Whether the class has an *attrs*-generated ``__init__`` method. + + added_repr (bool): + Whether the class has an *attrs*-generated ``__repr__`` method. + + added_eq (bool): + Whether the class has *attrs*-generated equality methods. + + added_ordering (bool): + Whether the class has *attrs*-generated ordering methods. + + hashability (Hashability): How `hashable ` the class is. + + added_match_args (bool): + Whether the class supports positional `match ` over its + fields. + + added_str (bool): + Whether the class has an *attrs*-generated ``__str__`` method. + + added_pickling (bool): + Whether the class has *attrs*-generated ``__getstate__`` and + ``__setstate__`` methods for `pickle`. + + on_setattr_hook (Callable[[Any, Attribute[Any], Any], Any] | None): + The class's ``__setattr__`` hook. + + field_transformer (Callable[[Attribute[Any]], Attribute[Any]] | None): + The class's `field transformers `. + + .. versionadded:: 25.4.0 + """ + + class Hashability(enum.Enum): + """ + The hashability of a class. + + .. versionadded:: 25.4.0 + """ + + HASHABLE = "hashable" + """Write a ``__hash__``.""" + HASHABLE_CACHED = "hashable_cache" + """Write a ``__hash__`` and cache the hash.""" + UNHASHABLE = "unhashable" + """Set ``__hash__`` to ``None``.""" + LEAVE_ALONE = "leave_alone" + """Don't touch ``__hash__``.""" + + class KeywordOnly(enum.Enum): + """ + How attributes should be treated regarding keyword-only parameters. + + .. versionadded:: 25.4.0 + """ + + NO = "no" + """Attributes are not keyword-only.""" + YES = "yes" + """Attributes in current class without kw_only=False are keyword-only.""" + FORCE = "force" + """All attributes are keyword-only.""" + + __slots__ = ( # noqa: RUF023 -- order matters for __init__ + "is_exception", + "is_slotted", + "has_weakref_slot", + "is_frozen", + "kw_only", + "collected_fields_by_mro", + "added_init", + "added_repr", + "added_eq", + "added_ordering", + "hashability", + "added_match_args", + "added_str", + "added_pickling", + "on_setattr_hook", + "field_transformer", + ) + + def __init__( + self, + is_exception, + is_slotted, + has_weakref_slot, + is_frozen, + kw_only, + collected_fields_by_mro, + added_init, + added_repr, + added_eq, + added_ordering, + hashability, + added_match_args, + added_str, + added_pickling, + on_setattr_hook, + field_transformer, + ): + self.is_exception = is_exception + self.is_slotted = is_slotted + self.has_weakref_slot = has_weakref_slot + self.is_frozen = is_frozen + self.kw_only = kw_only + self.collected_fields_by_mro = collected_fields_by_mro + self.added_init = added_init + self.added_repr = added_repr + self.added_eq = added_eq + self.added_ordering = added_ordering + self.hashability = hashability + self.added_match_args = added_match_args + self.added_str = added_str + self.added_pickling = added_pickling + self.on_setattr_hook = on_setattr_hook + self.field_transformer = field_transformer + + @property + def is_hashable(self): + return ( + self.hashability is ClassProps.Hashability.HASHABLE + or self.hashability is ClassProps.Hashability.HASHABLE_CACHED + ) + + +_cas = [ + Attribute( + name=name, + default=NOTHING, + validator=None, + repr=True, + cmp=None, + eq=True, + order=False, + hash=True, + init=True, + inherited=False, + alias=_default_init_alias_for(name), + ) + for name in ClassProps.__slots__ +] + +ClassProps = _add_eq(_add_repr(ClassProps, attrs=_cas), attrs=_cas) + + +class Factory: + """ + Stores a factory callable. + + If passed as the default value to `attrs.field`, the factory is used to + generate a new value. + + Args: + factory (typing.Callable): + A callable that takes either none or exactly one mandatory + positional argument depending on *takes_self*. + + takes_self (bool): + Pass the partially initialized instance that is being initialized + as a positional argument. + + .. versionadded:: 17.1.0 *takes_self* + """ + + __slots__ = ("factory", "takes_self") + + def __init__(self, factory, takes_self=False): + self.factory = factory + self.takes_self = takes_self + + def __getstate__(self): + """ + Play nice with pickle. + """ + return tuple(getattr(self, name) for name in self.__slots__) + + def __setstate__(self, state): + """ + Play nice with pickle. + """ + for name, value in zip(self.__slots__, state): + setattr(self, name, value) + + +_f = [ + Attribute( + name=name, + default=NOTHING, + validator=None, + repr=True, + cmp=None, + eq=True, + order=False, + hash=True, + init=True, + inherited=False, + ) + for name in Factory.__slots__ +] + +Factory = _add_hash(_add_eq(_add_repr(Factory, attrs=_f), attrs=_f), attrs=_f) + + +class Converter: + """ + Stores a converter callable. + + Allows for the wrapped converter to take additional arguments. The + arguments are passed in the order they are documented. + + Args: + converter (Callable): A callable that converts the passed value. + + takes_self (bool): + Pass the partially initialized instance that is being initialized + as a positional argument. (default: `False`) + + takes_field (bool): + Pass the field definition (an :class:`Attribute`) into the + converter as a positional argument. (default: `False`) + + .. versionadded:: 24.1.0 + """ + + __slots__ = ( + "__call__", + "_first_param_type", + "_global_name", + "converter", + "takes_field", + "takes_self", + ) + + def __init__(self, converter, *, takes_self=False, takes_field=False): + self.converter = converter + self.takes_self = takes_self + self.takes_field = takes_field + + ex = _AnnotationExtractor(converter) + self._first_param_type = ex.get_first_param_type() + + if not (self.takes_self or self.takes_field): + self.__call__ = lambda value, _, __: self.converter(value) + elif self.takes_self and not self.takes_field: + self.__call__ = lambda value, instance, __: self.converter( + value, instance + ) + elif not self.takes_self and self.takes_field: + self.__call__ = lambda value, __, field: self.converter( + value, field + ) + else: + self.__call__ = lambda value, instance, field: self.converter( + value, instance, field + ) + + rt = ex.get_return_type() + if rt is not None: + self.__call__.__annotations__["return"] = rt + + @staticmethod + def _get_global_name(attr_name: str) -> str: + """ + Return the name that a converter for an attribute name *attr_name* + would have. + """ + return f"__attr_converter_{attr_name}" + + def _fmt_converter_call(self, attr_name: str, value_var: str) -> str: + """ + Return a string that calls the converter for an attribute name + *attr_name* and the value in variable named *value_var* according to + `self.takes_self` and `self.takes_field`. + """ + if not (self.takes_self or self.takes_field): + return f"{self._get_global_name(attr_name)}({value_var})" + + if self.takes_self and self.takes_field: + return f"{self._get_global_name(attr_name)}({value_var}, self, attr_dict['{attr_name}'])" + + if self.takes_self: + return f"{self._get_global_name(attr_name)}({value_var}, self)" + + return f"{self._get_global_name(attr_name)}({value_var}, attr_dict['{attr_name}'])" + + def __getstate__(self): + """ + Return a dict containing only converter and takes_self -- the rest gets + computed when loading. + """ + return { + "converter": self.converter, + "takes_self": self.takes_self, + "takes_field": self.takes_field, + } + + def __setstate__(self, state): + """ + Load instance from state. + """ + self.__init__(**state) + + +_f = [ + Attribute( + name=name, + default=NOTHING, + validator=None, + repr=True, + cmp=None, + eq=True, + order=False, + hash=True, + init=True, + inherited=False, + ) + for name in ("converter", "takes_self", "takes_field") +] + +Converter = _add_hash( + _add_eq(_add_repr(Converter, attrs=_f), attrs=_f), attrs=_f +) + + +def make_class( + name, attrs, bases=(object,), class_body=None, **attributes_arguments +): + r""" + A quick way to create a new class called *name* with *attrs*. + + .. note:: + + ``make_class()`` is a thin wrapper around `attr.s`, not `attrs.define` + which means that it doesn't come with some of the improved defaults. + + For example, if you want the same ``on_setattr`` behavior as in + `attrs.define`, you have to pass the hooks yourself: ``make_class(..., + on_setattr=setters.pipe(setters.convert, setters.validate)`` + + .. warning:: + + It is *your* duty to ensure that the class name and the attribute names + are valid identifiers. ``make_class()`` will *not* validate them for + you. + + Args: + name (str): The name for the new class. + + attrs (list | dict): + A list of names or a dictionary of mappings of names to `attr.ib`\ + s / `attrs.field`\ s. + + The order is deduced from the order of the names or attributes + inside *attrs*. Otherwise the order of the definition of the + attributes is used. + + bases (tuple[type, ...]): Classes that the new class will subclass. + + class_body (dict): + An optional dictionary of class attributes for the new class. + + attributes_arguments: Passed unmodified to `attr.s`. + + Returns: + type: A new class with *attrs*. + + .. versionadded:: 17.1.0 *bases* + .. versionchanged:: 18.1.0 If *attrs* is ordered, the order is retained. + .. versionchanged:: 23.2.0 *class_body* + .. versionchanged:: 25.2.0 Class names can now be unicode. + """ + # Class identifiers are converted into the normal form NFKC while parsing + name = unicodedata.normalize("NFKC", name) + + if isinstance(attrs, dict): + cls_dict = attrs + elif isinstance(attrs, (list, tuple)): + cls_dict = {a: attrib() for a in attrs} + else: + msg = "attrs argument must be a dict or a list." + raise TypeError(msg) + + pre_init = cls_dict.pop("__attrs_pre_init__", None) + post_init = cls_dict.pop("__attrs_post_init__", None) + user_init = cls_dict.pop("__init__", None) + + body = {} + if class_body is not None: + body.update(class_body) + if pre_init is not None: + body["__attrs_pre_init__"] = pre_init + if post_init is not None: + body["__attrs_post_init__"] = post_init + if user_init is not None: + body["__init__"] = user_init + + type_ = types.new_class(name, bases, {}, lambda ns: ns.update(body)) + + # For pickling to work, the __module__ variable needs to be set to the + # frame where the class is created. Bypass this step in environments where + # sys._getframe is not defined (Jython for example) or sys._getframe is not + # defined for arguments greater than 0 (IronPython). + with contextlib.suppress(AttributeError, ValueError): + type_.__module__ = sys._getframe(1).f_globals.get( + "__name__", "__main__" + ) + + # We do it here for proper warnings with meaningful stacklevel. + cmp = attributes_arguments.pop("cmp", None) + ( + attributes_arguments["eq"], + attributes_arguments["order"], + ) = _determine_attrs_eq_order( + cmp, + attributes_arguments.get("eq"), + attributes_arguments.get("order"), + True, + ) + + cls = _attrs(these=cls_dict, **attributes_arguments)(type_) + # Only add type annotations now or "_attrs()" will complain: + cls.__annotations__ = { + k: v.type for k, v in cls_dict.items() if v.type is not None + } + return cls + + +# These are required by within this module so we define them here and merely +# import into .validators / .converters. + + +@attrs(slots=True, unsafe_hash=True) +class _AndValidator: + """ + Compose many validators to a single one. + """ + + _validators = attrib() + + def __call__(self, inst, attr, value): + for v in self._validators: + v(inst, attr, value) + + +def and_(*validators): + """ + A validator that composes multiple validators into one. + + When called on a value, it runs all wrapped validators. + + Args: + validators (~collections.abc.Iterable[typing.Callable]): + Arbitrary number of validators. + + .. versionadded:: 17.1.0 + """ + vals = [] + for validator in validators: + vals.extend( + validator._validators + if isinstance(validator, _AndValidator) + else [validator] + ) + + return _AndValidator(tuple(vals)) + + +def pipe(*converters): + """ + A converter that composes multiple converters into one. + + When called on a value, it runs all wrapped converters, returning the + *last* value. + + Type annotations will be inferred from the wrapped converters', if they + have any. + + converters (~collections.abc.Iterable[typing.Callable]): + Arbitrary number of converters. + + .. versionadded:: 20.1.0 + """ + + return_instance = any(isinstance(c, Converter) for c in converters) + + if return_instance: + + def pipe_converter(val, inst, field): + for c in converters: + val = ( + c(val, inst, field) if isinstance(c, Converter) else c(val) + ) + + return val + + else: + + def pipe_converter(val): + for c in converters: + val = c(val) + + return val + + if not converters: + # If the converter list is empty, pipe_converter is the identity. + A = TypeVar("A") + pipe_converter.__annotations__.update({"val": A, "return": A}) + else: + # Get parameter type from first converter. + t = _AnnotationExtractor(converters[0]).get_first_param_type() + if t: + pipe_converter.__annotations__["val"] = t + + last = converters[-1] + if not PY_3_11_PLUS and isinstance(last, Converter): + last = last.__call__ + + # Get return type from last converter. + rt = _AnnotationExtractor(last).get_return_type() + if rt: + pipe_converter.__annotations__["return"] = rt + + if return_instance: + return Converter(pipe_converter, takes_self=True, takes_field=True) + return pipe_converter diff --git a/env/lib/python3.12/site-packages/attr/_next_gen.py b/env/lib/python3.12/site-packages/attr/_next_gen.py new file mode 100644 index 0000000..4ccd0da --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/_next_gen.py @@ -0,0 +1,674 @@ +# SPDX-License-Identifier: MIT + +""" +These are keyword-only APIs that call `attr.s` and `attr.ib` with different +default values. +""" + +from functools import partial + +from . import setters +from ._funcs import asdict as _asdict +from ._funcs import astuple as _astuple +from ._make import ( + _DEFAULT_ON_SETATTR, + NOTHING, + _frozen_setattrs, + attrib, + attrs, +) +from .exceptions import NotAnAttrsClassError, UnannotatedAttributeError + + +def define( + maybe_cls=None, + *, + these=None, + repr=None, + unsafe_hash=None, + hash=None, + init=None, + slots=True, + frozen=False, + weakref_slot=True, + str=False, + auto_attribs=None, + kw_only=False, + cache_hash=False, + auto_exc=True, + eq=None, + order=False, + auto_detect=True, + getstate_setstate=None, + on_setattr=None, + field_transformer=None, + match_args=True, + force_kw_only=False, +): + r""" + A class decorator that adds :term:`dunder methods` according to + :term:`fields ` specified using :doc:`type annotations `, + `field()` calls, or the *these* argument. + + Since *attrs* patches or replaces an existing class, you cannot use + `object.__init_subclass__` with *attrs* classes, because it runs too early. + As a replacement, you can define ``__attrs_init_subclass__`` on your class. + It will be called by *attrs* classes that subclass it after they're + created. See also :ref:`init-subclass`. + + Args: + slots (bool): + Create a :term:`slotted class ` that's more + memory-efficient. Slotted classes are generally superior to the + default dict classes, but have some gotchas you should know about, + so we encourage you to read the :term:`glossary entry `. + + auto_detect (bool): + Instead of setting the *init*, *repr*, *eq*, and *hash* arguments + explicitly, assume they are set to True **unless any** of the + involved methods for one of the arguments is implemented in the + *current* class (meaning, it is *not* inherited from some base + class). + + So, for example by implementing ``__eq__`` on a class yourself, + *attrs* will deduce ``eq=False`` and will create *neither* + ``__eq__`` *nor* ``__ne__`` (but Python classes come with a + sensible ``__ne__`` by default, so it *should* be enough to only + implement ``__eq__`` in most cases). + + Passing :data:`True` or :data:`False` to *init*, *repr*, *eq*, or *hash* + overrides whatever *auto_detect* would determine. + + auto_exc (bool): + If the class subclasses `BaseException` (which implicitly includes + any subclass of any exception), the following happens to behave + like a well-behaved Python exception class: + + - the values for *eq*, *order*, and *hash* are ignored and the + instances compare and hash by the instance's ids [#]_ , + - all attributes that are either passed into ``__init__`` or have a + default value are additionally available as a tuple in the + ``args`` attribute, + - the value of *str* is ignored leaving ``__str__`` to base + classes. + + .. [#] + Note that *attrs* will *not* remove existing implementations of + ``__hash__`` or the equality methods. It just won't add own + ones. + + on_setattr (~typing.Callable | list[~typing.Callable] | None | ~typing.Literal[attrs.setters.NO_OP]): + A callable that is run whenever the user attempts to set an + attribute (either by assignment like ``i.x = 42`` or by using + `setattr` like ``setattr(i, "x", 42)``). It receives the same + arguments as validators: the instance, the attribute that is being + modified, and the new value. + + If no exception is raised, the attribute is set to the return value + of the callable. + + If a list of callables is passed, they're automatically wrapped in + an `attrs.setters.pipe`. + + If left None, the default behavior is to run converters and + validators whenever an attribute is set. + + init (bool): + Create a ``__init__`` method that initializes the *attrs* + attributes. Leading underscores are stripped for the argument name, + unless an alias is set on the attribute. + + .. seealso:: + `init` shows advanced ways to customize the generated + ``__init__`` method, including executing code before and after. + + repr(bool): + Create a ``__repr__`` method with a human readable representation + of *attrs* attributes. + + str (bool): + Create a ``__str__`` method that is identical to ``__repr__``. This + is usually not necessary except for `Exception`\ s. + + eq (bool | None): + If True or None (default), add ``__eq__`` and ``__ne__`` methods + that check two instances for equality. + + .. seealso:: + `comparison` describes how to customize the comparison behavior + going as far comparing NumPy arrays. + + order (bool | None): + If True, add ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` + methods that behave like *eq* above and allow instances to be + ordered. + + They compare the instances as if they were tuples of their *attrs* + attributes if and only if the types of both classes are + *identical*. + + If `None` mirror value of *eq*. + + .. seealso:: `comparison` + + unsafe_hash (bool | None): + If None (default), the ``__hash__`` method is generated according + how *eq* and *frozen* are set. + + 1. If *both* are True, *attrs* will generate a ``__hash__`` for + you. + 2. If *eq* is True and *frozen* is False, ``__hash__`` will be set + to None, marking it unhashable (which it is). + 3. If *eq* is False, ``__hash__`` will be left untouched meaning + the ``__hash__`` method of the base class will be used. If the + base class is `object`, this means it will fall back to id-based + hashing. + + Although not recommended, you can decide for yourself and force + *attrs* to create one (for example, if the class is immutable even + though you didn't freeze it programmatically) by passing True or + not. Both of these cases are rather special and should be used + carefully. + + .. seealso:: + + - Our documentation on `hashing`, + - Python's documentation on `object.__hash__`, + - and the `GitHub issue that led to the default \ behavior + `_ for more + details. + + hash (bool | None): + Deprecated alias for *unsafe_hash*. *unsafe_hash* takes precedence. + + cache_hash (bool): + Ensure that the object's hash code is computed only once and stored + on the object. If this is set to True, hashing must be either + explicitly or implicitly enabled for this class. If the hash code + is cached, avoid any reassignments of fields involved in hash code + computation or mutations of the objects those fields point to after + object creation. If such changes occur, the behavior of the + object's hash code is undefined. + + frozen (bool): + Make instances immutable after initialization. If someone attempts + to modify a frozen instance, `attrs.exceptions.FrozenInstanceError` + is raised. + + .. note:: + + 1. This is achieved by installing a custom ``__setattr__`` + method on your class, so you can't implement your own. + + 2. True immutability is impossible in Python. + + 3. This *does* have a minor a runtime performance `impact + ` when initializing new instances. In other + words: ``__init__`` is slightly slower with ``frozen=True``. + + 4. If a class is frozen, you cannot modify ``self`` in + ``__attrs_post_init__`` or a self-written ``__init__``. You + can circumvent that limitation by using + ``object.__setattr__(self, "attribute_name", value)``. + + 5. Subclasses of a frozen class are frozen too. + + kw_only (bool): + Make attributes keyword-only in the generated ``__init__`` (if + *init* is False, this parameter is ignored). Attributes that + explicitly set ``kw_only=False`` are not affected; base class + attributes are also not affected. + + Also see *force_kw_only*. + + weakref_slot (bool): + Make instances weak-referenceable. This has no effect unless + *slots* is True. + + field_transformer (~typing.Callable | None): + A function that is called with the original class object and all + fields right before *attrs* finalizes the class. You can use this, + for example, to automatically add converters or validators to + fields based on their types. + + .. seealso:: `transform-fields` + + match_args (bool): + If True (default), set ``__match_args__`` on the class to support + :pep:`634` (*Structural Pattern Matching*). It is a tuple of all + non-keyword-only ``__init__`` parameter names on Python 3.10 and + later. Ignored on older Python versions. + + collect_by_mro (bool): + If True, *attrs* collects attributes from base classes correctly + according to the `method resolution order + `_. If False, *attrs* + will mimic the (wrong) behavior of `dataclasses` and :pep:`681`. + + See also `issue #428 + `_. + + force_kw_only (bool): + A back-compat flag for restoring pre-25.4.0 behavior. If True and + ``kw_only=True``, all attributes are made keyword-only, including + base class attributes, and those set to ``kw_only=False`` at the + attribute level. Defaults to False. + + See also `issue #980 + `_. + + getstate_setstate (bool | None): + .. note:: + + This is usually only interesting for slotted classes and you + should probably just set *auto_detect* to True. + + If True, ``__getstate__`` and ``__setstate__`` are generated and + attached to the class. This is necessary for slotted classes to be + pickleable. If left None, it's True by default for slotted classes + and False for dict classes. + + If *auto_detect* is True, and *getstate_setstate* is left None, and + **either** ``__getstate__`` or ``__setstate__`` is detected + directly on the class (meaning: not inherited), it is set to False + (this is usually what you want). + + auto_attribs (bool | None): + If True, look at type annotations to determine which attributes to + use, like `dataclasses`. If False, it will only look for explicit + :func:`field` class attributes, like classic *attrs*. + + If left None, it will guess: + + 1. If any attributes are annotated and no unannotated + `attrs.field`\ s are found, it assumes *auto_attribs=True*. + 2. Otherwise it assumes *auto_attribs=False* and tries to collect + `attrs.field`\ s. + + If *attrs* decides to look at type annotations, **all** fields + **must** be annotated. If *attrs* encounters a field that is set to + a :func:`field` / `attr.ib` but lacks a type annotation, an + `attrs.exceptions.UnannotatedAttributeError` is raised. Use + ``field_name: typing.Any = field(...)`` if you don't want to set a + type. + + .. warning:: + + For features that use the attribute name to create decorators + (for example, :ref:`validators `), you still *must* + assign :func:`field` / `attr.ib` to them. Otherwise Python will + either not find the name or try to use the default value to + call, for example, ``validator`` on it. + + Attributes annotated as `typing.ClassVar`, and attributes that are + neither annotated nor set to an `field()` are **ignored**. + + these (dict[str, object]): + A dictionary of name to the (private) return value of `field()` + mappings. This is useful to avoid the definition of your attributes + within the class body because you can't (for example, if you want + to add ``__repr__`` methods to Django models) or don't want to. + + If *these* is not `None`, *attrs* will *not* search the class body + for attributes and will *not* remove any attributes from it. + + The order is deduced from the order of the attributes inside + *these*. + + Arguably, this is a rather obscure feature. + + .. versionadded:: 20.1.0 + .. versionchanged:: 21.3.0 Converters are also run ``on_setattr``. + .. versionadded:: 22.2.0 + *unsafe_hash* as an alias for *hash* (for :pep:`681` compliance). + .. versionchanged:: 24.1.0 + Instances are not compared as tuples of attributes anymore, but using a + big ``and`` condition. This is faster and has more correct behavior for + uncomparable values like `math.nan`. + .. versionadded:: 24.1.0 + If a class has an *inherited* classmethod called + ``__attrs_init_subclass__``, it is executed after the class is created. + .. deprecated:: 24.1.0 *hash* is deprecated in favor of *unsafe_hash*. + .. versionadded:: 24.3.0 + Unless already present, a ``__replace__`` method is automatically + created for `copy.replace` (Python 3.13+ only). + .. versionchanged:: 25.4.0 + *kw_only* now only applies to attributes defined in the current class, + and respects attribute-level ``kw_only=False`` settings. + .. versionadded:: 25.4.0 + Added *force_kw_only* to go back to the previous *kw_only* behavior. + + .. note:: + + The main differences to the classic `attr.s` are: + + - Automatically detect whether or not *auto_attribs* should be `True` + (c.f. *auto_attribs* parameter). + - Converters and validators run when attributes are set by default -- + if *frozen* is `False`. + - *slots=True* + + Usually, this has only upsides and few visible effects in everyday + programming. But it *can* lead to some surprising behaviors, so + please make sure to read :term:`slotted classes`. + + - *auto_exc=True* + - *auto_detect=True* + - *order=False* + - *force_kw_only=False* + - Some options that were only relevant on Python 2 or were kept around + for backwards-compatibility have been removed. + + """ + + def do_it(cls, auto_attribs): + return attrs( + maybe_cls=cls, + these=these, + repr=repr, + hash=hash, + unsafe_hash=unsafe_hash, + init=init, + slots=slots, + frozen=frozen, + weakref_slot=weakref_slot, + str=str, + auto_attribs=auto_attribs, + kw_only=kw_only, + cache_hash=cache_hash, + auto_exc=auto_exc, + eq=eq, + order=order, + auto_detect=auto_detect, + collect_by_mro=True, + getstate_setstate=getstate_setstate, + on_setattr=on_setattr, + field_transformer=field_transformer, + match_args=match_args, + force_kw_only=force_kw_only, + ) + + def wrap(cls): + """ + Making this a wrapper ensures this code runs during class creation. + + We also ensure that frozen-ness of classes is inherited. + """ + nonlocal frozen, on_setattr + + had_on_setattr = on_setattr not in (None, setters.NO_OP) + + # By default, mutable classes convert & validate on setattr. + if frozen is False and on_setattr is None: + on_setattr = _DEFAULT_ON_SETATTR + + # However, if we subclass a frozen class, we inherit the immutability + # and disable on_setattr. + for base_cls in cls.__bases__: + if base_cls.__setattr__ is _frozen_setattrs: + if had_on_setattr: + msg = "Frozen classes can't use on_setattr (frozen-ness was inherited)." + raise ValueError(msg) + + on_setattr = setters.NO_OP + break + + if auto_attribs is not None: + return do_it(cls, auto_attribs) + + try: + return do_it(cls, True) + except UnannotatedAttributeError: + return do_it(cls, False) + + # maybe_cls's type depends on the usage of the decorator. It's a class + # if it's used as `@attrs` but `None` if used as `@attrs()`. + if maybe_cls is None: + return wrap + + return wrap(maybe_cls) + + +mutable = define +frozen = partial(define, frozen=True, on_setattr=None) + + +def field( + *, + default=NOTHING, + validator=None, + repr=True, + hash=None, + init=True, + metadata=None, + type=None, + converter=None, + factory=None, + kw_only=None, + eq=None, + order=None, + on_setattr=None, + alias=None, +): + """ + Create a new :term:`field` / :term:`attribute` on a class. + + .. warning:: + + Does **nothing** unless the class is also decorated with + `attrs.define` (or similar)! + + Args: + default: + A value that is used if an *attrs*-generated ``__init__`` is used + and no value is passed while instantiating or the attribute is + excluded using ``init=False``. + + If the value is an instance of `attrs.Factory`, its callable will + be used to construct a new value (useful for mutable data types + like lists or dicts). + + If a default is not set (or set manually to `attrs.NOTHING`), a + value *must* be supplied when instantiating; otherwise a + `TypeError` will be raised. + + .. seealso:: `defaults` + + factory (~typing.Callable): + Syntactic sugar for ``default=attr.Factory(factory)``. + + validator (~typing.Callable | list[~typing.Callable]): + Callable that is called by *attrs*-generated ``__init__`` methods + after the instance has been initialized. They receive the + initialized instance, the :func:`~attrs.Attribute`, and the passed + value. + + The return value is *not* inspected so the validator has to throw + an exception itself. + + If a `list` is passed, its items are treated as validators and must + all pass. + + Validators can be globally disabled and re-enabled using + `attrs.validators.get_disabled` / `attrs.validators.set_disabled`. + + The validator can also be set using decorator notation as shown + below. + + .. seealso:: :ref:`validators` + + repr (bool | ~typing.Callable): + Include this attribute in the generated ``__repr__`` method. If + True, include the attribute; if False, omit it. By default, the + built-in ``repr()`` function is used. To override how the attribute + value is formatted, pass a ``callable`` that takes a single value + and returns a string. Note that the resulting string is used as-is, + which means it will be used directly *instead* of calling + ``repr()`` (the default). + + eq (bool | ~typing.Callable): + If True (default), include this attribute in the generated + ``__eq__`` and ``__ne__`` methods that check two instances for + equality. To override how the attribute value is compared, pass a + callable that takes a single value and returns the value to be + compared. + + .. seealso:: `comparison` + + order (bool | ~typing.Callable): + If True (default), include this attributes in the generated + ``__lt__``, ``__le__``, ``__gt__`` and ``__ge__`` methods. To + override how the attribute value is ordered, pass a callable that + takes a single value and returns the value to be ordered. + + .. seealso:: `comparison` + + hash (bool | None): + Include this attribute in the generated ``__hash__`` method. If + None (default), mirror *eq*'s value. This is the correct behavior + according the Python spec. Setting this value to anything else + than None is *discouraged*. + + .. seealso:: `hashing` + + init (bool): + Include this attribute in the generated ``__init__`` method. + + It is possible to set this to False and set a default value. In + that case this attributed is unconditionally initialized with the + specified default value or factory. + + .. seealso:: `init` + + converter (typing.Callable | Converter): + A callable that is called by *attrs*-generated ``__init__`` methods + to convert attribute's value to the desired format. + + If a vanilla callable is passed, it is given the passed-in value as + the only positional argument. It is possible to receive additional + arguments by wrapping the callable in a `Converter`. + + Either way, the returned value will be used as the new value of the + attribute. The value is converted before being passed to the + validator, if any. + + .. seealso:: :ref:`converters` + + metadata (dict | None): + An arbitrary mapping, to be used by third-party code. + + .. seealso:: `extending-metadata`. + + type (type): + The type of the attribute. Nowadays, the preferred method to + specify the type is using a variable annotation (see :pep:`526`). + This argument is provided for backwards-compatibility and for usage + with `make_class`. Regardless of the approach used, the type will + be stored on ``Attribute.type``. + + Please note that *attrs* doesn't do anything with this metadata by + itself. You can use it as part of your own code or for `static type + checking `. + + kw_only (bool | None): + Make this attribute keyword-only in the generated ``__init__`` (if + *init* is False, this parameter is ignored). If None (default), + mirror the setting from `attrs.define`. + + on_setattr (~typing.Callable | list[~typing.Callable] | None | ~typing.Literal[attrs.setters.NO_OP]): + Allows to overwrite the *on_setattr* setting from `attr.s`. If left + None, the *on_setattr* value from `attr.s` is used. Set to + `attrs.setters.NO_OP` to run **no** `setattr` hooks for this + attribute -- regardless of the setting in `define()`. + + alias (str | None): + Override this attribute's parameter name in the generated + ``__init__`` method. If left None, default to ``name`` stripped + of leading underscores. See `private-attributes`. + + .. versionadded:: 20.1.0 + .. versionchanged:: 21.1.0 + *eq*, *order*, and *cmp* also accept a custom callable + .. versionadded:: 22.2.0 *alias* + .. versionadded:: 23.1.0 + The *type* parameter has been re-added; mostly for `attrs.make_class`. + Please note that type checkers ignore this metadata. + .. versionchanged:: 25.4.0 + *kw_only* can now be None, and its default is also changed from False to + None. + + .. seealso:: + + `attr.ib` + """ + return attrib( + default=default, + validator=validator, + repr=repr, + hash=hash, + init=init, + metadata=metadata, + type=type, + converter=converter, + factory=factory, + kw_only=kw_only, + eq=eq, + order=order, + on_setattr=on_setattr, + alias=alias, + ) + + +def asdict(inst, *, recurse=True, filter=None, value_serializer=None): + """ + Same as `attr.asdict`, except that collections types are always retained + and dict is always used as *dict_factory*. + + .. versionadded:: 21.3.0 + """ + return _asdict( + inst=inst, + recurse=recurse, + filter=filter, + value_serializer=value_serializer, + retain_collection_types=True, + ) + + +def astuple(inst, *, recurse=True, filter=None): + """ + Same as `attr.astuple`, except that collections types are always retained + and `tuple` is always used as the *tuple_factory*. + + .. versionadded:: 21.3.0 + """ + return _astuple( + inst=inst, recurse=recurse, filter=filter, retain_collection_types=True + ) + + +def inspect(cls): + """ + Inspect the class and return its effective build parameters. + + Warning: + This feature is currently **experimental** and is not covered by our + strict backwards-compatibility guarantees. + + Args: + cls: The *attrs*-decorated class to inspect. + + Returns: + The effective build parameters of the class. + + Raises: + NotAnAttrsClassError: If the class is not an *attrs*-decorated class. + + .. versionadded:: 25.4.0 + """ + try: + return cls.__dict__["__attrs_props__"] + except KeyError: + msg = f"{cls!r} is not an attrs-decorated class." + raise NotAnAttrsClassError(msg) from None diff --git a/env/lib/python3.12/site-packages/attr/_typing_compat.pyi b/env/lib/python3.12/site-packages/attr/_typing_compat.pyi new file mode 100644 index 0000000..ca7b71e --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/_typing_compat.pyi @@ -0,0 +1,15 @@ +from typing import Any, ClassVar, Protocol + +# MYPY is a special constant in mypy which works the same way as `TYPE_CHECKING`. +MYPY = False + +if MYPY: + # A protocol to be able to statically accept an attrs class. + class AttrsInstance_(Protocol): + __attrs_attrs__: ClassVar[Any] + +else: + # For type checkers without plug-in support use an empty protocol that + # will (hopefully) be combined into a union. + class AttrsInstance_(Protocol): + pass diff --git a/env/lib/python3.12/site-packages/attr/_version_info.py b/env/lib/python3.12/site-packages/attr/_version_info.py new file mode 100644 index 0000000..27f1888 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/_version_info.py @@ -0,0 +1,89 @@ +# SPDX-License-Identifier: MIT + + +from functools import total_ordering + +from ._funcs import astuple +from ._make import attrib, attrs + + +@total_ordering +@attrs(eq=False, order=False, slots=True, frozen=True) +class VersionInfo: + """ + A version object that can be compared to tuple of length 1--4: + + >>> attr.VersionInfo(19, 1, 0, "final") <= (19, 2) + True + >>> attr.VersionInfo(19, 1, 0, "final") < (19, 1, 1) + True + >>> vi = attr.VersionInfo(19, 2, 0, "final") + >>> vi < (19, 1, 1) + False + >>> vi < (19,) + False + >>> vi == (19, 2,) + True + >>> vi == (19, 2, 1) + False + + .. versionadded:: 19.2 + """ + + year = attrib(type=int) + minor = attrib(type=int) + micro = attrib(type=int) + releaselevel = attrib(type=str) + + @classmethod + def _from_version_string(cls, s): + """ + Parse *s* and return a _VersionInfo. + """ + v = s.split(".") + if len(v) == 3: + v.append("final") + + return cls( + year=int(v[0]), minor=int(v[1]), micro=int(v[2]), releaselevel=v[3] + ) + + def _ensure_tuple(self, other): + """ + Ensure *other* is a tuple of a valid length. + + Returns a possibly transformed *other* and ourselves as a tuple of + the same length as *other*. + """ + + if self.__class__ is other.__class__: + other = astuple(other) + + if not isinstance(other, tuple): + raise NotImplementedError + + if not (1 <= len(other) <= 4): + raise NotImplementedError + + return astuple(self)[: len(other)], other + + def __eq__(self, other): + try: + us, them = self._ensure_tuple(other) + except NotImplementedError: + return NotImplemented + + return us == them + + def __lt__(self, other): + try: + us, them = self._ensure_tuple(other) + except NotImplementedError: + return NotImplemented + + # Since alphabetically "dev0" < "final" < "post1" < "post2", we don't + # have to do anything special with releaselevel for now. + return us < them + + def __hash__(self): + return hash((self.year, self.minor, self.micro, self.releaselevel)) diff --git a/env/lib/python3.12/site-packages/attr/_version_info.pyi b/env/lib/python3.12/site-packages/attr/_version_info.pyi new file mode 100644 index 0000000..45ced08 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/_version_info.pyi @@ -0,0 +1,9 @@ +class VersionInfo: + @property + def year(self) -> int: ... + @property + def minor(self) -> int: ... + @property + def micro(self) -> int: ... + @property + def releaselevel(self) -> str: ... diff --git a/env/lib/python3.12/site-packages/attr/converters.py b/env/lib/python3.12/site-packages/attr/converters.py new file mode 100644 index 0000000..0a79dee --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/converters.py @@ -0,0 +1,162 @@ +# SPDX-License-Identifier: MIT + +""" +Commonly useful converters. +""" + +import typing + +from ._compat import _AnnotationExtractor +from ._make import NOTHING, Converter, Factory, pipe + + +__all__ = [ + "default_if_none", + "optional", + "pipe", + "to_bool", +] + + +def optional(converter): + """ + A converter that allows an attribute to be optional. An optional attribute + is one which can be set to `None`. + + Type annotations will be inferred from the wrapped converter's, if it has + any. + + Args: + converter (typing.Callable): + the converter that is used for non-`None` values. + + .. versionadded:: 17.1.0 + """ + + if isinstance(converter, Converter): + + def optional_converter(val, inst, field): + if val is None: + return None + return converter(val, inst, field) + + else: + + def optional_converter(val): + if val is None: + return None + return converter(val) + + xtr = _AnnotationExtractor(converter) + + t = xtr.get_first_param_type() + if t: + optional_converter.__annotations__["val"] = typing.Optional[t] + + rt = xtr.get_return_type() + if rt: + optional_converter.__annotations__["return"] = typing.Optional[rt] + + if isinstance(converter, Converter): + return Converter(optional_converter, takes_self=True, takes_field=True) + + return optional_converter + + +def default_if_none(default=NOTHING, factory=None): + """ + A converter that allows to replace `None` values by *default* or the result + of *factory*. + + Args: + default: + Value to be used if `None` is passed. Passing an instance of + `attrs.Factory` is supported, however the ``takes_self`` option is + *not*. + + factory (typing.Callable): + A callable that takes no parameters whose result is used if `None` + is passed. + + Raises: + TypeError: If **neither** *default* or *factory* is passed. + + TypeError: If **both** *default* and *factory* are passed. + + ValueError: + If an instance of `attrs.Factory` is passed with + ``takes_self=True``. + + .. versionadded:: 18.2.0 + """ + if default is NOTHING and factory is None: + msg = "Must pass either `default` or `factory`." + raise TypeError(msg) + + if default is not NOTHING and factory is not None: + msg = "Must pass either `default` or `factory` but not both." + raise TypeError(msg) + + if factory is not None: + default = Factory(factory) + + if isinstance(default, Factory): + if default.takes_self: + msg = "`takes_self` is not supported by default_if_none." + raise ValueError(msg) + + def default_if_none_converter(val): + if val is not None: + return val + + return default.factory() + + else: + + def default_if_none_converter(val): + if val is not None: + return val + + return default + + return default_if_none_converter + + +def to_bool(val): + """ + Convert "boolean" strings (for example, from environment variables) to real + booleans. + + Values mapping to `True`: + + - ``True`` + - ``"true"`` / ``"t"`` + - ``"yes"`` / ``"y"`` + - ``"on"`` + - ``"1"`` + - ``1`` + + Values mapping to `False`: + + - ``False`` + - ``"false"`` / ``"f"`` + - ``"no"`` / ``"n"`` + - ``"off"`` + - ``"0"`` + - ``0`` + + Raises: + ValueError: For any other value. + + .. versionadded:: 21.3.0 + """ + if isinstance(val, str): + val = val.lower() + + if val in (True, "true", "t", "yes", "y", "on", "1", 1): + return True + if val in (False, "false", "f", "no", "n", "off", "0", 0): + return False + + msg = f"Cannot convert value to bool: {val!r}" + raise ValueError(msg) diff --git a/env/lib/python3.12/site-packages/attr/converters.pyi b/env/lib/python3.12/site-packages/attr/converters.pyi new file mode 100644 index 0000000..12bd0c4 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/converters.pyi @@ -0,0 +1,19 @@ +from typing import Callable, Any, overload + +from attrs import _ConverterType, _CallableConverterType + +@overload +def pipe(*validators: _CallableConverterType) -> _CallableConverterType: ... +@overload +def pipe(*validators: _ConverterType) -> _ConverterType: ... +@overload +def optional(converter: _CallableConverterType) -> _CallableConverterType: ... +@overload +def optional(converter: _ConverterType) -> _ConverterType: ... +@overload +def default_if_none(default: Any) -> _CallableConverterType: ... +@overload +def default_if_none( + *, factory: Callable[[], Any] +) -> _CallableConverterType: ... +def to_bool(val: str | int | bool) -> bool: ... diff --git a/env/lib/python3.12/site-packages/attr/exceptions.py b/env/lib/python3.12/site-packages/attr/exceptions.py new file mode 100644 index 0000000..3b7abb8 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/exceptions.py @@ -0,0 +1,95 @@ +# SPDX-License-Identifier: MIT + +from __future__ import annotations + +from typing import ClassVar + + +class FrozenError(AttributeError): + """ + A frozen/immutable instance or attribute have been attempted to be + modified. + + It mirrors the behavior of ``namedtuples`` by using the same error message + and subclassing `AttributeError`. + + .. versionadded:: 20.1.0 + """ + + msg = "can't set attribute" + args: ClassVar[tuple[str]] = [msg] + + +class FrozenInstanceError(FrozenError): + """ + A frozen instance has been attempted to be modified. + + .. versionadded:: 16.1.0 + """ + + +class FrozenAttributeError(FrozenError): + """ + A frozen attribute has been attempted to be modified. + + .. versionadded:: 20.1.0 + """ + + +class AttrsAttributeNotFoundError(ValueError): + """ + An *attrs* function couldn't find an attribute that the user asked for. + + .. versionadded:: 16.2.0 + """ + + +class NotAnAttrsClassError(ValueError): + """ + A non-*attrs* class has been passed into an *attrs* function. + + .. versionadded:: 16.2.0 + """ + + +class DefaultAlreadySetError(RuntimeError): + """ + A default has been set when defining the field and is attempted to be reset + using the decorator. + + .. versionadded:: 17.1.0 + """ + + +class UnannotatedAttributeError(RuntimeError): + """ + A class with ``auto_attribs=True`` has a field without a type annotation. + + .. versionadded:: 17.3.0 + """ + + +class PythonTooOldError(RuntimeError): + """ + It was attempted to use an *attrs* feature that requires a newer Python + version. + + .. versionadded:: 18.2.0 + """ + + +class NotCallableError(TypeError): + """ + A field requiring a callable has been set with a value that is not + callable. + + .. versionadded:: 19.2.0 + """ + + def __init__(self, msg, value): + super(TypeError, self).__init__(msg, value) + self.msg = msg + self.value = value + + def __str__(self): + return str(self.msg) diff --git a/env/lib/python3.12/site-packages/attr/exceptions.pyi b/env/lib/python3.12/site-packages/attr/exceptions.pyi new file mode 100644 index 0000000..f268011 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/exceptions.pyi @@ -0,0 +1,17 @@ +from typing import Any + +class FrozenError(AttributeError): + msg: str = ... + +class FrozenInstanceError(FrozenError): ... +class FrozenAttributeError(FrozenError): ... +class AttrsAttributeNotFoundError(ValueError): ... +class NotAnAttrsClassError(ValueError): ... +class DefaultAlreadySetError(RuntimeError): ... +class UnannotatedAttributeError(RuntimeError): ... +class PythonTooOldError(RuntimeError): ... + +class NotCallableError(TypeError): + msg: str = ... + value: Any = ... + def __init__(self, msg: str, value: Any) -> None: ... diff --git a/env/lib/python3.12/site-packages/attr/filters.py b/env/lib/python3.12/site-packages/attr/filters.py new file mode 100644 index 0000000..689b170 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/filters.py @@ -0,0 +1,72 @@ +# SPDX-License-Identifier: MIT + +""" +Commonly useful filters for `attrs.asdict` and `attrs.astuple`. +""" + +from ._make import Attribute + + +def _split_what(what): + """ + Returns a tuple of `frozenset`s of classes and attributes. + """ + return ( + frozenset(cls for cls in what if isinstance(cls, type)), + frozenset(cls for cls in what if isinstance(cls, str)), + frozenset(cls for cls in what if isinstance(cls, Attribute)), + ) + + +def include(*what): + """ + Create a filter that only allows *what*. + + Args: + what (list[type, str, attrs.Attribute]): + What to include. Can be a type, a name, or an attribute. + + Returns: + Callable: + A callable that can be passed to `attrs.asdict`'s and + `attrs.astuple`'s *filter* argument. + + .. versionchanged:: 23.1.0 Accept strings with field names. + """ + cls, names, attrs = _split_what(what) + + def include_(attribute, value): + return ( + value.__class__ in cls + or attribute.name in names + or attribute in attrs + ) + + return include_ + + +def exclude(*what): + """ + Create a filter that does **not** allow *what*. + + Args: + what (list[type, str, attrs.Attribute]): + What to exclude. Can be a type, a name, or an attribute. + + Returns: + Callable: + A callable that can be passed to `attrs.asdict`'s and + `attrs.astuple`'s *filter* argument. + + .. versionchanged:: 23.3.0 Accept field name string as input argument + """ + cls, names, attrs = _split_what(what) + + def exclude_(attribute, value): + return not ( + value.__class__ in cls + or attribute.name in names + or attribute in attrs + ) + + return exclude_ diff --git a/env/lib/python3.12/site-packages/attr/filters.pyi b/env/lib/python3.12/site-packages/attr/filters.pyi new file mode 100644 index 0000000..974abdc --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/filters.pyi @@ -0,0 +1,6 @@ +from typing import Any + +from . import Attribute, _FilterType + +def include(*what: type | str | Attribute[Any]) -> _FilterType[Any]: ... +def exclude(*what: type | str | Attribute[Any]) -> _FilterType[Any]: ... diff --git a/env/lib/python3.12/site-packages/attr/py.typed b/env/lib/python3.12/site-packages/attr/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/attr/setters.py b/env/lib/python3.12/site-packages/attr/setters.py new file mode 100644 index 0000000..78b0839 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/setters.py @@ -0,0 +1,79 @@ +# SPDX-License-Identifier: MIT + +""" +Commonly used hooks for on_setattr. +""" + +from . import _config +from .exceptions import FrozenAttributeError + + +def pipe(*setters): + """ + Run all *setters* and return the return value of the last one. + + .. versionadded:: 20.1.0 + """ + + def wrapped_pipe(instance, attrib, new_value): + rv = new_value + + for setter in setters: + rv = setter(instance, attrib, rv) + + return rv + + return wrapped_pipe + + +def frozen(_, __, ___): + """ + Prevent an attribute to be modified. + + .. versionadded:: 20.1.0 + """ + raise FrozenAttributeError + + +def validate(instance, attrib, new_value): + """ + Run *attrib*'s validator on *new_value* if it has one. + + .. versionadded:: 20.1.0 + """ + if _config._run_validators is False: + return new_value + + v = attrib.validator + if not v: + return new_value + + v(instance, attrib, new_value) + + return new_value + + +def convert(instance, attrib, new_value): + """ + Run *attrib*'s converter -- if it has one -- on *new_value* and return the + result. + + .. versionadded:: 20.1.0 + """ + c = attrib.converter + if c: + # This can be removed once we drop 3.8 and use attrs.Converter instead. + from ._make import Converter + + if not isinstance(c, Converter): + return c(new_value) + + return c(new_value, instance, attrib) + + return new_value + + +# Sentinel for disabling class-wide *on_setattr* hooks for certain attributes. +# Sphinx's autodata stopped working, so the docstring is inlined in the API +# docs. +NO_OP = object() diff --git a/env/lib/python3.12/site-packages/attr/setters.pyi b/env/lib/python3.12/site-packages/attr/setters.pyi new file mode 100644 index 0000000..73abf36 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/setters.pyi @@ -0,0 +1,20 @@ +from typing import Any, NewType, NoReturn, TypeVar + +from . import Attribute +from attrs import _OnSetAttrType + +_T = TypeVar("_T") + +def frozen( + instance: Any, attribute: Attribute[Any], new_value: Any +) -> NoReturn: ... +def pipe(*setters: _OnSetAttrType) -> _OnSetAttrType: ... +def validate(instance: Any, attribute: Attribute[_T], new_value: _T) -> _T: ... + +# convert is allowed to return Any, because they can be chained using pipe. +def convert( + instance: Any, attribute: Attribute[Any], new_value: Any +) -> Any: ... + +_NoOpType = NewType("_NoOpType", object) +NO_OP: _NoOpType diff --git a/env/lib/python3.12/site-packages/attr/validators.py b/env/lib/python3.12/site-packages/attr/validators.py new file mode 100644 index 0000000..837e003 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/validators.py @@ -0,0 +1,748 @@ +# SPDX-License-Identifier: MIT + +""" +Commonly useful validators. +""" + +import operator +import re + +from contextlib import contextmanager +from re import Pattern + +from ._config import get_run_validators, set_run_validators +from ._make import _AndValidator, and_, attrib, attrs +from .converters import default_if_none +from .exceptions import NotCallableError + + +__all__ = [ + "and_", + "deep_iterable", + "deep_mapping", + "disabled", + "ge", + "get_disabled", + "gt", + "in_", + "instance_of", + "is_callable", + "le", + "lt", + "matches_re", + "max_len", + "min_len", + "not_", + "optional", + "or_", + "set_disabled", +] + + +def set_disabled(disabled): + """ + Globally disable or enable running validators. + + By default, they are run. + + Args: + disabled (bool): If `True`, disable running all validators. + + .. warning:: + + This function is not thread-safe! + + .. versionadded:: 21.3.0 + """ + set_run_validators(not disabled) + + +def get_disabled(): + """ + Return a bool indicating whether validators are currently disabled or not. + + Returns: + bool:`True` if validators are currently disabled. + + .. versionadded:: 21.3.0 + """ + return not get_run_validators() + + +@contextmanager +def disabled(): + """ + Context manager that disables running validators within its context. + + .. warning:: + + This context manager is not thread-safe! + + .. versionadded:: 21.3.0 + """ + set_run_validators(False) + try: + yield + finally: + set_run_validators(True) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _InstanceOfValidator: + type = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not isinstance(value, self.type): + msg = f"'{attr.name}' must be {self.type!r} (got {value!r} that is a {value.__class__!r})." + raise TypeError( + msg, + attr, + self.type, + value, + ) + + def __repr__(self): + return f"" + + +def instance_of(type): + """ + A validator that raises a `TypeError` if the initializer is called with a + wrong type for this particular attribute (checks are performed using + `isinstance` therefore it's also valid to pass a tuple of types). + + Args: + type (type | tuple[type]): The type to check for. + + Raises: + TypeError: + With a human readable error message, the attribute (of type + `attrs.Attribute`), the expected type, and the value it got. + """ + return _InstanceOfValidator(type) + + +@attrs(repr=False, frozen=True, slots=True) +class _MatchesReValidator: + pattern = attrib() + match_func = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not self.match_func(value): + msg = f"'{attr.name}' must match regex {self.pattern.pattern!r} ({value!r} doesn't)" + raise ValueError( + msg, + attr, + self.pattern, + value, + ) + + def __repr__(self): + return f"" + + +def matches_re(regex, flags=0, func=None): + r""" + A validator that raises `ValueError` if the initializer is called with a + string that doesn't match *regex*. + + Args: + regex (str, re.Pattern): + A regex string or precompiled pattern to match against + + flags (int): + Flags that will be passed to the underlying re function (default 0) + + func (typing.Callable): + Which underlying `re` function to call. Valid options are + `re.fullmatch`, `re.search`, and `re.match`; the default `None` + means `re.fullmatch`. For performance reasons, the pattern is + always precompiled using `re.compile`. + + .. versionadded:: 19.2.0 + .. versionchanged:: 21.3.0 *regex* can be a pre-compiled pattern. + """ + valid_funcs = (re.fullmatch, None, re.search, re.match) + if func not in valid_funcs: + msg = "'func' must be one of {}.".format( + ", ".join( + sorted((e and e.__name__) or "None" for e in set(valid_funcs)) + ) + ) + raise ValueError(msg) + + if isinstance(regex, Pattern): + if flags: + msg = "'flags' can only be used with a string pattern; pass flags to re.compile() instead" + raise TypeError(msg) + pattern = regex + else: + pattern = re.compile(regex, flags) + + if func is re.match: + match_func = pattern.match + elif func is re.search: + match_func = pattern.search + else: + match_func = pattern.fullmatch + + return _MatchesReValidator(pattern, match_func) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _OptionalValidator: + validator = attrib() + + def __call__(self, inst, attr, value): + if value is None: + return + + self.validator(inst, attr, value) + + def __repr__(self): + return f"" + + +def optional(validator): + """ + A validator that makes an attribute optional. An optional attribute is one + which can be set to `None` in addition to satisfying the requirements of + the sub-validator. + + Args: + validator + (typing.Callable | tuple[typing.Callable] | list[typing.Callable]): + A validator (or validators) that is used for non-`None` values. + + .. versionadded:: 15.1.0 + .. versionchanged:: 17.1.0 *validator* can be a list of validators. + .. versionchanged:: 23.1.0 *validator* can also be a tuple of validators. + """ + if isinstance(validator, (list, tuple)): + return _OptionalValidator(_AndValidator(validator)) + + return _OptionalValidator(validator) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _InValidator: + options = attrib() + _original_options = attrib(hash=False) + + def __call__(self, inst, attr, value): + try: + in_options = value in self.options + except TypeError: # e.g. `1 in "abc"` + in_options = False + + if not in_options: + msg = f"'{attr.name}' must be in {self._original_options!r} (got {value!r})" + raise ValueError( + msg, + attr, + self._original_options, + value, + ) + + def __repr__(self): + return f"" + + +def in_(options): + """ + A validator that raises a `ValueError` if the initializer is called with a + value that does not belong in the *options* provided. + + The check is performed using ``value in options``, so *options* has to + support that operation. + + To keep the validator hashable, dicts, lists, and sets are transparently + transformed into a `tuple`. + + Args: + options: Allowed options. + + Raises: + ValueError: + With a human readable error message, the attribute (of type + `attrs.Attribute`), the expected options, and the value it got. + + .. versionadded:: 17.1.0 + .. versionchanged:: 22.1.0 + The ValueError was incomplete until now and only contained the human + readable error message. Now it contains all the information that has + been promised since 17.1.0. + .. versionchanged:: 24.1.0 + *options* that are a list, dict, or a set are now transformed into a + tuple to keep the validator hashable. + """ + repr_options = options + if isinstance(options, (list, dict, set)): + options = tuple(options) + + return _InValidator(options, repr_options) + + +@attrs(repr=False, slots=False, unsafe_hash=True) +class _IsCallableValidator: + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not callable(value): + message = ( + "'{name}' must be callable " + "(got {value!r} that is a {actual!r})." + ) + raise NotCallableError( + msg=message.format( + name=attr.name, value=value, actual=value.__class__ + ), + value=value, + ) + + def __repr__(self): + return "" + + +def is_callable(): + """ + A validator that raises a `attrs.exceptions.NotCallableError` if the + initializer is called with a value for this particular attribute that is + not callable. + + .. versionadded:: 19.1.0 + + Raises: + attrs.exceptions.NotCallableError: + With a human readable error message containing the attribute + (`attrs.Attribute`) name, and the value it got. + """ + return _IsCallableValidator() + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _DeepIterable: + member_validator = attrib(validator=is_callable()) + iterable_validator = attrib( + default=None, validator=optional(is_callable()) + ) + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if self.iterable_validator is not None: + self.iterable_validator(inst, attr, value) + + for member in value: + self.member_validator(inst, attr, member) + + def __repr__(self): + iterable_identifier = ( + "" + if self.iterable_validator is None + else f" {self.iterable_validator!r}" + ) + return ( + f"" + ) + + +def deep_iterable(member_validator, iterable_validator=None): + """ + A validator that performs deep validation of an iterable. + + Args: + member_validator: Validator(s) to apply to iterable members. + + iterable_validator: + Validator(s) to apply to iterable itself (optional). + + Raises + TypeError: if any sub-validators fail + + .. versionadded:: 19.1.0 + + .. versionchanged:: 25.4.0 + *member_validator* and *iterable_validator* can now be a list or tuple + of validators. + """ + if isinstance(member_validator, (list, tuple)): + member_validator = and_(*member_validator) + if isinstance(iterable_validator, (list, tuple)): + iterable_validator = and_(*iterable_validator) + return _DeepIterable(member_validator, iterable_validator) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _DeepMapping: + key_validator = attrib(validator=optional(is_callable())) + value_validator = attrib(validator=optional(is_callable())) + mapping_validator = attrib(validator=optional(is_callable())) + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if self.mapping_validator is not None: + self.mapping_validator(inst, attr, value) + + for key in value: + if self.key_validator is not None: + self.key_validator(inst, attr, key) + if self.value_validator is not None: + self.value_validator(inst, attr, value[key]) + + def __repr__(self): + return f"" + + +def deep_mapping( + key_validator=None, value_validator=None, mapping_validator=None +): + """ + A validator that performs deep validation of a dictionary. + + All validators are optional, but at least one of *key_validator* or + *value_validator* must be provided. + + Args: + key_validator: Validator(s) to apply to dictionary keys. + + value_validator: Validator(s) to apply to dictionary values. + + mapping_validator: + Validator(s) to apply to top-level mapping attribute. + + .. versionadded:: 19.1.0 + + .. versionchanged:: 25.4.0 + *key_validator* and *value_validator* are now optional, but at least one + of them must be provided. + + .. versionchanged:: 25.4.0 + *key_validator*, *value_validator*, and *mapping_validator* can now be a + list or tuple of validators. + + Raises: + TypeError: If any sub-validator fails on validation. + + ValueError: + If neither *key_validator* nor *value_validator* is provided on + instantiation. + """ + if key_validator is None and value_validator is None: + msg = ( + "At least one of key_validator or value_validator must be provided" + ) + raise ValueError(msg) + + if isinstance(key_validator, (list, tuple)): + key_validator = and_(*key_validator) + if isinstance(value_validator, (list, tuple)): + value_validator = and_(*value_validator) + if isinstance(mapping_validator, (list, tuple)): + mapping_validator = and_(*mapping_validator) + + return _DeepMapping(key_validator, value_validator, mapping_validator) + + +@attrs(repr=False, frozen=True, slots=True) +class _NumberValidator: + bound = attrib() + compare_op = attrib() + compare_func = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not self.compare_func(value, self.bound): + msg = f"'{attr.name}' must be {self.compare_op} {self.bound}: {value}" + raise ValueError(msg) + + def __repr__(self): + return f"" + + +def lt(val): + """ + A validator that raises `ValueError` if the initializer is called with a + number larger or equal to *val*. + + The validator uses `operator.lt` to compare the values. + + Args: + val: Exclusive upper bound for values. + + .. versionadded:: 21.3.0 + """ + return _NumberValidator(val, "<", operator.lt) + + +def le(val): + """ + A validator that raises `ValueError` if the initializer is called with a + number greater than *val*. + + The validator uses `operator.le` to compare the values. + + Args: + val: Inclusive upper bound for values. + + .. versionadded:: 21.3.0 + """ + return _NumberValidator(val, "<=", operator.le) + + +def ge(val): + """ + A validator that raises `ValueError` if the initializer is called with a + number smaller than *val*. + + The validator uses `operator.ge` to compare the values. + + Args: + val: Inclusive lower bound for values + + .. versionadded:: 21.3.0 + """ + return _NumberValidator(val, ">=", operator.ge) + + +def gt(val): + """ + A validator that raises `ValueError` if the initializer is called with a + number smaller or equal to *val*. + + The validator uses `operator.gt` to compare the values. + + Args: + val: Exclusive lower bound for values + + .. versionadded:: 21.3.0 + """ + return _NumberValidator(val, ">", operator.gt) + + +@attrs(repr=False, frozen=True, slots=True) +class _MaxLengthValidator: + max_length = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if len(value) > self.max_length: + msg = f"Length of '{attr.name}' must be <= {self.max_length}: {len(value)}" + raise ValueError(msg) + + def __repr__(self): + return f"" + + +def max_len(length): + """ + A validator that raises `ValueError` if the initializer is called + with a string or iterable that is longer than *length*. + + Args: + length (int): Maximum length of the string or iterable + + .. versionadded:: 21.3.0 + """ + return _MaxLengthValidator(length) + + +@attrs(repr=False, frozen=True, slots=True) +class _MinLengthValidator: + min_length = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if len(value) < self.min_length: + msg = f"Length of '{attr.name}' must be >= {self.min_length}: {len(value)}" + raise ValueError(msg) + + def __repr__(self): + return f"" + + +def min_len(length): + """ + A validator that raises `ValueError` if the initializer is called + with a string or iterable that is shorter than *length*. + + Args: + length (int): Minimum length of the string or iterable + + .. versionadded:: 22.1.0 + """ + return _MinLengthValidator(length) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _SubclassOfValidator: + type = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not issubclass(value, self.type): + msg = f"'{attr.name}' must be a subclass of {self.type!r} (got {value!r})." + raise TypeError( + msg, + attr, + self.type, + value, + ) + + def __repr__(self): + return f"" + + +def _subclass_of(type): + """ + A validator that raises a `TypeError` if the initializer is called with a + wrong type for this particular attribute (checks are performed using + `issubclass` therefore it's also valid to pass a tuple of types). + + Args: + type (type | tuple[type, ...]): The type(s) to check for. + + Raises: + TypeError: + With a human readable error message, the attribute (of type + `attrs.Attribute`), the expected type, and the value it got. + """ + return _SubclassOfValidator(type) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _NotValidator: + validator = attrib() + msg = attrib( + converter=default_if_none( + "not_ validator child '{validator!r}' " + "did not raise a captured error" + ) + ) + exc_types = attrib( + validator=deep_iterable( + member_validator=_subclass_of(Exception), + iterable_validator=instance_of(tuple), + ), + ) + + def __call__(self, inst, attr, value): + try: + self.validator(inst, attr, value) + except self.exc_types: + pass # suppress error to invert validity + else: + raise ValueError( + self.msg.format( + validator=self.validator, + exc_types=self.exc_types, + ), + attr, + self.validator, + value, + self.exc_types, + ) + + def __repr__(self): + return f"" + + +def not_(validator, *, msg=None, exc_types=(ValueError, TypeError)): + """ + A validator that wraps and logically 'inverts' the validator passed to it. + It will raise a `ValueError` if the provided validator *doesn't* raise a + `ValueError` or `TypeError` (by default), and will suppress the exception + if the provided validator *does*. + + Intended to be used with existing validators to compose logic without + needing to create inverted variants, for example, ``not_(in_(...))``. + + Args: + validator: A validator to be logically inverted. + + msg (str): + Message to raise if validator fails. Formatted with keys + ``exc_types`` and ``validator``. + + exc_types (tuple[type, ...]): + Exception type(s) to capture. Other types raised by child + validators will not be intercepted and pass through. + + Raises: + ValueError: + With a human readable error message, the attribute (of type + `attrs.Attribute`), the validator that failed to raise an + exception, the value it got, and the expected exception types. + + .. versionadded:: 22.2.0 + """ + try: + exc_types = tuple(exc_types) + except TypeError: + exc_types = (exc_types,) + return _NotValidator(validator, msg, exc_types) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _OrValidator: + validators = attrib() + + def __call__(self, inst, attr, value): + for v in self.validators: + try: + v(inst, attr, value) + except Exception: # noqa: BLE001, PERF203, S112 + continue + else: + return + + msg = f"None of {self.validators!r} satisfied for value {value!r}" + raise ValueError(msg) + + def __repr__(self): + return f"" + + +def or_(*validators): + """ + A validator that composes multiple validators into one. + + When called on a value, it runs all wrapped validators until one of them is + satisfied. + + Args: + validators (~collections.abc.Iterable[typing.Callable]): + Arbitrary number of validators. + + Raises: + ValueError: + If no validator is satisfied. Raised with a human-readable error + message listing all the wrapped validators and the value that + failed all of them. + + .. versionadded:: 24.1.0 + """ + vals = [] + for v in validators: + vals.extend(v.validators if isinstance(v, _OrValidator) else [v]) + + return _OrValidator(tuple(vals)) diff --git a/env/lib/python3.12/site-packages/attr/validators.pyi b/env/lib/python3.12/site-packages/attr/validators.pyi new file mode 100644 index 0000000..36a7e80 --- /dev/null +++ b/env/lib/python3.12/site-packages/attr/validators.pyi @@ -0,0 +1,140 @@ +from types import UnionType +from typing import ( + Any, + AnyStr, + Callable, + Container, + ContextManager, + Iterable, + Mapping, + Match, + Pattern, + TypeVar, + overload, +) + +from attrs import _ValidatorType +from attrs import _ValidatorArgType + +_T = TypeVar("_T") +_T1 = TypeVar("_T1") +_T2 = TypeVar("_T2") +_T3 = TypeVar("_T3") +_T4 = TypeVar("_T4") +_T5 = TypeVar("_T5") +_T6 = TypeVar("_T6") +_I = TypeVar("_I", bound=Iterable) +_K = TypeVar("_K") +_V = TypeVar("_V") +_M = TypeVar("_M", bound=Mapping) + +def set_disabled(run: bool) -> None: ... +def get_disabled() -> bool: ... +def disabled() -> ContextManager[None]: ... + +# To be more precise on instance_of use some overloads. +# If there are more than 3 items in the tuple then we fall back to Any +@overload +def instance_of(type: type[_T]) -> _ValidatorType[_T]: ... +@overload +def instance_of(type: tuple[type[_T]]) -> _ValidatorType[_T]: ... +@overload +def instance_of( + type: tuple[type[_T1], type[_T2]], +) -> _ValidatorType[_T1 | _T2]: ... +@overload +def instance_of( + type: tuple[type[_T1], type[_T2], type[_T3]], +) -> _ValidatorType[_T1 | _T2 | _T3]: ... +@overload +def instance_of(type: tuple[type, ...]) -> _ValidatorType[Any]: ... +@overload +def instance_of(type: UnionType) -> _ValidatorType[Any]: ... +def optional( + validator: ( + _ValidatorType[_T] + | list[_ValidatorType[_T]] + | tuple[_ValidatorType[_T]] + ), +) -> _ValidatorType[_T | None]: ... +def in_(options: Container[_T]) -> _ValidatorType[_T]: ... +def and_(*validators: _ValidatorType[_T]) -> _ValidatorType[_T]: ... +def matches_re( + regex: Pattern[AnyStr] | AnyStr, + flags: int = ..., + func: Callable[[AnyStr, AnyStr, int], Match[AnyStr] | None] | None = ..., +) -> _ValidatorType[AnyStr]: ... +def deep_iterable( + member_validator: _ValidatorArgType[_T], + iterable_validator: _ValidatorArgType[_I] | None = ..., +) -> _ValidatorType[_I]: ... +@overload +def deep_mapping( + key_validator: _ValidatorArgType[_K], + value_validator: _ValidatorArgType[_V] | None = ..., + mapping_validator: _ValidatorArgType[_M] | None = ..., +) -> _ValidatorType[_M]: ... +@overload +def deep_mapping( + key_validator: _ValidatorArgType[_K] | None = ..., + value_validator: _ValidatorArgType[_V] = ..., + mapping_validator: _ValidatorArgType[_M] | None = ..., +) -> _ValidatorType[_M]: ... +def is_callable() -> _ValidatorType[_T]: ... +def lt(val: _T) -> _ValidatorType[_T]: ... +def le(val: _T) -> _ValidatorType[_T]: ... +def ge(val: _T) -> _ValidatorType[_T]: ... +def gt(val: _T) -> _ValidatorType[_T]: ... +def max_len(length: int) -> _ValidatorType[_T]: ... +def min_len(length: int) -> _ValidatorType[_T]: ... +def not_( + validator: _ValidatorType[_T], + *, + msg: str | None = None, + exc_types: type[Exception] | Iterable[type[Exception]] = ..., +) -> _ValidatorType[_T]: ... +@overload +def or_( + __v1: _ValidatorType[_T1], + __v2: _ValidatorType[_T2], +) -> _ValidatorType[_T1 | _T2]: ... +@overload +def or_( + __v1: _ValidatorType[_T1], + __v2: _ValidatorType[_T2], + __v3: _ValidatorType[_T3], +) -> _ValidatorType[_T1 | _T2 | _T3]: ... +@overload +def or_( + __v1: _ValidatorType[_T1], + __v2: _ValidatorType[_T2], + __v3: _ValidatorType[_T3], + __v4: _ValidatorType[_T4], +) -> _ValidatorType[_T1 | _T2 | _T3 | _T4]: ... +@overload +def or_( + __v1: _ValidatorType[_T1], + __v2: _ValidatorType[_T2], + __v3: _ValidatorType[_T3], + __v4: _ValidatorType[_T4], + __v5: _ValidatorType[_T5], +) -> _ValidatorType[_T1 | _T2 | _T3 | _T4 | _T5]: ... +@overload +def or_( + __v1: _ValidatorType[_T1], + __v2: _ValidatorType[_T2], + __v3: _ValidatorType[_T3], + __v4: _ValidatorType[_T4], + __v5: _ValidatorType[_T5], + __v6: _ValidatorType[_T6], +) -> _ValidatorType[_T1 | _T2 | _T3 | _T4 | _T5 | _T6]: ... +@overload +def or_( + __v1: _ValidatorType[Any], + __v2: _ValidatorType[Any], + __v3: _ValidatorType[Any], + __v4: _ValidatorType[Any], + __v5: _ValidatorType[Any], + __v6: _ValidatorType[Any], + *validators: _ValidatorType[Any], +) -> _ValidatorType[Any]: ... diff --git a/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/INSTALLER b/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/METADATA b/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/METADATA new file mode 100644 index 0000000..51128bb --- /dev/null +++ b/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/METADATA @@ -0,0 +1,235 @@ +Metadata-Version: 2.4 +Name: attrs +Version: 25.4.0 +Summary: Classes Without Boilerplate +Project-URL: Documentation, https://www.attrs.org/ +Project-URL: Changelog, https://www.attrs.org/en/stable/changelog.html +Project-URL: GitHub, https://github.com/python-attrs/attrs +Project-URL: Funding, https://github.com/sponsors/hynek +Project-URL: Tidelift, https://tidelift.com/subscription/pkg/pypi-attrs?utm_source=pypi-attrs&utm_medium=pypi +Author-email: Hynek Schlawack +License-Expression: MIT +License-File: LICENSE +Keywords: attribute,boilerplate,class +Classifier: Development Status :: 5 - Production/Stable +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Programming Language :: Python :: 3.14 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Typing :: Typed +Requires-Python: >=3.9 +Description-Content-Type: text/markdown + +

+ + attrs + +

+ + +*attrs* is the Python package that will bring back the **joy** of **writing classes** by relieving you from the drudgery of implementing object protocols (aka [dunder methods](https://www.attrs.org/en/latest/glossary.html#term-dunder-methods)). +Trusted by NASA for [Mars missions since 2020](https://github.com/readme/featured/nasa-ingenuity-helicopter)! + +Its main goal is to help you to write **concise** and **correct** software without slowing down your code. + + +## Sponsors + +*attrs* would not be possible without our [amazing sponsors](https://github.com/sponsors/hynek). +Especially those generously supporting us at the *The Organization* tier and higher: + + + +

+ + + + + + + + + +

+ + + +

+ Please consider joining them to help make attrs’s maintenance more sustainable! +

+ + + +## Example + +*attrs* gives you a class decorator and a way to declaratively define the attributes on that class: + + + +```pycon +>>> from attrs import asdict, define, make_class, Factory + +>>> @define +... class SomeClass: +... a_number: int = 42 +... list_of_numbers: list[int] = Factory(list) +... +... def hard_math(self, another_number): +... return self.a_number + sum(self.list_of_numbers) * another_number + + +>>> sc = SomeClass(1, [1, 2, 3]) +>>> sc +SomeClass(a_number=1, list_of_numbers=[1, 2, 3]) + +>>> sc.hard_math(3) +19 +>>> sc == SomeClass(1, [1, 2, 3]) +True +>>> sc != SomeClass(2, [3, 2, 1]) +True + +>>> asdict(sc) +{'a_number': 1, 'list_of_numbers': [1, 2, 3]} + +>>> SomeClass() +SomeClass(a_number=42, list_of_numbers=[]) + +>>> C = make_class("C", ["a", "b"]) +>>> C("foo", "bar") +C(a='foo', b='bar') +``` + +After *declaring* your attributes, *attrs* gives you: + +- a concise and explicit overview of the class's attributes, +- a nice human-readable `__repr__`, +- equality-checking methods, +- an initializer, +- and much more, + +*without* writing dull boilerplate code again and again and *without* runtime performance penalties. + +--- + +This example uses *attrs*'s modern APIs that have been introduced in version 20.1.0, and the *attrs* package import name that has been added in version 21.3.0. +The classic APIs (`@attr.s`, `attr.ib`, plus their serious-business aliases) and the `attr` package import name will remain **indefinitely**. + +Check out [*On The Core API Names*](https://www.attrs.org/en/latest/names.html) for an in-depth explanation! + + +### Hate Type Annotations!? + +No problem! +Types are entirely **optional** with *attrs*. +Simply assign `attrs.field()` to the attributes instead of annotating them with types: + +```python +from attrs import define, field + +@define +class SomeClass: + a_number = field(default=42) + list_of_numbers = field(factory=list) +``` + + +## Data Classes + +On the tin, *attrs* might remind you of `dataclasses` (and indeed, `dataclasses` [are a descendant](https://hynek.me/articles/import-attrs/) of *attrs*). +In practice it does a lot more and is more flexible. +For instance, it allows you to define [special handling of NumPy arrays for equality checks](https://www.attrs.org/en/stable/comparison.html#customization), allows more ways to [plug into the initialization process](https://www.attrs.org/en/stable/init.html#hooking-yourself-into-initialization), has a replacement for `__init_subclass__`, and allows for stepping through the generated methods using a debugger. + +For more details, please refer to our [comparison page](https://www.attrs.org/en/stable/why.html#data-classes), but generally speaking, we are more likely to commit crimes against nature to make things work that one would expect to work, but that are quite complicated in practice. + + +## Project Information + +- [**Changelog**](https://www.attrs.org/en/stable/changelog.html) +- [**Documentation**](https://www.attrs.org/) +- [**PyPI**](https://pypi.org/project/attrs/) +- [**Source Code**](https://github.com/python-attrs/attrs) +- [**Contributing**](https://github.com/python-attrs/attrs/blob/main/.github/CONTRIBUTING.md) +- [**Third-party Extensions**](https://github.com/python-attrs/attrs/wiki/Extensions-to-attrs) +- **Get Help**: use the `python-attrs` tag on [Stack Overflow](https://stackoverflow.com/questions/tagged/python-attrs) + + +### *attrs* for Enterprise + +Available as part of the [Tidelift Subscription](https://tidelift.com/?utm_source=lifter&utm_medium=referral&utm_campaign=hynek). + +The maintainers of *attrs* and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. +Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use. + +## Release Information + +### Backwards-incompatible Changes + +- Class-level `kw_only=True` behavior is now consistent with `dataclasses`. + + Previously, a class that sets `kw_only=True` makes all attributes keyword-only, including those from base classes. + If an attribute sets `kw_only=False`, that setting is ignored, and it is still made keyword-only. + + Now, only the attributes defined in that class that doesn't explicitly set `kw_only=False` are made keyword-only. + + This shouldn't be a problem for most users, unless you have a pattern like this: + + ```python + @attrs.define(kw_only=True) + class Base: + a: int + b: int = attrs.field(default=1, kw_only=False) + + @attrs.define + class Subclass(Base): + c: int + ``` + + Here, we have a `kw_only=True` *attrs* class (`Base`) with an attribute that sets `kw_only=False` and has a default (`Base.b`), and then create a subclass (`Subclass`) with required arguments (`Subclass.c`). + Previously this would work, since it would make `Base.b` keyword-only, but now this fails since `Base.b` is positional, and we have a required positional argument (`Subclass.c`) following another argument with defaults. + [#1457](https://github.com/python-attrs/attrs/issues/1457) + + +### Changes + +- Values passed to the `__init__()` method of `attrs` classes are now correctly passed to `__attrs_pre_init__()` instead of their default values (in cases where *kw_only* was not specified). + [#1427](https://github.com/python-attrs/attrs/issues/1427) +- Added support for Python 3.14 and [PEP 749](https://peps.python.org/pep-0749/). + [#1446](https://github.com/python-attrs/attrs/issues/1446), + [#1451](https://github.com/python-attrs/attrs/issues/1451) +- `attrs.validators.deep_mapping()` now allows to leave out either *key_validator* xor *value_validator*. + [#1448](https://github.com/python-attrs/attrs/issues/1448) +- `attrs.validators.deep_iterator()` and `attrs.validators.deep_mapping()` now accept lists and tuples for all validators and wrap them into a `attrs.validators.and_()`. + [#1449](https://github.com/python-attrs/attrs/issues/1449) +- Added a new **experimental** way to inspect classes: + + `attrs.inspect(cls)` returns the _effective_ class-wide parameters that were used by *attrs* to construct the class. + + The returned class is the same data structure that *attrs* uses internally to decide how to construct the final class. + [#1454](https://github.com/python-attrs/attrs/issues/1454) +- Fixed annotations for `attrs.field(converter=...)`. + Previously, a `tuple` of converters was only accepted if it had exactly one element. + [#1461](https://github.com/python-attrs/attrs/issues/1461) +- The performance of `attrs.asdict()` has been improved by 45–260%. + [#1463](https://github.com/python-attrs/attrs/issues/1463) +- The performance of `attrs.astuple()` has been improved by 49–270%. + [#1469](https://github.com/python-attrs/attrs/issues/1469) +- The type annotation for `attrs.validators.or_()` now allows for different types of validators. + + This was only an issue on Pyright. + [#1474](https://github.com/python-attrs/attrs/issues/1474) + + + +--- + +[Full changelog →](https://www.attrs.org/en/stable/changelog.html) diff --git a/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/RECORD b/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/RECORD new file mode 100644 index 0000000..e7d4f86 --- /dev/null +++ b/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/RECORD @@ -0,0 +1,55 @@ +attr/__init__.py,sha256=fOYIvt1eGSqQre4uCS3sJWKZ0mwAuC8UD6qba5OS9_U,2057 +attr/__init__.pyi,sha256=IZkzIjvtbRqDWGkDBIF9dd12FgDa379JYq3GHnVOvFQ,11309 +attr/__pycache__/__init__.cpython-312.pyc,, +attr/__pycache__/_cmp.cpython-312.pyc,, +attr/__pycache__/_compat.cpython-312.pyc,, +attr/__pycache__/_config.cpython-312.pyc,, +attr/__pycache__/_funcs.cpython-312.pyc,, +attr/__pycache__/_make.cpython-312.pyc,, +attr/__pycache__/_next_gen.cpython-312.pyc,, +attr/__pycache__/_version_info.cpython-312.pyc,, +attr/__pycache__/converters.cpython-312.pyc,, +attr/__pycache__/exceptions.cpython-312.pyc,, +attr/__pycache__/filters.cpython-312.pyc,, +attr/__pycache__/setters.cpython-312.pyc,, +attr/__pycache__/validators.cpython-312.pyc,, +attr/_cmp.py,sha256=3Nn1TjxllUYiX_nJoVnEkXoDk0hM1DYKj5DE7GZe4i0,4117 +attr/_cmp.pyi,sha256=U-_RU_UZOyPUEQzXE6RMYQQcjkZRY25wTH99sN0s7MM,368 +attr/_compat.py,sha256=x0g7iEUOnBVJC72zyFCgb1eKqyxS-7f2LGnNyZ_r95s,2829 +attr/_config.py,sha256=dGq3xR6fgZEF6UBt_L0T-eUHIB4i43kRmH0P28sJVw8,843 +attr/_funcs.py,sha256=Ix5IETTfz5F01F-12MF_CSFomIn2h8b67EVVz2gCtBE,16479 +attr/_make.py,sha256=NRJDGS8syg2h3YNflVNoK2FwR3CpdSZxx8M6lacwljA,104141 +attr/_next_gen.py,sha256=BQtCUlzwg2gWHTYXBQvrEYBnzBUrDvO57u0Py6UCPhc,26274 +attr/_typing_compat.pyi,sha256=XDP54TUn-ZKhD62TOQebmzrwFyomhUCoGRpclb6alRA,469 +attr/_version_info.py,sha256=w4R-FYC3NK_kMkGUWJlYP4cVAlH9HRaC-um3fcjYkHM,2222 +attr/_version_info.pyi,sha256=x_M3L3WuB7r_ULXAWjx959udKQ4HLB8l-hsc1FDGNvk,209 +attr/converters.py,sha256=GlDeOzPeTFgeBBLbj9G57Ez5lAk68uhSALRYJ_exe84,3861 +attr/converters.pyi,sha256=orU2bff-VjQa2kMDyvnMQV73oJT2WRyQuw4ZR1ym1bE,643 +attr/exceptions.py,sha256=HRFq4iybmv7-DcZwyjl6M1euM2YeJVK_hFxuaBGAngI,1977 +attr/exceptions.pyi,sha256=zZq8bCUnKAy9mDtBEw42ZhPhAUIHoTKedDQInJD883M,539 +attr/filters.py,sha256=ZBiKWLp3R0LfCZsq7X11pn9WX8NslS2wXM4jsnLOGc8,1795 +attr/filters.pyi,sha256=3J5BG-dTxltBk1_-RuNRUHrv2qu1v8v4aDNAQ7_mifA,208 +attr/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +attr/setters.py,sha256=5-dcT63GQK35ONEzSgfXCkbB7pPkaR-qv15mm4PVSzQ,1617 +attr/setters.pyi,sha256=NnVkaFU1BB4JB8E4JuXyrzTUgvtMpj8p3wBdJY7uix4,584 +attr/validators.py,sha256=1BnYGTuYvSucGEI4ju-RPNJteVzG0ZlfWpJiWoSFHQ8,21458 +attr/validators.pyi,sha256=ftmW3m4KJ3pQcIXAj-BejT7BY4ZfqrC1G-5W7XvoPds,4082 +attrs-25.4.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +attrs-25.4.0.dist-info/METADATA,sha256=2Rerxj7agcMRxiwdkt6lC2guqHAmkGKCH13nWWK7ZoQ,10473 +attrs-25.4.0.dist-info/RECORD,, +attrs-25.4.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87 +attrs-25.4.0.dist-info/licenses/LICENSE,sha256=iCEVyV38KvHutnFPjsbVy8q_Znyv-HKfQkINpj9xTp8,1109 +attrs/__init__.py,sha256=RxaAZNwYiEh-fcvHLZNpQ_DWKni73M_jxEPEftiq1Zc,1183 +attrs/__init__.pyi,sha256=2gV79g9UxJppGSM48hAZJ6h_MHb70dZoJL31ZNJeZYI,9416 +attrs/__pycache__/__init__.cpython-312.pyc,, +attrs/__pycache__/converters.cpython-312.pyc,, +attrs/__pycache__/exceptions.cpython-312.pyc,, +attrs/__pycache__/filters.cpython-312.pyc,, +attrs/__pycache__/setters.cpython-312.pyc,, +attrs/__pycache__/validators.cpython-312.pyc,, +attrs/converters.py,sha256=8kQljrVwfSTRu8INwEk8SI0eGrzmWftsT7rM0EqyohM,76 +attrs/exceptions.py,sha256=ACCCmg19-vDFaDPY9vFl199SPXCQMN_bENs4DALjzms,76 +attrs/filters.py,sha256=VOUMZug9uEU6dUuA0dF1jInUK0PL3fLgP0VBS5d-CDE,73 +attrs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +attrs/setters.py,sha256=eL1YidYQV3T2h9_SYIZSZR1FAcHGb1TuCTy0E0Lv2SU,73 +attrs/validators.py,sha256=xcy6wD5TtTkdCG1f4XWbocPSO0faBjk5IfVJfP6SUj0,76 diff --git a/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/WHEEL b/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/WHEEL new file mode 100644 index 0000000..12228d4 --- /dev/null +++ b/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: hatchling 1.27.0 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/licenses/LICENSE b/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/licenses/LICENSE new file mode 100644 index 0000000..2bd6453 --- /dev/null +++ b/env/lib/python3.12/site-packages/attrs-25.4.0.dist-info/licenses/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2015 Hynek Schlawack and the attrs 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/env/lib/python3.12/site-packages/attrs/__init__.py b/env/lib/python3.12/site-packages/attrs/__init__.py new file mode 100644 index 0000000..dc1ce4b --- /dev/null +++ b/env/lib/python3.12/site-packages/attrs/__init__.py @@ -0,0 +1,72 @@ +# SPDX-License-Identifier: MIT + +from attr import ( + NOTHING, + Attribute, + AttrsInstance, + Converter, + Factory, + NothingType, + _make_getattr, + assoc, + cmp_using, + define, + evolve, + field, + fields, + fields_dict, + frozen, + has, + make_class, + mutable, + resolve_types, + validate, +) +from attr._make import ClassProps +from attr._next_gen import asdict, astuple, inspect + +from . import converters, exceptions, filters, setters, validators + + +__all__ = [ + "NOTHING", + "Attribute", + "AttrsInstance", + "ClassProps", + "Converter", + "Factory", + "NothingType", + "__author__", + "__copyright__", + "__description__", + "__doc__", + "__email__", + "__license__", + "__title__", + "__url__", + "__version__", + "__version_info__", + "asdict", + "assoc", + "astuple", + "cmp_using", + "converters", + "define", + "evolve", + "exceptions", + "field", + "fields", + "fields_dict", + "filters", + "frozen", + "has", + "inspect", + "make_class", + "mutable", + "resolve_types", + "setters", + "validate", + "validators", +] + +__getattr__ = _make_getattr(__name__) diff --git a/env/lib/python3.12/site-packages/attrs/__init__.pyi b/env/lib/python3.12/site-packages/attrs/__init__.pyi new file mode 100644 index 0000000..6364bac --- /dev/null +++ b/env/lib/python3.12/site-packages/attrs/__init__.pyi @@ -0,0 +1,314 @@ +import sys + +from typing import ( + Any, + Callable, + Mapping, + Sequence, + overload, + TypeVar, +) + +# Because we need to type our own stuff, we have to make everything from +# attr explicitly public too. +from attr import __author__ as __author__ +from attr import __copyright__ as __copyright__ +from attr import __description__ as __description__ +from attr import __email__ as __email__ +from attr import __license__ as __license__ +from attr import __title__ as __title__ +from attr import __url__ as __url__ +from attr import __version__ as __version__ +from attr import __version_info__ as __version_info__ +from attr import assoc as assoc +from attr import Attribute as Attribute +from attr import AttrsInstance as AttrsInstance +from attr import cmp_using as cmp_using +from attr import converters as converters +from attr import Converter as Converter +from attr import evolve as evolve +from attr import exceptions as exceptions +from attr import Factory as Factory +from attr import fields as fields +from attr import fields_dict as fields_dict +from attr import filters as filters +from attr import has as has +from attr import make_class as make_class +from attr import NOTHING as NOTHING +from attr import resolve_types as resolve_types +from attr import setters as setters +from attr import validate as validate +from attr import validators as validators +from attr import attrib, asdict as asdict, astuple as astuple +from attr import NothingType as NothingType + +if sys.version_info >= (3, 11): + from typing import dataclass_transform +else: + from typing_extensions import dataclass_transform + +_T = TypeVar("_T") +_C = TypeVar("_C", bound=type) + +_EqOrderType = bool | Callable[[Any], Any] +_ValidatorType = Callable[[Any, "Attribute[_T]", _T], Any] +_CallableConverterType = Callable[[Any], Any] +_ConverterType = _CallableConverterType | Converter[Any, Any] +_ReprType = Callable[[Any], str] +_ReprArgType = bool | _ReprType +_OnSetAttrType = Callable[[Any, "Attribute[Any]", Any], Any] +_OnSetAttrArgType = _OnSetAttrType | list[_OnSetAttrType] | setters._NoOpType +_FieldTransformer = Callable[ + [type, list["Attribute[Any]"]], list["Attribute[Any]"] +] +# FIXME: in reality, if multiple validators are passed they must be in a list +# or tuple, but those are invariant and so would prevent subtypes of +# _ValidatorType from working when passed in a list or tuple. +_ValidatorArgType = _ValidatorType[_T] | Sequence[_ValidatorType[_T]] + +@overload +def field( + *, + default: None = ..., + validator: None = ..., + repr: _ReprArgType = ..., + hash: bool | None = ..., + init: bool = ..., + metadata: Mapping[Any, Any] | None = ..., + converter: None = ..., + factory: None = ..., + kw_only: bool | None = ..., + eq: bool | None = ..., + order: bool | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + alias: str | None = ..., + type: type | None = ..., +) -> Any: ... + +# This form catches an explicit None or no default and infers the type from the +# other arguments. +@overload +def field( + *, + default: None = ..., + validator: _ValidatorArgType[_T] | None = ..., + repr: _ReprArgType = ..., + hash: bool | None = ..., + init: bool = ..., + metadata: Mapping[Any, Any] | None = ..., + converter: _ConverterType + | list[_ConverterType] + | tuple[_ConverterType, ...] + | None = ..., + factory: Callable[[], _T] | None = ..., + kw_only: bool | None = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + alias: str | None = ..., + type: type | None = ..., +) -> _T: ... + +# This form catches an explicit default argument. +@overload +def field( + *, + default: _T, + validator: _ValidatorArgType[_T] | None = ..., + repr: _ReprArgType = ..., + hash: bool | None = ..., + init: bool = ..., + metadata: Mapping[Any, Any] | None = ..., + converter: _ConverterType + | list[_ConverterType] + | tuple[_ConverterType, ...] + | None = ..., + factory: Callable[[], _T] | None = ..., + kw_only: bool | None = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + alias: str | None = ..., + type: type | None = ..., +) -> _T: ... + +# This form covers type=non-Type: e.g. forward references (str), Any +@overload +def field( + *, + default: _T | None = ..., + validator: _ValidatorArgType[_T] | None = ..., + repr: _ReprArgType = ..., + hash: bool | None = ..., + init: bool = ..., + metadata: Mapping[Any, Any] | None = ..., + converter: _ConverterType + | list[_ConverterType] + | tuple[_ConverterType, ...] + | None = ..., + factory: Callable[[], _T] | None = ..., + kw_only: bool | None = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + alias: str | None = ..., + type: type | None = ..., +) -> Any: ... +@overload +@dataclass_transform(field_specifiers=(attrib, field)) +def define( + maybe_cls: _C, + *, + these: dict[str, Any] | None = ..., + repr: bool = ..., + unsafe_hash: bool | None = ..., + hash: bool | None = ..., + init: bool = ..., + slots: bool = ..., + frozen: bool = ..., + weakref_slot: bool = ..., + str: bool = ..., + auto_attribs: bool = ..., + kw_only: bool = ..., + cache_hash: bool = ..., + auto_exc: bool = ..., + eq: bool | None = ..., + order: bool | None = ..., + auto_detect: bool = ..., + getstate_setstate: bool | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + field_transformer: _FieldTransformer | None = ..., + match_args: bool = ..., +) -> _C: ... +@overload +@dataclass_transform(field_specifiers=(attrib, field)) +def define( + maybe_cls: None = ..., + *, + these: dict[str, Any] | None = ..., + repr: bool = ..., + unsafe_hash: bool | None = ..., + hash: bool | None = ..., + init: bool = ..., + slots: bool = ..., + frozen: bool = ..., + weakref_slot: bool = ..., + str: bool = ..., + auto_attribs: bool = ..., + kw_only: bool = ..., + cache_hash: bool = ..., + auto_exc: bool = ..., + eq: bool | None = ..., + order: bool | None = ..., + auto_detect: bool = ..., + getstate_setstate: bool | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + field_transformer: _FieldTransformer | None = ..., + match_args: bool = ..., +) -> Callable[[_C], _C]: ... + +mutable = define + +@overload +@dataclass_transform(frozen_default=True, field_specifiers=(attrib, field)) +def frozen( + maybe_cls: _C, + *, + these: dict[str, Any] | None = ..., + repr: bool = ..., + unsafe_hash: bool | None = ..., + hash: bool | None = ..., + init: bool = ..., + slots: bool = ..., + frozen: bool = ..., + weakref_slot: bool = ..., + str: bool = ..., + auto_attribs: bool = ..., + kw_only: bool = ..., + cache_hash: bool = ..., + auto_exc: bool = ..., + eq: bool | None = ..., + order: bool | None = ..., + auto_detect: bool = ..., + getstate_setstate: bool | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + field_transformer: _FieldTransformer | None = ..., + match_args: bool = ..., +) -> _C: ... +@overload +@dataclass_transform(frozen_default=True, field_specifiers=(attrib, field)) +def frozen( + maybe_cls: None = ..., + *, + these: dict[str, Any] | None = ..., + repr: bool = ..., + unsafe_hash: bool | None = ..., + hash: bool | None = ..., + init: bool = ..., + slots: bool = ..., + frozen: bool = ..., + weakref_slot: bool = ..., + str: bool = ..., + auto_attribs: bool = ..., + kw_only: bool = ..., + cache_hash: bool = ..., + auto_exc: bool = ..., + eq: bool | None = ..., + order: bool | None = ..., + auto_detect: bool = ..., + getstate_setstate: bool | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + field_transformer: _FieldTransformer | None = ..., + match_args: bool = ..., +) -> Callable[[_C], _C]: ... + +class ClassProps: + # XXX: somehow when defining/using enums Mypy starts looking at our own + # (untyped) code and causes tons of errors. + Hashability: Any + KeywordOnly: Any + + is_exception: bool + is_slotted: bool + has_weakref_slot: bool + is_frozen: bool + # kw_only: ClassProps.KeywordOnly + kw_only: Any + collected_fields_by_mro: bool + added_init: bool + added_repr: bool + added_eq: bool + added_ordering: bool + # hashability: ClassProps.Hashability + hashability: Any + added_match_args: bool + added_str: bool + added_pickling: bool + on_setattr_hook: _OnSetAttrType | None + field_transformer: Callable[[Attribute[Any]], Attribute[Any]] | None + + def __init__( + self, + is_exception: bool, + is_slotted: bool, + has_weakref_slot: bool, + is_frozen: bool, + # kw_only: ClassProps.KeywordOnly + kw_only: Any, + collected_fields_by_mro: bool, + added_init: bool, + added_repr: bool, + added_eq: bool, + added_ordering: bool, + # hashability: ClassProps.Hashability + hashability: Any, + added_match_args: bool, + added_str: bool, + added_pickling: bool, + on_setattr_hook: _OnSetAttrType, + field_transformer: Callable[[Attribute[Any]], Attribute[Any]], + ) -> None: ... + @property + def is_hashable(self) -> bool: ... + +def inspect(cls: type) -> ClassProps: ... diff --git a/env/lib/python3.12/site-packages/attrs/converters.py b/env/lib/python3.12/site-packages/attrs/converters.py new file mode 100644 index 0000000..7821f6c --- /dev/null +++ b/env/lib/python3.12/site-packages/attrs/converters.py @@ -0,0 +1,3 @@ +# SPDX-License-Identifier: MIT + +from attr.converters import * # noqa: F403 diff --git a/env/lib/python3.12/site-packages/attrs/exceptions.py b/env/lib/python3.12/site-packages/attrs/exceptions.py new file mode 100644 index 0000000..3323f9d --- /dev/null +++ b/env/lib/python3.12/site-packages/attrs/exceptions.py @@ -0,0 +1,3 @@ +# SPDX-License-Identifier: MIT + +from attr.exceptions import * # noqa: F403 diff --git a/env/lib/python3.12/site-packages/attrs/filters.py b/env/lib/python3.12/site-packages/attrs/filters.py new file mode 100644 index 0000000..3080f48 --- /dev/null +++ b/env/lib/python3.12/site-packages/attrs/filters.py @@ -0,0 +1,3 @@ +# SPDX-License-Identifier: MIT + +from attr.filters import * # noqa: F403 diff --git a/env/lib/python3.12/site-packages/attrs/py.typed b/env/lib/python3.12/site-packages/attrs/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/attrs/setters.py b/env/lib/python3.12/site-packages/attrs/setters.py new file mode 100644 index 0000000..f3d73bb --- /dev/null +++ b/env/lib/python3.12/site-packages/attrs/setters.py @@ -0,0 +1,3 @@ +# SPDX-License-Identifier: MIT + +from attr.setters import * # noqa: F403 diff --git a/env/lib/python3.12/site-packages/attrs/validators.py b/env/lib/python3.12/site-packages/attrs/validators.py new file mode 100644 index 0000000..037e124 --- /dev/null +++ b/env/lib/python3.12/site-packages/attrs/validators.py @@ -0,0 +1,3 @@ +# SPDX-License-Identifier: MIT + +from attr.validators import * # noqa: F403 diff --git a/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/INSTALLER b/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/LICENSE b/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/LICENSE new file mode 100644 index 0000000..75f097e --- /dev/null +++ b/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/LICENSE @@ -0,0 +1,27 @@ +Copyright (c) 2014, Thomas Kluyver +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 the name of the {organization} nor the names of its + 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 COPYRIGHT HOLDER 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/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/METADATA b/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/METADATA new file mode 100644 index 0000000..df0f708 --- /dev/null +++ b/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/METADATA @@ -0,0 +1,55 @@ +Metadata-Version: 2.1 +Name: backcall +Version: 0.2.0 +Summary: Specifications for callback functions passed in to an API +Home-page: https://github.com/takluyver/backcall +License: UNKNOWN +Author: Thomas Kluyver +Author-email: thomas@kluyver.me.uk +Description-Content-Type: text/x-rst +Classifier: License :: OSI Approved :: BSD License +Classifier: Programming Language :: Python :: 2 +Classifier: Programming Language :: Python :: 2.7 +Classifier: Programming Language :: Python :: 3 + +======== +backcall +======== + +.. image:: https://travis-ci.org/takluyver/backcall.png?branch=master + :target: https://travis-ci.org/takluyver/backcall + +Specifications for callback functions passed in to an API + +If your code lets other people supply callback functions, it's important to +specify the function signature you expect, and check that functions support that. +Adding extra parameters later would break other peoples code unless you're careful. + +backcall provides a way of specifying the callback signature using a prototype +function:: + + from backcall import callback_prototype + + @callback_prototype + def handle_ping(sender, delay=None): + # Specify positional parameters without a default, and keyword + # parameters with a default. + pass + + def register_ping_handler(callback): + # This checks and adapts the function passed in: + callback = handle_ping.adapt(callback) + ping_callbacks.append(callback) + +If the callback takes fewer parameters than your prototype, *backcall* will wrap +it in a function that discards the extra arguments. If the callback expects +more arguments, a TypeError is thrown when it is registered. + +For more details, see the `docs `_ or +the `Demo notebook `_. + +The tests are run with `pytest `_. In the root directory, +execute:: + + py.test + diff --git a/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/RECORD b/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/RECORD new file mode 100644 index 0000000..c0a9a84 --- /dev/null +++ b/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/RECORD @@ -0,0 +1,11 @@ +backcall-0.2.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +backcall-0.2.0.dist-info/LICENSE,sha256=1CL4zncxJzPAf1_sjMvmHVjVOXdPembzfkvFR0DYYCA,1490 +backcall-0.2.0.dist-info/METADATA,sha256=LT8_pGhJ34ZF8jWEZL3L-hB7HLBkscI6q9cdipDWwao,1966 +backcall-0.2.0.dist-info/RECORD,, +backcall-0.2.0.dist-info/WHEEL,sha256=4vGQWMHJO3SOyvYcLHqr380W2n90FCfzkrP_YY3xjq8,99 +backcall/__init__.py,sha256=v9YUFMCNpwHpfy9M-sfVDIYaf-0McoI-AS-3j98RG0M,213 +backcall/__pycache__/__init__.cpython-312.pyc,, +backcall/__pycache__/_signatures.cpython-312.pyc,, +backcall/__pycache__/backcall.cpython-312.pyc,, +backcall/_signatures.py,sha256=y3px_fTFVZMy8-mwTOvSxlOOaLUdHJmF37k7Rv9NXu0,29847 +backcall/backcall.py,sha256=DQzNXv47Zooa8YTX5BE19RuLx4jyrEsQURJTHhqhc48,3752 diff --git a/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/WHEEL b/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/WHEEL new file mode 100644 index 0000000..4400aaf --- /dev/null +++ b/env/lib/python3.12/site-packages/backcall-0.2.0.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: flit 2.3.0 +Root-Is-Purelib: true +Tag: py2-none-any +Tag: py3-none-any diff --git a/env/lib/python3.12/site-packages/backcall/__init__.py b/env/lib/python3.12/site-packages/backcall/__init__.py new file mode 100644 index 0000000..7a5c366 --- /dev/null +++ b/env/lib/python3.12/site-packages/backcall/__init__.py @@ -0,0 +1,7 @@ +# -*- coding: utf-8 -*- +"""Specifications for callback functions passed in to an API""" +from .backcall import callback_prototype + +__author__ = 'Thomas Kluyver' +__email__ = 'takowl@gmail.com' +__version__ = '0.2.0' diff --git a/env/lib/python3.12/site-packages/backcall/_signatures.py b/env/lib/python3.12/site-packages/backcall/_signatures.py new file mode 100644 index 0000000..f37b31c --- /dev/null +++ b/env/lib/python3.12/site-packages/backcall/_signatures.py @@ -0,0 +1,819 @@ +"""Function signature objects for callables + +Back port of Python 3.3's function signature tools from the inspect module, +modified to be compatible with Python 2.6, 2.7 and 3.2+. +""" + +#----------------------------------------------------------------------------- +# Python 3.3 stdlib inspect.py is public domain +# +# Backports Copyright (C) 2013 Aaron Iles +# Used under Apache License Version 2.0 +# +# Further Changes are Copyright (C) 2013 The IPython Development Team +# +# Distributed under the terms of the BSD License. The full license is in +# the file COPYING, distributed as part of this software. +#----------------------------------------------------------------------------- + +from __future__ import absolute_import, division, print_function +import itertools +import functools +import re +import types + + +# patch for single-file +# we don't support 2.6, so we can just import OrderedDict +from collections import OrderedDict + +__version__ = '0.3' +# end patch + +__all__ = ['BoundArguments', 'Parameter', 'Signature', 'signature'] + + +_WrapperDescriptor = type(type.__call__) +_MethodWrapper = type(all.__call__) + +_NonUserDefinedCallables = (_WrapperDescriptor, + _MethodWrapper, + types.BuiltinFunctionType) + + +def formatannotation(annotation, base_module=None): + if isinstance(annotation, type): + if annotation.__module__ in ('builtins', '__builtin__', base_module): + return annotation.__name__ + return annotation.__module__+'.'+annotation.__name__ + return repr(annotation) + + +def _get_user_defined_method(cls, method_name, *nested): + try: + if cls is type: + return + meth = getattr(cls, method_name) + for name in nested: + meth = getattr(meth, name, meth) + except AttributeError: + return + else: + if not isinstance(meth, _NonUserDefinedCallables): + # Once '__signature__' will be added to 'C'-level + # callables, this check won't be necessary + return meth + + +def signature(obj): + '''Get a signature object for the passed callable.''' + + if not callable(obj): + raise TypeError('{0!r} is not a callable object'.format(obj)) + + if isinstance(obj, types.MethodType): + # In this case we skip the first parameter of the underlying + # function (usually `self` or `cls`). + sig = signature(obj.__func__) + return sig.replace(parameters=tuple(sig.parameters.values())[1:]) + + try: + sig = obj.__signature__ + except AttributeError: + pass + else: + if sig is not None: + return sig + + try: + # Was this function wrapped by a decorator? + wrapped = obj.__wrapped__ + except AttributeError: + pass + else: + return signature(wrapped) + + if isinstance(obj, types.FunctionType): + return Signature.from_function(obj) + + if isinstance(obj, functools.partial): + sig = signature(obj.func) + + new_params = OrderedDict(sig.parameters.items()) + + partial_args = obj.args or () + partial_keywords = obj.keywords or {} + try: + ba = sig.bind_partial(*partial_args, **partial_keywords) + except TypeError as ex: + msg = 'partial object {0!r} has incorrect arguments'.format(obj) + raise ValueError(msg) + + for arg_name, arg_value in ba.arguments.items(): + param = new_params[arg_name] + if arg_name in partial_keywords: + # We set a new default value, because the following code + # is correct: + # + # >>> def foo(a): print(a) + # >>> print(partial(partial(foo, a=10), a=20)()) + # 20 + # >>> print(partial(partial(foo, a=10), a=20)(a=30)) + # 30 + # + # So, with 'partial' objects, passing a keyword argument is + # like setting a new default value for the corresponding + # parameter + # + # We also mark this parameter with '_partial_kwarg' + # flag. Later, in '_bind', the 'default' value of this + # parameter will be added to 'kwargs', to simulate + # the 'functools.partial' real call. + new_params[arg_name] = param.replace(default=arg_value, + _partial_kwarg=True) + + elif (param.kind not in (_VAR_KEYWORD, _VAR_POSITIONAL) and + not param._partial_kwarg): + new_params.pop(arg_name) + + return sig.replace(parameters=new_params.values()) + + sig = None + if isinstance(obj, type): + # obj is a class or a metaclass + + # First, let's see if it has an overloaded __call__ defined + # in its metaclass + call = _get_user_defined_method(type(obj), '__call__') + if call is not None: + sig = signature(call) + else: + # Now we check if the 'obj' class has a '__new__' method + new = _get_user_defined_method(obj, '__new__') + if new is not None: + sig = signature(new) + else: + # Finally, we should have at least __init__ implemented + init = _get_user_defined_method(obj, '__init__') + if init is not None: + sig = signature(init) + elif not isinstance(obj, _NonUserDefinedCallables): + # An object with __call__ + # We also check that the 'obj' is not an instance of + # _WrapperDescriptor or _MethodWrapper to avoid + # infinite recursion (and even potential segfault) + call = _get_user_defined_method(type(obj), '__call__', 'im_func') + if call is not None: + sig = signature(call) + + if sig is not None: + return sig + + if isinstance(obj, types.BuiltinFunctionType): + # Raise a nicer error message for builtins + msg = 'no signature found for builtin function {0!r}'.format(obj) + raise ValueError(msg) + + raise ValueError('callable {0!r} is not supported by signature'.format(obj)) + + +class _void(object): + '''A private marker - used in Parameter & Signature''' + + +class _empty(object): + pass + + +class _ParameterKind(int): + def __new__(self, *args, **kwargs): + obj = int.__new__(self, *args) + obj._name = kwargs['name'] + return obj + + def __str__(self): + return self._name + + def __repr__(self): + return '<_ParameterKind: {0!r}>'.format(self._name) + + +_POSITIONAL_ONLY = _ParameterKind(0, name='POSITIONAL_ONLY') +_POSITIONAL_OR_KEYWORD = _ParameterKind(1, name='POSITIONAL_OR_KEYWORD') +_VAR_POSITIONAL = _ParameterKind(2, name='VAR_POSITIONAL') +_KEYWORD_ONLY = _ParameterKind(3, name='KEYWORD_ONLY') +_VAR_KEYWORD = _ParameterKind(4, name='VAR_KEYWORD') + + +class Parameter(object): + '''Represents a parameter in a function signature. + + Has the following public attributes: + + * name : str + The name of the parameter as a string. + * default : object + The default value for the parameter if specified. If the + parameter has no default value, this attribute is not set. + * annotation + The annotation for the parameter if specified. If the + parameter has no annotation, this attribute is not set. + * kind : str + Describes how argument values are bound to the parameter. + Possible values: `Parameter.POSITIONAL_ONLY`, + `Parameter.POSITIONAL_OR_KEYWORD`, `Parameter.VAR_POSITIONAL`, + `Parameter.KEYWORD_ONLY`, `Parameter.VAR_KEYWORD`. + ''' + + __slots__ = ('_name', '_kind', '_default', '_annotation', '_partial_kwarg') + + POSITIONAL_ONLY = _POSITIONAL_ONLY + POSITIONAL_OR_KEYWORD = _POSITIONAL_OR_KEYWORD + VAR_POSITIONAL = _VAR_POSITIONAL + KEYWORD_ONLY = _KEYWORD_ONLY + VAR_KEYWORD = _VAR_KEYWORD + + empty = _empty + + def __init__(self, name, kind, default=_empty, annotation=_empty, + _partial_kwarg=False): + + if kind not in (_POSITIONAL_ONLY, _POSITIONAL_OR_KEYWORD, + _VAR_POSITIONAL, _KEYWORD_ONLY, _VAR_KEYWORD): + raise ValueError("invalid value for 'Parameter.kind' attribute") + self._kind = kind + + if default is not _empty: + if kind in (_VAR_POSITIONAL, _VAR_KEYWORD): + msg = '{0} parameters cannot have default values'.format(kind) + raise ValueError(msg) + self._default = default + self._annotation = annotation + + if name is None: + if kind != _POSITIONAL_ONLY: + raise ValueError("None is not a valid name for a " + "non-positional-only parameter") + self._name = name + else: + name = str(name) + if kind != _POSITIONAL_ONLY and not re.match(r'[a-z_]\w*$', name, re.I): + msg = '{0!r} is not a valid parameter name'.format(name) + raise ValueError(msg) + self._name = name + + self._partial_kwarg = _partial_kwarg + + @property + def name(self): + return self._name + + @property + def default(self): + return self._default + + @property + def annotation(self): + return self._annotation + + @property + def kind(self): + return self._kind + + def replace(self, name=_void, kind=_void, annotation=_void, + default=_void, _partial_kwarg=_void): + '''Creates a customized copy of the Parameter.''' + + if name is _void: + name = self._name + + if kind is _void: + kind = self._kind + + if annotation is _void: + annotation = self._annotation + + if default is _void: + default = self._default + + if _partial_kwarg is _void: + _partial_kwarg = self._partial_kwarg + + return type(self)(name, kind, default=default, annotation=annotation, + _partial_kwarg=_partial_kwarg) + + def __str__(self): + kind = self.kind + + formatted = self._name + if kind == _POSITIONAL_ONLY: + if formatted is None: + formatted = '' + formatted = '<{0}>'.format(formatted) + + # Add annotation and default value + if self._annotation is not _empty: + formatted = '{0}:{1}'.format(formatted, + formatannotation(self._annotation)) + + if self._default is not _empty: + formatted = '{0}={1}'.format(formatted, repr(self._default)) + + if kind == _VAR_POSITIONAL: + formatted = '*' + formatted + elif kind == _VAR_KEYWORD: + formatted = '**' + formatted + + return formatted + + def __repr__(self): + return '<{0} at {1:#x} {2!r}>'.format(self.__class__.__name__, + id(self), self.name) + + def __hash__(self): + msg = "unhashable type: '{0}'".format(self.__class__.__name__) + raise TypeError(msg) + + def __eq__(self, other): + return (issubclass(other.__class__, Parameter) and + self._name == other._name and + self._kind == other._kind and + self._default == other._default and + self._annotation == other._annotation) + + def __ne__(self, other): + return not self.__eq__(other) + + +class BoundArguments(object): + '''Result of `Signature.bind` call. Holds the mapping of arguments + to the function's parameters. + + Has the following public attributes: + + * arguments : OrderedDict + An ordered mutable mapping of parameters' names to arguments' values. + Does not contain arguments' default values. + * signature : Signature + The Signature object that created this instance. + * args : tuple + Tuple of positional arguments values. + * kwargs : dict + Dict of keyword arguments values. + ''' + + def __init__(self, signature, arguments): + self.arguments = arguments + self._signature = signature + + @property + def signature(self): + return self._signature + + @property + def args(self): + args = [] + for param_name, param in self._signature.parameters.items(): + if (param.kind in (_VAR_KEYWORD, _KEYWORD_ONLY) or + param._partial_kwarg): + # Keyword arguments mapped by 'functools.partial' + # (Parameter._partial_kwarg is True) are mapped + # in 'BoundArguments.kwargs', along with VAR_KEYWORD & + # KEYWORD_ONLY + break + + try: + arg = self.arguments[param_name] + except KeyError: + # We're done here. Other arguments + # will be mapped in 'BoundArguments.kwargs' + break + else: + if param.kind == _VAR_POSITIONAL: + # *args + args.extend(arg) + else: + # plain argument + args.append(arg) + + return tuple(args) + + @property + def kwargs(self): + kwargs = {} + kwargs_started = False + for param_name, param in self._signature.parameters.items(): + if not kwargs_started: + if (param.kind in (_VAR_KEYWORD, _KEYWORD_ONLY) or + param._partial_kwarg): + kwargs_started = True + else: + if param_name not in self.arguments: + kwargs_started = True + continue + + if not kwargs_started: + continue + + try: + arg = self.arguments[param_name] + except KeyError: + pass + else: + if param.kind == _VAR_KEYWORD: + # **kwargs + kwargs.update(arg) + else: + # plain keyword argument + kwargs[param_name] = arg + + return kwargs + + def __hash__(self): + msg = "unhashable type: '{0}'".format(self.__class__.__name__) + raise TypeError(msg) + + def __eq__(self, other): + return (issubclass(other.__class__, BoundArguments) and + self.signature == other.signature and + self.arguments == other.arguments) + + def __ne__(self, other): + return not self.__eq__(other) + + +class Signature(object): + '''A Signature object represents the overall signature of a function. + It stores a Parameter object for each parameter accepted by the + function, as well as information specific to the function itself. + + A Signature object has the following public attributes and methods: + + * parameters : OrderedDict + An ordered mapping of parameters' names to the corresponding + Parameter objects (keyword-only arguments are in the same order + as listed in `code.co_varnames`). + * return_annotation : object + The annotation for the return type of the function if specified. + If the function has no annotation for its return type, this + attribute is not set. + * bind(*args, **kwargs) -> BoundArguments + Creates a mapping from positional and keyword arguments to + parameters. + * bind_partial(*args, **kwargs) -> BoundArguments + Creates a partial mapping from positional and keyword arguments + to parameters (simulating 'functools.partial' behavior.) + ''' + + __slots__ = ('_return_annotation', '_parameters') + + _parameter_cls = Parameter + _bound_arguments_cls = BoundArguments + + empty = _empty + + def __init__(self, parameters=None, return_annotation=_empty, + __validate_parameters__=True): + '''Constructs Signature from the given list of Parameter + objects and 'return_annotation'. All arguments are optional. + ''' + + if parameters is None: + params = OrderedDict() + else: + if __validate_parameters__: + params = OrderedDict() + top_kind = _POSITIONAL_ONLY + + for idx, param in enumerate(parameters): + kind = param.kind + if kind < top_kind: + msg = 'wrong parameter order: {0} before {1}' + msg = msg.format(top_kind, param.kind) + raise ValueError(msg) + else: + top_kind = kind + + name = param.name + if name is None: + name = str(idx) + param = param.replace(name=name) + + if name in params: + msg = 'duplicate parameter name: {0!r}'.format(name) + raise ValueError(msg) + params[name] = param + else: + params = OrderedDict(((param.name, param) + for param in parameters)) + + self._parameters = params + self._return_annotation = return_annotation + + @classmethod + def from_function(cls, func): + '''Constructs Signature for the given python function''' + + if not isinstance(func, types.FunctionType): + raise TypeError('{0!r} is not a Python function'.format(func)) + + Parameter = cls._parameter_cls + + # Parameter information. + func_code = func.__code__ + pos_count = func_code.co_argcount + arg_names = func_code.co_varnames + positional = tuple(arg_names[:pos_count]) + keyword_only_count = getattr(func_code, 'co_kwonlyargcount', 0) + keyword_only = arg_names[pos_count:(pos_count + keyword_only_count)] + annotations = getattr(func, '__annotations__', {}) + defaults = func.__defaults__ + kwdefaults = getattr(func, '__kwdefaults__', None) + + if defaults: + pos_default_count = len(defaults) + else: + pos_default_count = 0 + + parameters = [] + + # Non-keyword-only parameters w/o defaults. + non_default_count = pos_count - pos_default_count + for name in positional[:non_default_count]: + annotation = annotations.get(name, _empty) + parameters.append(Parameter(name, annotation=annotation, + kind=_POSITIONAL_OR_KEYWORD)) + + # ... w/ defaults. + for offset, name in enumerate(positional[non_default_count:]): + annotation = annotations.get(name, _empty) + parameters.append(Parameter(name, annotation=annotation, + kind=_POSITIONAL_OR_KEYWORD, + default=defaults[offset])) + + # *args + if func_code.co_flags & 0x04: + name = arg_names[pos_count + keyword_only_count] + annotation = annotations.get(name, _empty) + parameters.append(Parameter(name, annotation=annotation, + kind=_VAR_POSITIONAL)) + + # Keyword-only parameters. + for name in keyword_only: + default = _empty + if kwdefaults is not None: + default = kwdefaults.get(name, _empty) + + annotation = annotations.get(name, _empty) + parameters.append(Parameter(name, annotation=annotation, + kind=_KEYWORD_ONLY, + default=default)) + # **kwargs + if func_code.co_flags & 0x08: + index = pos_count + keyword_only_count + if func_code.co_flags & 0x04: + index += 1 + + name = arg_names[index] + annotation = annotations.get(name, _empty) + parameters.append(Parameter(name, annotation=annotation, + kind=_VAR_KEYWORD)) + + return cls(parameters, + return_annotation=annotations.get('return', _empty), + __validate_parameters__=False) + + @property + def parameters(self): + try: + return types.MappingProxyType(self._parameters) + except AttributeError: + return OrderedDict(self._parameters.items()) + + @property + def return_annotation(self): + return self._return_annotation + + def replace(self, parameters=_void, return_annotation=_void): + '''Creates a customized copy of the Signature. + Pass 'parameters' and/or 'return_annotation' arguments + to override them in the new copy. + ''' + + if parameters is _void: + parameters = self.parameters.values() + + if return_annotation is _void: + return_annotation = self._return_annotation + + return type(self)(parameters, + return_annotation=return_annotation) + + def __hash__(self): + msg = "unhashable type: '{0}'".format(self.__class__.__name__) + raise TypeError(msg) + + def __eq__(self, other): + if (not issubclass(type(other), Signature) or + self.return_annotation != other.return_annotation or + len(self.parameters) != len(other.parameters)): + return False + + other_positions = dict((param, idx) + for idx, param in enumerate(other.parameters.keys())) + + for idx, (param_name, param) in enumerate(self.parameters.items()): + if param.kind == _KEYWORD_ONLY: + try: + other_param = other.parameters[param_name] + except KeyError: + return False + else: + if param != other_param: + return False + else: + try: + other_idx = other_positions[param_name] + except KeyError: + return False + else: + if (idx != other_idx or + param != other.parameters[param_name]): + return False + + return True + + def __ne__(self, other): + return not self.__eq__(other) + + def _bind(self, args, kwargs, partial=False): + '''Private method. Don't use directly.''' + + arguments = OrderedDict() + + parameters = iter(self.parameters.values()) + parameters_ex = () + arg_vals = iter(args) + + if partial: + # Support for binding arguments to 'functools.partial' objects. + # See 'functools.partial' case in 'signature()' implementation + # for details. + for param_name, param in self.parameters.items(): + if (param._partial_kwarg and param_name not in kwargs): + # Simulating 'functools.partial' behavior + kwargs[param_name] = param.default + + while True: + # Let's iterate through the positional arguments and corresponding + # parameters + try: + arg_val = next(arg_vals) + except StopIteration: + # No more positional arguments + try: + param = next(parameters) + except StopIteration: + # No more parameters. That's it. Just need to check that + # we have no `kwargs` after this while loop + break + else: + if param.kind == _VAR_POSITIONAL: + # That's OK, just empty *args. Let's start parsing + # kwargs + break + elif param.name in kwargs: + if param.kind == _POSITIONAL_ONLY: + msg = '{arg!r} parameter is positional only, ' \ + 'but was passed as a keyword' + msg = msg.format(arg=param.name) + raise TypeError(msg) + parameters_ex = (param,) + break + elif (param.kind == _VAR_KEYWORD or + param.default is not _empty): + # That's fine too - we have a default value for this + # parameter. So, lets start parsing `kwargs`, starting + # with the current parameter + parameters_ex = (param,) + break + else: + if partial: + parameters_ex = (param,) + break + else: + msg = '{arg!r} parameter lacking default value' + msg = msg.format(arg=param.name) + raise TypeError(msg) + else: + # We have a positional argument to process + try: + param = next(parameters) + except StopIteration: + raise TypeError('too many positional arguments') + else: + if param.kind in (_VAR_KEYWORD, _KEYWORD_ONLY): + # Looks like we have no parameter for this positional + # argument + raise TypeError('too many positional arguments') + + if param.kind == _VAR_POSITIONAL: + # We have an '*args'-like argument, let's fill it with + # all positional arguments we have left and move on to + # the next phase + values = [arg_val] + values.extend(arg_vals) + arguments[param.name] = tuple(values) + break + + if param.name in kwargs: + raise TypeError('multiple values for argument ' + '{arg!r}'.format(arg=param.name)) + + arguments[param.name] = arg_val + + # Now, we iterate through the remaining parameters to process + # keyword arguments + kwargs_param = None + for param in itertools.chain(parameters_ex, parameters): + if param.kind == _POSITIONAL_ONLY: + # This should never happen in case of a properly built + # Signature object (but let's have this check here + # to ensure correct behaviour just in case) + raise TypeError('{arg!r} parameter is positional only, ' + 'but was passed as a keyword'. \ + format(arg=param.name)) + + if param.kind == _VAR_KEYWORD: + # Memorize that we have a '**kwargs'-like parameter + kwargs_param = param + continue + + param_name = param.name + try: + arg_val = kwargs.pop(param_name) + except KeyError: + # We have no value for this parameter. It's fine though, + # if it has a default value, or it is an '*args'-like + # parameter, left alone by the processing of positional + # arguments. + if (not partial and param.kind != _VAR_POSITIONAL and + param.default is _empty): + raise TypeError('{arg!r} parameter lacking default value'. \ + format(arg=param_name)) + + else: + arguments[param_name] = arg_val + + if kwargs: + if kwargs_param is not None: + # Process our '**kwargs'-like parameter + arguments[kwargs_param.name] = kwargs + else: + raise TypeError('too many keyword arguments') + + return self._bound_arguments_cls(self, arguments) + + def bind(self, *args, **kwargs): + '''Get a BoundArguments object, that maps the passed `args` + and `kwargs` to the function's signature. Raises `TypeError` + if the passed arguments can not be bound. + ''' + return self._bind(args, kwargs) + + def bind_partial(self, *args, **kwargs): + '''Get a BoundArguments object, that partially maps the + passed `args` and `kwargs` to the function's signature. + Raises `TypeError` if the passed arguments can not be bound. + ''' + return self._bind(args, kwargs, partial=True) + + def __str__(self): + result = [] + render_kw_only_separator = True + for idx, param in enumerate(self.parameters.values()): + formatted = str(param) + + kind = param.kind + if kind == _VAR_POSITIONAL: + # OK, we have an '*args'-like parameter, so we won't need + # a '*' to separate keyword-only arguments + render_kw_only_separator = False + elif kind == _KEYWORD_ONLY and render_kw_only_separator: + # We have a keyword-only parameter to render and we haven't + # rendered an '*args'-like parameter before, so add a '*' + # separator to the parameters list ("foo(arg1, *, arg2)" case) + result.append('*') + # This condition should be only triggered once, so + # reset the flag + render_kw_only_separator = False + + result.append(formatted) + + rendered = '({0})'.format(', '.join(result)) + + if self.return_annotation is not _empty: + anno = formatannotation(self.return_annotation) + rendered += ' -> {0}'.format(anno) + + return rendered diff --git a/env/lib/python3.12/site-packages/backcall/backcall.py b/env/lib/python3.12/site-packages/backcall/backcall.py new file mode 100644 index 0000000..fe1fdb5 --- /dev/null +++ b/env/lib/python3.12/site-packages/backcall/backcall.py @@ -0,0 +1,109 @@ +# -*- coding: utf-8 -*- +""" +Created on Mon Jan 13 18:17:15 2014 + +@author: takluyver +""" +import sys +PY3 = (sys.version_info[0] >= 3) + +try: + from inspect import signature, Parameter # Python >= 3.3 +except ImportError: + from ._signatures import signature, Parameter + +if PY3: + from functools import wraps +else: + from functools import wraps as _wraps + def wraps(f): + def dec(func): + _wraps(f)(func) + func.__wrapped__ = f + return func + + return dec + +def callback_prototype(prototype): + """Decorator to process a callback prototype. + + A callback prototype is a function whose signature includes all the values + that will be passed by the callback API in question. + + The original function will be returned, with a ``prototype.adapt`` attribute + which can be used to prepare third party callbacks. + """ + protosig = signature(prototype) + positional, keyword = [], [] + for name, param in protosig.parameters.items(): + if param.kind in (Parameter.VAR_POSITIONAL, Parameter.VAR_KEYWORD): + raise TypeError("*args/**kwargs not supported in prototypes") + + if (param.default is not Parameter.empty) \ + or (param.kind == Parameter.KEYWORD_ONLY): + keyword.append(name) + else: + positional.append(name) + + kwargs = dict.fromkeys(keyword) + def adapt(callback): + """Introspect and prepare a third party callback.""" + sig = signature(callback) + try: + # XXX: callback can have extra optional parameters - OK? + sig.bind(*positional, **kwargs) + return callback + except TypeError: + pass + + # Match up arguments + unmatched_pos = positional[:] + unmatched_kw = kwargs.copy() + unrecognised = [] + # TODO: unrecognised parameters with default values - OK? + for name, param in sig.parameters.items(): + # print(name, param.kind) #DBG + if param.kind == Parameter.POSITIONAL_ONLY: + if len(unmatched_pos) > 0: + unmatched_pos.pop(0) + else: + unrecognised.append(name) + elif param.kind == Parameter.POSITIONAL_OR_KEYWORD: + if (param.default is not Parameter.empty) and (name in unmatched_kw): + unmatched_kw.pop(name) + elif len(unmatched_pos) > 0: + unmatched_pos.pop(0) + else: + unrecognised.append(name) + elif param.kind == Parameter.VAR_POSITIONAL: + unmatched_pos = [] + elif param.kind == Parameter.KEYWORD_ONLY: + if name in unmatched_kw: + unmatched_kw.pop(name) + else: + unrecognised.append(name) + else: # VAR_KEYWORD + unmatched_kw = {} + + # print(unmatched_pos, unmatched_kw, unrecognised) #DBG + + if unrecognised: + raise TypeError("Function {!r} had unmatched arguments: {}".format(callback, unrecognised)) + + n_positional = len(positional) - len(unmatched_pos) + + @wraps(callback) + def adapted(*args, **kwargs): + """Wrapper for third party callbacks that discards excess arguments""" +# print(args, kwargs) + args = args[:n_positional] + for name in unmatched_kw: + # XXX: Could name not be in kwargs? + kwargs.pop(name) +# print(args, kwargs, unmatched_pos, cut_positional, unmatched_kw) + return callback(*args, **kwargs) + + return adapted + + prototype.adapt = adapt + return prototype \ No newline at end of file diff --git a/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/INSTALLER b/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/METADATA b/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/METADATA new file mode 100644 index 0000000..24baa57 --- /dev/null +++ b/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/METADATA @@ -0,0 +1,476 @@ +Metadata-Version: 2.4 +Name: docopt +Version: 0.6.2 +Summary: Pythonic argument parser, that will make you smile +Home-page: http://docopt.org +Author: Vladimir Keleshev +Author-email: vladimir@keleshev.com +License: MIT +Keywords: option arguments parsing optparse argparse getopt +Classifier: Development Status :: 3 - Alpha +Classifier: Topic :: Utilities +Classifier: Programming Language :: Python :: 2.5 +Classifier: Programming Language :: Python :: 2.6 +Classifier: Programming Language :: Python :: 2.7 +Classifier: Programming Language :: Python :: 3.2 +Classifier: Programming Language :: Python :: 3.3 +Classifier: License :: OSI Approved :: MIT License +License-File: LICENSE-MIT +Dynamic: author +Dynamic: author-email +Dynamic: classifier +Dynamic: description +Dynamic: home-page +Dynamic: keywords +Dynamic: license +Dynamic: license-file +Dynamic: summary + +``docopt`` creates *beautiful* command-line interfaces +====================================================================== + +Video introduction to **docopt**: `PyCon UK 2012: Create *beautiful* +command-line interfaces with Python `_ + + New in version 0.6.1: + + - Fix issue `#85 `_ + which caused improper handling of ``[options]`` shortcut + if it was present several times. + + New in version 0.6.0: + + - New argument ``options_first``, disallows interspersing options + and arguments. If you supply ``options_first=True`` to + ``docopt``, it will interpret all arguments as positional + arguments after first positional argument. + + - If option with argument could be repeated, its default value + will be interpreted as space-separated list. E.g. with + ``[default: ./here ./there]`` will be interpreted as + ``['./here', './there']``. + + Breaking changes: + + - Meaning of ``[options]`` shortcut slightly changed. Previously + it ment *"any known option"*. Now it means *"any option not in + usage-pattern"*. This avoids the situation when an option is + allowed to be repeated unintentionaly. + + - ``argv`` is ``None`` by default, not ``sys.argv[1:]``. + This allows ``docopt`` to always use the *latest* ``sys.argv``, + not ``sys.argv`` during import time. + +Isn't it awesome how ``optparse`` and ``argparse`` generate help +messages based on your code?! + +*Hell no!* You know what's awesome? It's when the option parser *is* +generated based on the beautiful help message that you write yourself! +This way you don't need to write this stupid repeatable parser-code, +and instead can write only the help message--*the way you want it*. + +**docopt** helps you create most beautiful command-line interfaces +*easily*: + +.. code:: python + + """Naval Fate. + + Usage: + naval_fate.py ship new ... + naval_fate.py ship move [--speed=] + naval_fate.py ship shoot + naval_fate.py mine (set|remove) [--moored | --drifting] + naval_fate.py (-h | --help) + naval_fate.py --version + + Options: + -h --help Show this screen. + --version Show version. + --speed= Speed in knots [default: 10]. + --moored Moored (anchored) mine. + --drifting Drifting mine. + + """ + from docopt import docopt + + + if __name__ == '__main__': + arguments = docopt(__doc__, version='Naval Fate 2.0') + print(arguments) + +Beat that! The option parser is generated based on the docstring above +that is passed to ``docopt`` function. ``docopt`` parses the usage +pattern (``"Usage: ..."``) and option descriptions (lines starting +with dash "``-``") and ensures that the program invocation matches the +usage pattern; it parses options, arguments and commands based on +that. The basic idea is that *a good help message has all necessary +information in it to make a parser*. + +Also, `PEP 257 `_ recommends +putting help message in the module docstrings. + +Installation +====================================================================== + +Use `pip `_ or easy_install:: + + pip install docopt==0.6.2 + +Alternatively, you can just drop ``docopt.py`` file into your +project--it is self-contained. + +**docopt** is tested with Python 2.5, 2.6, 2.7, 3.2, 3.3 and PyPy. + +API +====================================================================== + +.. code:: python + + from docopt import docopt + +.. code:: python + + docopt(doc, argv=None, help=True, version=None, options_first=False) + +``docopt`` takes 1 required and 4 optional arguments: + +- ``doc`` could be a module docstring (``__doc__``) or some other + string that contains a **help message** that will be parsed to + create the option parser. The simple rules of how to write such a + help message are given in next sections. Here is a quick example of + such a string: + +.. code:: python + + """Usage: my_program.py [-hso FILE] [--quiet | --verbose] [INPUT ...] + + -h --help show this + -s --sorted sorted output + -o FILE specify output file [default: ./test.txt] + --quiet print less text + --verbose print more text + + """ + +- ``argv`` is an optional argument vector; by default ``docopt`` uses + the argument vector passed to your program (``sys.argv[1:]``). + Alternatively you can supply a list of strings like ``['--verbose', + '-o', 'hai.txt']``. + +- ``help``, by default ``True``, specifies whether the parser should + automatically print the help message (supplied as ``doc``) and + terminate, in case ``-h`` or ``--help`` option is encountered + (options should exist in usage pattern, more on that below). If you + want to handle ``-h`` or ``--help`` options manually (as other + options), set ``help=False``. + +- ``version``, by default ``None``, is an optional argument that + specifies the version of your program. If supplied, then, (assuming + ``--version`` option is mentioned in usage pattern) when parser + encounters the ``--version`` option, it will print the supplied + version and terminate. ``version`` could be any printable object, + but most likely a string, e.g. ``"2.1.0rc1"``. + + Note, when ``docopt`` is set to automatically handle ``-h``, + ``--help`` and ``--version`` options, you still need to mention + them in usage pattern for this to work. Also, for your users to + know about them. + +- ``options_first``, by default ``False``. If set to ``True`` will + disallow mixing options and positional argument. I.e. after first + positional argument, all arguments will be interpreted as positional + even if the look like options. This can be used for strict + compatibility with POSIX, or if you want to dispatch your arguments + to other programs. + +The **return** value is a simple dictionary with options, arguments +and commands as keys, spelled exactly like in your help message. Long +versions of options are given priority. For example, if you invoke the +top example as:: + + naval_fate.py ship Guardian move 100 150 --speed=15 + +the return dictionary will be: + +.. code:: python + + {'--drifting': False, 'mine': False, + '--help': False, 'move': True, + '--moored': False, 'new': False, + '--speed': '15', 'remove': False, + '--version': False, 'set': False, + '': ['Guardian'], 'ship': True, + '': '100', 'shoot': False, + '': '150'} + +Help message format +====================================================================== + +Help message consists of 2 parts: + +- Usage pattern, e.g.:: + + Usage: my_program.py [-hso FILE] [--quiet | --verbose] [INPUT ...] + +- Option descriptions, e.g.:: + + -h --help show this + -s --sorted sorted output + -o FILE specify output file [default: ./test.txt] + --quiet print less text + --verbose print more text + +Their format is described below; other text is ignored. + +Usage pattern format +---------------------------------------------------------------------- + +**Usage pattern** is a substring of ``doc`` that starts with +``usage:`` (case *insensitive*) and ends with a *visibly* empty line. +Minimum example: + +.. code:: python + + """Usage: my_program.py + + """ + +The first word after ``usage:`` is interpreted as your program's name. +You can specify your program's name several times to signify several +exclusive patterns: + +.. code:: python + + """Usage: my_program.py FILE + my_program.py COUNT FILE + + """ + +Each pattern can consist of the following elements: + +- ****, **ARGUMENTS**. Arguments are specified as either + upper-case words, e.g. ``my_program.py CONTENT-PATH`` or words + surrounded by angular brackets: ``my_program.py ``. +- **--options**. Options are words started with dash (``-``), e.g. + ``--output``, ``-o``. You can "stack" several of one-letter + options, e.g. ``-oiv`` which will be the same as ``-o -i -v``. The + options can have arguments, e.g. ``--input=FILE`` or ``-i FILE`` or + even ``-iFILE``. However it is important that you specify option + descriptions if you want for option to have an argument, a default + value, or specify synonymous short/long versions of option (see next + section on option descriptions). +- **commands** are words that do *not* follow the described above + conventions of ``--options`` or ```` or ``ARGUMENTS``, + plus two special commands: dash "``-``" and double dash "``--``" + (see below). + +Use the following constructs to specify patterns: + +- **[ ]** (brackets) **optional** elements. e.g.: ``my_program.py + [-hvqo FILE]`` +- **( )** (parens) **required** elements. All elements that are *not* + put in **[ ]** are also required, e.g.: ``my_program.py + --path= ...`` is the same as ``my_program.py + (--path= ...)``. (Note, "required options" might be not + a good idea for your users). +- **|** (pipe) **mutualy exclusive** elements. Group them using **( + )** if one of the mutually exclusive elements is required: + ``my_program.py (--clockwise | --counter-clockwise) TIME``. Group + them using **[ ]** if none of the mutually-exclusive elements are + required: ``my_program.py [--left | --right]``. +- **...** (ellipsis) **one or more** elements. To specify that + arbitrary number of repeating elements could be accepted, use + ellipsis (``...``), e.g. ``my_program.py FILE ...`` means one or + more ``FILE``-s are accepted. If you want to accept zero or more + elements, use brackets, e.g.: ``my_program.py [FILE ...]``. Ellipsis + works as a unary operator on the expression to the left. +- **[options]** (case sensitive) shortcut for any options. You can + use it if you want to specify that the usage pattern could be + provided with any options defined below in the option-descriptions + and do not want to enumerate them all in usage-pattern. - + "``[--]``". Double dash "``--``" is used by convention to separate + positional arguments that can be mistaken for options. In order to + support this convention add "``[--]``" to you usage patterns. - + "``[-]``". Single dash "``-``" is used by convention to signify that + ``stdin`` is used instead of a file. To support this add "``[-]``" + to you usage patterns. "``-``" act as a normal command. + +If your pattern allows to match argument-less option (a flag) several +times:: + + Usage: my_program.py [-v | -vv | -vvv] + +then number of occurences of the option will be counted. I.e. +``args['-v']`` will be ``2`` if program was invoked as ``my_program +-vv``. Same works for commands. + +If your usage patterns allows to match same-named option with argument +or positional argument several times, the matched arguments will be +collected into a list:: + + Usage: my_program.py --path=... + +I.e. invoked with ``my_program.py file1 file2 --path=./here +--path=./there`` the returned dict will contain ``args[''] == +['file1', 'file2']`` and ``args['--path'] == ['./here', './there']``. + + +Option descriptions format +---------------------------------------------------------------------- + +**Option descriptions** consist of a list of options that you put +below your usage patterns. + +It is necessary to list option descriptions in order to specify: + +- synonymous short and long options, +- if an option has an argument, +- if option's argument has a default value. + +The rules are as follows: + +- Every line in ``doc`` that starts with ``-`` or ``--`` (not counting + spaces) is treated as an option description, e.g.:: + + Options: + --verbose # GOOD + -o FILE # GOOD + Other: --bad # BAD, line does not start with dash "-" + +- To specify that option has an argument, put a word describing that + argument after space (or equals "``=``" sign) as shown below. Follow + either or UPPER-CASE convention for options' + arguments. You can use comma if you want to separate options. In + the example below, both lines are valid, however you are recommended + to stick to a single style.:: + + -o FILE --output=FILE # without comma, with "=" sign + -i , --input # with comma, wihtout "=" sing + +- Use two spaces to separate options with their informal description:: + + --verbose More text. # BAD, will be treated as if verbose option had + # an argument "More", so use 2 spaces instead + -q Quit. # GOOD + -o FILE Output file. # GOOD + --stdout Use stdout. # GOOD, 2 spaces + +- If you want to set a default value for an option with an argument, + put it into the option-description, in form ``[default: + ]``:: + + --coefficient=K The K coefficient [default: 2.95] + --output=FILE Output file [default: test.txt] + --directory=DIR Some directory [default: ./] + +- If the option is not repeatable, the value inside ``[default: ...]`` + will be interpeted as string. If it *is* repeatable, it will be + splited into a list on whitespace:: + + Usage: my_program.py [--repeatable= --repeatable=] + [--another-repeatable=]... + [--not-repeatable=] + + # will be ['./here', './there'] + --repeatable= [default: ./here ./there] + + # will be ['./here'] + --another-repeatable= [default: ./here] + + # will be './here ./there', because it is not repeatable + --not-repeatable= [default: ./here ./there] + +Examples +---------------------------------------------------------------------- + +We have an extensive list of `examples +`_ which cover +every aspect of functionality of **docopt**. Try them out, read the +source if in doubt. + +Subparsers, multi-level help and *huge* applications (like git) +---------------------------------------------------------------------- + +If you want to split your usage-pattern into several, implement +multi-level help (whith separate help-screen for each subcommand), +want to interface with existing scripts that don't use **docopt**, or +you're building the next "git", you will need the new ``options_first`` +parameter (described in API section above). To get you started quickly +we implemented a subset of git command-line interface as an example: +`examples/git +`_ + + +Data validation +---------------------------------------------------------------------- + +**docopt** does one thing and does it well: it implements your +command-line interface. However it does not validate the input data. +On the other hand there are libraries like `python schema +`_ which make validating data a +breeze. Take a look at `validation_example.py +`_ +which uses **schema** to validate data and report an error to the +user. + +Development +====================================================================== + +We would *love* to hear what you think about **docopt** on our `issues +page `_ + +Make pull requrests, report bugs, suggest ideas and discuss +**docopt**. You can also drop a line directly to +. + +Porting ``docopt`` to other languages +====================================================================== + +We think **docopt** is so good, we want to share it beyond the Python +community! + +The follosing ports are available: + +- `Ruby port `_ +- `CoffeeScript port `_ +- `Lua port `_ +- `PHP port `_ + +But you can always create a port for your favorite language! You are +encouraged to use the Python version as a reference implementation. A +Language-agnostic test suite is bundled with `Python implementation +`_. + +Porting discussion is on `issues page +`_. + +Changelog +====================================================================== + +**docopt** follows `semantic versioning `_. The +first release with stable API will be 1.0.0 (soon). Until then, you +are encouraged to specify explicitly the version in your dependency +tools, e.g.:: + + pip install docopt==0.6.2 + +- 0.6.2 `Wheel `_ support. +- 0.6.1 Bugfix release. +- 0.6.0 ``options_first`` parameter. + **Breaking changes**: Corrected ``[options]`` meaning. + ``argv`` defaults to ``None``. +- 0.5.0 Repeated options/commands are counted or accumulated into a + list. +- 0.4.2 Bugfix release. +- 0.4.0 Option descriptions become optional, + support for "``--``" and "``-``" commands. +- 0.3.0 Support for (sub)commands like `git remote add`. + Introduce ``[options]`` shortcut for any options. + **Breaking changes**: ``docopt`` returns dictionary. +- 0.2.0 Usage pattern matching. Positional arguments parsing based on + usage patterns. + **Breaking changes**: ``docopt`` returns namespace (for arguments), + not list. Usage pattern is formalized. +- 0.1.0 Initial release. Options-parsing only (based on options + description). diff --git a/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/RECORD b/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/RECORD new file mode 100644 index 0000000..8b2741f --- /dev/null +++ b/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/RECORD @@ -0,0 +1,8 @@ +__pycache__/docopt.cpython-312.pyc,, +docopt-0.6.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +docopt-0.6.2.dist-info/METADATA,sha256=1MPvNeb4fHM4FO4CvNUONMQx9ARBldT5l6eSAfScUXY,18108 +docopt-0.6.2.dist-info/RECORD,, +docopt-0.6.2.dist-info/WHEEL,sha256=uC7DnXjtoKy23CNUXRq6ohLsm8FbS2C_ECfYYzqZHVY,109 +docopt-0.6.2.dist-info/licenses/LICENSE-MIT,sha256=PV33j1kv8kM8PGzkmECRt_SXBZ3bjGsIoGG6SON7Z_I,1097 +docopt-0.6.2.dist-info/top_level.txt,sha256=xAvL2ywTOdLde8wxTVye1299j65YdK3cM5963wNy5SU,7 +docopt.py,sha256=RMZQ69gz2FLIcx-j8MV1lQYwliIwDkwZVKVA14VyzFQ,19946 diff --git a/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/WHEEL b/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/WHEEL new file mode 100644 index 0000000..d621b60 --- /dev/null +++ b/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/WHEEL @@ -0,0 +1,6 @@ +Wheel-Version: 1.0 +Generator: setuptools (82.0.0) +Root-Is-Purelib: true +Tag: py2-none-any +Tag: py3-none-any + diff --git a/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/licenses/LICENSE-MIT b/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/licenses/LICENSE-MIT new file mode 100644 index 0000000..3b2eb5c --- /dev/null +++ b/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/licenses/LICENSE-MIT @@ -0,0 +1,19 @@ +Copyright (c) 2012 Vladimir Keleshev, + +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/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/top_level.txt b/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/top_level.txt new file mode 100644 index 0000000..e5ed2a0 --- /dev/null +++ b/env/lib/python3.12/site-packages/docopt-0.6.2.dist-info/top_level.txt @@ -0,0 +1 @@ +docopt diff --git a/env/lib/python3.12/site-packages/docopt.py b/env/lib/python3.12/site-packages/docopt.py new file mode 100644 index 0000000..7b927e2 --- /dev/null +++ b/env/lib/python3.12/site-packages/docopt.py @@ -0,0 +1,579 @@ +"""Pythonic command-line interface parser that will make you smile. + + * http://docopt.org + * Repository and issue-tracker: https://github.com/docopt/docopt + * Licensed under terms of MIT license (see LICENSE-MIT) + * Copyright (c) 2013 Vladimir Keleshev, vladimir@keleshev.com + +""" +import sys +import re + + +__all__ = ['docopt'] +__version__ = '0.6.2' + + +class DocoptLanguageError(Exception): + + """Error in construction of usage-message by developer.""" + + +class DocoptExit(SystemExit): + + """Exit in case user invoked program with incorrect arguments.""" + + usage = '' + + def __init__(self, message=''): + SystemExit.__init__(self, (message + '\n' + self.usage).strip()) + + +class Pattern(object): + + def __eq__(self, other): + return repr(self) == repr(other) + + def __hash__(self): + return hash(repr(self)) + + def fix(self): + self.fix_identities() + self.fix_repeating_arguments() + return self + + def fix_identities(self, uniq=None): + """Make pattern-tree tips point to same object if they are equal.""" + if not hasattr(self, 'children'): + return self + uniq = list(set(self.flat())) if uniq is None else uniq + for i, c in enumerate(self.children): + if not hasattr(c, 'children'): + assert c in uniq + self.children[i] = uniq[uniq.index(c)] + else: + c.fix_identities(uniq) + + def fix_repeating_arguments(self): + """Fix elements that should accumulate/increment values.""" + either = [list(c.children) for c in self.either.children] + for case in either: + for e in [c for c in case if case.count(c) > 1]: + if type(e) is Argument or type(e) is Option and e.argcount: + if e.value is None: + e.value = [] + elif type(e.value) is not list: + e.value = e.value.split() + if type(e) is Command or type(e) is Option and e.argcount == 0: + e.value = 0 + return self + + @property + def either(self): + """Transform pattern into an equivalent, with only top-level Either.""" + # Currently the pattern will not be equivalent, but more "narrow", + # although good enough to reason about list arguments. + ret = [] + groups = [[self]] + while groups: + children = groups.pop(0) + types = [type(c) for c in children] + if Either in types: + either = [c for c in children if type(c) is Either][0] + children.pop(children.index(either)) + for c in either.children: + groups.append([c] + children) + elif Required in types: + required = [c for c in children if type(c) is Required][0] + children.pop(children.index(required)) + groups.append(list(required.children) + children) + elif Optional in types: + optional = [c for c in children if type(c) is Optional][0] + children.pop(children.index(optional)) + groups.append(list(optional.children) + children) + elif AnyOptions in types: + optional = [c for c in children if type(c) is AnyOptions][0] + children.pop(children.index(optional)) + groups.append(list(optional.children) + children) + elif OneOrMore in types: + oneormore = [c for c in children if type(c) is OneOrMore][0] + children.pop(children.index(oneormore)) + groups.append(list(oneormore.children) * 2 + children) + else: + ret.append(children) + return Either(*[Required(*e) for e in ret]) + + +class ChildPattern(Pattern): + + def __init__(self, name, value=None): + self.name = name + self.value = value + + def __repr__(self): + return '%s(%r, %r)' % (self.__class__.__name__, self.name, self.value) + + def flat(self, *types): + return [self] if not types or type(self) in types else [] + + def match(self, left, collected=None): + collected = [] if collected is None else collected + pos, match = self.single_match(left) + if match is None: + return False, left, collected + left_ = left[:pos] + left[pos + 1:] + same_name = [a for a in collected if a.name == self.name] + if type(self.value) in (int, list): + if type(self.value) is int: + increment = 1 + else: + increment = ([match.value] if type(match.value) is str + else match.value) + if not same_name: + match.value = increment + return True, left_, collected + [match] + same_name[0].value += increment + return True, left_, collected + return True, left_, collected + [match] + + +class ParentPattern(Pattern): + + def __init__(self, *children): + self.children = list(children) + + def __repr__(self): + return '%s(%s)' % (self.__class__.__name__, + ', '.join(repr(a) for a in self.children)) + + def flat(self, *types): + if type(self) in types: + return [self] + return sum([c.flat(*types) for c in self.children], []) + + +class Argument(ChildPattern): + + def single_match(self, left): + for n, p in enumerate(left): + if type(p) is Argument: + return n, Argument(self.name, p.value) + return None, None + + @classmethod + def parse(class_, source): + name = re.findall('(<\S*?>)', source)[0] + value = re.findall('\[default: (.*)\]', source, flags=re.I) + return class_(name, value[0] if value else None) + + +class Command(Argument): + + def __init__(self, name, value=False): + self.name = name + self.value = value + + def single_match(self, left): + for n, p in enumerate(left): + if type(p) is Argument: + if p.value == self.name: + return n, Command(self.name, True) + else: + break + return None, None + + +class Option(ChildPattern): + + def __init__(self, short=None, long=None, argcount=0, value=False): + assert argcount in (0, 1) + self.short, self.long = short, long + self.argcount, self.value = argcount, value + self.value = None if value is False and argcount else value + + @classmethod + def parse(class_, option_description): + short, long, argcount, value = None, None, 0, False + options, _, description = option_description.strip().partition(' ') + options = options.replace(',', ' ').replace('=', ' ') + for s in options.split(): + if s.startswith('--'): + long = s + elif s.startswith('-'): + short = s + else: + argcount = 1 + if argcount: + matched = re.findall('\[default: (.*)\]', description, flags=re.I) + value = matched[0] if matched else None + return class_(short, long, argcount, value) + + def single_match(self, left): + for n, p in enumerate(left): + if self.name == p.name: + return n, p + return None, None + + @property + def name(self): + return self.long or self.short + + def __repr__(self): + return 'Option(%r, %r, %r, %r)' % (self.short, self.long, + self.argcount, self.value) + + +class Required(ParentPattern): + + def match(self, left, collected=None): + collected = [] if collected is None else collected + l = left + c = collected + for p in self.children: + matched, l, c = p.match(l, c) + if not matched: + return False, left, collected + return True, l, c + + +class Optional(ParentPattern): + + def match(self, left, collected=None): + collected = [] if collected is None else collected + for p in self.children: + m, left, collected = p.match(left, collected) + return True, left, collected + + +class AnyOptions(Optional): + + """Marker/placeholder for [options] shortcut.""" + + +class OneOrMore(ParentPattern): + + def match(self, left, collected=None): + assert len(self.children) == 1 + collected = [] if collected is None else collected + l = left + c = collected + l_ = None + matched = True + times = 0 + while matched: + # could it be that something didn't match but changed l or c? + matched, l, c = self.children[0].match(l, c) + times += 1 if matched else 0 + if l_ == l: + break + l_ = l + if times >= 1: + return True, l, c + return False, left, collected + + +class Either(ParentPattern): + + def match(self, left, collected=None): + collected = [] if collected is None else collected + outcomes = [] + for p in self.children: + matched, _, _ = outcome = p.match(left, collected) + if matched: + outcomes.append(outcome) + if outcomes: + return min(outcomes, key=lambda outcome: len(outcome[1])) + return False, left, collected + + +class TokenStream(list): + + def __init__(self, source, error): + self += source.split() if hasattr(source, 'split') else source + self.error = error + + def move(self): + return self.pop(0) if len(self) else None + + def current(self): + return self[0] if len(self) else None + + +def parse_long(tokens, options): + """long ::= '--' chars [ ( ' ' | '=' ) chars ] ;""" + long, eq, value = tokens.move().partition('=') + assert long.startswith('--') + value = None if eq == value == '' else value + similar = [o for o in options if o.long == long] + if tokens.error is DocoptExit and similar == []: # if no exact match + similar = [o for o in options if o.long and o.long.startswith(long)] + if len(similar) > 1: # might be simply specified ambiguously 2+ times? + raise tokens.error('%s is not a unique prefix: %s?' % + (long, ', '.join(o.long for o in similar))) + elif len(similar) < 1: + argcount = 1 if eq == '=' else 0 + o = Option(None, long, argcount) + options.append(o) + if tokens.error is DocoptExit: + o = Option(None, long, argcount, value if argcount else True) + else: + o = Option(similar[0].short, similar[0].long, + similar[0].argcount, similar[0].value) + if o.argcount == 0: + if value is not None: + raise tokens.error('%s must not have an argument' % o.long) + else: + if value is None: + if tokens.current() is None: + raise tokens.error('%s requires argument' % o.long) + value = tokens.move() + if tokens.error is DocoptExit: + o.value = value if value is not None else True + return [o] + + +def parse_shorts(tokens, options): + """shorts ::= '-' ( chars )* [ [ ' ' ] chars ] ;""" + token = tokens.move() + assert token.startswith('-') and not token.startswith('--') + left = token.lstrip('-') + parsed = [] + while left != '': + short, left = '-' + left[0], left[1:] + similar = [o for o in options if o.short == short] + if len(similar) > 1: + raise tokens.error('%s is specified ambiguously %d times' % + (short, len(similar))) + elif len(similar) < 1: + o = Option(short, None, 0) + options.append(o) + if tokens.error is DocoptExit: + o = Option(short, None, 0, True) + else: # why copying is necessary here? + o = Option(short, similar[0].long, + similar[0].argcount, similar[0].value) + value = None + if o.argcount != 0: + if left == '': + if tokens.current() is None: + raise tokens.error('%s requires argument' % short) + value = tokens.move() + else: + value = left + left = '' + if tokens.error is DocoptExit: + o.value = value if value is not None else True + parsed.append(o) + return parsed + + +def parse_pattern(source, options): + tokens = TokenStream(re.sub(r'([\[\]\(\)\|]|\.\.\.)', r' \1 ', source), + DocoptLanguageError) + result = parse_expr(tokens, options) + if tokens.current() is not None: + raise tokens.error('unexpected ending: %r' % ' '.join(tokens)) + return Required(*result) + + +def parse_expr(tokens, options): + """expr ::= seq ( '|' seq )* ;""" + seq = parse_seq(tokens, options) + if tokens.current() != '|': + return seq + result = [Required(*seq)] if len(seq) > 1 else seq + while tokens.current() == '|': + tokens.move() + seq = parse_seq(tokens, options) + result += [Required(*seq)] if len(seq) > 1 else seq + return [Either(*result)] if len(result) > 1 else result + + +def parse_seq(tokens, options): + """seq ::= ( atom [ '...' ] )* ;""" + result = [] + while tokens.current() not in [None, ']', ')', '|']: + atom = parse_atom(tokens, options) + if tokens.current() == '...': + atom = [OneOrMore(*atom)] + tokens.move() + result += atom + return result + + +def parse_atom(tokens, options): + """atom ::= '(' expr ')' | '[' expr ']' | 'options' + | long | shorts | argument | command ; + """ + token = tokens.current() + result = [] + if token in '([': + tokens.move() + matching, pattern = {'(': [')', Required], '[': [']', Optional]}[token] + result = pattern(*parse_expr(tokens, options)) + if tokens.move() != matching: + raise tokens.error("unmatched '%s'" % token) + return [result] + elif token == 'options': + tokens.move() + return [AnyOptions()] + elif token.startswith('--') and token != '--': + return parse_long(tokens, options) + elif token.startswith('-') and token not in ('-', '--'): + return parse_shorts(tokens, options) + elif token.startswith('<') and token.endswith('>') or token.isupper(): + return [Argument(tokens.move())] + else: + return [Command(tokens.move())] + + +def parse_argv(tokens, options, options_first=False): + """Parse command-line argument vector. + + If options_first: + argv ::= [ long | shorts ]* [ argument ]* [ '--' [ argument ]* ] ; + else: + argv ::= [ long | shorts | argument ]* [ '--' [ argument ]* ] ; + + """ + parsed = [] + while tokens.current() is not None: + if tokens.current() == '--': + return parsed + [Argument(None, v) for v in tokens] + elif tokens.current().startswith('--'): + parsed += parse_long(tokens, options) + elif tokens.current().startswith('-') and tokens.current() != '-': + parsed += parse_shorts(tokens, options) + elif options_first: + return parsed + [Argument(None, v) for v in tokens] + else: + parsed.append(Argument(None, tokens.move())) + return parsed + + +def parse_defaults(doc): + # in python < 2.7 you can't pass flags=re.MULTILINE + split = re.split('\n *(<\S+?>|-\S+?)', doc)[1:] + split = [s1 + s2 for s1, s2 in zip(split[::2], split[1::2])] + options = [Option.parse(s) for s in split if s.startswith('-')] + #arguments = [Argument.parse(s) for s in split if s.startswith('<')] + #return options, arguments + return options + + +def printable_usage(doc): + # in python < 2.7 you can't pass flags=re.IGNORECASE + usage_split = re.split(r'([Uu][Ss][Aa][Gg][Ee]:)', doc) + if len(usage_split) < 3: + raise DocoptLanguageError('"usage:" (case-insensitive) not found.') + if len(usage_split) > 3: + raise DocoptLanguageError('More than one "usage:" (case-insensitive).') + return re.split(r'\n\s*\n', ''.join(usage_split[1:]))[0].strip() + + +def formal_usage(printable_usage): + pu = printable_usage.split()[1:] # split and drop "usage:" + return '( ' + ' '.join(') | (' if s == pu[0] else s for s in pu[1:]) + ' )' + + +def extras(help, version, options, doc): + if help and any((o.name in ('-h', '--help')) and o.value for o in options): + print(doc.strip("\n")) + sys.exit() + if version and any(o.name == '--version' and o.value for o in options): + print(version) + sys.exit() + + +class Dict(dict): + def __repr__(self): + return '{%s}' % ',\n '.join('%r: %r' % i for i in sorted(self.items())) + + +def docopt(doc, argv=None, help=True, version=None, options_first=False): + """Parse `argv` based on command-line interface described in `doc`. + + `docopt` creates your command-line interface based on its + description that you pass as `doc`. Such description can contain + --options, , commands, which could be + [optional], (required), (mutually | exclusive) or repeated... + + Parameters + ---------- + doc : str + Description of your command-line interface. + argv : list of str, optional + Argument vector to be parsed. sys.argv[1:] is used if not + provided. + help : bool (default: True) + Set to False to disable automatic help on -h or --help + options. + version : any object + If passed, the object will be printed if --version is in + `argv`. + options_first : bool (default: False) + Set to True to require options preceed positional arguments, + i.e. to forbid options and positional arguments intermix. + + Returns + ------- + args : dict + A dictionary, where keys are names of command-line elements + such as e.g. "--verbose" and "", and values are the + parsed values of those elements. + + Example + ------- + >>> from docopt import docopt + >>> doc = ''' + Usage: + my_program tcp [--timeout=] + my_program serial [--baud=] [--timeout=] + my_program (-h | --help | --version) + + Options: + -h, --help Show this screen and exit. + --baud= Baudrate [default: 9600] + ''' + >>> argv = ['tcp', '127.0.0.1', '80', '--timeout', '30'] + >>> docopt(doc, argv) + {'--baud': '9600', + '--help': False, + '--timeout': '30', + '--version': False, + '': '127.0.0.1', + '': '80', + 'serial': False, + 'tcp': True} + + See also + -------- + * For video introduction see http://docopt.org + * Full documentation is available in README.rst as well as online + at https://github.com/docopt/docopt#readme + + """ + if argv is None: + argv = sys.argv[1:] + DocoptExit.usage = printable_usage(doc) + options = parse_defaults(doc) + pattern = parse_pattern(formal_usage(DocoptExit.usage), options) + # [default] syntax for argument is disabled + #for a in pattern.flat(Argument): + # same_name = [d for d in arguments if d.name == a.name] + # if same_name: + # a.value = same_name[0].value + argv = parse_argv(TokenStream(argv, DocoptExit), list(options), + options_first) + pattern_options = set(pattern.flat(Option)) + for ao in pattern.flat(AnyOptions): + doc_options = parse_defaults(doc) + ao.children = list(set(doc_options) - pattern_options) + #if any_options: + # ao.children += [Option(o.short, o.long, o.argcount) + # for o in argv if type(o) is Option] + extras(help, version, argv, doc) + matched, left, collected = pattern.fix().match(argv) + if matched and left == []: # better error message if left? + return Dict((a.name, a.value) for a in (pattern.flat() + collected)) + raise DocoptExit() diff --git a/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/INSTALLER b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/METADATA b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/METADATA new file mode 100644 index 0000000..937348e --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/METADATA @@ -0,0 +1,63 @@ +Metadata-Version: 2.4 +Name: fastjsonschema +Version: 2.21.2 +Summary: Fastest Python implementation of JSON schema +Home-page: https://github.com/horejsek/python-fastjsonschema +Author: Michal Horejsek +Author-email: fastjsonschema@horejsek.com +License: BSD +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.3 +Classifier: Programming Language :: Python :: 3.4 +Classifier: Programming Language :: Python :: 3.5 +Classifier: Programming Language :: Python :: 3.6 +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: License :: OSI Approved :: BSD License +Classifier: Operating System :: OS Independent +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: Topic :: Software Development :: Libraries :: Python Modules +License-File: LICENSE +License-File: AUTHORS +Provides-Extra: devel +Requires-Dist: colorama; extra == "devel" +Requires-Dist: jsonschema; extra == "devel" +Requires-Dist: json-spec; extra == "devel" +Requires-Dist: pylint; extra == "devel" +Requires-Dist: pytest; extra == "devel" +Requires-Dist: pytest-benchmark; extra == "devel" +Requires-Dist: pytest-cache; extra == "devel" +Requires-Dist: validictory; extra == "devel" +Dynamic: author +Dynamic: author-email +Dynamic: classifier +Dynamic: description +Dynamic: home-page +Dynamic: license +Dynamic: license-file +Dynamic: provides-extra +Dynamic: summary + +=========================== +Fast JSON schema for Python +=========================== + +|PyPI| |Pythons| + +.. |PyPI| image:: https://img.shields.io/pypi/v/fastjsonschema.svg + :alt: PyPI version + :target: https://pypi.python.org/pypi/fastjsonschema + +.. |Pythons| image:: https://img.shields.io/pypi/pyversions/fastjsonschema.svg + :alt: Supported Python versions + :target: https://pypi.python.org/pypi/fastjsonschema + +See `documentation `_. diff --git a/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/RECORD b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/RECORD new file mode 100644 index 0000000..b09d6ce --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/RECORD @@ -0,0 +1,27 @@ +fastjsonschema-2.21.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +fastjsonschema-2.21.2.dist-info/METADATA,sha256=G-gUOjPfDs-CuZPZXpEYDii98tEo-ajQP2i_CZ17afM,2330 +fastjsonschema-2.21.2.dist-info/RECORD,, +fastjsonschema-2.21.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91 +fastjsonschema-2.21.2.dist-info/licenses/AUTHORS,sha256=DLGgN1TEmM2VoBM4cRn-gklc4HA8jLLPDDCeBD1kGhU,350 +fastjsonschema-2.21.2.dist-info/licenses/LICENSE,sha256=nM3faes5mKYBSN6-hblMWv7VNpG2R0aS54q8wKDlRPE,1518 +fastjsonschema-2.21.2.dist-info/top_level.txt,sha256=8RQcPDFXXHZKduTjgzugpPNW3zIjxFT0axTh4UsT6gE,15 +fastjsonschema/__init__.py,sha256=GzCywWlandjQQsJLXaZkHYdnydNcITF6r24Av5gQYgU,10347 +fastjsonschema/__main__.py,sha256=4hfd23przxmQc8VjL0fUsbsrvvA73gJ2HDNPgLLFdAI,312 +fastjsonschema/__pycache__/__init__.cpython-312.pyc,, +fastjsonschema/__pycache__/__main__.cpython-312.pyc,, +fastjsonschema/__pycache__/draft04.cpython-312.pyc,, +fastjsonschema/__pycache__/draft06.cpython-312.pyc,, +fastjsonschema/__pycache__/draft07.cpython-312.pyc,, +fastjsonschema/__pycache__/exceptions.cpython-312.pyc,, +fastjsonschema/__pycache__/generator.cpython-312.pyc,, +fastjsonschema/__pycache__/indent.cpython-312.pyc,, +fastjsonschema/__pycache__/ref_resolver.cpython-312.pyc,, +fastjsonschema/__pycache__/version.cpython-312.pyc,, +fastjsonschema/draft04.py,sha256=nUP1LhjYBrTMrfhI8nNNxGnlBz1cTrJp5ckgJJMsZqQ,30801 +fastjsonschema/draft06.py,sha256=cSPnflqydr6EV4p02T_gh4VFX7mVVdoKCxnNwnC_PPA,7892 +fastjsonschema/draft07.py,sha256=D4qNNhWcjg0TrEiHQ0BJNwvlyv1Rp8gyEBYgRBmV2b8,4449 +fastjsonschema/exceptions.py,sha256=w749JgqKi8clBFcObdcbZVqsmF4oJ_QByhZ1SGbUFNw,1612 +fastjsonschema/generator.py,sha256=bYZt_QfrCH_v7rJDBMteeJx4UDygEV7XZjOtFL3ikls,13059 +fastjsonschema/indent.py,sha256=juZFW9LSvmDJbPFIUm3GPqdPqJoUnqvM8neHN5rkvzU,920 +fastjsonschema/ref_resolver.py,sha256=PWnu-2MZzWH5cymDvdcvXfx3iOW_Mr6c-xXMYm9FD7Q,5577 +fastjsonschema/version.py,sha256=MZ2cW1TR0nZ-hJl307Agq6NSdPz1JFAgDTEzzA3T-7c,19 diff --git a/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/WHEEL b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/WHEEL new file mode 100644 index 0000000..e7fa31b --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (80.9.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/licenses/AUTHORS b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/licenses/AUTHORS new file mode 100644 index 0000000..721bda3 --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/licenses/AUTHORS @@ -0,0 +1,11 @@ +MAINTAINER +Michal Hořejšek + +CONTRIBUTORS +anentropic +Antti Jokipii +bcaller +Frederik Petersen +Guillaume Desvé +Kris Molendyke +David Majda diff --git a/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/licenses/LICENSE b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/licenses/LICENSE new file mode 100644 index 0000000..1d77bbf --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/licenses/LICENSE @@ -0,0 +1,27 @@ +Copyright (c) 2018, Michal Horejsek +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 the name of the {organization} nor the names of its + 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 COPYRIGHT HOLDER 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/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/top_level.txt b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/top_level.txt new file mode 100644 index 0000000..f4ffe07 --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema-2.21.2.dist-info/top_level.txt @@ -0,0 +1 @@ +fastjsonschema diff --git a/env/lib/python3.12/site-packages/fastjsonschema/__init__.py b/env/lib/python3.12/site-packages/fastjsonschema/__init__.py new file mode 100644 index 0000000..0fe1bf7 --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema/__init__.py @@ -0,0 +1,277 @@ +# ___ +# \./ DANGER: This project implements some code generation +# .--.O.--. techniques involving string concatenation. +# \/ \/ If you look at it, you might die. +# + +r""" +Installation +************ + +.. code-block:: bash + + pip install fastjsonschema + +Support only for Python 3.3 and higher. + +About +***** + +``fastjsonschema`` implements validation of JSON documents by JSON schema. +The library implements JSON schema drafts 04, 06, and 07. The main purpose is +to have a really fast implementation. See some numbers: + + * Probably the most popular, ``jsonschema``, can take up to 5 seconds for valid + inputs and 1.2 seconds for invalid inputs. + * Second most popular, ``json-spec``, is even worse with up to 7.2 and 1.7 seconds. + * Last ``validictory``, now deprecated, is much better with 370 or 23 milliseconds, + but it does not follow all standards, and it can be still slow for some purposes. + +With this library you can gain big improvements as ``fastjsonschema`` takes +only about 25 milliseconds for valid inputs and 2 milliseconds for invalid ones. +Pretty amazing, right? :-) + +Technically it works by generating the most stupid code on the fly, which is fast but +is hard to write by hand. The best efficiency is achieved when a validator is compiled +once and used many times, of course. It works similarly like regular expressions. But +you can also generate the code to a file, which is even slightly faster. + +You can run the performance benchmarks on your computer or server with the included +script: + +.. code-block:: bash + + $ make performance + fast_compiled valid ==> 0.0993900 + fast_compiled invalid ==> 0.0041089 + fast_compiled_without_exc valid ==> 0.0465258 + fast_compiled_without_exc invalid ==> 0.0023688 + fast_file valid ==> 0.0989483 + fast_file invalid ==> 0.0041104 + fast_not_compiled valid ==> 11.9572681 + fast_not_compiled invalid ==> 2.9512092 + jsonschema valid ==> 5.2233240 + jsonschema invalid ==> 1.3227916 + jsonschema_compiled valid ==> 0.4447982 + jsonschema_compiled invalid ==> 0.0231333 + jsonspec valid ==> 4.1450569 + jsonspec invalid ==> 1.0485777 + validictory valid ==> 0.2730411 + validictory invalid ==> 0.0183669 + +This library follows and implements `JSON schema draft-04, draft-06, and draft-07 +`_. Sometimes it's not perfectly clear, so I recommend also +check out this `understanding JSON schema `_. + +Note that there are some differences compared to JSON schema standard: + + * Regular expressions are full Python ones, not only what JSON schema allows. It's easier + to allow everything, and also it's faster to compile without limits. So keep in mind that when + you will use a more advanced regular expression, it may not work with other libraries or in + other languages. + * Because Python matches new line for a dollar in regular expressions (``a$`` matches ``a`` and ``a\\n``), + instead of ``$`` is used ``\Z`` and all dollars in your regular expression are changed to ``\\Z`` + as well. When you want to use dollar as regular character, you have to escape it (``\$``). + * JSON schema says you can use keyword ``default`` for providing default values. This implementation + uses that and always returns transformed input data. + +Usage +***** + +.. code-block:: python + + import fastjsonschema + + point_schema = { + "type": "object", + "properties": { + "x": { + "type": "number", + }, + "y": { + "type": "number", + }, + }, + "required": ["x", "y"], + "additionalProperties": False, + } + + point_validator = fastjsonschema.compile(point_schema) + try: + point_validator({"x": 1.0, "y": 2.0}) + except fastjsonschema.JsonSchemaException as e: + print(f"Data failed validation: {e}") + +API +*** +""" +from functools import partial, update_wrapper + +from .draft04 import CodeGeneratorDraft04 +from .draft06 import CodeGeneratorDraft06 +from .draft07 import CodeGeneratorDraft07 +from .exceptions import JsonSchemaException, JsonSchemaValueException, JsonSchemaDefinitionException +from .ref_resolver import RefResolver +from .version import VERSION + +__all__ = ( + 'VERSION', + 'JsonSchemaException', + 'JsonSchemaValueException', + 'JsonSchemaDefinitionException', + 'validate', + 'compile', + 'compile_to_code', +) + + +def validate(definition, data, handlers={}, formats={}, use_default=True, use_formats=True, detailed_exceptions=True): + """ + Validation function for lazy programmers or for use cases when you need + to call validation only once, so you do not have to compile it first. + Use it only when you do not care about performance (even though it will + be still faster than alternative implementations). + + .. code-block:: python + + import fastjsonschema + + fastjsonschema.validate({'type': 'string'}, 'hello') + # same as: compile({'type': 'string'})('hello') + + Preferred is to use :any:`compile` function. + """ + return compile(definition, handlers, formats, use_default, use_formats, detailed_exceptions)(data) + + +#TODO: Change use_default to False when upgrading to version 3. +# pylint: disable=redefined-builtin,dangerous-default-value,exec-used +def compile(definition, handlers={}, formats={}, use_default=True, use_formats=True, detailed_exceptions=True): + """ + Generates validation function for validating JSON schema passed in ``definition``. + Example: + + .. code-block:: python + + import fastjsonschema + + validate = fastjsonschema.compile({'type': 'string'}) + validate('hello') + + This implementation supports keyword ``default`` (can be turned off + by passing `use_default=False`): + + .. code-block:: python + + validate = fastjsonschema.compile({ + 'type': 'object', + 'properties': { + 'a': {'type': 'number', 'default': 42}, + }, + }) + + data = validate({}) + assert data == {'a': 42} + + Supported implementations are draft-04, draft-06 and draft-07. Which version + should be used is determined by `$draft` in your ``definition``. When not + specified, the latest implementation is used (draft-07). + + .. code-block:: python + + validate = fastjsonschema.compile({ + '$schema': 'http://json-schema.org/draft-04/schema', + 'type': 'number', + }) + + You can pass mapping from URI to function that should be used to retrieve + remote schemes used in your ``definition`` in parameter ``handlers``. + + Also, you can pass mapping for custom formats. Key is the name of your + formatter and value can be regular expression, which will be compiled or + callback returning `bool` (or you can raise your own exception). + + .. code-block:: python + + validate = fastjsonschema.compile(definition, formats={ + 'foo': r'foo|bar', + 'bar': lambda value: value in ('foo', 'bar'), + }) + + Note that formats are automatically used as assertions. It can be turned + off by passing `use_formats=False`. When disabled, custom formats are + disabled as well. (Added in 2.19.0.) + + If you don't need detailed exceptions, you can turn the details off and gain + additional performance by passing `detailed_exceptions=False`. + + Exception :any:`JsonSchemaDefinitionException` is raised when generating the + code fails (bad definition). + + Exception :any:`JsonSchemaValueException` is raised from generated function when + validation fails (data do not follow the definition). + """ + resolver, code_generator = _factory(definition, handlers, formats, use_default, use_formats, detailed_exceptions) + global_state = code_generator.global_state + # Do not pass local state so it can recursively call itself. + exec(code_generator.func_code, global_state) + func = global_state[resolver.get_scope_name()] + if formats: + return update_wrapper(partial(func, custom_formats=formats), func) + return func + + +# pylint: disable=dangerous-default-value +def compile_to_code(definition, handlers={}, formats={}, use_default=True, use_formats=True, detailed_exceptions=True): + """ + Generates validation code for validating JSON schema passed in ``definition``. + Example: + + .. code-block:: python + + import fastjsonschema + + code = fastjsonschema.compile_to_code({'type': 'string'}) + with open('your_file.py', 'w') as f: + f.write(code) + + You can also use it as a script: + + .. code-block:: bash + + echo "{'type': 'string'}" | python3 -m fastjsonschema > your_file.py + python3 -m fastjsonschema "{'type': 'string'}" > your_file.py + + Exception :any:`JsonSchemaDefinitionException` is raised when generating the + code fails (bad definition). + """ + _, code_generator = _factory(definition, handlers, formats, use_default, use_formats, detailed_exceptions) + return ( + 'VERSION = "' + VERSION + '"\n' + + code_generator.global_state_code + '\n' + + code_generator.func_code + ) + + +def _factory(definition, handlers, formats={}, use_default=True, use_formats=True, detailed_exceptions=True): + resolver = RefResolver.from_schema(definition, handlers=handlers, store={}) + code_generator = _get_code_generator_class(definition)( + definition, + resolver=resolver, + formats=formats, + use_default=use_default, + use_formats=use_formats, + detailed_exceptions=detailed_exceptions, + ) + return resolver, code_generator + + +def _get_code_generator_class(schema): + # Schema in from draft-06 can be just the boolean value. + if isinstance(schema, dict): + schema_version = schema.get('$schema', '') + if 'draft-04' in schema_version: + return CodeGeneratorDraft04 + if 'draft-06' in schema_version: + return CodeGeneratorDraft06 + return CodeGeneratorDraft07 diff --git a/env/lib/python3.12/site-packages/fastjsonschema/__main__.py b/env/lib/python3.12/site-packages/fastjsonschema/__main__.py new file mode 100644 index 0000000..e5f3aa7 --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema/__main__.py @@ -0,0 +1,19 @@ +import json +import sys + +from . import compile_to_code + + +def main(): + if len(sys.argv) == 2: + definition = sys.argv[1] + else: + definition = sys.stdin.read() + + definition = json.loads(definition) + code = compile_to_code(definition) + print(code) + + +if __name__ == '__main__': + main() diff --git a/env/lib/python3.12/site-packages/fastjsonschema/draft04.py b/env/lib/python3.12/site-packages/fastjsonschema/draft04.py new file mode 100644 index 0000000..c1650dd --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema/draft04.py @@ -0,0 +1,618 @@ +import decimal +import re + +from .exceptions import JsonSchemaDefinitionException +from .generator import CodeGenerator, enforce_list + + +JSON_TYPE_TO_PYTHON_TYPE = { + 'null': 'NoneType', + 'boolean': 'bool', + 'number': 'int, float, Decimal', + 'integer': 'int', + 'string': 'str', + 'array': 'list, tuple', + 'object': 'dict', +} + +DOLLAR_FINDER = re.compile(r"(? {maxLength}:'): + self.exc('{name} must be shorter than or equal to {maxLength} characters', rule='maxLength') + + def generate_pattern(self): + with self.l('if isinstance({variable}, str):'): + pattern = self._definition['pattern'] + safe_pattern = pattern.replace('\\', '\\\\').replace('"', '\\"') + end_of_string_fixed_pattern = DOLLAR_FINDER.sub(r'\\Z', pattern) + self._compile_regexps[pattern] = re.compile(end_of_string_fixed_pattern) + with self.l('if not REGEX_PATTERNS[{}].search({variable}):', repr(pattern)): + self.exc('{name} must match pattern {}', safe_pattern, rule='pattern') + + def generate_format(self): + """ + Means that value have to be in specified format. For example date, email or other. + + .. code-block:: python + + {'format': 'email'} + + Valid value for this definition is user@example.com but not @username + """ + if not self._use_formats: + return + with self.l('if isinstance({variable}, str):'): + format_ = self._definition['format'] + # Checking custom formats - user is allowed to override default formats. + if format_ in self._custom_formats: + custom_format = self._custom_formats[format_] + if isinstance(custom_format, str): + self._generate_format(format_, format_ + '_re_pattern', custom_format) + else: + with self.l('if not custom_formats["{}"]({variable}):', format_): + self.exc('{name} must be {}', format_, rule='format') + elif format_ in self.FORMAT_REGEXS: + format_regex = self.FORMAT_REGEXS[format_] + self._generate_format(format_, format_ + '_re_pattern', format_regex) + # Format regex is used only in meta schemas. + elif format_ == 'regex': + self._extra_imports_lines = ['import re'] + with self.l('try:', optimize=False): + self.l('re.compile({variable})') + with self.l('except Exception:'): + self.exc('{name} must be a valid regex', rule='format') + else: + raise JsonSchemaDefinitionException('Unknown format: {}'.format(format_)) + + + def _generate_format(self, format_name, regexp_name, regexp): + if self._definition['format'] == format_name: + if not regexp_name in self._compile_regexps: + self._compile_regexps[regexp_name] = re.compile(regexp) + with self.l('if not REGEX_PATTERNS["{}"].match({variable}):', regexp_name): + self.exc('{name} must be {}', format_name, rule='format') + + def generate_minimum(self): + with self.l('if isinstance({variable}, (int, float, Decimal)):'): + if not isinstance(self._definition['minimum'], (int, float, decimal.Decimal)): + raise JsonSchemaDefinitionException('minimum must be a number') + if self._definition.get('exclusiveMinimum', False): + with self.l('if {variable} <= {minimum}:'): + self.exc('{name} must be bigger than {minimum}', rule='minimum') + else: + with self.l('if {variable} < {minimum}:'): + self.exc('{name} must be bigger than or equal to {minimum}', rule='minimum') + + def generate_maximum(self): + with self.l('if isinstance({variable}, (int, float, Decimal)):'): + if not isinstance(self._definition['maximum'], (int, float, decimal.Decimal)): + raise JsonSchemaDefinitionException('maximum must be a number') + if self._definition.get('exclusiveMaximum', False): + with self.l('if {variable} >= {maximum}:'): + self.exc('{name} must be smaller than {maximum}', rule='maximum') + else: + with self.l('if {variable} > {maximum}:'): + self.exc('{name} must be smaller than or equal to {maximum}', rule='maximum') + + def generate_multiple_of(self): + with self.l('if isinstance({variable}, (int, float, Decimal)):'): + if not isinstance(self._definition['multipleOf'], (int, float, decimal.Decimal)): + raise JsonSchemaDefinitionException('multipleOf must be a number') + # For proper multiplication check of floats we need to use decimals, + # because for example 19.01 / 0.01 = 1901.0000000000002. + if isinstance(self._definition['multipleOf'], float): + self.l('quotient = Decimal(repr({variable})) / Decimal(repr({multipleOf}))') + else: + self.l('quotient = {variable} / {multipleOf}') + with self.l('if int(quotient) != quotient:'): + self.exc('{name} must be multiple of {multipleOf}', rule='multipleOf') + # For example, 1e308 / 0.123456789 + with self.l('if {variable} / {multipleOf} == float("inf"):'): + self.exc('inifinity reached', rule='multipleOf') + + def generate_min_items(self): + self.create_variable_is_list() + with self.l('if {variable}_is_list:'): + if not isinstance(self._definition['minItems'], (int, float)): + raise JsonSchemaDefinitionException('minItems must be a number') + self.create_variable_with_length() + with self.l('if {variable}_len < {minItems}:'): + self.exc('{name} must contain at least {minItems} items', rule='minItems') + + def generate_max_items(self): + self.create_variable_is_list() + with self.l('if {variable}_is_list:'): + if not isinstance(self._definition['maxItems'], (int, float)): + raise JsonSchemaDefinitionException('maxItems must be a number') + self.create_variable_with_length() + with self.l('if {variable}_len > {maxItems}:'): + self.exc('{name} must contain less than or equal to {maxItems} items', rule='maxItems') + + def generate_unique_items(self): + """ + With Python 3.4 module ``timeit`` recommended this solutions: + + .. code-block:: python + + >>> timeit.timeit("len(x) > len(set(x))", "x=range(100)+range(100)", number=100000) + 0.5839540958404541 + >>> timeit.timeit("len({}.fromkeys(x)) == len(x)", "x=range(100)+range(100)", number=100000) + 0.7094449996948242 + >>> timeit.timeit("seen = set(); any(i in seen or seen.add(i) for i in x)", "x=range(100)+range(100)", number=100000) + 2.0819358825683594 + >>> timeit.timeit("np.unique(x).size == len(x)", "x=range(100)+range(100); import numpy as np", number=100000) + 2.1439831256866455 + """ + unique_definition = self._definition['uniqueItems'] + if not unique_definition: + return + + self.create_variable_is_list() + with self.l('if {variable}_is_list:'): + self.l( + 'def fn(var): ' + 'return frozenset(dict((k, fn(v)) ' + 'for k, v in var.items()).items()) ' + 'if hasattr(var, "items") else tuple(fn(v) ' + 'for v in var) ' + 'if isinstance(var, (dict, list)) else str(var) ' + 'if isinstance(var, bool) else var') + self.create_variable_with_length() + with self.l('if {variable}_len > len(set(fn({variable}_x) for {variable}_x in {variable})):'): + self.exc('{name} must contain unique items', rule='uniqueItems') + + def generate_items(self): + """ + Means array is valid only when all items are valid by this definition. + + .. code-block:: python + + { + 'items': [ + {'type': 'integer'}, + {'type': 'string'}, + ], + } + + Valid arrays are those with integers or strings, nothing else. + + Since draft 06 definition can be also boolean. True means nothing, False + means everything is invalid. + """ + items_definition = self._definition['items'] + if items_definition is True: + return + + self.create_variable_is_list() + with self.l('if {variable}_is_list:'): + self.create_variable_with_length() + if items_definition is False: + with self.l('if {variable}:'): + self.exc('{name} must not be there', rule='items') + elif isinstance(items_definition, list): + for idx, item_definition in enumerate(items_definition): + with self.l('if {variable}_len > {}:', idx): + self.l('{variable}__{0} = {variable}[{0}]', idx) + self.generate_func_code_block( + item_definition, + '{}__{}'.format(self._variable, idx), + '{}[{}]'.format(self._variable_name, idx), + ) + if self._use_default and isinstance(item_definition, dict) and 'default' in item_definition: + self.l('else: {variable}.append({})', repr(item_definition['default'])) + + if 'additionalItems' in self._definition: + if self._definition['additionalItems'] is False: + with self.l('if {variable}_len > {}:', len(items_definition)): + self.exc('{name} must contain only specified items', rule='items') + else: + with self.l('for {variable}_x, {variable}_item in enumerate({variable}[{0}:], {0}):', len(items_definition)): + count = self.generate_func_code_block( + self._definition['additionalItems'], + '{}_item'.format(self._variable), + '{}[{{{}_x}}]'.format(self._variable_name, self._variable), + ) + if count == 0: + self.l('pass') + else: + if items_definition: + with self.l('for {variable}_x, {variable}_item in enumerate({variable}):'): + count = self.generate_func_code_block( + items_definition, + '{}_item'.format(self._variable), + '{}[{{{}_x}}]'.format(self._variable_name, self._variable), + ) + if count == 0: + self.l('pass') + + def generate_min_properties(self): + self.create_variable_is_dict() + with self.l('if {variable}_is_dict:'): + if not isinstance(self._definition['minProperties'], (int, float)): + raise JsonSchemaDefinitionException('minProperties must be a number') + self.create_variable_with_length() + with self.l('if {variable}_len < {minProperties}:'): + self.exc('{name} must contain at least {minProperties} properties', rule='minProperties') + + def generate_max_properties(self): + self.create_variable_is_dict() + with self.l('if {variable}_is_dict:'): + if not isinstance(self._definition['maxProperties'], (int, float)): + raise JsonSchemaDefinitionException('maxProperties must be a number') + self.create_variable_with_length() + with self.l('if {variable}_len > {maxProperties}:'): + self.exc('{name} must contain less than or equal to {maxProperties} properties', rule='maxProperties') + + def generate_required(self): + self.create_variable_is_dict() + with self.l('if {variable}_is_dict:'): + if not isinstance(self._definition['required'], (list, tuple)): + raise JsonSchemaDefinitionException('required must be an array') + if len(self._definition['required']) != len(set(self._definition['required'])): + raise JsonSchemaDefinitionException('required must contain unique elements') + if not self._definition.get('additionalProperties', True): + not_possible = [ + prop + for prop in self._definition['required'] + if + prop not in self._definition.get('properties', {}) + and not any(re.search(regex, prop) for regex in self._definition.get('patternProperties', {})) + ] + if not_possible: + raise JsonSchemaDefinitionException('{}: items {} are required but not allowed'.format(self._variable, not_possible)) + self.l('{variable}__missing_keys = set({required}) - {variable}.keys()') + with self.l('if {variable}__missing_keys:'): + dynamic = 'str(sorted({variable}__missing_keys)) + " properties"' + self.exc('{name} must contain ', self.e(self._definition['required']), rule='required', append_to_msg=dynamic) + + def generate_properties(self): + """ + Means object with defined keys. + + .. code-block:: python + + { + 'properties': { + 'key': {'type': 'number'}, + }, + } + + Valid object is containing key called 'key' and value any number. + """ + self.create_variable_is_dict() + with self.l('if {variable}_is_dict:'): + self.create_variable_keys() + for key, prop_definition in self._definition['properties'].items(): + key_name = re.sub(r'($[^a-zA-Z]|[^a-zA-Z0-9])', '', key) + if not isinstance(prop_definition, (dict, bool)): + raise JsonSchemaDefinitionException('{}[{}] must be object'.format(self._variable, key_name)) + with self.l('if "{}" in {variable}_keys:', self.e(key)): + self.l('{variable}_keys.remove("{}")', self.e(key)) + self.l('{variable}__{0} = {variable}["{1}"]', key_name, self.e(key)) + self.generate_func_code_block( + prop_definition, + '{}__{}'.format(self._variable, key_name), + '{}.{}'.format(self._variable_name, self.e(key)), + clear_variables=True, + ) + if self._use_default and isinstance(prop_definition, dict) and 'default' in prop_definition: + self.l('else: {variable}["{}"] = {}', self.e(key), repr(prop_definition['default'])) + + def generate_pattern_properties(self): + """ + Means object with defined keys as patterns. + + .. code-block:: python + + { + 'patternProperties': { + '^x': {'type': 'number'}, + }, + } + + Valid object is containing key starting with a 'x' and value any number. + """ + self.create_variable_is_dict() + with self.l('if {variable}_is_dict:'): + self.create_variable_keys() + for pattern, definition in self._definition['patternProperties'].items(): + self._compile_regexps[pattern] = re.compile(pattern) + with self.l('for {variable}_key, {variable}_val in {variable}.items():'): + for pattern, definition in self._definition['patternProperties'].items(): + with self.l('if REGEX_PATTERNS[{}].search({variable}_key):', repr(pattern)): + with self.l('if {variable}_key in {variable}_keys:'): + self.l('{variable}_keys.remove({variable}_key)') + self.generate_func_code_block( + definition, + '{}_val'.format(self._variable), + '{}.{{{}_key}}'.format(self._variable_name, self._variable), + clear_variables=True, + ) + + def generate_additional_properties(self): + """ + Means object with keys with values defined by definition. + + .. code-block:: python + + { + 'properties': { + 'key': {'type': 'number'}, + } + 'additionalProperties': {'type': 'string'}, + } + + Valid object is containing key called 'key' and it's value any number and + any other key with any string. + """ + self.create_variable_is_dict() + with self.l('if {variable}_is_dict:'): + self.create_variable_keys() + add_prop_definition = self._definition["additionalProperties"] + if add_prop_definition is True or add_prop_definition == {}: + return + if add_prop_definition: + properties_keys = list(self._definition.get("properties", {}).keys()) + with self.l('for {variable}_key in {variable}_keys:'): + with self.l('if {variable}_key not in {}:', properties_keys): + self.l('{variable}_value = {variable}.get({variable}_key)') + self.generate_func_code_block( + add_prop_definition, + '{}_value'.format(self._variable), + '{}.{{{}_key}}'.format(self._variable_name, self._variable), + ) + else: + with self.l('if {variable}_keys:'): + self.exc('{name} must not contain "+str({variable}_keys)+" properties', rule='additionalProperties') + + def generate_dependencies(self): + """ + Means when object has property, it needs to have also other property. + + .. code-block:: python + + { + 'dependencies': { + 'bar': ['foo'], + }, + } + + Valid object is containing only foo, both bar and foo or none of them, but not + object with only bar. + + Since draft 06 definition can be boolean or empty array. True and empty array + means nothing, False means that key cannot be there at all. + """ + self.create_variable_is_dict() + with self.l('if {variable}_is_dict:'): + is_empty = True + for key, values in self._definition["dependencies"].items(): + if values == [] or values is True: + continue + is_empty = False + with self.l('if "{}" in {variable}:', self.e(key)): + if values is False: + self.exc('{} in {name} must not be there', key, rule='dependencies') + elif isinstance(values, list): + for value in values: + with self.l('if "{}" not in {variable}:', self.e(value)): + self.exc('{name} missing dependency {} for {}', self.e(value), self.e(key), rule='dependencies') + else: + self.generate_func_code_block(values, self._variable, self._variable_name, clear_variables=True) + if is_empty: + self.l('pass') diff --git a/env/lib/python3.12/site-packages/fastjsonschema/draft06.py b/env/lib/python3.12/site-packages/fastjsonschema/draft06.py new file mode 100644 index 0000000..07f1e04 --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema/draft06.py @@ -0,0 +1,188 @@ +import decimal +from .draft04 import CodeGeneratorDraft04, JSON_TYPE_TO_PYTHON_TYPE +from .exceptions import JsonSchemaDefinitionException +from .generator import enforce_list + + +class CodeGeneratorDraft06(CodeGeneratorDraft04): + FORMAT_REGEXS = dict(CodeGeneratorDraft04.FORMAT_REGEXS, **{ + 'json-pointer': r'^(/(([^/~])|(~[01]))*)*\Z', + 'uri-reference': r'^(\w+:(\/?\/?))?[^#\\\s]*(#[^\\\s]*)?\Z', + 'uri-template': ( + r'^(?:(?:[^\x00-\x20\"\'<>%\\^`{|}]|%[0-9a-f]{2})|' + r'\{[+#./;?&=,!@|]?(?:[a-z0-9_]|%[0-9a-f]{2})+' + r'(?::[1-9][0-9]{0,3}|\*)?(?:,(?:[a-z0-9_]|%[0-9a-f]{2})+' + r'(?::[1-9][0-9]{0,3}|\*)?)*\})*\Z' + ), + }) + + def __init__(self, definition, resolver=None, formats={}, use_default=True, use_formats=True, detailed_exceptions=True): + super().__init__(definition, resolver, formats, use_default, use_formats, detailed_exceptions) + self._json_keywords_to_function.update(( + ('exclusiveMinimum', self.generate_exclusive_minimum), + ('exclusiveMaximum', self.generate_exclusive_maximum), + ('propertyNames', self.generate_property_names), + ('contains', self.generate_contains), + ('const', self.generate_const), + )) + + def _generate_func_code_block(self, definition): + if isinstance(definition, bool): + self.generate_boolean_schema() + elif '$ref' in definition: + # needed because ref overrides any sibling keywords + self.generate_ref() + else: + self.run_generate_functions(definition) + + def generate_boolean_schema(self): + """ + Means that schema can be specified by boolean. + True means everything is valid, False everything is invalid. + """ + if self._definition is True: + self.l('pass') + if self._definition is False: + self.exc('{name} must not be there') + + def generate_type(self): + """ + Validation of type. Can be one type or list of types. + + Since draft 06 a float without fractional part is an integer. + + .. code-block:: python + + {'type': 'string'} + {'type': ['string', 'number']} + """ + types = enforce_list(self._definition['type']) + try: + python_types = ', '.join(JSON_TYPE_TO_PYTHON_TYPE[t] for t in types) + except KeyError as exc: + raise JsonSchemaDefinitionException('Unknown type: {}'.format(exc)) + + extra = '' + + if 'integer' in types: + extra += ' and not (isinstance({variable}, float) and {variable}.is_integer())'.format( + variable=self._variable, + ) + + if ('number' in types or 'integer' in types) and 'boolean' not in types: + extra += ' or isinstance({variable}, bool)'.format(variable=self._variable) + + with self.l('if not isinstance({variable}, ({})){}:', python_types, extra): + self.exc('{name} must be {}', ' or '.join(types), rule='type') + + def generate_exclusive_minimum(self): + with self.l('if isinstance({variable}, (int, float, Decimal)):'): + if not isinstance(self._definition['exclusiveMinimum'], (int, float, decimal.Decimal)): + raise JsonSchemaDefinitionException('exclusiveMinimum must be an integer, a float or a decimal') + with self.l('if {variable} <= {exclusiveMinimum}:'): + self.exc('{name} must be bigger than {exclusiveMinimum}', rule='exclusiveMinimum') + + def generate_exclusive_maximum(self): + with self.l('if isinstance({variable}, (int, float, Decimal)):'): + if not isinstance(self._definition['exclusiveMaximum'], (int, float, decimal.Decimal)): + raise JsonSchemaDefinitionException('exclusiveMaximum must be an integer, a float or a decimal') + with self.l('if {variable} >= {exclusiveMaximum}:'): + self.exc('{name} must be smaller than {exclusiveMaximum}', rule='exclusiveMaximum') + + def generate_property_names(self): + """ + Means that keys of object must to follow this definition. + + .. code-block:: python + + { + 'propertyNames': { + 'maxLength': 3, + }, + } + + Valid keys of object for this definition are foo, bar, ... but not foobar for example. + """ + property_names_definition = self._definition.get('propertyNames', {}) + if property_names_definition is True: + pass + elif property_names_definition is False: + self.create_variable_keys() + with self.l('if {variable}_keys:'): + self.exc('{name} must not be there', rule='propertyNames') + else: + self.create_variable_is_dict() + with self.l('if {variable}_is_dict:'): + self.create_variable_with_length() + with self.l('if {variable}_len != 0:'): + self.l('{variable}_property_names = True') + with self.l('for {variable}_key in {variable}:'): + with self.l('try:'): + self.generate_func_code_block( + property_names_definition, + '{}_key'.format(self._variable), + self._variable_name, + clear_variables=True, + ) + with self.l('except JsonSchemaValueException:'): + self.l('{variable}_property_names = False') + with self.l('if not {variable}_property_names:'): + self.exc('{name} must be named by propertyName definition', rule='propertyNames') + + def generate_contains(self): + """ + Means that array must contain at least one defined item. + + .. code-block:: python + + { + 'contains': { + 'type': 'number', + }, + } + + Valid array is any with at least one number. + """ + self.create_variable_is_list() + with self.l('if {variable}_is_list:'): + contains_definition = self._definition['contains'] + + if contains_definition is False: + self.exc('{name} is always invalid', rule='contains') + elif contains_definition is True: + with self.l('if not {variable}:'): + self.exc('{name} must not be empty', rule='contains') + else: + self.l('{variable}_contains = False') + with self.l('for {variable}_key in {variable}:'): + with self.l('try:'): + self.generate_func_code_block( + contains_definition, + '{}_key'.format(self._variable), + self._variable_name, + clear_variables=True, + ) + self.l('{variable}_contains = True') + self.l('break') + self.l('except JsonSchemaValueException: pass') + + with self.l('if not {variable}_contains:'): + self.exc('{name} must contain one of contains definition', rule='contains') + + def generate_const(self): + """ + Means that value is valid when is equeal to const definition. + + .. code-block:: python + + { + 'const': 42, + } + + Only valid value is 42 in this example. + """ + const = self._definition['const'] + if isinstance(const, str): + const = '"{}"'.format(self.e(const)) + with self.l('if {variable} != {}:', const): + self.exc('{name} must be same as const definition: {definition_rule}', rule='const') diff --git a/env/lib/python3.12/site-packages/fastjsonschema/draft07.py b/env/lib/python3.12/site-packages/fastjsonschema/draft07.py new file mode 100644 index 0000000..227525e --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema/draft07.py @@ -0,0 +1,116 @@ +from .draft06 import CodeGeneratorDraft06 + + +class CodeGeneratorDraft07(CodeGeneratorDraft06): + FORMAT_REGEXS = dict(CodeGeneratorDraft06.FORMAT_REGEXS, **{ + 'date': r'^(?P\d{4})-(?P(0[1-9]|1[0-2]))-(?P(0[1-9]|[12]\d|3[01]))\Z', + 'iri': r'^\w+:(\/?\/?)[^\s]+\Z', + 'iri-reference': r'^(\w+:(\/?\/?))?[^#\\\s]*(#[^\\\s]*)?\Z', + 'idn-email': r'^[^@]+@[^@]+\.[^@]+\Z', + 'idn-hostname': r'^(?!-)(xn--)?[a-zA-Z0-9][a-zA-Z0-9-_]{0,61}[a-zA-Z0-9]{0,1}\.(?!-)(xn--)?([a-zA-Z0-9\-]{1,50}|[a-zA-Z0-9-]{1,30}\.[a-zA-Z]{2,})$', + 'relative-json-pointer': r'^(?:0|[1-9][0-9]*)(?:#|(?:\/(?:[^~/]|~0|~1)*)*)\Z', + #'regex': r'', + 'time': ( + r'^(?P\d{1,2}):(?P\d{1,2})' + r'(?::(?P\d{1,2})(?:\.(?P\d{1,6}))?' + r'([zZ]|[+-]\d\d:\d\d)?)?\Z' + ), + }) + + def __init__(self, definition, resolver=None, formats={}, use_default=True, use_formats=True, detailed_exceptions=True): + super().__init__(definition, resolver, formats, use_default, use_formats, detailed_exceptions) + # pylint: disable=duplicate-code + self._json_keywords_to_function.update(( + ('if', self.generate_if_then_else), + ('contentEncoding', self.generate_content_encoding), + ('contentMediaType', self.generate_content_media_type), + )) + + def generate_if_then_else(self): + """ + Implementation of if-then-else. + + .. code-block:: python + + { + 'if': { + 'exclusiveMaximum': 0, + }, + 'then': { + 'minimum': -10, + }, + 'else': { + 'multipleOf': 2, + }, + } + + Valid values are any between -10 and 0 or any multiplication of two. + """ + with self.l('try:', optimize=False): + self.generate_func_code_block( + self._definition['if'], + self._variable, + self._variable_name, + clear_variables=True + ) + with self.l('except JsonSchemaValueException:'): + if 'else' in self._definition: + self.generate_func_code_block( + self._definition['else'], + self._variable, + self._variable_name, + clear_variables=True + ) + else: + self.l('pass') + if 'then' in self._definition: + with self.l('else:'): + self.generate_func_code_block( + self._definition['then'], + self._variable, + self._variable_name, + clear_variables=True + ) + + def generate_content_encoding(self): + """ + Means decoding value when it's encoded by base64. + + .. code-block:: python + + { + 'contentEncoding': 'base64', + } + """ + if self._definition['contentEncoding'] == 'base64': + with self.l('if isinstance({variable}, str):'): + with self.l('try:'): + self.l('import base64') + self.l('{variable} = base64.b64decode({variable})') + with self.l('except Exception:'): + self.exc('{name} must be encoded by base64') + with self.l('if {variable} == "":'): + self.exc('contentEncoding must be base64') + + def generate_content_media_type(self): + """ + Means loading value when it's specified as JSON. + + .. code-block:: python + + { + 'contentMediaType': 'application/json', + } + """ + if self._definition['contentMediaType'] == 'application/json': + with self.l('if isinstance({variable}, bytes):'): + with self.l('try:'): + self.l('{variable} = {variable}.decode("utf-8")') + with self.l('except Exception:'): + self.exc('{name} must encoded by utf8') + with self.l('if isinstance({variable}, str):'): + with self.l('try:'): + self.l('import json') + self.l('{variable} = json.loads({variable})') + with self.l('except Exception:'): + self.exc('{name} must be valid JSON') diff --git a/env/lib/python3.12/site-packages/fastjsonschema/exceptions.py b/env/lib/python3.12/site-packages/fastjsonschema/exceptions.py new file mode 100644 index 0000000..d2dddd6 --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema/exceptions.py @@ -0,0 +1,51 @@ +import re + + +SPLIT_RE = re.compile(r'[\.\[\]]+') + + +class JsonSchemaException(ValueError): + """ + Base exception of ``fastjsonschema`` library. + """ + + +class JsonSchemaValueException(JsonSchemaException): + """ + Exception raised by validation function. Available properties: + + * ``message`` containing human-readable information what is wrong (e.g. ``data.property[index] must be smaller than or equal to 42``), + * invalid ``value`` (e.g. ``60``), + * ``name`` of a path in the data structure (e.g. ``data.property[index]``), + * ``path`` as an array in the data structure (e.g. ``['data', 'property', 'index']``), + * the whole ``definition`` which the ``value`` has to fulfil (e.g. ``{'type': 'number', 'maximum': 42}``), + * ``rule`` which the ``value`` is breaking (e.g. ``maximum``) + * and ``rule_definition`` (e.g. ``42``). + + .. versionchanged:: 2.14.0 + Added all extra properties. + """ + + def __init__(self, message, value=None, name=None, definition=None, rule=None): + super().__init__(message) + self.message = message + self.value = value + self.name = name + self.definition = definition + self.rule = rule + + @property + def path(self): + return [item for item in SPLIT_RE.split(self.name) if item != ''] + + @property + def rule_definition(self): + if not self.rule or not self.definition: + return None + return self.definition.get(self.rule) + + +class JsonSchemaDefinitionException(JsonSchemaException): + """ + Exception raised by generator of validation function. + """ diff --git a/env/lib/python3.12/site-packages/fastjsonschema/generator.py b/env/lib/python3.12/site-packages/fastjsonschema/generator.py new file mode 100644 index 0000000..64092f7 --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema/generator.py @@ -0,0 +1,353 @@ +from collections import OrderedDict +from decimal import Decimal +import re + +from .exceptions import JsonSchemaValueException, JsonSchemaDefinitionException +from .indent import indent +from .ref_resolver import RefResolver + + +def enforce_list(variable): + if isinstance(variable, list): + return variable + return [variable] + + +# pylint: disable=too-many-instance-attributes,too-many-public-methods +class CodeGenerator: + """ + This class is not supposed to be used directly. Anything + inside of this class can be changed without noticing. + + This class generates code of validation function from JSON + schema object as string. Example: + + .. code-block:: python + + CodeGenerator(json_schema_definition).func_code + """ + + INDENT = 4 # spaces + + def __init__(self, definition, resolver=None, detailed_exceptions=True): + self._code = [] + self._compile_regexps = {} + self._custom_formats = {} + self._detailed_exceptions = detailed_exceptions + + # Any extra library should be here to be imported only once. + # Lines are imports to be printed in the file and objects + # key-value pair to pass to compile function directly. + self._extra_imports_lines = [ + "from decimal import Decimal", + ] + self._extra_imports_objects = { + "Decimal": Decimal, + } + + self._variables = set() + self._indent = 0 + self._indent_last_line = None + self._variable = None + self._variable_name = None + self._root_definition = definition + self._definition = None + + # map schema URIs to validation function names for functions + # that are not yet generated, but need to be generated + self._needed_validation_functions = {} + # validation function names that are already done + self._validation_functions_done = set() + + if resolver is None: + resolver = RefResolver.from_schema(definition, store={}) + self._resolver = resolver + + # add main function to `self._needed_validation_functions` + self._needed_validation_functions[self._resolver.get_uri()] = self._resolver.get_scope_name() + + self._json_keywords_to_function = OrderedDict() + + @property + def func_code(self): + """ + Returns generated code of whole validation function as string. + """ + self._generate_func_code() + + return '\n'.join(self._code) + + @property + def global_state(self): + """ + Returns global variables for generating function from ``func_code``. Includes + compiled regular expressions and imports, so it does not have to do it every + time when validation function is called. + """ + self._generate_func_code() + + return dict( + **self._extra_imports_objects, + REGEX_PATTERNS=self._compile_regexps, + re=re, + JsonSchemaValueException=JsonSchemaValueException, + ) + + @property + def global_state_code(self): + """ + Returns global variables for generating function from ``func_code`` as code. + Includes compiled regular expressions and imports. + """ + self._generate_func_code() + + if not self._compile_regexps: + return '\n'.join(self._extra_imports_lines + [ + 'from fastjsonschema import JsonSchemaValueException', + '', + '', + ]) + return '\n'.join(self._extra_imports_lines + [ + 'import re', + 'from fastjsonschema import JsonSchemaValueException', + '', + '', + 'REGEX_PATTERNS = ' + serialize_regexes(self._compile_regexps), + '', + ]) + + + def _generate_func_code(self): + if not self._code: + self.generate_func_code() + + def generate_func_code(self): + """ + Creates base code of validation function and calls helper + for creating code by definition. + """ + self.l('NoneType = type(None)') + # Generate parts that are referenced and not yet generated + while self._needed_validation_functions: + # During generation of validation function, could be needed to generate + # new one that is added again to `_needed_validation_functions`. + # Therefore usage of while instead of for loop. + uri, name = self._needed_validation_functions.popitem() + self.generate_validation_function(uri, name) + + def generate_validation_function(self, uri, name): + """ + Generate validation function for given uri with given name + """ + self._validation_functions_done.add(uri) + self.l('') + with self._resolver.resolving(uri) as definition: + with self.l('def {}(data, custom_formats={{}}, name_prefix=None):', name): + self.generate_func_code_block(definition, 'data', 'data', clear_variables=True) + self.l('return data') + + def generate_func_code_block(self, definition, variable, variable_name, clear_variables=False): + """ + Creates validation rules for current definition. + + Returns the number of validation rules generated as code. + """ + backup = self._definition, self._variable, self._variable_name + self._definition, self._variable, self._variable_name = definition, variable, variable_name + if clear_variables: + backup_variables = self._variables + self._variables = set() + + count = self._generate_func_code_block(definition) + + self._definition, self._variable, self._variable_name = backup + if clear_variables: + self._variables = backup_variables + + return count + + def _generate_func_code_block(self, definition): + if not isinstance(definition, dict): + raise JsonSchemaDefinitionException("definition must be an object") + if '$ref' in definition: + # needed because ref overrides any sibling keywords + return self.generate_ref() + else: + return self.run_generate_functions(definition) + + def run_generate_functions(self, definition): + """Returns the number of generate functions that were executed.""" + count = 0 + for key, func in self._json_keywords_to_function.items(): + if key in definition: + func() + count += 1 + return count + + def generate_ref(self): + """ + Ref can be link to remote or local definition. + + .. code-block:: python + + {'$ref': 'http://json-schema.org/draft-04/schema#'} + { + 'properties': { + 'foo': {'type': 'integer'}, + 'bar': {'$ref': '#/properties/foo'} + } + } + """ + with self._resolver.in_scope(self._definition['$ref']): + name = self._resolver.get_scope_name() + uri = self._resolver.get_uri() + if uri not in self._validation_functions_done: + self._needed_validation_functions[uri] = name + # call validation function + assert self._variable_name.startswith("data") + path = self._variable_name[4:] + name_arg = '(name_prefix or "data") + "{}"'.format(path) + if '{' in name_arg: + name_arg = name_arg + '.format(**locals())' + self.l('{}({variable}, custom_formats, {name_arg})', name, name_arg=name_arg) + + + # pylint: disable=invalid-name + @indent + def l(self, line, *args, **kwds): + """ + Short-cut of line. Used for inserting line. It's formated with parameters + ``variable``, ``variable_name`` (as ``name`` for short-cut), all keys from + current JSON schema ``definition`` and also passed arguments in ``args`` + and named ``kwds``. + + .. code-block:: python + + self.l('if {variable} not in {enum}: raise JsonSchemaValueException("Wrong!")') + + When you want to indent block, use it as context manager. For example: + + .. code-block:: python + + with self.l('if {variable} not in {enum}:'): + self.l('raise JsonSchemaValueException("Wrong!")') + """ + spaces = ' ' * self.INDENT * self._indent + + name = self._variable_name + if name: + # Add name_prefix to the name when it is being outputted. + assert name.startswith('data') + name = '" + (name_prefix or "data") + "' + name[4:] + if '{' in name: + name = name + '".format(**locals()) + "' + + context = dict( + self._definition if self._definition and self._definition is not True else {}, + variable=self._variable, + name=name, + **kwds + ) + line = line.format(*args, **context) + line = line.replace('\n', '\\n').replace('\r', '\\r') + self._code.append(spaces + line) + return line + + def e(self, string): + """ + Short-cut of escape. Used for inserting user values into a string message. + + .. code-block:: python + + self.l('raise JsonSchemaValueException("Variable: {}")', self.e(variable)) + """ + return str(string).replace('"', '\\"') + + def exc(self, msg, *args, append_to_msg=None, rule=None): + """ + Short-cut for creating raising exception in the code. + """ + if not self._detailed_exceptions: + self.l('raise JsonSchemaValueException("'+msg+'")', *args) + return + + arg = '"'+msg+'"' + if append_to_msg: + arg += ' + (' + append_to_msg + ')' + msg = 'raise JsonSchemaValueException('+arg+', value={variable}, name="{name}", definition={definition}, rule={rule})' + definition = self._expand_refs(self._definition) + definition_rule = self.e(definition.get(rule) if isinstance(definition, dict) else None) + self.l(msg, *args, definition=repr(definition), rule=repr(rule), definition_rule=definition_rule) + + def _expand_refs(self, definition): + if isinstance(definition, list): + return [self._expand_refs(v) for v in definition] + if not isinstance(definition, dict): + return definition + if "$ref" in definition and isinstance(definition["$ref"], str): + with self._resolver.resolving(definition["$ref"]) as schema: + return schema + return {k: self._expand_refs(v) for k, v in definition.items()} + + def create_variable_with_length(self): + """ + Append code for creating variable with length of that variable + (for example length of list or dictionary) with name ``{variable}_len``. + It can be called several times and always it's done only when that variable + still does not exists. + """ + variable_name = '{}_len'.format(self._variable) + if variable_name in self._variables: + return + self._variables.add(variable_name) + self.l('{variable}_len = len({variable})') + + def create_variable_keys(self): + """ + Append code for creating variable with keys of that variable (dictionary) + with a name ``{variable}_keys``. Similar to `create_variable_with_length`. + """ + variable_name = '{}_keys'.format(self._variable) + if variable_name in self._variables: + return + self._variables.add(variable_name) + self.l('{variable}_keys = set({variable}.keys())') + + def create_variable_is_list(self): + """ + Append code for creating variable with bool if it's instance of list + with a name ``{variable}_is_list``. Similar to `create_variable_with_length`. + """ + variable_name = '{}_is_list'.format(self._variable) + if variable_name in self._variables: + return + self._variables.add(variable_name) + self.l('{variable}_is_list = isinstance({variable}, (list, tuple))') + + def create_variable_is_dict(self): + """ + Append code for creating variable with bool if it's instance of list + with a name ``{variable}_is_dict``. Similar to `create_variable_with_length`. + """ + variable_name = '{}_is_dict'.format(self._variable) + if variable_name in self._variables: + return + self._variables.add(variable_name) + self.l('{variable}_is_dict = isinstance({variable}, dict)') + + +def serialize_regexes(patterns_dict): + # Unfortunately using `pprint.pformat` is causing errors + # specially with big regexes + regex_patterns = ( + repr(k) + ": " + repr_regex(v) + for k, v in patterns_dict.items() + ) + return '{\n ' + ",\n ".join(regex_patterns) + "\n}" + + +def repr_regex(regex): + all_flags = ("A", "I", "DEBUG", "L", "M", "S", "X") + flags = " | ".join(f"re.{f}" for f in all_flags if regex.flags & getattr(re, f)) + flags = ", " + flags if flags else "" + return "re.compile({!r}{})".format(regex.pattern, flags) diff --git a/env/lib/python3.12/site-packages/fastjsonschema/indent.py b/env/lib/python3.12/site-packages/fastjsonschema/indent.py new file mode 100644 index 0000000..411c69f --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema/indent.py @@ -0,0 +1,28 @@ +def indent(func): + """ + Decorator for allowing to use method as normal method or with + context manager for auto-indenting code blocks. + """ + def wrapper(self, line, *args, optimize=True, **kwds): + last_line = self._indent_last_line + line = func(self, line, *args, **kwds) + # When two blocks have the same condition (such as value has to be dict), + # do the check only once and keep it under one block. + if optimize and last_line == line: + self._code.pop() + self._indent_last_line = line + return Indent(self, line) + return wrapper + + +class Indent: + def __init__(self, instance, line): + self.instance = instance + self.line = line + + def __enter__(self): + self.instance._indent += 1 + + def __exit__(self, type_, value, traceback): + self.instance._indent -= 1 + self.instance._indent_last_line = self.line diff --git a/env/lib/python3.12/site-packages/fastjsonschema/ref_resolver.py b/env/lib/python3.12/site-packages/fastjsonschema/ref_resolver.py new file mode 100644 index 0000000..4319302 --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema/ref_resolver.py @@ -0,0 +1,178 @@ +""" +JSON Schema URI resolution scopes and dereferencing + +https://tools.ietf.org/id/draft-zyp-json-schema-04.html#rfc.section.7 + +Code adapted from https://github.com/Julian/jsonschema +""" + +import contextlib +import json +import re +from urllib import parse as urlparse +from urllib.parse import unquote + +from .exceptions import JsonSchemaDefinitionException + + +def get_id(schema): + """ + Originally ID was `id` and since v7 it's `$id`. + """ + return schema.get('$id', schema.get('id', '')) + + +def resolve_path(schema, fragment): + """ + Return definition from path. + + Path is unescaped according https://tools.ietf.org/html/rfc6901 + """ + fragment = fragment.lstrip('/') + parts = unquote(fragment).split('/') if fragment else [] + for part in parts: + part = part.replace('~1', '/').replace('~0', '~') + if isinstance(schema, list): + schema = schema[int(part)] + elif part in schema: + schema = schema[part] + else: + raise JsonSchemaDefinitionException('Unresolvable ref: {}'.format(part)) + return schema + + +def normalize(uri): + return urlparse.urlsplit(uri).geturl() + + +def resolve_remote(uri, handlers): + """ + Resolve a remote ``uri``. + + .. note:: + + urllib library is used to fetch requests from the remote ``uri`` + if handlers does notdefine otherwise. + """ + scheme = urlparse.urlsplit(uri).scheme + if scheme in handlers: + result = handlers[scheme](uri) + else: + from urllib.request import urlopen + + req = urlopen(uri) + encoding = req.info().get_content_charset() or 'utf-8' + try: + result = json.loads(req.read().decode(encoding),) + except ValueError as exc: + raise JsonSchemaDefinitionException('{} failed to decode: {}'.format(uri, exc)) + finally: + req.close() + return result + + +class RefResolver: + """ + Resolve JSON References. + """ + + # pylint: disable=dangerous-default-value,too-many-arguments + def __init__(self, base_uri, schema, store={}, cache=True, handlers={}): + """ + `base_uri` is URI of the referring document from the `schema`. + `store` is an dictionary that will be used to cache the fetched schemas + (if `cache=True`). + + Please notice that you can have caching problems when compiling schemas + with colliding `$ref`. To force overwriting use `cache=False` or + explicitly pass the `store` argument (with a brand new dictionary) + """ + self.base_uri = base_uri + self.resolution_scope = base_uri + self.schema = schema + self.store = store + self.cache = cache + self.handlers = handlers + self.walk(schema) + + @classmethod + def from_schema(cls, schema, handlers={}, **kwargs): + """ + Construct a resolver from a JSON schema object. + """ + return cls( + get_id(schema) if isinstance(schema, dict) else '', + schema, + handlers=handlers, + **kwargs + ) + + @contextlib.contextmanager + def in_scope(self, scope: str): + """ + Context manager to handle current scope. + """ + old_scope = self.resolution_scope + self.resolution_scope = urlparse.urljoin(old_scope, scope) + try: + yield + finally: + self.resolution_scope = old_scope + + @contextlib.contextmanager + def resolving(self, ref: str): + """ + Context manager which resolves a JSON ``ref`` and enters the + resolution scope of this ref. + """ + new_uri = urlparse.urljoin(self.resolution_scope, ref) + uri, fragment = urlparse.urldefrag(new_uri) + + if uri and normalize(uri) in self.store: + schema = self.store[normalize(uri)] + elif not uri or uri == self.base_uri: + schema = self.schema + else: + schema = resolve_remote(uri, self.handlers) + if self.cache: + self.store[normalize(uri)] = schema + + old_base_uri, old_schema = self.base_uri, self.schema + self.base_uri, self.schema = uri, schema + try: + with self.in_scope(uri): + yield resolve_path(schema, fragment) + finally: + self.base_uri, self.schema = old_base_uri, old_schema + + def get_uri(self): + return normalize(self.resolution_scope) + + def get_scope_name(self): + """ + Get current scope and return it as a valid function name. + """ + name = 'validate_' + unquote(self.resolution_scope).replace('~1', '_').replace('~0', '_').replace('"', '') + name = re.sub(r'($[^a-zA-Z]|[^a-zA-Z0-9])', '_', name) + name = name.lower().rstrip('_') + return name + + def walk(self, node: dict): + """ + Walk thru schema and dereferencing ``id`` and ``$ref`` instances + """ + if isinstance(node, bool): + pass + elif '$ref' in node and isinstance(node['$ref'], str): + ref = node['$ref'] + node['$ref'] = urlparse.urljoin(self.resolution_scope, ref) + elif ('$id' in node or 'id' in node) and isinstance(get_id(node), str): + with self.in_scope(get_id(node)): + self.store[normalize(self.resolution_scope)] = node + for _, item in node.items(): + if isinstance(item, dict): + self.walk(item) + else: + for _, item in node.items(): + if isinstance(item, dict): + self.walk(item) diff --git a/env/lib/python3.12/site-packages/fastjsonschema/version.py b/env/lib/python3.12/site-packages/fastjsonschema/version.py new file mode 100644 index 0000000..47bed89 --- /dev/null +++ b/env/lib/python3.12/site-packages/fastjsonschema/version.py @@ -0,0 +1 @@ +VERSION = '2.21.2' diff --git a/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/INSTALLER b/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/METADATA b/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/METADATA new file mode 100644 index 0000000..30d6653 --- /dev/null +++ b/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/METADATA @@ -0,0 +1,672 @@ +Metadata-Version: 2.4 +Name: frozenlist +Version: 1.8.0 +Summary: A list-like structure which implements collections.abc.MutableSequence +Home-page: https://github.com/aio-libs/frozenlist +Maintainer: aiohttp team +Maintainer-email: team@aiohttp.org +License: Apache-2.0 +Project-URL: Chat: Matrix, https://matrix.to/#/#aio-libs:matrix.org +Project-URL: Chat: Matrix Space, https://matrix.to/#/#aio-libs-space:matrix.org +Project-URL: CI: Github Actions, https://github.com/aio-libs/frozenlist/actions +Project-URL: Code of Conduct, https://github.com/aio-libs/.github/blob/master/CODE_OF_CONDUCT.md +Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/frozenlist +Project-URL: Docs: Changelog, https://github.com/aio-libs/frozenlist/blob/master/CHANGES.rst#changelog +Project-URL: Docs: RTD, https://frozenlist.aio-libs.org +Project-URL: GitHub: issues, https://github.com/aio-libs/frozenlist/issues +Project-URL: GitHub: repo, https://github.com/aio-libs/frozenlist +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: Operating System :: POSIX +Classifier: Operating System :: MacOS :: MacOS X +Classifier: Operating System :: Microsoft :: Windows +Classifier: Programming Language :: Cython +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Programming Language :: Python :: 3.14 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Requires-Python: >=3.9 +Description-Content-Type: text/x-rst +License-File: LICENSE +Dynamic: license-file + +frozenlist +========== + +.. image:: https://github.com/aio-libs/frozenlist/workflows/CI/badge.svg + :target: https://github.com/aio-libs/frozenlist/actions + :alt: GitHub status for master branch + +.. image:: https://codecov.io/gh/aio-libs/frozenlist/branch/master/graph/badge.svg?flag=pytest + :target: https://codecov.io/gh/aio-libs/frozenlist?flags[]=pytest + :alt: codecov.io status for master branch + +.. image:: https://img.shields.io/pypi/v/frozenlist.svg?logo=Python&logoColor=white + :target: https://pypi.org/project/frozenlist + :alt: frozenlist @ PyPI + +.. image:: https://readthedocs.org/projects/frozenlist/badge/?version=latest + :target: https://frozenlist.aio-libs.org + :alt: Read The Docs build status badge + +.. image:: https://img.shields.io/matrix/aio-libs:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat + :target: https://matrix.to/#/%23aio-libs:matrix.org + :alt: Matrix Room — #aio-libs:matrix.org + +.. image:: https://img.shields.io/matrix/aio-libs-space:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs-space%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat + :target: https://matrix.to/#/%23aio-libs-space:matrix.org + :alt: Matrix Space — #aio-libs-space:matrix.org + +Introduction +------------ + +``frozenlist.FrozenList`` is a list-like structure which implements +``collections.abc.MutableSequence``. The list is *mutable* until ``FrozenList.freeze`` +is called, after which list modifications raise ``RuntimeError``: + + +>>> from frozenlist import FrozenList +>>> fl = FrozenList([17, 42]) +>>> fl.append('spam') +>>> fl.append('Vikings') +>>> fl + +>>> fl.freeze() +>>> fl + +>>> fl.frozen +True +>>> fl.append("Monty") +Traceback (most recent call last): + File "", line 1, in + File "frozenlist/_frozenlist.pyx", line 97, in frozenlist._frozenlist.FrozenList.append + self._check_frozen() + File "frozenlist/_frozenlist.pyx", line 19, in frozenlist._frozenlist.FrozenList._check_frozen + raise RuntimeError("Cannot modify frozen list.") +RuntimeError: Cannot modify frozen list. + + +FrozenList is also hashable, but only when frozen. Otherwise it also throws a RuntimeError: + + +>>> fl = FrozenList([17, 42, 'spam']) +>>> hash(fl) +Traceback (most recent call last): + File "", line 1, in + File "frozenlist/_frozenlist.pyx", line 111, in frozenlist._frozenlist.FrozenList.__hash__ + raise RuntimeError("Cannot hash unfrozen list.") +RuntimeError: Cannot hash unfrozen list. +>>> fl.freeze() +>>> hash(fl) +3713081631934410656 +>>> dictionary = {fl: 'Vikings'} # frozen fl can be a dict key +>>> dictionary +{: 'Vikings'} + + +Installation +------------ + +:: + + $ pip install frozenlist + + +Documentation +------------- + +https://frozenlist.aio-libs.org + +Communication channels +---------------------- + +We have a *Matrix Space* `#aio-libs-space:matrix.org +`_ which is +also accessible via Gitter. + +License +------- + +``frozenlist`` is offered under the Apache 2 license. + +Source code +----------- + +The project is hosted on GitHub_ + +Please file an issue in the `bug tracker +`_ if you have found a bug +or have some suggestions to improve the library. + +.. _GitHub: https://github.com/aio-libs/frozenlist + +========= +Changelog +========= + +.. + You should *NOT* be adding new change log entries to this file, this + file is managed by towncrier. You *may* edit previous change logs to + fix problems like typo corrections or such. + To add a new change log entry, please see + https://pip.pypa.io/en/latest/development/contributing/#news-entries + we named the news folder "changes". + + WARNING: Don't drop the next directive! + +.. towncrier release notes start + +v1.8.0 +====== + +*(2025-10-05)* + + +Contributor-facing changes +-------------------------- + +- The ``reusable-cibuildwheel.yml`` workflow has been refactored to + be more generic and ``ci-cd.yml`` now holds all the configuration + toggles -- by `@webknjaz `__. + + *Related issues and pull requests on GitHub:* + `#668 `__. + +- When building wheels, the source distribution is now passed directly + to the ``cibuildwheel`` invocation -- by `@webknjaz `__. + + *Related issues and pull requests on GitHub:* + `#669 `__. + +- Builds and tests have been added to + ``ci-cd.yml`` for arm64 Windows wheels -- by `@finnagin `__. + + *Related issues and pull requests on GitHub:* + `#677 `__. + +- Started building wheels for CPython 3.14 -- by `@kumaraditya303 `__. + + *Related issues and pull requests on GitHub:* + `#681 `__, `#682 `__. + +- Removed ``--config-settings=pure-python=false`` from ``requirements/dev.txt``. + Developers on CPython still get accelerated builds by default. To explicitly build + a pure Python wheel, use ``pip install -e . --config-settings=pure-python=true`` + -- by `@bdraco `__. + + *Related issues and pull requests on GitHub:* + `#687 `__. + + +---- + + +v1.7.0 +====== + +*(2025-06-09)* + + +Features +-------- + +- Added deepcopy support to FrozenList -- by `@bdraco `__. + + *Related issues and pull requests on GitHub:* + `#659 `__. + + +Packaging updates and notes for downstreams +------------------------------------------- + +- Fixed an issue where ``frozenlist`` binary wheels would be built with debugging symbols and line tracing enabled, which significantly impacted performance. Line tracing is now disabled by default and can only be enabled explicitly -- by `@bdraco `__. + + This change ensures that production builds are optimized for performance. Developers who need line tracing for debugging purposes can still enable it by: + + 1. Setting the ``FROZENLIST_CYTHON_TRACING`` environment variable + 2. Using the ``--config-setting=with-cython-tracing=true`` option with pip + + *Related issues and pull requests on GitHub:* + `#660 `__. + +- Enabled ``PIP_CONSTRAINT`` environment variable in the build configuration to ensure the pinned Cython version from ``requirements/cython.txt`` is used during wheel builds. + + *Related issues and pull requests on GitHub:* + `#661 `__. + + +---- + + +v1.6.2 +====== + +*(2025-06-03)* + + +No significant changes. + + +---- + + +v1.6.1 +====== + +*(2025-06-02)* + + +Bug fixes +--------- + +- Correctly use ``cimport`` for including ``PyBool_FromLong`` -- by `@lysnikolaou `__. + + *Related issues and pull requests on GitHub:* + `#653 `__. + + +Packaging updates and notes for downstreams +------------------------------------------- + +- Exclude ``_frozenlist.cpp`` from bdists/wheels -- by `@musicinmybrain `__. + + *Related issues and pull requests on GitHub:* + `#649 `__. + +- Updated to use Cython 3.1 universally across the build path -- by `@lysnikolaou `__. + + *Related issues and pull requests on GitHub:* + `#654 `__. + + +---- + + +v1.6.0 +====== + +*(2025-04-17)* + + +Bug fixes +--------- + +- Stopped implicitly allowing the use of Cython pre-release versions when + building the distribution package -- by `@ajsanchezsanz `__ and + `@markgreene74 `__. + + *Related commits on GitHub:* + `41591f2 `__. + + +Features +-------- + +- Implemented support for the free-threaded build of CPython 3.13 -- by `@lysnikolaou `__. + + *Related issues and pull requests on GitHub:* + `#618 `__. + +- Started building armv7l wheels -- by `@bdraco `__. + + *Related issues and pull requests on GitHub:* + `#642 `__. + + +Packaging updates and notes for downstreams +------------------------------------------- + +- Stopped implicitly allowing the use of Cython pre-release versions when + building the distribution package -- by `@ajsanchezsanz `__ and + `@markgreene74 `__. + + *Related commits on GitHub:* + `41591f2 `__. + +- Started building wheels for the free-threaded build of CPython 3.13 -- by `@lysnikolaou `__. + + *Related issues and pull requests on GitHub:* + `#618 `__. + +- The packaging metadata switched to including an SPDX license identifier introduced in `PEP 639 `__ -- by `@cdce8p `__. + + *Related issues and pull requests on GitHub:* + `#639 `__. + + +Contributor-facing changes +-------------------------- + +- GitHub Actions CI/CD is now configured to manage caching pip-ecosystem + dependencies using `re-actors/cache-python-deps`_ -- an action by + `@webknjaz `__ that takes into account ABI stability and the exact + version of Python runtime. + + .. _`re-actors/cache-python-deps`: + https://github.com/marketplace/actions/cache-python-deps + + *Related issues and pull requests on GitHub:* + `#633 `__. + +- Organized dependencies into test and lint dependencies so that no + unnecessary ones are installed during CI runs -- by `@lysnikolaou `__. + + *Related issues and pull requests on GitHub:* + `#636 `__. + + +---- + + +1.5.0 (2024-10-22) +================== + +Bug fixes +--------- + +- An incorrect signature of the ``__class_getitem__`` class method + has been fixed, adding a missing ``class_item`` argument under + Python 3.8 and older. + + This change also improves the code coverage of this method that + was previously missing -- by `@webknjaz `__. + + + *Related issues and pull requests on GitHub:* + `#567 `__, `#571 `__. + + +Improved documentation +---------------------- + +- Rendered issue, PR, and commit links now lead to + ``frozenlist``'s repo instead of ``yarl``'s repo. + + + *Related issues and pull requests on GitHub:* + `#573 `__. + +- On the ``Contributing docs`` page, + a link to the ``Towncrier philosophy`` has been fixed. + + + *Related issues and pull requests on GitHub:* + `#574 `__. + + +Packaging updates and notes for downstreams +------------------------------------------- + +- A name of a temporary building directory now reflects + that it's related to ``frozenlist``, not ``yarl``. + + + *Related issues and pull requests on GitHub:* + `#573 `__. + +- Declared Python 3.13 supported officially in the distribution package metadata. + + + *Related issues and pull requests on GitHub:* + `#595 `__. + + +---- + + +1.4.1 (2023-12-15) +================== + +Packaging updates and notes for downstreams +------------------------------------------- + +- Declared Python 3.12 and PyPy 3.8-3.10 supported officially + in the distribution package metadata. + + + *Related issues and pull requests on GitHub:* + `#553 `__. + +- Replaced the packaging is replaced from an old-fashioned ``setup.py`` to an + in-tree `PEP 517 `__ build backend -- by `@webknjaz `__. + + Whenever the end-users or downstream packagers need to build ``frozenlist`` + from source (a Git checkout or an sdist), they may pass a ``config_settings`` + flag ``pure-python``. If this flag is not set, a C-extension will be built + and included into the distribution. + + Here is how this can be done with ``pip``: + + .. code-block:: console + + $ python3 -m pip install . --config-settings=pure-python= + + This will also work with ``-e | --editable``. + + The same can be achieved via ``pypa/build``: + + .. code-block:: console + + $ python3 -m build --config-setting=pure-python= + + Adding ``-w | --wheel`` can force ``pypa/build`` produce a wheel from source + directly, as opposed to building an ``sdist`` and then building from it. + + + *Related issues and pull requests on GitHub:* + `#560 `__. + + +Contributor-facing changes +-------------------------- + +- It is now possible to request line tracing in Cython builds using the + ``with-cython-tracing`` `PEP 517 `__ config setting + -- `@webknjaz `__. + + This can be used in CI and development environment to measure coverage + on Cython modules, but is not normally useful to the end-users or + downstream packagers. + + Here's a usage example: + + .. code-block:: console + + $ python3 -Im pip install . --config-settings=with-cython-tracing=true + + For editable installs, this setting is on by default. Otherwise, it's + off unless requested explicitly. + + The following produces C-files required for the Cython coverage + plugin to map the measurements back to the PYX-files: + + .. code-block:: console + + $ python -Im pip install -e . + + Alternatively, the ``FROZENLIST_CYTHON_TRACING=1`` environment variable + can be set to do the same as the `PEP 517 `__ config setting. + + + *Related issues and pull requests on GitHub:* + `#560 `__. + +- Coverage collection has been implemented for the Cython modules + -- by `@webknjaz `__. + + It will also be reported to Codecov from any non-release CI jobs. + + + *Related issues and pull requests on GitHub:* + `#561 `__. + +- A step-by-step ``Release Guide`` guide has + been added, describing how to release *frozenlist* -- by `@webknjaz `__. + + This is primarily targeting the maintainers. + + + *Related issues and pull requests on GitHub:* + `#563 `__. + +- Detailed ``Contributing Guidelines`` on + authoring the changelog fragments have been published in the + documentation -- by `@webknjaz `__. + + + *Related issues and pull requests on GitHub:* + `#564 `__. + + +---- + + +1.4.0 (2023-07-12) +================== + +The published source distribution package became buildable +under Python 3.12. + + +---- + + +Bugfixes +-------- + +- Removed an unused ``typing.Tuple`` import + `#411 `_ + + +Deprecations and Removals +------------------------- + +- Dropped Python 3.7 support. + `#413 `_ + + +Misc +---- + +- `#410 `_, `#433 `_ + + +---- + + +1.3.3 (2022-11-08) +================== + +- Fixed CI runs when creating a new release, where new towncrier versions + fail when the current version section is already present. + + +---- + + +1.3.2 (2022-11-08) +================== + +Misc +---- + +- Updated the CI runs to better check for test results and to avoid deprecated syntax. `#327 `_ + + +---- + + +1.3.1 (2022-08-02) +================== + +The published source distribution package became buildable +under Python 3.11. + + +---- + + +1.3.0 (2022-01-18) +================== + +Bugfixes +-------- + +- Do not install C sources with binary distributions. + `#250 `_ + + +Deprecations and Removals +------------------------- + +- Dropped Python 3.6 support + `#274 `_ + + +---- + + +1.2.0 (2021-10-16) +================== + +Features +-------- + +- ``FrozenList`` now supports being used as a generic type as per PEP 585, e.g. ``frozen_int_list: FrozenList[int]`` (requires Python 3.9 or newer). + `#172 `_ +- Added support for Python 3.10. + `#227 `_ +- Started shipping platform-specific wheels with the ``musl`` tag targeting typical Alpine Linux runtimes. + `#227 `_ +- Started shipping platform-specific arm64 wheels for Apple Silicon. + `#227 `_ + + +---- + + +1.1.1 (2020-11-14) +================== + +Bugfixes +-------- + +- Provide x86 Windows wheels. + `#169 `_ + + +---- + + +1.1.0 (2020-10-13) +================== + +Features +-------- + +- Add support for hashing of a frozen list. + `#136 `_ + +- Support Python 3.8 and 3.9. + +- Provide wheels for ``aarch64``, ``i686``, ``ppc64le``, ``s390x`` architectures on + Linux as well as ``x86_64``. + + +---- + + +1.0.0 (2019-11-09) +================== + +Deprecations and Removals +------------------------- + +- Dropped support for Python 3.5; only 3.6, 3.7 and 3.8 are supported going forward. + `#24 `_ diff --git a/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/RECORD b/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/RECORD new file mode 100644 index 0000000..cbde177 --- /dev/null +++ b/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/RECORD @@ -0,0 +1,12 @@ +frozenlist-1.8.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +frozenlist-1.8.0.dist-info/METADATA,sha256=lGwi3J9-LHby1pjwCkMG2-Sagg4rPxoOIv5ShsvsNfE,20333 +frozenlist-1.8.0.dist-info/RECORD,, +frozenlist-1.8.0.dist-info/WHEEL,sha256=AwHYJA1Do1jwgPIoLQR4DiHSeYY_vU6Ht9Vljq5Yt_M,112 +frozenlist-1.8.0.dist-info/licenses/LICENSE,sha256=b9UkPpLdf5jsacesN3co50kFcJ_1J6W_mNbQJjwE9bY,11332 +frozenlist-1.8.0.dist-info/top_level.txt,sha256=jivtxsPXA3nK3WBWW2LW5Mtu_GHt8UZA13NeCs2cKuA,11 +frozenlist/__init__.py,sha256=xAIE2u9ncAbjATGIPfno_OJfe8AQ-1h7z_uc73dYsEA,2108 +frozenlist/__init__.pyi,sha256=vMEoES1xGegPtVXoCi9XydEeHsyuIq-KdeXwP5PdsaA,1470 +frozenlist/__pycache__/__init__.cpython-312.pyc,, +frozenlist/_frozenlist.cpython-312-x86_64-linux-musl.so,sha256=RHxdWO-IFr30xSeTFrkRIp4R0fX8kK3B1DzNZuJJ5RQ,585104 +frozenlist/_frozenlist.pyx,sha256=t-aGjuEiVt_MZPBJ0RnraavVmPBK6arz3i48ZvXuYsU,3708 +frozenlist/py.typed,sha256=sow9soTwP9T_gEAQSVh7Gb8855h04Nwmhs2We-JRgZM,7 diff --git a/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/WHEEL b/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/WHEEL new file mode 100644 index 0000000..5b148ea --- /dev/null +++ b/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (80.9.0) +Root-Is-Purelib: false +Tag: cp312-cp312-musllinux_1_2_x86_64 + diff --git a/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/licenses/LICENSE b/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/licenses/LICENSE new file mode 100644 index 0000000..7082a2d --- /dev/null +++ b/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/licenses/LICENSE @@ -0,0 +1,201 @@ +Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2013-2019 Nikolay Kim and Andrew Svetlov + + 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. diff --git a/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/top_level.txt b/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/top_level.txt new file mode 100644 index 0000000..52f13fc --- /dev/null +++ b/env/lib/python3.12/site-packages/frozenlist-1.8.0.dist-info/top_level.txt @@ -0,0 +1 @@ +frozenlist diff --git a/env/lib/python3.12/site-packages/frozenlist/__init__.py b/env/lib/python3.12/site-packages/frozenlist/__init__.py new file mode 100644 index 0000000..41c8595 --- /dev/null +++ b/env/lib/python3.12/site-packages/frozenlist/__init__.py @@ -0,0 +1,86 @@ +import os +import types +from collections.abc import MutableSequence +from functools import total_ordering + +__version__ = "1.8.0" + +__all__ = ("FrozenList", "PyFrozenList") # type: Tuple[str, ...] + + +NO_EXTENSIONS = bool(os.environ.get("FROZENLIST_NO_EXTENSIONS")) # type: bool + + +@total_ordering +class FrozenList(MutableSequence): + __slots__ = ("_frozen", "_items") + __class_getitem__ = classmethod(types.GenericAlias) + + def __init__(self, items=None): + self._frozen = False + if items is not None: + items = list(items) + else: + items = [] + self._items = items + + @property + def frozen(self): + return self._frozen + + def freeze(self): + self._frozen = True + + def __getitem__(self, index): + return self._items[index] + + def __setitem__(self, index, value): + if self._frozen: + raise RuntimeError("Cannot modify frozen list.") + self._items[index] = value + + def __delitem__(self, index): + if self._frozen: + raise RuntimeError("Cannot modify frozen list.") + del self._items[index] + + def __len__(self): + return self._items.__len__() + + def __iter__(self): + return self._items.__iter__() + + def __reversed__(self): + return self._items.__reversed__() + + def __eq__(self, other): + return list(self) == other + + def __le__(self, other): + return list(self) <= other + + def insert(self, pos, item): + if self._frozen: + raise RuntimeError("Cannot modify frozen list.") + self._items.insert(pos, item) + + def __repr__(self): + return f"" + + def __hash__(self): + if self._frozen: + return hash(tuple(self)) + else: + raise RuntimeError("Cannot hash unfrozen list.") + + +PyFrozenList = FrozenList + + +if not NO_EXTENSIONS: + try: + from ._frozenlist import FrozenList as CFrozenList # type: ignore + except ImportError: # pragma: no cover + pass + else: + FrozenList = CFrozenList # type: ignore diff --git a/env/lib/python3.12/site-packages/frozenlist/__init__.pyi b/env/lib/python3.12/site-packages/frozenlist/__init__.pyi new file mode 100644 index 0000000..ae803ef --- /dev/null +++ b/env/lib/python3.12/site-packages/frozenlist/__init__.pyi @@ -0,0 +1,47 @@ +from typing import ( + Generic, + Iterable, + Iterator, + List, + MutableSequence, + Optional, + TypeVar, + Union, + overload, +) + +_T = TypeVar("_T") +_Arg = Union[List[_T], Iterable[_T]] + +class FrozenList(MutableSequence[_T], Generic[_T]): + def __init__(self, items: Optional[_Arg[_T]] = None) -> None: ... + @property + def frozen(self) -> bool: ... + def freeze(self) -> None: ... + @overload + def __getitem__(self, i: int) -> _T: ... + @overload + def __getitem__(self, s: slice) -> FrozenList[_T]: ... + @overload + def __setitem__(self, i: int, o: _T) -> None: ... + @overload + def __setitem__(self, s: slice, o: Iterable[_T]) -> None: ... + @overload + def __delitem__(self, i: int) -> None: ... + @overload + def __delitem__(self, i: slice) -> None: ... + def __len__(self) -> int: ... + def __iter__(self) -> Iterator[_T]: ... + def __reversed__(self) -> Iterator[_T]: ... + def __eq__(self, other: object) -> bool: ... + def __le__(self, other: FrozenList[_T]) -> bool: ... + def __ne__(self, other: object) -> bool: ... + def __lt__(self, other: FrozenList[_T]) -> bool: ... + def __ge__(self, other: FrozenList[_T]) -> bool: ... + def __gt__(self, other: FrozenList[_T]) -> bool: ... + def insert(self, pos: int, item: _T) -> None: ... + def __repr__(self) -> str: ... + def __hash__(self) -> int: ... + +# types for C accelerators are the same +CFrozenList = PyFrozenList = FrozenList diff --git a/env/lib/python3.12/site-packages/frozenlist/_frozenlist.cpython-312-x86_64-linux-musl.so b/env/lib/python3.12/site-packages/frozenlist/_frozenlist.cpython-312-x86_64-linux-musl.so new file mode 100755 index 0000000000000000000000000000000000000000..47255b8ba46a3670ac07fe04d128800c045792e7 GIT binary patch literal 585104 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 z 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 a@BLe9{rv2!OZ|`ZKU%Q;C`BQK4E;ZE{1tBi literal 0 HcmV?d00001 diff --git a/env/lib/python3.12/site-packages/multidict/_multidict_py.py b/env/lib/python3.12/site-packages/multidict/_multidict_py.py new file mode 100644 index 0000000..6b68d52 --- /dev/null +++ b/env/lib/python3.12/site-packages/multidict/_multidict_py.py @@ -0,0 +1,1242 @@ +import enum +import functools +import reprlib +import sys +from array import array +from collections.abc import ( + ItemsView, + Iterable, + Iterator, + KeysView, + Mapping, + ValuesView, +) +from dataclasses import dataclass +from typing import ( + TYPE_CHECKING, + Any, + ClassVar, + Generic, + NoReturn, + Optional, + TypeVar, + Union, + cast, + overload, +) + +from ._abc import MDArg, MultiMapping, MutableMultiMapping, SupportsKeys + +if sys.version_info >= (3, 11): + from typing import Self +else: + from typing_extensions import Self + + +class istr(str): + """Case insensitive str.""" + + __is_istr__ = True + __istr_identity__: Optional[str] = None + + +_V = TypeVar("_V") +_T = TypeVar("_T") + +_SENTINEL = enum.Enum("_SENTINEL", "sentinel") +sentinel = _SENTINEL.sentinel + +_version = array("Q", [0]) + + +class _Iter(Generic[_T]): + __slots__ = ("_size", "_iter") + + def __init__(self, size: int, iterator: Iterator[_T]): + self._size = size + self._iter = iterator + + def __iter__(self) -> Self: + return self + + def __next__(self) -> _T: + return next(self._iter) + + def __length_hint__(self) -> int: + return self._size + + +class _ViewBase(Generic[_V]): + def __init__( + self, + md: "MultiDict[_V]", + ): + self._md = md + + def __len__(self) -> int: + return len(self._md) + + +class _ItemsView(_ViewBase[_V], ItemsView[str, _V]): + def __contains__(self, item: object) -> bool: + if not isinstance(item, (tuple, list)) or len(item) != 2: + return False + key, value = item + try: + identity = self._md._identity(key) + except TypeError: + return False + hash_ = hash(identity) + for slot, idx, e in self._md._keys.iter_hash(hash_): + if e.identity == identity and value == e.value: + return True + return False + + def __iter__(self) -> _Iter[tuple[str, _V]]: + return _Iter(len(self), self._iter(self._md._version)) + + def _iter(self, version: int) -> Iterator[tuple[str, _V]]: + for e in self._md._keys.iter_entries(): + if version != self._md._version: + raise RuntimeError("Dictionary changed during iteration") + yield self._md._key(e.key), e.value + + @reprlib.recursive_repr() + def __repr__(self) -> str: + lst = [] + for e in self._md._keys.iter_entries(): + lst.append(f"'{e.key}': {e.value!r}") + body = ", ".join(lst) + return f"<{self.__class__.__name__}({body})>" + + def _parse_item( + self, arg: Union[tuple[str, _V], _T] + ) -> Optional[tuple[int, str, str, _V]]: + if not isinstance(arg, tuple): + return None + if len(arg) != 2: + return None + try: + identity = self._md._identity(arg[0]) + return (hash(identity), identity, arg[0], arg[1]) + except TypeError: + return None + + def _tmp_set(self, it: Iterable[_T]) -> set[tuple[str, _V]]: + tmp = set() + for arg in it: + item = self._parse_item(arg) + if item is None: + continue + else: + tmp.add((item[1], item[3])) + return tmp + + def __and__(self, other: Iterable[Any]) -> set[tuple[str, _V]]: + ret = set() + try: + it = iter(other) + except TypeError: + return NotImplemented + for arg in it: + item = self._parse_item(arg) + if item is None: + continue + hash_, identity, key, value = item + for slot, idx, e in self._md._keys.iter_hash(hash_): + e.hash = -1 + if e.identity == identity and e.value == value: + ret.add((e.key, e.value)) + self._md._keys.restore_hash(hash_) + return ret + + def __rand__(self, other: Iterable[_T]) -> set[_T]: + ret = set() + try: + it = iter(other) + except TypeError: + return NotImplemented + for arg in it: + item = self._parse_item(arg) + if item is None: + continue + hash_, identity, key, value = item + for slot, idx, e in self._md._keys.iter_hash(hash_): + if e.identity == identity and e.value == value: + ret.add(arg) + break + return ret + + def __or__(self, other: Iterable[_T]) -> set[Union[tuple[str, _V], _T]]: + ret: set[Union[tuple[str, _V], _T]] = set(self) + try: + it = iter(other) + except TypeError: + return NotImplemented + for arg in it: + item: Optional[tuple[int, str, str, _V]] = self._parse_item(arg) + if item is None: + ret.add(arg) + continue + hash_, identity, key, value = item + for slot, idx, e in self._md._keys.iter_hash(hash_): + if e.identity == identity and e.value == value: # pragma: no branch + break + else: + ret.add(arg) + return ret + + def __ror__(self, other: Iterable[_T]) -> set[Union[tuple[str, _V], _T]]: + try: + ret: set[Union[tuple[str, _V], _T]] = set(other) + except TypeError: + return NotImplemented + tmp = self._tmp_set(ret) + + for e in self._md._keys.iter_entries(): + if (e.identity, e.value) not in tmp: + ret.add((e.key, e.value)) + return ret + + def __sub__(self, other: Iterable[_T]) -> set[Union[tuple[str, _V], _T]]: + ret: set[Union[tuple[str, _V], _T]] = set() + try: + it = iter(other) + except TypeError: + return NotImplemented + tmp = self._tmp_set(it) + + for e in self._md._keys.iter_entries(): + if (e.identity, e.value) not in tmp: + ret.add((e.key, e.value)) + + return ret + + def __rsub__(self, other: Iterable[_T]) -> set[_T]: + ret: set[_T] = set() + try: + it = iter(other) + except TypeError: + return NotImplemented + for arg in it: + item = self._parse_item(arg) + if item is None: + ret.add(arg) + continue + + hash_, identity, key, value = item + for slot, idx, e in self._md._keys.iter_hash(hash_): + if e.identity == identity and e.value == value: # pragma: no branch + break + else: + ret.add(arg) + return ret + + def __xor__(self, other: Iterable[_T]) -> set[Union[tuple[str, _V], _T]]: + try: + rgt = set(other) + except TypeError: + return NotImplemented + ret: set[Union[tuple[str, _V], _T]] = self - rgt + ret |= rgt - self + return ret + + __rxor__ = __xor__ + + def isdisjoint(self, other: Iterable[tuple[str, _V]]) -> bool: + for arg in other: + item = self._parse_item(arg) + if item is None: + continue + + hash_, identity, key, value = item + for slot, idx, e in self._md._keys.iter_hash(hash_): + if e.identity == identity and e.value == value: # pragma: no branch + return False + return True + + +class _ValuesView(_ViewBase[_V], ValuesView[_V]): + def __contains__(self, value: object) -> bool: + for e in self._md._keys.iter_entries(): + if e.value == value: + return True + return False + + def __iter__(self) -> _Iter[_V]: + return _Iter(len(self), self._iter(self._md._version)) + + def _iter(self, version: int) -> Iterator[_V]: + for e in self._md._keys.iter_entries(): + if version != self._md._version: + raise RuntimeError("Dictionary changed during iteration") + yield e.value + + @reprlib.recursive_repr() + def __repr__(self) -> str: + lst = [] + for e in self._md._keys.iter_entries(): + lst.append(repr(e.value)) + body = ", ".join(lst) + return f"<{self.__class__.__name__}({body})>" + + +class _KeysView(_ViewBase[_V], KeysView[str]): + def __contains__(self, key: object) -> bool: + if not isinstance(key, str): + return False + identity = self._md._identity(key) + hash_ = hash(identity) + for slot, idx, e in self._md._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + return True + return False + + def __iter__(self) -> _Iter[str]: + return _Iter(len(self), self._iter(self._md._version)) + + def _iter(self, version: int) -> Iterator[str]: + for e in self._md._keys.iter_entries(): + if version != self._md._version: + raise RuntimeError("Dictionary changed during iteration") + yield self._md._key(e.key) + + def __repr__(self) -> str: + lst = [] + for e in self._md._keys.iter_entries(): + lst.append(f"'{e.key}'") + body = ", ".join(lst) + return f"<{self.__class__.__name__}({body})>" + + def __and__(self, other: Iterable[object]) -> set[str]: + ret = set() + try: + it = iter(other) + except TypeError: + return NotImplemented + for key in it: + if not isinstance(key, str): + continue + identity = self._md._identity(key) + hash_ = hash(identity) + for slot, idx, e in self._md._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + ret.add(e.key) + break + return ret + + def __rand__(self, other: Iterable[_T]) -> set[_T]: + ret = set() + try: + it = iter(other) + except TypeError: + return NotImplemented + for key in it: + if not isinstance(key, str): + continue + if key in self._md: + ret.add(key) + return cast(set[_T], ret) + + def __or__(self, other: Iterable[_T]) -> set[Union[str, _T]]: + ret: set[Union[str, _T]] = set(self) + try: + it = iter(other) + except TypeError: + return NotImplemented + for key in it: + if not isinstance(key, str): + ret.add(key) + continue + if key not in self._md: + ret.add(key) + return ret + + def __ror__(self, other: Iterable[_T]) -> set[Union[str, _T]]: + try: + ret: set[Union[str, _T]] = set(other) + except TypeError: + return NotImplemented + + tmp = set() + for key in ret: + if not isinstance(key, str): + continue + identity = self._md._identity(key) + tmp.add(identity) + + for e in self._md._keys.iter_entries(): + if e.identity not in tmp: + ret.add(e.key) + return ret + + def __sub__(self, other: Iterable[object]) -> set[str]: + ret = set(self) + try: + it = iter(other) + except TypeError: + return NotImplemented + for key in it: + if not isinstance(key, str): + continue + identity = self._md._identity(key) + hash_ = hash(identity) + for slot, idx, e in self._md._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + ret.discard(e.key) + break + return ret + + def __rsub__(self, other: Iterable[_T]) -> set[_T]: + try: + ret: set[_T] = set(other) + except TypeError: + return NotImplemented + for key in other: + if not isinstance(key, str): + continue + if key in self._md: + ret.discard(key) # type: ignore[arg-type] + return ret + + def __xor__(self, other: Iterable[_T]) -> set[Union[str, _T]]: + try: + rgt = set(other) + except TypeError: + return NotImplemented + ret: set[Union[str, _T]] = self - rgt # type: ignore[assignment] + ret |= rgt - self + return ret + + __rxor__ = __xor__ + + def isdisjoint(self, other: Iterable[object]) -> bool: + for key in other: + if not isinstance(key, str): + continue + if key in self._md: + return False + return True + + +class _CSMixin: + _ci: ClassVar[bool] = False + + def _key(self, key: str) -> str: + return key + + def _identity(self, key: str) -> str: + if isinstance(key, str): + return key + else: + raise TypeError("MultiDict keys should be either str or subclasses of str") + + +class _CIMixin: + _ci: ClassVar[bool] = True + + def _key(self, key: str) -> str: + if type(key) is istr: + return key + else: + return istr(key) + + def _identity(self, key: str) -> str: + if isinstance(key, istr): + ret = key.__istr_identity__ + if ret is None: + ret = key.lower() + key.__istr_identity__ = ret + return ret + if isinstance(key, str): + return key.lower() + else: + raise TypeError("MultiDict keys should be either str or subclasses of str") + + +def estimate_log2_keysize(n: int) -> int: + # 7 == HT_MINSIZE - 1 + return (((n * 3 + 1) // 2) | 7).bit_length() + + +@dataclass +class _Entry(Generic[_V]): + hash: int + identity: str + key: str + value: _V + + +@dataclass +class _HtKeys(Generic[_V]): # type: ignore[misc] + LOG_MINSIZE: ClassVar[int] = 3 + MINSIZE: ClassVar[int] = 8 + PREALLOCATED_INDICES: ClassVar[dict[int, array]] = { # type: ignore[type-arg] + log2_size: array( + "b" if log2_size < 8 else "h", (-1 for i in range(1 << log2_size)) + ) + for log2_size in range(3, 10) + } + + log2_size: int + usable: int + + indices: array # type: ignore[type-arg] # in py3.9 array is not generic + entries: list[Optional[_Entry[_V]]] + + @functools.cached_property + def nslots(self) -> int: + return 1 << self.log2_size + + @functools.cached_property + def mask(self) -> int: + return self.nslots - 1 + + if sys.implementation.name != "pypy": + + def __sizeof__(self) -> int: + return ( + object.__sizeof__(self) + + sys.getsizeof(self.indices) + + sys.getsizeof(self.entries) + ) + + @classmethod + def new(cls, log2_size: int, entries: list[Optional[_Entry[_V]]]) -> Self: + size = 1 << log2_size + usable = (size << 1) // 3 + if log2_size < 10: + indices = cls.PREALLOCATED_INDICES[log2_size].__copy__() + elif log2_size < 16: + indices = array("h", (-1 for i in range(size))) + elif log2_size < 32: + indices = array("l", (-1 for i in range(size))) + else: # pragma: no cover # don't test huge multidicts + indices = array("q", (-1 for i in range(size))) + ret = cls( + log2_size=log2_size, + usable=usable, + indices=indices, + entries=entries, + ) + return ret + + def clone(self) -> "_HtKeys[_V]": + entries = [ + _Entry(e.hash, e.identity, e.key, e.value) if e is not None else None + for e in self.entries + ] + + return _HtKeys( + log2_size=self.log2_size, + usable=self.usable, + indices=self.indices.__copy__(), + entries=entries, + ) + + def build_indices(self, update: bool) -> None: + mask = self.mask + indices = self.indices + for idx, e in enumerate(self.entries): + assert e is not None + hash_ = e.hash + if update: + if hash_ == -1: + hash_ = hash(e.identity) + else: + assert hash_ != -1 + i = hash_ & mask + perturb = hash_ & sys.maxsize + while indices[i] != -1: + perturb >>= 5 + i = mask & (i * 5 + perturb + 1) + indices[i] = idx + + def find_empty_slot(self, hash_: int) -> int: + mask = self.mask + indices = self.indices + i = hash_ & mask + perturb = hash_ & sys.maxsize + ix = indices[i] + while ix != -1: + perturb >>= 5 + i = (i * 5 + perturb + 1) & mask + ix = indices[i] + return i + + def iter_hash(self, hash_: int) -> Iterator[tuple[int, int, _Entry[_V]]]: + mask = self.mask + indices = self.indices + entries = self.entries + i = hash_ & mask + perturb = hash_ & sys.maxsize + ix = indices[i] + while ix != -1: + if ix != -2: + e = entries[ix] + if e.hash == hash_: + yield i, ix, e + perturb >>= 5 + i = (i * 5 + perturb + 1) & mask + ix = indices[i] + + def del_idx(self, hash_: int, idx: int) -> None: + mask = self.mask + indices = self.indices + i = hash_ & mask + perturb = hash_ & sys.maxsize + ix = indices[i] + while ix != idx: + perturb >>= 5 + i = (i * 5 + perturb + 1) & mask + ix = indices[i] + indices[i] = -2 + + def iter_entries(self) -> Iterator[_Entry[_V]]: + return filter(None, self.entries) + + def restore_hash(self, hash_: int) -> None: + mask = self.mask + indices = self.indices + entries = self.entries + i = hash_ & mask + perturb = hash_ & sys.maxsize + ix = indices[i] + while ix != -1: + if ix != -2: + entry = entries[ix] + if entry.hash == -1: + entry.hash = hash_ + perturb >>= 5 + i = (i * 5 + perturb + 1) & mask + ix = indices[i] + + +class MultiDict(_CSMixin, MutableMultiMapping[_V]): + """Dictionary with the support for duplicate keys.""" + + __slots__ = ("_keys", "_used", "_version") + + def __init__(self, arg: MDArg[_V] = None, /, **kwargs: _V): + self._used = 0 + v = _version + v[0] += 1 + self._version = v[0] + if not kwargs: + md = None + if isinstance(arg, MultiDictProxy): + md = arg._md + elif isinstance(arg, MultiDict): + md = arg + if md is not None and md._ci is self._ci: + self._from_md(md) + return + + it = self._parse_args(arg, kwargs) + log2_size = estimate_log2_keysize(cast(int, next(it))) + if log2_size > 17: # pragma: no cover + # Don't overallocate really huge keys space in init + log2_size = 17 + self._keys: _HtKeys[_V] = _HtKeys.new(log2_size, []) + self._extend_items(cast(Iterator[_Entry[_V]], it)) + + def _from_md(self, md: "MultiDict[_V]") -> None: + # Copy everything as-is without compacting the new multidict, + # otherwise it requires reindexing + self._keys = md._keys.clone() + self._used = md._used + + @overload + def getall(self, key: str) -> list[_V]: ... + @overload + def getall(self, key: str, default: _T) -> Union[list[_V], _T]: ... + def getall( + self, key: str, default: Union[_T, _SENTINEL] = sentinel + ) -> Union[list[_V], _T]: + """Return a list of all values matching the key.""" + identity = self._identity(key) + hash_ = hash(identity) + res = [] + restore = [] + for slot, idx, e in self._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + res.append(e.value) + e.hash = -1 + restore.append(idx) + + if res: + entries = self._keys.entries + for idx in restore: + entries[idx].hash = hash_ # type: ignore[union-attr] + return res + if not res and default is not sentinel: + return default + raise KeyError("Key not found: %r" % key) + + @overload + def getone(self, key: str) -> _V: ... + @overload + def getone(self, key: str, default: _T) -> Union[_V, _T]: ... + def getone( + self, key: str, default: Union[_T, _SENTINEL] = sentinel + ) -> Union[_V, _T]: + """Get first value matching the key. + + Raises KeyError if the key is not found and no default is provided. + """ + identity = self._identity(key) + hash_ = hash(identity) + for slot, idx, e in self._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + return e.value + if default is not sentinel: + return default + raise KeyError("Key not found: %r" % key) + + # Mapping interface # + + def __getitem__(self, key: str) -> _V: + return self.getone(key) + + @overload + def get(self, key: str, /) -> Union[_V, None]: ... + @overload + def get(self, key: str, /, default: _T) -> Union[_V, _T]: ... + def get(self, key: str, default: Union[_T, None] = None) -> Union[_V, _T, None]: + """Get first value matching the key. + + If the key is not found, returns the default (or None if no default is provided) + """ + return self.getone(key, default) + + def __iter__(self) -> Iterator[str]: + return iter(self.keys()) + + def __len__(self) -> int: + return self._used + + def keys(self) -> KeysView[str]: + """Return a new view of the dictionary's keys.""" + return _KeysView(self) + + def items(self) -> ItemsView[str, _V]: + """Return a new view of the dictionary's items *(key, value) pairs).""" + return _ItemsView(self) + + def values(self) -> _ValuesView[_V]: + """Return a new view of the dictionary's values.""" + return _ValuesView(self) + + def __eq__(self, other: object) -> bool: + if not isinstance(other, Mapping): + return NotImplemented + if isinstance(other, MultiDictProxy): + return self == other._md + if isinstance(other, MultiDict): + lft = self._keys + rht = other._keys + if self._used != other._used: + return False + for e1, e2 in zip(lft.iter_entries(), rht.iter_entries()): + if e1.identity != e2.identity or e1.value != e2.value: + return False + return True + if self._used != len(other): + return False + for k, v in self.items(): + nv = other.get(k, sentinel) + if v != nv: + return False + return True + + def __contains__(self, key: object) -> bool: + if not isinstance(key, str): + return False + identity = self._identity(key) + hash_ = hash(identity) + for slot, idx, e in self._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + return True + return False + + @reprlib.recursive_repr() + def __repr__(self) -> str: + body = ", ".join(f"'{e.key}': {e.value!r}" for e in self._keys.iter_entries()) + return f"<{self.__class__.__name__}({body})>" + + if sys.implementation.name != "pypy": + + def __sizeof__(self) -> int: + return object.__sizeof__(self) + sys.getsizeof(self._keys) + + def __reduce__(self) -> tuple[type[Self], tuple[list[tuple[str, _V]]]]: + return (self.__class__, (list(self.items()),)) + + def add(self, key: str, value: _V) -> None: + identity = self._identity(key) + hash_ = hash(identity) + self._add_with_hash(_Entry(hash_, identity, key, value)) + self._incr_version() + + def copy(self) -> Self: + """Return a copy of itself.""" + cls = self.__class__ + return cls(self) + + __copy__ = copy + + def extend(self, arg: MDArg[_V] = None, /, **kwargs: _V) -> None: + """Extend current MultiDict with more values. + + This method must be used instead of update. + """ + it = self._parse_args(arg, kwargs) + newsize = self._used + cast(int, next(it)) + self._resize(estimate_log2_keysize(newsize), False) + self._extend_items(cast(Iterator[_Entry[_V]], it)) + + def _parse_args( + self, + arg: MDArg[_V], + kwargs: Mapping[str, _V], + ) -> Iterator[Union[int, _Entry[_V]]]: + identity_func = self._identity + if arg: + if isinstance(arg, MultiDictProxy): + arg = arg._md + if isinstance(arg, MultiDict): + yield len(arg) + len(kwargs) + if self._ci is not arg._ci: + for e in arg._keys.iter_entries(): + identity = identity_func(e.key) + yield _Entry(hash(identity), identity, e.key, e.value) + else: + for e in arg._keys.iter_entries(): + yield _Entry(e.hash, e.identity, e.key, e.value) + if kwargs: + for key, value in kwargs.items(): + identity = identity_func(key) + yield _Entry(hash(identity), identity, key, value) + else: + if hasattr(arg, "keys"): + arg = cast(SupportsKeys[_V], arg) + arg = [(k, arg[k]) for k in arg.keys()] + if kwargs: + arg = list(arg) + arg.extend(list(kwargs.items())) + try: + yield len(arg) + len(kwargs) # type: ignore[arg-type] + except TypeError: + yield 0 + for pos, item in enumerate(arg): + if not len(item) == 2: + raise ValueError( + f"multidict update sequence element #{pos}" + f"has length {len(item)}; 2 is required" + ) + identity = identity_func(item[0]) + yield _Entry(hash(identity), identity, item[0], item[1]) + else: + yield len(kwargs) + for key, value in kwargs.items(): + identity = identity_func(key) + yield _Entry(hash(identity), identity, key, value) + + def _extend_items(self, items: Iterable[_Entry[_V]]) -> None: + for e in items: + self._add_with_hash(e) + self._incr_version() + + def clear(self) -> None: + """Remove all items from MultiDict.""" + self._used = 0 + self._keys = _HtKeys.new(_HtKeys.LOG_MINSIZE, []) + self._incr_version() + + # Mapping interface # + + def __setitem__(self, key: str, value: _V) -> None: + identity = self._identity(key) + hash_ = hash(identity) + found = False + + for slot, idx, e in self._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + if not found: + e.key = key + e.value = value + e.hash = -1 + found = True + self._incr_version() + elif e.hash != -1: # pragma: no branch + self._del_at(slot, idx) + + if not found: + self._add_with_hash(_Entry(hash_, identity, key, value)) + else: + self._keys.restore_hash(hash_) + + def __delitem__(self, key: str) -> None: + found = False + identity = self._identity(key) + hash_ = hash(identity) + for slot, idx, e in self._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + self._del_at(slot, idx) + found = True + if not found: + raise KeyError(key) + else: + self._incr_version() + + @overload + def setdefault( + self: "MultiDict[Union[_T, None]]", key: str, default: None = None + ) -> Union[_T, None]: ... + @overload + def setdefault(self, key: str, default: _V) -> _V: ... + def setdefault(self, key: str, default: Union[_V, None] = None) -> Union[_V, None]: # type: ignore[misc] + """Return value for key, set value to default if key is not present.""" + identity = self._identity(key) + hash_ = hash(identity) + for slot, idx, e in self._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + return e.value + self.add(key, default) # type: ignore[arg-type] + return default + + @overload + def popone(self, key: str) -> _V: ... + @overload + def popone(self, key: str, default: _T) -> Union[_V, _T]: ... + def popone( + self, key: str, default: Union[_T, _SENTINEL] = sentinel + ) -> Union[_V, _T]: + """Remove specified key and return the corresponding value. + + If key is not found, d is returned if given, otherwise + KeyError is raised. + + """ + identity = self._identity(key) + hash_ = hash(identity) + for slot, idx, e in self._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + value = e.value + self._del_at(slot, idx) + self._incr_version() + return value + if default is sentinel: + raise KeyError(key) + else: + return default + + # Type checking will inherit signature for pop() if we don't confuse it here. + if not TYPE_CHECKING: + pop = popone + + @overload + def popall(self, key: str) -> list[_V]: ... + @overload + def popall(self, key: str, default: _T) -> Union[list[_V], _T]: ... + def popall( + self, key: str, default: Union[_T, _SENTINEL] = sentinel + ) -> Union[list[_V], _T]: + """Remove all occurrences of key and return the list of corresponding + values. + + If key is not found, default is returned if given, otherwise + KeyError is raised. + + """ + found = False + identity = self._identity(key) + hash_ = hash(identity) + ret = [] + for slot, idx, e in self._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + found = True + ret.append(e.value) + self._del_at(slot, idx) + self._incr_version() + + if not found: + if default is sentinel: + raise KeyError(key) + else: + return default + else: + return ret + + def popitem(self) -> tuple[str, _V]: + """Remove and return an arbitrary (key, value) pair.""" + if self._used <= 0: + raise KeyError("empty multidict") + + pos = len(self._keys.entries) - 1 + entry = self._keys.entries.pop() + + while entry is None: + pos -= 1 + entry = self._keys.entries.pop() + + ret = self._key(entry.key), entry.value + self._keys.del_idx(entry.hash, pos) + self._used -= 1 + self._incr_version() + return ret + + def update(self, arg: MDArg[_V] = None, /, **kwargs: _V) -> None: + """Update the dictionary, overwriting existing keys.""" + it = self._parse_args(arg, kwargs) + newsize = self._used + cast(int, next(it)) + log2_size = estimate_log2_keysize(newsize) + if log2_size > 17: # pragma: no cover + # Don't overallocate really huge keys space in update, + # duplicate keys could reduce the resulting anount of entries + log2_size = 17 + if log2_size > self._keys.log2_size: + self._resize(log2_size, False) + try: + self._update_items(cast(Iterator[_Entry[_V]], it)) + finally: + self._post_update() + + def _update_items(self, items: Iterator[_Entry[_V]]) -> None: + for entry in items: + found = False + hash_ = entry.hash + identity = entry.identity + for slot, idx, e in self._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + if not found: + found = True + e.key = entry.key + e.value = entry.value + e.hash = -1 + else: + self._del_at_for_upd(e) + if not found: + self._add_with_hash_for_upd(entry) + + def _post_update(self) -> None: + keys = self._keys + indices = keys.indices + entries = keys.entries + for slot in range(keys.nslots): + idx = indices[slot] + if idx >= 0: + e2 = entries[idx] + assert e2 is not None + if e2.key is None: + entries[idx] = None + indices[slot] = -2 + self._used -= 1 + if e2.hash == -1: + e2.hash = hash(e2.identity) + + self._incr_version() + + def merge(self, arg: MDArg[_V] = None, /, **kwargs: _V) -> None: + """Merge into the dictionary, adding non-existing keys.""" + it = self._parse_args(arg, kwargs) + newsize = self._used + cast(int, next(it)) + log2_size = estimate_log2_keysize(newsize) + if log2_size > 17: # pragma: no cover + # Don't overallocate really huge keys space in update, + # duplicate keys could reduce the resulting anount of entries + log2_size = 17 + if log2_size > self._keys.log2_size: + self._resize(log2_size, False) + try: + self._merge_items(cast(Iterator[_Entry[_V]], it)) + finally: + self._post_update() + + def _merge_items(self, items: Iterator[_Entry[_V]]) -> None: + for entry in items: + hash_ = entry.hash + identity = entry.identity + for slot, idx, e in self._keys.iter_hash(hash_): + if e.identity == identity: # pragma: no branch + break + else: + self._add_with_hash_for_upd(entry) + + def _incr_version(self) -> None: + v = _version + v[0] += 1 + self._version = v[0] + + def _resize(self, log2_newsize: int, update: bool) -> None: + oldkeys = self._keys + newentries = self._used + + if len(oldkeys.entries) == newentries: + entries = oldkeys.entries + else: + entries = [e for e in oldkeys.entries if e is not None] + newkeys: _HtKeys[_V] = _HtKeys.new(log2_newsize, entries) + newkeys.usable -= newentries + newkeys.build_indices(update) + self._keys = newkeys + + def _add_with_hash(self, entry: _Entry[_V]) -> None: + if self._keys.usable <= 0: + self._resize((self._used * 3 | _HtKeys.MINSIZE - 1).bit_length(), False) + keys = self._keys + slot = keys.find_empty_slot(entry.hash) + keys.indices[slot] = len(keys.entries) + keys.entries.append(entry) + self._incr_version() + self._used += 1 + keys.usable -= 1 + + def _add_with_hash_for_upd(self, entry: _Entry[_V]) -> None: + if self._keys.usable <= 0: + self._resize((self._used * 3 | _HtKeys.MINSIZE - 1).bit_length(), True) + keys = self._keys + slot = keys.find_empty_slot(entry.hash) + keys.indices[slot] = len(keys.entries) + entry.hash = -1 + keys.entries.append(entry) + self._incr_version() + self._used += 1 + keys.usable -= 1 + + def _del_at(self, slot: int, idx: int) -> None: + self._keys.entries[idx] = None + self._keys.indices[slot] = -2 + self._used -= 1 + + def _del_at_for_upd(self, entry: _Entry[_V]) -> None: + entry.key = None # type: ignore[assignment] + entry.value = None # type: ignore[assignment] + + +class CIMultiDict(_CIMixin, MultiDict[_V]): + """Dictionary with the support for duplicate case-insensitive keys.""" + + +class MultiDictProxy(_CSMixin, MultiMapping[_V]): + """Read-only proxy for MultiDict instance.""" + + __slots__ = ("_md",) + + _md: MultiDict[_V] + + def __init__(self, arg: Union[MultiDict[_V], "MultiDictProxy[_V]"]): + if not isinstance(arg, (MultiDict, MultiDictProxy)): + raise TypeError( + f"ctor requires MultiDict or MultiDictProxy instance, not {type(arg)}" + ) + if isinstance(arg, MultiDictProxy): + self._md = arg._md + else: + self._md = arg + + def __reduce__(self) -> NoReturn: + raise TypeError(f"can't pickle {self.__class__.__name__} objects") + + @overload + def getall(self, key: str) -> list[_V]: ... + @overload + def getall(self, key: str, default: _T) -> Union[list[_V], _T]: ... + def getall( + self, key: str, default: Union[_T, _SENTINEL] = sentinel + ) -> Union[list[_V], _T]: + """Return a list of all values matching the key.""" + if default is not sentinel: + return self._md.getall(key, default) + else: + return self._md.getall(key) + + @overload + def getone(self, key: str) -> _V: ... + @overload + def getone(self, key: str, default: _T) -> Union[_V, _T]: ... + def getone( + self, key: str, default: Union[_T, _SENTINEL] = sentinel + ) -> Union[_V, _T]: + """Get first value matching the key. + + Raises KeyError if the key is not found and no default is provided. + """ + if default is not sentinel: + return self._md.getone(key, default) + else: + return self._md.getone(key) + + # Mapping interface # + + def __getitem__(self, key: str) -> _V: + return self.getone(key) + + @overload + def get(self, key: str, /) -> Union[_V, None]: ... + @overload + def get(self, key: str, /, default: _T) -> Union[_V, _T]: ... + def get(self, key: str, default: Union[_T, None] = None) -> Union[_V, _T, None]: + """Get first value matching the key. + + If the key is not found, returns the default (or None if no default is provided) + """ + return self._md.getone(key, default) + + def __iter__(self) -> Iterator[str]: + return iter(self._md.keys()) + + def __len__(self) -> int: + return len(self._md) + + def keys(self) -> KeysView[str]: + """Return a new view of the dictionary's keys.""" + return self._md.keys() + + def items(self) -> ItemsView[str, _V]: + """Return a new view of the dictionary's items *(key, value) pairs).""" + return self._md.items() + + def values(self) -> _ValuesView[_V]: + """Return a new view of the dictionary's values.""" + return self._md.values() + + def __eq__(self, other: object) -> bool: + return self._md == other + + def __contains__(self, key: object) -> bool: + return key in self._md + + @reprlib.recursive_repr() + def __repr__(self) -> str: + body = ", ".join(f"'{k}': {v!r}" for k, v in self.items()) + return f"<{self.__class__.__name__}({body})>" + + def copy(self) -> MultiDict[_V]: + """Return a copy of itself.""" + return MultiDict(self._md) + + +class CIMultiDictProxy(_CIMixin, MultiDictProxy[_V]): + """Read-only proxy for CIMultiDict instance.""" + + def __init__(self, arg: Union[MultiDict[_V], MultiDictProxy[_V]]): + if not isinstance(arg, (CIMultiDict, CIMultiDictProxy)): + raise TypeError( + "ctor requires CIMultiDict or CIMultiDictProxy instance" + f", not {type(arg)}" + ) + + super().__init__(arg) + + def copy(self) -> CIMultiDict[_V]: + """Return a copy of itself.""" + return CIMultiDict(self._md) + + +def getversion(md: Union[MultiDict[object], MultiDictProxy[object]]) -> int: + if isinstance(md, MultiDictProxy): + md = md._md + elif not isinstance(md, MultiDict): + raise TypeError("Parameter should be multidict or proxy") + return md._version diff --git a/env/lib/python3.12/site-packages/multidict/py.typed b/env/lib/python3.12/site-packages/multidict/py.typed new file mode 100644 index 0000000..dfe8cc0 --- /dev/null +++ b/env/lib/python3.12/site-packages/multidict/py.typed @@ -0,0 +1 @@ +PEP-561 marker. \ No newline at end of file diff --git a/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/DESCRIPTION.rst b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/DESCRIPTION.rst new file mode 100644 index 0000000..c5c2ca0 --- /dev/null +++ b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/DESCRIPTION.rst @@ -0,0 +1,27 @@ +PickleShare - a small 'shelve' like datastore with concurrency support + +Like shelve, a PickleShareDB object acts like a normal dictionary. Unlike shelve, +many processes can access the database simultaneously. Changing a value in +database is immediately visible to other processes accessing the same database. + +Concurrency is possible because the values are stored in separate files. Hence +the "database" is a directory where *all* files are governed by PickleShare. + +Example usage:: + + from pickleshare import * + db = PickleShareDB('~/testpickleshare') + db.clear() + print("Should be empty:",db.items()) + db['hello'] = 15 + db['aku ankka'] = [1,2,313] + db['paths/are/ok/key'] = [1,(5,46)] + print(db.keys()) + +This module is certainly not ZODB, but can be used for low-load +(non-mission-critical) situations where tiny code size trumps the +advanced features of a "real" object database. + +Installation guide: pip install pickleshare + + diff --git a/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/INSTALLER b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/METADATA b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/METADATA new file mode 100644 index 0000000..4d9cb5f --- /dev/null +++ b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/METADATA @@ -0,0 +1,43 @@ +Metadata-Version: 2.0 +Name: pickleshare +Version: 0.7.5 +Summary: Tiny 'shelve'-like database with concurrency support +Home-page: https://github.com/pickleshare/pickleshare +Author: Ville Vainio +Author-email: vivainio@gmail.com +License: MIT +Keywords: database persistence pickle ipc shelve +Platform: UNKNOWN +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python :: 2 +Classifier: Programming Language :: Python :: 2.7 +Classifier: Programming Language :: Python :: 3 +Requires-Dist: pathlib2; python_version in "2.6 2.7 3.2 3.3" + +PickleShare - a small 'shelve' like datastore with concurrency support + +Like shelve, a PickleShareDB object acts like a normal dictionary. Unlike shelve, +many processes can access the database simultaneously. Changing a value in +database is immediately visible to other processes accessing the same database. + +Concurrency is possible because the values are stored in separate files. Hence +the "database" is a directory where *all* files are governed by PickleShare. + +Example usage:: + + from pickleshare import * + db = PickleShareDB('~/testpickleshare') + db.clear() + print("Should be empty:",db.items()) + db['hello'] = 15 + db['aku ankka'] = [1,2,313] + db['paths/are/ok/key'] = [1,(5,46)] + print(db.keys()) + +This module is certainly not ZODB, but can be used for low-load +(non-mission-critical) situations where tiny code size trumps the +advanced features of a "real" object database. + +Installation guide: pip install pickleshare + + diff --git a/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/RECORD b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/RECORD new file mode 100644 index 0000000..bc4f1c2 --- /dev/null +++ b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/RECORD @@ -0,0 +1,9 @@ +__pycache__/pickleshare.cpython-312.pyc,, +pickleshare-0.7.5.dist-info/DESCRIPTION.rst,sha256=MzTGgSadINt6oklHN7G__Xz9_AGWxZ8wSUF52_xlqMc,955 +pickleshare-0.7.5.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +pickleshare-0.7.5.dist-info/METADATA,sha256=gtNHj-qWJlHKtLE9qkGxPzN3GwPOw9dtHs51VQR-Ce4,1519 +pickleshare-0.7.5.dist-info/RECORD,, +pickleshare-0.7.5.dist-info/WHEEL,sha256=o2k-Qa-RMNIJmUdIc7KU6VWR_ErNRbWNlxDIpl7lm34,110 +pickleshare-0.7.5.dist-info/metadata.json,sha256=7sZL7JqXL9AxCsI_tY_kSTedkIcXt9fcUilY3cJbXx0,805 +pickleshare-0.7.5.dist-info/top_level.txt,sha256=GiYXIFGUaJgH-I56GU6Q9DA8QmwBtTNL1_UMBlESlts,12 +pickleshare.py,sha256=YAYV_g5pDnVfO3IeR5vMyNNIWs4dhBMtTfIHevLKI6E,9942 diff --git a/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/WHEEL b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/WHEEL new file mode 100644 index 0000000..8b6dd1b --- /dev/null +++ b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/WHEEL @@ -0,0 +1,6 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.29.0) +Root-Is-Purelib: true +Tag: py2-none-any +Tag: py3-none-any + diff --git a/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/metadata.json b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/metadata.json new file mode 100644 index 0000000..8eefd98 --- /dev/null +++ b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/metadata.json @@ -0,0 +1 @@ +{"classifiers": ["License :: OSI Approved :: MIT License", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3"], "extensions": {"python.details": {"contacts": [{"email": "vivainio@gmail.com", "name": "Ville Vainio", "role": "author"}], "document_names": {"description": "DESCRIPTION.rst"}, "project_urls": {"Home": "https://github.com/pickleshare/pickleshare"}}}, "extras": [], "generator": "bdist_wheel (0.29.0)", "keywords": ["database", "persistence", "pickle", "ipc", "shelve"], "license": "MIT", "metadata_version": "2.0", "name": "pickleshare", "run_requires": [{"environment": "python_version in \"2.6 2.7 3.2 3.3\"", "requires": ["pathlib2"]}], "summary": "Tiny 'shelve'-like database with concurrency support", "version": "0.7.5"} \ No newline at end of file diff --git a/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/top_level.txt b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/top_level.txt new file mode 100644 index 0000000..e28afd8 --- /dev/null +++ b/env/lib/python3.12/site-packages/pickleshare-0.7.5.dist-info/top_level.txt @@ -0,0 +1 @@ +pickleshare diff --git a/env/lib/python3.12/site-packages/pickleshare.py b/env/lib/python3.12/site-packages/pickleshare.py new file mode 100644 index 0000000..086f84f --- /dev/null +++ b/env/lib/python3.12/site-packages/pickleshare.py @@ -0,0 +1,352 @@ +#!/usr/bin/env python + +""" PickleShare - a small 'shelve' like datastore with concurrency support + +Like shelve, a PickleShareDB object acts like a normal dictionary. Unlike +shelve, many processes can access the database simultaneously. Changing a +value in database is immediately visible to other processes accessing the +same database. + +Concurrency is possible because the values are stored in separate files. Hence +the "database" is a directory where *all* files are governed by PickleShare. + +Example usage:: + + from pickleshare import * + db = PickleShareDB('~/testpickleshare') + db.clear() + print "Should be empty:",db.items() + db['hello'] = 15 + db['aku ankka'] = [1,2,313] + db['paths/are/ok/key'] = [1,(5,46)] + print db.keys() + del db['aku ankka'] + +This module is certainly not ZODB, but can be used for low-load +(non-mission-critical) situations where tiny code size trumps the +advanced features of a "real" object database. + +Installation guide: pip install pickleshare + +Author: Ville Vainio +License: MIT open source license. + +""" + +from __future__ import print_function + + +__version__ = "0.7.5" + +try: + from pathlib import Path +except ImportError: + # Python 2 backport + from pathlib2 import Path + +import os,stat,time +try: + import collections.abc as collections_abc +except ImportError: + import collections as collections_abc +try: + import cPickle as pickle +except ImportError: + import pickle +import errno +import sys + +if sys.version_info[0] >= 3: + string_types = (str,) +else: + string_types = (str, unicode) + +def gethashfile(key): + return ("%02x" % abs(hash(key) % 256))[-2:] + +_sentinel = object() + +class PickleShareDB(collections_abc.MutableMapping): + """ The main 'connection' object for PickleShare database """ + def __init__(self,root): + """ Return a db object that will manage the specied directory""" + if not isinstance(root, string_types): + root = str(root) + root = os.path.abspath(os.path.expanduser(root)) + self.root = Path(root) + if not self.root.is_dir(): + # catching the exception is necessary if multiple processes are concurrently trying to create a folder + # exists_ok keyword argument of mkdir does the same but only from Python 3.5 + try: + self.root.mkdir(parents=True) + except OSError as e: + if e.errno != errno.EEXIST: + raise + # cache has { 'key' : (obj, orig_mod_time) } + self.cache = {} + + + def __getitem__(self,key): + """ db['key'] reading """ + fil = self.root / key + try: + mtime = (fil.stat()[stat.ST_MTIME]) + except OSError: + raise KeyError(key) + + if fil in self.cache and mtime == self.cache[fil][1]: + return self.cache[fil][0] + try: + # The cached item has expired, need to read + with fil.open("rb") as f: + obj = pickle.loads(f.read()) + except: + raise KeyError(key) + + self.cache[fil] = (obj,mtime) + return obj + + def __setitem__(self,key,value): + """ db['key'] = 5 """ + fil = self.root / key + parent = fil.parent + if parent and not parent.is_dir(): + parent.mkdir(parents=True) + # We specify protocol 2, so that we can mostly go between Python 2 + # and Python 3. We can upgrade to protocol 3 when Python 2 is obsolete. + with fil.open('wb') as f: + pickle.dump(value, f, protocol=2) + try: + self.cache[fil] = (value, fil.stat().st_mtime) + except OSError as e: + if e.errno != errno.ENOENT: + raise + + def hset(self, hashroot, key, value): + """ hashed set """ + hroot = self.root / hashroot + if not hroot.is_dir(): + hroot.mkdir() + hfile = hroot / gethashfile(key) + d = self.get(hfile, {}) + d.update( {key : value}) + self[hfile] = d + + + + def hget(self, hashroot, key, default = _sentinel, fast_only = True): + """ hashed get """ + hroot = self.root / hashroot + hfile = hroot / gethashfile(key) + + d = self.get(hfile, _sentinel ) + #print "got dict",d,"from",hfile + if d is _sentinel: + if fast_only: + if default is _sentinel: + raise KeyError(key) + + return default + + # slow mode ok, works even after hcompress() + d = self.hdict(hashroot) + + return d.get(key, default) + + def hdict(self, hashroot): + """ Get all data contained in hashed category 'hashroot' as dict """ + hfiles = self.keys(hashroot + "/*") + hfiles.sort() + last = len(hfiles) and hfiles[-1] or '' + if last.endswith('xx'): + # print "using xx" + hfiles = [last] + hfiles[:-1] + + all = {} + + for f in hfiles: + # print "using",f + try: + all.update(self[f]) + except KeyError: + print("Corrupt",f,"deleted - hset is not threadsafe!") + del self[f] + + self.uncache(f) + + return all + + def hcompress(self, hashroot): + """ Compress category 'hashroot', so hset is fast again + + hget will fail if fast_only is True for compressed items (that were + hset before hcompress). + + """ + hfiles = self.keys(hashroot + "/*") + all = {} + for f in hfiles: + # print "using",f + all.update(self[f]) + self.uncache(f) + + self[hashroot + '/xx'] = all + for f in hfiles: + p = self.root / f + if p.name == 'xx': + continue + p.unlink() + + + + def __delitem__(self,key): + """ del db["key"] """ + fil = self.root / key + self.cache.pop(fil,None) + try: + fil.unlink() + except OSError: + # notfound and permission denied are ok - we + # lost, the other process wins the conflict + pass + + def _normalized(self, p): + """ Make a key suitable for user's eyes """ + return str(p.relative_to(self.root)).replace('\\','/') + + def keys(self, globpat = None): + """ All keys in DB, or all keys matching a glob""" + + if globpat is None: + files = self.root.rglob('*') + else: + files = self.root.glob(globpat) + return [self._normalized(p) for p in files if p.is_file()] + + def __iter__(self): + return iter(self.keys()) + + def __len__(self): + return len(self.keys()) + + def uncache(self,*items): + """ Removes all, or specified items from cache + + Use this after reading a large amount of large objects + to free up memory, when you won't be needing the objects + for a while. + + """ + if not items: + self.cache = {} + for it in items: + self.cache.pop(it,None) + + def waitget(self,key, maxwaittime = 60 ): + """ Wait (poll) for a key to get a value + + Will wait for `maxwaittime` seconds before raising a KeyError. + The call exits normally if the `key` field in db gets a value + within the timeout period. + + Use this for synchronizing different processes or for ensuring + that an unfortunately timed "db['key'] = newvalue" operation + in another process (which causes all 'get' operation to cause a + KeyError for the duration of pickling) won't screw up your program + logic. + """ + + wtimes = [0.2] * 3 + [0.5] * 2 + [1] + tries = 0 + waited = 0 + while 1: + try: + val = self[key] + return val + except KeyError: + pass + + if waited > maxwaittime: + raise KeyError(key) + + time.sleep(wtimes[tries]) + waited+=wtimes[tries] + if tries < len(wtimes) -1: + tries+=1 + + def getlink(self,folder): + """ Get a convenient link for accessing items """ + return PickleShareLink(self, folder) + + def __repr__(self): + return "PickleShareDB('%s')" % self.root + + + +class PickleShareLink: + """ A shortdand for accessing nested PickleShare data conveniently. + + Created through PickleShareDB.getlink(), example:: + + lnk = db.getlink('myobjects/test') + lnk.foo = 2 + lnk.bar = lnk.foo + 5 + + """ + def __init__(self, db, keydir ): + self.__dict__.update(locals()) + + def __getattr__(self,key): + return self.__dict__['db'][self.__dict__['keydir']+'/' + key] + def __setattr__(self,key,val): + self.db[self.keydir+'/' + key] = val + def __repr__(self): + db = self.__dict__['db'] + keys = db.keys( self.__dict__['keydir'] +"/*") + return "" % ( + self.__dict__['keydir'], + ";".join([Path(k).basename() for k in keys])) + +def main(): + import textwrap + usage = textwrap.dedent("""\ + pickleshare - manage PickleShare databases + + Usage: + + pickleshare dump /path/to/db > dump.txt + pickleshare load /path/to/db < dump.txt + pickleshare test /path/to/db + """) + DB = PickleShareDB + import sys + if len(sys.argv) < 2: + print(usage) + return + + cmd = sys.argv[1] + args = sys.argv[2:] + if cmd == 'dump': + if not args: args= ['.'] + db = DB(args[0]) + import pprint + pprint.pprint(db.items()) + elif cmd == 'load': + cont = sys.stdin.read() + db = DB(args[0]) + data = eval(cont) + db.clear() + for k,v in db.items(): + db[k] = v + elif cmd == 'testwait': + db = DB(args[0]) + db.clear() + print(db.waitget('250')) + elif cmd == 'test': + test() + stress() + +if __name__== "__main__": + main() + + diff --git a/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/AUTHORS.txt b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/AUTHORS.txt new file mode 100644 index 0000000..f42daec --- /dev/null +++ b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/AUTHORS.txt @@ -0,0 +1,806 @@ +@Switch01 +A_Rog +Aakanksha Agrawal +Abhinav Sagar +ABHYUDAY PRATAP SINGH +abs51295 +AceGentile +Adam Chainz +Adam Tse +Adam Wentz +admin +Adolfo Ochagavía +Adrien Morison +Agus +ahayrapetyan +Ahilya +AinsworthK +Akash Srivastava +Alan Yee +Albert Tugushev +Albert-Guan +albertg +Alberto Sottile +Aleks Bunin +Ales Erjavec +Alethea Flowers +Alex Gaynor +Alex Grönholm +Alex Hedges +Alex Loosley +Alex Morega +Alex Stachowiak +Alexander Shtyrov +Alexandre Conrad +Alexey Popravka +Aleš Erjavec +Alli +Ami Fischman +Ananya Maiti +Anatoly Techtonik +Anders Kaseorg +Andre Aguiar +Andreas Lutro +Andrei Geacar +Andrew Gaul +Andrew Shymanel +Andrey Bienkowski +Andrey Bulgakov +Andrés Delfino +Andy Freeland +Andy Kluger +Ani Hayrapetyan +Aniruddha Basak +Anish Tambe +Anrs Hu +Anthony Sottile +Antoine Musso +Anton Ovchinnikov +Anton Patrushev +Anton Zelenov +Antonio Alvarado Hernandez +Antony Lee +Antti Kaihola +Anubhav Patel +Anudit Nagar +Anuj Godase +AQNOUCH Mohammed +AraHaan +arena +arenasys +Arindam Choudhury +Armin Ronacher +Arnon Yaari +Artem +Arun Babu Neelicattu +Ashley Manton +Ashwin Ramaswami +atse +Atsushi Odagiri +Avinash Karhana +Avner Cohen +Awit (Ah-Wit) Ghirmai +Baptiste Mispelon +Barney Gale +barneygale +Bartek Ogryczak +Bastian Venthur +Ben Bodenmiller +Ben Darnell +Ben Hoyt +Ben Mares +Ben Rosser +Bence Nagy +Benjamin Peterson +Benjamin VanEvery +Benoit Pierre +Berker Peksag +Bernard +Bernard Tyers +Bernardo B. Marques +Bernhard M. Wiedemann +Bertil Hatt +Bhavam Vidyarthi +Blazej Michalik +Bogdan Opanchuk +BorisZZZ +Brad Erickson +Bradley Ayers +Branch Vincent +Brandon L. Reiss +Brandt Bucher +Brannon Dorsey +Brett Randall +Brett Rosen +Brian Cristante +Brian Rosner +briantracy +BrownTruck +Bruno Oliveira +Bruno Renié +Bruno S +Bstrdsmkr +Buck Golemon +burrows +Bussonnier Matthias +bwoodsend +c22 +Caleb Brown +Caleb Martinez +Calvin Smith +Carl Meyer +Carlos Liam +Carol Willing +Carter Thayer +Cass +Chandrasekhar Atina +Charlie Marsh +charwick +Chih-Hsuan Yen +Chris Brinker +Chris Hunt +Chris Jerdonek +Chris Kuehl +Chris Markiewicz +Chris McDonough +Chris Pawley +Chris Pryer +Chris Wolfe +Christian Clauss +Christian Heimes +Christian Oudard +Christoph Reiter +Christopher Hunt +Christopher Snyder +chrysle +cjc7373 +Clark Boylan +Claudio Jolowicz +Clay McClure +Cody +Cody Soyland +Colin Watson +Collin Anderson +Connor Osborn +Cooper Lees +Cooper Ry Lees +Cory Benfield +Cory Wright +Craig Kerstiens +Cristian Sorinel +Cristina +Cristina Muñoz +ctg123 +Curtis Doty +cytolentino +Daan De Meyer +Dale +Damian +Damian Quiroga +Damian Shaw +Dan Black +Dan Savilonis +Dan Sully +Dane Hillard +daniel +Daniel Collins +Daniel Hahler +Daniel Holth +Daniel Jost +Daniel Katz +Daniel Shaulov +Daniele Esposti +Daniele Nicolodi +Daniele Procida +Daniil Konovalenko +Danny Hermes +Danny McClanahan +Darren Kavanagh +Dav Clark +Dave Abrahams +Dave Jones +David Aguilar +David Black +David Bordeynik +David Caro +David D Lowe +David Evans +David Hewitt +David Linke +David Poggi +David Poznik +David Pursehouse +David Runge +David Tucker +David Wales +Davidovich +ddelange +Deepak Sharma +Deepyaman Datta +Denise Yu +dependabot[bot] +derwolfe +Desetude +Devesh Kumar Singh +devsagul +Diego Caraballo +Diego Ramirez +DiegoCaraballo +Dimitri Merejkowsky +Dimitri Papadopoulos +Dimitri Papadopoulos Orfanos +Dirk Stolle +Dmitry Gladkov +Dmitry Volodin +Domen Kožar +Dominic Davis-Foster +Donald Stufft +Dongweiming +doron zarhi +Dos Moonen +Douglas Thor +DrFeathers +Dustin Ingram +Dustin Rodrigues +Dwayne Bailey +Ed Morley +Edgar Ramírez +Edgar Ramírez Mondragón +Ee Durbin +Efflam Lemaillet +efflamlemaillet +Eitan Adler +ekristina +elainechan +Eli Schwartz +Elisha Hollander +Ellen Marie Dash +Emil Burzo +Emil Styrke +Emmanuel Arias +Endoh Takanao +enoch +Erdinc Mutlu +Eric Cousineau +Eric Gillingham +Eric Hanchrow +Eric Hopper +Erik M. Bray +Erik Rose +Erwin Janssen +Eugene Vereshchagin +everdimension +Federico +Felipe Peter +Felix Yan +fiber-space +Filip Kokosiński +Filipe Laíns +Finn Womack +finnagin +Flavio Amurrio +Florian Briand +Florian Rathgeber +Francesco +Francesco Montesano +Fredrik Orderud +Frost Ming +Gabriel Curio +Gabriel de Perthuis +Garry Polley +gavin +gdanielson +Geoffrey Sneddon +George Song +Georgi Valkov +Georgy Pchelkin +ghost +Giftlin Rajaiah +gizmoguy1 +gkdoc +Godefroid Chapelle +Gopinath M +GOTO Hayato +gousaiyang +gpiks +Greg Roodt +Greg Ward +Guilherme Espada +Guillaume Seguin +gutsytechster +Guy Rozendorn +Guy Tuval +gzpan123 +Hanjun Kim +Hari Charan +Harsh Vardhan +harupy +Harutaka Kawamura +hauntsaninja +Henrich Hartzer +Henry Schreiner +Herbert Pfennig +Holly Stotelmyer +Honnix +Hsiaoming Yang +Hugo Lopes Tavares +Hugo van Kemenade +Hugues Bruant +Hynek Schlawack +Ian Bicking +Ian Cordasco +Ian Lee +Ian Stapleton Cordasco +Ian Wienand +Igor Kuzmitshov +Igor Sobreira +Ikko Ashimine +Ilan Schnell +Illia Volochii +Ilya Baryshev +Inada Naoki +Ionel Cristian Mărieș +Ionel Maries Cristian +Itamar Turner-Trauring +Ivan Pozdeev +J. Nick Koston +Jacob Kim +Jacob Walls +Jaime Sanz +jakirkham +Jakub Kuczys +Jakub Stasiak +Jakub Vysoky +Jakub Wilk +James Cleveland +James Curtin +James Firth +James Gerity +James Polley +Jan Pokorný +Jannis Leidel +Jarek Potiuk +jarondl +Jason Curtis +Jason R. Coombs +JasonMo +JasonMo1 +Jay Graves +Jean Abou Samra +Jean-Christophe Fillion-Robin +Jeff Barber +Jeff Dairiki +Jeff Widman +Jelmer Vernooij +jenix21 +Jeremy Fleischman +Jeremy Stanley +Jeremy Zafran +Jesse Rittner +Jiashuo Li +Jim Fisher +Jim Garrison +Jinzhe Zeng +Jiun Bae +Jivan Amara +Joe Bylund +Joe Michelini +John Paton +John Sirois +John T. Wodder II +John-Scott Atlakson +johnthagen +Jon Banafato +Jon Dufresne +Jon Parise +Jonas Nockert +Jonathan Herbert +Joonatan Partanen +Joost Molenaar +Jorge Niedbalski +Joseph Bylund +Joseph Long +Josh Bronson +Josh Cannon +Josh Hansen +Josh Schneier +Joshua +JoshuaPerdue +Juan Luis Cano Rodríguez +Juanjo Bazán +Judah Rand +Julian Berman +Julian Gethmann +Julien Demoor +July Tikhonov +Jussi Kukkonen +Justin van Heek +jwg4 +Jyrki Pulliainen +Kai Chen +Kai Mueller +Kamal Bin Mustafa +Karolina Surma +kasium +kaustav haldar +keanemind +Keith Maxwell +Kelsey Hightower +Kenneth Belitzky +Kenneth Reitz +Kevin Burke +Kevin Carter +Kevin Frommelt +Kevin R Patterson +Kexuan Sun +Kit Randel +Klaas van Schelven +KOLANICH +konstin +kpinc +Krishna Oza +Kumar McMillan +Kuntal Majumder +Kurt McKee +Kyle Persohn +lakshmanaram +Laszlo Kiss-Kollar +Laurent Bristiel +Laurent LAPORTE +Laurie O +Laurie Opperman +layday +Leon Sasson +Lev Givon +Lincoln de Sousa +Lipis +lorddavidiii +Loren Carvalho +Lucas Cimon +Ludovic Gasc +Luis Medel +Lukas Geiger +Lukas Juhrich +Luke Macken +Luo Jiebin +luojiebin +luz.paz +László Kiss Kollár +M00nL1ght +Marc Abramowitz +Marc Tamlyn +Marcus Smith +Mariatta +Mark Kohler +Mark McLoughlin +Mark Williams +Markus Hametner +Martey Dodoo +Martin Fischer +Martin Häcker +Martin Pavlasek +Masaki +Masklinn +Matej Stuchlik +Mathew Jennings +Mathieu Bridon +Mathieu Kniewallner +Matt Bacchi +Matt Good +Matt Maker +Matt Robenolt +Matt Wozniski +matthew +Matthew Einhorn +Matthew Feickert +Matthew Gilliard +Matthew Hughes +Matthew Iversen +Matthew Treinish +Matthew Trumbell +Matthew Willson +Matthias Bussonnier +mattip +Maurits van Rees +Max W Chase +Maxim Kurnikov +Maxime Rouyrre +mayeut +mbaluna +mdebi +memoselyk +meowmeowcat +Michael +Michael Aquilina +Michael E. Karpeles +Michael Klich +Michael Mintz +Michael Williamson +michaelpacer +Michał Górny +Mickaël Schoentgen +Miguel Araujo Perez +Mihir Singh +Mike +Mike Hendricks +Min RK +MinRK +Miro Hrončok +Monica Baluna +montefra +Monty Taylor +morotti +mrKazzila +Muha Ajjan +Nadav Wexler +Nahuel Ambrosini +Nate Coraor +Nate Prewitt +Nathan Houghton +Nathaniel J. Smith +Nehal J Wani +Neil Botelho +Nguyễn Gia Phong +Nicholas Serra +Nick Coghlan +Nick Stenning +Nick Timkovich +Nicolas Bock +Nicole Harris +Nikhil Benesch +Nikhil Ladha +Nikita Chepanov +Nikolay Korolev +Nipunn Koorapati +Nitesh Sharma +Niyas Sait +Noah +Noah Gorny +Nowell Strite +NtaleGrey +nvdv +OBITORASU +Ofek Lev +ofrinevo +Oliver Freund +Oliver Jeeves +Oliver Mannion +Oliver Tonnhofer +Olivier Girardot +Olivier Grisel +Ollie Rutherfurd +OMOTO Kenji +Omry Yadan +onlinejudge95 +Oren Held +Oscar Benjamin +Oz N Tiram +Pachwenko +Patrick Dubroy +Patrick Jenkins +Patrick Lawson +patricktokeeffe +Patrik Kopkan +Paul Ganssle +Paul Kehrer +Paul Moore +Paul Nasrat +Paul Oswald +Paul van der Linden +Paulus Schoutsen +Pavel Safronov +Pavithra Eswaramoorthy +Pawel Jasinski +Paweł Szramowski +Pekka Klärck +Peter Gessler +Peter Lisák +Peter Shen +Peter Waller +Petr Viktorin +petr-tik +Phaneendra Chiruvella +Phil Elson +Phil Freo +Phil Pennock +Phil Whelan +Philip Jägenstedt +Philip Molloy +Philippe Ombredanne +Pi Delport +Pierre-Yves Rofes +Pieter Degroote +pip +Prabakaran Kumaresshan +Prabhjyotsing Surjit Singh Sodhi +Prabhu Marappan +Pradyun Gedam +Prashant Sharma +Pratik Mallya +pre-commit-ci[bot] +Preet Thakkar +Preston Holmes +Przemek Wrzos +Pulkit Goyal +q0w +Qiangning Hong +Qiming Xu +Quentin Lee +Quentin Pradet +R. David Murray +Rafael Caricio +Ralf Schmitt +Ran Benita +Randy Döring +Razzi Abuissa +rdb +Reece Dunham +Remi Rampin +Rene Dudfield +Riccardo Magliocchetti +Riccardo Schirone +Richard Jones +Richard Si +Ricky Ng-Adam +Rishi +rmorotti +RobberPhex +Robert Collins +Robert McGibbon +Robert Pollak +Robert T. McGibbon +robin elisha robinson +Roey Berman +Rohan Jain +Roman Bogorodskiy +Roman Donchenko +Romuald Brunet +ronaudinho +Ronny Pfannschmidt +Rory McCann +Ross Brattain +Roy Wellington Ⅳ +Ruairidh MacLeod +Russell Keith-Magee +Ryan Shepherd +Ryan Wooden +ryneeverett +S. Guliaev +Sachi King +Salvatore Rinchiera +sandeepkiran-js +Sander Van Balen +Savio Jomton +schlamar +Scott Kitterman +Sean +seanj +Sebastian Jordan +Sebastian Schaetz +Segev Finer +SeongSoo Cho +Sergey Vasilyev +Seth Michael Larson +Seth Woodworth +Shahar Epstein +Shantanu +shenxianpeng +shireenrao +Shivansh-007 +Shixian Sheng +Shlomi Fish +Shovan Maity +Simeon Visser +Simon Cross +Simon Pichugin +sinoroc +sinscary +snook92 +socketubs +Sorin Sbarnea +Srinivas Nyayapati +Srishti Hegde +Stavros Korokithakis +Stefan Scherfke +Stefano Rivera +Stephan Erb +Stephen Rosen +stepshal +Steve (Gadget) Barnes +Steve Barnes +Steve Dower +Steve Kowalik +Steven Myint +Steven Silvester +stonebig +studioj +Stéphane Bidoul +Stéphane Bidoul (ACSONE) +Stéphane Klein +Sumana Harihareswara +Surbhi Sharma +Sviatoslav Sydorenko +Sviatoslav Sydorenko (Святослав Сидоренко) +Swat009 +Sylvain +Takayuki SHIMIZUKAWA +Taneli Hukkinen +tbeswick +Thiago +Thijs Triemstra +Thomas Fenzl +Thomas Grainger +Thomas Guettler +Thomas Johansson +Thomas Kluyver +Thomas Smith +Thomas VINCENT +Tim D. Smith +Tim Gates +Tim Harder +Tim Heap +tim smith +tinruufu +Tobias Hermann +Tom Forbes +Tom Freudenheim +Tom V +Tomas Hrnciar +Tomas Orsava +Tomer Chachamu +Tommi Enenkel | AnB +Tomáš Hrnčiar +Tony Beswick +Tony Narlock +Tony Zhaocheng Tan +TonyBeswick +toonarmycaptain +Toshio Kuratomi +toxinu +Travis Swicegood +Tushar Sadhwani +Tzu-ping Chung +Valentin Haenel +Victor Stinner +victorvpaulo +Vikram - Google +Viktor Szépe +Ville Skyttä +Vinay Sajip +Vincent Philippon +Vinicyus Macedo +Vipul Kumar +Vitaly Babiy +Vladimir Fokow +Vladimir Rutsky +W. Trevor King +Wil Tan +Wilfred Hughes +William Edwards +William ML Leslie +William T Olson +William Woodruff +Wilson Mo +wim glenn +Winson Luk +Wolfgang Maier +Wu Zhenyu +XAMES3 +Xavier Fernandez +Xianpeng Shen +xoviat +xtreak +YAMAMOTO Takashi +Yen Chi Hsuan +Yeray Diaz Diaz +Yoval P +Yu Jian +Yuan Jing Vincent Yan +Yusuke Hayashi +Zearin +Zhiping Deng +ziebam +Zvezdan Petkovic +Łukasz Langa +Роман Донченко +Семён Марьясин diff --git a/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/INSTALLER b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/LICENSE.txt b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/LICENSE.txt new file mode 100644 index 0000000..8e7b65e --- /dev/null +++ b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/LICENSE.txt @@ -0,0 +1,20 @@ +Copyright (c) 2008-present The pip developers (see AUTHORS.txt file) + +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/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/METADATA b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/METADATA new file mode 100644 index 0000000..3315c06 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/METADATA @@ -0,0 +1,90 @@ +Metadata-Version: 2.2 +Name: pip +Version: 25.0.1 +Summary: The PyPA recommended tool for installing Python packages. +Author-email: The pip developers +License: MIT +Project-URL: Homepage, https://pip.pypa.io/ +Project-URL: Documentation, https://pip.pypa.io +Project-URL: Source, https://github.com/pypa/pip +Project-URL: Changelog, https://pip.pypa.io/en/stable/news/ +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Topic :: Software Development :: Build Tools +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +License-File: LICENSE.txt +License-File: AUTHORS.txt + +pip - The Python Package Installer +================================== + +.. |pypi-version| image:: https://img.shields.io/pypi/v/pip.svg + :target: https://pypi.org/project/pip/ + :alt: PyPI + +.. |python-versions| image:: https://img.shields.io/pypi/pyversions/pip + :target: https://pypi.org/project/pip + :alt: PyPI - Python Version + +.. |docs-badge| image:: https://readthedocs.org/projects/pip/badge/?version=latest + :target: https://pip.pypa.io/en/latest + :alt: Documentation + +|pypi-version| |python-versions| |docs-badge| + +pip is the `package installer`_ for Python. You can use pip to install packages from the `Python Package Index`_ and other indexes. + +Please take a look at our documentation for how to install and use pip: + +* `Installation`_ +* `Usage`_ + +We release updates regularly, with a new version every 3 months. Find more details in our documentation: + +* `Release notes`_ +* `Release process`_ + +If you find bugs, need help, or want to talk to the developers, please use our mailing lists or chat rooms: + +* `Issue tracking`_ +* `Discourse channel`_ +* `User IRC`_ + +If you want to get involved head over to GitHub to get the source code, look at our development documentation and feel free to jump on the developer mailing lists and chat rooms: + +* `GitHub page`_ +* `Development documentation`_ +* `Development IRC`_ + +Code of Conduct +--------------- + +Everyone interacting in the pip project's codebases, issue trackers, chat +rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_. + +.. _package installer: https://packaging.python.org/guides/tool-recommendations/ +.. _Python Package Index: https://pypi.org +.. _Installation: https://pip.pypa.io/en/stable/installation/ +.. _Usage: https://pip.pypa.io/en/stable/ +.. _Release notes: https://pip.pypa.io/en/stable/news.html +.. _Release process: https://pip.pypa.io/en/latest/development/release-process/ +.. _GitHub page: https://github.com/pypa/pip +.. _Development documentation: https://pip.pypa.io/en/latest/development +.. _Issue tracking: https://github.com/pypa/pip/issues +.. _Discourse channel: https://discuss.python.org/c/packaging +.. _User IRC: https://kiwiirc.com/nextclient/#ircs://irc.libera.chat:+6697/pypa +.. _Development IRC: https://kiwiirc.com/nextclient/#ircs://irc.libera.chat:+6697/pypa-dev +.. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md diff --git a/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/RECORD b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/RECORD new file mode 100644 index 0000000..855f8d0 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/RECORD @@ -0,0 +1,854 @@ +../../../bin/pip,sha256=FutyofUvDTSdL-51SnntyG2Gn5STqKYjt2dATSUFIS8,242 +../../../bin/pip3,sha256=FutyofUvDTSdL-51SnntyG2Gn5STqKYjt2dATSUFIS8,242 +../../../bin/pip3.12,sha256=FutyofUvDTSdL-51SnntyG2Gn5STqKYjt2dATSUFIS8,242 +pip-25.0.1.dist-info/AUTHORS.txt,sha256=HqzpBVLfT1lBthqQfiDlVeFkg65hJ7ZQvvWhoq-BAsA,11018 +pip-25.0.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +pip-25.0.1.dist-info/LICENSE.txt,sha256=Y0MApmnUmurmWxLGxIySTFGkzfPR_whtw0VtyLyqIQQ,1093 +pip-25.0.1.dist-info/METADATA,sha256=T6cxjPMPl523zsRcEsu8K0-IoV8S7vv1mmKR0KA6-SY,3677 +pip-25.0.1.dist-info/RECORD,, +pip-25.0.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip-25.0.1.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91 +pip-25.0.1.dist-info/entry_points.txt,sha256=eeIjuzfnfR2PrhbjnbzFU6MnSS70kZLxwaHHq6M-bD0,87 +pip-25.0.1.dist-info/top_level.txt,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +pip/__init__.py,sha256=aKiv_sTe7UbE7qmtCinJutFjqN0MndZQZ1fKLNwFFLE,357 +pip/__main__.py,sha256=WzbhHXTbSE6gBY19mNN9m4s5o_365LOvTYSgqgbdBhE,854 +pip/__pip-runner__.py,sha256=cPPWuJ6NK_k-GzfvlejLFgwzmYUROmpAR6QC3Q-vkXQ,1450 +pip/__pycache__/__init__.cpython-312.pyc,, +pip/__pycache__/__main__.cpython-312.pyc,, +pip/__pycache__/__pip-runner__.cpython-312.pyc,, +pip/_internal/__init__.py,sha256=MfcoOluDZ8QMCFYal04IqOJ9q6m2V7a0aOsnI-WOxUo,513 +pip/_internal/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/__pycache__/build_env.cpython-312.pyc,, +pip/_internal/__pycache__/cache.cpython-312.pyc,, +pip/_internal/__pycache__/configuration.cpython-312.pyc,, +pip/_internal/__pycache__/exceptions.cpython-312.pyc,, +pip/_internal/__pycache__/main.cpython-312.pyc,, +pip/_internal/__pycache__/pyproject.cpython-312.pyc,, +pip/_internal/__pycache__/self_outdated_check.cpython-312.pyc,, +pip/_internal/__pycache__/wheel_builder.cpython-312.pyc,, +pip/_internal/build_env.py,sha256=Dv4UCClSg4uNaal_hL-trg5-zl3Is9CuIDxkChCkXF4,10700 +pip/_internal/cache.py,sha256=Jb698p5PNigRtpW5o26wQNkkUv4MnQ94mc471wL63A0,10369 +pip/_internal/cli/__init__.py,sha256=FkHBgpxxb-_gd6r1FjnNhfMOzAUYyXoXKJ6abijfcFU,132 +pip/_internal/cli/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/cli/__pycache__/autocompletion.cpython-312.pyc,, +pip/_internal/cli/__pycache__/base_command.cpython-312.pyc,, +pip/_internal/cli/__pycache__/cmdoptions.cpython-312.pyc,, +pip/_internal/cli/__pycache__/command_context.cpython-312.pyc,, +pip/_internal/cli/__pycache__/index_command.cpython-312.pyc,, +pip/_internal/cli/__pycache__/main.cpython-312.pyc,, +pip/_internal/cli/__pycache__/main_parser.cpython-312.pyc,, +pip/_internal/cli/__pycache__/parser.cpython-312.pyc,, +pip/_internal/cli/__pycache__/progress_bars.cpython-312.pyc,, +pip/_internal/cli/__pycache__/req_command.cpython-312.pyc,, +pip/_internal/cli/__pycache__/spinners.cpython-312.pyc,, +pip/_internal/cli/__pycache__/status_codes.cpython-312.pyc,, +pip/_internal/cli/autocompletion.py,sha256=Lli3Mr6aDNu7ZkJJFFvwD2-hFxNI6Avz8OwMyS5TVrs,6865 +pip/_internal/cli/base_command.py,sha256=NZin6KMzW9NSYzKk4Tc8isb_TQYKR4CKd5j9mSm46PI,8625 +pip/_internal/cli/cmdoptions.py,sha256=V3BB22F4_v_RkHaZ5onWnszhbBtjYZvNhbn9M0NO0HI,30116 +pip/_internal/cli/command_context.py,sha256=RHgIPwtObh5KhMrd3YZTkl8zbVG-6Okml7YbFX4Ehg0,774 +pip/_internal/cli/index_command.py,sha256=i_sgNlPmXC5iHUaY-dmmrHKKTgc5O4hWzisr5Al1rr0,5677 +pip/_internal/cli/main.py,sha256=BDZef-bWe9g9Jpr4OVs4dDf-845HJsKw835T7AqEnAc,2817 +pip/_internal/cli/main_parser.py,sha256=laDpsuBDl6kyfywp9eMMA9s84jfH2TJJn-vmL0GG90w,4338 +pip/_internal/cli/parser.py,sha256=VCMtduzECUV87KaHNu-xJ-wLNL82yT3x16V4XBxOAqI,10825 +pip/_internal/cli/progress_bars.py,sha256=9GcgusWtwfqou2zhAQp1XNbQHIDslqyyz9UwLzw7Jgc,2717 +pip/_internal/cli/req_command.py,sha256=DqeFhmUMs6o6Ev8qawAcOoYNdAZsfyKS0MZI5jsJYwQ,12250 +pip/_internal/cli/spinners.py,sha256=hIJ83GerdFgFCdobIA23Jggetegl_uC4Sp586nzFbPE,5118 +pip/_internal/cli/status_codes.py,sha256=sEFHUaUJbqv8iArL3HAtcztWZmGOFX01hTesSytDEh0,116 +pip/_internal/commands/__init__.py,sha256=5oRO9O3dM2vGuh0bFw4HOVletryrz5HHMmmPWwJrH9U,3882 +pip/_internal/commands/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/commands/__pycache__/cache.cpython-312.pyc,, +pip/_internal/commands/__pycache__/check.cpython-312.pyc,, +pip/_internal/commands/__pycache__/completion.cpython-312.pyc,, +pip/_internal/commands/__pycache__/configuration.cpython-312.pyc,, +pip/_internal/commands/__pycache__/debug.cpython-312.pyc,, +pip/_internal/commands/__pycache__/download.cpython-312.pyc,, +pip/_internal/commands/__pycache__/freeze.cpython-312.pyc,, +pip/_internal/commands/__pycache__/hash.cpython-312.pyc,, +pip/_internal/commands/__pycache__/help.cpython-312.pyc,, +pip/_internal/commands/__pycache__/index.cpython-312.pyc,, +pip/_internal/commands/__pycache__/inspect.cpython-312.pyc,, +pip/_internal/commands/__pycache__/install.cpython-312.pyc,, +pip/_internal/commands/__pycache__/list.cpython-312.pyc,, +pip/_internal/commands/__pycache__/search.cpython-312.pyc,, +pip/_internal/commands/__pycache__/show.cpython-312.pyc,, +pip/_internal/commands/__pycache__/uninstall.cpython-312.pyc,, +pip/_internal/commands/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/commands/cache.py,sha256=IOezTicHjGE5sWdBx2nwPVgbjuJHM3s-BZEkpZLemuY,8107 +pip/_internal/commands/check.py,sha256=Hr_4eiMd9cgVDgEvjtIdw915NmL7ROIWW8enkr8slPQ,2268 +pip/_internal/commands/completion.py,sha256=HT4lD0bgsflHq2IDgYfiEdp7IGGtE7s6MgI3xn0VQEw,4287 +pip/_internal/commands/configuration.py,sha256=n98enwp6y0b5G6fiRQjaZo43FlJKYve_daMhN-4BRNc,9766 +pip/_internal/commands/debug.py,sha256=DNDRgE9YsKrbYzU0s3VKi8rHtKF4X13CJ_br_8PUXO0,6797 +pip/_internal/commands/download.py,sha256=0qB0nys6ZEPsog451lDsjL5Bx7Z97t-B80oFZKhpzKM,5273 +pip/_internal/commands/freeze.py,sha256=2Vt72BYTSm9rzue6d8dNzt8idxWK4Db6Hd-anq7GQ80,3203 +pip/_internal/commands/hash.py,sha256=EVVOuvGtoPEdFi8SNnmdqlCQrhCxV-kJsdwtdcCnXGQ,1703 +pip/_internal/commands/help.py,sha256=gcc6QDkcgHMOuAn5UxaZwAStsRBrnGSn_yxjS57JIoM,1132 +pip/_internal/commands/index.py,sha256=RAXxmJwFhVb5S1BYzb5ifX3sn9Na8v2CCVYwSMP8pao,4731 +pip/_internal/commands/inspect.py,sha256=PGrY9TRTRCM3y5Ml8Bdk8DEOXquWRfscr4DRo1LOTPc,3189 +pip/_internal/commands/install.py,sha256=r3yHQUxvxt7gD5j9n6zRDslAvtx9CT_whLuQJcktp6M,29390 +pip/_internal/commands/list.py,sha256=oiIzSjLP6__d7dIS3q0Xb5ywsaOThBWRqMyjjKzkPdM,12769 +pip/_internal/commands/search.py,sha256=fWkUQVx_gm8ebbFAlCgqtxKXT9rNahpJ-BI__3HNZpg,5626 +pip/_internal/commands/show.py,sha256=0YBhCga3PAd81vT3l7UWflktSpB5-aYqQcJxBVPazVM,7857 +pip/_internal/commands/uninstall.py,sha256=7pOR7enK76gimyxQbzxcG1OsyLXL3DvX939xmM8Fvtg,3892 +pip/_internal/commands/wheel.py,sha256=eJRhr_qoNNxWAkkdJCNiQM7CXd4E1_YyQhsqJnBPGGg,6414 +pip/_internal/configuration.py,sha256=-KOok6jh3hFzXMPQFPJ1_EFjBpAsge-RSreQuLHLmzo,14005 +pip/_internal/distributions/__init__.py,sha256=Hq6kt6gXBgjNit5hTTWLAzeCNOKoB-N0pGYSqehrli8,858 +pip/_internal/distributions/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/distributions/__pycache__/base.cpython-312.pyc,, +pip/_internal/distributions/__pycache__/installed.cpython-312.pyc,, +pip/_internal/distributions/__pycache__/sdist.cpython-312.pyc,, +pip/_internal/distributions/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/distributions/base.py,sha256=QeB9qvKXDIjLdPBDE5fMgpfGqMMCr-govnuoQnGuiF8,1783 +pip/_internal/distributions/installed.py,sha256=QinHFbWAQ8oE0pbD8MFZWkwlnfU1QYTccA1vnhrlYOU,842 +pip/_internal/distributions/sdist.py,sha256=PlcP4a6-R6c98XnOM-b6Lkb3rsvh9iG4ok8shaanrzs,6751 +pip/_internal/distributions/wheel.py,sha256=THBYfnv7VVt8mYhMYUtH13S1E7FDwtDyDfmUcl8ai0E,1317 +pip/_internal/exceptions.py,sha256=2_byISIv3kSnI_9T-Esfxrt0LnTRgcUHyxu0twsHjQY,26481 +pip/_internal/index/__init__.py,sha256=vpt-JeTZefh8a-FC22ZeBSXFVbuBcXSGiILhQZJaNpQ,30 +pip/_internal/index/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/index/__pycache__/collector.cpython-312.pyc,, +pip/_internal/index/__pycache__/package_finder.cpython-312.pyc,, +pip/_internal/index/__pycache__/sources.cpython-312.pyc,, +pip/_internal/index/collector.py,sha256=RdPO0JLAlmyBWPAWYHPyRoGjz3GNAeTngCNkbGey_mE,16265 +pip/_internal/index/package_finder.py,sha256=mJHAljlHeHuclyuxtjvBZO6DtovKjsZjF_tCh_wux5E,38076 +pip/_internal/index/sources.py,sha256=lPBLK5Xiy8Q6IQMio26Wl7ocfZOKkgGklIBNyUJ23fI,8632 +pip/_internal/locations/__init__.py,sha256=UaAxeZ_f93FyouuFf4p7SXYF-4WstXuEvd3LbmPCAno,14925 +pip/_internal/locations/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/locations/__pycache__/_distutils.cpython-312.pyc,, +pip/_internal/locations/__pycache__/_sysconfig.cpython-312.pyc,, +pip/_internal/locations/__pycache__/base.cpython-312.pyc,, +pip/_internal/locations/_distutils.py,sha256=x6nyVLj7X11Y4khIdf-mFlxMl2FWadtVEgeb8upc_WI,6013 +pip/_internal/locations/_sysconfig.py,sha256=IGzds60qsFneRogC-oeBaY7bEh3lPt_v47kMJChQXsU,7724 +pip/_internal/locations/base.py,sha256=RQiPi1d4FVM2Bxk04dQhXZ2PqkeljEL2fZZ9SYqIQ78,2556 +pip/_internal/main.py,sha256=r-UnUe8HLo5XFJz8inTcOOTiu_sxNhgHb6VwlGUllOI,340 +pip/_internal/metadata/__init__.py,sha256=CU8jK1TZso7jOLdr0sX9xDjrcs5iy8d7IRK-hvaIO5Y,4337 +pip/_internal/metadata/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/metadata/__pycache__/_json.cpython-312.pyc,, +pip/_internal/metadata/__pycache__/base.cpython-312.pyc,, +pip/_internal/metadata/__pycache__/pkg_resources.cpython-312.pyc,, +pip/_internal/metadata/_json.py,sha256=ezrIYazHCINM2QUk1eA9wEAMj3aeGWeDVgGalgUzKpc,2707 +pip/_internal/metadata/base.py,sha256=ft0K5XNgI4ETqZnRv2-CtvgYiMOMAeGMAzxT-f6VLJA,25298 +pip/_internal/metadata/importlib/__init__.py,sha256=jUUidoxnHcfITHHaAWG1G2i5fdBYklv_uJcjo2x7VYE,135 +pip/_internal/metadata/importlib/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/metadata/importlib/__pycache__/_compat.cpython-312.pyc,, +pip/_internal/metadata/importlib/__pycache__/_dists.cpython-312.pyc,, +pip/_internal/metadata/importlib/__pycache__/_envs.cpython-312.pyc,, +pip/_internal/metadata/importlib/_compat.py,sha256=c6av8sP8BBjAZuFSJow1iWfygUXNM3xRTCn5nqw6B9M,2796 +pip/_internal/metadata/importlib/_dists.py,sha256=ftmYiyfUGUIjnVwt6W-Ijsimy5c28KgmXly5Q5IQ2P4,8279 +pip/_internal/metadata/importlib/_envs.py,sha256=UUB980XSrDWrMpQ1_G45i0r8Hqlg_tg3IPQ63mEqbNc,7431 +pip/_internal/metadata/pkg_resources.py,sha256=U07ETAINSGeSRBfWUG93E4tZZbaW_f7PGzEqZN0hulc,10542 +pip/_internal/models/__init__.py,sha256=3DHUd_qxpPozfzouoqa9g9ts1Czr5qaHfFxbnxriepM,63 +pip/_internal/models/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/models/__pycache__/candidate.cpython-312.pyc,, +pip/_internal/models/__pycache__/direct_url.cpython-312.pyc,, +pip/_internal/models/__pycache__/format_control.cpython-312.pyc,, +pip/_internal/models/__pycache__/index.cpython-312.pyc,, +pip/_internal/models/__pycache__/installation_report.cpython-312.pyc,, +pip/_internal/models/__pycache__/link.cpython-312.pyc,, +pip/_internal/models/__pycache__/scheme.cpython-312.pyc,, +pip/_internal/models/__pycache__/search_scope.cpython-312.pyc,, +pip/_internal/models/__pycache__/selection_prefs.cpython-312.pyc,, +pip/_internal/models/__pycache__/target_python.cpython-312.pyc,, +pip/_internal/models/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/models/candidate.py,sha256=zzgFRuw_kWPjKpGw7LC0ZUMD2CQ2EberUIYs8izjdCA,753 +pip/_internal/models/direct_url.py,sha256=uBtY2HHd3TO9cKQJWh0ThvE5FRr-MWRYChRU4IG9HZE,6578 +pip/_internal/models/format_control.py,sha256=wtsQqSK9HaUiNxQEuB-C62eVimw6G4_VQFxV9-_KDBE,2486 +pip/_internal/models/index.py,sha256=tYnL8oxGi4aSNWur0mG8DAP7rC6yuha_MwJO8xw0crI,1030 +pip/_internal/models/installation_report.py,sha256=zRVZoaz-2vsrezj_H3hLOhMZCK9c7TbzWgC-jOalD00,2818 +pip/_internal/models/link.py,sha256=GQ8hq7x-FDFPv25Nbn2veIM-MlBrGZDGLd7aZeF4Xrg,21448 +pip/_internal/models/scheme.py,sha256=PakmHJM3e8OOWSZFtfz1Az7f1meONJnkGuQxFlt3wBE,575 +pip/_internal/models/search_scope.py,sha256=67NEnsYY84784S-MM7ekQuo9KXLH-7MzFntXjapvAo0,4531 +pip/_internal/models/selection_prefs.py,sha256=qaFfDs3ciqoXPg6xx45N1jPLqccLJw4N0s4P0PyHTQ8,2015 +pip/_internal/models/target_python.py,sha256=2XaH2rZ5ZF-K5wcJbEMGEl7SqrTToDDNkrtQ2v_v_-Q,4271 +pip/_internal/models/wheel.py,sha256=G7dND_s4ebPkEL7RJ1qCY0QhUUWIIK6AnjWgRATF5no,4539 +pip/_internal/network/__init__.py,sha256=jf6Tt5nV_7zkARBrKojIXItgejvoegVJVKUbhAa5Ioc,50 +pip/_internal/network/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/network/__pycache__/auth.cpython-312.pyc,, +pip/_internal/network/__pycache__/cache.cpython-312.pyc,, +pip/_internal/network/__pycache__/download.cpython-312.pyc,, +pip/_internal/network/__pycache__/lazy_wheel.cpython-312.pyc,, +pip/_internal/network/__pycache__/session.cpython-312.pyc,, +pip/_internal/network/__pycache__/utils.cpython-312.pyc,, +pip/_internal/network/__pycache__/xmlrpc.cpython-312.pyc,, +pip/_internal/network/auth.py,sha256=D4gASjUrqoDFlSt6gQ767KAAjv6PUyJU0puDlhXNVRE,20809 +pip/_internal/network/cache.py,sha256=0yGMA3Eet59xBSLtbPAenvI53dl29oUOeqZ2c0QL2Ss,4614 +pip/_internal/network/download.py,sha256=FLOP29dPYECBiAi7eEjvAbNkyzaKNqbyjOT2m8HPW8U,6048 +pip/_internal/network/lazy_wheel.py,sha256=PBdoMoNQQIA84Fhgne38jWF52W4x_KtsHjxgv4dkRKA,7622 +pip/_internal/network/session.py,sha256=msM4es16LmmNEYNkrYyg8fTc7gAHbKFltawfKP27LOI,18771 +pip/_internal/network/utils.py,sha256=Inaxel-NxBu4PQWkjyErdnfewsFCcgHph7dzR1-FboY,4088 +pip/_internal/network/xmlrpc.py,sha256=sAxzOacJ-N1NXGPvap9jC3zuYWSnnv3GXtgR2-E2APA,1838 +pip/_internal/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/operations/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/operations/__pycache__/check.cpython-312.pyc,, +pip/_internal/operations/__pycache__/freeze.cpython-312.pyc,, +pip/_internal/operations/__pycache__/prepare.cpython-312.pyc,, +pip/_internal/operations/build/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/operations/build/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/build_tracker.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/metadata.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/metadata_editable.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/wheel_editable.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/wheel_legacy.cpython-312.pyc,, +pip/_internal/operations/build/build_tracker.py,sha256=-ARW_TcjHCOX7D2NUOGntB4Fgc6b4aolsXkAK6BWL7w,4774 +pip/_internal/operations/build/metadata.py,sha256=9S0CUD8U3QqZeXp-Zyt8HxwU90lE4QrnYDgrqZDzBnc,1422 +pip/_internal/operations/build/metadata_editable.py,sha256=xlAwcP9q_8_fmv_3I39w9EZ7SQV9hnJZr9VuTsq2Y68,1510 +pip/_internal/operations/build/metadata_legacy.py,sha256=8i6i1QZX9m_lKPStEFsHKM0MT4a-CD408JOw99daLmo,2190 +pip/_internal/operations/build/wheel.py,sha256=sT12FBLAxDC6wyrDorh8kvcZ1jG5qInCRWzzP-UkJiQ,1075 +pip/_internal/operations/build/wheel_editable.py,sha256=yOtoH6zpAkoKYEUtr8FhzrYnkNHQaQBjWQ2HYae1MQg,1417 +pip/_internal/operations/build/wheel_legacy.py,sha256=K-6kNhmj-1xDF45ny1yheMerF0ui4EoQCLzEoHh6-tc,3045 +pip/_internal/operations/check.py,sha256=L24vRL8VWbyywdoeAhM89WCd8zLTnjIbULlKelUgIec,5912 +pip/_internal/operations/freeze.py,sha256=1_M79jAQKnCxWr-KCCmHuVXOVFGaUJHmoWLfFzgh7K4,9843 +pip/_internal/operations/install/__init__.py,sha256=mX7hyD2GNBO2mFGokDQ30r_GXv7Y_PLdtxcUv144e-s,51 +pip/_internal/operations/install/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/operations/install/__pycache__/editable_legacy.cpython-312.pyc,, +pip/_internal/operations/install/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/operations/install/editable_legacy.py,sha256=PoEsNEPGbIZ2yQphPsmYTKLOCMs4gv5OcCdzW124NcA,1283 +pip/_internal/operations/install/wheel.py,sha256=X5Iz9yUg5LlK5VNQ9g2ikc6dcRu8EPi_SUi5iuEDRgo,27615 +pip/_internal/operations/prepare.py,sha256=joWJwPkuqGscQgVNImLK71e9hRapwKvRCM8HclysmvU,28118 +pip/_internal/pyproject.py,sha256=GLJ6rWRS5_2noKdajohoLyDty57Z7QXhcUAYghmTnWc,7286 +pip/_internal/req/__init__.py,sha256=HxBFtZy_BbCclLgr26waMtpzYdO5T3vxePvpGAXSt5s,2653 +pip/_internal/req/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/req/__pycache__/constructors.cpython-312.pyc,, +pip/_internal/req/__pycache__/req_file.cpython-312.pyc,, +pip/_internal/req/__pycache__/req_install.cpython-312.pyc,, +pip/_internal/req/__pycache__/req_set.cpython-312.pyc,, +pip/_internal/req/__pycache__/req_uninstall.cpython-312.pyc,, +pip/_internal/req/constructors.py,sha256=v1qzCN1mIldwx-nCrPc8JO4lxkm3Fv8M5RWvt8LISjc,18430 +pip/_internal/req/req_file.py,sha256=eys82McgaICOGic2UZRHjD720piKJPwmeSYdXlWwl6w,20234 +pip/_internal/req/req_install.py,sha256=BMptxHYg2uG_b-7HFEULPb3nuw0FMAbuea8zTq2rE7w,35786 +pip/_internal/req/req_set.py,sha256=j3esG0s6SzoVReX9rWn4rpYNtyET_fwxbwJPRimvRxo,2858 +pip/_internal/req/req_uninstall.py,sha256=qzDIxJo-OETWqGais7tSMCDcWbATYABT-Tid3ityF0s,23853 +pip/_internal/resolution/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/resolution/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/resolution/__pycache__/base.cpython-312.pyc,, +pip/_internal/resolution/base.py,sha256=qlmh325SBVfvG6Me9gc5Nsh5sdwHBwzHBq6aEXtKsLA,583 +pip/_internal/resolution/legacy/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/resolution/legacy/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/resolution/legacy/__pycache__/resolver.cpython-312.pyc,, +pip/_internal/resolution/legacy/resolver.py,sha256=3HZiJBRd1FTN6jQpI4qRO8-TbLYeIbUTS6PFvXnXs2w,24068 +pip/_internal/resolution/resolvelib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/resolution/resolvelib/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/base.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/candidates.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/factory.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/found_candidates.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/provider.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/reporter.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/requirements.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/resolver.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/base.py,sha256=DCf669FsqyQY5uqXeePDHQY1e4QO-pBzWH8O0s9-K94,5023 +pip/_internal/resolution/resolvelib/candidates.py,sha256=5UZ1upNnmqsP-nmEZaDYxaBgCoejw_e2WVGmmAvBxXc,20001 +pip/_internal/resolution/resolvelib/factory.py,sha256=MJOLSZJY8_28PPdcutoQ6gjJ_1eBDt6Z1edtfTJyR4E,32659 +pip/_internal/resolution/resolvelib/found_candidates.py,sha256=9hrTyQqFvl9I7Tji79F1AxHv39Qh1rkJ_7deSHSMfQc,6383 +pip/_internal/resolution/resolvelib/provider.py,sha256=bcsFnYvlmtB80cwVdW1fIwgol8ZNr1f1VHyRTkz47SM,9935 +pip/_internal/resolution/resolvelib/reporter.py,sha256=00JtoXEkTlw0-rl_sl54d71avwOsJHt9GGHcrj5Sza0,3168 +pip/_internal/resolution/resolvelib/requirements.py,sha256=7JG4Z72e5Yk4vU0S5ulGvbqTy4FMQGYhY5zQhX9zTtY,8065 +pip/_internal/resolution/resolvelib/resolver.py,sha256=nLJOsVMEVi2gQUVJoUFKMZAeu2f7GRMjGMvNSWyz0Bc,12592 +pip/_internal/self_outdated_check.py,sha256=1PFtttvLAeyCVR3tPoBq2sOlPD0IJ-KSqU6bc1HUk9c,8318 +pip/_internal/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/utils/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/utils/__pycache__/_jaraco_text.cpython-312.pyc,, +pip/_internal/utils/__pycache__/_log.cpython-312.pyc,, +pip/_internal/utils/__pycache__/appdirs.cpython-312.pyc,, +pip/_internal/utils/__pycache__/compat.cpython-312.pyc,, +pip/_internal/utils/__pycache__/compatibility_tags.cpython-312.pyc,, +pip/_internal/utils/__pycache__/datetime.cpython-312.pyc,, +pip/_internal/utils/__pycache__/deprecation.cpython-312.pyc,, +pip/_internal/utils/__pycache__/direct_url_helpers.cpython-312.pyc,, +pip/_internal/utils/__pycache__/egg_link.cpython-312.pyc,, +pip/_internal/utils/__pycache__/entrypoints.cpython-312.pyc,, +pip/_internal/utils/__pycache__/filesystem.cpython-312.pyc,, +pip/_internal/utils/__pycache__/filetypes.cpython-312.pyc,, +pip/_internal/utils/__pycache__/glibc.cpython-312.pyc,, +pip/_internal/utils/__pycache__/hashes.cpython-312.pyc,, +pip/_internal/utils/__pycache__/logging.cpython-312.pyc,, +pip/_internal/utils/__pycache__/misc.cpython-312.pyc,, +pip/_internal/utils/__pycache__/packaging.cpython-312.pyc,, +pip/_internal/utils/__pycache__/retry.cpython-312.pyc,, +pip/_internal/utils/__pycache__/setuptools_build.cpython-312.pyc,, +pip/_internal/utils/__pycache__/subprocess.cpython-312.pyc,, +pip/_internal/utils/__pycache__/temp_dir.cpython-312.pyc,, +pip/_internal/utils/__pycache__/unpacking.cpython-312.pyc,, +pip/_internal/utils/__pycache__/urls.cpython-312.pyc,, +pip/_internal/utils/__pycache__/virtualenv.cpython-312.pyc,, +pip/_internal/utils/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/utils/_jaraco_text.py,sha256=M15uUPIh5NpP1tdUGBxRau6q1ZAEtI8-XyLEETscFfE,3350 +pip/_internal/utils/_log.py,sha256=-jHLOE_THaZz5BFcCnoSL9EYAtJ0nXem49s9of4jvKw,1015 +pip/_internal/utils/appdirs.py,sha256=swgcTKOm3daLeXTW6v5BUS2Ti2RvEnGRQYH_yDXklAo,1665 +pip/_internal/utils/compat.py,sha256=ckkFveBiYQjRWjkNsajt_oWPS57tJvE8XxoC4OIYgCY,2399 +pip/_internal/utils/compatibility_tags.py,sha256=OWq5axHpW-MEEPztGdvgADrgJPAcV9a88Rxm4Z8VBs8,6272 +pip/_internal/utils/datetime.py,sha256=m21Y3wAtQc-ji6Veb6k_M5g6A0ZyFI4egchTdnwh-pQ,242 +pip/_internal/utils/deprecation.py,sha256=k7Qg_UBAaaTdyq82YVARA6D7RmcGTXGv7fnfcgigj4Q,3707 +pip/_internal/utils/direct_url_helpers.py,sha256=r2MRtkVDACv9AGqYODBUC9CjwgtsUU1s68hmgfCJMtA,3196 +pip/_internal/utils/egg_link.py,sha256=0FePZoUYKv4RGQ2t6x7w5Z427wbA_Uo3WZnAkrgsuqo,2463 +pip/_internal/utils/entrypoints.py,sha256=YlhLTRl2oHBAuqhc-zmL7USS67TPWVHImjeAQHreZTQ,3064 +pip/_internal/utils/filesystem.py,sha256=ajvA-q4ocliW9kPp8Yquh-4vssXbu-UKbo5FV9V4X64,4950 +pip/_internal/utils/filetypes.py,sha256=i8XAQ0eFCog26Fw9yV0Yb1ygAqKYB1w9Cz9n0fj8gZU,716 +pip/_internal/utils/glibc.py,sha256=vUkWq_1pJuzcYNcGKLlQmABoUiisK8noYY1yc8Wq4w4,3734 +pip/_internal/utils/hashes.py,sha256=XGGLL0AG8-RhWnyz87xF6MFZ--BKadHU35D47eApCKI,4972 +pip/_internal/utils/logging.py,sha256=ONfbrhaD248akkosK79if97n20EABxwjOxp5dE5RCRY,11845 +pip/_internal/utils/misc.py,sha256=DWnYxBUItjRp7hhxEg4ih6P6YpKrykM86dbi_EcU8SQ,23450 +pip/_internal/utils/packaging.py,sha256=cm-X_0HVHV_jRwUVZh6AuEWqSitzf8EpaJ7Uv2UGu6A,2142 +pip/_internal/utils/retry.py,sha256=mhFbykXjhTnZfgzeuy-vl9c8nECnYn_CMtwNJX2tYzQ,1392 +pip/_internal/utils/setuptools_build.py,sha256=ouXpud-jeS8xPyTPsXJ-m34NPvK5os45otAzdSV_IJE,4435 +pip/_internal/utils/subprocess.py,sha256=EsvqSRiSMHF98T8Txmu6NLU3U--MpTTQjtNgKP0P--M,8988 +pip/_internal/utils/temp_dir.py,sha256=5qOXe8M4JeY6vaFQM867d5zkp1bSwMZ-KT5jymmP0Zg,9310 +pip/_internal/utils/unpacking.py,sha256=_gVdyzTRDMYktpnYljn4OoxrZTtMCf4xknSm4rK0WaA,11967 +pip/_internal/utils/urls.py,sha256=qceSOZb5lbNDrHNsv7_S4L4Ytszja5NwPKUMnZHbYnM,1599 +pip/_internal/utils/virtualenv.py,sha256=S6f7csYorRpiD6cvn3jISZYc3I8PJC43H5iMFpRAEDU,3456 +pip/_internal/utils/wheel.py,sha256=b442jkydFHjXzDy6cMR7MpzWBJ1Q82hR5F33cmcHV3g,4494 +pip/_internal/vcs/__init__.py,sha256=UAqvzpbi0VbZo3Ub6skEeZAw-ooIZR-zX_WpCbxyCoU,596 +pip/_internal/vcs/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/bazaar.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/git.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/mercurial.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/subversion.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/versioncontrol.cpython-312.pyc,, +pip/_internal/vcs/bazaar.py,sha256=EKStcQaKpNu0NK4p5Q10Oc4xb3DUxFw024XrJy40bFQ,3528 +pip/_internal/vcs/git.py,sha256=3tpc9LQA_J4IVW5r5NvWaaSeDzcmJOrSFZN0J8vIKfU,18177 +pip/_internal/vcs/mercurial.py,sha256=oULOhzJ2Uie-06d1omkL-_Gc6meGaUkyogvqG9ZCyPs,5249 +pip/_internal/vcs/subversion.py,sha256=ddTugHBqHzV3ebKlU5QXHPN4gUqlyXbOx8q8NgXKvs8,11735 +pip/_internal/vcs/versioncontrol.py,sha256=cvf_-hnTAjQLXJ3d17FMNhQfcO1AcKWUF10tfrYyP-c,22440 +pip/_internal/wheel_builder.py,sha256=DL3A8LKeRj_ACp11WS5wSgASgPFqeyAeXJKdXfmaWXU,11799 +pip/_vendor/__init__.py,sha256=JYuAXvClhInxIrA2FTp5p-uuWVL7WV6-vEpTs46-Qh4,4873 +pip/_vendor/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/__pycache__/typing_extensions.cpython-312.pyc,, +pip/_vendor/cachecontrol/__init__.py,sha256=LMC5CBe94ZRL5xhlzwyPDmHXvBD0p7lT4R3Z73D6a_I,677 +pip/_vendor/cachecontrol/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/adapter.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/cache.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/controller.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/serialize.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-312.pyc,, +pip/_vendor/cachecontrol/_cmd.py,sha256=iist2EpzJvDVIhMAxXq8iFnTBsiZAd6iplxfmNboNyk,1737 +pip/_vendor/cachecontrol/adapter.py,sha256=febjY4LV87iiCIK3jcl8iH58iaSA7b9WkovsByIDK0Y,6348 +pip/_vendor/cachecontrol/cache.py,sha256=OXwv7Fn2AwnKNiahJHnjtvaKLndvVLv_-zO-ltlV9qI,1953 +pip/_vendor/cachecontrol/caches/__init__.py,sha256=dtrrroK5BnADR1GWjCZ19aZ0tFsMfvFBtLQQU1sp_ag,303 +pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-312.pyc,, +pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-312.pyc,, +pip/_vendor/cachecontrol/caches/file_cache.py,sha256=b7oMgsRSqPmEsonVJw6uFEYUlFgD6GF8TyacOGG1x3M,5399 +pip/_vendor/cachecontrol/caches/redis_cache.py,sha256=9rmqwtYu_ljVkW6_oLqbC7EaX_a8YT_yLuna-eS0dgo,1386 +pip/_vendor/cachecontrol/controller.py,sha256=glbPj2iZlGqdBg8z09D2DtQOzoOGXnWvy7K2LEyBsEQ,18576 +pip/_vendor/cachecontrol/filewrapper.py,sha256=2ktXNPE0KqnyzF24aOsKCA58HQq1xeC6l2g6_zwjghc,4291 +pip/_vendor/cachecontrol/heuristics.py,sha256=gqMXU8w0gQuEQiSdu3Yg-0vd9kW7nrWKbLca75rheGE,4881 +pip/_vendor/cachecontrol/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/cachecontrol/serialize.py,sha256=HQd2IllQ05HzPkVLMXTF2uX5mjEQjDBkxCqUJUODpZk,5163 +pip/_vendor/cachecontrol/wrapper.py,sha256=hsGc7g8QGQTT-4f8tgz3AM5qwScg6FO0BSdLSRdEvpU,1417 +pip/_vendor/certifi/__init__.py,sha256=p_GYZrjUwPBUhpLlCZoGb0miKBKSqDAyZC5DvIuqbHQ,94 +pip/_vendor/certifi/__main__.py,sha256=1k3Cr95vCxxGRGDljrW3wMdpZdL3Nhf0u1n-k2qdsCY,255 +pip/_vendor/certifi/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/certifi/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/certifi/__pycache__/core.cpython-312.pyc,, +pip/_vendor/certifi/cacert.pem,sha256=lO3rZukXdPyuk6BWUJFOKQliWaXH6HGh9l1GGrUgG0c,299427 +pip/_vendor/certifi/core.py,sha256=2SRT5rIcQChFDbe37BQa-kULxAgJ8qN6l1jfqTp4HIs,4486 +pip/_vendor/certifi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/distlib/__init__.py,sha256=dcwgYGYGQqAEawBXPDtIx80DO_3cOmFv8HTc8JMzknQ,625 +pip/_vendor/distlib/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/compat.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/database.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/index.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/locators.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/manifest.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/markers.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/metadata.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/resources.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/scripts.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/util.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/version.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/wheel.cpython-312.pyc,, +pip/_vendor/distlib/compat.py,sha256=2jRSjRI4o-vlXeTK2BCGIUhkc6e9ZGhSsacRM5oseTw,41467 +pip/_vendor/distlib/database.py,sha256=mHy_LxiXIsIVRb-T0-idBrVLw3Ffij5teHCpbjmJ9YU,51160 +pip/_vendor/distlib/index.py,sha256=lTbw268rRhj8dw1sib3VZ_0EhSGgoJO3FKJzSFMOaeA,20797 +pip/_vendor/distlib/locators.py,sha256=oBeAZpFuPQSY09MgNnLfQGGAXXvVO96BFpZyKMuK4tM,51026 +pip/_vendor/distlib/manifest.py,sha256=3qfmAmVwxRqU1o23AlfXrQGZzh6g_GGzTAP_Hb9C5zQ,14168 +pip/_vendor/distlib/markers.py,sha256=X6sDvkFGcYS8gUW8hfsWuKEKAqhQZAJ7iXOMLxRYjYk,5164 +pip/_vendor/distlib/metadata.py,sha256=zil3sg2EUfLXVigljY2d_03IJt-JSs7nX-73fECMX2s,38724 +pip/_vendor/distlib/resources.py,sha256=LwbPksc0A1JMbi6XnuPdMBUn83X7BPuFNWqPGEKI698,10820 +pip/_vendor/distlib/scripts.py,sha256=BJliaDAZaVB7WAkwokgC3HXwLD2iWiHaVI50H7C6eG8,18608 +pip/_vendor/distlib/t32.exe,sha256=a0GV5kCoWsMutvliiCKmIgV98eRZ33wXoS-XrqvJQVs,97792 +pip/_vendor/distlib/t64-arm.exe,sha256=68TAa32V504xVBnufojh0PcenpR3U4wAqTqf-MZqbPw,182784 +pip/_vendor/distlib/t64.exe,sha256=gaYY8hy4fbkHYTTnA4i26ct8IQZzkBG2pRdy0iyuBrc,108032 +pip/_vendor/distlib/util.py,sha256=vMPGvsS4j9hF6Y9k3Tyom1aaHLb0rFmZAEyzeAdel9w,66682 +pip/_vendor/distlib/version.py,sha256=s5VIs8wBn0fxzGxWM_aA2ZZyx525HcZbMvcTlTyZ3Rg,23727 +pip/_vendor/distlib/w32.exe,sha256=R4csx3-OGM9kL4aPIzQKRo5TfmRSHZo6QWyLhDhNBks,91648 +pip/_vendor/distlib/w64-arm.exe,sha256=xdyYhKj0WDcVUOCb05blQYvzdYIKMbmJn2SZvzkcey4,168448 +pip/_vendor/distlib/w64.exe,sha256=ejGf-rojoBfXseGLpya6bFTFPWRG21X5KvU8J5iU-K0,101888 +pip/_vendor/distlib/wheel.py,sha256=DFIVguEQHCdxnSdAO0dfFsgMcvVZitg7bCOuLwZ7A_s,43979 +pip/_vendor/distro/__init__.py,sha256=2fHjF-SfgPvjyNZ1iHh_wjqWdR_Yo5ODHwZC0jLBPhc,981 +pip/_vendor/distro/__main__.py,sha256=bu9d3TifoKciZFcqRBuygV3GSuThnVD_m2IK4cz96Vs,64 +pip/_vendor/distro/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/distro/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/distro/__pycache__/distro.cpython-312.pyc,, +pip/_vendor/distro/distro.py,sha256=XqbefacAhDT4zr_trnbA15eY8vdK4GTghgmvUGrEM_4,49430 +pip/_vendor/distro/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/idna/__init__.py,sha256=MPqNDLZbXqGaNdXxAFhiqFPKEQXju2jNQhCey6-5eJM,868 +pip/_vendor/idna/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/codec.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/compat.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/core.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/idnadata.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/intranges.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/package_data.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/uts46data.cpython-312.pyc,, +pip/_vendor/idna/codec.py,sha256=PEew3ItwzjW4hymbasnty2N2OXvNcgHB-JjrBuxHPYY,3422 +pip/_vendor/idna/compat.py,sha256=RzLy6QQCdl9784aFhb2EX9EKGCJjg0P3PilGdeXXcx8,316 +pip/_vendor/idna/core.py,sha256=YJYyAMnwiQEPjVC4-Fqu_p4CJ6yKKuDGmppBNQNQpFs,13239 +pip/_vendor/idna/idnadata.py,sha256=W30GcIGvtOWYwAjZj4ZjuouUutC6ffgNuyjJy7fZ-lo,78306 +pip/_vendor/idna/intranges.py,sha256=amUtkdhYcQG8Zr-CoMM_kVRacxkivC1WgxN1b63KKdU,1898 +pip/_vendor/idna/package_data.py,sha256=q59S3OXsc5VI8j6vSD0sGBMyk6zZ4vWFREE88yCJYKs,21 +pip/_vendor/idna/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/idna/uts46data.py,sha256=rt90K9J40gUSwppDPCrhjgi5AA6pWM65dEGRSf6rIhM,239289 +pip/_vendor/msgpack/__init__.py,sha256=reRaiOtEzSjPnr7TpxjgIvbfln5pV66FhricAs2eC-g,1109 +pip/_vendor/msgpack/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/msgpack/__pycache__/exceptions.cpython-312.pyc,, +pip/_vendor/msgpack/__pycache__/ext.cpython-312.pyc,, +pip/_vendor/msgpack/__pycache__/fallback.cpython-312.pyc,, +pip/_vendor/msgpack/exceptions.py,sha256=dCTWei8dpkrMsQDcjQk74ATl9HsIBH0ybt8zOPNqMYc,1081 +pip/_vendor/msgpack/ext.py,sha256=kteJv03n9tYzd5oo3xYopVTo4vRaAxonBQQJhXohZZo,5726 +pip/_vendor/msgpack/fallback.py,sha256=0g1Pzp0vtmBEmJ5w9F3s_-JMVURP8RS4G1cc5TRaAsI,32390 +pip/_vendor/packaging/__init__.py,sha256=dk4Ta_vmdVJxYHDcfyhvQNw8V3PgSBomKNXqg-D2JDY,494 +pip/_vendor/packaging/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_manylinux.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_parser.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_structures.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/markers.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/metadata.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/requirements.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/tags.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/utils.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/version.cpython-312.pyc,, +pip/_vendor/packaging/_elffile.py,sha256=cflAQAkE25tzhYmq_aCi72QfbT_tn891tPzfpbeHOwE,3306 +pip/_vendor/packaging/_manylinux.py,sha256=vl5OCoz4kx80H5rwXKeXWjl9WNISGmr4ZgTpTP9lU9c,9612 +pip/_vendor/packaging/_musllinux.py,sha256=p9ZqNYiOItGee8KcZFeHF_YcdhVwGHdK6r-8lgixvGQ,2694 +pip/_vendor/packaging/_parser.py,sha256=s_TvTvDNK0NrM2QB3VKThdWFM4Nc0P6JnkObkl3MjpM,10236 +pip/_vendor/packaging/_structures.py,sha256=q3eVNmbWJGG_S0Dit_S3Ao8qQqz_5PYTXFAKBZe5yr4,1431 +pip/_vendor/packaging/_tokenizer.py,sha256=J6v5H7Jzvb-g81xp_2QACKwO7LxHQA6ikryMU7zXwN8,5273 +pip/_vendor/packaging/licenses/__init__.py,sha256=A116-FU49_Dz4162M4y1uAiZN4Rgdc83FxNd8EjlfqI,5727 +pip/_vendor/packaging/licenses/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/packaging/licenses/__pycache__/_spdx.cpython-312.pyc,, +pip/_vendor/packaging/licenses/_spdx.py,sha256=oAm1ztPFwlsmCKe7lAAsv_OIOfS1cWDu9bNBkeu-2ns,48398 +pip/_vendor/packaging/markers.py,sha256=c89TNzB7ZdGYhkovm6PYmqGyHxXlYVaLW591PHUNKD8,10561 +pip/_vendor/packaging/metadata.py,sha256=YJibM7GYe4re8-0a3OlXmGS-XDgTEoO4tlBt2q25Bng,34762 +pip/_vendor/packaging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/packaging/requirements.py,sha256=gYyRSAdbrIyKDY66ugIDUQjRMvxkH2ALioTmX3tnL6o,2947 +pip/_vendor/packaging/specifiers.py,sha256=hGU6kuCd77bL-msIL6yLCp6MNT75RSMUKZDuju26c8U,40098 +pip/_vendor/packaging/tags.py,sha256=CFqrJzAzc2XNGexerH__T-Y5Iwq7WbsYXsiLERLWxY0,21014 +pip/_vendor/packaging/utils.py,sha256=0F3Hh9OFuRgrhTgGZUl5K22Fv1YP2tZl1z_2gO6kJiA,5050 +pip/_vendor/packaging/version.py,sha256=oiHqzTUv_p12hpjgsLDVcaF5hT7pDaSOViUNMD4GTW0,16688 +pip/_vendor/pkg_resources/__init__.py,sha256=jrhDRbOubP74QuPXxd7U7Po42PH2l-LZ2XfcO7llpZ4,124463 +pip/_vendor/pkg_resources/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/platformdirs/__init__.py,sha256=JueR2cRLkxY7iwik-qNWJCwKOrAlBgVgcZ_IHQzqGLE,22344 +pip/_vendor/platformdirs/__main__.py,sha256=jBJ8zb7Mpx5ebcqF83xrpO94MaeCpNGHVf9cvDN2JLg,1505 +pip/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/android.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/api.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/unix.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/version.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc,, +pip/_vendor/platformdirs/android.py,sha256=kV5oL3V3DZ6WZKu9yFiQupv18yp_jlSV2ChH1TmPcds,9007 +pip/_vendor/platformdirs/api.py,sha256=2dfUDNbEXeDhDKarqtR5NY7oUikUZ4RZhs3ozstmhBQ,9246 +pip/_vendor/platformdirs/macos.py,sha256=UlbyFZ8Rzu3xndCqQEHrfsYTeHwYdFap1Ioz-yxveT4,6154 +pip/_vendor/platformdirs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/platformdirs/unix.py,sha256=uRPJWRyQEtv7yOSvU94rUmsblo5XKDLA1SzFg55kbK0,10393 +pip/_vendor/platformdirs/version.py,sha256=oH4KgTfK4AklbTYVcV_yynvJ9JLI3pyvDVay0hRsLCs,411 +pip/_vendor/platformdirs/windows.py,sha256=IFpiohUBwxPtCzlyKwNtxyW4Jk8haa6W8o59mfrDXVo,10125 +pip/_vendor/pygments/__init__.py,sha256=7N1oiaWulw_nCsTY4EEixYLz15pWY5u4uPAFFi-ielU,2983 +pip/_vendor/pygments/__main__.py,sha256=isIhBxLg65nLlXukG4VkMuPfNdd7gFzTZ_R_z3Q8diY,353 +pip/_vendor/pygments/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/cmdline.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/console.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/filter.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/formatter.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/lexer.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/modeline.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/plugin.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/regexopt.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/scanner.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/sphinxext.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/style.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/token.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/unistring.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/util.cpython-312.pyc,, +pip/_vendor/pygments/cmdline.py,sha256=LIVzmAunlk9sRJJp54O4KRy9GDIN4Wu13v9p9QzfGPM,23656 +pip/_vendor/pygments/console.py,sha256=yhP9UsLAVmWKVQf2446JJewkA7AiXeeTf4Ieg3Oi2fU,1718 +pip/_vendor/pygments/filter.py,sha256=_ADNPCskD8_GmodHi6_LoVgPU3Zh336aBCT5cOeTMs0,1910 +pip/_vendor/pygments/filters/__init__.py,sha256=RdedK2KWKXlKwR7cvkfr3NUj9YiZQgMgilRMFUg2jPA,40392 +pip/_vendor/pygments/filters/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/formatter.py,sha256=jDWBTndlBH2Z5IYZFVDnP0qn1CaTQjTWt7iAGtCnJEg,4390 +pip/_vendor/pygments/formatters/__init__.py,sha256=8No-NUs8rBTSSBJIv4hSEQt2M0cFB4hwAT0snVc2QGE,5385 +pip/_vendor/pygments/formatters/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/_mapping.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/bbcode.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/groff.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/html.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/img.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/irc.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/latex.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/other.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/pangomarkup.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/rtf.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/svg.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/terminal.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/terminal256.cpython-312.pyc,, +pip/_vendor/pygments/formatters/_mapping.py,sha256=1Cw37FuQlNacnxRKmtlPX4nyLoX9_ttko5ZwscNUZZ4,4176 +pip/_vendor/pygments/formatters/bbcode.py,sha256=3JQLI45tcrQ_kRUMjuab6C7Hb0XUsbVWqqbSn9cMjkI,3320 +pip/_vendor/pygments/formatters/groff.py,sha256=M39k0PaSSZRnxWjqBSVPkF0mu1-Vr7bm6RsFvs-CNN4,5106 +pip/_vendor/pygments/formatters/html.py,sha256=SE2jc3YCqbMS3rZW9EAmDlAUhdVxJ52gA4dileEvCGU,35669 +pip/_vendor/pygments/formatters/img.py,sha256=MwA4xWPLOwh6j7Yc6oHzjuqSPt0M1fh5r-5BTIIUfsU,23287 +pip/_vendor/pygments/formatters/irc.py,sha256=dp1Z0l_ObJ5NFh9MhqLGg5ptG5hgJqedT2Vkutt9v0M,4981 +pip/_vendor/pygments/formatters/latex.py,sha256=XMmhOCqUKDBQtG5mGJNAFYxApqaC5puo5cMmPfK3944,19306 +pip/_vendor/pygments/formatters/other.py,sha256=56PMJOliin-rAUdnRM0i1wsV1GdUPd_dvQq0_UPfF9c,5034 +pip/_vendor/pygments/formatters/pangomarkup.py,sha256=y16U00aVYYEFpeCfGXlYBSMacG425CbfoG8oKbKegIg,2218 +pip/_vendor/pygments/formatters/rtf.py,sha256=ZT90dmcKyJboIB0mArhL7IhE467GXRN0G7QAUgG03To,11957 +pip/_vendor/pygments/formatters/svg.py,sha256=KKsiophPupHuxm0So-MsbQEWOT54IAiSF7hZPmxtKXE,7174 +pip/_vendor/pygments/formatters/terminal.py,sha256=AojNG4MlKq2L6IsC_VnXHu4AbHCBn9Otog6u45XvxeI,4674 +pip/_vendor/pygments/formatters/terminal256.py,sha256=kGkNUVo3FpwjytIDS0if79EuUoroAprcWt3igrcIqT0,11753 +pip/_vendor/pygments/lexer.py,sha256=TYHDt___gNW4axTl2zvPZff-VQi8fPaIh5OKRcVSjUM,35349 +pip/_vendor/pygments/lexers/__init__.py,sha256=pIlxyQJuu_syh9lE080cq8ceVbEVcKp0osAFU5fawJU,12115 +pip/_vendor/pygments/lexers/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/lexers/__pycache__/_mapping.cpython-312.pyc,, +pip/_vendor/pygments/lexers/__pycache__/python.cpython-312.pyc,, +pip/_vendor/pygments/lexers/_mapping.py,sha256=61-h3zr103m01OS5BUq_AfUiL9YI06Ves9ipQ7k4vr4,76097 +pip/_vendor/pygments/lexers/python.py,sha256=2J_YJrPTr_A6fJY_qKiKv0GpgPwHMrlMSeo59qN3fe4,53687 +pip/_vendor/pygments/modeline.py,sha256=gtRYZBS-CKOCDXHhGZqApboHBaZwGH8gznN3O6nuxj4,1005 +pip/_vendor/pygments/plugin.py,sha256=ioeJ3QeoJ-UQhZpY9JL7vbxsTVuwwM7BCu-Jb8nN0AU,1891 +pip/_vendor/pygments/regexopt.py,sha256=Hky4EB13rIXEHQUNkwmCrYqtIlnXDehNR3MztafZ43w,3072 +pip/_vendor/pygments/scanner.py,sha256=NDy3ofK_fHRFK4hIDvxpamG871aewqcsIb6sgTi7Fhk,3092 +pip/_vendor/pygments/sphinxext.py,sha256=iOptJBcqOGPwMEJ2p70PvwpZPIGdvdZ8dxvq6kzxDgA,7981 +pip/_vendor/pygments/style.py,sha256=rSCZWFpg1_DwFMXDU0nEVmAcBHpuQGf9RxvOPPQvKLQ,6420 +pip/_vendor/pygments/styles/__init__.py,sha256=qUk6_1z5KmT8EdJFZYgESmG6P_HJF_2vVrDD7HSCGYY,2042 +pip/_vendor/pygments/styles/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/styles/__pycache__/_mapping.cpython-312.pyc,, +pip/_vendor/pygments/styles/_mapping.py,sha256=6lovFUE29tz6EsV3XYY4hgozJ7q1JL7cfO3UOlgnS8w,3312 +pip/_vendor/pygments/token.py,sha256=qZwT7LSPy5YBY3JgDjut642CCy7JdQzAfmqD9NmT5j0,6226 +pip/_vendor/pygments/unistring.py,sha256=p5c1i-HhoIhWemy9CUsaN9o39oomYHNxXll0Xfw6tEA,63208 +pip/_vendor/pygments/util.py,sha256=2tj2nS1X9_OpcuSjf8dOET2bDVZhs8cEKd_uT6-Fgg8,10031 +pip/_vendor/pyproject_hooks/__init__.py,sha256=cPB_a9LXz5xvsRbX1o2qyAdjLatZJdQ_Lc5McNX-X7Y,691 +pip/_vendor/pyproject_hooks/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/__pycache__/_impl.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/_impl.py,sha256=jY-raxnmyRyB57ruAitrJRUzEexuAhGTpgMygqx67Z4,14936 +pip/_vendor/pyproject_hooks/_in_process/__init__.py,sha256=MJNPpfIxcO-FghxpBbxkG1rFiQf6HOUbV4U5mq0HFns,557 +pip/_vendor/pyproject_hooks/_in_process/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/_in_process/__pycache__/_in_process.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/_in_process/_in_process.py,sha256=qcXMhmx__MIJq10gGHW3mA4Tl8dy8YzHMccwnNoKlw0,12216 +pip/_vendor/pyproject_hooks/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/requests/__init__.py,sha256=HlB_HzhrzGtfD_aaYUwUh1zWXLZ75_YCLyit75d0Vz8,5057 +pip/_vendor/requests/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/__version__.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/_internal_utils.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/adapters.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/api.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/auth.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/certs.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/compat.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/cookies.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/exceptions.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/help.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/hooks.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/models.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/packages.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/sessions.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/status_codes.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/structures.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/utils.cpython-312.pyc,, +pip/_vendor/requests/__version__.py,sha256=FVfglgZmNQnmYPXpOohDU58F5EUb_-VnSTaAesS187g,435 +pip/_vendor/requests/_internal_utils.py,sha256=nMQymr4hs32TqVo5AbCrmcJEhvPUh7xXlluyqwslLiQ,1495 +pip/_vendor/requests/adapters.py,sha256=J7VeVxKBvawbtlX2DERVo05J9BXTcWYLMHNd1Baa-bk,27607 +pip/_vendor/requests/api.py,sha256=_Zb9Oa7tzVIizTKwFrPjDEY9ejtm_OnSRERnADxGsQs,6449 +pip/_vendor/requests/auth.py,sha256=kF75tqnLctZ9Mf_hm9TZIj4cQWnN5uxRz8oWsx5wmR0,10186 +pip/_vendor/requests/certs.py,sha256=kHDlkK_beuHXeMPc5jta2wgl8gdKeUWt5f2nTDVrvt8,441 +pip/_vendor/requests/compat.py,sha256=Mo9f9xZpefod8Zm-n9_StJcVTmwSukXR2p3IQyyVXvU,1485 +pip/_vendor/requests/cookies.py,sha256=bNi-iqEj4NPZ00-ob-rHvzkvObzN3lEpgw3g6paS3Xw,18590 +pip/_vendor/requests/exceptions.py,sha256=D1wqzYWne1mS2rU43tP9CeN1G7QAy7eqL9o1god6Ejw,4272 +pip/_vendor/requests/help.py,sha256=hRKaf9u0G7fdwrqMHtF3oG16RKktRf6KiwtSq2Fo1_0,3813 +pip/_vendor/requests/hooks.py,sha256=CiuysiHA39V5UfcCBXFIx83IrDpuwfN9RcTUgv28ftQ,733 +pip/_vendor/requests/models.py,sha256=x4K4CmH-lC0l2Kb-iPfMN4dRXxHEcbOaEWBL_i09AwI,35483 +pip/_vendor/requests/packages.py,sha256=_ZQDCJTJ8SP3kVWunSqBsRZNPzj2c1WFVqbdr08pz3U,1057 +pip/_vendor/requests/sessions.py,sha256=ykTI8UWGSltOfH07HKollH7kTBGw4WhiBVaQGmckTw4,30495 +pip/_vendor/requests/status_codes.py,sha256=iJUAeA25baTdw-6PfD0eF4qhpINDJRJI-yaMqxs4LEI,4322 +pip/_vendor/requests/structures.py,sha256=-IbmhVz06S-5aPSZuUthZ6-6D9XOjRuTXHOabY041XM,2912 +pip/_vendor/requests/utils.py,sha256=L79vnFbzJ3SFLKtJwpoWe41Tozi3RlZv94pY1TFIyow,33631 +pip/_vendor/resolvelib/__init__.py,sha256=h509TdEcpb5-44JonaU3ex2TM15GVBLjM9CNCPwnTTs,537 +pip/_vendor/resolvelib/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/resolvelib/__pycache__/providers.cpython-312.pyc,, +pip/_vendor/resolvelib/__pycache__/reporters.cpython-312.pyc,, +pip/_vendor/resolvelib/__pycache__/resolvers.cpython-312.pyc,, +pip/_vendor/resolvelib/__pycache__/structs.cpython-312.pyc,, +pip/_vendor/resolvelib/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/resolvelib/compat/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/resolvelib/compat/__pycache__/collections_abc.cpython-312.pyc,, +pip/_vendor/resolvelib/compat/collections_abc.py,sha256=uy8xUZ-NDEw916tugUXm8HgwCGiMO0f-RcdnpkfXfOs,156 +pip/_vendor/resolvelib/providers.py,sha256=fuuvVrCetu5gsxPB43ERyjfO8aReS3rFQHpDgiItbs4,5871 +pip/_vendor/resolvelib/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/resolvelib/reporters.py,sha256=TSbRmWzTc26w0ggsV1bxVpeWDB8QNIre6twYl7GIZBE,1601 +pip/_vendor/resolvelib/resolvers.py,sha256=G8rsLZSq64g5VmIq-lB7UcIJ1gjAxIQJmTF4REZleQ0,20511 +pip/_vendor/resolvelib/structs.py,sha256=0_1_XO8z_CLhegP3Vpf9VJ3zJcfLm0NOHRM-i0Ykz3o,4963 +pip/_vendor/rich/__init__.py,sha256=dRxjIL-SbFVY0q3IjSMrfgBTHrm1LZDgLOygVBwiYZc,6090 +pip/_vendor/rich/__main__.py,sha256=eO7Cq8JnrgG8zVoeImiAs92q3hXNMIfp0w5lMsO7Q2Y,8477 +pip/_vendor/rich/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_cell_widths.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_emoji_codes.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_emoji_replace.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_export_format.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_extension.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_fileno.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_inspect.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_log_render.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_loop.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_null_file.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_palettes.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_pick.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_ratio.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_spinners.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_stack.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_timer.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_win32_console.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_windows.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_windows_renderer.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_wrap.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/abc.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/align.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/ansi.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/bar.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/box.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/cells.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/color.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/color_triplet.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/columns.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/console.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/constrain.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/containers.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/control.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/default_styles.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/diagnose.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/emoji.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/errors.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/file_proxy.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/filesize.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/highlighter.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/json.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/jupyter.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/layout.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/live.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/live_render.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/logging.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/markup.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/measure.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/padding.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/pager.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/palette.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/panel.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/pretty.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/progress.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/progress_bar.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/prompt.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/protocol.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/region.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/repr.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/rule.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/scope.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/screen.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/segment.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/spinner.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/status.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/style.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/styled.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/syntax.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/table.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/terminal_theme.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/text.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/theme.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/themes.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/traceback.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/tree.cpython-312.pyc,, +pip/_vendor/rich/_cell_widths.py,sha256=fbmeyetEdHjzE_Vx2l1uK7tnPOhMs2X1lJfO3vsKDpA,10209 +pip/_vendor/rich/_emoji_codes.py,sha256=hu1VL9nbVdppJrVoijVshRlcRRe_v3dju3Mmd2sKZdY,140235 +pip/_vendor/rich/_emoji_replace.py,sha256=n-kcetsEUx2ZUmhQrfeMNc-teeGhpuSQ5F8VPBsyvDo,1064 +pip/_vendor/rich/_export_format.py,sha256=RI08pSrm5tBSzPMvnbTqbD9WIalaOoN5d4M1RTmLq1Y,2128 +pip/_vendor/rich/_extension.py,sha256=Xt47QacCKwYruzjDi-gOBq724JReDj9Cm9xUi5fr-34,265 +pip/_vendor/rich/_fileno.py,sha256=HWZxP5C2ajMbHryvAQZseflVfQoGzsKOHzKGsLD8ynQ,799 +pip/_vendor/rich/_inspect.py,sha256=QM05lEFnFoTaFqpnbx-zBEI6k8oIKrD3cvjEOQNhKig,9655 +pip/_vendor/rich/_log_render.py,sha256=1ByI0PA1ZpxZY3CGJOK54hjlq4X-Bz_boIjIqCd8Kns,3225 +pip/_vendor/rich/_loop.py,sha256=hV_6CLdoPm0va22Wpw4zKqM0RYsz3TZxXj0PoS-9eDQ,1236 +pip/_vendor/rich/_null_file.py,sha256=ADGKp1yt-k70FMKV6tnqCqecB-rSJzp-WQsD7LPL-kg,1394 +pip/_vendor/rich/_palettes.py,sha256=cdev1JQKZ0JvlguV9ipHgznTdnvlIzUFDBb0It2PzjI,7063 +pip/_vendor/rich/_pick.py,sha256=evDt8QN4lF5CiwrUIXlOJCntitBCOsI3ZLPEIAVRLJU,423 +pip/_vendor/rich/_ratio.py,sha256=Zt58apszI6hAAcXPpgdWKpu3c31UBWebOeR4mbyptvU,5471 +pip/_vendor/rich/_spinners.py,sha256=U2r1_g_1zSjsjiUdAESc2iAMc3i4ri_S8PYP6kQ5z1I,19919 +pip/_vendor/rich/_stack.py,sha256=-C8OK7rxn3sIUdVwxZBBpeHhIzX0eI-VM3MemYfaXm0,351 +pip/_vendor/rich/_timer.py,sha256=zelxbT6oPFZnNrwWPpc1ktUeAT-Vc4fuFcRZLQGLtMI,417 +pip/_vendor/rich/_win32_console.py,sha256=BSaDRIMwBLITn_m0mTRLPqME5q-quGdSMuYMpYeYJwc,22755 +pip/_vendor/rich/_windows.py,sha256=aBwaD_S56SbgopIvayVmpk0Y28uwY2C5Bab1wl3Bp-I,1925 +pip/_vendor/rich/_windows_renderer.py,sha256=t74ZL3xuDCP3nmTp9pH1L5LiI2cakJuQRQleHCJerlk,2783 +pip/_vendor/rich/_wrap.py,sha256=FlSsom5EX0LVkA3KWy34yHnCfLtqX-ZIepXKh-70rpc,3404 +pip/_vendor/rich/abc.py,sha256=ON-E-ZqSSheZ88VrKX2M3PXpFbGEUUZPMa_Af0l-4f0,890 +pip/_vendor/rich/align.py,sha256=Rh-3adnDaN1Ao07EjR2PhgE62PGLPgO8SMwJBku1urQ,10469 +pip/_vendor/rich/ansi.py,sha256=Avs1LHbSdcyOvDOdpELZUoULcBiYewY76eNBp6uFBhs,6921 +pip/_vendor/rich/bar.py,sha256=ldbVHOzKJOnflVNuv1xS7g6dLX2E3wMnXkdPbpzJTcs,3263 +pip/_vendor/rich/box.py,sha256=nr5fYIUghB_iUCEq6y0Z3LlCT8gFPDrzN9u2kn7tJl4,10831 +pip/_vendor/rich/cells.py,sha256=KrQkj5-LghCCpJLSNQIyAZjndc4bnEqOEmi5YuZ9UCY,5130 +pip/_vendor/rich/color.py,sha256=3HSULVDj7qQkXUdFWv78JOiSZzfy5y1nkcYhna296V0,18211 +pip/_vendor/rich/color_triplet.py,sha256=3lhQkdJbvWPoLDO-AnYImAWmJvV5dlgYNCVZ97ORaN4,1054 +pip/_vendor/rich/columns.py,sha256=HUX0KcMm9dsKNi11fTbiM_h2iDtl8ySCaVcxlalEzq8,7131 +pip/_vendor/rich/console.py,sha256=nKjrEx_7xy8KGmDVT-BgNII0R5hm1cexhAHDwdwNVqg,100156 +pip/_vendor/rich/constrain.py,sha256=1VIPuC8AgtKWrcncQrjBdYqA3JVWysu6jZo1rrh7c7Q,1288 +pip/_vendor/rich/containers.py,sha256=c_56TxcedGYqDepHBMTuZdUIijitAQgnox-Qde0Z1qo,5502 +pip/_vendor/rich/control.py,sha256=DSkHTUQLorfSERAKE_oTAEUFefZnZp4bQb4q8rHbKws,6630 +pip/_vendor/rich/default_styles.py,sha256=dZxgaSD9VUy7SXQShO33aLYiAWspCr2sCQZFX_JK1j4,8159 +pip/_vendor/rich/diagnose.py,sha256=an6uouwhKPAlvQhYpNNpGq9EJysfMIOvvCbO3oSoR24,972 +pip/_vendor/rich/emoji.py,sha256=omTF9asaAnsM4yLY94eR_9dgRRSm1lHUszX20D1yYCQ,2501 +pip/_vendor/rich/errors.py,sha256=5pP3Kc5d4QJ_c0KFsxrfyhjiPVe7J1zOqSFbFAzcV-Y,642 +pip/_vendor/rich/file_proxy.py,sha256=Tl9THMDZ-Pk5Wm8sI1gGg_U5DhusmxD-FZ0fUbcU0W0,1683 +pip/_vendor/rich/filesize.py,sha256=_iz9lIpRgvW7MNSeCZnLg-HwzbP4GETg543WqD8SFs0,2484 +pip/_vendor/rich/highlighter.py,sha256=G_sn-8DKjM1sEjLG_oc4ovkWmiUpWvj8bXi0yed2LnY,9586 +pip/_vendor/rich/json.py,sha256=vVEoKdawoJRjAFayPwXkMBPLy7RSTs-f44wSQDR2nJ0,5031 +pip/_vendor/rich/jupyter.py,sha256=QyoKoE_8IdCbrtiSHp9TsTSNyTHY0FO5whE7jOTd9UE,3252 +pip/_vendor/rich/layout.py,sha256=ajkSFAtEVv9EFTcFs-w4uZfft7nEXhNzL7ZVdgrT5rI,14004 +pip/_vendor/rich/live.py,sha256=DhzAPEnjTxQuq9_0Y2xh2MUwQcP_aGPkenLfKETslwM,14270 +pip/_vendor/rich/live_render.py,sha256=zJtB471jGziBtEwxc54x12wEQtH4BuQr1SA8v9kU82w,3666 +pip/_vendor/rich/logging.py,sha256=ZgpKMMBY_BuMAI_BYzo-UtXak6t5oH9VK8m9Q2Lm0f4,12458 +pip/_vendor/rich/markup.py,sha256=3euGKP5s41NCQwaSjTnJxus5iZMHjxpIM0W6fCxra38,8451 +pip/_vendor/rich/measure.py,sha256=HmrIJX8sWRTHbgh8MxEay_83VkqNW_70s8aKP5ZcYI8,5305 +pip/_vendor/rich/padding.py,sha256=KVEI3tOwo9sgK1YNSuH__M1_jUWmLZwRVV_KmOtVzyM,4908 +pip/_vendor/rich/pager.py,sha256=SO_ETBFKbg3n_AgOzXm41Sv36YxXAyI3_R-KOY2_uSc,828 +pip/_vendor/rich/palette.py,sha256=lInvR1ODDT2f3UZMfL1grq7dY_pDdKHw4bdUgOGaM4Y,3396 +pip/_vendor/rich/panel.py,sha256=fFRHcviXvWhk3V3zx5Zwmsb_RL9KJ3esD-sU0NYEVyw,11235 +pip/_vendor/rich/pretty.py,sha256=gy3S72u4FRg2ytoo7N1ZDWDIvB4unbzd5iUGdgm-8fc,36391 +pip/_vendor/rich/progress.py,sha256=MtmCjTk5zYU_XtRHxRHTAEHG6hF9PeF7EMWbEPleIC0,60357 +pip/_vendor/rich/progress_bar.py,sha256=mZTPpJUwcfcdgQCTTz3kyY-fc79ddLwtx6Ghhxfo064,8162 +pip/_vendor/rich/prompt.py,sha256=l0RhQU-0UVTV9e08xW1BbIj0Jq2IXyChX4lC0lFNzt4,12447 +pip/_vendor/rich/protocol.py,sha256=5hHHDDNHckdk8iWH5zEbi-zuIVSF5hbU2jIo47R7lTE,1391 +pip/_vendor/rich/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/rich/region.py,sha256=rNT9xZrVZTYIXZC0NYn41CJQwYNbR-KecPOxTgQvB8Y,166 +pip/_vendor/rich/repr.py,sha256=5MZJZmONgC6kud-QW-_m1okXwL2aR6u6y-pUcUCJz28,4431 +pip/_vendor/rich/rule.py,sha256=0fNaS_aERa3UMRc3T5WMpN_sumtDxfaor2y3of1ftBk,4602 +pip/_vendor/rich/scope.py,sha256=TMUU8qo17thyqQCPqjDLYpg_UU1k5qVd-WwiJvnJVas,2843 +pip/_vendor/rich/screen.py,sha256=YoeReESUhx74grqb0mSSb9lghhysWmFHYhsbMVQjXO8,1591 +pip/_vendor/rich/segment.py,sha256=otnKeKGEV-WRlQVosfJVeFDcDxAKHpvJ_hLzSu5lumM,24743 +pip/_vendor/rich/spinner.py,sha256=PT5qgXPG3ZpqRj7n3EZQ6NW56mx3ldZqZCU7gEMyZk4,4364 +pip/_vendor/rich/status.py,sha256=kkPph3YeAZBo-X-4wPp8gTqZyU466NLwZBA4PZTTewo,4424 +pip/_vendor/rich/style.py,sha256=aSoUNbVgfP1PAnduAqgbbl4AMQy668qs2S1FEwr3Oqs,27067 +pip/_vendor/rich/styled.py,sha256=eZNnzGrI4ki_54pgY3Oj0T-x3lxdXTYh4_ryDB24wBU,1258 +pip/_vendor/rich/syntax.py,sha256=qqAnEUZ4K57Po81_5RBxnsuU4KRzSdvDPAhKw8ma_3E,35763 +pip/_vendor/rich/table.py,sha256=yXYUr0YsPpG466N50HCAw2bpb5ZUuuzdc-G66Zk-oTc,40103 +pip/_vendor/rich/terminal_theme.py,sha256=1j5-ufJfnvlAo5Qsi_ACZiXDmwMXzqgmFByObT9-yJY,3370 +pip/_vendor/rich/text.py,sha256=AO7JPCz6-gaN1thVLXMBntEmDPVYFgFNG1oM61_sanU,47552 +pip/_vendor/rich/theme.py,sha256=oNyhXhGagtDlbDye3tVu3esWOWk0vNkuxFw-_unlaK0,3771 +pip/_vendor/rich/themes.py,sha256=0xgTLozfabebYtcJtDdC5QkX5IVUEaviqDUJJh4YVFk,102 +pip/_vendor/rich/traceback.py,sha256=z8UoN7NbTQKW6YDDUVwOh7F8snZf6gYnUWtOrKsLE1w,31797 +pip/_vendor/rich/tree.py,sha256=yWnQ6rAvRGJ3qZGqBrxS2SW2TKBTNrP0SdY8QxOFPuw,9451 +pip/_vendor/tomli/__init__.py,sha256=PhNw_eyLgdn7McJ6nrAN8yIm3dXC75vr1sVGVVwDSpA,314 +pip/_vendor/tomli/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/tomli/__pycache__/_parser.cpython-312.pyc,, +pip/_vendor/tomli/__pycache__/_re.cpython-312.pyc,, +pip/_vendor/tomli/__pycache__/_types.cpython-312.pyc,, +pip/_vendor/tomli/_parser.py,sha256=9w8LG0jB7fwmZZWB0vVXbeejDHcl4ANIJxB2scEnDlA,25591 +pip/_vendor/tomli/_re.py,sha256=sh4sBDRgO94KJZwNIrgdcyV_qQast50YvzOAUGpRDKA,3171 +pip/_vendor/tomli/_types.py,sha256=-GTG2VUqkpxwMqzmVO4F7ybKddIbAnuAHXfmWQcTi3Q,254 +pip/_vendor/tomli/py.typed,sha256=8PjyZ1aVoQpRVvt71muvuq5qE-jTFZkK-GLHkhdebmc,26 +pip/_vendor/truststore/__init__.py,sha256=WIDeyzWm7EVX44g354M25vpRXbeY1lsPH6EmUJUcq4o,1264 +pip/_vendor/truststore/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_api.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_macos.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_openssl.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_ssl_constants.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_windows.cpython-312.pyc,, +pip/_vendor/truststore/_api.py,sha256=GeXRNTlxPZ3kif4kNoh6JY0oE4QRzTGcgXr6l_X_Gk0,10555 +pip/_vendor/truststore/_macos.py,sha256=nZlLkOmszUE0g6ryRwBVGY5COzPyudcsiJtDWarM5LQ,20503 +pip/_vendor/truststore/_openssl.py,sha256=LLUZ7ZGaio-i5dpKKjKCSeSufmn6T8pi9lDcFnvSyq0,2324 +pip/_vendor/truststore/_ssl_constants.py,sha256=NUD4fVKdSD02ri7-db0tnO0VqLP9aHuzmStcW7tAl08,1130 +pip/_vendor/truststore/_windows.py,sha256=rAHyKYD8M7t-bXfG8VgOVa3TpfhVhbt4rZQlO45YuP8,17993 +pip/_vendor/truststore/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/typing_extensions.py,sha256=78hFl0HpDY-ylHUVCnWdU5nTHxUP2-S-3wEZk6CQmLk,134499 +pip/_vendor/urllib3/__init__.py,sha256=iXLcYiJySn0GNbWOOZDDApgBL1JgP44EZ8i1760S8Mc,3333 +pip/_vendor/urllib3/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/_collections.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/_version.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/connection.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/connectionpool.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/exceptions.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/fields.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/filepost.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/poolmanager.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/request.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/response.cpython-312.pyc,, +pip/_vendor/urllib3/_collections.py,sha256=pyASJJhW7wdOpqJj9QJA8FyGRfr8E8uUUhqUvhF0728,11372 +pip/_vendor/urllib3/_version.py,sha256=t9wGB6ooOTXXgiY66K1m6BZS1CJyXHAU8EoWDTe6Shk,64 +pip/_vendor/urllib3/connection.py,sha256=ttIA909BrbTUzwkqEe_TzZVh4JOOj7g61Ysei2mrwGg,20314 +pip/_vendor/urllib3/connectionpool.py,sha256=e2eiAwNbFNCKxj4bwDKNK-w7HIdSz3OmMxU_TIt-evQ,40408 +pip/_vendor/urllib3/contrib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/_appengine_environ.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/appengine.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/ntlmpool.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/socks.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/_appengine_environ.py,sha256=bDbyOEhW2CKLJcQqAKAyrEHN-aklsyHFKq6vF8ZFsmk,957 +pip/_vendor/urllib3/contrib/_securetransport/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/_securetransport/__pycache__/low_level.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/_securetransport/bindings.py,sha256=4Xk64qIkPBt09A5q-RIFUuDhNc9mXilVapm7WnYnzRw,17632 +pip/_vendor/urllib3/contrib/_securetransport/low_level.py,sha256=B2JBB2_NRP02xK6DCa1Pa9IuxrPwxzDzZbixQkb7U9M,13922 +pip/_vendor/urllib3/contrib/appengine.py,sha256=VR68eAVE137lxTgjBDwCna5UiBZTOKa01Aj_-5BaCz4,11036 +pip/_vendor/urllib3/contrib/ntlmpool.py,sha256=NlfkW7WMdW8ziqudopjHoW299og1BTWi0IeIibquFwk,4528 +pip/_vendor/urllib3/contrib/pyopenssl.py,sha256=hDJh4MhyY_p-oKlFcYcQaVQRDv6GMmBGuW9yjxyeejM,17081 +pip/_vendor/urllib3/contrib/securetransport.py,sha256=Fef1IIUUFHqpevzXiDPbIGkDKchY2FVKeVeLGR1Qq3g,34446 +pip/_vendor/urllib3/contrib/socks.py,sha256=aRi9eWXo9ZEb95XUxef4Z21CFlnnjbEiAo9HOseoMt4,7097 +pip/_vendor/urllib3/exceptions.py,sha256=0Mnno3KHTNfXRfY7638NufOPkUb6mXOm-Lqj-4x2w8A,8217 +pip/_vendor/urllib3/fields.py,sha256=kvLDCg_JmH1lLjUUEY_FLS8UhY7hBvDPuVETbY8mdrM,8579 +pip/_vendor/urllib3/filepost.py,sha256=5b_qqgRHVlL7uLtdAYBzBh-GHmU5AfJVt_2N0XS3PeY,2440 +pip/_vendor/urllib3/packages/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/packages/__pycache__/six.cpython-312.pyc,, +pip/_vendor/urllib3/packages/backports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/urllib3/packages/backports/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/packages/backports/__pycache__/makefile.cpython-312.pyc,, +pip/_vendor/urllib3/packages/backports/__pycache__/weakref_finalize.cpython-312.pyc,, +pip/_vendor/urllib3/packages/backports/makefile.py,sha256=nbzt3i0agPVP07jqqgjhaYjMmuAi_W5E0EywZivVO8E,1417 +pip/_vendor/urllib3/packages/backports/weakref_finalize.py,sha256=tRCal5OAhNSRyb0DhHp-38AtIlCsRP8BxF3NX-6rqIA,5343 +pip/_vendor/urllib3/packages/six.py,sha256=b9LM0wBXv7E7SrbCjAm4wwN-hrH-iNxv18LgWNMMKPo,34665 +pip/_vendor/urllib3/poolmanager.py,sha256=aWyhXRtNO4JUnCSVVqKTKQd8EXTvUm1VN9pgs2bcONo,19990 +pip/_vendor/urllib3/request.py,sha256=YTWFNr7QIwh7E1W9dde9LM77v2VWTJ5V78XuTTw7D1A,6691 +pip/_vendor/urllib3/response.py,sha256=fmDJAFkG71uFTn-sVSTh2Iw0WmcXQYqkbRjihvwBjU8,30641 +pip/_vendor/urllib3/util/__init__.py,sha256=JEmSmmqqLyaw8P51gUImZh8Gwg9i1zSe-DoqAitn2nc,1155 +pip/_vendor/urllib3/util/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/connection.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/proxy.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/queue.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/request.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/response.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/retry.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/ssl_match_hostname.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/ssltransport.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/timeout.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/url.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/wait.cpython-312.pyc,, +pip/_vendor/urllib3/util/connection.py,sha256=5Lx2B1PW29KxBn2T0xkN1CBgRBa3gGVJBKoQoRogEVk,4901 +pip/_vendor/urllib3/util/proxy.py,sha256=zUvPPCJrp6dOF0N4GAVbOcl6o-4uXKSrGiTkkr5vUS4,1605 +pip/_vendor/urllib3/util/queue.py,sha256=nRgX8_eX-_VkvxoX096QWoz8Ps0QHUAExILCY_7PncM,498 +pip/_vendor/urllib3/util/request.py,sha256=C0OUt2tcU6LRiQJ7YYNP9GvPrSvl7ziIBekQ-5nlBZk,3997 +pip/_vendor/urllib3/util/response.py,sha256=GJpg3Egi9qaJXRwBh5wv-MNuRWan5BIu40oReoxWP28,3510 +pip/_vendor/urllib3/util/retry.py,sha256=6ENvOZ8PBDzh8kgixpql9lIrb2dxH-k7ZmBanJF2Ng4,22050 +pip/_vendor/urllib3/util/ssl_.py,sha256=QDuuTxPSCj1rYtZ4xpD7Ux-r20TD50aHyqKyhQ7Bq4A,17460 +pip/_vendor/urllib3/util/ssl_match_hostname.py,sha256=Ir4cZVEjmAk8gUAIHWSi7wtOO83UCYABY2xFD1Ql_WA,5758 +pip/_vendor/urllib3/util/ssltransport.py,sha256=NA-u5rMTrDFDFC8QzRKUEKMG0561hOD4qBTr3Z4pv6E,6895 +pip/_vendor/urllib3/util/timeout.py,sha256=cwq4dMk87mJHSBktK1miYJ-85G-3T3RmT20v7SFCpno,10168 +pip/_vendor/urllib3/util/url.py,sha256=lCAE7M5myA8EDdW0sJuyyZhVB9K_j38ljWhHAnFaWoE,14296 +pip/_vendor/urllib3/util/wait.py,sha256=fOX0_faozG2P7iVojQoE1mbydweNyTcm-hXEfFrTtLI,5403 +pip/_vendor/vendor.txt,sha256=EW-E3cE5XEAtVFzGInikArOMDxGP0DLUWzXpY4RZfFY,333 +pip/py.typed,sha256=EBVvvPRTn_eIpz5e5QztSCdrMX7Qwd7VP93RSoIlZ2I,286 diff --git a/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/REQUESTED b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/REQUESTED new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/WHEEL b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/WHEEL new file mode 100644 index 0000000..505164b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (75.8.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/entry_points.txt b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/entry_points.txt new file mode 100644 index 0000000..25fcf7e --- /dev/null +++ b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/entry_points.txt @@ -0,0 +1,3 @@ +[console_scripts] +pip = pip._internal.cli.main:main +pip3 = pip._internal.cli.main:main diff --git a/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/top_level.txt b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/top_level.txt new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/pip-25.0.1.dist-info/top_level.txt @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/pip/__init__.py b/env/lib/python3.12/site-packages/pip/__init__.py new file mode 100644 index 0000000..d628f93 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/__init__.py @@ -0,0 +1,13 @@ +from typing import List, Optional + +__version__ = "25.0.1" + + +def main(args: Optional[List[str]] = None) -> int: + """This is an internal API only meant for use by pip's own console scripts. + + For additional details, see https://github.com/pypa/pip/issues/7498. + """ + from pip._internal.utils.entrypoints import _wrapper + + return _wrapper(args) diff --git a/env/lib/python3.12/site-packages/pip/__main__.py b/env/lib/python3.12/site-packages/pip/__main__.py new file mode 100644 index 0000000..5991326 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/__main__.py @@ -0,0 +1,24 @@ +import os +import sys + +# Remove '' and current working directory from the first entry +# of sys.path, if present to avoid using current directory +# in pip commands check, freeze, install, list and show, +# when invoked as python -m pip +if sys.path[0] in ("", os.getcwd()): + sys.path.pop(0) + +# If we are running from a wheel, add the wheel to sys.path +# This allows the usage python pip-*.whl/pip install pip-*.whl +if __package__ == "": + # __file__ is pip-*.whl/pip/__main__.py + # first dirname call strips of '/__main__.py', second strips off '/pip' + # Resulting path is the name of the wheel itself + # Add that to sys.path so we can import pip + path = os.path.dirname(os.path.dirname(__file__)) + sys.path.insert(0, path) + +if __name__ == "__main__": + from pip._internal.cli.main import main as _main + + sys.exit(_main()) diff --git a/env/lib/python3.12/site-packages/pip/__pip-runner__.py b/env/lib/python3.12/site-packages/pip/__pip-runner__.py new file mode 100644 index 0000000..c633787 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/__pip-runner__.py @@ -0,0 +1,50 @@ +"""Execute exactly this copy of pip, within a different environment. + +This file is named as it is, to ensure that this module can't be imported via +an import statement. +""" + +# /!\ This version compatibility check section must be Python 2 compatible. /!\ + +import sys + +# Copied from pyproject.toml +PYTHON_REQUIRES = (3, 8) + + +def version_str(version): # type: ignore + return ".".join(str(v) for v in version) + + +if sys.version_info[:2] < PYTHON_REQUIRES: + raise SystemExit( + "This version of pip does not support python {} (requires >={}).".format( + version_str(sys.version_info[:2]), version_str(PYTHON_REQUIRES) + ) + ) + +# From here on, we can use Python 3 features, but the syntax must remain +# Python 2 compatible. + +import runpy # noqa: E402 +from importlib.machinery import PathFinder # noqa: E402 +from os.path import dirname # noqa: E402 + +PIP_SOURCES_ROOT = dirname(dirname(__file__)) + + +class PipImportRedirectingFinder: + @classmethod + def find_spec(self, fullname, path=None, target=None): # type: ignore + if fullname != "pip": + return None + + spec = PathFinder.find_spec(fullname, [PIP_SOURCES_ROOT], target) + assert spec, (PIP_SOURCES_ROOT, fullname) + return spec + + +sys.meta_path.insert(0, PipImportRedirectingFinder()) + +assert __name__ == "__main__", "Cannot run __pip-runner__.py as a non-main module" +runpy.run_module("pip", run_name="__main__", alter_sys=True) diff --git a/env/lib/python3.12/site-packages/pip/_internal/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/__init__.py new file mode 100644 index 0000000..1a5b7f8 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/__init__.py @@ -0,0 +1,18 @@ +from typing import List, Optional + +from pip._internal.utils import _log + +# init_logging() must be called before any call to logging.getLogger() +# which happens at import of most modules. +_log.init_logging() + + +def main(args: Optional[List[str]] = None) -> int: + """This is preserved for old console scripts that may still be referencing + it. + + For additional details, see https://github.com/pypa/pip/issues/7498. + """ + from pip._internal.utils.entrypoints import _wrapper + + return _wrapper(args) diff --git a/env/lib/python3.12/site-packages/pip/_internal/build_env.py b/env/lib/python3.12/site-packages/pip/_internal/build_env.py new file mode 100644 index 0000000..e8d1aca --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/build_env.py @@ -0,0 +1,322 @@ +"""Build Environment used for isolation during sdist building +""" + +import logging +import os +import pathlib +import site +import sys +import textwrap +from collections import OrderedDict +from types import TracebackType +from typing import TYPE_CHECKING, Iterable, List, Optional, Set, Tuple, Type, Union + +from pip._vendor.packaging.version import Version + +from pip import __file__ as pip_location +from pip._internal.cli.spinners import open_spinner +from pip._internal.locations import get_platlib, get_purelib, get_scheme +from pip._internal.metadata import get_default_environment, get_environment +from pip._internal.utils.logging import VERBOSE +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.subprocess import call_subprocess +from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + +logger = logging.getLogger(__name__) + + +def _dedup(a: str, b: str) -> Union[Tuple[str], Tuple[str, str]]: + return (a, b) if a != b else (a,) + + +class _Prefix: + def __init__(self, path: str) -> None: + self.path = path + self.setup = False + scheme = get_scheme("", prefix=path) + self.bin_dir = scheme.scripts + self.lib_dirs = _dedup(scheme.purelib, scheme.platlib) + + +def get_runnable_pip() -> str: + """Get a file to pass to a Python executable, to run the currently-running pip. + + This is used to run a pip subprocess, for installing requirements into the build + environment. + """ + source = pathlib.Path(pip_location).resolve().parent + + if not source.is_dir(): + # This would happen if someone is using pip from inside a zip file. In that + # case, we can use that directly. + return str(source) + + return os.fsdecode(source / "__pip-runner__.py") + + +def _get_system_sitepackages() -> Set[str]: + """Get system site packages + + Usually from site.getsitepackages, + but fallback on `get_purelib()/get_platlib()` if unavailable + (e.g. in a virtualenv created by virtualenv<20) + + Returns normalized set of strings. + """ + if hasattr(site, "getsitepackages"): + system_sites = site.getsitepackages() + else: + # virtualenv < 20 overwrites site.py without getsitepackages + # fallback on get_purelib/get_platlib. + # this is known to miss things, but shouldn't in the cases + # where getsitepackages() has been removed (inside a virtualenv) + system_sites = [get_purelib(), get_platlib()] + return {os.path.normcase(path) for path in system_sites} + + +class BuildEnvironment: + """Creates and manages an isolated environment to install build deps""" + + def __init__(self) -> None: + temp_dir = TempDirectory(kind=tempdir_kinds.BUILD_ENV, globally_managed=True) + + self._prefixes = OrderedDict( + (name, _Prefix(os.path.join(temp_dir.path, name))) + for name in ("normal", "overlay") + ) + + self._bin_dirs: List[str] = [] + self._lib_dirs: List[str] = [] + for prefix in reversed(list(self._prefixes.values())): + self._bin_dirs.append(prefix.bin_dir) + self._lib_dirs.extend(prefix.lib_dirs) + + # Customize site to: + # - ensure .pth files are honored + # - prevent access to system site packages + system_sites = _get_system_sitepackages() + + self._site_dir = os.path.join(temp_dir.path, "site") + if not os.path.exists(self._site_dir): + os.mkdir(self._site_dir) + with open( + os.path.join(self._site_dir, "sitecustomize.py"), "w", encoding="utf-8" + ) as fp: + fp.write( + textwrap.dedent( + """ + import os, site, sys + + # First, drop system-sites related paths. + original_sys_path = sys.path[:] + known_paths = set() + for path in {system_sites!r}: + site.addsitedir(path, known_paths=known_paths) + system_paths = set( + os.path.normcase(path) + for path in sys.path[len(original_sys_path):] + ) + original_sys_path = [ + path for path in original_sys_path + if os.path.normcase(path) not in system_paths + ] + sys.path = original_sys_path + + # Second, add lib directories. + # ensuring .pth file are processed. + for path in {lib_dirs!r}: + assert not path in sys.path + site.addsitedir(path) + """ + ).format(system_sites=system_sites, lib_dirs=self._lib_dirs) + ) + + def __enter__(self) -> None: + self._save_env = { + name: os.environ.get(name, None) + for name in ("PATH", "PYTHONNOUSERSITE", "PYTHONPATH") + } + + path = self._bin_dirs[:] + old_path = self._save_env["PATH"] + if old_path: + path.extend(old_path.split(os.pathsep)) + + pythonpath = [self._site_dir] + + os.environ.update( + { + "PATH": os.pathsep.join(path), + "PYTHONNOUSERSITE": "1", + "PYTHONPATH": os.pathsep.join(pythonpath), + } + ) + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + for varname, old_value in self._save_env.items(): + if old_value is None: + os.environ.pop(varname, None) + else: + os.environ[varname] = old_value + + def check_requirements( + self, reqs: Iterable[str] + ) -> Tuple[Set[Tuple[str, str]], Set[str]]: + """Return 2 sets: + - conflicting requirements: set of (installed, wanted) reqs tuples + - missing requirements: set of reqs + """ + missing = set() + conflicting = set() + if reqs: + env = ( + get_environment(self._lib_dirs) + if hasattr(self, "_lib_dirs") + else get_default_environment() + ) + for req_str in reqs: + req = get_requirement(req_str) + # We're explicitly evaluating with an empty extra value, since build + # environments are not provided any mechanism to select specific extras. + if req.marker is not None and not req.marker.evaluate({"extra": ""}): + continue + dist = env.get_distribution(req.name) + if not dist: + missing.add(req_str) + continue + if isinstance(dist.version, Version): + installed_req_str = f"{req.name}=={dist.version}" + else: + installed_req_str = f"{req.name}==={dist.version}" + if not req.specifier.contains(dist.version, prereleases=True): + conflicting.add((installed_req_str, req_str)) + # FIXME: Consider direct URL? + return conflicting, missing + + def install_requirements( + self, + finder: "PackageFinder", + requirements: Iterable[str], + prefix_as_string: str, + *, + kind: str, + ) -> None: + prefix = self._prefixes[prefix_as_string] + assert not prefix.setup + prefix.setup = True + if not requirements: + return + self._install_requirements( + get_runnable_pip(), + finder, + requirements, + prefix, + kind=kind, + ) + + @staticmethod + def _install_requirements( + pip_runnable: str, + finder: "PackageFinder", + requirements: Iterable[str], + prefix: _Prefix, + *, + kind: str, + ) -> None: + args: List[str] = [ + sys.executable, + pip_runnable, + "install", + "--ignore-installed", + "--no-user", + "--prefix", + prefix.path, + "--no-warn-script-location", + "--disable-pip-version-check", + # The prefix specified two lines above, thus + # target from config file or env var should be ignored + "--target", + "", + ] + if logger.getEffectiveLevel() <= logging.DEBUG: + args.append("-vv") + elif logger.getEffectiveLevel() <= VERBOSE: + args.append("-v") + for format_control in ("no_binary", "only_binary"): + formats = getattr(finder.format_control, format_control) + args.extend( + ( + "--" + format_control.replace("_", "-"), + ",".join(sorted(formats or {":none:"})), + ) + ) + + index_urls = finder.index_urls + if index_urls: + args.extend(["-i", index_urls[0]]) + for extra_index in index_urls[1:]: + args.extend(["--extra-index-url", extra_index]) + else: + args.append("--no-index") + for link in finder.find_links: + args.extend(["--find-links", link]) + + if finder.proxy: + args.extend(["--proxy", finder.proxy]) + for host in finder.trusted_hosts: + args.extend(["--trusted-host", host]) + if finder.custom_cert: + args.extend(["--cert", finder.custom_cert]) + if finder.client_cert: + args.extend(["--client-cert", finder.client_cert]) + if finder.allow_all_prereleases: + args.append("--pre") + if finder.prefer_binary: + args.append("--prefer-binary") + args.append("--") + args.extend(requirements) + with open_spinner(f"Installing {kind}") as spinner: + call_subprocess( + args, + command_desc=f"pip subprocess to install {kind}", + spinner=spinner, + ) + + +class NoOpBuildEnvironment(BuildEnvironment): + """A no-op drop-in replacement for BuildEnvironment""" + + def __init__(self) -> None: + pass + + def __enter__(self) -> None: + pass + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + pass + + def cleanup(self) -> None: + pass + + def install_requirements( + self, + finder: "PackageFinder", + requirements: Iterable[str], + prefix_as_string: str, + *, + kind: str, + ) -> None: + raise NotImplementedError() diff --git a/env/lib/python3.12/site-packages/pip/_internal/cache.py b/env/lib/python3.12/site-packages/pip/_internal/cache.py new file mode 100644 index 0000000..6b45126 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cache.py @@ -0,0 +1,290 @@ +"""Cache Management +""" + +import hashlib +import json +import logging +import os +from pathlib import Path +from typing import Any, Dict, List, Optional + +from pip._vendor.packaging.tags import Tag, interpreter_name, interpreter_version +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import InvalidWheelFilename +from pip._internal.models.direct_url import DirectUrl +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds +from pip._internal.utils.urls import path_to_url + +logger = logging.getLogger(__name__) + +ORIGIN_JSON_NAME = "origin.json" + + +def _hash_dict(d: Dict[str, str]) -> str: + """Return a stable sha224 of a dictionary.""" + s = json.dumps(d, sort_keys=True, separators=(",", ":"), ensure_ascii=True) + return hashlib.sha224(s.encode("ascii")).hexdigest() + + +class Cache: + """An abstract class - provides cache directories for data from links + + :param cache_dir: The root of the cache. + """ + + def __init__(self, cache_dir: str) -> None: + super().__init__() + assert not cache_dir or os.path.isabs(cache_dir) + self.cache_dir = cache_dir or None + + def _get_cache_path_parts(self, link: Link) -> List[str]: + """Get parts of part that must be os.path.joined with cache_dir""" + + # We want to generate an url to use as our cache key, we don't want to + # just reuse the URL because it might have other items in the fragment + # and we don't care about those. + key_parts = {"url": link.url_without_fragment} + if link.hash_name is not None and link.hash is not None: + key_parts[link.hash_name] = link.hash + if link.subdirectory_fragment: + key_parts["subdirectory"] = link.subdirectory_fragment + + # Include interpreter name, major and minor version in cache key + # to cope with ill-behaved sdists that build a different wheel + # depending on the python version their setup.py is being run on, + # and don't encode the difference in compatibility tags. + # https://github.com/pypa/pip/issues/7296 + key_parts["interpreter_name"] = interpreter_name() + key_parts["interpreter_version"] = interpreter_version() + + # Encode our key url with sha224, we'll use this because it has similar + # security properties to sha256, but with a shorter total output (and + # thus less secure). However the differences don't make a lot of + # difference for our use case here. + hashed = _hash_dict(key_parts) + + # We want to nest the directories some to prevent having a ton of top + # level directories where we might run out of sub directories on some + # FS. + parts = [hashed[:2], hashed[2:4], hashed[4:6], hashed[6:]] + + return parts + + def _get_candidates(self, link: Link, canonical_package_name: str) -> List[Any]: + can_not_cache = not self.cache_dir or not canonical_package_name or not link + if can_not_cache: + return [] + + path = self.get_path_for_link(link) + if os.path.isdir(path): + return [(candidate, path) for candidate in os.listdir(path)] + return [] + + def get_path_for_link(self, link: Link) -> str: + """Return a directory to store cached items in for link.""" + raise NotImplementedError() + + def get( + self, + link: Link, + package_name: Optional[str], + supported_tags: List[Tag], + ) -> Link: + """Returns a link to a cached item if it exists, otherwise returns the + passed link. + """ + raise NotImplementedError() + + +class SimpleWheelCache(Cache): + """A cache of wheels for future installs.""" + + def __init__(self, cache_dir: str) -> None: + super().__init__(cache_dir) + + def get_path_for_link(self, link: Link) -> str: + """Return a directory to store cached wheels for link + + Because there are M wheels for any one sdist, we provide a directory + to cache them in, and then consult that directory when looking up + cache hits. + + We only insert things into the cache if they have plausible version + numbers, so that we don't contaminate the cache with things that were + not unique. E.g. ./package might have dozens of installs done for it + and build a version of 0.0...and if we built and cached a wheel, we'd + end up using the same wheel even if the source has been edited. + + :param link: The link of the sdist for which this will cache wheels. + """ + parts = self._get_cache_path_parts(link) + assert self.cache_dir + # Store wheels within the root cache_dir + return os.path.join(self.cache_dir, "wheels", *parts) + + def get( + self, + link: Link, + package_name: Optional[str], + supported_tags: List[Tag], + ) -> Link: + candidates = [] + + if not package_name: + return link + + canonical_package_name = canonicalize_name(package_name) + for wheel_name, wheel_dir in self._get_candidates(link, canonical_package_name): + try: + wheel = Wheel(wheel_name) + except InvalidWheelFilename: + continue + if canonicalize_name(wheel.name) != canonical_package_name: + logger.debug( + "Ignoring cached wheel %s for %s as it " + "does not match the expected distribution name %s.", + wheel_name, + link, + package_name, + ) + continue + if not wheel.supported(supported_tags): + # Built for a different python/arch/etc + continue + candidates.append( + ( + wheel.support_index_min(supported_tags), + wheel_name, + wheel_dir, + ) + ) + + if not candidates: + return link + + _, wheel_name, wheel_dir = min(candidates) + return Link(path_to_url(os.path.join(wheel_dir, wheel_name))) + + +class EphemWheelCache(SimpleWheelCache): + """A SimpleWheelCache that creates it's own temporary cache directory""" + + def __init__(self) -> None: + self._temp_dir = TempDirectory( + kind=tempdir_kinds.EPHEM_WHEEL_CACHE, + globally_managed=True, + ) + + super().__init__(self._temp_dir.path) + + +class CacheEntry: + def __init__( + self, + link: Link, + persistent: bool, + ): + self.link = link + self.persistent = persistent + self.origin: Optional[DirectUrl] = None + origin_direct_url_path = Path(self.link.file_path).parent / ORIGIN_JSON_NAME + if origin_direct_url_path.exists(): + try: + self.origin = DirectUrl.from_json( + origin_direct_url_path.read_text(encoding="utf-8") + ) + except Exception as e: + logger.warning( + "Ignoring invalid cache entry origin file %s for %s (%s)", + origin_direct_url_path, + link.filename, + e, + ) + + +class WheelCache(Cache): + """Wraps EphemWheelCache and SimpleWheelCache into a single Cache + + This Cache allows for gracefully degradation, using the ephem wheel cache + when a certain link is not found in the simple wheel cache first. + """ + + def __init__(self, cache_dir: str) -> None: + super().__init__(cache_dir) + self._wheel_cache = SimpleWheelCache(cache_dir) + self._ephem_cache = EphemWheelCache() + + def get_path_for_link(self, link: Link) -> str: + return self._wheel_cache.get_path_for_link(link) + + def get_ephem_path_for_link(self, link: Link) -> str: + return self._ephem_cache.get_path_for_link(link) + + def get( + self, + link: Link, + package_name: Optional[str], + supported_tags: List[Tag], + ) -> Link: + cache_entry = self.get_cache_entry(link, package_name, supported_tags) + if cache_entry is None: + return link + return cache_entry.link + + def get_cache_entry( + self, + link: Link, + package_name: Optional[str], + supported_tags: List[Tag], + ) -> Optional[CacheEntry]: + """Returns a CacheEntry with a link to a cached item if it exists or + None. The cache entry indicates if the item was found in the persistent + or ephemeral cache. + """ + retval = self._wheel_cache.get( + link=link, + package_name=package_name, + supported_tags=supported_tags, + ) + if retval is not link: + return CacheEntry(retval, persistent=True) + + retval = self._ephem_cache.get( + link=link, + package_name=package_name, + supported_tags=supported_tags, + ) + if retval is not link: + return CacheEntry(retval, persistent=False) + + return None + + @staticmethod + def record_download_origin(cache_dir: str, download_info: DirectUrl) -> None: + origin_path = Path(cache_dir) / ORIGIN_JSON_NAME + if origin_path.exists(): + try: + origin = DirectUrl.from_json(origin_path.read_text(encoding="utf-8")) + except Exception as e: + logger.warning( + "Could not read origin file %s in cache entry (%s). " + "Will attempt to overwrite it.", + origin_path, + e, + ) + else: + # TODO: use DirectUrl.equivalent when + # https://github.com/pypa/pip/pull/10564 is merged. + if origin.url != download_info.url: + logger.warning( + "Origin URL %s in cache entry %s does not match download URL " + "%s. This is likely a pip bug or a cache corruption issue. " + "Will overwrite it with the new value.", + origin.url, + cache_dir, + download_info.url, + ) + origin_path.write_text(download_info.to_json(), encoding="utf-8") diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/cli/__init__.py new file mode 100644 index 0000000..e589bb9 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/__init__.py @@ -0,0 +1,4 @@ +"""Subpackage containing all of pip's command line interface related code +""" + +# This file intentionally does not import submodules diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/autocompletion.py b/env/lib/python3.12/site-packages/pip/_internal/cli/autocompletion.py new file mode 100644 index 0000000..f3f70ac --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/autocompletion.py @@ -0,0 +1,176 @@ +"""Logic that powers autocompletion installed by ``pip completion``. +""" + +import optparse +import os +import sys +from itertools import chain +from typing import Any, Iterable, List, Optional + +from pip._internal.cli.main_parser import create_main_parser +from pip._internal.commands import commands_dict, create_command +from pip._internal.metadata import get_default_environment + + +def autocomplete() -> None: + """Entry Point for completion of main and subcommand options.""" + # Don't complete if user hasn't sourced bash_completion file. + if "PIP_AUTO_COMPLETE" not in os.environ: + return + # Don't complete if autocompletion environment variables + # are not present + if not os.environ.get("COMP_WORDS") or not os.environ.get("COMP_CWORD"): + return + cwords = os.environ["COMP_WORDS"].split()[1:] + cword = int(os.environ["COMP_CWORD"]) + try: + current = cwords[cword - 1] + except IndexError: + current = "" + + parser = create_main_parser() + subcommands = list(commands_dict) + options = [] + + # subcommand + subcommand_name: Optional[str] = None + for word in cwords: + if word in subcommands: + subcommand_name = word + break + # subcommand options + if subcommand_name is not None: + # special case: 'help' subcommand has no options + if subcommand_name == "help": + sys.exit(1) + # special case: list locally installed dists for show and uninstall + should_list_installed = not current.startswith("-") and subcommand_name in [ + "show", + "uninstall", + ] + if should_list_installed: + env = get_default_environment() + lc = current.lower() + installed = [ + dist.canonical_name + for dist in env.iter_installed_distributions(local_only=True) + if dist.canonical_name.startswith(lc) + and dist.canonical_name not in cwords[1:] + ] + # if there are no dists installed, fall back to option completion + if installed: + for dist in installed: + print(dist) + sys.exit(1) + + should_list_installables = ( + not current.startswith("-") and subcommand_name == "install" + ) + if should_list_installables: + for path in auto_complete_paths(current, "path"): + print(path) + sys.exit(1) + + subcommand = create_command(subcommand_name) + + for opt in subcommand.parser.option_list_all: + if opt.help != optparse.SUPPRESS_HELP: + options += [ + (opt_str, opt.nargs) for opt_str in opt._long_opts + opt._short_opts + ] + + # filter out previously specified options from available options + prev_opts = [x.split("=")[0] for x in cwords[1 : cword - 1]] + options = [(x, v) for (x, v) in options if x not in prev_opts] + # filter options by current input + options = [(k, v) for k, v in options if k.startswith(current)] + # get completion type given cwords and available subcommand options + completion_type = get_path_completion_type( + cwords, + cword, + subcommand.parser.option_list_all, + ) + # get completion files and directories if ``completion_type`` is + # ````, ``

`` or ```` + if completion_type: + paths = auto_complete_paths(current, completion_type) + options = [(path, 0) for path in paths] + for option in options: + opt_label = option[0] + # append '=' to options which require args + if option[1] and option[0][:2] == "--": + opt_label += "=" + print(opt_label) + else: + # show main parser options only when necessary + + opts = [i.option_list for i in parser.option_groups] + opts.append(parser.option_list) + flattened_opts = chain.from_iterable(opts) + if current.startswith("-"): + for opt in flattened_opts: + if opt.help != optparse.SUPPRESS_HELP: + subcommands += opt._long_opts + opt._short_opts + else: + # get completion type given cwords and all available options + completion_type = get_path_completion_type(cwords, cword, flattened_opts) + if completion_type: + subcommands = list(auto_complete_paths(current, completion_type)) + + print(" ".join([x for x in subcommands if x.startswith(current)])) + sys.exit(1) + + +def get_path_completion_type( + cwords: List[str], cword: int, opts: Iterable[Any] +) -> Optional[str]: + """Get the type of path completion (``file``, ``dir``, ``path`` or None) + + :param cwords: same as the environmental variable ``COMP_WORDS`` + :param cword: same as the environmental variable ``COMP_CWORD`` + :param opts: The available options to check + :return: path completion type (``file``, ``dir``, ``path`` or None) + """ + if cword < 2 or not cwords[cword - 2].startswith("-"): + return None + for opt in opts: + if opt.help == optparse.SUPPRESS_HELP: + continue + for o in str(opt).split("/"): + if cwords[cword - 2].split("=")[0] == o: + if not opt.metavar or any( + x in ("path", "file", "dir") for x in opt.metavar.split("/") + ): + return opt.metavar + return None + + +def auto_complete_paths(current: str, completion_type: str) -> Iterable[str]: + """If ``completion_type`` is ``file`` or ``path``, list all regular files + and directories starting with ``current``; otherwise only list directories + starting with ``current``. + + :param current: The word to be completed + :param completion_type: path completion type(``file``, ``path`` or ``dir``) + :return: A generator of regular files and/or directories + """ + directory, filename = os.path.split(current) + current_path = os.path.abspath(directory) + # Don't complete paths if they can't be accessed + if not os.access(current_path, os.R_OK): + return + filename = os.path.normcase(filename) + # list all files that start with ``filename`` + file_list = ( + x for x in os.listdir(current_path) if os.path.normcase(x).startswith(filename) + ) + for f in file_list: + opt = os.path.join(current_path, f) + comp_file = os.path.normcase(os.path.join(directory, f)) + # complete regular files when there is not ```` after option + # complete directories when there is ````, ```` or + # ````after option + if completion_type != "dir" and os.path.isfile(opt): + yield comp_file + elif os.path.isdir(opt): + yield os.path.join(comp_file, "") diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/base_command.py b/env/lib/python3.12/site-packages/pip/_internal/cli/base_command.py new file mode 100644 index 0000000..362f84b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/base_command.py @@ -0,0 +1,240 @@ +"""Base Command class, and related routines""" + +import logging +import logging.config +import optparse +import os +import sys +import traceback +from optparse import Values +from typing import List, Optional, Tuple + +from pip._vendor.rich import reconfigure +from pip._vendor.rich import traceback as rich_traceback + +from pip._internal.cli import cmdoptions +from pip._internal.cli.command_context import CommandContextMixIn +from pip._internal.cli.parser import ConfigOptionParser, UpdatingDefaultsHelpFormatter +from pip._internal.cli.status_codes import ( + ERROR, + PREVIOUS_BUILD_DIR_ERROR, + UNKNOWN_ERROR, + VIRTUALENV_NOT_FOUND, +) +from pip._internal.exceptions import ( + BadCommand, + CommandError, + DiagnosticPipError, + InstallationError, + NetworkConnectionError, + PreviousBuildDirError, +) +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.filesystem import check_path_owner +from pip._internal.utils.logging import BrokenStdoutLoggingError, setup_logging +from pip._internal.utils.misc import get_prog, normalize_path +from pip._internal.utils.temp_dir import TempDirectoryTypeRegistry as TempDirRegistry +from pip._internal.utils.temp_dir import global_tempdir_manager, tempdir_registry +from pip._internal.utils.virtualenv import running_under_virtualenv + +__all__ = ["Command"] + +logger = logging.getLogger(__name__) + + +class Command(CommandContextMixIn): + usage: str = "" + ignore_require_venv: bool = False + + def __init__(self, name: str, summary: str, isolated: bool = False) -> None: + super().__init__() + + self.name = name + self.summary = summary + self.parser = ConfigOptionParser( + usage=self.usage, + prog=f"{get_prog()} {name}", + formatter=UpdatingDefaultsHelpFormatter(), + add_help_option=False, + name=name, + description=self.__doc__, + isolated=isolated, + ) + + self.tempdir_registry: Optional[TempDirRegistry] = None + + # Commands should add options to this option group + optgroup_name = f"{self.name.capitalize()} Options" + self.cmd_opts = optparse.OptionGroup(self.parser, optgroup_name) + + # Add the general options + gen_opts = cmdoptions.make_option_group( + cmdoptions.general_group, + self.parser, + ) + self.parser.add_option_group(gen_opts) + + self.add_options() + + def add_options(self) -> None: + pass + + def handle_pip_version_check(self, options: Values) -> None: + """ + This is a no-op so that commands by default do not do the pip version + check. + """ + # Make sure we do the pip version check if the index_group options + # are present. + assert not hasattr(options, "no_index") + + def run(self, options: Values, args: List[str]) -> int: + raise NotImplementedError + + def _run_wrapper(self, level_number: int, options: Values, args: List[str]) -> int: + def _inner_run() -> int: + try: + return self.run(options, args) + finally: + self.handle_pip_version_check(options) + + if options.debug_mode: + rich_traceback.install(show_locals=True) + return _inner_run() + + try: + status = _inner_run() + assert isinstance(status, int) + return status + except DiagnosticPipError as exc: + logger.error("%s", exc, extra={"rich": True}) + logger.debug("Exception information:", exc_info=True) + + return ERROR + except PreviousBuildDirError as exc: + logger.critical(str(exc)) + logger.debug("Exception information:", exc_info=True) + + return PREVIOUS_BUILD_DIR_ERROR + except ( + InstallationError, + BadCommand, + NetworkConnectionError, + ) as exc: + logger.critical(str(exc)) + logger.debug("Exception information:", exc_info=True) + + return ERROR + except CommandError as exc: + logger.critical("%s", exc) + logger.debug("Exception information:", exc_info=True) + + return ERROR + except BrokenStdoutLoggingError: + # Bypass our logger and write any remaining messages to + # stderr because stdout no longer works. + print("ERROR: Pipe to stdout was broken", file=sys.stderr) + if level_number <= logging.DEBUG: + traceback.print_exc(file=sys.stderr) + + return ERROR + except KeyboardInterrupt: + logger.critical("Operation cancelled by user") + logger.debug("Exception information:", exc_info=True) + + return ERROR + except BaseException: + logger.critical("Exception:", exc_info=True) + + return UNKNOWN_ERROR + + def parse_args(self, args: List[str]) -> Tuple[Values, List[str]]: + # factored out for testability + return self.parser.parse_args(args) + + def main(self, args: List[str]) -> int: + try: + with self.main_context(): + return self._main(args) + finally: + logging.shutdown() + + def _main(self, args: List[str]) -> int: + # We must initialize this before the tempdir manager, otherwise the + # configuration would not be accessible by the time we clean up the + # tempdir manager. + self.tempdir_registry = self.enter_context(tempdir_registry()) + # Intentionally set as early as possible so globally-managed temporary + # directories are available to the rest of the code. + self.enter_context(global_tempdir_manager()) + + options, args = self.parse_args(args) + + # Set verbosity so that it can be used elsewhere. + self.verbosity = options.verbose - options.quiet + + reconfigure(no_color=options.no_color) + level_number = setup_logging( + verbosity=self.verbosity, + no_color=options.no_color, + user_log_file=options.log, + ) + + always_enabled_features = set(options.features_enabled) & set( + cmdoptions.ALWAYS_ENABLED_FEATURES + ) + if always_enabled_features: + logger.warning( + "The following features are always enabled: %s. ", + ", ".join(sorted(always_enabled_features)), + ) + + # Make sure that the --python argument isn't specified after the + # subcommand. We can tell, because if --python was specified, + # we should only reach this point if we're running in the created + # subprocess, which has the _PIP_RUNNING_IN_SUBPROCESS environment + # variable set. + if options.python and "_PIP_RUNNING_IN_SUBPROCESS" not in os.environ: + logger.critical( + "The --python option must be placed before the pip subcommand name" + ) + sys.exit(ERROR) + + # TODO: Try to get these passing down from the command? + # without resorting to os.environ to hold these. + # This also affects isolated builds and it should. + + if options.no_input: + os.environ["PIP_NO_INPUT"] = "1" + + if options.exists_action: + os.environ["PIP_EXISTS_ACTION"] = " ".join(options.exists_action) + + if options.require_venv and not self.ignore_require_venv: + # If a venv is required check if it can really be found + if not running_under_virtualenv(): + logger.critical("Could not find an activated virtualenv (required).") + sys.exit(VIRTUALENV_NOT_FOUND) + + if options.cache_dir: + options.cache_dir = normalize_path(options.cache_dir) + if not check_path_owner(options.cache_dir): + logger.warning( + "The directory '%s' or its parent directory is not owned " + "or is not writable by the current user. The cache " + "has been disabled. Check the permissions and owner of " + "that directory. If executing pip with sudo, you should " + "use sudo's -H flag.", + options.cache_dir, + ) + options.cache_dir = None + + if options.no_python_version_warning: + deprecated( + reason="--no-python-version-warning is deprecated.", + replacement="to remove the flag as it's a no-op", + gone_in="25.1", + issue=13154, + ) + + return self._run_wrapper(level_number, options, args) diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/cmdoptions.py b/env/lib/python3.12/site-packages/pip/_internal/cli/cmdoptions.py new file mode 100644 index 0000000..eeb7e65 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/cmdoptions.py @@ -0,0 +1,1075 @@ +""" +shared options and groups + +The principle here is to define options once, but *not* instantiate them +globally. One reason being that options with action='append' can carry state +between parses. pip parses general options twice internally, and shouldn't +pass on state. To be consistent, all options will follow this design. +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +import importlib.util +import logging +import os +import textwrap +from functools import partial +from optparse import SUPPRESS_HELP, Option, OptionGroup, OptionParser, Values +from textwrap import dedent +from typing import Any, Callable, Dict, Optional, Tuple + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.cli.parser import ConfigOptionParser +from pip._internal.exceptions import CommandError +from pip._internal.locations import USER_CACHE_DIR, get_src_prefix +from pip._internal.models.format_control import FormatControl +from pip._internal.models.index import PyPI +from pip._internal.models.target_python import TargetPython +from pip._internal.utils.hashes import STRONG_HASHES +from pip._internal.utils.misc import strtobool + +logger = logging.getLogger(__name__) + + +def raise_option_error(parser: OptionParser, option: Option, msg: str) -> None: + """ + Raise an option parsing error using parser.error(). + + Args: + parser: an OptionParser instance. + option: an Option instance. + msg: the error text. + """ + msg = f"{option} error: {msg}" + msg = textwrap.fill(" ".join(msg.split())) + parser.error(msg) + + +def make_option_group(group: Dict[str, Any], parser: ConfigOptionParser) -> OptionGroup: + """ + Return an OptionGroup object + group -- assumed to be dict with 'name' and 'options' keys + parser -- an optparse Parser + """ + option_group = OptionGroup(parser, group["name"]) + for option in group["options"]: + option_group.add_option(option()) + return option_group + + +def check_dist_restriction(options: Values, check_target: bool = False) -> None: + """Function for determining if custom platform options are allowed. + + :param options: The OptionParser options. + :param check_target: Whether or not to check if --target is being used. + """ + dist_restriction_set = any( + [ + options.python_version, + options.platforms, + options.abis, + options.implementation, + ] + ) + + binary_only = FormatControl(set(), {":all:"}) + sdist_dependencies_allowed = ( + options.format_control != binary_only and not options.ignore_dependencies + ) + + # Installations or downloads using dist restrictions must not combine + # source distributions and dist-specific wheels, as they are not + # guaranteed to be locally compatible. + if dist_restriction_set and sdist_dependencies_allowed: + raise CommandError( + "When restricting platform and interpreter constraints using " + "--python-version, --platform, --abi, or --implementation, " + "either --no-deps must be set, or --only-binary=:all: must be " + "set and --no-binary must not be set (or must be set to " + ":none:)." + ) + + if check_target: + if not options.dry_run and dist_restriction_set and not options.target_dir: + raise CommandError( + "Can not use any platform or abi specific options unless " + "installing via '--target' or using '--dry-run'" + ) + + +def _path_option_check(option: Option, opt: str, value: str) -> str: + return os.path.expanduser(value) + + +def _package_name_option_check(option: Option, opt: str, value: str) -> str: + return canonicalize_name(value) + + +class PipOption(Option): + TYPES = Option.TYPES + ("path", "package_name") + TYPE_CHECKER = Option.TYPE_CHECKER.copy() + TYPE_CHECKER["package_name"] = _package_name_option_check + TYPE_CHECKER["path"] = _path_option_check + + +########### +# options # +########### + +help_: Callable[..., Option] = partial( + Option, + "-h", + "--help", + dest="help", + action="help", + help="Show help.", +) + +debug_mode: Callable[..., Option] = partial( + Option, + "--debug", + dest="debug_mode", + action="store_true", + default=False, + help=( + "Let unhandled exceptions propagate outside the main subroutine, " + "instead of logging them to stderr." + ), +) + +isolated_mode: Callable[..., Option] = partial( + Option, + "--isolated", + dest="isolated_mode", + action="store_true", + default=False, + help=( + "Run pip in an isolated mode, ignoring environment variables and user " + "configuration." + ), +) + +require_virtualenv: Callable[..., Option] = partial( + Option, + "--require-virtualenv", + "--require-venv", + dest="require_venv", + action="store_true", + default=False, + help=( + "Allow pip to only run in a virtual environment; " + "exit with an error otherwise." + ), +) + +override_externally_managed: Callable[..., Option] = partial( + Option, + "--break-system-packages", + dest="override_externally_managed", + action="store_true", + help="Allow pip to modify an EXTERNALLY-MANAGED Python installation", +) + +python: Callable[..., Option] = partial( + Option, + "--python", + dest="python", + help="Run pip with the specified Python interpreter.", +) + +verbose: Callable[..., Option] = partial( + Option, + "-v", + "--verbose", + dest="verbose", + action="count", + default=0, + help="Give more output. Option is additive, and can be used up to 3 times.", +) + +no_color: Callable[..., Option] = partial( + Option, + "--no-color", + dest="no_color", + action="store_true", + default=False, + help="Suppress colored output.", +) + +version: Callable[..., Option] = partial( + Option, + "-V", + "--version", + dest="version", + action="store_true", + help="Show version and exit.", +) + +quiet: Callable[..., Option] = partial( + Option, + "-q", + "--quiet", + dest="quiet", + action="count", + default=0, + help=( + "Give less output. Option is additive, and can be used up to 3" + " times (corresponding to WARNING, ERROR, and CRITICAL logging" + " levels)." + ), +) + +progress_bar: Callable[..., Option] = partial( + Option, + "--progress-bar", + dest="progress_bar", + type="choice", + choices=["on", "off", "raw"], + default="on", + help="Specify whether the progress bar should be used [on, off, raw] (default: on)", +) + +log: Callable[..., Option] = partial( + PipOption, + "--log", + "--log-file", + "--local-log", + dest="log", + metavar="path", + type="path", + help="Path to a verbose appending log.", +) + +no_input: Callable[..., Option] = partial( + Option, + # Don't ask for input + "--no-input", + dest="no_input", + action="store_true", + default=False, + help="Disable prompting for input.", +) + +keyring_provider: Callable[..., Option] = partial( + Option, + "--keyring-provider", + dest="keyring_provider", + choices=["auto", "disabled", "import", "subprocess"], + default="auto", + help=( + "Enable the credential lookup via the keyring library if user input is allowed." + " Specify which mechanism to use [auto, disabled, import, subprocess]." + " (default: %default)" + ), +) + +proxy: Callable[..., Option] = partial( + Option, + "--proxy", + dest="proxy", + type="str", + default="", + help="Specify a proxy in the form scheme://[user:passwd@]proxy.server:port.", +) + +retries: Callable[..., Option] = partial( + Option, + "--retries", + dest="retries", + type="int", + default=5, + help="Maximum number of retries each connection should attempt " + "(default %default times).", +) + +timeout: Callable[..., Option] = partial( + Option, + "--timeout", + "--default-timeout", + metavar="sec", + dest="timeout", + type="float", + default=15, + help="Set the socket timeout (default %default seconds).", +) + + +def exists_action() -> Option: + return Option( + # Option when path already exist + "--exists-action", + dest="exists_action", + type="choice", + choices=["s", "i", "w", "b", "a"], + default=[], + action="append", + metavar="action", + help="Default action when a path already exists: " + "(s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.", + ) + + +cert: Callable[..., Option] = partial( + PipOption, + "--cert", + dest="cert", + type="path", + metavar="path", + help=( + "Path to PEM-encoded CA certificate bundle. " + "If provided, overrides the default. " + "See 'SSL Certificate Verification' in pip documentation " + "for more information." + ), +) + +client_cert: Callable[..., Option] = partial( + PipOption, + "--client-cert", + dest="client_cert", + type="path", + default=None, + metavar="path", + help="Path to SSL client certificate, a single file containing the " + "private key and the certificate in PEM format.", +) + +index_url: Callable[..., Option] = partial( + Option, + "-i", + "--index-url", + "--pypi-url", + dest="index_url", + metavar="URL", + default=PyPI.simple_url, + help="Base URL of the Python Package Index (default %default). " + "This should point to a repository compliant with PEP 503 " + "(the simple repository API) or a local directory laid out " + "in the same format.", +) + + +def extra_index_url() -> Option: + return Option( + "--extra-index-url", + dest="extra_index_urls", + metavar="URL", + action="append", + default=[], + help="Extra URLs of package indexes to use in addition to " + "--index-url. Should follow the same rules as " + "--index-url.", + ) + + +no_index: Callable[..., Option] = partial( + Option, + "--no-index", + dest="no_index", + action="store_true", + default=False, + help="Ignore package index (only looking at --find-links URLs instead).", +) + + +def find_links() -> Option: + return Option( + "-f", + "--find-links", + dest="find_links", + action="append", + default=[], + metavar="url", + help="If a URL or path to an html file, then parse for links to " + "archives such as sdist (.tar.gz) or wheel (.whl) files. " + "If a local path or file:// URL that's a directory, " + "then look for archives in the directory listing. " + "Links to VCS project URLs are not supported.", + ) + + +def trusted_host() -> Option: + return Option( + "--trusted-host", + dest="trusted_hosts", + action="append", + metavar="HOSTNAME", + default=[], + help="Mark this host or host:port pair as trusted, even though it " + "does not have valid or any HTTPS.", + ) + + +def constraints() -> Option: + return Option( + "-c", + "--constraint", + dest="constraints", + action="append", + default=[], + metavar="file", + help="Constrain versions using the given constraints file. " + "This option can be used multiple times.", + ) + + +def requirements() -> Option: + return Option( + "-r", + "--requirement", + dest="requirements", + action="append", + default=[], + metavar="file", + help="Install from the given requirements file. " + "This option can be used multiple times.", + ) + + +def editable() -> Option: + return Option( + "-e", + "--editable", + dest="editables", + action="append", + default=[], + metavar="path/url", + help=( + "Install a project in editable mode (i.e. setuptools " + '"develop mode") from a local project path or a VCS url.' + ), + ) + + +def _handle_src(option: Option, opt_str: str, value: str, parser: OptionParser) -> None: + value = os.path.abspath(value) + setattr(parser.values, option.dest, value) + + +src: Callable[..., Option] = partial( + PipOption, + "--src", + "--source", + "--source-dir", + "--source-directory", + dest="src_dir", + type="path", + metavar="dir", + default=get_src_prefix(), + action="callback", + callback=_handle_src, + help="Directory to check out editable projects into. " + 'The default in a virtualenv is "/src". ' + 'The default for global installs is "/src".', +) + + +def _get_format_control(values: Values, option: Option) -> Any: + """Get a format_control object.""" + return getattr(values, option.dest) + + +def _handle_no_binary( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + existing = _get_format_control(parser.values, option) + FormatControl.handle_mutual_excludes( + value, + existing.no_binary, + existing.only_binary, + ) + + +def _handle_only_binary( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + existing = _get_format_control(parser.values, option) + FormatControl.handle_mutual_excludes( + value, + existing.only_binary, + existing.no_binary, + ) + + +def no_binary() -> Option: + format_control = FormatControl(set(), set()) + return Option( + "--no-binary", + dest="format_control", + action="callback", + callback=_handle_no_binary, + type="str", + default=format_control, + help="Do not use binary packages. Can be supplied multiple times, and " + 'each time adds to the existing value. Accepts either ":all:" to ' + 'disable all binary packages, ":none:" to empty the set (notice ' + "the colons), or one or more package names with commas between " + "them (no colons). Note that some packages are tricky to compile " + "and may fail to install when this option is used on them.", + ) + + +def only_binary() -> Option: + format_control = FormatControl(set(), set()) + return Option( + "--only-binary", + dest="format_control", + action="callback", + callback=_handle_only_binary, + type="str", + default=format_control, + help="Do not use source packages. Can be supplied multiple times, and " + 'each time adds to the existing value. Accepts either ":all:" to ' + 'disable all source packages, ":none:" to empty the set, or one ' + "or more package names with commas between them. Packages " + "without binary distributions will fail to install when this " + "option is used on them.", + ) + + +platforms: Callable[..., Option] = partial( + Option, + "--platform", + dest="platforms", + metavar="platform", + action="append", + default=None, + help=( + "Only use wheels compatible with . Defaults to the " + "platform of the running system. Use this option multiple times to " + "specify multiple platforms supported by the target interpreter." + ), +) + + +# This was made a separate function for unit-testing purposes. +def _convert_python_version(value: str) -> Tuple[Tuple[int, ...], Optional[str]]: + """ + Convert a version string like "3", "37", or "3.7.3" into a tuple of ints. + + :return: A 2-tuple (version_info, error_msg), where `error_msg` is + non-None if and only if there was a parsing error. + """ + if not value: + # The empty string is the same as not providing a value. + return (None, None) + + parts = value.split(".") + if len(parts) > 3: + return ((), "at most three version parts are allowed") + + if len(parts) == 1: + # Then we are in the case of "3" or "37". + value = parts[0] + if len(value) > 1: + parts = [value[0], value[1:]] + + try: + version_info = tuple(int(part) for part in parts) + except ValueError: + return ((), "each version part must be an integer") + + return (version_info, None) + + +def _handle_python_version( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + """ + Handle a provided --python-version value. + """ + version_info, error_msg = _convert_python_version(value) + if error_msg is not None: + msg = f"invalid --python-version value: {value!r}: {error_msg}" + raise_option_error(parser, option=option, msg=msg) + + parser.values.python_version = version_info + + +python_version: Callable[..., Option] = partial( + Option, + "--python-version", + dest="python_version", + metavar="python_version", + action="callback", + callback=_handle_python_version, + type="str", + default=None, + help=dedent( + """\ + The Python interpreter version to use for wheel and "Requires-Python" + compatibility checks. Defaults to a version derived from the running + interpreter. The version can be specified using up to three dot-separated + integers (e.g. "3" for 3.0.0, "3.7" for 3.7.0, or "3.7.3"). A major-minor + version can also be given as a string without dots (e.g. "37" for 3.7.0). + """ + ), +) + + +implementation: Callable[..., Option] = partial( + Option, + "--implementation", + dest="implementation", + metavar="implementation", + default=None, + help=( + "Only use wheels compatible with Python " + "implementation , e.g. 'pp', 'jy', 'cp', " + " or 'ip'. If not specified, then the current " + "interpreter implementation is used. Use 'py' to force " + "implementation-agnostic wheels." + ), +) + + +abis: Callable[..., Option] = partial( + Option, + "--abi", + dest="abis", + metavar="abi", + action="append", + default=None, + help=( + "Only use wheels compatible with Python abi , e.g. 'pypy_41'. " + "If not specified, then the current interpreter abi tag is used. " + "Use this option multiple times to specify multiple abis supported " + "by the target interpreter. Generally you will need to specify " + "--implementation, --platform, and --python-version when using this " + "option." + ), +) + + +def add_target_python_options(cmd_opts: OptionGroup) -> None: + cmd_opts.add_option(platforms()) + cmd_opts.add_option(python_version()) + cmd_opts.add_option(implementation()) + cmd_opts.add_option(abis()) + + +def make_target_python(options: Values) -> TargetPython: + target_python = TargetPython( + platforms=options.platforms, + py_version_info=options.python_version, + abis=options.abis, + implementation=options.implementation, + ) + + return target_python + + +def prefer_binary() -> Option: + return Option( + "--prefer-binary", + dest="prefer_binary", + action="store_true", + default=False, + help=( + "Prefer binary packages over source packages, even if the " + "source packages are newer." + ), + ) + + +cache_dir: Callable[..., Option] = partial( + PipOption, + "--cache-dir", + dest="cache_dir", + default=USER_CACHE_DIR, + metavar="dir", + type="path", + help="Store the cache data in .", +) + + +def _handle_no_cache_dir( + option: Option, opt: str, value: str, parser: OptionParser +) -> None: + """ + Process a value provided for the --no-cache-dir option. + + This is an optparse.Option callback for the --no-cache-dir option. + """ + # The value argument will be None if --no-cache-dir is passed via the + # command-line, since the option doesn't accept arguments. However, + # the value can be non-None if the option is triggered e.g. by an + # environment variable, like PIP_NO_CACHE_DIR=true. + if value is not None: + # Then parse the string value to get argument error-checking. + try: + strtobool(value) + except ValueError as exc: + raise_option_error(parser, option=option, msg=str(exc)) + + # Originally, setting PIP_NO_CACHE_DIR to a value that strtobool() + # converted to 0 (like "false" or "no") caused cache_dir to be disabled + # rather than enabled (logic would say the latter). Thus, we disable + # the cache directory not just on values that parse to True, but (for + # backwards compatibility reasons) also on values that parse to False. + # In other words, always set it to False if the option is provided in + # some (valid) form. + parser.values.cache_dir = False + + +no_cache: Callable[..., Option] = partial( + Option, + "--no-cache-dir", + dest="cache_dir", + action="callback", + callback=_handle_no_cache_dir, + help="Disable the cache.", +) + +no_deps: Callable[..., Option] = partial( + Option, + "--no-deps", + "--no-dependencies", + dest="ignore_dependencies", + action="store_true", + default=False, + help="Don't install package dependencies.", +) + +ignore_requires_python: Callable[..., Option] = partial( + Option, + "--ignore-requires-python", + dest="ignore_requires_python", + action="store_true", + help="Ignore the Requires-Python information.", +) + +no_build_isolation: Callable[..., Option] = partial( + Option, + "--no-build-isolation", + dest="build_isolation", + action="store_false", + default=True, + help="Disable isolation when building a modern source distribution. " + "Build dependencies specified by PEP 518 must be already installed " + "if this option is used.", +) + +check_build_deps: Callable[..., Option] = partial( + Option, + "--check-build-dependencies", + dest="check_build_deps", + action="store_true", + default=False, + help="Check the build dependencies when PEP517 is used.", +) + + +def _handle_no_use_pep517( + option: Option, opt: str, value: str, parser: OptionParser +) -> None: + """ + Process a value provided for the --no-use-pep517 option. + + This is an optparse.Option callback for the no_use_pep517 option. + """ + # Since --no-use-pep517 doesn't accept arguments, the value argument + # will be None if --no-use-pep517 is passed via the command-line. + # However, the value can be non-None if the option is triggered e.g. + # by an environment variable, for example "PIP_NO_USE_PEP517=true". + if value is not None: + msg = """A value was passed for --no-use-pep517, + probably using either the PIP_NO_USE_PEP517 environment variable + or the "no-use-pep517" config file option. Use an appropriate value + of the PIP_USE_PEP517 environment variable or the "use-pep517" + config file option instead. + """ + raise_option_error(parser, option=option, msg=msg) + + # If user doesn't wish to use pep517, we check if setuptools and wheel are installed + # and raise error if it is not. + packages = ("setuptools", "wheel") + if not all(importlib.util.find_spec(package) for package in packages): + msg = ( + f"It is not possible to use --no-use-pep517 " + f"without {' and '.join(packages)} installed." + ) + raise_option_error(parser, option=option, msg=msg) + + # Otherwise, --no-use-pep517 was passed via the command-line. + parser.values.use_pep517 = False + + +use_pep517: Any = partial( + Option, + "--use-pep517", + dest="use_pep517", + action="store_true", + default=None, + help="Use PEP 517 for building source distributions " + "(use --no-use-pep517 to force legacy behaviour).", +) + +no_use_pep517: Any = partial( + Option, + "--no-use-pep517", + dest="use_pep517", + action="callback", + callback=_handle_no_use_pep517, + default=None, + help=SUPPRESS_HELP, +) + + +def _handle_config_settings( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + key, sep, val = value.partition("=") + if sep != "=": + parser.error(f"Arguments to {opt_str} must be of the form KEY=VAL") + dest = getattr(parser.values, option.dest) + if dest is None: + dest = {} + setattr(parser.values, option.dest, dest) + if key in dest: + if isinstance(dest[key], list): + dest[key].append(val) + else: + dest[key] = [dest[key], val] + else: + dest[key] = val + + +config_settings: Callable[..., Option] = partial( + Option, + "-C", + "--config-settings", + dest="config_settings", + type=str, + action="callback", + callback=_handle_config_settings, + metavar="settings", + help="Configuration settings to be passed to the PEP 517 build backend. " + "Settings take the form KEY=VALUE. Use multiple --config-settings options " + "to pass multiple keys to the backend.", +) + +build_options: Callable[..., Option] = partial( + Option, + "--build-option", + dest="build_options", + metavar="options", + action="append", + help="Extra arguments to be supplied to 'setup.py bdist_wheel'.", +) + +global_options: Callable[..., Option] = partial( + Option, + "--global-option", + dest="global_options", + action="append", + metavar="options", + help="Extra global options to be supplied to the setup.py " + "call before the install or bdist_wheel command.", +) + +no_clean: Callable[..., Option] = partial( + Option, + "--no-clean", + action="store_true", + default=False, + help="Don't clean up build directories.", +) + +pre: Callable[..., Option] = partial( + Option, + "--pre", + action="store_true", + default=False, + help="Include pre-release and development versions. By default, " + "pip only finds stable versions.", +) + +disable_pip_version_check: Callable[..., Option] = partial( + Option, + "--disable-pip-version-check", + dest="disable_pip_version_check", + action="store_true", + default=False, + help="Don't periodically check PyPI to determine whether a new version " + "of pip is available for download. Implied with --no-index.", +) + +root_user_action: Callable[..., Option] = partial( + Option, + "--root-user-action", + dest="root_user_action", + default="warn", + choices=["warn", "ignore"], + help="Action if pip is run as a root user [warn, ignore] (default: warn)", +) + + +def _handle_merge_hash( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + """Given a value spelled "algo:digest", append the digest to a list + pointed to in a dict by the algo name.""" + if not parser.values.hashes: + parser.values.hashes = {} + try: + algo, digest = value.split(":", 1) + except ValueError: + parser.error( + f"Arguments to {opt_str} must be a hash name " + "followed by a value, like --hash=sha256:" + "abcde..." + ) + if algo not in STRONG_HASHES: + parser.error( + "Allowed hash algorithms for {} are {}.".format( + opt_str, ", ".join(STRONG_HASHES) + ) + ) + parser.values.hashes.setdefault(algo, []).append(digest) + + +hash: Callable[..., Option] = partial( + Option, + "--hash", + # Hash values eventually end up in InstallRequirement.hashes due to + # __dict__ copying in process_line(). + dest="hashes", + action="callback", + callback=_handle_merge_hash, + type="string", + help="Verify that the package's archive matches this " + "hash before installing. Example: --hash=sha256:abcdef...", +) + + +require_hashes: Callable[..., Option] = partial( + Option, + "--require-hashes", + dest="require_hashes", + action="store_true", + default=False, + help="Require a hash to check each requirement against, for " + "repeatable installs. This option is implied when any package in a " + "requirements file has a --hash option.", +) + + +list_path: Callable[..., Option] = partial( + PipOption, + "--path", + dest="path", + type="path", + action="append", + help="Restrict to the specified installation path for listing " + "packages (can be used multiple times).", +) + + +def check_list_path_option(options: Values) -> None: + if options.path and (options.user or options.local): + raise CommandError("Cannot combine '--path' with '--user' or '--local'") + + +list_exclude: Callable[..., Option] = partial( + PipOption, + "--exclude", + dest="excludes", + action="append", + metavar="package", + type="package_name", + help="Exclude specified package from the output", +) + + +no_python_version_warning: Callable[..., Option] = partial( + Option, + "--no-python-version-warning", + dest="no_python_version_warning", + action="store_true", + default=False, + help="Silence deprecation warnings for upcoming unsupported Pythons.", +) + + +# Features that are now always on. A warning is printed if they are used. +ALWAYS_ENABLED_FEATURES = [ + "truststore", # always on since 24.2 + "no-binary-enable-wheel-cache", # always on since 23.1 +] + +use_new_feature: Callable[..., Option] = partial( + Option, + "--use-feature", + dest="features_enabled", + metavar="feature", + action="append", + default=[], + choices=[ + "fast-deps", + ] + + ALWAYS_ENABLED_FEATURES, + help="Enable new functionality, that may be backward incompatible.", +) + +use_deprecated_feature: Callable[..., Option] = partial( + Option, + "--use-deprecated", + dest="deprecated_features_enabled", + metavar="feature", + action="append", + default=[], + choices=[ + "legacy-resolver", + "legacy-certs", + ], + help=("Enable deprecated functionality, that will be removed in the future."), +) + + +########## +# groups # +########## + +general_group: Dict[str, Any] = { + "name": "General Options", + "options": [ + help_, + debug_mode, + isolated_mode, + require_virtualenv, + python, + verbose, + version, + quiet, + log, + no_input, + keyring_provider, + proxy, + retries, + timeout, + exists_action, + trusted_host, + cert, + client_cert, + cache_dir, + no_cache, + disable_pip_version_check, + no_color, + no_python_version_warning, + use_new_feature, + use_deprecated_feature, + ], +} + +index_group: Dict[str, Any] = { + "name": "Package Index Options", + "options": [ + index_url, + extra_index_url, + no_index, + find_links, + ], +} diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/command_context.py b/env/lib/python3.12/site-packages/pip/_internal/cli/command_context.py new file mode 100644 index 0000000..139995a --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/command_context.py @@ -0,0 +1,27 @@ +from contextlib import ExitStack, contextmanager +from typing import ContextManager, Generator, TypeVar + +_T = TypeVar("_T", covariant=True) + + +class CommandContextMixIn: + def __init__(self) -> None: + super().__init__() + self._in_main_context = False + self._main_context = ExitStack() + + @contextmanager + def main_context(self) -> Generator[None, None, None]: + assert not self._in_main_context + + self._in_main_context = True + try: + with self._main_context: + yield + finally: + self._in_main_context = False + + def enter_context(self, context_provider: ContextManager[_T]) -> _T: + assert self._in_main_context + + return self._main_context.enter_context(context_provider) diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/index_command.py b/env/lib/python3.12/site-packages/pip/_internal/cli/index_command.py new file mode 100644 index 0000000..295108e --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/index_command.py @@ -0,0 +1,171 @@ +""" +Contains command classes which may interact with an index / the network. + +Unlike its sister module, req_command, this module still uses lazy imports +so commands which don't always hit the network (e.g. list w/o --outdated or +--uptodate) don't need waste time importing PipSession and friends. +""" + +import logging +import os +import sys +from optparse import Values +from typing import TYPE_CHECKING, List, Optional + +from pip._vendor import certifi + +from pip._internal.cli.base_command import Command +from pip._internal.cli.command_context import CommandContextMixIn + +if TYPE_CHECKING: + from ssl import SSLContext + + from pip._internal.network.session import PipSession + +logger = logging.getLogger(__name__) + + +def _create_truststore_ssl_context() -> Optional["SSLContext"]: + if sys.version_info < (3, 10): + logger.debug("Disabling truststore because Python version isn't 3.10+") + return None + + try: + import ssl + except ImportError: + logger.warning("Disabling truststore since ssl support is missing") + return None + + try: + from pip._vendor import truststore + except ImportError: + logger.warning("Disabling truststore because platform isn't supported") + return None + + ctx = truststore.SSLContext(ssl.PROTOCOL_TLS_CLIENT) + ctx.load_verify_locations(certifi.where()) + return ctx + + +class SessionCommandMixin(CommandContextMixIn): + """ + A class mixin for command classes needing _build_session(). + """ + + def __init__(self) -> None: + super().__init__() + self._session: Optional[PipSession] = None + + @classmethod + def _get_index_urls(cls, options: Values) -> Optional[List[str]]: + """Return a list of index urls from user-provided options.""" + index_urls = [] + if not getattr(options, "no_index", False): + url = getattr(options, "index_url", None) + if url: + index_urls.append(url) + urls = getattr(options, "extra_index_urls", None) + if urls: + index_urls.extend(urls) + # Return None rather than an empty list + return index_urls or None + + def get_default_session(self, options: Values) -> "PipSession": + """Get a default-managed session.""" + if self._session is None: + self._session = self.enter_context(self._build_session(options)) + # there's no type annotation on requests.Session, so it's + # automatically ContextManager[Any] and self._session becomes Any, + # then https://github.com/python/mypy/issues/7696 kicks in + assert self._session is not None + return self._session + + def _build_session( + self, + options: Values, + retries: Optional[int] = None, + timeout: Optional[int] = None, + ) -> "PipSession": + from pip._internal.network.session import PipSession + + cache_dir = options.cache_dir + assert not cache_dir or os.path.isabs(cache_dir) + + if "legacy-certs" not in options.deprecated_features_enabled: + ssl_context = _create_truststore_ssl_context() + else: + ssl_context = None + + session = PipSession( + cache=os.path.join(cache_dir, "http-v2") if cache_dir else None, + retries=retries if retries is not None else options.retries, + trusted_hosts=options.trusted_hosts, + index_urls=self._get_index_urls(options), + ssl_context=ssl_context, + ) + + # Handle custom ca-bundles from the user + if options.cert: + session.verify = options.cert + + # Handle SSL client certificate + if options.client_cert: + session.cert = options.client_cert + + # Handle timeouts + if options.timeout or timeout: + session.timeout = timeout if timeout is not None else options.timeout + + # Handle configured proxies + if options.proxy: + session.proxies = { + "http": options.proxy, + "https": options.proxy, + } + session.trust_env = False + session.pip_proxy = options.proxy + + # Determine if we can prompt the user for authentication or not + session.auth.prompting = not options.no_input + session.auth.keyring_provider = options.keyring_provider + + return session + + +def _pip_self_version_check(session: "PipSession", options: Values) -> None: + from pip._internal.self_outdated_check import pip_self_version_check as check + + check(session, options) + + +class IndexGroupCommand(Command, SessionCommandMixin): + """ + Abstract base class for commands with the index_group options. + + This also corresponds to the commands that permit the pip version check. + """ + + def handle_pip_version_check(self, options: Values) -> None: + """ + Do the pip version check if not disabled. + + This overrides the default behavior of not doing the check. + """ + # Make sure the index_group options are present. + assert hasattr(options, "no_index") + + if options.disable_pip_version_check or options.no_index: + return + + try: + # Otherwise, check if we're using the latest version of pip available. + session = self._build_session( + options, + retries=0, + timeout=min(5, options.timeout), + ) + with session: + _pip_self_version_check(session, options) + except Exception: + logger.warning("There was an error checking the latest version of pip.") + logger.debug("See below for error", exc_info=True) diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/main.py b/env/lib/python3.12/site-packages/pip/_internal/cli/main.py new file mode 100644 index 0000000..563ac79 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/main.py @@ -0,0 +1,80 @@ +"""Primary application entrypoint. +""" + +import locale +import logging +import os +import sys +import warnings +from typing import List, Optional + +from pip._internal.cli.autocompletion import autocomplete +from pip._internal.cli.main_parser import parse_command +from pip._internal.commands import create_command +from pip._internal.exceptions import PipError +from pip._internal.utils import deprecation + +logger = logging.getLogger(__name__) + + +# Do not import and use main() directly! Using it directly is actively +# discouraged by pip's maintainers. The name, location and behavior of +# this function is subject to change, so calling it directly is not +# portable across different pip versions. + +# In addition, running pip in-process is unsupported and unsafe. This is +# elaborated in detail at +# https://pip.pypa.io/en/stable/user_guide/#using-pip-from-your-program. +# That document also provides suggestions that should work for nearly +# all users that are considering importing and using main() directly. + +# However, we know that certain users will still want to invoke pip +# in-process. If you understand and accept the implications of using pip +# in an unsupported manner, the best approach is to use runpy to avoid +# depending on the exact location of this entry point. + +# The following example shows how to use runpy to invoke pip in that +# case: +# +# sys.argv = ["pip", your, args, here] +# runpy.run_module("pip", run_name="__main__") +# +# Note that this will exit the process after running, unlike a direct +# call to main. As it is not safe to do any processing after calling +# main, this should not be an issue in practice. + + +def main(args: Optional[List[str]] = None) -> int: + if args is None: + args = sys.argv[1:] + + # Suppress the pkg_resources deprecation warning + # Note - we use a module of .*pkg_resources to cover + # the normal case (pip._vendor.pkg_resources) and the + # devendored case (a bare pkg_resources) + warnings.filterwarnings( + action="ignore", category=DeprecationWarning, module=".*pkg_resources" + ) + + # Configure our deprecation warnings to be sent through loggers + deprecation.install_warning_logger() + + autocomplete() + + try: + cmd_name, cmd_args = parse_command(args) + except PipError as exc: + sys.stderr.write(f"ERROR: {exc}") + sys.stderr.write(os.linesep) + sys.exit(1) + + # Needed for locale.getpreferredencoding(False) to work + # in pip._internal.utils.encoding.auto_decode + try: + locale.setlocale(locale.LC_ALL, "") + except locale.Error as e: + # setlocale can apparently crash if locale are uninitialized + logger.debug("Ignoring error %s when setting locale", e) + command = create_command(cmd_name, isolated=("--isolated" in cmd_args)) + + return command.main(cmd_args) diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/main_parser.py b/env/lib/python3.12/site-packages/pip/_internal/cli/main_parser.py new file mode 100644 index 0000000..5ade356 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/main_parser.py @@ -0,0 +1,134 @@ +"""A single place for constructing and exposing the main parser +""" + +import os +import subprocess +import sys +from typing import List, Optional, Tuple + +from pip._internal.build_env import get_runnable_pip +from pip._internal.cli import cmdoptions +from pip._internal.cli.parser import ConfigOptionParser, UpdatingDefaultsHelpFormatter +from pip._internal.commands import commands_dict, get_similar_commands +from pip._internal.exceptions import CommandError +from pip._internal.utils.misc import get_pip_version, get_prog + +__all__ = ["create_main_parser", "parse_command"] + + +def create_main_parser() -> ConfigOptionParser: + """Creates and returns the main parser for pip's CLI""" + + parser = ConfigOptionParser( + usage="\n%prog [options]", + add_help_option=False, + formatter=UpdatingDefaultsHelpFormatter(), + name="global", + prog=get_prog(), + ) + parser.disable_interspersed_args() + + parser.version = get_pip_version() + + # add the general options + gen_opts = cmdoptions.make_option_group(cmdoptions.general_group, parser) + parser.add_option_group(gen_opts) + + # so the help formatter knows + parser.main = True # type: ignore + + # create command listing for description + description = [""] + [ + f"{name:27} {command_info.summary}" + for name, command_info in commands_dict.items() + ] + parser.description = "\n".join(description) + + return parser + + +def identify_python_interpreter(python: str) -> Optional[str]: + # If the named file exists, use it. + # If it's a directory, assume it's a virtual environment and + # look for the environment's Python executable. + if os.path.exists(python): + if os.path.isdir(python): + # bin/python for Unix, Scripts/python.exe for Windows + # Try both in case of odd cases like cygwin. + for exe in ("bin/python", "Scripts/python.exe"): + py = os.path.join(python, exe) + if os.path.exists(py): + return py + else: + return python + + # Could not find the interpreter specified + return None + + +def parse_command(args: List[str]) -> Tuple[str, List[str]]: + parser = create_main_parser() + + # Note: parser calls disable_interspersed_args(), so the result of this + # call is to split the initial args into the general options before the + # subcommand and everything else. + # For example: + # args: ['--timeout=5', 'install', '--user', 'INITools'] + # general_options: ['--timeout==5'] + # args_else: ['install', '--user', 'INITools'] + general_options, args_else = parser.parse_args(args) + + # --python + if general_options.python and "_PIP_RUNNING_IN_SUBPROCESS" not in os.environ: + # Re-invoke pip using the specified Python interpreter + interpreter = identify_python_interpreter(general_options.python) + if interpreter is None: + raise CommandError( + f"Could not locate Python interpreter {general_options.python}" + ) + + pip_cmd = [ + interpreter, + get_runnable_pip(), + ] + pip_cmd.extend(args) + + # Set a flag so the child doesn't re-invoke itself, causing + # an infinite loop. + os.environ["_PIP_RUNNING_IN_SUBPROCESS"] = "1" + returncode = 0 + try: + proc = subprocess.run(pip_cmd) + returncode = proc.returncode + except (subprocess.SubprocessError, OSError) as exc: + raise CommandError(f"Failed to run pip under {interpreter}: {exc}") + sys.exit(returncode) + + # --version + if general_options.version: + sys.stdout.write(parser.version) + sys.stdout.write(os.linesep) + sys.exit() + + # pip || pip help -> print_help() + if not args_else or (args_else[0] == "help" and len(args_else) == 1): + parser.print_help() + sys.exit() + + # the subcommand name + cmd_name = args_else[0] + + if cmd_name not in commands_dict: + guess = get_similar_commands(cmd_name) + + msg = [f'unknown command "{cmd_name}"'] + if guess: + msg.append(f'maybe you meant "{guess}"') + + raise CommandError(" - ".join(msg)) + + # all the args without the subcommand + cmd_args = args[:] + cmd_args.remove(cmd_name) + + return cmd_name, cmd_args diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/parser.py b/env/lib/python3.12/site-packages/pip/_internal/cli/parser.py new file mode 100644 index 0000000..bc4aca0 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/parser.py @@ -0,0 +1,294 @@ +"""Base option parser setup""" + +import logging +import optparse +import shutil +import sys +import textwrap +from contextlib import suppress +from typing import Any, Dict, Generator, List, NoReturn, Optional, Tuple + +from pip._internal.cli.status_codes import UNKNOWN_ERROR +from pip._internal.configuration import Configuration, ConfigurationError +from pip._internal.utils.misc import redact_auth_from_url, strtobool + +logger = logging.getLogger(__name__) + + +class PrettyHelpFormatter(optparse.IndentedHelpFormatter): + """A prettier/less verbose help formatter for optparse.""" + + def __init__(self, *args: Any, **kwargs: Any) -> None: + # help position must be aligned with __init__.parseopts.description + kwargs["max_help_position"] = 30 + kwargs["indent_increment"] = 1 + kwargs["width"] = shutil.get_terminal_size()[0] - 2 + super().__init__(*args, **kwargs) + + def format_option_strings(self, option: optparse.Option) -> str: + return self._format_option_strings(option) + + def _format_option_strings( + self, option: optparse.Option, mvarfmt: str = " <{}>", optsep: str = ", " + ) -> str: + """ + Return a comma-separated list of option strings and metavars. + + :param option: tuple of (short opt, long opt), e.g: ('-f', '--format') + :param mvarfmt: metavar format string + :param optsep: separator + """ + opts = [] + + if option._short_opts: + opts.append(option._short_opts[0]) + if option._long_opts: + opts.append(option._long_opts[0]) + if len(opts) > 1: + opts.insert(1, optsep) + + if option.takes_value(): + assert option.dest is not None + metavar = option.metavar or option.dest.lower() + opts.append(mvarfmt.format(metavar.lower())) + + return "".join(opts) + + def format_heading(self, heading: str) -> str: + if heading == "Options": + return "" + return heading + ":\n" + + def format_usage(self, usage: str) -> str: + """ + Ensure there is only one newline between usage and the first heading + if there is no description. + """ + msg = "\nUsage: {}\n".format(self.indent_lines(textwrap.dedent(usage), " ")) + return msg + + def format_description(self, description: Optional[str]) -> str: + # leave full control over description to us + if description: + if hasattr(self.parser, "main"): + label = "Commands" + else: + label = "Description" + # some doc strings have initial newlines, some don't + description = description.lstrip("\n") + # some doc strings have final newlines and spaces, some don't + description = description.rstrip() + # dedent, then reindent + description = self.indent_lines(textwrap.dedent(description), " ") + description = f"{label}:\n{description}\n" + return description + else: + return "" + + def format_epilog(self, epilog: Optional[str]) -> str: + # leave full control over epilog to us + if epilog: + return epilog + else: + return "" + + def indent_lines(self, text: str, indent: str) -> str: + new_lines = [indent + line for line in text.split("\n")] + return "\n".join(new_lines) + + +class UpdatingDefaultsHelpFormatter(PrettyHelpFormatter): + """Custom help formatter for use in ConfigOptionParser. + + This is updates the defaults before expanding them, allowing + them to show up correctly in the help listing. + + Also redact auth from url type options + """ + + def expand_default(self, option: optparse.Option) -> str: + default_values = None + if self.parser is not None: + assert isinstance(self.parser, ConfigOptionParser) + self.parser._update_defaults(self.parser.defaults) + assert option.dest is not None + default_values = self.parser.defaults.get(option.dest) + help_text = super().expand_default(option) + + if default_values and option.metavar == "URL": + if isinstance(default_values, str): + default_values = [default_values] + + # If its not a list, we should abort and just return the help text + if not isinstance(default_values, list): + default_values = [] + + for val in default_values: + help_text = help_text.replace(val, redact_auth_from_url(val)) + + return help_text + + +class CustomOptionParser(optparse.OptionParser): + def insert_option_group( + self, idx: int, *args: Any, **kwargs: Any + ) -> optparse.OptionGroup: + """Insert an OptionGroup at a given position.""" + group = self.add_option_group(*args, **kwargs) + + self.option_groups.pop() + self.option_groups.insert(idx, group) + + return group + + @property + def option_list_all(self) -> List[optparse.Option]: + """Get a list of all options, including those in option groups.""" + res = self.option_list[:] + for i in self.option_groups: + res.extend(i.option_list) + + return res + + +class ConfigOptionParser(CustomOptionParser): + """Custom option parser which updates its defaults by checking the + configuration files and environmental variables""" + + def __init__( + self, + *args: Any, + name: str, + isolated: bool = False, + **kwargs: Any, + ) -> None: + self.name = name + self.config = Configuration(isolated) + + assert self.name + super().__init__(*args, **kwargs) + + def check_default(self, option: optparse.Option, key: str, val: Any) -> Any: + try: + return option.check_value(key, val) + except optparse.OptionValueError as exc: + print(f"An error occurred during configuration: {exc}") + sys.exit(3) + + def _get_ordered_configuration_items( + self, + ) -> Generator[Tuple[str, Any], None, None]: + # Configuration gives keys in an unordered manner. Order them. + override_order = ["global", self.name, ":env:"] + + # Pool the options into different groups + section_items: Dict[str, List[Tuple[str, Any]]] = { + name: [] for name in override_order + } + for section_key, val in self.config.items(): + # ignore empty values + if not val: + logger.debug( + "Ignoring configuration key '%s' as it's value is empty.", + section_key, + ) + continue + + section, key = section_key.split(".", 1) + if section in override_order: + section_items[section].append((key, val)) + + # Yield each group in their override order + for section in override_order: + for key, val in section_items[section]: + yield key, val + + def _update_defaults(self, defaults: Dict[str, Any]) -> Dict[str, Any]: + """Updates the given defaults with values from the config files and + the environ. Does a little special handling for certain types of + options (lists).""" + + # Accumulate complex default state. + self.values = optparse.Values(self.defaults) + late_eval = set() + # Then set the options with those values + for key, val in self._get_ordered_configuration_items(): + # '--' because configuration supports only long names + option = self.get_option("--" + key) + + # Ignore options not present in this parser. E.g. non-globals put + # in [global] by users that want them to apply to all applicable + # commands. + if option is None: + continue + + assert option.dest is not None + + if option.action in ("store_true", "store_false"): + try: + val = strtobool(val) + except ValueError: + self.error( + f"{val} is not a valid value for {key} option, " + "please specify a boolean value like yes/no, " + "true/false or 1/0 instead." + ) + elif option.action == "count": + with suppress(ValueError): + val = strtobool(val) + with suppress(ValueError): + val = int(val) + if not isinstance(val, int) or val < 0: + self.error( + f"{val} is not a valid value for {key} option, " + "please instead specify either a non-negative integer " + "or a boolean value like yes/no or false/true " + "which is equivalent to 1/0." + ) + elif option.action == "append": + val = val.split() + val = [self.check_default(option, key, v) for v in val] + elif option.action == "callback": + assert option.callback is not None + late_eval.add(option.dest) + opt_str = option.get_opt_string() + val = option.convert_value(opt_str, val) + # From take_action + args = option.callback_args or () + kwargs = option.callback_kwargs or {} + option.callback(option, opt_str, val, self, *args, **kwargs) + else: + val = self.check_default(option, key, val) + + defaults[option.dest] = val + + for key in late_eval: + defaults[key] = getattr(self.values, key) + self.values = None + return defaults + + def get_default_values(self) -> optparse.Values: + """Overriding to make updating the defaults after instantiation of + the option parser possible, _update_defaults() does the dirty work.""" + if not self.process_default_values: + # Old, pre-Optik 1.5 behaviour. + return optparse.Values(self.defaults) + + # Load the configuration, or error out in case of an error + try: + self.config.load() + except ConfigurationError as err: + self.exit(UNKNOWN_ERROR, str(err)) + + defaults = self._update_defaults(self.defaults.copy()) # ours + for option in self._get_all_options(): + assert option.dest is not None + default = defaults.get(option.dest) + if isinstance(default, str): + opt_str = option.get_opt_string() + defaults[option.dest] = option.check_value(opt_str, default) + return optparse.Values(defaults) + + def error(self, msg: str) -> NoReturn: + self.print_usage(sys.stderr) + self.exit(UNKNOWN_ERROR, f"{msg}\n") diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/progress_bars.py b/env/lib/python3.12/site-packages/pip/_internal/cli/progress_bars.py new file mode 100644 index 0000000..3d9dde8 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/progress_bars.py @@ -0,0 +1,94 @@ +import functools +import sys +from typing import Callable, Generator, Iterable, Iterator, Optional, Tuple + +from pip._vendor.rich.progress import ( + BarColumn, + DownloadColumn, + FileSizeColumn, + Progress, + ProgressColumn, + SpinnerColumn, + TextColumn, + TimeElapsedColumn, + TimeRemainingColumn, + TransferSpeedColumn, +) + +from pip._internal.cli.spinners import RateLimiter +from pip._internal.utils.logging import get_indentation + +DownloadProgressRenderer = Callable[[Iterable[bytes]], Iterator[bytes]] + + +def _rich_progress_bar( + iterable: Iterable[bytes], + *, + bar_type: str, + size: Optional[int], +) -> Generator[bytes, None, None]: + assert bar_type == "on", "This should only be used in the default mode." + + if not size: + total = float("inf") + columns: Tuple[ProgressColumn, ...] = ( + TextColumn("[progress.description]{task.description}"), + SpinnerColumn("line", speed=1.5), + FileSizeColumn(), + TransferSpeedColumn(), + TimeElapsedColumn(), + ) + else: + total = size + columns = ( + TextColumn("[progress.description]{task.description}"), + BarColumn(), + DownloadColumn(), + TransferSpeedColumn(), + TextColumn("eta"), + TimeRemainingColumn(), + ) + + progress = Progress(*columns, refresh_per_second=5) + task_id = progress.add_task(" " * (get_indentation() + 2), total=total) + with progress: + for chunk in iterable: + yield chunk + progress.update(task_id, advance=len(chunk)) + + +def _raw_progress_bar( + iterable: Iterable[bytes], + *, + size: Optional[int], +) -> Generator[bytes, None, None]: + def write_progress(current: int, total: int) -> None: + sys.stdout.write(f"Progress {current} of {total}\n") + sys.stdout.flush() + + current = 0 + total = size or 0 + rate_limiter = RateLimiter(0.25) + + write_progress(current, total) + for chunk in iterable: + current += len(chunk) + if rate_limiter.ready() or current == total: + write_progress(current, total) + rate_limiter.reset() + yield chunk + + +def get_download_progress_renderer( + *, bar_type: str, size: Optional[int] = None +) -> DownloadProgressRenderer: + """Get an object that can be used to render the download progress. + + Returns a callable, that takes an iterable to "wrap". + """ + if bar_type == "on": + return functools.partial(_rich_progress_bar, bar_type=bar_type, size=size) + elif bar_type == "raw": + return functools.partial(_raw_progress_bar, size=size) + else: + return iter # no-op, when passed an iterator diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/req_command.py b/env/lib/python3.12/site-packages/pip/_internal/cli/req_command.py new file mode 100644 index 0000000..92900f9 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/req_command.py @@ -0,0 +1,329 @@ +"""Contains the RequirementCommand base class. + +This class is in a separate module so the commands that do not always +need PackageFinder capability don't unnecessarily import the +PackageFinder machinery and all its vendored dependencies, etc. +""" + +import logging +from functools import partial +from optparse import Values +from typing import Any, List, Optional, Tuple + +from pip._internal.cache import WheelCache +from pip._internal.cli import cmdoptions +from pip._internal.cli.index_command import IndexGroupCommand +from pip._internal.cli.index_command import SessionCommandMixin as SessionCommandMixin +from pip._internal.exceptions import CommandError, PreviousBuildDirError +from pip._internal.index.collector import LinkCollector +from pip._internal.index.package_finder import PackageFinder +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.models.target_python import TargetPython +from pip._internal.network.session import PipSession +from pip._internal.operations.build.build_tracker import BuildTracker +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.constructors import ( + install_req_from_editable, + install_req_from_line, + install_req_from_parsed_requirement, + install_req_from_req_string, +) +from pip._internal.req.req_file import parse_requirements +from pip._internal.req.req_install import InstallRequirement +from pip._internal.resolution.base import BaseResolver +from pip._internal.utils.temp_dir import ( + TempDirectory, + TempDirectoryTypeRegistry, + tempdir_kinds, +) + +logger = logging.getLogger(__name__) + + +KEEPABLE_TEMPDIR_TYPES = [ + tempdir_kinds.BUILD_ENV, + tempdir_kinds.EPHEM_WHEEL_CACHE, + tempdir_kinds.REQ_BUILD, +] + + +def with_cleanup(func: Any) -> Any: + """Decorator for common logic related to managing temporary + directories. + """ + + def configure_tempdir_registry(registry: TempDirectoryTypeRegistry) -> None: + for t in KEEPABLE_TEMPDIR_TYPES: + registry.set_delete(t, False) + + def wrapper( + self: RequirementCommand, options: Values, args: List[Any] + ) -> Optional[int]: + assert self.tempdir_registry is not None + if options.no_clean: + configure_tempdir_registry(self.tempdir_registry) + + try: + return func(self, options, args) + except PreviousBuildDirError: + # This kind of conflict can occur when the user passes an explicit + # build directory with a pre-existing folder. In that case we do + # not want to accidentally remove it. + configure_tempdir_registry(self.tempdir_registry) + raise + + return wrapper + + +class RequirementCommand(IndexGroupCommand): + def __init__(self, *args: Any, **kw: Any) -> None: + super().__init__(*args, **kw) + + self.cmd_opts.add_option(cmdoptions.no_clean()) + + @staticmethod + def determine_resolver_variant(options: Values) -> str: + """Determines which resolver should be used, based on the given options.""" + if "legacy-resolver" in options.deprecated_features_enabled: + return "legacy" + + return "resolvelib" + + @classmethod + def make_requirement_preparer( + cls, + temp_build_dir: TempDirectory, + options: Values, + build_tracker: BuildTracker, + session: PipSession, + finder: PackageFinder, + use_user_site: bool, + download_dir: Optional[str] = None, + verbosity: int = 0, + ) -> RequirementPreparer: + """ + Create a RequirementPreparer instance for the given parameters. + """ + temp_build_dir_path = temp_build_dir.path + assert temp_build_dir_path is not None + legacy_resolver = False + + resolver_variant = cls.determine_resolver_variant(options) + if resolver_variant == "resolvelib": + lazy_wheel = "fast-deps" in options.features_enabled + if lazy_wheel: + logger.warning( + "pip is using lazily downloaded wheels using HTTP " + "range requests to obtain dependency information. " + "This experimental feature is enabled through " + "--use-feature=fast-deps and it is not ready for " + "production." + ) + else: + legacy_resolver = True + lazy_wheel = False + if "fast-deps" in options.features_enabled: + logger.warning( + "fast-deps has no effect when used with the legacy resolver." + ) + + return RequirementPreparer( + build_dir=temp_build_dir_path, + src_dir=options.src_dir, + download_dir=download_dir, + build_isolation=options.build_isolation, + check_build_deps=options.check_build_deps, + build_tracker=build_tracker, + session=session, + progress_bar=options.progress_bar, + finder=finder, + require_hashes=options.require_hashes, + use_user_site=use_user_site, + lazy_wheel=lazy_wheel, + verbosity=verbosity, + legacy_resolver=legacy_resolver, + ) + + @classmethod + def make_resolver( + cls, + preparer: RequirementPreparer, + finder: PackageFinder, + options: Values, + wheel_cache: Optional[WheelCache] = None, + use_user_site: bool = False, + ignore_installed: bool = True, + ignore_requires_python: bool = False, + force_reinstall: bool = False, + upgrade_strategy: str = "to-satisfy-only", + use_pep517: Optional[bool] = None, + py_version_info: Optional[Tuple[int, ...]] = None, + ) -> BaseResolver: + """ + Create a Resolver instance for the given parameters. + """ + make_install_req = partial( + install_req_from_req_string, + isolated=options.isolated_mode, + use_pep517=use_pep517, + ) + resolver_variant = cls.determine_resolver_variant(options) + # The long import name and duplicated invocation is needed to convince + # Mypy into correctly typechecking. Otherwise it would complain the + # "Resolver" class being redefined. + if resolver_variant == "resolvelib": + import pip._internal.resolution.resolvelib.resolver + + return pip._internal.resolution.resolvelib.resolver.Resolver( + preparer=preparer, + finder=finder, + wheel_cache=wheel_cache, + make_install_req=make_install_req, + use_user_site=use_user_site, + ignore_dependencies=options.ignore_dependencies, + ignore_installed=ignore_installed, + ignore_requires_python=ignore_requires_python, + force_reinstall=force_reinstall, + upgrade_strategy=upgrade_strategy, + py_version_info=py_version_info, + ) + import pip._internal.resolution.legacy.resolver + + return pip._internal.resolution.legacy.resolver.Resolver( + preparer=preparer, + finder=finder, + wheel_cache=wheel_cache, + make_install_req=make_install_req, + use_user_site=use_user_site, + ignore_dependencies=options.ignore_dependencies, + ignore_installed=ignore_installed, + ignore_requires_python=ignore_requires_python, + force_reinstall=force_reinstall, + upgrade_strategy=upgrade_strategy, + py_version_info=py_version_info, + ) + + def get_requirements( + self, + args: List[str], + options: Values, + finder: PackageFinder, + session: PipSession, + ) -> List[InstallRequirement]: + """ + Parse command-line arguments into the corresponding requirements. + """ + requirements: List[InstallRequirement] = [] + for filename in options.constraints: + for parsed_req in parse_requirements( + filename, + constraint=True, + finder=finder, + options=options, + session=session, + ): + req_to_add = install_req_from_parsed_requirement( + parsed_req, + isolated=options.isolated_mode, + user_supplied=False, + ) + requirements.append(req_to_add) + + for req in args: + req_to_add = install_req_from_line( + req, + comes_from=None, + isolated=options.isolated_mode, + use_pep517=options.use_pep517, + user_supplied=True, + config_settings=getattr(options, "config_settings", None), + ) + requirements.append(req_to_add) + + for req in options.editables: + req_to_add = install_req_from_editable( + req, + user_supplied=True, + isolated=options.isolated_mode, + use_pep517=options.use_pep517, + config_settings=getattr(options, "config_settings", None), + ) + requirements.append(req_to_add) + + # NOTE: options.require_hashes may be set if --require-hashes is True + for filename in options.requirements: + for parsed_req in parse_requirements( + filename, finder=finder, options=options, session=session + ): + req_to_add = install_req_from_parsed_requirement( + parsed_req, + isolated=options.isolated_mode, + use_pep517=options.use_pep517, + user_supplied=True, + config_settings=( + parsed_req.options.get("config_settings") + if parsed_req.options + else None + ), + ) + requirements.append(req_to_add) + + # If any requirement has hash options, enable hash checking. + if any(req.has_hash_options for req in requirements): + options.require_hashes = True + + if not (args or options.editables or options.requirements): + opts = {"name": self.name} + if options.find_links: + raise CommandError( + "You must give at least one requirement to {name} " + '(maybe you meant "pip {name} {links}"?)'.format( + **dict(opts, links=" ".join(options.find_links)) + ) + ) + else: + raise CommandError( + "You must give at least one requirement to {name} " + '(see "pip help {name}")'.format(**opts) + ) + + return requirements + + @staticmethod + def trace_basic_info(finder: PackageFinder) -> None: + """ + Trace basic information about the provided objects. + """ + # Display where finder is looking for packages + search_scope = finder.search_scope + locations = search_scope.get_formatted_locations() + if locations: + logger.info(locations) + + def _build_package_finder( + self, + options: Values, + session: PipSession, + target_python: Optional[TargetPython] = None, + ignore_requires_python: Optional[bool] = None, + ) -> PackageFinder: + """ + Create a package finder appropriate to this requirement command. + + :param ignore_requires_python: Whether to ignore incompatible + "Requires-Python" values in links. Defaults to False. + """ + link_collector = LinkCollector.create(session, options=options) + selection_prefs = SelectionPreferences( + allow_yanked=True, + format_control=options.format_control, + allow_all_prereleases=options.pre, + prefer_binary=options.prefer_binary, + ignore_requires_python=ignore_requires_python, + ) + + return PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + target_python=target_python, + ) diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/spinners.py b/env/lib/python3.12/site-packages/pip/_internal/cli/spinners.py new file mode 100644 index 0000000..cf2b976 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/spinners.py @@ -0,0 +1,159 @@ +import contextlib +import itertools +import logging +import sys +import time +from typing import IO, Generator, Optional + +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.logging import get_indentation + +logger = logging.getLogger(__name__) + + +class SpinnerInterface: + def spin(self) -> None: + raise NotImplementedError() + + def finish(self, final_status: str) -> None: + raise NotImplementedError() + + +class InteractiveSpinner(SpinnerInterface): + def __init__( + self, + message: str, + file: Optional[IO[str]] = None, + spin_chars: str = "-\\|/", + # Empirically, 8 updates/second looks nice + min_update_interval_seconds: float = 0.125, + ): + self._message = message + if file is None: + file = sys.stdout + self._file = file + self._rate_limiter = RateLimiter(min_update_interval_seconds) + self._finished = False + + self._spin_cycle = itertools.cycle(spin_chars) + + self._file.write(" " * get_indentation() + self._message + " ... ") + self._width = 0 + + def _write(self, status: str) -> None: + assert not self._finished + # Erase what we wrote before by backspacing to the beginning, writing + # spaces to overwrite the old text, and then backspacing again + backup = "\b" * self._width + self._file.write(backup + " " * self._width + backup) + # Now we have a blank slate to add our status + self._file.write(status) + self._width = len(status) + self._file.flush() + self._rate_limiter.reset() + + def spin(self) -> None: + if self._finished: + return + if not self._rate_limiter.ready(): + return + self._write(next(self._spin_cycle)) + + def finish(self, final_status: str) -> None: + if self._finished: + return + self._write(final_status) + self._file.write("\n") + self._file.flush() + self._finished = True + + +# Used for dumb terminals, non-interactive installs (no tty), etc. +# We still print updates occasionally (once every 60 seconds by default) to +# act as a keep-alive for systems like Travis-CI that take lack-of-output as +# an indication that a task has frozen. +class NonInteractiveSpinner(SpinnerInterface): + def __init__(self, message: str, min_update_interval_seconds: float = 60.0) -> None: + self._message = message + self._finished = False + self._rate_limiter = RateLimiter(min_update_interval_seconds) + self._update("started") + + def _update(self, status: str) -> None: + assert not self._finished + self._rate_limiter.reset() + logger.info("%s: %s", self._message, status) + + def spin(self) -> None: + if self._finished: + return + if not self._rate_limiter.ready(): + return + self._update("still running...") + + def finish(self, final_status: str) -> None: + if self._finished: + return + self._update(f"finished with status '{final_status}'") + self._finished = True + + +class RateLimiter: + def __init__(self, min_update_interval_seconds: float) -> None: + self._min_update_interval_seconds = min_update_interval_seconds + self._last_update: float = 0 + + def ready(self) -> bool: + now = time.time() + delta = now - self._last_update + return delta >= self._min_update_interval_seconds + + def reset(self) -> None: + self._last_update = time.time() + + +@contextlib.contextmanager +def open_spinner(message: str) -> Generator[SpinnerInterface, None, None]: + # Interactive spinner goes directly to sys.stdout rather than being routed + # through the logging system, but it acts like it has level INFO, + # i.e. it's only displayed if we're at level INFO or better. + # Non-interactive spinner goes through the logging system, so it is always + # in sync with logging configuration. + if sys.stdout.isatty() and logger.getEffectiveLevel() <= logging.INFO: + spinner: SpinnerInterface = InteractiveSpinner(message) + else: + spinner = NonInteractiveSpinner(message) + try: + with hidden_cursor(sys.stdout): + yield spinner + except KeyboardInterrupt: + spinner.finish("canceled") + raise + except Exception: + spinner.finish("error") + raise + else: + spinner.finish("done") + + +HIDE_CURSOR = "\x1b[?25l" +SHOW_CURSOR = "\x1b[?25h" + + +@contextlib.contextmanager +def hidden_cursor(file: IO[str]) -> Generator[None, None, None]: + # The Windows terminal does not support the hide/show cursor ANSI codes, + # even via colorama. So don't even try. + if WINDOWS: + yield + # We don't want to clutter the output with control characters if we're + # writing to a file, or if the user is running with --quiet. + # See https://github.com/pypa/pip/issues/3418 + elif not file.isatty() or logger.getEffectiveLevel() > logging.INFO: + yield + else: + file.write(HIDE_CURSOR) + try: + yield + finally: + file.write(SHOW_CURSOR) diff --git a/env/lib/python3.12/site-packages/pip/_internal/cli/status_codes.py b/env/lib/python3.12/site-packages/pip/_internal/cli/status_codes.py new file mode 100644 index 0000000..5e29502 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/cli/status_codes.py @@ -0,0 +1,6 @@ +SUCCESS = 0 +ERROR = 1 +UNKNOWN_ERROR = 2 +VIRTUALENV_NOT_FOUND = 3 +PREVIOUS_BUILD_DIR_ERROR = 4 +NO_MATCHES_FOUND = 23 diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/commands/__init__.py new file mode 100644 index 0000000..858a410 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/__init__.py @@ -0,0 +1,132 @@ +""" +Package containing all pip commands +""" + +import importlib +from collections import namedtuple +from typing import Any, Dict, Optional + +from pip._internal.cli.base_command import Command + +CommandInfo = namedtuple("CommandInfo", "module_path, class_name, summary") + +# This dictionary does a bunch of heavy lifting for help output: +# - Enables avoiding additional (costly) imports for presenting `--help`. +# - The ordering matters for help display. +# +# Even though the module path starts with the same "pip._internal.commands" +# prefix, the full path makes testing easier (specifically when modifying +# `commands_dict` in test setup / teardown). +commands_dict: Dict[str, CommandInfo] = { + "install": CommandInfo( + "pip._internal.commands.install", + "InstallCommand", + "Install packages.", + ), + "download": CommandInfo( + "pip._internal.commands.download", + "DownloadCommand", + "Download packages.", + ), + "uninstall": CommandInfo( + "pip._internal.commands.uninstall", + "UninstallCommand", + "Uninstall packages.", + ), + "freeze": CommandInfo( + "pip._internal.commands.freeze", + "FreezeCommand", + "Output installed packages in requirements format.", + ), + "inspect": CommandInfo( + "pip._internal.commands.inspect", + "InspectCommand", + "Inspect the python environment.", + ), + "list": CommandInfo( + "pip._internal.commands.list", + "ListCommand", + "List installed packages.", + ), + "show": CommandInfo( + "pip._internal.commands.show", + "ShowCommand", + "Show information about installed packages.", + ), + "check": CommandInfo( + "pip._internal.commands.check", + "CheckCommand", + "Verify installed packages have compatible dependencies.", + ), + "config": CommandInfo( + "pip._internal.commands.configuration", + "ConfigurationCommand", + "Manage local and global configuration.", + ), + "search": CommandInfo( + "pip._internal.commands.search", + "SearchCommand", + "Search PyPI for packages.", + ), + "cache": CommandInfo( + "pip._internal.commands.cache", + "CacheCommand", + "Inspect and manage pip's wheel cache.", + ), + "index": CommandInfo( + "pip._internal.commands.index", + "IndexCommand", + "Inspect information available from package indexes.", + ), + "wheel": CommandInfo( + "pip._internal.commands.wheel", + "WheelCommand", + "Build wheels from your requirements.", + ), + "hash": CommandInfo( + "pip._internal.commands.hash", + "HashCommand", + "Compute hashes of package archives.", + ), + "completion": CommandInfo( + "pip._internal.commands.completion", + "CompletionCommand", + "A helper command used for command completion.", + ), + "debug": CommandInfo( + "pip._internal.commands.debug", + "DebugCommand", + "Show information useful for debugging.", + ), + "help": CommandInfo( + "pip._internal.commands.help", + "HelpCommand", + "Show help for commands.", + ), +} + + +def create_command(name: str, **kwargs: Any) -> Command: + """ + Create an instance of the Command class with the given name. + """ + module_path, class_name, summary = commands_dict[name] + module = importlib.import_module(module_path) + command_class = getattr(module, class_name) + command = command_class(name=name, summary=summary, **kwargs) + + return command + + +def get_similar_commands(name: str) -> Optional[str]: + """Command name auto-correct.""" + from difflib import get_close_matches + + name = name.lower() + + close_commands = get_close_matches(name, commands_dict.keys()) + + if close_commands: + return close_commands[0] + else: + return None diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/cache.py b/env/lib/python3.12/site-packages/pip/_internal/commands/cache.py new file mode 100644 index 0000000..ad65641 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/cache.py @@ -0,0 +1,228 @@ +import os +import textwrap +from optparse import Values +from typing import Any, List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.exceptions import CommandError, PipError +from pip._internal.utils import filesystem +from pip._internal.utils.logging import getLogger +from pip._internal.utils.misc import format_size + +logger = getLogger(__name__) + + +class CacheCommand(Command): + """ + Inspect and manage pip's wheel cache. + + Subcommands: + + - dir: Show the cache directory. + - info: Show information about the cache. + - list: List filenames of packages stored in the cache. + - remove: Remove one or more package from the cache. + - purge: Remove all items from the cache. + + ```` can be a glob expression or a package name. + """ + + ignore_require_venv = True + usage = """ + %prog dir + %prog info + %prog list [] [--format=[human, abspath]] + %prog remove + %prog purge + """ + + def add_options(self) -> None: + self.cmd_opts.add_option( + "--format", + action="store", + dest="list_format", + default="human", + choices=("human", "abspath"), + help="Select the output format among: human (default) or abspath", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + handlers = { + "dir": self.get_cache_dir, + "info": self.get_cache_info, + "list": self.list_cache_items, + "remove": self.remove_cache_items, + "purge": self.purge_cache, + } + + if not options.cache_dir: + logger.error("pip cache commands can not function since cache is disabled.") + return ERROR + + # Determine action + if not args or args[0] not in handlers: + logger.error( + "Need an action (%s) to perform.", + ", ".join(sorted(handlers)), + ) + return ERROR + + action = args[0] + + # Error handling happens here, not in the action-handlers. + try: + handlers[action](options, args[1:]) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + return SUCCESS + + def get_cache_dir(self, options: Values, args: List[Any]) -> None: + if args: + raise CommandError("Too many arguments") + + logger.info(options.cache_dir) + + def get_cache_info(self, options: Values, args: List[Any]) -> None: + if args: + raise CommandError("Too many arguments") + + num_http_files = len(self._find_http_files(options)) + num_packages = len(self._find_wheels(options, "*")) + + http_cache_location = self._cache_dir(options, "http-v2") + old_http_cache_location = self._cache_dir(options, "http") + wheels_cache_location = self._cache_dir(options, "wheels") + http_cache_size = filesystem.format_size( + filesystem.directory_size(http_cache_location) + + filesystem.directory_size(old_http_cache_location) + ) + wheels_cache_size = filesystem.format_directory_size(wheels_cache_location) + + message = ( + textwrap.dedent( + """ + Package index page cache location (pip v23.3+): {http_cache_location} + Package index page cache location (older pips): {old_http_cache_location} + Package index page cache size: {http_cache_size} + Number of HTTP files: {num_http_files} + Locally built wheels location: {wheels_cache_location} + Locally built wheels size: {wheels_cache_size} + Number of locally built wheels: {package_count} + """ # noqa: E501 + ) + .format( + http_cache_location=http_cache_location, + old_http_cache_location=old_http_cache_location, + http_cache_size=http_cache_size, + num_http_files=num_http_files, + wheels_cache_location=wheels_cache_location, + package_count=num_packages, + wheels_cache_size=wheels_cache_size, + ) + .strip() + ) + + logger.info(message) + + def list_cache_items(self, options: Values, args: List[Any]) -> None: + if len(args) > 1: + raise CommandError("Too many arguments") + + if args: + pattern = args[0] + else: + pattern = "*" + + files = self._find_wheels(options, pattern) + if options.list_format == "human": + self.format_for_human(files) + else: + self.format_for_abspath(files) + + def format_for_human(self, files: List[str]) -> None: + if not files: + logger.info("No locally built wheels cached.") + return + + results = [] + for filename in files: + wheel = os.path.basename(filename) + size = filesystem.format_file_size(filename) + results.append(f" - {wheel} ({size})") + logger.info("Cache contents:\n") + logger.info("\n".join(sorted(results))) + + def format_for_abspath(self, files: List[str]) -> None: + if files: + logger.info("\n".join(sorted(files))) + + def remove_cache_items(self, options: Values, args: List[Any]) -> None: + if len(args) > 1: + raise CommandError("Too many arguments") + + if not args: + raise CommandError("Please provide a pattern") + + files = self._find_wheels(options, args[0]) + + no_matching_msg = "No matching packages" + if args[0] == "*": + # Only fetch http files if no specific pattern given + files += self._find_http_files(options) + else: + # Add the pattern to the log message + no_matching_msg += f' for pattern "{args[0]}"' + + if not files: + logger.warning(no_matching_msg) + + bytes_removed = 0 + for filename in files: + bytes_removed += os.stat(filename).st_size + os.unlink(filename) + logger.verbose("Removed %s", filename) + logger.info("Files removed: %s (%s)", len(files), format_size(bytes_removed)) + + def purge_cache(self, options: Values, args: List[Any]) -> None: + if args: + raise CommandError("Too many arguments") + + return self.remove_cache_items(options, ["*"]) + + def _cache_dir(self, options: Values, subdir: str) -> str: + return os.path.join(options.cache_dir, subdir) + + def _find_http_files(self, options: Values) -> List[str]: + old_http_dir = self._cache_dir(options, "http") + new_http_dir = self._cache_dir(options, "http-v2") + return filesystem.find_files(old_http_dir, "*") + filesystem.find_files( + new_http_dir, "*" + ) + + def _find_wheels(self, options: Values, pattern: str) -> List[str]: + wheel_dir = self._cache_dir(options, "wheels") + + # The wheel filename format, as specified in PEP 427, is: + # {distribution}-{version}(-{build})?-{python}-{abi}-{platform}.whl + # + # Additionally, non-alphanumeric values in the distribution are + # normalized to underscores (_), meaning hyphens can never occur + # before `-{version}`. + # + # Given that information: + # - If the pattern we're given contains a hyphen (-), the user is + # providing at least the version. Thus, we can just append `*.whl` + # to match the rest of it. + # - If the pattern we're given doesn't contain a hyphen (-), the + # user is only providing the name. Thus, we append `-*.whl` to + # match the hyphen before the version, followed by anything else. + # + # PEP 427: https://www.python.org/dev/peps/pep-0427/ + pattern = pattern + ("*.whl" if "-" in pattern else "-*.whl") + + return filesystem.find_files(wheel_dir, pattern) diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/check.py b/env/lib/python3.12/site-packages/pip/_internal/commands/check.py new file mode 100644 index 0000000..f54a16d --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/check.py @@ -0,0 +1,67 @@ +import logging +from optparse import Values +from typing import List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.metadata import get_default_environment +from pip._internal.operations.check import ( + check_package_set, + check_unsupported, + create_package_set_from_installed, +) +from pip._internal.utils.compatibility_tags import get_supported +from pip._internal.utils.misc import write_output + +logger = logging.getLogger(__name__) + + +class CheckCommand(Command): + """Verify installed packages have compatible dependencies.""" + + ignore_require_venv = True + usage = """ + %prog [options]""" + + def run(self, options: Values, args: List[str]) -> int: + package_set, parsing_probs = create_package_set_from_installed() + missing, conflicting = check_package_set(package_set) + unsupported = list( + check_unsupported( + get_default_environment().iter_installed_distributions(), + get_supported(), + ) + ) + + for project_name in missing: + version = package_set[project_name].version + for dependency in missing[project_name]: + write_output( + "%s %s requires %s, which is not installed.", + project_name, + version, + dependency[0], + ) + + for project_name in conflicting: + version = package_set[project_name].version + for dep_name, dep_version, req in conflicting[project_name]: + write_output( + "%s %s has requirement %s, but you have %s %s.", + project_name, + version, + req, + dep_name, + dep_version, + ) + for package in unsupported: + write_output( + "%s %s is not supported on this platform", + package.raw_name, + package.version, + ) + if missing or conflicting or parsing_probs or unsupported: + return ERROR + else: + write_output("No broken requirements found.") + return SUCCESS diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/completion.py b/env/lib/python3.12/site-packages/pip/_internal/commands/completion.py new file mode 100644 index 0000000..9e89e27 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/completion.py @@ -0,0 +1,130 @@ +import sys +import textwrap +from optparse import Values +from typing import List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.utils.misc import get_prog + +BASE_COMPLETION = """ +# pip {shell} completion start{script}# pip {shell} completion end +""" + +COMPLETION_SCRIPTS = { + "bash": """ + _pip_completion() + {{ + COMPREPLY=( $( COMP_WORDS="${{COMP_WORDS[*]}}" \\ + COMP_CWORD=$COMP_CWORD \\ + PIP_AUTO_COMPLETE=1 $1 2>/dev/null ) ) + }} + complete -o default -F _pip_completion {prog} + """, + "zsh": """ + #compdef -P pip[0-9.]# + __pip() {{ + compadd $( COMP_WORDS="$words[*]" \\ + COMP_CWORD=$((CURRENT-1)) \\ + PIP_AUTO_COMPLETE=1 $words[1] 2>/dev/null ) + }} + if [[ $zsh_eval_context[-1] == loadautofunc ]]; then + # autoload from fpath, call function directly + __pip "$@" + else + # eval/source/. command, register function for later + compdef __pip -P 'pip[0-9.]#' + fi + """, + "fish": """ + function __fish_complete_pip + set -lx COMP_WORDS (commandline -o) "" + set -lx COMP_CWORD ( \\ + math (contains -i -- (commandline -t) $COMP_WORDS)-1 \\ + ) + set -lx PIP_AUTO_COMPLETE 1 + string split \\ -- (eval $COMP_WORDS[1]) + end + complete -fa "(__fish_complete_pip)" -c {prog} + """, + "powershell": """ + if ((Test-Path Function:\\TabExpansion) -and -not ` + (Test-Path Function:\\_pip_completeBackup)) {{ + Rename-Item Function:\\TabExpansion _pip_completeBackup + }} + function TabExpansion($line, $lastWord) {{ + $lastBlock = [regex]::Split($line, '[|;]')[-1].TrimStart() + if ($lastBlock.StartsWith("{prog} ")) {{ + $Env:COMP_WORDS=$lastBlock + $Env:COMP_CWORD=$lastBlock.Split().Length - 1 + $Env:PIP_AUTO_COMPLETE=1 + (& {prog}).Split() + Remove-Item Env:COMP_WORDS + Remove-Item Env:COMP_CWORD + Remove-Item Env:PIP_AUTO_COMPLETE + }} + elseif (Test-Path Function:\\_pip_completeBackup) {{ + # Fall back on existing tab expansion + _pip_completeBackup $line $lastWord + }} + }} + """, +} + + +class CompletionCommand(Command): + """A helper command to be used for command completion.""" + + ignore_require_venv = True + + def add_options(self) -> None: + self.cmd_opts.add_option( + "--bash", + "-b", + action="store_const", + const="bash", + dest="shell", + help="Emit completion code for bash", + ) + self.cmd_opts.add_option( + "--zsh", + "-z", + action="store_const", + const="zsh", + dest="shell", + help="Emit completion code for zsh", + ) + self.cmd_opts.add_option( + "--fish", + "-f", + action="store_const", + const="fish", + dest="shell", + help="Emit completion code for fish", + ) + self.cmd_opts.add_option( + "--powershell", + "-p", + action="store_const", + const="powershell", + dest="shell", + help="Emit completion code for powershell", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + """Prints the completion code of the given shell""" + shells = COMPLETION_SCRIPTS.keys() + shell_options = ["--" + shell for shell in sorted(shells)] + if options.shell in shells: + script = textwrap.dedent( + COMPLETION_SCRIPTS.get(options.shell, "").format(prog=get_prog()) + ) + print(BASE_COMPLETION.format(script=script, shell=options.shell)) + return SUCCESS + else: + sys.stderr.write( + "ERROR: You must pass {}\n".format(" or ".join(shell_options)) + ) + return SUCCESS diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/configuration.py b/env/lib/python3.12/site-packages/pip/_internal/commands/configuration.py new file mode 100644 index 0000000..1a1dc6b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/configuration.py @@ -0,0 +1,280 @@ +import logging +import os +import subprocess +from optparse import Values +from typing import Any, List, Optional + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.configuration import ( + Configuration, + Kind, + get_configuration_files, + kinds, +) +from pip._internal.exceptions import PipError +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import get_prog, write_output + +logger = logging.getLogger(__name__) + + +class ConfigurationCommand(Command): + """ + Manage local and global configuration. + + Subcommands: + + - list: List the active configuration (or from the file specified) + - edit: Edit the configuration file in an editor + - get: Get the value associated with command.option + - set: Set the command.option=value + - unset: Unset the value associated with command.option + - debug: List the configuration files and values defined under them + + Configuration keys should be dot separated command and option name, + with the special prefix "global" affecting any command. For example, + "pip config set global.index-url https://example.org/" would configure + the index url for all commands, but "pip config set download.timeout 10" + would configure a 10 second timeout only for "pip download" commands. + + If none of --user, --global and --site are passed, a virtual + environment configuration file is used if one is active and the file + exists. Otherwise, all modifications happen to the user file by + default. + """ + + ignore_require_venv = True + usage = """ + %prog [] list + %prog [] [--editor ] edit + + %prog [] get command.option + %prog [] set command.option value + %prog [] unset command.option + %prog [] debug + """ + + def add_options(self) -> None: + self.cmd_opts.add_option( + "--editor", + dest="editor", + action="store", + default=None, + help=( + "Editor to use to edit the file. Uses VISUAL or EDITOR " + "environment variables if not provided." + ), + ) + + self.cmd_opts.add_option( + "--global", + dest="global_file", + action="store_true", + default=False, + help="Use the system-wide configuration file only", + ) + + self.cmd_opts.add_option( + "--user", + dest="user_file", + action="store_true", + default=False, + help="Use the user configuration file only", + ) + + self.cmd_opts.add_option( + "--site", + dest="site_file", + action="store_true", + default=False, + help="Use the current environment configuration file only", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + handlers = { + "list": self.list_values, + "edit": self.open_in_editor, + "get": self.get_name, + "set": self.set_name_value, + "unset": self.unset_name, + "debug": self.list_config_values, + } + + # Determine action + if not args or args[0] not in handlers: + logger.error( + "Need an action (%s) to perform.", + ", ".join(sorted(handlers)), + ) + return ERROR + + action = args[0] + + # Determine which configuration files are to be loaded + # Depends on whether the command is modifying. + try: + load_only = self._determine_file( + options, need_value=(action in ["get", "set", "unset", "edit"]) + ) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + # Load a new configuration + self.configuration = Configuration( + isolated=options.isolated_mode, load_only=load_only + ) + self.configuration.load() + + # Error handling happens here, not in the action-handlers. + try: + handlers[action](options, args[1:]) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + return SUCCESS + + def _determine_file(self, options: Values, need_value: bool) -> Optional[Kind]: + file_options = [ + key + for key, value in ( + (kinds.USER, options.user_file), + (kinds.GLOBAL, options.global_file), + (kinds.SITE, options.site_file), + ) + if value + ] + + if not file_options: + if not need_value: + return None + # Default to user, unless there's a site file. + elif any( + os.path.exists(site_config_file) + for site_config_file in get_configuration_files()[kinds.SITE] + ): + return kinds.SITE + else: + return kinds.USER + elif len(file_options) == 1: + return file_options[0] + + raise PipError( + "Need exactly one file to operate upon " + "(--user, --site, --global) to perform." + ) + + def list_values(self, options: Values, args: List[str]) -> None: + self._get_n_args(args, "list", n=0) + + for key, value in sorted(self.configuration.items()): + write_output("%s=%r", key, value) + + def get_name(self, options: Values, args: List[str]) -> None: + key = self._get_n_args(args, "get [name]", n=1) + value = self.configuration.get_value(key) + + write_output("%s", value) + + def set_name_value(self, options: Values, args: List[str]) -> None: + key, value = self._get_n_args(args, "set [name] [value]", n=2) + self.configuration.set_value(key, value) + + self._save_configuration() + + def unset_name(self, options: Values, args: List[str]) -> None: + key = self._get_n_args(args, "unset [name]", n=1) + self.configuration.unset_value(key) + + self._save_configuration() + + def list_config_values(self, options: Values, args: List[str]) -> None: + """List config key-value pairs across different config files""" + self._get_n_args(args, "debug", n=0) + + self.print_env_var_values() + # Iterate over config files and print if they exist, and the + # key-value pairs present in them if they do + for variant, files in sorted(self.configuration.iter_config_files()): + write_output("%s:", variant) + for fname in files: + with indent_log(): + file_exists = os.path.exists(fname) + write_output("%s, exists: %r", fname, file_exists) + if file_exists: + self.print_config_file_values(variant) + + def print_config_file_values(self, variant: Kind) -> None: + """Get key-value pairs from the file of a variant""" + for name, value in self.configuration.get_values_in_config(variant).items(): + with indent_log(): + write_output("%s: %s", name, value) + + def print_env_var_values(self) -> None: + """Get key-values pairs present as environment variables""" + write_output("%s:", "env_var") + with indent_log(): + for key, value in sorted(self.configuration.get_environ_vars()): + env_var = f"PIP_{key.upper()}" + write_output("%s=%r", env_var, value) + + def open_in_editor(self, options: Values, args: List[str]) -> None: + editor = self._determine_editor(options) + + fname = self.configuration.get_file_to_edit() + if fname is None: + raise PipError("Could not determine appropriate file.") + elif '"' in fname: + # This shouldn't happen, unless we see a username like that. + # If that happens, we'd appreciate a pull request fixing this. + raise PipError( + f'Can not open an editor for a file name containing "\n{fname}' + ) + + try: + subprocess.check_call(f'{editor} "{fname}"', shell=True) + except FileNotFoundError as e: + if not e.filename: + e.filename = editor + raise + except subprocess.CalledProcessError as e: + raise PipError(f"Editor Subprocess exited with exit code {e.returncode}") + + def _get_n_args(self, args: List[str], example: str, n: int) -> Any: + """Helper to make sure the command got the right number of arguments""" + if len(args) != n: + msg = ( + f"Got unexpected number of arguments, expected {n}. " + f'(example: "{get_prog()} config {example}")' + ) + raise PipError(msg) + + if n == 1: + return args[0] + else: + return args + + def _save_configuration(self) -> None: + # We successfully ran a modifying command. Need to save the + # configuration. + try: + self.configuration.save() + except Exception: + logger.exception( + "Unable to save configuration. Please report this as a bug." + ) + raise PipError("Internal Error.") + + def _determine_editor(self, options: Values) -> str: + if options.editor is not None: + return options.editor + elif "VISUAL" in os.environ: + return os.environ["VISUAL"] + elif "EDITOR" in os.environ: + return os.environ["EDITOR"] + else: + raise PipError("Could not determine editor to use.") diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/debug.py b/env/lib/python3.12/site-packages/pip/_internal/commands/debug.py new file mode 100644 index 0000000..567ca96 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/debug.py @@ -0,0 +1,201 @@ +import locale +import logging +import os +import sys +from optparse import Values +from types import ModuleType +from typing import Any, Dict, List, Optional + +import pip._vendor +from pip._vendor.certifi import where +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.cmdoptions import make_target_python +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.configuration import Configuration +from pip._internal.metadata import get_environment +from pip._internal.utils.compat import open_text_resource +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import get_pip_version + +logger = logging.getLogger(__name__) + + +def show_value(name: str, value: Any) -> None: + logger.info("%s: %s", name, value) + + +def show_sys_implementation() -> None: + logger.info("sys.implementation:") + implementation_name = sys.implementation.name + with indent_log(): + show_value("name", implementation_name) + + +def create_vendor_txt_map() -> Dict[str, str]: + with open_text_resource("pip._vendor", "vendor.txt") as f: + # Purge non version specifying lines. + # Also, remove any space prefix or suffixes (including comments). + lines = [ + line.strip().split(" ", 1)[0] for line in f.readlines() if "==" in line + ] + + # Transform into "module" -> version dict. + return dict(line.split("==", 1) for line in lines) + + +def get_module_from_module_name(module_name: str) -> Optional[ModuleType]: + # Module name can be uppercase in vendor.txt for some reason... + module_name = module_name.lower().replace("-", "_") + # PATCH: setuptools is actually only pkg_resources. + if module_name == "setuptools": + module_name = "pkg_resources" + + try: + __import__(f"pip._vendor.{module_name}", globals(), locals(), level=0) + return getattr(pip._vendor, module_name) + except ImportError: + # We allow 'truststore' to fail to import due + # to being unavailable on Python 3.9 and earlier. + if module_name == "truststore" and sys.version_info < (3, 10): + return None + raise + + +def get_vendor_version_from_module(module_name: str) -> Optional[str]: + module = get_module_from_module_name(module_name) + version = getattr(module, "__version__", None) + + if module and not version: + # Try to find version in debundled module info. + assert module.__file__ is not None + env = get_environment([os.path.dirname(module.__file__)]) + dist = env.get_distribution(module_name) + if dist: + version = str(dist.version) + + return version + + +def show_actual_vendor_versions(vendor_txt_versions: Dict[str, str]) -> None: + """Log the actual version and print extra info if there is + a conflict or if the actual version could not be imported. + """ + for module_name, expected_version in vendor_txt_versions.items(): + extra_message = "" + actual_version = get_vendor_version_from_module(module_name) + if not actual_version: + extra_message = ( + " (Unable to locate actual module version, using" + " vendor.txt specified version)" + ) + actual_version = expected_version + elif parse_version(actual_version) != parse_version(expected_version): + extra_message = ( + " (CONFLICT: vendor.txt suggests version should" + f" be {expected_version})" + ) + logger.info("%s==%s%s", module_name, actual_version, extra_message) + + +def show_vendor_versions() -> None: + logger.info("vendored library versions:") + + vendor_txt_versions = create_vendor_txt_map() + with indent_log(): + show_actual_vendor_versions(vendor_txt_versions) + + +def show_tags(options: Values) -> None: + tag_limit = 10 + + target_python = make_target_python(options) + tags = target_python.get_sorted_tags() + + # Display the target options that were explicitly provided. + formatted_target = target_python.format_given() + suffix = "" + if formatted_target: + suffix = f" (target: {formatted_target})" + + msg = f"Compatible tags: {len(tags)}{suffix}" + logger.info(msg) + + if options.verbose < 1 and len(tags) > tag_limit: + tags_limited = True + tags = tags[:tag_limit] + else: + tags_limited = False + + with indent_log(): + for tag in tags: + logger.info(str(tag)) + + if tags_limited: + msg = f"...\n[First {tag_limit} tags shown. Pass --verbose to show all.]" + logger.info(msg) + + +def ca_bundle_info(config: Configuration) -> str: + levels = {key.split(".", 1)[0] for key, _ in config.items()} + if not levels: + return "Not specified" + + levels_that_override_global = ["install", "wheel", "download"] + global_overriding_level = [ + level for level in levels if level in levels_that_override_global + ] + if not global_overriding_level: + return "global" + + if "global" in levels: + levels.remove("global") + return ", ".join(levels) + + +class DebugCommand(Command): + """ + Display debug information. + """ + + usage = """ + %prog """ + ignore_require_venv = True + + def add_options(self) -> None: + cmdoptions.add_target_python_options(self.cmd_opts) + self.parser.insert_option_group(0, self.cmd_opts) + self.parser.config.load() + + def run(self, options: Values, args: List[str]) -> int: + logger.warning( + "This command is only meant for debugging. " + "Do not use this with automation for parsing and getting these " + "details, since the output and options of this command may " + "change without notice." + ) + show_value("pip version", get_pip_version()) + show_value("sys.version", sys.version) + show_value("sys.executable", sys.executable) + show_value("sys.getdefaultencoding", sys.getdefaultencoding()) + show_value("sys.getfilesystemencoding", sys.getfilesystemencoding()) + show_value( + "locale.getpreferredencoding", + locale.getpreferredencoding(), + ) + show_value("sys.platform", sys.platform) + show_sys_implementation() + + show_value("'cert' config value", ca_bundle_info(self.parser.config)) + show_value("REQUESTS_CA_BUNDLE", os.environ.get("REQUESTS_CA_BUNDLE")) + show_value("CURL_CA_BUNDLE", os.environ.get("CURL_CA_BUNDLE")) + show_value("pip._vendor.certifi.where()", where()) + show_value("pip._vendor.DEBUNDLED", pip._vendor.DEBUNDLED) + + show_vendor_versions() + + show_tags(options) + + return SUCCESS diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/download.py b/env/lib/python3.12/site-packages/pip/_internal/commands/download.py new file mode 100644 index 0000000..917bbb9 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/download.py @@ -0,0 +1,146 @@ +import logging +import os +from optparse import Values +from typing import List + +from pip._internal.cli import cmdoptions +from pip._internal.cli.cmdoptions import make_target_python +from pip._internal.cli.req_command import RequirementCommand, with_cleanup +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.operations.build.build_tracker import get_build_tracker +from pip._internal.req.req_install import check_legacy_setup_py_options +from pip._internal.utils.misc import ensure_dir, normalize_path, write_output +from pip._internal.utils.temp_dir import TempDirectory + +logger = logging.getLogger(__name__) + + +class DownloadCommand(RequirementCommand): + """ + Download packages from: + + - PyPI (and other indexes) using requirement specifiers. + - VCS project urls. + - Local project directories. + - Local or remote source archives. + + pip also supports downloading from "requirements files", which provide + an easy way to specify a whole environment to be downloaded. + """ + + usage = """ + %prog [options] [package-index-options] ... + %prog [options] -r [package-index-options] ... + %prog [options] ... + %prog [options] ... + %prog [options] ...""" + + def add_options(self) -> None: + self.cmd_opts.add_option(cmdoptions.constraints()) + self.cmd_opts.add_option(cmdoptions.requirements()) + self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.global_options()) + self.cmd_opts.add_option(cmdoptions.no_binary()) + self.cmd_opts.add_option(cmdoptions.only_binary()) + self.cmd_opts.add_option(cmdoptions.prefer_binary()) + self.cmd_opts.add_option(cmdoptions.src()) + self.cmd_opts.add_option(cmdoptions.pre()) + self.cmd_opts.add_option(cmdoptions.require_hashes()) + self.cmd_opts.add_option(cmdoptions.progress_bar()) + self.cmd_opts.add_option(cmdoptions.no_build_isolation()) + self.cmd_opts.add_option(cmdoptions.use_pep517()) + self.cmd_opts.add_option(cmdoptions.no_use_pep517()) + self.cmd_opts.add_option(cmdoptions.check_build_deps()) + self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) + + self.cmd_opts.add_option( + "-d", + "--dest", + "--destination-dir", + "--destination-directory", + dest="download_dir", + metavar="dir", + default=os.curdir, + help="Download packages into .", + ) + + cmdoptions.add_target_python_options(self.cmd_opts) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + @with_cleanup + def run(self, options: Values, args: List[str]) -> int: + options.ignore_installed = True + # editable doesn't really make sense for `pip download`, but the bowels + # of the RequirementSet code require that property. + options.editables = [] + + cmdoptions.check_dist_restriction(options) + + options.download_dir = normalize_path(options.download_dir) + ensure_dir(options.download_dir) + + session = self.get_default_session(options) + + target_python = make_target_python(options) + finder = self._build_package_finder( + options=options, + session=session, + target_python=target_python, + ignore_requires_python=options.ignore_requires_python, + ) + + build_tracker = self.enter_context(get_build_tracker()) + + directory = TempDirectory( + delete=not options.no_clean, + kind="download", + globally_managed=True, + ) + + reqs = self.get_requirements(args, options, finder, session) + check_legacy_setup_py_options(options, reqs) + + preparer = self.make_requirement_preparer( + temp_build_dir=directory, + options=options, + build_tracker=build_tracker, + session=session, + finder=finder, + download_dir=options.download_dir, + use_user_site=False, + verbosity=self.verbosity, + ) + + resolver = self.make_resolver( + preparer=preparer, + finder=finder, + options=options, + ignore_requires_python=options.ignore_requires_python, + use_pep517=options.use_pep517, + py_version_info=options.python_version, + ) + + self.trace_basic_info(finder) + + requirement_set = resolver.resolve(reqs, check_supported_wheels=True) + + downloaded: List[str] = [] + for req in requirement_set.requirements.values(): + if req.satisfied_by is None: + assert req.name is not None + preparer.save_linked_requirement(req) + downloaded.append(req.name) + + preparer.prepare_linked_requirements_more(requirement_set.requirements.values()) + + if downloaded: + write_output("Successfully downloaded %s", " ".join(downloaded)) + + return SUCCESS diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/freeze.py b/env/lib/python3.12/site-packages/pip/_internal/commands/freeze.py new file mode 100644 index 0000000..885fdfe --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/freeze.py @@ -0,0 +1,109 @@ +import sys +from optparse import Values +from typing import AbstractSet, List + +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.operations.freeze import freeze +from pip._internal.utils.compat import stdlib_pkgs + + +def _should_suppress_build_backends() -> bool: + return sys.version_info < (3, 12) + + +def _dev_pkgs() -> AbstractSet[str]: + pkgs = {"pip"} + + if _should_suppress_build_backends(): + pkgs |= {"setuptools", "distribute", "wheel"} + + return pkgs + + +class FreezeCommand(Command): + """ + Output installed packages in requirements format. + + packages are listed in a case-insensitive sorted order. + """ + + ignore_require_venv = True + usage = """ + %prog [options]""" + log_streams = ("ext://sys.stderr", "ext://sys.stderr") + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-r", + "--requirement", + dest="requirements", + action="append", + default=[], + metavar="file", + help=( + "Use the order in the given requirements file and its " + "comments when generating output. This option can be " + "used multiple times." + ), + ) + self.cmd_opts.add_option( + "-l", + "--local", + dest="local", + action="store_true", + default=False, + help=( + "If in a virtualenv that has global access, do not output " + "globally-installed packages." + ), + ) + self.cmd_opts.add_option( + "--user", + dest="user", + action="store_true", + default=False, + help="Only output packages installed in user-site.", + ) + self.cmd_opts.add_option(cmdoptions.list_path()) + self.cmd_opts.add_option( + "--all", + dest="freeze_all", + action="store_true", + help=( + "Do not skip these packages in the output:" + " {}".format(", ".join(_dev_pkgs())) + ), + ) + self.cmd_opts.add_option( + "--exclude-editable", + dest="exclude_editable", + action="store_true", + help="Exclude editable package from output.", + ) + self.cmd_opts.add_option(cmdoptions.list_exclude()) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + skip = set(stdlib_pkgs) + if not options.freeze_all: + skip.update(_dev_pkgs()) + + if options.excludes: + skip.update(options.excludes) + + cmdoptions.check_list_path_option(options) + + for line in freeze( + requirement=options.requirements, + local_only=options.local, + user_only=options.user, + paths=options.path, + isolated=options.isolated_mode, + skip=skip, + exclude_editable=options.exclude_editable, + ): + sys.stdout.write(line + "\n") + return SUCCESS diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/hash.py b/env/lib/python3.12/site-packages/pip/_internal/commands/hash.py new file mode 100644 index 0000000..042dac8 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/hash.py @@ -0,0 +1,59 @@ +import hashlib +import logging +import sys +from optparse import Values +from typing import List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.utils.hashes import FAVORITE_HASH, STRONG_HASHES +from pip._internal.utils.misc import read_chunks, write_output + +logger = logging.getLogger(__name__) + + +class HashCommand(Command): + """ + Compute a hash of a local package archive. + + These can be used with --hash in a requirements file to do repeatable + installs. + """ + + usage = "%prog [options] ..." + ignore_require_venv = True + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-a", + "--algorithm", + dest="algorithm", + choices=STRONG_HASHES, + action="store", + default=FAVORITE_HASH, + help="The hash algorithm to use: one of {}".format( + ", ".join(STRONG_HASHES) + ), + ) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + if not args: + self.parser.print_usage(sys.stderr) + return ERROR + + algorithm = options.algorithm + for path in args: + write_output( + "%s:\n--hash=%s:%s", path, algorithm, _hash_of_file(path, algorithm) + ) + return SUCCESS + + +def _hash_of_file(path: str, algorithm: str) -> str: + """Return the hash digest of a file.""" + with open(path, "rb") as archive: + hash = hashlib.new(algorithm) + for chunk in read_chunks(archive): + hash.update(chunk) + return hash.hexdigest() diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/help.py b/env/lib/python3.12/site-packages/pip/_internal/commands/help.py new file mode 100644 index 0000000..6206631 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/help.py @@ -0,0 +1,41 @@ +from optparse import Values +from typing import List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import CommandError + + +class HelpCommand(Command): + """Show help for commands""" + + usage = """ + %prog """ + ignore_require_venv = True + + def run(self, options: Values, args: List[str]) -> int: + from pip._internal.commands import ( + commands_dict, + create_command, + get_similar_commands, + ) + + try: + # 'pip help' with no args is handled by pip.__init__.parseopt() + cmd_name = args[0] # the command we need help for + except IndexError: + return SUCCESS + + if cmd_name not in commands_dict: + guess = get_similar_commands(cmd_name) + + msg = [f'unknown command "{cmd_name}"'] + if guess: + msg.append(f'maybe you meant "{guess}"') + + raise CommandError(" - ".join(msg)) + + command = create_command(cmd_name) + command.parser.print_help() + + return SUCCESS diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/index.py b/env/lib/python3.12/site-packages/pip/_internal/commands/index.py new file mode 100644 index 0000000..2e2661b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/index.py @@ -0,0 +1,139 @@ +import logging +from optparse import Values +from typing import Any, Iterable, List, Optional + +from pip._vendor.packaging.version import Version + +from pip._internal.cli import cmdoptions +from pip._internal.cli.req_command import IndexGroupCommand +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.commands.search import print_dist_installation_info +from pip._internal.exceptions import CommandError, DistributionNotFound, PipError +from pip._internal.index.collector import LinkCollector +from pip._internal.index.package_finder import PackageFinder +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.models.target_python import TargetPython +from pip._internal.network.session import PipSession +from pip._internal.utils.misc import write_output + +logger = logging.getLogger(__name__) + + +class IndexCommand(IndexGroupCommand): + """ + Inspect information available from package indexes. + """ + + ignore_require_venv = True + usage = """ + %prog versions + """ + + def add_options(self) -> None: + cmdoptions.add_target_python_options(self.cmd_opts) + + self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) + self.cmd_opts.add_option(cmdoptions.pre()) + self.cmd_opts.add_option(cmdoptions.no_binary()) + self.cmd_opts.add_option(cmdoptions.only_binary()) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + handlers = { + "versions": self.get_available_package_versions, + } + + logger.warning( + "pip index is currently an experimental command. " + "It may be removed/changed in a future release " + "without prior warning." + ) + + # Determine action + if not args or args[0] not in handlers: + logger.error( + "Need an action (%s) to perform.", + ", ".join(sorted(handlers)), + ) + return ERROR + + action = args[0] + + # Error handling happens here, not in the action-handlers. + try: + handlers[action](options, args[1:]) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + return SUCCESS + + def _build_package_finder( + self, + options: Values, + session: PipSession, + target_python: Optional[TargetPython] = None, + ignore_requires_python: Optional[bool] = None, + ) -> PackageFinder: + """ + Create a package finder appropriate to the index command. + """ + link_collector = LinkCollector.create(session, options=options) + + # Pass allow_yanked=False to ignore yanked versions. + selection_prefs = SelectionPreferences( + allow_yanked=False, + allow_all_prereleases=options.pre, + ignore_requires_python=ignore_requires_python, + ) + + return PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + target_python=target_python, + ) + + def get_available_package_versions(self, options: Values, args: List[Any]) -> None: + if len(args) != 1: + raise CommandError("You need to specify exactly one argument") + + target_python = cmdoptions.make_target_python(options) + query = args[0] + + with self._build_session(options) as session: + finder = self._build_package_finder( + options=options, + session=session, + target_python=target_python, + ignore_requires_python=options.ignore_requires_python, + ) + + versions: Iterable[Version] = ( + candidate.version for candidate in finder.find_all_candidates(query) + ) + + if not options.pre: + # Remove prereleases + versions = ( + version for version in versions if not version.is_prerelease + ) + versions = set(versions) + + if not versions: + raise DistributionNotFound( + f"No matching distribution found for {query}" + ) + + formatted_versions = [str(ver) for ver in sorted(versions, reverse=True)] + latest = formatted_versions[0] + + write_output(f"{query} ({latest})") + write_output("Available versions: {}".format(", ".join(formatted_versions))) + print_dist_installation_info(query, latest) diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/inspect.py b/env/lib/python3.12/site-packages/pip/_internal/commands/inspect.py new file mode 100644 index 0000000..e810c13 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/inspect.py @@ -0,0 +1,92 @@ +import logging +from optparse import Values +from typing import Any, Dict, List + +from pip._vendor.packaging.markers import default_environment +from pip._vendor.rich import print_json + +from pip import __version__ +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.metadata import BaseDistribution, get_environment +from pip._internal.utils.compat import stdlib_pkgs +from pip._internal.utils.urls import path_to_url + +logger = logging.getLogger(__name__) + + +class InspectCommand(Command): + """ + Inspect the content of a Python environment and produce a report in JSON format. + """ + + ignore_require_venv = True + usage = """ + %prog [options]""" + + def add_options(self) -> None: + self.cmd_opts.add_option( + "--local", + action="store_true", + default=False, + help=( + "If in a virtualenv that has global access, do not list " + "globally-installed packages." + ), + ) + self.cmd_opts.add_option( + "--user", + dest="user", + action="store_true", + default=False, + help="Only output packages installed in user-site.", + ) + self.cmd_opts.add_option(cmdoptions.list_path()) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + cmdoptions.check_list_path_option(options) + dists = get_environment(options.path).iter_installed_distributions( + local_only=options.local, + user_only=options.user, + skip=set(stdlib_pkgs), + ) + output = { + "version": "1", + "pip_version": __version__, + "installed": [self._dist_to_dict(dist) for dist in dists], + "environment": default_environment(), + # TODO tags? scheme? + } + print_json(data=output) + return SUCCESS + + def _dist_to_dict(self, dist: BaseDistribution) -> Dict[str, Any]: + res: Dict[str, Any] = { + "metadata": dist.metadata_dict, + "metadata_location": dist.info_location, + } + # direct_url. Note that we don't have download_info (as in the installation + # report) since it is not recorded in installed metadata. + direct_url = dist.direct_url + if direct_url is not None: + res["direct_url"] = direct_url.to_dict() + else: + # Emulate direct_url for legacy editable installs. + editable_project_location = dist.editable_project_location + if editable_project_location is not None: + res["direct_url"] = { + "url": path_to_url(editable_project_location), + "dir_info": { + "editable": True, + }, + } + # installer + installer = dist.installer + if dist.installer: + res["installer"] = installer + # requested + if dist.installed_with_dist_info: + res["requested"] = dist.requested + return res diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/install.py b/env/lib/python3.12/site-packages/pip/_internal/commands/install.py new file mode 100644 index 0000000..232a34a --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/install.py @@ -0,0 +1,784 @@ +import errno +import json +import operator +import os +import shutil +import site +from optparse import SUPPRESS_HELP, Values +from typing import List, Optional + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.rich import print_json + +# Eagerly import self_outdated_check to avoid crashes. Otherwise, +# this module would be imported *after* pip was replaced, resulting +# in crashes if the new self_outdated_check module was incompatible +# with the rest of pip that's already imported, or allowing a +# wheel to execute arbitrary code on install by replacing +# self_outdated_check. +import pip._internal.self_outdated_check # noqa: F401 +from pip._internal.cache import WheelCache +from pip._internal.cli import cmdoptions +from pip._internal.cli.cmdoptions import make_target_python +from pip._internal.cli.req_command import ( + RequirementCommand, + with_cleanup, +) +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.exceptions import CommandError, InstallationError +from pip._internal.locations import get_scheme +from pip._internal.metadata import get_environment +from pip._internal.models.installation_report import InstallationReport +from pip._internal.operations.build.build_tracker import get_build_tracker +from pip._internal.operations.check import ConflictDetails, check_install_conflicts +from pip._internal.req import install_given_reqs +from pip._internal.req.req_install import ( + InstallRequirement, + check_legacy_setup_py_options, +) +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.filesystem import test_writable_dir +from pip._internal.utils.logging import getLogger +from pip._internal.utils.misc import ( + check_externally_managed, + ensure_dir, + get_pip_version, + protect_pip_from_modification_on_windows, + warn_if_run_as_root, + write_output, +) +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.virtualenv import ( + running_under_virtualenv, + virtualenv_no_global, +) +from pip._internal.wheel_builder import build, should_build_for_install_command + +logger = getLogger(__name__) + + +class InstallCommand(RequirementCommand): + """ + Install packages from: + + - PyPI (and other indexes) using requirement specifiers. + - VCS project urls. + - Local project directories. + - Local or remote source archives. + + pip also supports installing from "requirements files", which provide + an easy way to specify a whole environment to be installed. + """ + + usage = """ + %prog [options] [package-index-options] ... + %prog [options] -r [package-index-options] ... + %prog [options] [-e] ... + %prog [options] [-e] ... + %prog [options] ...""" + + def add_options(self) -> None: + self.cmd_opts.add_option(cmdoptions.requirements()) + self.cmd_opts.add_option(cmdoptions.constraints()) + self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.pre()) + + self.cmd_opts.add_option(cmdoptions.editable()) + self.cmd_opts.add_option( + "--dry-run", + action="store_true", + dest="dry_run", + default=False, + help=( + "Don't actually install anything, just print what would be. " + "Can be used in combination with --ignore-installed " + "to 'resolve' the requirements." + ), + ) + self.cmd_opts.add_option( + "-t", + "--target", + dest="target_dir", + metavar="dir", + default=None, + help=( + "Install packages into . " + "By default this will not replace existing files/folders in " + ". Use --upgrade to replace existing packages in " + "with new versions." + ), + ) + cmdoptions.add_target_python_options(self.cmd_opts) + + self.cmd_opts.add_option( + "--user", + dest="use_user_site", + action="store_true", + help=( + "Install to the Python user install directory for your " + "platform. Typically ~/.local/, or %APPDATA%\\Python on " + "Windows. (See the Python documentation for site.USER_BASE " + "for full details.)" + ), + ) + self.cmd_opts.add_option( + "--no-user", + dest="use_user_site", + action="store_false", + help=SUPPRESS_HELP, + ) + self.cmd_opts.add_option( + "--root", + dest="root_path", + metavar="dir", + default=None, + help="Install everything relative to this alternate root directory.", + ) + self.cmd_opts.add_option( + "--prefix", + dest="prefix_path", + metavar="dir", + default=None, + help=( + "Installation prefix where lib, bin and other top-level " + "folders are placed. Note that the resulting installation may " + "contain scripts and other resources which reference the " + "Python interpreter of pip, and not that of ``--prefix``. " + "See also the ``--python`` option if the intention is to " + "install packages into another (possibly pip-free) " + "environment." + ), + ) + + self.cmd_opts.add_option(cmdoptions.src()) + + self.cmd_opts.add_option( + "-U", + "--upgrade", + dest="upgrade", + action="store_true", + help=( + "Upgrade all specified packages to the newest available " + "version. The handling of dependencies depends on the " + "upgrade-strategy used." + ), + ) + + self.cmd_opts.add_option( + "--upgrade-strategy", + dest="upgrade_strategy", + default="only-if-needed", + choices=["only-if-needed", "eager"], + help=( + "Determines how dependency upgrading should be handled " + "[default: %default]. " + '"eager" - dependencies are upgraded regardless of ' + "whether the currently installed version satisfies the " + "requirements of the upgraded package(s). " + '"only-if-needed" - are upgraded only when they do not ' + "satisfy the requirements of the upgraded package(s)." + ), + ) + + self.cmd_opts.add_option( + "--force-reinstall", + dest="force_reinstall", + action="store_true", + help="Reinstall all packages even if they are already up-to-date.", + ) + + self.cmd_opts.add_option( + "-I", + "--ignore-installed", + dest="ignore_installed", + action="store_true", + help=( + "Ignore the installed packages, overwriting them. " + "This can break your system if the existing package " + "is of a different version or was installed " + "with a different package manager!" + ), + ) + + self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) + self.cmd_opts.add_option(cmdoptions.no_build_isolation()) + self.cmd_opts.add_option(cmdoptions.use_pep517()) + self.cmd_opts.add_option(cmdoptions.no_use_pep517()) + self.cmd_opts.add_option(cmdoptions.check_build_deps()) + self.cmd_opts.add_option(cmdoptions.override_externally_managed()) + + self.cmd_opts.add_option(cmdoptions.config_settings()) + self.cmd_opts.add_option(cmdoptions.global_options()) + + self.cmd_opts.add_option( + "--compile", + action="store_true", + dest="compile", + default=True, + help="Compile Python source files to bytecode", + ) + + self.cmd_opts.add_option( + "--no-compile", + action="store_false", + dest="compile", + help="Do not compile Python source files to bytecode", + ) + + self.cmd_opts.add_option( + "--no-warn-script-location", + action="store_false", + dest="warn_script_location", + default=True, + help="Do not warn when installing scripts outside PATH", + ) + self.cmd_opts.add_option( + "--no-warn-conflicts", + action="store_false", + dest="warn_about_conflicts", + default=True, + help="Do not warn about broken dependencies", + ) + self.cmd_opts.add_option(cmdoptions.no_binary()) + self.cmd_opts.add_option(cmdoptions.only_binary()) + self.cmd_opts.add_option(cmdoptions.prefer_binary()) + self.cmd_opts.add_option(cmdoptions.require_hashes()) + self.cmd_opts.add_option(cmdoptions.progress_bar()) + self.cmd_opts.add_option(cmdoptions.root_user_action()) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + self.cmd_opts.add_option( + "--report", + dest="json_report_file", + metavar="file", + default=None, + help=( + "Generate a JSON file describing what pip did to install " + "the provided requirements. " + "Can be used in combination with --dry-run and --ignore-installed " + "to 'resolve' the requirements. " + "When - is used as file name it writes to stdout. " + "When writing to stdout, please combine with the --quiet option " + "to avoid mixing pip logging output with JSON output." + ), + ) + + @with_cleanup + def run(self, options: Values, args: List[str]) -> int: + if options.use_user_site and options.target_dir is not None: + raise CommandError("Can not combine '--user' and '--target'") + + # Check whether the environment we're installing into is externally + # managed, as specified in PEP 668. Specifying --root, --target, or + # --prefix disables the check, since there's no reliable way to locate + # the EXTERNALLY-MANAGED file for those cases. An exception is also + # made specifically for "--dry-run --report" for convenience. + installing_into_current_environment = ( + not (options.dry_run and options.json_report_file) + and options.root_path is None + and options.target_dir is None + and options.prefix_path is None + ) + if ( + installing_into_current_environment + and not options.override_externally_managed + ): + check_externally_managed() + + upgrade_strategy = "to-satisfy-only" + if options.upgrade: + upgrade_strategy = options.upgrade_strategy + + cmdoptions.check_dist_restriction(options, check_target=True) + + logger.verbose("Using %s", get_pip_version()) + options.use_user_site = decide_user_install( + options.use_user_site, + prefix_path=options.prefix_path, + target_dir=options.target_dir, + root_path=options.root_path, + isolated_mode=options.isolated_mode, + ) + + target_temp_dir: Optional[TempDirectory] = None + target_temp_dir_path: Optional[str] = None + if options.target_dir: + options.ignore_installed = True + options.target_dir = os.path.abspath(options.target_dir) + if ( + # fmt: off + os.path.exists(options.target_dir) and + not os.path.isdir(options.target_dir) + # fmt: on + ): + raise CommandError( + "Target path exists but is not a directory, will not continue." + ) + + # Create a target directory for using with the target option + target_temp_dir = TempDirectory(kind="target") + target_temp_dir_path = target_temp_dir.path + self.enter_context(target_temp_dir) + + global_options = options.global_options or [] + + session = self.get_default_session(options) + + target_python = make_target_python(options) + finder = self._build_package_finder( + options=options, + session=session, + target_python=target_python, + ignore_requires_python=options.ignore_requires_python, + ) + build_tracker = self.enter_context(get_build_tracker()) + + directory = TempDirectory( + delete=not options.no_clean, + kind="install", + globally_managed=True, + ) + + try: + reqs = self.get_requirements(args, options, finder, session) + check_legacy_setup_py_options(options, reqs) + + wheel_cache = WheelCache(options.cache_dir) + + # Only when installing is it permitted to use PEP 660. + # In other circumstances (pip wheel, pip download) we generate + # regular (i.e. non editable) metadata and wheels. + for req in reqs: + req.permit_editable_wheels = True + + preparer = self.make_requirement_preparer( + temp_build_dir=directory, + options=options, + build_tracker=build_tracker, + session=session, + finder=finder, + use_user_site=options.use_user_site, + verbosity=self.verbosity, + ) + resolver = self.make_resolver( + preparer=preparer, + finder=finder, + options=options, + wheel_cache=wheel_cache, + use_user_site=options.use_user_site, + ignore_installed=options.ignore_installed, + ignore_requires_python=options.ignore_requires_python, + force_reinstall=options.force_reinstall, + upgrade_strategy=upgrade_strategy, + use_pep517=options.use_pep517, + py_version_info=options.python_version, + ) + + self.trace_basic_info(finder) + + requirement_set = resolver.resolve( + reqs, check_supported_wheels=not options.target_dir + ) + + if options.json_report_file: + report = InstallationReport(requirement_set.requirements_to_install) + if options.json_report_file == "-": + print_json(data=report.to_dict()) + else: + with open(options.json_report_file, "w", encoding="utf-8") as f: + json.dump(report.to_dict(), f, indent=2, ensure_ascii=False) + + if options.dry_run: + would_install_items = sorted( + (r.metadata["name"], r.metadata["version"]) + for r in requirement_set.requirements_to_install + ) + if would_install_items: + write_output( + "Would install %s", + " ".join("-".join(item) for item in would_install_items), + ) + return SUCCESS + + try: + pip_req = requirement_set.get_requirement("pip") + except KeyError: + modifying_pip = False + else: + # If we're not replacing an already installed pip, + # we're not modifying it. + modifying_pip = pip_req.satisfied_by is None + protect_pip_from_modification_on_windows(modifying_pip=modifying_pip) + + reqs_to_build = [ + r + for r in requirement_set.requirements.values() + if should_build_for_install_command(r) + ] + + _, build_failures = build( + reqs_to_build, + wheel_cache=wheel_cache, + verify=True, + build_options=[], + global_options=global_options, + ) + + if build_failures: + raise InstallationError( + "Failed to build installable wheels for some " + "pyproject.toml based projects ({})".format( + ", ".join(r.name for r in build_failures) # type: ignore + ) + ) + + to_install = resolver.get_installation_order(requirement_set) + + # Check for conflicts in the package set we're installing. + conflicts: Optional[ConflictDetails] = None + should_warn_about_conflicts = ( + not options.ignore_dependencies and options.warn_about_conflicts + ) + if should_warn_about_conflicts: + conflicts = self._determine_conflicts(to_install) + + # Don't warn about script install locations if + # --target or --prefix has been specified + warn_script_location = options.warn_script_location + if options.target_dir or options.prefix_path: + warn_script_location = False + + installed = install_given_reqs( + to_install, + global_options, + root=options.root_path, + home=target_temp_dir_path, + prefix=options.prefix_path, + warn_script_location=warn_script_location, + use_user_site=options.use_user_site, + pycompile=options.compile, + ) + + lib_locations = get_lib_location_guesses( + user=options.use_user_site, + home=target_temp_dir_path, + root=options.root_path, + prefix=options.prefix_path, + isolated=options.isolated_mode, + ) + env = get_environment(lib_locations) + + # Display a summary of installed packages, with extra care to + # display a package name as it was requested by the user. + installed.sort(key=operator.attrgetter("name")) + summary = [] + installed_versions = {} + for distribution in env.iter_all_distributions(): + installed_versions[distribution.canonical_name] = distribution.version + for package in installed: + display_name = package.name + version = installed_versions.get(canonicalize_name(display_name), None) + if version: + text = f"{display_name}-{version}" + else: + text = display_name + summary.append(text) + + if conflicts is not None: + self._warn_about_conflicts( + conflicts, + resolver_variant=self.determine_resolver_variant(options), + ) + + installed_desc = " ".join(summary) + if installed_desc: + write_output( + "Successfully installed %s", + installed_desc, + ) + except OSError as error: + show_traceback = self.verbosity >= 1 + + message = create_os_error_message( + error, + show_traceback, + options.use_user_site, + ) + logger.error(message, exc_info=show_traceback) + + return ERROR + + if options.target_dir: + assert target_temp_dir + self._handle_target_dir( + options.target_dir, target_temp_dir, options.upgrade + ) + if options.root_user_action == "warn": + warn_if_run_as_root() + return SUCCESS + + def _handle_target_dir( + self, target_dir: str, target_temp_dir: TempDirectory, upgrade: bool + ) -> None: + ensure_dir(target_dir) + + # Checking both purelib and platlib directories for installed + # packages to be moved to target directory + lib_dir_list = [] + + # Checking both purelib and platlib directories for installed + # packages to be moved to target directory + scheme = get_scheme("", home=target_temp_dir.path) + purelib_dir = scheme.purelib + platlib_dir = scheme.platlib + data_dir = scheme.data + + if os.path.exists(purelib_dir): + lib_dir_list.append(purelib_dir) + if os.path.exists(platlib_dir) and platlib_dir != purelib_dir: + lib_dir_list.append(platlib_dir) + if os.path.exists(data_dir): + lib_dir_list.append(data_dir) + + for lib_dir in lib_dir_list: + for item in os.listdir(lib_dir): + if lib_dir == data_dir: + ddir = os.path.join(data_dir, item) + if any(s.startswith(ddir) for s in lib_dir_list[:-1]): + continue + target_item_dir = os.path.join(target_dir, item) + if os.path.exists(target_item_dir): + if not upgrade: + logger.warning( + "Target directory %s already exists. Specify " + "--upgrade to force replacement.", + target_item_dir, + ) + continue + if os.path.islink(target_item_dir): + logger.warning( + "Target directory %s already exists and is " + "a link. pip will not automatically replace " + "links, please remove if replacement is " + "desired.", + target_item_dir, + ) + continue + if os.path.isdir(target_item_dir): + shutil.rmtree(target_item_dir) + else: + os.remove(target_item_dir) + + shutil.move(os.path.join(lib_dir, item), target_item_dir) + + def _determine_conflicts( + self, to_install: List[InstallRequirement] + ) -> Optional[ConflictDetails]: + try: + return check_install_conflicts(to_install) + except Exception: + logger.exception( + "Error while checking for conflicts. Please file an issue on " + "pip's issue tracker: https://github.com/pypa/pip/issues/new" + ) + return None + + def _warn_about_conflicts( + self, conflict_details: ConflictDetails, resolver_variant: str + ) -> None: + package_set, (missing, conflicting) = conflict_details + if not missing and not conflicting: + return + + parts: List[str] = [] + if resolver_variant == "legacy": + parts.append( + "pip's legacy dependency resolver does not consider dependency " + "conflicts when selecting packages. This behaviour is the " + "source of the following dependency conflicts." + ) + else: + assert resolver_variant == "resolvelib" + parts.append( + "pip's dependency resolver does not currently take into account " + "all the packages that are installed. This behaviour is the " + "source of the following dependency conflicts." + ) + + # NOTE: There is some duplication here, with commands/check.py + for project_name in missing: + version = package_set[project_name][0] + for dependency in missing[project_name]: + message = ( + f"{project_name} {version} requires {dependency[1]}, " + "which is not installed." + ) + parts.append(message) + + for project_name in conflicting: + version = package_set[project_name][0] + for dep_name, dep_version, req in conflicting[project_name]: + message = ( + "{name} {version} requires {requirement}, but {you} have " + "{dep_name} {dep_version} which is incompatible." + ).format( + name=project_name, + version=version, + requirement=req, + dep_name=dep_name, + dep_version=dep_version, + you=("you" if resolver_variant == "resolvelib" else "you'll"), + ) + parts.append(message) + + logger.critical("\n".join(parts)) + + +def get_lib_location_guesses( + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + isolated: bool = False, + prefix: Optional[str] = None, +) -> List[str]: + scheme = get_scheme( + "", + user=user, + home=home, + root=root, + isolated=isolated, + prefix=prefix, + ) + return [scheme.purelib, scheme.platlib] + + +def site_packages_writable(root: Optional[str], isolated: bool) -> bool: + return all( + test_writable_dir(d) + for d in set(get_lib_location_guesses(root=root, isolated=isolated)) + ) + + +def decide_user_install( + use_user_site: Optional[bool], + prefix_path: Optional[str] = None, + target_dir: Optional[str] = None, + root_path: Optional[str] = None, + isolated_mode: bool = False, +) -> bool: + """Determine whether to do a user install based on the input options. + + If use_user_site is False, no additional checks are done. + If use_user_site is True, it is checked for compatibility with other + options. + If use_user_site is None, the default behaviour depends on the environment, + which is provided by the other arguments. + """ + # In some cases (config from tox), use_user_site can be set to an integer + # rather than a bool, which 'use_user_site is False' wouldn't catch. + if (use_user_site is not None) and (not use_user_site): + logger.debug("Non-user install by explicit request") + return False + + if use_user_site: + if prefix_path: + raise CommandError( + "Can not combine '--user' and '--prefix' as they imply " + "different installation locations" + ) + if virtualenv_no_global(): + raise InstallationError( + "Can not perform a '--user' install. User site-packages " + "are not visible in this virtualenv." + ) + logger.debug("User install by explicit request") + return True + + # If we are here, user installs have not been explicitly requested/avoided + assert use_user_site is None + + # user install incompatible with --prefix/--target + if prefix_path or target_dir: + logger.debug("Non-user install due to --prefix or --target option") + return False + + # If user installs are not enabled, choose a non-user install + if not site.ENABLE_USER_SITE: + logger.debug("Non-user install because user site-packages disabled") + return False + + # If we have permission for a non-user install, do that, + # otherwise do a user install. + if site_packages_writable(root=root_path, isolated=isolated_mode): + logger.debug("Non-user install because site-packages writeable") + return False + + logger.info( + "Defaulting to user installation because normal site-packages " + "is not writeable" + ) + return True + + +def create_os_error_message( + error: OSError, show_traceback: bool, using_user_site: bool +) -> str: + """Format an error message for an OSError + + It may occur anytime during the execution of the install command. + """ + parts = [] + + # Mention the error if we are not going to show a traceback + parts.append("Could not install packages due to an OSError") + if not show_traceback: + parts.append(": ") + parts.append(str(error)) + else: + parts.append(".") + + # Spilt the error indication from a helper message (if any) + parts[-1] += "\n" + + # Suggest useful actions to the user: + # (1) using user site-packages or (2) verifying the permissions + if error.errno == errno.EACCES: + user_option_part = "Consider using the `--user` option" + permissions_part = "Check the permissions" + + if not running_under_virtualenv() and not using_user_site: + parts.extend( + [ + user_option_part, + " or ", + permissions_part.lower(), + ] + ) + else: + parts.append(permissions_part) + parts.append(".\n") + + # Suggest the user to enable Long Paths if path length is + # more than 260 + if ( + WINDOWS + and error.errno == errno.ENOENT + and error.filename + and len(error.filename) > 260 + ): + parts.append( + "HINT: This error might have occurred since " + "this system does not have Windows Long Path " + "support enabled. You can find information on " + "how to enable this at " + "https://pip.pypa.io/warnings/enable-long-paths\n" + ) + + return "".join(parts).strip() + "\n" diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/list.py b/env/lib/python3.12/site-packages/pip/_internal/commands/list.py new file mode 100644 index 0000000..8494370 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/list.py @@ -0,0 +1,375 @@ +import json +import logging +from optparse import Values +from typing import TYPE_CHECKING, Generator, List, Optional, Sequence, Tuple, cast + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.packaging.version import Version + +from pip._internal.cli import cmdoptions +from pip._internal.cli.index_command import IndexGroupCommand +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import CommandError +from pip._internal.metadata import BaseDistribution, get_environment +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.utils.compat import stdlib_pkgs +from pip._internal.utils.misc import tabulate, write_output + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + from pip._internal.network.session import PipSession + + class _DistWithLatestInfo(BaseDistribution): + """Give the distribution object a couple of extra fields. + + These will be populated during ``get_outdated()``. This is dirty but + makes the rest of the code much cleaner. + """ + + latest_version: Version + latest_filetype: str + + _ProcessedDists = Sequence[_DistWithLatestInfo] + + +logger = logging.getLogger(__name__) + + +class ListCommand(IndexGroupCommand): + """ + List installed packages, including editables. + + Packages are listed in a case-insensitive sorted order. + """ + + ignore_require_venv = True + usage = """ + %prog [options]""" + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-o", + "--outdated", + action="store_true", + default=False, + help="List outdated packages", + ) + self.cmd_opts.add_option( + "-u", + "--uptodate", + action="store_true", + default=False, + help="List uptodate packages", + ) + self.cmd_opts.add_option( + "-e", + "--editable", + action="store_true", + default=False, + help="List editable projects.", + ) + self.cmd_opts.add_option( + "-l", + "--local", + action="store_true", + default=False, + help=( + "If in a virtualenv that has global access, do not list " + "globally-installed packages." + ), + ) + self.cmd_opts.add_option( + "--user", + dest="user", + action="store_true", + default=False, + help="Only output packages installed in user-site.", + ) + self.cmd_opts.add_option(cmdoptions.list_path()) + self.cmd_opts.add_option( + "--pre", + action="store_true", + default=False, + help=( + "Include pre-release and development versions. By default, " + "pip only finds stable versions." + ), + ) + + self.cmd_opts.add_option( + "--format", + action="store", + dest="list_format", + default="columns", + choices=("columns", "freeze", "json"), + help=( + "Select the output format among: columns (default), freeze, or json. " + "The 'freeze' format cannot be used with the --outdated option." + ), + ) + + self.cmd_opts.add_option( + "--not-required", + action="store_true", + dest="not_required", + help="List packages that are not dependencies of installed packages.", + ) + + self.cmd_opts.add_option( + "--exclude-editable", + action="store_false", + dest="include_editable", + help="Exclude editable package from output.", + ) + self.cmd_opts.add_option( + "--include-editable", + action="store_true", + dest="include_editable", + help="Include editable package from output.", + default=True, + ) + self.cmd_opts.add_option(cmdoptions.list_exclude()) + index_opts = cmdoptions.make_option_group(cmdoptions.index_group, self.parser) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + def handle_pip_version_check(self, options: Values) -> None: + if options.outdated or options.uptodate: + super().handle_pip_version_check(options) + + def _build_package_finder( + self, options: Values, session: "PipSession" + ) -> "PackageFinder": + """ + Create a package finder appropriate to this list command. + """ + # Lazy import the heavy index modules as most list invocations won't need 'em. + from pip._internal.index.collector import LinkCollector + from pip._internal.index.package_finder import PackageFinder + + link_collector = LinkCollector.create(session, options=options) + + # Pass allow_yanked=False to ignore yanked versions. + selection_prefs = SelectionPreferences( + allow_yanked=False, + allow_all_prereleases=options.pre, + ) + + return PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + ) + + def run(self, options: Values, args: List[str]) -> int: + if options.outdated and options.uptodate: + raise CommandError("Options --outdated and --uptodate cannot be combined.") + + if options.outdated and options.list_format == "freeze": + raise CommandError( + "List format 'freeze' cannot be used with the --outdated option." + ) + + cmdoptions.check_list_path_option(options) + + skip = set(stdlib_pkgs) + if options.excludes: + skip.update(canonicalize_name(n) for n in options.excludes) + + packages: _ProcessedDists = [ + cast("_DistWithLatestInfo", d) + for d in get_environment(options.path).iter_installed_distributions( + local_only=options.local, + user_only=options.user, + editables_only=options.editable, + include_editables=options.include_editable, + skip=skip, + ) + ] + + # get_not_required must be called firstly in order to find and + # filter out all dependencies correctly. Otherwise a package + # can't be identified as requirement because some parent packages + # could be filtered out before. + if options.not_required: + packages = self.get_not_required(packages, options) + + if options.outdated: + packages = self.get_outdated(packages, options) + elif options.uptodate: + packages = self.get_uptodate(packages, options) + + self.output_package_listing(packages, options) + return SUCCESS + + def get_outdated( + self, packages: "_ProcessedDists", options: Values + ) -> "_ProcessedDists": + return [ + dist + for dist in self.iter_packages_latest_infos(packages, options) + if dist.latest_version > dist.version + ] + + def get_uptodate( + self, packages: "_ProcessedDists", options: Values + ) -> "_ProcessedDists": + return [ + dist + for dist in self.iter_packages_latest_infos(packages, options) + if dist.latest_version == dist.version + ] + + def get_not_required( + self, packages: "_ProcessedDists", options: Values + ) -> "_ProcessedDists": + dep_keys = { + canonicalize_name(dep.name) + for dist in packages + for dep in (dist.iter_dependencies() or ()) + } + + # Create a set to remove duplicate packages, and cast it to a list + # to keep the return type consistent with get_outdated and + # get_uptodate + return list({pkg for pkg in packages if pkg.canonical_name not in dep_keys}) + + def iter_packages_latest_infos( + self, packages: "_ProcessedDists", options: Values + ) -> Generator["_DistWithLatestInfo", None, None]: + with self._build_session(options) as session: + finder = self._build_package_finder(options, session) + + def latest_info( + dist: "_DistWithLatestInfo", + ) -> Optional["_DistWithLatestInfo"]: + all_candidates = finder.find_all_candidates(dist.canonical_name) + if not options.pre: + # Remove prereleases + all_candidates = [ + candidate + for candidate in all_candidates + if not candidate.version.is_prerelease + ] + + evaluator = finder.make_candidate_evaluator( + project_name=dist.canonical_name, + ) + best_candidate = evaluator.sort_best_candidate(all_candidates) + if best_candidate is None: + return None + + remote_version = best_candidate.version + if best_candidate.link.is_wheel: + typ = "wheel" + else: + typ = "sdist" + dist.latest_version = remote_version + dist.latest_filetype = typ + return dist + + for dist in map(latest_info, packages): + if dist is not None: + yield dist + + def output_package_listing( + self, packages: "_ProcessedDists", options: Values + ) -> None: + packages = sorted( + packages, + key=lambda dist: dist.canonical_name, + ) + if options.list_format == "columns" and packages: + data, header = format_for_columns(packages, options) + self.output_package_listing_columns(data, header) + elif options.list_format == "freeze": + for dist in packages: + if options.verbose >= 1: + write_output( + "%s==%s (%s)", dist.raw_name, dist.version, dist.location + ) + else: + write_output("%s==%s", dist.raw_name, dist.version) + elif options.list_format == "json": + write_output(format_for_json(packages, options)) + + def output_package_listing_columns( + self, data: List[List[str]], header: List[str] + ) -> None: + # insert the header first: we need to know the size of column names + if len(data) > 0: + data.insert(0, header) + + pkg_strings, sizes = tabulate(data) + + # Create and add a separator. + if len(data) > 0: + pkg_strings.insert(1, " ".join("-" * x for x in sizes)) + + for val in pkg_strings: + write_output(val) + + +def format_for_columns( + pkgs: "_ProcessedDists", options: Values +) -> Tuple[List[List[str]], List[str]]: + """ + Convert the package data into something usable + by output_package_listing_columns. + """ + header = ["Package", "Version"] + + running_outdated = options.outdated + if running_outdated: + header.extend(["Latest", "Type"]) + + has_editables = any(x.editable for x in pkgs) + if has_editables: + header.append("Editable project location") + + if options.verbose >= 1: + header.append("Location") + if options.verbose >= 1: + header.append("Installer") + + data = [] + for proj in pkgs: + # if we're working on the 'outdated' list, separate out the + # latest_version and type + row = [proj.raw_name, proj.raw_version] + + if running_outdated: + row.append(str(proj.latest_version)) + row.append(proj.latest_filetype) + + if has_editables: + row.append(proj.editable_project_location or "") + + if options.verbose >= 1: + row.append(proj.location or "") + if options.verbose >= 1: + row.append(proj.installer) + + data.append(row) + + return data, header + + +def format_for_json(packages: "_ProcessedDists", options: Values) -> str: + data = [] + for dist in packages: + info = { + "name": dist.raw_name, + "version": str(dist.version), + } + if options.verbose >= 1: + info["location"] = dist.location or "" + info["installer"] = dist.installer + if options.outdated: + info["latest_version"] = str(dist.latest_version) + info["latest_filetype"] = dist.latest_filetype + editable_project_location = dist.editable_project_location + if editable_project_location: + info["editable_project_location"] = editable_project_location + data.append(info) + return json.dumps(data) diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/search.py b/env/lib/python3.12/site-packages/pip/_internal/commands/search.py new file mode 100644 index 0000000..74b8d65 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/search.py @@ -0,0 +1,172 @@ +import logging +import shutil +import sys +import textwrap +import xmlrpc.client +from collections import OrderedDict +from optparse import Values +from typing import TYPE_CHECKING, Dict, List, Optional, TypedDict + +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.cli.base_command import Command +from pip._internal.cli.req_command import SessionCommandMixin +from pip._internal.cli.status_codes import NO_MATCHES_FOUND, SUCCESS +from pip._internal.exceptions import CommandError +from pip._internal.metadata import get_default_environment +from pip._internal.models.index import PyPI +from pip._internal.network.xmlrpc import PipXmlrpcTransport +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import write_output + +if TYPE_CHECKING: + + class TransformedHit(TypedDict): + name: str + summary: str + versions: List[str] + + +logger = logging.getLogger(__name__) + + +class SearchCommand(Command, SessionCommandMixin): + """Search for PyPI packages whose name or summary contains .""" + + usage = """ + %prog [options] """ + ignore_require_venv = True + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-i", + "--index", + dest="index", + metavar="URL", + default=PyPI.pypi_url, + help="Base URL of Python Package Index (default %default)", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + if not args: + raise CommandError("Missing required argument (search query).") + query = args + pypi_hits = self.search(query, options) + hits = transform_hits(pypi_hits) + + terminal_width = None + if sys.stdout.isatty(): + terminal_width = shutil.get_terminal_size()[0] + + print_results(hits, terminal_width=terminal_width) + if pypi_hits: + return SUCCESS + return NO_MATCHES_FOUND + + def search(self, query: List[str], options: Values) -> List[Dict[str, str]]: + index_url = options.index + + session = self.get_default_session(options) + + transport = PipXmlrpcTransport(index_url, session) + pypi = xmlrpc.client.ServerProxy(index_url, transport) + try: + hits = pypi.search({"name": query, "summary": query}, "or") + except xmlrpc.client.Fault as fault: + message = ( + f"XMLRPC request failed [code: {fault.faultCode}]\n{fault.faultString}" + ) + raise CommandError(message) + assert isinstance(hits, list) + return hits + + +def transform_hits(hits: List[Dict[str, str]]) -> List["TransformedHit"]: + """ + The list from pypi is really a list of versions. We want a list of + packages with the list of versions stored inline. This converts the + list from pypi into one we can use. + """ + packages: Dict[str, TransformedHit] = OrderedDict() + for hit in hits: + name = hit["name"] + summary = hit["summary"] + version = hit["version"] + + if name not in packages.keys(): + packages[name] = { + "name": name, + "summary": summary, + "versions": [version], + } + else: + packages[name]["versions"].append(version) + + # if this is the highest version, replace summary and score + if version == highest_version(packages[name]["versions"]): + packages[name]["summary"] = summary + + return list(packages.values()) + + +def print_dist_installation_info(name: str, latest: str) -> None: + env = get_default_environment() + dist = env.get_distribution(name) + if dist is not None: + with indent_log(): + if dist.version == latest: + write_output("INSTALLED: %s (latest)", dist.version) + else: + write_output("INSTALLED: %s", dist.version) + if parse_version(latest).pre: + write_output( + "LATEST: %s (pre-release; install" + " with `pip install --pre`)", + latest, + ) + else: + write_output("LATEST: %s", latest) + + +def print_results( + hits: List["TransformedHit"], + name_column_width: Optional[int] = None, + terminal_width: Optional[int] = None, +) -> None: + if not hits: + return + if name_column_width is None: + name_column_width = ( + max( + [ + len(hit["name"]) + len(highest_version(hit.get("versions", ["-"]))) + for hit in hits + ] + ) + + 4 + ) + + for hit in hits: + name = hit["name"] + summary = hit["summary"] or "" + latest = highest_version(hit.get("versions", ["-"])) + if terminal_width is not None: + target_width = terminal_width - name_column_width - 5 + if target_width > 10: + # wrap and indent summary to fit terminal + summary_lines = textwrap.wrap(summary, target_width) + summary = ("\n" + " " * (name_column_width + 3)).join(summary_lines) + + name_latest = f"{name} ({latest})" + line = f"{name_latest:{name_column_width}} - {summary}" + try: + write_output(line) + print_dist_installation_info(name, latest) + except UnicodeEncodeError: + pass + + +def highest_version(versions: List[str]) -> str: + return max(versions, key=parse_version) diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/show.py b/env/lib/python3.12/site-packages/pip/_internal/commands/show.py new file mode 100644 index 0000000..b47500c --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/show.py @@ -0,0 +1,224 @@ +import logging +from optparse import Values +from typing import Generator, Iterable, Iterator, List, NamedTuple, Optional + +from pip._vendor.packaging.requirements import InvalidRequirement +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.metadata import BaseDistribution, get_default_environment +from pip._internal.utils.misc import write_output + +logger = logging.getLogger(__name__) + + +class ShowCommand(Command): + """ + Show information about one or more installed packages. + + The output is in RFC-compliant mail header format. + """ + + usage = """ + %prog [options] ...""" + ignore_require_venv = True + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-f", + "--files", + dest="files", + action="store_true", + default=False, + help="Show the full list of installed files for each package.", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + if not args: + logger.warning("ERROR: Please provide a package name or names.") + return ERROR + query = args + + results = search_packages_info(query) + if not print_results( + results, list_files=options.files, verbose=options.verbose + ): + return ERROR + return SUCCESS + + +class _PackageInfo(NamedTuple): + name: str + version: str + location: str + editable_project_location: Optional[str] + requires: List[str] + required_by: List[str] + installer: str + metadata_version: str + classifiers: List[str] + summary: str + homepage: str + project_urls: List[str] + author: str + author_email: str + license: str + license_expression: str + entry_points: List[str] + files: Optional[List[str]] + + +def search_packages_info(query: List[str]) -> Generator[_PackageInfo, None, None]: + """ + Gather details from installed distributions. Print distribution name, + version, location, and installed files. Installed files requires a + pip generated 'installed-files.txt' in the distributions '.egg-info' + directory. + """ + env = get_default_environment() + + installed = {dist.canonical_name: dist for dist in env.iter_all_distributions()} + query_names = [canonicalize_name(name) for name in query] + missing = sorted( + [name for name, pkg in zip(query, query_names) if pkg not in installed] + ) + if missing: + logger.warning("Package(s) not found: %s", ", ".join(missing)) + + def _get_requiring_packages(current_dist: BaseDistribution) -> Iterator[str]: + return ( + dist.metadata["Name"] or "UNKNOWN" + for dist in installed.values() + if current_dist.canonical_name + in {canonicalize_name(d.name) for d in dist.iter_dependencies()} + ) + + for query_name in query_names: + try: + dist = installed[query_name] + except KeyError: + continue + + try: + requires = sorted( + # Avoid duplicates in requirements (e.g. due to environment markers). + {req.name for req in dist.iter_dependencies()}, + key=str.lower, + ) + except InvalidRequirement: + requires = sorted(dist.iter_raw_dependencies(), key=str.lower) + + try: + required_by = sorted(_get_requiring_packages(dist), key=str.lower) + except InvalidRequirement: + required_by = ["#N/A"] + + try: + entry_points_text = dist.read_text("entry_points.txt") + entry_points = entry_points_text.splitlines(keepends=False) + except FileNotFoundError: + entry_points = [] + + files_iter = dist.iter_declared_entries() + if files_iter is None: + files: Optional[List[str]] = None + else: + files = sorted(files_iter) + + metadata = dist.metadata + + project_urls = metadata.get_all("Project-URL", []) + homepage = metadata.get("Home-page", "") + if not homepage: + # It's common that there is a "homepage" Project-URL, but Home-page + # remains unset (especially as PEP 621 doesn't surface the field). + # + # This logic was taken from PyPI's codebase. + for url in project_urls: + url_label, url = url.split(",", maxsplit=1) + normalized_label = ( + url_label.casefold().replace("-", "").replace("_", "").strip() + ) + if normalized_label == "homepage": + homepage = url.strip() + break + + yield _PackageInfo( + name=dist.raw_name, + version=dist.raw_version, + location=dist.location or "", + editable_project_location=dist.editable_project_location, + requires=requires, + required_by=required_by, + installer=dist.installer, + metadata_version=dist.metadata_version or "", + classifiers=metadata.get_all("Classifier", []), + summary=metadata.get("Summary", ""), + homepage=homepage, + project_urls=project_urls, + author=metadata.get("Author", ""), + author_email=metadata.get("Author-email", ""), + license=metadata.get("License", ""), + license_expression=metadata.get("License-Expression", ""), + entry_points=entry_points, + files=files, + ) + + +def print_results( + distributions: Iterable[_PackageInfo], + list_files: bool, + verbose: bool, +) -> bool: + """ + Print the information from installed distributions found. + """ + results_printed = False + for i, dist in enumerate(distributions): + results_printed = True + if i > 0: + write_output("---") + + metadata_version_tuple = tuple(map(int, dist.metadata_version.split("."))) + + write_output("Name: %s", dist.name) + write_output("Version: %s", dist.version) + write_output("Summary: %s", dist.summary) + write_output("Home-page: %s", dist.homepage) + write_output("Author: %s", dist.author) + write_output("Author-email: %s", dist.author_email) + if metadata_version_tuple >= (2, 4) and dist.license_expression: + write_output("License-Expression: %s", dist.license_expression) + else: + write_output("License: %s", dist.license) + write_output("Location: %s", dist.location) + if dist.editable_project_location is not None: + write_output( + "Editable project location: %s", dist.editable_project_location + ) + write_output("Requires: %s", ", ".join(dist.requires)) + write_output("Required-by: %s", ", ".join(dist.required_by)) + + if verbose: + write_output("Metadata-Version: %s", dist.metadata_version) + write_output("Installer: %s", dist.installer) + write_output("Classifiers:") + for classifier in dist.classifiers: + write_output(" %s", classifier) + write_output("Entry-points:") + for entry in dist.entry_points: + write_output(" %s", entry.strip()) + write_output("Project-URLs:") + for project_url in dist.project_urls: + write_output(" %s", project_url) + if list_files: + write_output("Files:") + if dist.files is None: + write_output("Cannot locate RECORD or installed-files.txt") + else: + for line in dist.files: + write_output(" %s", line.strip()) + return results_printed diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/uninstall.py b/env/lib/python3.12/site-packages/pip/_internal/commands/uninstall.py new file mode 100644 index 0000000..bc0edea --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/uninstall.py @@ -0,0 +1,114 @@ +import logging +from optparse import Values +from typing import List + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.index_command import SessionCommandMixin +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import InstallationError +from pip._internal.req import parse_requirements +from pip._internal.req.constructors import ( + install_req_from_line, + install_req_from_parsed_requirement, +) +from pip._internal.utils.misc import ( + check_externally_managed, + protect_pip_from_modification_on_windows, + warn_if_run_as_root, +) + +logger = logging.getLogger(__name__) + + +class UninstallCommand(Command, SessionCommandMixin): + """ + Uninstall packages. + + pip is able to uninstall most installed packages. Known exceptions are: + + - Pure distutils packages installed with ``python setup.py install``, which + leave behind no metadata to determine what files were installed. + - Script wrappers installed by ``python setup.py develop``. + """ + + usage = """ + %prog [options] ... + %prog [options] -r ...""" + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-r", + "--requirement", + dest="requirements", + action="append", + default=[], + metavar="file", + help=( + "Uninstall all the packages listed in the given requirements " + "file. This option can be used multiple times." + ), + ) + self.cmd_opts.add_option( + "-y", + "--yes", + dest="yes", + action="store_true", + help="Don't ask for confirmation of uninstall deletions.", + ) + self.cmd_opts.add_option(cmdoptions.root_user_action()) + self.cmd_opts.add_option(cmdoptions.override_externally_managed()) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + session = self.get_default_session(options) + + reqs_to_uninstall = {} + for name in args: + req = install_req_from_line( + name, + isolated=options.isolated_mode, + ) + if req.name: + reqs_to_uninstall[canonicalize_name(req.name)] = req + else: + logger.warning( + "Invalid requirement: %r ignored -" + " the uninstall command expects named" + " requirements.", + name, + ) + for filename in options.requirements: + for parsed_req in parse_requirements( + filename, options=options, session=session + ): + req = install_req_from_parsed_requirement( + parsed_req, isolated=options.isolated_mode + ) + if req.name: + reqs_to_uninstall[canonicalize_name(req.name)] = req + if not reqs_to_uninstall: + raise InstallationError( + f"You must give at least one requirement to {self.name} (see " + f'"pip help {self.name}")' + ) + + if not options.override_externally_managed: + check_externally_managed() + + protect_pip_from_modification_on_windows( + modifying_pip="pip" in reqs_to_uninstall + ) + + for req in reqs_to_uninstall.values(): + uninstall_pathset = req.uninstall( + auto_confirm=options.yes, + verbose=self.verbosity > 0, + ) + if uninstall_pathset: + uninstall_pathset.commit() + if options.root_user_action == "warn": + warn_if_run_as_root() + return SUCCESS diff --git a/env/lib/python3.12/site-packages/pip/_internal/commands/wheel.py b/env/lib/python3.12/site-packages/pip/_internal/commands/wheel.py new file mode 100644 index 0000000..278719f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/commands/wheel.py @@ -0,0 +1,182 @@ +import logging +import os +import shutil +from optparse import Values +from typing import List + +from pip._internal.cache import WheelCache +from pip._internal.cli import cmdoptions +from pip._internal.cli.req_command import RequirementCommand, with_cleanup +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import CommandError +from pip._internal.operations.build.build_tracker import get_build_tracker +from pip._internal.req.req_install import ( + InstallRequirement, + check_legacy_setup_py_options, +) +from pip._internal.utils.misc import ensure_dir, normalize_path +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.wheel_builder import build, should_build_for_wheel_command + +logger = logging.getLogger(__name__) + + +class WheelCommand(RequirementCommand): + """ + Build Wheel archives for your requirements and dependencies. + + Wheel is a built-package format, and offers the advantage of not + recompiling your software during every install. For more details, see the + wheel docs: https://wheel.readthedocs.io/en/latest/ + + 'pip wheel' uses the build system interface as described here: + https://pip.pypa.io/en/stable/reference/build-system/ + + """ + + usage = """ + %prog [options] ... + %prog [options] -r ... + %prog [options] [-e] ... + %prog [options] [-e] ... + %prog [options] ...""" + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-w", + "--wheel-dir", + dest="wheel_dir", + metavar="dir", + default=os.curdir, + help=( + "Build wheels into , where the default is the " + "current working directory." + ), + ) + self.cmd_opts.add_option(cmdoptions.no_binary()) + self.cmd_opts.add_option(cmdoptions.only_binary()) + self.cmd_opts.add_option(cmdoptions.prefer_binary()) + self.cmd_opts.add_option(cmdoptions.no_build_isolation()) + self.cmd_opts.add_option(cmdoptions.use_pep517()) + self.cmd_opts.add_option(cmdoptions.no_use_pep517()) + self.cmd_opts.add_option(cmdoptions.check_build_deps()) + self.cmd_opts.add_option(cmdoptions.constraints()) + self.cmd_opts.add_option(cmdoptions.editable()) + self.cmd_opts.add_option(cmdoptions.requirements()) + self.cmd_opts.add_option(cmdoptions.src()) + self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) + self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.progress_bar()) + + self.cmd_opts.add_option( + "--no-verify", + dest="no_verify", + action="store_true", + default=False, + help="Don't verify if built wheel is valid.", + ) + + self.cmd_opts.add_option(cmdoptions.config_settings()) + self.cmd_opts.add_option(cmdoptions.build_options()) + self.cmd_opts.add_option(cmdoptions.global_options()) + + self.cmd_opts.add_option( + "--pre", + action="store_true", + default=False, + help=( + "Include pre-release and development versions. By default, " + "pip only finds stable versions." + ), + ) + + self.cmd_opts.add_option(cmdoptions.require_hashes()) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + @with_cleanup + def run(self, options: Values, args: List[str]) -> int: + session = self.get_default_session(options) + + finder = self._build_package_finder(options, session) + + options.wheel_dir = normalize_path(options.wheel_dir) + ensure_dir(options.wheel_dir) + + build_tracker = self.enter_context(get_build_tracker()) + + directory = TempDirectory( + delete=not options.no_clean, + kind="wheel", + globally_managed=True, + ) + + reqs = self.get_requirements(args, options, finder, session) + check_legacy_setup_py_options(options, reqs) + + wheel_cache = WheelCache(options.cache_dir) + + preparer = self.make_requirement_preparer( + temp_build_dir=directory, + options=options, + build_tracker=build_tracker, + session=session, + finder=finder, + download_dir=options.wheel_dir, + use_user_site=False, + verbosity=self.verbosity, + ) + + resolver = self.make_resolver( + preparer=preparer, + finder=finder, + options=options, + wheel_cache=wheel_cache, + ignore_requires_python=options.ignore_requires_python, + use_pep517=options.use_pep517, + ) + + self.trace_basic_info(finder) + + requirement_set = resolver.resolve(reqs, check_supported_wheels=True) + + reqs_to_build: List[InstallRequirement] = [] + for req in requirement_set.requirements.values(): + if req.is_wheel: + preparer.save_linked_requirement(req) + elif should_build_for_wheel_command(req): + reqs_to_build.append(req) + + preparer.prepare_linked_requirements_more(requirement_set.requirements.values()) + + # build wheels + build_successes, build_failures = build( + reqs_to_build, + wheel_cache=wheel_cache, + verify=(not options.no_verify), + build_options=options.build_options or [], + global_options=options.global_options or [], + ) + for req in build_successes: + assert req.link and req.link.is_wheel + assert req.local_file_path + # copy from cache to target directory + try: + shutil.copy(req.local_file_path, options.wheel_dir) + except OSError as e: + logger.warning( + "Building wheel for %s failed: %s", + req.name, + e, + ) + build_failures.append(req) + if len(build_failures) != 0: + raise CommandError("Failed to build one or more wheels") + + return SUCCESS diff --git a/env/lib/python3.12/site-packages/pip/_internal/configuration.py b/env/lib/python3.12/site-packages/pip/_internal/configuration.py new file mode 100644 index 0000000..ffeda1d --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/configuration.py @@ -0,0 +1,383 @@ +"""Configuration management setup + +Some terminology: +- name + As written in config files. +- value + Value associated with a name +- key + Name combined with it's section (section.name) +- variant + A single word describing where the configuration key-value pair came from +""" + +import configparser +import locale +import os +import sys +from typing import Any, Dict, Iterable, List, NewType, Optional, Tuple + +from pip._internal.exceptions import ( + ConfigurationError, + ConfigurationFileCouldNotBeLoaded, +) +from pip._internal.utils import appdirs +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.logging import getLogger +from pip._internal.utils.misc import ensure_dir, enum + +RawConfigParser = configparser.RawConfigParser # Shorthand +Kind = NewType("Kind", str) + +CONFIG_BASENAME = "pip.ini" if WINDOWS else "pip.conf" +ENV_NAMES_IGNORED = "version", "help" + +# The kinds of configurations there are. +kinds = enum( + USER="user", # User Specific + GLOBAL="global", # System Wide + SITE="site", # [Virtual] Environment Specific + ENV="env", # from PIP_CONFIG_FILE + ENV_VAR="env-var", # from Environment Variables +) +OVERRIDE_ORDER = kinds.GLOBAL, kinds.USER, kinds.SITE, kinds.ENV, kinds.ENV_VAR +VALID_LOAD_ONLY = kinds.USER, kinds.GLOBAL, kinds.SITE + +logger = getLogger(__name__) + + +# NOTE: Maybe use the optionx attribute to normalize keynames. +def _normalize_name(name: str) -> str: + """Make a name consistent regardless of source (environment or file)""" + name = name.lower().replace("_", "-") + if name.startswith("--"): + name = name[2:] # only prefer long opts + return name + + +def _disassemble_key(name: str) -> List[str]: + if "." not in name: + error_message = ( + "Key does not contain dot separated section and key. " + f"Perhaps you wanted to use 'global.{name}' instead?" + ) + raise ConfigurationError(error_message) + return name.split(".", 1) + + +def get_configuration_files() -> Dict[Kind, List[str]]: + global_config_files = [ + os.path.join(path, CONFIG_BASENAME) for path in appdirs.site_config_dirs("pip") + ] + + site_config_file = os.path.join(sys.prefix, CONFIG_BASENAME) + legacy_config_file = os.path.join( + os.path.expanduser("~"), + "pip" if WINDOWS else ".pip", + CONFIG_BASENAME, + ) + new_config_file = os.path.join(appdirs.user_config_dir("pip"), CONFIG_BASENAME) + return { + kinds.GLOBAL: global_config_files, + kinds.SITE: [site_config_file], + kinds.USER: [legacy_config_file, new_config_file], + } + + +class Configuration: + """Handles management of configuration. + + Provides an interface to accessing and managing configuration files. + + This class converts provides an API that takes "section.key-name" style + keys and stores the value associated with it as "key-name" under the + section "section". + + This allows for a clean interface wherein the both the section and the + key-name are preserved in an easy to manage form in the configuration files + and the data stored is also nice. + """ + + def __init__(self, isolated: bool, load_only: Optional[Kind] = None) -> None: + super().__init__() + + if load_only is not None and load_only not in VALID_LOAD_ONLY: + raise ConfigurationError( + "Got invalid value for load_only - should be one of {}".format( + ", ".join(map(repr, VALID_LOAD_ONLY)) + ) + ) + self.isolated = isolated + self.load_only = load_only + + # Because we keep track of where we got the data from + self._parsers: Dict[Kind, List[Tuple[str, RawConfigParser]]] = { + variant: [] for variant in OVERRIDE_ORDER + } + self._config: Dict[Kind, Dict[str, Any]] = { + variant: {} for variant in OVERRIDE_ORDER + } + self._modified_parsers: List[Tuple[str, RawConfigParser]] = [] + + def load(self) -> None: + """Loads configuration from configuration files and environment""" + self._load_config_files() + if not self.isolated: + self._load_environment_vars() + + def get_file_to_edit(self) -> Optional[str]: + """Returns the file with highest priority in configuration""" + assert self.load_only is not None, "Need to be specified a file to be editing" + + try: + return self._get_parser_to_modify()[0] + except IndexError: + return None + + def items(self) -> Iterable[Tuple[str, Any]]: + """Returns key-value pairs like dict.items() representing the loaded + configuration + """ + return self._dictionary.items() + + def get_value(self, key: str) -> Any: + """Get a value from the configuration.""" + orig_key = key + key = _normalize_name(key) + try: + return self._dictionary[key] + except KeyError: + # disassembling triggers a more useful error message than simply + # "No such key" in the case that the key isn't in the form command.option + _disassemble_key(key) + raise ConfigurationError(f"No such key - {orig_key}") + + def set_value(self, key: str, value: Any) -> None: + """Modify a value in the configuration.""" + key = _normalize_name(key) + self._ensure_have_load_only() + + assert self.load_only + fname, parser = self._get_parser_to_modify() + + if parser is not None: + section, name = _disassemble_key(key) + + # Modify the parser and the configuration + if not parser.has_section(section): + parser.add_section(section) + parser.set(section, name, value) + + self._config[self.load_only][key] = value + self._mark_as_modified(fname, parser) + + def unset_value(self, key: str) -> None: + """Unset a value in the configuration.""" + orig_key = key + key = _normalize_name(key) + self._ensure_have_load_only() + + assert self.load_only + if key not in self._config[self.load_only]: + raise ConfigurationError(f"No such key - {orig_key}") + + fname, parser = self._get_parser_to_modify() + + if parser is not None: + section, name = _disassemble_key(key) + if not ( + parser.has_section(section) and parser.remove_option(section, name) + ): + # The option was not removed. + raise ConfigurationError( + "Fatal Internal error [id=1]. Please report as a bug." + ) + + # The section may be empty after the option was removed. + if not parser.items(section): + parser.remove_section(section) + self._mark_as_modified(fname, parser) + + del self._config[self.load_only][key] + + def save(self) -> None: + """Save the current in-memory state.""" + self._ensure_have_load_only() + + for fname, parser in self._modified_parsers: + logger.info("Writing to %s", fname) + + # Ensure directory exists. + ensure_dir(os.path.dirname(fname)) + + # Ensure directory's permission(need to be writeable) + try: + with open(fname, "w") as f: + parser.write(f) + except OSError as error: + raise ConfigurationError( + f"An error occurred while writing to the configuration file " + f"{fname}: {error}" + ) + + # + # Private routines + # + + def _ensure_have_load_only(self) -> None: + if self.load_only is None: + raise ConfigurationError("Needed a specific file to be modifying.") + logger.debug("Will be working with %s variant only", self.load_only) + + @property + def _dictionary(self) -> Dict[str, Any]: + """A dictionary representing the loaded configuration.""" + # NOTE: Dictionaries are not populated if not loaded. So, conditionals + # are not needed here. + retval = {} + + for variant in OVERRIDE_ORDER: + retval.update(self._config[variant]) + + return retval + + def _load_config_files(self) -> None: + """Loads configuration from configuration files""" + config_files = dict(self.iter_config_files()) + if config_files[kinds.ENV][0:1] == [os.devnull]: + logger.debug( + "Skipping loading configuration files due to " + "environment's PIP_CONFIG_FILE being os.devnull" + ) + return + + for variant, files in config_files.items(): + for fname in files: + # If there's specific variant set in `load_only`, load only + # that variant, not the others. + if self.load_only is not None and variant != self.load_only: + logger.debug("Skipping file '%s' (variant: %s)", fname, variant) + continue + + parser = self._load_file(variant, fname) + + # Keeping track of the parsers used + self._parsers[variant].append((fname, parser)) + + def _load_file(self, variant: Kind, fname: str) -> RawConfigParser: + logger.verbose("For variant '%s', will try loading '%s'", variant, fname) + parser = self._construct_parser(fname) + + for section in parser.sections(): + items = parser.items(section) + self._config[variant].update(self._normalized_keys(section, items)) + + return parser + + def _construct_parser(self, fname: str) -> RawConfigParser: + parser = configparser.RawConfigParser() + # If there is no such file, don't bother reading it but create the + # parser anyway, to hold the data. + # Doing this is useful when modifying and saving files, where we don't + # need to construct a parser. + if os.path.exists(fname): + locale_encoding = locale.getpreferredencoding(False) + try: + parser.read(fname, encoding=locale_encoding) + except UnicodeDecodeError: + # See https://github.com/pypa/pip/issues/4963 + raise ConfigurationFileCouldNotBeLoaded( + reason=f"contains invalid {locale_encoding} characters", + fname=fname, + ) + except configparser.Error as error: + # See https://github.com/pypa/pip/issues/4893 + raise ConfigurationFileCouldNotBeLoaded(error=error) + return parser + + def _load_environment_vars(self) -> None: + """Loads configuration from environment variables""" + self._config[kinds.ENV_VAR].update( + self._normalized_keys(":env:", self.get_environ_vars()) + ) + + def _normalized_keys( + self, section: str, items: Iterable[Tuple[str, Any]] + ) -> Dict[str, Any]: + """Normalizes items to construct a dictionary with normalized keys. + + This routine is where the names become keys and are made the same + regardless of source - configuration files or environment. + """ + normalized = {} + for name, val in items: + key = section + "." + _normalize_name(name) + normalized[key] = val + return normalized + + def get_environ_vars(self) -> Iterable[Tuple[str, str]]: + """Returns a generator with all environmental vars with prefix PIP_""" + for key, val in os.environ.items(): + if key.startswith("PIP_"): + name = key[4:].lower() + if name not in ENV_NAMES_IGNORED: + yield name, val + + # XXX: This is patched in the tests. + def iter_config_files(self) -> Iterable[Tuple[Kind, List[str]]]: + """Yields variant and configuration files associated with it. + + This should be treated like items of a dictionary. The order + here doesn't affect what gets overridden. That is controlled + by OVERRIDE_ORDER. However this does control the order they are + displayed to the user. It's probably most ergonomic to display + things in the same order as OVERRIDE_ORDER + """ + # SMELL: Move the conditions out of this function + + env_config_file = os.environ.get("PIP_CONFIG_FILE", None) + config_files = get_configuration_files() + + yield kinds.GLOBAL, config_files[kinds.GLOBAL] + + # per-user config is not loaded when env_config_file exists + should_load_user_config = not self.isolated and not ( + env_config_file and os.path.exists(env_config_file) + ) + if should_load_user_config: + # The legacy config file is overridden by the new config file + yield kinds.USER, config_files[kinds.USER] + + # virtualenv config + yield kinds.SITE, config_files[kinds.SITE] + + if env_config_file is not None: + yield kinds.ENV, [env_config_file] + else: + yield kinds.ENV, [] + + def get_values_in_config(self, variant: Kind) -> Dict[str, Any]: + """Get values present in a config file""" + return self._config[variant] + + def _get_parser_to_modify(self) -> Tuple[str, RawConfigParser]: + # Determine which parser to modify + assert self.load_only + parsers = self._parsers[self.load_only] + if not parsers: + # This should not happen if everything works correctly. + raise ConfigurationError( + "Fatal Internal error [id=2]. Please report as a bug." + ) + + # Use the highest priority parser. + return parsers[-1] + + # XXX: This is patched in the tests. + def _mark_as_modified(self, fname: str, parser: RawConfigParser) -> None: + file_parser_tuple = (fname, parser) + if file_parser_tuple not in self._modified_parsers: + self._modified_parsers.append(file_parser_tuple) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self._dictionary!r})" diff --git a/env/lib/python3.12/site-packages/pip/_internal/distributions/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/distributions/__init__.py new file mode 100644 index 0000000..9a89a83 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/distributions/__init__.py @@ -0,0 +1,21 @@ +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.distributions.sdist import SourceDistribution +from pip._internal.distributions.wheel import WheelDistribution +from pip._internal.req.req_install import InstallRequirement + + +def make_distribution_for_install_requirement( + install_req: InstallRequirement, +) -> AbstractDistribution: + """Returns a Distribution for the given InstallRequirement""" + # Editable requirements will always be source distributions. They use the + # legacy logic until we create a modern standard for them. + if install_req.editable: + return SourceDistribution(install_req) + + # If it's a wheel, it's a WheelDistribution + if install_req.is_wheel: + return WheelDistribution(install_req) + + # Otherwise, a SourceDistribution + return SourceDistribution(install_req) diff --git a/env/lib/python3.12/site-packages/pip/_internal/distributions/base.py b/env/lib/python3.12/site-packages/pip/_internal/distributions/base.py new file mode 100644 index 0000000..6e4d0c9 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/distributions/base.py @@ -0,0 +1,53 @@ +import abc +from typing import TYPE_CHECKING, Optional + +from pip._internal.metadata.base import BaseDistribution +from pip._internal.req import InstallRequirement + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + + +class AbstractDistribution(metaclass=abc.ABCMeta): + """A base class for handling installable artifacts. + + The requirements for anything installable are as follows: + + - we must be able to determine the requirement name + (or we can't correctly handle the non-upgrade case). + + - for packages with setup requirements, we must also be able + to determine their requirements without installing additional + packages (for the same reason as run-time dependencies) + + - we must be able to create a Distribution object exposing the + above metadata. + + - if we need to do work in the build tracker, we must be able to generate a unique + string to identify the requirement in the build tracker. + """ + + def __init__(self, req: InstallRequirement) -> None: + super().__init__() + self.req = req + + @abc.abstractproperty + def build_tracker_id(self) -> Optional[str]: + """A string that uniquely identifies this requirement to the build tracker. + + If None, then this dist has no work to do in the build tracker, and + ``.prepare_distribution_metadata()`` will not be called.""" + raise NotImplementedError() + + @abc.abstractmethod + def get_metadata_distribution(self) -> BaseDistribution: + raise NotImplementedError() + + @abc.abstractmethod + def prepare_distribution_metadata( + self, + finder: "PackageFinder", + build_isolation: bool, + check_build_deps: bool, + ) -> None: + raise NotImplementedError() diff --git a/env/lib/python3.12/site-packages/pip/_internal/distributions/installed.py b/env/lib/python3.12/site-packages/pip/_internal/distributions/installed.py new file mode 100644 index 0000000..ab8d53b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/distributions/installed.py @@ -0,0 +1,29 @@ +from typing import Optional + +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import BaseDistribution + + +class InstalledDistribution(AbstractDistribution): + """Represents an installed package. + + This does not need any preparation as the required information has already + been computed. + """ + + @property + def build_tracker_id(self) -> Optional[str]: + return None + + def get_metadata_distribution(self) -> BaseDistribution: + assert self.req.satisfied_by is not None, "not actually installed" + return self.req.satisfied_by + + def prepare_distribution_metadata( + self, + finder: PackageFinder, + build_isolation: bool, + check_build_deps: bool, + ) -> None: + pass diff --git a/env/lib/python3.12/site-packages/pip/_internal/distributions/sdist.py b/env/lib/python3.12/site-packages/pip/_internal/distributions/sdist.py new file mode 100644 index 0000000..28ea5ce --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/distributions/sdist.py @@ -0,0 +1,158 @@ +import logging +from typing import TYPE_CHECKING, Iterable, Optional, Set, Tuple + +from pip._internal.build_env import BuildEnvironment +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.exceptions import InstallationError +from pip._internal.metadata import BaseDistribution +from pip._internal.utils.subprocess import runner_with_spinner_message + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + +logger = logging.getLogger(__name__) + + +class SourceDistribution(AbstractDistribution): + """Represents a source distribution. + + The preparation step for these needs metadata for the packages to be + generated, either using PEP 517 or using the legacy `setup.py egg_info`. + """ + + @property + def build_tracker_id(self) -> Optional[str]: + """Identify this requirement uniquely by its link.""" + assert self.req.link + return self.req.link.url_without_fragment + + def get_metadata_distribution(self) -> BaseDistribution: + return self.req.get_dist() + + def prepare_distribution_metadata( + self, + finder: "PackageFinder", + build_isolation: bool, + check_build_deps: bool, + ) -> None: + # Load pyproject.toml, to determine whether PEP 517 is to be used + self.req.load_pyproject_toml() + + # Set up the build isolation, if this requirement should be isolated + should_isolate = self.req.use_pep517 and build_isolation + if should_isolate: + # Setup an isolated environment and install the build backend static + # requirements in it. + self._prepare_build_backend(finder) + # Check that if the requirement is editable, it either supports PEP 660 or + # has a setup.py or a setup.cfg. This cannot be done earlier because we need + # to setup the build backend to verify it supports build_editable, nor can + # it be done later, because we want to avoid installing build requirements + # needlessly. Doing it here also works around setuptools generating + # UNKNOWN.egg-info when running get_requires_for_build_wheel on a directory + # without setup.py nor setup.cfg. + self.req.isolated_editable_sanity_check() + # Install the dynamic build requirements. + self._install_build_reqs(finder) + # Check if the current environment provides build dependencies + should_check_deps = self.req.use_pep517 and check_build_deps + if should_check_deps: + pyproject_requires = self.req.pyproject_requires + assert pyproject_requires is not None + conflicting, missing = self.req.build_env.check_requirements( + pyproject_requires + ) + if conflicting: + self._raise_conflicts("the backend dependencies", conflicting) + if missing: + self._raise_missing_reqs(missing) + self.req.prepare_metadata() + + def _prepare_build_backend(self, finder: "PackageFinder") -> None: + # Isolate in a BuildEnvironment and install the build-time + # requirements. + pyproject_requires = self.req.pyproject_requires + assert pyproject_requires is not None + + self.req.build_env = BuildEnvironment() + self.req.build_env.install_requirements( + finder, pyproject_requires, "overlay", kind="build dependencies" + ) + conflicting, missing = self.req.build_env.check_requirements( + self.req.requirements_to_check + ) + if conflicting: + self._raise_conflicts("PEP 517/518 supported requirements", conflicting) + if missing: + logger.warning( + "Missing build requirements in pyproject.toml for %s.", + self.req, + ) + logger.warning( + "The project does not specify a build backend, and " + "pip cannot fall back to setuptools without %s.", + " and ".join(map(repr, sorted(missing))), + ) + + def _get_build_requires_wheel(self) -> Iterable[str]: + with self.req.build_env: + runner = runner_with_spinner_message("Getting requirements to build wheel") + backend = self.req.pep517_backend + assert backend is not None + with backend.subprocess_runner(runner): + return backend.get_requires_for_build_wheel() + + def _get_build_requires_editable(self) -> Iterable[str]: + with self.req.build_env: + runner = runner_with_spinner_message( + "Getting requirements to build editable" + ) + backend = self.req.pep517_backend + assert backend is not None + with backend.subprocess_runner(runner): + return backend.get_requires_for_build_editable() + + def _install_build_reqs(self, finder: "PackageFinder") -> None: + # Install any extra build dependencies that the backend requests. + # This must be done in a second pass, as the pyproject.toml + # dependencies must be installed before we can call the backend. + if ( + self.req.editable + and self.req.permit_editable_wheels + and self.req.supports_pyproject_editable + ): + build_reqs = self._get_build_requires_editable() + else: + build_reqs = self._get_build_requires_wheel() + conflicting, missing = self.req.build_env.check_requirements(build_reqs) + if conflicting: + self._raise_conflicts("the backend dependencies", conflicting) + self.req.build_env.install_requirements( + finder, missing, "normal", kind="backend dependencies" + ) + + def _raise_conflicts( + self, conflicting_with: str, conflicting_reqs: Set[Tuple[str, str]] + ) -> None: + format_string = ( + "Some build dependencies for {requirement} " + "conflict with {conflicting_with}: {description}." + ) + error_message = format_string.format( + requirement=self.req, + conflicting_with=conflicting_with, + description=", ".join( + f"{installed} is incompatible with {wanted}" + for installed, wanted in sorted(conflicting_reqs) + ), + ) + raise InstallationError(error_message) + + def _raise_missing_reqs(self, missing: Set[str]) -> None: + format_string = ( + "Some build dependencies for {requirement} are missing: {missing}." + ) + error_message = format_string.format( + requirement=self.req, missing=", ".join(map(repr, sorted(missing))) + ) + raise InstallationError(error_message) diff --git a/env/lib/python3.12/site-packages/pip/_internal/distributions/wheel.py b/env/lib/python3.12/site-packages/pip/_internal/distributions/wheel.py new file mode 100644 index 0000000..bfadd39 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/distributions/wheel.py @@ -0,0 +1,42 @@ +from typing import TYPE_CHECKING, Optional + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.metadata import ( + BaseDistribution, + FilesystemWheel, + get_wheel_distribution, +) + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + + +class WheelDistribution(AbstractDistribution): + """Represents a wheel distribution. + + This does not need any preparation as wheels can be directly unpacked. + """ + + @property + def build_tracker_id(self) -> Optional[str]: + return None + + def get_metadata_distribution(self) -> BaseDistribution: + """Loads the metadata from the wheel file into memory and returns a + Distribution that uses it, not relying on the wheel file or + requirement. + """ + assert self.req.local_file_path, "Set as part of preparation during download" + assert self.req.name, "Wheels are never unnamed" + wheel = FilesystemWheel(self.req.local_file_path) + return get_wheel_distribution(wheel, canonicalize_name(self.req.name)) + + def prepare_distribution_metadata( + self, + finder: "PackageFinder", + build_isolation: bool, + check_build_deps: bool, + ) -> None: + pass diff --git a/env/lib/python3.12/site-packages/pip/_internal/exceptions.py b/env/lib/python3.12/site-packages/pip/_internal/exceptions.py new file mode 100644 index 0000000..45a876a --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/exceptions.py @@ -0,0 +1,809 @@ +"""Exceptions used throughout package. + +This module MUST NOT try to import from anything within `pip._internal` to +operate. This is expected to be importable from any/all files within the +subpackage and, thus, should not depend on them. +""" + +import configparser +import contextlib +import locale +import logging +import pathlib +import re +import sys +from itertools import chain, groupby, repeat +from typing import TYPE_CHECKING, Dict, Iterator, List, Literal, Optional, Union + +from pip._vendor.packaging.requirements import InvalidRequirement +from pip._vendor.packaging.version import InvalidVersion +from pip._vendor.rich.console import Console, ConsoleOptions, RenderResult +from pip._vendor.rich.markup import escape +from pip._vendor.rich.text import Text + +if TYPE_CHECKING: + from hashlib import _Hash + + from pip._vendor.requests.models import Request, Response + + from pip._internal.metadata import BaseDistribution + from pip._internal.req.req_install import InstallRequirement + +logger = logging.getLogger(__name__) + + +# +# Scaffolding +# +def _is_kebab_case(s: str) -> bool: + return re.match(r"^[a-z]+(-[a-z]+)*$", s) is not None + + +def _prefix_with_indent( + s: Union[Text, str], + console: Console, + *, + prefix: str, + indent: str, +) -> Text: + if isinstance(s, Text): + text = s + else: + text = console.render_str(s) + + return console.render_str(prefix, overflow="ignore") + console.render_str( + f"\n{indent}", overflow="ignore" + ).join(text.split(allow_blank=True)) + + +class PipError(Exception): + """The base pip error.""" + + +class DiagnosticPipError(PipError): + """An error, that presents diagnostic information to the user. + + This contains a bunch of logic, to enable pretty presentation of our error + messages. Each error gets a unique reference. Each error can also include + additional context, a hint and/or a note -- which are presented with the + main error message in a consistent style. + + This is adapted from the error output styling in `sphinx-theme-builder`. + """ + + reference: str + + def __init__( + self, + *, + kind: 'Literal["error", "warning"]' = "error", + reference: Optional[str] = None, + message: Union[str, Text], + context: Optional[Union[str, Text]], + hint_stmt: Optional[Union[str, Text]], + note_stmt: Optional[Union[str, Text]] = None, + link: Optional[str] = None, + ) -> None: + # Ensure a proper reference is provided. + if reference is None: + assert hasattr(self, "reference"), "error reference not provided!" + reference = self.reference + assert _is_kebab_case(reference), "error reference must be kebab-case!" + + self.kind = kind + self.reference = reference + + self.message = message + self.context = context + + self.note_stmt = note_stmt + self.hint_stmt = hint_stmt + + self.link = link + + super().__init__(f"<{self.__class__.__name__}: {self.reference}>") + + def __repr__(self) -> str: + return ( + f"<{self.__class__.__name__}(" + f"reference={self.reference!r}, " + f"message={self.message!r}, " + f"context={self.context!r}, " + f"note_stmt={self.note_stmt!r}, " + f"hint_stmt={self.hint_stmt!r}" + ")>" + ) + + def __rich_console__( + self, + console: Console, + options: ConsoleOptions, + ) -> RenderResult: + colour = "red" if self.kind == "error" else "yellow" + + yield f"[{colour} bold]{self.kind}[/]: [bold]{self.reference}[/]" + yield "" + + if not options.ascii_only: + # Present the main message, with relevant context indented. + if self.context is not None: + yield _prefix_with_indent( + self.message, + console, + prefix=f"[{colour}]×[/] ", + indent=f"[{colour}]│[/] ", + ) + yield _prefix_with_indent( + self.context, + console, + prefix=f"[{colour}]╰─>[/] ", + indent=f"[{colour}] [/] ", + ) + else: + yield _prefix_with_indent( + self.message, + console, + prefix="[red]×[/] ", + indent=" ", + ) + else: + yield self.message + if self.context is not None: + yield "" + yield self.context + + if self.note_stmt is not None or self.hint_stmt is not None: + yield "" + + if self.note_stmt is not None: + yield _prefix_with_indent( + self.note_stmt, + console, + prefix="[magenta bold]note[/]: ", + indent=" ", + ) + if self.hint_stmt is not None: + yield _prefix_with_indent( + self.hint_stmt, + console, + prefix="[cyan bold]hint[/]: ", + indent=" ", + ) + + if self.link is not None: + yield "" + yield f"Link: {self.link}" + + +# +# Actual Errors +# +class ConfigurationError(PipError): + """General exception in configuration""" + + +class InstallationError(PipError): + """General exception during installation""" + + +class MissingPyProjectBuildRequires(DiagnosticPipError): + """Raised when pyproject.toml has `build-system`, but no `build-system.requires`.""" + + reference = "missing-pyproject-build-system-requires" + + def __init__(self, *, package: str) -> None: + super().__init__( + message=f"Can not process {escape(package)}", + context=Text( + "This package has an invalid pyproject.toml file.\n" + "The [build-system] table is missing the mandatory `requires` key." + ), + note_stmt="This is an issue with the package mentioned above, not pip.", + hint_stmt=Text("See PEP 518 for the detailed specification."), + ) + + +class InvalidPyProjectBuildRequires(DiagnosticPipError): + """Raised when pyproject.toml an invalid `build-system.requires`.""" + + reference = "invalid-pyproject-build-system-requires" + + def __init__(self, *, package: str, reason: str) -> None: + super().__init__( + message=f"Can not process {escape(package)}", + context=Text( + "This package has an invalid `build-system.requires` key in " + f"pyproject.toml.\n{reason}" + ), + note_stmt="This is an issue with the package mentioned above, not pip.", + hint_stmt=Text("See PEP 518 for the detailed specification."), + ) + + +class NoneMetadataError(PipError): + """Raised when accessing a Distribution's "METADATA" or "PKG-INFO". + + This signifies an inconsistency, when the Distribution claims to have + the metadata file (if not, raise ``FileNotFoundError`` instead), but is + not actually able to produce its content. This may be due to permission + errors. + """ + + def __init__( + self, + dist: "BaseDistribution", + metadata_name: str, + ) -> None: + """ + :param dist: A Distribution object. + :param metadata_name: The name of the metadata being accessed + (can be "METADATA" or "PKG-INFO"). + """ + self.dist = dist + self.metadata_name = metadata_name + + def __str__(self) -> str: + # Use `dist` in the error message because its stringification + # includes more information, like the version and location. + return f"None {self.metadata_name} metadata found for distribution: {self.dist}" + + +class UserInstallationInvalid(InstallationError): + """A --user install is requested on an environment without user site.""" + + def __str__(self) -> str: + return "User base directory is not specified" + + +class InvalidSchemeCombination(InstallationError): + def __str__(self) -> str: + before = ", ".join(str(a) for a in self.args[:-1]) + return f"Cannot set {before} and {self.args[-1]} together" + + +class DistributionNotFound(InstallationError): + """Raised when a distribution cannot be found to satisfy a requirement""" + + +class RequirementsFileParseError(InstallationError): + """Raised when a general error occurs parsing a requirements file line.""" + + +class BestVersionAlreadyInstalled(PipError): + """Raised when the most up-to-date version of a package is already + installed.""" + + +class BadCommand(PipError): + """Raised when virtualenv or a command is not found""" + + +class CommandError(PipError): + """Raised when there is an error in command-line arguments""" + + +class PreviousBuildDirError(PipError): + """Raised when there's a previous conflicting build directory""" + + +class NetworkConnectionError(PipError): + """HTTP connection error""" + + def __init__( + self, + error_msg: str, + response: Optional["Response"] = None, + request: Optional["Request"] = None, + ) -> None: + """ + Initialize NetworkConnectionError with `request` and `response` + objects. + """ + self.response = response + self.request = request + self.error_msg = error_msg + if ( + self.response is not None + and not self.request + and hasattr(response, "request") + ): + self.request = self.response.request + super().__init__(error_msg, response, request) + + def __str__(self) -> str: + return str(self.error_msg) + + +class InvalidWheelFilename(InstallationError): + """Invalid wheel filename.""" + + +class UnsupportedWheel(InstallationError): + """Unsupported wheel.""" + + +class InvalidWheel(InstallationError): + """Invalid (e.g. corrupt) wheel.""" + + def __init__(self, location: str, name: str): + self.location = location + self.name = name + + def __str__(self) -> str: + return f"Wheel '{self.name}' located at {self.location} is invalid." + + +class MetadataInconsistent(InstallationError): + """Built metadata contains inconsistent information. + + This is raised when the metadata contains values (e.g. name and version) + that do not match the information previously obtained from sdist filename, + user-supplied ``#egg=`` value, or an install requirement name. + """ + + def __init__( + self, ireq: "InstallRequirement", field: str, f_val: str, m_val: str + ) -> None: + self.ireq = ireq + self.field = field + self.f_val = f_val + self.m_val = m_val + + def __str__(self) -> str: + return ( + f"Requested {self.ireq} has inconsistent {self.field}: " + f"expected {self.f_val!r}, but metadata has {self.m_val!r}" + ) + + +class MetadataInvalid(InstallationError): + """Metadata is invalid.""" + + def __init__(self, ireq: "InstallRequirement", error: str) -> None: + self.ireq = ireq + self.error = error + + def __str__(self) -> str: + return f"Requested {self.ireq} has invalid metadata: {self.error}" + + +class InstallationSubprocessError(DiagnosticPipError, InstallationError): + """A subprocess call failed.""" + + reference = "subprocess-exited-with-error" + + def __init__( + self, + *, + command_description: str, + exit_code: int, + output_lines: Optional[List[str]], + ) -> None: + if output_lines is None: + output_prompt = Text("See above for output.") + else: + output_prompt = ( + Text.from_markup(f"[red][{len(output_lines)} lines of output][/]\n") + + Text("".join(output_lines)) + + Text.from_markup(R"[red]\[end of output][/]") + ) + + super().__init__( + message=( + f"[green]{escape(command_description)}[/] did not run successfully.\n" + f"exit code: {exit_code}" + ), + context=output_prompt, + hint_stmt=None, + note_stmt=( + "This error originates from a subprocess, and is likely not a " + "problem with pip." + ), + ) + + self.command_description = command_description + self.exit_code = exit_code + + def __str__(self) -> str: + return f"{self.command_description} exited with {self.exit_code}" + + +class MetadataGenerationFailed(InstallationSubprocessError, InstallationError): + reference = "metadata-generation-failed" + + def __init__( + self, + *, + package_details: str, + ) -> None: + super(InstallationSubprocessError, self).__init__( + message="Encountered error while generating package metadata.", + context=escape(package_details), + hint_stmt="See above for details.", + note_stmt="This is an issue with the package mentioned above, not pip.", + ) + + def __str__(self) -> str: + return "metadata generation failed" + + +class HashErrors(InstallationError): + """Multiple HashError instances rolled into one for reporting""" + + def __init__(self) -> None: + self.errors: List[HashError] = [] + + def append(self, error: "HashError") -> None: + self.errors.append(error) + + def __str__(self) -> str: + lines = [] + self.errors.sort(key=lambda e: e.order) + for cls, errors_of_cls in groupby(self.errors, lambda e: e.__class__): + lines.append(cls.head) + lines.extend(e.body() for e in errors_of_cls) + if lines: + return "\n".join(lines) + return "" + + def __bool__(self) -> bool: + return bool(self.errors) + + +class HashError(InstallationError): + """ + A failure to verify a package against known-good hashes + + :cvar order: An int sorting hash exception classes by difficulty of + recovery (lower being harder), so the user doesn't bother fretting + about unpinned packages when he has deeper issues, like VCS + dependencies, to deal with. Also keeps error reports in a + deterministic order. + :cvar head: A section heading for display above potentially many + exceptions of this kind + :ivar req: The InstallRequirement that triggered this error. This is + pasted on after the exception is instantiated, because it's not + typically available earlier. + + """ + + req: Optional["InstallRequirement"] = None + head = "" + order: int = -1 + + def body(self) -> str: + """Return a summary of me for display under the heading. + + This default implementation simply prints a description of the + triggering requirement. + + :param req: The InstallRequirement that provoked this error, with + its link already populated by the resolver's _populate_link(). + + """ + return f" {self._requirement_name()}" + + def __str__(self) -> str: + return f"{self.head}\n{self.body()}" + + def _requirement_name(self) -> str: + """Return a description of the requirement that triggered me. + + This default implementation returns long description of the req, with + line numbers + + """ + return str(self.req) if self.req else "unknown package" + + +class VcsHashUnsupported(HashError): + """A hash was provided for a version-control-system-based requirement, but + we don't have a method for hashing those.""" + + order = 0 + head = ( + "Can't verify hashes for these requirements because we don't " + "have a way to hash version control repositories:" + ) + + +class DirectoryUrlHashUnsupported(HashError): + """A hash was provided for a version-control-system-based requirement, but + we don't have a method for hashing those.""" + + order = 1 + head = ( + "Can't verify hashes for these file:// requirements because they " + "point to directories:" + ) + + +class HashMissing(HashError): + """A hash was needed for a requirement but is absent.""" + + order = 2 + head = ( + "Hashes are required in --require-hashes mode, but they are " + "missing from some requirements. Here is a list of those " + "requirements along with the hashes their downloaded archives " + "actually had. Add lines like these to your requirements files to " + "prevent tampering. (If you did not enable --require-hashes " + "manually, note that it turns on automatically when any package " + "has a hash.)" + ) + + def __init__(self, gotten_hash: str) -> None: + """ + :param gotten_hash: The hash of the (possibly malicious) archive we + just downloaded + """ + self.gotten_hash = gotten_hash + + def body(self) -> str: + # Dodge circular import. + from pip._internal.utils.hashes import FAVORITE_HASH + + package = None + if self.req: + # In the case of URL-based requirements, display the original URL + # seen in the requirements file rather than the package name, + # so the output can be directly copied into the requirements file. + package = ( + self.req.original_link + if self.req.is_direct + # In case someone feeds something downright stupid + # to InstallRequirement's constructor. + else getattr(self.req, "req", None) + ) + return " {} --hash={}:{}".format( + package or "unknown package", FAVORITE_HASH, self.gotten_hash + ) + + +class HashUnpinned(HashError): + """A requirement had a hash specified but was not pinned to a specific + version.""" + + order = 3 + head = ( + "In --require-hashes mode, all requirements must have their " + "versions pinned with ==. These do not:" + ) + + +class HashMismatch(HashError): + """ + Distribution file hash values don't match. + + :ivar package_name: The name of the package that triggered the hash + mismatch. Feel free to write to this after the exception is raise to + improve its error message. + + """ + + order = 4 + head = ( + "THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS " + "FILE. If you have updated the package versions, please update " + "the hashes. Otherwise, examine the package contents carefully; " + "someone may have tampered with them." + ) + + def __init__(self, allowed: Dict[str, List[str]], gots: Dict[str, "_Hash"]) -> None: + """ + :param allowed: A dict of algorithm names pointing to lists of allowed + hex digests + :param gots: A dict of algorithm names pointing to hashes we + actually got from the files under suspicion + """ + self.allowed = allowed + self.gots = gots + + def body(self) -> str: + return f" {self._requirement_name()}:\n{self._hash_comparison()}" + + def _hash_comparison(self) -> str: + """ + Return a comparison of actual and expected hash values. + + Example:: + + Expected sha256 abcdeabcdeabcdeabcdeabcdeabcdeabcdeabcdeabcde + or 123451234512345123451234512345123451234512345 + Got bcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdef + + """ + + def hash_then_or(hash_name: str) -> "chain[str]": + # For now, all the decent hashes have 6-char names, so we can get + # away with hard-coding space literals. + return chain([hash_name], repeat(" or")) + + lines: List[str] = [] + for hash_name, expecteds in self.allowed.items(): + prefix = hash_then_or(hash_name) + lines.extend((f" Expected {next(prefix)} {e}") for e in expecteds) + lines.append( + f" Got {self.gots[hash_name].hexdigest()}\n" + ) + return "\n".join(lines) + + +class UnsupportedPythonVersion(InstallationError): + """Unsupported python version according to Requires-Python package + metadata.""" + + +class ConfigurationFileCouldNotBeLoaded(ConfigurationError): + """When there are errors while loading a configuration file""" + + def __init__( + self, + reason: str = "could not be loaded", + fname: Optional[str] = None, + error: Optional[configparser.Error] = None, + ) -> None: + super().__init__(error) + self.reason = reason + self.fname = fname + self.error = error + + def __str__(self) -> str: + if self.fname is not None: + message_part = f" in {self.fname}." + else: + assert self.error is not None + message_part = f".\n{self.error}\n" + return f"Configuration file {self.reason}{message_part}" + + +_DEFAULT_EXTERNALLY_MANAGED_ERROR = f"""\ +The Python environment under {sys.prefix} is managed externally, and may not be +manipulated by the user. Please use specific tooling from the distributor of +the Python installation to interact with this environment instead. +""" + + +class ExternallyManagedEnvironment(DiagnosticPipError): + """The current environment is externally managed. + + This is raised when the current environment is externally managed, as + defined by `PEP 668`_. The ``EXTERNALLY-MANAGED`` configuration is checked + and displayed when the error is bubbled up to the user. + + :param error: The error message read from ``EXTERNALLY-MANAGED``. + """ + + reference = "externally-managed-environment" + + def __init__(self, error: Optional[str]) -> None: + if error is None: + context = Text(_DEFAULT_EXTERNALLY_MANAGED_ERROR) + else: + context = Text(error) + super().__init__( + message="This environment is externally managed", + context=context, + note_stmt=( + "If you believe this is a mistake, please contact your " + "Python installation or OS distribution provider. " + "You can override this, at the risk of breaking your Python " + "installation or OS, by passing --break-system-packages." + ), + hint_stmt=Text("See PEP 668 for the detailed specification."), + ) + + @staticmethod + def _iter_externally_managed_error_keys() -> Iterator[str]: + # LC_MESSAGES is in POSIX, but not the C standard. The most common + # platform that does not implement this category is Windows, where + # using other categories for console message localization is equally + # unreliable, so we fall back to the locale-less vendor message. This + # can always be re-evaluated when a vendor proposes a new alternative. + try: + category = locale.LC_MESSAGES + except AttributeError: + lang: Optional[str] = None + else: + lang, _ = locale.getlocale(category) + if lang is not None: + yield f"Error-{lang}" + for sep in ("-", "_"): + before, found, _ = lang.partition(sep) + if not found: + continue + yield f"Error-{before}" + yield "Error" + + @classmethod + def from_config( + cls, + config: Union[pathlib.Path, str], + ) -> "ExternallyManagedEnvironment": + parser = configparser.ConfigParser(interpolation=None) + try: + parser.read(config, encoding="utf-8") + section = parser["externally-managed"] + for key in cls._iter_externally_managed_error_keys(): + with contextlib.suppress(KeyError): + return cls(section[key]) + except KeyError: + pass + except (OSError, UnicodeDecodeError, configparser.ParsingError): + from pip._internal.utils._log import VERBOSE + + exc_info = logger.isEnabledFor(VERBOSE) + logger.warning("Failed to read %s", config, exc_info=exc_info) + return cls(None) + + +class UninstallMissingRecord(DiagnosticPipError): + reference = "uninstall-no-record-file" + + def __init__(self, *, distribution: "BaseDistribution") -> None: + installer = distribution.installer + if not installer or installer == "pip": + dep = f"{distribution.raw_name}=={distribution.version}" + hint = Text.assemble( + "You might be able to recover from this via: ", + (f"pip install --force-reinstall --no-deps {dep}", "green"), + ) + else: + hint = Text( + f"The package was installed by {installer}. " + "You should check if it can uninstall the package." + ) + + super().__init__( + message=Text(f"Cannot uninstall {distribution}"), + context=( + "The package's contents are unknown: " + f"no RECORD file was found for {distribution.raw_name}." + ), + hint_stmt=hint, + ) + + +class LegacyDistutilsInstall(DiagnosticPipError): + reference = "uninstall-distutils-installed-package" + + def __init__(self, *, distribution: "BaseDistribution") -> None: + super().__init__( + message=Text(f"Cannot uninstall {distribution}"), + context=( + "It is a distutils installed project and thus we cannot accurately " + "determine which files belong to it which would lead to only a partial " + "uninstall." + ), + hint_stmt=None, + ) + + +class InvalidInstalledPackage(DiagnosticPipError): + reference = "invalid-installed-package" + + def __init__( + self, + *, + dist: "BaseDistribution", + invalid_exc: Union[InvalidRequirement, InvalidVersion], + ) -> None: + installed_location = dist.installed_location + + if isinstance(invalid_exc, InvalidRequirement): + invalid_type = "requirement" + else: + invalid_type = "version" + + super().__init__( + message=Text( + f"Cannot process installed package {dist} " + + (f"in {installed_location!r} " if installed_location else "") + + f"because it has an invalid {invalid_type}:\n{invalid_exc.args[0]}" + ), + context=( + "Starting with pip 24.1, packages with invalid " + f"{invalid_type}s can not be processed." + ), + hint_stmt="To proceed this package must be uninstalled.", + ) diff --git a/env/lib/python3.12/site-packages/pip/_internal/index/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/index/__init__.py new file mode 100644 index 0000000..7a17b7b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/index/__init__.py @@ -0,0 +1,2 @@ +"""Index interaction code +""" diff --git a/env/lib/python3.12/site-packages/pip/_internal/index/collector.py b/env/lib/python3.12/site-packages/pip/_internal/index/collector.py new file mode 100644 index 0000000..5f8fdee --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/index/collector.py @@ -0,0 +1,494 @@ +""" +The main purpose of this module is to expose LinkCollector.collect_sources(). +""" + +import collections +import email.message +import functools +import itertools +import json +import logging +import os +import urllib.parse +import urllib.request +from dataclasses import dataclass +from html.parser import HTMLParser +from optparse import Values +from typing import ( + Callable, + Dict, + Iterable, + List, + MutableMapping, + NamedTuple, + Optional, + Protocol, + Sequence, + Tuple, + Union, +) + +from pip._vendor import requests +from pip._vendor.requests import Response +from pip._vendor.requests.exceptions import RetryError, SSLError + +from pip._internal.exceptions import NetworkConnectionError +from pip._internal.models.link import Link +from pip._internal.models.search_scope import SearchScope +from pip._internal.network.session import PipSession +from pip._internal.network.utils import raise_for_status +from pip._internal.utils.filetypes import is_archive_file +from pip._internal.utils.misc import redact_auth_from_url +from pip._internal.vcs import vcs + +from .sources import CandidatesFromPage, LinkSource, build_source + +logger = logging.getLogger(__name__) + +ResponseHeaders = MutableMapping[str, str] + + +def _match_vcs_scheme(url: str) -> Optional[str]: + """Look for VCS schemes in the URL. + + Returns the matched VCS scheme, or None if there's no match. + """ + for scheme in vcs.schemes: + if url.lower().startswith(scheme) and url[len(scheme)] in "+:": + return scheme + return None + + +class _NotAPIContent(Exception): + def __init__(self, content_type: str, request_desc: str) -> None: + super().__init__(content_type, request_desc) + self.content_type = content_type + self.request_desc = request_desc + + +def _ensure_api_header(response: Response) -> None: + """ + Check the Content-Type header to ensure the response contains a Simple + API Response. + + Raises `_NotAPIContent` if the content type is not a valid content-type. + """ + content_type = response.headers.get("Content-Type", "Unknown") + + content_type_l = content_type.lower() + if content_type_l.startswith( + ( + "text/html", + "application/vnd.pypi.simple.v1+html", + "application/vnd.pypi.simple.v1+json", + ) + ): + return + + raise _NotAPIContent(content_type, response.request.method) + + +class _NotHTTP(Exception): + pass + + +def _ensure_api_response(url: str, session: PipSession) -> None: + """ + Send a HEAD request to the URL, and ensure the response contains a simple + API Response. + + Raises `_NotHTTP` if the URL is not available for a HEAD request, or + `_NotAPIContent` if the content type is not a valid content type. + """ + scheme, netloc, path, query, fragment = urllib.parse.urlsplit(url) + if scheme not in {"http", "https"}: + raise _NotHTTP() + + resp = session.head(url, allow_redirects=True) + raise_for_status(resp) + + _ensure_api_header(resp) + + +def _get_simple_response(url: str, session: PipSession) -> Response: + """Access an Simple API response with GET, and return the response. + + This consists of three parts: + + 1. If the URL looks suspiciously like an archive, send a HEAD first to + check the Content-Type is HTML or Simple API, to avoid downloading a + large file. Raise `_NotHTTP` if the content type cannot be determined, or + `_NotAPIContent` if it is not HTML or a Simple API. + 2. Actually perform the request. Raise HTTP exceptions on network failures. + 3. Check the Content-Type header to make sure we got a Simple API response, + and raise `_NotAPIContent` otherwise. + """ + if is_archive_file(Link(url).filename): + _ensure_api_response(url, session=session) + + logger.debug("Getting page %s", redact_auth_from_url(url)) + + resp = session.get( + url, + headers={ + "Accept": ", ".join( + [ + "application/vnd.pypi.simple.v1+json", + "application/vnd.pypi.simple.v1+html; q=0.1", + "text/html; q=0.01", + ] + ), + # We don't want to blindly returned cached data for + # /simple/, because authors generally expecting that + # twine upload && pip install will function, but if + # they've done a pip install in the last ~10 minutes + # it won't. Thus by setting this to zero we will not + # blindly use any cached data, however the benefit of + # using max-age=0 instead of no-cache, is that we will + # still support conditional requests, so we will still + # minimize traffic sent in cases where the page hasn't + # changed at all, we will just always incur the round + # trip for the conditional GET now instead of only + # once per 10 minutes. + # For more information, please see pypa/pip#5670. + "Cache-Control": "max-age=0", + }, + ) + raise_for_status(resp) + + # The check for archives above only works if the url ends with + # something that looks like an archive. However that is not a + # requirement of an url. Unless we issue a HEAD request on every + # url we cannot know ahead of time for sure if something is a + # Simple API response or not. However we can check after we've + # downloaded it. + _ensure_api_header(resp) + + logger.debug( + "Fetched page %s as %s", + redact_auth_from_url(url), + resp.headers.get("Content-Type", "Unknown"), + ) + + return resp + + +def _get_encoding_from_headers(headers: ResponseHeaders) -> Optional[str]: + """Determine if we have any encoding information in our headers.""" + if headers and "Content-Type" in headers: + m = email.message.Message() + m["content-type"] = headers["Content-Type"] + charset = m.get_param("charset") + if charset: + return str(charset) + return None + + +class CacheablePageContent: + def __init__(self, page: "IndexContent") -> None: + assert page.cache_link_parsing + self.page = page + + def __eq__(self, other: object) -> bool: + return isinstance(other, type(self)) and self.page.url == other.page.url + + def __hash__(self) -> int: + return hash(self.page.url) + + +class ParseLinks(Protocol): + def __call__(self, page: "IndexContent") -> Iterable[Link]: ... + + +def with_cached_index_content(fn: ParseLinks) -> ParseLinks: + """ + Given a function that parses an Iterable[Link] from an IndexContent, cache the + function's result (keyed by CacheablePageContent), unless the IndexContent + `page` has `page.cache_link_parsing == False`. + """ + + @functools.lru_cache(maxsize=None) + def wrapper(cacheable_page: CacheablePageContent) -> List[Link]: + return list(fn(cacheable_page.page)) + + @functools.wraps(fn) + def wrapper_wrapper(page: "IndexContent") -> List[Link]: + if page.cache_link_parsing: + return wrapper(CacheablePageContent(page)) + return list(fn(page)) + + return wrapper_wrapper + + +@with_cached_index_content +def parse_links(page: "IndexContent") -> Iterable[Link]: + """ + Parse a Simple API's Index Content, and yield its anchor elements as Link objects. + """ + + content_type_l = page.content_type.lower() + if content_type_l.startswith("application/vnd.pypi.simple.v1+json"): + data = json.loads(page.content) + for file in data.get("files", []): + link = Link.from_json(file, page.url) + if link is None: + continue + yield link + return + + parser = HTMLLinkParser(page.url) + encoding = page.encoding or "utf-8" + parser.feed(page.content.decode(encoding)) + + url = page.url + base_url = parser.base_url or url + for anchor in parser.anchors: + link = Link.from_element(anchor, page_url=url, base_url=base_url) + if link is None: + continue + yield link + + +@dataclass(frozen=True) +class IndexContent: + """Represents one response (or page), along with its URL. + + :param encoding: the encoding to decode the given content. + :param url: the URL from which the HTML was downloaded. + :param cache_link_parsing: whether links parsed from this page's url + should be cached. PyPI index urls should + have this set to False, for example. + """ + + content: bytes + content_type: str + encoding: Optional[str] + url: str + cache_link_parsing: bool = True + + def __str__(self) -> str: + return redact_auth_from_url(self.url) + + +class HTMLLinkParser(HTMLParser): + """ + HTMLParser that keeps the first base HREF and a list of all anchor + elements' attributes. + """ + + def __init__(self, url: str) -> None: + super().__init__(convert_charrefs=True) + + self.url: str = url + self.base_url: Optional[str] = None + self.anchors: List[Dict[str, Optional[str]]] = [] + + def handle_starttag(self, tag: str, attrs: List[Tuple[str, Optional[str]]]) -> None: + if tag == "base" and self.base_url is None: + href = self.get_href(attrs) + if href is not None: + self.base_url = href + elif tag == "a": + self.anchors.append(dict(attrs)) + + def get_href(self, attrs: List[Tuple[str, Optional[str]]]) -> Optional[str]: + for name, value in attrs: + if name == "href": + return value + return None + + +def _handle_get_simple_fail( + link: Link, + reason: Union[str, Exception], + meth: Optional[Callable[..., None]] = None, +) -> None: + if meth is None: + meth = logger.debug + meth("Could not fetch URL %s: %s - skipping", link, reason) + + +def _make_index_content( + response: Response, cache_link_parsing: bool = True +) -> IndexContent: + encoding = _get_encoding_from_headers(response.headers) + return IndexContent( + response.content, + response.headers["Content-Type"], + encoding=encoding, + url=response.url, + cache_link_parsing=cache_link_parsing, + ) + + +def _get_index_content(link: Link, *, session: PipSession) -> Optional["IndexContent"]: + url = link.url.split("#", 1)[0] + + # Check for VCS schemes that do not support lookup as web pages. + vcs_scheme = _match_vcs_scheme(url) + if vcs_scheme: + logger.warning( + "Cannot look at %s URL %s because it does not support lookup as web pages.", + vcs_scheme, + link, + ) + return None + + # Tack index.html onto file:// URLs that point to directories + scheme, _, path, _, _, _ = urllib.parse.urlparse(url) + if scheme == "file" and os.path.isdir(urllib.request.url2pathname(path)): + # add trailing slash if not present so urljoin doesn't trim + # final segment + if not url.endswith("/"): + url += "/" + # TODO: In the future, it would be nice if pip supported PEP 691 + # style responses in the file:// URLs, however there's no + # standard file extension for application/vnd.pypi.simple.v1+json + # so we'll need to come up with something on our own. + url = urllib.parse.urljoin(url, "index.html") + logger.debug(" file: URL is directory, getting %s", url) + + try: + resp = _get_simple_response(url, session=session) + except _NotHTTP: + logger.warning( + "Skipping page %s because it looks like an archive, and cannot " + "be checked by a HTTP HEAD request.", + link, + ) + except _NotAPIContent as exc: + logger.warning( + "Skipping page %s because the %s request got Content-Type: %s. " + "The only supported Content-Types are application/vnd.pypi.simple.v1+json, " + "application/vnd.pypi.simple.v1+html, and text/html", + link, + exc.request_desc, + exc.content_type, + ) + except NetworkConnectionError as exc: + _handle_get_simple_fail(link, exc) + except RetryError as exc: + _handle_get_simple_fail(link, exc) + except SSLError as exc: + reason = "There was a problem confirming the ssl certificate: " + reason += str(exc) + _handle_get_simple_fail(link, reason, meth=logger.info) + except requests.ConnectionError as exc: + _handle_get_simple_fail(link, f"connection error: {exc}") + except requests.Timeout: + _handle_get_simple_fail(link, "timed out") + else: + return _make_index_content(resp, cache_link_parsing=link.cache_link_parsing) + return None + + +class CollectedSources(NamedTuple): + find_links: Sequence[Optional[LinkSource]] + index_urls: Sequence[Optional[LinkSource]] + + +class LinkCollector: + """ + Responsible for collecting Link objects from all configured locations, + making network requests as needed. + + The class's main method is its collect_sources() method. + """ + + def __init__( + self, + session: PipSession, + search_scope: SearchScope, + ) -> None: + self.search_scope = search_scope + self.session = session + + @classmethod + def create( + cls, + session: PipSession, + options: Values, + suppress_no_index: bool = False, + ) -> "LinkCollector": + """ + :param session: The Session to use to make requests. + :param suppress_no_index: Whether to ignore the --no-index option + when constructing the SearchScope object. + """ + index_urls = [options.index_url] + options.extra_index_urls + if options.no_index and not suppress_no_index: + logger.debug( + "Ignoring indexes: %s", + ",".join(redact_auth_from_url(url) for url in index_urls), + ) + index_urls = [] + + # Make sure find_links is a list before passing to create(). + find_links = options.find_links or [] + + search_scope = SearchScope.create( + find_links=find_links, + index_urls=index_urls, + no_index=options.no_index, + ) + link_collector = LinkCollector( + session=session, + search_scope=search_scope, + ) + return link_collector + + @property + def find_links(self) -> List[str]: + return self.search_scope.find_links + + def fetch_response(self, location: Link) -> Optional[IndexContent]: + """ + Fetch an HTML page containing package links. + """ + return _get_index_content(location, session=self.session) + + def collect_sources( + self, + project_name: str, + candidates_from_page: CandidatesFromPage, + ) -> CollectedSources: + # The OrderedDict calls deduplicate sources by URL. + index_url_sources = collections.OrderedDict( + build_source( + loc, + candidates_from_page=candidates_from_page, + page_validator=self.session.is_secure_origin, + expand_dir=False, + cache_link_parsing=False, + project_name=project_name, + ) + for loc in self.search_scope.get_index_urls_locations(project_name) + ).values() + find_links_sources = collections.OrderedDict( + build_source( + loc, + candidates_from_page=candidates_from_page, + page_validator=self.session.is_secure_origin, + expand_dir=True, + cache_link_parsing=True, + project_name=project_name, + ) + for loc in self.find_links + ).values() + + if logger.isEnabledFor(logging.DEBUG): + lines = [ + f"* {s.link}" + for s in itertools.chain(find_links_sources, index_url_sources) + if s is not None and s.link is not None + ] + lines = [ + f"{len(lines)} location(s) to search " + f"for versions of {project_name}:" + ] + lines + logger.debug("\n".join(lines)) + + return CollectedSources( + find_links=list(find_links_sources), + index_urls=list(index_url_sources), + ) diff --git a/env/lib/python3.12/site-packages/pip/_internal/index/package_finder.py b/env/lib/python3.12/site-packages/pip/_internal/index/package_finder.py new file mode 100644 index 0000000..85628ee --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/index/package_finder.py @@ -0,0 +1,1029 @@ +"""Routines related to PyPI, indexes""" + +import enum +import functools +import itertools +import logging +import re +from dataclasses import dataclass +from typing import TYPE_CHECKING, FrozenSet, Iterable, List, Optional, Set, Tuple, Union + +from pip._vendor.packaging import specifiers +from pip._vendor.packaging.tags import Tag +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.packaging.version import InvalidVersion, _BaseVersion +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.exceptions import ( + BestVersionAlreadyInstalled, + DistributionNotFound, + InvalidWheelFilename, + UnsupportedWheel, +) +from pip._internal.index.collector import LinkCollector, parse_links +from pip._internal.models.candidate import InstallationCandidate +from pip._internal.models.format_control import FormatControl +from pip._internal.models.link import Link +from pip._internal.models.search_scope import SearchScope +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.models.target_python import TargetPython +from pip._internal.models.wheel import Wheel +from pip._internal.req import InstallRequirement +from pip._internal.utils._log import getLogger +from pip._internal.utils.filetypes import WHEEL_EXTENSION +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import build_netloc +from pip._internal.utils.packaging import check_requires_python +from pip._internal.utils.unpacking import SUPPORTED_EXTENSIONS + +if TYPE_CHECKING: + from pip._vendor.typing_extensions import TypeGuard + +__all__ = ["FormatControl", "BestCandidateResult", "PackageFinder"] + + +logger = getLogger(__name__) + +BuildTag = Union[Tuple[()], Tuple[int, str]] +CandidateSortingKey = Tuple[int, int, int, _BaseVersion, Optional[int], BuildTag] + + +def _check_link_requires_python( + link: Link, + version_info: Tuple[int, int, int], + ignore_requires_python: bool = False, +) -> bool: + """ + Return whether the given Python version is compatible with a link's + "Requires-Python" value. + + :param version_info: A 3-tuple of ints representing the Python + major-minor-micro version to check. + :param ignore_requires_python: Whether to ignore the "Requires-Python" + value if the given Python version isn't compatible. + """ + try: + is_compatible = check_requires_python( + link.requires_python, + version_info=version_info, + ) + except specifiers.InvalidSpecifier: + logger.debug( + "Ignoring invalid Requires-Python (%r) for link: %s", + link.requires_python, + link, + ) + else: + if not is_compatible: + version = ".".join(map(str, version_info)) + if not ignore_requires_python: + logger.verbose( + "Link requires a different Python (%s not in: %r): %s", + version, + link.requires_python, + link, + ) + return False + + logger.debug( + "Ignoring failed Requires-Python check (%s not in: %r) for link: %s", + version, + link.requires_python, + link, + ) + + return True + + +class LinkType(enum.Enum): + candidate = enum.auto() + different_project = enum.auto() + yanked = enum.auto() + format_unsupported = enum.auto() + format_invalid = enum.auto() + platform_mismatch = enum.auto() + requires_python_mismatch = enum.auto() + + +class LinkEvaluator: + """ + Responsible for evaluating links for a particular project. + """ + + _py_version_re = re.compile(r"-py([123]\.?[0-9]?)$") + + # Don't include an allow_yanked default value to make sure each call + # site considers whether yanked releases are allowed. This also causes + # that decision to be made explicit in the calling code, which helps + # people when reading the code. + def __init__( + self, + project_name: str, + canonical_name: str, + formats: FrozenSet[str], + target_python: TargetPython, + allow_yanked: bool, + ignore_requires_python: Optional[bool] = None, + ) -> None: + """ + :param project_name: The user supplied package name. + :param canonical_name: The canonical package name. + :param formats: The formats allowed for this package. Should be a set + with 'binary' or 'source' or both in it. + :param target_python: The target Python interpreter to use when + evaluating link compatibility. This is used, for example, to + check wheel compatibility, as well as when checking the Python + version, e.g. the Python version embedded in a link filename + (or egg fragment) and against an HTML link's optional PEP 503 + "data-requires-python" attribute. + :param allow_yanked: Whether files marked as yanked (in the sense + of PEP 592) are permitted to be candidates for install. + :param ignore_requires_python: Whether to ignore incompatible + PEP 503 "data-requires-python" values in HTML links. Defaults + to False. + """ + if ignore_requires_python is None: + ignore_requires_python = False + + self._allow_yanked = allow_yanked + self._canonical_name = canonical_name + self._ignore_requires_python = ignore_requires_python + self._formats = formats + self._target_python = target_python + + self.project_name = project_name + + def evaluate_link(self, link: Link) -> Tuple[LinkType, str]: + """ + Determine whether a link is a candidate for installation. + + :return: A tuple (result, detail), where *result* is an enum + representing whether the evaluation found a candidate, or the reason + why one is not found. If a candidate is found, *detail* will be the + candidate's version string; if one is not found, it contains the + reason the link fails to qualify. + """ + version = None + if link.is_yanked and not self._allow_yanked: + reason = link.yanked_reason or "" + return (LinkType.yanked, f"yanked for reason: {reason}") + + if link.egg_fragment: + egg_info = link.egg_fragment + ext = link.ext + else: + egg_info, ext = link.splitext() + if not ext: + return (LinkType.format_unsupported, "not a file") + if ext not in SUPPORTED_EXTENSIONS: + return ( + LinkType.format_unsupported, + f"unsupported archive format: {ext}", + ) + if "binary" not in self._formats and ext == WHEEL_EXTENSION: + reason = f"No binaries permitted for {self.project_name}" + return (LinkType.format_unsupported, reason) + if "macosx10" in link.path and ext == ".zip": + return (LinkType.format_unsupported, "macosx10 one") + if ext == WHEEL_EXTENSION: + try: + wheel = Wheel(link.filename) + except InvalidWheelFilename: + return ( + LinkType.format_invalid, + "invalid wheel filename", + ) + if canonicalize_name(wheel.name) != self._canonical_name: + reason = f"wrong project name (not {self.project_name})" + return (LinkType.different_project, reason) + + supported_tags = self._target_python.get_unsorted_tags() + if not wheel.supported(supported_tags): + # Include the wheel's tags in the reason string to + # simplify troubleshooting compatibility issues. + file_tags = ", ".join(wheel.get_formatted_file_tags()) + reason = ( + f"none of the wheel's tags ({file_tags}) are compatible " + f"(run pip debug --verbose to show compatible tags)" + ) + return (LinkType.platform_mismatch, reason) + + version = wheel.version + + # This should be up by the self.ok_binary check, but see issue 2700. + if "source" not in self._formats and ext != WHEEL_EXTENSION: + reason = f"No sources permitted for {self.project_name}" + return (LinkType.format_unsupported, reason) + + if not version: + version = _extract_version_from_fragment( + egg_info, + self._canonical_name, + ) + if not version: + reason = f"Missing project version for {self.project_name}" + return (LinkType.format_invalid, reason) + + match = self._py_version_re.search(version) + if match: + version = version[: match.start()] + py_version = match.group(1) + if py_version != self._target_python.py_version: + return ( + LinkType.platform_mismatch, + "Python version is incorrect", + ) + + supports_python = _check_link_requires_python( + link, + version_info=self._target_python.py_version_info, + ignore_requires_python=self._ignore_requires_python, + ) + if not supports_python: + reason = f"{version} Requires-Python {link.requires_python}" + return (LinkType.requires_python_mismatch, reason) + + logger.debug("Found link %s, version: %s", link, version) + + return (LinkType.candidate, version) + + +def filter_unallowed_hashes( + candidates: List[InstallationCandidate], + hashes: Optional[Hashes], + project_name: str, +) -> List[InstallationCandidate]: + """ + Filter out candidates whose hashes aren't allowed, and return a new + list of candidates. + + If at least one candidate has an allowed hash, then all candidates with + either an allowed hash or no hash specified are returned. Otherwise, + the given candidates are returned. + + Including the candidates with no hash specified when there is a match + allows a warning to be logged if there is a more preferred candidate + with no hash specified. Returning all candidates in the case of no + matches lets pip report the hash of the candidate that would otherwise + have been installed (e.g. permitting the user to more easily update + their requirements file with the desired hash). + """ + if not hashes: + logger.debug( + "Given no hashes to check %s links for project %r: " + "discarding no candidates", + len(candidates), + project_name, + ) + # Make sure we're not returning back the given value. + return list(candidates) + + matches_or_no_digest = [] + # Collect the non-matches for logging purposes. + non_matches = [] + match_count = 0 + for candidate in candidates: + link = candidate.link + if not link.has_hash: + pass + elif link.is_hash_allowed(hashes=hashes): + match_count += 1 + else: + non_matches.append(candidate) + continue + + matches_or_no_digest.append(candidate) + + if match_count: + filtered = matches_or_no_digest + else: + # Make sure we're not returning back the given value. + filtered = list(candidates) + + if len(filtered) == len(candidates): + discard_message = "discarding no candidates" + else: + discard_message = "discarding {} non-matches:\n {}".format( + len(non_matches), + "\n ".join(str(candidate.link) for candidate in non_matches), + ) + + logger.debug( + "Checked %s links for project %r against %s hashes " + "(%s matches, %s no digest): %s", + len(candidates), + project_name, + hashes.digest_count, + match_count, + len(matches_or_no_digest) - match_count, + discard_message, + ) + + return filtered + + +@dataclass +class CandidatePreferences: + """ + Encapsulates some of the preferences for filtering and sorting + InstallationCandidate objects. + """ + + prefer_binary: bool = False + allow_all_prereleases: bool = False + + +@dataclass(frozen=True) +class BestCandidateResult: + """A collection of candidates, returned by `PackageFinder.find_best_candidate`. + + This class is only intended to be instantiated by CandidateEvaluator's + `compute_best_candidate()` method. + + :param all_candidates: A sequence of all available candidates found. + :param applicable_candidates: The applicable candidates. + :param best_candidate: The most preferred candidate found, or None + if no applicable candidates were found. + """ + + all_candidates: List[InstallationCandidate] + applicable_candidates: List[InstallationCandidate] + best_candidate: Optional[InstallationCandidate] + + def __post_init__(self) -> None: + assert set(self.applicable_candidates) <= set(self.all_candidates) + + if self.best_candidate is None: + assert not self.applicable_candidates + else: + assert self.best_candidate in self.applicable_candidates + + +class CandidateEvaluator: + """ + Responsible for filtering and sorting candidates for installation based + on what tags are valid. + """ + + @classmethod + def create( + cls, + project_name: str, + target_python: Optional[TargetPython] = None, + prefer_binary: bool = False, + allow_all_prereleases: bool = False, + specifier: Optional[specifiers.BaseSpecifier] = None, + hashes: Optional[Hashes] = None, + ) -> "CandidateEvaluator": + """Create a CandidateEvaluator object. + + :param target_python: The target Python interpreter to use when + checking compatibility. If None (the default), a TargetPython + object will be constructed from the running Python. + :param specifier: An optional object implementing `filter` + (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable + versions. + :param hashes: An optional collection of allowed hashes. + """ + if target_python is None: + target_python = TargetPython() + if specifier is None: + specifier = specifiers.SpecifierSet() + + supported_tags = target_python.get_sorted_tags() + + return cls( + project_name=project_name, + supported_tags=supported_tags, + specifier=specifier, + prefer_binary=prefer_binary, + allow_all_prereleases=allow_all_prereleases, + hashes=hashes, + ) + + def __init__( + self, + project_name: str, + supported_tags: List[Tag], + specifier: specifiers.BaseSpecifier, + prefer_binary: bool = False, + allow_all_prereleases: bool = False, + hashes: Optional[Hashes] = None, + ) -> None: + """ + :param supported_tags: The PEP 425 tags supported by the target + Python in order of preference (most preferred first). + """ + self._allow_all_prereleases = allow_all_prereleases + self._hashes = hashes + self._prefer_binary = prefer_binary + self._project_name = project_name + self._specifier = specifier + self._supported_tags = supported_tags + # Since the index of the tag in the _supported_tags list is used + # as a priority, precompute a map from tag to index/priority to be + # used in wheel.find_most_preferred_tag. + self._wheel_tag_preferences = { + tag: idx for idx, tag in enumerate(supported_tags) + } + + def get_applicable_candidates( + self, + candidates: List[InstallationCandidate], + ) -> List[InstallationCandidate]: + """ + Return the applicable candidates from a list of candidates. + """ + # Using None infers from the specifier instead. + allow_prereleases = self._allow_all_prereleases or None + specifier = self._specifier + + # We turn the version object into a str here because otherwise + # when we're debundled but setuptools isn't, Python will see + # packaging.version.Version and + # pkg_resources._vendor.packaging.version.Version as different + # types. This way we'll use a str as a common data interchange + # format. If we stop using the pkg_resources provided specifier + # and start using our own, we can drop the cast to str(). + candidates_and_versions = [(c, str(c.version)) for c in candidates] + versions = set( + specifier.filter( + (v for _, v in candidates_and_versions), + prereleases=allow_prereleases, + ) + ) + + applicable_candidates = [c for c, v in candidates_and_versions if v in versions] + filtered_applicable_candidates = filter_unallowed_hashes( + candidates=applicable_candidates, + hashes=self._hashes, + project_name=self._project_name, + ) + + return sorted(filtered_applicable_candidates, key=self._sort_key) + + def _sort_key(self, candidate: InstallationCandidate) -> CandidateSortingKey: + """ + Function to pass as the `key` argument to a call to sorted() to sort + InstallationCandidates by preference. + + Returns a tuple such that tuples sorting as greater using Python's + default comparison operator are more preferred. + + The preference is as follows: + + First and foremost, candidates with allowed (matching) hashes are + always preferred over candidates without matching hashes. This is + because e.g. if the only candidate with an allowed hash is yanked, + we still want to use that candidate. + + Second, excepting hash considerations, candidates that have been + yanked (in the sense of PEP 592) are always less preferred than + candidates that haven't been yanked. Then: + + If not finding wheels, they are sorted by version only. + If finding wheels, then the sort order is by version, then: + 1. existing installs + 2. wheels ordered via Wheel.support_index_min(self._supported_tags) + 3. source archives + If prefer_binary was set, then all wheels are sorted above sources. + + Note: it was considered to embed this logic into the Link + comparison operators, but then different sdist links + with the same version, would have to be considered equal + """ + valid_tags = self._supported_tags + support_num = len(valid_tags) + build_tag: BuildTag = () + binary_preference = 0 + link = candidate.link + if link.is_wheel: + # can raise InvalidWheelFilename + wheel = Wheel(link.filename) + try: + pri = -( + wheel.find_most_preferred_tag( + valid_tags, self._wheel_tag_preferences + ) + ) + except ValueError: + raise UnsupportedWheel( + f"{wheel.filename} is not a supported wheel for this platform. It " + "can't be sorted." + ) + if self._prefer_binary: + binary_preference = 1 + if wheel.build_tag is not None: + match = re.match(r"^(\d+)(.*)$", wheel.build_tag) + assert match is not None, "guaranteed by filename validation" + build_tag_groups = match.groups() + build_tag = (int(build_tag_groups[0]), build_tag_groups[1]) + else: # sdist + pri = -(support_num) + has_allowed_hash = int(link.is_hash_allowed(self._hashes)) + yank_value = -1 * int(link.is_yanked) # -1 for yanked. + return ( + has_allowed_hash, + yank_value, + binary_preference, + candidate.version, + pri, + build_tag, + ) + + def sort_best_candidate( + self, + candidates: List[InstallationCandidate], + ) -> Optional[InstallationCandidate]: + """ + Return the best candidate per the instance's sort order, or None if + no candidate is acceptable. + """ + if not candidates: + return None + best_candidate = max(candidates, key=self._sort_key) + return best_candidate + + def compute_best_candidate( + self, + candidates: List[InstallationCandidate], + ) -> BestCandidateResult: + """ + Compute and return a `BestCandidateResult` instance. + """ + applicable_candidates = self.get_applicable_candidates(candidates) + + best_candidate = self.sort_best_candidate(applicable_candidates) + + return BestCandidateResult( + candidates, + applicable_candidates=applicable_candidates, + best_candidate=best_candidate, + ) + + +class PackageFinder: + """This finds packages. + + This is meant to match easy_install's technique for looking for + packages, by reading pages and looking for appropriate links. + """ + + def __init__( + self, + link_collector: LinkCollector, + target_python: TargetPython, + allow_yanked: bool, + format_control: Optional[FormatControl] = None, + candidate_prefs: Optional[CandidatePreferences] = None, + ignore_requires_python: Optional[bool] = None, + ) -> None: + """ + This constructor is primarily meant to be used by the create() class + method and from tests. + + :param format_control: A FormatControl object, used to control + the selection of source packages / binary packages when consulting + the index and links. + :param candidate_prefs: Options to use when creating a + CandidateEvaluator object. + """ + if candidate_prefs is None: + candidate_prefs = CandidatePreferences() + + format_control = format_control or FormatControl(set(), set()) + + self._allow_yanked = allow_yanked + self._candidate_prefs = candidate_prefs + self._ignore_requires_python = ignore_requires_python + self._link_collector = link_collector + self._target_python = target_python + + self.format_control = format_control + + # These are boring links that have already been logged somehow. + self._logged_links: Set[Tuple[Link, LinkType, str]] = set() + + # Don't include an allow_yanked default value to make sure each call + # site considers whether yanked releases are allowed. This also causes + # that decision to be made explicit in the calling code, which helps + # people when reading the code. + @classmethod + def create( + cls, + link_collector: LinkCollector, + selection_prefs: SelectionPreferences, + target_python: Optional[TargetPython] = None, + ) -> "PackageFinder": + """Create a PackageFinder. + + :param selection_prefs: The candidate selection preferences, as a + SelectionPreferences object. + :param target_python: The target Python interpreter to use when + checking compatibility. If None (the default), a TargetPython + object will be constructed from the running Python. + """ + if target_python is None: + target_python = TargetPython() + + candidate_prefs = CandidatePreferences( + prefer_binary=selection_prefs.prefer_binary, + allow_all_prereleases=selection_prefs.allow_all_prereleases, + ) + + return cls( + candidate_prefs=candidate_prefs, + link_collector=link_collector, + target_python=target_python, + allow_yanked=selection_prefs.allow_yanked, + format_control=selection_prefs.format_control, + ignore_requires_python=selection_prefs.ignore_requires_python, + ) + + @property + def target_python(self) -> TargetPython: + return self._target_python + + @property + def search_scope(self) -> SearchScope: + return self._link_collector.search_scope + + @search_scope.setter + def search_scope(self, search_scope: SearchScope) -> None: + self._link_collector.search_scope = search_scope + + @property + def find_links(self) -> List[str]: + return self._link_collector.find_links + + @property + def index_urls(self) -> List[str]: + return self.search_scope.index_urls + + @property + def proxy(self) -> Optional[str]: + return self._link_collector.session.pip_proxy + + @property + def trusted_hosts(self) -> Iterable[str]: + for host_port in self._link_collector.session.pip_trusted_origins: + yield build_netloc(*host_port) + + @property + def custom_cert(self) -> Optional[str]: + # session.verify is either a boolean (use default bundle/no SSL + # verification) or a string path to a custom CA bundle to use. We only + # care about the latter. + verify = self._link_collector.session.verify + return verify if isinstance(verify, str) else None + + @property + def client_cert(self) -> Optional[str]: + cert = self._link_collector.session.cert + assert not isinstance(cert, tuple), "pip only supports PEM client certs" + return cert + + @property + def allow_all_prereleases(self) -> bool: + return self._candidate_prefs.allow_all_prereleases + + def set_allow_all_prereleases(self) -> None: + self._candidate_prefs.allow_all_prereleases = True + + @property + def prefer_binary(self) -> bool: + return self._candidate_prefs.prefer_binary + + def set_prefer_binary(self) -> None: + self._candidate_prefs.prefer_binary = True + + def requires_python_skipped_reasons(self) -> List[str]: + reasons = { + detail + for _, result, detail in self._logged_links + if result == LinkType.requires_python_mismatch + } + return sorted(reasons) + + def make_link_evaluator(self, project_name: str) -> LinkEvaluator: + canonical_name = canonicalize_name(project_name) + formats = self.format_control.get_allowed_formats(canonical_name) + + return LinkEvaluator( + project_name=project_name, + canonical_name=canonical_name, + formats=formats, + target_python=self._target_python, + allow_yanked=self._allow_yanked, + ignore_requires_python=self._ignore_requires_python, + ) + + def _sort_links(self, links: Iterable[Link]) -> List[Link]: + """ + Returns elements of links in order, non-egg links first, egg links + second, while eliminating duplicates + """ + eggs, no_eggs = [], [] + seen: Set[Link] = set() + for link in links: + if link not in seen: + seen.add(link) + if link.egg_fragment: + eggs.append(link) + else: + no_eggs.append(link) + return no_eggs + eggs + + def _log_skipped_link(self, link: Link, result: LinkType, detail: str) -> None: + # This is a hot method so don't waste time hashing links unless we're + # actually going to log 'em. + if not logger.isEnabledFor(logging.DEBUG): + return + + entry = (link, result, detail) + if entry not in self._logged_links: + # Put the link at the end so the reason is more visible and because + # the link string is usually very long. + logger.debug("Skipping link: %s: %s", detail, link) + self._logged_links.add(entry) + + def get_install_candidate( + self, link_evaluator: LinkEvaluator, link: Link + ) -> Optional[InstallationCandidate]: + """ + If the link is a candidate for install, convert it to an + InstallationCandidate and return it. Otherwise, return None. + """ + result, detail = link_evaluator.evaluate_link(link) + if result != LinkType.candidate: + self._log_skipped_link(link, result, detail) + return None + + try: + return InstallationCandidate( + name=link_evaluator.project_name, + link=link, + version=detail, + ) + except InvalidVersion: + return None + + def evaluate_links( + self, link_evaluator: LinkEvaluator, links: Iterable[Link] + ) -> List[InstallationCandidate]: + """ + Convert links that are candidates to InstallationCandidate objects. + """ + candidates = [] + for link in self._sort_links(links): + candidate = self.get_install_candidate(link_evaluator, link) + if candidate is not None: + candidates.append(candidate) + + return candidates + + def process_project_url( + self, project_url: Link, link_evaluator: LinkEvaluator + ) -> List[InstallationCandidate]: + logger.debug( + "Fetching project page and analyzing links: %s", + project_url, + ) + index_response = self._link_collector.fetch_response(project_url) + if index_response is None: + return [] + + page_links = list(parse_links(index_response)) + + with indent_log(): + package_links = self.evaluate_links( + link_evaluator, + links=page_links, + ) + + return package_links + + @functools.lru_cache(maxsize=None) + def find_all_candidates(self, project_name: str) -> List[InstallationCandidate]: + """Find all available InstallationCandidate for project_name + + This checks index_urls and find_links. + All versions found are returned as an InstallationCandidate list. + + See LinkEvaluator.evaluate_link() for details on which files + are accepted. + """ + link_evaluator = self.make_link_evaluator(project_name) + + collected_sources = self._link_collector.collect_sources( + project_name=project_name, + candidates_from_page=functools.partial( + self.process_project_url, + link_evaluator=link_evaluator, + ), + ) + + page_candidates_it = itertools.chain.from_iterable( + source.page_candidates() + for sources in collected_sources + for source in sources + if source is not None + ) + page_candidates = list(page_candidates_it) + + file_links_it = itertools.chain.from_iterable( + source.file_links() + for sources in collected_sources + for source in sources + if source is not None + ) + file_candidates = self.evaluate_links( + link_evaluator, + sorted(file_links_it, reverse=True), + ) + + if logger.isEnabledFor(logging.DEBUG) and file_candidates: + paths = [] + for candidate in file_candidates: + assert candidate.link.url # we need to have a URL + try: + paths.append(candidate.link.file_path) + except Exception: + paths.append(candidate.link.url) # it's not a local file + + logger.debug("Local files found: %s", ", ".join(paths)) + + # This is an intentional priority ordering + return file_candidates + page_candidates + + def make_candidate_evaluator( + self, + project_name: str, + specifier: Optional[specifiers.BaseSpecifier] = None, + hashes: Optional[Hashes] = None, + ) -> CandidateEvaluator: + """Create a CandidateEvaluator object to use.""" + candidate_prefs = self._candidate_prefs + return CandidateEvaluator.create( + project_name=project_name, + target_python=self._target_python, + prefer_binary=candidate_prefs.prefer_binary, + allow_all_prereleases=candidate_prefs.allow_all_prereleases, + specifier=specifier, + hashes=hashes, + ) + + @functools.lru_cache(maxsize=None) + def find_best_candidate( + self, + project_name: str, + specifier: Optional[specifiers.BaseSpecifier] = None, + hashes: Optional[Hashes] = None, + ) -> BestCandidateResult: + """Find matches for the given project and specifier. + + :param specifier: An optional object implementing `filter` + (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable + versions. + + :return: A `BestCandidateResult` instance. + """ + candidates = self.find_all_candidates(project_name) + candidate_evaluator = self.make_candidate_evaluator( + project_name=project_name, + specifier=specifier, + hashes=hashes, + ) + return candidate_evaluator.compute_best_candidate(candidates) + + def find_requirement( + self, req: InstallRequirement, upgrade: bool + ) -> Optional[InstallationCandidate]: + """Try to find a Link matching req + + Expects req, an InstallRequirement and upgrade, a boolean + Returns a InstallationCandidate if found, + Raises DistributionNotFound or BestVersionAlreadyInstalled otherwise + """ + hashes = req.hashes(trust_internet=False) + best_candidate_result = self.find_best_candidate( + req.name, + specifier=req.specifier, + hashes=hashes, + ) + best_candidate = best_candidate_result.best_candidate + + installed_version: Optional[_BaseVersion] = None + if req.satisfied_by is not None: + installed_version = req.satisfied_by.version + + def _format_versions(cand_iter: Iterable[InstallationCandidate]) -> str: + # This repeated parse_version and str() conversion is needed to + # handle different vendoring sources from pip and pkg_resources. + # If we stop using the pkg_resources provided specifier and start + # using our own, we can drop the cast to str(). + return ( + ", ".join( + sorted( + {str(c.version) for c in cand_iter}, + key=parse_version, + ) + ) + or "none" + ) + + if installed_version is None and best_candidate is None: + logger.critical( + "Could not find a version that satisfies the requirement %s " + "(from versions: %s)", + req, + _format_versions(best_candidate_result.all_candidates), + ) + + raise DistributionNotFound(f"No matching distribution found for {req}") + + def _should_install_candidate( + candidate: Optional[InstallationCandidate], + ) -> "TypeGuard[InstallationCandidate]": + if installed_version is None: + return True + if best_candidate is None: + return False + return best_candidate.version > installed_version + + if not upgrade and installed_version is not None: + if _should_install_candidate(best_candidate): + logger.debug( + "Existing installed version (%s) satisfies requirement " + "(most up-to-date version is %s)", + installed_version, + best_candidate.version, + ) + else: + logger.debug( + "Existing installed version (%s) is most up-to-date and " + "satisfies requirement", + installed_version, + ) + return None + + if _should_install_candidate(best_candidate): + logger.debug( + "Using version %s (newest of versions: %s)", + best_candidate.version, + _format_versions(best_candidate_result.applicable_candidates), + ) + return best_candidate + + # We have an existing version, and its the best version + logger.debug( + "Installed version (%s) is most up-to-date (past versions: %s)", + installed_version, + _format_versions(best_candidate_result.applicable_candidates), + ) + raise BestVersionAlreadyInstalled + + +def _find_name_version_sep(fragment: str, canonical_name: str) -> int: + """Find the separator's index based on the package's canonical name. + + :param fragment: A + filename "fragment" (stem) or + egg fragment. + :param canonical_name: The package's canonical name. + + This function is needed since the canonicalized name does not necessarily + have the same length as the egg info's name part. An example:: + + >>> fragment = 'foo__bar-1.0' + >>> canonical_name = 'foo-bar' + >>> _find_name_version_sep(fragment, canonical_name) + 8 + """ + # Project name and version must be separated by one single dash. Find all + # occurrences of dashes; if the string in front of it matches the canonical + # name, this is the one separating the name and version parts. + for i, c in enumerate(fragment): + if c != "-": + continue + if canonicalize_name(fragment[:i]) == canonical_name: + return i + raise ValueError(f"{fragment} does not match {canonical_name}") + + +def _extract_version_from_fragment(fragment: str, canonical_name: str) -> Optional[str]: + """Parse the version string from a + filename + "fragment" (stem) or egg fragment. + + :param fragment: The string to parse. E.g. foo-2.1 + :param canonical_name: The canonicalized name of the package this + belongs to. + """ + try: + version_start = _find_name_version_sep(fragment, canonical_name) + 1 + except ValueError: + return None + version = fragment[version_start:] + if not version: + return None + return version diff --git a/env/lib/python3.12/site-packages/pip/_internal/index/sources.py b/env/lib/python3.12/site-packages/pip/_internal/index/sources.py new file mode 100644 index 0000000..3dafb30 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/index/sources.py @@ -0,0 +1,284 @@ +import logging +import mimetypes +import os +from collections import defaultdict +from typing import Callable, Dict, Iterable, List, Optional, Tuple + +from pip._vendor.packaging.utils import ( + InvalidSdistFilename, + InvalidWheelFilename, + canonicalize_name, + parse_sdist_filename, + parse_wheel_filename, +) + +from pip._internal.models.candidate import InstallationCandidate +from pip._internal.models.link import Link +from pip._internal.utils.urls import path_to_url, url_to_path +from pip._internal.vcs import is_url + +logger = logging.getLogger(__name__) + +FoundCandidates = Iterable[InstallationCandidate] +FoundLinks = Iterable[Link] +CandidatesFromPage = Callable[[Link], Iterable[InstallationCandidate]] +PageValidator = Callable[[Link], bool] + + +class LinkSource: + @property + def link(self) -> Optional[Link]: + """Returns the underlying link, if there's one.""" + raise NotImplementedError() + + def page_candidates(self) -> FoundCandidates: + """Candidates found by parsing an archive listing HTML file.""" + raise NotImplementedError() + + def file_links(self) -> FoundLinks: + """Links found by specifying archives directly.""" + raise NotImplementedError() + + +def _is_html_file(file_url: str) -> bool: + return mimetypes.guess_type(file_url, strict=False)[0] == "text/html" + + +class _FlatDirectoryToUrls: + """Scans directory and caches results""" + + def __init__(self, path: str) -> None: + self._path = path + self._page_candidates: List[str] = [] + self._project_name_to_urls: Dict[str, List[str]] = defaultdict(list) + self._scanned_directory = False + + def _scan_directory(self) -> None: + """Scans directory once and populates both page_candidates + and project_name_to_urls at the same time + """ + for entry in os.scandir(self._path): + url = path_to_url(entry.path) + if _is_html_file(url): + self._page_candidates.append(url) + continue + + # File must have a valid wheel or sdist name, + # otherwise not worth considering as a package + try: + project_filename = parse_wheel_filename(entry.name)[0] + except InvalidWheelFilename: + try: + project_filename = parse_sdist_filename(entry.name)[0] + except InvalidSdistFilename: + continue + + self._project_name_to_urls[project_filename].append(url) + self._scanned_directory = True + + @property + def page_candidates(self) -> List[str]: + if not self._scanned_directory: + self._scan_directory() + + return self._page_candidates + + @property + def project_name_to_urls(self) -> Dict[str, List[str]]: + if not self._scanned_directory: + self._scan_directory() + + return self._project_name_to_urls + + +class _FlatDirectorySource(LinkSource): + """Link source specified by ``--find-links=``. + + This looks the content of the directory, and returns: + + * ``page_candidates``: Links listed on each HTML file in the directory. + * ``file_candidates``: Archives in the directory. + """ + + _paths_to_urls: Dict[str, _FlatDirectoryToUrls] = {} + + def __init__( + self, + candidates_from_page: CandidatesFromPage, + path: str, + project_name: str, + ) -> None: + self._candidates_from_page = candidates_from_page + self._project_name = canonicalize_name(project_name) + + # Get existing instance of _FlatDirectoryToUrls if it exists + if path in self._paths_to_urls: + self._path_to_urls = self._paths_to_urls[path] + else: + self._path_to_urls = _FlatDirectoryToUrls(path=path) + self._paths_to_urls[path] = self._path_to_urls + + @property + def link(self) -> Optional[Link]: + return None + + def page_candidates(self) -> FoundCandidates: + for url in self._path_to_urls.page_candidates: + yield from self._candidates_from_page(Link(url)) + + def file_links(self) -> FoundLinks: + for url in self._path_to_urls.project_name_to_urls[self._project_name]: + yield Link(url) + + +class _LocalFileSource(LinkSource): + """``--find-links=`` or ``--[extra-]index-url=``. + + If a URL is supplied, it must be a ``file:`` URL. If a path is supplied to + the option, it is converted to a URL first. This returns: + + * ``page_candidates``: Links listed on an HTML file. + * ``file_candidates``: The non-HTML file. + """ + + def __init__( + self, + candidates_from_page: CandidatesFromPage, + link: Link, + ) -> None: + self._candidates_from_page = candidates_from_page + self._link = link + + @property + def link(self) -> Optional[Link]: + return self._link + + def page_candidates(self) -> FoundCandidates: + if not _is_html_file(self._link.url): + return + yield from self._candidates_from_page(self._link) + + def file_links(self) -> FoundLinks: + if _is_html_file(self._link.url): + return + yield self._link + + +class _RemoteFileSource(LinkSource): + """``--find-links=`` or ``--[extra-]index-url=``. + + This returns: + + * ``page_candidates``: Links listed on an HTML file. + * ``file_candidates``: The non-HTML file. + """ + + def __init__( + self, + candidates_from_page: CandidatesFromPage, + page_validator: PageValidator, + link: Link, + ) -> None: + self._candidates_from_page = candidates_from_page + self._page_validator = page_validator + self._link = link + + @property + def link(self) -> Optional[Link]: + return self._link + + def page_candidates(self) -> FoundCandidates: + if not self._page_validator(self._link): + return + yield from self._candidates_from_page(self._link) + + def file_links(self) -> FoundLinks: + yield self._link + + +class _IndexDirectorySource(LinkSource): + """``--[extra-]index-url=``. + + This is treated like a remote URL; ``candidates_from_page`` contains logic + for this by appending ``index.html`` to the link. + """ + + def __init__( + self, + candidates_from_page: CandidatesFromPage, + link: Link, + ) -> None: + self._candidates_from_page = candidates_from_page + self._link = link + + @property + def link(self) -> Optional[Link]: + return self._link + + def page_candidates(self) -> FoundCandidates: + yield from self._candidates_from_page(self._link) + + def file_links(self) -> FoundLinks: + return () + + +def build_source( + location: str, + *, + candidates_from_page: CandidatesFromPage, + page_validator: PageValidator, + expand_dir: bool, + cache_link_parsing: bool, + project_name: str, +) -> Tuple[Optional[str], Optional[LinkSource]]: + path: Optional[str] = None + url: Optional[str] = None + if os.path.exists(location): # Is a local path. + url = path_to_url(location) + path = location + elif location.startswith("file:"): # A file: URL. + url = location + path = url_to_path(location) + elif is_url(location): + url = location + + if url is None: + msg = ( + "Location '%s' is ignored: " + "it is either a non-existing path or lacks a specific scheme." + ) + logger.warning(msg, location) + return (None, None) + + if path is None: + source: LinkSource = _RemoteFileSource( + candidates_from_page=candidates_from_page, + page_validator=page_validator, + link=Link(url, cache_link_parsing=cache_link_parsing), + ) + return (url, source) + + if os.path.isdir(path): + if expand_dir: + source = _FlatDirectorySource( + candidates_from_page=candidates_from_page, + path=path, + project_name=project_name, + ) + else: + source = _IndexDirectorySource( + candidates_from_page=candidates_from_page, + link=Link(url, cache_link_parsing=cache_link_parsing), + ) + return (url, source) + elif os.path.isfile(path): + source = _LocalFileSource( + candidates_from_page=candidates_from_page, + link=Link(url, cache_link_parsing=cache_link_parsing), + ) + return (url, source) + logger.warning( + "Location '%s' is ignored: it is neither a file nor a directory.", + location, + ) + return (url, None) diff --git a/env/lib/python3.12/site-packages/pip/_internal/locations/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/locations/__init__.py new file mode 100644 index 0000000..32382be --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/locations/__init__.py @@ -0,0 +1,456 @@ +import functools +import logging +import os +import pathlib +import sys +import sysconfig +from typing import Any, Dict, Generator, Optional, Tuple + +from pip._internal.models.scheme import SCHEME_KEYS, Scheme +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.virtualenv import running_under_virtualenv + +from . import _sysconfig +from .base import ( + USER_CACHE_DIR, + get_major_minor_version, + get_src_prefix, + is_osx_framework, + site_packages, + user_site, +) + +__all__ = [ + "USER_CACHE_DIR", + "get_bin_prefix", + "get_bin_user", + "get_major_minor_version", + "get_platlib", + "get_purelib", + "get_scheme", + "get_src_prefix", + "site_packages", + "user_site", +] + + +logger = logging.getLogger(__name__) + + +_PLATLIBDIR: str = getattr(sys, "platlibdir", "lib") + +_USE_SYSCONFIG_DEFAULT = sys.version_info >= (3, 10) + + +def _should_use_sysconfig() -> bool: + """This function determines the value of _USE_SYSCONFIG. + + By default, pip uses sysconfig on Python 3.10+. + But Python distributors can override this decision by setting: + sysconfig._PIP_USE_SYSCONFIG = True / False + Rationale in https://github.com/pypa/pip/issues/10647 + + This is a function for testability, but should be constant during any one + run. + """ + return bool(getattr(sysconfig, "_PIP_USE_SYSCONFIG", _USE_SYSCONFIG_DEFAULT)) + + +_USE_SYSCONFIG = _should_use_sysconfig() + +if not _USE_SYSCONFIG: + # Import distutils lazily to avoid deprecation warnings, + # but import it soon enough that it is in memory and available during + # a pip reinstall. + from . import _distutils + +# Be noisy about incompatibilities if this platforms "should" be using +# sysconfig, but is explicitly opting out and using distutils instead. +if _USE_SYSCONFIG_DEFAULT and not _USE_SYSCONFIG: + _MISMATCH_LEVEL = logging.WARNING +else: + _MISMATCH_LEVEL = logging.DEBUG + + +def _looks_like_bpo_44860() -> bool: + """The resolution to bpo-44860 will change this incorrect platlib. + + See . + """ + from distutils.command.install import INSTALL_SCHEMES + + try: + unix_user_platlib = INSTALL_SCHEMES["unix_user"]["platlib"] + except KeyError: + return False + return unix_user_platlib == "$usersite" + + +def _looks_like_red_hat_patched_platlib_purelib(scheme: Dict[str, str]) -> bool: + platlib = scheme["platlib"] + if "/$platlibdir/" in platlib: + platlib = platlib.replace("/$platlibdir/", f"/{_PLATLIBDIR}/") + if "/lib64/" not in platlib: + return False + unpatched = platlib.replace("/lib64/", "/lib/") + return unpatched.replace("$platbase/", "$base/") == scheme["purelib"] + + +@functools.lru_cache(maxsize=None) +def _looks_like_red_hat_lib() -> bool: + """Red Hat patches platlib in unix_prefix and unix_home, but not purelib. + + This is the only way I can see to tell a Red Hat-patched Python. + """ + from distutils.command.install import INSTALL_SCHEMES + + return all( + k in INSTALL_SCHEMES + and _looks_like_red_hat_patched_platlib_purelib(INSTALL_SCHEMES[k]) + for k in ("unix_prefix", "unix_home") + ) + + +@functools.lru_cache(maxsize=None) +def _looks_like_debian_scheme() -> bool: + """Debian adds two additional schemes.""" + from distutils.command.install import INSTALL_SCHEMES + + return "deb_system" in INSTALL_SCHEMES and "unix_local" in INSTALL_SCHEMES + + +@functools.lru_cache(maxsize=None) +def _looks_like_red_hat_scheme() -> bool: + """Red Hat patches ``sys.prefix`` and ``sys.exec_prefix``. + + Red Hat's ``00251-change-user-install-location.patch`` changes the install + command's ``prefix`` and ``exec_prefix`` to append ``"/local"``. This is + (fortunately?) done quite unconditionally, so we create a default command + object without any configuration to detect this. + """ + from distutils.command.install import install + from distutils.dist import Distribution + + cmd: Any = install(Distribution()) + cmd.finalize_options() + return ( + cmd.exec_prefix == f"{os.path.normpath(sys.exec_prefix)}/local" + and cmd.prefix == f"{os.path.normpath(sys.prefix)}/local" + ) + + +@functools.lru_cache(maxsize=None) +def _looks_like_slackware_scheme() -> bool: + """Slackware patches sysconfig but fails to patch distutils and site. + + Slackware changes sysconfig's user scheme to use ``"lib64"`` for the lib + path, but does not do the same to the site module. + """ + if user_site is None: # User-site not available. + return False + try: + paths = sysconfig.get_paths(scheme="posix_user", expand=False) + except KeyError: # User-site not available. + return False + return "/lib64/" in paths["purelib"] and "/lib64/" not in user_site + + +@functools.lru_cache(maxsize=None) +def _looks_like_msys2_mingw_scheme() -> bool: + """MSYS2 patches distutils and sysconfig to use a UNIX-like scheme. + + However, MSYS2 incorrectly patches sysconfig ``nt`` scheme. The fix is + likely going to be included in their 3.10 release, so we ignore the warning. + See msys2/MINGW-packages#9319. + + MSYS2 MINGW's patch uses lowercase ``"lib"`` instead of the usual uppercase, + and is missing the final ``"site-packages"``. + """ + paths = sysconfig.get_paths("nt", expand=False) + return all( + "Lib" not in p and "lib" in p and not p.endswith("site-packages") + for p in (paths[key] for key in ("platlib", "purelib")) + ) + + +def _fix_abiflags(parts: Tuple[str]) -> Generator[str, None, None]: + ldversion = sysconfig.get_config_var("LDVERSION") + abiflags = getattr(sys, "abiflags", None) + + # LDVERSION does not end with sys.abiflags. Just return the path unchanged. + if not ldversion or not abiflags or not ldversion.endswith(abiflags): + yield from parts + return + + # Strip sys.abiflags from LDVERSION-based path components. + for part in parts: + if part.endswith(ldversion): + part = part[: (0 - len(abiflags))] + yield part + + +@functools.lru_cache(maxsize=None) +def _warn_mismatched(old: pathlib.Path, new: pathlib.Path, *, key: str) -> None: + issue_url = "https://github.com/pypa/pip/issues/10151" + message = ( + "Value for %s does not match. Please report this to <%s>" + "\ndistutils: %s" + "\nsysconfig: %s" + ) + logger.log(_MISMATCH_LEVEL, message, key, issue_url, old, new) + + +def _warn_if_mismatch(old: pathlib.Path, new: pathlib.Path, *, key: str) -> bool: + if old == new: + return False + _warn_mismatched(old, new, key=key) + return True + + +@functools.lru_cache(maxsize=None) +def _log_context( + *, + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + prefix: Optional[str] = None, +) -> None: + parts = [ + "Additional context:", + "user = %r", + "home = %r", + "root = %r", + "prefix = %r", + ] + + logger.log(_MISMATCH_LEVEL, "\n".join(parts), user, home, root, prefix) + + +def get_scheme( + dist_name: str, + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + isolated: bool = False, + prefix: Optional[str] = None, +) -> Scheme: + new = _sysconfig.get_scheme( + dist_name, + user=user, + home=home, + root=root, + isolated=isolated, + prefix=prefix, + ) + if _USE_SYSCONFIG: + return new + + old = _distutils.get_scheme( + dist_name, + user=user, + home=home, + root=root, + isolated=isolated, + prefix=prefix, + ) + + warning_contexts = [] + for k in SCHEME_KEYS: + old_v = pathlib.Path(getattr(old, k)) + new_v = pathlib.Path(getattr(new, k)) + + if old_v == new_v: + continue + + # distutils incorrectly put PyPy packages under ``site-packages/python`` + # in the ``posix_home`` scheme, but PyPy devs said they expect the + # directory name to be ``pypy`` instead. So we treat this as a bug fix + # and not warn about it. See bpo-43307 and python/cpython#24628. + skip_pypy_special_case = ( + sys.implementation.name == "pypy" + and home is not None + and k in ("platlib", "purelib") + and old_v.parent == new_v.parent + and old_v.name.startswith("python") + and new_v.name.startswith("pypy") + ) + if skip_pypy_special_case: + continue + + # sysconfig's ``osx_framework_user`` does not include ``pythonX.Y`` in + # the ``include`` value, but distutils's ``headers`` does. We'll let + # CPython decide whether this is a bug or feature. See bpo-43948. + skip_osx_framework_user_special_case = ( + user + and is_osx_framework() + and k == "headers" + and old_v.parent.parent == new_v.parent + and old_v.parent.name.startswith("python") + ) + if skip_osx_framework_user_special_case: + continue + + # On Red Hat and derived Linux distributions, distutils is patched to + # use "lib64" instead of "lib" for platlib. + if k == "platlib" and _looks_like_red_hat_lib(): + continue + + # On Python 3.9+, sysconfig's posix_user scheme sets platlib against + # sys.platlibdir, but distutils's unix_user incorrectly coninutes + # using the same $usersite for both platlib and purelib. This creates a + # mismatch when sys.platlibdir is not "lib". + skip_bpo_44860 = ( + user + and k == "platlib" + and not WINDOWS + and sys.version_info >= (3, 9) + and _PLATLIBDIR != "lib" + and _looks_like_bpo_44860() + ) + if skip_bpo_44860: + continue + + # Slackware incorrectly patches posix_user to use lib64 instead of lib, + # but not usersite to match the location. + skip_slackware_user_scheme = ( + user + and k in ("platlib", "purelib") + and not WINDOWS + and _looks_like_slackware_scheme() + ) + if skip_slackware_user_scheme: + continue + + # Both Debian and Red Hat patch Python to place the system site under + # /usr/local instead of /usr. Debian also places lib in dist-packages + # instead of site-packages, but the /usr/local check should cover it. + skip_linux_system_special_case = ( + not (user or home or prefix or running_under_virtualenv()) + and old_v.parts[1:3] == ("usr", "local") + and len(new_v.parts) > 1 + and new_v.parts[1] == "usr" + and (len(new_v.parts) < 3 or new_v.parts[2] != "local") + and (_looks_like_red_hat_scheme() or _looks_like_debian_scheme()) + ) + if skip_linux_system_special_case: + continue + + # MSYS2 MINGW's sysconfig patch does not include the "site-packages" + # part of the path. This is incorrect and will be fixed in MSYS. + skip_msys2_mingw_bug = ( + WINDOWS and k in ("platlib", "purelib") and _looks_like_msys2_mingw_scheme() + ) + if skip_msys2_mingw_bug: + continue + + # CPython's POSIX install script invokes pip (via ensurepip) against the + # interpreter located in the source tree, not the install site. This + # triggers special logic in sysconfig that's not present in distutils. + # https://github.com/python/cpython/blob/8c21941ddaf/Lib/sysconfig.py#L178-L194 + skip_cpython_build = ( + sysconfig.is_python_build(check_home=True) + and not WINDOWS + and k in ("headers", "include", "platinclude") + ) + if skip_cpython_build: + continue + + warning_contexts.append((old_v, new_v, f"scheme.{k}")) + + if not warning_contexts: + return old + + # Check if this path mismatch is caused by distutils config files. Those + # files will no longer work once we switch to sysconfig, so this raises a + # deprecation message for them. + default_old = _distutils.distutils_scheme( + dist_name, + user, + home, + root, + isolated, + prefix, + ignore_config_files=True, + ) + if any(default_old[k] != getattr(old, k) for k in SCHEME_KEYS): + deprecated( + reason=( + "Configuring installation scheme with distutils config files " + "is deprecated and will no longer work in the near future. If you " + "are using a Homebrew or Linuxbrew Python, please see discussion " + "at https://github.com/Homebrew/homebrew-core/issues/76621" + ), + replacement=None, + gone_in=None, + ) + return old + + # Post warnings about this mismatch so user can report them back. + for old_v, new_v, key in warning_contexts: + _warn_mismatched(old_v, new_v, key=key) + _log_context(user=user, home=home, root=root, prefix=prefix) + + return old + + +def get_bin_prefix() -> str: + new = _sysconfig.get_bin_prefix() + if _USE_SYSCONFIG: + return new + + old = _distutils.get_bin_prefix() + if _warn_if_mismatch(pathlib.Path(old), pathlib.Path(new), key="bin_prefix"): + _log_context() + return old + + +def get_bin_user() -> str: + return _sysconfig.get_scheme("", user=True).scripts + + +def _looks_like_deb_system_dist_packages(value: str) -> bool: + """Check if the value is Debian's APT-controlled dist-packages. + + Debian's ``distutils.sysconfig.get_python_lib()`` implementation returns the + default package path controlled by APT, but does not patch ``sysconfig`` to + do the same. This is similar to the bug worked around in ``get_scheme()``, + but here the default is ``deb_system`` instead of ``unix_local``. Ultimately + we can't do anything about this Debian bug, and this detection allows us to + skip the warning when needed. + """ + if not _looks_like_debian_scheme(): + return False + if value == "/usr/lib/python3/dist-packages": + return True + return False + + +def get_purelib() -> str: + """Return the default pure-Python lib location.""" + new = _sysconfig.get_purelib() + if _USE_SYSCONFIG: + return new + + old = _distutils.get_purelib() + if _looks_like_deb_system_dist_packages(old): + return old + if _warn_if_mismatch(pathlib.Path(old), pathlib.Path(new), key="purelib"): + _log_context() + return old + + +def get_platlib() -> str: + """Return the default platform-shared lib location.""" + new = _sysconfig.get_platlib() + if _USE_SYSCONFIG: + return new + + from . import _distutils + + old = _distutils.get_platlib() + if _looks_like_deb_system_dist_packages(old): + return old + if _warn_if_mismatch(pathlib.Path(old), pathlib.Path(new), key="platlib"): + _log_context() + return old diff --git a/env/lib/python3.12/site-packages/pip/_internal/locations/_distutils.py b/env/lib/python3.12/site-packages/pip/_internal/locations/_distutils.py new file mode 100644 index 0000000..3d85625 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/locations/_distutils.py @@ -0,0 +1,172 @@ +"""Locations where we look for configs, install stuff, etc""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +# If pip's going to use distutils, it should not be using the copy that setuptools +# might have injected into the environment. This is done by removing the injected +# shim, if it's injected. +# +# See https://github.com/pypa/pip/issues/8761 for the original discussion and +# rationale for why this is done within pip. +try: + __import__("_distutils_hack").remove_shim() +except (ImportError, AttributeError): + pass + +import logging +import os +import sys +from distutils.cmd import Command as DistutilsCommand +from distutils.command.install import SCHEME_KEYS +from distutils.command.install import install as distutils_install_command +from distutils.sysconfig import get_python_lib +from typing import Dict, List, Optional, Union + +from pip._internal.models.scheme import Scheme +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.virtualenv import running_under_virtualenv + +from .base import get_major_minor_version + +logger = logging.getLogger(__name__) + + +def distutils_scheme( + dist_name: str, + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + isolated: bool = False, + prefix: Optional[str] = None, + *, + ignore_config_files: bool = False, +) -> Dict[str, str]: + """ + Return a distutils install scheme + """ + from distutils.dist import Distribution + + dist_args: Dict[str, Union[str, List[str]]] = {"name": dist_name} + if isolated: + dist_args["script_args"] = ["--no-user-cfg"] + + d = Distribution(dist_args) + if not ignore_config_files: + try: + d.parse_config_files() + except UnicodeDecodeError: + paths = d.find_config_files() + logger.warning( + "Ignore distutils configs in %s due to encoding errors.", + ", ".join(os.path.basename(p) for p in paths), + ) + obj: Optional[DistutilsCommand] = None + obj = d.get_command_obj("install", create=True) + assert obj is not None + i: distutils_install_command = obj + # NOTE: setting user or home has the side-effect of creating the home dir + # or user base for installations during finalize_options() + # ideally, we'd prefer a scheme class that has no side-effects. + assert not (user and prefix), f"user={user} prefix={prefix}" + assert not (home and prefix), f"home={home} prefix={prefix}" + i.user = user or i.user + if user or home: + i.prefix = "" + i.prefix = prefix or i.prefix + i.home = home or i.home + i.root = root or i.root + i.finalize_options() + + scheme: Dict[str, str] = {} + for key in SCHEME_KEYS: + scheme[key] = getattr(i, "install_" + key) + + # install_lib specified in setup.cfg should install *everything* + # into there (i.e. it takes precedence over both purelib and + # platlib). Note, i.install_lib is *always* set after + # finalize_options(); we only want to override here if the user + # has explicitly requested it hence going back to the config + if "install_lib" in d.get_option_dict("install"): + scheme.update({"purelib": i.install_lib, "platlib": i.install_lib}) + + if running_under_virtualenv(): + if home: + prefix = home + elif user: + prefix = i.install_userbase + else: + prefix = i.prefix + scheme["headers"] = os.path.join( + prefix, + "include", + "site", + f"python{get_major_minor_version()}", + dist_name, + ) + + if root is not None: + path_no_drive = os.path.splitdrive(os.path.abspath(scheme["headers"]))[1] + scheme["headers"] = os.path.join(root, path_no_drive[1:]) + + return scheme + + +def get_scheme( + dist_name: str, + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + isolated: bool = False, + prefix: Optional[str] = None, +) -> Scheme: + """ + Get the "scheme" corresponding to the input parameters. The distutils + documentation provides the context for the available schemes: + https://docs.python.org/3/install/index.html#alternate-installation + + :param dist_name: the name of the package to retrieve the scheme for, used + in the headers scheme path + :param user: indicates to use the "user" scheme + :param home: indicates to use the "home" scheme and provides the base + directory for the same + :param root: root under which other directories are re-based + :param isolated: equivalent to --no-user-cfg, i.e. do not consider + ~/.pydistutils.cfg (posix) or ~/pydistutils.cfg (non-posix) for + scheme paths + :param prefix: indicates to use the "prefix" scheme and provides the + base directory for the same + """ + scheme = distutils_scheme(dist_name, user, home, root, isolated, prefix) + return Scheme( + platlib=scheme["platlib"], + purelib=scheme["purelib"], + headers=scheme["headers"], + scripts=scheme["scripts"], + data=scheme["data"], + ) + + +def get_bin_prefix() -> str: + # XXX: In old virtualenv versions, sys.prefix can contain '..' components, + # so we need to call normpath to eliminate them. + prefix = os.path.normpath(sys.prefix) + if WINDOWS: + bin_py = os.path.join(prefix, "Scripts") + # buildout uses 'bin' on Windows too? + if not os.path.exists(bin_py): + bin_py = os.path.join(prefix, "bin") + return bin_py + # Forcing to use /usr/local/bin for standard macOS framework installs + # Also log to ~/Library/Logs/ for use with the Console.app log viewer + if sys.platform[:6] == "darwin" and prefix[:16] == "/System/Library/": + return "/usr/local/bin" + return os.path.join(prefix, "bin") + + +def get_purelib() -> str: + return get_python_lib(plat_specific=False) + + +def get_platlib() -> str: + return get_python_lib(plat_specific=True) diff --git a/env/lib/python3.12/site-packages/pip/_internal/locations/_sysconfig.py b/env/lib/python3.12/site-packages/pip/_internal/locations/_sysconfig.py new file mode 100644 index 0000000..ca860ea --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/locations/_sysconfig.py @@ -0,0 +1,214 @@ +import logging +import os +import sys +import sysconfig +import typing + +from pip._internal.exceptions import InvalidSchemeCombination, UserInstallationInvalid +from pip._internal.models.scheme import SCHEME_KEYS, Scheme +from pip._internal.utils.virtualenv import running_under_virtualenv + +from .base import change_root, get_major_minor_version, is_osx_framework + +logger = logging.getLogger(__name__) + + +# Notes on _infer_* functions. +# Unfortunately ``get_default_scheme()`` didn't exist before 3.10, so there's no +# way to ask things like "what is the '_prefix' scheme on this platform". These +# functions try to answer that with some heuristics while accounting for ad-hoc +# platforms not covered by CPython's default sysconfig implementation. If the +# ad-hoc implementation does not fully implement sysconfig, we'll fall back to +# a POSIX scheme. + +_AVAILABLE_SCHEMES = set(sysconfig.get_scheme_names()) + +_PREFERRED_SCHEME_API = getattr(sysconfig, "get_preferred_scheme", None) + + +def _should_use_osx_framework_prefix() -> bool: + """Check for Apple's ``osx_framework_library`` scheme. + + Python distributed by Apple's Command Line Tools has this special scheme + that's used when: + + * This is a framework build. + * We are installing into the system prefix. + + This does not account for ``pip install --prefix`` (also means we're not + installing to the system prefix), which should use ``posix_prefix``, but + logic here means ``_infer_prefix()`` outputs ``osx_framework_library``. But + since ``prefix`` is not available for ``sysconfig.get_default_scheme()``, + which is the stdlib replacement for ``_infer_prefix()``, presumably Apple + wouldn't be able to magically switch between ``osx_framework_library`` and + ``posix_prefix``. ``_infer_prefix()`` returning ``osx_framework_library`` + means its behavior is consistent whether we use the stdlib implementation + or our own, and we deal with this special case in ``get_scheme()`` instead. + """ + return ( + "osx_framework_library" in _AVAILABLE_SCHEMES + and not running_under_virtualenv() + and is_osx_framework() + ) + + +def _infer_prefix() -> str: + """Try to find a prefix scheme for the current platform. + + This tries: + + * A special ``osx_framework_library`` for Python distributed by Apple's + Command Line Tools, when not running in a virtual environment. + * Implementation + OS, used by PyPy on Windows (``pypy_nt``). + * Implementation without OS, used by PyPy on POSIX (``pypy``). + * OS + "prefix", used by CPython on POSIX (``posix_prefix``). + * Just the OS name, used by CPython on Windows (``nt``). + + If none of the above works, fall back to ``posix_prefix``. + """ + if _PREFERRED_SCHEME_API: + return _PREFERRED_SCHEME_API("prefix") + if _should_use_osx_framework_prefix(): + return "osx_framework_library" + implementation_suffixed = f"{sys.implementation.name}_{os.name}" + if implementation_suffixed in _AVAILABLE_SCHEMES: + return implementation_suffixed + if sys.implementation.name in _AVAILABLE_SCHEMES: + return sys.implementation.name + suffixed = f"{os.name}_prefix" + if suffixed in _AVAILABLE_SCHEMES: + return suffixed + if os.name in _AVAILABLE_SCHEMES: # On Windows, prefx is just called "nt". + return os.name + return "posix_prefix" + + +def _infer_user() -> str: + """Try to find a user scheme for the current platform.""" + if _PREFERRED_SCHEME_API: + return _PREFERRED_SCHEME_API("user") + if is_osx_framework() and not running_under_virtualenv(): + suffixed = "osx_framework_user" + else: + suffixed = f"{os.name}_user" + if suffixed in _AVAILABLE_SCHEMES: + return suffixed + if "posix_user" not in _AVAILABLE_SCHEMES: # User scheme unavailable. + raise UserInstallationInvalid() + return "posix_user" + + +def _infer_home() -> str: + """Try to find a home for the current platform.""" + if _PREFERRED_SCHEME_API: + return _PREFERRED_SCHEME_API("home") + suffixed = f"{os.name}_home" + if suffixed in _AVAILABLE_SCHEMES: + return suffixed + return "posix_home" + + +# Update these keys if the user sets a custom home. +_HOME_KEYS = [ + "installed_base", + "base", + "installed_platbase", + "platbase", + "prefix", + "exec_prefix", +] +if sysconfig.get_config_var("userbase") is not None: + _HOME_KEYS.append("userbase") + + +def get_scheme( + dist_name: str, + user: bool = False, + home: typing.Optional[str] = None, + root: typing.Optional[str] = None, + isolated: bool = False, + prefix: typing.Optional[str] = None, +) -> Scheme: + """ + Get the "scheme" corresponding to the input parameters. + + :param dist_name: the name of the package to retrieve the scheme for, used + in the headers scheme path + :param user: indicates to use the "user" scheme + :param home: indicates to use the "home" scheme + :param root: root under which other directories are re-based + :param isolated: ignored, but kept for distutils compatibility (where + this controls whether the user-site pydistutils.cfg is honored) + :param prefix: indicates to use the "prefix" scheme and provides the + base directory for the same + """ + if user and prefix: + raise InvalidSchemeCombination("--user", "--prefix") + if home and prefix: + raise InvalidSchemeCombination("--home", "--prefix") + + if home is not None: + scheme_name = _infer_home() + elif user: + scheme_name = _infer_user() + else: + scheme_name = _infer_prefix() + + # Special case: When installing into a custom prefix, use posix_prefix + # instead of osx_framework_library. See _should_use_osx_framework_prefix() + # docstring for details. + if prefix is not None and scheme_name == "osx_framework_library": + scheme_name = "posix_prefix" + + if home is not None: + variables = {k: home for k in _HOME_KEYS} + elif prefix is not None: + variables = {k: prefix for k in _HOME_KEYS} + else: + variables = {} + + paths = sysconfig.get_paths(scheme=scheme_name, vars=variables) + + # Logic here is very arbitrary, we're doing it for compatibility, don't ask. + # 1. Pip historically uses a special header path in virtual environments. + # 2. If the distribution name is not known, distutils uses 'UNKNOWN'. We + # only do the same when not running in a virtual environment because + # pip's historical header path logic (see point 1) did not do this. + if running_under_virtualenv(): + if user: + base = variables.get("userbase", sys.prefix) + else: + base = variables.get("base", sys.prefix) + python_xy = f"python{get_major_minor_version()}" + paths["include"] = os.path.join(base, "include", "site", python_xy) + elif not dist_name: + dist_name = "UNKNOWN" + + scheme = Scheme( + platlib=paths["platlib"], + purelib=paths["purelib"], + headers=os.path.join(paths["include"], dist_name), + scripts=paths["scripts"], + data=paths["data"], + ) + if root is not None: + converted_keys = {} + for key in SCHEME_KEYS: + converted_keys[key] = change_root(root, getattr(scheme, key)) + scheme = Scheme(**converted_keys) + return scheme + + +def get_bin_prefix() -> str: + # Forcing to use /usr/local/bin for standard macOS framework installs. + if sys.platform[:6] == "darwin" and sys.prefix[:16] == "/System/Library/": + return "/usr/local/bin" + return sysconfig.get_paths()["scripts"] + + +def get_purelib() -> str: + return sysconfig.get_paths()["purelib"] + + +def get_platlib() -> str: + return sysconfig.get_paths()["platlib"] diff --git a/env/lib/python3.12/site-packages/pip/_internal/locations/base.py b/env/lib/python3.12/site-packages/pip/_internal/locations/base.py new file mode 100644 index 0000000..3f9f896 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/locations/base.py @@ -0,0 +1,81 @@ +import functools +import os +import site +import sys +import sysconfig +import typing + +from pip._internal.exceptions import InstallationError +from pip._internal.utils import appdirs +from pip._internal.utils.virtualenv import running_under_virtualenv + +# Application Directories +USER_CACHE_DIR = appdirs.user_cache_dir("pip") + +# FIXME doesn't account for venv linked to global site-packages +site_packages: str = sysconfig.get_path("purelib") + + +def get_major_minor_version() -> str: + """ + Return the major-minor version of the current Python as a string, e.g. + "3.7" or "3.10". + """ + return "{}.{}".format(*sys.version_info) + + +def change_root(new_root: str, pathname: str) -> str: + """Return 'pathname' with 'new_root' prepended. + + If 'pathname' is relative, this is equivalent to os.path.join(new_root, pathname). + Otherwise, it requires making 'pathname' relative and then joining the + two, which is tricky on DOS/Windows and Mac OS. + + This is borrowed from Python's standard library's distutils module. + """ + if os.name == "posix": + if not os.path.isabs(pathname): + return os.path.join(new_root, pathname) + else: + return os.path.join(new_root, pathname[1:]) + + elif os.name == "nt": + (drive, path) = os.path.splitdrive(pathname) + if path[0] == "\\": + path = path[1:] + return os.path.join(new_root, path) + + else: + raise InstallationError( + f"Unknown platform: {os.name}\n" + "Can not change root path prefix on unknown platform." + ) + + +def get_src_prefix() -> str: + if running_under_virtualenv(): + src_prefix = os.path.join(sys.prefix, "src") + else: + # FIXME: keep src in cwd for now (it is not a temporary folder) + try: + src_prefix = os.path.join(os.getcwd(), "src") + except OSError: + # In case the current working directory has been renamed or deleted + sys.exit("The folder you are executing pip from can no longer be found.") + + # under macOS + virtualenv sys.prefix is not properly resolved + # it is something like /path/to/python/bin/.. + return os.path.abspath(src_prefix) + + +try: + # Use getusersitepackages if this is present, as it ensures that the + # value is initialised properly. + user_site: typing.Optional[str] = site.getusersitepackages() +except AttributeError: + user_site = site.USER_SITE + + +@functools.lru_cache(maxsize=None) +def is_osx_framework() -> bool: + return bool(sysconfig.get_config_var("PYTHONFRAMEWORK")) diff --git a/env/lib/python3.12/site-packages/pip/_internal/main.py b/env/lib/python3.12/site-packages/pip/_internal/main.py new file mode 100644 index 0000000..33c6d24 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/main.py @@ -0,0 +1,12 @@ +from typing import List, Optional + + +def main(args: Optional[List[str]] = None) -> int: + """This is preserved for old console scripts that may still be referencing + it. + + For additional details, see https://github.com/pypa/pip/issues/7498. + """ + from pip._internal.utils.entrypoints import _wrapper + + return _wrapper(args) diff --git a/env/lib/python3.12/site-packages/pip/_internal/metadata/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/metadata/__init__.py new file mode 100644 index 0000000..1ea1e7f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/metadata/__init__.py @@ -0,0 +1,128 @@ +import contextlib +import functools +import os +import sys +from typing import TYPE_CHECKING, List, Optional, Type, cast + +from pip._internal.utils.misc import strtobool + +from .base import BaseDistribution, BaseEnvironment, FilesystemWheel, MemoryWheel, Wheel + +if TYPE_CHECKING: + from typing import Literal, Protocol +else: + Protocol = object + +__all__ = [ + "BaseDistribution", + "BaseEnvironment", + "FilesystemWheel", + "MemoryWheel", + "Wheel", + "get_default_environment", + "get_environment", + "get_wheel_distribution", + "select_backend", +] + + +def _should_use_importlib_metadata() -> bool: + """Whether to use the ``importlib.metadata`` or ``pkg_resources`` backend. + + By default, pip uses ``importlib.metadata`` on Python 3.11+, and + ``pkg_resources`` otherwise. This can be overridden by a couple of ways: + + * If environment variable ``_PIP_USE_IMPORTLIB_METADATA`` is set, it + dictates whether ``importlib.metadata`` is used, regardless of Python + version. + * On Python 3.11+, Python distributors can patch ``importlib.metadata`` + to add a global constant ``_PIP_USE_IMPORTLIB_METADATA = False``. This + makes pip use ``pkg_resources`` (unless the user set the aforementioned + environment variable to *True*). + """ + with contextlib.suppress(KeyError, ValueError): + return bool(strtobool(os.environ["_PIP_USE_IMPORTLIB_METADATA"])) + if sys.version_info < (3, 11): + return False + import importlib.metadata + + return bool(getattr(importlib.metadata, "_PIP_USE_IMPORTLIB_METADATA", True)) + + +class Backend(Protocol): + NAME: 'Literal["importlib", "pkg_resources"]' + Distribution: Type[BaseDistribution] + Environment: Type[BaseEnvironment] + + +@functools.lru_cache(maxsize=None) +def select_backend() -> Backend: + if _should_use_importlib_metadata(): + from . import importlib + + return cast(Backend, importlib) + from . import pkg_resources + + return cast(Backend, pkg_resources) + + +def get_default_environment() -> BaseEnvironment: + """Get the default representation for the current environment. + + This returns an Environment instance from the chosen backend. The default + Environment instance should be built from ``sys.path`` and may use caching + to share instance state across calls. + """ + return select_backend().Environment.default() + + +def get_environment(paths: Optional[List[str]]) -> BaseEnvironment: + """Get a representation of the environment specified by ``paths``. + + This returns an Environment instance from the chosen backend based on the + given import paths. The backend must build a fresh instance representing + the state of installed distributions when this function is called. + """ + return select_backend().Environment.from_paths(paths) + + +def get_directory_distribution(directory: str) -> BaseDistribution: + """Get the distribution metadata representation in the specified directory. + + This returns a Distribution instance from the chosen backend based on + the given on-disk ``.dist-info`` directory. + """ + return select_backend().Distribution.from_directory(directory) + + +def get_wheel_distribution(wheel: Wheel, canonical_name: str) -> BaseDistribution: + """Get the representation of the specified wheel's distribution metadata. + + This returns a Distribution instance from the chosen backend based on + the given wheel's ``.dist-info`` directory. + + :param canonical_name: Normalized project name of the given wheel. + """ + return select_backend().Distribution.from_wheel(wheel, canonical_name) + + +def get_metadata_distribution( + metadata_contents: bytes, + filename: str, + canonical_name: str, +) -> BaseDistribution: + """Get the dist representation of the specified METADATA file contents. + + This returns a Distribution instance from the chosen backend sourced from the data + in `metadata_contents`. + + :param metadata_contents: Contents of a METADATA file within a dist, or one served + via PEP 658. + :param filename: Filename for the dist this metadata represents. + :param canonical_name: Normalized project name of the given dist. + """ + return select_backend().Distribution.from_metadata_file_contents( + metadata_contents, + filename, + canonical_name, + ) diff --git a/env/lib/python3.12/site-packages/pip/_internal/metadata/_json.py b/env/lib/python3.12/site-packages/pip/_internal/metadata/_json.py new file mode 100644 index 0000000..f3aeab3 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/metadata/_json.py @@ -0,0 +1,86 @@ +# Extracted from https://github.com/pfmoore/pkg_metadata + +from email.header import Header, decode_header, make_header +from email.message import Message +from typing import Any, Dict, List, Union, cast + +METADATA_FIELDS = [ + # Name, Multiple-Use + ("Metadata-Version", False), + ("Name", False), + ("Version", False), + ("Dynamic", True), + ("Platform", True), + ("Supported-Platform", True), + ("Summary", False), + ("Description", False), + ("Description-Content-Type", False), + ("Keywords", False), + ("Home-page", False), + ("Download-URL", False), + ("Author", False), + ("Author-email", False), + ("Maintainer", False), + ("Maintainer-email", False), + ("License", False), + ("License-Expression", False), + ("License-File", True), + ("Classifier", True), + ("Requires-Dist", True), + ("Requires-Python", False), + ("Requires-External", True), + ("Project-URL", True), + ("Provides-Extra", True), + ("Provides-Dist", True), + ("Obsoletes-Dist", True), +] + + +def json_name(field: str) -> str: + return field.lower().replace("-", "_") + + +def msg_to_json(msg: Message) -> Dict[str, Any]: + """Convert a Message object into a JSON-compatible dictionary.""" + + def sanitise_header(h: Union[Header, str]) -> str: + if isinstance(h, Header): + chunks = [] + for bytes, encoding in decode_header(h): + if encoding == "unknown-8bit": + try: + # See if UTF-8 works + bytes.decode("utf-8") + encoding = "utf-8" + except UnicodeDecodeError: + # If not, latin1 at least won't fail + encoding = "latin1" + chunks.append((bytes, encoding)) + return str(make_header(chunks)) + return str(h) + + result = {} + for field, multi in METADATA_FIELDS: + if field not in msg: + continue + key = json_name(field) + if multi: + value: Union[str, List[str]] = [ + sanitise_header(v) for v in msg.get_all(field) # type: ignore + ] + else: + value = sanitise_header(msg.get(field)) # type: ignore + if key == "keywords": + # Accept both comma-separated and space-separated + # forms, for better compatibility with old data. + if "," in value: + value = [v.strip() for v in value.split(",")] + else: + value = value.split() + result[key] = value + + payload = cast(str, msg.get_payload()) + if payload: + result["description"] = payload + + return result diff --git a/env/lib/python3.12/site-packages/pip/_internal/metadata/base.py b/env/lib/python3.12/site-packages/pip/_internal/metadata/base.py new file mode 100644 index 0000000..9eabcdb --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/metadata/base.py @@ -0,0 +1,688 @@ +import csv +import email.message +import functools +import json +import logging +import pathlib +import re +import zipfile +from typing import ( + IO, + Any, + Collection, + Container, + Dict, + Iterable, + Iterator, + List, + NamedTuple, + Optional, + Protocol, + Tuple, + Union, +) + +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.specifiers import InvalidSpecifier, SpecifierSet +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version + +from pip._internal.exceptions import NoneMetadataError +from pip._internal.locations import site_packages, user_site +from pip._internal.models.direct_url import ( + DIRECT_URL_METADATA_NAME, + DirectUrl, + DirectUrlValidationError, +) +from pip._internal.utils.compat import stdlib_pkgs # TODO: Move definition here. +from pip._internal.utils.egg_link import egg_link_path_from_sys_path +from pip._internal.utils.misc import is_local, normalize_path +from pip._internal.utils.urls import url_to_path + +from ._json import msg_to_json + +InfoPath = Union[str, pathlib.PurePath] + +logger = logging.getLogger(__name__) + + +class BaseEntryPoint(Protocol): + @property + def name(self) -> str: + raise NotImplementedError() + + @property + def value(self) -> str: + raise NotImplementedError() + + @property + def group(self) -> str: + raise NotImplementedError() + + +def _convert_installed_files_path( + entry: Tuple[str, ...], + info: Tuple[str, ...], +) -> str: + """Convert a legacy installed-files.txt path into modern RECORD path. + + The legacy format stores paths relative to the info directory, while the + modern format stores paths relative to the package root, e.g. the + site-packages directory. + + :param entry: Path parts of the installed-files.txt entry. + :param info: Path parts of the egg-info directory relative to package root. + :returns: The converted entry. + + For best compatibility with symlinks, this does not use ``abspath()`` or + ``Path.resolve()``, but tries to work with path parts: + + 1. While ``entry`` starts with ``..``, remove the equal amounts of parts + from ``info``; if ``info`` is empty, start appending ``..`` instead. + 2. Join the two directly. + """ + while entry and entry[0] == "..": + if not info or info[-1] == "..": + info += ("..",) + else: + info = info[:-1] + entry = entry[1:] + return str(pathlib.Path(*info, *entry)) + + +class RequiresEntry(NamedTuple): + requirement: str + extra: str + marker: str + + +class BaseDistribution(Protocol): + @classmethod + def from_directory(cls, directory: str) -> "BaseDistribution": + """Load the distribution from a metadata directory. + + :param directory: Path to a metadata directory, e.g. ``.dist-info``. + """ + raise NotImplementedError() + + @classmethod + def from_metadata_file_contents( + cls, + metadata_contents: bytes, + filename: str, + project_name: str, + ) -> "BaseDistribution": + """Load the distribution from the contents of a METADATA file. + + This is used to implement PEP 658 by generating a "shallow" dist object that can + be used for resolution without downloading or building the actual dist yet. + + :param metadata_contents: The contents of a METADATA file. + :param filename: File name for the dist with this metadata. + :param project_name: Name of the project this dist represents. + """ + raise NotImplementedError() + + @classmethod + def from_wheel(cls, wheel: "Wheel", name: str) -> "BaseDistribution": + """Load the distribution from a given wheel. + + :param wheel: A concrete wheel definition. + :param name: File name of the wheel. + + :raises InvalidWheel: Whenever loading of the wheel causes a + :py:exc:`zipfile.BadZipFile` exception to be thrown. + :raises UnsupportedWheel: If the wheel is a valid zip, but malformed + internally. + """ + raise NotImplementedError() + + def __repr__(self) -> str: + return f"{self.raw_name} {self.raw_version} ({self.location})" + + def __str__(self) -> str: + return f"{self.raw_name} {self.raw_version}" + + @property + def location(self) -> Optional[str]: + """Where the distribution is loaded from. + + A string value is not necessarily a filesystem path, since distributions + can be loaded from other sources, e.g. arbitrary zip archives. ``None`` + means the distribution is created in-memory. + + Do not canonicalize this value with e.g. ``pathlib.Path.resolve()``. If + this is a symbolic link, we want to preserve the relative path between + it and files in the distribution. + """ + raise NotImplementedError() + + @property + def editable_project_location(self) -> Optional[str]: + """The project location for editable distributions. + + This is the directory where pyproject.toml or setup.py is located. + None if the distribution is not installed in editable mode. + """ + # TODO: this property is relatively costly to compute, memoize it ? + direct_url = self.direct_url + if direct_url: + if direct_url.is_local_editable(): + return url_to_path(direct_url.url) + else: + # Search for an .egg-link file by walking sys.path, as it was + # done before by dist_is_editable(). + egg_link_path = egg_link_path_from_sys_path(self.raw_name) + if egg_link_path: + # TODO: get project location from second line of egg_link file + # (https://github.com/pypa/pip/issues/10243) + return self.location + return None + + @property + def installed_location(self) -> Optional[str]: + """The distribution's "installed" location. + + This should generally be a ``site-packages`` directory. This is + usually ``dist.location``, except for legacy develop-installed packages, + where ``dist.location`` is the source code location, and this is where + the ``.egg-link`` file is. + + The returned location is normalized (in particular, with symlinks removed). + """ + raise NotImplementedError() + + @property + def info_location(self) -> Optional[str]: + """Location of the .[egg|dist]-info directory or file. + + Similarly to ``location``, a string value is not necessarily a + filesystem path. ``None`` means the distribution is created in-memory. + + For a modern .dist-info installation on disk, this should be something + like ``{location}/{raw_name}-{version}.dist-info``. + + Do not canonicalize this value with e.g. ``pathlib.Path.resolve()``. If + this is a symbolic link, we want to preserve the relative path between + it and other files in the distribution. + """ + raise NotImplementedError() + + @property + def installed_by_distutils(self) -> bool: + """Whether this distribution is installed with legacy distutils format. + + A distribution installed with "raw" distutils not patched by setuptools + uses one single file at ``info_location`` to store metadata. We need to + treat this specially on uninstallation. + """ + info_location = self.info_location + if not info_location: + return False + return pathlib.Path(info_location).is_file() + + @property + def installed_as_egg(self) -> bool: + """Whether this distribution is installed as an egg. + + This usually indicates the distribution was installed by (older versions + of) easy_install. + """ + location = self.location + if not location: + return False + return location.endswith(".egg") + + @property + def installed_with_setuptools_egg_info(self) -> bool: + """Whether this distribution is installed with the ``.egg-info`` format. + + This usually indicates the distribution was installed with setuptools + with an old pip version or with ``single-version-externally-managed``. + + Note that this ensure the metadata store is a directory. distutils can + also installs an ``.egg-info``, but as a file, not a directory. This + property is *False* for that case. Also see ``installed_by_distutils``. + """ + info_location = self.info_location + if not info_location: + return False + if not info_location.endswith(".egg-info"): + return False + return pathlib.Path(info_location).is_dir() + + @property + def installed_with_dist_info(self) -> bool: + """Whether this distribution is installed with the "modern format". + + This indicates a "modern" installation, e.g. storing metadata in the + ``.dist-info`` directory. This applies to installations made by + setuptools (but through pip, not directly), or anything using the + standardized build backend interface (PEP 517). + """ + info_location = self.info_location + if not info_location: + return False + if not info_location.endswith(".dist-info"): + return False + return pathlib.Path(info_location).is_dir() + + @property + def canonical_name(self) -> NormalizedName: + raise NotImplementedError() + + @property + def version(self) -> Version: + raise NotImplementedError() + + @property + def raw_version(self) -> str: + raise NotImplementedError() + + @property + def setuptools_filename(self) -> str: + """Convert a project name to its setuptools-compatible filename. + + This is a copy of ``pkg_resources.to_filename()`` for compatibility. + """ + return self.raw_name.replace("-", "_") + + @property + def direct_url(self) -> Optional[DirectUrl]: + """Obtain a DirectUrl from this distribution. + + Returns None if the distribution has no `direct_url.json` metadata, + or if `direct_url.json` is invalid. + """ + try: + content = self.read_text(DIRECT_URL_METADATA_NAME) + except FileNotFoundError: + return None + try: + return DirectUrl.from_json(content) + except ( + UnicodeDecodeError, + json.JSONDecodeError, + DirectUrlValidationError, + ) as e: + logger.warning( + "Error parsing %s for %s: %s", + DIRECT_URL_METADATA_NAME, + self.canonical_name, + e, + ) + return None + + @property + def installer(self) -> str: + try: + installer_text = self.read_text("INSTALLER") + except (OSError, ValueError, NoneMetadataError): + return "" # Fail silently if the installer file cannot be read. + for line in installer_text.splitlines(): + cleaned_line = line.strip() + if cleaned_line: + return cleaned_line + return "" + + @property + def requested(self) -> bool: + return self.is_file("REQUESTED") + + @property + def editable(self) -> bool: + return bool(self.editable_project_location) + + @property + def local(self) -> bool: + """If distribution is installed in the current virtual environment. + + Always True if we're not in a virtualenv. + """ + if self.installed_location is None: + return False + return is_local(self.installed_location) + + @property + def in_usersite(self) -> bool: + if self.installed_location is None or user_site is None: + return False + return self.installed_location.startswith(normalize_path(user_site)) + + @property + def in_site_packages(self) -> bool: + if self.installed_location is None or site_packages is None: + return False + return self.installed_location.startswith(normalize_path(site_packages)) + + def is_file(self, path: InfoPath) -> bool: + """Check whether an entry in the info directory is a file.""" + raise NotImplementedError() + + def iter_distutils_script_names(self) -> Iterator[str]: + """Find distutils 'scripts' entries metadata. + + If 'scripts' is supplied in ``setup.py``, distutils records those in the + installed distribution's ``scripts`` directory, a file for each script. + """ + raise NotImplementedError() + + def read_text(self, path: InfoPath) -> str: + """Read a file in the info directory. + + :raise FileNotFoundError: If ``path`` does not exist in the directory. + :raise NoneMetadataError: If ``path`` exists in the info directory, but + cannot be read. + """ + raise NotImplementedError() + + def iter_entry_points(self) -> Iterable[BaseEntryPoint]: + raise NotImplementedError() + + def _metadata_impl(self) -> email.message.Message: + raise NotImplementedError() + + @functools.cached_property + def metadata(self) -> email.message.Message: + """Metadata of distribution parsed from e.g. METADATA or PKG-INFO. + + This should return an empty message if the metadata file is unavailable. + + :raises NoneMetadataError: If the metadata file is available, but does + not contain valid metadata. + """ + metadata = self._metadata_impl() + self._add_egg_info_requires(metadata) + return metadata + + @property + def metadata_dict(self) -> Dict[str, Any]: + """PEP 566 compliant JSON-serializable representation of METADATA or PKG-INFO. + + This should return an empty dict if the metadata file is unavailable. + + :raises NoneMetadataError: If the metadata file is available, but does + not contain valid metadata. + """ + return msg_to_json(self.metadata) + + @property + def metadata_version(self) -> Optional[str]: + """Value of "Metadata-Version:" in distribution metadata, if available.""" + return self.metadata.get("Metadata-Version") + + @property + def raw_name(self) -> str: + """Value of "Name:" in distribution metadata.""" + # The metadata should NEVER be missing the Name: key, but if it somehow + # does, fall back to the known canonical name. + return self.metadata.get("Name", self.canonical_name) + + @property + def requires_python(self) -> SpecifierSet: + """Value of "Requires-Python:" in distribution metadata. + + If the key does not exist or contains an invalid value, an empty + SpecifierSet should be returned. + """ + value = self.metadata.get("Requires-Python") + if value is None: + return SpecifierSet() + try: + # Convert to str to satisfy the type checker; this can be a Header object. + spec = SpecifierSet(str(value)) + except InvalidSpecifier as e: + message = "Package %r has an invalid Requires-Python: %s" + logger.warning(message, self.raw_name, e) + return SpecifierSet() + return spec + + def iter_dependencies(self, extras: Collection[str] = ()) -> Iterable[Requirement]: + """Dependencies of this distribution. + + For modern .dist-info distributions, this is the collection of + "Requires-Dist:" entries in distribution metadata. + """ + raise NotImplementedError() + + def iter_raw_dependencies(self) -> Iterable[str]: + """Raw Requires-Dist metadata.""" + return self.metadata.get_all("Requires-Dist", []) + + def iter_provided_extras(self) -> Iterable[NormalizedName]: + """Extras provided by this distribution. + + For modern .dist-info distributions, this is the collection of + "Provides-Extra:" entries in distribution metadata. + + The return value of this function is expected to be normalised names, + per PEP 685, with the returned value being handled appropriately by + `iter_dependencies`. + """ + raise NotImplementedError() + + def _iter_declared_entries_from_record(self) -> Optional[Iterator[str]]: + try: + text = self.read_text("RECORD") + except FileNotFoundError: + return None + # This extra Path-str cast normalizes entries. + return (str(pathlib.Path(row[0])) for row in csv.reader(text.splitlines())) + + def _iter_declared_entries_from_legacy(self) -> Optional[Iterator[str]]: + try: + text = self.read_text("installed-files.txt") + except FileNotFoundError: + return None + paths = (p for p in text.splitlines(keepends=False) if p) + root = self.location + info = self.info_location + if root is None or info is None: + return paths + try: + info_rel = pathlib.Path(info).relative_to(root) + except ValueError: # info is not relative to root. + return paths + if not info_rel.parts: # info *is* root. + return paths + return ( + _convert_installed_files_path(pathlib.Path(p).parts, info_rel.parts) + for p in paths + ) + + def iter_declared_entries(self) -> Optional[Iterator[str]]: + """Iterate through file entries declared in this distribution. + + For modern .dist-info distributions, this is the files listed in the + ``RECORD`` metadata file. For legacy setuptools distributions, this + comes from ``installed-files.txt``, with entries normalized to be + compatible with the format used by ``RECORD``. + + :return: An iterator for listed entries, or None if the distribution + contains neither ``RECORD`` nor ``installed-files.txt``. + """ + return ( + self._iter_declared_entries_from_record() + or self._iter_declared_entries_from_legacy() + ) + + def _iter_requires_txt_entries(self) -> Iterator[RequiresEntry]: + """Parse a ``requires.txt`` in an egg-info directory. + + This is an INI-ish format where an egg-info stores dependencies. A + section name describes extra other environment markers, while each entry + is an arbitrary string (not a key-value pair) representing a dependency + as a requirement string (no markers). + + There is a construct in ``importlib.metadata`` called ``Sectioned`` that + does mostly the same, but the format is currently considered private. + """ + try: + content = self.read_text("requires.txt") + except FileNotFoundError: + return + extra = marker = "" # Section-less entries don't have markers. + for line in content.splitlines(): + line = line.strip() + if not line or line.startswith("#"): # Comment; ignored. + continue + if line.startswith("[") and line.endswith("]"): # A section header. + extra, _, marker = line.strip("[]").partition(":") + continue + yield RequiresEntry(requirement=line, extra=extra, marker=marker) + + def _iter_egg_info_extras(self) -> Iterable[str]: + """Get extras from the egg-info directory.""" + known_extras = {""} + for entry in self._iter_requires_txt_entries(): + extra = canonicalize_name(entry.extra) + if extra in known_extras: + continue + known_extras.add(extra) + yield extra + + def _iter_egg_info_dependencies(self) -> Iterable[str]: + """Get distribution dependencies from the egg-info directory. + + To ease parsing, this converts a legacy dependency entry into a PEP 508 + requirement string. Like ``_iter_requires_txt_entries()``, there is code + in ``importlib.metadata`` that does mostly the same, but not do exactly + what we need. + + Namely, ``importlib.metadata`` does not normalize the extra name before + putting it into the requirement string, which causes marker comparison + to fail because the dist-info format do normalize. This is consistent in + all currently available PEP 517 backends, although not standardized. + """ + for entry in self._iter_requires_txt_entries(): + extra = canonicalize_name(entry.extra) + if extra and entry.marker: + marker = f'({entry.marker}) and extra == "{extra}"' + elif extra: + marker = f'extra == "{extra}"' + elif entry.marker: + marker = entry.marker + else: + marker = "" + if marker: + yield f"{entry.requirement} ; {marker}" + else: + yield entry.requirement + + def _add_egg_info_requires(self, metadata: email.message.Message) -> None: + """Add egg-info requires.txt information to the metadata.""" + if not metadata.get_all("Requires-Dist"): + for dep in self._iter_egg_info_dependencies(): + metadata["Requires-Dist"] = dep + if not metadata.get_all("Provides-Extra"): + for extra in self._iter_egg_info_extras(): + metadata["Provides-Extra"] = extra + + +class BaseEnvironment: + """An environment containing distributions to introspect.""" + + @classmethod + def default(cls) -> "BaseEnvironment": + raise NotImplementedError() + + @classmethod + def from_paths(cls, paths: Optional[List[str]]) -> "BaseEnvironment": + raise NotImplementedError() + + def get_distribution(self, name: str) -> Optional["BaseDistribution"]: + """Given a requirement name, return the installed distributions. + + The name may not be normalized. The implementation must canonicalize + it for lookup. + """ + raise NotImplementedError() + + def _iter_distributions(self) -> Iterator["BaseDistribution"]: + """Iterate through installed distributions. + + This function should be implemented by subclass, but never called + directly. Use the public ``iter_distribution()`` instead, which + implements additional logic to make sure the distributions are valid. + """ + raise NotImplementedError() + + def iter_all_distributions(self) -> Iterator[BaseDistribution]: + """Iterate through all installed distributions without any filtering.""" + for dist in self._iter_distributions(): + # Make sure the distribution actually comes from a valid Python + # packaging distribution. Pip's AdjacentTempDirectory leaves folders + # e.g. ``~atplotlib.dist-info`` if cleanup was interrupted. The + # valid project name pattern is taken from PEP 508. + project_name_valid = re.match( + r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", + dist.canonical_name, + flags=re.IGNORECASE, + ) + if not project_name_valid: + logger.warning( + "Ignoring invalid distribution %s (%s)", + dist.canonical_name, + dist.location, + ) + continue + yield dist + + def iter_installed_distributions( + self, + local_only: bool = True, + skip: Container[str] = stdlib_pkgs, + include_editables: bool = True, + editables_only: bool = False, + user_only: bool = False, + ) -> Iterator[BaseDistribution]: + """Return a list of installed distributions. + + This is based on ``iter_all_distributions()`` with additional filtering + options. Note that ``iter_installed_distributions()`` without arguments + is *not* equal to ``iter_all_distributions()``, since some of the + configurations exclude packages by default. + + :param local_only: If True (default), only return installations + local to the current virtualenv, if in a virtualenv. + :param skip: An iterable of canonicalized project names to ignore; + defaults to ``stdlib_pkgs``. + :param include_editables: If False, don't report editables. + :param editables_only: If True, only report editables. + :param user_only: If True, only report installations in the user + site directory. + """ + it = self.iter_all_distributions() + if local_only: + it = (d for d in it if d.local) + if not include_editables: + it = (d for d in it if not d.editable) + if editables_only: + it = (d for d in it if d.editable) + if user_only: + it = (d for d in it if d.in_usersite) + return (d for d in it if d.canonical_name not in skip) + + +class Wheel(Protocol): + location: str + + def as_zipfile(self) -> zipfile.ZipFile: + raise NotImplementedError() + + +class FilesystemWheel(Wheel): + def __init__(self, location: str) -> None: + self.location = location + + def as_zipfile(self) -> zipfile.ZipFile: + return zipfile.ZipFile(self.location, allowZip64=True) + + +class MemoryWheel(Wheel): + def __init__(self, location: str, stream: IO[bytes]) -> None: + self.location = location + self.stream = stream + + def as_zipfile(self) -> zipfile.ZipFile: + return zipfile.ZipFile(self.stream, allowZip64=True) diff --git a/env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__init__.py new file mode 100644 index 0000000..a779138 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__init__.py @@ -0,0 +1,6 @@ +from ._dists import Distribution +from ._envs import Environment + +__all__ = ["NAME", "Distribution", "Environment"] + +NAME = "importlib" diff --git a/env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_compat.py b/env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_compat.py new file mode 100644 index 0000000..ec1e815 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_compat.py @@ -0,0 +1,85 @@ +import importlib.metadata +import os +from typing import Any, Optional, Protocol, Tuple, cast + +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name + + +class BadMetadata(ValueError): + def __init__(self, dist: importlib.metadata.Distribution, *, reason: str) -> None: + self.dist = dist + self.reason = reason + + def __str__(self) -> str: + return f"Bad metadata in {self.dist} ({self.reason})" + + +class BasePath(Protocol): + """A protocol that various path objects conform. + + This exists because importlib.metadata uses both ``pathlib.Path`` and + ``zipfile.Path``, and we need a common base for type hints (Union does not + work well since ``zipfile.Path`` is too new for our linter setup). + + This does not mean to be exhaustive, but only contains things that present + in both classes *that we need*. + """ + + @property + def name(self) -> str: + raise NotImplementedError() + + @property + def parent(self) -> "BasePath": + raise NotImplementedError() + + +def get_info_location(d: importlib.metadata.Distribution) -> Optional[BasePath]: + """Find the path to the distribution's metadata directory. + + HACK: This relies on importlib.metadata's private ``_path`` attribute. Not + all distributions exist on disk, so importlib.metadata is correct to not + expose the attribute as public. But pip's code base is old and not as clean, + so we do this to avoid having to rewrite too many things. Hopefully we can + eliminate this some day. + """ + return getattr(d, "_path", None) + + +def parse_name_and_version_from_info_directory( + dist: importlib.metadata.Distribution, +) -> Tuple[Optional[str], Optional[str]]: + """Get a name and version from the metadata directory name. + + This is much faster than reading distribution metadata. + """ + info_location = get_info_location(dist) + if info_location is None: + return None, None + + stem, suffix = os.path.splitext(info_location.name) + if suffix == ".dist-info": + name, sep, version = stem.partition("-") + if sep: + return name, version + + if suffix == ".egg-info": + name = stem.split("-", 1)[0] + return name, None + + return None, None + + +def get_dist_canonical_name(dist: importlib.metadata.Distribution) -> NormalizedName: + """Get the distribution's normalized name. + + The ``name`` attribute is only available in Python 3.10 or later. We are + targeting exactly that, but Mypy does not know this. + """ + if name := parse_name_and_version_from_info_directory(dist)[0]: + return canonicalize_name(name) + + name = cast(Any, dist).name + if not isinstance(name, str): + raise BadMetadata(dist, reason="invalid metadata entry 'name'") + return canonicalize_name(name) diff --git a/env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_dists.py b/env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_dists.py new file mode 100644 index 0000000..d220b61 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_dists.py @@ -0,0 +1,228 @@ +import email.message +import importlib.metadata +import pathlib +import zipfile +from os import PathLike +from typing import ( + Collection, + Dict, + Iterable, + Iterator, + Mapping, + Optional, + Sequence, + Union, + cast, +) + +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.exceptions import InvalidWheel, UnsupportedWheel +from pip._internal.metadata.base import ( + BaseDistribution, + BaseEntryPoint, + InfoPath, + Wheel, +) +from pip._internal.utils.misc import normalize_path +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.wheel import parse_wheel, read_wheel_metadata_file + +from ._compat import ( + BasePath, + get_dist_canonical_name, + parse_name_and_version_from_info_directory, +) + + +class WheelDistribution(importlib.metadata.Distribution): + """An ``importlib.metadata.Distribution`` read from a wheel. + + Although ``importlib.metadata.PathDistribution`` accepts ``zipfile.Path``, + its implementation is too "lazy" for pip's needs (we can't keep the ZipFile + handle open for the entire lifetime of the distribution object). + + This implementation eagerly reads the entire metadata directory into the + memory instead, and operates from that. + """ + + def __init__( + self, + files: Mapping[pathlib.PurePosixPath, bytes], + info_location: pathlib.PurePosixPath, + ) -> None: + self._files = files + self.info_location = info_location + + @classmethod + def from_zipfile( + cls, + zf: zipfile.ZipFile, + name: str, + location: str, + ) -> "WheelDistribution": + info_dir, _ = parse_wheel(zf, name) + paths = ( + (name, pathlib.PurePosixPath(name.split("/", 1)[-1])) + for name in zf.namelist() + if name.startswith(f"{info_dir}/") + ) + files = { + relpath: read_wheel_metadata_file(zf, fullpath) + for fullpath, relpath in paths + } + info_location = pathlib.PurePosixPath(location, info_dir) + return cls(files, info_location) + + def iterdir(self, path: InfoPath) -> Iterator[pathlib.PurePosixPath]: + # Only allow iterating through the metadata directory. + if pathlib.PurePosixPath(str(path)) in self._files: + return iter(self._files) + raise FileNotFoundError(path) + + def read_text(self, filename: str) -> Optional[str]: + try: + data = self._files[pathlib.PurePosixPath(filename)] + except KeyError: + return None + try: + text = data.decode("utf-8") + except UnicodeDecodeError as e: + wheel = self.info_location.parent + error = f"Error decoding metadata for {wheel}: {e} in {filename} file" + raise UnsupportedWheel(error) + return text + + def locate_file(self, path: Union[str, "PathLike[str]"]) -> pathlib.Path: + # This method doesn't make sense for our in-memory wheel, but the API + # requires us to define it. + raise NotImplementedError + + +class Distribution(BaseDistribution): + def __init__( + self, + dist: importlib.metadata.Distribution, + info_location: Optional[BasePath], + installed_location: Optional[BasePath], + ) -> None: + self._dist = dist + self._info_location = info_location + self._installed_location = installed_location + + @classmethod + def from_directory(cls, directory: str) -> BaseDistribution: + info_location = pathlib.Path(directory) + dist = importlib.metadata.Distribution.at(info_location) + return cls(dist, info_location, info_location.parent) + + @classmethod + def from_metadata_file_contents( + cls, + metadata_contents: bytes, + filename: str, + project_name: str, + ) -> BaseDistribution: + # Generate temp dir to contain the metadata file, and write the file contents. + temp_dir = pathlib.Path( + TempDirectory(kind="metadata", globally_managed=True).path + ) + metadata_path = temp_dir / "METADATA" + metadata_path.write_bytes(metadata_contents) + # Construct dist pointing to the newly created directory. + dist = importlib.metadata.Distribution.at(metadata_path.parent) + return cls(dist, metadata_path.parent, None) + + @classmethod + def from_wheel(cls, wheel: Wheel, name: str) -> BaseDistribution: + try: + with wheel.as_zipfile() as zf: + dist = WheelDistribution.from_zipfile(zf, name, wheel.location) + except zipfile.BadZipFile as e: + raise InvalidWheel(wheel.location, name) from e + return cls(dist, dist.info_location, pathlib.PurePosixPath(wheel.location)) + + @property + def location(self) -> Optional[str]: + if self._info_location is None: + return None + return str(self._info_location.parent) + + @property + def info_location(self) -> Optional[str]: + if self._info_location is None: + return None + return str(self._info_location) + + @property + def installed_location(self) -> Optional[str]: + if self._installed_location is None: + return None + return normalize_path(str(self._installed_location)) + + @property + def canonical_name(self) -> NormalizedName: + return get_dist_canonical_name(self._dist) + + @property + def version(self) -> Version: + if version := parse_name_and_version_from_info_directory(self._dist)[1]: + return parse_version(version) + return parse_version(self._dist.version) + + @property + def raw_version(self) -> str: + return self._dist.version + + def is_file(self, path: InfoPath) -> bool: + return self._dist.read_text(str(path)) is not None + + def iter_distutils_script_names(self) -> Iterator[str]: + # A distutils installation is always "flat" (not in e.g. egg form), so + # if this distribution's info location is NOT a pathlib.Path (but e.g. + # zipfile.Path), it can never contain any distutils scripts. + if not isinstance(self._info_location, pathlib.Path): + return + for child in self._info_location.joinpath("scripts").iterdir(): + yield child.name + + def read_text(self, path: InfoPath) -> str: + content = self._dist.read_text(str(path)) + if content is None: + raise FileNotFoundError(path) + return content + + def iter_entry_points(self) -> Iterable[BaseEntryPoint]: + # importlib.metadata's EntryPoint structure satisfies BaseEntryPoint. + return self._dist.entry_points + + def _metadata_impl(self) -> email.message.Message: + # From Python 3.10+, importlib.metadata declares PackageMetadata as the + # return type. This protocol is unfortunately a disaster now and misses + # a ton of fields that we need, including get() and get_payload(). We + # rely on the implementation that the object is actually a Message now, + # until upstream can improve the protocol. (python/cpython#94952) + return cast(email.message.Message, self._dist.metadata) + + def iter_provided_extras(self) -> Iterable[NormalizedName]: + return [ + canonicalize_name(extra) + for extra in self.metadata.get_all("Provides-Extra", []) + ] + + def iter_dependencies(self, extras: Collection[str] = ()) -> Iterable[Requirement]: + contexts: Sequence[Dict[str, str]] = [{"extra": e} for e in extras] + for req_string in self.metadata.get_all("Requires-Dist", []): + # strip() because email.message.Message.get_all() may return a leading \n + # in case a long header was wrapped. + req = get_requirement(req_string.strip()) + if not req.marker: + yield req + elif not extras and req.marker.evaluate({"extra": ""}): + yield req + elif any(req.marker.evaluate(context) for context in contexts): + yield req diff --git a/env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_envs.py b/env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_envs.py new file mode 100644 index 0000000..4d906fd --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_envs.py @@ -0,0 +1,189 @@ +import functools +import importlib.metadata +import logging +import os +import pathlib +import sys +import zipfile +import zipimport +from typing import Iterator, List, Optional, Sequence, Set, Tuple + +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name + +from pip._internal.metadata.base import BaseDistribution, BaseEnvironment +from pip._internal.models.wheel import Wheel +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.filetypes import WHEEL_EXTENSION + +from ._compat import BadMetadata, BasePath, get_dist_canonical_name, get_info_location +from ._dists import Distribution + +logger = logging.getLogger(__name__) + + +def _looks_like_wheel(location: str) -> bool: + if not location.endswith(WHEEL_EXTENSION): + return False + if not os.path.isfile(location): + return False + if not Wheel.wheel_file_re.match(os.path.basename(location)): + return False + return zipfile.is_zipfile(location) + + +class _DistributionFinder: + """Finder to locate distributions. + + The main purpose of this class is to memoize found distributions' names, so + only one distribution is returned for each package name. At lot of pip code + assumes this (because it is setuptools's behavior), and not doing the same + can potentially cause a distribution in lower precedence path to override a + higher precedence one if the caller is not careful. + + Eventually we probably want to make it possible to see lower precedence + installations as well. It's useful feature, after all. + """ + + FoundResult = Tuple[importlib.metadata.Distribution, Optional[BasePath]] + + def __init__(self) -> None: + self._found_names: Set[NormalizedName] = set() + + def _find_impl(self, location: str) -> Iterator[FoundResult]: + """Find distributions in a location.""" + # Skip looking inside a wheel. Since a package inside a wheel is not + # always valid (due to .data directories etc.), its .dist-info entry + # should not be considered an installed distribution. + if _looks_like_wheel(location): + return + # To know exactly where we find a distribution, we have to feed in the + # paths one by one, instead of dumping the list to importlib.metadata. + for dist in importlib.metadata.distributions(path=[location]): + info_location = get_info_location(dist) + try: + name = get_dist_canonical_name(dist) + except BadMetadata as e: + logger.warning("Skipping %s due to %s", info_location, e.reason) + continue + if name in self._found_names: + continue + self._found_names.add(name) + yield dist, info_location + + def find(self, location: str) -> Iterator[BaseDistribution]: + """Find distributions in a location. + + The path can be either a directory, or a ZIP archive. + """ + for dist, info_location in self._find_impl(location): + if info_location is None: + installed_location: Optional[BasePath] = None + else: + installed_location = info_location.parent + yield Distribution(dist, info_location, installed_location) + + def find_linked(self, location: str) -> Iterator[BaseDistribution]: + """Read location in egg-link files and return distributions in there. + + The path should be a directory; otherwise this returns nothing. This + follows how setuptools does this for compatibility. The first non-empty + line in the egg-link is read as a path (resolved against the egg-link's + containing directory if relative). Distributions found at that linked + location are returned. + """ + path = pathlib.Path(location) + if not path.is_dir(): + return + for child in path.iterdir(): + if child.suffix != ".egg-link": + continue + with child.open() as f: + lines = (line.strip() for line in f) + target_rel = next((line for line in lines if line), "") + if not target_rel: + continue + target_location = str(path.joinpath(target_rel)) + for dist, info_location in self._find_impl(target_location): + yield Distribution(dist, info_location, path) + + def _find_eggs_in_dir(self, location: str) -> Iterator[BaseDistribution]: + from pip._vendor.pkg_resources import find_distributions + + from pip._internal.metadata import pkg_resources as legacy + + with os.scandir(location) as it: + for entry in it: + if not entry.name.endswith(".egg"): + continue + for dist in find_distributions(entry.path): + yield legacy.Distribution(dist) + + def _find_eggs_in_zip(self, location: str) -> Iterator[BaseDistribution]: + from pip._vendor.pkg_resources import find_eggs_in_zip + + from pip._internal.metadata import pkg_resources as legacy + + try: + importer = zipimport.zipimporter(location) + except zipimport.ZipImportError: + return + for dist in find_eggs_in_zip(importer, location): + yield legacy.Distribution(dist) + + def find_eggs(self, location: str) -> Iterator[BaseDistribution]: + """Find eggs in a location. + + This actually uses the old *pkg_resources* backend. We likely want to + deprecate this so we can eventually remove the *pkg_resources* + dependency entirely. Before that, this should first emit a deprecation + warning for some versions when using the fallback since importing + *pkg_resources* is slow for those who don't need it. + """ + if os.path.isdir(location): + yield from self._find_eggs_in_dir(location) + if zipfile.is_zipfile(location): + yield from self._find_eggs_in_zip(location) + + +@functools.lru_cache(maxsize=None) # Warn a distribution exactly once. +def _emit_egg_deprecation(location: Optional[str]) -> None: + deprecated( + reason=f"Loading egg at {location} is deprecated.", + replacement="to use pip for package installation", + gone_in="25.1", + issue=12330, + ) + + +class Environment(BaseEnvironment): + def __init__(self, paths: Sequence[str]) -> None: + self._paths = paths + + @classmethod + def default(cls) -> BaseEnvironment: + return cls(sys.path) + + @classmethod + def from_paths(cls, paths: Optional[List[str]]) -> BaseEnvironment: + if paths is None: + return cls(sys.path) + return cls(paths) + + def _iter_distributions(self) -> Iterator[BaseDistribution]: + finder = _DistributionFinder() + for location in self._paths: + yield from finder.find(location) + for dist in finder.find_eggs(location): + _emit_egg_deprecation(dist.location) + yield dist + # This must go last because that's how pkg_resources tie-breaks. + yield from finder.find_linked(location) + + def get_distribution(self, name: str) -> Optional[BaseDistribution]: + canonical_name = canonicalize_name(name) + matches = ( + distribution + for distribution in self.iter_all_distributions() + if distribution.canonical_name == canonical_name + ) + return next(matches, None) diff --git a/env/lib/python3.12/site-packages/pip/_internal/metadata/pkg_resources.py b/env/lib/python3.12/site-packages/pip/_internal/metadata/pkg_resources.py new file mode 100644 index 0000000..4ea84f9 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/metadata/pkg_resources.py @@ -0,0 +1,301 @@ +import email.message +import email.parser +import logging +import os +import zipfile +from typing import ( + Collection, + Iterable, + Iterator, + List, + Mapping, + NamedTuple, + Optional, +) + +from pip._vendor import pkg_resources +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.exceptions import InvalidWheel, NoneMetadataError, UnsupportedWheel +from pip._internal.utils.egg_link import egg_link_path_from_location +from pip._internal.utils.misc import display_path, normalize_path +from pip._internal.utils.wheel import parse_wheel, read_wheel_metadata_file + +from .base import ( + BaseDistribution, + BaseEntryPoint, + BaseEnvironment, + InfoPath, + Wheel, +) + +__all__ = ["NAME", "Distribution", "Environment"] + +logger = logging.getLogger(__name__) + +NAME = "pkg_resources" + + +class EntryPoint(NamedTuple): + name: str + value: str + group: str + + +class InMemoryMetadata: + """IMetadataProvider that reads metadata files from a dictionary. + + This also maps metadata decoding exceptions to our internal exception type. + """ + + def __init__(self, metadata: Mapping[str, bytes], wheel_name: str) -> None: + self._metadata = metadata + self._wheel_name = wheel_name + + def has_metadata(self, name: str) -> bool: + return name in self._metadata + + def get_metadata(self, name: str) -> str: + try: + return self._metadata[name].decode() + except UnicodeDecodeError as e: + # Augment the default error with the origin of the file. + raise UnsupportedWheel( + f"Error decoding metadata for {self._wheel_name}: {e} in {name} file" + ) + + def get_metadata_lines(self, name: str) -> Iterable[str]: + return pkg_resources.yield_lines(self.get_metadata(name)) + + def metadata_isdir(self, name: str) -> bool: + return False + + def metadata_listdir(self, name: str) -> List[str]: + return [] + + def run_script(self, script_name: str, namespace: str) -> None: + pass + + +class Distribution(BaseDistribution): + def __init__(self, dist: pkg_resources.Distribution) -> None: + self._dist = dist + # This is populated lazily, to avoid loading metadata for all possible + # distributions eagerly. + self.__extra_mapping: Optional[Mapping[NormalizedName, str]] = None + + @property + def _extra_mapping(self) -> Mapping[NormalizedName, str]: + if self.__extra_mapping is None: + self.__extra_mapping = { + canonicalize_name(extra): extra for extra in self._dist.extras + } + + return self.__extra_mapping + + @classmethod + def from_directory(cls, directory: str) -> BaseDistribution: + dist_dir = directory.rstrip(os.sep) + + # Build a PathMetadata object, from path to metadata. :wink: + base_dir, dist_dir_name = os.path.split(dist_dir) + metadata = pkg_resources.PathMetadata(base_dir, dist_dir) + + # Determine the correct Distribution object type. + if dist_dir.endswith(".egg-info"): + dist_cls = pkg_resources.Distribution + dist_name = os.path.splitext(dist_dir_name)[0] + else: + assert dist_dir.endswith(".dist-info") + dist_cls = pkg_resources.DistInfoDistribution + dist_name = os.path.splitext(dist_dir_name)[0].split("-")[0] + + dist = dist_cls(base_dir, project_name=dist_name, metadata=metadata) + return cls(dist) + + @classmethod + def from_metadata_file_contents( + cls, + metadata_contents: bytes, + filename: str, + project_name: str, + ) -> BaseDistribution: + metadata_dict = { + "METADATA": metadata_contents, + } + dist = pkg_resources.DistInfoDistribution( + location=filename, + metadata=InMemoryMetadata(metadata_dict, filename), + project_name=project_name, + ) + return cls(dist) + + @classmethod + def from_wheel(cls, wheel: Wheel, name: str) -> BaseDistribution: + try: + with wheel.as_zipfile() as zf: + info_dir, _ = parse_wheel(zf, name) + metadata_dict = { + path.split("/", 1)[-1]: read_wheel_metadata_file(zf, path) + for path in zf.namelist() + if path.startswith(f"{info_dir}/") + } + except zipfile.BadZipFile as e: + raise InvalidWheel(wheel.location, name) from e + except UnsupportedWheel as e: + raise UnsupportedWheel(f"{name} has an invalid wheel, {e}") + dist = pkg_resources.DistInfoDistribution( + location=wheel.location, + metadata=InMemoryMetadata(metadata_dict, wheel.location), + project_name=name, + ) + return cls(dist) + + @property + def location(self) -> Optional[str]: + return self._dist.location + + @property + def installed_location(self) -> Optional[str]: + egg_link = egg_link_path_from_location(self.raw_name) + if egg_link: + location = egg_link + elif self.location: + location = self.location + else: + return None + return normalize_path(location) + + @property + def info_location(self) -> Optional[str]: + return self._dist.egg_info + + @property + def installed_by_distutils(self) -> bool: + # A distutils-installed distribution is provided by FileMetadata. This + # provider has a "path" attribute not present anywhere else. Not the + # best introspection logic, but pip has been doing this for a long time. + try: + return bool(self._dist._provider.path) + except AttributeError: + return False + + @property + def canonical_name(self) -> NormalizedName: + return canonicalize_name(self._dist.project_name) + + @property + def version(self) -> Version: + return parse_version(self._dist.version) + + @property + def raw_version(self) -> str: + return self._dist.version + + def is_file(self, path: InfoPath) -> bool: + return self._dist.has_metadata(str(path)) + + def iter_distutils_script_names(self) -> Iterator[str]: + yield from self._dist.metadata_listdir("scripts") + + def read_text(self, path: InfoPath) -> str: + name = str(path) + if not self._dist.has_metadata(name): + raise FileNotFoundError(name) + content = self._dist.get_metadata(name) + if content is None: + raise NoneMetadataError(self, name) + return content + + def iter_entry_points(self) -> Iterable[BaseEntryPoint]: + for group, entries in self._dist.get_entry_map().items(): + for name, entry_point in entries.items(): + name, _, value = str(entry_point).partition("=") + yield EntryPoint(name=name.strip(), value=value.strip(), group=group) + + def _metadata_impl(self) -> email.message.Message: + """ + :raises NoneMetadataError: if the distribution reports `has_metadata()` + True but `get_metadata()` returns None. + """ + if isinstance(self._dist, pkg_resources.DistInfoDistribution): + metadata_name = "METADATA" + else: + metadata_name = "PKG-INFO" + try: + metadata = self.read_text(metadata_name) + except FileNotFoundError: + if self.location: + displaying_path = display_path(self.location) + else: + displaying_path = repr(self.location) + logger.warning("No metadata found in %s", displaying_path) + metadata = "" + feed_parser = email.parser.FeedParser() + feed_parser.feed(metadata) + return feed_parser.close() + + def iter_dependencies(self, extras: Collection[str] = ()) -> Iterable[Requirement]: + if extras: + relevant_extras = set(self._extra_mapping) & set( + map(canonicalize_name, extras) + ) + extras = [self._extra_mapping[extra] for extra in relevant_extras] + return self._dist.requires(extras) + + def iter_provided_extras(self) -> Iterable[NormalizedName]: + return self._extra_mapping.keys() + + +class Environment(BaseEnvironment): + def __init__(self, ws: pkg_resources.WorkingSet) -> None: + self._ws = ws + + @classmethod + def default(cls) -> BaseEnvironment: + return cls(pkg_resources.working_set) + + @classmethod + def from_paths(cls, paths: Optional[List[str]]) -> BaseEnvironment: + return cls(pkg_resources.WorkingSet(paths)) + + def _iter_distributions(self) -> Iterator[BaseDistribution]: + for dist in self._ws: + yield Distribution(dist) + + def _search_distribution(self, name: str) -> Optional[BaseDistribution]: + """Find a distribution matching the ``name`` in the environment. + + This searches from *all* distributions available in the environment, to + match the behavior of ``pkg_resources.get_distribution()``. + """ + canonical_name = canonicalize_name(name) + for dist in self.iter_all_distributions(): + if dist.canonical_name == canonical_name: + return dist + return None + + def get_distribution(self, name: str) -> Optional[BaseDistribution]: + # Search the distribution by looking through the working set. + dist = self._search_distribution(name) + if dist: + return dist + + # If distribution could not be found, call working_set.require to + # update the working set, and try to find the distribution again. + # This might happen for e.g. when you install a package twice, once + # using setup.py develop and again using setup.py install. Now when + # running pip uninstall twice, the package gets removed from the + # working set in the first uninstall, so we have to populate the + # working set again so that pip knows about it and the packages gets + # picked up and is successfully uninstalled the second time too. + try: + # We didn't pass in any version specifiers, so this can never + # raise pkg_resources.VersionConflict. + self._ws.require(name) + except pkg_resources.DistributionNotFound: + return None + return self._search_distribution(name) diff --git a/env/lib/python3.12/site-packages/pip/_internal/models/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/models/__init__.py new file mode 100644 index 0000000..7855226 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/models/__init__.py @@ -0,0 +1,2 @@ +"""A package that contains models that represent entities. +""" diff --git a/env/lib/python3.12/site-packages/pip/_internal/models/candidate.py b/env/lib/python3.12/site-packages/pip/_internal/models/candidate.py new file mode 100644 index 0000000..f27f283 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/models/candidate.py @@ -0,0 +1,25 @@ +from dataclasses import dataclass + +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.models.link import Link + + +@dataclass(frozen=True) +class InstallationCandidate: + """Represents a potential "candidate" for installation.""" + + __slots__ = ["name", "version", "link"] + + name: str + version: Version + link: Link + + def __init__(self, name: str, version: str, link: Link) -> None: + object.__setattr__(self, "name", name) + object.__setattr__(self, "version", parse_version(version)) + object.__setattr__(self, "link", link) + + def __str__(self) -> str: + return f"{self.name!r} candidate (version {self.version} at {self.link})" diff --git a/env/lib/python3.12/site-packages/pip/_internal/models/direct_url.py b/env/lib/python3.12/site-packages/pip/_internal/models/direct_url.py new file mode 100644 index 0000000..fc5ec8d --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/models/direct_url.py @@ -0,0 +1,224 @@ +""" PEP 610 """ + +import json +import re +import urllib.parse +from dataclasses import dataclass +from typing import Any, ClassVar, Dict, Iterable, Optional, Type, TypeVar, Union + +__all__ = [ + "DirectUrl", + "DirectUrlValidationError", + "DirInfo", + "ArchiveInfo", + "VcsInfo", +] + +T = TypeVar("T") + +DIRECT_URL_METADATA_NAME = "direct_url.json" +ENV_VAR_RE = re.compile(r"^\$\{[A-Za-z0-9-_]+\}(:\$\{[A-Za-z0-9-_]+\})?$") + + +class DirectUrlValidationError(Exception): + pass + + +def _get( + d: Dict[str, Any], expected_type: Type[T], key: str, default: Optional[T] = None +) -> Optional[T]: + """Get value from dictionary and verify expected type.""" + if key not in d: + return default + value = d[key] + if not isinstance(value, expected_type): + raise DirectUrlValidationError( + f"{value!r} has unexpected type for {key} (expected {expected_type})" + ) + return value + + +def _get_required( + d: Dict[str, Any], expected_type: Type[T], key: str, default: Optional[T] = None +) -> T: + value = _get(d, expected_type, key, default) + if value is None: + raise DirectUrlValidationError(f"{key} must have a value") + return value + + +def _exactly_one_of(infos: Iterable[Optional["InfoType"]]) -> "InfoType": + infos = [info for info in infos if info is not None] + if not infos: + raise DirectUrlValidationError( + "missing one of archive_info, dir_info, vcs_info" + ) + if len(infos) > 1: + raise DirectUrlValidationError( + "more than one of archive_info, dir_info, vcs_info" + ) + assert infos[0] is not None + return infos[0] + + +def _filter_none(**kwargs: Any) -> Dict[str, Any]: + """Make dict excluding None values.""" + return {k: v for k, v in kwargs.items() if v is not None} + + +@dataclass +class VcsInfo: + name: ClassVar = "vcs_info" + + vcs: str + commit_id: str + requested_revision: Optional[str] = None + + @classmethod + def _from_dict(cls, d: Optional[Dict[str, Any]]) -> Optional["VcsInfo"]: + if d is None: + return None + return cls( + vcs=_get_required(d, str, "vcs"), + commit_id=_get_required(d, str, "commit_id"), + requested_revision=_get(d, str, "requested_revision"), + ) + + def _to_dict(self) -> Dict[str, Any]: + return _filter_none( + vcs=self.vcs, + requested_revision=self.requested_revision, + commit_id=self.commit_id, + ) + + +class ArchiveInfo: + name = "archive_info" + + def __init__( + self, + hash: Optional[str] = None, + hashes: Optional[Dict[str, str]] = None, + ) -> None: + # set hashes before hash, since the hash setter will further populate hashes + self.hashes = hashes + self.hash = hash + + @property + def hash(self) -> Optional[str]: + return self._hash + + @hash.setter + def hash(self, value: Optional[str]) -> None: + if value is not None: + # Auto-populate the hashes key to upgrade to the new format automatically. + # We don't back-populate the legacy hash key from hashes. + try: + hash_name, hash_value = value.split("=", 1) + except ValueError: + raise DirectUrlValidationError( + f"invalid archive_info.hash format: {value!r}" + ) + if self.hashes is None: + self.hashes = {hash_name: hash_value} + elif hash_name not in self.hashes: + self.hashes = self.hashes.copy() + self.hashes[hash_name] = hash_value + self._hash = value + + @classmethod + def _from_dict(cls, d: Optional[Dict[str, Any]]) -> Optional["ArchiveInfo"]: + if d is None: + return None + return cls(hash=_get(d, str, "hash"), hashes=_get(d, dict, "hashes")) + + def _to_dict(self) -> Dict[str, Any]: + return _filter_none(hash=self.hash, hashes=self.hashes) + + +@dataclass +class DirInfo: + name: ClassVar = "dir_info" + + editable: bool = False + + @classmethod + def _from_dict(cls, d: Optional[Dict[str, Any]]) -> Optional["DirInfo"]: + if d is None: + return None + return cls(editable=_get_required(d, bool, "editable", default=False)) + + def _to_dict(self) -> Dict[str, Any]: + return _filter_none(editable=self.editable or None) + + +InfoType = Union[ArchiveInfo, DirInfo, VcsInfo] + + +@dataclass +class DirectUrl: + url: str + info: InfoType + subdirectory: Optional[str] = None + + def _remove_auth_from_netloc(self, netloc: str) -> str: + if "@" not in netloc: + return netloc + user_pass, netloc_no_user_pass = netloc.split("@", 1) + if ( + isinstance(self.info, VcsInfo) + and self.info.vcs == "git" + and user_pass == "git" + ): + return netloc + if ENV_VAR_RE.match(user_pass): + return netloc + return netloc_no_user_pass + + @property + def redacted_url(self) -> str: + """url with user:password part removed unless it is formed with + environment variables as specified in PEP 610, or it is ``git`` + in the case of a git URL. + """ + purl = urllib.parse.urlsplit(self.url) + netloc = self._remove_auth_from_netloc(purl.netloc) + surl = urllib.parse.urlunsplit( + (purl.scheme, netloc, purl.path, purl.query, purl.fragment) + ) + return surl + + def validate(self) -> None: + self.from_dict(self.to_dict()) + + @classmethod + def from_dict(cls, d: Dict[str, Any]) -> "DirectUrl": + return DirectUrl( + url=_get_required(d, str, "url"), + subdirectory=_get(d, str, "subdirectory"), + info=_exactly_one_of( + [ + ArchiveInfo._from_dict(_get(d, dict, "archive_info")), + DirInfo._from_dict(_get(d, dict, "dir_info")), + VcsInfo._from_dict(_get(d, dict, "vcs_info")), + ] + ), + ) + + def to_dict(self) -> Dict[str, Any]: + res = _filter_none( + url=self.redacted_url, + subdirectory=self.subdirectory, + ) + res[self.info.name] = self.info._to_dict() + return res + + @classmethod + def from_json(cls, s: str) -> "DirectUrl": + return cls.from_dict(json.loads(s)) + + def to_json(self) -> str: + return json.dumps(self.to_dict(), sort_keys=True) + + def is_local_editable(self) -> bool: + return isinstance(self.info, DirInfo) and self.info.editable diff --git a/env/lib/python3.12/site-packages/pip/_internal/models/format_control.py b/env/lib/python3.12/site-packages/pip/_internal/models/format_control.py new file mode 100644 index 0000000..ccd1127 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/models/format_control.py @@ -0,0 +1,78 @@ +from typing import FrozenSet, Optional, Set + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import CommandError + + +class FormatControl: + """Helper for managing formats from which a package can be installed.""" + + __slots__ = ["no_binary", "only_binary"] + + def __init__( + self, + no_binary: Optional[Set[str]] = None, + only_binary: Optional[Set[str]] = None, + ) -> None: + if no_binary is None: + no_binary = set() + if only_binary is None: + only_binary = set() + + self.no_binary = no_binary + self.only_binary = only_binary + + def __eq__(self, other: object) -> bool: + if not isinstance(other, self.__class__): + return NotImplemented + + if self.__slots__ != other.__slots__: + return False + + return all(getattr(self, k) == getattr(other, k) for k in self.__slots__) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.no_binary}, {self.only_binary})" + + @staticmethod + def handle_mutual_excludes(value: str, target: Set[str], other: Set[str]) -> None: + if value.startswith("-"): + raise CommandError( + "--no-binary / --only-binary option requires 1 argument." + ) + new = value.split(",") + while ":all:" in new: + other.clear() + target.clear() + target.add(":all:") + del new[: new.index(":all:") + 1] + # Without a none, we want to discard everything as :all: covers it + if ":none:" not in new: + return + for name in new: + if name == ":none:": + target.clear() + continue + name = canonicalize_name(name) + other.discard(name) + target.add(name) + + def get_allowed_formats(self, canonical_name: str) -> FrozenSet[str]: + result = {"binary", "source"} + if canonical_name in self.only_binary: + result.discard("source") + elif canonical_name in self.no_binary: + result.discard("binary") + elif ":all:" in self.only_binary: + result.discard("source") + elif ":all:" in self.no_binary: + result.discard("binary") + return frozenset(result) + + def disallow_binaries(self) -> None: + self.handle_mutual_excludes( + ":all:", + self.no_binary, + self.only_binary, + ) diff --git a/env/lib/python3.12/site-packages/pip/_internal/models/index.py b/env/lib/python3.12/site-packages/pip/_internal/models/index.py new file mode 100644 index 0000000..b94c325 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/models/index.py @@ -0,0 +1,28 @@ +import urllib.parse + + +class PackageIndex: + """Represents a Package Index and provides easier access to endpoints""" + + __slots__ = ["url", "netloc", "simple_url", "pypi_url", "file_storage_domain"] + + def __init__(self, url: str, file_storage_domain: str) -> None: + super().__init__() + self.url = url + self.netloc = urllib.parse.urlsplit(url).netloc + self.simple_url = self._url_for_path("simple") + self.pypi_url = self._url_for_path("pypi") + + # This is part of a temporary hack used to block installs of PyPI + # packages which depend on external urls only necessary until PyPI can + # block such packages themselves + self.file_storage_domain = file_storage_domain + + def _url_for_path(self, path: str) -> str: + return urllib.parse.urljoin(self.url, path) + + +PyPI = PackageIndex("https://pypi.org/", file_storage_domain="files.pythonhosted.org") +TestPyPI = PackageIndex( + "https://test.pypi.org/", file_storage_domain="test-files.pythonhosted.org" +) diff --git a/env/lib/python3.12/site-packages/pip/_internal/models/installation_report.py b/env/lib/python3.12/site-packages/pip/_internal/models/installation_report.py new file mode 100644 index 0000000..b9c6330 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/models/installation_report.py @@ -0,0 +1,56 @@ +from typing import Any, Dict, Sequence + +from pip._vendor.packaging.markers import default_environment + +from pip import __version__ +from pip._internal.req.req_install import InstallRequirement + + +class InstallationReport: + def __init__(self, install_requirements: Sequence[InstallRequirement]): + self._install_requirements = install_requirements + + @classmethod + def _install_req_to_dict(cls, ireq: InstallRequirement) -> Dict[str, Any]: + assert ireq.download_info, f"No download_info for {ireq}" + res = { + # PEP 610 json for the download URL. download_info.archive_info.hashes may + # be absent when the requirement was installed from the wheel cache + # and the cache entry was populated by an older pip version that did not + # record origin.json. + "download_info": ireq.download_info.to_dict(), + # is_direct is true if the requirement was a direct URL reference (which + # includes editable requirements), and false if the requirement was + # downloaded from a PEP 503 index or --find-links. + "is_direct": ireq.is_direct, + # is_yanked is true if the requirement was yanked from the index, but + # was still selected by pip to conform to PEP 592. + "is_yanked": ireq.link.is_yanked if ireq.link else False, + # requested is true if the requirement was specified by the user (aka + # top level requirement), and false if it was installed as a dependency of a + # requirement. https://peps.python.org/pep-0376/#requested + "requested": ireq.user_supplied, + # PEP 566 json encoding for metadata + # https://www.python.org/dev/peps/pep-0566/#json-compatible-metadata + "metadata": ireq.get_dist().metadata_dict, + } + if ireq.user_supplied and ireq.extras: + # For top level requirements, the list of requested extras, if any. + res["requested_extras"] = sorted(ireq.extras) + return res + + def to_dict(self) -> Dict[str, Any]: + return { + "version": "1", + "pip_version": __version__, + "install": [ + self._install_req_to_dict(ireq) for ireq in self._install_requirements + ], + # https://peps.python.org/pep-0508/#environment-markers + # TODO: currently, the resolver uses the default environment to evaluate + # environment markers, so that is what we report here. In the future, it + # should also take into account options such as --python-version or + # --platform, perhaps under the form of an environment_override field? + # https://github.com/pypa/pip/issues/11198 + "environment": default_environment(), + } diff --git a/env/lib/python3.12/site-packages/pip/_internal/models/link.py b/env/lib/python3.12/site-packages/pip/_internal/models/link.py new file mode 100644 index 0000000..27ad016 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/models/link.py @@ -0,0 +1,604 @@ +import functools +import itertools +import logging +import os +import posixpath +import re +import urllib.parse +from dataclasses import dataclass +from typing import ( + TYPE_CHECKING, + Any, + Dict, + List, + Mapping, + NamedTuple, + Optional, + Tuple, + Union, +) + +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.filetypes import WHEEL_EXTENSION +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.misc import ( + pairwise, + redact_auth_from_url, + split_auth_from_netloc, + splitext, +) +from pip._internal.utils.urls import path_to_url, url_to_path + +if TYPE_CHECKING: + from pip._internal.index.collector import IndexContent + +logger = logging.getLogger(__name__) + + +# Order matters, earlier hashes have a precedence over later hashes for what +# we will pick to use. +_SUPPORTED_HASHES = ("sha512", "sha384", "sha256", "sha224", "sha1", "md5") + + +@dataclass(frozen=True) +class LinkHash: + """Links to content may have embedded hash values. This class parses those. + + `name` must be any member of `_SUPPORTED_HASHES`. + + This class can be converted to and from `ArchiveInfo`. While ArchiveInfo intends to + be JSON-serializable to conform to PEP 610, this class contains the logic for + parsing a hash name and value for correctness, and then checking whether that hash + conforms to a schema with `.is_hash_allowed()`.""" + + name: str + value: str + + _hash_url_fragment_re = re.compile( + # NB: we do not validate that the second group (.*) is a valid hex + # digest. Instead, we simply keep that string in this class, and then check it + # against Hashes when hash-checking is needed. This is easier to debug than + # proactively discarding an invalid hex digest, as we handle incorrect hashes + # and malformed hashes in the same place. + r"[#&]({choices})=([^&]*)".format( + choices="|".join(re.escape(hash_name) for hash_name in _SUPPORTED_HASHES) + ), + ) + + def __post_init__(self) -> None: + assert self.name in _SUPPORTED_HASHES + + @classmethod + @functools.lru_cache(maxsize=None) + def find_hash_url_fragment(cls, url: str) -> Optional["LinkHash"]: + """Search a string for a checksum algorithm name and encoded output value.""" + match = cls._hash_url_fragment_re.search(url) + if match is None: + return None + name, value = match.groups() + return cls(name=name, value=value) + + def as_dict(self) -> Dict[str, str]: + return {self.name: self.value} + + def as_hashes(self) -> Hashes: + """Return a Hashes instance which checks only for the current hash.""" + return Hashes({self.name: [self.value]}) + + def is_hash_allowed(self, hashes: Optional[Hashes]) -> bool: + """ + Return True if the current hash is allowed by `hashes`. + """ + if hashes is None: + return False + return hashes.is_hash_allowed(self.name, hex_digest=self.value) + + +@dataclass(frozen=True) +class MetadataFile: + """Information about a core metadata file associated with a distribution.""" + + hashes: Optional[Dict[str, str]] + + def __post_init__(self) -> None: + if self.hashes is not None: + assert all(name in _SUPPORTED_HASHES for name in self.hashes) + + +def supported_hashes(hashes: Optional[Dict[str, str]]) -> Optional[Dict[str, str]]: + # Remove any unsupported hash types from the mapping. If this leaves no + # supported hashes, return None + if hashes is None: + return None + hashes = {n: v for n, v in hashes.items() if n in _SUPPORTED_HASHES} + if not hashes: + return None + return hashes + + +def _clean_url_path_part(part: str) -> str: + """ + Clean a "part" of a URL path (i.e. after splitting on "@" characters). + """ + # We unquote prior to quoting to make sure nothing is double quoted. + return urllib.parse.quote(urllib.parse.unquote(part)) + + +def _clean_file_url_path(part: str) -> str: + """ + Clean the first part of a URL path that corresponds to a local + filesystem path (i.e. the first part after splitting on "@" characters). + """ + # We unquote prior to quoting to make sure nothing is double quoted. + # Also, on Windows the path part might contain a drive letter which + # should not be quoted. On Linux where drive letters do not + # exist, the colon should be quoted. We rely on urllib.request + # to do the right thing here. + return urllib.request.pathname2url(urllib.request.url2pathname(part)) + + +# percent-encoded: / +_reserved_chars_re = re.compile("(@|%2F)", re.IGNORECASE) + + +def _clean_url_path(path: str, is_local_path: bool) -> str: + """ + Clean the path portion of a URL. + """ + if is_local_path: + clean_func = _clean_file_url_path + else: + clean_func = _clean_url_path_part + + # Split on the reserved characters prior to cleaning so that + # revision strings in VCS URLs are properly preserved. + parts = _reserved_chars_re.split(path) + + cleaned_parts = [] + for to_clean, reserved in pairwise(itertools.chain(parts, [""])): + cleaned_parts.append(clean_func(to_clean)) + # Normalize %xx escapes (e.g. %2f -> %2F) + cleaned_parts.append(reserved.upper()) + + return "".join(cleaned_parts) + + +def _ensure_quoted_url(url: str) -> str: + """ + Make sure a link is fully quoted. + For example, if ' ' occurs in the URL, it will be replaced with "%20", + and without double-quoting other characters. + """ + # Split the URL into parts according to the general structure + # `scheme://netloc/path?query#fragment`. + result = urllib.parse.urlsplit(url) + # If the netloc is empty, then the URL refers to a local filesystem path. + is_local_path = not result.netloc + path = _clean_url_path(result.path, is_local_path=is_local_path) + return urllib.parse.urlunsplit(result._replace(path=path)) + + +def _absolute_link_url(base_url: str, url: str) -> str: + """ + A faster implementation of urllib.parse.urljoin with a shortcut + for absolute http/https URLs. + """ + if url.startswith(("https://", "http://")): + return url + else: + return urllib.parse.urljoin(base_url, url) + + +@functools.total_ordering +class Link: + """Represents a parsed link from a Package Index's simple URL""" + + __slots__ = [ + "_parsed_url", + "_url", + "_path", + "_hashes", + "comes_from", + "requires_python", + "yanked_reason", + "metadata_file_data", + "cache_link_parsing", + "egg_fragment", + ] + + def __init__( + self, + url: str, + comes_from: Optional[Union[str, "IndexContent"]] = None, + requires_python: Optional[str] = None, + yanked_reason: Optional[str] = None, + metadata_file_data: Optional[MetadataFile] = None, + cache_link_parsing: bool = True, + hashes: Optional[Mapping[str, str]] = None, + ) -> None: + """ + :param url: url of the resource pointed to (href of the link) + :param comes_from: instance of IndexContent where the link was found, + or string. + :param requires_python: String containing the `Requires-Python` + metadata field, specified in PEP 345. This may be specified by + a data-requires-python attribute in the HTML link tag, as + described in PEP 503. + :param yanked_reason: the reason the file has been yanked, if the + file has been yanked, or None if the file hasn't been yanked. + This is the value of the "data-yanked" attribute, if present, in + a simple repository HTML link. If the file has been yanked but + no reason was provided, this should be the empty string. See + PEP 592 for more information and the specification. + :param metadata_file_data: the metadata attached to the file, or None if + no such metadata is provided. This argument, if not None, indicates + that a separate metadata file exists, and also optionally supplies + hashes for that file. + :param cache_link_parsing: A flag that is used elsewhere to determine + whether resources retrieved from this link should be cached. PyPI + URLs should generally have this set to False, for example. + :param hashes: A mapping of hash names to digests to allow us to + determine the validity of a download. + """ + + # The comes_from, requires_python, and metadata_file_data arguments are + # only used by classmethods of this class, and are not used in client + # code directly. + + # url can be a UNC windows share + if url.startswith("\\\\"): + url = path_to_url(url) + + self._parsed_url = urllib.parse.urlsplit(url) + # Store the url as a private attribute to prevent accidentally + # trying to set a new value. + self._url = url + # The .path property is hot, so calculate its value ahead of time. + self._path = urllib.parse.unquote(self._parsed_url.path) + + link_hash = LinkHash.find_hash_url_fragment(url) + hashes_from_link = {} if link_hash is None else link_hash.as_dict() + if hashes is None: + self._hashes = hashes_from_link + else: + self._hashes = {**hashes, **hashes_from_link} + + self.comes_from = comes_from + self.requires_python = requires_python if requires_python else None + self.yanked_reason = yanked_reason + self.metadata_file_data = metadata_file_data + + self.cache_link_parsing = cache_link_parsing + self.egg_fragment = self._egg_fragment() + + @classmethod + def from_json( + cls, + file_data: Dict[str, Any], + page_url: str, + ) -> Optional["Link"]: + """ + Convert an pypi json document from a simple repository page into a Link. + """ + file_url = file_data.get("url") + if file_url is None: + return None + + url = _ensure_quoted_url(_absolute_link_url(page_url, file_url)) + pyrequire = file_data.get("requires-python") + yanked_reason = file_data.get("yanked") + hashes = file_data.get("hashes", {}) + + # PEP 714: Indexes must use the name core-metadata, but + # clients should support the old name as a fallback for compatibility. + metadata_info = file_data.get("core-metadata") + if metadata_info is None: + metadata_info = file_data.get("dist-info-metadata") + + # The metadata info value may be a boolean, or a dict of hashes. + if isinstance(metadata_info, dict): + # The file exists, and hashes have been supplied + metadata_file_data = MetadataFile(supported_hashes(metadata_info)) + elif metadata_info: + # The file exists, but there are no hashes + metadata_file_data = MetadataFile(None) + else: + # False or not present: the file does not exist + metadata_file_data = None + + # The Link.yanked_reason expects an empty string instead of a boolean. + if yanked_reason and not isinstance(yanked_reason, str): + yanked_reason = "" + # The Link.yanked_reason expects None instead of False. + elif not yanked_reason: + yanked_reason = None + + return cls( + url, + comes_from=page_url, + requires_python=pyrequire, + yanked_reason=yanked_reason, + hashes=hashes, + metadata_file_data=metadata_file_data, + ) + + @classmethod + def from_element( + cls, + anchor_attribs: Dict[str, Optional[str]], + page_url: str, + base_url: str, + ) -> Optional["Link"]: + """ + Convert an anchor element's attributes in a simple repository page to a Link. + """ + href = anchor_attribs.get("href") + if not href: + return None + + url = _ensure_quoted_url(_absolute_link_url(base_url, href)) + pyrequire = anchor_attribs.get("data-requires-python") + yanked_reason = anchor_attribs.get("data-yanked") + + # PEP 714: Indexes must use the name data-core-metadata, but + # clients should support the old name as a fallback for compatibility. + metadata_info = anchor_attribs.get("data-core-metadata") + if metadata_info is None: + metadata_info = anchor_attribs.get("data-dist-info-metadata") + # The metadata info value may be the string "true", or a string of + # the form "hashname=hashval" + if metadata_info == "true": + # The file exists, but there are no hashes + metadata_file_data = MetadataFile(None) + elif metadata_info is None: + # The file does not exist + metadata_file_data = None + else: + # The file exists, and hashes have been supplied + hashname, sep, hashval = metadata_info.partition("=") + if sep == "=": + metadata_file_data = MetadataFile(supported_hashes({hashname: hashval})) + else: + # Error - data is wrong. Treat as no hashes supplied. + logger.debug( + "Index returned invalid data-dist-info-metadata value: %s", + metadata_info, + ) + metadata_file_data = MetadataFile(None) + + return cls( + url, + comes_from=page_url, + requires_python=pyrequire, + yanked_reason=yanked_reason, + metadata_file_data=metadata_file_data, + ) + + def __str__(self) -> str: + if self.requires_python: + rp = f" (requires-python:{self.requires_python})" + else: + rp = "" + if self.comes_from: + return f"{redact_auth_from_url(self._url)} (from {self.comes_from}){rp}" + else: + return redact_auth_from_url(str(self._url)) + + def __repr__(self) -> str: + return f"" + + def __hash__(self) -> int: + return hash(self.url) + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, Link): + return NotImplemented + return self.url == other.url + + def __lt__(self, other: Any) -> bool: + if not isinstance(other, Link): + return NotImplemented + return self.url < other.url + + @property + def url(self) -> str: + return self._url + + @property + def filename(self) -> str: + path = self.path.rstrip("/") + name = posixpath.basename(path) + if not name: + # Make sure we don't leak auth information if the netloc + # includes a username and password. + netloc, user_pass = split_auth_from_netloc(self.netloc) + return netloc + + name = urllib.parse.unquote(name) + assert name, f"URL {self._url!r} produced no filename" + return name + + @property + def file_path(self) -> str: + return url_to_path(self.url) + + @property + def scheme(self) -> str: + return self._parsed_url.scheme + + @property + def netloc(self) -> str: + """ + This can contain auth information. + """ + return self._parsed_url.netloc + + @property + def path(self) -> str: + return self._path + + def splitext(self) -> Tuple[str, str]: + return splitext(posixpath.basename(self.path.rstrip("/"))) + + @property + def ext(self) -> str: + return self.splitext()[1] + + @property + def url_without_fragment(self) -> str: + scheme, netloc, path, query, fragment = self._parsed_url + return urllib.parse.urlunsplit((scheme, netloc, path, query, "")) + + _egg_fragment_re = re.compile(r"[#&]egg=([^&]*)") + + # Per PEP 508. + _project_name_re = re.compile( + r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", re.IGNORECASE + ) + + def _egg_fragment(self) -> Optional[str]: + match = self._egg_fragment_re.search(self._url) + if not match: + return None + + # An egg fragment looks like a PEP 508 project name, along with + # an optional extras specifier. Anything else is invalid. + project_name = match.group(1) + if not self._project_name_re.match(project_name): + deprecated( + reason=f"{self} contains an egg fragment with a non-PEP 508 name.", + replacement="to use the req @ url syntax, and remove the egg fragment", + gone_in="25.1", + issue=13157, + ) + + return project_name + + _subdirectory_fragment_re = re.compile(r"[#&]subdirectory=([^&]*)") + + @property + def subdirectory_fragment(self) -> Optional[str]: + match = self._subdirectory_fragment_re.search(self._url) + if not match: + return None + return match.group(1) + + def metadata_link(self) -> Optional["Link"]: + """Return a link to the associated core metadata file (if any).""" + if self.metadata_file_data is None: + return None + metadata_url = f"{self.url_without_fragment}.metadata" + if self.metadata_file_data.hashes is None: + return Link(metadata_url) + return Link(metadata_url, hashes=self.metadata_file_data.hashes) + + def as_hashes(self) -> Hashes: + return Hashes({k: [v] for k, v in self._hashes.items()}) + + @property + def hash(self) -> Optional[str]: + return next(iter(self._hashes.values()), None) + + @property + def hash_name(self) -> Optional[str]: + return next(iter(self._hashes), None) + + @property + def show_url(self) -> str: + return posixpath.basename(self._url.split("#", 1)[0].split("?", 1)[0]) + + @property + def is_file(self) -> bool: + return self.scheme == "file" + + def is_existing_dir(self) -> bool: + return self.is_file and os.path.isdir(self.file_path) + + @property + def is_wheel(self) -> bool: + return self.ext == WHEEL_EXTENSION + + @property + def is_vcs(self) -> bool: + from pip._internal.vcs import vcs + + return self.scheme in vcs.all_schemes + + @property + def is_yanked(self) -> bool: + return self.yanked_reason is not None + + @property + def has_hash(self) -> bool: + return bool(self._hashes) + + def is_hash_allowed(self, hashes: Optional[Hashes]) -> bool: + """ + Return True if the link has a hash and it is allowed by `hashes`. + """ + if hashes is None: + return False + return any(hashes.is_hash_allowed(k, v) for k, v in self._hashes.items()) + + +class _CleanResult(NamedTuple): + """Convert link for equivalency check. + + This is used in the resolver to check whether two URL-specified requirements + likely point to the same distribution and can be considered equivalent. This + equivalency logic avoids comparing URLs literally, which can be too strict + (e.g. "a=1&b=2" vs "b=2&a=1") and produce conflicts unexpecting to users. + + Currently this does three things: + + 1. Drop the basic auth part. This is technically wrong since a server can + serve different content based on auth, but if it does that, it is even + impossible to guarantee two URLs without auth are equivalent, since + the user can input different auth information when prompted. So the + practical solution is to assume the auth doesn't affect the response. + 2. Parse the query to avoid the ordering issue. Note that ordering under the + same key in the query are NOT cleaned; i.e. "a=1&a=2" and "a=2&a=1" are + still considered different. + 3. Explicitly drop most of the fragment part, except ``subdirectory=`` and + hash values, since it should have no impact the downloaded content. Note + that this drops the "egg=" part historically used to denote the requested + project (and extras), which is wrong in the strictest sense, but too many + people are supplying it inconsistently to cause superfluous resolution + conflicts, so we choose to also ignore them. + """ + + parsed: urllib.parse.SplitResult + query: Dict[str, List[str]] + subdirectory: str + hashes: Dict[str, str] + + +def _clean_link(link: Link) -> _CleanResult: + parsed = link._parsed_url + netloc = parsed.netloc.rsplit("@", 1)[-1] + # According to RFC 8089, an empty host in file: means localhost. + if parsed.scheme == "file" and not netloc: + netloc = "localhost" + fragment = urllib.parse.parse_qs(parsed.fragment) + if "egg" in fragment: + logger.debug("Ignoring egg= fragment in %s", link) + try: + # If there are multiple subdirectory values, use the first one. + # This matches the behavior of Link.subdirectory_fragment. + subdirectory = fragment["subdirectory"][0] + except (IndexError, KeyError): + subdirectory = "" + # If there are multiple hash values under the same algorithm, use the + # first one. This matches the behavior of Link.hash_value. + hashes = {k: fragment[k][0] for k in _SUPPORTED_HASHES if k in fragment} + return _CleanResult( + parsed=parsed._replace(netloc=netloc, query="", fragment=""), + query=urllib.parse.parse_qs(parsed.query), + subdirectory=subdirectory, + hashes=hashes, + ) + + +@functools.lru_cache(maxsize=None) +def links_equivalent(link1: Link, link2: Link) -> bool: + return _clean_link(link1) == _clean_link(link2) diff --git a/env/lib/python3.12/site-packages/pip/_internal/models/scheme.py b/env/lib/python3.12/site-packages/pip/_internal/models/scheme.py new file mode 100644 index 0000000..06a9a55 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/models/scheme.py @@ -0,0 +1,25 @@ +""" +For types associated with installation schemes. + +For a general overview of available schemes and their context, see +https://docs.python.org/3/install/index.html#alternate-installation. +""" + +from dataclasses import dataclass + +SCHEME_KEYS = ["platlib", "purelib", "headers", "scripts", "data"] + + +@dataclass(frozen=True) +class Scheme: + """A Scheme holds paths which are used as the base directories for + artifacts associated with a Python package. + """ + + __slots__ = SCHEME_KEYS + + platlib: str + purelib: str + headers: str + scripts: str + data: str diff --git a/env/lib/python3.12/site-packages/pip/_internal/models/search_scope.py b/env/lib/python3.12/site-packages/pip/_internal/models/search_scope.py new file mode 100644 index 0000000..ee7bc86 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/models/search_scope.py @@ -0,0 +1,127 @@ +import itertools +import logging +import os +import posixpath +import urllib.parse +from dataclasses import dataclass +from typing import List + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.models.index import PyPI +from pip._internal.utils.compat import has_tls +from pip._internal.utils.misc import normalize_path, redact_auth_from_url + +logger = logging.getLogger(__name__) + + +@dataclass(frozen=True) +class SearchScope: + """ + Encapsulates the locations that pip is configured to search. + """ + + __slots__ = ["find_links", "index_urls", "no_index"] + + find_links: List[str] + index_urls: List[str] + no_index: bool + + @classmethod + def create( + cls, + find_links: List[str], + index_urls: List[str], + no_index: bool, + ) -> "SearchScope": + """ + Create a SearchScope object after normalizing the `find_links`. + """ + # Build find_links. If an argument starts with ~, it may be + # a local file relative to a home directory. So try normalizing + # it and if it exists, use the normalized version. + # This is deliberately conservative - it might be fine just to + # blindly normalize anything starting with a ~... + built_find_links: List[str] = [] + for link in find_links: + if link.startswith("~"): + new_link = normalize_path(link) + if os.path.exists(new_link): + link = new_link + built_find_links.append(link) + + # If we don't have TLS enabled, then WARN if anyplace we're looking + # relies on TLS. + if not has_tls(): + for link in itertools.chain(index_urls, built_find_links): + parsed = urllib.parse.urlparse(link) + if parsed.scheme == "https": + logger.warning( + "pip is configured with locations that require " + "TLS/SSL, however the ssl module in Python is not " + "available." + ) + break + + return cls( + find_links=built_find_links, + index_urls=index_urls, + no_index=no_index, + ) + + def get_formatted_locations(self) -> str: + lines = [] + redacted_index_urls = [] + if self.index_urls and self.index_urls != [PyPI.simple_url]: + for url in self.index_urls: + redacted_index_url = redact_auth_from_url(url) + + # Parse the URL + purl = urllib.parse.urlsplit(redacted_index_url) + + # URL is generally invalid if scheme and netloc is missing + # there are issues with Python and URL parsing, so this test + # is a bit crude. See bpo-20271, bpo-23505. Python doesn't + # always parse invalid URLs correctly - it should raise + # exceptions for malformed URLs + if not purl.scheme and not purl.netloc: + logger.warning( + 'The index url "%s" seems invalid, please provide a scheme.', + redacted_index_url, + ) + + redacted_index_urls.append(redacted_index_url) + + lines.append( + "Looking in indexes: {}".format(", ".join(redacted_index_urls)) + ) + + if self.find_links: + lines.append( + "Looking in links: {}".format( + ", ".join(redact_auth_from_url(url) for url in self.find_links) + ) + ) + return "\n".join(lines) + + def get_index_urls_locations(self, project_name: str) -> List[str]: + """Returns the locations found via self.index_urls + + Checks the url_name on the main (first in the list) index and + use this url_name to produce all locations + """ + + def mkurl_pypi_url(url: str) -> str: + loc = posixpath.join( + url, urllib.parse.quote(canonicalize_name(project_name)) + ) + # For maximum compatibility with easy_install, ensure the path + # ends in a trailing slash. Although this isn't in the spec + # (and PyPI can handle it without the slash) some other index + # implementations might break if they relied on easy_install's + # behavior. + if not loc.endswith("/"): + loc = loc + "/" + return loc + + return [mkurl_pypi_url(url) for url in self.index_urls] diff --git a/env/lib/python3.12/site-packages/pip/_internal/models/selection_prefs.py b/env/lib/python3.12/site-packages/pip/_internal/models/selection_prefs.py new file mode 100644 index 0000000..e9b50aa --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/models/selection_prefs.py @@ -0,0 +1,53 @@ +from typing import Optional + +from pip._internal.models.format_control import FormatControl + + +# TODO: This needs Python 3.10's improved slots support for dataclasses +# to be converted into a dataclass. +class SelectionPreferences: + """ + Encapsulates the candidate selection preferences for downloading + and installing files. + """ + + __slots__ = [ + "allow_yanked", + "allow_all_prereleases", + "format_control", + "prefer_binary", + "ignore_requires_python", + ] + + # Don't include an allow_yanked default value to make sure each call + # site considers whether yanked releases are allowed. This also causes + # that decision to be made explicit in the calling code, which helps + # people when reading the code. + def __init__( + self, + allow_yanked: bool, + allow_all_prereleases: bool = False, + format_control: Optional[FormatControl] = None, + prefer_binary: bool = False, + ignore_requires_python: Optional[bool] = None, + ) -> None: + """Create a SelectionPreferences object. + + :param allow_yanked: Whether files marked as yanked (in the sense + of PEP 592) are permitted to be candidates for install. + :param format_control: A FormatControl object or None. Used to control + the selection of source packages / binary packages when consulting + the index and links. + :param prefer_binary: Whether to prefer an old, but valid, binary + dist over a new source dist. + :param ignore_requires_python: Whether to ignore incompatible + "Requires-Python" values in links. Defaults to False. + """ + if ignore_requires_python is None: + ignore_requires_python = False + + self.allow_yanked = allow_yanked + self.allow_all_prereleases = allow_all_prereleases + self.format_control = format_control + self.prefer_binary = prefer_binary + self.ignore_requires_python = ignore_requires_python diff --git a/env/lib/python3.12/site-packages/pip/_internal/models/target_python.py b/env/lib/python3.12/site-packages/pip/_internal/models/target_python.py new file mode 100644 index 0000000..88925a9 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/models/target_python.py @@ -0,0 +1,121 @@ +import sys +from typing import List, Optional, Set, Tuple + +from pip._vendor.packaging.tags import Tag + +from pip._internal.utils.compatibility_tags import get_supported, version_info_to_nodot +from pip._internal.utils.misc import normalize_version_info + + +class TargetPython: + """ + Encapsulates the properties of a Python interpreter one is targeting + for a package install, download, etc. + """ + + __slots__ = [ + "_given_py_version_info", + "abis", + "implementation", + "platforms", + "py_version", + "py_version_info", + "_valid_tags", + "_valid_tags_set", + ] + + def __init__( + self, + platforms: Optional[List[str]] = None, + py_version_info: Optional[Tuple[int, ...]] = None, + abis: Optional[List[str]] = None, + implementation: Optional[str] = None, + ) -> None: + """ + :param platforms: A list of strings or None. If None, searches for + packages that are supported by the current system. Otherwise, will + find packages that can be built on the platforms passed in. These + packages will only be downloaded for distribution: they will + not be built locally. + :param py_version_info: An optional tuple of ints representing the + Python version information to use (e.g. `sys.version_info[:3]`). + This can have length 1, 2, or 3 when provided. + :param abis: A list of strings or None. This is passed to + compatibility_tags.py's get_supported() function as is. + :param implementation: A string or None. This is passed to + compatibility_tags.py's get_supported() function as is. + """ + # Store the given py_version_info for when we call get_supported(). + self._given_py_version_info = py_version_info + + if py_version_info is None: + py_version_info = sys.version_info[:3] + else: + py_version_info = normalize_version_info(py_version_info) + + py_version = ".".join(map(str, py_version_info[:2])) + + self.abis = abis + self.implementation = implementation + self.platforms = platforms + self.py_version = py_version + self.py_version_info = py_version_info + + # This is used to cache the return value of get_(un)sorted_tags. + self._valid_tags: Optional[List[Tag]] = None + self._valid_tags_set: Optional[Set[Tag]] = None + + def format_given(self) -> str: + """ + Format the given, non-None attributes for display. + """ + display_version = None + if self._given_py_version_info is not None: + display_version = ".".join( + str(part) for part in self._given_py_version_info + ) + + key_values = [ + ("platforms", self.platforms), + ("version_info", display_version), + ("abis", self.abis), + ("implementation", self.implementation), + ] + return " ".join( + f"{key}={value!r}" for key, value in key_values if value is not None + ) + + def get_sorted_tags(self) -> List[Tag]: + """ + Return the supported PEP 425 tags to check wheel candidates against. + + The tags are returned in order of preference (most preferred first). + """ + if self._valid_tags is None: + # Pass versions=None if no py_version_info was given since + # versions=None uses special default logic. + py_version_info = self._given_py_version_info + if py_version_info is None: + version = None + else: + version = version_info_to_nodot(py_version_info) + + tags = get_supported( + version=version, + platforms=self.platforms, + abis=self.abis, + impl=self.implementation, + ) + self._valid_tags = tags + + return self._valid_tags + + def get_unsorted_tags(self) -> Set[Tag]: + """Exactly the same as get_sorted_tags, but returns a set. + + This is important for performance. + """ + if self._valid_tags_set is None: + self._valid_tags_set = set(self.get_sorted_tags()) + + return self._valid_tags_set diff --git a/env/lib/python3.12/site-packages/pip/_internal/models/wheel.py b/env/lib/python3.12/site-packages/pip/_internal/models/wheel.py new file mode 100644 index 0000000..ea85600 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/models/wheel.py @@ -0,0 +1,118 @@ +"""Represents a wheel file and provides access to the various parts of the +name that have meaning. +""" + +import re +from typing import Dict, Iterable, List + +from pip._vendor.packaging.tags import Tag +from pip._vendor.packaging.utils import ( + InvalidWheelFilename as PackagingInvalidWheelName, +) +from pip._vendor.packaging.utils import parse_wheel_filename + +from pip._internal.exceptions import InvalidWheelFilename +from pip._internal.utils.deprecation import deprecated + + +class Wheel: + """A wheel file""" + + wheel_file_re = re.compile( + r"""^(?P(?P[^\s-]+?)-(?P[^\s-]*?)) + ((-(?P\d[^-]*?))?-(?P[^\s-]+?)-(?P[^\s-]+?)-(?P[^\s-]+?) + \.whl|\.dist-info)$""", + re.VERBOSE, + ) + + def __init__(self, filename: str) -> None: + """ + :raises InvalidWheelFilename: when the filename is invalid for a wheel + """ + wheel_info = self.wheel_file_re.match(filename) + if not wheel_info: + raise InvalidWheelFilename(f"{filename} is not a valid wheel filename.") + self.filename = filename + self.name = wheel_info.group("name").replace("_", "-") + _version = wheel_info.group("ver") + if "_" in _version: + try: + parse_wheel_filename(filename) + except PackagingInvalidWheelName as e: + deprecated( + reason=( + f"Wheel filename {filename!r} is not correctly normalised. " + "Future versions of pip will raise the following error:\n" + f"{e.args[0]}\n\n" + ), + replacement=( + "to rename the wheel to use a correctly normalised " + "name (this may require updating the version in " + "the project metadata)" + ), + gone_in="25.1", + issue=12938, + ) + + _version = _version.replace("_", "-") + + self.version = _version + self.build_tag = wheel_info.group("build") + self.pyversions = wheel_info.group("pyver").split(".") + self.abis = wheel_info.group("abi").split(".") + self.plats = wheel_info.group("plat").split(".") + + # All the tag combinations from this file + self.file_tags = { + Tag(x, y, z) for x in self.pyversions for y in self.abis for z in self.plats + } + + def get_formatted_file_tags(self) -> List[str]: + """Return the wheel's tags as a sorted list of strings.""" + return sorted(str(tag) for tag in self.file_tags) + + def support_index_min(self, tags: List[Tag]) -> int: + """Return the lowest index that one of the wheel's file_tag combinations + achieves in the given list of supported tags. + + For example, if there are 8 supported tags and one of the file tags + is first in the list, then return 0. + + :param tags: the PEP 425 tags to check the wheel against, in order + with most preferred first. + + :raises ValueError: If none of the wheel's file tags match one of + the supported tags. + """ + try: + return next(i for i, t in enumerate(tags) if t in self.file_tags) + except StopIteration: + raise ValueError() + + def find_most_preferred_tag( + self, tags: List[Tag], tag_to_priority: Dict[Tag, int] + ) -> int: + """Return the priority of the most preferred tag that one of the wheel's file + tag combinations achieves in the given list of supported tags using the given + tag_to_priority mapping, where lower priorities are more-preferred. + + This is used in place of support_index_min in some cases in order to avoid + an expensive linear scan of a large list of tags. + + :param tags: the PEP 425 tags to check the wheel against. + :param tag_to_priority: a mapping from tag to priority of that tag, where + lower is more preferred. + + :raises ValueError: If none of the wheel's file tags match one of + the supported tags. + """ + return min( + tag_to_priority[tag] for tag in self.file_tags if tag in tag_to_priority + ) + + def supported(self, tags: Iterable[Tag]) -> bool: + """Return whether the wheel is compatible with one of the given tags. + + :param tags: the PEP 425 tags to check the wheel against. + """ + return not self.file_tags.isdisjoint(tags) diff --git a/env/lib/python3.12/site-packages/pip/_internal/network/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/network/__init__.py new file mode 100644 index 0000000..b51bde9 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/network/__init__.py @@ -0,0 +1,2 @@ +"""Contains purely network-related utilities. +""" diff --git a/env/lib/python3.12/site-packages/pip/_internal/network/auth.py b/env/lib/python3.12/site-packages/pip/_internal/network/auth.py new file mode 100644 index 0000000..1a2606e --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/network/auth.py @@ -0,0 +1,566 @@ +"""Network Authentication Helpers + +Contains interface (MultiDomainBasicAuth) and associated glue code for +providing credentials in the context of network requests. +""" + +import logging +import os +import shutil +import subprocess +import sysconfig +import typing +import urllib.parse +from abc import ABC, abstractmethod +from functools import lru_cache +from os.path import commonprefix +from pathlib import Path +from typing import Any, Dict, List, NamedTuple, Optional, Tuple + +from pip._vendor.requests.auth import AuthBase, HTTPBasicAuth +from pip._vendor.requests.models import Request, Response +from pip._vendor.requests.utils import get_netrc_auth + +from pip._internal.utils.logging import getLogger +from pip._internal.utils.misc import ( + ask, + ask_input, + ask_password, + remove_auth_from_url, + split_auth_netloc_from_url, +) +from pip._internal.vcs.versioncontrol import AuthInfo + +logger = getLogger(__name__) + +KEYRING_DISABLED = False + + +class Credentials(NamedTuple): + url: str + username: str + password: str + + +class KeyRingBaseProvider(ABC): + """Keyring base provider interface""" + + has_keyring: bool + + @abstractmethod + def get_auth_info( + self, url: str, username: Optional[str] + ) -> Optional[AuthInfo]: ... + + @abstractmethod + def save_auth_info(self, url: str, username: str, password: str) -> None: ... + + +class KeyRingNullProvider(KeyRingBaseProvider): + """Keyring null provider""" + + has_keyring = False + + def get_auth_info(self, url: str, username: Optional[str]) -> Optional[AuthInfo]: + return None + + def save_auth_info(self, url: str, username: str, password: str) -> None: + return None + + +class KeyRingPythonProvider(KeyRingBaseProvider): + """Keyring interface which uses locally imported `keyring`""" + + has_keyring = True + + def __init__(self) -> None: + import keyring + + self.keyring = keyring + + def get_auth_info(self, url: str, username: Optional[str]) -> Optional[AuthInfo]: + # Support keyring's get_credential interface which supports getting + # credentials without a username. This is only available for + # keyring>=15.2.0. + if hasattr(self.keyring, "get_credential"): + logger.debug("Getting credentials from keyring for %s", url) + cred = self.keyring.get_credential(url, username) + if cred is not None: + return cred.username, cred.password + return None + + if username is not None: + logger.debug("Getting password from keyring for %s", url) + password = self.keyring.get_password(url, username) + if password: + return username, password + return None + + def save_auth_info(self, url: str, username: str, password: str) -> None: + self.keyring.set_password(url, username, password) + + +class KeyRingCliProvider(KeyRingBaseProvider): + """Provider which uses `keyring` cli + + Instead of calling the keyring package installed alongside pip + we call keyring on the command line which will enable pip to + use which ever installation of keyring is available first in + PATH. + """ + + has_keyring = True + + def __init__(self, cmd: str) -> None: + self.keyring = cmd + + def get_auth_info(self, url: str, username: Optional[str]) -> Optional[AuthInfo]: + # This is the default implementation of keyring.get_credential + # https://github.com/jaraco/keyring/blob/97689324abcf01bd1793d49063e7ca01e03d7d07/keyring/backend.py#L134-L139 + if username is not None: + password = self._get_password(url, username) + if password is not None: + return username, password + return None + + def save_auth_info(self, url: str, username: str, password: str) -> None: + return self._set_password(url, username, password) + + def _get_password(self, service_name: str, username: str) -> Optional[str]: + """Mirror the implementation of keyring.get_password using cli""" + if self.keyring is None: + return None + + cmd = [self.keyring, "get", service_name, username] + env = os.environ.copy() + env["PYTHONIOENCODING"] = "utf-8" + res = subprocess.run( + cmd, + stdin=subprocess.DEVNULL, + stdout=subprocess.PIPE, + env=env, + ) + if res.returncode: + return None + return res.stdout.decode("utf-8").strip(os.linesep) + + def _set_password(self, service_name: str, username: str, password: str) -> None: + """Mirror the implementation of keyring.set_password using cli""" + if self.keyring is None: + return None + env = os.environ.copy() + env["PYTHONIOENCODING"] = "utf-8" + subprocess.run( + [self.keyring, "set", service_name, username], + input=f"{password}{os.linesep}".encode(), + env=env, + check=True, + ) + return None + + +@lru_cache(maxsize=None) +def get_keyring_provider(provider: str) -> KeyRingBaseProvider: + logger.verbose("Keyring provider requested: %s", provider) + + # keyring has previously failed and been disabled + if KEYRING_DISABLED: + provider = "disabled" + if provider in ["import", "auto"]: + try: + impl = KeyRingPythonProvider() + logger.verbose("Keyring provider set: import") + return impl + except ImportError: + pass + except Exception as exc: + # In the event of an unexpected exception + # we should warn the user + msg = "Installed copy of keyring fails with exception %s" + if provider == "auto": + msg = msg + ", trying to find a keyring executable as a fallback" + logger.warning(msg, exc, exc_info=logger.isEnabledFor(logging.DEBUG)) + if provider in ["subprocess", "auto"]: + cli = shutil.which("keyring") + if cli and cli.startswith(sysconfig.get_path("scripts")): + # all code within this function is stolen from shutil.which implementation + @typing.no_type_check + def PATH_as_shutil_which_determines_it() -> str: + path = os.environ.get("PATH", None) + if path is None: + try: + path = os.confstr("CS_PATH") + except (AttributeError, ValueError): + # os.confstr() or CS_PATH is not available + path = os.defpath + # bpo-35755: Don't use os.defpath if the PATH environment variable is + # set to an empty string + + return path + + scripts = Path(sysconfig.get_path("scripts")) + + paths = [] + for path in PATH_as_shutil_which_determines_it().split(os.pathsep): + p = Path(path) + try: + if not p.samefile(scripts): + paths.append(path) + except FileNotFoundError: + pass + + path = os.pathsep.join(paths) + + cli = shutil.which("keyring", path=path) + + if cli: + logger.verbose("Keyring provider set: subprocess with executable %s", cli) + return KeyRingCliProvider(cli) + + logger.verbose("Keyring provider set: disabled") + return KeyRingNullProvider() + + +class MultiDomainBasicAuth(AuthBase): + def __init__( + self, + prompting: bool = True, + index_urls: Optional[List[str]] = None, + keyring_provider: str = "auto", + ) -> None: + self.prompting = prompting + self.index_urls = index_urls + self.keyring_provider = keyring_provider # type: ignore[assignment] + self.passwords: Dict[str, AuthInfo] = {} + # When the user is prompted to enter credentials and keyring is + # available, we will offer to save them. If the user accepts, + # this value is set to the credentials they entered. After the + # request authenticates, the caller should call + # ``save_credentials`` to save these. + self._credentials_to_save: Optional[Credentials] = None + + @property + def keyring_provider(self) -> KeyRingBaseProvider: + return get_keyring_provider(self._keyring_provider) + + @keyring_provider.setter + def keyring_provider(self, provider: str) -> None: + # The free function get_keyring_provider has been decorated with + # functools.cache. If an exception occurs in get_keyring_auth that + # cache will be cleared and keyring disabled, take that into account + # if you want to remove this indirection. + self._keyring_provider = provider + + @property + def use_keyring(self) -> bool: + # We won't use keyring when --no-input is passed unless + # a specific provider is requested because it might require + # user interaction + return self.prompting or self._keyring_provider not in ["auto", "disabled"] + + def _get_keyring_auth( + self, + url: Optional[str], + username: Optional[str], + ) -> Optional[AuthInfo]: + """Return the tuple auth for a given url from keyring.""" + # Do nothing if no url was provided + if not url: + return None + + try: + return self.keyring_provider.get_auth_info(url, username) + except Exception as exc: + # Log the full exception (with stacktrace) at debug, so it'll only + # show up when running in verbose mode. + logger.debug("Keyring is skipped due to an exception", exc_info=True) + # Always log a shortened version of the exception. + logger.warning( + "Keyring is skipped due to an exception: %s", + str(exc), + ) + global KEYRING_DISABLED + KEYRING_DISABLED = True + get_keyring_provider.cache_clear() + return None + + def _get_index_url(self, url: str) -> Optional[str]: + """Return the original index URL matching the requested URL. + + Cached or dynamically generated credentials may work against + the original index URL rather than just the netloc. + + The provided url should have had its username and password + removed already. If the original index url had credentials then + they will be included in the return value. + + Returns None if no matching index was found, or if --no-index + was specified by the user. + """ + if not url or not self.index_urls: + return None + + url = remove_auth_from_url(url).rstrip("/") + "/" + parsed_url = urllib.parse.urlsplit(url) + + candidates = [] + + for index in self.index_urls: + index = index.rstrip("/") + "/" + parsed_index = urllib.parse.urlsplit(remove_auth_from_url(index)) + if parsed_url == parsed_index: + return index + + if parsed_url.netloc != parsed_index.netloc: + continue + + candidate = urllib.parse.urlsplit(index) + candidates.append(candidate) + + if not candidates: + return None + + candidates.sort( + reverse=True, + key=lambda candidate: commonprefix( + [ + parsed_url.path, + candidate.path, + ] + ).rfind("/"), + ) + + return urllib.parse.urlunsplit(candidates[0]) + + def _get_new_credentials( + self, + original_url: str, + *, + allow_netrc: bool = True, + allow_keyring: bool = False, + ) -> AuthInfo: + """Find and return credentials for the specified URL.""" + # Split the credentials and netloc from the url. + url, netloc, url_user_password = split_auth_netloc_from_url( + original_url, + ) + + # Start with the credentials embedded in the url + username, password = url_user_password + if username is not None and password is not None: + logger.debug("Found credentials in url for %s", netloc) + return url_user_password + + # Find a matching index url for this request + index_url = self._get_index_url(url) + if index_url: + # Split the credentials from the url. + index_info = split_auth_netloc_from_url(index_url) + if index_info: + index_url, _, index_url_user_password = index_info + logger.debug("Found index url %s", index_url) + + # If an index URL was found, try its embedded credentials + if index_url and index_url_user_password[0] is not None: + username, password = index_url_user_password + if username is not None and password is not None: + logger.debug("Found credentials in index url for %s", netloc) + return index_url_user_password + + # Get creds from netrc if we still don't have them + if allow_netrc: + netrc_auth = get_netrc_auth(original_url) + if netrc_auth: + logger.debug("Found credentials in netrc for %s", netloc) + return netrc_auth + + # If we don't have a password and keyring is available, use it. + if allow_keyring: + # The index url is more specific than the netloc, so try it first + # fmt: off + kr_auth = ( + self._get_keyring_auth(index_url, username) or + self._get_keyring_auth(netloc, username) + ) + # fmt: on + if kr_auth: + logger.debug("Found credentials in keyring for %s", netloc) + return kr_auth + + return username, password + + def _get_url_and_credentials( + self, original_url: str + ) -> Tuple[str, Optional[str], Optional[str]]: + """Return the credentials to use for the provided URL. + + If allowed, netrc and keyring may be used to obtain the + correct credentials. + + Returns (url_without_credentials, username, password). Note + that even if the original URL contains credentials, this + function may return a different username and password. + """ + url, netloc, _ = split_auth_netloc_from_url(original_url) + + # Try to get credentials from original url + username, password = self._get_new_credentials(original_url) + + # If credentials not found, use any stored credentials for this netloc. + # Do this if either the username or the password is missing. + # This accounts for the situation in which the user has specified + # the username in the index url, but the password comes from keyring. + if (username is None or password is None) and netloc in self.passwords: + un, pw = self.passwords[netloc] + # It is possible that the cached credentials are for a different username, + # in which case the cache should be ignored. + if username is None or username == un: + username, password = un, pw + + if username is not None or password is not None: + # Convert the username and password if they're None, so that + # this netloc will show up as "cached" in the conditional above. + # Further, HTTPBasicAuth doesn't accept None, so it makes sense to + # cache the value that is going to be used. + username = username or "" + password = password or "" + + # Store any acquired credentials. + self.passwords[netloc] = (username, password) + + assert ( + # Credentials were found + (username is not None and password is not None) + # Credentials were not found + or (username is None and password is None) + ), f"Could not load credentials from url: {original_url}" + + return url, username, password + + def __call__(self, req: Request) -> Request: + # Get credentials for this request + url, username, password = self._get_url_and_credentials(req.url) + + # Set the url of the request to the url without any credentials + req.url = url + + if username is not None and password is not None: + # Send the basic auth with this request + req = HTTPBasicAuth(username, password)(req) + + # Attach a hook to handle 401 responses + req.register_hook("response", self.handle_401) + + return req + + # Factored out to allow for easy patching in tests + def _prompt_for_password( + self, netloc: str + ) -> Tuple[Optional[str], Optional[str], bool]: + username = ask_input(f"User for {netloc}: ") if self.prompting else None + if not username: + return None, None, False + if self.use_keyring: + auth = self._get_keyring_auth(netloc, username) + if auth and auth[0] is not None and auth[1] is not None: + return auth[0], auth[1], False + password = ask_password("Password: ") + return username, password, True + + # Factored out to allow for easy patching in tests + def _should_save_password_to_keyring(self) -> bool: + if ( + not self.prompting + or not self.use_keyring + or not self.keyring_provider.has_keyring + ): + return False + return ask("Save credentials to keyring [y/N]: ", ["y", "n"]) == "y" + + def handle_401(self, resp: Response, **kwargs: Any) -> Response: + # We only care about 401 responses, anything else we want to just + # pass through the actual response + if resp.status_code != 401: + return resp + + username, password = None, None + + # Query the keyring for credentials: + if self.use_keyring: + username, password = self._get_new_credentials( + resp.url, + allow_netrc=False, + allow_keyring=True, + ) + + # We are not able to prompt the user so simply return the response + if not self.prompting and not username and not password: + return resp + + parsed = urllib.parse.urlparse(resp.url) + + # Prompt the user for a new username and password + save = False + if not username and not password: + username, password, save = self._prompt_for_password(parsed.netloc) + + # Store the new username and password to use for future requests + self._credentials_to_save = None + if username is not None and password is not None: + self.passwords[parsed.netloc] = (username, password) + + # Prompt to save the password to keyring + if save and self._should_save_password_to_keyring(): + self._credentials_to_save = Credentials( + url=parsed.netloc, + username=username, + password=password, + ) + + # Consume content and release the original connection to allow our new + # request to reuse the same one. + # The result of the assignment isn't used, it's just needed to consume + # the content. + _ = resp.content + resp.raw.release_conn() + + # Add our new username and password to the request + req = HTTPBasicAuth(username or "", password or "")(resp.request) + req.register_hook("response", self.warn_on_401) + + # On successful request, save the credentials that were used to + # keyring. (Note that if the user responded "no" above, this member + # is not set and nothing will be saved.) + if self._credentials_to_save: + req.register_hook("response", self.save_credentials) + + # Send our new request + new_resp = resp.connection.send(req, **kwargs) + new_resp.history.append(resp) + + return new_resp + + def warn_on_401(self, resp: Response, **kwargs: Any) -> None: + """Response callback to warn about incorrect credentials.""" + if resp.status_code == 401: + logger.warning( + "401 Error, Credentials not correct for %s", + resp.request.url, + ) + + def save_credentials(self, resp: Response, **kwargs: Any) -> None: + """Response callback to save credentials on success.""" + assert ( + self.keyring_provider.has_keyring + ), "should never reach here without keyring" + + creds = self._credentials_to_save + self._credentials_to_save = None + if creds and resp.status_code < 400: + try: + logger.info("Saving credentials to keyring") + self.keyring_provider.save_auth_info( + creds.url, creds.username, creds.password + ) + except Exception: + logger.exception("Failed to save credentials") diff --git a/env/lib/python3.12/site-packages/pip/_internal/network/cache.py b/env/lib/python3.12/site-packages/pip/_internal/network/cache.py new file mode 100644 index 0000000..fca04e6 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/network/cache.py @@ -0,0 +1,118 @@ +"""HTTP cache implementation. +""" + +import os +from contextlib import contextmanager +from datetime import datetime +from typing import BinaryIO, Generator, Optional, Union + +from pip._vendor.cachecontrol.cache import SeparateBodyBaseCache +from pip._vendor.cachecontrol.caches import SeparateBodyFileCache +from pip._vendor.requests.models import Response + +from pip._internal.utils.filesystem import adjacent_tmp_file, replace +from pip._internal.utils.misc import ensure_dir + + +def is_from_cache(response: Response) -> bool: + return getattr(response, "from_cache", False) + + +@contextmanager +def suppressed_cache_errors() -> Generator[None, None, None]: + """If we can't access the cache then we can just skip caching and process + requests as if caching wasn't enabled. + """ + try: + yield + except OSError: + pass + + +class SafeFileCache(SeparateBodyBaseCache): + """ + A file based cache which is safe to use even when the target directory may + not be accessible or writable. + + There is a race condition when two processes try to write and/or read the + same entry at the same time, since each entry consists of two separate + files (https://github.com/psf/cachecontrol/issues/324). We therefore have + additional logic that makes sure that both files to be present before + returning an entry; this fixes the read side of the race condition. + + For the write side, we assume that the server will only ever return the + same data for the same URL, which ought to be the case for files pip is + downloading. PyPI does not have a mechanism to swap out a wheel for + another wheel, for example. If this assumption is not true, the + CacheControl issue will need to be fixed. + """ + + def __init__(self, directory: str) -> None: + assert directory is not None, "Cache directory must not be None." + super().__init__() + self.directory = directory + + def _get_cache_path(self, name: str) -> str: + # From cachecontrol.caches.file_cache.FileCache._fn, brought into our + # class for backwards-compatibility and to avoid using a non-public + # method. + hashed = SeparateBodyFileCache.encode(name) + parts = list(hashed[:5]) + [hashed] + return os.path.join(self.directory, *parts) + + def get(self, key: str) -> Optional[bytes]: + # The cache entry is only valid if both metadata and body exist. + metadata_path = self._get_cache_path(key) + body_path = metadata_path + ".body" + if not (os.path.exists(metadata_path) and os.path.exists(body_path)): + return None + with suppressed_cache_errors(): + with open(metadata_path, "rb") as f: + return f.read() + + def _write(self, path: str, data: bytes) -> None: + with suppressed_cache_errors(): + ensure_dir(os.path.dirname(path)) + + with adjacent_tmp_file(path) as f: + f.write(data) + # Inherit the read/write permissions of the cache directory + # to enable multi-user cache use-cases. + mode = ( + os.stat(self.directory).st_mode + & 0o666 # select read/write permissions of cache directory + | 0o600 # set owner read/write permissions + ) + # Change permissions only if there is no risk of following a symlink. + if os.chmod in os.supports_fd: + os.chmod(f.fileno(), mode) + elif os.chmod in os.supports_follow_symlinks: + os.chmod(f.name, mode, follow_symlinks=False) + + replace(f.name, path) + + def set( + self, key: str, value: bytes, expires: Union[int, datetime, None] = None + ) -> None: + path = self._get_cache_path(key) + self._write(path, value) + + def delete(self, key: str) -> None: + path = self._get_cache_path(key) + with suppressed_cache_errors(): + os.remove(path) + with suppressed_cache_errors(): + os.remove(path + ".body") + + def get_body(self, key: str) -> Optional[BinaryIO]: + # The cache entry is only valid if both metadata and body exist. + metadata_path = self._get_cache_path(key) + body_path = metadata_path + ".body" + if not (os.path.exists(metadata_path) and os.path.exists(body_path)): + return None + with suppressed_cache_errors(): + return open(body_path, "rb") + + def set_body(self, key: str, body: bytes) -> None: + path = self._get_cache_path(key) + ".body" + self._write(path, body) diff --git a/env/lib/python3.12/site-packages/pip/_internal/network/download.py b/env/lib/python3.12/site-packages/pip/_internal/network/download.py new file mode 100644 index 0000000..5c3bce3 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/network/download.py @@ -0,0 +1,187 @@ +"""Download files with progress indicators. +""" + +import email.message +import logging +import mimetypes +import os +from typing import Iterable, Optional, Tuple + +from pip._vendor.requests.models import Response + +from pip._internal.cli.progress_bars import get_download_progress_renderer +from pip._internal.exceptions import NetworkConnectionError +from pip._internal.models.index import PyPI +from pip._internal.models.link import Link +from pip._internal.network.cache import is_from_cache +from pip._internal.network.session import PipSession +from pip._internal.network.utils import HEADERS, raise_for_status, response_chunks +from pip._internal.utils.misc import format_size, redact_auth_from_url, splitext + +logger = logging.getLogger(__name__) + + +def _get_http_response_size(resp: Response) -> Optional[int]: + try: + return int(resp.headers["content-length"]) + except (ValueError, KeyError, TypeError): + return None + + +def _prepare_download( + resp: Response, + link: Link, + progress_bar: str, +) -> Iterable[bytes]: + total_length = _get_http_response_size(resp) + + if link.netloc == PyPI.file_storage_domain: + url = link.show_url + else: + url = link.url_without_fragment + + logged_url = redact_auth_from_url(url) + + if total_length: + logged_url = f"{logged_url} ({format_size(total_length)})" + + if is_from_cache(resp): + logger.info("Using cached %s", logged_url) + else: + logger.info("Downloading %s", logged_url) + + if logger.getEffectiveLevel() > logging.INFO: + show_progress = False + elif is_from_cache(resp): + show_progress = False + elif not total_length: + show_progress = True + elif total_length > (512 * 1024): + show_progress = True + else: + show_progress = False + + chunks = response_chunks(resp) + + if not show_progress: + return chunks + + renderer = get_download_progress_renderer(bar_type=progress_bar, size=total_length) + return renderer(chunks) + + +def sanitize_content_filename(filename: str) -> str: + """ + Sanitize the "filename" value from a Content-Disposition header. + """ + return os.path.basename(filename) + + +def parse_content_disposition(content_disposition: str, default_filename: str) -> str: + """ + Parse the "filename" value from a Content-Disposition header, and + return the default filename if the result is empty. + """ + m = email.message.Message() + m["content-type"] = content_disposition + filename = m.get_param("filename") + if filename: + # We need to sanitize the filename to prevent directory traversal + # in case the filename contains ".." path parts. + filename = sanitize_content_filename(str(filename)) + return filename or default_filename + + +def _get_http_response_filename(resp: Response, link: Link) -> str: + """Get an ideal filename from the given HTTP response, falling back to + the link filename if not provided. + """ + filename = link.filename # fallback + # Have a look at the Content-Disposition header for a better guess + content_disposition = resp.headers.get("content-disposition") + if content_disposition: + filename = parse_content_disposition(content_disposition, filename) + ext: Optional[str] = splitext(filename)[1] + if not ext: + ext = mimetypes.guess_extension(resp.headers.get("content-type", "")) + if ext: + filename += ext + if not ext and link.url != resp.url: + ext = os.path.splitext(resp.url)[1] + if ext: + filename += ext + return filename + + +def _http_get_download(session: PipSession, link: Link) -> Response: + target_url = link.url.split("#", 1)[0] + resp = session.get(target_url, headers=HEADERS, stream=True) + raise_for_status(resp) + return resp + + +class Downloader: + def __init__( + self, + session: PipSession, + progress_bar: str, + ) -> None: + self._session = session + self._progress_bar = progress_bar + + def __call__(self, link: Link, location: str) -> Tuple[str, str]: + """Download the file given by link into location.""" + try: + resp = _http_get_download(self._session, link) + except NetworkConnectionError as e: + assert e.response is not None + logger.critical( + "HTTP error %s while getting %s", e.response.status_code, link + ) + raise + + filename = _get_http_response_filename(resp, link) + filepath = os.path.join(location, filename) + + chunks = _prepare_download(resp, link, self._progress_bar) + with open(filepath, "wb") as content_file: + for chunk in chunks: + content_file.write(chunk) + content_type = resp.headers.get("Content-Type", "") + return filepath, content_type + + +class BatchDownloader: + def __init__( + self, + session: PipSession, + progress_bar: str, + ) -> None: + self._session = session + self._progress_bar = progress_bar + + def __call__( + self, links: Iterable[Link], location: str + ) -> Iterable[Tuple[Link, Tuple[str, str]]]: + """Download the files given by links into location.""" + for link in links: + try: + resp = _http_get_download(self._session, link) + except NetworkConnectionError as e: + assert e.response is not None + logger.critical( + "HTTP error %s while getting %s", + e.response.status_code, + link, + ) + raise + + filename = _get_http_response_filename(resp, link) + filepath = os.path.join(location, filename) + + chunks = _prepare_download(resp, link, self._progress_bar) + with open(filepath, "wb") as content_file: + for chunk in chunks: + content_file.write(chunk) + content_type = resp.headers.get("Content-Type", "") + yield link, (filepath, content_type) diff --git a/env/lib/python3.12/site-packages/pip/_internal/network/lazy_wheel.py b/env/lib/python3.12/site-packages/pip/_internal/network/lazy_wheel.py new file mode 100644 index 0000000..03f883c --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/network/lazy_wheel.py @@ -0,0 +1,210 @@ +"""Lazy ZIP over HTTP""" + +__all__ = ["HTTPRangeRequestUnsupported", "dist_from_wheel_url"] + +from bisect import bisect_left, bisect_right +from contextlib import contextmanager +from tempfile import NamedTemporaryFile +from typing import Any, Dict, Generator, List, Optional, Tuple +from zipfile import BadZipFile, ZipFile + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.requests.models import CONTENT_CHUNK_SIZE, Response + +from pip._internal.metadata import BaseDistribution, MemoryWheel, get_wheel_distribution +from pip._internal.network.session import PipSession +from pip._internal.network.utils import HEADERS, raise_for_status, response_chunks + + +class HTTPRangeRequestUnsupported(Exception): + pass + + +def dist_from_wheel_url(name: str, url: str, session: PipSession) -> BaseDistribution: + """Return a distribution object from the given wheel URL. + + This uses HTTP range requests to only fetch the portion of the wheel + containing metadata, just enough for the object to be constructed. + If such requests are not supported, HTTPRangeRequestUnsupported + is raised. + """ + with LazyZipOverHTTP(url, session) as zf: + # For read-only ZIP files, ZipFile only needs methods read, + # seek, seekable and tell, not the whole IO protocol. + wheel = MemoryWheel(zf.name, zf) # type: ignore + # After context manager exit, wheel.name + # is an invalid file by intention. + return get_wheel_distribution(wheel, canonicalize_name(name)) + + +class LazyZipOverHTTP: + """File-like object mapped to a ZIP file over HTTP. + + This uses HTTP range requests to lazily fetch the file's content, + which is supposed to be fed to ZipFile. If such requests are not + supported by the server, raise HTTPRangeRequestUnsupported + during initialization. + """ + + def __init__( + self, url: str, session: PipSession, chunk_size: int = CONTENT_CHUNK_SIZE + ) -> None: + head = session.head(url, headers=HEADERS) + raise_for_status(head) + assert head.status_code == 200 + self._session, self._url, self._chunk_size = session, url, chunk_size + self._length = int(head.headers["Content-Length"]) + self._file = NamedTemporaryFile() + self.truncate(self._length) + self._left: List[int] = [] + self._right: List[int] = [] + if "bytes" not in head.headers.get("Accept-Ranges", "none"): + raise HTTPRangeRequestUnsupported("range request is not supported") + self._check_zip() + + @property + def mode(self) -> str: + """Opening mode, which is always rb.""" + return "rb" + + @property + def name(self) -> str: + """Path to the underlying file.""" + return self._file.name + + def seekable(self) -> bool: + """Return whether random access is supported, which is True.""" + return True + + def close(self) -> None: + """Close the file.""" + self._file.close() + + @property + def closed(self) -> bool: + """Whether the file is closed.""" + return self._file.closed + + def read(self, size: int = -1) -> bytes: + """Read up to size bytes from the object and return them. + + As a convenience, if size is unspecified or -1, + all bytes until EOF are returned. Fewer than + size bytes may be returned if EOF is reached. + """ + download_size = max(size, self._chunk_size) + start, length = self.tell(), self._length + stop = length if size < 0 else min(start + download_size, length) + start = max(0, stop - download_size) + self._download(start, stop - 1) + return self._file.read(size) + + def readable(self) -> bool: + """Return whether the file is readable, which is True.""" + return True + + def seek(self, offset: int, whence: int = 0) -> int: + """Change stream position and return the new absolute position. + + Seek to offset relative position indicated by whence: + * 0: Start of stream (the default). pos should be >= 0; + * 1: Current position - pos may be negative; + * 2: End of stream - pos usually negative. + """ + return self._file.seek(offset, whence) + + def tell(self) -> int: + """Return the current position.""" + return self._file.tell() + + def truncate(self, size: Optional[int] = None) -> int: + """Resize the stream to the given size in bytes. + + If size is unspecified resize to the current position. + The current stream position isn't changed. + + Return the new file size. + """ + return self._file.truncate(size) + + def writable(self) -> bool: + """Return False.""" + return False + + def __enter__(self) -> "LazyZipOverHTTP": + self._file.__enter__() + return self + + def __exit__(self, *exc: Any) -> None: + self._file.__exit__(*exc) + + @contextmanager + def _stay(self) -> Generator[None, None, None]: + """Return a context manager keeping the position. + + At the end of the block, seek back to original position. + """ + pos = self.tell() + try: + yield + finally: + self.seek(pos) + + def _check_zip(self) -> None: + """Check and download until the file is a valid ZIP.""" + end = self._length - 1 + for start in reversed(range(0, end, self._chunk_size)): + self._download(start, end) + with self._stay(): + try: + # For read-only ZIP files, ZipFile only needs + # methods read, seek, seekable and tell. + ZipFile(self) + except BadZipFile: + pass + else: + break + + def _stream_response( + self, start: int, end: int, base_headers: Dict[str, str] = HEADERS + ) -> Response: + """Return HTTP response to a range request from start to end.""" + headers = base_headers.copy() + headers["Range"] = f"bytes={start}-{end}" + # TODO: Get range requests to be correctly cached + headers["Cache-Control"] = "no-cache" + return self._session.get(self._url, headers=headers, stream=True) + + def _merge( + self, start: int, end: int, left: int, right: int + ) -> Generator[Tuple[int, int], None, None]: + """Return a generator of intervals to be fetched. + + Args: + start (int): Start of needed interval + end (int): End of needed interval + left (int): Index of first overlapping downloaded data + right (int): Index after last overlapping downloaded data + """ + lslice, rslice = self._left[left:right], self._right[left:right] + i = start = min([start] + lslice[:1]) + end = max([end] + rslice[-1:]) + for j, k in zip(lslice, rslice): + if j > i: + yield i, j - 1 + i = k + 1 + if i <= end: + yield i, end + self._left[left:right], self._right[left:right] = [start], [end] + + def _download(self, start: int, end: int) -> None: + """Download bytes from start to end inclusively.""" + with self._stay(): + left = bisect_left(self._right, start) + right = bisect_right(self._left, end) + for start, end in self._merge(start, end, left, right): + response = self._stream_response(start, end) + response.raise_for_status() + self.seek(start) + for chunk in response_chunks(response, self._chunk_size): + self._file.write(chunk) diff --git a/env/lib/python3.12/site-packages/pip/_internal/network/session.py b/env/lib/python3.12/site-packages/pip/_internal/network/session.py new file mode 100644 index 0000000..5e10f8f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/network/session.py @@ -0,0 +1,523 @@ +"""PipSession and supporting code, containing all pip-specific +network request configuration and behavior. +""" + +import email.utils +import functools +import io +import ipaddress +import json +import logging +import mimetypes +import os +import platform +import shutil +import subprocess +import sys +import urllib.parse +import warnings +from typing import ( + TYPE_CHECKING, + Any, + Dict, + Generator, + List, + Mapping, + Optional, + Sequence, + Tuple, + Union, +) + +from pip._vendor import requests, urllib3 +from pip._vendor.cachecontrol import CacheControlAdapter as _BaseCacheControlAdapter +from pip._vendor.requests.adapters import DEFAULT_POOLBLOCK, BaseAdapter +from pip._vendor.requests.adapters import HTTPAdapter as _BaseHTTPAdapter +from pip._vendor.requests.models import PreparedRequest, Response +from pip._vendor.requests.structures import CaseInsensitiveDict +from pip._vendor.urllib3.connectionpool import ConnectionPool +from pip._vendor.urllib3.exceptions import InsecureRequestWarning + +from pip import __version__ +from pip._internal.metadata import get_default_environment +from pip._internal.models.link import Link +from pip._internal.network.auth import MultiDomainBasicAuth +from pip._internal.network.cache import SafeFileCache + +# Import ssl from compat so the initial import occurs in only one place. +from pip._internal.utils.compat import has_tls +from pip._internal.utils.glibc import libc_ver +from pip._internal.utils.misc import build_url_from_netloc, parse_netloc +from pip._internal.utils.urls import url_to_path + +if TYPE_CHECKING: + from ssl import SSLContext + + from pip._vendor.urllib3.poolmanager import PoolManager + + +logger = logging.getLogger(__name__) + +SecureOrigin = Tuple[str, str, Optional[Union[int, str]]] + + +# Ignore warning raised when using --trusted-host. +warnings.filterwarnings("ignore", category=InsecureRequestWarning) + + +SECURE_ORIGINS: List[SecureOrigin] = [ + # protocol, hostname, port + # Taken from Chrome's list of secure origins (See: http://bit.ly/1qrySKC) + ("https", "*", "*"), + ("*", "localhost", "*"), + ("*", "127.0.0.0/8", "*"), + ("*", "::1/128", "*"), + ("file", "*", None), + # ssh is always secure. + ("ssh", "*", "*"), +] + + +# These are environment variables present when running under various +# CI systems. For each variable, some CI systems that use the variable +# are indicated. The collection was chosen so that for each of a number +# of popular systems, at least one of the environment variables is used. +# This list is used to provide some indication of and lower bound for +# CI traffic to PyPI. Thus, it is okay if the list is not comprehensive. +# For more background, see: https://github.com/pypa/pip/issues/5499 +CI_ENVIRONMENT_VARIABLES = ( + # Azure Pipelines + "BUILD_BUILDID", + # Jenkins + "BUILD_ID", + # AppVeyor, CircleCI, Codeship, Gitlab CI, Shippable, Travis CI + "CI", + # Explicit environment variable. + "PIP_IS_CI", +) + + +def looks_like_ci() -> bool: + """ + Return whether it looks like pip is running under CI. + """ + # We don't use the method of checking for a tty (e.g. using isatty()) + # because some CI systems mimic a tty (e.g. Travis CI). Thus that + # method doesn't provide definitive information in either direction. + return any(name in os.environ for name in CI_ENVIRONMENT_VARIABLES) + + +@functools.lru_cache(maxsize=1) +def user_agent() -> str: + """ + Return a string representing the user agent. + """ + data: Dict[str, Any] = { + "installer": {"name": "pip", "version": __version__}, + "python": platform.python_version(), + "implementation": { + "name": platform.python_implementation(), + }, + } + + if data["implementation"]["name"] == "CPython": + data["implementation"]["version"] = platform.python_version() + elif data["implementation"]["name"] == "PyPy": + pypy_version_info = sys.pypy_version_info # type: ignore + if pypy_version_info.releaselevel == "final": + pypy_version_info = pypy_version_info[:3] + data["implementation"]["version"] = ".".join( + [str(x) for x in pypy_version_info] + ) + elif data["implementation"]["name"] == "Jython": + # Complete Guess + data["implementation"]["version"] = platform.python_version() + elif data["implementation"]["name"] == "IronPython": + # Complete Guess + data["implementation"]["version"] = platform.python_version() + + if sys.platform.startswith("linux"): + from pip._vendor import distro + + linux_distribution = distro.name(), distro.version(), distro.codename() + distro_infos: Dict[str, Any] = dict( + filter( + lambda x: x[1], + zip(["name", "version", "id"], linux_distribution), + ) + ) + libc = dict( + filter( + lambda x: x[1], + zip(["lib", "version"], libc_ver()), + ) + ) + if libc: + distro_infos["libc"] = libc + if distro_infos: + data["distro"] = distro_infos + + if sys.platform.startswith("darwin") and platform.mac_ver()[0]: + data["distro"] = {"name": "macOS", "version": platform.mac_ver()[0]} + + if platform.system(): + data.setdefault("system", {})["name"] = platform.system() + + if platform.release(): + data.setdefault("system", {})["release"] = platform.release() + + if platform.machine(): + data["cpu"] = platform.machine() + + if has_tls(): + import _ssl as ssl + + data["openssl_version"] = ssl.OPENSSL_VERSION + + setuptools_dist = get_default_environment().get_distribution("setuptools") + if setuptools_dist is not None: + data["setuptools_version"] = str(setuptools_dist.version) + + if shutil.which("rustc") is not None: + # If for any reason `rustc --version` fails, silently ignore it + try: + rustc_output = subprocess.check_output( + ["rustc", "--version"], stderr=subprocess.STDOUT, timeout=0.5 + ) + except Exception: + pass + else: + if rustc_output.startswith(b"rustc "): + # The format of `rustc --version` is: + # `b'rustc 1.52.1 (9bc8c42bb 2021-05-09)\n'` + # We extract just the middle (1.52.1) part + data["rustc_version"] = rustc_output.split(b" ")[1].decode() + + # Use None rather than False so as not to give the impression that + # pip knows it is not being run under CI. Rather, it is a null or + # inconclusive result. Also, we include some value rather than no + # value to make it easier to know that the check has been run. + data["ci"] = True if looks_like_ci() else None + + user_data = os.environ.get("PIP_USER_AGENT_USER_DATA") + if user_data is not None: + data["user_data"] = user_data + + return "{data[installer][name]}/{data[installer][version]} {json}".format( + data=data, + json=json.dumps(data, separators=(",", ":"), sort_keys=True), + ) + + +class LocalFSAdapter(BaseAdapter): + def send( + self, + request: PreparedRequest, + stream: bool = False, + timeout: Optional[Union[float, Tuple[float, float]]] = None, + verify: Union[bool, str] = True, + cert: Optional[Union[str, Tuple[str, str]]] = None, + proxies: Optional[Mapping[str, str]] = None, + ) -> Response: + pathname = url_to_path(request.url) + + resp = Response() + resp.status_code = 200 + resp.url = request.url + + try: + stats = os.stat(pathname) + except OSError as exc: + # format the exception raised as a io.BytesIO object, + # to return a better error message: + resp.status_code = 404 + resp.reason = type(exc).__name__ + resp.raw = io.BytesIO(f"{resp.reason}: {exc}".encode()) + else: + modified = email.utils.formatdate(stats.st_mtime, usegmt=True) + content_type = mimetypes.guess_type(pathname)[0] or "text/plain" + resp.headers = CaseInsensitiveDict( + { + "Content-Type": content_type, + "Content-Length": stats.st_size, + "Last-Modified": modified, + } + ) + + resp.raw = open(pathname, "rb") + resp.close = resp.raw.close + + return resp + + def close(self) -> None: + pass + + +class _SSLContextAdapterMixin: + """Mixin to add the ``ssl_context`` constructor argument to HTTP adapters. + + The additional argument is forwarded directly to the pool manager. This allows us + to dynamically decide what SSL store to use at runtime, which is used to implement + the optional ``truststore`` backend. + """ + + def __init__( + self, + *, + ssl_context: Optional["SSLContext"] = None, + **kwargs: Any, + ) -> None: + self._ssl_context = ssl_context + super().__init__(**kwargs) + + def init_poolmanager( + self, + connections: int, + maxsize: int, + block: bool = DEFAULT_POOLBLOCK, + **pool_kwargs: Any, + ) -> "PoolManager": + if self._ssl_context is not None: + pool_kwargs.setdefault("ssl_context", self._ssl_context) + return super().init_poolmanager( # type: ignore[misc] + connections=connections, + maxsize=maxsize, + block=block, + **pool_kwargs, + ) + + +class HTTPAdapter(_SSLContextAdapterMixin, _BaseHTTPAdapter): + pass + + +class CacheControlAdapter(_SSLContextAdapterMixin, _BaseCacheControlAdapter): + pass + + +class InsecureHTTPAdapter(HTTPAdapter): + def cert_verify( + self, + conn: ConnectionPool, + url: str, + verify: Union[bool, str], + cert: Optional[Union[str, Tuple[str, str]]], + ) -> None: + super().cert_verify(conn=conn, url=url, verify=False, cert=cert) + + +class InsecureCacheControlAdapter(CacheControlAdapter): + def cert_verify( + self, + conn: ConnectionPool, + url: str, + verify: Union[bool, str], + cert: Optional[Union[str, Tuple[str, str]]], + ) -> None: + super().cert_verify(conn=conn, url=url, verify=False, cert=cert) + + +class PipSession(requests.Session): + timeout: Optional[int] = None + + def __init__( + self, + *args: Any, + retries: int = 0, + cache: Optional[str] = None, + trusted_hosts: Sequence[str] = (), + index_urls: Optional[List[str]] = None, + ssl_context: Optional["SSLContext"] = None, + **kwargs: Any, + ) -> None: + """ + :param trusted_hosts: Domains not to emit warnings for when not using + HTTPS. + """ + super().__init__(*args, **kwargs) + + # Namespace the attribute with "pip_" just in case to prevent + # possible conflicts with the base class. + self.pip_trusted_origins: List[Tuple[str, Optional[int]]] = [] + self.pip_proxy = None + + # Attach our User Agent to the request + self.headers["User-Agent"] = user_agent() + + # Attach our Authentication handler to the session + self.auth = MultiDomainBasicAuth(index_urls=index_urls) + + # Create our urllib3.Retry instance which will allow us to customize + # how we handle retries. + retries = urllib3.Retry( + # Set the total number of retries that a particular request can + # have. + total=retries, + # A 503 error from PyPI typically means that the Fastly -> Origin + # connection got interrupted in some way. A 503 error in general + # is typically considered a transient error so we'll go ahead and + # retry it. + # A 500 may indicate transient error in Amazon S3 + # A 502 may be a transient error from a CDN like CloudFlare or CloudFront + # A 520 or 527 - may indicate transient error in CloudFlare + status_forcelist=[500, 502, 503, 520, 527], + # Add a small amount of back off between failed requests in + # order to prevent hammering the service. + backoff_factor=0.25, + ) # type: ignore + + # Our Insecure HTTPAdapter disables HTTPS validation. It does not + # support caching so we'll use it for all http:// URLs. + # If caching is disabled, we will also use it for + # https:// hosts that we've marked as ignoring + # TLS errors for (trusted-hosts). + insecure_adapter = InsecureHTTPAdapter(max_retries=retries) + + # We want to _only_ cache responses on securely fetched origins or when + # the host is specified as trusted. We do this because + # we can't validate the response of an insecurely/untrusted fetched + # origin, and we don't want someone to be able to poison the cache and + # require manual eviction from the cache to fix it. + if cache: + secure_adapter = CacheControlAdapter( + cache=SafeFileCache(cache), + max_retries=retries, + ssl_context=ssl_context, + ) + self._trusted_host_adapter = InsecureCacheControlAdapter( + cache=SafeFileCache(cache), + max_retries=retries, + ) + else: + secure_adapter = HTTPAdapter(max_retries=retries, ssl_context=ssl_context) + self._trusted_host_adapter = insecure_adapter + + self.mount("https://", secure_adapter) + self.mount("http://", insecure_adapter) + + # Enable file:// urls + self.mount("file://", LocalFSAdapter()) + + for host in trusted_hosts: + self.add_trusted_host(host, suppress_logging=True) + + def update_index_urls(self, new_index_urls: List[str]) -> None: + """ + :param new_index_urls: New index urls to update the authentication + handler with. + """ + self.auth.index_urls = new_index_urls + + def add_trusted_host( + self, host: str, source: Optional[str] = None, suppress_logging: bool = False + ) -> None: + """ + :param host: It is okay to provide a host that has previously been + added. + :param source: An optional source string, for logging where the host + string came from. + """ + if not suppress_logging: + msg = f"adding trusted host: {host!r}" + if source is not None: + msg += f" (from {source})" + logger.info(msg) + + parsed_host, parsed_port = parse_netloc(host) + if parsed_host is None: + raise ValueError(f"Trusted host URL must include a host part: {host!r}") + if (parsed_host, parsed_port) not in self.pip_trusted_origins: + self.pip_trusted_origins.append((parsed_host, parsed_port)) + + self.mount( + build_url_from_netloc(host, scheme="http") + "/", self._trusted_host_adapter + ) + self.mount(build_url_from_netloc(host) + "/", self._trusted_host_adapter) + if not parsed_port: + self.mount( + build_url_from_netloc(host, scheme="http") + ":", + self._trusted_host_adapter, + ) + # Mount wildcard ports for the same host. + self.mount(build_url_from_netloc(host) + ":", self._trusted_host_adapter) + + def iter_secure_origins(self) -> Generator[SecureOrigin, None, None]: + yield from SECURE_ORIGINS + for host, port in self.pip_trusted_origins: + yield ("*", host, "*" if port is None else port) + + def is_secure_origin(self, location: Link) -> bool: + # Determine if this url used a secure transport mechanism + parsed = urllib.parse.urlparse(str(location)) + origin_protocol, origin_host, origin_port = ( + parsed.scheme, + parsed.hostname, + parsed.port, + ) + + # The protocol to use to see if the protocol matches. + # Don't count the repository type as part of the protocol: in + # cases such as "git+ssh", only use "ssh". (I.e., Only verify against + # the last scheme.) + origin_protocol = origin_protocol.rsplit("+", 1)[-1] + + # Determine if our origin is a secure origin by looking through our + # hardcoded list of secure origins, as well as any additional ones + # configured on this PackageFinder instance. + for secure_origin in self.iter_secure_origins(): + secure_protocol, secure_host, secure_port = secure_origin + if origin_protocol != secure_protocol and secure_protocol != "*": + continue + + try: + addr = ipaddress.ip_address(origin_host or "") + network = ipaddress.ip_network(secure_host) + except ValueError: + # We don't have both a valid address or a valid network, so + # we'll check this origin against hostnames. + if ( + origin_host + and origin_host.lower() != secure_host.lower() + and secure_host != "*" + ): + continue + else: + # We have a valid address and network, so see if the address + # is contained within the network. + if addr not in network: + continue + + # Check to see if the port matches. + if ( + origin_port != secure_port + and secure_port != "*" + and secure_port is not None + ): + continue + + # If we've gotten here, then this origin matches the current + # secure origin and we should return True + return True + + # If we've gotten to this point, then the origin isn't secure and we + # will not accept it as a valid location to search. We will however + # log a warning that we are ignoring it. + logger.warning( + "The repository located at %s is not a trusted or secure host and " + "is being ignored. If this repository is available via HTTPS we " + "recommend you use HTTPS instead, otherwise you may silence " + "this warning and allow it anyway with '--trusted-host %s'.", + origin_host, + origin_host, + ) + + return False + + def request(self, method: str, url: str, *args: Any, **kwargs: Any) -> Response: + # Allow setting a default timeout on a session + kwargs.setdefault("timeout", self.timeout) + # Allow setting a default proxies on a session + kwargs.setdefault("proxies", self.proxies) + + # Dispatch the actual request + return super().request(method, url, *args, **kwargs) diff --git a/env/lib/python3.12/site-packages/pip/_internal/network/utils.py b/env/lib/python3.12/site-packages/pip/_internal/network/utils.py new file mode 100644 index 0000000..bba4c26 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/network/utils.py @@ -0,0 +1,98 @@ +from typing import Dict, Generator + +from pip._vendor.requests.models import Response + +from pip._internal.exceptions import NetworkConnectionError + +# The following comments and HTTP headers were originally added by +# Donald Stufft in git commit 22c562429a61bb77172039e480873fb239dd8c03. +# +# We use Accept-Encoding: identity here because requests defaults to +# accepting compressed responses. This breaks in a variety of ways +# depending on how the server is configured. +# - Some servers will notice that the file isn't a compressible file +# and will leave the file alone and with an empty Content-Encoding +# - Some servers will notice that the file is already compressed and +# will leave the file alone, adding a Content-Encoding: gzip header +# - Some servers won't notice anything at all and will take a file +# that's already been compressed and compress it again, and set +# the Content-Encoding: gzip header +# By setting this to request only the identity encoding we're hoping +# to eliminate the third case. Hopefully there does not exist a server +# which when given a file will notice it is already compressed and that +# you're not asking for a compressed file and will then decompress it +# before sending because if that's the case I don't think it'll ever be +# possible to make this work. +HEADERS: Dict[str, str] = {"Accept-Encoding": "identity"} + +DOWNLOAD_CHUNK_SIZE = 256 * 1024 + + +def raise_for_status(resp: Response) -> None: + http_error_msg = "" + if isinstance(resp.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. + try: + reason = resp.reason.decode("utf-8") + except UnicodeDecodeError: + reason = resp.reason.decode("iso-8859-1") + else: + reason = resp.reason + + if 400 <= resp.status_code < 500: + http_error_msg = ( + f"{resp.status_code} Client Error: {reason} for url: {resp.url}" + ) + + elif 500 <= resp.status_code < 600: + http_error_msg = ( + f"{resp.status_code} Server Error: {reason} for url: {resp.url}" + ) + + if http_error_msg: + raise NetworkConnectionError(http_error_msg, response=resp) + + +def response_chunks( + response: Response, chunk_size: int = DOWNLOAD_CHUNK_SIZE +) -> Generator[bytes, None, None]: + """Given a requests Response, provide the data chunks.""" + try: + # Special case for urllib3. + for chunk in response.raw.stream( + chunk_size, + # We use decode_content=False here because we don't + # want urllib3 to mess with the raw bytes we get + # from the server. If we decompress inside of + # urllib3 then we cannot verify the checksum + # because the checksum will be of the compressed + # file. This breakage will only occur if the + # server adds a Content-Encoding header, which + # depends on how the server was configured: + # - Some servers will notice that the file isn't a + # compressible file and will leave the file alone + # and with an empty Content-Encoding + # - Some servers will notice that the file is + # already compressed and will leave the file + # alone and will add a Content-Encoding: gzip + # header + # - Some servers won't notice anything at all and + # will take a file that's already been compressed + # and compress it again and set the + # Content-Encoding: gzip header + # + # By setting this not to decode automatically we + # hope to eliminate problems with the second case. + decode_content=False, + ): + yield chunk + except AttributeError: + # Standard file-like object. + while True: + chunk = response.raw.read(chunk_size) + if not chunk: + break + yield chunk diff --git a/env/lib/python3.12/site-packages/pip/_internal/network/xmlrpc.py b/env/lib/python3.12/site-packages/pip/_internal/network/xmlrpc.py new file mode 100644 index 0000000..22ec8d2 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/network/xmlrpc.py @@ -0,0 +1,62 @@ +"""xmlrpclib.Transport implementation +""" + +import logging +import urllib.parse +import xmlrpc.client +from typing import TYPE_CHECKING, Tuple + +from pip._internal.exceptions import NetworkConnectionError +from pip._internal.network.session import PipSession +from pip._internal.network.utils import raise_for_status + +if TYPE_CHECKING: + from xmlrpc.client import _HostType, _Marshallable + + from _typeshed import SizedBuffer + +logger = logging.getLogger(__name__) + + +class PipXmlrpcTransport(xmlrpc.client.Transport): + """Provide a `xmlrpclib.Transport` implementation via a `PipSession` + object. + """ + + def __init__( + self, index_url: str, session: PipSession, use_datetime: bool = False + ) -> None: + super().__init__(use_datetime) + index_parts = urllib.parse.urlparse(index_url) + self._scheme = index_parts.scheme + self._session = session + + def request( + self, + host: "_HostType", + handler: str, + request_body: "SizedBuffer", + verbose: bool = False, + ) -> Tuple["_Marshallable", ...]: + assert isinstance(host, str) + parts = (self._scheme, host, handler, None, None, None) + url = urllib.parse.urlunparse(parts) + try: + headers = {"Content-Type": "text/xml"} + response = self._session.post( + url, + data=request_body, + headers=headers, + stream=True, + ) + raise_for_status(response) + self.verbose = verbose + return self.parse_response(response.raw) + except NetworkConnectionError as exc: + assert exc.response + logger.critical( + "HTTP error %s while getting %s", + exc.response.status_code, + url, + ) + raise diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/operations/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/build/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/operations/build/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/build/build_tracker.py b/env/lib/python3.12/site-packages/pip/_internal/operations/build/build_tracker.py new file mode 100644 index 0000000..0ed8dd2 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/build/build_tracker.py @@ -0,0 +1,138 @@ +import contextlib +import hashlib +import logging +import os +from types import TracebackType +from typing import Dict, Generator, Optional, Type, Union + +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.temp_dir import TempDirectory + +logger = logging.getLogger(__name__) + + +@contextlib.contextmanager +def update_env_context_manager(**changes: str) -> Generator[None, None, None]: + target = os.environ + + # Save values from the target and change them. + non_existent_marker = object() + saved_values: Dict[str, Union[object, str]] = {} + for name, new_value in changes.items(): + try: + saved_values[name] = target[name] + except KeyError: + saved_values[name] = non_existent_marker + target[name] = new_value + + try: + yield + finally: + # Restore original values in the target. + for name, original_value in saved_values.items(): + if original_value is non_existent_marker: + del target[name] + else: + assert isinstance(original_value, str) # for mypy + target[name] = original_value + + +@contextlib.contextmanager +def get_build_tracker() -> Generator["BuildTracker", None, None]: + root = os.environ.get("PIP_BUILD_TRACKER") + with contextlib.ExitStack() as ctx: + if root is None: + root = ctx.enter_context(TempDirectory(kind="build-tracker")).path + ctx.enter_context(update_env_context_manager(PIP_BUILD_TRACKER=root)) + logger.debug("Initialized build tracking at %s", root) + + with BuildTracker(root) as tracker: + yield tracker + + +class TrackerId(str): + """Uniquely identifying string provided to the build tracker.""" + + +class BuildTracker: + """Ensure that an sdist cannot request itself as a setup requirement. + + When an sdist is prepared, it identifies its setup requirements in the + context of ``BuildTracker.track()``. If a requirement shows up recursively, this + raises an exception. + + This stops fork bombs embedded in malicious packages.""" + + def __init__(self, root: str) -> None: + self._root = root + self._entries: Dict[TrackerId, InstallRequirement] = {} + logger.debug("Created build tracker: %s", self._root) + + def __enter__(self) -> "BuildTracker": + logger.debug("Entered build tracker: %s", self._root) + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + self.cleanup() + + def _entry_path(self, key: TrackerId) -> str: + hashed = hashlib.sha224(key.encode()).hexdigest() + return os.path.join(self._root, hashed) + + def add(self, req: InstallRequirement, key: TrackerId) -> None: + """Add an InstallRequirement to build tracking.""" + + # Get the file to write information about this requirement. + entry_path = self._entry_path(key) + + # Try reading from the file. If it exists and can be read from, a build + # is already in progress, so a LookupError is raised. + try: + with open(entry_path) as fp: + contents = fp.read() + except FileNotFoundError: + pass + else: + message = f"{req.link} is already being built: {contents}" + raise LookupError(message) + + # If we're here, req should really not be building already. + assert key not in self._entries + + # Start tracking this requirement. + with open(entry_path, "w", encoding="utf-8") as fp: + fp.write(str(req)) + self._entries[key] = req + + logger.debug("Added %s to build tracker %r", req, self._root) + + def remove(self, req: InstallRequirement, key: TrackerId) -> None: + """Remove an InstallRequirement from build tracking.""" + + # Delete the created file and the corresponding entry. + os.unlink(self._entry_path(key)) + del self._entries[key] + + logger.debug("Removed %s from build tracker %r", req, self._root) + + def cleanup(self) -> None: + for key, req in list(self._entries.items()): + self.remove(req, key) + + logger.debug("Removed build tracker: %r", self._root) + + @contextlib.contextmanager + def track(self, req: InstallRequirement, key: str) -> Generator[None, None, None]: + """Ensure that `key` cannot install itself as a setup requirement. + + :raises LookupError: If `key` was already provided in a parent invocation of + the context introduced by this method.""" + tracker_id = TrackerId(key) + self.add(req, tracker_id) + yield + self.remove(req, tracker_id) diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/build/metadata.py b/env/lib/python3.12/site-packages/pip/_internal/operations/build/metadata.py new file mode 100644 index 0000000..c66ac35 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/build/metadata.py @@ -0,0 +1,39 @@ +"""Metadata generation logic for source distributions. +""" + +import os + +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip._internal.build_env import BuildEnvironment +from pip._internal.exceptions import ( + InstallationSubprocessError, + MetadataGenerationFailed, +) +from pip._internal.utils.subprocess import runner_with_spinner_message +from pip._internal.utils.temp_dir import TempDirectory + + +def generate_metadata( + build_env: BuildEnvironment, backend: BuildBackendHookCaller, details: str +) -> str: + """Generate metadata using mechanisms described in PEP 517. + + Returns the generated metadata directory. + """ + metadata_tmpdir = TempDirectory(kind="modern-metadata", globally_managed=True) + + metadata_dir = metadata_tmpdir.path + + with build_env: + # Note that BuildBackendHookCaller implements a fallback for + # prepare_metadata_for_build_wheel, so we don't have to + # consider the possibility that this hook doesn't exist. + runner = runner_with_spinner_message("Preparing metadata (pyproject.toml)") + with backend.subprocess_runner(runner): + try: + distinfo_dir = backend.prepare_metadata_for_build_wheel(metadata_dir) + except InstallationSubprocessError as error: + raise MetadataGenerationFailed(package_details=details) from error + + return os.path.join(metadata_dir, distinfo_dir) diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_editable.py b/env/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_editable.py new file mode 100644 index 0000000..3397ccf --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_editable.py @@ -0,0 +1,42 @@ +"""Metadata generation logic for source distributions. +""" + +import os + +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip._internal.build_env import BuildEnvironment +from pip._internal.exceptions import ( + InstallationSubprocessError, + MetadataGenerationFailed, +) +from pip._internal.utils.subprocess import runner_with_spinner_message +from pip._internal.utils.temp_dir import TempDirectory + + +def generate_editable_metadata( + build_env: BuildEnvironment, backend: BuildBackendHookCaller, details: str +) -> str: + """Generate metadata using mechanisms described in PEP 660. + + Returns the generated metadata directory. + """ + metadata_tmpdir = TempDirectory(kind="modern-metadata", globally_managed=True) + + metadata_dir = metadata_tmpdir.path + + with build_env: + # Note that BuildBackendHookCaller implements a fallback for + # prepare_metadata_for_build_wheel/editable, so we don't have to + # consider the possibility that this hook doesn't exist. + runner = runner_with_spinner_message( + "Preparing editable metadata (pyproject.toml)" + ) + with backend.subprocess_runner(runner): + try: + distinfo_dir = backend.prepare_metadata_for_build_editable(metadata_dir) + except InstallationSubprocessError as error: + raise MetadataGenerationFailed(package_details=details) from error + + assert distinfo_dir is not None + return os.path.join(metadata_dir, distinfo_dir) diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_legacy.py b/env/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_legacy.py new file mode 100644 index 0000000..c01dd1c --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_legacy.py @@ -0,0 +1,74 @@ +"""Metadata generation logic for legacy source distributions. +""" + +import logging +import os + +from pip._internal.build_env import BuildEnvironment +from pip._internal.cli.spinners import open_spinner +from pip._internal.exceptions import ( + InstallationError, + InstallationSubprocessError, + MetadataGenerationFailed, +) +from pip._internal.utils.setuptools_build import make_setuptools_egg_info_args +from pip._internal.utils.subprocess import call_subprocess +from pip._internal.utils.temp_dir import TempDirectory + +logger = logging.getLogger(__name__) + + +def _find_egg_info(directory: str) -> str: + """Find an .egg-info subdirectory in `directory`.""" + filenames = [f for f in os.listdir(directory) if f.endswith(".egg-info")] + + if not filenames: + raise InstallationError(f"No .egg-info directory found in {directory}") + + if len(filenames) > 1: + raise InstallationError( + f"More than one .egg-info directory found in {directory}" + ) + + return os.path.join(directory, filenames[0]) + + +def generate_metadata( + build_env: BuildEnvironment, + setup_py_path: str, + source_dir: str, + isolated: bool, + details: str, +) -> str: + """Generate metadata using setup.py-based defacto mechanisms. + + Returns the generated metadata directory. + """ + logger.debug( + "Running setup.py (path:%s) egg_info for package %s", + setup_py_path, + details, + ) + + egg_info_dir = TempDirectory(kind="pip-egg-info", globally_managed=True).path + + args = make_setuptools_egg_info_args( + setup_py_path, + egg_info_dir=egg_info_dir, + no_user_config=isolated, + ) + + with build_env: + with open_spinner("Preparing metadata (setup.py)") as spinner: + try: + call_subprocess( + args, + cwd=source_dir, + command_desc="python setup.py egg_info", + spinner=spinner, + ) + except InstallationSubprocessError as error: + raise MetadataGenerationFailed(package_details=details) from error + + # Return the .egg-info directory. + return _find_egg_info(egg_info_dir) diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/build/wheel.py b/env/lib/python3.12/site-packages/pip/_internal/operations/build/wheel.py new file mode 100644 index 0000000..064811a --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/build/wheel.py @@ -0,0 +1,37 @@ +import logging +import os +from typing import Optional + +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip._internal.utils.subprocess import runner_with_spinner_message + +logger = logging.getLogger(__name__) + + +def build_wheel_pep517( + name: str, + backend: BuildBackendHookCaller, + metadata_directory: str, + tempd: str, +) -> Optional[str]: + """Build one InstallRequirement using the PEP 517 build process. + + Returns path to wheel if successfully built. Otherwise, returns None. + """ + assert metadata_directory is not None + try: + logger.debug("Destination directory: %s", tempd) + + runner = runner_with_spinner_message( + f"Building wheel for {name} (pyproject.toml)" + ) + with backend.subprocess_runner(runner): + wheel_name = backend.build_wheel( + tempd, + metadata_directory=metadata_directory, + ) + except Exception: + logger.error("Failed building wheel for %s", name) + return None + return os.path.join(tempd, wheel_name) diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_editable.py b/env/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_editable.py new file mode 100644 index 0000000..719d69d --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_editable.py @@ -0,0 +1,46 @@ +import logging +import os +from typing import Optional + +from pip._vendor.pyproject_hooks import BuildBackendHookCaller, HookMissing + +from pip._internal.utils.subprocess import runner_with_spinner_message + +logger = logging.getLogger(__name__) + + +def build_wheel_editable( + name: str, + backend: BuildBackendHookCaller, + metadata_directory: str, + tempd: str, +) -> Optional[str]: + """Build one InstallRequirement using the PEP 660 build process. + + Returns path to wheel if successfully built. Otherwise, returns None. + """ + assert metadata_directory is not None + try: + logger.debug("Destination directory: %s", tempd) + + runner = runner_with_spinner_message( + f"Building editable for {name} (pyproject.toml)" + ) + with backend.subprocess_runner(runner): + try: + wheel_name = backend.build_editable( + tempd, + metadata_directory=metadata_directory, + ) + except HookMissing as e: + logger.error( + "Cannot build editable %s because the build " + "backend does not have the %s hook", + name, + e, + ) + return None + except Exception: + logger.error("Failed building editable for %s", name) + return None + return os.path.join(tempd, wheel_name) diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_legacy.py b/env/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_legacy.py new file mode 100644 index 0000000..3ee2a70 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_legacy.py @@ -0,0 +1,102 @@ +import logging +import os.path +from typing import List, Optional + +from pip._internal.cli.spinners import open_spinner +from pip._internal.utils.setuptools_build import make_setuptools_bdist_wheel_args +from pip._internal.utils.subprocess import call_subprocess, format_command_args + +logger = logging.getLogger(__name__) + + +def format_command_result( + command_args: List[str], + command_output: str, +) -> str: + """Format command information for logging.""" + command_desc = format_command_args(command_args) + text = f"Command arguments: {command_desc}\n" + + if not command_output: + text += "Command output: None" + elif logger.getEffectiveLevel() > logging.DEBUG: + text += "Command output: [use --verbose to show]" + else: + if not command_output.endswith("\n"): + command_output += "\n" + text += f"Command output:\n{command_output}" + + return text + + +def get_legacy_build_wheel_path( + names: List[str], + temp_dir: str, + name: str, + command_args: List[str], + command_output: str, +) -> Optional[str]: + """Return the path to the wheel in the temporary build directory.""" + # Sort for determinism. + names = sorted(names) + if not names: + msg = f"Legacy build of wheel for {name!r} created no files.\n" + msg += format_command_result(command_args, command_output) + logger.warning(msg) + return None + + if len(names) > 1: + msg = ( + f"Legacy build of wheel for {name!r} created more than one file.\n" + f"Filenames (choosing first): {names}\n" + ) + msg += format_command_result(command_args, command_output) + logger.warning(msg) + + return os.path.join(temp_dir, names[0]) + + +def build_wheel_legacy( + name: str, + setup_py_path: str, + source_dir: str, + global_options: List[str], + build_options: List[str], + tempd: str, +) -> Optional[str]: + """Build one unpacked package using the "legacy" build process. + + Returns path to wheel if successfully built. Otherwise, returns None. + """ + wheel_args = make_setuptools_bdist_wheel_args( + setup_py_path, + global_options=global_options, + build_options=build_options, + destination_dir=tempd, + ) + + spin_message = f"Building wheel for {name} (setup.py)" + with open_spinner(spin_message) as spinner: + logger.debug("Destination directory: %s", tempd) + + try: + output = call_subprocess( + wheel_args, + command_desc="python setup.py bdist_wheel", + cwd=source_dir, + spinner=spinner, + ) + except Exception: + spinner.finish("error") + logger.error("Failed building wheel for %s", name) + return None + + names = os.listdir(tempd) + wheel_path = get_legacy_build_wheel_path( + names=names, + temp_dir=tempd, + name=name, + command_args=wheel_args, + command_output=output, + ) + return wheel_path diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/check.py b/env/lib/python3.12/site-packages/pip/_internal/operations/check.py new file mode 100644 index 0000000..4b6fbc4 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/check.py @@ -0,0 +1,181 @@ +"""Validation of dependencies of packages +""" + +import logging +from contextlib import suppress +from email.parser import Parser +from functools import reduce +from typing import ( + Callable, + Dict, + FrozenSet, + Generator, + Iterable, + List, + NamedTuple, + Optional, + Set, + Tuple, +) + +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.tags import Tag, parse_tag +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version + +from pip._internal.distributions import make_distribution_for_install_requirement +from pip._internal.metadata import get_default_environment +from pip._internal.metadata.base import BaseDistribution +from pip._internal.req.req_install import InstallRequirement + +logger = logging.getLogger(__name__) + + +class PackageDetails(NamedTuple): + version: Version + dependencies: List[Requirement] + + +# Shorthands +PackageSet = Dict[NormalizedName, PackageDetails] +Missing = Tuple[NormalizedName, Requirement] +Conflicting = Tuple[NormalizedName, Version, Requirement] + +MissingDict = Dict[NormalizedName, List[Missing]] +ConflictingDict = Dict[NormalizedName, List[Conflicting]] +CheckResult = Tuple[MissingDict, ConflictingDict] +ConflictDetails = Tuple[PackageSet, CheckResult] + + +def create_package_set_from_installed() -> Tuple[PackageSet, bool]: + """Converts a list of distributions into a PackageSet.""" + package_set = {} + problems = False + env = get_default_environment() + for dist in env.iter_installed_distributions(local_only=False, skip=()): + name = dist.canonical_name + try: + dependencies = list(dist.iter_dependencies()) + package_set[name] = PackageDetails(dist.version, dependencies) + except (OSError, ValueError) as e: + # Don't crash on unreadable or broken metadata. + logger.warning("Error parsing dependencies of %s: %s", name, e) + problems = True + return package_set, problems + + +def check_package_set( + package_set: PackageSet, should_ignore: Optional[Callable[[str], bool]] = None +) -> CheckResult: + """Check if a package set is consistent + + If should_ignore is passed, it should be a callable that takes a + package name and returns a boolean. + """ + + missing = {} + conflicting = {} + + for package_name, package_detail in package_set.items(): + # Info about dependencies of package_name + missing_deps: Set[Missing] = set() + conflicting_deps: Set[Conflicting] = set() + + if should_ignore and should_ignore(package_name): + continue + + for req in package_detail.dependencies: + name = canonicalize_name(req.name) + + # Check if it's missing + if name not in package_set: + missed = True + if req.marker is not None: + missed = req.marker.evaluate({"extra": ""}) + if missed: + missing_deps.add((name, req)) + continue + + # Check if there's a conflict + version = package_set[name].version + if not req.specifier.contains(version, prereleases=True): + conflicting_deps.add((name, version, req)) + + if missing_deps: + missing[package_name] = sorted(missing_deps, key=str) + if conflicting_deps: + conflicting[package_name] = sorted(conflicting_deps, key=str) + + return missing, conflicting + + +def check_install_conflicts(to_install: List[InstallRequirement]) -> ConflictDetails: + """For checking if the dependency graph would be consistent after \ + installing given requirements + """ + # Start from the current state + package_set, _ = create_package_set_from_installed() + # Install packages + would_be_installed = _simulate_installation_of(to_install, package_set) + + # Only warn about directly-dependent packages; create a whitelist of them + whitelist = _create_whitelist(would_be_installed, package_set) + + return ( + package_set, + check_package_set( + package_set, should_ignore=lambda name: name not in whitelist + ), + ) + + +def check_unsupported( + packages: Iterable[BaseDistribution], + supported_tags: Iterable[Tag], +) -> Generator[BaseDistribution, None, None]: + for p in packages: + with suppress(FileNotFoundError): + wheel_file = p.read_text("WHEEL") + wheel_tags: FrozenSet[Tag] = reduce( + frozenset.union, + map(parse_tag, Parser().parsestr(wheel_file).get_all("Tag", [])), + frozenset(), + ) + if wheel_tags.isdisjoint(supported_tags): + yield p + + +def _simulate_installation_of( + to_install: List[InstallRequirement], package_set: PackageSet +) -> Set[NormalizedName]: + """Computes the version of packages after installing to_install.""" + # Keep track of packages that were installed + installed = set() + + # Modify it as installing requirement_set would (assuming no errors) + for inst_req in to_install: + abstract_dist = make_distribution_for_install_requirement(inst_req) + dist = abstract_dist.get_metadata_distribution() + name = dist.canonical_name + package_set[name] = PackageDetails(dist.version, list(dist.iter_dependencies())) + + installed.add(name) + + return installed + + +def _create_whitelist( + would_be_installed: Set[NormalizedName], package_set: PackageSet +) -> Set[NormalizedName]: + packages_affected = set(would_be_installed) + + for package_name in package_set: + if package_name in packages_affected: + continue + + for req in package_set[package_name].dependencies: + if canonicalize_name(req.name) in packages_affected: + packages_affected.add(package_name) + break + + return packages_affected diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/freeze.py b/env/lib/python3.12/site-packages/pip/_internal/operations/freeze.py new file mode 100644 index 0000000..ae5dd37 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/freeze.py @@ -0,0 +1,256 @@ +import collections +import logging +import os +from dataclasses import dataclass, field +from typing import Container, Dict, Generator, Iterable, List, NamedTuple, Optional, Set + +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import InvalidVersion + +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.metadata import BaseDistribution, get_environment +from pip._internal.req.constructors import ( + install_req_from_editable, + install_req_from_line, +) +from pip._internal.req.req_file import COMMENT_RE +from pip._internal.utils.direct_url_helpers import direct_url_as_pep440_direct_reference + +logger = logging.getLogger(__name__) + + +class _EditableInfo(NamedTuple): + requirement: str + comments: List[str] + + +def freeze( + requirement: Optional[List[str]] = None, + local_only: bool = False, + user_only: bool = False, + paths: Optional[List[str]] = None, + isolated: bool = False, + exclude_editable: bool = False, + skip: Container[str] = (), +) -> Generator[str, None, None]: + installations: Dict[str, FrozenRequirement] = {} + + dists = get_environment(paths).iter_installed_distributions( + local_only=local_only, + skip=(), + user_only=user_only, + ) + for dist in dists: + req = FrozenRequirement.from_dist(dist) + if exclude_editable and req.editable: + continue + installations[req.canonical_name] = req + + if requirement: + # the options that don't get turned into an InstallRequirement + # should only be emitted once, even if the same option is in multiple + # requirements files, so we need to keep track of what has been emitted + # so that we don't emit it again if it's seen again + emitted_options: Set[str] = set() + # keep track of which files a requirement is in so that we can + # give an accurate warning if a requirement appears multiple times. + req_files: Dict[str, List[str]] = collections.defaultdict(list) + for req_file_path in requirement: + with open(req_file_path) as req_file: + for line in req_file: + if ( + not line.strip() + or line.strip().startswith("#") + or line.startswith( + ( + "-r", + "--requirement", + "-f", + "--find-links", + "-i", + "--index-url", + "--pre", + "--trusted-host", + "--process-dependency-links", + "--extra-index-url", + "--use-feature", + ) + ) + ): + line = line.rstrip() + if line not in emitted_options: + emitted_options.add(line) + yield line + continue + + if line.startswith("-e") or line.startswith("--editable"): + if line.startswith("-e"): + line = line[2:].strip() + else: + line = line[len("--editable") :].strip().lstrip("=") + line_req = install_req_from_editable( + line, + isolated=isolated, + ) + else: + line_req = install_req_from_line( + COMMENT_RE.sub("", line).strip(), + isolated=isolated, + ) + + if not line_req.name: + logger.info( + "Skipping line in requirement file [%s] because " + "it's not clear what it would install: %s", + req_file_path, + line.strip(), + ) + logger.info( + " (add #egg=PackageName to the URL to avoid" + " this warning)" + ) + else: + line_req_canonical_name = canonicalize_name(line_req.name) + if line_req_canonical_name not in installations: + # either it's not installed, or it is installed + # but has been processed already + if not req_files[line_req.name]: + logger.warning( + "Requirement file [%s] contains %s, but " + "package %r is not installed", + req_file_path, + COMMENT_RE.sub("", line).strip(), + line_req.name, + ) + else: + req_files[line_req.name].append(req_file_path) + else: + yield str(installations[line_req_canonical_name]).rstrip() + del installations[line_req_canonical_name] + req_files[line_req.name].append(req_file_path) + + # Warn about requirements that were included multiple times (in a + # single requirements file or in different requirements files). + for name, files in req_files.items(): + if len(files) > 1: + logger.warning( + "Requirement %s included multiple times [%s]", + name, + ", ".join(sorted(set(files))), + ) + + yield ("## The following requirements were added by pip freeze:") + for installation in sorted(installations.values(), key=lambda x: x.name.lower()): + if installation.canonical_name not in skip: + yield str(installation).rstrip() + + +def _format_as_name_version(dist: BaseDistribution) -> str: + try: + dist_version = dist.version + except InvalidVersion: + # legacy version + return f"{dist.raw_name}==={dist.raw_version}" + else: + return f"{dist.raw_name}=={dist_version}" + + +def _get_editable_info(dist: BaseDistribution) -> _EditableInfo: + """ + Compute and return values (req, comments) for use in + FrozenRequirement.from_dist(). + """ + editable_project_location = dist.editable_project_location + assert editable_project_location + location = os.path.normcase(os.path.abspath(editable_project_location)) + + from pip._internal.vcs import RemoteNotFoundError, RemoteNotValidError, vcs + + vcs_backend = vcs.get_backend_for_dir(location) + + if vcs_backend is None: + display = _format_as_name_version(dist) + logger.debug( + 'No VCS found for editable requirement "%s" in: %r', + display, + location, + ) + return _EditableInfo( + requirement=location, + comments=[f"# Editable install with no version control ({display})"], + ) + + vcs_name = type(vcs_backend).__name__ + + try: + req = vcs_backend.get_src_requirement(location, dist.raw_name) + except RemoteNotFoundError: + display = _format_as_name_version(dist) + return _EditableInfo( + requirement=location, + comments=[f"# Editable {vcs_name} install with no remote ({display})"], + ) + except RemoteNotValidError as ex: + display = _format_as_name_version(dist) + return _EditableInfo( + requirement=location, + comments=[ + f"# Editable {vcs_name} install ({display}) with either a deleted " + f"local remote or invalid URI:", + f"# '{ex.url}'", + ], + ) + except BadCommand: + logger.warning( + "cannot determine version of editable source in %s " + "(%s command not found in path)", + location, + vcs_backend.name, + ) + return _EditableInfo(requirement=location, comments=[]) + except InstallationError as exc: + logger.warning("Error when trying to get requirement for VCS system %s", exc) + else: + return _EditableInfo(requirement=req, comments=[]) + + logger.warning("Could not determine repository location of %s", location) + + return _EditableInfo( + requirement=location, + comments=["## !! Could not determine repository location"], + ) + + +@dataclass(frozen=True) +class FrozenRequirement: + name: str + req: str + editable: bool + comments: Iterable[str] = field(default_factory=tuple) + + @property + def canonical_name(self) -> NormalizedName: + return canonicalize_name(self.name) + + @classmethod + def from_dist(cls, dist: BaseDistribution) -> "FrozenRequirement": + editable = dist.editable + if editable: + req, comments = _get_editable_info(dist) + else: + comments = [] + direct_url = dist.direct_url + if direct_url: + # if PEP 610 metadata is present, use it + req = direct_url_as_pep440_direct_reference(direct_url, dist.raw_name) + else: + # name==version requirement + req = _format_as_name_version(dist) + + return cls(dist.raw_name, req, editable, comments=comments) + + def __str__(self) -> str: + req = self.req + if self.editable: + req = f"-e {req}" + return "\n".join(list(self.comments) + [str(req)]) + "\n" diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/install/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/operations/install/__init__.py new file mode 100644 index 0000000..24d6a5d --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/install/__init__.py @@ -0,0 +1,2 @@ +"""For modules related to installing packages. +""" diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/install/editable_legacy.py b/env/lib/python3.12/site-packages/pip/_internal/operations/install/editable_legacy.py new file mode 100644 index 0000000..9aaa699 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/install/editable_legacy.py @@ -0,0 +1,47 @@ +"""Legacy editable installation process, i.e. `setup.py develop`. +""" + +import logging +from typing import Optional, Sequence + +from pip._internal.build_env import BuildEnvironment +from pip._internal.utils.logging import indent_log +from pip._internal.utils.setuptools_build import make_setuptools_develop_args +from pip._internal.utils.subprocess import call_subprocess + +logger = logging.getLogger(__name__) + + +def install_editable( + *, + global_options: Sequence[str], + prefix: Optional[str], + home: Optional[str], + use_user_site: bool, + name: str, + setup_py_path: str, + isolated: bool, + build_env: BuildEnvironment, + unpacked_source_directory: str, +) -> None: + """Install a package in editable mode. Most arguments are pass-through + to setuptools. + """ + logger.info("Running setup.py develop for %s", name) + + args = make_setuptools_develop_args( + setup_py_path, + global_options=global_options, + no_user_config=isolated, + prefix=prefix, + home=home, + use_user_site=use_user_site, + ) + + with indent_log(): + with build_env: + call_subprocess( + args, + command_desc="python setup.py develop", + cwd=unpacked_source_directory, + ) diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/install/wheel.py b/env/lib/python3.12/site-packages/pip/_internal/operations/install/wheel.py new file mode 100644 index 0000000..aef42aa --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/install/wheel.py @@ -0,0 +1,741 @@ +"""Support for installing and building the "wheel" binary package format. +""" + +import collections +import compileall +import contextlib +import csv +import importlib +import logging +import os.path +import re +import shutil +import sys +import warnings +from base64 import urlsafe_b64encode +from email.message import Message +from itertools import chain, filterfalse, starmap +from typing import ( + IO, + TYPE_CHECKING, + Any, + BinaryIO, + Callable, + Dict, + Generator, + Iterable, + Iterator, + List, + NewType, + Optional, + Protocol, + Sequence, + Set, + Tuple, + Union, + cast, +) +from zipfile import ZipFile, ZipInfo + +from pip._vendor.distlib.scripts import ScriptMaker +from pip._vendor.distlib.util import get_export_entry +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import InstallationError +from pip._internal.locations import get_major_minor_version +from pip._internal.metadata import ( + BaseDistribution, + FilesystemWheel, + get_wheel_distribution, +) +from pip._internal.models.direct_url import DIRECT_URL_METADATA_NAME, DirectUrl +from pip._internal.models.scheme import SCHEME_KEYS, Scheme +from pip._internal.utils.filesystem import adjacent_tmp_file, replace +from pip._internal.utils.misc import StreamWrapper, ensure_dir, hash_file, partition +from pip._internal.utils.unpacking import ( + current_umask, + is_within_directory, + set_extracted_file_to_default_mode_plus_executable, + zip_item_is_executable, +) +from pip._internal.utils.wheel import parse_wheel + +if TYPE_CHECKING: + + class File(Protocol): + src_record_path: "RecordPath" + dest_path: str + changed: bool + + def save(self) -> None: + pass + + +logger = logging.getLogger(__name__) + +RecordPath = NewType("RecordPath", str) +InstalledCSVRow = Tuple[RecordPath, str, Union[int, str]] + + +def rehash(path: str, blocksize: int = 1 << 20) -> Tuple[str, str]: + """Return (encoded_digest, length) for path using hashlib.sha256()""" + h, length = hash_file(path, blocksize) + digest = "sha256=" + urlsafe_b64encode(h.digest()).decode("latin1").rstrip("=") + return (digest, str(length)) + + +def csv_io_kwargs(mode: str) -> Dict[str, Any]: + """Return keyword arguments to properly open a CSV file + in the given mode. + """ + return {"mode": mode, "newline": "", "encoding": "utf-8"} + + +def fix_script(path: str) -> bool: + """Replace #!python with #!/path/to/python + Return True if file was changed. + """ + # XXX RECORD hashes will need to be updated + assert os.path.isfile(path) + + with open(path, "rb") as script: + firstline = script.readline() + if not firstline.startswith(b"#!python"): + return False + exename = sys.executable.encode(sys.getfilesystemencoding()) + firstline = b"#!" + exename + os.linesep.encode("ascii") + rest = script.read() + with open(path, "wb") as script: + script.write(firstline) + script.write(rest) + return True + + +def wheel_root_is_purelib(metadata: Message) -> bool: + return metadata.get("Root-Is-Purelib", "").lower() == "true" + + +def get_entrypoints(dist: BaseDistribution) -> Tuple[Dict[str, str], Dict[str, str]]: + console_scripts = {} + gui_scripts = {} + for entry_point in dist.iter_entry_points(): + if entry_point.group == "console_scripts": + console_scripts[entry_point.name] = entry_point.value + elif entry_point.group == "gui_scripts": + gui_scripts[entry_point.name] = entry_point.value + return console_scripts, gui_scripts + + +def message_about_scripts_not_on_PATH(scripts: Sequence[str]) -> Optional[str]: + """Determine if any scripts are not on PATH and format a warning. + Returns a warning message if one or more scripts are not on PATH, + otherwise None. + """ + if not scripts: + return None + + # Group scripts by the path they were installed in + grouped_by_dir: Dict[str, Set[str]] = collections.defaultdict(set) + for destfile in scripts: + parent_dir = os.path.dirname(destfile) + script_name = os.path.basename(destfile) + grouped_by_dir[parent_dir].add(script_name) + + # We don't want to warn for directories that are on PATH. + not_warn_dirs = [ + os.path.normcase(os.path.normpath(i)).rstrip(os.sep) + for i in os.environ.get("PATH", "").split(os.pathsep) + ] + # If an executable sits with sys.executable, we don't warn for it. + # This covers the case of venv invocations without activating the venv. + not_warn_dirs.append( + os.path.normcase(os.path.normpath(os.path.dirname(sys.executable))) + ) + warn_for: Dict[str, Set[str]] = { + parent_dir: scripts + for parent_dir, scripts in grouped_by_dir.items() + if os.path.normcase(os.path.normpath(parent_dir)) not in not_warn_dirs + } + if not warn_for: + return None + + # Format a message + msg_lines = [] + for parent_dir, dir_scripts in warn_for.items(): + sorted_scripts: List[str] = sorted(dir_scripts) + if len(sorted_scripts) == 1: + start_text = f"script {sorted_scripts[0]} is" + else: + start_text = "scripts {} are".format( + ", ".join(sorted_scripts[:-1]) + " and " + sorted_scripts[-1] + ) + + msg_lines.append( + f"The {start_text} installed in '{parent_dir}' which is not on PATH." + ) + + last_line_fmt = ( + "Consider adding {} to PATH or, if you prefer " + "to suppress this warning, use --no-warn-script-location." + ) + if len(msg_lines) == 1: + msg_lines.append(last_line_fmt.format("this directory")) + else: + msg_lines.append(last_line_fmt.format("these directories")) + + # Add a note if any directory starts with ~ + warn_for_tilde = any( + i[0] == "~" for i in os.environ.get("PATH", "").split(os.pathsep) if i + ) + if warn_for_tilde: + tilde_warning_msg = ( + "NOTE: The current PATH contains path(s) starting with `~`, " + "which may not be expanded by all applications." + ) + msg_lines.append(tilde_warning_msg) + + # Returns the formatted multiline message + return "\n".join(msg_lines) + + +def _normalized_outrows( + outrows: Iterable[InstalledCSVRow], +) -> List[Tuple[str, str, str]]: + """Normalize the given rows of a RECORD file. + + Items in each row are converted into str. Rows are then sorted to make + the value more predictable for tests. + + Each row is a 3-tuple (path, hash, size) and corresponds to a record of + a RECORD file (see PEP 376 and PEP 427 for details). For the rows + passed to this function, the size can be an integer as an int or string, + or the empty string. + """ + # Normally, there should only be one row per path, in which case the + # second and third elements don't come into play when sorting. + # However, in cases in the wild where a path might happen to occur twice, + # we don't want the sort operation to trigger an error (but still want + # determinism). Since the third element can be an int or string, we + # coerce each element to a string to avoid a TypeError in this case. + # For additional background, see-- + # https://github.com/pypa/pip/issues/5868 + return sorted( + (record_path, hash_, str(size)) for record_path, hash_, size in outrows + ) + + +def _record_to_fs_path(record_path: RecordPath, lib_dir: str) -> str: + return os.path.join(lib_dir, record_path) + + +def _fs_to_record_path(path: str, lib_dir: str) -> RecordPath: + # On Windows, do not handle relative paths if they belong to different + # logical disks + if os.path.splitdrive(path)[0].lower() == os.path.splitdrive(lib_dir)[0].lower(): + path = os.path.relpath(path, lib_dir) + + path = path.replace(os.path.sep, "/") + return cast("RecordPath", path) + + +def get_csv_rows_for_installed( + old_csv_rows: List[List[str]], + installed: Dict[RecordPath, RecordPath], + changed: Set[RecordPath], + generated: List[str], + lib_dir: str, +) -> List[InstalledCSVRow]: + """ + :param installed: A map from archive RECORD path to installation RECORD + path. + """ + installed_rows: List[InstalledCSVRow] = [] + for row in old_csv_rows: + if len(row) > 3: + logger.warning("RECORD line has more than three elements: %s", row) + old_record_path = cast("RecordPath", row[0]) + new_record_path = installed.pop(old_record_path, old_record_path) + if new_record_path in changed: + digest, length = rehash(_record_to_fs_path(new_record_path, lib_dir)) + else: + digest = row[1] if len(row) > 1 else "" + length = row[2] if len(row) > 2 else "" + installed_rows.append((new_record_path, digest, length)) + for f in generated: + path = _fs_to_record_path(f, lib_dir) + digest, length = rehash(f) + installed_rows.append((path, digest, length)) + return installed_rows + [ + (installed_record_path, "", "") for installed_record_path in installed.values() + ] + + +def get_console_script_specs(console: Dict[str, str]) -> List[str]: + """ + Given the mapping from entrypoint name to callable, return the relevant + console script specs. + """ + # Don't mutate caller's version + console = console.copy() + + scripts_to_generate = [] + + # Special case pip and setuptools to generate versioned wrappers + # + # The issue is that some projects (specifically, pip and setuptools) use + # code in setup.py to create "versioned" entry points - pip2.7 on Python + # 2.7, pip3.3 on Python 3.3, etc. But these entry points are baked into + # the wheel metadata at build time, and so if the wheel is installed with + # a *different* version of Python the entry points will be wrong. The + # correct fix for this is to enhance the metadata to be able to describe + # such versioned entry points. + # Currently, projects using versioned entry points will either have + # incorrect versioned entry points, or they will not be able to distribute + # "universal" wheels (i.e., they will need a wheel per Python version). + # + # Because setuptools and pip are bundled with _ensurepip and virtualenv, + # we need to use universal wheels. As a workaround, we + # override the versioned entry points in the wheel and generate the + # correct ones. + # + # To add the level of hack in this section of code, in order to support + # ensurepip this code will look for an ``ENSUREPIP_OPTIONS`` environment + # variable which will control which version scripts get installed. + # + # ENSUREPIP_OPTIONS=altinstall + # - Only pipX.Y and easy_install-X.Y will be generated and installed + # ENSUREPIP_OPTIONS=install + # - pipX.Y, pipX, easy_install-X.Y will be generated and installed. Note + # that this option is technically if ENSUREPIP_OPTIONS is set and is + # not altinstall + # DEFAULT + # - The default behavior is to install pip, pipX, pipX.Y, easy_install + # and easy_install-X.Y. + pip_script = console.pop("pip", None) + if pip_script: + if "ENSUREPIP_OPTIONS" not in os.environ: + scripts_to_generate.append("pip = " + pip_script) + + if os.environ.get("ENSUREPIP_OPTIONS", "") != "altinstall": + scripts_to_generate.append(f"pip{sys.version_info[0]} = {pip_script}") + + scripts_to_generate.append(f"pip{get_major_minor_version()} = {pip_script}") + # Delete any other versioned pip entry points + pip_ep = [k for k in console if re.match(r"pip(\d+(\.\d+)?)?$", k)] + for k in pip_ep: + del console[k] + easy_install_script = console.pop("easy_install", None) + if easy_install_script: + if "ENSUREPIP_OPTIONS" not in os.environ: + scripts_to_generate.append("easy_install = " + easy_install_script) + + scripts_to_generate.append( + f"easy_install-{get_major_minor_version()} = {easy_install_script}" + ) + # Delete any other versioned easy_install entry points + easy_install_ep = [ + k for k in console if re.match(r"easy_install(-\d+\.\d+)?$", k) + ] + for k in easy_install_ep: + del console[k] + + # Generate the console entry points specified in the wheel + scripts_to_generate.extend(starmap("{} = {}".format, console.items())) + + return scripts_to_generate + + +class ZipBackedFile: + def __init__( + self, src_record_path: RecordPath, dest_path: str, zip_file: ZipFile + ) -> None: + self.src_record_path = src_record_path + self.dest_path = dest_path + self._zip_file = zip_file + self.changed = False + + def _getinfo(self) -> ZipInfo: + return self._zip_file.getinfo(self.src_record_path) + + def save(self) -> None: + # When we open the output file below, any existing file is truncated + # before we start writing the new contents. This is fine in most + # cases, but can cause a segfault if pip has loaded a shared + # object (e.g. from pyopenssl through its vendored urllib3) + # Since the shared object is mmap'd an attempt to call a + # symbol in it will then cause a segfault. Unlinking the file + # allows writing of new contents while allowing the process to + # continue to use the old copy. + if os.path.exists(self.dest_path): + os.unlink(self.dest_path) + + zipinfo = self._getinfo() + + # optimization: the file is created by open(), + # skip the decompression when there is 0 bytes to decompress. + with open(self.dest_path, "wb") as dest: + if zipinfo.file_size > 0: + with self._zip_file.open(zipinfo) as f: + blocksize = min(zipinfo.file_size, 1024 * 1024) + shutil.copyfileobj(f, dest, blocksize) + + if zip_item_is_executable(zipinfo): + set_extracted_file_to_default_mode_plus_executable(self.dest_path) + + +class ScriptFile: + def __init__(self, file: "File") -> None: + self._file = file + self.src_record_path = self._file.src_record_path + self.dest_path = self._file.dest_path + self.changed = False + + def save(self) -> None: + self._file.save() + self.changed = fix_script(self.dest_path) + + +class MissingCallableSuffix(InstallationError): + def __init__(self, entry_point: str) -> None: + super().__init__( + f"Invalid script entry point: {entry_point} - A callable " + "suffix is required. Cf https://packaging.python.org/" + "specifications/entry-points/#use-for-scripts for more " + "information." + ) + + +def _raise_for_invalid_entrypoint(specification: str) -> None: + entry = get_export_entry(specification) + if entry is not None and entry.suffix is None: + raise MissingCallableSuffix(str(entry)) + + +class PipScriptMaker(ScriptMaker): + def make( + self, specification: str, options: Optional[Dict[str, Any]] = None + ) -> List[str]: + _raise_for_invalid_entrypoint(specification) + return super().make(specification, options) + + +def _install_wheel( # noqa: C901, PLR0915 function is too long + name: str, + wheel_zip: ZipFile, + wheel_path: str, + scheme: Scheme, + pycompile: bool = True, + warn_script_location: bool = True, + direct_url: Optional[DirectUrl] = None, + requested: bool = False, +) -> None: + """Install a wheel. + + :param name: Name of the project to install + :param wheel_zip: open ZipFile for wheel being installed + :param scheme: Distutils scheme dictating the install directories + :param req_description: String used in place of the requirement, for + logging + :param pycompile: Whether to byte-compile installed Python files + :param warn_script_location: Whether to check that scripts are installed + into a directory on PATH + :raises UnsupportedWheel: + * when the directory holds an unpacked wheel with incompatible + Wheel-Version + * when the .dist-info dir does not match the wheel + """ + info_dir, metadata = parse_wheel(wheel_zip, name) + + if wheel_root_is_purelib(metadata): + lib_dir = scheme.purelib + else: + lib_dir = scheme.platlib + + # Record details of the files moved + # installed = files copied from the wheel to the destination + # changed = files changed while installing (scripts #! line typically) + # generated = files newly generated during the install (script wrappers) + installed: Dict[RecordPath, RecordPath] = {} + changed: Set[RecordPath] = set() + generated: List[str] = [] + + def record_installed( + srcfile: RecordPath, destfile: str, modified: bool = False + ) -> None: + """Map archive RECORD paths to installation RECORD paths.""" + newpath = _fs_to_record_path(destfile, lib_dir) + installed[srcfile] = newpath + if modified: + changed.add(newpath) + + def is_dir_path(path: RecordPath) -> bool: + return path.endswith("/") + + def assert_no_path_traversal(dest_dir_path: str, target_path: str) -> None: + if not is_within_directory(dest_dir_path, target_path): + message = ( + "The wheel {!r} has a file {!r} trying to install" + " outside the target directory {!r}" + ) + raise InstallationError( + message.format(wheel_path, target_path, dest_dir_path) + ) + + def root_scheme_file_maker( + zip_file: ZipFile, dest: str + ) -> Callable[[RecordPath], "File"]: + def make_root_scheme_file(record_path: RecordPath) -> "File": + normed_path = os.path.normpath(record_path) + dest_path = os.path.join(dest, normed_path) + assert_no_path_traversal(dest, dest_path) + return ZipBackedFile(record_path, dest_path, zip_file) + + return make_root_scheme_file + + def data_scheme_file_maker( + zip_file: ZipFile, scheme: Scheme + ) -> Callable[[RecordPath], "File"]: + scheme_paths = {key: getattr(scheme, key) for key in SCHEME_KEYS} + + def make_data_scheme_file(record_path: RecordPath) -> "File": + normed_path = os.path.normpath(record_path) + try: + _, scheme_key, dest_subpath = normed_path.split(os.path.sep, 2) + except ValueError: + message = ( + f"Unexpected file in {wheel_path}: {record_path!r}. .data directory" + " contents should be named like: '/'." + ) + raise InstallationError(message) + + try: + scheme_path = scheme_paths[scheme_key] + except KeyError: + valid_scheme_keys = ", ".join(sorted(scheme_paths)) + message = ( + f"Unknown scheme key used in {wheel_path}: {scheme_key} " + f"(for file {record_path!r}). .data directory contents " + f"should be in subdirectories named with a valid scheme " + f"key ({valid_scheme_keys})" + ) + raise InstallationError(message) + + dest_path = os.path.join(scheme_path, dest_subpath) + assert_no_path_traversal(scheme_path, dest_path) + return ZipBackedFile(record_path, dest_path, zip_file) + + return make_data_scheme_file + + def is_data_scheme_path(path: RecordPath) -> bool: + return path.split("/", 1)[0].endswith(".data") + + paths = cast(List[RecordPath], wheel_zip.namelist()) + file_paths = filterfalse(is_dir_path, paths) + root_scheme_paths, data_scheme_paths = partition(is_data_scheme_path, file_paths) + + make_root_scheme_file = root_scheme_file_maker(wheel_zip, lib_dir) + files: Iterator[File] = map(make_root_scheme_file, root_scheme_paths) + + def is_script_scheme_path(path: RecordPath) -> bool: + parts = path.split("/", 2) + return len(parts) > 2 and parts[0].endswith(".data") and parts[1] == "scripts" + + other_scheme_paths, script_scheme_paths = partition( + is_script_scheme_path, data_scheme_paths + ) + + make_data_scheme_file = data_scheme_file_maker(wheel_zip, scheme) + other_scheme_files = map(make_data_scheme_file, other_scheme_paths) + files = chain(files, other_scheme_files) + + # Get the defined entry points + distribution = get_wheel_distribution( + FilesystemWheel(wheel_path), + canonicalize_name(name), + ) + console, gui = get_entrypoints(distribution) + + def is_entrypoint_wrapper(file: "File") -> bool: + # EP, EP.exe and EP-script.py are scripts generated for + # entry point EP by setuptools + path = file.dest_path + name = os.path.basename(path) + if name.lower().endswith(".exe"): + matchname = name[:-4] + elif name.lower().endswith("-script.py"): + matchname = name[:-10] + elif name.lower().endswith(".pya"): + matchname = name[:-4] + else: + matchname = name + # Ignore setuptools-generated scripts + return matchname in console or matchname in gui + + script_scheme_files: Iterator[File] = map( + make_data_scheme_file, script_scheme_paths + ) + script_scheme_files = filterfalse(is_entrypoint_wrapper, script_scheme_files) + script_scheme_files = map(ScriptFile, script_scheme_files) + files = chain(files, script_scheme_files) + + existing_parents = set() + for file in files: + # directory creation is lazy and after file filtering + # to ensure we don't install empty dirs; empty dirs can't be + # uninstalled. + parent_dir = os.path.dirname(file.dest_path) + if parent_dir not in existing_parents: + ensure_dir(parent_dir) + existing_parents.add(parent_dir) + file.save() + record_installed(file.src_record_path, file.dest_path, file.changed) + + def pyc_source_file_paths() -> Generator[str, None, None]: + # We de-duplicate installation paths, since there can be overlap (e.g. + # file in .data maps to same location as file in wheel root). + # Sorting installation paths makes it easier to reproduce and debug + # issues related to permissions on existing files. + for installed_path in sorted(set(installed.values())): + full_installed_path = os.path.join(lib_dir, installed_path) + if not os.path.isfile(full_installed_path): + continue + if not full_installed_path.endswith(".py"): + continue + yield full_installed_path + + def pyc_output_path(path: str) -> str: + """Return the path the pyc file would have been written to.""" + return importlib.util.cache_from_source(path) + + # Compile all of the pyc files for the installed files + if pycompile: + with contextlib.redirect_stdout( + StreamWrapper.from_stream(sys.stdout) + ) as stdout: + with warnings.catch_warnings(): + warnings.filterwarnings("ignore") + for path in pyc_source_file_paths(): + success = compileall.compile_file(path, force=True, quiet=True) + if success: + pyc_path = pyc_output_path(path) + assert os.path.exists(pyc_path) + pyc_record_path = cast( + "RecordPath", pyc_path.replace(os.path.sep, "/") + ) + record_installed(pyc_record_path, pyc_path) + logger.debug(stdout.getvalue()) + + maker = PipScriptMaker(None, scheme.scripts) + + # Ensure old scripts are overwritten. + # See https://github.com/pypa/pip/issues/1800 + maker.clobber = True + + # Ensure we don't generate any variants for scripts because this is almost + # never what somebody wants. + # See https://bitbucket.org/pypa/distlib/issue/35/ + maker.variants = {""} + + # This is required because otherwise distlib creates scripts that are not + # executable. + # See https://bitbucket.org/pypa/distlib/issue/32/ + maker.set_mode = True + + # Generate the console and GUI entry points specified in the wheel + scripts_to_generate = get_console_script_specs(console) + + gui_scripts_to_generate = list(starmap("{} = {}".format, gui.items())) + + generated_console_scripts = maker.make_multiple(scripts_to_generate) + generated.extend(generated_console_scripts) + + generated.extend(maker.make_multiple(gui_scripts_to_generate, {"gui": True})) + + if warn_script_location: + msg = message_about_scripts_not_on_PATH(generated_console_scripts) + if msg is not None: + logger.warning(msg) + + generated_file_mode = 0o666 & ~current_umask() + + @contextlib.contextmanager + def _generate_file(path: str, **kwargs: Any) -> Generator[BinaryIO, None, None]: + with adjacent_tmp_file(path, **kwargs) as f: + yield f + os.chmod(f.name, generated_file_mode) + replace(f.name, path) + + dest_info_dir = os.path.join(lib_dir, info_dir) + + # Record pip as the installer + installer_path = os.path.join(dest_info_dir, "INSTALLER") + with _generate_file(installer_path) as installer_file: + installer_file.write(b"pip\n") + generated.append(installer_path) + + # Record the PEP 610 direct URL reference + if direct_url is not None: + direct_url_path = os.path.join(dest_info_dir, DIRECT_URL_METADATA_NAME) + with _generate_file(direct_url_path) as direct_url_file: + direct_url_file.write(direct_url.to_json().encode("utf-8")) + generated.append(direct_url_path) + + # Record the REQUESTED file + if requested: + requested_path = os.path.join(dest_info_dir, "REQUESTED") + with open(requested_path, "wb"): + pass + generated.append(requested_path) + + record_text = distribution.read_text("RECORD") + record_rows = list(csv.reader(record_text.splitlines())) + + rows = get_csv_rows_for_installed( + record_rows, + installed=installed, + changed=changed, + generated=generated, + lib_dir=lib_dir, + ) + + # Record details of all files installed + record_path = os.path.join(dest_info_dir, "RECORD") + + with _generate_file(record_path, **csv_io_kwargs("w")) as record_file: + # Explicitly cast to typing.IO[str] as a workaround for the mypy error: + # "writer" has incompatible type "BinaryIO"; expected "_Writer" + writer = csv.writer(cast("IO[str]", record_file)) + writer.writerows(_normalized_outrows(rows)) + + +@contextlib.contextmanager +def req_error_context(req_description: str) -> Generator[None, None, None]: + try: + yield + except InstallationError as e: + message = f"For req: {req_description}. {e.args[0]}" + raise InstallationError(message) from e + + +def install_wheel( + name: str, + wheel_path: str, + scheme: Scheme, + req_description: str, + pycompile: bool = True, + warn_script_location: bool = True, + direct_url: Optional[DirectUrl] = None, + requested: bool = False, +) -> None: + with ZipFile(wheel_path, allowZip64=True) as z: + with req_error_context(req_description): + _install_wheel( + name=name, + wheel_zip=z, + wheel_path=wheel_path, + scheme=scheme, + pycompile=pycompile, + warn_script_location=warn_script_location, + direct_url=direct_url, + requested=requested, + ) diff --git a/env/lib/python3.12/site-packages/pip/_internal/operations/prepare.py b/env/lib/python3.12/site-packages/pip/_internal/operations/prepare.py new file mode 100644 index 0000000..e6aa344 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/operations/prepare.py @@ -0,0 +1,732 @@ +"""Prepares a distribution for installation +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +import mimetypes +import os +import shutil +from dataclasses import dataclass +from pathlib import Path +from typing import Dict, Iterable, List, Optional + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.distributions import make_distribution_for_install_requirement +from pip._internal.distributions.installed import InstalledDistribution +from pip._internal.exceptions import ( + DirectoryUrlHashUnsupported, + HashMismatch, + HashUnpinned, + InstallationError, + MetadataInconsistent, + NetworkConnectionError, + VcsHashUnsupported, +) +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import BaseDistribution, get_metadata_distribution +from pip._internal.models.direct_url import ArchiveInfo +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.network.download import BatchDownloader, Downloader +from pip._internal.network.lazy_wheel import ( + HTTPRangeRequestUnsupported, + dist_from_wheel_url, +) +from pip._internal.network.session import PipSession +from pip._internal.operations.build.build_tracker import BuildTracker +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils._log import getLogger +from pip._internal.utils.direct_url_helpers import ( + direct_url_for_editable, + direct_url_from_link, +) +from pip._internal.utils.hashes import Hashes, MissingHashes +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import ( + display_path, + hash_file, + hide_url, + redact_auth_from_requirement, +) +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.unpacking import unpack_file +from pip._internal.vcs import vcs + +logger = getLogger(__name__) + + +def _get_prepared_distribution( + req: InstallRequirement, + build_tracker: BuildTracker, + finder: PackageFinder, + build_isolation: bool, + check_build_deps: bool, +) -> BaseDistribution: + """Prepare a distribution for installation.""" + abstract_dist = make_distribution_for_install_requirement(req) + tracker_id = abstract_dist.build_tracker_id + if tracker_id is not None: + with build_tracker.track(req, tracker_id): + abstract_dist.prepare_distribution_metadata( + finder, build_isolation, check_build_deps + ) + return abstract_dist.get_metadata_distribution() + + +def unpack_vcs_link(link: Link, location: str, verbosity: int) -> None: + vcs_backend = vcs.get_backend_for_scheme(link.scheme) + assert vcs_backend is not None + vcs_backend.unpack(location, url=hide_url(link.url), verbosity=verbosity) + + +@dataclass +class File: + path: str + content_type: Optional[str] = None + + def __post_init__(self) -> None: + if self.content_type is None: + self.content_type = mimetypes.guess_type(self.path)[0] + + +def get_http_url( + link: Link, + download: Downloader, + download_dir: Optional[str] = None, + hashes: Optional[Hashes] = None, +) -> File: + temp_dir = TempDirectory(kind="unpack", globally_managed=True) + # If a download dir is specified, is the file already downloaded there? + already_downloaded_path = None + if download_dir: + already_downloaded_path = _check_download_dir(link, download_dir, hashes) + + if already_downloaded_path: + from_path = already_downloaded_path + content_type = None + else: + # let's download to a tmp dir + from_path, content_type = download(link, temp_dir.path) + if hashes: + hashes.check_against_path(from_path) + + return File(from_path, content_type) + + +def get_file_url( + link: Link, download_dir: Optional[str] = None, hashes: Optional[Hashes] = None +) -> File: + """Get file and optionally check its hash.""" + # If a download dir is specified, is the file already there and valid? + already_downloaded_path = None + if download_dir: + already_downloaded_path = _check_download_dir(link, download_dir, hashes) + + if already_downloaded_path: + from_path = already_downloaded_path + else: + from_path = link.file_path + + # If --require-hashes is off, `hashes` is either empty, the + # link's embedded hash, or MissingHashes; it is required to + # match. If --require-hashes is on, we are satisfied by any + # hash in `hashes` matching: a URL-based or an option-based + # one; no internet-sourced hash will be in `hashes`. + if hashes: + hashes.check_against_path(from_path) + return File(from_path, None) + + +def unpack_url( + link: Link, + location: str, + download: Downloader, + verbosity: int, + download_dir: Optional[str] = None, + hashes: Optional[Hashes] = None, +) -> Optional[File]: + """Unpack link into location, downloading if required. + + :param hashes: A Hashes object, one of whose embedded hashes must match, + or HashMismatch will be raised. If the Hashes is empty, no matches are + required, and unhashable types of requirements (like VCS ones, which + would ordinarily raise HashUnsupported) are allowed. + """ + # non-editable vcs urls + if link.is_vcs: + unpack_vcs_link(link, location, verbosity=verbosity) + return None + + assert not link.is_existing_dir() + + # file urls + if link.is_file: + file = get_file_url(link, download_dir, hashes=hashes) + + # http urls + else: + file = get_http_url( + link, + download, + download_dir, + hashes=hashes, + ) + + # unpack the archive to the build dir location. even when only downloading + # archives, they have to be unpacked to parse dependencies, except wheels + if not link.is_wheel: + unpack_file(file.path, location, file.content_type) + + return file + + +def _check_download_dir( + link: Link, + download_dir: str, + hashes: Optional[Hashes], + warn_on_hash_mismatch: bool = True, +) -> Optional[str]: + """Check download_dir for previously downloaded file with correct hash + If a correct file is found return its path else None + """ + download_path = os.path.join(download_dir, link.filename) + + if not os.path.exists(download_path): + return None + + # If already downloaded, does its hash match? + logger.info("File was already downloaded %s", download_path) + if hashes: + try: + hashes.check_against_path(download_path) + except HashMismatch: + if warn_on_hash_mismatch: + logger.warning( + "Previously-downloaded file %s has bad hash. Re-downloading.", + download_path, + ) + os.unlink(download_path) + return None + return download_path + + +class RequirementPreparer: + """Prepares a Requirement""" + + def __init__( + self, + build_dir: str, + download_dir: Optional[str], + src_dir: str, + build_isolation: bool, + check_build_deps: bool, + build_tracker: BuildTracker, + session: PipSession, + progress_bar: str, + finder: PackageFinder, + require_hashes: bool, + use_user_site: bool, + lazy_wheel: bool, + verbosity: int, + legacy_resolver: bool, + ) -> None: + super().__init__() + + self.src_dir = src_dir + self.build_dir = build_dir + self.build_tracker = build_tracker + self._session = session + self._download = Downloader(session, progress_bar) + self._batch_download = BatchDownloader(session, progress_bar) + self.finder = finder + + # Where still-packed archives should be written to. If None, they are + # not saved, and are deleted immediately after unpacking. + self.download_dir = download_dir + + # Is build isolation allowed? + self.build_isolation = build_isolation + + # Should check build dependencies? + self.check_build_deps = check_build_deps + + # Should hash-checking be required? + self.require_hashes = require_hashes + + # Should install in user site-packages? + self.use_user_site = use_user_site + + # Should wheels be downloaded lazily? + self.use_lazy_wheel = lazy_wheel + + # How verbose should underlying tooling be? + self.verbosity = verbosity + + # Are we using the legacy resolver? + self.legacy_resolver = legacy_resolver + + # Memoized downloaded files, as mapping of url: path. + self._downloaded: Dict[str, str] = {} + + # Previous "header" printed for a link-based InstallRequirement + self._previous_requirement_header = ("", "") + + def _log_preparing_link(self, req: InstallRequirement) -> None: + """Provide context for the requirement being prepared.""" + if req.link.is_file and not req.is_wheel_from_cache: + message = "Processing %s" + information = str(display_path(req.link.file_path)) + else: + message = "Collecting %s" + information = redact_auth_from_requirement(req.req) if req.req else str(req) + + # If we used req.req, inject requirement source if available (this + # would already be included if we used req directly) + if req.req and req.comes_from: + if isinstance(req.comes_from, str): + comes_from: Optional[str] = req.comes_from + else: + comes_from = req.comes_from.from_path() + if comes_from: + information += f" (from {comes_from})" + + if (message, information) != self._previous_requirement_header: + self._previous_requirement_header = (message, information) + logger.info(message, information) + + if req.is_wheel_from_cache: + with indent_log(): + logger.info("Using cached %s", req.link.filename) + + def _ensure_link_req_src_dir( + self, req: InstallRequirement, parallel_builds: bool + ) -> None: + """Ensure source_dir of a linked InstallRequirement.""" + # Since source_dir is only set for editable requirements. + if req.link.is_wheel: + # We don't need to unpack wheels, so no need for a source + # directory. + return + assert req.source_dir is None + if req.link.is_existing_dir(): + # build local directories in-tree + req.source_dir = req.link.file_path + return + + # We always delete unpacked sdists after pip runs. + req.ensure_has_source_dir( + self.build_dir, + autodelete=True, + parallel_builds=parallel_builds, + ) + req.ensure_pristine_source_checkout() + + def _get_linked_req_hashes(self, req: InstallRequirement) -> Hashes: + # By the time this is called, the requirement's link should have + # been checked so we can tell what kind of requirements req is + # and raise some more informative errors than otherwise. + # (For example, we can raise VcsHashUnsupported for a VCS URL + # rather than HashMissing.) + if not self.require_hashes: + return req.hashes(trust_internet=True) + + # We could check these first 2 conditions inside unpack_url + # and save repetition of conditions, but then we would + # report less-useful error messages for unhashable + # requirements, complaining that there's no hash provided. + if req.link.is_vcs: + raise VcsHashUnsupported() + if req.link.is_existing_dir(): + raise DirectoryUrlHashUnsupported() + + # Unpinned packages are asking for trouble when a new version + # is uploaded. This isn't a security check, but it saves users + # a surprising hash mismatch in the future. + # file:/// URLs aren't pinnable, so don't complain about them + # not being pinned. + if not req.is_direct and not req.is_pinned: + raise HashUnpinned() + + # If known-good hashes are missing for this requirement, + # shim it with a facade object that will provoke hash + # computation and then raise a HashMissing exception + # showing the user what the hash should be. + return req.hashes(trust_internet=False) or MissingHashes() + + def _fetch_metadata_only( + self, + req: InstallRequirement, + ) -> Optional[BaseDistribution]: + if self.legacy_resolver: + logger.debug( + "Metadata-only fetching is not used in the legacy resolver", + ) + return None + if self.require_hashes: + logger.debug( + "Metadata-only fetching is not used as hash checking is required", + ) + return None + # Try PEP 658 metadata first, then fall back to lazy wheel if unavailable. + return self._fetch_metadata_using_link_data_attr( + req + ) or self._fetch_metadata_using_lazy_wheel(req.link) + + def _fetch_metadata_using_link_data_attr( + self, + req: InstallRequirement, + ) -> Optional[BaseDistribution]: + """Fetch metadata from the data-dist-info-metadata attribute, if possible.""" + # (1) Get the link to the metadata file, if provided by the backend. + metadata_link = req.link.metadata_link() + if metadata_link is None: + return None + assert req.req is not None + logger.verbose( + "Obtaining dependency information for %s from %s", + req.req, + metadata_link, + ) + # (2) Download the contents of the METADATA file, separate from the dist itself. + metadata_file = get_http_url( + metadata_link, + self._download, + hashes=metadata_link.as_hashes(), + ) + with open(metadata_file.path, "rb") as f: + metadata_contents = f.read() + # (3) Generate a dist just from those file contents. + metadata_dist = get_metadata_distribution( + metadata_contents, + req.link.filename, + req.req.name, + ) + # (4) Ensure the Name: field from the METADATA file matches the name from the + # install requirement. + # + # NB: raw_name will fall back to the name from the install requirement if + # the Name: field is not present, but it's noted in the raw_name docstring + # that that should NEVER happen anyway. + if canonicalize_name(metadata_dist.raw_name) != canonicalize_name(req.req.name): + raise MetadataInconsistent( + req, "Name", req.req.name, metadata_dist.raw_name + ) + return metadata_dist + + def _fetch_metadata_using_lazy_wheel( + self, + link: Link, + ) -> Optional[BaseDistribution]: + """Fetch metadata using lazy wheel, if possible.""" + # --use-feature=fast-deps must be provided. + if not self.use_lazy_wheel: + return None + if link.is_file or not link.is_wheel: + logger.debug( + "Lazy wheel is not used as %r does not point to a remote wheel", + link, + ) + return None + + wheel = Wheel(link.filename) + name = canonicalize_name(wheel.name) + logger.info( + "Obtaining dependency information from %s %s", + name, + wheel.version, + ) + url = link.url.split("#", 1)[0] + try: + return dist_from_wheel_url(name, url, self._session) + except HTTPRangeRequestUnsupported: + logger.debug("%s does not support range requests", url) + return None + + def _complete_partial_requirements( + self, + partially_downloaded_reqs: Iterable[InstallRequirement], + parallel_builds: bool = False, + ) -> None: + """Download any requirements which were only fetched by metadata.""" + # Download to a temporary directory. These will be copied over as + # needed for downstream 'download', 'wheel', and 'install' commands. + temp_dir = TempDirectory(kind="unpack", globally_managed=True).path + + # Map each link to the requirement that owns it. This allows us to set + # `req.local_file_path` on the appropriate requirement after passing + # all the links at once into BatchDownloader. + links_to_fully_download: Dict[Link, InstallRequirement] = {} + for req in partially_downloaded_reqs: + assert req.link + links_to_fully_download[req.link] = req + + batch_download = self._batch_download( + links_to_fully_download.keys(), + temp_dir, + ) + for link, (filepath, _) in batch_download: + logger.debug("Downloading link %s to %s", link, filepath) + req = links_to_fully_download[link] + # Record the downloaded file path so wheel reqs can extract a Distribution + # in .get_dist(). + req.local_file_path = filepath + # Record that the file is downloaded so we don't do it again in + # _prepare_linked_requirement(). + self._downloaded[req.link.url] = filepath + + # If this is an sdist, we need to unpack it after downloading, but the + # .source_dir won't be set up until we are in _prepare_linked_requirement(). + # Add the downloaded archive to the install requirement to unpack after + # preparing the source dir. + if not req.is_wheel: + req.needs_unpacked_archive(Path(filepath)) + + # This step is necessary to ensure all lazy wheels are processed + # successfully by the 'download', 'wheel', and 'install' commands. + for req in partially_downloaded_reqs: + self._prepare_linked_requirement(req, parallel_builds) + + def prepare_linked_requirement( + self, req: InstallRequirement, parallel_builds: bool = False + ) -> BaseDistribution: + """Prepare a requirement to be obtained from req.link.""" + assert req.link + self._log_preparing_link(req) + with indent_log(): + # Check if the relevant file is already available + # in the download directory + file_path = None + if self.download_dir is not None and req.link.is_wheel: + hashes = self._get_linked_req_hashes(req) + file_path = _check_download_dir( + req.link, + self.download_dir, + hashes, + # When a locally built wheel has been found in cache, we don't warn + # about re-downloading when the already downloaded wheel hash does + # not match. This is because the hash must be checked against the + # original link, not the cached link. It that case the already + # downloaded file will be removed and re-fetched from cache (which + # implies a hash check against the cache entry's origin.json). + warn_on_hash_mismatch=not req.is_wheel_from_cache, + ) + + if file_path is not None: + # The file is already available, so mark it as downloaded + self._downloaded[req.link.url] = file_path + else: + # The file is not available, attempt to fetch only metadata + metadata_dist = self._fetch_metadata_only(req) + if metadata_dist is not None: + req.needs_more_preparation = True + return metadata_dist + + # None of the optimizations worked, fully prepare the requirement + return self._prepare_linked_requirement(req, parallel_builds) + + def prepare_linked_requirements_more( + self, reqs: Iterable[InstallRequirement], parallel_builds: bool = False + ) -> None: + """Prepare linked requirements more, if needed.""" + reqs = [req for req in reqs if req.needs_more_preparation] + for req in reqs: + # Determine if any of these requirements were already downloaded. + if self.download_dir is not None and req.link.is_wheel: + hashes = self._get_linked_req_hashes(req) + file_path = _check_download_dir(req.link, self.download_dir, hashes) + if file_path is not None: + self._downloaded[req.link.url] = file_path + req.needs_more_preparation = False + + # Prepare requirements we found were already downloaded for some + # reason. The other downloads will be completed separately. + partially_downloaded_reqs: List[InstallRequirement] = [] + for req in reqs: + if req.needs_more_preparation: + partially_downloaded_reqs.append(req) + else: + self._prepare_linked_requirement(req, parallel_builds) + + # TODO: separate this part out from RequirementPreparer when the v1 + # resolver can be removed! + self._complete_partial_requirements( + partially_downloaded_reqs, + parallel_builds=parallel_builds, + ) + + def _prepare_linked_requirement( + self, req: InstallRequirement, parallel_builds: bool + ) -> BaseDistribution: + assert req.link + link = req.link + + hashes = self._get_linked_req_hashes(req) + + if hashes and req.is_wheel_from_cache: + assert req.download_info is not None + assert link.is_wheel + assert link.is_file + # We need to verify hashes, and we have found the requirement in the cache + # of locally built wheels. + if ( + isinstance(req.download_info.info, ArchiveInfo) + and req.download_info.info.hashes + and hashes.has_one_of(req.download_info.info.hashes) + ): + # At this point we know the requirement was built from a hashable source + # artifact, and we verified that the cache entry's hash of the original + # artifact matches one of the hashes we expect. We don't verify hashes + # against the cached wheel, because the wheel is not the original. + hashes = None + else: + logger.warning( + "The hashes of the source archive found in cache entry " + "don't match, ignoring cached built wheel " + "and re-downloading source." + ) + req.link = req.cached_wheel_source_link + link = req.link + + self._ensure_link_req_src_dir(req, parallel_builds) + + if link.is_existing_dir(): + local_file = None + elif link.url not in self._downloaded: + try: + local_file = unpack_url( + link, + req.source_dir, + self._download, + self.verbosity, + self.download_dir, + hashes, + ) + except NetworkConnectionError as exc: + raise InstallationError( + f"Could not install requirement {req} because of HTTP " + f"error {exc} for URL {link}" + ) + else: + file_path = self._downloaded[link.url] + if hashes: + hashes.check_against_path(file_path) + local_file = File(file_path, content_type=None) + + # If download_info is set, we got it from the wheel cache. + if req.download_info is None: + # Editables don't go through this function (see + # prepare_editable_requirement). + assert not req.editable + req.download_info = direct_url_from_link(link, req.source_dir) + # Make sure we have a hash in download_info. If we got it as part of the + # URL, it will have been verified and we can rely on it. Otherwise we + # compute it from the downloaded file. + # FIXME: https://github.com/pypa/pip/issues/11943 + if ( + isinstance(req.download_info.info, ArchiveInfo) + and not req.download_info.info.hashes + and local_file + ): + hash = hash_file(local_file.path)[0].hexdigest() + # We populate info.hash for backward compatibility. + # This will automatically populate info.hashes. + req.download_info.info.hash = f"sha256={hash}" + + # For use in later processing, + # preserve the file path on the requirement. + if local_file: + req.local_file_path = local_file.path + + dist = _get_prepared_distribution( + req, + self.build_tracker, + self.finder, + self.build_isolation, + self.check_build_deps, + ) + return dist + + def save_linked_requirement(self, req: InstallRequirement) -> None: + assert self.download_dir is not None + assert req.link is not None + link = req.link + if link.is_vcs or (link.is_existing_dir() and req.editable): + # Make a .zip of the source_dir we already created. + req.archive(self.download_dir) + return + + if link.is_existing_dir(): + logger.debug( + "Not copying link to destination directory " + "since it is a directory: %s", + link, + ) + return + if req.local_file_path is None: + # No distribution was downloaded for this requirement. + return + + download_location = os.path.join(self.download_dir, link.filename) + if not os.path.exists(download_location): + shutil.copy(req.local_file_path, download_location) + download_path = display_path(download_location) + logger.info("Saved %s", download_path) + + def prepare_editable_requirement( + self, + req: InstallRequirement, + ) -> BaseDistribution: + """Prepare an editable requirement.""" + assert req.editable, "cannot prepare a non-editable req as editable" + + logger.info("Obtaining %s", req) + + with indent_log(): + if self.require_hashes: + raise InstallationError( + f"The editable requirement {req} cannot be installed when " + "requiring hashes, because there is no single file to " + "hash." + ) + req.ensure_has_source_dir(self.src_dir) + req.update_editable() + assert req.source_dir + req.download_info = direct_url_for_editable(req.unpacked_source_directory) + + dist = _get_prepared_distribution( + req, + self.build_tracker, + self.finder, + self.build_isolation, + self.check_build_deps, + ) + + req.check_if_exists(self.use_user_site) + + return dist + + def prepare_installed_requirement( + self, + req: InstallRequirement, + skip_reason: str, + ) -> BaseDistribution: + """Prepare an already-installed requirement.""" + assert req.satisfied_by, "req should have been satisfied but isn't" + assert skip_reason is not None, ( + "did not get skip reason skipped but req.satisfied_by " + f"is set to {req.satisfied_by}" + ) + logger.info( + "Requirement %s: %s (%s)", skip_reason, req, req.satisfied_by.version + ) + with indent_log(): + if self.require_hashes: + logger.debug( + "Since it is already installed, we are trusting this " + "package without checking its hash. To ensure a " + "completely repeatable environment, install into an " + "empty virtualenv." + ) + return InstalledDistribution(req).get_metadata_distribution() diff --git a/env/lib/python3.12/site-packages/pip/_internal/pyproject.py b/env/lib/python3.12/site-packages/pip/_internal/pyproject.py new file mode 100644 index 0000000..0e8452f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/pyproject.py @@ -0,0 +1,185 @@ +import importlib.util +import os +import sys +from collections import namedtuple +from typing import Any, List, Optional + +if sys.version_info >= (3, 11): + import tomllib +else: + from pip._vendor import tomli as tomllib + +from pip._vendor.packaging.requirements import InvalidRequirement + +from pip._internal.exceptions import ( + InstallationError, + InvalidPyProjectBuildRequires, + MissingPyProjectBuildRequires, +) +from pip._internal.utils.packaging import get_requirement + + +def _is_list_of_str(obj: Any) -> bool: + return isinstance(obj, list) and all(isinstance(item, str) for item in obj) + + +def make_pyproject_path(unpacked_source_directory: str) -> str: + return os.path.join(unpacked_source_directory, "pyproject.toml") + + +BuildSystemDetails = namedtuple( + "BuildSystemDetails", ["requires", "backend", "check", "backend_path"] +) + + +def load_pyproject_toml( + use_pep517: Optional[bool], pyproject_toml: str, setup_py: str, req_name: str +) -> Optional[BuildSystemDetails]: + """Load the pyproject.toml file. + + Parameters: + use_pep517 - Has the user requested PEP 517 processing? None + means the user hasn't explicitly specified. + pyproject_toml - Location of the project's pyproject.toml file + setup_py - Location of the project's setup.py file + req_name - The name of the requirement we're processing (for + error reporting) + + Returns: + None if we should use the legacy code path, otherwise a tuple + ( + requirements from pyproject.toml, + name of PEP 517 backend, + requirements we should check are installed after setting + up the build environment + directory paths to import the backend from (backend-path), + relative to the project root. + ) + """ + has_pyproject = os.path.isfile(pyproject_toml) + has_setup = os.path.isfile(setup_py) + + if not has_pyproject and not has_setup: + raise InstallationError( + f"{req_name} does not appear to be a Python project: " + f"neither 'setup.py' nor 'pyproject.toml' found." + ) + + if has_pyproject: + with open(pyproject_toml, encoding="utf-8") as f: + pp_toml = tomllib.loads(f.read()) + build_system = pp_toml.get("build-system") + else: + build_system = None + + # The following cases must use PEP 517 + # We check for use_pep517 being non-None and falsy because that means + # the user explicitly requested --no-use-pep517. The value 0 as + # opposed to False can occur when the value is provided via an + # environment variable or config file option (due to the quirk of + # strtobool() returning an integer in pip's configuration code). + if has_pyproject and not has_setup: + if use_pep517 is not None and not use_pep517: + raise InstallationError( + "Disabling PEP 517 processing is invalid: " + "project does not have a setup.py" + ) + use_pep517 = True + elif build_system and "build-backend" in build_system: + if use_pep517 is not None and not use_pep517: + raise InstallationError( + "Disabling PEP 517 processing is invalid: " + "project specifies a build backend of {} " + "in pyproject.toml".format(build_system["build-backend"]) + ) + use_pep517 = True + + # If we haven't worked out whether to use PEP 517 yet, + # and the user hasn't explicitly stated a preference, + # we do so if the project has a pyproject.toml file + # or if we cannot import setuptools or wheels. + + # We fallback to PEP 517 when without setuptools or without the wheel package, + # so setuptools can be installed as a default build backend. + # For more info see: + # https://discuss.python.org/t/pip-without-setuptools-could-the-experience-be-improved/11810/9 + # https://github.com/pypa/pip/issues/8559 + elif use_pep517 is None: + use_pep517 = ( + has_pyproject + or not importlib.util.find_spec("setuptools") + or not importlib.util.find_spec("wheel") + ) + + # At this point, we know whether we're going to use PEP 517. + assert use_pep517 is not None + + # If we're using the legacy code path, there is nothing further + # for us to do here. + if not use_pep517: + return None + + if build_system is None: + # Either the user has a pyproject.toml with no build-system + # section, or the user has no pyproject.toml, but has opted in + # explicitly via --use-pep517. + # In the absence of any explicit backend specification, we + # assume the setuptools backend that most closely emulates the + # traditional direct setup.py execution, and require wheel and + # a version of setuptools that supports that backend. + + build_system = { + "requires": ["setuptools>=40.8.0"], + "build-backend": "setuptools.build_meta:__legacy__", + } + + # If we're using PEP 517, we have build system information (either + # from pyproject.toml, or defaulted by the code above). + # Note that at this point, we do not know if the user has actually + # specified a backend, though. + assert build_system is not None + + # Ensure that the build-system section in pyproject.toml conforms + # to PEP 518. + + # Specifying the build-system table but not the requires key is invalid + if "requires" not in build_system: + raise MissingPyProjectBuildRequires(package=req_name) + + # Error out if requires is not a list of strings + requires = build_system["requires"] + if not _is_list_of_str(requires): + raise InvalidPyProjectBuildRequires( + package=req_name, + reason="It is not a list of strings.", + ) + + # Each requirement must be valid as per PEP 508 + for requirement in requires: + try: + get_requirement(requirement) + except InvalidRequirement as error: + raise InvalidPyProjectBuildRequires( + package=req_name, + reason=f"It contains an invalid requirement: {requirement!r}", + ) from error + + backend = build_system.get("build-backend") + backend_path = build_system.get("backend-path", []) + check: List[str] = [] + if backend is None: + # If the user didn't specify a backend, we assume they want to use + # the setuptools backend. But we can't be sure they have included + # a version of setuptools which supplies the backend. So we + # make a note to check that this requirement is present once + # we have set up the environment. + # This is quite a lot of work to check for a very specific case. But + # the problem is, that case is potentially quite common - projects that + # adopted PEP 518 early for the ability to specify requirements to + # execute setup.py, but never considered needing to mention the build + # tools themselves. The original PEP 518 code had a similar check (but + # implemented in a different way). + backend = "setuptools.build_meta:__legacy__" + check = ["setuptools>=40.8.0"] + + return BuildSystemDetails(requires, backend, check, backend_path) diff --git a/env/lib/python3.12/site-packages/pip/_internal/req/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/req/__init__.py new file mode 100644 index 0000000..422d851 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/req/__init__.py @@ -0,0 +1,90 @@ +import collections +import logging +from dataclasses import dataclass +from typing import Generator, List, Optional, Sequence, Tuple + +from pip._internal.utils.logging import indent_log + +from .req_file import parse_requirements +from .req_install import InstallRequirement +from .req_set import RequirementSet + +__all__ = [ + "RequirementSet", + "InstallRequirement", + "parse_requirements", + "install_given_reqs", +] + +logger = logging.getLogger(__name__) + + +@dataclass(frozen=True) +class InstallationResult: + name: str + + +def _validate_requirements( + requirements: List[InstallRequirement], +) -> Generator[Tuple[str, InstallRequirement], None, None]: + for req in requirements: + assert req.name, f"invalid to-be-installed requirement: {req}" + yield req.name, req + + +def install_given_reqs( + requirements: List[InstallRequirement], + global_options: Sequence[str], + root: Optional[str], + home: Optional[str], + prefix: Optional[str], + warn_script_location: bool, + use_user_site: bool, + pycompile: bool, +) -> List[InstallationResult]: + """ + Install everything in the given list. + + (to be called after having downloaded and unpacked the packages) + """ + to_install = collections.OrderedDict(_validate_requirements(requirements)) + + if to_install: + logger.info( + "Installing collected packages: %s", + ", ".join(to_install.keys()), + ) + + installed = [] + + with indent_log(): + for req_name, requirement in to_install.items(): + if requirement.should_reinstall: + logger.info("Attempting uninstall: %s", req_name) + with indent_log(): + uninstalled_pathset = requirement.uninstall(auto_confirm=True) + else: + uninstalled_pathset = None + + try: + requirement.install( + global_options, + root=root, + home=home, + prefix=prefix, + warn_script_location=warn_script_location, + use_user_site=use_user_site, + pycompile=pycompile, + ) + except Exception: + # if install did not succeed, rollback previous uninstall + if uninstalled_pathset and not requirement.install_succeeded: + uninstalled_pathset.rollback() + raise + else: + if uninstalled_pathset and requirement.install_succeeded: + uninstalled_pathset.commit() + + installed.append(InstallationResult(req_name)) + + return installed diff --git a/env/lib/python3.12/site-packages/pip/_internal/req/constructors.py b/env/lib/python3.12/site-packages/pip/_internal/req/constructors.py new file mode 100644 index 0000000..56a964f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/req/constructors.py @@ -0,0 +1,560 @@ +"""Backing implementation for InstallRequirement's various constructors + +The idea here is that these formed a major chunk of InstallRequirement's size +so, moving them and support code dedicated to them outside of that class +helps creates for better understandability for the rest of the code. + +These are meant to be used elsewhere within pip to create instances of +InstallRequirement. +""" + +import copy +import logging +import os +import re +from dataclasses import dataclass +from typing import Collection, Dict, List, Optional, Set, Tuple, Union + +from pip._vendor.packaging.markers import Marker +from pip._vendor.packaging.requirements import InvalidRequirement, Requirement +from pip._vendor.packaging.specifiers import Specifier + +from pip._internal.exceptions import InstallationError +from pip._internal.models.index import PyPI, TestPyPI +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.req.req_file import ParsedRequirement +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.filetypes import is_archive_file +from pip._internal.utils.misc import is_installable_dir +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs import is_url, vcs + +__all__ = [ + "install_req_from_editable", + "install_req_from_line", + "parse_editable", +] + +logger = logging.getLogger(__name__) +operators = Specifier._operators.keys() + + +def _strip_extras(path: str) -> Tuple[str, Optional[str]]: + m = re.match(r"^(.+)(\[[^\]]+\])$", path) + extras = None + if m: + path_no_extras = m.group(1) + extras = m.group(2) + else: + path_no_extras = path + + return path_no_extras, extras + + +def convert_extras(extras: Optional[str]) -> Set[str]: + if not extras: + return set() + return get_requirement("placeholder" + extras.lower()).extras + + +def _set_requirement_extras(req: Requirement, new_extras: Set[str]) -> Requirement: + """ + Returns a new requirement based on the given one, with the supplied extras. If the + given requirement already has extras those are replaced (or dropped if no new extras + are given). + """ + match: Optional[re.Match[str]] = re.fullmatch( + # see https://peps.python.org/pep-0508/#complete-grammar + r"([\w\t .-]+)(\[[^\]]*\])?(.*)", + str(req), + flags=re.ASCII, + ) + # ireq.req is a valid requirement so the regex should always match + assert ( + match is not None + ), f"regex match on requirement {req} failed, this should never happen" + pre: Optional[str] = match.group(1) + post: Optional[str] = match.group(3) + assert ( + pre is not None and post is not None + ), f"regex group selection for requirement {req} failed, this should never happen" + extras: str = "[{}]".format(",".join(sorted(new_extras)) if new_extras else "") + return get_requirement(f"{pre}{extras}{post}") + + +def parse_editable(editable_req: str) -> Tuple[Optional[str], str, Set[str]]: + """Parses an editable requirement into: + - a requirement name + - an URL + - extras + - editable options + Accepted requirements: + svn+http://blahblah@rev#egg=Foobar[baz]&subdirectory=version_subdir + .[some_extra] + """ + + url = editable_req + + # If a file path is specified with extras, strip off the extras. + url_no_extras, extras = _strip_extras(url) + + if os.path.isdir(url_no_extras): + # Treating it as code that has already been checked out + url_no_extras = path_to_url(url_no_extras) + + if url_no_extras.lower().startswith("file:"): + package_name = Link(url_no_extras).egg_fragment + if extras: + return ( + package_name, + url_no_extras, + get_requirement("placeholder" + extras.lower()).extras, + ) + else: + return package_name, url_no_extras, set() + + for version_control in vcs: + if url.lower().startswith(f"{version_control}:"): + url = f"{version_control}+{url}" + break + + link = Link(url) + + if not link.is_vcs: + backends = ", ".join(vcs.all_schemes) + raise InstallationError( + f"{editable_req} is not a valid editable requirement. " + f"It should either be a path to a local project or a VCS URL " + f"(beginning with {backends})." + ) + + package_name = link.egg_fragment + if not package_name: + raise InstallationError( + f"Could not detect requirement name for '{editable_req}', " + "please specify one with #egg=your_package_name" + ) + return package_name, url, set() + + +def check_first_requirement_in_file(filename: str) -> None: + """Check if file is parsable as a requirements file. + + This is heavily based on ``pkg_resources.parse_requirements``, but + simplified to just check the first meaningful line. + + :raises InvalidRequirement: If the first meaningful line cannot be parsed + as an requirement. + """ + with open(filename, encoding="utf-8", errors="ignore") as f: + # Create a steppable iterator, so we can handle \-continuations. + lines = ( + line + for line in (line.strip() for line in f) + if line and not line.startswith("#") # Skip blank lines/comments. + ) + + for line in lines: + # Drop comments -- a hash without a space may be in a URL. + if " #" in line: + line = line[: line.find(" #")] + # If there is a line continuation, drop it, and append the next line. + if line.endswith("\\"): + line = line[:-2].strip() + next(lines, "") + get_requirement(line) + return + + +def deduce_helpful_msg(req: str) -> str: + """Returns helpful msg in case requirements file does not exist, + or cannot be parsed. + + :params req: Requirements file path + """ + if not os.path.exists(req): + return f" File '{req}' does not exist." + msg = " The path does exist. " + # Try to parse and check if it is a requirements file. + try: + check_first_requirement_in_file(req) + except InvalidRequirement: + logger.debug("Cannot parse '%s' as requirements file", req) + else: + msg += ( + f"The argument you provided " + f"({req}) appears to be a" + f" requirements file. If that is the" + f" case, use the '-r' flag to install" + f" the packages specified within it." + ) + return msg + + +@dataclass(frozen=True) +class RequirementParts: + requirement: Optional[Requirement] + link: Optional[Link] + markers: Optional[Marker] + extras: Set[str] + + +def parse_req_from_editable(editable_req: str) -> RequirementParts: + name, url, extras_override = parse_editable(editable_req) + + if name is not None: + try: + req: Optional[Requirement] = get_requirement(name) + except InvalidRequirement as exc: + raise InstallationError(f"Invalid requirement: {name!r}: {exc}") + else: + req = None + + link = Link(url) + + return RequirementParts(req, link, None, extras_override) + + +# ---- The actual constructors follow ---- + + +def install_req_from_editable( + editable_req: str, + comes_from: Optional[Union[InstallRequirement, str]] = None, + *, + use_pep517: Optional[bool] = None, + isolated: bool = False, + global_options: Optional[List[str]] = None, + hash_options: Optional[Dict[str, List[str]]] = None, + constraint: bool = False, + user_supplied: bool = False, + permit_editable_wheels: bool = False, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, +) -> InstallRequirement: + parts = parse_req_from_editable(editable_req) + + return InstallRequirement( + parts.requirement, + comes_from=comes_from, + user_supplied=user_supplied, + editable=True, + permit_editable_wheels=permit_editable_wheels, + link=parts.link, + constraint=constraint, + use_pep517=use_pep517, + isolated=isolated, + global_options=global_options, + hash_options=hash_options, + config_settings=config_settings, + extras=parts.extras, + ) + + +def _looks_like_path(name: str) -> bool: + """Checks whether the string "looks like" a path on the filesystem. + + This does not check whether the target actually exists, only judge from the + appearance. + + Returns true if any of the following conditions is true: + * a path separator is found (either os.path.sep or os.path.altsep); + * a dot is found (which represents the current directory). + """ + if os.path.sep in name: + return True + if os.path.altsep is not None and os.path.altsep in name: + return True + if name.startswith("."): + return True + return False + + +def _get_url_from_path(path: str, name: str) -> Optional[str]: + """ + First, it checks whether a provided path is an installable directory. If it + is, returns the path. + + If false, check if the path is an archive file (such as a .whl). + The function checks if the path is a file. If false, if the path has + an @, it will treat it as a PEP 440 URL requirement and return the path. + """ + if _looks_like_path(name) and os.path.isdir(path): + if is_installable_dir(path): + return path_to_url(path) + # TODO: The is_installable_dir test here might not be necessary + # now that it is done in load_pyproject_toml too. + raise InstallationError( + f"Directory {name!r} is not installable. Neither 'setup.py' " + "nor 'pyproject.toml' found." + ) + if not is_archive_file(path): + return None + if os.path.isfile(path): + return path_to_url(path) + urlreq_parts = name.split("@", 1) + if len(urlreq_parts) >= 2 and not _looks_like_path(urlreq_parts[0]): + # If the path contains '@' and the part before it does not look + # like a path, try to treat it as a PEP 440 URL req instead. + return None + logger.warning( + "Requirement %r looks like a filename, but the file does not exist", + name, + ) + return path_to_url(path) + + +def parse_req_from_line(name: str, line_source: Optional[str]) -> RequirementParts: + if is_url(name): + marker_sep = "; " + else: + marker_sep = ";" + if marker_sep in name: + name, markers_as_string = name.split(marker_sep, 1) + markers_as_string = markers_as_string.strip() + if not markers_as_string: + markers = None + else: + markers = Marker(markers_as_string) + else: + markers = None + name = name.strip() + req_as_string = None + path = os.path.normpath(os.path.abspath(name)) + link = None + extras_as_string = None + + if is_url(name): + link = Link(name) + else: + p, extras_as_string = _strip_extras(path) + url = _get_url_from_path(p, name) + if url is not None: + link = Link(url) + + # it's a local file, dir, or url + if link: + # Handle relative file URLs + if link.scheme == "file" and re.search(r"\.\./", link.url): + link = Link(path_to_url(os.path.normpath(os.path.abspath(link.path)))) + # wheel file + if link.is_wheel: + wheel = Wheel(link.filename) # can raise InvalidWheelFilename + req_as_string = f"{wheel.name}=={wheel.version}" + else: + # set the req to the egg fragment. when it's not there, this + # will become an 'unnamed' requirement + req_as_string = link.egg_fragment + + # a requirement specifier + else: + req_as_string = name + + extras = convert_extras(extras_as_string) + + def with_source(text: str) -> str: + if not line_source: + return text + return f"{text} (from {line_source})" + + def _parse_req_string(req_as_string: str) -> Requirement: + try: + return get_requirement(req_as_string) + except InvalidRequirement as exc: + if os.path.sep in req_as_string: + add_msg = "It looks like a path." + add_msg += deduce_helpful_msg(req_as_string) + elif "=" in req_as_string and not any( + op in req_as_string for op in operators + ): + add_msg = "= is not a valid operator. Did you mean == ?" + else: + add_msg = "" + msg = with_source(f"Invalid requirement: {req_as_string!r}: {exc}") + if add_msg: + msg += f"\nHint: {add_msg}" + raise InstallationError(msg) + + if req_as_string is not None: + req: Optional[Requirement] = _parse_req_string(req_as_string) + else: + req = None + + return RequirementParts(req, link, markers, extras) + + +def install_req_from_line( + name: str, + comes_from: Optional[Union[str, InstallRequirement]] = None, + *, + use_pep517: Optional[bool] = None, + isolated: bool = False, + global_options: Optional[List[str]] = None, + hash_options: Optional[Dict[str, List[str]]] = None, + constraint: bool = False, + line_source: Optional[str] = None, + user_supplied: bool = False, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, +) -> InstallRequirement: + """Creates an InstallRequirement from a name, which might be a + requirement, directory containing 'setup.py', filename, or URL. + + :param line_source: An optional string describing where the line is from, + for logging purposes in case of an error. + """ + parts = parse_req_from_line(name, line_source) + + return InstallRequirement( + parts.requirement, + comes_from, + link=parts.link, + markers=parts.markers, + use_pep517=use_pep517, + isolated=isolated, + global_options=global_options, + hash_options=hash_options, + config_settings=config_settings, + constraint=constraint, + extras=parts.extras, + user_supplied=user_supplied, + ) + + +def install_req_from_req_string( + req_string: str, + comes_from: Optional[InstallRequirement] = None, + isolated: bool = False, + use_pep517: Optional[bool] = None, + user_supplied: bool = False, +) -> InstallRequirement: + try: + req = get_requirement(req_string) + except InvalidRequirement as exc: + raise InstallationError(f"Invalid requirement: {req_string!r}: {exc}") + + domains_not_allowed = [ + PyPI.file_storage_domain, + TestPyPI.file_storage_domain, + ] + if ( + req.url + and comes_from + and comes_from.link + and comes_from.link.netloc in domains_not_allowed + ): + # Explicitly disallow pypi packages that depend on external urls + raise InstallationError( + "Packages installed from PyPI cannot depend on packages " + "which are not also hosted on PyPI.\n" + f"{comes_from.name} depends on {req} " + ) + + return InstallRequirement( + req, + comes_from, + isolated=isolated, + use_pep517=use_pep517, + user_supplied=user_supplied, + ) + + +def install_req_from_parsed_requirement( + parsed_req: ParsedRequirement, + isolated: bool = False, + use_pep517: Optional[bool] = None, + user_supplied: bool = False, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, +) -> InstallRequirement: + if parsed_req.is_editable: + req = install_req_from_editable( + parsed_req.requirement, + comes_from=parsed_req.comes_from, + use_pep517=use_pep517, + constraint=parsed_req.constraint, + isolated=isolated, + user_supplied=user_supplied, + config_settings=config_settings, + ) + + else: + req = install_req_from_line( + parsed_req.requirement, + comes_from=parsed_req.comes_from, + use_pep517=use_pep517, + isolated=isolated, + global_options=( + parsed_req.options.get("global_options", []) + if parsed_req.options + else [] + ), + hash_options=( + parsed_req.options.get("hashes", {}) if parsed_req.options else {} + ), + constraint=parsed_req.constraint, + line_source=parsed_req.line_source, + user_supplied=user_supplied, + config_settings=config_settings, + ) + return req + + +def install_req_from_link_and_ireq( + link: Link, ireq: InstallRequirement +) -> InstallRequirement: + return InstallRequirement( + req=ireq.req, + comes_from=ireq.comes_from, + editable=ireq.editable, + link=link, + markers=ireq.markers, + use_pep517=ireq.use_pep517, + isolated=ireq.isolated, + global_options=ireq.global_options, + hash_options=ireq.hash_options, + config_settings=ireq.config_settings, + user_supplied=ireq.user_supplied, + ) + + +def install_req_drop_extras(ireq: InstallRequirement) -> InstallRequirement: + """ + Creates a new InstallationRequirement using the given template but without + any extras. Sets the original requirement as the new one's parent + (comes_from). + """ + return InstallRequirement( + req=( + _set_requirement_extras(ireq.req, set()) if ireq.req is not None else None + ), + comes_from=ireq, + editable=ireq.editable, + link=ireq.link, + markers=ireq.markers, + use_pep517=ireq.use_pep517, + isolated=ireq.isolated, + global_options=ireq.global_options, + hash_options=ireq.hash_options, + constraint=ireq.constraint, + extras=[], + config_settings=ireq.config_settings, + user_supplied=ireq.user_supplied, + permit_editable_wheels=ireq.permit_editable_wheels, + ) + + +def install_req_extend_extras( + ireq: InstallRequirement, + extras: Collection[str], +) -> InstallRequirement: + """ + Returns a copy of an installation requirement with some additional extras. + Makes a shallow copy of the ireq object. + """ + result = copy.copy(ireq) + result.extras = {*ireq.extras, *extras} + result.req = ( + _set_requirement_extras(ireq.req, result.extras) + if ireq.req is not None + else None + ) + return result diff --git a/env/lib/python3.12/site-packages/pip/_internal/req/req_file.py b/env/lib/python3.12/site-packages/pip/_internal/req/req_file.py new file mode 100644 index 0000000..f6ba70f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/req/req_file.py @@ -0,0 +1,623 @@ +""" +Requirements file parsing +""" + +import codecs +import locale +import logging +import optparse +import os +import re +import shlex +import sys +import urllib.parse +from dataclasses import dataclass +from optparse import Values +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + Generator, + Iterable, + List, + NoReturn, + Optional, + Tuple, +) + +from pip._internal.cli import cmdoptions +from pip._internal.exceptions import InstallationError, RequirementsFileParseError +from pip._internal.models.search_scope import SearchScope + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + from pip._internal.network.session import PipSession + +__all__ = ["parse_requirements"] + +ReqFileLines = Iterable[Tuple[int, str]] + +LineParser = Callable[[str], Tuple[str, Values]] + +SCHEME_RE = re.compile(r"^(http|https|file):", re.I) +COMMENT_RE = re.compile(r"(^|\s+)#.*$") + +# Matches environment variable-style values in '${MY_VARIABLE_1}' with the +# variable name consisting of only uppercase letters, digits or the '_' +# (underscore). This follows the POSIX standard defined in IEEE Std 1003.1, +# 2013 Edition. +ENV_VAR_RE = re.compile(r"(?P\$\{(?P[A-Z0-9_]+)\})") + +SUPPORTED_OPTIONS: List[Callable[..., optparse.Option]] = [ + cmdoptions.index_url, + cmdoptions.extra_index_url, + cmdoptions.no_index, + cmdoptions.constraints, + cmdoptions.requirements, + cmdoptions.editable, + cmdoptions.find_links, + cmdoptions.no_binary, + cmdoptions.only_binary, + cmdoptions.prefer_binary, + cmdoptions.require_hashes, + cmdoptions.pre, + cmdoptions.trusted_host, + cmdoptions.use_new_feature, +] + +# options to be passed to requirements +SUPPORTED_OPTIONS_REQ: List[Callable[..., optparse.Option]] = [ + cmdoptions.global_options, + cmdoptions.hash, + cmdoptions.config_settings, +] + +SUPPORTED_OPTIONS_EDITABLE_REQ: List[Callable[..., optparse.Option]] = [ + cmdoptions.config_settings, +] + + +# the 'dest' string values +SUPPORTED_OPTIONS_REQ_DEST = [str(o().dest) for o in SUPPORTED_OPTIONS_REQ] +SUPPORTED_OPTIONS_EDITABLE_REQ_DEST = [ + str(o().dest) for o in SUPPORTED_OPTIONS_EDITABLE_REQ +] + +# order of BOMS is important: codecs.BOM_UTF16_LE is a prefix of codecs.BOM_UTF32_LE +# so data.startswith(BOM_UTF16_LE) would be true for UTF32_LE data +BOMS: List[Tuple[bytes, str]] = [ + (codecs.BOM_UTF8, "utf-8"), + (codecs.BOM_UTF32, "utf-32"), + (codecs.BOM_UTF32_BE, "utf-32-be"), + (codecs.BOM_UTF32_LE, "utf-32-le"), + (codecs.BOM_UTF16, "utf-16"), + (codecs.BOM_UTF16_BE, "utf-16-be"), + (codecs.BOM_UTF16_LE, "utf-16-le"), +] + +PEP263_ENCODING_RE = re.compile(rb"coding[:=]\s*([-\w.]+)") +DEFAULT_ENCODING = "utf-8" + +logger = logging.getLogger(__name__) + + +@dataclass(frozen=True) +class ParsedRequirement: + # TODO: replace this with slots=True when dropping Python 3.9 support. + __slots__ = ( + "requirement", + "is_editable", + "comes_from", + "constraint", + "options", + "line_source", + ) + + requirement: str + is_editable: bool + comes_from: str + constraint: bool + options: Optional[Dict[str, Any]] + line_source: Optional[str] + + +@dataclass(frozen=True) +class ParsedLine: + __slots__ = ("filename", "lineno", "args", "opts", "constraint") + + filename: str + lineno: int + args: str + opts: Values + constraint: bool + + @property + def is_editable(self) -> bool: + return bool(self.opts.editables) + + @property + def requirement(self) -> Optional[str]: + if self.args: + return self.args + elif self.is_editable: + # We don't support multiple -e on one line + return self.opts.editables[0] + return None + + +def parse_requirements( + filename: str, + session: "PipSession", + finder: Optional["PackageFinder"] = None, + options: Optional[optparse.Values] = None, + constraint: bool = False, +) -> Generator[ParsedRequirement, None, None]: + """Parse a requirements file and yield ParsedRequirement instances. + + :param filename: Path or url of requirements file. + :param session: PipSession instance. + :param finder: Instance of pip.index.PackageFinder. + :param options: cli options. + :param constraint: If true, parsing a constraint file rather than + requirements file. + """ + line_parser = get_line_parser(finder) + parser = RequirementsFileParser(session, line_parser) + + for parsed_line in parser.parse(filename, constraint): + parsed_req = handle_line( + parsed_line, options=options, finder=finder, session=session + ) + if parsed_req is not None: + yield parsed_req + + +def preprocess(content: str) -> ReqFileLines: + """Split, filter, and join lines, and return a line iterator + + :param content: the content of the requirements file + """ + lines_enum: ReqFileLines = enumerate(content.splitlines(), start=1) + lines_enum = join_lines(lines_enum) + lines_enum = ignore_comments(lines_enum) + lines_enum = expand_env_variables(lines_enum) + return lines_enum + + +def handle_requirement_line( + line: ParsedLine, + options: Optional[optparse.Values] = None, +) -> ParsedRequirement: + # preserve for the nested code path + line_comes_from = "{} {} (line {})".format( + "-c" if line.constraint else "-r", + line.filename, + line.lineno, + ) + + assert line.requirement is not None + + # get the options that apply to requirements + if line.is_editable: + supported_dest = SUPPORTED_OPTIONS_EDITABLE_REQ_DEST + else: + supported_dest = SUPPORTED_OPTIONS_REQ_DEST + req_options = {} + for dest in supported_dest: + if dest in line.opts.__dict__ and line.opts.__dict__[dest]: + req_options[dest] = line.opts.__dict__[dest] + + line_source = f"line {line.lineno} of {line.filename}" + return ParsedRequirement( + requirement=line.requirement, + is_editable=line.is_editable, + comes_from=line_comes_from, + constraint=line.constraint, + options=req_options, + line_source=line_source, + ) + + +def handle_option_line( + opts: Values, + filename: str, + lineno: int, + finder: Optional["PackageFinder"] = None, + options: Optional[optparse.Values] = None, + session: Optional["PipSession"] = None, +) -> None: + if opts.hashes: + logger.warning( + "%s line %s has --hash but no requirement, and will be ignored.", + filename, + lineno, + ) + + if options: + # percolate options upward + if opts.require_hashes: + options.require_hashes = opts.require_hashes + if opts.features_enabled: + options.features_enabled.extend( + f for f in opts.features_enabled if f not in options.features_enabled + ) + + # set finder options + if finder: + find_links = finder.find_links + index_urls = finder.index_urls + no_index = finder.search_scope.no_index + if opts.no_index is True: + no_index = True + index_urls = [] + if opts.index_url and not no_index: + index_urls = [opts.index_url] + if opts.extra_index_urls and not no_index: + index_urls.extend(opts.extra_index_urls) + if opts.find_links: + # FIXME: it would be nice to keep track of the source + # of the find_links: support a find-links local path + # relative to a requirements file. + value = opts.find_links[0] + req_dir = os.path.dirname(os.path.abspath(filename)) + relative_to_reqs_file = os.path.join(req_dir, value) + if os.path.exists(relative_to_reqs_file): + value = relative_to_reqs_file + find_links.append(value) + + if session: + # We need to update the auth urls in session + session.update_index_urls(index_urls) + + search_scope = SearchScope( + find_links=find_links, + index_urls=index_urls, + no_index=no_index, + ) + finder.search_scope = search_scope + + if opts.pre: + finder.set_allow_all_prereleases() + + if opts.prefer_binary: + finder.set_prefer_binary() + + if session: + for host in opts.trusted_hosts or []: + source = f"line {lineno} of {filename}" + session.add_trusted_host(host, source=source) + + +def handle_line( + line: ParsedLine, + options: Optional[optparse.Values] = None, + finder: Optional["PackageFinder"] = None, + session: Optional["PipSession"] = None, +) -> Optional[ParsedRequirement]: + """Handle a single parsed requirements line; This can result in + creating/yielding requirements, or updating the finder. + + :param line: The parsed line to be processed. + :param options: CLI options. + :param finder: The finder - updated by non-requirement lines. + :param session: The session - updated by non-requirement lines. + + Returns a ParsedRequirement object if the line is a requirement line, + otherwise returns None. + + For lines that contain requirements, the only options that have an effect + are from SUPPORTED_OPTIONS_REQ, and they are scoped to the + requirement. Other options from SUPPORTED_OPTIONS may be present, but are + ignored. + + For lines that do not contain requirements, the only options that have an + effect are from SUPPORTED_OPTIONS. Options from SUPPORTED_OPTIONS_REQ may + be present, but are ignored. These lines may contain multiple options + (although our docs imply only one is supported), and all our parsed and + affect the finder. + """ + + if line.requirement is not None: + parsed_req = handle_requirement_line(line, options) + return parsed_req + else: + handle_option_line( + line.opts, + line.filename, + line.lineno, + finder, + options, + session, + ) + return None + + +class RequirementsFileParser: + def __init__( + self, + session: "PipSession", + line_parser: LineParser, + ) -> None: + self._session = session + self._line_parser = line_parser + + def parse( + self, filename: str, constraint: bool + ) -> Generator[ParsedLine, None, None]: + """Parse a given file, yielding parsed lines.""" + yield from self._parse_and_recurse( + filename, constraint, [{os.path.abspath(filename): None}] + ) + + def _parse_and_recurse( + self, + filename: str, + constraint: bool, + parsed_files_stack: List[Dict[str, Optional[str]]], + ) -> Generator[ParsedLine, None, None]: + for line in self._parse_file(filename, constraint): + if line.requirement is None and ( + line.opts.requirements or line.opts.constraints + ): + # parse a nested requirements file + if line.opts.requirements: + req_path = line.opts.requirements[0] + nested_constraint = False + else: + req_path = line.opts.constraints[0] + nested_constraint = True + + # original file is over http + if SCHEME_RE.search(filename): + # do a url join so relative paths work + req_path = urllib.parse.urljoin(filename, req_path) + # original file and nested file are paths + elif not SCHEME_RE.search(req_path): + # do a join so relative paths work + # and then abspath so that we can identify recursive references + req_path = os.path.abspath( + os.path.join( + os.path.dirname(filename), + req_path, + ) + ) + parsed_files = parsed_files_stack[0] + if req_path in parsed_files: + initial_file = parsed_files[req_path] + tail = ( + f" and again in {initial_file}" + if initial_file is not None + else "" + ) + raise RequirementsFileParseError( + f"{req_path} recursively references itself in {filename}{tail}" + ) + # Keeping a track where was each file first included in + new_parsed_files = parsed_files.copy() + new_parsed_files[req_path] = filename + yield from self._parse_and_recurse( + req_path, nested_constraint, [new_parsed_files, *parsed_files_stack] + ) + else: + yield line + + def _parse_file( + self, filename: str, constraint: bool + ) -> Generator[ParsedLine, None, None]: + _, content = get_file_content(filename, self._session) + + lines_enum = preprocess(content) + + for line_number, line in lines_enum: + try: + args_str, opts = self._line_parser(line) + except OptionParsingError as e: + # add offending line + msg = f"Invalid requirement: {line}\n{e.msg}" + raise RequirementsFileParseError(msg) + + yield ParsedLine( + filename, + line_number, + args_str, + opts, + constraint, + ) + + +def get_line_parser(finder: Optional["PackageFinder"]) -> LineParser: + def parse_line(line: str) -> Tuple[str, Values]: + # Build new parser for each line since it accumulates appendable + # options. + parser = build_parser() + defaults = parser.get_default_values() + defaults.index_url = None + if finder: + defaults.format_control = finder.format_control + + args_str, options_str = break_args_options(line) + + try: + options = shlex.split(options_str) + except ValueError as e: + raise OptionParsingError(f"Could not split options: {options_str}") from e + + opts, _ = parser.parse_args(options, defaults) + + return args_str, opts + + return parse_line + + +def break_args_options(line: str) -> Tuple[str, str]: + """Break up the line into an args and options string. We only want to shlex + (and then optparse) the options, not the args. args can contain markers + which are corrupted by shlex. + """ + tokens = line.split(" ") + args = [] + options = tokens[:] + for token in tokens: + if token.startswith("-") or token.startswith("--"): + break + else: + args.append(token) + options.pop(0) + return " ".join(args), " ".join(options) + + +class OptionParsingError(Exception): + def __init__(self, msg: str) -> None: + self.msg = msg + + +def build_parser() -> optparse.OptionParser: + """ + Return a parser for parsing requirement lines + """ + parser = optparse.OptionParser(add_help_option=False) + + option_factories = SUPPORTED_OPTIONS + SUPPORTED_OPTIONS_REQ + for option_factory in option_factories: + option = option_factory() + parser.add_option(option) + + # By default optparse sys.exits on parsing errors. We want to wrap + # that in our own exception. + def parser_exit(self: Any, msg: str) -> "NoReturn": + raise OptionParsingError(msg) + + # NOTE: mypy disallows assigning to a method + # https://github.com/python/mypy/issues/2427 + parser.exit = parser_exit # type: ignore + + return parser + + +def join_lines(lines_enum: ReqFileLines) -> ReqFileLines: + """Joins a line ending in '\' with the previous line (except when following + comments). The joined line takes on the index of the first line. + """ + primary_line_number = None + new_line: List[str] = [] + for line_number, line in lines_enum: + if not line.endswith("\\") or COMMENT_RE.match(line): + if COMMENT_RE.match(line): + # this ensures comments are always matched later + line = " " + line + if new_line: + new_line.append(line) + assert primary_line_number is not None + yield primary_line_number, "".join(new_line) + new_line = [] + else: + yield line_number, line + else: + if not new_line: + primary_line_number = line_number + new_line.append(line.strip("\\")) + + # last line contains \ + if new_line: + assert primary_line_number is not None + yield primary_line_number, "".join(new_line) + + # TODO: handle space after '\'. + + +def ignore_comments(lines_enum: ReqFileLines) -> ReqFileLines: + """ + Strips comments and filter empty lines. + """ + for line_number, line in lines_enum: + line = COMMENT_RE.sub("", line) + line = line.strip() + if line: + yield line_number, line + + +def expand_env_variables(lines_enum: ReqFileLines) -> ReqFileLines: + """Replace all environment variables that can be retrieved via `os.getenv`. + + The only allowed format for environment variables defined in the + requirement file is `${MY_VARIABLE_1}` to ensure two things: + + 1. Strings that contain a `$` aren't accidentally (partially) expanded. + 2. Ensure consistency across platforms for requirement files. + + These points are the result of a discussion on the `github pull + request #3514 `_. + + Valid characters in variable names follow the `POSIX standard + `_ and are limited + to uppercase letter, digits and the `_` (underscore). + """ + for line_number, line in lines_enum: + for env_var, var_name in ENV_VAR_RE.findall(line): + value = os.getenv(var_name) + if not value: + continue + + line = line.replace(env_var, value) + + yield line_number, line + + +def get_file_content(url: str, session: "PipSession") -> Tuple[str, str]: + """Gets the content of a file; it may be a filename, file: URL, or + http: URL. Returns (location, content). Content is unicode. + Respects # -*- coding: declarations on the retrieved files. + + :param url: File path or url. + :param session: PipSession instance. + """ + scheme = urllib.parse.urlsplit(url).scheme + # Pip has special support for file:// URLs (LocalFSAdapter). + if scheme in ["http", "https", "file"]: + # Delay importing heavy network modules until absolutely necessary. + from pip._internal.network.utils import raise_for_status + + resp = session.get(url) + raise_for_status(resp) + return resp.url, resp.text + + # Assume this is a bare path. + try: + with open(url, "rb") as f: + raw_content = f.read() + except OSError as exc: + raise InstallationError(f"Could not open requirements file: {exc}") + + content = _decode_req_file(raw_content, url) + + return url, content + + +def _decode_req_file(data: bytes, url: str) -> str: + for bom, encoding in BOMS: + if data.startswith(bom): + return data[len(bom) :].decode(encoding) + + for line in data.split(b"\n")[:2]: + if line[0:1] == b"#": + result = PEP263_ENCODING_RE.search(line) + if result is not None: + encoding = result.groups()[0].decode("ascii") + return data.decode(encoding) + + try: + return data.decode(DEFAULT_ENCODING) + except UnicodeDecodeError: + locale_encoding = locale.getpreferredencoding(False) or sys.getdefaultencoding() + logging.warning( + "unable to decode data from %s with default encoding %s, " + "falling back to encoding from locale: %s. " + "If this is intentional you should specify the encoding with a " + "PEP-263 style comment, e.g. '# -*- coding: %s -*-'", + url, + DEFAULT_ENCODING, + locale_encoding, + locale_encoding, + ) + return data.decode(locale_encoding) diff --git a/env/lib/python3.12/site-packages/pip/_internal/req/req_install.py b/env/lib/python3.12/site-packages/pip/_internal/req/req_install.py new file mode 100644 index 0000000..3262d82 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/req/req_install.py @@ -0,0 +1,934 @@ +import functools +import logging +import os +import shutil +import sys +import uuid +import zipfile +from optparse import Values +from pathlib import Path +from typing import Any, Collection, Dict, Iterable, List, Optional, Sequence, Union + +from pip._vendor.packaging.markers import Marker +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.specifiers import SpecifierSet +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip._internal.build_env import BuildEnvironment, NoOpBuildEnvironment +from pip._internal.exceptions import InstallationError, PreviousBuildDirError +from pip._internal.locations import get_scheme +from pip._internal.metadata import ( + BaseDistribution, + get_default_environment, + get_directory_distribution, + get_wheel_distribution, +) +from pip._internal.metadata.base import FilesystemWheel +from pip._internal.models.direct_url import DirectUrl +from pip._internal.models.link import Link +from pip._internal.operations.build.metadata import generate_metadata +from pip._internal.operations.build.metadata_editable import generate_editable_metadata +from pip._internal.operations.build.metadata_legacy import ( + generate_metadata as generate_metadata_legacy, +) +from pip._internal.operations.install.editable_legacy import ( + install_editable as install_editable_legacy, +) +from pip._internal.operations.install.wheel import install_wheel +from pip._internal.pyproject import load_pyproject_toml, make_pyproject_path +from pip._internal.req.req_uninstall import UninstallPathSet +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.misc import ( + ConfiguredBuildBackendHookCaller, + ask_path_exists, + backup_dir, + display_path, + hide_url, + is_installable_dir, + redact_auth_from_requirement, + redact_auth_from_url, +) +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.subprocess import runner_with_spinner_message +from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds +from pip._internal.utils.unpacking import unpack_file +from pip._internal.utils.virtualenv import running_under_virtualenv +from pip._internal.vcs import vcs + +logger = logging.getLogger(__name__) + + +class InstallRequirement: + """ + Represents something that may be installed later on, may have information + about where to fetch the relevant requirement and also contains logic for + installing the said requirement. + """ + + def __init__( + self, + req: Optional[Requirement], + comes_from: Optional[Union[str, "InstallRequirement"]], + editable: bool = False, + link: Optional[Link] = None, + markers: Optional[Marker] = None, + use_pep517: Optional[bool] = None, + isolated: bool = False, + *, + global_options: Optional[List[str]] = None, + hash_options: Optional[Dict[str, List[str]]] = None, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, + constraint: bool = False, + extras: Collection[str] = (), + user_supplied: bool = False, + permit_editable_wheels: bool = False, + ) -> None: + assert req is None or isinstance(req, Requirement), req + self.req = req + self.comes_from = comes_from + self.constraint = constraint + self.editable = editable + self.permit_editable_wheels = permit_editable_wheels + + # source_dir is the local directory where the linked requirement is + # located, or unpacked. In case unpacking is needed, creating and + # populating source_dir is done by the RequirementPreparer. Note this + # is not necessarily the directory where pyproject.toml or setup.py is + # located - that one is obtained via unpacked_source_directory. + self.source_dir: Optional[str] = None + if self.editable: + assert link + if link.is_file: + self.source_dir = os.path.normpath(os.path.abspath(link.file_path)) + + # original_link is the direct URL that was provided by the user for the + # requirement, either directly or via a constraints file. + if link is None and req and req.url: + # PEP 508 URL requirement + link = Link(req.url) + self.link = self.original_link = link + + # When this InstallRequirement is a wheel obtained from the cache of locally + # built wheels, this is the source link corresponding to the cache entry, which + # was used to download and build the cached wheel. + self.cached_wheel_source_link: Optional[Link] = None + + # Information about the location of the artifact that was downloaded . This + # property is guaranteed to be set in resolver results. + self.download_info: Optional[DirectUrl] = None + + # Path to any downloaded or already-existing package. + self.local_file_path: Optional[str] = None + if self.link and self.link.is_file: + self.local_file_path = self.link.file_path + + if extras: + self.extras = extras + elif req: + self.extras = req.extras + else: + self.extras = set() + if markers is None and req: + markers = req.marker + self.markers = markers + + # This holds the Distribution object if this requirement is already installed. + self.satisfied_by: Optional[BaseDistribution] = None + # Whether the installation process should try to uninstall an existing + # distribution before installing this requirement. + self.should_reinstall = False + # Temporary build location + self._temp_build_dir: Optional[TempDirectory] = None + # Set to True after successful installation + self.install_succeeded: Optional[bool] = None + # Supplied options + self.global_options = global_options if global_options else [] + self.hash_options = hash_options if hash_options else {} + self.config_settings = config_settings + # Set to True after successful preparation of this requirement + self.prepared = False + # User supplied requirement are explicitly requested for installation + # by the user via CLI arguments or requirements files, as opposed to, + # e.g. dependencies, extras or constraints. + self.user_supplied = user_supplied + + self.isolated = isolated + self.build_env: BuildEnvironment = NoOpBuildEnvironment() + + # For PEP 517, the directory where we request the project metadata + # gets stored. We need this to pass to build_wheel, so the backend + # can ensure that the wheel matches the metadata (see the PEP for + # details). + self.metadata_directory: Optional[str] = None + + # The static build requirements (from pyproject.toml) + self.pyproject_requires: Optional[List[str]] = None + + # Build requirements that we will check are available + self.requirements_to_check: List[str] = [] + + # The PEP 517 backend we should use to build the project + self.pep517_backend: Optional[BuildBackendHookCaller] = None + + # Are we using PEP 517 for this requirement? + # After pyproject.toml has been loaded, the only valid values are True + # and False. Before loading, None is valid (meaning "use the default"). + # Setting an explicit value before loading pyproject.toml is supported, + # but after loading this flag should be treated as read only. + self.use_pep517 = use_pep517 + + # If config settings are provided, enforce PEP 517. + if self.config_settings: + if self.use_pep517 is False: + logger.warning( + "--no-use-pep517 ignored for %s " + "because --config-settings are specified.", + self, + ) + self.use_pep517 = True + + # This requirement needs more preparation before it can be built + self.needs_more_preparation = False + + # This requirement needs to be unpacked before it can be installed. + self._archive_source: Optional[Path] = None + + def __str__(self) -> str: + if self.req: + s = redact_auth_from_requirement(self.req) + if self.link: + s += f" from {redact_auth_from_url(self.link.url)}" + elif self.link: + s = redact_auth_from_url(self.link.url) + else: + s = "" + if self.satisfied_by is not None: + if self.satisfied_by.location is not None: + location = display_path(self.satisfied_by.location) + else: + location = "" + s += f" in {location}" + if self.comes_from: + if isinstance(self.comes_from, str): + comes_from: Optional[str] = self.comes_from + else: + comes_from = self.comes_from.from_path() + if comes_from: + s += f" (from {comes_from})" + return s + + def __repr__(self) -> str: + return ( + f"<{self.__class__.__name__} object: " + f"{str(self)} editable={self.editable!r}>" + ) + + def format_debug(self) -> str: + """An un-tested helper for getting state, for debugging.""" + attributes = vars(self) + names = sorted(attributes) + + state = (f"{attr}={attributes[attr]!r}" for attr in sorted(names)) + return "<{name} object: {{{state}}}>".format( + name=self.__class__.__name__, + state=", ".join(state), + ) + + # Things that are valid for all kinds of requirements? + @property + def name(self) -> Optional[str]: + if self.req is None: + return None + return self.req.name + + @functools.cached_property + def supports_pyproject_editable(self) -> bool: + if not self.use_pep517: + return False + assert self.pep517_backend + with self.build_env: + runner = runner_with_spinner_message( + "Checking if build backend supports build_editable" + ) + with self.pep517_backend.subprocess_runner(runner): + return "build_editable" in self.pep517_backend._supported_features() + + @property + def specifier(self) -> SpecifierSet: + assert self.req is not None + return self.req.specifier + + @property + def is_direct(self) -> bool: + """Whether this requirement was specified as a direct URL.""" + return self.original_link is not None + + @property + def is_pinned(self) -> bool: + """Return whether I am pinned to an exact version. + + For example, some-package==1.2 is pinned; some-package>1.2 is not. + """ + assert self.req is not None + specifiers = self.req.specifier + return len(specifiers) == 1 and next(iter(specifiers)).operator in {"==", "==="} + + def match_markers(self, extras_requested: Optional[Iterable[str]] = None) -> bool: + if not extras_requested: + # Provide an extra to safely evaluate the markers + # without matching any extra + extras_requested = ("",) + if self.markers is not None: + return any( + self.markers.evaluate({"extra": extra}) for extra in extras_requested + ) + else: + return True + + @property + def has_hash_options(self) -> bool: + """Return whether any known-good hashes are specified as options. + + These activate --require-hashes mode; hashes specified as part of a + URL do not. + + """ + return bool(self.hash_options) + + def hashes(self, trust_internet: bool = True) -> Hashes: + """Return a hash-comparer that considers my option- and URL-based + hashes to be known-good. + + Hashes in URLs--ones embedded in the requirements file, not ones + downloaded from an index server--are almost peers with ones from + flags. They satisfy --require-hashes (whether it was implicitly or + explicitly activated) but do not activate it. md5 and sha224 are not + allowed in flags, which should nudge people toward good algos. We + always OR all hashes together, even ones from URLs. + + :param trust_internet: Whether to trust URL-based (#md5=...) hashes + downloaded from the internet, as by populate_link() + + """ + good_hashes = self.hash_options.copy() + if trust_internet: + link = self.link + elif self.is_direct and self.user_supplied: + link = self.original_link + else: + link = None + if link and link.hash: + assert link.hash_name is not None + good_hashes.setdefault(link.hash_name, []).append(link.hash) + return Hashes(good_hashes) + + def from_path(self) -> Optional[str]: + """Format a nice indicator to show where this "comes from" """ + if self.req is None: + return None + s = str(self.req) + if self.comes_from: + comes_from: Optional[str] + if isinstance(self.comes_from, str): + comes_from = self.comes_from + else: + comes_from = self.comes_from.from_path() + if comes_from: + s += "->" + comes_from + return s + + def ensure_build_location( + self, build_dir: str, autodelete: bool, parallel_builds: bool + ) -> str: + assert build_dir is not None + if self._temp_build_dir is not None: + assert self._temp_build_dir.path + return self._temp_build_dir.path + if self.req is None: + # Some systems have /tmp as a symlink which confuses custom + # builds (such as numpy). Thus, we ensure that the real path + # is returned. + self._temp_build_dir = TempDirectory( + kind=tempdir_kinds.REQ_BUILD, globally_managed=True + ) + + return self._temp_build_dir.path + + # This is the only remaining place where we manually determine the path + # for the temporary directory. It is only needed for editables where + # it is the value of the --src option. + + # When parallel builds are enabled, add a UUID to the build directory + # name so multiple builds do not interfere with each other. + dir_name: str = canonicalize_name(self.req.name) + if parallel_builds: + dir_name = f"{dir_name}_{uuid.uuid4().hex}" + + # FIXME: Is there a better place to create the build_dir? (hg and bzr + # need this) + if not os.path.exists(build_dir): + logger.debug("Creating directory %s", build_dir) + os.makedirs(build_dir) + actual_build_dir = os.path.join(build_dir, dir_name) + # `None` indicates that we respect the globally-configured deletion + # settings, which is what we actually want when auto-deleting. + delete_arg = None if autodelete else False + return TempDirectory( + path=actual_build_dir, + delete=delete_arg, + kind=tempdir_kinds.REQ_BUILD, + globally_managed=True, + ).path + + def _set_requirement(self) -> None: + """Set requirement after generating metadata.""" + assert self.req is None + assert self.metadata is not None + assert self.source_dir is not None + + # Construct a Requirement object from the generated metadata + if isinstance(parse_version(self.metadata["Version"]), Version): + op = "==" + else: + op = "===" + + self.req = get_requirement( + "".join( + [ + self.metadata["Name"], + op, + self.metadata["Version"], + ] + ) + ) + + def warn_on_mismatching_name(self) -> None: + assert self.req is not None + metadata_name = canonicalize_name(self.metadata["Name"]) + if canonicalize_name(self.req.name) == metadata_name: + # Everything is fine. + return + + # If we're here, there's a mismatch. Log a warning about it. + logger.warning( + "Generating metadata for package %s " + "produced metadata for project name %s. Fix your " + "#egg=%s fragments.", + self.name, + metadata_name, + self.name, + ) + self.req = get_requirement(metadata_name) + + def check_if_exists(self, use_user_site: bool) -> None: + """Find an installed distribution that satisfies or conflicts + with this requirement, and set self.satisfied_by or + self.should_reinstall appropriately. + """ + if self.req is None: + return + existing_dist = get_default_environment().get_distribution(self.req.name) + if not existing_dist: + return + + version_compatible = self.req.specifier.contains( + existing_dist.version, + prereleases=True, + ) + if not version_compatible: + self.satisfied_by = None + if use_user_site: + if existing_dist.in_usersite: + self.should_reinstall = True + elif running_under_virtualenv() and existing_dist.in_site_packages: + raise InstallationError( + f"Will not install to the user site because it will " + f"lack sys.path precedence to {existing_dist.raw_name} " + f"in {existing_dist.location}" + ) + else: + self.should_reinstall = True + else: + if self.editable: + self.should_reinstall = True + # when installing editables, nothing pre-existing should ever + # satisfy + self.satisfied_by = None + else: + self.satisfied_by = existing_dist + + # Things valid for wheels + @property + def is_wheel(self) -> bool: + if not self.link: + return False + return self.link.is_wheel + + @property + def is_wheel_from_cache(self) -> bool: + # When True, it means that this InstallRequirement is a local wheel file in the + # cache of locally built wheels. + return self.cached_wheel_source_link is not None + + # Things valid for sdists + @property + def unpacked_source_directory(self) -> str: + assert self.source_dir, f"No source dir for {self}" + return os.path.join( + self.source_dir, self.link and self.link.subdirectory_fragment or "" + ) + + @property + def setup_py_path(self) -> str: + assert self.source_dir, f"No source dir for {self}" + setup_py = os.path.join(self.unpacked_source_directory, "setup.py") + + return setup_py + + @property + def setup_cfg_path(self) -> str: + assert self.source_dir, f"No source dir for {self}" + setup_cfg = os.path.join(self.unpacked_source_directory, "setup.cfg") + + return setup_cfg + + @property + def pyproject_toml_path(self) -> str: + assert self.source_dir, f"No source dir for {self}" + return make_pyproject_path(self.unpacked_source_directory) + + def load_pyproject_toml(self) -> None: + """Load the pyproject.toml file. + + After calling this routine, all of the attributes related to PEP 517 + processing for this requirement have been set. In particular, the + use_pep517 attribute can be used to determine whether we should + follow the PEP 517 or legacy (setup.py) code path. + """ + pyproject_toml_data = load_pyproject_toml( + self.use_pep517, self.pyproject_toml_path, self.setup_py_path, str(self) + ) + + if pyproject_toml_data is None: + assert not self.config_settings + self.use_pep517 = False + return + + self.use_pep517 = True + requires, backend, check, backend_path = pyproject_toml_data + self.requirements_to_check = check + self.pyproject_requires = requires + self.pep517_backend = ConfiguredBuildBackendHookCaller( + self, + self.unpacked_source_directory, + backend, + backend_path=backend_path, + ) + + def isolated_editable_sanity_check(self) -> None: + """Check that an editable requirement if valid for use with PEP 517/518. + + This verifies that an editable that has a pyproject.toml either supports PEP 660 + or as a setup.py or a setup.cfg + """ + if ( + self.editable + and self.use_pep517 + and not self.supports_pyproject_editable + and not os.path.isfile(self.setup_py_path) + and not os.path.isfile(self.setup_cfg_path) + ): + raise InstallationError( + f"Project {self} has a 'pyproject.toml' and its build " + f"backend is missing the 'build_editable' hook. Since it does not " + f"have a 'setup.py' nor a 'setup.cfg', " + f"it cannot be installed in editable mode. " + f"Consider using a build backend that supports PEP 660." + ) + + def prepare_metadata(self) -> None: + """Ensure that project metadata is available. + + Under PEP 517 and PEP 660, call the backend hook to prepare the metadata. + Under legacy processing, call setup.py egg-info. + """ + assert self.source_dir, f"No source dir for {self}" + details = self.name or f"from {self.link}" + + if self.use_pep517: + assert self.pep517_backend is not None + if ( + self.editable + and self.permit_editable_wheels + and self.supports_pyproject_editable + ): + self.metadata_directory = generate_editable_metadata( + build_env=self.build_env, + backend=self.pep517_backend, + details=details, + ) + else: + self.metadata_directory = generate_metadata( + build_env=self.build_env, + backend=self.pep517_backend, + details=details, + ) + else: + self.metadata_directory = generate_metadata_legacy( + build_env=self.build_env, + setup_py_path=self.setup_py_path, + source_dir=self.unpacked_source_directory, + isolated=self.isolated, + details=details, + ) + + # Act on the newly generated metadata, based on the name and version. + if not self.name: + self._set_requirement() + else: + self.warn_on_mismatching_name() + + self.assert_source_matches_version() + + @property + def metadata(self) -> Any: + if not hasattr(self, "_metadata"): + self._metadata = self.get_dist().metadata + + return self._metadata + + def get_dist(self) -> BaseDistribution: + if self.metadata_directory: + return get_directory_distribution(self.metadata_directory) + elif self.local_file_path and self.is_wheel: + assert self.req is not None + return get_wheel_distribution( + FilesystemWheel(self.local_file_path), + canonicalize_name(self.req.name), + ) + raise AssertionError( + f"InstallRequirement {self} has no metadata directory and no wheel: " + f"can't make a distribution." + ) + + def assert_source_matches_version(self) -> None: + assert self.source_dir, f"No source dir for {self}" + version = self.metadata["version"] + if self.req and self.req.specifier and version not in self.req.specifier: + logger.warning( + "Requested %s, but installing version %s", + self, + version, + ) + else: + logger.debug( + "Source in %s has version %s, which satisfies requirement %s", + display_path(self.source_dir), + version, + self, + ) + + # For both source distributions and editables + def ensure_has_source_dir( + self, + parent_dir: str, + autodelete: bool = False, + parallel_builds: bool = False, + ) -> None: + """Ensure that a source_dir is set. + + This will create a temporary build dir if the name of the requirement + isn't known yet. + + :param parent_dir: The ideal pip parent_dir for the source_dir. + Generally src_dir for editables and build_dir for sdists. + :return: self.source_dir + """ + if self.source_dir is None: + self.source_dir = self.ensure_build_location( + parent_dir, + autodelete=autodelete, + parallel_builds=parallel_builds, + ) + + def needs_unpacked_archive(self, archive_source: Path) -> None: + assert self._archive_source is None + self._archive_source = archive_source + + def ensure_pristine_source_checkout(self) -> None: + """Ensure the source directory has not yet been built in.""" + assert self.source_dir is not None + if self._archive_source is not None: + unpack_file(str(self._archive_source), self.source_dir) + elif is_installable_dir(self.source_dir): + # If a checkout exists, it's unwise to keep going. + # version inconsistencies are logged later, but do not fail + # the installation. + raise PreviousBuildDirError( + f"pip can't proceed with requirements '{self}' due to a " + f"pre-existing build directory ({self.source_dir}). This is likely " + "due to a previous installation that failed . pip is " + "being responsible and not assuming it can delete this. " + "Please delete it and try again." + ) + + # For editable installations + def update_editable(self) -> None: + if not self.link: + logger.debug( + "Cannot update repository at %s; repository location is unknown", + self.source_dir, + ) + return + assert self.editable + assert self.source_dir + if self.link.scheme == "file": + # Static paths don't get updated + return + vcs_backend = vcs.get_backend_for_scheme(self.link.scheme) + # Editable requirements are validated in Requirement constructors. + # So here, if it's neither a path nor a valid VCS URL, it's a bug. + assert vcs_backend, f"Unsupported VCS URL {self.link.url}" + hidden_url = hide_url(self.link.url) + vcs_backend.obtain(self.source_dir, url=hidden_url, verbosity=0) + + # Top-level Actions + def uninstall( + self, auto_confirm: bool = False, verbose: bool = False + ) -> Optional[UninstallPathSet]: + """ + Uninstall the distribution currently satisfying this requirement. + + Prompts before removing or modifying files unless + ``auto_confirm`` is True. + + Refuses to delete or modify files outside of ``sys.prefix`` - + thus uninstallation within a virtual environment can only + modify that virtual environment, even if the virtualenv is + linked to global site-packages. + + """ + assert self.req + dist = get_default_environment().get_distribution(self.req.name) + if not dist: + logger.warning("Skipping %s as it is not installed.", self.name) + return None + logger.info("Found existing installation: %s", dist) + + uninstalled_pathset = UninstallPathSet.from_dist(dist) + uninstalled_pathset.remove(auto_confirm, verbose) + return uninstalled_pathset + + def _get_archive_name(self, path: str, parentdir: str, rootdir: str) -> str: + def _clean_zip_name(name: str, prefix: str) -> str: + assert name.startswith( + prefix + os.path.sep + ), f"name {name!r} doesn't start with prefix {prefix!r}" + name = name[len(prefix) + 1 :] + name = name.replace(os.path.sep, "/") + return name + + assert self.req is not None + path = os.path.join(parentdir, path) + name = _clean_zip_name(path, rootdir) + return self.req.name + "/" + name + + def archive(self, build_dir: Optional[str]) -> None: + """Saves archive to provided build_dir. + + Used for saving downloaded VCS requirements as part of `pip download`. + """ + assert self.source_dir + if build_dir is None: + return + + create_archive = True + archive_name = "{}-{}.zip".format(self.name, self.metadata["version"]) + archive_path = os.path.join(build_dir, archive_name) + + if os.path.exists(archive_path): + response = ask_path_exists( + f"The file {display_path(archive_path)} exists. (i)gnore, (w)ipe, " + "(b)ackup, (a)bort ", + ("i", "w", "b", "a"), + ) + if response == "i": + create_archive = False + elif response == "w": + logger.warning("Deleting %s", display_path(archive_path)) + os.remove(archive_path) + elif response == "b": + dest_file = backup_dir(archive_path) + logger.warning( + "Backing up %s to %s", + display_path(archive_path), + display_path(dest_file), + ) + shutil.move(archive_path, dest_file) + elif response == "a": + sys.exit(-1) + + if not create_archive: + return + + zip_output = zipfile.ZipFile( + archive_path, + "w", + zipfile.ZIP_DEFLATED, + allowZip64=True, + ) + with zip_output: + dir = os.path.normcase(os.path.abspath(self.unpacked_source_directory)) + for dirpath, dirnames, filenames in os.walk(dir): + for dirname in dirnames: + dir_arcname = self._get_archive_name( + dirname, + parentdir=dirpath, + rootdir=dir, + ) + zipdir = zipfile.ZipInfo(dir_arcname + "/") + zipdir.external_attr = 0x1ED << 16 # 0o755 + zip_output.writestr(zipdir, "") + for filename in filenames: + file_arcname = self._get_archive_name( + filename, + parentdir=dirpath, + rootdir=dir, + ) + filename = os.path.join(dirpath, filename) + zip_output.write(filename, file_arcname) + + logger.info("Saved %s", display_path(archive_path)) + + def install( + self, + global_options: Optional[Sequence[str]] = None, + root: Optional[str] = None, + home: Optional[str] = None, + prefix: Optional[str] = None, + warn_script_location: bool = True, + use_user_site: bool = False, + pycompile: bool = True, + ) -> None: + assert self.req is not None + scheme = get_scheme( + self.req.name, + user=use_user_site, + home=home, + root=root, + isolated=self.isolated, + prefix=prefix, + ) + + if self.editable and not self.is_wheel: + deprecated( + reason=( + f"Legacy editable install of {self} (setup.py develop) " + "is deprecated." + ), + replacement=( + "to add a pyproject.toml or enable --use-pep517, " + "and use setuptools >= 64. " + "If the resulting installation is not behaving as expected, " + "try using --config-settings editable_mode=compat. " + "Please consult the setuptools documentation for more information" + ), + gone_in="25.1", + issue=11457, + ) + if self.config_settings: + logger.warning( + "--config-settings ignored for legacy editable install of %s. " + "Consider upgrading to a version of setuptools " + "that supports PEP 660 (>= 64).", + self, + ) + install_editable_legacy( + global_options=global_options if global_options is not None else [], + prefix=prefix, + home=home, + use_user_site=use_user_site, + name=self.req.name, + setup_py_path=self.setup_py_path, + isolated=self.isolated, + build_env=self.build_env, + unpacked_source_directory=self.unpacked_source_directory, + ) + self.install_succeeded = True + return + + assert self.is_wheel + assert self.local_file_path + + install_wheel( + self.req.name, + self.local_file_path, + scheme=scheme, + req_description=str(self.req), + pycompile=pycompile, + warn_script_location=warn_script_location, + direct_url=self.download_info if self.is_direct else None, + requested=self.user_supplied, + ) + self.install_succeeded = True + + +def check_invalid_constraint_type(req: InstallRequirement) -> str: + # Check for unsupported forms + problem = "" + if not req.name: + problem = "Unnamed requirements are not allowed as constraints" + elif req.editable: + problem = "Editable requirements are not allowed as constraints" + elif req.extras: + problem = "Constraints cannot have extras" + + if problem: + deprecated( + reason=( + "Constraints are only allowed to take the form of a package " + "name and a version specifier. Other forms were originally " + "permitted as an accident of the implementation, but were " + "undocumented. The new implementation of the resolver no " + "longer supports these forms." + ), + replacement="replacing the constraint with a requirement", + # No plan yet for when the new resolver becomes default + gone_in=None, + issue=8210, + ) + + return problem + + +def _has_option(options: Values, reqs: List[InstallRequirement], option: str) -> bool: + if getattr(options, option, None): + return True + for req in reqs: + if getattr(req, option, None): + return True + return False + + +def check_legacy_setup_py_options( + options: Values, + reqs: List[InstallRequirement], +) -> None: + has_build_options = _has_option(options, reqs, "build_options") + has_global_options = _has_option(options, reqs, "global_options") + if has_build_options or has_global_options: + deprecated( + reason="--build-option and --global-option are deprecated.", + issue=11859, + replacement="to use --config-settings", + gone_in=None, + ) + logger.warning( + "Implying --no-binary=:all: due to the presence of " + "--build-option / --global-option. " + ) + options.format_control.disallow_binaries() diff --git a/env/lib/python3.12/site-packages/pip/_internal/req/req_set.py b/env/lib/python3.12/site-packages/pip/_internal/req/req_set.py new file mode 100644 index 0000000..ec7a6e0 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/req/req_set.py @@ -0,0 +1,82 @@ +import logging +from collections import OrderedDict +from typing import Dict, List + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.req.req_install import InstallRequirement + +logger = logging.getLogger(__name__) + + +class RequirementSet: + def __init__(self, check_supported_wheels: bool = True) -> None: + """Create a RequirementSet.""" + + self.requirements: Dict[str, InstallRequirement] = OrderedDict() + self.check_supported_wheels = check_supported_wheels + + self.unnamed_requirements: List[InstallRequirement] = [] + + def __str__(self) -> str: + requirements = sorted( + (req for req in self.requirements.values() if not req.comes_from), + key=lambda req: canonicalize_name(req.name or ""), + ) + return " ".join(str(req.req) for req in requirements) + + def __repr__(self) -> str: + requirements = sorted( + self.requirements.values(), + key=lambda req: canonicalize_name(req.name or ""), + ) + + format_string = "<{classname} object; {count} requirement(s): {reqs}>" + return format_string.format( + classname=self.__class__.__name__, + count=len(requirements), + reqs=", ".join(str(req.req) for req in requirements), + ) + + def add_unnamed_requirement(self, install_req: InstallRequirement) -> None: + assert not install_req.name + self.unnamed_requirements.append(install_req) + + def add_named_requirement(self, install_req: InstallRequirement) -> None: + assert install_req.name + + project_name = canonicalize_name(install_req.name) + self.requirements[project_name] = install_req + + def has_requirement(self, name: str) -> bool: + project_name = canonicalize_name(name) + + return ( + project_name in self.requirements + and not self.requirements[project_name].constraint + ) + + def get_requirement(self, name: str) -> InstallRequirement: + project_name = canonicalize_name(name) + + if project_name in self.requirements: + return self.requirements[project_name] + + raise KeyError(f"No project with the name {name!r}") + + @property + def all_requirements(self) -> List[InstallRequirement]: + return self.unnamed_requirements + list(self.requirements.values()) + + @property + def requirements_to_install(self) -> List[InstallRequirement]: + """Return the list of requirements that need to be installed. + + TODO remove this property together with the legacy resolver, since the new + resolver only returns requirements that need to be installed. + """ + return [ + install_req + for install_req in self.all_requirements + if not install_req.constraint and not install_req.satisfied_by + ] diff --git a/env/lib/python3.12/site-packages/pip/_internal/req/req_uninstall.py b/env/lib/python3.12/site-packages/pip/_internal/req/req_uninstall.py new file mode 100644 index 0000000..26df208 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/req/req_uninstall.py @@ -0,0 +1,633 @@ +import functools +import os +import sys +import sysconfig +from importlib.util import cache_from_source +from typing import Any, Callable, Dict, Generator, Iterable, List, Optional, Set, Tuple + +from pip._internal.exceptions import LegacyDistutilsInstall, UninstallMissingRecord +from pip._internal.locations import get_bin_prefix, get_bin_user +from pip._internal.metadata import BaseDistribution +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.egg_link import egg_link_path_from_location +from pip._internal.utils.logging import getLogger, indent_log +from pip._internal.utils.misc import ask, normalize_path, renames, rmtree +from pip._internal.utils.temp_dir import AdjacentTempDirectory, TempDirectory +from pip._internal.utils.virtualenv import running_under_virtualenv + +logger = getLogger(__name__) + + +def _script_names( + bin_dir: str, script_name: str, is_gui: bool +) -> Generator[str, None, None]: + """Create the fully qualified name of the files created by + {console,gui}_scripts for the given ``dist``. + Returns the list of file names + """ + exe_name = os.path.join(bin_dir, script_name) + yield exe_name + if not WINDOWS: + return + yield f"{exe_name}.exe" + yield f"{exe_name}.exe.manifest" + if is_gui: + yield f"{exe_name}-script.pyw" + else: + yield f"{exe_name}-script.py" + + +def _unique( + fn: Callable[..., Generator[Any, None, None]] +) -> Callable[..., Generator[Any, None, None]]: + @functools.wraps(fn) + def unique(*args: Any, **kw: Any) -> Generator[Any, None, None]: + seen: Set[Any] = set() + for item in fn(*args, **kw): + if item not in seen: + seen.add(item) + yield item + + return unique + + +@_unique +def uninstallation_paths(dist: BaseDistribution) -> Generator[str, None, None]: + """ + Yield all the uninstallation paths for dist based on RECORD-without-.py[co] + + Yield paths to all the files in RECORD. For each .py file in RECORD, add + the .pyc and .pyo in the same directory. + + UninstallPathSet.add() takes care of the __pycache__ .py[co]. + + If RECORD is not found, raises an error, + with possible information from the INSTALLER file. + + https://packaging.python.org/specifications/recording-installed-packages/ + """ + location = dist.location + assert location is not None, "not installed" + + entries = dist.iter_declared_entries() + if entries is None: + raise UninstallMissingRecord(distribution=dist) + + for entry in entries: + path = os.path.join(location, entry) + yield path + if path.endswith(".py"): + dn, fn = os.path.split(path) + base = fn[:-3] + path = os.path.join(dn, base + ".pyc") + yield path + path = os.path.join(dn, base + ".pyo") + yield path + + +def compact(paths: Iterable[str]) -> Set[str]: + """Compact a path set to contain the minimal number of paths + necessary to contain all paths in the set. If /a/path/ and + /a/path/to/a/file.txt are both in the set, leave only the + shorter path.""" + + sep = os.path.sep + short_paths: Set[str] = set() + for path in sorted(paths, key=len): + should_skip = any( + path.startswith(shortpath.rstrip("*")) + and path[len(shortpath.rstrip("*").rstrip(sep))] == sep + for shortpath in short_paths + ) + if not should_skip: + short_paths.add(path) + return short_paths + + +def compress_for_rename(paths: Iterable[str]) -> Set[str]: + """Returns a set containing the paths that need to be renamed. + + This set may include directories when the original sequence of paths + included every file on disk. + """ + case_map = {os.path.normcase(p): p for p in paths} + remaining = set(case_map) + unchecked = sorted({os.path.split(p)[0] for p in case_map.values()}, key=len) + wildcards: Set[str] = set() + + def norm_join(*a: str) -> str: + return os.path.normcase(os.path.join(*a)) + + for root in unchecked: + if any(os.path.normcase(root).startswith(w) for w in wildcards): + # This directory has already been handled. + continue + + all_files: Set[str] = set() + all_subdirs: Set[str] = set() + for dirname, subdirs, files in os.walk(root): + all_subdirs.update(norm_join(root, dirname, d) for d in subdirs) + all_files.update(norm_join(root, dirname, f) for f in files) + # If all the files we found are in our remaining set of files to + # remove, then remove them from the latter set and add a wildcard + # for the directory. + if not (all_files - remaining): + remaining.difference_update(all_files) + wildcards.add(root + os.sep) + + return set(map(case_map.__getitem__, remaining)) | wildcards + + +def compress_for_output_listing(paths: Iterable[str]) -> Tuple[Set[str], Set[str]]: + """Returns a tuple of 2 sets of which paths to display to user + + The first set contains paths that would be deleted. Files of a package + are not added and the top-level directory of the package has a '*' added + at the end - to signify that all it's contents are removed. + + The second set contains files that would have been skipped in the above + folders. + """ + + will_remove = set(paths) + will_skip = set() + + # Determine folders and files + folders = set() + files = set() + for path in will_remove: + if path.endswith(".pyc"): + continue + if path.endswith("__init__.py") or ".dist-info" in path: + folders.add(os.path.dirname(path)) + files.add(path) + + _normcased_files = set(map(os.path.normcase, files)) + + folders = compact(folders) + + # This walks the tree using os.walk to not miss extra folders + # that might get added. + for folder in folders: + for dirpath, _, dirfiles in os.walk(folder): + for fname in dirfiles: + if fname.endswith(".pyc"): + continue + + file_ = os.path.join(dirpath, fname) + if ( + os.path.isfile(file_) + and os.path.normcase(file_) not in _normcased_files + ): + # We are skipping this file. Add it to the set. + will_skip.add(file_) + + will_remove = files | {os.path.join(folder, "*") for folder in folders} + + return will_remove, will_skip + + +class StashedUninstallPathSet: + """A set of file rename operations to stash files while + tentatively uninstalling them.""" + + def __init__(self) -> None: + # Mapping from source file root to [Adjacent]TempDirectory + # for files under that directory. + self._save_dirs: Dict[str, TempDirectory] = {} + # (old path, new path) tuples for each move that may need + # to be undone. + self._moves: List[Tuple[str, str]] = [] + + def _get_directory_stash(self, path: str) -> str: + """Stashes a directory. + + Directories are stashed adjacent to their original location if + possible, or else moved/copied into the user's temp dir.""" + + try: + save_dir: TempDirectory = AdjacentTempDirectory(path) + except OSError: + save_dir = TempDirectory(kind="uninstall") + self._save_dirs[os.path.normcase(path)] = save_dir + + return save_dir.path + + def _get_file_stash(self, path: str) -> str: + """Stashes a file. + + If no root has been provided, one will be created for the directory + in the user's temp directory.""" + path = os.path.normcase(path) + head, old_head = os.path.dirname(path), None + save_dir = None + + while head != old_head: + try: + save_dir = self._save_dirs[head] + break + except KeyError: + pass + head, old_head = os.path.dirname(head), head + else: + # Did not find any suitable root + head = os.path.dirname(path) + save_dir = TempDirectory(kind="uninstall") + self._save_dirs[head] = save_dir + + relpath = os.path.relpath(path, head) + if relpath and relpath != os.path.curdir: + return os.path.join(save_dir.path, relpath) + return save_dir.path + + def stash(self, path: str) -> str: + """Stashes the directory or file and returns its new location. + Handle symlinks as files to avoid modifying the symlink targets. + """ + path_is_dir = os.path.isdir(path) and not os.path.islink(path) + if path_is_dir: + new_path = self._get_directory_stash(path) + else: + new_path = self._get_file_stash(path) + + self._moves.append((path, new_path)) + if path_is_dir and os.path.isdir(new_path): + # If we're moving a directory, we need to + # remove the destination first or else it will be + # moved to inside the existing directory. + # We just created new_path ourselves, so it will + # be removable. + os.rmdir(new_path) + renames(path, new_path) + return new_path + + def commit(self) -> None: + """Commits the uninstall by removing stashed files.""" + for save_dir in self._save_dirs.values(): + save_dir.cleanup() + self._moves = [] + self._save_dirs = {} + + def rollback(self) -> None: + """Undoes the uninstall by moving stashed files back.""" + for p in self._moves: + logger.info("Moving to %s\n from %s", *p) + + for new_path, path in self._moves: + try: + logger.debug("Replacing %s from %s", new_path, path) + if os.path.isfile(new_path) or os.path.islink(new_path): + os.unlink(new_path) + elif os.path.isdir(new_path): + rmtree(new_path) + renames(path, new_path) + except OSError as ex: + logger.error("Failed to restore %s", new_path) + logger.debug("Exception: %s", ex) + + self.commit() + + @property + def can_rollback(self) -> bool: + return bool(self._moves) + + +class UninstallPathSet: + """A set of file paths to be removed in the uninstallation of a + requirement.""" + + def __init__(self, dist: BaseDistribution) -> None: + self._paths: Set[str] = set() + self._refuse: Set[str] = set() + self._pth: Dict[str, UninstallPthEntries] = {} + self._dist = dist + self._moved_paths = StashedUninstallPathSet() + # Create local cache of normalize_path results. Creating an UninstallPathSet + # can result in hundreds/thousands of redundant calls to normalize_path with + # the same args, which hurts performance. + self._normalize_path_cached = functools.lru_cache(normalize_path) + + def _permitted(self, path: str) -> bool: + """ + Return True if the given path is one we are permitted to + remove/modify, False otherwise. + + """ + # aka is_local, but caching normalized sys.prefix + if not running_under_virtualenv(): + return True + return path.startswith(self._normalize_path_cached(sys.prefix)) + + def add(self, path: str) -> None: + head, tail = os.path.split(path) + + # we normalize the head to resolve parent directory symlinks, but not + # the tail, since we only want to uninstall symlinks, not their targets + path = os.path.join(self._normalize_path_cached(head), os.path.normcase(tail)) + + if not os.path.exists(path): + return + if self._permitted(path): + self._paths.add(path) + else: + self._refuse.add(path) + + # __pycache__ files can show up after 'installed-files.txt' is created, + # due to imports + if os.path.splitext(path)[1] == ".py": + self.add(cache_from_source(path)) + + def add_pth(self, pth_file: str, entry: str) -> None: + pth_file = self._normalize_path_cached(pth_file) + if self._permitted(pth_file): + if pth_file not in self._pth: + self._pth[pth_file] = UninstallPthEntries(pth_file) + self._pth[pth_file].add(entry) + else: + self._refuse.add(pth_file) + + def remove(self, auto_confirm: bool = False, verbose: bool = False) -> None: + """Remove paths in ``self._paths`` with confirmation (unless + ``auto_confirm`` is True).""" + + if not self._paths: + logger.info( + "Can't uninstall '%s'. No files were found to uninstall.", + self._dist.raw_name, + ) + return + + dist_name_version = f"{self._dist.raw_name}-{self._dist.raw_version}" + logger.info("Uninstalling %s:", dist_name_version) + + with indent_log(): + if auto_confirm or self._allowed_to_proceed(verbose): + moved = self._moved_paths + + for_rename = compress_for_rename(self._paths) + + for path in sorted(compact(for_rename)): + moved.stash(path) + logger.verbose("Removing file or directory %s", path) + + for pth in self._pth.values(): + pth.remove() + + logger.info("Successfully uninstalled %s", dist_name_version) + + def _allowed_to_proceed(self, verbose: bool) -> bool: + """Display which files would be deleted and prompt for confirmation""" + + def _display(msg: str, paths: Iterable[str]) -> None: + if not paths: + return + + logger.info(msg) + with indent_log(): + for path in sorted(compact(paths)): + logger.info(path) + + if not verbose: + will_remove, will_skip = compress_for_output_listing(self._paths) + else: + # In verbose mode, display all the files that are going to be + # deleted. + will_remove = set(self._paths) + will_skip = set() + + _display("Would remove:", will_remove) + _display("Would not remove (might be manually added):", will_skip) + _display("Would not remove (outside of prefix):", self._refuse) + if verbose: + _display("Will actually move:", compress_for_rename(self._paths)) + + return ask("Proceed (Y/n)? ", ("y", "n", "")) != "n" + + def rollback(self) -> None: + """Rollback the changes previously made by remove().""" + if not self._moved_paths.can_rollback: + logger.error( + "Can't roll back %s; was not uninstalled", + self._dist.raw_name, + ) + return + logger.info("Rolling back uninstall of %s", self._dist.raw_name) + self._moved_paths.rollback() + for pth in self._pth.values(): + pth.rollback() + + def commit(self) -> None: + """Remove temporary save dir: rollback will no longer be possible.""" + self._moved_paths.commit() + + @classmethod + def from_dist(cls, dist: BaseDistribution) -> "UninstallPathSet": + dist_location = dist.location + info_location = dist.info_location + if dist_location is None: + logger.info( + "Not uninstalling %s since it is not installed", + dist.canonical_name, + ) + return cls(dist) + + normalized_dist_location = normalize_path(dist_location) + if not dist.local: + logger.info( + "Not uninstalling %s at %s, outside environment %s", + dist.canonical_name, + normalized_dist_location, + sys.prefix, + ) + return cls(dist) + + if normalized_dist_location in { + p + for p in {sysconfig.get_path("stdlib"), sysconfig.get_path("platstdlib")} + if p + }: + logger.info( + "Not uninstalling %s at %s, as it is in the standard library.", + dist.canonical_name, + normalized_dist_location, + ) + return cls(dist) + + paths_to_remove = cls(dist) + develop_egg_link = egg_link_path_from_location(dist.raw_name) + + # Distribution is installed with metadata in a "flat" .egg-info + # directory. This means it is not a modern .dist-info installation, an + # egg, or legacy editable. + setuptools_flat_installation = ( + dist.installed_with_setuptools_egg_info + and info_location is not None + and os.path.exists(info_location) + # If dist is editable and the location points to a ``.egg-info``, + # we are in fact in the legacy editable case. + and not info_location.endswith(f"{dist.setuptools_filename}.egg-info") + ) + + # Uninstall cases order do matter as in the case of 2 installs of the + # same package, pip needs to uninstall the currently detected version + if setuptools_flat_installation: + if info_location is not None: + paths_to_remove.add(info_location) + installed_files = dist.iter_declared_entries() + if installed_files is not None: + for installed_file in installed_files: + paths_to_remove.add(os.path.join(dist_location, installed_file)) + # FIXME: need a test for this elif block + # occurs with --single-version-externally-managed/--record outside + # of pip + elif dist.is_file("top_level.txt"): + try: + namespace_packages = dist.read_text("namespace_packages.txt") + except FileNotFoundError: + namespaces = [] + else: + namespaces = namespace_packages.splitlines(keepends=False) + for top_level_pkg in [ + p + for p in dist.read_text("top_level.txt").splitlines() + if p and p not in namespaces + ]: + path = os.path.join(dist_location, top_level_pkg) + paths_to_remove.add(path) + paths_to_remove.add(f"{path}.py") + paths_to_remove.add(f"{path}.pyc") + paths_to_remove.add(f"{path}.pyo") + + elif dist.installed_by_distutils: + raise LegacyDistutilsInstall(distribution=dist) + + elif dist.installed_as_egg: + # package installed by easy_install + # We cannot match on dist.egg_name because it can slightly vary + # i.e. setuptools-0.6c11-py2.6.egg vs setuptools-0.6rc11-py2.6.egg + paths_to_remove.add(dist_location) + easy_install_egg = os.path.split(dist_location)[1] + easy_install_pth = os.path.join( + os.path.dirname(dist_location), + "easy-install.pth", + ) + paths_to_remove.add_pth(easy_install_pth, "./" + easy_install_egg) + + elif dist.installed_with_dist_info: + for path in uninstallation_paths(dist): + paths_to_remove.add(path) + + elif develop_egg_link: + # PEP 660 modern editable is handled in the ``.dist-info`` case + # above, so this only covers the setuptools-style editable. + with open(develop_egg_link) as fh: + link_pointer = os.path.normcase(fh.readline().strip()) + normalized_link_pointer = paths_to_remove._normalize_path_cached( + link_pointer + ) + assert os.path.samefile( + normalized_link_pointer, normalized_dist_location + ), ( + f"Egg-link {develop_egg_link} (to {link_pointer}) does not match " + f"installed location of {dist.raw_name} (at {dist_location})" + ) + paths_to_remove.add(develop_egg_link) + easy_install_pth = os.path.join( + os.path.dirname(develop_egg_link), "easy-install.pth" + ) + paths_to_remove.add_pth(easy_install_pth, dist_location) + + else: + logger.debug( + "Not sure how to uninstall: %s - Check: %s", + dist, + dist_location, + ) + + if dist.in_usersite: + bin_dir = get_bin_user() + else: + bin_dir = get_bin_prefix() + + # find distutils scripts= scripts + try: + for script in dist.iter_distutils_script_names(): + paths_to_remove.add(os.path.join(bin_dir, script)) + if WINDOWS: + paths_to_remove.add(os.path.join(bin_dir, f"{script}.bat")) + except (FileNotFoundError, NotADirectoryError): + pass + + # find console_scripts and gui_scripts + def iter_scripts_to_remove( + dist: BaseDistribution, + bin_dir: str, + ) -> Generator[str, None, None]: + for entry_point in dist.iter_entry_points(): + if entry_point.group == "console_scripts": + yield from _script_names(bin_dir, entry_point.name, False) + elif entry_point.group == "gui_scripts": + yield from _script_names(bin_dir, entry_point.name, True) + + for s in iter_scripts_to_remove(dist, bin_dir): + paths_to_remove.add(s) + + return paths_to_remove + + +class UninstallPthEntries: + def __init__(self, pth_file: str) -> None: + self.file = pth_file + self.entries: Set[str] = set() + self._saved_lines: Optional[List[bytes]] = None + + def add(self, entry: str) -> None: + entry = os.path.normcase(entry) + # On Windows, os.path.normcase converts the entry to use + # backslashes. This is correct for entries that describe absolute + # paths outside of site-packages, but all the others use forward + # slashes. + # os.path.splitdrive is used instead of os.path.isabs because isabs + # treats non-absolute paths with drive letter markings like c:foo\bar + # as absolute paths. It also does not recognize UNC paths if they don't + # have more than "\\sever\share". Valid examples: "\\server\share\" or + # "\\server\share\folder". + if WINDOWS and not os.path.splitdrive(entry)[0]: + entry = entry.replace("\\", "/") + self.entries.add(entry) + + def remove(self) -> None: + logger.verbose("Removing pth entries from %s:", self.file) + + # If the file doesn't exist, log a warning and return + if not os.path.isfile(self.file): + logger.warning("Cannot remove entries from nonexistent file %s", self.file) + return + with open(self.file, "rb") as fh: + # windows uses '\r\n' with py3k, but uses '\n' with py2.x + lines = fh.readlines() + self._saved_lines = lines + if any(b"\r\n" in line for line in lines): + endline = "\r\n" + else: + endline = "\n" + # handle missing trailing newline + if lines and not lines[-1].endswith(endline.encode("utf-8")): + lines[-1] = lines[-1] + endline.encode("utf-8") + for entry in self.entries: + try: + logger.verbose("Removing entry: %s", entry) + lines.remove((entry + endline).encode("utf-8")) + except ValueError: + pass + with open(self.file, "wb") as fh: + fh.writelines(lines) + + def rollback(self) -> bool: + if self._saved_lines is None: + logger.error("Cannot roll back changes to %s, none were made", self.file) + return False + logger.debug("Rolling %s back to previous state", self.file) + with open(self.file, "wb") as fh: + fh.writelines(self._saved_lines) + return True diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/base.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/base.py new file mode 100644 index 0000000..42dade1 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/resolution/base.py @@ -0,0 +1,20 @@ +from typing import Callable, List, Optional + +from pip._internal.req.req_install import InstallRequirement +from pip._internal.req.req_set import RequirementSet + +InstallRequirementProvider = Callable[ + [str, Optional[InstallRequirement]], InstallRequirement +] + + +class BaseResolver: + def resolve( + self, root_reqs: List[InstallRequirement], check_supported_wheels: bool + ) -> RequirementSet: + raise NotImplementedError() + + def get_installation_order( + self, req_set: RequirementSet + ) -> List[InstallRequirement]: + raise NotImplementedError() diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/legacy/resolver.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/legacy/resolver.py new file mode 100644 index 0000000..1dd0d70 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/resolution/legacy/resolver.py @@ -0,0 +1,597 @@ +"""Dependency Resolution + +The dependency resolution in pip is performed as follows: + +for top-level requirements: + a. only one spec allowed per project, regardless of conflicts or not. + otherwise a "double requirement" exception is raised + b. they override sub-dependency requirements. +for sub-dependencies + a. "first found, wins" (where the order is breadth first) +""" + +import logging +import sys +from collections import defaultdict +from itertools import chain +from typing import DefaultDict, Iterable, List, Optional, Set, Tuple + +from pip._vendor.packaging import specifiers +from pip._vendor.packaging.requirements import Requirement + +from pip._internal.cache import WheelCache +from pip._internal.exceptions import ( + BestVersionAlreadyInstalled, + DistributionNotFound, + HashError, + HashErrors, + InstallationError, + NoneMetadataError, + UnsupportedPythonVersion, +) +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import BaseDistribution +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.req_install import ( + InstallRequirement, + check_invalid_constraint_type, +) +from pip._internal.req.req_set import RequirementSet +from pip._internal.resolution.base import BaseResolver, InstallRequirementProvider +from pip._internal.utils import compatibility_tags +from pip._internal.utils.compatibility_tags import get_supported +from pip._internal.utils.direct_url_helpers import direct_url_from_link +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import normalize_version_info +from pip._internal.utils.packaging import check_requires_python + +logger = logging.getLogger(__name__) + +DiscoveredDependencies = DefaultDict[Optional[str], List[InstallRequirement]] + + +def _check_dist_requires_python( + dist: BaseDistribution, + version_info: Tuple[int, int, int], + ignore_requires_python: bool = False, +) -> None: + """ + Check whether the given Python version is compatible with a distribution's + "Requires-Python" value. + + :param version_info: A 3-tuple of ints representing the Python + major-minor-micro version to check. + :param ignore_requires_python: Whether to ignore the "Requires-Python" + value if the given Python version isn't compatible. + + :raises UnsupportedPythonVersion: When the given Python version isn't + compatible. + """ + # This idiosyncratically converts the SpecifierSet to str and let + # check_requires_python then parse it again into SpecifierSet. But this + # is the legacy resolver so I'm just not going to bother refactoring. + try: + requires_python = str(dist.requires_python) + except FileNotFoundError as e: + raise NoneMetadataError(dist, str(e)) + try: + is_compatible = check_requires_python( + requires_python, + version_info=version_info, + ) + except specifiers.InvalidSpecifier as exc: + logger.warning( + "Package %r has an invalid Requires-Python: %s", dist.raw_name, exc + ) + return + + if is_compatible: + return + + version = ".".join(map(str, version_info)) + if ignore_requires_python: + logger.debug( + "Ignoring failed Requires-Python check for package %r: %s not in %r", + dist.raw_name, + version, + requires_python, + ) + return + + raise UnsupportedPythonVersion( + f"Package {dist.raw_name!r} requires a different Python: " + f"{version} not in {requires_python!r}" + ) + + +class Resolver(BaseResolver): + """Resolves which packages need to be installed/uninstalled to perform \ + the requested operation without breaking the requirements of any package. + """ + + _allowed_strategies = {"eager", "only-if-needed", "to-satisfy-only"} + + def __init__( + self, + preparer: RequirementPreparer, + finder: PackageFinder, + wheel_cache: Optional[WheelCache], + make_install_req: InstallRequirementProvider, + use_user_site: bool, + ignore_dependencies: bool, + ignore_installed: bool, + ignore_requires_python: bool, + force_reinstall: bool, + upgrade_strategy: str, + py_version_info: Optional[Tuple[int, ...]] = None, + ) -> None: + super().__init__() + assert upgrade_strategy in self._allowed_strategies + + if py_version_info is None: + py_version_info = sys.version_info[:3] + else: + py_version_info = normalize_version_info(py_version_info) + + self._py_version_info = py_version_info + + self.preparer = preparer + self.finder = finder + self.wheel_cache = wheel_cache + + self.upgrade_strategy = upgrade_strategy + self.force_reinstall = force_reinstall + self.ignore_dependencies = ignore_dependencies + self.ignore_installed = ignore_installed + self.ignore_requires_python = ignore_requires_python + self.use_user_site = use_user_site + self._make_install_req = make_install_req + + self._discovered_dependencies: DiscoveredDependencies = defaultdict(list) + + def resolve( + self, root_reqs: List[InstallRequirement], check_supported_wheels: bool + ) -> RequirementSet: + """Resolve what operations need to be done + + As a side-effect of this method, the packages (and their dependencies) + are downloaded, unpacked and prepared for installation. This + preparation is done by ``pip.operations.prepare``. + + Once PyPI has static dependency metadata available, it would be + possible to move the preparation to become a step separated from + dependency resolution. + """ + requirement_set = RequirementSet(check_supported_wheels=check_supported_wheels) + for req in root_reqs: + if req.constraint: + check_invalid_constraint_type(req) + self._add_requirement_to_set(requirement_set, req) + + # Actually prepare the files, and collect any exceptions. Most hash + # exceptions cannot be checked ahead of time, because + # _populate_link() needs to be called before we can make decisions + # based on link type. + discovered_reqs: List[InstallRequirement] = [] + hash_errors = HashErrors() + for req in chain(requirement_set.all_requirements, discovered_reqs): + try: + discovered_reqs.extend(self._resolve_one(requirement_set, req)) + except HashError as exc: + exc.req = req + hash_errors.append(exc) + + if hash_errors: + raise hash_errors + + return requirement_set + + def _add_requirement_to_set( + self, + requirement_set: RequirementSet, + install_req: InstallRequirement, + parent_req_name: Optional[str] = None, + extras_requested: Optional[Iterable[str]] = None, + ) -> Tuple[List[InstallRequirement], Optional[InstallRequirement]]: + """Add install_req as a requirement to install. + + :param parent_req_name: The name of the requirement that needed this + added. The name is used because when multiple unnamed requirements + resolve to the same name, we could otherwise end up with dependency + links that point outside the Requirements set. parent_req must + already be added. Note that None implies that this is a user + supplied requirement, vs an inferred one. + :param extras_requested: an iterable of extras used to evaluate the + environment markers. + :return: Additional requirements to scan. That is either [] if + the requirement is not applicable, or [install_req] if the + requirement is applicable and has just been added. + """ + # If the markers do not match, ignore this requirement. + if not install_req.match_markers(extras_requested): + logger.info( + "Ignoring %s: markers '%s' don't match your environment", + install_req.name, + install_req.markers, + ) + return [], None + + # If the wheel is not supported, raise an error. + # Should check this after filtering out based on environment markers to + # allow specifying different wheels based on the environment/OS, in a + # single requirements file. + if install_req.link and install_req.link.is_wheel: + wheel = Wheel(install_req.link.filename) + tags = compatibility_tags.get_supported() + if requirement_set.check_supported_wheels and not wheel.supported(tags): + raise InstallationError( + f"{wheel.filename} is not a supported wheel on this platform." + ) + + # This next bit is really a sanity check. + assert ( + not install_req.user_supplied or parent_req_name is None + ), "a user supplied req shouldn't have a parent" + + # Unnamed requirements are scanned again and the requirement won't be + # added as a dependency until after scanning. + if not install_req.name: + requirement_set.add_unnamed_requirement(install_req) + return [install_req], None + + try: + existing_req: Optional[InstallRequirement] = ( + requirement_set.get_requirement(install_req.name) + ) + except KeyError: + existing_req = None + + has_conflicting_requirement = ( + parent_req_name is None + and existing_req + and not existing_req.constraint + and existing_req.extras == install_req.extras + and existing_req.req + and install_req.req + and existing_req.req.specifier != install_req.req.specifier + ) + if has_conflicting_requirement: + raise InstallationError( + f"Double requirement given: {install_req} " + f"(already in {existing_req}, name={install_req.name!r})" + ) + + # When no existing requirement exists, add the requirement as a + # dependency and it will be scanned again after. + if not existing_req: + requirement_set.add_named_requirement(install_req) + # We'd want to rescan this requirement later + return [install_req], install_req + + # Assume there's no need to scan, and that we've already + # encountered this for scanning. + if install_req.constraint or not existing_req.constraint: + return [], existing_req + + does_not_satisfy_constraint = install_req.link and not ( + existing_req.link and install_req.link.path == existing_req.link.path + ) + if does_not_satisfy_constraint: + raise InstallationError( + f"Could not satisfy constraints for '{install_req.name}': " + "installation from path or url cannot be " + "constrained to a version" + ) + # If we're now installing a constraint, mark the existing + # object for real installation. + existing_req.constraint = False + # If we're now installing a user supplied requirement, + # mark the existing object as such. + if install_req.user_supplied: + existing_req.user_supplied = True + existing_req.extras = tuple( + sorted(set(existing_req.extras) | set(install_req.extras)) + ) + logger.debug( + "Setting %s extras to: %s", + existing_req, + existing_req.extras, + ) + # Return the existing requirement for addition to the parent and + # scanning again. + return [existing_req], existing_req + + def _is_upgrade_allowed(self, req: InstallRequirement) -> bool: + if self.upgrade_strategy == "to-satisfy-only": + return False + elif self.upgrade_strategy == "eager": + return True + else: + assert self.upgrade_strategy == "only-if-needed" + return req.user_supplied or req.constraint + + def _set_req_to_reinstall(self, req: InstallRequirement) -> None: + """ + Set a requirement to be installed. + """ + # Don't uninstall the conflict if doing a user install and the + # conflict is not a user install. + assert req.satisfied_by is not None + if not self.use_user_site or req.satisfied_by.in_usersite: + req.should_reinstall = True + req.satisfied_by = None + + def _check_skip_installed( + self, req_to_install: InstallRequirement + ) -> Optional[str]: + """Check if req_to_install should be skipped. + + This will check if the req is installed, and whether we should upgrade + or reinstall it, taking into account all the relevant user options. + + After calling this req_to_install will only have satisfied_by set to + None if the req_to_install is to be upgraded/reinstalled etc. Any + other value will be a dist recording the current thing installed that + satisfies the requirement. + + Note that for vcs urls and the like we can't assess skipping in this + routine - we simply identify that we need to pull the thing down, + then later on it is pulled down and introspected to assess upgrade/ + reinstalls etc. + + :return: A text reason for why it was skipped, or None. + """ + if self.ignore_installed: + return None + + req_to_install.check_if_exists(self.use_user_site) + if not req_to_install.satisfied_by: + return None + + if self.force_reinstall: + self._set_req_to_reinstall(req_to_install) + return None + + if not self._is_upgrade_allowed(req_to_install): + if self.upgrade_strategy == "only-if-needed": + return "already satisfied, skipping upgrade" + return "already satisfied" + + # Check for the possibility of an upgrade. For link-based + # requirements we have to pull the tree down and inspect to assess + # the version #, so it's handled way down. + if not req_to_install.link: + try: + self.finder.find_requirement(req_to_install, upgrade=True) + except BestVersionAlreadyInstalled: + # Then the best version is installed. + return "already up-to-date" + except DistributionNotFound: + # No distribution found, so we squash the error. It will + # be raised later when we re-try later to do the install. + # Why don't we just raise here? + pass + + self._set_req_to_reinstall(req_to_install) + return None + + def _find_requirement_link(self, req: InstallRequirement) -> Optional[Link]: + upgrade = self._is_upgrade_allowed(req) + best_candidate = self.finder.find_requirement(req, upgrade) + if not best_candidate: + return None + + # Log a warning per PEP 592 if necessary before returning. + link = best_candidate.link + if link.is_yanked: + reason = link.yanked_reason or "" + msg = ( + # Mark this as a unicode string to prevent + # "UnicodeEncodeError: 'ascii' codec can't encode character" + # in Python 2 when the reason contains non-ascii characters. + "The candidate selected for download or install is a " + f"yanked version: {best_candidate}\n" + f"Reason for being yanked: {reason}" + ) + logger.warning(msg) + + return link + + def _populate_link(self, req: InstallRequirement) -> None: + """Ensure that if a link can be found for this, that it is found. + + Note that req.link may still be None - if the requirement is already + installed and not needed to be upgraded based on the return value of + _is_upgrade_allowed(). + + If preparer.require_hashes is True, don't use the wheel cache, because + cached wheels, always built locally, have different hashes than the + files downloaded from the index server and thus throw false hash + mismatches. Furthermore, cached wheels at present have undeterministic + contents due to file modification times. + """ + if req.link is None: + req.link = self._find_requirement_link(req) + + if self.wheel_cache is None or self.preparer.require_hashes: + return + + assert req.link is not None, "_find_requirement_link unexpectedly returned None" + cache_entry = self.wheel_cache.get_cache_entry( + link=req.link, + package_name=req.name, + supported_tags=get_supported(), + ) + if cache_entry is not None: + logger.debug("Using cached wheel link: %s", cache_entry.link) + if req.link is req.original_link and cache_entry.persistent: + req.cached_wheel_source_link = req.link + if cache_entry.origin is not None: + req.download_info = cache_entry.origin + else: + # Legacy cache entry that does not have origin.json. + # download_info may miss the archive_info.hashes field. + req.download_info = direct_url_from_link( + req.link, link_is_in_wheel_cache=cache_entry.persistent + ) + req.link = cache_entry.link + + def _get_dist_for(self, req: InstallRequirement) -> BaseDistribution: + """Takes a InstallRequirement and returns a single AbstractDist \ + representing a prepared variant of the same. + """ + if req.editable: + return self.preparer.prepare_editable_requirement(req) + + # satisfied_by is only evaluated by calling _check_skip_installed, + # so it must be None here. + assert req.satisfied_by is None + skip_reason = self._check_skip_installed(req) + + if req.satisfied_by: + return self.preparer.prepare_installed_requirement(req, skip_reason) + + # We eagerly populate the link, since that's our "legacy" behavior. + self._populate_link(req) + dist = self.preparer.prepare_linked_requirement(req) + + # NOTE + # The following portion is for determining if a certain package is + # going to be re-installed/upgraded or not and reporting to the user. + # This should probably get cleaned up in a future refactor. + + # req.req is only avail after unpack for URL + # pkgs repeat check_if_exists to uninstall-on-upgrade + # (#14) + if not self.ignore_installed: + req.check_if_exists(self.use_user_site) + + if req.satisfied_by: + should_modify = ( + self.upgrade_strategy != "to-satisfy-only" + or self.force_reinstall + or self.ignore_installed + or req.link.scheme == "file" + ) + if should_modify: + self._set_req_to_reinstall(req) + else: + logger.info( + "Requirement already satisfied (use --upgrade to upgrade): %s", + req, + ) + return dist + + def _resolve_one( + self, + requirement_set: RequirementSet, + req_to_install: InstallRequirement, + ) -> List[InstallRequirement]: + """Prepare a single requirements file. + + :return: A list of additional InstallRequirements to also install. + """ + # Tell user what we are doing for this requirement: + # obtain (editable), skipping, processing (local url), collecting + # (remote url or package name) + if req_to_install.constraint or req_to_install.prepared: + return [] + + req_to_install.prepared = True + + # Parse and return dependencies + dist = self._get_dist_for(req_to_install) + # This will raise UnsupportedPythonVersion if the given Python + # version isn't compatible with the distribution's Requires-Python. + _check_dist_requires_python( + dist, + version_info=self._py_version_info, + ignore_requires_python=self.ignore_requires_python, + ) + + more_reqs: List[InstallRequirement] = [] + + def add_req(subreq: Requirement, extras_requested: Iterable[str]) -> None: + # This idiosyncratically converts the Requirement to str and let + # make_install_req then parse it again into Requirement. But this is + # the legacy resolver so I'm just not going to bother refactoring. + sub_install_req = self._make_install_req(str(subreq), req_to_install) + parent_req_name = req_to_install.name + to_scan_again, add_to_parent = self._add_requirement_to_set( + requirement_set, + sub_install_req, + parent_req_name=parent_req_name, + extras_requested=extras_requested, + ) + if parent_req_name and add_to_parent: + self._discovered_dependencies[parent_req_name].append(add_to_parent) + more_reqs.extend(to_scan_again) + + with indent_log(): + # We add req_to_install before its dependencies, so that we + # can refer to it when adding dependencies. + assert req_to_install.name is not None + if not requirement_set.has_requirement(req_to_install.name): + # 'unnamed' requirements will get added here + # 'unnamed' requirements can only come from being directly + # provided by the user. + assert req_to_install.user_supplied + self._add_requirement_to_set( + requirement_set, req_to_install, parent_req_name=None + ) + + if not self.ignore_dependencies: + if req_to_install.extras: + logger.debug( + "Installing extra requirements: %r", + ",".join(req_to_install.extras), + ) + missing_requested = sorted( + set(req_to_install.extras) - set(dist.iter_provided_extras()) + ) + for missing in missing_requested: + logger.warning( + "%s %s does not provide the extra '%s'", + dist.raw_name, + dist.version, + missing, + ) + + available_requested = sorted( + set(dist.iter_provided_extras()) & set(req_to_install.extras) + ) + for subreq in dist.iter_dependencies(available_requested): + add_req(subreq, extras_requested=available_requested) + + return more_reqs + + def get_installation_order( + self, req_set: RequirementSet + ) -> List[InstallRequirement]: + """Create the installation order. + + The installation order is topological - requirements are installed + before the requiring thing. We break cycles at an arbitrary point, + and make no other guarantees. + """ + # The current implementation, which we may change at any point + # installs the user specified things in the order given, except when + # dependencies must come earlier to achieve topological order. + order = [] + ordered_reqs: Set[InstallRequirement] = set() + + def schedule(req: InstallRequirement) -> None: + if req.satisfied_by or req in ordered_reqs: + return + if req.constraint: + return + ordered_reqs.add(req) + for dep in self._discovered_dependencies[req.name]: + schedule(dep) + order.append(req) + + for install_req in req_set.requirements.values(): + schedule(install_req) + return order diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/base.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/base.py new file mode 100644 index 0000000..0f31dc9 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/base.py @@ -0,0 +1,139 @@ +from dataclasses import dataclass +from typing import FrozenSet, Iterable, Optional, Tuple + +from pip._vendor.packaging.specifiers import SpecifierSet +from pip._vendor.packaging.utils import NormalizedName +from pip._vendor.packaging.version import Version + +from pip._internal.models.link import Link, links_equivalent +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.hashes import Hashes + +CandidateLookup = Tuple[Optional["Candidate"], Optional[InstallRequirement]] + + +def format_name(project: NormalizedName, extras: FrozenSet[NormalizedName]) -> str: + if not extras: + return project + extras_expr = ",".join(sorted(extras)) + return f"{project}[{extras_expr}]" + + +@dataclass(frozen=True) +class Constraint: + specifier: SpecifierSet + hashes: Hashes + links: FrozenSet[Link] + + @classmethod + def empty(cls) -> "Constraint": + return Constraint(SpecifierSet(), Hashes(), frozenset()) + + @classmethod + def from_ireq(cls, ireq: InstallRequirement) -> "Constraint": + links = frozenset([ireq.link]) if ireq.link else frozenset() + return Constraint(ireq.specifier, ireq.hashes(trust_internet=False), links) + + def __bool__(self) -> bool: + return bool(self.specifier) or bool(self.hashes) or bool(self.links) + + def __and__(self, other: InstallRequirement) -> "Constraint": + if not isinstance(other, InstallRequirement): + return NotImplemented + specifier = self.specifier & other.specifier + hashes = self.hashes & other.hashes(trust_internet=False) + links = self.links + if other.link: + links = links.union([other.link]) + return Constraint(specifier, hashes, links) + + def is_satisfied_by(self, candidate: "Candidate") -> bool: + # Reject if there are any mismatched URL constraints on this package. + if self.links and not all(_match_link(link, candidate) for link in self.links): + return False + # We can safely always allow prereleases here since PackageFinder + # already implements the prerelease logic, and would have filtered out + # prerelease candidates if the user does not expect them. + return self.specifier.contains(candidate.version, prereleases=True) + + +class Requirement: + @property + def project_name(self) -> NormalizedName: + """The "project name" of a requirement. + + This is different from ``name`` if this requirement contains extras, + in which case ``name`` would contain the ``[...]`` part, while this + refers to the name of the project. + """ + raise NotImplementedError("Subclass should override") + + @property + def name(self) -> str: + """The name identifying this requirement in the resolver. + + This is different from ``project_name`` if this requirement contains + extras, where ``project_name`` would not contain the ``[...]`` part. + """ + raise NotImplementedError("Subclass should override") + + def is_satisfied_by(self, candidate: "Candidate") -> bool: + return False + + def get_candidate_lookup(self) -> CandidateLookup: + raise NotImplementedError("Subclass should override") + + def format_for_error(self) -> str: + raise NotImplementedError("Subclass should override") + + +def _match_link(link: Link, candidate: "Candidate") -> bool: + if candidate.source_link: + return links_equivalent(link, candidate.source_link) + return False + + +class Candidate: + @property + def project_name(self) -> NormalizedName: + """The "project name" of the candidate. + + This is different from ``name`` if this candidate contains extras, + in which case ``name`` would contain the ``[...]`` part, while this + refers to the name of the project. + """ + raise NotImplementedError("Override in subclass") + + @property + def name(self) -> str: + """The name identifying this candidate in the resolver. + + This is different from ``project_name`` if this candidate contains + extras, where ``project_name`` would not contain the ``[...]`` part. + """ + raise NotImplementedError("Override in subclass") + + @property + def version(self) -> Version: + raise NotImplementedError("Override in subclass") + + @property + def is_installed(self) -> bool: + raise NotImplementedError("Override in subclass") + + @property + def is_editable(self) -> bool: + raise NotImplementedError("Override in subclass") + + @property + def source_link(self) -> Optional[Link]: + raise NotImplementedError("Override in subclass") + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + raise NotImplementedError("Override in subclass") + + def get_install_requirement(self) -> Optional[InstallRequirement]: + raise NotImplementedError("Override in subclass") + + def format_for_error(self) -> str: + raise NotImplementedError("Subclass should override") diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/candidates.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/candidates.py new file mode 100644 index 0000000..6617644 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/candidates.py @@ -0,0 +1,574 @@ +import logging +import sys +from typing import TYPE_CHECKING, Any, FrozenSet, Iterable, Optional, Tuple, Union, cast + +from pip._vendor.packaging.requirements import InvalidRequirement +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version + +from pip._internal.exceptions import ( + HashError, + InstallationSubprocessError, + InvalidInstalledPackage, + MetadataInconsistent, + MetadataInvalid, +) +from pip._internal.metadata import BaseDistribution +from pip._internal.models.link import Link, links_equivalent +from pip._internal.models.wheel import Wheel +from pip._internal.req.constructors import ( + install_req_from_editable, + install_req_from_line, +) +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.direct_url_helpers import direct_url_from_link +from pip._internal.utils.misc import normalize_version_info + +from .base import Candidate, Requirement, format_name + +if TYPE_CHECKING: + from .factory import Factory + +logger = logging.getLogger(__name__) + +BaseCandidate = Union[ + "AlreadyInstalledCandidate", + "EditableCandidate", + "LinkCandidate", +] + +# Avoid conflicting with the PyPI package "Python". +REQUIRES_PYTHON_IDENTIFIER = cast(NormalizedName, "") + + +def as_base_candidate(candidate: Candidate) -> Optional[BaseCandidate]: + """The runtime version of BaseCandidate.""" + base_candidate_classes = ( + AlreadyInstalledCandidate, + EditableCandidate, + LinkCandidate, + ) + if isinstance(candidate, base_candidate_classes): + return candidate + return None + + +def make_install_req_from_link( + link: Link, template: InstallRequirement +) -> InstallRequirement: + assert not template.editable, "template is editable" + if template.req: + line = str(template.req) + else: + line = link.url + ireq = install_req_from_line( + line, + user_supplied=template.user_supplied, + comes_from=template.comes_from, + use_pep517=template.use_pep517, + isolated=template.isolated, + constraint=template.constraint, + global_options=template.global_options, + hash_options=template.hash_options, + config_settings=template.config_settings, + ) + ireq.original_link = template.original_link + ireq.link = link + ireq.extras = template.extras + return ireq + + +def make_install_req_from_editable( + link: Link, template: InstallRequirement +) -> InstallRequirement: + assert template.editable, "template not editable" + ireq = install_req_from_editable( + link.url, + user_supplied=template.user_supplied, + comes_from=template.comes_from, + use_pep517=template.use_pep517, + isolated=template.isolated, + constraint=template.constraint, + permit_editable_wheels=template.permit_editable_wheels, + global_options=template.global_options, + hash_options=template.hash_options, + config_settings=template.config_settings, + ) + ireq.extras = template.extras + return ireq + + +def _make_install_req_from_dist( + dist: BaseDistribution, template: InstallRequirement +) -> InstallRequirement: + if template.req: + line = str(template.req) + elif template.link: + line = f"{dist.canonical_name} @ {template.link.url}" + else: + line = f"{dist.canonical_name}=={dist.version}" + ireq = install_req_from_line( + line, + user_supplied=template.user_supplied, + comes_from=template.comes_from, + use_pep517=template.use_pep517, + isolated=template.isolated, + constraint=template.constraint, + global_options=template.global_options, + hash_options=template.hash_options, + config_settings=template.config_settings, + ) + ireq.satisfied_by = dist + return ireq + + +class _InstallRequirementBackedCandidate(Candidate): + """A candidate backed by an ``InstallRequirement``. + + This represents a package request with the target not being already + in the environment, and needs to be fetched and installed. The backing + ``InstallRequirement`` is responsible for most of the leg work; this + class exposes appropriate information to the resolver. + + :param link: The link passed to the ``InstallRequirement``. The backing + ``InstallRequirement`` will use this link to fetch the distribution. + :param source_link: The link this candidate "originates" from. This is + different from ``link`` when the link is found in the wheel cache. + ``link`` would point to the wheel cache, while this points to the + found remote link (e.g. from pypi.org). + """ + + dist: BaseDistribution + is_installed = False + + def __init__( + self, + link: Link, + source_link: Link, + ireq: InstallRequirement, + factory: "Factory", + name: Optional[NormalizedName] = None, + version: Optional[Version] = None, + ) -> None: + self._link = link + self._source_link = source_link + self._factory = factory + self._ireq = ireq + self._name = name + self._version = version + self.dist = self._prepare() + self._hash: Optional[int] = None + + def __str__(self) -> str: + return f"{self.name} {self.version}" + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({str(self._link)!r})" + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + + self._hash = hash((self.__class__, self._link)) + return self._hash + + def __eq__(self, other: Any) -> bool: + if isinstance(other, self.__class__): + return links_equivalent(self._link, other._link) + return False + + @property + def source_link(self) -> Optional[Link]: + return self._source_link + + @property + def project_name(self) -> NormalizedName: + """The normalised name of the project the candidate refers to""" + if self._name is None: + self._name = self.dist.canonical_name + return self._name + + @property + def name(self) -> str: + return self.project_name + + @property + def version(self) -> Version: + if self._version is None: + self._version = self.dist.version + return self._version + + def format_for_error(self) -> str: + return ( + f"{self.name} {self.version} " + f"(from {self._link.file_path if self._link.is_file else self._link})" + ) + + def _prepare_distribution(self) -> BaseDistribution: + raise NotImplementedError("Override in subclass") + + def _check_metadata_consistency(self, dist: BaseDistribution) -> None: + """Check for consistency of project name and version of dist.""" + if self._name is not None and self._name != dist.canonical_name: + raise MetadataInconsistent( + self._ireq, + "name", + self._name, + dist.canonical_name, + ) + if self._version is not None and self._version != dist.version: + raise MetadataInconsistent( + self._ireq, + "version", + str(self._version), + str(dist.version), + ) + # check dependencies are valid + # TODO performance: this means we iterate the dependencies at least twice, + # we may want to cache parsed Requires-Dist + try: + list(dist.iter_dependencies(list(dist.iter_provided_extras()))) + except InvalidRequirement as e: + raise MetadataInvalid(self._ireq, str(e)) + + def _prepare(self) -> BaseDistribution: + try: + dist = self._prepare_distribution() + except HashError as e: + # Provide HashError the underlying ireq that caused it. This + # provides context for the resulting error message to show the + # offending line to the user. + e.req = self._ireq + raise + except InstallationSubprocessError as exc: + # The output has been presented already, so don't duplicate it. + exc.context = "See above for output." + raise + + self._check_metadata_consistency(dist) + return dist + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + requires = self.dist.iter_dependencies() if with_requires else () + for r in requires: + yield from self._factory.make_requirements_from_spec(str(r), self._ireq) + yield self._factory.make_requires_python_requirement(self.dist.requires_python) + + def get_install_requirement(self) -> Optional[InstallRequirement]: + return self._ireq + + +class LinkCandidate(_InstallRequirementBackedCandidate): + is_editable = False + + def __init__( + self, + link: Link, + template: InstallRequirement, + factory: "Factory", + name: Optional[NormalizedName] = None, + version: Optional[Version] = None, + ) -> None: + source_link = link + cache_entry = factory.get_wheel_cache_entry(source_link, name) + if cache_entry is not None: + logger.debug("Using cached wheel link: %s", cache_entry.link) + link = cache_entry.link + ireq = make_install_req_from_link(link, template) + assert ireq.link == link + if ireq.link.is_wheel and not ireq.link.is_file: + wheel = Wheel(ireq.link.filename) + wheel_name = canonicalize_name(wheel.name) + assert name == wheel_name, f"{name!r} != {wheel_name!r} for wheel" + # Version may not be present for PEP 508 direct URLs + if version is not None: + wheel_version = Version(wheel.version) + assert ( + version == wheel_version + ), f"{version!r} != {wheel_version!r} for wheel {name}" + + if cache_entry is not None: + assert ireq.link.is_wheel + assert ireq.link.is_file + if cache_entry.persistent and template.link is template.original_link: + ireq.cached_wheel_source_link = source_link + if cache_entry.origin is not None: + ireq.download_info = cache_entry.origin + else: + # Legacy cache entry that does not have origin.json. + # download_info may miss the archive_info.hashes field. + ireq.download_info = direct_url_from_link( + source_link, link_is_in_wheel_cache=cache_entry.persistent + ) + + super().__init__( + link=link, + source_link=source_link, + ireq=ireq, + factory=factory, + name=name, + version=version, + ) + + def _prepare_distribution(self) -> BaseDistribution: + preparer = self._factory.preparer + return preparer.prepare_linked_requirement(self._ireq, parallel_builds=True) + + +class EditableCandidate(_InstallRequirementBackedCandidate): + is_editable = True + + def __init__( + self, + link: Link, + template: InstallRequirement, + factory: "Factory", + name: Optional[NormalizedName] = None, + version: Optional[Version] = None, + ) -> None: + super().__init__( + link=link, + source_link=link, + ireq=make_install_req_from_editable(link, template), + factory=factory, + name=name, + version=version, + ) + + def _prepare_distribution(self) -> BaseDistribution: + return self._factory.preparer.prepare_editable_requirement(self._ireq) + + +class AlreadyInstalledCandidate(Candidate): + is_installed = True + source_link = None + + def __init__( + self, + dist: BaseDistribution, + template: InstallRequirement, + factory: "Factory", + ) -> None: + self.dist = dist + self._ireq = _make_install_req_from_dist(dist, template) + self._factory = factory + self._version = None + + # This is just logging some messages, so we can do it eagerly. + # The returned dist would be exactly the same as self.dist because we + # set satisfied_by in _make_install_req_from_dist. + # TODO: Supply reason based on force_reinstall and upgrade_strategy. + skip_reason = "already satisfied" + factory.preparer.prepare_installed_requirement(self._ireq, skip_reason) + + def __str__(self) -> str: + return str(self.dist) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.dist!r})" + + def __eq__(self, other: object) -> bool: + if not isinstance(other, AlreadyInstalledCandidate): + return NotImplemented + return self.name == other.name and self.version == other.version + + def __hash__(self) -> int: + return hash((self.name, self.version)) + + @property + def project_name(self) -> NormalizedName: + return self.dist.canonical_name + + @property + def name(self) -> str: + return self.project_name + + @property + def version(self) -> Version: + if self._version is None: + self._version = self.dist.version + return self._version + + @property + def is_editable(self) -> bool: + return self.dist.editable + + def format_for_error(self) -> str: + return f"{self.name} {self.version} (Installed)" + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + if not with_requires: + return + + try: + for r in self.dist.iter_dependencies(): + yield from self._factory.make_requirements_from_spec(str(r), self._ireq) + except InvalidRequirement as exc: + raise InvalidInstalledPackage(dist=self.dist, invalid_exc=exc) from None + + def get_install_requirement(self) -> Optional[InstallRequirement]: + return None + + +class ExtrasCandidate(Candidate): + """A candidate that has 'extras', indicating additional dependencies. + + Requirements can be for a project with dependencies, something like + foo[extra]. The extras don't affect the project/version being installed + directly, but indicate that we need additional dependencies. We model that + by having an artificial ExtrasCandidate that wraps the "base" candidate. + + The ExtrasCandidate differs from the base in the following ways: + + 1. It has a unique name, of the form foo[extra]. This causes the resolver + to treat it as a separate node in the dependency graph. + 2. When we're getting the candidate's dependencies, + a) We specify that we want the extra dependencies as well. + b) We add a dependency on the base candidate. + See below for why this is needed. + 3. We return None for the underlying InstallRequirement, as the base + candidate will provide it, and we don't want to end up with duplicates. + + The dependency on the base candidate is needed so that the resolver can't + decide that it should recommend foo[extra1] version 1.0 and foo[extra2] + version 2.0. Having those candidates depend on foo=1.0 and foo=2.0 + respectively forces the resolver to recognise that this is a conflict. + """ + + def __init__( + self, + base: BaseCandidate, + extras: FrozenSet[str], + *, + comes_from: Optional[InstallRequirement] = None, + ) -> None: + """ + :param comes_from: the InstallRequirement that led to this candidate if it + differs from the base's InstallRequirement. This will often be the + case in the sense that this candidate's requirement has the extras + while the base's does not. Unlike the InstallRequirement backed + candidates, this requirement is used solely for reporting purposes, + it does not do any leg work. + """ + self.base = base + self.extras = frozenset(canonicalize_name(e) for e in extras) + self._comes_from = comes_from if comes_from is not None else self.base._ireq + + def __str__(self) -> str: + name, rest = str(self.base).split(" ", 1) + return "{}[{}] {}".format(name, ",".join(self.extras), rest) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}(base={self.base!r}, extras={self.extras!r})" + + def __hash__(self) -> int: + return hash((self.base, self.extras)) + + def __eq__(self, other: Any) -> bool: + if isinstance(other, self.__class__): + return self.base == other.base and self.extras == other.extras + return False + + @property + def project_name(self) -> NormalizedName: + return self.base.project_name + + @property + def name(self) -> str: + """The normalised name of the project the candidate refers to""" + return format_name(self.base.project_name, self.extras) + + @property + def version(self) -> Version: + return self.base.version + + def format_for_error(self) -> str: + return "{} [{}]".format( + self.base.format_for_error(), ", ".join(sorted(self.extras)) + ) + + @property + def is_installed(self) -> bool: + return self.base.is_installed + + @property + def is_editable(self) -> bool: + return self.base.is_editable + + @property + def source_link(self) -> Optional[Link]: + return self.base.source_link + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + factory = self.base._factory + + # Add a dependency on the exact base + # (See note 2b in the class docstring) + yield factory.make_requirement_from_candidate(self.base) + if not with_requires: + return + + # The user may have specified extras that the candidate doesn't + # support. We ignore any unsupported extras here. + valid_extras = self.extras.intersection(self.base.dist.iter_provided_extras()) + invalid_extras = self.extras.difference(self.base.dist.iter_provided_extras()) + for extra in sorted(invalid_extras): + logger.warning( + "%s %s does not provide the extra '%s'", + self.base.name, + self.version, + extra, + ) + + for r in self.base.dist.iter_dependencies(valid_extras): + yield from factory.make_requirements_from_spec( + str(r), + self._comes_from, + valid_extras, + ) + + def get_install_requirement(self) -> Optional[InstallRequirement]: + # We don't return anything here, because we always + # depend on the base candidate, and we'll get the + # install requirement from that. + return None + + +class RequiresPythonCandidate(Candidate): + is_installed = False + source_link = None + + def __init__(self, py_version_info: Optional[Tuple[int, ...]]) -> None: + if py_version_info is not None: + version_info = normalize_version_info(py_version_info) + else: + version_info = sys.version_info[:3] + self._version = Version(".".join(str(c) for c in version_info)) + + # We don't need to implement __eq__() and __ne__() since there is always + # only one RequiresPythonCandidate in a resolution, i.e. the host Python. + # The built-in object.__eq__() and object.__ne__() do exactly what we want. + + def __str__(self) -> str: + return f"Python {self._version}" + + @property + def project_name(self) -> NormalizedName: + return REQUIRES_PYTHON_IDENTIFIER + + @property + def name(self) -> str: + return REQUIRES_PYTHON_IDENTIFIER + + @property + def version(self) -> Version: + return self._version + + def format_for_error(self) -> str: + return f"Python {self.version}" + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + return () + + def get_install_requirement(self) -> Optional[InstallRequirement]: + return None diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/factory.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/factory.py new file mode 100644 index 0000000..6c273eb --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/factory.py @@ -0,0 +1,823 @@ +import contextlib +import functools +import logging +from typing import ( + TYPE_CHECKING, + Callable, + Dict, + FrozenSet, + Iterable, + Iterator, + List, + Mapping, + NamedTuple, + Optional, + Protocol, + Sequence, + Set, + Tuple, + TypeVar, + cast, +) + +from pip._vendor.packaging.requirements import InvalidRequirement +from pip._vendor.packaging.specifiers import SpecifierSet +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import InvalidVersion, Version +from pip._vendor.resolvelib import ResolutionImpossible + +from pip._internal.cache import CacheEntry, WheelCache +from pip._internal.exceptions import ( + DistributionNotFound, + InstallationError, + InvalidInstalledPackage, + MetadataInconsistent, + MetadataInvalid, + UnsupportedPythonVersion, + UnsupportedWheel, +) +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import BaseDistribution, get_default_environment +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.constructors import ( + install_req_drop_extras, + install_req_from_link_and_ireq, +) +from pip._internal.req.req_install import ( + InstallRequirement, + check_invalid_constraint_type, +) +from pip._internal.resolution.base import InstallRequirementProvider +from pip._internal.utils.compatibility_tags import get_supported +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.virtualenv import running_under_virtualenv + +from .base import Candidate, Constraint, Requirement +from .candidates import ( + AlreadyInstalledCandidate, + BaseCandidate, + EditableCandidate, + ExtrasCandidate, + LinkCandidate, + RequiresPythonCandidate, + as_base_candidate, +) +from .found_candidates import FoundCandidates, IndexCandidateInfo +from .requirements import ( + ExplicitRequirement, + RequiresPythonRequirement, + SpecifierRequirement, + SpecifierWithoutExtrasRequirement, + UnsatisfiableRequirement, +) + +if TYPE_CHECKING: + + class ConflictCause(Protocol): + requirement: RequiresPythonRequirement + parent: Candidate + + +logger = logging.getLogger(__name__) + +C = TypeVar("C") +Cache = Dict[Link, C] + + +class CollectedRootRequirements(NamedTuple): + requirements: List[Requirement] + constraints: Dict[str, Constraint] + user_requested: Dict[str, int] + + +class Factory: + def __init__( + self, + finder: PackageFinder, + preparer: RequirementPreparer, + make_install_req: InstallRequirementProvider, + wheel_cache: Optional[WheelCache], + use_user_site: bool, + force_reinstall: bool, + ignore_installed: bool, + ignore_requires_python: bool, + py_version_info: Optional[Tuple[int, ...]] = None, + ) -> None: + self._finder = finder + self.preparer = preparer + self._wheel_cache = wheel_cache + self._python_candidate = RequiresPythonCandidate(py_version_info) + self._make_install_req_from_spec = make_install_req + self._use_user_site = use_user_site + self._force_reinstall = force_reinstall + self._ignore_requires_python = ignore_requires_python + + self._build_failures: Cache[InstallationError] = {} + self._link_candidate_cache: Cache[LinkCandidate] = {} + self._editable_candidate_cache: Cache[EditableCandidate] = {} + self._installed_candidate_cache: Dict[str, AlreadyInstalledCandidate] = {} + self._extras_candidate_cache: Dict[ + Tuple[int, FrozenSet[NormalizedName]], ExtrasCandidate + ] = {} + self._supported_tags_cache = get_supported() + + if not ignore_installed: + env = get_default_environment() + self._installed_dists = { + dist.canonical_name: dist + for dist in env.iter_installed_distributions(local_only=False) + } + else: + self._installed_dists = {} + + @property + def force_reinstall(self) -> bool: + return self._force_reinstall + + def _fail_if_link_is_unsupported_wheel(self, link: Link) -> None: + if not link.is_wheel: + return + wheel = Wheel(link.filename) + if wheel.supported(self._finder.target_python.get_unsorted_tags()): + return + msg = f"{link.filename} is not a supported wheel on this platform." + raise UnsupportedWheel(msg) + + def _make_extras_candidate( + self, + base: BaseCandidate, + extras: FrozenSet[str], + *, + comes_from: Optional[InstallRequirement] = None, + ) -> ExtrasCandidate: + cache_key = (id(base), frozenset(canonicalize_name(e) for e in extras)) + try: + candidate = self._extras_candidate_cache[cache_key] + except KeyError: + candidate = ExtrasCandidate(base, extras, comes_from=comes_from) + self._extras_candidate_cache[cache_key] = candidate + return candidate + + def _make_candidate_from_dist( + self, + dist: BaseDistribution, + extras: FrozenSet[str], + template: InstallRequirement, + ) -> Candidate: + try: + base = self._installed_candidate_cache[dist.canonical_name] + except KeyError: + base = AlreadyInstalledCandidate(dist, template, factory=self) + self._installed_candidate_cache[dist.canonical_name] = base + if not extras: + return base + return self._make_extras_candidate(base, extras, comes_from=template) + + def _make_candidate_from_link( + self, + link: Link, + extras: FrozenSet[str], + template: InstallRequirement, + name: Optional[NormalizedName], + version: Optional[Version], + ) -> Optional[Candidate]: + base: Optional[BaseCandidate] = self._make_base_candidate_from_link( + link, template, name, version + ) + if not extras or base is None: + return base + return self._make_extras_candidate(base, extras, comes_from=template) + + def _make_base_candidate_from_link( + self, + link: Link, + template: InstallRequirement, + name: Optional[NormalizedName], + version: Optional[Version], + ) -> Optional[BaseCandidate]: + # TODO: Check already installed candidate, and use it if the link and + # editable flag match. + + if link in self._build_failures: + # We already tried this candidate before, and it does not build. + # Don't bother trying again. + return None + + if template.editable: + if link not in self._editable_candidate_cache: + try: + self._editable_candidate_cache[link] = EditableCandidate( + link, + template, + factory=self, + name=name, + version=version, + ) + except (MetadataInconsistent, MetadataInvalid) as e: + logger.info( + "Discarding [blue underline]%s[/]: [yellow]%s[reset]", + link, + e, + extra={"markup": True}, + ) + self._build_failures[link] = e + return None + + return self._editable_candidate_cache[link] + else: + if link not in self._link_candidate_cache: + try: + self._link_candidate_cache[link] = LinkCandidate( + link, + template, + factory=self, + name=name, + version=version, + ) + except MetadataInconsistent as e: + logger.info( + "Discarding [blue underline]%s[/]: [yellow]%s[reset]", + link, + e, + extra={"markup": True}, + ) + self._build_failures[link] = e + return None + return self._link_candidate_cache[link] + + def _iter_found_candidates( + self, + ireqs: Sequence[InstallRequirement], + specifier: SpecifierSet, + hashes: Hashes, + prefers_installed: bool, + incompatible_ids: Set[int], + ) -> Iterable[Candidate]: + if not ireqs: + return () + + # The InstallRequirement implementation requires us to give it a + # "template". Here we just choose the first requirement to represent + # all of them. + # Hopefully the Project model can correct this mismatch in the future. + template = ireqs[0] + assert template.req, "Candidates found on index must be PEP 508" + name = canonicalize_name(template.req.name) + + extras: FrozenSet[str] = frozenset() + for ireq in ireqs: + assert ireq.req, "Candidates found on index must be PEP 508" + specifier &= ireq.req.specifier + hashes &= ireq.hashes(trust_internet=False) + extras |= frozenset(ireq.extras) + + def _get_installed_candidate() -> Optional[Candidate]: + """Get the candidate for the currently-installed version.""" + # If --force-reinstall is set, we want the version from the index + # instead, so we "pretend" there is nothing installed. + if self._force_reinstall: + return None + try: + installed_dist = self._installed_dists[name] + except KeyError: + return None + + try: + # Don't use the installed distribution if its version + # does not fit the current dependency graph. + if not specifier.contains(installed_dist.version, prereleases=True): + return None + except InvalidVersion as e: + raise InvalidInstalledPackage(dist=installed_dist, invalid_exc=e) + + candidate = self._make_candidate_from_dist( + dist=installed_dist, + extras=extras, + template=template, + ) + # The candidate is a known incompatibility. Don't use it. + if id(candidate) in incompatible_ids: + return None + return candidate + + def iter_index_candidate_infos() -> Iterator[IndexCandidateInfo]: + result = self._finder.find_best_candidate( + project_name=name, + specifier=specifier, + hashes=hashes, + ) + icans = result.applicable_candidates + + # PEP 592: Yanked releases are ignored unless the specifier + # explicitly pins a version (via '==' or '===') that can be + # solely satisfied by a yanked release. + all_yanked = all(ican.link.is_yanked for ican in icans) + + def is_pinned(specifier: SpecifierSet) -> bool: + for sp in specifier: + if sp.operator == "===": + return True + if sp.operator != "==": + continue + if sp.version.endswith(".*"): + continue + return True + return False + + pinned = is_pinned(specifier) + + # PackageFinder returns earlier versions first, so we reverse. + for ican in reversed(icans): + if not (all_yanked and pinned) and ican.link.is_yanked: + continue + func = functools.partial( + self._make_candidate_from_link, + link=ican.link, + extras=extras, + template=template, + name=name, + version=ican.version, + ) + yield ican.version, func + + return FoundCandidates( + iter_index_candidate_infos, + _get_installed_candidate(), + prefers_installed, + incompatible_ids, + ) + + def _iter_explicit_candidates_from_base( + self, + base_requirements: Iterable[Requirement], + extras: FrozenSet[str], + ) -> Iterator[Candidate]: + """Produce explicit candidates from the base given an extra-ed package. + + :param base_requirements: Requirements known to the resolver. The + requirements are guaranteed to not have extras. + :param extras: The extras to inject into the explicit requirements' + candidates. + """ + for req in base_requirements: + lookup_cand, _ = req.get_candidate_lookup() + if lookup_cand is None: # Not explicit. + continue + # We've stripped extras from the identifier, and should always + # get a BaseCandidate here, unless there's a bug elsewhere. + base_cand = as_base_candidate(lookup_cand) + assert base_cand is not None, "no extras here" + yield self._make_extras_candidate(base_cand, extras) + + def _iter_candidates_from_constraints( + self, + identifier: str, + constraint: Constraint, + template: InstallRequirement, + ) -> Iterator[Candidate]: + """Produce explicit candidates from constraints. + + This creates "fake" InstallRequirement objects that are basically clones + of what "should" be the template, but with original_link set to link. + """ + for link in constraint.links: + self._fail_if_link_is_unsupported_wheel(link) + candidate = self._make_base_candidate_from_link( + link, + template=install_req_from_link_and_ireq(link, template), + name=canonicalize_name(identifier), + version=None, + ) + if candidate: + yield candidate + + def find_candidates( + self, + identifier: str, + requirements: Mapping[str, Iterable[Requirement]], + incompatibilities: Mapping[str, Iterator[Candidate]], + constraint: Constraint, + prefers_installed: bool, + is_satisfied_by: Callable[[Requirement, Candidate], bool], + ) -> Iterable[Candidate]: + # Collect basic lookup information from the requirements. + explicit_candidates: Set[Candidate] = set() + ireqs: List[InstallRequirement] = [] + for req in requirements[identifier]: + cand, ireq = req.get_candidate_lookup() + if cand is not None: + explicit_candidates.add(cand) + if ireq is not None: + ireqs.append(ireq) + + # If the current identifier contains extras, add requires and explicit + # candidates from entries from extra-less identifier. + with contextlib.suppress(InvalidRequirement): + parsed_requirement = get_requirement(identifier) + if parsed_requirement.name != identifier: + explicit_candidates.update( + self._iter_explicit_candidates_from_base( + requirements.get(parsed_requirement.name, ()), + frozenset(parsed_requirement.extras), + ), + ) + for req in requirements.get(parsed_requirement.name, []): + _, ireq = req.get_candidate_lookup() + if ireq is not None: + ireqs.append(ireq) + + # Add explicit candidates from constraints. We only do this if there are + # known ireqs, which represent requirements not already explicit. If + # there are no ireqs, we're constraining already-explicit requirements, + # which is handled later when we return the explicit candidates. + if ireqs: + try: + explicit_candidates.update( + self._iter_candidates_from_constraints( + identifier, + constraint, + template=ireqs[0], + ), + ) + except UnsupportedWheel: + # If we're constrained to install a wheel incompatible with the + # target architecture, no candidates will ever be valid. + return () + + # Since we cache all the candidates, incompatibility identification + # can be made quicker by comparing only the id() values. + incompat_ids = {id(c) for c in incompatibilities.get(identifier, ())} + + # If none of the requirements want an explicit candidate, we can ask + # the finder for candidates. + if not explicit_candidates: + return self._iter_found_candidates( + ireqs, + constraint.specifier, + constraint.hashes, + prefers_installed, + incompat_ids, + ) + + return ( + c + for c in explicit_candidates + if id(c) not in incompat_ids + and constraint.is_satisfied_by(c) + and all(is_satisfied_by(req, c) for req in requirements[identifier]) + ) + + def _make_requirements_from_install_req( + self, ireq: InstallRequirement, requested_extras: Iterable[str] + ) -> Iterator[Requirement]: + """ + Returns requirement objects associated with the given InstallRequirement. In + most cases this will be a single object but the following special cases exist: + - the InstallRequirement has markers that do not apply -> result is empty + - the InstallRequirement has both a constraint (or link) and extras + -> result is split in two requirement objects: one with the constraint + (or link) and one with the extra. This allows centralized constraint + handling for the base, resulting in fewer candidate rejections. + """ + if not ireq.match_markers(requested_extras): + logger.info( + "Ignoring %s: markers '%s' don't match your environment", + ireq.name, + ireq.markers, + ) + elif not ireq.link: + if ireq.extras and ireq.req is not None and ireq.req.specifier: + yield SpecifierWithoutExtrasRequirement(ireq) + yield SpecifierRequirement(ireq) + else: + self._fail_if_link_is_unsupported_wheel(ireq.link) + # Always make the link candidate for the base requirement to make it + # available to `find_candidates` for explicit candidate lookup for any + # set of extras. + # The extras are required separately via a second requirement. + cand = self._make_base_candidate_from_link( + ireq.link, + template=install_req_drop_extras(ireq) if ireq.extras else ireq, + name=canonicalize_name(ireq.name) if ireq.name else None, + version=None, + ) + if cand is None: + # There's no way we can satisfy a URL requirement if the underlying + # candidate fails to build. An unnamed URL must be user-supplied, so + # we fail eagerly. If the URL is named, an unsatisfiable requirement + # can make the resolver do the right thing, either backtrack (and + # maybe find some other requirement that's buildable) or raise a + # ResolutionImpossible eventually. + if not ireq.name: + raise self._build_failures[ireq.link] + yield UnsatisfiableRequirement(canonicalize_name(ireq.name)) + else: + # require the base from the link + yield self.make_requirement_from_candidate(cand) + if ireq.extras: + # require the extras on top of the base candidate + yield self.make_requirement_from_candidate( + self._make_extras_candidate(cand, frozenset(ireq.extras)) + ) + + def collect_root_requirements( + self, root_ireqs: List[InstallRequirement] + ) -> CollectedRootRequirements: + collected = CollectedRootRequirements([], {}, {}) + for i, ireq in enumerate(root_ireqs): + if ireq.constraint: + # Ensure we only accept valid constraints + problem = check_invalid_constraint_type(ireq) + if problem: + raise InstallationError(problem) + if not ireq.match_markers(): + continue + assert ireq.name, "Constraint must be named" + name = canonicalize_name(ireq.name) + if name in collected.constraints: + collected.constraints[name] &= ireq + else: + collected.constraints[name] = Constraint.from_ireq(ireq) + else: + reqs = list( + self._make_requirements_from_install_req( + ireq, + requested_extras=(), + ) + ) + if not reqs: + continue + template = reqs[0] + if ireq.user_supplied and template.name not in collected.user_requested: + collected.user_requested[template.name] = i + collected.requirements.extend(reqs) + # Put requirements with extras at the end of the root requires. This does not + # affect resolvelib's picking preference but it does affect its initial criteria + # population: by putting extras at the end we enable the candidate finder to + # present resolvelib with a smaller set of candidates to resolvelib, already + # taking into account any non-transient constraints on the associated base. This + # means resolvelib will have fewer candidates to visit and reject. + # Python's list sort is stable, meaning relative order is kept for objects with + # the same key. + collected.requirements.sort(key=lambda r: r.name != r.project_name) + return collected + + def make_requirement_from_candidate( + self, candidate: Candidate + ) -> ExplicitRequirement: + return ExplicitRequirement(candidate) + + def make_requirements_from_spec( + self, + specifier: str, + comes_from: Optional[InstallRequirement], + requested_extras: Iterable[str] = (), + ) -> Iterator[Requirement]: + """ + Returns requirement objects associated with the given specifier. In most cases + this will be a single object but the following special cases exist: + - the specifier has markers that do not apply -> result is empty + - the specifier has both a constraint and extras -> result is split + in two requirement objects: one with the constraint and one with the + extra. This allows centralized constraint handling for the base, + resulting in fewer candidate rejections. + """ + ireq = self._make_install_req_from_spec(specifier, comes_from) + return self._make_requirements_from_install_req(ireq, requested_extras) + + def make_requires_python_requirement( + self, + specifier: SpecifierSet, + ) -> Optional[Requirement]: + if self._ignore_requires_python: + return None + # Don't bother creating a dependency for an empty Requires-Python. + if not str(specifier): + return None + return RequiresPythonRequirement(specifier, self._python_candidate) + + def get_wheel_cache_entry( + self, link: Link, name: Optional[str] + ) -> Optional[CacheEntry]: + """Look up the link in the wheel cache. + + If ``preparer.require_hashes`` is True, don't use the wheel cache, + because cached wheels, always built locally, have different hashes + than the files downloaded from the index server and thus throw false + hash mismatches. Furthermore, cached wheels at present have + nondeterministic contents due to file modification times. + """ + if self._wheel_cache is None: + return None + return self._wheel_cache.get_cache_entry( + link=link, + package_name=name, + supported_tags=self._supported_tags_cache, + ) + + def get_dist_to_uninstall(self, candidate: Candidate) -> Optional[BaseDistribution]: + # TODO: Are there more cases this needs to return True? Editable? + dist = self._installed_dists.get(candidate.project_name) + if dist is None: # Not installed, no uninstallation required. + return None + + # We're installing into global site. The current installation must + # be uninstalled, no matter it's in global or user site, because the + # user site installation has precedence over global. + if not self._use_user_site: + return dist + + # We're installing into user site. Remove the user site installation. + if dist.in_usersite: + return dist + + # We're installing into user site, but the installed incompatible + # package is in global site. We can't uninstall that, and would let + # the new user installation to "shadow" it. But shadowing won't work + # in virtual environments, so we error out. + if running_under_virtualenv() and dist.in_site_packages: + message = ( + f"Will not install to the user site because it will lack " + f"sys.path precedence to {dist.raw_name} in {dist.location}" + ) + raise InstallationError(message) + return None + + def _report_requires_python_error( + self, causes: Sequence["ConflictCause"] + ) -> UnsupportedPythonVersion: + assert causes, "Requires-Python error reported with no cause" + + version = self._python_candidate.version + + if len(causes) == 1: + specifier = str(causes[0].requirement.specifier) + message = ( + f"Package {causes[0].parent.name!r} requires a different " + f"Python: {version} not in {specifier!r}" + ) + return UnsupportedPythonVersion(message) + + message = f"Packages require a different Python. {version} not in:" + for cause in causes: + package = cause.parent.format_for_error() + specifier = str(cause.requirement.specifier) + message += f"\n{specifier!r} (required by {package})" + return UnsupportedPythonVersion(message) + + def _report_single_requirement_conflict( + self, req: Requirement, parent: Optional[Candidate] + ) -> DistributionNotFound: + if parent is None: + req_disp = str(req) + else: + req_disp = f"{req} (from {parent.name})" + + cands = self._finder.find_all_candidates(req.project_name) + skipped_by_requires_python = self._finder.requires_python_skipped_reasons() + + versions_set: Set[Version] = set() + yanked_versions_set: Set[Version] = set() + for c in cands: + is_yanked = c.link.is_yanked if c.link else False + if is_yanked: + yanked_versions_set.add(c.version) + else: + versions_set.add(c.version) + + versions = [str(v) for v in sorted(versions_set)] + yanked_versions = [str(v) for v in sorted(yanked_versions_set)] + + if yanked_versions: + # Saying "version X is yanked" isn't entirely accurate. + # https://github.com/pypa/pip/issues/11745#issuecomment-1402805842 + logger.critical( + "Ignored the following yanked versions: %s", + ", ".join(yanked_versions) or "none", + ) + if skipped_by_requires_python: + logger.critical( + "Ignored the following versions that require a different python " + "version: %s", + "; ".join(skipped_by_requires_python) or "none", + ) + logger.critical( + "Could not find a version that satisfies the requirement %s " + "(from versions: %s)", + req_disp, + ", ".join(versions) or "none", + ) + if str(req) == "requirements.txt": + logger.info( + "HINT: You are attempting to install a package literally " + 'named "requirements.txt" (which cannot exist). Consider ' + "using the '-r' flag to install the packages listed in " + "requirements.txt" + ) + + return DistributionNotFound(f"No matching distribution found for {req}") + + def get_installation_error( + self, + e: "ResolutionImpossible[Requirement, Candidate]", + constraints: Dict[str, Constraint], + ) -> InstallationError: + assert e.causes, "Installation error reported with no cause" + + # If one of the things we can't solve is "we need Python X.Y", + # that is what we report. + requires_python_causes = [ + cause + for cause in e.causes + if isinstance(cause.requirement, RequiresPythonRequirement) + and not cause.requirement.is_satisfied_by(self._python_candidate) + ] + if requires_python_causes: + # The comprehension above makes sure all Requirement instances are + # RequiresPythonRequirement, so let's cast for convenience. + return self._report_requires_python_error( + cast("Sequence[ConflictCause]", requires_python_causes), + ) + + # Otherwise, we have a set of causes which can't all be satisfied + # at once. + + # The simplest case is when we have *one* cause that can't be + # satisfied. We just report that case. + if len(e.causes) == 1: + req, parent = e.causes[0] + if req.name not in constraints: + return self._report_single_requirement_conflict(req, parent) + + # OK, we now have a list of requirements that can't all be + # satisfied at once. + + # A couple of formatting helpers + def text_join(parts: List[str]) -> str: + if len(parts) == 1: + return parts[0] + + return ", ".join(parts[:-1]) + " and " + parts[-1] + + def describe_trigger(parent: Candidate) -> str: + ireq = parent.get_install_requirement() + if not ireq or not ireq.comes_from: + return f"{parent.name}=={parent.version}" + if isinstance(ireq.comes_from, InstallRequirement): + return str(ireq.comes_from.name) + return str(ireq.comes_from) + + triggers = set() + for req, parent in e.causes: + if parent is None: + # This is a root requirement, so we can report it directly + trigger = req.format_for_error() + else: + trigger = describe_trigger(parent) + triggers.add(trigger) + + if triggers: + info = text_join(sorted(triggers)) + else: + info = "the requested packages" + + msg = ( + f"Cannot install {info} because these package versions " + "have conflicting dependencies." + ) + logger.critical(msg) + msg = "\nThe conflict is caused by:" + + relevant_constraints = set() + for req, parent in e.causes: + if req.name in constraints: + relevant_constraints.add(req.name) + msg = msg + "\n " + if parent: + msg = msg + f"{parent.name} {parent.version} depends on " + else: + msg = msg + "The user requested " + msg = msg + req.format_for_error() + for key in relevant_constraints: + spec = constraints[key].specifier + msg += f"\n The user requested (constraint) {key}{spec}" + + msg = ( + msg + + "\n\n" + + "To fix this you could try to:\n" + + "1. loosen the range of package versions you've specified\n" + + "2. remove package versions to allow pip to attempt to solve " + + "the dependency conflict\n" + ) + + logger.info(msg) + + return DistributionNotFound( + "ResolutionImpossible: for help visit " + "https://pip.pypa.io/en/latest/topics/dependency-resolution/" + "#dealing-with-dependency-conflicts" + ) diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py new file mode 100644 index 0000000..a1d57e0 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py @@ -0,0 +1,174 @@ +"""Utilities to lazily create and visit candidates found. + +Creating and visiting a candidate is a *very* costly operation. It involves +fetching, extracting, potentially building modules from source, and verifying +distribution metadata. It is therefore crucial for performance to keep +everything here lazy all the way down, so we only touch candidates that we +absolutely need, and not "download the world" when we only need one version of +something. +""" + +import functools +import logging +from collections.abc import Sequence +from typing import TYPE_CHECKING, Any, Callable, Iterator, Optional, Set, Tuple + +from pip._vendor.packaging.version import _BaseVersion + +from pip._internal.exceptions import MetadataInvalid + +from .base import Candidate + +logger = logging.getLogger(__name__) + +IndexCandidateInfo = Tuple[_BaseVersion, Callable[[], Optional[Candidate]]] + +if TYPE_CHECKING: + SequenceCandidate = Sequence[Candidate] +else: + # For compatibility: Python before 3.9 does not support using [] on the + # Sequence class. + # + # >>> from collections.abc import Sequence + # >>> Sequence[str] + # Traceback (most recent call last): + # File "", line 1, in + # TypeError: 'ABCMeta' object is not subscriptable + # + # TODO: Remove this block after dropping Python 3.8 support. + SequenceCandidate = Sequence + + +def _iter_built(infos: Iterator[IndexCandidateInfo]) -> Iterator[Candidate]: + """Iterator for ``FoundCandidates``. + + This iterator is used when the package is not already installed. Candidates + from index come later in their normal ordering. + """ + versions_found: Set[_BaseVersion] = set() + for version, func in infos: + if version in versions_found: + continue + try: + candidate = func() + except MetadataInvalid as e: + logger.warning( + "Ignoring version %s of %s since it has invalid metadata:\n" + "%s\n" + "Please use pip<24.1 if you need to use this version.", + version, + e.ireq.name, + e, + ) + # Mark version as found to avoid trying other candidates with the same + # version, since they most likely have invalid metadata as well. + versions_found.add(version) + else: + if candidate is None: + continue + yield candidate + versions_found.add(version) + + +def _iter_built_with_prepended( + installed: Candidate, infos: Iterator[IndexCandidateInfo] +) -> Iterator[Candidate]: + """Iterator for ``FoundCandidates``. + + This iterator is used when the resolver prefers the already-installed + candidate and NOT to upgrade. The installed candidate is therefore + always yielded first, and candidates from index come later in their + normal ordering, except skipped when the version is already installed. + """ + yield installed + versions_found: Set[_BaseVersion] = {installed.version} + for version, func in infos: + if version in versions_found: + continue + candidate = func() + if candidate is None: + continue + yield candidate + versions_found.add(version) + + +def _iter_built_with_inserted( + installed: Candidate, infos: Iterator[IndexCandidateInfo] +) -> Iterator[Candidate]: + """Iterator for ``FoundCandidates``. + + This iterator is used when the resolver prefers to upgrade an + already-installed package. Candidates from index are returned in their + normal ordering, except replaced when the version is already installed. + + The implementation iterates through and yields other candidates, inserting + the installed candidate exactly once before we start yielding older or + equivalent candidates, or after all other candidates if they are all newer. + """ + versions_found: Set[_BaseVersion] = set() + for version, func in infos: + if version in versions_found: + continue + # If the installed candidate is better, yield it first. + if installed.version >= version: + yield installed + versions_found.add(installed.version) + candidate = func() + if candidate is None: + continue + yield candidate + versions_found.add(version) + + # If the installed candidate is older than all other candidates. + if installed.version not in versions_found: + yield installed + + +class FoundCandidates(SequenceCandidate): + """A lazy sequence to provide candidates to the resolver. + + The intended usage is to return this from `find_matches()` so the resolver + can iterate through the sequence multiple times, but only access the index + page when remote packages are actually needed. This improve performances + when suitable candidates are already installed on disk. + """ + + def __init__( + self, + get_infos: Callable[[], Iterator[IndexCandidateInfo]], + installed: Optional[Candidate], + prefers_installed: bool, + incompatible_ids: Set[int], + ): + self._get_infos = get_infos + self._installed = installed + self._prefers_installed = prefers_installed + self._incompatible_ids = incompatible_ids + + def __getitem__(self, index: Any) -> Any: + # Implemented to satisfy the ABC check. This is not needed by the + # resolver, and should not be used by the provider either (for + # performance reasons). + raise NotImplementedError("don't do this") + + def __iter__(self) -> Iterator[Candidate]: + infos = self._get_infos() + if not self._installed: + iterator = _iter_built(infos) + elif self._prefers_installed: + iterator = _iter_built_with_prepended(self._installed, infos) + else: + iterator = _iter_built_with_inserted(self._installed, infos) + return (c for c in iterator if id(c) not in self._incompatible_ids) + + def __len__(self) -> int: + # Implemented to satisfy the ABC check. This is not needed by the + # resolver, and should not be used by the provider either (for + # performance reasons). + raise NotImplementedError("don't do this") + + @functools.lru_cache(maxsize=1) + def __bool__(self) -> bool: + if self._prefers_installed and self._installed: + return True + return any(self) diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/provider.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/provider.py new file mode 100644 index 0000000..fb0dd85 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/provider.py @@ -0,0 +1,258 @@ +import collections +import math +from functools import lru_cache +from typing import ( + TYPE_CHECKING, + Dict, + Iterable, + Iterator, + Mapping, + Sequence, + TypeVar, + Union, +) + +from pip._vendor.resolvelib.providers import AbstractProvider + +from .base import Candidate, Constraint, Requirement +from .candidates import REQUIRES_PYTHON_IDENTIFIER +from .factory import Factory + +if TYPE_CHECKING: + from pip._vendor.resolvelib.providers import Preference + from pip._vendor.resolvelib.resolvers import RequirementInformation + + PreferenceInformation = RequirementInformation[Requirement, Candidate] + + _ProviderBase = AbstractProvider[Requirement, Candidate, str] +else: + _ProviderBase = AbstractProvider + +# Notes on the relationship between the provider, the factory, and the +# candidate and requirement classes. +# +# The provider is a direct implementation of the resolvelib class. Its role +# is to deliver the API that resolvelib expects. +# +# Rather than work with completely abstract "requirement" and "candidate" +# concepts as resolvelib does, pip has concrete classes implementing these two +# ideas. The API of Requirement and Candidate objects are defined in the base +# classes, but essentially map fairly directly to the equivalent provider +# methods. In particular, `find_matches` and `is_satisfied_by` are +# requirement methods, and `get_dependencies` is a candidate method. +# +# The factory is the interface to pip's internal mechanisms. It is stateless, +# and is created by the resolver and held as a property of the provider. It is +# responsible for creating Requirement and Candidate objects, and provides +# services to those objects (access to pip's finder and preparer). + + +D = TypeVar("D") +V = TypeVar("V") + + +def _get_with_identifier( + mapping: Mapping[str, V], + identifier: str, + default: D, +) -> Union[D, V]: + """Get item from a package name lookup mapping with a resolver identifier. + + This extra logic is needed when the target mapping is keyed by package + name, which cannot be directly looked up with an identifier (which may + contain requested extras). Additional logic is added to also look up a value + by "cleaning up" the extras from the identifier. + """ + if identifier in mapping: + return mapping[identifier] + # HACK: Theoretically we should check whether this identifier is a valid + # "NAME[EXTRAS]" format, and parse out the name part with packaging or + # some regular expression. But since pip's resolver only spits out three + # kinds of identifiers: normalized PEP 503 names, normalized names plus + # extras, and Requires-Python, we can cheat a bit here. + name, open_bracket, _ = identifier.partition("[") + if open_bracket and name in mapping: + return mapping[name] + return default + + +class PipProvider(_ProviderBase): + """Pip's provider implementation for resolvelib. + + :params constraints: A mapping of constraints specified by the user. Keys + are canonicalized project names. + :params ignore_dependencies: Whether the user specified ``--no-deps``. + :params upgrade_strategy: The user-specified upgrade strategy. + :params user_requested: A set of canonicalized package names that the user + supplied for pip to install/upgrade. + """ + + def __init__( + self, + factory: Factory, + constraints: Dict[str, Constraint], + ignore_dependencies: bool, + upgrade_strategy: str, + user_requested: Dict[str, int], + ) -> None: + self._factory = factory + self._constraints = constraints + self._ignore_dependencies = ignore_dependencies + self._upgrade_strategy = upgrade_strategy + self._user_requested = user_requested + self._known_depths: Dict[str, float] = collections.defaultdict(lambda: math.inf) + + def identify(self, requirement_or_candidate: Union[Requirement, Candidate]) -> str: + return requirement_or_candidate.name + + def get_preference( + self, + identifier: str, + resolutions: Mapping[str, Candidate], + candidates: Mapping[str, Iterator[Candidate]], + information: Mapping[str, Iterable["PreferenceInformation"]], + backtrack_causes: Sequence["PreferenceInformation"], + ) -> "Preference": + """Produce a sort key for given requirement based on preference. + + The lower the return value is, the more preferred this group of + arguments is. + + Currently pip considers the following in order: + + * Prefer if any of the known requirements is "direct", e.g. points to an + explicit URL. + * If equal, prefer if any requirement is "pinned", i.e. contains + operator ``===`` or ``==``. + * If equal, calculate an approximate "depth" and resolve requirements + closer to the user-specified requirements first. If the depth cannot + by determined (eg: due to no matching parents), it is considered + infinite. + * Order user-specified requirements by the order they are specified. + * If equal, prefers "non-free" requirements, i.e. contains at least one + operator, such as ``>=`` or ``<``. + * If equal, order alphabetically for consistency (helps debuggability). + """ + try: + next(iter(information[identifier])) + except StopIteration: + # There is no information for this identifier, so there's no known + # candidates. + has_information = False + else: + has_information = True + + if has_information: + lookups = (r.get_candidate_lookup() for r, _ in information[identifier]) + candidate, ireqs = zip(*lookups) + else: + candidate, ireqs = None, () + + operators = [ + specifier.operator + for specifier_set in (ireq.specifier for ireq in ireqs if ireq) + for specifier in specifier_set + ] + + direct = candidate is not None + pinned = any(op[:2] == "==" for op in operators) + unfree = bool(operators) + + try: + requested_order: Union[int, float] = self._user_requested[identifier] + except KeyError: + requested_order = math.inf + if has_information: + parent_depths = ( + self._known_depths[parent.name] if parent is not None else 0.0 + for _, parent in information[identifier] + ) + inferred_depth = min(d for d in parent_depths) + 1.0 + else: + inferred_depth = math.inf + else: + inferred_depth = 1.0 + self._known_depths[identifier] = inferred_depth + + requested_order = self._user_requested.get(identifier, math.inf) + + # Requires-Python has only one candidate and the check is basically + # free, so we always do it first to avoid needless work if it fails. + requires_python = identifier == REQUIRES_PYTHON_IDENTIFIER + + # Prefer the causes of backtracking on the assumption that the problem + # resolving the dependency tree is related to the failures that caused + # the backtracking + backtrack_cause = self.is_backtrack_cause(identifier, backtrack_causes) + + return ( + not requires_python, + not direct, + not pinned, + not backtrack_cause, + inferred_depth, + requested_order, + not unfree, + identifier, + ) + + def find_matches( + self, + identifier: str, + requirements: Mapping[str, Iterator[Requirement]], + incompatibilities: Mapping[str, Iterator[Candidate]], + ) -> Iterable[Candidate]: + def _eligible_for_upgrade(identifier: str) -> bool: + """Are upgrades allowed for this project? + + This checks the upgrade strategy, and whether the project was one + that the user specified in the command line, in order to decide + whether we should upgrade if there's a newer version available. + + (Note that we don't need access to the `--upgrade` flag, because + an upgrade strategy of "to-satisfy-only" means that `--upgrade` + was not specified). + """ + if self._upgrade_strategy == "eager": + return True + elif self._upgrade_strategy == "only-if-needed": + user_order = _get_with_identifier( + self._user_requested, + identifier, + default=None, + ) + return user_order is not None + return False + + constraint = _get_with_identifier( + self._constraints, + identifier, + default=Constraint.empty(), + ) + return self._factory.find_candidates( + identifier=identifier, + requirements=requirements, + constraint=constraint, + prefers_installed=(not _eligible_for_upgrade(identifier)), + incompatibilities=incompatibilities, + is_satisfied_by=self.is_satisfied_by, + ) + + @lru_cache(maxsize=None) + def is_satisfied_by(self, requirement: Requirement, candidate: Candidate) -> bool: + return requirement.is_satisfied_by(candidate) + + def get_dependencies(self, candidate: Candidate) -> Sequence[Requirement]: + with_requires = not self._ignore_dependencies + return [r for r in candidate.iter_dependencies(with_requires) if r is not None] + + @staticmethod + def is_backtrack_cause( + identifier: str, backtrack_causes: Sequence["PreferenceInformation"] + ) -> bool: + for backtrack_cause in backtrack_causes: + if identifier == backtrack_cause.requirement.name: + return True + if backtrack_cause.parent and identifier == backtrack_cause.parent.name: + return True + return False diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/reporter.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/reporter.py new file mode 100644 index 0000000..0594569 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/reporter.py @@ -0,0 +1,81 @@ +from collections import defaultdict +from logging import getLogger +from typing import Any, DefaultDict + +from pip._vendor.resolvelib.reporters import BaseReporter + +from .base import Candidate, Requirement + +logger = getLogger(__name__) + + +class PipReporter(BaseReporter): + def __init__(self) -> None: + self.reject_count_by_package: DefaultDict[str, int] = defaultdict(int) + + self._messages_at_reject_count = { + 1: ( + "pip is looking at multiple versions of {package_name} to " + "determine which version is compatible with other " + "requirements. This could take a while." + ), + 8: ( + "pip is still looking at multiple versions of {package_name} to " + "determine which version is compatible with other " + "requirements. This could take a while." + ), + 13: ( + "This is taking longer than usual. You might need to provide " + "the dependency resolver with stricter constraints to reduce " + "runtime. See https://pip.pypa.io/warnings/backtracking for " + "guidance. If you want to abort this run, press Ctrl + C." + ), + } + + def rejecting_candidate(self, criterion: Any, candidate: Candidate) -> None: + self.reject_count_by_package[candidate.name] += 1 + + count = self.reject_count_by_package[candidate.name] + if count not in self._messages_at_reject_count: + return + + message = self._messages_at_reject_count[count] + logger.info("INFO: %s", message.format(package_name=candidate.name)) + + msg = "Will try a different candidate, due to conflict:" + for req_info in criterion.information: + req, parent = req_info.requirement, req_info.parent + # Inspired by Factory.get_installation_error + msg += "\n " + if parent: + msg += f"{parent.name} {parent.version} depends on " + else: + msg += "The user requested " + msg += req.format_for_error() + logger.debug(msg) + + +class PipDebuggingReporter(BaseReporter): + """A reporter that does an info log for every event it sees.""" + + def starting(self) -> None: + logger.info("Reporter.starting()") + + def starting_round(self, index: int) -> None: + logger.info("Reporter.starting_round(%r)", index) + + def ending_round(self, index: int, state: Any) -> None: + logger.info("Reporter.ending_round(%r, state)", index) + logger.debug("Reporter.ending_round(%r, %r)", index, state) + + def ending(self, state: Any) -> None: + logger.info("Reporter.ending(%r)", state) + + def adding_requirement(self, requirement: Requirement, parent: Candidate) -> None: + logger.info("Reporter.adding_requirement(%r, %r)", requirement, parent) + + def rejecting_candidate(self, criterion: Any, candidate: Candidate) -> None: + logger.info("Reporter.rejecting_candidate(%r, %r)", criterion, candidate) + + def pinning(self, candidate: Candidate) -> None: + logger.info("Reporter.pinning(%r)", candidate) diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/requirements.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/requirements.py new file mode 100644 index 0000000..b04f41b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/requirements.py @@ -0,0 +1,245 @@ +from typing import Any, Optional + +from pip._vendor.packaging.specifiers import SpecifierSet +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name + +from pip._internal.req.constructors import install_req_drop_extras +from pip._internal.req.req_install import InstallRequirement + +from .base import Candidate, CandidateLookup, Requirement, format_name + + +class ExplicitRequirement(Requirement): + def __init__(self, candidate: Candidate) -> None: + self.candidate = candidate + + def __str__(self) -> str: + return str(self.candidate) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.candidate!r})" + + def __hash__(self) -> int: + return hash(self.candidate) + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, ExplicitRequirement): + return False + return self.candidate == other.candidate + + @property + def project_name(self) -> NormalizedName: + # No need to canonicalize - the candidate did this + return self.candidate.project_name + + @property + def name(self) -> str: + # No need to canonicalize - the candidate did this + return self.candidate.name + + def format_for_error(self) -> str: + return self.candidate.format_for_error() + + def get_candidate_lookup(self) -> CandidateLookup: + return self.candidate, None + + def is_satisfied_by(self, candidate: Candidate) -> bool: + return candidate == self.candidate + + +class SpecifierRequirement(Requirement): + def __init__(self, ireq: InstallRequirement) -> None: + assert ireq.link is None, "This is a link, not a specifier" + self._ireq = ireq + self._equal_cache: Optional[str] = None + self._hash: Optional[int] = None + self._extras = frozenset(canonicalize_name(e) for e in self._ireq.extras) + + @property + def _equal(self) -> str: + if self._equal_cache is not None: + return self._equal_cache + + self._equal_cache = str(self._ireq) + return self._equal_cache + + def __str__(self) -> str: + return str(self._ireq.req) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({str(self._ireq.req)!r})" + + def __eq__(self, other: object) -> bool: + if not isinstance(other, SpecifierRequirement): + return NotImplemented + return self._equal == other._equal + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + + self._hash = hash(self._equal) + return self._hash + + @property + def project_name(self) -> NormalizedName: + assert self._ireq.req, "Specifier-backed ireq is always PEP 508" + return canonicalize_name(self._ireq.req.name) + + @property + def name(self) -> str: + return format_name(self.project_name, self._extras) + + def format_for_error(self) -> str: + # Convert comma-separated specifiers into "A, B, ..., F and G" + # This makes the specifier a bit more "human readable", without + # risking a change in meaning. (Hopefully! Not all edge cases have + # been checked) + parts = [s.strip() for s in str(self).split(",")] + if len(parts) == 0: + return "" + elif len(parts) == 1: + return parts[0] + + return ", ".join(parts[:-1]) + " and " + parts[-1] + + def get_candidate_lookup(self) -> CandidateLookup: + return None, self._ireq + + def is_satisfied_by(self, candidate: Candidate) -> bool: + assert candidate.name == self.name, ( + f"Internal issue: Candidate is not for this requirement " + f"{candidate.name} vs {self.name}" + ) + # We can safely always allow prereleases here since PackageFinder + # already implements the prerelease logic, and would have filtered out + # prerelease candidates if the user does not expect them. + assert self._ireq.req, "Specifier-backed ireq is always PEP 508" + spec = self._ireq.req.specifier + return spec.contains(candidate.version, prereleases=True) + + +class SpecifierWithoutExtrasRequirement(SpecifierRequirement): + """ + Requirement backed by an install requirement on a base package. + Trims extras from its install requirement if there are any. + """ + + def __init__(self, ireq: InstallRequirement) -> None: + assert ireq.link is None, "This is a link, not a specifier" + self._ireq = install_req_drop_extras(ireq) + self._equal_cache: Optional[str] = None + self._hash: Optional[int] = None + self._extras = frozenset(canonicalize_name(e) for e in self._ireq.extras) + + @property + def _equal(self) -> str: + if self._equal_cache is not None: + return self._equal_cache + + self._equal_cache = str(self._ireq) + return self._equal_cache + + def __eq__(self, other: object) -> bool: + if not isinstance(other, SpecifierWithoutExtrasRequirement): + return NotImplemented + return self._equal == other._equal + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + + self._hash = hash(self._equal) + return self._hash + + +class RequiresPythonRequirement(Requirement): + """A requirement representing Requires-Python metadata.""" + + def __init__(self, specifier: SpecifierSet, match: Candidate) -> None: + self.specifier = specifier + self._specifier_string = str(specifier) # for faster __eq__ + self._hash: Optional[int] = None + self._candidate = match + + def __str__(self) -> str: + return f"Python {self.specifier}" + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({str(self.specifier)!r})" + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + + self._hash = hash((self._specifier_string, self._candidate)) + return self._hash + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, RequiresPythonRequirement): + return False + return ( + self._specifier_string == other._specifier_string + and self._candidate == other._candidate + ) + + @property + def project_name(self) -> NormalizedName: + return self._candidate.project_name + + @property + def name(self) -> str: + return self._candidate.name + + def format_for_error(self) -> str: + return str(self) + + def get_candidate_lookup(self) -> CandidateLookup: + if self.specifier.contains(self._candidate.version, prereleases=True): + return self._candidate, None + return None, None + + def is_satisfied_by(self, candidate: Candidate) -> bool: + assert candidate.name == self._candidate.name, "Not Python candidate" + # We can safely always allow prereleases here since PackageFinder + # already implements the prerelease logic, and would have filtered out + # prerelease candidates if the user does not expect them. + return self.specifier.contains(candidate.version, prereleases=True) + + +class UnsatisfiableRequirement(Requirement): + """A requirement that cannot be satisfied.""" + + def __init__(self, name: NormalizedName) -> None: + self._name = name + + def __str__(self) -> str: + return f"{self._name} (unavailable)" + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({str(self._name)!r})" + + def __eq__(self, other: object) -> bool: + if not isinstance(other, UnsatisfiableRequirement): + return NotImplemented + return self._name == other._name + + def __hash__(self) -> int: + return hash(self._name) + + @property + def project_name(self) -> NormalizedName: + return self._name + + @property + def name(self) -> str: + return self._name + + def format_for_error(self) -> str: + return str(self) + + def get_candidate_lookup(self) -> CandidateLookup: + return None, None + + def is_satisfied_by(self, candidate: Candidate) -> bool: + return False diff --git a/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/resolver.py b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/resolver.py new file mode 100644 index 0000000..c12beef --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/resolver.py @@ -0,0 +1,317 @@ +import contextlib +import functools +import logging +import os +from typing import TYPE_CHECKING, Dict, List, Optional, Set, Tuple, cast + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.resolvelib import BaseReporter, ResolutionImpossible +from pip._vendor.resolvelib import Resolver as RLResolver +from pip._vendor.resolvelib.structs import DirectedGraph + +from pip._internal.cache import WheelCache +from pip._internal.index.package_finder import PackageFinder +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.constructors import install_req_extend_extras +from pip._internal.req.req_install import InstallRequirement +from pip._internal.req.req_set import RequirementSet +from pip._internal.resolution.base import BaseResolver, InstallRequirementProvider +from pip._internal.resolution.resolvelib.provider import PipProvider +from pip._internal.resolution.resolvelib.reporter import ( + PipDebuggingReporter, + PipReporter, +) +from pip._internal.utils.packaging import get_requirement + +from .base import Candidate, Requirement +from .factory import Factory + +if TYPE_CHECKING: + from pip._vendor.resolvelib.resolvers import Result as RLResult + + Result = RLResult[Requirement, Candidate, str] + + +logger = logging.getLogger(__name__) + + +class Resolver(BaseResolver): + _allowed_strategies = {"eager", "only-if-needed", "to-satisfy-only"} + + def __init__( + self, + preparer: RequirementPreparer, + finder: PackageFinder, + wheel_cache: Optional[WheelCache], + make_install_req: InstallRequirementProvider, + use_user_site: bool, + ignore_dependencies: bool, + ignore_installed: bool, + ignore_requires_python: bool, + force_reinstall: bool, + upgrade_strategy: str, + py_version_info: Optional[Tuple[int, ...]] = None, + ): + super().__init__() + assert upgrade_strategy in self._allowed_strategies + + self.factory = Factory( + finder=finder, + preparer=preparer, + make_install_req=make_install_req, + wheel_cache=wheel_cache, + use_user_site=use_user_site, + force_reinstall=force_reinstall, + ignore_installed=ignore_installed, + ignore_requires_python=ignore_requires_python, + py_version_info=py_version_info, + ) + self.ignore_dependencies = ignore_dependencies + self.upgrade_strategy = upgrade_strategy + self._result: Optional[Result] = None + + def resolve( + self, root_reqs: List[InstallRequirement], check_supported_wheels: bool + ) -> RequirementSet: + collected = self.factory.collect_root_requirements(root_reqs) + provider = PipProvider( + factory=self.factory, + constraints=collected.constraints, + ignore_dependencies=self.ignore_dependencies, + upgrade_strategy=self.upgrade_strategy, + user_requested=collected.user_requested, + ) + if "PIP_RESOLVER_DEBUG" in os.environ: + reporter: BaseReporter = PipDebuggingReporter() + else: + reporter = PipReporter() + resolver: RLResolver[Requirement, Candidate, str] = RLResolver( + provider, + reporter, + ) + + try: + limit_how_complex_resolution_can_be = 200000 + result = self._result = resolver.resolve( + collected.requirements, max_rounds=limit_how_complex_resolution_can_be + ) + + except ResolutionImpossible as e: + error = self.factory.get_installation_error( + cast("ResolutionImpossible[Requirement, Candidate]", e), + collected.constraints, + ) + raise error from e + + req_set = RequirementSet(check_supported_wheels=check_supported_wheels) + # process candidates with extras last to ensure their base equivalent is + # already in the req_set if appropriate. + # Python's sort is stable so using a binary key function keeps relative order + # within both subsets. + for candidate in sorted( + result.mapping.values(), key=lambda c: c.name != c.project_name + ): + ireq = candidate.get_install_requirement() + if ireq is None: + if candidate.name != candidate.project_name: + # extend existing req's extras + with contextlib.suppress(KeyError): + req = req_set.get_requirement(candidate.project_name) + req_set.add_named_requirement( + install_req_extend_extras( + req, get_requirement(candidate.name).extras + ) + ) + continue + + # Check if there is already an installation under the same name, + # and set a flag for later stages to uninstall it, if needed. + installed_dist = self.factory.get_dist_to_uninstall(candidate) + if installed_dist is None: + # There is no existing installation -- nothing to uninstall. + ireq.should_reinstall = False + elif self.factory.force_reinstall: + # The --force-reinstall flag is set -- reinstall. + ireq.should_reinstall = True + elif installed_dist.version != candidate.version: + # The installation is different in version -- reinstall. + ireq.should_reinstall = True + elif candidate.is_editable or installed_dist.editable: + # The incoming distribution is editable, or different in + # editable-ness to installation -- reinstall. + ireq.should_reinstall = True + elif candidate.source_link and candidate.source_link.is_file: + # The incoming distribution is under file:// + if candidate.source_link.is_wheel: + # is a local wheel -- do nothing. + logger.info( + "%s is already installed with the same version as the " + "provided wheel. Use --force-reinstall to force an " + "installation of the wheel.", + ireq.name, + ) + continue + + # is a local sdist or path -- reinstall + ireq.should_reinstall = True + else: + continue + + link = candidate.source_link + if link and link.is_yanked: + # The reason can contain non-ASCII characters, Unicode + # is required for Python 2. + msg = ( + "The candidate selected for download or install is a " + "yanked version: {name!r} candidate (version {version} " + "at {link})\nReason for being yanked: {reason}" + ).format( + name=candidate.name, + version=candidate.version, + link=link, + reason=link.yanked_reason or "", + ) + logger.warning(msg) + + req_set.add_named_requirement(ireq) + + reqs = req_set.all_requirements + self.factory.preparer.prepare_linked_requirements_more(reqs) + for req in reqs: + req.prepared = True + req.needs_more_preparation = False + return req_set + + def get_installation_order( + self, req_set: RequirementSet + ) -> List[InstallRequirement]: + """Get order for installation of requirements in RequirementSet. + + The returned list contains a requirement before another that depends on + it. This helps ensure that the environment is kept consistent as they + get installed one-by-one. + + The current implementation creates a topological ordering of the + dependency graph, giving more weight to packages with less + or no dependencies, while breaking any cycles in the graph at + arbitrary points. We make no guarantees about where the cycle + would be broken, other than it *would* be broken. + """ + assert self._result is not None, "must call resolve() first" + + if not req_set.requirements: + # Nothing is left to install, so we do not need an order. + return [] + + graph = self._result.graph + weights = get_topological_weights(graph, set(req_set.requirements.keys())) + + sorted_items = sorted( + req_set.requirements.items(), + key=functools.partial(_req_set_item_sorter, weights=weights), + reverse=True, + ) + return [ireq for _, ireq in sorted_items] + + +def get_topological_weights( + graph: "DirectedGraph[Optional[str]]", requirement_keys: Set[str] +) -> Dict[Optional[str], int]: + """Assign weights to each node based on how "deep" they are. + + This implementation may change at any point in the future without prior + notice. + + We first simplify the dependency graph by pruning any leaves and giving them + the highest weight: a package without any dependencies should be installed + first. This is done again and again in the same way, giving ever less weight + to the newly found leaves. The loop stops when no leaves are left: all + remaining packages have at least one dependency left in the graph. + + Then we continue with the remaining graph, by taking the length for the + longest path to any node from root, ignoring any paths that contain a single + node twice (i.e. cycles). This is done through a depth-first search through + the graph, while keeping track of the path to the node. + + Cycles in the graph result would result in node being revisited while also + being on its own path. In this case, take no action. This helps ensure we + don't get stuck in a cycle. + + When assigning weight, the longer path (i.e. larger length) is preferred. + + We are only interested in the weights of packages that are in the + requirement_keys. + """ + path: Set[Optional[str]] = set() + weights: Dict[Optional[str], int] = {} + + def visit(node: Optional[str]) -> None: + if node in path: + # We hit a cycle, so we'll break it here. + return + + # Time to visit the children! + path.add(node) + for child in graph.iter_children(node): + visit(child) + path.remove(node) + + if node not in requirement_keys: + return + + last_known_parent_count = weights.get(node, 0) + weights[node] = max(last_known_parent_count, len(path)) + + # Simplify the graph, pruning leaves that have no dependencies. + # This is needed for large graphs (say over 200 packages) because the + # `visit` function is exponentially slower then, taking minutes. + # See https://github.com/pypa/pip/issues/10557 + # We will loop until we explicitly break the loop. + while True: + leaves = set() + for key in graph: + if key is None: + continue + for _child in graph.iter_children(key): + # This means we have at least one child + break + else: + # No child. + leaves.add(key) + if not leaves: + # We are done simplifying. + break + # Calculate the weight for the leaves. + weight = len(graph) - 1 + for leaf in leaves: + if leaf not in requirement_keys: + continue + weights[leaf] = weight + # Remove the leaves from the graph, making it simpler. + for leaf in leaves: + graph.remove(leaf) + + # Visit the remaining graph. + # `None` is guaranteed to be the root node by resolvelib. + visit(None) + + # Sanity check: all requirement keys should be in the weights, + # and no other keys should be in the weights. + difference = set(weights.keys()).difference(requirement_keys) + assert not difference, difference + + return weights + + +def _req_set_item_sorter( + item: Tuple[str, InstallRequirement], + weights: Dict[Optional[str], int], +) -> Tuple[int, str]: + """Key function used to sort install requirements for installation. + + Based on the "weight" mapping calculated in ``get_installation_order()``. + The canonical package name is returned as the second member as a tie- + breaker to ensure the result is predictable, which is useful in tests. + """ + name = canonicalize_name(item[0]) + return weights[name], name diff --git a/env/lib/python3.12/site-packages/pip/_internal/self_outdated_check.py b/env/lib/python3.12/site-packages/pip/_internal/self_outdated_check.py new file mode 100644 index 0000000..2e0e3df --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/self_outdated_check.py @@ -0,0 +1,252 @@ +import datetime +import functools +import hashlib +import json +import logging +import optparse +import os.path +import sys +from dataclasses import dataclass +from typing import Any, Callable, Dict, Optional + +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version +from pip._vendor.rich.console import Group +from pip._vendor.rich.markup import escape +from pip._vendor.rich.text import Text + +from pip._internal.index.collector import LinkCollector +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import get_default_environment +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.network.session import PipSession +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.entrypoints import ( + get_best_invocation_for_this_pip, + get_best_invocation_for_this_python, +) +from pip._internal.utils.filesystem import adjacent_tmp_file, check_path_owner, replace +from pip._internal.utils.misc import ( + ExternallyManagedEnvironment, + check_externally_managed, + ensure_dir, +) + +_WEEK = datetime.timedelta(days=7) + +logger = logging.getLogger(__name__) + + +def _get_statefile_name(key: str) -> str: + key_bytes = key.encode() + name = hashlib.sha224(key_bytes).hexdigest() + return name + + +def _convert_date(isodate: str) -> datetime.datetime: + """Convert an ISO format string to a date. + + Handles the format 2020-01-22T14:24:01Z (trailing Z) + which is not supported by older versions of fromisoformat. + """ + return datetime.datetime.fromisoformat(isodate.replace("Z", "+00:00")) + + +class SelfCheckState: + def __init__(self, cache_dir: str) -> None: + self._state: Dict[str, Any] = {} + self._statefile_path = None + + # Try to load the existing state + if cache_dir: + self._statefile_path = os.path.join( + cache_dir, "selfcheck", _get_statefile_name(self.key) + ) + try: + with open(self._statefile_path, encoding="utf-8") as statefile: + self._state = json.load(statefile) + except (OSError, ValueError, KeyError): + # Explicitly suppressing exceptions, since we don't want to + # error out if the cache file is invalid. + pass + + @property + def key(self) -> str: + return sys.prefix + + def get(self, current_time: datetime.datetime) -> Optional[str]: + """Check if we have a not-outdated version loaded already.""" + if not self._state: + return None + + if "last_check" not in self._state: + return None + + if "pypi_version" not in self._state: + return None + + # Determine if we need to refresh the state + last_check = _convert_date(self._state["last_check"]) + time_since_last_check = current_time - last_check + if time_since_last_check > _WEEK: + return None + + return self._state["pypi_version"] + + def set(self, pypi_version: str, current_time: datetime.datetime) -> None: + # If we do not have a path to cache in, don't bother saving. + if not self._statefile_path: + return + + # Check to make sure that we own the directory + if not check_path_owner(os.path.dirname(self._statefile_path)): + return + + # Now that we've ensured the directory is owned by this user, we'll go + # ahead and make sure that all our directories are created. + ensure_dir(os.path.dirname(self._statefile_path)) + + state = { + # Include the key so it's easy to tell which pip wrote the + # file. + "key": self.key, + "last_check": current_time.isoformat(), + "pypi_version": pypi_version, + } + + text = json.dumps(state, sort_keys=True, separators=(",", ":")) + + with adjacent_tmp_file(self._statefile_path) as f: + f.write(text.encode()) + + try: + # Since we have a prefix-specific state file, we can just + # overwrite whatever is there, no need to check. + replace(f.name, self._statefile_path) + except OSError: + # Best effort. + pass + + +@dataclass +class UpgradePrompt: + old: str + new: str + + def __rich__(self) -> Group: + if WINDOWS: + pip_cmd = f"{get_best_invocation_for_this_python()} -m pip" + else: + pip_cmd = get_best_invocation_for_this_pip() + + notice = "[bold][[reset][blue]notice[reset][bold]][reset]" + return Group( + Text(), + Text.from_markup( + f"{notice} A new release of pip is available: " + f"[red]{self.old}[reset] -> [green]{self.new}[reset]" + ), + Text.from_markup( + f"{notice} To update, run: " + f"[green]{escape(pip_cmd)} install --upgrade pip" + ), + ) + + +def was_installed_by_pip(pkg: str) -> bool: + """Checks whether pkg was installed by pip + + This is used not to display the upgrade message when pip is in fact + installed by system package manager, such as dnf on Fedora. + """ + dist = get_default_environment().get_distribution(pkg) + return dist is not None and "pip" == dist.installer + + +def _get_current_remote_pip_version( + session: PipSession, options: optparse.Values +) -> Optional[str]: + # Lets use PackageFinder to see what the latest pip version is + link_collector = LinkCollector.create( + session, + options=options, + suppress_no_index=True, + ) + + # Pass allow_yanked=False so we don't suggest upgrading to a + # yanked version. + selection_prefs = SelectionPreferences( + allow_yanked=False, + allow_all_prereleases=False, # Explicitly set to False + ) + + finder = PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + ) + best_candidate = finder.find_best_candidate("pip").best_candidate + if best_candidate is None: + return None + + return str(best_candidate.version) + + +def _self_version_check_logic( + *, + state: SelfCheckState, + current_time: datetime.datetime, + local_version: Version, + get_remote_version: Callable[[], Optional[str]], +) -> Optional[UpgradePrompt]: + remote_version_str = state.get(current_time) + if remote_version_str is None: + remote_version_str = get_remote_version() + if remote_version_str is None: + logger.debug("No remote pip version found") + return None + state.set(remote_version_str, current_time) + + remote_version = parse_version(remote_version_str) + logger.debug("Remote version of pip: %s", remote_version) + logger.debug("Local version of pip: %s", local_version) + + pip_installed_by_pip = was_installed_by_pip("pip") + logger.debug("Was pip installed by pip? %s", pip_installed_by_pip) + if not pip_installed_by_pip: + return None # Only suggest upgrade if pip is installed by pip. + + local_version_is_older = ( + local_version < remote_version + and local_version.base_version != remote_version.base_version + ) + if local_version_is_older: + return UpgradePrompt(old=str(local_version), new=remote_version_str) + + return None + + +def pip_self_version_check(session: PipSession, options: optparse.Values) -> None: + """Check for an update for pip. + + Limit the frequency of checks to once per week. State is stored either in + the active virtualenv or in the user's USER_CACHE_DIR keyed off the prefix + of the pip script path. + """ + installed_dist = get_default_environment().get_distribution("pip") + if not installed_dist: + return + try: + check_externally_managed() + except ExternallyManagedEnvironment: + return + + upgrade_prompt = _self_version_check_logic( + state=SelfCheckState(cache_dir=options.cache_dir), + current_time=datetime.datetime.now(datetime.timezone.utc), + local_version=installed_dist.version, + get_remote_version=functools.partial( + _get_current_remote_pip_version, session, options + ), + ) + if upgrade_prompt is not None: + logger.warning("%s", upgrade_prompt, extra={"rich": True}) diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/utils/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/_jaraco_text.py b/env/lib/python3.12/site-packages/pip/_internal/utils/_jaraco_text.py new file mode 100644 index 0000000..6ccf53b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/_jaraco_text.py @@ -0,0 +1,109 @@ +"""Functions brought over from jaraco.text. + +These functions are not supposed to be used within `pip._internal`. These are +helper functions brought over from `jaraco.text` to enable vendoring newer +copies of `pkg_resources` without having to vendor `jaraco.text` and its entire +dependency cone; something that our vendoring setup is not currently capable of +handling. + +License reproduced from original source below: + +Copyright Jason R. Coombs + +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. +""" + +import functools +import itertools + + +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 preceding 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 diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/_log.py b/env/lib/python3.12/site-packages/pip/_internal/utils/_log.py new file mode 100644 index 0000000..92c4c6a --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/_log.py @@ -0,0 +1,38 @@ +"""Customize logging + +Defines custom logger class for the `logger.verbose(...)` method. + +init_logging() must be called before any other modules that call logging.getLogger. +""" + +import logging +from typing import Any, cast + +# custom log level for `--verbose` output +# between DEBUG and INFO +VERBOSE = 15 + + +class VerboseLogger(logging.Logger): + """Custom Logger, defining a verbose log-level + + VERBOSE is between INFO and DEBUG. + """ + + def verbose(self, msg: str, *args: Any, **kwargs: Any) -> None: + return self.log(VERBOSE, msg, *args, **kwargs) + + +def getLogger(name: str) -> VerboseLogger: + """logging.getLogger, but ensures our VerboseLogger class is returned""" + return cast(VerboseLogger, logging.getLogger(name)) + + +def init_logging() -> None: + """Register our VerboseLogger and VERBOSE log level. + + Should be called before any calls to getLogger(), + i.e. in pip._internal.__init__ + """ + logging.setLoggerClass(VerboseLogger) + logging.addLevelName(VERBOSE, "VERBOSE") diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/appdirs.py b/env/lib/python3.12/site-packages/pip/_internal/utils/appdirs.py new file mode 100644 index 0000000..16933bf --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/appdirs.py @@ -0,0 +1,52 @@ +""" +This code wraps the vendored appdirs module to so the return values are +compatible for the current pip code base. + +The intention is to rewrite current usages gradually, keeping the tests pass, +and eventually drop this after all usages are changed. +""" + +import os +import sys +from typing import List + +from pip._vendor import platformdirs as _appdirs + + +def user_cache_dir(appname: str) -> str: + return _appdirs.user_cache_dir(appname, appauthor=False) + + +def _macos_user_config_dir(appname: str, roaming: bool = True) -> str: + # Use ~/Application Support/pip, if the directory exists. + path = _appdirs.user_data_dir(appname, appauthor=False, roaming=roaming) + if os.path.isdir(path): + return path + + # Use a Linux-like ~/.config/pip, by default. + linux_like_path = "~/.config/" + if appname: + linux_like_path = os.path.join(linux_like_path, appname) + + return os.path.expanduser(linux_like_path) + + +def user_config_dir(appname: str, roaming: bool = True) -> str: + if sys.platform == "darwin": + return _macos_user_config_dir(appname, roaming) + + return _appdirs.user_config_dir(appname, appauthor=False, roaming=roaming) + + +# for the discussion regarding site_config_dir locations +# see +def site_config_dirs(appname: str) -> List[str]: + if sys.platform == "darwin": + return [_appdirs.site_data_dir(appname, appauthor=False, multipath=True)] + + dirval = _appdirs.site_config_dir(appname, appauthor=False, multipath=True) + if sys.platform == "win32": + return [dirval] + + # Unix-y system. Look in /etc as well. + return dirval.split(os.pathsep) + ["/etc"] diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/compat.py b/env/lib/python3.12/site-packages/pip/_internal/utils/compat.py new file mode 100644 index 0000000..d8b54e4 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/compat.py @@ -0,0 +1,79 @@ +"""Stuff that differs in different Python versions and platform +distributions.""" + +import importlib.resources +import logging +import os +import sys +from typing import IO + +__all__ = ["get_path_uid", "stdlib_pkgs", "WINDOWS"] + + +logger = logging.getLogger(__name__) + + +def has_tls() -> bool: + try: + import _ssl # noqa: F401 # ignore unused + + return True + except ImportError: + pass + + from pip._vendor.urllib3.util import IS_PYOPENSSL + + return IS_PYOPENSSL + + +def get_path_uid(path: str) -> int: + """ + Return path's uid. + + Does not follow symlinks: + https://github.com/pypa/pip/pull/935#discussion_r5307003 + + Placed this function in compat due to differences on AIX and + Jython, that should eventually go away. + + :raises OSError: When path is a symlink or can't be read. + """ + if hasattr(os, "O_NOFOLLOW"): + fd = os.open(path, os.O_RDONLY | os.O_NOFOLLOW) + file_uid = os.fstat(fd).st_uid + os.close(fd) + else: # AIX and Jython + # WARNING: time of check vulnerability, but best we can do w/o NOFOLLOW + if not os.path.islink(path): + # older versions of Jython don't have `os.fstat` + file_uid = os.stat(path).st_uid + else: + # raise OSError for parity with os.O_NOFOLLOW above + raise OSError(f"{path} is a symlink; Will not return uid for symlinks") + return file_uid + + +# The importlib.resources.open_text function was deprecated in 3.11 with suggested +# replacement we use below. +if sys.version_info < (3, 11): + open_text_resource = importlib.resources.open_text +else: + + def open_text_resource( + package: str, resource: str, encoding: str = "utf-8", errors: str = "strict" + ) -> IO[str]: + return (importlib.resources.files(package) / resource).open( + "r", encoding=encoding, errors=errors + ) + + +# packages in the stdlib that may have installation metadata, but should not be +# considered 'installed'. this theoretically could be determined based on +# dist.location (py27:`sysconfig.get_paths()['stdlib']`, +# py26:sysconfig.get_config_vars('LIBDEST')), but fear platform variation may +# make this ineffective, so hard-coding +stdlib_pkgs = {"python", "wsgiref", "argparse"} + + +# windows detection, covers cpython and ironpython +WINDOWS = sys.platform.startswith("win") or (sys.platform == "cli" and os.name == "nt") diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/compatibility_tags.py b/env/lib/python3.12/site-packages/pip/_internal/utils/compatibility_tags.py new file mode 100644 index 0000000..2e7b745 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/compatibility_tags.py @@ -0,0 +1,188 @@ +"""Generate and work with PEP 425 Compatibility Tags. +""" + +import re +from typing import List, Optional, Tuple + +from pip._vendor.packaging.tags import ( + PythonVersion, + Tag, + compatible_tags, + cpython_tags, + generic_tags, + interpreter_name, + interpreter_version, + ios_platforms, + mac_platforms, +) + +_apple_arch_pat = re.compile(r"(.+)_(\d+)_(\d+)_(.+)") + + +def version_info_to_nodot(version_info: Tuple[int, ...]) -> str: + # Only use up to the first two numbers. + return "".join(map(str, version_info[:2])) + + +def _mac_platforms(arch: str) -> List[str]: + match = _apple_arch_pat.match(arch) + if match: + name, major, minor, actual_arch = match.groups() + mac_version = (int(major), int(minor)) + arches = [ + # Since we have always only checked that the platform starts + # with "macosx", for backwards-compatibility we extract the + # actual prefix provided by the user in case they provided + # something like "macosxcustom_". It may be good to remove + # this as undocumented or deprecate it in the future. + "{}_{}".format(name, arch[len("macosx_") :]) + for arch in mac_platforms(mac_version, actual_arch) + ] + else: + # arch pattern didn't match (?!) + arches = [arch] + return arches + + +def _ios_platforms(arch: str) -> List[str]: + match = _apple_arch_pat.match(arch) + if match: + name, major, minor, actual_multiarch = match.groups() + ios_version = (int(major), int(minor)) + arches = [ + # Since we have always only checked that the platform starts + # with "ios", for backwards-compatibility we extract the + # actual prefix provided by the user in case they provided + # something like "ioscustom_". It may be good to remove + # this as undocumented or deprecate it in the future. + "{}_{}".format(name, arch[len("ios_") :]) + for arch in ios_platforms(ios_version, actual_multiarch) + ] + else: + # arch pattern didn't match (?!) + arches = [arch] + return arches + + +def _custom_manylinux_platforms(arch: str) -> List[str]: + arches = [arch] + arch_prefix, arch_sep, arch_suffix = arch.partition("_") + if arch_prefix == "manylinux2014": + # manylinux1/manylinux2010 wheels run on most manylinux2014 systems + # with the exception of wheels depending on ncurses. PEP 599 states + # manylinux1/manylinux2010 wheels should be considered + # manylinux2014 wheels: + # https://www.python.org/dev/peps/pep-0599/#backwards-compatibility-with-manylinux2010-wheels + if arch_suffix in {"i686", "x86_64"}: + arches.append("manylinux2010" + arch_sep + arch_suffix) + arches.append("manylinux1" + arch_sep + arch_suffix) + elif arch_prefix == "manylinux2010": + # manylinux1 wheels run on most manylinux2010 systems with the + # exception of wheels depending on ncurses. PEP 571 states + # manylinux1 wheels should be considered manylinux2010 wheels: + # https://www.python.org/dev/peps/pep-0571/#backwards-compatibility-with-manylinux1-wheels + arches.append("manylinux1" + arch_sep + arch_suffix) + return arches + + +def _get_custom_platforms(arch: str) -> List[str]: + arch_prefix, arch_sep, arch_suffix = arch.partition("_") + if arch.startswith("macosx"): + arches = _mac_platforms(arch) + elif arch.startswith("ios"): + arches = _ios_platforms(arch) + elif arch_prefix in ["manylinux2014", "manylinux2010"]: + arches = _custom_manylinux_platforms(arch) + else: + arches = [arch] + return arches + + +def _expand_allowed_platforms(platforms: Optional[List[str]]) -> Optional[List[str]]: + if not platforms: + return None + + seen = set() + result = [] + + for p in platforms: + if p in seen: + continue + additions = [c for c in _get_custom_platforms(p) if c not in seen] + seen.update(additions) + result.extend(additions) + + return result + + +def _get_python_version(version: str) -> PythonVersion: + if len(version) > 1: + return int(version[0]), int(version[1:]) + else: + return (int(version[0]),) + + +def _get_custom_interpreter( + implementation: Optional[str] = None, version: Optional[str] = None +) -> str: + if implementation is None: + implementation = interpreter_name() + if version is None: + version = interpreter_version() + return f"{implementation}{version}" + + +def get_supported( + version: Optional[str] = None, + platforms: Optional[List[str]] = None, + impl: Optional[str] = None, + abis: Optional[List[str]] = None, +) -> List[Tag]: + """Return a list of supported tags for each version specified in + `versions`. + + :param version: a string version, of the form "33" or "32", + or None. The version will be assumed to support our ABI. + :param platform: specify a list of platforms you want valid + tags for, or None. If None, use the local system platform. + :param impl: specify the exact implementation you want valid + tags for, or None. If None, use the local interpreter impl. + :param abis: specify a list of abis you want valid + tags for, or None. If None, use the local interpreter abi. + """ + supported: List[Tag] = [] + + python_version: Optional[PythonVersion] = None + if version is not None: + python_version = _get_python_version(version) + + interpreter = _get_custom_interpreter(impl, version) + + platforms = _expand_allowed_platforms(platforms) + + is_cpython = (impl or interpreter_name()) == "cp" + if is_cpython: + supported.extend( + cpython_tags( + python_version=python_version, + abis=abis, + platforms=platforms, + ) + ) + else: + supported.extend( + generic_tags( + interpreter=interpreter, + abis=abis, + platforms=platforms, + ) + ) + supported.extend( + compatible_tags( + python_version=python_version, + interpreter=interpreter, + platforms=platforms, + ) + ) + + return supported diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/datetime.py b/env/lib/python3.12/site-packages/pip/_internal/utils/datetime.py new file mode 100644 index 0000000..8668b3b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/datetime.py @@ -0,0 +1,11 @@ +"""For when pip wants to check the date or time. +""" + +import datetime + + +def today_is_later_than(year: int, month: int, day: int) -> bool: + today = datetime.date.today() + given = datetime.date(year, month, day) + + return today > given diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/deprecation.py b/env/lib/python3.12/site-packages/pip/_internal/utils/deprecation.py new file mode 100644 index 0000000..0911147 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/deprecation.py @@ -0,0 +1,124 @@ +""" +A module that implements tooling to enable easy warnings about deprecations. +""" + +import logging +import warnings +from typing import Any, Optional, TextIO, Type, Union + +from pip._vendor.packaging.version import parse + +from pip import __version__ as current_version # NOTE: tests patch this name. + +DEPRECATION_MSG_PREFIX = "DEPRECATION: " + + +class PipDeprecationWarning(Warning): + pass + + +_original_showwarning: Any = None + + +# Warnings <-> Logging Integration +def _showwarning( + message: Union[Warning, str], + category: Type[Warning], + filename: str, + lineno: int, + file: Optional[TextIO] = None, + line: Optional[str] = None, +) -> None: + if file is not None: + if _original_showwarning is not None: + _original_showwarning(message, category, filename, lineno, file, line) + elif issubclass(category, PipDeprecationWarning): + # We use a specially named logger which will handle all of the + # deprecation messages for pip. + logger = logging.getLogger("pip._internal.deprecations") + logger.warning(message) + else: + _original_showwarning(message, category, filename, lineno, file, line) + + +def install_warning_logger() -> None: + # Enable our Deprecation Warnings + warnings.simplefilter("default", PipDeprecationWarning, append=True) + + global _original_showwarning + + if _original_showwarning is None: + _original_showwarning = warnings.showwarning + warnings.showwarning = _showwarning + + +def deprecated( + *, + reason: str, + replacement: Optional[str], + gone_in: Optional[str], + feature_flag: Optional[str] = None, + issue: Optional[int] = None, +) -> None: + """Helper to deprecate existing functionality. + + reason: + Textual reason shown to the user about why this functionality has + been deprecated. Should be a complete sentence. + replacement: + Textual suggestion shown to the user about what alternative + functionality they can use. + gone_in: + The version of pip does this functionality should get removed in. + Raises an error if pip's current version is greater than or equal to + this. + feature_flag: + Command-line flag of the form --use-feature={feature_flag} for testing + upcoming functionality. + issue: + Issue number on the tracker that would serve as a useful place for + users to find related discussion and provide feedback. + """ + + # Determine whether or not the feature is already gone in this version. + is_gone = gone_in is not None and parse(current_version) >= parse(gone_in) + + message_parts = [ + (reason, f"{DEPRECATION_MSG_PREFIX}{{}}"), + ( + gone_in, + ( + "pip {} will enforce this behaviour change." + if not is_gone + else "Since pip {}, this is no longer supported." + ), + ), + ( + replacement, + "A possible replacement is {}.", + ), + ( + feature_flag, + ( + "You can use the flag --use-feature={} to test the upcoming behaviour." + if not is_gone + else None + ), + ), + ( + issue, + "Discussion can be found at https://github.com/pypa/pip/issues/{}", + ), + ] + + message = " ".join( + format_str.format(value) + for value, format_str in message_parts + if format_str is not None and value is not None + ) + + # Raise as an error if this behaviour is deprecated. + if is_gone: + raise PipDeprecationWarning(message) + + warnings.warn(message, category=PipDeprecationWarning, stacklevel=2) diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/direct_url_helpers.py b/env/lib/python3.12/site-packages/pip/_internal/utils/direct_url_helpers.py new file mode 100644 index 0000000..66020d3 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/direct_url_helpers.py @@ -0,0 +1,87 @@ +from typing import Optional + +from pip._internal.models.direct_url import ArchiveInfo, DirectUrl, DirInfo, VcsInfo +from pip._internal.models.link import Link +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs import vcs + + +def direct_url_as_pep440_direct_reference(direct_url: DirectUrl, name: str) -> str: + """Convert a DirectUrl to a pip requirement string.""" + direct_url.validate() # if invalid, this is a pip bug + requirement = name + " @ " + fragments = [] + if isinstance(direct_url.info, VcsInfo): + requirement += ( + f"{direct_url.info.vcs}+{direct_url.url}@{direct_url.info.commit_id}" + ) + elif isinstance(direct_url.info, ArchiveInfo): + requirement += direct_url.url + if direct_url.info.hash: + fragments.append(direct_url.info.hash) + else: + assert isinstance(direct_url.info, DirInfo) + requirement += direct_url.url + if direct_url.subdirectory: + fragments.append("subdirectory=" + direct_url.subdirectory) + if fragments: + requirement += "#" + "&".join(fragments) + return requirement + + +def direct_url_for_editable(source_dir: str) -> DirectUrl: + return DirectUrl( + url=path_to_url(source_dir), + info=DirInfo(editable=True), + ) + + +def direct_url_from_link( + link: Link, source_dir: Optional[str] = None, link_is_in_wheel_cache: bool = False +) -> DirectUrl: + if link.is_vcs: + vcs_backend = vcs.get_backend_for_scheme(link.scheme) + assert vcs_backend + url, requested_revision, _ = vcs_backend.get_url_rev_and_auth( + link.url_without_fragment + ) + # For VCS links, we need to find out and add commit_id. + if link_is_in_wheel_cache: + # If the requested VCS link corresponds to a cached + # wheel, it means the requested revision was an + # immutable commit hash, otherwise it would not have + # been cached. In that case we don't have a source_dir + # with the VCS checkout. + assert requested_revision + commit_id = requested_revision + else: + # If the wheel was not in cache, it means we have + # had to checkout from VCS to build and we have a source_dir + # which we can inspect to find out the commit id. + assert source_dir + commit_id = vcs_backend.get_revision(source_dir) + return DirectUrl( + url=url, + info=VcsInfo( + vcs=vcs_backend.name, + commit_id=commit_id, + requested_revision=requested_revision, + ), + subdirectory=link.subdirectory_fragment, + ) + elif link.is_existing_dir(): + return DirectUrl( + url=link.url_without_fragment, + info=DirInfo(), + subdirectory=link.subdirectory_fragment, + ) + else: + hash = None + hash_name = link.hash_name + if hash_name: + hash = f"{hash_name}={link.hash}" + return DirectUrl( + url=link.url_without_fragment, + info=ArchiveInfo(hash=hash), + subdirectory=link.subdirectory_fragment, + ) diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/egg_link.py b/env/lib/python3.12/site-packages/pip/_internal/utils/egg_link.py new file mode 100644 index 0000000..4a384a6 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/egg_link.py @@ -0,0 +1,80 @@ +import os +import re +import sys +from typing import List, Optional + +from pip._internal.locations import site_packages, user_site +from pip._internal.utils.virtualenv import ( + running_under_virtualenv, + virtualenv_no_global, +) + +__all__ = [ + "egg_link_path_from_sys_path", + "egg_link_path_from_location", +] + + +def _egg_link_names(raw_name: str) -> List[str]: + """ + Convert a Name metadata value to a .egg-link name, by applying + the same substitution as pkg_resources's safe_name function. + Note: we cannot use canonicalize_name because it has a different logic. + + We also look for the raw name (without normalization) as setuptools 69 changed + the way it names .egg-link files (https://github.com/pypa/setuptools/issues/4167). + """ + return [ + re.sub("[^A-Za-z0-9.]+", "-", raw_name) + ".egg-link", + f"{raw_name}.egg-link", + ] + + +def egg_link_path_from_sys_path(raw_name: str) -> Optional[str]: + """ + Look for a .egg-link file for project name, by walking sys.path. + """ + egg_link_names = _egg_link_names(raw_name) + for path_item in sys.path: + for egg_link_name in egg_link_names: + egg_link = os.path.join(path_item, egg_link_name) + if os.path.isfile(egg_link): + return egg_link + return None + + +def egg_link_path_from_location(raw_name: str) -> Optional[str]: + """ + Return the path for the .egg-link file if it exists, otherwise, None. + + There's 3 scenarios: + 1) not in a virtualenv + try to find in site.USER_SITE, then site_packages + 2) in a no-global virtualenv + try to find in site_packages + 3) in a yes-global virtualenv + try to find in site_packages, then site.USER_SITE + (don't look in global location) + + For #1 and #3, there could be odd cases, where there's an egg-link in 2 + locations. + + This method will just return the first one found. + """ + sites: List[str] = [] + if running_under_virtualenv(): + sites.append(site_packages) + if not virtualenv_no_global() and user_site: + sites.append(user_site) + else: + if user_site: + sites.append(user_site) + sites.append(site_packages) + + egg_link_names = _egg_link_names(raw_name) + for site in sites: + for egg_link_name in egg_link_names: + egglink = os.path.join(site, egg_link_name) + if os.path.isfile(egglink): + return egglink + return None diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/entrypoints.py b/env/lib/python3.12/site-packages/pip/_internal/utils/entrypoints.py new file mode 100644 index 0000000..1501369 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/entrypoints.py @@ -0,0 +1,84 @@ +import itertools +import os +import shutil +import sys +from typing import List, Optional + +from pip._internal.cli.main import main +from pip._internal.utils.compat import WINDOWS + +_EXECUTABLE_NAMES = [ + "pip", + f"pip{sys.version_info.major}", + f"pip{sys.version_info.major}.{sys.version_info.minor}", +] +if WINDOWS: + _allowed_extensions = {"", ".exe"} + _EXECUTABLE_NAMES = [ + "".join(parts) + for parts in itertools.product(_EXECUTABLE_NAMES, _allowed_extensions) + ] + + +def _wrapper(args: Optional[List[str]] = None) -> int: + """Central wrapper for all old entrypoints. + + Historically pip has had several entrypoints defined. Because of issues + arising from PATH, sys.path, multiple Pythons, their interactions, and most + of them having a pip installed, users suffer every time an entrypoint gets + moved. + + To alleviate this pain, and provide a mechanism for warning users and + directing them to an appropriate place for help, we now define all of + our old entrypoints as wrappers for the current one. + """ + sys.stderr.write( + "WARNING: pip is being invoked by an old script wrapper. This will " + "fail in a future version of pip.\n" + "Please see https://github.com/pypa/pip/issues/5599 for advice on " + "fixing the underlying issue.\n" + "To avoid this problem you can invoke Python with '-m pip' instead of " + "running pip directly.\n" + ) + return main(args) + + +def get_best_invocation_for_this_pip() -> str: + """Try to figure out the best way to invoke pip in the current environment.""" + binary_directory = "Scripts" if WINDOWS else "bin" + binary_prefix = os.path.join(sys.prefix, binary_directory) + + # Try to use pip[X[.Y]] names, if those executables for this environment are + # the first on PATH with that name. + path_parts = os.path.normcase(os.environ.get("PATH", "")).split(os.pathsep) + exe_are_in_PATH = os.path.normcase(binary_prefix) in path_parts + if exe_are_in_PATH: + for exe_name in _EXECUTABLE_NAMES: + found_executable = shutil.which(exe_name) + binary_executable = os.path.join(binary_prefix, exe_name) + if ( + found_executable + and os.path.exists(binary_executable) + and os.path.samefile( + found_executable, + binary_executable, + ) + ): + return exe_name + + # Use the `-m` invocation, if there's no "nice" invocation. + return f"{get_best_invocation_for_this_python()} -m pip" + + +def get_best_invocation_for_this_python() -> str: + """Try to figure out the best way to invoke the current Python.""" + exe = sys.executable + exe_name = os.path.basename(exe) + + # Try to use the basename, if it's the first executable. + found_executable = shutil.which(exe_name) + if found_executable and os.path.samefile(found_executable, exe): + return exe_name + + # Use the full executable name, because we couldn't find something simpler. + return exe diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/filesystem.py b/env/lib/python3.12/site-packages/pip/_internal/utils/filesystem.py new file mode 100644 index 0000000..22e356c --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/filesystem.py @@ -0,0 +1,149 @@ +import fnmatch +import os +import os.path +import random +import sys +from contextlib import contextmanager +from tempfile import NamedTemporaryFile +from typing import Any, BinaryIO, Generator, List, Union, cast + +from pip._internal.utils.compat import get_path_uid +from pip._internal.utils.misc import format_size +from pip._internal.utils.retry import retry + + +def check_path_owner(path: str) -> bool: + # If we don't have a way to check the effective uid of this process, then + # we'll just assume that we own the directory. + if sys.platform == "win32" or not hasattr(os, "geteuid"): + return True + + assert os.path.isabs(path) + + previous = None + while path != previous: + if os.path.lexists(path): + # Check if path is writable by current user. + if os.geteuid() == 0: + # Special handling for root user in order to handle properly + # cases where users use sudo without -H flag. + try: + path_uid = get_path_uid(path) + except OSError: + return False + return path_uid == 0 + else: + return os.access(path, os.W_OK) + else: + previous, path = path, os.path.dirname(path) + return False # assume we don't own the path + + +@contextmanager +def adjacent_tmp_file(path: str, **kwargs: Any) -> Generator[BinaryIO, None, None]: + """Return a file-like object pointing to a tmp file next to path. + + The file is created securely and is ensured to be written to disk + after the context reaches its end. + + kwargs will be passed to tempfile.NamedTemporaryFile to control + the way the temporary file will be opened. + """ + with NamedTemporaryFile( + delete=False, + dir=os.path.dirname(path), + prefix=os.path.basename(path), + suffix=".tmp", + **kwargs, + ) as f: + result = cast(BinaryIO, f) + try: + yield result + finally: + result.flush() + os.fsync(result.fileno()) + + +replace = retry(stop_after_delay=1, wait=0.25)(os.replace) + + +# test_writable_dir and _test_writable_dir_win are copied from Flit, +# with the author's agreement to also place them under pip's license. +def test_writable_dir(path: str) -> bool: + """Check if a directory is writable. + + Uses os.access() on POSIX, tries creating files on Windows. + """ + # If the directory doesn't exist, find the closest parent that does. + while not os.path.isdir(path): + parent = os.path.dirname(path) + if parent == path: + break # Should never get here, but infinite loops are bad + path = parent + + if os.name == "posix": + return os.access(path, os.W_OK) + + return _test_writable_dir_win(path) + + +def _test_writable_dir_win(path: str) -> bool: + # os.access doesn't work on Windows: http://bugs.python.org/issue2528 + # and we can't use tempfile: http://bugs.python.org/issue22107 + basename = "accesstest_deleteme_fishfingers_custard_" + alphabet = "abcdefghijklmnopqrstuvwxyz0123456789" + for _ in range(10): + name = basename + "".join(random.choice(alphabet) for _ in range(6)) + file = os.path.join(path, name) + try: + fd = os.open(file, os.O_RDWR | os.O_CREAT | os.O_EXCL) + except FileExistsError: + pass + except PermissionError: + # This could be because there's a directory with the same name. + # But it's highly unlikely there's a directory called that, + # so we'll assume it's because the parent dir is not writable. + # This could as well be because the parent dir is not readable, + # due to non-privileged user access. + return False + else: + os.close(fd) + os.unlink(file) + return True + + # This should never be reached + raise OSError("Unexpected condition testing for writable directory") + + +def find_files(path: str, pattern: str) -> List[str]: + """Returns a list of absolute paths of files beneath path, recursively, + with filenames which match the UNIX-style shell glob pattern.""" + result: List[str] = [] + for root, _, files in os.walk(path): + matches = fnmatch.filter(files, pattern) + result.extend(os.path.join(root, f) for f in matches) + return result + + +def file_size(path: str) -> Union[int, float]: + # If it's a symlink, return 0. + if os.path.islink(path): + return 0 + return os.path.getsize(path) + + +def format_file_size(path: str) -> str: + return format_size(file_size(path)) + + +def directory_size(path: str) -> Union[int, float]: + size = 0.0 + for root, _dirs, files in os.walk(path): + for filename in files: + file_path = os.path.join(root, filename) + size += file_size(file_path) + return size + + +def format_directory_size(path: str) -> str: + return format_size(directory_size(path)) diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/filetypes.py b/env/lib/python3.12/site-packages/pip/_internal/utils/filetypes.py new file mode 100644 index 0000000..5948570 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/filetypes.py @@ -0,0 +1,27 @@ +"""Filetype information. +""" + +from typing import Tuple + +from pip._internal.utils.misc import splitext + +WHEEL_EXTENSION = ".whl" +BZ2_EXTENSIONS: Tuple[str, ...] = (".tar.bz2", ".tbz") +XZ_EXTENSIONS: Tuple[str, ...] = ( + ".tar.xz", + ".txz", + ".tlz", + ".tar.lz", + ".tar.lzma", +) +ZIP_EXTENSIONS: Tuple[str, ...] = (".zip", WHEEL_EXTENSION) +TAR_EXTENSIONS: Tuple[str, ...] = (".tar.gz", ".tgz", ".tar") +ARCHIVE_EXTENSIONS = ZIP_EXTENSIONS + BZ2_EXTENSIONS + TAR_EXTENSIONS + XZ_EXTENSIONS + + +def is_archive_file(name: str) -> bool: + """Return True if `name` is a considered as an archive file.""" + ext = splitext(name)[1].lower() + if ext in ARCHIVE_EXTENSIONS: + return True + return False diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/glibc.py b/env/lib/python3.12/site-packages/pip/_internal/utils/glibc.py new file mode 100644 index 0000000..998868f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/glibc.py @@ -0,0 +1,101 @@ +import os +import sys +from typing import Optional, Tuple + + +def glibc_version_string() -> Optional[str]: + "Returns glibc version string, or None if not using glibc." + return glibc_version_string_confstr() or glibc_version_string_ctypes() + + +def glibc_version_string_confstr() -> Optional[str]: + "Primary implementation of glibc_version_string using os.confstr." + # os.confstr is quite a bit faster than ctypes.DLL. It's also less likely + # to be broken or missing. This strategy is used in the standard library + # platform module: + # https://github.com/python/cpython/blob/fcf1d003bf4f0100c9d0921ff3d70e1127ca1b71/Lib/platform.py#L175-L183 + if sys.platform == "win32": + return None + try: + gnu_libc_version = os.confstr("CS_GNU_LIBC_VERSION") + if gnu_libc_version is None: + return None + # os.confstr("CS_GNU_LIBC_VERSION") returns a string like "glibc 2.17": + _, version = gnu_libc_version.split() + except (AttributeError, OSError, ValueError): + # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)... + return None + return version + + +def glibc_version_string_ctypes() -> Optional[str]: + "Fallback implementation of glibc_version_string using ctypes." + + try: + import ctypes + except ImportError: + return None + + # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen + # manpage says, "If filename is NULL, then the returned handle is for the + # main program". This way we can let the linker do the work to figure out + # which libc our process is actually using. + # + # We must also handle the special case where the executable is not a + # dynamically linked executable. This can occur when using musl libc, + # for example. In this situation, dlopen() will error, leading to an + # OSError. Interestingly, at least in the case of musl, there is no + # errno set on the OSError. The single string argument used to construct + # OSError comes from libc itself and is therefore not portable to + # hard code here. In any case, failure to call dlopen() means we + # can't proceed, so we bail on our attempt. + try: + process_namespace = ctypes.CDLL(None) + except OSError: + return None + + try: + gnu_get_libc_version = process_namespace.gnu_get_libc_version + except AttributeError: + # Symbol doesn't exist -> therefore, we are not linked to + # glibc. + return None + + # Call gnu_get_libc_version, which returns a string like "2.5" + gnu_get_libc_version.restype = ctypes.c_char_p + version_str: str = gnu_get_libc_version() + # py2 / py3 compatibility: + if not isinstance(version_str, str): + version_str = version_str.decode("ascii") + + return version_str + + +# platform.libc_ver regularly returns completely nonsensical glibc +# versions. E.g. on my computer, platform says: +# +# ~$ python2.7 -c 'import platform; print(platform.libc_ver())' +# ('glibc', '2.7') +# ~$ python3.5 -c 'import platform; print(platform.libc_ver())' +# ('glibc', '2.9') +# +# But the truth is: +# +# ~$ ldd --version +# ldd (Debian GLIBC 2.22-11) 2.22 +# +# This is unfortunate, because it means that the linehaul data on libc +# versions that was generated by pip 8.1.2 and earlier is useless and +# misleading. Solution: instead of using platform, use our code that actually +# works. +def libc_ver() -> Tuple[str, str]: + """Try to determine the glibc version + + Returns a tuple of strings (lib, version) which default to empty strings + in case the lookup fails. + """ + glibc_version = glibc_version_string() + if glibc_version is None: + return ("", "") + else: + return ("glibc", glibc_version) diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/hashes.py b/env/lib/python3.12/site-packages/pip/_internal/utils/hashes.py new file mode 100644 index 0000000..535e94f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/hashes.py @@ -0,0 +1,147 @@ +import hashlib +from typing import TYPE_CHECKING, BinaryIO, Dict, Iterable, List, NoReturn, Optional + +from pip._internal.exceptions import HashMismatch, HashMissing, InstallationError +from pip._internal.utils.misc import read_chunks + +if TYPE_CHECKING: + from hashlib import _Hash + + +# The recommended hash algo of the moment. Change this whenever the state of +# the art changes; it won't hurt backward compatibility. +FAVORITE_HASH = "sha256" + + +# Names of hashlib algorithms allowed by the --hash option and ``pip hash`` +# Currently, those are the ones at least as collision-resistant as sha256. +STRONG_HASHES = ["sha256", "sha384", "sha512"] + + +class Hashes: + """A wrapper that builds multiple hashes at once and checks them against + known-good values + + """ + + def __init__(self, hashes: Optional[Dict[str, List[str]]] = None) -> None: + """ + :param hashes: A dict of algorithm names pointing to lists of allowed + hex digests + """ + allowed = {} + if hashes is not None: + for alg, keys in hashes.items(): + # Make sure values are always sorted (to ease equality checks) + allowed[alg] = [k.lower() for k in sorted(keys)] + self._allowed = allowed + + def __and__(self, other: "Hashes") -> "Hashes": + if not isinstance(other, Hashes): + return NotImplemented + + # If either of the Hashes object is entirely empty (i.e. no hash + # specified at all), all hashes from the other object are allowed. + if not other: + return self + if not self: + return other + + # Otherwise only hashes that present in both objects are allowed. + new = {} + for alg, values in other._allowed.items(): + if alg not in self._allowed: + continue + new[alg] = [v for v in values if v in self._allowed[alg]] + return Hashes(new) + + @property + def digest_count(self) -> int: + return sum(len(digests) for digests in self._allowed.values()) + + def is_hash_allowed(self, hash_name: str, hex_digest: str) -> bool: + """Return whether the given hex digest is allowed.""" + return hex_digest in self._allowed.get(hash_name, []) + + def check_against_chunks(self, chunks: Iterable[bytes]) -> None: + """Check good hashes against ones built from iterable of chunks of + data. + + Raise HashMismatch if none match. + + """ + gots = {} + for hash_name in self._allowed.keys(): + try: + gots[hash_name] = hashlib.new(hash_name) + except (ValueError, TypeError): + raise InstallationError(f"Unknown hash name: {hash_name}") + + for chunk in chunks: + for hash in gots.values(): + hash.update(chunk) + + for hash_name, got in gots.items(): + if got.hexdigest() in self._allowed[hash_name]: + return + self._raise(gots) + + def _raise(self, gots: Dict[str, "_Hash"]) -> "NoReturn": + raise HashMismatch(self._allowed, gots) + + def check_against_file(self, file: BinaryIO) -> None: + """Check good hashes against a file-like object + + Raise HashMismatch if none match. + + """ + return self.check_against_chunks(read_chunks(file)) + + def check_against_path(self, path: str) -> None: + with open(path, "rb") as file: + return self.check_against_file(file) + + def has_one_of(self, hashes: Dict[str, str]) -> bool: + """Return whether any of the given hashes are allowed.""" + for hash_name, hex_digest in hashes.items(): + if self.is_hash_allowed(hash_name, hex_digest): + return True + return False + + def __bool__(self) -> bool: + """Return whether I know any known-good hashes.""" + return bool(self._allowed) + + def __eq__(self, other: object) -> bool: + if not isinstance(other, Hashes): + return NotImplemented + return self._allowed == other._allowed + + def __hash__(self) -> int: + return hash( + ",".join( + sorted( + ":".join((alg, digest)) + for alg, digest_list in self._allowed.items() + for digest in digest_list + ) + ) + ) + + +class MissingHashes(Hashes): + """A workalike for Hashes used when we're missing a hash for a requirement + + It computes the actual hash of the requirement and raises a HashMissing + exception showing it to the user. + + """ + + def __init__(self) -> None: + """Don't offer the ``hashes`` kwarg.""" + # Pass our favorite hash in to generate a "gotten hash". With the + # empty list, it will never match, so an error will always raise. + super().__init__(hashes={FAVORITE_HASH: []}) + + def _raise(self, gots: Dict[str, "_Hash"]) -> "NoReturn": + raise HashMissing(gots[FAVORITE_HASH].hexdigest()) diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/logging.py b/env/lib/python3.12/site-packages/pip/_internal/utils/logging.py new file mode 100644 index 0000000..62035fc --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/logging.py @@ -0,0 +1,354 @@ +import contextlib +import errno +import logging +import logging.handlers +import os +import sys +import threading +from dataclasses import dataclass +from io import TextIOWrapper +from logging import Filter +from typing import Any, ClassVar, Generator, List, Optional, TextIO, Type + +from pip._vendor.rich.console import ( + Console, + ConsoleOptions, + ConsoleRenderable, + RenderableType, + RenderResult, + RichCast, +) +from pip._vendor.rich.highlighter import NullHighlighter +from pip._vendor.rich.logging import RichHandler +from pip._vendor.rich.segment import Segment +from pip._vendor.rich.style import Style + +from pip._internal.utils._log import VERBOSE, getLogger +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.deprecation import DEPRECATION_MSG_PREFIX +from pip._internal.utils.misc import ensure_dir + +_log_state = threading.local() +subprocess_logger = getLogger("pip.subprocessor") + + +class BrokenStdoutLoggingError(Exception): + """ + Raised if BrokenPipeError occurs for the stdout stream while logging. + """ + + +def _is_broken_pipe_error(exc_class: Type[BaseException], exc: BaseException) -> bool: + if exc_class is BrokenPipeError: + return True + + # On Windows, a broken pipe can show up as EINVAL rather than EPIPE: + # https://bugs.python.org/issue19612 + # https://bugs.python.org/issue30418 + if not WINDOWS: + return False + + return isinstance(exc, OSError) and exc.errno in (errno.EINVAL, errno.EPIPE) + + +@contextlib.contextmanager +def indent_log(num: int = 2) -> Generator[None, None, None]: + """ + A context manager which will cause the log output to be indented for any + log messages emitted inside it. + """ + # For thread-safety + _log_state.indentation = get_indentation() + _log_state.indentation += num + try: + yield + finally: + _log_state.indentation -= num + + +def get_indentation() -> int: + return getattr(_log_state, "indentation", 0) + + +class IndentingFormatter(logging.Formatter): + default_time_format = "%Y-%m-%dT%H:%M:%S" + + def __init__( + self, + *args: Any, + add_timestamp: bool = False, + **kwargs: Any, + ) -> None: + """ + A logging.Formatter that obeys the indent_log() context manager. + + :param add_timestamp: A bool indicating output lines should be prefixed + with their record's timestamp. + """ + self.add_timestamp = add_timestamp + super().__init__(*args, **kwargs) + + def get_message_start(self, formatted: str, levelno: int) -> str: + """ + Return the start of the formatted log message (not counting the + prefix to add to each line). + """ + if levelno < logging.WARNING: + return "" + if formatted.startswith(DEPRECATION_MSG_PREFIX): + # Then the message already has a prefix. We don't want it to + # look like "WARNING: DEPRECATION: ...." + return "" + if levelno < logging.ERROR: + return "WARNING: " + + return "ERROR: " + + def format(self, record: logging.LogRecord) -> str: + """ + Calls the standard formatter, but will indent all of the log message + lines by our current indentation level. + """ + formatted = super().format(record) + message_start = self.get_message_start(formatted, record.levelno) + formatted = message_start + formatted + + prefix = "" + if self.add_timestamp: + prefix = f"{self.formatTime(record)} " + prefix += " " * get_indentation() + formatted = "".join([prefix + line for line in formatted.splitlines(True)]) + return formatted + + +@dataclass +class IndentedRenderable: + renderable: RenderableType + indent: int + + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> RenderResult: + segments = console.render(self.renderable, options) + lines = Segment.split_lines(segments) + for line in lines: + yield Segment(" " * self.indent) + yield from line + yield Segment("\n") + + +class PipConsole(Console): + def on_broken_pipe(self) -> None: + # Reraise the original exception, rich 13.8.0+ exits by default + # instead, preventing our handler from firing. + raise BrokenPipeError() from None + + +class RichPipStreamHandler(RichHandler): + KEYWORDS: ClassVar[Optional[List[str]]] = [] + + def __init__(self, stream: Optional[TextIO], no_color: bool) -> None: + super().__init__( + console=PipConsole(file=stream, no_color=no_color, soft_wrap=True), + show_time=False, + show_level=False, + show_path=False, + highlighter=NullHighlighter(), + ) + + # Our custom override on Rich's logger, to make things work as we need them to. + def emit(self, record: logging.LogRecord) -> None: + style: Optional[Style] = None + + # If we are given a diagnostic error to present, present it with indentation. + if getattr(record, "rich", False): + assert isinstance(record.args, tuple) + (rich_renderable,) = record.args + assert isinstance( + rich_renderable, (ConsoleRenderable, RichCast, str) + ), f"{rich_renderable} is not rich-console-renderable" + + renderable: RenderableType = IndentedRenderable( + rich_renderable, indent=get_indentation() + ) + else: + message = self.format(record) + renderable = self.render_message(record, message) + if record.levelno is not None: + if record.levelno >= logging.ERROR: + style = Style(color="red") + elif record.levelno >= logging.WARNING: + style = Style(color="yellow") + + try: + self.console.print(renderable, overflow="ignore", crop=False, style=style) + except Exception: + self.handleError(record) + + def handleError(self, record: logging.LogRecord) -> None: + """Called when logging is unable to log some output.""" + + exc_class, exc = sys.exc_info()[:2] + # If a broken pipe occurred while calling write() or flush() on the + # stdout stream in logging's Handler.emit(), then raise our special + # exception so we can handle it in main() instead of logging the + # broken pipe error and continuing. + if ( + exc_class + and exc + and self.console.file is sys.stdout + and _is_broken_pipe_error(exc_class, exc) + ): + raise BrokenStdoutLoggingError() + + return super().handleError(record) + + +class BetterRotatingFileHandler(logging.handlers.RotatingFileHandler): + def _open(self) -> TextIOWrapper: + ensure_dir(os.path.dirname(self.baseFilename)) + return super()._open() + + +class MaxLevelFilter(Filter): + def __init__(self, level: int) -> None: + self.level = level + + def filter(self, record: logging.LogRecord) -> bool: + return record.levelno < self.level + + +class ExcludeLoggerFilter(Filter): + """ + A logging Filter that excludes records from a logger (or its children). + """ + + def filter(self, record: logging.LogRecord) -> bool: + # The base Filter class allows only records from a logger (or its + # children). + return not super().filter(record) + + +def setup_logging(verbosity: int, no_color: bool, user_log_file: Optional[str]) -> int: + """Configures and sets up all of the logging + + Returns the requested logging level, as its integer value. + """ + + # Determine the level to be logging at. + if verbosity >= 2: + level_number = logging.DEBUG + elif verbosity == 1: + level_number = VERBOSE + elif verbosity == -1: + level_number = logging.WARNING + elif verbosity == -2: + level_number = logging.ERROR + elif verbosity <= -3: + level_number = logging.CRITICAL + else: + level_number = logging.INFO + + level = logging.getLevelName(level_number) + + # The "root" logger should match the "console" level *unless* we also need + # to log to a user log file. + include_user_log = user_log_file is not None + if include_user_log: + additional_log_file = user_log_file + root_level = "DEBUG" + else: + additional_log_file = "/dev/null" + root_level = level + + # Disable any logging besides WARNING unless we have DEBUG level logging + # enabled for vendored libraries. + vendored_log_level = "WARNING" if level in ["INFO", "ERROR"] else "DEBUG" + + # Shorthands for clarity + log_streams = { + "stdout": "ext://sys.stdout", + "stderr": "ext://sys.stderr", + } + handler_classes = { + "stream": "pip._internal.utils.logging.RichPipStreamHandler", + "file": "pip._internal.utils.logging.BetterRotatingFileHandler", + } + handlers = ["console", "console_errors", "console_subprocess"] + ( + ["user_log"] if include_user_log else [] + ) + + logging.config.dictConfig( + { + "version": 1, + "disable_existing_loggers": False, + "filters": { + "exclude_warnings": { + "()": "pip._internal.utils.logging.MaxLevelFilter", + "level": logging.WARNING, + }, + "restrict_to_subprocess": { + "()": "logging.Filter", + "name": subprocess_logger.name, + }, + "exclude_subprocess": { + "()": "pip._internal.utils.logging.ExcludeLoggerFilter", + "name": subprocess_logger.name, + }, + }, + "formatters": { + "indent": { + "()": IndentingFormatter, + "format": "%(message)s", + }, + "indent_with_timestamp": { + "()": IndentingFormatter, + "format": "%(message)s", + "add_timestamp": True, + }, + }, + "handlers": { + "console": { + "level": level, + "class": handler_classes["stream"], + "no_color": no_color, + "stream": log_streams["stdout"], + "filters": ["exclude_subprocess", "exclude_warnings"], + "formatter": "indent", + }, + "console_errors": { + "level": "WARNING", + "class": handler_classes["stream"], + "no_color": no_color, + "stream": log_streams["stderr"], + "filters": ["exclude_subprocess"], + "formatter": "indent", + }, + # A handler responsible for logging to the console messages + # from the "subprocessor" logger. + "console_subprocess": { + "level": level, + "class": handler_classes["stream"], + "stream": log_streams["stderr"], + "no_color": no_color, + "filters": ["restrict_to_subprocess"], + "formatter": "indent", + }, + "user_log": { + "level": "DEBUG", + "class": handler_classes["file"], + "filename": additional_log_file, + "encoding": "utf-8", + "delay": True, + "formatter": "indent_with_timestamp", + }, + }, + "root": { + "level": root_level, + "handlers": handlers, + }, + "loggers": {"pip._vendor": {"level": vendored_log_level}}, + } + ) + + return level_number diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/misc.py b/env/lib/python3.12/site-packages/pip/_internal/utils/misc.py new file mode 100644 index 0000000..44f6a05 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/misc.py @@ -0,0 +1,773 @@ +import errno +import getpass +import hashlib +import logging +import os +import posixpath +import shutil +import stat +import sys +import sysconfig +import urllib.parse +from dataclasses import dataclass +from functools import partial +from io import StringIO +from itertools import filterfalse, tee, zip_longest +from pathlib import Path +from types import FunctionType, TracebackType +from typing import ( + Any, + BinaryIO, + Callable, + Generator, + Iterable, + Iterator, + List, + Mapping, + Optional, + Sequence, + TextIO, + Tuple, + Type, + TypeVar, + Union, + cast, +) + +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip import __version__ +from pip._internal.exceptions import CommandError, ExternallyManagedEnvironment +from pip._internal.locations import get_major_minor_version +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.retry import retry +from pip._internal.utils.virtualenv import running_under_virtualenv + +__all__ = [ + "rmtree", + "display_path", + "backup_dir", + "ask", + "splitext", + "format_size", + "is_installable_dir", + "normalize_path", + "renames", + "get_prog", + "ensure_dir", + "remove_auth_from_url", + "check_externally_managed", + "ConfiguredBuildBackendHookCaller", +] + +logger = logging.getLogger(__name__) + +T = TypeVar("T") +ExcInfo = Tuple[Type[BaseException], BaseException, TracebackType] +VersionInfo = Tuple[int, int, int] +NetlocTuple = Tuple[str, Tuple[Optional[str], Optional[str]]] +OnExc = Callable[[FunctionType, Path, BaseException], Any] +OnErr = Callable[[FunctionType, Path, ExcInfo], Any] + +FILE_CHUNK_SIZE = 1024 * 1024 + + +def get_pip_version() -> str: + pip_pkg_dir = os.path.join(os.path.dirname(__file__), "..", "..") + pip_pkg_dir = os.path.abspath(pip_pkg_dir) + + return f"pip {__version__} from {pip_pkg_dir} (python {get_major_minor_version()})" + + +def normalize_version_info(py_version_info: Tuple[int, ...]) -> Tuple[int, int, int]: + """ + Convert a tuple of ints representing a Python version to one of length + three. + + :param py_version_info: a tuple of ints representing a Python version, + or None to specify no version. The tuple can have any length. + + :return: a tuple of length three if `py_version_info` is non-None. + Otherwise, return `py_version_info` unchanged (i.e. None). + """ + if len(py_version_info) < 3: + py_version_info += (3 - len(py_version_info)) * (0,) + elif len(py_version_info) > 3: + py_version_info = py_version_info[:3] + + return cast("VersionInfo", py_version_info) + + +def ensure_dir(path: str) -> None: + """os.path.makedirs without EEXIST.""" + try: + os.makedirs(path) + except OSError as e: + # Windows can raise spurious ENOTEMPTY errors. See #6426. + if e.errno != errno.EEXIST and e.errno != errno.ENOTEMPTY: + raise + + +def get_prog() -> str: + try: + prog = os.path.basename(sys.argv[0]) + if prog in ("__main__.py", "-c"): + return f"{sys.executable} -m pip" + else: + return prog + except (AttributeError, TypeError, IndexError): + pass + return "pip" + + +# Retry every half second for up to 3 seconds +@retry(stop_after_delay=3, wait=0.5) +def rmtree( + dir: str, ignore_errors: bool = False, onexc: Optional[OnExc] = None +) -> None: + if ignore_errors: + onexc = _onerror_ignore + if onexc is None: + onexc = _onerror_reraise + handler: OnErr = partial(rmtree_errorhandler, onexc=onexc) + if sys.version_info >= (3, 12): + # See https://docs.python.org/3.12/whatsnew/3.12.html#shutil. + shutil.rmtree(dir, onexc=handler) # type: ignore + else: + shutil.rmtree(dir, onerror=handler) # type: ignore + + +def _onerror_ignore(*_args: Any) -> None: + pass + + +def _onerror_reraise(*_args: Any) -> None: + raise # noqa: PLE0704 - Bare exception used to reraise existing exception + + +def rmtree_errorhandler( + func: FunctionType, + path: Path, + exc_info: Union[ExcInfo, BaseException], + *, + onexc: OnExc = _onerror_reraise, +) -> None: + """ + `rmtree` error handler to 'force' a file remove (i.e. like `rm -f`). + + * If a file is readonly then it's write flag is set and operation is + retried. + + * `onerror` is the original callback from `rmtree(... onerror=onerror)` + that is chained at the end if the "rm -f" still fails. + """ + try: + st_mode = os.stat(path).st_mode + except OSError: + # it's equivalent to os.path.exists + return + + if not st_mode & stat.S_IWRITE: + # convert to read/write + try: + os.chmod(path, st_mode | stat.S_IWRITE) + except OSError: + pass + else: + # use the original function to repeat the operation + try: + func(path) + return + except OSError: + pass + + if not isinstance(exc_info, BaseException): + _, exc_info, _ = exc_info + onexc(func, path, exc_info) + + +def display_path(path: str) -> str: + """Gives the display value for a given path, making it relative to cwd + if possible.""" + path = os.path.normcase(os.path.abspath(path)) + if path.startswith(os.getcwd() + os.path.sep): + path = "." + path[len(os.getcwd()) :] + return path + + +def backup_dir(dir: str, ext: str = ".bak") -> str: + """Figure out the name of a directory to back up the given dir to + (adding .bak, .bak2, etc)""" + n = 1 + extension = ext + while os.path.exists(dir + extension): + n += 1 + extension = ext + str(n) + return dir + extension + + +def ask_path_exists(message: str, options: Iterable[str]) -> str: + for action in os.environ.get("PIP_EXISTS_ACTION", "").split(): + if action in options: + return action + return ask(message, options) + + +def _check_no_input(message: str) -> None: + """Raise an error if no input is allowed.""" + if os.environ.get("PIP_NO_INPUT"): + raise Exception( + f"No input was expected ($PIP_NO_INPUT set); question: {message}" + ) + + +def ask(message: str, options: Iterable[str]) -> str: + """Ask the message interactively, with the given possible responses""" + while 1: + _check_no_input(message) + response = input(message) + response = response.strip().lower() + if response not in options: + print( + "Your response ({!r}) was not one of the expected responses: " + "{}".format(response, ", ".join(options)) + ) + else: + return response + + +def ask_input(message: str) -> str: + """Ask for input interactively.""" + _check_no_input(message) + return input(message) + + +def ask_password(message: str) -> str: + """Ask for a password interactively.""" + _check_no_input(message) + return getpass.getpass(message) + + +def strtobool(val: str) -> int: + """Convert a string representation of truth to true (1) or false (0). + + True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values + are 'n', 'no', 'f', 'false', 'off', and '0'. Raises ValueError if + 'val' is anything else. + """ + val = val.lower() + if val in ("y", "yes", "t", "true", "on", "1"): + return 1 + elif val in ("n", "no", "f", "false", "off", "0"): + return 0 + else: + raise ValueError(f"invalid truth value {val!r}") + + +def format_size(bytes: float) -> str: + if bytes > 1000 * 1000: + return f"{bytes / 1000.0 / 1000:.1f} MB" + elif bytes > 10 * 1000: + return f"{int(bytes / 1000)} kB" + elif bytes > 1000: + return f"{bytes / 1000.0:.1f} kB" + else: + return f"{int(bytes)} bytes" + + +def tabulate(rows: Iterable[Iterable[Any]]) -> Tuple[List[str], List[int]]: + """Return a list of formatted rows and a list of column sizes. + + For example:: + + >>> tabulate([['foobar', 2000], [0xdeadbeef]]) + (['foobar 2000', '3735928559'], [10, 4]) + """ + rows = [tuple(map(str, row)) for row in rows] + sizes = [max(map(len, col)) for col in zip_longest(*rows, fillvalue="")] + table = [" ".join(map(str.ljust, row, sizes)).rstrip() for row in rows] + return table, sizes + + +def is_installable_dir(path: str) -> bool: + """Is path is a directory containing pyproject.toml or setup.py? + + If pyproject.toml exists, this is a PEP 517 project. Otherwise we look for + a legacy setuptools layout by identifying setup.py. We don't check for the + setup.cfg because using it without setup.py is only available for PEP 517 + projects, which are already covered by the pyproject.toml check. + """ + if not os.path.isdir(path): + return False + if os.path.isfile(os.path.join(path, "pyproject.toml")): + return True + if os.path.isfile(os.path.join(path, "setup.py")): + return True + return False + + +def read_chunks( + file: BinaryIO, size: int = FILE_CHUNK_SIZE +) -> Generator[bytes, None, None]: + """Yield pieces of data from a file-like object until EOF.""" + while True: + chunk = file.read(size) + if not chunk: + break + yield chunk + + +def normalize_path(path: str, resolve_symlinks: bool = True) -> str: + """ + Convert a path to its canonical, case-normalized, absolute version. + + """ + path = os.path.expanduser(path) + if resolve_symlinks: + path = os.path.realpath(path) + else: + path = os.path.abspath(path) + return os.path.normcase(path) + + +def splitext(path: str) -> Tuple[str, str]: + """Like os.path.splitext, but take off .tar too""" + base, ext = posixpath.splitext(path) + if base.lower().endswith(".tar"): + ext = base[-4:] + ext + base = base[:-4] + return base, ext + + +def renames(old: str, new: str) -> None: + """Like os.renames(), but handles renaming across devices.""" + # Implementation borrowed from os.renames(). + head, tail = os.path.split(new) + if head and tail and not os.path.exists(head): + os.makedirs(head) + + shutil.move(old, new) + + head, tail = os.path.split(old) + if head and tail: + try: + os.removedirs(head) + except OSError: + pass + + +def is_local(path: str) -> bool: + """ + Return True if path is within sys.prefix, if we're running in a virtualenv. + + If we're not in a virtualenv, all paths are considered "local." + + Caution: this function assumes the head of path has been normalized + with normalize_path. + """ + if not running_under_virtualenv(): + return True + return path.startswith(normalize_path(sys.prefix)) + + +def write_output(msg: Any, *args: Any) -> None: + logger.info(msg, *args) + + +class StreamWrapper(StringIO): + orig_stream: TextIO + + @classmethod + def from_stream(cls, orig_stream: TextIO) -> "StreamWrapper": + ret = cls() + ret.orig_stream = orig_stream + return ret + + # compileall.compile_dir() needs stdout.encoding to print to stdout + # type ignore is because TextIOBase.encoding is writeable + @property + def encoding(self) -> str: # type: ignore + return self.orig_stream.encoding + + +# Simulates an enum +def enum(*sequential: Any, **named: Any) -> Type[Any]: + enums = dict(zip(sequential, range(len(sequential))), **named) + reverse = {value: key for key, value in enums.items()} + enums["reverse_mapping"] = reverse + return type("Enum", (), enums) + + +def build_netloc(host: str, port: Optional[int]) -> str: + """ + Build a netloc from a host-port pair + """ + if port is None: + return host + if ":" in host: + # Only wrap host with square brackets when it is IPv6 + host = f"[{host}]" + return f"{host}:{port}" + + +def build_url_from_netloc(netloc: str, scheme: str = "https") -> str: + """ + Build a full URL from a netloc. + """ + if netloc.count(":") >= 2 and "@" not in netloc and "[" not in netloc: + # It must be a bare IPv6 address, so wrap it with brackets. + netloc = f"[{netloc}]" + return f"{scheme}://{netloc}" + + +def parse_netloc(netloc: str) -> Tuple[Optional[str], Optional[int]]: + """ + Return the host-port pair from a netloc. + """ + url = build_url_from_netloc(netloc) + parsed = urllib.parse.urlparse(url) + return parsed.hostname, parsed.port + + +def split_auth_from_netloc(netloc: str) -> NetlocTuple: + """ + Parse out and remove the auth information from a netloc. + + Returns: (netloc, (username, password)). + """ + if "@" not in netloc: + return netloc, (None, None) + + # Split from the right because that's how urllib.parse.urlsplit() + # behaves if more than one @ is present (which can be checked using + # the password attribute of urlsplit()'s return value). + auth, netloc = netloc.rsplit("@", 1) + pw: Optional[str] = None + if ":" in auth: + # Split from the left because that's how urllib.parse.urlsplit() + # behaves if more than one : is present (which again can be checked + # using the password attribute of the return value) + user, pw = auth.split(":", 1) + else: + user, pw = auth, None + + user = urllib.parse.unquote(user) + if pw is not None: + pw = urllib.parse.unquote(pw) + + return netloc, (user, pw) + + +def redact_netloc(netloc: str) -> str: + """ + Replace the sensitive data in a netloc with "****", if it exists. + + For example: + - "user:pass@example.com" returns "user:****@example.com" + - "accesstoken@example.com" returns "****@example.com" + """ + netloc, (user, password) = split_auth_from_netloc(netloc) + if user is None: + return netloc + if password is None: + user = "****" + password = "" + else: + user = urllib.parse.quote(user) + password = ":****" + return f"{user}{password}@{netloc}" + + +def _transform_url( + url: str, transform_netloc: Callable[[str], Tuple[Any, ...]] +) -> Tuple[str, NetlocTuple]: + """Transform and replace netloc in a url. + + transform_netloc is a function taking the netloc and returning a + tuple. The first element of this tuple is the new netloc. The + entire tuple is returned. + + Returns a tuple containing the transformed url as item 0 and the + original tuple returned by transform_netloc as item 1. + """ + purl = urllib.parse.urlsplit(url) + netloc_tuple = transform_netloc(purl.netloc) + # stripped url + url_pieces = (purl.scheme, netloc_tuple[0], purl.path, purl.query, purl.fragment) + surl = urllib.parse.urlunsplit(url_pieces) + return surl, cast("NetlocTuple", netloc_tuple) + + +def _get_netloc(netloc: str) -> NetlocTuple: + return split_auth_from_netloc(netloc) + + +def _redact_netloc(netloc: str) -> Tuple[str]: + return (redact_netloc(netloc),) + + +def split_auth_netloc_from_url( + url: str, +) -> Tuple[str, str, Tuple[Optional[str], Optional[str]]]: + """ + Parse a url into separate netloc, auth, and url with no auth. + + Returns: (url_without_auth, netloc, (username, password)) + """ + url_without_auth, (netloc, auth) = _transform_url(url, _get_netloc) + return url_without_auth, netloc, auth + + +def remove_auth_from_url(url: str) -> str: + """Return a copy of url with 'username:password@' removed.""" + # username/pass params are passed to subversion through flags + # and are not recognized in the url. + return _transform_url(url, _get_netloc)[0] + + +def redact_auth_from_url(url: str) -> str: + """Replace the password in a given url with ****.""" + return _transform_url(url, _redact_netloc)[0] + + +def redact_auth_from_requirement(req: Requirement) -> str: + """Replace the password in a given requirement url with ****.""" + if not req.url: + return str(req) + return str(req).replace(req.url, redact_auth_from_url(req.url)) + + +@dataclass(frozen=True) +class HiddenText: + secret: str + redacted: str + + def __repr__(self) -> str: + return f"" + + def __str__(self) -> str: + return self.redacted + + # This is useful for testing. + def __eq__(self, other: Any) -> bool: + if type(self) is not type(other): + return False + + # The string being used for redaction doesn't also have to match, + # just the raw, original string. + return self.secret == other.secret + + +def hide_value(value: str) -> HiddenText: + return HiddenText(value, redacted="****") + + +def hide_url(url: str) -> HiddenText: + redacted = redact_auth_from_url(url) + return HiddenText(url, redacted=redacted) + + +def protect_pip_from_modification_on_windows(modifying_pip: bool) -> None: + """Protection of pip.exe from modification on Windows + + On Windows, any operation modifying pip should be run as: + python -m pip ... + """ + pip_names = [ + "pip", + f"pip{sys.version_info.major}", + f"pip{sys.version_info.major}.{sys.version_info.minor}", + ] + + # See https://github.com/pypa/pip/issues/1299 for more discussion + should_show_use_python_msg = ( + modifying_pip and WINDOWS and os.path.basename(sys.argv[0]) in pip_names + ) + + if should_show_use_python_msg: + new_command = [sys.executable, "-m", "pip"] + sys.argv[1:] + raise CommandError( + "To modify pip, please run the following command:\n{}".format( + " ".join(new_command) + ) + ) + + +def check_externally_managed() -> None: + """Check whether the current environment is externally managed. + + If the ``EXTERNALLY-MANAGED`` config file is found, the current environment + is considered externally managed, and an ExternallyManagedEnvironment is + raised. + """ + if running_under_virtualenv(): + return + marker = os.path.join(sysconfig.get_path("stdlib"), "EXTERNALLY-MANAGED") + if not os.path.isfile(marker): + return + raise ExternallyManagedEnvironment.from_config(marker) + + +def is_console_interactive() -> bool: + """Is this console interactive?""" + return sys.stdin is not None and sys.stdin.isatty() + + +def hash_file(path: str, blocksize: int = 1 << 20) -> Tuple[Any, int]: + """Return (hash, length) for path using hashlib.sha256()""" + + h = hashlib.sha256() + length = 0 + with open(path, "rb") as f: + for block in read_chunks(f, size=blocksize): + length += len(block) + h.update(block) + return h, length + + +def pairwise(iterable: Iterable[Any]) -> Iterator[Tuple[Any, Any]]: + """ + Return paired elements. + + For example: + s -> (s0, s1), (s2, s3), (s4, s5), ... + """ + iterable = iter(iterable) + return zip_longest(iterable, iterable) + + +def partition( + pred: Callable[[T], bool], iterable: Iterable[T] +) -> Tuple[Iterable[T], Iterable[T]]: + """ + Use a predicate to partition entries into false entries and true entries, + like + + partition(is_odd, range(10)) --> 0 2 4 6 8 and 1 3 5 7 9 + """ + t1, t2 = tee(iterable) + return filterfalse(pred, t1), filter(pred, t2) + + +class ConfiguredBuildBackendHookCaller(BuildBackendHookCaller): + def __init__( + self, + config_holder: Any, + source_dir: str, + build_backend: str, + backend_path: Optional[str] = None, + runner: Optional[Callable[..., None]] = None, + python_executable: Optional[str] = None, + ): + super().__init__( + source_dir, build_backend, backend_path, runner, python_executable + ) + self.config_holder = config_holder + + def build_wheel( + self, + wheel_directory: str, + config_settings: Optional[Mapping[str, Any]] = None, + metadata_directory: Optional[str] = None, + ) -> str: + cs = self.config_holder.config_settings + return super().build_wheel( + wheel_directory, config_settings=cs, metadata_directory=metadata_directory + ) + + def build_sdist( + self, + sdist_directory: str, + config_settings: Optional[Mapping[str, Any]] = None, + ) -> str: + cs = self.config_holder.config_settings + return super().build_sdist(sdist_directory, config_settings=cs) + + def build_editable( + self, + wheel_directory: str, + config_settings: Optional[Mapping[str, Any]] = None, + metadata_directory: Optional[str] = None, + ) -> str: + cs = self.config_holder.config_settings + return super().build_editable( + wheel_directory, config_settings=cs, metadata_directory=metadata_directory + ) + + def get_requires_for_build_wheel( + self, config_settings: Optional[Mapping[str, Any]] = None + ) -> Sequence[str]: + cs = self.config_holder.config_settings + return super().get_requires_for_build_wheel(config_settings=cs) + + def get_requires_for_build_sdist( + self, config_settings: Optional[Mapping[str, Any]] = None + ) -> Sequence[str]: + cs = self.config_holder.config_settings + return super().get_requires_for_build_sdist(config_settings=cs) + + def get_requires_for_build_editable( + self, config_settings: Optional[Mapping[str, Any]] = None + ) -> Sequence[str]: + cs = self.config_holder.config_settings + return super().get_requires_for_build_editable(config_settings=cs) + + def prepare_metadata_for_build_wheel( + self, + metadata_directory: str, + config_settings: Optional[Mapping[str, Any]] = None, + _allow_fallback: bool = True, + ) -> str: + cs = self.config_holder.config_settings + return super().prepare_metadata_for_build_wheel( + metadata_directory=metadata_directory, + config_settings=cs, + _allow_fallback=_allow_fallback, + ) + + def prepare_metadata_for_build_editable( + self, + metadata_directory: str, + config_settings: Optional[Mapping[str, Any]] = None, + _allow_fallback: bool = True, + ) -> Optional[str]: + cs = self.config_holder.config_settings + return super().prepare_metadata_for_build_editable( + metadata_directory=metadata_directory, + config_settings=cs, + _allow_fallback=_allow_fallback, + ) + + +def warn_if_run_as_root() -> None: + """Output a warning for sudo users on Unix. + + In a virtual environment, sudo pip still writes to virtualenv. + On Windows, users may run pip as Administrator without issues. + This warning only applies to Unix root users outside of virtualenv. + """ + if running_under_virtualenv(): + return + if not hasattr(os, "getuid"): + return + # On Windows, there are no "system managed" Python packages. Installing as + # Administrator via pip is the correct way of updating system environments. + # + # We choose sys.platform over utils.compat.WINDOWS here to enable Mypy platform + # checks: https://mypy.readthedocs.io/en/stable/common_issues.html + if sys.platform == "win32" or sys.platform == "cygwin": + return + + if os.getuid() != 0: + return + + logger.warning( + "Running pip as the 'root' user can result in broken permissions and " + "conflicting behaviour with the system package manager, possibly " + "rendering your system unusable. " + "It is recommended to use a virtual environment instead: " + "https://pip.pypa.io/warnings/venv. " + "Use the --root-user-action option if you know what you are doing and " + "want to suppress this warning." + ) diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/packaging.py b/env/lib/python3.12/site-packages/pip/_internal/utils/packaging.py new file mode 100644 index 0000000..caad70f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/packaging.py @@ -0,0 +1,58 @@ +import functools +import logging +import re +from typing import NewType, Optional, Tuple, cast + +from pip._vendor.packaging import specifiers, version +from pip._vendor.packaging.requirements import Requirement + +NormalizedExtra = NewType("NormalizedExtra", str) + +logger = logging.getLogger(__name__) + + +@functools.lru_cache(maxsize=32) +def check_requires_python( + requires_python: Optional[str], version_info: Tuple[int, ...] +) -> bool: + """ + Check if the given Python version matches a "Requires-Python" specifier. + + :param version_info: A 3-tuple of ints representing a Python + major-minor-micro version to check (e.g. `sys.version_info[:3]`). + + :return: `True` if the given Python version satisfies the requirement. + Otherwise, return `False`. + + :raises InvalidSpecifier: If `requires_python` has an invalid format. + """ + if requires_python is None: + # The package provides no information + return True + requires_python_specifier = specifiers.SpecifierSet(requires_python) + + python_version = version.parse(".".join(map(str, version_info))) + return python_version in requires_python_specifier + + +@functools.lru_cache(maxsize=2048) +def get_requirement(req_string: str) -> Requirement: + """Construct a packaging.Requirement object with caching""" + # Parsing requirement strings is expensive, and is also expected to happen + # with a low diversity of different arguments (at least relative the number + # constructed). This method adds a cache to requirement object creation to + # minimize repeated parsing of the same string to construct equivalent + # Requirement objects. + return Requirement(req_string) + + +def safe_extra(extra: str) -> NormalizedExtra: + """Convert an arbitrary string to a standard 'extra' name + + Any runs of non-alphanumeric characters are replaced with a single '_', + and the result is always lowercased. + + This function is duplicated from ``pkg_resources``. Note that this is not + the same to either ``canonicalize_name`` or ``_egg_link_name``. + """ + return cast(NormalizedExtra, re.sub("[^A-Za-z0-9.-]+", "_", extra).lower()) diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/retry.py b/env/lib/python3.12/site-packages/pip/_internal/utils/retry.py new file mode 100644 index 0000000..abfe072 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/retry.py @@ -0,0 +1,42 @@ +import functools +from time import perf_counter, sleep +from typing import Callable, TypeVar + +from pip._vendor.typing_extensions import ParamSpec + +T = TypeVar("T") +P = ParamSpec("P") + + +def retry( + wait: float, stop_after_delay: float +) -> Callable[[Callable[P, T]], Callable[P, T]]: + """Decorator to automatically retry a function on error. + + If the function raises, the function is recalled with the same arguments + until it returns or the time limit is reached. When the time limit is + surpassed, the last exception raised is reraised. + + :param wait: The time to wait after an error before retrying, in seconds. + :param stop_after_delay: The time limit after which retries will cease, + in seconds. + """ + + def wrapper(func: Callable[P, T]) -> Callable[P, T]: + + @functools.wraps(func) + def retry_wrapped(*args: P.args, **kwargs: P.kwargs) -> T: + # The performance counter is monotonic on all platforms we care + # about and has much better resolution than time.monotonic(). + start_time = perf_counter() + while True: + try: + return func(*args, **kwargs) + except Exception: + if perf_counter() - start_time > stop_after_delay: + raise + sleep(wait) + + return retry_wrapped + + return wrapper diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/setuptools_build.py b/env/lib/python3.12/site-packages/pip/_internal/utils/setuptools_build.py new file mode 100644 index 0000000..96d1b24 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/setuptools_build.py @@ -0,0 +1,146 @@ +import sys +import textwrap +from typing import List, Optional, Sequence + +# Shim to wrap setup.py invocation with setuptools +# Note that __file__ is handled via two {!r} *and* %r, to ensure that paths on +# Windows are correctly handled (it should be "C:\\Users" not "C:\Users"). +_SETUPTOOLS_SHIM = textwrap.dedent( + """ + exec(compile(''' + # This is -- a caller that pip uses to run setup.py + # + # - It imports setuptools before invoking setup.py, to enable projects that directly + # import from `distutils.core` to work with newer packaging standards. + # - It provides a clear error message when setuptools is not installed. + # - It sets `sys.argv[0]` to the underlying `setup.py`, when invoking `setup.py` so + # setuptools doesn't think the script is `-c`. This avoids the following warning: + # manifest_maker: standard file '-c' not found". + # - It generates a shim setup.py, for handling setup.cfg-only projects. + import os, sys, tokenize + + try: + import setuptools + except ImportError as error: + print( + "ERROR: Can not execute `setup.py` since setuptools is not available in " + "the build environment.", + file=sys.stderr, + ) + sys.exit(1) + + __file__ = %r + sys.argv[0] = __file__ + + if os.path.exists(__file__): + filename = __file__ + with tokenize.open(__file__) as f: + setup_py_code = f.read() + else: + filename = "" + setup_py_code = "from setuptools import setup; setup()" + + exec(compile(setup_py_code, filename, "exec")) + ''' % ({!r},), "", "exec")) + """ +).rstrip() + + +def make_setuptools_shim_args( + setup_py_path: str, + global_options: Optional[Sequence[str]] = None, + no_user_config: bool = False, + unbuffered_output: bool = False, +) -> List[str]: + """ + Get setuptools command arguments with shim wrapped setup file invocation. + + :param setup_py_path: The path to setup.py to be wrapped. + :param global_options: Additional global options. + :param no_user_config: If True, disables personal user configuration. + :param unbuffered_output: If True, adds the unbuffered switch to the + argument list. + """ + args = [sys.executable] + if unbuffered_output: + args += ["-u"] + args += ["-c", _SETUPTOOLS_SHIM.format(setup_py_path)] + if global_options: + args += global_options + if no_user_config: + args += ["--no-user-cfg"] + return args + + +def make_setuptools_bdist_wheel_args( + setup_py_path: str, + global_options: Sequence[str], + build_options: Sequence[str], + destination_dir: str, +) -> List[str]: + # NOTE: Eventually, we'd want to also -S to the flags here, when we're + # isolating. Currently, it breaks Python in virtualenvs, because it + # relies on site.py to find parts of the standard library outside the + # virtualenv. + args = make_setuptools_shim_args( + setup_py_path, global_options=global_options, unbuffered_output=True + ) + args += ["bdist_wheel", "-d", destination_dir] + args += build_options + return args + + +def make_setuptools_clean_args( + setup_py_path: str, + global_options: Sequence[str], +) -> List[str]: + args = make_setuptools_shim_args( + setup_py_path, global_options=global_options, unbuffered_output=True + ) + args += ["clean", "--all"] + return args + + +def make_setuptools_develop_args( + setup_py_path: str, + *, + global_options: Sequence[str], + no_user_config: bool, + prefix: Optional[str], + home: Optional[str], + use_user_site: bool, +) -> List[str]: + assert not (use_user_site and prefix) + + args = make_setuptools_shim_args( + setup_py_path, + global_options=global_options, + no_user_config=no_user_config, + ) + + args += ["develop", "--no-deps"] + + if prefix: + args += ["--prefix", prefix] + if home is not None: + args += ["--install-dir", home] + + if use_user_site: + args += ["--user", "--prefix="] + + return args + + +def make_setuptools_egg_info_args( + setup_py_path: str, + egg_info_dir: Optional[str], + no_user_config: bool, +) -> List[str]: + args = make_setuptools_shim_args(setup_py_path, no_user_config=no_user_config) + + args += ["egg_info"] + + if egg_info_dir: + args += ["--egg-base", egg_info_dir] + + return args diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/subprocess.py b/env/lib/python3.12/site-packages/pip/_internal/utils/subprocess.py new file mode 100644 index 0000000..cb2e23f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/subprocess.py @@ -0,0 +1,245 @@ +import logging +import os +import shlex +import subprocess +from typing import Any, Callable, Iterable, List, Literal, Mapping, Optional, Union + +from pip._vendor.rich.markup import escape + +from pip._internal.cli.spinners import SpinnerInterface, open_spinner +from pip._internal.exceptions import InstallationSubprocessError +from pip._internal.utils.logging import VERBOSE, subprocess_logger +from pip._internal.utils.misc import HiddenText + +CommandArgs = List[Union[str, HiddenText]] + + +def make_command(*args: Union[str, HiddenText, CommandArgs]) -> CommandArgs: + """ + Create a CommandArgs object. + """ + command_args: CommandArgs = [] + for arg in args: + # Check for list instead of CommandArgs since CommandArgs is + # only known during type-checking. + if isinstance(arg, list): + command_args.extend(arg) + else: + # Otherwise, arg is str or HiddenText. + command_args.append(arg) + + return command_args + + +def format_command_args(args: Union[List[str], CommandArgs]) -> str: + """ + Format command arguments for display. + """ + # For HiddenText arguments, display the redacted form by calling str(). + # Also, we don't apply str() to arguments that aren't HiddenText since + # this can trigger a UnicodeDecodeError in Python 2 if the argument + # has type unicode and includes a non-ascii character. (The type + # checker doesn't ensure the annotations are correct in all cases.) + return " ".join( + shlex.quote(str(arg)) if isinstance(arg, HiddenText) else shlex.quote(arg) + for arg in args + ) + + +def reveal_command_args(args: Union[List[str], CommandArgs]) -> List[str]: + """ + Return the arguments in their raw, unredacted form. + """ + return [arg.secret if isinstance(arg, HiddenText) else arg for arg in args] + + +def call_subprocess( + cmd: Union[List[str], CommandArgs], + show_stdout: bool = False, + cwd: Optional[str] = None, + on_returncode: 'Literal["raise", "warn", "ignore"]' = "raise", + extra_ok_returncodes: Optional[Iterable[int]] = None, + extra_environ: Optional[Mapping[str, Any]] = None, + unset_environ: Optional[Iterable[str]] = None, + spinner: Optional[SpinnerInterface] = None, + log_failed_cmd: Optional[bool] = True, + stdout_only: Optional[bool] = False, + *, + command_desc: str, +) -> str: + """ + Args: + show_stdout: if true, use INFO to log the subprocess's stderr and + stdout streams. Otherwise, use DEBUG. Defaults to False. + extra_ok_returncodes: an iterable of integer return codes that are + acceptable, in addition to 0. Defaults to None, which means []. + unset_environ: an iterable of environment variable names to unset + prior to calling subprocess.Popen(). + log_failed_cmd: if false, failed commands are not logged, only raised. + stdout_only: if true, return only stdout, else return both. When true, + logging of both stdout and stderr occurs when the subprocess has + terminated, else logging occurs as subprocess output is produced. + """ + if extra_ok_returncodes is None: + extra_ok_returncodes = [] + if unset_environ is None: + unset_environ = [] + # Most places in pip use show_stdout=False. What this means is-- + # + # - We connect the child's output (combined stderr and stdout) to a + # single pipe, which we read. + # - We log this output to stderr at DEBUG level as it is received. + # - If DEBUG logging isn't enabled (e.g. if --verbose logging wasn't + # requested), then we show a spinner so the user can still see the + # subprocess is in progress. + # - If the subprocess exits with an error, we log the output to stderr + # at ERROR level if it hasn't already been displayed to the console + # (e.g. if --verbose logging wasn't enabled). This way we don't log + # the output to the console twice. + # + # If show_stdout=True, then the above is still done, but with DEBUG + # replaced by INFO. + if show_stdout: + # Then log the subprocess output at INFO level. + log_subprocess: Callable[..., None] = subprocess_logger.info + used_level = logging.INFO + else: + # Then log the subprocess output using VERBOSE. This also ensures + # it will be logged to the log file (aka user_log), if enabled. + log_subprocess = subprocess_logger.verbose + used_level = VERBOSE + + # Whether the subprocess will be visible in the console. + showing_subprocess = subprocess_logger.getEffectiveLevel() <= used_level + + # Only use the spinner if we're not showing the subprocess output + # and we have a spinner. + use_spinner = not showing_subprocess and spinner is not None + + log_subprocess("Running command %s", command_desc) + env = os.environ.copy() + if extra_environ: + env.update(extra_environ) + for name in unset_environ: + env.pop(name, None) + try: + proc = subprocess.Popen( + # Convert HiddenText objects to the underlying str. + reveal_command_args(cmd), + stdin=subprocess.PIPE, + stdout=subprocess.PIPE, + stderr=subprocess.STDOUT if not stdout_only else subprocess.PIPE, + cwd=cwd, + env=env, + errors="backslashreplace", + ) + except Exception as exc: + if log_failed_cmd: + subprocess_logger.critical( + "Error %s while executing command %s", + exc, + command_desc, + ) + raise + all_output = [] + if not stdout_only: + assert proc.stdout + assert proc.stdin + proc.stdin.close() + # In this mode, stdout and stderr are in the same pipe. + while True: + line: str = proc.stdout.readline() + if not line: + break + line = line.rstrip() + all_output.append(line + "\n") + + # Show the line immediately. + log_subprocess(line) + # Update the spinner. + if use_spinner: + assert spinner + spinner.spin() + try: + proc.wait() + finally: + if proc.stdout: + proc.stdout.close() + output = "".join(all_output) + else: + # In this mode, stdout and stderr are in different pipes. + # We must use communicate() which is the only safe way to read both. + out, err = proc.communicate() + # log line by line to preserve pip log indenting + for out_line in out.splitlines(): + log_subprocess(out_line) + all_output.append(out) + for err_line in err.splitlines(): + log_subprocess(err_line) + all_output.append(err) + output = out + + proc_had_error = proc.returncode and proc.returncode not in extra_ok_returncodes + if use_spinner: + assert spinner + if proc_had_error: + spinner.finish("error") + else: + spinner.finish("done") + if proc_had_error: + if on_returncode == "raise": + error = InstallationSubprocessError( + command_description=command_desc, + exit_code=proc.returncode, + output_lines=all_output if not showing_subprocess else None, + ) + if log_failed_cmd: + subprocess_logger.error("%s", error, extra={"rich": True}) + subprocess_logger.verbose( + "[bold magenta]full command[/]: [blue]%s[/]", + escape(format_command_args(cmd)), + extra={"markup": True}, + ) + subprocess_logger.verbose( + "[bold magenta]cwd[/]: %s", + escape(cwd or "[inherit]"), + extra={"markup": True}, + ) + + raise error + elif on_returncode == "warn": + subprocess_logger.warning( + 'Command "%s" had error code %s in %s', + command_desc, + proc.returncode, + cwd, + ) + elif on_returncode == "ignore": + pass + else: + raise ValueError(f"Invalid value: on_returncode={on_returncode!r}") + return output + + +def runner_with_spinner_message(message: str) -> Callable[..., None]: + """Provide a subprocess_runner that shows a spinner message. + + Intended for use with for BuildBackendHookCaller. Thus, the runner has + an API that matches what's expected by BuildBackendHookCaller.subprocess_runner. + """ + + def runner( + cmd: List[str], + cwd: Optional[str] = None, + extra_environ: Optional[Mapping[str, Any]] = None, + ) -> None: + with open_spinner(message) as spinner: + call_subprocess( + cmd, + command_desc=message, + cwd=cwd, + extra_environ=extra_environ, + spinner=spinner, + ) + + return runner diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/temp_dir.py b/env/lib/python3.12/site-packages/pip/_internal/utils/temp_dir.py new file mode 100644 index 0000000..06668e8 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/temp_dir.py @@ -0,0 +1,296 @@ +import errno +import itertools +import logging +import os.path +import tempfile +import traceback +from contextlib import ExitStack, contextmanager +from pathlib import Path +from typing import ( + Any, + Callable, + Dict, + Generator, + List, + Optional, + TypeVar, + Union, +) + +from pip._internal.utils.misc import enum, rmtree + +logger = logging.getLogger(__name__) + +_T = TypeVar("_T", bound="TempDirectory") + + +# Kinds of temporary directories. Only needed for ones that are +# globally-managed. +tempdir_kinds = enum( + BUILD_ENV="build-env", + EPHEM_WHEEL_CACHE="ephem-wheel-cache", + REQ_BUILD="req-build", +) + + +_tempdir_manager: Optional[ExitStack] = None + + +@contextmanager +def global_tempdir_manager() -> Generator[None, None, None]: + global _tempdir_manager + with ExitStack() as stack: + old_tempdir_manager, _tempdir_manager = _tempdir_manager, stack + try: + yield + finally: + _tempdir_manager = old_tempdir_manager + + +class TempDirectoryTypeRegistry: + """Manages temp directory behavior""" + + def __init__(self) -> None: + self._should_delete: Dict[str, bool] = {} + + def set_delete(self, kind: str, value: bool) -> None: + """Indicate whether a TempDirectory of the given kind should be + auto-deleted. + """ + self._should_delete[kind] = value + + def get_delete(self, kind: str) -> bool: + """Get configured auto-delete flag for a given TempDirectory type, + default True. + """ + return self._should_delete.get(kind, True) + + +_tempdir_registry: Optional[TempDirectoryTypeRegistry] = None + + +@contextmanager +def tempdir_registry() -> Generator[TempDirectoryTypeRegistry, None, None]: + """Provides a scoped global tempdir registry that can be used to dictate + whether directories should be deleted. + """ + global _tempdir_registry + old_tempdir_registry = _tempdir_registry + _tempdir_registry = TempDirectoryTypeRegistry() + try: + yield _tempdir_registry + finally: + _tempdir_registry = old_tempdir_registry + + +class _Default: + pass + + +_default = _Default() + + +class TempDirectory: + """Helper class that owns and cleans up a temporary directory. + + This class can be used as a context manager or as an OO representation of a + temporary directory. + + Attributes: + path + Location to the created temporary directory + delete + Whether the directory should be deleted when exiting + (when used as a contextmanager) + + Methods: + cleanup() + Deletes the temporary directory + + When used as a context manager, if the delete attribute is True, on + exiting the context the temporary directory is deleted. + """ + + def __init__( + self, + path: Optional[str] = None, + delete: Union[bool, None, _Default] = _default, + kind: str = "temp", + globally_managed: bool = False, + ignore_cleanup_errors: bool = True, + ): + super().__init__() + + if delete is _default: + if path is not None: + # If we were given an explicit directory, resolve delete option + # now. + delete = False + else: + # Otherwise, we wait until cleanup and see what + # tempdir_registry says. + delete = None + + # The only time we specify path is in for editables where it + # is the value of the --src option. + if path is None: + path = self._create(kind) + + self._path = path + self._deleted = False + self.delete = delete + self.kind = kind + self.ignore_cleanup_errors = ignore_cleanup_errors + + if globally_managed: + assert _tempdir_manager is not None + _tempdir_manager.enter_context(self) + + @property + def path(self) -> str: + assert not self._deleted, f"Attempted to access deleted path: {self._path}" + return self._path + + def __repr__(self) -> str: + return f"<{self.__class__.__name__} {self.path!r}>" + + def __enter__(self: _T) -> _T: + return self + + def __exit__(self, exc: Any, value: Any, tb: Any) -> None: + if self.delete is not None: + delete = self.delete + elif _tempdir_registry: + delete = _tempdir_registry.get_delete(self.kind) + else: + delete = True + + if delete: + self.cleanup() + + def _create(self, kind: str) -> str: + """Create a temporary directory and store its path in self.path""" + # We realpath here because some systems have their default tmpdir + # symlinked to another directory. This tends to confuse build + # scripts, so we canonicalize the path by traversing potential + # symlinks here. + path = os.path.realpath(tempfile.mkdtemp(prefix=f"pip-{kind}-")) + logger.debug("Created temporary directory: %s", path) + return path + + def cleanup(self) -> None: + """Remove the temporary directory created and reset state""" + self._deleted = True + if not os.path.exists(self._path): + return + + errors: List[BaseException] = [] + + def onerror( + func: Callable[..., Any], + path: Path, + exc_val: BaseException, + ) -> None: + """Log a warning for a `rmtree` error and continue""" + formatted_exc = "\n".join( + traceback.format_exception_only(type(exc_val), exc_val) + ) + formatted_exc = formatted_exc.rstrip() # remove trailing new line + if func in (os.unlink, os.remove, os.rmdir): + logger.debug( + "Failed to remove a temporary file '%s' due to %s.\n", + path, + formatted_exc, + ) + else: + logger.debug("%s failed with %s.", func.__qualname__, formatted_exc) + errors.append(exc_val) + + if self.ignore_cleanup_errors: + try: + # first try with @retry; retrying to handle ephemeral errors + rmtree(self._path, ignore_errors=False) + except OSError: + # last pass ignore/log all errors + rmtree(self._path, onexc=onerror) + if errors: + logger.warning( + "Failed to remove contents in a temporary directory '%s'.\n" + "You can safely remove it manually.", + self._path, + ) + else: + rmtree(self._path) + + +class AdjacentTempDirectory(TempDirectory): + """Helper class that creates a temporary directory adjacent to a real one. + + Attributes: + original + The original directory to create a temp directory for. + path + After calling create() or entering, contains the full + path to the temporary directory. + delete + Whether the directory should be deleted when exiting + (when used as a contextmanager) + + """ + + # The characters that may be used to name the temp directory + # We always prepend a ~ and then rotate through these until + # a usable name is found. + # pkg_resources raises a different error for .dist-info folder + # with leading '-' and invalid metadata + LEADING_CHARS = "-~.=%0123456789" + + def __init__(self, original: str, delete: Optional[bool] = None) -> None: + self.original = original.rstrip("/\\") + super().__init__(delete=delete) + + @classmethod + def _generate_names(cls, name: str) -> Generator[str, None, None]: + """Generates a series of temporary names. + + The algorithm replaces the leading characters in the name + with ones that are valid filesystem characters, but are not + valid package names (for both Python and pip definitions of + package). + """ + for i in range(1, len(name)): + for candidate in itertools.combinations_with_replacement( + cls.LEADING_CHARS, i - 1 + ): + new_name = "~" + "".join(candidate) + name[i:] + if new_name != name: + yield new_name + + # If we make it this far, we will have to make a longer name + for i in range(len(cls.LEADING_CHARS)): + for candidate in itertools.combinations_with_replacement( + cls.LEADING_CHARS, i + ): + new_name = "~" + "".join(candidate) + name + if new_name != name: + yield new_name + + def _create(self, kind: str) -> str: + root, name = os.path.split(self.original) + for candidate in self._generate_names(name): + path = os.path.join(root, candidate) + try: + os.mkdir(path) + except OSError as ex: + # Continue if the name exists already + if ex.errno != errno.EEXIST: + raise + else: + path = os.path.realpath(path) + break + else: + # Final fallback on the default behavior. + path = os.path.realpath(tempfile.mkdtemp(prefix=f"pip-{kind}-")) + + logger.debug("Created temporary directory: %s", path) + return path diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/unpacking.py b/env/lib/python3.12/site-packages/pip/_internal/utils/unpacking.py new file mode 100644 index 0000000..87a6d19 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/unpacking.py @@ -0,0 +1,337 @@ +"""Utilities related archives. +""" + +import logging +import os +import shutil +import stat +import sys +import tarfile +import zipfile +from typing import Iterable, List, Optional +from zipfile import ZipInfo + +from pip._internal.exceptions import InstallationError +from pip._internal.utils.filetypes import ( + BZ2_EXTENSIONS, + TAR_EXTENSIONS, + XZ_EXTENSIONS, + ZIP_EXTENSIONS, +) +from pip._internal.utils.misc import ensure_dir + +logger = logging.getLogger(__name__) + + +SUPPORTED_EXTENSIONS = ZIP_EXTENSIONS + TAR_EXTENSIONS + +try: + import bz2 # noqa + + SUPPORTED_EXTENSIONS += BZ2_EXTENSIONS +except ImportError: + logger.debug("bz2 module is not available") + +try: + # Only for Python 3.3+ + import lzma # noqa + + SUPPORTED_EXTENSIONS += XZ_EXTENSIONS +except ImportError: + logger.debug("lzma module is not available") + + +def current_umask() -> int: + """Get the current umask which involves having to set it temporarily.""" + mask = os.umask(0) + os.umask(mask) + return mask + + +def split_leading_dir(path: str) -> List[str]: + path = path.lstrip("/").lstrip("\\") + if "/" in path and ( + ("\\" in path and path.find("/") < path.find("\\")) or "\\" not in path + ): + return path.split("/", 1) + elif "\\" in path: + return path.split("\\", 1) + else: + return [path, ""] + + +def has_leading_dir(paths: Iterable[str]) -> bool: + """Returns true if all the paths have the same leading path name + (i.e., everything is in one subdirectory in an archive)""" + common_prefix = None + for path in paths: + prefix, rest = split_leading_dir(path) + if not prefix: + return False + elif common_prefix is None: + common_prefix = prefix + elif prefix != common_prefix: + return False + return True + + +def is_within_directory(directory: str, target: str) -> bool: + """ + Return true if the absolute path of target is within the directory + """ + abs_directory = os.path.abspath(directory) + abs_target = os.path.abspath(target) + + prefix = os.path.commonprefix([abs_directory, abs_target]) + return prefix == abs_directory + + +def _get_default_mode_plus_executable() -> int: + return 0o777 & ~current_umask() | 0o111 + + +def set_extracted_file_to_default_mode_plus_executable(path: str) -> None: + """ + Make file present at path have execute for user/group/world + (chmod +x) is no-op on windows per python docs + """ + os.chmod(path, _get_default_mode_plus_executable()) + + +def zip_item_is_executable(info: ZipInfo) -> bool: + mode = info.external_attr >> 16 + # if mode and regular file and any execute permissions for + # user/group/world? + return bool(mode and stat.S_ISREG(mode) and mode & 0o111) + + +def unzip_file(filename: str, location: str, flatten: bool = True) -> None: + """ + Unzip the file (with path `filename`) to the destination `location`. All + files are written based on system defaults and umask (i.e. permissions are + not preserved), except that regular file members with any execute + permissions (user, group, or world) have "chmod +x" applied after being + written. Note that for windows, any execute changes using os.chmod are + no-ops per the python docs. + """ + ensure_dir(location) + zipfp = open(filename, "rb") + try: + zip = zipfile.ZipFile(zipfp, allowZip64=True) + leading = has_leading_dir(zip.namelist()) and flatten + for info in zip.infolist(): + name = info.filename + fn = name + if leading: + fn = split_leading_dir(name)[1] + fn = os.path.join(location, fn) + dir = os.path.dirname(fn) + if not is_within_directory(location, fn): + message = ( + "The zip file ({}) has a file ({}) trying to install " + "outside target directory ({})" + ) + raise InstallationError(message.format(filename, fn, location)) + if fn.endswith("/") or fn.endswith("\\"): + # A directory + ensure_dir(fn) + else: + ensure_dir(dir) + # Don't use read() to avoid allocating an arbitrarily large + # chunk of memory for the file's content + fp = zip.open(name) + try: + with open(fn, "wb") as destfp: + shutil.copyfileobj(fp, destfp) + finally: + fp.close() + if zip_item_is_executable(info): + set_extracted_file_to_default_mode_plus_executable(fn) + finally: + zipfp.close() + + +def untar_file(filename: str, location: str) -> None: + """ + Untar the file (with path `filename`) to the destination `location`. + All files are written based on system defaults and umask (i.e. permissions + are not preserved), except that regular file members with any execute + permissions (user, group, or world) have "chmod +x" applied on top of the + default. Note that for windows, any execute changes using os.chmod are + no-ops per the python docs. + """ + ensure_dir(location) + if filename.lower().endswith(".gz") or filename.lower().endswith(".tgz"): + mode = "r:gz" + elif filename.lower().endswith(BZ2_EXTENSIONS): + mode = "r:bz2" + elif filename.lower().endswith(XZ_EXTENSIONS): + mode = "r:xz" + elif filename.lower().endswith(".tar"): + mode = "r" + else: + logger.warning( + "Cannot determine compression type for file %s", + filename, + ) + mode = "r:*" + + tar = tarfile.open(filename, mode, encoding="utf-8") # type: ignore + try: + leading = has_leading_dir([member.name for member in tar.getmembers()]) + + # PEP 706 added `tarfile.data_filter`, and made some other changes to + # Python's tarfile module (see below). The features were backported to + # security releases. + try: + data_filter = tarfile.data_filter + except AttributeError: + _untar_without_filter(filename, location, tar, leading) + else: + default_mode_plus_executable = _get_default_mode_plus_executable() + + if leading: + # Strip the leading directory from all files in the archive, + # including hardlink targets (which are relative to the + # unpack location). + for member in tar.getmembers(): + name_lead, name_rest = split_leading_dir(member.name) + member.name = name_rest + if member.islnk(): + lnk_lead, lnk_rest = split_leading_dir(member.linkname) + if lnk_lead == name_lead: + member.linkname = lnk_rest + + def pip_filter(member: tarfile.TarInfo, path: str) -> tarfile.TarInfo: + orig_mode = member.mode + try: + try: + member = data_filter(member, location) + except tarfile.LinkOutsideDestinationError: + if sys.version_info[:3] in { + (3, 8, 17), + (3, 9, 17), + (3, 10, 12), + (3, 11, 4), + }: + # The tarfile filter in specific Python versions + # raises LinkOutsideDestinationError on valid input + # (https://github.com/python/cpython/issues/107845) + # Ignore the error there, but do use the + # more lax `tar_filter` + member = tarfile.tar_filter(member, location) + else: + raise + except tarfile.TarError as exc: + message = "Invalid member in the tar file {}: {}" + # Filter error messages mention the member name. + # No need to add it here. + raise InstallationError( + message.format( + filename, + exc, + ) + ) + if member.isfile() and orig_mode & 0o111: + member.mode = default_mode_plus_executable + else: + # See PEP 706 note above. + # The PEP changed this from `int` to `Optional[int]`, + # where None means "use the default". Mypy doesn't + # know this yet. + member.mode = None # type: ignore [assignment] + return member + + tar.extractall(location, filter=pip_filter) + + finally: + tar.close() + + +def _untar_without_filter( + filename: str, + location: str, + tar: tarfile.TarFile, + leading: bool, +) -> None: + """Fallback for Python without tarfile.data_filter""" + for member in tar.getmembers(): + fn = member.name + if leading: + fn = split_leading_dir(fn)[1] + path = os.path.join(location, fn) + if not is_within_directory(location, path): + message = ( + "The tar file ({}) has a file ({}) trying to install " + "outside target directory ({})" + ) + raise InstallationError(message.format(filename, path, location)) + if member.isdir(): + ensure_dir(path) + elif member.issym(): + try: + tar._extract_member(member, path) + except Exception as exc: + # Some corrupt tar files seem to produce this + # (specifically bad symlinks) + logger.warning( + "In the tar file %s the member %s is invalid: %s", + filename, + member.name, + exc, + ) + continue + else: + try: + fp = tar.extractfile(member) + except (KeyError, AttributeError) as exc: + # Some corrupt tar files seem to produce this + # (specifically bad symlinks) + logger.warning( + "In the tar file %s the member %s is invalid: %s", + filename, + member.name, + exc, + ) + continue + ensure_dir(os.path.dirname(path)) + assert fp is not None + with open(path, "wb") as destfp: + shutil.copyfileobj(fp, destfp) + fp.close() + # Update the timestamp (useful for cython compiled files) + tar.utime(member, path) + # member have any execute permissions for user/group/world? + if member.mode & 0o111: + set_extracted_file_to_default_mode_plus_executable(path) + + +def unpack_file( + filename: str, + location: str, + content_type: Optional[str] = None, +) -> None: + filename = os.path.realpath(filename) + if ( + content_type == "application/zip" + or filename.lower().endswith(ZIP_EXTENSIONS) + or zipfile.is_zipfile(filename) + ): + unzip_file(filename, location, flatten=not filename.endswith(".whl")) + elif ( + content_type == "application/x-gzip" + or tarfile.is_tarfile(filename) + or filename.lower().endswith(TAR_EXTENSIONS + BZ2_EXTENSIONS + XZ_EXTENSIONS) + ): + untar_file(filename, location) + else: + # FIXME: handle? + # FIXME: magic signatures? + logger.critical( + "Cannot unpack file %s (downloaded from %s, content-type: %s); " + "cannot detect archive format", + filename, + location, + content_type, + ) + raise InstallationError(f"Cannot determine archive format of {location}") diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/urls.py b/env/lib/python3.12/site-packages/pip/_internal/utils/urls.py new file mode 100644 index 0000000..9f34f88 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/urls.py @@ -0,0 +1,55 @@ +import os +import string +import urllib.parse +import urllib.request + +from .compat import WINDOWS + + +def path_to_url(path: str) -> str: + """ + Convert a path to a file: URL. The path will be made absolute and have + quoted path parts. + """ + path = os.path.normpath(os.path.abspath(path)) + url = urllib.parse.urljoin("file:", urllib.request.pathname2url(path)) + return url + + +def url_to_path(url: str) -> str: + """ + Convert a file: URL to a path. + """ + assert url.startswith( + "file:" + ), f"You can only turn file: urls into filenames (not {url!r})" + + _, netloc, path, _, _ = urllib.parse.urlsplit(url) + + if not netloc or netloc == "localhost": + # According to RFC 8089, same as empty authority. + netloc = "" + elif WINDOWS: + # If we have a UNC path, prepend UNC share notation. + netloc = "\\\\" + netloc + else: + raise ValueError( + f"non-local file URIs are not supported on this platform: {url!r}" + ) + + path = urllib.request.url2pathname(netloc + path) + + # On Windows, urlsplit parses the path as something like "/C:/Users/foo". + # This creates issues for path-related functions like io.open(), so we try + # to detect and strip the leading slash. + if ( + WINDOWS + and not netloc # Not UNC. + and len(path) >= 3 + and path[0] == "/" # Leading slash to strip. + and path[1] in string.ascii_letters # Drive letter. + and path[2:4] in (":", ":/") # Colon + end of string, or colon + absolute path. + ): + path = path[1:] + + return path diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/virtualenv.py b/env/lib/python3.12/site-packages/pip/_internal/utils/virtualenv.py new file mode 100644 index 0000000..882e36f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/virtualenv.py @@ -0,0 +1,104 @@ +import logging +import os +import re +import site +import sys +from typing import List, Optional + +logger = logging.getLogger(__name__) +_INCLUDE_SYSTEM_SITE_PACKAGES_REGEX = re.compile( + r"include-system-site-packages\s*=\s*(?Ptrue|false)" +) + + +def _running_under_venv() -> bool: + """Checks if sys.base_prefix and sys.prefix match. + + This handles PEP 405 compliant virtual environments. + """ + return sys.prefix != getattr(sys, "base_prefix", sys.prefix) + + +def _running_under_legacy_virtualenv() -> bool: + """Checks if sys.real_prefix is set. + + This handles virtual environments created with pypa's virtualenv. + """ + # pypa/virtualenv case + return hasattr(sys, "real_prefix") + + +def running_under_virtualenv() -> bool: + """True if we're running inside a virtual environment, False otherwise.""" + return _running_under_venv() or _running_under_legacy_virtualenv() + + +def _get_pyvenv_cfg_lines() -> Optional[List[str]]: + """Reads {sys.prefix}/pyvenv.cfg and returns its contents as list of lines + + Returns None, if it could not read/access the file. + """ + pyvenv_cfg_file = os.path.join(sys.prefix, "pyvenv.cfg") + try: + # Although PEP 405 does not specify, the built-in venv module always + # writes with UTF-8. (pypa/pip#8717) + with open(pyvenv_cfg_file, encoding="utf-8") as f: + return f.read().splitlines() # avoids trailing newlines + except OSError: + return None + + +def _no_global_under_venv() -> bool: + """Check `{sys.prefix}/pyvenv.cfg` for system site-packages inclusion + + PEP 405 specifies that when system site-packages are not supposed to be + visible from a virtual environment, `pyvenv.cfg` must contain the following + line: + + include-system-site-packages = false + + Additionally, log a warning if accessing the file fails. + """ + cfg_lines = _get_pyvenv_cfg_lines() + if cfg_lines is None: + # We're not in a "sane" venv, so assume there is no system + # site-packages access (since that's PEP 405's default state). + logger.warning( + "Could not access 'pyvenv.cfg' despite a virtual environment " + "being active. Assuming global site-packages is not accessible " + "in this environment." + ) + return True + + for line in cfg_lines: + match = _INCLUDE_SYSTEM_SITE_PACKAGES_REGEX.match(line) + if match is not None and match.group("value") == "false": + return True + return False + + +def _no_global_under_legacy_virtualenv() -> bool: + """Check if "no-global-site-packages.txt" exists beside site.py + + This mirrors logic in pypa/virtualenv for determining whether system + site-packages are visible in the virtual environment. + """ + site_mod_dir = os.path.dirname(os.path.abspath(site.__file__)) + no_global_site_packages_file = os.path.join( + site_mod_dir, + "no-global-site-packages.txt", + ) + return os.path.exists(no_global_site_packages_file) + + +def virtualenv_no_global() -> bool: + """Returns a boolean, whether running in venv with no system site-packages.""" + # PEP 405 compliance needs to be checked first since virtualenv >=20 would + # return True for both checks, but is only able to use the PEP 405 config. + if _running_under_venv(): + return _no_global_under_venv() + + if _running_under_legacy_virtualenv(): + return _no_global_under_legacy_virtualenv() + + return False diff --git a/env/lib/python3.12/site-packages/pip/_internal/utils/wheel.py b/env/lib/python3.12/site-packages/pip/_internal/utils/wheel.py new file mode 100644 index 0000000..f85aee8 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/utils/wheel.py @@ -0,0 +1,134 @@ +"""Support functions for working with wheel files. +""" + +import logging +from email.message import Message +from email.parser import Parser +from typing import Tuple +from zipfile import BadZipFile, ZipFile + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import UnsupportedWheel + +VERSION_COMPATIBLE = (1, 0) + + +logger = logging.getLogger(__name__) + + +def parse_wheel(wheel_zip: ZipFile, name: str) -> Tuple[str, Message]: + """Extract information from the provided wheel, ensuring it meets basic + standards. + + Returns the name of the .dist-info directory and the parsed WHEEL metadata. + """ + try: + info_dir = wheel_dist_info_dir(wheel_zip, name) + metadata = wheel_metadata(wheel_zip, info_dir) + version = wheel_version(metadata) + except UnsupportedWheel as e: + raise UnsupportedWheel(f"{name} has an invalid wheel, {e}") + + check_compatibility(version, name) + + return info_dir, metadata + + +def wheel_dist_info_dir(source: ZipFile, name: str) -> str: + """Returns the name of the contained .dist-info directory. + + Raises AssertionError or UnsupportedWheel if not found, >1 found, or + it doesn't match the provided name. + """ + # Zip file path separators must be / + subdirs = {p.split("/", 1)[0] for p in source.namelist()} + + info_dirs = [s for s in subdirs if s.endswith(".dist-info")] + + if not info_dirs: + raise UnsupportedWheel(".dist-info directory not found") + + if len(info_dirs) > 1: + raise UnsupportedWheel( + "multiple .dist-info directories found: {}".format(", ".join(info_dirs)) + ) + + info_dir = info_dirs[0] + + info_dir_name = canonicalize_name(info_dir) + canonical_name = canonicalize_name(name) + if not info_dir_name.startswith(canonical_name): + raise UnsupportedWheel( + f".dist-info directory {info_dir!r} does not start with {canonical_name!r}" + ) + + return info_dir + + +def read_wheel_metadata_file(source: ZipFile, path: str) -> bytes: + try: + return source.read(path) + # BadZipFile for general corruption, KeyError for missing entry, + # and RuntimeError for password-protected files + except (BadZipFile, KeyError, RuntimeError) as e: + raise UnsupportedWheel(f"could not read {path!r} file: {e!r}") + + +def wheel_metadata(source: ZipFile, dist_info_dir: str) -> Message: + """Return the WHEEL metadata of an extracted wheel, if possible. + Otherwise, raise UnsupportedWheel. + """ + path = f"{dist_info_dir}/WHEEL" + # Zip file path separators must be / + wheel_contents = read_wheel_metadata_file(source, path) + + try: + wheel_text = wheel_contents.decode() + except UnicodeDecodeError as e: + raise UnsupportedWheel(f"error decoding {path!r}: {e!r}") + + # FeedParser (used by Parser) does not raise any exceptions. The returned + # message may have .defects populated, but for backwards-compatibility we + # currently ignore them. + return Parser().parsestr(wheel_text) + + +def wheel_version(wheel_data: Message) -> Tuple[int, ...]: + """Given WHEEL metadata, return the parsed Wheel-Version. + Otherwise, raise UnsupportedWheel. + """ + version_text = wheel_data["Wheel-Version"] + if version_text is None: + raise UnsupportedWheel("WHEEL is missing Wheel-Version") + + version = version_text.strip() + + try: + return tuple(map(int, version.split("."))) + except ValueError: + raise UnsupportedWheel(f"invalid Wheel-Version: {version!r}") + + +def check_compatibility(version: Tuple[int, ...], name: str) -> None: + """Raises errors or warns if called with an incompatible Wheel-Version. + + pip should refuse to install a Wheel-Version that's a major series + ahead of what it's compatible with (e.g 2.0 > 1.1); and warn when + installing a version only minor version ahead (e.g 1.2 > 1.1). + + version: a 2-tuple representing a Wheel-Version (Major, Minor) + name: name of wheel or package to raise exception about + + :raises UnsupportedWheel: when an incompatible Wheel-Version is given + """ + if version[0] > VERSION_COMPATIBLE[0]: + raise UnsupportedWheel( + "{}'s Wheel-Version ({}) is not compatible with this version " + "of pip".format(name, ".".join(map(str, version))) + ) + elif version > VERSION_COMPATIBLE: + logger.warning( + "Installing from a newer Wheel-Version (%s)", + ".".join(map(str, version)), + ) diff --git a/env/lib/python3.12/site-packages/pip/_internal/vcs/__init__.py b/env/lib/python3.12/site-packages/pip/_internal/vcs/__init__.py new file mode 100644 index 0000000..b6beddb --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/vcs/__init__.py @@ -0,0 +1,15 @@ +# Expose a limited set of classes and functions so callers outside of +# the vcs package don't need to import deeper than `pip._internal.vcs`. +# (The test directory may still need to import from a vcs sub-package.) +# Import all vcs modules to register each VCS in the VcsSupport object. +import pip._internal.vcs.bazaar +import pip._internal.vcs.git +import pip._internal.vcs.mercurial +import pip._internal.vcs.subversion # noqa: F401 +from pip._internal.vcs.versioncontrol import ( # noqa: F401 + RemoteNotFoundError, + RemoteNotValidError, + is_url, + make_vcs_requirement_url, + vcs, +) diff --git a/env/lib/python3.12/site-packages/pip/_internal/vcs/bazaar.py b/env/lib/python3.12/site-packages/pip/_internal/vcs/bazaar.py new file mode 100644 index 0000000..c754b7c --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/vcs/bazaar.py @@ -0,0 +1,112 @@ +import logging +from typing import List, Optional, Tuple + +from pip._internal.utils.misc import HiddenText, display_path +from pip._internal.utils.subprocess import make_command +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs.versioncontrol import ( + AuthInfo, + RemoteNotFoundError, + RevOptions, + VersionControl, + vcs, +) + +logger = logging.getLogger(__name__) + + +class Bazaar(VersionControl): + name = "bzr" + dirname = ".bzr" + repo_name = "branch" + schemes = ( + "bzr+http", + "bzr+https", + "bzr+ssh", + "bzr+sftp", + "bzr+ftp", + "bzr+lp", + "bzr+file", + ) + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + return ["-r", rev] + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + rev_display = rev_options.to_display() + logger.info( + "Checking out %s%s to %s", + url, + rev_display, + display_path(dest), + ) + if verbosity <= 0: + flags = ["--quiet"] + elif verbosity == 1: + flags = [] + else: + flags = [f"-{'v'*verbosity}"] + cmd_args = make_command( + "checkout", "--lightweight", *flags, rev_options.to_args(), url, dest + ) + self.run_command(cmd_args) + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + self.run_command(make_command("switch", url), cwd=dest) + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + output = self.run_command( + make_command("info"), show_stdout=False, stdout_only=True, cwd=dest + ) + if output.startswith("Standalone "): + # Older versions of pip used to create standalone branches. + # Convert the standalone branch to a checkout by calling "bzr bind". + cmd_args = make_command("bind", "-q", url) + self.run_command(cmd_args, cwd=dest) + + cmd_args = make_command("update", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + @classmethod + def get_url_rev_and_auth(cls, url: str) -> Tuple[str, Optional[str], AuthInfo]: + # hotfix the URL scheme after removing bzr+ from bzr+ssh:// re-add it + url, rev, user_pass = super().get_url_rev_and_auth(url) + if url.startswith("ssh://"): + url = "bzr+" + url + return url, rev, user_pass + + @classmethod + def get_remote_url(cls, location: str) -> str: + urls = cls.run_command( + ["info"], show_stdout=False, stdout_only=True, cwd=location + ) + for line in urls.splitlines(): + line = line.strip() + for x in ("checkout of branch: ", "parent branch: "): + if line.startswith(x): + repo = line.split(x)[1] + if cls._is_local_repository(repo): + return path_to_url(repo) + return repo + raise RemoteNotFoundError + + @classmethod + def get_revision(cls, location: str) -> str: + revision = cls.run_command( + ["revno"], + show_stdout=False, + stdout_only=True, + cwd=location, + ) + return revision.splitlines()[-1] + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """Always assume the versions don't match""" + return False + + +vcs.register(Bazaar) diff --git a/env/lib/python3.12/site-packages/pip/_internal/vcs/git.py b/env/lib/python3.12/site-packages/pip/_internal/vcs/git.py new file mode 100644 index 0000000..0425deb --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/vcs/git.py @@ -0,0 +1,527 @@ +import logging +import os.path +import pathlib +import re +import urllib.parse +import urllib.request +from dataclasses import replace +from typing import List, Optional, Tuple + +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.utils.misc import HiddenText, display_path, hide_url +from pip._internal.utils.subprocess import make_command +from pip._internal.vcs.versioncontrol import ( + AuthInfo, + RemoteNotFoundError, + RemoteNotValidError, + RevOptions, + VersionControl, + find_path_to_project_root_from_repo_root, + vcs, +) + +urlsplit = urllib.parse.urlsplit +urlunsplit = urllib.parse.urlunsplit + + +logger = logging.getLogger(__name__) + + +GIT_VERSION_REGEX = re.compile( + r"^git version " # Prefix. + r"(\d+)" # Major. + r"\.(\d+)" # Dot, minor. + r"(?:\.(\d+))?" # Optional dot, patch. + r".*$" # Suffix, including any pre- and post-release segments we don't care about. +) + +HASH_REGEX = re.compile("^[a-fA-F0-9]{40}$") + +# SCP (Secure copy protocol) shorthand. e.g. 'git@example.com:foo/bar.git' +SCP_REGEX = re.compile( + r"""^ + # Optional user, e.g. 'git@' + (\w+@)? + # Server, e.g. 'github.com'. + ([^/:]+): + # The server-side path. e.g. 'user/project.git'. Must start with an + # alphanumeric character so as not to be confusable with a Windows paths + # like 'C:/foo/bar' or 'C:\foo\bar'. + (\w[^:]*) + $""", + re.VERBOSE, +) + + +def looks_like_hash(sha: str) -> bool: + return bool(HASH_REGEX.match(sha)) + + +class Git(VersionControl): + name = "git" + dirname = ".git" + repo_name = "clone" + schemes = ( + "git+http", + "git+https", + "git+ssh", + "git+git", + "git+file", + ) + # Prevent the user's environment variables from interfering with pip: + # https://github.com/pypa/pip/issues/1130 + unset_environ = ("GIT_DIR", "GIT_WORK_TREE") + default_arg_rev = "HEAD" + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + return [rev] + + def is_immutable_rev_checkout(self, url: str, dest: str) -> bool: + _, rev_options = self.get_url_rev_options(hide_url(url)) + if not rev_options.rev: + return False + if not self.is_commit_id_equal(dest, rev_options.rev): + # the current commit is different from rev, + # which means rev was something else than a commit hash + return False + # return False in the rare case rev is both a commit hash + # and a tag or a branch; we don't want to cache in that case + # because that branch/tag could point to something else in the future + is_tag_or_branch = bool(self.get_revision_sha(dest, rev_options.rev)[0]) + return not is_tag_or_branch + + def get_git_version(self) -> Tuple[int, ...]: + version = self.run_command( + ["version"], + command_desc="git version", + show_stdout=False, + stdout_only=True, + ) + match = GIT_VERSION_REGEX.match(version) + if not match: + logger.warning("Can't parse git version: %s", version) + return () + return (int(match.group(1)), int(match.group(2))) + + @classmethod + def get_current_branch(cls, location: str) -> Optional[str]: + """ + Return the current branch, or None if HEAD isn't at a branch + (e.g. detached HEAD). + """ + # git-symbolic-ref exits with empty stdout if "HEAD" is a detached + # HEAD rather than a symbolic ref. In addition, the -q causes the + # command to exit with status code 1 instead of 128 in this case + # and to suppress the message to stderr. + args = ["symbolic-ref", "-q", "HEAD"] + output = cls.run_command( + args, + extra_ok_returncodes=(1,), + show_stdout=False, + stdout_only=True, + cwd=location, + ) + ref = output.strip() + + if ref.startswith("refs/heads/"): + return ref[len("refs/heads/") :] + + return None + + @classmethod + def get_revision_sha(cls, dest: str, rev: str) -> Tuple[Optional[str], bool]: + """ + Return (sha_or_none, is_branch), where sha_or_none is a commit hash + if the revision names a remote branch or tag, otherwise None. + + Args: + dest: the repository directory. + rev: the revision name. + """ + # Pass rev to pre-filter the list. + output = cls.run_command( + ["show-ref", rev], + cwd=dest, + show_stdout=False, + stdout_only=True, + on_returncode="ignore", + ) + refs = {} + # NOTE: We do not use splitlines here since that would split on other + # unicode separators, which can be maliciously used to install a + # different revision. + for line in output.strip().split("\n"): + line = line.rstrip("\r") + if not line: + continue + try: + ref_sha, ref_name = line.split(" ", maxsplit=2) + except ValueError: + # Include the offending line to simplify troubleshooting if + # this error ever occurs. + raise ValueError(f"unexpected show-ref line: {line!r}") + + refs[ref_name] = ref_sha + + branch_ref = f"refs/remotes/origin/{rev}" + tag_ref = f"refs/tags/{rev}" + + sha = refs.get(branch_ref) + if sha is not None: + return (sha, True) + + sha = refs.get(tag_ref) + + return (sha, False) + + @classmethod + def _should_fetch(cls, dest: str, rev: str) -> bool: + """ + Return true if rev is a ref or is a commit that we don't have locally. + + Branches and tags are not considered in this method because they are + assumed to be always available locally (which is a normal outcome of + ``git clone`` and ``git fetch --tags``). + """ + if rev.startswith("refs/"): + # Always fetch remote refs. + return True + + if not looks_like_hash(rev): + # Git fetch would fail with abbreviated commits. + return False + + if cls.has_commit(dest, rev): + # Don't fetch if we have the commit locally. + return False + + return True + + @classmethod + def resolve_revision( + cls, dest: str, url: HiddenText, rev_options: RevOptions + ) -> RevOptions: + """ + Resolve a revision to a new RevOptions object with the SHA1 of the + branch, tag, or ref if found. + + Args: + rev_options: a RevOptions object. + """ + rev = rev_options.arg_rev + # The arg_rev property's implementation for Git ensures that the + # rev return value is always non-None. + assert rev is not None + + sha, is_branch = cls.get_revision_sha(dest, rev) + + if sha is not None: + rev_options = rev_options.make_new(sha) + rev_options = replace(rev_options, branch_name=(rev if is_branch else None)) + + return rev_options + + # Do not show a warning for the common case of something that has + # the form of a Git commit hash. + if not looks_like_hash(rev): + logger.warning( + "Did not find branch or tag '%s', assuming revision or ref.", + rev, + ) + + if not cls._should_fetch(dest, rev): + return rev_options + + # fetch the requested revision + cls.run_command( + make_command("fetch", "-q", url, rev_options.to_args()), + cwd=dest, + ) + # Change the revision to the SHA of the ref we fetched + sha = cls.get_revision(dest, rev="FETCH_HEAD") + rev_options = rev_options.make_new(sha) + + return rev_options + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """ + Return whether the current commit hash equals the given name. + + Args: + dest: the repository directory. + name: a string name. + """ + if not name: + # Then avoid an unnecessary subprocess call. + return False + + return cls.get_revision(dest) == name + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + rev_display = rev_options.to_display() + logger.info("Cloning %s%s to %s", url, rev_display, display_path(dest)) + if verbosity <= 0: + flags: Tuple[str, ...] = ("--quiet",) + elif verbosity == 1: + flags = () + else: + flags = ("--verbose", "--progress") + if self.get_git_version() >= (2, 17): + # Git added support for partial clone in 2.17 + # https://git-scm.com/docs/partial-clone + # Speeds up cloning by functioning without a complete copy of repository + self.run_command( + make_command( + "clone", + "--filter=blob:none", + *flags, + url, + dest, + ) + ) + else: + self.run_command(make_command("clone", *flags, url, dest)) + + if rev_options.rev: + # Then a specific revision was requested. + rev_options = self.resolve_revision(dest, url, rev_options) + branch_name = getattr(rev_options, "branch_name", None) + logger.debug("Rev options %s, branch_name %s", rev_options, branch_name) + if branch_name is None: + # Only do a checkout if the current commit id doesn't match + # the requested revision. + if not self.is_commit_id_equal(dest, rev_options.rev): + cmd_args = make_command( + "checkout", + "-q", + rev_options.to_args(), + ) + self.run_command(cmd_args, cwd=dest) + elif self.get_current_branch(dest) != branch_name: + # Then a specific branch was requested, and that branch + # is not yet checked out. + track_branch = f"origin/{branch_name}" + cmd_args = [ + "checkout", + "-b", + branch_name, + "--track", + track_branch, + ] + self.run_command(cmd_args, cwd=dest) + else: + sha = self.get_revision(dest) + rev_options = rev_options.make_new(sha) + + logger.info("Resolved %s to commit %s", url, rev_options.rev) + + #: repo may contain submodules + self.update_submodules(dest) + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + self.run_command( + make_command("config", "remote.origin.url", url), + cwd=dest, + ) + cmd_args = make_command("checkout", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + self.update_submodules(dest) + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + # First fetch changes from the default remote + if self.get_git_version() >= (1, 9): + # fetch tags in addition to everything else + self.run_command(["fetch", "-q", "--tags"], cwd=dest) + else: + self.run_command(["fetch", "-q"], cwd=dest) + # Then reset to wanted revision (maybe even origin/master) + rev_options = self.resolve_revision(dest, url, rev_options) + cmd_args = make_command("reset", "--hard", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + #: update submodules + self.update_submodules(dest) + + @classmethod + def get_remote_url(cls, location: str) -> str: + """ + Return URL of the first remote encountered. + + Raises RemoteNotFoundError if the repository does not have a remote + url configured. + """ + # We need to pass 1 for extra_ok_returncodes since the command + # exits with return code 1 if there are no matching lines. + stdout = cls.run_command( + ["config", "--get-regexp", r"remote\..*\.url"], + extra_ok_returncodes=(1,), + show_stdout=False, + stdout_only=True, + cwd=location, + ) + remotes = stdout.splitlines() + try: + found_remote = remotes[0] + except IndexError: + raise RemoteNotFoundError + + for remote in remotes: + if remote.startswith("remote.origin.url "): + found_remote = remote + break + url = found_remote.split(" ")[1] + return cls._git_remote_to_pip_url(url.strip()) + + @staticmethod + def _git_remote_to_pip_url(url: str) -> str: + """ + Convert a remote url from what git uses to what pip accepts. + + There are 3 legal forms **url** may take: + + 1. A fully qualified url: ssh://git@example.com/foo/bar.git + 2. A local project.git folder: /path/to/bare/repository.git + 3. SCP shorthand for form 1: git@example.com:foo/bar.git + + Form 1 is output as-is. Form 2 must be converted to URI and form 3 must + be converted to form 1. + + See the corresponding test test_git_remote_url_to_pip() for examples of + sample inputs/outputs. + """ + if re.match(r"\w+://", url): + # This is already valid. Pass it though as-is. + return url + if os.path.exists(url): + # A local bare remote (git clone --mirror). + # Needs a file:// prefix. + return pathlib.PurePath(url).as_uri() + scp_match = SCP_REGEX.match(url) + if scp_match: + # Add an ssh:// prefix and replace the ':' with a '/'. + return scp_match.expand(r"ssh://\1\2/\3") + # Otherwise, bail out. + raise RemoteNotValidError(url) + + @classmethod + def has_commit(cls, location: str, rev: str) -> bool: + """ + Check if rev is a commit that is available in the local repository. + """ + try: + cls.run_command( + ["rev-parse", "-q", "--verify", "sha^" + rev], + cwd=location, + log_failed_cmd=False, + ) + except InstallationError: + return False + else: + return True + + @classmethod + def get_revision(cls, location: str, rev: Optional[str] = None) -> str: + if rev is None: + rev = "HEAD" + current_rev = cls.run_command( + ["rev-parse", rev], + show_stdout=False, + stdout_only=True, + cwd=location, + ) + return current_rev.strip() + + @classmethod + def get_subdirectory(cls, location: str) -> Optional[str]: + """ + Return the path to Python project root, relative to the repo root. + Return None if the project root is in the repo root. + """ + # find the repo root + git_dir = cls.run_command( + ["rev-parse", "--git-dir"], + show_stdout=False, + stdout_only=True, + cwd=location, + ).strip() + if not os.path.isabs(git_dir): + git_dir = os.path.join(location, git_dir) + repo_root = os.path.abspath(os.path.join(git_dir, "..")) + return find_path_to_project_root_from_repo_root(location, repo_root) + + @classmethod + def get_url_rev_and_auth(cls, url: str) -> Tuple[str, Optional[str], AuthInfo]: + """ + Prefixes stub URLs like 'user@hostname:user/repo.git' with 'ssh://'. + That's required because although they use SSH they sometimes don't + work with a ssh:// scheme (e.g. GitHub). But we need a scheme for + parsing. Hence we remove it again afterwards and return it as a stub. + """ + # Works around an apparent Git bug + # (see https://article.gmane.org/gmane.comp.version-control.git/146500) + scheme, netloc, path, query, fragment = urlsplit(url) + if scheme.endswith("file"): + initial_slashes = path[: -len(path.lstrip("/"))] + newpath = initial_slashes + urllib.request.url2pathname(path).replace( + "\\", "/" + ).lstrip("/") + after_plus = scheme.find("+") + 1 + url = scheme[:after_plus] + urlunsplit( + (scheme[after_plus:], netloc, newpath, query, fragment), + ) + + if "://" not in url: + assert "file:" not in url + url = url.replace("git+", "git+ssh://") + url, rev, user_pass = super().get_url_rev_and_auth(url) + url = url.replace("ssh://", "") + else: + url, rev, user_pass = super().get_url_rev_and_auth(url) + + return url, rev, user_pass + + @classmethod + def update_submodules(cls, location: str) -> None: + if not os.path.exists(os.path.join(location, ".gitmodules")): + return + cls.run_command( + ["submodule", "update", "--init", "--recursive", "-q"], + cwd=location, + ) + + @classmethod + def get_repository_root(cls, location: str) -> Optional[str]: + loc = super().get_repository_root(location) + if loc: + return loc + try: + r = cls.run_command( + ["rev-parse", "--show-toplevel"], + cwd=location, + show_stdout=False, + stdout_only=True, + on_returncode="raise", + log_failed_cmd=False, + ) + except BadCommand: + logger.debug( + "could not determine if %s is under git control " + "because git is not available", + location, + ) + return None + except InstallationError: + return None + return os.path.normpath(r.rstrip("\r\n")) + + @staticmethod + def should_add_vcs_url_prefix(repo_url: str) -> bool: + """In either https or ssh form, requirements must be prefixed with git+.""" + return True + + +vcs.register(Git) diff --git a/env/lib/python3.12/site-packages/pip/_internal/vcs/mercurial.py b/env/lib/python3.12/site-packages/pip/_internal/vcs/mercurial.py new file mode 100644 index 0000000..c183d41 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/vcs/mercurial.py @@ -0,0 +1,163 @@ +import configparser +import logging +import os +from typing import List, Optional, Tuple + +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.utils.misc import HiddenText, display_path +from pip._internal.utils.subprocess import make_command +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs.versioncontrol import ( + RevOptions, + VersionControl, + find_path_to_project_root_from_repo_root, + vcs, +) + +logger = logging.getLogger(__name__) + + +class Mercurial(VersionControl): + name = "hg" + dirname = ".hg" + repo_name = "clone" + schemes = ( + "hg+file", + "hg+http", + "hg+https", + "hg+ssh", + "hg+static-http", + ) + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + return [f"--rev={rev}"] + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + rev_display = rev_options.to_display() + logger.info( + "Cloning hg %s%s to %s", + url, + rev_display, + display_path(dest), + ) + if verbosity <= 0: + flags: Tuple[str, ...] = ("--quiet",) + elif verbosity == 1: + flags = () + elif verbosity == 2: + flags = ("--verbose",) + else: + flags = ("--verbose", "--debug") + self.run_command(make_command("clone", "--noupdate", *flags, url, dest)) + self.run_command( + make_command("update", *flags, rev_options.to_args()), + cwd=dest, + ) + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + repo_config = os.path.join(dest, self.dirname, "hgrc") + config = configparser.RawConfigParser() + try: + config.read(repo_config) + config.set("paths", "default", url.secret) + with open(repo_config, "w") as config_file: + config.write(config_file) + except (OSError, configparser.NoSectionError) as exc: + logger.warning("Could not switch Mercurial repository to %s: %s", url, exc) + else: + cmd_args = make_command("update", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + self.run_command(["pull", "-q"], cwd=dest) + cmd_args = make_command("update", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + @classmethod + def get_remote_url(cls, location: str) -> str: + url = cls.run_command( + ["showconfig", "paths.default"], + show_stdout=False, + stdout_only=True, + cwd=location, + ).strip() + if cls._is_local_repository(url): + url = path_to_url(url) + return url.strip() + + @classmethod + def get_revision(cls, location: str) -> str: + """ + Return the repository-local changeset revision number, as an integer. + """ + current_revision = cls.run_command( + ["parents", "--template={rev}"], + show_stdout=False, + stdout_only=True, + cwd=location, + ).strip() + return current_revision + + @classmethod + def get_requirement_revision(cls, location: str) -> str: + """ + Return the changeset identification hash, as a 40-character + hexadecimal string + """ + current_rev_hash = cls.run_command( + ["parents", "--template={node}"], + show_stdout=False, + stdout_only=True, + cwd=location, + ).strip() + return current_rev_hash + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """Always assume the versions don't match""" + return False + + @classmethod + def get_subdirectory(cls, location: str) -> Optional[str]: + """ + Return the path to Python project root, relative to the repo root. + Return None if the project root is in the repo root. + """ + # find the repo root + repo_root = cls.run_command( + ["root"], show_stdout=False, stdout_only=True, cwd=location + ).strip() + if not os.path.isabs(repo_root): + repo_root = os.path.abspath(os.path.join(location, repo_root)) + return find_path_to_project_root_from_repo_root(location, repo_root) + + @classmethod + def get_repository_root(cls, location: str) -> Optional[str]: + loc = super().get_repository_root(location) + if loc: + return loc + try: + r = cls.run_command( + ["root"], + cwd=location, + show_stdout=False, + stdout_only=True, + on_returncode="raise", + log_failed_cmd=False, + ) + except BadCommand: + logger.debug( + "could not determine if %s is under hg control " + "because hg is not available", + location, + ) + return None + except InstallationError: + return None + return os.path.normpath(r.rstrip("\r\n")) + + +vcs.register(Mercurial) diff --git a/env/lib/python3.12/site-packages/pip/_internal/vcs/subversion.py b/env/lib/python3.12/site-packages/pip/_internal/vcs/subversion.py new file mode 100644 index 0000000..f359266 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/vcs/subversion.py @@ -0,0 +1,324 @@ +import logging +import os +import re +from typing import List, Optional, Tuple + +from pip._internal.utils.misc import ( + HiddenText, + display_path, + is_console_interactive, + is_installable_dir, + split_auth_from_netloc, +) +from pip._internal.utils.subprocess import CommandArgs, make_command +from pip._internal.vcs.versioncontrol import ( + AuthInfo, + RemoteNotFoundError, + RevOptions, + VersionControl, + vcs, +) + +logger = logging.getLogger(__name__) + +_svn_xml_url_re = re.compile('url="([^"]+)"') +_svn_rev_re = re.compile(r'committed-rev="(\d+)"') +_svn_info_xml_rev_re = re.compile(r'\s*revision="(\d+)"') +_svn_info_xml_url_re = re.compile(r"(.*)") + + +class Subversion(VersionControl): + name = "svn" + dirname = ".svn" + repo_name = "checkout" + schemes = ("svn+ssh", "svn+http", "svn+https", "svn+svn", "svn+file") + + @classmethod + def should_add_vcs_url_prefix(cls, remote_url: str) -> bool: + return True + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + return ["-r", rev] + + @classmethod + def get_revision(cls, location: str) -> str: + """ + Return the maximum revision for all files under a given location + """ + # Note: taken from setuptools.command.egg_info + revision = 0 + + for base, dirs, _ in os.walk(location): + if cls.dirname not in dirs: + dirs[:] = [] + continue # no sense walking uncontrolled subdirs + dirs.remove(cls.dirname) + entries_fn = os.path.join(base, cls.dirname, "entries") + if not os.path.exists(entries_fn): + # FIXME: should we warn? + continue + + dirurl, localrev = cls._get_svn_url_rev(base) + + if base == location: + assert dirurl is not None + base = dirurl + "/" # save the root url + elif not dirurl or not dirurl.startswith(base): + dirs[:] = [] + continue # not part of the same svn tree, skip it + revision = max(revision, localrev) + return str(revision) + + @classmethod + def get_netloc_and_auth( + cls, netloc: str, scheme: str + ) -> Tuple[str, Tuple[Optional[str], Optional[str]]]: + """ + This override allows the auth information to be passed to svn via the + --username and --password options instead of via the URL. + """ + if scheme == "ssh": + # The --username and --password options can't be used for + # svn+ssh URLs, so keep the auth information in the URL. + return super().get_netloc_and_auth(netloc, scheme) + + return split_auth_from_netloc(netloc) + + @classmethod + def get_url_rev_and_auth(cls, url: str) -> Tuple[str, Optional[str], AuthInfo]: + # hotfix the URL scheme after removing svn+ from svn+ssh:// re-add it + url, rev, user_pass = super().get_url_rev_and_auth(url) + if url.startswith("ssh://"): + url = "svn+" + url + return url, rev, user_pass + + @staticmethod + def make_rev_args( + username: Optional[str], password: Optional[HiddenText] + ) -> CommandArgs: + extra_args: CommandArgs = [] + if username: + extra_args += ["--username", username] + if password: + extra_args += ["--password", password] + + return extra_args + + @classmethod + def get_remote_url(cls, location: str) -> str: + # In cases where the source is in a subdirectory, we have to look up in + # the location until we find a valid project root. + orig_location = location + while not is_installable_dir(location): + last_location = location + location = os.path.dirname(location) + if location == last_location: + # We've traversed up to the root of the filesystem without + # finding a Python project. + logger.warning( + "Could not find Python project for directory %s (tried all " + "parent directories)", + orig_location, + ) + raise RemoteNotFoundError + + url, _rev = cls._get_svn_url_rev(location) + if url is None: + raise RemoteNotFoundError + + return url + + @classmethod + def _get_svn_url_rev(cls, location: str) -> Tuple[Optional[str], int]: + from pip._internal.exceptions import InstallationError + + entries_path = os.path.join(location, cls.dirname, "entries") + if os.path.exists(entries_path): + with open(entries_path) as f: + data = f.read() + else: # subversion >= 1.7 does not have the 'entries' file + data = "" + + url = None + if data.startswith("8") or data.startswith("9") or data.startswith("10"): + entries = list(map(str.splitlines, data.split("\n\x0c\n"))) + del entries[0][0] # get rid of the '8' + url = entries[0][3] + revs = [int(d[9]) for d in entries if len(d) > 9 and d[9]] + [0] + elif data.startswith("= 1.7 + # Note that using get_remote_call_options is not necessary here + # because `svn info` is being run against a local directory. + # We don't need to worry about making sure interactive mode + # is being used to prompt for passwords, because passwords + # are only potentially needed for remote server requests. + xml = cls.run_command( + ["info", "--xml", location], + show_stdout=False, + stdout_only=True, + ) + match = _svn_info_xml_url_re.search(xml) + assert match is not None + url = match.group(1) + revs = [int(m.group(1)) for m in _svn_info_xml_rev_re.finditer(xml)] + except InstallationError: + url, revs = None, [] + + if revs: + rev = max(revs) + else: + rev = 0 + + return url, rev + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """Always assume the versions don't match""" + return False + + def __init__(self, use_interactive: Optional[bool] = None) -> None: + if use_interactive is None: + use_interactive = is_console_interactive() + self.use_interactive = use_interactive + + # This member is used to cache the fetched version of the current + # ``svn`` client. + # Special value definitions: + # None: Not evaluated yet. + # Empty tuple: Could not parse version. + self._vcs_version: Optional[Tuple[int, ...]] = None + + super().__init__() + + def call_vcs_version(self) -> Tuple[int, ...]: + """Query the version of the currently installed Subversion client. + + :return: A tuple containing the parts of the version information or + ``()`` if the version returned from ``svn`` could not be parsed. + :raises: BadCommand: If ``svn`` is not installed. + """ + # Example versions: + # svn, version 1.10.3 (r1842928) + # compiled Feb 25 2019, 14:20:39 on x86_64-apple-darwin17.0.0 + # svn, version 1.7.14 (r1542130) + # compiled Mar 28 2018, 08:49:13 on x86_64-pc-linux-gnu + # svn, version 1.12.0-SlikSvn (SlikSvn/1.12.0) + # compiled May 28 2019, 13:44:56 on x86_64-microsoft-windows6.2 + version_prefix = "svn, version " + version = self.run_command(["--version"], show_stdout=False, stdout_only=True) + if not version.startswith(version_prefix): + return () + + version = version[len(version_prefix) :].split()[0] + version_list = version.partition("-")[0].split(".") + try: + parsed_version = tuple(map(int, version_list)) + except ValueError: + return () + + return parsed_version + + def get_vcs_version(self) -> Tuple[int, ...]: + """Return the version of the currently installed Subversion client. + + If the version of the Subversion client has already been queried, + a cached value will be used. + + :return: A tuple containing the parts of the version information or + ``()`` if the version returned from ``svn`` could not be parsed. + :raises: BadCommand: If ``svn`` is not installed. + """ + if self._vcs_version is not None: + # Use cached version, if available. + # If parsing the version failed previously (empty tuple), + # do not attempt to parse it again. + return self._vcs_version + + vcs_version = self.call_vcs_version() + self._vcs_version = vcs_version + return vcs_version + + def get_remote_call_options(self) -> CommandArgs: + """Return options to be used on calls to Subversion that contact the server. + + These options are applicable for the following ``svn`` subcommands used + in this class. + + - checkout + - switch + - update + + :return: A list of command line arguments to pass to ``svn``. + """ + if not self.use_interactive: + # --non-interactive switch is available since Subversion 0.14.4. + # Subversion < 1.8 runs in interactive mode by default. + return ["--non-interactive"] + + svn_version = self.get_vcs_version() + # By default, Subversion >= 1.8 runs in non-interactive mode if + # stdin is not a TTY. Since that is how pip invokes SVN, in + # call_subprocess(), pip must pass --force-interactive to ensure + # the user can be prompted for a password, if required. + # SVN added the --force-interactive option in SVN 1.8. Since + # e.g. RHEL/CentOS 7, which is supported until 2024, ships with + # SVN 1.7, pip should continue to support SVN 1.7. Therefore, pip + # can't safely add the option if the SVN version is < 1.8 (or unknown). + if svn_version >= (1, 8): + return ["--force-interactive"] + + return [] + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + rev_display = rev_options.to_display() + logger.info( + "Checking out %s%s to %s", + url, + rev_display, + display_path(dest), + ) + if verbosity <= 0: + flags = ["--quiet"] + else: + flags = [] + cmd_args = make_command( + "checkout", + *flags, + self.get_remote_call_options(), + rev_options.to_args(), + url, + dest, + ) + self.run_command(cmd_args) + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + cmd_args = make_command( + "switch", + self.get_remote_call_options(), + rev_options.to_args(), + url, + dest, + ) + self.run_command(cmd_args) + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + cmd_args = make_command( + "update", + self.get_remote_call_options(), + rev_options.to_args(), + dest, + ) + self.run_command(cmd_args) + + +vcs.register(Subversion) diff --git a/env/lib/python3.12/site-packages/pip/_internal/vcs/versioncontrol.py b/env/lib/python3.12/site-packages/pip/_internal/vcs/versioncontrol.py new file mode 100644 index 0000000..a413316 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/vcs/versioncontrol.py @@ -0,0 +1,688 @@ +"""Handles all VCS (version control) support""" + +import logging +import os +import shutil +import sys +import urllib.parse +from dataclasses import dataclass, field +from typing import ( + Any, + Dict, + Iterable, + Iterator, + List, + Literal, + Mapping, + Optional, + Tuple, + Type, + Union, +) + +from pip._internal.cli.spinners import SpinnerInterface +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.utils.misc import ( + HiddenText, + ask_path_exists, + backup_dir, + display_path, + hide_url, + hide_value, + is_installable_dir, + rmtree, +) +from pip._internal.utils.subprocess import ( + CommandArgs, + call_subprocess, + format_command_args, + make_command, +) + +__all__ = ["vcs"] + + +logger = logging.getLogger(__name__) + +AuthInfo = Tuple[Optional[str], Optional[str]] + + +def is_url(name: str) -> bool: + """ + Return true if the name looks like a URL. + """ + scheme = urllib.parse.urlsplit(name).scheme + if not scheme: + return False + return scheme in ["http", "https", "file", "ftp"] + vcs.all_schemes + + +def make_vcs_requirement_url( + repo_url: str, rev: str, project_name: str, subdir: Optional[str] = None +) -> str: + """ + Return the URL for a VCS requirement. + + Args: + repo_url: the remote VCS url, with any needed VCS prefix (e.g. "git+"). + project_name: the (unescaped) project name. + """ + egg_project_name = project_name.replace("-", "_") + req = f"{repo_url}@{rev}#egg={egg_project_name}" + if subdir: + req += f"&subdirectory={subdir}" + + return req + + +def find_path_to_project_root_from_repo_root( + location: str, repo_root: str +) -> Optional[str]: + """ + Find the the Python project's root by searching up the filesystem from + `location`. Return the path to project root relative to `repo_root`. + Return None if the project root is `repo_root`, or cannot be found. + """ + # find project root. + orig_location = location + while not is_installable_dir(location): + last_location = location + location = os.path.dirname(location) + if location == last_location: + # We've traversed up to the root of the filesystem without + # finding a Python project. + logger.warning( + "Could not find a Python project for directory %s (tried all " + "parent directories)", + orig_location, + ) + return None + + if os.path.samefile(repo_root, location): + return None + + return os.path.relpath(location, repo_root) + + +class RemoteNotFoundError(Exception): + pass + + +class RemoteNotValidError(Exception): + def __init__(self, url: str): + super().__init__(url) + self.url = url + + +@dataclass(frozen=True) +class RevOptions: + """ + Encapsulates a VCS-specific revision to install, along with any VCS + install options. + + Args: + vc_class: a VersionControl subclass. + rev: the name of the revision to install. + extra_args: a list of extra options. + """ + + vc_class: Type["VersionControl"] + rev: Optional[str] = None + extra_args: CommandArgs = field(default_factory=list) + branch_name: Optional[str] = None + + def __repr__(self) -> str: + return f"" + + @property + def arg_rev(self) -> Optional[str]: + if self.rev is None: + return self.vc_class.default_arg_rev + + return self.rev + + def to_args(self) -> CommandArgs: + """ + Return the VCS-specific command arguments. + """ + args: CommandArgs = [] + rev = self.arg_rev + if rev is not None: + args += self.vc_class.get_base_rev_args(rev) + args += self.extra_args + + return args + + def to_display(self) -> str: + if not self.rev: + return "" + + return f" (to revision {self.rev})" + + def make_new(self, rev: str) -> "RevOptions": + """ + Make a copy of the current instance, but with a new rev. + + Args: + rev: the name of the revision for the new object. + """ + return self.vc_class.make_rev_options(rev, extra_args=self.extra_args) + + +class VcsSupport: + _registry: Dict[str, "VersionControl"] = {} + schemes = ["ssh", "git", "hg", "bzr", "sftp", "svn"] + + def __init__(self) -> None: + # Register more schemes with urlparse for various version control + # systems + urllib.parse.uses_netloc.extend(self.schemes) + super().__init__() + + def __iter__(self) -> Iterator[str]: + return self._registry.__iter__() + + @property + def backends(self) -> List["VersionControl"]: + return list(self._registry.values()) + + @property + def dirnames(self) -> List[str]: + return [backend.dirname for backend in self.backends] + + @property + def all_schemes(self) -> List[str]: + schemes: List[str] = [] + for backend in self.backends: + schemes.extend(backend.schemes) + return schemes + + def register(self, cls: Type["VersionControl"]) -> None: + if not hasattr(cls, "name"): + logger.warning("Cannot register VCS %s", cls.__name__) + return + if cls.name not in self._registry: + self._registry[cls.name] = cls() + logger.debug("Registered VCS backend: %s", cls.name) + + def unregister(self, name: str) -> None: + if name in self._registry: + del self._registry[name] + + def get_backend_for_dir(self, location: str) -> Optional["VersionControl"]: + """ + Return a VersionControl object if a repository of that type is found + at the given directory. + """ + vcs_backends = {} + for vcs_backend in self._registry.values(): + repo_path = vcs_backend.get_repository_root(location) + if not repo_path: + continue + logger.debug("Determine that %s uses VCS: %s", location, vcs_backend.name) + vcs_backends[repo_path] = vcs_backend + + if not vcs_backends: + return None + + # Choose the VCS in the inner-most directory. Since all repository + # roots found here would be either `location` or one of its + # parents, the longest path should have the most path components, + # i.e. the backend representing the inner-most repository. + inner_most_repo_path = max(vcs_backends, key=len) + return vcs_backends[inner_most_repo_path] + + def get_backend_for_scheme(self, scheme: str) -> Optional["VersionControl"]: + """ + Return a VersionControl object or None. + """ + for vcs_backend in self._registry.values(): + if scheme in vcs_backend.schemes: + return vcs_backend + return None + + def get_backend(self, name: str) -> Optional["VersionControl"]: + """ + Return a VersionControl object or None. + """ + name = name.lower() + return self._registry.get(name) + + +vcs = VcsSupport() + + +class VersionControl: + name = "" + dirname = "" + repo_name = "" + # List of supported schemes for this Version Control + schemes: Tuple[str, ...] = () + # Iterable of environment variable names to pass to call_subprocess(). + unset_environ: Tuple[str, ...] = () + default_arg_rev: Optional[str] = None + + @classmethod + def should_add_vcs_url_prefix(cls, remote_url: str) -> bool: + """ + Return whether the vcs prefix (e.g. "git+") should be added to a + repository's remote url when used in a requirement. + """ + return not remote_url.lower().startswith(f"{cls.name}:") + + @classmethod + def get_subdirectory(cls, location: str) -> Optional[str]: + """ + Return the path to Python project root, relative to the repo root. + Return None if the project root is in the repo root. + """ + return None + + @classmethod + def get_requirement_revision(cls, repo_dir: str) -> str: + """ + Return the revision string that should be used in a requirement. + """ + return cls.get_revision(repo_dir) + + @classmethod + def get_src_requirement(cls, repo_dir: str, project_name: str) -> str: + """ + Return the requirement string to use to redownload the files + currently at the given repository directory. + + Args: + project_name: the (unescaped) project name. + + The return value has a form similar to the following: + + {repository_url}@{revision}#egg={project_name} + """ + repo_url = cls.get_remote_url(repo_dir) + + if cls.should_add_vcs_url_prefix(repo_url): + repo_url = f"{cls.name}+{repo_url}" + + revision = cls.get_requirement_revision(repo_dir) + subdir = cls.get_subdirectory(repo_dir) + req = make_vcs_requirement_url(repo_url, revision, project_name, subdir=subdir) + + return req + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + """ + Return the base revision arguments for a vcs command. + + Args: + rev: the name of a revision to install. Cannot be None. + """ + raise NotImplementedError + + def is_immutable_rev_checkout(self, url: str, dest: str) -> bool: + """ + Return true if the commit hash checked out at dest matches + the revision in url. + + Always return False, if the VCS does not support immutable commit + hashes. + + This method does not check if there are local uncommitted changes + in dest after checkout, as pip currently has no use case for that. + """ + return False + + @classmethod + def make_rev_options( + cls, rev: Optional[str] = None, extra_args: Optional[CommandArgs] = None + ) -> RevOptions: + """ + Return a RevOptions object. + + Args: + rev: the name of a revision to install. + extra_args: a list of extra options. + """ + return RevOptions(cls, rev, extra_args=extra_args or []) + + @classmethod + def _is_local_repository(cls, repo: str) -> bool: + """ + posix absolute paths start with os.path.sep, + win32 ones start with drive (like c:\\folder) + """ + drive, tail = os.path.splitdrive(repo) + return repo.startswith(os.path.sep) or bool(drive) + + @classmethod + def get_netloc_and_auth( + cls, netloc: str, scheme: str + ) -> Tuple[str, Tuple[Optional[str], Optional[str]]]: + """ + Parse the repository URL's netloc, and return the new netloc to use + along with auth information. + + Args: + netloc: the original repository URL netloc. + scheme: the repository URL's scheme without the vcs prefix. + + This is mainly for the Subversion class to override, so that auth + information can be provided via the --username and --password options + instead of through the URL. For other subclasses like Git without + such an option, auth information must stay in the URL. + + Returns: (netloc, (username, password)). + """ + return netloc, (None, None) + + @classmethod + def get_url_rev_and_auth(cls, url: str) -> Tuple[str, Optional[str], AuthInfo]: + """ + Parse the repository URL to use, and return the URL, revision, + and auth info to use. + + Returns: (url, rev, (username, password)). + """ + scheme, netloc, path, query, frag = urllib.parse.urlsplit(url) + if "+" not in scheme: + raise ValueError( + f"Sorry, {url!r} is a malformed VCS url. " + "The format is +://, " + "e.g. svn+http://myrepo/svn/MyApp#egg=MyApp" + ) + # Remove the vcs prefix. + scheme = scheme.split("+", 1)[1] + netloc, user_pass = cls.get_netloc_and_auth(netloc, scheme) + rev = None + if "@" in path: + path, rev = path.rsplit("@", 1) + if not rev: + raise InstallationError( + f"The URL {url!r} has an empty revision (after @) " + "which is not supported. Include a revision after @ " + "or remove @ from the URL." + ) + url = urllib.parse.urlunsplit((scheme, netloc, path, query, "")) + return url, rev, user_pass + + @staticmethod + def make_rev_args( + username: Optional[str], password: Optional[HiddenText] + ) -> CommandArgs: + """ + Return the RevOptions "extra arguments" to use in obtain(). + """ + return [] + + def get_url_rev_options(self, url: HiddenText) -> Tuple[HiddenText, RevOptions]: + """ + Return the URL and RevOptions object to use in obtain(), + as a tuple (url, rev_options). + """ + secret_url, rev, user_pass = self.get_url_rev_and_auth(url.secret) + username, secret_password = user_pass + password: Optional[HiddenText] = None + if secret_password is not None: + password = hide_value(secret_password) + extra_args = self.make_rev_args(username, password) + rev_options = self.make_rev_options(rev, extra_args=extra_args) + + return hide_url(secret_url), rev_options + + @staticmethod + def normalize_url(url: str) -> str: + """ + Normalize a URL for comparison by unquoting it and removing any + trailing slash. + """ + return urllib.parse.unquote(url).rstrip("/") + + @classmethod + def compare_urls(cls, url1: str, url2: str) -> bool: + """ + Compare two repo URLs for identity, ignoring incidental differences. + """ + return cls.normalize_url(url1) == cls.normalize_url(url2) + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + """ + Fetch a revision from a repository, in the case that this is the + first fetch from the repository. + + Args: + dest: the directory to fetch the repository to. + rev_options: a RevOptions object. + verbosity: verbosity level. + """ + raise NotImplementedError + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + """ + Switch the repo at ``dest`` to point to ``URL``. + + Args: + rev_options: a RevOptions object. + """ + raise NotImplementedError + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + """ + Update an already-existing repo to the given ``rev_options``. + + Args: + rev_options: a RevOptions object. + """ + raise NotImplementedError + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """ + Return whether the id of the current commit equals the given name. + + Args: + dest: the repository directory. + name: a string name. + """ + raise NotImplementedError + + def obtain(self, dest: str, url: HiddenText, verbosity: int) -> None: + """ + Install or update in editable mode the package represented by this + VersionControl object. + + :param dest: the repository directory in which to install or update. + :param url: the repository URL starting with a vcs prefix. + :param verbosity: verbosity level. + """ + url, rev_options = self.get_url_rev_options(url) + + if not os.path.exists(dest): + self.fetch_new(dest, url, rev_options, verbosity=verbosity) + return + + rev_display = rev_options.to_display() + if self.is_repository_directory(dest): + existing_url = self.get_remote_url(dest) + if self.compare_urls(existing_url, url.secret): + logger.debug( + "%s in %s exists, and has correct URL (%s)", + self.repo_name.title(), + display_path(dest), + url, + ) + if not self.is_commit_id_equal(dest, rev_options.rev): + logger.info( + "Updating %s %s%s", + display_path(dest), + self.repo_name, + rev_display, + ) + self.update(dest, url, rev_options) + else: + logger.info("Skipping because already up-to-date.") + return + + logger.warning( + "%s %s in %s exists with URL %s", + self.name, + self.repo_name, + display_path(dest), + existing_url, + ) + prompt = ("(s)witch, (i)gnore, (w)ipe, (b)ackup ", ("s", "i", "w", "b")) + else: + logger.warning( + "Directory %s already exists, and is not a %s %s.", + dest, + self.name, + self.repo_name, + ) + # https://github.com/python/mypy/issues/1174 + prompt = ("(i)gnore, (w)ipe, (b)ackup ", ("i", "w", "b")) # type: ignore + + logger.warning( + "The plan is to install the %s repository %s", + self.name, + url, + ) + response = ask_path_exists(f"What to do? {prompt[0]}", prompt[1]) + + if response == "a": + sys.exit(-1) + + if response == "w": + logger.warning("Deleting %s", display_path(dest)) + rmtree(dest) + self.fetch_new(dest, url, rev_options, verbosity=verbosity) + return + + if response == "b": + dest_dir = backup_dir(dest) + logger.warning("Backing up %s to %s", display_path(dest), dest_dir) + shutil.move(dest, dest_dir) + self.fetch_new(dest, url, rev_options, verbosity=verbosity) + return + + # Do nothing if the response is "i". + if response == "s": + logger.info( + "Switching %s %s to %s%s", + self.repo_name, + display_path(dest), + url, + rev_display, + ) + self.switch(dest, url, rev_options) + + def unpack(self, location: str, url: HiddenText, verbosity: int) -> None: + """ + Clean up current location and download the url repository + (and vcs infos) into location + + :param url: the repository URL starting with a vcs prefix. + :param verbosity: verbosity level. + """ + if os.path.exists(location): + rmtree(location) + self.obtain(location, url=url, verbosity=verbosity) + + @classmethod + def get_remote_url(cls, location: str) -> str: + """ + Return the url used at location + + Raises RemoteNotFoundError if the repository does not have a remote + url configured. + """ + raise NotImplementedError + + @classmethod + def get_revision(cls, location: str) -> str: + """ + Return the current commit id of the files at the given location. + """ + raise NotImplementedError + + @classmethod + def run_command( + cls, + cmd: Union[List[str], CommandArgs], + show_stdout: bool = True, + cwd: Optional[str] = None, + on_returncode: 'Literal["raise", "warn", "ignore"]' = "raise", + extra_ok_returncodes: Optional[Iterable[int]] = None, + command_desc: Optional[str] = None, + extra_environ: Optional[Mapping[str, Any]] = None, + spinner: Optional[SpinnerInterface] = None, + log_failed_cmd: bool = True, + stdout_only: bool = False, + ) -> str: + """ + Run a VCS subcommand + This is simply a wrapper around call_subprocess that adds the VCS + command name, and checks that the VCS is available + """ + cmd = make_command(cls.name, *cmd) + if command_desc is None: + command_desc = format_command_args(cmd) + try: + return call_subprocess( + cmd, + show_stdout, + cwd, + on_returncode=on_returncode, + extra_ok_returncodes=extra_ok_returncodes, + command_desc=command_desc, + extra_environ=extra_environ, + unset_environ=cls.unset_environ, + spinner=spinner, + log_failed_cmd=log_failed_cmd, + stdout_only=stdout_only, + ) + except NotADirectoryError: + raise BadCommand(f"Cannot find command {cls.name!r} - invalid PATH") + except FileNotFoundError: + # errno.ENOENT = no such file or directory + # In other words, the VCS executable isn't available + raise BadCommand( + f"Cannot find command {cls.name!r} - do you have " + f"{cls.name!r} installed and in your PATH?" + ) + except PermissionError: + # errno.EACCES = Permission denied + # This error occurs, for instance, when the command is installed + # only for another user. So, the current user don't have + # permission to call the other user command. + raise BadCommand( + f"No permission to execute {cls.name!r} - install it " + f"locally, globally (ask admin), or check your PATH. " + f"See possible solutions at " + f"https://pip.pypa.io/en/latest/reference/pip_freeze/" + f"#fixing-permission-denied." + ) + + @classmethod + def is_repository_directory(cls, path: str) -> bool: + """ + Return whether a directory path is a repository directory. + """ + logger.debug("Checking in %s for %s (%s)...", path, cls.dirname, cls.name) + return os.path.exists(os.path.join(path, cls.dirname)) + + @classmethod + def get_repository_root(cls, location: str) -> Optional[str]: + """ + Return the "root" (top-level) directory controlled by the vcs, + or `None` if the directory is not in any. + + It is meant to be overridden to implement smarter detection + mechanisms for specific vcs. + + This can do more than is_repository_directory() alone. For + example, the Git override checks that Git is actually available. + """ + if cls.is_repository_directory(location): + return location + return None diff --git a/env/lib/python3.12/site-packages/pip/_internal/wheel_builder.py b/env/lib/python3.12/site-packages/pip/_internal/wheel_builder.py new file mode 100644 index 0000000..93f8e1f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_internal/wheel_builder.py @@ -0,0 +1,354 @@ +"""Orchestrator for building wheels from InstallRequirements. +""" + +import logging +import os.path +import re +import shutil +from typing import Iterable, List, Optional, Tuple + +from pip._vendor.packaging.utils import canonicalize_name, canonicalize_version +from pip._vendor.packaging.version import InvalidVersion, Version + +from pip._internal.cache import WheelCache +from pip._internal.exceptions import InvalidWheelFilename, UnsupportedWheel +from pip._internal.metadata import FilesystemWheel, get_wheel_distribution +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.operations.build.wheel import build_wheel_pep517 +from pip._internal.operations.build.wheel_editable import build_wheel_editable +from pip._internal.operations.build.wheel_legacy import build_wheel_legacy +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import ensure_dir, hash_file +from pip._internal.utils.setuptools_build import make_setuptools_clean_args +from pip._internal.utils.subprocess import call_subprocess +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs import vcs + +logger = logging.getLogger(__name__) + +_egg_info_re = re.compile(r"([a-z0-9_.]+)-([a-z0-9_.!+-]+)", re.IGNORECASE) + +BuildResult = Tuple[List[InstallRequirement], List[InstallRequirement]] + + +def _contains_egg_info(s: str) -> bool: + """Determine whether the string looks like an egg_info. + + :param s: The string to parse. E.g. foo-2.1 + """ + return bool(_egg_info_re.search(s)) + + +def _should_build( + req: InstallRequirement, + need_wheel: bool, +) -> bool: + """Return whether an InstallRequirement should be built into a wheel.""" + if req.constraint: + # never build requirements that are merely constraints + return False + if req.is_wheel: + if need_wheel: + logger.info( + "Skipping %s, due to already being wheel.", + req.name, + ) + return False + + if need_wheel: + # i.e. pip wheel, not pip install + return True + + # From this point, this concerns the pip install command only + # (need_wheel=False). + + if not req.source_dir: + return False + + if req.editable: + # we only build PEP 660 editable requirements + return req.supports_pyproject_editable + + return True + + +def should_build_for_wheel_command( + req: InstallRequirement, +) -> bool: + return _should_build(req, need_wheel=True) + + +def should_build_for_install_command( + req: InstallRequirement, +) -> bool: + return _should_build(req, need_wheel=False) + + +def _should_cache( + req: InstallRequirement, +) -> Optional[bool]: + """ + Return whether a built InstallRequirement can be stored in the persistent + wheel cache, assuming the wheel cache is available, and _should_build() + has determined a wheel needs to be built. + """ + if req.editable or not req.source_dir: + # never cache editable requirements + return False + + if req.link and req.link.is_vcs: + # VCS checkout. Do not cache + # unless it points to an immutable commit hash. + assert not req.editable + assert req.source_dir + vcs_backend = vcs.get_backend_for_scheme(req.link.scheme) + assert vcs_backend + if vcs_backend.is_immutable_rev_checkout(req.link.url, req.source_dir): + return True + return False + + assert req.link + base, ext = req.link.splitext() + if _contains_egg_info(base): + return True + + # Otherwise, do not cache. + return False + + +def _get_cache_dir( + req: InstallRequirement, + wheel_cache: WheelCache, +) -> str: + """Return the persistent or temporary cache directory where the built + wheel need to be stored. + """ + cache_available = bool(wheel_cache.cache_dir) + assert req.link + if cache_available and _should_cache(req): + cache_dir = wheel_cache.get_path_for_link(req.link) + else: + cache_dir = wheel_cache.get_ephem_path_for_link(req.link) + return cache_dir + + +def _verify_one(req: InstallRequirement, wheel_path: str) -> None: + canonical_name = canonicalize_name(req.name or "") + w = Wheel(os.path.basename(wheel_path)) + if canonicalize_name(w.name) != canonical_name: + raise InvalidWheelFilename( + f"Wheel has unexpected file name: expected {canonical_name!r}, " + f"got {w.name!r}", + ) + dist = get_wheel_distribution(FilesystemWheel(wheel_path), canonical_name) + dist_verstr = str(dist.version) + if canonicalize_version(dist_verstr) != canonicalize_version(w.version): + raise InvalidWheelFilename( + f"Wheel has unexpected file name: expected {dist_verstr!r}, " + f"got {w.version!r}", + ) + metadata_version_value = dist.metadata_version + if metadata_version_value is None: + raise UnsupportedWheel("Missing Metadata-Version") + try: + metadata_version = Version(metadata_version_value) + except InvalidVersion: + msg = f"Invalid Metadata-Version: {metadata_version_value}" + raise UnsupportedWheel(msg) + if metadata_version >= Version("1.2") and not isinstance(dist.version, Version): + raise UnsupportedWheel( + f"Metadata 1.2 mandates PEP 440 version, but {dist_verstr!r} is not" + ) + + +def _build_one( + req: InstallRequirement, + output_dir: str, + verify: bool, + build_options: List[str], + global_options: List[str], + editable: bool, +) -> Optional[str]: + """Build one wheel. + + :return: The filename of the built wheel, or None if the build failed. + """ + artifact = "editable" if editable else "wheel" + try: + ensure_dir(output_dir) + except OSError as e: + logger.warning( + "Building %s for %s failed: %s", + artifact, + req.name, + e, + ) + return None + + # Install build deps into temporary directory (PEP 518) + with req.build_env: + wheel_path = _build_one_inside_env( + req, output_dir, build_options, global_options, editable + ) + if wheel_path and verify: + try: + _verify_one(req, wheel_path) + except (InvalidWheelFilename, UnsupportedWheel) as e: + logger.warning("Built %s for %s is invalid: %s", artifact, req.name, e) + return None + return wheel_path + + +def _build_one_inside_env( + req: InstallRequirement, + output_dir: str, + build_options: List[str], + global_options: List[str], + editable: bool, +) -> Optional[str]: + with TempDirectory(kind="wheel") as temp_dir: + assert req.name + if req.use_pep517: + assert req.metadata_directory + assert req.pep517_backend + if global_options: + logger.warning( + "Ignoring --global-option when building %s using PEP 517", req.name + ) + if build_options: + logger.warning( + "Ignoring --build-option when building %s using PEP 517", req.name + ) + if editable: + wheel_path = build_wheel_editable( + name=req.name, + backend=req.pep517_backend, + metadata_directory=req.metadata_directory, + tempd=temp_dir.path, + ) + else: + wheel_path = build_wheel_pep517( + name=req.name, + backend=req.pep517_backend, + metadata_directory=req.metadata_directory, + tempd=temp_dir.path, + ) + else: + wheel_path = build_wheel_legacy( + name=req.name, + setup_py_path=req.setup_py_path, + source_dir=req.unpacked_source_directory, + global_options=global_options, + build_options=build_options, + tempd=temp_dir.path, + ) + + if wheel_path is not None: + wheel_name = os.path.basename(wheel_path) + dest_path = os.path.join(output_dir, wheel_name) + try: + wheel_hash, length = hash_file(wheel_path) + shutil.move(wheel_path, dest_path) + logger.info( + "Created wheel for %s: filename=%s size=%d sha256=%s", + req.name, + wheel_name, + length, + wheel_hash.hexdigest(), + ) + logger.info("Stored in directory: %s", output_dir) + return dest_path + except Exception as e: + logger.warning( + "Building wheel for %s failed: %s", + req.name, + e, + ) + # Ignore return, we can't do anything else useful. + if not req.use_pep517: + _clean_one_legacy(req, global_options) + return None + + +def _clean_one_legacy(req: InstallRequirement, global_options: List[str]) -> bool: + clean_args = make_setuptools_clean_args( + req.setup_py_path, + global_options=global_options, + ) + + logger.info("Running setup.py clean for %s", req.name) + try: + call_subprocess( + clean_args, command_desc="python setup.py clean", cwd=req.source_dir + ) + return True + except Exception: + logger.error("Failed cleaning build dir for %s", req.name) + return False + + +def build( + requirements: Iterable[InstallRequirement], + wheel_cache: WheelCache, + verify: bool, + build_options: List[str], + global_options: List[str], +) -> BuildResult: + """Build wheels. + + :return: The list of InstallRequirement that succeeded to build and + the list of InstallRequirement that failed to build. + """ + if not requirements: + return [], [] + + # Build the wheels. + logger.info( + "Building wheels for collected packages: %s", + ", ".join(req.name for req in requirements), # type: ignore + ) + + with indent_log(): + build_successes, build_failures = [], [] + for req in requirements: + assert req.name + cache_dir = _get_cache_dir(req, wheel_cache) + wheel_file = _build_one( + req, + cache_dir, + verify, + build_options, + global_options, + req.editable and req.permit_editable_wheels, + ) + if wheel_file: + # Record the download origin in the cache + if req.download_info is not None: + # download_info is guaranteed to be set because when we build an + # InstallRequirement it has been through the preparer before, but + # let's be cautious. + wheel_cache.record_download_origin(cache_dir, req.download_info) + # Update the link for this. + req.link = Link(path_to_url(wheel_file)) + req.local_file_path = req.link.file_path + assert req.link.is_wheel + build_successes.append(req) + else: + build_failures.append(req) + + # notify success/failure + if build_successes: + logger.info( + "Successfully built %s", + " ".join([req.name for req in build_successes]), # type: ignore + ) + if build_failures: + logger.info( + "Failed to build %s", + " ".join([req.name for req in build_failures]), # type: ignore + ) + # Return a list of requirements that failed to build + return build_successes, build_failures diff --git a/env/lib/python3.12/site-packages/pip/_vendor/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/__init__.py new file mode 100644 index 0000000..561089c --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/__init__.py @@ -0,0 +1,116 @@ +""" +pip._vendor is for vendoring dependencies of pip to prevent needing pip to +depend on something external. + +Files inside of pip._vendor should be considered immutable and should only be +updated to versions from upstream. +""" +from __future__ import absolute_import + +import glob +import os.path +import sys + +# Downstream redistributors which have debundled our dependencies should also +# patch this value to be true. This will trigger the additional patching +# to cause things like "six" to be available as pip. +DEBUNDLED = False + +# By default, look in this directory for a bunch of .whl files which we will +# add to the beginning of sys.path before attempting to import anything. This +# is done to support downstream re-distributors like Debian and Fedora who +# wish to create their own Wheels for our dependencies to aid in debundling. +WHEEL_DIR = os.path.abspath(os.path.dirname(__file__)) + + +# Define a small helper function to alias our vendored modules to the real ones +# if the vendored ones do not exist. This idea of this was taken from +# https://github.com/kennethreitz/requests/pull/2567. +def vendored(modulename): + vendored_name = "{0}.{1}".format(__name__, modulename) + + try: + __import__(modulename, globals(), locals(), level=0) + except ImportError: + # We can just silently allow import failures to pass here. If we + # got to this point it means that ``import pip._vendor.whatever`` + # failed and so did ``import whatever``. Since we're importing this + # upfront in an attempt to alias imports, not erroring here will + # just mean we get a regular import error whenever pip *actually* + # tries to import one of these modules to use it, which actually + # gives us a better error message than we would have otherwise + # gotten. + pass + else: + sys.modules[vendored_name] = sys.modules[modulename] + base, head = vendored_name.rsplit(".", 1) + setattr(sys.modules[base], head, sys.modules[modulename]) + + +# If we're operating in a debundled setup, then we want to go ahead and trigger +# the aliasing of our vendored libraries as well as looking for wheels to add +# to our sys.path. This will cause all of this code to be a no-op typically +# however downstream redistributors can enable it in a consistent way across +# all platforms. +if DEBUNDLED: + # Actually look inside of WHEEL_DIR to find .whl files and add them to the + # front of our sys.path. + sys.path[:] = glob.glob(os.path.join(WHEEL_DIR, "*.whl")) + sys.path + + # Actually alias all of our vendored dependencies. + vendored("cachecontrol") + vendored("certifi") + vendored("distlib") + vendored("distro") + vendored("packaging") + vendored("packaging.version") + vendored("packaging.specifiers") + vendored("pkg_resources") + vendored("platformdirs") + vendored("progress") + vendored("pyproject_hooks") + vendored("requests") + vendored("requests.exceptions") + vendored("requests.packages") + vendored("requests.packages.urllib3") + vendored("requests.packages.urllib3._collections") + vendored("requests.packages.urllib3.connection") + vendored("requests.packages.urllib3.connectionpool") + vendored("requests.packages.urllib3.contrib") + vendored("requests.packages.urllib3.contrib.ntlmpool") + vendored("requests.packages.urllib3.contrib.pyopenssl") + vendored("requests.packages.urllib3.exceptions") + vendored("requests.packages.urllib3.fields") + vendored("requests.packages.urllib3.filepost") + vendored("requests.packages.urllib3.packages") + vendored("requests.packages.urllib3.packages.ordered_dict") + vendored("requests.packages.urllib3.packages.six") + vendored("requests.packages.urllib3.packages.ssl_match_hostname") + vendored("requests.packages.urllib3.packages.ssl_match_hostname." + "_implementation") + vendored("requests.packages.urllib3.poolmanager") + vendored("requests.packages.urllib3.request") + vendored("requests.packages.urllib3.response") + vendored("requests.packages.urllib3.util") + vendored("requests.packages.urllib3.util.connection") + vendored("requests.packages.urllib3.util.request") + vendored("requests.packages.urllib3.util.response") + vendored("requests.packages.urllib3.util.retry") + vendored("requests.packages.urllib3.util.ssl_") + vendored("requests.packages.urllib3.util.timeout") + vendored("requests.packages.urllib3.util.url") + vendored("resolvelib") + vendored("rich") + vendored("rich.console") + vendored("rich.highlighter") + vendored("rich.logging") + vendored("rich.markup") + vendored("rich.progress") + vendored("rich.segment") + vendored("rich.style") + vendored("rich.text") + vendored("rich.traceback") + if sys.version_info < (3, 11): + vendored("tomli") + vendored("truststore") + vendored("urllib3") diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__init__.py new file mode 100644 index 0000000..2191624 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__init__.py @@ -0,0 +1,29 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 + +"""CacheControl import Interface. + +Make it easy to import from cachecontrol without long namespaces. +""" + +__author__ = "Eric Larson" +__email__ = "eric@ionrock.org" +__version__ = "0.14.1" + +from pip._vendor.cachecontrol.adapter import CacheControlAdapter +from pip._vendor.cachecontrol.controller import CacheController +from pip._vendor.cachecontrol.wrapper import CacheControl + +__all__ = [ + "__author__", + "__email__", + "__version__", + "CacheControlAdapter", + "CacheController", + "CacheControl", +] + +import logging + +logging.getLogger(__name__).addHandler(logging.NullHandler()) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/_cmd.py b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/_cmd.py new file mode 100644 index 0000000..2c84208 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/_cmd.py @@ -0,0 +1,70 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import logging +from argparse import ArgumentParser +from typing import TYPE_CHECKING + +from pip._vendor import requests + +from pip._vendor.cachecontrol.adapter import CacheControlAdapter +from pip._vendor.cachecontrol.cache import DictCache +from pip._vendor.cachecontrol.controller import logger + +if TYPE_CHECKING: + from argparse import Namespace + + from pip._vendor.cachecontrol.controller import CacheController + + +def setup_logging() -> None: + logger.setLevel(logging.DEBUG) + handler = logging.StreamHandler() + logger.addHandler(handler) + + +def get_session() -> requests.Session: + adapter = CacheControlAdapter( + DictCache(), cache_etags=True, serializer=None, heuristic=None + ) + sess = requests.Session() + sess.mount("http://", adapter) + sess.mount("https://", adapter) + + sess.cache_controller = adapter.controller # type: ignore[attr-defined] + return sess + + +def get_args() -> Namespace: + parser = ArgumentParser() + parser.add_argument("url", help="The URL to try and cache") + return parser.parse_args() + + +def main() -> None: + args = get_args() + sess = get_session() + + # Make a request to get a response + resp = sess.get(args.url) + + # Turn on logging + setup_logging() + + # try setting the cache + cache_controller: CacheController = ( + sess.cache_controller # type: ignore[attr-defined] + ) + cache_controller.cache_response(resp.request, resp.raw) + + # Now try to get it + if cache_controller.cached_request(resp.request): + print("Cached!") + else: + print("Not cached :(") + + +if __name__ == "__main__": + main() diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/adapter.py b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/adapter.py new file mode 100644 index 0000000..34a9eb8 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/adapter.py @@ -0,0 +1,161 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import functools +import types +import zlib +from typing import TYPE_CHECKING, Any, Collection, Mapping + +from pip._vendor.requests.adapters import HTTPAdapter + +from pip._vendor.cachecontrol.cache import DictCache +from pip._vendor.cachecontrol.controller import PERMANENT_REDIRECT_STATUSES, CacheController +from pip._vendor.cachecontrol.filewrapper import CallbackFileWrapper + +if TYPE_CHECKING: + from pip._vendor.requests import PreparedRequest, Response + from pip._vendor.urllib3 import HTTPResponse + + from pip._vendor.cachecontrol.cache import BaseCache + from pip._vendor.cachecontrol.heuristics import BaseHeuristic + from pip._vendor.cachecontrol.serialize import Serializer + + +class CacheControlAdapter(HTTPAdapter): + invalidating_methods = {"PUT", "PATCH", "DELETE"} + + def __init__( + self, + cache: BaseCache | None = None, + cache_etags: bool = True, + controller_class: type[CacheController] | None = None, + serializer: Serializer | None = None, + heuristic: BaseHeuristic | None = None, + cacheable_methods: Collection[str] | None = None, + *args: Any, + **kw: Any, + ) -> None: + super().__init__(*args, **kw) + self.cache = DictCache() if cache is None else cache + self.heuristic = heuristic + self.cacheable_methods = cacheable_methods or ("GET",) + + controller_factory = controller_class or CacheController + self.controller = controller_factory( + self.cache, cache_etags=cache_etags, serializer=serializer + ) + + def send( + self, + request: PreparedRequest, + stream: bool = False, + timeout: None | float | tuple[float, float] | tuple[float, None] = None, + verify: bool | str = True, + cert: (None | bytes | str | tuple[bytes | str, bytes | str]) = None, + proxies: Mapping[str, str] | None = None, + cacheable_methods: Collection[str] | None = None, + ) -> Response: + """ + Send a request. Use the request information to see if it + exists in the cache and cache the response if we need to and can. + """ + cacheable = cacheable_methods or self.cacheable_methods + if request.method in cacheable: + try: + cached_response = self.controller.cached_request(request) + except zlib.error: + cached_response = None + if cached_response: + return self.build_response(request, cached_response, from_cache=True) + + # check for etags and add headers if appropriate + request.headers.update(self.controller.conditional_headers(request)) + + resp = super().send(request, stream, timeout, verify, cert, proxies) + + return resp + + def build_response( # type: ignore[override] + self, + request: PreparedRequest, + response: HTTPResponse, + from_cache: bool = False, + cacheable_methods: Collection[str] | None = None, + ) -> Response: + """ + Build a response by making a request or using the cache. + + This will end up calling send and returning a potentially + cached response + """ + cacheable = cacheable_methods or self.cacheable_methods + if not from_cache and request.method in cacheable: + # Check for any heuristics that might update headers + # before trying to cache. + if self.heuristic: + response = self.heuristic.apply(response) + + # apply any expiration heuristics + if response.status == 304: + # We must have sent an ETag request. This could mean + # that we've been expired already or that we simply + # have an etag. In either case, we want to try and + # update the cache if that is the case. + cached_response = self.controller.update_cached_response( + request, response + ) + + if cached_response is not response: + from_cache = True + + # We are done with the server response, read a + # possible response body (compliant servers will + # not return one, but we cannot be 100% sure) and + # release the connection back to the pool. + response.read(decode_content=False) + response.release_conn() + + response = cached_response + + # We always cache the 301 responses + elif int(response.status) in PERMANENT_REDIRECT_STATUSES: + self.controller.cache_response(request, response) + else: + # Wrap the response file with a wrapper that will cache the + # response when the stream has been consumed. + response._fp = CallbackFileWrapper( # type: ignore[assignment] + response._fp, # type: ignore[arg-type] + functools.partial( + self.controller.cache_response, request, response + ), + ) + if response.chunked: + super_update_chunk_length = response._update_chunk_length + + def _update_chunk_length(self: HTTPResponse) -> None: + super_update_chunk_length() + if self.chunk_left == 0: + self._fp._close() # type: ignore[union-attr] + + response._update_chunk_length = types.MethodType( # type: ignore[method-assign] + _update_chunk_length, response + ) + + resp: Response = super().build_response(request, response) + + # See if we should invalidate the cache. + if request.method in self.invalidating_methods and resp.ok: + assert request.url is not None + cache_url = self.controller.cache_url(request.url) + self.cache.delete(cache_url) + + # Give the request a from_cache attr to let people use it + resp.from_cache = from_cache # type: ignore[attr-defined] + + return resp + + def close(self) -> None: + self.cache.close() + super().close() # type: ignore[no-untyped-call] diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/cache.py b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/cache.py new file mode 100644 index 0000000..91598e9 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/cache.py @@ -0,0 +1,75 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 + +""" +The cache object API for implementing caches. The default is a thread +safe in-memory dictionary. +""" + +from __future__ import annotations + +from threading import Lock +from typing import IO, TYPE_CHECKING, MutableMapping + +if TYPE_CHECKING: + from datetime import datetime + + +class BaseCache: + def get(self, key: str) -> bytes | None: + raise NotImplementedError() + + def set( + self, key: str, value: bytes, expires: int | datetime | None = None + ) -> None: + raise NotImplementedError() + + def delete(self, key: str) -> None: + raise NotImplementedError() + + def close(self) -> None: + pass + + +class DictCache(BaseCache): + def __init__(self, init_dict: MutableMapping[str, bytes] | None = None) -> None: + self.lock = Lock() + self.data = init_dict or {} + + def get(self, key: str) -> bytes | None: + return self.data.get(key, None) + + def set( + self, key: str, value: bytes, expires: int | datetime | None = None + ) -> None: + with self.lock: + self.data.update({key: value}) + + def delete(self, key: str) -> None: + with self.lock: + if key in self.data: + self.data.pop(key) + + +class SeparateBodyBaseCache(BaseCache): + """ + In this variant, the body is not stored mixed in with the metadata, but is + passed in (as a bytes-like object) in a separate call to ``set_body()``. + + That is, the expected interaction pattern is:: + + cache.set(key, serialized_metadata) + cache.set_body(key) + + Similarly, the body should be loaded separately via ``get_body()``. + """ + + def set_body(self, key: str, body: bytes) -> None: + raise NotImplementedError() + + def get_body(self, key: str) -> IO[bytes] | None: + """ + Return the body as file-like object. + """ + raise NotImplementedError() diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__init__.py new file mode 100644 index 0000000..24ff469 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__init__.py @@ -0,0 +1,8 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 + +from pip._vendor.cachecontrol.caches.file_cache import FileCache, SeparateBodyFileCache +from pip._vendor.cachecontrol.caches.redis_cache import RedisCache + +__all__ = ["FileCache", "SeparateBodyFileCache", "RedisCache"] diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/file_cache.py b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/file_cache.py new file mode 100644 index 0000000..81d2ef4 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/file_cache.py @@ -0,0 +1,182 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import hashlib +import os +from textwrap import dedent +from typing import IO, TYPE_CHECKING +from pathlib import Path + +from pip._vendor.cachecontrol.cache import BaseCache, SeparateBodyBaseCache +from pip._vendor.cachecontrol.controller import CacheController + +if TYPE_CHECKING: + from datetime import datetime + + from filelock import BaseFileLock + + +def _secure_open_write(filename: str, fmode: int) -> IO[bytes]: + # We only want to write to this file, so open it in write only mode + flags = os.O_WRONLY + + # os.O_CREAT | os.O_EXCL will fail if the file already exists, so we only + # will open *new* files. + # We specify this because we want to ensure that the mode we pass is the + # mode of the file. + flags |= os.O_CREAT | os.O_EXCL + + # Do not follow symlinks to prevent someone from making a symlink that + # we follow and insecurely open a cache file. + if hasattr(os, "O_NOFOLLOW"): + flags |= os.O_NOFOLLOW + + # On Windows we'll mark this file as binary + if hasattr(os, "O_BINARY"): + flags |= os.O_BINARY + + # Before we open our file, we want to delete any existing file that is + # there + try: + os.remove(filename) + except OSError: + # The file must not exist already, so we can just skip ahead to opening + pass + + # Open our file, the use of os.O_CREAT | os.O_EXCL will ensure that if a + # race condition happens between the os.remove and this line, that an + # error will be raised. Because we utilize a lockfile this should only + # happen if someone is attempting to attack us. + fd = os.open(filename, flags, fmode) + try: + return os.fdopen(fd, "wb") + + except: + # An error occurred wrapping our FD in a file object + os.close(fd) + raise + + +class _FileCacheMixin: + """Shared implementation for both FileCache variants.""" + + def __init__( + self, + directory: str | Path, + forever: bool = False, + filemode: int = 0o0600, + dirmode: int = 0o0700, + lock_class: type[BaseFileLock] | None = None, + ) -> None: + try: + if lock_class is None: + from filelock import FileLock + + lock_class = FileLock + except ImportError: + notice = dedent( + """ + NOTE: In order to use the FileCache you must have + filelock installed. You can install it via pip: + pip install cachecontrol[filecache] + """ + ) + raise ImportError(notice) + + self.directory = directory + self.forever = forever + self.filemode = filemode + self.dirmode = dirmode + self.lock_class = lock_class + + @staticmethod + def encode(x: str) -> str: + return hashlib.sha224(x.encode()).hexdigest() + + def _fn(self, name: str) -> str: + # NOTE: This method should not change as some may depend on it. + # See: https://github.com/ionrock/cachecontrol/issues/63 + hashed = self.encode(name) + parts = list(hashed[:5]) + [hashed] + return os.path.join(self.directory, *parts) + + def get(self, key: str) -> bytes | None: + name = self._fn(key) + try: + with open(name, "rb") as fh: + return fh.read() + + except FileNotFoundError: + return None + + def set( + self, key: str, value: bytes, expires: int | datetime | None = None + ) -> None: + name = self._fn(key) + self._write(name, value) + + def _write(self, path: str, data: bytes) -> None: + """ + Safely write the data to the given path. + """ + # Make sure the directory exists + try: + os.makedirs(os.path.dirname(path), self.dirmode) + except OSError: + pass + + with self.lock_class(path + ".lock"): + # Write our actual file + with _secure_open_write(path, self.filemode) as fh: + fh.write(data) + + def _delete(self, key: str, suffix: str) -> None: + name = self._fn(key) + suffix + if not self.forever: + try: + os.remove(name) + except FileNotFoundError: + pass + + +class FileCache(_FileCacheMixin, BaseCache): + """ + Traditional FileCache: body is stored in memory, so not suitable for large + downloads. + """ + + def delete(self, key: str) -> None: + self._delete(key, "") + + +class SeparateBodyFileCache(_FileCacheMixin, SeparateBodyBaseCache): + """ + Memory-efficient FileCache: body is stored in a separate file, reducing + peak memory usage. + """ + + def get_body(self, key: str) -> IO[bytes] | None: + name = self._fn(key) + ".body" + try: + return open(name, "rb") + except FileNotFoundError: + return None + + def set_body(self, key: str, body: bytes) -> None: + name = self._fn(key) + ".body" + self._write(name, body) + + def delete(self, key: str) -> None: + self._delete(key, "") + self._delete(key, ".body") + + +def url_to_file_path(url: str, filecache: FileCache) -> str: + """Return the file cache path based on the URL. + + This does not ensure the file exists! + """ + key = CacheController.cache_url(url) + return filecache._fn(key) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py new file mode 100644 index 0000000..f4f68c4 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py @@ -0,0 +1,48 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + + +from datetime import datetime, timezone +from typing import TYPE_CHECKING + +from pip._vendor.cachecontrol.cache import BaseCache + +if TYPE_CHECKING: + from redis import Redis + + +class RedisCache(BaseCache): + def __init__(self, conn: Redis[bytes]) -> None: + self.conn = conn + + def get(self, key: str) -> bytes | None: + return self.conn.get(key) + + def set( + self, key: str, value: bytes, expires: int | datetime | None = None + ) -> None: + if not expires: + self.conn.set(key, value) + elif isinstance(expires, datetime): + now_utc = datetime.now(timezone.utc) + if expires.tzinfo is None: + now_utc = now_utc.replace(tzinfo=None) + delta = expires - now_utc + self.conn.setex(key, int(delta.total_seconds()), value) + else: + self.conn.setex(key, expires, value) + + def delete(self, key: str) -> None: + self.conn.delete(key) + + def clear(self) -> None: + """Helper for clearing all the keys in a database. Use with + caution!""" + for key in self.conn.keys(): + self.conn.delete(key) + + def close(self) -> None: + """Redis uses connection pooling, no need to close the connection.""" + pass diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/controller.py b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/controller.py new file mode 100644 index 0000000..f0ff6e1 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/controller.py @@ -0,0 +1,500 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 + +""" +The httplib2 algorithms ported for use with requests. +""" + +from __future__ import annotations + +import calendar +import logging +import re +import time +from email.utils import parsedate_tz +from typing import TYPE_CHECKING, Collection, Mapping + +from pip._vendor.requests.structures import CaseInsensitiveDict + +from pip._vendor.cachecontrol.cache import DictCache, SeparateBodyBaseCache +from pip._vendor.cachecontrol.serialize import Serializer + +if TYPE_CHECKING: + from typing import Literal + + from pip._vendor.requests import PreparedRequest + from pip._vendor.urllib3 import HTTPResponse + + from pip._vendor.cachecontrol.cache import BaseCache + +logger = logging.getLogger(__name__) + +URI = re.compile(r"^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?") + +PERMANENT_REDIRECT_STATUSES = (301, 308) + + +def parse_uri(uri: str) -> tuple[str, str, str, str, str]: + """Parses a URI using the regex given in Appendix B of RFC 3986. + + (scheme, authority, path, query, fragment) = parse_uri(uri) + """ + match = URI.match(uri) + assert match is not None + groups = match.groups() + return (groups[1], groups[3], groups[4], groups[6], groups[8]) + + +class CacheController: + """An interface to see if request should cached or not.""" + + def __init__( + self, + cache: BaseCache | None = None, + cache_etags: bool = True, + serializer: Serializer | None = None, + status_codes: Collection[int] | None = None, + ): + self.cache = DictCache() if cache is None else cache + self.cache_etags = cache_etags + self.serializer = serializer or Serializer() + self.cacheable_status_codes = status_codes or (200, 203, 300, 301, 308) + + @classmethod + def _urlnorm(cls, uri: str) -> str: + """Normalize the URL to create a safe key for the cache""" + (scheme, authority, path, query, fragment) = parse_uri(uri) + if not scheme or not authority: + raise Exception("Only absolute URIs are allowed. uri = %s" % uri) + + scheme = scheme.lower() + authority = authority.lower() + + if not path: + path = "/" + + # Could do syntax based normalization of the URI before + # computing the digest. See Section 6.2.2 of Std 66. + request_uri = query and "?".join([path, query]) or path + defrag_uri = scheme + "://" + authority + request_uri + + return defrag_uri + + @classmethod + def cache_url(cls, uri: str) -> str: + return cls._urlnorm(uri) + + def parse_cache_control(self, headers: Mapping[str, str]) -> dict[str, int | None]: + known_directives = { + # https://tools.ietf.org/html/rfc7234#section-5.2 + "max-age": (int, True), + "max-stale": (int, False), + "min-fresh": (int, True), + "no-cache": (None, False), + "no-store": (None, False), + "no-transform": (None, False), + "only-if-cached": (None, False), + "must-revalidate": (None, False), + "public": (None, False), + "private": (None, False), + "proxy-revalidate": (None, False), + "s-maxage": (int, True), + } + + cc_headers = headers.get("cache-control", headers.get("Cache-Control", "")) + + retval: dict[str, int | None] = {} + + for cc_directive in cc_headers.split(","): + if not cc_directive.strip(): + continue + + parts = cc_directive.split("=", 1) + directive = parts[0].strip() + + try: + typ, required = known_directives[directive] + except KeyError: + logger.debug("Ignoring unknown cache-control directive: %s", directive) + continue + + if not typ or not required: + retval[directive] = None + if typ: + try: + retval[directive] = typ(parts[1].strip()) + except IndexError: + if required: + logger.debug( + "Missing value for cache-control " "directive: %s", + directive, + ) + except ValueError: + logger.debug( + "Invalid value for cache-control directive " "%s, must be %s", + directive, + typ.__name__, + ) + + return retval + + def _load_from_cache(self, request: PreparedRequest) -> HTTPResponse | None: + """ + Load a cached response, or return None if it's not available. + """ + # We do not support caching of partial content: so if the request contains a + # Range header then we don't want to load anything from the cache. + if "Range" in request.headers: + return None + + cache_url = request.url + assert cache_url is not None + cache_data = self.cache.get(cache_url) + if cache_data is None: + logger.debug("No cache entry available") + return None + + if isinstance(self.cache, SeparateBodyBaseCache): + body_file = self.cache.get_body(cache_url) + else: + body_file = None + + result = self.serializer.loads(request, cache_data, body_file) + if result is None: + logger.warning("Cache entry deserialization failed, entry ignored") + return result + + def cached_request(self, request: PreparedRequest) -> HTTPResponse | Literal[False]: + """ + Return a cached response if it exists in the cache, otherwise + return False. + """ + assert request.url is not None + cache_url = self.cache_url(request.url) + logger.debug('Looking up "%s" in the cache', cache_url) + cc = self.parse_cache_control(request.headers) + + # Bail out if the request insists on fresh data + if "no-cache" in cc: + logger.debug('Request header has "no-cache", cache bypassed') + return False + + if "max-age" in cc and cc["max-age"] == 0: + logger.debug('Request header has "max_age" as 0, cache bypassed') + return False + + # Check whether we can load the response from the cache: + resp = self._load_from_cache(request) + if not resp: + return False + + # If we have a cached permanent redirect, return it immediately. We + # don't need to test our response for other headers b/c it is + # intrinsically "cacheable" as it is Permanent. + # + # See: + # https://tools.ietf.org/html/rfc7231#section-6.4.2 + # + # Client can try to refresh the value by repeating the request + # with cache busting headers as usual (ie no-cache). + if int(resp.status) in PERMANENT_REDIRECT_STATUSES: + msg = ( + "Returning cached permanent redirect response " + "(ignoring date and etag information)" + ) + logger.debug(msg) + return resp + + headers: CaseInsensitiveDict[str] = CaseInsensitiveDict(resp.headers) + if not headers or "date" not in headers: + if "etag" not in headers: + # Without date or etag, the cached response can never be used + # and should be deleted. + logger.debug("Purging cached response: no date or etag") + self.cache.delete(cache_url) + logger.debug("Ignoring cached response: no date") + return False + + now = time.time() + time_tuple = parsedate_tz(headers["date"]) + assert time_tuple is not None + date = calendar.timegm(time_tuple[:6]) + current_age = max(0, now - date) + logger.debug("Current age based on date: %i", current_age) + + # TODO: There is an assumption that the result will be a + # urllib3 response object. This may not be best since we + # could probably avoid instantiating or constructing the + # response until we know we need it. + resp_cc = self.parse_cache_control(headers) + + # determine freshness + freshness_lifetime = 0 + + # Check the max-age pragma in the cache control header + max_age = resp_cc.get("max-age") + if max_age is not None: + freshness_lifetime = max_age + logger.debug("Freshness lifetime from max-age: %i", freshness_lifetime) + + # If there isn't a max-age, check for an expires header + elif "expires" in headers: + expires = parsedate_tz(headers["expires"]) + if expires is not None: + expire_time = calendar.timegm(expires[:6]) - date + freshness_lifetime = max(0, expire_time) + logger.debug("Freshness lifetime from expires: %i", freshness_lifetime) + + # Determine if we are setting freshness limit in the + # request. Note, this overrides what was in the response. + max_age = cc.get("max-age") + if max_age is not None: + freshness_lifetime = max_age + logger.debug( + "Freshness lifetime from request max-age: %i", freshness_lifetime + ) + + min_fresh = cc.get("min-fresh") + if min_fresh is not None: + # adjust our current age by our min fresh + current_age += min_fresh + logger.debug("Adjusted current age from min-fresh: %i", current_age) + + # Return entry if it is fresh enough + if freshness_lifetime > current_age: + logger.debug('The response is "fresh", returning cached response') + logger.debug("%i > %i", freshness_lifetime, current_age) + return resp + + # we're not fresh. If we don't have an Etag, clear it out + if "etag" not in headers: + logger.debug('The cached response is "stale" with no etag, purging') + self.cache.delete(cache_url) + + # return the original handler + return False + + def conditional_headers(self, request: PreparedRequest) -> dict[str, str]: + resp = self._load_from_cache(request) + new_headers = {} + + if resp: + headers: CaseInsensitiveDict[str] = CaseInsensitiveDict(resp.headers) + + if "etag" in headers: + new_headers["If-None-Match"] = headers["ETag"] + + if "last-modified" in headers: + new_headers["If-Modified-Since"] = headers["Last-Modified"] + + return new_headers + + def _cache_set( + self, + cache_url: str, + request: PreparedRequest, + response: HTTPResponse, + body: bytes | None = None, + expires_time: int | None = None, + ) -> None: + """ + Store the data in the cache. + """ + if isinstance(self.cache, SeparateBodyBaseCache): + # We pass in the body separately; just put a placeholder empty + # string in the metadata. + self.cache.set( + cache_url, + self.serializer.dumps(request, response, b""), + expires=expires_time, + ) + # body is None can happen when, for example, we're only updating + # headers, as is the case in update_cached_response(). + if body is not None: + self.cache.set_body(cache_url, body) + else: + self.cache.set( + cache_url, + self.serializer.dumps(request, response, body), + expires=expires_time, + ) + + def cache_response( + self, + request: PreparedRequest, + response: HTTPResponse, + body: bytes | None = None, + status_codes: Collection[int] | None = None, + ) -> None: + """ + Algorithm for caching requests. + + This assumes a requests Response object. + """ + # From httplib2: Don't cache 206's since we aren't going to + # handle byte range requests + cacheable_status_codes = status_codes or self.cacheable_status_codes + if response.status not in cacheable_status_codes: + logger.debug( + "Status code %s not in %s", response.status, cacheable_status_codes + ) + return + + response_headers: CaseInsensitiveDict[str] = CaseInsensitiveDict( + response.headers + ) + + if "date" in response_headers: + time_tuple = parsedate_tz(response_headers["date"]) + assert time_tuple is not None + date = calendar.timegm(time_tuple[:6]) + else: + date = 0 + + # If we've been given a body, our response has a Content-Length, that + # Content-Length is valid then we can check to see if the body we've + # been given matches the expected size, and if it doesn't we'll just + # skip trying to cache it. + if ( + body is not None + and "content-length" in response_headers + and response_headers["content-length"].isdigit() + and int(response_headers["content-length"]) != len(body) + ): + return + + cc_req = self.parse_cache_control(request.headers) + cc = self.parse_cache_control(response_headers) + + assert request.url is not None + cache_url = self.cache_url(request.url) + logger.debug('Updating cache with response from "%s"', cache_url) + + # Delete it from the cache if we happen to have it stored there + no_store = False + if "no-store" in cc: + no_store = True + logger.debug('Response header has "no-store"') + if "no-store" in cc_req: + no_store = True + logger.debug('Request header has "no-store"') + if no_store and self.cache.get(cache_url): + logger.debug('Purging existing cache entry to honor "no-store"') + self.cache.delete(cache_url) + if no_store: + return + + # https://tools.ietf.org/html/rfc7234#section-4.1: + # A Vary header field-value of "*" always fails to match. + # Storing such a response leads to a deserialization warning + # during cache lookup and is not allowed to ever be served, + # so storing it can be avoided. + if "*" in response_headers.get("vary", ""): + logger.debug('Response header has "Vary: *"') + return + + # If we've been given an etag, then keep the response + if self.cache_etags and "etag" in response_headers: + expires_time = 0 + if response_headers.get("expires"): + expires = parsedate_tz(response_headers["expires"]) + if expires is not None: + expires_time = calendar.timegm(expires[:6]) - date + + expires_time = max(expires_time, 14 * 86400) + + logger.debug(f"etag object cached for {expires_time} seconds") + logger.debug("Caching due to etag") + self._cache_set(cache_url, request, response, body, expires_time) + + # Add to the cache any permanent redirects. We do this before looking + # that the Date headers. + elif int(response.status) in PERMANENT_REDIRECT_STATUSES: + logger.debug("Caching permanent redirect") + self._cache_set(cache_url, request, response, b"") + + # Add to the cache if the response headers demand it. If there + # is no date header then we can't do anything about expiring + # the cache. + elif "date" in response_headers: + time_tuple = parsedate_tz(response_headers["date"]) + assert time_tuple is not None + date = calendar.timegm(time_tuple[:6]) + # cache when there is a max-age > 0 + max_age = cc.get("max-age") + if max_age is not None and max_age > 0: + logger.debug("Caching b/c date exists and max-age > 0") + expires_time = max_age + self._cache_set( + cache_url, + request, + response, + body, + expires_time, + ) + + # If the request can expire, it means we should cache it + # in the meantime. + elif "expires" in response_headers: + if response_headers["expires"]: + expires = parsedate_tz(response_headers["expires"]) + if expires is not None: + expires_time = calendar.timegm(expires[:6]) - date + else: + expires_time = None + + logger.debug( + "Caching b/c of expires header. expires in {} seconds".format( + expires_time + ) + ) + self._cache_set( + cache_url, + request, + response, + body, + expires_time, + ) + + def update_cached_response( + self, request: PreparedRequest, response: HTTPResponse + ) -> HTTPResponse: + """On a 304 we will get a new set of headers that we want to + update our cached value with, assuming we have one. + + This should only ever be called when we've sent an ETag and + gotten a 304 as the response. + """ + assert request.url is not None + cache_url = self.cache_url(request.url) + cached_response = self._load_from_cache(request) + + if not cached_response: + # we didn't have a cached response + return response + + # Lets update our headers with the headers from the new request: + # http://tools.ietf.org/html/draft-ietf-httpbis-p4-conditional-26#section-4.1 + # + # The server isn't supposed to send headers that would make + # the cached body invalid. But... just in case, we'll be sure + # to strip out ones we know that might be problmatic due to + # typical assumptions. + excluded_headers = ["content-length"] + + cached_response.headers.update( + { + k: v + for k, v in response.headers.items() + if k.lower() not in excluded_headers + } + ) + + # we want a 200 b/c we have content via the cache + cached_response.status = 200 + + # update our cache + self._cache_set(cache_url, request, cached_response) + + return cached_response diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/filewrapper.py b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/filewrapper.py new file mode 100644 index 0000000..37d2fa5 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/filewrapper.py @@ -0,0 +1,119 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import mmap +from tempfile import NamedTemporaryFile +from typing import TYPE_CHECKING, Any, Callable + +if TYPE_CHECKING: + from http.client import HTTPResponse + + +class CallbackFileWrapper: + """ + Small wrapper around a fp object which will tee everything read into a + buffer, and when that file is closed it will execute a callback with the + contents of that buffer. + + All attributes are proxied to the underlying file object. + + This class uses members with a double underscore (__) leading prefix so as + not to accidentally shadow an attribute. + + The data is stored in a temporary file until it is all available. As long + as the temporary files directory is disk-based (sometimes it's a + memory-backed-``tmpfs`` on Linux), data will be unloaded to disk if memory + pressure is high. For small files the disk usually won't be used at all, + it'll all be in the filesystem memory cache, so there should be no + performance impact. + """ + + def __init__( + self, fp: HTTPResponse, callback: Callable[[bytes], None] | None + ) -> None: + self.__buf = NamedTemporaryFile("rb+", delete=True) + self.__fp = fp + self.__callback = callback + + def __getattr__(self, name: str) -> Any: + # The vagaries of garbage collection means that self.__fp is + # not always set. By using __getattribute__ and the private + # name[0] allows looking up the attribute value and raising an + # AttributeError when it doesn't exist. This stop things from + # infinitely recursing calls to getattr in the case where + # self.__fp hasn't been set. + # + # [0] https://docs.python.org/2/reference/expressions.html#atom-identifiers + fp = self.__getattribute__("_CallbackFileWrapper__fp") + return getattr(fp, name) + + def __is_fp_closed(self) -> bool: + try: + return self.__fp.fp is None + + except AttributeError: + pass + + try: + closed: bool = self.__fp.closed + return closed + + except AttributeError: + pass + + # We just don't cache it then. + # TODO: Add some logging here... + return False + + def _close(self) -> None: + if self.__callback: + if self.__buf.tell() == 0: + # Empty file: + result = b"" + else: + # Return the data without actually loading it into memory, + # relying on Python's buffer API and mmap(). mmap() just gives + # a view directly into the filesystem's memory cache, so it + # doesn't result in duplicate memory use. + self.__buf.seek(0, 0) + result = memoryview( + mmap.mmap(self.__buf.fileno(), 0, access=mmap.ACCESS_READ) + ) + self.__callback(result) + + # We assign this to None here, because otherwise we can get into + # really tricky problems where the CPython interpreter dead locks + # because the callback is holding a reference to something which + # has a __del__ method. Setting this to None breaks the cycle + # and allows the garbage collector to do it's thing normally. + self.__callback = None + + # Closing the temporary file releases memory and frees disk space. + # Important when caching big files. + self.__buf.close() + + def read(self, amt: int | None = None) -> bytes: + data: bytes = self.__fp.read(amt) + if data: + # We may be dealing with b'', a sign that things are over: + # it's passed e.g. after we've already closed self.__buf. + self.__buf.write(data) + if self.__is_fp_closed(): + self._close() + + return data + + def _safe_read(self, amt: int) -> bytes: + data: bytes = self.__fp._safe_read(amt) # type: ignore[attr-defined] + if amt == 2 and data == b"\r\n": + # urllib executes this read to toss the CRLF at the end + # of the chunk. + return data + + self.__buf.write(data) + if self.__is_fp_closed(): + self._close() + + return data diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/heuristics.py b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/heuristics.py new file mode 100644 index 0000000..b778c4f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/heuristics.py @@ -0,0 +1,157 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import calendar +import time +from datetime import datetime, timedelta, timezone +from email.utils import formatdate, parsedate, parsedate_tz +from typing import TYPE_CHECKING, Any, Mapping + +if TYPE_CHECKING: + from pip._vendor.urllib3 import HTTPResponse + +TIME_FMT = "%a, %d %b %Y %H:%M:%S GMT" + + +def expire_after(delta: timedelta, date: datetime | None = None) -> datetime: + date = date or datetime.now(timezone.utc) + return date + delta + + +def datetime_to_header(dt: datetime) -> str: + return formatdate(calendar.timegm(dt.timetuple())) + + +class BaseHeuristic: + def warning(self, response: HTTPResponse) -> str | None: + """ + Return a valid 1xx warning header value describing the cache + adjustments. + + The response is provided too allow warnings like 113 + http://tools.ietf.org/html/rfc7234#section-5.5.4 where we need + to explicitly say response is over 24 hours old. + """ + return '110 - "Response is Stale"' + + def update_headers(self, response: HTTPResponse) -> dict[str, str]: + """Update the response headers with any new headers. + + NOTE: This SHOULD always include some Warning header to + signify that the response was cached by the client, not + by way of the provided headers. + """ + return {} + + def apply(self, response: HTTPResponse) -> HTTPResponse: + updated_headers = self.update_headers(response) + + if updated_headers: + response.headers.update(updated_headers) + warning_header_value = self.warning(response) + if warning_header_value is not None: + response.headers.update({"Warning": warning_header_value}) + + return response + + +class OneDayCache(BaseHeuristic): + """ + Cache the response by providing an expires 1 day in the + future. + """ + + def update_headers(self, response: HTTPResponse) -> dict[str, str]: + headers = {} + + if "expires" not in response.headers: + date = parsedate(response.headers["date"]) + expires = expire_after( + timedelta(days=1), + date=datetime(*date[:6], tzinfo=timezone.utc), # type: ignore[index,misc] + ) + headers["expires"] = datetime_to_header(expires) + headers["cache-control"] = "public" + return headers + + +class ExpiresAfter(BaseHeuristic): + """ + Cache **all** requests for a defined time period. + """ + + def __init__(self, **kw: Any) -> None: + self.delta = timedelta(**kw) + + def update_headers(self, response: HTTPResponse) -> dict[str, str]: + expires = expire_after(self.delta) + return {"expires": datetime_to_header(expires), "cache-control": "public"} + + def warning(self, response: HTTPResponse) -> str | None: + tmpl = "110 - Automatically cached for %s. Response might be stale" + return tmpl % self.delta + + +class LastModified(BaseHeuristic): + """ + If there is no Expires header already, fall back on Last-Modified + using the heuristic from + http://tools.ietf.org/html/rfc7234#section-4.2.2 + to calculate a reasonable value. + + Firefox also does something like this per + https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching_FAQ + http://lxr.mozilla.org/mozilla-release/source/netwerk/protocol/http/nsHttpResponseHead.cpp#397 + Unlike mozilla we limit this to 24-hr. + """ + + cacheable_by_default_statuses = { + 200, + 203, + 204, + 206, + 300, + 301, + 404, + 405, + 410, + 414, + 501, + } + + def update_headers(self, resp: HTTPResponse) -> dict[str, str]: + headers: Mapping[str, str] = resp.headers + + if "expires" in headers: + return {} + + if "cache-control" in headers and headers["cache-control"] != "public": + return {} + + if resp.status not in self.cacheable_by_default_statuses: + return {} + + if "date" not in headers or "last-modified" not in headers: + return {} + + time_tuple = parsedate_tz(headers["date"]) + assert time_tuple is not None + date = calendar.timegm(time_tuple[:6]) + last_modified = parsedate(headers["last-modified"]) + if last_modified is None: + return {} + + now = time.time() + current_age = max(0, now - date) + delta = date - calendar.timegm(last_modified) + freshness_lifetime = max(0, min(delta / 10, 24 * 3600)) + if freshness_lifetime <= current_age: + return {} + + expires = date + freshness_lifetime + return {"expires": time.strftime(TIME_FMT, time.gmtime(expires))} + + def warning(self, resp: HTTPResponse) -> str | None: + return None diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/py.typed b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/serialize.py b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/serialize.py new file mode 100644 index 0000000..a49487a --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/serialize.py @@ -0,0 +1,146 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import io +from typing import IO, TYPE_CHECKING, Any, Mapping, cast + +from pip._vendor import msgpack +from pip._vendor.requests.structures import CaseInsensitiveDict +from pip._vendor.urllib3 import HTTPResponse + +if TYPE_CHECKING: + from pip._vendor.requests import PreparedRequest + + +class Serializer: + serde_version = "4" + + def dumps( + self, + request: PreparedRequest, + response: HTTPResponse, + body: bytes | None = None, + ) -> bytes: + response_headers: CaseInsensitiveDict[str] = CaseInsensitiveDict( + response.headers + ) + + if body is None: + # When a body isn't passed in, we'll read the response. We + # also update the response with a new file handler to be + # sure it acts as though it was never read. + body = response.read(decode_content=False) + response._fp = io.BytesIO(body) # type: ignore[assignment] + response.length_remaining = len(body) + + data = { + "response": { + "body": body, # Empty bytestring if body is stored separately + "headers": {str(k): str(v) for k, v in response.headers.items()}, + "status": response.status, + "version": response.version, + "reason": str(response.reason), + "decode_content": response.decode_content, + } + } + + # Construct our vary headers + data["vary"] = {} + if "vary" in response_headers: + varied_headers = response_headers["vary"].split(",") + for header in varied_headers: + header = str(header).strip() + header_value = request.headers.get(header, None) + if header_value is not None: + header_value = str(header_value) + data["vary"][header] = header_value + + return b",".join([f"cc={self.serde_version}".encode(), self.serialize(data)]) + + def serialize(self, data: dict[str, Any]) -> bytes: + return cast(bytes, msgpack.dumps(data, use_bin_type=True)) + + def loads( + self, + request: PreparedRequest, + data: bytes, + body_file: IO[bytes] | None = None, + ) -> HTTPResponse | None: + # Short circuit if we've been given an empty set of data + if not data: + return None + + # Previous versions of this library supported other serialization + # formats, but these have all been removed. + if not data.startswith(f"cc={self.serde_version},".encode()): + return None + + data = data[5:] + return self._loads_v4(request, data, body_file) + + def prepare_response( + self, + request: PreparedRequest, + cached: Mapping[str, Any], + body_file: IO[bytes] | None = None, + ) -> HTTPResponse | None: + """Verify our vary headers match and construct a real urllib3 + HTTPResponse object. + """ + # Special case the '*' Vary value as it means we cannot actually + # determine if the cached response is suitable for this request. + # This case is also handled in the controller code when creating + # a cache entry, but is left here for backwards compatibility. + if "*" in cached.get("vary", {}): + return None + + # Ensure that the Vary headers for the cached response match our + # request + for header, value in cached.get("vary", {}).items(): + if request.headers.get(header, None) != value: + return None + + body_raw = cached["response"].pop("body") + + headers: CaseInsensitiveDict[str] = CaseInsensitiveDict( + data=cached["response"]["headers"] + ) + if headers.get("transfer-encoding", "") == "chunked": + headers.pop("transfer-encoding") + + cached["response"]["headers"] = headers + + try: + body: IO[bytes] + if body_file is None: + body = io.BytesIO(body_raw) + else: + body = body_file + except TypeError: + # This can happen if cachecontrol serialized to v1 format (pickle) + # using Python 2. A Python 2 str(byte string) will be unpickled as + # a Python 3 str (unicode string), which will cause the above to + # fail with: + # + # TypeError: 'str' does not support the buffer interface + body = io.BytesIO(body_raw.encode("utf8")) + + # Discard any `strict` parameter serialized by older version of cachecontrol. + cached["response"].pop("strict", None) + + return HTTPResponse(body=body, preload_content=False, **cached["response"]) + + def _loads_v4( + self, + request: PreparedRequest, + data: bytes, + body_file: IO[bytes] | None = None, + ) -> HTTPResponse | None: + try: + cached = msgpack.loads(data, raw=False) + except ValueError: + return None + + return self.prepare_response(request, cached, body_file) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/wrapper.py b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/wrapper.py new file mode 100644 index 0000000..f618bc3 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/cachecontrol/wrapper.py @@ -0,0 +1,43 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +from typing import TYPE_CHECKING, Collection + +from pip._vendor.cachecontrol.adapter import CacheControlAdapter +from pip._vendor.cachecontrol.cache import DictCache + +if TYPE_CHECKING: + from pip._vendor import requests + + from pip._vendor.cachecontrol.cache import BaseCache + from pip._vendor.cachecontrol.controller import CacheController + from pip._vendor.cachecontrol.heuristics import BaseHeuristic + from pip._vendor.cachecontrol.serialize import Serializer + + +def CacheControl( + sess: requests.Session, + cache: BaseCache | None = None, + cache_etags: bool = True, + serializer: Serializer | None = None, + heuristic: BaseHeuristic | None = None, + controller_class: type[CacheController] | None = None, + adapter_class: type[CacheControlAdapter] | None = None, + cacheable_methods: Collection[str] | None = None, +) -> requests.Session: + cache = DictCache() if cache is None else cache + adapter_class = adapter_class or CacheControlAdapter + adapter = adapter_class( + cache, + cache_etags=cache_etags, + serializer=serializer, + heuristic=heuristic, + controller_class=controller_class, + cacheable_methods=cacheable_methods, + ) + sess.mount("http://", adapter) + sess.mount("https://", adapter) + + return sess diff --git a/env/lib/python3.12/site-packages/pip/_vendor/certifi/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/certifi/__init__.py new file mode 100644 index 0000000..f61d77f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/certifi/__init__.py @@ -0,0 +1,4 @@ +from .core import contents, where + +__all__ = ["contents", "where"] +__version__ = "2024.08.30" diff --git a/env/lib/python3.12/site-packages/pip/_vendor/certifi/__main__.py b/env/lib/python3.12/site-packages/pip/_vendor/certifi/__main__.py new file mode 100644 index 0000000..0037634 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/certifi/__main__.py @@ -0,0 +1,12 @@ +import argparse + +from pip._vendor.certifi import contents, where + +parser = argparse.ArgumentParser() +parser.add_argument("-c", "--contents", action="store_true") +args = parser.parse_args() + +if args.contents: + print(contents()) +else: + print(where()) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/certifi/cacert.pem b/env/lib/python3.12/site-packages/pip/_vendor/certifi/cacert.pem new file mode 100644 index 0000000..3c165a1 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/certifi/cacert.pem @@ -0,0 +1,4929 @@ + +# 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" +# Serial: 1164660820 +# MD5 Fingerprint: d6:a5:c3:ed:5d:dd:3e:00:c1:3d:87:92:1f:1d:3f:e4 +# SHA1 Fingerprint: b3:1e:b1:b7:40:e3:6c:84:02:da:dc:37:d4:4d:f5:d4:67:49:52:f9 +# SHA256 Fingerprint: 73:c1:76:43:4f:1b:c6:d5:ad:f4:5b:0e:76:e7:27:28:7c:8d:e5:76:16:c1:e6:e6:14:1a:2b:2c:bc:7d:8e:4c +-----BEGIN CERTIFICATE----- +MIIEkTCCA3mgAwIBAgIERWtQVDANBgkqhkiG9w0BAQUFADCBsDELMAkGA1UEBhMC +VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xOTA3BgNVBAsTMHd3dy5lbnRydXN0 +Lm5ldC9DUFMgaXMgaW5jb3Jwb3JhdGVkIGJ5IHJlZmVyZW5jZTEfMB0GA1UECxMW +KGMpIDIwMDYgRW50cnVzdCwgSW5jLjEtMCsGA1UEAxMkRW50cnVzdCBSb290IENl +cnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA2MTEyNzIwMjM0MloXDTI2MTEyNzIw +NTM0MlowgbAxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMTkw +NwYDVQQLEzB3d3cuZW50cnVzdC5uZXQvQ1BTIGlzIGluY29ycG9yYXRlZCBieSBy +ZWZlcmVuY2UxHzAdBgNVBAsTFihjKSAyMDA2IEVudHJ1c3QsIEluYy4xLTArBgNV +BAMTJEVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASIwDQYJ +KoZIhvcNAQEBBQADggEPADCCAQoCggEBALaVtkNC+sZtKm9I35RMOVcF7sN5EUFo +Nu3s/poBj6E4KPz3EEZmLk0eGrEaTsbRwJWIsMn/MYszA9u3g3s+IIRe7bJWKKf4 +4LlAcTfFy0cOlypowCKVYhXbR9n10Cv/gkvJrT7eTNuQgFA/CYqEAOwwCj0Yzfv9 +KlmaI5UXLEWeH25DeW0MXJj+SKfFI0dcXv1u5x609mhF0YaDW6KKjbHjKYD+JXGI +rb68j6xSlkuqUY3kEzEZ6E5Nn9uss2rVvDlUccp6en+Q3X0dgNmBu1kmwhH+5pPi +94DkZfs0Nw4pgHBNrziGLp5/V6+eF67rHMsoIV+2HNjnogQi+dPa2MsCAwEAAaOB +sDCBrTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zArBgNVHRAEJDAi +gA8yMDA2MTEyNzIwMjM0MlqBDzIwMjYxMTI3MjA1MzQyWjAfBgNVHSMEGDAWgBRo +kORnpKZTgMeGZqTx90tD+4S9bTAdBgNVHQ4EFgQUaJDkZ6SmU4DHhmak8fdLQ/uE +vW0wHQYJKoZIhvZ9B0EABBAwDhsIVjcuMTo0LjADAgSQMA0GCSqGSIb3DQEBBQUA +A4IBAQCT1DCw1wMgKtD5Y+iRDAUgqV8ZyntyTtSx29CW+1RaGSwMCPeyvIWonX9t +O1KzKtvn1ISMY/YPyyYBkVBs9F8U4pN0wBOeMDpQ47RgxRzwIkSNcUesyBrJ6Zua +AGAT/3B+XxFNSRuzFVJ7yVTav52Vr2ua2J7p8eRDjeIRRDq/r72DQnNSi6q7pynP +9WQcCk3RvKqsnyrQ/39/2n3qse0wJcGE2jTSW3iDVuycNsMm4hH2Z0kdkquM++v/ +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" +# Serial: 1289 +# MD5 Fingerprint: 5e:39:7b:dd:f8:ba:ec:82:e9:ac:62:ba:0c:54:00:2b +# SHA1 Fingerprint: ca:3a:fb:cf:12:40:36:4b:44:b2:16:20:88:80:48:39:19:93:7c:f7 +# SHA256 Fingerprint: 85:a0:dd:7d:d7:20:ad:b7:ff:05:f8:3d:54:2b:20:9d:c7:ff:45:28:f7:d6:77:b1:83:89:fe:a5:e5:c4:9e:86 +-----BEGIN CERTIFICATE----- +MIIFtzCCA5+gAwIBAgICBQkwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x +GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv +b3QgQ0EgMjAeFw0wNjExMjQxODI3MDBaFw0zMTExMjQxODIzMzNaMEUxCzAJBgNV +BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W +YWRpcyBSb290IENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCa +GMpLlA0ALa8DKYrwD4HIrkwZhR0In6spRIXzL4GtMh6QRr+jhiYaHv5+HBg6XJxg +Fyo6dIMzMH1hVBHL7avg5tKifvVrbxi3Cgst/ek+7wrGsxDp3MJGF/hd/aTa/55J +WpzmM+Yklvc/ulsrHHo1wtZn/qtmUIttKGAr79dgw8eTvI02kfN/+NsRE8Scd3bB +rrcCaoF6qUWD4gXmuVbBlDePSHFjIuwXZQeVikvfj8ZaCuWw419eaxGrDPmF60Tp ++ARz8un+XJiM9XOva7R+zdRcAitMOeGylZUtQofX1bOQQ7dsE/He3fbE+Ik/0XX1 +ksOR1YqI0JDs3G3eicJlcZaLDQP9nL9bFqyS2+r+eXyt66/3FsvbzSUr5R/7mp/i +Ucw6UwxI5g69ybR2BlLmEROFcmMDBOAENisgGQLodKcftslWZvB1JdxnwQ5hYIiz +PtGo/KPaHbDRsSNU30R2be1B2MGyIrZTHN81Hdyhdyox5C315eXbyOD/5YDXC2Og +/zOhD7osFRXql7PSorW+8oyWHhqPHWykYTe5hnMz15eWniN9gqRMgeKh0bpnX5UH +oycR7hYQe7xFSkyyBNKr79X9DFHOUGoIMfmR2gyPZFwDwzqLID9ujWc9Otb+fVuI +yV77zGHcizN300QyNQliBJIWENieJ0f7OyHj+OsdWwIDAQABo4GwMIGtMA8GA1Ud +EwEB/wQFMAMBAf8wCwYDVR0PBAQDAgEGMB0GA1UdDgQWBBQahGK8SEwzJQTU7tD2 +A8QZRtGUazBuBgNVHSMEZzBlgBQahGK8SEwzJQTU7tD2A8QZRtGUa6FJpEcwRTEL +MAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMT +ElF1b1ZhZGlzIFJvb3QgQ0EgMoICBQkwDQYJKoZIhvcNAQEFBQADggIBAD4KFk2f +BluornFdLwUvZ+YTRYPENvbzwCYMDbVHZF34tHLJRqUDGCdViXh9duqWNIAXINzn +g/iN/Ae42l9NLmeyhP3ZRPx3UIHmfLTJDQtyU/h2BwdBR5YM++CCJpNVjP4iH2Bl +fF/nJrP3MpCYUNQ3cVX2kiF495V5+vgtJodmVjB3pjd4M1IQWK4/YY7yarHvGH5K +WWPKjaJW1acvvFYfzznB4vsKqBUsfU16Y8Zsl0Q80m/DShcK+JDSV6IZUaUtl0Ha +B0+pUNqQjZRG4T7wlP0QADj1O+hA4bRuVhogzG9Yje0uRY/W6ZM/57Es3zrWIozc +hLsib9D45MY56QSIPMO661V6bYCZJPVsAfv4l7CUW+v90m/xd2gNNWQjrLhVoQPR +TUIZ3Ph1WVaj+ahJefivDrkRoHy3au000LYmYjgahwz46P0u05B/B5EqHdZ+XIWD +mbA4CD/pXvk1B+TJYm5Xf6dQlfe6yJvmjqIBxdZmv3lh8zwc4bmCXF2gw+nYSL0Z +ohEUGW6yhhtoPkg3Goi3XZZenMfvJ2II4pEZXNLxId26F0KCl3GBUzGpn/Z9Yr9y +4aOTHcyKJloJONDO1w2AFrR4pTqHTI2KpdVGl/IsELm8VCLAAVBpQ570su9t+Oza +8eOx79+Rj1QqCyXBJhnEUhAFZdWCEOrCMc0u +-----END CERTIFICATE----- + +# Issuer: CN=QuoVadis Root CA 3 O=QuoVadis Limited +# Subject: CN=QuoVadis Root CA 3 O=QuoVadis Limited +# Label: "QuoVadis Root CA 3" +# Serial: 1478 +# MD5 Fingerprint: 31:85:3c:62:94:97:63:b9:aa:fd:89:4e:af:6f:e0:cf +# SHA1 Fingerprint: 1f:49:14:f7:d8:74:95:1d:dd:ae:02:c0:be:fd:3a:2d:82:75:51:85 +# SHA256 Fingerprint: 18:f1:fc:7f:20:5d:f8:ad:dd:eb:7f:e0:07:dd:57:e3:af:37:5a:9c:4d:8d:73:54:6b:f4:f1:fe:d1:e1:8d:35 +-----BEGIN CERTIFICATE----- +MIIGnTCCBIWgAwIBAgICBcYwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x +GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv +b3QgQ0EgMzAeFw0wNjExMjQxOTExMjNaFw0zMTExMjQxOTA2NDRaMEUxCzAJBgNV +BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W +YWRpcyBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDM +V0IWVJzmmNPTTe7+7cefQzlKZbPoFog02w1ZkXTPkrgEQK0CSzGrvI2RaNggDhoB +4hp7Thdd4oq3P5kazethq8Jlph+3t723j/z9cI8LoGe+AaJZz3HmDyl2/7FWeUUr +H556VOijKTVopAFPD6QuN+8bv+OPEKhyq1hX51SGyMnzW9os2l2ObjyjPtr7guXd +8lyyBTNvijbO0BNO/79KDDRMpsMhvVAEVeuxu537RR5kFd5VAYwCdrXLoT9Cabwv +vWhDFlaJKjdhkf2mrk7AyxRllDdLkgbvBNDInIjbC3uBr7E9KsRlOni27tyAsdLT +mZw67mtaa7ONt9XOnMK+pUsvFrGeaDsGb659n/je7Mwpp5ijJUMv7/FfJuGITfhe +btfZFG4ZM2mnO4SJk8RTVROhUXhA+LjJou57ulJCg54U7QVSWllWp5f8nT8KKdjc +T5EOE7zelaTfi5m+rJsziO+1ga8bxiJTyPbH7pcUsMV8eFLI8M5ud2CEpukqdiDt +WAEXMJPpGovgc2PZapKUSU60rUqFxKMiMPwJ7Wgic6aIDFUhWMXhOp8q3crhkODZ +c6tsgLjoC2SToJyMGf+z0gzskSaHirOi4XCPLArlzW1oUevaPwV/izLmE1xr/l9A +4iLItLRkT9a6fUg+qGkM17uGcclzuD87nSVL2v9A6wIDAQABo4IBlTCCAZEwDwYD +VR0TAQH/BAUwAwEB/zCB4QYDVR0gBIHZMIHWMIHTBgkrBgEEAb5YAAMwgcUwgZMG +CCsGAQUFBwICMIGGGoGDQW55IHVzZSBvZiB0aGlzIENlcnRpZmljYXRlIGNvbnN0 +aXR1dGVzIGFjY2VwdGFuY2Ugb2YgdGhlIFF1b1ZhZGlzIFJvb3QgQ0EgMyBDZXJ0 +aWZpY2F0ZSBQb2xpY3kgLyBDZXJ0aWZpY2F0aW9uIFByYWN0aWNlIFN0YXRlbWVu +dC4wLQYIKwYBBQUHAgEWIWh0dHA6Ly93d3cucXVvdmFkaXNnbG9iYWwuY29tL2Nw +czALBgNVHQ8EBAMCAQYwHQYDVR0OBBYEFPLAE+CCQz777i9nMpY1XNu4ywLQMG4G +A1UdIwRnMGWAFPLAE+CCQz777i9nMpY1XNu4ywLQoUmkRzBFMQswCQYDVQQGEwJC +TTEZMBcGA1UEChMQUXVvVmFkaXMgTGltaXRlZDEbMBkGA1UEAxMSUXVvVmFkaXMg +Um9vdCBDQSAzggIFxjANBgkqhkiG9w0BAQUFAAOCAgEAT62gLEz6wPJv92ZVqyM0 +7ucp2sNbtrCD2dDQ4iH782CnO11gUyeim/YIIirnv6By5ZwkajGxkHon24QRiSem +d1o417+shvzuXYO8BsbRd2sPbSQvS3pspweWyuOEn62Iix2rFo1bZhfZFvSLgNLd ++LJ2w/w4E6oM3kJpK27zPOuAJ9v1pkQNn1pVWQvVDVJIxa6f8i+AxeoyUDUSly7B +4f/xI4hROJ/yZlZ25w9Rl6VSDE1JUZU2Pb+iSwwQHYaZTKrzchGT5Or2m9qoXadN +t54CrnMAyNojA+j56hl0YgCUyyIgvpSnWbWCar6ZeXqp8kokUvd0/bpO5qgdAm6x +DYBEwa7TIzdfu4V8K5Iu6H6li92Z4b8nby1dqnuH/grdS/yO9SbkbnBCbjPsMZ57 +k8HkyWkaPcBrTiJt7qtYTcbQQcEr6k8Sh17rRdhs9ZgC06DYVYoGmRmioHfRMJ6s +zHXug/WwYjnPbFfiTNKRCw51KBuav/0aQ/HKd/s7j2G4aSgWQgRecCocIdiP4b0j +Wy10QJLZYxkNc91pvGJHvOB0K7Lrfb5BG7XARsWhIstfTsEokt4YutUqKLsRixeT +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" +# Serial: 17154717934120587862167794914071425081 +# MD5 Fingerprint: 87:ce:0b:7b:2a:0e:49:00:e1:58:71:9b:37:a8:93:72 +# SHA1 Fingerprint: 05:63:b8:63:0d:62:d7:5a:bb:c8:ab:1e:4b:df:b5:a8:99:b2:4d:43 +# SHA256 Fingerprint: 3e:90:99:b5:01:5e:8f:48:6c:00:bc:ea:9d:11:1e:e7:21:fa:ba:35:5a:89:bc:f1:df:69:56:1e:3d:c6:32:5c +-----BEGIN CERTIFICATE----- +MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBl +MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 +d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv +b3QgQ0EwHhcNMDYxMTEwMDAwMDAwWhcNMzExMTEwMDAwMDAwWjBlMQswCQYDVQQG +EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl +cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwggEi +MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCtDhXO5EOAXLGH87dg+XESpa7c +JpSIqvTO9SA5KFhgDPiA2qkVlTJhPLWxKISKityfCgyDF3qPkKyK53lTXDGEKvYP +mDI2dsze3Tyoou9q+yHyUmHfnyDXH+Kx2f4YZNISW1/5WBg1vEfNoTb5a3/UsDg+ +wRvDjDPZ2C8Y/igPs6eD1sNuRMBhNZYW/lmci3Zt1/GiSw0r/wty2p5g0I6QNcZ4 +VYcgoc/lbQrISXwxmDNsIumH0DJaoroTghHtORedmTpyoeb6pNnVFzF1roV9Iq4/ +AUaG9ih5yLHa5FcXxH4cDrC0kqZWs72yl+2qp/C3xag/lRbQ/6GW6whfGHdPAgMB +AAGjYzBhMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW +BBRF66Kv9JLLgjEtUYunpyGd823IDzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYun +pyGd823IDzANBgkqhkiG9w0BAQUFAAOCAQEAog683+Lt8ONyc3pklL/3cmbYMuRC +dWKuh+vy1dneVrOfzM4UKLkNl2BcEkxY5NM9g0lFWJc1aRqoR+pWxnmrEthngYTf +fwk8lOa4JiwgvT2zKIn3X/8i4peEH+ll74fg38FnSbNd67IJKusm7Xi+fT8r87cm +NW1fiQG2SVufAQWbqz0lwcy2f8Lxb4bG+mRo64EtlOtCt/qMHt1i8b5QZ7dsvfPx +H2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe ++o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g== +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Global Root CA" +# Serial: 10944719598952040374951832963794454346 +# MD5 Fingerprint: 79:e4:a9:84:0d:7d:3a:96:d7:c0:4f:e2:43:4c:89:2e +# SHA1 Fingerprint: a8:98:5d:3a:65:e5:e5:c4:b2:d7:d6:6d:40:c6:dd:2f:b1:9c:54:36 +# SHA256 Fingerprint: 43:48:a0:e9:44:4c:78:cb:26:5e:05:8d:5e:89:44:b4:d8:4f:96:62:bd:26:db:25:7f:89:34:a4:43:c7:01:61 +-----BEGIN CERTIFICATE----- +MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh +MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 +d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD +QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT +MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j +b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG +9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB +CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97 +nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt +43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P +T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4 +gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO +BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR +TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw +DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr +hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg +06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF +PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls +YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk +CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4= +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert High Assurance EV Root CA" +# Serial: 3553400076410547919724730734378100087 +# MD5 Fingerprint: d4:74:de:57:5c:39:b2:d3:9c:85:83:c5:c0:65:49:8a +# SHA1 Fingerprint: 5f:b7:ee:06:33:e2:59:db:ad:0c:4c:9a:e6:d3:8f:1a:61:c7:dc:25 +# SHA256 Fingerprint: 74:31:e5:f4:c3:c1:ce:46:90:77:4f:0b:61:e0:54:40:88:3b:a9:a0:1e:d0:0b:a6:ab:d7:80:6e:d3:b1:18:cf +-----BEGIN CERTIFICATE----- +MIIDxTCCAq2gAwIBAgIQAqxcJmoLQJuPC3nyrkYldzANBgkqhkiG9w0BAQUFADBs +MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 +d3cuZGlnaWNlcnQuY29tMSswKQYDVQQDEyJEaWdpQ2VydCBIaWdoIEFzc3VyYW5j +ZSBFViBSb290IENBMB4XDTA2MTExMDAwMDAwMFoXDTMxMTExMDAwMDAwMFowbDEL +MAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3 +LmRpZ2ljZXJ0LmNvbTErMCkGA1UEAxMiRGlnaUNlcnQgSGlnaCBBc3N1cmFuY2Ug +RVYgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMbM5XPm ++9S75S0tMqbf5YE/yc0lSbZxKsPVlDRnogocsF9ppkCxxLeyj9CYpKlBWTrT3JTW +PNt0OKRKzE0lgvdKpVMSOO7zSW1xkX5jtqumX8OkhPhPYlG++MXs2ziS4wblCJEM +xChBVfvLWokVfnHoNb9Ncgk9vjo4UFt3MRuNs8ckRZqnrG0AFFoEt7oT61EKmEFB +Ik5lYYeBQVCmeVyJ3hlKV9Uu5l0cUyx+mM0aBhakaHPQNAQTXKFx01p8VdteZOE3 +hzBWBOURtCmAEvF5OYiiAhF8J2a3iLd48soKqDirCmTCv2ZdlYTBoSUeh10aUAsg +EsxBu24LUTi4S8sCAwEAAaNjMGEwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQF +MAMBAf8wHQYDVR0OBBYEFLE+w2kD+L9HAdSYJhoIAu9jZCvDMB8GA1UdIwQYMBaA +FLE+w2kD+L9HAdSYJhoIAu9jZCvDMA0GCSqGSIb3DQEBBQUAA4IBAQAcGgaX3Nec +nzyIZgYIVyHbIUf4KmeqvxgydkAQV8GK83rZEWWONfqe/EW1ntlMMUu4kehDLI6z +eM7b41N5cdblIZQB2lWHmiRk9opmzN6cN82oNLFpmyPInngiK3BD41VHMWEZ71jF +hS9OMPagMRYjyOfiZRYzy78aG6A9+MpeizGLYAiJLQwGXFK3xPkKmNEVX58Svnw2 +Yzi9RKR/5CYrCsSXaQ3pjOLAEFe4yHYSkVXySGnYvCoCWw9E1CAx2/S6cCZdkGCe +vEsXCS+0yx5DaMkHJ8HSXPfqIbloEpw8nL+e/IBcm2PN7EeqJSdnoDfzAIJ9VNep ++OkuE6N36B9K +-----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" +# Serial: 13492815561806991280 +# MD5 Fingerprint: 24:77:d9:a8:91:d1:3b:fa:88:2d:c2:ff:f8:cd:33:93 +# SHA1 Fingerprint: d8:c5:38:8a:b7:30:1b:1b:6e:d4:7a:e6:45:25:3a:6f:9f:1a:27:61 +# SHA256 Fingerprint: 62:dd:0b:e9:b9:f5:0a:16:3e:a0:f8:e7:5c:05:3b:1e:ca:57:ea:55:c8:68:8f:64:7c:68:81:f2:c8:35:7b:95 +-----BEGIN CERTIFICATE----- +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 +-----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" +# Serial: 17199774589125277788362757014266862032 +# MD5 Fingerprint: dc:32:c3:a7:6d:25:57:c7:68:09:9d:ea:2d:a9:a2:d1 +# SHA1 Fingerprint: 87:82:c6:c3:04:35:3b:cf:d2:96:92:d2:59:3e:7d:44:d9:34:ff:11 +# SHA256 Fingerprint: f1:c1:b5:0a:e5:a2:0d:d8:03:0e:c9:f6:bc:24:82:3d:d3:67:b5:25:57:59:b4:e7:1b:61:fc:e9:f7:37:5d:73 +-----BEGIN CERTIFICATE----- +MIIDuDCCAqCgAwIBAgIQDPCOXAgWpa1Cf/DrJxhZ0DANBgkqhkiG9w0BAQUFADBI +MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x +FzAVBgNVBAMTDlNlY3VyZVRydXN0IENBMB4XDTA2MTEwNzE5MzExOFoXDTI5MTIz +MTE5NDA1NVowSDELMAkGA1UEBhMCVVMxIDAeBgNVBAoTF1NlY3VyZVRydXN0IENv +cnBvcmF0aW9uMRcwFQYDVQQDEw5TZWN1cmVUcnVzdCBDQTCCASIwDQYJKoZIhvcN +AQEBBQADggEPADCCAQoCggEBAKukgeWVzfX2FI7CT8rU4niVWJxB4Q2ZQCQXOZEz +Zum+4YOvYlyJ0fwkW2Gz4BERQRwdbvC4u/jep4G6pkjGnx29vo6pQT64lO0pGtSO +0gMdA+9tDWccV9cGrcrI9f4Or2YlSASWC12juhbDCE/RRvgUXPLIXgGZbf2IzIao +wW8xQmxSPmjL8xk037uHGFaAJsTQ3MBv396gwpEWoGQRS0S8Hvbn+mPeZqx2pHGj +7DaUaHp3pLHnDi+BeuK1cobvomuL8A/b01k/unK8RCSc43Oz969XL0Imnal0ugBS +8kvNU3xHCzaFDmapCJcWNFfBZveA4+1wVMeT4C4oFVmHursCAwEAAaOBnTCBmjAT +BgkrBgEEAYI3FAIEBh4EAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB +/zAdBgNVHQ4EFgQUQjK2FvoE/f5dS3rD/fdMQB1aQ68wNAYDVR0fBC0wKzApoCeg +JYYjaHR0cDovL2NybC5zZWN1cmV0cnVzdC5jb20vU1RDQS5jcmwwEAYJKwYBBAGC +NxUBBAMCAQAwDQYJKoZIhvcNAQEFBQADggEBADDtT0rhWDpSclu1pqNlGKa7UTt3 +6Z3q059c4EVlew3KW+JwULKUBRSuSceNQQcSc5R+DCMh/bwQf2AQWnL1mA6s7Ll/ +3XpvXdMc9P+IBWlCqQVxyLesJugutIxq/3HcuLHfmbx8IVQr5Fiiu1cprp6poxkm +D5kuCLDv/WnPmRoJjeOnnyvJNjR7JLN4TJUXpAYmHrZkUjZfYGfZnMUFdAvnZyPS +CPyI6a6Lf+Ew9Dd+/cYy2i2eRDAwbO4H3tI0/NL/QPZL9GZGBlSm8jIKYyYwa5vR +3ItHuuG51WLQoqD0ZwV4KWMabwTW+MZMo5qxN7SN5ShLHZ4swrhovO0C7jE= +-----END CERTIFICATE----- + +# Issuer: CN=Secure Global CA O=SecureTrust Corporation +# Subject: CN=Secure Global CA O=SecureTrust Corporation +# Label: "Secure Global CA" +# Serial: 9751836167731051554232119481456978597 +# MD5 Fingerprint: cf:f4:27:0d:d4:ed:dc:65:16:49:6d:3d:da:bf:6e:de +# SHA1 Fingerprint: 3a:44:73:5a:e5:81:90:1f:24:86:61:46:1e:3b:9c:c4:5f:f5:3a:1b +# SHA256 Fingerprint: 42:00:f5:04:3a:c8:59:0e:bb:52:7d:20:9e:d1:50:30:29:fb:cb:d4:1c:a1:b5:06:ec:27:f1:5a:de:7d:ac:69 +-----BEGIN CERTIFICATE----- +MIIDvDCCAqSgAwIBAgIQB1YipOjUiolN9BPI8PjqpTANBgkqhkiG9w0BAQUFADBK +MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x +GTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwHhcNMDYxMTA3MTk0MjI4WhcNMjkx +MjMxMTk1MjA2WjBKMQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3Qg +Q29ycG9yYXRpb24xGTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwggEiMA0GCSqG +SIb3DQEBAQUAA4IBDwAwggEKAoIBAQCvNS7YrGxVaQZx5RNoJLNP2MwhR/jxYDiJ +iQPpvepeRlMJ3Fz1Wuj3RSoC6zFh1ykzTM7HfAo3fg+6MpjhHZevj8fcyTiW89sa +/FHtaMbQbqR8JNGuQsiWUGMu4P51/pinX0kuleM5M2SOHqRfkNJnPLLZ/kG5VacJ +jnIFHovdRIWCQtBJwB1g8NEXLJXr9qXBkqPFwqcIYA1gBBCWeZ4WNOaptvolRTnI +HmX5k/Wq8VLcmZg9pYYaDDUz+kulBAYVHDGA76oYa8J719rO+TMg1fW9ajMtgQT7 +sFzUnKPiXB3jqUJ1XnvUd+85VLrJChgbEplJL4hL/VBi0XPnj3pDAgMBAAGjgZ0w +gZowEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQF +MAMBAf8wHQYDVR0OBBYEFK9EBMJBfkiD2045AuzshHrmzsmkMDQGA1UdHwQtMCsw +KaAnoCWGI2h0dHA6Ly9jcmwuc2VjdXJldHJ1c3QuY29tL1NHQ0EuY3JsMBAGCSsG +AQQBgjcVAQQDAgEAMA0GCSqGSIb3DQEBBQUAA4IBAQBjGghAfaReUw132HquHw0L +URYD7xh8yOOvaliTFGCRsoTciE6+OYo68+aCiV0BN7OrJKQVDpI1WkpEXk5X+nXO +H0jOZvQ8QCaSmGwb7iRGDBezUqXbpZGRzzfTb+cnCDpOGR86p1hcF895P4vkp9Mm +I50mD1hp/Ed+stCNi5O/KU9DaXR2Z0vPB4zmAve14bRDtUstFJ/53CYNv6ZHdAbY +iNE6KTCEztI5gGIbqMdXSbxqVVFnFUq+NQfk1XWYN3kwFNspnWzFacxHVaIw98xc +f8LDmBxrThaA63p4ZUWiABqvDA1VZDRIuJK58bRQKfJPIx/abKwfROHdI3hRW8cW +-----END CERTIFICATE----- + +# Issuer: CN=COMODO Certification Authority O=COMODO CA Limited +# Subject: CN=COMODO Certification Authority O=COMODO CA Limited +# Label: "COMODO Certification Authority" +# Serial: 104350513648249232941998508985834464573 +# MD5 Fingerprint: 5c:48:dc:f7:42:72:ec:56:94:6d:1c:cc:71:35:80:75 +# SHA1 Fingerprint: 66:31:bf:9e:f7:4f:9e:b6:c9:d5:a6:0c:ba:6a:be:d1:f7:bd:ef:7b +# SHA256 Fingerprint: 0c:2c:d6:3d:f7:80:6f:a3:99:ed:e8:09:11:6b:57:5b:f8:79:89:f0:65:18:f9:80:8c:86:05:03:17:8b:af:66 +-----BEGIN CERTIFICATE----- +MIIEHTCCAwWgAwIBAgIQToEtioJl4AsC7j41AkblPTANBgkqhkiG9w0BAQUFADCB +gTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G +A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxJzAlBgNV +BAMTHkNPTU9ETyBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNjEyMDEwMDAw +MDBaFw0yOTEyMzEyMzU5NTlaMIGBMQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3Jl +YXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRowGAYDVQQKExFDT01P +RE8gQ0EgTGltaXRlZDEnMCUGA1UEAxMeQ09NT0RPIENlcnRpZmljYXRpb24gQXV0 +aG9yaXR5MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0ECLi3LjkRv3 +UcEbVASY06m/weaKXTuH+7uIzg3jLz8GlvCiKVCZrts7oVewdFFxze1CkU1B/qnI +2GqGd0S7WWaXUF601CxwRM/aN5VCaTwwxHGzUvAhTaHYujl8HJ6jJJ3ygxaYqhZ8 +Q5sVW7euNJH+1GImGEaaP+vB+fGQV+useg2L23IwambV4EajcNxo2f8ESIl33rXp ++2dtQem8Ob0y2WIC8bGoPW43nOIv4tOiJovGuFVDiOEjPqXSJDlqR6sA1KGzqSX+ +DT+nHbrTUcELpNqsOO9VUCQFZUaTNE8tja3G1CEZ0o7KBWFxB3NH5YoZEr0ETc5O +nKVIrLsm9wIDAQABo4GOMIGLMB0GA1UdDgQWBBQLWOWLxkwVN6RAqTCpIb5HNlpW +/zAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zBJBgNVHR8EQjBAMD6g +PKA6hjhodHRwOi8vY3JsLmNvbW9kb2NhLmNvbS9DT01PRE9DZXJ0aWZpY2F0aW9u +QXV0aG9yaXR5LmNybDANBgkqhkiG9w0BAQUFAAOCAQEAPpiem/Yb6dc5t3iuHXIY +SdOH5EOC6z/JqvWote9VfCFSZfnVDeFs9D6Mk3ORLgLETgdxb8CPOGEIqB6BCsAv +IC9Bi5HcSEW88cbeunZrM8gALTFGTO3nnc+IlP8zwFboJIYmuNg4ON8qa90SzMc/ +RxdMosIGlgnW2/4/PEZB31jiVg88O8EckzXZOFKs7sjsLjBOlDW0JB9LeGna8gI4 +zJVSk/BwJVmcIGfE7vmLV2H0knZ9P4SNVbfo5azV8fUZVqZa+5Acr5Pr5RzUZ5dd +BA6+C4OmF4O5MBKgxTMVBbkN+8cFduPYSo38NBejxiEovjBFMR7HeL5YYTisO+IB +ZQ== +-----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" +# Serial: 41578283867086692638256921589707938090 +# MD5 Fingerprint: 7c:62:ff:74:9d:31:53:5e:68:4a:d5:78:aa:1e:bf:23 +# SHA1 Fingerprint: 9f:74:4e:9f:2b:4d:ba:ec:0f:31:2c:50:b6:56:3b:8e:2d:93:c3:11 +# SHA256 Fingerprint: 17:93:92:7a:06:14:54:97:89:ad:ce:2f:8f:34:f7:f0:b6:6d:0f:3a:e3:a3:b8:4d:21:ec:15:db:ba:4f:ad:c7 +-----BEGIN CERTIFICATE----- +MIICiTCCAg+gAwIBAgIQH0evqmIAcFBUTAGem2OZKjAKBggqhkjOPQQDAzCBhTEL +MAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE +BxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMT +IkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwMzA2MDAw +MDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdy +ZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09N +T0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlv +biBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQDR3svdcmCFYX7deSR +FtSrYpn1PlILBs5BAH+X4QokPB0BBO490o0JlwzgdeT6+3eKKvUDYEs2ixYjFq0J +cfRK9ChQtP6IHG4/bC8vCVlbpVsLM5niwz2J+Wos77LTBumjQjBAMB0GA1UdDgQW +BBR1cacZSBm8nZ3qQUfflMRId5nTeTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/ +BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjEA7wNbeqy3eApyt4jf/7VGFAkK+qDm +fQjGGoe9GKhzvSbKYAydzpmfz1wPMOG+FDHqAjAU9JM8SaczepBGR7NjfRObTrdv +GDeAU/7dIOA1mjbRxwG55tzd8/8dLDoWV9mSOdY= +-----END CERTIFICATE----- + +# Issuer: CN=Certigna O=Dhimyotis +# Subject: CN=Certigna O=Dhimyotis +# Label: "Certigna" +# Serial: 18364802974209362175 +# MD5 Fingerprint: ab:57:a6:5b:7d:42:82:19:b5:d8:58:26:28:5e:fd:ff +# SHA1 Fingerprint: b1:2e:13:63:45:86:a4:6f:1a:b2:60:68:37:58:2d:c4:ac:fd:94:97 +# SHA256 Fingerprint: e3:b6:a2:db:2e:d7:ce:48:84:2f:7a:c5:32:41:c7:b7:1d:54:14:4b:fb:40:c1:1f:3f:1d:0b:42:f5:ee:a1:2d +-----BEGIN CERTIFICATE----- +MIIDqDCCApCgAwIBAgIJAP7c4wEPyUj/MA0GCSqGSIb3DQEBBQUAMDQxCzAJBgNV +BAYTAkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hMB4X +DTA3MDYyOTE1MTMwNVoXDTI3MDYyOTE1MTMwNVowNDELMAkGA1UEBhMCRlIxEjAQ +BgNVBAoMCURoaW15b3RpczERMA8GA1UEAwwIQ2VydGlnbmEwggEiMA0GCSqGSIb3 +DQEBAQUAA4IBDwAwggEKAoIBAQDIaPHJ1tazNHUmgh7stL7qXOEm7RFHYeGifBZ4 +QCHkYJ5ayGPhxLGWkv8YbWkj4Sti993iNi+RB7lIzw7sebYs5zRLcAglozyHGxny +gQcPOJAZ0xH+hrTy0V4eHpbNgGzOOzGTtvKg0KmVEn2lmsxryIRWijOp5yIVUxbw +zBfsV1/pogqYCd7jX5xv3EjjhQsVWqa6n6xI4wmy9/Qy3l40vhx4XUJbzg4ij02Q +130yGLMLLGq/jj8UEYkgDncUtT2UCIf3JR7VsmAA7G8qKCVuKj4YYxclPz5EIBb2 +JsglrgVKtOdjLPOMFlN+XPsRGgjBRmKfIrjxwo1p3Po6WAbfAgMBAAGjgbwwgbkw +DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUGu3+QTmQtCRZvgHyUtVF9lo53BEw +ZAYDVR0jBF0wW4AUGu3+QTmQtCRZvgHyUtVF9lo53BGhOKQ2MDQxCzAJBgNVBAYT +AkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hggkA/tzj +AQ/JSP8wDgYDVR0PAQH/BAQDAgEGMBEGCWCGSAGG+EIBAQQEAwIABzANBgkqhkiG +9w0BAQUFAAOCAQEAhQMeknH2Qq/ho2Ge6/PAD/Kl1NqV5ta+aDY9fm4fTIrv0Q8h +bV6lUmPOEvjvKtpv6zf+EwLHyzs+ImvaYS5/1HI93TDhHkxAGYwP15zRgzB7mFnc +fca5DClMoTOi62c6ZYTTluLtdkVwj7Ur3vkj1kluPBS1xp81HlDQwY9qcEQCYsuu +HWhBp6pX6FOqB9IG9tUUBguRA3UsbHK1YZWaDYu5Def131TN3ubY1gkIl2PlwS6w +t0QmwCbAr1UwnjvVNioZBPRcHv/PLLf/0P2HQBHVESO7SMAhqaQoLf0V+LBOK/Qw +WyH8EZE0vkHve52Xdf+XlcCWWC/qu0bXu+TZLg== +-----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" +# Serial: 28956088682735189655030529057352760477 +# MD5 Fingerprint: 1b:2e:00:ca:26:06:90:3d:ad:fe:6f:15:68:d3:6b:b3 +# SHA1 Fingerprint: 67:65:0d:f1:7e:8e:7e:5b:82:40:a4:f4:56:4b:cf:e2:3d:69:c6:f0 +# SHA256 Fingerprint: c0:a6:f4:dc:63:a2:4b:fd:cf:54:ef:2a:6a:08:2a:0a:72:de:35:80:3e:2f:f5:ff:52:7a:e5:d8:72:06:df:d5 +-----BEGIN CERTIFICATE----- +MIIFsDCCA5igAwIBAgIQFci9ZUdcr7iXAF7kBtK8nTANBgkqhkiG9w0BAQUFADBe +MQswCQYDVQQGEwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0 +ZC4xKjAoBgNVBAsMIWVQS0kgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAe +Fw0wNDEyMjAwMjMxMjdaFw0zNDEyMjAwMjMxMjdaMF4xCzAJBgNVBAYTAlRXMSMw +IQYDVQQKDBpDaHVuZ2h3YSBUZWxlY29tIENvLiwgTHRkLjEqMCgGA1UECwwhZVBL +SSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkqhkiG9w0BAQEF +AAOCAg8AMIICCgKCAgEA4SUP7o3biDN1Z82tH306Tm2d0y8U82N0ywEhajfqhFAH +SyZbCUNsIZ5qyNUD9WBpj8zwIuQf5/dqIjG3LBXy4P4AakP/h2XGtRrBp0xtInAh +ijHyl3SJCRImHJ7K2RKilTza6We/CKBk49ZCt0Xvl/T29de1ShUCWH2YWEtgvM3X +DZoTM1PRYfl61dd4s5oz9wCGzh1NlDivqOx4UXCKXBCDUSH3ET00hl7lSM2XgYI1 +TBnsZfZrxQWh7kcT1rMhJ5QQCtkkO7q+RBNGMD+XPNjX12ruOzjjK9SXDrkb5wdJ +fzcq+Xd4z1TtW0ado4AOkUPB1ltfFLqfpo0kR0BZv3I4sjZsN/+Z0V0OWQqraffA +sgRFelQArr5T9rXn4fg8ozHSqf4hUmTFpmfwdQcGlBSBVcYn5AGPF8Fqcde+S/uU +WH1+ETOxQvdibBjWzwloPn9s9h6PYq2lY9sJpx8iQkEeb5mKPtf5P0B6ebClAZLS +nT0IFaUQAS2zMnaolQ2zepr7BxB4EW/hj8e6DyUadCrlHJhBmd8hh+iVBmoKs2pH +dmX2Os+PYhcZewoozRrSgx4hxyy/vv9haLdnG7t4TY3OZ+XkwY63I2binZB1NJip +NiuKmpS5nezMirH4JYlcWrYvjB9teSSnUmjDhDXiZo1jDiVN1Rmy5nk3pyKdVDEC +AwEAAaNqMGgwHQYDVR0OBBYEFB4M97Zn8uGSJglFwFU5Lnc/QkqiMAwGA1UdEwQF +MAMBAf8wOQYEZyoHAAQxMC8wLQIBADAJBgUrDgMCGgUAMAcGBWcqAwAABBRFsMLH +ClZ87lt4DJX5GFPBphzYEDANBgkqhkiG9w0BAQUFAAOCAgEACbODU1kBPpVJufGB +uvl2ICO1J2B01GqZNF5sAFPZn/KmsSQHRGoqxqWOeBLoR9lYGxMqXnmbnwoqZ6Yl +PwZpVnPDimZI+ymBV3QGypzqKOg4ZyYr8dW1P2WT+DZdjo2NQCCHGervJ8A9tDkP +JXtoUHRVnAxZfVo9QZQlUgjgRywVMRnVvwdVxrsStZf0X4OFunHB2WyBEXYKCrC/ +gpf36j36+uwtqSiUO1bd0lEursC9CBWMd1I0ltabrNMdjmEPNXubrjlpC2JgQCA2 +j6/7Nu4tCEoduL+bXPjqpRugc6bY+G7gMwRfaKonh+3ZwZCc7b3jajWvY9+rGNm6 +5ulK6lCKD2GTHuItGeIwlDWSXQ62B68ZgI9HkFFLLk3dheLSClIKF5r8GrBQAuUB +o2M3IUxExJtRmREOc5wGj1QupyheRDmHVi03vYVElOEMSyycw5KFNGHLD7ibSkNS +/jQ6fbjpKdx2qcgw+BRxgMYeNkh0IkFch4LoGHGLQYlE535YW6i4jRPpp2zDR+2z +Gp1iro2C6pSe3VkQw63d4k3jMdXH7OjysP6SHhYKGvzZ8/gntsm+HbRsZJB/9OTE +W9c3rkIO3aQab3yIVMUWbuF6aC74Or8NpDyJO3inTmODBCEIZ43ygknQW/2xzQ+D +hNQ+IIX3Sj0rnP0qCglN6oH4EZw= +-----END CERTIFICATE----- + +# Issuer: O=certSIGN OU=certSIGN ROOT CA +# Subject: O=certSIGN OU=certSIGN ROOT CA +# Label: "certSIGN ROOT CA" +# Serial: 35210227249154 +# MD5 Fingerprint: 18:98:c0:d6:e9:3a:fc:f9:b0:f5:0c:f7:4b:01:44:17 +# SHA1 Fingerprint: fa:b7:ee:36:97:26:62:fb:2d:b0:2a:f6:bf:03:fd:e8:7c:4b:2f:9b +# SHA256 Fingerprint: ea:a9:62:c4:fa:4a:6b:af:eb:e4:15:19:6d:35:1c:cd:88:8d:4f:53:f3:fa:8a:e6:d7:c4:66:a9:4e:60:42:bb +-----BEGIN CERTIFICATE----- +MIIDODCCAiCgAwIBAgIGIAYFFnACMA0GCSqGSIb3DQEBBQUAMDsxCzAJBgNVBAYT +AlJPMREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBD +QTAeFw0wNjA3MDQxNzIwMDRaFw0zMTA3MDQxNzIwMDRaMDsxCzAJBgNVBAYTAlJP +MREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBDQTCC +ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALczuX7IJUqOtdu0KBuqV5Do +0SLTZLrTk+jUrIZhQGpgV2hUhE28alQCBf/fm5oqrl0Hj0rDKH/v+yv6efHHrfAQ +UySQi2bJqIirr1qjAOm+ukbuW3N7LBeCgV5iLKECZbO9xSsAfsT8AzNXDe3i+s5d +RdY4zTW2ssHQnIFKquSyAVwdj1+ZxLGt24gh65AIgoDzMKND5pCCrlUoSe1b16kQ +OA7+j0xbm0bqQfWwCHTD0IgztnzXdN/chNFDDnU5oSVAKOp4yw4sLjmdjItuFhwv +JoIQ4uNllAoEwF73XVv4EOLQunpL+943AAAaWyjj0pxzPjKHmKHJUS/X3qwzs08C +AwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAcYwHQYDVR0O +BBYEFOCMm9slSbPxfIbWskKHC9BroNnkMA0GCSqGSIb3DQEBBQUAA4IBAQA+0hyJ +LjX8+HXd5n9liPRyTMks1zJO890ZeUe9jjtbkw9QSSQTaxQGcu8J06Gh40CEyecY +MnQ8SG4Pn0vU9x7Tk4ZkVJdjclDVVc/6IJMCopvDI5NOFlV2oHB5bc0hH88vLbwZ +44gx+FkagQnIl6Z0x2DEW8xXjrJ1/RsCCdtZb3KTafcxQdaIOL+Hsr0Wefmq5L6I +Jd1hJyMctTEHBDa0GpC9oHRxUIltvBTjD4au8as+x6AJzKNI0eDbZOeStc+vckNw +i/nDhDwTqn6Sm1dTk/pwwpEOMfmbZ13pljheX7NzTogVZ96edhBiIL5VaZVDADlN +9u6wWk5JRFRYX0KD +-----END CERTIFICATE----- + +# Issuer: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services) +# Subject: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services) +# Label: "NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny" +# Serial: 80544274841616 +# MD5 Fingerprint: c5:a1:b7:ff:73:dd:d6:d7:34:32:18:df:fc:3c:ad:88 +# SHA1 Fingerprint: 06:08:3f:59:3f:15:a1:04:a0:69:a4:6b:a9:03:d0:06:b7:97:09:91 +# SHA256 Fingerprint: 6c:61:da:c3:a2:de:f0:31:50:6b:e0:36:d2:a6:fe:40:19:94:fb:d1:3d:f9:c8:d4:66:59:92:74:c4:46:ec:98 +-----BEGIN CERTIFICATE----- +MIIEFTCCAv2gAwIBAgIGSUEs5AAQMA0GCSqGSIb3DQEBCwUAMIGnMQswCQYDVQQG +EwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFTATBgNVBAoMDE5ldExvY2sgS2Z0LjE3 +MDUGA1UECwwuVGFuw7pzw610dsOhbnlraWFkw7NrIChDZXJ0aWZpY2F0aW9uIFNl +cnZpY2VzKTE1MDMGA1UEAwwsTmV0TG9jayBBcmFueSAoQ2xhc3MgR29sZCkgRsWR +dGFuw7pzw610dsOhbnkwHhcNMDgxMjExMTUwODIxWhcNMjgxMjA2MTUwODIxWjCB +pzELMAkGA1UEBhMCSFUxETAPBgNVBAcMCEJ1ZGFwZXN0MRUwEwYDVQQKDAxOZXRM +b2NrIEtmdC4xNzA1BgNVBAsMLlRhbsO6c8OtdHbDoW55a2lhZMOzayAoQ2VydGlm +aWNhdGlvbiBTZXJ2aWNlcykxNTAzBgNVBAMMLE5ldExvY2sgQXJhbnkgKENsYXNz +IEdvbGQpIEbFkXRhbsO6c8OtdHbDoW55MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A +MIIBCgKCAQEAxCRec75LbRTDofTjl5Bu0jBFHjzuZ9lk4BqKf8owyoPjIMHj9DrT +lF8afFttvzBPhCf2nx9JvMaZCpDyD/V/Q4Q3Y1GLeqVw/HpYzY6b7cNGbIRwXdrz +AZAj/E4wqX7hJ2Pn7WQ8oLjJM2P+FpD/sLj916jAwJRDC7bVWaaeVtAkH3B5r9s5 +VA1lddkVQZQBr17s9o3x/61k/iCa11zr/qYfCGSji3ZVrR47KGAuhyXoqq8fxmRG +ILdwfzzeSNuWU7c5d+Qa4scWhHaXWy+7GRWF+GmF9ZmnqfI0p6m2pgP8b4Y9VHx2 +BJtr+UBdADTHLpl1neWIA6pN+APSQnbAGwIDAKiLo0UwQzASBgNVHRMBAf8ECDAG +AQH/AgEEMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUzPpnk/C2uNClwB7zU/2M +U9+D15YwDQYJKoZIhvcNAQELBQADggEBAKt/7hwWqZw8UQCgwBEIBaeZ5m8BiFRh +bvG5GK1Krf6BQCOUL/t1fC8oS2IkgYIL9WHxHG64YTjrgfpioTtaYtOUZcTh5m2C ++C8lcLIhJsFyUR+MLMOEkMNaj7rP9KdlpeuY0fsFskZ1FSNqb4VjMIDw1Z4fKRzC +bLBQWV2QWzuoDTDPv31/zvGdg73JRm4gpvlhUbohL3u+pRVjodSVh/GeufOJ8z2F +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" +# Serial: 14014712776195784473 +# MD5 Fingerprint: f8:49:f4:03:bc:44:2d:83:be:48:69:7d:29:64:fc:b1 +# SHA1 Fingerprint: 89:df:74:fe:5c:f4:0f:4a:80:f9:e3:37:7d:54:da:91:e1:01:31:8e +# SHA256 Fingerprint: 3c:5f:81:fe:a5:fa:b8:2c:64:bf:a2:ea:ec:af:cd:e8:e0:77:fc:86:20:a7:ca:e5:37:16:3d:f3:6e:db:f3:78 +-----BEGIN CERTIFICATE----- +MIIECjCCAvKgAwIBAgIJAMJ+QwRORz8ZMA0GCSqGSIb3DQEBCwUAMIGCMQswCQYD +VQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0 +ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3ppZ25vIFJvb3QgQ0EgMjAwOTEfMB0G +CSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5odTAeFw0wOTA2MTYxMTMwMThaFw0y +OTEyMzAxMTMwMThaMIGCMQswCQYDVQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3Qx +FjAUBgNVBAoMDU1pY3Jvc2VjIEx0ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3pp +Z25vIFJvb3QgQ0EgMjAwOTEfMB0GCSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5o +dTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAOn4j/NjrdqG2KfgQvvP +kd6mJviZpWNwrZuuyjNAfW2WbqEORO7hE52UQlKavXWFdCyoDh2Tthi3jCyoz/tc +cbna7P7ofo/kLx2yqHWH2Leh5TvPmUpG0IMZfcChEhyVbUr02MelTTMuhTlAdX4U +fIASmFDHQWe4oIBhVKZsTh/gnQ4H6cm6M+f+wFUoLAKApxn1ntxVUwOXewdI/5n7 +N4okxFnMUBBjjqqpGrCEGob5X7uxUG6k0QrM1XF+H6cbfPVTbiJfyyvm1HxdrtbC +xkzlBQHZ7Vf8wSN5/PrIJIOV87VqUQHQd9bpEqH5GoP7ghu5sJf0dgYzQ0mg/wu1 ++rUCAwEAAaOBgDB+MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G +A1UdDgQWBBTLD8bfQkPMPcu1SCOhGnqmKrs0aDAfBgNVHSMEGDAWgBTLD8bfQkPM +Pcu1SCOhGnqmKrs0aDAbBgNVHREEFDASgRBpbmZvQGUtc3ppZ25vLmh1MA0GCSqG +SIb3DQEBCwUAA4IBAQDJ0Q5eLtXMs3w+y/w9/w0olZMEyL/azXm4Q5DwpL7v8u8h +mLzU1F0G9u5C7DBsoKqpyvGvivo/C3NqPuouQH4frlRheesuCDfXI/OMn74dseGk +ddug4lQUsbocKaQY9hK6ohQU4zE1yED/t+AFdlfBHFny+L/k7SViXITwfn4fs775 +tyERzAMBVnCnEJIeGzSBHq2cGsMEPO0CYdYeBvNfOofyK/FFh+U9rNHHV4S9a67c +2Pm2G2JwCz02yULyMtd6YebS2z3PyKnJm9zbWETXbzivf3jTo60adbocwTZ8jx5t +HMN1Rq41Bab2XD0h7lbwyYIiLXpUq3DDfSJlgnCW +-----END CERTIFICATE----- + +# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3 +# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3 +# Label: "GlobalSign Root CA - R3" +# Serial: 4835703278459759426209954 +# MD5 Fingerprint: c5:df:b8:49:ca:05:13:55:ee:2d:ba:1a:c3:3e:b0:28 +# SHA1 Fingerprint: d6:9b:56:11:48:f0:1c:77:c5:45:78:c1:09:26:df:5b:85:69:76:ad +# SHA256 Fingerprint: cb:b5:22:d7:b7:f1:27:ad:6a:01:13:86:5b:df:1c:d4:10:2e:7d:07:59:af:63:5a:7c:f4:72:0d:c9:63:c5:3b +-----BEGIN CERTIFICATE----- +MIIDXzCCAkegAwIBAgILBAAAAAABIVhTCKIwDQYJKoZIhvcNAQELBQAwTDEgMB4G +A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2JhbFNp +Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDkwMzE4MTAwMDAwWhcNMjkwMzE4 +MTAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEG +A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI +hvcNAQEBBQADggEPADCCAQoCggEBAMwldpB5BngiFvXAg7aEyiie/QV2EcWtiHL8 +RgJDx7KKnQRfJMsuS+FggkbhUqsMgUdwbN1k0ev1LKMPgj0MK66X17YUhhB5uzsT +gHeMCOFJ0mpiLx9e+pZo34knlTifBtc+ycsmWQ1z3rDI6SYOgxXG71uL0gRgykmm +KPZpO/bLyCiR5Z2KYVc3rHQU3HTgOu5yLy6c+9C7v/U9AOEGM+iCK65TpjoWc4zd +QQ4gOsC0p6Hpsk+QLjJg6VfLuQSSaGjlOCZgdbKfd/+RFO+uIEn8rUAVSNECMWEZ +XriX7613t2Saer9fwRPvm2L7DWzgVGkWqQPabumDk3F2xmmFghcCAwEAAaNCMEAw +DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI/wS3+o +LkUkrk1Q+mOai97i3Ru8MA0GCSqGSIb3DQEBCwUAA4IBAQBLQNvAUKr+yAzv95ZU +RUm7lgAJQayzE4aGKAczymvmdLm6AC2upArT9fHxD4q/c2dKg8dEe3jgr25sbwMp +jjM5RcOO5LlXbKr8EpbsU8Yt5CRsuZRj+9xTaGdWPoO4zzUhw8lo/s7awlOqzJCK +6fBdRoyV3XpYKBovHd7NADdBj+1EbddTKJd+82cEHhXXipa0095MJ6RMG3NzdvQX +mcIfeg7jLQitChws/zyrVQ4PkX4268NXSb7hLi18YIvDQVETI53O9zJrlAGomecs +Mx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7rkpeDMdmztcpH +WD9f +-----END CERTIFICATE----- + +# Issuer: CN=Izenpe.com O=IZENPE S.A. +# Subject: CN=Izenpe.com O=IZENPE S.A. +# Label: "Izenpe.com" +# Serial: 917563065490389241595536686991402621 +# MD5 Fingerprint: a6:b0:cd:85:80:da:5c:50:34:a3:39:90:2f:55:67:73 +# SHA1 Fingerprint: 2f:78:3d:25:52:18:a7:4a:65:39:71:b5:2c:a2:9c:45:15:6f:e9:19 +# SHA256 Fingerprint: 25:30:cc:8e:98:32:15:02:ba:d9:6f:9b:1f:ba:1b:09:9e:2d:29:9e:0f:45:48:bb:91:4f:36:3b:c0:d4:53:1f +-----BEGIN CERTIFICATE----- +MIIF8TCCA9mgAwIBAgIQALC3WhZIX7/hy/WL1xnmfTANBgkqhkiG9w0BAQsFADA4 +MQswCQYDVQQGEwJFUzEUMBIGA1UECgwLSVpFTlBFIFMuQS4xEzARBgNVBAMMCkl6 +ZW5wZS5jb20wHhcNMDcxMjEzMTMwODI4WhcNMzcxMjEzMDgyNzI1WjA4MQswCQYD +VQQGEwJFUzEUMBIGA1UECgwLSVpFTlBFIFMuQS4xEzARBgNVBAMMCkl6ZW5wZS5j +b20wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDJ03rKDx6sp4boFmVq +scIbRTJxldn+EFvMr+eleQGPicPK8lVx93e+d5TzcqQsRNiekpsUOqHnJJAKClaO +xdgmlOHZSOEtPtoKct2jmRXagaKH9HtuJneJWK3W6wyyQXpzbm3benhB6QiIEn6H +LmYRY2xU+zydcsC8Lv/Ct90NduM61/e0aL6i9eOBbsFGb12N4E3GVFWJGjMxCrFX +uaOKmMPsOzTFlUFpfnXCPCDFYbpRR6AgkJOhkEvzTnyFRVSa0QUmQbC1TR0zvsQD +yCV8wXDbO/QJLVQnSKwv4cSsPsjLkkxTOTcj7NMB+eAJRE1NZMDhDVqHIrytG6P+ +JrUV86f8hBnp7KGItERphIPzidF0BqnMC9bC3ieFUCbKF7jJeodWLBoBHmy+E60Q +rLUk9TiRodZL2vG70t5HtfG8gfZZa88ZU+mNFctKy6lvROUbQc/hhqfK0GqfvEyN +BjNaooXlkDWgYlwWTvDjovoDGrQscbNYLN57C9saD+veIR8GdwYDsMnvmfzAuU8L +hij+0rnq49qlw0dpEuDb8PYZi+17cNcC1u2HGCgsBCRMd+RIihrGO5rUD8r6ddIB +QFqNeb+Lz0vPqhbBleStTIo+F5HUsWLlguWABKQDfo2/2n+iD5dPDNMN+9fR5XJ+ +HMh3/1uaD7euBUbl8agW7EekFwIDAQABo4H2MIHzMIGwBgNVHREEgagwgaWBD2lu +Zm9AaXplbnBlLmNvbaSBkTCBjjFHMEUGA1UECgw+SVpFTlBFIFMuQS4gLSBDSUYg +QTAxMzM3MjYwLVJNZXJjLlZpdG9yaWEtR2FzdGVpeiBUMTA1NSBGNjIgUzgxQzBB +BgNVBAkMOkF2ZGEgZGVsIE1lZGl0ZXJyYW5lbyBFdG9yYmlkZWEgMTQgLSAwMTAx +MCBWaXRvcmlhLUdhc3RlaXowDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC +AQYwHQYDVR0OBBYEFB0cZQ6o8iV7tJHP5LGx5r1VdGwFMA0GCSqGSIb3DQEBCwUA +A4ICAQB4pgwWSp9MiDrAyw6lFn2fuUhfGI8NYjb2zRlrrKvV9pF9rnHzP7MOeIWb +laQnIUdCSnxIOvVFfLMMjlF4rJUT3sb9fbgakEyrkgPH7UIBzg/YsfqikuFgba56 +awmqxinuaElnMIAkejEWOVt+8Rwu3WwJrfIxwYJOubv5vr8qhT/AQKM6WfxZSzwo +JNu0FXWuDYi6LnPAvViH5ULy617uHjAimcs30cQhbIHsvm0m5hzkQiCeR7Csg1lw +LDXWrzY0tM07+DKo7+N4ifuNRSzanLh+QBxh5z6ikixL8s36mLYp//Pye6kfLqCT +VyvehQP5aTfLnnhqBbTFMXiJ7HqnheG5ezzevh55hM6fcA5ZwjUukCox2eRFekGk +LhObNA5me0mrZJfQRsN5nXJQY6aYWwa9SG3YOYNw6DXwBdGqvOPbyALqfP2C2sJb +UjWumDqtujWTI6cfSN01RpiyEGjkpTHCClguGYEQyVB1/OpaFs4R1+7vUIgtYf8/ +QnMFlEPVjjxOAToZpR9GTnfQXeWBIiGH/pR9hNiTrdZoQ0iy2+tzJOeRf1SktoA+ +naM8THLCV8Sg1Mw4J87VBp6iSNnpn86CcDaTmjvfliHjWbcM2pE38P1ZWrOZyGls +QyYBNWNgVYkDOnXYukrZVP/u3oDYLdE41V4tC5h9Pmzb/CaIxw== +-----END CERTIFICATE----- + +# Issuer: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc. +# Subject: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc. +# Label: "Go Daddy Root Certificate Authority - G2" +# Serial: 0 +# MD5 Fingerprint: 80:3a:bc:22:c1:e6:fb:8d:9b:3b:27:4a:32:1b:9a:01 +# SHA1 Fingerprint: 47:be:ab:c9:22:ea:e8:0e:78:78:34:62:a7:9f:45:c2:54:fd:e6:8b +# SHA256 Fingerprint: 45:14:0b:32:47:eb:9c:c8:c5:b4:f0:d7:b5:30:91:f7:32:92:08:9e:6e:5a:63:e2:74:9d:d3:ac:a9:19:8e:da +-----BEGIN CERTIFICATE----- +MIIDxTCCAq2gAwIBAgIBADANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMCVVMx +EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAYBgNVBAoT +EUdvRGFkZHkuY29tLCBJbmMuMTEwLwYDVQQDEyhHbyBEYWRkeSBSb290IENlcnRp +ZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAwMFoXDTM3MTIzMTIz +NTk1OVowgYMxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6b25hMRMwEQYDVQQH +EwpTY290dHNkYWxlMRowGAYDVQQKExFHb0RhZGR5LmNvbSwgSW5jLjExMC8GA1UE +AxMoR28gRGFkZHkgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIw +DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL9xYgjx+lk09xvJGKP3gElY6SKD +E6bFIEMBO4Tx5oVJnyfq9oQbTqC023CYxzIBsQU+B07u9PpPL1kwIuerGVZr4oAH +/PMWdYA5UXvl+TW2dE6pjYIT5LY/qQOD+qK+ihVqf94Lw7YZFAXK6sOoBJQ7Rnwy +DfMAZiLIjWltNowRGLfTshxgtDj6AozO091GB94KPutdfMh8+7ArU6SSYmlRJQVh +GkSBjCypQ5Yj36w6gZoOKcUcqeldHraenjAKOc7xiID7S13MMuyFYkMlNAJWJwGR +tDtwKj9useiciAF9n9T521NtYJ2/LOdYq7hfRvzOxBsDPAnrSTFcaUaz4EcCAwEA +AaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE +FDqahQcQZyi27/a9BUFuIMGU2g/eMA0GCSqGSIb3DQEBCwUAA4IBAQCZ21151fmX +WWcDYfF+OwYxdS2hII5PZYe096acvNjpL9DbWu7PdIxztDhC2gV7+AJ1uP2lsdeu +9tfeE8tTEH6KRtGX+rcuKxGrkLAngPnon1rpN5+r5N9ss4UXnT3ZJE95kTXWXwTr +gIOrmgIttRD02JDHBHNA7XIloKmf7J6raBKZV8aPEjoJpL1E/QYVN8Gb5DKj7Tjo +2GTzLH4U/ALqn83/B2gX2yKQOC16jdFU8WnjXzPKej17CuPKf1855eJ1usV2GDPO +LPAvTK33sefOT6jEm0pUBsV/fdUID+Ic/n4XuKxe9tQWskMJDE32p2u0mYRlynqI +4uJEvlz36hz1 +-----END CERTIFICATE----- + +# Issuer: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc. +# Subject: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc. +# Label: "Starfield Root Certificate Authority - G2" +# Serial: 0 +# MD5 Fingerprint: d6:39:81:c6:52:7e:96:69:fc:fc:ca:66:ed:05:f2:96 +# SHA1 Fingerprint: b5:1c:06:7c:ee:2b:0c:3d:f8:55:ab:2d:92:f4:fe:39:d4:e7:0f:0e +# SHA256 Fingerprint: 2c:e1:cb:0b:f9:d2:f9:e1:02:99:3f:be:21:51:52:c3:b2:dd:0c:ab:de:1c:68:e5:31:9b:83:91:54:db:b7:f5 +-----BEGIN CERTIFICATE----- +MIID3TCCAsWgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBjzELMAkGA1UEBhMCVVMx +EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT +HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAMTKVN0YXJmaWVs +ZCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAw +MFoXDTM3MTIzMTIzNTk1OVowgY8xCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6 +b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFyZmllbGQgVGVj +aG5vbG9naWVzLCBJbmMuMTIwMAYDVQQDEylTdGFyZmllbGQgUm9vdCBDZXJ0aWZp +Y2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC +ggEBAL3twQP89o/8ArFvW59I2Z154qK3A2FWGMNHttfKPTUuiUP3oWmb3ooa/RMg +nLRJdzIpVv257IzdIvpy3Cdhl+72WoTsbhm5iSzchFvVdPtrX8WJpRBSiUZV9Lh1 +HOZ/5FSuS/hVclcCGfgXcVnrHigHdMWdSL5stPSksPNkN3mSwOxGXn/hbVNMYq/N +Hwtjuzqd+/x5AJhhdM8mgkBj87JyahkNmcrUDnXMN/uLicFZ8WJ/X7NfZTD4p7dN +dloedl40wOiWVpmKs/B/pM293DIxfJHP4F8R+GuqSVzRmZTRouNjWwl2tVZi4Ut0 +HZbUJtQIBFnQmA4O5t78w+wfkPECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAO +BgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFHwMMh+n2TB/xH1oo2Kooc6rB1snMA0G +CSqGSIb3DQEBCwUAA4IBAQARWfolTwNvlJk7mh+ChTnUdgWUXuEok21iXQnCoKjU +sHU48TRqneSfioYmUeYs0cYtbpUgSpIB7LiKZ3sx4mcujJUDJi5DnUox9g61DLu3 +4jd/IroAow57UvtruzvE03lRTs2Q9GcHGcg8RnoNAX3FWOdt5oUwF5okxBDgBPfg +8n/Uqgr/Qh037ZTlZFkSIHc40zI+OIF1lnP6aI+xy84fxez6nH7PfrHxBy22/L/K +pL/QlwVKvOoYKAKQvVR4CSFx09F9HdkWsKlhPdAKACL8x3vLCWRFCztAgfd9fDL1 +mMpYjn0q7pBZc2T5NnReJaH1ZgUufzkVqSr7UIuOhWn0 +-----END CERTIFICATE----- + +# Issuer: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc. +# Subject: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc. +# Label: "Starfield Services Root Certificate Authority - G2" +# Serial: 0 +# MD5 Fingerprint: 17:35:74:af:7b:61:1c:eb:f4:f9:3c:e2:ee:40:f9:a2 +# SHA1 Fingerprint: 92:5a:8f:8d:2c:6d:04:e0:66:5f:59:6a:ff:22:d8:63:e8:25:6f:3f +# SHA256 Fingerprint: 56:8d:69:05:a2:c8:87:08:a4:b3:02:51:90:ed:cf:ed:b1:97:4a:60:6a:13:c6:e5:29:0f:cb:2a:e6:3e:da:b5 +-----BEGIN CERTIFICATE----- +MIID7zCCAtegAwIBAgIBADANBgkqhkiG9w0BAQsFADCBmDELMAkGA1UEBhMCVVMx +EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT +HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xOzA5BgNVBAMTMlN0YXJmaWVs +ZCBTZXJ2aWNlcyBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5 +MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgZgxCzAJBgNVBAYTAlVTMRAwDgYD +VQQIEwdBcml6b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFy +ZmllbGQgVGVjaG5vbG9naWVzLCBJbmMuMTswOQYDVQQDEzJTdGFyZmllbGQgU2Vy +dmljZXMgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZI +hvcNAQEBBQADggEPADCCAQoCggEBANUMOsQq+U7i9b4Zl1+OiFOxHz/Lz58gE20p +OsgPfTz3a3Y4Y9k2YKibXlwAgLIvWX/2h/klQ4bnaRtSmpDhcePYLQ1Ob/bISdm2 +8xpWriu2dBTrz/sm4xq6HZYuajtYlIlHVv8loJNwU4PahHQUw2eeBGg6345AWh1K +Ts9DkTvnVtYAcMtS7nt9rjrnvDH5RfbCYM8TWQIrgMw0R9+53pBlbQLPLJGmpufe +hRhJfGZOozptqbXuNC66DQO4M99H67FrjSXZm86B0UVGMpZwh94CDklDhbZsc7tk +6mFBrMnUVN+HL8cisibMn1lUaJ/8viovxFUcdUBgF4UCVTmLfwUCAwEAAaNCMEAw +DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJxfAN+q +AdcwKziIorhtSpzyEZGDMA0GCSqGSIb3DQEBCwUAA4IBAQBLNqaEd2ndOxmfZyMI +bw5hyf2E3F/YNoHN2BtBLZ9g3ccaaNnRbobhiCPPE95Dz+I0swSdHynVv/heyNXB +ve6SbzJ08pGCL72CQnqtKrcgfU28elUSwhXqvfdqlS5sdJ/PHLTyxQGjhdByPq1z +qwubdQxtRbeOlKyWN7Wg0I8VRw7j6IPdj/3vQQF3zCepYoUz8jcI73HPdwbeyBkd +iEDPfUYd/x7H4c7/I9vG+o1VTqkC50cRRj70/b17KSa7qWFiNyi2LSr2EIZkyXCn +0q23KXB56jzaYyWf/Wi3MOxw+3WKt21gZ7IeyLnp2KhvAotnDU0mV3HaIPzBSlCN +sSi6 +-----END CERTIFICATE----- + +# Issuer: CN=AffirmTrust Commercial O=AffirmTrust +# Subject: CN=AffirmTrust Commercial O=AffirmTrust +# Label: "AffirmTrust Commercial" +# Serial: 8608355977964138876 +# MD5 Fingerprint: 82:92:ba:5b:ef:cd:8a:6f:a6:3d:55:f9:84:f6:d6:b7 +# SHA1 Fingerprint: f9:b5:b6:32:45:5f:9c:be:ec:57:5f:80:dc:e9:6e:2c:c7:b2:78:b7 +# SHA256 Fingerprint: 03:76:ab:1d:54:c5:f9:80:3c:e4:b2:e2:01:a0:ee:7e:ef:7b:57:b6:36:e8:a9:3c:9b:8d:48:60:c9:6f:5f:a7 +-----BEGIN CERTIFICATE----- +MIIDTDCCAjSgAwIBAgIId3cGJyapsXwwDQYJKoZIhvcNAQELBQAwRDELMAkGA1UE +BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz +dCBDb21tZXJjaWFsMB4XDTEwMDEyOTE0MDYwNloXDTMwMTIzMTE0MDYwNlowRDEL +MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp +cm1UcnVzdCBDb21tZXJjaWFsMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC +AQEA9htPZwcroRX1BiLLHwGy43NFBkRJLLtJJRTWzsO3qyxPxkEylFf6EqdbDuKP +Hx6GGaeqtS25Xw2Kwq+FNXkyLbscYjfysVtKPcrNcV/pQr6U6Mje+SJIZMblq8Yr +ba0F8PrVC8+a5fBQpIs7R6UjW3p6+DM/uO+Zl+MgwdYoic+U+7lF7eNAFxHUdPAL +MeIrJmqbTFeurCA+ukV6BfO9m2kVrn1OIGPENXY6BwLJN/3HR+7o8XYdcxXyl6S1 +yHp52UKqK39c/s4mT6NmgTWvRLpUHhwwMmWd5jyTXlBOeuM61G7MGvv50jeuJCqr +VwMiKA1JdX+3KNp1v47j3A55MQIDAQABo0IwQDAdBgNVHQ4EFgQUnZPGU4teyq8/ +nx4P5ZmVvCT2lI8wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ +KoZIhvcNAQELBQADggEBAFis9AQOzcAN/wr91LoWXym9e2iZWEnStB03TX8nfUYG +XUPGhi4+c7ImfU+TqbbEKpqrIZcUsd6M06uJFdhrJNTxFq7YpFzUf1GO7RgBsZNj +vbz4YYCanrHOQnDiqX0GJX0nof5v7LMeJNrjS1UaADs1tDvZ110w/YETifLCBivt +Z8SOyUOyXGsViQK8YvxO8rUzqrJv0wqiUOP2O+guRMLbZjipM1ZI8W0bM40NjD9g +N53Tym1+NH4Nn3J2ixufcv1SNUFFApYvHLKac0khsUlHRUe072o0EclNmsxZt9YC +nlpOZbWUrhvfKbAW8b8Angc6F2S1BLUjIZkKlTuXfO8= +-----END CERTIFICATE----- + +# Issuer: CN=AffirmTrust Networking O=AffirmTrust +# Subject: CN=AffirmTrust Networking O=AffirmTrust +# Label: "AffirmTrust Networking" +# Serial: 8957382827206547757 +# MD5 Fingerprint: 42:65:ca:be:01:9a:9a:4c:a9:8c:41:49:cd:c0:d5:7f +# SHA1 Fingerprint: 29:36:21:02:8b:20:ed:02:f5:66:c5:32:d1:d6:ed:90:9f:45:00:2f +# SHA256 Fingerprint: 0a:81:ec:5a:92:97:77:f1:45:90:4a:f3:8d:5d:50:9f:66:b5:e2:c5:8f:cd:b5:31:05:8b:0e:17:f3:f0:b4:1b +-----BEGIN CERTIFICATE----- +MIIDTDCCAjSgAwIBAgIIfE8EORzUmS0wDQYJKoZIhvcNAQEFBQAwRDELMAkGA1UE +BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz +dCBOZXR3b3JraW5nMB4XDTEwMDEyOTE0MDgyNFoXDTMwMTIzMTE0MDgyNFowRDEL +MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp +cm1UcnVzdCBOZXR3b3JraW5nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC +AQEAtITMMxcua5Rsa2FSoOujz3mUTOWUgJnLVWREZY9nZOIG41w3SfYvm4SEHi3y +YJ0wTsyEheIszx6e/jarM3c1RNg1lho9Nuh6DtjVR6FqaYvZ/Ls6rnla1fTWcbua +kCNrmreIdIcMHl+5ni36q1Mr3Lt2PpNMCAiMHqIjHNRqrSK6mQEubWXLviRmVSRL +QESxG9fhwoXA3hA/Pe24/PHxI1Pcv2WXb9n5QHGNfb2V1M6+oF4nI979ptAmDgAp +6zxG8D1gvz9Q0twmQVGeFDdCBKNwV6gbh+0t+nvujArjqWaJGctB+d1ENmHP4ndG +yH329JKBNv3bNPFyfvMMFr20FQIDAQABo0IwQDAdBgNVHQ4EFgQUBx/S55zawm6i +QLSwelAQUHTEyL0wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ +KoZIhvcNAQEFBQADggEBAIlXshZ6qML91tmbmzTCnLQyFE2npN/svqe++EPbkTfO +tDIuUFUaNU52Q3Eg75N3ThVwLofDwR1t3Mu1J9QsVtFSUzpE0nPIxBsFZVpikpzu +QY0x2+c06lkh1QF612S4ZDnNye2v7UsDSKegmQGA3GWjNq5lWUhPgkvIZfFXHeVZ +Lgo/bNjR9eUJtGxUAArgFU2HdW23WJZa3W3SAKD0m0i+wzekujbgfIeFlxoVot4u +olu9rxj5kFDNcFn4J2dHy8egBzp90SxdbBk6ZrV9/ZFvgrG+CJPbFEfxojfHRZ48 +x3evZKiT3/Zpg4Jg8klCNO1aAFSFHBY2kgxc+qatv9s= +-----END CERTIFICATE----- + +# Issuer: CN=AffirmTrust Premium O=AffirmTrust +# Subject: CN=AffirmTrust Premium O=AffirmTrust +# Label: "AffirmTrust Premium" +# Serial: 7893706540734352110 +# MD5 Fingerprint: c4:5d:0e:48:b6:ac:28:30:4e:0a:bc:f9:38:16:87:57 +# SHA1 Fingerprint: d8:a6:33:2c:e0:03:6f:b1:85:f6:63:4f:7d:6a:06:65:26:32:28:27 +# SHA256 Fingerprint: 70:a7:3f:7f:37:6b:60:07:42:48:90:45:34:b1:14:82:d5:bf:0e:69:8e:cc:49:8d:f5:25:77:eb:f2:e9:3b:9a +-----BEGIN CERTIFICATE----- +MIIFRjCCAy6gAwIBAgIIbYwURrGmCu4wDQYJKoZIhvcNAQEMBQAwQTELMAkGA1UE +BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1UcnVz +dCBQcmVtaXVtMB4XDTEwMDEyOTE0MTAzNloXDTQwMTIzMTE0MTAzNlowQTELMAkG +A1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1U +cnVzdCBQcmVtaXVtMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxBLf +qV/+Qd3d9Z+K4/as4Tx4mrzY8H96oDMq3I0gW64tb+eT2TZwamjPjlGjhVtnBKAQ +JG9dKILBl1fYSCkTtuG+kU3fhQxTGJoeJKJPj/CihQvL9Cl/0qRY7iZNyaqoe5rZ ++jjeRFcV5fiMyNlI4g0WJx0eyIOFJbe6qlVBzAMiSy2RjYvmia9mx+n/K+k8rNrS +s8PhaJyJ+HoAVt70VZVs+7pk3WKL3wt3MutizCaam7uqYoNMtAZ6MMgpv+0GTZe5 +HMQxK9VfvFMSF5yZVylmd2EhMQcuJUmdGPLu8ytxjLW6OQdJd/zvLpKQBY0tL3d7 +70O/Nbua2Plzpyzy0FfuKE4mX4+QaAkvuPjcBukumj5Rp9EixAqnOEhss/n/fauG +V+O61oV4d7pD6kh/9ti+I20ev9E2bFhc8e6kGVQa9QPSdubhjL08s9NIS+LI+H+S +qHZGnEJlPqQewQcDWkYtuJfzt9WyVSHvutxMAJf7FJUnM7/oQ0dG0giZFmA7mn7S +5u046uwBHjxIVkkJx0w3AJ6IDsBz4W9m6XJHMD4Q5QsDyZpCAGzFlH5hxIrff4Ia +C1nEWTJ3s7xgaVY5/bQGeyzWZDbZvUjthB9+pSKPKrhC9IK31FOQeE4tGv2Bb0TX +OwF0lkLgAOIua+rF7nKsu7/+6qqo+Nz2snmKtmcCAwEAAaNCMEAwHQYDVR0OBBYE +FJ3AZ6YMItkm9UWrpmVSESfYRaxjMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/ +BAQDAgEGMA0GCSqGSIb3DQEBDAUAA4ICAQCzV00QYk465KzquByvMiPIs0laUZx2 +KI15qldGF9X1Uva3ROgIRL8YhNILgM3FEv0AVQVhh0HctSSePMTYyPtwni94loMg +Nt58D2kTiKV1NpgIpsbfrM7jWNa3Pt668+s0QNiigfV4Py/VpfzZotReBA4Xrf5B +8OWycvpEgjNC6C1Y91aMYj+6QrCcDFx+LmUmXFNPALJ4fqENmS2NuB2OosSw/WDQ +MKSOyARiqcTtNd56l+0OOF6SL5Nwpamcb6d9Ex1+xghIsV5n61EIJenmJWtSKZGc +0jlzCFfemQa0W50QBuHCAKi4HEoCChTQwUHK+4w1IX2COPKpVJEZNZOUbWo6xbLQ +u4mGk+ibyQ86p3q4ofB4Rvr8Ny/lioTz3/4E2aFooC8k4gmVBtWVyuEklut89pMF +u+1z6S3RdTnX5yTb2E5fQ4+e0BQ5v1VwSJlXMbSc7kqYA5YwH2AG7hsj/oFgIxpH +YoWlzBk0gG+zrBrjn/B7SK3VAdlntqlyk+otZrWyuOQ9PLLvTIzq6we/qzWaVYa8 +GKa1qF60g2xraUDTn9zxw2lrueFtCfTxqlB2Cnp9ehehVZZCmTEJ3WARjQUwfuaO +RtGdFNrHF+QFlozEJLUbzxQHskD4o55BhrwE0GuWyCqANP2/7waj3VjFhT0+j/6e +KeC2uAloGRwYQw== +-----END CERTIFICATE----- + +# Issuer: CN=AffirmTrust Premium ECC O=AffirmTrust +# Subject: CN=AffirmTrust Premium ECC O=AffirmTrust +# Label: "AffirmTrust Premium ECC" +# Serial: 8401224907861490260 +# MD5 Fingerprint: 64:b0:09:55:cf:b1:d5:99:e2:be:13:ab:a6:5d:ea:4d +# SHA1 Fingerprint: b8:23:6b:00:2f:1d:16:86:53:01:55:6c:11:a4:37:ca:eb:ff:c3:bb +# SHA256 Fingerprint: bd:71:fd:f6:da:97:e4:cf:62:d1:64:7a:dd:25:81:b0:7d:79:ad:f8:39:7e:b4:ec:ba:9c:5e:84:88:82:14:23 +-----BEGIN CERTIFICATE----- +MIIB/jCCAYWgAwIBAgIIdJclisc/elQwCgYIKoZIzj0EAwMwRTELMAkGA1UEBhMC +VVMxFDASBgNVBAoMC0FmZmlybVRydXN0MSAwHgYDVQQDDBdBZmZpcm1UcnVzdCBQ +cmVtaXVtIEVDQzAeFw0xMDAxMjkxNDIwMjRaFw00MDEyMzExNDIwMjRaMEUxCzAJ +BgNVBAYTAlVTMRQwEgYDVQQKDAtBZmZpcm1UcnVzdDEgMB4GA1UEAwwXQWZmaXJt +VHJ1c3QgUHJlbWl1bSBFQ0MwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQNMF4bFZ0D +0KF5Nbc6PJJ6yhUczWLznCZcBz3lVPqj1swS6vQUX+iOGasvLkjmrBhDeKzQN8O9 +ss0s5kfiGuZjuD0uL3jET9v0D6RoTFVya5UdThhClXjMNzyR4ptlKymjQjBAMB0G +A1UdDgQWBBSaryl6wBE1NSZRMADDav5A1a7WPDAPBgNVHRMBAf8EBTADAQH/MA4G +A1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNnADBkAjAXCfOHiFBar8jAQr9HX/Vs +aobgxCd05DhT1wV/GzTjxi+zygk8N53X57hG8f2h4nECMEJZh0PUUd+60wkyWs6I +flc9nF9Ca/UHLbXwgpP5WW+uZPpY5Yse42O+tYHNbwKMeQ== +-----END CERTIFICATE----- + +# Issuer: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority +# Subject: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority +# Label: "Certum Trusted Network CA" +# Serial: 279744 +# MD5 Fingerprint: d5:e9:81:40:c5:18:69:fc:46:2c:89:75:62:0f:aa:78 +# SHA1 Fingerprint: 07:e0:32:e0:20:b7:2c:3f:19:2f:06:28:a2:59:3a:19:a7:0f:06:9e +# SHA256 Fingerprint: 5c:58:46:8d:55:f5:8e:49:7e:74:39:82:d2:b5:00:10:b6:d1:65:37:4a:cf:83:a7:d4:a3:2d:b7:68:c4:40:8e +-----BEGIN CERTIFICATE----- +MIIDuzCCAqOgAwIBAgIDBETAMA0GCSqGSIb3DQEBBQUAMH4xCzAJBgNVBAYTAlBM +MSIwIAYDVQQKExlVbml6ZXRvIFRlY2hub2xvZ2llcyBTLkEuMScwJQYDVQQLEx5D +ZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxIjAgBgNVBAMTGUNlcnR1bSBU +cnVzdGVkIE5ldHdvcmsgQ0EwHhcNMDgxMDIyMTIwNzM3WhcNMjkxMjMxMTIwNzM3 +WjB+MQswCQYDVQQGEwJQTDEiMCAGA1UEChMZVW5pemV0byBUZWNobm9sb2dpZXMg +Uy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MSIw +IAYDVQQDExlDZXJ0dW0gVHJ1c3RlZCBOZXR3b3JrIENBMIIBIjANBgkqhkiG9w0B +AQEFAAOCAQ8AMIIBCgKCAQEA4/t9o3K6wvDJFIf1awFO4W5AB7ptJ11/91sts1rH +UV+rpDKmYYe2bg+G0jACl/jXaVehGDldamR5xgFZrDwxSjh80gTSSyjoIF87B6LM +TXPb865Px1bVWqeWifrzq2jUI4ZZJ88JJ7ysbnKDHDBy3+Ci6dLhdHUZvSqeexVU +BBvXQzmtVSjF4hq79MDkrjhJM8x2hZ85RdKknvISjFH4fOQtf/WsX+sWn7Et0brM +kUJ3TCXJkDhv2/DM+44el1k+1WBO5gUo7Ul5E0u6SNsv+XLTOcr+H9g0cvW0QM8x +AcPs3hEtF10fuFDRXhmnad4HMyjKUJX5p1TLVIZQRan5SQIDAQABo0IwQDAPBgNV +HRMBAf8EBTADAQH/MB0GA1UdDgQWBBQIds3LB/8k9sXN7buQvOKEN0Z19zAOBgNV +HQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQEFBQADggEBAKaorSLOAT2mo/9i0Eidi15y +sHhE49wcrwn9I0j6vSrEuVUEtRCjjSfeC4Jj0O7eDDd5QVsisrCaQVymcODU0HfL +I9MA4GxWL+FpDQ3Zqr8hgVDZBqWo/5U30Kr+4rP1mS1FhIrlQgnXdAIv94nYmem8 +J9RHjboNRhx3zxSkHLmkMcScKHQDNP8zGSal6Q10tz6XxnboJ5ajZt3hrvJBW8qY +VoNzcOSGGtIxQbovvi0TWnZvTuhOgQ4/WwMioBK+ZlgRSssDxLQqKi2WF+A5VLxI +03YnnZotBqbJ7DnSq9ufmgsnAjUpsUCV5/nonFWIGUbWtzT1fs45mtk48VH3Tyw= +-----END CERTIFICATE----- + +# Issuer: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA +# Subject: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA +# Label: "TWCA Root Certification Authority" +# Serial: 1 +# MD5 Fingerprint: aa:08:8f:f6:f9:7b:b7:f2:b1:a7:1e:9b:ea:ea:bd:79 +# SHA1 Fingerprint: cf:9e:87:6d:d3:eb:fc:42:26:97:a3:b5:a3:7a:a0:76:a9:06:23:48 +# SHA256 Fingerprint: bf:d8:8f:e1:10:1c:41:ae:3e:80:1b:f8:be:56:35:0e:e9:ba:d1:a6:b9:bd:51:5e:dc:5c:6d:5b:87:11:ac:44 +-----BEGIN CERTIFICATE----- +MIIDezCCAmOgAwIBAgIBATANBgkqhkiG9w0BAQUFADBfMQswCQYDVQQGEwJUVzES +MBAGA1UECgwJVEFJV0FOLUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFU +V0NBIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwODI4MDcyNDMz +WhcNMzAxMjMxMTU1OTU5WjBfMQswCQYDVQQGEwJUVzESMBAGA1UECgwJVEFJV0FO +LUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFUV0NBIFJvb3QgQ2VydGlm +aWNhdGlvbiBBdXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB +AQCwfnK4pAOU5qfeCTiRShFAh6d8WWQUe7UREN3+v9XAu1bihSX0NXIP+FPQQeFE +AcK0HMMxQhZHhTMidrIKbw/lJVBPhYa+v5guEGcevhEFhgWQxFnQfHgQsIBct+HH +K3XLfJ+utdGdIzdjp9xCoi2SBBtQwXu4PhvJVgSLL1KbralW6cH/ralYhzC2gfeX +RfwZVzsrb+RH9JlF/h3x+JejiB03HFyP4HYlmlD4oFT/RJB2I9IyxsOrBr/8+7/z +rX2SYgJbKdM1o5OaQ2RgXbL6Mv87BK9NQGr5x+PvI/1ry+UPizgN7gr8/g+YnzAx +3WxSZfmLgb4i4RxYA7qRG4kHAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV +HRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqOFsmjd6LWvJPelSDGRjjCDWmujANBgkq +hkiG9w0BAQUFAAOCAQEAPNV3PdrfibqHDAhUaiBQkr6wQT25JmSDCi/oQMCXKCeC +MErJk/9q56YAf4lCmtYR5VPOL8zy2gXE/uJQxDqGfczafhAJO5I1KlOy/usrBdls +XebQ79NqZp4VKIV66IIArB6nCWlWQtNoURi+VJq/REG6Sb4gumlc7rh3zc5sH62D +lhh9DrUUOYTxKOkto557HnpyWoOzeW/vtPzQCqVYT0bf+215WfKEIlKuD8z7fDvn +aspHYcN6+NOSBB+4IIThNlQWx0DeO4pz3N/GCUzf7Nr/1FNCocnyYh0igzyXxfkZ +YiesZSLX0zzG5Y6yU8xJzrww/nsOM5D77dIUkR8Hrw== +-----END CERTIFICATE----- + +# Issuer: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2 +# Subject: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2 +# Label: "Security Communication RootCA2" +# Serial: 0 +# MD5 Fingerprint: 6c:39:7d:a4:0e:55:59:b2:3f:d6:41:b1:12:50:de:43 +# SHA1 Fingerprint: 5f:3b:8c:f2:f8:10:b3:7d:78:b4:ce:ec:19:19:c3:73:34:b9:c7:74 +# SHA256 Fingerprint: 51:3b:2c:ec:b8:10:d4:cd:e5:dd:85:39:1a:df:c6:c2:dd:60:d8:7b:b7:36:d2:b5:21:48:4a:a4:7a:0e:be:f6 +-----BEGIN CERTIFICATE----- +MIIDdzCCAl+gAwIBAgIBADANBgkqhkiG9w0BAQsFADBdMQswCQYDVQQGEwJKUDEl +MCMGA1UEChMcU0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UECxMe +U2VjdXJpdHkgQ29tbXVuaWNhdGlvbiBSb290Q0EyMB4XDTA5MDUyOTA1MDAzOVoX +DTI5MDUyOTA1MDAzOVowXTELMAkGA1UEBhMCSlAxJTAjBgNVBAoTHFNFQ09NIFRy +dXN0IFN5c3RlbXMgQ08uLExURC4xJzAlBgNVBAsTHlNlY3VyaXR5IENvbW11bmlj +YXRpb24gUm9vdENBMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANAV +OVKxUrO6xVmCxF1SrjpDZYBLx/KWvNs2l9amZIyoXvDjChz335c9S672XewhtUGr +zbl+dp+++T42NKA7wfYxEUV0kz1XgMX5iZnK5atq1LXaQZAQwdbWQonCv/Q4EpVM +VAX3NuRFg3sUZdbcDE3R3n4MqzvEFb46VqZab3ZpUql6ucjrappdUtAtCms1FgkQ +hNBqyjoGADdH5H5XTz+L62e4iKrFvlNVspHEfbmwhRkGeC7bYRr6hfVKkaHnFtWO +ojnflLhwHyg/i/xAXmODPIMqGplrz95Zajv8bxbXH/1KEOtOghY6rCcMU/Gt1SSw +awNQwS08Ft1ENCcadfsCAwEAAaNCMEAwHQYDVR0OBBYEFAqFqXdlBZh8QIH4D5cs +OPEK7DzPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3 +DQEBCwUAA4IBAQBMOqNErLlFsceTfsgLCkLfZOoc7llsCLqJX2rKSpWeeo8HxdpF +coJxDjrSzG+ntKEju/Ykn8sX/oymzsLS28yN/HH8AynBbF0zX2S2ZTuJbxh2ePXc +okgfGT+Ok+vx+hfuzU7jBBJV1uXk3fs+BXziHV7Gp7yXT2g69ekuCkO2r1dcYmh8 +t/2jioSgrGK+KwmHNPBqAbubKVY8/gA3zyNs8U6qtnRGEmyR7jTV7JqR50S+kDFy +1UkC9gLl9B/rfNmWVan/7Ir5mUf/NVoCqgTLiluHcSmRvaS0eg29mvVXIwAHIRc/ +SjnRBUkLp7Y3gaVdjKozXoEofKd9J+sAro03 +-----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" +# Serial: 6271844772424770508 +# MD5 Fingerprint: 69:c1:0d:4f:07:a3:1b:c3:fe:56:3d:04:bc:11:f6:a6 +# SHA1 Fingerprint: f3:73:b3:87:06:5a:28:84:8a:f2:f3:4a:ce:19:2b:dd:c7:8e:9c:ac +# SHA256 Fingerprint: 55:92:60:84:ec:96:3a:64:b9:6e:2a:be:01:ce:0b:a8:6a:64:fb:fe:bc:c7:aa:b5:af:c1:55:b3:7f:d7:60:66 +-----BEGIN CERTIFICATE----- +MIIFuzCCA6OgAwIBAgIIVwoRl0LE48wwDQYJKoZIhvcNAQELBQAwazELMAkGA1UE +BhMCSVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8w +MzM1ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290 +IENBMB4XDTExMDkyMjExMjIwMloXDTMwMDkyMjExMjIwMlowazELMAkGA1UEBhMC +SVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8wMzM1 +ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290IENB +MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAp8bEpSmkLO/lGMWwUKNv +UTufClrJwkg4CsIcoBh/kbWHuUA/3R1oHwiD1S0eiKD4j1aPbZkCkpAW1V8IbInX +4ay8IMKx4INRimlNAJZaby/ARH6jDuSRzVju3PvHHkVH3Se5CAGfpiEd9UEtL0z9 +KK3giq0itFZljoZUj5NDKd45RnijMCO6zfB9E1fAXdKDa0hMxKufgFpbOr3JpyI/ +gCczWw63igxdBzcIy2zSekciRDXFzMwujt0q7bd9Zg1fYVEiVRvjRuPjPdA1Yprb +rxTIW6HMiRvhMCb8oJsfgadHHwTrozmSBp+Z07/T6k9QnBn+locePGX2oxgkg4YQ +51Q+qDp2JE+BIcXjDwL4k5RHILv+1A7TaLndxHqEguNTVHnd25zS8gebLra8Pu2F +be8lEfKXGkJh90qX6IuxEAf6ZYGyojnP9zz/GPvG8VqLWeICrHuS0E4UT1lF9gxe +KF+w6D9Fz8+vm2/7hNN3WpVvrJSEnu68wEqPSpP4RCHiMUVhUE4Q2OM1fEwZtN4F +v6MGn8i1zeQf1xcGDXqVdFUNaBr8EBtiZJ1t4JWgw5QHVw0U5r0F+7if5t+L4sbn +fpb2U8WANFAoWPASUHEXMLrmeGO89LKtmyuy/uE5jF66CyCU3nuDuP/jVo23Eek7 +jPKxwV2dpAtMK9myGPW1n0sCAwEAAaNjMGEwHQYDVR0OBBYEFFLYiDrIn3hm7Ynz +ezhwlMkCAjbQMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUUtiIOsifeGbt +ifN7OHCUyQICNtAwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQAL +e3KHwGCmSUyIWOYdiPcUZEim2FgKDk8TNd81HdTtBjHIgT5q1d07GjLukD0R0i70 +jsNjLiNmsGe+b7bAEzlgqqI0JZN1Ut6nna0Oh4lScWoWPBkdg/iaKWW+9D+a2fDz +WochcYBNy+A4mz+7+uAwTc+G02UQGRjRlwKxK3JCaKygvU5a2hi/a5iB0P2avl4V +SM0RFbnAKVy06Ij3Pjaut2L9HmLecHgQHEhb2rykOLpn7VU+Xlff1ANATIGk0k9j +pwlCCRT8AKnCgHNPLsBA2RF7SOp6AsDT6ygBJlh0wcBzIm2Tlf05fbsq4/aC4yyX +X04fkZT6/iyj2HYauE2yOE+b+h1IYHkm4vP9qdCa6HCPSXrW5b0KDtst842/6+Ok +fcvHlXHo2qN8xcL4dJIEG4aspCJTQLas/kx2z/uUMsA1n3Y/buWQbqCmJqK4LL7R +K4X9p2jIugErsWx0Hbhzlefut8cl8ABMALJ+tguLHPPAUJ4lueAI3jZm/zel0btU +ZCzJJ7VLkn5l/9Mt4blOvH+kQSGQQXemOR/qnuOf0GZvBeyqdn6/axag67XH/JJU +LysRJyU3eExRarDzzFhdFPFqSBX/wge2sY0PjlxQRrM9vwGYT7JZVEc+NHt4bVaT +LnPqZih4zR0Uv6CPLy64Lo7yFIrM6bV8+2ydDKXhlg== +-----END CERTIFICATE----- + +# Issuer: CN=Buypass Class 2 Root CA O=Buypass AS-983163327 +# Subject: CN=Buypass Class 2 Root CA O=Buypass AS-983163327 +# Label: "Buypass Class 2 Root CA" +# Serial: 2 +# MD5 Fingerprint: 46:a7:d2:fe:45:fb:64:5a:a8:59:90:9b:78:44:9b:29 +# SHA1 Fingerprint: 49:0a:75:74:de:87:0a:47:fe:58:ee:f6:c7:6b:eb:c6:0b:12:40:99 +# SHA256 Fingerprint: 9a:11:40:25:19:7c:5b:b9:5d:94:e6:3d:55:cd:43:79:08:47:b6:46:b2:3c:df:11:ad:a4:a0:0e:ff:15:fb:48 +-----BEGIN CERTIFICATE----- +MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd +MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg +Q2xhc3MgMiBSb290IENBMB4XDTEwMTAyNjA4MzgwM1oXDTQwMTAyNjA4MzgwM1ow +TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw +HgYDVQQDDBdCdXlwYXNzIENsYXNzIDIgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB +BQADggIPADCCAgoCggIBANfHXvfBB9R3+0Mh9PT1aeTuMgHbo4Yf5FkNuud1g1Lr +6hxhFUi7HQfKjK6w3Jad6sNgkoaCKHOcVgb/S2TwDCo3SbXlzwx87vFKu3MwZfPV +L4O2fuPn9Z6rYPnT8Z2SdIrkHJasW4DptfQxh6NR/Md+oW+OU3fUl8FVM5I+GC91 +1K2GScuVr1QGbNgGE41b/+EmGVnAJLqBcXmQRFBoJJRfuLMR8SlBYaNByyM21cHx +MlAQTn/0hpPshNOOvEu/XAFOBz3cFIqUCqTqc/sLUegTBxj6DvEr0VQVfTzh97QZ +QmdiXnfgolXsttlpF9U6r0TtSsWe5HonfOV116rLJeffawrbD02TTqigzXsu8lkB +arcNuAeBfos4GzjmCleZPe4h6KP1DBbdi+w0jpwqHAAVF41og9JwnxgIzRFo1clr +Us3ERo/ctfPYV3Me6ZQ5BL/T3jjetFPsaRyifsSP5BtwrfKi+fv3FmRmaZ9JUaLi +FRhnBkp/1Wy1TbMz4GHrXb7pmA8y1x1LPC5aAVKRCfLf6o3YBkBjqhHk/sM3nhRS +P/TizPJhk9H9Z2vXUq6/aKtAQ6BXNVN48FP4YUIHZMbXb5tMOA1jrGKvNouicwoN +9SG9dKpN6nIDSdvHXx1iY8f93ZHsM+71bbRuMGjeyNYmsHVee7QHIJihdjK4TWxP +AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMmAd+BikoL1Rpzz +uvdMw964o605MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAU18h +9bqwOlI5LJKwbADJ784g7wbylp7ppHR/ehb8t/W2+xUbP6umwHJdELFx7rxP462s +A20ucS6vxOOto70MEae0/0qyexAQH6dXQbLArvQsWdZHEIjzIVEpMMpghq9Gqx3t +OluwlN5E40EIosHsHdb9T7bWR9AUC8rmyrV7d35BH16Dx7aMOZawP5aBQW9gkOLo ++fsicdl9sz1Gv7SEr5AcD48Saq/v7h56rgJKihcrdv6sVIkkLE8/trKnToyokZf7 +KcZ7XC25y2a2t6hbElGFtQl+Ynhw/qlqYLYdDnkM/crqJIByw5c/8nerQyIKx+u2 +DISCLIBrQYoIwOula9+ZEsuK1V6ADJHgJgg2SMX6OBE1/yWDLfJ6v9r9jv6ly0Us +H8SIU653DtmadsWOLB2jutXsMq7Aqqz30XpN69QH4kj3Io6wpJ9qzo6ysmD0oyLQ +I+uUWnpp3Q+/QFesa1lQ2aOZ4W7+jQF5JyMV3pKdewlNWudLSDBaGOYKbeaP4NK7 +5t98biGCwWg5TbSYWGZizEqQXsP6JwSxeRV0mcy+rSDeJmAc61ZRpqPq5KM/p/9h +3PFaTWwyI0PurKju7koSCTxdccK+efrCh2gdC/1cacwG0Jp9VJkqyTkaGa9LKkPz +Y11aWOIv4x3kqdbQCtCev9eBCfHJxyYNrJgWVqA= +-----END CERTIFICATE----- + +# Issuer: CN=Buypass Class 3 Root CA O=Buypass AS-983163327 +# Subject: CN=Buypass Class 3 Root CA O=Buypass AS-983163327 +# Label: "Buypass Class 3 Root CA" +# Serial: 2 +# MD5 Fingerprint: 3d:3b:18:9e:2c:64:5a:e8:d5:88:ce:0e:f9:37:c2:ec +# SHA1 Fingerprint: da:fa:f7:fa:66:84:ec:06:8f:14:50:bd:c7:c2:81:a5:bc:a9:64:57 +# SHA256 Fingerprint: ed:f7:eb:bc:a2:7a:2a:38:4d:38:7b:7d:40:10:c6:66:e2:ed:b4:84:3e:4c:29:b4:ae:1d:5b:93:32:e6:b2:4d +-----BEGIN CERTIFICATE----- +MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd +MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg +Q2xhc3MgMyBSb290IENBMB4XDTEwMTAyNjA4Mjg1OFoXDTQwMTAyNjA4Mjg1OFow +TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw +HgYDVQQDDBdCdXlwYXNzIENsYXNzIDMgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB +BQADggIPADCCAgoCggIBAKXaCpUWUOOV8l6ddjEGMnqb8RB2uACatVI2zSRHsJ8Y +ZLya9vrVediQYkwiL944PdbgqOkcLNt4EemOaFEVcsfzM4fkoF0LXOBXByow9c3E +N3coTRiR5r/VUv1xLXA+58bEiuPwKAv0dpihi4dVsjoT/Lc+JzeOIuOoTyrvYLs9 +tznDDgFHmV0ST9tD+leh7fmdvhFHJlsTmKtdFoqwNxxXnUX/iJY2v7vKB3tvh2PX +0DJq1l1sDPGzbjniazEuOQAnFN44wOwZZoYS6J1yFhNkUsepNxz9gjDthBgd9K5c +/3ATAOux9TN6S9ZV+AWNS2mw9bMoNlwUxFFzTWsL8TQH2xc519woe2v1n/MuwU8X +KhDzzMro6/1rqy6any2CbgTUUgGTLT2G/H783+9CHaZr77kgxve9oKeV/afmiSTY +zIw0bOIjL9kSGiG5VZFvC5F5GQytQIgLcOJ60g7YaEi7ghM5EFjp2CoHxhLbWNvS +O1UQRwUVZ2J+GGOmRj8JDlQyXr8NYnon74Do29lLBlo3WiXQCBJ31G8JUJc9yB3D +34xFMFbG02SrZvPAXpacw8Tvw3xrizp5f7NJzz3iiZ+gMEuFuZyUJHmPfWupRWgP +K9Dx2hzLabjKSWJtyNBjYt1gD1iqj6G8BaVmos8bdrKEZLFMOVLAMLrwjEsCsLa3 +AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFEe4zf/lb+74suwv +Tg75JbCOPGvDMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAACAj +QTUEkMJAYmDv4jVM1z+s4jSQuKFvdvoWFqRINyzpkMLyPPgKn9iB5btb2iUspKdV +cSQy9sgL8rxq+JOssgfCX5/bzMiKqr5qb+FJEMwx14C7u8jYog5kV+qi9cKpMRXS +IGrs/CIBKM+GuIAeqcwRpTzyFrNHnfzSgCHEy9BHcEGhyoMZCCxt8l13nIoUE9Q2 +HJLw5QY33KbmkJs4j1xrG0aGQ0JfPgEHU1RdZX33inOhmlRaHylDFCfChQ+1iHsa +O5S3HWCntZznKWlXWpuTekMwGwPXYshApqr8ZORK15FTAaggiG6cX0S5y2CBNOxv +033aSF/rtJC8LakcC6wc1aJoIIAE1vyxjy+7SjENSoYc6+I2KSb12tjE8nVhz36u +dmNKekBlk4f4HoCMhuWG1o8O/FMsYOgWYRqiPkN7zTlgVGr18okmAWiDSKIz6MkE +kbIRNBE+6tBDGR8Dk5AM/1E9V/RBbuHLoL7ryWPNbczk+DaqaJ3tvV2XcEQNtg41 +3OEMXbugUZTLfhbrES+jkkXITHHZvMmZUldGL1DPvTVp9D0VzgalLA8+9oG6lLvD +u79leNKGef9JOxqDDPDeeOzI8k1MGt6CKfjBWtrt7uYnXuhF0J0cUahoq0Tj0Itq +4/g7u9xN12TyUb7mqqta6THuBrxzvxNiCp/HuZc= +-----END CERTIFICATE----- + +# Issuer: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center +# Subject: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center +# Label: "T-TeleSec GlobalRoot Class 3" +# Serial: 1 +# MD5 Fingerprint: ca:fb:40:a8:4e:39:92:8a:1d:fe:8e:2f:c4:27:ea:ef +# SHA1 Fingerprint: 55:a6:72:3e:cb:f2:ec:cd:c3:23:74:70:19:9d:2a:be:11:e3:81:d1 +# SHA256 Fingerprint: fd:73:da:d3:1c:64:4f:f1:b4:3b:ef:0c:cd:da:96:71:0b:9c:d9:87:5e:ca:7e:31:70:7a:f3:e9:6d:52:2b:bd +-----BEGIN CERTIFICATE----- +MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx +KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd +BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl +YyBHbG9iYWxSb290IENsYXNzIDMwHhcNMDgxMDAxMTAyOTU2WhcNMzMxMDAxMjM1 +OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy +aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50 +ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDMwggEiMA0G +CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC9dZPwYiJvJK7genasfb3ZJNW4t/zN +8ELg63iIVl6bmlQdTQyK9tPPcPRStdiTBONGhnFBSivwKixVA9ZIw+A5OO3yXDw/ +RLyTPWGrTs0NvvAgJ1gORH8EGoel15YUNpDQSXuhdfsaa3Ox+M6pCSzyU9XDFES4 +hqX2iys52qMzVNn6chr3IhUciJFrf2blw2qAsCTz34ZFiP0Zf3WHHx+xGwpzJFu5 +ZeAsVMhg02YXP+HMVDNzkQI6pn97djmiH5a2OK61yJN0HZ65tOVgnS9W0eDrXltM +EnAMbEQgqxHY9Bn20pxSN+f6tsIxO0rUFJmtxxr1XV/6B7h8DR/Wgx6zAgMBAAGj +QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS1 +A/d2O2GCahKqGFPrAyGUv/7OyjANBgkqhkiG9w0BAQsFAAOCAQEAVj3vlNW92nOy +WL6ukK2YJ5f+AbGwUgC4TeQbIXQbfsDuXmkqJa9c1h3a0nnJ85cp4IaH3gRZD/FZ +1GSFS5mvJQQeyUapl96Cshtwn5z2r3Ex3XsFpSzTucpH9sry9uetuUg/vBa3wW30 +6gmv7PO15wWeph6KU1HWk4HMdJP2udqmJQV0eVp+QD6CSyYRMG7hP0HHRwA11fXT +91Q+gT3aSWqas+8QPebrb9HIIkfLzM8BMZLZGOMivgkeGj5asuRrDFR6fUNOuIml +e9eiPZaGzPImNC1qkp2aGtAw4l1OBLBfiyB+d8E9lYLRRpo7PHi4b6HQDWSieB4p +TpPDpFQUWw== +-----END CERTIFICATE----- + +# Issuer: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH +# Subject: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH +# Label: "D-TRUST Root Class 3 CA 2 2009" +# Serial: 623603 +# MD5 Fingerprint: cd:e0:25:69:8d:47:ac:9c:89:35:90:f7:fd:51:3d:2f +# SHA1 Fingerprint: 58:e8:ab:b0:36:15:33:fb:80:f7:9b:1b:6d:29:d3:ff:8d:5f:00:f0 +# SHA256 Fingerprint: 49:e7:a4:42:ac:f0:ea:62:87:05:00:54:b5:25:64:b6:50:e4:f4:9e:42:e3:48:d6:aa:38:e0:39:e9:57:b1:c1 +-----BEGIN CERTIFICATE----- +MIIEMzCCAxugAwIBAgIDCYPzMA0GCSqGSIb3DQEBCwUAME0xCzAJBgNVBAYTAkRF +MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMMHkQtVFJVU1QgUm9vdCBD +bGFzcyAzIENBIDIgMjAwOTAeFw0wOTExMDUwODM1NThaFw0yOTExMDUwODM1NTha +ME0xCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMM +HkQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgMjAwOTCCASIwDQYJKoZIhvcNAQEB +BQADggEPADCCAQoCggEBANOySs96R+91myP6Oi/WUEWJNTrGa9v+2wBoqOADER03 +UAifTUpolDWzU9GUY6cgVq/eUXjsKj3zSEhQPgrfRlWLJ23DEE0NkVJD2IfgXU42 +tSHKXzlABF9bfsyjxiupQB7ZNoTWSPOSHjRGICTBpFGOShrvUD9pXRl/RcPHAY9R +ySPocq60vFYJfxLLHLGvKZAKyVXMD9O0Gu1HNVpK7ZxzBCHQqr0ME7UAyiZsxGsM +lFqVlNpQmvH/pStmMaTJOKDfHR+4CS7zp+hnUquVH+BGPtikw8paxTGA6Eian5Rp +/hnd2HN8gcqW3o7tszIFZYQ05ub9VxC1X3a/L7AQDcUCAwEAAaOCARowggEWMA8G +A1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFP3aFMSfMN4hvR5COfyrYyNJ4PGEMA4G +A1UdDwEB/wQEAwIBBjCB0wYDVR0fBIHLMIHIMIGAoH6gfIZ6bGRhcDovL2RpcmVj +dG9yeS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwUm9vdCUyMENsYXNzJTIwMyUy +MENBJTIwMiUyMDIwMDksTz1ELVRydXN0JTIwR21iSCxDPURFP2NlcnRpZmljYXRl +cmV2b2NhdGlvbmxpc3QwQ6BBoD+GPWh0dHA6Ly93d3cuZC10cnVzdC5uZXQvY3Js +L2QtdHJ1c3Rfcm9vdF9jbGFzc18zX2NhXzJfMjAwOS5jcmwwDQYJKoZIhvcNAQEL +BQADggEBAH+X2zDI36ScfSF6gHDOFBJpiBSVYEQBrLLpME+bUMJm2H6NMLVwMeni +acfzcNsgFYbQDfC+rAF1hM5+n02/t2A7nPPKHeJeaNijnZflQGDSNiH+0LS4F9p0 +o3/U37CYAqxva2ssJSRyoWXuJVrl5jLn8t+rSfrzkGkj2wTZ51xY/GXUl77M/C4K +zCUqNQT4YJEVdT1B/yMfGchs64JTBKbkTCJNjYy6zltz7GRUUG3RnFX7acM2w4y8 +PIWmawomDeCTmGCufsYkl4phX5GOZpIJhzbNi5stPvZR1FDUWSi9g/LMKHtThm3Y +Johw1+qRzT65ysCQblrGXnRl11z+o+I= +-----END CERTIFICATE----- + +# Issuer: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH +# Subject: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH +# Label: "D-TRUST Root Class 3 CA 2 EV 2009" +# Serial: 623604 +# MD5 Fingerprint: aa:c6:43:2c:5e:2d:cd:c4:34:c0:50:4f:11:02:4f:b6 +# SHA1 Fingerprint: 96:c9:1b:0b:95:b4:10:98:42:fa:d0:d8:22:79:fe:60:fa:b9:16:83 +# SHA256 Fingerprint: ee:c5:49:6b:98:8c:e9:86:25:b9:34:09:2e:ec:29:08:be:d0:b0:f3:16:c2:d4:73:0c:84:ea:f1:f3:d3:48:81 +-----BEGIN CERTIFICATE----- +MIIEQzCCAyugAwIBAgIDCYP0MA0GCSqGSIb3DQEBCwUAMFAxCzAJBgNVBAYTAkRF +MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNVBAMMIUQtVFJVU1QgUm9vdCBD +bGFzcyAzIENBIDIgRVYgMjAwOTAeFw0wOTExMDUwODUwNDZaFw0yOTExMDUwODUw +NDZaMFAxCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNV +BAMMIUQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgRVYgMjAwOTCCASIwDQYJKoZI +hvcNAQEBBQADggEPADCCAQoCggEBAJnxhDRwui+3MKCOvXwEz75ivJn9gpfSegpn +ljgJ9hBOlSJzmY3aFS3nBfwZcyK3jpgAvDw9rKFs+9Z5JUut8Mxk2og+KbgPCdM0 +3TP1YtHhzRnp7hhPTFiu4h7WDFsVWtg6uMQYZB7jM7K1iXdODL/ZlGsTl28So/6Z +qQTMFexgaDbtCHu39b+T7WYxg4zGcTSHThfqr4uRjRxWQa4iN1438h3Z0S0NL2lR +p75mpoo6Kr3HGrHhFPC+Oh25z1uxav60sUYgovseO3Dvk5h9jHOW8sXvhXCtKSb8 +HgQ+HKDYD8tSg2J87otTlZCpV6LqYQXY+U3EJ/pure3511H3a6UCAwEAAaOCASQw +ggEgMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFNOUikxiEyoZLsyvcop9Ntea +HNxnMA4GA1UdDwEB/wQEAwIBBjCB3QYDVR0fBIHVMIHSMIGHoIGEoIGBhn9sZGFw +Oi8vZGlyZWN0b3J5LmQtdHJ1c3QubmV0L0NOPUQtVFJVU1QlMjBSb290JTIwQ2xh +c3MlMjAzJTIwQ0ElMjAyJTIwRVYlMjAyMDA5LE89RC1UcnVzdCUyMEdtYkgsQz1E +RT9jZXJ0aWZpY2F0ZXJldm9jYXRpb25saXN0MEagRKBChkBodHRwOi8vd3d3LmQt +dHJ1c3QubmV0L2NybC9kLXRydXN0X3Jvb3RfY2xhc3NfM19jYV8yX2V2XzIwMDku +Y3JsMA0GCSqGSIb3DQEBCwUAA4IBAQA07XtaPKSUiO8aEXUHL7P+PPoeUSbrh/Yp +3uDx1MYkCenBz1UbtDDZzhr+BlGmFaQt77JLvyAoJUnRpjZ3NOhk31KxEcdzes05 +nsKtjHEh8lprr988TlWvsoRlFIm5d8sqMb7Po23Pb0iUMkZv53GMoKaEGTcH8gNF +CSuGdXzfX2lXANtu2KZyIktQ1HWYVt+3GP9DQ1CuekR78HlR10M9p9OB0/DJT7na +xpeG0ILD5EJt/rDiZE4OJudANCa1CInXCGNjOCd1HjPqbqjdn5lPdE2BiYBL3ZqX +KVwvvoFBuYz/6n1gBp7N1z3TLqMVvKjmJuVvw9y4AyHqnxbxLFS1 +-----END CERTIFICATE----- + +# Issuer: CN=CA Disig Root R2 O=Disig a.s. +# Subject: CN=CA Disig Root R2 O=Disig a.s. +# Label: "CA Disig Root R2" +# Serial: 10572350602393338211 +# MD5 Fingerprint: 26:01:fb:d8:27:a7:17:9a:45:54:38:1a:43:01:3b:03 +# SHA1 Fingerprint: b5:61:eb:ea:a4:de:e4:25:4b:69:1a:98:a5:57:47:c2:34:c7:d9:71 +# SHA256 Fingerprint: e2:3d:4a:03:6d:7b:70:e9:f5:95:b1:42:20:79:d2:b9:1e:df:bb:1f:b6:51:a0:63:3e:aa:8a:9d:c5:f8:07:03 +-----BEGIN CERTIFICATE----- +MIIFaTCCA1GgAwIBAgIJAJK4iNuwisFjMA0GCSqGSIb3DQEBCwUAMFIxCzAJBgNV +BAYTAlNLMRMwEQYDVQQHEwpCcmF0aXNsYXZhMRMwEQYDVQQKEwpEaXNpZyBhLnMu +MRkwFwYDVQQDExBDQSBEaXNpZyBSb290IFIyMB4XDTEyMDcxOTA5MTUzMFoXDTQy +MDcxOTA5MTUzMFowUjELMAkGA1UEBhMCU0sxEzARBgNVBAcTCkJyYXRpc2xhdmEx +EzARBgNVBAoTCkRpc2lnIGEucy4xGTAXBgNVBAMTEENBIERpc2lnIFJvb3QgUjIw +ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCio8QACdaFXS1tFPbCw3Oe +NcJxVX6B+6tGUODBfEl45qt5WDza/3wcn9iXAng+a0EE6UG9vgMsRfYvZNSrXaNH +PWSb6WiaxswbP7q+sos0Ai6YVRn8jG+qX9pMzk0DIaPY0jSTVpbLTAwAFjxfGs3I +x2ymrdMxp7zo5eFm1tL7A7RBZckQrg4FY8aAamkw/dLukO8NJ9+flXP04SXabBbe +QTg06ov80egEFGEtQX6sx3dOy1FU+16SGBsEWmjGycT6txOgmLcRK7fWV8x8nhfR +yyX+hk4kLlYMeE2eARKmK6cBZW58Yh2EhN/qwGu1pSqVg8NTEQxzHQuyRpDRQjrO +QG6Vrf/GlK1ul4SOfW+eioANSW1z4nuSHsPzwfPrLgVv2RvPN3YEyLRa5Beny912 +H9AZdugsBbPWnDTYltxhh5EF5EQIM8HauQhl1K6yNg3ruji6DOWbnuuNZt2Zz9aJ +QfYEkoopKW1rOhzndX0CcQ7zwOe9yxndnWCywmZgtrEE7snmhrmaZkCo5xHtgUUD +i/ZnWejBBhG93c+AAk9lQHhcR1DIm+YfgXvkRKhbhZri3lrVx/k6RGZL5DJUfORs +nLMOPReisjQS1n6yqEm70XooQL6iFh/f5DcfEXP7kAplQ6INfPgGAVUzfbANuPT1 +rqVCV3w2EYx7XsQDnYx5nQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1Ud +DwEB/wQEAwIBBjAdBgNVHQ4EFgQUtZn4r7CU9eMg1gqtzk5WpC5uQu0wDQYJKoZI +hvcNAQELBQADggIBACYGXnDnZTPIgm7ZnBc6G3pmsgH2eDtpXi/q/075KMOYKmFM +tCQSin1tERT3nLXK5ryeJ45MGcipvXrA1zYObYVybqjGom32+nNjf7xueQgcnYqf +GopTpti72TVVsRHFqQOzVju5hJMiXn7B9hJSi+osZ7z+Nkz1uM/Rs0mSO9MpDpkb +lvdhuDvEK7Z4bLQjb/D907JedR+Zlais9trhxTF7+9FGs9K8Z7RiVLoJ92Owk6Ka ++elSLotgEqv89WBW7xBci8QaQtyDW2QOy7W81k/BfDxujRNt+3vrMNDcTa/F1bal +TFtxyegxvug4BkihGuLq0t4SOVga/4AOgnXmt8kHbA7v/zjxmHHEt38OFdAlab0i +nSvtBfZGR6ztwPDUO+Ls7pZbkBNOHlY667DvlruWIxG68kOGdGSVyCh13x01utI3 +gzhTODY7z2zp+WsO0PsE6E9312UBeIYMej4hYvF/Y3EMyZ9E26gnonW+boE+18Dr +G5gPcFw0sorMwIUY6256s/daoQe/qUKS82Ail+QUoQebTnbAjn39pCXHR+3/H3Os +zMOl6W8KjptlwlCFtaOgUxLMVYdh84GuEEZhvUQhuMI9dM9+JDX6HAcOmz0iyu8x +L4ysEr3vQCj8KWefshNPZiTEUxnpHikV7+ZtsH8tZ/3zbBt1RqPlShfppNcL +-----END CERTIFICATE----- + +# Issuer: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV +# Subject: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV +# Label: "ACCVRAIZ1" +# Serial: 6828503384748696800 +# MD5 Fingerprint: d0:a0:5a:ee:05:b6:09:94:21:a1:7d:f1:b2:29:82:02 +# SHA1 Fingerprint: 93:05:7a:88:15:c6:4f:ce:88:2f:fa:91:16:52:28:78:bc:53:64:17 +# SHA256 Fingerprint: 9a:6e:c0:12:e1:a7:da:9d:be:34:19:4d:47:8a:d7:c0:db:18:22:fb:07:1d:f1:29:81:49:6e:d1:04:38:41:13 +-----BEGIN CERTIFICATE----- +MIIH0zCCBbugAwIBAgIIXsO3pkN/pOAwDQYJKoZIhvcNAQEFBQAwQjESMBAGA1UE +AwwJQUNDVlJBSVoxMRAwDgYDVQQLDAdQS0lBQ0NWMQ0wCwYDVQQKDARBQ0NWMQsw +CQYDVQQGEwJFUzAeFw0xMTA1MDUwOTM3MzdaFw0zMDEyMzEwOTM3MzdaMEIxEjAQ +BgNVBAMMCUFDQ1ZSQUlaMTEQMA4GA1UECwwHUEtJQUNDVjENMAsGA1UECgwEQUND +VjELMAkGA1UEBhMCRVMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCb +qau/YUqXry+XZpp0X9DZlv3P4uRm7x8fRzPCRKPfmt4ftVTdFXxpNRFvu8gMjmoY +HtiP2Ra8EEg2XPBjs5BaXCQ316PWywlxufEBcoSwfdtNgM3802/J+Nq2DoLSRYWo +G2ioPej0RGy9ocLLA76MPhMAhN9KSMDjIgro6TenGEyxCQ0jVn8ETdkXhBilyNpA +lHPrzg5XPAOBOp0KoVdDaaxXbXmQeOW1tDvYvEyNKKGno6e6Ak4l0Squ7a4DIrhr +IA8wKFSVf+DuzgpmndFALW4ir50awQUZ0m/A8p/4e7MCQvtQqR0tkw8jq8bBD5L/ +0KIV9VMJcRz/RROE5iZe+OCIHAr8Fraocwa48GOEAqDGWuzndN9wrqODJerWx5eH +k6fGioozl2A3ED6XPm4pFdahD9GILBKfb6qkxkLrQaLjlUPTAYVtjrs78yM2x/47 +4KElB0iryYl0/wiPgL/AlmXz7uxLaL2diMMxs0Dx6M/2OLuc5NF/1OVYm3z61PMO +m3WR5LpSLhl+0fXNWhn8ugb2+1KoS5kE3fj5tItQo05iifCHJPqDQsGH+tUtKSpa +cXpkatcnYGMN285J9Y0fkIkyF/hzQ7jSWpOGYdbhdQrqeWZ2iE9x6wQl1gpaepPl +uUsXQA+xtrn13k/c4LOsOxFwYIRKQ26ZIMApcQrAZQIDAQABo4ICyzCCAscwfQYI +KwYBBQUHAQEEcTBvMEwGCCsGAQUFBzAChkBodHRwOi8vd3d3LmFjY3YuZXMvZmls +ZWFkbWluL0FyY2hpdm9zL2NlcnRpZmljYWRvcy9yYWl6YWNjdjEuY3J0MB8GCCsG +AQUFBzABhhNodHRwOi8vb2NzcC5hY2N2LmVzMB0GA1UdDgQWBBTSh7Tj3zcnk1X2 +VuqB5TbMjB4/vTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNKHtOPfNyeT +VfZW6oHlNsyMHj+9MIIBcwYDVR0gBIIBajCCAWYwggFiBgRVHSAAMIIBWDCCASIG +CCsGAQUFBwICMIIBFB6CARAAQQB1AHQAbwByAGkAZABhAGQAIABkAGUAIABDAGUA +cgB0AGkAZgBpAGMAYQBjAGkA8wBuACAAUgBhAO0AegAgAGQAZQAgAGwAYQAgAEEA +QwBDAFYAIAAoAEEAZwBlAG4AYwBpAGEAIABkAGUAIABUAGUAYwBuAG8AbABvAGcA +7QBhACAAeQAgAEMAZQByAHQAaQBmAGkAYwBhAGMAaQDzAG4AIABFAGwAZQBjAHQA +cgDzAG4AaQBjAGEALAAgAEMASQBGACAAUQA0ADYAMAAxADEANQA2AEUAKQAuACAA +QwBQAFMAIABlAG4AIABoAHQAdABwADoALwAvAHcAdwB3AC4AYQBjAGMAdgAuAGUA +czAwBggrBgEFBQcCARYkaHR0cDovL3d3dy5hY2N2LmVzL2xlZ2lzbGFjaW9uX2Mu +aHRtMFUGA1UdHwROMEwwSqBIoEaGRGh0dHA6Ly93d3cuYWNjdi5lcy9maWxlYWRt +aW4vQXJjaGl2b3MvY2VydGlmaWNhZG9zL3JhaXphY2N2MV9kZXIuY3JsMA4GA1Ud +DwEB/wQEAwIBBjAXBgNVHREEEDAOgQxhY2N2QGFjY3YuZXMwDQYJKoZIhvcNAQEF +BQADggIBAJcxAp/n/UNnSEQU5CmH7UwoZtCPNdpNYbdKl02125DgBS4OxnnQ8pdp +D70ER9m+27Up2pvZrqmZ1dM8MJP1jaGo/AaNRPTKFpV8M9xii6g3+CfYCS0b78gU +JyCpZET/LtZ1qmxNYEAZSUNUY9rizLpm5U9EelvZaoErQNV/+QEnWCzI7UiRfD+m +AM/EKXMRNt6GGT6d7hmKG9Ww7Y49nCrADdg9ZuM8Db3VlFzi4qc1GwQA9j9ajepD +vV+JHanBsMyZ4k0ACtrJJ1vnE5Bc5PUzolVt3OAJTS+xJlsndQAJxGJ3KQhfnlms +tn6tn1QwIgPBHnFk/vk4CpYY3QIUrCPLBhwepH2NDd4nQeit2hW3sCPdK6jT2iWH +7ehVRE2I9DZ+hJp4rPcOVkkO1jMl1oRQQmwgEh0q1b688nCBpHBgvgW1m54ERL5h +I6zppSSMEYCUWqKiuUnSwdzRp+0xESyeGabu4VXhwOrPDYTkF7eifKXeVSUG7szA +h1xA2syVP1XgNce4hL60Xc16gwFy7ofmXx2utYXGJt/mwZrpHgJHnyqobalbz+xF +d3+YJ5oyXSrjhO7FmGYvliAd3djDJ9ew+f7Zfc3Qn48LFFhRny+Lwzgt3uiP1o2H +pPVWQxaZLPSkVrQ0uGE3ycJYgBugl6H8WY3pEfbRD0tVNEYqi4Y7 +-----END CERTIFICATE----- + +# Issuer: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA +# Subject: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA +# Label: "TWCA Global Root CA" +# Serial: 3262 +# MD5 Fingerprint: f9:03:7e:cf:e6:9e:3c:73:7a:2a:90:07:69:ff:2b:96 +# SHA1 Fingerprint: 9c:bb:48:53:f6:a4:f6:d3:52:a4:e8:32:52:55:60:13:f5:ad:af:65 +# SHA256 Fingerprint: 59:76:90:07:f7:68:5d:0f:cd:50:87:2f:9f:95:d5:75:5a:5b:2b:45:7d:81:f3:69:2b:61:0a:98:67:2f:0e:1b +-----BEGIN CERTIFICATE----- +MIIFQTCCAymgAwIBAgICDL4wDQYJKoZIhvcNAQELBQAwUTELMAkGA1UEBhMCVFcx +EjAQBgNVBAoTCVRBSVdBTi1DQTEQMA4GA1UECxMHUm9vdCBDQTEcMBoGA1UEAxMT +VFdDQSBHbG9iYWwgUm9vdCBDQTAeFw0xMjA2MjcwNjI4MzNaFw0zMDEyMzExNTU5 +NTlaMFExCzAJBgNVBAYTAlRXMRIwEAYDVQQKEwlUQUlXQU4tQ0ExEDAOBgNVBAsT +B1Jvb3QgQ0ExHDAaBgNVBAMTE1RXQ0EgR2xvYmFsIFJvb3QgQ0EwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQCwBdvI64zEbooh745NnHEKH1Jw7W2CnJfF +10xORUnLQEK1EjRsGcJ0pDFfhQKX7EMzClPSnIyOt7h52yvVavKOZsTuKwEHktSz +0ALfUPZVr2YOy+BHYC8rMjk1Ujoog/h7FsYYuGLWRyWRzvAZEk2tY/XTP3VfKfCh +MBwqoJimFb3u/Rk28OKRQ4/6ytYQJ0lM793B8YVwm8rqqFpD/G2Gb3PpN0Wp8DbH +zIh1HrtsBv+baz4X7GGqcXzGHaL3SekVtTzWoWH1EfcFbx39Eb7QMAfCKbAJTibc +46KokWofwpFFiFzlmLhxpRUZyXx1EcxwdE8tmx2RRP1WKKD+u4ZqyPpcC1jcxkt2 +yKsi2XMPpfRaAok/T54igu6idFMqPVMnaR1sjjIsZAAmY2E2TqNGtz99sy2sbZCi +laLOz9qC5wc0GZbpuCGqKX6mOL6OKUohZnkfs8O1CWfe1tQHRvMq2uYiN2DLgbYP +oA/pyJV/v1WRBXrPPRXAb94JlAGD1zQbzECl8LibZ9WYkTunhHiVJqRaCPgrdLQA +BDzfuBSO6N+pjWxnkjMdwLfS7JLIvgm/LCkFbwJrnu+8vyq8W8BQj0FwcYeyTbcE +qYSjMq+u7msXi7Kx/mzhkIyIqJdIzshNy/MGz19qCkKxHh53L46g5pIOBvwFItIm +4TFRfTLcDwIDAQABoyMwITAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB +/zANBgkqhkiG9w0BAQsFAAOCAgEAXzSBdu+WHdXltdkCY4QWwa6gcFGn90xHNcgL +1yg9iXHZqjNB6hQbbCEAwGxCGX6faVsgQt+i0trEfJdLjbDorMjupWkEmQqSpqsn +LhpNgb+E1HAerUf+/UqdM+DyucRFCCEK2mlpc3INvjT+lIutwx4116KD7+U4x6WF +H6vPNOw/KP4M8VeGTslV9xzU2KV9Bnpv1d8Q34FOIWWxtuEXeZVFBs5fzNxGiWNo +RI2T9GRwoD2dKAXDOXC4Ynsg/eTb6QihuJ49CcdP+yz4k3ZB3lLg4VfSnQO8d57+ +nile98FRYB/e2guyLXW3Q0iT5/Z5xoRdgFlglPx4mI88k1HtQJAH32RjJMtOcQWh +15QaiDLxInQirqWm2BJpTGCjAu4r7NRjkgtevi92a6O2JryPA9gK8kxkRr05YuWW +6zRjESjMlfGt7+/cgFhI6Uu46mWs6fyAtbXIRfmswZ/ZuepiiI7E8UuDEq3mi4TW +nsLrgxifarsbJGAzcMzs9zLzXNl5fe+epP7JI8Mk7hWSsT2RTyaGvWZzJBPqpK5j +wa19hAM8EHiGG3njxPPyBJUgriOCxLM6AGK/5jYk4Ve6xx6QddVfP5VhK8E7zeWz +aGHQRiapIVJpLesux+t3zqY6tQMzT3bR51xUAV3LePTJDL/PEo4XLSNolOer/qmy +KwbQBM0= +-----END CERTIFICATE----- + +# Issuer: CN=TeliaSonera Root CA v1 O=TeliaSonera +# Subject: CN=TeliaSonera Root CA v1 O=TeliaSonera +# Label: "TeliaSonera Root CA v1" +# Serial: 199041966741090107964904287217786801558 +# MD5 Fingerprint: 37:41:49:1b:18:56:9a:26:f5:ad:c2:66:fb:40:a5:4c +# SHA1 Fingerprint: 43:13:bb:96:f1:d5:86:9b:c1:4e:6a:92:f6:cf:f6:34:69:87:82:37 +# SHA256 Fingerprint: dd:69:36:fe:21:f8:f0:77:c1:23:a1:a5:21:c1:22:24:f7:22:55:b7:3e:03:a7:26:06:93:e8:a2:4b:0f:a3:89 +-----BEGIN CERTIFICATE----- +MIIFODCCAyCgAwIBAgIRAJW+FqD3LkbxezmCcvqLzZYwDQYJKoZIhvcNAQEFBQAw +NzEUMBIGA1UECgwLVGVsaWFTb25lcmExHzAdBgNVBAMMFlRlbGlhU29uZXJhIFJv +b3QgQ0EgdjEwHhcNMDcxMDE4MTIwMDUwWhcNMzIxMDE4MTIwMDUwWjA3MRQwEgYD +VQQKDAtUZWxpYVNvbmVyYTEfMB0GA1UEAwwWVGVsaWFTb25lcmEgUm9vdCBDQSB2 +MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMK+6yfwIaPzaSZVfp3F +VRaRXP3vIb9TgHot0pGMYzHw7CTww6XScnwQbfQ3t+XmfHnqjLWCi65ItqwA3GV1 +7CpNX8GH9SBlK4GoRz6JI5UwFpB/6FcHSOcZrr9FZ7E3GwYq/t75rH2D+1665I+X +Z75Ljo1kB1c4VWk0Nj0TSO9P4tNmHqTPGrdeNjPUtAa9GAH9d4RQAEX1jF3oI7x+ +/jXh7VB7qTCNGdMJjmhnXb88lxhTuylixcpecsHHltTbLaC0H2kD7OriUPEMPPCs +81Mt8Bz17Ww5OXOAFshSsCPN4D7c3TxHoLs1iuKYaIu+5b9y7tL6pe0S7fyYGKkm +dtwoSxAgHNN/Fnct7W+A90m7UwW7XWjH1Mh1Fj+JWov3F0fUTPHSiXk+TT2YqGHe +Oh7S+F4D4MHJHIzTjU3TlTazN19jY5szFPAtJmtTfImMMsJu7D0hADnJoWjiUIMu +sDor8zagrC/kb2HCUQk5PotTubtn2txTuXZZNp1D5SDgPTJghSJRt8czu90VL6R4 +pgd7gUY2BIbdeTXHlSw7sKMXNeVzH7RcWe/a6hBle3rQf5+ztCo3O3CLm1u5K7fs +slESl1MpWtTwEhDcTwK7EpIvYtQ/aUN8Ddb8WHUBiJ1YFkveupD/RwGJBmr2X7KQ +arMCpgKIv7NHfirZ1fpoeDVNAgMBAAGjPzA9MA8GA1UdEwEB/wQFMAMBAf8wCwYD +VR0PBAQDAgEGMB0GA1UdDgQWBBTwj1k4ALP1j5qWDNXr+nuqF+gTEjANBgkqhkiG +9w0BAQUFAAOCAgEAvuRcYk4k9AwI//DTDGjkk0kiP0Qnb7tt3oNmzqjMDfz1mgbl +dxSR651Be5kqhOX//CHBXfDkH1e3damhXwIm/9fH907eT/j3HEbAek9ALCI18Bmx +0GtnLLCo4MBANzX2hFxc469CeP6nyQ1Q6g2EdvZR74NTxnr/DlZJLo961gzmJ1Tj +TQpgcmLNkQfWpb/ImWvtxBnmq0wROMVvMeJuScg/doAmAyYp4Db29iBT4xdwNBed +Y2gea+zDTYa4EzAvXUYNR0PVG6pZDrlcjQZIrXSHX8f8MVRBE+LHIQ6e4B4N4cB7 +Q4WQxYpYxmUKeFfyxiMPAdkgS94P+5KFdSpcc41teyWRyu5FrgZLAMzTsVlQ2jqI +OylDRl6XK1TOU2+NSueW+r9xDkKLfP0ooNBIytrEgUy7onOTJsjrDNYmiLbAJM+7 +vVvrdX3pCI6GMyx5dwlppYn8s3CQh3aP0yK7Qs69cwsgJirQmz1wHiRszYd2qReW +t88NkvuOGKmYSdGe/mBEciG5Ge3C9THxOUiIkCR1VBatzvT4aRRkOfujuLpwQMcn +HL/EVlP6Y2XQ8xwOFvVrhlhNGNTkDY6lnVuR3HYkUD/GKvvZt5y11ubQ2egZixVx +SK236thZiNSQvxaz2emsWWFUyBy6ysHK4bkgTI86k4mloMy/0/Z1pHWWbVY= +-----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" +# Serial: 1 +# MD5 Fingerprint: 2b:9b:9e:e4:7b:6c:1f:00:72:1a:cc:c1:77:79:df:6a +# SHA1 Fingerprint: 59:0d:2d:7d:88:4f:40:2e:61:7e:a5:62:32:17:65:cf:17:d8:94:e9 +# SHA256 Fingerprint: 91:e2:f5:78:8d:58:10:eb:a7:ba:58:73:7d:e1:54:8a:8e:ca:cd:01:45:98:bc:0b:14:3e:04:1b:17:05:25:52 +-----BEGIN CERTIFICATE----- +MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx +KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd +BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl +YyBHbG9iYWxSb290IENsYXNzIDIwHhcNMDgxMDAxMTA0MDE0WhcNMzMxMDAxMjM1 +OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy +aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50 +ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDIwggEiMA0G +CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCqX9obX+hzkeXaXPSi5kfl82hVYAUd +AqSzm1nzHoqvNK38DcLZSBnuaY/JIPwhqgcZ7bBcrGXHX+0CfHt8LRvWurmAwhiC +FoT6ZrAIxlQjgeTNuUk/9k9uN0goOA/FvudocP05l03Sx5iRUKrERLMjfTlH6VJi +1hKTXrcxlkIF+3anHqP1wvzpesVsqXFP6st4vGCvx9702cu+fjOlbpSD8DT6Iavq +jnKgP6TeMFvvhk1qlVtDRKgQFRzlAVfFmPHmBiiRqiDFt1MmUUOyCxGVWOHAD3bZ +wI18gfNycJ5v/hqO2V81xrJvNHy+SE/iWjnX2J14np+GPgNeGYtEotXHAgMBAAGj +QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS/ +WSA2AHmgoCJrjNXyYdK4LMuCSjANBgkqhkiG9w0BAQsFAAOCAQEAMQOiYQsfdOhy +NsZt+U2e+iKo4YFWz827n+qrkRk4r6p8FU3ztqONpfSO9kSpp+ghla0+AGIWiPAC +uvxhI+YzmzB6azZie60EI4RYZeLbK4rnJVM3YlNfvNoBYimipidx5joifsFvHZVw +IEoHNN/q/xWA5brXethbdXwFeilHfkCoMRN3zUA7tFFHei4R40cR3p1m0IvVVGb6 +g1XqfMIpiRvpb7PO4gWEyS8+eIVibslfwXhjdFjASBgMmTnrpMwatXlajRWc2BQN +9noHV8cigwUtPJslJj0Ys6lDfMjIq2SPDqO/nBudMNva0Bkuqjzx+zOAduTNrRlP +BSeOE6Fuwg== +-----END CERTIFICATE----- + +# Issuer: CN=Atos TrustedRoot 2011 O=Atos +# Subject: CN=Atos TrustedRoot 2011 O=Atos +# Label: "Atos TrustedRoot 2011" +# Serial: 6643877497813316402 +# MD5 Fingerprint: ae:b9:c4:32:4b:ac:7f:5d:66:cc:77:94:bb:2a:77:56 +# SHA1 Fingerprint: 2b:b1:f5:3e:55:0c:1d:c5:f1:d4:e6:b7:6a:46:4b:55:06:02:ac:21 +# SHA256 Fingerprint: f3:56:be:a2:44:b7:a9:1e:b3:5d:53:ca:9a:d7:86:4a:ce:01:8e:2d:35:d5:f8:f9:6d:df:68:a6:f4:1a:a4:74 +-----BEGIN CERTIFICATE----- +MIIDdzCCAl+gAwIBAgIIXDPLYixfszIwDQYJKoZIhvcNAQELBQAwPDEeMBwGA1UE +AwwVQXRvcyBUcnVzdGVkUm9vdCAyMDExMQ0wCwYDVQQKDARBdG9zMQswCQYDVQQG +EwJERTAeFw0xMTA3MDcxNDU4MzBaFw0zMDEyMzEyMzU5NTlaMDwxHjAcBgNVBAMM +FUF0b3MgVHJ1c3RlZFJvb3QgMjAxMTENMAsGA1UECgwEQXRvczELMAkGA1UEBhMC +REUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCVhTuXbyo7LjvPpvMp +Nb7PGKw+qtn4TaA+Gke5vJrf8v7MPkfoepbCJI419KkM/IL9bcFyYie96mvr54rM +VD6QUM+A1JX76LWC1BTFtqlVJVfbsVD2sGBkWXppzwO3bw2+yj5vdHLqqjAqc2K+ +SZFhyBH+DgMq92og3AIVDV4VavzjgsG1xZ1kCWyjWZgHJ8cblithdHFsQ/H3NYkQ +4J7sVaE3IqKHBAUsR320HLliKWYoyrfhk/WklAOZuXCFteZI6o1Q/NnezG8HDt0L +cp2AMBYHlT8oDv3FdU9T1nSatCQujgKRz3bFmx5VdJx4IbHwLfELn8LVlhgf8FQi +eowHAgMBAAGjfTB7MB0GA1UdDgQWBBSnpQaxLKYJYO7Rl+lwrrw7GWzbITAPBgNV +HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFKelBrEspglg7tGX6XCuvDsZbNshMBgG +A1UdIAQRMA8wDQYLKwYBBAGwLQMEAQEwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3 +DQEBCwUAA4IBAQAmdzTblEiGKkGdLD4GkGDEjKwLVLgfuXvTBznk+j57sj1O7Z8j +vZfza1zv7v1Apt+hk6EKhqzvINB5Ab149xnYJDE0BAGmuhWawyfc2E8PzBhj/5kP +DpFrdRbhIfzYJsdHt6bPWHJxfrrhTZVHO8mvbaG0weyJ9rQPOLXiZNwlz6bb65pc +maHFCN795trV1lpFDMS3wrUU77QR/w4VtfX128a961qn8FYiqTxlVMYVqL2Gns2D +lmh6cYGJ4Qvh6hEbaAjMaZ7snkGeRDImeuKHCnE96+RapNLbxc3G3mB/ufNPRJLv +KrcYPqcZ2Qt9sTdBQrC6YB3y/gkRsPCHe6ed +-----END CERTIFICATE----- + +# Issuer: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited +# Subject: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited +# Label: "QuoVadis Root CA 1 G3" +# Serial: 687049649626669250736271037606554624078720034195 +# MD5 Fingerprint: a4:bc:5b:3f:fe:37:9a:fa:64:f0:e2:fa:05:3d:0b:ab +# SHA1 Fingerprint: 1b:8e:ea:57:96:29:1a:c9:39:ea:b8:0a:81:1a:73:73:c0:93:79:67 +# SHA256 Fingerprint: 8a:86:6f:d1:b2:76:b5:7e:57:8e:92:1c:65:82:8a:2b:ed:58:e9:f2:f2:88:05:41:34:b7:f1:f4:bf:c9:cc:74 +-----BEGIN CERTIFICATE----- +MIIFYDCCA0igAwIBAgIUeFhfLq0sGUvjNwc1NBMotZbUZZMwDQYJKoZIhvcNAQEL +BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc +BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMSBHMzAeFw0xMjAxMTIxNzI3NDRaFw00 +MjAxMTIxNzI3NDRaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM +aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDEgRzMwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQCgvlAQjunybEC0BJyFuTHK3C3kEakEPBtV +wedYMB0ktMPvhd6MLOHBPd+C5k+tR4ds7FtJwUrVu4/sh6x/gpqG7D0DmVIB0jWe +rNrwU8lmPNSsAgHaJNM7qAJGr6Qc4/hzWHa39g6QDbXwz8z6+cZM5cOGMAqNF341 +68Xfuw6cwI2H44g4hWf6Pser4BOcBRiYz5P1sZK0/CPTz9XEJ0ngnjybCKOLXSoh +4Pw5qlPafX7PGglTvF0FBM+hSo+LdoINofjSxxR3W5A2B4GbPgb6Ul5jxaYA/qXp +UhtStZI5cgMJYr2wYBZupt0lwgNm3fME0UDiTouG9G/lg6AnhF4EwfWQvTA9xO+o +abw4m6SkltFi2mnAAZauy8RRNOoMqv8hjlmPSlzkYZqn0ukqeI1RPToV7qJZjqlc +3sX5kCLliEVx3ZGZbHqfPT2YfF72vhZooF6uCyP8Wg+qInYtyaEQHeTTRCOQiJ/G +KubX9ZqzWB4vMIkIG1SitZgj7Ah3HJVdYdHLiZxfokqRmu8hqkkWCKi9YSgxyXSt +hfbZxbGL0eUQMk1fiyA6PEkfM4VZDdvLCXVDaXP7a3F98N/ETH3Goy7IlXnLc6KO +Tk0k+17kBL5yG6YnLUlamXrXXAkgt3+UuU/xDRxeiEIbEbfnkduebPRq34wGmAOt +zCjvpUfzUwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB +BjAdBgNVHQ4EFgQUo5fW816iEOGrRZ88F2Q87gFwnMwwDQYJKoZIhvcNAQELBQAD +ggIBABj6W3X8PnrHX3fHyt/PX8MSxEBd1DKquGrX1RUVRpgjpeaQWxiZTOOtQqOC +MTaIzen7xASWSIsBx40Bz1szBpZGZnQdT+3Btrm0DWHMY37XLneMlhwqI2hrhVd2 +cDMT/uFPpiN3GPoajOi9ZcnPP/TJF9zrx7zABC4tRi9pZsMbj/7sPtPKlL92CiUN +qXsCHKnQO18LwIE6PWThv6ctTr1NxNgpxiIY0MWscgKCP6o6ojoilzHdCGPDdRS5 +YCgtW2jgFqlmgiNR9etT2DGbe+m3nUvriBbP+V04ikkwj+3x6xn0dxoxGE1nVGwv +b2X52z3sIexe9PSLymBlVNFxZPT5pqOBMzYzcfCkeF9OrYMh3jRJjehZrJ3ydlo2 +8hP0r+AJx2EqbPfgna67hkooby7utHnNkDPDs3b69fBsnQGQ+p6Q9pxyz0fawx/k +NSBT8lTR32GDpgLiJTjehTItXnOQUl1CxM49S+H5GYQd1aJQzEH7QRTDvdbJWqNj +ZgKAvQU6O0ec7AAmTPWIUb+oI38YB7AL7YsmoWTTYUrrXJ/es69nA7Mf3W1daWhp +q1467HxpvMc7hU6eFbm0FU/DlXpY18ls6Wy58yljXrQs8C097Vpl4KlbQMJImYFt +nh8GKjwStIsPm6Ik8KaN1nrgS7ZklmOVhMJKzRwuJIczYOXD +-----END CERTIFICATE----- + +# Issuer: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited +# Subject: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited +# Label: "QuoVadis Root CA 2 G3" +# Serial: 390156079458959257446133169266079962026824725800 +# MD5 Fingerprint: af:0c:86:6e:bf:40:2d:7f:0b:3e:12:50:ba:12:3d:06 +# SHA1 Fingerprint: 09:3c:61:f3:8b:8b:dc:7d:55:df:75:38:02:05:00:e1:25:f5:c8:36 +# SHA256 Fingerprint: 8f:e4:fb:0a:f9:3a:4d:0d:67:db:0b:eb:b2:3e:37:c7:1b:f3:25:dc:bc:dd:24:0e:a0:4d:af:58:b4:7e:18:40 +-----BEGIN CERTIFICATE----- +MIIFYDCCA0igAwIBAgIURFc0JFuBiZs18s64KztbpybwdSgwDQYJKoZIhvcNAQEL +BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc +BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMiBHMzAeFw0xMjAxMTIxODU5MzJaFw00 +MjAxMTIxODU5MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM +aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDIgRzMwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQChriWyARjcV4g/Ruv5r+LrI3HimtFhZiFf +qq8nUeVuGxbULX1QsFN3vXg6YOJkApt8hpvWGo6t/x8Vf9WVHhLL5hSEBMHfNrMW +n4rjyduYNM7YMxcoRvynyfDStNVNCXJJ+fKH46nafaF9a7I6JaltUkSs+L5u+9ym +c5GQYaYDFCDy54ejiK2toIz/pgslUiXnFgHVy7g1gQyjO/Dh4fxaXc6AcW34Sas+ +O7q414AB+6XrW7PFXmAqMaCvN+ggOp+oMiwMzAkd056OXbxMmO7FGmh77FOm6RQ1 +o9/NgJ8MSPsc9PG/Srj61YxxSscfrf5BmrODXfKEVu+lV0POKa2Mq1W/xPtbAd0j +IaFYAI7D0GoT7RPjEiuA3GfmlbLNHiJuKvhB1PLKFAeNilUSxmn1uIZoL1NesNKq +IcGY5jDjZ1XHm26sGahVpkUG0CM62+tlXSoREfA7T8pt9DTEceT/AFr2XK4jYIVz +8eQQsSWu1ZK7E8EM4DnatDlXtas1qnIhO4M15zHfeiFuuDIIfR0ykRVKYnLP43eh +vNURG3YBZwjgQQvD6xVu+KQZ2aKrr+InUlYrAoosFCT5v0ICvybIxo/gbjh9Uy3l +7ZizlWNof/k19N+IxWA1ksB8aRxhlRbQ694Lrz4EEEVlWFA4r0jyWbYW8jwNkALG +cC4BrTwV1wIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB +BjAdBgNVHQ4EFgQU7edvdlq/YOxJW8ald7tyFnGbxD0wDQYJKoZIhvcNAQELBQAD +ggIBAJHfgD9DCX5xwvfrs4iP4VGyvD11+ShdyLyZm3tdquXK4Qr36LLTn91nMX66 +AarHakE7kNQIXLJgapDwyM4DYvmL7ftuKtwGTTwpD4kWilhMSA/ohGHqPHKmd+RC +roijQ1h5fq7KpVMNqT1wvSAZYaRsOPxDMuHBR//47PERIjKWnML2W2mWeyAMQ0Ga +W/ZZGYjeVYg3UQt4XAoeo0L9x52ID8DyeAIkVJOviYeIyUqAHerQbj5hLja7NQ4n +lv1mNDthcnPxFlxHBlRJAHpYErAK74X9sbgzdWqTHBLmYF5vHX/JHyPLhGGfHoJE ++V+tYlUkmlKY7VHnoX6XOuYvHxHaU4AshZ6rNRDbIl9qxV6XU/IyAgkwo1jwDQHV +csaxfGl7w/U2Rcxhbl5MlMVerugOXou/983g7aEOGzPuVBj+D77vfoRrQ+NwmNtd +dbINWQeFFSM51vHfqSYP1kjHs6Yi9TM3WpVHn3u6GBVv/9YUZINJ0gpnIdsPNWNg +KCLjsZWDzYWm3S8P52dSbrsvhXz1SnPnxT7AvSESBT/8twNJAlvIJebiVDj1eYeM +HVOyToV7BjjHLPj4sHKNJeV3UvQDHEimUF+IIDBu8oJDqz2XhOdT+yHBTw8imoa4 +WSr2Rz0ZiC3oheGe7IUIarFsNMkd7EgrO3jtZsSOeWmD3n+M +-----END CERTIFICATE----- + +# Issuer: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited +# Subject: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited +# Label: "QuoVadis Root CA 3 G3" +# Serial: 268090761170461462463995952157327242137089239581 +# MD5 Fingerprint: df:7d:b9:ad:54:6f:68:a1:df:89:57:03:97:43:b0:d7 +# SHA1 Fingerprint: 48:12:bd:92:3c:a8:c4:39:06:e7:30:6d:27:96:e6:a4:cf:22:2e:7d +# SHA256 Fingerprint: 88:ef:81:de:20:2e:b0:18:45:2e:43:f8:64:72:5c:ea:5f:bd:1f:c2:d9:d2:05:73:07:09:c5:d8:b8:69:0f:46 +-----BEGIN CERTIFICATE----- +MIIFYDCCA0igAwIBAgIULvWbAiin23r/1aOp7r0DoM8Sah0wDQYJKoZIhvcNAQEL +BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc +BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMyBHMzAeFw0xMjAxMTIyMDI2MzJaFw00 +MjAxMTIyMDI2MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM +aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDMgRzMwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQCzyw4QZ47qFJenMioKVjZ/aEzHs286IxSR +/xl/pcqs7rN2nXrpixurazHb+gtTTK/FpRp5PIpM/6zfJd5O2YIyC0TeytuMrKNu +FoM7pmRLMon7FhY4futD4tN0SsJiCnMK3UmzV9KwCoWdcTzeo8vAMvMBOSBDGzXR +U7Ox7sWTaYI+FrUoRqHe6okJ7UO4BUaKhvVZR74bbwEhELn9qdIoyhA5CcoTNs+c +ra1AdHkrAj80//ogaX3T7mH1urPnMNA3I4ZyYUUpSFlob3emLoG+B01vr87ERROR +FHAGjx+f+IdpsQ7vw4kZ6+ocYfx6bIrc1gMLnia6Et3UVDmrJqMz6nWB2i3ND0/k +A9HvFZcba5DFApCTZgIhsUfei5pKgLlVj7WiL8DWM2fafsSntARE60f75li59wzw +eyuxwHApw0BiLTtIadwjPEjrewl5qW3aqDCYz4ByA4imW0aucnl8CAMhZa634Ryl +sSqiMd5mBPfAdOhx3v89WcyWJhKLhZVXGqtrdQtEPREoPHtht+KPZ0/l7DxMYIBp +VzgeAVuNVejH38DMdyM0SXV89pgR6y3e7UEuFAUCf+D+IOs15xGsIs5XPd7JMG0Q +A4XN8f+MFrXBsj6IbGB/kE+V9/YtrQE5BwT6dYB9v0lQ7e/JxHwc64B+27bQ3RP+ +ydOc17KXqQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB +BjAdBgNVHQ4EFgQUxhfQvKjqAkPyGwaZXSuQILnXnOQwDQYJKoZIhvcNAQELBQAD +ggIBADRh2Va1EodVTd2jNTFGu6QHcrxfYWLopfsLN7E8trP6KZ1/AvWkyaiTt3px +KGmPc+FSkNrVvjrlt3ZqVoAh313m6Tqe5T72omnHKgqwGEfcIHB9UqM+WXzBusnI +FUBhynLWcKzSt/Ac5IYp8M7vaGPQtSCKFWGafoaYtMnCdvvMujAWzKNhxnQT5Wvv +oxXqA/4Ti2Tk08HS6IT7SdEQTXlm66r99I0xHnAUrdzeZxNMgRVhvLfZkXdxGYFg +u/BYpbWcC/ePIlUnwEsBbTuZDdQdm2NnL9DuDcpmvJRPpq3t/O5jrFc/ZSXPsoaP +0Aj/uHYUbt7lJ+yreLVTubY/6CD50qi+YUbKh4yE8/nxoGibIh6BJpsQBJFxwAYf +3KDTuVan45gtf4Od34wrnDKOMpTwATwiKp9Dwi7DmDkHOHv8XgBCH/MyJnmDhPbl +8MFREsALHgQjDFSlTC9JxUrRtm5gDWv8a4uFJGS3iQ6rJUdbPM9+Sb3H6QrG2vd+ +DhcI00iX0HGS8A85PjRqHH3Y8iKuu2n0M7SmSFXRDw4m6Oy2Cy2nhTXN/VnIn9HN +PlopNLk9hM6xZdRZkZFWdSHBd575euFgndOtBBj0fOtek49TSiIp+EgrPk2GrFt/ +ywaZWWDYWGWVjUTR939+J399roD1B0y2PpxxVJkES/1Y+Zj0 +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Assured ID Root G2" +# Serial: 15385348160840213938643033620894905419 +# MD5 Fingerprint: 92:38:b9:f8:63:24:82:65:2c:57:33:e6:fe:81:8f:9d +# SHA1 Fingerprint: a1:4b:48:d9:43:ee:0a:0e:40:90:4f:3c:e0:a4:c0:91:93:51:5d:3f +# SHA256 Fingerprint: 7d:05:eb:b6:82:33:9f:8c:94:51:ee:09:4e:eb:fe:fa:79:53:a1:14:ed:b2:f4:49:49:45:2f:ab:7d:2f:c1:85 +-----BEGIN CERTIFICATE----- +MIIDljCCAn6gAwIBAgIQC5McOtY5Z+pnI7/Dr5r0SzANBgkqhkiG9w0BAQsFADBl +MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 +d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv +b3QgRzIwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQG +EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl +cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzIwggEi +MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDZ5ygvUj82ckmIkzTz+GoeMVSA +n61UQbVH35ao1K+ALbkKz3X9iaV9JPrjIgwrvJUXCzO/GU1BBpAAvQxNEP4Htecc +biJVMWWXvdMX0h5i89vqbFCMP4QMls+3ywPgym2hFEwbid3tALBSfK+RbLE4E9Hp +EgjAALAcKxHad3A2m67OeYfcgnDmCXRwVWmvo2ifv922ebPynXApVfSr/5Vh88lA +bx3RvpO704gqu52/clpWcTs/1PPRCv4o76Pu2ZmvA9OPYLfykqGxvYmJHzDNw6Yu +YjOuFgJ3RFrngQo8p0Quebg/BLxcoIfhG69Rjs3sLPr4/m3wOnyqi+RnlTGNAgMB +AAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQW +BBTOw0q5mVXyuNtgv6l+vVa1lzan1jANBgkqhkiG9w0BAQsFAAOCAQEAyqVVjOPI +QW5pJ6d1Ee88hjZv0p3GeDgdaZaikmkuOGybfQTUiaWxMTeKySHMq2zNixya1r9I +0jJmwYrA8y8678Dj1JGG0VDjA9tzd29KOVPt3ibHtX2vK0LRdWLjSisCx1BL4Gni +lmwORGYQRI+tBev4eaymG+g3NJ1TyWGqolKvSnAWhsI6yLETcDbYz+70CjTVW0z9 +B5yiutkBclzzTcHdDrEcDcRjvq30FPuJ7KJBDkzMyFdA0G4Dqs0MjomZmWzwPDCv +ON9vvKO+KSAnq3T/EyJ43pdSVR6DtVQgA+6uwE9W3jfMw3+qBCe703e4YtsXfJwo +IhNzbM8m9Yop5w== +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Assured ID Root G3" +# Serial: 15459312981008553731928384953135426796 +# MD5 Fingerprint: 7c:7f:65:31:0c:81:df:8d:ba:3e:99:e2:5c:ad:6e:fb +# SHA1 Fingerprint: f5:17:a2:4f:9a:48:c6:c9:f8:a2:00:26:9f:dc:0f:48:2c:ab:30:89 +# SHA256 Fingerprint: 7e:37:cb:8b:4c:47:09:0c:ab:36:55:1b:a6:f4:5d:b8:40:68:0f:ba:16:6a:95:2d:b1:00:71:7f:43:05:3f:c2 +-----BEGIN CERTIFICATE----- +MIICRjCCAc2gAwIBAgIQC6Fa+h3foLVJRK/NJKBs7DAKBggqhkjOPQQDAzBlMQsw +CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu +ZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3Qg +RzMwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQGEwJV +UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu +Y29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzMwdjAQBgcq +hkjOPQIBBgUrgQQAIgNiAAQZ57ysRGXtzbg/WPuNsVepRC0FFfLvC/8QdJ+1YlJf +Zn4f5dwbRXkLzMZTCp2NXQLZqVneAlr2lSoOjThKiknGvMYDOAdfVdp+CW7if17Q +RSAPWXYQ1qAk8C3eNvJsKTmjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/ +BAQDAgGGMB0GA1UdDgQWBBTL0L2p4ZgFUaFNN6KDec6NHSrkhDAKBggqhkjOPQQD +AwNnADBkAjAlpIFFAmsSS3V0T8gj43DydXLefInwz5FyYZ5eEJJZVrmDxxDnOOlY +JjZ91eQ0hjkCMHw2U/Aw5WJjOpnitqM7mzT6HtoQknFekROn3aRukswy1vUhZscv +6pZjamVFkpUBtA== +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Global Root G2" +# Serial: 4293743540046975378534879503202253541 +# MD5 Fingerprint: e4:a6:8a:c8:54:ac:52:42:46:0a:fd:72:48:1b:2a:44 +# SHA1 Fingerprint: df:3c:24:f9:bf:d6:66:76:1b:26:80:73:fe:06:d1:cc:8d:4f:82:a4 +# SHA256 Fingerprint: cb:3c:cb:b7:60:31:e5:e0:13:8f:8d:d3:9a:23:f9:de:47:ff:c3:5e:43:c1:14:4c:ea:27:d4:6a:5a:b1:cb:5f +-----BEGIN CERTIFICATE----- +MIIDjjCCAnagAwIBAgIQAzrx5qcRqaC7KGSxHQn65TANBgkqhkiG9w0BAQsFADBh +MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 +d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBH +MjAeFw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVT +MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j +b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEcyMIIBIjANBgkqhkiG +9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuzfNNNx7a8myaJCtSnX/RrohCgiN9RlUyfuI +2/Ou8jqJkTx65qsGGmvPrC3oXgkkRLpimn7Wo6h+4FR1IAWsULecYxpsMNzaHxmx +1x7e/dfgy5SDN67sH0NO3Xss0r0upS/kqbitOtSZpLYl6ZtrAGCSYP9PIUkY92eQ +q2EGnI/yuum06ZIya7XzV+hdG82MHauVBJVJ8zUtluNJbd134/tJS7SsVQepj5Wz +tCO7TG1F8PapspUwtP1MVYwnSlcUfIKdzXOS0xZKBgyMUNGPHgm+F6HmIcr9g+UQ +vIOlCsRnKPZzFBQ9RnbDhxSJITRNrw9FDKZJobq7nMWxM4MphQIDAQABo0IwQDAP +BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUTiJUIBiV +5uNu5g/6+rkS7QYXjzkwDQYJKoZIhvcNAQELBQADggEBAGBnKJRvDkhj6zHd6mcY +1Yl9PMWLSn/pvtsrF9+wX3N3KjITOYFnQoQj8kVnNeyIv/iPsGEMNKSuIEyExtv4 +NeF22d+mQrvHRAiGfzZ0JFrabA0UWTW98kndth/Jsw1HKj2ZL7tcu7XUIOGZX1NG +Fdtom/DzMNU+MeKNhJ7jitralj41E6Vf8PlwUHBHQRFXGU7Aj64GxJUTFy8bJZ91 +8rGOmaFvE7FBcf6IKshPECBV1/MUReXgRPTqh5Uykw7+U0b6LJ3/iyK5S9kJRaTe +pLiaWN0bfVKfjllDiIGknibVb63dDcY3fe0Dkhvld1927jyNxF1WW6LZZm6zNTfl +MrY= +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Global Root G3" +# Serial: 7089244469030293291760083333884364146 +# MD5 Fingerprint: f5:5d:a4:50:a5:fb:28:7e:1e:0f:0d:cc:96:57:56:ca +# SHA1 Fingerprint: 7e:04:de:89:6a:3e:66:6d:00:e6:87:d3:3f:fa:d9:3b:e8:3d:34:9e +# SHA256 Fingerprint: 31:ad:66:48:f8:10:41:38:c7:38:f3:9e:a4:32:01:33:39:3e:3a:18:cc:02:29:6e:f9:7c:2a:c9:ef:67:31:d0 +-----BEGIN CERTIFICATE----- +MIICPzCCAcWgAwIBAgIQBVVWvPJepDU1w6QP1atFcjAKBggqhkjOPQQDAzBhMQsw +CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu +ZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBHMzAe +Fw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVTMRUw +EwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20x +IDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEczMHYwEAYHKoZIzj0CAQYF +K4EEACIDYgAE3afZu4q4C/sLfyHS8L6+c/MzXRq8NOrexpu80JX28MzQC7phW1FG +fp4tn+6OYwwX7Adw9c+ELkCDnOg/QW07rdOkFFk2eJ0DQ+4QE2xy3q6Ip6FrtUPO +Z9wj/wMco+I+o0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAd +BgNVHQ4EFgQUs9tIpPmhxdiuNkHMEWNpYim8S8YwCgYIKoZIzj0EAwMDaAAwZQIx +AK288mw/EkrRLTnDCgmXc/SINoyIJ7vmiI1Qhadj+Z4y3maTD/HMsQmP3Wyr+mt/ +oAIwOWZbwmSNuJ5Q3KjVSaLtx9zRSX8XAbjIho9OjIgrqJqpisXRAL34VOKa5Vt8 +sycX +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Trusted Root G4" +# Serial: 7451500558977370777930084869016614236 +# MD5 Fingerprint: 78:f2:fc:aa:60:1f:2f:b4:eb:c9:37:ba:53:2e:75:49 +# SHA1 Fingerprint: dd:fb:16:cd:49:31:c9:73:a2:03:7d:3f:c8:3a:4d:7d:77:5d:05:e4 +# SHA256 Fingerprint: 55:2f:7b:dc:f1:a7:af:9e:6c:e6:72:01:7f:4f:12:ab:f7:72:40:c7:8e:76:1a:c2:03:d1:d9:d2:0a:c8:99:88 +-----BEGIN CERTIFICATE----- +MIIFkDCCA3igAwIBAgIQBZsbV56OITLiOQe9p3d1XDANBgkqhkiG9w0BAQwFADBi +MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 +d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3Qg +RzQwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBiMQswCQYDVQQGEwJV +UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu +Y29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQC/5pBzaN675F1KPDAiMGkz7MKnJS7JIT3y +ithZwuEppz1Yq3aaza57G4QNxDAf8xukOBbrVsaXbR2rsnnyyhHS5F/WBTxSD1If +xp4VpX6+n6lXFllVcq9ok3DCsrp1mWpzMpTREEQQLt+C8weE5nQ7bXHiLQwb7iDV +ySAdYyktzuxeTsiT+CFhmzTrBcZe7FsavOvJz82sNEBfsXpm7nfISKhmV1efVFiO +DCu3T6cw2Vbuyntd463JT17lNecxy9qTXtyOj4DatpGYQJB5w3jHtrHEtWoYOAMQ +jdjUN6QuBX2I9YI+EJFwq1WCQTLX2wRzKm6RAXwhTNS8rhsDdV14Ztk6MUSaM0C/ +CNdaSaTC5qmgZ92kJ7yhTzm1EVgX9yRcRo9k98FpiHaYdj1ZXUJ2h4mXaXpI8OCi +EhtmmnTK3kse5w5jrubU75KSOp493ADkRSWJtppEGSt+wJS00mFt6zPZxd9LBADM +fRyVw4/3IbKyEbe7f/LVjHAsQWCqsWMYRJUadmJ+9oCw++hkpjPRiQfhvbfmQ6QY +uKZ3AeEPlAwhHbJUKSWJbOUOUlFHdL4mrLZBdd56rF+NP8m800ERElvlEFDrMcXK +chYiCd98THU/Y+whX8QgUWtvsauGi0/C1kVfnSD8oR7FwI+isX4KJpn15GkvmB0t +9dmpsh3lGwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB +hjAdBgNVHQ4EFgQU7NfjgtJxXWRM3y5nP+e6mK4cD08wDQYJKoZIhvcNAQEMBQAD +ggIBALth2X2pbL4XxJEbw6GiAI3jZGgPVs93rnD5/ZpKmbnJeFwMDF/k5hQpVgs2 +SV1EY+CtnJYYZhsjDT156W1r1lT40jzBQ0CuHVD1UvyQO7uYmWlrx8GnqGikJ9yd ++SeuMIW59mdNOj6PWTkiU0TryF0Dyu1Qen1iIQqAyHNm0aAFYF/opbSnr6j3bTWc +fFqK1qI4mfN4i/RN0iAL3gTujJtHgXINwBQy7zBZLq7gcfJW5GqXb5JQbZaNaHqa +sjYUegbyJLkJEVDXCLG4iXqEI2FCKeWjzaIgQdfRnGTZ6iahixTXTBmyUEFxPT9N +cCOGDErcgdLMMpSEDQgJlxxPwO5rIHQw0uA5NBCFIRUBCOhVMt5xSdkoF1BN5r5N +0XWs0Mr7QbhDparTwwVETyw2m+L64kW4I1NsBm9nVX9GtUw/bihaeSbSpKhil9Ie +4u1Ki7wb/UdKDd9nZn6yW0HQO+T0O/QEY+nvwlQAUaCKKsnOeMzV6ocEGLPOr0mI +r/OSmbaz5mEP0oUA51Aa5BuVnRmhuZyxm7EAHu/QD09CbMkKvO5D+jpxpchNJqU1 +/YldvIViHTLSoCtU7ZpXwdv6EM8Zt4tKG48BtieVU+i2iW1bvGjUI+iLUaJW+fCm +gKDWHrO8Dw9TdSmq6hN35N6MgSGtBxBHEa2HPQfRdbzP82Z+ +-----END CERTIFICATE----- + +# Issuer: CN=COMODO RSA Certification Authority O=COMODO CA Limited +# Subject: CN=COMODO RSA Certification Authority O=COMODO CA Limited +# Label: "COMODO RSA Certification Authority" +# Serial: 101909084537582093308941363524873193117 +# MD5 Fingerprint: 1b:31:b0:71:40:36:cc:14:36:91:ad:c4:3e:fd:ec:18 +# SHA1 Fingerprint: af:e5:d2:44:a8:d1:19:42:30:ff:47:9f:e2:f8:97:bb:cd:7a:8c:b4 +# SHA256 Fingerprint: 52:f0:e1:c4:e5:8e:c6:29:29:1b:60:31:7f:07:46:71:b8:5d:7e:a8:0d:5b:07:27:34:63:53:4b:32:b4:02:34 +-----BEGIN CERTIFICATE----- +MIIF2DCCA8CgAwIBAgIQTKr5yttjb+Af907YWwOGnTANBgkqhkiG9w0BAQwFADCB +hTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G +A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNV +BAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMTE5 +MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgT +EkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMR +Q09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNh +dGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCR +6FSS0gpWsawNJN3Fz0RndJkrN6N9I3AAcbxT38T6KhKPS38QVr2fcHK3YX/JSw8X +pz3jsARh7v8Rl8f0hj4K+j5c+ZPmNHrZFGvnnLOFoIJ6dq9xkNfs/Q36nGz637CC +9BR++b7Epi9Pf5l/tfxnQ3K9DADWietrLNPtj5gcFKt+5eNu/Nio5JIk2kNrYrhV +/erBvGy2i/MOjZrkm2xpmfh4SDBF1a3hDTxFYPwyllEnvGfDyi62a+pGx8cgoLEf +Zd5ICLqkTqnyg0Y3hOvozIFIQ2dOciqbXL1MGyiKXCJ7tKuY2e7gUYPDCUZObT6Z ++pUX2nwzV0E8jVHtC7ZcryxjGt9XyD+86V3Em69FmeKjWiS0uqlWPc9vqv9JWL7w +qP/0uK3pN/u6uPQLOvnoQ0IeidiEyxPx2bvhiWC4jChWrBQdnArncevPDt09qZah +SL0896+1DSJMwBGB7FY79tOi4lu3sgQiUpWAk2nojkxl8ZEDLXB0AuqLZxUpaVIC +u9ffUGpVRr+goyhhf3DQw6KqLCGqR84onAZFdr+CGCe01a60y1Dma/RMhnEw6abf +Fobg2P9A3fvQQoh/ozM6LlweQRGBY84YcWsr7KaKtzFcOmpH4MN5WdYgGq/yapiq +crxXStJLnbsQ/LBMQeXtHT1eKJ2czL+zUdqnR+WEUwIDAQABo0IwQDAdBgNVHQ4E +FgQUu69+Aj36pvE8hI6t7jiY7NkyMtQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB +/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAArx1UaEt65Ru2yyTUEUAJNMnMvl +wFTPoCWOAvn9sKIN9SCYPBMtrFaisNZ+EZLpLrqeLppysb0ZRGxhNaKatBYSaVqM +4dc+pBroLwP0rmEdEBsqpIt6xf4FpuHA1sj+nq6PK7o9mfjYcwlYRm6mnPTXJ9OV +2jeDchzTc+CiR5kDOF3VSXkAKRzH7JsgHAckaVd4sjn8OoSgtZx8jb8uk2Intzna +FxiuvTwJaP+EmzzV1gsD41eeFPfR60/IvYcjt7ZJQ3mFXLrrkguhxuhoqEwWsRqZ +CuhTLJK7oQkYdQxlqHvLI7cawiiFwxv/0Cti76R7CZGYZ4wUAc1oBmpjIXUDgIiK +boHGhfKppC3n9KUkEEeDys30jXlYsQab5xoq2Z0B15R97QNKyvDb6KkBPvVWmcke +jkk9u+UJueBPSZI9FoJAzMxZxuY67RIuaTxslbH9qh17f4a+Hg4yRvv7E491f0yL +S0Zj/gA0QHDBw7mh3aZw4gSzQbzpgJHqZJx64SIDqZxubw5lT2yHh17zbqD5daWb +QOhTsiedSrnAdyGN/4fy3ryM7xfft0kL0fJuMAsaDk527RH89elWsn2/x20Kk4yl +0MC2Hb46TpSi125sC8KKfPog88Tk5c0NqMuRkrF8hey1FGlmDoLnzc7ILaZRfyHB +NVOFBkpdn627G190 +-----END CERTIFICATE----- + +# Issuer: CN=USERTrust RSA Certification Authority O=The USERTRUST Network +# Subject: CN=USERTrust RSA Certification Authority O=The USERTRUST Network +# Label: "USERTrust RSA Certification Authority" +# Serial: 2645093764781058787591871645665788717 +# MD5 Fingerprint: 1b:fe:69:d1:91:b7:19:33:a3:72:a8:0f:e1:55:e5:b5 +# SHA1 Fingerprint: 2b:8f:1b:57:33:0d:bb:a2:d0:7a:6c:51:f7:0e:e9:0d:da:b9:ad:8e +# SHA256 Fingerprint: e7:93:c9:b0:2f:d8:aa:13:e2:1c:31:22:8a:cc:b0:81:19:64:3b:74:9c:89:89:64:b1:74:6d:46:c3:d4:cb:d2 +-----BEGIN CERTIFICATE----- +MIIF3jCCA8agAwIBAgIQAf1tMPyjylGoG7xkDjUDLTANBgkqhkiG9w0BAQwFADCB +iDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0pl +cnNleSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNV +BAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAw +MjAxMDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNV +BAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVU +aGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2Vy +dGlmaWNhdGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK +AoICAQCAEmUXNg7D2wiz0KxXDXbtzSfTTK1Qg2HiqiBNCS1kCdzOiZ/MPans9s/B +3PHTsdZ7NygRK0faOca8Ohm0X6a9fZ2jY0K2dvKpOyuR+OJv0OwWIJAJPuLodMkY +tJHUYmTbf6MG8YgYapAiPLz+E/CHFHv25B+O1ORRxhFnRghRy4YUVD+8M/5+bJz/ +Fp0YvVGONaanZshyZ9shZrHUm3gDwFA66Mzw3LyeTP6vBZY1H1dat//O+T23LLb2 +VN3I5xI6Ta5MirdcmrS3ID3KfyI0rn47aGYBROcBTkZTmzNg95S+UzeQc0PzMsNT +79uq/nROacdrjGCT3sTHDN/hMq7MkztReJVni+49Vv4M0GkPGw/zJSZrM233bkf6 +c0Plfg6lZrEpfDKEY1WJxA3Bk1QwGROs0303p+tdOmw1XNtB1xLaqUkL39iAigmT +Yo61Zs8liM2EuLE/pDkP2QKe6xJMlXzzawWpXhaDzLhn4ugTncxbgtNMs+1b/97l +c6wjOy0AvzVVdAlJ2ElYGn+SNuZRkg7zJn0cTRe8yexDJtC/QV9AqURE9JnnV4ee +UB9XVKg+/XRjL7FQZQnmWEIuQxpMtPAlR1n6BB6T1CZGSlCBst6+eLf8ZxXhyVeE +Hg9j1uliutZfVS7qXMYoCAQlObgOK6nyTJccBz8NUvXt7y+CDwIDAQABo0IwQDAd +BgNVHQ4EFgQUU3m/WqorSs9UgOHYm8Cd8rIDZsswDgYDVR0PAQH/BAQDAgEGMA8G +A1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAFzUfA3P9wF9QZllDHPF +Up/L+M+ZBn8b2kMVn54CVVeWFPFSPCeHlCjtHzoBN6J2/FNQwISbxmtOuowhT6KO +VWKR82kV2LyI48SqC/3vqOlLVSoGIG1VeCkZ7l8wXEskEVX/JJpuXior7gtNn3/3 +ATiUFJVDBwn7YKnuHKsSjKCaXqeYalltiz8I+8jRRa8YFWSQEg9zKC7F4iRO/Fjs +8PRF/iKz6y+O0tlFYQXBl2+odnKPi4w2r78NBc5xjeambx9spnFixdjQg3IM8WcR +iQycE0xyNN+81XHfqnHd4blsjDwSXWXavVcStkNr/+XeTWYRUc+ZruwXtuhxkYze +Sf7dNXGiFSeUHM9h4ya7b6NnJSFd5t0dCy5oGzuCr+yDZ4XUmFF0sbmZgIn/f3gZ +XHlKYC6SQK5MNyosycdiyA5d9zZbyuAlJQG03RoHnHcAP9Dc1ew91Pq7P8yF1m9/ +qS3fuQL39ZeatTXaw2ewh0qpKJ4jjv9cJ2vhsE/zB+4ALtRZh8tSQZXq9EfX7mRB +VXyNWQKV3WKdwrnuWih0hKWbt5DHDAff9Yk2dDLWKMGwsAvgnEzDHNb842m1R0aB +L6KCq9NjRHDEjf8tM7qtj3u1cIiuPhnPQCjY/MiQu12ZIvVS5ljFH4gxQ+6IHdfG +jjxDah2nGN59PRbxYvnKkKj9 +-----END CERTIFICATE----- + +# Issuer: CN=USERTrust ECC Certification Authority O=The USERTRUST Network +# Subject: CN=USERTrust ECC Certification Authority O=The USERTRUST Network +# Label: "USERTrust ECC Certification Authority" +# Serial: 123013823720199481456569720443997572134 +# MD5 Fingerprint: fa:68:bc:d9:b5:7f:ad:fd:c9:1d:06:83:28:cc:24:c1 +# SHA1 Fingerprint: d1:cb:ca:5d:b2:d5:2a:7f:69:3b:67:4d:e5:f0:5a:1d:0c:95:7d:f0 +# SHA256 Fingerprint: 4f:f4:60:d5:4b:9c:86:da:bf:bc:fc:57:12:e0:40:0d:2b:ed:3f:bc:4d:4f:bd:aa:86:e0:6a:dc:d2:a9:ad:7a +-----BEGIN CERTIFICATE----- +MIICjzCCAhWgAwIBAgIQXIuZxVqUxdJxVt7NiYDMJjAKBggqhkjOPQQDAzCBiDEL +MAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNl +eSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMT +JVVTRVJUcnVzdCBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMjAx +MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT +Ck5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVUaGUg +VVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBFQ0MgQ2VydGlm +aWNhdGlvbiBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQarFRaqflo +I+d61SRvU8Za2EurxtW20eZzca7dnNYMYf3boIkDuAUU7FfO7l0/4iGzzvfUinng +o4N+LZfQYcTxmdwlkWOrfzCjtHDix6EznPO/LlxTsV+zfTJ/ijTjeXmjQjBAMB0G +A1UdDgQWBBQ64QmG1M8ZwpZ2dEl23OA1xmNjmjAOBgNVHQ8BAf8EBAMCAQYwDwYD +VR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjA2Z6EWCNzklwBBHU6+4WMB +zzuqQhFkoJ2UOQIReVx7Hfpkue4WQrO/isIJxOzksU0CMQDpKmFHjFJKS04YcPbW +RNZu9YO6bVi9JNlWSOrvxKJGgYhqOkbRqZtNyWHa0V1Xahg= +-----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" +# Serial: 32785792099990507226680698011560947931244 +# MD5 Fingerprint: 9f:ad:3b:1c:02:1e:8a:ba:17:74:38:81:0c:a2:bc:08 +# SHA1 Fingerprint: 1f:24:c6:30:cd:a4:18:ef:20:69:ff:ad:4f:dd:5f:46:3a:1b:69:aa +# SHA256 Fingerprint: 17:9f:bc:14:8a:3d:d0:0f:d2:4e:a1:34:58:cc:43:bf:a7:f5:9c:81:82:d7:83:a5:13:f6:eb:ec:10:0c:89:24 +-----BEGIN CERTIFICATE----- +MIICHjCCAaSgAwIBAgIRYFlJ4CYuu1X5CneKcflK2GwwCgYIKoZIzj0EAwMwUDEk +MCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI1MRMwEQYDVQQKEwpH +bG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoX +DTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBD +QSAtIFI1MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWdu +MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAER0UOlvt9Xb/pOdEh+J8LttV7HpI6SFkc +8GIxLcB6KP4ap1yztsyX50XUWPrRd21DosCHZTQKH3rd6zwzocWdTaRvQZU4f8ke +hOvRnkmSh5SHDDqFSmafnVmTTZdhBoZKo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYD +VR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUPeYpSJvqB8ohREom3m7e0oPQn1kwCgYI +KoZIzj0EAwMDaAAwZQIxAOVpEslu28YxuglB4Zf4+/2a4n0Sye18ZNPLBSWLVtmg +515dTguDnFt2KaAJJiFqYgIwcdK1j1zqO+F4CYWodZI7yFz9SO8NdCKoCOJuxUnO +xwy8p2Fp8fc74SrL+SvzZpA3 +-----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" +# Serial: 13298821034946342390520003877796839426 +# MD5 Fingerprint: b3:3e:77:73:75:ee:a0:d3:e3:7e:49:63:49:59:bb:c7 +# SHA1 Fingerprint: df:71:7e:aa:4a:d9:4e:c9:55:84:99:60:2d:48:de:5f:bc:f0:3a:25 +# SHA256 Fingerprint: 5d:56:49:9b:e4:d2:e0:8b:cf:ca:d0:8a:3e:38:72:3d:50:50:3b:de:70:69:48:e4:2f:55:60:30:19:e5:28:ae +-----BEGIN CERTIFICATE----- +MIIFYDCCA0igAwIBAgIQCgFCgAAAAUUjyES1AAAAAjANBgkqhkiG9w0BAQsFADBK +MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScwJQYDVQQDEx5JZGVu +VHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwHhcNMTQwMTE2MTgxMjIzWhcNMzQw +MTE2MTgxMjIzWjBKMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScw +JQYDVQQDEx5JZGVuVHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQCnUBneP5k91DNG8W9RYYKyqU+PZ4ldhNlT +3Qwo2dfw/66VQ3KZ+bVdfIrBQuExUHTRgQ18zZshq0PirK1ehm7zCYofWjK9ouuU ++ehcCuz/mNKvcbO0U59Oh++SvL3sTzIwiEsXXlfEU8L2ApeN2WIrvyQfYo3fw7gp +S0l4PJNgiCL8mdo2yMKi1CxUAGc1bnO/AljwpN3lsKImesrgNqUZFvX9t++uP0D1 +bVoE/c40yiTcdCMbXTMTEl3EASX2MN0CXZ/g1Ue9tOsbobtJSdifWwLziuQkkORi +T0/Br4sOdBeo0XKIanoBScy0RnnGF7HamB4HWfp1IYVl3ZBWzvurpWCdxJ35UrCL +vYf5jysjCiN2O/cz4ckA82n5S6LgTrx+kzmEB/dEcH7+B1rlsazRGMzyNeVJSQjK +Vsk9+w8YfYs7wRPCTY/JTw436R+hDmrfYi7LNQZReSzIJTj0+kuniVyc0uMNOYZK +dHzVWYfCP04MXFL0PfdSgvHqo6z9STQaKPNBiDoT7uje/5kdX7rL6B7yuVBgwDHT +c+XvvqDtMwt0viAgxGds8AgDelWAf0ZOlqf0Hj7h9tgJ4TNkK2PXMl6f+cB7D3hv +l7yTmvmcEpB4eoCHFddydJxVdHixuuFucAS6T6C6aMN7/zHwcz09lCqxC0EOoP5N +iGVreTO01wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB +/zAdBgNVHQ4EFgQU7UQZwNPwBovupHu+QucmVMiONnYwDQYJKoZIhvcNAQELBQAD +ggIBAA2ukDL2pkt8RHYZYR4nKM1eVO8lvOMIkPkp165oCOGUAFjvLi5+U1KMtlwH +6oi6mYtQlNeCgN9hCQCTrQ0U5s7B8jeUeLBfnLOic7iPBZM4zY0+sLj7wM+x8uwt +LRvM7Kqas6pgghstO8OEPVeKlh6cdbjTMM1gCIOQ045U8U1mwF10A0Cj7oV+wh93 +nAbowacYXVKV7cndJZ5t+qntozo00Fl72u1Q8zW/7esUTTHHYPTa8Yec4kjixsU3 ++wYQ+nVZZjFHKdp2mhzpgq7vmrlR94gjmmmVYjzlVYA211QC//G5Xc7UI2/YRYRK +W2XviQzdFKcgyxilJbQN+QHwotL0AMh0jqEqSI5l2xPE4iUXfeu+h1sXIFRRk0pT +AwvsXcoz7WL9RccvW9xYoIA55vrX/hMUpu09lEpCdNTDd1lzzY9GvlU47/rokTLq +l1gEIt44w8y8bckzOmoKaT+gyOpyj4xjhiO9bTyWnpXgSUyqorkqG5w2gXjtw+hG +4iZZRHUe2XWJUc0QhJ1hYMtd+ZciTY6Y5uN/9lu7rs3KSoFrXgvzUeF0K+l+J6fZ +mUlO+KWA2yUPHGNiiskzZ2s8EIPGrd6ozRaOjfAHN3Gf8qv8QfXBi+wAN10J5U6A +7/qxXDgGpRtK4dw4LTzcqx+QGtVKnO7RcGzM7vRX+Bi6hG6H +-----END CERTIFICATE----- + +# Issuer: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust +# Subject: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust +# Label: "IdenTrust Public Sector Root CA 1" +# Serial: 13298821034946342390521976156843933698 +# MD5 Fingerprint: 37:06:a5:b0:fc:89:9d:ba:f4:6b:8c:1a:64:cd:d5:ba +# SHA1 Fingerprint: ba:29:41:60:77:98:3f:f4:f3:ef:f2:31:05:3b:2e:ea:6d:4d:45:fd +# SHA256 Fingerprint: 30:d0:89:5a:9a:44:8a:26:20:91:63:55:22:d1:f5:20:10:b5:86:7a:ca:e1:2c:78:ef:95:8f:d4:f4:38:9f:2f +-----BEGIN CERTIFICATE----- +MIIFZjCCA06gAwIBAgIQCgFCgAAAAUUjz0Z8AAAAAjANBgkqhkiG9w0BAQsFADBN +MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MSowKAYDVQQDEyFJZGVu +VHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwHhcNMTQwMTE2MTc1MzMyWhcN +MzQwMTE2MTc1MzMyWjBNMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0 +MSowKAYDVQQDEyFJZGVuVHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwggIi +MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC2IpT8pEiv6EdrCvsnduTyP4o7 +ekosMSqMjbCpwzFrqHd2hCa2rIFCDQjrVVi7evi8ZX3yoG2LqEfpYnYeEe4IFNGy +RBb06tD6Hi9e28tzQa68ALBKK0CyrOE7S8ItneShm+waOh7wCLPQ5CQ1B5+ctMlS +bdsHyo+1W/CD80/HLaXIrcuVIKQxKFdYWuSNG5qrng0M8gozOSI5Cpcu81N3uURF +/YTLNiCBWS2ab21ISGHKTN9T0a9SvESfqy9rg3LvdYDaBjMbXcjaY8ZNzaxmMc3R +3j6HEDbhuaR672BQssvKplbgN6+rNBM5Jeg5ZuSYeqoSmJxZZoY+rfGwyj4GD3vw +EUs3oERte8uojHH01bWRNszwFcYr3lEXsZdMUD2xlVl8BX0tIdUAvwFnol57plzy +9yLxkA2T26pEUWbMfXYD62qoKjgZl3YNa4ph+bz27nb9cCvdKTz4Ch5bQhyLVi9V +GxyhLrXHFub4qjySjmm2AcG1hp2JDws4lFTo6tyePSW8Uybt1as5qsVATFSrsrTZ +2fjXctscvG29ZV/viDUqZi/u9rNl8DONfJhBaUYPQxxp+pu10GFqzcpL2UyQRqsV +WaFHVCkugyhfHMKiq3IXAAaOReyL4jM9f9oZRORicsPfIsbyVtTdX5Vy7W1f90gD +W/3FKqD2cyOEEBsB5wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/ +BAUwAwEB/zAdBgNVHQ4EFgQU43HgntinQtnbcZFrlJPrw6PRFKMwDQYJKoZIhvcN +AQELBQADggIBAEf63QqwEZE4rU1d9+UOl1QZgkiHVIyqZJnYWv6IAcVYpZmxI1Qj +t2odIFflAWJBF9MJ23XLblSQdf4an4EKwt3X9wnQW3IV5B4Jaj0z8yGa5hV+rVHV +DRDtfULAj+7AmgjVQdZcDiFpboBhDhXAuM/FSRJSzL46zNQuOAXeNf0fb7iAaJg9 +TaDKQGXSc3z1i9kKlT/YPyNtGtEqJBnZhbMX73huqVjRI9PHE+1yJX9dsXNw0H8G +lwmEKYBhHfpe/3OsoOOJuBxxFcbeMX8S3OFtm6/n6J91eEyrRjuazr8FGF1NFTwW +mhlQBJqymm9li1JfPFgEKCXAZmExfrngdbkaqIHWchezxQMxNRF4eKLg6TCMf4Df +WN88uieW4oA0beOY02QnrEh+KHdcxiVhJfiFDGX6xDIvpZgF5PgLZxYWxoK4Mhn5 ++bl53B/N66+rDt0b20XkeucC4pVd/GnwU2lhlXV5C15V5jgclKlZM57IcXR5f1GJ +tshquDDIajjDbp7hNxbqBWJMWxJH7ae0s1hWx0nzfxJoCTFx8G34Tkf71oXuxVhA +GaQdp/lLQzfcaFpPz+vCZHTetBXZ9FRUGi8c15dxVJCO2SCdUyt/q4/i6jC8UDfv +8Ue1fXwsBOxonbRJRBD0ckscZOf85muQ3Wl9af0AVqW3rLatt8o+Ae+c +-----END CERTIFICATE----- + +# Issuer: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only +# Subject: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only +# Label: "Entrust Root Certification Authority - G2" +# Serial: 1246989352 +# MD5 Fingerprint: 4b:e2:c9:91:96:65:0c:f4:0e:5a:93:92:a0:0a:fe:b2 +# SHA1 Fingerprint: 8c:f4:27:fd:79:0c:3a:d1:66:06:8d:e8:1e:57:ef:bb:93:22:72:d4 +# SHA256 Fingerprint: 43:df:57:74:b0:3e:7f:ef:5f:e4:0d:93:1a:7b:ed:f1:bb:2e:6b:42:73:8c:4e:6d:38:41:10:3d:3a:a7:f3:39 +-----BEGIN CERTIFICATE----- +MIIEPjCCAyagAwIBAgIESlOMKDANBgkqhkiG9w0BAQsFADCBvjELMAkGA1UEBhMC +VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50 +cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3Qs +IEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVz +dCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRzIwHhcNMDkwNzA3MTcy +NTU0WhcNMzAxMjA3MTc1NTU0WjCBvjELMAkGA1UEBhMCVVMxFjAUBgNVBAoTDUVu +dHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50cnVzdC5uZXQvbGVnYWwt +dGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3QsIEluYy4gLSBmb3IgYXV0 +aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVzdCBSb290IENlcnRpZmlj +YXRpb24gQXV0aG9yaXR5IC0gRzIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK +AoIBAQC6hLZy254Ma+KZ6TABp3bqMriVQRrJ2mFOWHLP/vaCeb9zYQYKpSfYs1/T +RU4cctZOMvJyig/3gxnQaoCAAEUesMfnmr8SVycco2gvCoe9amsOXmXzHHfV1IWN +cCG0szLni6LVhjkCsbjSR87kyUnEO6fe+1R9V77w6G7CebI6C1XiUJgWMhNcL3hW +wcKUs/Ja5CeanyTXxuzQmyWC48zCxEXFjJd6BmsqEZ+pCm5IO2/b1BEZQvePB7/1 +U1+cPvQXLOZprE4yTGJ36rfo5bs0vBmLrpxR57d+tVOxMyLlbc9wPBr64ptntoP0 +jaWvYkxN4FisZDQSA/i2jZRjJKRxAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAP +BgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqciZ60B7vfec7aVHUbI2fkBJmqzAN +BgkqhkiG9w0BAQsFAAOCAQEAeZ8dlsa2eT8ijYfThwMEYGprmi5ZiXMRrEPR9RP/ +jTkrwPK9T3CMqS/qF8QLVJ7UG5aYMzyorWKiAHarWWluBh1+xLlEjZivEtRh2woZ +Rkfz6/djwUAFQKXSt/S1mja/qYh2iARVBCuch38aNzx+LaUa2NSJXsq9rD1s2G2v +1fN2D807iDginWyTmsQ9v4IbZT+mD12q/OWyFcq1rca8PdCE6OoGcrBNOTJ4vz4R +nAuknZoh8/CbCzB428Hch0P+vGOaysXCHMnHjf87ElgI5rY97HosTvuDls4MPGmH +VHOkc8KT/1EQrBVUAdj8BbGJoX90g5pJ19xOe4pIb4tF9g== +-----END CERTIFICATE----- + +# Issuer: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only +# Subject: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only +# Label: "Entrust Root Certification Authority - EC1" +# Serial: 51543124481930649114116133369 +# MD5 Fingerprint: b6:7e:1d:f0:58:c5:49:6c:24:3b:3d:ed:98:18:ed:bc +# SHA1 Fingerprint: 20:d8:06:40:df:9b:25:f5:12:25:3a:11:ea:f7:59:8a:eb:14:b5:47 +# SHA256 Fingerprint: 02:ed:0e:b2:8c:14:da:45:16:5c:56:67:91:70:0d:64:51:d7:fb:56:f0:b2:ab:1d:3b:8e:b0:70:e5:6e:df:f5 +-----BEGIN CERTIFICATE----- +MIIC+TCCAoCgAwIBAgINAKaLeSkAAAAAUNCR+TAKBggqhkjOPQQDAzCBvzELMAkG +A1UEBhMCVVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3 +d3cuZW50cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDEyIEVu +dHJ1c3QsIEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEzMDEGA1UEAxMq +RW50cnVzdCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRUMxMB4XDTEy +MTIxODE1MjUzNloXDTM3MTIxODE1NTUzNlowgb8xCzAJBgNVBAYTAlVTMRYwFAYD +VQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1c3QubmV0 +L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxMiBFbnRydXN0LCBJbmMuIC0g +Zm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMzAxBgNVBAMTKkVudHJ1c3QgUm9vdCBD +ZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEVDMTB2MBAGByqGSM49AgEGBSuBBAAi +A2IABIQTydC6bUF74mzQ61VfZgIaJPRbiWlH47jCffHyAsWfoPZb1YsGGYZPUxBt +ByQnoaD41UcZYUx9ypMn6nQM72+WCf5j7HBdNq1nd67JnXxVRDqiY1Ef9eNi1KlH +Bz7MIKNCMEAwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0O +BBYEFLdj5xrdjekIplWDpOBqUEFlEUJJMAoGCCqGSM49BAMDA2cAMGQCMGF52OVC +R98crlOZF7ZvHH3hvxGU0QOIdeSNiaSKd0bebWHvAvX7td/M/k7//qnmpwIwW5nX +hTcGtXsI/esni0qU+eH6p44mCOh8kmhtc9hvJqwhAriZtyZBWyVgrtBIGu4G +-----END CERTIFICATE----- + +# Issuer: CN=CFCA EV ROOT O=China Financial Certification Authority +# Subject: CN=CFCA EV ROOT O=China Financial Certification Authority +# Label: "CFCA EV ROOT" +# Serial: 407555286 +# MD5 Fingerprint: 74:e1:b6:ed:26:7a:7a:44:30:33:94:ab:7b:27:81:30 +# SHA1 Fingerprint: e2:b8:29:4b:55:84:ab:6b:58:c2:90:46:6c:ac:3f:b8:39:8f:84:83 +# SHA256 Fingerprint: 5c:c3:d7:8e:4e:1d:5e:45:54:7a:04:e6:87:3e:64:f9:0c:f9:53:6d:1c:cc:2e:f8:00:f3:55:c4:c5:fd:70:fd +-----BEGIN CERTIFICATE----- +MIIFjTCCA3WgAwIBAgIEGErM1jANBgkqhkiG9w0BAQsFADBWMQswCQYDVQQGEwJD +TjEwMC4GA1UECgwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9y +aXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJPT1QwHhcNMTIwODA4MDMwNzAxWhcNMjkx +MjMxMDMwNzAxWjBWMQswCQYDVQQGEwJDTjEwMC4GA1UECgwnQ2hpbmEgRmluYW5j +aWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJP +T1QwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDXXWvNED8fBVnVBU03 +sQ7smCuOFR36k0sXgiFxEFLXUWRwFsJVaU2OFW2fvwwbwuCjZ9YMrM8irq93VCpL +TIpTUnrD7i7es3ElweldPe6hL6P3KjzJIx1qqx2hp/Hz7KDVRM8Vz3IvHWOX6Jn5 +/ZOkVIBMUtRSqy5J35DNuF++P96hyk0g1CXohClTt7GIH//62pCfCqktQT+x8Rgp +7hZZLDRJGqgG16iI0gNyejLi6mhNbiyWZXvKWfry4t3uMCz7zEasxGPrb382KzRz +EpR/38wmnvFyXVBlWY9ps4deMm/DGIq1lY+wejfeWkU7xzbh72fROdOXW3NiGUgt +hxwG+3SYIElz8AXSG7Ggo7cbcNOIabla1jj0Ytwli3i/+Oh+uFzJlU9fpy25IGvP +a931DfSCt/SyZi4QKPaXWnuWFo8BGS1sbn85WAZkgwGDg8NNkt0yxoekN+kWzqot +aK8KgWU6cMGbrU1tVMoqLUuFG7OA5nBFDWteNfB/O7ic5ARwiRIlk9oKmSJgamNg +TnYGmE69g60dWIolhdLHZR4tjsbftsbhf4oEIRUpdPA+nJCdDC7xij5aqgwJHsfV +PKPtl8MeNPo4+QgO48BdK4PRVmrJtqhUUy54Mmc9gn900PvhtgVguXDbjgv5E1hv +cWAQUhC5wUEJ73IfZzF4/5YFjQIDAQABo2MwYTAfBgNVHSMEGDAWgBTj/i39KNAL +tbq2osS/BqoFjJP7LzAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAd +BgNVHQ4EFgQU4/4t/SjQC7W6tqLEvwaqBYyT+y8wDQYJKoZIhvcNAQELBQADggIB +ACXGumvrh8vegjmWPfBEp2uEcwPenStPuiB/vHiyz5ewG5zz13ku9Ui20vsXiObT +ej/tUxPQ4i9qecsAIyjmHjdXNYmEwnZPNDatZ8POQQaIxffu2Bq41gt/UP+TqhdL +jOztUmCypAbqTuv0axn96/Ua4CUqmtzHQTb3yHQFhDmVOdYLO6Qn+gjYXB74BGBS +ESgoA//vU2YApUo0FmZ8/Qmkrp5nGm9BC2sGE5uPhnEFtC+NiWYzKXZUmhH4J/qy +P5Hgzg0b8zAarb8iXRvTvyUFTeGSGn+ZnzxEk8rUQElsgIfXBDrDMlI1Dlb4pd19 +xIsNER9Tyx6yF7Zod1rg1MvIB671Oi6ON7fQAUtDKXeMOZePglr4UeWJoBjnaH9d +Ci77o0cOPaYjesYBx4/IXr9tgFa+iiS6M+qf4TIRnvHST4D2G0CvOJ4RUHlzEhLN +5mydLIhyPDCBBpEi6lmt2hkuIsKNuYyH4Ga8cyNfIWRjgEj1oDwYPZTISEEdQLpe +/v5WOaHIz16eGWRGENoXkbcFgKyLmZJ956LYBws2J+dIeWCKw9cTXPhyQN9Ky8+Z +AAoACxGV2lZFA4gKn2fQ1XmxqI1AbQ3CekD6819kR5LLU7m7Wc5P/dAVUwHY3+vZ +5nbv0CO7O6l5s9UCKc2Jo5YPSjXnTkLAdc0Hz+Ys63su +-----END CERTIFICATE----- + +# Issuer: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed +# Subject: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed +# Label: "OISTE WISeKey Global Root GB CA" +# Serial: 157768595616588414422159278966750757568 +# MD5 Fingerprint: a4:eb:b9:61:28:2e:b7:2f:98:b0:35:26:90:99:51:1d +# SHA1 Fingerprint: 0f:f9:40:76:18:d3:d7:6a:4b:98:f0:a8:35:9e:0c:fd:27:ac:cc:ed +# SHA256 Fingerprint: 6b:9c:08:e8:6e:b0:f7:67:cf:ad:65:cd:98:b6:21:49:e5:49:4a:67:f5:84:5e:7b:d1:ed:01:9f:27:b8:6b:d6 +-----BEGIN CERTIFICATE----- +MIIDtTCCAp2gAwIBAgIQdrEgUnTwhYdGs/gjGvbCwDANBgkqhkiG9w0BAQsFADBt +MQswCQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUg +Rm91bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9i +YWwgUm9vdCBHQiBDQTAeFw0xNDEyMDExNTAwMzJaFw0zOTEyMDExNTEwMzFaMG0x +CzAJBgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBG +b3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2Jh +bCBSb290IEdCIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2Be3 +HEokKtaXscriHvt9OO+Y9bI5mE4nuBFde9IllIiCFSZqGzG7qFshISvYD06fWvGx +WuR51jIjK+FTzJlFXHtPrby/h0oLS5daqPZI7H17Dc0hBt+eFf1Biki3IPShehtX +1F1Q/7pn2COZH8g/497/b1t3sWtuuMlk9+HKQUYOKXHQuSP8yYFfTvdv37+ErXNk +u7dCjmn21HYdfp2nuFeKUWdy19SouJVUQHMD9ur06/4oQnc/nSMbsrY9gBQHTC5P +99UKFg29ZkM3fiNDecNAhvVMKdqOmq0NpQSHiB6F4+lT1ZvIiwNjeOvgGUpuuy9r +M2RYk61pv48b74JIxwIDAQABo1EwTzALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUw +AwEB/zAdBgNVHQ4EFgQUNQ/INmNe4qPs+TtmFc5RUuORmj0wEAYJKwYBBAGCNxUB +BAMCAQAwDQYJKoZIhvcNAQELBQADggEBAEBM+4eymYGQfp3FsLAmzYh7KzKNbrgh +cViXfa43FK8+5/ea4n32cZiZBKpDdHij40lhPnOMTZTg+XHEthYOU3gf1qKHLwI5 +gSk8rxWYITD+KJAAjNHhy/peyP34EEY7onhCkRd0VQreUGdNZtGn//3ZwLWoo4rO +ZvUPQ82nK1d7Y0Zqqi5S2PTt4W2tKZB4SLrhI6qjiey1q5bAtEuiHZeeevJuQHHf +aPFlTc58Bd9TZaml8LGXBHAVRgOY1NK/VLSgWH1Sb9pWJmLU2NuJMW8c8CLC02Ic +Nc1MaRVUGpCY3useX8p3x8uOPUNpnJpY0CQ73xtAln41rYHHTnG6iBM= +-----END CERTIFICATE----- + +# Issuer: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A. +# Subject: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A. +# Label: "SZAFIR ROOT CA2" +# Serial: 357043034767186914217277344587386743377558296292 +# MD5 Fingerprint: 11:64:c1:89:b0:24:b1:8c:b1:07:7e:89:9e:51:9e:99 +# SHA1 Fingerprint: e2:52:fa:95:3f:ed:db:24:60:bd:6e:28:f3:9c:cc:cf:5e:b3:3f:de +# SHA256 Fingerprint: a1:33:9d:33:28:1a:0b:56:e5:57:d3:d3:2b:1c:e7:f9:36:7e:b0:94:bd:5f:a7:2a:7e:50:04:c8:de:d7:ca:fe +-----BEGIN CERTIFICATE----- +MIIDcjCCAlqgAwIBAgIUPopdB+xV0jLVt+O2XwHrLdzk1uQwDQYJKoZIhvcNAQEL +BQAwUTELMAkGA1UEBhMCUEwxKDAmBgNVBAoMH0tyYWpvd2EgSXpiYSBSb3psaWN6 +ZW5pb3dhIFMuQS4xGDAWBgNVBAMMD1NaQUZJUiBST09UIENBMjAeFw0xNTEwMTkw +NzQzMzBaFw0zNTEwMTkwNzQzMzBaMFExCzAJBgNVBAYTAlBMMSgwJgYDVQQKDB9L +cmFqb3dhIEl6YmEgUm96bGljemVuaW93YSBTLkEuMRgwFgYDVQQDDA9TWkFGSVIg +Uk9PVCBDQTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC3vD5QqEvN +QLXOYeeWyrSh2gwisPq1e3YAd4wLz32ohswmUeQgPYUM1ljj5/QqGJ3a0a4m7utT +3PSQ1hNKDJA8w/Ta0o4NkjrcsbH/ON7Dui1fgLkCvUqdGw+0w8LBZwPd3BucPbOw +3gAeqDRHu5rr/gsUvTaE2g0gv/pby6kWIK05YO4vdbbnl5z5Pv1+TW9NL++IDWr6 +3fE9biCloBK0TXC5ztdyO4mTp4CEHCdJckm1/zuVnsHMyAHs6A6KCpbns6aH5db5 +BSsNl0BwPLqsdVqc1U2dAgrSS5tmS0YHF2Wtn2yIANwiieDhZNRnvDF5YTy7ykHN +XGoAyDw4jlivAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD +AgEGMB0GA1UdDgQWBBQuFqlKGLXLzPVvUPMjX/hd56zwyDANBgkqhkiG9w0BAQsF +AAOCAQEAtXP4A9xZWx126aMqe5Aosk3AM0+qmrHUuOQn/6mWmc5G4G18TKI4pAZw +8PRBEew/R40/cof5O/2kbytTAOD/OblqBw7rHRz2onKQy4I9EYKL0rufKq8h5mOG +nXkZ7/e7DDWQw4rtTw/1zBLZpD67oPwglV9PJi8RI4NOdQcPv5vRtB3pEAT+ymCP +oky4rc/hkA/NrgrHXXu3UNLUYfrVFdvXn4dRVOul4+vJhaAlIDf7js4MNIThPIGy +d05DpYhfhmehPea0XGG2Ptv+tyjFogeutcrKjSoS75ftwjCkySp6+/NNIxuZMzSg +LvWpCz/UXeHPhJ/iGcJfitYgHuNztw== +-----END CERTIFICATE----- + +# Issuer: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority +# Subject: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority +# Label: "Certum Trusted Network CA 2" +# Serial: 44979900017204383099463764357512596969 +# MD5 Fingerprint: 6d:46:9e:d9:25:6d:08:23:5b:5e:74:7d:1e:27:db:f2 +# SHA1 Fingerprint: d3:dd:48:3e:2b:bf:4c:05:e8:af:10:f5:fa:76:26:cf:d3:dc:30:92 +# SHA256 Fingerprint: b6:76:f2:ed:da:e8:77:5c:d3:6c:b0:f6:3c:d1:d4:60:39:61:f4:9e:62:65:ba:01:3a:2f:03:07:b6:d0:b8:04 +-----BEGIN CERTIFICATE----- +MIIF0jCCA7qgAwIBAgIQIdbQSk8lD8kyN/yqXhKN6TANBgkqhkiG9w0BAQ0FADCB +gDELMAkGA1UEBhMCUEwxIjAgBgNVBAoTGVVuaXpldG8gVGVjaG5vbG9naWVzIFMu +QS4xJzAlBgNVBAsTHkNlcnR1bSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEkMCIG +A1UEAxMbQ2VydHVtIFRydXN0ZWQgTmV0d29yayBDQSAyMCIYDzIwMTExMDA2MDgz +OTU2WhgPMjA0NjEwMDYwODM5NTZaMIGAMQswCQYDVQQGEwJQTDEiMCAGA1UEChMZ +VW5pemV0byBUZWNobm9sb2dpZXMgUy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRp +ZmljYXRpb24gQXV0aG9yaXR5MSQwIgYDVQQDExtDZXJ0dW0gVHJ1c3RlZCBOZXR3 +b3JrIENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC9+Xj45tWA +DGSdhhuWZGc/IjoedQF97/tcZ4zJzFxrqZHmuULlIEub2pt7uZld2ZuAS9eEQCsn +0+i6MLs+CRqnSZXvK0AkwpfHp+6bJe+oCgCXhVqqndwpyeI1B+twTUrWwbNWuKFB +OJvR+zF/j+Bf4bE/D44WSWDXBo0Y+aomEKsq09DRZ40bRr5HMNUuctHFY9rnY3lE +fktjJImGLjQ/KUxSiyqnwOKRKIm5wFv5HdnnJ63/mgKXwcZQkpsCLL2puTRZCr+E +Sv/f/rOf69me4Jgj7KZrdxYq28ytOxykh9xGc14ZYmhFV+SQgkK7QtbwYeDBoz1m +o130GO6IyY0XRSmZMnUCMe4pJshrAua1YkV/NxVaI2iJ1D7eTiew8EAMvE0Xy02i +sx7QBlrd9pPPV3WZ9fqGGmd4s7+W/jTcvedSVuWz5XV710GRBdxdaeOVDUO5/IOW +OZV7bIBaTxNyxtd9KXpEulKkKtVBRgkg/iKgtlswjbyJDNXXcPiHUv3a76xRLgez +Tv7QCdpw75j6VuZt27VXS9zlLCUVyJ4ueE742pyehizKV/Ma5ciSixqClnrDvFAS +adgOWkaLOusm+iPJtrCBvkIApPjW/jAux9JG9uWOdf3yzLnQh1vMBhBgu4M1t15n +3kfsmUjxpKEV/q2MYo45VU85FrmxY53/twIDAQABo0IwQDAPBgNVHRMBAf8EBTAD +AQH/MB0GA1UdDgQWBBS2oVQ5AsOgP46KvPrU+Bym0ToO/TAOBgNVHQ8BAf8EBAMC +AQYwDQYJKoZIhvcNAQENBQADggIBAHGlDs7k6b8/ONWJWsQCYftMxRQXLYtPU2sQ +F/xlhMcQSZDe28cmk4gmb3DWAl45oPePq5a1pRNcgRRtDoGCERuKTsZPpd1iHkTf +CVn0W3cLN+mLIMb4Ck4uWBzrM9DPhmDJ2vuAL55MYIR4PSFk1vtBHxgP58l1cb29 +XN40hz5BsA72udY/CROWFC/emh1auVbONTqwX3BNXuMp8SMoclm2q8KMZiYcdywm +djWLKKdpoPk79SPdhRB0yZADVpHnr7pH1BKXESLjokmUbOe3lEu6LaTaM4tMpkT/ +WjzGHWTYtTHkpjx6qFcL2+1hGsvxznN3Y6SHb0xRONbkX8eftoEq5IVIeVheO/jb +AoJnwTnbw3RLPTYe+SmTiGhbqEQZIfCn6IENLOiTNrQ3ssqwGyZ6miUfmpqAnksq +P/ujmv5zMnHCnsZy4YpoJ/HkD7TETKVhk/iXEAcqMCWpuchxuO9ozC1+9eB+D4Ko +b7a6bINDd82Kkhehnlt4Fj1F4jNy3eFmypnTycUm/Q1oBEauttmbjL4ZvrHG8hnj +XALKLNhvSgfZyTXaQHXyxKcZb55CEJh15pWLYLztxRLXis7VmFxWlgPF7ncGNf/P +5O4/E2Hu29othfDNrp2yGAlFw5Khchf8R7agCyzxxN5DaAhqXzvwdmP7zAYspsbi +DrW5viSP +-----END CERTIFICATE----- + +# Issuer: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority +# Subject: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority +# Label: "Hellenic Academic and Research Institutions RootCA 2015" +# Serial: 0 +# MD5 Fingerprint: ca:ff:e2:db:03:d9:cb:4b:e9:0f:ad:84:fd:7b:18:ce +# SHA1 Fingerprint: 01:0c:06:95:a6:98:19:14:ff:bf:5f:c6:b0:b6:95:ea:29:e9:12:a6 +# SHA256 Fingerprint: a0:40:92:9a:02:ce:53:b4:ac:f4:f2:ff:c6:98:1c:e4:49:6f:75:5e:6d:45:fe:0b:2a:69:2b:cd:52:52:3f:36 +-----BEGIN CERTIFICATE----- +MIIGCzCCA/OgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBpjELMAkGA1UEBhMCR1Ix +DzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5k +IFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxQDA+BgNVBAMT +N0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgUm9v +dENBIDIwMTUwHhcNMTUwNzA3MTAxMTIxWhcNNDAwNjMwMTAxMTIxWjCBpjELMAkG +A1UEBhMCR1IxDzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNh +ZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkx +QDA+BgNVBAMTN0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1 +dGlvbnMgUm9vdENBIDIwMTUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC +AQDC+Kk/G4n8PDwEXT2QNrCROnk8ZlrvbTkBSRq0t89/TSNTt5AA4xMqKKYx8ZEA +4yjsriFBzh/a/X0SWwGDD7mwX5nh8hKDgE0GPt+sr+ehiGsxr/CL0BgzuNtFajT0 +AoAkKAoCFZVedioNmToUW/bLy1O8E00BiDeUJRtCvCLYjqOWXjrZMts+6PAQZe10 +4S+nfK8nNLspfZu2zwnI5dMK/IhlZXQK3HMcXM1AsRzUtoSMTFDPaI6oWa7CJ06C +ojXdFPQf/7J31Ycvqm59JCfnxssm5uX+Zwdj2EUN3TpZZTlYepKZcj2chF6IIbjV +9Cz82XBST3i4vTwri5WY9bPRaM8gFH5MXF/ni+X1NYEZN9cRCLdmvtNKzoNXADrD +gfgXy5I2XdGj2HUb4Ysn6npIQf1FGQatJ5lOwXBH3bWfgVMS5bGMSF0xQxfjjMZ6 +Y5ZLKTBOhE5iGV48zpeQpX8B653g+IuJ3SWYPZK2fu/Z8VFRfS0myGlZYeCsargq +NhEEelC9MoS+L9xy1dcdFkfkR2YgP/SWxa+OAXqlD3pk9Q0Yh9muiNX6hME6wGko +LfINaFGq46V3xqSQDqE3izEjR8EJCOtu93ib14L8hCCZSRm2Ekax+0VVFqmjZayc +Bw/qa9wfLgZy7IaIEuQt218FL+TwA9MmM+eAws1CoRc0CwIDAQABo0IwQDAPBgNV +HRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUcRVnyMjJvXVd +ctA4GGqd83EkVAswDQYJKoZIhvcNAQELBQADggIBAHW7bVRLqhBYRjTyYtcWNl0I +XtVsyIe9tC5G8jH4fOpCtZMWVdyhDBKg2mF+D1hYc2Ryx+hFjtyp8iY/xnmMsVMI +M4GwVhO+5lFc2JsKT0ucVlMC6U/2DWDqTUJV6HwbISHTGzrMd/K4kPFox/la/vot +9L/J9UUbzjgQKjeKeaO04wlshYaT/4mWJ3iBj2fjRnRUjtkNaeJK9E10A/+yd+2V +Z5fkscWrv2oj6NSU4kQoYsRL4vDY4ilrGnB+JGGTe08DMiUNRSQrlrRGar9KC/ea +j8GsGsVn82800vpzY4zvFrCopEYq+OsS7HK07/grfoxSwIuEVPkvPuNVqNxmsdnh +X9izjFk0WaSrT2y7HxjbdavYy5LNlDhhDgcGH0tGEPEVvo2FXDtKK4F5D7Rpn0lQ +l033DlZdwJVqwjbDG2jJ9SrcR5q+ss7FJej6A7na+RZukYT1HCjI/CbM1xyQVqdf +bzoEvM14iQuODy+jqk+iGxI9FghAD/FGTNeqewjBCvVtJ94Cj8rDtSvK6evIIVM4 +pcw72Hc3MKJP2W/R8kCtQXoXxdZKNYm3QdV8hn9VTYNKpXMgwDqvkPGaJI7ZjnHK +e7iG2rKPmT4dEw0SEe7Uq/DpFXYC5ODfqiAeW2GFZECpkJcNrVPSWh2HagCXZWK0 +vm9qp/UsQu0yrbYhnr68 +-----END CERTIFICATE----- + +# Issuer: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority +# Subject: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority +# Label: "Hellenic Academic and Research Institutions ECC RootCA 2015" +# Serial: 0 +# MD5 Fingerprint: 81:e5:b4:17:eb:c2:f5:e1:4b:0d:41:7b:49:92:fe:ef +# SHA1 Fingerprint: 9f:f1:71:8d:92:d5:9a:f3:7d:74:97:b4:bc:6f:84:68:0b:ba:b6:66 +# SHA256 Fingerprint: 44:b5:45:aa:8a:25:e6:5a:73:ca:15:dc:27:fc:36:d2:4c:1c:b9:95:3a:06:65:39:b1:15:82:dc:48:7b:48:33 +-----BEGIN CERTIFICATE----- +MIICwzCCAkqgAwIBAgIBADAKBggqhkjOPQQDAjCBqjELMAkGA1UEBhMCR1IxDzAN +BgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl +c2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxRDBCBgNVBAMTO0hl +bGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgRUNDIFJv +b3RDQSAyMDE1MB4XDTE1MDcwNzEwMzcxMloXDTQwMDYzMDEwMzcxMlowgaoxCzAJ +BgNVBAYTAkdSMQ8wDQYDVQQHEwZBdGhlbnMxRDBCBgNVBAoTO0hlbGxlbmljIEFj +YWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ2VydC4gQXV0aG9yaXR5 +MUQwQgYDVQQDEztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0 +dXRpb25zIEVDQyBSb290Q0EgMjAxNTB2MBAGByqGSM49AgEGBSuBBAAiA2IABJKg +QehLgoRc4vgxEZmGZE4JJS+dQS8KrjVPdJWyUWRrjWvmP3CV8AVER6ZyOFB2lQJa +jq4onvktTpnvLEhvTCUp6NFxW98dwXU3tNf6e3pCnGoKVlp8aQuqgAkkbH7BRqNC +MEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFLQi +C4KZJAEOnLvkDv2/+5cgk5kqMAoGCCqGSM49BAMCA2cAMGQCMGfOFmI4oqxiRaep +lSTAGiecMjvAwNW6qef4BENThe5SId6d9SWDPp5YSy/XZxMOIQIwBeF1Ad5o7Sof +TUwJCA3sS61kFyjndc5FZXIhF8siQQ6ME5g4mlRtm8rifOoCWCKR +-----END CERTIFICATE----- + +# Issuer: CN=ISRG Root X1 O=Internet Security Research Group +# Subject: CN=ISRG Root X1 O=Internet Security Research Group +# Label: "ISRG Root X1" +# Serial: 172886928669790476064670243504169061120 +# MD5 Fingerprint: 0c:d2:f9:e0:da:17:73:e9:ed:86:4d:a5:e3:70:e7:4e +# SHA1 Fingerprint: ca:bd:2a:79:a1:07:6a:31:f2:1d:25:36:35:cb:03:9d:43:29:a5:e8 +# SHA256 Fingerprint: 96:bc:ec:06:26:49:76:f3:74:60:77:9a:cf:28:c5:a7:cf:e8:a3:c0:aa:e1:1a:8f:fc:ee:05:c0:bd:df:08:c6 +-----BEGIN CERTIFICATE----- +MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw +TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh +cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4 +WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu +ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY +MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc +h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+ +0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U +A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW +T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH +B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC +B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv +KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn +OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn +jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw +qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI +rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV +HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq +hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL +ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ +3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK +NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5 +ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur +TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC +jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc +oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq +4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA +mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d +emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc= +-----END CERTIFICATE----- + +# Issuer: O=FNMT-RCM OU=AC RAIZ FNMT-RCM +# Subject: O=FNMT-RCM OU=AC RAIZ FNMT-RCM +# Label: "AC RAIZ FNMT-RCM" +# Serial: 485876308206448804701554682760554759 +# MD5 Fingerprint: e2:09:04:b4:d3:bd:d1:a0:14:fd:1a:d2:47:c4:57:1d +# SHA1 Fingerprint: ec:50:35:07:b2:15:c4:95:62:19:e2:a8:9a:5b:42:99:2c:4c:2c:20 +# SHA256 Fingerprint: eb:c5:57:0c:29:01:8c:4d:67:b1:aa:12:7b:af:12:f7:03:b4:61:1e:bc:17:b7:da:b5:57:38:94:17:9b:93:fa +-----BEGIN CERTIFICATE----- +MIIFgzCCA2ugAwIBAgIPXZONMGc2yAYdGsdUhGkHMA0GCSqGSIb3DQEBCwUAMDsx +CzAJBgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJ +WiBGTk1ULVJDTTAeFw0wODEwMjkxNTU5NTZaFw0zMDAxMDEwMDAwMDBaMDsxCzAJ +BgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJWiBG +Tk1ULVJDTTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALpxgHpMhm5/ +yBNtwMZ9HACXjywMI7sQmkCpGreHiPibVmr75nuOi5KOpyVdWRHbNi63URcfqQgf +BBckWKo3Shjf5TnUV/3XwSyRAZHiItQDwFj8d0fsjz50Q7qsNI1NOHZnjrDIbzAz +WHFctPVrbtQBULgTfmxKo0nRIBnuvMApGGWn3v7v3QqQIecaZ5JCEJhfTzC8PhxF +tBDXaEAUwED653cXeuYLj2VbPNmaUtu1vZ5Gzz3rkQUCwJaydkxNEJY7kvqcfw+Z +374jNUUeAlz+taibmSXaXvMiwzn15Cou08YfxGyqxRxqAQVKL9LFwag0Jl1mpdIC +IfkYtwb1TplvqKtMUejPUBjFd8g5CSxJkjKZqLsXF3mwWsXmo8RZZUc1g16p6DUL +mbvkzSDGm0oGObVo/CK67lWMK07q87Hj/LaZmtVC+nFNCM+HHmpxffnTtOmlcYF7 +wk5HlqX2doWjKI/pgG6BU6VtX7hI+cL5NqYuSf+4lsKMB7ObiFj86xsc3i1w4peS +MKGJ47xVqCfWS+2QrYv6YyVZLag13cqXM7zlzced0ezvXg5KkAYmY6252TUtB7p2 +ZSysV4999AeU14ECll2jB0nVetBX+RvnU0Z1qrB5QstocQjpYL05ac70r8NWQMet +UqIJ5G+GR4of6ygnXYMgrwTJbFaai0b1AgMBAAGjgYMwgYAwDwYDVR0TAQH/BAUw +AwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFPd9xf3E6Jobd2Sn9R2gzL+H +YJptMD4GA1UdIAQ3MDUwMwYEVR0gADArMCkGCCsGAQUFBwIBFh1odHRwOi8vd3d3 +LmNlcnQuZm5tdC5lcy9kcGNzLzANBgkqhkiG9w0BAQsFAAOCAgEAB5BK3/MjTvDD +nFFlm5wioooMhfNzKWtN/gHiqQxjAb8EZ6WdmF/9ARP67Jpi6Yb+tmLSbkyU+8B1 +RXxlDPiyN8+sD8+Nb/kZ94/sHvJwnvDKuO+3/3Y3dlv2bojzr2IyIpMNOmqOFGYM +LVN0V2Ue1bLdI4E7pWYjJ2cJj+F3qkPNZVEI7VFY/uY5+ctHhKQV8Xa7pO6kO8Rf +77IzlhEYt8llvhjho6Tc+hj507wTmzl6NLrTQfv6MooqtyuGC2mDOL7Nii4LcK2N +JpLuHvUBKwrZ1pebbuCoGRw6IYsMHkCtA+fdZn71uSANA+iW+YJF1DngoABd15jm +fZ5nc8OaKveri6E6FO80vFIOiZiaBECEHX5FaZNXzuvO+FB8TxxuBEOb+dY7Ixjp +6o7RTUaN8Tvkasq6+yO3m/qZASlaWFot4/nUbQ4mrcFuNLwy+AwF+mWj2zs3gyLp +1txyM/1d8iC9djwj2ij3+RvrWWTV3F9yfiD8zYm1kGdNYno/Tq0dwzn+evQoFt9B +9kiABdcPUXmsEKvU7ANm5mqwujGSQkBqvjrTcuFqN1W8rB2Vt2lh8kORdOag0wok +RqEIr9baRRmW1FMdW4R58MD3R++Lj8UGrp1MYp3/RgT408m2ECVAdf4WqslKYIYv +uu8wd+RU4riEmViAqhOLUTpPSPaLtrM= +-----END CERTIFICATE----- + +# Issuer: CN=Amazon Root CA 1 O=Amazon +# Subject: CN=Amazon Root CA 1 O=Amazon +# Label: "Amazon Root CA 1" +# Serial: 143266978916655856878034712317230054538369994 +# MD5 Fingerprint: 43:c6:bf:ae:ec:fe:ad:2f:18:c6:88:68:30:fc:c8:e6 +# SHA1 Fingerprint: 8d:a7:f9:65:ec:5e:fc:37:91:0f:1c:6e:59:fd:c1:cc:6a:6e:de:16 +# SHA256 Fingerprint: 8e:cd:e6:88:4f:3d:87:b1:12:5b:a3:1a:c3:fc:b1:3d:70:16:de:7f:57:cc:90:4f:e1:cb:97:c6:ae:98:19:6e +-----BEGIN CERTIFICATE----- +MIIDQTCCAimgAwIBAgITBmyfz5m/jAo54vB4ikPmljZbyjANBgkqhkiG9w0BAQsF +ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6 +b24gUm9vdCBDQSAxMB4XDTE1MDUyNjAwMDAwMFoXDTM4MDExNzAwMDAwMFowOTEL +MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv +b3QgQ0EgMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALJ4gHHKeNXj +ca9HgFB0fW7Y14h29Jlo91ghYPl0hAEvrAIthtOgQ3pOsqTQNroBvo3bSMgHFzZM +9O6II8c+6zf1tRn4SWiw3te5djgdYZ6k/oI2peVKVuRF4fn9tBb6dNqcmzU5L/qw +IFAGbHrQgLKm+a/sRxmPUDgH3KKHOVj4utWp+UhnMJbulHheb4mjUcAwhmahRWa6 +VOujw5H5SNz/0egwLX0tdHA114gk957EWW67c4cX8jJGKLhD+rcdqsq08p8kDi1L +93FcXmn/6pUCyziKrlA4b9v7LWIbxcceVOF34GfID5yHI9Y/QCB/IIDEgEw+OyQm +jgSubJrIqg0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC +AYYwHQYDVR0OBBYEFIQYzIU07LwMlJQuCFmcx7IQTgoIMA0GCSqGSIb3DQEBCwUA +A4IBAQCY8jdaQZChGsV2USggNiMOruYou6r4lK5IpDB/G/wkjUu0yKGX9rbxenDI +U5PMCCjjmCXPI6T53iHTfIUJrU6adTrCC2qJeHZERxhlbI1Bjjt/msv0tadQ1wUs +N+gDS63pYaACbvXy8MWy7Vu33PqUXHeeE6V/Uq2V8viTO96LXFvKWlJbYK8U90vv +o/ufQJVtMVT8QtPHRh8jrdkPSHCa2XV4cdFyQzR1bldZwgJcJmApzyMZFo6IQ6XU +5MsI+yMRQ+hDKXJioaldXgjUkK642M4UwtBV8ob2xJNDd2ZhwLnoQdeXeGADbkpy +rqXRfboQnoZsG4q5WTP468SQvvG5 +-----END CERTIFICATE----- + +# Issuer: CN=Amazon Root CA 2 O=Amazon +# Subject: CN=Amazon Root CA 2 O=Amazon +# Label: "Amazon Root CA 2" +# Serial: 143266982885963551818349160658925006970653239 +# MD5 Fingerprint: c8:e5:8d:ce:a8:42:e2:7a:c0:2a:5c:7c:9e:26:bf:66 +# SHA1 Fingerprint: 5a:8c:ef:45:d7:a6:98:59:76:7a:8c:8b:44:96:b5:78:cf:47:4b:1a +# SHA256 Fingerprint: 1b:a5:b2:aa:8c:65:40:1a:82:96:01:18:f8:0b:ec:4f:62:30:4d:83:ce:c4:71:3a:19:c3:9c:01:1e:a4:6d:b4 +-----BEGIN CERTIFICATE----- +MIIFQTCCAymgAwIBAgITBmyf0pY1hp8KD+WGePhbJruKNzANBgkqhkiG9w0BAQwF +ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6 +b24gUm9vdCBDQSAyMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTEL +MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv +b3QgQ0EgMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK2Wny2cSkxK +gXlRmeyKy2tgURO8TW0G/LAIjd0ZEGrHJgw12MBvIITplLGbhQPDW9tK6Mj4kHbZ +W0/jTOgGNk3Mmqw9DJArktQGGWCsN0R5hYGCrVo34A3MnaZMUnbqQ523BNFQ9lXg +1dKmSYXpN+nKfq5clU1Imj+uIFptiJXZNLhSGkOQsL9sBbm2eLfq0OQ6PBJTYv9K +8nu+NQWpEjTj82R0Yiw9AElaKP4yRLuH3WUnAnE72kr3H9rN9yFVkE8P7K6C4Z9r +2UXTu/Bfh+08LDmG2j/e7HJV63mjrdvdfLC6HM783k81ds8P+HgfajZRRidhW+me +z/CiVX18JYpvL7TFz4QuK/0NURBs+18bvBt+xa47mAExkv8LV/SasrlX6avvDXbR +8O70zoan4G7ptGmh32n2M8ZpLpcTnqWHsFcQgTfJU7O7f/aS0ZzQGPSSbtqDT6Zj +mUyl+17vIWR6IF9sZIUVyzfpYgwLKhbcAS4y2j5L9Z469hdAlO+ekQiG+r5jqFoz +7Mt0Q5X5bGlSNscpb/xVA1wf+5+9R+vnSUeVC06JIglJ4PVhHvG/LopyboBZ/1c6 ++XUyo05f7O0oYtlNc/LMgRdg7c3r3NunysV+Ar3yVAhU/bQtCSwXVEqY0VThUWcI +0u1ufm8/0i2BWSlmy5A5lREedCf+3euvAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMB +Af8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSwDPBMMPQFWAJI/TPlUq9LhONm +UjANBgkqhkiG9w0BAQwFAAOCAgEAqqiAjw54o+Ci1M3m9Zh6O+oAA7CXDpO8Wqj2 +LIxyh6mx/H9z/WNxeKWHWc8w4Q0QshNabYL1auaAn6AFC2jkR2vHat+2/XcycuUY ++gn0oJMsXdKMdYV2ZZAMA3m3MSNjrXiDCYZohMr/+c8mmpJ5581LxedhpxfL86kS +k5Nrp+gvU5LEYFiwzAJRGFuFjWJZY7attN6a+yb3ACfAXVU3dJnJUH/jWS5E4ywl +7uxMMne0nxrpS10gxdr9HIcWxkPo1LsmmkVwXqkLN1PiRnsn/eBG8om3zEK2yygm +btmlyTrIQRNg91CMFa6ybRoVGld45pIq2WWQgj9sAq+uEjonljYE1x2igGOpm/Hl +urR8FLBOybEfdF849lHqm/osohHUqS0nGkWxr7JOcQ3AWEbWaQbLU8uz/mtBzUF+ +fUwPfHJ5elnNXkoOrJupmHN5fLT0zLm4BwyydFy4x2+IoZCn9Kr5v2c69BoVYh63 +n749sSmvZ6ES8lgQGVMDMBu4Gon2nL2XA46jCfMdiyHxtN/kHNGfZQIG6lzWE7OE +76KlXIx3KadowGuuQNKotOrN8I1LOJwZmhsoVLiJkO/KdYE+HvJkJMcYr07/R54H +9jVlpNMKVv/1F2Rs76giJUmTtt8AF9pYfl3uxRuw0dFfIRDH+fO6AgonB8Xx1sfT +4PsJYGw= +-----END CERTIFICATE----- + +# Issuer: CN=Amazon Root CA 3 O=Amazon +# Subject: CN=Amazon Root CA 3 O=Amazon +# Label: "Amazon Root CA 3" +# Serial: 143266986699090766294700635381230934788665930 +# MD5 Fingerprint: a0:d4:ef:0b:f7:b5:d8:49:95:2a:ec:f5:c4:fc:81:87 +# SHA1 Fingerprint: 0d:44:dd:8c:3c:8c:1a:1a:58:75:64:81:e9:0f:2e:2a:ff:b3:d2:6e +# SHA256 Fingerprint: 18:ce:6c:fe:7b:f1:4e:60:b2:e3:47:b8:df:e8:68:cb:31:d0:2e:bb:3a:da:27:15:69:f5:03:43:b4:6d:b3:a4 +-----BEGIN CERTIFICATE----- +MIIBtjCCAVugAwIBAgITBmyf1XSXNmY/Owua2eiedgPySjAKBggqhkjOPQQDAjA5 +MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g +Um9vdCBDQSAzMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG +A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg +Q0EgMzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABCmXp8ZBf8ANm+gBG1bG8lKl +ui2yEujSLtf6ycXYqm0fc4E7O5hrOXwzpcVOho6AF2hiRVd9RFgdszflZwjrZt6j +QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSr +ttvXBp43rDCGB5Fwx5zEGbF4wDAKBggqhkjOPQQDAgNJADBGAiEA4IWSoxe3jfkr +BqWTrBqYaGFy+uGh0PsceGCmQ5nFuMQCIQCcAu/xlJyzlvnrxir4tiz+OpAUFteM +YyRIHN8wfdVoOw== +-----END CERTIFICATE----- + +# Issuer: CN=Amazon Root CA 4 O=Amazon +# Subject: CN=Amazon Root CA 4 O=Amazon +# Label: "Amazon Root CA 4" +# Serial: 143266989758080763974105200630763877849284878 +# MD5 Fingerprint: 89:bc:27:d5:eb:17:8d:06:6a:69:d5:fd:89:47:b4:cd +# SHA1 Fingerprint: f6:10:84:07:d6:f8:bb:67:98:0c:c2:e2:44:c2:eb:ae:1c:ef:63:be +# SHA256 Fingerprint: e3:5d:28:41:9e:d0:20:25:cf:a6:90:38:cd:62:39:62:45:8d:a5:c6:95:fb:de:a3:c2:2b:0b:fb:25:89:70:92 +-----BEGIN CERTIFICATE----- +MIIB8jCCAXigAwIBAgITBmyf18G7EEwpQ+Vxe3ssyBrBDjAKBggqhkjOPQQDAzA5 +MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g +Um9vdCBDQSA0MB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG +A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg +Q0EgNDB2MBAGByqGSM49AgEGBSuBBAAiA2IABNKrijdPo1MN/sGKe0uoe0ZLY7Bi +9i0b2whxIdIA6GO9mif78DluXeo9pcmBqqNbIJhFXRbb/egQbeOc4OO9X4Ri83Bk +M6DLJC9wuoihKqB1+IGuYgbEgds5bimwHvouXKNCMEAwDwYDVR0TAQH/BAUwAwEB +/zAOBgNVHQ8BAf8EBAMCAYYwHQYDVR0OBBYEFNPsxzplbszh2naaVvuc84ZtV+WB +MAoGCCqGSM49BAMDA2gAMGUCMDqLIfG9fhGt0O9Yli/W651+kI0rz2ZVwyzjKKlw +CkcO8DdZEv8tmZQoTipPNU0zWgIxAOp1AE47xDqUEpHJWEadIRNyp4iciuRMStuW +1KyLa2tJElMzrdfkviT8tQp21KW8EA== +-----END CERTIFICATE----- + +# Issuer: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM +# Subject: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM +# Label: "TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1" +# Serial: 1 +# MD5 Fingerprint: dc:00:81:dc:69:2f:3e:2f:b0:3b:f6:3d:5a:91:8e:49 +# SHA1 Fingerprint: 31:43:64:9b:ec:ce:27:ec:ed:3a:3f:0b:8f:0d:e4:e8:91:dd:ee:ca +# SHA256 Fingerprint: 46:ed:c3:68:90:46:d5:3a:45:3f:b3:10:4a:b8:0d:ca:ec:65:8b:26:60:ea:16:29:dd:7e:86:79:90:64:87:16 +-----BEGIN CERTIFICATE----- +MIIEYzCCA0ugAwIBAgIBATANBgkqhkiG9w0BAQsFADCB0jELMAkGA1UEBhMCVFIx +GDAWBgNVBAcTD0dlYnplIC0gS29jYWVsaTFCMEAGA1UEChM5VHVya2l5ZSBCaWxp +bXNlbCB2ZSBUZWtub2xvamlrIEFyYXN0aXJtYSBLdXJ1bXUgLSBUVUJJVEFLMS0w +KwYDVQQLEyRLYW11IFNlcnRpZmlrYXN5b24gTWVya2V6aSAtIEthbXUgU00xNjA0 +BgNVBAMTLVRVQklUQUsgS2FtdSBTTSBTU0wgS29rIFNlcnRpZmlrYXNpIC0gU3Vy +dW0gMTAeFw0xMzExMjUwODI1NTVaFw00MzEwMjUwODI1NTVaMIHSMQswCQYDVQQG +EwJUUjEYMBYGA1UEBxMPR2ViemUgLSBLb2NhZWxpMUIwQAYDVQQKEzlUdXJraXll +IEJpbGltc2VsIHZlIFRla25vbG9qaWsgQXJhc3Rpcm1hIEt1cnVtdSAtIFRVQklU +QUsxLTArBgNVBAsTJEthbXUgU2VydGlmaWthc3lvbiBNZXJrZXppIC0gS2FtdSBT +TTE2MDQGA1UEAxMtVFVCSVRBSyBLYW11IFNNIFNTTCBLb2sgU2VydGlmaWthc2kg +LSBTdXJ1bSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAr3UwM6q7 +a9OZLBI3hNmNe5eA027n/5tQlT6QlVZC1xl8JoSNkvoBHToP4mQ4t4y86Ij5iySr +LqP1N+RAjhgleYN1Hzv/bKjFxlb4tO2KRKOrbEz8HdDc72i9z+SqzvBV96I01INr +N3wcwv61A+xXzry0tcXtAA9TNypN9E8Mg/uGz8v+jE69h/mniyFXnHrfA2eJLJ2X +YacQuFWQfw4tJzh03+f92k4S400VIgLI4OD8D62K18lUUMw7D8oWgITQUVbDjlZ/ +iSIzL+aFCr2lqBs23tPcLG07xxO9WSMs5uWk99gL7eqQQESolbuT1dCANLZGeA4f +AJNG4e7p+exPFwIDAQABo0IwQDAdBgNVHQ4EFgQUZT/HiobGPN08VFw1+DrtUgxH +V8gwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL +BQADggEBACo/4fEyjq7hmFxLXs9rHmoJ0iKpEsdeV31zVmSAhHqT5Am5EM2fKifh +AHe+SMg1qIGf5LgsyX8OsNJLN13qudULXjS99HMpw+0mFZx+CFOKWI3QSyjfwbPf +IPP54+M638yclNhOT8NrF7f3cuitZjO1JVOr4PhMqZ398g26rrnZqsZr+ZO7rqu4 +lzwDGrpDxpa5RXI4s6ehlj2Re37AIVNMh+3yC1SVUZPVIqUNivGTDj5UDrDYyU7c +8jEyVupk+eq1nRZmQnLzf9OxMUP8pI4X8W0jq5Rm+K37DwhuJi1/FwcJsoz7UMCf +lo3Ptv0AnVoUmr8CRPXBwp8iXqIPoeM= +-----END CERTIFICATE----- + +# Issuer: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD. +# Subject: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD. +# Label: "GDCA TrustAUTH R5 ROOT" +# Serial: 9009899650740120186 +# MD5 Fingerprint: 63:cc:d9:3d:34:35:5c:6f:53:a3:e2:08:70:48:1f:b4 +# SHA1 Fingerprint: 0f:36:38:5b:81:1a:25:c3:9b:31:4e:83:ca:e9:34:66:70:cc:74:b4 +# SHA256 Fingerprint: bf:ff:8f:d0:44:33:48:7d:6a:8a:a6:0c:1a:29:76:7a:9f:c2:bb:b0:5e:42:0f:71:3a:13:b9:92:89:1d:38:93 +-----BEGIN CERTIFICATE----- +MIIFiDCCA3CgAwIBAgIIfQmX/vBH6nowDQYJKoZIhvcNAQELBQAwYjELMAkGA1UE +BhMCQ04xMjAwBgNVBAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZ +IENPLixMVEQuMR8wHQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMB4XDTE0 +MTEyNjA1MTMxNVoXDTQwMTIzMTE1NTk1OVowYjELMAkGA1UEBhMCQ04xMjAwBgNV +BAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZIENPLixMVEQuMR8w +HQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMIICIjANBgkqhkiG9w0BAQEF +AAOCAg8AMIICCgKCAgEA2aMW8Mh0dHeb7zMNOwZ+Vfy1YI92hhJCfVZmPoiC7XJj +Dp6L3TQsAlFRwxn9WVSEyfFrs0yw6ehGXTjGoqcuEVe6ghWinI9tsJlKCvLriXBj +TnnEt1u9ol2x8kECK62pOqPseQrsXzrj/e+APK00mxqriCZ7VqKChh/rNYmDf1+u +KU49tm7srsHwJ5uu4/Ts765/94Y9cnrrpftZTqfrlYwiOXnhLQiPzLyRuEH3FMEj +qcOtmkVEs7LXLM3GKeJQEK5cy4KOFxg2fZfmiJqwTTQJ9Cy5WmYqsBebnh52nUpm +MUHfP/vFBu8btn4aRjb3ZGM74zkYI+dndRTVdVeSN72+ahsmUPI2JgaQxXABZG12 +ZuGR224HwGGALrIuL4xwp9E7PLOR5G62xDtw8mySlwnNR30YwPO7ng/Wi64HtloP +zgsMR6flPri9fcebNaBhlzpBdRfMK5Z3KpIhHtmVdiBnaM8Nvd/WHwlqmuLMc3Gk +L30SgLdTMEZeS1SZD2fJpcjyIMGC7J0R38IC+xo70e0gmu9lZJIQDSri3nDxGGeC +jGHeuLzRL5z7D9Ar7Rt2ueQ5Vfj4oR24qoAATILnsn8JuLwwoC8N9VKejveSswoA +HQBUlwbgsQfZxw9cZX08bVlX5O2ljelAU58VS6Bx9hoh49pwBiFYFIeFd3mqgnkC +AwEAAaNCMEAwHQYDVR0OBBYEFOLJQJ9NzuiaoXzPDj9lxSmIahlRMA8GA1UdEwEB +/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQDRSVfg +p8xoWLoBDysZzY2wYUWsEe1jUGn4H3++Fo/9nesLqjJHdtJnJO29fDMylyrHBYZm +DRd9FBUb1Ov9H5r2XpdptxolpAqzkT9fNqyL7FeoPueBihhXOYV0GkLH6VsTX4/5 +COmSdI31R9KrO9b7eGZONn356ZLpBN79SWP8bfsUcZNnL0dKt7n/HipzcEYwv1ry +L3ml4Y0M2fmyYzeMN2WFcGpcWwlyua1jPLHd+PwyvzeG5LuOmCd+uh8W4XAR8gPf +JWIyJyYYMoSf/wA6E7qaTfRPuBRwIrHKK5DOKcFw9C+df/KQHtZa37dG/OaG+svg +IHZ6uqbL9XzeYqWxi+7egmaKTjowHz+Ay60nugxe19CxVsp3cbK1daFQqUBDF8Io +2c9Si1vIY9RCPqAzekYu9wogRlR+ak8x8YF+QnQ4ZXMn7sZ8uI7XpTrXmKGcjBBV +09tL7ECQ8s1uV9JiDnxXk7Gnbc2dg7sq5+W2O3FYrf3RRbxake5TFW/TRQl1brqQ +XR4EzzffHqhmsYzmIGrv/EhOdJhCrylvLmrH+33RZjEizIYAfmaDDEL0vTSSwxrq +T8p+ck0LcIymSLumoRT2+1hEmRSuqguTaaApJUqlyyvdimYHFngVV3Eb7PVHhPOe +MTd61X8kreS8/f3MboPoDKi3QWwH3b08hpcv0g== +-----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" +# Serial: 8875640296558310041 +# MD5 Fingerprint: 86:69:12:c0:70:f1:ec:ac:ac:c2:d5:bc:a5:5b:a1:29 +# SHA1 Fingerprint: b7:ab:33:08:d1:ea:44:77:ba:14:80:12:5a:6f:bd:a9:36:49:0c:bb +# SHA256 Fingerprint: 85:66:6a:56:2e:e0:be:5c:e9:25:c1:d8:89:0a:6f:76:a8:7e:c1:6d:4d:7d:5f:29:ea:74:19:cf:20:12:3b:69 +-----BEGIN CERTIFICATE----- +MIIF3TCCA8WgAwIBAgIIeyyb0xaAMpkwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UE +BhMCVVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQK +DA9TU0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZp +Y2F0aW9uIEF1dGhvcml0eSBSU0EwHhcNMTYwMjEyMTczOTM5WhcNNDEwMjEyMTcz +OTM5WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv +dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNv +bSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTCCAiIwDQYJKoZIhvcN +AQEBBQADggIPADCCAgoCggIBAPkP3aMrfcvQKv7sZ4Wm5y4bunfh4/WvpOz6Sl2R +xFdHaxh3a3by/ZPkPQ/CFp4LZsNWlJ4Xg4XOVu/yFv0AYvUiCVToZRdOQbngT0aX +qhvIuG5iXmmxX9sqAn78bMrzQdjt0Oj8P2FI7bADFB0QDksZ4LtO7IZl/zbzXmcC +C52GVWH9ejjt/uIZALdvoVBidXQ8oPrIJZK0bnoix/geoeOy3ZExqysdBP+lSgQ3 +6YWkMyv94tZVNHwZpEpox7Ko07fKoZOI68GXvIz5HdkihCR0xwQ9aqkpk8zruFvh +/l8lqjRYyMEjVJ0bmBHDOJx+PYZspQ9AhnwC9FwCTyjLrnGfDzrIM/4RJTXq/LrF +YD3ZfBjVsqnTdXgDciLKOsMf7yzlLqn6niy2UUb9rwPW6mBo6oUWNmuF6R7As93E +JNyAKoFBbZQ+yODJgUEAnl6/f8UImKIYLEJAs/lvOCdLToD0PYFH4Ih86hzOtXVc +US4cK38acijnALXRdMbX5J+tB5O2UzU1/Dfkw/ZdFr4hc96SCvigY2q8lpJqPvi8 +ZVWb3vUNiSYE/CUapiVpy8JtynziWV+XrOvvLsi81xtZPCvM8hnIk2snYxnP/Okm ++Mpxm3+T/jRnhE6Z6/yzeAkzcLpmpnbtG3PrGqUNxCITIJRWCk4sbE6x/c+cCbqi +M+2HAgMBAAGjYzBhMB0GA1UdDgQWBBTdBAkHovV6fVJTEpKV7jiAJQ2mWTAPBgNV +HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFN0ECQei9Xp9UlMSkpXuOIAlDaZZMA4G +A1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAIBgRlCn7Jp0cHh5wYfGV +cpNxJK1ok1iOMq8bs3AD/CUrdIWQPXhq9LmLpZc7tRiRux6n+UBbkflVma8eEdBc +Hadm47GUBwwyOabqG7B52B2ccETjit3E+ZUfijhDPwGFpUenPUayvOUiaPd7nNgs +PgohyC0zrL/FgZkxdMF1ccW+sfAjRfSda/wZY52jvATGGAslu1OJD7OAUN5F7kR/ +q5R4ZJjT9ijdh9hwZXT7DrkT66cPYakylszeu+1jTBi7qUD3oFRuIIhxdRjqerQ0 +cuAjJ3dctpDqhiVAq+8zD8ufgr6iIPv2tS0a5sKFsXQP+8hlAqRSAUfdSSLBv9jr +a6x+3uxjMxW3IwiPxg+NQVrdjsW5j+VFP3jbutIbQLH+cU0/4IGiul607BXgk90I +H37hVZkLId6Tngr75qNJvTYw/ud3sqB1l7UtgYgXZSD32pAAn8lSzDLKNXz1PQ/Y +K9f1JmzJBjSWFupwWRoyeXkLtoh/D1JIPb9s2KJELtFOt3JY04kTlf5Eq/jXixtu +nLwsoFvVagCvXzfh1foQC5ichucmj87w7G6KVwuA406ywKBjYZC6VWg3dGq2ktuf +oYYitmUnDuy2n0Jg5GfCtdpBC8TTi2EbvPofkSvXRAdeuims2cXp71NIWuuA8ShY +Ic2wBlX7Jz9TkHCpBB5XJ7k= +-----END CERTIFICATE----- + +# Issuer: CN=SSL.com Root Certification Authority ECC O=SSL Corporation +# Subject: CN=SSL.com Root Certification Authority ECC O=SSL Corporation +# Label: "SSL.com Root Certification Authority ECC" +# Serial: 8495723813297216424 +# MD5 Fingerprint: 2e:da:e4:39:7f:9c:8f:37:d1:70:9f:26:17:51:3a:8e +# SHA1 Fingerprint: c3:19:7c:39:24:e6:54:af:1b:c4:ab:20:95:7a:e2:c3:0e:13:02:6a +# SHA256 Fingerprint: 34:17:bb:06:cc:60:07:da:1b:96:1c:92:0b:8a:b4:ce:3f:ad:82:0e:4a:a3:0b:9a:cb:c4:a7:4e:bd:ce:bc:65 +-----BEGIN CERTIFICATE----- +MIICjTCCAhSgAwIBAgIIdebfy8FoW6gwCgYIKoZIzj0EAwIwfDELMAkGA1UEBhMC +VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T +U0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZpY2F0 +aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNDAzWhcNNDEwMjEyMTgxNDAz +WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0 +b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNvbSBS +b290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49AgEGBSuB +BAAiA2IABEVuqVDEpiM2nl8ojRfLliJkP9x6jh3MCLOicSS6jkm5BBtHllirLZXI +7Z4INcgn64mMU1jrYor+8FsPazFSY0E7ic3s7LaNGdM0B9y7xgZ/wkWV7Mt/qCPg +CemB+vNH06NjMGEwHQYDVR0OBBYEFILRhXMw5zUE044CkvvlpNHEIejNMA8GA1Ud +EwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUgtGFczDnNQTTjgKS++Wk0cQh6M0wDgYD +VR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2cAMGQCMG/n61kRpGDPYbCWe+0F+S8T +kdzt5fxQaxFGRrMcIQBiu77D5+jNB5n5DQtdcj7EqgIwH7y6C+IwJPt8bYBVCpk+ +gA0z5Wajs6O7pdWLjwkspl1+4vAHCGht0nxpbl/f5Wpl +-----END CERTIFICATE----- + +# Issuer: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation +# Subject: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation +# Label: "SSL.com EV Root Certification Authority RSA R2" +# Serial: 6248227494352943350 +# MD5 Fingerprint: e1:1e:31:58:1a:ae:54:53:02:f6:17:6a:11:7b:4d:95 +# SHA1 Fingerprint: 74:3a:f0:52:9b:d0:32:a0:f4:4a:83:cd:d4:ba:a9:7b:7c:2e:c4:9a +# SHA256 Fingerprint: 2e:7b:f1:6c:c2:24:85:a7:bb:e2:aa:86:96:75:07:61:b0:ae:39:be:3b:2f:e9:d0:cc:6d:4e:f7:34:91:42:5c +-----BEGIN CERTIFICATE----- +MIIF6zCCA9OgAwIBAgIIVrYpzTS8ePYwDQYJKoZIhvcNAQELBQAwgYIxCzAJBgNV +BAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UE +CgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQDDC5TU0wuY29tIEVWIFJvb3QgQ2Vy +dGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIyMB4XDTE3MDUzMTE4MTQzN1oXDTQy +MDUzMDE4MTQzN1owgYIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4G +A1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQD +DC5TU0wuY29tIEVWIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIy +MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAjzZlQOHWTcDXtOlG2mvq +M0fNTPl9fb69LT3w23jhhqXZuglXaO1XPqDQCEGD5yhBJB/jchXQARr7XnAjssuf +OePPxU7Gkm0mxnu7s9onnQqG6YE3Bf7wcXHswxzpY6IXFJ3vG2fThVUCAtZJycxa +4bH3bzKfydQ7iEGonL3Lq9ttewkfokxykNorCPzPPFTOZw+oz12WGQvE43LrrdF9 +HSfvkusQv1vrO6/PgN3B0pYEW3p+pKk8OHakYo6gOV7qd89dAFmPZiw+B6KjBSYR +aZfqhbcPlgtLyEDhULouisv3D5oi53+aNxPN8k0TayHRwMwi8qFG9kRpnMphNQcA +b9ZhCBHqurj26bNg5U257J8UZslXWNvNh2n4ioYSA0e/ZhN2rHd9NCSFg83XqpyQ +Gp8hLH94t2S42Oim9HizVcuE0jLEeK6jj2HdzghTreyI/BXkmg3mnxp3zkyPuBQV +PWKchjgGAGYS5Fl2WlPAApiiECtoRHuOec4zSnaqW4EWG7WK2NAAe15itAnWhmMO +pgWVSbooi4iTsjQc2KRVbrcc0N6ZVTsj9CLg+SlmJuwgUHfbSguPvuUCYHBBXtSu +UDkiFCbLsjtzdFVHB3mBOagwE0TlBIqulhMlQg+5U8Sb/M3kHN48+qvWBkofZ6aY +MBzdLNvcGJVXZsb/XItW9XcCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNV +HSMEGDAWgBT5YLvU49U09rj1BoAlp3PbRmmonjAdBgNVHQ4EFgQU+WC71OPVNPa4 +9QaAJadz20ZpqJ4wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQBW +s47LCp1Jjr+kxJG7ZhcFUZh1++VQLHqe8RT6q9OKPv+RKY9ji9i0qVQBDb6Thi/5 +Sm3HXvVX+cpVHBK+Rw82xd9qt9t1wkclf7nxY/hoLVUE0fKNsKTPvDxeH3jnpaAg +cLAExbf3cqfeIg29MyVGjGSSJuM+LmOW2puMPfgYCdcDzH2GguDKBAdRUNf/ktUM +79qGn5nX67evaOI5JpS6aLe/g9Pqemc9YmeuJeVy6OLk7K4S9ksrPJ/psEDzOFSz +/bdoyNrGj1E8svuR3Bznm53htw1yj+KkxKl4+esUrMZDBcJlOSgYAsOCsp0FvmXt +ll9ldDz7CTUue5wT/RsPXcdtgTpWD8w74a8CLyKsRspGPKAcTNZEtF4uXBVmCeEm +Kf7GUmG6sXP/wwyc5WxqlD8UykAWlYTzWamsX0xhk23RO8yilQwipmdnRC652dKK +QbNmC1r7fSOl8hqw/96bg5Qu0T/fkreRrwU7ZcegbLHNYhLDkBvjJc40vG93drEQ +w/cFGsDWr3RiSBd3kmmQYRzelYB0VI8YHMPzA9C/pEN1hlMYegouCRw2n5H9gooi +S9EOUCXdywMMF8mDAAhONU2Ki+3wApRmLER/y5UnlhetCTCstnEXbosX9hwJ1C07 +mKVx01QT2WDz9UtmT/rx7iASjbSsV7FFY6GsdqnC+w== +-----END CERTIFICATE----- + +# Issuer: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation +# Subject: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation +# Label: "SSL.com EV Root Certification Authority ECC" +# Serial: 3182246526754555285 +# MD5 Fingerprint: 59:53:22:65:83:42:01:54:c0:ce:42:b9:5a:7c:f2:90 +# SHA1 Fingerprint: 4c:dd:51:a3:d1:f5:20:32:14:b0:c6:c5:32:23:03:91:c7:46:42:6d +# SHA256 Fingerprint: 22:a2:c1:f7:bd:ed:70:4c:c1:e7:01:b5:f4:08:c3:10:88:0f:e9:56:b5:de:2a:4a:44:f9:9c:87:3a:25:a7:c8 +-----BEGIN CERTIFICATE----- +MIIClDCCAhqgAwIBAgIILCmcWxbtBZUwCgYIKoZIzj0EAwIwfzELMAkGA1UEBhMC +VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T +U0wgQ29ycG9yYXRpb24xNDAyBgNVBAMMK1NTTC5jb20gRVYgUm9vdCBDZXJ0aWZp +Y2F0aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNTIzWhcNNDEwMjEyMTgx +NTIzWjB/MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv +dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjE0MDIGA1UEAwwrU1NMLmNv +bSBFViBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49 +AgEGBSuBBAAiA2IABKoSR5CYG/vvw0AHgyBO8TCCogbR8pKGYfL2IWjKAMTH6kMA +VIbc/R/fALhBYlzccBYy3h+Z1MzFB8gIH2EWB1E9fVwHU+M1OIzfzZ/ZLg1Kthku +WnBaBu2+8KGwytAJKaNjMGEwHQYDVR0OBBYEFFvKXuXe0oGqzagtZFG22XKbl+ZP +MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUW8pe5d7SgarNqC1kUbbZcpuX +5k8wDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2gAMGUCMQCK5kCJN+vp1RPZ +ytRrJPOwPYdGWBrssd9v+1a6cGvHOMzosYxPD/fxZ3YOg9AeUY8CMD32IygmTMZg +h5Mmm7I1HrrW9zzRHM76JTymGoEVW/MSD2zuZYrJh6j5B+BimoxcSg== +-----END CERTIFICATE----- + +# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R6 +# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R6 +# Label: "GlobalSign Root CA - R6" +# Serial: 1417766617973444989252670301619537 +# MD5 Fingerprint: 4f:dd:07:e4:d4:22:64:39:1e:0c:37:42:ea:d1:c6:ae +# SHA1 Fingerprint: 80:94:64:0e:b5:a7:a1:ca:11:9c:1f:dd:d5:9f:81:02:63:a7:fb:d1 +# SHA256 Fingerprint: 2c:ab:ea:fe:37:d0:6c:a2:2a:ba:73:91:c0:03:3d:25:98:29:52:c4:53:64:73:49:76:3a:3a:b5:ad:6c:cf:69 +-----BEGIN CERTIFICATE----- +MIIFgzCCA2ugAwIBAgIORea7A4Mzw4VlSOb/RVEwDQYJKoZIhvcNAQEMBQAwTDEg +MB4GA1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjYxEzARBgNVBAoTCkdsb2Jh +bFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMTQxMjEwMDAwMDAwWhcNMzQx +MjEwMDAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSNjET +MBEGA1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCAiIwDQYJ +KoZIhvcNAQEBBQADggIPADCCAgoCggIBAJUH6HPKZvnsFMp7PPcNCPG0RQssgrRI +xutbPK6DuEGSMxSkb3/pKszGsIhrxbaJ0cay/xTOURQh7ErdG1rG1ofuTToVBu1k +ZguSgMpE3nOUTvOniX9PeGMIyBJQbUJmL025eShNUhqKGoC3GYEOfsSKvGRMIRxD +aNc9PIrFsmbVkJq3MQbFvuJtMgamHvm566qjuL++gmNQ0PAYid/kD3n16qIfKtJw +LnvnvJO7bVPiSHyMEAc4/2ayd2F+4OqMPKq0pPbzlUoSB239jLKJz9CgYXfIWHSw +1CM69106yqLbnQneXUQtkPGBzVeS+n68UARjNN9rkxi+azayOeSsJDa38O+2HBNX +k7besvjihbdzorg1qkXy4J02oW9UivFyVm4uiMVRQkQVlO6jxTiWm05OWgtH8wY2 +SXcwvHE35absIQh1/OZhFj931dmRl4QKbNQCTXTAFO39OfuD8l4UoQSwC+n+7o/h +bguyCLNhZglqsQY6ZZZZwPA1/cnaKI0aEYdwgQqomnUdnjqGBQCe24DWJfncBZ4n +WUx2OVvq+aWh2IMP0f/fMBH5hc8zSPXKbWQULHpYT9NLCEnFlWQaYw55PfWzjMpY +rZxCRXluDocZXFSxZba/jJvcE+kNb7gu3GduyYsRtYQUigAZcIN5kZeR1Bonvzce +MgfYFGM8KEyvAgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTAD +AQH/MB0GA1UdDgQWBBSubAWjkxPioufi1xzWx/B/yGdToDAfBgNVHSMEGDAWgBSu +bAWjkxPioufi1xzWx/B/yGdToDANBgkqhkiG9w0BAQwFAAOCAgEAgyXt6NH9lVLN +nsAEoJFp5lzQhN7craJP6Ed41mWYqVuoPId8AorRbrcWc+ZfwFSY1XS+wc3iEZGt +Ixg93eFyRJa0lV7Ae46ZeBZDE1ZXs6KzO7V33EByrKPrmzU+sQghoefEQzd5Mr61 +55wsTLxDKZmOMNOsIeDjHfrYBzN2VAAiKrlNIC5waNrlU/yDXNOd8v9EDERm8tLj +vUYAGm0CuiVdjaExUd1URhxN25mW7xocBFymFe944Hn+Xds+qkxV/ZoVqW/hpvvf +cDDpw+5CRu3CkwWJ+n1jez/QcYF8AOiYrg54NMMl+68KnyBr3TsTjxKM4kEaSHpz +oHdpx7Zcf4LIHv5YGygrqGytXm3ABdJ7t+uA/iU3/gKbaKxCXcPu9czc8FB10jZp +nOZ7BN9uBmm23goJSFmH63sUYHpkqmlD75HHTOwY3WzvUy2MmeFe8nI+z1TIvWfs +pA9MRf/TuTAjB0yPEL+GltmZWrSZVxykzLsViVO6LAUP5MSeGbEYNNVMnbrt9x+v +JJUEeKgDu+6B5dpffItKoZB0JaezPkvILFa9x8jvOOJckvB595yEunQtYQEgfn7R +8k8HWV+LLUNS60YMlOH1Zkd5d9VUWx+tJDfLRVpOoERIyNiwmcUVhAn21klJwGW4 +5hpxbqCo8YLoRT5s1gLXCmeDBVrJpBA= +-----END CERTIFICATE----- + +# Issuer: CN=OISTE WISeKey Global Root GC CA O=WISeKey OU=OISTE Foundation Endorsed +# Subject: CN=OISTE WISeKey Global Root GC CA O=WISeKey OU=OISTE Foundation Endorsed +# Label: "OISTE WISeKey Global Root GC CA" +# Serial: 44084345621038548146064804565436152554 +# MD5 Fingerprint: a9:d6:b9:2d:2f:93:64:f8:a5:69:ca:91:e9:68:07:23 +# SHA1 Fingerprint: e0:11:84:5e:34:de:be:88:81:b9:9c:f6:16:26:d1:96:1f:c3:b9:31 +# SHA256 Fingerprint: 85:60:f9:1c:36:24:da:ba:95:70:b5:fe:a0:db:e3:6f:f1:1a:83:23:be:94:86:85:4f:b3:f3:4a:55:71:19:8d +-----BEGIN CERTIFICATE----- +MIICaTCCAe+gAwIBAgIQISpWDK7aDKtARb8roi066jAKBggqhkjOPQQDAzBtMQsw +CQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUgRm91 +bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9iYWwg +Um9vdCBHQyBDQTAeFw0xNzA1MDkwOTQ4MzRaFw00MjA1MDkwOTU4MzNaMG0xCzAJ +BgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBGb3Vu +ZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2JhbCBS +b290IEdDIENBMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAETOlQwMYPchi82PG6s4ni +eUqjFqdrVCTbUf/q9Akkwwsin8tqJ4KBDdLArzHkdIJuyiXZjHWd8dvQmqJLIX4W +p2OQ0jnUsYd4XxiWD1AbNTcPasbc2RNNpI6QN+a9WzGRo1QwUjAOBgNVHQ8BAf8E +BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUSIcUrOPDnpBgOtfKie7T +rYy0UGYwEAYJKwYBBAGCNxUBBAMCAQAwCgYIKoZIzj0EAwMDaAAwZQIwJsdpW9zV +57LnyAyMjMPdeYwbY9XJUpROTYJKcx6ygISpJcBMWm1JKWB4E+J+SOtkAjEA2zQg +Mgj/mkkCtojeFK9dbJlxjRo/i9fgojaGHAeCOnZT/cKi7e97sIBPWA9LUzm9 +-----END CERTIFICATE----- + +# Issuer: CN=UCA Global G2 Root O=UniTrust +# Subject: CN=UCA Global G2 Root O=UniTrust +# Label: "UCA Global G2 Root" +# Serial: 124779693093741543919145257850076631279 +# MD5 Fingerprint: 80:fe:f0:c4:4a:f0:5c:62:32:9f:1c:ba:78:a9:50:f8 +# SHA1 Fingerprint: 28:f9:78:16:19:7a:ff:18:25:18:aa:44:fe:c1:a0:ce:5c:b6:4c:8a +# SHA256 Fingerprint: 9b:ea:11:c9:76:fe:01:47:64:c1:be:56:a6:f9:14:b5:a5:60:31:7a:bd:99:88:39:33:82:e5:16:1a:a0:49:3c +-----BEGIN CERTIFICATE----- +MIIFRjCCAy6gAwIBAgIQXd+x2lqj7V2+WmUgZQOQ7zANBgkqhkiG9w0BAQsFADA9 +MQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxGzAZBgNVBAMMElVDQSBH +bG9iYWwgRzIgUm9vdDAeFw0xNjAzMTEwMDAwMDBaFw00MDEyMzEwMDAwMDBaMD0x +CzAJBgNVBAYTAkNOMREwDwYDVQQKDAhVbmlUcnVzdDEbMBkGA1UEAwwSVUNBIEds +b2JhbCBHMiBSb290MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxeYr +b3zvJgUno4Ek2m/LAfmZmqkywiKHYUGRO8vDaBsGxUypK8FnFyIdK+35KYmToni9 +kmugow2ifsqTs6bRjDXVdfkX9s9FxeV67HeToI8jrg4aA3++1NDtLnurRiNb/yzm +VHqUwCoV8MmNsHo7JOHXaOIxPAYzRrZUEaalLyJUKlgNAQLx+hVRZ2zA+te2G3/R +VogvGjqNO7uCEeBHANBSh6v7hn4PJGtAnTRnvI3HLYZveT6OqTwXS3+wmeOwcWDc +C/Vkw85DvG1xudLeJ1uK6NjGruFZfc8oLTW4lVYa8bJYS7cSN8h8s+1LgOGN+jIj +tm+3SJUIsUROhYw6AlQgL9+/V087OpAh18EmNVQg7Mc/R+zvWr9LesGtOxdQXGLY +D0tK3Cv6brxzks3sx1DoQZbXqX5t2Okdj4q1uViSukqSKwxW/YDrCPBeKW4bHAyv +j5OJrdu9o54hyokZ7N+1wxrrFv54NkzWbtA+FxyQF2smuvt6L78RHBgOLXMDj6Dl +NaBa4kx1HXHhOThTeEDMg5PXCp6dW4+K5OXgSORIskfNTip1KnvyIvbJvgmRlld6 +iIis7nCs+dwp4wwcOxJORNanTrAmyPPZGpeRaOrvjUYG0lZFWJo8DA+DuAUlwznP +O6Q0ibd5Ei9Hxeepl2n8pndntd978XplFeRhVmUCAwEAAaNCMEAwDgYDVR0PAQH/ +BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFIHEjMz15DD/pQwIX4wV +ZyF0Ad/fMA0GCSqGSIb3DQEBCwUAA4ICAQATZSL1jiutROTL/7lo5sOASD0Ee/oj +L3rtNtqyzm325p7lX1iPyzcyochltq44PTUbPrw7tgTQvPlJ9Zv3hcU2tsu8+Mg5 +1eRfB70VVJd0ysrtT7q6ZHafgbiERUlMjW+i67HM0cOU2kTC5uLqGOiiHycFutfl +1qnN3e92mI0ADs0b+gO3joBYDic/UvuUospeZcnWhNq5NXHzJsBPd+aBJ9J3O5oU +b3n09tDh05S60FdRvScFDcH9yBIw7m+NESsIndTUv4BFFJqIRNow6rSn4+7vW4LV +PtateJLbXDzz2K36uGt/xDYotgIVilQsnLAXc47QN6MUPJiVAAwpBVueSUmxX8fj +y88nZY41F7dXyDDZQVu5FLbowg+UMaeUmMxq67XhJ/UQqAHojhJi6IjMtX9Gl8Cb +EGY4GjZGXyJoPd/JxhMnq1MGrKI8hgZlb7F+sSlEmqO6SWkoaY/X5V+tBIZkbxqg +DMUIYs6Ao9Dz7GjevjPHF1t/gMRMTLGmhIrDO7gJzRSBuhjjVFc2/tsvfEehOjPI ++Vg7RE+xygKJBJYoaMVLuCaJu9YzL1DV/pqJuhgyklTGW+Cd+V7lDSKb9triyCGy +YiGqhkCyLmTTX8jjfhFnRR8F/uOi77Oos/N9j/gMHyIfLXC0uAE0djAA5SN4p1bX +UB+K+wb1whnw0A== +-----END CERTIFICATE----- + +# Issuer: CN=UCA Extended Validation Root O=UniTrust +# Subject: CN=UCA Extended Validation Root O=UniTrust +# Label: "UCA Extended Validation Root" +# Serial: 106100277556486529736699587978573607008 +# MD5 Fingerprint: a1:f3:5f:43:c6:34:9b:da:bf:8c:7e:05:53:ad:96:e2 +# SHA1 Fingerprint: a3:a1:b0:6f:24:61:23:4a:e3:36:a5:c2:37:fc:a6:ff:dd:f0:d7:3a +# SHA256 Fingerprint: d4:3a:f9:b3:54:73:75:5c:96:84:fc:06:d7:d8:cb:70:ee:5c:28:e7:73:fb:29:4e:b4:1e:e7:17:22:92:4d:24 +-----BEGIN CERTIFICATE----- +MIIFWjCCA0KgAwIBAgIQT9Irj/VkyDOeTzRYZiNwYDANBgkqhkiG9w0BAQsFADBH +MQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNVBAMMHFVDQSBF +eHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwHhcNMTUwMzEzMDAwMDAwWhcNMzgxMjMx +MDAwMDAwWjBHMQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNV +BAMMHFVDQSBFeHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwggIiMA0GCSqGSIb3DQEB +AQUAA4ICDwAwggIKAoICAQCpCQcoEwKwmeBkqh5DFnpzsZGgdT6o+uM4AHrsiWog +D4vFsJszA1qGxliG1cGFu0/GnEBNyr7uaZa4rYEwmnySBesFK5pI0Lh2PpbIILvS +sPGP2KxFRv+qZ2C0d35qHzwaUnoEPQc8hQ2E0B92CvdqFN9y4zR8V05WAT558aop +O2z6+I9tTcg1367r3CTueUWnhbYFiN6IXSV8l2RnCdm/WhUFhvMJHuxYMjMR83dk +sHYf5BA1FxvyDrFspCqjc/wJHx4yGVMR59mzLC52LqGj3n5qiAno8geK+LLNEOfi +c0CTuwjRP+H8C5SzJe98ptfRr5//lpr1kXuYC3fUfugH0mK1lTnj8/FtDw5lhIpj +VMWAtuCeS31HJqcBCF3RiJ7XwzJE+oJKCmhUfzhTA8ykADNkUVkLo4KRel7sFsLz +KuZi2irbWWIQJUoqgQtHB0MGcIfS+pMRKXpITeuUx3BNr2fVUbGAIAEBtHoIppB/ +TuDvB0GHr2qlXov7z1CymlSvw4m6WC31MJixNnI5fkkE/SmnTHnkBVfblLkWU41G +sx2VYVdWf6/wFlthWG82UBEL2KwrlRYaDh8IzTY0ZRBiZtWAXxQgXy0MoHgKaNYs +1+lvK9JKBZP8nm9rZ/+I8U6laUpSNwXqxhaN0sSZ0YIrO7o1dfdRUVjzyAfd5LQD +fwIDAQABo0IwQDAdBgNVHQ4EFgQU2XQ65DA9DfcS3H5aBZ8eNJr34RQwDwYDVR0T +AQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQELBQADggIBADaN +l8xCFWQpN5smLNb7rhVpLGsaGvdftvkHTFnq88nIua7Mui563MD1sC3AO6+fcAUR +ap8lTwEpcOPlDOHqWnzcSbvBHiqB9RZLcpHIojG5qtr8nR/zXUACE/xOHAbKsxSQ +VBcZEhrxH9cMaVr2cXj0lH2RC47skFSOvG+hTKv8dGT9cZr4QQehzZHkPJrgmzI5 +c6sq1WnIeJEmMX3ixzDx/BR4dxIOE/TdFpS/S2d7cFOFyrC78zhNLJA5wA3CXWvp +4uXViI3WLL+rG761KIcSF3Ru/H38j9CHJrAb+7lsq+KePRXBOy5nAliRn+/4Qh8s +t2j1da3Ptfb/EX3C8CSlrdP6oDyp+l3cpaDvRKS+1ujl5BOWF3sGPjLtx7dCvHaj +2GU4Kzg1USEODm8uNBNA4StnDG1KQTAYI1oyVZnJF+A83vbsea0rWBmirSwiGpWO +vpaQXUJXxPkUAzUrHC1RVwinOt4/5Mi0A3PCwSaAuwtCH60NryZy2sy+s6ODWA2C +xR9GUeOcGMyNm43sSet1UNWMKFnKdDTajAshqx7qG+XH/RU+wBeq+yNuJkbL+vmx +cmtpzyKEC2IPrNkZAJSidjzULZrtBJ4tBmIQN1IchXIbJ+XMxjHsN+xjWZsLHXbM +fjKaiJUINlK73nZfdklJrX+9ZSCyycErdhh2n1ax +-----END CERTIFICATE----- + +# Issuer: CN=Certigna Root CA O=Dhimyotis OU=0002 48146308100036 +# Subject: CN=Certigna Root CA O=Dhimyotis OU=0002 48146308100036 +# Label: "Certigna Root CA" +# Serial: 269714418870597844693661054334862075617 +# MD5 Fingerprint: 0e:5c:30:62:27:eb:5b:bc:d7:ae:62:ba:e9:d5:df:77 +# SHA1 Fingerprint: 2d:0d:52:14:ff:9e:ad:99:24:01:74:20:47:6e:6c:85:27:27:f5:43 +# SHA256 Fingerprint: d4:8d:3d:23:ee:db:50:a4:59:e5:51:97:60:1c:27:77:4b:9d:7b:18:c9:4d:5a:05:95:11:a1:02:50:b9:31:68 +-----BEGIN CERTIFICATE----- +MIIGWzCCBEOgAwIBAgIRAMrpG4nxVQMNo+ZBbcTjpuEwDQYJKoZIhvcNAQELBQAw +WjELMAkGA1UEBhMCRlIxEjAQBgNVBAoMCURoaW15b3RpczEcMBoGA1UECwwTMDAw +MiA0ODE0NjMwODEwMDAzNjEZMBcGA1UEAwwQQ2VydGlnbmEgUm9vdCBDQTAeFw0x +MzEwMDEwODMyMjdaFw0zMzEwMDEwODMyMjdaMFoxCzAJBgNVBAYTAkZSMRIwEAYD +VQQKDAlEaGlteW90aXMxHDAaBgNVBAsMEzAwMDIgNDgxNDYzMDgxMDAwMzYxGTAX +BgNVBAMMEENlcnRpZ25hIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAw +ggIKAoICAQDNGDllGlmx6mQWDoyUJJV8g9PFOSbcDO8WV43X2KyjQn+Cyu3NW9sO +ty3tRQgXstmzy9YXUnIo245Onoq2C/mehJpNdt4iKVzSs9IGPjA5qXSjklYcoW9M +CiBtnyN6tMbaLOQdLNyzKNAT8kxOAkmhVECe5uUFoC2EyP+YbNDrihqECB63aCPu +I9Vwzm1RaRDuoXrC0SIxwoKF0vJVdlB8JXrJhFwLrN1CTivngqIkicuQstDuI7pm +TLtipPlTWmR7fJj6o0ieD5Wupxj0auwuA0Wv8HT4Ks16XdG+RCYyKfHx9WzMfgIh +C59vpD++nVPiz32pLHxYGpfhPTc3GGYo0kDFUYqMwy3OU4gkWGQwFsWq4NYKpkDf +ePb1BHxpE4S80dGnBs8B92jAqFe7OmGtBIyT46388NtEbVncSVmurJqZNjBBe3Yz +IoejwpKGbvlw7q6Hh5UbxHq9MfPU0uWZ/75I7HX1eBYdpnDBfzwboZL7z8g81sWT +Co/1VTp2lc5ZmIoJlXcymoO6LAQ6l73UL77XbJuiyn1tJslV1c/DeVIICZkHJC1k +JWumIWmbat10TWuXekG9qxf5kBdIjzb5LdXF2+6qhUVB+s06RbFo5jZMm5BX7CO5 +hwjCxAnxl4YqKE3idMDaxIzb3+KhF1nOJFl0Mdp//TBt2dzhauH8XwIDAQABo4IB +GjCCARYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE +FBiHVuBud+4kNTxOc5of1uHieX4rMB8GA1UdIwQYMBaAFBiHVuBud+4kNTxOc5of +1uHieX4rMEQGA1UdIAQ9MDswOQYEVR0gADAxMC8GCCsGAQUFBwIBFiNodHRwczov +L3d3d3cuY2VydGlnbmEuZnIvYXV0b3JpdGVzLzBtBgNVHR8EZjBkMC+gLaArhilo +dHRwOi8vY3JsLmNlcnRpZ25hLmZyL2NlcnRpZ25hcm9vdGNhLmNybDAxoC+gLYYr +aHR0cDovL2NybC5kaGlteW90aXMuY29tL2NlcnRpZ25hcm9vdGNhLmNybDANBgkq +hkiG9w0BAQsFAAOCAgEAlLieT/DjlQgi581oQfccVdV8AOItOoldaDgvUSILSo3L +6btdPrtcPbEo/uRTVRPPoZAbAh1fZkYJMyjhDSSXcNMQH+pkV5a7XdrnxIxPTGRG +HVyH41neQtGbqH6mid2PHMkwgu07nM3A6RngatgCdTer9zQoKJHyBApPNeNgJgH6 +0BGM+RFq7q89w1DTj18zeTyGqHNFkIwgtnJzFyO+B2XleJINugHA64wcZr+shncB +lA2c5uk5jR+mUYyZDDl34bSb+hxnV29qao6pK0xXeXpXIs/NX2NGjVxZOob4Mkdi +o2cNGJHc+6Zr9UhhcyNZjgKnvETq9Emd8VRY+WCv2hikLyhF3HqgiIZd8zvn/yk1 +gPxkQ5Tm4xxvvq0OKmOZK8l+hfZx6AYDlf7ej0gcWtSS6Cvu5zHbugRqh5jnxV/v +faci9wHYTfmJ0A6aBVmknpjZbyvKcL5kwlWj9Omvw5Ip3IgWJJk8jSaYtlu3zM63 +Nwf9JtmYhST/WSMDmu2dnajkXjjO11INb9I/bbEFa0nOipFGc/T2L/Coc3cOZayh +jWZSaX5LaAzHHjcng6WMxwLkFM1JAbBzs/3GkDpv0mztO+7skb6iQ12LAEpmJURw +3kAP+HwV96LOPNdeE4yBFxgX0b3xdxA61GU5wSesVywlVP+i2k+KYTlerj1KjL0= +-----END CERTIFICATE----- + +# Issuer: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI +# Subject: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI +# Label: "emSign Root CA - G1" +# Serial: 235931866688319308814040 +# MD5 Fingerprint: 9c:42:84:57:dd:cb:0b:a7:2e:95:ad:b6:f3:da:bc:ac +# SHA1 Fingerprint: 8a:c7:ad:8f:73:ac:4e:c1:b5:75:4d:a5:40:f4:fc:cf:7c:b5:8e:8c +# SHA256 Fingerprint: 40:f6:af:03:46:a9:9a:a1:cd:1d:55:5a:4e:9c:ce:62:c7:f9:63:46:03:ee:40:66:15:83:3d:c8:c8:d0:03:67 +-----BEGIN CERTIFICATE----- +MIIDlDCCAnygAwIBAgIKMfXkYgxsWO3W2DANBgkqhkiG9w0BAQsFADBnMQswCQYD +VQQGEwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBU +ZWNobm9sb2dpZXMgTGltaXRlZDEcMBoGA1UEAxMTZW1TaWduIFJvb3QgQ0EgLSBH +MTAeFw0xODAyMTgxODMwMDBaFw00MzAyMTgxODMwMDBaMGcxCzAJBgNVBAYTAklO +MRMwEQYDVQQLEwplbVNpZ24gUEtJMSUwIwYDVQQKExxlTXVkaHJhIFRlY2hub2xv +Z2llcyBMaW1pdGVkMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEcxMIIBIjAN +BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAk0u76WaK7p1b1TST0Bsew+eeuGQz +f2N4aLTNLnF115sgxk0pvLZoYIr3IZpWNVrzdr3YzZr/k1ZLpVkGoZM0Kd0WNHVO +8oG0x5ZOrRkVUkr+PHB1cM2vK6sVmjM8qrOLqs1D/fXqcP/tzxE7lM5OMhbTI0Aq +d7OvPAEsbO2ZLIvZTmmYsvePQbAyeGHWDV/D+qJAkh1cF+ZwPjXnorfCYuKrpDhM +tTk1b+oDafo6VGiFbdbyL0NVHpENDtjVaqSW0RM8LHhQ6DqS0hdW5TUaQBw+jSzt +Od9C4INBdN+jzcKGYEho42kLVACL5HZpIQ15TjQIXhTCzLG3rdd8cIrHhQIDAQAB +o0IwQDAdBgNVHQ4EFgQU++8Nhp6w492pufEhF38+/PB3KxowDgYDVR0PAQH/BAQD +AgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAFn/8oz1h31x +PaOfG1vR2vjTnGs2vZupYeveFix0PZ7mddrXuqe8QhfnPZHr5X3dPpzxz5KsbEjM +wiI/aTvFthUvozXGaCocV685743QNcMYDHsAVhzNixl03r4PEuDQqqE/AjSxcM6d +GNYIAwlG7mDgfrbESQRRfXBgvKqy/3lyeqYdPV8q+Mri/Tm3R7nrft8EI6/6nAYH +6ftjk4BAtcZsCjEozgyfz7MjNYBBjWzEN3uBL4ChQEKF6dk4jeihU80Bv2noWgby +RQuQ+q7hv53yrlc8pa6yVvSLZUDp/TGBLPQ5Cdjua6e0ph0VpZj3AYHYhX3zUVxx +iN66zB+Afko= +-----END CERTIFICATE----- + +# Issuer: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI +# Subject: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI +# Label: "emSign ECC Root CA - G3" +# Serial: 287880440101571086945156 +# MD5 Fingerprint: ce:0b:72:d1:9f:88:8e:d0:50:03:e8:e3:b8:8b:67:40 +# SHA1 Fingerprint: 30:43:fa:4f:f2:57:dc:a0:c3:80:ee:2e:58:ea:78:b2:3f:e6:bb:c1 +# SHA256 Fingerprint: 86:a1:ec:ba:08:9c:4a:8d:3b:be:27:34:c6:12:ba:34:1d:81:3e:04:3c:f9:e8:a8:62:cd:5c:57:a3:6b:be:6b +-----BEGIN CERTIFICATE----- +MIICTjCCAdOgAwIBAgIKPPYHqWhwDtqLhDAKBggqhkjOPQQDAzBrMQswCQYDVQQG +EwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNo +bm9sb2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0g +RzMwHhcNMTgwMjE4MTgzMDAwWhcNNDMwMjE4MTgzMDAwWjBrMQswCQYDVQQGEwJJ +TjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNobm9s +b2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0gRzMw +djAQBgcqhkjOPQIBBgUrgQQAIgNiAAQjpQy4LRL1KPOxst3iAhKAnjlfSU2fySU0 +WXTsuwYc58Byr+iuL+FBVIcUqEqy6HyC5ltqtdyzdc6LBtCGI79G1Y4PPwT01xyS +fvalY8L1X44uT6EYGQIrMgqCZH0Wk9GjQjBAMB0GA1UdDgQWBBR8XQKEE9TMipuB +zhccLikenEhjQjAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggq +hkjOPQQDAwNpADBmAjEAvvNhzwIQHWSVB7gYboiFBS+DCBeQyh+KTOgNG3qxrdWB +CUfvO6wIBHxcmbHtRwfSAjEAnbpV/KlK6O3t5nYBQnvI+GDZjVGLVTv7jHvrZQnD ++JbNR6iC8hZVdyR+EhCVBCyj +-----END CERTIFICATE----- + +# Issuer: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI +# Subject: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI +# Label: "emSign Root CA - C1" +# Serial: 825510296613316004955058 +# MD5 Fingerprint: d8:e3:5d:01:21:fa:78:5a:b0:df:ba:d2:ee:2a:5f:68 +# SHA1 Fingerprint: e7:2e:f1:df:fc:b2:09:28:cf:5d:d4:d5:67:37:b1:51:cb:86:4f:01 +# SHA256 Fingerprint: 12:56:09:aa:30:1d:a0:a2:49:b9:7a:82:39:cb:6a:34:21:6f:44:dc:ac:9f:39:54:b1:42:92:f2:e8:c8:60:8f +-----BEGIN CERTIFICATE----- +MIIDczCCAlugAwIBAgILAK7PALrEzzL4Q7IwDQYJKoZIhvcNAQELBQAwVjELMAkG +A1UEBhMCVVMxEzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEg +SW5jMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEMxMB4XDTE4MDIxODE4MzAw +MFoXDTQzMDIxODE4MzAwMFowVjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln +biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMRwwGgYDVQQDExNlbVNpZ24gUm9v +dCBDQSAtIEMxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz+upufGZ +BczYKCFK83M0UYRWEPWgTywS4/oTmifQz/l5GnRfHXk5/Fv4cI7gklL35CX5VIPZ +HdPIWoU/Xse2B+4+wM6ar6xWQio5JXDWv7V7Nq2s9nPczdcdioOl+yuQFTdrHCZH +3DspVpNqs8FqOp099cGXOFgFixwR4+S0uF2FHYP+eF8LRWgYSKVGczQ7/g/IdrvH +GPMF0Ybzhe3nudkyrVWIzqa2kbBPrH4VI5b2P/AgNBbeCsbEBEV5f6f9vtKppa+c +xSMq9zwhbL2vj07FOrLzNBL834AaSaTUqZX3noleoomslMuoaJuvimUnzYnu3Yy1 +aylwQ6BpC+S5DwIDAQABo0IwQDAdBgNVHQ4EFgQU/qHgcB4qAzlSWkK+XJGFehiq +TbUwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL +BQADggEBAMJKVvoVIXsoounlHfv4LcQ5lkFMOycsxGwYFYDGrK9HWS8mC+M2sO87 +/kOXSTKZEhVb3xEp/6tT+LvBeA+snFOvV71ojD1pM/CjoCNjO2RnIkSt1XHLVip4 +kqNPEjE2NuLe/gDEo2APJ62gsIq1NnpSob0n9CAnYuhNlCQT5AoE6TyrLshDCUrG +YQTlSTR+08TI9Q/Aqum6VF7zYytPT1DU/rl7mYw9wC68AivTxEDkigcxHpvOJpkT ++xHqmiIMERnHXhuBUDDIlhJu58tBf5E7oke3VIAb3ADMmpDqw8NQBmIMMMAVSKeo +WXzhriKi4gp6D/piq1JM4fHfyr6DDUI= +-----END CERTIFICATE----- + +# Issuer: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI +# Subject: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI +# Label: "emSign ECC Root CA - C3" +# Serial: 582948710642506000014504 +# MD5 Fingerprint: 3e:53:b3:a3:81:ee:d7:10:f8:d3:b0:1d:17:92:f5:d5 +# SHA1 Fingerprint: b6:af:43:c2:9b:81:53:7d:f6:ef:6b:c3:1f:1f:60:15:0c:ee:48:66 +# SHA256 Fingerprint: bc:4d:80:9b:15:18:9d:78:db:3e:1d:8c:f4:f9:72:6a:79:5d:a1:64:3c:a5:f1:35:8e:1d:db:0e:dc:0d:7e:b3 +-----BEGIN CERTIFICATE----- +MIICKzCCAbGgAwIBAgIKe3G2gla4EnycqDAKBggqhkjOPQQDAzBaMQswCQYDVQQG +EwJVUzETMBEGA1UECxMKZW1TaWduIFBLSTEUMBIGA1UEChMLZU11ZGhyYSBJbmMx +IDAeBgNVBAMTF2VtU2lnbiBFQ0MgUm9vdCBDQSAtIEMzMB4XDTE4MDIxODE4MzAw +MFoXDTQzMDIxODE4MzAwMFowWjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln +biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMSAwHgYDVQQDExdlbVNpZ24gRUND +IFJvb3QgQ0EgLSBDMzB2MBAGByqGSM49AgEGBSuBBAAiA2IABP2lYa57JhAd6bci +MK4G9IGzsUJxlTm801Ljr6/58pc1kjZGDoeVjbk5Wum739D+yAdBPLtVb4Ojavti +sIGJAnB9SMVK4+kiVCJNk7tCDK93nCOmfddhEc5lx/h//vXyqaNCMEAwHQYDVR0O +BBYEFPtaSNCAIEDyqOkAB2kZd6fmw/TPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMB +Af8EBTADAQH/MAoGCCqGSM49BAMDA2gAMGUCMQC02C8Cif22TGK6Q04ThHK1rt0c +3ta13FaPWEBaLd4gTCKDypOofu4SQMfWh0/434UCMBwUZOR8loMRnLDRWmFLpg9J +0wD8ofzkpf9/rdcw0Md3f76BB1UwUCAU9Vc4CqgxUQ== +-----END CERTIFICATE----- + +# Issuer: CN=Hongkong Post Root CA 3 O=Hongkong Post +# Subject: CN=Hongkong Post Root CA 3 O=Hongkong Post +# Label: "Hongkong Post Root CA 3" +# Serial: 46170865288971385588281144162979347873371282084 +# MD5 Fingerprint: 11:fc:9f:bd:73:30:02:8a:fd:3f:f3:58:b9:cb:20:f0 +# SHA1 Fingerprint: 58:a2:d0:ec:20:52:81:5b:c1:f3:f8:64:02:24:4e:c2:8e:02:4b:02 +# SHA256 Fingerprint: 5a:2f:c0:3f:0c:83:b0:90:bb:fa:40:60:4b:09:88:44:6c:76:36:18:3d:f9:84:6e:17:10:1a:44:7f:b8:ef:d6 +-----BEGIN CERTIFICATE----- +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 +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" +# Serial: 136839042543790627607696632466672567020 +# MD5 Fingerprint: dd:a1:03:e6:4a:93:10:d1:bf:f0:19:42:cb:fe:ed:67 +# SHA1 Fingerprint: 99:9a:64:c3:7f:f4:7d:9f:ab:95:f1:47:69:89:14:60:ee:c4:c3:c5 +# SHA256 Fingerprint: 35:8d:f3:9d:76:4a:f9:e1:b7:66:e9:c9:72:df:35:2e:e1:5c:fa:c2:27:af:6a:d1:d7:0e:8e:4a:6e:dc:ba:02 +-----BEGIN CERTIFICATE----- +MIICWTCCAd+gAwIBAgIQZvI9r4fei7FK6gxXMQHC7DAKBggqhkjOPQQDAzBlMQsw +CQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYD +VQQDEy1NaWNyb3NvZnQgRUNDIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIw +MTcwHhcNMTkxMjE4MjMwNjQ1WhcNNDIwNzE4MjMxNjA0WjBlMQswCQYDVQQGEwJV +UzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1NaWNy +b3NvZnQgRUNDIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwdjAQBgcq +hkjOPQIBBgUrgQQAIgNiAATUvD0CQnVBEyPNgASGAlEvaqiBYgtlzPbKnR5vSmZR +ogPZnZH6thaxjG7efM3beaYvzrvOcS/lpaso7GMEZpn4+vKTEAXhgShC48Zo9OYb +hGBKia/teQ87zvH2RPUBeMCjVDBSMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8E +BTADAQH/MB0GA1UdDgQWBBTIy5lycFIM+Oa+sgRXKSrPQhDtNTAQBgkrBgEEAYI3 +FQEEAwIBADAKBggqhkjOPQQDAwNoADBlAjBY8k3qDPlfXu5gKcs68tvWMoQZP3zV +L8KxzJOuULsJMsbG7X7JNpQS5GiFBqIb0C8CMQCZ6Ra0DvpWSNSkMBaReNtUjGUB +iudQZsIxtzm6uBoiB078a1QWIP8rtedMDE2mT3M= +-----END CERTIFICATE----- + +# Issuer: CN=Microsoft RSA Root Certificate Authority 2017 O=Microsoft Corporation +# Subject: CN=Microsoft RSA Root Certificate Authority 2017 O=Microsoft Corporation +# Label: "Microsoft RSA Root Certificate Authority 2017" +# Serial: 40975477897264996090493496164228220339 +# MD5 Fingerprint: 10:ff:00:ff:cf:c9:f8:c7:7a:c0:ee:35:8e:c9:0f:47 +# SHA1 Fingerprint: 73:a5:e6:4a:3b:ff:83:16:ff:0e:dc:cc:61:8a:90:6e:4e:ae:4d:74 +# SHA256 Fingerprint: c7:41:f7:0f:4b:2a:8d:88:bf:2e:71:c1:41:22:ef:53:ef:10:eb:a0:cf:a5:e6:4c:fa:20:f4:18:85:30:73:e0 +-----BEGIN CERTIFICATE----- +MIIFqDCCA5CgAwIBAgIQHtOXCV/YtLNHcB6qvn9FszANBgkqhkiG9w0BAQwFADBl +MQswCQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYw +NAYDVQQDEy1NaWNyb3NvZnQgUlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5 +IDIwMTcwHhcNMTkxMjE4MjI1MTIyWhcNNDIwNzE4MjMwMDIzWjBlMQswCQYDVQQG +EwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1N +aWNyb3NvZnQgUlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwggIi +MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKW76UM4wplZEWCpW9R2LBifOZ +Nt9GkMml7Xhqb0eRaPgnZ1AzHaGm++DlQ6OEAlcBXZxIQIJTELy/xztokLaCLeX0 +ZdDMbRnMlfl7rEqUrQ7eS0MdhweSE5CAg2Q1OQT85elss7YfUJQ4ZVBcF0a5toW1 +HLUX6NZFndiyJrDKxHBKrmCk3bPZ7Pw71VdyvD/IybLeS2v4I2wDwAW9lcfNcztm +gGTjGqwu+UcF8ga2m3P1eDNbx6H7JyqhtJqRjJHTOoI+dkC0zVJhUXAoP8XFWvLJ +jEm7FFtNyP9nTUwSlq31/niol4fX/V4ggNyhSyL71Imtus5Hl0dVe49FyGcohJUc +aDDv70ngNXtk55iwlNpNhTs+VcQor1fznhPbRiefHqJeRIOkpcrVE7NLP8TjwuaG +YaRSMLl6IE9vDzhTyzMMEyuP1pq9KsgtsRx9S1HKR9FIJ3Jdh+vVReZIZZ2vUpC6 +W6IYZVcSn2i51BVrlMRpIpj0M+Dt+VGOQVDJNE92kKz8OMHY4Xu54+OU4UZpyw4K +UGsTuqwPN1q3ErWQgR5WrlcihtnJ0tHXUeOrO8ZV/R4O03QK0dqq6mm4lyiPSMQH ++FJDOvTKVTUssKZqwJz58oHhEmrARdlns87/I6KJClTUFLkqqNfs+avNJVgyeY+Q +W5g5xAgGwax/Dj0ApQIDAQABo1QwUjAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/ +BAUwAwEB/zAdBgNVHQ4EFgQUCctZf4aycI8awznjwNnpv7tNsiMwEAYJKwYBBAGC +NxUBBAMCAQAwDQYJKoZIhvcNAQEMBQADggIBAKyvPl3CEZaJjqPnktaXFbgToqZC +LgLNFgVZJ8og6Lq46BrsTaiXVq5lQ7GPAJtSzVXNUzltYkyLDVt8LkS/gxCP81OC +gMNPOsduET/m4xaRhPtthH80dK2Jp86519efhGSSvpWhrQlTM93uCupKUY5vVau6 +tZRGrox/2KJQJWVggEbbMwSubLWYdFQl3JPk+ONVFT24bcMKpBLBaYVu32TxU5nh +SnUgnZUP5NbcA/FZGOhHibJXWpS2qdgXKxdJ5XbLwVaZOjex/2kskZGT4d9Mozd2 +TaGf+G0eHdP67Pv0RR0Tbc/3WeUiJ3IrhvNXuzDtJE3cfVa7o7P4NHmJweDyAmH3 +pvwPuxwXC65B2Xy9J6P9LjrRk5Sxcx0ki69bIImtt2dmefU6xqaWM/5TkshGsRGR +xpl/j8nWZjEgQRCHLQzWwa80mMpkg/sTV9HB8Dx6jKXB/ZUhoHHBk2dxEuqPiApp +GWSZI1b7rCoucL5mxAyE7+WL85MB+GqQk2dLsmijtWKP6T+MejteD+eMuMZ87zf9 +dOLITzNy4ZQ5bb0Sr74MTnB8G2+NszKTc0QWbej09+CVgI+WXTik9KveCjCHk9hN +AHFiRSdLOkKEW39lt2c0Ui2cFmuqqNh7o0JMcccMyj6D5KbvtwEwXlGjefVwaaZB +RA+GsCyRxj3qrg+E +-----END CERTIFICATE----- + +# Issuer: CN=e-Szigno Root CA 2017 O=Microsec Ltd. +# Subject: CN=e-Szigno Root CA 2017 O=Microsec Ltd. +# Label: "e-Szigno Root CA 2017" +# Serial: 411379200276854331539784714 +# MD5 Fingerprint: de:1f:f6:9e:84:ae:a7:b4:21:ce:1e:58:7d:d1:84:98 +# SHA1 Fingerprint: 89:d4:83:03:4f:9e:9a:48:80:5f:72:37:d4:a9:a6:ef:cb:7c:1f:d1 +# SHA256 Fingerprint: be:b0:0b:30:83:9b:9b:c3:2c:32:e4:44:79:05:95:06:41:f2:64:21:b1:5e:d0:89:19:8b:51:8a:e2:ea:1b:99 +-----BEGIN CERTIFICATE----- +MIICQDCCAeWgAwIBAgIMAVRI7yH9l1kN9QQKMAoGCCqGSM49BAMCMHExCzAJBgNV +BAYTAkhVMREwDwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UECgwNTWljcm9zZWMgTHRk +LjEXMBUGA1UEYQwOVkFUSFUtMjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3ppZ25vIFJv +b3QgQ0EgMjAxNzAeFw0xNzA4MjIxMjA3MDZaFw00MjA4MjIxMjA3MDZaMHExCzAJ +BgNVBAYTAkhVMREwDwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UECgwNTWljcm9zZWMg +THRkLjEXMBUGA1UEYQwOVkFUSFUtMjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3ppZ25v +IFJvb3QgQ0EgMjAxNzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABJbcPYrYsHtv +xie+RJCxs1YVe45DJH0ahFnuY2iyxl6H0BVIHqiQrb1TotreOpCmYF9oMrWGQd+H +Wyx7xf58etqjYzBhMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G +A1UdDgQWBBSHERUI0arBeAyxr87GyZDvvzAEwDAfBgNVHSMEGDAWgBSHERUI0arB +eAyxr87GyZDvvzAEwDAKBggqhkjOPQQDAgNJADBGAiEAtVfd14pVCzbhhkT61Nlo +jbjcI4qKDdQvfepz7L9NbKgCIQDLpbQS+ue16M9+k/zzNY9vTlp8tLxOsvxyqltZ ++efcMQ== +-----END CERTIFICATE----- + +# Issuer: O=CERTSIGN SA OU=certSIGN ROOT CA G2 +# Subject: O=CERTSIGN SA OU=certSIGN ROOT CA G2 +# Label: "certSIGN Root CA G2" +# Serial: 313609486401300475190 +# MD5 Fingerprint: 8c:f1:75:8a:c6:19:cf:94:b7:f7:65:20:87:c3:97:c7 +# SHA1 Fingerprint: 26:f9:93:b4:ed:3d:28:27:b0:b9:4b:a7:e9:15:1d:a3:8d:92:e5:32 +# SHA256 Fingerprint: 65:7c:fe:2f:a7:3f:aa:38:46:25:71:f3:32:a2:36:3a:46:fc:e7:02:09:51:71:07:02:cd:fb:b6:ee:da:33:05 +-----BEGIN CERTIFICATE----- +MIIFRzCCAy+gAwIBAgIJEQA0tk7GNi02MA0GCSqGSIb3DQEBCwUAMEExCzAJBgNV +BAYTAlJPMRQwEgYDVQQKEwtDRVJUU0lHTiBTQTEcMBoGA1UECxMTY2VydFNJR04g +Uk9PVCBDQSBHMjAeFw0xNzAyMDYwOTI3MzVaFw00MjAyMDYwOTI3MzVaMEExCzAJ +BgNVBAYTAlJPMRQwEgYDVQQKEwtDRVJUU0lHTiBTQTEcMBoGA1UECxMTY2VydFNJ +R04gUk9PVCBDQSBHMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMDF +dRmRfUR0dIf+DjuW3NgBFszuY5HnC2/OOwppGnzC46+CjobXXo9X69MhWf05N0Iw +vlDqtg+piNguLWkh59E3GE59kdUWX2tbAMI5Qw02hVK5U2UPHULlj88F0+7cDBrZ +uIt4ImfkabBoxTzkbFpG583H+u/E7Eu9aqSs/cwoUe+StCmrqzWaTOTECMYmzPhp +n+Sc8CnTXPnGFiWeI8MgwT0PPzhAsP6CRDiqWhqKa2NYOLQV07YRaXseVO6MGiKs +cpc/I1mbySKEwQdPzH/iV8oScLumZfNpdWO9lfsbl83kqK/20U6o2YpxJM02PbyW +xPFsqa7lzw1uKA2wDrXKUXt4FMMgL3/7FFXhEZn91QqhngLjYl/rNUssuHLoPj1P +rCy7Lobio3aP5ZMqz6WryFyNSwb/EkaseMsUBzXgqd+L6a8VTxaJW732jcZZroiF +DsGJ6x9nxUWO/203Nit4ZoORUSs9/1F3dmKh7Gc+PoGD4FapUB8fepmrY7+EF3fx +DTvf95xhszWYijqy7DwaNz9+j5LP2RIUZNoQAhVB/0/E6xyjyfqZ90bp4RjZsbgy +LcsUDFDYg2WD7rlcz8sFWkz6GZdr1l0T08JcVLwyc6B49fFtHsufpaafItzRUZ6C +eWRgKRM+o/1Pcmqr4tTluCRVLERLiohEnMqE0yo7AgMBAAGjQjBAMA8GA1UdEwEB +/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBSCIS1mxteg4BXrzkwJ +d8RgnlRuAzANBgkqhkiG9w0BAQsFAAOCAgEAYN4auOfyYILVAzOBywaK8SJJ6ejq +kX/GM15oGQOGO0MBzwdw5AgeZYWR5hEit/UCI46uuR59H35s5r0l1ZUa8gWmr4UC +b6741jH/JclKyMeKqdmfS0mbEVeZkkMR3rYzpMzXjWR91M08KCy0mpbqTfXERMQl +qiCA2ClV9+BB/AYm/7k29UMUA2Z44RGx2iBfRgB4ACGlHgAoYXhvqAEBj500mv/0 +OJD7uNGzcgbJceaBxXntC6Z58hMLnPddDnskk7RI24Zf3lCGeOdA5jGokHZwYa+c +NywRtYK3qq4kNFtyDGkNzVmf9nGvnAvRCjj5BiKDUyUM/FHE5r7iOZULJK2v0ZXk +ltd0ZGtxTgI8qoXzIKNDOXZbbFD+mpwUHmUUihW9o4JFWklWatKcsWMy5WHgUyIO +pwpJ6st+H6jiYoD2EEVSmAYY3qXNL3+q1Ok+CHLsIwMCPKaq2LxndD0UF/tUSxfj +03k9bWtJySgOLnRQvwzZRjoQhsmnP+mg7H/rpXdYaXHmgwo38oZJar55CJD2AhZk +PuXaTH4MNMn5X7azKFGnpyuqSfqNZSlO42sTp5SjLVFteAxEy9/eCG/Oo2Sr05WE +1LlSVHJ7liXMvGnjSG4N0MedJ5qq+BOS3R7fY581qRY27Iy4g/Q9iY/NtBde17MX +QRBdJ3NghVdJIgc= +-----END CERTIFICATE----- + +# Issuer: CN=Trustwave Global Certification Authority O=Trustwave Holdings, Inc. +# Subject: CN=Trustwave Global Certification Authority O=Trustwave Holdings, Inc. +# Label: "Trustwave Global Certification Authority" +# Serial: 1846098327275375458322922162 +# MD5 Fingerprint: f8:1c:18:2d:2f:ba:5f:6d:a1:6c:bc:c7:ab:91:c7:0e +# SHA1 Fingerprint: 2f:8f:36:4f:e1:58:97:44:21:59:87:a5:2a:9a:d0:69:95:26:7f:b5 +# SHA256 Fingerprint: 97:55:20:15:f5:dd:fc:3c:87:88:c0:06:94:45:55:40:88:94:45:00:84:f1:00:86:70:86:bc:1a:2b:b5:8d:c8 +-----BEGIN CERTIFICATE----- +MIIF2jCCA8KgAwIBAgIMBfcOhtpJ80Y1LrqyMA0GCSqGSIb3DQEBCwUAMIGIMQsw +CQYDVQQGEwJVUzERMA8GA1UECAwISWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28x +ITAfBgNVBAoMGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1 +c3R3YXZlIEdsb2JhbCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0xNzA4MjMx +OTM0MTJaFw00MjA4MjMxOTM0MTJaMIGIMQswCQYDVQQGEwJVUzERMA8GA1UECAwI +SWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28xITAfBgNVBAoMGFRydXN0d2F2ZSBI +b2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1c3R3YXZlIEdsb2JhbCBDZXJ0aWZp +Y2F0aW9uIEF1dGhvcml0eTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIB +ALldUShLPDeS0YLOvR29zd24q88KPuFd5dyqCblXAj7mY2Hf8g+CY66j96xz0Xzn +swuvCAAJWX/NKSqIk4cXGIDtiLK0thAfLdZfVaITXdHG6wZWiYj+rDKd/VzDBcdu +7oaJuogDnXIhhpCujwOl3J+IKMujkkkP7NAP4m1ET4BqstTnoApTAbqOl5F2brz8 +1Ws25kCI1nsvXwXoLG0R8+eyvpJETNKXpP7ScoFDB5zpET71ixpZfR9oWN0EACyW +80OzfpgZdNmcc9kYvkHHNHnZ9GLCQ7mzJ7Aiy/k9UscwR7PJPrhq4ufogXBeQotP +JqX+OsIgbrv4Fo7NDKm0G2x2EOFYeUY+VM6AqFcJNykbmROPDMjWLBz7BegIlT1l +RtzuzWniTY+HKE40Cz7PFNm73bZQmq131BnW2hqIyE4bJ3XYsgjxroMwuREOzYfw +hI0Vcnyh78zyiGG69Gm7DIwLdVcEuE4qFC49DxweMqZiNu5m4iK4BUBjECLzMx10 +coos9TkpoNPnG4CELcU9402x/RpvumUHO1jsQkUm+9jaJXLE9gCxInm943xZYkqc +BW89zubWR2OZxiRvchLIrH+QtAuRcOi35hYQcRfO3gZPSEF9NUqjifLJS3tBEW1n +twiYTOURGa5CgNz7kAXU+FDKvuStx8KU1xad5hePrzb7AgMBAAGjQjBAMA8GA1Ud +EwEB/wQFMAMBAf8wHQYDVR0OBBYEFJngGWcNYtt2s9o9uFvo/ULSMQ6HMA4GA1Ud +DwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAmHNw4rDT7TnsTGDZqRKGFx6W +0OhUKDtkLSGm+J1WE2pIPU/HPinbbViDVD2HfSMF1OQc3Og4ZYbFdada2zUFvXfe +uyk3QAUHw5RSn8pk3fEbK9xGChACMf1KaA0HZJDmHvUqoai7PF35owgLEQzxPy0Q +lG/+4jSHg9bP5Rs1bdID4bANqKCqRieCNqcVtgimQlRXtpla4gt5kNdXElE1GYhB +aCXUNxeEFfsBctyV3lImIJgm4nb1J2/6ADtKYdkNy1GTKv0WBpanI5ojSP5RvbbE +sLFUzt5sQa0WZ37b/TjNuThOssFgy50X31ieemKyJo90lZvkWx3SD92YHJtZuSPT +MaCm/zjdzyBP6VhWOmfD0faZmZ26NraAL4hHT4a/RDqA5Dccprrql5gR0IRiR2Qe +qu5AvzSxnI9O4fKSTx+O856X3vOmeWqJcU9LJxdI/uz0UA9PSX3MReO9ekDFQdxh +VicGaeVyQYHTtgGJoC86cnn+OjC/QezHYj6RS8fZMXZC+fc8Y+wmjHMMfRod6qh8 +h6jCJ3zhM0EPz8/8AKAigJ5Kp28AsEFFtyLKaEjFQqKu3R3y4G5OBVixwJAWKqQ9 +EEC+j2Jjg6mcgn0tAumDMHzLJ8n9HmYAsC7TIS+OMxZsmO0QqAfWzJPP29FpHOTK +yeC2nOnOcXHebD8WpHk= +-----END CERTIFICATE----- + +# Issuer: CN=Trustwave Global ECC P256 Certification Authority O=Trustwave Holdings, Inc. +# Subject: CN=Trustwave Global ECC P256 Certification Authority O=Trustwave Holdings, Inc. +# Label: "Trustwave Global ECC P256 Certification Authority" +# Serial: 4151900041497450638097112925 +# MD5 Fingerprint: 5b:44:e3:8d:5d:36:86:26:e8:0d:05:d2:59:a7:83:54 +# SHA1 Fingerprint: b4:90:82:dd:45:0c:be:8b:5b:b1:66:d3:e2:a4:08:26:cd:ed:42:cf +# SHA256 Fingerprint: 94:5b:bc:82:5e:a5:54:f4:89:d1:fd:51:a7:3d:df:2e:a6:24:ac:70:19:a0:52:05:22:5c:22:a7:8c:cf:a8:b4 +-----BEGIN CERTIFICATE----- +MIICYDCCAgegAwIBAgIMDWpfCD8oXD5Rld9dMAoGCCqGSM49BAMCMIGRMQswCQYD +VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAf +BgNVBAoTGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3 +YXZlIEdsb2JhbCBFQ0MgUDI1NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0x +NzA4MjMxOTM1MTBaFw00MjA4MjMxOTM1MTBaMIGRMQswCQYDVQQGEwJVUzERMA8G +A1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0 +d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBF +Q0MgUDI1NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTBZMBMGByqGSM49AgEGCCqG +SM49AwEHA0IABH77bOYj43MyCMpg5lOcunSNGLB4kFKA3TjASh3RqMyTpJcGOMoN +FWLGjgEqZZ2q3zSRLoHB5DOSMcT9CTqmP62jQzBBMA8GA1UdEwEB/wQFMAMBAf8w +DwYDVR0PAQH/BAUDAwcGADAdBgNVHQ4EFgQUo0EGrJBt0UrrdaVKEJmzsaGLSvcw +CgYIKoZIzj0EAwIDRwAwRAIgB+ZU2g6gWrKuEZ+Hxbb/ad4lvvigtwjzRM4q3wgh +DDcCIC0mA6AFvWvR9lz4ZcyGbbOcNEhjhAnFjXca4syc4XR7 +-----END CERTIFICATE----- + +# Issuer: CN=Trustwave Global ECC P384 Certification Authority O=Trustwave Holdings, Inc. +# Subject: CN=Trustwave Global ECC P384 Certification Authority O=Trustwave Holdings, Inc. +# Label: "Trustwave Global ECC P384 Certification Authority" +# Serial: 2704997926503831671788816187 +# MD5 Fingerprint: ea:cf:60:c4:3b:b9:15:29:40:a1:97:ed:78:27:93:d6 +# SHA1 Fingerprint: e7:f3:a3:c8:cf:6f:c3:04:2e:6d:0e:67:32:c5:9e:68:95:0d:5e:d2 +# SHA256 Fingerprint: 55:90:38:59:c8:c0:c3:eb:b8:75:9e:ce:4e:25:57:22:5f:f5:75:8b:bd:38:eb:d4:82:76:60:1e:1b:d5:80:97 +-----BEGIN CERTIFICATE----- +MIICnTCCAiSgAwIBAgIMCL2Fl2yZJ6SAaEc7MAoGCCqGSM49BAMDMIGRMQswCQYD +VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAf +BgNVBAoTGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3 +YXZlIEdsb2JhbCBFQ0MgUDM4NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0x +NzA4MjMxOTM2NDNaFw00MjA4MjMxOTM2NDNaMIGRMQswCQYDVQQGEwJVUzERMA8G +A1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0 +d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBF +Q0MgUDM4NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTB2MBAGByqGSM49AgEGBSuB +BAAiA2IABGvaDXU1CDFHBa5FmVXxERMuSvgQMSOjfoPTfygIOiYaOs+Xgh+AtycJ +j9GOMMQKmw6sWASr9zZ9lCOkmwqKi6vr/TklZvFe/oyujUF5nQlgziip04pt89ZF +1PKYhDhloKNDMEEwDwYDVR0TAQH/BAUwAwEB/zAPBgNVHQ8BAf8EBQMDBwYAMB0G +A1UdDgQWBBRVqYSJ0sEyvRjLbKYHTsjnnb6CkDAKBggqhkjOPQQDAwNnADBkAjA3 +AZKXRRJ+oPM+rRk6ct30UJMDEr5E0k9BpIycnR+j9sKS50gU/k6bpZFXrsY3crsC +MGclCrEMXu6pY5Jv5ZAL/mYiykf9ijH3g/56vxC+GCsej/YpHpRZ744hN8tRmKVu +Sw== +-----END CERTIFICATE----- + +# Issuer: CN=NAVER Global Root Certification Authority O=NAVER BUSINESS PLATFORM Corp. +# Subject: CN=NAVER Global Root Certification Authority O=NAVER BUSINESS PLATFORM Corp. +# Label: "NAVER Global Root Certification Authority" +# Serial: 9013692873798656336226253319739695165984492813 +# MD5 Fingerprint: c8:7e:41:f6:25:3b:f5:09:b3:17:e8:46:3d:bf:d0:9b +# SHA1 Fingerprint: 8f:6b:f2:a9:27:4a:da:14:a0:c4:f4:8e:61:27:f9:c0:1e:78:5d:d1 +# SHA256 Fingerprint: 88:f4:38:dc:f8:ff:d1:fa:8f:42:91:15:ff:e5:f8:2a:e1:e0:6e:0c:70:c3:75:fa:ad:71:7b:34:a4:9e:72:65 +-----BEGIN CERTIFICATE----- +MIIFojCCA4qgAwIBAgIUAZQwHqIL3fXFMyqxQ0Rx+NZQTQ0wDQYJKoZIhvcNAQEM +BQAwaTELMAkGA1UEBhMCS1IxJjAkBgNVBAoMHU5BVkVSIEJVU0lORVNTIFBMQVRG +T1JNIENvcnAuMTIwMAYDVQQDDClOQVZFUiBHbG9iYWwgUm9vdCBDZXJ0aWZpY2F0 +aW9uIEF1dGhvcml0eTAeFw0xNzA4MTgwODU4NDJaFw0zNzA4MTgyMzU5NTlaMGkx +CzAJBgNVBAYTAktSMSYwJAYDVQQKDB1OQVZFUiBCVVNJTkVTUyBQTEFURk9STSBD +b3JwLjEyMDAGA1UEAwwpTkFWRVIgR2xvYmFsIFJvb3QgQ2VydGlmaWNhdGlvbiBB +dXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC21PGTXLVA +iQqrDZBbUGOukJR0F0Vy1ntlWilLp1agS7gvQnXp2XskWjFlqxcX0TM62RHcQDaH +38dq6SZeWYp34+hInDEW+j6RscrJo+KfziFTowI2MMtSAuXaMl3Dxeb57hHHi8lE +HoSTGEq0n+USZGnQJoViAbbJAh2+g1G7XNr4rRVqmfeSVPc0W+m/6imBEtRTkZaz +kVrd/pBzKPswRrXKCAfHcXLJZtM0l/aM9BhK4dA9WkW2aacp+yPOiNgSnABIqKYP +szuSjXEOdMWLyEz59JuOuDxp7W87UC9Y7cSw0BwbagzivESq2M0UXZR4Yb8Obtoq +vC8MC3GmsxY/nOb5zJ9TNeIDoKAYv7vxvvTWjIcNQvcGufFt7QSUqP620wbGQGHf +nZ3zVHbOUzoBppJB7ASjjw2i1QnK1sua8e9DXcCrpUHPXFNwcMmIpi3Ua2FzUCaG +YQ5fG8Ir4ozVu53BA0K6lNpfqbDKzE0K70dpAy8i+/Eozr9dUGWokG2zdLAIx6yo +0es+nPxdGoMuK8u180SdOqcXYZaicdNwlhVNt0xz7hlcxVs+Qf6sdWA7G2POAN3a +CJBitOUt7kinaxeZVL6HSuOpXgRM6xBtVNbv8ejyYhbLgGvtPe31HzClrkvJE+2K +AQHJuFFYwGY6sWZLxNUxAmLpdIQM201GLQIDAQABo0IwQDAdBgNVHQ4EFgQU0p+I +36HNLL3s9TsBAZMzJ7LrYEswDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMB +Af8wDQYJKoZIhvcNAQEMBQADggIBADLKgLOdPVQG3dLSLvCkASELZ0jKbY7gyKoN +qo0hV4/GPnrK21HUUrPUloSlWGB/5QuOH/XcChWB5Tu2tyIvCZwTFrFsDDUIbatj +cu3cvuzHV+YwIHHW1xDBE1UBjCpD5EHxzzp6U5LOogMFDTjfArsQLtk70pt6wKGm ++LUx5vR1yblTmXVHIloUFcd4G7ad6Qz4G3bxhYTeodoS76TiEJd6eN4MUZeoIUCL +hr0N8F5OSza7OyAfikJW4Qsav3vQIkMsRIz75Sq0bBwcupTgE34h5prCy8VCZLQe +lHsIJchxzIdFV4XTnyliIoNRlwAYl3dqmJLJfGBs32x9SuRwTMKeuB330DTHD8z7 +p/8Dvq1wkNoL3chtl1+afwkyQf3NosxabUzyqkn+Zvjp2DXrDige7kgvOtB5CTh8 +piKCk5XQA76+AqAF3SAi428diDRgxuYKuQl1C/AH6GmWNcf7I4GOODm4RStDeKLR +LBT/DShycpWbXgnbiUSYqqFJu3FS8r/2/yehNq+4tneI3TqkbZs0kNwUXTC/t+sX +5Ie3cdCh13cV1ELX8vMxmV2b3RZtP+oGI/hGoiLtk/bdmuYqh7GYVPEi92tF4+KO +dh2ajcQGjTa3FPOdVGm3jjzVpG2Tgbet9r1ke8LJaDmgkpzNNIaRkPpkUZ3+/uul +9XXeifdy +-----END CERTIFICATE----- + +# Issuer: CN=AC RAIZ FNMT-RCM SERVIDORES SEGUROS O=FNMT-RCM OU=Ceres +# Subject: CN=AC RAIZ FNMT-RCM SERVIDORES SEGUROS O=FNMT-RCM OU=Ceres +# Label: "AC RAIZ FNMT-RCM SERVIDORES SEGUROS" +# Serial: 131542671362353147877283741781055151509 +# MD5 Fingerprint: 19:36:9c:52:03:2f:d2:d1:bb:23:cc:dd:1e:12:55:bb +# SHA1 Fingerprint: 62:ff:d9:9e:c0:65:0d:03:ce:75:93:d2:ed:3f:2d:32:c9:e3:e5:4a +# SHA256 Fingerprint: 55:41:53:b1:3d:2c:f9:dd:b7:53:bf:be:1a:4e:0a:e0:8d:0a:a4:18:70:58:fe:60:a2:b8:62:b2:e4:b8:7b:cb +-----BEGIN CERTIFICATE----- +MIICbjCCAfOgAwIBAgIQYvYybOXE42hcG2LdnC6dlTAKBggqhkjOPQQDAzB4MQsw +CQYDVQQGEwJFUzERMA8GA1UECgwIRk5NVC1SQ00xDjAMBgNVBAsMBUNlcmVzMRgw +FgYDVQRhDA9WQVRFUy1RMjgyNjAwNEoxLDAqBgNVBAMMI0FDIFJBSVogRk5NVC1S +Q00gU0VSVklET1JFUyBTRUdVUk9TMB4XDTE4MTIyMDA5MzczM1oXDTQzMTIyMDA5 +MzczM1oweDELMAkGA1UEBhMCRVMxETAPBgNVBAoMCEZOTVQtUkNNMQ4wDAYDVQQL +DAVDZXJlczEYMBYGA1UEYQwPVkFURVMtUTI4MjYwMDRKMSwwKgYDVQQDDCNBQyBS +QUlaIEZOTVQtUkNNIFNFUlZJRE9SRVMgU0VHVVJPUzB2MBAGByqGSM49AgEGBSuB +BAAiA2IABPa6V1PIyqvfNkpSIeSX0oNnnvBlUdBeh8dHsVnyV0ebAAKTRBdp20LH +sbI6GA60XYyzZl2hNPk2LEnb80b8s0RpRBNm/dfF/a82Tc4DTQdxz69qBdKiQ1oK +Um8BA06Oi6NCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYD +VR0OBBYEFAG5L++/EYZg8k/QQW6rcx/n0m5JMAoGCCqGSM49BAMDA2kAMGYCMQCu +SuMrQMN0EfKVrRYj3k4MGuZdpSRea0R7/DjiT8ucRRcRTBQnJlU5dUoDzBOQn5IC +MQD6SmxgiHPz7riYYqnOK8LZiqZwMR2vsJRM60/G49HzYqc8/5MuB1xJAWdpEgJy +v+c= +-----END CERTIFICATE----- + +# Issuer: CN=GlobalSign Root R46 O=GlobalSign nv-sa +# Subject: CN=GlobalSign Root R46 O=GlobalSign nv-sa +# Label: "GlobalSign Root R46" +# Serial: 1552617688466950547958867513931858518042577 +# MD5 Fingerprint: c4:14:30:e4:fa:66:43:94:2a:6a:1b:24:5f:19:d0:ef +# SHA1 Fingerprint: 53:a2:b0:4b:ca:6b:d6:45:e6:39:8a:8e:c4:0d:d2:bf:77:c3:a2:90 +# SHA256 Fingerprint: 4f:a3:12:6d:8d:3a:11:d1:c4:85:5a:4f:80:7c:ba:d6:cf:91:9d:3a:5a:88:b0:3b:ea:2c:63:72:d9:3c:40:c9 +-----BEGIN CERTIFICATE----- +MIIFWjCCA0KgAwIBAgISEdK7udcjGJ5AXwqdLdDfJWfRMA0GCSqGSIb3DQEBDAUA +MEYxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYD +VQQDExNHbG9iYWxTaWduIFJvb3QgUjQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMy +MDAwMDAwMFowRjELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYt +c2ExHDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEB +AQUAA4ICDwAwggIKAoICAQCsrHQy6LNl5brtQyYdpokNRbopiLKkHWPd08EsCVeJ +OaFV6Wc0dwxu5FUdUiXSE2te4R2pt32JMl8Nnp8semNgQB+msLZ4j5lUlghYruQG +vGIFAha/r6gjA7aUD7xubMLL1aa7DOn2wQL7Id5m3RerdELv8HQvJfTqa1VbkNud +316HCkD7rRlr+/fKYIje2sGP1q7Vf9Q8g+7XFkyDRTNrJ9CG0Bwta/OrffGFqfUo +0q3v84RLHIf8E6M6cqJaESvWJ3En7YEtbWaBkoe0G1h6zD8K+kZPTXhc+CtI4wSE +y132tGqzZfxCnlEmIyDLPRT5ge1lFgBPGmSXZgjPjHvjK8Cd+RTyG/FWaha/LIWF +zXg4mutCagI0GIMXTpRW+LaCtfOW3T3zvn8gdz57GSNrLNRyc0NXfeD412lPFzYE ++cCQYDdF3uYM2HSNrpyibXRdQr4G9dlkbgIQrImwTDsHTUB+JMWKmIJ5jqSngiCN +I/onccnfxkF0oE32kRbcRoxfKWMxWXEM2G/CtjJ9++ZdU6Z+Ffy7dXxd7Pj2Fxzs +x2sZy/N78CsHpdlseVR2bJ0cpm4O6XkMqCNqo98bMDGfsVR7/mrLZqrcZdCinkqa +ByFrgY/bxFn63iLABJzjqls2k+g9vXqhnQt2sQvHnf3PmKgGwvgqo6GDoLclcqUC +4wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV +HQ4EFgQUA1yrc4GHqMywptWU4jaWSf8FmSwwDQYJKoZIhvcNAQEMBQADggIBAHx4 +7PYCLLtbfpIrXTncvtgdokIzTfnvpCo7RGkerNlFo048p9gkUbJUHJNOxO97k4Vg +JuoJSOD1u8fpaNK7ajFxzHmuEajwmf3lH7wvqMxX63bEIaZHU1VNaL8FpO7XJqti +2kM3S+LGteWygxk6x9PbTZ4IevPuzz5i+6zoYMzRx6Fcg0XERczzF2sUyQQCPtIk +pnnpHs6i58FZFZ8d4kuaPp92CC1r2LpXFNqD6v6MVenQTqnMdzGxRBF6XLE+0xRF +FRhiJBPSy03OXIPBNvIQtQ6IbbjhVp+J3pZmOUdkLG5NrmJ7v2B0GbhWrJKsFjLt +rWhV/pi60zTe9Mlhww6G9kuEYO4Ne7UyWHmRVSyBQ7N0H3qqJZ4d16GLuc1CLgSk +ZoNNiTW2bKg2SnkheCLQQrzRQDGQob4Ez8pn7fXwgNNgyYMqIgXQBztSvwyeqiv5 +u+YfjyW6hY0XHgL+XVAEV8/+LbzvXMAaq7afJMbfc2hIkCwU9D9SGuTSyxTDYWnP +4vkYxboznxSjBF25cfe1lNj2M8FawTSLfJvdkzrnE6JwYZ+vj+vYxXX4M2bUdGc6 +N3ec592kD3ZDZopD8p/7DEJ4Y9HiD2971KE9dJeFt0g5QdYg/NA6s/rob8SKunE3 +vouXsXgxT7PntgMTzlSdriVZzH81Xwj3QEUxeCp6 +-----END CERTIFICATE----- + +# Issuer: CN=GlobalSign Root E46 O=GlobalSign nv-sa +# Subject: CN=GlobalSign Root E46 O=GlobalSign nv-sa +# Label: "GlobalSign Root E46" +# Serial: 1552617690338932563915843282459653771421763 +# MD5 Fingerprint: b5:b8:66:ed:de:08:83:e3:c9:e2:01:34:06:ac:51:6f +# SHA1 Fingerprint: 39:b4:6c:d5:fe:80:06:eb:e2:2f:4a:bb:08:33:a0:af:db:b9:dd:84 +# SHA256 Fingerprint: cb:b9:c4:4d:84:b8:04:3e:10:50:ea:31:a6:9f:51:49:55:d7:bf:d2:e2:c6:b4:93:01:01:9a:d6:1d:9f:50:58 +-----BEGIN CERTIFICATE----- +MIICCzCCAZGgAwIBAgISEdK7ujNu1LzmJGjFDYQdmOhDMAoGCCqGSM49BAMDMEYx +CzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYDVQQD +ExNHbG9iYWxTaWduIFJvb3QgRTQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMyMDAw +MDAwMFowRjELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2Ex +HDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBFNDYwdjAQBgcqhkjOPQIBBgUrgQQA +IgNiAAScDrHPt+ieUnd1NPqlRqetMhkytAepJ8qUuwzSChDH2omwlwxwEwkBjtjq +R+q+soArzfwoDdusvKSGN+1wCAB16pMLey5SnCNoIwZD7JIvU4Tb+0cUB+hflGdd +yXqBPCCjQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud +DgQWBBQxCpCPtsad0kRLgLWi5h+xEk8blTAKBggqhkjOPQQDAwNoADBlAjEA31SQ +7Zvvi5QCkxeCmb6zniz2C5GMn0oUsfZkvLtoURMMA/cVi4RguYv/Uo7njLwcAjA8 ++RHUjE7AwWHCFUyqqx0LMV87HOIAl0Qx5v5zli/altP+CAezNIm8BZ/3Hobui3A= +-----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" +# Serial: 996390341000653745 +# MD5 Fingerprint: 26:a6:44:5a:d9:af:4e:2f:b2:1d:b6:65:b0:4e:e8:96 +# SHA1 Fingerprint: 5b:6e:68:d0:cc:15:b6:a0:5f:1e:c1:5f:ae:02:fc:6b:2f:5d:6f:74 +# SHA256 Fingerprint: fb:8f:ec:75:91:69:b9:10:6b:1e:51:16:44:c6:18:c5:13:04:37:3f:6c:06:43:08:8d:8b:ef:fd:1b:99:75:99 +-----BEGIN CERTIFICATE----- +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 +-----END CERTIFICATE----- + +# Issuer: CN=Certum EC-384 CA O=Asseco Data Systems S.A. OU=Certum Certification Authority +# Subject: CN=Certum EC-384 CA O=Asseco Data Systems S.A. OU=Certum Certification Authority +# Label: "Certum EC-384 CA" +# Serial: 160250656287871593594747141429395092468 +# MD5 Fingerprint: b6:65:b3:96:60:97:12:a1:ec:4e:e1:3d:a3:c6:c9:f1 +# SHA1 Fingerprint: f3:3e:78:3c:ac:df:f4:a2:cc:ac:67:55:69:56:d7:e5:16:3c:e1:ed +# SHA256 Fingerprint: 6b:32:80:85:62:53:18:aa:50:d1:73:c9:8d:8b:da:09:d5:7e:27:41:3d:11:4c:f7:87:a0:f5:d0:6c:03:0c:f6 +-----BEGIN CERTIFICATE----- +MIICZTCCAeugAwIBAgIQeI8nXIESUiClBNAt3bpz9DAKBggqhkjOPQQDAzB0MQsw +CQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBTLkEuMScw +JQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxGTAXBgNVBAMT +EENlcnR1bSBFQy0zODQgQ0EwHhcNMTgwMzI2MDcyNDU0WhcNNDMwMzI2MDcyNDU0 +WjB0MQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBT +LkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxGTAX +BgNVBAMTEENlcnR1bSBFQy0zODQgQ0EwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATE +KI6rGFtqvm5kN2PkzeyrOvfMobgOgknXhimfoZTy42B4mIF4Bk3y7JoOV2CDn7Tm +Fy8as10CW4kjPMIRBSqniBMY81CE1700LCeJVf/OTOffph8oxPBUw7l8t1Ot68Kj +QjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI0GZnQkdjrzife81r1HfS+8 +EF9LMA4GA1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNoADBlAjADVS2m5hjEfO/J +UG7BJw+ch69u1RsIGL2SKcHvlJF40jocVYli5RsJHrpka/F2tNQCMQC0QoSZ/6vn +nvuRlydd3LBbMHHOXjgaatkl5+r3YZJW+OraNsKHZZYuciUvf9/DE8k= +-----END CERTIFICATE----- + +# Issuer: CN=Certum Trusted Root CA O=Asseco Data Systems S.A. OU=Certum Certification Authority +# Subject: CN=Certum Trusted Root CA O=Asseco Data Systems S.A. OU=Certum Certification Authority +# Label: "Certum Trusted Root CA" +# Serial: 40870380103424195783807378461123655149 +# MD5 Fingerprint: 51:e1:c2:e7:fe:4c:84:af:59:0e:2f:f4:54:6f:ea:29 +# SHA1 Fingerprint: c8:83:44:c0:18:ae:9f:cc:f1:87:b7:8f:22:d1:c5:d7:45:84:ba:e5 +# SHA256 Fingerprint: fe:76:96:57:38:55:77:3e:37:a9:5e:7a:d4:d9:cc:96:c3:01:57:c1:5d:31:76:5b:a9:b1:57:04:e1:ae:78:fd +-----BEGIN CERTIFICATE----- +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 +-----END CERTIFICATE----- + +# Issuer: CN=TunTrust Root CA O=Agence Nationale de Certification Electronique +# Subject: CN=TunTrust Root CA O=Agence Nationale de Certification Electronique +# Label: "TunTrust Root CA" +# Serial: 108534058042236574382096126452369648152337120275 +# MD5 Fingerprint: 85:13:b9:90:5b:36:5c:b6:5e:b8:5a:f8:e0:31:57:b4 +# SHA1 Fingerprint: cf:e9:70:84:0f:e0:73:0f:9d:f6:0c:7f:2c:4b:ee:20:46:34:9c:bb +# SHA256 Fingerprint: 2e:44:10:2a:b5:8c:b8:54:19:45:1c:8e:19:d9:ac:f3:66:2c:af:bc:61:4b:6a:53:96:0a:30:f7:d0:e2:eb:41 +-----BEGIN CERTIFICATE----- +MIIFszCCA5ugAwIBAgIUEwLV4kBMkkaGFmddtLu7sms+/BMwDQYJKoZIhvcNAQEL +BQAwYTELMAkGA1UEBhMCVE4xNzA1BgNVBAoMLkFnZW5jZSBOYXRpb25hbGUgZGUg +Q2VydGlmaWNhdGlvbiBFbGVjdHJvbmlxdWUxGTAXBgNVBAMMEFR1blRydXN0IFJv +b3QgQ0EwHhcNMTkwNDI2MDg1NzU2WhcNNDQwNDI2MDg1NzU2WjBhMQswCQYDVQQG +EwJUTjE3MDUGA1UECgwuQWdlbmNlIE5hdGlvbmFsZSBkZSBDZXJ0aWZpY2F0aW9u +IEVsZWN0cm9uaXF1ZTEZMBcGA1UEAwwQVHVuVHJ1c3QgUm9vdCBDQTCCAiIwDQYJ +KoZIhvcNAQEBBQADggIPADCCAgoCggIBAMPN0/y9BFPdDCA61YguBUtB9YOCfvdZ +n56eY+hz2vYGqU8ftPkLHzmMmiDQfgbU7DTZhrx1W4eI8NLZ1KMKsmwb60ksPqxd +2JQDoOw05TDENX37Jk0bbjBU2PWARZw5rZzJJQRNmpA+TkBuimvNKWfGzC3gdOgF +VwpIUPp6Q9p+7FuaDmJ2/uqdHYVy7BG7NegfJ7/Boce7SBbdVtfMTqDhuazb1YMZ +GoXRlJfXyqNlC/M4+QKu3fZnz8k/9YosRxqZbwUN/dAdgjH8KcwAWJeRTIAAHDOF +li/LQcKLEITDCSSJH7UP2dl3RxiSlGBcx5kDPP73lad9UKGAwqmDrViWVSHbhlnU +r8a83YFuB9tgYv7sEG7aaAH0gxupPqJbI9dkxt/con3YS7qC0lH4Zr8GRuR5KiY2 +eY8fTpkdso8MDhz/yV3A/ZAQprE38806JG60hZC/gLkMjNWb1sjxVj8agIl6qeIb +MlEsPvLfe/ZdeikZjuXIvTZxi11Mwh0/rViizz1wTaZQmCXcI/m4WEEIcb9PuISg +jwBUFfyRbVinljvrS5YnzWuioYasDXxU5mZMZl+QviGaAkYt5IPCgLnPSz7ofzwB +7I9ezX/SKEIBlYrilz0QIX32nRzFNKHsLA4KUiwSVXAkPcvCFDVDXSdOvsC9qnyW +5/yeYa1E0wCXAgMBAAGjYzBhMB0GA1UdDgQWBBQGmpsfU33x9aTI04Y+oXNZtPdE +ITAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFAaamx9TffH1pMjThj6hc1m0 +90QhMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAqgVutt0Vyb+z +xiD2BkewhpMl0425yAA/l/VSJ4hxyXT968pk21vvHl26v9Hr7lxpuhbI87mP0zYu +QEkHDVneixCwSQXi/5E/S7fdAo74gShczNxtr18UnH1YeA32gAm56Q6XKRm4t+v4 +FstVEuTGfbvE7Pi1HE4+Z7/FXxttbUcoqgRYYdZ2vyJ/0Adqp2RT8JeNnYA/u8EH +22Wv5psymsNUk8QcCMNE+3tjEUPRahphanltkE8pjkcFwRJpadbGNjHh/PqAulxP +xOu3Mqz4dWEX1xAZufHSCe96Qp1bWgvUxpVOKs7/B9dPfhgGiPEZtdmYu65xxBzn +dFlY7wyJz4sfdZMaBBSSSFCp61cpABbjNhzI+L/wM9VBD8TMPN3pM0MBkRArHtG5 +Xc0yGYuPjCB31yLEQtyEFpslbei0VXF/sHyz03FJuc9SpAQ/3D2gu68zngowYI7b +nV2UqL1g52KAdoGDDIzMMEZJ4gzSqK/rYXHv5yJiqfdcZGyfFoxnNidF9Ql7v/YQ +CvGwjVRDjAS6oz/v4jXH+XTgbzRB0L9zZVcg+ZtnemZoJE6AZb0QmQZZ8mWvuMZH +u/2QeItBcy6vVR/cO5JyboTT0GFMDcx2V+IthSIVNg3rAZ3r2OvEhJn7wAzMMujj +d9qDRIueVSjAi1jTkD5OGwDxFa2DK5o= +-----END CERTIFICATE----- + +# Issuer: CN=HARICA TLS RSA Root CA 2021 O=Hellenic Academic and Research Institutions CA +# Subject: CN=HARICA TLS RSA Root CA 2021 O=Hellenic Academic and Research Institutions CA +# Label: "HARICA TLS RSA Root CA 2021" +# Serial: 76817823531813593706434026085292783742 +# MD5 Fingerprint: 65:47:9b:58:86:dd:2c:f0:fc:a2:84:1f:1e:96:c4:91 +# SHA1 Fingerprint: 02:2d:05:82:fa:88:ce:14:0c:06:79:de:7f:14:10:e9:45:d7:a5:6d +# SHA256 Fingerprint: d9:5d:0e:8e:da:79:52:5b:f9:be:b1:1b:14:d2:10:0d:32:94:98:5f:0c:62:d9:fa:bd:9c:d9:99:ec:cb:7b:1d +-----BEGIN CERTIFICATE----- +MIIFpDCCA4ygAwIBAgIQOcqTHO9D88aOk8f0ZIk4fjANBgkqhkiG9w0BAQsFADBs +MQswCQYDVQQGEwJHUjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl +c2VhcmNoIEluc3RpdHV0aW9ucyBDQTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBSU0Eg +Um9vdCBDQSAyMDIxMB4XDTIxMDIxOTEwNTUzOFoXDTQ1MDIxMzEwNTUzN1owbDEL +MAkGA1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNl +YXJjaCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgUlNBIFJv +b3QgQ0EgMjAyMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAIvC569l +mwVnlskNJLnQDmT8zuIkGCyEf3dRywQRNrhe7Wlxp57kJQmXZ8FHws+RFjZiPTgE +4VGC/6zStGndLuwRo0Xua2s7TL+MjaQenRG56Tj5eg4MmOIjHdFOY9TnuEFE+2uv +a9of08WRiFukiZLRgeaMOVig1mlDqa2YUlhu2wr7a89o+uOkXjpFc5gH6l8Cct4M +pbOfrqkdtx2z/IpZ525yZa31MJQjB/OCFks1mJxTuy/K5FrZx40d/JiZ+yykgmvw +Kh+OC19xXFyuQnspiYHLA6OZyoieC0AJQTPb5lh6/a6ZcMBaD9YThnEvdmn8kN3b +LW7R8pv1GmuebxWMevBLKKAiOIAkbDakO/IwkfN4E8/BPzWr8R0RI7VDIp4BkrcY +AuUR0YLbFQDMYTfBKnya4dC6s1BG7oKsnTH4+yPiAwBIcKMJJnkVU2DzOFytOOqB +AGMUuTNe3QvboEUHGjMJ+E20pwKmafTCWQWIZYVWrkvL4N48fS0ayOn7H6NhStYq +E613TBoYm5EPWNgGVMWX+Ko/IIqmhaZ39qb8HOLubpQzKoNQhArlT4b4UEV4AIHr +W2jjJo3Me1xR9BQsQL4aYB16cmEdH2MtiKrOokWQCPxrvrNQKlr9qEgYRtaQQJKQ +CoReaDH46+0N0x3GfZkYVVYnZS6NRcUk7M7jAgMBAAGjQjBAMA8GA1UdEwEB/wQF +MAMBAf8wHQYDVR0OBBYEFApII6ZgpJIKM+qTW8VX6iVNvRLuMA4GA1UdDwEB/wQE +AwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAPpBIqm5iFSVmewzVjIuJndftTgfvnNAU +X15QvWiWkKQUEapobQk1OUAJ2vQJLDSle1mESSmXdMgHHkdt8s4cUCbjnj1AUz/3 +f5Z2EMVGpdAgS1D0NTsY9FVqQRtHBmg8uwkIYtlfVUKqrFOFrJVWNlar5AWMxaja +H6NpvVMPxP/cyuN+8kyIhkdGGvMA9YCRotxDQpSbIPDRzbLrLFPCU3hKTwSUQZqP +JzLB5UkZv/HywouoCjkxKLR9YjYsTewfM7Z+d21+UPCfDtcRj88YxeMn/ibvBZ3P +zzfF0HvaO7AWhAw6k9a+F9sPPg4ZeAnHqQJyIkv3N3a6dcSFA1pj1bF1BcK5vZSt +jBWZp5N99sXzqnTPBIWUmAD04vnKJGW/4GKvyMX6ssmeVkjaef2WdhW+o45WxLM0 +/L5H9MG0qPzVMIho7suuyWPEdr6sOBjhXlzPrjoiUevRi7PzKzMHVIf6tLITe7pT +BGIBnfHAT+7hOtSLIBD6Alfm78ELt5BGnBkpjNxvoEppaZS3JGWg/6w/zgH7IS79 +aPib8qXPMThcFarmlwDB31qlpzmq6YR/PFGoOtmUW4y/Twhx5duoXNTSpv4Ao8YW +xw/ogM4cKGR0GQjTQuPOAF1/sdwTsOEFy9EgqoZ0njnnkf3/W9b3raYvAwtt41dU +63ZTGI0RmLo= +-----END CERTIFICATE----- + +# Issuer: CN=HARICA TLS ECC Root CA 2021 O=Hellenic Academic and Research Institutions CA +# Subject: CN=HARICA TLS ECC Root CA 2021 O=Hellenic Academic and Research Institutions CA +# Label: "HARICA TLS ECC Root CA 2021" +# Serial: 137515985548005187474074462014555733966 +# MD5 Fingerprint: ae:f7:4c:e5:66:35:d1:b7:9b:8c:22:93:74:d3:4b:b0 +# SHA1 Fingerprint: bc:b0:c1:9d:e9:98:92:70:19:38:57:e9:8d:a7:b4:5d:6e:ee:01:48 +# SHA256 Fingerprint: 3f:99:cc:47:4a:cf:ce:4d:fe:d5:87:94:66:5e:47:8d:15:47:73:9f:2e:78:0f:1b:b4:ca:9b:13:30:97:d4:01 +-----BEGIN CERTIFICATE----- +MIICVDCCAdugAwIBAgIQZ3SdjXfYO2rbIvT/WeK/zjAKBggqhkjOPQQDAzBsMQsw +CQYDVQQGEwJHUjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2Vh +cmNoIEluc3RpdHV0aW9ucyBDQTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBFQ0MgUm9v +dCBDQSAyMDIxMB4XDTIxMDIxOTExMDExMFoXDTQ1MDIxMzExMDEwOVowbDELMAkG +A1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJj +aCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgRUNDIFJvb3Qg +Q0EgMjAyMTB2MBAGByqGSM49AgEGBSuBBAAiA2IABDgI/rGgltJ6rK9JOtDA4MM7 +KKrxcm1lAEeIhPyaJmuqS7psBAqIXhfyVYf8MLA04jRYVxqEU+kw2anylnTDUR9Y +STHMmE5gEYd103KUkE+bECUqqHgtvpBBWJAVcqeht6NCMEAwDwYDVR0TAQH/BAUw +AwEB/zAdBgNVHQ4EFgQUyRtTgRL+BNUW0aq8mm+3oJUZbsowDgYDVR0PAQH/BAQD +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----- + +# 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=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----- + +# 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----- + +# 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----- + +# 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----- + +# 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/env/lib/python3.12/site-packages/pip/_vendor/certifi/core.py b/env/lib/python3.12/site-packages/pip/_vendor/certifi/core.py new file mode 100644 index 0000000..70e0c3b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/certifi/core.py @@ -0,0 +1,114 @@ +""" +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): + + from importlib.resources import as_file, files + + _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 = as_file(files("pip._vendor.certifi").joinpath("cacert.pem")) + _CACERT_PATH = str(_CACERT_CTX.__enter__()) + atexit.register(exit_cacert_ctx) + + return _CACERT_PATH + + def contents() -> str: + return files("pip._vendor.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("pip._vendor.certifi", "cacert.pem") + _CACERT_PATH = str(_CACERT_CTX.__enter__()) + atexit.register(exit_cacert_ctx) + + return _CACERT_PATH + + def contents() -> str: + return read_text("pip._vendor.certifi", "cacert.pem", encoding="ascii") + +else: + import os + import types + from typing import Union + + 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( + 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() -> str: + f = os.path.dirname(__file__) + + return os.path.join(f, "cacert.pem") + + def contents() -> str: + return read_text("pip._vendor.certifi", "cacert.pem", encoding="ascii") diff --git a/env/lib/python3.12/site-packages/pip/_vendor/certifi/py.typed b/env/lib/python3.12/site-packages/pip/_vendor/certifi/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/distlib/__init__.py new file mode 100644 index 0000000..bf0d6c6 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distlib/__init__.py @@ -0,0 +1,33 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +import logging + +__version__ = '0.3.9' + + +class DistlibException(Exception): + pass + + +try: + from logging import NullHandler +except ImportError: # pragma: no cover + + class NullHandler(logging.Handler): + + def handle(self, record): + pass + + def emit(self, record): + pass + + def createLock(self): + self.lock = None + + +logger = logging.getLogger(__name__) +logger.addHandler(NullHandler()) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/compat.py b/env/lib/python3.12/site-packages/pip/_vendor/distlib/compat.py new file mode 100644 index 0000000..ca561dd --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distlib/compat.py @@ -0,0 +1,1137 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2017 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +from __future__ import absolute_import + +import os +import re +import shutil +import sys + +try: + import ssl +except ImportError: # pragma: no cover + ssl = None + +if sys.version_info[0] < 3: # pragma: no cover + from StringIO import StringIO + string_types = basestring, + text_type = unicode + from types import FileType as file_type + import __builtin__ as builtins + import ConfigParser as configparser + from urlparse import urlparse, urlunparse, urljoin, urlsplit, urlunsplit + from urllib import (urlretrieve, quote as _quote, unquote, url2pathname, + pathname2url, ContentTooShortError, splittype) + + def quote(s): + if isinstance(s, unicode): + s = s.encode('utf-8') + return _quote(s) + + import urllib2 + from urllib2 import (Request, urlopen, URLError, HTTPError, + HTTPBasicAuthHandler, HTTPPasswordMgr, HTTPHandler, + HTTPRedirectHandler, build_opener) + if ssl: + from urllib2 import HTTPSHandler + import httplib + import xmlrpclib + import Queue as queue + from HTMLParser import HTMLParser + import htmlentitydefs + raw_input = raw_input + from itertools import ifilter as filter + from itertools import ifilterfalse as filterfalse + + # Leaving this around for now, in case it needs resurrecting in some way + # _userprog = None + # def splituser(host): + # """splituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'.""" + # global _userprog + # if _userprog is None: + # import re + # _userprog = re.compile('^(.*)@(.*)$') + + # match = _userprog.match(host) + # if match: return match.group(1, 2) + # return None, host + +else: # pragma: no cover + from io import StringIO + string_types = str, + text_type = str + from io import TextIOWrapper as file_type + import builtins + import configparser + from urllib.parse import (urlparse, urlunparse, urljoin, quote, unquote, + urlsplit, urlunsplit, splittype) + from urllib.request import (urlopen, urlretrieve, Request, url2pathname, + pathname2url, HTTPBasicAuthHandler, + HTTPPasswordMgr, HTTPHandler, + HTTPRedirectHandler, build_opener) + if ssl: + from urllib.request import HTTPSHandler + from urllib.error import HTTPError, URLError, ContentTooShortError + import http.client as httplib + import urllib.request as urllib2 + import xmlrpc.client as xmlrpclib + import queue + from html.parser import HTMLParser + import html.entities as htmlentitydefs + raw_input = input + from itertools import filterfalse + filter = filter + +try: + from ssl import match_hostname, CertificateError +except ImportError: # pragma: no cover + + class CertificateError(ValueError): + pass + + 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 + """ + pats = [] + if not dn: + return False + + parts = dn.split('.') + leftmost, remainder = parts[0], parts[1:] + + wildcards = leftmost.count('*') + if wildcards > max_wildcards: + # Issue #17980: avoid denials of service by refusing more + # than one wildcard per fragment. A survey of established + # policy among SSL implementations showed it to be a + # reasonable choice. + raise CertificateError( + "too many wildcards in certificate DNS name: " + repr(dn)) + + # speed up common case w/o wildcards + if not wildcards: + 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 + # the wildcard character comprises a label other than the left-most label. + if leftmost == '*': + # When '*' is a fragment by itself, it matches a non-empty dotless + # fragment. + pats.append('[^.]+') + elif leftmost.startswith('xn--') or hostname.startswith('xn--'): + # RFC 6125, section 6.4.3, subitem 3. + # The client SHOULD NOT attempt to match a presented identifier + # where the wildcard character is embedded within an A-label or + # U-label of an internationalized domain name. + pats.append(re.escape(leftmost)) + else: + # Otherwise, '*' matches any dotless string, e.g. www* + pats.append(re.escape(leftmost).replace(r'\*', '[^.]*')) + + # add the remaining fragments, ignore any wildcards + for frag in remainder: + pats.append(re.escape(frag)) + + pat = re.compile(r'\A' + r'\.'.join(pats) + r'\Z', re.IGNORECASE) + return pat.match(hostname) + + 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*. + + CertificateError is raised on failure. On success, the function + returns nothing. + """ + if not cert: + raise ValueError("empty or no certificate, match_hostname needs a " + "SSL socket or SSL context with either " + "CERT_OPTIONAL or CERT_REQUIRED") + dnsnames = [] + san = cert.get('subjectAltName', ()) + for key, value in san: + if key == 'DNS': + if _dnsname_match(value, hostname): + return + dnsnames.append(value) + 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("hostname %r " + "doesn't match %r" % + (hostname, dnsnames[0])) + else: + raise CertificateError("no appropriate commonName or " + "subjectAltName fields were found") + + +try: + from types import SimpleNamespace as Container +except ImportError: # pragma: no cover + + class Container(object): + """ + A generic container for when multiple values need to be returned + """ + + def __init__(self, **kwargs): + self.__dict__.update(kwargs) + + +try: + from shutil import which +except ImportError: # pragma: no cover + # Implementation from Python 3.3 + def which(cmd, mode=os.F_OK | os.X_OK, path=None): + """Given a command, mode, and a PATH string, return the path which + conforms to the given mode on the PATH, or None if there is no such + file. + + `mode` defaults to os.F_OK | os.X_OK. `path` defaults to the result + of os.environ.get("PATH"), or can be overridden with a custom search + path. + + """ + + # Check that a given file can be accessed with the correct mode. + # Additionally check that `file` is not a directory, as on Windows + # directories pass the os.access check. + def _access_check(fn, mode): + return (os.path.exists(fn) and os.access(fn, mode) and not os.path.isdir(fn)) + + # If we're given a path with a directory part, look it up directly rather + # than referring to PATH directories. This includes checking relative to the + # current directory, e.g. ./script + if os.path.dirname(cmd): + if _access_check(cmd, mode): + return cmd + return None + + if path is None: + path = os.environ.get("PATH", os.defpath) + if not path: + return None + path = path.split(os.pathsep) + + if sys.platform == "win32": + # The current directory takes precedence on Windows. + if os.curdir not in path: + path.insert(0, os.curdir) + + # PATHEXT is necessary to check on Windows. + pathext = os.environ.get("PATHEXT", "").split(os.pathsep) + # See if the given file matches any of the expected path extensions. + # This will allow us to short circuit when given "python.exe". + # If it does match, only test that one, otherwise we have to try + # others. + if any(cmd.lower().endswith(ext.lower()) for ext in pathext): + files = [cmd] + else: + files = [cmd + ext for ext in pathext] + else: + # On other platforms you don't have things like PATHEXT to tell you + # what file suffixes are executable, so just pass on cmd as-is. + files = [cmd] + + seen = set() + for dir in path: + normdir = os.path.normcase(dir) + if normdir not in seen: + seen.add(normdir) + for thefile in files: + name = os.path.join(dir, thefile) + if _access_check(name, mode): + return name + return None + + +# ZipFile is a context manager in 2.7, but not in 2.6 + +from zipfile import ZipFile as BaseZipFile + +if hasattr(BaseZipFile, '__enter__'): # pragma: no cover + ZipFile = BaseZipFile +else: # pragma: no cover + from zipfile import ZipExtFile as BaseZipExtFile + + class ZipExtFile(BaseZipExtFile): + + def __init__(self, base): + self.__dict__.update(base.__dict__) + + def __enter__(self): + return self + + def __exit__(self, *exc_info): + self.close() + # return None, so if an exception occurred, it will propagate + + class ZipFile(BaseZipFile): + + def __enter__(self): + return self + + def __exit__(self, *exc_info): + self.close() + # return None, so if an exception occurred, it will propagate + + def open(self, *args, **kwargs): + base = BaseZipFile.open(self, *args, **kwargs) + return ZipExtFile(base) + + +try: + from platform import python_implementation +except ImportError: # pragma: no cover + + def python_implementation(): + """Return a string identifying the Python implementation.""" + if 'PyPy' in sys.version: + return 'PyPy' + if os.name == 'java': + return 'Jython' + if sys.version.startswith('IronPython'): + return 'IronPython' + return 'CPython' + + +import sysconfig + +try: + callable = callable +except NameError: # pragma: no cover + from collections.abc import Callable + + def callable(obj): + return isinstance(obj, Callable) + + +try: + fsencode = os.fsencode + fsdecode = os.fsdecode +except AttributeError: # pragma: no cover + # Issue #99: on some systems (e.g. containerised), + # sys.getfilesystemencoding() returns None, and we need a real value, + # so fall back to utf-8. From the CPython 2.7 docs relating to Unix and + # sys.getfilesystemencoding(): the return value is "the user’s preference + # according to the result of nl_langinfo(CODESET), or None if the + # nl_langinfo(CODESET) failed." + _fsencoding = sys.getfilesystemencoding() or 'utf-8' + if _fsencoding == 'mbcs': + _fserrors = 'strict' + else: + _fserrors = 'surrogateescape' + + def fsencode(filename): + if isinstance(filename, bytes): + return filename + elif isinstance(filename, text_type): + return filename.encode(_fsencoding, _fserrors) + else: + raise TypeError("expect bytes or str, not %s" % + type(filename).__name__) + + def fsdecode(filename): + if isinstance(filename, text_type): + return filename + elif isinstance(filename, bytes): + return filename.decode(_fsencoding, _fserrors) + else: + raise TypeError("expect bytes or str, not %s" % + type(filename).__name__) + + +try: + from tokenize import detect_encoding +except ImportError: # pragma: no cover + from codecs import BOM_UTF8, lookup + + cookie_re = re.compile(r"coding[:=]\s*([-\w.]+)") + + def _get_normal_name(orig_enc): + """Imitates get_normal_name in tokenizer.c.""" + # Only care about the first 12 characters. + enc = orig_enc[:12].lower().replace("_", "-") + if enc == "utf-8" or enc.startswith("utf-8-"): + return "utf-8" + if enc in ("latin-1", "iso-8859-1", "iso-latin-1") or \ + enc.startswith(("latin-1-", "iso-8859-1-", "iso-latin-1-")): + return "iso-8859-1" + return orig_enc + + def detect_encoding(readline): + """ + The detect_encoding() function is used to detect the encoding that should + be used to decode a Python source file. It requires one argument, readline, + in the same way as the tokenize() generator. + + It will call readline a maximum of twice, and return the encoding used + (as a string) and a list of any lines (left as bytes) it has read in. + + It detects the encoding from the presence of a utf-8 bom or an encoding + cookie as specified in pep-0263. If both a bom and a cookie are present, + but disagree, a SyntaxError will be raised. If the encoding cookie is an + invalid charset, raise a SyntaxError. Note that if a utf-8 bom is found, + 'utf-8-sig' is returned. + + If no encoding is specified, then the default of 'utf-8' will be returned. + """ + try: + filename = readline.__self__.name + except AttributeError: + filename = None + bom_found = False + encoding = None + default = 'utf-8' + + def read_or_stop(): + try: + return readline() + except StopIteration: + return b'' + + def find_cookie(line): + try: + # Decode as UTF-8. Either the line is an encoding declaration, + # in which case it should be pure ASCII, or it must be UTF-8 + # per default encoding. + line_string = line.decode('utf-8') + except UnicodeDecodeError: + msg = "invalid or missing encoding declaration" + if filename is not None: + msg = '{} for {!r}'.format(msg, filename) + raise SyntaxError(msg) + + matches = cookie_re.findall(line_string) + if not matches: + return None + encoding = _get_normal_name(matches[0]) + try: + codec = lookup(encoding) + except LookupError: + # This behaviour mimics the Python interpreter + if filename is None: + msg = "unknown encoding: " + encoding + else: + msg = "unknown encoding for {!r}: {}".format( + filename, encoding) + raise SyntaxError(msg) + + if bom_found: + if codec.name != 'utf-8': + # This behaviour mimics the Python interpreter + if filename is None: + msg = 'encoding problem: utf-8' + else: + msg = 'encoding problem for {!r}: utf-8'.format( + filename) + raise SyntaxError(msg) + encoding += '-sig' + return encoding + + first = read_or_stop() + if first.startswith(BOM_UTF8): + bom_found = True + first = first[3:] + default = 'utf-8-sig' + if not first: + return default, [] + + encoding = find_cookie(first) + if encoding: + return encoding, [first] + + second = read_or_stop() + if not second: + return default, [first] + + encoding = find_cookie(second) + if encoding: + return encoding, [first, second] + + return default, [first, second] + + +# For converting & <-> & etc. +try: + from html import escape +except ImportError: + from cgi import escape +if sys.version_info[:2] < (3, 4): + unescape = HTMLParser().unescape +else: + from html import unescape + +try: + from collections import ChainMap +except ImportError: # pragma: no cover + from collections import MutableMapping + + try: + from reprlib import recursive_repr as _recursive_repr + except ImportError: + + def _recursive_repr(fillvalue='...'): + ''' + Decorator to make a repr function return fillvalue for a recursive + call + ''' + + def decorating_function(user_function): + repr_running = set() + + def wrapper(self): + key = id(self), get_ident() + if key in repr_running: + return fillvalue + repr_running.add(key) + try: + result = user_function(self) + finally: + repr_running.discard(key) + return result + + # Can't use functools.wraps() here because of bootstrap issues + wrapper.__module__ = getattr(user_function, '__module__') + wrapper.__doc__ = getattr(user_function, '__doc__') + wrapper.__name__ = getattr(user_function, '__name__') + wrapper.__annotations__ = getattr(user_function, + '__annotations__', {}) + return wrapper + + return decorating_function + + class ChainMap(MutableMapping): + ''' + A ChainMap groups multiple dicts (or other mappings) together + to create a single, updateable view. + + The underlying mappings are stored in a list. That list is public and can + accessed or updated using the *maps* attribute. There is no other state. + + Lookups search the underlying mappings successively until a key is found. + In contrast, writes, updates, and deletions only operate on the first + mapping. + ''' + + def __init__(self, *maps): + '''Initialize a ChainMap by setting *maps* to the given mappings. + If no mappings are provided, a single empty dictionary is used. + + ''' + self.maps = list(maps) or [{}] # always at least one map + + def __missing__(self, key): + raise KeyError(key) + + def __getitem__(self, key): + for mapping in self.maps: + try: + return mapping[ + key] # can't use 'key in mapping' with defaultdict + except KeyError: + pass + return self.__missing__( + key) # support subclasses that define __missing__ + + def get(self, key, default=None): + return self[key] if key in self else default + + def __len__(self): + return len(set().union( + *self.maps)) # reuses stored hash values if possible + + def __iter__(self): + return iter(set().union(*self.maps)) + + def __contains__(self, key): + return any(key in m for m in self.maps) + + def __bool__(self): + return any(self.maps) + + @_recursive_repr() + def __repr__(self): + return '{0.__class__.__name__}({1})'.format( + self, ', '.join(map(repr, self.maps))) + + @classmethod + def fromkeys(cls, iterable, *args): + 'Create a ChainMap with a single dict created from the iterable.' + return cls(dict.fromkeys(iterable, *args)) + + def copy(self): + 'New ChainMap or subclass with a new copy of maps[0] and refs to maps[1:]' + return self.__class__(self.maps[0].copy(), *self.maps[1:]) + + __copy__ = copy + + def new_child(self): # like Django's Context.push() + 'New ChainMap with a new dict followed by all previous maps.' + return self.__class__({}, *self.maps) + + @property + def parents(self): # like Django's Context.pop() + 'New ChainMap from maps[1:].' + return self.__class__(*self.maps[1:]) + + def __setitem__(self, key, value): + self.maps[0][key] = value + + def __delitem__(self, key): + try: + del self.maps[0][key] + except KeyError: + raise KeyError( + 'Key not found in the first mapping: {!r}'.format(key)) + + def popitem(self): + 'Remove and return an item pair from maps[0]. Raise KeyError is maps[0] is empty.' + try: + return self.maps[0].popitem() + except KeyError: + raise KeyError('No keys found in the first mapping.') + + def pop(self, key, *args): + 'Remove *key* from maps[0] and return its value. Raise KeyError if *key* not in maps[0].' + try: + return self.maps[0].pop(key, *args) + except KeyError: + raise KeyError( + 'Key not found in the first mapping: {!r}'.format(key)) + + def clear(self): + 'Clear maps[0], leaving maps[1:] intact.' + self.maps[0].clear() + + +try: + from importlib.util import cache_from_source # Python >= 3.4 +except ImportError: # pragma: no cover + + def cache_from_source(path, debug_override=None): + assert path.endswith('.py') + if debug_override is None: + debug_override = __debug__ + if debug_override: + suffix = 'c' + else: + suffix = 'o' + return path + suffix + + +try: + from collections import OrderedDict +except ImportError: # pragma: no cover + # {{{ http://code.activestate.com/recipes/576693/ (r9) + # Backport of OrderedDict() class that runs on Python 2.4, 2.5, 2.6, 2.7 and pypy. + # Passes Python2.7's test suite and incorporates all the latest updates. + try: + from thread import get_ident as _get_ident + except ImportError: + from dummy_thread import get_ident as _get_ident + + try: + from _abcoll import KeysView, ValuesView, ItemsView + except ImportError: + pass + + class OrderedDict(dict): + 'Dictionary that remembers insertion order' + + # An inherited dict maps keys to values. + # The inherited dict provides __getitem__, __len__, __contains__, and get. + # The remaining methods are order-aware. + # Big-O running times for all methods are the same as for regular dictionaries. + + # The internal self.__map dictionary maps keys to links in a doubly linked list. + # The circular doubly linked list starts and ends with a sentinel element. + # The sentinel element never gets deleted (this simplifies the algorithm). + # Each link is stored as a list of length three: [PREV, NEXT, KEY]. + + def __init__(self, *args, **kwds): + '''Initialize an ordered dictionary. Signature is the same as for + regular dictionaries, but keyword arguments are not recommended + because their insertion order is arbitrary. + + ''' + if len(args) > 1: + raise TypeError('expected at most 1 arguments, got %d' % + len(args)) + try: + self.__root + except AttributeError: + self.__root = root = [] # sentinel node + root[:] = [root, root, None] + self.__map = {} + self.__update(*args, **kwds) + + def __setitem__(self, key, value, dict_setitem=dict.__setitem__): + 'od.__setitem__(i, y) <==> od[i]=y' + # Setting a new item creates a new link which goes at the end of the linked + # list, and the inherited dictionary is updated with the new key/value pair. + if key not in self: + root = self.__root + last = root[0] + last[1] = root[0] = self.__map[key] = [last, root, key] + dict_setitem(self, key, value) + + def __delitem__(self, key, dict_delitem=dict.__delitem__): + 'od.__delitem__(y) <==> del od[y]' + # Deleting an existing item uses self.__map to find the link which is + # then removed by updating the links in the predecessor and successor nodes. + dict_delitem(self, key) + link_prev, link_next, key = self.__map.pop(key) + link_prev[1] = link_next + link_next[0] = link_prev + + def __iter__(self): + 'od.__iter__() <==> iter(od)' + root = self.__root + curr = root[1] + while curr is not root: + yield curr[2] + curr = curr[1] + + def __reversed__(self): + 'od.__reversed__() <==> reversed(od)' + root = self.__root + curr = root[0] + while curr is not root: + yield curr[2] + curr = curr[0] + + def clear(self): + 'od.clear() -> None. Remove all items from od.' + try: + for node in self.__map.itervalues(): + del node[:] + root = self.__root + root[:] = [root, root, None] + self.__map.clear() + except AttributeError: + pass + dict.clear(self) + + def popitem(self, last=True): + '''od.popitem() -> (k, v), return and remove a (key, value) pair. + Pairs are returned in LIFO order if last is true or FIFO order if false. + + ''' + if not self: + raise KeyError('dictionary is empty') + root = self.__root + if last: + link = root[0] + link_prev = link[0] + link_prev[1] = root + root[0] = link_prev + else: + link = root[1] + link_next = link[1] + root[1] = link_next + link_next[0] = root + key = link[2] + del self.__map[key] + value = dict.pop(self, key) + return key, value + + # -- the following methods do not depend on the internal structure -- + + def keys(self): + 'od.keys() -> list of keys in od' + return list(self) + + def values(self): + 'od.values() -> list of values in od' + return [self[key] for key in self] + + def items(self): + 'od.items() -> list of (key, value) pairs in od' + return [(key, self[key]) for key in self] + + def iterkeys(self): + 'od.iterkeys() -> an iterator over the keys in od' + return iter(self) + + def itervalues(self): + 'od.itervalues -> an iterator over the values in od' + for k in self: + yield self[k] + + def iteritems(self): + 'od.iteritems -> an iterator over the (key, value) items in od' + for k in self: + yield (k, self[k]) + + def update(*args, **kwds): + '''od.update(E, **F) -> None. Update od from dict/iterable E and F. + + If E is a dict instance, does: for k in E: od[k] = E[k] + If E has a .keys() method, does: for k in E.keys(): od[k] = E[k] + Or if E is an iterable of items, does: for k, v in E: od[k] = v + In either case, this is followed by: for k, v in F.items(): od[k] = v + + ''' + if len(args) > 2: + raise TypeError('update() takes at most 2 positional ' + 'arguments (%d given)' % (len(args), )) + elif not args: + raise TypeError('update() takes at least 1 argument (0 given)') + self = args[0] + # Make progressively weaker assumptions about "other" + other = () + if len(args) == 2: + other = args[1] + if isinstance(other, dict): + for key in other: + self[key] = other[key] + elif hasattr(other, 'keys'): + for key in other.keys(): + self[key] = other[key] + else: + for key, value in other: + self[key] = value + for key, value in kwds.items(): + self[key] = value + + __update = update # let subclasses override update without breaking __init__ + + __marker = object() + + def pop(self, key, default=__marker): + '''od.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. + + ''' + if key in self: + result = self[key] + del self[key] + return result + if default is self.__marker: + raise KeyError(key) + return default + + def setdefault(self, key, default=None): + 'od.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in od' + if key in self: + return self[key] + self[key] = default + return default + + def __repr__(self, _repr_running=None): + 'od.__repr__() <==> repr(od)' + if not _repr_running: + _repr_running = {} + call_key = id(self), _get_ident() + if call_key in _repr_running: + return '...' + _repr_running[call_key] = 1 + try: + if not self: + return '%s()' % (self.__class__.__name__, ) + return '%s(%r)' % (self.__class__.__name__, self.items()) + finally: + del _repr_running[call_key] + + def __reduce__(self): + 'Return state information for pickling' + items = [[k, self[k]] for k in self] + inst_dict = vars(self).copy() + for k in vars(OrderedDict()): + inst_dict.pop(k, None) + if inst_dict: + return (self.__class__, (items, ), inst_dict) + return self.__class__, (items, ) + + def copy(self): + 'od.copy() -> a shallow copy of od' + return self.__class__(self) + + @classmethod + def fromkeys(cls, iterable, value=None): + '''OD.fromkeys(S[, v]) -> New ordered dictionary with keys from S + and values equal to v (which defaults to None). + + ''' + d = cls() + for key in iterable: + d[key] = value + return d + + def __eq__(self, other): + '''od.__eq__(y) <==> od==y. Comparison to another OD is order-sensitive + while comparison to a regular mapping is order-insensitive. + + ''' + if isinstance(other, OrderedDict): + return len(self) == len( + other) and self.items() == other.items() + return dict.__eq__(self, other) + + def __ne__(self, other): + return not self == other + + # -- the following methods are only used in Python 2.7 -- + + def viewkeys(self): + "od.viewkeys() -> a set-like object providing a view on od's keys" + return KeysView(self) + + def viewvalues(self): + "od.viewvalues() -> an object providing a view on od's values" + return ValuesView(self) + + def viewitems(self): + "od.viewitems() -> a set-like object providing a view on od's items" + return ItemsView(self) + + +try: + from logging.config import BaseConfigurator, valid_ident +except ImportError: # pragma: no cover + IDENTIFIER = re.compile('^[a-z_][a-z0-9_]*$', re.I) + + def valid_ident(s): + m = IDENTIFIER.match(s) + if not m: + raise ValueError('Not a valid Python identifier: %r' % s) + return True + + # The ConvertingXXX classes are wrappers around standard Python containers, + # and they serve to convert any suitable values in the container. The + # conversion converts base dicts, lists and tuples to their wrapped + # equivalents, whereas strings which match a conversion format are converted + # appropriately. + # + # Each wrapper should have a configurator attribute holding the actual + # configurator to use for conversion. + + class ConvertingDict(dict): + """A converting dictionary wrapper.""" + + def __getitem__(self, key): + value = dict.__getitem__(self, key) + result = self.configurator.convert(value) + # If the converted value is different, save for next time + if value is not result: + self[key] = result + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + def get(self, key, default=None): + value = dict.get(self, key, default) + result = self.configurator.convert(value) + # If the converted value is different, save for next time + if value is not result: + self[key] = result + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + def pop(self, key, default=None): + value = dict.pop(self, key, default) + result = self.configurator.convert(value) + if value is not result: + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + class ConvertingList(list): + """A converting list wrapper.""" + + def __getitem__(self, key): + value = list.__getitem__(self, key) + result = self.configurator.convert(value) + # If the converted value is different, save for next time + if value is not result: + self[key] = result + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + def pop(self, idx=-1): + value = list.pop(self, idx) + result = self.configurator.convert(value) + if value is not result: + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + return result + + class ConvertingTuple(tuple): + """A converting tuple wrapper.""" + + def __getitem__(self, key): + value = tuple.__getitem__(self, key) + result = self.configurator.convert(value) + if value is not result: + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + class BaseConfigurator(object): + """ + The configurator base class which defines some useful defaults. + """ + + CONVERT_PATTERN = re.compile(r'^(?P[a-z]+)://(?P.*)$') + + WORD_PATTERN = re.compile(r'^\s*(\w+)\s*') + DOT_PATTERN = re.compile(r'^\.\s*(\w+)\s*') + INDEX_PATTERN = re.compile(r'^\[\s*(\w+)\s*\]\s*') + DIGIT_PATTERN = re.compile(r'^\d+$') + + value_converters = { + 'ext': 'ext_convert', + 'cfg': 'cfg_convert', + } + + # We might want to use a different one, e.g. importlib + importer = staticmethod(__import__) + + def __init__(self, config): + self.config = ConvertingDict(config) + self.config.configurator = self + + def resolve(self, s): + """ + Resolve strings to objects using standard import and attribute + syntax. + """ + name = s.split('.') + used = name.pop(0) + try: + found = self.importer(used) + for frag in name: + used += '.' + frag + try: + found = getattr(found, frag) + except AttributeError: + self.importer(used) + found = getattr(found, frag) + return found + except ImportError: + e, tb = sys.exc_info()[1:] + v = ValueError('Cannot resolve %r: %s' % (s, e)) + v.__cause__, v.__traceback__ = e, tb + raise v + + def ext_convert(self, value): + """Default converter for the ext:// protocol.""" + return self.resolve(value) + + def cfg_convert(self, value): + """Default converter for the cfg:// protocol.""" + rest = value + m = self.WORD_PATTERN.match(rest) + if m is None: + raise ValueError("Unable to convert %r" % value) + else: + rest = rest[m.end():] + d = self.config[m.groups()[0]] + while rest: + m = self.DOT_PATTERN.match(rest) + if m: + d = d[m.groups()[0]] + else: + m = self.INDEX_PATTERN.match(rest) + if m: + idx = m.groups()[0] + if not self.DIGIT_PATTERN.match(idx): + d = d[idx] + else: + try: + n = int( + idx + ) # try as number first (most likely) + d = d[n] + except TypeError: + d = d[idx] + if m: + rest = rest[m.end():] + else: + raise ValueError('Unable to convert ' + '%r at %r' % (value, rest)) + # rest should be empty + return d + + def convert(self, value): + """ + Convert values to an appropriate type. dicts, lists and tuples are + replaced by their converting alternatives. Strings are checked to + see if they have a conversion format and are converted if they do. + """ + if not isinstance(value, ConvertingDict) and isinstance( + value, dict): + value = ConvertingDict(value) + value.configurator = self + elif not isinstance(value, ConvertingList) and isinstance( + value, list): + value = ConvertingList(value) + value.configurator = self + elif not isinstance(value, ConvertingTuple) and isinstance(value, tuple): + value = ConvertingTuple(value) + value.configurator = self + elif isinstance(value, string_types): + m = self.CONVERT_PATTERN.match(value) + if m: + d = m.groupdict() + prefix = d['prefix'] + converter = self.value_converters.get(prefix, None) + if converter: + suffix = d['suffix'] + converter = getattr(self, converter) + value = converter(suffix) + return value + + def configure_custom(self, config): + """Configure an object with a user-supplied factory.""" + c = config.pop('()') + if not callable(c): + c = self.resolve(c) + props = config.pop('.', None) + # Check for valid identifiers + kwargs = dict([(k, config[k]) for k in config if valid_ident(k)]) + result = c(**kwargs) + if props: + for name, value in props.items(): + setattr(result, name, value) + return result + + def as_tuple(self, value): + """Utility function which converts lists to tuples.""" + if isinstance(value, list): + value = tuple(value) + return value diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/database.py b/env/lib/python3.12/site-packages/pip/_vendor/distlib/database.py new file mode 100644 index 0000000..c0f896a --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distlib/database.py @@ -0,0 +1,1329 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 The Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +"""PEP 376 implementation.""" + +from __future__ import unicode_literals + +import base64 +import codecs +import contextlib +import hashlib +import logging +import os +import posixpath +import sys +import zipimport + +from . import DistlibException, resources +from .compat import StringIO +from .version import get_scheme, UnsupportedVersionError +from .metadata import (Metadata, METADATA_FILENAME, WHEEL_METADATA_FILENAME, LEGACY_METADATA_FILENAME) +from .util import (parse_requirement, cached_property, parse_name_and_version, read_exports, write_exports, CSVReader, + CSVWriter) + +__all__ = [ + 'Distribution', 'BaseInstalledDistribution', 'InstalledDistribution', 'EggInfoDistribution', 'DistributionPath' +] + +logger = logging.getLogger(__name__) + +EXPORTS_FILENAME = 'pydist-exports.json' +COMMANDS_FILENAME = 'pydist-commands.json' + +DIST_FILES = ('INSTALLER', METADATA_FILENAME, 'RECORD', 'REQUESTED', 'RESOURCES', EXPORTS_FILENAME, 'SHARED') + +DISTINFO_EXT = '.dist-info' + + +class _Cache(object): + """ + A simple cache mapping names and .dist-info paths to distributions + """ + + def __init__(self): + """ + Initialise an instance. There is normally one for each DistributionPath. + """ + self.name = {} + self.path = {} + self.generated = False + + def clear(self): + """ + Clear the cache, setting it to its initial state. + """ + self.name.clear() + self.path.clear() + self.generated = False + + def add(self, dist): + """ + Add a distribution to the cache. + :param dist: The distribution to add. + """ + if dist.path not in self.path: + self.path[dist.path] = dist + self.name.setdefault(dist.key, []).append(dist) + + +class DistributionPath(object): + """ + Represents a set of distributions installed on a path (typically sys.path). + """ + + def __init__(self, path=None, include_egg=False): + """ + Create an instance from a path, optionally including legacy (distutils/ + setuptools/distribute) distributions. + :param path: The path to use, as a list of directories. If not specified, + sys.path is used. + :param include_egg: If True, this instance will look for and return legacy + distributions as well as those based on PEP 376. + """ + if path is None: + path = sys.path + self.path = path + self._include_dist = True + self._include_egg = include_egg + + self._cache = _Cache() + self._cache_egg = _Cache() + self._cache_enabled = True + self._scheme = get_scheme('default') + + def _get_cache_enabled(self): + return self._cache_enabled + + def _set_cache_enabled(self, value): + self._cache_enabled = value + + cache_enabled = property(_get_cache_enabled, _set_cache_enabled) + + def clear_cache(self): + """ + Clears the internal cache. + """ + self._cache.clear() + self._cache_egg.clear() + + def _yield_distributions(self): + """ + Yield .dist-info and/or .egg(-info) distributions. + """ + # We need to check if we've seen some resources already, because on + # some Linux systems (e.g. some Debian/Ubuntu variants) there are + # symlinks which alias other files in the environment. + seen = set() + for path in self.path: + finder = resources.finder_for_path(path) + if finder is None: + continue + r = finder.find('') + if not r or not r.is_container: + continue + rset = sorted(r.resources) + for entry in rset: + r = finder.find(entry) + if not r or r.path in seen: + continue + try: + if self._include_dist and entry.endswith(DISTINFO_EXT): + possible_filenames = [METADATA_FILENAME, WHEEL_METADATA_FILENAME, LEGACY_METADATA_FILENAME] + for metadata_filename in possible_filenames: + metadata_path = posixpath.join(entry, metadata_filename) + pydist = finder.find(metadata_path) + if pydist: + break + else: + continue + + with contextlib.closing(pydist.as_stream()) as stream: + metadata = Metadata(fileobj=stream, scheme='legacy') + logger.debug('Found %s', r.path) + seen.add(r.path) + yield new_dist_class(r.path, metadata=metadata, env=self) + elif self._include_egg and entry.endswith(('.egg-info', '.egg')): + logger.debug('Found %s', r.path) + seen.add(r.path) + yield old_dist_class(r.path, self) + except Exception as e: + msg = 'Unable to read distribution at %s, perhaps due to bad metadata: %s' + logger.warning(msg, r.path, e) + import warnings + warnings.warn(msg % (r.path, e), stacklevel=2) + + def _generate_cache(self): + """ + Scan the path for distributions and populate the cache with + those that are found. + """ + gen_dist = not self._cache.generated + gen_egg = self._include_egg and not self._cache_egg.generated + if gen_dist or gen_egg: + for dist in self._yield_distributions(): + if isinstance(dist, InstalledDistribution): + self._cache.add(dist) + else: + self._cache_egg.add(dist) + + if gen_dist: + self._cache.generated = True + if gen_egg: + self._cache_egg.generated = True + + @classmethod + def distinfo_dirname(cls, name, version): + """ + The *name* and *version* parameters are converted into their + filename-escaped form, i.e. any ``'-'`` characters are replaced + with ``'_'`` other than the one in ``'dist-info'`` and the one + separating the name from the version number. + + :parameter name: is converted to a standard distribution name by replacing + any runs of non- alphanumeric characters with a single + ``'-'``. + :type name: string + :parameter version: is converted to a standard version string. Spaces + become dots, and all other non-alphanumeric characters + (except dots) become dashes, with runs of multiple + dashes condensed to a single dash. + :type version: string + :returns: directory name + :rtype: string""" + name = name.replace('-', '_') + return '-'.join([name, version]) + DISTINFO_EXT + + def get_distributions(self): + """ + Provides an iterator that looks for distributions and returns + :class:`InstalledDistribution` or + :class:`EggInfoDistribution` instances for each one of them. + + :rtype: iterator of :class:`InstalledDistribution` and + :class:`EggInfoDistribution` instances + """ + if not self._cache_enabled: + for dist in self._yield_distributions(): + yield dist + else: + self._generate_cache() + + for dist in self._cache.path.values(): + yield dist + + if self._include_egg: + for dist in self._cache_egg.path.values(): + yield dist + + def get_distribution(self, name): + """ + Looks for a named distribution on the path. + + This function only returns the first result found, as no more than one + value is expected. If nothing is found, ``None`` is returned. + + :rtype: :class:`InstalledDistribution`, :class:`EggInfoDistribution` + or ``None`` + """ + result = None + name = name.lower() + if not self._cache_enabled: + for dist in self._yield_distributions(): + if dist.key == name: + result = dist + break + else: + self._generate_cache() + + if name in self._cache.name: + result = self._cache.name[name][0] + elif self._include_egg and name in self._cache_egg.name: + result = self._cache_egg.name[name][0] + return result + + def provides_distribution(self, name, version=None): + """ + Iterates over all distributions to find which distributions provide *name*. + If a *version* is provided, it will be used to filter the results. + + This function only returns the first result found, since no more than + one values are expected. If the directory is not found, returns ``None``. + + :parameter version: a version specifier that indicates the version + required, conforming to the format in ``PEP-345`` + + :type name: string + :type version: string + """ + matcher = None + if version is not None: + try: + matcher = self._scheme.matcher('%s (%s)' % (name, version)) + except ValueError: + raise DistlibException('invalid name or version: %r, %r' % (name, version)) + + for dist in self.get_distributions(): + # We hit a problem on Travis where enum34 was installed and doesn't + # have a provides attribute ... + if not hasattr(dist, 'provides'): + logger.debug('No "provides": %s', dist) + else: + provided = dist.provides + + for p in provided: + p_name, p_ver = parse_name_and_version(p) + if matcher is None: + if p_name == name: + yield dist + break + else: + if p_name == name and matcher.match(p_ver): + yield dist + break + + def get_file_path(self, name, relative_path): + """ + Return the path to a resource file. + """ + dist = self.get_distribution(name) + if dist is None: + raise LookupError('no distribution named %r found' % name) + return dist.get_resource_path(relative_path) + + def get_exported_entries(self, category, name=None): + """ + Return all of the exported entries in a particular category. + + :param category: The category to search for entries. + :param name: If specified, only entries with that name are returned. + """ + for dist in self.get_distributions(): + r = dist.exports + if category in r: + d = r[category] + if name is not None: + if name in d: + yield d[name] + else: + for v in d.values(): + yield v + + +class Distribution(object): + """ + A base class for distributions, whether installed or from indexes. + Either way, it must have some metadata, so that's all that's needed + for construction. + """ + + build_time_dependency = False + """ + Set to True if it's known to be only a build-time dependency (i.e. + not needed after installation). + """ + + requested = False + """A boolean that indicates whether the ``REQUESTED`` metadata file is + present (in other words, whether the package was installed by user + request or it was installed as a dependency).""" + + def __init__(self, metadata): + """ + Initialise an instance. + :param metadata: The instance of :class:`Metadata` describing this + distribution. + """ + self.metadata = metadata + self.name = metadata.name + self.key = self.name.lower() # for case-insensitive comparisons + self.version = metadata.version + self.locator = None + self.digest = None + self.extras = None # additional features requested + self.context = None # environment marker overrides + self.download_urls = set() + self.digests = {} + + @property + def source_url(self): + """ + The source archive download URL for this distribution. + """ + return self.metadata.source_url + + download_url = source_url # Backward compatibility + + @property + def name_and_version(self): + """ + A utility property which displays the name and version in parentheses. + """ + return '%s (%s)' % (self.name, self.version) + + @property + def provides(self): + """ + A set of distribution names and versions provided by this distribution. + :return: A set of "name (version)" strings. + """ + plist = self.metadata.provides + s = '%s (%s)' % (self.name, self.version) + if s not in plist: + plist.append(s) + return plist + + def _get_requirements(self, req_attr): + md = self.metadata + reqts = getattr(md, req_attr) + logger.debug('%s: got requirements %r from metadata: %r', self.name, req_attr, reqts) + return set(md.get_requirements(reqts, extras=self.extras, env=self.context)) + + @property + def run_requires(self): + return self._get_requirements('run_requires') + + @property + def meta_requires(self): + return self._get_requirements('meta_requires') + + @property + def build_requires(self): + return self._get_requirements('build_requires') + + @property + def test_requires(self): + return self._get_requirements('test_requires') + + @property + def dev_requires(self): + return self._get_requirements('dev_requires') + + def matches_requirement(self, req): + """ + Say if this instance matches (fulfills) a requirement. + :param req: The requirement to match. + :rtype req: str + :return: True if it matches, else False. + """ + # Requirement may contain extras - parse to lose those + # from what's passed to the matcher + r = parse_requirement(req) + scheme = get_scheme(self.metadata.scheme) + try: + matcher = scheme.matcher(r.requirement) + except UnsupportedVersionError: + # XXX compat-mode if cannot read the version + logger.warning('could not read version %r - using name only', req) + name = req.split()[0] + matcher = scheme.matcher(name) + + name = matcher.key # case-insensitive + + result = False + for p in self.provides: + p_name, p_ver = parse_name_and_version(p) + if p_name != name: + continue + try: + result = matcher.match(p_ver) + break + except UnsupportedVersionError: + pass + return result + + def __repr__(self): + """ + Return a textual representation of this instance, + """ + if self.source_url: + suffix = ' [%s]' % self.source_url + else: + suffix = '' + return '' % (self.name, self.version, suffix) + + def __eq__(self, other): + """ + See if this distribution is the same as another. + :param other: The distribution to compare with. To be equal to one + another. distributions must have the same type, name, + version and source_url. + :return: True if it is the same, else False. + """ + if type(other) is not type(self): + result = False + else: + result = (self.name == other.name and self.version == other.version and self.source_url == other.source_url) + return result + + def __hash__(self): + """ + Compute hash in a way which matches the equality test. + """ + return hash(self.name) + hash(self.version) + hash(self.source_url) + + +class BaseInstalledDistribution(Distribution): + """ + This is the base class for installed distributions (whether PEP 376 or + legacy). + """ + + hasher = None + + def __init__(self, metadata, path, env=None): + """ + Initialise an instance. + :param metadata: An instance of :class:`Metadata` which describes the + distribution. This will normally have been initialised + from a metadata file in the ``path``. + :param path: The path of the ``.dist-info`` or ``.egg-info`` + directory for the distribution. + :param env: This is normally the :class:`DistributionPath` + instance where this distribution was found. + """ + super(BaseInstalledDistribution, self).__init__(metadata) + self.path = path + self.dist_path = env + + def get_hash(self, data, hasher=None): + """ + Get the hash of some data, using a particular hash algorithm, if + specified. + + :param data: The data to be hashed. + :type data: bytes + :param hasher: The name of a hash implementation, supported by hashlib, + or ``None``. Examples of valid values are ``'sha1'``, + ``'sha224'``, ``'sha384'``, '``sha256'``, ``'md5'`` and + ``'sha512'``. If no hasher is specified, the ``hasher`` + attribute of the :class:`InstalledDistribution` instance + is used. If the hasher is determined to be ``None``, MD5 + is used as the hashing algorithm. + :returns: The hash of the data. If a hasher was explicitly specified, + the returned hash will be prefixed with the specified hasher + followed by '='. + :rtype: str + """ + if hasher is None: + hasher = self.hasher + if hasher is None: + hasher = hashlib.md5 + prefix = '' + else: + hasher = getattr(hashlib, hasher) + prefix = '%s=' % self.hasher + digest = hasher(data).digest() + digest = base64.urlsafe_b64encode(digest).rstrip(b'=').decode('ascii') + return '%s%s' % (prefix, digest) + + +class InstalledDistribution(BaseInstalledDistribution): + """ + Created with the *path* of the ``.dist-info`` directory provided to the + constructor. It reads the metadata contained in ``pydist.json`` when it is + instantiated., or uses a passed in Metadata instance (useful for when + dry-run mode is being used). + """ + + hasher = 'sha256' + + def __init__(self, path, metadata=None, env=None): + self.modules = [] + self.finder = finder = resources.finder_for_path(path) + if finder is None: + raise ValueError('finder unavailable for %s' % path) + if env and env._cache_enabled and path in env._cache.path: + metadata = env._cache.path[path].metadata + elif metadata is None: + r = finder.find(METADATA_FILENAME) + # Temporary - for Wheel 0.23 support + if r is None: + r = finder.find(WHEEL_METADATA_FILENAME) + # Temporary - for legacy support + if r is None: + r = finder.find(LEGACY_METADATA_FILENAME) + if r is None: + raise ValueError('no %s found in %s' % (METADATA_FILENAME, path)) + with contextlib.closing(r.as_stream()) as stream: + metadata = Metadata(fileobj=stream, scheme='legacy') + + super(InstalledDistribution, self).__init__(metadata, path, env) + + if env and env._cache_enabled: + env._cache.add(self) + + r = finder.find('REQUESTED') + self.requested = r is not None + p = os.path.join(path, 'top_level.txt') + if os.path.exists(p): + with open(p, 'rb') as f: + data = f.read().decode('utf-8') + self.modules = data.splitlines() + + def __repr__(self): + return '' % (self.name, self.version, self.path) + + def __str__(self): + return "%s %s" % (self.name, self.version) + + def _get_records(self): + """ + Get the list of installed files for the distribution + :return: A list of tuples of path, hash and size. Note that hash and + size might be ``None`` for some entries. The path is exactly + as stored in the file (which is as in PEP 376). + """ + results = [] + r = self.get_distinfo_resource('RECORD') + with contextlib.closing(r.as_stream()) as stream: + with CSVReader(stream=stream) as record_reader: + # Base location is parent dir of .dist-info dir + # base_location = os.path.dirname(self.path) + # base_location = os.path.abspath(base_location) + for row in record_reader: + missing = [None for i in range(len(row), 3)] + path, checksum, size = row + missing + # if not os.path.isabs(path): + # path = path.replace('/', os.sep) + # path = os.path.join(base_location, path) + results.append((path, checksum, size)) + return results + + @cached_property + def exports(self): + """ + Return the information exported by this distribution. + :return: A dictionary of exports, mapping an export category to a dict + of :class:`ExportEntry` instances describing the individual + export entries, and keyed by name. + """ + result = {} + r = self.get_distinfo_resource(EXPORTS_FILENAME) + if r: + result = self.read_exports() + return result + + def read_exports(self): + """ + Read exports data from a file in .ini format. + + :return: A dictionary of exports, mapping an export category to a list + of :class:`ExportEntry` instances describing the individual + export entries. + """ + result = {} + r = self.get_distinfo_resource(EXPORTS_FILENAME) + if r: + with contextlib.closing(r.as_stream()) as stream: + result = read_exports(stream) + return result + + def write_exports(self, exports): + """ + Write a dictionary of exports to a file in .ini format. + :param exports: A dictionary of exports, mapping an export category to + a list of :class:`ExportEntry` instances describing the + individual export entries. + """ + rf = self.get_distinfo_file(EXPORTS_FILENAME) + with open(rf, 'w') as f: + write_exports(exports, f) + + def get_resource_path(self, relative_path): + """ + NOTE: This API may change in the future. + + Return the absolute path to a resource file with the given relative + path. + + :param relative_path: The path, relative to .dist-info, of the resource + of interest. + :return: The absolute path where the resource is to be found. + """ + r = self.get_distinfo_resource('RESOURCES') + with contextlib.closing(r.as_stream()) as stream: + with CSVReader(stream=stream) as resources_reader: + for relative, destination in resources_reader: + if relative == relative_path: + return destination + raise KeyError('no resource file with relative path %r ' + 'is installed' % relative_path) + + def list_installed_files(self): + """ + Iterates over the ``RECORD`` entries and returns a tuple + ``(path, hash, size)`` for each line. + + :returns: iterator of (path, hash, size) + """ + for result in self._get_records(): + yield result + + def write_installed_files(self, paths, prefix, dry_run=False): + """ + Writes the ``RECORD`` file, using the ``paths`` iterable passed in. Any + existing ``RECORD`` file is silently overwritten. + + prefix is used to determine when to write absolute paths. + """ + prefix = os.path.join(prefix, '') + base = os.path.dirname(self.path) + base_under_prefix = base.startswith(prefix) + base = os.path.join(base, '') + record_path = self.get_distinfo_file('RECORD') + logger.info('creating %s', record_path) + if dry_run: + return None + with CSVWriter(record_path) as writer: + for path in paths: + if os.path.isdir(path) or path.endswith(('.pyc', '.pyo')): + # do not put size and hash, as in PEP-376 + hash_value = size = '' + else: + size = '%d' % os.path.getsize(path) + with open(path, 'rb') as fp: + hash_value = self.get_hash(fp.read()) + if path.startswith(base) or (base_under_prefix and path.startswith(prefix)): + path = os.path.relpath(path, base) + writer.writerow((path, hash_value, size)) + + # add the RECORD file itself + if record_path.startswith(base): + record_path = os.path.relpath(record_path, base) + writer.writerow((record_path, '', '')) + return record_path + + def check_installed_files(self): + """ + Checks that the hashes and sizes of the files in ``RECORD`` are + matched by the files themselves. Returns a (possibly empty) list of + mismatches. Each entry in the mismatch list will be a tuple consisting + of the path, 'exists', 'size' or 'hash' according to what didn't match + (existence is checked first, then size, then hash), the expected + value and the actual value. + """ + mismatches = [] + base = os.path.dirname(self.path) + record_path = self.get_distinfo_file('RECORD') + for path, hash_value, size in self.list_installed_files(): + if not os.path.isabs(path): + path = os.path.join(base, path) + if path == record_path: + continue + if not os.path.exists(path): + mismatches.append((path, 'exists', True, False)) + elif os.path.isfile(path): + actual_size = str(os.path.getsize(path)) + if size and actual_size != size: + mismatches.append((path, 'size', size, actual_size)) + elif hash_value: + if '=' in hash_value: + hasher = hash_value.split('=', 1)[0] + else: + hasher = None + + with open(path, 'rb') as f: + actual_hash = self.get_hash(f.read(), hasher) + if actual_hash != hash_value: + mismatches.append((path, 'hash', hash_value, actual_hash)) + return mismatches + + @cached_property + def shared_locations(self): + """ + A dictionary of shared locations whose keys are in the set 'prefix', + 'purelib', 'platlib', 'scripts', 'headers', 'data' and 'namespace'. + The corresponding value is the absolute path of that category for + this distribution, and takes into account any paths selected by the + user at installation time (e.g. via command-line arguments). In the + case of the 'namespace' key, this would be a list of absolute paths + for the roots of namespace packages in this distribution. + + The first time this property is accessed, the relevant information is + read from the SHARED file in the .dist-info directory. + """ + result = {} + shared_path = os.path.join(self.path, 'SHARED') + if os.path.isfile(shared_path): + with codecs.open(shared_path, 'r', encoding='utf-8') as f: + lines = f.read().splitlines() + for line in lines: + key, value = line.split('=', 1) + if key == 'namespace': + result.setdefault(key, []).append(value) + else: + result[key] = value + return result + + def write_shared_locations(self, paths, dry_run=False): + """ + Write shared location information to the SHARED file in .dist-info. + :param paths: A dictionary as described in the documentation for + :meth:`shared_locations`. + :param dry_run: If True, the action is logged but no file is actually + written. + :return: The path of the file written to. + """ + shared_path = os.path.join(self.path, 'SHARED') + logger.info('creating %s', shared_path) + if dry_run: + return None + lines = [] + for key in ('prefix', 'lib', 'headers', 'scripts', 'data'): + path = paths[key] + if os.path.isdir(paths[key]): + lines.append('%s=%s' % (key, path)) + for ns in paths.get('namespace', ()): + lines.append('namespace=%s' % ns) + + with codecs.open(shared_path, 'w', encoding='utf-8') as f: + f.write('\n'.join(lines)) + return shared_path + + def get_distinfo_resource(self, path): + if path not in DIST_FILES: + raise DistlibException('invalid path for a dist-info file: ' + '%r at %r' % (path, self.path)) + finder = resources.finder_for_path(self.path) + if finder is None: + raise DistlibException('Unable to get a finder for %s' % self.path) + return finder.find(path) + + def get_distinfo_file(self, path): + """ + Returns a path located under the ``.dist-info`` directory. Returns a + string representing the path. + + :parameter path: a ``'/'``-separated path relative to the + ``.dist-info`` directory or an absolute path; + If *path* is an absolute path and doesn't start + with the ``.dist-info`` directory path, + a :class:`DistlibException` is raised + :type path: str + :rtype: str + """ + # Check if it is an absolute path # XXX use relpath, add tests + if path.find(os.sep) >= 0: + # it's an absolute path? + distinfo_dirname, path = path.split(os.sep)[-2:] + if distinfo_dirname != self.path.split(os.sep)[-1]: + raise DistlibException('dist-info file %r does not belong to the %r %s ' + 'distribution' % (path, self.name, self.version)) + + # The file must be relative + if path not in DIST_FILES: + raise DistlibException('invalid path for a dist-info file: ' + '%r at %r' % (path, self.path)) + + return os.path.join(self.path, path) + + def list_distinfo_files(self): + """ + Iterates over the ``RECORD`` entries and returns paths for each line if + the path is pointing to a file located in the ``.dist-info`` directory + or one of its subdirectories. + + :returns: iterator of paths + """ + base = os.path.dirname(self.path) + for path, checksum, size in self._get_records(): + # XXX add separator or use real relpath algo + if not os.path.isabs(path): + path = os.path.join(base, path) + if path.startswith(self.path): + yield path + + def __eq__(self, other): + return (isinstance(other, InstalledDistribution) and self.path == other.path) + + # See http://docs.python.org/reference/datamodel#object.__hash__ + __hash__ = object.__hash__ + + +class EggInfoDistribution(BaseInstalledDistribution): + """Created with the *path* of the ``.egg-info`` directory or file provided + to the constructor. It reads the metadata contained in the file itself, or + if the given path happens to be a directory, the metadata is read from the + file ``PKG-INFO`` under that directory.""" + + requested = True # as we have no way of knowing, assume it was + shared_locations = {} + + def __init__(self, path, env=None): + + def set_name_and_version(s, n, v): + s.name = n + s.key = n.lower() # for case-insensitive comparisons + s.version = v + + self.path = path + self.dist_path = env + if env and env._cache_enabled and path in env._cache_egg.path: + metadata = env._cache_egg.path[path].metadata + set_name_and_version(self, metadata.name, metadata.version) + else: + metadata = self._get_metadata(path) + + # Need to be set before caching + set_name_and_version(self, metadata.name, metadata.version) + + if env and env._cache_enabled: + env._cache_egg.add(self) + super(EggInfoDistribution, self).__init__(metadata, path, env) + + def _get_metadata(self, path): + requires = None + + def parse_requires_data(data): + """Create a list of dependencies from a requires.txt file. + + *data*: the contents of a setuptools-produced requires.txt file. + """ + reqs = [] + lines = data.splitlines() + for line in lines: + line = line.strip() + # sectioned files have bare newlines (separating sections) + if not line: # pragma: no cover + continue + if line.startswith('['): # pragma: no cover + logger.warning('Unexpected line: quitting requirement scan: %r', line) + break + r = parse_requirement(line) + if not r: # pragma: no cover + logger.warning('Not recognised as a requirement: %r', line) + continue + if r.extras: # pragma: no cover + logger.warning('extra requirements in requires.txt are ' + 'not supported') + if not r.constraints: + reqs.append(r.name) + else: + cons = ', '.join('%s%s' % c for c in r.constraints) + reqs.append('%s (%s)' % (r.name, cons)) + return reqs + + def parse_requires_path(req_path): + """Create a list of dependencies from a requires.txt file. + + *req_path*: the path to a setuptools-produced requires.txt file. + """ + + reqs = [] + try: + with codecs.open(req_path, 'r', 'utf-8') as fp: + reqs = parse_requires_data(fp.read()) + except IOError: + pass + return reqs + + tl_path = tl_data = None + if path.endswith('.egg'): + if os.path.isdir(path): + p = os.path.join(path, 'EGG-INFO') + meta_path = os.path.join(p, 'PKG-INFO') + metadata = Metadata(path=meta_path, scheme='legacy') + req_path = os.path.join(p, 'requires.txt') + tl_path = os.path.join(p, 'top_level.txt') + requires = parse_requires_path(req_path) + else: + # FIXME handle the case where zipfile is not available + zipf = zipimport.zipimporter(path) + fileobj = StringIO(zipf.get_data('EGG-INFO/PKG-INFO').decode('utf8')) + metadata = Metadata(fileobj=fileobj, scheme='legacy') + try: + data = zipf.get_data('EGG-INFO/requires.txt') + tl_data = zipf.get_data('EGG-INFO/top_level.txt').decode('utf-8') + requires = parse_requires_data(data.decode('utf-8')) + except IOError: + requires = None + elif path.endswith('.egg-info'): + if os.path.isdir(path): + req_path = os.path.join(path, 'requires.txt') + requires = parse_requires_path(req_path) + path = os.path.join(path, 'PKG-INFO') + tl_path = os.path.join(path, 'top_level.txt') + metadata = Metadata(path=path, scheme='legacy') + else: + raise DistlibException('path must end with .egg-info or .egg, ' + 'got %r' % path) + + if requires: + metadata.add_requirements(requires) + # look for top-level modules in top_level.txt, if present + if tl_data is None: + if tl_path is not None and os.path.exists(tl_path): + with open(tl_path, 'rb') as f: + tl_data = f.read().decode('utf-8') + if not tl_data: + tl_data = [] + else: + tl_data = tl_data.splitlines() + self.modules = tl_data + return metadata + + def __repr__(self): + return '' % (self.name, self.version, self.path) + + def __str__(self): + return "%s %s" % (self.name, self.version) + + def check_installed_files(self): + """ + Checks that the hashes and sizes of the files in ``RECORD`` are + matched by the files themselves. Returns a (possibly empty) list of + mismatches. Each entry in the mismatch list will be a tuple consisting + of the path, 'exists', 'size' or 'hash' according to what didn't match + (existence is checked first, then size, then hash), the expected + value and the actual value. + """ + mismatches = [] + record_path = os.path.join(self.path, 'installed-files.txt') + if os.path.exists(record_path): + for path, _, _ in self.list_installed_files(): + if path == record_path: + continue + if not os.path.exists(path): + mismatches.append((path, 'exists', True, False)) + return mismatches + + def list_installed_files(self): + """ + Iterates over the ``installed-files.txt`` entries and returns a tuple + ``(path, hash, size)`` for each line. + + :returns: a list of (path, hash, size) + """ + + def _md5(path): + f = open(path, 'rb') + try: + content = f.read() + finally: + f.close() + return hashlib.md5(content).hexdigest() + + def _size(path): + return os.stat(path).st_size + + record_path = os.path.join(self.path, 'installed-files.txt') + result = [] + if os.path.exists(record_path): + with codecs.open(record_path, 'r', encoding='utf-8') as f: + for line in f: + line = line.strip() + p = os.path.normpath(os.path.join(self.path, line)) + # "./" is present as a marker between installed files + # and installation metadata files + if not os.path.exists(p): + logger.warning('Non-existent file: %s', p) + if p.endswith(('.pyc', '.pyo')): + continue + # otherwise fall through and fail + if not os.path.isdir(p): + result.append((p, _md5(p), _size(p))) + result.append((record_path, None, None)) + return result + + def list_distinfo_files(self, absolute=False): + """ + Iterates over the ``installed-files.txt`` entries and returns paths for + each line if the path is pointing to a file located in the + ``.egg-info`` directory or one of its subdirectories. + + :parameter absolute: If *absolute* is ``True``, each returned path is + transformed into a local absolute path. Otherwise the + raw value from ``installed-files.txt`` is returned. + :type absolute: boolean + :returns: iterator of paths + """ + record_path = os.path.join(self.path, 'installed-files.txt') + if os.path.exists(record_path): + skip = True + with codecs.open(record_path, 'r', encoding='utf-8') as f: + for line in f: + line = line.strip() + if line == './': + skip = False + continue + if not skip: + p = os.path.normpath(os.path.join(self.path, line)) + if p.startswith(self.path): + if absolute: + yield p + else: + yield line + + def __eq__(self, other): + return (isinstance(other, EggInfoDistribution) and self.path == other.path) + + # See http://docs.python.org/reference/datamodel#object.__hash__ + __hash__ = object.__hash__ + + +new_dist_class = InstalledDistribution +old_dist_class = EggInfoDistribution + + +class DependencyGraph(object): + """ + Represents a dependency graph between distributions. + + The dependency relationships are stored in an ``adjacency_list`` that maps + distributions to a list of ``(other, label)`` tuples where ``other`` + is a distribution and the edge is labeled with ``label`` (i.e. the version + specifier, if such was provided). Also, for more efficient traversal, for + every distribution ``x``, a list of predecessors is kept in + ``reverse_list[x]``. An edge from distribution ``a`` to + distribution ``b`` means that ``a`` depends on ``b``. If any missing + dependencies are found, they are stored in ``missing``, which is a + dictionary that maps distributions to a list of requirements that were not + provided by any other distributions. + """ + + def __init__(self): + self.adjacency_list = {} + self.reverse_list = {} + self.missing = {} + + def add_distribution(self, distribution): + """Add the *distribution* to the graph. + + :type distribution: :class:`distutils2.database.InstalledDistribution` + or :class:`distutils2.database.EggInfoDistribution` + """ + self.adjacency_list[distribution] = [] + self.reverse_list[distribution] = [] + # self.missing[distribution] = [] + + def add_edge(self, x, y, label=None): + """Add an edge from distribution *x* to distribution *y* with the given + *label*. + + :type x: :class:`distutils2.database.InstalledDistribution` or + :class:`distutils2.database.EggInfoDistribution` + :type y: :class:`distutils2.database.InstalledDistribution` or + :class:`distutils2.database.EggInfoDistribution` + :type label: ``str`` or ``None`` + """ + self.adjacency_list[x].append((y, label)) + # multiple edges are allowed, so be careful + if x not in self.reverse_list[y]: + self.reverse_list[y].append(x) + + def add_missing(self, distribution, requirement): + """ + Add a missing *requirement* for the given *distribution*. + + :type distribution: :class:`distutils2.database.InstalledDistribution` + or :class:`distutils2.database.EggInfoDistribution` + :type requirement: ``str`` + """ + logger.debug('%s missing %r', distribution, requirement) + self.missing.setdefault(distribution, []).append(requirement) + + def _repr_dist(self, dist): + return '%s %s' % (dist.name, dist.version) + + def repr_node(self, dist, level=1): + """Prints only a subgraph""" + output = [self._repr_dist(dist)] + for other, label in self.adjacency_list[dist]: + dist = self._repr_dist(other) + if label is not None: + dist = '%s [%s]' % (dist, label) + output.append(' ' * level + str(dist)) + suboutput = self.repr_node(other, level + 1) + subs = suboutput.split('\n') + output.extend(subs[1:]) + return '\n'.join(output) + + def to_dot(self, f, skip_disconnected=True): + """Writes a DOT output for the graph to the provided file *f*. + + If *skip_disconnected* is set to ``True``, then all distributions + that are not dependent on any other distribution are skipped. + + :type f: has to support ``file``-like operations + :type skip_disconnected: ``bool`` + """ + disconnected = [] + + f.write("digraph dependencies {\n") + for dist, adjs in self.adjacency_list.items(): + if len(adjs) == 0 and not skip_disconnected: + disconnected.append(dist) + for other, label in adjs: + if label is not None: + f.write('"%s" -> "%s" [label="%s"]\n' % (dist.name, other.name, label)) + else: + f.write('"%s" -> "%s"\n' % (dist.name, other.name)) + if not skip_disconnected and len(disconnected) > 0: + f.write('subgraph disconnected {\n') + f.write('label = "Disconnected"\n') + f.write('bgcolor = red\n') + + for dist in disconnected: + f.write('"%s"' % dist.name) + f.write('\n') + f.write('}\n') + f.write('}\n') + + def topological_sort(self): + """ + Perform a topological sort of the graph. + :return: A tuple, the first element of which is a topologically sorted + list of distributions, and the second element of which is a + list of distributions that cannot be sorted because they have + circular dependencies and so form a cycle. + """ + result = [] + # Make a shallow copy of the adjacency list + alist = {} + for k, v in self.adjacency_list.items(): + alist[k] = v[:] + while True: + # See what we can remove in this run + to_remove = [] + for k, v in list(alist.items())[:]: + if not v: + to_remove.append(k) + del alist[k] + if not to_remove: + # What's left in alist (if anything) is a cycle. + break + # Remove from the adjacency list of others + for k, v in alist.items(): + alist[k] = [(d, r) for d, r in v if d not in to_remove] + logger.debug('Moving to result: %s', ['%s (%s)' % (d.name, d.version) for d in to_remove]) + result.extend(to_remove) + return result, list(alist.keys()) + + def __repr__(self): + """Representation of the graph""" + output = [] + for dist, adjs in self.adjacency_list.items(): + output.append(self.repr_node(dist)) + return '\n'.join(output) + + +def make_graph(dists, scheme='default'): + """Makes a dependency graph from the given distributions. + + :parameter dists: a list of distributions + :type dists: list of :class:`distutils2.database.InstalledDistribution` and + :class:`distutils2.database.EggInfoDistribution` instances + :rtype: a :class:`DependencyGraph` instance + """ + scheme = get_scheme(scheme) + graph = DependencyGraph() + provided = {} # maps names to lists of (version, dist) tuples + + # first, build the graph and find out what's provided + for dist in dists: + graph.add_distribution(dist) + + for p in dist.provides: + name, version = parse_name_and_version(p) + logger.debug('Add to provided: %s, %s, %s', name, version, dist) + provided.setdefault(name, []).append((version, dist)) + + # now make the edges + for dist in dists: + requires = (dist.run_requires | dist.meta_requires | dist.build_requires | dist.dev_requires) + for req in requires: + try: + matcher = scheme.matcher(req) + except UnsupportedVersionError: + # XXX compat-mode if cannot read the version + logger.warning('could not read version %r - using name only', req) + name = req.split()[0] + matcher = scheme.matcher(name) + + name = matcher.key # case-insensitive + + matched = False + if name in provided: + for version, provider in provided[name]: + try: + match = matcher.match(version) + except UnsupportedVersionError: + match = False + + if match: + graph.add_edge(dist, provider, req) + matched = True + break + if not matched: + graph.add_missing(dist, req) + return graph + + +def get_dependent_dists(dists, dist): + """Recursively generate a list of distributions from *dists* that are + dependent on *dist*. + + :param dists: a list of distributions + :param dist: a distribution, member of *dists* for which we are interested + """ + if dist not in dists: + raise DistlibException('given distribution %r is not a member ' + 'of the list' % dist.name) + graph = make_graph(dists) + + dep = [dist] # dependent distributions + todo = graph.reverse_list[dist] # list of nodes we should inspect + + while todo: + d = todo.pop() + dep.append(d) + for succ in graph.reverse_list[d]: + if succ not in dep: + todo.append(succ) + + dep.pop(0) # remove dist from dep, was there to prevent infinite loops + return dep + + +def get_required_dists(dists, dist): + """Recursively generate a list of distributions from *dists* that are + required by *dist*. + + :param dists: a list of distributions + :param dist: a distribution, member of *dists* for which we are interested + in finding the dependencies. + """ + if dist not in dists: + raise DistlibException('given distribution %r is not a member ' + 'of the list' % dist.name) + graph = make_graph(dists) + + req = set() # required distributions + todo = graph.adjacency_list[dist] # list of nodes we should inspect + seen = set(t[0] for t in todo) # already added to todo + + while todo: + d = todo.pop()[0] + req.add(d) + pred_list = graph.adjacency_list[d] + for pred in pred_list: + d = pred[0] + if d not in req and d not in seen: + seen.add(d) + todo.append(pred) + return req + + +def make_dist(name, version, **kwargs): + """ + A convenience method for making a dist given just a name and version. + """ + summary = kwargs.pop('summary', 'Placeholder for summary') + md = Metadata(**kwargs) + md.name = name + md.version = version + md.summary = summary or 'Placeholder for summary' + return Distribution(md) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/index.py b/env/lib/python3.12/site-packages/pip/_vendor/distlib/index.py new file mode 100644 index 0000000..56cd286 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distlib/index.py @@ -0,0 +1,508 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +import hashlib +import logging +import os +import shutil +import subprocess +import tempfile +try: + from threading import Thread +except ImportError: # pragma: no cover + from dummy_threading import Thread + +from . import DistlibException +from .compat import (HTTPBasicAuthHandler, Request, HTTPPasswordMgr, + urlparse, build_opener, string_types) +from .util import zip_dir, ServerProxy + +logger = logging.getLogger(__name__) + +DEFAULT_INDEX = 'https://pypi.org/pypi' +DEFAULT_REALM = 'pypi' + + +class PackageIndex(object): + """ + This class represents a package index compatible with PyPI, the Python + Package Index. + """ + + boundary = b'----------ThIs_Is_tHe_distlib_index_bouNdaRY_$' + + def __init__(self, url=None): + """ + Initialise an instance. + + :param url: The URL of the index. If not specified, the URL for PyPI is + used. + """ + self.url = url or DEFAULT_INDEX + self.read_configuration() + scheme, netloc, path, params, query, frag = urlparse(self.url) + if params or query or frag or scheme not in ('http', 'https'): + raise DistlibException('invalid repository: %s' % self.url) + self.password_handler = None + self.ssl_verifier = None + self.gpg = None + self.gpg_home = None + with open(os.devnull, 'w') as sink: + # Use gpg by default rather than gpg2, as gpg2 insists on + # prompting for passwords + for s in ('gpg', 'gpg2'): + try: + rc = subprocess.check_call([s, '--version'], stdout=sink, + stderr=sink) + if rc == 0: + self.gpg = s + break + except OSError: + pass + + def _get_pypirc_command(self): + """ + Get the distutils command for interacting with PyPI configurations. + :return: the command. + """ + from .util import _get_pypirc_command as cmd + return cmd() + + def read_configuration(self): + """ + Read the PyPI access configuration as supported by distutils. This populates + ``username``, ``password``, ``realm`` and ``url`` attributes from the + configuration. + """ + from .util import _load_pypirc + cfg = _load_pypirc(self) + self.username = cfg.get('username') + self.password = cfg.get('password') + self.realm = cfg.get('realm', 'pypi') + self.url = cfg.get('repository', self.url) + + def save_configuration(self): + """ + Save the PyPI access configuration. You must have set ``username`` and + ``password`` attributes before calling this method. + """ + self.check_credentials() + from .util import _store_pypirc + _store_pypirc(self) + + def check_credentials(self): + """ + Check that ``username`` and ``password`` have been set, and raise an + exception if not. + """ + if self.username is None or self.password is None: + raise DistlibException('username and password must be set') + pm = HTTPPasswordMgr() + _, netloc, _, _, _, _ = urlparse(self.url) + pm.add_password(self.realm, netloc, self.username, self.password) + self.password_handler = HTTPBasicAuthHandler(pm) + + def register(self, metadata): # pragma: no cover + """ + Register a distribution on PyPI, using the provided metadata. + + :param metadata: A :class:`Metadata` instance defining at least a name + and version number for the distribution to be + registered. + :return: The HTTP response received from PyPI upon submission of the + request. + """ + self.check_credentials() + metadata.validate() + d = metadata.todict() + d[':action'] = 'verify' + request = self.encode_request(d.items(), []) + self.send_request(request) + d[':action'] = 'submit' + request = self.encode_request(d.items(), []) + return self.send_request(request) + + def _reader(self, name, stream, outbuf): + """ + Thread runner for reading lines of from a subprocess into a buffer. + + :param name: The logical name of the stream (used for logging only). + :param stream: The stream to read from. This will typically a pipe + connected to the output stream of a subprocess. + :param outbuf: The list to append the read lines to. + """ + while True: + s = stream.readline() + if not s: + break + s = s.decode('utf-8').rstrip() + outbuf.append(s) + logger.debug('%s: %s' % (name, s)) + stream.close() + + def get_sign_command(self, filename, signer, sign_password, keystore=None): # pragma: no cover + """ + Return a suitable command for signing a file. + + :param filename: The pathname to the file to be signed. + :param signer: The identifier of the signer of the file. + :param sign_password: The passphrase for the signer's + private key used for signing. + :param keystore: The path to a directory which contains the keys + used in verification. If not specified, the + instance's ``gpg_home`` attribute is used instead. + :return: The signing command as a list suitable to be + passed to :class:`subprocess.Popen`. + """ + cmd = [self.gpg, '--status-fd', '2', '--no-tty'] + if keystore is None: + keystore = self.gpg_home + if keystore: + cmd.extend(['--homedir', keystore]) + if sign_password is not None: + cmd.extend(['--batch', '--passphrase-fd', '0']) + td = tempfile.mkdtemp() + sf = os.path.join(td, os.path.basename(filename) + '.asc') + cmd.extend(['--detach-sign', '--armor', '--local-user', + signer, '--output', sf, filename]) + logger.debug('invoking: %s', ' '.join(cmd)) + return cmd, sf + + def run_command(self, cmd, input_data=None): + """ + Run a command in a child process , passing it any input data specified. + + :param cmd: The command to run. + :param input_data: If specified, this must be a byte string containing + data to be sent to the child process. + :return: A tuple consisting of the subprocess' exit code, a list of + lines read from the subprocess' ``stdout``, and a list of + lines read from the subprocess' ``stderr``. + """ + kwargs = { + 'stdout': subprocess.PIPE, + 'stderr': subprocess.PIPE, + } + if input_data is not None: + kwargs['stdin'] = subprocess.PIPE + stdout = [] + stderr = [] + p = subprocess.Popen(cmd, **kwargs) + # We don't use communicate() here because we may need to + # get clever with interacting with the command + t1 = Thread(target=self._reader, args=('stdout', p.stdout, stdout)) + t1.start() + t2 = Thread(target=self._reader, args=('stderr', p.stderr, stderr)) + t2.start() + if input_data is not None: + p.stdin.write(input_data) + p.stdin.close() + + p.wait() + t1.join() + t2.join() + return p.returncode, stdout, stderr + + def sign_file(self, filename, signer, sign_password, keystore=None): # pragma: no cover + """ + Sign a file. + + :param filename: The pathname to the file to be signed. + :param signer: The identifier of the signer of the file. + :param sign_password: The passphrase for the signer's + private key used for signing. + :param keystore: The path to a directory which contains the keys + used in signing. If not specified, the instance's + ``gpg_home`` attribute is used instead. + :return: The absolute pathname of the file where the signature is + stored. + """ + cmd, sig_file = self.get_sign_command(filename, signer, sign_password, + keystore) + rc, stdout, stderr = self.run_command(cmd, + sign_password.encode('utf-8')) + if rc != 0: + raise DistlibException('sign command failed with error ' + 'code %s' % rc) + return sig_file + + def upload_file(self, metadata, filename, signer=None, sign_password=None, + filetype='sdist', pyversion='source', keystore=None): + """ + Upload a release file to the index. + + :param metadata: A :class:`Metadata` instance defining at least a name + and version number for the file to be uploaded. + :param filename: The pathname of the file to be uploaded. + :param signer: The identifier of the signer of the file. + :param sign_password: The passphrase for the signer's + private key used for signing. + :param filetype: The type of the file being uploaded. This is the + distutils command which produced that file, e.g. + ``sdist`` or ``bdist_wheel``. + :param pyversion: The version of Python which the release relates + to. For code compatible with any Python, this would + be ``source``, otherwise it would be e.g. ``3.2``. + :param keystore: The path to a directory which contains the keys + used in signing. If not specified, the instance's + ``gpg_home`` attribute is used instead. + :return: The HTTP response received from PyPI upon submission of the + request. + """ + self.check_credentials() + if not os.path.exists(filename): + raise DistlibException('not found: %s' % filename) + metadata.validate() + d = metadata.todict() + sig_file = None + if signer: + if not self.gpg: + logger.warning('no signing program available - not signed') + else: + sig_file = self.sign_file(filename, signer, sign_password, + keystore) + with open(filename, 'rb') as f: + file_data = f.read() + md5_digest = hashlib.md5(file_data).hexdigest() + sha256_digest = hashlib.sha256(file_data).hexdigest() + d.update({ + ':action': 'file_upload', + 'protocol_version': '1', + 'filetype': filetype, + 'pyversion': pyversion, + 'md5_digest': md5_digest, + 'sha256_digest': sha256_digest, + }) + files = [('content', os.path.basename(filename), file_data)] + if sig_file: + with open(sig_file, 'rb') as f: + sig_data = f.read() + files.append(('gpg_signature', os.path.basename(sig_file), + sig_data)) + shutil.rmtree(os.path.dirname(sig_file)) + request = self.encode_request(d.items(), files) + return self.send_request(request) + + def upload_documentation(self, metadata, doc_dir): # pragma: no cover + """ + Upload documentation to the index. + + :param metadata: A :class:`Metadata` instance defining at least a name + and version number for the documentation to be + uploaded. + :param doc_dir: The pathname of the directory which contains the + documentation. This should be the directory that + contains the ``index.html`` for the documentation. + :return: The HTTP response received from PyPI upon submission of the + request. + """ + self.check_credentials() + if not os.path.isdir(doc_dir): + raise DistlibException('not a directory: %r' % doc_dir) + fn = os.path.join(doc_dir, 'index.html') + if not os.path.exists(fn): + raise DistlibException('not found: %r' % fn) + metadata.validate() + name, version = metadata.name, metadata.version + zip_data = zip_dir(doc_dir).getvalue() + fields = [(':action', 'doc_upload'), + ('name', name), ('version', version)] + files = [('content', name, zip_data)] + request = self.encode_request(fields, files) + return self.send_request(request) + + def get_verify_command(self, signature_filename, data_filename, + keystore=None): + """ + Return a suitable command for verifying a file. + + :param signature_filename: The pathname to the file containing the + signature. + :param data_filename: The pathname to the file containing the + signed data. + :param keystore: The path to a directory which contains the keys + used in verification. If not specified, the + instance's ``gpg_home`` attribute is used instead. + :return: The verifying command as a list suitable to be + passed to :class:`subprocess.Popen`. + """ + cmd = [self.gpg, '--status-fd', '2', '--no-tty'] + if keystore is None: + keystore = self.gpg_home + if keystore: + cmd.extend(['--homedir', keystore]) + cmd.extend(['--verify', signature_filename, data_filename]) + logger.debug('invoking: %s', ' '.join(cmd)) + return cmd + + def verify_signature(self, signature_filename, data_filename, + keystore=None): + """ + Verify a signature for a file. + + :param signature_filename: The pathname to the file containing the + signature. + :param data_filename: The pathname to the file containing the + signed data. + :param keystore: The path to a directory which contains the keys + used in verification. If not specified, the + instance's ``gpg_home`` attribute is used instead. + :return: True if the signature was verified, else False. + """ + if not self.gpg: + raise DistlibException('verification unavailable because gpg ' + 'unavailable') + cmd = self.get_verify_command(signature_filename, data_filename, + keystore) + rc, stdout, stderr = self.run_command(cmd) + if rc not in (0, 1): + raise DistlibException('verify command failed with error code %s' % rc) + return rc == 0 + + def download_file(self, url, destfile, digest=None, reporthook=None): + """ + This is a convenience method for downloading a file from an URL. + Normally, this will be a file from the index, though currently + no check is made for this (i.e. a file can be downloaded from + anywhere). + + The method is just like the :func:`urlretrieve` function in the + standard library, except that it allows digest computation to be + done during download and checking that the downloaded data + matched any expected value. + + :param url: The URL of the file to be downloaded (assumed to be + available via an HTTP GET request). + :param destfile: The pathname where the downloaded file is to be + saved. + :param digest: If specified, this must be a (hasher, value) + tuple, where hasher is the algorithm used (e.g. + ``'md5'``) and ``value`` is the expected value. + :param reporthook: The same as for :func:`urlretrieve` in the + standard library. + """ + if digest is None: + digester = None + logger.debug('No digest specified') + else: + if isinstance(digest, (list, tuple)): + hasher, digest = digest + else: + hasher = 'md5' + digester = getattr(hashlib, hasher)() + logger.debug('Digest specified: %s' % digest) + # The following code is equivalent to urlretrieve. + # We need to do it this way so that we can compute the + # digest of the file as we go. + with open(destfile, 'wb') as dfp: + # addinfourl is not a context manager on 2.x + # so we have to use try/finally + sfp = self.send_request(Request(url)) + try: + headers = sfp.info() + blocksize = 8192 + size = -1 + read = 0 + blocknum = 0 + if "content-length" in headers: + size = int(headers["Content-Length"]) + if reporthook: + reporthook(blocknum, blocksize, size) + while True: + block = sfp.read(blocksize) + if not block: + break + read += len(block) + dfp.write(block) + if digester: + digester.update(block) + blocknum += 1 + if reporthook: + reporthook(blocknum, blocksize, size) + finally: + sfp.close() + + # check that we got the whole file, if we can + if size >= 0 and read < size: + raise DistlibException( + 'retrieval incomplete: got only %d out of %d bytes' + % (read, size)) + # if we have a digest, it must match. + if digester: + actual = digester.hexdigest() + if digest != actual: + raise DistlibException('%s digest mismatch for %s: expected ' + '%s, got %s' % (hasher, destfile, + digest, actual)) + logger.debug('Digest verified: %s', digest) + + def send_request(self, req): + """ + Send a standard library :class:`Request` to PyPI and return its + response. + + :param req: The request to send. + :return: The HTTP response from PyPI (a standard library HTTPResponse). + """ + handlers = [] + if self.password_handler: + handlers.append(self.password_handler) + if self.ssl_verifier: + handlers.append(self.ssl_verifier) + opener = build_opener(*handlers) + return opener.open(req) + + def encode_request(self, fields, files): + """ + Encode fields and files for posting to an HTTP server. + + :param fields: The fields to send as a list of (fieldname, value) + tuples. + :param files: The files to send as a list of (fieldname, filename, + file_bytes) tuple. + """ + # Adapted from packaging, which in turn was adapted from + # http://code.activestate.com/recipes/146306 + + parts = [] + boundary = self.boundary + for k, values in fields: + if not isinstance(values, (list, tuple)): + values = [values] + + for v in values: + parts.extend(( + b'--' + boundary, + ('Content-Disposition: form-data; name="%s"' % + k).encode('utf-8'), + b'', + v.encode('utf-8'))) + for key, filename, value in files: + parts.extend(( + b'--' + boundary, + ('Content-Disposition: form-data; name="%s"; filename="%s"' % + (key, filename)).encode('utf-8'), + b'', + value)) + + parts.extend((b'--' + boundary + b'--', b'')) + + body = b'\r\n'.join(parts) + ct = b'multipart/form-data; boundary=' + boundary + headers = { + 'Content-type': ct, + 'Content-length': str(len(body)) + } + return Request(self.url, body, headers) + + def search(self, terms, operator=None): # pragma: no cover + if isinstance(terms, string_types): + terms = {'name': terms} + rpc_proxy = ServerProxy(self.url, timeout=3.0) + try: + return rpc_proxy.search(terms, operator or 'and') + finally: + rpc_proxy('close')() diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/locators.py b/env/lib/python3.12/site-packages/pip/_vendor/distlib/locators.py new file mode 100644 index 0000000..222c1bf --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distlib/locators.py @@ -0,0 +1,1295 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# + +import gzip +from io import BytesIO +import json +import logging +import os +import posixpath +import re +try: + import threading +except ImportError: # pragma: no cover + import dummy_threading as threading +import zlib + +from . import DistlibException +from .compat import (urljoin, urlparse, urlunparse, url2pathname, pathname2url, queue, quote, unescape, build_opener, + HTTPRedirectHandler as BaseRedirectHandler, text_type, Request, HTTPError, URLError) +from .database import Distribution, DistributionPath, make_dist +from .metadata import Metadata, MetadataInvalidError +from .util import (cached_property, ensure_slash, split_filename, get_project_data, parse_requirement, + parse_name_and_version, ServerProxy, normalize_name) +from .version import get_scheme, UnsupportedVersionError +from .wheel import Wheel, is_compatible + +logger = logging.getLogger(__name__) + +HASHER_HASH = re.compile(r'^(\w+)=([a-f0-9]+)') +CHARSET = re.compile(r';\s*charset\s*=\s*(.*)\s*$', re.I) +HTML_CONTENT_TYPE = re.compile('text/html|application/x(ht)?ml') +DEFAULT_INDEX = 'https://pypi.org/pypi' + + +def get_all_distribution_names(url=None): + """ + Return all distribution names known by an index. + :param url: The URL of the index. + :return: A list of all known distribution names. + """ + if url is None: + url = DEFAULT_INDEX + client = ServerProxy(url, timeout=3.0) + try: + return client.list_packages() + finally: + client('close')() + + +class RedirectHandler(BaseRedirectHandler): + """ + A class to work around a bug in some Python 3.2.x releases. + """ + + # There's a bug in the base version for some 3.2.x + # (e.g. 3.2.2 on Ubuntu Oneiric). If a Location header + # returns e.g. /abc, it bails because it says the scheme '' + # is bogus, when actually it should use the request's + # URL for the scheme. See Python issue #13696. + def http_error_302(self, req, fp, code, msg, headers): + # Some servers (incorrectly) return multiple Location headers + # (so probably same goes for URI). Use first header. + newurl = None + for key in ('location', 'uri'): + if key in headers: + newurl = headers[key] + break + if newurl is None: # pragma: no cover + return + urlparts = urlparse(newurl) + if urlparts.scheme == '': + newurl = urljoin(req.get_full_url(), newurl) + if hasattr(headers, 'replace_header'): + headers.replace_header(key, newurl) + else: + headers[key] = newurl + return BaseRedirectHandler.http_error_302(self, req, fp, code, msg, headers) + + http_error_301 = http_error_303 = http_error_307 = http_error_302 + + +class Locator(object): + """ + A base class for locators - things that locate distributions. + """ + source_extensions = ('.tar.gz', '.tar.bz2', '.tar', '.zip', '.tgz', '.tbz') + binary_extensions = ('.egg', '.exe', '.whl') + excluded_extensions = ('.pdf', ) + + # A list of tags indicating which wheels you want to match. The default + # value of None matches against the tags compatible with the running + # Python. If you want to match other values, set wheel_tags on a locator + # instance to a list of tuples (pyver, abi, arch) which you want to match. + wheel_tags = None + + downloadable_extensions = source_extensions + ('.whl', ) + + def __init__(self, scheme='default'): + """ + Initialise an instance. + :param scheme: Because locators look for most recent versions, they + need to know the version scheme to use. This specifies + the current PEP-recommended scheme - use ``'legacy'`` + if you need to support existing distributions on PyPI. + """ + self._cache = {} + self.scheme = scheme + # Because of bugs in some of the handlers on some of the platforms, + # we use our own opener rather than just using urlopen. + self.opener = build_opener(RedirectHandler()) + # If get_project() is called from locate(), the matcher instance + # is set from the requirement passed to locate(). See issue #18 for + # why this can be useful to know. + self.matcher = None + self.errors = queue.Queue() + + def get_errors(self): + """ + Return any errors which have occurred. + """ + result = [] + while not self.errors.empty(): # pragma: no cover + try: + e = self.errors.get(False) + result.append(e) + except self.errors.Empty: + continue + self.errors.task_done() + return result + + def clear_errors(self): + """ + Clear any errors which may have been logged. + """ + # Just get the errors and throw them away + self.get_errors() + + def clear_cache(self): + self._cache.clear() + + def _get_scheme(self): + return self._scheme + + def _set_scheme(self, value): + self._scheme = value + + scheme = property(_get_scheme, _set_scheme) + + def _get_project(self, name): + """ + For a given project, get a dictionary mapping available versions to Distribution + instances. + + This should be implemented in subclasses. + + If called from a locate() request, self.matcher will be set to a + matcher for the requirement to satisfy, otherwise it will be None. + """ + raise NotImplementedError('Please implement in the subclass') + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + raise NotImplementedError('Please implement in the subclass') + + def get_project(self, name): + """ + For a given project, get a dictionary mapping available versions to Distribution + instances. + + This calls _get_project to do all the work, and just implements a caching layer on top. + """ + if self._cache is None: # pragma: no cover + result = self._get_project(name) + elif name in self._cache: + result = self._cache[name] + else: + self.clear_errors() + result = self._get_project(name) + self._cache[name] = result + return result + + def score_url(self, url): + """ + Give an url a score which can be used to choose preferred URLs + for a given project release. + """ + t = urlparse(url) + basename = posixpath.basename(t.path) + compatible = True + is_wheel = basename.endswith('.whl') + is_downloadable = basename.endswith(self.downloadable_extensions) + if is_wheel: + compatible = is_compatible(Wheel(basename), self.wheel_tags) + return (t.scheme == 'https', 'pypi.org' in t.netloc, is_downloadable, is_wheel, compatible, basename) + + def prefer_url(self, url1, url2): + """ + Choose one of two URLs where both are candidates for distribution + archives for the same version of a distribution (for example, + .tar.gz vs. zip). + + The current implementation favours https:// URLs over http://, archives + from PyPI over those from other locations, wheel compatibility (if a + wheel) and then the archive name. + """ + result = url2 + if url1: + s1 = self.score_url(url1) + s2 = self.score_url(url2) + if s1 > s2: + result = url1 + if result != url2: + logger.debug('Not replacing %r with %r', url1, url2) + else: + logger.debug('Replacing %r with %r', url1, url2) + return result + + def split_filename(self, filename, project_name): + """ + Attempt to split a filename in project name, version and Python version. + """ + return split_filename(filename, project_name) + + def convert_url_to_download_info(self, url, project_name): + """ + See if a URL is a candidate for a download URL for a project (the URL + has typically been scraped from an HTML page). + + If it is, a dictionary is returned with keys "name", "version", + "filename" and "url"; otherwise, None is returned. + """ + + def same_project(name1, name2): + return normalize_name(name1) == normalize_name(name2) + + result = None + scheme, netloc, path, params, query, frag = urlparse(url) + if frag.lower().startswith('egg='): # pragma: no cover + logger.debug('%s: version hint in fragment: %r', project_name, frag) + m = HASHER_HASH.match(frag) + if m: + algo, digest = m.groups() + else: + algo, digest = None, None + origpath = path + if path and path[-1] == '/': # pragma: no cover + path = path[:-1] + if path.endswith('.whl'): + try: + wheel = Wheel(path) + if not is_compatible(wheel, self.wheel_tags): + logger.debug('Wheel not compatible: %s', path) + else: + if project_name is None: + include = True + else: + include = same_project(wheel.name, project_name) + if include: + result = { + 'name': wheel.name, + 'version': wheel.version, + 'filename': wheel.filename, + 'url': urlunparse((scheme, netloc, origpath, params, query, '')), + 'python-version': ', '.join(['.'.join(list(v[2:])) for v in wheel.pyver]), + } + except Exception: # pragma: no cover + logger.warning('invalid path for wheel: %s', path) + elif not path.endswith(self.downloadable_extensions): # pragma: no cover + logger.debug('Not downloadable: %s', path) + else: # downloadable extension + path = filename = posixpath.basename(path) + for ext in self.downloadable_extensions: + if path.endswith(ext): + path = path[:-len(ext)] + t = self.split_filename(path, project_name) + if not t: # pragma: no cover + logger.debug('No match for project/version: %s', path) + else: + name, version, pyver = t + if not project_name or same_project(project_name, name): + result = { + 'name': name, + 'version': version, + 'filename': filename, + 'url': urlunparse((scheme, netloc, origpath, params, query, '')), + } + if pyver: # pragma: no cover + result['python-version'] = pyver + break + if result and algo: + result['%s_digest' % algo] = digest + return result + + def _get_digest(self, info): + """ + Get a digest from a dictionary by looking at a "digests" dictionary + or keys of the form 'algo_digest'. + + Returns a 2-tuple (algo, digest) if found, else None. Currently + looks only for SHA256, then MD5. + """ + result = None + if 'digests' in info: + digests = info['digests'] + for algo in ('sha256', 'md5'): + if algo in digests: + result = (algo, digests[algo]) + break + if not result: + for algo in ('sha256', 'md5'): + key = '%s_digest' % algo + if key in info: + result = (algo, info[key]) + break + return result + + def _update_version_data(self, result, info): + """ + Update a result dictionary (the final result from _get_project) with a + dictionary for a specific version, which typically holds information + gleaned from a filename or URL for an archive for the distribution. + """ + name = info.pop('name') + version = info.pop('version') + if version in result: + dist = result[version] + md = dist.metadata + else: + dist = make_dist(name, version, scheme=self.scheme) + md = dist.metadata + dist.digest = digest = self._get_digest(info) + url = info['url'] + result['digests'][url] = digest + if md.source_url != info['url']: + md.source_url = self.prefer_url(md.source_url, url) + result['urls'].setdefault(version, set()).add(url) + dist.locator = self + result[version] = dist + + def locate(self, requirement, prereleases=False): + """ + Find the most recent distribution which matches the given + requirement. + + :param requirement: A requirement of the form 'foo (1.0)' or perhaps + 'foo (>= 1.0, < 2.0, != 1.3)' + :param prereleases: If ``True``, allow pre-release versions + to be located. Otherwise, pre-release versions + are not returned. + :return: A :class:`Distribution` instance, or ``None`` if no such + distribution could be located. + """ + result = None + r = parse_requirement(requirement) + if r is None: # pragma: no cover + raise DistlibException('Not a valid requirement: %r' % requirement) + scheme = get_scheme(self.scheme) + self.matcher = matcher = scheme.matcher(r.requirement) + logger.debug('matcher: %s (%s)', matcher, type(matcher).__name__) + versions = self.get_project(r.name) + if len(versions) > 2: # urls and digests keys are present + # sometimes, versions are invalid + slist = [] + vcls = matcher.version_class + for k in versions: + if k in ('urls', 'digests'): + continue + try: + if not matcher.match(k): + pass # logger.debug('%s did not match %r', matcher, k) + else: + if prereleases or not vcls(k).is_prerelease: + slist.append(k) + except Exception: # pragma: no cover + logger.warning('error matching %s with %r', matcher, k) + pass # slist.append(k) + if len(slist) > 1: + slist = sorted(slist, key=scheme.key) + if slist: + logger.debug('sorted list: %s', slist) + version = slist[-1] + result = versions[version] + if result: + if r.extras: + result.extras = r.extras + result.download_urls = versions.get('urls', {}).get(version, set()) + d = {} + sd = versions.get('digests', {}) + for url in result.download_urls: + if url in sd: # pragma: no cover + d[url] = sd[url] + result.digests = d + self.matcher = None + return result + + +class PyPIRPCLocator(Locator): + """ + This locator uses XML-RPC to locate distributions. It therefore + cannot be used with simple mirrors (that only mirror file content). + """ + + def __init__(self, url, **kwargs): + """ + Initialise an instance. + + :param url: The URL to use for XML-RPC. + :param kwargs: Passed to the superclass constructor. + """ + super(PyPIRPCLocator, self).__init__(**kwargs) + self.base_url = url + self.client = ServerProxy(url, timeout=3.0) + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + return set(self.client.list_packages()) + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + versions = self.client.package_releases(name, True) + for v in versions: + urls = self.client.release_urls(name, v) + data = self.client.release_data(name, v) + metadata = Metadata(scheme=self.scheme) + metadata.name = data['name'] + metadata.version = data['version'] + metadata.license = data.get('license') + metadata.keywords = data.get('keywords', []) + metadata.summary = data.get('summary') + dist = Distribution(metadata) + if urls: + info = urls[0] + metadata.source_url = info['url'] + dist.digest = self._get_digest(info) + dist.locator = self + result[v] = dist + for info in urls: + url = info['url'] + digest = self._get_digest(info) + result['urls'].setdefault(v, set()).add(url) + result['digests'][url] = digest + return result + + +class PyPIJSONLocator(Locator): + """ + This locator uses PyPI's JSON interface. It's very limited in functionality + and probably not worth using. + """ + + def __init__(self, url, **kwargs): + super(PyPIJSONLocator, self).__init__(**kwargs) + self.base_url = ensure_slash(url) + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + raise NotImplementedError('Not available from this locator') + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + url = urljoin(self.base_url, '%s/json' % quote(name)) + try: + resp = self.opener.open(url) + data = resp.read().decode() # for now + d = json.loads(data) + md = Metadata(scheme=self.scheme) + data = d['info'] + md.name = data['name'] + md.version = data['version'] + md.license = data.get('license') + md.keywords = data.get('keywords', []) + md.summary = data.get('summary') + dist = Distribution(md) + dist.locator = self + # urls = d['urls'] + result[md.version] = dist + for info in d['urls']: + url = info['url'] + dist.download_urls.add(url) + dist.digests[url] = self._get_digest(info) + result['urls'].setdefault(md.version, set()).add(url) + result['digests'][url] = self._get_digest(info) + # Now get other releases + for version, infos in d['releases'].items(): + if version == md.version: + continue # already done + omd = Metadata(scheme=self.scheme) + omd.name = md.name + omd.version = version + odist = Distribution(omd) + odist.locator = self + result[version] = odist + for info in infos: + url = info['url'] + odist.download_urls.add(url) + odist.digests[url] = self._get_digest(info) + result['urls'].setdefault(version, set()).add(url) + result['digests'][url] = self._get_digest(info) + + +# for info in urls: +# md.source_url = info['url'] +# dist.digest = self._get_digest(info) +# dist.locator = self +# for info in urls: +# url = info['url'] +# result['urls'].setdefault(md.version, set()).add(url) +# result['digests'][url] = self._get_digest(info) + except Exception as e: + self.errors.put(text_type(e)) + logger.exception('JSON fetch failed: %s', e) + return result + + +class Page(object): + """ + This class represents a scraped HTML page. + """ + # The following slightly hairy-looking regex just looks for the contents of + # an anchor link, which has an attribute "href" either immediately preceded + # or immediately followed by a "rel" attribute. The attribute values can be + # declared with double quotes, single quotes or no quotes - which leads to + # the length of the expression. + _href = re.compile( + """ +(rel\\s*=\\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\\s\n]*))\\s+)? +href\\s*=\\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\\s\n]*)) +(\\s+rel\\s*=\\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\\s\n]*)))? +""", re.I | re.S | re.X) + _base = re.compile(r"""]+)""", re.I | re.S) + + def __init__(self, data, url): + """ + Initialise an instance with the Unicode page contents and the URL they + came from. + """ + self.data = data + self.base_url = self.url = url + m = self._base.search(self.data) + if m: + self.base_url = m.group(1) + + _clean_re = re.compile(r'[^a-z0-9$&+,/:;=?@.#%_\\|-]', re.I) + + @cached_property + def links(self): + """ + Return the URLs of all the links on a page together with information + about their "rel" attribute, for determining which ones to treat as + downloads and which ones to queue for further scraping. + """ + + def clean(url): + "Tidy up an URL." + scheme, netloc, path, params, query, frag = urlparse(url) + return urlunparse((scheme, netloc, quote(path), params, query, frag)) + + result = set() + for match in self._href.finditer(self.data): + d = match.groupdict('') + rel = (d['rel1'] or d['rel2'] or d['rel3'] or d['rel4'] or d['rel5'] or d['rel6']) + url = d['url1'] or d['url2'] or d['url3'] + url = urljoin(self.base_url, url) + url = unescape(url) + url = self._clean_re.sub(lambda m: '%%%2x' % ord(m.group(0)), url) + result.add((url, rel)) + # We sort the result, hoping to bring the most recent versions + # to the front + result = sorted(result, key=lambda t: t[0], reverse=True) + return result + + +class SimpleScrapingLocator(Locator): + """ + A locator which scrapes HTML pages to locate downloads for a distribution. + This runs multiple threads to do the I/O; performance is at least as good + as pip's PackageFinder, which works in an analogous fashion. + """ + + # These are used to deal with various Content-Encoding schemes. + decoders = { + 'deflate': zlib.decompress, + 'gzip': lambda b: gzip.GzipFile(fileobj=BytesIO(b)).read(), + 'none': lambda b: b, + } + + def __init__(self, url, timeout=None, num_workers=10, **kwargs): + """ + Initialise an instance. + :param url: The root URL to use for scraping. + :param timeout: The timeout, in seconds, to be applied to requests. + This defaults to ``None`` (no timeout specified). + :param num_workers: The number of worker threads you want to do I/O, + This defaults to 10. + :param kwargs: Passed to the superclass. + """ + super(SimpleScrapingLocator, self).__init__(**kwargs) + self.base_url = ensure_slash(url) + self.timeout = timeout + self._page_cache = {} + self._seen = set() + self._to_fetch = queue.Queue() + self._bad_hosts = set() + self.skip_externals = False + self.num_workers = num_workers + self._lock = threading.RLock() + # See issue #45: we need to be resilient when the locator is used + # in a thread, e.g. with concurrent.futures. We can't use self._lock + # as it is for coordinating our internal threads - the ones created + # in _prepare_threads. + self._gplock = threading.RLock() + self.platform_check = False # See issue #112 + + def _prepare_threads(self): + """ + Threads are created only when get_project is called, and terminate + before it returns. They are there primarily to parallelise I/O (i.e. + fetching web pages). + """ + self._threads = [] + for i in range(self.num_workers): + t = threading.Thread(target=self._fetch) + t.daemon = True + t.start() + self._threads.append(t) + + def _wait_threads(self): + """ + Tell all the threads to terminate (by sending a sentinel value) and + wait for them to do so. + """ + # Note that you need two loops, since you can't say which + # thread will get each sentinel + for t in self._threads: + self._to_fetch.put(None) # sentinel + for t in self._threads: + t.join() + self._threads = [] + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + with self._gplock: + self.result = result + self.project_name = name + url = urljoin(self.base_url, '%s/' % quote(name)) + self._seen.clear() + self._page_cache.clear() + self._prepare_threads() + try: + logger.debug('Queueing %s', url) + self._to_fetch.put(url) + self._to_fetch.join() + finally: + self._wait_threads() + del self.result + return result + + platform_dependent = re.compile(r'\b(linux_(i\d86|x86_64|arm\w+)|' + r'win(32|_amd64)|macosx_?\d+)\b', re.I) + + def _is_platform_dependent(self, url): + """ + Does an URL refer to a platform-specific download? + """ + return self.platform_dependent.search(url) + + def _process_download(self, url): + """ + See if an URL is a suitable download for a project. + + If it is, register information in the result dictionary (for + _get_project) about the specific version it's for. + + Note that the return value isn't actually used other than as a boolean + value. + """ + if self.platform_check and self._is_platform_dependent(url): + info = None + else: + info = self.convert_url_to_download_info(url, self.project_name) + logger.debug('process_download: %s -> %s', url, info) + if info: + with self._lock: # needed because self.result is shared + self._update_version_data(self.result, info) + return info + + def _should_queue(self, link, referrer, rel): + """ + Determine whether a link URL from a referring page and with a + particular "rel" attribute should be queued for scraping. + """ + scheme, netloc, path, _, _, _ = urlparse(link) + if path.endswith(self.source_extensions + self.binary_extensions + self.excluded_extensions): + result = False + elif self.skip_externals and not link.startswith(self.base_url): + result = False + elif not referrer.startswith(self.base_url): + result = False + elif rel not in ('homepage', 'download'): + result = False + elif scheme not in ('http', 'https', 'ftp'): + result = False + elif self._is_platform_dependent(link): + result = False + else: + host = netloc.split(':', 1)[0] + if host.lower() == 'localhost': + result = False + else: + result = True + logger.debug('should_queue: %s (%s) from %s -> %s', link, rel, referrer, result) + return result + + def _fetch(self): + """ + Get a URL to fetch from the work queue, get the HTML page, examine its + links for download candidates and candidates for further scraping. + + This is a handy method to run in a thread. + """ + while True: + url = self._to_fetch.get() + try: + if url: + page = self.get_page(url) + if page is None: # e.g. after an error + continue + for link, rel in page.links: + if link not in self._seen: + try: + self._seen.add(link) + if (not self._process_download(link) and self._should_queue(link, url, rel)): + logger.debug('Queueing %s from %s', link, url) + self._to_fetch.put(link) + except MetadataInvalidError: # e.g. invalid versions + pass + except Exception as e: # pragma: no cover + self.errors.put(text_type(e)) + finally: + # always do this, to avoid hangs :-) + self._to_fetch.task_done() + if not url: + # logger.debug('Sentinel seen, quitting.') + break + + def get_page(self, url): + """ + Get the HTML for an URL, possibly from an in-memory cache. + + XXX TODO Note: this cache is never actually cleared. It's assumed that + the data won't get stale over the lifetime of a locator instance (not + necessarily true for the default_locator). + """ + # http://peak.telecommunity.com/DevCenter/EasyInstall#package-index-api + scheme, netloc, path, _, _, _ = urlparse(url) + if scheme == 'file' and os.path.isdir(url2pathname(path)): + url = urljoin(ensure_slash(url), 'index.html') + + if url in self._page_cache: + result = self._page_cache[url] + logger.debug('Returning %s from cache: %s', url, result) + else: + host = netloc.split(':', 1)[0] + result = None + if host in self._bad_hosts: + logger.debug('Skipping %s due to bad host %s', url, host) + else: + req = Request(url, headers={'Accept-encoding': 'identity'}) + try: + logger.debug('Fetching %s', url) + resp = self.opener.open(req, timeout=self.timeout) + logger.debug('Fetched %s', url) + headers = resp.info() + content_type = headers.get('Content-Type', '') + if HTML_CONTENT_TYPE.match(content_type): + final_url = resp.geturl() + data = resp.read() + encoding = headers.get('Content-Encoding') + if encoding: + decoder = self.decoders[encoding] # fail if not found + data = decoder(data) + encoding = 'utf-8' + m = CHARSET.search(content_type) + if m: + encoding = m.group(1) + try: + data = data.decode(encoding) + except UnicodeError: # pragma: no cover + data = data.decode('latin-1') # fallback + result = Page(data, final_url) + self._page_cache[final_url] = result + except HTTPError as e: + if e.code != 404: + logger.exception('Fetch failed: %s: %s', url, e) + except URLError as e: # pragma: no cover + logger.exception('Fetch failed: %s: %s', url, e) + with self._lock: + self._bad_hosts.add(host) + except Exception as e: # pragma: no cover + logger.exception('Fetch failed: %s: %s', url, e) + finally: + self._page_cache[url] = result # even if None (failure) + return result + + _distname_re = re.compile(']*>([^<]+)<') + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + result = set() + page = self.get_page(self.base_url) + if not page: + raise DistlibException('Unable to get %s' % self.base_url) + for match in self._distname_re.finditer(page.data): + result.add(match.group(1)) + return result + + +class DirectoryLocator(Locator): + """ + This class locates distributions in a directory tree. + """ + + def __init__(self, path, **kwargs): + """ + Initialise an instance. + :param path: The root of the directory tree to search. + :param kwargs: Passed to the superclass constructor, + except for: + * recursive - if True (the default), subdirectories are + recursed into. If False, only the top-level directory + is searched, + """ + self.recursive = kwargs.pop('recursive', True) + super(DirectoryLocator, self).__init__(**kwargs) + path = os.path.abspath(path) + if not os.path.isdir(path): # pragma: no cover + raise DistlibException('Not a directory: %r' % path) + self.base_dir = path + + def should_include(self, filename, parent): + """ + Should a filename be considered as a candidate for a distribution + archive? As well as the filename, the directory which contains it + is provided, though not used by the current implementation. + """ + return filename.endswith(self.downloadable_extensions) + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + for root, dirs, files in os.walk(self.base_dir): + for fn in files: + if self.should_include(fn, root): + fn = os.path.join(root, fn) + url = urlunparse(('file', '', pathname2url(os.path.abspath(fn)), '', '', '')) + info = self.convert_url_to_download_info(url, name) + if info: + self._update_version_data(result, info) + if not self.recursive: + break + return result + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + result = set() + for root, dirs, files in os.walk(self.base_dir): + for fn in files: + if self.should_include(fn, root): + fn = os.path.join(root, fn) + url = urlunparse(('file', '', pathname2url(os.path.abspath(fn)), '', '', '')) + info = self.convert_url_to_download_info(url, None) + if info: + result.add(info['name']) + if not self.recursive: + break + return result + + +class JSONLocator(Locator): + """ + This locator uses special extended metadata (not available on PyPI) and is + the basis of performant dependency resolution in distlib. Other locators + require archive downloads before dependencies can be determined! As you + might imagine, that can be slow. + """ + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + raise NotImplementedError('Not available from this locator') + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + data = get_project_data(name) + if data: + for info in data.get('files', []): + if info['ptype'] != 'sdist' or info['pyversion'] != 'source': + continue + # We don't store summary in project metadata as it makes + # the data bigger for no benefit during dependency + # resolution + dist = make_dist(data['name'], + info['version'], + summary=data.get('summary', 'Placeholder for summary'), + scheme=self.scheme) + md = dist.metadata + md.source_url = info['url'] + # TODO SHA256 digest + if 'digest' in info and info['digest']: + dist.digest = ('md5', info['digest']) + md.dependencies = info.get('requirements', {}) + dist.exports = info.get('exports', {}) + result[dist.version] = dist + result['urls'].setdefault(dist.version, set()).add(info['url']) + return result + + +class DistPathLocator(Locator): + """ + This locator finds installed distributions in a path. It can be useful for + adding to an :class:`AggregatingLocator`. + """ + + def __init__(self, distpath, **kwargs): + """ + Initialise an instance. + + :param distpath: A :class:`DistributionPath` instance to search. + """ + super(DistPathLocator, self).__init__(**kwargs) + assert isinstance(distpath, DistributionPath) + self.distpath = distpath + + def _get_project(self, name): + dist = self.distpath.get_distribution(name) + if dist is None: + result = {'urls': {}, 'digests': {}} + else: + result = { + dist.version: dist, + 'urls': { + dist.version: set([dist.source_url]) + }, + 'digests': { + dist.version: set([None]) + } + } + return result + + +class AggregatingLocator(Locator): + """ + This class allows you to chain and/or merge a list of locators. + """ + + def __init__(self, *locators, **kwargs): + """ + Initialise an instance. + + :param locators: The list of locators to search. + :param kwargs: Passed to the superclass constructor, + except for: + * merge - if False (the default), the first successful + search from any of the locators is returned. If True, + the results from all locators are merged (this can be + slow). + """ + self.merge = kwargs.pop('merge', False) + self.locators = locators + super(AggregatingLocator, self).__init__(**kwargs) + + def clear_cache(self): + super(AggregatingLocator, self).clear_cache() + for locator in self.locators: + locator.clear_cache() + + def _set_scheme(self, value): + self._scheme = value + for locator in self.locators: + locator.scheme = value + + scheme = property(Locator.scheme.fget, _set_scheme) + + def _get_project(self, name): + result = {} + for locator in self.locators: + d = locator.get_project(name) + if d: + if self.merge: + files = result.get('urls', {}) + digests = result.get('digests', {}) + # next line could overwrite result['urls'], result['digests'] + result.update(d) + df = result.get('urls') + if files and df: + for k, v in files.items(): + if k in df: + df[k] |= v + else: + df[k] = v + dd = result.get('digests') + if digests and dd: + dd.update(digests) + else: + # See issue #18. If any dists are found and we're looking + # for specific constraints, we only return something if + # a match is found. For example, if a DirectoryLocator + # returns just foo (1.0) while we're looking for + # foo (>= 2.0), we'll pretend there was nothing there so + # that subsequent locators can be queried. Otherwise we + # would just return foo (1.0) which would then lead to a + # failure to find foo (>= 2.0), because other locators + # weren't searched. Note that this only matters when + # merge=False. + if self.matcher is None: + found = True + else: + found = False + for k in d: + if self.matcher.match(k): + found = True + break + if found: + result = d + break + return result + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + result = set() + for locator in self.locators: + try: + result |= locator.get_distribution_names() + except NotImplementedError: + pass + return result + + +# We use a legacy scheme simply because most of the dists on PyPI use legacy +# versions which don't conform to PEP 440. +default_locator = AggregatingLocator( + # JSONLocator(), # don't use as PEP 426 is withdrawn + SimpleScrapingLocator('https://pypi.org/simple/', timeout=3.0), + scheme='legacy') + +locate = default_locator.locate + + +class DependencyFinder(object): + """ + Locate dependencies for distributions. + """ + + def __init__(self, locator=None): + """ + Initialise an instance, using the specified locator + to locate distributions. + """ + self.locator = locator or default_locator + self.scheme = get_scheme(self.locator.scheme) + + def add_distribution(self, dist): + """ + Add a distribution to the finder. This will update internal information + about who provides what. + :param dist: The distribution to add. + """ + logger.debug('adding distribution %s', dist) + name = dist.key + self.dists_by_name[name] = dist + self.dists[(name, dist.version)] = dist + for p in dist.provides: + name, version = parse_name_and_version(p) + logger.debug('Add to provided: %s, %s, %s', name, version, dist) + self.provided.setdefault(name, set()).add((version, dist)) + + def remove_distribution(self, dist): + """ + Remove a distribution from the finder. This will update internal + information about who provides what. + :param dist: The distribution to remove. + """ + logger.debug('removing distribution %s', dist) + name = dist.key + del self.dists_by_name[name] + del self.dists[(name, dist.version)] + for p in dist.provides: + name, version = parse_name_and_version(p) + logger.debug('Remove from provided: %s, %s, %s', name, version, dist) + s = self.provided[name] + s.remove((version, dist)) + if not s: + del self.provided[name] + + def get_matcher(self, reqt): + """ + Get a version matcher for a requirement. + :param reqt: The requirement + :type reqt: str + :return: A version matcher (an instance of + :class:`distlib.version.Matcher`). + """ + try: + matcher = self.scheme.matcher(reqt) + except UnsupportedVersionError: # pragma: no cover + # XXX compat-mode if cannot read the version + name = reqt.split()[0] + matcher = self.scheme.matcher(name) + return matcher + + def find_providers(self, reqt): + """ + Find the distributions which can fulfill a requirement. + + :param reqt: The requirement. + :type reqt: str + :return: A set of distribution which can fulfill the requirement. + """ + matcher = self.get_matcher(reqt) + name = matcher.key # case-insensitive + result = set() + provided = self.provided + if name in provided: + for version, provider in provided[name]: + try: + match = matcher.match(version) + except UnsupportedVersionError: + match = False + + if match: + result.add(provider) + break + return result + + def try_to_replace(self, provider, other, problems): + """ + Attempt to replace one provider with another. This is typically used + when resolving dependencies from multiple sources, e.g. A requires + (B >= 1.0) while C requires (B >= 1.1). + + For successful replacement, ``provider`` must meet all the requirements + which ``other`` fulfills. + + :param provider: The provider we are trying to replace with. + :param other: The provider we're trying to replace. + :param problems: If False is returned, this will contain what + problems prevented replacement. This is currently + a tuple of the literal string 'cantreplace', + ``provider``, ``other`` and the set of requirements + that ``provider`` couldn't fulfill. + :return: True if we can replace ``other`` with ``provider``, else + False. + """ + rlist = self.reqts[other] + unmatched = set() + for s in rlist: + matcher = self.get_matcher(s) + if not matcher.match(provider.version): + unmatched.add(s) + if unmatched: + # can't replace other with provider + problems.add(('cantreplace', provider, other, frozenset(unmatched))) + result = False + else: + # can replace other with provider + self.remove_distribution(other) + del self.reqts[other] + for s in rlist: + self.reqts.setdefault(provider, set()).add(s) + self.add_distribution(provider) + result = True + return result + + def find(self, requirement, meta_extras=None, prereleases=False): + """ + Find a distribution and all distributions it depends on. + + :param requirement: The requirement specifying the distribution to + find, or a Distribution instance. + :param meta_extras: A list of meta extras such as :test:, :build: and + so on. + :param prereleases: If ``True``, allow pre-release versions to be + returned - otherwise, don't return prereleases + unless they're all that's available. + + Return a set of :class:`Distribution` instances and a set of + problems. + + The distributions returned should be such that they have the + :attr:`required` attribute set to ``True`` if they were + from the ``requirement`` passed to ``find()``, and they have the + :attr:`build_time_dependency` attribute set to ``True`` unless they + are post-installation dependencies of the ``requirement``. + + The problems should be a tuple consisting of the string + ``'unsatisfied'`` and the requirement which couldn't be satisfied + by any distribution known to the locator. + """ + + self.provided = {} + self.dists = {} + self.dists_by_name = {} + self.reqts = {} + + meta_extras = set(meta_extras or []) + if ':*:' in meta_extras: + meta_extras.remove(':*:') + # :meta: and :run: are implicitly included + meta_extras |= set([':test:', ':build:', ':dev:']) + + if isinstance(requirement, Distribution): + dist = odist = requirement + logger.debug('passed %s as requirement', odist) + else: + dist = odist = self.locator.locate(requirement, prereleases=prereleases) + if dist is None: + raise DistlibException('Unable to locate %r' % requirement) + logger.debug('located %s', odist) + dist.requested = True + problems = set() + todo = set([dist]) + install_dists = set([odist]) + while todo: + dist = todo.pop() + name = dist.key # case-insensitive + if name not in self.dists_by_name: + self.add_distribution(dist) + else: + # import pdb; pdb.set_trace() + other = self.dists_by_name[name] + if other != dist: + self.try_to_replace(dist, other, problems) + + ireqts = dist.run_requires | dist.meta_requires + sreqts = dist.build_requires + ereqts = set() + if meta_extras and dist in install_dists: + for key in ('test', 'build', 'dev'): + e = ':%s:' % key + if e in meta_extras: + ereqts |= getattr(dist, '%s_requires' % key) + all_reqts = ireqts | sreqts | ereqts + for r in all_reqts: + providers = self.find_providers(r) + if not providers: + logger.debug('No providers found for %r', r) + provider = self.locator.locate(r, prereleases=prereleases) + # If no provider is found and we didn't consider + # prereleases, consider them now. + if provider is None and not prereleases: + provider = self.locator.locate(r, prereleases=True) + if provider is None: + logger.debug('Cannot satisfy %r', r) + problems.add(('unsatisfied', r)) + else: + n, v = provider.key, provider.version + if (n, v) not in self.dists: + todo.add(provider) + providers.add(provider) + if r in ireqts and dist in install_dists: + install_dists.add(provider) + logger.debug('Adding %s to install_dists', provider.name_and_version) + for p in providers: + name = p.key + if name not in self.dists_by_name: + self.reqts.setdefault(p, set()).add(r) + else: + other = self.dists_by_name[name] + if other != p: + # see if other can be replaced by p + self.try_to_replace(p, other, problems) + + dists = set(self.dists.values()) + for dist in dists: + dist.build_time_dependency = dist not in install_dists + if dist.build_time_dependency: + logger.debug('%s is a build-time dependency only.', dist.name_and_version) + logger.debug('find done for %s', odist) + return dists, problems diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/manifest.py b/env/lib/python3.12/site-packages/pip/_vendor/distlib/manifest.py new file mode 100644 index 0000000..420dcf1 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distlib/manifest.py @@ -0,0 +1,384 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +""" +Class representing the list of files in a distribution. + +Equivalent to distutils.filelist, but fixes some problems. +""" +import fnmatch +import logging +import os +import re +import sys + +from . import DistlibException +from .compat import fsdecode +from .util import convert_path + + +__all__ = ['Manifest'] + +logger = logging.getLogger(__name__) + +# a \ followed by some spaces + EOL +_COLLAPSE_PATTERN = re.compile('\\\\w*\n', re.M) +_COMMENTED_LINE = re.compile('#.*?(?=\n)|\n(?=$)', re.M | re.S) + +# +# Due to the different results returned by fnmatch.translate, we need +# to do slightly different processing for Python 2.7 and 3.2 ... this needed +# to be brought in for Python 3.6 onwards. +# +_PYTHON_VERSION = sys.version_info[:2] + + +class Manifest(object): + """ + A list of files built by exploring the filesystem and filtered by applying various + patterns to what we find there. + """ + + def __init__(self, base=None): + """ + Initialise an instance. + + :param base: The base directory to explore under. + """ + self.base = os.path.abspath(os.path.normpath(base or os.getcwd())) + self.prefix = self.base + os.sep + self.allfiles = None + self.files = set() + + # + # Public API + # + + def findall(self): + """Find all files under the base and set ``allfiles`` to the absolute + pathnames of files found. + """ + from stat import S_ISREG, S_ISDIR, S_ISLNK + + self.allfiles = allfiles = [] + root = self.base + stack = [root] + pop = stack.pop + push = stack.append + + while stack: + root = pop() + names = os.listdir(root) + + for name in names: + fullname = os.path.join(root, name) + + # Avoid excess stat calls -- just one will do, thank you! + stat = os.stat(fullname) + mode = stat.st_mode + if S_ISREG(mode): + allfiles.append(fsdecode(fullname)) + elif S_ISDIR(mode) and not S_ISLNK(mode): + push(fullname) + + def add(self, item): + """ + Add a file to the manifest. + + :param item: The pathname to add. This can be relative to the base. + """ + if not item.startswith(self.prefix): + item = os.path.join(self.base, item) + self.files.add(os.path.normpath(item)) + + def add_many(self, items): + """ + Add a list of files to the manifest. + + :param items: The pathnames to add. These can be relative to the base. + """ + for item in items: + self.add(item) + + def sorted(self, wantdirs=False): + """ + Return sorted files in directory order + """ + + def add_dir(dirs, d): + dirs.add(d) + logger.debug('add_dir added %s', d) + if d != self.base: + parent, _ = os.path.split(d) + assert parent not in ('', '/') + add_dir(dirs, parent) + + result = set(self.files) # make a copy! + if wantdirs: + dirs = set() + for f in result: + add_dir(dirs, os.path.dirname(f)) + result |= dirs + return [os.path.join(*path_tuple) for path_tuple in + sorted(os.path.split(path) for path in result)] + + def clear(self): + """Clear all collected files.""" + self.files = set() + self.allfiles = [] + + def process_directive(self, directive): + """ + Process a directive which either adds some files from ``allfiles`` to + ``files``, or removes some files from ``files``. + + :param directive: The directive to process. This should be in a format + compatible with distutils ``MANIFEST.in`` files: + + http://docs.python.org/distutils/sourcedist.html#commands + """ + # Parse the line: split it up, make sure the right number of words + # is there, and return the relevant words. 'action' is always + # defined: it's the first word of the line. Which of the other + # three are defined depends on the action; it'll be either + # patterns, (dir and patterns), or (dirpattern). + action, patterns, thedir, dirpattern = self._parse_directive(directive) + + # OK, now we know that the action is valid and we have the + # right number of words on the line for that action -- so we + # can proceed with minimal error-checking. + if action == 'include': + for pattern in patterns: + if not self._include_pattern(pattern, anchor=True): + logger.warning('no files found matching %r', pattern) + + elif action == 'exclude': + for pattern in patterns: + self._exclude_pattern(pattern, anchor=True) + + elif action == 'global-include': + for pattern in patterns: + if not self._include_pattern(pattern, anchor=False): + logger.warning('no files found matching %r ' + 'anywhere in distribution', pattern) + + elif action == 'global-exclude': + for pattern in patterns: + self._exclude_pattern(pattern, anchor=False) + + elif action == 'recursive-include': + for pattern in patterns: + if not self._include_pattern(pattern, prefix=thedir): + logger.warning('no files found matching %r ' + 'under directory %r', pattern, thedir) + + elif action == 'recursive-exclude': + for pattern in patterns: + self._exclude_pattern(pattern, prefix=thedir) + + elif action == 'graft': + if not self._include_pattern(None, prefix=dirpattern): + logger.warning('no directories found matching %r', + dirpattern) + + elif action == 'prune': + if not self._exclude_pattern(None, prefix=dirpattern): + logger.warning('no previously-included directories found ' + 'matching %r', dirpattern) + else: # pragma: no cover + # This should never happen, as it should be caught in + # _parse_template_line + raise DistlibException( + 'invalid action %r' % action) + + # + # Private API + # + + def _parse_directive(self, directive): + """ + Validate a directive. + :param directive: The directive to validate. + :return: A tuple of action, patterns, thedir, dir_patterns + """ + words = directive.split() + if len(words) == 1 and words[0] not in ('include', 'exclude', + 'global-include', + 'global-exclude', + 'recursive-include', + 'recursive-exclude', + 'graft', 'prune'): + # no action given, let's use the default 'include' + words.insert(0, 'include') + + action = words[0] + patterns = thedir = dir_pattern = None + + if action in ('include', 'exclude', + 'global-include', 'global-exclude'): + if len(words) < 2: + raise DistlibException( + '%r expects ...' % action) + + patterns = [convert_path(word) for word in words[1:]] + + elif action in ('recursive-include', 'recursive-exclude'): + if len(words) < 3: + raise DistlibException( + '%r expects ...' % action) + + thedir = convert_path(words[1]) + patterns = [convert_path(word) for word in words[2:]] + + elif action in ('graft', 'prune'): + if len(words) != 2: + raise DistlibException( + '%r expects a single ' % action) + + dir_pattern = convert_path(words[1]) + + else: + raise DistlibException('unknown action %r' % action) + + return action, patterns, thedir, dir_pattern + + def _include_pattern(self, pattern, anchor=True, prefix=None, + is_regex=False): + """Select strings (presumably filenames) from 'self.files' that + match 'pattern', a Unix-style wildcard (glob) pattern. + + Patterns are not quite the same as implemented by the 'fnmatch' + module: '*' and '?' match non-special characters, where "special" + is platform-dependent: slash on Unix; colon, slash, and backslash on + DOS/Windows; and colon on Mac OS. + + If 'anchor' is true (the default), then the pattern match is more + stringent: "*.py" will match "foo.py" but not "foo/bar.py". If + 'anchor' is false, both of these will match. + + If 'prefix' is supplied, then only filenames starting with 'prefix' + (itself a pattern) and ending with 'pattern', with anything in between + them, will match. 'anchor' is ignored in this case. + + If 'is_regex' is true, 'anchor' and 'prefix' are ignored, and + 'pattern' is assumed to be either a string containing a regex or a + regex object -- no translation is done, the regex is just compiled + and used as-is. + + Selected strings will be added to self.files. + + Return True if files are found. + """ + # XXX docstring lying about what the special chars are? + found = False + pattern_re = self._translate_pattern(pattern, anchor, prefix, is_regex) + + # delayed loading of allfiles list + if self.allfiles is None: + self.findall() + + for name in self.allfiles: + if pattern_re.search(name): + self.files.add(name) + found = True + return found + + def _exclude_pattern(self, pattern, anchor=True, prefix=None, + is_regex=False): + """Remove strings (presumably filenames) from 'files' that match + 'pattern'. + + Other parameters are the same as for 'include_pattern()', above. + The list 'self.files' is modified in place. Return True if files are + found. + + This API is public to allow e.g. exclusion of SCM subdirs, e.g. when + packaging source distributions + """ + found = False + pattern_re = self._translate_pattern(pattern, anchor, prefix, is_regex) + for f in list(self.files): + if pattern_re.search(f): + self.files.remove(f) + found = True + return found + + def _translate_pattern(self, pattern, anchor=True, prefix=None, + is_regex=False): + """Translate a shell-like wildcard pattern to a compiled regular + expression. + + Return the compiled regex. If 'is_regex' true, + then 'pattern' is directly compiled to a regex (if it's a string) + or just returned as-is (assumes it's a regex object). + """ + if is_regex: + if isinstance(pattern, str): + return re.compile(pattern) + else: + return pattern + + if _PYTHON_VERSION > (3, 2): + # ditch start and end characters + start, _, end = self._glob_to_re('_').partition('_') + + if pattern: + pattern_re = self._glob_to_re(pattern) + if _PYTHON_VERSION > (3, 2): + assert pattern_re.startswith(start) and pattern_re.endswith(end) + else: + pattern_re = '' + + base = re.escape(os.path.join(self.base, '')) + if prefix is not None: + # ditch end of pattern character + if _PYTHON_VERSION <= (3, 2): + empty_pattern = self._glob_to_re('') + prefix_re = self._glob_to_re(prefix)[:-len(empty_pattern)] + else: + prefix_re = self._glob_to_re(prefix) + assert prefix_re.startswith(start) and prefix_re.endswith(end) + prefix_re = prefix_re[len(start): len(prefix_re) - len(end)] + sep = os.sep + if os.sep == '\\': + sep = r'\\' + if _PYTHON_VERSION <= (3, 2): + pattern_re = '^' + base + sep.join((prefix_re, + '.*' + pattern_re)) + else: + pattern_re = pattern_re[len(start): len(pattern_re) - len(end)] + pattern_re = r'%s%s%s%s.*%s%s' % (start, base, prefix_re, sep, + pattern_re, end) + else: # no prefix -- respect anchor flag + if anchor: + if _PYTHON_VERSION <= (3, 2): + pattern_re = '^' + base + pattern_re + else: + pattern_re = r'%s%s%s' % (start, base, pattern_re[len(start):]) + + return re.compile(pattern_re) + + def _glob_to_re(self, pattern): + """Translate a shell-like glob pattern to a regular expression. + + Return a string containing the regex. Differs from + 'fnmatch.translate()' in that '*' does not match "special characters" + (which are platform-specific). + """ + pattern_re = fnmatch.translate(pattern) + + # '?' and '*' in the glob pattern become '.' and '.*' in the RE, which + # IMHO is wrong -- '?' and '*' aren't supposed to match slash in Unix, + # and by extension they shouldn't match such "special characters" under + # any OS. So change all non-escaped dots in the RE to match any + # character except the special characters (currently: just os.sep). + sep = os.sep + if os.sep == '\\': + # we're using a regex to manipulate a regex, so we need + # to escape the backslash twice + sep = r'\\\\' + escaped = r'\1[^%s]' % sep + pattern_re = re.sub(r'((? y, + '!=': lambda x, y: x != y, + '<': lambda x, y: x < y, + '<=': lambda x, y: x == y or x < y, + '>': lambda x, y: x > y, + '>=': lambda x, y: x == y or x > y, + 'and': lambda x, y: x and y, + 'or': lambda x, y: x or y, + 'in': lambda x, y: x in y, + 'not in': lambda x, y: x not in y, + } + + def evaluate(self, expr, context): + """ + Evaluate a marker expression returned by the :func:`parse_requirement` + function in the specified context. + """ + if isinstance(expr, string_types): + if expr[0] in '\'"': + result = expr[1:-1] + else: + if expr not in context: + raise SyntaxError('unknown variable: %s' % expr) + result = context[expr] + else: + assert isinstance(expr, dict) + op = expr['op'] + if op not in self.operations: + raise NotImplementedError('op not implemented: %s' % op) + elhs = expr['lhs'] + erhs = expr['rhs'] + if _is_literal(expr['lhs']) and _is_literal(expr['rhs']): + raise SyntaxError('invalid comparison: %s %s %s' % (elhs, op, erhs)) + + lhs = self.evaluate(elhs, context) + rhs = self.evaluate(erhs, context) + if ((_is_version_marker(elhs) or _is_version_marker(erhs)) and + op in ('<', '<=', '>', '>=', '===', '==', '!=', '~=')): + lhs = LV(lhs) + rhs = LV(rhs) + elif _is_version_marker(elhs) and op in ('in', 'not in'): + lhs = LV(lhs) + rhs = _get_versions(rhs) + result = self.operations[op](lhs, rhs) + return result + + +_DIGITS = re.compile(r'\d+\.\d+') + + +def default_context(): + + def format_full_version(info): + version = '%s.%s.%s' % (info.major, info.minor, info.micro) + kind = info.releaselevel + if kind != 'final': + version += kind[0] + str(info.serial) + return version + + if hasattr(sys, 'implementation'): + implementation_version = format_full_version(sys.implementation.version) + implementation_name = sys.implementation.name + else: + implementation_version = '0' + implementation_name = '' + + ppv = platform.python_version() + m = _DIGITS.match(ppv) + pv = m.group(0) + result = { + 'implementation_name': implementation_name, + 'implementation_version': implementation_version, + 'os_name': os.name, + 'platform_machine': platform.machine(), + 'platform_python_implementation': platform.python_implementation(), + 'platform_release': platform.release(), + 'platform_system': platform.system(), + 'platform_version': platform.version(), + 'platform_in_venv': str(in_venv()), + 'python_full_version': ppv, + 'python_version': pv, + 'sys_platform': sys.platform, + } + return result + + +DEFAULT_CONTEXT = default_context() +del default_context + +evaluator = Evaluator() + + +def interpret(marker, execution_context=None): + """ + Interpret a marker and return a result depending on environment. + + :param marker: The marker to interpret. + :type marker: str + :param execution_context: The context used for name lookup. + :type execution_context: mapping + """ + try: + expr, rest = parse_marker(marker) + except Exception as e: + raise SyntaxError('Unable to interpret marker syntax: %s: %s' % (marker, e)) + if rest and rest[0] != '#': + raise SyntaxError('unexpected trailing data in marker: %s: %s' % (marker, rest)) + context = dict(DEFAULT_CONTEXT) + if execution_context: + context.update(execution_context) + return evaluator.evaluate(expr, context) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/metadata.py b/env/lib/python3.12/site-packages/pip/_vendor/distlib/metadata.py new file mode 100644 index 0000000..ce9a34b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distlib/metadata.py @@ -0,0 +1,1031 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012 The Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +"""Implementation of the Metadata for Python packages PEPs. + +Supports all metadata formats (1.0, 1.1, 1.2, 1.3/2.1 and 2.2). +""" +from __future__ import unicode_literals + +import codecs +from email import message_from_file +import json +import logging +import re + +from . import DistlibException, __version__ +from .compat import StringIO, string_types, text_type +from .markers import interpret +from .util import extract_by_key, get_extras +from .version import get_scheme, PEP440_VERSION_RE + +logger = logging.getLogger(__name__) + + +class MetadataMissingError(DistlibException): + """A required metadata is missing""" + + +class MetadataConflictError(DistlibException): + """Attempt to read or write metadata fields that are conflictual.""" + + +class MetadataUnrecognizedVersionError(DistlibException): + """Unknown metadata version number.""" + + +class MetadataInvalidError(DistlibException): + """A metadata value is invalid""" + + +# public API of this module +__all__ = ['Metadata', 'PKG_INFO_ENCODING', 'PKG_INFO_PREFERRED_VERSION'] + +# Encoding used for the PKG-INFO files +PKG_INFO_ENCODING = 'utf-8' + +# preferred version. Hopefully will be changed +# to 1.2 once PEP 345 is supported everywhere +PKG_INFO_PREFERRED_VERSION = '1.1' + +_LINE_PREFIX_1_2 = re.compile('\n \\|') +_LINE_PREFIX_PRE_1_2 = re.compile('\n ') +_241_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', 'Summary', 'Description', 'Keywords', 'Home-page', + 'Author', 'Author-email', 'License') + +_314_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', 'Supported-Platform', 'Summary', 'Description', + 'Keywords', 'Home-page', 'Author', 'Author-email', 'License', 'Classifier', 'Download-URL', 'Obsoletes', + 'Provides', 'Requires') + +_314_MARKERS = ('Obsoletes', 'Provides', 'Requires', 'Classifier', 'Download-URL') + +_345_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', 'Supported-Platform', 'Summary', 'Description', + 'Keywords', 'Home-page', 'Author', 'Author-email', 'Maintainer', 'Maintainer-email', 'License', + 'Classifier', 'Download-URL', 'Obsoletes-Dist', 'Project-URL', 'Provides-Dist', 'Requires-Dist', + 'Requires-Python', 'Requires-External') + +_345_MARKERS = ('Provides-Dist', 'Requires-Dist', 'Requires-Python', 'Obsoletes-Dist', 'Requires-External', + 'Maintainer', 'Maintainer-email', 'Project-URL') + +_426_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', 'Supported-Platform', 'Summary', 'Description', + 'Keywords', 'Home-page', 'Author', 'Author-email', 'Maintainer', 'Maintainer-email', 'License', + 'Classifier', 'Download-URL', 'Obsoletes-Dist', 'Project-URL', 'Provides-Dist', 'Requires-Dist', + 'Requires-Python', 'Requires-External', 'Private-Version', 'Obsoleted-By', 'Setup-Requires-Dist', + 'Extension', 'Provides-Extra') + +_426_MARKERS = ('Private-Version', 'Provides-Extra', 'Obsoleted-By', 'Setup-Requires-Dist', 'Extension') + +# See issue #106: Sometimes 'Requires' and 'Provides' occur wrongly in +# the metadata. Include them in the tuple literal below to allow them +# (for now). +# Ditto for Obsoletes - see issue #140. +_566_FIELDS = _426_FIELDS + ('Description-Content-Type', 'Requires', 'Provides', 'Obsoletes') + +_566_MARKERS = ('Description-Content-Type', ) + +_643_MARKERS = ('Dynamic', 'License-File') + +_643_FIELDS = _566_FIELDS + _643_MARKERS + +_ALL_FIELDS = set() +_ALL_FIELDS.update(_241_FIELDS) +_ALL_FIELDS.update(_314_FIELDS) +_ALL_FIELDS.update(_345_FIELDS) +_ALL_FIELDS.update(_426_FIELDS) +_ALL_FIELDS.update(_566_FIELDS) +_ALL_FIELDS.update(_643_FIELDS) + +EXTRA_RE = re.compile(r'''extra\s*==\s*("([^"]+)"|'([^']+)')''') + + +def _version2fieldlist(version): + if version == '1.0': + return _241_FIELDS + elif version == '1.1': + return _314_FIELDS + elif version == '1.2': + return _345_FIELDS + elif version in ('1.3', '2.1'): + # avoid adding field names if already there + return _345_FIELDS + tuple(f for f in _566_FIELDS if f not in _345_FIELDS) + elif version == '2.0': + raise ValueError('Metadata 2.0 is withdrawn and not supported') + # return _426_FIELDS + elif version == '2.2': + return _643_FIELDS + raise MetadataUnrecognizedVersionError(version) + + +def _best_version(fields): + """Detect the best version depending on the fields used.""" + + def _has_marker(keys, markers): + return any(marker in keys for marker in markers) + + keys = [key for key, value in fields.items() if value not in ([], 'UNKNOWN', None)] + possible_versions = ['1.0', '1.1', '1.2', '1.3', '2.1', '2.2'] # 2.0 removed + + # first let's try to see if a field is not part of one of the version + for key in keys: + if key not in _241_FIELDS and '1.0' in possible_versions: + possible_versions.remove('1.0') + logger.debug('Removed 1.0 due to %s', key) + if key not in _314_FIELDS and '1.1' in possible_versions: + possible_versions.remove('1.1') + logger.debug('Removed 1.1 due to %s', key) + if key not in _345_FIELDS and '1.2' in possible_versions: + possible_versions.remove('1.2') + logger.debug('Removed 1.2 due to %s', key) + if key not in _566_FIELDS and '1.3' in possible_versions: + possible_versions.remove('1.3') + logger.debug('Removed 1.3 due to %s', key) + if key not in _566_FIELDS and '2.1' in possible_versions: + if key != 'Description': # In 2.1, description allowed after headers + possible_versions.remove('2.1') + logger.debug('Removed 2.1 due to %s', key) + if key not in _643_FIELDS and '2.2' in possible_versions: + possible_versions.remove('2.2') + logger.debug('Removed 2.2 due to %s', key) + # if key not in _426_FIELDS and '2.0' in possible_versions: + # possible_versions.remove('2.0') + # logger.debug('Removed 2.0 due to %s', key) + + # possible_version contains qualified versions + if len(possible_versions) == 1: + return possible_versions[0] # found ! + elif len(possible_versions) == 0: + logger.debug('Out of options - unknown metadata set: %s', fields) + raise MetadataConflictError('Unknown metadata set') + + # let's see if one unique marker is found + is_1_1 = '1.1' in possible_versions and _has_marker(keys, _314_MARKERS) + is_1_2 = '1.2' in possible_versions and _has_marker(keys, _345_MARKERS) + is_2_1 = '2.1' in possible_versions and _has_marker(keys, _566_MARKERS) + # is_2_0 = '2.0' in possible_versions and _has_marker(keys, _426_MARKERS) + is_2_2 = '2.2' in possible_versions and _has_marker(keys, _643_MARKERS) + if int(is_1_1) + int(is_1_2) + int(is_2_1) + int(is_2_2) > 1: + raise MetadataConflictError('You used incompatible 1.1/1.2/2.1/2.2 fields') + + # we have the choice, 1.0, or 1.2, 2.1 or 2.2 + # - 1.0 has a broken Summary field but works with all tools + # - 1.1 is to avoid + # - 1.2 fixes Summary but has little adoption + # - 2.1 adds more features + # - 2.2 is the latest + if not is_1_1 and not is_1_2 and not is_2_1 and not is_2_2: + # we couldn't find any specific marker + if PKG_INFO_PREFERRED_VERSION in possible_versions: + return PKG_INFO_PREFERRED_VERSION + if is_1_1: + return '1.1' + if is_1_2: + return '1.2' + if is_2_1: + return '2.1' + # if is_2_2: + # return '2.2' + + return '2.2' + + +# This follows the rules about transforming keys as described in +# https://www.python.org/dev/peps/pep-0566/#id17 +_ATTR2FIELD = {name.lower().replace("-", "_"): name for name in _ALL_FIELDS} +_FIELD2ATTR = {field: attr for attr, field in _ATTR2FIELD.items()} + +_PREDICATE_FIELDS = ('Requires-Dist', 'Obsoletes-Dist', 'Provides-Dist') +_VERSIONS_FIELDS = ('Requires-Python', ) +_VERSION_FIELDS = ('Version', ) +_LISTFIELDS = ('Platform', 'Classifier', 'Obsoletes', 'Requires', 'Provides', 'Obsoletes-Dist', 'Provides-Dist', + 'Requires-Dist', 'Requires-External', 'Project-URL', 'Supported-Platform', 'Setup-Requires-Dist', + 'Provides-Extra', 'Extension', 'License-File') +_LISTTUPLEFIELDS = ('Project-URL', ) + +_ELEMENTSFIELD = ('Keywords', ) + +_UNICODEFIELDS = ('Author', 'Maintainer', 'Summary', 'Description') + +_MISSING = object() + +_FILESAFE = re.compile('[^A-Za-z0-9.]+') + + +def _get_name_and_version(name, version, for_filename=False): + """Return the distribution name with version. + + If for_filename is true, return a filename-escaped form.""" + if for_filename: + # For both name and version any runs of non-alphanumeric or '.' + # characters are replaced with a single '-'. Additionally any + # spaces in the version string become '.' + name = _FILESAFE.sub('-', name) + version = _FILESAFE.sub('-', version.replace(' ', '.')) + return '%s-%s' % (name, version) + + +class LegacyMetadata(object): + """The legacy metadata of a release. + + Supports versions 1.0, 1.1, 1.2, 2.0 and 1.3/2.1 (auto-detected). You can + instantiate the class with one of these arguments (or none): + - *path*, the path to a metadata file + - *fileobj* give a file-like object with metadata as content + - *mapping* is a dict-like object + - *scheme* is a version scheme name + """ + + # TODO document the mapping API and UNKNOWN default key + + def __init__(self, path=None, fileobj=None, mapping=None, scheme='default'): + if [path, fileobj, mapping].count(None) < 2: + raise TypeError('path, fileobj and mapping are exclusive') + self._fields = {} + self.requires_files = [] + self._dependencies = None + self.scheme = scheme + if path is not None: + self.read(path) + elif fileobj is not None: + self.read_file(fileobj) + elif mapping is not None: + self.update(mapping) + self.set_metadata_version() + + def set_metadata_version(self): + self._fields['Metadata-Version'] = _best_version(self._fields) + + def _write_field(self, fileobj, name, value): + fileobj.write('%s: %s\n' % (name, value)) + + def __getitem__(self, name): + return self.get(name) + + def __setitem__(self, name, value): + return self.set(name, value) + + def __delitem__(self, name): + field_name = self._convert_name(name) + try: + del self._fields[field_name] + except KeyError: + raise KeyError(name) + + def __contains__(self, name): + return (name in self._fields or self._convert_name(name) in self._fields) + + def _convert_name(self, name): + if name in _ALL_FIELDS: + return name + name = name.replace('-', '_').lower() + return _ATTR2FIELD.get(name, name) + + def _default_value(self, name): + if name in _LISTFIELDS or name in _ELEMENTSFIELD: + return [] + return 'UNKNOWN' + + def _remove_line_prefix(self, value): + if self.metadata_version in ('1.0', '1.1'): + return _LINE_PREFIX_PRE_1_2.sub('\n', value) + else: + return _LINE_PREFIX_1_2.sub('\n', value) + + def __getattr__(self, name): + if name in _ATTR2FIELD: + return self[name] + raise AttributeError(name) + + # + # Public API + # + + def get_fullname(self, filesafe=False): + """ + Return the distribution name with version. + + If filesafe is true, return a filename-escaped form. + """ + return _get_name_and_version(self['Name'], self['Version'], filesafe) + + def is_field(self, name): + """return True if name is a valid metadata key""" + name = self._convert_name(name) + return name in _ALL_FIELDS + + def is_multi_field(self, name): + name = self._convert_name(name) + return name in _LISTFIELDS + + def read(self, filepath): + """Read the metadata values from a file path.""" + fp = codecs.open(filepath, 'r', encoding='utf-8') + try: + self.read_file(fp) + finally: + fp.close() + + def read_file(self, fileob): + """Read the metadata values from a file object.""" + msg = message_from_file(fileob) + self._fields['Metadata-Version'] = msg['metadata-version'] + + # When reading, get all the fields we can + for field in _ALL_FIELDS: + if field not in msg: + continue + if field in _LISTFIELDS: + # we can have multiple lines + values = msg.get_all(field) + if field in _LISTTUPLEFIELDS and values is not None: + values = [tuple(value.split(',')) for value in values] + self.set(field, values) + else: + # single line + value = msg[field] + if value is not None and value != 'UNKNOWN': + self.set(field, value) + + # PEP 566 specifies that the body be used for the description, if + # available + body = msg.get_payload() + self["Description"] = body if body else self["Description"] + # logger.debug('Attempting to set metadata for %s', self) + # self.set_metadata_version() + + def write(self, filepath, skip_unknown=False): + """Write the metadata fields to filepath.""" + fp = codecs.open(filepath, 'w', encoding='utf-8') + try: + self.write_file(fp, skip_unknown) + finally: + fp.close() + + def write_file(self, fileobject, skip_unknown=False): + """Write the PKG-INFO format data to a file object.""" + self.set_metadata_version() + + for field in _version2fieldlist(self['Metadata-Version']): + values = self.get(field) + if skip_unknown and values in ('UNKNOWN', [], ['UNKNOWN']): + continue + if field in _ELEMENTSFIELD: + self._write_field(fileobject, field, ','.join(values)) + continue + if field not in _LISTFIELDS: + if field == 'Description': + if self.metadata_version in ('1.0', '1.1'): + values = values.replace('\n', '\n ') + else: + values = values.replace('\n', '\n |') + values = [values] + + if field in _LISTTUPLEFIELDS: + values = [','.join(value) for value in values] + + for value in values: + self._write_field(fileobject, field, value) + + def update(self, other=None, **kwargs): + """Set metadata values from the given iterable `other` and kwargs. + + Behavior is like `dict.update`: If `other` has a ``keys`` method, + they are looped over and ``self[key]`` is assigned ``other[key]``. + Else, ``other`` is an iterable of ``(key, value)`` iterables. + + Keys that don't match a metadata field or that have an empty value are + dropped. + """ + + def _set(key, value): + if key in _ATTR2FIELD and value: + self.set(self._convert_name(key), value) + + if not other: + # other is None or empty container + pass + elif hasattr(other, 'keys'): + for k in other.keys(): + _set(k, other[k]) + else: + for k, v in other: + _set(k, v) + + if kwargs: + for k, v in kwargs.items(): + _set(k, v) + + def set(self, name, value): + """Control then set a metadata field.""" + name = self._convert_name(name) + + if ((name in _ELEMENTSFIELD or name == 'Platform') and not isinstance(value, (list, tuple))): + if isinstance(value, string_types): + value = [v.strip() for v in value.split(',')] + else: + value = [] + elif (name in _LISTFIELDS and not isinstance(value, (list, tuple))): + if isinstance(value, string_types): + value = [value] + else: + value = [] + + if logger.isEnabledFor(logging.WARNING): + project_name = self['Name'] + + scheme = get_scheme(self.scheme) + if name in _PREDICATE_FIELDS and value is not None: + for v in value: + # check that the values are valid + if not scheme.is_valid_matcher(v.split(';')[0]): + logger.warning("'%s': '%s' is not valid (field '%s')", project_name, v, name) + # FIXME this rejects UNKNOWN, is that right? + elif name in _VERSIONS_FIELDS and value is not None: + if not scheme.is_valid_constraint_list(value): + logger.warning("'%s': '%s' is not a valid version (field '%s')", project_name, value, name) + elif name in _VERSION_FIELDS and value is not None: + if not scheme.is_valid_version(value): + logger.warning("'%s': '%s' is not a valid version (field '%s')", project_name, value, name) + + if name in _UNICODEFIELDS: + if name == 'Description': + value = self._remove_line_prefix(value) + + self._fields[name] = value + + def get(self, name, default=_MISSING): + """Get a metadata field.""" + name = self._convert_name(name) + if name not in self._fields: + if default is _MISSING: + default = self._default_value(name) + return default + if name in _UNICODEFIELDS: + value = self._fields[name] + return value + elif name in _LISTFIELDS: + value = self._fields[name] + if value is None: + return [] + res = [] + for val in value: + if name not in _LISTTUPLEFIELDS: + res.append(val) + else: + # That's for Project-URL + res.append((val[0], val[1])) + return res + + elif name in _ELEMENTSFIELD: + value = self._fields[name] + if isinstance(value, string_types): + return value.split(',') + return self._fields[name] + + def check(self, strict=False): + """Check if the metadata is compliant. If strict is True then raise if + no Name or Version are provided""" + self.set_metadata_version() + + # XXX should check the versions (if the file was loaded) + missing, warnings = [], [] + + for attr in ('Name', 'Version'): # required by PEP 345 + if attr not in self: + missing.append(attr) + + if strict and missing != []: + msg = 'missing required metadata: %s' % ', '.join(missing) + raise MetadataMissingError(msg) + + for attr in ('Home-page', 'Author'): + if attr not in self: + missing.append(attr) + + # checking metadata 1.2 (XXX needs to check 1.1, 1.0) + if self['Metadata-Version'] != '1.2': + return missing, warnings + + scheme = get_scheme(self.scheme) + + def are_valid_constraints(value): + for v in value: + if not scheme.is_valid_matcher(v.split(';')[0]): + return False + return True + + for fields, controller in ((_PREDICATE_FIELDS, are_valid_constraints), + (_VERSIONS_FIELDS, scheme.is_valid_constraint_list), (_VERSION_FIELDS, + scheme.is_valid_version)): + for field in fields: + value = self.get(field, None) + if value is not None and not controller(value): + warnings.append("Wrong value for '%s': %s" % (field, value)) + + return missing, warnings + + def todict(self, skip_missing=False): + """Return fields as a dict. + + Field names will be converted to use the underscore-lowercase style + instead of hyphen-mixed case (i.e. home_page instead of Home-page). + This is as per https://www.python.org/dev/peps/pep-0566/#id17. + """ + self.set_metadata_version() + + fields = _version2fieldlist(self['Metadata-Version']) + + data = {} + + for field_name in fields: + if not skip_missing or field_name in self._fields: + key = _FIELD2ATTR[field_name] + if key != 'project_url': + data[key] = self[field_name] + else: + data[key] = [','.join(u) for u in self[field_name]] + + return data + + def add_requirements(self, requirements): + if self['Metadata-Version'] == '1.1': + # we can't have 1.1 metadata *and* Setuptools requires + for field in ('Obsoletes', 'Requires', 'Provides'): + if field in self: + del self[field] + self['Requires-Dist'] += requirements + + # Mapping API + # TODO could add iter* variants + + def keys(self): + return list(_version2fieldlist(self['Metadata-Version'])) + + def __iter__(self): + for key in self.keys(): + yield key + + def values(self): + return [self[key] for key in self.keys()] + + def items(self): + return [(key, self[key]) for key in self.keys()] + + def __repr__(self): + return '<%s %s %s>' % (self.__class__.__name__, self.name, self.version) + + +METADATA_FILENAME = 'pydist.json' +WHEEL_METADATA_FILENAME = 'metadata.json' +LEGACY_METADATA_FILENAME = 'METADATA' + + +class Metadata(object): + """ + The metadata of a release. This implementation uses 2.1 + metadata where possible. If not possible, it wraps a LegacyMetadata + instance which handles the key-value metadata format. + """ + + METADATA_VERSION_MATCHER = re.compile(r'^\d+(\.\d+)*$') + + NAME_MATCHER = re.compile('^[0-9A-Z]([0-9A-Z_.-]*[0-9A-Z])?$', re.I) + + FIELDNAME_MATCHER = re.compile('^[A-Z]([0-9A-Z-]*[0-9A-Z])?$', re.I) + + VERSION_MATCHER = PEP440_VERSION_RE + + SUMMARY_MATCHER = re.compile('.{1,2047}') + + METADATA_VERSION = '2.0' + + GENERATOR = 'distlib (%s)' % __version__ + + MANDATORY_KEYS = { + 'name': (), + 'version': (), + 'summary': ('legacy', ), + } + + INDEX_KEYS = ('name version license summary description author ' + 'author_email keywords platform home_page classifiers ' + 'download_url') + + DEPENDENCY_KEYS = ('extras run_requires test_requires build_requires ' + 'dev_requires provides meta_requires obsoleted_by ' + 'supports_environments') + + SYNTAX_VALIDATORS = { + 'metadata_version': (METADATA_VERSION_MATCHER, ()), + 'name': (NAME_MATCHER, ('legacy', )), + 'version': (VERSION_MATCHER, ('legacy', )), + 'summary': (SUMMARY_MATCHER, ('legacy', )), + 'dynamic': (FIELDNAME_MATCHER, ('legacy', )), + } + + __slots__ = ('_legacy', '_data', 'scheme') + + def __init__(self, path=None, fileobj=None, mapping=None, scheme='default'): + if [path, fileobj, mapping].count(None) < 2: + raise TypeError('path, fileobj and mapping are exclusive') + self._legacy = None + self._data = None + self.scheme = scheme + # import pdb; pdb.set_trace() + if mapping is not None: + try: + self._validate_mapping(mapping, scheme) + self._data = mapping + except MetadataUnrecognizedVersionError: + self._legacy = LegacyMetadata(mapping=mapping, scheme=scheme) + self.validate() + else: + data = None + if path: + with open(path, 'rb') as f: + data = f.read() + elif fileobj: + data = fileobj.read() + if data is None: + # Initialised with no args - to be added + self._data = { + 'metadata_version': self.METADATA_VERSION, + 'generator': self.GENERATOR, + } + else: + if not isinstance(data, text_type): + data = data.decode('utf-8') + try: + self._data = json.loads(data) + self._validate_mapping(self._data, scheme) + except ValueError: + # Note: MetadataUnrecognizedVersionError does not + # inherit from ValueError (it's a DistlibException, + # which should not inherit from ValueError). + # The ValueError comes from the json.load - if that + # succeeds and we get a validation error, we want + # that to propagate + self._legacy = LegacyMetadata(fileobj=StringIO(data), scheme=scheme) + self.validate() + + common_keys = set(('name', 'version', 'license', 'keywords', 'summary')) + + none_list = (None, list) + none_dict = (None, dict) + + mapped_keys = { + 'run_requires': ('Requires-Dist', list), + 'build_requires': ('Setup-Requires-Dist', list), + 'dev_requires': none_list, + 'test_requires': none_list, + 'meta_requires': none_list, + 'extras': ('Provides-Extra', list), + 'modules': none_list, + 'namespaces': none_list, + 'exports': none_dict, + 'commands': none_dict, + 'classifiers': ('Classifier', list), + 'source_url': ('Download-URL', None), + 'metadata_version': ('Metadata-Version', None), + } + + del none_list, none_dict + + def __getattribute__(self, key): + common = object.__getattribute__(self, 'common_keys') + mapped = object.__getattribute__(self, 'mapped_keys') + if key in mapped: + lk, maker = mapped[key] + if self._legacy: + if lk is None: + result = None if maker is None else maker() + else: + result = self._legacy.get(lk) + else: + value = None if maker is None else maker() + if key not in ('commands', 'exports', 'modules', 'namespaces', 'classifiers'): + result = self._data.get(key, value) + else: + # special cases for PEP 459 + sentinel = object() + result = sentinel + d = self._data.get('extensions') + if d: + if key == 'commands': + result = d.get('python.commands', value) + elif key == 'classifiers': + d = d.get('python.details') + if d: + result = d.get(key, value) + else: + d = d.get('python.exports') + if not d: + d = self._data.get('python.exports') + if d: + result = d.get(key, value) + if result is sentinel: + result = value + elif key not in common: + result = object.__getattribute__(self, key) + elif self._legacy: + result = self._legacy.get(key) + else: + result = self._data.get(key) + return result + + def _validate_value(self, key, value, scheme=None): + if key in self.SYNTAX_VALIDATORS: + pattern, exclusions = self.SYNTAX_VALIDATORS[key] + if (scheme or self.scheme) not in exclusions: + m = pattern.match(value) + if not m: + raise MetadataInvalidError("'%s' is an invalid value for " + "the '%s' property" % (value, key)) + + def __setattr__(self, key, value): + self._validate_value(key, value) + common = object.__getattribute__(self, 'common_keys') + mapped = object.__getattribute__(self, 'mapped_keys') + if key in mapped: + lk, _ = mapped[key] + if self._legacy: + if lk is None: + raise NotImplementedError + self._legacy[lk] = value + elif key not in ('commands', 'exports', 'modules', 'namespaces', 'classifiers'): + self._data[key] = value + else: + # special cases for PEP 459 + d = self._data.setdefault('extensions', {}) + if key == 'commands': + d['python.commands'] = value + elif key == 'classifiers': + d = d.setdefault('python.details', {}) + d[key] = value + else: + d = d.setdefault('python.exports', {}) + d[key] = value + elif key not in common: + object.__setattr__(self, key, value) + else: + if key == 'keywords': + if isinstance(value, string_types): + value = value.strip() + if value: + value = value.split() + else: + value = [] + if self._legacy: + self._legacy[key] = value + else: + self._data[key] = value + + @property + def name_and_version(self): + return _get_name_and_version(self.name, self.version, True) + + @property + def provides(self): + if self._legacy: + result = self._legacy['Provides-Dist'] + else: + result = self._data.setdefault('provides', []) + s = '%s (%s)' % (self.name, self.version) + if s not in result: + result.append(s) + return result + + @provides.setter + def provides(self, value): + if self._legacy: + self._legacy['Provides-Dist'] = value + else: + self._data['provides'] = value + + def get_requirements(self, reqts, extras=None, env=None): + """ + Base method to get dependencies, given a set of extras + to satisfy and an optional environment context. + :param reqts: A list of sometimes-wanted dependencies, + perhaps dependent on extras and environment. + :param extras: A list of optional components being requested. + :param env: An optional environment for marker evaluation. + """ + if self._legacy: + result = reqts + else: + result = [] + extras = get_extras(extras or [], self.extras) + for d in reqts: + if 'extra' not in d and 'environment' not in d: + # unconditional + include = True + else: + if 'extra' not in d: + # Not extra-dependent - only environment-dependent + include = True + else: + include = d.get('extra') in extras + if include: + # Not excluded because of extras, check environment + marker = d.get('environment') + if marker: + include = interpret(marker, env) + if include: + result.extend(d['requires']) + for key in ('build', 'dev', 'test'): + e = ':%s:' % key + if e in extras: + extras.remove(e) + # A recursive call, but it should terminate since 'test' + # has been removed from the extras + reqts = self._data.get('%s_requires' % key, []) + result.extend(self.get_requirements(reqts, extras=extras, env=env)) + return result + + @property + def dictionary(self): + if self._legacy: + return self._from_legacy() + return self._data + + @property + def dependencies(self): + if self._legacy: + raise NotImplementedError + else: + return extract_by_key(self._data, self.DEPENDENCY_KEYS) + + @dependencies.setter + def dependencies(self, value): + if self._legacy: + raise NotImplementedError + else: + self._data.update(value) + + def _validate_mapping(self, mapping, scheme): + if mapping.get('metadata_version') != self.METADATA_VERSION: + raise MetadataUnrecognizedVersionError() + missing = [] + for key, exclusions in self.MANDATORY_KEYS.items(): + if key not in mapping: + if scheme not in exclusions: + missing.append(key) + if missing: + msg = 'Missing metadata items: %s' % ', '.join(missing) + raise MetadataMissingError(msg) + for k, v in mapping.items(): + self._validate_value(k, v, scheme) + + def validate(self): + if self._legacy: + missing, warnings = self._legacy.check(True) + if missing or warnings: + logger.warning('Metadata: missing: %s, warnings: %s', missing, warnings) + else: + self._validate_mapping(self._data, self.scheme) + + def todict(self): + if self._legacy: + return self._legacy.todict(True) + else: + result = extract_by_key(self._data, self.INDEX_KEYS) + return result + + def _from_legacy(self): + assert self._legacy and not self._data + result = { + 'metadata_version': self.METADATA_VERSION, + 'generator': self.GENERATOR, + } + lmd = self._legacy.todict(True) # skip missing ones + for k in ('name', 'version', 'license', 'summary', 'description', 'classifier'): + if k in lmd: + if k == 'classifier': + nk = 'classifiers' + else: + nk = k + result[nk] = lmd[k] + kw = lmd.get('Keywords', []) + if kw == ['']: + kw = [] + result['keywords'] = kw + keys = (('requires_dist', 'run_requires'), ('setup_requires_dist', 'build_requires')) + for ok, nk in keys: + if ok in lmd and lmd[ok]: + result[nk] = [{'requires': lmd[ok]}] + result['provides'] = self.provides + # author = {} + # maintainer = {} + return result + + LEGACY_MAPPING = { + 'name': 'Name', + 'version': 'Version', + ('extensions', 'python.details', 'license'): 'License', + 'summary': 'Summary', + 'description': 'Description', + ('extensions', 'python.project', 'project_urls', 'Home'): 'Home-page', + ('extensions', 'python.project', 'contacts', 0, 'name'): 'Author', + ('extensions', 'python.project', 'contacts', 0, 'email'): 'Author-email', + 'source_url': 'Download-URL', + ('extensions', 'python.details', 'classifiers'): 'Classifier', + } + + def _to_legacy(self): + + def process_entries(entries): + reqts = set() + for e in entries: + extra = e.get('extra') + env = e.get('environment') + rlist = e['requires'] + for r in rlist: + if not env and not extra: + reqts.add(r) + else: + marker = '' + if extra: + marker = 'extra == "%s"' % extra + if env: + if marker: + marker = '(%s) and %s' % (env, marker) + else: + marker = env + reqts.add(';'.join((r, marker))) + return reqts + + assert self._data and not self._legacy + result = LegacyMetadata() + nmd = self._data + # import pdb; pdb.set_trace() + for nk, ok in self.LEGACY_MAPPING.items(): + if not isinstance(nk, tuple): + if nk in nmd: + result[ok] = nmd[nk] + else: + d = nmd + found = True + for k in nk: + try: + d = d[k] + except (KeyError, IndexError): + found = False + break + if found: + result[ok] = d + r1 = process_entries(self.run_requires + self.meta_requires) + r2 = process_entries(self.build_requires + self.dev_requires) + if self.extras: + result['Provides-Extra'] = sorted(self.extras) + result['Requires-Dist'] = sorted(r1) + result['Setup-Requires-Dist'] = sorted(r2) + # TODO: any other fields wanted + return result + + def write(self, path=None, fileobj=None, legacy=False, skip_unknown=True): + if [path, fileobj].count(None) != 1: + raise ValueError('Exactly one of path and fileobj is needed') + self.validate() + if legacy: + if self._legacy: + legacy_md = self._legacy + else: + legacy_md = self._to_legacy() + if path: + legacy_md.write(path, skip_unknown=skip_unknown) + else: + legacy_md.write_file(fileobj, skip_unknown=skip_unknown) + else: + if self._legacy: + d = self._from_legacy() + else: + d = self._data + if fileobj: + json.dump(d, fileobj, ensure_ascii=True, indent=2, sort_keys=True) + else: + with codecs.open(path, 'w', 'utf-8') as f: + json.dump(d, f, ensure_ascii=True, indent=2, sort_keys=True) + + def add_requirements(self, requirements): + if self._legacy: + self._legacy.add_requirements(requirements) + else: + run_requires = self._data.setdefault('run_requires', []) + always = None + for entry in run_requires: + if 'environment' not in entry and 'extra' not in entry: + always = entry + break + if always is None: + always = {'requires': requirements} + run_requires.insert(0, always) + else: + rset = set(always['requires']) | set(requirements) + always['requires'] = sorted(rset) + + def __repr__(self): + name = self.name or '(no name)' + version = self.version or 'no version' + return '<%s %s %s (%s)>' % (self.__class__.__name__, self.metadata_version, name, version) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/resources.py b/env/lib/python3.12/site-packages/pip/_vendor/distlib/resources.py new file mode 100644 index 0000000..fef52aa --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distlib/resources.py @@ -0,0 +1,358 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2017 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +from __future__ import unicode_literals + +import bisect +import io +import logging +import os +import pkgutil +import sys +import types +import zipimport + +from . import DistlibException +from .util import cached_property, get_cache_base, Cache + +logger = logging.getLogger(__name__) + + +cache = None # created when needed + + +class ResourceCache(Cache): + def __init__(self, base=None): + if base is None: + # Use native string to avoid issues on 2.x: see Python #20140. + base = os.path.join(get_cache_base(), str('resource-cache')) + super(ResourceCache, self).__init__(base) + + def is_stale(self, resource, path): + """ + Is the cache stale for the given resource? + + :param resource: The :class:`Resource` being cached. + :param path: The path of the resource in the cache. + :return: True if the cache is stale. + """ + # Cache invalidation is a hard problem :-) + return True + + def get(self, resource): + """ + Get a resource into the cache, + + :param resource: A :class:`Resource` instance. + :return: The pathname of the resource in the cache. + """ + prefix, path = resource.finder.get_cache_info(resource) + if prefix is None: + result = path + else: + result = os.path.join(self.base, self.prefix_to_dir(prefix), path) + dirname = os.path.dirname(result) + if not os.path.isdir(dirname): + os.makedirs(dirname) + if not os.path.exists(result): + stale = True + else: + stale = self.is_stale(resource, path) + if stale: + # write the bytes of the resource to the cache location + with open(result, 'wb') as f: + f.write(resource.bytes) + return result + + +class ResourceBase(object): + def __init__(self, finder, name): + self.finder = finder + self.name = name + + +class Resource(ResourceBase): + """ + A class representing an in-package resource, such as a data file. This is + not normally instantiated by user code, but rather by a + :class:`ResourceFinder` which manages the resource. + """ + is_container = False # Backwards compatibility + + def as_stream(self): + """ + Get the resource as a stream. + + This is not a property to make it obvious that it returns a new stream + each time. + """ + return self.finder.get_stream(self) + + @cached_property + def file_path(self): + global cache + if cache is None: + cache = ResourceCache() + return cache.get(self) + + @cached_property + def bytes(self): + return self.finder.get_bytes(self) + + @cached_property + def size(self): + return self.finder.get_size(self) + + +class ResourceContainer(ResourceBase): + is_container = True # Backwards compatibility + + @cached_property + def resources(self): + return self.finder.get_resources(self) + + +class ResourceFinder(object): + """ + Resource finder for file system resources. + """ + + if sys.platform.startswith('java'): + skipped_extensions = ('.pyc', '.pyo', '.class') + else: + skipped_extensions = ('.pyc', '.pyo') + + def __init__(self, module): + self.module = module + self.loader = getattr(module, '__loader__', None) + self.base = os.path.dirname(getattr(module, '__file__', '')) + + def _adjust_path(self, path): + return os.path.realpath(path) + + def _make_path(self, resource_name): + # Issue #50: need to preserve type of path on Python 2.x + # like os.path._get_sep + if isinstance(resource_name, bytes): # should only happen on 2.x + sep = b'/' + else: + sep = '/' + parts = resource_name.split(sep) + parts.insert(0, self.base) + result = os.path.join(*parts) + return self._adjust_path(result) + + def _find(self, path): + return os.path.exists(path) + + def get_cache_info(self, resource): + return None, resource.path + + def find(self, resource_name): + path = self._make_path(resource_name) + if not self._find(path): + result = None + else: + if self._is_directory(path): + result = ResourceContainer(self, resource_name) + else: + result = Resource(self, resource_name) + result.path = path + return result + + def get_stream(self, resource): + return open(resource.path, 'rb') + + def get_bytes(self, resource): + with open(resource.path, 'rb') as f: + return f.read() + + def get_size(self, resource): + return os.path.getsize(resource.path) + + def get_resources(self, resource): + def allowed(f): + return (f != '__pycache__' and not + f.endswith(self.skipped_extensions)) + return set([f for f in os.listdir(resource.path) if allowed(f)]) + + def is_container(self, resource): + return self._is_directory(resource.path) + + _is_directory = staticmethod(os.path.isdir) + + def iterator(self, resource_name): + resource = self.find(resource_name) + if resource is not None: + todo = [resource] + while todo: + resource = todo.pop(0) + yield resource + if resource.is_container: + rname = resource.name + for name in resource.resources: + if not rname: + new_name = name + else: + new_name = '/'.join([rname, name]) + child = self.find(new_name) + if child.is_container: + todo.append(child) + else: + yield child + + +class ZipResourceFinder(ResourceFinder): + """ + Resource finder for resources in .zip files. + """ + def __init__(self, module): + super(ZipResourceFinder, self).__init__(module) + archive = self.loader.archive + self.prefix_len = 1 + len(archive) + # PyPy doesn't have a _files attr on zipimporter, and you can't set one + if hasattr(self.loader, '_files'): + self._files = self.loader._files + else: + self._files = zipimport._zip_directory_cache[archive] + self.index = sorted(self._files) + + def _adjust_path(self, path): + return path + + def _find(self, path): + path = path[self.prefix_len:] + if path in self._files: + result = True + else: + if path and path[-1] != os.sep: + path = path + os.sep + i = bisect.bisect(self.index, path) + try: + result = self.index[i].startswith(path) + except IndexError: + result = False + if not result: + logger.debug('_find failed: %r %r', path, self.loader.prefix) + else: + logger.debug('_find worked: %r %r', path, self.loader.prefix) + return result + + def get_cache_info(self, resource): + prefix = self.loader.archive + path = resource.path[1 + len(prefix):] + return prefix, path + + def get_bytes(self, resource): + return self.loader.get_data(resource.path) + + def get_stream(self, resource): + return io.BytesIO(self.get_bytes(resource)) + + def get_size(self, resource): + path = resource.path[self.prefix_len:] + return self._files[path][3] + + def get_resources(self, resource): + path = resource.path[self.prefix_len:] + if path and path[-1] != os.sep: + path += os.sep + plen = len(path) + result = set() + i = bisect.bisect(self.index, path) + while i < len(self.index): + if not self.index[i].startswith(path): + break + s = self.index[i][plen:] + result.add(s.split(os.sep, 1)[0]) # only immediate children + i += 1 + return result + + def _is_directory(self, path): + path = path[self.prefix_len:] + if path and path[-1] != os.sep: + path += os.sep + i = bisect.bisect(self.index, path) + try: + result = self.index[i].startswith(path) + except IndexError: + result = False + return result + + +_finder_registry = { + type(None): ResourceFinder, + zipimport.zipimporter: ZipResourceFinder +} + +try: + # In Python 3.6, _frozen_importlib -> _frozen_importlib_external + try: + import _frozen_importlib_external as _fi + except ImportError: + import _frozen_importlib as _fi + _finder_registry[_fi.SourceFileLoader] = ResourceFinder + _finder_registry[_fi.FileFinder] = ResourceFinder + # See issue #146 + _finder_registry[_fi.SourcelessFileLoader] = ResourceFinder + del _fi +except (ImportError, AttributeError): + pass + + +def register_finder(loader, finder_maker): + _finder_registry[type(loader)] = finder_maker + + +_finder_cache = {} + + +def finder(package): + """ + Return a resource finder for a package. + :param package: The name of the package. + :return: A :class:`ResourceFinder` instance for the package. + """ + if package in _finder_cache: + result = _finder_cache[package] + else: + if package not in sys.modules: + __import__(package) + module = sys.modules[package] + path = getattr(module, '__path__', None) + if path is None: + raise DistlibException('You cannot get a finder for a module, ' + 'only for a package') + loader = getattr(module, '__loader__', None) + finder_maker = _finder_registry.get(type(loader)) + if finder_maker is None: + raise DistlibException('Unable to locate finder for %r' % package) + result = finder_maker(module) + _finder_cache[package] = result + return result + + +_dummy_module = types.ModuleType(str('__dummy__')) + + +def finder_for_path(path): + """ + Return a resource finder for a path, which should represent a container. + + :param path: The path. + :return: A :class:`ResourceFinder` instance for the path. + """ + result = None + # calls any path hooks, gets importer into cache + pkgutil.get_importer(path) + loader = sys.path_importer_cache.get(path) + finder = _finder_registry.get(type(loader)) + if finder: + module = _dummy_module + module.__file__ = os.path.join(path, '') + module.__loader__ = loader + result = finder(module) + return result diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/scripts.py b/env/lib/python3.12/site-packages/pip/_vendor/distlib/scripts.py new file mode 100644 index 0000000..b1fc705 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distlib/scripts.py @@ -0,0 +1,447 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +from io import BytesIO +import logging +import os +import re +import struct +import sys +import time +from zipfile import ZipInfo + +from .compat import sysconfig, detect_encoding, ZipFile +from .resources import finder +from .util import (FileOperator, get_export_entry, convert_path, get_executable, get_platform, in_venv) + +logger = logging.getLogger(__name__) + +_DEFAULT_MANIFEST = ''' + + + + + + + + + + + + +'''.strip() + +# check if Python is called on the first line with this expression +FIRST_LINE_RE = re.compile(b'^#!.*pythonw?[0-9.]*([ \t].*)?$') +SCRIPT_TEMPLATE = r'''# -*- coding: utf-8 -*- +import re +import sys +from %(module)s import %(import_name)s +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(%(func)s()) +''' + +# Pre-fetch the contents of all executable wrapper stubs. +# This is to address https://github.com/pypa/pip/issues/12666. +# When updating pip, we rename the old pip in place before installing the +# new version. If we try to fetch a wrapper *after* that rename, the finder +# machinery will be confused as the package is no longer available at the +# location where it was imported from. So we load everything into memory in +# advance. + +if os.name == 'nt' or (os.name == 'java' and os._name == 'nt'): + # Issue 31: don't hardcode an absolute package name, but + # determine it relative to the current package + DISTLIB_PACKAGE = __name__.rsplit('.', 1)[0] + + WRAPPERS = { + r.name: r.bytes + for r in finder(DISTLIB_PACKAGE).iterator("") + if r.name.endswith(".exe") + } + + +def enquote_executable(executable): + if ' ' in executable: + # make sure we quote only the executable in case of env + # for example /usr/bin/env "/dir with spaces/bin/jython" + # instead of "/usr/bin/env /dir with spaces/bin/jython" + # otherwise whole + if executable.startswith('/usr/bin/env '): + env, _executable = executable.split(' ', 1) + if ' ' in _executable and not _executable.startswith('"'): + executable = '%s "%s"' % (env, _executable) + else: + if not executable.startswith('"'): + executable = '"%s"' % executable + return executable + + +# Keep the old name around (for now), as there is at least one project using it! +_enquote_executable = enquote_executable + + +class ScriptMaker(object): + """ + A class to copy or create scripts from source scripts or callable + specifications. + """ + script_template = SCRIPT_TEMPLATE + + executable = None # for shebangs + + def __init__(self, source_dir, target_dir, add_launchers=True, dry_run=False, fileop=None): + self.source_dir = source_dir + self.target_dir = target_dir + self.add_launchers = add_launchers + self.force = False + self.clobber = False + # It only makes sense to set mode bits on POSIX. + self.set_mode = (os.name == 'posix') or (os.name == 'java' and os._name == 'posix') + self.variants = set(('', 'X.Y')) + self._fileop = fileop or FileOperator(dry_run) + + self._is_nt = os.name == 'nt' or (os.name == 'java' and os._name == 'nt') + self.version_info = sys.version_info + + def _get_alternate_executable(self, executable, options): + if options.get('gui', False) and self._is_nt: # pragma: no cover + dn, fn = os.path.split(executable) + fn = fn.replace('python', 'pythonw') + executable = os.path.join(dn, fn) + return executable + + if sys.platform.startswith('java'): # pragma: no cover + + def _is_shell(self, executable): + """ + Determine if the specified executable is a script + (contains a #! line) + """ + try: + with open(executable) as fp: + return fp.read(2) == '#!' + except (OSError, IOError): + logger.warning('Failed to open %s', executable) + return False + + def _fix_jython_executable(self, executable): + if self._is_shell(executable): + # Workaround for Jython is not needed on Linux systems. + import java + + if java.lang.System.getProperty('os.name') == 'Linux': + return executable + elif executable.lower().endswith('jython.exe'): + # Use wrapper exe for Jython on Windows + return executable + return '/usr/bin/env %s' % executable + + def _build_shebang(self, executable, post_interp): + """ + Build a shebang line. In the simple case (on Windows, or a shebang line + which is not too long or contains spaces) use a simple formulation for + the shebang. Otherwise, use /bin/sh as the executable, with a contrived + shebang which allows the script to run either under Python or sh, using + suitable quoting. Thanks to Harald Nordgren for his input. + + See also: http://www.in-ulm.de/~mascheck/various/shebang/#length + https://hg.mozilla.org/mozilla-central/file/tip/mach + """ + if os.name != 'posix': + simple_shebang = True + elif getattr(sys, "cross_compiling", False): + # In a cross-compiling environment, the shebang will likely be a + # script; this *must* be invoked with the "safe" version of the + # shebang, or else using os.exec() to run the entry script will + # fail, raising "OSError 8 [Errno 8] Exec format error". + simple_shebang = False + else: + # Add 3 for '#!' prefix and newline suffix. + shebang_length = len(executable) + len(post_interp) + 3 + if sys.platform == 'darwin': + max_shebang_length = 512 + else: + max_shebang_length = 127 + simple_shebang = ((b' ' not in executable) and (shebang_length <= max_shebang_length)) + + if simple_shebang: + result = b'#!' + executable + post_interp + b'\n' + else: + result = b'#!/bin/sh\n' + result += b"'''exec' " + executable + post_interp + b' "$0" "$@"\n' + result += b"' '''\n" + return result + + def _get_shebang(self, encoding, post_interp=b'', options=None): + enquote = True + if self.executable: + executable = self.executable + enquote = False # assume this will be taken care of + elif not sysconfig.is_python_build(): + executable = get_executable() + elif in_venv(): # pragma: no cover + executable = os.path.join(sysconfig.get_path('scripts'), 'python%s' % sysconfig.get_config_var('EXE')) + else: # pragma: no cover + if os.name == 'nt': + # for Python builds from source on Windows, no Python executables with + # a version suffix are created, so we use python.exe + executable = os.path.join(sysconfig.get_config_var('BINDIR'), + 'python%s' % (sysconfig.get_config_var('EXE'))) + else: + executable = os.path.join( + sysconfig.get_config_var('BINDIR'), + 'python%s%s' % (sysconfig.get_config_var('VERSION'), sysconfig.get_config_var('EXE'))) + if options: + executable = self._get_alternate_executable(executable, options) + + if sys.platform.startswith('java'): # pragma: no cover + executable = self._fix_jython_executable(executable) + + # Normalise case for Windows - COMMENTED OUT + # executable = os.path.normcase(executable) + # N.B. The normalising operation above has been commented out: See + # issue #124. Although paths in Windows are generally case-insensitive, + # they aren't always. For example, a path containing a ẞ (which is a + # LATIN CAPITAL LETTER SHARP S - U+1E9E) is normcased to ß (which is a + # LATIN SMALL LETTER SHARP S' - U+00DF). The two are not considered by + # Windows as equivalent in path names. + + # If the user didn't specify an executable, it may be necessary to + # cater for executable paths with spaces (not uncommon on Windows) + if enquote: + executable = enquote_executable(executable) + # Issue #51: don't use fsencode, since we later try to + # check that the shebang is decodable using utf-8. + executable = executable.encode('utf-8') + # in case of IronPython, play safe and enable frames support + if (sys.platform == 'cli' and '-X:Frames' not in post_interp and + '-X:FullFrames' not in post_interp): # pragma: no cover + post_interp += b' -X:Frames' + shebang = self._build_shebang(executable, post_interp) + # Python parser starts to read a script using UTF-8 until + # it gets a #coding:xxx cookie. The shebang has to be the + # first line of a file, the #coding:xxx cookie cannot be + # written before. So the shebang has to be decodable from + # UTF-8. + try: + shebang.decode('utf-8') + except UnicodeDecodeError: # pragma: no cover + raise ValueError('The shebang (%r) is not decodable from utf-8' % shebang) + # If the script is encoded to a custom encoding (use a + # #coding:xxx cookie), the shebang has to be decodable from + # the script encoding too. + if encoding != 'utf-8': + try: + shebang.decode(encoding) + except UnicodeDecodeError: # pragma: no cover + raise ValueError('The shebang (%r) is not decodable ' + 'from the script encoding (%r)' % (shebang, encoding)) + return shebang + + def _get_script_text(self, entry): + return self.script_template % dict( + module=entry.prefix, import_name=entry.suffix.split('.')[0], func=entry.suffix) + + manifest = _DEFAULT_MANIFEST + + def get_manifest(self, exename): + base = os.path.basename(exename) + return self.manifest % base + + def _write_script(self, names, shebang, script_bytes, filenames, ext): + use_launcher = self.add_launchers and self._is_nt + if not use_launcher: + script_bytes = shebang + script_bytes + else: # pragma: no cover + if ext == 'py': + launcher = self._get_launcher('t') + else: + launcher = self._get_launcher('w') + stream = BytesIO() + with ZipFile(stream, 'w') as zf: + source_date_epoch = os.environ.get('SOURCE_DATE_EPOCH') + if source_date_epoch: + date_time = time.gmtime(int(source_date_epoch))[:6] + zinfo = ZipInfo(filename='__main__.py', date_time=date_time) + zf.writestr(zinfo, script_bytes) + else: + zf.writestr('__main__.py', script_bytes) + zip_data = stream.getvalue() + script_bytes = launcher + shebang + zip_data + for name in names: + outname = os.path.join(self.target_dir, name) + if use_launcher: # pragma: no cover + n, e = os.path.splitext(outname) + if e.startswith('.py'): + outname = n + outname = '%s.exe' % outname + try: + self._fileop.write_binary_file(outname, script_bytes) + except Exception: + # Failed writing an executable - it might be in use. + logger.warning('Failed to write executable - trying to ' + 'use .deleteme logic') + dfname = '%s.deleteme' % outname + if os.path.exists(dfname): + os.remove(dfname) # Not allowed to fail here + os.rename(outname, dfname) # nor here + self._fileop.write_binary_file(outname, script_bytes) + logger.debug('Able to replace executable using ' + '.deleteme logic') + try: + os.remove(dfname) + except Exception: + pass # still in use - ignore error + else: + if self._is_nt and not outname.endswith('.' + ext): # pragma: no cover + outname = '%s.%s' % (outname, ext) + if os.path.exists(outname) and not self.clobber: + logger.warning('Skipping existing file %s', outname) + continue + self._fileop.write_binary_file(outname, script_bytes) + if self.set_mode: + self._fileop.set_executable_mode([outname]) + filenames.append(outname) + + variant_separator = '-' + + def get_script_filenames(self, name): + result = set() + if '' in self.variants: + result.add(name) + if 'X' in self.variants: + result.add('%s%s' % (name, self.version_info[0])) + if 'X.Y' in self.variants: + result.add('%s%s%s.%s' % (name, self.variant_separator, self.version_info[0], self.version_info[1])) + return result + + def _make_script(self, entry, filenames, options=None): + post_interp = b'' + if options: + args = options.get('interpreter_args', []) + if args: + args = ' %s' % ' '.join(args) + post_interp = args.encode('utf-8') + shebang = self._get_shebang('utf-8', post_interp, options=options) + script = self._get_script_text(entry).encode('utf-8') + scriptnames = self.get_script_filenames(entry.name) + if options and options.get('gui', False): + ext = 'pyw' + else: + ext = 'py' + self._write_script(scriptnames, shebang, script, filenames, ext) + + def _copy_script(self, script, filenames): + adjust = False + script = os.path.join(self.source_dir, convert_path(script)) + outname = os.path.join(self.target_dir, os.path.basename(script)) + if not self.force and not self._fileop.newer(script, outname): + logger.debug('not copying %s (up-to-date)', script) + return + + # Always open the file, but ignore failures in dry-run mode -- + # that way, we'll get accurate feedback if we can read the + # script. + try: + f = open(script, 'rb') + except IOError: # pragma: no cover + if not self.dry_run: + raise + f = None + else: + first_line = f.readline() + if not first_line: # pragma: no cover + logger.warning('%s is an empty file (skipping)', script) + return + + match = FIRST_LINE_RE.match(first_line.replace(b'\r\n', b'\n')) + if match: + adjust = True + post_interp = match.group(1) or b'' + + if not adjust: + if f: + f.close() + self._fileop.copy_file(script, outname) + if self.set_mode: + self._fileop.set_executable_mode([outname]) + filenames.append(outname) + else: + logger.info('copying and adjusting %s -> %s', script, self.target_dir) + if not self._fileop.dry_run: + encoding, lines = detect_encoding(f.readline) + f.seek(0) + shebang = self._get_shebang(encoding, post_interp) + if b'pythonw' in first_line: # pragma: no cover + ext = 'pyw' + else: + ext = 'py' + n = os.path.basename(outname) + self._write_script([n], shebang, f.read(), filenames, ext) + if f: + f.close() + + @property + def dry_run(self): + return self._fileop.dry_run + + @dry_run.setter + def dry_run(self, value): + self._fileop.dry_run = value + + if os.name == 'nt' or (os.name == 'java' and os._name == 'nt'): # pragma: no cover + # Executable launcher support. + # Launchers are from https://bitbucket.org/vinay.sajip/simple_launcher/ + + def _get_launcher(self, kind): + if struct.calcsize('P') == 8: # 64-bit + bits = '64' + else: + bits = '32' + platform_suffix = '-arm' if get_platform() == 'win-arm64' else '' + name = '%s%s%s.exe' % (kind, bits, platform_suffix) + if name not in WRAPPERS: + msg = ('Unable to find resource %s in package %s' % + (name, DISTLIB_PACKAGE)) + raise ValueError(msg) + return WRAPPERS[name] + + # Public API follows + + def make(self, specification, options=None): + """ + Make a script. + + :param specification: The specification, which is either a valid export + entry specification (to make a script from a + callable) or a filename (to make a script by + copying from a source location). + :param options: A dictionary of options controlling script generation. + :return: A list of all absolute pathnames written to. + """ + filenames = [] + entry = get_export_entry(specification) + if entry is None: + self._copy_script(specification, filenames) + else: + self._make_script(entry, filenames, options=options) + return filenames + + def make_multiple(self, specifications, options=None): + """ + Take a list of specifications and make scripts from them, + :param specifications: A list of specifications. + :return: A list of all absolute pathnames written to, + """ + filenames = [] + for specification in specifications: + filenames.extend(self.make(specification, options)) + return filenames diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/t32.exe b/env/lib/python3.12/site-packages/pip/_vendor/distlib/t32.exe new file mode 100644 index 0000000000000000000000000000000000000000..52154f0be32cc2bdbf98af131d477900667d0abd GIT binary patch literal 97792 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

XMwe#*Lv$g8jIpIBEV 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 w+IyK^N3WCD*(>mhAj=irKyR>D9b+D<@QBhV6U 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

qx{CqlSNQ_YhQ()VtG-D; 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 z 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 bB!6W7g#4-b3-g!cLzth+PZapSNrC?c%T_@< literal 0 HcmV?d00001 diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/wheel.py b/env/lib/python3.12/site-packages/pip/_vendor/distlib/wheel.py new file mode 100644 index 0000000..62ab10f --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distlib/wheel.py @@ -0,0 +1,1100 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +from __future__ import unicode_literals + +import base64 +import codecs +import datetime +from email import message_from_file +import hashlib +import json +import logging +import os +import posixpath +import re +import shutil +import sys +import tempfile +import zipfile + +from . import __version__, DistlibException +from .compat import sysconfig, ZipFile, fsdecode, text_type, filter +from .database import InstalledDistribution +from .metadata import Metadata, WHEEL_METADATA_FILENAME, LEGACY_METADATA_FILENAME +from .util import (FileOperator, convert_path, CSVReader, CSVWriter, Cache, cached_property, get_cache_base, + read_exports, tempdir, get_platform) +from .version import NormalizedVersion, UnsupportedVersionError + +logger = logging.getLogger(__name__) + +cache = None # created when needed + +if hasattr(sys, 'pypy_version_info'): # pragma: no cover + IMP_PREFIX = 'pp' +elif sys.platform.startswith('java'): # pragma: no cover + IMP_PREFIX = 'jy' +elif sys.platform == 'cli': # pragma: no cover + IMP_PREFIX = 'ip' +else: + IMP_PREFIX = 'cp' + +VER_SUFFIX = sysconfig.get_config_var('py_version_nodot') +if not VER_SUFFIX: # pragma: no cover + VER_SUFFIX = '%s%s' % sys.version_info[:2] +PYVER = 'py' + VER_SUFFIX +IMPVER = IMP_PREFIX + VER_SUFFIX + +ARCH = get_platform().replace('-', '_').replace('.', '_') + +ABI = sysconfig.get_config_var('SOABI') +if ABI and ABI.startswith('cpython-'): + ABI = ABI.replace('cpython-', 'cp').split('-')[0] +else: + + def _derive_abi(): + parts = ['cp', VER_SUFFIX] + if sysconfig.get_config_var('Py_DEBUG'): + parts.append('d') + if IMP_PREFIX == 'cp': + vi = sys.version_info[:2] + if vi < (3, 8): + wpm = sysconfig.get_config_var('WITH_PYMALLOC') + if wpm is None: + wpm = True + if wpm: + parts.append('m') + if vi < (3, 3): + us = sysconfig.get_config_var('Py_UNICODE_SIZE') + if us == 4 or (us is None and sys.maxunicode == 0x10FFFF): + parts.append('u') + return ''.join(parts) + + ABI = _derive_abi() + del _derive_abi + +FILENAME_RE = re.compile( + r''' +(?P[^-]+) +-(?P\d+[^-]*) +(-(?P\d+[^-]*))? +-(?P\w+\d+(\.\w+\d+)*) +-(?P\w+) +-(?P\w+(\.\w+)*) +\.whl$ +''', re.IGNORECASE | re.VERBOSE) + +NAME_VERSION_RE = re.compile(r''' +(?P[^-]+) +-(?P\d+[^-]*) +(-(?P\d+[^-]*))?$ +''', re.IGNORECASE | re.VERBOSE) + +SHEBANG_RE = re.compile(br'\s*#![^\r\n]*') +SHEBANG_DETAIL_RE = re.compile(br'^(\s*#!("[^"]+"|\S+))\s+(.*)$') +SHEBANG_PYTHON = b'#!python' +SHEBANG_PYTHONW = b'#!pythonw' + +if os.sep == '/': + to_posix = lambda o: o +else: + to_posix = lambda o: o.replace(os.sep, '/') + +if sys.version_info[0] < 3: + import imp +else: + imp = None + import importlib.machinery + import importlib.util + + +def _get_suffixes(): + if imp: + return [s[0] for s in imp.get_suffixes()] + else: + return importlib.machinery.EXTENSION_SUFFIXES + + +def _load_dynamic(name, path): + # https://docs.python.org/3/library/importlib.html#importing-a-source-file-directly + if imp: + return imp.load_dynamic(name, path) + else: + spec = importlib.util.spec_from_file_location(name, path) + module = importlib.util.module_from_spec(spec) + sys.modules[name] = module + spec.loader.exec_module(module) + return module + + +class Mounter(object): + + def __init__(self): + self.impure_wheels = {} + self.libs = {} + + def add(self, pathname, extensions): + self.impure_wheels[pathname] = extensions + self.libs.update(extensions) + + def remove(self, pathname): + extensions = self.impure_wheels.pop(pathname) + for k, v in extensions: + if k in self.libs: + del self.libs[k] + + def find_module(self, fullname, path=None): + if fullname in self.libs: + result = self + else: + result = None + return result + + def load_module(self, fullname): + if fullname in sys.modules: + result = sys.modules[fullname] + else: + if fullname not in self.libs: + raise ImportError('unable to find extension for %s' % fullname) + result = _load_dynamic(fullname, self.libs[fullname]) + result.__loader__ = self + parts = fullname.rsplit('.', 1) + if len(parts) > 1: + result.__package__ = parts[0] + return result + + +_hook = Mounter() + + +class Wheel(object): + """ + Class to build and install from Wheel files (PEP 427). + """ + + wheel_version = (1, 1) + hash_kind = 'sha256' + + def __init__(self, filename=None, sign=False, verify=False): + """ + Initialise an instance using a (valid) filename. + """ + self.sign = sign + self.should_verify = verify + self.buildver = '' + self.pyver = [PYVER] + self.abi = ['none'] + self.arch = ['any'] + self.dirname = os.getcwd() + if filename is None: + self.name = 'dummy' + self.version = '0.1' + self._filename = self.filename + else: + m = NAME_VERSION_RE.match(filename) + if m: + info = m.groupdict('') + self.name = info['nm'] + # Reinstate the local version separator + self.version = info['vn'].replace('_', '-') + self.buildver = info['bn'] + self._filename = self.filename + else: + dirname, filename = os.path.split(filename) + m = FILENAME_RE.match(filename) + if not m: + raise DistlibException('Invalid name or ' + 'filename: %r' % filename) + if dirname: + self.dirname = os.path.abspath(dirname) + self._filename = filename + info = m.groupdict('') + self.name = info['nm'] + self.version = info['vn'] + self.buildver = info['bn'] + self.pyver = info['py'].split('.') + self.abi = info['bi'].split('.') + self.arch = info['ar'].split('.') + + @property + def filename(self): + """ + Build and return a filename from the various components. + """ + if self.buildver: + buildver = '-' + self.buildver + else: + buildver = '' + pyver = '.'.join(self.pyver) + abi = '.'.join(self.abi) + arch = '.'.join(self.arch) + # replace - with _ as a local version separator + version = self.version.replace('-', '_') + return '%s-%s%s-%s-%s-%s.whl' % (self.name, version, buildver, pyver, abi, arch) + + @property + def exists(self): + path = os.path.join(self.dirname, self.filename) + return os.path.isfile(path) + + @property + def tags(self): + for pyver in self.pyver: + for abi in self.abi: + for arch in self.arch: + yield pyver, abi, arch + + @cached_property + def metadata(self): + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + info_dir = '%s.dist-info' % name_ver + wrapper = codecs.getreader('utf-8') + with ZipFile(pathname, 'r') as zf: + self.get_wheel_metadata(zf) + # wv = wheel_metadata['Wheel-Version'].split('.', 1) + # file_version = tuple([int(i) for i in wv]) + # if file_version < (1, 1): + # fns = [WHEEL_METADATA_FILENAME, METADATA_FILENAME, + # LEGACY_METADATA_FILENAME] + # else: + # fns = [WHEEL_METADATA_FILENAME, METADATA_FILENAME] + fns = [WHEEL_METADATA_FILENAME, LEGACY_METADATA_FILENAME] + result = None + for fn in fns: + try: + metadata_filename = posixpath.join(info_dir, fn) + with zf.open(metadata_filename) as bf: + wf = wrapper(bf) + result = Metadata(fileobj=wf) + if result: + break + except KeyError: + pass + if not result: + raise ValueError('Invalid wheel, because metadata is ' + 'missing: looked in %s' % ', '.join(fns)) + return result + + def get_wheel_metadata(self, zf): + name_ver = '%s-%s' % (self.name, self.version) + info_dir = '%s.dist-info' % name_ver + metadata_filename = posixpath.join(info_dir, 'WHEEL') + with zf.open(metadata_filename) as bf: + wf = codecs.getreader('utf-8')(bf) + message = message_from_file(wf) + return dict(message) + + @cached_property + def info(self): + pathname = os.path.join(self.dirname, self.filename) + with ZipFile(pathname, 'r') as zf: + result = self.get_wheel_metadata(zf) + return result + + def process_shebang(self, data): + m = SHEBANG_RE.match(data) + if m: + end = m.end() + shebang, data_after_shebang = data[:end], data[end:] + # Preserve any arguments after the interpreter + if b'pythonw' in shebang.lower(): + shebang_python = SHEBANG_PYTHONW + else: + shebang_python = SHEBANG_PYTHON + m = SHEBANG_DETAIL_RE.match(shebang) + if m: + args = b' ' + m.groups()[-1] + else: + args = b'' + shebang = shebang_python + args + data = shebang + data_after_shebang + else: + cr = data.find(b'\r') + lf = data.find(b'\n') + if cr < 0 or cr > lf: + term = b'\n' + else: + if data[cr:cr + 2] == b'\r\n': + term = b'\r\n' + else: + term = b'\r' + data = SHEBANG_PYTHON + term + data + return data + + def get_hash(self, data, hash_kind=None): + if hash_kind is None: + hash_kind = self.hash_kind + try: + hasher = getattr(hashlib, hash_kind) + except AttributeError: + raise DistlibException('Unsupported hash algorithm: %r' % hash_kind) + result = hasher(data).digest() + result = base64.urlsafe_b64encode(result).rstrip(b'=').decode('ascii') + return hash_kind, result + + def write_record(self, records, record_path, archive_record_path): + records = list(records) # make a copy, as mutated + records.append((archive_record_path, '', '')) + with CSVWriter(record_path) as writer: + for row in records: + writer.writerow(row) + + def write_records(self, info, libdir, archive_paths): + records = [] + distinfo, info_dir = info + # hasher = getattr(hashlib, self.hash_kind) + for ap, p in archive_paths: + with open(p, 'rb') as f: + data = f.read() + digest = '%s=%s' % self.get_hash(data) + size = os.path.getsize(p) + records.append((ap, digest, size)) + + p = os.path.join(distinfo, 'RECORD') + ap = to_posix(os.path.join(info_dir, 'RECORD')) + self.write_record(records, p, ap) + archive_paths.append((ap, p)) + + def build_zip(self, pathname, archive_paths): + with ZipFile(pathname, 'w', zipfile.ZIP_DEFLATED) as zf: + for ap, p in archive_paths: + logger.debug('Wrote %s to %s in wheel', p, ap) + zf.write(p, ap) + + def build(self, paths, tags=None, wheel_version=None): + """ + Build a wheel from files in specified paths, and use any specified tags + when determining the name of the wheel. + """ + if tags is None: + tags = {} + + libkey = list(filter(lambda o: o in paths, ('purelib', 'platlib')))[0] + if libkey == 'platlib': + is_pure = 'false' + default_pyver = [IMPVER] + default_abi = [ABI] + default_arch = [ARCH] + else: + is_pure = 'true' + default_pyver = [PYVER] + default_abi = ['none'] + default_arch = ['any'] + + self.pyver = tags.get('pyver', default_pyver) + self.abi = tags.get('abi', default_abi) + self.arch = tags.get('arch', default_arch) + + libdir = paths[libkey] + + name_ver = '%s-%s' % (self.name, self.version) + data_dir = '%s.data' % name_ver + info_dir = '%s.dist-info' % name_ver + + archive_paths = [] + + # First, stuff which is not in site-packages + for key in ('data', 'headers', 'scripts'): + if key not in paths: + continue + path = paths[key] + if os.path.isdir(path): + for root, dirs, files in os.walk(path): + for fn in files: + p = fsdecode(os.path.join(root, fn)) + rp = os.path.relpath(p, path) + ap = to_posix(os.path.join(data_dir, key, rp)) + archive_paths.append((ap, p)) + if key == 'scripts' and not p.endswith('.exe'): + with open(p, 'rb') as f: + data = f.read() + data = self.process_shebang(data) + with open(p, 'wb') as f: + f.write(data) + + # Now, stuff which is in site-packages, other than the + # distinfo stuff. + path = libdir + distinfo = None + for root, dirs, files in os.walk(path): + if root == path: + # At the top level only, save distinfo for later + # and skip it for now + for i, dn in enumerate(dirs): + dn = fsdecode(dn) + if dn.endswith('.dist-info'): + distinfo = os.path.join(root, dn) + del dirs[i] + break + assert distinfo, '.dist-info directory expected, not found' + + for fn in files: + # comment out next suite to leave .pyc files in + if fsdecode(fn).endswith(('.pyc', '.pyo')): + continue + p = os.path.join(root, fn) + rp = to_posix(os.path.relpath(p, path)) + archive_paths.append((rp, p)) + + # Now distinfo. Assumed to be flat, i.e. os.listdir is enough. + files = os.listdir(distinfo) + for fn in files: + if fn not in ('RECORD', 'INSTALLER', 'SHARED', 'WHEEL'): + p = fsdecode(os.path.join(distinfo, fn)) + ap = to_posix(os.path.join(info_dir, fn)) + archive_paths.append((ap, p)) + + wheel_metadata = [ + 'Wheel-Version: %d.%d' % (wheel_version or self.wheel_version), + 'Generator: distlib %s' % __version__, + 'Root-Is-Purelib: %s' % is_pure, + ] + for pyver, abi, arch in self.tags: + wheel_metadata.append('Tag: %s-%s-%s' % (pyver, abi, arch)) + p = os.path.join(distinfo, 'WHEEL') + with open(p, 'w') as f: + f.write('\n'.join(wheel_metadata)) + ap = to_posix(os.path.join(info_dir, 'WHEEL')) + archive_paths.append((ap, p)) + + # sort the entries by archive path. Not needed by any spec, but it + # keeps the archive listing and RECORD tidier than they would otherwise + # be. Use the number of path segments to keep directory entries together, + # and keep the dist-info stuff at the end. + def sorter(t): + ap = t[0] + n = ap.count('/') + if '.dist-info' in ap: + n += 10000 + return (n, ap) + + archive_paths = sorted(archive_paths, key=sorter) + + # Now, at last, RECORD. + # Paths in here are archive paths - nothing else makes sense. + self.write_records((distinfo, info_dir), libdir, archive_paths) + # Now, ready to build the zip file + pathname = os.path.join(self.dirname, self.filename) + self.build_zip(pathname, archive_paths) + return pathname + + def skip_entry(self, arcname): + """ + Determine whether an archive entry should be skipped when verifying + or installing. + """ + # The signature file won't be in RECORD, + # and we don't currently don't do anything with it + # We also skip directories, as they won't be in RECORD + # either. See: + # + # https://github.com/pypa/wheel/issues/294 + # https://github.com/pypa/wheel/issues/287 + # https://github.com/pypa/wheel/pull/289 + # + return arcname.endswith(('/', '/RECORD.jws')) + + def install(self, paths, maker, **kwargs): + """ + Install a wheel to the specified paths. If kwarg ``warner`` is + specified, it should be a callable, which will be called with two + tuples indicating the wheel version of this software and the wheel + version in the file, if there is a discrepancy in the versions. + This can be used to issue any warnings to raise any exceptions. + If kwarg ``lib_only`` is True, only the purelib/platlib files are + installed, and the headers, scripts, data and dist-info metadata are + not written. If kwarg ``bytecode_hashed_invalidation`` is True, written + bytecode will try to use file-hash based invalidation (PEP-552) on + supported interpreter versions (CPython 3.7+). + + The return value is a :class:`InstalledDistribution` instance unless + ``options.lib_only`` is True, in which case the return value is ``None``. + """ + + dry_run = maker.dry_run + warner = kwargs.get('warner') + lib_only = kwargs.get('lib_only', False) + bc_hashed_invalidation = kwargs.get('bytecode_hashed_invalidation', False) + + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + data_dir = '%s.data' % name_ver + info_dir = '%s.dist-info' % name_ver + + metadata_name = posixpath.join(info_dir, LEGACY_METADATA_FILENAME) + wheel_metadata_name = posixpath.join(info_dir, 'WHEEL') + record_name = posixpath.join(info_dir, 'RECORD') + + wrapper = codecs.getreader('utf-8') + + with ZipFile(pathname, 'r') as zf: + with zf.open(wheel_metadata_name) as bwf: + wf = wrapper(bwf) + message = message_from_file(wf) + wv = message['Wheel-Version'].split('.', 1) + file_version = tuple([int(i) for i in wv]) + if (file_version != self.wheel_version) and warner: + warner(self.wheel_version, file_version) + + if message['Root-Is-Purelib'] == 'true': + libdir = paths['purelib'] + else: + libdir = paths['platlib'] + + records = {} + with zf.open(record_name) as bf: + with CSVReader(stream=bf) as reader: + for row in reader: + p = row[0] + records[p] = row + + data_pfx = posixpath.join(data_dir, '') + info_pfx = posixpath.join(info_dir, '') + script_pfx = posixpath.join(data_dir, 'scripts', '') + + # make a new instance rather than a copy of maker's, + # as we mutate it + fileop = FileOperator(dry_run=dry_run) + fileop.record = True # so we can rollback if needed + + bc = not sys.dont_write_bytecode # Double negatives. Lovely! + + outfiles = [] # for RECORD writing + + # for script copying/shebang processing + workdir = tempfile.mkdtemp() + # set target dir later + # we default add_launchers to False, as the + # Python Launcher should be used instead + maker.source_dir = workdir + maker.target_dir = None + try: + for zinfo in zf.infolist(): + arcname = zinfo.filename + if isinstance(arcname, text_type): + u_arcname = arcname + else: + u_arcname = arcname.decode('utf-8') + if self.skip_entry(u_arcname): + continue + row = records[u_arcname] + if row[2] and str(zinfo.file_size) != row[2]: + raise DistlibException('size mismatch for ' + '%s' % u_arcname) + if row[1]: + kind, value = row[1].split('=', 1) + with zf.open(arcname) as bf: + data = bf.read() + _, digest = self.get_hash(data, kind) + if digest != value: + raise DistlibException('digest mismatch for ' + '%s' % arcname) + + if lib_only and u_arcname.startswith((info_pfx, data_pfx)): + logger.debug('lib_only: skipping %s', u_arcname) + continue + is_script = (u_arcname.startswith(script_pfx) and not u_arcname.endswith('.exe')) + + if u_arcname.startswith(data_pfx): + _, where, rp = u_arcname.split('/', 2) + outfile = os.path.join(paths[where], convert_path(rp)) + else: + # meant for site-packages. + if u_arcname in (wheel_metadata_name, record_name): + continue + outfile = os.path.join(libdir, convert_path(u_arcname)) + if not is_script: + with zf.open(arcname) as bf: + fileop.copy_stream(bf, outfile) + # Issue #147: permission bits aren't preserved. Using + # zf.extract(zinfo, libdir) should have worked, but didn't, + # see https://www.thetopsites.net/article/53834422.shtml + # So ... manually preserve permission bits as given in zinfo + if os.name == 'posix': + # just set the normal permission bits + os.chmod(outfile, (zinfo.external_attr >> 16) & 0x1FF) + outfiles.append(outfile) + # Double check the digest of the written file + if not dry_run and row[1]: + with open(outfile, 'rb') as bf: + data = bf.read() + _, newdigest = self.get_hash(data, kind) + if newdigest != digest: + raise DistlibException('digest mismatch ' + 'on write for ' + '%s' % outfile) + if bc and outfile.endswith('.py'): + try: + pyc = fileop.byte_compile(outfile, hashed_invalidation=bc_hashed_invalidation) + outfiles.append(pyc) + except Exception: + # Don't give up if byte-compilation fails, + # but log it and perhaps warn the user + logger.warning('Byte-compilation failed', exc_info=True) + else: + fn = os.path.basename(convert_path(arcname)) + workname = os.path.join(workdir, fn) + with zf.open(arcname) as bf: + fileop.copy_stream(bf, workname) + + dn, fn = os.path.split(outfile) + maker.target_dir = dn + filenames = maker.make(fn) + fileop.set_executable_mode(filenames) + outfiles.extend(filenames) + + if lib_only: + logger.debug('lib_only: returning None') + dist = None + else: + # Generate scripts + + # Try to get pydist.json so we can see if there are + # any commands to generate. If this fails (e.g. because + # of a legacy wheel), log a warning but don't give up. + commands = None + file_version = self.info['Wheel-Version'] + if file_version == '1.0': + # Use legacy info + ep = posixpath.join(info_dir, 'entry_points.txt') + try: + with zf.open(ep) as bwf: + epdata = read_exports(bwf) + commands = {} + for key in ('console', 'gui'): + k = '%s_scripts' % key + if k in epdata: + commands['wrap_%s' % key] = d = {} + for v in epdata[k].values(): + s = '%s:%s' % (v.prefix, v.suffix) + if v.flags: + s += ' [%s]' % ','.join(v.flags) + d[v.name] = s + except Exception: + logger.warning('Unable to read legacy script ' + 'metadata, so cannot generate ' + 'scripts') + else: + try: + with zf.open(metadata_name) as bwf: + wf = wrapper(bwf) + commands = json.load(wf).get('extensions') + if commands: + commands = commands.get('python.commands') + except Exception: + logger.warning('Unable to read JSON metadata, so ' + 'cannot generate scripts') + if commands: + console_scripts = commands.get('wrap_console', {}) + gui_scripts = commands.get('wrap_gui', {}) + if console_scripts or gui_scripts: + script_dir = paths.get('scripts', '') + if not os.path.isdir(script_dir): + raise ValueError('Valid script path not ' + 'specified') + maker.target_dir = script_dir + for k, v in console_scripts.items(): + script = '%s = %s' % (k, v) + filenames = maker.make(script) + fileop.set_executable_mode(filenames) + + if gui_scripts: + options = {'gui': True} + for k, v in gui_scripts.items(): + script = '%s = %s' % (k, v) + filenames = maker.make(script, options) + fileop.set_executable_mode(filenames) + + p = os.path.join(libdir, info_dir) + dist = InstalledDistribution(p) + + # Write SHARED + paths = dict(paths) # don't change passed in dict + del paths['purelib'] + del paths['platlib'] + paths['lib'] = libdir + p = dist.write_shared_locations(paths, dry_run) + if p: + outfiles.append(p) + + # Write RECORD + dist.write_installed_files(outfiles, paths['prefix'], dry_run) + return dist + except Exception: # pragma: no cover + logger.exception('installation failed.') + fileop.rollback() + raise + finally: + shutil.rmtree(workdir) + + def _get_dylib_cache(self): + global cache + if cache is None: + # Use native string to avoid issues on 2.x: see Python #20140. + base = os.path.join(get_cache_base(), str('dylib-cache'), '%s.%s' % sys.version_info[:2]) + cache = Cache(base) + return cache + + def _get_extensions(self): + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + info_dir = '%s.dist-info' % name_ver + arcname = posixpath.join(info_dir, 'EXTENSIONS') + wrapper = codecs.getreader('utf-8') + result = [] + with ZipFile(pathname, 'r') as zf: + try: + with zf.open(arcname) as bf: + wf = wrapper(bf) + extensions = json.load(wf) + cache = self._get_dylib_cache() + prefix = cache.prefix_to_dir(self.filename, use_abspath=False) + cache_base = os.path.join(cache.base, prefix) + if not os.path.isdir(cache_base): + os.makedirs(cache_base) + for name, relpath in extensions.items(): + dest = os.path.join(cache_base, convert_path(relpath)) + if not os.path.exists(dest): + extract = True + else: + file_time = os.stat(dest).st_mtime + file_time = datetime.datetime.fromtimestamp(file_time) + info = zf.getinfo(relpath) + wheel_time = datetime.datetime(*info.date_time) + extract = wheel_time > file_time + if extract: + zf.extract(relpath, cache_base) + result.append((name, dest)) + except KeyError: + pass + return result + + def is_compatible(self): + """ + Determine if a wheel is compatible with the running system. + """ + return is_compatible(self) + + def is_mountable(self): + """ + Determine if a wheel is asserted as mountable by its metadata. + """ + return True # for now - metadata details TBD + + def mount(self, append=False): + pathname = os.path.abspath(os.path.join(self.dirname, self.filename)) + if not self.is_compatible(): + msg = 'Wheel %s not compatible with this Python.' % pathname + raise DistlibException(msg) + if not self.is_mountable(): + msg = 'Wheel %s is marked as not mountable.' % pathname + raise DistlibException(msg) + if pathname in sys.path: + logger.debug('%s already in path', pathname) + else: + if append: + sys.path.append(pathname) + else: + sys.path.insert(0, pathname) + extensions = self._get_extensions() + if extensions: + if _hook not in sys.meta_path: + sys.meta_path.append(_hook) + _hook.add(pathname, extensions) + + def unmount(self): + pathname = os.path.abspath(os.path.join(self.dirname, self.filename)) + if pathname not in sys.path: + logger.debug('%s not in path', pathname) + else: + sys.path.remove(pathname) + if pathname in _hook.impure_wheels: + _hook.remove(pathname) + if not _hook.impure_wheels: + if _hook in sys.meta_path: + sys.meta_path.remove(_hook) + + def verify(self): + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + # data_dir = '%s.data' % name_ver + info_dir = '%s.dist-info' % name_ver + + # metadata_name = posixpath.join(info_dir, LEGACY_METADATA_FILENAME) + wheel_metadata_name = posixpath.join(info_dir, 'WHEEL') + record_name = posixpath.join(info_dir, 'RECORD') + + wrapper = codecs.getreader('utf-8') + + with ZipFile(pathname, 'r') as zf: + with zf.open(wheel_metadata_name) as bwf: + wf = wrapper(bwf) + message_from_file(wf) + # wv = message['Wheel-Version'].split('.', 1) + # file_version = tuple([int(i) for i in wv]) + # TODO version verification + + records = {} + with zf.open(record_name) as bf: + with CSVReader(stream=bf) as reader: + for row in reader: + p = row[0] + records[p] = row + + for zinfo in zf.infolist(): + arcname = zinfo.filename + if isinstance(arcname, text_type): + u_arcname = arcname + else: + u_arcname = arcname.decode('utf-8') + # See issue #115: some wheels have .. in their entries, but + # in the filename ... e.g. __main__..py ! So the check is + # updated to look for .. in the directory portions + p = u_arcname.split('/') + if '..' in p: + raise DistlibException('invalid entry in ' + 'wheel: %r' % u_arcname) + + if self.skip_entry(u_arcname): + continue + row = records[u_arcname] + if row[2] and str(zinfo.file_size) != row[2]: + raise DistlibException('size mismatch for ' + '%s' % u_arcname) + if row[1]: + kind, value = row[1].split('=', 1) + with zf.open(arcname) as bf: + data = bf.read() + _, digest = self.get_hash(data, kind) + if digest != value: + raise DistlibException('digest mismatch for ' + '%s' % arcname) + + def update(self, modifier, dest_dir=None, **kwargs): + """ + Update the contents of a wheel in a generic way. The modifier should + be a callable which expects a dictionary argument: its keys are + archive-entry paths, and its values are absolute filesystem paths + where the contents the corresponding archive entries can be found. The + modifier is free to change the contents of the files pointed to, add + new entries and remove entries, before returning. This method will + extract the entire contents of the wheel to a temporary location, call + the modifier, and then use the passed (and possibly updated) + dictionary to write a new wheel. If ``dest_dir`` is specified, the new + wheel is written there -- otherwise, the original wheel is overwritten. + + The modifier should return True if it updated the wheel, else False. + This method returns the same value the modifier returns. + """ + + def get_version(path_map, info_dir): + version = path = None + key = '%s/%s' % (info_dir, LEGACY_METADATA_FILENAME) + if key not in path_map: + key = '%s/PKG-INFO' % info_dir + if key in path_map: + path = path_map[key] + version = Metadata(path=path).version + return version, path + + def update_version(version, path): + updated = None + try: + NormalizedVersion(version) + i = version.find('-') + if i < 0: + updated = '%s+1' % version + else: + parts = [int(s) for s in version[i + 1:].split('.')] + parts[-1] += 1 + updated = '%s+%s' % (version[:i], '.'.join(str(i) for i in parts)) + except UnsupportedVersionError: + logger.debug('Cannot update non-compliant (PEP-440) ' + 'version %r', version) + if updated: + md = Metadata(path=path) + md.version = updated + legacy = path.endswith(LEGACY_METADATA_FILENAME) + md.write(path=path, legacy=legacy) + logger.debug('Version updated from %r to %r', version, updated) + + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + info_dir = '%s.dist-info' % name_ver + record_name = posixpath.join(info_dir, 'RECORD') + with tempdir() as workdir: + with ZipFile(pathname, 'r') as zf: + path_map = {} + for zinfo in zf.infolist(): + arcname = zinfo.filename + if isinstance(arcname, text_type): + u_arcname = arcname + else: + u_arcname = arcname.decode('utf-8') + if u_arcname == record_name: + continue + if '..' in u_arcname: + raise DistlibException('invalid entry in ' + 'wheel: %r' % u_arcname) + zf.extract(zinfo, workdir) + path = os.path.join(workdir, convert_path(u_arcname)) + path_map[u_arcname] = path + + # Remember the version. + original_version, _ = get_version(path_map, info_dir) + # Files extracted. Call the modifier. + modified = modifier(path_map, **kwargs) + if modified: + # Something changed - need to build a new wheel. + current_version, path = get_version(path_map, info_dir) + if current_version and (current_version == original_version): + # Add or update local version to signify changes. + update_version(current_version, path) + # Decide where the new wheel goes. + if dest_dir is None: + fd, newpath = tempfile.mkstemp(suffix='.whl', prefix='wheel-update-', dir=workdir) + os.close(fd) + else: + if not os.path.isdir(dest_dir): + raise DistlibException('Not a directory: %r' % dest_dir) + newpath = os.path.join(dest_dir, self.filename) + archive_paths = list(path_map.items()) + distinfo = os.path.join(workdir, info_dir) + info = distinfo, info_dir + self.write_records(info, workdir, archive_paths) + self.build_zip(newpath, archive_paths) + if dest_dir is None: + shutil.copyfile(newpath, pathname) + return modified + + +def _get_glibc_version(): + import platform + ver = platform.libc_ver() + result = [] + if ver[0] == 'glibc': + for s in ver[1].split('.'): + result.append(int(s) if s.isdigit() else 0) + result = tuple(result) + return result + + +def compatible_tags(): + """ + Return (pyver, abi, arch) tuples compatible with this Python. + """ + class _Version: + def __init__(self, major, minor): + self.major = major + self.major_minor = (major, minor) + self.string = ''.join((str(major), str(minor))) + + def __str__(self): + return self.string + + + versions = [ + _Version(sys.version_info.major, minor_version) + for minor_version in range(sys.version_info.minor, -1, -1) + ] + abis = [] + for suffix in _get_suffixes(): + if suffix.startswith('.abi'): + abis.append(suffix.split('.', 2)[1]) + abis.sort() + if ABI != 'none': + abis.insert(0, ABI) + abis.append('none') + result = [] + + arches = [ARCH] + if sys.platform == 'darwin': + m = re.match(r'(\w+)_(\d+)_(\d+)_(\w+)$', ARCH) + if m: + name, major, minor, arch = m.groups() + minor = int(minor) + matches = [arch] + if arch in ('i386', 'ppc'): + matches.append('fat') + if arch in ('i386', 'ppc', 'x86_64'): + matches.append('fat3') + if arch in ('ppc64', 'x86_64'): + matches.append('fat64') + if arch in ('i386', 'x86_64'): + matches.append('intel') + if arch in ('i386', 'x86_64', 'intel', 'ppc', 'ppc64'): + matches.append('universal') + while minor >= 0: + for match in matches: + s = '%s_%s_%s_%s' % (name, major, minor, match) + if s != ARCH: # already there + arches.append(s) + minor -= 1 + + # Most specific - our Python version, ABI and arch + for i, version_object in enumerate(versions): + version = str(version_object) + add_abis = [] + + if i == 0: + add_abis = abis + + if IMP_PREFIX == 'cp' and version_object.major_minor >= (3, 2): + limited_api_abi = 'abi' + str(version_object.major) + if limited_api_abi not in add_abis: + add_abis.append(limited_api_abi) + + for abi in add_abis: + for arch in arches: + result.append((''.join((IMP_PREFIX, version)), abi, arch)) + # manylinux + if abi != 'none' and sys.platform.startswith('linux'): + arch = arch.replace('linux_', '') + parts = _get_glibc_version() + if len(parts) == 2: + if parts >= (2, 5): + result.append((''.join((IMP_PREFIX, version)), abi, 'manylinux1_%s' % arch)) + if parts >= (2, 12): + result.append((''.join((IMP_PREFIX, version)), abi, 'manylinux2010_%s' % arch)) + if parts >= (2, 17): + result.append((''.join((IMP_PREFIX, version)), abi, 'manylinux2014_%s' % arch)) + result.append((''.join( + (IMP_PREFIX, version)), abi, 'manylinux_%s_%s_%s' % (parts[0], parts[1], arch))) + + # where no ABI / arch dependency, but IMP_PREFIX dependency + for i, version_object in enumerate(versions): + version = str(version_object) + result.append((''.join((IMP_PREFIX, version)), 'none', 'any')) + if i == 0: + result.append((''.join((IMP_PREFIX, version[0])), 'none', 'any')) + + # no IMP_PREFIX, ABI or arch dependency + for i, version_object in enumerate(versions): + version = str(version_object) + result.append((''.join(('py', version)), 'none', 'any')) + if i == 0: + result.append((''.join(('py', version[0])), 'none', 'any')) + + return set(result) + + +COMPATIBLE_TAGS = compatible_tags() + +del compatible_tags + + +def is_compatible(wheel, tags=None): + if not isinstance(wheel, Wheel): + wheel = Wheel(wheel) # assume it's a filename + result = False + if tags is None: + tags = COMPATIBLE_TAGS + for ver, abi, arch in tags: + if ver in wheel.pyver and abi in wheel.abi and arch in wheel.arch: + result = True + break + return result diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distro/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/distro/__init__.py new file mode 100644 index 0000000..7686fe8 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/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/env/lib/python3.12/site-packages/pip/_vendor/distro/__main__.py b/env/lib/python3.12/site-packages/pip/_vendor/distro/__main__.py new file mode 100644 index 0000000..0c01d5b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distro/__main__.py @@ -0,0 +1,4 @@ +from .distro import main + +if __name__ == "__main__": + main() diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distro/distro.py b/env/lib/python3.12/site-packages/pip/_vendor/distro/distro.py new file mode 100644 index 0000000..78ccdfa --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distro/distro.py @@ -0,0 +1,1403 @@ +#!/usr/bin/env python +# 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. +# 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 +`_ 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.9.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 looked up for if _UNIXCONFDIR is not readable. +_DISTRO_RELEASE_BASENAMES = [ + "SuSE-release", + "altlinux-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", + "lsb-release", + "oem-release", + _OS_RELEASE_BASENAME, + "system-release", + "plesk-release", + "iredmail-release", + "board-release", + "ec2_version", +) + + +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 + "buildroot" Buildroot + "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 + "guix" Guix System + "altlinux" ALT Linux + ============== ========================================= + + 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 "" 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 "" field of the distro release file, appended + with the value of the pretty version ("" and "" + 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 "" 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 + `_. + """ + 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 "" 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()) + 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 + # 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 InfoDict( + id=self.id(), + version=self.version(pretty, best), + version_parts=VersionDict( + 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() + + @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: + 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) + else: + try: + 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. + 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 = _DISTRO_RELEASE_BASENAMES + for basename in basenames: + match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename) + 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]: + """ + 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/env/lib/python3.12/site-packages/pip/_vendor/distro/py.typed b/env/lib/python3.12/site-packages/pip/_vendor/distro/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/pip/_vendor/idna/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/idna/__init__.py new file mode 100644 index 0000000..cfdc030 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/idna/__init__.py @@ -0,0 +1,45 @@ +from .core import ( + IDNABidiError, + IDNAError, + InvalidCodepoint, + InvalidCodepointContext, + alabel, + check_bidi, + check_hyphen_ok, + check_initial_combiner, + check_label, + check_nfc, + decode, + encode, + ulabel, + uts46_remap, + valid_contextj, + valid_contexto, + valid_label_length, + valid_string_length, +) +from .intranges import intranges_contain +from .package_data import __version__ + +__all__ = [ + "__version__", + "IDNABidiError", + "IDNAError", + "InvalidCodepoint", + "InvalidCodepointContext", + "alabel", + "check_bidi", + "check_hyphen_ok", + "check_initial_combiner", + "check_label", + "check_nfc", + "decode", + "encode", + "intranges_contain", + "ulabel", + "uts46_remap", + "valid_contextj", + "valid_contexto", + "valid_label_length", + "valid_string_length", +] diff --git a/env/lib/python3.12/site-packages/pip/_vendor/idna/codec.py b/env/lib/python3.12/site-packages/pip/_vendor/idna/codec.py new file mode 100644 index 0000000..913abfd --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/idna/codec.py @@ -0,0 +1,122 @@ +import codecs +import re +from typing import Any, Optional, Tuple + +from .core import IDNAError, alabel, decode, encode, ulabel + +_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)) + + 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)) + + if not data: + 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 not data: + return b"", 0 + + labels = _unicode_dots_re.split(data) + trailing_dot = b"" + if labels: + if not labels[-1]: + 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"." + + result = [] + size = 0 + for label in labels: + result.append(alabel(label)) + if size: + size += 1 + size += len(label) + + # Join with U+002E + 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 not data: + return ("", 0) + + if not isinstance(data, str): + data = str(data, "ascii") + + labels = _unicode_dots_re.split(data) + trailing_dot = "" + if labels: + if not labels[-1]: + trailing_dot = "." + del labels[-1] + elif not final: + # Keep potentially unfinished label until the next call + del labels[-1] + if labels: + trailing_dot = "." + + result = [] + size = 0 + for label in labels: + result.append(ulabel(label)) + if size: + size += 1 + size += len(label) + + result_str = ".".join(result) + trailing_dot + size += len(trailing_dot) + return (result_str, size) + + +class StreamWriter(Codec, codecs.StreamWriter): + pass + + +class StreamReader(Codec, codecs.StreamReader): + pass + + +def search_function(name: str) -> Optional[codecs.CodecInfo]: + if name != "idna2008": + return None + return codecs.CodecInfo( + name=name, + encode=Codec().encode, + decode=Codec().decode, + incrementalencoder=IncrementalEncoder, + incrementaldecoder=IncrementalDecoder, + streamwriter=StreamWriter, + streamreader=StreamReader, + ) + + +codecs.register(search_function) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/idna/compat.py b/env/lib/python3.12/site-packages/pip/_vendor/idna/compat.py new file mode 100644 index 0000000..1df9f2a --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/idna/compat.py @@ -0,0 +1,15 @@ +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") diff --git a/env/lib/python3.12/site-packages/pip/_vendor/idna/core.py b/env/lib/python3.12/site-packages/pip/_vendor/idna/core.py new file mode 100644 index 0000000..9115f12 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/idna/core.py @@ -0,0 +1,437 @@ +import bisect +import re +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]") + + +class IDNAError(UnicodeError): + """Base exception for all IDNA-encoding related problems""" + + pass + + +class IDNABidiError(IDNAError): + """Exception when bidirectional requirements are not satisfied""" + + pass + + +class InvalidCodepoint(IDNAError): + """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""" + + pass + + +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") + 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") + + +def _unot(s: int) -> str: + return "U+{:04X}".format(s) + + +def valid_label_length(label: Union[bytes, str]) -> bool: + if len(label) > 63: + return False + return True + + +def valid_string_length(label: Union[bytes, str], trailing_dot: bool) -> bool: + if len(label) > (254 if trailing_dot else 253): + return False + return True + + +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): + direction = unicodedata.bidirectional(cp) + 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"]: + 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"]: + rtl = True + elif direction == "L": + rtl = False + else: + raise IDNABidiError("First codepoint in label {} must be directionality L, R or AL".format(repr(label))) + + valid_ending = False + number_type: Optional[str] = None + for idx, cp in enumerate(label, 1): + direction = unicodedata.bidirectional(cp) + + if rtl: + # Bidi rule 2 + 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"]: + valid_ending = True + elif direction != "NSM": + valid_ending = False + # Bidi rule 4 + 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") + else: + # Bidi rule 5 + 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"]: + valid_ending = True + elif direction != "NSM": + valid_ending = False + + if not valid_ending: + 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") + 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") + return True + + +def check_nfc(label: str) -> None: + 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 pos > 0: + if _combining_class(ord(label[pos - 1])) == _virama_combining_class: + return True + + ok = False + for i in range(pos - 1, -1, -1): + joining_type = idnadata.joining_types.get(ord(label[i])) + if joining_type == ord("T"): + continue + elif joining_type in [ord("L"), ord("D")]: + ok = True + break + else: + break + + if not ok: + return False + + ok = False + for i in range(pos + 1, len(label)): + joining_type = idnadata.joining_types.get(ord(label[i])) + if joining_type == ord("T"): + continue + elif joining_type in [ord("R"), ord("D")]: + ok = True + break + else: + break + return ok + + 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: + return True + return False + + elif cp_value == 0x0375: + 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: + if pos > 0: + return _is_script(label[pos - 1], "Hebrew") + return False + + elif cp_value == 0x30FB: + for cp in label: + if cp == "\u30fb": + continue + 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: + return False + return True + + elif 0x6F0 <= cp_value <= 0x6F9: + for cp in label: + if 0x660 <= ord(cp) <= 0x0669: + return False + return True + + return False + + +def check_label(label: Union[str, bytes, bytearray]) -> None: + if isinstance(label, (bytes, bytearray)): + label = label.decode("utf-8") + if len(label) == 0: + raise IDNAError("Empty Label") + + check_nfc(label) + check_hyphen_ok(label) + check_initial_combiner(label) + + for pos, cp in enumerate(label): + cp_value = ord(cp) + 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( + _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)) + ) + else: + 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") + ulabel(label_bytes) + if not valid_label_length(label_bytes): + raise IDNAError("Label too long") + return label_bytes + except UnicodeEncodeError: + pass + + check_label(label) + label_bytes = _alabel_prefix + _punycode(label) + + if not valid_label_length(label_bytes): + raise IDNAError("Label too long") + + return label_bytes + + +def ulabel(label: Union[str, bytes, bytearray]) -> str: + if not isinstance(label, (bytes, bytearray)): + try: + label_bytes = label.encode("ascii") + except UnicodeEncodeError: + check_label(label) + return label + else: + label_bytes = label + + label_bytes = label_bytes.lower() + if label_bytes.startswith(_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") + else: + check_label(label_bytes) + return label_bytes.decode("ascii") + + try: + label = label_bytes.decode("punycode") + except UnicodeError: + raise IDNAError("Invalid A-label") + check_label(label) + return label + + +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 = "" + + 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] + status = uts46row[1] + 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) + ): + output += char + 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": + raise IndexError() + except IndexError: + raise InvalidCodepoint( + "Codepoint {} not allowed at position {} in {}".format(_unot(code_point), pos + 1, repr(domain)) + ) + + 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: + if not isinstance(s, str): + try: + s = str(s, "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 + result = [] + if strict: + labels = s.split(".") + else: + labels = _unicode_dots_re.split(s) + if not labels or labels == [""]: + raise IDNAError("Empty domain") + if labels[-1] == "": + del labels[-1] + trailing_dot = True + for label in labels: + s = alabel(label) + if s: + result.append(s) + else: + raise IDNAError("Empty label") + if trailing_dot: + result.append(b"") + s = b".".join(result) + if not valid_string_length(s, trailing_dot): + 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: + try: + if not isinstance(s, str): + s = str(s, "ascii") + except UnicodeDecodeError: + raise IDNAError("Invalid ASCII in A-label") + if uts46: + s = uts46_remap(s, std3_rules, False) + trailing_dot = False + result = [] + if not strict: + labels = _unicode_dots_re.split(s) + else: + labels = s.split(".") + if not labels or labels == [""]: + raise IDNAError("Empty domain") + if not labels[-1]: + del labels[-1] + trailing_dot = True + for label in labels: + s = ulabel(label) + if s: + result.append(s) + else: + raise IDNAError("Empty label") + if trailing_dot: + result.append("") + return ".".join(result) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/idna/idnadata.py b/env/lib/python3.12/site-packages/pip/_vendor/idna/idnadata.py new file mode 100644 index 0000000..4be6004 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/idna/idnadata.py @@ -0,0 +1,4243 @@ +# This file is automatically generated by tools/idna-data + +__version__ = "15.1.0" +scripts = { + "Greek": ( + 0x37000000374, + 0x37500000378, + 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, + 0x212600002127, + 0xAB650000AB66, + 0x101400001018F, + 0x101A0000101A1, + 0x1D2000001D246, + ), + "Han": ( + 0x2E8000002E9A, + 0x2E9B00002EF4, + 0x2F0000002FD6, + 0x300500003006, + 0x300700003008, + 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, + ), + "Hiragana": ( + 0x304100003097, + 0x309D000030A0, + 0x1B0010001B120, + 0x1B1320001B133, + 0x1B1500001B153, + 0x1F2000001F201, + ), + "Katakana": ( + 0x30A1000030FB, + 0x30FD00003100, + 0x31F000003200, + 0x32D0000032FF, + 0x330000003358, + 0xFF660000FF70, + 0xFF710000FF9E, + 0x1AFF00001AFF4, + 0x1AFF50001AFFC, + 0x1AFFD0001AFFF, + 0x1B0000001B001, + 0x1B1200001B123, + 0x1B1550001B156, + 0x1B1640001B168, + ), +} +joining_types = { + 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, + 0x622: 82, + 0x623: 82, + 0x624: 82, + 0x625: 82, + 0x626: 68, + 0x627: 82, + 0x628: 68, + 0x629: 82, + 0x62A: 68, + 0x62B: 68, + 0x62C: 68, + 0x62D: 68, + 0x62E: 68, + 0x62F: 82, + 0x630: 82, + 0x631: 82, + 0x632: 82, + 0x633: 68, + 0x634: 68, + 0x635: 68, + 0x636: 68, + 0x637: 68, + 0x638: 68, + 0x639: 68, + 0x63A: 68, + 0x63B: 68, + 0x63C: 68, + 0x63D: 68, + 0x63E: 68, + 0x63F: 68, + 0x640: 67, + 0x641: 68, + 0x642: 68, + 0x643: 68, + 0x644: 68, + 0x645: 68, + 0x646: 68, + 0x647: 68, + 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, + 0x675: 82, + 0x676: 82, + 0x677: 82, + 0x678: 68, + 0x679: 68, + 0x67A: 68, + 0x67B: 68, + 0x67C: 68, + 0x67D: 68, + 0x67E: 68, + 0x67F: 68, + 0x680: 68, + 0x681: 68, + 0x682: 68, + 0x683: 68, + 0x684: 68, + 0x685: 68, + 0x686: 68, + 0x687: 68, + 0x688: 82, + 0x689: 82, + 0x68A: 82, + 0x68B: 82, + 0x68C: 82, + 0x68D: 82, + 0x68E: 82, + 0x68F: 82, + 0x690: 82, + 0x691: 82, + 0x692: 82, + 0x693: 82, + 0x694: 82, + 0x695: 82, + 0x696: 82, + 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, + 0x710: 82, + 0x711: 84, + 0x712: 68, + 0x713: 68, + 0x714: 68, + 0x715: 82, + 0x716: 82, + 0x717: 82, + 0x718: 82, + 0x719: 82, + 0x71A: 68, + 0x71B: 68, + 0x71C: 68, + 0x71D: 68, + 0x71E: 82, + 0x71F: 68, + 0x720: 68, + 0x721: 68, + 0x722: 68, + 0x723: 68, + 0x724: 68, + 0x725: 68, + 0x726: 68, + 0x727: 68, + 0x728: 82, + 0x729: 68, + 0x72A: 82, + 0x72B: 68, + 0x72C: 82, + 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, + 0x750: 68, + 0x751: 68, + 0x752: 68, + 0x753: 68, + 0x754: 68, + 0x755: 68, + 0x756: 68, + 0x757: 68, + 0x758: 68, + 0x759: 82, + 0x75A: 82, + 0x75B: 82, + 0x75C: 68, + 0x75D: 68, + 0x75E: 68, + 0x75F: 68, + 0x760: 68, + 0x761: 68, + 0x762: 68, + 0x763: 68, + 0x764: 68, + 0x765: 68, + 0x766: 68, + 0x767: 68, + 0x768: 68, + 0x769: 68, + 0x76A: 68, + 0x76B: 82, + 0x76C: 82, + 0x76D: 68, + 0x76E: 68, + 0x76F: 68, + 0x770: 68, + 0x771: 82, + 0x772: 68, + 0x773: 82, + 0x774: 82, + 0x775: 68, + 0x776: 68, + 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, + 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, + 0x843: 68, + 0x844: 68, + 0x845: 68, + 0x846: 82, + 0x847: 82, + 0x848: 68, + 0x849: 82, + 0x84A: 68, + 0x84B: 68, + 0x84C: 68, + 0x84D: 68, + 0x84E: 68, + 0x84F: 68, + 0x850: 68, + 0x851: 68, + 0x852: 68, + 0x853: 68, + 0x854: 82, + 0x855: 68, + 0x856: 82, + 0x857: 82, + 0x858: 82, + 0x859: 84, + 0x85A: 84, + 0x85B: 84, + 0x860: 68, + 0x862: 68, + 0x863: 68, + 0x864: 68, + 0x865: 68, + 0x867: 82, + 0x868: 68, + 0x869: 82, + 0x86A: 82, + 0x870: 82, + 0x871: 82, + 0x872: 82, + 0x873: 82, + 0x874: 82, + 0x875: 82, + 0x876: 82, + 0x877: 82, + 0x878: 82, + 0x879: 82, + 0x87A: 82, + 0x87B: 82, + 0x87C: 82, + 0x87D: 82, + 0x87E: 82, + 0x87F: 82, + 0x880: 82, + 0x881: 82, + 0x882: 82, + 0x883: 67, + 0x884: 67, + 0x885: 67, + 0x886: 68, + 0x889: 68, + 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, + 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, + 0x180B: 84, + 0x180C: 84, + 0x180D: 84, + 0x180F: 84, + 0x1820: 68, + 0x1821: 68, + 0x1822: 68, + 0x1823: 68, + 0x1824: 68, + 0x1825: 68, + 0x1826: 68, + 0x1827: 68, + 0x1828: 68, + 0x1829: 68, + 0x182A: 68, + 0x182B: 68, + 0x182C: 68, + 0x182D: 68, + 0x182E: 68, + 0x182F: 68, + 0x1830: 68, + 0x1831: 68, + 0x1832: 68, + 0x1833: 68, + 0x1834: 68, + 0x1835: 68, + 0x1836: 68, + 0x1837: 68, + 0x1838: 68, + 0x1839: 68, + 0x183A: 68, + 0x183B: 68, + 0x183C: 68, + 0x183D: 68, + 0x183E: 68, + 0x183F: 68, + 0x1840: 68, + 0x1841: 68, + 0x1842: 68, + 0x1843: 68, + 0x1844: 68, + 0x1845: 68, + 0x1846: 68, + 0x1847: 68, + 0x1848: 68, + 0x1849: 68, + 0x184A: 68, + 0x184B: 68, + 0x184C: 68, + 0x184D: 68, + 0x184E: 68, + 0x184F: 68, + 0x1850: 68, + 0x1851: 68, + 0x1852: 68, + 0x1853: 68, + 0x1854: 68, + 0x1855: 68, + 0x1856: 68, + 0x1857: 68, + 0x1858: 68, + 0x1859: 68, + 0x185A: 68, + 0x185B: 68, + 0x185C: 68, + 0x185D: 68, + 0x185E: 68, + 0x185F: 68, + 0x1860: 68, + 0x1861: 68, + 0x1862: 68, + 0x1863: 68, + 0x1864: 68, + 0x1865: 68, + 0x1866: 68, + 0x1867: 68, + 0x1868: 68, + 0x1869: 68, + 0x186A: 68, + 0x186B: 68, + 0x186C: 68, + 0x186D: 68, + 0x186E: 68, + 0x186F: 68, + 0x1870: 68, + 0x1871: 68, + 0x1872: 68, + 0x1873: 68, + 0x1874: 68, + 0x1875: 68, + 0x1876: 68, + 0x1877: 68, + 0x1878: 68, + 0x1885: 84, + 0x1886: 84, + 0x1887: 68, + 0x1888: 68, + 0x1889: 68, + 0x188A: 68, + 0x188B: 68, + 0x188C: 68, + 0x188D: 68, + 0x188E: 68, + 0x188F: 68, + 0x1890: 68, + 0x1891: 68, + 0x1892: 68, + 0x1893: 68, + 0x1894: 68, + 0x1895: 68, + 0x1896: 68, + 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, + 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, + 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, + 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, + 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, + 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, + 0x10100000102, + 0x10300000104, + 0x10500000106, + 0x10700000108, + 0x1090000010A, + 0x10B0000010C, + 0x10D0000010E, + 0x10F00000110, + 0x11100000112, + 0x11300000114, + 0x11500000116, + 0x11700000118, + 0x1190000011A, + 0x11B0000011C, + 0x11D0000011E, + 0x11F00000120, + 0x12100000122, + 0x12300000124, + 0x12500000126, + 0x12700000128, + 0x1290000012A, + 0x12B0000012C, + 0x12D0000012E, + 0x12F00000130, + 0x13100000132, + 0x13500000136, + 0x13700000139, + 0x13A0000013B, + 0x13C0000013D, + 0x13E0000013F, + 0x14200000143, + 0x14400000145, + 0x14600000147, + 0x14800000149, + 0x14B0000014C, + 0x14D0000014E, + 0x14F00000150, + 0x15100000152, + 0x15300000154, + 0x15500000156, + 0x15700000158, + 0x1590000015A, + 0x15B0000015C, + 0x15D0000015E, + 0x15F00000160, + 0x16100000162, + 0x16300000164, + 0x16500000166, + 0x16700000168, + 0x1690000016A, + 0x16B0000016C, + 0x16D0000016E, + 0x16F00000170, + 0x17100000172, + 0x17300000174, + 0x17500000176, + 0x17700000178, + 0x17A0000017B, + 0x17C0000017D, + 0x17E0000017F, + 0x18000000181, + 0x18300000184, + 0x18500000186, + 0x18800000189, + 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, + 0x20100000202, + 0x20300000204, + 0x20500000206, + 0x20700000208, + 0x2090000020A, + 0x20B0000020C, + 0x20D0000020E, + 0x20F00000210, + 0x21100000212, + 0x21300000214, + 0x21500000216, + 0x21700000218, + 0x2190000021A, + 0x21B0000021C, + 0x21D0000021E, + 0x21F00000220, + 0x22100000222, + 0x22300000224, + 0x22500000226, + 0x22700000228, + 0x2290000022A, + 0x22B0000022C, + 0x22D0000022E, + 0x22F00000230, + 0x23100000232, + 0x2330000023A, + 0x23C0000023D, + 0x23F00000241, + 0x24200000243, + 0x24700000248, + 0x2490000024A, + 0x24B0000024C, + 0x24D0000024E, + 0x24F000002B0, + 0x2B9000002C2, + 0x2C6000002D2, + 0x2EC000002ED, + 0x2EE000002EF, + 0x30000000340, + 0x34200000343, + 0x3460000034F, + 0x35000000370, + 0x37100000372, + 0x37300000374, + 0x37700000378, + 0x37B0000037E, + 0x39000000391, + 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, + 0x47100000472, + 0x47300000474, + 0x47500000476, + 0x47700000478, + 0x4790000047A, + 0x47B0000047C, + 0x47D0000047E, + 0x47F00000480, + 0x48100000482, + 0x48300000488, + 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, + 0x50100000502, + 0x50300000504, + 0x50500000506, + 0x50700000508, + 0x5090000050A, + 0x50B0000050C, + 0x50D0000050E, + 0x50F00000510, + 0x51100000512, + 0x51300000514, + 0x51500000516, + 0x51700000518, + 0x5190000051A, + 0x51B0000051C, + 0x51D0000051E, + 0x51F00000520, + 0x52100000522, + 0x52300000524, + 0x52500000526, + 0x52700000528, + 0x5290000052A, + 0x52B0000052C, + 0x52D0000052E, + 0x52F00000530, + 0x5590000055A, + 0x56000000587, + 0x58800000589, + 0x591000005BE, + 0x5BF000005C0, + 0x5C1000005C3, + 0x5C4000005C6, + 0x5C7000005C8, + 0x5D0000005EB, + 0x5EF000005F3, + 0x6100000061B, + 0x62000000640, + 0x64100000660, + 0x66E00000675, + 0x679000006D4, + 0x6D5000006DD, + 0x6DF000006E9, + 0x6EA000006F0, + 0x6FA00000700, + 0x7100000074B, + 0x74D000007B2, + 0x7C0000007F6, + 0x7FD000007FE, + 0x8000000082E, + 0x8400000085C, + 0x8600000086B, + 0x87000000888, + 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, + 0x120000001249, + 0x124A0000124E, + 0x125000001257, + 0x125800001259, + 0x125A0000125E, + 0x126000001289, + 0x128A0000128E, + 0x1290000012B1, + 0x12B2000012B6, + 0x12B8000012BF, + 0x12C0000012C1, + 0x12C2000012C6, + 0x12C8000012D7, + 0x12D800001311, + 0x131200001316, + 0x13180000135B, + 0x135D00001360, + 0x138000001390, + 0x13A0000013F6, + 0x14010000166D, + 0x166F00001680, + 0x16810000169B, + 0x16A0000016EB, + 0x16F1000016F9, + 0x170000001716, + 0x171F00001735, + 0x174000001754, + 0x17600000176D, + 0x176E00001771, + 0x177200001774, + 0x1780000017B4, + 0x17B6000017D4, + 0x17D7000017D8, + 0x17DC000017DE, + 0x17E0000017EA, + 0x18100000181A, + 0x182000001879, + 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, + 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, + 0x300500003008, + 0x302A0000302E, + 0x303C0000303D, + 0x304100003097, + 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, + 0x1030000010320, + 0x1032D00010341, + 0x103420001034A, + 0x103500001037B, + 0x103800001039E, + 0x103A0000103C4, + 0x103C8000103D0, + 0x104280001049E, + 0x104A0000104AA, + 0x104D8000104FC, + 0x1050000010528, + 0x1053000010564, + 0x10597000105A2, + 0x105A3000105B2, + 0x105B3000105BA, + 0x105BB000105BD, + 0x1060000010737, + 0x1074000010756, + 0x1076000010768, + 0x1078000010781, + 0x1080000010806, + 0x1080800010809, + 0x1080A00010836, + 0x1083700010839, + 0x1083C0001083D, + 0x1083F00010856, + 0x1086000010877, + 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, + 0x1100000011047, + 0x1106600011076, + 0x1107F000110BB, + 0x110C2000110C3, + 0x110D0000110E9, + 0x110F0000110FA, + 0x1110000011135, + 0x1113600011140, + 0x1114400011148, + 0x1115000011174, + 0x1117600011177, + 0x11180000111C5, + 0x111C9000111CD, + 0x111CE000111DB, + 0x111DC000111DD, + 0x1120000011212, + 0x1121300011238, + 0x1123E00011242, + 0x1128000011287, + 0x1128800011289, + 0x1128A0001128E, + 0x1128F0001129E, + 0x1129F000112A9, + 0x112B0000112EB, + 0x112F0000112FA, + 0x1130000011304, + 0x113050001130D, + 0x1130F00011311, + 0x1131300011329, + 0x1132A00011331, + 0x1133200011334, + 0x113350001133A, + 0x1133B00011345, + 0x1134700011349, + 0x1134B0001134E, + 0x1135000011351, + 0x1135700011358, + 0x1135D00011364, + 0x113660001136D, + 0x1137000011375, + 0x114000001144B, + 0x114500001145A, + 0x1145E00011462, + 0x11480000114C6, + 0x114C7000114C8, + 0x114D0000114DA, + 0x11580000115B6, + 0x115B8000115C1, + 0x115D8000115DE, + 0x1160000011641, + 0x1164400011645, + 0x116500001165A, + 0x11680000116B9, + 0x116C0000116CA, + 0x117000001171B, + 0x1171D0001172C, + 0x117300001173A, + 0x1174000011747, + 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, + 0x1248000012544, + 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, + ), + "CONTEXTJ": (0x200C0000200E,), + "CONTEXTO": ( + 0xB7000000B8, + 0x37500000376, + 0x5F3000005F5, + 0x6600000066A, + 0x6F0000006FA, + 0x30FB000030FC, + ), +} diff --git a/env/lib/python3.12/site-packages/pip/_vendor/idna/intranges.py b/env/lib/python3.12/site-packages/pip/_vendor/idna/intranges.py new file mode 100644 index 0000000..7bfaa8d --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/idna/intranges.py @@ -0,0 +1,57 @@ +""" +Given a list of integers, made up of (hopefully) a small number of long runs +of consecutive integers, compute a representation of the form +((start1, end1), (start2, end2) ...). Then answer the question "was x present +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 + integers are exactly those x such that start_i <= x < end_i for some i. + + Ranges are encoded as single integers (start << 32 | end), not as tuples. + """ + + sorted_list = sorted(list_) + 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: + continue + 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)) + + +def intranges_contain(int_: int, ranges: Tuple[int, ...]) -> bool: + """Determine if `int_` falls into one of the ranges in `ranges`.""" + tuple_ = _encode_range(int_, 0) + pos = bisect.bisect_left(ranges, tuple_) + # we could be immediately ahead of a tuple (start, end) + # with start < int_ <= end + if pos > 0: + left, right = _decode_range(ranges[pos - 1]) + if left <= int_ < right: + return True + # or we could be immediately behind a tuple (int_, end) + if pos < len(ranges): + left, _ = _decode_range(ranges[pos]) + if left == int_: + return True + return False diff --git a/env/lib/python3.12/site-packages/pip/_vendor/idna/package_data.py b/env/lib/python3.12/site-packages/pip/_vendor/idna/package_data.py new file mode 100644 index 0000000..514ff7e --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/idna/package_data.py @@ -0,0 +1 @@ +__version__ = "3.10" diff --git a/env/lib/python3.12/site-packages/pip/_vendor/idna/py.typed b/env/lib/python3.12/site-packages/pip/_vendor/idna/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/pip/_vendor/idna/uts46data.py b/env/lib/python3.12/site-packages/pip/_vendor/idna/uts46data.py new file mode 100644 index 0000000..eb89432 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/idna/uts46data.py @@ -0,0 +1,8681 @@ +# This file is automatically generated by tools/idna-data +# vim: set fileencoding=utf-8 : + +from typing import List, Tuple, Union + +"""IDNA Mapping Table from UTS46.""" + + +__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"), + ] + + +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", "ç"), + ] + + +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"), + ] + + +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", "ɠ"), + ] + + +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", "ȍ"), + ] + + +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"), + ] + + +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", "ђ"), + ] + + +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"), + ] + + +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", "ԃ"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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", "в"), + ] + + +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", "ɔ"), + ] + + +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"), + ] + + +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"), + ] + + +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", "ự"), + ] + + +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", "ἇι"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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", "ⱜ"), + ] + + +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", "ⳇ"), + ] + + +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", "卩"), + ] + + +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", "而"), + ] + + +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"), + ] + + +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", "ᆅ"), + ] + + +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"), + ] + + +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"), + ] + + +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", "グラムトン"), + ] + + +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", "大正"), + ] + + +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日"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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", "Ꮮ"), + ] + + +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", "雷"), + ] + + +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", "玲"), + ] + + +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", "晴"), + ] + + +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", "塚"), + ] + + +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"), + ] + + +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", "ى"), + ] + + +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", "يي"), + ] + + +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", "فج"), + ] + + +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", "صي"), + ] + + +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", "شحي"), + ] + + +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", "*"), + ] + + +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", ">"), + ] + + +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", "ツ"), + ] + + +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", "■"), + ] + + +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", "𐓡"), + ] + + +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", "ɗ"), + ] + + +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"), + ] + + +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"), + ] + + +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", "𑣊"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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"), + ] + + +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", "η"), + ] + + +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", "ω"), + ] + + +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", "κ"), + ] + + +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", "ж"), + ] + + +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", "𞤯"), + ] + + +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", "س"), + ] + + +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", "ذ"), + ] + + +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"), + ] + + +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"), + ] + + +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", "咢"), + ] + + +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", "慎"), + ] + + +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", "滇"), + ] + + +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", "𦉇"), + ] + + +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", "起"), + ] + + +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"), + ] + + +uts46data = tuple( + _seg_0() + + _seg_1() + + _seg_2() + + _seg_3() + + _seg_4() + + _seg_5() + + _seg_6() + + _seg_7() + + _seg_8() + + _seg_9() + + _seg_10() + + _seg_11() + + _seg_12() + + _seg_13() + + _seg_14() + + _seg_15() + + _seg_16() + + _seg_17() + + _seg_18() + + _seg_19() + + _seg_20() + + _seg_21() + + _seg_22() + + _seg_23() + + _seg_24() + + _seg_25() + + _seg_26() + + _seg_27() + + _seg_28() + + _seg_29() + + _seg_30() + + _seg_31() + + _seg_32() + + _seg_33() + + _seg_34() + + _seg_35() + + _seg_36() + + _seg_37() + + _seg_38() + + _seg_39() + + _seg_40() + + _seg_41() + + _seg_42() + + _seg_43() + + _seg_44() + + _seg_45() + + _seg_46() + + _seg_47() + + _seg_48() + + _seg_49() + + _seg_50() + + _seg_51() + + _seg_52() + + _seg_53() + + _seg_54() + + _seg_55() + + _seg_56() + + _seg_57() + + _seg_58() + + _seg_59() + + _seg_60() + + _seg_61() + + _seg_62() + + _seg_63() + + _seg_64() + + _seg_65() + + _seg_66() + + _seg_67() + + _seg_68() + + _seg_69() + + _seg_70() + + _seg_71() + + _seg_72() + + _seg_73() + + _seg_74() + + _seg_75() + + _seg_76() + + _seg_77() + + _seg_78() + + _seg_79() + + _seg_80() + + _seg_81() +) # type: Tuple[Union[Tuple[int, str], Tuple[int, str, str]], ...] diff --git a/env/lib/python3.12/site-packages/pip/_vendor/msgpack/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/msgpack/__init__.py new file mode 100644 index 0000000..b615105 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/msgpack/__init__.py @@ -0,0 +1,55 @@ +# ruff: noqa: F401 +import os + +from .exceptions import * # noqa: F403 +from .ext import ExtType, Timestamp + +version = (1, 1, 0) +__version__ = "1.1.0" + + +if os.environ.get("MSGPACK_PUREPYTHON"): + from .fallback import Packer, Unpacker, unpackb +else: + try: + from ._cmsgpack import Packer, Unpacker, unpackb + except ImportError: + from .fallback import Packer, Unpacker, unpackb + + +def pack(o, stream, **kwargs): + """ + Pack object `o` and write it to `stream` + + See :class:`Packer` for options. + """ + packer = Packer(**kwargs) + stream.write(packer.pack(o)) + + +def packb(o, **kwargs): + """ + Pack object `o` and return packed bytes + + See :class:`Packer` for options. + """ + return Packer(**kwargs).pack(o) + + +def unpack(stream, **kwargs): + """ + Unpack an object from `stream`. + + Raises `ExtraData` when `stream` contains extra bytes. + See :class:`Unpacker` for options. + """ + data = stream.read() + return unpackb(data, **kwargs) + + +# alias for compatibility to simplejson/marshal/pickle. +load = unpack +loads = unpackb + +dump = pack +dumps = packb diff --git a/env/lib/python3.12/site-packages/pip/_vendor/msgpack/exceptions.py b/env/lib/python3.12/site-packages/pip/_vendor/msgpack/exceptions.py new file mode 100644 index 0000000..d6d2615 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/msgpack/exceptions.py @@ -0,0 +1,48 @@ +class UnpackException(Exception): + """Base class for some exceptions raised while unpacking. + + NOTE: unpack may raise exception other than subclass of + UnpackException. If you want to catch all error, catch + Exception instead. + """ + + +class BufferFull(UnpackException): + pass + + +class OutOfData(UnpackException): + pass + + +class FormatError(ValueError, UnpackException): + """Invalid msgpack format""" + + +class StackError(ValueError, UnpackException): + """Too nested""" + + +# Deprecated. Use ValueError instead +UnpackValueError = ValueError + + +class ExtraData(UnpackValueError): + """ExtraData is raised when there is trailing data. + + This exception is raised while only one-shot (not streaming) + unpack. + """ + + def __init__(self, unpacked, extra): + self.unpacked = unpacked + self.extra = extra + + def __str__(self): + return "unpack(b) received extra data." + + +# Deprecated. Use Exception instead to catch all exception during packing. +PackException = Exception +PackValueError = ValueError +PackOverflowError = OverflowError diff --git a/env/lib/python3.12/site-packages/pip/_vendor/msgpack/ext.py b/env/lib/python3.12/site-packages/pip/_vendor/msgpack/ext.py new file mode 100644 index 0000000..9694819 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/msgpack/ext.py @@ -0,0 +1,170 @@ +import datetime +import struct +from collections import namedtuple + + +class ExtType(namedtuple("ExtType", "code data")): + """ExtType represents ext type in msgpack.""" + + def __new__(cls, code, data): + if not isinstance(code, int): + raise TypeError("code must be int") + if not isinstance(data, bytes): + raise TypeError("data must be bytes") + if not 0 <= code <= 127: + raise ValueError("code must be 0~127") + return super().__new__(cls, code, data) + + +class Timestamp: + """Timestamp represents the Timestamp extension type in msgpack. + + When built with Cython, msgpack uses C methods to pack and unpack `Timestamp`. + When using pure-Python msgpack, :func:`to_bytes` and :func:`from_bytes` are used to pack and + unpack `Timestamp`. + + This class is immutable: Do not override seconds and nanoseconds. + """ + + __slots__ = ["seconds", "nanoseconds"] + + def __init__(self, seconds, nanoseconds=0): + """Initialize a Timestamp object. + + :param int seconds: + Number of seconds since the UNIX epoch (00:00:00 UTC Jan 1 1970, minus leap seconds). + May be negative. + + :param int nanoseconds: + Number of nanoseconds to add to `seconds` to get fractional time. + Maximum is 999_999_999. Default is 0. + + Note: Negative times (before the UNIX epoch) are represented as neg. seconds + pos. ns. + """ + if not isinstance(seconds, int): + raise TypeError("seconds must be an integer") + if not isinstance(nanoseconds, int): + raise TypeError("nanoseconds must be an integer") + if not (0 <= nanoseconds < 10**9): + raise ValueError("nanoseconds must be a non-negative integer less than 999999999.") + self.seconds = seconds + self.nanoseconds = nanoseconds + + def __repr__(self): + """String representation of Timestamp.""" + return f"Timestamp(seconds={self.seconds}, nanoseconds={self.nanoseconds})" + + def __eq__(self, other): + """Check for equality with another Timestamp object""" + if type(other) is self.__class__: + return self.seconds == other.seconds and self.nanoseconds == other.nanoseconds + return False + + def __ne__(self, other): + """not-equals method (see :func:`__eq__()`)""" + return not self.__eq__(other) + + def __hash__(self): + return hash((self.seconds, self.nanoseconds)) + + @staticmethod + def from_bytes(b): + """Unpack bytes into a `Timestamp` object. + + Used for pure-Python msgpack unpacking. + + :param b: Payload from msgpack ext message with code -1 + :type b: bytes + + :returns: Timestamp object unpacked from msgpack ext payload + :rtype: Timestamp + """ + if len(b) == 4: + seconds = struct.unpack("!L", b)[0] + nanoseconds = 0 + elif len(b) == 8: + data64 = struct.unpack("!Q", b)[0] + seconds = data64 & 0x00000003FFFFFFFF + nanoseconds = data64 >> 34 + elif len(b) == 12: + nanoseconds, seconds = struct.unpack("!Iq", b) + else: + raise ValueError( + "Timestamp type can only be created from 32, 64, or 96-bit byte objects" + ) + return Timestamp(seconds, nanoseconds) + + def to_bytes(self): + """Pack this Timestamp object into bytes. + + Used for pure-Python msgpack packing. + + :returns data: Payload for EXT message with code -1 (timestamp type) + :rtype: bytes + """ + if (self.seconds >> 34) == 0: # seconds is non-negative and fits in 34 bits + data64 = self.nanoseconds << 34 | self.seconds + if data64 & 0xFFFFFFFF00000000 == 0: + # nanoseconds is zero and seconds < 2**32, so timestamp 32 + data = struct.pack("!L", data64) + else: + # timestamp 64 + data = struct.pack("!Q", data64) + else: + # timestamp 96 + data = struct.pack("!Iq", self.nanoseconds, self.seconds) + return data + + @staticmethod + def from_unix(unix_sec): + """Create a Timestamp from posix timestamp in seconds. + + :param unix_float: Posix timestamp in seconds. + :type unix_float: int or float + """ + seconds = int(unix_sec // 1) + nanoseconds = int((unix_sec % 1) * 10**9) + return Timestamp(seconds, nanoseconds) + + def to_unix(self): + """Get the timestamp as a floating-point value. + + :returns: posix timestamp + :rtype: float + """ + return self.seconds + self.nanoseconds / 1e9 + + @staticmethod + def from_unix_nano(unix_ns): + """Create a Timestamp from posix timestamp in nanoseconds. + + :param int unix_ns: Posix timestamp in nanoseconds. + :rtype: Timestamp + """ + return Timestamp(*divmod(unix_ns, 10**9)) + + def to_unix_nano(self): + """Get the timestamp as a unixtime in nanoseconds. + + :returns: posix timestamp in nanoseconds + :rtype: int + """ + return self.seconds * 10**9 + self.nanoseconds + + def to_datetime(self): + """Get the timestamp as a UTC datetime. + + :rtype: `datetime.datetime` + """ + utc = datetime.timezone.utc + return datetime.datetime.fromtimestamp(0, utc) + datetime.timedelta( + seconds=self.seconds, microseconds=self.nanoseconds // 1000 + ) + + @staticmethod + def from_datetime(dt): + """Create a Timestamp from datetime with tzinfo. + + :rtype: Timestamp + """ + return Timestamp(seconds=int(dt.timestamp()), nanoseconds=dt.microsecond * 1000) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/msgpack/fallback.py b/env/lib/python3.12/site-packages/pip/_vendor/msgpack/fallback.py new file mode 100644 index 0000000..b02e47c --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/msgpack/fallback.py @@ -0,0 +1,929 @@ +"""Fallback pure Python implementation of msgpack""" + +import struct +import sys +from datetime import datetime as _DateTime + +if hasattr(sys, "pypy_version_info"): + from __pypy__ import newlist_hint + from __pypy__.builders import BytesBuilder + + _USING_STRINGBUILDER = True + + class BytesIO: + def __init__(self, s=b""): + if s: + self.builder = BytesBuilder(len(s)) + self.builder.append(s) + else: + self.builder = BytesBuilder() + + def write(self, s): + if isinstance(s, memoryview): + s = s.tobytes() + elif isinstance(s, bytearray): + s = bytes(s) + self.builder.append(s) + + def getvalue(self): + return self.builder.build() + +else: + from io import BytesIO + + _USING_STRINGBUILDER = False + + def newlist_hint(size): + return [] + + +from .exceptions import BufferFull, ExtraData, FormatError, OutOfData, StackError +from .ext import ExtType, Timestamp + +EX_SKIP = 0 +EX_CONSTRUCT = 1 +EX_READ_ARRAY_HEADER = 2 +EX_READ_MAP_HEADER = 3 + +TYPE_IMMEDIATE = 0 +TYPE_ARRAY = 1 +TYPE_MAP = 2 +TYPE_RAW = 3 +TYPE_BIN = 4 +TYPE_EXT = 5 + +DEFAULT_RECURSE_LIMIT = 511 + + +def _check_type_strict(obj, t, type=type, tuple=tuple): + if type(t) is tuple: + return type(obj) in t + else: + return type(obj) is t + + +def _get_data_from_buffer(obj): + view = memoryview(obj) + if view.itemsize != 1: + raise ValueError("cannot unpack from multi-byte object") + return view + + +def unpackb(packed, **kwargs): + """ + Unpack an object from `packed`. + + Raises ``ExtraData`` when *packed* contains extra bytes. + Raises ``ValueError`` when *packed* is incomplete. + Raises ``FormatError`` when *packed* is not valid msgpack. + Raises ``StackError`` when *packed* contains too nested. + Other exceptions can be raised during unpacking. + + See :class:`Unpacker` for options. + """ + unpacker = Unpacker(None, max_buffer_size=len(packed), **kwargs) + unpacker.feed(packed) + try: + ret = unpacker._unpack() + except OutOfData: + raise ValueError("Unpack failed: incomplete input") + except RecursionError: + raise StackError + if unpacker._got_extradata(): + raise ExtraData(ret, unpacker._get_extradata()) + return ret + + +_NO_FORMAT_USED = "" +_MSGPACK_HEADERS = { + 0xC4: (1, _NO_FORMAT_USED, TYPE_BIN), + 0xC5: (2, ">H", TYPE_BIN), + 0xC6: (4, ">I", TYPE_BIN), + 0xC7: (2, "Bb", TYPE_EXT), + 0xC8: (3, ">Hb", TYPE_EXT), + 0xC9: (5, ">Ib", TYPE_EXT), + 0xCA: (4, ">f"), + 0xCB: (8, ">d"), + 0xCC: (1, _NO_FORMAT_USED), + 0xCD: (2, ">H"), + 0xCE: (4, ">I"), + 0xCF: (8, ">Q"), + 0xD0: (1, "b"), + 0xD1: (2, ">h"), + 0xD2: (4, ">i"), + 0xD3: (8, ">q"), + 0xD4: (1, "b1s", TYPE_EXT), + 0xD5: (2, "b2s", TYPE_EXT), + 0xD6: (4, "b4s", TYPE_EXT), + 0xD7: (8, "b8s", TYPE_EXT), + 0xD8: (16, "b16s", TYPE_EXT), + 0xD9: (1, _NO_FORMAT_USED, TYPE_RAW), + 0xDA: (2, ">H", TYPE_RAW), + 0xDB: (4, ">I", TYPE_RAW), + 0xDC: (2, ">H", TYPE_ARRAY), + 0xDD: (4, ">I", TYPE_ARRAY), + 0xDE: (2, ">H", TYPE_MAP), + 0xDF: (4, ">I", TYPE_MAP), +} + + +class Unpacker: + """Streaming unpacker. + + Arguments: + + :param file_like: + File-like object having `.read(n)` method. + If specified, unpacker reads serialized data from it and `.feed()` is not usable. + + :param int read_size: + Used as `file_like.read(read_size)`. (default: `min(16*1024, max_buffer_size)`) + + :param bool use_list: + If true, unpack msgpack array to Python list. + Otherwise, unpack to Python tuple. (default: True) + + :param bool raw: + If true, unpack msgpack raw to Python bytes. + Otherwise, unpack to Python str by decoding with UTF-8 encoding (default). + + :param int timestamp: + Control how timestamp type is unpacked: + + 0 - Timestamp + 1 - float (Seconds from the EPOCH) + 2 - int (Nanoseconds from the EPOCH) + 3 - datetime.datetime (UTC). + + :param bool strict_map_key: + If true (default), only str or bytes are accepted for map (dict) keys. + + :param object_hook: + When specified, it should be callable. + Unpacker calls it with a dict argument after unpacking msgpack map. + (See also simplejson) + + :param object_pairs_hook: + When specified, it should be callable. + Unpacker calls it with a list of key-value pairs after unpacking msgpack map. + (See also simplejson) + + :param str unicode_errors: + The error handler for decoding unicode. (default: 'strict') + This option should be used only when you have msgpack data which + contains invalid UTF-8 string. + + :param int max_buffer_size: + Limits size of data waiting unpacked. 0 means 2**32-1. + The default value is 100*1024*1024 (100MiB). + Raises `BufferFull` exception when it is insufficient. + You should set this parameter when unpacking data from untrusted source. + + :param int max_str_len: + Deprecated, use *max_buffer_size* instead. + Limits max length of str. (default: max_buffer_size) + + :param int max_bin_len: + Deprecated, use *max_buffer_size* instead. + Limits max length of bin. (default: max_buffer_size) + + :param int max_array_len: + Limits max length of array. + (default: max_buffer_size) + + :param int max_map_len: + Limits max length of map. + (default: max_buffer_size//2) + + :param int max_ext_len: + Deprecated, use *max_buffer_size* instead. + Limits max size of ext type. (default: max_buffer_size) + + Example of streaming deserialize from file-like object:: + + unpacker = Unpacker(file_like) + for o in unpacker: + process(o) + + Example of streaming deserialize from socket:: + + unpacker = Unpacker() + while True: + buf = sock.recv(1024**2) + if not buf: + break + unpacker.feed(buf) + for o in unpacker: + process(o) + + Raises ``ExtraData`` when *packed* contains extra bytes. + Raises ``OutOfData`` when *packed* is incomplete. + Raises ``FormatError`` when *packed* is not valid msgpack. + Raises ``StackError`` when *packed* contains too nested. + Other exceptions can be raised during unpacking. + """ + + def __init__( + self, + file_like=None, + *, + read_size=0, + use_list=True, + raw=False, + timestamp=0, + strict_map_key=True, + object_hook=None, + object_pairs_hook=None, + list_hook=None, + unicode_errors=None, + max_buffer_size=100 * 1024 * 1024, + ext_hook=ExtType, + max_str_len=-1, + max_bin_len=-1, + max_array_len=-1, + max_map_len=-1, + max_ext_len=-1, + ): + if unicode_errors is None: + unicode_errors = "strict" + + if file_like is None: + self._feeding = True + else: + if not callable(file_like.read): + raise TypeError("`file_like.read` must be callable") + self.file_like = file_like + self._feeding = False + + #: array of bytes fed. + self._buffer = bytearray() + #: Which position we currently reads + self._buff_i = 0 + + # When Unpacker is used as an iterable, between the calls to next(), + # the buffer is not "consumed" completely, for efficiency sake. + # Instead, it is done sloppily. To make sure we raise BufferFull at + # the correct moments, we have to keep track of how sloppy we were. + # Furthermore, when the buffer is incomplete (that is: in the case + # we raise an OutOfData) we need to rollback the buffer to the correct + # state, which _buf_checkpoint records. + self._buf_checkpoint = 0 + + if not max_buffer_size: + max_buffer_size = 2**31 - 1 + if max_str_len == -1: + max_str_len = max_buffer_size + if max_bin_len == -1: + max_bin_len = max_buffer_size + if max_array_len == -1: + max_array_len = max_buffer_size + if max_map_len == -1: + max_map_len = max_buffer_size // 2 + if max_ext_len == -1: + max_ext_len = max_buffer_size + + self._max_buffer_size = max_buffer_size + if read_size > self._max_buffer_size: + raise ValueError("read_size must be smaller than max_buffer_size") + self._read_size = read_size or min(self._max_buffer_size, 16 * 1024) + self._raw = bool(raw) + self._strict_map_key = bool(strict_map_key) + self._unicode_errors = unicode_errors + self._use_list = use_list + if not (0 <= timestamp <= 3): + raise ValueError("timestamp must be 0..3") + self._timestamp = timestamp + self._list_hook = list_hook + self._object_hook = object_hook + self._object_pairs_hook = object_pairs_hook + self._ext_hook = ext_hook + self._max_str_len = max_str_len + self._max_bin_len = max_bin_len + self._max_array_len = max_array_len + self._max_map_len = max_map_len + self._max_ext_len = max_ext_len + self._stream_offset = 0 + + if list_hook is not None and not callable(list_hook): + raise TypeError("`list_hook` is not callable") + if object_hook is not None and not callable(object_hook): + raise TypeError("`object_hook` is not callable") + if object_pairs_hook is not None and not callable(object_pairs_hook): + raise TypeError("`object_pairs_hook` is not callable") + if object_hook is not None and object_pairs_hook is not None: + raise TypeError("object_pairs_hook and object_hook are mutually exclusive") + if not callable(ext_hook): + raise TypeError("`ext_hook` is not callable") + + def feed(self, next_bytes): + assert self._feeding + view = _get_data_from_buffer(next_bytes) + if len(self._buffer) - self._buff_i + len(view) > self._max_buffer_size: + raise BufferFull + + # Strip buffer before checkpoint before reading file. + if self._buf_checkpoint > 0: + del self._buffer[: self._buf_checkpoint] + self._buff_i -= self._buf_checkpoint + self._buf_checkpoint = 0 + + # Use extend here: INPLACE_ADD += doesn't reliably typecast memoryview in jython + self._buffer.extend(view) + view.release() + + def _consume(self): + """Gets rid of the used parts of the buffer.""" + self._stream_offset += self._buff_i - self._buf_checkpoint + self._buf_checkpoint = self._buff_i + + def _got_extradata(self): + return self._buff_i < len(self._buffer) + + def _get_extradata(self): + return self._buffer[self._buff_i :] + + def read_bytes(self, n): + ret = self._read(n, raise_outofdata=False) + self._consume() + return ret + + def _read(self, n, raise_outofdata=True): + # (int) -> bytearray + self._reserve(n, raise_outofdata=raise_outofdata) + i = self._buff_i + ret = self._buffer[i : i + n] + self._buff_i = i + len(ret) + return ret + + def _reserve(self, n, raise_outofdata=True): + remain_bytes = len(self._buffer) - self._buff_i - n + + # Fast path: buffer has n bytes already + if remain_bytes >= 0: + return + + if self._feeding: + self._buff_i = self._buf_checkpoint + raise OutOfData + + # Strip buffer before checkpoint before reading file. + if self._buf_checkpoint > 0: + del self._buffer[: self._buf_checkpoint] + self._buff_i -= self._buf_checkpoint + self._buf_checkpoint = 0 + + # Read from file + remain_bytes = -remain_bytes + if remain_bytes + len(self._buffer) > self._max_buffer_size: + raise BufferFull + while remain_bytes > 0: + to_read_bytes = max(self._read_size, remain_bytes) + read_data = self.file_like.read(to_read_bytes) + if not read_data: + break + assert isinstance(read_data, bytes) + self._buffer += read_data + remain_bytes -= len(read_data) + + if len(self._buffer) < n + self._buff_i and raise_outofdata: + self._buff_i = 0 # rollback + raise OutOfData + + def _read_header(self): + typ = TYPE_IMMEDIATE + n = 0 + obj = None + self._reserve(1) + b = self._buffer[self._buff_i] + self._buff_i += 1 + if b & 0b10000000 == 0: + obj = b + elif b & 0b11100000 == 0b11100000: + obj = -1 - (b ^ 0xFF) + elif b & 0b11100000 == 0b10100000: + n = b & 0b00011111 + typ = TYPE_RAW + if n > self._max_str_len: + raise ValueError(f"{n} exceeds max_str_len({self._max_str_len})") + obj = self._read(n) + elif b & 0b11110000 == 0b10010000: + n = b & 0b00001111 + typ = TYPE_ARRAY + if n > self._max_array_len: + raise ValueError(f"{n} exceeds max_array_len({self._max_array_len})") + elif b & 0b11110000 == 0b10000000: + n = b & 0b00001111 + typ = TYPE_MAP + if n > self._max_map_len: + raise ValueError(f"{n} exceeds max_map_len({self._max_map_len})") + elif b == 0xC0: + obj = None + elif b == 0xC2: + obj = False + elif b == 0xC3: + obj = True + elif 0xC4 <= b <= 0xC6: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + if len(fmt) > 0: + n = struct.unpack_from(fmt, self._buffer, self._buff_i)[0] + else: + n = self._buffer[self._buff_i] + self._buff_i += size + if n > self._max_bin_len: + raise ValueError(f"{n} exceeds max_bin_len({self._max_bin_len})") + obj = self._read(n) + elif 0xC7 <= b <= 0xC9: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + L, n = struct.unpack_from(fmt, self._buffer, self._buff_i) + self._buff_i += size + if L > self._max_ext_len: + raise ValueError(f"{L} exceeds max_ext_len({self._max_ext_len})") + obj = self._read(L) + elif 0xCA <= b <= 0xD3: + size, fmt = _MSGPACK_HEADERS[b] + self._reserve(size) + if len(fmt) > 0: + obj = struct.unpack_from(fmt, self._buffer, self._buff_i)[0] + else: + obj = self._buffer[self._buff_i] + self._buff_i += size + elif 0xD4 <= b <= 0xD8: + size, fmt, typ = _MSGPACK_HEADERS[b] + if self._max_ext_len < size: + raise ValueError(f"{size} exceeds max_ext_len({self._max_ext_len})") + self._reserve(size + 1) + n, obj = struct.unpack_from(fmt, self._buffer, self._buff_i) + self._buff_i += size + 1 + elif 0xD9 <= b <= 0xDB: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + if len(fmt) > 0: + (n,) = struct.unpack_from(fmt, self._buffer, self._buff_i) + else: + n = self._buffer[self._buff_i] + self._buff_i += size + if n > self._max_str_len: + raise ValueError(f"{n} exceeds max_str_len({self._max_str_len})") + obj = self._read(n) + elif 0xDC <= b <= 0xDD: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + (n,) = struct.unpack_from(fmt, self._buffer, self._buff_i) + self._buff_i += size + if n > self._max_array_len: + raise ValueError(f"{n} exceeds max_array_len({self._max_array_len})") + elif 0xDE <= b <= 0xDF: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + (n,) = struct.unpack_from(fmt, self._buffer, self._buff_i) + self._buff_i += size + if n > self._max_map_len: + raise ValueError(f"{n} exceeds max_map_len({self._max_map_len})") + else: + raise FormatError("Unknown header: 0x%x" % b) + return typ, n, obj + + def _unpack(self, execute=EX_CONSTRUCT): + typ, n, obj = self._read_header() + + if execute == EX_READ_ARRAY_HEADER: + if typ != TYPE_ARRAY: + raise ValueError("Expected array") + return n + if execute == EX_READ_MAP_HEADER: + if typ != TYPE_MAP: + raise ValueError("Expected map") + return n + # TODO should we eliminate the recursion? + if typ == TYPE_ARRAY: + if execute == EX_SKIP: + for i in range(n): + # TODO check whether we need to call `list_hook` + self._unpack(EX_SKIP) + return + ret = newlist_hint(n) + for i in range(n): + ret.append(self._unpack(EX_CONSTRUCT)) + if self._list_hook is not None: + ret = self._list_hook(ret) + # TODO is the interaction between `list_hook` and `use_list` ok? + return ret if self._use_list else tuple(ret) + if typ == TYPE_MAP: + if execute == EX_SKIP: + for i in range(n): + # TODO check whether we need to call hooks + self._unpack(EX_SKIP) + self._unpack(EX_SKIP) + return + if self._object_pairs_hook is not None: + ret = self._object_pairs_hook( + (self._unpack(EX_CONSTRUCT), self._unpack(EX_CONSTRUCT)) for _ in range(n) + ) + else: + ret = {} + for _ in range(n): + key = self._unpack(EX_CONSTRUCT) + if self._strict_map_key and type(key) not in (str, bytes): + raise ValueError("%s is not allowed for map key" % str(type(key))) + if isinstance(key, str): + key = sys.intern(key) + ret[key] = self._unpack(EX_CONSTRUCT) + if self._object_hook is not None: + ret = self._object_hook(ret) + return ret + if execute == EX_SKIP: + return + if typ == TYPE_RAW: + if self._raw: + obj = bytes(obj) + else: + obj = obj.decode("utf_8", self._unicode_errors) + return obj + if typ == TYPE_BIN: + return bytes(obj) + if typ == TYPE_EXT: + if n == -1: # timestamp + ts = Timestamp.from_bytes(bytes(obj)) + if self._timestamp == 1: + return ts.to_unix() + elif self._timestamp == 2: + return ts.to_unix_nano() + elif self._timestamp == 3: + return ts.to_datetime() + else: + return ts + else: + return self._ext_hook(n, bytes(obj)) + assert typ == TYPE_IMMEDIATE + return obj + + def __iter__(self): + return self + + def __next__(self): + try: + ret = self._unpack(EX_CONSTRUCT) + self._consume() + return ret + except OutOfData: + self._consume() + raise StopIteration + except RecursionError: + raise StackError + + next = __next__ + + def skip(self): + self._unpack(EX_SKIP) + self._consume() + + def unpack(self): + try: + ret = self._unpack(EX_CONSTRUCT) + except RecursionError: + raise StackError + self._consume() + return ret + + def read_array_header(self): + ret = self._unpack(EX_READ_ARRAY_HEADER) + self._consume() + return ret + + def read_map_header(self): + ret = self._unpack(EX_READ_MAP_HEADER) + self._consume() + return ret + + def tell(self): + return self._stream_offset + + +class Packer: + """ + MessagePack Packer + + Usage:: + + packer = Packer() + astream.write(packer.pack(a)) + astream.write(packer.pack(b)) + + Packer's constructor has some keyword arguments: + + :param default: + When specified, it should be callable. + Convert user type to builtin type that Packer supports. + See also simplejson's document. + + :param bool use_single_float: + Use single precision float type for float. (default: False) + + :param bool autoreset: + Reset buffer after each pack and return its content as `bytes`. (default: True). + If set this to false, use `bytes()` to get content and `.reset()` to clear buffer. + + :param bool use_bin_type: + Use bin type introduced in msgpack spec 2.0 for bytes. + It also enables str8 type for unicode. (default: True) + + :param bool strict_types: + If set to true, types will be checked to be exact. Derived classes + from serializable types will not be serialized and will be + treated as unsupported type and forwarded to default. + Additionally tuples will not be serialized as lists. + This is useful when trying to implement accurate serialization + for python types. + + :param bool datetime: + If set to true, datetime with tzinfo is packed into Timestamp type. + Note that the tzinfo is stripped in the timestamp. + You can get UTC datetime with `timestamp=3` option of the Unpacker. + + :param str unicode_errors: + The error handler for encoding unicode. (default: 'strict') + DO NOT USE THIS!! This option is kept for very specific usage. + + :param int buf_size: + Internal buffer size. This option is used only for C implementation. + """ + + def __init__( + self, + *, + default=None, + use_single_float=False, + autoreset=True, + use_bin_type=True, + strict_types=False, + datetime=False, + unicode_errors=None, + buf_size=None, + ): + self._strict_types = strict_types + self._use_float = use_single_float + self._autoreset = autoreset + self._use_bin_type = use_bin_type + self._buffer = BytesIO() + self._datetime = bool(datetime) + self._unicode_errors = unicode_errors or "strict" + if default is not None and not callable(default): + raise TypeError("default must be callable") + self._default = default + + def _pack( + self, + obj, + nest_limit=DEFAULT_RECURSE_LIMIT, + check=isinstance, + check_type_strict=_check_type_strict, + ): + default_used = False + if self._strict_types: + check = check_type_strict + list_types = list + else: + list_types = (list, tuple) + while True: + if nest_limit < 0: + raise ValueError("recursion limit exceeded") + if obj is None: + return self._buffer.write(b"\xc0") + if check(obj, bool): + if obj: + return self._buffer.write(b"\xc3") + return self._buffer.write(b"\xc2") + if check(obj, int): + if 0 <= obj < 0x80: + return self._buffer.write(struct.pack("B", obj)) + if -0x20 <= obj < 0: + return self._buffer.write(struct.pack("b", obj)) + if 0x80 <= obj <= 0xFF: + return self._buffer.write(struct.pack("BB", 0xCC, obj)) + if -0x80 <= obj < 0: + return self._buffer.write(struct.pack(">Bb", 0xD0, obj)) + if 0xFF < obj <= 0xFFFF: + return self._buffer.write(struct.pack(">BH", 0xCD, obj)) + if -0x8000 <= obj < -0x80: + return self._buffer.write(struct.pack(">Bh", 0xD1, obj)) + if 0xFFFF < obj <= 0xFFFFFFFF: + return self._buffer.write(struct.pack(">BI", 0xCE, obj)) + if -0x80000000 <= obj < -0x8000: + return self._buffer.write(struct.pack(">Bi", 0xD2, obj)) + if 0xFFFFFFFF < obj <= 0xFFFFFFFFFFFFFFFF: + return self._buffer.write(struct.pack(">BQ", 0xCF, obj)) + if -0x8000000000000000 <= obj < -0x80000000: + return self._buffer.write(struct.pack(">Bq", 0xD3, obj)) + if not default_used and self._default is not None: + obj = self._default(obj) + default_used = True + continue + raise OverflowError("Integer value out of range") + if check(obj, (bytes, bytearray)): + n = len(obj) + if n >= 2**32: + raise ValueError("%s is too large" % type(obj).__name__) + self._pack_bin_header(n) + return self._buffer.write(obj) + if check(obj, str): + obj = obj.encode("utf-8", self._unicode_errors) + n = len(obj) + if n >= 2**32: + raise ValueError("String is too large") + self._pack_raw_header(n) + return self._buffer.write(obj) + if check(obj, memoryview): + n = obj.nbytes + if n >= 2**32: + raise ValueError("Memoryview is too large") + self._pack_bin_header(n) + return self._buffer.write(obj) + if check(obj, float): + if self._use_float: + return self._buffer.write(struct.pack(">Bf", 0xCA, obj)) + return self._buffer.write(struct.pack(">Bd", 0xCB, obj)) + if check(obj, (ExtType, Timestamp)): + if check(obj, Timestamp): + code = -1 + data = obj.to_bytes() + else: + code = obj.code + data = obj.data + assert isinstance(code, int) + assert isinstance(data, bytes) + L = len(data) + if L == 1: + self._buffer.write(b"\xd4") + elif L == 2: + self._buffer.write(b"\xd5") + elif L == 4: + self._buffer.write(b"\xd6") + elif L == 8: + self._buffer.write(b"\xd7") + elif L == 16: + self._buffer.write(b"\xd8") + elif L <= 0xFF: + self._buffer.write(struct.pack(">BB", 0xC7, L)) + elif L <= 0xFFFF: + self._buffer.write(struct.pack(">BH", 0xC8, L)) + else: + self._buffer.write(struct.pack(">BI", 0xC9, L)) + self._buffer.write(struct.pack("b", code)) + self._buffer.write(data) + return + if check(obj, list_types): + n = len(obj) + self._pack_array_header(n) + for i in range(n): + self._pack(obj[i], nest_limit - 1) + return + if check(obj, dict): + return self._pack_map_pairs(len(obj), obj.items(), nest_limit - 1) + + if self._datetime and check(obj, _DateTime) and obj.tzinfo is not None: + obj = Timestamp.from_datetime(obj) + default_used = 1 + continue + + if not default_used and self._default is not None: + obj = self._default(obj) + default_used = 1 + continue + + if self._datetime and check(obj, _DateTime): + raise ValueError(f"Cannot serialize {obj!r} where tzinfo=None") + + raise TypeError(f"Cannot serialize {obj!r}") + + def pack(self, obj): + try: + self._pack(obj) + except: + self._buffer = BytesIO() # force reset + raise + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = BytesIO() + return ret + + def pack_map_pairs(self, pairs): + self._pack_map_pairs(len(pairs), pairs) + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = BytesIO() + return ret + + def pack_array_header(self, n): + if n >= 2**32: + raise ValueError + self._pack_array_header(n) + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = BytesIO() + return ret + + def pack_map_header(self, n): + if n >= 2**32: + raise ValueError + self._pack_map_header(n) + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = BytesIO() + return ret + + def pack_ext_type(self, typecode, data): + if not isinstance(typecode, int): + raise TypeError("typecode must have int type.") + if not 0 <= typecode <= 127: + raise ValueError("typecode should be 0-127") + if not isinstance(data, bytes): + raise TypeError("data must have bytes type") + L = len(data) + if L > 0xFFFFFFFF: + raise ValueError("Too large data") + if L == 1: + self._buffer.write(b"\xd4") + elif L == 2: + self._buffer.write(b"\xd5") + elif L == 4: + self._buffer.write(b"\xd6") + elif L == 8: + self._buffer.write(b"\xd7") + elif L == 16: + self._buffer.write(b"\xd8") + elif L <= 0xFF: + self._buffer.write(b"\xc7" + struct.pack("B", L)) + elif L <= 0xFFFF: + self._buffer.write(b"\xc8" + struct.pack(">H", L)) + else: + self._buffer.write(b"\xc9" + struct.pack(">I", L)) + self._buffer.write(struct.pack("B", typecode)) + self._buffer.write(data) + + def _pack_array_header(self, n): + if n <= 0x0F: + return self._buffer.write(struct.pack("B", 0x90 + n)) + if n <= 0xFFFF: + return self._buffer.write(struct.pack(">BH", 0xDC, n)) + if n <= 0xFFFFFFFF: + return self._buffer.write(struct.pack(">BI", 0xDD, n)) + raise ValueError("Array is too large") + + def _pack_map_header(self, n): + if n <= 0x0F: + return self._buffer.write(struct.pack("B", 0x80 + n)) + if n <= 0xFFFF: + return self._buffer.write(struct.pack(">BH", 0xDE, n)) + if n <= 0xFFFFFFFF: + return self._buffer.write(struct.pack(">BI", 0xDF, n)) + raise ValueError("Dict is too large") + + def _pack_map_pairs(self, n, pairs, nest_limit=DEFAULT_RECURSE_LIMIT): + self._pack_map_header(n) + for k, v in pairs: + self._pack(k, nest_limit - 1) + self._pack(v, nest_limit - 1) + + def _pack_raw_header(self, n): + if n <= 0x1F: + self._buffer.write(struct.pack("B", 0xA0 + n)) + elif self._use_bin_type and n <= 0xFF: + self._buffer.write(struct.pack(">BB", 0xD9, n)) + elif n <= 0xFFFF: + self._buffer.write(struct.pack(">BH", 0xDA, n)) + elif n <= 0xFFFFFFFF: + self._buffer.write(struct.pack(">BI", 0xDB, n)) + else: + raise ValueError("Raw is too large") + + def _pack_bin_header(self, n): + if not self._use_bin_type: + return self._pack_raw_header(n) + elif n <= 0xFF: + return self._buffer.write(struct.pack(">BB", 0xC4, n)) + elif n <= 0xFFFF: + return self._buffer.write(struct.pack(">BH", 0xC5, n)) + elif n <= 0xFFFFFFFF: + return self._buffer.write(struct.pack(">BI", 0xC6, n)) + else: + raise ValueError("Bin is too large") + + def bytes(self): + """Return internal buffer contents as bytes object""" + return self._buffer.getvalue() + + def reset(self): + """Reset internal buffer. + + This method is useful only when autoreset=False. + """ + self._buffer = BytesIO() + + def getbuffer(self): + """Return view of internal buffer.""" + if _USING_STRINGBUILDER: + return memoryview(self.bytes()) + else: + return self._buffer.getbuffer() diff --git a/env/lib/python3.12/site-packages/pip/_vendor/packaging/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/__init__.py new file mode 100644 index 0000000..d79f73c --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/__init__.py @@ -0,0 +1,15 @@ +# 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. + +__title__ = "packaging" +__summary__ = "Core utilities for Python packages" +__uri__ = "https://github.com/pypa/packaging" + +__version__ = "24.2" + +__author__ = "Donald Stufft and individual contributors" +__email__ = "donald@stufft.io" + +__license__ = "BSD-2-Clause or Apache-2.0" +__copyright__ = f"2014 {__author__}" diff --git a/env/lib/python3.12/site-packages/pip/_vendor/packaging/_elffile.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/_elffile.py new file mode 100644 index 0000000..25f4282 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/_elffile.py @@ -0,0 +1,110 @@ +""" +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 +""" + +from __future__ import annotations + +import enum +import os +import struct +from typing import IO + + +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 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}") + + self.capacity = ident[4] # Format for program header (bitness). + self.encoding = ident[5] # Data structure encoding (endianness). + + 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 MSB. + (2, 1): ("HHIQQQIHHH", ">IIQQQQQQ", (0, 2, 5)), # 64-bit MSB. + }[(self.capacity, self.encoding)] + except KeyError as e: + raise ELFInvalid( + f"unrecognized capacity ({self.capacity}) or " + f"encoding ({self.encoding})" + ) from e + + 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) -> str | None: + """ + 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/env/lib/python3.12/site-packages/pip/_vendor/packaging/_manylinux.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/_manylinux.py new file mode 100644 index 0000000..61339a6 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/_manylinux.py @@ -0,0 +1,263 @@ +from __future__ import annotations + +import collections +import contextlib +import functools +import os +import re +import sys +import warnings +from typing import Generator, Iterator, NamedTuple, Sequence + +from ._elffile import EIClass, EIData, ELFFile, EMachine + +EF_ARM_ABIMASK = 0xFF000000 +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[ELFFile | None, None, None]: + try: + with open(path, "rb") as f: + yield ELFFile(f) + except (OSError, TypeError, ValueError): + yield None + + +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 + 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(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(executable: str, archs: Sequence[str]) -> bool: + if "armv7l" in archs: + return _is_linux_armhf(executable) + if "i686" in archs: + return _is_linux_i686(executable) + 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 +# minor version was, so we can build the complete list of all versions. +# 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) + + +class _GLibCVersion(NamedTuple): + major: int + minor: int + + +def _glibc_version_string_confstr() -> str | None: + """ + Primary implementation of glibc_version_string using os.confstr. + """ + # os.confstr is quite a bit faster than ctypes.DLL. It's also less likely + # to be broken or missing. This strategy is used in the standard library + # platform module. + # https://github.com/python/cpython/blob/fcf1d003bf4f0100c/Lib/platform.py#L175-L183 + try: + # Should be a string like "glibc 2.17". + 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): + # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)... + return None + return version + + +def _glibc_version_string_ctypes() -> str | None: + """ + Fallback implementation of glibc_version_string using ctypes. + """ + try: + import ctypes + except ImportError: + return None + + # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen + # manpage says, "If filename is NULL, then the returned handle is for the + # main program". This way we can let the linker do the work to figure out + # which libc our process is actually using. + # + # We must also handle the special case where the executable is not a + # dynamically linked executable. This can occur when using musl libc, + # for example. In this situation, dlopen() will error, leading to an + # OSError. Interestingly, at least in the case of musl, there is no + # errno set on the OSError. The single string argument used to construct + # OSError comes from libc itself and is therefore not portable to + # hard code here. In any case, failure to call dlopen() means we + # can proceed, so we bail on our attempt. + try: + process_namespace = ctypes.CDLL(None) + except OSError: + return None + + try: + gnu_get_libc_version = process_namespace.gnu_get_libc_version + except AttributeError: + # Symbol doesn't exist -> therefore, we are not linked to + # glibc. + return None + + # Call gnu_get_libc_version, which returns a string like "2.5" + gnu_get_libc_version.restype = ctypes.c_char_p + version_str: str = gnu_get_libc_version() + # py2 / py3 compatibility: + if not isinstance(version_str, str): + version_str = version_str.decode("ascii") + + return version_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]: + """Parse glibc version. + + We use a regexp instead of str.split because we want to discard any + random junk that might come after the minor version -- this might happen + in patched/forked versions of glibc (e.g. Linaro's version of glibc + uses version strings like "2.20-2014.11"). See gh-3588. + """ + m = re.match(r"(?P[0-9]+)\.(?P[0-9]+)", version_str) + if not m: + warnings.warn( + 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")) + + +@functools.lru_cache +def _get_glibc_version() -> tuple[int, int]: + version_str = _glibc_version_string() + if version_str is None: + return (-1, -1) + return _parse_glibc_version(version_str) + + +# From PEP 513, PEP 600 +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 + except ImportError: + return True + if hasattr(_manylinux, "manylinux_compatible"): + result = _manylinux.manylinux_compatible(version[0], version[1], arch) + if result is not None: + return bool(result) + return True + if version == _GLibCVersion(2, 5): + if hasattr(_manylinux, "manylinux1_compatible"): + return bool(_manylinux.manylinux1_compatible) + if version == _GLibCVersion(2, 12): + if hasattr(_manylinux, "manylinux2010_compatible"): + return bool(_manylinux.manylinux2010_compatible) + if version == _GLibCVersion(2, 17): + if hasattr(_manylinux, "manylinux2014_compatible"): + return bool(_manylinux.manylinux2014_compatible) + return True + + +_LEGACY_MANYLINUX_MAP = { + # CentOS 7 w/ glibc 2.17 (PEP 599) + (2, 17): "manylinux2014", + # CentOS 6 w/ glibc 2.12 (PEP 571) + (2, 12): "manylinux2010", + # CentOS 5 w/ glibc 2.5 (PEP 513) + (2, 5): "manylinux1", +} + + +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 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()) + glibc_max_list = [current_glibc] + # We can assume compatibility across glibc major versions. + # https://sourceware.org/bugzilla/show_bug.cgi?id=24636 + # + # Build a list of maximum glibc versions so that we can + # output the canonical list of all glibc from current_glibc + # down to too_old_glibc2, including all intermediary versions. + 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 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/env/lib/python3.12/site-packages/pip/_vendor/packaging/_musllinux.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/_musllinux.py new file mode 100644 index 0000000..d2bf30b --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/_musllinux.py @@ -0,0 +1,85 @@ +"""PEP 656 support. + +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, Sequence + +from ._elffile import ELFFile + + +class _MuslVersion(NamedTuple): + major: int + minor: int + + +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 + m = re.match(r"Version (\d+)\.(\d+)", lines[1]) + if not m: + return None + return _MuslVersion(major=int(m.group(1)), minor=int(m.group(2))) + + +@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 + information, and invoking the loader to parse its output for a version + string. If the loader is musl, the output would be something like:: + + musl libc (x86_64) + Version 1.2.2 + Dynamic Program Loader + """ + 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, text=True) + return _parse_musl_version(proc.stderr) + + +def platform_tags(archs: Sequence[str]) -> Iterator[str]: + """Generate musllinux 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 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 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 + import sysconfig + + plat = sysconfig.get_platform() + assert plat.startswith("linux-"), "not linux" + + print("plat:", plat) + print("musl:", _get_musl_version(sys.executable)) + print("tags:", end=" ") + for t in platform_tags(re.sub(r"[.-]", "_", plat.split("-", 1)[-1])): + print(t, end="\n ") diff --git a/env/lib/python3.12/site-packages/pip/_vendor/packaging/_parser.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/_parser.py new file mode 100644 index 0000000..c1238c0 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/_parser.py @@ -0,0 +1,354 @@ +"""Handwritten parser of dependency specifiers. + +The docstring for each __parse_* function contains EBNF-inspired grammar representing +the implementation. +""" + +from __future__ import annotations + +import ast +from typing import NamedTuple, Sequence, 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, Sequence["MarkerAtom"]] +MarkerList = Sequence[Union["MarkerList", MarkerAtom, str]] + + +class ParsedRequirement(NamedTuple): + name: str + url: str + extras: list[str] + specifier: str + marker: MarkerList | None + + +# -------------------------------------------------------------------------------------- +# 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, MarkerList | None]: + """ + 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") + + # 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" + ) + 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, + ) + 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", + around="extras", + ): + 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", + around="version specifier", + ): + tokenizer.consume("WS") + parsed_specifiers = _parse_version_many(tokenizer) + tokenizer.consume("WS") + + return parsed_specifiers + + +def _parse_version_many(tokenizer: Tokenizer) -> str: + """ + version_many = (SPECIFIER (WS? COMMA WS? SPECIFIER)*)? + """ + 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 + 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_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: + """ + 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", + around="marker expression", + ): + 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 in ("platform_python_implementation", "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/env/lib/python3.12/site-packages/pip/_vendor/packaging/_structures.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/_structures.py new file mode 100644 index 0000000..90a6465 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/_structures.py @@ -0,0 +1,61 @@ +# 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. + + +class InfinityType: + def __repr__(self) -> str: + return "Infinity" + + def __hash__(self) -> int: + return hash(repr(self)) + + def __lt__(self, other: object) -> bool: + return False + + def __le__(self, other: object) -> bool: + return False + + def __eq__(self, other: object) -> bool: + return isinstance(other, self.__class__) + + def __gt__(self, other: object) -> bool: + return True + + def __ge__(self, other: object) -> bool: + return True + + def __neg__(self: object) -> "NegativeInfinityType": + return NegativeInfinity + + +Infinity = InfinityType() + + +class NegativeInfinityType: + def __repr__(self) -> str: + return "-Infinity" + + def __hash__(self) -> int: + return hash(repr(self)) + + def __lt__(self, other: object) -> bool: + return True + + def __le__(self, other: object) -> bool: + return True + + def __eq__(self, other: object) -> bool: + return isinstance(other, self.__class__) + + def __gt__(self, other: object) -> bool: + return False + + def __ge__(self, other: object) -> bool: + return False + + def __neg__(self: object) -> InfinityType: + return Infinity + + +NegativeInfinity = NegativeInfinityType() diff --git a/env/lib/python3.12/site-packages/pip/_vendor/packaging/_tokenizer.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/_tokenizer.py new file mode 100644 index 0000000..89d0416 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/_tokenizer.py @@ -0,0 +1,194 @@ +from __future__ import annotations + +import contextlib +import re +from dataclasses import dataclass +from typing import Iterator, NoReturn + +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, str | re.Pattern[str]] = { + "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, + ), + "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", + "VERSION_PREFIX_TRAIL": r"\.\*", + "VERSION_LOCAL_LABEL_TRAIL": r"\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*", + "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, 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: Token | None = 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: int | None = None, + span_end: int | None = 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, *, around: str + ) -> Iterator[None]: + if self.check(open_token): + open_position = self.position + self.read() + else: + open_position = None + + yield + + if open_position is None: + return + + if not self.check(close_token): + self.raise_syntax_error( + f"Expected matching {close_token} for {open_token}, after {around}", + span_start=open_position, + ) + + self.read() diff --git a/env/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/__init__.py new file mode 100644 index 0000000..71a1a77 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/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 +# +# 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 pip._vendor.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/env/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/_spdx.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/_spdx.py new file mode 100644 index 0000000..eac2227 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/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/env/lib/python3.12/site-packages/pip/_vendor/packaging/markers.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/markers.py new file mode 100644 index 0000000..fb7f49c --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/markers.py @@ -0,0 +1,331 @@ +# 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 + +import operator +import os +import platform +import sys +from typing import Any, Callable, TypedDict, cast + +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 + +__all__ = [ + "InvalidMarker", + "Marker", + "UndefinedComparison", + "UndefinedEnvironmentName", + "default_environment", +] + +Operator = Callable[[str, str], bool] + + +class InvalidMarker(ValueError): + """ + An invalid marker was found, users should refer to PEP 508. + """ + + +class UndefinedComparison(ValueError): + """ + An invalid operation was attempted on a value that doesn't support it. + """ + + +class UndefinedEnvironmentName(ValueError): + """ + A name was attempted to be used that does not exist inside of the + environment. + """ + + +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. + """ + 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: 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 + # where the single item is itself it's own list. In that case we want skip + # the rest of this function so that we don't get extraneous () on the + # outside. + if ( + isinstance(marker, list) + and len(marker) == 1 + and isinstance(marker[0], (list, tuple)) + ): + return _format_marker(marker[0]) + + if isinstance(marker, list): + inner = (_format_marker(m, first=False) for m in marker) + if first: + return " ".join(inner) + else: + return "(" + " ".join(inner) + ")" + elif isinstance(marker, tuple): + return " ".join([m.serialize() for m in marker]) + else: + return marker + + +_operators: dict[str, Operator] = { + "in": lambda lhs, rhs: lhs in rhs, + "not in": lambda lhs, rhs: lhs not in rhs, + "<": operator.lt, + "<=": operator.le, + "==": operator.eq, + "!=": operator.ne, + ">=": operator.ge, + ">": operator.gt, +} + + +def _eval_op(lhs: str, op: Op, rhs: str) -> bool: + try: + spec = Specifier("".join([op.serialize(), rhs])) + except InvalidSpecifier: + pass + else: + return spec.contains(lhs, prereleases=True) + + 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, ...]: + # 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 + + +def _evaluate_markers(markers: MarkerList, environment: dict[str, str]) -> bool: + groups: list[list[bool]] = [[]] + + for marker in markers: + assert isinstance(marker, (list, tuple, str)) + + if isinstance(marker, list): + groups[-1].append(_evaluate_markers(marker, environment)) + elif isinstance(marker, tuple): + lhs, op, rhs = marker + + if isinstance(lhs, Variable): + environment_key = lhs.value + lhs_value = environment[environment_key] + rhs_value = rhs.value + else: + lhs_value = lhs.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"] + if marker == "or": + groups.append([]) + + return any(all(item) for item in groups) + + +def format_full_version(info: sys._version_info) -> str: + version = f"{info.major}.{info.minor}.{info.micro}" + kind = info.releaselevel + if kind != "final": + version += kind[0] + str(info.serial) + return version + + +def default_environment() -> Environment: + iver = format_full_version(sys.implementation.version) + implementation_name = sys.implementation.name + return { + "implementation_name": implementation_name, + "implementation_version": iver, + "os_name": os.name, + "platform_machine": platform.machine(), + "platform_release": platform.release(), + "platform_system": platform.system(), + "platform_version": platform.version(), + "python_full_version": platform.python_version(), + "platform_python_implementation": platform.python_implementation(), + "python_version": ".".join(platform.python_version_tuple()[:2]), + "sys_platform": sys.platform, + } + + +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 = _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: + # [ + # (, ')>, ), + # 'and', + # [ + # (, , ), + # 'or', + # (, , ) + # ] + # ] + except ParserSyntaxError as e: + raise InvalidMarker(str(e)) from e + + def __str__(self) -> str: + return _format_marker(self._markers) + + def __repr__(self) -> str: + return f"" + + 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: dict[str, str] | None = None) -> bool: + """Evaluate a marker. + + Return the boolean from evaluating the given marker against the + environment. environment is an optional argument to override all or + part of the determined environment. + + The environment is determined from the current Python process. + """ + current_environment = cast("dict[str, str]", default_environment()) + 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, _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/env/lib/python3.12/site-packages/pip/_vendor/packaging/metadata.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/metadata.py new file mode 100644 index 0000000..721f411 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/metadata.py @@ -0,0 +1,863 @@ +from __future__ import annotations + +import email.feedparser +import email.header +import email.message +import email.parser +import email.policy +import pathlib +import sys +import typing +from typing import ( + Any, + Callable, + Generic, + Literal, + TypedDict, + cast, +) + +from . import licenses, requirements, specifiers, utils +from . import version as version_module +from .licenses import NormalizedLicenseExpression + +T = typing.TypeVar("T") + + +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. + + 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})" + + +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 +# 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. 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 + 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 emitting 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. + + # Metadata 2.4 - PEP 639 + license_expression: str + license_files: list[str] + + +_STRING_FIELDS = { + "author", + "author_email", + "description", + "description_content_type", + "download_url", + "home_page", + "license", + "license_expression", + "maintainer", + "maintainer_email", + "metadata_version", + "name", + "requires_python", + "summary", + "version", +} + +_LIST_FIELDS = { + "classifiers", + "dynamic", + "license_files", + "obsoletes", + "obsoletes_dist", + "platforms", + "provides", + "provides_dist", + "provides_extra", + "requires", + "requires_dist", + "requires_external", + "supported_platforms", +} + +_DICT_FIELDS = { + "project_urls", +} + + +def _parse_keywords(data: str) -> list[str]: + """Split a string of comma-separated keywords 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: 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 = 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 = msg.get_payload(decode=True) + assert isinstance(bpayload, bytes) + try: + return bpayload.decode("utf8", "strict") + 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 +# 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", + "license-expression": "license_expression", + "license-file": "license_files", + "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", +} +_RAW_TO_EMAIL_MAPPING = {raw: email for email, raw in _EMAIL_TO_RAW_MAPPING.items()} + + +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 + 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, 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) or [] + + # 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, str | None]] = [] + 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_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)) # type: ignore[call-overload] + ) + 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 + + +_NOT_FOUND = object() + + +# Keep the two values in sync. +_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"]) + + +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: Exception | None = 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 + ) from 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 + ) from 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"{dynamic_field!r} is not allowed as a dynamic field" + ) + elif dynamic_field not in _EMAIL_TO_RAW_MAPPING: + raise self._invalid_metadata( + f"{dynamic_field!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 + ) from 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 + ) from 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 + ) 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. + + 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, + f"{field} introduced in metadata version " + f"{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: 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` 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 + *validate* parameter)""" + version: _Validator[version_module.Version] = _Validator() + """:external:ref:`core-metadata-version` (required)""" + dynamic: _Validator[list[str] | None] = _Validator( + added="2.2", + ) + """:external:ref:`core-metadata-dynamic` + (validated against core metadata field names and lowercased)""" + platforms: _Validator[list[str] | None] = _Validator() + """:external:ref:`core-metadata-platform`""" + supported_platforms: _Validator[list[str] | None] = _Validator(added="1.1") + """:external:ref:`core-metadata-supported-platform`""" + summary: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-summary` (validated to contain no newlines)""" + description: _Validator[str | None] = _Validator() # TODO 2.1: can be in body + """:external:ref:`core-metadata-description`""" + description_content_type: _Validator[str | None] = _Validator(added="2.1") + """:external:ref:`core-metadata-description-content-type` (validated)""" + keywords: _Validator[list[str] | None] = _Validator() + """:external:ref:`core-metadata-keywords`""" + home_page: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-home-page`""" + download_url: _Validator[str | None] = _Validator(added="1.1") + """:external:ref:`core-metadata-download-url`""" + author: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-author`""" + author_email: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-author-email`""" + maintainer: _Validator[str | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-maintainer`""" + maintainer_email: _Validator[str | None] = _Validator(added="1.2") + """: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( + added="1.2" + ) + """:external:ref:`core-metadata-requires-dist`""" + 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[list[str] | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-requires-external`""" + 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[list[utils.NormalizedName] | None] = _Validator( + added="2.1", + ) + """:external:ref:`core-metadata-provides-extra`""" + provides_dist: _Validator[list[str] | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-provides-dist`""" + obsoletes_dist: _Validator[list[str] | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-obsoletes-dist`""" + requires: _Validator[list[str] | None] = _Validator(added="1.1") + """``Requires`` (deprecated)""" + provides: _Validator[list[str] | None] = _Validator(added="1.1") + """``Provides`` (deprecated)""" + obsoletes: _Validator[list[str] | None] = _Validator(added="1.1") + """``Obsoletes`` (deprecated)""" diff --git a/env/lib/python3.12/site-packages/pip/_vendor/packaging/py.typed b/env/lib/python3.12/site-packages/pip/_vendor/packaging/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/pip/_vendor/packaging/requirements.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/requirements.py new file mode 100644 index 0000000..4e068c9 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/requirements.py @@ -0,0 +1,91 @@ +# 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 + +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): + """ + An invalid requirement was found, users should refer to PEP 508. + """ + + +class Requirement: + """Parse a requirement. + + Parse a given requirement string into its parts, such as name, specifier, + URL, and extras. Raises InvalidRequirement on a badly-formed requirement + string. + """ + + # TODO: Can we test whether something is contained within a requirement? + # If so how do we do that? Do we need to test against the _name_ of + # the thing as well as the version? What about the markers? + # TODO: Can we normalize the name and extra name? + + def __init__(self, requirement_string: str) -> None: + try: + parsed = _parse_requirement(requirement_string) + except ParserSyntaxError as e: + raise InvalidRequirement(str(e)) from e + + self.name: str = parsed.name + self.url: str | None = parsed.url or None + self.extras: set[str] = set(parsed.extras or []) + self.specifier: SpecifierSet = SpecifierSet(parsed.specifier) + self.marker: Marker | None = None + if parsed.marker is not None: + self.marker = Marker.__new__(Marker) + self.marker._markers = _normalize_extra_values(parsed.marker) + + def _iter_parts(self, name: str) -> Iterator[str]: + yield name + + if self.extras: + formatted_extras = ",".join(sorted(self.extras)) + yield f"[{formatted_extras}]" + + if self.specifier: + yield str(self.specifier) + + if self.url: + yield f"@ {self.url}" + if self.marker: + yield " " + + if self.marker: + yield f"; {self.marker}" + + def __str__(self) -> str: + return "".join(self._iter_parts(self.name)) + + def __repr__(self) -> str: + return f"" + + def __hash__(self) -> int: + 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 ( + canonicalize_name(self.name) == canonicalize_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/env/lib/python3.12/site-packages/pip/_vendor/packaging/specifiers.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/specifiers.py new file mode 100644 index 0000000..f18016e --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/specifiers.py @@ -0,0 +1,1020 @@ +# 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 pip._vendor.packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier + from pip._vendor.packaging.version import Version +""" + +from __future__ import annotations + +import abc +import itertools +import re +from typing import Callable, Iterable, Iterator, 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] + + +def _coerce_version(version: UnparsedVersion) -> Version: + if not isinstance(version, Version): + version = Version(version) + return version + + +class InvalidSpecifier(ValueError): + """ + 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' + """ + + +class BaseSpecifier(metaclass=abc.ABCMeta): + @abc.abstractmethod + def __str__(self) -> str: + """ + 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. + """ + + @abc.abstractmethod + def __eq__(self, other: object) -> bool: + """ + Returns a boolean representing whether or not the two Specifier-like + objects are equal. + + :param other: The other object to check against. + """ + + @property + @abc.abstractmethod + 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 + prereleases or it can be set to ``None`` (the default) to use default semantics. + """ + + @prereleases.setter + def prereleases(self, value: bool) -> None: + """Setter for :attr:`prereleases`. + + :param value: The value to set. + """ + + @abc.abstractmethod + 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: bool | None = 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. + """ + + +class Specifier(BaseSpecifier): + """This class abstracts handling of version specifiers. + + .. tip:: + + 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). + """ + + _operator_regex_str = r""" + (?P(~=|==|!=|<=|>=|<|>|===)) + """ + _version_regex_str = r""" + (?P + (?: + # The identity operators allow for an escape hatch that will + # do an exact string match of the version you wish to install. + # This will not be parsed by PEP 440 and we cannot determine + # any semantic meaning from it. This operator is discouraged + # but included entirely as an escape hatch. + (?<====) # Only match for the identity operator + \s* + [^\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. + ) + | + (?: + # The (non)equality operators allow for wild card and local + # versions to be specified so we have to define these two + # operators separately to enable that. + (?<===|!=) # Only match for equals and not equals + + \s* + v? + (?:[0-9]+!)? # epoch + [0-9]+(?:\.[0-9]+)* # release + + # 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 + [-_\.]? + (alpha|beta|preview|pre|a|b|c|rc) + [-_\.]? + [0-9]* + )? + (?: # post release + (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) + )? + (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release + (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local + )? + ) + | + (?: + # The compatible operator requires at least two digits in the + # release segment. + (?<=~=) # Only match for the compatible operator + + \s* + v? + (?:[0-9]+!)? # epoch + [0-9]+(?:\.[0-9]+)+ # release (We have a + instead of a *) + (?: # pre release + [-_\.]? + (alpha|beta|preview|pre|a|b|c|rc) + [-_\.]? + [0-9]* + )? + (?: # post release + (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) + )? + (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release + ) + | + (?: + # All other operators only allow a sub set of what the + # (non)equality operators do. Specifically they do not allow + # local versions to be specified nor do they allow the prefix + # matching wild cards. + (?=": "greater_than_equal", + "<": "less_than", + ">": "greater_than", + "===": "arbitrary", + } + + def __init__(self, spec: str = "", prereleases: bool | None = 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!r}") + + 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 + + # 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. + 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') + =1.0.0')> + >>> Specifier('>=1.0.0', prereleases=False) + =1.0.0', prereleases=False)> + >>> Specifier('>=1.0.0', prereleases=True) + =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 + # implement this in terms of the other specifiers instead of + # implementing it ourselves. The only thing we need to do is construct + # the other specifiers. + + # We want everything but the last item in the version, but we want to + # ignore suffix segments. + prefix = _version_join( + list(itertools.takewhile(_is_not_suffix, _version_split(spec)))[:-1] + ) + + # Add the prefix notation to the end of our string + prefix += ".*" + + return self._get_operator(">=")(prospective, spec) and self._get_operator("==")( + prospective, prefix + ) + + 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. + 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 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 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 + # 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 = padded_prospective[: len(split_spec)] + + return shortened_prospective == split_spec + else: + # Convert our spec string into a Version + spec_version = Version(spec) + + # If the specifier does not have a local segment, then we want to + # act as if the prospective version also does not have a local + # segment. + if not spec_version.local: + prospective = Version(prospective.public) + + return prospective == spec_version + + def _compare_not_equal(self, prospective: Version, spec: str) -> bool: + 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) + + # Check to see if the prospective version is less than the spec + # version. If it's not we can short circuit and just return False now + # instead of doing extra unneeded work. + if not prospective < spec: + return False + + # This special case is here so that, unless the specifier itself + # includes is a pre-release version, that we do not accept pre-release + # versions for the version mentioned in the specifier (e.g. <3.1 should + # not match 3.1.dev0, but should match 3.0.dev0). + if not spec.is_prerelease and prospective.is_prerelease: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # If we've gotten to here, it means that prospective version is both + # less than the spec version *and* it's not a pre-release of the same + # version in the spec. + 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) + + # Check to see if the prospective version is greater than the spec + # version. If it's not we can short circuit and just return False now + # instead of doing extra unneeded work. + if not prospective > spec: + return False + + # This special case is here so that, unless the specifier itself + # includes is a post-release version, that we do not accept + # post-release versions for the version mentioned in the specifier + # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0). + if not spec.is_postrelease and prospective.is_postrelease: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # Ensure that we do not allow a local version of the version mentioned + # in the specifier, which is technically greater than, to match. + if prospective.local is not None: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # If we've gotten to here, it means that prospective version is both + # greater than the spec version *and* it's not a pre-release of the + # same version in the spec. + return True + + def _compare_arbitrary(self, prospective: Version, spec: str) -> bool: + return str(prospective).lower() == str(spec).lower() + + 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. + + This is used for the ``in`` operator and behaves the same as + :meth:`contains` with no ``prereleases`` argument passed. + + >>> "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) + + def contains(self, item: UnparsedVersion, prereleases: bool | None = None) -> bool: + """Return whether or not the item is contained in this specifier. + + :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[UnparsedVersionVar], prereleases: bool | None = None + ) -> Iterator[UnparsedVersionVar]: + """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', ] + >>> 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 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 + + +_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] = [] + + 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()) + else: + result.append(item) + 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") + ) + + +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 + left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left))) + right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right))) + + # Get the rest of our versions + left_split.append(left[len(left_split[0]) :]) + right_split.append(right[len(right_split[0]) :]) + + # Insert our padding + 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.from_iterable(left_split)), + list(itertools.chain.from_iterable(right_split)), + ) + + +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 | 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 + given specifiers. + + :raises InvalidSpecifier: + If the given ``specifiers`` are not parseable than this exception will be + raised. + """ + + 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)) + 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. + self._prereleases = prereleases + + @property + 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: + 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') + =1.0.0')> + >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False) + =1.0.0', prereleases=False)> + >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True) + =1.0.0', prereleases=True)> + """ + pre = ( + f", prereleases={self.prereleases!r}" + if self._prereleases is not None + else "" + ) + + return f"" + + 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: 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' + =1.0.0')> + >>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1') + =1.0.0')> + """ + if isinstance(other, str): + other = SpecifierSet(other) + elif not isinstance(other, SpecifierSet): + return NotImplemented + + specifier = SpecifierSet() + specifier._specs = frozenset(self._specs | other._specs) + + if self._prereleases is None and other._prereleases is not None: + specifier._prereleases = other._prereleases + elif self._prereleases is not None and other._prereleases is None: + specifier._prereleases = self._prereleases + elif self._prereleases == other._prereleases: + specifier._prereleases = self._prereleases + else: + raise ValueError( + "Cannot combine SpecifierSets with True and False prerelease " + "overrides." + ) + + return specifier + + def __eq__(self, other: object) -> bool: + """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 + + 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[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) + [, =1.0.0')>] + """ + return iter(self._specs) + + 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: bool | None = None, + installed: bool | None = None, + ) -> bool: + """Return whether or not the item is contained in this SpecifierSet. + + :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 + # SpecifierSet thinks for whether or not we should support prereleases. + if prereleases is None: + prereleases = self.prereleases + + # We can determine if we're going to allow pre-releases by looking to + # see if any of the underlying items supports them. If none of them do + # and this item is a pre-release then we do not allow it and we can + # short circuit that here. + # Note: This means that 1.0.dev1 would not be contained in something + # like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0 + 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 + # will always return True, this is an explicit design decision. + return all(s.contains(item, prereleases=prereleases) for s in self._specs) + + def filter( + self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None + ) -> Iterator[UnparsedVersionVar]: + """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', ] + >>> 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. + if prereleases is None: + prereleases = self.prereleases + + # If we have any specifiers, then we want to wrap our iterable in the + # filter method for each one, this will act as a logical AND amongst + # each specifier. + if self._specs: + for spec in self._specs: + iterable = spec.filter(iterable, prereleases=bool(prereleases)) + 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. + else: + filtered: list[UnparsedVersionVar] = [] + found_prereleases: list[UnparsedVersionVar] = [] + + for item in iterable: + 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 + if parsed_version.is_prerelease and not prereleases: + if not filtered: + found_prereleases.append(item) + else: + filtered.append(item) + + # 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 iter(found_prereleases) + + return iter(filtered) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/packaging/tags.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/tags.py new file mode 100644 index 0000000..f590340 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/tags.py @@ -0,0 +1,617 @@ +# 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 + +import logging +import platform +import re +import struct +import subprocess +import sys +import sysconfig +from importlib.machinery import EXTENSION_SUFFIXES +from typing import ( + Iterable, + Iterator, + Sequence, + Tuple, + cast, +) + +from . import _manylinux, _musllinux + +logger = logging.getLogger(__name__) + +PythonVersion = Sequence[int] +AppleVersion = Tuple[int, int] + +INTERPRETER_SHORT_NAMES: dict[str, str] = { + "python": "py", # Generic. + "cpython": "cp", + "pypy": "pp", + "ironpython": "ip", + "jython": "jy", +} + + +_32_BIT_INTERPRETER = struct.calcsize("P") == 4 + + +class Tag: + """ + A representation of the tag triple for a wheel. + + Instances are considered immutable and thus are hashable. Equality checking + is also supported. + """ + + __slots__ = ["_abi", "_hash", "_interpreter", "_platform"] + + def __init__(self, interpreter: str, abi: str, platform: str) -> None: + self._interpreter = interpreter.lower() + self._abi = abi.lower() + self._platform = platform.lower() + # The __hash__ of every single element in a Set[Tag] will be evaluated each time + # that a set calls its `.disjoint()` method, which may be called hundreds of + # times when scanning a page of links for packages with tags matching that + # Set[Tag]. Pre-computing the value here produces significant speedups for + # downstream consumers. + self._hash = hash((self._interpreter, self._abi, self._platform)) + + @property + def interpreter(self) -> str: + return self._interpreter + + @property + def abi(self) -> str: + return self._abi + + @property + def platform(self) -> str: + return self._platform + + def __eq__(self, other: object) -> bool: + if not isinstance(other, Tag): + return NotImplemented + + return ( + (self._hash == other._hash) # Short-circuit ASAP for perf reasons. + and (self._platform == other._platform) + and (self._abi == other._abi) + and (self._interpreter == other._interpreter) + ) + + def __hash__(self) -> int: + return self._hash + + def __str__(self) -> str: + return f"{self._interpreter}-{self._abi}-{self._platform}" + + def __repr__(self) -> str: + return f"<{self} @ {id(self)}>" + + +def parse_tag(tag: str) -> frozenset[Tag]: + """ + Parses the provided tag (e.g. `py3-none-any`) into a frozenset of Tag instances. + + Returning a set is required due to the possibility that the tag is a + compressed tag set. + """ + tags = set() + interpreters, abis, platforms = tag.split("-") + for interpreter in interpreters.split("."): + for abi in abis.split("."): + for platform_ in platforms.split("."): + tags.add(Tag(interpreter, abi, platform_)) + return frozenset(tags) + + +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 + ) + return value + + +def _normalize_string(string: str) -> str: + return string.replace(".", "_").replace("-", "_").replace(" ", "_") + + +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. The threaded (`--disable-gil`) + builds do not support abi3. + """ + 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]) + 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 + # extension modules is the best option. + # https://github.com/pypa/pip/issues/3383#issuecomment-173267692 + 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: + pymalloc = "m" + if py_version < (3, 3): + unicode_size = _get_config_var("Py_UNICODE_SIZE", warn) + if unicode_size == 4 or ( + unicode_size is None and sys.maxunicode == 0x10FFFF + ): + ucs4 = "u" + 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}{threading}") + abis.insert(0, f"cp{version}{threading}{debug}{pymalloc}{ucs4}") + return abis + + +def cpython_tags( + python_version: PythonVersion | None = None, + abis: Iterable[str] | None = None, + platforms: Iterable[str] | None = None, + *, + warn: bool = False, +) -> Iterator[Tag]: + """ + Yields the tags for a CPython interpreter. + + The tags consist of: + - cp-- + - cp-abi3- + - cp-none- + - cp-abi3- # Older Python versions down to 3.2. + + If python_version only specifies a major version then user-provided ABIs and + the 'none' ABItag will be used. + + If 'abi3' or 'none' are specified in 'abis' then they will be yielded at + their normal position and not at the beginning. + """ + if not python_version: + python_version = sys.version_info[:2] + + interpreter = f"cp{_version_nodot(python_version[:2])}" + + if abis is None: + if len(python_version) > 1: + abis = _cpython_abis(python_version, warn) + else: + abis = [] + abis = list(abis) + # 'abi3' and 'none' are explicitly handled later. + for explicit_abi in ("abi3", "none"): + try: + abis.remove(explicit_abi) + except ValueError: + pass + + platforms = list(platforms or platform_tags()) + for abi in abis: + for platform_ in platforms: + yield Tag(interpreter, abi, platform_) + + 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 use_abi3: + for minor_version in range(python_version[1] - 1, 1, -1): + for platform_ in platforms: + version = _version_nodot((python_version[0], minor_version)) + interpreter = f"cp{version}" + yield Tag(interpreter, "abi3", platform_) + + +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( + interpreter: str | None = None, + abis: Iterable[str] | None = None, + platforms: Iterable[str] | None = None, + *, + warn: bool = False, +) -> Iterator[Tag]: + """ + Yields the tags for a generic interpreter. + + The tags consist of: + - -- + + The "none" ABI will be added if it was not explicitly provided. + """ + if not interpreter: + interp_name = interpreter_name() + interp_version = interpreter_version(warn=warn) + interpreter = "".join([interp_name, interp_version]) + if abis is None: + abis = _generic_abi() + else: + abis = list(abis) + platforms = list(platforms or platform_tags()) + if "none" not in abis: + abis.append("none") + for abi in abis: + for platform_ in platforms: + yield Tag(interpreter, abi, platform_) + + +def _py_interpreter_range(py_version: PythonVersion) -> Iterator[str]: + """ + Yields Python versions in descending order. + + After the latest version, the major-only version will be yielded, and then + all previous versions of that major version. + """ + if len(py_version) > 1: + yield f"py{_version_nodot(py_version[:2])}" + yield f"py{py_version[0]}" + if len(py_version) > 1: + for minor in range(py_version[1] - 1, -1, -1): + yield f"py{_version_nodot((py_version[0], minor))}" + + +def compatible_tags( + 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. + + The tags consist of: + - py*-none- + - -none-any # ... if `interpreter` is provided. + - py*-none-any + """ + if not python_version: + python_version = sys.version_info[:2] + platforms = list(platforms or platform_tags()) + for version in _py_interpreter_range(python_version): + for platform_ in platforms: + yield Tag(version, "none", platform_) + if interpreter: + yield Tag(interpreter, "none", "any") + for version in _py_interpreter_range(python_version): + yield Tag(version, "none", "any") + + +def _mac_arch(arch: str, is_32bit: bool = _32_BIT_INTERPRETER) -> str: + if not is_32bit: + return arch + + if arch.startswith("ppc"): + return "ppc" + + return "i386" + + +def _mac_binary_formats(version: AppleVersion, cpu_arch: str) -> list[str]: + formats = [cpu_arch] + if cpu_arch == "x86_64": + if version < (10, 4): + return [] + formats.extend(["intel", "fat64", "fat32"]) + + elif cpu_arch == "i386": + if version < (10, 4): + return [] + formats.extend(["intel", "fat32", "fat"]) + + elif cpu_arch == "ppc64": + # TODO: Need to care about 32-bit PPC for ppc64 through 10.2? + if version > (10, 5) or version < (10, 4): + return [] + formats.append("fat64") + + elif cpu_arch == "ppc": + if version > (10, 6): + return [] + formats.extend(["fat32", "fat"]) + + if cpu_arch in {"arm64", "x86_64"}: + formats.append("universal2") + + if cpu_arch in {"x86_64", "i386", "ppc64", "ppc", "intel"}: + formats.append("universal") + + return formats + + +def mac_platforms( + version: AppleVersion | None = None, arch: str | None = None +) -> Iterator[str]: + """ + Yields the platform tags for a macOS system. + + The `version` parameter is a two-item tuple specifying the macOS version to + generate platform tags for. The `arch` parameter is the CPU architecture to + generate platform tags for. Both parameters default to the appropriate value + for the current system. + """ + version_str, _, cpu_arch = platform.mac_ver() + if version is None: + 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. + 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, + text=True, + ).stdout + version = cast("AppleVersion", tuple(map(int, version_str.split(".")[:2]))) + else: + version = version + if arch is None: + arch = _mac_arch(cpu_arch) + else: + arch = arch + + 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 = major_version, minor_version + binary_formats = _mac_binary_formats(compat_version, arch) + for binary_format in binary_formats: + 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, minor_version + binary_formats = _mac_binary_formats(compat_version, arch) + for binary_format in binary_formats: + 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. + # Arm64 support was introduced in 11.0, so no Arm binaries from previous + # releases exist. + # + # 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 = major_version, minor_version + binary_formats = _mac_binary_formats(compat_version, arch) + for binary_format in binary_formats: + yield f"macosx_{major_version}_{minor_version}_{binary_format}" + else: + for minor_version in range(16, 3, -1): + compat_version = major_version, minor_version + binary_format = "universal2" + 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]: + 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_armv8l" + _, arch = linux.split("_", 1) + 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]: + yield _normalize_string(sysconfig.get_platform()) + + +def platform_tags() -> Iterator[str]: + """ + Provides the platform tags for this installation. + """ + if platform.system() == "Darwin": + return mac_platforms() + elif platform.system() == "iOS": + return ios_platforms() + elif platform.system() == "Linux": + return _linux_platforms() + else: + return _generic_platforms() + + +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 + + +def interpreter_version(*, warn: bool = False) -> str: + """ + Returns the version of the running interpreter. + """ + version = _get_config_var("py_version_nodot", warn=warn) + if version: + version = str(version) + else: + version = _version_nodot(sys.version_info[:2]) + return version + + +def _version_nodot(version: PythonVersion) -> str: + return "".join(map(str, version)) + + +def sys_tags(*, warn: bool = False) -> Iterator[Tag]: + """ + Returns the sequence of tag triples for the running interpreter. + + The order of the sequence corresponds to priority order for the + interpreter, from most to least important. + """ + + interp_name = interpreter_name() + if interp_name == "cp": + yield from cpython_tags(warn=warn) + else: + yield from generic_tags() + + if interp_name == "pp": + interp = "pp3" + elif interp_name == "cp": + interp = "cp" + interpreter_version(warn=warn) + else: + interp = None + yield from compatible_tags(interpreter=interp) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/packaging/utils.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/utils.py new file mode 100644 index 0000000..2345095 --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/utils.py @@ -0,0 +1,163 @@ +# 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 + +import functools +import re +from typing import NewType, Tuple, Union, cast + +from .tags import Tag, parse_tag +from .version import InvalidVersion, Version, _TrimmedRelease + +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. + """ + + +class InvalidSdistFilename(ValueError): + """ + An invalid sdist filename was found, users should refer to the packaging user guide. + """ + + +# 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, *, 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 + + +@functools.singledispatch +def canonicalize_version( + version: Version | str, *, strip_trailing_zero: bool = True +) -> str: + """ + 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' + """ + return str(_TrimmedRelease(str(version)) if strip_trailing_zero else version) + + +@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( + filename: str, +) -> tuple[NormalizedName, Version, BuildTag, frozenset[Tag]]: + if not filename.endswith(".whl"): + raise InvalidWheelFilename( + 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!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!r}") + name = canonicalize_name(name_part) + + try: + version = Version(parts[1]) + except InvalidVersion as e: + raise InvalidWheelFilename( + f"Invalid wheel filename (invalid version): {filename!r}" + ) from e + + if dashes == 5: + build_part = parts[2] + build_match = _build_tag_regex.match(build_part) + if build_match is None: + raise InvalidWheelFilename( + f"Invalid build number: {build_part} in {filename!r}" + ) + build = cast(BuildTag, (int(build_match.group(1)), build_match.group(2))) + else: + build = () + tags = parse_tag(parts[-1]) + return (name, version, build, tags) + + +def parse_sdist_filename(filename: str) -> tuple[NormalizedName, Version]: + if filename.endswith(".tar.gz"): + file_stem = filename[: -len(".tar.gz")] + elif filename.endswith(".zip"): + file_stem = filename[: -len(".zip")] + else: + raise InvalidSdistFilename( + f"Invalid sdist filename (extension must be '.tar.gz' or '.zip'):" + 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!r}") + + name = canonicalize_name(name_part) + + try: + version = Version(version_part) + except InvalidVersion as e: + raise InvalidSdistFilename( + f"Invalid sdist filename (invalid version): {filename!r}" + ) from e + + return (name, version) diff --git a/env/lib/python3.12/site-packages/pip/_vendor/packaging/version.py b/env/lib/python3.12/site-packages/pip/_vendor/packaging/version.py new file mode 100644 index 0000000..21f44ca --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/packaging/version.py @@ -0,0 +1,582 @@ +# 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 pip._vendor.packaging.version import parse, Version +""" + +from __future__ import annotations + +import itertools +import re +from typing import Any, Callable, NamedTuple, SupportsInt, Tuple, Union + +from ._structures import Infinity, InfinityType, NegativeInfinity, NegativeInfinityType + +__all__ = ["VERSION_PATTERN", "InvalidVersion", "Version", "parse"] + +LocalType = Tuple[Union[int, str], ...] + +CmpPrePostDevType = Union[InfinityType, NegativeInfinityType, Tuple[str, int]] +CmpLocalType = Union[ + NegativeInfinityType, + Tuple[Union[Tuple[int, str], Tuple[NegativeInfinityType, Union[int, str]]], ...], +] +CmpKey = Tuple[ + int, + Tuple[int, ...], + CmpPrePostDevType, + CmpPrePostDevType, + CmpPrePostDevType, + CmpLocalType, +] +VersionComparisonMethod = Callable[[CmpKey, CmpKey], bool] + + +class _Version(NamedTuple): + epoch: int + 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: + """Parse the given version string. + + >>> parse('1.0.dev1') + + + :param version: The version string to parse. + :raises InvalidVersion: When the version string is not a valid version. + """ + return Version(version) + + +class InvalidVersion(ValueError): + """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: tuple[Any, ...] + + def __hash__(self) -> int: + return hash(self._key) + + # 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: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key < other._key + + def __le__(self, other: _BaseVersion) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key <= other._key + + def __eq__(self, other: object) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key == other._key + + def __ge__(self, other: _BaseVersion) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key >= other._key + + def __gt__(self, other: _BaseVersion) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key > other._key + + def __ne__(self, other: object) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key != other._key + + +# Deliberately not anchored to the start and end of the string, to make it +# easier for 3rd party code to reuse +_VERSION_PATTERN = r""" + v? + (?: + (?:(?P[0-9]+)!)? # epoch + (?P[0-9]+(?:\.[0-9]+)*) # release segment + (?P

!I7S{BS4i1|@R7s@ zBh>dJ`X=v~Z#j7L7qym3O>1w@`}Ib;lHEs;SuB-d~dOAuxs6o zj(1yQZ!1o$-ceA_ip^cMNbJHAzA zF5#OchBvm%$mo|fg`L0}NG*Gu^P*QrkQ=_&+t1jl8hJX@o2ho?5x?BcbwBFM#siz|d;E%O<^m>3KE=JyzULbu z!9rpT0nW-V=64D0ba8!}-!$&ST-WlG@kRyLYJMUoQLfGWF5rHDnyWqgUbko8>-Ow> zX>TX(w@rvt?c(R7d>7ZJ`3VoUQRgmx(%%Zws`-VH(WuxbeV)7Zy&mWrRQR#2e9Q4u zyf?`&I8M$dwp{Xj8oYi-^R5+}NamrKQk`Gs_Z5C$<;T2V=N5ij`R($k&fWZAd)14b zk#V3iZ*4s*_w#0%zwaks7#?uWjt_FC`!YFG*#0)KE(g3$J??cPygRE7;bGQZ>oe#b z8!7rOI)oSNyQ{+AHTwIOBfldcb*2MX262l@&YrL3>{@f?{_UJS|D*-01nD#~1loCCNM{vKql!)eY^z7ZXSKF&3X z-^={Fk2=8buIQ`JEyNEj!CuDhs>Q6m4+0nKpKpM^yFP8>!`*lB_an6H$3EVNEh>m`j@YD1eU|hR z;wsYL8p=r?!DXQff70d%oRi1Fp}P&qM_eRdU}zWxhKG4~6Yrjb)`AlUA3CNz%2~JW zb7)NU<`(((;|lZ=dU6Z4U7y8l`u1%vCH;QzRrDFpj^1(pIC`p|*if}UOEne3Zn!zW8COJkrrg7Uc71-$!*e@A^1Twq51l0y&|xd@pWn#Yn1e?9 zQT$0~>?|;f{dw(6W$n{|TkMhet0Fh7Y2D2kE<@uS>DLAHOUCb)1Ivc76Pu(?sn4=y zIq?f9i_OsAW$(o|5V>9Zh)PIV6TUgdbH(2q9kLfu*4oOq5kwz+ls-s2(P}-`cZYhHj4t*Pua$G%o@CMJ8|n?uZrujTn^9aF&PCoVE_ zd~3$VN1)$TpYY@3;ZJ>vJY_bHcL0ZsIqqYOx`BFLz~(%UUm#;fr(6x?Ldcsu%Q#{V zYu5#jk5e{Ej3N5w;BJ9UY?8cpci9c&Yb$LE z55qgViAQH=>bf~+lRl%1befDw1UKp%e6!{&_ySfx4{f1c;it{|dam!pSh&^gZy9bs zmpXrTj<#eQy~^1T4T)o>gw zQ^x=aX2kAIO>c@C`a4V-cQvH_k+GlPZZ0w;xRZK&!JYX5&bH^=#?j((a_0U5$}Y3< zXvt50`~Y<&8?~I|HG=AsO85@zsJaoo7bcV${dGW6Ri|A#1k6kOY&d3Wo^*j%K z+`3~8<%e}gZoH6nyVAFI>IlO-Cc1-XeKv^b*#}7HIa})t^z4bH?(>b|1$&-Q`eJ^A zz9{CVh{@H!+ssqyez|${tJLSlZ4=Mh2A=iZs9{}e-uKS+vOsY}z1YpO>vipW(YO~K z4!*$0?lAf?j2;tQh~E6M#Gc{dt=O#^ELHHoGea){c4_de)>IH{tqVQe_v8x-SC`*E|Kkw@9Coh+qwGuIlIsDeI2LIk?rzb zf|36C+M#}*trtZ00xItSXR0yJyXf#9kJ0}c--#8u`4s#>VCSh_UknZGLTB}^C`-Hy zkI6SoBl!K|_wl`ieghv=+Dz6@$#z(DhRjXNcU^_wzDC{asQcH{-KFcc##=Imis0)= zKB-&yTk3bObyNIVcyrF`w!Q-;V|_m{+^1!&I8T@syAQ%1`-hXG6A1U7=lcyNF zv`xFJq&H2?E23R!u-WX9@4vT1B|Z^_uNZT&hE2`uVs1#rIZGJh;InNG?38ahrR%;` z>haTo?JtXd6j@_DDR{H}HSs47$=FHiS7m8>ZzN;xx<-6PowhSAb`N{eqjr1y!H3ji z^kl|1arH0HjNJ>}by{JTm1bncz9ebLhQKIg0`#G6T53s@v(u$NKH@qWmoD9K5qr!9 zAJjET=Jw=UG%{9Px#sq6jVCRKKhbN9pkeUHmpnx)uyfM3Sthu7u1oqO->hs!r~8f#1%@c?}}6;^t!QP zWHLAx`pH@);?gC(tZV9HF0mJXvv0b$y@LK!^6PuRTXdAU#3K*jziwna$2mpyBE$K5 z&uHQo|588ts9C>TZhb>m(&U|+UwQwOu`{6kW}#icoTMk~No+vWljQdwJ?iYEGak+2if$f|(_2fNvJB=Re+viem z*sjO1P2K4A`dDfy$P=0;BWJDYJ|+pG39+OXk>eSL^$zp7Uxzhip=08gt@E`kC*JI?u!U-Wd;j z<9uLF>*L3Ks(FvdFm2{Gz9)79-TVxEBj4kUVsjlIWdDZrSQworWAaw$wwGt*C;n0V zo*Mk>HRR>oh5S}@`p>B|dFoYb3(eOctK3`PI$*6qH}D^2 zOyKZw^HFO(Lpn4w`9`0N^W^(6W}8>9jW+Syo&+Zq$9)~$tWgo%JFy0*U+N2Gn)j{# zSUwkVd>w1(aaoTC9RKO`$WsC@~kko{2GtZo{FU$@4Vf<*#`A&>KP0UMt2C;p=Aih$K&$f;;>gB!U zlNihaSDv4cCzo}oUm2UzBrv{)419TP9xip{(97Pj@it@ZkRK*+_2P$hp}SWzZhG+x zYJhc5IuuR6XwcW{+;Zq4aZlT8>qwlNu z@rds}zcJnY4J{S#qRkB2L!XIXufN;*JLq{W{ir2f=vNCpzXA+5&ia)_Phzd5S?ZB$ zo-0_(m|!e>8vGA{+a2h;=4tAntnHO~wkY)%7#H;8D_8rd>l^5k@XE5pT*^9jQ*7pb z@=2RBXj9q>b4@3|#MnPX-aYJzkmn`b*BBppy_@*&X>S(uOr`pC?*ZC=&#<2+ZS&nQ^sDu4GF^9Ly2Lv-2ac!c zIV-nbbNcwK_;S);Y!~M>Z}Z#u8HU5sgZI2S@}1kileTi`hu9L&5$jvFw;-GH{BQR4 z2gDuZ`6ry)@3i68zm6Rh`uz6)pv#$;ciTtzI1Zm|^QyP5Oo+~vcxeTCx82se0es0C z-aQRW(em-o(CimJA(%k?cYG}TmW2zg|J~zkw>_f%nqyZczDt>gV<`z~ujZvI6A#Gq zOZM}ltbvo~NBJJDy#GNcu|uAJFl^gL>t7V#RFxIQ43!c)j8B~0PX`aO{uR0u3vSI* z*CZ;?Rbv=u3GT#iao2NvlzQCs*+@J(hjWU>mrWisiA);QHw_yh{OYt1?+>k0^)ZHV z?Cg)&uPgpyE@f80+vF=5xlXljVIWT}3Gr)Tvedbr(md+dmb3i7# zPV|NNIrH&v>nT5xc3&cp z`ZGH9Hu4A#TYjMGdOZbmPG?6a%e}-7!9jJ)zglD0nUpD}jO6d-oxrvZc=nVtABBGA z8)5Nix&1vU=EK62jqX!7hz}h7oM(bQ+x=EM{hy2*^t|I+!|BogkG(gKkNT?j|39A@ z0y7CvvI4<630&IA&_#BlUNeDK2jWIZ>vq2q%GFMidao(8mew{2xJ(+CPC=`nvbiLw z)mA`>y-J|!4aKEEOZ6@`0c$6u)gq-$T4{dI*ZF)t$s~l@yZrvUc|7v?eCB-4`abXT zKJWA1&hM?2%PAvXiLwh~=rG_x@;*?|xeZtfjuGH^6L3=7G3{&n!(veC#4K2cb)Gk?ba*0|6e z&5goOhVa40uDfpGXtJRN=n5}STR)$`<`!Jb(fp|X`|QA?*H{08M%Vv3^X5#Z{`axAUi24KsGZkS z4&Dqt^^w-GVk%s0{YiF}0M5Ga^A>mg_1V^zC%}t*@aAj4@}F%h@5{ijYmD`GJv{kW zDKDM%e1CKUvHXm!h3d@3wvN3gl3)(dQB=N#x}xkCt*kZZb^U&DF8)1hWt;Bju!FUd z6M5xS=Be9f+^l{y<#Es2A*=oo?$&8IZPi2ns^YA#j{~FN$?cU5zF^(SiG15Qy?!_M zGBvbMck*nUzVb%$G#r{ye@fp^&v47mSh+^&TW8l}%Sqj{o%F46fo$U68+|es`wQOWgF5mG3d>bLvlFYtnFNj+;J5>zVvl*3UBOSGws}u3To)=hm+! z{(Zxtxo-O0m9pP!*gC(Sy^i$xZuV8^o1*hs|`y_>t`vww$w>q zTDo$MNq2ApR73k)o%D@wT`68G7}#iF_z3)DEU0&E z;em00^tdljQJ_43b@J@ing6_#NAnOMUA8!ZSHGsbj;*a|Ahajo+f*rkp5>>UIWqZ~ zFWnI*S|geuTbB5E$M&-3Gxo|h>MVm+iXJGB^m*}()=H(tH$tQS(^{#ufd0H*bn*l^ zWbA3cH^oqe*WQqcO*3-Ff%qCH?rNv{LSB_o{ur@JgkPK|pdZNVklj_2=SuKiIRDgB zjx8MdlB@Wxa>^eB7f<9g8#;OY5S=^$oh+E~fB5--`03%N@OpCg^|zk{rv}}9PS4T% z+)FbH%swZYx5S~j~^fAM{8jJ#%_ zdq4Z!Oa7@B-RDM^)Bb$1eJ;WIIIH~1r0j~`d1v%^;>?}LgEe*gLsqa(JQMao*{k5%c0eC=Rt!AvTPc}+Cch7}-lNH8bBBF1^$=$_SyU6>Fa9>2&zBtS zFW6c#H~YFcX9Nz8Gxqp_dpNtY|K-|N$G^c(C?EFJ!}%U^^EFyYS(??xG{l_3|A{&*#=_QLmS8^#1=!NOB5K4rWF6U=!>5U_=@+9lt5rsk1+HJi{{# zJOaF50gU!whs!vh58yYYy<(>9ckzRmiY)ms=}V9+Pe-OaLw;R%e4@W()(j(4KJBv> z2_9E+&crU`-Vxuxw_l~T)9JRYGuKJ@8b>~r8{zz82mh0q%{J-JRZR=@+(-nP2w#S|rooj?VNPW0ws426&`4%9hn&Ujm=gicYm`p;a&1 zRfA33InGOOrJj&o(07B`n}^$34xYu39s1M`&wOHVsLY%At#S^`GmKncwjz=bNtYvg zE!lAk_EGFMq$dl=e#0G`#uW$>bC$lZwga_M+C9CD`==S7_WoAdjnj^UllUR_TBW(P znIey1Q0=RF8J@8!Mn2gcx%#7fyZwa`Y>DqvKEY6VJISa1>$g|0^vVZ-(Xy8YtFrhu z)DHc*+j`UD7&3FgQSgoVoxZ3{wJ)#2;O{K(w{BV6unh9&MxXQFop1T?IrBX+ZNA}! z=)d^zi_Z6WXTH6;*1T_oS8l^zM)Tbbzsos2eZDtn-mYa_!}C4dj^;bz&bQ{>o$n2$ zy;WJigj>bYg)nnj9F|-$C5ADua4+w!OJm&Z0V@JLY$_CrT&So1Yj|KhXE zx90B%dvV;(NR|+r?F#A)9`0RIf}F61wC&lz@80*nyc=ALzq)$K=h&CShf}g=TktXJ zQMoqCWl@HD7QUUn#a#b8`j_(->W@<s;qa&G);Q&pOu8 z_8{j+@~Qtd$PA=^Fk@hTw@-5J=DXkXVWpLM=z6{pyT zhzWsxzPp0hwe}Uh63|g(WLRM}ap4h97087#N8e+ah zp!2MQ%0Tw^LhLOfHRl}LhKtSd>)F?3W3K(o+t+*PgZA|^Jj390fcFKAaZiTX*Wq8> zeVsF8+P?nSMfY{?DU`hL0K5SBQgzg=|93nkzZ4It{rYNrQe?O3&_0(ZVBh~uT0aiC zWu1MWdy>#MsjR#2!?Wf_)>04qeuRGK{m{+-)3iGNS#oUJdF_3FEWM2*`^VoV(gT0= z6nxNipNt;wVN73h+xcc%I~c>}-C8^hv!@vU$s((&%Uw5b79YgAnZ~+Ve#eIXNvxa9 z%O`EC07vf+jfB~!-1(IPj0W6MF*9-6`lC_F&dE(Uxi(BuqSA|%E&EVRCxrsvYQC~-& z1CQDc?2hSv7Cq0RXL*Eo&LI0fLcIwWU*6AqfcJ-~&)o~98;ty(^q4!=;H*j8il(Ed z;kU-EbqTkEe_C$4)~VL$4sa~i>+G?gDvaJ%%_ps*=l|PeKp7i)d%A2y#1dVetzGge% zFH9ZGYj9Q&y4_itIgWVuTJt^Qlik?!%l<(2JK{@<=(8EuGOJYcb`bhhL*6iW;^j3w z&06f|nIFaGG4?XhOjBnX9YH^L-`T0rfqwx0y}Or|EXW9CW%DkZB2(wVjFEN9mWVau z)tL%mn`Bw_nc3If-i6Gm7k(+v4rXaQ!czlR#&dVDe^E2|to{}On^W-7-+ZLP~4_*yVSWca~ z4;4Dz2hWL|W|%iv!MrEHLGe;Cp4^YqQfqV9H~IV6W6CJA2_9OsLjBGJ7nXxpVR)$+ zyj0wtYWB$m?30D$>7gI$?;ddUacJ;pn1=G4{@f32J-YY}7tXEVgw~UxU(^-a>)cHs z`*J_OKS@4))0{w~+F#_HA{wPLCF@9K^IFIwy1O~8{%i1&<~y|NXMbZKPm8-|{ED3T zSY`~iW9K4$i0~!#9c-J$6J3oxDR#Yi*rx@pPgUk~e%+oKt>65EX4ZRdo+cA4|) zwH^;ZDSpR%wJeyMyNo$W^w>28Qp|c4Lls^e9i^Wf9NtpfhIKo$9QE z{O3%waM?{)KH-o!nh(@vb_QKLM_)jPSLSSR#@&fA^K) zJr0;0Q-9B;oww8FJ|~&)nb?ME{MMvvWxM@+pxo(?Yyj04*1-j|`+c+_Sx}N^F7#j| zT#-kZIGqkW3~bA%3bvIRe?dm$F?h1$*2)6n3uD9hLQ~~K?9a5bpw$=aU`=H=yqSFt z-k6w_9lMFWCAbS`8INKfY|+zlL9;Scu(Fdu2>d$CfYqfXL zewB~z*I4|VqhnSbQ_G8zJ=l@FywR7O4o`=^t6h9aKW87=KtIm9YC%R?i){?PosSk_ zFC;owjXsJ0eNPdq(&B8JK;{#)=Nr11X$O+MbL_S{#(D>KE04cDy8kSEz3STx9%DE6 zP$&AC1;BpchV}hEtEn;uEWr(UCC4sY{MH`7wNErF%>EuQur50h`UmbPhsM(0gLZK+ zdD1QOUCtGjV?X<#y=FN5+oVTMPv`lMAYh^zD?VVHJCYY>&-gvMx^|Bt~j3v-C9(X(akIHG@ zJF&gL8yI`Gw7}W;&@R7ZdJF#ek4D^nTtYv*I-i9GYF=uX7ujsdmP`2q^gF;DW!YJe z&T-3u*R0oz$7^u#mv!a(iwL&9xs#Fx#^sYt9GYcQtYjndmz$t}nw$CZAJKS>@3b?1 z$@q5AzHB%I&mGv9n>FmxwNR1&3GPDgH0`C)Thrc7;(>!h_Q7CMZD}p8blW;BIBOlI zwdJ+ptr5?*<+aZB@PJ1-?-^N{&(6dy)%YkxOuNOI$rt_p$g(1M1=?0T$$o!EMDZkF z@lR;KioPgLMyWH8ZeOOGc~8A1I`9lKwm%Xh;%RgTe}JDl1wWPYW1j^+%ctDTwZH6y zY#&4e^}7$6W5!h+Ftj?otXEF>LBEZ>`eJ+681r|JZ%w8H&!$Xg{uoy^?fw;>RO3dj zegRB%))8EdZc*@Va%i^tkUo!Nws+8NugAdEz_C%|ba-I-rKYv#_>};INF(iuPc?Ap zaoSV*=r+^$Rn3>r&T__AoTYg*?d_nwpZ!(zcFpDaoRGr0m9X$tfcUz zlXkyNyW(>eju_`qOab`oToW%qb|z-52c5QEAKanwrthf^oJa0^vPUp|IcWMK9~%dM zdz`*RIU{d!`*PhFeQ|UK4nFPx_Cx(yGt?gkSKT?k&<|&<{ltOMi1mff%82#VG;wHs zHPXk?>+5>@{J*`v;32jcSeO5AtgkWf;h-}{^h53(Omy&p@y&GcaKVTgTXOfTL5<8RG!DGYdZQ`gzq!@)F9A>2N*iAJBK#WQ%^r)v zUwQrwUOCBS^d9=%{QkYf#}PmHd-hQE?*YE)OlovUX}q5UKkbX24s3*7{J_2w+{c9; zInF*TJKqv~M2Xwz#Qdb+t&(eGSUEb=NETa`QFt@5fU2PH{fpxGXi=uLSF%vbbG{#r z%gvp+FhdKJZjlbpWa9TQH&tpcrgJNN>~eIY;$P#FDa%eQ?lM6686SPnq&k0nRj=-i-DKs zyPI=b{HkbMo}E=8TgC0z%qW)Am872~HsBgyAo){Hp|yo?b(~kKhT|m-$59d=YB9&s zvBkZZu*8*3aRwjCkDrMbcgf9f*6Ij6NaMTIZ*XfL^;T-U;x9#u;BQTA$Dwwv%v#k- zJNotu`b;2}E!E(y%8AcYzYKqn=6_qnx9!YP`ngc;4b`c24ZlA0n>(Zv;7~R2_!x2^ zjVUYK$asj&YiDJqkE`J>t4%OWZ_{bVTc;L&r`RqsxA#z&a0a@vC17c-nm7}Ck@0qf zkhw6ox>LwmKgbMJrj0Tht64+tnBc2(LZ8Ggei|`>-is__3gtWPeq>_VQWa zSm38JujYJaqTRJG?_C^^H2bZ^%6A|6bS|*7IH$5V{F!s~4rn*?b8H%8YDLb(`1cxG z!C3X%J1bkz&Zk*Rdq^9?C)!GfyV|&oHZ}u8%{%ytOfL^OjpeWF?U&A+$d5CKuc(1{ z5c<#l6KF2)kStnt1&PC3)`aYy{Y&=(mVMeb`scF4#Jv&i{7<{Sm^=06S3CCRI`N#Ilg|h8>&XZLk?g#CpU!mp5JJIX^1|Q*d zzBkOvp)c!v)8`qxMPK2~J2~gB^A*mUNBZToyMX6M@i)GV_xa-ki)#bceD!zpIBULi z`CnvRt@F*8cQxNNmhI4fh&isy`ieeYg5^)HZVHP!DmV!KVh_ z)SFqOv|TVy_4E=SN_%U=_?(+<%B}O|%+p!qPqepULtc*fkT2-n&YyP`ZL3cWw5_v% z%4q*u=gW5L!e>}~<2tK)5x8VzDC>NA=35EB%P7}6W&74i_N12H7qDwZjyQ-+eJ`@9 z1p08zcY-*h2FA?yci=~q9wRnV4)>c&&l5oY^9Z=s1KpKfh}oOdc%uaC$?lnyyn%TX z4t|$A$cl*L++1iS!_2GN2ovksYeR8Dijj#gpf6+f!PI9@PVRE+doOgZ5qQLXljkkR zzf1FK@{~_bI{sdH?e7@MbICkxAddyTJWZ2bxkO(3+sIQrFi1U9<{hRUVj_1WYHLit zb^_D8eZiJkT0aB*gA32CwMq}MjxGKSJu&>7BeRhYTDPmW)IBekL92UaSskfO(b8`A z<~V(pyaC(xypzCg+?yIJWrJhR8LYuB^fMN;<5A!jJM*57KJ*=impF4t$MCw(ilnc5 z;`DWh-Zmg_743}|S{)93BoScV?5p1j;APV z!QW_ZhxyfEev7+ou$%F>dw%|xN(KqPAYLnSE%$h6ZxA1p7E8Svo}iR`7xF*D^(tPd z;eF_bc%KR6k5g|h^;WNlDpu~^59hMS@!lo+edd}0`R!P&vsNR+$sF?I2~3IN17a=w zCHU8{g7`MHKmBjCKYCoxygcN`KOi|!G5v`0|8@2(jVI&3Sl@Bg=fbH7I5je!z+WBT zq`+T?eUlj5LNlIn$1f=gK7N6+YBR+%9fs%cc-Zib;-7?PDfmX|ep13c(s<%q%-+d= z@9uFW)O}9?-{0Ox_y!L-N9pi)%{;ThR>!GL@L^XIBNKcHmd{Qq?$pUs_>^s?{$=bH z?8}N%>GiLo&EL_>@9?!wdJQtK69IVEn*BQQSI6itBZ#rKqTGPlH zkbYci;;Xvn(OnNp|66Nf0{J(yCf0GL6nuY9Y;eP~jXswc`sVOUzzx6k;TY`jj1d^r z=Xcz@v_t2B2sP zx*4m>6Q$9{f8wsn(eS1J&o{c`5^Z@0ZHY&QCpR+kDEqy}q&ynahxopOGo?4CPtXVD z*Z1S@m@3Jm{(X&a+OwpKeivyPlUvWR<^0xsIAh9f54vOeB4zftbCo_%W%PY`AA0@s zluJ8*Yo0D6Px?G9r4OU$NpxRhx{+_*JWV4leV+38ojy;GBY#nu4^n2Vc^YeuG(SUf z67bwYCf&|DYGs~?zGv`Hd=T}*PZEa+xHY=xCuEpgUIs^s_$Js5?PqE92G~Ad?anvl zs=iO%0nQcidwm^VxnViB$3Hvp4mDa2#l`pG2N`Buxpw1LGp^zZNe+hhNOvchhtc=Z z2gy&X9ev+}()T_4XW-2FO7s3L)+P8hQr|}zi!zoUR&Si?d#nW?6z`nrpU4e zW>JUsc)|Tq?lw)|*Z)@jZ-8Uz`G@h%^M`ce2^qOX(AxV1{|W5j65#b7-Z}4Ws4)2M z#P)s>-ckES1e>$)B%R?iO&ppoVCAU;-}TJ%t(;cdfTC;kdP z{_7Z90=+!vrVW}S`JBbZU+7P8rPe9=de&OWPf#EH%>uPQD+upI%!bdiz7P2Pbrn2| z=nwrp^E5oUVhby#Trua)mBfEjnNG$OrrZJU#5qO&#Q4tAR_3dSv~F-rdtQ2Z!QG-x zuO7vr+wt`8Pjv$9{=ls)v7$?U!WUr)F6jIP;y+ z9DFk~`m$(G8+g1*^vdVNXITs!1T%xzq@{>=js06+FZpKBACI^Hi0Jbqc5w!!!gLA_m3dA=YD4oPEp{MI_3HmqNf`fOaEsh_}%sN z;T981(kj*2opo6Wo^(i#@-#fRY`UId4_3@L#d^~`on(DL%PV#NKsPcKV~A<9HedEni0s|5z3?xOL(i_VvIkjHDaLVI z8mvlOSUtqNNwygqSbscpK6GXc^ft9E+VKo_tlWc3%+AKjr;*jkrj@(q+d0Ru<`ffL z_Fnnz-xt5moT@+Hpst-0nM=N%ox|BQ7kh{|TDkDGm64hmt18Ov>@3SF4NbI4?^U~2 z{|{TiJ@BVgeUJ@Mm(Qv!ywu8F9-6Ug(WO>)e?#N34WzFwdFNkda6f$yiz< zx6rSme_6u4MLNre`L4Q%Po0!KHMqKvHEH4oX^jQ$bk0#>Y<|Ojr;gySu*c+nJfG^e zyN|JE>hTw^QvE^OzIzVeTBpn%r3}MJjmD-Yo%-qeZ+^< z7>fUT&2iZ$?m9oX=mzc;It4rht0|oSq>EsT3$Q~z`W(L8H_?{_w#~um_R2DQlEJq- z&V`m}Uu_@`hj4N`?RA~DvZJ(_;OvJFd2WsE_y@$#Jhdc1TKr6CiTeI4@<_I7Gak*u zXAhx=Sh}Dk#lGJjX3LPj7Q2-?$*1pEQ+DYMQ*b|$v! z8K+$9L-^-rSf#6XUUFs|W%}@a&!TU^I~$M1CLP`?-}KD3;I;sL3j(KR@-(2E(fV1P zw9hDS^F$|adOo!;`)lRBCb;5d<&*3|b&i!U=GL!r4fIE}<6^YS(IH>l24JN9iX*do z0sVI()5`9H&S%oEYCC#}YIcd$qD)=?(7 z{LCE1%Vq6R54!b;bnBW|*Z0Z9{S)snmYvK9J8*M>ocC&Qg!?h&xzI zTUcMJYZ7(EGpGx`APz2s-L)N|{@P2eC0)MgvEae^Eujh4L-T?4-M(C4KCOjy``FC6 z^OCkdu~qA1HasHt2rjIKUVMT+wQ|N54QWLtAEd6bgYZY3N%-9{2|J~aS^bNi^G~X{ zeLVCxY1h}$j{x!bTki~S3!bk&9?!&A0mmJU@XC;4l z03KquyMJ^3O5eY=J~l&3v=_qXpt~5pi|X5l(JL1Dp9p=rZ{>|2{pd%B*27vK`ach6 zoY)#Y;Dz+?x^v<_@Z&?wb2~7Z2A%l?d|C|H;L}rQ1CJ4Ne=yP#1IJg_%wIAM8s&Xc z|65(!FPbU%iZ)%r{?i5B_TV3;&zb|#z5ws{F-LL!*Hgymg`jJ_%%jqV@hSI+z6+koxno&tw-_j|&WckkI6!pA%pAM@H-tB@e2Py`sGt<8Q_Q!W63fBXZ_(l3wjeV_y@44;opze*>qI&dt#=+N~ORc|Q zzc26JxY72&uKs~_Z9%_e-^RL*h@Tbx>Sdjtf>$WJ(`pkPV{eN5)~x>tktd)-hK{Wr zrepAq5v@V-ZCcOsSFyNDaTvdb4da?t0jrCZVGi-v6nE;_?2KXTTUW!cu;zuS4; z?T>;RgT!aJo4Jg0r$GvtY{SXWlBX9(2mX$^70pyzj-N+f`#%g0-e+hb-=#ZnXyJ5d z;WTLBaK4{$?iDS(n7y!fzAa&lVeFnyL!TRvZFU2fUG#-BP-!D)5$_D!%NT^40n$0g zJQR8Z(kt?vJ+n>Eqx1ber9dfxX| z@mU3TN8nc~WTH+^kGObyVTAd3p4jz`#5HZ9Oq{&peIn$2CwaFQJ3LJh za0VWEyIF@}Xhop-$*s)c(TJUO_iA`88{Ng=A;+(=E2rXa;)j|#D&S$ngEhdX^>N0l zwyhlLT9B93?*w+(&Mi=1Q&#_v@FAY6d!J{zMi!m)Swr!D?2a_EH14;#Bn#=VB`f(`s@-Y?->gYb%q;i&XR(xo#>oL_hR zv_BlFVC>cS9VEB|)&?$rpl_$3Ly}YcKX7^#c~euaIX;m*Dfop!>yEz^;Nx}RQ+7RZ zd#YN;(XS1KH}9bC19|inpNs?3Y_9009DKnu{)v$n;lp*_Iz>D-oqZW6){@SrJD?k>O%9z1K_^bqj**|z<}X?2 zsafzk@Fa%UA)lcSmpk-9^2s7-zR%9jNuZej9(1=3kB1+0nhnc{`vv76;kS}sht3Lbj2#>L=KQx>t7I<_m^*P5 zx;k{udF{U>ehopbo?9Ub^=5FKE!Y201>?(;9Y)kik;f$!$*R+ zrZU!ft@}r{^_{e~zWI9F z>Y*)v|03zYq}%J6B^qxf-wIw>=xkH|Xoqyk+HXJ4I)9PxosXVfB3W=T=Q;JK6Wmii z_U3H)f@HDoC1>a+J`Z-|c?s@G3I?r}&FIJu!xK3+efg1>pfQ52>>IVN^YPJX<|)4l z_Dk>+8No8{-ef*r!YAt7hnBL|%b{t*^7t_NCG8s}*c&XT?v0nq{~Nsld|rv3(BKGr zJ2cJQ`O_-B18cU8xhr}48e$nne^6#;_IYuhN1oH2yHHpE%DD>_I%U@Nhuq&g8Mp9o zIk5f;_X}6MbXoJL^`9;SNY@)kF7!v%w$68PWM#_xcDK$Z>ZFg)=apZclngb>w=(ye z&H6Oo)?A)!XB^T`GWP7{(oK4H5!~q}KlPo=mGqSr??n&f*ochKSqk1MBb(iL>;dGg zjlkPt{!ei3*EjVkpxE*^V^_f)PRscXugksDR!7ZDtHao&lCJyalwWarDesIqU4M}# z-_>|UhXd($Ewh8hu0?P>i_eAnob}#|*tO8E^sDJ`_4eylV5WN%yU>+)Gp-oCdY7vw z9{_%ci*ka%vmBZ(ncHgZvG_RL&D?1(l3b6c(Z5JGJuKgIcw6nCigO{|DErVpjaB>P z3%p;M*4FRcwr26|I=3y>glWsWR}n{E!y{T>HL^_iUd4Q9T3-7{>5pP~IsUYfs}6zF7fl<;D2=vE-N@ykgYXlkJS(rk;z9+v~f=eP79Fn;fNd^>b|1oq)bWCjsuevYiK9fh>^CI(? zeqKzc!=vdNJlwt;)8=WKSr@JyoJ$`@*>Vlrx@n)qR%Pfr_MV~(DfmB!mW{OgI}Pn| z(ybBpSYCPWp3F5ay*|r2igRWc%@Ixe9Wf4Xm>KO@L)x3+2?NY&HFOTUxB6CK43Arn z{R;FDc|10b>dRO(RW>01N?*KoLm8o)n>aVBole@&URiDU1mdddH+(|3;S;!TgWu2? z@Fcf=AMXk9jJbTQ#CGq`hEFJQ@6V3Sp12KKmB;r7!*(zk=!upt$4@a}2Qx!KpE>&v z_i@HZm@v+e9jIR;-0}7dYzqb3q2I*#2d|Ka62}di8)yHng~n^275(S@o{ZW?=QF^) z3($S2q5BM3cHa%anG|C)rQhB6Id>>1-!OmftU1wD?Fo_>U<SKVdHo^jyaj5)zMIl#F@HoeTpXB3;QTu>>ugl)Ba#&bia_N zZc%)G;I?l${gOY}zcG%0;#~qa?Ny>V>3pw8=U+l+hiXV`kis{0~k=hnr#9c=KmaR=kELC!ZZ?p|7jyyDyhM;Co|nc@-z+RweiDjlpK zMh$zc%5-aw-jsf)UZA}O{zzxn9@ebNoaB2KX`)-}$Kf-<9Zd1_gZs|DZ)sZ_GSo0J zVes?|W`j^VaF~XCnU(uou;SI@*6RSuZ}-EyQ?9PUn9+ao~5t zv(2Pj4>~68!#Z!hNPjqknS0!d=%3ox^WX4E)csA0dHxc1DVV%i7K+PAQ0L>Z%am`~I#=-+~!zUrN7Pi<+!Zn6M) z%cq02b}R#Y(p_M!zJlQx_T)WB40~eZ$sc)dC-%&*u-CkVoN$nDO`MrT`(GrDap7xm zalihtWIk{EnP`vb>uC9&LuUn}E+bd{@1XqK zNG~G2W>>ULdR3iqs+pfgXsnHHr;&O;O}*9b`Q&@N*YG_keR2~%`@5_*#fjmpawHFY z3tG?LyB)gA@2W3DVb8Yja{=OZ7~v zEjY2DMc-=JKkiYx@CVTT0r3vOV%p~XqqDJWZpNCE-#sE(9;`Y-@pJ2tr1S2{2uvGpUr;v6%p_U$KtF;``j})Dj)6Z>^s&s##7nzh;3x`&mq&n2W3EegZ6Z94!Uy_ zTVrN_cI<3VZt@wM0@?iZ18?bhZ2CDGK68POWHleA?XJtBZQT2NWHC5p#@sNjP5Se} zhK#ns`PRVTZo720#_!r=j2QnZcl@L5BfRkkHGc98jem5$^zo1SX2y^0X7_x5@)G1< z=a7wQ?A^Iv+A6#Wb-22paf*e7%|5@y_XYx;x^HHI#(WamDH+T;%4@vy;ipo&%S+>Y z*IIpo^QD2`K?i<4z)x#j@Z0ecw$U@AZ9(*KbAZjDFU#OsKz2hrGn3ItQ(M*$KSgV< z96hJjhxUy0`hVip-{jQq)ty?q)ae6rx|clA!w736dGN>hKF*2`ytH;1>&TMNYeCS@cpSB_Iynv?>e+gYO{32spkj_^wp??YN>yb-1e5K2WdifS&qaJg0n^B&o zEPUe}%DH@Fsr;=x9$;)?ZK-(jD&igN zDiWVyCpGuNSCc1=@BJnHhDPE$V*Iv`on7TKwBqb4f7>9mZg7@e`k`Nf@Ba-tQ3lQZ zAJGZcYd3wrgLTb$c7QP^uVSo@4AH&UNOoLl`U0Kz@pEtgAvjdTTu6?T(0*e(HudHB zC$(}e%inor?`8t0)%%@0jRU}f-^auQ&ZE6=0i)xbACYBuT#p_#y}oyT zWL)xo_LCOsd6s(aw#OwCvk$h$XE(KOM=rS&zCiWGNpHBbskH%|I7r$()T#QGsy^*U z>L33XyJN%4Q$!y6e@`IIru}!E)77UezBN;q>WO0)AG5LBCSAWP_+8`r6V#;n6Lk7G z?*Jp|)Y8uvp?fAf{y;k>8$YGcwIg{@ryR{I3q_K(lbY7KOnmNGkD%M$|J+=P@KAhv=IjG*a;vHwjK)?2aO!HVX`$> zd(((-oSi*CSkXc4Ih-@+GM_{F#P8*@w_QxOCK@IA+OS8^j;wwhKRm z58vxB_Okb60slC-w0)`7zdgquDB=6|LsoyLoqJ?^0cY%*bxTS(Z^sL)C2itwPyzC{OF-!-&3xakeZwygGQbkJe;VR(eP zPW-ZBz$j4ez@Z12nstt^SAf3u?uK`#e&`7C635l=2Jf<Cl*x^-*m1KoYYqQ(@u=~0Js;w6Wgz);g)}buUk%AVcLq(mUN%-4ByJo zN38mAT0SSwjCnP-KU?{(qMX{6-(K7|v1Rf{#>pNkTjwLS{{VK9%yaS_bm%O!{sMbp zL+6|`r11UZCBC*r$OesU7rM8Kvz+jGHuO?5M4jsbtovX_v;&^HZVmG)T0f0GSl2cl z+m1X_{Qg;ZhI7y_mGNB*o>S%xKf>>d^aDQmLghv7b{h7wWskcj&=A;WYZTlX|u8Tj`7P=v%OK|%C+&Y`XMJIF5 za@&WxA>BTBSk5K=L38`E4zEr2_u3u6G=Z-Ov~KU_w?_vq1-3hAubn>YcPsQ)GW8vt zUH1TEVxF3@$6p=xQ%V6JQzv6q-fHR;Jl9gk9?EZiJ9-<+K~J)4UJWE#p%>C;s+}K_ z=QwREzmXB8@d&{`YOfroXM3TuiJZ7>z17}>x$J=+tg%@#a4#vpRQuySoZFM}%dED~ zp-(yqjzpQ`wM(6~F1@zqBass>E#jF@yFA*tlyYjr?zueq0Qr?i`@mTG+PUDnBfGcT zZ)Hw|w|P0(Wzdg;redx8%B=C+T}NE^*1NK{1#52IUuNgkMWKJJ-R#x*Zd`Zh;&$|x zQT$qCqKiEaf7vTN&C}?*B{(i*H+Q9zP(Ets{4-lM3?m%BY z&U~7>JR0lQevoH;VRjH}?-sK^RhEOx?0Mu#q9-UtfwZRWgk3EDWtp zL3iiaQS2rIbus!9z<<7$v1IYzx}tUobYZ39Znv(8XrIWgW6ni`!_eRo;2~UST~V{7 z4EyhZeJS}$maK(NS3`fZ>9_J!GdAx$$Qif;zxSz{lYqUVBY>RFVoout%=?5H!_=WM zoMY_^_7lpBvAb$K_66$t1<&6w|E=@JZ|j>BARZ&Jz@-OdEE*GQudbDGyo-Jv$QW0@ zl=sw%kD0zVi#8L}Hnrl)CCU%2%U1rw$bxDa(`o3gXyC6I^JLzITkCgOC4#f!ii+-Q zEH}-wl1KP9+245VS2^@0GI^WeB>LU9A%0u)Z0k0`DaklBf0KX%W2}_UW(Q*$O9$=A zQHO2d?1(v|QwBRw^hf^4Hh47Aom%db3Si?F{7AGE{HqlXAq!d{9z#0m;O}a0i`e;@ zg1KE1dHK6`|SO zQv%KCt!k_c&+aOWBWDP;a&Cm?h-cB6J#c)hDYt`i;U~74_Zr^gC!BZ9MZo1Ns(JT# zjB@HNwl2+yX+5p+{MJGzl-IN^9SeQx#okFgiEw#zzfRMy82w84oPJ4{<@KjKtv}1t z`okG(s6U=&}T@yg4`LiMGW{|4oO$pY<(!ZY~^3ilu9Eb9FRNB5dB?sUc|8G+~_ z>&xsJW7`#b{xQz}HyTFj<9g2HYF9esgn?Dwe*;#;GzV4-fz=M=eYZ1y@ww~Vy2X?3 zGIBu2X6VJeW=$Xan$GmX$)Pd1_b)K^(fc6F2D$23{ua*IBwIzM8aY9mk!Oba8s;Yl zo*-{0vUbhQS^i^1))pg!@>^%dIXIpz!hgY^7`wx}<$F#Ef^ySBw;2()> z26}SrYG6=JouU)(=UwHiE&*?;mvw05ugW)@Z#(XF^1YjPeGg1_+IxJG@&6i_>MuB= z*!}_V(DC^QAone3|0D4VI>n#BhXiY0T2gk7cn#B|w}W$4t>_D0(4OMUJCctqNoPL2 zpSvV+iz*Mzi$>cbOGzH_m&|? zJ%sI*>Juzyq}4T%x?UhgZi04IR{?f!>wzT!hZc0Xa`w2^x@*_Dz%Dq_Nd3j+J<8c# zG~yQUMLL6A`XG6D6W_JATF_}!qiZnw1MJX6A6EOV`qkJ(_xSI|7CpcHMeOPtGXkyIh+X(hSf2Z+vHLoMA71$Eqh+^<>F{<;*(*C3j7HB&}V_=Io&_S_@hiXE~z^Pqt8>V8VIf%r|pb7u?$WEV8f;2-Zl#UvMuXcZD-q-aPQT7JvASO?;R`&u!w`-u$ zZRm8B?>FQV9TYD)*7z=Ee4nJ8Ll-=`saCPO3g6-x2YYq8*9x*kl(H$iCmmW}cuVF0JIi&ILrTv4_h+&@K-%ER+ z(h5oA-%G1h+8asZ-%ER!(q@vzzn2zM+GV8i@1-qM+9J~U_tM^`v^SH+zn503w6~GQ zzn8W^X-i4t-%Gn%X~;wp{CjB;r6E6&48=>EO`6uyh`4TPats46Xx$LJe3a+kE1$1A z$CJjtmo`Od*xw}h_tLVIb`@#-duij9Hjgy^y)>J&3;Q#YKh_#-pO4-v`YRpw zxlM_!Pq6MAu@!heh0P`S+~C>@7+R4gs~K&#ycyo4hkCG~xlhmPli26;-UKgGeF*)b z_rBDh{7>GsPO1-$likpL)w`ktkJDcDx1$5c^lXm~JjT=1voRxypS<&a!}#Q{hw7P- zJmS3{3W!EIbuP_JqEo-Gy0U!Wfah+wILHK3XPwdzh!r|B};V_nIu`AG&yyI34?feAD+LJ5b@si+(&(|6Vt)?Ugx> zTzvN)$;GXs+;5f?|K7tKa0e57i}8_;yy72+&qzk(tbcr@{paw<(8CydtUUAq4ft=B zU^^gLLoqgi-r3CYH`09(d6C)J(8C8sZl#>|lD9CHC$Q^lU$?+OFi|;A6#<&n&V$mKi6G-1iVdh7TBBk>Q@avSBBojrK@{e zAKq3ON4~iZ8H>(s!lAR&tFww=)j}2Z|pEf zf4l89zO8?aZ;coKCR#D6cuF#}+mRu~?A86;mE8vqUiD7S9lxY6&8~i|IZZznYx=M` zue`Hqb^pcktZ35t-&$FR?8>?)I&dBE9ZSxjx#r%#ff|=~dGV9FWn*}=WW~glu%jK| z!NTg>jcxhf06I+izOb8fX*FeUMy6GL>&S1vbHDva->Bya_xEw0@r_O_Q`HN8E{uOB zI$#a>kN#5M?&jV09X+h~FF5bNP+7|SOwW6x1M}ds1-q%h?$%x7lIx*EPk=iKpWx^C ztT#e?JAt3q*L{@jByA7R#KsTzck!)}xQmT$o*3i#F5gbf8T%M`!K%!UXCz%+LU!!@usj{xHiP3Vg&ffki@(wIRqN2JPcrvz z)@%I3m7xvv% zuuW}CM#8-n<_w4*?wNnex$fm%)U}KAgZ7L@AAWg1aCm;hZ={_~Jl-<~TmwDBvQLfC znv?7w^QXbZ%Pl5UPQglJYFbA^~NZ>$|yPy$uQqX{kK93USuq(8_Ea%%$d>R zEZ0eFaQPEa?*i?4;)@OfQ$4GphlGv(PtM0xjYH!ZfnRBUS^6e95^X*vJCZrv znQ=Gs70bRB+mFDbtFAn_+Z0 z^+|?29E%&Di26?EFEou<3VObk`;&lYsLHC}0d9ug@BF4e$K)p^I0bfwlU6Y?Mbdw- zQCuPCyVVmm_9O{stdnRMzeR~e}dwLc!W}b>?yZtK8 zg-UyybN_APdTXWeM{(r3kss2xm%xK!@~(N-k&`Th-T{{!>4PqIZ*d!IASNC!$XsLx zS|k@lj*3r6UY+1uQZBwUvu_Q$K*=5s!-wC3KZ+;+xQuuk^2uHdyx}n`4=|=_ zRrC9=$Vy(M4dC_IblXZoTNi}k0kgoVM}2`uuV?Ow2XLmE^?iaftHzmPoPn85m4Vrh z7bdt540+$c{#N941#7m-0 zuRp(`KZ5Cv|1LaqF*`L{ENY{#m>ajk`k^x1q%vyTL4BHMs% zF8lKCG#HaVrx6B7YyIffj$BKDirw_vUOdRuvxGi#>K=>BPar!OadddM<&tEwOJrwcI8 zsqc($n}ZJe4sy)!S_78xLp3v(^| zg9F%%R6rxK%NRI-Y;GcUd%r?gq_HV)mz|M}3~;CL;nPd5BL4|{QpNUzi~3s7Yoylt zl5uRymG3m~ef~+2D+aKot2u4#He%S^-H(1)HULi{XSkBJEdQBjRW84C$#Q#AmTWp! z+XZ!r!zD}V=m+*_$JDm$z=#>ua{97MWZRHjJz$l-i@Mb2;BJ3gOm%X9YYERK$Sr&g z(c`C1DV`ECA-|P;^LXRa|4?;4^qI8@-saW#qNN&70e32Qu}-%i4ENPdVK1hh!QYH) zi%{2c{@JQZocY|1?NP%VVm7gsTcPi%`PK$QQ>Z(=Uiw{Wcox?#A0NgA zsw<%-=k0B$iN6tLuaPa`cH*{u9@v9#28Rv{ziQ4d z!JZ~Nc(A0U4_vARj~?Y7>(%zezCLJl!p_UWN2){oht`Se_!xNT)uA;a{GMZHwx}+Z zZ+FXQkxyqH;j3tD?@ab0zOUeSGyU$R-o8lIwm7&U8z#-U=4v!;?Izxb;Fwyrw6v9V zdAe+rtO;2iXB>P8e8~sD_u8_ivFysWQReD!Yb(C!5|vCNH)LjCerlfDc7aY5>{(Gu(& zJMaz8N=>jhALrLCqdm2|8(YV*;M$X=7=*H6iw5A7>s5AqigLB-U9qHr!w0}l2g`8XYWoHL{AA+ZN-x>Hp zr^E6Q@nm+^5kES$A)46URQZQlGmil$0Ztd(Yd<}$or!MS;>XNhg3Lx`+5aTBiRk?S>d`qPKpxA@ zA4sdC16?KjJiObXi=GQ#3okzaTnGKO;par(WY_pafwf>h=gmL-rvsa3d3tBWuewyo-E;+noX9PcQ`oL_f-!eZU^-fD#x zv4_id0vnuyNEPGK^Iy=d?7$vZb@ft*?of{e`WG!g_nfnRo+KIO*h`iza;C-^)(0B#Y<-p@Gu?AmY z4PtX&Z_&Qw4aLxf^m6yS>exM`r#(rUsd6%fu+Nv zoI39AMf6SkP$%;63&t~_J9nrjjJ)ZzAN^erUn}ZcPF-5lsR`&Y@JnP5>S$yPx?|mD z43*%Sw+64}y_NY0ur~h@n3eGR2A)H64*uM2y=hULy){(h$X1q;C&4|fDzlJxt!v`+ zaL=7x;hiJF_2f6d``WZbG39P>b(F~B^4jyGOXlQ7m&7t0e~;x&R(72CcQ!Q_*6=Rh zjyUg)=p`G0$4&4nOVMjCeRXi3bDna})CuTDdK{wy`sl5zf5m55I*B0dm5+*J^dFqr zWIyL;K6qXS+o?uCUr}VEHXAR?ouQ{5FZZ@^s^@~Msovsrc%YJ#-uG*u` zo; ziS<~e)xK!QJMgqn0<3K<-<+RJ8P~gY?qt#Cf>Kw56M^O+qscHGmdbze2@Z}p^S-!U;PT- zwSLs!hRi897jeewV%?=Cy=n0i_!MMXt(C|Vv32CW_)CasJKmQApH|lmz00&7M1P!F z*GW5>)_(I|JdyI5z&?w$j}HX2+?+Rq&|B`Mt1sq^KA*bUpy@a8)R^VJrkEi2{obtW z`szo^Z$InbT&TD^I~b>6A^CDQ@5B|ax8cb{_Vl_n{MPt%HXYt;rbarzvrgn&KI(V& zpQ(|(q*32P;?b|>-9o>*m~w4*g;rrlF%=u{oWsOxl0JMVc`i%CRoS}sKIMGVT&do2 zv#(8!e8a7`8X2KrDZV_t-7kCJkrl4uj*|qi6)ZJw$%O?+!KsI5iZ+nxbgbgL>O~~NnF_*;Ku~7htHca&21bQtjfc+jk7`BM9yfA4Dj{aw|yObz7?Hd z{rTYo*h{DDcf2(mfc6kimGLFUTQ|dJMdX+LB$a+FL%zZ5GW-$+BlLsy z!UgVvt>4La$t@&HXy%#2vxcYWIsO?&HeY5>Gkqzu-(a3UaQpO+^eGNrgVRP<*+x0_ zp@gS=WezN5Ea2*ajn4ge2M#&+;~ntXCcfqYpRc}?{(Qr&@4fCAB|{9F^$@I6j3V}_ zyf}4=|BLa|c*Aa60iHqPKE=Onm&oU6i?zh;b@E}v2B37WecR&L1Zx`l##-TpXv1k_ zubmkVT?iFN>l;argG+%m(@mK?JG#iwpyew%dWlaOu?sS5ttE@qCb5K&Rj{8DH>y@+ zx5v+`pP*Be_TYo+NJOYr+J<$W1eP5+jIt85kzi@FJ^qU)m9rM zt_N%3%)dG7OgvG7J?kZYYkYrYeDZ&4Bu)Jm?fT=WywB>l%UAtH`vdSe{SM;QVr$h! zIeqKd{PvPmg~fef>moto-Xgp0z=v4=z{gG@GZephEq-2Mo%PBcnXk@?;vrwDySC&H zS=W?E=QYTD9AvI~7e_lLLIc7X+Dj(Z*{tic$hN)mi#Av};_I*V&xojv7em~uCfOwX zvRAKHpZ0)e_IHE(?Cru6;fs;~gDdI#`yBdLgN$GMe3<&B2fCZ_?`7OCB7-yS??iTK zY>ypTOf|f$lkWLIm7S1o;FFXat6gu;mnBr|_Fca?h_xr4QfkDs7zaOK8H(9Ew(o3&KRZN1s=s*{~_k!ULzyA$lSv_9=nDA zFZ2I;$Gyw<<)Lv?|FOSv_m*jLOQs)n_pV)P}TdY>!-`H6BEccCs^Vm<|lbUOamK1+-{3?8o zkKV+&Hg4OJy_H6#Z=;Xm)%3jl0@$YAdpC4{m~-xDFVML>BH7w*#wPfNo`A3a(e}d2 zsBa>Av?z9+Uix?GTOYVn1H7(-uMgwzAzYBZS?Hj1Pjo`{{AKkLcyh?Pr<4 zQ~2u~hu6=w;0K{cI=5d#TeP_sc-8A%5bNaL19V4aoh5zrzv={KRuM}>Yv~2*IF?q& zCh8EcGoNn-tcgbKMsB5!TY!n?GeA77ID3V~y(fZAfIO|lQ&~FBTB-JQ#yLQKAGQ-s z(8yEpOedjfUuDmdZCMPswy~B3Tgg@y*=E0A5_%e#Q8qw7!=xD){oJbGNq-aKi%D;W z7ZxvHOJ8D?zt}xCYxvF>+TZ(a@melS)9ma#c(O+x4Zw@V-e@hjoaY3d6VdhdF_tWR z@gw7+9oV**c@6L$0>+}tluM@Dl|73MufDGUHyW+CJsu1`S{UA$IYTrmFb>{~SgpX0 zvcU_=qUSp%J@fVqCvNSZSQ80iDlpz;=500mE1I&}-_0DU-gxlWTUj3~vmThdjXnDK zq^3zNDks~zICtM0o};swBPHG4z$lcvGoD^@D%)AxcKp{@38~zeqht( z_94sd19y!Zo8~`LW|=!je+oXb^>jn@2VFn$Z+i;;Vvv5dssEd*f6!$IT7t9v+y2D& z6#tx?`&y~@{=1^bzfZo}J11{@PT!h>?Xs=XxNEFnOBput=#7uAKwnhC8kx*~DV)(A z^OvI+N>Ns0jWDj*mDB+rmjyng?2Ih%nepDV|If^i<}GGVs;HaYvNdqq75fM633aoW z!-n#|>(kySo%1umfO?O$QWo9vag~qpAEb^sx5f7xI}OT(%jdLY+LyFsQqOy6OFAa? z@mXkX7v*xBa$CLyynn&}N6rqi)kiy8=)-A$R)n$D`4~4iX8Ikvtz^HxgIn}5P`8XR zVo!{3m$g86R%6Ccv%i-0rF3jFj9vQZb;w#jc43)ws8q0j1QB7e=x>yMWpdu{l2^e@%IkvUP~*mN$6!+ZN4 z!rlUUC%JJM_W~Y-?~RjB?V7bj`tecspd@HVI)?bG!}p-Xx#Q$X>X9612XibrkfrA& z*9H_Dksf}VHj8zRlP+vVdl`2ZS{to}^QjYBpJ%??c2c~6dGCP+dhZ8i>*AD~OSx#H zxevbbFMi6s9K9F1ot?s-$g*$zM&|kT$9v(qB-2@468%fB-zuHx>pmvf2e=QX*Z(>0 zHwv_9jPK+>fq&kL5-X?54rJX6%%*hy;~SAl<=pgY_3;7rsewJgk`DsspzpRfhLMkl zHiVFYH5YD&wwz;4tDPACbEv0}bMp3MQ|i}Zhm)HBM(KAuB(Dwlc2xGaOz22$p3rdx zve8V^p5^;<^X+8Y2Ws~x_?PUl+>31k4AB)-B_5r!vYG!$cV?`*9J~n7kMZ_|3fept zF8;;V3~;xXI^sOTABgXVcY^1^?!`Yl5`+%M@|RaM+rf%V&Pl83Z_3~N!8SW9tL#^H z{Y3N|0qjZ!p=a7ZbZ^ljzCHD8yPow}^?mC6CALJ{q05c%ED6>%G+<>2o2!lB$Z6Vr zH*Jdc$sVQ5O;3>?_<%zb0~)(MF7vRRk(oLB7lq;Ce=S@A-R&b!?FX*duf0a~3pe{J zxRa9k9(WIS50rb3wW+a{eIUGFdv*xgvJ;r-`-{L?d%Mx=@%|O^zcj(GJF12pNC$6;`_ z)y3DIfZ4CJSG)My49;m?1;9Ju;b`0of^%i$J$?E1!s}gJYi91f{wOB!VQ{WYyb3fU z41RccC45`q;+6X2;h}IT?&6{FCbl7w>!g+JFHw2w^6=|f7r%r*U7vxcg(p~lSH`N1 zcinYdG_-rqCCNSC;@q2K*-z> zNUnay0O%W zgZXh_aSGWp`s0o-5rgHW8B1AXOFLrMS<}8$+`qW>uGVdZ?9Cr&@UQBa&OHyv*t(!m zW!vCOo4#78yJT6rD@zXkeR6&<(Bi>(eP*=umdVl5jW6DHJmJgF5-hKytr}lcc60c9 zO-~BuyZCMggDufuUdt`OwYP6s2lH8O3Ml><^R3Txz5Zmk@Yg?>HG+`|1N*6QXb=2W)A803Ub zpSc(H{Pa&9*HuF&W9JU6Y(V^jkss-?2F-U(9^;;31 z;u(bZyF_@{KlClzpU`<^Zf$HrIqF3@Qak@s86v)#$D5bo(@!>S?CeyA2e7`O+6vi` z)3m=6`y;4*jKp^&FMZQA{AcWyFr(dg6?UH)*5-PjXIgnrIfymF4BDsO1LuFD-FU;^ zd1G%&66!VC!%vW3N4@s`NA(*0KYP7?9OdC$uhBN!H=w?L+|wyu*wd+a-@H_`mo}n) zt+uz9j`sEv+5_?8nJwB&i0luD_5wE%FKjI4FaoJgP{LT$oCQ_ zd(pI+?8U}^%U;Al=U1~AR+Ldo_Ch^toY5MoeGB@) zX0{iDP}hE05EDAn$yR*qY%A<}akUkWyc`y`qN9_o=qPOk!b)2KjNcAh(J{04;0J}R zcn7wE@<+Df?Pj*3V`d%gTSj~N82Si-t@s6Pp7uaF+lo7y*@}+;maV8>_AG2g|25SE zd|@jF!B({UldbrLZN)UU6?A^&9_-m}$yS_&tX9|x8t>9`Vj=7WjXfz2vKKhJUDyi) z`aQ~Ctbo0sGJFet2)nIN<%js*+uGb#JPiBa)~WpV;9bpM&}OKf7@D#8^db^!S^qJDyd&-)VO@Fczt6@9HPL$O(B|KQy)Z9+k>wxR?&rt_r$WCy3?uoH; zOZE8|oR>nfUIfK=1<+5IdzYH<{62~22)V65-+}5c=0i8srRvw!VqIkP?^u(Cy$dm7 zz75aGP|WF_!*kV&u^H`o&&OFnhj0d$vTgKyi-Qf4ZLqD&GtSpxgOKOHdS)xzM*9M2 zf0bQE*drk$(pU-^DGwzW_d|~9^bQJ*xAj%n2L{V#{{6ts{@9x2jx3zXaiwol$o7YUL2^R1Tm0*0hmiX@fOK%tMFW=N2&K1fKWb zV$Z_2$Zy8-R~~M{ILjAxe)V$qnPxnjyxPS2WO{l{S-4kgZ^pOT*T9{|e>7kHt+pkY z#(x<&;}h*;`X2PP>+oDIcMCX3@!^ch3!x}S+ zzH!5CCNbwr^BlLfmggB`&SYH$Y~R)P2Dh}g;PiIPD;(I2V>>kM@S#J8h&uMA$$5L) zOGj%&^zLgu=GABpm)2WNm@Dab%rW16{6)1-t@)fe=ASQ=_|N##dw9k2^QiRY%{>-W(+jZw}WN`V(v8qb6Xi$GqU!i^PsgwVJN4C z*xNA`ZQO#ncgP!7eo?OXT7maqA5jC=V2zj~?@4U|d-Ul!3HzYlQ(H^#QP3K5DAsLh zjhWV0X-$>JWz7S*DDy6zQhUan4h!F~?X%k;m~3*I|urWbtc)KxDju6n`V5a^}&Kh(>Smh|HD zZ|G$l>t!_Qh4#e#m0rYq;!-F2K$AG%Lf^)HCdy_Q=~&3m?o?+=P>=P!P1`UBb=HJF zq822>JdSq)X)Oq2kQYm6JWhSny{*I^3DohLUWn@?%8B-Rl;HUx_!f7;uR~j=av)wA z&E@op7T*dYnaO5Qn{!^L(YK+Yv%q_OJOgdEvhip*qcK6z`K1L>05#1pVpbsu7+ixy-*zz=h+m8 z_&cBL;fOb+*|+@c?!{f3`KP#5n(Et!bto4~+k8^4ZK3?cymSTjy3!u2kRgm1{vdNaOv;(_OvXV`P7 zBP+09j?O?Fk7p3I89ZATk-PlvX~*qj;Er}2wgYva_LI{4K=e)=?XUV8&z^ehk-)dV zu#VaRdmVzX&#Ke*Q`n14&%`xu0ht-gLjt@|zr)&~4}f;7=~f5RItbMt$6gcpt`yay ztF4E;3|X4?;ruRy{|W21(U61Wh1}b*7J@x-?l_m%6VK;XVZXY!4m<3Wj|Qx#Q$FZ9 z1DiB>O(*o_5tjUH6*}m=9b>BvwBLyQ?17(5tU)e8xs_sXNT)U??61{^J%DeQVefUO z3G?*uv*-}!yAj`_0kC~WvT@P!Y?SC;a&I!(FaySjB%!nyI`##9k0O!>knU8*rWr*>&1)lHf&W zSO=kA(b?536J#Zs4nrmr`oRvFJ3!{ncA4J+pWe?Mfw5%uEzM>AJ9#5n-k%_EKIBzr zuARglO?r+UV|ih-o1MA#GW6g$V~youdAC9y?6nwX!WwMzcGD60Q)jZ#xjbFMI-<=` z-6K6v|7$2@a6W5|#+-E4+L;gKIo;$3`y+PXT&-s3v6aA29sJOqI~tFe;7>g>lVA_f ze%77da`nEkwCBywIZ@{m(6?gFl&(Saa7G?Jh z>;iq$88!lY$FS!RnQxo`gspfy`25@KIp!7>u&v< za>BPScFe^+R+#o+ZE_FB+36o|Mn8UC zQV;Ed8RO{?_u#XqJ8KEY+=4O23Oaic?}?VeHZ_PdjO06;ypMUi!F}w<*k`h+;H?dt zkKwE+@=xCZI19UR27BGM0BZ<)w_DIb+5>}m@}sM8#zCnyEHVb~G-GXiXAsT}r!-5^ zmp_YkQ30KsFGn8>Sl;nrm1Y5Cp*^-T-C%pV_aN?bNb4+YLy~)-NNb@k;GjGsp=u=7 z1dqa&j{xpLs97H9yOho2QgSEZ+z668*8Q*L{&QS7Kc4kLa;dofi4J~(96t+v z1)SZ6uu_+S;@#Zl>BuweRXT^EYuaO^bZ# z_Hm^5E7ER4+B6On&q#}F`kh4jRacsZwL$)b%py#%_$KL}<(2+x;h)m+at}Coc8+OV zgIn-H8iyQ2I!W%G#JiPC&>m0^*WKJpTldZ?MH9Av3w1 zgqY9m{6^Ta0q{@ZsgCc&nPX??Xxos+(ckgjX#bN`1Jp9lVvs$dIqpdNwix?X4Woo=|FoXbav*$L@}P47pp8Cib-)oeVzqhwZ$T z+79-SQatp$(QCRjA!tjQH@?ROnMk(p-*@!Cw?G~f#zJ@((LVn$`7zk8+i33^-Uo2U z-W=@J8oNTfFb=kc=A6dD7KE&jXQ_m0rjb_2cnb;PwJzvf~3flE`!?v{ zKj}MuMEPi;?|3Wr*Iupf_@R$$-?0Pr3q;>B3bIw15mq>b8pgytNp&0Z{Er8cHw;|e1Dnt`Ze9^h3)}t*i4)=igcQua2rYA zBc^du)2*$mPrTr&qK*yQhmw zIxNp_k_Ue5^0@kQmdAxBg8Ab6q>V;Z&pl>|swr@cEG_N-r`{H{e z&h-N0yFZW(&*#8fS86YsF&827-NSv|Vx(8q7U|*LG}vm4!Q>hPrH6Uho#d|r{28n9 zz8`D?#a)N*6&UcF!cmy=D<`T|IO>;|Va!2m5@+$9-%>mm5XUZhK9c;-d(SB!>fFs* z%&lXPzX9bs?Bq=GO^O**rz_x=O#1F+DyDHN&HK^Z?$ypAq%|0-XH+-IHcf%PX?~0B z%s99aZxY;^F!#LPO*>eHGqz~`poGra!urcptaJ2$9~vv3!MKZ_DWum|IY0EA*J*2E z3p<2Gy@$EmR;CMH7$4HyLeH)1gXOrSL)Z)7i#3M9&|5+f`1x-c4pJCOBOCon3P*n3 zo>(9JB>ScFU)LiYy@oc5_u8qy@(^%2>+wPS4ginp-w%+j2V|l57rR0ZawB=Ej?#WN zoRjm4Y=bmT=n&?GJX1bRNSpB9ZIlk`zfRUODsuzYp_e;Et$tYcMKb7JxaiPzx8i)@g?^=*g*;y2`0kQ+VIVM3Bg*1B z{@u=R%jN|r3j^Lwx&e7Kw=osNCJ#S|z7y8X@jbuDYo?*!dKUX*(O+Fu+j`69>F}4~ z)dlbHxG$pT679{U{%%H_uKpn_q+1r;#Qx*<-TXuLx-Y83xhQwTtpPXnYtS#7Vnja@ za|qM>>wLVw!#fAq&m9=s-ZZie_P|cj;jFbwd}a;i@5&yEUb+u+e|vPknJWctefG5B zp3U#+bO({gz;|(O-?!M$U+obLx!e|6(EqK*`$RsSeZrbFue0vxKhoZL8gG>ALZ?hY zeqz0}VtV%=rj1ryg=ZYSyOcruhVkx_mFiRUghf3;^>_!Io>N}h3cTA?HskaYT4<@4 zb`<-S*BOg5DsRQy;VH!HtfwR$omG9$W}1Ve-+vrLKi=s*FnW%qqRf;Hay|dN7IVkZ zMZW$R6L_C?(}M7PSxEK%Wt0Wl+YIXO;f16P$(SGe8gVQ8_aN3(Y0N^;5ZJ065$uQB zdN|nwgrhXo`+l{5oX6|OuzybTJk;m;5NpvCw;Sfq(Z42p(=43pdxFVs_^ze!i@j5z z;`xcO*%>^`O?WQQ8EF~tL(j>*(ADWqIM)?%X5f7uax=lrAkx4&olf&RuIV%(PKx_O z#0z~4Z@}}Du#6w)TejDR(Af;fiI0Bq8OTEEQ2twrzpXa^F|R8>)KrJY-VZs>>QLS% z4$D3GweD@VZ*bEBzi-p{N*|27JYX|u9nGz&sm4stm96d9>FTvXec@)o9@B@*r?`8EX$c`a z@cWe+i6I?;KN*)8(s-sYBpBgm_$=>UJmtoaxeIOzNyd%wexM%v>`!2Rnf8z9m)6$! zd1>3C5W*=MLN}HFZ z)BD^4x?Y#kegCZ`H4V_2F+BEVKg6^DQo*tQx^`2nm)lJ*#eR!O_-Uil9VOlAqjl>F zy=~q7i?ja_c!k%xz-tS;$9p2K+0#R2fiA-RP;h?t0?;l~5<;#)zJ3`uE2IO$9Gf&J z!uzPUQ?2tstYwC?5Gbpc9ZVI92T8P2@BUEv1_WAZzL{~Pt zY3G}6tR7Y}dh9m|vvBPkJN$t~#%s2fM-jj1;OAqvOux{&S4_&-58r+5p@$w?1+z)l z5qC*T#(s6vox(l(x=%-qgTFZx4dMa6cHF>k#*Qu?{=>-Ma-uYkAn}a@{e)2;dDpI= z(GKrEH!N>Ev$d|He}kvDtql4P(Z!3iFG6(5i^@=ULUehHypr)v?SNImVh-OR-_L7n zlJ%JOZ#C(HY+h*RXLOzXPvad2*qB9n)X%dNuX|}Q+3Gvt59f=Aozr!I+nwS)h$(Q3 zf!lYwK)9_5-UEN+=QQo@SndtG>xHuey7(^youX?UmaJ?s@dbwM(G!Eh2NmF}Ykp}73!=oeKod{yR zc(7h@rijps?;@|DvYM|0RtdZ6sV@`n0DJnC)lfaf7^+atU-$ZS#b@gwh zb@3sv6lsyCF?Kwq1olkKDnA8iHjn$0KZcL~lYfIHzP z!lsfM@+UCD`WPI1A8l>T3AibKDEx)#Jh%JQuCFocd=BU*boq$%*pxh0*xS~SvmNAY z3pv|B&JeAOjdbket|jVqKC8X8t}}7=NX-n zt2Z~1Y}m`AWG9(IIsN3OCa^UP&#vu8%o)Qr)>NZE7^3OUmO#fEo}v1T(~+f^&mno8 zp9}eze@nhH;S%;UyofpU1hm@(~6`7zWNO1|Q8 ziTX?ELx}GdINSLQ#I0RM+`ih2<&Z;9Hlj|Q!4UE>$wG2BKleuVeWYKvb=0rKJj&Wy z$VmNfKL2Jr?L9h$F^W8IO@4=z`d#bsZ95UxsXs>N;_rn`rZ`%bW$ef1e>2}oK9Zvr zI*?<7Kg(n9=V8n%`}K}>TKzJQnciqmW_(LJMC)Xmf_IoQa28C6*3q^Qzs-2JD@5zS z?izjvvU?l+ZZF*R9^N+UL$qXX=$V!286?h%$;6p5)SfbRoe)-UL!W3!GSZ+jz&v1B zLjavetH*K>`XP8;uGV#(Npfw`h1liVqU&y#Ym2U%U9K&CsQr!l*qfTUzVhE)07lHlB7LfU|To?{b~5 zcN}aD+Ha--{lseM%sZRp>onwqU5<|Ut>o)~-%9R4{MK0R_W0dK$X)Fj#CrR)J(7C! zX1#f{-n@p8&Q5shZKt6tDxU_Om$wOW>0u9$KVc8nKyKCl3vt(rXNzP1n5^40-g+7D zxX>8vBQ0pe4$U+I{g|33(XYv0+SNY*<@Ax}2Y2%b6WkvY?qpNQU4wi4h!VJO67C_e ziR7+_d*X;foC&1CPT+u1#MRw@C-4TGE2O!V)Z8uHy7*&kWuHHBei!}n&9B?frTsP4 zecPp8+NFkm+U3jW6F;>HW08GsM~n4ZBF+%LY&0cz$2_I@UMa0dYS00lk4JkY&F%^_J)?;1uS-uBwihTG8p?WL`& zM;}mrdl~0JLk9Gp*M*`FJ7bTW2Qp%BW+3hh`%Kv+!}%xNvTHH-brEMxHsXBt3n4hc z0W#29=}d%4M&A+Rzp%dK7Gk3%W<*V1GzC`ans(KH53H#{uJt}ejzuXT7-C@2&w;eVU=d_tF;hYSt|9W68 z%TvrLV_(Cr({R7oT?-o92K$;(erJF;0GmDO>?dtV4EDmlh4Lo%i`|qv_Bjc6O}Ho6 z-Mh29pK#yNRr&A6?m@ym(C&`CONb`}YcJm+ey_{sW968WKN}DlhG)^_Gw3f2K>I62 zpQjwMlE3eTznEjy z4JDb5qmGoJosfPo_Jz)nC+M<_btc`Af8i$eBHf@X;U;w=-JnXHPPC|dL2i%1W825U4YC~w0M>)**M% z*xK&Du)9CTT)WP}Pbr1(5F~WpKfH^-IBN$y;kO6Zi5_^L8h$f?XQNGcWq0wn!j1f# zcQd^i-(GuD@Ga86)xzNk!*2}Z7vXpMbnQ*DK{Tc}wh0-Ufp|z(#B({qOS>%6<#;F@ z#Y=uO;3oXTjr=37%Y#F;%h#hk#Pf11pLL3M-4p(4%uDT$`Vk^d)Sq(HchalZr6u=c zyne|n+=AF`v6Gu0yA?XQ>DjHo?pBI=AmhuIZaU=GQ?nURHe+eOKFW;ViL64Ip}j4l zK9KP5x$q^L|3JQK2pc^YzMKJhsP7&FH#$Q_`1?6S#QPxnTk+FPZ(=U)O&Ep1>7k~} zFS@~Y(wS`b^MK^DA9lP7dyuNu<6ejRUfgSOtLGwYgQ!E;`zyX*(*W7(Fn49f_>FL&at$qf5NiW!M ztIq3y7sAmPnQR%w=Z&>T%&Tng?-ZX(N7+05Xwxow*U!7kxF#mlR2+->CZo=Kjb_1n z1(>V!HsE`Nuw7$Kp=X~!Ud&VmIxio>r+~4(hj#&eGqp0TZEV%nJ%RZ>^h0V?{BnI! zK09e1V^~vDMTwiXE|BIkc%6)%jiqq2xakiP?{hq3z}ty<#GYpCuibU})(q4&&7ayI zxr;fInU3>iFrQewEoRLOn!B)|9*BHxFO~U%%=9koR+4`(zLkmaA>sN(CSZz-WL4#t z(G~R<{`;d18>=%L7ea^VuOAH4>DHKfXh%QWfVp8#pTc46SA#Q#(Qn0>&h4QuU(9ix zTZT2wplkAURb%wN-Ddh?F0Zst_2%}Q4RJ%f4RJA1`Z$aQ&LEEoG3~29qkT%|sGvA6 z{0`OW+Q+!z{6X}+lG~Wqp#L1`dw%)-Yjvi}X0L8DaSp`&U0%o;1gWns_STF=rq~*&oG0{;D;vDc}2=*PQp= zJDOzoM;;bI_8GYQBkUlAoeCNY`W5U1*^oBapJeQDU^8sb(J;t51#zvyoJ=U*5%7Tw zW}R+2=1!UKV=q^dPo=vb=~9{2B5lftYNu3hbf`ZK_#XRzyYASK&VN#O(h%;yRd=Q% zt_<1EYj9RhAk`geA5?!%y9Zq}6!l8A6RImz9#j_X?;V;$^@i#e)uVwZk2X5*GXqeE zsNGOKaBeqfpY5|yFIK^w^j^*7P4%Kb_F9G0{#3N(65rwF^G5`Kg$%AAvk2>2w#|p}V|^rsu4CwRJYHsxjx> zeYR&KuQ@BUbsg>GU)ugZ2f<$qK~P6nlg zcDn=dm9ow&pnvMeopW!q{XBkq;rCjV9`t$+&(5`Qr}}da=Rx`T7~=FU<)ueGBwccO ztuH}+qVlJDYIO0d?5Xl=grNZU)X$SLI3jkyfKTGeDDc_@*T0 zlpN0|x%bqlnQ&fW3Ox}C2F{GqEz$~c>RL%P5MgB&#pCiuJ7CfcTe0(XJzR3 zPR2W?f2Gq}Jooz^_-lSS_8*kunMLsw(OM+ZqTj=>5@$L1D9cL&{@%~7AMifxU&)q? zIpC)Kf6eD~cKvb{KU8O^UR~aOm3S~0MtFY{mfpUKteE4N@!?g%mt)@qrE%~o ze#%f5`>w(-0sr-@@HOyXz6zh(0LpS$GW>13nm^>#j4@j|*3X`y@<*T9s*~sD!_JHM z{X+4sADtgd@B4+}4Az)BoS&-B%|||quc9l}j<-V&oE2|tsV!^&AH2*-=q2I0o~e!L z-Av1wzQXizOt(^-Y!O1~ZLdI*w@q(+s9dnXYE~Ak)X09$@-0(|V>qGW~;T+ccT3foTNO zaZKZwrZBZJy`Aa3OgA%qn&}%%KW2KKsW+ETSEdn6CovV33IDotc?@JafvMsb_0dc^ z1wf02G{=fnK3KXZGynKBiL0N`iSXwqN~-)T8vm~JSAtF~rQVMfj6RgO${Bkzu5`iGjM4WI*KwEd^^7q`Bd+rMY@C^$C%mL1jgu-iz}Y7ia(LDD${w4W$o0oWEY&~;y=TM zpXGw{TyPO%RUWsy@JkshdG2=MuXVv2T>Nix!H>A$GREi&i|a`jez^;N)&*BER{GiD z!mo7Uzv05Ka^b)2!moD0hg|Rxm+&9D;Nvd%3m07Lg6myyg9|>#Sn2D$3%=;$ztIK% z;exd=_&ntFvd7XTz-s|e*80PX-P?`Y3Zq1pm~=3R7)0n z1I{l<16B@6Nd*~J^1u#BN%JlF1jufR597}B?;=NH(lshH@YD=Dck$C71TkdvM!u;Nli3_0nTK9-juEj=r}AYB^+ z7=>L`qep965BwejhaR|ZxKaAc%}cjgATObC_@nyMAC)pZ95?;OO>HtfDoh&$O7#~} zX`>MbZPtnc9RO+!)wEkcZ^FF{cV7frh96+l@E zb8u^c)H#XZNZ%g2GuzIW;{R1F6pz(bPzX(=S@ZLERb{swdCCF9IJuqP`;IFMY2OlvZXi|D#_={zv0GaK9aL7IhF86SF7X0IuGX6V_|fao1KH8;t! z#A0PLYIh$!hO8KDX9DbsVM2O-s?D0`Fb|qx9GQ*rS(f~KC$7O#V33avXMVKJW+`U9 zauBl>P2HB7QS200_%Mvm&CVkWZJ3s_5Kjz4EbN$5y2+ND+??X<+`@bV$}c@X4^5h* z7V^?R)pxNw@DEpa^-Og3*OHs+OSy(unELk4;b`ncH}$z(DV&7+-%(1F!mG5&KV9VZ zPcD*4k6Vp9C?3KpJW;}QwU)$=36g(uSLrKC;mBRZgP->B^jlpjT}8>=H9h6mm6AWD zTcWO*{5$gryIv$Cg;RNR#>(B9Qh362sW7fsavgkyl|NUi_=+mNYy67;ckasH|I({# zK-C%YrF2fz)t%a`;*($J%eg(Pw&NOJVb#_sJcXk+PnT*VL|yHG!jwMoT`8RG;pw-! zR6A5u$*B8KUL?R3>z(vS|rZT#8SAUE?PC=q7jdTgluKhBtA!#-rR7ReTkf!ixWQ z?#kc)(!bV#QOnT^wJiK$;DyVWQ<#+{e+rCxS*6DE#xjAFn z1Lurs51ccmy>ZU?eiuyp=bZUF+?wN^F4&iZ#HHH5mxNljmanC1xtdK&$KOCLP3S<= z#^>55qW>Ci%S}zs&)2ltgU#o=O^2G}pr0j9WSSQ#v7&}^5?3)@8!zV%s+h7k+FFjc zw3Xx^XIgSbhOcI7ey4f-MI)qt6_27SeTDrF%Ww);aC*w0k#QsESGkjY?ueW04Bezh zqErX4e?izS?8DQ@K9FvyO_I*3jEIsOQJP;T9@Qnqqj)JSQJP<)c>Qpb8_g%t91z{) z-UBzeW1oh=(TvA4jt8YMGuVA5(>b6N|6JUZb{1}mCmXi`cOLGpxNW#e))L$#>k6hT zLCO6#+!W94xG6m9sc12eG2RMFaz2Th()kx|^7krklIwlk#Qy|0@#jK;G)EEyrI3Eq zmHeG7&oZX9Oby>l_dKRYm>PbN?#WEcnAS2ioM%4M3Z{M+*qvzw(`u%*OwTio{89S1 zKx0laAxhf_v+#2BU}o?*+l%!!;+5v zN%$|1wsmTKNVPrpcLQPyFKL6)~8hL+Q(^c-y<2dEJ7 zP%Tz%Bn`P)(t=Da$46mP5eJn-0W=bh*hnu_PqLwzLZM@7V^lYrm$W0VREg5HB7|~n zugxV)Lp)UDbF~Gileq}dvhMzAe6kE=j!9PS(tmGuypBgv->1ldb%^dF1=v3C95#q z)!$5KcY3B$_!#@N+;|%%=rBP!6SG0q+#IA$7d^MhU+nm)mOQ&uPVO}QogRlNqJ-So z@i7x9j6d$^yuA3_ENf~pq~T6cLb@&6nuB@r+?=WD1sS<%IQh``2%H;K7ZX z9@_lyBac3|rEKftPdxe5)Bh^pw*8rBpL_m=iWgscdB@IIUaj2q+Usw;xqDC5-naI> z{m#4ZRqsD=@X+D+KR9x<=GccHef-JsPe1$oi!Z-AQCoNNRQ=cAeA{sP%-M6_egDJx z3qSsJ@#kNDZM^i`?|)pr(xmC!+&w&7wbpxi`}nqL+s?1Oe?VY|j-7%!2Y2b(t$T=} zN6%ip`}FN+3=Qi)AbjAUh`~dK4jVq=n#hsYj>4SxSd%3M3!d{AWLOtwW@YE(<}I@2 z7ZfgDQdGS3hIu#Ml$89}{F|38zvb5d>HPmsr~iMg|LAe!Crq4lojGRml-Q|p)8ePk zn3*tZ_MF7I*Gv8XHUIw=`qx~nA6YqN|BNm0{%i&R3l>nf!v3fGhnKQoL|5t@e{Q;e z_NT%-=jWg0*Et0J*0*5){dE+7gq;(Jm*4y}>FS5y>KFO?hZ$yXuKxd7ZXLe-G{-FjmyeSkYLQi>FrF{ zGTp?qoaqjxRZI^tJ;L-urpK9n!L*iXJ<|rJ=a`;ndXZ@(Q_O0Zr~vg$1DSSZs^ag> zcmUI3OifJVnIiS=H_S#7?;e!-l2qyLT!@Gs?D?%XyBz; ziZ$X3s^Nmad;;*BBY%-A+%pPof`Q)%Z}*RQ3T=!gqy0@vPtm4YY#4{wK#R4>NPlu+ zmKI&OK%1GKr%l6#rnub2+JtmDq(T_%-6^JUHt_@TBYbKGDB`fv{2$^FgDS)WY2jYD zpfH~o^bu!4dUi^>jTpEPe=Z@U;p|N5*>Ut#O^e4(*VL(l($WSMi+BmA;Tm9=ipxMh zigA&%W;S1&oqa9MFw1ME7@s1%7|}yNz$D}x{HFm{0%lYSK_`hh0Zp4JM%6@VTuZZV zGF}^GTG-A{ul7=uAkI2RaSoNGggr=wUJF1h`Yl%J>UKtQ5~AxThdyhYK8W z$#iM{NnSF2t4NDnWcqSUt#B6Wjn}kaEd+7dbCUzLcCahexwKN?w|sQ7*z8 z%ir8R8dA~~&y;>o#or+4G!6fYo#Y`G`Wv7bgdg%}u)B~?>D#QCwQG@jHvZF0pt{mg zD&ZJ)(|kBx3!%YqXdzxg%yH68-FWC*UYXE)xHd)1qmzr|C!ii`&~>KtpooDPNq1MQl=I+JiFXf@R zcDnS8)m*zDW16FN~Kv?YvbZG)~-##p}-*ILHi8E;~&_EDEHHZZ@O zaSz57jC(Sk$Ipjej4PSnn{gH6K8&jw_ho#9aX-e#8LN&}En`|Up{s#$e+jkoj0Z4o zWE{>|3y}4J_MXzEXFNhe&5!XljDr}fc`O6tk<2$Tmb<=C9~h5iek5ZPV-w?O#%9Lj z8OJl8z&MfdB*w{%uVb9SIEHZ^r+>3Du&SKFusOy5#vb4rHn^1-o*G?#^sDhF|K4B z#kiXBSjNX0n;17Rj%M7*csyf$Cz<~Vj17z@GLB$8iLr_Cb&TT~$1qN2JehGG<0*_w z7{@YR%Q%j48RKb;D;UQ!u3|ic@e#(e8P_tN!}vVo>ltf7GQa7J{TOF5HZaa&9Km=6 zV-sT?cR=D9doYgR_Ka`HiYuA7)LRVU_73&iE$?5M8-PqP-QUoU|htwHRDpoILAd?n;7Hl z8gZ2~_GMhjIGAxY<57%j8D}y+&lnS5@(Pyu^I+`9xHV$~V=u-LjJ+9~82d7gXB^Bp zneiybd5m>|GWin59*oyAZq2xiu@~bC#@>vp82d6l!Z?_5E#py)8yV|@WcvCpGXGwT zgBW`=HZt~Q9LYGCv6=BG#>tFz+@Z{4?8Uf*u{YzjjDs1MF&@RZlCjPp<*jDy#rQa5 zZ^jKOJmW?czPAjo@5=dQ9K_h0v61m8#*vJ5Mj76$!ZS`(;TdNr{{y7|BITcPsq)Ww zlky)S{g*5Mj4PFY#?{LIFzNre^3S+I`Dfgy{6|Xv`ff7+-i(77>qbkyQSli^D!xhb z&5F-BQQ--apP{f>;v$7(B`#GsUgAxRJ(fva&N!HHC1W{DpkdTZvjDV?Y!OtAOU*oT zm8;8`Phmc->(fQ6`;yY^1L1r@X&(_?^Tp^K<0tknXHhh8r9awVK^KjS>7wy3T{#?Y z4&yw=dF-Ed-Oxod5OmSL8@lp&jGV76V!T*T+L=Qa?XIDVW>Dy|B1d%5tN~s5_WVe> zvcxP1?OT(0KFhh7^OwPM1s06d=}KpLvRMubG(cA-hofCJbY*aO+Q&s#Ci~Ci`0}w^ zg|0%5w}8{n<9HTuI<&ikE}9{sD^tt@(f&H656RDF_XV6k(sL&K)4mq+NqbO8Q&b9GCzbL;deX3{SK*~SWH^M4?s&^!h@=x`T^r!Mq^)MXTRPpCS%fwgupn4e& zX}MV=b&4;+9v{_Hl264)^_B9+W&zSrdb6C$i}W>4?6)KpP<^KKlzwTi85u9=rKj>o^*$WF)i{>wKjn|7U*UVHz}Mq{EKmX0J8Bos^@iF zk-u=%B318-gkBtYsR-}D)UKTUQ~L@>EmirFyVoY!%Z=I_rI#JyQFmc{x?jshtv5?Sk4XVU<3$TPhba&+Aa5pL|}M?d?hGDcUZ#)Kj$GZb>~k?6}m^czgTH7xhHu(^(EF zzayVYu6Wk4lq=TWZlqi@?Q%-FVx8om`sPSi%5|MxZY7tpkJ8?bbCNR~eFsO&mFZ8g z*B_bwRJ$Ee={xKprSGV3GX3#(dneO($V+>MsrE+Wzq5VI#}k+2P$etnm}-|(>OaO_ z4`n*>cD_t!Dwi(VZK`K2r$ZJ%)livEg1!F8bR6wTrZd5wf9H6cmut4L1kL52hL$8R z8Si8#OnR7Y&kyCFTvW}Fa?Q2#W%%)SJEHWgo~sm|N}_pqWksl8Mci@ra#i|M_Ex4h z*`817Kfzv)r2lApxk~@BPV!Lv*Nb%)%CYpXTAONbQ=ItZKiQSQg1PRL8fAMKQX z;?J_T3&|hn5i;D(Ue5eH#;-C~>waoou$1|#-Kcdx5B9%_ z`Kn)2&iF3ot93z7#+A%h_F1hHs&&L_=0DEnEIXCG%}6Jo5)Lu4aA_;}Ygy%lJ6+S28wn`t2F3b>*>)8`%FU#*K_;s_-2D z5XSl;vV4mfALsb{Fvb_L#J;x$jE^wCH)A97<*XUj{TScNd_AYvpRt+w*^Cnz-^N(2 zqmN;n!TdWJmvVfg7#A`BcE%CRk5K-Z|0v^4jOA<{*5w%&GQX1XEXHPknSX!A)y#j8 z@o~lpj2jqlWE}4=!v`>KWd1#jlUd#ojP*mM|63R*a`-^TLCl}6!ZW`EVLPsR<*Ph;H3csFDHFe%?Y#zBlL7#kT^GLB??kg=KZ zdyGpt{b0t4%%8_t&Eub9oWcCJ7?&`9lkq0TPcyDy{1D@{oL(2k)y&___&DPm8Jh!S zeupw{VE$6Z70fp=Ze;#y#(B(-WUL=9<11lY#Qc$rgP6a9@g|nHD`O+`Z(rmm4Ud1oh zU)1Uxt;f*31HGRuFF7BTf*9zXVMjc2orXsJ@}l)SIwwH2OOhoVT2^|J>o#ea<(8M6 zC!_eBv14Dak6uZ07sl6V``4*~e%0KC! z-tKnBsVKAN*p=TrJiXKH>|gH9CKs8Wqr4?vU@t$3Gwk(7;%vNY?i^o^z5FC!tv0Io z^PKca`H_3e9qH%U>#Yn=v*OP27rO8lJH~t24@=xm?6pOs%I+WF}Pq}WWR+(v? znbzsl>Z)9KCVi{;Mki_&~rAPCxS@!xU`PpJGJo%98AP)KDI*p@U%5_V} zzIVC)=a{X+9U0-s&E7RUS<8ob5t)kOwolLUUFSn?KY76 z51i|dTqjby5{OUfJNu{j9ri%3<2mG!>&$8w1D$(A^_||Jke9@2cLP2=&Ff^!VkoRy zyuzwQ%5`eBD?;vzkf$!l_~kmELms(~<7ht;JMtqj{a4{>{Zs9(Q0vNcQi$Tq^#c_H z&F9lINyVVnN1XYzUgFFrjVg)MdV&MfIy#+_q0&?Bhn{M*he2}W`o^E1htfSCdT+_U zba#G!%Jn>zI^~z@tCE&5t@qL?8A=|Kfqcj(w_K-n=v$sJjh*_ zq=j){*@6^S;U&(n%Of$J2qG_u^X>LQ;sX2gQ?BDwl zm-2~jV$aQ;`u3YfV^)*f1FiS2n%%qWzkYjXL3VZi7unC9wdp9p-uKh`J)U|X=*b`Y z+O}xHOW6h%3li%9+S!_U-+A&Mw=xq0e(M{*-9&m!BnUIkd+z_lswqnfIRW1kaxr zbbRCJj2B-0J@lUYk~f4=`dSa))vtGY^4=F_Z`*QRs}V0vxv@6sixThcSI(P0y|?^G zNpNPbRIJ}b#twP#y*amiG;VUerRTO!$M}tY)ArNX>k2x|t!ndhw{uyahWQ=)2C@0w z(ftO?v>a>L%|TsH#(VT1_T`}O`^Bd|v}pg+9Zyfb*Emq$DK{r3IHxmd+cc!F={b*h zTlY&J9o-Q6`r#YqKR9sIKkoNU z`6ExiI0oS~)8r%PE}k##b?ZCX-if&$d&cj(F}%^NZ~uMQxn;i@&tE(|_NjrL%NBk7 z#$6Mv%XK-I{2rYhTwM6%eVSJH(yq~kr7PEW9D6wP+8wLDy6Z9hq={2Ae4qaO^1AiC zPXwIHi0C(A$3x#ouXttO0k^~p(=$GOywBq0_biG-4NCj{o7=AcvE6fXHniVaqRrnK zYWSe$olll$kA14^)K?FGmG|gpW1>608h7BxqD=wypRB#sH0|WrXD;O~ncDZ87rd#K z`3;`+j8{#f@6!kST4vvMTi1nqFWyzSxM9M853VbVe#}$9KdRMhWewFId^@Y^x4M@m z=zgfU#n3yykL~D+OO^G{dv<7TN*T3u+Ko@XKQ#K}wCwD5J$@WI`|H^Od;4tsJ zoaa-{ZC};%hcADB{FVA2>N@@S=KP^0r8};P8c?}s-B-_c)~8+kFm7Sf@U{zQF9_WA zx#_^Du%e8Ihh%>G&I>=kVNL6c{M27eD*63|qqDv%H%xxGan8nPystd3yZPw>ldTWz z=^onk?f16Vd~|&Adn1ne&iZWq+DG5pTz+s$pPg zxHXsdKf2B*|Al2uo_BE3x_toz9QQ#(Jay%Tb>Dzm)Af1?WdzIZOu(tGJV*ZcN^yR|0?mT(H|r> zP3qZU*_`sZh2Qp_xnN1B)K|Ybo8*1@lyzjo(BWmC<#+8G{LA=uAw51HfBo?Xf9~?k zL2-j+JZJ)I&AxR=gwc+J{Xz5?yZ=! zhc@<4dSGm1yI)>jX9&Ee=;(=YNB4f!GpfU!6ECbz`ugW3YYu$-#0@hBxsRFl?Kp45 ztNDF-afa8#8|%jHcz)opm!HUe;_%p>SCJ{=LO^XFfAV&F@G@!RitX5^W1!yeqY?ZgS)m195El(-d_T?5f|4?hxr z;khr~8}Qti$ZMv)n}1|M_L)}Y4^MCW(f#em>t>W)+sp5hZTWXhc-`?4`5$Vxb=dk%;i*GEh7P)Y1?i@~ z(~`8`e?GQo%;K`sg94Y&kG(i_;DySc?rqa9z`7wezr0=FWK)1{w0G&ELp{Quy5@)d zpRL|8`1Ntov6nv1@?2A0sq;L!?7NLK-nQ&Z*?#=9yS_Rzw9=Ase#4ua4+SjzXzxAY zqQdwEG>lmK?qi`HFM5xS`RRkFpIY)nuia0syy5XfgKU1oZ=LYy?#h6-%HxK_?tgCR zV{g26<=MqUdc+PKayTGr$GR(dBR-w?`W+hs$6XFSG^z2+$Zu-yYHjUw)GheRg`H8) zKeKCJ?)UnxyX8aFwEZp9icgm`4jA)E-J(r{zWvB6b-L}#&gCymx<2gV_rGupyYl6v z_wVT)(C@jLUaxk3-Q(^4hg!XQ;OvXneKE!B(F1N@ymRmLZw8ml-gj?#;-F#Ux_hh% z{CdxofIpf%+ZCrSxIE&c`HSQ0cBQm}-YgXhg1vP$Rdt?6M&4lI7$V zsbOz;^xg3AM|qY9`hZtRoVNy zR_o`V&57xp`}sZV3s)B0G-7kkJA+?cJK~*j#_D^EpYQ!uTPmcq=)IduKYD1u_)mks zEqQ$4m|rr-6vwO_zwO)N$=_V=xjFCS+8;hR;Q7gu_q>^oH7f=@_Un@c?_Jur@!PHoBkPl%ePqo~t$#aL z`q8s{uaA2F&CY+ z(|6gx&(;){tt}Z9@XF`mYt0{I-{Mi<`=NM|ruyfGqI5?;$iqw1d9=}Vp8lGyRgmV^ zs=Maax{v0j57*rF!!>uWD9zp5ta*6P&^&x@)I5Bxnx}7}=GkVY=Gk_w=GktG)~em} zS}VWZTC4USXsz4VYOVc$)LI94>hu9YI(>(5oxbCEoma=XI z{@`A8;s?>`bmRvpo%SK!xt|8EyvnQY6U$PYR&EhAvEW~VMtHv<=qJ%H3tDsj6+yG_ ze@)QV{dNm_%O_PtOJ+Rqmcad|zAb1((>sE$dgeXBzkbGkf%pG(K;U2RJ0x)He(wt! zwCe++RlT1$BKY$b92Gb^v_{~Q4T73tpFSqs*H}Ij?#~5(BtB%~O_9X~f_RV90nvxo%d&Jr z7PR(sm7s=CTAvc}8{-76s$DN=vfHPE*522xUc|e`BB-hHNkO&a-wJ975Bpm1FJ%g9 zGCe0~ncMe*){YzajYyZ$R@di06)!6Z84*>zz-`ms{EVo_-Ywm7!@D;{Jv8W0!T`6# zsEC>V*Dl?c619F=zV*3zmZ;Nry!7J2K2xI}U%GVH8>?@K`r@g%5B3_C8?{7t%zU|Z zPSh_KAG+?ukj$vYu0LL^56z02+vSA0`cA*7i0H*TW?zhr+BEc)KL(YhMlJTrEPeVL z3&)cgHDlHjtM8kW8TH4m7Zz2Iv_z%7uWNnmqx7h8J&wNg#<$r~X&vJ>-J6#kHDb_v zrzcuxMSXTdL%=U54N<@J?zf}%)zMM!O)`G%@oa9??s0EFANcT1QGFN1xi{RH8Fg&# zOLcShW=Eww^6^41&rwld#=iDj#~$;duDjtIWqvFl?#OOC)AGIWD(u>!9lO5IV z&R=it@~<1Ck~db|nXxb`D(#1gGlg1i)We&8U+Ld^XjIMa3;V{OO^&*K-pl7&y^s`@ zk@WJIZ!W||J+&zK_wgGiMLjqt&UB({R@6-?pLuWJV2V0->hgoJ;W<&m?%Q_yql+m~ zyXPIs*}oty>iTnIj+pXtqDFkRa@?NX3!=sroeh3*RZ3Lk&$dq8R$U*pZfD4DziFva z>(6#PR`*DD)VQ~|bq<@I8WpQI|NPv^gs7$atLJ@vcRcGMB5F@Rx7VX8vZFRtJW_GP ztCpyqCw4v4F*hbErEBykl3&n?y z1Q+Kn=FnG=h(9045g9Bw21_11rXdWShGJcuK2Z2{_!D11nQzO@Mu;pitHm?-u#s&(qgxhaNJ1ff$P4fBOCB0h4*`ANC9Y{^{~ynZOXEZ}}zlJr|%_`*_wEjP=MVaZ9$!l!av^XVwR1?dGSK72AK zH8(BYkUQUyr_LUymLw24J|IQLW53|aDsHyaDW=`Xo|!)JsYY9<8?A9Qve`^6!vWohk}x(sBz?dBYbK=Hk0H^pT4PO^iYt^Jf`{AWXM#jIyiZe`6m+!SEmK4kr~EhwY{&o>y;7sFCn=Nr;dEdmec6TzGBZ{v^ETftSZTIEgD#r+)pHX`Wmsca62GMxH0<>TbvXPsw9X z;Q#JN`7JHy>pzWk#>@#b$9}!}?#xL$;vVhNB_aRCBkz(5#$P*cR(`rIf8J~yU0gg5 zM;X)CvhwHUTj}#zN$NQ}FM7t*5yR%qz()`9y{>r$BZh@rY}o_z(o$HUW1w`?RfGGw z@d>dwL{ZaY+&2)PKBL)aJvLwHpVCR(J3EK``t8$cbk>IO(;KUvM|4^h>d-(OeO6%U zJ)HcYEOCw=+#(`U=P%H-YK6zoNa&q7KAQX-ad9KZh?Cf!6DLCxIaMH&XUK^+`6K9RykH20TC9wVE(iTF&-+!925 z=H_m~Up(9@pu&MTD6YVQ$j}ahFwT>>_tK?H(^8;5EohpX)TgZ=wRcRkl&_iF^&&o_ zvs;4n7Xdes4+@(g{h7!g8vno|nXY-B8_p^PmSs2uKear#3EfGzq2yKyH>a{5MsD<- z`q`M5;IJdeP0K@?=;aOMY~kD6nh_hJ2Bz>iab<{`($8ZL6>eHQ)gfEHEwy*VV2UFC zB{!{ly4_94MDG9e>Yyd}tXpyF)TtvY!|GSizf-5WX=P#LcGRPq93_F5V6CEa9q3*4 zRVBK+>QCjpq0=gxnwp&4P0sEkwFtku>f5W`?vQ?~;rDqI(@D2+RjVl0zV)ZR1Fkbw z73`PrR4dJ-_tZ>UeZBZ@hQ98$daOg4{ETp`Tk)X|;+@LS;{E0kzU|1$-f#%QG&|Iy zRU!8cC;@7FL=Dh<1a5`B5jU1cv=s<5Ov|IVMOYo&s?j2EN2x?2EKwgPzg_UVlSse* zR6qRgDSr2??}6VP`1e39UN2<4qh~$ILvb!MVgDfRG{i}C9Q==jJ7uFaetT*--Ll?| z=4|!Iu7CbT@JrQ>RQ!~?0%@hgw-4FQg zU%g*neP^}DxYqT}0PX#W2&&s(y1x~b;VM~%;YSJFvwkww^&`#e`luG% zzJzRLNYmBt=ob8@Xz@W1SF4jHfEIVk-sV!lgJ>=C+KamFD4XN6FpZ46mhK$ z-{`@|`wbI%t!~!7d;d$*-o|ZYf3^7C=!9<*^;Oi?X1em!40h5spgtT?!9emH|U9<=G<653&@1efqR&luU z8^F8h#BZbd+4G_F(|8z}dtcf#qUbB@>ri^4Alg}&z&-0b zxX5J06T(b4rx)PD$1&a7|7q__0HUh)|IZyT(JZm$g|;wSDrw4ST39L|U_hedPAi~* zP>Lg<;>%<#D=IU5uUA-_!#?a-YP3o_l_lCnK1)n3EK4diD)an5pELKuh+tOl{eRm# zdic)0_blK2e9tm>e2|Uj7qxqC#j}-e&wblHx1;SkxAxP3TNrV<&!vO@`Z$0+EHyq1 z(&0!Q4p+VrqJ{TJW>;dyY@C*JP{Br3Dd<*>hiT%y!Ko^(#Ya++eCO7~h5?Z9YF}66iq= z(CO*Ow&JH~*qqQrv|i?M@Vh^8xaUNhHbDmE(=>7ObWLRFWe?)Bn9+89UOWBUh<59d z4gJO0O~hMm_(jju#0SWR&+p8a?23a-W@)WHV(TgRFhc8`M-w~IhY3oLP8_#mPSM9z z(4QVkb|>nObq;ue?9lmxaR#xWYm8k7S!Sy`uCe1e$iG}&x5@uD+#9d%wdo0bhqpKH z>AE_{(`x4X?>f_iUqnzZ&S89!dGh3YWVkhS1(MYEa_BX-($0O&ba;j(Y< zVCdUGmW6NN9H0q0_=>QaF@$znKUG-Nm|>Kki1G**#hzW=+^pMW%ZxF5Q(u<1=}W`& zm`|fG@umwhKIhySDClzrcsxuRaNiqq2(eE)$SDMVuQ13PQ$-DPj(y{BgJT!(&(`5# z9dgcQB=0zU#(domb2cMcanG@XBW}lu^E;*+b(pHdl{$3laI+5I(_y0yn|0VD*40iw z9S+xFxDIdB;cYs+ONZGybm*`~hg)^HQ-=q2__GdICAj)qrbC+!<8?Sqhc}ZaNQ-p1 zQipjud_jjhbl9vz&snZ|=jgDX4u|S+v<@S6I8BFhb+|%@c{+Sfhg)^npu>GSY|&wl z*{**3=+L6WaXOr)!z3O4RfiAg@KGJ+>F{kGex$>FI{aRT$8>mhysKZc4lOzyr^AUl zoTbB59j?&fDjhzq!y+BNpu>-J*sR0ux_mCup+$$|b*O}fKbPq87^=fi9U9N;P58mD zsaz6YXp6vp&P;K@6F)o_GCw74{@jF+^whcGuAL1rvI}K~luC8%HAZp><^yG0%((%)0Gn3;JLXzTA zMTs_E5fp`AfsLEPdU32bAucUFjGJ>q*(v^j3Vk@j7H-YATk*Lz7dn28k7HwElqz;ci+&EBe8B2e{_`Q?yNb37t~ZnM92E z>vPkV*b>ATUa>+5_L1~LLR=p=u#CP)v1lqb zk7kNV8h#)S|07UhYWRei!PW>>J=7&nYeK3LcFOF8kogN!u(2Wfuy36zz3Yg0af#dA zX-V8)#7%L4cc(5%!_O>COP-eyoTeziCo#*T?N{ukPDoBm4@VV|LXJ&ONmA+-AC@s2 zztDh9N7Q1^8EnlZV;9GP^A67`>2s&2U}FQt#W2=)liOOY?Kk+IR}%A$e9Re-UGGdrpOAfLE2g z%SM9Z<5Sfy9yheJxnOZAIY>0D^OMO45Fw7cN-1vu_5;H?3R~Slpyf~xh|lKwvBPln zSus=G+BtWEQ{t!El2epci6^^EYyGW62S2yUDVJBRa$3(T)%1%V6XwUkPbhj7bx)r7 zJB+}p%ws~^FCgOjW76;XJw#d&?kv{ELvfT1i#yfl@yYm2Gt#fxT&3cl_?eN9sZ= z4LFr6Np|$;Jj%xH!Hl@nWNw znE8KG`mJ9xGqp<|diuRQpgu7f_3Wa1cdi{9>8YPw`?Bt3_^kS{>%O5E2IMpM&%8cW z@=7-aovQqQ_4D?)TbFc!ed95H3R-4Y(24Rd=kLrnyB?qPclmMGtsot4I?eLI zdil*Lzb$WHULUbPuPN`Q&f8y>t7=T{BE;mKx9&8Hn4P!n9DZ{7_ZvQI{0ZmZm$@)& z(*1Ui2VDO3&%#VS9n{T1<(!{0BG)m`hY%{00KW7;4NaWRu4Fh z_+qi1_Z@(|FU;5v#&r_l3cz~6`$eKD8V+c(DZ#^esSsyr2_7|KnH)dKH^jnkq5 z*Fg@;!eO?z@?}kehuFNvQMklA@^W&P0618M$H(M6G1}sXFb3y zly3qgz9QHK0|0wKjy!yJzP3-ZjT88$e4N$O zS8FnPPv&>%_h~hN=S@LBQ~2(lIIRKjACQ|3hdIJ=zX@=O*rVB|K@V_kn+{T^LXLpv z0rCaByKp~iCeA(p`rIHyA@rtJhfTK#Q38CjZxv#b_|g;})H3rq8veEEn{8P>2uFPb1*#Vz$Y-l6WSXnpQzSOkbKTt4YT!tqJgDwB!7n z5JvzVeEgGZ`p+FTBplSS^#@YGYRi9W$&gWz{_x54;Y2^%;jho{voyk z{ss5BDR%{*19pS`M?Xz_g?z5A<$ud z)5Qlnp!amxEuaO^yH1D~=@;LEAENx;QGP^o00xU#Qw!h_wClIk9}s;wa1qp89T5Ne#Vy`b)UHG-ft)L3H7Wx z%m7@9^4b5SzRotq?h@iV_#f+M=-+g}!`2A70B`H(;1|ke?S+1O9`Fok65>}e=Zt^@ zF1qYrfvTjQ(wBvR<54t3&S|npofg{`S=1 zulAdwy)_Y!a@pr-@P~;W;pb`MVr`B`()l=tf%}%f;2Z&<-vyc&W{NjO_r`ftTqj+q zDY?`F9s$2ej z4flga0Dr)0oTIS-X5cIh^`!~0FYxoa8s|80KWCJN@oujv>sn3p*Ah(Cqc!D6>|-?H z;PW8h16UUVd;qIMHPHa*4AY>`v6}aI@E`s(=sFF0H%qGroD8{`!`V)p77zisqkQxA zxR3VjQJRW7yl@uA^9JArNPpH0mapHb6U@rW5b~N~SBlPnYv;&xPt0sZ~>tb*| z2QWMibfSFhEKM{6HYT{_8IY*KF7}$50c|Wl2YdmnzD*MafPV8d@d^B+NP#>(51ipl zRr+A^N+Z2{G%H{o%C)3Z??B%|LX3lp$d`Ru%VOYl6ZHNLO&mnItcM_XK+7sk#Zlpa z=WDY~u@AdoMmF);qghsiUhu#AZ!TzgM8i0lXlenx0`1vzDBmwVeAZ|x&Zq$l$Nlgf}QPe#T{lk5pTN#CGo+ZBm@g~oSM+5R~cR3)>j^-f#<2gmb za=_7uFB$xT;Cqh3!KIge8Ui0iHA5u^Nb-O&m;0a&!zF2=eY=ZW{Z&L zv4{`P9pylNJRj2neE)AIPvHT=E%>hb*?<{<-hkPFK7a_F>;P`5D@F^T!kILEm5}+A9Zj)5%=vK+-JWq6+3`i;$6hSE^yNQ z+D`7*cXGe6ll#q`+!rUQjjNz{C-=>r+_!XapTEN#g!}xyN|W33fK9LoH+*6@!`FMY zk?yqxzJfx~lkGJ;?{8dT`u!EIDP%p>{*3Yzo}T<9u8j-8Y+QR$$a=~#dBC3;S3-Ti z$BfG$WQ-X2+j$x~bf~!Qy6eQunKMOla{nhCT>Ij>RPp*m^c^rQ6`h^AH#Ddlu_kbpK0!oxITvdx4ogR(Fxn%&Hh#T z5&cW~;5Oig))Etm-?42!?Z(wn7Et)#b?kwy$F?428@xU~<>m+!I5rpUQWr@t<7xoum{?4T+=Ok;IoFTRHGBf=Pc)5kL`4nGjU(q zg@){b+!eVevaj?Lm>(gVk$+3iM~oODqN1Y2)TvVizHFy(gMup^&(6*krKP1}iaM=qEo<)#?9?EZmUZkiq=GG+dj zP1D)lv#Z#Crj+0O_+zzDT6~8P%Y1#McUNC2JoF6O!McvKQHJH2d%E~U9t9~rxj80W zw@>~1_ZNc)4;B`SMT{9UMg#{3i-?E_#kl--n|R~l>qUM3?ZWRRDXw@$ieYa^5%`)EBj1){^m|g={H_!sA4qZiPAMku zmLd&#`sY&I^raND8>N_aP>SWtmy7%FzhA6gy;?l>*kfYNnl)nW+O@*raEQXfLM7ko z>T0oR(#x5q-g@gT@$S3titXFCiw{2dKKf4)vD$fyPY9_shAV*IyZZl8^>iB@AS zi~4h#5evv(;sMlOi~5zQUyJ%XP=B9W{Q;;SWW^a?8|LoWLaeIB+7s%((k#Sw)Nerj z&rp9a>K{P;L#Th$t-k*NjBmlv^_wuxV7;q)74~XM5Kp`cBizwT$cAA;emYsmeG7#A zYPFEf8-zT%y%m4|^H9GZ>RV8MEb2$0KH6$dM*StdgnVF_kn1K3S+zjOmsg|B4MOhU z-c}#u8h=0Cb_VKqL;dck5C7AQU`U$J5pwJ>A#a{6aZzX0{0M*Wvi|4r0KpR0GF{(jVNZmoX>-g0q0T1Z9<_o0PCwD1~Q*n<|D zdr9&AFewgCmg49FDSlin#ZMcg_+`6nt$!iv^Ec80QGW{R&qn=4sGo)UYkEmhG)#(( zlcjiNffU-UkW56*nVVW zL||mh#pm|+!E+Sw(+doULH)pBHV_gSbK$w?_I5p2I9}Gz3?w63+mAW_ymQaJevE2h zu%faro&*0-)(?)v^YhNV_<9|;34@3N>c<2IM@@{342z8E!v=c$TyVi(di3aV(FEei z=NO`pBJuo$0x@I*pNE7+MMOqMg+=+EPyo*d4pQxpiwcbliwcbze@UP7^)Apu%;kPV zCV+mnAELT2xE3?o2Pp6g{8Q}@yEY0ejtYy6QbZ^m4gLfFn9yNCL?JRNDyGl)@#mg< zE{JG-9&^GRa9O)URRI6Yl4G^ zd-UvL35JP}Ph)}pI{dvqNfA4N*Xj-puU`Q0B zA_JjFZO?6^O%@%!IQ2%yK9%L&_hTJTaO5B>pv!h zdN=9XvrJus_&g*K>WbYIJyE_f(13`bGkcvqDJCQ;@LK4a@s#{EQn+`oQBlF*V}#pd z@;_9S!2PSQ47nDj;{F)Vp+9Ip6p9!THu9QwkKNjbpd*5>Ik7hE8DjZ_}p{P3C0Q^))tE=5N}i?R(S2T*Tj48y{BS>eV^|ZpMU;2zU#kFeEs#;;^4u9 z;`{Foso3Dikt5>QUw;*=f0SYaVukI$xcOQCz8L7P#y|(V%$|*bZV3juhcVCsFeURQ7a?c>wm-`{@_KbiaV@#)id zkgxaIXJ3MNxOYFl{{08`_wVK1^YXKB-KX!R0|%mPFK=J}!Ty8AMg0c(`Cr`KzZVLe zeb!l*T-3L}pZ}TN{VvgOn9Y8J{Jp$-_@U0_=bU|3AD;^b`Jd_K)xBGnEneA(c^eFrQ0EIq-h`Vhi%5sRz|GyeXmWI}C3>;e&cYwm*2?D_vk>WunR^-X-wL_Xiw*S9Yq z^JT~bx^?S@8IXWyAg2&QW6KZuEM$Y@`1mhLn{Pg-Y1-h?qenyY6-^j4R6Cem zDY^X~{!!K(n9mt7V8Eq-0Jv(;nc=F|!U(OsiZrqhmWwp{e7sje#3?hcRusXGj}5F3%mR7yC>Of zw$N3pR#_2O6SvEe2VZc(1y^EihC!Z)hAs>Z1Wz*Q$DF6A-f2wQJWMsrV>N9li@OR&R*8;u! z1#LF{{PWN9`|rR1;lmF z6C)FU@`}*-%xh+Y4npE%WZ*1~44F$K8}|(ONAQ33)mK+Sj{Tq$D@e;Lue_pYpnhPz zNm2$_XHxn?9BC7ec5G~jYJH;3jR_;9*PF~9Lj)vB|Ve{apz~s|Fh3NQ<%0ZxEz>8A$drrz#yRbKK z?AY4VK^|ok{_yqE$i&~shAa&DN9=@lKz*6{nUvQxNEz}W_)i)jgR9<=ayV#6`55~h z$FSbLT}sPKO0BT6cv`79)=8<$E3drr%6`y=6{G`lQ1lpd5R#YFBl5o^I>>kOoHC-` zQ2*(7F=tZICDZK4MsNT=tw38E$(#u^2;xB z`?Kq0;nGO?_<}(B==>ms*o|LEIeo8`lN+UsA`PGD_6(gFZP+t?66~2iX#nhi_B;go zM4LX2eYOs0Q20aME3tOb4}N_GX`w$PG-x2C-czsJ(_!crb)CAjd+SD7ym++CUpPiS znKo9@Kmu+#Amt4@4c6UKP5@5fprO^CNrP_BL+O*?Q~Sdw^#u*SH7?(ZW|p_3LE+!8 zU%yuWk1?L({7Lel{c=1o`n0fRVgng4dB1|St%#MPa(b65&rP^O8;SNs~8W_<_tOv zS||gK2ktU4Xdxv2^pl&G2g}Mku9c;rp%66Wrn~S@J0xZ7*Px+E%9)^n_Dr7?37=%x zGifmFnKT&oOrPZUyuu%+3{ObCX=fZ?5NEY!(qQEFbQrecP6t1e2Bv2+N6Dv_UL!02 zdaW$U01b=A$Ro{P$&X>qq#*`0V2@4CbhBsrB-(Q@Y=J&006vN1v*D8lZjtg*7yj-2 zlENSH{mPLeNA^REvVwHbFA`E`NC#scLej!}9BYlZjL$gUGG<_U&OSI6i|0BgPo`lB@Cw+=u_CzcBRwnrp5ZKv@`>_DZ~o z8*w*iq3@@^=e&k~lVcUfHl~;E3Xso&hE2<^k=0ADmF1wJy*>W}K56y5V7c=4aWX48 zMBY6oL}tc^$_E$TC_nqSUXlj)7(>}Jd=gVf_`}~T{Rcj)h&%BjBu>Pe_CP)xGNF%m zkB=D-kw)tOt65{^i=d$fG;F*RG{6>U&!mC&OrNv{ew8$2lZM;I$@`K(Lt?0079XZ) zAfAjdI6fOO#z>5BNGIt(eFn#1#u3a;r&E@dl}W~>MmFR@cq%)=x~!~!GETmH_to-+ z<)8t!@HA+s((Rc(DR<#mxh{3A%&`T^M^b|1!*he>gP`GF&~O)MxDzxmwU04wg>4|6 zDA#%&z0rGj>p6QbedoF-aA`MUIH2e*EwCeU? zd4IBt1|q6r48+?Lkk`Rq9hdT*cDm2Y-jq4U-_YsAq?4taTba?+$p5@(C#Lk~S9v8N;- zdE^m=59jyfH)-Hlz;S|l#mqSjX`nx)9&#)sk6wE)RPHDy{zv881&i8Z4A=r=4B9h& z(&HIXME^JEUs(IQA6uczsXx&5)tL8>#5tI9*s#PinURqpVH1+q*I$3VihFP#M)^2W|M|{ldGyGU_aX1oUVp$@O1WaiiXU)BN#1qWT}N)b@kTj! z?p(!p%qx{Hkp|iY*L{c^>1a<2*C03!Q|}og(N?$~u?6!<-eZi!ae}mTkideUKBK&T z@A?nhg6%r6M!EZrJMK76JaKMRW!khs!=OQfB+jlWIdIIN&NKEg=peqtpE^%EIX57r zJvyB5j6#@jhcJ#@z5Ff5Y0-RXAt(Fy|0|1b^y1 zGj)mU&7_IAam^WL@09(9goMbTpdg9UDM}7}&N>DSgoa)jGBNCg_CeeYNIl}5fqKO_ zkg_w@H-JC4+j=0MPE!68bg#q~KtJ$s1?~C87hhB~kUv~EgncL);^N}ugb5RrZedSe z;ZI(Z=cI*r(+=o=c%O3w>JMY>EwBUH0BwTp(gy?g<7j7vkB?6fZz1re z-{d~w=_ZB0p{IoII!qdjOx#Epb%?fb-+lK<_$Z-#GkS; zVhHZ*Q17Wr8O~K-`V}5zLYBE#*IqyTYG+81r9@J*%jf9D_&)ZIFDT|Ddnqc;qe<@^dQ^|xh;Y_p| zuc%|JL)wThb!!WJCuuQoM|@iJ2ld^Bb=zOH{sa3`^IweLD@Y6ZPiW9VXwX4Op3=Y2 z7MLj;-lH7oJ87qs8GRA=61WFNTF7_w@kjhj8^$MoQurJCk62*<`NVuGnJ~U*{6o69 zFUL&XB7EbGHkg^wyk;57 zf;vw=lSb+~^yoNZgeJ&}<0{Ws{GPFi`2AKo2L*Tr;oq6r2hTq6oW`F{(vHDp%i_hy zL|1t{aPi_sd_Skz1@TE;|LdTK-kzpIeES9cA^k~cv}d&MhPR!~Uc^Q z)O6^f!>&5)sY72K2I??VhtdT#LOeg@ z_Sm=<%sqwS*xR`oYr`LXuTVM_4y5&>E?v4@jk(O@V5sr7950M+KKo) z59?&NAqEab`C-WY5N{lsgFO!JlW{FH22R}%;4XbkaJ`&TnDBoGS7(P57 zeYVhl(noT>L>!onJq$hOKMue81AOlL@SD%EVeXl7zmfY~++X3EIQNG>JS=5BXg`g; zUSIlYtSiJ}?P&&aVC=-XC&x$nb&f^!)r@5sr|=m+Gu?!}D(-o5uZ?>=Jiov_D(>%a z-=BMIOq~&r`@Wn5U=Ess`NC}+e>tvkp38n2N0TQy{VH~HwdnfG{jwXecFX-f?v-t9 zc7NL8XKrG->x1f_^FhW4%*272{+*dT;rR8<{++V;?ip%dg6rW-v%bN8*H^B6)2YCL z`@TE_!L@zv`5OAj{a)@fjt2bjM4j~In1cCh9OB#=#KXXa@@EW8TsZzbzh<6V)8?Kt z*W``K_o%qn$$i2bU?WI%x=egIj$_>=1>e8Bjbk&j zfdgX>@`SN<<+2d9*T?-Ct|KzBZ)Wbja{rine(w6nvn<@B;a(s2n5d6~UsP3(8vQd4 zGWHiat};$D;x_{q*5JA_*8=mgp2#18%Ng_qobNL}C*8z_JRsbWpRD!`xnIS- zTkaWh?|HqxUr3wa{s{L9?bxF-c)-rweKhxOky`biwuSHZrojK-Mq8xc;k!1ZbBBlqyRHf`7h_nElY$9=L)9S3%1-R;`PzZre+`jK~9eULBX zOX?u)kTE|Y@n9xDn287ZL^+%)z5hy;+B4-|-3s8q{nB>nB>%_$AAIn^xF?@{at8N? z7>^SV@|^Q(&Z)U>N<7F5`XfGL;{Gkq0T?#Xkv_7Vu4^3uU&h#2uSmgq%RKVo;fEhq zevf{a;~)J$b%Fe#F0yap!bF?+_VW+qH=ln5n`ozxunFoTQ%4;e`p@||*EzVROCEE6 z1zS|}E!rk=GUVef8_MGK)mGWO?*n;g??-L=2%F&kHTCg{WjC<<4#$7^R>s@D>>qm( zdjbO))h$+g(|D(XeBglx)clS((J#^thzEH<`H(k1H0_k{<=!rzy*pT)1u*n6Z^?N1 z)IV(U>wO4L+H~y%HjEuR_DZbxE+HM*$DBWF)~q-2{cU;s?YFCSV4RUuYZu1chdd`g z$bZi7s0-u=@o%5lCd%!AZn=-OC-lz??2Ao@-K%*Z$9nF|aBm55mc+SlMYl2kA|A}- z2k~ex8{)@ti@t;NQZ#=RGUK~bC11`#5r2Hey+rOy;CrT$>#xLN!GZ;f@AL;82idlv z1MG`_!LU_~6UVSGGY7hyh8XEMI^~(C-X5M*%o6v@|$b9)IqMLb6&Qm|Jc8c!}sWBuy3|WITHuGCqUx8 z0&?QSi3&I3z|1nV0hXiQFixVs;JHMsh3BGO&J|84DgR6VgLCw^vAx|`ljoREpToTc zyt6>e97 z)H%wFye8fB$yj?S`kj5N{@D+Fjq?8;;bFwU_|AdE_Z`(*G2=q6IZ+?~MBl1^(rb*r z)Fsl(Hks-3Xmhk}(n%fT`5m6U!1n@_fB1uRvu`F}(%+u%?);|=nCW}z`zU9;6N38p z4c5c%M;lx}`J;*7HSzv~nfCQt{;gBIj``v{yISk_b$#vN1+s=LP9w9NQO6fmm;-Uo z$eH-eEbSe5{A zF~795RNY4z&;0!S2&`wnR8di(K`t2Jy^8x?TT5fm}V`6&udh=Wm=p za{kJ>0_Q3g%$3#vFYdK+PEOpZ|LnJ9S%ivle!v{;3E<2&I2Y&Ki)#^__i^4CfO#j^ zs2NicZ~84J&S5x*dioy=B-?OLU&F<6O^53UoU@UCloQ7w#z9Qa-y5dlEzUnU_u$-z zu`cHuBPJi-}9E4nVIU02=~<}OX`cke^nTN>R+x_asQo|`{;?pZX*9ME-1gnJvp8qU|mD! zHY^(}ziND6@so3?dy-ZEhYkIq?$OuN?@*Tb?z-YBeKlqI*(-VSsk^RI=egHqTrb~# zu9)3#GV0^ID=Jo_|DxW|Z!_kiJm^o|ap7l<2-WhS%Zj6)cpW_kd32d8w z8DoE@dwu$8;>~u*3p`i$#4(%eNvz9xHpg!4#hg%=?JVnB9_)=QJoGF8JIh8HmS^tC zvKkgL&1P>vPxS^i4Zrm4y5jrS@CHUR%Xq1`uX*5^>x%DQ^TZpCcx6^^UhATl#1+b% zp_eqPx2|=?yVV%(%@9*X4E~1UJuFl4_LxaxBCaFwcRW5bz36!ev7x5^(IN2@VIUtO zdEy_?Iw9dL+qgGXq>EI1_c}$)L2JokF5bNtfvZF@AEn2sG8Pel<2KfX{PONpi*po{)+;pgJ98PQGVG zFdc#~R+=G&)8|)!!fle?HYG>g4B7F@C584l1|cNS@IIbY;1&-q%?4JdFEdVj$j1}w zx94U@yyW7x2JMYQ&jyxl8pcIO!hTkq6 zGjP~Y%RqBN%Ix{^`0>aw1E)_LKO|tFIV~MOau_#veoDfaflCt71_q8jtNZAbWj|F9HPaGiFT^hpF43=XCpBTgLiCalZ%s{J zgr9qxlaSW>(EV{(2CDKW8z&?zN|Z01B`l7}nyo9FMyVzW8DGn;O7RMIbitWYO#g5|Y;@aZ+;>P0U zVho&4v(w@Xa$23SPMg#2%yv4Q)y`UHy|dBT>=Y&5CFT-KNl=NkB(}s>VlT-qag4l}VMh%8W{TWmaW&Wlp7|(pgzuSyNeCSyx$K*-+V7*;LtF z*-|O0ysEsbe5%Y<`g;$ zYYOWM8w#5WTME63e2V;v0*bGK#W_a*CWqHAQtr4Mj~wEk$0%KE-~;0mb3P z(Zxx{8O2$}ImOQ6n&P_RhT^8;mSQibkJHZ?;0$+0JCmFl&MapRCS5hoI%k8k$=Txc zD)A}tD+wqGFNrQmD#<9xD#?U)(1Pf)q_T{%tg@UkXITy8+W^_NlzBm_evoK*d31SFc}96wc@AV-1C42b zwzQOcK~MakBjM1GBuFp|(sM#`b&y(9MN5SjRZ~?9WrG(FX90LQd>np`07tkZ+L7eQaAY}h98O1# zqt4ObXmYeTymEbV{c;0x!*io^lX5e1vvPBCow>EppGKuS-q0HhbjAvOu|Zd|p(oYQ zk$UJyGjzindSQW1SgT^IY*qHE>?%i9byaOueN|&sGx0D359o++cstAvizCQkb;LSs z4!a{8)8}eOt)t%2=xBC`T<=_St|d1p*P0ufYsvJ1(n{!2;cb+-V zk{6U`&5O;m<=OMH^Bj5AdA0CejqqI}-y5FGk{<-m75l&5Z`t6dvf-nu;i2l`otjHU znRl5PzA328S{7SoE3=nnmpRI+%WC0q8sTmD0%=S+L<7oJm*ImA?@Px# literal 0 HcmV?d00001 diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/t64.exe b/env/lib/python3.12/site-packages/pip/_vendor/distlib/t64.exe new file mode 100644 index 0000000000000000000000000000000000000000..e8bebdba6d8f242244bf397ab067965d47c5093e GIT binary patch literal 108032 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%0AHbpwE%ZM zv;ObB_nxnOhUf4be31oc0dM$^jOKl6mZZNS9{+|}Z-wA{C}+@hgJ^i(tdnSH_mo-m z<7NxqQEs5Ja&cXdS09hRY`p~){DT^-MbI9Jo}dTF%WvN^J9nFY6Y{3`4-Hy_vtKnk zOEgUQyYd~Cig#}|>-@AAD@7LTR9Y%diY(9X+O=!6WMLk3XdOH~0UfmP5;=nZwb23J z;W=xB+#vthU7guHLPLcAdH<}Up}&5I*-yCk5)Fzc+a%Ei{$sY7o%UpvTGR=9@n3s} z1@<5L*M4NwU_EHTKag|epY=elkd1&AbR0QD?$M2)MK359zHfHEXh@O#4-~(lq3ry=avc)-y@psocEI`k&Ew#~syoawzAXl{TpZn|!z+z{@ z%kUl2QD}JAELk)R5Dmqjh4(n*=Pz{Uu0s&h^6Rg^HtjP9RcHumKu2wB63`M($G6{p zYnvZiV)xBTvAZV6+21C{d&DmJm)S)hnho1-mI@932H*d*yQHmRNT0DV3~ z@`O%*uRL2VG zWcKqkK)~-lGP^iL!_YFb!NO^fXsFg_Xb9=^nb;)R)V8uotwlrRx+>eMVdmDL!Q&qt z9bIkzwa2s1|6o1PU-pAwJXR%%CCAXJ`oY8JpDQCGq_^vyRXp{zpA#Hbizx<@MU|m%aD$FI`)JKZMQ&bOf}p z2J8pnYZA~x3;x*2HFFbe<+Z)7Ks4MZ8gj3$!asAj*&jX;4ZF;KD;m&eY*LDBQlQV! z5a=^B1p16k>hOfeUr!PpR9d2E>@V`Osw*@EwI&^bu7uOUXK0{2nstsnJgb+jyr#E3 zI72i{>uY<m}potrTN}$p{73nRW>PSe1gp%+uv>)lW5nEPPD8m zlI+&0m)LuM-(=7b?qhg;mQAA6hQI8+mw(~20NlZg7M#EveSpuwnqcF@{bT$gXhi;> zyQ!Z&B^uU=hSjr0gLDCXh6eN*n{=n_Dl{yFhO7G9jaQ0>QAsxEiUFPm@WjVpe-3<% z?%Ll}ejxwY4EA9B2fLtNg(JgMT3Zy?gg=2M*w=r$VY}U|quL zI2;#?A7;Xuhx)#E?ctZ+JAHO97D>42@_rcSM(7bm@{XNry*RvYSL13O}NG;pbI}% z{{H;RY99lA{!>VwYrq}W{{es2e$b#ntb;xH;Dg@x!lzMuz@|-`R!zg<=s4V(fDbll zH8$zT^jS1eYTZ@)3{P|w574q?R z2VbZ*THrl<1GWlZ2!E9G00n(6y??4zexvh7{xrWohx-_JhV*%%bb(SEvcY$XRWy~a z{~KL<{LeV!jI;G<&jkIc_D|$T`*q06%d;UvhM1l$vOoRlPo|ub-G2M+9v{y4@EaP~ z3)m-+D=KFgXuzH#hwO#$==ocd?2QM&f1kZ_@3aFxhI9cR1AWFO-8CZ>^ndjHrP$xi zN`=lvekAKTI`?%+C@oO90YdZx$6L6|$F%cf@(P0u8m zVp`U*V@H#3?QsDQ{H5>;4M7d)pk+KNG8K%CZGCOY<@V$sJWuJp154d?}NA8>`>A@sZFK;t?e}Px2i;68i+S)KbKPuis<6ero)Ov821p6r(J=_S$Q|2TwgW z>MJ@O(9o$KcfDZ5le`FpyIUCTT59kQ`5UdF;GKg;y>^+>lIX_EY zep37s-9r8)OSyVpY%6-IjJVC3HOsF9G+bp184{;Gz8~f&XoAr$US({ zB16y?$QR$^Q{i*Vmi$?y!{m2^OXXK77yp4 z&rdz|l&1my5I2;5cpB2v({1qJ!CtnMllS<;Yj_SV;Ef(&fB2p=0`h~eT_Qa|2ha(| z#Rd!a?={Z6h=_=It$Uv0PP>FOIUn*mbt&F|2xJidC*Ujil$Dive6+SE--4%#y*_BY zP4ebtfISL6)1S&UG+;;JDfa*2haa|;D_8nG@S%qu@^Him#HU@dZNJkVIZL=dtM6_U z(&Rnrn!jlYzW6`bf9c}_uF*GIaADoC3zAdsODIp`ZL4(M?{C-|d!O*eZjvXgYw`F8a!MO6!_W{^aDy&n2wk}G#v4sG%h;#G z3%CUp80-wTh=TlZCZd8nbS+)Flo;bO{k;CC;tq`-|G@tjzvn?iU>5^g0vc%HH?~Q8 zw?8K!Q|z_j`~_F8!JoAWd62{}IZ271js-_3_C+gwW z1pglY2fE11QIRd$7hinQ+g*5oz9R47j~+-K@744_S7yQ~XbC@q_^0edb^He!*gNrG zuz$z_`w@F5Jm$;^?^y?YfnXiD#^z&dv12+@_`HT_{!il$9bW#!WuvB?2iJk#hPTK% z*Ysg6ka_qFjmWy>=zIAHyR=s9t2|@zQ}!nC`>}GoI`9m_|I5l8Jo~_N8b7;OwlC-D+Bl|vX`tenxtPvvK}!Fa*=VR&aVysp=W+U-B5 z%?jaZRc*acTR+q`3bjo`ZDgp83$t*10>*szDrc9W&k71%TRoO@+&Khj?C zsqE6*^3U@WC%Z~MaFY7#O)M^2{>JXn%5jh?byo^Ab2vgB(W4=l@=I^()!jEwY=BGcY+*@{Q!V$gdC+CqMM&9AGL2DER&J!DLTKV%g-GS9sw?_KRz(Hu>U-9=Xf8}Cg)5{KA0aI zelHxzdy+r*@+ch0wUOgN9?4OW>m*Njv2;XbLugGR*~b-knV{d_UB%u^4RFBcfG7CY zE9WHoTp#%v;)oRHrjmOle@xCVTpoFrg&YmJK5|URW6VQSeoJR_rDNeZAdkaq$fKU$_d3C|G{|F(JY6L7E1#0CxWe#oJeV6f zr=^f@BS%8MkUZ7eJ0|^T&hX=J%%+qn=P4X`o(G*EXG;m_$FG<L8$>A z#7*D@h4?zTCUP9)%E&X3-yly$j)~j`IWqD~vqo0czg;)Rz`@I-@~%PdoAJWu#|BXG zZK&aRfD7yY%#CqIzUyJ(KunX^I5`&Nkvtdq6>^O}#}%4?_7ww}%IicRkA1}lmFo4! zH&Y%WUB9~=jxFH4kADu`-~tb5-^d^1^M>TB$la1NB=@{DlrKal$d8aK%vO#n-~p3` z+h}sPD%J9jZt1tZ6J-CdLKm?+oC`SH!4qr`{MfVWANI;$hWb1K@oD6d96qt>KqtsE zk?SK*mKDN*$%d9yriGPUl3~A7!DcX0j!4=VfskD6-(e(YP=4$h?-{%lqJyTg@8&Yq)UP8Y!HR7+} zFnRK1&v)zr`ygWnGQeEeg+N!ePgE)|Gg`8oDIZC1nQ=Vx^kZkLNO&dQFTC=~D_{SEiUe zdpUcx1kdm$s9?pN(fQs$K_OZ@-Cj|2M znc`tLYYgHiM_Tx;NwXuY=+}?gw?pDp8L8jw)~o)#Ze+H2p;}MX)uGZafQb|cHBR3J zHA|nVmR-v`Sh9ccyWJ>vsG?`J7`xUYc}!fobm?m4X!glQeXi$1{(S%a_a9_;lmpnU zF(wui6!`Der$K&xezM}(Pp??9!mnqrhq2DG>2HNkMm|l?KNDyDR%2|J{Ov&xIU6Id zD|H6BP<|cHHOA>|b+^ueDvt(Z&=;A;hYS3fK&P-}X*xG?W+I00hTNKNdahF?@Q)q& z1Li{4uuD|r63mF^T?$;KGrj`KZx?g4FkNt#rcD?2WKCAUCtXt zi*Gi@;2b_kc(8tY_l(bTW5eLX_UChLZFXOOp2T;@Z|B^=*=cshxqgld%gmPRT&v%C zTUJ(W^dm{CfiVLH4lq*d5kVzg_n{#a6SH?>(Dm4_|k#f1Z2EjPvZ3#~)z&H37VS zyW)K{>=$x_-Nxr)J+POsd@6QT{$4-Mc z5u_xi-1O*{!$&e`nU%EcT6%Q$ly6(uxNb@fBlsXbH;`p}=+l)m*8$c&0=rnZ59 z1DoDu*{te{_pkjz_vq8uzkRK~?p0m!?zIMbqY+n8{>^I*Lp^n+KEDk0jPh??YovFp z;qDE07rHe4J3#MYxlnJ98RE{@b+Y~)sLzzA8tj&DSkM25LE;l_95+=O=s%%#P#GmJ zvYy7fT7NBTjGN#_YqT-?i&_~Pd4e0|CaQOT->0+dsc`8zs@?P+8X@meln~Y{WJWWdM~zXqyB?+J=*t#Gn2#G{w60Zfg3QbqIaPnocBUUEN~O<~jLB0qOU4yLr;M4V zzm_^WBeVKu`0W8R1j^qh9-J{PV_eiY{_Pu`o|!yh+QhLLQ=+4$j!76fQh!FbZ}h12 zahVy>{rbdKk9{z3_4r{uelUBV*n@EG6I)HR!284o{OmV0VQ4~9Qu6udju@d2tQ0@W z-j=srf8VJ*uW^2}{Gs_H@?A5%V_M&DShj81u4NU=8s|pjcF66SJ1BQV?v=SSa&O9A zl)F54UG9e5ZMnO0D{>p>Mdb098@39@Eo-(c`@w|;iwc$%EH5Z7SXZ#VU_-&Cf^7xc z3w9Nh7gQ9u!p4Qo3L^@m3Of{bF6>ztUpT06XyJ&$KNMbBIH_<(VRqq7g$oN86)r1W zURYeXu5f+fhQdvS+X}ZARusCT#zoDFB8sAlIuvy->RA+DG^l83(TJiy6kS;~sc1$~ zcF|2m3yT&NEh}1HR9v*KXnoO!qD@8HinbT+Dk?9kC~_+ruV}U+Vnx)74l6pZ=(!?( z#h?}IR%}~Qu_9t+&y_P)E?l{2<+7E_R~D~azf!aeMa%W7le`&u*?BkREzDb#w=8dY zUUA;Ky!Ck-@;2pd^L(qwbNTQtB0nm>Lw@J{p8113AODblW&Wi68Tr}yFy_DIza04A H#ex3;_fXA_ literal 0 HcmV?d00001 diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/util.py b/env/lib/python3.12/site-packages/pip/_vendor/distlib/util.py new file mode 100644 index 0000000..0d5bd7a --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distlib/util.py @@ -0,0 +1,1984 @@ +# +# Copyright (C) 2012-2023 The Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +import codecs +from collections import deque +import contextlib +import csv +from glob import iglob as std_iglob +import io +import json +import logging +import os +import py_compile +import re +import socket +try: + import ssl +except ImportError: # pragma: no cover + ssl = None +import subprocess +import sys +import tarfile +import tempfile +import textwrap + +try: + import threading +except ImportError: # pragma: no cover + import dummy_threading as threading +import time + +from . import DistlibException +from .compat import (string_types, text_type, shutil, raw_input, StringIO, cache_from_source, urlopen, urljoin, httplib, + xmlrpclib, HTTPHandler, BaseConfigurator, valid_ident, Container, configparser, URLError, ZipFile, + fsdecode, unquote, urlparse) + +logger = logging.getLogger(__name__) + +# +# Requirement parsing code as per PEP 508 +# + +IDENTIFIER = re.compile(r'^([\w\.-]+)\s*') +VERSION_IDENTIFIER = re.compile(r'^([\w\.*+-]+)\s*') +COMPARE_OP = re.compile(r'^(<=?|>=?|={2,3}|[~!]=)\s*') +MARKER_OP = re.compile(r'^((<=?)|(>=?)|={2,3}|[~!]=|in|not\s+in)\s*') +OR = re.compile(r'^or\b\s*') +AND = re.compile(r'^and\b\s*') +NON_SPACE = re.compile(r'(\S+)\s*') +STRING_CHUNK = re.compile(r'([\s\w\.{}()*+#:;,/?!~`@$%^&=|<>\[\]-]+)') + + +def parse_marker(marker_string): + """ + Parse a marker string and return a dictionary containing a marker expression. + + The dictionary will contain keys "op", "lhs" and "rhs" for non-terminals in + the expression grammar, or strings. A string contained in quotes is to be + interpreted as a literal string, and a string not contained in quotes is a + variable (such as os_name). + """ + + def marker_var(remaining): + # either identifier, or literal string + m = IDENTIFIER.match(remaining) + if m: + result = m.groups()[0] + remaining = remaining[m.end():] + elif not remaining: + raise SyntaxError('unexpected end of input') + else: + q = remaining[0] + if q not in '\'"': + raise SyntaxError('invalid expression: %s' % remaining) + oq = '\'"'.replace(q, '') + remaining = remaining[1:] + parts = [q] + while remaining: + # either a string chunk, or oq, or q to terminate + if remaining[0] == q: + break + elif remaining[0] == oq: + parts.append(oq) + remaining = remaining[1:] + else: + m = STRING_CHUNK.match(remaining) + if not m: + raise SyntaxError('error in string literal: %s' % remaining) + parts.append(m.groups()[0]) + remaining = remaining[m.end():] + else: + s = ''.join(parts) + raise SyntaxError('unterminated string: %s' % s) + parts.append(q) + result = ''.join(parts) + remaining = remaining[1:].lstrip() # skip past closing quote + return result, remaining + + def marker_expr(remaining): + if remaining and remaining[0] == '(': + result, remaining = marker(remaining[1:].lstrip()) + if remaining[0] != ')': + raise SyntaxError('unterminated parenthesis: %s' % remaining) + remaining = remaining[1:].lstrip() + else: + lhs, remaining = marker_var(remaining) + while remaining: + m = MARKER_OP.match(remaining) + if not m: + break + op = m.groups()[0] + remaining = remaining[m.end():] + rhs, remaining = marker_var(remaining) + lhs = {'op': op, 'lhs': lhs, 'rhs': rhs} + result = lhs + return result, remaining + + def marker_and(remaining): + lhs, remaining = marker_expr(remaining) + while remaining: + m = AND.match(remaining) + if not m: + break + remaining = remaining[m.end():] + rhs, remaining = marker_expr(remaining) + lhs = {'op': 'and', 'lhs': lhs, 'rhs': rhs} + return lhs, remaining + + def marker(remaining): + lhs, remaining = marker_and(remaining) + while remaining: + m = OR.match(remaining) + if not m: + break + remaining = remaining[m.end():] + rhs, remaining = marker_and(remaining) + lhs = {'op': 'or', 'lhs': lhs, 'rhs': rhs} + return lhs, remaining + + return marker(marker_string) + + +def parse_requirement(req): + """ + Parse a requirement passed in as a string. Return a Container + whose attributes contain the various parts of the requirement. + """ + remaining = req.strip() + if not remaining or remaining.startswith('#'): + return None + m = IDENTIFIER.match(remaining) + if not m: + raise SyntaxError('name expected: %s' % remaining) + distname = m.groups()[0] + remaining = remaining[m.end():] + extras = mark_expr = versions = uri = None + if remaining and remaining[0] == '[': + i = remaining.find(']', 1) + if i < 0: + raise SyntaxError('unterminated extra: %s' % remaining) + s = remaining[1:i] + remaining = remaining[i + 1:].lstrip() + extras = [] + while s: + m = IDENTIFIER.match(s) + if not m: + raise SyntaxError('malformed extra: %s' % s) + extras.append(m.groups()[0]) + s = s[m.end():] + if not s: + break + if s[0] != ',': + raise SyntaxError('comma expected in extras: %s' % s) + s = s[1:].lstrip() + if not extras: + extras = None + if remaining: + if remaining[0] == '@': + # it's a URI + remaining = remaining[1:].lstrip() + m = NON_SPACE.match(remaining) + if not m: + raise SyntaxError('invalid URI: %s' % remaining) + uri = m.groups()[0] + t = urlparse(uri) + # there are issues with Python and URL parsing, so this test + # is a bit crude. See bpo-20271, bpo-23505. Python doesn't + # always parse invalid URLs correctly - it should raise + # exceptions for malformed URLs + if not (t.scheme and t.netloc): + raise SyntaxError('Invalid URL: %s' % uri) + remaining = remaining[m.end():].lstrip() + else: + + def get_versions(ver_remaining): + """ + Return a list of operator, version tuples if any are + specified, else None. + """ + m = COMPARE_OP.match(ver_remaining) + versions = None + if m: + versions = [] + while True: + op = m.groups()[0] + ver_remaining = ver_remaining[m.end():] + m = VERSION_IDENTIFIER.match(ver_remaining) + if not m: + raise SyntaxError('invalid version: %s' % ver_remaining) + v = m.groups()[0] + versions.append((op, v)) + ver_remaining = ver_remaining[m.end():] + if not ver_remaining or ver_remaining[0] != ',': + break + ver_remaining = ver_remaining[1:].lstrip() + # Some packages have a trailing comma which would break things + # See issue #148 + if not ver_remaining: + break + m = COMPARE_OP.match(ver_remaining) + if not m: + raise SyntaxError('invalid constraint: %s' % ver_remaining) + if not versions: + versions = None + return versions, ver_remaining + + if remaining[0] != '(': + versions, remaining = get_versions(remaining) + else: + i = remaining.find(')', 1) + if i < 0: + raise SyntaxError('unterminated parenthesis: %s' % remaining) + s = remaining[1:i] + remaining = remaining[i + 1:].lstrip() + # As a special diversion from PEP 508, allow a version number + # a.b.c in parentheses as a synonym for ~= a.b.c (because this + # is allowed in earlier PEPs) + if COMPARE_OP.match(s): + versions, _ = get_versions(s) + else: + m = VERSION_IDENTIFIER.match(s) + if not m: + raise SyntaxError('invalid constraint: %s' % s) + v = m.groups()[0] + s = s[m.end():].lstrip() + if s: + raise SyntaxError('invalid constraint: %s' % s) + versions = [('~=', v)] + + if remaining: + if remaining[0] != ';': + raise SyntaxError('invalid requirement: %s' % remaining) + remaining = remaining[1:].lstrip() + + mark_expr, remaining = parse_marker(remaining) + + if remaining and remaining[0] != '#': + raise SyntaxError('unexpected trailing data: %s' % remaining) + + if not versions: + rs = distname + else: + rs = '%s %s' % (distname, ', '.join(['%s %s' % con for con in versions])) + return Container(name=distname, extras=extras, constraints=versions, marker=mark_expr, url=uri, requirement=rs) + + +def get_resources_dests(resources_root, rules): + """Find destinations for resources files""" + + def get_rel_path(root, path): + # normalizes and returns a lstripped-/-separated path + root = root.replace(os.path.sep, '/') + path = path.replace(os.path.sep, '/') + assert path.startswith(root) + return path[len(root):].lstrip('/') + + destinations = {} + for base, suffix, dest in rules: + prefix = os.path.join(resources_root, base) + for abs_base in iglob(prefix): + abs_glob = os.path.join(abs_base, suffix) + for abs_path in iglob(abs_glob): + resource_file = get_rel_path(resources_root, abs_path) + if dest is None: # remove the entry if it was here + destinations.pop(resource_file, None) + else: + rel_path = get_rel_path(abs_base, abs_path) + rel_dest = dest.replace(os.path.sep, '/').rstrip('/') + destinations[resource_file] = rel_dest + '/' + rel_path + return destinations + + +def in_venv(): + if hasattr(sys, 'real_prefix'): + # virtualenv venvs + result = True + else: + # PEP 405 venvs + result = sys.prefix != getattr(sys, 'base_prefix', sys.prefix) + return result + + +def get_executable(): + # The __PYVENV_LAUNCHER__ dance is apparently no longer needed, as + # changes to the stub launcher mean that sys.executable always points + # to the stub on OS X + # if sys.platform == 'darwin' and ('__PYVENV_LAUNCHER__' + # in os.environ): + # result = os.environ['__PYVENV_LAUNCHER__'] + # else: + # result = sys.executable + # return result + # Avoid normcasing: see issue #143 + # result = os.path.normcase(sys.executable) + result = sys.executable + if not isinstance(result, text_type): + result = fsdecode(result) + return result + + +def proceed(prompt, allowed_chars, error_prompt=None, default=None): + p = prompt + while True: + s = raw_input(p) + p = prompt + if not s and default: + s = default + if s: + c = s[0].lower() + if c in allowed_chars: + break + if error_prompt: + p = '%c: %s\n%s' % (c, error_prompt, prompt) + return c + + +def extract_by_key(d, keys): + if isinstance(keys, string_types): + keys = keys.split() + result = {} + for key in keys: + if key in d: + result[key] = d[key] + return result + + +def read_exports(stream): + if sys.version_info[0] >= 3: + # needs to be a text stream + stream = codecs.getreader('utf-8')(stream) + # Try to load as JSON, falling back on legacy format + data = stream.read() + stream = StringIO(data) + try: + jdata = json.load(stream) + result = jdata['extensions']['python.exports']['exports'] + for group, entries in result.items(): + for k, v in entries.items(): + s = '%s = %s' % (k, v) + entry = get_export_entry(s) + assert entry is not None + entries[k] = entry + return result + except Exception: + stream.seek(0, 0) + + def read_stream(cp, stream): + if hasattr(cp, 'read_file'): + cp.read_file(stream) + else: + cp.readfp(stream) + + cp = configparser.ConfigParser() + try: + read_stream(cp, stream) + except configparser.MissingSectionHeaderError: + stream.close() + data = textwrap.dedent(data) + stream = StringIO(data) + read_stream(cp, stream) + + result = {} + for key in cp.sections(): + result[key] = entries = {} + for name, value in cp.items(key): + s = '%s = %s' % (name, value) + entry = get_export_entry(s) + assert entry is not None + # entry.dist = self + entries[name] = entry + return result + + +def write_exports(exports, stream): + if sys.version_info[0] >= 3: + # needs to be a text stream + stream = codecs.getwriter('utf-8')(stream) + cp = configparser.ConfigParser() + for k, v in exports.items(): + # TODO check k, v for valid values + cp.add_section(k) + for entry in v.values(): + if entry.suffix is None: + s = entry.prefix + else: + s = '%s:%s' % (entry.prefix, entry.suffix) + if entry.flags: + s = '%s [%s]' % (s, ', '.join(entry.flags)) + cp.set(k, entry.name, s) + cp.write(stream) + + +@contextlib.contextmanager +def tempdir(): + td = tempfile.mkdtemp() + try: + yield td + finally: + shutil.rmtree(td) + + +@contextlib.contextmanager +def chdir(d): + cwd = os.getcwd() + try: + os.chdir(d) + yield + finally: + os.chdir(cwd) + + +@contextlib.contextmanager +def socket_timeout(seconds=15): + cto = socket.getdefaulttimeout() + try: + socket.setdefaulttimeout(seconds) + yield + finally: + socket.setdefaulttimeout(cto) + + +class cached_property(object): + + def __init__(self, func): + self.func = func + # for attr in ('__name__', '__module__', '__doc__'): + # setattr(self, attr, getattr(func, attr, None)) + + def __get__(self, obj, cls=None): + if obj is None: + return self + value = self.func(obj) + object.__setattr__(obj, self.func.__name__, value) + # obj.__dict__[self.func.__name__] = value = self.func(obj) + return value + + +def convert_path(pathname): + """Return 'pathname' as a name that will work on the native filesystem. + + The path is split on '/' and put back together again using the current + directory separator. Needed because filenames in the setup script are + always supplied in Unix style, and have to be converted to the local + convention before we can actually use them in the filesystem. Raises + ValueError on non-Unix-ish systems if 'pathname' either starts or + ends with a slash. + """ + if os.sep == '/': + return pathname + if not pathname: + return pathname + if pathname[0] == '/': + raise ValueError("path '%s' cannot be absolute" % pathname) + if pathname[-1] == '/': + raise ValueError("path '%s' cannot end with '/'" % pathname) + + paths = pathname.split('/') + while os.curdir in paths: + paths.remove(os.curdir) + if not paths: + return os.curdir + return os.path.join(*paths) + + +class FileOperator(object): + + def __init__(self, dry_run=False): + self.dry_run = dry_run + self.ensured = set() + self._init_record() + + def _init_record(self): + self.record = False + self.files_written = set() + self.dirs_created = set() + + def record_as_written(self, path): + if self.record: + self.files_written.add(path) + + def newer(self, source, target): + """Tell if the target is newer than the source. + + Returns true if 'source' exists and is more recently modified than + 'target', or if 'source' exists and 'target' doesn't. + + Returns false if both exist and 'target' is the same age or younger + than 'source'. Raise PackagingFileError if 'source' does not exist. + + Note that this test is not very accurate: files created in the same + second will have the same "age". + """ + if not os.path.exists(source): + raise DistlibException("file '%r' does not exist" % os.path.abspath(source)) + if not os.path.exists(target): + return True + + return os.stat(source).st_mtime > os.stat(target).st_mtime + + def copy_file(self, infile, outfile, check=True): + """Copy a file respecting dry-run and force flags. + """ + self.ensure_dir(os.path.dirname(outfile)) + logger.info('Copying %s to %s', infile, outfile) + if not self.dry_run: + msg = None + if check: + if os.path.islink(outfile): + msg = '%s is a symlink' % outfile + elif os.path.exists(outfile) and not os.path.isfile(outfile): + msg = '%s is a non-regular file' % outfile + if msg: + raise ValueError(msg + ' which would be overwritten') + shutil.copyfile(infile, outfile) + self.record_as_written(outfile) + + def copy_stream(self, instream, outfile, encoding=None): + assert not os.path.isdir(outfile) + self.ensure_dir(os.path.dirname(outfile)) + logger.info('Copying stream %s to %s', instream, outfile) + if not self.dry_run: + if encoding is None: + outstream = open(outfile, 'wb') + else: + outstream = codecs.open(outfile, 'w', encoding=encoding) + try: + shutil.copyfileobj(instream, outstream) + finally: + outstream.close() + self.record_as_written(outfile) + + def write_binary_file(self, path, data): + self.ensure_dir(os.path.dirname(path)) + if not self.dry_run: + if os.path.exists(path): + os.remove(path) + with open(path, 'wb') as f: + f.write(data) + self.record_as_written(path) + + def write_text_file(self, path, data, encoding): + self.write_binary_file(path, data.encode(encoding)) + + def set_mode(self, bits, mask, files): + if os.name == 'posix' or (os.name == 'java' and os._name == 'posix'): + # Set the executable bits (owner, group, and world) on + # all the files specified. + for f in files: + if self.dry_run: + logger.info("changing mode of %s", f) + else: + mode = (os.stat(f).st_mode | bits) & mask + logger.info("changing mode of %s to %o", f, mode) + os.chmod(f, mode) + + set_executable_mode = lambda s, f: s.set_mode(0o555, 0o7777, f) + + def ensure_dir(self, path): + path = os.path.abspath(path) + if path not in self.ensured and not os.path.exists(path): + self.ensured.add(path) + d, f = os.path.split(path) + self.ensure_dir(d) + logger.info('Creating %s' % path) + if not self.dry_run: + os.mkdir(path) + if self.record: + self.dirs_created.add(path) + + def byte_compile(self, path, optimize=False, force=False, prefix=None, hashed_invalidation=False): + dpath = cache_from_source(path, not optimize) + logger.info('Byte-compiling %s to %s', path, dpath) + if not self.dry_run: + if force or self.newer(path, dpath): + if not prefix: + diagpath = None + else: + assert path.startswith(prefix) + diagpath = path[len(prefix):] + compile_kwargs = {} + if hashed_invalidation and hasattr(py_compile, 'PycInvalidationMode'): + if not isinstance(hashed_invalidation, py_compile.PycInvalidationMode): + hashed_invalidation = py_compile.PycInvalidationMode.CHECKED_HASH + compile_kwargs['invalidation_mode'] = hashed_invalidation + py_compile.compile(path, dpath, diagpath, True, **compile_kwargs) # raise error + self.record_as_written(dpath) + return dpath + + def ensure_removed(self, path): + if os.path.exists(path): + if os.path.isdir(path) and not os.path.islink(path): + logger.debug('Removing directory tree at %s', path) + if not self.dry_run: + shutil.rmtree(path) + if self.record: + if path in self.dirs_created: + self.dirs_created.remove(path) + else: + if os.path.islink(path): + s = 'link' + else: + s = 'file' + logger.debug('Removing %s %s', s, path) + if not self.dry_run: + os.remove(path) + if self.record: + if path in self.files_written: + self.files_written.remove(path) + + def is_writable(self, path): + result = False + while not result: + if os.path.exists(path): + result = os.access(path, os.W_OK) + break + parent = os.path.dirname(path) + if parent == path: + break + path = parent + return result + + def commit(self): + """ + Commit recorded changes, turn off recording, return + changes. + """ + assert self.record + result = self.files_written, self.dirs_created + self._init_record() + return result + + def rollback(self): + if not self.dry_run: + for f in list(self.files_written): + if os.path.exists(f): + os.remove(f) + # dirs should all be empty now, except perhaps for + # __pycache__ subdirs + # reverse so that subdirs appear before their parents + dirs = sorted(self.dirs_created, reverse=True) + for d in dirs: + flist = os.listdir(d) + if flist: + assert flist == ['__pycache__'] + sd = os.path.join(d, flist[0]) + os.rmdir(sd) + os.rmdir(d) # should fail if non-empty + self._init_record() + + +def resolve(module_name, dotted_path): + if module_name in sys.modules: + mod = sys.modules[module_name] + else: + mod = __import__(module_name) + if dotted_path is None: + result = mod + else: + parts = dotted_path.split('.') + result = getattr(mod, parts.pop(0)) + for p in parts: + result = getattr(result, p) + return result + + +class ExportEntry(object): + + def __init__(self, name, prefix, suffix, flags): + self.name = name + self.prefix = prefix + self.suffix = suffix + self.flags = flags + + @cached_property + def value(self): + return resolve(self.prefix, self.suffix) + + def __repr__(self): # pragma: no cover + return '' % (self.name, self.prefix, self.suffix, self.flags) + + def __eq__(self, other): + if not isinstance(other, ExportEntry): + result = False + else: + result = (self.name == other.name and self.prefix == other.prefix and self.suffix == other.suffix and + self.flags == other.flags) + return result + + __hash__ = object.__hash__ + + +ENTRY_RE = re.compile( + r'''(?P([^\[]\S*)) + \s*=\s*(?P(\w+)([:\.]\w+)*) + \s*(\[\s*(?P[\w-]+(=\w+)?(,\s*\w+(=\w+)?)*)\s*\])? + ''', re.VERBOSE) + + +def get_export_entry(specification): + m = ENTRY_RE.search(specification) + if not m: + result = None + if '[' in specification or ']' in specification: + raise DistlibException("Invalid specification " + "'%s'" % specification) + else: + d = m.groupdict() + name = d['name'] + path = d['callable'] + colons = path.count(':') + if colons == 0: + prefix, suffix = path, None + else: + if colons != 1: + raise DistlibException("Invalid specification " + "'%s'" % specification) + prefix, suffix = path.split(':') + flags = d['flags'] + if flags is None: + if '[' in specification or ']' in specification: + raise DistlibException("Invalid specification " + "'%s'" % specification) + flags = [] + else: + flags = [f.strip() for f in flags.split(',')] + result = ExportEntry(name, prefix, suffix, flags) + return result + + +def get_cache_base(suffix=None): + """ + Return the default base location for distlib caches. If the directory does + not exist, it is created. Use the suffix provided for the base directory, + and default to '.distlib' if it isn't provided. + + On Windows, if LOCALAPPDATA is defined in the environment, then it is + assumed to be a directory, and will be the parent directory of the result. + On POSIX, and on Windows if LOCALAPPDATA is not defined, the user's home + directory - using os.expanduser('~') - will be the parent directory of + the result. + + The result is just the directory '.distlib' in the parent directory as + determined above, or with the name specified with ``suffix``. + """ + if suffix is None: + suffix = '.distlib' + if os.name == 'nt' and 'LOCALAPPDATA' in os.environ: + result = os.path.expandvars('$localappdata') + else: + # Assume posix, or old Windows + result = os.path.expanduser('~') + # we use 'isdir' instead of 'exists', because we want to + # fail if there's a file with that name + if os.path.isdir(result): + usable = os.access(result, os.W_OK) + if not usable: + logger.warning('Directory exists but is not writable: %s', result) + else: + try: + os.makedirs(result) + usable = True + except OSError: + logger.warning('Unable to create %s', result, exc_info=True) + usable = False + if not usable: + result = tempfile.mkdtemp() + logger.warning('Default location unusable, using %s', result) + return os.path.join(result, suffix) + + +def path_to_cache_dir(path, use_abspath=True): + """ + Convert an absolute path to a directory name for use in a cache. + + The algorithm used is: + + #. On Windows, any ``':'`` in the drive is replaced with ``'---'``. + #. Any occurrence of ``os.sep`` is replaced with ``'--'``. + #. ``'.cache'`` is appended. + """ + d, p = os.path.splitdrive(os.path.abspath(path) if use_abspath else path) + if d: + d = d.replace(':', '---') + p = p.replace(os.sep, '--') + return d + p + '.cache' + + +def ensure_slash(s): + if not s.endswith('/'): + return s + '/' + return s + + +def parse_credentials(netloc): + username = password = None + if '@' in netloc: + prefix, netloc = netloc.rsplit('@', 1) + if ':' not in prefix: + username = prefix + else: + username, password = prefix.split(':', 1) + if username: + username = unquote(username) + if password: + password = unquote(password) + return username, password, netloc + + +def get_process_umask(): + result = os.umask(0o22) + os.umask(result) + return result + + +def is_string_sequence(seq): + result = True + i = None + for i, s in enumerate(seq): + if not isinstance(s, string_types): + result = False + break + assert i is not None + return result + + +PROJECT_NAME_AND_VERSION = re.compile('([a-z0-9_]+([.-][a-z_][a-z0-9_]*)*)-' + '([a-z0-9_.+-]+)', re.I) +PYTHON_VERSION = re.compile(r'-py(\d\.?\d?)') + + +def split_filename(filename, project_name=None): + """ + Extract name, version, python version from a filename (no extension) + + Return name, version, pyver or None + """ + result = None + pyver = None + filename = unquote(filename).replace(' ', '-') + m = PYTHON_VERSION.search(filename) + if m: + pyver = m.group(1) + filename = filename[:m.start()] + if project_name and len(filename) > len(project_name) + 1: + m = re.match(re.escape(project_name) + r'\b', filename) + if m: + n = m.end() + result = filename[:n], filename[n + 1:], pyver + if result is None: + m = PROJECT_NAME_AND_VERSION.match(filename) + if m: + result = m.group(1), m.group(3), pyver + return result + + +# Allow spaces in name because of legacy dists like "Twisted Core" +NAME_VERSION_RE = re.compile(r'(?P[\w .-]+)\s*' + r'\(\s*(?P[^\s)]+)\)$') + + +def parse_name_and_version(p): + """ + A utility method used to get name and version from a string. + + From e.g. a Provides-Dist value. + + :param p: A value in a form 'foo (1.0)' + :return: The name and version as a tuple. + """ + m = NAME_VERSION_RE.match(p) + if not m: + raise DistlibException('Ill-formed name/version string: \'%s\'' % p) + d = m.groupdict() + return d['name'].strip().lower(), d['ver'] + + +def get_extras(requested, available): + result = set() + requested = set(requested or []) + available = set(available or []) + if '*' in requested: + requested.remove('*') + result |= available + for r in requested: + if r == '-': + result.add(r) + elif r.startswith('-'): + unwanted = r[1:] + if unwanted not in available: + logger.warning('undeclared extra: %s' % unwanted) + if unwanted in result: + result.remove(unwanted) + else: + if r not in available: + logger.warning('undeclared extra: %s' % r) + result.add(r) + return result + + +# +# Extended metadata functionality +# + + +def _get_external_data(url): + result = {} + try: + # urlopen might fail if it runs into redirections, + # because of Python issue #13696. Fixed in locators + # using a custom redirect handler. + resp = urlopen(url) + headers = resp.info() + ct = headers.get('Content-Type') + if not ct.startswith('application/json'): + logger.debug('Unexpected response for JSON request: %s', ct) + else: + reader = codecs.getreader('utf-8')(resp) + # data = reader.read().decode('utf-8') + # result = json.loads(data) + result = json.load(reader) + except Exception as e: + logger.exception('Failed to get external data for %s: %s', url, e) + return result + + +_external_data_base_url = 'https://www.red-dove.com/pypi/projects/' + + +def get_project_data(name): + url = '%s/%s/project.json' % (name[0].upper(), name) + url = urljoin(_external_data_base_url, url) + result = _get_external_data(url) + return result + + +def get_package_data(name, version): + url = '%s/%s/package-%s.json' % (name[0].upper(), name, version) + url = urljoin(_external_data_base_url, url) + return _get_external_data(url) + + +class Cache(object): + """ + A class implementing a cache for resources that need to live in the file system + e.g. shared libraries. This class was moved from resources to here because it + could be used by other modules, e.g. the wheel module. + """ + + def __init__(self, base): + """ + Initialise an instance. + + :param base: The base directory where the cache should be located. + """ + # we use 'isdir' instead of 'exists', because we want to + # fail if there's a file with that name + if not os.path.isdir(base): # pragma: no cover + os.makedirs(base) + if (os.stat(base).st_mode & 0o77) != 0: + logger.warning('Directory \'%s\' is not private', base) + self.base = os.path.abspath(os.path.normpath(base)) + + def prefix_to_dir(self, prefix, use_abspath=True): + """ + Converts a resource prefix to a directory name in the cache. + """ + return path_to_cache_dir(prefix, use_abspath=use_abspath) + + def clear(self): + """ + Clear the cache. + """ + not_removed = [] + for fn in os.listdir(self.base): + fn = os.path.join(self.base, fn) + try: + if os.path.islink(fn) or os.path.isfile(fn): + os.remove(fn) + elif os.path.isdir(fn): + shutil.rmtree(fn) + except Exception: + not_removed.append(fn) + return not_removed + + +class EventMixin(object): + """ + A very simple publish/subscribe system. + """ + + def __init__(self): + self._subscribers = {} + + def add(self, event, subscriber, append=True): + """ + Add a subscriber for an event. + + :param event: The name of an event. + :param subscriber: The subscriber to be added (and called when the + event is published). + :param append: Whether to append or prepend the subscriber to an + existing subscriber list for the event. + """ + subs = self._subscribers + if event not in subs: + subs[event] = deque([subscriber]) + else: + sq = subs[event] + if append: + sq.append(subscriber) + else: + sq.appendleft(subscriber) + + def remove(self, event, subscriber): + """ + Remove a subscriber for an event. + + :param event: The name of an event. + :param subscriber: The subscriber to be removed. + """ + subs = self._subscribers + if event not in subs: + raise ValueError('No subscribers: %r' % event) + subs[event].remove(subscriber) + + def get_subscribers(self, event): + """ + Return an iterator for the subscribers for an event. + :param event: The event to return subscribers for. + """ + return iter(self._subscribers.get(event, ())) + + def publish(self, event, *args, **kwargs): + """ + Publish a event and return a list of values returned by its + subscribers. + + :param event: The event to publish. + :param args: The positional arguments to pass to the event's + subscribers. + :param kwargs: The keyword arguments to pass to the event's + subscribers. + """ + result = [] + for subscriber in self.get_subscribers(event): + try: + value = subscriber(event, *args, **kwargs) + except Exception: + logger.exception('Exception during event publication') + value = None + result.append(value) + logger.debug('publish %s: args = %s, kwargs = %s, result = %s', event, args, kwargs, result) + return result + + +# +# Simple sequencing +# +class Sequencer(object): + + def __init__(self): + self._preds = {} + self._succs = {} + self._nodes = set() # nodes with no preds/succs + + def add_node(self, node): + self._nodes.add(node) + + def remove_node(self, node, edges=False): + if node in self._nodes: + self._nodes.remove(node) + if edges: + for p in set(self._preds.get(node, ())): + self.remove(p, node) + for s in set(self._succs.get(node, ())): + self.remove(node, s) + # Remove empties + for k, v in list(self._preds.items()): + if not v: + del self._preds[k] + for k, v in list(self._succs.items()): + if not v: + del self._succs[k] + + def add(self, pred, succ): + assert pred != succ + self._preds.setdefault(succ, set()).add(pred) + self._succs.setdefault(pred, set()).add(succ) + + def remove(self, pred, succ): + assert pred != succ + try: + preds = self._preds[succ] + succs = self._succs[pred] + except KeyError: # pragma: no cover + raise ValueError('%r not a successor of anything' % succ) + try: + preds.remove(pred) + succs.remove(succ) + except KeyError: # pragma: no cover + raise ValueError('%r not a successor of %r' % (succ, pred)) + + def is_step(self, step): + return (step in self._preds or step in self._succs or step in self._nodes) + + def get_steps(self, final): + if not self.is_step(final): + raise ValueError('Unknown: %r' % final) + result = [] + todo = [] + seen = set() + todo.append(final) + while todo: + step = todo.pop(0) + if step in seen: + # if a step was already seen, + # move it to the end (so it will appear earlier + # when reversed on return) ... but not for the + # final step, as that would be confusing for + # users + if step != final: + result.remove(step) + result.append(step) + else: + seen.add(step) + result.append(step) + preds = self._preds.get(step, ()) + todo.extend(preds) + return reversed(result) + + @property + def strong_connections(self): + # http://en.wikipedia.org/wiki/Tarjan%27s_strongly_connected_components_algorithm + index_counter = [0] + stack = [] + lowlinks = {} + index = {} + result = [] + + graph = self._succs + + def strongconnect(node): + # set the depth index for this node to the smallest unused index + index[node] = index_counter[0] + lowlinks[node] = index_counter[0] + index_counter[0] += 1 + stack.append(node) + + # Consider successors + try: + successors = graph[node] + except Exception: + successors = [] + for successor in successors: + if successor not in lowlinks: + # Successor has not yet been visited + strongconnect(successor) + lowlinks[node] = min(lowlinks[node], lowlinks[successor]) + elif successor in stack: + # the successor is in the stack and hence in the current + # strongly connected component (SCC) + lowlinks[node] = min(lowlinks[node], index[successor]) + + # If `node` is a root node, pop the stack and generate an SCC + if lowlinks[node] == index[node]: + connected_component = [] + + while True: + successor = stack.pop() + connected_component.append(successor) + if successor == node: + break + component = tuple(connected_component) + # storing the result + result.append(component) + + for node in graph: + if node not in lowlinks: + strongconnect(node) + + return result + + @property + def dot(self): + result = ['digraph G {'] + for succ in self._preds: + preds = self._preds[succ] + for pred in preds: + result.append(' %s -> %s;' % (pred, succ)) + for node in self._nodes: + result.append(' %s;' % node) + result.append('}') + return '\n'.join(result) + + +# +# Unarchiving functionality for zip, tar, tgz, tbz, whl +# + +ARCHIVE_EXTENSIONS = ('.tar.gz', '.tar.bz2', '.tar', '.zip', '.tgz', '.tbz', '.whl') + + +def unarchive(archive_filename, dest_dir, format=None, check=True): + + def check_path(path): + if not isinstance(path, text_type): + path = path.decode('utf-8') + p = os.path.abspath(os.path.join(dest_dir, path)) + if not p.startswith(dest_dir) or p[plen] != os.sep: + raise ValueError('path outside destination: %r' % p) + + dest_dir = os.path.abspath(dest_dir) + plen = len(dest_dir) + archive = None + if format is None: + if archive_filename.endswith(('.zip', '.whl')): + format = 'zip' + elif archive_filename.endswith(('.tar.gz', '.tgz')): + format = 'tgz' + mode = 'r:gz' + elif archive_filename.endswith(('.tar.bz2', '.tbz')): + format = 'tbz' + mode = 'r:bz2' + elif archive_filename.endswith('.tar'): + format = 'tar' + mode = 'r' + else: # pragma: no cover + raise ValueError('Unknown format for %r' % archive_filename) + try: + if format == 'zip': + archive = ZipFile(archive_filename, 'r') + if check: + names = archive.namelist() + for name in names: + check_path(name) + else: + archive = tarfile.open(archive_filename, mode) + if check: + names = archive.getnames() + for name in names: + check_path(name) + if format != 'zip' and sys.version_info[0] < 3: + # See Python issue 17153. If the dest path contains Unicode, + # tarfile extraction fails on Python 2.x if a member path name + # contains non-ASCII characters - it leads to an implicit + # bytes -> unicode conversion using ASCII to decode. + for tarinfo in archive.getmembers(): + if not isinstance(tarinfo.name, text_type): + tarinfo.name = tarinfo.name.decode('utf-8') + + # Limit extraction of dangerous items, if this Python + # allows it easily. If not, just trust the input. + # See: https://docs.python.org/3/library/tarfile.html#extraction-filters + def extraction_filter(member, path): + """Run tarfile.tar_filter, but raise the expected ValueError""" + # This is only called if the current Python has tarfile filters + try: + return tarfile.tar_filter(member, path) + except tarfile.FilterError as exc: + raise ValueError(str(exc)) + + archive.extraction_filter = extraction_filter + + archive.extractall(dest_dir) + + finally: + if archive: + archive.close() + + +def zip_dir(directory): + """zip a directory tree into a BytesIO object""" + result = io.BytesIO() + dlen = len(directory) + with ZipFile(result, "w") as zf: + for root, dirs, files in os.walk(directory): + for name in files: + full = os.path.join(root, name) + rel = root[dlen:] + dest = os.path.join(rel, name) + zf.write(full, dest) + return result + + +# +# Simple progress bar +# + +UNITS = ('', 'K', 'M', 'G', 'T', 'P') + + +class Progress(object): + unknown = 'UNKNOWN' + + def __init__(self, minval=0, maxval=100): + assert maxval is None or maxval >= minval + self.min = self.cur = minval + self.max = maxval + self.started = None + self.elapsed = 0 + self.done = False + + def update(self, curval): + assert self.min <= curval + assert self.max is None or curval <= self.max + self.cur = curval + now = time.time() + if self.started is None: + self.started = now + else: + self.elapsed = now - self.started + + def increment(self, incr): + assert incr >= 0 + self.update(self.cur + incr) + + def start(self): + self.update(self.min) + return self + + def stop(self): + if self.max is not None: + self.update(self.max) + self.done = True + + @property + def maximum(self): + return self.unknown if self.max is None else self.max + + @property + def percentage(self): + if self.done: + result = '100 %' + elif self.max is None: + result = ' ?? %' + else: + v = 100.0 * (self.cur - self.min) / (self.max - self.min) + result = '%3d %%' % v + return result + + def format_duration(self, duration): + if (duration <= 0) and self.max is None or self.cur == self.min: + result = '??:??:??' + # elif duration < 1: + # result = '--:--:--' + else: + result = time.strftime('%H:%M:%S', time.gmtime(duration)) + return result + + @property + def ETA(self): + if self.done: + prefix = 'Done' + t = self.elapsed + # import pdb; pdb.set_trace() + else: + prefix = 'ETA ' + if self.max is None: + t = -1 + elif self.elapsed == 0 or (self.cur == self.min): + t = 0 + else: + # import pdb; pdb.set_trace() + t = float(self.max - self.min) + t /= self.cur - self.min + t = (t - 1) * self.elapsed + return '%s: %s' % (prefix, self.format_duration(t)) + + @property + def speed(self): + if self.elapsed == 0: + result = 0.0 + else: + result = (self.cur - self.min) / self.elapsed + for unit in UNITS: + if result < 1000: + break + result /= 1000.0 + return '%d %sB/s' % (result, unit) + + +# +# Glob functionality +# + +RICH_GLOB = re.compile(r'\{([^}]*)\}') +_CHECK_RECURSIVE_GLOB = re.compile(r'[^/\\,{]\*\*|\*\*[^/\\,}]') +_CHECK_MISMATCH_SET = re.compile(r'^[^{]*\}|\{[^}]*$') + + +def iglob(path_glob): + """Extended globbing function that supports ** and {opt1,opt2,opt3}.""" + if _CHECK_RECURSIVE_GLOB.search(path_glob): + msg = """invalid glob %r: recursive glob "**" must be used alone""" + raise ValueError(msg % path_glob) + if _CHECK_MISMATCH_SET.search(path_glob): + msg = """invalid glob %r: mismatching set marker '{' or '}'""" + raise ValueError(msg % path_glob) + return _iglob(path_glob) + + +def _iglob(path_glob): + rich_path_glob = RICH_GLOB.split(path_glob, 1) + if len(rich_path_glob) > 1: + assert len(rich_path_glob) == 3, rich_path_glob + prefix, set, suffix = rich_path_glob + for item in set.split(','): + for path in _iglob(''.join((prefix, item, suffix))): + yield path + else: + if '**' not in path_glob: + for item in std_iglob(path_glob): + yield item + else: + prefix, radical = path_glob.split('**', 1) + if prefix == '': + prefix = '.' + if radical == '': + radical = '*' + else: + # we support both + radical = radical.lstrip('/') + radical = radical.lstrip('\\') + for path, dir, files in os.walk(prefix): + path = os.path.normpath(path) + for fn in _iglob(os.path.join(path, radical)): + yield fn + + +if ssl: + from .compat import (HTTPSHandler as BaseHTTPSHandler, match_hostname, CertificateError) + + # + # HTTPSConnection which verifies certificates/matches domains + # + + class HTTPSConnection(httplib.HTTPSConnection): + ca_certs = None # set this to the path to the certs file (.pem) + check_domain = True # only used if ca_certs is not None + + # noinspection PyPropertyAccess + def connect(self): + sock = socket.create_connection((self.host, self.port), self.timeout) + if getattr(self, '_tunnel_host', False): + self.sock = sock + self._tunnel() + + context = ssl.SSLContext(ssl.PROTOCOL_SSLv23) + if hasattr(ssl, 'OP_NO_SSLv2'): + context.options |= ssl.OP_NO_SSLv2 + if getattr(self, 'cert_file', None): + context.load_cert_chain(self.cert_file, self.key_file) + kwargs = {} + if self.ca_certs: + context.verify_mode = ssl.CERT_REQUIRED + context.load_verify_locations(cafile=self.ca_certs) + if getattr(ssl, 'HAS_SNI', False): + kwargs['server_hostname'] = self.host + + self.sock = context.wrap_socket(sock, **kwargs) + if self.ca_certs and self.check_domain: + try: + match_hostname(self.sock.getpeercert(), self.host) + logger.debug('Host verified: %s', self.host) + except CertificateError: # pragma: no cover + self.sock.shutdown(socket.SHUT_RDWR) + self.sock.close() + raise + + class HTTPSHandler(BaseHTTPSHandler): + + def __init__(self, ca_certs, check_domain=True): + BaseHTTPSHandler.__init__(self) + self.ca_certs = ca_certs + self.check_domain = check_domain + + def _conn_maker(self, *args, **kwargs): + """ + This is called to create a connection instance. Normally you'd + pass a connection class to do_open, but it doesn't actually check for + a class, and just expects a callable. As long as we behave just as a + constructor would have, we should be OK. If it ever changes so that + we *must* pass a class, we'll create an UnsafeHTTPSConnection class + which just sets check_domain to False in the class definition, and + choose which one to pass to do_open. + """ + result = HTTPSConnection(*args, **kwargs) + if self.ca_certs: + result.ca_certs = self.ca_certs + result.check_domain = self.check_domain + return result + + def https_open(self, req): + try: + return self.do_open(self._conn_maker, req) + except URLError as e: + if 'certificate verify failed' in str(e.reason): + raise CertificateError('Unable to verify server certificate ' + 'for %s' % req.host) + else: + raise + + # + # To prevent against mixing HTTP traffic with HTTPS (examples: A Man-In-The- + # Middle proxy using HTTP listens on port 443, or an index mistakenly serves + # HTML containing a http://xyz link when it should be https://xyz), + # you can use the following handler class, which does not allow HTTP traffic. + # + # It works by inheriting from HTTPHandler - so build_opener won't add a + # handler for HTTP itself. + # + class HTTPSOnlyHandler(HTTPSHandler, HTTPHandler): + + def http_open(self, req): + raise URLError('Unexpected HTTP request on what should be a secure ' + 'connection: %s' % req) + + +# +# XML-RPC with timeouts +# +class Transport(xmlrpclib.Transport): + + def __init__(self, timeout, use_datetime=0): + self.timeout = timeout + xmlrpclib.Transport.__init__(self, use_datetime) + + def make_connection(self, host): + h, eh, x509 = self.get_host_info(host) + if not self._connection or host != self._connection[0]: + self._extra_headers = eh + self._connection = host, httplib.HTTPConnection(h) + return self._connection[1] + + +if ssl: + + class SafeTransport(xmlrpclib.SafeTransport): + + def __init__(self, timeout, use_datetime=0): + self.timeout = timeout + xmlrpclib.SafeTransport.__init__(self, use_datetime) + + def make_connection(self, host): + h, eh, kwargs = self.get_host_info(host) + if not kwargs: + kwargs = {} + kwargs['timeout'] = self.timeout + if not self._connection or host != self._connection[0]: + self._extra_headers = eh + self._connection = host, httplib.HTTPSConnection(h, None, **kwargs) + return self._connection[1] + + +class ServerProxy(xmlrpclib.ServerProxy): + + def __init__(self, uri, **kwargs): + self.timeout = timeout = kwargs.pop('timeout', None) + # The above classes only come into play if a timeout + # is specified + if timeout is not None: + # scheme = splittype(uri) # deprecated as of Python 3.8 + scheme = urlparse(uri)[0] + use_datetime = kwargs.get('use_datetime', 0) + if scheme == 'https': + tcls = SafeTransport + else: + tcls = Transport + kwargs['transport'] = t = tcls(timeout, use_datetime=use_datetime) + self.transport = t + xmlrpclib.ServerProxy.__init__(self, uri, **kwargs) + + +# +# CSV functionality. This is provided because on 2.x, the csv module can't +# handle Unicode. However, we need to deal with Unicode in e.g. RECORD files. +# + + +def _csv_open(fn, mode, **kwargs): + if sys.version_info[0] < 3: + mode += 'b' + else: + kwargs['newline'] = '' + # Python 3 determines encoding from locale. Force 'utf-8' + # file encoding to match other forced utf-8 encoding + kwargs['encoding'] = 'utf-8' + return open(fn, mode, **kwargs) + + +class CSVBase(object): + defaults = { + 'delimiter': str(','), # The strs are used because we need native + 'quotechar': str('"'), # str in the csv API (2.x won't take + 'lineterminator': str('\n') # Unicode) + } + + def __enter__(self): + return self + + def __exit__(self, *exc_info): + self.stream.close() + + +class CSVReader(CSVBase): + + def __init__(self, **kwargs): + if 'stream' in kwargs: + stream = kwargs['stream'] + if sys.version_info[0] >= 3: + # needs to be a text stream + stream = codecs.getreader('utf-8')(stream) + self.stream = stream + else: + self.stream = _csv_open(kwargs['path'], 'r') + self.reader = csv.reader(self.stream, **self.defaults) + + def __iter__(self): + return self + + def next(self): + result = next(self.reader) + if sys.version_info[0] < 3: + for i, item in enumerate(result): + if not isinstance(item, text_type): + result[i] = item.decode('utf-8') + return result + + __next__ = next + + +class CSVWriter(CSVBase): + + def __init__(self, fn, **kwargs): + self.stream = _csv_open(fn, 'w') + self.writer = csv.writer(self.stream, **self.defaults) + + def writerow(self, row): + if sys.version_info[0] < 3: + r = [] + for item in row: + if isinstance(item, text_type): + item = item.encode('utf-8') + r.append(item) + row = r + self.writer.writerow(row) + + +# +# Configurator functionality +# + + +class Configurator(BaseConfigurator): + + value_converters = dict(BaseConfigurator.value_converters) + value_converters['inc'] = 'inc_convert' + + def __init__(self, config, base=None): + super(Configurator, self).__init__(config) + self.base = base or os.getcwd() + + def configure_custom(self, config): + + def convert(o): + if isinstance(o, (list, tuple)): + result = type(o)([convert(i) for i in o]) + elif isinstance(o, dict): + if '()' in o: + result = self.configure_custom(o) + else: + result = {} + for k in o: + result[k] = convert(o[k]) + else: + result = self.convert(o) + return result + + c = config.pop('()') + if not callable(c): + c = self.resolve(c) + props = config.pop('.', None) + # Check for valid identifiers + args = config.pop('[]', ()) + if args: + args = tuple([convert(o) for o in args]) + items = [(k, convert(config[k])) for k in config if valid_ident(k)] + kwargs = dict(items) + result = c(*args, **kwargs) + if props: + for n, v in props.items(): + setattr(result, n, convert(v)) + return result + + def __getitem__(self, key): + result = self.config[key] + if isinstance(result, dict) and '()' in result: + self.config[key] = result = self.configure_custom(result) + return result + + def inc_convert(self, value): + """Default converter for the inc:// protocol.""" + if not os.path.isabs(value): + value = os.path.join(self.base, value) + with codecs.open(value, 'r', encoding='utf-8') as f: + result = json.load(f) + return result + + +class SubprocessMixin(object): + """ + Mixin for running subprocesses and capturing their output + """ + + def __init__(self, verbose=False, progress=None): + self.verbose = verbose + self.progress = progress + + def reader(self, stream, context): + """ + Read lines from a subprocess' output stream and either pass to a progress + callable (if specified) or write progress information to sys.stderr. + """ + progress = self.progress + verbose = self.verbose + while True: + s = stream.readline() + if not s: + break + if progress is not None: + progress(s, context) + else: + if not verbose: + sys.stderr.write('.') + else: + sys.stderr.write(s.decode('utf-8')) + sys.stderr.flush() + stream.close() + + def run_command(self, cmd, **kwargs): + p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, **kwargs) + t1 = threading.Thread(target=self.reader, args=(p.stdout, 'stdout')) + t1.start() + t2 = threading.Thread(target=self.reader, args=(p.stderr, 'stderr')) + t2.start() + p.wait() + t1.join() + t2.join() + if self.progress is not None: + self.progress('done.', 'main') + elif self.verbose: + sys.stderr.write('done.\n') + return p + + +def normalize_name(name): + """Normalize a python package name a la PEP 503""" + # https://www.python.org/dev/peps/pep-0503/#normalized-names + return re.sub('[-_.]+', '-', name).lower() + + +# def _get_pypirc_command(): +# """ +# Get the distutils command for interacting with PyPI configurations. +# :return: the command. +# """ +# from distutils.core import Distribution +# from distutils.config import PyPIRCCommand +# d = Distribution() +# return PyPIRCCommand(d) + + +class PyPIRCFile(object): + + DEFAULT_REPOSITORY = 'https://upload.pypi.org/legacy/' + DEFAULT_REALM = 'pypi' + + def __init__(self, fn=None, url=None): + if fn is None: + fn = os.path.join(os.path.expanduser('~'), '.pypirc') + self.filename = fn + self.url = url + + def read(self): + result = {} + + if os.path.exists(self.filename): + repository = self.url or self.DEFAULT_REPOSITORY + + config = configparser.RawConfigParser() + config.read(self.filename) + sections = config.sections() + if 'distutils' in sections: + # let's get the list of servers + index_servers = config.get('distutils', 'index-servers') + _servers = [server.strip() for server in index_servers.split('\n') if server.strip() != ''] + if _servers == []: + # nothing set, let's try to get the default pypi + if 'pypi' in sections: + _servers = ['pypi'] + else: + for server in _servers: + result = {'server': server} + result['username'] = config.get(server, 'username') + + # optional params + for key, default in (('repository', self.DEFAULT_REPOSITORY), ('realm', self.DEFAULT_REALM), + ('password', None)): + if config.has_option(server, key): + result[key] = config.get(server, key) + else: + result[key] = default + + # work around people having "repository" for the "pypi" + # section of their config set to the HTTP (rather than + # HTTPS) URL + if (server == 'pypi' and repository in (self.DEFAULT_REPOSITORY, 'pypi')): + result['repository'] = self.DEFAULT_REPOSITORY + elif (result['server'] != repository and result['repository'] != repository): + result = {} + elif 'server-login' in sections: + # old format + server = 'server-login' + if config.has_option(server, 'repository'): + repository = config.get(server, 'repository') + else: + repository = self.DEFAULT_REPOSITORY + result = { + 'username': config.get(server, 'username'), + 'password': config.get(server, 'password'), + 'repository': repository, + 'server': server, + 'realm': self.DEFAULT_REALM + } + return result + + def update(self, username, password): + # import pdb; pdb.set_trace() + config = configparser.RawConfigParser() + fn = self.filename + config.read(fn) + if not config.has_section('pypi'): + config.add_section('pypi') + config.set('pypi', 'username', username) + config.set('pypi', 'password', password) + with open(fn, 'w') as f: + config.write(f) + + +def _load_pypirc(index): + """ + Read the PyPI access configuration as supported by distutils. + """ + return PyPIRCFile(url=index.url).read() + + +def _store_pypirc(index): + PyPIRCFile().update(index.username, index.password) + + +# +# get_platform()/get_host_platform() copied from Python 3.10.a0 source, with some minor +# tweaks +# + + +def get_host_platform(): + """Return a string that identifies the current platform. This is used mainly to + distinguish platform-specific build directories and platform-specific built + distributions. Typically includes the OS name and version and the + architecture (as supplied by 'os.uname()'), although the exact information + included depends on the OS; eg. on Linux, the kernel version isn't + particularly important. + + Examples of returned values: + linux-i586 + linux-alpha (?) + solaris-2.6-sun4u + + Windows will return one of: + win-amd64 (64bit Windows on AMD64 (aka x86_64, Intel64, EM64T, etc) + win32 (all others - specifically, sys.platform is returned) + + For other non-POSIX platforms, currently just returns 'sys.platform'. + + """ + if os.name == 'nt': + if 'amd64' in sys.version.lower(): + return 'win-amd64' + if '(arm)' in sys.version.lower(): + return 'win-arm32' + if '(arm64)' in sys.version.lower(): + return 'win-arm64' + return sys.platform + + # Set for cross builds explicitly + if "_PYTHON_HOST_PLATFORM" in os.environ: + return os.environ["_PYTHON_HOST_PLATFORM"] + + if os.name != 'posix' or not hasattr(os, 'uname'): + # XXX what about the architecture? NT is Intel or Alpha, + # Mac OS is M68k or PPC, etc. + return sys.platform + + # Try to distinguish various flavours of Unix + + (osname, host, release, version, machine) = os.uname() + + # Convert the OS name to lowercase, remove '/' characters, and translate + # spaces (for "Power Macintosh") + osname = osname.lower().replace('/', '') + machine = machine.replace(' ', '_').replace('/', '-') + + if osname[:5] == 'linux': + # At least on Linux/Intel, 'machine' is the processor -- + # i386, etc. + # XXX what about Alpha, SPARC, etc? + return "%s-%s" % (osname, machine) + + elif osname[:5] == 'sunos': + if release[0] >= '5': # SunOS 5 == Solaris 2 + osname = 'solaris' + release = '%d.%s' % (int(release[0]) - 3, release[2:]) + # We can't use 'platform.architecture()[0]' because a + # bootstrap problem. We use a dict to get an error + # if some suspicious happens. + bitness = {2147483647: '32bit', 9223372036854775807: '64bit'} + machine += '.%s' % bitness[sys.maxsize] + # fall through to standard osname-release-machine representation + elif osname[:3] == 'aix': + from _aix_support import aix_platform + return aix_platform() + elif osname[:6] == 'cygwin': + osname = 'cygwin' + rel_re = re.compile(r'[\d.]+', re.ASCII) + m = rel_re.match(release) + if m: + release = m.group() + elif osname[:6] == 'darwin': + import _osx_support + try: + from distutils import sysconfig + except ImportError: + import sysconfig + osname, release, machine = _osx_support.get_platform_osx(sysconfig.get_config_vars(), osname, release, machine) + + return '%s-%s-%s' % (osname, release, machine) + + +_TARGET_TO_PLAT = { + 'x86': 'win32', + 'x64': 'win-amd64', + 'arm': 'win-arm32', +} + + +def get_platform(): + if os.name != 'nt': + return get_host_platform() + cross_compilation_target = os.environ.get('VSCMD_ARG_TGT_ARCH') + if cross_compilation_target not in _TARGET_TO_PLAT: + return get_host_platform() + return _TARGET_TO_PLAT[cross_compilation_target] diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/version.py b/env/lib/python3.12/site-packages/pip/_vendor/distlib/version.py new file mode 100644 index 0000000..d70a96e --- /dev/null +++ b/env/lib/python3.12/site-packages/pip/_vendor/distlib/version.py @@ -0,0 +1,750 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 The Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +""" +Implementation of a flexible versioning scheme providing support for PEP-440, +setuptools-compatible and semantic versioning. +""" + +import logging +import re + +from .compat import string_types +from .util import parse_requirement + +__all__ = ['NormalizedVersion', 'NormalizedMatcher', + 'LegacyVersion', 'LegacyMatcher', + 'SemanticVersion', 'SemanticMatcher', + 'UnsupportedVersionError', 'get_scheme'] + +logger = logging.getLogger(__name__) + + +class UnsupportedVersionError(ValueError): + """This is an unsupported version.""" + pass + + +class Version(object): + def __init__(self, s): + self._string = s = s.strip() + self._parts = parts = self.parse(s) + assert isinstance(parts, tuple) + assert len(parts) > 0 + + def parse(self, s): + raise NotImplementedError('please implement in a subclass') + + def _check_compatible(self, other): + if type(self) != type(other): + raise TypeError('cannot compare %r and %r' % (self, other)) + + def __eq__(self, other): + self._check_compatible(other) + return self._parts == other._parts + + def __ne__(self, other): + return not self.__eq__(other) + + def __lt__(self, other): + self._check_compatible(other) + return self._parts < other._parts + + def __gt__(self, other): + return not (self.__lt__(other) or self.__eq__(other)) + + def __le__(self, other): + return self.__lt__(other) or self.__eq__(other) + + def __ge__(self, other): + return self.__gt__(other) or self.__eq__(other) + + # See http://docs.python.org/reference/datamodel#object.__hash__ + def __hash__(self): + return hash(self._parts) + + def __repr__(self): + return "%s('%s')" % (self.__class__.__name__, self._string) + + def __str__(self): + return self._string + + @property + def is_prerelease(self): + raise NotImplementedError('Please implement in subclasses.') + + +class Matcher(object): + version_class = None + + # value is either a callable or the name of a method + _operators = { + '<': lambda v, c, p: v < c, + '>': lambda v, c, p: v > c, + '<=': lambda v, c, p: v == c or v < c, + '>=': lambda v, c, p: v == c or v > c, + '==': lambda v, c, p: v == c, + '===': lambda v, c, p: v == c, + # by default, compatible => >=. + '~=': lambda v, c, p: v == c or v > c, + '!=': lambda v, c, p: v != c, + } + + # this is a method only to support alternative implementations + # via overriding + def parse_requirement(self, s): + return parse_requirement(s) + + def __init__(self, s): + if self.version_class is None: + raise ValueError('Please specify a version class') + self._string = s = s.strip() + r = self.parse_requirement(s) + if not r: + raise ValueError('Not valid: %r' % s) + self.name = r.name + self.key = self.name.lower() # for case-insensitive comparisons + clist = [] + if r.constraints: + # import pdb; pdb.set_trace() + for op, s in r.constraints: + if s.endswith('.*'): + if op not in ('==', '!='): + raise ValueError('\'.*\' not allowed for ' + '%r constraints' % op) + # Could be a partial version (e.g. for '2.*') which + # won't parse as a version, so keep it as a string + vn, prefix = s[:-2], True + # Just to check that vn is a valid version + self.version_class(vn) + else: + # Should parse as a version, so we can create an + # instance for the comparison + vn, prefix = self.version_class(s), False + clist.append((op, vn, prefix)) + self._parts = tuple(clist) + + def match(self, version): + """ + Check if the provided version matches the constraints. + + :param version: The version to match against this instance. + :type version: String or :class:`Version` instance. + """ + if isinstance(version, string_types): + version = self.version_class(version) + for operator, constraint, prefix in self._parts: + f = self._operators.get(operator) + if isinstance(f, string_types): + f = getattr(self, f) + if not f: + msg = ('%r not implemented ' + 'for %s' % (operator, self.__class__.__name__)) + raise NotImplementedError(msg) + if not f(version, constraint, prefix): + return False + return True + + @property + def exact_version(self): + result = None + if len(self._parts) == 1 and self._parts[0][0] in ('==', '==='): + result = self._parts[0][1] + return result + + def _check_compatible(self, other): + if type(self) != type(other) or self.name != other.name: + raise TypeError('cannot compare %s and %s' % (self, other)) + + def __eq__(self, other): + self._check_compatible(other) + return self.key == other.key and self._parts == other._parts + + def __ne__(self, other): + return not self.__eq__(other) + + # See http://docs.python.org/reference/datamodel#object.__hash__ + def __hash__(self): + return hash(self.key) + hash(self._parts) + + def __repr__(self): + return "%s(%r)" % (self.__class__.__name__, self._string) + + def __str__(self): + return self._string + + +PEP440_VERSION_RE = re.compile(r'^v?(\d+!)?(\d+(\.\d+)*)((a|alpha|b|beta|c|rc|pre|preview)(\d+)?)?' + r'(\.(post|r|rev)(\d+)?)?([._-]?(dev)(\d+)?)?' + r'(\+([a-zA-Z\d]+(\.[a-zA-Z\d]+)?))?$', re.I) + + +def _pep_440_key(s): + s = s.strip() + m = PEP440_VERSION_RE.match(s) + if not m: + raise UnsupportedVersionError('Not a valid version: %s' % s) + groups = m.groups() + nums = tuple(int(v) for v in groups[1].split('.')) + while len(nums) > 1 and nums[-1] == 0: + nums = nums[:-1] + + if not groups[0]: + epoch = 0 + else: + epoch = int(groups[0][:-1]) + pre = groups[4:6] + post = groups[7:9] + dev = groups[10:12] + local = groups[13] + if pre == (None, None): + pre = () + else: + if pre[1] is None: + pre = pre[0], 0 + else: + pre = pre[0], int(pre[1]) + if post == (None, None): + post = () + else: + if post[1] is None: + post = post[0], 0 + else: + post = post[0], int(post[1]) + if dev == (None, None): + dev = () + else: + if dev[1] is None: + dev = dev[0], 0 + else: + dev = dev[0], int(dev[1]) + if local is None: + local = () + else: + parts = [] + for part in local.split('.'): + # to ensure that numeric compares as > lexicographic, avoid + # comparing them directly, but encode a tuple which ensures + # correct sorting + if part.isdigit(): + part = (1, int(part)) + else: + part = (0, part) + parts.append(part) + local = tuple(parts) + if not pre: + # either before pre-release, or final release and after + if not post and dev: + # before pre-release + pre = ('a', -1) # to sort before a0 + else: + pre = ('z',) # to sort after all pre-releases + # now look at the state of post and dev. + if not post: + post = ('_',) # sort before 'a' + if not dev: + dev = ('final',) + + return epoch, nums, pre, post, dev, local + + +_normalized_key = _pep_440_key + + +class NormalizedVersion(Version): + """A rational version. + + Good: + 1.2 # equivalent to "1.2.0" + 1.2.0 + 1.2a1 + 1.2.3a2 + 1.2.3b1 + 1.2.3c1 + 1.2.3.4 + TODO: fill this out + + Bad: + 1 # minimum two numbers + 1.2a # release level must have a release serial + 1.2.3b + """ + def parse(self, s): + result = _normalized_key(s) + # _normalized_key loses trailing zeroes in the release + # clause, since that's needed to ensure that X.Y == X.Y.0 == X.Y.0.0 + # However, PEP 440 prefix matching needs it: for example, + # (~= 1.4.5.0) matches differently to (~= 1.4.5.0.0). + m = PEP440_VERSION_RE.match(s) # must succeed + groups = m.groups() + self._release_clause = tuple(int(v) for v in groups[1].split('.')) + return result + + PREREL_TAGS = set(['a', 'b', 'c', 'rc', 'dev']) + + @property + def is_prerelease(self): + return any(t[0] in self.PREREL_TAGS for t in self._parts if t) + + +def _match_prefix(x, y): + x = str(x) + y = str(y) + if x == y: + return True + if not x.startswith(y): + return False + n = len(y) + return x[n] == '.' + + +class NormalizedMatcher(Matcher): + version_class = NormalizedVersion + + # value is either a callable or the name of a method + _operators = { + '~=': '_match_compatible', + '<': '_match_lt', + '>': '_match_gt', + '<=': '_match_le', + '>=': '_match_ge', + '==': '_match_eq', + '===': '_match_arbitrary', + '!=': '_match_ne', + } + + def _adjust_local(self, version, constraint, prefix): + if prefix: + strip_local = '+' not in constraint and version._parts[-1] + else: + # both constraint and version are + # NormalizedVersion instances. + # If constraint does not have a local component, + # ensure the version doesn't, either. + strip_local = not constraint._parts[-1] and version._parts[-1] + if strip_local: + s = version._string.split('+', 1)[0] + version = self.version_class(s) + return version, constraint + + def _match_lt(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if version >= constraint: + return False + release_clause = constraint._release_clause + pfx = '.'.join([str(i) for i in release_clause]) + return not _match_prefix(version, pfx) + + def _match_gt(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if version <= constraint: + return False + release_clause = constraint._release_clause + pfx = '.'.join([str(i) for i in release_clause]) + return not _match_prefix(version, pfx) + + def _match_le(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + return version <= constraint + + def _match_ge(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + return version >= constraint + + def _match_eq(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if not prefix: + result = (version == constraint) + else: + result = _match_prefix(version, constraint) + return result + + def _match_arbitrary(self, version, constraint, prefix): + return str(version) == str(constraint) + + def _match_ne(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if not prefix: + result = (version != constraint) + else: + result = not _match_prefix(version, constraint) + return result + + def _match_compatible(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if version == constraint: + return True + if version < constraint: + return False +# if not prefix: +# return True + release_clause = constraint._release_clause + if len(release_clause) > 1: + release_clause = release_clause[:-1] + pfx = '.'.join([str(i) for i in release_clause]) + return _match_prefix(version, pfx) + + +_REPLACEMENTS = ( + (re.compile('[.+-]$'), ''), # remove trailing puncts + (re.compile(r'^[.](\d)'), r'0.\1'), # .N -> 0.N at start + (re.compile('^[.-]'), ''), # remove leading puncts + (re.compile(r'^\((.*)\)$'), r'\1'), # remove parentheses + (re.compile(r'^v(ersion)?\s*(\d+)'), r'\2'), # remove leading v(ersion) + (re.compile(r'^r(ev)?\s*(\d+)'), r'\2'), # remove leading v(ersion) + (re.compile('[.]{2,}'), '.'), # multiple runs of '.' + (re.compile(r'\b(alfa|apha)\b'), 'alpha'), # misspelt alpha + (re.compile(r'\b(pre-alpha|prealpha)\b'), + 'pre.alpha'), # standardise + (re.compile(r'\(beta\)$'), 'beta'), # remove parentheses +) + +_SUFFIX_REPLACEMENTS = ( + (re.compile('^[:~._+-]+'), ''), # remove leading puncts + (re.compile('[,*")([\\]]'), ''), # remove unwanted chars + (re.compile('[~:+_ -]'), '.'), # replace illegal chars + (re.compile('[.]{2,}'), '.'), # multiple runs of '.' + (re.compile(r'\.$'), ''), # trailing '.' +) + +_NUMERIC_PREFIX = re.compile(r'(\d+(\.\d+)*)') + + +def _suggest_semantic_version(s): + """ + Try to suggest a semantic form for a version for which + _suggest_normalized_version couldn't come up with anything. + """ + result = s.strip().lower() + for pat, repl in _REPLACEMENTS: + result = pat.sub(repl, result) + if not result: + result = '0.0.0' + + # Now look for numeric prefix, and separate it out from + # the rest. + # import pdb; pdb.set_trace() + m = _NUMERIC_PREFIX.match(result) + if not m: + prefix = '0.0.0' + suffix = result + else: + prefix = m.groups()[0].split('.') + prefix = [int(i) for i in prefix] + while len(prefix) < 3: + prefix.append(0) + if len(prefix) == 3: + suffix = result[m.end():] + else: + suffix = '.'.join([str(i) for i in prefix[3:]]) + result[m.end():] + prefix = prefix[:3] + prefix = '.'.join([str(i) for i in prefix]) + suffix = suffix.strip() + if suffix: + # import pdb; pdb.set_trace() + # massage the suffix. + for pat, repl in _SUFFIX_REPLACEMENTS: + suffix = pat.sub(repl, suffix) + + if not suffix: + result = prefix + else: + sep = '-' if 'dev' in suffix else '+' + result = prefix + sep + suffix + if not is_semver(result): + result = None + return result + + +def _suggest_normalized_version(s): + """Suggest a normalized version close to the given version string. + + If you have a version string that isn't rational (i.e. NormalizedVersion + doesn't like it) then you might be able to get an equivalent (or close) + rational version from this function. + + This does a number of simple normalizations to the given string, based + on observation of versions currently in use on PyPI. Given a dump of + those version during PyCon 2009, 4287 of them: + - 2312 (53.93%) match NormalizedVersion without change + with the automatic suggestion + - 3474 (81.04%) match when using this suggestion method + + @param s {str} An irrational version string. + @returns A rational version string, or None, if couldn't determine one. + """ + try: + _normalized_key(s) + return s # already rational + except UnsupportedVersionError: + pass + + rs = s.lower() + + # part of this could use maketrans + for orig, repl in (('-alpha', 'a'), ('-beta', 'b'), ('alpha', 'a'), + ('beta', 'b'), ('rc', 'c'), ('-final', ''), + ('-pre', 'c'), + ('-release', ''), ('.release', ''), ('-stable', ''), + ('+', '.'), ('_', '.'), (' ', ''), ('.final', ''), + ('final', '')): + rs = rs.replace(orig, repl) + + # if something ends with dev or pre, we add a 0 + rs = re.sub(r"pre$", r"pre0", rs) + rs = re.sub(r"dev$", r"dev0", rs) + + # if we have something like "b-2" or "a.2" at the end of the + # version, that is probably beta, alpha, etc + # let's remove the dash or dot + rs = re.sub(r"([abc]|rc)[\-\.](\d+)$", r"\1\2", rs) + + # 1.0-dev-r371 -> 1.0.dev371 + # 0.1-dev-r79 -> 0.1.dev79 + rs = re.sub(r"[\-\.](dev)[\-\.]?r?(\d+)$", r".\1\2", rs) + + # Clean: 2.0.a.3, 2.0.b1, 0.9.0~c1 + rs = re.sub(r"[.~]?([abc])\.?", r"\1", rs) + + # Clean: v0.3, v1.0 + if rs.startswith('v'): + rs = rs[1:] + + # Clean leading '0's on numbers. + # TODO: unintended side-effect on, e.g., "2003.05.09" + # PyPI stats: 77 (~2%) better + rs = re.sub(r"\b0+(\d+)(?!\d)", r"\1", rs) + + # Clean a/b/c with no version. E.g. "1.0a" -> "1.0a0". Setuptools infers + # zero. + # PyPI stats: 245 (7.56%) better + rs = re.sub(r"(\d+[abc])$", r"\g<1>0", rs) + + # the 'dev-rNNN' tag is a dev tag + rs = re.sub(r"\.?(dev-r|dev\.r)\.?(\d+)$", r".dev\2", rs) + + # clean the - when used as a pre delimiter + rs = re.sub(r"-(a|b|c)(\d+)$", r"\1\2", rs) + + # a terminal "dev" or "devel" can be changed into ".dev0" + rs = re.sub(r"[\.\-](dev|devel)$", r".dev0", rs) + + # a terminal "dev" can be changed into ".dev0" + rs = re.sub(r"(?![\.\-])dev$", r".dev0", rs) + + # a terminal "final" or "stable" can be removed + rs = re.sub(r"(final|stable)$", "", rs) + + # The 'r' and the '-' tags are post release tags + # 0.4a1.r10 -> 0.4a1.post10 + # 0.9.33-17222 -> 0.9.33.post17222 + # 0.9.33-r17222 -> 0.9.33.post17222 + rs = re.sub(r"\.?(r|-|-r)\.?(\d+)$", r".post\2", rs) + + # Clean 'r' instead of 'dev' usage: + # 0.9.33+r17222 -> 0.9.33.dev17222 + # 1.0dev123 -> 1.0.dev123 + # 1.0.git123 -> 1.0.dev123 + # 1.0.bzr123 -> 1.0.dev123 + # 0.1a0dev.123 -> 0.1a0.dev123 + # PyPI stats: ~150 (~4%) better + rs = re.sub(r"\.?(dev|git|bzr)\.?(\d+)$", r".dev\2", rs) + + # Clean '.pre' (normalized from '-pre' above) instead of 'c' usage: + # 0.2.pre1 -> 0.2c1 + # 0.2-c1 -> 0.2c1 + # 1.0preview123 -> 1.0c123 + # PyPI stats: ~21 (0.62%) better + rs = re.sub(r"\.?(pre|preview|-c)(\d+)$", r"c\g<2>", rs) + + # Tcl/Tk uses "px" for their post release markers + rs = re.sub(r"p(\d+)$", r".post\1", rs) + + try: + _normalized_key(rs) + except UnsupportedVersionError: + rs = None + return rs + +# +# Legacy version processing (distribute-compatible) +# + + +_VERSION_PART = re.compile(r'([a-z]+|\d+|[\.-])', re.I) +_VERSION_REPLACE = { + 'pre': 'c', + 'preview': 'c', + '-': 'final-', + 'rc': 'c', + 'dev': '@', + '': None, + '.': None, +} + + +def _legacy_key(s): + def get_parts(s): + result = [] + for p in _VERSION_PART.split(s.lower()): + p = _VERSION_REPLACE.get(p, p) + if p: + if '0' <= p[:1] <= '9': + p = p.zfill(8) + else: + p = '*' + p + result.append(p) + result.append('*final') + return result + + result = [] + for p in get_parts(s): + if p.startswith('*'): + if p < '*final': + while result and result[-1] == '*final-': + result.pop() + while result and result[-1] == '00000000': + result.pop() + result.append(p) + return tuple(result) + + +class LegacyVersion(Version): + def parse(self, s): + return _legacy_key(s) + + @property + def is_prerelease(self): + result = False + for x in self._parts: + if (isinstance(x, string_types) and x.startswith('*') and x < '*final'): + result = True + break + return result + + +class LegacyMatcher(Matcher): + version_class = LegacyVersion + + _operators = dict(Matcher._operators) + _operators['~='] = '_match_compatible' + + numeric_re = re.compile(r'^(\d+(\.\d+)*)') + + def _match_compatible(self, version, constraint, prefix): + if version < constraint: + return False + m = self.numeric_re.match(str(constraint)) + if not m: + logger.warning('Cannot compute compatible match for version %s ' + ' and constraint %s', version, constraint) + return True + s = m.groups()[0] + if '.' in s: + s = s.rsplit('.', 1)[0] + return _match_prefix(version, s) + +# +# Semantic versioning +# + + +_SEMVER_RE = re.compile(r'^(\d+)\.(\d+)\.(\d+)' + r'(-[a-z0-9]+(\.[a-z0-9-]+)*)?' + r'(\+[a-z0-9]+(\.[a-z0-9-]+)*)?$', re.I) + + +def is_semver(s): + return _SEMVER_RE.match(s) + + +def _semantic_key(s): + def make_tuple(s, absent): + if s is None: + result = (absent,) + else: + parts = s[1:].split('.') + # We can't compare ints and strings on Python 3, so fudge it + # by zero-filling numeric values so simulate a numeric comparison + result = tuple([p.zfill(8) if p.isdigit() else p for p in parts]) + return result + + m = is_semver(s) + if not m: + raise UnsupportedVersionError(s) + groups = m.groups() + major, minor, patch = [int(i) for i in groups[:3]] + # choose the '|' and '*' so that versions sort correctly + pre, build = make_tuple(groups[3], '|'), make_tuple(groups[5], '*') + return (major, minor, patch), pre, build + + +class SemanticVersion(Version): + def parse(self, s): + return _semantic_key(s) + + @property + def is_prerelease(self): + return self._parts[1][0] != '|' + + +class SemanticMatcher(Matcher): + version_class = SemanticVersion + + +class VersionScheme(object): + def __init__(self, key, matcher, suggester=None): + self.key = key + self.matcher = matcher + self.suggester = suggester + + def is_valid_version(self, s): + try: + self.matcher.version_class(s) + result = True + except UnsupportedVersionError: + result = False + return result + + def is_valid_matcher(self, s): + try: + self.matcher(s) + result = True + except UnsupportedVersionError: + result = False + return result + + def is_valid_constraint_list(self, s): + """ + Used for processing some metadata fields + """ + # See issue #140. Be tolerant of a single trailing comma. + if s.endswith(','): + s = s[:-1] + return self.is_valid_matcher('dummy_name (%s)' % s) + + def suggest(self, s): + if self.suggester is None: + result = None + else: + result = self.suggester(s) + return result + + +_SCHEMES = { + 'normalized': VersionScheme(_normalized_key, NormalizedMatcher, + _suggest_normalized_version), + 'legacy': VersionScheme(_legacy_key, LegacyMatcher, lambda self, s: s), + 'semantic': VersionScheme(_semantic_key, SemanticMatcher, + _suggest_semantic_version), +} + +_SCHEMES['default'] = _SCHEMES['normalized'] + + +def get_scheme(name): + if name not in _SCHEMES: + raise ValueError('unknown scheme name: %r' % name) + return _SCHEMES[name] diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/w32.exe b/env/lib/python3.12/site-packages/pip/_vendor/distlib/w32.exe new file mode 100644 index 0000000000000000000000000000000000000000..4ee2d3a31b59e8b50f433ecdf0be9e496e8cc3b8 GIT binary patch literal 91648 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 literal 0 HcmV?d00001 diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/w64-arm.exe b/env/lib/python3.12/site-packages/pip/_vendor/distlib/w64-arm.exe new file mode 100644 index 0000000000000000000000000000000000000000..951d5817c9e6d81c94a173a0d9fead7f1f143331 GIT binary patch literal 168448 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 literal 0 HcmV?d00001 diff --git a/env/lib/python3.12/site-packages/pip/_vendor/distlib/w64.exe b/env/lib/python3.12/site-packages/pip/_vendor/distlib/w64.exe new file mode 100644 index 0000000000000000000000000000000000000000..5763076d2878093971a0ef9870e1cde7f556b18b GIT binary patch literal 101888 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

                                          # pre-release
+            [-_\.]?
+            (?Palpha|a|beta|b|preview|pre|c|rc)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+        (?P                                         # post release
+            (?:-(?P[0-9]+))
+            |
+            (?:
+                [-_\.]?
+                (?Ppost|rev|r)
+                [-_\.]?
+                (?P[0-9]+)?
+            )
+        )?
+        (?P                                          # dev release
+            [-_\.]?
+            (?Pdev)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+    )
+    (?:\+(?P[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
+    
+    >>> v2
+    
+    >>> 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)
+    _key: CmpKey
+
+    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)
+        if not match:
+            raise InvalidVersion(f"Invalid version: {version!r}")
+
+        # Store the parsed out pieces of the version
+        self._version = _Version(
+            epoch=int(match.group("epoch")) if match.group("epoch") else 0,
+            release=tuple(int(i) for i in match.group("release").split(".")),
+            pre=_parse_letter_version(match.group("pre_l"), match.group("pre_n")),
+            post=_parse_letter_version(
+                match.group("post_l"), match.group("post_n1") or match.group("post_n2")
+            ),
+            dev=_parse_letter_version(match.group("dev_l"), match.group("dev_n")),
+            local=_parse_local_version(match.group("local")),
+        )
+
+        # Generate a key which will be used for sorting
+        self._key = _cmpkey(
+            self._version.epoch,
+            self._version.release,
+            self._version.pre,
+            self._version.post,
+            self._version.dev,
+            self._version.local,
+        )
+
+    def __repr__(self) -> str:
+        """A representation of the Version that shows all internal state.
+
+        >>> Version('1.0.0')
+        
+        """
+        return f""
+
+    def __str__(self) -> str:
+        """A string representation of the version that can be round-tripped.
+
+        >>> str(Version("1.0a5"))
+        '1.0a5'
+        """
+        parts = []
+
+        # Epoch
+        if self.epoch != 0:
+            parts.append(f"{self.epoch}!")
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self.release))
+
+        # Pre-release
+        if self.pre is not None:
+            parts.append("".join(str(x) for x in self.pre))
+
+        # Post-release
+        if self.post is not None:
+            parts.append(f".post{self.post}")
+
+        # Development release
+        if self.dev is not None:
+            parts.append(f".dev{self.dev}")
+
+        # Local version segment
+        if self.local is not None:
+            parts.append(f"+{self.local}")
+
+        return "".join(parts)
+
+    @property
+    def epoch(self) -> int:
+        """The epoch of the version.
+
+        >>> Version("2.0.0").epoch
+        0
+        >>> Version("1!2.0.0").epoch
+        1
+        """
+        return self._version.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.
+        """
+        return self._version.release
+
+    @property
+    def pre(self) -> tuple[str, int] | None:
+        """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)
+        """
+        return self._version.pre
+
+    @property
+    def post(self) -> int | None:
+        """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) -> int | None:
+        """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) -> str | None:
+        """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:
+            return None
+
+    @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!1.2.3dev1+abc").public
+        '1!1.2.3.dev1'
+        """
+        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.3dev1+abc").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
+        if self.epoch != 0:
+            parts.append(f"{self.epoch}!")
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self.release))
+
+        return "".join(parts)
+
+    @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
+
+
+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:
+    if letter:
+        # We consider there to be an implicit 0 in a pre-release if there is
+        # not a numeral associated with it.
+        if number is None:
+            number = 0
+
+        # We normalize any letters to their lower case form
+        letter = letter.lower()
+
+        # We consider some words to be alternate spellings of other words and
+        # in those cases we want to normalize the spellings to our preferred
+        # spelling.
+        if letter == "alpha":
+            letter = "a"
+        elif letter == "beta":
+            letter = "b"
+        elif letter in ["c", "pre", "preview"]:
+            letter = "rc"
+        elif letter in ["rev", "r"]:
+            letter = "post"
+
+        return letter, int(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"
+
+        return letter, int(number)
+
+    return None
+
+
+_local_version_separators = re.compile(r"[\._-]")
+
+
+def _parse_local_version(local: str | None) -> LocalType | None:
+    """
+    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
+    """
+    if local is not None:
+        return tuple(
+            part.lower() if not part.isdigit() else int(part)
+            for part in _local_version_separators.split(local)
+        )
+    return None
+
+
+def _cmpkey(
+    epoch: int,
+    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
+    # re-reverse it back into the correct order and make it a tuple and use
+    # that for our sorting key.
+    _release = tuple(
+        reversed(list(itertools.dropwhile(lambda x: x == 0, reversed(release))))
+    )
+
+    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
+    # We'll do this by abusing the pre segment, but we _only_ want to do this
+    # 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: CmpPrePostDevType = NegativeInfinity
+    # Versions without a pre-release (except as noted above) should sort after
+    # those with one.
+    elif pre is None:
+        _pre = Infinity
+    else:
+        _pre = pre
+
+    # Versions without a post segment should sort before those with one.
+    if post is None:
+        _post: CmpPrePostDevType = NegativeInfinity
+
+    else:
+        _post = post
+
+    # Versions without a development segment should sort after those with one.
+    if dev is None:
+        _dev: CmpPrePostDevType = Infinity
+
+    else:
+        _dev = dev
+
+    if local is None:
+        # Versions without a local segment should sort before those with one.
+        _local: CmpLocalType = NegativeInfinity
+    else:
+        # Versions with a local segment need that segment parsed to implement
+        # the sorting rules in PEP440.
+        # - Alpha numeric segments sort before numeric segments
+        # - Alpha numeric segments sort lexicographically
+        # - Numeric segments sort numerically
+        # - Shorter versions sort before longer versions when the prefixes
+        #   match exactly
+        _local = tuple(
+            (i, "") if isinstance(i, int) else (NegativeInfinity, i) for i in local
+        )
+
+    return epoch, _release, _pre, _post, _dev, _local
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__init__.py
new file mode 100644
index 0000000..57ce7f1
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__init__.py
@@ -0,0 +1,3676 @@
+# TODO: Add Generic type annotations to initialized collections.
+# For now we'd simply use implicit Any/Unknown which would add redundant annotations
+# mypy: disable-error-code="var-annotated"
+"""
+Package resource API
+--------------------
+
+A resource is a logical file contained within a package, or a logical
+subdirectory thereof.  The package resource API expects resource names
+to have their path parts separated with ``/``, *not* whatever the local
+path separator is.  Do not use os.path operations to manipulate resource
+names being passed into the API.
+
+The package resource API is designed to work with normal filesystem packages,
+.egg files, and unpacked .egg files.  It can also work in a limited way with
+.zip files and with custom PEP 302 loaders that support the ``get_data()``
+method.
+
+This module is deprecated. Users are directed to :mod:`importlib.resources`,
+:mod:`importlib.metadata` and :pypi:`packaging` instead.
+"""
+
+from __future__ import annotations
+
+import sys
+
+if sys.version_info < (3, 8):  # noqa: UP036 # Check for unsupported versions
+    raise RuntimeError("Python 3.8 or later is required")
+
+import os
+import io
+import time
+import re
+import types
+from typing import (
+    Any,
+    Literal,
+    Dict,
+    Iterator,
+    Mapping,
+    MutableSequence,
+    NamedTuple,
+    NoReturn,
+    Tuple,
+    Union,
+    TYPE_CHECKING,
+    Protocol,
+    Callable,
+    Iterable,
+    TypeVar,
+    overload,
+)
+import zipfile
+import zipimport
+import warnings
+import stat
+import functools
+import pkgutil
+import operator
+import platform
+import collections
+import plistlib
+import email.parser
+import errno
+import tempfile
+import textwrap
+import inspect
+import ntpath
+import posixpath
+import importlib
+import importlib.abc
+import importlib.machinery
+from pkgutil import get_importer
+
+import _imp
+
+# capture these to bypass sandboxing
+from os import utime
+from os import open as os_open
+from os.path import isdir, split
+
+try:
+    from os import mkdir, rename, unlink
+
+    WRITE_SUPPORT = True
+except ImportError:
+    # no write support, probably under GAE
+    WRITE_SUPPORT = False
+
+from pip._internal.utils._jaraco_text import (
+    yield_lines,
+    drop_comment,
+    join_continuation,
+)
+from pip._vendor.packaging import markers as _packaging_markers
+from pip._vendor.packaging import requirements as _packaging_requirements
+from pip._vendor.packaging import utils as _packaging_utils
+from pip._vendor.packaging import version as _packaging_version
+from pip._vendor.platformdirs import user_cache_dir as _user_cache_dir
+
+if TYPE_CHECKING:
+    from _typeshed import BytesPath, StrPath, StrOrBytesPath
+    from pip._vendor.typing_extensions import Self
+
+
+# Patch: Remove deprecation warning from vendored pkg_resources.
+# Setting PYTHONWARNINGS=error to verify builds produce no warnings
+# causes immediate exceptions.
+# See https://github.com/pypa/pip/issues/12243
+
+
+_T = TypeVar("_T")
+_DistributionT = TypeVar("_DistributionT", bound="Distribution")
+# Type aliases
+_NestedStr = Union[str, Iterable[Union[str, Iterable["_NestedStr"]]]]
+_InstallerTypeT = Callable[["Requirement"], "_DistributionT"]
+_InstallerType = Callable[["Requirement"], Union["Distribution", None]]
+_PkgReqType = Union[str, "Requirement"]
+_EPDistType = Union["Distribution", _PkgReqType]
+_MetadataType = Union["IResourceProvider", None]
+_ResolvedEntryPoint = Any  # Can be any attribute in the module
+_ResourceStream = Any  # TODO / Incomplete: A readable file-like object
+# Any object works, but let's indicate we expect something like a module (optionally has __loader__ or __file__)
+_ModuleLike = Union[object, types.ModuleType]
+# Any: Should be _ModuleLike but we end up with issues where _ModuleLike doesn't have _ZipLoaderModule's __loader__
+_ProviderFactoryType = Callable[[Any], "IResourceProvider"]
+_DistFinderType = Callable[[_T, str, bool], Iterable["Distribution"]]
+_NSHandlerType = Callable[[_T, str, str, types.ModuleType], Union[str, None]]
+_AdapterT = TypeVar(
+    "_AdapterT", _DistFinderType[Any], _ProviderFactoryType, _NSHandlerType[Any]
+)
+
+
+# Use _typeshed.importlib.LoaderProtocol once available https://github.com/python/typeshed/pull/11890
+class _LoaderProtocol(Protocol):
+    def load_module(self, fullname: str, /) -> types.ModuleType: ...
+
+
+class _ZipLoaderModule(Protocol):
+    __loader__: zipimport.zipimporter
+
+
+_PEP440_FALLBACK = re.compile(r"^v?(?P(?:[0-9]+!)?[0-9]+(?:\.[0-9]+)*)", re.I)
+
+
+class PEP440Warning(RuntimeWarning):
+    """
+    Used when there is an issue with a version or specifier not complying with
+    PEP 440.
+    """
+
+
+parse_version = _packaging_version.Version
+
+
+_state_vars: dict[str, str] = {}
+
+
+def _declare_state(vartype: str, varname: str, initial_value: _T) -> _T:
+    _state_vars[varname] = vartype
+    return initial_value
+
+
+def __getstate__() -> dict[str, Any]:
+    state = {}
+    g = globals()
+    for k, v in _state_vars.items():
+        state[k] = g['_sget_' + v](g[k])
+    return state
+
+
+def __setstate__(state: dict[str, Any]) -> dict[str, Any]:
+    g = globals()
+    for k, v in state.items():
+        g['_sset_' + _state_vars[k]](k, g[k], v)
+    return state
+
+
+def _sget_dict(val):
+    return val.copy()
+
+
+def _sset_dict(key, ob, state):
+    ob.clear()
+    ob.update(state)
+
+
+def _sget_object(val):
+    return val.__getstate__()
+
+
+def _sset_object(key, ob, state):
+    ob.__setstate__(state)
+
+
+_sget_none = _sset_none = lambda *args: None
+
+
+def get_supported_platform():
+    """Return this platform's maximum compatible version.
+
+    distutils.util.get_platform() normally reports the minimum version
+    of macOS that would be required to *use* extensions produced by
+    distutils.  But what we want when checking compatibility is to know the
+    version of macOS that we are *running*.  To allow usage of packages that
+    explicitly require a newer version of macOS, we must also know the
+    current version of the OS.
+
+    If this condition occurs for any other platform with a version in its
+    platform strings, this function should be extended accordingly.
+    """
+    plat = get_build_platform()
+    m = macosVersionString.match(plat)
+    if m is not None and sys.platform == "darwin":
+        try:
+            plat = 'macosx-%s-%s' % ('.'.join(_macos_vers()[:2]), m.group(3))
+        except ValueError:
+            # not macOS
+            pass
+    return plat
+
+
+__all__ = [
+    # Basic resource access and distribution/entry point discovery
+    'require',
+    'run_script',
+    'get_provider',
+    'get_distribution',
+    'load_entry_point',
+    'get_entry_map',
+    'get_entry_info',
+    'iter_entry_points',
+    'resource_string',
+    'resource_stream',
+    'resource_filename',
+    'resource_listdir',
+    'resource_exists',
+    'resource_isdir',
+    # Environmental control
+    'declare_namespace',
+    'working_set',
+    'add_activation_listener',
+    'find_distributions',
+    'set_extraction_path',
+    'cleanup_resources',
+    'get_default_cache',
+    # Primary implementation classes
+    'Environment',
+    'WorkingSet',
+    'ResourceManager',
+    'Distribution',
+    'Requirement',
+    'EntryPoint',
+    # Exceptions
+    'ResolutionError',
+    'VersionConflict',
+    'DistributionNotFound',
+    'UnknownExtra',
+    'ExtractionError',
+    # Warnings
+    'PEP440Warning',
+    # Parsing functions and string utilities
+    'parse_requirements',
+    'parse_version',
+    'safe_name',
+    'safe_version',
+    'get_platform',
+    'compatible_platforms',
+    'yield_lines',
+    'split_sections',
+    'safe_extra',
+    'to_filename',
+    'invalid_marker',
+    'evaluate_marker',
+    # filesystem utilities
+    'ensure_directory',
+    'normalize_path',
+    # Distribution "precedence" constants
+    'EGG_DIST',
+    'BINARY_DIST',
+    'SOURCE_DIST',
+    'CHECKOUT_DIST',
+    'DEVELOP_DIST',
+    # "Provider" interfaces, implementations, and registration/lookup APIs
+    'IMetadataProvider',
+    'IResourceProvider',
+    'FileMetadata',
+    'PathMetadata',
+    'EggMetadata',
+    'EmptyProvider',
+    'empty_provider',
+    'NullProvider',
+    'EggProvider',
+    'DefaultProvider',
+    'ZipProvider',
+    'register_finder',
+    'register_namespace_handler',
+    'register_loader_type',
+    'fixup_namespace_packages',
+    'get_importer',
+    # Warnings
+    'PkgResourcesDeprecationWarning',
+    # Deprecated/backward compatibility only
+    'run_main',
+    'AvailableDistributions',
+]
+
+
+class ResolutionError(Exception):
+    """Abstract base for dependency resolution errors"""
+
+    def __repr__(self):
+        return self.__class__.__name__ + repr(self.args)
+
+
+class VersionConflict(ResolutionError):
+    """
+    An already-installed version conflicts with the requested version.
+
+    Should be initialized with the installed Distribution and the requested
+    Requirement.
+    """
+
+    _template = "{self.dist} is installed but {self.req} is required"
+
+    @property
+    def dist(self) -> Distribution:
+        return self.args[0]
+
+    @property
+    def req(self) -> Requirement:
+        return self.args[1]
+
+    def report(self):
+        return self._template.format(**locals())
+
+    def with_context(self, required_by: set[Distribution | str]):
+        """
+        If required_by is non-empty, return a version of self that is a
+        ContextualVersionConflict.
+        """
+        if not required_by:
+            return self
+        args = self.args + (required_by,)
+        return ContextualVersionConflict(*args)
+
+
+class ContextualVersionConflict(VersionConflict):
+    """
+    A VersionConflict that accepts a third parameter, the set of the
+    requirements that required the installed Distribution.
+    """
+
+    _template = VersionConflict._template + ' by {self.required_by}'
+
+    @property
+    def required_by(self) -> set[str]:
+        return self.args[2]
+
+
+class DistributionNotFound(ResolutionError):
+    """A requested distribution was not found"""
+
+    _template = (
+        "The '{self.req}' distribution was not found "
+        "and is required by {self.requirers_str}"
+    )
+
+    @property
+    def req(self) -> Requirement:
+        return self.args[0]
+
+    @property
+    def requirers(self) -> set[str] | None:
+        return self.args[1]
+
+    @property
+    def requirers_str(self):
+        if not self.requirers:
+            return 'the application'
+        return ', '.join(self.requirers)
+
+    def report(self):
+        return self._template.format(**locals())
+
+    def __str__(self):
+        return self.report()
+
+
+class UnknownExtra(ResolutionError):
+    """Distribution doesn't have an "extra feature" of the given name"""
+
+
+_provider_factories: dict[type[_ModuleLike], _ProviderFactoryType] = {}
+
+PY_MAJOR = '{}.{}'.format(*sys.version_info)
+EGG_DIST = 3
+BINARY_DIST = 2
+SOURCE_DIST = 1
+CHECKOUT_DIST = 0
+DEVELOP_DIST = -1
+
+
+def register_loader_type(
+    loader_type: type[_ModuleLike], provider_factory: _ProviderFactoryType
+):
+    """Register `provider_factory` to make providers for `loader_type`
+
+    `loader_type` is the type or class of a PEP 302 ``module.__loader__``,
+    and `provider_factory` is a function that, passed a *module* object,
+    returns an ``IResourceProvider`` for that module.
+    """
+    _provider_factories[loader_type] = provider_factory
+
+
+@overload
+def get_provider(moduleOrReq: str) -> IResourceProvider: ...
+@overload
+def get_provider(moduleOrReq: Requirement) -> Distribution: ...
+def get_provider(moduleOrReq: str | Requirement) -> IResourceProvider | Distribution:
+    """Return an IResourceProvider for the named module or requirement"""
+    if isinstance(moduleOrReq, Requirement):
+        return working_set.find(moduleOrReq) or require(str(moduleOrReq))[0]
+    try:
+        module = sys.modules[moduleOrReq]
+    except KeyError:
+        __import__(moduleOrReq)
+        module = sys.modules[moduleOrReq]
+    loader = getattr(module, '__loader__', None)
+    return _find_adapter(_provider_factories, loader)(module)
+
+
+@functools.lru_cache(maxsize=None)
+def _macos_vers():
+    version = platform.mac_ver()[0]
+    # fallback for MacPorts
+    if version == '':
+        plist = '/System/Library/CoreServices/SystemVersion.plist'
+        if os.path.exists(plist):
+            with open(plist, 'rb') as fh:
+                plist_content = plistlib.load(fh)
+            if 'ProductVersion' in plist_content:
+                version = plist_content['ProductVersion']
+    return version.split('.')
+
+
+def _macos_arch(machine):
+    return {'PowerPC': 'ppc', 'Power_Macintosh': 'ppc'}.get(machine, machine)
+
+
+def get_build_platform():
+    """Return this platform's string for platform-specific distributions
+
+    XXX Currently this is the same as ``distutils.util.get_platform()``, but it
+    needs some hacks for Linux and macOS.
+    """
+    from sysconfig import get_platform
+
+    plat = get_platform()
+    if sys.platform == "darwin" and not plat.startswith('macosx-'):
+        try:
+            version = _macos_vers()
+            machine = os.uname()[4].replace(" ", "_")
+            return "macosx-%d.%d-%s" % (
+                int(version[0]),
+                int(version[1]),
+                _macos_arch(machine),
+            )
+        except ValueError:
+            # if someone is running a non-Mac darwin system, this will fall
+            # through to the default implementation
+            pass
+    return plat
+
+
+macosVersionString = re.compile(r"macosx-(\d+)\.(\d+)-(.*)")
+darwinVersionString = re.compile(r"darwin-(\d+)\.(\d+)\.(\d+)-(.*)")
+# XXX backward compat
+get_platform = get_build_platform
+
+
+def compatible_platforms(provided: str | None, required: str | None):
+    """Can code for the `provided` platform run on the `required` platform?
+
+    Returns true if either platform is ``None``, or the platforms are equal.
+
+    XXX Needs compatibility checks for Linux and other unixy OSes.
+    """
+    if provided is None or required is None or provided == required:
+        # easy case
+        return True
+
+    # macOS special cases
+    reqMac = macosVersionString.match(required)
+    if reqMac:
+        provMac = macosVersionString.match(provided)
+
+        # is this a Mac package?
+        if not provMac:
+            # this is backwards compatibility for packages built before
+            # setuptools 0.6. All packages built after this point will
+            # use the new macOS designation.
+            provDarwin = darwinVersionString.match(provided)
+            if provDarwin:
+                dversion = int(provDarwin.group(1))
+                macosversion = "%s.%s" % (reqMac.group(1), reqMac.group(2))
+                if (
+                    dversion == 7
+                    and macosversion >= "10.3"
+                    or dversion == 8
+                    and macosversion >= "10.4"
+                ):
+                    return True
+            # egg isn't macOS or legacy darwin
+            return False
+
+        # are they the same major version and machine type?
+        if provMac.group(1) != reqMac.group(1) or provMac.group(3) != reqMac.group(3):
+            return False
+
+        # is the required OS major update >= the provided one?
+        if int(provMac.group(2)) > int(reqMac.group(2)):
+            return False
+
+        return True
+
+    # XXX Linux and other platforms' special cases should go here
+    return False
+
+
+@overload
+def get_distribution(dist: _DistributionT) -> _DistributionT: ...
+@overload
+def get_distribution(dist: _PkgReqType) -> Distribution: ...
+def get_distribution(dist: Distribution | _PkgReqType) -> Distribution:
+    """Return a current distribution object for a Requirement or string"""
+    if isinstance(dist, str):
+        dist = Requirement.parse(dist)
+    if isinstance(dist, Requirement):
+        # Bad type narrowing, dist has to be a Requirement here, so get_provider has to return Distribution
+        dist = get_provider(dist)  # type: ignore[assignment]
+    if not isinstance(dist, Distribution):
+        raise TypeError("Expected str, Requirement, or Distribution", dist)
+    return dist
+
+
+def load_entry_point(dist: _EPDistType, group: str, name: str) -> _ResolvedEntryPoint:
+    """Return `name` entry point of `group` for `dist` or raise ImportError"""
+    return get_distribution(dist).load_entry_point(group, name)
+
+
+@overload
+def get_entry_map(
+    dist: _EPDistType, group: None = None
+) -> dict[str, dict[str, EntryPoint]]: ...
+@overload
+def get_entry_map(dist: _EPDistType, group: str) -> dict[str, EntryPoint]: ...
+def get_entry_map(dist: _EPDistType, group: str | None = None):
+    """Return the entry point map for `group`, or the full entry map"""
+    return get_distribution(dist).get_entry_map(group)
+
+
+def get_entry_info(dist: _EPDistType, group: str, name: str):
+    """Return the EntryPoint object for `group`+`name`, or ``None``"""
+    return get_distribution(dist).get_entry_info(group, name)
+
+
+class IMetadataProvider(Protocol):
+    def has_metadata(self, name: str) -> bool:
+        """Does the package's distribution contain the named metadata?"""
+
+    def get_metadata(self, name: str) -> str:
+        """The named metadata resource as a string"""
+
+    def get_metadata_lines(self, name: str) -> Iterator[str]:
+        """Yield named metadata resource as list of non-blank non-comment lines
+
+        Leading and trailing whitespace is stripped from each line, and lines
+        with ``#`` as the first non-blank character are omitted."""
+
+    def metadata_isdir(self, name: str) -> bool:
+        """Is the named metadata a directory?  (like ``os.path.isdir()``)"""
+
+    def metadata_listdir(self, name: str) -> list[str]:
+        """List of metadata names in the directory (like ``os.listdir()``)"""
+
+    def run_script(self, script_name: str, namespace: dict[str, Any]) -> None:
+        """Execute the named script in the supplied namespace dictionary"""
+
+
+class IResourceProvider(IMetadataProvider, Protocol):
+    """An object that provides access to package resources"""
+
+    def get_resource_filename(
+        self, manager: ResourceManager, resource_name: str
+    ) -> str:
+        """Return a true filesystem path for `resource_name`
+
+        `manager` must be a ``ResourceManager``"""
+
+    def get_resource_stream(
+        self, manager: ResourceManager, resource_name: str
+    ) -> _ResourceStream:
+        """Return a readable file-like object for `resource_name`
+
+        `manager` must be a ``ResourceManager``"""
+
+    def get_resource_string(
+        self, manager: ResourceManager, resource_name: str
+    ) -> bytes:
+        """Return the contents of `resource_name` as :obj:`bytes`
+
+        `manager` must be a ``ResourceManager``"""
+
+    def has_resource(self, resource_name: str) -> bool:
+        """Does the package contain the named resource?"""
+
+    def resource_isdir(self, resource_name: str) -> bool:
+        """Is the named resource a directory?  (like ``os.path.isdir()``)"""
+
+    def resource_listdir(self, resource_name: str) -> list[str]:
+        """List of resource names in the directory (like ``os.listdir()``)"""
+
+
+class WorkingSet:
+    """A collection of active distributions on sys.path (or a similar list)"""
+
+    def __init__(self, entries: Iterable[str] | None = None):
+        """Create working set from list of path entries (default=sys.path)"""
+        self.entries: list[str] = []
+        self.entry_keys = {}
+        self.by_key = {}
+        self.normalized_to_canonical_keys = {}
+        self.callbacks = []
+
+        if entries is None:
+            entries = sys.path
+
+        for entry in entries:
+            self.add_entry(entry)
+
+    @classmethod
+    def _build_master(cls):
+        """
+        Prepare the master working set.
+        """
+        ws = cls()
+        try:
+            from __main__ import __requires__
+        except ImportError:
+            # The main program does not list any requirements
+            return ws
+
+        # ensure the requirements are met
+        try:
+            ws.require(__requires__)
+        except VersionConflict:
+            return cls._build_from_requirements(__requires__)
+
+        return ws
+
+    @classmethod
+    def _build_from_requirements(cls, req_spec):
+        """
+        Build a working set from a requirement spec. Rewrites sys.path.
+        """
+        # try it without defaults already on sys.path
+        # by starting with an empty path
+        ws = cls([])
+        reqs = parse_requirements(req_spec)
+        dists = ws.resolve(reqs, Environment())
+        for dist in dists:
+            ws.add(dist)
+
+        # add any missing entries from sys.path
+        for entry in sys.path:
+            if entry not in ws.entries:
+                ws.add_entry(entry)
+
+        # then copy back to sys.path
+        sys.path[:] = ws.entries
+        return ws
+
+    def add_entry(self, entry: str):
+        """Add a path item to ``.entries``, finding any distributions on it
+
+        ``find_distributions(entry, True)`` is used to find distributions
+        corresponding to the path entry, and they are added.  `entry` is
+        always appended to ``.entries``, even if it is already present.
+        (This is because ``sys.path`` can contain the same value more than
+        once, and the ``.entries`` of the ``sys.path`` WorkingSet should always
+        equal ``sys.path``.)
+        """
+        self.entry_keys.setdefault(entry, [])
+        self.entries.append(entry)
+        for dist in find_distributions(entry, True):
+            self.add(dist, entry, False)
+
+    def __contains__(self, dist: Distribution) -> bool:
+        """True if `dist` is the active distribution for its project"""
+        return self.by_key.get(dist.key) == dist
+
+    def find(self, req: Requirement) -> Distribution | None:
+        """Find a distribution matching requirement `req`
+
+        If there is an active distribution for the requested project, this
+        returns it as long as it meets the version requirement specified by
+        `req`.  But, if there is an active distribution for the project and it
+        does *not* meet the `req` requirement, ``VersionConflict`` is raised.
+        If there is no active distribution for the requested project, ``None``
+        is returned.
+        """
+        dist = self.by_key.get(req.key)
+
+        if dist is None:
+            canonical_key = self.normalized_to_canonical_keys.get(req.key)
+
+            if canonical_key is not None:
+                req.key = canonical_key
+                dist = self.by_key.get(canonical_key)
+
+        if dist is not None and dist not in req:
+            # XXX add more info
+            raise VersionConflict(dist, req)
+        return dist
+
+    def iter_entry_points(self, group: str, name: str | None = None):
+        """Yield entry point objects from `group` matching `name`
+
+        If `name` is None, yields all entry points in `group` from all
+        distributions in the working set, otherwise only ones matching
+        both `group` and `name` are yielded (in distribution order).
+        """
+        return (
+            entry
+            for dist in self
+            for entry in dist.get_entry_map(group).values()
+            if name is None or name == entry.name
+        )
+
+    def run_script(self, requires: str, script_name: str):
+        """Locate distribution for `requires` and run `script_name` script"""
+        ns = sys._getframe(1).f_globals
+        name = ns['__name__']
+        ns.clear()
+        ns['__name__'] = name
+        self.require(requires)[0].run_script(script_name, ns)
+
+    def __iter__(self) -> Iterator[Distribution]:
+        """Yield distributions for non-duplicate projects in the working set
+
+        The yield order is the order in which the items' path entries were
+        added to the working set.
+        """
+        seen = set()
+        for item in self.entries:
+            if item not in self.entry_keys:
+                # workaround a cache issue
+                continue
+
+            for key in self.entry_keys[item]:
+                if key not in seen:
+                    seen.add(key)
+                    yield self.by_key[key]
+
+    def add(
+        self,
+        dist: Distribution,
+        entry: str | None = None,
+        insert: bool = True,
+        replace: bool = False,
+    ):
+        """Add `dist` to working set, associated with `entry`
+
+        If `entry` is unspecified, it defaults to the ``.location`` of `dist`.
+        On exit from this routine, `entry` is added to the end of the working
+        set's ``.entries`` (if it wasn't already present).
+
+        `dist` is only added to the working set if it's for a project that
+        doesn't already have a distribution in the set, unless `replace=True`.
+        If it's added, any callbacks registered with the ``subscribe()`` method
+        will be called.
+        """
+        if insert:
+            dist.insert_on(self.entries, entry, replace=replace)
+
+        if entry is None:
+            entry = dist.location
+        keys = self.entry_keys.setdefault(entry, [])
+        keys2 = self.entry_keys.setdefault(dist.location, [])
+        if not replace and dist.key in self.by_key:
+            # ignore hidden distros
+            return
+
+        self.by_key[dist.key] = dist
+        normalized_name = _packaging_utils.canonicalize_name(dist.key)
+        self.normalized_to_canonical_keys[normalized_name] = dist.key
+        if dist.key not in keys:
+            keys.append(dist.key)
+        if dist.key not in keys2:
+            keys2.append(dist.key)
+        self._added_new(dist)
+
+    @overload
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None,
+        installer: _InstallerTypeT[_DistributionT],
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[_DistributionT]: ...
+    @overload
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None = None,
+        *,
+        installer: _InstallerTypeT[_DistributionT],
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[_DistributionT]: ...
+    @overload
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None = None,
+        installer: _InstallerType | None = None,
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[Distribution]: ...
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None = None,
+        installer: _InstallerType | None | _InstallerTypeT[_DistributionT] = None,
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[Distribution] | list[_DistributionT]:
+        """List all distributions needed to (recursively) meet `requirements`
+
+        `requirements` must be a sequence of ``Requirement`` objects.  `env`,
+        if supplied, should be an ``Environment`` instance.  If
+        not supplied, it defaults to all distributions available within any
+        entry or distribution in the working set.  `installer`, if supplied,
+        will be invoked with each requirement that cannot be met by an
+        already-installed distribution; it should return a ``Distribution`` or
+        ``None``.
+
+        Unless `replace_conflicting=True`, raises a VersionConflict exception
+        if
+        any requirements are found on the path that have the correct name but
+        the wrong version.  Otherwise, if an `installer` is supplied it will be
+        invoked to obtain the correct version of the requirement and activate
+        it.
+
+        `extras` is a list of the extras to be used with these requirements.
+        This is important because extra requirements may look like `my_req;
+        extra = "my_extra"`, which would otherwise be interpreted as a purely
+        optional requirement.  Instead, we want to be able to assert that these
+        requirements are truly required.
+        """
+
+        # set up the stack
+        requirements = list(requirements)[::-1]
+        # set of processed requirements
+        processed = set()
+        # key -> dist
+        best = {}
+        to_activate = []
+
+        req_extras = _ReqExtras()
+
+        # Mapping of requirement to set of distributions that required it;
+        # useful for reporting info about conflicts.
+        required_by = collections.defaultdict(set)
+
+        while requirements:
+            # process dependencies breadth-first
+            req = requirements.pop(0)
+            if req in processed:
+                # Ignore cyclic or redundant dependencies
+                continue
+
+            if not req_extras.markers_pass(req, extras):
+                continue
+
+            dist = self._resolve_dist(
+                req, best, replace_conflicting, env, installer, required_by, to_activate
+            )
+
+            # push the new requirements onto the stack
+            new_requirements = dist.requires(req.extras)[::-1]
+            requirements.extend(new_requirements)
+
+            # Register the new requirements needed by req
+            for new_requirement in new_requirements:
+                required_by[new_requirement].add(req.project_name)
+                req_extras[new_requirement] = req.extras
+
+            processed.add(req)
+
+        # return list of distros to activate
+        return to_activate
+
+    def _resolve_dist(
+        self, req, best, replace_conflicting, env, installer, required_by, to_activate
+    ) -> Distribution:
+        dist = best.get(req.key)
+        if dist is None:
+            # Find the best distribution and add it to the map
+            dist = self.by_key.get(req.key)
+            if dist is None or (dist not in req and replace_conflicting):
+                ws = self
+                if env is None:
+                    if dist is None:
+                        env = Environment(self.entries)
+                    else:
+                        # Use an empty environment and workingset to avoid
+                        # any further conflicts with the conflicting
+                        # distribution
+                        env = Environment([])
+                        ws = WorkingSet([])
+                dist = best[req.key] = env.best_match(
+                    req, ws, installer, replace_conflicting=replace_conflicting
+                )
+                if dist is None:
+                    requirers = required_by.get(req, None)
+                    raise DistributionNotFound(req, requirers)
+            to_activate.append(dist)
+        if dist not in req:
+            # Oops, the "best" so far conflicts with a dependency
+            dependent_req = required_by[req]
+            raise VersionConflict(dist, req).with_context(dependent_req)
+        return dist
+
+    @overload
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None,
+        installer: _InstallerTypeT[_DistributionT],
+        fallback: bool = True,
+    ) -> tuple[list[_DistributionT], dict[Distribution, Exception]]: ...
+    @overload
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None = None,
+        *,
+        installer: _InstallerTypeT[_DistributionT],
+        fallback: bool = True,
+    ) -> tuple[list[_DistributionT], dict[Distribution, Exception]]: ...
+    @overload
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None = None,
+        installer: _InstallerType | None = None,
+        fallback: bool = True,
+    ) -> tuple[list[Distribution], dict[Distribution, Exception]]: ...
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None = None,
+        installer: _InstallerType | None | _InstallerTypeT[_DistributionT] = None,
+        fallback: bool = True,
+    ) -> tuple[
+        list[Distribution] | list[_DistributionT],
+        dict[Distribution, Exception],
+    ]:
+        """Find all activatable distributions in `plugin_env`
+
+        Example usage::
+
+            distributions, errors = working_set.find_plugins(
+                Environment(plugin_dirlist)
+            )
+            # add plugins+libs to sys.path
+            map(working_set.add, distributions)
+            # display errors
+            print('Could not load', errors)
+
+        The `plugin_env` should be an ``Environment`` instance that contains
+        only distributions that are in the project's "plugin directory" or
+        directories. The `full_env`, if supplied, should be an ``Environment``
+        contains all currently-available distributions.  If `full_env` is not
+        supplied, one is created automatically from the ``WorkingSet`` this
+        method is called on, which will typically mean that every directory on
+        ``sys.path`` will be scanned for distributions.
+
+        `installer` is a standard installer callback as used by the
+        ``resolve()`` method. The `fallback` flag indicates whether we should
+        attempt to resolve older versions of a plugin if the newest version
+        cannot be resolved.
+
+        This method returns a 2-tuple: (`distributions`, `error_info`), where
+        `distributions` is a list of the distributions found in `plugin_env`
+        that were loadable, along with any other distributions that are needed
+        to resolve their dependencies.  `error_info` is a dictionary mapping
+        unloadable plugin distributions to an exception instance describing the
+        error that occurred. Usually this will be a ``DistributionNotFound`` or
+        ``VersionConflict`` instance.
+        """
+
+        plugin_projects = list(plugin_env)
+        # scan project names in alphabetic order
+        plugin_projects.sort()
+
+        error_info: dict[Distribution, Exception] = {}
+        distributions: dict[Distribution, Exception | None] = {}
+
+        if full_env is None:
+            env = Environment(self.entries)
+            env += plugin_env
+        else:
+            env = full_env + plugin_env
+
+        shadow_set = self.__class__([])
+        # put all our entries in shadow_set
+        list(map(shadow_set.add, self))
+
+        for project_name in plugin_projects:
+            for dist in plugin_env[project_name]:
+                req = [dist.as_requirement()]
+
+                try:
+                    resolvees = shadow_set.resolve(req, env, installer)
+
+                except ResolutionError as v:
+                    # save error info
+                    error_info[dist] = v
+                    if fallback:
+                        # try the next older version of project
+                        continue
+                    else:
+                        # give up on this project, keep going
+                        break
+
+                else:
+                    list(map(shadow_set.add, resolvees))
+                    distributions.update(dict.fromkeys(resolvees))
+
+                    # success, no need to try any more versions of this project
+                    break
+
+        sorted_distributions = list(distributions)
+        sorted_distributions.sort()
+
+        return sorted_distributions, error_info
+
+    def require(self, *requirements: _NestedStr):
+        """Ensure that distributions matching `requirements` are activated
+
+        `requirements` must be a string or a (possibly-nested) sequence
+        thereof, specifying the distributions and versions required.  The
+        return value is a sequence of the distributions that needed to be
+        activated to fulfill the requirements; all relevant distributions are
+        included, even if they were already activated in this working set.
+        """
+        needed = self.resolve(parse_requirements(requirements))
+
+        for dist in needed:
+            self.add(dist)
+
+        return needed
+
+    def subscribe(
+        self, callback: Callable[[Distribution], object], existing: bool = True
+    ):
+        """Invoke `callback` for all distributions
+
+        If `existing=True` (default),
+        call on all existing ones, as well.
+        """
+        if callback in self.callbacks:
+            return
+        self.callbacks.append(callback)
+        if not existing:
+            return
+        for dist in self:
+            callback(dist)
+
+    def _added_new(self, dist):
+        for callback in self.callbacks:
+            callback(dist)
+
+    def __getstate__(self):
+        return (
+            self.entries[:],
+            self.entry_keys.copy(),
+            self.by_key.copy(),
+            self.normalized_to_canonical_keys.copy(),
+            self.callbacks[:],
+        )
+
+    def __setstate__(self, e_k_b_n_c):
+        entries, keys, by_key, normalized_to_canonical_keys, callbacks = e_k_b_n_c
+        self.entries = entries[:]
+        self.entry_keys = keys.copy()
+        self.by_key = by_key.copy()
+        self.normalized_to_canonical_keys = normalized_to_canonical_keys.copy()
+        self.callbacks = callbacks[:]
+
+
+class _ReqExtras(Dict["Requirement", Tuple[str, ...]]):
+    """
+    Map each requirement to the extras that demanded it.
+    """
+
+    def markers_pass(self, req: Requirement, extras: tuple[str, ...] | None = None):
+        """
+        Evaluate markers for req against each extra that
+        demanded it.
+
+        Return False if the req has a marker and fails
+        evaluation. Otherwise, return True.
+        """
+        extra_evals = (
+            req.marker.evaluate({'extra': extra})
+            for extra in self.get(req, ()) + (extras or (None,))
+        )
+        return not req.marker or any(extra_evals)
+
+
+class Environment:
+    """Searchable snapshot of distributions on a search path"""
+
+    def __init__(
+        self,
+        search_path: Iterable[str] | None = None,
+        platform: str | None = get_supported_platform(),
+        python: str | None = PY_MAJOR,
+    ):
+        """Snapshot distributions available on a search path
+
+        Any distributions found on `search_path` are added to the environment.
+        `search_path` should be a sequence of ``sys.path`` items.  If not
+        supplied, ``sys.path`` is used.
+
+        `platform` is an optional string specifying the name of the platform
+        that platform-specific distributions must be compatible with.  If
+        unspecified, it defaults to the current platform.  `python` is an
+        optional string naming the desired version of Python (e.g. ``'3.6'``);
+        it defaults to the current version.
+
+        You may explicitly set `platform` (and/or `python`) to ``None`` if you
+        wish to map *all* distributions, not just those compatible with the
+        running platform or Python version.
+        """
+        self._distmap = {}
+        self.platform = platform
+        self.python = python
+        self.scan(search_path)
+
+    def can_add(self, dist: Distribution):
+        """Is distribution `dist` acceptable for this environment?
+
+        The distribution must match the platform and python version
+        requirements specified when this environment was created, or False
+        is returned.
+        """
+        py_compat = (
+            self.python is None
+            or dist.py_version is None
+            or dist.py_version == self.python
+        )
+        return py_compat and compatible_platforms(dist.platform, self.platform)
+
+    def remove(self, dist: Distribution):
+        """Remove `dist` from the environment"""
+        self._distmap[dist.key].remove(dist)
+
+    def scan(self, search_path: Iterable[str] | None = None):
+        """Scan `search_path` for distributions usable in this environment
+
+        Any distributions found are added to the environment.
+        `search_path` should be a sequence of ``sys.path`` items.  If not
+        supplied, ``sys.path`` is used.  Only distributions conforming to
+        the platform/python version defined at initialization are added.
+        """
+        if search_path is None:
+            search_path = sys.path
+
+        for item in search_path:
+            for dist in find_distributions(item):
+                self.add(dist)
+
+    def __getitem__(self, project_name: str) -> list[Distribution]:
+        """Return a newest-to-oldest list of distributions for `project_name`
+
+        Uses case-insensitive `project_name` comparison, assuming all the
+        project's distributions use their project's name converted to all
+        lowercase as their key.
+
+        """
+        distribution_key = project_name.lower()
+        return self._distmap.get(distribution_key, [])
+
+    def add(self, dist: Distribution):
+        """Add `dist` if we ``can_add()`` it and it has not already been added"""
+        if self.can_add(dist) and dist.has_version():
+            dists = self._distmap.setdefault(dist.key, [])
+            if dist not in dists:
+                dists.append(dist)
+                dists.sort(key=operator.attrgetter('hashcmp'), reverse=True)
+
+    @overload
+    def best_match(
+        self,
+        req: Requirement,
+        working_set: WorkingSet,
+        installer: _InstallerTypeT[_DistributionT],
+        replace_conflicting: bool = False,
+    ) -> _DistributionT: ...
+    @overload
+    def best_match(
+        self,
+        req: Requirement,
+        working_set: WorkingSet,
+        installer: _InstallerType | None = None,
+        replace_conflicting: bool = False,
+    ) -> Distribution | None: ...
+    def best_match(
+        self,
+        req: Requirement,
+        working_set: WorkingSet,
+        installer: _InstallerType | None | _InstallerTypeT[_DistributionT] = None,
+        replace_conflicting: bool = False,
+    ) -> Distribution | None:
+        """Find distribution best matching `req` and usable on `working_set`
+
+        This calls the ``find(req)`` method of the `working_set` to see if a
+        suitable distribution is already active.  (This may raise
+        ``VersionConflict`` if an unsuitable version of the project is already
+        active in the specified `working_set`.)  If a suitable distribution
+        isn't active, this method returns the newest distribution in the
+        environment that meets the ``Requirement`` in `req`.  If no suitable
+        distribution is found, and `installer` is supplied, then the result of
+        calling the environment's ``obtain(req, installer)`` method will be
+        returned.
+        """
+        try:
+            dist = working_set.find(req)
+        except VersionConflict:
+            if not replace_conflicting:
+                raise
+            dist = None
+        if dist is not None:
+            return dist
+        for dist in self[req.key]:
+            if dist in req:
+                return dist
+        # try to download/install
+        return self.obtain(req, installer)
+
+    @overload
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: _InstallerTypeT[_DistributionT],
+    ) -> _DistributionT: ...
+    @overload
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: Callable[[Requirement], None] | None = None,
+    ) -> None: ...
+    @overload
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: _InstallerType | None = None,
+    ) -> Distribution | None: ...
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: Callable[[Requirement], None]
+        | _InstallerType
+        | None
+        | _InstallerTypeT[_DistributionT] = None,
+    ) -> Distribution | None:
+        """Obtain a distribution matching `requirement` (e.g. via download)
+
+        Obtain a distro that matches requirement (e.g. via download).  In the
+        base ``Environment`` class, this routine just returns
+        ``installer(requirement)``, unless `installer` is None, in which case
+        None is returned instead.  This method is a hook that allows subclasses
+        to attempt other ways of obtaining a distribution before falling back
+        to the `installer` argument."""
+        return installer(requirement) if installer else None
+
+    def __iter__(self) -> Iterator[str]:
+        """Yield the unique project names of the available distributions"""
+        for key in self._distmap.keys():
+            if self[key]:
+                yield key
+
+    def __iadd__(self, other: Distribution | Environment):
+        """In-place addition of a distribution or environment"""
+        if isinstance(other, Distribution):
+            self.add(other)
+        elif isinstance(other, Environment):
+            for project in other:
+                for dist in other[project]:
+                    self.add(dist)
+        else:
+            raise TypeError("Can't add %r to environment" % (other,))
+        return self
+
+    def __add__(self, other: Distribution | Environment):
+        """Add an environment or distribution to an environment"""
+        new = self.__class__([], platform=None, python=None)
+        for env in self, other:
+            new += env
+        return new
+
+
+# XXX backward compatibility
+AvailableDistributions = Environment
+
+
+class ExtractionError(RuntimeError):
+    """An error occurred extracting a resource
+
+    The following attributes are available from instances of this exception:
+
+    manager
+        The resource manager that raised this exception
+
+    cache_path
+        The base directory for resource extraction
+
+    original_error
+        The exception instance that caused extraction to fail
+    """
+
+    manager: ResourceManager
+    cache_path: str
+    original_error: BaseException | None
+
+
+class ResourceManager:
+    """Manage resource extraction and packages"""
+
+    extraction_path: str | None = None
+
+    def __init__(self):
+        self.cached_files = {}
+
+    def resource_exists(self, package_or_requirement: _PkgReqType, resource_name: str):
+        """Does the named resource exist?"""
+        return get_provider(package_or_requirement).has_resource(resource_name)
+
+    def resource_isdir(self, package_or_requirement: _PkgReqType, resource_name: str):
+        """Is the named resource an existing directory?"""
+        return get_provider(package_or_requirement).resource_isdir(resource_name)
+
+    def resource_filename(
+        self, package_or_requirement: _PkgReqType, resource_name: str
+    ):
+        """Return a true filesystem path for specified resource"""
+        return get_provider(package_or_requirement).get_resource_filename(
+            self, resource_name
+        )
+
+    def resource_stream(self, package_or_requirement: _PkgReqType, resource_name: str):
+        """Return a readable file-like object for specified resource"""
+        return get_provider(package_or_requirement).get_resource_stream(
+            self, resource_name
+        )
+
+    def resource_string(
+        self, package_or_requirement: _PkgReqType, resource_name: str
+    ) -> bytes:
+        """Return specified resource as :obj:`bytes`"""
+        return get_provider(package_or_requirement).get_resource_string(
+            self, resource_name
+        )
+
+    def resource_listdir(self, package_or_requirement: _PkgReqType, resource_name: str):
+        """List the contents of the named resource directory"""
+        return get_provider(package_or_requirement).resource_listdir(resource_name)
+
+    def extraction_error(self) -> NoReturn:
+        """Give an error message for problems extracting file(s)"""
+
+        old_exc = sys.exc_info()[1]
+        cache_path = self.extraction_path or get_default_cache()
+
+        tmpl = textwrap.dedent(
+            """
+            Can't extract file(s) to egg cache
+
+            The following error occurred while trying to extract file(s)
+            to the Python egg cache:
+
+              {old_exc}
+
+            The Python egg cache directory is currently set to:
+
+              {cache_path}
+
+            Perhaps your account does not have write access to this directory?
+            You can change the cache directory by setting the PYTHON_EGG_CACHE
+            environment variable to point to an accessible directory.
+            """
+        ).lstrip()
+        err = ExtractionError(tmpl.format(**locals()))
+        err.manager = self
+        err.cache_path = cache_path
+        err.original_error = old_exc
+        raise err
+
+    def get_cache_path(self, archive_name: str, names: Iterable[StrPath] = ()):
+        """Return absolute location in cache for `archive_name` and `names`
+
+        The parent directory of the resulting path will be created if it does
+        not already exist.  `archive_name` should be the base filename of the
+        enclosing egg (which may not be the name of the enclosing zipfile!),
+        including its ".egg" extension.  `names`, if provided, should be a
+        sequence of path name parts "under" the egg's extraction location.
+
+        This method should only be called by resource providers that need to
+        obtain an extraction location, and only for names they intend to
+        extract, as it tracks the generated names for possible cleanup later.
+        """
+        extract_path = self.extraction_path or get_default_cache()
+        target_path = os.path.join(extract_path, archive_name + '-tmp', *names)
+        try:
+            _bypass_ensure_directory(target_path)
+        except Exception:
+            self.extraction_error()
+
+        self._warn_unsafe_extraction_path(extract_path)
+
+        self.cached_files[target_path] = True
+        return target_path
+
+    @staticmethod
+    def _warn_unsafe_extraction_path(path):
+        """
+        If the default extraction path is overridden and set to an insecure
+        location, such as /tmp, it opens up an opportunity for an attacker to
+        replace an extracted file with an unauthorized payload. Warn the user
+        if a known insecure location is used.
+
+        See Distribute #375 for more details.
+        """
+        if os.name == 'nt' and not path.startswith(os.environ['windir']):
+            # On Windows, permissions are generally restrictive by default
+            #  and temp directories are not writable by other users, so
+            #  bypass the warning.
+            return
+        mode = os.stat(path).st_mode
+        if mode & stat.S_IWOTH or mode & stat.S_IWGRP:
+            msg = (
+                "Extraction path is writable by group/others "
+                "and vulnerable to attack when "
+                "used with get_resource_filename ({path}). "
+                "Consider a more secure "
+                "location (set with .set_extraction_path or the "
+                "PYTHON_EGG_CACHE environment variable)."
+            ).format(**locals())
+            warnings.warn(msg, UserWarning)
+
+    def postprocess(self, tempname: StrOrBytesPath, filename: StrOrBytesPath):
+        """Perform any platform-specific postprocessing of `tempname`
+
+        This is where Mac header rewrites should be done; other platforms don't
+        have anything special they should do.
+
+        Resource providers should call this method ONLY after successfully
+        extracting a compressed resource.  They must NOT call it on resources
+        that are already in the filesystem.
+
+        `tempname` is the current (temporary) name of the file, and `filename`
+        is the name it will be renamed to by the caller after this routine
+        returns.
+        """
+
+        if os.name == 'posix':
+            # Make the resource executable
+            mode = ((os.stat(tempname).st_mode) | 0o555) & 0o7777
+            os.chmod(tempname, mode)
+
+    def set_extraction_path(self, path: str):
+        """Set the base path where resources will be extracted to, if needed.
+
+        If you do not call this routine before any extractions take place, the
+        path defaults to the return value of ``get_default_cache()``.  (Which
+        is based on the ``PYTHON_EGG_CACHE`` environment variable, with various
+        platform-specific fallbacks.  See that routine's documentation for more
+        details.)
+
+        Resources are extracted to subdirectories of this path based upon
+        information given by the ``IResourceProvider``.  You may set this to a
+        temporary directory, but then you must call ``cleanup_resources()`` to
+        delete the extracted files when done.  There is no guarantee that
+        ``cleanup_resources()`` will be able to remove all extracted files.
+
+        (Note: you may not change the extraction path for a given resource
+        manager once resources have been extracted, unless you first call
+        ``cleanup_resources()``.)
+        """
+        if self.cached_files:
+            raise ValueError("Can't change extraction path, files already extracted")
+
+        self.extraction_path = path
+
+    def cleanup_resources(self, force: bool = False) -> list[str]:
+        """
+        Delete all extracted resource files and directories, returning a list
+        of the file and directory names that could not be successfully removed.
+        This function does not have any concurrency protection, so it should
+        generally only be called when the extraction path is a temporary
+        directory exclusive to a single process.  This method is not
+        automatically called; you must call it explicitly or register it as an
+        ``atexit`` function if you wish to ensure cleanup of a temporary
+        directory used for extractions.
+        """
+        # XXX
+        return []
+
+
+def get_default_cache() -> str:
+    """
+    Return the ``PYTHON_EGG_CACHE`` environment variable
+    or a platform-relevant user cache dir for an app
+    named "Python-Eggs".
+    """
+    return os.environ.get('PYTHON_EGG_CACHE') or _user_cache_dir(appname='Python-Eggs')
+
+
+def safe_name(name: str):
+    """Convert an arbitrary string to a standard distribution name
+
+    Any runs of non-alphanumeric/. characters are replaced with a single '-'.
+    """
+    return re.sub('[^A-Za-z0-9.]+', '-', name)
+
+
+def safe_version(version: str):
+    """
+    Convert an arbitrary string to a standard version string
+    """
+    try:
+        # normalize the version
+        return str(_packaging_version.Version(version))
+    except _packaging_version.InvalidVersion:
+        version = version.replace(' ', '.')
+        return re.sub('[^A-Za-z0-9.]+', '-', version)
+
+
+def _forgiving_version(version):
+    """Fallback when ``safe_version`` is not safe enough
+    >>> parse_version(_forgiving_version('0.23ubuntu1'))
+    
+    >>> parse_version(_forgiving_version('0.23-'))
+    
+    >>> parse_version(_forgiving_version('0.-_'))
+    
+    >>> parse_version(_forgiving_version('42.+?1'))
+    
+    >>> parse_version(_forgiving_version('hello world'))
+    
+    """
+    version = version.replace(' ', '.')
+    match = _PEP440_FALLBACK.search(version)
+    if match:
+        safe = match["safe"]
+        rest = version[len(safe) :]
+    else:
+        safe = "0"
+        rest = version
+    local = f"sanitized.{_safe_segment(rest)}".strip(".")
+    return f"{safe}.dev0+{local}"
+
+
+def _safe_segment(segment):
+    """Convert an arbitrary string into a safe segment"""
+    segment = re.sub('[^A-Za-z0-9.]+', '-', segment)
+    segment = re.sub('-[^A-Za-z0-9]+', '-', segment)
+    return re.sub(r'\.[^A-Za-z0-9]+', '.', segment).strip(".-")
+
+
+def safe_extra(extra: str):
+    """Convert an arbitrary string to a standard 'extra' name
+
+    Any runs of non-alphanumeric characters are replaced with a single '_',
+    and the result is always lowercased.
+    """
+    return re.sub('[^A-Za-z0-9.-]+', '_', extra).lower()
+
+
+def to_filename(name: str):
+    """Convert a project or version name to its filename-escaped form
+
+    Any '-' characters are currently replaced with '_'.
+    """
+    return name.replace('-', '_')
+
+
+def invalid_marker(text: str):
+    """
+    Validate text as a PEP 508 environment marker; return an exception
+    if invalid or False otherwise.
+    """
+    try:
+        evaluate_marker(text)
+    except SyntaxError as e:
+        e.filename = None
+        e.lineno = None
+        return e
+    return False
+
+
+def evaluate_marker(text: str, extra: str | None = None) -> bool:
+    """
+    Evaluate a PEP 508 environment marker.
+    Return a boolean indicating the marker result in this environment.
+    Raise SyntaxError if marker is invalid.
+
+    This implementation uses the 'pyparsing' module.
+    """
+    try:
+        marker = _packaging_markers.Marker(text)
+        return marker.evaluate()
+    except _packaging_markers.InvalidMarker as e:
+        raise SyntaxError(e) from e
+
+
+class NullProvider:
+    """Try to implement resources and metadata for arbitrary PEP 302 loaders"""
+
+    egg_name: str | None = None
+    egg_info: str | None = None
+    loader: _LoaderProtocol | None = None
+
+    def __init__(self, module: _ModuleLike):
+        self.loader = getattr(module, '__loader__', None)
+        self.module_path = os.path.dirname(getattr(module, '__file__', ''))
+
+    def get_resource_filename(self, manager: ResourceManager, resource_name: str):
+        return self._fn(self.module_path, resource_name)
+
+    def get_resource_stream(self, manager: ResourceManager, resource_name: str):
+        return io.BytesIO(self.get_resource_string(manager, resource_name))
+
+    def get_resource_string(
+        self, manager: ResourceManager, resource_name: str
+    ) -> bytes:
+        return self._get(self._fn(self.module_path, resource_name))
+
+    def has_resource(self, resource_name: str):
+        return self._has(self._fn(self.module_path, resource_name))
+
+    def _get_metadata_path(self, name):
+        return self._fn(self.egg_info, name)
+
+    def has_metadata(self, name: str) -> bool:
+        if not self.egg_info:
+            return False
+
+        path = self._get_metadata_path(name)
+        return self._has(path)
+
+    def get_metadata(self, name: str):
+        if not self.egg_info:
+            return ""
+        path = self._get_metadata_path(name)
+        value = self._get(path)
+        try:
+            return value.decode('utf-8')
+        except UnicodeDecodeError as exc:
+            # Include the path in the error message to simplify
+            # troubleshooting, and without changing the exception type.
+            exc.reason += ' in {} file at path: {}'.format(name, path)
+            raise
+
+    def get_metadata_lines(self, name: str) -> Iterator[str]:
+        return yield_lines(self.get_metadata(name))
+
+    def resource_isdir(self, resource_name: str):
+        return self._isdir(self._fn(self.module_path, resource_name))
+
+    def metadata_isdir(self, name: str) -> bool:
+        return bool(self.egg_info and self._isdir(self._fn(self.egg_info, name)))
+
+    def resource_listdir(self, resource_name: str):
+        return self._listdir(self._fn(self.module_path, resource_name))
+
+    def metadata_listdir(self, name: str) -> list[str]:
+        if self.egg_info:
+            return self._listdir(self._fn(self.egg_info, name))
+        return []
+
+    def run_script(self, script_name: str, namespace: dict[str, Any]):
+        script = 'scripts/' + script_name
+        if not self.has_metadata(script):
+            raise ResolutionError(
+                "Script {script!r} not found in metadata at {self.egg_info!r}".format(
+                    **locals()
+                ),
+            )
+
+        script_text = self.get_metadata(script).replace('\r\n', '\n')
+        script_text = script_text.replace('\r', '\n')
+        script_filename = self._fn(self.egg_info, script)
+        namespace['__file__'] = script_filename
+        if os.path.exists(script_filename):
+            source = _read_utf8_with_fallback(script_filename)
+            code = compile(source, script_filename, 'exec')
+            exec(code, namespace, namespace)
+        else:
+            from linecache import cache
+
+            cache[script_filename] = (
+                len(script_text),
+                0,
+                script_text.split('\n'),
+                script_filename,
+            )
+            script_code = compile(script_text, script_filename, 'exec')
+            exec(script_code, namespace, namespace)
+
+    def _has(self, path) -> bool:
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _isdir(self, path) -> bool:
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _listdir(self, path) -> list[str]:
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _fn(self, base: str | None, resource_name: str):
+        if base is None:
+            raise TypeError(
+                "`base` parameter in `_fn` is `None`. Either override this method or check the parameter first."
+            )
+        self._validate_resource_path(resource_name)
+        if resource_name:
+            return os.path.join(base, *resource_name.split('/'))
+        return base
+
+    @staticmethod
+    def _validate_resource_path(path):
+        """
+        Validate the resource paths according to the docs.
+        https://setuptools.pypa.io/en/latest/pkg_resources.html#basic-resource-access
+
+        >>> warned = getfixture('recwarn')
+        >>> warnings.simplefilter('always')
+        >>> vrp = NullProvider._validate_resource_path
+        >>> vrp('foo/bar.txt')
+        >>> bool(warned)
+        False
+        >>> vrp('../foo/bar.txt')
+        >>> bool(warned)
+        True
+        >>> warned.clear()
+        >>> vrp('/foo/bar.txt')
+        >>> bool(warned)
+        True
+        >>> vrp('foo/../../bar.txt')
+        >>> bool(warned)
+        True
+        >>> warned.clear()
+        >>> vrp('foo/f../bar.txt')
+        >>> bool(warned)
+        False
+
+        Windows path separators are straight-up disallowed.
+        >>> vrp(r'\\foo/bar.txt')
+        Traceback (most recent call last):
+        ...
+        ValueError: Use of .. or absolute path in a resource path \
+is not allowed.
+
+        >>> vrp(r'C:\\foo/bar.txt')
+        Traceback (most recent call last):
+        ...
+        ValueError: Use of .. or absolute path in a resource path \
+is not allowed.
+
+        Blank values are allowed
+
+        >>> vrp('')
+        >>> bool(warned)
+        False
+
+        Non-string values are not.
+
+        >>> vrp(None)
+        Traceback (most recent call last):
+        ...
+        AttributeError: ...
+        """
+        invalid = (
+            os.path.pardir in path.split(posixpath.sep)
+            or posixpath.isabs(path)
+            or ntpath.isabs(path)
+            or path.startswith("\\")
+        )
+        if not invalid:
+            return
+
+        msg = "Use of .. or absolute path in a resource path is not allowed."
+
+        # Aggressively disallow Windows absolute paths
+        if (path.startswith("\\") or ntpath.isabs(path)) and not posixpath.isabs(path):
+            raise ValueError(msg)
+
+        # for compatibility, warn; in future
+        # raise ValueError(msg)
+        issue_warning(
+            msg[:-1] + " and will raise exceptions in a future release.",
+            DeprecationWarning,
+        )
+
+    def _get(self, path) -> bytes:
+        if hasattr(self.loader, 'get_data') and self.loader:
+            # Already checked get_data exists
+            return self.loader.get_data(path)  # type: ignore[attr-defined]
+        raise NotImplementedError(
+            "Can't perform this operation for loaders without 'get_data()'"
+        )
+
+
+register_loader_type(object, NullProvider)
+
+
+def _parents(path):
+    """
+    yield all parents of path including path
+    """
+    last = None
+    while path != last:
+        yield path
+        last = path
+        path, _ = os.path.split(path)
+
+
+class EggProvider(NullProvider):
+    """Provider based on a virtual filesystem"""
+
+    def __init__(self, module: _ModuleLike):
+        super().__init__(module)
+        self._setup_prefix()
+
+    def _setup_prefix(self):
+        # Assume that metadata may be nested inside a "basket"
+        # of multiple eggs and use module_path instead of .archive.
+        eggs = filter(_is_egg_path, _parents(self.module_path))
+        egg = next(eggs, None)
+        egg and self._set_egg(egg)
+
+    def _set_egg(self, path: str):
+        self.egg_name = os.path.basename(path)
+        self.egg_info = os.path.join(path, 'EGG-INFO')
+        self.egg_root = path
+
+
+class DefaultProvider(EggProvider):
+    """Provides access to package resources in the filesystem"""
+
+    def _has(self, path) -> bool:
+        return os.path.exists(path)
+
+    def _isdir(self, path) -> bool:
+        return os.path.isdir(path)
+
+    def _listdir(self, path):
+        return os.listdir(path)
+
+    def get_resource_stream(self, manager: object, resource_name: str):
+        return open(self._fn(self.module_path, resource_name), 'rb')
+
+    def _get(self, path) -> bytes:
+        with open(path, 'rb') as stream:
+            return stream.read()
+
+    @classmethod
+    def _register(cls):
+        loader_names = (
+            'SourceFileLoader',
+            'SourcelessFileLoader',
+        )
+        for name in loader_names:
+            loader_cls = getattr(importlib.machinery, name, type(None))
+            register_loader_type(loader_cls, cls)
+
+
+DefaultProvider._register()
+
+
+class EmptyProvider(NullProvider):
+    """Provider that returns nothing for all requests"""
+
+    # A special case, we don't want all Providers inheriting from NullProvider to have a potentially None module_path
+    module_path: str | None = None  # type: ignore[assignment]
+
+    _isdir = _has = lambda self, path: False
+
+    def _get(self, path) -> bytes:
+        return b''
+
+    def _listdir(self, path):
+        return []
+
+    def __init__(self):
+        pass
+
+
+empty_provider = EmptyProvider()
+
+
+class ZipManifests(Dict[str, "MemoizedZipManifests.manifest_mod"]):
+    """
+    zip manifest builder
+    """
+
+    # `path` could be `StrPath | IO[bytes]` but that violates the LSP for `MemoizedZipManifests.load`
+    @classmethod
+    def build(cls, path: str):
+        """
+        Build a dictionary similar to the zipimport directory
+        caches, except instead of tuples, store ZipInfo objects.
+
+        Use a platform-specific path separator (os.sep) for the path keys
+        for compatibility with pypy on Windows.
+        """
+        with zipfile.ZipFile(path) as zfile:
+            items = (
+                (
+                    name.replace('/', os.sep),
+                    zfile.getinfo(name),
+                )
+                for name in zfile.namelist()
+            )
+            return dict(items)
+
+    load = build
+
+
+class MemoizedZipManifests(ZipManifests):
+    """
+    Memoized zipfile manifests.
+    """
+
+    class manifest_mod(NamedTuple):
+        manifest: dict[str, zipfile.ZipInfo]
+        mtime: float
+
+    def load(self, path: str) -> dict[str, zipfile.ZipInfo]:  # type: ignore[override] # ZipManifests.load is a classmethod
+        """
+        Load a manifest at path or return a suitable manifest already loaded.
+        """
+        path = os.path.normpath(path)
+        mtime = os.stat(path).st_mtime
+
+        if path not in self or self[path].mtime != mtime:
+            manifest = self.build(path)
+            self[path] = self.manifest_mod(manifest, mtime)
+
+        return self[path].manifest
+
+
+class ZipProvider(EggProvider):
+    """Resource support for zips and eggs"""
+
+    eagers: list[str] | None = None
+    _zip_manifests = MemoizedZipManifests()
+    # ZipProvider's loader should always be a zipimporter or equivalent
+    loader: zipimport.zipimporter
+
+    def __init__(self, module: _ZipLoaderModule):
+        super().__init__(module)
+        self.zip_pre = self.loader.archive + os.sep
+
+    def _zipinfo_name(self, fspath):
+        # Convert a virtual filename (full path to file) into a zipfile subpath
+        # usable with the zipimport directory cache for our target archive
+        fspath = fspath.rstrip(os.sep)
+        if fspath == self.loader.archive:
+            return ''
+        if fspath.startswith(self.zip_pre):
+            return fspath[len(self.zip_pre) :]
+        raise AssertionError("%s is not a subpath of %s" % (fspath, self.zip_pre))
+
+    def _parts(self, zip_path):
+        # Convert a zipfile subpath into an egg-relative path part list.
+        # pseudo-fs path
+        fspath = self.zip_pre + zip_path
+        if fspath.startswith(self.egg_root + os.sep):
+            return fspath[len(self.egg_root) + 1 :].split(os.sep)
+        raise AssertionError("%s is not a subpath of %s" % (fspath, self.egg_root))
+
+    @property
+    def zipinfo(self):
+        return self._zip_manifests.load(self.loader.archive)
+
+    def get_resource_filename(self, manager: ResourceManager, resource_name: str):
+        if not self.egg_name:
+            raise NotImplementedError(
+                "resource_filename() only supported for .egg, not .zip"
+            )
+        # no need to lock for extraction, since we use temp names
+        zip_path = self._resource_to_zip(resource_name)
+        eagers = self._get_eager_resources()
+        if '/'.join(self._parts(zip_path)) in eagers:
+            for name in eagers:
+                self._extract_resource(manager, self._eager_to_zip(name))
+        return self._extract_resource(manager, zip_path)
+
+    @staticmethod
+    def _get_date_and_size(zip_stat):
+        size = zip_stat.file_size
+        # ymdhms+wday, yday, dst
+        date_time = zip_stat.date_time + (0, 0, -1)
+        # 1980 offset already done
+        timestamp = time.mktime(date_time)
+        return timestamp, size
+
+    # FIXME: 'ZipProvider._extract_resource' is too complex (12)
+    def _extract_resource(self, manager: ResourceManager, zip_path) -> str:  # noqa: C901
+        if zip_path in self._index():
+            for name in self._index()[zip_path]:
+                last = self._extract_resource(manager, os.path.join(zip_path, name))
+            # return the extracted directory name
+            return os.path.dirname(last)
+
+        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])
+
+        if not WRITE_SUPPORT:
+            raise OSError(
+                '"os.rename" and "os.unlink" are not supported on this platform'
+            )
+        try:
+            if not self.egg_name:
+                raise OSError(
+                    '"egg_name" is empty. This likely means no egg could be found from the "module_path".'
+                )
+            real_path = manager.get_cache_path(self.egg_name, self._parts(zip_path))
+
+            if self._is_current(real_path, zip_path):
+                return real_path
+
+            outf, tmpnam = _mkstemp(
+                ".$extract",
+                dir=os.path.dirname(real_path),
+            )
+            os.write(outf, self.loader.get_data(zip_path))
+            os.close(outf)
+            utime(tmpnam, (timestamp, timestamp))
+            manager.postprocess(tmpnam, real_path)
+
+            try:
+                rename(tmpnam, real_path)
+
+            except OSError:
+                if os.path.isfile(real_path):
+                    if self._is_current(real_path, zip_path):
+                        # the file became current since it was checked above,
+                        #  so proceed.
+                        return real_path
+                    # Windows, del old file and retry
+                    elif os.name == 'nt':
+                        unlink(real_path)
+                        rename(tmpnam, real_path)
+                        return real_path
+                raise
+
+        except OSError:
+            # report a user-friendly error
+            manager.extraction_error()
+
+        return real_path
+
+    def _is_current(self, file_path, zip_path):
+        """
+        Return True if the file_path is current for this zip_path
+        """
+        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])
+        if not os.path.isfile(file_path):
+            return False
+        stat = os.stat(file_path)
+        if stat.st_size != size or stat.st_mtime != timestamp:
+            return False
+        # check that the contents match
+        zip_contents = self.loader.get_data(zip_path)
+        with open(file_path, 'rb') as f:
+            file_contents = f.read()
+        return zip_contents == file_contents
+
+    def _get_eager_resources(self):
+        if self.eagers is None:
+            eagers = []
+            for name in ('native_libs.txt', 'eager_resources.txt'):
+                if self.has_metadata(name):
+                    eagers.extend(self.get_metadata_lines(name))
+            self.eagers = eagers
+        return self.eagers
+
+    def _index(self):
+        try:
+            return self._dirindex
+        except AttributeError:
+            ind = {}
+            for path in self.zipinfo:
+                parts = path.split(os.sep)
+                while parts:
+                    parent = os.sep.join(parts[:-1])
+                    if parent in ind:
+                        ind[parent].append(parts[-1])
+                        break
+                    else:
+                        ind[parent] = [parts.pop()]
+            self._dirindex = ind
+            return ind
+
+    def _has(self, fspath) -> bool:
+        zip_path = self._zipinfo_name(fspath)
+        return zip_path in self.zipinfo or zip_path in self._index()
+
+    def _isdir(self, fspath) -> bool:
+        return self._zipinfo_name(fspath) in self._index()
+
+    def _listdir(self, fspath):
+        return list(self._index().get(self._zipinfo_name(fspath), ()))
+
+    def _eager_to_zip(self, resource_name: str):
+        return self._zipinfo_name(self._fn(self.egg_root, resource_name))
+
+    def _resource_to_zip(self, resource_name: str):
+        return self._zipinfo_name(self._fn(self.module_path, resource_name))
+
+
+register_loader_type(zipimport.zipimporter, ZipProvider)
+
+
+class FileMetadata(EmptyProvider):
+    """Metadata handler for standalone PKG-INFO files
+
+    Usage::
+
+        metadata = FileMetadata("/path/to/PKG-INFO")
+
+    This provider rejects all data and metadata requests except for PKG-INFO,
+    which is treated as existing, and will be the contents of the file at
+    the provided location.
+    """
+
+    def __init__(self, path: StrPath):
+        self.path = path
+
+    def _get_metadata_path(self, name):
+        return self.path
+
+    def has_metadata(self, name: str) -> bool:
+        return name == 'PKG-INFO' and os.path.isfile(self.path)
+
+    def get_metadata(self, name: str):
+        if name != 'PKG-INFO':
+            raise KeyError("No metadata except PKG-INFO is available")
+
+        with open(self.path, encoding='utf-8', errors="replace") as f:
+            metadata = f.read()
+        self._warn_on_replacement(metadata)
+        return metadata
+
+    def _warn_on_replacement(self, metadata):
+        replacement_char = '�'
+        if replacement_char in metadata:
+            tmpl = "{self.path} could not be properly decoded in UTF-8"
+            msg = tmpl.format(**locals())
+            warnings.warn(msg)
+
+    def get_metadata_lines(self, name: str) -> Iterator[str]:
+        return yield_lines(self.get_metadata(name))
+
+
+class PathMetadata(DefaultProvider):
+    """Metadata provider for egg directories
+
+    Usage::
+
+        # Development eggs:
+
+        egg_info = "/path/to/PackageName.egg-info"
+        base_dir = os.path.dirname(egg_info)
+        metadata = PathMetadata(base_dir, egg_info)
+        dist_name = os.path.splitext(os.path.basename(egg_info))[0]
+        dist = Distribution(basedir, project_name=dist_name, metadata=metadata)
+
+        # Unpacked egg directories:
+
+        egg_path = "/path/to/PackageName-ver-pyver-etc.egg"
+        metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO'))
+        dist = Distribution.from_filename(egg_path, metadata=metadata)
+    """
+
+    def __init__(self, path: str, egg_info: str):
+        self.module_path = path
+        self.egg_info = egg_info
+
+
+class EggMetadata(ZipProvider):
+    """Metadata provider for .egg files"""
+
+    def __init__(self, importer: zipimport.zipimporter):
+        """Create a metadata provider from a zipimporter"""
+
+        self.zip_pre = importer.archive + os.sep
+        self.loader = importer
+        if importer.prefix:
+            self.module_path = os.path.join(importer.archive, importer.prefix)
+        else:
+            self.module_path = importer.archive
+        self._setup_prefix()
+
+
+_distribution_finders: dict[type, _DistFinderType[Any]] = _declare_state(
+    'dict', '_distribution_finders', {}
+)
+
+
+def register_finder(importer_type: type[_T], distribution_finder: _DistFinderType[_T]):
+    """Register `distribution_finder` to find distributions in sys.path items
+
+    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
+    handler), and `distribution_finder` is a callable that, passed a path
+    item and the importer instance, yields ``Distribution`` instances found on
+    that path item.  See ``pkg_resources.find_on_path`` for an example."""
+    _distribution_finders[importer_type] = distribution_finder
+
+
+def find_distributions(path_item: str, only: bool = False):
+    """Yield distributions accessible via `path_item`"""
+    importer = get_importer(path_item)
+    finder = _find_adapter(_distribution_finders, importer)
+    return finder(importer, path_item, only)
+
+
+def find_eggs_in_zip(
+    importer: zipimport.zipimporter, path_item: str, only: bool = False
+) -> Iterator[Distribution]:
+    """
+    Find eggs in zip files; possibly multiple nested eggs.
+    """
+    if importer.archive.endswith('.whl'):
+        # wheels are not supported with this finder
+        # they don't have PKG-INFO metadata, and won't ever contain eggs
+        return
+    metadata = EggMetadata(importer)
+    if metadata.has_metadata('PKG-INFO'):
+        yield Distribution.from_filename(path_item, metadata=metadata)
+    if only:
+        # don't yield nested distros
+        return
+    for subitem in metadata.resource_listdir(''):
+        if _is_egg_path(subitem):
+            subpath = os.path.join(path_item, subitem)
+            dists = find_eggs_in_zip(zipimport.zipimporter(subpath), subpath)
+            yield from dists
+        elif subitem.lower().endswith(('.dist-info', '.egg-info')):
+            subpath = os.path.join(path_item, subitem)
+            submeta = EggMetadata(zipimport.zipimporter(subpath))
+            submeta.egg_info = subpath
+            yield Distribution.from_location(path_item, subitem, submeta)
+
+
+register_finder(zipimport.zipimporter, find_eggs_in_zip)
+
+
+def find_nothing(
+    importer: object | None, path_item: str | None, only: bool | None = False
+):
+    return ()
+
+
+register_finder(object, find_nothing)
+
+
+def find_on_path(importer: object | None, path_item, only=False):
+    """Yield distributions accessible on a sys.path directory"""
+    path_item = _normalize_cached(path_item)
+
+    if _is_unpacked_egg(path_item):
+        yield Distribution.from_filename(
+            path_item,
+            metadata=PathMetadata(path_item, os.path.join(path_item, 'EGG-INFO')),
+        )
+        return
+
+    entries = (os.path.join(path_item, child) for child in safe_listdir(path_item))
+
+    # scan for .egg and .egg-info in directory
+    for entry in sorted(entries):
+        fullpath = os.path.join(path_item, entry)
+        factory = dist_factory(path_item, entry, only)
+        yield from factory(fullpath)
+
+
+def dist_factory(path_item, entry, only):
+    """Return a dist_factory for the given entry."""
+    lower = entry.lower()
+    is_egg_info = lower.endswith('.egg-info')
+    is_dist_info = lower.endswith('.dist-info') and os.path.isdir(
+        os.path.join(path_item, entry)
+    )
+    is_meta = is_egg_info or is_dist_info
+    return (
+        distributions_from_metadata
+        if is_meta
+        else find_distributions
+        if not only and _is_egg_path(entry)
+        else resolve_egg_link
+        if not only and lower.endswith('.egg-link')
+        else NoDists()
+    )
+
+
+class NoDists:
+    """
+    >>> bool(NoDists())
+    False
+
+    >>> list(NoDists()('anything'))
+    []
+    """
+
+    def __bool__(self):
+        return False
+
+    def __call__(self, fullpath):
+        return iter(())
+
+
+def safe_listdir(path: StrOrBytesPath):
+    """
+    Attempt to list contents of path, but suppress some exceptions.
+    """
+    try:
+        return os.listdir(path)
+    except (PermissionError, NotADirectoryError):
+        pass
+    except OSError as e:
+        # Ignore the directory if does not exist, not a directory or
+        # permission denied
+        if e.errno not in (errno.ENOTDIR, errno.EACCES, errno.ENOENT):
+            raise
+    return ()
+
+
+def distributions_from_metadata(path: str):
+    root = os.path.dirname(path)
+    if os.path.isdir(path):
+        if len(os.listdir(path)) == 0:
+            # empty metadata dir; skip
+            return
+        metadata: _MetadataType = PathMetadata(root, path)
+    else:
+        metadata = FileMetadata(path)
+    entry = os.path.basename(path)
+    yield Distribution.from_location(
+        root,
+        entry,
+        metadata,
+        precedence=DEVELOP_DIST,
+    )
+
+
+def non_empty_lines(path):
+    """
+    Yield non-empty lines from file at path
+    """
+    for line in _read_utf8_with_fallback(path).splitlines():
+        line = line.strip()
+        if line:
+            yield line
+
+
+def resolve_egg_link(path):
+    """
+    Given a path to an .egg-link, resolve distributions
+    present in the referenced path.
+    """
+    referenced_paths = non_empty_lines(path)
+    resolved_paths = (
+        os.path.join(os.path.dirname(path), ref) for ref in referenced_paths
+    )
+    dist_groups = map(find_distributions, resolved_paths)
+    return next(dist_groups, ())
+
+
+if hasattr(pkgutil, 'ImpImporter'):
+    register_finder(pkgutil.ImpImporter, find_on_path)
+
+register_finder(importlib.machinery.FileFinder, find_on_path)
+
+_namespace_handlers: dict[type, _NSHandlerType[Any]] = _declare_state(
+    'dict', '_namespace_handlers', {}
+)
+_namespace_packages: dict[str | None, list[str]] = _declare_state(
+    'dict', '_namespace_packages', {}
+)
+
+
+def register_namespace_handler(
+    importer_type: type[_T], namespace_handler: _NSHandlerType[_T]
+):
+    """Register `namespace_handler` to declare namespace packages
+
+    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
+    handler), and `namespace_handler` is a callable like this::
+
+        def namespace_handler(importer, path_entry, moduleName, module):
+            # return a path_entry to use for child packages
+
+    Namespace handlers are only called if the importer object has already
+    agreed that it can handle the relevant path item, and they should only
+    return a subpath if the module __path__ does not already contain an
+    equivalent subpath.  For an example namespace handler, see
+    ``pkg_resources.file_ns_handler``.
+    """
+    _namespace_handlers[importer_type] = namespace_handler
+
+
+def _handle_ns(packageName, path_item):
+    """Ensure that named package includes a subpath of path_item (if needed)"""
+
+    importer = get_importer(path_item)
+    if importer is None:
+        return None
+
+    # use find_spec (PEP 451) and fall-back to find_module (PEP 302)
+    try:
+        spec = importer.find_spec(packageName)
+    except AttributeError:
+        # capture warnings due to #1111
+        with warnings.catch_warnings():
+            warnings.simplefilter("ignore")
+            loader = importer.find_module(packageName)
+    else:
+        loader = spec.loader if spec else None
+
+    if loader is None:
+        return None
+    module = sys.modules.get(packageName)
+    if module is None:
+        module = sys.modules[packageName] = types.ModuleType(packageName)
+        module.__path__ = []
+        _set_parent_ns(packageName)
+    elif not hasattr(module, '__path__'):
+        raise TypeError("Not a package:", packageName)
+    handler = _find_adapter(_namespace_handlers, importer)
+    subpath = handler(importer, path_item, packageName, module)
+    if subpath is not None:
+        path = module.__path__
+        path.append(subpath)
+        importlib.import_module(packageName)
+        _rebuild_mod_path(path, packageName, module)
+    return subpath
+
+
+def _rebuild_mod_path(orig_path, package_name, module: types.ModuleType):
+    """
+    Rebuild module.__path__ ensuring that all entries are ordered
+    corresponding to their sys.path order
+    """
+    sys_path = [_normalize_cached(p) for p in sys.path]
+
+    def safe_sys_path_index(entry):
+        """
+        Workaround for #520 and #513.
+        """
+        try:
+            return sys_path.index(entry)
+        except ValueError:
+            return float('inf')
+
+    def position_in_sys_path(path):
+        """
+        Return the ordinal of the path based on its position in sys.path
+        """
+        path_parts = path.split(os.sep)
+        module_parts = package_name.count('.') + 1
+        parts = path_parts[:-module_parts]
+        return safe_sys_path_index(_normalize_cached(os.sep.join(parts)))
+
+    new_path = sorted(orig_path, key=position_in_sys_path)
+    new_path = [_normalize_cached(p) for p in new_path]
+
+    if isinstance(module.__path__, list):
+        module.__path__[:] = new_path
+    else:
+        module.__path__ = new_path
+
+
+def declare_namespace(packageName: str):
+    """Declare that package 'packageName' is a namespace package"""
+
+    msg = (
+        f"Deprecated call to `pkg_resources.declare_namespace({packageName!r})`.\n"
+        "Implementing implicit namespace packages (as specified in PEP 420) "
+        "is preferred to `pkg_resources.declare_namespace`. "
+        "See https://setuptools.pypa.io/en/latest/references/"
+        "keywords.html#keyword-namespace-packages"
+    )
+    warnings.warn(msg, DeprecationWarning, stacklevel=2)
+
+    _imp.acquire_lock()
+    try:
+        if packageName in _namespace_packages:
+            return
+
+        path: MutableSequence[str] = sys.path
+        parent, _, _ = packageName.rpartition('.')
+
+        if parent:
+            declare_namespace(parent)
+            if parent not in _namespace_packages:
+                __import__(parent)
+            try:
+                path = sys.modules[parent].__path__
+            except AttributeError as e:
+                raise TypeError("Not a package:", parent) from e
+
+        # Track what packages are namespaces, so when new path items are added,
+        # they can be updated
+        _namespace_packages.setdefault(parent or None, []).append(packageName)
+        _namespace_packages.setdefault(packageName, [])
+
+        for path_item in path:
+            # Ensure all the parent's path items are reflected in the child,
+            # if they apply
+            _handle_ns(packageName, path_item)
+
+    finally:
+        _imp.release_lock()
+
+
+def fixup_namespace_packages(path_item: str, parent: str | None = None):
+    """Ensure that previously-declared namespace packages include path_item"""
+    _imp.acquire_lock()
+    try:
+        for package in _namespace_packages.get(parent, ()):
+            subpath = _handle_ns(package, path_item)
+            if subpath:
+                fixup_namespace_packages(subpath, package)
+    finally:
+        _imp.release_lock()
+
+
+def file_ns_handler(
+    importer: object,
+    path_item: StrPath,
+    packageName: str,
+    module: types.ModuleType,
+):
+    """Compute an ns-package subpath for a filesystem or zipfile importer"""
+
+    subpath = os.path.join(path_item, packageName.split('.')[-1])
+    normalized = _normalize_cached(subpath)
+    for item in module.__path__:
+        if _normalize_cached(item) == normalized:
+            break
+    else:
+        # Only return the path if it's not already there
+        return subpath
+
+
+if hasattr(pkgutil, 'ImpImporter'):
+    register_namespace_handler(pkgutil.ImpImporter, file_ns_handler)
+
+register_namespace_handler(zipimport.zipimporter, file_ns_handler)
+register_namespace_handler(importlib.machinery.FileFinder, file_ns_handler)
+
+
+def null_ns_handler(
+    importer: object,
+    path_item: str | None,
+    packageName: str | None,
+    module: _ModuleLike | None,
+):
+    return None
+
+
+register_namespace_handler(object, null_ns_handler)
+
+
+@overload
+def normalize_path(filename: StrPath) -> str: ...
+@overload
+def normalize_path(filename: BytesPath) -> bytes: ...
+def normalize_path(filename: StrOrBytesPath):
+    """Normalize a file/dir name for comparison purposes"""
+    return os.path.normcase(os.path.realpath(os.path.normpath(_cygwin_patch(filename))))
+
+
+def _cygwin_patch(filename: StrOrBytesPath):  # pragma: nocover
+    """
+    Contrary to POSIX 2008, on Cygwin, getcwd (3) contains
+    symlink components. Using
+    os.path.abspath() works around this limitation. A fix in os.getcwd()
+    would probably better, in Cygwin even more so, except
+    that this seems to be by design...
+    """
+    return os.path.abspath(filename) if sys.platform == 'cygwin' else filename
+
+
+if TYPE_CHECKING:
+    # https://github.com/python/mypy/issues/16261
+    # https://github.com/python/typeshed/issues/6347
+    @overload
+    def _normalize_cached(filename: StrPath) -> str: ...
+    @overload
+    def _normalize_cached(filename: BytesPath) -> bytes: ...
+    def _normalize_cached(filename: StrOrBytesPath) -> str | bytes: ...
+else:
+
+    @functools.lru_cache(maxsize=None)
+    def _normalize_cached(filename):
+        return normalize_path(filename)
+
+
+def _is_egg_path(path):
+    """
+    Determine if given path appears to be an egg.
+    """
+    return _is_zip_egg(path) or _is_unpacked_egg(path)
+
+
+def _is_zip_egg(path):
+    return (
+        path.lower().endswith('.egg')
+        and os.path.isfile(path)
+        and zipfile.is_zipfile(path)
+    )
+
+
+def _is_unpacked_egg(path):
+    """
+    Determine if given path appears to be an unpacked egg.
+    """
+    return path.lower().endswith('.egg') and os.path.isfile(
+        os.path.join(path, 'EGG-INFO', 'PKG-INFO')
+    )
+
+
+def _set_parent_ns(packageName):
+    parts = packageName.split('.')
+    name = parts.pop()
+    if parts:
+        parent = '.'.join(parts)
+        setattr(sys.modules[parent], name, sys.modules[packageName])
+
+
+MODULE = re.compile(r"\w+(\.\w+)*$").match
+EGG_NAME = re.compile(
+    r"""
+    (?P[^-]+) (
+        -(?P[^-]+) (
+            -py(?P[^-]+) (
+                -(?P.+)
+            )?
+        )?
+    )?
+    """,
+    re.VERBOSE | re.IGNORECASE,
+).match
+
+
+class EntryPoint:
+    """Object representing an advertised importable object"""
+
+    def __init__(
+        self,
+        name: str,
+        module_name: str,
+        attrs: Iterable[str] = (),
+        extras: Iterable[str] = (),
+        dist: Distribution | None = None,
+    ):
+        if not MODULE(module_name):
+            raise ValueError("Invalid module name", module_name)
+        self.name = name
+        self.module_name = module_name
+        self.attrs = tuple(attrs)
+        self.extras = tuple(extras)
+        self.dist = dist
+
+    def __str__(self):
+        s = "%s = %s" % (self.name, self.module_name)
+        if self.attrs:
+            s += ':' + '.'.join(self.attrs)
+        if self.extras:
+            s += ' [%s]' % ','.join(self.extras)
+        return s
+
+    def __repr__(self):
+        return "EntryPoint.parse(%r)" % str(self)
+
+    @overload
+    def load(
+        self,
+        require: Literal[True] = True,
+        env: Environment | None = None,
+        installer: _InstallerType | None = None,
+    ) -> _ResolvedEntryPoint: ...
+    @overload
+    def load(
+        self,
+        require: Literal[False],
+        *args: Any,
+        **kwargs: Any,
+    ) -> _ResolvedEntryPoint: ...
+    def load(
+        self,
+        require: bool = True,
+        *args: Environment | _InstallerType | None,
+        **kwargs: Environment | _InstallerType | None,
+    ) -> _ResolvedEntryPoint:
+        """
+        Require packages for this EntryPoint, then resolve it.
+        """
+        if not require or args or kwargs:
+            warnings.warn(
+                "Parameters to load are deprecated.  Call .resolve and "
+                ".require separately.",
+                PkgResourcesDeprecationWarning,
+                stacklevel=2,
+            )
+        if require:
+            # We could pass `env` and `installer` directly,
+            # but keeping `*args` and `**kwargs` for backwards compatibility
+            self.require(*args, **kwargs)  # type: ignore
+        return self.resolve()
+
+    def resolve(self) -> _ResolvedEntryPoint:
+        """
+        Resolve the entry point from its module and attrs.
+        """
+        module = __import__(self.module_name, fromlist=['__name__'], level=0)
+        try:
+            return functools.reduce(getattr, self.attrs, module)
+        except AttributeError as exc:
+            raise ImportError(str(exc)) from exc
+
+    def require(
+        self,
+        env: Environment | None = None,
+        installer: _InstallerType | None = None,
+    ):
+        if not self.dist:
+            error_cls = UnknownExtra if self.extras else AttributeError
+            raise error_cls("Can't require() without a distribution", self)
+
+        # Get the requirements for this entry point with all its extras and
+        # then resolve them. We have to pass `extras` along when resolving so
+        # that the working set knows what extras we want. Otherwise, for
+        # dist-info distributions, the working set will assume that the
+        # requirements for that extra are purely optional and skip over them.
+        reqs = self.dist.requires(self.extras)
+        items = working_set.resolve(reqs, env, installer, extras=self.extras)
+        list(map(working_set.add, items))
+
+    pattern = re.compile(
+        r'\s*'
+        r'(?P.+?)\s*'
+        r'=\s*'
+        r'(?P[\w.]+)\s*'
+        r'(:\s*(?P[\w.]+))?\s*'
+        r'(?P\[.*\])?\s*$'
+    )
+
+    @classmethod
+    def parse(cls, src: str, dist: Distribution | None = None):
+        """Parse a single entry point from string `src`
+
+        Entry point syntax follows the form::
+
+            name = some.module:some.attr [extra1, extra2]
+
+        The entry name and module name are required, but the ``:attrs`` and
+        ``[extras]`` parts are optional
+        """
+        m = cls.pattern.match(src)
+        if not m:
+            msg = "EntryPoint must be in 'name=module:attrs [extras]' format"
+            raise ValueError(msg, src)
+        res = m.groupdict()
+        extras = cls._parse_extras(res['extras'])
+        attrs = res['attr'].split('.') if res['attr'] else ()
+        return cls(res['name'], res['module'], attrs, extras, dist)
+
+    @classmethod
+    def _parse_extras(cls, extras_spec):
+        if not extras_spec:
+            return ()
+        req = Requirement.parse('x' + extras_spec)
+        if req.specs:
+            raise ValueError
+        return req.extras
+
+    @classmethod
+    def parse_group(
+        cls,
+        group: str,
+        lines: _NestedStr,
+        dist: Distribution | None = None,
+    ):
+        """Parse an entry point group"""
+        if not MODULE(group):
+            raise ValueError("Invalid group name", group)
+        this: dict[str, Self] = {}
+        for line in yield_lines(lines):
+            ep = cls.parse(line, dist)
+            if ep.name in this:
+                raise ValueError("Duplicate entry point", group, ep.name)
+            this[ep.name] = ep
+        return this
+
+    @classmethod
+    def parse_map(
+        cls,
+        data: str | Iterable[str] | dict[str, str | Iterable[str]],
+        dist: Distribution | None = None,
+    ):
+        """Parse a map of entry point groups"""
+        _data: Iterable[tuple[str | None, str | Iterable[str]]]
+        if isinstance(data, dict):
+            _data = data.items()
+        else:
+            _data = split_sections(data)
+        maps: dict[str, dict[str, Self]] = {}
+        for group, lines in _data:
+            if group is None:
+                if not lines:
+                    continue
+                raise ValueError("Entry points must be listed in groups")
+            group = group.strip()
+            if group in maps:
+                raise ValueError("Duplicate group name", group)
+            maps[group] = cls.parse_group(group, lines, dist)
+        return maps
+
+
+def _version_from_file(lines):
+    """
+    Given an iterable of lines from a Metadata file, return
+    the value of the Version field, if present, or None otherwise.
+    """
+
+    def is_version_line(line):
+        return line.lower().startswith('version:')
+
+    version_lines = filter(is_version_line, lines)
+    line = next(iter(version_lines), '')
+    _, _, value = line.partition(':')
+    return safe_version(value.strip()) or None
+
+
+class Distribution:
+    """Wrap an actual or potential sys.path entry w/metadata"""
+
+    PKG_INFO = 'PKG-INFO'
+
+    def __init__(
+        self,
+        location: str | None = None,
+        metadata: _MetadataType = None,
+        project_name: str | None = None,
+        version: str | None = None,
+        py_version: str | None = PY_MAJOR,
+        platform: str | None = None,
+        precedence: int = EGG_DIST,
+    ):
+        self.project_name = safe_name(project_name or 'Unknown')
+        if version is not None:
+            self._version = safe_version(version)
+        self.py_version = py_version
+        self.platform = platform
+        self.location = location
+        self.precedence = precedence
+        self._provider = metadata or empty_provider
+
+    @classmethod
+    def from_location(
+        cls,
+        location: str,
+        basename: StrPath,
+        metadata: _MetadataType = None,
+        **kw: int,  # We could set `precedence` explicitly, but keeping this as `**kw` for full backwards and subclassing compatibility
+    ) -> Distribution:
+        project_name, version, py_version, platform = [None] * 4
+        basename, ext = os.path.splitext(basename)
+        if ext.lower() in _distributionImpl:
+            cls = _distributionImpl[ext.lower()]
+
+            match = EGG_NAME(basename)
+            if match:
+                project_name, version, py_version, platform = match.group(
+                    'name', 'ver', 'pyver', 'plat'
+                )
+        return cls(
+            location,
+            metadata,
+            project_name=project_name,
+            version=version,
+            py_version=py_version,
+            platform=platform,
+            **kw,
+        )._reload_version()
+
+    def _reload_version(self):
+        return self
+
+    @property
+    def hashcmp(self):
+        return (
+            self._forgiving_parsed_version,
+            self.precedence,
+            self.key,
+            self.location,
+            self.py_version or '',
+            self.platform or '',
+        )
+
+    def __hash__(self):
+        return hash(self.hashcmp)
+
+    def __lt__(self, other: Distribution):
+        return self.hashcmp < other.hashcmp
+
+    def __le__(self, other: Distribution):
+        return self.hashcmp <= other.hashcmp
+
+    def __gt__(self, other: Distribution):
+        return self.hashcmp > other.hashcmp
+
+    def __ge__(self, other: Distribution):
+        return self.hashcmp >= other.hashcmp
+
+    def __eq__(self, other: object):
+        if not isinstance(other, self.__class__):
+            # It's not a Distribution, so they are not equal
+            return False
+        return self.hashcmp == other.hashcmp
+
+    def __ne__(self, other: object):
+        return not self == other
+
+    # These properties have to be lazy so that we don't have to load any
+    # metadata until/unless it's actually needed.  (i.e., some distributions
+    # may not know their name or version without loading PKG-INFO)
+
+    @property
+    def key(self):
+        try:
+            return self._key
+        except AttributeError:
+            self._key = key = self.project_name.lower()
+            return key
+
+    @property
+    def parsed_version(self):
+        if not hasattr(self, "_parsed_version"):
+            try:
+                self._parsed_version = parse_version(self.version)
+            except _packaging_version.InvalidVersion as ex:
+                info = f"(package: {self.project_name})"
+                if hasattr(ex, "add_note"):
+                    ex.add_note(info)  # PEP 678
+                    raise
+                raise _packaging_version.InvalidVersion(f"{str(ex)} {info}") from None
+
+        return self._parsed_version
+
+    @property
+    def _forgiving_parsed_version(self):
+        try:
+            return self.parsed_version
+        except _packaging_version.InvalidVersion as ex:
+            self._parsed_version = parse_version(_forgiving_version(self.version))
+
+            notes = "\n".join(getattr(ex, "__notes__", []))  # PEP 678
+            msg = f"""!!\n\n
+            *************************************************************************
+            {str(ex)}\n{notes}
+
+            This is a long overdue deprecation.
+            For the time being, `pkg_resources` will use `{self._parsed_version}`
+            as a replacement to avoid breaking existing environments,
+            but no future compatibility is guaranteed.
+
+            If you maintain package {self.project_name} you should implement
+            the relevant changes to adequate the project to PEP 440 immediately.
+            *************************************************************************
+            \n\n!!
+            """
+            warnings.warn(msg, DeprecationWarning)
+
+            return self._parsed_version
+
+    @property
+    def version(self):
+        try:
+            return self._version
+        except AttributeError as e:
+            version = self._get_version()
+            if version is None:
+                path = self._get_metadata_path_for_display(self.PKG_INFO)
+                msg = ("Missing 'Version:' header and/or {} file at path: {}").format(
+                    self.PKG_INFO, path
+                )
+                raise ValueError(msg, self) from e
+
+            return version
+
+    @property
+    def _dep_map(self):
+        """
+        A map of extra to its list of (direct) requirements
+        for this distribution, including the null extra.
+        """
+        try:
+            return self.__dep_map
+        except AttributeError:
+            self.__dep_map = self._filter_extras(self._build_dep_map())
+        return self.__dep_map
+
+    @staticmethod
+    def _filter_extras(dm: dict[str | None, list[Requirement]]):
+        """
+        Given a mapping of extras to dependencies, strip off
+        environment markers and filter out any dependencies
+        not matching the markers.
+        """
+        for extra in list(filter(None, dm)):
+            new_extra: str | None = extra
+            reqs = dm.pop(extra)
+            new_extra, _, marker = extra.partition(':')
+            fails_marker = marker and (
+                invalid_marker(marker) or not evaluate_marker(marker)
+            )
+            if fails_marker:
+                reqs = []
+            new_extra = safe_extra(new_extra) or None
+
+            dm.setdefault(new_extra, []).extend(reqs)
+        return dm
+
+    def _build_dep_map(self):
+        dm = {}
+        for name in 'requires.txt', 'depends.txt':
+            for extra, reqs in split_sections(self._get_metadata(name)):
+                dm.setdefault(extra, []).extend(parse_requirements(reqs))
+        return dm
+
+    def requires(self, extras: Iterable[str] = ()):
+        """List of Requirements needed for this distro if `extras` are used"""
+        dm = self._dep_map
+        deps: list[Requirement] = []
+        deps.extend(dm.get(None, ()))
+        for ext in extras:
+            try:
+                deps.extend(dm[safe_extra(ext)])
+            except KeyError as e:
+                raise UnknownExtra(
+                    "%s has no such extra feature %r" % (self, ext)
+                ) from e
+        return deps
+
+    def _get_metadata_path_for_display(self, name):
+        """
+        Return the path to the given metadata file, if available.
+        """
+        try:
+            # We need to access _get_metadata_path() on the provider object
+            # directly rather than through this class's __getattr__()
+            # since _get_metadata_path() is marked private.
+            path = self._provider._get_metadata_path(name)
+
+        # Handle exceptions e.g. in case the distribution's metadata
+        # provider doesn't support _get_metadata_path().
+        except Exception:
+            return '[could not detect]'
+
+        return path
+
+    def _get_metadata(self, name):
+        if self.has_metadata(name):
+            yield from self.get_metadata_lines(name)
+
+    def _get_version(self):
+        lines = self._get_metadata(self.PKG_INFO)
+        return _version_from_file(lines)
+
+    def activate(self, path: list[str] | None = None, replace: bool = False):
+        """Ensure distribution is importable on `path` (default=sys.path)"""
+        if path is None:
+            path = sys.path
+        self.insert_on(path, replace=replace)
+        if path is sys.path and self.location is not None:
+            fixup_namespace_packages(self.location)
+            for pkg in self._get_metadata('namespace_packages.txt'):
+                if pkg in sys.modules:
+                    declare_namespace(pkg)
+
+    def egg_name(self):
+        """Return what this distribution's standard .egg filename should be"""
+        filename = "%s-%s-py%s" % (
+            to_filename(self.project_name),
+            to_filename(self.version),
+            self.py_version or PY_MAJOR,
+        )
+
+        if self.platform:
+            filename += '-' + self.platform
+        return filename
+
+    def __repr__(self):
+        if self.location:
+            return "%s (%s)" % (self, self.location)
+        else:
+            return str(self)
+
+    def __str__(self):
+        try:
+            version = getattr(self, 'version', None)
+        except ValueError:
+            version = None
+        version = version or "[unknown version]"
+        return "%s %s" % (self.project_name, version)
+
+    def __getattr__(self, attr):
+        """Delegate all unrecognized public attributes to .metadata provider"""
+        if attr.startswith('_'):
+            raise AttributeError(attr)
+        return getattr(self._provider, attr)
+
+    def __dir__(self):
+        return list(
+            set(super().__dir__())
+            | set(attr for attr in self._provider.__dir__() if not attr.startswith('_'))
+        )
+
+    @classmethod
+    def from_filename(
+        cls,
+        filename: StrPath,
+        metadata: _MetadataType = None,
+        **kw: int,  # We could set `precedence` explicitly, but keeping this as `**kw` for full backwards and subclassing compatibility
+    ):
+        return cls.from_location(
+            _normalize_cached(filename), os.path.basename(filename), metadata, **kw
+        )
+
+    def as_requirement(self):
+        """Return a ``Requirement`` that matches this distribution exactly"""
+        if isinstance(self.parsed_version, _packaging_version.Version):
+            spec = "%s==%s" % (self.project_name, self.parsed_version)
+        else:
+            spec = "%s===%s" % (self.project_name, self.parsed_version)
+
+        return Requirement.parse(spec)
+
+    def load_entry_point(self, group: str, name: str) -> _ResolvedEntryPoint:
+        """Return the `name` entry point of `group` or raise ImportError"""
+        ep = self.get_entry_info(group, name)
+        if ep is None:
+            raise ImportError("Entry point %r not found" % ((group, name),))
+        return ep.load()
+
+    @overload
+    def get_entry_map(self, group: None = None) -> dict[str, dict[str, EntryPoint]]: ...
+    @overload
+    def get_entry_map(self, group: str) -> dict[str, EntryPoint]: ...
+    def get_entry_map(self, group: str | None = None):
+        """Return the entry point map for `group`, or the full entry map"""
+        if not hasattr(self, "_ep_map"):
+            self._ep_map = EntryPoint.parse_map(
+                self._get_metadata('entry_points.txt'), self
+            )
+        if group is not None:
+            return self._ep_map.get(group, {})
+        return self._ep_map
+
+    def get_entry_info(self, group: str, name: str):
+        """Return the EntryPoint object for `group`+`name`, or ``None``"""
+        return self.get_entry_map(group).get(name)
+
+    # FIXME: 'Distribution.insert_on' is too complex (13)
+    def insert_on(  # noqa: C901
+        self,
+        path: list[str],
+        loc=None,
+        replace: bool = False,
+    ):
+        """Ensure self.location is on path
+
+        If replace=False (default):
+            - If location is already in path anywhere, do nothing.
+            - Else:
+              - If it's an egg and its parent directory is on path,
+                insert just ahead of the parent.
+              - Else: add to the end of path.
+        If replace=True:
+            - If location is already on path anywhere (not eggs)
+              or higher priority than its parent (eggs)
+              do nothing.
+            - Else:
+              - If it's an egg and its parent directory is on path,
+                insert just ahead of the parent,
+                removing any lower-priority entries.
+              - Else: add it to the front of path.
+        """
+
+        loc = loc or self.location
+        if not loc:
+            return
+
+        nloc = _normalize_cached(loc)
+        bdir = os.path.dirname(nloc)
+        npath = [(p and _normalize_cached(p) or p) for p in path]
+
+        for p, item in enumerate(npath):
+            if item == nloc:
+                if replace:
+                    break
+                else:
+                    # don't modify path (even removing duplicates) if
+                    # found and not replace
+                    return
+            elif item == bdir and self.precedence == EGG_DIST:
+                # if it's an .egg, give it precedence over its directory
+                # UNLESS it's already been added to sys.path and replace=False
+                if (not replace) and nloc in npath[p:]:
+                    return
+                if path is sys.path:
+                    self.check_version_conflict()
+                path.insert(p, loc)
+                npath.insert(p, nloc)
+                break
+        else:
+            if path is sys.path:
+                self.check_version_conflict()
+            if replace:
+                path.insert(0, loc)
+            else:
+                path.append(loc)
+            return
+
+        # p is the spot where we found or inserted loc; now remove duplicates
+        while True:
+            try:
+                np = npath.index(nloc, p + 1)
+            except ValueError:
+                break
+            else:
+                del npath[np], path[np]
+                # ha!
+                p = np
+
+        return
+
+    def check_version_conflict(self):
+        if self.key == 'setuptools':
+            # ignore the inevitable setuptools self-conflicts  :(
+            return
+
+        nsp = dict.fromkeys(self._get_metadata('namespace_packages.txt'))
+        loc = normalize_path(self.location)
+        for modname in self._get_metadata('top_level.txt'):
+            if (
+                modname not in sys.modules
+                or modname in nsp
+                or modname in _namespace_packages
+            ):
+                continue
+            if modname in ('pkg_resources', 'setuptools', 'site'):
+                continue
+            fn = getattr(sys.modules[modname], '__file__', None)
+            if fn and (
+                normalize_path(fn).startswith(loc) or fn.startswith(self.location)
+            ):
+                continue
+            issue_warning(
+                "Module %s was already imported from %s, but %s is being added"
+                " to sys.path" % (modname, fn, self.location),
+            )
+
+    def has_version(self):
+        try:
+            self.version
+        except ValueError:
+            issue_warning("Unbuilt egg for " + repr(self))
+            return False
+        except SystemError:
+            # TODO: remove this except clause when python/cpython#103632 is fixed.
+            return False
+        return True
+
+    def clone(self, **kw: str | int | IResourceProvider | None):
+        """Copy this distribution, substituting in any changed keyword args"""
+        names = 'project_name version py_version platform location precedence'
+        for attr in names.split():
+            kw.setdefault(attr, getattr(self, attr, None))
+        kw.setdefault('metadata', self._provider)
+        # Unsafely unpacking. But keeping **kw for backwards and subclassing compatibility
+        return self.__class__(**kw)  # type:ignore[arg-type]
+
+    @property
+    def extras(self):
+        return [dep for dep in self._dep_map if dep]
+
+
+class EggInfoDistribution(Distribution):
+    def _reload_version(self):
+        """
+        Packages installed by distutils (e.g. numpy or scipy),
+        which uses an old safe_version, and so
+        their version numbers can get mangled when
+        converted to filenames (e.g., 1.11.0.dev0+2329eae to
+        1.11.0.dev0_2329eae). These distributions will not be
+        parsed properly
+        downstream by Distribution and safe_version, so
+        take an extra step and try to get the version number from
+        the metadata file itself instead of the filename.
+        """
+        md_version = self._get_version()
+        if md_version:
+            self._version = md_version
+        return self
+
+
+class DistInfoDistribution(Distribution):
+    """
+    Wrap an actual or potential sys.path entry
+    w/metadata, .dist-info style.
+    """
+
+    PKG_INFO = 'METADATA'
+    EQEQ = re.compile(r"([\(,])\s*(\d.*?)\s*([,\)])")
+
+    @property
+    def _parsed_pkg_info(self):
+        """Parse and cache metadata"""
+        try:
+            return self._pkg_info
+        except AttributeError:
+            metadata = self.get_metadata(self.PKG_INFO)
+            self._pkg_info = email.parser.Parser().parsestr(metadata)
+            return self._pkg_info
+
+    @property
+    def _dep_map(self):
+        try:
+            return self.__dep_map
+        except AttributeError:
+            self.__dep_map = self._compute_dependencies()
+            return self.__dep_map
+
+    def _compute_dependencies(self) -> dict[str | None, list[Requirement]]:
+        """Recompute this distribution's dependencies."""
+        self.__dep_map: dict[str | None, list[Requirement]] = {None: []}
+
+        reqs: list[Requirement] = []
+        # Including any condition expressions
+        for req in self._parsed_pkg_info.get_all('Requires-Dist') or []:
+            reqs.extend(parse_requirements(req))
+
+        def reqs_for_extra(extra):
+            for req in reqs:
+                if not req.marker or req.marker.evaluate({'extra': extra}):
+                    yield req
+
+        common = types.MappingProxyType(dict.fromkeys(reqs_for_extra(None)))
+        self.__dep_map[None].extend(common)
+
+        for extra in self._parsed_pkg_info.get_all('Provides-Extra') or []:
+            s_extra = safe_extra(extra.strip())
+            self.__dep_map[s_extra] = [
+                r for r in reqs_for_extra(extra) if r not in common
+            ]
+
+        return self.__dep_map
+
+
+_distributionImpl = {
+    '.egg': Distribution,
+    '.egg-info': EggInfoDistribution,
+    '.dist-info': DistInfoDistribution,
+}
+
+
+def issue_warning(*args, **kw):
+    level = 1
+    g = globals()
+    try:
+        # find the first stack frame that is *not* code in
+        # the pkg_resources module, to use for the warning
+        while sys._getframe(level).f_globals is g:
+            level += 1
+    except ValueError:
+        pass
+    warnings.warn(stacklevel=level + 1, *args, **kw)
+
+
+def parse_requirements(strs: _NestedStr):
+    """
+    Yield ``Requirement`` objects for each specification in `strs`.
+
+    `strs` must be a string, or a (possibly-nested) iterable thereof.
+    """
+    return map(Requirement, join_continuation(map(drop_comment, yield_lines(strs))))
+
+
+class RequirementParseError(_packaging_requirements.InvalidRequirement):
+    "Compatibility wrapper for InvalidRequirement"
+
+
+class Requirement(_packaging_requirements.Requirement):
+    def __init__(self, requirement_string: str):
+        """DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!"""
+        super().__init__(requirement_string)
+        self.unsafe_name = self.name
+        project_name = safe_name(self.name)
+        self.project_name, self.key = project_name, project_name.lower()
+        self.specs = [(spec.operator, spec.version) for spec in self.specifier]
+        # packaging.requirements.Requirement uses a set for its extras. We use a variable-length tuple
+        self.extras: tuple[str] = tuple(map(safe_extra, self.extras))
+        self.hashCmp = (
+            self.key,
+            self.url,
+            self.specifier,
+            frozenset(self.extras),
+            str(self.marker) if self.marker else None,
+        )
+        self.__hash = hash(self.hashCmp)
+
+    def __eq__(self, other: object):
+        return isinstance(other, Requirement) and self.hashCmp == other.hashCmp
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __contains__(self, item: Distribution | str | tuple[str, ...]) -> bool:
+        if isinstance(item, Distribution):
+            if item.key != self.key:
+                return False
+
+            item = item.version
+
+        # Allow prereleases always in order to match the previous behavior of
+        # this method. In the future this should be smarter and follow PEP 440
+        # more accurately.
+        return self.specifier.contains(item, prereleases=True)
+
+    def __hash__(self):
+        return self.__hash
+
+    def __repr__(self):
+        return "Requirement.parse(%r)" % str(self)
+
+    @staticmethod
+    def parse(s: str | Iterable[str]):
+        (req,) = parse_requirements(s)
+        return req
+
+
+def _always_object(classes):
+    """
+    Ensure object appears in the mro even
+    for old-style classes.
+    """
+    if object not in classes:
+        return classes + (object,)
+    return classes
+
+
+def _find_adapter(registry: Mapping[type, _AdapterT], ob: object) -> _AdapterT:
+    """Return an adapter factory for `ob` from `registry`"""
+    types = _always_object(inspect.getmro(getattr(ob, '__class__', type(ob))))
+    for t in types:
+        if t in registry:
+            return registry[t]
+    # _find_adapter would previously return None, and immediately be called.
+    # So we're raising a TypeError to keep backward compatibility if anyone depended on that behaviour.
+    raise TypeError(f"Could not find adapter for {registry} and {ob}")
+
+
+def ensure_directory(path: StrOrBytesPath):
+    """Ensure that the parent directory of `path` exists"""
+    dirname = os.path.dirname(path)
+    os.makedirs(dirname, exist_ok=True)
+
+
+def _bypass_ensure_directory(path):
+    """Sandbox-bypassing version of ensure_directory()"""
+    if not WRITE_SUPPORT:
+        raise OSError('"os.mkdir" not supported on this platform.')
+    dirname, filename = split(path)
+    if dirname and filename and not isdir(dirname):
+        _bypass_ensure_directory(dirname)
+        try:
+            mkdir(dirname, 0o755)
+        except FileExistsError:
+            pass
+
+
+def split_sections(s: _NestedStr) -> Iterator[tuple[str | None, list[str]]]:
+    """Split a string or iterable thereof into (section, content) pairs
+
+    Each ``section`` is a stripped version of the section header ("[section]")
+    and each ``content`` is a list of stripped lines excluding blank lines and
+    comment-only lines.  If there are any such lines before the first section
+    header, they're returned in a first ``section`` of ``None``.
+    """
+    section = None
+    content = []
+    for line in yield_lines(s):
+        if line.startswith("["):
+            if line.endswith("]"):
+                if section or content:
+                    yield section, content
+                section = line[1:-1].strip()
+                content = []
+            else:
+                raise ValueError("Invalid section heading", line)
+        else:
+            content.append(line)
+
+    # wrap up last segment
+    yield section, content
+
+
+def _mkstemp(*args, **kw):
+    old_open = os.open
+    try:
+        # temporarily bypass sandboxing
+        os.open = os_open
+        return tempfile.mkstemp(*args, **kw)
+    finally:
+        # and then put it back
+        os.open = old_open
+
+
+# Silence the PEP440Warning by default, so that end users don't get hit by it
+# randomly just because they use pkg_resources. We want to append the rule
+# because we want earlier uses of filterwarnings to take precedence over this
+# one.
+warnings.filterwarnings("ignore", category=PEP440Warning, append=True)
+
+
+class PkgResourcesDeprecationWarning(Warning):
+    """
+    Base class for warning about deprecations in ``pkg_resources``
+
+    This class is not derived from ``DeprecationWarning``, and as such is
+    visible by default.
+    """
+
+
+# Ported from ``setuptools`` to avoid introducing an import inter-dependency:
+_LOCALE_ENCODING = "locale" if sys.version_info >= (3, 10) else None
+
+
+def _read_utf8_with_fallback(file: str, fallback_encoding=_LOCALE_ENCODING) -> str:
+    """See setuptools.unicode_utils._read_utf8_with_fallback"""
+    try:
+        with open(file, "r", encoding="utf-8") as f:
+            return f.read()
+    except UnicodeDecodeError:  # pragma: no cover
+        msg = f"""\
+        ********************************************************************************
+        `encoding="utf-8"` fails with {file!r}, trying `encoding={fallback_encoding!r}`.
+
+        This fallback behaviour is considered **deprecated** and future versions of
+        `setuptools/pkg_resources` may not implement it.
+
+        Please encode {file!r} with "utf-8" to ensure future builds will succeed.
+
+        If this file was produced by `setuptools` itself, cleaning up the cached files
+        and re-building/re-installing the package with a newer version of `setuptools`
+        (e.g. by updating `build-system.requires` in its `pyproject.toml`)
+        might solve the problem.
+        ********************************************************************************
+        """
+        # TODO: Add a deadline?
+        #       See comment in setuptools.unicode_utils._Utf8EncodingNeeded
+        warnings.warn(msg, PkgResourcesDeprecationWarning, stacklevel=2)
+        with open(file, "r", encoding=fallback_encoding) as f:
+            return f.read()
+
+
+# from jaraco.functools 1.3
+def _call_aside(f, *args, **kwargs):
+    f(*args, **kwargs)
+    return f
+
+
+@_call_aside
+def _initialize(g=globals()):
+    "Set up global resource manager (deliberately not state-saved)"
+    manager = ResourceManager()
+    g['_manager'] = manager
+    g.update(
+        (name, getattr(manager, name))
+        for name in dir(manager)
+        if not name.startswith('_')
+    )
+
+
+@_call_aside
+def _initialize_master_working_set():
+    """
+    Prepare the master working set and make the ``require()``
+    API available.
+
+    This function has explicit effects on the global state
+    of pkg_resources. It is intended to be invoked once at
+    the initialization of this module.
+
+    Invocation by other packages is unsupported and done
+    at their own risk.
+    """
+    working_set = _declare_state('object', 'working_set', WorkingSet._build_master())
+
+    require = working_set.require
+    iter_entry_points = working_set.iter_entry_points
+    add_activation_listener = working_set.subscribe
+    run_script = working_set.run_script
+    # backward compatibility
+    run_main = run_script
+    # Activate all distributions already on sys.path with replace=False and
+    # ensure that all distributions added to the working set in the future
+    # (e.g. by calling ``require()``) will get activated as well,
+    # with higher priority (replace=True).
+    tuple(dist.activate(replace=False) for dist in working_set)
+    add_activation_listener(
+        lambda dist: dist.activate(replace=True),
+        existing=False,
+    )
+    working_set.entries = []
+    # match order
+    list(map(working_set.add_entry, sys.path))
+    globals().update(locals())
+
+
+if TYPE_CHECKING:
+    # All of these are set by the @_call_aside methods above
+    __resource_manager = ResourceManager()  # Won't exist at runtime
+    resource_exists = __resource_manager.resource_exists
+    resource_isdir = __resource_manager.resource_isdir
+    resource_filename = __resource_manager.resource_filename
+    resource_stream = __resource_manager.resource_stream
+    resource_string = __resource_manager.resource_string
+    resource_listdir = __resource_manager.resource_listdir
+    set_extraction_path = __resource_manager.set_extraction_path
+    cleanup_resources = __resource_manager.cleanup_resources
+
+    working_set = WorkingSet()
+    require = working_set.require
+    iter_entry_points = working_set.iter_entry_points
+    add_activation_listener = working_set.subscribe
+    run_script = working_set.run_script
+    run_main = run_script
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/__init__.py
new file mode 100644
index 0000000..edc21fa
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/__init__.py
@@ -0,0 +1,631 @@
+"""
+Utilities for determining application-specific dirs.
+
+See  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
+    from typing import Literal
+
+if sys.platform == "win32":
+    from pip._vendor.platformdirs.windows import Windows as _Result
+elif sys.platform == "darwin":
+    from pip._vendor.platformdirs.macos import MacOS as _Result
+else:
+    from pip._vendor.platformdirs.unix import Unix as _Result
+
+
+def _set_platform_dir_class() -> type[PlatformDirsABC]:
+    if os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system":
+        if os.getenv("SHELL") or os.getenv("PREFIX"):
+            return _Result
+
+        from pip._vendor.platformdirs.android import _android_folder  # noqa: PLC0415
+
+        if _android_folder() is not None:
+            from pip._vendor.platformdirs.android import Android  # noqa: PLC0415
+
+            return Android  # return to avoid redefinition of a result
+
+    return _Result
+
+
+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
+
+
+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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `multipath `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `roaming `.
+    :param ensure_exists: See `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 a 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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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 `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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__ = [
+    "AppDirs",
+    "PlatformDirs",
+    "PlatformDirsABC",
+    "__version__",
+    "__version_info__",
+    "site_cache_dir",
+    "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/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/__main__.py b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/__main__.py
new file mode 100644
index 0000000..fa8a677
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/__main__.py
@@ -0,0 +1,55 @@
+"""Main entry point."""
+
+from __future__ import annotations
+
+from pip._vendor.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 the 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/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/android.py b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/android.py
new file mode 100644
index 0000000..7004a85
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/android.py
@@ -0,0 +1,249 @@
+"""Android."""
+
+from __future__ import annotations
+
+import os
+import re
+import sys
+from functools import lru_cache
+from typing import TYPE_CHECKING, cast
+
+from .api import PlatformDirsABC
+
+
+class Android(PlatformDirsABC):
+    """
+    Follows the guidance `from here `_.
+
+    Makes use of the `appname `, `version
+    `, `ensure_exists `.
+
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """:return: data directory tied to the user, e.g. ``/data/user///files/``"""
+        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///shared_prefs/``
+        """
+        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.,``/data/user///cache/``"""
+        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///cache//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///cache//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:  # 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
+    # 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 = 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):
+                result = path.split("/files")[0]
+                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
+
+
+@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  # noqa: PLC0415
+
+        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  # noqa: PLC0415
+
+        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  # noqa: PLC0415
+
+        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  # noqa: PLC0415
+
+        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  # noqa: PLC0415
+
+        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/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/api.py b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/api.py
new file mode 100644
index 0000000..18d660e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/api.py
@@ -0,0 +1,298 @@
+"""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:
+    from typing import Iterator, Literal
+
+
+class PlatformDirsABC(ABC):  # noqa: PLR0904
+    """Abstract base class for platform directories."""
+
+    def __init__(  # noqa: PLR0913, PLR0917
+        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 ``.``.
+
+        """
+        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 `_).
+
+        """
+        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)
+
+    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:
+        """: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 a 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)
+
+    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/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/macos.py b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/macos.py
new file mode 100644
index 0000000..e4b0391
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/macos.py
@@ -0,0 +1,144 @@
+"""macOS."""
+
+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):
+    """
+    Platform directories for the macOS operating system.
+
+    Follows the guidance from
+    `Apple documentation `_.
+    Makes use of the `appname `,
+    `version `,
+    `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 `_, the directory
+          will be under the Homebrew prefix, e.g. ``/opt/homebrew/share/$appname/$version``.
+          If `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 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`"""
+        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 `_, the directory
+          will be under the Homebrew prefix, e.g. ``/opt/homebrew/var/cache/$appname/$version``.
+          If `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 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`"""
+        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/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/py.typed b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/unix.py b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/unix.py
new file mode 100644
index 0000000..f1942e9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/unix.py
@@ -0,0 +1,269 @@
+"""Unix."""
+
+from __future__ import annotations
+
+import os
+import sys
+from configparser import ConfigParser
+from pathlib import Path
+from typing import Iterator, NoReturn
+
+from .api import PlatformDirsABC
+
+if sys.platform == "win32":
+
+    def getuid() -> NoReturn:
+        msg = "should only be used on Unix"
+        raise RuntimeError(msg)
+
+else:
+    from os import getuid
+
+
+class Unix(PlatformDirsABC):  # noqa: PLR0904
+    """
+    On Unix/Linux, we follow the `XDG Basedir Spec `_.
+
+    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
+    `, `version `, `multipath
+    `, `opinion `, `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_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._append_app_name_and_version(p) for p in path.split(os.pathsep)]
+
+    @property
+    def site_data_dir(self) -> str:
+        """
+        :return: data directories shared by users (if `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:
+            return dirs[0]
+        return os.pathsep.join(dirs)
+
+    @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_dirs(self) -> list[str]:
+        path = os.environ.get("XDG_CONFIG_DIRS", "")
+        if not path.strip():
+            path = "/etc/xdg"
+        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 `
+         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:
+        """
+        :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/cache/$appname/$version``"""
+        return self._append_app_name_and_version("/var/cache")
+
+    @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 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, 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 the first item, even if ``multipath`` is set to ``True``"""
+        return self._first_item_as_path_if_multipath(self.site_cache_dir)
+
+    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)
+    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/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/version.py b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/version.py
new file mode 100644
index 0000000..afb4924
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/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 = '4.3.6'
+__version_tuple__ = version_tuple = (4, 3, 6)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/windows.py b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/windows.py
new file mode 100644
index 0000000..d7bc960
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/platformdirs/windows.py
@@ -0,0 +1,272 @@
+"""Windows."""
+
+from __future__ import annotations
+
+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 `_.
+
+    Makes use of the `appname `, `appauthor
+    `, `version `, `roaming
+    `, `opinion `, `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 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
+
+    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  # noqa: PLC0415
+
+    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
+
+    import ctypes  # noqa: PLC0415
+
+    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]:
+    try:
+        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:
+        return get_win_folder_from_registry
+
+
+get_win_folder = lru_cache(maxsize=None)(_pick_get_win_folder())
+
+__all__ = [
+    "Windows",
+]
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pygments/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/pygments/__init__.py
new file mode 100644
index 0000000..60ae9bb
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pygments/__init__.py
@@ -0,0 +1,82 @@
+"""
+    Pygments
+    ~~~~~~~~
+
+    Pygments is a syntax highlighting package written in Python.
+
+    It is a generic syntax highlighter for general use in all kinds of software
+    such as forum systems, wikis or other applications that need to prettify
+    source code. Highlights are:
+
+    * a wide range of common languages and markup formats is supported
+    * special attention is paid to details, increasing quality by a fair amount
+    * support for new languages and formats are added easily
+    * a number of output formats, presently HTML, LaTeX, RTF, SVG, all image
+      formats that PIL supports, and ANSI sequences
+    * it is usable as a command-line tool and as a library
+    * ... and it highlights even Brainfuck!
+
+    The `Pygments master branch`_ is installable with ``easy_install Pygments==dev``.
+
+    .. _Pygments master branch:
+       https://github.com/pygments/pygments/archive/master.zip#egg=Pygments-dev
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+from io import StringIO, BytesIO
+
+__version__ = '2.18.0'
+__docformat__ = 'restructuredtext'
+
+__all__ = ['lex', 'format', 'highlight']
+
+
+def lex(code, lexer):
+    """
+    Lex `code` with the `lexer` (must be a `Lexer` instance)
+    and return an iterable of tokens. Currently, this only calls
+    `lexer.get_tokens()`.
+    """
+    try:
+        return lexer.get_tokens(code)
+    except TypeError:
+        # Heuristic to catch a common mistake.
+        from pip._vendor.pygments.lexer import RegexLexer
+        if isinstance(lexer, type) and issubclass(lexer, RegexLexer):
+            raise TypeError('lex() argument must be a lexer instance, '
+                            'not a class')
+        raise
+
+
+def format(tokens, formatter, outfile=None):  # pylint: disable=redefined-builtin
+    """
+    Format ``tokens`` (an iterable of tokens) with the formatter ``formatter``
+    (a `Formatter` instance).
+
+    If ``outfile`` is given and a valid file object (an object with a
+    ``write`` method), the result will be written to it, otherwise it
+    is returned as a string.
+    """
+    try:
+        if not outfile:
+            realoutfile = getattr(formatter, 'encoding', None) and BytesIO() or StringIO()
+            formatter.format(tokens, realoutfile)
+            return realoutfile.getvalue()
+        else:
+            formatter.format(tokens, outfile)
+    except TypeError:
+        # Heuristic to catch a common mistake.
+        from pip._vendor.pygments.formatter import Formatter
+        if isinstance(formatter, type) and issubclass(formatter, Formatter):
+            raise TypeError('format() argument must be a formatter instance, '
+                            'not a class')
+        raise
+
+
+def highlight(code, lexer, formatter, outfile=None):
+    """
+    This is the most high-level highlighting function. It combines `lex` and
+    `format` in one function.
+    """
+    return format(lex(code, lexer), formatter, outfile)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pygments/__main__.py b/env/lib/python3.12/site-packages/pip/_vendor/pygments/__main__.py
new file mode 100644
index 0000000..dcc6e5a
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pygments/__main__.py
@@ -0,0 +1,17 @@
+"""
+    pygments.__main__
+    ~~~~~~~~~~~~~~~~~
+
+    Main entry point for ``python -m pygments``.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import sys
+from pip._vendor.pygments.cmdline import main
+
+try:
+    sys.exit(main(sys.argv))
+except KeyboardInterrupt:
+    sys.exit(1)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pygments/cmdline.py b/env/lib/python3.12/site-packages/pip/_vendor/pygments/cmdline.py
new file mode 100644
index 0000000..0a7072e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pygments/cmdline.py
@@ -0,0 +1,668 @@
+"""
+    pygments.cmdline
+    ~~~~~~~~~~~~~~~~
+
+    Command line interface.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import os
+import sys
+import shutil
+import argparse
+from textwrap import dedent
+
+from pip._vendor.pygments import __version__, highlight
+from pip._vendor.pygments.util import ClassNotFound, OptionError, docstring_headline, \
+    guess_decode, guess_decode_from_terminal, terminal_encoding, \
+    UnclosingTextIOWrapper
+from pip._vendor.pygments.lexers import get_all_lexers, get_lexer_by_name, guess_lexer, \
+    load_lexer_from_file, get_lexer_for_filename, find_lexer_class_for_filename
+from pip._vendor.pygments.lexers.special import TextLexer
+from pip._vendor.pygments.formatters.latex import LatexEmbeddedLexer, LatexFormatter
+from pip._vendor.pygments.formatters import get_all_formatters, get_formatter_by_name, \
+    load_formatter_from_file, get_formatter_for_filename, find_formatter_class
+from pip._vendor.pygments.formatters.terminal import TerminalFormatter
+from pip._vendor.pygments.formatters.terminal256 import Terminal256Formatter, TerminalTrueColorFormatter
+from pip._vendor.pygments.filters import get_all_filters, find_filter_class
+from pip._vendor.pygments.styles import get_all_styles, get_style_by_name
+
+
+def _parse_options(o_strs):
+    opts = {}
+    if not o_strs:
+        return opts
+    for o_str in o_strs:
+        if not o_str.strip():
+            continue
+        o_args = o_str.split(',')
+        for o_arg in o_args:
+            o_arg = o_arg.strip()
+            try:
+                o_key, o_val = o_arg.split('=', 1)
+                o_key = o_key.strip()
+                o_val = o_val.strip()
+            except ValueError:
+                opts[o_arg] = True
+            else:
+                opts[o_key] = o_val
+    return opts
+
+
+def _parse_filters(f_strs):
+    filters = []
+    if not f_strs:
+        return filters
+    for f_str in f_strs:
+        if ':' in f_str:
+            fname, fopts = f_str.split(':', 1)
+            filters.append((fname, _parse_options([fopts])))
+        else:
+            filters.append((f_str, {}))
+    return filters
+
+
+def _print_help(what, name):
+    try:
+        if what == 'lexer':
+            cls = get_lexer_by_name(name)
+            print(f"Help on the {cls.name} lexer:")
+            print(dedent(cls.__doc__))
+        elif what == 'formatter':
+            cls = find_formatter_class(name)
+            print(f"Help on the {cls.name} formatter:")
+            print(dedent(cls.__doc__))
+        elif what == 'filter':
+            cls = find_filter_class(name)
+            print(f"Help on the {name} filter:")
+            print(dedent(cls.__doc__))
+        return 0
+    except (AttributeError, ValueError):
+        print(f"{what} not found!", file=sys.stderr)
+        return 1
+
+
+def _print_list(what):
+    if what == 'lexer':
+        print()
+        print("Lexers:")
+        print("~~~~~~~")
+
+        info = []
+        for fullname, names, exts, _ in get_all_lexers():
+            tup = (', '.join(names)+':', fullname,
+                   exts and '(filenames ' + ', '.join(exts) + ')' or '')
+            info.append(tup)
+        info.sort()
+        for i in info:
+            print(('* {}\n    {} {}').format(*i))
+
+    elif what == 'formatter':
+        print()
+        print("Formatters:")
+        print("~~~~~~~~~~~")
+
+        info = []
+        for cls in get_all_formatters():
+            doc = docstring_headline(cls)
+            tup = (', '.join(cls.aliases) + ':', doc, cls.filenames and
+                   '(filenames ' + ', '.join(cls.filenames) + ')' or '')
+            info.append(tup)
+        info.sort()
+        for i in info:
+            print(('* {}\n    {} {}').format(*i))
+
+    elif what == 'filter':
+        print()
+        print("Filters:")
+        print("~~~~~~~~")
+
+        for name in get_all_filters():
+            cls = find_filter_class(name)
+            print("* " + name + ':')
+            print(f"    {docstring_headline(cls)}")
+
+    elif what == 'style':
+        print()
+        print("Styles:")
+        print("~~~~~~~")
+
+        for name in get_all_styles():
+            cls = get_style_by_name(name)
+            print("* " + name + ':')
+            print(f"    {docstring_headline(cls)}")
+
+
+def _print_list_as_json(requested_items):
+    import json
+    result = {}
+    if 'lexer' in requested_items:
+        info = {}
+        for fullname, names, filenames, mimetypes in get_all_lexers():
+            info[fullname] = {
+                'aliases': names,
+                'filenames': filenames,
+                'mimetypes': mimetypes
+            }
+        result['lexers'] = info
+
+    if 'formatter' in requested_items:
+        info = {}
+        for cls in get_all_formatters():
+            doc = docstring_headline(cls)
+            info[cls.name] = {
+                'aliases': cls.aliases,
+                'filenames': cls.filenames,
+                'doc': doc
+            }
+        result['formatters'] = info
+
+    if 'filter' in requested_items:
+        info = {}
+        for name in get_all_filters():
+            cls = find_filter_class(name)
+            info[name] = {
+                'doc': docstring_headline(cls)
+            }
+        result['filters'] = info
+
+    if 'style' in requested_items:
+        info = {}
+        for name in get_all_styles():
+            cls = get_style_by_name(name)
+            info[name] = {
+                'doc': docstring_headline(cls)
+            }
+        result['styles'] = info
+
+    json.dump(result, sys.stdout)
+
+def main_inner(parser, argns):
+    if argns.help:
+        parser.print_help()
+        return 0
+
+    if argns.V:
+        print(f'Pygments version {__version__}, (c) 2006-2024 by Georg Brandl, Matthäus '
+              'Chajdas and contributors.')
+        return 0
+
+    def is_only_option(opt):
+        return not any(v for (k, v) in vars(argns).items() if k != opt)
+
+    # handle ``pygmentize -L``
+    if argns.L is not None:
+        arg_set = set()
+        for k, v in vars(argns).items():
+            if v:
+                arg_set.add(k)
+
+        arg_set.discard('L')
+        arg_set.discard('json')
+
+        if arg_set:
+            parser.print_help(sys.stderr)
+            return 2
+
+        # print version
+        if not argns.json:
+            main(['', '-V'])
+        allowed_types = {'lexer', 'formatter', 'filter', 'style'}
+        largs = [arg.rstrip('s') for arg in argns.L]
+        if any(arg not in allowed_types for arg in largs):
+            parser.print_help(sys.stderr)
+            return 0
+        if not largs:
+            largs = allowed_types
+        if not argns.json:
+            for arg in largs:
+                _print_list(arg)
+        else:
+            _print_list_as_json(largs)
+        return 0
+
+    # handle ``pygmentize -H``
+    if argns.H:
+        if not is_only_option('H'):
+            parser.print_help(sys.stderr)
+            return 2
+        what, name = argns.H
+        if what not in ('lexer', 'formatter', 'filter'):
+            parser.print_help(sys.stderr)
+            return 2
+        return _print_help(what, name)
+
+    # parse -O options
+    parsed_opts = _parse_options(argns.O or [])
+
+    # parse -P options
+    for p_opt in argns.P or []:
+        try:
+            name, value = p_opt.split('=', 1)
+        except ValueError:
+            parsed_opts[p_opt] = True
+        else:
+            parsed_opts[name] = value
+
+    # encodings
+    inencoding = parsed_opts.get('inencoding', parsed_opts.get('encoding'))
+    outencoding = parsed_opts.get('outencoding', parsed_opts.get('encoding'))
+
+    # handle ``pygmentize -N``
+    if argns.N:
+        lexer = find_lexer_class_for_filename(argns.N)
+        if lexer is None:
+            lexer = TextLexer
+
+        print(lexer.aliases[0])
+        return 0
+
+    # handle ``pygmentize -C``
+    if argns.C:
+        inp = sys.stdin.buffer.read()
+        try:
+            lexer = guess_lexer(inp, inencoding=inencoding)
+        except ClassNotFound:
+            lexer = TextLexer
+
+        print(lexer.aliases[0])
+        return 0
+
+    # handle ``pygmentize -S``
+    S_opt = argns.S
+    a_opt = argns.a
+    if S_opt is not None:
+        f_opt = argns.f
+        if not f_opt:
+            parser.print_help(sys.stderr)
+            return 2
+        if argns.l or argns.INPUTFILE:
+            parser.print_help(sys.stderr)
+            return 2
+
+        try:
+            parsed_opts['style'] = S_opt
+            fmter = get_formatter_by_name(f_opt, **parsed_opts)
+        except ClassNotFound as err:
+            print(err, file=sys.stderr)
+            return 1
+
+        print(fmter.get_style_defs(a_opt or ''))
+        return 0
+
+    # if no -S is given, -a is not allowed
+    if argns.a is not None:
+        parser.print_help(sys.stderr)
+        return 2
+
+    # parse -F options
+    F_opts = _parse_filters(argns.F or [])
+
+    # -x: allow custom (eXternal) lexers and formatters
+    allow_custom_lexer_formatter = bool(argns.x)
+
+    # select lexer
+    lexer = None
+
+    # given by name?
+    lexername = argns.l
+    if lexername:
+        # custom lexer, located relative to user's cwd
+        if allow_custom_lexer_formatter and '.py' in lexername:
+            try:
+                filename = None
+                name = None
+                if ':' in lexername:
+                    filename, name = lexername.rsplit(':', 1)
+
+                    if '.py' in name:
+                        # This can happen on Windows: If the lexername is
+                        # C:\lexer.py -- return to normal load path in that case
+                        name = None
+
+                if filename and name:
+                    lexer = load_lexer_from_file(filename, name,
+                                                 **parsed_opts)
+                else:
+                    lexer = load_lexer_from_file(lexername, **parsed_opts)
+            except ClassNotFound as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+        else:
+            try:
+                lexer = get_lexer_by_name(lexername, **parsed_opts)
+            except (OptionError, ClassNotFound) as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+
+    # read input code
+    code = None
+
+    if argns.INPUTFILE:
+        if argns.s:
+            print('Error: -s option not usable when input file specified',
+                  file=sys.stderr)
+            return 2
+
+        infn = argns.INPUTFILE
+        try:
+            with open(infn, 'rb') as infp:
+                code = infp.read()
+        except Exception as err:
+            print('Error: cannot read infile:', err, file=sys.stderr)
+            return 1
+        if not inencoding:
+            code, inencoding = guess_decode(code)
+
+        # do we have to guess the lexer?
+        if not lexer:
+            try:
+                lexer = get_lexer_for_filename(infn, code, **parsed_opts)
+            except ClassNotFound as err:
+                if argns.g:
+                    try:
+                        lexer = guess_lexer(code, **parsed_opts)
+                    except ClassNotFound:
+                        lexer = TextLexer(**parsed_opts)
+                else:
+                    print('Error:', err, file=sys.stderr)
+                    return 1
+            except OptionError as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+
+    elif not argns.s:  # treat stdin as full file (-s support is later)
+        # read code from terminal, always in binary mode since we want to
+        # decode ourselves and be tolerant with it
+        code = sys.stdin.buffer.read()  # use .buffer to get a binary stream
+        if not inencoding:
+            code, inencoding = guess_decode_from_terminal(code, sys.stdin)
+            # else the lexer will do the decoding
+        if not lexer:
+            try:
+                lexer = guess_lexer(code, **parsed_opts)
+            except ClassNotFound:
+                lexer = TextLexer(**parsed_opts)
+
+    else:  # -s option needs a lexer with -l
+        if not lexer:
+            print('Error: when using -s a lexer has to be selected with -l',
+                  file=sys.stderr)
+            return 2
+
+    # process filters
+    for fname, fopts in F_opts:
+        try:
+            lexer.add_filter(fname, **fopts)
+        except ClassNotFound as err:
+            print('Error:', err, file=sys.stderr)
+            return 1
+
+    # select formatter
+    outfn = argns.o
+    fmter = argns.f
+    if fmter:
+        # custom formatter, located relative to user's cwd
+        if allow_custom_lexer_formatter and '.py' in fmter:
+            try:
+                filename = None
+                name = None
+                if ':' in fmter:
+                    # Same logic as above for custom lexer
+                    filename, name = fmter.rsplit(':', 1)
+
+                    if '.py' in name:
+                        name = None
+
+                if filename and name:
+                    fmter = load_formatter_from_file(filename, name,
+                                                     **parsed_opts)
+                else:
+                    fmter = load_formatter_from_file(fmter, **parsed_opts)
+            except ClassNotFound as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+        else:
+            try:
+                fmter = get_formatter_by_name(fmter, **parsed_opts)
+            except (OptionError, ClassNotFound) as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+
+    if outfn:
+        if not fmter:
+            try:
+                fmter = get_formatter_for_filename(outfn, **parsed_opts)
+            except (OptionError, ClassNotFound) as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+        try:
+            outfile = open(outfn, 'wb')
+        except Exception as err:
+            print('Error: cannot open outfile:', err, file=sys.stderr)
+            return 1
+    else:
+        if not fmter:
+            if os.environ.get('COLORTERM','') in ('truecolor', '24bit'):
+                fmter = TerminalTrueColorFormatter(**parsed_opts)
+            elif '256' in os.environ.get('TERM', ''):
+                fmter = Terminal256Formatter(**parsed_opts)
+            else:
+                fmter = TerminalFormatter(**parsed_opts)
+        outfile = sys.stdout.buffer
+
+    # determine output encoding if not explicitly selected
+    if not outencoding:
+        if outfn:
+            # output file? use lexer encoding for now (can still be None)
+            fmter.encoding = inencoding
+        else:
+            # else use terminal encoding
+            fmter.encoding = terminal_encoding(sys.stdout)
+
+    # provide coloring under Windows, if possible
+    if not outfn and sys.platform in ('win32', 'cygwin') and \
+       fmter.name in ('Terminal', 'Terminal256'):  # pragma: no cover
+        # unfortunately colorama doesn't support binary streams on Py3
+        outfile = UnclosingTextIOWrapper(outfile, encoding=fmter.encoding)
+        fmter.encoding = None
+        try:
+            import colorama.initialise
+        except ImportError:
+            pass
+        else:
+            outfile = colorama.initialise.wrap_stream(
+                outfile, convert=None, strip=None, autoreset=False, wrap=True)
+
+    # When using the LaTeX formatter and the option `escapeinside` is
+    # specified, we need a special lexer which collects escaped text
+    # before running the chosen language lexer.
+    escapeinside = parsed_opts.get('escapeinside', '')
+    if len(escapeinside) == 2 and isinstance(fmter, LatexFormatter):
+        left = escapeinside[0]
+        right = escapeinside[1]
+        lexer = LatexEmbeddedLexer(left, right, lexer)
+
+    # ... and do it!
+    if not argns.s:
+        # process whole input as per normal...
+        try:
+            highlight(code, lexer, fmter, outfile)
+        finally:
+            if outfn:
+                outfile.close()
+        return 0
+    else:
+        # line by line processing of stdin (eg: for 'tail -f')...
+        try:
+            while 1:
+                line = sys.stdin.buffer.readline()
+                if not line:
+                    break
+                if not inencoding:
+                    line = guess_decode_from_terminal(line, sys.stdin)[0]
+                highlight(line, lexer, fmter, outfile)
+                if hasattr(outfile, 'flush'):
+                    outfile.flush()
+            return 0
+        except KeyboardInterrupt:  # pragma: no cover
+            return 0
+        finally:
+            if outfn:
+                outfile.close()
+
+
+class HelpFormatter(argparse.HelpFormatter):
+    def __init__(self, prog, indent_increment=2, max_help_position=16, width=None):
+        if width is None:
+            try:
+                width = shutil.get_terminal_size().columns - 2
+            except Exception:
+                pass
+        argparse.HelpFormatter.__init__(self, prog, indent_increment,
+                                        max_help_position, width)
+
+
+def main(args=sys.argv):
+    """
+    Main command line entry point.
+    """
+    desc = "Highlight an input file and write the result to an output file."
+    parser = argparse.ArgumentParser(description=desc, add_help=False,
+                                     formatter_class=HelpFormatter)
+
+    operation = parser.add_argument_group('Main operation')
+    lexersel = operation.add_mutually_exclusive_group()
+    lexersel.add_argument(
+        '-l', metavar='LEXER',
+        help='Specify the lexer to use.  (Query names with -L.)  If not '
+        'given and -g is not present, the lexer is guessed from the filename.')
+    lexersel.add_argument(
+        '-g', action='store_true',
+        help='Guess the lexer from the file contents, or pass through '
+        'as plain text if nothing can be guessed.')
+    operation.add_argument(
+        '-F', metavar='FILTER[:options]', action='append',
+        help='Add a filter to the token stream.  (Query names with -L.) '
+        'Filter options are given after a colon if necessary.')
+    operation.add_argument(
+        '-f', metavar='FORMATTER',
+        help='Specify the formatter to use.  (Query names with -L.) '
+        'If not given, the formatter is guessed from the output filename, '
+        'and defaults to the terminal formatter if the output is to the '
+        'terminal or an unknown file extension.')
+    operation.add_argument(
+        '-O', metavar='OPTION=value[,OPTION=value,...]', action='append',
+        help='Give options to the lexer and formatter as a comma-separated '
+        'list of key-value pairs. '
+        'Example: `-O bg=light,python=cool`.')
+    operation.add_argument(
+        '-P', metavar='OPTION=value', action='append',
+        help='Give a single option to the lexer and formatter - with this '
+        'you can pass options whose value contains commas and equal signs. '
+        'Example: `-P "heading=Pygments, the Python highlighter"`.')
+    operation.add_argument(
+        '-o', metavar='OUTPUTFILE',
+        help='Where to write the output.  Defaults to standard output.')
+
+    operation.add_argument(
+        'INPUTFILE', nargs='?',
+        help='Where to read the input.  Defaults to standard input.')
+
+    flags = parser.add_argument_group('Operation flags')
+    flags.add_argument(
+        '-v', action='store_true',
+        help='Print a detailed traceback on unhandled exceptions, which '
+        'is useful for debugging and bug reports.')
+    flags.add_argument(
+        '-s', action='store_true',
+        help='Process lines one at a time until EOF, rather than waiting to '
+        'process the entire file.  This only works for stdin, only for lexers '
+        'with no line-spanning constructs, and is intended for streaming '
+        'input such as you get from `tail -f`. '
+        'Example usage: `tail -f sql.log | pygmentize -s -l sql`.')
+    flags.add_argument(
+        '-x', action='store_true',
+        help='Allow custom lexers and formatters to be loaded from a .py file '
+        'relative to the current working directory. For example, '
+        '`-l ./customlexer.py -x`. By default, this option expects a file '
+        'with a class named CustomLexer or CustomFormatter; you can also '
+        'specify your own class name with a colon (`-l ./lexer.py:MyLexer`). '
+        'Users should be very careful not to use this option with untrusted '
+        'files, because it will import and run them.')
+    flags.add_argument('--json', help='Output as JSON. This can '
+        'be only used in conjunction with -L.',
+        default=False,
+        action='store_true')
+
+    special_modes_group = parser.add_argument_group(
+        'Special modes - do not do any highlighting')
+    special_modes = special_modes_group.add_mutually_exclusive_group()
+    special_modes.add_argument(
+        '-S', metavar='STYLE -f formatter',
+        help='Print style definitions for STYLE for a formatter '
+        'given with -f. The argument given by -a is formatter '
+        'dependent.')
+    special_modes.add_argument(
+        '-L', nargs='*', metavar='WHAT',
+        help='List lexers, formatters, styles or filters -- '
+        'give additional arguments for the thing(s) you want to list '
+        '(e.g. "styles"), or omit them to list everything.')
+    special_modes.add_argument(
+        '-N', metavar='FILENAME',
+        help='Guess and print out a lexer name based solely on the given '
+        'filename. Does not take input or highlight anything. If no specific '
+        'lexer can be determined, "text" is printed.')
+    special_modes.add_argument(
+        '-C', action='store_true',
+        help='Like -N, but print out a lexer name based solely on '
+        'a given content from standard input.')
+    special_modes.add_argument(
+        '-H', action='store', nargs=2, metavar=('NAME', 'TYPE'),
+        help='Print detailed help for the object  of type , '
+        'where  is one of "lexer", "formatter" or "filter".')
+    special_modes.add_argument(
+        '-V', action='store_true',
+        help='Print the package version.')
+    special_modes.add_argument(
+        '-h', '--help', action='store_true',
+        help='Print this help.')
+    special_modes_group.add_argument(
+        '-a', metavar='ARG',
+        help='Formatter-specific additional argument for the -S (print '
+        'style sheet) mode.')
+
+    argns = parser.parse_args(args[1:])
+
+    try:
+        return main_inner(parser, argns)
+    except BrokenPipeError:
+        # someone closed our stdout, e.g. by quitting a pager.
+        return 0
+    except Exception:
+        if argns.v:
+            print(file=sys.stderr)
+            print('*' * 65, file=sys.stderr)
+            print('An unhandled exception occurred while highlighting.',
+                  file=sys.stderr)
+            print('Please report the whole traceback to the issue tracker at',
+                  file=sys.stderr)
+            print('.',
+                  file=sys.stderr)
+            print('*' * 65, file=sys.stderr)
+            print(file=sys.stderr)
+            raise
+        import traceback
+        info = traceback.format_exception(*sys.exc_info())
+        msg = info[-1].strip()
+        if len(info) >= 3:
+            # extract relevant file and position info
+            msg += '\n   (f{})'.format(info[-2].split('\n')[0].strip()[1:])
+        print(file=sys.stderr)
+        print('*** Error while highlighting:', file=sys.stderr)
+        print(msg, file=sys.stderr)
+        print('*** If this is a bug you want to report, please rerun with -v.',
+              file=sys.stderr)
+        return 1
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pygments/console.py b/env/lib/python3.12/site-packages/pip/_vendor/pygments/console.py
new file mode 100644
index 0000000..4c1a062
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pygments/console.py
@@ -0,0 +1,70 @@
+"""
+    pygments.console
+    ~~~~~~~~~~~~~~~~
+
+    Format colored console output.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+esc = "\x1b["
+
+codes = {}
+codes[""] = ""
+codes["reset"] = esc + "39;49;00m"
+
+codes["bold"] = esc + "01m"
+codes["faint"] = esc + "02m"
+codes["standout"] = esc + "03m"
+codes["underline"] = esc + "04m"
+codes["blink"] = esc + "05m"
+codes["overline"] = esc + "06m"
+
+dark_colors = ["black", "red", "green", "yellow", "blue",
+               "magenta", "cyan", "gray"]
+light_colors = ["brightblack", "brightred", "brightgreen", "brightyellow", "brightblue",
+                "brightmagenta", "brightcyan", "white"]
+
+x = 30
+for dark, light in zip(dark_colors, light_colors):
+    codes[dark] = esc + "%im" % x
+    codes[light] = esc + "%im" % (60 + x)
+    x += 1
+
+del dark, light, x
+
+codes["white"] = codes["bold"]
+
+
+def reset_color():
+    return codes["reset"]
+
+
+def colorize(color_key, text):
+    return codes[color_key] + text + codes["reset"]
+
+
+def ansiformat(attr, text):
+    """
+    Format ``text`` with a color and/or some attributes::
+
+        color       normal color
+        *color*     bold color
+        _color_     underlined color
+        +color+     blinking color
+    """
+    result = []
+    if attr[:1] == attr[-1:] == '+':
+        result.append(codes['blink'])
+        attr = attr[1:-1]
+    if attr[:1] == attr[-1:] == '*':
+        result.append(codes['bold'])
+        attr = attr[1:-1]
+    if attr[:1] == attr[-1:] == '_':
+        result.append(codes['underline'])
+        attr = attr[1:-1]
+    result.append(codes[attr])
+    result.append(text)
+    result.append(codes['reset'])
+    return ''.join(result)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pygments/filter.py b/env/lib/python3.12/site-packages/pip/_vendor/pygments/filter.py
new file mode 100644
index 0000000..aa6f760
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pygments/filter.py
@@ -0,0 +1,70 @@
+"""
+    pygments.filter
+    ~~~~~~~~~~~~~~~
+
+    Module that implements the default filter.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+
+def apply_filters(stream, filters, lexer=None):
+    """
+    Use this method to apply an iterable of filters to
+    a stream. If lexer is given it's forwarded to the
+    filter, otherwise the filter receives `None`.
+    """
+    def _apply(filter_, stream):
+        yield from filter_.filter(lexer, stream)
+    for filter_ in filters:
+        stream = _apply(filter_, stream)
+    return stream
+
+
+def simplefilter(f):
+    """
+    Decorator that converts a function into a filter::
+
+        @simplefilter
+        def lowercase(self, lexer, stream, options):
+            for ttype, value in stream:
+                yield ttype, value.lower()
+    """
+    return type(f.__name__, (FunctionFilter,), {
+        '__module__': getattr(f, '__module__'),
+        '__doc__': f.__doc__,
+        'function': f,
+    })
+
+
+class Filter:
+    """
+    Default filter. Subclass this class or use the `simplefilter`
+    decorator to create own filters.
+    """
+
+    def __init__(self, **options):
+        self.options = options
+
+    def filter(self, lexer, stream):
+        raise NotImplementedError()
+
+
+class FunctionFilter(Filter):
+    """
+    Abstract class used by `simplefilter` to create simple
+    function filters on the fly. The `simplefilter` decorator
+    automatically creates subclasses of this class for
+    functions passed to it.
+    """
+    function = None
+
+    def __init__(self, **options):
+        if not hasattr(self, 'function'):
+            raise TypeError(f'{self.__class__.__name__!r} used without bound function')
+        Filter.__init__(self, **options)
+
+    def filter(self, lexer, stream):
+        # pylint: disable=not-callable
+        yield from self.function(lexer, stream, self.options)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__init__.py
new file mode 100644
index 0000000..9255ca2
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__init__.py
@@ -0,0 +1,940 @@
+"""
+    pygments.filters
+    ~~~~~~~~~~~~~~~~
+
+    Module containing filter lookup functions and default
+    filters.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pip._vendor.pygments.token import String, Comment, Keyword, Name, Error, Whitespace, \
+    string_to_tokentype
+from pip._vendor.pygments.filter import Filter
+from pip._vendor.pygments.util import get_list_opt, get_int_opt, get_bool_opt, \
+    get_choice_opt, ClassNotFound, OptionError
+from pip._vendor.pygments.plugin import find_plugin_filters
+
+
+def find_filter_class(filtername):
+    """Lookup a filter by name. Return None if not found."""
+    if filtername in FILTERS:
+        return FILTERS[filtername]
+    for name, cls in find_plugin_filters():
+        if name == filtername:
+            return cls
+    return None
+
+
+def get_filter_by_name(filtername, **options):
+    """Return an instantiated filter.
+
+    Options are passed to the filter initializer if wanted.
+    Raise a ClassNotFound if not found.
+    """
+    cls = find_filter_class(filtername)
+    if cls:
+        return cls(**options)
+    else:
+        raise ClassNotFound(f'filter {filtername!r} not found')
+
+
+def get_all_filters():
+    """Return a generator of all filter names."""
+    yield from FILTERS
+    for name, _ in find_plugin_filters():
+        yield name
+
+
+def _replace_special(ttype, value, regex, specialttype,
+                     replacefunc=lambda x: x):
+    last = 0
+    for match in regex.finditer(value):
+        start, end = match.start(), match.end()
+        if start != last:
+            yield ttype, value[last:start]
+        yield specialttype, replacefunc(value[start:end])
+        last = end
+    if last != len(value):
+        yield ttype, value[last:]
+
+
+class CodeTagFilter(Filter):
+    """Highlight special code tags in comments and docstrings.
+
+    Options accepted:
+
+    `codetags` : list of strings
+       A list of strings that are flagged as code tags.  The default is to
+       highlight ``XXX``, ``TODO``, ``FIXME``, ``BUG`` and ``NOTE``.
+
+    .. versionchanged:: 2.13
+       Now recognizes ``FIXME`` by default.
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        tags = get_list_opt(options, 'codetags',
+                            ['XXX', 'TODO', 'FIXME', 'BUG', 'NOTE'])
+        self.tag_re = re.compile(r'\b({})\b'.format('|'.join([
+            re.escape(tag) for tag in tags if tag
+        ])))
+
+    def filter(self, lexer, stream):
+        regex = self.tag_re
+        for ttype, value in stream:
+            if ttype in String.Doc or \
+               ttype in Comment and \
+               ttype not in Comment.Preproc:
+                yield from _replace_special(ttype, value, regex, Comment.Special)
+            else:
+                yield ttype, value
+
+
+class SymbolFilter(Filter):
+    """Convert mathematical symbols such as \\ in Isabelle
+    or \\longrightarrow in LaTeX into Unicode characters.
+
+    This is mostly useful for HTML or console output when you want to
+    approximate the source rendering you'd see in an IDE.
+
+    Options accepted:
+
+    `lang` : string
+       The symbol language. Must be one of ``'isabelle'`` or
+       ``'latex'``.  The default is ``'isabelle'``.
+    """
+
+    latex_symbols = {
+        '\\alpha'                : '\U000003b1',
+        '\\beta'                 : '\U000003b2',
+        '\\gamma'                : '\U000003b3',
+        '\\delta'                : '\U000003b4',
+        '\\varepsilon'           : '\U000003b5',
+        '\\zeta'                 : '\U000003b6',
+        '\\eta'                  : '\U000003b7',
+        '\\vartheta'             : '\U000003b8',
+        '\\iota'                 : '\U000003b9',
+        '\\kappa'                : '\U000003ba',
+        '\\lambda'               : '\U000003bb',
+        '\\mu'                   : '\U000003bc',
+        '\\nu'                   : '\U000003bd',
+        '\\xi'                   : '\U000003be',
+        '\\pi'                   : '\U000003c0',
+        '\\varrho'               : '\U000003c1',
+        '\\sigma'                : '\U000003c3',
+        '\\tau'                  : '\U000003c4',
+        '\\upsilon'              : '\U000003c5',
+        '\\varphi'               : '\U000003c6',
+        '\\chi'                  : '\U000003c7',
+        '\\psi'                  : '\U000003c8',
+        '\\omega'                : '\U000003c9',
+        '\\Gamma'                : '\U00000393',
+        '\\Delta'                : '\U00000394',
+        '\\Theta'                : '\U00000398',
+        '\\Lambda'               : '\U0000039b',
+        '\\Xi'                   : '\U0000039e',
+        '\\Pi'                   : '\U000003a0',
+        '\\Sigma'                : '\U000003a3',
+        '\\Upsilon'              : '\U000003a5',
+        '\\Phi'                  : '\U000003a6',
+        '\\Psi'                  : '\U000003a8',
+        '\\Omega'                : '\U000003a9',
+        '\\leftarrow'            : '\U00002190',
+        '\\longleftarrow'        : '\U000027f5',
+        '\\rightarrow'           : '\U00002192',
+        '\\longrightarrow'       : '\U000027f6',
+        '\\Leftarrow'            : '\U000021d0',
+        '\\Longleftarrow'        : '\U000027f8',
+        '\\Rightarrow'           : '\U000021d2',
+        '\\Longrightarrow'       : '\U000027f9',
+        '\\leftrightarrow'       : '\U00002194',
+        '\\longleftrightarrow'   : '\U000027f7',
+        '\\Leftrightarrow'       : '\U000021d4',
+        '\\Longleftrightarrow'   : '\U000027fa',
+        '\\mapsto'               : '\U000021a6',
+        '\\longmapsto'           : '\U000027fc',
+        '\\relbar'               : '\U00002500',
+        '\\Relbar'               : '\U00002550',
+        '\\hookleftarrow'        : '\U000021a9',
+        '\\hookrightarrow'       : '\U000021aa',
+        '\\leftharpoondown'      : '\U000021bd',
+        '\\rightharpoondown'     : '\U000021c1',
+        '\\leftharpoonup'        : '\U000021bc',
+        '\\rightharpoonup'       : '\U000021c0',
+        '\\rightleftharpoons'    : '\U000021cc',
+        '\\leadsto'              : '\U0000219d',
+        '\\downharpoonleft'      : '\U000021c3',
+        '\\downharpoonright'     : '\U000021c2',
+        '\\upharpoonleft'        : '\U000021bf',
+        '\\upharpoonright'       : '\U000021be',
+        '\\restriction'          : '\U000021be',
+        '\\uparrow'              : '\U00002191',
+        '\\Uparrow'              : '\U000021d1',
+        '\\downarrow'            : '\U00002193',
+        '\\Downarrow'            : '\U000021d3',
+        '\\updownarrow'          : '\U00002195',
+        '\\Updownarrow'          : '\U000021d5',
+        '\\langle'               : '\U000027e8',
+        '\\rangle'               : '\U000027e9',
+        '\\lceil'                : '\U00002308',
+        '\\rceil'                : '\U00002309',
+        '\\lfloor'               : '\U0000230a',
+        '\\rfloor'               : '\U0000230b',
+        '\\flqq'                 : '\U000000ab',
+        '\\frqq'                 : '\U000000bb',
+        '\\bot'                  : '\U000022a5',
+        '\\top'                  : '\U000022a4',
+        '\\wedge'                : '\U00002227',
+        '\\bigwedge'             : '\U000022c0',
+        '\\vee'                  : '\U00002228',
+        '\\bigvee'               : '\U000022c1',
+        '\\forall'               : '\U00002200',
+        '\\exists'               : '\U00002203',
+        '\\nexists'              : '\U00002204',
+        '\\neg'                  : '\U000000ac',
+        '\\Box'                  : '\U000025a1',
+        '\\Diamond'              : '\U000025c7',
+        '\\vdash'                : '\U000022a2',
+        '\\models'               : '\U000022a8',
+        '\\dashv'                : '\U000022a3',
+        '\\surd'                 : '\U0000221a',
+        '\\le'                   : '\U00002264',
+        '\\ge'                   : '\U00002265',
+        '\\ll'                   : '\U0000226a',
+        '\\gg'                   : '\U0000226b',
+        '\\lesssim'              : '\U00002272',
+        '\\gtrsim'               : '\U00002273',
+        '\\lessapprox'           : '\U00002a85',
+        '\\gtrapprox'            : '\U00002a86',
+        '\\in'                   : '\U00002208',
+        '\\notin'                : '\U00002209',
+        '\\subset'               : '\U00002282',
+        '\\supset'               : '\U00002283',
+        '\\subseteq'             : '\U00002286',
+        '\\supseteq'             : '\U00002287',
+        '\\sqsubset'             : '\U0000228f',
+        '\\sqsupset'             : '\U00002290',
+        '\\sqsubseteq'           : '\U00002291',
+        '\\sqsupseteq'           : '\U00002292',
+        '\\cap'                  : '\U00002229',
+        '\\bigcap'               : '\U000022c2',
+        '\\cup'                  : '\U0000222a',
+        '\\bigcup'               : '\U000022c3',
+        '\\sqcup'                : '\U00002294',
+        '\\bigsqcup'             : '\U00002a06',
+        '\\sqcap'                : '\U00002293',
+        '\\Bigsqcap'             : '\U00002a05',
+        '\\setminus'             : '\U00002216',
+        '\\propto'               : '\U0000221d',
+        '\\uplus'                : '\U0000228e',
+        '\\bigplus'              : '\U00002a04',
+        '\\sim'                  : '\U0000223c',
+        '\\doteq'                : '\U00002250',
+        '\\simeq'                : '\U00002243',
+        '\\approx'               : '\U00002248',
+        '\\asymp'                : '\U0000224d',
+        '\\cong'                 : '\U00002245',
+        '\\equiv'                : '\U00002261',
+        '\\Join'                 : '\U000022c8',
+        '\\bowtie'               : '\U00002a1d',
+        '\\prec'                 : '\U0000227a',
+        '\\succ'                 : '\U0000227b',
+        '\\preceq'               : '\U0000227c',
+        '\\succeq'               : '\U0000227d',
+        '\\parallel'             : '\U00002225',
+        '\\mid'                  : '\U000000a6',
+        '\\pm'                   : '\U000000b1',
+        '\\mp'                   : '\U00002213',
+        '\\times'                : '\U000000d7',
+        '\\div'                  : '\U000000f7',
+        '\\cdot'                 : '\U000022c5',
+        '\\star'                 : '\U000022c6',
+        '\\circ'                 : '\U00002218',
+        '\\dagger'               : '\U00002020',
+        '\\ddagger'              : '\U00002021',
+        '\\lhd'                  : '\U000022b2',
+        '\\rhd'                  : '\U000022b3',
+        '\\unlhd'                : '\U000022b4',
+        '\\unrhd'                : '\U000022b5',
+        '\\triangleleft'         : '\U000025c3',
+        '\\triangleright'        : '\U000025b9',
+        '\\triangle'             : '\U000025b3',
+        '\\triangleq'            : '\U0000225c',
+        '\\oplus'                : '\U00002295',
+        '\\bigoplus'             : '\U00002a01',
+        '\\otimes'               : '\U00002297',
+        '\\bigotimes'            : '\U00002a02',
+        '\\odot'                 : '\U00002299',
+        '\\bigodot'              : '\U00002a00',
+        '\\ominus'               : '\U00002296',
+        '\\oslash'               : '\U00002298',
+        '\\dots'                 : '\U00002026',
+        '\\cdots'                : '\U000022ef',
+        '\\sum'                  : '\U00002211',
+        '\\prod'                 : '\U0000220f',
+        '\\coprod'               : '\U00002210',
+        '\\infty'                : '\U0000221e',
+        '\\int'                  : '\U0000222b',
+        '\\oint'                 : '\U0000222e',
+        '\\clubsuit'             : '\U00002663',
+        '\\diamondsuit'          : '\U00002662',
+        '\\heartsuit'            : '\U00002661',
+        '\\spadesuit'            : '\U00002660',
+        '\\aleph'                : '\U00002135',
+        '\\emptyset'             : '\U00002205',
+        '\\nabla'                : '\U00002207',
+        '\\partial'              : '\U00002202',
+        '\\flat'                 : '\U0000266d',
+        '\\natural'              : '\U0000266e',
+        '\\sharp'                : '\U0000266f',
+        '\\angle'                : '\U00002220',
+        '\\copyright'            : '\U000000a9',
+        '\\textregistered'       : '\U000000ae',
+        '\\textonequarter'       : '\U000000bc',
+        '\\textonehalf'          : '\U000000bd',
+        '\\textthreequarters'    : '\U000000be',
+        '\\textordfeminine'      : '\U000000aa',
+        '\\textordmasculine'     : '\U000000ba',
+        '\\euro'                 : '\U000020ac',
+        '\\pounds'               : '\U000000a3',
+        '\\yen'                  : '\U000000a5',
+        '\\textcent'             : '\U000000a2',
+        '\\textcurrency'         : '\U000000a4',
+        '\\textdegree'           : '\U000000b0',
+    }
+
+    isabelle_symbols = {
+        '\\'                 : '\U0001d7ec',
+        '\\'                  : '\U0001d7ed',
+        '\\'                  : '\U0001d7ee',
+        '\\'                : '\U0001d7ef',
+        '\\'                 : '\U0001d7f0',
+        '\\'                 : '\U0001d7f1',
+        '\\'                  : '\U0001d7f2',
+        '\\'                : '\U0001d7f3',
+        '\\'                : '\U0001d7f4',
+        '\\'                 : '\U0001d7f5',
+        '\\'                    : '\U0001d49c',
+        '\\'                    : '\U0000212c',
+        '\\'                    : '\U0001d49e',
+        '\\'                    : '\U0001d49f',
+        '\\'                    : '\U00002130',
+        '\\'                    : '\U00002131',
+        '\\'                    : '\U0001d4a2',
+        '\\'                    : '\U0000210b',
+        '\\'                    : '\U00002110',
+        '\\'                    : '\U0001d4a5',
+        '\\'                    : '\U0001d4a6',
+        '\\'                    : '\U00002112',
+        '\\'                    : '\U00002133',
+        '\\'                    : '\U0001d4a9',
+        '\\'                    : '\U0001d4aa',
+        '\\
'                    : '\U0001d5c9',
+        '\\'                    : '\U0001d5ca',
+        '\\'                    : '\U0001d5cb',
+        '\\'                    : '\U0001d5cc',
+        '\\'                    : '\U0001d5cd',
+        '\\'                    : '\U0001d5ce',
+        '\\'                    : '\U0001d5cf',
+        '\\'                    : '\U0001d5d0',
+        '\\'                    : '\U0001d5d1',
+        '\\'                    : '\U0001d5d2',
+        '\\'                    : '\U0001d5d3',
+        '\\'                   : '\U0001d504',
+        '\\'                   : '\U0001d505',
+        '\\'                   : '\U0000212d',
+        '\\
'                   : '\U0001d507',
+        '\\'                   : '\U0001d508',
+        '\\'                   : '\U0001d509',
+        '\\'                   : '\U0001d50a',
+        '\\'                   : '\U0000210c',
+        '\\'                   : '\U00002111',
+        '\\'                   : '\U0001d50d',
+        '\\'                   : '\U0001d50e',
+        '\\'                   : '\U0001d50f',
+        '\\'                   : '\U0001d510',
+        '\\'                   : '\U0001d511',
+        '\\'                   : '\U0001d512',
+        '\\'                   : '\U0001d513',
+        '\\'                   : '\U0001d514',
+        '\\'                   : '\U0000211c',
+        '\\'                   : '\U0001d516',
+        '\\'                   : '\U0001d517',
+        '\\'                   : '\U0001d518',
+        '\\'                   : '\U0001d519',
+        '\\'                   : '\U0001d51a',
+        '\\'                   : '\U0001d51b',
+        '\\'                   : '\U0001d51c',
+        '\\'                   : '\U00002128',
+        '\\'                   : '\U0001d51e',
+        '\\'                   : '\U0001d51f',
+        '\\'                   : '\U0001d520',
+        '\\
'                    : '\U0001d4ab',
+        '\\'                    : '\U0001d4ac',
+        '\\'                    : '\U0000211b',
+        '\\'                    : '\U0001d4ae',
+        '\\'                    : '\U0001d4af',
+        '\\'                    : '\U0001d4b0',
+        '\\'                    : '\U0001d4b1',
+        '\\'                    : '\U0001d4b2',
+        '\\'                    : '\U0001d4b3',
+        '\\'                    : '\U0001d4b4',
+        '\\'                    : '\U0001d4b5',
+        '\\'                    : '\U0001d5ba',
+        '\\'                    : '\U0001d5bb',
+        '\\'                    : '\U0001d5bc',
+        '\\'                    : '\U0001d5bd',
+        '\\'                    : '\U0001d5be',
+        '\\'                    : '\U0001d5bf',
+        '\\'                    : '\U0001d5c0',
+        '\\'                    : '\U0001d5c1',
+        '\\'                    : '\U0001d5c2',
+        '\\'                    : '\U0001d5c3',
+        '\\'                    : '\U0001d5c4',
+        '\\'                    : '\U0001d5c5',
+        '\\'                    : '\U0001d5c6',
+        '\\'                    : '\U0001d5c7',
+        '\\'                    : '\U0001d5c8',
+        '\\
'                   : '\U0001d521',
+        '\\'                   : '\U0001d522',
+        '\\'                   : '\U0001d523',
+        '\\'                   : '\U0001d524',
+        '\\'                   : '\U0001d525',
+        '\\'                   : '\U0001d526',
+        '\\'                   : '\U0001d527',
+        '\\'                   : '\U0001d528',
+        '\\'                   : '\U0001d529',
+        '\\'                   : '\U0001d52a',
+        '\\'                   : '\U0001d52b',
+        '\\'                   : '\U0001d52c',
+        '\\'                   : '\U0001d52d',
+        '\\'                   : '\U0001d52e',
+        '\\'                   : '\U0001d52f',
+        '\\'                   : '\U0001d530',
+        '\\'                   : '\U0001d531',
+        '\\'                   : '\U0001d532',
+        '\\'                   : '\U0001d533',
+        '\\'                   : '\U0001d534',
+        '\\'                   : '\U0001d535',
+        '\\'                   : '\U0001d536',
+        '\\'                   : '\U0001d537',
+        '\\'                : '\U000003b1',
+        '\\'                 : '\U000003b2',
+        '\\'                : '\U000003b3',
+        '\\'                : '\U000003b4',
+        '\\'              : '\U000003b5',
+        '\\'                 : '\U000003b6',
+        '\\'                  : '\U000003b7',
+        '\\'                : '\U000003b8',
+        '\\'                 : '\U000003b9',
+        '\\'                : '\U000003ba',
+        '\\'               : '\U000003bb',
+        '\\'                   : '\U000003bc',
+        '\\'                   : '\U000003bd',
+        '\\'                   : '\U000003be',
+        '\\'                   : '\U000003c0',
+        '\\'                  : '\U000003c1',
+        '\\'                : '\U000003c3',
+        '\\'                  : '\U000003c4',
+        '\\'              : '\U000003c5',
+        '\\'                  : '\U000003c6',
+        '\\'                  : '\U000003c7',
+        '\\'                  : '\U000003c8',
+        '\\'                : '\U000003c9',
+        '\\'                : '\U00000393',
+        '\\'                : '\U00000394',
+        '\\'                : '\U00000398',
+        '\\'               : '\U0000039b',
+        '\\'                   : '\U0000039e',
+        '\\'                   : '\U000003a0',
+        '\\'                : '\U000003a3',
+        '\\'              : '\U000003a5',
+        '\\'                  : '\U000003a6',
+        '\\'                  : '\U000003a8',
+        '\\'                : '\U000003a9',
+        '\\'                 : '\U0001d539',
+        '\\'              : '\U00002102',
+        '\\'                  : '\U00002115',
+        '\\'                  : '\U0000211a',
+        '\\'                 : '\U0000211d',
+        '\\'                  : '\U00002124',
+        '\\'            : '\U00002190',
+        '\\'        : '\U000027f5',
+        '\\'           : '\U00002192',
+        '\\'       : '\U000027f6',
+        '\\'            : '\U000021d0',
+        '\\'        : '\U000027f8',
+        '\\'           : '\U000021d2',
+        '\\'       : '\U000027f9',
+        '\\'       : '\U00002194',
+        '\\'   : '\U000027f7',
+        '\\'       : '\U000021d4',
+        '\\'   : '\U000027fa',
+        '\\'               : '\U000021a6',
+        '\\'           : '\U000027fc',
+        '\\'             : '\U00002500',
+        '\\'             : '\U00002550',
+        '\\'        : '\U000021a9',
+        '\\'       : '\U000021aa',
+        '\\'      : '\U000021bd',
+        '\\'     : '\U000021c1',
+        '\\'        : '\U000021bc',
+        '\\'       : '\U000021c0',
+        '\\'    : '\U000021cc',
+        '\\'              : '\U0000219d',
+        '\\'      : '\U000021c3',
+        '\\'     : '\U000021c2',
+        '\\'        : '\U000021bf',
+        '\\'       : '\U000021be',
+        '\\'          : '\U000021be',
+        '\\'                : '\U00002237',
+        '\\'                   : '\U00002191',
+        '\\'                   : '\U000021d1',
+        '\\'                 : '\U00002193',
+        '\\'                 : '\U000021d3',
+        '\\'               : '\U00002195',
+        '\\'               : '\U000021d5',
+        '\\'               : '\U000027e8',
+        '\\'               : '\U000027e9',
+        '\\'                : '\U00002308',
+        '\\'                : '\U00002309',
+        '\\'               : '\U0000230a',
+        '\\'               : '\U0000230b',
+        '\\'                : '\U00002987',
+        '\\'                : '\U00002988',
+        '\\'               : '\U000027e6',
+        '\\'               : '\U000027e7',
+        '\\'               : '\U00002983',
+        '\\'               : '\U00002984',
+        '\\'        : '\U000000ab',
+        '\\'       : '\U000000bb',
+        '\\'               : '\U000022a5',
+        '\\'                  : '\U000022a4',
+        '\\'                  : '\U00002227',
+        '\\'                  : '\U000022c0',
+        '\\'                   : '\U00002228',
+        '\\'                   : '\U000022c1',
+        '\\'               : '\U00002200',
+        '\\'               : '\U00002203',
+        '\\'              : '\U00002204',
+        '\\'                  : '\U000000ac',
+        '\\'                  : '\U000025a1',
+        '\\'              : '\U000025c7',
+        '\\'            : '\U000022a2',
+        '\\'            : '\U000022a8',
+        '\\'           : '\U000022a9',
+        '\\'           : '\U000022ab',
+        '\\'            : '\U000022a3',
+        '\\'                 : '\U0000221a',
+        '\\'                   : '\U00002264',
+        '\\'                   : '\U00002265',
+        '\\'                : '\U0000226a',
+        '\\'             : '\U0000226b',
+        '\\'              : '\U00002272',
+        '\\'           : '\U00002273',
+        '\\'           : '\U00002a85',
+        '\\'        : '\U00002a86',
+        '\\'                   : '\U00002208',
+        '\\'                : '\U00002209',
+        '\\'               : '\U00002282',
+        '\\'               : '\U00002283',
+        '\\'             : '\U00002286',
+        '\\'             : '\U00002287',
+        '\\'             : '\U0000228f',
+        '\\'             : '\U00002290',
+        '\\'           : '\U00002291',
+        '\\'           : '\U00002292',
+        '\\'                : '\U00002229',
+        '\\'                : '\U000022c2',
+        '\\'                : '\U0000222a',
+        '\\'                : '\U000022c3',
+        '\\'              : '\U00002294',
+        '\\'              : '\U00002a06',
+        '\\'              : '\U00002293',
+        '\\'              : '\U00002a05',
+        '\\'             : '\U00002216',
+        '\\'               : '\U0000221d',
+        '\\'                : '\U0000228e',
+        '\\'                : '\U00002a04',
+        '\\'                : '\U00002260',
+        '\\'                  : '\U0000223c',
+        '\\'                : '\U00002250',
+        '\\'                : '\U00002243',
+        '\\'               : '\U00002248',
+        '\\'                : '\U0000224d',
+        '\\'                 : '\U00002245',
+        '\\'                : '\U00002323',
+        '\\'                : '\U00002261',
+        '\\'                : '\U00002322',
+        '\\'                 : '\U000022c8',
+        '\\'               : '\U00002a1d',
+        '\\'                 : '\U0000227a',
+        '\\'                 : '\U0000227b',
+        '\\'               : '\U0000227c',
+        '\\'               : '\U0000227d',
+        '\\'             : '\U00002225',
+        '\\'                  : '\U000000a6',
+        '\\'            : '\U000000b1',
+        '\\'            : '\U00002213',
+        '\\'                : '\U000000d7',
+        '\\
'                  : '\U000000f7',
+        '\\'                 : '\U000022c5',
+        '\\'                 : '\U000022c6',
+        '\\'               : '\U00002219',
+        '\\'                 : '\U00002218',
+        '\\'               : '\U00002020',
+        '\\'              : '\U00002021',
+        '\\'                  : '\U000022b2',
+        '\\'                  : '\U000022b3',
+        '\\'                : '\U000022b4',
+        '\\'                : '\U000022b5',
+        '\\'         : '\U000025c3',
+        '\\'        : '\U000025b9',
+        '\\'             : '\U000025b3',
+        '\\'            : '\U0000225c',
+        '\\'                : '\U00002295',
+        '\\'                : '\U00002a01',
+        '\\'               : '\U00002297',
+        '\\'               : '\U00002a02',
+        '\\'                 : '\U00002299',
+        '\\'                 : '\U00002a00',
+        '\\'               : '\U00002296',
+        '\\'               : '\U00002298',
+        '\\'                 : '\U00002026',
+        '\\'                : '\U000022ef',
+        '\\'                  : '\U00002211',
+        '\\'                 : '\U0000220f',
+        '\\'               : '\U00002210',
+        '\\'             : '\U0000221e',
+        '\\'             : '\U0000222b',
+        '\\'            : '\U0000222e',
+        '\\'             : '\U00002663',
+        '\\'          : '\U00002662',
+        '\\'            : '\U00002661',
+        '\\'            : '\U00002660',
+        '\\'                : '\U00002135',
+        '\\'             : '\U00002205',
+        '\\'                : '\U00002207',
+        '\\'              : '\U00002202',
+        '\\'                 : '\U0000266d',
+        '\\'              : '\U0000266e',
+        '\\'                : '\U0000266f',
+        '\\'                : '\U00002220',
+        '\\'            : '\U000000a9',
+        '\\'           : '\U000000ae',
+        '\\'               : '\U000000ad',
+        '\\'              : '\U000000af',
+        '\\'           : '\U000000bc',
+        '\\'              : '\U000000bd',
+        '\\'        : '\U000000be',
+        '\\'          : '\U000000aa',
+        '\\'         : '\U000000ba',
+        '\\
'              : '\U000000a7',
+        '\\'            : '\U000000b6',
+        '\\'           : '\U000000a1',
+        '\\'         : '\U000000bf',
+        '\\'                 : '\U000020ac',
+        '\\'               : '\U000000a3',
+        '\\'                  : '\U000000a5',
+        '\\'                 : '\U000000a2',
+        '\\'             : '\U000000a4',
+        '\\'               : '\U000000b0',
+        '\\'                : '\U00002a3f',
+        '\\'                  : '\U00002127',
+        '\\'              : '\U000025ca',
+        '\\'                   : '\U00002118',
+        '\\'                : '\U00002240',
+        '\\'               : '\U000022c4',
+        '\\'                : '\U000000b4',
+        '\\'                : '\U00000131',
+        '\\'             : '\U000000a8',
+        '\\'              : '\U000000b8',
+        '\\'         : '\U000002dd',
+        '\\'                 : '\U000003f5',
+        '\\'              : '\U000023ce',
+        '\\'                 : '\U00002039',
+        '\\'                : '\U0000203a',
+        '\\'                 : '\U00002302',
+        '\\<^sub>'                 : '\U000021e9',
+        '\\<^sup>'                 : '\U000021e7',
+        '\\<^bold>'                : '\U00002759',
+        '\\<^bsub>'                : '\U000021d8',
+        '\\<^esub>'                : '\U000021d9',
+        '\\<^bsup>'                : '\U000021d7',
+        '\\<^esup>'                : '\U000021d6',
+    }
+
+    lang_map = {'isabelle' : isabelle_symbols, 'latex' : latex_symbols}
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        lang = get_choice_opt(options, 'lang',
+                              ['isabelle', 'latex'], 'isabelle')
+        self.symbols = self.lang_map[lang]
+
+    def filter(self, lexer, stream):
+        for ttype, value in stream:
+            if value in self.symbols:
+                yield ttype, self.symbols[value]
+            else:
+                yield ttype, value
+
+
+class KeywordCaseFilter(Filter):
+    """Convert keywords to lowercase or uppercase or capitalize them, which
+    means first letter uppercase, rest lowercase.
+
+    This can be useful e.g. if you highlight Pascal code and want to adapt the
+    code to your styleguide.
+
+    Options accepted:
+
+    `case` : string
+       The casing to convert keywords to. Must be one of ``'lower'``,
+       ``'upper'`` or ``'capitalize'``.  The default is ``'lower'``.
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        case = get_choice_opt(options, 'case',
+                              ['lower', 'upper', 'capitalize'], 'lower')
+        self.convert = getattr(str, case)
+
+    def filter(self, lexer, stream):
+        for ttype, value in stream:
+            if ttype in Keyword:
+                yield ttype, self.convert(value)
+            else:
+                yield ttype, value
+
+
+class NameHighlightFilter(Filter):
+    """Highlight a normal Name (and Name.*) token with a different token type.
+
+    Example::
+
+        filter = NameHighlightFilter(
+            names=['foo', 'bar', 'baz'],
+            tokentype=Name.Function,
+        )
+
+    This would highlight the names "foo", "bar" and "baz"
+    as functions. `Name.Function` is the default token type.
+
+    Options accepted:
+
+    `names` : list of strings
+      A list of names that should be given the different token type.
+      There is no default.
+    `tokentype` : TokenType or string
+      A token type or a string containing a token type name that is
+      used for highlighting the strings in `names`.  The default is
+      `Name.Function`.
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        self.names = set(get_list_opt(options, 'names', []))
+        tokentype = options.get('tokentype')
+        if tokentype:
+            self.tokentype = string_to_tokentype(tokentype)
+        else:
+            self.tokentype = Name.Function
+
+    def filter(self, lexer, stream):
+        for ttype, value in stream:
+            if ttype in Name and value in self.names:
+                yield self.tokentype, value
+            else:
+                yield ttype, value
+
+
+class ErrorToken(Exception):
+    pass
+
+
+class RaiseOnErrorTokenFilter(Filter):
+    """Raise an exception when the lexer generates an error token.
+
+    Options accepted:
+
+    `excclass` : Exception class
+      The exception class to raise.
+      The default is `pygments.filters.ErrorToken`.
+
+    .. versionadded:: 0.8
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        self.exception = options.get('excclass', ErrorToken)
+        try:
+            # issubclass() will raise TypeError if first argument is not a class
+            if not issubclass(self.exception, Exception):
+                raise TypeError
+        except TypeError:
+            raise OptionError('excclass option is not an exception class')
+
+    def filter(self, lexer, stream):
+        for ttype, value in stream:
+            if ttype is Error:
+                raise self.exception(value)
+            yield ttype, value
+
+
+class VisibleWhitespaceFilter(Filter):
+    """Convert tabs, newlines and/or spaces to visible characters.
+
+    Options accepted:
+
+    `spaces` : string or bool
+      If this is a one-character string, spaces will be replaces by this string.
+      If it is another true value, spaces will be replaced by ``·`` (unicode
+      MIDDLE DOT).  If it is a false value, spaces will not be replaced.  The
+      default is ``False``.
+    `tabs` : string or bool
+      The same as for `spaces`, but the default replacement character is ``»``
+      (unicode RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK).  The default value
+      is ``False``.  Note: this will not work if the `tabsize` option for the
+      lexer is nonzero, as tabs will already have been expanded then.
+    `tabsize` : int
+      If tabs are to be replaced by this filter (see the `tabs` option), this
+      is the total number of characters that a tab should be expanded to.
+      The default is ``8``.
+    `newlines` : string or bool
+      The same as for `spaces`, but the default replacement character is ``¶``
+      (unicode PILCROW SIGN).  The default value is ``False``.
+    `wstokentype` : bool
+      If true, give whitespace the special `Whitespace` token type.  This allows
+      styling the visible whitespace differently (e.g. greyed out), but it can
+      disrupt background colors.  The default is ``True``.
+
+    .. versionadded:: 0.8
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        for name, default in [('spaces',   '·'),
+                              ('tabs',     '»'),
+                              ('newlines', '¶')]:
+            opt = options.get(name, False)
+            if isinstance(opt, str) and len(opt) == 1:
+                setattr(self, name, opt)
+            else:
+                setattr(self, name, (opt and default or ''))
+        tabsize = get_int_opt(options, 'tabsize', 8)
+        if self.tabs:
+            self.tabs += ' ' * (tabsize - 1)
+        if self.newlines:
+            self.newlines += '\n'
+        self.wstt = get_bool_opt(options, 'wstokentype', True)
+
+    def filter(self, lexer, stream):
+        if self.wstt:
+            spaces = self.spaces or ' '
+            tabs = self.tabs or '\t'
+            newlines = self.newlines or '\n'
+            regex = re.compile(r'\s')
+
+            def replacefunc(wschar):
+                if wschar == ' ':
+                    return spaces
+                elif wschar == '\t':
+                    return tabs
+                elif wschar == '\n':
+                    return newlines
+                return wschar
+
+            for ttype, value in stream:
+                yield from _replace_special(ttype, value, regex, Whitespace,
+                                            replacefunc)
+        else:
+            spaces, tabs, newlines = self.spaces, self.tabs, self.newlines
+            # simpler processing
+            for ttype, value in stream:
+                if spaces:
+                    value = value.replace(' ', spaces)
+                if tabs:
+                    value = value.replace('\t', tabs)
+                if newlines:
+                    value = value.replace('\n', newlines)
+                yield ttype, value
+
+
+class GobbleFilter(Filter):
+    """Gobbles source code lines (eats initial characters).
+
+    This filter drops the first ``n`` characters off every line of code.  This
+    may be useful when the source code fed to the lexer is indented by a fixed
+    amount of space that isn't desired in the output.
+
+    Options accepted:
+
+    `n` : int
+       The number of characters to gobble.
+
+    .. versionadded:: 1.2
+    """
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        self.n = get_int_opt(options, 'n', 0)
+
+    def gobble(self, value, left):
+        if left < len(value):
+            return value[left:], 0
+        else:
+            return '', left - len(value)
+
+    def filter(self, lexer, stream):
+        n = self.n
+        left = n  # How many characters left to gobble.
+        for ttype, value in stream:
+            # Remove ``left`` tokens from first line, ``n`` from all others.
+            parts = value.split('\n')
+            (parts[0], left) = self.gobble(parts[0], left)
+            for i in range(1, len(parts)):
+                (parts[i], left) = self.gobble(parts[i], n)
+            value = '\n'.join(parts)
+
+            if value != '':
+                yield ttype, value
+
+
+class TokenMergeFilter(Filter):
+    """Merges consecutive tokens with the same token type in the output
+    stream of a lexer.
+
+    .. versionadded:: 1.2
+    """
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+
+    def filter(self, lexer, stream):
+        current_type = None
+        current_value = None
+        for ttype, value in stream:
+            if ttype is current_type:
+                current_value += value
+            else:
+                if current_type is not None:
+                    yield current_type, current_value
+                current_type = ttype
+                current_value = value
+        if current_type is not None:
+            yield current_type, current_value
+
+
+FILTERS = {
+    'codetagify':     CodeTagFilter,
+    'keywordcase':    KeywordCaseFilter,
+    'highlight':      NameHighlightFilter,
+    'raiseonerror':   RaiseOnErrorTokenFilter,
+    'whitespace':     VisibleWhitespaceFilter,
+    'gobble':         GobbleFilter,
+    'tokenmerge':     TokenMergeFilter,
+    'symbols':        SymbolFilter,
+}
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatter.py b/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatter.py
new file mode 100644
index 0000000..d266603
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatter.py
@@ -0,0 +1,129 @@
+"""
+    pygments.formatter
+    ~~~~~~~~~~~~~~~~~~
+
+    Base formatter class.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import codecs
+
+from pip._vendor.pygments.util import get_bool_opt
+from pip._vendor.pygments.styles import get_style_by_name
+
+__all__ = ['Formatter']
+
+
+def _lookup_style(style):
+    if isinstance(style, str):
+        return get_style_by_name(style)
+    return style
+
+
+class Formatter:
+    """
+    Converts a token stream to text.
+
+    Formatters should have attributes to help selecting them. These
+    are similar to the corresponding :class:`~pygments.lexer.Lexer`
+    attributes.
+
+    .. autoattribute:: name
+       :no-value:
+
+    .. autoattribute:: aliases
+       :no-value:
+
+    .. autoattribute:: filenames
+       :no-value:
+
+    You can pass options as keyword arguments to the constructor.
+    All formatters accept these basic options:
+
+    ``style``
+        The style to use, can be a string or a Style subclass
+        (default: "default"). Not used by e.g. the
+        TerminalFormatter.
+    ``full``
+        Tells the formatter to output a "full" document, i.e.
+        a complete self-contained document. This doesn't have
+        any effect for some formatters (default: false).
+    ``title``
+        If ``full`` is true, the title that should be used to
+        caption the document (default: '').
+    ``encoding``
+        If given, must be an encoding name. This will be used to
+        convert the Unicode token strings to byte strings in the
+        output. If it is "" or None, Unicode strings will be written
+        to the output file, which most file-like objects do not
+        support (default: None).
+    ``outencoding``
+        Overrides ``encoding`` if given.
+
+    """
+
+    #: Full name for the formatter, in human-readable form.
+    name = None
+
+    #: A list of short, unique identifiers that can be used to lookup
+    #: the formatter from a list, e.g. using :func:`.get_formatter_by_name()`.
+    aliases = []
+
+    #: A list of fnmatch patterns that match filenames for which this
+    #: formatter can produce output. The patterns in this list should be unique
+    #: among all formatters.
+    filenames = []
+
+    #: If True, this formatter outputs Unicode strings when no encoding
+    #: option is given.
+    unicodeoutput = True
+
+    def __init__(self, **options):
+        """
+        As with lexers, this constructor takes arbitrary optional arguments,
+        and if you override it, you should first process your own options, then
+        call the base class implementation.
+        """
+        self.style = _lookup_style(options.get('style', 'default'))
+        self.full = get_bool_opt(options, 'full', False)
+        self.title = options.get('title', '')
+        self.encoding = options.get('encoding', None) or None
+        if self.encoding in ('guess', 'chardet'):
+            # can happen for e.g. pygmentize -O encoding=guess
+            self.encoding = 'utf-8'
+        self.encoding = options.get('outencoding') or self.encoding
+        self.options = options
+
+    def get_style_defs(self, arg=''):
+        """
+        This method must return statements or declarations suitable to define
+        the current style for subsequent highlighted text (e.g. CSS classes
+        in the `HTMLFormatter`).
+
+        The optional argument `arg` can be used to modify the generation and
+        is formatter dependent (it is standardized because it can be given on
+        the command line).
+
+        This method is called by the ``-S`` :doc:`command-line option `,
+        the `arg` is then given by the ``-a`` option.
+        """
+        return ''
+
+    def format(self, tokensource, outfile):
+        """
+        This method must format the tokens from the `tokensource` iterable and
+        write the formatted version to the file object `outfile`.
+
+        Formatter options can control how exactly the tokens are converted.
+        """
+        if self.encoding:
+            # wrap the outfile in a StreamWriter
+            outfile = codecs.lookup(self.encoding)[3](outfile)
+        return self.format_unencoded(tokensource, outfile)
+
+    # Allow writing Formatter[str] or Formatter[bytes]. That's equivalent to
+    # Formatter. This helps when using third-party type stubs from typeshed.
+    def __class_getitem__(cls, name):
+        return cls
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__init__.py
new file mode 100644
index 0000000..f19e993
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__init__.py
@@ -0,0 +1,157 @@
+"""
+    pygments.formatters
+    ~~~~~~~~~~~~~~~~~~~
+
+    Pygments formatters.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+import sys
+import types
+import fnmatch
+from os.path import basename
+
+from pip._vendor.pygments.formatters._mapping import FORMATTERS
+from pip._vendor.pygments.plugin import find_plugin_formatters
+from pip._vendor.pygments.util import ClassNotFound
+
+__all__ = ['get_formatter_by_name', 'get_formatter_for_filename',
+           'get_all_formatters', 'load_formatter_from_file'] + list(FORMATTERS)
+
+_formatter_cache = {}  # classes by name
+_pattern_cache = {}
+
+
+def _fn_matches(fn, glob):
+    """Return whether the supplied file name fn matches pattern filename."""
+    if glob not in _pattern_cache:
+        pattern = _pattern_cache[glob] = re.compile(fnmatch.translate(glob))
+        return pattern.match(fn)
+    return _pattern_cache[glob].match(fn)
+
+
+def _load_formatters(module_name):
+    """Load a formatter (and all others in the module too)."""
+    mod = __import__(module_name, None, None, ['__all__'])
+    for formatter_name in mod.__all__:
+        cls = getattr(mod, formatter_name)
+        _formatter_cache[cls.name] = cls
+
+
+def get_all_formatters():
+    """Return a generator for all formatter classes."""
+    # NB: this returns formatter classes, not info like get_all_lexers().
+    for info in FORMATTERS.values():
+        if info[1] not in _formatter_cache:
+            _load_formatters(info[0])
+        yield _formatter_cache[info[1]]
+    for _, formatter in find_plugin_formatters():
+        yield formatter
+
+
+def find_formatter_class(alias):
+    """Lookup a formatter by alias.
+
+    Returns None if not found.
+    """
+    for module_name, name, aliases, _, _ in FORMATTERS.values():
+        if alias in aliases:
+            if name not in _formatter_cache:
+                _load_formatters(module_name)
+            return _formatter_cache[name]
+    for _, cls in find_plugin_formatters():
+        if alias in cls.aliases:
+            return cls
+
+
+def get_formatter_by_name(_alias, **options):
+    """
+    Return an instance of a :class:`.Formatter` subclass that has `alias` in its
+    aliases list. The formatter is given the `options` at its instantiation.
+
+    Will raise :exc:`pygments.util.ClassNotFound` if no formatter with that
+    alias is found.
+    """
+    cls = find_formatter_class(_alias)
+    if cls is None:
+        raise ClassNotFound(f"no formatter found for name {_alias!r}")
+    return cls(**options)
+
+
+def load_formatter_from_file(filename, formattername="CustomFormatter", **options):
+    """
+    Return a `Formatter` subclass instance loaded from the provided file, relative
+    to the current directory.
+
+    The file is expected to contain a Formatter class named ``formattername``
+    (by default, CustomFormatter). Users should be very careful with the input, because
+    this method is equivalent to running ``eval()`` on the input file. The formatter is
+    given the `options` at its instantiation.
+
+    :exc:`pygments.util.ClassNotFound` is raised if there are any errors loading
+    the formatter.
+
+    .. versionadded:: 2.2
+    """
+    try:
+        # This empty dict will contain the namespace for the exec'd file
+        custom_namespace = {}
+        with open(filename, 'rb') as f:
+            exec(f.read(), custom_namespace)
+        # Retrieve the class `formattername` from that namespace
+        if formattername not in custom_namespace:
+            raise ClassNotFound(f'no valid {formattername} class found in {filename}')
+        formatter_class = custom_namespace[formattername]
+        # And finally instantiate it with the options
+        return formatter_class(**options)
+    except OSError as err:
+        raise ClassNotFound(f'cannot read {filename}: {err}')
+    except ClassNotFound:
+        raise
+    except Exception as err:
+        raise ClassNotFound(f'error when loading custom formatter: {err}')
+
+
+def get_formatter_for_filename(fn, **options):
+    """
+    Return a :class:`.Formatter` subclass instance that has a filename pattern
+    matching `fn`. The formatter is given the `options` at its instantiation.
+
+    Will raise :exc:`pygments.util.ClassNotFound` if no formatter for that filename
+    is found.
+    """
+    fn = basename(fn)
+    for modname, name, _, filenames, _ in FORMATTERS.values():
+        for filename in filenames:
+            if _fn_matches(fn, filename):
+                if name not in _formatter_cache:
+                    _load_formatters(modname)
+                return _formatter_cache[name](**options)
+    for _name, cls in find_plugin_formatters():
+        for filename in cls.filenames:
+            if _fn_matches(fn, filename):
+                return cls(**options)
+    raise ClassNotFound(f"no formatter found for file name {fn!r}")
+
+
+class _automodule(types.ModuleType):
+    """Automatically import formatters."""
+
+    def __getattr__(self, name):
+        info = FORMATTERS.get(name)
+        if info:
+            _load_formatters(info[0])
+            cls = _formatter_cache[info[1]]
+            setattr(self, name, cls)
+            return cls
+        raise AttributeError(name)
+
+
+oldmod = sys.modules[__name__]
+newmod = _automodule(__name__)
+newmod.__dict__.update(oldmod.__dict__)
+sys.modules[__name__] = newmod
+del newmod.newmod, newmod.oldmod, newmod.sys, newmod.types
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/_mapping.py b/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/_mapping.py
new file mode 100644
index 0000000..72ca840
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/_mapping.py
@@ -0,0 +1,23 @@
+# Automatically generated by scripts/gen_mapfiles.py.
+# DO NOT EDIT BY HAND; run `tox -e mapfiles` instead.
+
+FORMATTERS = {
+    'BBCodeFormatter': ('pygments.formatters.bbcode', 'BBCode', ('bbcode', 'bb'), (), 'Format tokens with BBcodes. These formatting codes are used by many bulletin boards, so you can highlight your sourcecode with pygments before posting it there.'),
+    'BmpImageFormatter': ('pygments.formatters.img', 'img_bmp', ('bmp', 'bitmap'), ('*.bmp',), 'Create a bitmap image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'),
+    'GifImageFormatter': ('pygments.formatters.img', 'img_gif', ('gif',), ('*.gif',), 'Create a GIF image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'),
+    'GroffFormatter': ('pygments.formatters.groff', 'groff', ('groff', 'troff', 'roff'), (), 'Format tokens with groff escapes to change their color and font style.'),
+    'HtmlFormatter': ('pygments.formatters.html', 'HTML', ('html',), ('*.html', '*.htm'), "Format tokens as HTML 4 ```` tags. By default, the content is enclosed in a ``
`` tag, itself wrapped in a ``
`` tag (but see the `nowrap` option). The ``
``'s CSS class can be set by the `cssclass` option."),
+    'IRCFormatter': ('pygments.formatters.irc', 'IRC', ('irc', 'IRC'), (), 'Format tokens with IRC color sequences'),
+    'ImageFormatter': ('pygments.formatters.img', 'img', ('img', 'IMG', 'png'), ('*.png',), 'Create a PNG image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'),
+    'JpgImageFormatter': ('pygments.formatters.img', 'img_jpg', ('jpg', 'jpeg'), ('*.jpg',), 'Create a JPEG image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'),
+    'LatexFormatter': ('pygments.formatters.latex', 'LaTeX', ('latex', 'tex'), ('*.tex',), 'Format tokens as LaTeX code. This needs the `fancyvrb` and `color` standard packages.'),
+    'NullFormatter': ('pygments.formatters.other', 'Text only', ('text', 'null'), ('*.txt',), 'Output the text unchanged without any formatting.'),
+    'PangoMarkupFormatter': ('pygments.formatters.pangomarkup', 'Pango Markup', ('pango', 'pangomarkup'), (), 'Format tokens as Pango Markup code. It can then be rendered to an SVG.'),
+    'RawTokenFormatter': ('pygments.formatters.other', 'Raw tokens', ('raw', 'tokens'), ('*.raw',), 'Format tokens as a raw representation for storing token streams.'),
+    'RtfFormatter': ('pygments.formatters.rtf', 'RTF', ('rtf',), ('*.rtf',), 'Format tokens as RTF markup. This formatter automatically outputs full RTF documents with color information and other useful stuff. Perfect for Copy and Paste into Microsoft(R) Word(R) documents.'),
+    'SvgFormatter': ('pygments.formatters.svg', 'SVG', ('svg',), ('*.svg',), 'Format tokens as an SVG graphics file.  This formatter is still experimental. Each line of code is a ```` element with explicit ``x`` and ``y`` coordinates containing ```` elements with the individual token styles.'),
+    'Terminal256Formatter': ('pygments.formatters.terminal256', 'Terminal256', ('terminal256', 'console256', '256'), (), 'Format tokens with ANSI color sequences, for output in a 256-color terminal or console.  Like in `TerminalFormatter` color sequences are terminated at newlines, so that paging the output works correctly.'),
+    'TerminalFormatter': ('pygments.formatters.terminal', 'Terminal', ('terminal', 'console'), (), 'Format tokens with ANSI color sequences, for output in a text console. Color sequences are terminated at newlines, so that paging the output works correctly.'),
+    'TerminalTrueColorFormatter': ('pygments.formatters.terminal256', 'TerminalTrueColor', ('terminal16m', 'console16m', '16m'), (), 'Format tokens with ANSI color sequences, for output in a true-color terminal or console.  Like in `TerminalFormatter` color sequences are terminated at newlines, so that paging the output works correctly.'),
+    'TestcaseFormatter': ('pygments.formatters.other', 'Testcase', ('testcase',), (), 'Format tokens as appropriate for a new testcase.'),
+}
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/bbcode.py b/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/bbcode.py
new file mode 100644
index 0000000..5a05bd9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/bbcode.py
@@ -0,0 +1,108 @@
+"""
+    pygments.formatters.bbcode
+    ~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    BBcode formatter.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+
+from pip._vendor.pygments.formatter import Formatter
+from pip._vendor.pygments.util import get_bool_opt
+
+__all__ = ['BBCodeFormatter']
+
+
+class BBCodeFormatter(Formatter):
+    """
+    Format tokens with BBcodes. These formatting codes are used by many
+    bulletin boards, so you can highlight your sourcecode with pygments before
+    posting it there.
+
+    This formatter has no support for background colors and borders, as there
+    are no common BBcode tags for that.
+
+    Some board systems (e.g. phpBB) don't support colors in their [code] tag,
+    so you can't use the highlighting together with that tag.
+    Text in a [code] tag usually is shown with a monospace font (which this
+    formatter can do with the ``monofont`` option) and no spaces (which you
+    need for indentation) are removed.
+
+    Additional options accepted:
+
+    `style`
+        The style to use, can be a string or a Style subclass (default:
+        ``'default'``).
+
+    `codetag`
+        If set to true, put the output into ``[code]`` tags (default:
+        ``false``)
+
+    `monofont`
+        If set to true, add a tag to show the code with a monospace font
+        (default: ``false``).
+    """
+    name = 'BBCode'
+    aliases = ['bbcode', 'bb']
+    filenames = []
+
+    def __init__(self, **options):
+        Formatter.__init__(self, **options)
+        self._code = get_bool_opt(options, 'codetag', False)
+        self._mono = get_bool_opt(options, 'monofont', False)
+
+        self.styles = {}
+        self._make_styles()
+
+    def _make_styles(self):
+        for ttype, ndef in self.style:
+            start = end = ''
+            if ndef['color']:
+                start += '[color=#{}]'.format(ndef['color'])
+                end = '[/color]' + end
+            if ndef['bold']:
+                start += '[b]'
+                end = '[/b]' + end
+            if ndef['italic']:
+                start += '[i]'
+                end = '[/i]' + end
+            if ndef['underline']:
+                start += '[u]'
+                end = '[/u]' + end
+            # there are no common BBcodes for background-color and border
+
+            self.styles[ttype] = start, end
+
+    def format_unencoded(self, tokensource, outfile):
+        if self._code:
+            outfile.write('[code]')
+        if self._mono:
+            outfile.write('[font=monospace]')
+
+        lastval = ''
+        lasttype = None
+
+        for ttype, value in tokensource:
+            while ttype not in self.styles:
+                ttype = ttype.parent
+            if ttype == lasttype:
+                lastval += value
+            else:
+                if lastval:
+                    start, end = self.styles[lasttype]
+                    outfile.write(''.join((start, lastval, end)))
+                lastval = value
+                lasttype = ttype
+
+        if lastval:
+            start, end = self.styles[lasttype]
+            outfile.write(''.join((start, lastval, end)))
+
+        if self._mono:
+            outfile.write('[/font]')
+        if self._code:
+            outfile.write('[/code]')
+        if self._code or self._mono:
+            outfile.write('\n')
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/groff.py b/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/groff.py
new file mode 100644
index 0000000..5c8a958
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/groff.py
@@ -0,0 +1,170 @@
+"""
+    pygments.formatters.groff
+    ~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Formatter for groff output.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import math
+from pip._vendor.pygments.formatter import Formatter
+from pip._vendor.pygments.util import get_bool_opt, get_int_opt
+
+__all__ = ['GroffFormatter']
+
+
+class GroffFormatter(Formatter):
+    """
+    Format tokens with groff escapes to change their color and font style.
+
+    .. versionadded:: 2.11
+
+    Additional options accepted:
+
+    `style`
+        The style to use, can be a string or a Style subclass (default:
+        ``'default'``).
+
+    `monospaced`
+        If set to true, monospace font will be used (default: ``true``).
+
+    `linenos`
+        If set to true, print the line numbers (default: ``false``).
+
+    `wrap`
+        Wrap lines to the specified number of characters. Disabled if set to 0
+        (default: ``0``).
+    """
+
+    name = 'groff'
+    aliases = ['groff','troff','roff']
+    filenames = []
+
+    def __init__(self, **options):
+        Formatter.__init__(self, **options)
+
+        self.monospaced = get_bool_opt(options, 'monospaced', True)
+        self.linenos = get_bool_opt(options, 'linenos', False)
+        self._lineno = 0
+        self.wrap = get_int_opt(options, 'wrap', 0)
+        self._linelen = 0
+
+        self.styles = {}
+        self._make_styles()
+
+
+    def _make_styles(self):
+        regular = '\\f[CR]' if self.monospaced else '\\f[R]'
+        bold = '\\f[CB]' if self.monospaced else '\\f[B]'
+        italic = '\\f[CI]' if self.monospaced else '\\f[I]'
+
+        for ttype, ndef in self.style:
+            start = end = ''
+            if ndef['color']:
+                start += '\\m[{}]'.format(ndef['color'])
+                end = '\\m[]' + end
+            if ndef['bold']:
+                start += bold
+                end = regular + end
+            if ndef['italic']:
+                start += italic
+                end = regular + end
+            if ndef['bgcolor']:
+                start += '\\M[{}]'.format(ndef['bgcolor'])
+                end = '\\M[]' + end
+
+            self.styles[ttype] = start, end
+
+
+    def _define_colors(self, outfile):
+        colors = set()
+        for _, ndef in self.style:
+            if ndef['color'] is not None:
+                colors.add(ndef['color'])
+
+        for color in sorted(colors):
+            outfile.write('.defcolor ' + color + ' rgb #' + color + '\n')
+
+
+    def _write_lineno(self, outfile):
+        self._lineno += 1
+        outfile.write("%s% 4d " % (self._lineno != 1 and '\n' or '', self._lineno))
+
+
+    def _wrap_line(self, line):
+        length = len(line.rstrip('\n'))
+        space = '     ' if self.linenos else ''
+        newline = ''
+
+        if length > self.wrap:
+            for i in range(0, math.floor(length / self.wrap)):
+                chunk = line[i*self.wrap:i*self.wrap+self.wrap]
+                newline += (chunk + '\n' + space)
+            remainder = length % self.wrap
+            if remainder > 0:
+                newline += line[-remainder-1:]
+                self._linelen = remainder
+        elif self._linelen + length > self.wrap:
+            newline = ('\n' + space) + line
+            self._linelen = length
+        else:
+            newline = line
+            self._linelen += length
+
+        return newline
+
+
+    def _escape_chars(self, text):
+        text = text.replace('\\', '\\[u005C]'). \
+                    replace('.', '\\[char46]'). \
+                    replace('\'', '\\[u0027]'). \
+                    replace('`', '\\[u0060]'). \
+                    replace('~', '\\[u007E]')
+        copy = text
+
+        for char in copy:
+            if len(char) != len(char.encode()):
+                uni = char.encode('unicode_escape') \
+                    .decode()[1:] \
+                    .replace('x', 'u00') \
+                    .upper()
+                text = text.replace(char, '\\[u' + uni[1:] + ']')
+
+        return text
+
+
+    def format_unencoded(self, tokensource, outfile):
+        self._define_colors(outfile)
+
+        outfile.write('.nf\n\\f[CR]\n')
+
+        if self.linenos:
+            self._write_lineno(outfile)
+
+        for ttype, value in tokensource:
+            while ttype not in self.styles:
+                ttype = ttype.parent
+            start, end = self.styles[ttype]
+
+            for line in value.splitlines(True):
+                if self.wrap > 0:
+                    line = self._wrap_line(line)
+
+                if start and end:
+                    text = self._escape_chars(line.rstrip('\n'))
+                    if text != '':
+                        outfile.write(''.join((start, text, end)))
+                else:
+                    outfile.write(self._escape_chars(line.rstrip('\n')))
+
+                if line.endswith('\n'):
+                    if self.linenos:
+                        self._write_lineno(outfile)
+                        self._linelen = 0
+                    else:
+                        outfile.write('\n')
+                        self._linelen = 0
+
+        outfile.write('\n.fi')
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/html.py b/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/html.py
new file mode 100644
index 0000000..7aa938f
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/html.py
@@ -0,0 +1,987 @@
+"""
+    pygments.formatters.html
+    ~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Formatter for HTML output.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import functools
+import os
+import sys
+import os.path
+from io import StringIO
+
+from pip._vendor.pygments.formatter import Formatter
+from pip._vendor.pygments.token import Token, Text, STANDARD_TYPES
+from pip._vendor.pygments.util import get_bool_opt, get_int_opt, get_list_opt
+
+try:
+    import ctags
+except ImportError:
+    ctags = None
+
+__all__ = ['HtmlFormatter']
+
+
+_escape_html_table = {
+    ord('&'): '&',
+    ord('<'): '<',
+    ord('>'): '>',
+    ord('"'): '"',
+    ord("'"): ''',
+}
+
+
+def escape_html(text, table=_escape_html_table):
+    """Escape &, <, > as well as single and double quotes for HTML."""
+    return text.translate(table)
+
+
+def webify(color):
+    if color.startswith('calc') or color.startswith('var'):
+        return color
+    else:
+        return '#' + color
+
+
+def _get_ttype_class(ttype):
+    fname = STANDARD_TYPES.get(ttype)
+    if fname:
+        return fname
+    aname = ''
+    while fname is None:
+        aname = '-' + ttype[-1] + aname
+        ttype = ttype.parent
+        fname = STANDARD_TYPES.get(ttype)
+    return fname + aname
+
+
+CSSFILE_TEMPLATE = '''\
+/*
+generated by Pygments 
+Copyright 2006-2024 by the Pygments team.
+Licensed under the BSD license, see LICENSE for details.
+*/
+%(styledefs)s
+'''
+
+DOC_HEADER = '''\
+
+
+
+
+  %(title)s
+  
+  
+
+
+
%(title)s

+
+'''
+
+DOC_HEADER_EXTERNALCSS = '''\
+
+
+
+
+  %(title)s
+  
+  
+
+
+
%(title)s

+
+'''
+
+DOC_FOOTER = '''\
+
+
+'''
+
+
+class HtmlFormatter(Formatter):
+    r"""
+    Format tokens as HTML 4 ```` tags. By default, the content is enclosed
+    in a ``
`` tag, itself wrapped in a ``
`` tag (but see the `nowrap` option).
+    The ``
``'s CSS class can be set by the `cssclass` option.
+
+    If the `linenos` option is set to ``"table"``, the ``
`` is
+    additionally wrapped inside a ```` which has one row and two
+    cells: one containing the line numbers and one containing the code.
+    Example:
+
+    .. sourcecode:: html
+
+        

+        

+          
+          
+        

+            
1
+            2

+          		
+            
def foo(bar):
+              pass
+            

+          

+
+    (whitespace added to improve clarity).
+
+    A list of lines can be specified using the `hl_lines` option to make these
+    lines highlighted (as of Pygments 0.11).
+
+    With the `full` option, a complete HTML 4 document is output, including
+    the style definitions inside a ``
+
+
+    
{code}

+
+
+"""
+
+CONSOLE_SVG_FORMAT = """\
+
+    
+    
+
+    
+    
+      
+    
+    {lines}
+    
+
+    {chrome}
+    
+    {backgrounds}
+    
+    {matrix}
+    
+    
+
+"""
+
+_SVG_FONT_FAMILY = "Rich Fira Code"
+_SVG_CLASSES_PREFIX = "rich-svg"
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_extension.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_extension.py
new file mode 100644
index 0000000..cbd6da9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_extension.py
@@ -0,0 +1,10 @@
+from typing import Any
+
+
+def load_ipython_extension(ip: Any) -> None:  # pragma: no cover
+    # prevent circular import
+    from pip._vendor.rich.pretty import install
+    from pip._vendor.rich.traceback import install as tr_install
+
+    install()
+    tr_install()
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_fileno.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_fileno.py
new file mode 100644
index 0000000..b17ee65
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_fileno.py
@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from typing import IO, Callable
+
+
+def get_fileno(file_like: IO[str]) -> int | None:
+    """Get fileno() from a file, accounting for poorly implemented file-like objects.
+
+    Args:
+        file_like (IO): A file-like object.
+
+    Returns:
+        int | None: The result of fileno if available, or None if operation failed.
+    """
+    fileno: Callable[[], int] | None = getattr(file_like, "fileno", None)
+    if fileno is not None:
+        try:
+            return fileno()
+        except Exception:
+            # `fileno` is documented as potentially raising a OSError
+            # Alas, from the issues, there are so many poorly implemented file-like objects,
+            # that `fileno()` can raise just about anything.
+            return None
+    return None
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_inspect.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_inspect.py
new file mode 100644
index 0000000..e87698d
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_inspect.py
@@ -0,0 +1,268 @@
+import inspect
+from inspect import cleandoc, getdoc, getfile, isclass, ismodule, signature
+from typing import Any, Collection, Iterable, Optional, Tuple, Type, Union
+
+from .console import Group, RenderableType
+from .control import escape_control_codes
+from .highlighter import ReprHighlighter
+from .jupyter import JupyterMixin
+from .panel import Panel
+from .pretty import Pretty
+from .table import Table
+from .text import Text, TextType
+
+
+def _first_paragraph(doc: str) -> str:
+    """Get the first paragraph from a docstring."""
+    paragraph, _, _ = doc.partition("\n\n")
+    return paragraph
+
+
+class Inspect(JupyterMixin):
+    """A renderable to inspect any Python Object.
+
+    Args:
+        obj (Any): An object to inspect.
+        title (str, optional): Title to display over inspect result, or None use type. Defaults to None.
+        help (bool, optional): Show full help text rather than just first paragraph. Defaults to False.
+        methods (bool, optional): Enable inspection of callables. Defaults to False.
+        docs (bool, optional): Also render doc strings. Defaults to True.
+        private (bool, optional): Show private attributes (beginning with underscore). Defaults to False.
+        dunder (bool, optional): Show attributes starting with double underscore. Defaults to False.
+        sort (bool, optional): Sort attributes alphabetically. Defaults to True.
+        all (bool, optional): Show all attributes. Defaults to False.
+        value (bool, optional): Pretty print value of object. Defaults to True.
+    """
+
+    def __init__(
+        self,
+        obj: Any,
+        *,
+        title: Optional[TextType] = None,
+        help: bool = False,
+        methods: bool = False,
+        docs: bool = True,
+        private: bool = False,
+        dunder: bool = False,
+        sort: bool = True,
+        all: bool = True,
+        value: bool = True,
+    ) -> None:
+        self.highlighter = ReprHighlighter()
+        self.obj = obj
+        self.title = title or self._make_title(obj)
+        if all:
+            methods = private = dunder = True
+        self.help = help
+        self.methods = methods
+        self.docs = docs or help
+        self.private = private or dunder
+        self.dunder = dunder
+        self.sort = sort
+        self.value = value
+
+    def _make_title(self, obj: Any) -> Text:
+        """Make a default title."""
+        title_str = (
+            str(obj)
+            if (isclass(obj) or callable(obj) or ismodule(obj))
+            else str(type(obj))
+        )
+        title_text = self.highlighter(title_str)
+        return title_text
+
+    def __rich__(self) -> Panel:
+        return Panel.fit(
+            Group(*self._render()),
+            title=self.title,
+            border_style="scope.border",
+            padding=(0, 1),
+        )
+
+    def _get_signature(self, name: str, obj: Any) -> Optional[Text]:
+        """Get a signature for a callable."""
+        try:
+            _signature = str(signature(obj)) + ":"
+        except ValueError:
+            _signature = "(...)"
+        except TypeError:
+            return None
+
+        source_filename: Optional[str] = None
+        try:
+            source_filename = getfile(obj)
+        except (OSError, TypeError):
+            # OSError is raised if obj has no source file, e.g. when defined in REPL.
+            pass
+
+        callable_name = Text(name, style="inspect.callable")
+        if source_filename:
+            callable_name.stylize(f"link file://{source_filename}")
+        signature_text = self.highlighter(_signature)
+
+        qualname = name or getattr(obj, "__qualname__", name)
+
+        # If obj is a module, there may be classes (which are callable) to display
+        if inspect.isclass(obj):
+            prefix = "class"
+        elif inspect.iscoroutinefunction(obj):
+            prefix = "async def"
+        else:
+            prefix = "def"
+
+        qual_signature = Text.assemble(
+            (f"{prefix} ", f"inspect.{prefix.replace(' ', '_')}"),
+            (qualname, "inspect.callable"),
+            signature_text,
+        )
+
+        return qual_signature
+
+    def _render(self) -> Iterable[RenderableType]:
+        """Render object."""
+
+        def sort_items(item: Tuple[str, Any]) -> Tuple[bool, str]:
+            key, (_error, value) = item
+            return (callable(value), key.strip("_").lower())
+
+        def safe_getattr(attr_name: str) -> Tuple[Any, Any]:
+            """Get attribute or any exception."""
+            try:
+                return (None, getattr(obj, attr_name))
+            except Exception as error:
+                return (error, None)
+
+        obj = self.obj
+        keys = dir(obj)
+        total_items = len(keys)
+        if not self.dunder:
+            keys = [key for key in keys if not key.startswith("__")]
+        if not self.private:
+            keys = [key for key in keys if not key.startswith("_")]
+        not_shown_count = total_items - len(keys)
+        items = [(key, safe_getattr(key)) for key in keys]
+        if self.sort:
+            items.sort(key=sort_items)
+
+        items_table = Table.grid(padding=(0, 1), expand=False)
+        items_table.add_column(justify="right")
+        add_row = items_table.add_row
+        highlighter = self.highlighter
+
+        if callable(obj):
+            signature = self._get_signature("", obj)
+            if signature is not None:
+                yield signature
+                yield ""
+
+        if self.docs:
+            _doc = self._get_formatted_doc(obj)
+            if _doc is not None:
+                doc_text = Text(_doc, style="inspect.help")
+                doc_text = highlighter(doc_text)
+                yield doc_text
+                yield ""
+
+        if self.value and not (isclass(obj) or callable(obj) or ismodule(obj)):
+            yield Panel(
+                Pretty(obj, indent_guides=True, max_length=10, max_string=60),
+                border_style="inspect.value.border",
+            )
+            yield ""
+
+        for key, (error, value) in items:
+            key_text = Text.assemble(
+                (
+                    key,
+                    "inspect.attr.dunder" if key.startswith("__") else "inspect.attr",
+                ),
+                (" =", "inspect.equals"),
+            )
+            if error is not None:
+                warning = key_text.copy()
+                warning.stylize("inspect.error")
+                add_row(warning, highlighter(repr(error)))
+                continue
+
+            if callable(value):
+                if not self.methods:
+                    continue
+
+                _signature_text = self._get_signature(key, value)
+                if _signature_text is None:
+                    add_row(key_text, Pretty(value, highlighter=highlighter))
+                else:
+                    if self.docs:
+                        docs = self._get_formatted_doc(value)
+                        if docs is not None:
+                            _signature_text.append("\n" if "\n" in docs else " ")
+                            doc = highlighter(docs)
+                            doc.stylize("inspect.doc")
+                            _signature_text.append(doc)
+
+                    add_row(key_text, _signature_text)
+            else:
+                add_row(key_text, Pretty(value, highlighter=highlighter))
+        if items_table.row_count:
+            yield items_table
+        elif not_shown_count:
+            yield Text.from_markup(
+                f"[b cyan]{not_shown_count}[/][i] attribute(s) not shown.[/i] "
+                f"Run [b][magenta]inspect[/]([not b]inspect[/])[/b] for options."
+            )
+
+    def _get_formatted_doc(self, object_: Any) -> Optional[str]:
+        """
+        Extract the docstring of an object, process it and returns it.
+        The processing consists in cleaning up the doctring's indentation,
+        taking only its 1st paragraph if `self.help` is not True,
+        and escape its control codes.
+
+        Args:
+            object_ (Any): the object to get the docstring from.
+
+        Returns:
+            Optional[str]: the processed docstring, or None if no docstring was found.
+        """
+        docs = getdoc(object_)
+        if docs is None:
+            return None
+        docs = cleandoc(docs).strip()
+        if not self.help:
+            docs = _first_paragraph(docs)
+        return escape_control_codes(docs)
+
+
+def get_object_types_mro(obj: Union[object, Type[Any]]) -> Tuple[type, ...]:
+    """Returns the MRO of an object's class, or of the object itself if it's a class."""
+    if not hasattr(obj, "__mro__"):
+        # N.B. we cannot use `if type(obj) is type` here because it doesn't work with
+        # some types of classes, such as the ones that use abc.ABCMeta.
+        obj = type(obj)
+    return getattr(obj, "__mro__", ())
+
+
+def get_object_types_mro_as_strings(obj: object) -> Collection[str]:
+    """
+    Returns the MRO of an object's class as full qualified names, or of the object itself if it's a class.
+
+    Examples:
+        `object_types_mro_as_strings(JSONDecoder)` will return `['json.decoder.JSONDecoder', 'builtins.object']`
+    """
+    return [
+        f'{getattr(type_, "__module__", "")}.{getattr(type_, "__qualname__", "")}'
+        for type_ in get_object_types_mro(obj)
+    ]
+
+
+def is_object_one_of_types(
+    obj: object, fully_qualified_types_names: Collection[str]
+) -> bool:
+    """
+    Returns `True` if the given object's class (or the object itself, if it's a class) has one of the
+    fully qualified names in its MRO.
+    """
+    for type_name in get_object_types_mro_as_strings(obj):
+        if type_name in fully_qualified_types_names:
+            return True
+    return False
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_log_render.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_log_render.py
new file mode 100644
index 0000000..fc16c84
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_log_render.py
@@ -0,0 +1,94 @@
+from datetime import datetime
+from typing import Iterable, List, Optional, TYPE_CHECKING, Union, Callable
+
+
+from .text import Text, TextType
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleRenderable, RenderableType
+    from .table import Table
+
+FormatTimeCallable = Callable[[datetime], Text]
+
+
+class LogRender:
+    def __init__(
+        self,
+        show_time: bool = True,
+        show_level: bool = False,
+        show_path: bool = True,
+        time_format: Union[str, FormatTimeCallable] = "[%x %X]",
+        omit_repeated_times: bool = True,
+        level_width: Optional[int] = 8,
+    ) -> None:
+        self.show_time = show_time
+        self.show_level = show_level
+        self.show_path = show_path
+        self.time_format = time_format
+        self.omit_repeated_times = omit_repeated_times
+        self.level_width = level_width
+        self._last_time: Optional[Text] = None
+
+    def __call__(
+        self,
+        console: "Console",
+        renderables: Iterable["ConsoleRenderable"],
+        log_time: Optional[datetime] = None,
+        time_format: Optional[Union[str, FormatTimeCallable]] = None,
+        level: TextType = "",
+        path: Optional[str] = None,
+        line_no: Optional[int] = None,
+        link_path: Optional[str] = None,
+    ) -> "Table":
+        from .containers import Renderables
+        from .table import Table
+
+        output = Table.grid(padding=(0, 1))
+        output.expand = True
+        if self.show_time:
+            output.add_column(style="log.time")
+        if self.show_level:
+            output.add_column(style="log.level", width=self.level_width)
+        output.add_column(ratio=1, style="log.message", overflow="fold")
+        if self.show_path and path:
+            output.add_column(style="log.path")
+        row: List["RenderableType"] = []
+        if self.show_time:
+            log_time = log_time or console.get_datetime()
+            time_format = time_format or self.time_format
+            if callable(time_format):
+                log_time_display = time_format(log_time)
+            else:
+                log_time_display = Text(log_time.strftime(time_format))
+            if log_time_display == self._last_time and self.omit_repeated_times:
+                row.append(Text(" " * len(log_time_display)))
+            else:
+                row.append(log_time_display)
+                self._last_time = log_time_display
+        if self.show_level:
+            row.append(level)
+
+        row.append(Renderables(renderables))
+        if self.show_path and path:
+            path_text = Text()
+            path_text.append(
+                path, style=f"link file://{link_path}" if link_path else ""
+            )
+            if line_no:
+                path_text.append(":")
+                path_text.append(
+                    f"{line_no}",
+                    style=f"link file://{link_path}#{line_no}" if link_path else "",
+                )
+            row.append(path_text)
+
+        output.add_row(*row)
+        return output
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Console
+
+    c = Console()
+    c.print("[on blue]Hello", justify="right")
+    c.log("[on blue]hello", justify="right")
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_loop.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_loop.py
new file mode 100644
index 0000000..01c6caf
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_loop.py
@@ -0,0 +1,43 @@
+from typing import Iterable, Tuple, TypeVar
+
+T = TypeVar("T")
+
+
+def loop_first(values: Iterable[T]) -> Iterable[Tuple[bool, T]]:
+    """Iterate and generate a tuple with a flag for first value."""
+    iter_values = iter(values)
+    try:
+        value = next(iter_values)
+    except StopIteration:
+        return
+    yield True, value
+    for value in iter_values:
+        yield False, value
+
+
+def loop_last(values: Iterable[T]) -> Iterable[Tuple[bool, T]]:
+    """Iterate and generate a tuple with a flag for last value."""
+    iter_values = iter(values)
+    try:
+        previous_value = next(iter_values)
+    except StopIteration:
+        return
+    for value in iter_values:
+        yield False, previous_value
+        previous_value = value
+    yield True, previous_value
+
+
+def loop_first_last(values: Iterable[T]) -> Iterable[Tuple[bool, bool, T]]:
+    """Iterate and generate a tuple with a flag for first and last value."""
+    iter_values = iter(values)
+    try:
+        previous_value = next(iter_values)
+    except StopIteration:
+        return
+    first = True
+    for value in iter_values:
+        yield first, False, previous_value
+        first = False
+        previous_value = value
+    yield first, True, previous_value
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_null_file.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_null_file.py
new file mode 100644
index 0000000..6ae05d3
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_null_file.py
@@ -0,0 +1,69 @@
+from types import TracebackType
+from typing import IO, Iterable, Iterator, List, Optional, Type
+
+
+class NullFile(IO[str]):
+    def close(self) -> None:
+        pass
+
+    def isatty(self) -> bool:
+        return False
+
+    def read(self, __n: int = 1) -> str:
+        return ""
+
+    def readable(self) -> bool:
+        return False
+
+    def readline(self, __limit: int = 1) -> str:
+        return ""
+
+    def readlines(self, __hint: int = 1) -> List[str]:
+        return []
+
+    def seek(self, __offset: int, __whence: int = 1) -> int:
+        return 0
+
+    def seekable(self) -> bool:
+        return False
+
+    def tell(self) -> int:
+        return 0
+
+    def truncate(self, __size: Optional[int] = 1) -> int:
+        return 0
+
+    def writable(self) -> bool:
+        return False
+
+    def writelines(self, __lines: Iterable[str]) -> None:
+        pass
+
+    def __next__(self) -> str:
+        return ""
+
+    def __iter__(self) -> Iterator[str]:
+        return iter([""])
+
+    def __enter__(self) -> IO[str]:
+        return self
+
+    def __exit__(
+        self,
+        __t: Optional[Type[BaseException]],
+        __value: Optional[BaseException],
+        __traceback: Optional[TracebackType],
+    ) -> None:
+        pass
+
+    def write(self, text: str) -> int:
+        return 0
+
+    def flush(self) -> None:
+        pass
+
+    def fileno(self) -> int:
+        return -1
+
+
+NULL_FILE = NullFile()
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_palettes.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_palettes.py
new file mode 100644
index 0000000..3c748d3
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_palettes.py
@@ -0,0 +1,309 @@
+from .palette import Palette
+
+
+# Taken from https://en.wikipedia.org/wiki/ANSI_escape_code (Windows 10 column)
+WINDOWS_PALETTE = Palette(
+    [
+        (12, 12, 12),
+        (197, 15, 31),
+        (19, 161, 14),
+        (193, 156, 0),
+        (0, 55, 218),
+        (136, 23, 152),
+        (58, 150, 221),
+        (204, 204, 204),
+        (118, 118, 118),
+        (231, 72, 86),
+        (22, 198, 12),
+        (249, 241, 165),
+        (59, 120, 255),
+        (180, 0, 158),
+        (97, 214, 214),
+        (242, 242, 242),
+    ]
+)
+
+# # The standard ansi colors (including bright variants)
+STANDARD_PALETTE = Palette(
+    [
+        (0, 0, 0),
+        (170, 0, 0),
+        (0, 170, 0),
+        (170, 85, 0),
+        (0, 0, 170),
+        (170, 0, 170),
+        (0, 170, 170),
+        (170, 170, 170),
+        (85, 85, 85),
+        (255, 85, 85),
+        (85, 255, 85),
+        (255, 255, 85),
+        (85, 85, 255),
+        (255, 85, 255),
+        (85, 255, 255),
+        (255, 255, 255),
+    ]
+)
+
+
+# The 256 color palette
+EIGHT_BIT_PALETTE = Palette(
+    [
+        (0, 0, 0),
+        (128, 0, 0),
+        (0, 128, 0),
+        (128, 128, 0),
+        (0, 0, 128),
+        (128, 0, 128),
+        (0, 128, 128),
+        (192, 192, 192),
+        (128, 128, 128),
+        (255, 0, 0),
+        (0, 255, 0),
+        (255, 255, 0),
+        (0, 0, 255),
+        (255, 0, 255),
+        (0, 255, 255),
+        (255, 255, 255),
+        (0, 0, 0),
+        (0, 0, 95),
+        (0, 0, 135),
+        (0, 0, 175),
+        (0, 0, 215),
+        (0, 0, 255),
+        (0, 95, 0),
+        (0, 95, 95),
+        (0, 95, 135),
+        (0, 95, 175),
+        (0, 95, 215),
+        (0, 95, 255),
+        (0, 135, 0),
+        (0, 135, 95),
+        (0, 135, 135),
+        (0, 135, 175),
+        (0, 135, 215),
+        (0, 135, 255),
+        (0, 175, 0),
+        (0, 175, 95),
+        (0, 175, 135),
+        (0, 175, 175),
+        (0, 175, 215),
+        (0, 175, 255),
+        (0, 215, 0),
+        (0, 215, 95),
+        (0, 215, 135),
+        (0, 215, 175),
+        (0, 215, 215),
+        (0, 215, 255),
+        (0, 255, 0),
+        (0, 255, 95),
+        (0, 255, 135),
+        (0, 255, 175),
+        (0, 255, 215),
+        (0, 255, 255),
+        (95, 0, 0),
+        (95, 0, 95),
+        (95, 0, 135),
+        (95, 0, 175),
+        (95, 0, 215),
+        (95, 0, 255),
+        (95, 95, 0),
+        (95, 95, 95),
+        (95, 95, 135),
+        (95, 95, 175),
+        (95, 95, 215),
+        (95, 95, 255),
+        (95, 135, 0),
+        (95, 135, 95),
+        (95, 135, 135),
+        (95, 135, 175),
+        (95, 135, 215),
+        (95, 135, 255),
+        (95, 175, 0),
+        (95, 175, 95),
+        (95, 175, 135),
+        (95, 175, 175),
+        (95, 175, 215),
+        (95, 175, 255),
+        (95, 215, 0),
+        (95, 215, 95),
+        (95, 215, 135),
+        (95, 215, 175),
+        (95, 215, 215),
+        (95, 215, 255),
+        (95, 255, 0),
+        (95, 255, 95),
+        (95, 255, 135),
+        (95, 255, 175),
+        (95, 255, 215),
+        (95, 255, 255),
+        (135, 0, 0),
+        (135, 0, 95),
+        (135, 0, 135),
+        (135, 0, 175),
+        (135, 0, 215),
+        (135, 0, 255),
+        (135, 95, 0),
+        (135, 95, 95),
+        (135, 95, 135),
+        (135, 95, 175),
+        (135, 95, 215),
+        (135, 95, 255),
+        (135, 135, 0),
+        (135, 135, 95),
+        (135, 135, 135),
+        (135, 135, 175),
+        (135, 135, 215),
+        (135, 135, 255),
+        (135, 175, 0),
+        (135, 175, 95),
+        (135, 175, 135),
+        (135, 175, 175),
+        (135, 175, 215),
+        (135, 175, 255),
+        (135, 215, 0),
+        (135, 215, 95),
+        (135, 215, 135),
+        (135, 215, 175),
+        (135, 215, 215),
+        (135, 215, 255),
+        (135, 255, 0),
+        (135, 255, 95),
+        (135, 255, 135),
+        (135, 255, 175),
+        (135, 255, 215),
+        (135, 255, 255),
+        (175, 0, 0),
+        (175, 0, 95),
+        (175, 0, 135),
+        (175, 0, 175),
+        (175, 0, 215),
+        (175, 0, 255),
+        (175, 95, 0),
+        (175, 95, 95),
+        (175, 95, 135),
+        (175, 95, 175),
+        (175, 95, 215),
+        (175, 95, 255),
+        (175, 135, 0),
+        (175, 135, 95),
+        (175, 135, 135),
+        (175, 135, 175),
+        (175, 135, 215),
+        (175, 135, 255),
+        (175, 175, 0),
+        (175, 175, 95),
+        (175, 175, 135),
+        (175, 175, 175),
+        (175, 175, 215),
+        (175, 175, 255),
+        (175, 215, 0),
+        (175, 215, 95),
+        (175, 215, 135),
+        (175, 215, 175),
+        (175, 215, 215),
+        (175, 215, 255),
+        (175, 255, 0),
+        (175, 255, 95),
+        (175, 255, 135),
+        (175, 255, 175),
+        (175, 255, 215),
+        (175, 255, 255),
+        (215, 0, 0),
+        (215, 0, 95),
+        (215, 0, 135),
+        (215, 0, 175),
+        (215, 0, 215),
+        (215, 0, 255),
+        (215, 95, 0),
+        (215, 95, 95),
+        (215, 95, 135),
+        (215, 95, 175),
+        (215, 95, 215),
+        (215, 95, 255),
+        (215, 135, 0),
+        (215, 135, 95),
+        (215, 135, 135),
+        (215, 135, 175),
+        (215, 135, 215),
+        (215, 135, 255),
+        (215, 175, 0),
+        (215, 175, 95),
+        (215, 175, 135),
+        (215, 175, 175),
+        (215, 175, 215),
+        (215, 175, 255),
+        (215, 215, 0),
+        (215, 215, 95),
+        (215, 215, 135),
+        (215, 215, 175),
+        (215, 215, 215),
+        (215, 215, 255),
+        (215, 255, 0),
+        (215, 255, 95),
+        (215, 255, 135),
+        (215, 255, 175),
+        (215, 255, 215),
+        (215, 255, 255),
+        (255, 0, 0),
+        (255, 0, 95),
+        (255, 0, 135),
+        (255, 0, 175),
+        (255, 0, 215),
+        (255, 0, 255),
+        (255, 95, 0),
+        (255, 95, 95),
+        (255, 95, 135),
+        (255, 95, 175),
+        (255, 95, 215),
+        (255, 95, 255),
+        (255, 135, 0),
+        (255, 135, 95),
+        (255, 135, 135),
+        (255, 135, 175),
+        (255, 135, 215),
+        (255, 135, 255),
+        (255, 175, 0),
+        (255, 175, 95),
+        (255, 175, 135),
+        (255, 175, 175),
+        (255, 175, 215),
+        (255, 175, 255),
+        (255, 215, 0),
+        (255, 215, 95),
+        (255, 215, 135),
+        (255, 215, 175),
+        (255, 215, 215),
+        (255, 215, 255),
+        (255, 255, 0),
+        (255, 255, 95),
+        (255, 255, 135),
+        (255, 255, 175),
+        (255, 255, 215),
+        (255, 255, 255),
+        (8, 8, 8),
+        (18, 18, 18),
+        (28, 28, 28),
+        (38, 38, 38),
+        (48, 48, 48),
+        (58, 58, 58),
+        (68, 68, 68),
+        (78, 78, 78),
+        (88, 88, 88),
+        (98, 98, 98),
+        (108, 108, 108),
+        (118, 118, 118),
+        (128, 128, 128),
+        (138, 138, 138),
+        (148, 148, 148),
+        (158, 158, 158),
+        (168, 168, 168),
+        (178, 178, 178),
+        (188, 188, 188),
+        (198, 198, 198),
+        (208, 208, 208),
+        (218, 218, 218),
+        (228, 228, 228),
+        (238, 238, 238),
+    ]
+)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_pick.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_pick.py
new file mode 100644
index 0000000..4f6d8b2
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_pick.py
@@ -0,0 +1,17 @@
+from typing import Optional
+
+
+def pick_bool(*values: Optional[bool]) -> bool:
+    """Pick the first non-none bool or return the last value.
+
+    Args:
+        *values (bool): Any number of boolean or None values.
+
+    Returns:
+        bool: First non-none boolean.
+    """
+    assert values, "1 or more values required"
+    for value in values:
+        if value is not None:
+            return value
+    return bool(value)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_ratio.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_ratio.py
new file mode 100644
index 0000000..95267b0
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_ratio.py
@@ -0,0 +1,159 @@
+import sys
+from fractions import Fraction
+from math import ceil
+from typing import cast, List, Optional, Sequence
+
+if sys.version_info >= (3, 8):
+    from typing import Protocol
+else:
+    from pip._vendor.typing_extensions import Protocol  # pragma: no cover
+
+
+class Edge(Protocol):
+    """Any object that defines an edge (such as Layout)."""
+
+    size: Optional[int] = None
+    ratio: int = 1
+    minimum_size: int = 1
+
+
+def ratio_resolve(total: int, edges: Sequence[Edge]) -> List[int]:
+    """Divide total space to satisfy size, ratio, and minimum_size, constraints.
+
+    The returned list of integers should add up to total in most cases, unless it is
+    impossible to satisfy all the constraints. For instance, if there are two edges
+    with a minimum size of 20 each and `total` is 30 then the returned list will be
+    greater than total. In practice, this would mean that a Layout object would
+    clip the rows that would overflow the screen height.
+
+    Args:
+        total (int): Total number of characters.
+        edges (List[Edge]): Edges within total space.
+
+    Returns:
+        List[int]: Number of characters for each edge.
+    """
+    # Size of edge or None for yet to be determined
+    sizes = [(edge.size or None) for edge in edges]
+
+    _Fraction = Fraction
+
+    # While any edges haven't been calculated
+    while None in sizes:
+        # Get flexible edges and index to map these back on to sizes list
+        flexible_edges = [
+            (index, edge)
+            for index, (size, edge) in enumerate(zip(sizes, edges))
+            if size is None
+        ]
+        # Remaining space in total
+        remaining = total - sum(size or 0 for size in sizes)
+        if remaining <= 0:
+            # No room for flexible edges
+            return [
+                ((edge.minimum_size or 1) if size is None else size)
+                for size, edge in zip(sizes, edges)
+            ]
+        # Calculate number of characters in a ratio portion
+        portion = _Fraction(
+            remaining, sum((edge.ratio or 1) for _, edge in flexible_edges)
+        )
+
+        # If any edges will be less than their minimum, replace size with the minimum
+        for index, edge in flexible_edges:
+            if portion * edge.ratio <= edge.minimum_size:
+                sizes[index] = edge.minimum_size
+                # New fixed size will invalidate calculations, so we need to repeat the process
+                break
+        else:
+            # Distribute flexible space and compensate for rounding error
+            # Since edge sizes can only be integers we need to add the remainder
+            # to the following line
+            remainder = _Fraction(0)
+            for index, edge in flexible_edges:
+                size, remainder = divmod(portion * edge.ratio + remainder, 1)
+                sizes[index] = size
+            break
+    # Sizes now contains integers only
+    return cast(List[int], sizes)
+
+
+def ratio_reduce(
+    total: int, ratios: List[int], maximums: List[int], values: List[int]
+) -> List[int]:
+    """Divide an integer total in to parts based on ratios.
+
+    Args:
+        total (int): The total to divide.
+        ratios (List[int]): A list of integer ratios.
+        maximums (List[int]): List of maximums values for each slot.
+        values (List[int]): List of values
+
+    Returns:
+        List[int]: A list of integers guaranteed to sum to total.
+    """
+    ratios = [ratio if _max else 0 for ratio, _max in zip(ratios, maximums)]
+    total_ratio = sum(ratios)
+    if not total_ratio:
+        return values[:]
+    total_remaining = total
+    result: List[int] = []
+    append = result.append
+    for ratio, maximum, value in zip(ratios, maximums, values):
+        if ratio and total_ratio > 0:
+            distributed = min(maximum, round(ratio * total_remaining / total_ratio))
+            append(value - distributed)
+            total_remaining -= distributed
+            total_ratio -= ratio
+        else:
+            append(value)
+    return result
+
+
+def ratio_distribute(
+    total: int, ratios: List[int], minimums: Optional[List[int]] = None
+) -> List[int]:
+    """Distribute an integer total in to parts based on ratios.
+
+    Args:
+        total (int): The total to divide.
+        ratios (List[int]): A list of integer ratios.
+        minimums (List[int]): List of minimum values for each slot.
+
+    Returns:
+        List[int]: A list of integers guaranteed to sum to total.
+    """
+    if minimums:
+        ratios = [ratio if _min else 0 for ratio, _min in zip(ratios, minimums)]
+    total_ratio = sum(ratios)
+    assert total_ratio > 0, "Sum of ratios must be > 0"
+
+    total_remaining = total
+    distributed_total: List[int] = []
+    append = distributed_total.append
+    if minimums is None:
+        _minimums = [0] * len(ratios)
+    else:
+        _minimums = minimums
+    for ratio, minimum in zip(ratios, _minimums):
+        if total_ratio > 0:
+            distributed = max(minimum, ceil(ratio * total_remaining / total_ratio))
+        else:
+            distributed = total_remaining
+        append(distributed)
+        total_ratio -= ratio
+        total_remaining -= distributed
+    return distributed_total
+
+
+if __name__ == "__main__":
+    from dataclasses import dataclass
+
+    @dataclass
+    class E:
+        size: Optional[int] = None
+        ratio: int = 1
+        minimum_size: int = 1
+
+    resolved = ratio_resolve(110, [E(None, 1, 1), E(None, 1, 1), E(None, 1, 1)])
+    print(sum(resolved))
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_spinners.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_spinners.py
new file mode 100644
index 0000000..d0bb1fe
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_spinners.py
@@ -0,0 +1,482 @@
+"""
+Spinners are from:
+* cli-spinners:
+    MIT License
+    Copyright (c) Sindre Sorhus  (sindresorhus.com)
+    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.
+"""
+
+SPINNERS = {
+    "dots": {
+        "interval": 80,
+        "frames": "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏",
+    },
+    "dots2": {"interval": 80, "frames": "⣾⣽⣻⢿⡿⣟⣯⣷"},
+    "dots3": {
+        "interval": 80,
+        "frames": "⠋⠙⠚⠞⠖⠦⠴⠲⠳⠓",
+    },
+    "dots4": {
+        "interval": 80,
+        "frames": "⠄⠆⠇⠋⠙⠸⠰⠠⠰⠸⠙⠋⠇⠆",
+    },
+    "dots5": {
+        "interval": 80,
+        "frames": "⠋⠙⠚⠒⠂⠂⠒⠲⠴⠦⠖⠒⠐⠐⠒⠓⠋",
+    },
+    "dots6": {
+        "interval": 80,
+        "frames": "⠁⠉⠙⠚⠒⠂⠂⠒⠲⠴⠤⠄⠄⠤⠴⠲⠒⠂⠂⠒⠚⠙⠉⠁",
+    },
+    "dots7": {
+        "interval": 80,
+        "frames": "⠈⠉⠋⠓⠒⠐⠐⠒⠖⠦⠤⠠⠠⠤⠦⠖⠒⠐⠐⠒⠓⠋⠉⠈",
+    },
+    "dots8": {
+        "interval": 80,
+        "frames": "⠁⠁⠉⠙⠚⠒⠂⠂⠒⠲⠴⠤⠄⠄⠤⠠⠠⠤⠦⠖⠒⠐⠐⠒⠓⠋⠉⠈⠈",
+    },
+    "dots9": {"interval": 80, "frames": "⢹⢺⢼⣸⣇⡧⡗⡏"},
+    "dots10": {"interval": 80, "frames": "⢄⢂⢁⡁⡈⡐⡠"},
+    "dots11": {"interval": 100, "frames": "⠁⠂⠄⡀⢀⠠⠐⠈"},
+    "dots12": {
+        "interval": 80,
+        "frames": [
+            "⢀⠀",
+            "⡀⠀",
+            "⠄⠀",
+            "⢂⠀",
+            "⡂⠀",
+            "⠅⠀",
+            "⢃⠀",
+            "⡃⠀",
+            "⠍⠀",
+            "⢋⠀",
+            "⡋⠀",
+            "⠍⠁",
+            "⢋⠁",
+            "⡋⠁",
+            "⠍⠉",
+            "⠋⠉",
+            "⠋⠉",
+            "⠉⠙",
+            "⠉⠙",
+            "⠉⠩",
+            "⠈⢙",
+            "⠈⡙",
+            "⢈⠩",
+            "⡀⢙",
+            "⠄⡙",
+            "⢂⠩",
+            "⡂⢘",
+            "⠅⡘",
+            "⢃⠨",
+            "⡃⢐",
+            "⠍⡐",
+            "⢋⠠",
+            "⡋⢀",
+            "⠍⡁",
+            "⢋⠁",
+            "⡋⠁",
+            "⠍⠉",
+            "⠋⠉",
+            "⠋⠉",
+            "⠉⠙",
+            "⠉⠙",
+            "⠉⠩",
+            "⠈⢙",
+            "⠈⡙",
+            "⠈⠩",
+            "⠀⢙",
+            "⠀⡙",
+            "⠀⠩",
+            "⠀⢘",
+            "⠀⡘",
+            "⠀⠨",
+            "⠀⢐",
+            "⠀⡐",
+            "⠀⠠",
+            "⠀⢀",
+            "⠀⡀",
+        ],
+    },
+    "dots8Bit": {
+        "interval": 80,
+        "frames": "⠀⠁⠂⠃⠄⠅⠆⠇⡀⡁⡂⡃⡄⡅⡆⡇⠈⠉⠊⠋⠌⠍⠎⠏⡈⡉⡊⡋⡌⡍⡎⡏⠐⠑⠒⠓⠔⠕⠖⠗⡐⡑⡒⡓⡔⡕⡖⡗⠘⠙⠚⠛⠜⠝⠞⠟⡘⡙"
+        "⡚⡛⡜⡝⡞⡟⠠⠡⠢⠣⠤⠥⠦⠧⡠⡡⡢⡣⡤⡥⡦⡧⠨⠩⠪⠫⠬⠭⠮⠯⡨⡩⡪⡫⡬⡭⡮⡯⠰⠱⠲⠳⠴⠵⠶⠷⡰⡱⡲⡳⡴⡵⡶⡷⠸⠹⠺⠻"
+        "⠼⠽⠾⠿⡸⡹⡺⡻⡼⡽⡾⡿⢀⢁⢂⢃⢄⢅⢆⢇⣀⣁⣂⣃⣄⣅⣆⣇⢈⢉⢊⢋⢌⢍⢎⢏⣈⣉⣊⣋⣌⣍⣎⣏⢐⢑⢒⢓⢔⢕⢖⢗⣐⣑⣒⣓⣔⣕"
+        "⣖⣗⢘⢙⢚⢛⢜⢝⢞⢟⣘⣙⣚⣛⣜⣝⣞⣟⢠⢡⢢⢣⢤⢥⢦⢧⣠⣡⣢⣣⣤⣥⣦⣧⢨⢩⢪⢫⢬⢭⢮⢯⣨⣩⣪⣫⣬⣭⣮⣯⢰⢱⢲⢳⢴⢵⢶⢷"
+        "⣰⣱⣲⣳⣴⣵⣶⣷⢸⢹⢺⢻⢼⢽⢾⢿⣸⣹⣺⣻⣼⣽⣾⣿",
+    },
+    "line": {"interval": 130, "frames": ["-", "\\", "|", "/"]},
+    "line2": {"interval": 100, "frames": "⠂-–—–-"},
+    "pipe": {"interval": 100, "frames": "┤┘┴└├┌┬┐"},
+    "simpleDots": {"interval": 400, "frames": [".  ", ".. ", "...", "   "]},
+    "simpleDotsScrolling": {
+        "interval": 200,
+        "frames": [".  ", ".. ", "...", " ..", "  .", "   "],
+    },
+    "star": {"interval": 70, "frames": "✶✸✹✺✹✷"},
+    "star2": {"interval": 80, "frames": "+x*"},
+    "flip": {
+        "interval": 70,
+        "frames": "___-``'´-___",
+    },
+    "hamburger": {"interval": 100, "frames": "☱☲☴"},
+    "growVertical": {
+        "interval": 120,
+        "frames": "▁▃▄▅▆▇▆▅▄▃",
+    },
+    "growHorizontal": {
+        "interval": 120,
+        "frames": "▏▎▍▌▋▊▉▊▋▌▍▎",
+    },
+    "balloon": {"interval": 140, "frames": " .oO@* "},
+    "balloon2": {"interval": 120, "frames": ".oO°Oo."},
+    "noise": {"interval": 100, "frames": "▓▒░"},
+    "bounce": {"interval": 120, "frames": "⠁⠂⠄⠂"},
+    "boxBounce": {"interval": 120, "frames": "▖▘▝▗"},
+    "boxBounce2": {"interval": 100, "frames": "▌▀▐▄"},
+    "triangle": {"interval": 50, "frames": "◢◣◤◥"},
+    "arc": {"interval": 100, "frames": "◜◠◝◞◡◟"},
+    "circle": {"interval": 120, "frames": "◡⊙◠"},
+    "squareCorners": {"interval": 180, "frames": "◰◳◲◱"},
+    "circleQuarters": {"interval": 120, "frames": "◴◷◶◵"},
+    "circleHalves": {"interval": 50, "frames": "◐◓◑◒"},
+    "squish": {"interval": 100, "frames": "╫╪"},
+    "toggle": {"interval": 250, "frames": "⊶⊷"},
+    "toggle2": {"interval": 80, "frames": "▫▪"},
+    "toggle3": {"interval": 120, "frames": "□■"},
+    "toggle4": {"interval": 100, "frames": "■□▪▫"},
+    "toggle5": {"interval": 100, "frames": "▮▯"},
+    "toggle6": {"interval": 300, "frames": "ဝ၀"},
+    "toggle7": {"interval": 80, "frames": "⦾⦿"},
+    "toggle8": {"interval": 100, "frames": "◍◌"},
+    "toggle9": {"interval": 100, "frames": "◉◎"},
+    "toggle10": {"interval": 100, "frames": "㊂㊀㊁"},
+    "toggle11": {"interval": 50, "frames": "⧇⧆"},
+    "toggle12": {"interval": 120, "frames": "☗☖"},
+    "toggle13": {"interval": 80, "frames": "=*-"},
+    "arrow": {"interval": 100, "frames": "←↖↑↗→↘↓↙"},
+    "arrow2": {
+        "interval": 80,
+        "frames": ["⬆️ ", "↗️ ", "➡️ ", "↘️ ", "⬇️ ", "↙️ ", "⬅️ ", "↖️ "],
+    },
+    "arrow3": {
+        "interval": 120,
+        "frames": ["▹▹▹▹▹", "▸▹▹▹▹", "▹▸▹▹▹", "▹▹▸▹▹", "▹▹▹▸▹", "▹▹▹▹▸"],
+    },
+    "bouncingBar": {
+        "interval": 80,
+        "frames": [
+            "[    ]",
+            "[=   ]",
+            "[==  ]",
+            "[=== ]",
+            "[ ===]",
+            "[  ==]",
+            "[   =]",
+            "[    ]",
+            "[   =]",
+            "[  ==]",
+            "[ ===]",
+            "[====]",
+            "[=== ]",
+            "[==  ]",
+            "[=   ]",
+        ],
+    },
+    "bouncingBall": {
+        "interval": 80,
+        "frames": [
+            "( ●    )",
+            "(  ●   )",
+            "(   ●  )",
+            "(    ● )",
+            "(     ●)",
+            "(    ● )",
+            "(   ●  )",
+            "(  ●   )",
+            "( ●    )",
+            "(●     )",
+        ],
+    },
+    "smiley": {"interval": 200, "frames": ["😄 ", "😝 "]},
+    "monkey": {"interval": 300, "frames": ["🙈 ", "🙈 ", "🙉 ", "🙊 "]},
+    "hearts": {"interval": 100, "frames": ["💛 ", "💙 ", "💜 ", "💚 ", "❤️ "]},
+    "clock": {
+        "interval": 100,
+        "frames": [
+            "🕛 ",
+            "🕐 ",
+            "🕑 ",
+            "🕒 ",
+            "🕓 ",
+            "🕔 ",
+            "🕕 ",
+            "🕖 ",
+            "🕗 ",
+            "🕘 ",
+            "🕙 ",
+            "🕚 ",
+        ],
+    },
+    "earth": {"interval": 180, "frames": ["🌍 ", "🌎 ", "🌏 "]},
+    "material": {
+        "interval": 17,
+        "frames": [
+            "█▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "██▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "███▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "████▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "██████▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "██████▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "███████▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "████████▁▁▁▁▁▁▁▁▁▁▁▁",
+            "█████████▁▁▁▁▁▁▁▁▁▁▁",
+            "█████████▁▁▁▁▁▁▁▁▁▁▁",
+            "██████████▁▁▁▁▁▁▁▁▁▁",
+            "███████████▁▁▁▁▁▁▁▁▁",
+            "█████████████▁▁▁▁▁▁▁",
+            "██████████████▁▁▁▁▁▁",
+            "██████████████▁▁▁▁▁▁",
+            "▁██████████████▁▁▁▁▁",
+            "▁██████████████▁▁▁▁▁",
+            "▁██████████████▁▁▁▁▁",
+            "▁▁██████████████▁▁▁▁",
+            "▁▁▁██████████████▁▁▁",
+            "▁▁▁▁█████████████▁▁▁",
+            "▁▁▁▁██████████████▁▁",
+            "▁▁▁▁██████████████▁▁",
+            "▁▁▁▁▁██████████████▁",
+            "▁▁▁▁▁██████████████▁",
+            "▁▁▁▁▁██████████████▁",
+            "▁▁▁▁▁▁██████████████",
+            "▁▁▁▁▁▁██████████████",
+            "▁▁▁▁▁▁▁█████████████",
+            "▁▁▁▁▁▁▁█████████████",
+            "▁▁▁▁▁▁▁▁████████████",
+            "▁▁▁▁▁▁▁▁████████████",
+            "▁▁▁▁▁▁▁▁▁███████████",
+            "▁▁▁▁▁▁▁▁▁███████████",
+            "▁▁▁▁▁▁▁▁▁▁██████████",
+            "▁▁▁▁▁▁▁▁▁▁██████████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁████████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁███████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁██████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█████",
+            "█▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████",
+            "██▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███",
+            "██▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███",
+            "███▁▁▁▁▁▁▁▁▁▁▁▁▁▁███",
+            "████▁▁▁▁▁▁▁▁▁▁▁▁▁▁██",
+            "█████▁▁▁▁▁▁▁▁▁▁▁▁▁▁█",
+            "█████▁▁▁▁▁▁▁▁▁▁▁▁▁▁█",
+            "██████▁▁▁▁▁▁▁▁▁▁▁▁▁█",
+            "████████▁▁▁▁▁▁▁▁▁▁▁▁",
+            "█████████▁▁▁▁▁▁▁▁▁▁▁",
+            "█████████▁▁▁▁▁▁▁▁▁▁▁",
+            "█████████▁▁▁▁▁▁▁▁▁▁▁",
+            "█████████▁▁▁▁▁▁▁▁▁▁▁",
+            "███████████▁▁▁▁▁▁▁▁▁",
+            "████████████▁▁▁▁▁▁▁▁",
+            "████████████▁▁▁▁▁▁▁▁",
+            "██████████████▁▁▁▁▁▁",
+            "██████████████▁▁▁▁▁▁",
+            "▁██████████████▁▁▁▁▁",
+            "▁██████████████▁▁▁▁▁",
+            "▁▁▁█████████████▁▁▁▁",
+            "▁▁▁▁▁████████████▁▁▁",
+            "▁▁▁▁▁████████████▁▁▁",
+            "▁▁▁▁▁▁███████████▁▁▁",
+            "▁▁▁▁▁▁▁▁█████████▁▁▁",
+            "▁▁▁▁▁▁▁▁█████████▁▁▁",
+            "▁▁▁▁▁▁▁▁▁█████████▁▁",
+            "▁▁▁▁▁▁▁▁▁█████████▁▁",
+            "▁▁▁▁▁▁▁▁▁▁█████████▁",
+            "▁▁▁▁▁▁▁▁▁▁▁████████▁",
+            "▁▁▁▁▁▁▁▁▁▁▁████████▁",
+            "▁▁▁▁▁▁▁▁▁▁▁▁███████▁",
+            "▁▁▁▁▁▁▁▁▁▁▁▁███████▁",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁███████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁███████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁██",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁██",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁██",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+        ],
+    },
+    "moon": {
+        "interval": 80,
+        "frames": ["🌑 ", "🌒 ", "🌓 ", "🌔 ", "🌕 ", "🌖 ", "🌗 ", "🌘 "],
+    },
+    "runner": {"interval": 140, "frames": ["🚶 ", "🏃 "]},
+    "pong": {
+        "interval": 80,
+        "frames": [
+            "▐⠂       ▌",
+            "▐⠈       ▌",
+            "▐ ⠂      ▌",
+            "▐ ⠠      ▌",
+            "▐  ⡀     ▌",
+            "▐  ⠠     ▌",
+            "▐   ⠂    ▌",
+            "▐   ⠈    ▌",
+            "▐    ⠂   ▌",
+            "▐    ⠠   ▌",
+            "▐     ⡀  ▌",
+            "▐     ⠠  ▌",
+            "▐      ⠂ ▌",
+            "▐      ⠈ ▌",
+            "▐       ⠂▌",
+            "▐       ⠠▌",
+            "▐       ⡀▌",
+            "▐      ⠠ ▌",
+            "▐      ⠂ ▌",
+            "▐     ⠈  ▌",
+            "▐     ⠂  ▌",
+            "▐    ⠠   ▌",
+            "▐    ⡀   ▌",
+            "▐   ⠠    ▌",
+            "▐   ⠂    ▌",
+            "▐  ⠈     ▌",
+            "▐  ⠂     ▌",
+            "▐ ⠠      ▌",
+            "▐ ⡀      ▌",
+            "▐⠠       ▌",
+        ],
+    },
+    "shark": {
+        "interval": 120,
+        "frames": [
+            "▐|\\____________▌",
+            "▐_|\\___________▌",
+            "▐__|\\__________▌",
+            "▐___|\\_________▌",
+            "▐____|\\________▌",
+            "▐_____|\\_______▌",
+            "▐______|\\______▌",
+            "▐_______|\\_____▌",
+            "▐________|\\____▌",
+            "▐_________|\\___▌",
+            "▐__________|\\__▌",
+            "▐___________|\\_▌",
+            "▐____________|\\▌",
+            "▐____________/|▌",
+            "▐___________/|_▌",
+            "▐__________/|__▌",
+            "▐_________/|___▌",
+            "▐________/|____▌",
+            "▐_______/|_____▌",
+            "▐______/|______▌",
+            "▐_____/|_______▌",
+            "▐____/|________▌",
+            "▐___/|_________▌",
+            "▐__/|__________▌",
+            "▐_/|___________▌",
+            "▐/|____________▌",
+        ],
+    },
+    "dqpb": {"interval": 100, "frames": "dqpb"},
+    "weather": {
+        "interval": 100,
+        "frames": [
+            "☀️ ",
+            "☀️ ",
+            "☀️ ",
+            "🌤 ",
+            "⛅️ ",
+            "🌥 ",
+            "☁️ ",
+            "🌧 ",
+            "🌨 ",
+            "🌧 ",
+            "🌨 ",
+            "🌧 ",
+            "🌨 ",
+            "⛈ ",
+            "🌨 ",
+            "🌧 ",
+            "🌨 ",
+            "☁️ ",
+            "🌥 ",
+            "⛅️ ",
+            "🌤 ",
+            "☀️ ",
+            "☀️ ",
+        ],
+    },
+    "christmas": {"interval": 400, "frames": "🌲🎄"},
+    "grenade": {
+        "interval": 80,
+        "frames": [
+            "،   ",
+            "′   ",
+            " ´ ",
+            " ‾ ",
+            "  ⸌",
+            "  ⸊",
+            "  |",
+            "  ⁎",
+            "  ⁕",
+            " ෴ ",
+            "  ⁓",
+            "   ",
+            "   ",
+            "   ",
+        ],
+    },
+    "point": {"interval": 125, "frames": ["∙∙∙", "●∙∙", "∙●∙", "∙∙●", "∙∙∙"]},
+    "layer": {"interval": 150, "frames": "-=≡"},
+    "betaWave": {
+        "interval": 80,
+        "frames": [
+            "ρββββββ",
+            "βρβββββ",
+            "ββρββββ",
+            "βββρβββ",
+            "ββββρββ",
+            "βββββρβ",
+            "ββββββρ",
+        ],
+    },
+    "aesthetic": {
+        "interval": 80,
+        "frames": [
+            "▰▱▱▱▱▱▱",
+            "▰▰▱▱▱▱▱",
+            "▰▰▰▱▱▱▱",
+            "▰▰▰▰▱▱▱",
+            "▰▰▰▰▰▱▱",
+            "▰▰▰▰▰▰▱",
+            "▰▰▰▰▰▰▰",
+            "▰▱▱▱▱▱▱",
+        ],
+    },
+}
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_stack.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_stack.py
new file mode 100644
index 0000000..194564e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_stack.py
@@ -0,0 +1,16 @@
+from typing import List, TypeVar
+
+T = TypeVar("T")
+
+
+class Stack(List[T]):
+    """A small shim over builtin list."""
+
+    @property
+    def top(self) -> T:
+        """Get top of stack."""
+        return self[-1]
+
+    def push(self, item: T) -> None:
+        """Push an item on to the stack (append in stack nomenclature)."""
+        self.append(item)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_timer.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_timer.py
new file mode 100644
index 0000000..a2ca6be
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_timer.py
@@ -0,0 +1,19 @@
+"""
+Timer context manager, only used in debug.
+
+"""
+
+from time import time
+
+import contextlib
+from typing import Generator
+
+
+@contextlib.contextmanager
+def timer(subject: str = "time") -> Generator[None, None, None]:
+    """print the elapsed time. (only used in debugging)"""
+    start = time()
+    yield
+    elapsed = time() - start
+    elapsed_ms = elapsed * 1000
+    print(f"{subject} elapsed {elapsed_ms:.1f}ms")
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_win32_console.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_win32_console.py
new file mode 100644
index 0000000..2eba1b9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_win32_console.py
@@ -0,0 +1,661 @@
+"""Light wrapper around the Win32 Console API - this module should only be imported on Windows
+
+The API that this module wraps is documented at https://docs.microsoft.com/en-us/windows/console/console-functions
+"""
+
+import ctypes
+import sys
+from typing import Any
+
+windll: Any = None
+if sys.platform == "win32":
+    windll = ctypes.LibraryLoader(ctypes.WinDLL)
+else:
+    raise ImportError(f"{__name__} can only be imported on Windows")
+
+import time
+from ctypes import Structure, byref, wintypes
+from typing import IO, NamedTuple, Type, cast
+
+from pip._vendor.rich.color import ColorSystem
+from pip._vendor.rich.style import Style
+
+STDOUT = -11
+ENABLE_VIRTUAL_TERMINAL_PROCESSING = 4
+
+COORD = wintypes._COORD
+
+
+class LegacyWindowsError(Exception):
+    pass
+
+
+class WindowsCoordinates(NamedTuple):
+    """Coordinates in the Windows Console API are (y, x), not (x, y).
+    This class is intended to prevent that confusion.
+    Rows and columns are indexed from 0.
+    This class can be used in place of wintypes._COORD in arguments and argtypes.
+    """
+
+    row: int
+    col: int
+
+    @classmethod
+    def from_param(cls, value: "WindowsCoordinates") -> COORD:
+        """Converts a WindowsCoordinates into a wintypes _COORD structure.
+        This classmethod is internally called by ctypes to perform the conversion.
+
+        Args:
+            value (WindowsCoordinates): The input coordinates to convert.
+
+        Returns:
+            wintypes._COORD: The converted coordinates struct.
+        """
+        return COORD(value.col, value.row)
+
+
+class CONSOLE_SCREEN_BUFFER_INFO(Structure):
+    _fields_ = [
+        ("dwSize", COORD),
+        ("dwCursorPosition", COORD),
+        ("wAttributes", wintypes.WORD),
+        ("srWindow", wintypes.SMALL_RECT),
+        ("dwMaximumWindowSize", COORD),
+    ]
+
+
+class CONSOLE_CURSOR_INFO(ctypes.Structure):
+    _fields_ = [("dwSize", wintypes.DWORD), ("bVisible", wintypes.BOOL)]
+
+
+_GetStdHandle = windll.kernel32.GetStdHandle
+_GetStdHandle.argtypes = [
+    wintypes.DWORD,
+]
+_GetStdHandle.restype = wintypes.HANDLE
+
+
+def GetStdHandle(handle: int = STDOUT) -> wintypes.HANDLE:
+    """Retrieves a handle to the specified standard device (standard input, standard output, or standard error).
+
+    Args:
+        handle (int): Integer identifier for the handle. Defaults to -11 (stdout).
+
+    Returns:
+        wintypes.HANDLE: The handle
+    """
+    return cast(wintypes.HANDLE, _GetStdHandle(handle))
+
+
+_GetConsoleMode = windll.kernel32.GetConsoleMode
+_GetConsoleMode.argtypes = [wintypes.HANDLE, wintypes.LPDWORD]
+_GetConsoleMode.restype = wintypes.BOOL
+
+
+def GetConsoleMode(std_handle: wintypes.HANDLE) -> int:
+    """Retrieves the current input mode of a console's input buffer
+    or the current output mode of a console screen buffer.
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+
+    Raises:
+        LegacyWindowsError: If any error occurs while calling the Windows console API.
+
+    Returns:
+        int: Value representing the current console mode as documented at
+            https://docs.microsoft.com/en-us/windows/console/getconsolemode#parameters
+    """
+
+    console_mode = wintypes.DWORD()
+    success = bool(_GetConsoleMode(std_handle, console_mode))
+    if not success:
+        raise LegacyWindowsError("Unable to get legacy Windows Console Mode")
+    return console_mode.value
+
+
+_FillConsoleOutputCharacterW = windll.kernel32.FillConsoleOutputCharacterW
+_FillConsoleOutputCharacterW.argtypes = [
+    wintypes.HANDLE,
+    ctypes.c_char,
+    wintypes.DWORD,
+    cast(Type[COORD], WindowsCoordinates),
+    ctypes.POINTER(wintypes.DWORD),
+]
+_FillConsoleOutputCharacterW.restype = wintypes.BOOL
+
+
+def FillConsoleOutputCharacter(
+    std_handle: wintypes.HANDLE,
+    char: str,
+    length: int,
+    start: WindowsCoordinates,
+) -> int:
+    """Writes a character to the console screen buffer a specified number of times, beginning at the specified coordinates.
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+        char (str): The character to write. Must be a string of length 1.
+        length (int): The number of times to write the character.
+        start (WindowsCoordinates): The coordinates to start writing at.
+
+    Returns:
+        int: The number of characters written.
+    """
+    character = ctypes.c_char(char.encode())
+    num_characters = wintypes.DWORD(length)
+    num_written = wintypes.DWORD(0)
+    _FillConsoleOutputCharacterW(
+        std_handle,
+        character,
+        num_characters,
+        start,
+        byref(num_written),
+    )
+    return num_written.value
+
+
+_FillConsoleOutputAttribute = windll.kernel32.FillConsoleOutputAttribute
+_FillConsoleOutputAttribute.argtypes = [
+    wintypes.HANDLE,
+    wintypes.WORD,
+    wintypes.DWORD,
+    cast(Type[COORD], WindowsCoordinates),
+    ctypes.POINTER(wintypes.DWORD),
+]
+_FillConsoleOutputAttribute.restype = wintypes.BOOL
+
+
+def FillConsoleOutputAttribute(
+    std_handle: wintypes.HANDLE,
+    attributes: int,
+    length: int,
+    start: WindowsCoordinates,
+) -> int:
+    """Sets the character attributes for a specified number of character cells,
+    beginning at the specified coordinates in a screen buffer.
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+        attributes (int): Integer value representing the foreground and background colours of the cells.
+        length (int): The number of cells to set the output attribute of.
+        start (WindowsCoordinates): The coordinates of the first cell whose attributes are to be set.
+
+    Returns:
+        int: The number of cells whose attributes were actually set.
+    """
+    num_cells = wintypes.DWORD(length)
+    style_attrs = wintypes.WORD(attributes)
+    num_written = wintypes.DWORD(0)
+    _FillConsoleOutputAttribute(
+        std_handle, style_attrs, num_cells, start, byref(num_written)
+    )
+    return num_written.value
+
+
+_SetConsoleTextAttribute = windll.kernel32.SetConsoleTextAttribute
+_SetConsoleTextAttribute.argtypes = [
+    wintypes.HANDLE,
+    wintypes.WORD,
+]
+_SetConsoleTextAttribute.restype = wintypes.BOOL
+
+
+def SetConsoleTextAttribute(
+    std_handle: wintypes.HANDLE, attributes: wintypes.WORD
+) -> bool:
+    """Set the colour attributes for all text written after this function is called.
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+        attributes (int): Integer value representing the foreground and background colours.
+
+
+    Returns:
+        bool: True if the attribute was set successfully, otherwise False.
+    """
+    return bool(_SetConsoleTextAttribute(std_handle, attributes))
+
+
+_GetConsoleScreenBufferInfo = windll.kernel32.GetConsoleScreenBufferInfo
+_GetConsoleScreenBufferInfo.argtypes = [
+    wintypes.HANDLE,
+    ctypes.POINTER(CONSOLE_SCREEN_BUFFER_INFO),
+]
+_GetConsoleScreenBufferInfo.restype = wintypes.BOOL
+
+
+def GetConsoleScreenBufferInfo(
+    std_handle: wintypes.HANDLE,
+) -> CONSOLE_SCREEN_BUFFER_INFO:
+    """Retrieves information about the specified console screen buffer.
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+
+    Returns:
+        CONSOLE_SCREEN_BUFFER_INFO: A CONSOLE_SCREEN_BUFFER_INFO ctype struct contain information about
+            screen size, cursor position, colour attributes, and more."""
+    console_screen_buffer_info = CONSOLE_SCREEN_BUFFER_INFO()
+    _GetConsoleScreenBufferInfo(std_handle, byref(console_screen_buffer_info))
+    return console_screen_buffer_info
+
+
+_SetConsoleCursorPosition = windll.kernel32.SetConsoleCursorPosition
+_SetConsoleCursorPosition.argtypes = [
+    wintypes.HANDLE,
+    cast(Type[COORD], WindowsCoordinates),
+]
+_SetConsoleCursorPosition.restype = wintypes.BOOL
+
+
+def SetConsoleCursorPosition(
+    std_handle: wintypes.HANDLE, coords: WindowsCoordinates
+) -> bool:
+    """Set the position of the cursor in the console screen
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+        coords (WindowsCoordinates): The coordinates to move the cursor to.
+
+    Returns:
+        bool: True if the function succeeds, otherwise False.
+    """
+    return bool(_SetConsoleCursorPosition(std_handle, coords))
+
+
+_GetConsoleCursorInfo = windll.kernel32.GetConsoleCursorInfo
+_GetConsoleCursorInfo.argtypes = [
+    wintypes.HANDLE,
+    ctypes.POINTER(CONSOLE_CURSOR_INFO),
+]
+_GetConsoleCursorInfo.restype = wintypes.BOOL
+
+
+def GetConsoleCursorInfo(
+    std_handle: wintypes.HANDLE, cursor_info: CONSOLE_CURSOR_INFO
+) -> bool:
+    """Get the cursor info - used to get cursor visibility and width
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+        cursor_info (CONSOLE_CURSOR_INFO): CONSOLE_CURSOR_INFO ctype struct that receives information
+            about the console's cursor.
+
+    Returns:
+          bool: True if the function succeeds, otherwise False.
+    """
+    return bool(_GetConsoleCursorInfo(std_handle, byref(cursor_info)))
+
+
+_SetConsoleCursorInfo = windll.kernel32.SetConsoleCursorInfo
+_SetConsoleCursorInfo.argtypes = [
+    wintypes.HANDLE,
+    ctypes.POINTER(CONSOLE_CURSOR_INFO),
+]
+_SetConsoleCursorInfo.restype = wintypes.BOOL
+
+
+def SetConsoleCursorInfo(
+    std_handle: wintypes.HANDLE, cursor_info: CONSOLE_CURSOR_INFO
+) -> bool:
+    """Set the cursor info - used for adjusting cursor visibility and width
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+        cursor_info (CONSOLE_CURSOR_INFO): CONSOLE_CURSOR_INFO ctype struct containing the new cursor info.
+
+    Returns:
+          bool: True if the function succeeds, otherwise False.
+    """
+    return bool(_SetConsoleCursorInfo(std_handle, byref(cursor_info)))
+
+
+_SetConsoleTitle = windll.kernel32.SetConsoleTitleW
+_SetConsoleTitle.argtypes = [wintypes.LPCWSTR]
+_SetConsoleTitle.restype = wintypes.BOOL
+
+
+def SetConsoleTitle(title: str) -> bool:
+    """Sets the title of the current console window
+
+    Args:
+        title (str): The new title of the console window.
+
+    Returns:
+        bool: True if the function succeeds, otherwise False.
+    """
+    return bool(_SetConsoleTitle(title))
+
+
+class LegacyWindowsTerm:
+    """This class allows interaction with the legacy Windows Console API. It should only be used in the context
+    of environments where virtual terminal processing is not available. However, if it is used in a Windows environment,
+    the entire API should work.
+
+    Args:
+        file (IO[str]): The file which the Windows Console API HANDLE is retrieved from, defaults to sys.stdout.
+    """
+
+    BRIGHT_BIT = 8
+
+    # Indices are ANSI color numbers, values are the corresponding Windows Console API color numbers
+    ANSI_TO_WINDOWS = [
+        0,  # black                      The Windows colours are defined in wincon.h as follows:
+        4,  # red                         define FOREGROUND_BLUE            0x0001 -- 0000 0001
+        2,  # green                       define FOREGROUND_GREEN           0x0002 -- 0000 0010
+        6,  # yellow                      define FOREGROUND_RED             0x0004 -- 0000 0100
+        1,  # blue                        define FOREGROUND_INTENSITY       0x0008 -- 0000 1000
+        5,  # magenta                     define BACKGROUND_BLUE            0x0010 -- 0001 0000
+        3,  # cyan                        define BACKGROUND_GREEN           0x0020 -- 0010 0000
+        7,  # white                       define BACKGROUND_RED             0x0040 -- 0100 0000
+        8,  # bright black (grey)         define BACKGROUND_INTENSITY       0x0080 -- 1000 0000
+        12,  # bright red
+        10,  # bright green
+        14,  # bright yellow
+        9,  # bright blue
+        13,  # bright magenta
+        11,  # bright cyan
+        15,  # bright white
+    ]
+
+    def __init__(self, file: "IO[str]") -> None:
+        handle = GetStdHandle(STDOUT)
+        self._handle = handle
+        default_text = GetConsoleScreenBufferInfo(handle).wAttributes
+        self._default_text = default_text
+
+        self._default_fore = default_text & 7
+        self._default_back = (default_text >> 4) & 7
+        self._default_attrs = self._default_fore | (self._default_back << 4)
+
+        self._file = file
+        self.write = file.write
+        self.flush = file.flush
+
+    @property
+    def cursor_position(self) -> WindowsCoordinates:
+        """Returns the current position of the cursor (0-based)
+
+        Returns:
+            WindowsCoordinates: The current cursor position.
+        """
+        coord: COORD = GetConsoleScreenBufferInfo(self._handle).dwCursorPosition
+        return WindowsCoordinates(row=coord.Y, col=coord.X)
+
+    @property
+    def screen_size(self) -> WindowsCoordinates:
+        """Returns the current size of the console screen buffer, in character columns and rows
+
+        Returns:
+            WindowsCoordinates: The width and height of the screen as WindowsCoordinates.
+        """
+        screen_size: COORD = GetConsoleScreenBufferInfo(self._handle).dwSize
+        return WindowsCoordinates(row=screen_size.Y, col=screen_size.X)
+
+    def write_text(self, text: str) -> None:
+        """Write text directly to the terminal without any modification of styles
+
+        Args:
+            text (str): The text to write to the console
+        """
+        self.write(text)
+        self.flush()
+
+    def write_styled(self, text: str, style: Style) -> None:
+        """Write styled text to the terminal.
+
+        Args:
+            text (str): The text to write
+            style (Style): The style of the text
+        """
+        color = style.color
+        bgcolor = style.bgcolor
+        if style.reverse:
+            color, bgcolor = bgcolor, color
+
+        if color:
+            fore = color.downgrade(ColorSystem.WINDOWS).number
+            fore = fore if fore is not None else 7  # Default to ANSI 7: White
+            if style.bold:
+                fore = fore | self.BRIGHT_BIT
+            if style.dim:
+                fore = fore & ~self.BRIGHT_BIT
+            fore = self.ANSI_TO_WINDOWS[fore]
+        else:
+            fore = self._default_fore
+
+        if bgcolor:
+            back = bgcolor.downgrade(ColorSystem.WINDOWS).number
+            back = back if back is not None else 0  # Default to ANSI 0: Black
+            back = self.ANSI_TO_WINDOWS[back]
+        else:
+            back = self._default_back
+
+        assert fore is not None
+        assert back is not None
+
+        SetConsoleTextAttribute(
+            self._handle, attributes=ctypes.c_ushort(fore | (back << 4))
+        )
+        self.write_text(text)
+        SetConsoleTextAttribute(self._handle, attributes=self._default_text)
+
+    def move_cursor_to(self, new_position: WindowsCoordinates) -> None:
+        """Set the position of the cursor
+
+        Args:
+            new_position (WindowsCoordinates): The WindowsCoordinates representing the new position of the cursor.
+        """
+        if new_position.col < 0 or new_position.row < 0:
+            return
+        SetConsoleCursorPosition(self._handle, coords=new_position)
+
+    def erase_line(self) -> None:
+        """Erase all content on the line the cursor is currently located at"""
+        screen_size = self.screen_size
+        cursor_position = self.cursor_position
+        cells_to_erase = screen_size.col
+        start_coordinates = WindowsCoordinates(row=cursor_position.row, col=0)
+        FillConsoleOutputCharacter(
+            self._handle, " ", length=cells_to_erase, start=start_coordinates
+        )
+        FillConsoleOutputAttribute(
+            self._handle,
+            self._default_attrs,
+            length=cells_to_erase,
+            start=start_coordinates,
+        )
+
+    def erase_end_of_line(self) -> None:
+        """Erase all content from the cursor position to the end of that line"""
+        cursor_position = self.cursor_position
+        cells_to_erase = self.screen_size.col - cursor_position.col
+        FillConsoleOutputCharacter(
+            self._handle, " ", length=cells_to_erase, start=cursor_position
+        )
+        FillConsoleOutputAttribute(
+            self._handle,
+            self._default_attrs,
+            length=cells_to_erase,
+            start=cursor_position,
+        )
+
+    def erase_start_of_line(self) -> None:
+        """Erase all content from the cursor position to the start of that line"""
+        row, col = self.cursor_position
+        start = WindowsCoordinates(row, 0)
+        FillConsoleOutputCharacter(self._handle, " ", length=col, start=start)
+        FillConsoleOutputAttribute(
+            self._handle, self._default_attrs, length=col, start=start
+        )
+
+    def move_cursor_up(self) -> None:
+        """Move the cursor up a single cell"""
+        cursor_position = self.cursor_position
+        SetConsoleCursorPosition(
+            self._handle,
+            coords=WindowsCoordinates(
+                row=cursor_position.row - 1, col=cursor_position.col
+            ),
+        )
+
+    def move_cursor_down(self) -> None:
+        """Move the cursor down a single cell"""
+        cursor_position = self.cursor_position
+        SetConsoleCursorPosition(
+            self._handle,
+            coords=WindowsCoordinates(
+                row=cursor_position.row + 1,
+                col=cursor_position.col,
+            ),
+        )
+
+    def move_cursor_forward(self) -> None:
+        """Move the cursor forward a single cell. Wrap to the next line if required."""
+        row, col = self.cursor_position
+        if col == self.screen_size.col - 1:
+            row += 1
+            col = 0
+        else:
+            col += 1
+        SetConsoleCursorPosition(
+            self._handle, coords=WindowsCoordinates(row=row, col=col)
+        )
+
+    def move_cursor_to_column(self, column: int) -> None:
+        """Move cursor to the column specified by the zero-based column index, staying on the same row
+
+        Args:
+            column (int): The zero-based column index to move the cursor to.
+        """
+        row, _ = self.cursor_position
+        SetConsoleCursorPosition(self._handle, coords=WindowsCoordinates(row, column))
+
+    def move_cursor_backward(self) -> None:
+        """Move the cursor backward a single cell. Wrap to the previous line if required."""
+        row, col = self.cursor_position
+        if col == 0:
+            row -= 1
+            col = self.screen_size.col - 1
+        else:
+            col -= 1
+        SetConsoleCursorPosition(
+            self._handle, coords=WindowsCoordinates(row=row, col=col)
+        )
+
+    def hide_cursor(self) -> None:
+        """Hide the cursor"""
+        current_cursor_size = self._get_cursor_size()
+        invisible_cursor = CONSOLE_CURSOR_INFO(dwSize=current_cursor_size, bVisible=0)
+        SetConsoleCursorInfo(self._handle, cursor_info=invisible_cursor)
+
+    def show_cursor(self) -> None:
+        """Show the cursor"""
+        current_cursor_size = self._get_cursor_size()
+        visible_cursor = CONSOLE_CURSOR_INFO(dwSize=current_cursor_size, bVisible=1)
+        SetConsoleCursorInfo(self._handle, cursor_info=visible_cursor)
+
+    def set_title(self, title: str) -> None:
+        """Set the title of the terminal window
+
+        Args:
+            title (str): The new title of the console window
+        """
+        assert len(title) < 255, "Console title must be less than 255 characters"
+        SetConsoleTitle(title)
+
+    def _get_cursor_size(self) -> int:
+        """Get the percentage of the character cell that is filled by the cursor"""
+        cursor_info = CONSOLE_CURSOR_INFO()
+        GetConsoleCursorInfo(self._handle, cursor_info=cursor_info)
+        return int(cursor_info.dwSize)
+
+
+if __name__ == "__main__":
+    handle = GetStdHandle()
+
+    from pip._vendor.rich.console import Console
+
+    console = Console()
+
+    term = LegacyWindowsTerm(sys.stdout)
+    term.set_title("Win32 Console Examples")
+
+    style = Style(color="black", bgcolor="red")
+
+    heading = Style.parse("black on green")
+
+    # Check colour output
+    console.rule("Checking colour output")
+    console.print("[on red]on red!")
+    console.print("[blue]blue!")
+    console.print("[yellow]yellow!")
+    console.print("[bold yellow]bold yellow!")
+    console.print("[bright_yellow]bright_yellow!")
+    console.print("[dim bright_yellow]dim bright_yellow!")
+    console.print("[italic cyan]italic cyan!")
+    console.print("[bold white on blue]bold white on blue!")
+    console.print("[reverse bold white on blue]reverse bold white on blue!")
+    console.print("[bold black on cyan]bold black on cyan!")
+    console.print("[black on green]black on green!")
+    console.print("[blue on green]blue on green!")
+    console.print("[white on black]white on black!")
+    console.print("[black on white]black on white!")
+    console.print("[#1BB152 on #DA812D]#1BB152 on #DA812D!")
+
+    # Check cursor movement
+    console.rule("Checking cursor movement")
+    console.print()
+    term.move_cursor_backward()
+    term.move_cursor_backward()
+    term.write_text("went back and wrapped to prev line")
+    time.sleep(1)
+    term.move_cursor_up()
+    term.write_text("we go up")
+    time.sleep(1)
+    term.move_cursor_down()
+    term.write_text("and down")
+    time.sleep(1)
+    term.move_cursor_up()
+    term.move_cursor_backward()
+    term.move_cursor_backward()
+    term.write_text("we went up and back 2")
+    time.sleep(1)
+    term.move_cursor_down()
+    term.move_cursor_backward()
+    term.move_cursor_backward()
+    term.write_text("we went down and back 2")
+    time.sleep(1)
+
+    # Check erasing of lines
+    term.hide_cursor()
+    console.print()
+    console.rule("Checking line erasing")
+    console.print("\n...Deleting to the start of the line...")
+    term.write_text("The red arrow shows the cursor location, and direction of erase")
+    time.sleep(1)
+    term.move_cursor_to_column(16)
+    term.write_styled("<", Style.parse("black on red"))
+    term.move_cursor_backward()
+    time.sleep(1)
+    term.erase_start_of_line()
+    time.sleep(1)
+
+    console.print("\n\n...And to the end of the line...")
+    term.write_text("The red arrow shows the cursor location, and direction of erase")
+    time.sleep(1)
+
+    term.move_cursor_to_column(16)
+    term.write_styled(">", Style.parse("black on red"))
+    time.sleep(1)
+    term.erase_end_of_line()
+    time.sleep(1)
+
+    console.print("\n\n...Now the whole line will be erased...")
+    term.write_styled("I'm going to disappear!", style=Style.parse("black on cyan"))
+    time.sleep(1)
+    term.erase_line()
+
+    term.show_cursor()
+    print("\n")
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_windows.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_windows.py
new file mode 100644
index 0000000..7520a9f
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_windows.py
@@ -0,0 +1,71 @@
+import sys
+from dataclasses import dataclass
+
+
+@dataclass
+class WindowsConsoleFeatures:
+    """Windows features available."""
+
+    vt: bool = False
+    """The console supports VT codes."""
+    truecolor: bool = False
+    """The console supports truecolor."""
+
+
+try:
+    import ctypes
+    from ctypes import LibraryLoader
+
+    if sys.platform == "win32":
+        windll = LibraryLoader(ctypes.WinDLL)
+    else:
+        windll = None
+        raise ImportError("Not windows")
+
+    from pip._vendor.rich._win32_console import (
+        ENABLE_VIRTUAL_TERMINAL_PROCESSING,
+        GetConsoleMode,
+        GetStdHandle,
+        LegacyWindowsError,
+    )
+
+except (AttributeError, ImportError, ValueError):
+    # Fallback if we can't load the Windows DLL
+    def get_windows_console_features() -> WindowsConsoleFeatures:
+        features = WindowsConsoleFeatures()
+        return features
+
+else:
+
+    def get_windows_console_features() -> WindowsConsoleFeatures:
+        """Get windows console features.
+
+        Returns:
+            WindowsConsoleFeatures: An instance of WindowsConsoleFeatures.
+        """
+        handle = GetStdHandle()
+        try:
+            console_mode = GetConsoleMode(handle)
+            success = True
+        except LegacyWindowsError:
+            console_mode = 0
+            success = False
+        vt = bool(success and console_mode & ENABLE_VIRTUAL_TERMINAL_PROCESSING)
+        truecolor = False
+        if vt:
+            win_version = sys.getwindowsversion()
+            truecolor = win_version.major > 10 or (
+                win_version.major == 10 and win_version.build >= 15063
+            )
+        features = WindowsConsoleFeatures(vt=vt, truecolor=truecolor)
+        return features
+
+
+if __name__ == "__main__":
+    import platform
+
+    features = get_windows_console_features()
+    from pip._vendor.rich import print
+
+    print(f'platform="{platform.system()}"')
+    print(repr(features))
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_windows_renderer.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_windows_renderer.py
new file mode 100644
index 0000000..5ece056
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_windows_renderer.py
@@ -0,0 +1,56 @@
+from typing import Iterable, Sequence, Tuple, cast
+
+from pip._vendor.rich._win32_console import LegacyWindowsTerm, WindowsCoordinates
+from pip._vendor.rich.segment import ControlCode, ControlType, Segment
+
+
+def legacy_windows_render(buffer: Iterable[Segment], term: LegacyWindowsTerm) -> None:
+    """Makes appropriate Windows Console API calls based on the segments in the buffer.
+
+    Args:
+        buffer (Iterable[Segment]): Iterable of Segments to convert to Win32 API calls.
+        term (LegacyWindowsTerm): Used to call the Windows Console API.
+    """
+    for text, style, control in buffer:
+        if not control:
+            if style:
+                term.write_styled(text, style)
+            else:
+                term.write_text(text)
+        else:
+            control_codes: Sequence[ControlCode] = control
+            for control_code in control_codes:
+                control_type = control_code[0]
+                if control_type == ControlType.CURSOR_MOVE_TO:
+                    _, x, y = cast(Tuple[ControlType, int, int], control_code)
+                    term.move_cursor_to(WindowsCoordinates(row=y - 1, col=x - 1))
+                elif control_type == ControlType.CARRIAGE_RETURN:
+                    term.write_text("\r")
+                elif control_type == ControlType.HOME:
+                    term.move_cursor_to(WindowsCoordinates(0, 0))
+                elif control_type == ControlType.CURSOR_UP:
+                    term.move_cursor_up()
+                elif control_type == ControlType.CURSOR_DOWN:
+                    term.move_cursor_down()
+                elif control_type == ControlType.CURSOR_FORWARD:
+                    term.move_cursor_forward()
+                elif control_type == ControlType.CURSOR_BACKWARD:
+                    term.move_cursor_backward()
+                elif control_type == ControlType.CURSOR_MOVE_TO_COLUMN:
+                    _, column = cast(Tuple[ControlType, int], control_code)
+                    term.move_cursor_to_column(column - 1)
+                elif control_type == ControlType.HIDE_CURSOR:
+                    term.hide_cursor()
+                elif control_type == ControlType.SHOW_CURSOR:
+                    term.show_cursor()
+                elif control_type == ControlType.ERASE_IN_LINE:
+                    _, mode = cast(Tuple[ControlType, int], control_code)
+                    if mode == 0:
+                        term.erase_end_of_line()
+                    elif mode == 1:
+                        term.erase_start_of_line()
+                    elif mode == 2:
+                        term.erase_line()
+                elif control_type == ControlType.SET_WINDOW_TITLE:
+                    _, title = cast(Tuple[ControlType, str], control_code)
+                    term.set_title(title)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/_wrap.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/_wrap.py
new file mode 100644
index 0000000..2e94ff6
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/_wrap.py
@@ -0,0 +1,93 @@
+from __future__ import annotations
+
+import re
+from typing import Iterable
+
+from ._loop import loop_last
+from .cells import cell_len, chop_cells
+
+re_word = re.compile(r"\s*\S+\s*")
+
+
+def words(text: str) -> Iterable[tuple[int, int, str]]:
+    """Yields each word from the text as a tuple
+    containing (start_index, end_index, word). A "word" in this context may
+    include the actual word and any whitespace to the right.
+    """
+    position = 0
+    word_match = re_word.match(text, position)
+    while word_match is not None:
+        start, end = word_match.span()
+        word = word_match.group(0)
+        yield start, end, word
+        word_match = re_word.match(text, end)
+
+
+def divide_line(text: str, width: int, fold: bool = True) -> list[int]:
+    """Given a string of text, and a width (measured in cells), return a list
+    of cell offsets which the string should be split at in order for it to fit
+    within the given width.
+
+    Args:
+        text: The text to examine.
+        width: The available cell width.
+        fold: If True, words longer than `width` will be folded onto a new line.
+
+    Returns:
+        A list of indices to break the line at.
+    """
+    break_positions: list[int] = []  # offsets to insert the breaks at
+    append = break_positions.append
+    cell_offset = 0
+    _cell_len = cell_len
+
+    for start, _end, word in words(text):
+        word_length = _cell_len(word.rstrip())
+        remaining_space = width - cell_offset
+        word_fits_remaining_space = remaining_space >= word_length
+
+        if word_fits_remaining_space:
+            # Simplest case - the word fits within the remaining width for this line.
+            cell_offset += _cell_len(word)
+        else:
+            # Not enough space remaining for this word on the current line.
+            if word_length > width:
+                # The word doesn't fit on any line, so we can't simply
+                # place it on the next line...
+                if fold:
+                    # Fold the word across multiple lines.
+                    folded_word = chop_cells(word, width=width)
+                    for last, line in loop_last(folded_word):
+                        if start:
+                            append(start)
+                        if last:
+                            cell_offset = _cell_len(line)
+                        else:
+                            start += len(line)
+                else:
+                    # Folding isn't allowed, so crop the word.
+                    if start:
+                        append(start)
+                    cell_offset = _cell_len(word)
+            elif cell_offset and start:
+                # The word doesn't fit within the remaining space on the current
+                # line, but it *can* fit on to the next (empty) line.
+                append(start)
+                cell_offset = _cell_len(word)
+
+    return break_positions
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from .console import Console
+
+    console = Console(width=10)
+    console.print("12345 abcdefghijklmnopqrstuvwyxzABCDEFGHIJKLMNOPQRSTUVWXYZ 12345")
+    print(chop_cells("abcdefghijklmnopqrstuvwxyz", 10))
+
+    console = Console(width=20)
+    console.rule()
+    console.print("TextualはPythonの高速アプリケーション開発フレームワークです")
+
+    console.rule()
+    console.print("アプリケーションは1670万色を使用でき")
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/abc.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/abc.py
new file mode 100644
index 0000000..e6e498e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/abc.py
@@ -0,0 +1,33 @@
+from abc import ABC
+
+
+class RichRenderable(ABC):
+    """An abstract base class for Rich renderables.
+
+    Note that there is no need to extend this class, the intended use is to check if an
+    object supports the Rich renderable protocol. For example::
+
+        if isinstance(my_object, RichRenderable):
+            console.print(my_object)
+
+    """
+
+    @classmethod
+    def __subclasshook__(cls, other: type) -> bool:
+        """Check if this class supports the rich render protocol."""
+        return hasattr(other, "__rich_console__") or hasattr(other, "__rich__")
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.text import Text
+
+    t = Text()
+    print(isinstance(Text, RichRenderable))
+    print(isinstance(t, RichRenderable))
+
+    class Foo:
+        pass
+
+    f = Foo()
+    print(isinstance(f, RichRenderable))
+    print(isinstance("", RichRenderable))
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/align.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/align.py
new file mode 100644
index 0000000..330dcc5
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/align.py
@@ -0,0 +1,312 @@
+import sys
+from itertools import chain
+from typing import TYPE_CHECKING, Iterable, Optional
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from pip._vendor.typing_extensions import Literal  # pragma: no cover
+
+from .constrain import Constrain
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment
+from .style import StyleType
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderableType, RenderResult
+
+AlignMethod = Literal["left", "center", "right"]
+VerticalAlignMethod = Literal["top", "middle", "bottom"]
+
+
+class Align(JupyterMixin):
+    """Align a renderable by adding spaces if necessary.
+
+    Args:
+        renderable (RenderableType): A console renderable.
+        align (AlignMethod): One of "left", "center", or "right""
+        style (StyleType, optional): An optional style to apply to the background.
+        vertical (Optional[VerticalAlignMethod], optional): Optional vertical align, one of "top", "middle", or "bottom". Defaults to None.
+        pad (bool, optional): Pad the right with spaces. Defaults to True.
+        width (int, optional): Restrict contents to given width, or None to use default width. Defaults to None.
+        height (int, optional): Set height of align renderable, or None to fit to contents. Defaults to None.
+
+    Raises:
+        ValueError: if ``align`` is not one of the expected values.
+    """
+
+    def __init__(
+        self,
+        renderable: "RenderableType",
+        align: AlignMethod = "left",
+        style: Optional[StyleType] = None,
+        *,
+        vertical: Optional[VerticalAlignMethod] = None,
+        pad: bool = True,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+    ) -> None:
+        if align not in ("left", "center", "right"):
+            raise ValueError(
+                f'invalid value for align, expected "left", "center", or "right" (not {align!r})'
+            )
+        if vertical is not None and vertical not in ("top", "middle", "bottom"):
+            raise ValueError(
+                f'invalid value for vertical, expected "top", "middle", or "bottom" (not {vertical!r})'
+            )
+        self.renderable = renderable
+        self.align = align
+        self.style = style
+        self.vertical = vertical
+        self.pad = pad
+        self.width = width
+        self.height = height
+
+    def __repr__(self) -> str:
+        return f"Align({self.renderable!r}, {self.align!r})"
+
+    @classmethod
+    def left(
+        cls,
+        renderable: "RenderableType",
+        style: Optional[StyleType] = None,
+        *,
+        vertical: Optional[VerticalAlignMethod] = None,
+        pad: bool = True,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+    ) -> "Align":
+        """Align a renderable to the left."""
+        return cls(
+            renderable,
+            "left",
+            style=style,
+            vertical=vertical,
+            pad=pad,
+            width=width,
+            height=height,
+        )
+
+    @classmethod
+    def center(
+        cls,
+        renderable: "RenderableType",
+        style: Optional[StyleType] = None,
+        *,
+        vertical: Optional[VerticalAlignMethod] = None,
+        pad: bool = True,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+    ) -> "Align":
+        """Align a renderable to the center."""
+        return cls(
+            renderable,
+            "center",
+            style=style,
+            vertical=vertical,
+            pad=pad,
+            width=width,
+            height=height,
+        )
+
+    @classmethod
+    def right(
+        cls,
+        renderable: "RenderableType",
+        style: Optional[StyleType] = None,
+        *,
+        vertical: Optional[VerticalAlignMethod] = None,
+        pad: bool = True,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+    ) -> "Align":
+        """Align a renderable to the right."""
+        return cls(
+            renderable,
+            "right",
+            style=style,
+            vertical=vertical,
+            pad=pad,
+            width=width,
+            height=height,
+        )
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        align = self.align
+        width = console.measure(self.renderable, options=options).maximum
+        rendered = console.render(
+            Constrain(
+                self.renderable, width if self.width is None else min(width, self.width)
+            ),
+            options.update(height=None),
+        )
+        lines = list(Segment.split_lines(rendered))
+        width, height = Segment.get_shape(lines)
+        lines = Segment.set_shape(lines, width, height)
+        new_line = Segment.line()
+        excess_space = options.max_width - width
+        style = console.get_style(self.style) if self.style is not None else None
+
+        def generate_segments() -> Iterable[Segment]:
+            if excess_space <= 0:
+                # Exact fit
+                for line in lines:
+                    yield from line
+                    yield new_line
+
+            elif align == "left":
+                # Pad on the right
+                pad = Segment(" " * excess_space, style) if self.pad else None
+                for line in lines:
+                    yield from line
+                    if pad:
+                        yield pad
+                    yield new_line
+
+            elif align == "center":
+                # Pad left and right
+                left = excess_space // 2
+                pad = Segment(" " * left, style)
+                pad_right = (
+                    Segment(" " * (excess_space - left), style) if self.pad else None
+                )
+                for line in lines:
+                    if left:
+                        yield pad
+                    yield from line
+                    if pad_right:
+                        yield pad_right
+                    yield new_line
+
+            elif align == "right":
+                # Padding on left
+                pad = Segment(" " * excess_space, style)
+                for line in lines:
+                    yield pad
+                    yield from line
+                    yield new_line
+
+        blank_line = (
+            Segment(f"{' ' * (self.width or options.max_width)}\n", style)
+            if self.pad
+            else Segment("\n")
+        )
+
+        def blank_lines(count: int) -> Iterable[Segment]:
+            if count > 0:
+                for _ in range(count):
+                    yield blank_line
+
+        vertical_height = self.height or options.height
+        iter_segments: Iterable[Segment]
+        if self.vertical and vertical_height is not None:
+            if self.vertical == "top":
+                bottom_space = vertical_height - height
+                iter_segments = chain(generate_segments(), blank_lines(bottom_space))
+            elif self.vertical == "middle":
+                top_space = (vertical_height - height) // 2
+                bottom_space = vertical_height - top_space - height
+                iter_segments = chain(
+                    blank_lines(top_space),
+                    generate_segments(),
+                    blank_lines(bottom_space),
+                )
+            else:  #  self.vertical == "bottom":
+                top_space = vertical_height - height
+                iter_segments = chain(blank_lines(top_space), generate_segments())
+        else:
+            iter_segments = generate_segments()
+        if self.style:
+            style = console.get_style(self.style)
+            iter_segments = Segment.apply_style(iter_segments, style)
+        yield from iter_segments
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Measurement:
+        measurement = Measurement.get(console, options, self.renderable)
+        return measurement
+
+
+class VerticalCenter(JupyterMixin):
+    """Vertically aligns a renderable.
+
+    Warn:
+        This class is deprecated and may be removed in a future version. Use Align class with
+        `vertical="middle"`.
+
+    Args:
+        renderable (RenderableType): A renderable object.
+        style (StyleType, optional): An optional style to apply to the background. Defaults to None.
+    """
+
+    def __init__(
+        self,
+        renderable: "RenderableType",
+        style: Optional[StyleType] = None,
+    ) -> None:
+        self.renderable = renderable
+        self.style = style
+
+    def __repr__(self) -> str:
+        return f"VerticalCenter({self.renderable!r})"
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        style = console.get_style(self.style) if self.style is not None else None
+        lines = console.render_lines(
+            self.renderable, options.update(height=None), pad=False
+        )
+        width, _height = Segment.get_shape(lines)
+        new_line = Segment.line()
+        height = options.height or options.size.height
+        top_space = (height - len(lines)) // 2
+        bottom_space = height - top_space - len(lines)
+        blank_line = Segment(f"{' ' * width}", style)
+
+        def blank_lines(count: int) -> Iterable[Segment]:
+            for _ in range(count):
+                yield blank_line
+                yield new_line
+
+        if top_space > 0:
+            yield from blank_lines(top_space)
+        for line in lines:
+            yield from line
+            yield new_line
+        if bottom_space > 0:
+            yield from blank_lines(bottom_space)
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Measurement:
+        measurement = Measurement.get(console, options, self.renderable)
+        return measurement
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Console, Group
+    from pip._vendor.rich.highlighter import ReprHighlighter
+    from pip._vendor.rich.panel import Panel
+
+    highlighter = ReprHighlighter()
+    console = Console()
+
+    panel = Panel(
+        Group(
+            Align.left(highlighter("align='left'")),
+            Align.center(highlighter("align='center'")),
+            Align.right(highlighter("align='right'")),
+        ),
+        width=60,
+        style="on dark_blue",
+        title="Align",
+    )
+
+    console.print(
+        Align.center(panel, vertical="middle", style="on red", height=console.height)
+    )
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/ansi.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/ansi.py
new file mode 100644
index 0000000..7de86ce
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/ansi.py
@@ -0,0 +1,241 @@
+import re
+import sys
+from contextlib import suppress
+from typing import Iterable, NamedTuple, Optional
+
+from .color import Color
+from .style import Style
+from .text import Text
+
+re_ansi = re.compile(
+    r"""
+(?:\x1b[0-?])|
+(?:\x1b\](.*?)\x1b\\)|
+(?:\x1b([(@-Z\\-_]|\[[0-?]*[ -/]*[@-~]))
+""",
+    re.VERBOSE,
+)
+
+
+class _AnsiToken(NamedTuple):
+    """Result of ansi tokenized string."""
+
+    plain: str = ""
+    sgr: Optional[str] = ""
+    osc: Optional[str] = ""
+
+
+def _ansi_tokenize(ansi_text: str) -> Iterable[_AnsiToken]:
+    """Tokenize a string in to plain text and ANSI codes.
+
+    Args:
+        ansi_text (str): A String containing ANSI codes.
+
+    Yields:
+        AnsiToken: A named tuple of (plain, sgr, osc)
+    """
+
+    position = 0
+    sgr: Optional[str]
+    osc: Optional[str]
+    for match in re_ansi.finditer(ansi_text):
+        start, end = match.span(0)
+        osc, sgr = match.groups()
+        if start > position:
+            yield _AnsiToken(ansi_text[position:start])
+        if sgr:
+            if sgr == "(":
+                position = end + 1
+                continue
+            if sgr.endswith("m"):
+                yield _AnsiToken("", sgr[1:-1], osc)
+        else:
+            yield _AnsiToken("", sgr, osc)
+        position = end
+    if position < len(ansi_text):
+        yield _AnsiToken(ansi_text[position:])
+
+
+SGR_STYLE_MAP = {
+    1: "bold",
+    2: "dim",
+    3: "italic",
+    4: "underline",
+    5: "blink",
+    6: "blink2",
+    7: "reverse",
+    8: "conceal",
+    9: "strike",
+    21: "underline2",
+    22: "not dim not bold",
+    23: "not italic",
+    24: "not underline",
+    25: "not blink",
+    26: "not blink2",
+    27: "not reverse",
+    28: "not conceal",
+    29: "not strike",
+    30: "color(0)",
+    31: "color(1)",
+    32: "color(2)",
+    33: "color(3)",
+    34: "color(4)",
+    35: "color(5)",
+    36: "color(6)",
+    37: "color(7)",
+    39: "default",
+    40: "on color(0)",
+    41: "on color(1)",
+    42: "on color(2)",
+    43: "on color(3)",
+    44: "on color(4)",
+    45: "on color(5)",
+    46: "on color(6)",
+    47: "on color(7)",
+    49: "on default",
+    51: "frame",
+    52: "encircle",
+    53: "overline",
+    54: "not frame not encircle",
+    55: "not overline",
+    90: "color(8)",
+    91: "color(9)",
+    92: "color(10)",
+    93: "color(11)",
+    94: "color(12)",
+    95: "color(13)",
+    96: "color(14)",
+    97: "color(15)",
+    100: "on color(8)",
+    101: "on color(9)",
+    102: "on color(10)",
+    103: "on color(11)",
+    104: "on color(12)",
+    105: "on color(13)",
+    106: "on color(14)",
+    107: "on color(15)",
+}
+
+
+class AnsiDecoder:
+    """Translate ANSI code in to styled Text."""
+
+    def __init__(self) -> None:
+        self.style = Style.null()
+
+    def decode(self, terminal_text: str) -> Iterable[Text]:
+        """Decode ANSI codes in an iterable of lines.
+
+        Args:
+            lines (Iterable[str]): An iterable of lines of terminal output.
+
+        Yields:
+            Text: Marked up Text.
+        """
+        for line in terminal_text.splitlines():
+            yield self.decode_line(line)
+
+    def decode_line(self, line: str) -> Text:
+        """Decode a line containing ansi codes.
+
+        Args:
+            line (str): A line of terminal output.
+
+        Returns:
+            Text: A Text instance marked up according to ansi codes.
+        """
+        from_ansi = Color.from_ansi
+        from_rgb = Color.from_rgb
+        _Style = Style
+        text = Text()
+        append = text.append
+        line = line.rsplit("\r", 1)[-1]
+        for plain_text, sgr, osc in _ansi_tokenize(line):
+            if plain_text:
+                append(plain_text, self.style or None)
+            elif osc is not None:
+                if osc.startswith("8;"):
+                    _params, semicolon, link = osc[2:].partition(";")
+                    if semicolon:
+                        self.style = self.style.update_link(link or None)
+            elif sgr is not None:
+                # Translate in to semi-colon separated codes
+                # Ignore invalid codes, because we want to be lenient
+                codes = [
+                    min(255, int(_code) if _code else 0)
+                    for _code in sgr.split(";")
+                    if _code.isdigit() or _code == ""
+                ]
+                iter_codes = iter(codes)
+                for code in iter_codes:
+                    if code == 0:
+                        # reset
+                        self.style = _Style.null()
+                    elif code in SGR_STYLE_MAP:
+                        # styles
+                        self.style += _Style.parse(SGR_STYLE_MAP[code])
+                    elif code == 38:
+                        #  Foreground
+                        with suppress(StopIteration):
+                            color_type = next(iter_codes)
+                            if color_type == 5:
+                                self.style += _Style.from_color(
+                                    from_ansi(next(iter_codes))
+                                )
+                            elif color_type == 2:
+                                self.style += _Style.from_color(
+                                    from_rgb(
+                                        next(iter_codes),
+                                        next(iter_codes),
+                                        next(iter_codes),
+                                    )
+                                )
+                    elif code == 48:
+                        # Background
+                        with suppress(StopIteration):
+                            color_type = next(iter_codes)
+                            if color_type == 5:
+                                self.style += _Style.from_color(
+                                    None, from_ansi(next(iter_codes))
+                                )
+                            elif color_type == 2:
+                                self.style += _Style.from_color(
+                                    None,
+                                    from_rgb(
+                                        next(iter_codes),
+                                        next(iter_codes),
+                                        next(iter_codes),
+                                    ),
+                                )
+
+        return text
+
+
+if sys.platform != "win32" and __name__ == "__main__":  # pragma: no cover
+    import io
+    import os
+    import pty
+    import sys
+
+    decoder = AnsiDecoder()
+
+    stdout = io.BytesIO()
+
+    def read(fd: int) -> bytes:
+        data = os.read(fd, 1024)
+        stdout.write(data)
+        return data
+
+    pty.spawn(sys.argv[1:], read)
+
+    from .console import Console
+
+    console = Console(record=True)
+
+    stdout_result = stdout.getvalue().decode("utf-8")
+    print(stdout_result)
+
+    for line in decoder.decode(stdout_result):
+        console.print(line)
+
+    console.save_html("stdout.html")
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/bar.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/bar.py
new file mode 100644
index 0000000..022284b
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/bar.py
@@ -0,0 +1,93 @@
+from typing import Optional, Union
+
+from .color import Color
+from .console import Console, ConsoleOptions, RenderResult
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment
+from .style import Style
+
+# There are left-aligned characters for 1/8 to 7/8, but
+# the right-aligned characters exist only for 1/8 and 4/8.
+BEGIN_BLOCK_ELEMENTS = ["█", "█", "█", "▐", "▐", "▐", "▕", "▕"]
+END_BLOCK_ELEMENTS = [" ", "▏", "▎", "▍", "▌", "▋", "▊", "▉"]
+FULL_BLOCK = "█"
+
+
+class Bar(JupyterMixin):
+    """Renders a solid block bar.
+
+    Args:
+        size (float): Value for the end of the bar.
+        begin (float): Begin point (between 0 and size, inclusive).
+        end (float): End point (between 0 and size, inclusive).
+        width (int, optional): Width of the bar, or ``None`` for maximum width. Defaults to None.
+        color (Union[Color, str], optional): Color of the bar. Defaults to "default".
+        bgcolor (Union[Color, str], optional): Color of bar background. Defaults to "default".
+    """
+
+    def __init__(
+        self,
+        size: float,
+        begin: float,
+        end: float,
+        *,
+        width: Optional[int] = None,
+        color: Union[Color, str] = "default",
+        bgcolor: Union[Color, str] = "default",
+    ):
+        self.size = size
+        self.begin = max(begin, 0)
+        self.end = min(end, size)
+        self.width = width
+        self.style = Style(color=color, bgcolor=bgcolor)
+
+    def __repr__(self) -> str:
+        return f"Bar({self.size}, {self.begin}, {self.end})"
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        width = min(
+            self.width if self.width is not None else options.max_width,
+            options.max_width,
+        )
+
+        if self.begin >= self.end:
+            yield Segment(" " * width, self.style)
+            yield Segment.line()
+            return
+
+        prefix_complete_eights = int(width * 8 * self.begin / self.size)
+        prefix_bar_count = prefix_complete_eights // 8
+        prefix_eights_count = prefix_complete_eights % 8
+
+        body_complete_eights = int(width * 8 * self.end / self.size)
+        body_bar_count = body_complete_eights // 8
+        body_eights_count = body_complete_eights % 8
+
+        # When start and end fall into the same cell, we ideally should render
+        # a symbol that's "center-aligned", but there is no good symbol in Unicode.
+        # In this case, we fall back to right-aligned block symbol for simplicity.
+
+        prefix = " " * prefix_bar_count
+        if prefix_eights_count:
+            prefix += BEGIN_BLOCK_ELEMENTS[prefix_eights_count]
+
+        body = FULL_BLOCK * body_bar_count
+        if body_eights_count:
+            body += END_BLOCK_ELEMENTS[body_eights_count]
+
+        suffix = " " * (width - len(body))
+
+        yield Segment(prefix + body[len(prefix) :] + suffix, self.style)
+        yield Segment.line()
+
+    def __rich_measure__(
+        self, console: Console, options: ConsoleOptions
+    ) -> Measurement:
+        return (
+            Measurement(self.width, self.width)
+            if self.width is not None
+            else Measurement(4, options.max_width)
+        )
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/box.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/box.py
new file mode 100644
index 0000000..0511a9e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/box.py
@@ -0,0 +1,480 @@
+import sys
+from typing import TYPE_CHECKING, Iterable, List
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from pip._vendor.typing_extensions import Literal  # pragma: no cover
+
+
+from ._loop import loop_last
+
+if TYPE_CHECKING:
+    from pip._vendor.rich.console import ConsoleOptions
+
+
+class Box:
+    """Defines characters to render boxes.
+
+    ┌─┬┐ top
+    │ ││ head
+    ├─┼┤ head_row
+    │ ││ mid
+    ├─┼┤ row
+    ├─┼┤ foot_row
+    │ ││ foot
+    └─┴┘ bottom
+
+    Args:
+        box (str): Characters making up box.
+        ascii (bool, optional): True if this box uses ascii characters only. Default is False.
+    """
+
+    def __init__(self, box: str, *, ascii: bool = False) -> None:
+        self._box = box
+        self.ascii = ascii
+        line1, line2, line3, line4, line5, line6, line7, line8 = box.splitlines()
+        # top
+        self.top_left, self.top, self.top_divider, self.top_right = iter(line1)
+        # head
+        self.head_left, _, self.head_vertical, self.head_right = iter(line2)
+        # head_row
+        (
+            self.head_row_left,
+            self.head_row_horizontal,
+            self.head_row_cross,
+            self.head_row_right,
+        ) = iter(line3)
+
+        # mid
+        self.mid_left, _, self.mid_vertical, self.mid_right = iter(line4)
+        # row
+        self.row_left, self.row_horizontal, self.row_cross, self.row_right = iter(line5)
+        # foot_row
+        (
+            self.foot_row_left,
+            self.foot_row_horizontal,
+            self.foot_row_cross,
+            self.foot_row_right,
+        ) = iter(line6)
+        # foot
+        self.foot_left, _, self.foot_vertical, self.foot_right = iter(line7)
+        # bottom
+        self.bottom_left, self.bottom, self.bottom_divider, self.bottom_right = iter(
+            line8
+        )
+
+    def __repr__(self) -> str:
+        return "Box(...)"
+
+    def __str__(self) -> str:
+        return self._box
+
+    def substitute(self, options: "ConsoleOptions", safe: bool = True) -> "Box":
+        """Substitute this box for another if it won't render due to platform issues.
+
+        Args:
+            options (ConsoleOptions): Console options used in rendering.
+            safe (bool, optional): Substitute this for another Box if there are known problems
+                displaying on the platform (currently only relevant on Windows). Default is True.
+
+        Returns:
+            Box: A different Box or the same Box.
+        """
+        box = self
+        if options.legacy_windows and safe:
+            box = LEGACY_WINDOWS_SUBSTITUTIONS.get(box, box)
+        if options.ascii_only and not box.ascii:
+            box = ASCII
+        return box
+
+    def get_plain_headed_box(self) -> "Box":
+        """If this box uses special characters for the borders of the header, then
+        return the equivalent box that does not.
+
+        Returns:
+            Box: The most similar Box that doesn't use header-specific box characters.
+                If the current Box already satisfies this criterion, then it's returned.
+        """
+        return PLAIN_HEADED_SUBSTITUTIONS.get(self, self)
+
+    def get_top(self, widths: Iterable[int]) -> str:
+        """Get the top of a simple box.
+
+        Args:
+            widths (List[int]): Widths of columns.
+
+        Returns:
+            str: A string of box characters.
+        """
+
+        parts: List[str] = []
+        append = parts.append
+        append(self.top_left)
+        for last, width in loop_last(widths):
+            append(self.top * width)
+            if not last:
+                append(self.top_divider)
+        append(self.top_right)
+        return "".join(parts)
+
+    def get_row(
+        self,
+        widths: Iterable[int],
+        level: Literal["head", "row", "foot", "mid"] = "row",
+        edge: bool = True,
+    ) -> str:
+        """Get the top of a simple box.
+
+        Args:
+            width (List[int]): Widths of columns.
+
+        Returns:
+            str: A string of box characters.
+        """
+        if level == "head":
+            left = self.head_row_left
+            horizontal = self.head_row_horizontal
+            cross = self.head_row_cross
+            right = self.head_row_right
+        elif level == "row":
+            left = self.row_left
+            horizontal = self.row_horizontal
+            cross = self.row_cross
+            right = self.row_right
+        elif level == "mid":
+            left = self.mid_left
+            horizontal = " "
+            cross = self.mid_vertical
+            right = self.mid_right
+        elif level == "foot":
+            left = self.foot_row_left
+            horizontal = self.foot_row_horizontal
+            cross = self.foot_row_cross
+            right = self.foot_row_right
+        else:
+            raise ValueError("level must be 'head', 'row' or 'foot'")
+
+        parts: List[str] = []
+        append = parts.append
+        if edge:
+            append(left)
+        for last, width in loop_last(widths):
+            append(horizontal * width)
+            if not last:
+                append(cross)
+        if edge:
+            append(right)
+        return "".join(parts)
+
+    def get_bottom(self, widths: Iterable[int]) -> str:
+        """Get the bottom of a simple box.
+
+        Args:
+            widths (List[int]): Widths of columns.
+
+        Returns:
+            str: A string of box characters.
+        """
+
+        parts: List[str] = []
+        append = parts.append
+        append(self.bottom_left)
+        for last, width in loop_last(widths):
+            append(self.bottom * width)
+            if not last:
+                append(self.bottom_divider)
+        append(self.bottom_right)
+        return "".join(parts)
+
+
+# fmt: off
+ASCII: Box = Box(
+    "+--+\n"
+    "| ||\n"
+    "|-+|\n"
+    "| ||\n"
+    "|-+|\n"
+    "|-+|\n"
+    "| ||\n"
+    "+--+\n",
+    ascii=True,
+)
+
+ASCII2: Box = Box(
+    "+-++\n"
+    "| ||\n"
+    "+-++\n"
+    "| ||\n"
+    "+-++\n"
+    "+-++\n"
+    "| ||\n"
+    "+-++\n",
+    ascii=True,
+)
+
+ASCII_DOUBLE_HEAD: Box = Box(
+    "+-++\n"
+    "| ||\n"
+    "+=++\n"
+    "| ||\n"
+    "+-++\n"
+    "+-++\n"
+    "| ||\n"
+    "+-++\n",
+    ascii=True,
+)
+
+SQUARE: Box = Box(
+    "┌─┬┐\n"
+    "│ ││\n"
+    "├─┼┤\n"
+    "│ ││\n"
+    "├─┼┤\n"
+    "├─┼┤\n"
+    "│ ││\n"
+    "└─┴┘\n"
+)
+
+SQUARE_DOUBLE_HEAD: Box = Box(
+    "┌─┬┐\n"
+    "│ ││\n"
+    "╞═╪╡\n"
+    "│ ││\n"
+    "├─┼┤\n"
+    "├─┼┤\n"
+    "│ ││\n"
+    "└─┴┘\n"
+)
+
+MINIMAL: Box = Box(
+    "  ╷ \n"
+    "  │ \n"
+    "╶─┼╴\n"
+    "  │ \n"
+    "╶─┼╴\n"
+    "╶─┼╴\n"
+    "  │ \n"
+    "  ╵ \n"
+)
+
+
+MINIMAL_HEAVY_HEAD: Box = Box(
+    "  ╷ \n"
+    "  │ \n"
+    "╺━┿╸\n"
+    "  │ \n"
+    "╶─┼╴\n"
+    "╶─┼╴\n"
+    "  │ \n"
+    "  ╵ \n"
+)
+
+MINIMAL_DOUBLE_HEAD: Box = Box(
+    "  ╷ \n"
+    "  │ \n"
+    " ═╪ \n"
+    "  │ \n"
+    " ─┼ \n"
+    " ─┼ \n"
+    "  │ \n"
+    "  ╵ \n"
+)
+
+
+SIMPLE: Box = Box(
+    "    \n"
+    "    \n"
+    " ── \n"
+    "    \n"
+    "    \n"
+    " ── \n"
+    "    \n"
+    "    \n"
+)
+
+SIMPLE_HEAD: Box = Box(
+    "    \n"
+    "    \n"
+    " ── \n"
+    "    \n"
+    "    \n"
+    "    \n"
+    "    \n"
+    "    \n"
+)
+
+
+SIMPLE_HEAVY: Box = Box(
+    "    \n"
+    "    \n"
+    " ━━ \n"
+    "    \n"
+    "    \n"
+    " ━━ \n"
+    "    \n"
+    "    \n"
+)
+
+
+HORIZONTALS: Box = Box(
+    " ── \n"
+    "    \n"
+    " ── \n"
+    "    \n"
+    " ── \n"
+    " ── \n"
+    "    \n"
+    " ── \n"
+)
+
+ROUNDED: Box = Box(
+    "╭─┬╮\n"
+    "│ ││\n"
+    "├─┼┤\n"
+    "│ ││\n"
+    "├─┼┤\n"
+    "├─┼┤\n"
+    "│ ││\n"
+    "╰─┴╯\n"
+)
+
+HEAVY: Box = Box(
+    "┏━┳┓\n"
+    "┃ ┃┃\n"
+    "┣━╋┫\n"
+    "┃ ┃┃\n"
+    "┣━╋┫\n"
+    "┣━╋┫\n"
+    "┃ ┃┃\n"
+    "┗━┻┛\n"
+)
+
+HEAVY_EDGE: Box = Box(
+    "┏━┯┓\n"
+    "┃ │┃\n"
+    "┠─┼┨\n"
+    "┃ │┃\n"
+    "┠─┼┨\n"
+    "┠─┼┨\n"
+    "┃ │┃\n"
+    "┗━┷┛\n"
+)
+
+HEAVY_HEAD: Box = Box(
+    "┏━┳┓\n"
+    "┃ ┃┃\n"
+    "┡━╇┩\n"
+    "│ ││\n"
+    "├─┼┤\n"
+    "├─┼┤\n"
+    "│ ││\n"
+    "└─┴┘\n"
+)
+
+DOUBLE: Box = Box(
+    "╔═╦╗\n"
+    "║ ║║\n"
+    "╠═╬╣\n"
+    "║ ║║\n"
+    "╠═╬╣\n"
+    "╠═╬╣\n"
+    "║ ║║\n"
+    "╚═╩╝\n"
+)
+
+DOUBLE_EDGE: Box = Box(
+    "╔═╤╗\n"
+    "║ │║\n"
+    "╟─┼╢\n"
+    "║ │║\n"
+    "╟─┼╢\n"
+    "╟─┼╢\n"
+    "║ │║\n"
+    "╚═╧╝\n"
+)
+
+MARKDOWN: Box = Box(
+    "    \n"
+    "| ||\n"
+    "|-||\n"
+    "| ||\n"
+    "|-||\n"
+    "|-||\n"
+    "| ||\n"
+    "    \n",
+    ascii=True,
+)
+# fmt: on
+
+# Map Boxes that don't render with raster fonts on to equivalent that do
+LEGACY_WINDOWS_SUBSTITUTIONS = {
+    ROUNDED: SQUARE,
+    MINIMAL_HEAVY_HEAD: MINIMAL,
+    SIMPLE_HEAVY: SIMPLE,
+    HEAVY: SQUARE,
+    HEAVY_EDGE: SQUARE,
+    HEAVY_HEAD: SQUARE,
+}
+
+# Map headed boxes to their headerless equivalents
+PLAIN_HEADED_SUBSTITUTIONS = {
+    HEAVY_HEAD: SQUARE,
+    SQUARE_DOUBLE_HEAD: SQUARE,
+    MINIMAL_DOUBLE_HEAD: MINIMAL,
+    MINIMAL_HEAVY_HEAD: MINIMAL,
+    ASCII_DOUBLE_HEAD: ASCII2,
+}
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.columns import Columns
+    from pip._vendor.rich.panel import Panel
+
+    from . import box as box
+    from .console import Console
+    from .table import Table
+    from .text import Text
+
+    console = Console(record=True)
+
+    BOXES = [
+        "ASCII",
+        "ASCII2",
+        "ASCII_DOUBLE_HEAD",
+        "SQUARE",
+        "SQUARE_DOUBLE_HEAD",
+        "MINIMAL",
+        "MINIMAL_HEAVY_HEAD",
+        "MINIMAL_DOUBLE_HEAD",
+        "SIMPLE",
+        "SIMPLE_HEAD",
+        "SIMPLE_HEAVY",
+        "HORIZONTALS",
+        "ROUNDED",
+        "HEAVY",
+        "HEAVY_EDGE",
+        "HEAVY_HEAD",
+        "DOUBLE",
+        "DOUBLE_EDGE",
+        "MARKDOWN",
+    ]
+
+    console.print(Panel("[bold green]Box Constants", style="green"), justify="center")
+    console.print()
+
+    columns = Columns(expand=True, padding=2)
+    for box_name in sorted(BOXES):
+        table = Table(
+            show_footer=True, style="dim", border_style="not dim", expand=True
+        )
+        table.add_column("Header 1", "Footer 1")
+        table.add_column("Header 2", "Footer 2")
+        table.add_row("Cell", "Cell")
+        table.add_row("Cell", "Cell")
+        table.box = getattr(box, box_name)
+        table.title = Text(f"box.{box_name}", style="magenta")
+        columns.add_renderable(table)
+    console.print(columns)
+
+    # console.save_svg("box.svg")
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/cells.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/cells.py
new file mode 100644
index 0000000..a854622
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/cells.py
@@ -0,0 +1,174 @@
+from __future__ import annotations
+
+from functools import lru_cache
+from typing import Callable
+
+from ._cell_widths import CELL_WIDTHS
+
+# Ranges of unicode ordinals that produce a 1-cell wide character
+# This is non-exhaustive, but covers most common Western characters
+_SINGLE_CELL_UNICODE_RANGES: list[tuple[int, int]] = [
+    (0x20, 0x7E),  # Latin (excluding non-printable)
+    (0xA0, 0xAC),
+    (0xAE, 0x002FF),
+    (0x00370, 0x00482),  # Greek / Cyrillic
+    (0x02500, 0x025FC),  # Box drawing, box elements, geometric shapes
+    (0x02800, 0x028FF),  # Braille
+]
+
+# A set of characters that are a single cell wide
+_SINGLE_CELLS = frozenset(
+    [
+        character
+        for _start, _end in _SINGLE_CELL_UNICODE_RANGES
+        for character in map(chr, range(_start, _end + 1))
+    ]
+)
+
+# When called with a string this will return True if all
+# characters are single-cell, otherwise False
+_is_single_cell_widths: Callable[[str], bool] = _SINGLE_CELLS.issuperset
+
+
+@lru_cache(4096)
+def cached_cell_len(text: str) -> int:
+    """Get the number of cells required to display text.
+
+    This method always caches, which may use up a lot of memory. It is recommended to use
+    `cell_len` over this method.
+
+    Args:
+        text (str): Text to display.
+
+    Returns:
+        int: Get the number of cells required to display text.
+    """
+    if _is_single_cell_widths(text):
+        return len(text)
+    return sum(map(get_character_cell_size, text))
+
+
+def cell_len(text: str, _cell_len: Callable[[str], int] = cached_cell_len) -> int:
+    """Get the number of cells required to display text.
+
+    Args:
+        text (str): Text to display.
+
+    Returns:
+        int: Get the number of cells required to display text.
+    """
+    if len(text) < 512:
+        return _cell_len(text)
+    if _is_single_cell_widths(text):
+        return len(text)
+    return sum(map(get_character_cell_size, text))
+
+
+@lru_cache(maxsize=4096)
+def get_character_cell_size(character: str) -> int:
+    """Get the cell size of a character.
+
+    Args:
+        character (str): A single character.
+
+    Returns:
+        int: Number of cells (0, 1 or 2) occupied by that character.
+    """
+    codepoint = ord(character)
+    _table = CELL_WIDTHS
+    lower_bound = 0
+    upper_bound = len(_table) - 1
+    index = (lower_bound + upper_bound) // 2
+    while True:
+        start, end, width = _table[index]
+        if codepoint < start:
+            upper_bound = index - 1
+        elif codepoint > end:
+            lower_bound = index + 1
+        else:
+            return 0 if width == -1 else width
+        if upper_bound < lower_bound:
+            break
+        index = (lower_bound + upper_bound) // 2
+    return 1
+
+
+def set_cell_size(text: str, total: int) -> str:
+    """Set the length of a string to fit within given number of cells."""
+
+    if _is_single_cell_widths(text):
+        size = len(text)
+        if size < total:
+            return text + " " * (total - size)
+        return text[:total]
+
+    if total <= 0:
+        return ""
+    cell_size = cell_len(text)
+    if cell_size == total:
+        return text
+    if cell_size < total:
+        return text + " " * (total - cell_size)
+
+    start = 0
+    end = len(text)
+
+    # Binary search until we find the right size
+    while True:
+        pos = (start + end) // 2
+        before = text[: pos + 1]
+        before_len = cell_len(before)
+        if before_len == total + 1 and cell_len(before[-1]) == 2:
+            return before[:-1] + " "
+        if before_len == total:
+            return before
+        if before_len > total:
+            end = pos
+        else:
+            start = pos
+
+
+def chop_cells(
+    text: str,
+    width: int,
+) -> list[str]:
+    """Split text into lines such that each line fits within the available (cell) width.
+
+    Args:
+        text: The text to fold such that it fits in the given width.
+        width: The width available (number of cells).
+
+    Returns:
+        A list of strings such that each string in the list has cell width
+        less than or equal to the available width.
+    """
+    _get_character_cell_size = get_character_cell_size
+    lines: list[list[str]] = [[]]
+
+    append_new_line = lines.append
+    append_to_last_line = lines[-1].append
+
+    total_width = 0
+
+    for character in text:
+        cell_width = _get_character_cell_size(character)
+        char_doesnt_fit = total_width + cell_width > width
+
+        if char_doesnt_fit:
+            append_new_line([character])
+            append_to_last_line = lines[-1].append
+            total_width = cell_width
+        else:
+            append_to_last_line(character)
+            total_width += cell_width
+
+    return ["".join(line) for line in lines]
+
+
+if __name__ == "__main__":  # pragma: no cover
+    print(get_character_cell_size("😽"))
+    for line in chop_cells("""这是对亚洲语言支持的测试。面对模棱两可的想法，拒绝猜测的诱惑。""", 8):
+        print(line)
+    for n in range(80, 1, -1):
+        print(set_cell_size("""这是对亚洲语言支持的测试。面对模棱两可的想法，拒绝猜测的诱惑。""", n) + "|")
+        print("x" * n)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/color.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/color.py
new file mode 100644
index 0000000..e2c23a6
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/color.py
@@ -0,0 +1,621 @@
+import re
+import sys
+from colorsys import rgb_to_hls
+from enum import IntEnum
+from functools import lru_cache
+from typing import TYPE_CHECKING, NamedTuple, Optional, Tuple
+
+from ._palettes import EIGHT_BIT_PALETTE, STANDARD_PALETTE, WINDOWS_PALETTE
+from .color_triplet import ColorTriplet
+from .repr import Result, rich_repr
+from .terminal_theme import DEFAULT_TERMINAL_THEME
+
+if TYPE_CHECKING:  # pragma: no cover
+    from .terminal_theme import TerminalTheme
+    from .text import Text
+
+
+WINDOWS = sys.platform == "win32"
+
+
+class ColorSystem(IntEnum):
+    """One of the 3 color system supported by terminals."""
+
+    STANDARD = 1
+    EIGHT_BIT = 2
+    TRUECOLOR = 3
+    WINDOWS = 4
+
+    def __repr__(self) -> str:
+        return f"ColorSystem.{self.name}"
+
+    def __str__(self) -> str:
+        return repr(self)
+
+
+class ColorType(IntEnum):
+    """Type of color stored in Color class."""
+
+    DEFAULT = 0
+    STANDARD = 1
+    EIGHT_BIT = 2
+    TRUECOLOR = 3
+    WINDOWS = 4
+
+    def __repr__(self) -> str:
+        return f"ColorType.{self.name}"
+
+
+ANSI_COLOR_NAMES = {
+    "black": 0,
+    "red": 1,
+    "green": 2,
+    "yellow": 3,
+    "blue": 4,
+    "magenta": 5,
+    "cyan": 6,
+    "white": 7,
+    "bright_black": 8,
+    "bright_red": 9,
+    "bright_green": 10,
+    "bright_yellow": 11,
+    "bright_blue": 12,
+    "bright_magenta": 13,
+    "bright_cyan": 14,
+    "bright_white": 15,
+    "grey0": 16,
+    "gray0": 16,
+    "navy_blue": 17,
+    "dark_blue": 18,
+    "blue3": 20,
+    "blue1": 21,
+    "dark_green": 22,
+    "deep_sky_blue4": 25,
+    "dodger_blue3": 26,
+    "dodger_blue2": 27,
+    "green4": 28,
+    "spring_green4": 29,
+    "turquoise4": 30,
+    "deep_sky_blue3": 32,
+    "dodger_blue1": 33,
+    "green3": 40,
+    "spring_green3": 41,
+    "dark_cyan": 36,
+    "light_sea_green": 37,
+    "deep_sky_blue2": 38,
+    "deep_sky_blue1": 39,
+    "spring_green2": 47,
+    "cyan3": 43,
+    "dark_turquoise": 44,
+    "turquoise2": 45,
+    "green1": 46,
+    "spring_green1": 48,
+    "medium_spring_green": 49,
+    "cyan2": 50,
+    "cyan1": 51,
+    "dark_red": 88,
+    "deep_pink4": 125,
+    "purple4": 55,
+    "purple3": 56,
+    "blue_violet": 57,
+    "orange4": 94,
+    "grey37": 59,
+    "gray37": 59,
+    "medium_purple4": 60,
+    "slate_blue3": 62,
+    "royal_blue1": 63,
+    "chartreuse4": 64,
+    "dark_sea_green4": 71,
+    "pale_turquoise4": 66,
+    "steel_blue": 67,
+    "steel_blue3": 68,
+    "cornflower_blue": 69,
+    "chartreuse3": 76,
+    "cadet_blue": 73,
+    "sky_blue3": 74,
+    "steel_blue1": 81,
+    "pale_green3": 114,
+    "sea_green3": 78,
+    "aquamarine3": 79,
+    "medium_turquoise": 80,
+    "chartreuse2": 112,
+    "sea_green2": 83,
+    "sea_green1": 85,
+    "aquamarine1": 122,
+    "dark_slate_gray2": 87,
+    "dark_magenta": 91,
+    "dark_violet": 128,
+    "purple": 129,
+    "light_pink4": 95,
+    "plum4": 96,
+    "medium_purple3": 98,
+    "slate_blue1": 99,
+    "yellow4": 106,
+    "wheat4": 101,
+    "grey53": 102,
+    "gray53": 102,
+    "light_slate_grey": 103,
+    "light_slate_gray": 103,
+    "medium_purple": 104,
+    "light_slate_blue": 105,
+    "dark_olive_green3": 149,
+    "dark_sea_green": 108,
+    "light_sky_blue3": 110,
+    "sky_blue2": 111,
+    "dark_sea_green3": 150,
+    "dark_slate_gray3": 116,
+    "sky_blue1": 117,
+    "chartreuse1": 118,
+    "light_green": 120,
+    "pale_green1": 156,
+    "dark_slate_gray1": 123,
+    "red3": 160,
+    "medium_violet_red": 126,
+    "magenta3": 164,
+    "dark_orange3": 166,
+    "indian_red": 167,
+    "hot_pink3": 168,
+    "medium_orchid3": 133,
+    "medium_orchid": 134,
+    "medium_purple2": 140,
+    "dark_goldenrod": 136,
+    "light_salmon3": 173,
+    "rosy_brown": 138,
+    "grey63": 139,
+    "gray63": 139,
+    "medium_purple1": 141,
+    "gold3": 178,
+    "dark_khaki": 143,
+    "navajo_white3": 144,
+    "grey69": 145,
+    "gray69": 145,
+    "light_steel_blue3": 146,
+    "light_steel_blue": 147,
+    "yellow3": 184,
+    "dark_sea_green2": 157,
+    "light_cyan3": 152,
+    "light_sky_blue1": 153,
+    "green_yellow": 154,
+    "dark_olive_green2": 155,
+    "dark_sea_green1": 193,
+    "pale_turquoise1": 159,
+    "deep_pink3": 162,
+    "magenta2": 200,
+    "hot_pink2": 169,
+    "orchid": 170,
+    "medium_orchid1": 207,
+    "orange3": 172,
+    "light_pink3": 174,
+    "pink3": 175,
+    "plum3": 176,
+    "violet": 177,
+    "light_goldenrod3": 179,
+    "tan": 180,
+    "misty_rose3": 181,
+    "thistle3": 182,
+    "plum2": 183,
+    "khaki3": 185,
+    "light_goldenrod2": 222,
+    "light_yellow3": 187,
+    "grey84": 188,
+    "gray84": 188,
+    "light_steel_blue1": 189,
+    "yellow2": 190,
+    "dark_olive_green1": 192,
+    "honeydew2": 194,
+    "light_cyan1": 195,
+    "red1": 196,
+    "deep_pink2": 197,
+    "deep_pink1": 199,
+    "magenta1": 201,
+    "orange_red1": 202,
+    "indian_red1": 204,
+    "hot_pink": 206,
+    "dark_orange": 208,
+    "salmon1": 209,
+    "light_coral": 210,
+    "pale_violet_red1": 211,
+    "orchid2": 212,
+    "orchid1": 213,
+    "orange1": 214,
+    "sandy_brown": 215,
+    "light_salmon1": 216,
+    "light_pink1": 217,
+    "pink1": 218,
+    "plum1": 219,
+    "gold1": 220,
+    "navajo_white1": 223,
+    "misty_rose1": 224,
+    "thistle1": 225,
+    "yellow1": 226,
+    "light_goldenrod1": 227,
+    "khaki1": 228,
+    "wheat1": 229,
+    "cornsilk1": 230,
+    "grey100": 231,
+    "gray100": 231,
+    "grey3": 232,
+    "gray3": 232,
+    "grey7": 233,
+    "gray7": 233,
+    "grey11": 234,
+    "gray11": 234,
+    "grey15": 235,
+    "gray15": 235,
+    "grey19": 236,
+    "gray19": 236,
+    "grey23": 237,
+    "gray23": 237,
+    "grey27": 238,
+    "gray27": 238,
+    "grey30": 239,
+    "gray30": 239,
+    "grey35": 240,
+    "gray35": 240,
+    "grey39": 241,
+    "gray39": 241,
+    "grey42": 242,
+    "gray42": 242,
+    "grey46": 243,
+    "gray46": 243,
+    "grey50": 244,
+    "gray50": 244,
+    "grey54": 245,
+    "gray54": 245,
+    "grey58": 246,
+    "gray58": 246,
+    "grey62": 247,
+    "gray62": 247,
+    "grey66": 248,
+    "gray66": 248,
+    "grey70": 249,
+    "gray70": 249,
+    "grey74": 250,
+    "gray74": 250,
+    "grey78": 251,
+    "gray78": 251,
+    "grey82": 252,
+    "gray82": 252,
+    "grey85": 253,
+    "gray85": 253,
+    "grey89": 254,
+    "gray89": 254,
+    "grey93": 255,
+    "gray93": 255,
+}
+
+
+class ColorParseError(Exception):
+    """The color could not be parsed."""
+
+
+RE_COLOR = re.compile(
+    r"""^
+\#([0-9a-f]{6})$|
+color\(([0-9]{1,3})\)$|
+rgb\(([\d\s,]+)\)$
+""",
+    re.VERBOSE,
+)
+
+
+@rich_repr
+class Color(NamedTuple):
+    """Terminal color definition."""
+
+    name: str
+    """The name of the color (typically the input to Color.parse)."""
+    type: ColorType
+    """The type of the color."""
+    number: Optional[int] = None
+    """The color number, if a standard color, or None."""
+    triplet: Optional[ColorTriplet] = None
+    """A triplet of color components, if an RGB color."""
+
+    def __rich__(self) -> "Text":
+        """Displays the actual color if Rich printed."""
+        from .style import Style
+        from .text import Text
+
+        return Text.assemble(
+            f"",
+        )
+
+    def __rich_repr__(self) -> Result:
+        yield self.name
+        yield self.type
+        yield "number", self.number, None
+        yield "triplet", self.triplet, None
+
+    @property
+    def system(self) -> ColorSystem:
+        """Get the native color system for this color."""
+        if self.type == ColorType.DEFAULT:
+            return ColorSystem.STANDARD
+        return ColorSystem(int(self.type))
+
+    @property
+    def is_system_defined(self) -> bool:
+        """Check if the color is ultimately defined by the system."""
+        return self.system not in (ColorSystem.EIGHT_BIT, ColorSystem.TRUECOLOR)
+
+    @property
+    def is_default(self) -> bool:
+        """Check if the color is a default color."""
+        return self.type == ColorType.DEFAULT
+
+    def get_truecolor(
+        self, theme: Optional["TerminalTheme"] = None, foreground: bool = True
+    ) -> ColorTriplet:
+        """Get an equivalent color triplet for this color.
+
+        Args:
+            theme (TerminalTheme, optional): Optional terminal theme, or None to use default. Defaults to None.
+            foreground (bool, optional): True for a foreground color, or False for background. Defaults to True.
+
+        Returns:
+            ColorTriplet: A color triplet containing RGB components.
+        """
+
+        if theme is None:
+            theme = DEFAULT_TERMINAL_THEME
+        if self.type == ColorType.TRUECOLOR:
+            assert self.triplet is not None
+            return self.triplet
+        elif self.type == ColorType.EIGHT_BIT:
+            assert self.number is not None
+            return EIGHT_BIT_PALETTE[self.number]
+        elif self.type == ColorType.STANDARD:
+            assert self.number is not None
+            return theme.ansi_colors[self.number]
+        elif self.type == ColorType.WINDOWS:
+            assert self.number is not None
+            return WINDOWS_PALETTE[self.number]
+        else:  # self.type == ColorType.DEFAULT:
+            assert self.number is None
+            return theme.foreground_color if foreground else theme.background_color
+
+    @classmethod
+    def from_ansi(cls, number: int) -> "Color":
+        """Create a Color number from it's 8-bit ansi number.
+
+        Args:
+            number (int): A number between 0-255 inclusive.
+
+        Returns:
+            Color: A new Color instance.
+        """
+        return cls(
+            name=f"color({number})",
+            type=(ColorType.STANDARD if number < 16 else ColorType.EIGHT_BIT),
+            number=number,
+        )
+
+    @classmethod
+    def from_triplet(cls, triplet: "ColorTriplet") -> "Color":
+        """Create a truecolor RGB color from a triplet of values.
+
+        Args:
+            triplet (ColorTriplet): A color triplet containing red, green and blue components.
+
+        Returns:
+            Color: A new color object.
+        """
+        return cls(name=triplet.hex, type=ColorType.TRUECOLOR, triplet=triplet)
+
+    @classmethod
+    def from_rgb(cls, red: float, green: float, blue: float) -> "Color":
+        """Create a truecolor from three color components in the range(0->255).
+
+        Args:
+            red (float): Red component in range 0-255.
+            green (float): Green component in range 0-255.
+            blue (float): Blue component in range 0-255.
+
+        Returns:
+            Color: A new color object.
+        """
+        return cls.from_triplet(ColorTriplet(int(red), int(green), int(blue)))
+
+    @classmethod
+    def default(cls) -> "Color":
+        """Get a Color instance representing the default color.
+
+        Returns:
+            Color: Default color.
+        """
+        return cls(name="default", type=ColorType.DEFAULT)
+
+    @classmethod
+    @lru_cache(maxsize=1024)
+    def parse(cls, color: str) -> "Color":
+        """Parse a color definition."""
+        original_color = color
+        color = color.lower().strip()
+
+        if color == "default":
+            return cls(color, type=ColorType.DEFAULT)
+
+        color_number = ANSI_COLOR_NAMES.get(color)
+        if color_number is not None:
+            return cls(
+                color,
+                type=(ColorType.STANDARD if color_number < 16 else ColorType.EIGHT_BIT),
+                number=color_number,
+            )
+
+        color_match = RE_COLOR.match(color)
+        if color_match is None:
+            raise ColorParseError(f"{original_color!r} is not a valid color")
+
+        color_24, color_8, color_rgb = color_match.groups()
+        if color_24:
+            triplet = ColorTriplet(
+                int(color_24[0:2], 16), int(color_24[2:4], 16), int(color_24[4:6], 16)
+            )
+            return cls(color, ColorType.TRUECOLOR, triplet=triplet)
+
+        elif color_8:
+            number = int(color_8)
+            if number > 255:
+                raise ColorParseError(f"color number must be <= 255 in {color!r}")
+            return cls(
+                color,
+                type=(ColorType.STANDARD if number < 16 else ColorType.EIGHT_BIT),
+                number=number,
+            )
+
+        else:  #  color_rgb:
+            components = color_rgb.split(",")
+            if len(components) != 3:
+                raise ColorParseError(
+                    f"expected three components in {original_color!r}"
+                )
+            red, green, blue = components
+            triplet = ColorTriplet(int(red), int(green), int(blue))
+            if not all(component <= 255 for component in triplet):
+                raise ColorParseError(
+                    f"color components must be <= 255 in {original_color!r}"
+                )
+            return cls(color, ColorType.TRUECOLOR, triplet=triplet)
+
+    @lru_cache(maxsize=1024)
+    def get_ansi_codes(self, foreground: bool = True) -> Tuple[str, ...]:
+        """Get the ANSI escape codes for this color."""
+        _type = self.type
+        if _type == ColorType.DEFAULT:
+            return ("39" if foreground else "49",)
+
+        elif _type == ColorType.WINDOWS:
+            number = self.number
+            assert number is not None
+            fore, back = (30, 40) if number < 8 else (82, 92)
+            return (str(fore + number if foreground else back + number),)
+
+        elif _type == ColorType.STANDARD:
+            number = self.number
+            assert number is not None
+            fore, back = (30, 40) if number < 8 else (82, 92)
+            return (str(fore + number if foreground else back + number),)
+
+        elif _type == ColorType.EIGHT_BIT:
+            assert self.number is not None
+            return ("38" if foreground else "48", "5", str(self.number))
+
+        else:  # self.standard == ColorStandard.TRUECOLOR:
+            assert self.triplet is not None
+            red, green, blue = self.triplet
+            return ("38" if foreground else "48", "2", str(red), str(green), str(blue))
+
+    @lru_cache(maxsize=1024)
+    def downgrade(self, system: ColorSystem) -> "Color":
+        """Downgrade a color system to a system with fewer colors."""
+
+        if self.type in (ColorType.DEFAULT, system):
+            return self
+        # Convert to 8-bit color from truecolor color
+        if system == ColorSystem.EIGHT_BIT and self.system == ColorSystem.TRUECOLOR:
+            assert self.triplet is not None
+            _h, l, s = rgb_to_hls(*self.triplet.normalized)
+            # If saturation is under 15% assume it is grayscale
+            if s < 0.15:
+                gray = round(l * 25.0)
+                if gray == 0:
+                    color_number = 16
+                elif gray == 25:
+                    color_number = 231
+                else:
+                    color_number = 231 + gray
+                return Color(self.name, ColorType.EIGHT_BIT, number=color_number)
+
+            red, green, blue = self.triplet
+            six_red = red / 95 if red < 95 else 1 + (red - 95) / 40
+            six_green = green / 95 if green < 95 else 1 + (green - 95) / 40
+            six_blue = blue / 95 if blue < 95 else 1 + (blue - 95) / 40
+
+            color_number = (
+                16 + 36 * round(six_red) + 6 * round(six_green) + round(six_blue)
+            )
+            return Color(self.name, ColorType.EIGHT_BIT, number=color_number)
+
+        # Convert to standard from truecolor or 8-bit
+        elif system == ColorSystem.STANDARD:
+            if self.system == ColorSystem.TRUECOLOR:
+                assert self.triplet is not None
+                triplet = self.triplet
+            else:  # self.system == ColorSystem.EIGHT_BIT
+                assert self.number is not None
+                triplet = ColorTriplet(*EIGHT_BIT_PALETTE[self.number])
+
+            color_number = STANDARD_PALETTE.match(triplet)
+            return Color(self.name, ColorType.STANDARD, number=color_number)
+
+        elif system == ColorSystem.WINDOWS:
+            if self.system == ColorSystem.TRUECOLOR:
+                assert self.triplet is not None
+                triplet = self.triplet
+            else:  # self.system == ColorSystem.EIGHT_BIT
+                assert self.number is not None
+                if self.number < 16:
+                    return Color(self.name, ColorType.WINDOWS, number=self.number)
+                triplet = ColorTriplet(*EIGHT_BIT_PALETTE[self.number])
+
+            color_number = WINDOWS_PALETTE.match(triplet)
+            return Color(self.name, ColorType.WINDOWS, number=color_number)
+
+        return self
+
+
+def parse_rgb_hex(hex_color: str) -> ColorTriplet:
+    """Parse six hex characters in to RGB triplet."""
+    assert len(hex_color) == 6, "must be 6 characters"
+    color = ColorTriplet(
+        int(hex_color[0:2], 16), int(hex_color[2:4], 16), int(hex_color[4:6], 16)
+    )
+    return color
+
+
+def blend_rgb(
+    color1: ColorTriplet, color2: ColorTriplet, cross_fade: float = 0.5
+) -> ColorTriplet:
+    """Blend one RGB color in to another."""
+    r1, g1, b1 = color1
+    r2, g2, b2 = color2
+    new_color = ColorTriplet(
+        int(r1 + (r2 - r1) * cross_fade),
+        int(g1 + (g2 - g1) * cross_fade),
+        int(b1 + (b2 - b1) * cross_fade),
+    )
+    return new_color
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from .console import Console
+    from .table import Table
+    from .text import Text
+
+    console = Console()
+
+    table = Table(show_footer=False, show_edge=True)
+    table.add_column("Color", width=10, overflow="ellipsis")
+    table.add_column("Number", justify="right", style="yellow")
+    table.add_column("Name", style="green")
+    table.add_column("Hex", style="blue")
+    table.add_column("RGB", style="magenta")
+
+    colors = sorted((v, k) for k, v in ANSI_COLOR_NAMES.items())
+    for color_number, name in colors:
+        if "grey" in name:
+            continue
+        color_cell = Text(" " * 10, style=f"on {name}")
+        if color_number < 16:
+            table.add_row(color_cell, f"{color_number}", Text(f'"{name}"'))
+        else:
+            color = EIGHT_BIT_PALETTE[color_number]  # type: ignore[has-type]
+            table.add_row(
+                color_cell, str(color_number), Text(f'"{name}"'), color.hex, color.rgb
+            )
+
+    console.print(table)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/color_triplet.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/color_triplet.py
new file mode 100644
index 0000000..02cab32
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/color_triplet.py
@@ -0,0 +1,38 @@
+from typing import NamedTuple, Tuple
+
+
+class ColorTriplet(NamedTuple):
+    """The red, green, and blue components of a color."""
+
+    red: int
+    """Red component in 0 to 255 range."""
+    green: int
+    """Green component in 0 to 255 range."""
+    blue: int
+    """Blue component in 0 to 255 range."""
+
+    @property
+    def hex(self) -> str:
+        """get the color triplet in CSS style."""
+        red, green, blue = self
+        return f"#{red:02x}{green:02x}{blue:02x}"
+
+    @property
+    def rgb(self) -> str:
+        """The color in RGB format.
+
+        Returns:
+            str: An rgb color, e.g. ``"rgb(100,23,255)"``.
+        """
+        red, green, blue = self
+        return f"rgb({red},{green},{blue})"
+
+    @property
+    def normalized(self) -> Tuple[float, float, float]:
+        """Convert components into floats between 0 and 1.
+
+        Returns:
+            Tuple[float, float, float]: A tuple of three normalized colour components.
+        """
+        red, green, blue = self
+        return red / 255.0, green / 255.0, blue / 255.0
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/columns.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/columns.py
new file mode 100644
index 0000000..669a3a7
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/columns.py
@@ -0,0 +1,187 @@
+from collections import defaultdict
+from itertools import chain
+from operator import itemgetter
+from typing import Dict, Iterable, List, Optional, Tuple
+
+from .align import Align, AlignMethod
+from .console import Console, ConsoleOptions, RenderableType, RenderResult
+from .constrain import Constrain
+from .measure import Measurement
+from .padding import Padding, PaddingDimensions
+from .table import Table
+from .text import TextType
+from .jupyter import JupyterMixin
+
+
+class Columns(JupyterMixin):
+    """Display renderables in neat columns.
+
+    Args:
+        renderables (Iterable[RenderableType]): Any number of Rich renderables (including str).
+        width (int, optional): The desired width of the columns, or None to auto detect. Defaults to None.
+        padding (PaddingDimensions, optional): Optional padding around cells. Defaults to (0, 1).
+        expand (bool, optional): Expand columns to full width. Defaults to False.
+        equal (bool, optional): Arrange in to equal sized columns. Defaults to False.
+        column_first (bool, optional): Align items from top to bottom (rather than left to right). Defaults to False.
+        right_to_left (bool, optional): Start column from right hand side. Defaults to False.
+        align (str, optional): Align value ("left", "right", or "center") or None for default. Defaults to None.
+        title (TextType, optional): Optional title for Columns.
+    """
+
+    def __init__(
+        self,
+        renderables: Optional[Iterable[RenderableType]] = None,
+        padding: PaddingDimensions = (0, 1),
+        *,
+        width: Optional[int] = None,
+        expand: bool = False,
+        equal: bool = False,
+        column_first: bool = False,
+        right_to_left: bool = False,
+        align: Optional[AlignMethod] = None,
+        title: Optional[TextType] = None,
+    ) -> None:
+        self.renderables = list(renderables or [])
+        self.width = width
+        self.padding = padding
+        self.expand = expand
+        self.equal = equal
+        self.column_first = column_first
+        self.right_to_left = right_to_left
+        self.align: Optional[AlignMethod] = align
+        self.title = title
+
+    def add_renderable(self, renderable: RenderableType) -> None:
+        """Add a renderable to the columns.
+
+        Args:
+            renderable (RenderableType): Any renderable object.
+        """
+        self.renderables.append(renderable)
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        render_str = console.render_str
+        renderables = [
+            render_str(renderable) if isinstance(renderable, str) else renderable
+            for renderable in self.renderables
+        ]
+        if not renderables:
+            return
+        _top, right, _bottom, left = Padding.unpack(self.padding)
+        width_padding = max(left, right)
+        max_width = options.max_width
+        widths: Dict[int, int] = defaultdict(int)
+        column_count = len(renderables)
+
+        get_measurement = Measurement.get
+        renderable_widths = [
+            get_measurement(console, options, renderable).maximum
+            for renderable in renderables
+        ]
+        if self.equal:
+            renderable_widths = [max(renderable_widths)] * len(renderable_widths)
+
+        def iter_renderables(
+            column_count: int,
+        ) -> Iterable[Tuple[int, Optional[RenderableType]]]:
+            item_count = len(renderables)
+            if self.column_first:
+                width_renderables = list(zip(renderable_widths, renderables))
+
+                column_lengths: List[int] = [item_count // column_count] * column_count
+                for col_no in range(item_count % column_count):
+                    column_lengths[col_no] += 1
+
+                row_count = (item_count + column_count - 1) // column_count
+                cells = [[-1] * column_count for _ in range(row_count)]
+                row = col = 0
+                for index in range(item_count):
+                    cells[row][col] = index
+                    column_lengths[col] -= 1
+                    if column_lengths[col]:
+                        row += 1
+                    else:
+                        col += 1
+                        row = 0
+                for index in chain.from_iterable(cells):
+                    if index == -1:
+                        break
+                    yield width_renderables[index]
+            else:
+                yield from zip(renderable_widths, renderables)
+            # Pad odd elements with spaces
+            if item_count % column_count:
+                for _ in range(column_count - (item_count % column_count)):
+                    yield 0, None
+
+        table = Table.grid(padding=self.padding, collapse_padding=True, pad_edge=False)
+        table.expand = self.expand
+        table.title = self.title
+
+        if self.width is not None:
+            column_count = (max_width) // (self.width + width_padding)
+            for _ in range(column_count):
+                table.add_column(width=self.width)
+        else:
+            while column_count > 1:
+                widths.clear()
+                column_no = 0
+                for renderable_width, _ in iter_renderables(column_count):
+                    widths[column_no] = max(widths[column_no], renderable_width)
+                    total_width = sum(widths.values()) + width_padding * (
+                        len(widths) - 1
+                    )
+                    if total_width > max_width:
+                        column_count = len(widths) - 1
+                        break
+                    else:
+                        column_no = (column_no + 1) % column_count
+                else:
+                    break
+
+        get_renderable = itemgetter(1)
+        _renderables = [
+            get_renderable(_renderable)
+            for _renderable in iter_renderables(column_count)
+        ]
+        if self.equal:
+            _renderables = [
+                None
+                if renderable is None
+                else Constrain(renderable, renderable_widths[0])
+                for renderable in _renderables
+            ]
+        if self.align:
+            align = self.align
+            _Align = Align
+            _renderables = [
+                None if renderable is None else _Align(renderable, align)
+                for renderable in _renderables
+            ]
+
+        right_to_left = self.right_to_left
+        add_row = table.add_row
+        for start in range(0, len(_renderables), column_count):
+            row = _renderables[start : start + column_count]
+            if right_to_left:
+                row = row[::-1]
+            add_row(*row)
+        yield table
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import os
+
+    console = Console()
+
+    files = [f"{i} {s}" for i, s in enumerate(sorted(os.listdir()))]
+    columns = Columns(files, padding=(0, 1), expand=False, equal=False)
+    console.print(columns)
+    console.rule()
+    columns.column_first = True
+    console.print(columns)
+    columns.right_to_left = True
+    console.rule()
+    console.print(columns)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/console.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/console.py
new file mode 100644
index 0000000..5728845
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/console.py
@@ -0,0 +1,2661 @@
+import inspect
+import os
+import sys
+import threading
+import zlib
+from abc import ABC, abstractmethod
+from dataclasses import dataclass, field
+from datetime import datetime
+from functools import wraps
+from getpass import getpass
+from html import escape
+from inspect import isclass
+from itertools import islice
+from math import ceil
+from time import monotonic
+from types import FrameType, ModuleType, TracebackType
+from typing import (
+    IO,
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Mapping,
+    NamedTuple,
+    Optional,
+    TextIO,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+from pip._vendor.rich._null_file import NULL_FILE
+
+if sys.version_info >= (3, 8):
+    from typing import Literal, Protocol, runtime_checkable
+else:
+    from pip._vendor.typing_extensions import (
+        Literal,
+        Protocol,
+        runtime_checkable,
+    )  # pragma: no cover
+
+from . import errors, themes
+from ._emoji_replace import _emoji_replace
+from ._export_format import CONSOLE_HTML_FORMAT, CONSOLE_SVG_FORMAT
+from ._fileno import get_fileno
+from ._log_render import FormatTimeCallable, LogRender
+from .align import Align, AlignMethod
+from .color import ColorSystem, blend_rgb
+from .control import Control
+from .emoji import EmojiVariant
+from .highlighter import NullHighlighter, ReprHighlighter
+from .markup import render as render_markup
+from .measure import Measurement, measure_renderables
+from .pager import Pager, SystemPager
+from .pretty import Pretty, is_expandable
+from .protocol import rich_cast
+from .region import Region
+from .scope import render_scope
+from .screen import Screen
+from .segment import Segment
+from .style import Style, StyleType
+from .styled import Styled
+from .terminal_theme import DEFAULT_TERMINAL_THEME, SVG_EXPORT_THEME, TerminalTheme
+from .text import Text, TextType
+from .theme import Theme, ThemeStack
+
+if TYPE_CHECKING:
+    from ._windows import WindowsConsoleFeatures
+    from .live import Live
+    from .status import Status
+
+JUPYTER_DEFAULT_COLUMNS = 115
+JUPYTER_DEFAULT_LINES = 100
+WINDOWS = sys.platform == "win32"
+
+HighlighterType = Callable[[Union[str, "Text"]], "Text"]
+JustifyMethod = Literal["default", "left", "center", "right", "full"]
+OverflowMethod = Literal["fold", "crop", "ellipsis", "ignore"]
+
+
+class NoChange:
+    pass
+
+
+NO_CHANGE = NoChange()
+
+try:
+    _STDIN_FILENO = sys.__stdin__.fileno()  # type: ignore[union-attr]
+except Exception:
+    _STDIN_FILENO = 0
+try:
+    _STDOUT_FILENO = sys.__stdout__.fileno()  # type: ignore[union-attr]
+except Exception:
+    _STDOUT_FILENO = 1
+try:
+    _STDERR_FILENO = sys.__stderr__.fileno()  # type: ignore[union-attr]
+except Exception:
+    _STDERR_FILENO = 2
+
+_STD_STREAMS = (_STDIN_FILENO, _STDOUT_FILENO, _STDERR_FILENO)
+_STD_STREAMS_OUTPUT = (_STDOUT_FILENO, _STDERR_FILENO)
+
+
+_TERM_COLORS = {
+    "kitty": ColorSystem.EIGHT_BIT,
+    "256color": ColorSystem.EIGHT_BIT,
+    "16color": ColorSystem.STANDARD,
+}
+
+
+class ConsoleDimensions(NamedTuple):
+    """Size of the terminal."""
+
+    width: int
+    """The width of the console in 'cells'."""
+    height: int
+    """The height of the console in lines."""
+
+
+@dataclass
+class ConsoleOptions:
+    """Options for __rich_console__ method."""
+
+    size: ConsoleDimensions
+    """Size of console."""
+    legacy_windows: bool
+    """legacy_windows: flag for legacy windows."""
+    min_width: int
+    """Minimum width of renderable."""
+    max_width: int
+    """Maximum width of renderable."""
+    is_terminal: bool
+    """True if the target is a terminal, otherwise False."""
+    encoding: str
+    """Encoding of terminal."""
+    max_height: int
+    """Height of container (starts as terminal)"""
+    justify: Optional[JustifyMethod] = None
+    """Justify value override for renderable."""
+    overflow: Optional[OverflowMethod] = None
+    """Overflow value override for renderable."""
+    no_wrap: Optional[bool] = False
+    """Disable wrapping for text."""
+    highlight: Optional[bool] = None
+    """Highlight override for render_str."""
+    markup: Optional[bool] = None
+    """Enable markup when rendering strings."""
+    height: Optional[int] = None
+
+    @property
+    def ascii_only(self) -> bool:
+        """Check if renderables should use ascii only."""
+        return not self.encoding.startswith("utf")
+
+    def copy(self) -> "ConsoleOptions":
+        """Return a copy of the options.
+
+        Returns:
+            ConsoleOptions: a copy of self.
+        """
+        options: ConsoleOptions = ConsoleOptions.__new__(ConsoleOptions)
+        options.__dict__ = self.__dict__.copy()
+        return options
+
+    def update(
+        self,
+        *,
+        width: Union[int, NoChange] = NO_CHANGE,
+        min_width: Union[int, NoChange] = NO_CHANGE,
+        max_width: Union[int, NoChange] = NO_CHANGE,
+        justify: Union[Optional[JustifyMethod], NoChange] = NO_CHANGE,
+        overflow: Union[Optional[OverflowMethod], NoChange] = NO_CHANGE,
+        no_wrap: Union[Optional[bool], NoChange] = NO_CHANGE,
+        highlight: Union[Optional[bool], NoChange] = NO_CHANGE,
+        markup: Union[Optional[bool], NoChange] = NO_CHANGE,
+        height: Union[Optional[int], NoChange] = NO_CHANGE,
+    ) -> "ConsoleOptions":
+        """Update values, return a copy."""
+        options = self.copy()
+        if not isinstance(width, NoChange):
+            options.min_width = options.max_width = max(0, width)
+        if not isinstance(min_width, NoChange):
+            options.min_width = min_width
+        if not isinstance(max_width, NoChange):
+            options.max_width = max_width
+        if not isinstance(justify, NoChange):
+            options.justify = justify
+        if not isinstance(overflow, NoChange):
+            options.overflow = overflow
+        if not isinstance(no_wrap, NoChange):
+            options.no_wrap = no_wrap
+        if not isinstance(highlight, NoChange):
+            options.highlight = highlight
+        if not isinstance(markup, NoChange):
+            options.markup = markup
+        if not isinstance(height, NoChange):
+            if height is not None:
+                options.max_height = height
+            options.height = None if height is None else max(0, height)
+        return options
+
+    def update_width(self, width: int) -> "ConsoleOptions":
+        """Update just the width, return a copy.
+
+        Args:
+            width (int): New width (sets both min_width and max_width)
+
+        Returns:
+            ~ConsoleOptions: New console options instance.
+        """
+        options = self.copy()
+        options.min_width = options.max_width = max(0, width)
+        return options
+
+    def update_height(self, height: int) -> "ConsoleOptions":
+        """Update the height, and return a copy.
+
+        Args:
+            height (int): New height
+
+        Returns:
+            ~ConsoleOptions: New Console options instance.
+        """
+        options = self.copy()
+        options.max_height = options.height = height
+        return options
+
+    def reset_height(self) -> "ConsoleOptions":
+        """Return a copy of the options with height set to ``None``.
+
+        Returns:
+            ~ConsoleOptions: New console options instance.
+        """
+        options = self.copy()
+        options.height = None
+        return options
+
+    def update_dimensions(self, width: int, height: int) -> "ConsoleOptions":
+        """Update the width and height, and return a copy.
+
+        Args:
+            width (int): New width (sets both min_width and max_width).
+            height (int): New height.
+
+        Returns:
+            ~ConsoleOptions: New console options instance.
+        """
+        options = self.copy()
+        options.min_width = options.max_width = max(0, width)
+        options.height = options.max_height = height
+        return options
+
+
+@runtime_checkable
+class RichCast(Protocol):
+    """An object that may be 'cast' to a console renderable."""
+
+    def __rich__(
+        self,
+    ) -> Union["ConsoleRenderable", "RichCast", str]:  # pragma: no cover
+        ...
+
+
+@runtime_checkable
+class ConsoleRenderable(Protocol):
+    """An object that supports the console protocol."""
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":  # pragma: no cover
+        ...
+
+
+# A type that may be rendered by Console.
+RenderableType = Union[ConsoleRenderable, RichCast, str]
+"""A string or any object that may be rendered by Rich."""
+
+# The result of calling a __rich_console__ method.
+RenderResult = Iterable[Union[RenderableType, Segment]]
+
+_null_highlighter = NullHighlighter()
+
+
+class CaptureError(Exception):
+    """An error in the Capture context manager."""
+
+
+class NewLine:
+    """A renderable to generate new line(s)"""
+
+    def __init__(self, count: int = 1) -> None:
+        self.count = count
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Iterable[Segment]:
+        yield Segment("\n" * self.count)
+
+
+class ScreenUpdate:
+    """Render a list of lines at a given offset."""
+
+    def __init__(self, lines: List[List[Segment]], x: int, y: int) -> None:
+        self._lines = lines
+        self.x = x
+        self.y = y
+
+    def __rich_console__(
+        self, console: "Console", options: ConsoleOptions
+    ) -> RenderResult:
+        x = self.x
+        move_to = Control.move_to
+        for offset, line in enumerate(self._lines, self.y):
+            yield move_to(x, offset)
+            yield from line
+
+
+class Capture:
+    """Context manager to capture the result of printing to the console.
+    See :meth:`~rich.console.Console.capture` for how to use.
+
+    Args:
+        console (Console): A console instance to capture output.
+    """
+
+    def __init__(self, console: "Console") -> None:
+        self._console = console
+        self._result: Optional[str] = None
+
+    def __enter__(self) -> "Capture":
+        self._console.begin_capture()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self._result = self._console.end_capture()
+
+    def get(self) -> str:
+        """Get the result of the capture."""
+        if self._result is None:
+            raise CaptureError(
+                "Capture result is not available until context manager exits."
+            )
+        return self._result
+
+
+class ThemeContext:
+    """A context manager to use a temporary theme. See :meth:`~rich.console.Console.use_theme` for usage."""
+
+    def __init__(self, console: "Console", theme: Theme, inherit: bool = True) -> None:
+        self.console = console
+        self.theme = theme
+        self.inherit = inherit
+
+    def __enter__(self) -> "ThemeContext":
+        self.console.push_theme(self.theme)
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.console.pop_theme()
+
+
+class PagerContext:
+    """A context manager that 'pages' content. See :meth:`~rich.console.Console.pager` for usage."""
+
+    def __init__(
+        self,
+        console: "Console",
+        pager: Optional[Pager] = None,
+        styles: bool = False,
+        links: bool = False,
+    ) -> None:
+        self._console = console
+        self.pager = SystemPager() if pager is None else pager
+        self.styles = styles
+        self.links = links
+
+    def __enter__(self) -> "PagerContext":
+        self._console._enter_buffer()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        if exc_type is None:
+            with self._console._lock:
+                buffer: List[Segment] = self._console._buffer[:]
+                del self._console._buffer[:]
+                segments: Iterable[Segment] = buffer
+                if not self.styles:
+                    segments = Segment.strip_styles(segments)
+                elif not self.links:
+                    segments = Segment.strip_links(segments)
+                content = self._console._render_buffer(segments)
+            self.pager.show(content)
+        self._console._exit_buffer()
+
+
+class ScreenContext:
+    """A context manager that enables an alternative screen. See :meth:`~rich.console.Console.screen` for usage."""
+
+    def __init__(
+        self, console: "Console", hide_cursor: bool, style: StyleType = ""
+    ) -> None:
+        self.console = console
+        self.hide_cursor = hide_cursor
+        self.screen = Screen(style=style)
+        self._changed = False
+
+    def update(
+        self, *renderables: RenderableType, style: Optional[StyleType] = None
+    ) -> None:
+        """Update the screen.
+
+        Args:
+            renderable (RenderableType, optional): Optional renderable to replace current renderable,
+                or None for no change. Defaults to None.
+            style: (Style, optional): Replacement style, or None for no change. Defaults to None.
+        """
+        if renderables:
+            self.screen.renderable = (
+                Group(*renderables) if len(renderables) > 1 else renderables[0]
+            )
+        if style is not None:
+            self.screen.style = style
+        self.console.print(self.screen, end="")
+
+    def __enter__(self) -> "ScreenContext":
+        self._changed = self.console.set_alt_screen(True)
+        if self._changed and self.hide_cursor:
+            self.console.show_cursor(False)
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        if self._changed:
+            self.console.set_alt_screen(False)
+            if self.hide_cursor:
+                self.console.show_cursor(True)
+
+
+class Group:
+    """Takes a group of renderables and returns a renderable object that renders the group.
+
+    Args:
+        renderables (Iterable[RenderableType]): An iterable of renderable objects.
+        fit (bool, optional): Fit dimension of group to contents, or fill available space. Defaults to True.
+    """
+
+    def __init__(self, *renderables: "RenderableType", fit: bool = True) -> None:
+        self._renderables = renderables
+        self.fit = fit
+        self._render: Optional[List[RenderableType]] = None
+
+    @property
+    def renderables(self) -> List["RenderableType"]:
+        if self._render is None:
+            self._render = list(self._renderables)
+        return self._render
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        if self.fit:
+            return measure_renderables(console, options, self.renderables)
+        else:
+            return Measurement(options.max_width, options.max_width)
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> RenderResult:
+        yield from self.renderables
+
+
+def group(fit: bool = True) -> Callable[..., Callable[..., Group]]:
+    """A decorator that turns an iterable of renderables in to a group.
+
+    Args:
+        fit (bool, optional): Fit dimension of group to contents, or fill available space. Defaults to True.
+    """
+
+    def decorator(
+        method: Callable[..., Iterable[RenderableType]]
+    ) -> Callable[..., Group]:
+        """Convert a method that returns an iterable of renderables in to a Group."""
+
+        @wraps(method)
+        def _replace(*args: Any, **kwargs: Any) -> Group:
+            renderables = method(*args, **kwargs)
+            return Group(*renderables, fit=fit)
+
+        return _replace
+
+    return decorator
+
+
+def _is_jupyter() -> bool:  # pragma: no cover
+    """Check if we're running in a Jupyter notebook."""
+    try:
+        get_ipython  # type: ignore[name-defined]
+    except NameError:
+        return False
+    ipython = get_ipython()  # type: ignore[name-defined]
+    shell = ipython.__class__.__name__
+    if (
+        "google.colab" in str(ipython.__class__)
+        or os.getenv("DATABRICKS_RUNTIME_VERSION")
+        or shell == "ZMQInteractiveShell"
+    ):
+        return True  # Jupyter notebook or qtconsole
+    elif shell == "TerminalInteractiveShell":
+        return False  # Terminal running IPython
+    else:
+        return False  # Other type (?)
+
+
+COLOR_SYSTEMS = {
+    "standard": ColorSystem.STANDARD,
+    "256": ColorSystem.EIGHT_BIT,
+    "truecolor": ColorSystem.TRUECOLOR,
+    "windows": ColorSystem.WINDOWS,
+}
+
+_COLOR_SYSTEMS_NAMES = {system: name for name, system in COLOR_SYSTEMS.items()}
+
+
+@dataclass
+class ConsoleThreadLocals(threading.local):
+    """Thread local values for Console context."""
+
+    theme_stack: ThemeStack
+    buffer: List[Segment] = field(default_factory=list)
+    buffer_index: int = 0
+
+
+class RenderHook(ABC):
+    """Provides hooks in to the render process."""
+
+    @abstractmethod
+    def process_renderables(
+        self, renderables: List[ConsoleRenderable]
+    ) -> List[ConsoleRenderable]:
+        """Called with a list of objects to render.
+
+        This method can return a new list of renderables, or modify and return the same list.
+
+        Args:
+            renderables (List[ConsoleRenderable]): A number of renderable objects.
+
+        Returns:
+            List[ConsoleRenderable]: A replacement list of renderables.
+        """
+
+
+_windows_console_features: Optional["WindowsConsoleFeatures"] = None
+
+
+def get_windows_console_features() -> "WindowsConsoleFeatures":  # pragma: no cover
+    global _windows_console_features
+    if _windows_console_features is not None:
+        return _windows_console_features
+    from ._windows import get_windows_console_features
+
+    _windows_console_features = get_windows_console_features()
+    return _windows_console_features
+
+
+def detect_legacy_windows() -> bool:
+    """Detect legacy Windows."""
+    return WINDOWS and not get_windows_console_features().vt
+
+
+class Console:
+    """A high level console interface.
+
+    Args:
+        color_system (str, optional): The color system supported by your terminal,
+            either ``"standard"``, ``"256"`` or ``"truecolor"``. Leave as ``"auto"`` to autodetect.
+        force_terminal (Optional[bool], optional): Enable/disable terminal control codes, or None to auto-detect terminal. Defaults to None.
+        force_jupyter (Optional[bool], optional): Enable/disable Jupyter rendering, or None to auto-detect Jupyter. Defaults to None.
+        force_interactive (Optional[bool], optional): Enable/disable interactive mode, or None to auto detect. Defaults to None.
+        soft_wrap (Optional[bool], optional): Set soft wrap default on print method. Defaults to False.
+        theme (Theme, optional): An optional style theme object, or ``None`` for default theme.
+        stderr (bool, optional): Use stderr rather than stdout if ``file`` is not specified. Defaults to False.
+        file (IO, optional): A file object where the console should write to. Defaults to stdout.
+        quiet (bool, Optional): Boolean to suppress all output. Defaults to False.
+        width (int, optional): The width of the terminal. Leave as default to auto-detect width.
+        height (int, optional): The height of the terminal. Leave as default to auto-detect height.
+        style (StyleType, optional): Style to apply to all output, or None for no style. Defaults to None.
+        no_color (Optional[bool], optional): Enabled no color mode, or None to auto detect. Defaults to None.
+        tab_size (int, optional): Number of spaces used to replace a tab character. Defaults to 8.
+        record (bool, optional): Boolean to enable recording of terminal output,
+            required to call :meth:`export_html`, :meth:`export_svg`, and :meth:`export_text`. Defaults to False.
+        markup (bool, optional): Boolean to enable :ref:`console_markup`. Defaults to True.
+        emoji (bool, optional): Enable emoji code. Defaults to True.
+        emoji_variant (str, optional): Optional emoji variant, either "text" or "emoji". Defaults to None.
+        highlight (bool, optional): Enable automatic highlighting. Defaults to True.
+        log_time (bool, optional): Boolean to enable logging of time by :meth:`log` methods. Defaults to True.
+        log_path (bool, optional): Boolean to enable the logging of the caller by :meth:`log`. Defaults to True.
+        log_time_format (Union[str, TimeFormatterCallable], optional): If ``log_time`` is enabled, either string for strftime or callable that formats the time. Defaults to "[%X] ".
+        highlighter (HighlighterType, optional): Default highlighter.
+        legacy_windows (bool, optional): Enable legacy Windows mode, or ``None`` to auto detect. Defaults to ``None``.
+        safe_box (bool, optional): Restrict box options that don't render on legacy Windows.
+        get_datetime (Callable[[], datetime], optional): Callable that gets the current time as a datetime.datetime object (used by Console.log),
+            or None for datetime.now.
+        get_time (Callable[[], time], optional): Callable that gets the current time in seconds, default uses time.monotonic.
+    """
+
+    _environ: Mapping[str, str] = os.environ
+
+    def __init__(
+        self,
+        *,
+        color_system: Optional[
+            Literal["auto", "standard", "256", "truecolor", "windows"]
+        ] = "auto",
+        force_terminal: Optional[bool] = None,
+        force_jupyter: Optional[bool] = None,
+        force_interactive: Optional[bool] = None,
+        soft_wrap: bool = False,
+        theme: Optional[Theme] = None,
+        stderr: bool = False,
+        file: Optional[IO[str]] = None,
+        quiet: bool = False,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+        style: Optional[StyleType] = None,
+        no_color: Optional[bool] = None,
+        tab_size: int = 8,
+        record: bool = False,
+        markup: bool = True,
+        emoji: bool = True,
+        emoji_variant: Optional[EmojiVariant] = None,
+        highlight: bool = True,
+        log_time: bool = True,
+        log_path: bool = True,
+        log_time_format: Union[str, FormatTimeCallable] = "[%X]",
+        highlighter: Optional["HighlighterType"] = ReprHighlighter(),
+        legacy_windows: Optional[bool] = None,
+        safe_box: bool = True,
+        get_datetime: Optional[Callable[[], datetime]] = None,
+        get_time: Optional[Callable[[], float]] = None,
+        _environ: Optional[Mapping[str, str]] = None,
+    ):
+        # Copy of os.environ allows us to replace it for testing
+        if _environ is not None:
+            self._environ = _environ
+
+        self.is_jupyter = _is_jupyter() if force_jupyter is None else force_jupyter
+        if self.is_jupyter:
+            if width is None:
+                jupyter_columns = self._environ.get("JUPYTER_COLUMNS")
+                if jupyter_columns is not None and jupyter_columns.isdigit():
+                    width = int(jupyter_columns)
+                else:
+                    width = JUPYTER_DEFAULT_COLUMNS
+            if height is None:
+                jupyter_lines = self._environ.get("JUPYTER_LINES")
+                if jupyter_lines is not None and jupyter_lines.isdigit():
+                    height = int(jupyter_lines)
+                else:
+                    height = JUPYTER_DEFAULT_LINES
+
+        self.tab_size = tab_size
+        self.record = record
+        self._markup = markup
+        self._emoji = emoji
+        self._emoji_variant: Optional[EmojiVariant] = emoji_variant
+        self._highlight = highlight
+        self.legacy_windows: bool = (
+            (detect_legacy_windows() and not self.is_jupyter)
+            if legacy_windows is None
+            else legacy_windows
+        )
+
+        if width is None:
+            columns = self._environ.get("COLUMNS")
+            if columns is not None and columns.isdigit():
+                width = int(columns) - self.legacy_windows
+        if height is None:
+            lines = self._environ.get("LINES")
+            if lines is not None and lines.isdigit():
+                height = int(lines)
+
+        self.soft_wrap = soft_wrap
+        self._width = width
+        self._height = height
+
+        self._color_system: Optional[ColorSystem]
+
+        self._force_terminal = None
+        if force_terminal is not None:
+            self._force_terminal = force_terminal
+
+        self._file = file
+        self.quiet = quiet
+        self.stderr = stderr
+
+        if color_system is None:
+            self._color_system = None
+        elif color_system == "auto":
+            self._color_system = self._detect_color_system()
+        else:
+            self._color_system = COLOR_SYSTEMS[color_system]
+
+        self._lock = threading.RLock()
+        self._log_render = LogRender(
+            show_time=log_time,
+            show_path=log_path,
+            time_format=log_time_format,
+        )
+        self.highlighter: HighlighterType = highlighter or _null_highlighter
+        self.safe_box = safe_box
+        self.get_datetime = get_datetime or datetime.now
+        self.get_time = get_time or monotonic
+        self.style = style
+        self.no_color = (
+            no_color if no_color is not None else "NO_COLOR" in self._environ
+        )
+        self.is_interactive = (
+            (self.is_terminal and not self.is_dumb_terminal)
+            if force_interactive is None
+            else force_interactive
+        )
+
+        self._record_buffer_lock = threading.RLock()
+        self._thread_locals = ConsoleThreadLocals(
+            theme_stack=ThemeStack(themes.DEFAULT if theme is None else theme)
+        )
+        self._record_buffer: List[Segment] = []
+        self._render_hooks: List[RenderHook] = []
+        self._live: Optional["Live"] = None
+        self._is_alt_screen = False
+
+    def __repr__(self) -> str:
+        return f""
+
+    @property
+    def file(self) -> IO[str]:
+        """Get the file object to write to."""
+        file = self._file or (sys.stderr if self.stderr else sys.stdout)
+        file = getattr(file, "rich_proxied_file", file)
+        if file is None:
+            file = NULL_FILE
+        return file
+
+    @file.setter
+    def file(self, new_file: IO[str]) -> None:
+        """Set a new file object."""
+        self._file = new_file
+
+    @property
+    def _buffer(self) -> List[Segment]:
+        """Get a thread local buffer."""
+        return self._thread_locals.buffer
+
+    @property
+    def _buffer_index(self) -> int:
+        """Get a thread local buffer."""
+        return self._thread_locals.buffer_index
+
+    @_buffer_index.setter
+    def _buffer_index(self, value: int) -> None:
+        self._thread_locals.buffer_index = value
+
+    @property
+    def _theme_stack(self) -> ThemeStack:
+        """Get the thread local theme stack."""
+        return self._thread_locals.theme_stack
+
+    def _detect_color_system(self) -> Optional[ColorSystem]:
+        """Detect color system from env vars."""
+        if self.is_jupyter:
+            return ColorSystem.TRUECOLOR
+        if not self.is_terminal or self.is_dumb_terminal:
+            return None
+        if WINDOWS:  # pragma: no cover
+            if self.legacy_windows:  # pragma: no cover
+                return ColorSystem.WINDOWS
+            windows_console_features = get_windows_console_features()
+            return (
+                ColorSystem.TRUECOLOR
+                if windows_console_features.truecolor
+                else ColorSystem.EIGHT_BIT
+            )
+        else:
+            color_term = self._environ.get("COLORTERM", "").strip().lower()
+            if color_term in ("truecolor", "24bit"):
+                return ColorSystem.TRUECOLOR
+            term = self._environ.get("TERM", "").strip().lower()
+            _term_name, _hyphen, colors = term.rpartition("-")
+            color_system = _TERM_COLORS.get(colors, ColorSystem.STANDARD)
+            return color_system
+
+    def _enter_buffer(self) -> None:
+        """Enter in to a buffer context, and buffer all output."""
+        self._buffer_index += 1
+
+    def _exit_buffer(self) -> None:
+        """Leave buffer context, and render content if required."""
+        self._buffer_index -= 1
+        self._check_buffer()
+
+    def set_live(self, live: "Live") -> None:
+        """Set Live instance. Used by Live context manager.
+
+        Args:
+            live (Live): Live instance using this Console.
+
+        Raises:
+            errors.LiveError: If this Console has a Live context currently active.
+        """
+        with self._lock:
+            if self._live is not None:
+                raise errors.LiveError("Only one live display may be active at once")
+            self._live = live
+
+    def clear_live(self) -> None:
+        """Clear the Live instance."""
+        with self._lock:
+            self._live = None
+
+    def push_render_hook(self, hook: RenderHook) -> None:
+        """Add a new render hook to the stack.
+
+        Args:
+            hook (RenderHook): Render hook instance.
+        """
+        with self._lock:
+            self._render_hooks.append(hook)
+
+    def pop_render_hook(self) -> None:
+        """Pop the last renderhook from the stack."""
+        with self._lock:
+            self._render_hooks.pop()
+
+    def __enter__(self) -> "Console":
+        """Own context manager to enter buffer context."""
+        self._enter_buffer()
+        return self
+
+    def __exit__(self, exc_type: Any, exc_value: Any, traceback: Any) -> None:
+        """Exit buffer context."""
+        self._exit_buffer()
+
+    def begin_capture(self) -> None:
+        """Begin capturing console output. Call :meth:`end_capture` to exit capture mode and return output."""
+        self._enter_buffer()
+
+    def end_capture(self) -> str:
+        """End capture mode and return captured string.
+
+        Returns:
+            str: Console output.
+        """
+        render_result = self._render_buffer(self._buffer)
+        del self._buffer[:]
+        self._exit_buffer()
+        return render_result
+
+    def push_theme(self, theme: Theme, *, inherit: bool = True) -> None:
+        """Push a new theme on to the top of the stack, replacing the styles from the previous theme.
+        Generally speaking, you should call :meth:`~rich.console.Console.use_theme` to get a context manager, rather
+        than calling this method directly.
+
+        Args:
+            theme (Theme): A theme instance.
+            inherit (bool, optional): Inherit existing styles. Defaults to True.
+        """
+        self._theme_stack.push_theme(theme, inherit=inherit)
+
+    def pop_theme(self) -> None:
+        """Remove theme from top of stack, restoring previous theme."""
+        self._theme_stack.pop_theme()
+
+    def use_theme(self, theme: Theme, *, inherit: bool = True) -> ThemeContext:
+        """Use a different theme for the duration of the context manager.
+
+        Args:
+            theme (Theme): Theme instance to user.
+            inherit (bool, optional): Inherit existing console styles. Defaults to True.
+
+        Returns:
+            ThemeContext: [description]
+        """
+        return ThemeContext(self, theme, inherit)
+
+    @property
+    def color_system(self) -> Optional[str]:
+        """Get color system string.
+
+        Returns:
+            Optional[str]: "standard", "256" or "truecolor".
+        """
+
+        if self._color_system is not None:
+            return _COLOR_SYSTEMS_NAMES[self._color_system]
+        else:
+            return None
+
+    @property
+    def encoding(self) -> str:
+        """Get the encoding of the console file, e.g. ``"utf-8"``.
+
+        Returns:
+            str: A standard encoding string.
+        """
+        return (getattr(self.file, "encoding", "utf-8") or "utf-8").lower()
+
+    @property
+    def is_terminal(self) -> bool:
+        """Check if the console is writing to a terminal.
+
+        Returns:
+            bool: True if the console writing to a device capable of
+            understanding terminal codes, otherwise False.
+        """
+        if self._force_terminal is not None:
+            return self._force_terminal
+
+        if hasattr(sys.stdin, "__module__") and sys.stdin.__module__.startswith(
+            "idlelib"
+        ):
+            # Return False for Idle which claims to be a tty but can't handle ansi codes
+            return False
+
+        if self.is_jupyter:
+            # return False for Jupyter, which may have FORCE_COLOR set
+            return False
+
+        # If FORCE_COLOR env var has any value at all, we assume a terminal.
+        force_color = self._environ.get("FORCE_COLOR")
+        if force_color is not None:
+            self._force_terminal = True
+            return True
+
+        isatty: Optional[Callable[[], bool]] = getattr(self.file, "isatty", None)
+        try:
+            return False if isatty is None else isatty()
+        except ValueError:
+            # in some situation (at the end of a pytest run for example) isatty() can raise
+            # ValueError: I/O operation on closed file
+            # return False because we aren't in a terminal anymore
+            return False
+
+    @property
+    def is_dumb_terminal(self) -> bool:
+        """Detect dumb terminal.
+
+        Returns:
+            bool: True if writing to a dumb terminal, otherwise False.
+
+        """
+        _term = self._environ.get("TERM", "")
+        is_dumb = _term.lower() in ("dumb", "unknown")
+        return self.is_terminal and is_dumb
+
+    @property
+    def options(self) -> ConsoleOptions:
+        """Get default console options."""
+        return ConsoleOptions(
+            max_height=self.size.height,
+            size=self.size,
+            legacy_windows=self.legacy_windows,
+            min_width=1,
+            max_width=self.width,
+            encoding=self.encoding,
+            is_terminal=self.is_terminal,
+        )
+
+    @property
+    def size(self) -> ConsoleDimensions:
+        """Get the size of the console.
+
+        Returns:
+            ConsoleDimensions: A named tuple containing the dimensions.
+        """
+
+        if self._width is not None and self._height is not None:
+            return ConsoleDimensions(self._width - self.legacy_windows, self._height)
+
+        if self.is_dumb_terminal:
+            return ConsoleDimensions(80, 25)
+
+        width: Optional[int] = None
+        height: Optional[int] = None
+
+        streams = _STD_STREAMS_OUTPUT if WINDOWS else _STD_STREAMS
+        for file_descriptor in streams:
+            try:
+                width, height = os.get_terminal_size(file_descriptor)
+            except (AttributeError, ValueError, OSError):  # Probably not a terminal
+                pass
+            else:
+                break
+
+        columns = self._environ.get("COLUMNS")
+        if columns is not None and columns.isdigit():
+            width = int(columns)
+        lines = self._environ.get("LINES")
+        if lines is not None and lines.isdigit():
+            height = int(lines)
+
+        # get_terminal_size can report 0, 0 if run from pseudo-terminal
+        width = width or 80
+        height = height or 25
+        return ConsoleDimensions(
+            width - self.legacy_windows if self._width is None else self._width,
+            height if self._height is None else self._height,
+        )
+
+    @size.setter
+    def size(self, new_size: Tuple[int, int]) -> None:
+        """Set a new size for the terminal.
+
+        Args:
+            new_size (Tuple[int, int]): New width and height.
+        """
+        width, height = new_size
+        self._width = width
+        self._height = height
+
+    @property
+    def width(self) -> int:
+        """Get the width of the console.
+
+        Returns:
+            int: The width (in characters) of the console.
+        """
+        return self.size.width
+
+    @width.setter
+    def width(self, width: int) -> None:
+        """Set width.
+
+        Args:
+            width (int): New width.
+        """
+        self._width = width
+
+    @property
+    def height(self) -> int:
+        """Get the height of the console.
+
+        Returns:
+            int: The height (in lines) of the console.
+        """
+        return self.size.height
+
+    @height.setter
+    def height(self, height: int) -> None:
+        """Set height.
+
+        Args:
+            height (int): new height.
+        """
+        self._height = height
+
+    def bell(self) -> None:
+        """Play a 'bell' sound (if supported by the terminal)."""
+        self.control(Control.bell())
+
+    def capture(self) -> Capture:
+        """A context manager to *capture* the result of print() or log() in a string,
+        rather than writing it to the console.
+
+        Example:
+            >>> from rich.console import Console
+            >>> console = Console()
+            >>> with console.capture() as capture:
+            ...     console.print("[bold magenta]Hello World[/]")
+            >>> print(capture.get())
+
+        Returns:
+            Capture: Context manager with disables writing to the terminal.
+        """
+        capture = Capture(self)
+        return capture
+
+    def pager(
+        self, pager: Optional[Pager] = None, styles: bool = False, links: bool = False
+    ) -> PagerContext:
+        """A context manager to display anything printed within a "pager". The pager application
+        is defined by the system and will typically support at least pressing a key to scroll.
+
+        Args:
+            pager (Pager, optional): A pager object, or None to use :class:`~rich.pager.SystemPager`. Defaults to None.
+            styles (bool, optional): Show styles in pager. Defaults to False.
+            links (bool, optional): Show links in pager. Defaults to False.
+
+        Example:
+            >>> from rich.console import Console
+            >>> from rich.__main__ import make_test_card
+            >>> console = Console()
+            >>> with console.pager():
+                    console.print(make_test_card())
+
+        Returns:
+            PagerContext: A context manager.
+        """
+        return PagerContext(self, pager=pager, styles=styles, links=links)
+
+    def line(self, count: int = 1) -> None:
+        """Write new line(s).
+
+        Args:
+            count (int, optional): Number of new lines. Defaults to 1.
+        """
+
+        assert count >= 0, "count must be >= 0"
+        self.print(NewLine(count))
+
+    def clear(self, home: bool = True) -> None:
+        """Clear the screen.
+
+        Args:
+            home (bool, optional): Also move the cursor to 'home' position. Defaults to True.
+        """
+        if home:
+            self.control(Control.clear(), Control.home())
+        else:
+            self.control(Control.clear())
+
+    def status(
+        self,
+        status: RenderableType,
+        *,
+        spinner: str = "dots",
+        spinner_style: StyleType = "status.spinner",
+        speed: float = 1.0,
+        refresh_per_second: float = 12.5,
+    ) -> "Status":
+        """Display a status and spinner.
+
+        Args:
+            status (RenderableType): A status renderable (str or Text typically).
+            spinner (str, optional): Name of spinner animation (see python -m rich.spinner). Defaults to "dots".
+            spinner_style (StyleType, optional): Style of spinner. Defaults to "status.spinner".
+            speed (float, optional): Speed factor for spinner animation. Defaults to 1.0.
+            refresh_per_second (float, optional): Number of refreshes per second. Defaults to 12.5.
+
+        Returns:
+            Status: A Status object that may be used as a context manager.
+        """
+        from .status import Status
+
+        status_renderable = Status(
+            status,
+            console=self,
+            spinner=spinner,
+            spinner_style=spinner_style,
+            speed=speed,
+            refresh_per_second=refresh_per_second,
+        )
+        return status_renderable
+
+    def show_cursor(self, show: bool = True) -> bool:
+        """Show or hide the cursor.
+
+        Args:
+            show (bool, optional): Set visibility of the cursor.
+        """
+        if self.is_terminal:
+            self.control(Control.show_cursor(show))
+            return True
+        return False
+
+    def set_alt_screen(self, enable: bool = True) -> bool:
+        """Enables alternative screen mode.
+
+        Note, if you enable this mode, you should ensure that is disabled before
+        the application exits. See :meth:`~rich.Console.screen` for a context manager
+        that handles this for you.
+
+        Args:
+            enable (bool, optional): Enable (True) or disable (False) alternate screen. Defaults to True.
+
+        Returns:
+            bool: True if the control codes were written.
+
+        """
+        changed = False
+        if self.is_terminal and not self.legacy_windows:
+            self.control(Control.alt_screen(enable))
+            changed = True
+            self._is_alt_screen = enable
+        return changed
+
+    @property
+    def is_alt_screen(self) -> bool:
+        """Check if the alt screen was enabled.
+
+        Returns:
+            bool: True if the alt screen was enabled, otherwise False.
+        """
+        return self._is_alt_screen
+
+    def set_window_title(self, title: str) -> bool:
+        """Set the title of the console terminal window.
+
+        Warning: There is no means within Rich of "resetting" the window title to its
+        previous value, meaning the title you set will persist even after your application
+        exits.
+
+        ``fish`` shell resets the window title before and after each command by default,
+        negating this issue. Windows Terminal and command prompt will also reset the title for you.
+        Most other shells and terminals, however, do not do this.
+
+        Some terminals may require configuration changes before you can set the title.
+        Some terminals may not support setting the title at all.
+
+        Other software (including the terminal itself, the shell, custom prompts, plugins, etc.)
+        may also set the terminal window title. This could result in whatever value you write
+        using this method being overwritten.
+
+        Args:
+            title (str): The new title of the terminal window.
+
+        Returns:
+            bool: True if the control code to change the terminal title was
+                written, otherwise False. Note that a return value of True
+                does not guarantee that the window title has actually changed,
+                since the feature may be unsupported/disabled in some terminals.
+        """
+        if self.is_terminal:
+            self.control(Control.title(title))
+            return True
+        return False
+
+    def screen(
+        self, hide_cursor: bool = True, style: Optional[StyleType] = None
+    ) -> "ScreenContext":
+        """Context manager to enable and disable 'alternative screen' mode.
+
+        Args:
+            hide_cursor (bool, optional): Also hide the cursor. Defaults to False.
+            style (Style, optional): Optional style for screen. Defaults to None.
+
+        Returns:
+            ~ScreenContext: Context which enables alternate screen on enter, and disables it on exit.
+        """
+        return ScreenContext(self, hide_cursor=hide_cursor, style=style or "")
+
+    def measure(
+        self, renderable: RenderableType, *, options: Optional[ConsoleOptions] = None
+    ) -> Measurement:
+        """Measure a renderable. Returns a :class:`~rich.measure.Measurement` object which contains
+        information regarding the number of characters required to print the renderable.
+
+        Args:
+            renderable (RenderableType): Any renderable or string.
+            options (Optional[ConsoleOptions], optional): Options to use when measuring, or None
+                to use default options. Defaults to None.
+
+        Returns:
+            Measurement: A measurement of the renderable.
+        """
+        measurement = Measurement.get(self, options or self.options, renderable)
+        return measurement
+
+    def render(
+        self, renderable: RenderableType, options: Optional[ConsoleOptions] = None
+    ) -> Iterable[Segment]:
+        """Render an object in to an iterable of `Segment` instances.
+
+        This method contains the logic for rendering objects with the console protocol.
+        You are unlikely to need to use it directly, unless you are extending the library.
+
+        Args:
+            renderable (RenderableType): An object supporting the console protocol, or
+                an object that may be converted to a string.
+            options (ConsoleOptions, optional): An options object, or None to use self.options. Defaults to None.
+
+        Returns:
+            Iterable[Segment]: An iterable of segments that may be rendered.
+        """
+
+        _options = options or self.options
+        if _options.max_width < 1:
+            # No space to render anything. This prevents potential recursion errors.
+            return
+        render_iterable: RenderResult
+
+        renderable = rich_cast(renderable)
+        if hasattr(renderable, "__rich_console__") and not isclass(renderable):
+            render_iterable = renderable.__rich_console__(self, _options)
+        elif isinstance(renderable, str):
+            text_renderable = self.render_str(
+                renderable, highlight=_options.highlight, markup=_options.markup
+            )
+            render_iterable = text_renderable.__rich_console__(self, _options)
+        else:
+            raise errors.NotRenderableError(
+                f"Unable to render {renderable!r}; "
+                "A str, Segment or object with __rich_console__ method is required"
+            )
+
+        try:
+            iter_render = iter(render_iterable)
+        except TypeError:
+            raise errors.NotRenderableError(
+                f"object {render_iterable!r} is not renderable"
+            )
+        _Segment = Segment
+        _options = _options.reset_height()
+        for render_output in iter_render:
+            if isinstance(render_output, _Segment):
+                yield render_output
+            else:
+                yield from self.render(render_output, _options)
+
+    def render_lines(
+        self,
+        renderable: RenderableType,
+        options: Optional[ConsoleOptions] = None,
+        *,
+        style: Optional[Style] = None,
+        pad: bool = True,
+        new_lines: bool = False,
+    ) -> List[List[Segment]]:
+        """Render objects in to a list of lines.
+
+        The output of render_lines is useful when further formatting of rendered console text
+        is required, such as the Panel class which draws a border around any renderable object.
+
+        Args:
+            renderable (RenderableType): Any object renderable in the console.
+            options (Optional[ConsoleOptions], optional): Console options, or None to use self.options. Default to ``None``.
+            style (Style, optional): Optional style to apply to renderables. Defaults to ``None``.
+            pad (bool, optional): Pad lines shorter than render width. Defaults to ``True``.
+            new_lines (bool, optional): Include "\n" characters at end of lines.
+
+        Returns:
+            List[List[Segment]]: A list of lines, where a line is a list of Segment objects.
+        """
+        with self._lock:
+            render_options = options or self.options
+            _rendered = self.render(renderable, render_options)
+            if style:
+                _rendered = Segment.apply_style(_rendered, style)
+
+            render_height = render_options.height
+            if render_height is not None:
+                render_height = max(0, render_height)
+
+            lines = list(
+                islice(
+                    Segment.split_and_crop_lines(
+                        _rendered,
+                        render_options.max_width,
+                        include_new_lines=new_lines,
+                        pad=pad,
+                        style=style,
+                    ),
+                    None,
+                    render_height,
+                )
+            )
+            if render_options.height is not None:
+                extra_lines = render_options.height - len(lines)
+                if extra_lines > 0:
+                    pad_line = [
+                        (
+                            [
+                                Segment(" " * render_options.max_width, style),
+                                Segment("\n"),
+                            ]
+                            if new_lines
+                            else [Segment(" " * render_options.max_width, style)]
+                        )
+                    ]
+                    lines.extend(pad_line * extra_lines)
+
+            return lines
+
+    def render_str(
+        self,
+        text: str,
+        *,
+        style: Union[str, Style] = "",
+        justify: Optional[JustifyMethod] = None,
+        overflow: Optional[OverflowMethod] = None,
+        emoji: Optional[bool] = None,
+        markup: Optional[bool] = None,
+        highlight: Optional[bool] = None,
+        highlighter: Optional[HighlighterType] = None,
+    ) -> "Text":
+        """Convert a string to a Text instance. This is called automatically if
+        you print or log a string.
+
+        Args:
+            text (str): Text to render.
+            style (Union[str, Style], optional): Style to apply to rendered text.
+            justify (str, optional): Justify method: "default", "left", "center", "full", or "right". Defaults to ``None``.
+            overflow (str, optional): Overflow method: "crop", "fold", or "ellipsis". Defaults to ``None``.
+            emoji (Optional[bool], optional): Enable emoji, or ``None`` to use Console default.
+            markup (Optional[bool], optional): Enable markup, or ``None`` to use Console default.
+            highlight (Optional[bool], optional): Enable highlighting, or ``None`` to use Console default.
+            highlighter (HighlighterType, optional): Optional highlighter to apply.
+        Returns:
+            ConsoleRenderable: Renderable object.
+
+        """
+        emoji_enabled = emoji or (emoji is None and self._emoji)
+        markup_enabled = markup or (markup is None and self._markup)
+        highlight_enabled = highlight or (highlight is None and self._highlight)
+
+        if markup_enabled:
+            rich_text = render_markup(
+                text,
+                style=style,
+                emoji=emoji_enabled,
+                emoji_variant=self._emoji_variant,
+            )
+            rich_text.justify = justify
+            rich_text.overflow = overflow
+        else:
+            rich_text = Text(
+                (
+                    _emoji_replace(text, default_variant=self._emoji_variant)
+                    if emoji_enabled
+                    else text
+                ),
+                justify=justify,
+                overflow=overflow,
+                style=style,
+            )
+
+        _highlighter = (highlighter or self.highlighter) if highlight_enabled else None
+        if _highlighter is not None:
+            highlight_text = _highlighter(str(rich_text))
+            highlight_text.copy_styles(rich_text)
+            return highlight_text
+
+        return rich_text
+
+    def get_style(
+        self, name: Union[str, Style], *, default: Optional[Union[Style, str]] = None
+    ) -> Style:
+        """Get a Style instance by its theme name or parse a definition.
+
+        Args:
+            name (str): The name of a style or a style definition.
+
+        Returns:
+            Style: A Style object.
+
+        Raises:
+            MissingStyle: If no style could be parsed from name.
+
+        """
+        if isinstance(name, Style):
+            return name
+
+        try:
+            style = self._theme_stack.get(name)
+            if style is None:
+                style = Style.parse(name)
+            return style.copy() if style.link else style
+        except errors.StyleSyntaxError as error:
+            if default is not None:
+                return self.get_style(default)
+            raise errors.MissingStyle(
+                f"Failed to get style {name!r}; {error}"
+            ) from None
+
+    def _collect_renderables(
+        self,
+        objects: Iterable[Any],
+        sep: str,
+        end: str,
+        *,
+        justify: Optional[JustifyMethod] = None,
+        emoji: Optional[bool] = None,
+        markup: Optional[bool] = None,
+        highlight: Optional[bool] = None,
+    ) -> List[ConsoleRenderable]:
+        """Combine a number of renderables and text into one renderable.
+
+        Args:
+            objects (Iterable[Any]): Anything that Rich can render.
+            sep (str): String to write between print data.
+            end (str): String to write at end of print data.
+            justify (str, optional): One of "left", "right", "center", or "full". Defaults to ``None``.
+            emoji (Optional[bool], optional): Enable emoji code, or ``None`` to use console default.
+            markup (Optional[bool], optional): Enable markup, or ``None`` to use console default.
+            highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default.
+
+        Returns:
+            List[ConsoleRenderable]: A list of things to render.
+        """
+        renderables: List[ConsoleRenderable] = []
+        _append = renderables.append
+        text: List[Text] = []
+        append_text = text.append
+
+        append = _append
+        if justify in ("left", "center", "right"):
+
+            def align_append(renderable: RenderableType) -> None:
+                _append(Align(renderable, cast(AlignMethod, justify)))
+
+            append = align_append
+
+        _highlighter: HighlighterType = _null_highlighter
+        if highlight or (highlight is None and self._highlight):
+            _highlighter = self.highlighter
+
+        def check_text() -> None:
+            if text:
+                sep_text = Text(sep, justify=justify, end=end)
+                append(sep_text.join(text))
+                text.clear()
+
+        for renderable in objects:
+            renderable = rich_cast(renderable)
+            if isinstance(renderable, str):
+                append_text(
+                    self.render_str(
+                        renderable,
+                        emoji=emoji,
+                        markup=markup,
+                        highlight=highlight,
+                        highlighter=_highlighter,
+                    )
+                )
+            elif isinstance(renderable, Text):
+                append_text(renderable)
+            elif isinstance(renderable, ConsoleRenderable):
+                check_text()
+                append(renderable)
+            elif is_expandable(renderable):
+                check_text()
+                append(Pretty(renderable, highlighter=_highlighter))
+            else:
+                append_text(_highlighter(str(renderable)))
+
+        check_text()
+
+        if self.style is not None:
+            style = self.get_style(self.style)
+            renderables = [Styled(renderable, style) for renderable in renderables]
+
+        return renderables
+
+    def rule(
+        self,
+        title: TextType = "",
+        *,
+        characters: str = "─",
+        style: Union[str, Style] = "rule.line",
+        align: AlignMethod = "center",
+    ) -> None:
+        """Draw a line with optional centered title.
+
+        Args:
+            title (str, optional): Text to render over the rule. Defaults to "".
+            characters (str, optional): Character(s) to form the line. Defaults to "─".
+            style (str, optional): Style of line. Defaults to "rule.line".
+            align (str, optional): How to align the title, one of "left", "center", or "right". Defaults to "center".
+        """
+        from .rule import Rule
+
+        rule = Rule(title=title, characters=characters, style=style, align=align)
+        self.print(rule)
+
+    def control(self, *control: Control) -> None:
+        """Insert non-printing control codes.
+
+        Args:
+            control_codes (str): Control codes, such as those that may move the cursor.
+        """
+        if not self.is_dumb_terminal:
+            with self:
+                self._buffer.extend(_control.segment for _control in control)
+
+    def out(
+        self,
+        *objects: Any,
+        sep: str = " ",
+        end: str = "\n",
+        style: Optional[Union[str, Style]] = None,
+        highlight: Optional[bool] = None,
+    ) -> None:
+        """Output to the terminal. This is a low-level way of writing to the terminal which unlike
+        :meth:`~rich.console.Console.print` won't pretty print, wrap text, or apply markup, but will
+        optionally apply highlighting and a basic style.
+
+        Args:
+            sep (str, optional): String to write between print data. Defaults to " ".
+            end (str, optional): String to write at end of print data. Defaults to "\\\\n".
+            style (Union[str, Style], optional): A style to apply to output. Defaults to None.
+            highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use
+                console default. Defaults to ``None``.
+        """
+        raw_output: str = sep.join(str(_object) for _object in objects)
+        self.print(
+            raw_output,
+            style=style,
+            highlight=highlight,
+            emoji=False,
+            markup=False,
+            no_wrap=True,
+            overflow="ignore",
+            crop=False,
+            end=end,
+        )
+
+    def print(
+        self,
+        *objects: Any,
+        sep: str = " ",
+        end: str = "\n",
+        style: Optional[Union[str, Style]] = None,
+        justify: Optional[JustifyMethod] = None,
+        overflow: Optional[OverflowMethod] = None,
+        no_wrap: Optional[bool] = None,
+        emoji: Optional[bool] = None,
+        markup: Optional[bool] = None,
+        highlight: Optional[bool] = None,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+        crop: bool = True,
+        soft_wrap: Optional[bool] = None,
+        new_line_start: bool = False,
+    ) -> None:
+        """Print to the console.
+
+        Args:
+            objects (positional args): Objects to log to the terminal.
+            sep (str, optional): String to write between print data. Defaults to " ".
+            end (str, optional): String to write at end of print data. Defaults to "\\\\n".
+            style (Union[str, Style], optional): A style to apply to output. Defaults to None.
+            justify (str, optional): Justify method: "default", "left", "right", "center", or "full". Defaults to ``None``.
+            overflow (str, optional): Overflow method: "ignore", "crop", "fold", or "ellipsis". Defaults to None.
+            no_wrap (Optional[bool], optional): Disable word wrapping. Defaults to None.
+            emoji (Optional[bool], optional): Enable emoji code, or ``None`` to use console default. Defaults to ``None``.
+            markup (Optional[bool], optional): Enable markup, or ``None`` to use console default. Defaults to ``None``.
+            highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default. Defaults to ``None``.
+            width (Optional[int], optional): Width of output, or ``None`` to auto-detect. Defaults to ``None``.
+            crop (Optional[bool], optional): Crop output to width of terminal. Defaults to True.
+            soft_wrap (bool, optional): Enable soft wrap mode which disables word wrapping and cropping of text or ``None`` for
+                Console default. Defaults to ``None``.
+            new_line_start (bool, False): Insert a new line at the start if the output contains more than one line. Defaults to ``False``.
+        """
+        if not objects:
+            objects = (NewLine(),)
+
+        if soft_wrap is None:
+            soft_wrap = self.soft_wrap
+        if soft_wrap:
+            if no_wrap is None:
+                no_wrap = True
+            if overflow is None:
+                overflow = "ignore"
+            crop = False
+        render_hooks = self._render_hooks[:]
+        with self:
+            renderables = self._collect_renderables(
+                objects,
+                sep,
+                end,
+                justify=justify,
+                emoji=emoji,
+                markup=markup,
+                highlight=highlight,
+            )
+            for hook in render_hooks:
+                renderables = hook.process_renderables(renderables)
+            render_options = self.options.update(
+                justify=justify,
+                overflow=overflow,
+                width=min(width, self.width) if width is not None else NO_CHANGE,
+                height=height,
+                no_wrap=no_wrap,
+                markup=markup,
+                highlight=highlight,
+            )
+
+            new_segments: List[Segment] = []
+            extend = new_segments.extend
+            render = self.render
+            if style is None:
+                for renderable in renderables:
+                    extend(render(renderable, render_options))
+            else:
+                for renderable in renderables:
+                    extend(
+                        Segment.apply_style(
+                            render(renderable, render_options), self.get_style(style)
+                        )
+                    )
+            if new_line_start:
+                if (
+                    len("".join(segment.text for segment in new_segments).splitlines())
+                    > 1
+                ):
+                    new_segments.insert(0, Segment.line())
+            if crop:
+                buffer_extend = self._buffer.extend
+                for line in Segment.split_and_crop_lines(
+                    new_segments, self.width, pad=False
+                ):
+                    buffer_extend(line)
+            else:
+                self._buffer.extend(new_segments)
+
+    def print_json(
+        self,
+        json: Optional[str] = None,
+        *,
+        data: Any = None,
+        indent: Union[None, int, str] = 2,
+        highlight: bool = True,
+        skip_keys: bool = False,
+        ensure_ascii: bool = False,
+        check_circular: bool = True,
+        allow_nan: bool = True,
+        default: Optional[Callable[[Any], Any]] = None,
+        sort_keys: bool = False,
+    ) -> None:
+        """Pretty prints JSON. Output will be valid JSON.
+
+        Args:
+            json (Optional[str]): A string containing JSON.
+            data (Any): If json is not supplied, then encode this data.
+            indent (Union[None, int, str], optional): Number of spaces to indent. Defaults to 2.
+            highlight (bool, optional): Enable highlighting of output: Defaults to True.
+            skip_keys (bool, optional): Skip keys not of a basic type. Defaults to False.
+            ensure_ascii (bool, optional): Escape all non-ascii characters. Defaults to False.
+            check_circular (bool, optional): Check for circular references. Defaults to True.
+            allow_nan (bool, optional): Allow NaN and Infinity values. Defaults to True.
+            default (Callable, optional): A callable that converts values that can not be encoded
+                in to something that can be JSON encoded. Defaults to None.
+            sort_keys (bool, optional): Sort dictionary keys. Defaults to False.
+        """
+        from pip._vendor.rich.json import JSON
+
+        if json is None:
+            json_renderable = JSON.from_data(
+                data,
+                indent=indent,
+                highlight=highlight,
+                skip_keys=skip_keys,
+                ensure_ascii=ensure_ascii,
+                check_circular=check_circular,
+                allow_nan=allow_nan,
+                default=default,
+                sort_keys=sort_keys,
+            )
+        else:
+            if not isinstance(json, str):
+                raise TypeError(
+                    f"json must be str. Did you mean print_json(data={json!r}) ?"
+                )
+            json_renderable = JSON(
+                json,
+                indent=indent,
+                highlight=highlight,
+                skip_keys=skip_keys,
+                ensure_ascii=ensure_ascii,
+                check_circular=check_circular,
+                allow_nan=allow_nan,
+                default=default,
+                sort_keys=sort_keys,
+            )
+        self.print(json_renderable, soft_wrap=True)
+
+    def update_screen(
+        self,
+        renderable: RenderableType,
+        *,
+        region: Optional[Region] = None,
+        options: Optional[ConsoleOptions] = None,
+    ) -> None:
+        """Update the screen at a given offset.
+
+        Args:
+            renderable (RenderableType): A Rich renderable.
+            region (Region, optional): Region of screen to update, or None for entire screen. Defaults to None.
+            x (int, optional): x offset. Defaults to 0.
+            y (int, optional): y offset. Defaults to 0.
+
+        Raises:
+            errors.NoAltScreen: If the Console isn't in alt screen mode.
+
+        """
+        if not self.is_alt_screen:
+            raise errors.NoAltScreen("Alt screen must be enabled to call update_screen")
+        render_options = options or self.options
+        if region is None:
+            x = y = 0
+            render_options = render_options.update_dimensions(
+                render_options.max_width, render_options.height or self.height
+            )
+        else:
+            x, y, width, height = region
+            render_options = render_options.update_dimensions(width, height)
+
+        lines = self.render_lines(renderable, options=render_options)
+        self.update_screen_lines(lines, x, y)
+
+    def update_screen_lines(
+        self, lines: List[List[Segment]], x: int = 0, y: int = 0
+    ) -> None:
+        """Update lines of the screen at a given offset.
+
+        Args:
+            lines (List[List[Segment]]): Rendered lines (as produced by :meth:`~rich.Console.render_lines`).
+            x (int, optional): x offset (column no). Defaults to 0.
+            y (int, optional): y offset (column no). Defaults to 0.
+
+        Raises:
+            errors.NoAltScreen: If the Console isn't in alt screen mode.
+        """
+        if not self.is_alt_screen:
+            raise errors.NoAltScreen("Alt screen must be enabled to call update_screen")
+        screen_update = ScreenUpdate(lines, x, y)
+        segments = self.render(screen_update)
+        self._buffer.extend(segments)
+        self._check_buffer()
+
+    def print_exception(
+        self,
+        *,
+        width: Optional[int] = 100,
+        extra_lines: int = 3,
+        theme: Optional[str] = None,
+        word_wrap: bool = False,
+        show_locals: bool = False,
+        suppress: Iterable[Union[str, ModuleType]] = (),
+        max_frames: int = 100,
+    ) -> None:
+        """Prints a rich render of the last exception and traceback.
+
+        Args:
+            width (Optional[int], optional): Number of characters used to render code. Defaults to 100.
+            extra_lines (int, optional): Additional lines of code to render. Defaults to 3.
+            theme (str, optional): Override pygments theme used in traceback
+            word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False.
+            show_locals (bool, optional): Enable display of local variables. Defaults to False.
+            suppress (Iterable[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
+            max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
+        """
+        from .traceback import Traceback
+
+        traceback = Traceback(
+            width=width,
+            extra_lines=extra_lines,
+            theme=theme,
+            word_wrap=word_wrap,
+            show_locals=show_locals,
+            suppress=suppress,
+            max_frames=max_frames,
+        )
+        self.print(traceback)
+
+    @staticmethod
+    def _caller_frame_info(
+        offset: int,
+        currentframe: Callable[[], Optional[FrameType]] = inspect.currentframe,
+    ) -> Tuple[str, int, Dict[str, Any]]:
+        """Get caller frame information.
+
+        Args:
+            offset (int): the caller offset within the current frame stack.
+            currentframe (Callable[[], Optional[FrameType]], optional): the callable to use to
+                retrieve the current frame. Defaults to ``inspect.currentframe``.
+
+        Returns:
+            Tuple[str, int, Dict[str, Any]]: A tuple containing the filename, the line number and
+                the dictionary of local variables associated with the caller frame.
+
+        Raises:
+            RuntimeError: If the stack offset is invalid.
+        """
+        # Ignore the frame of this local helper
+        offset += 1
+
+        frame = currentframe()
+        if frame is not None:
+            # Use the faster currentframe where implemented
+            while offset and frame is not None:
+                frame = frame.f_back
+                offset -= 1
+            assert frame is not None
+            return frame.f_code.co_filename, frame.f_lineno, frame.f_locals
+        else:
+            # Fallback to the slower stack
+            frame_info = inspect.stack()[offset]
+            return frame_info.filename, frame_info.lineno, frame_info.frame.f_locals
+
+    def log(
+        self,
+        *objects: Any,
+        sep: str = " ",
+        end: str = "\n",
+        style: Optional[Union[str, Style]] = None,
+        justify: Optional[JustifyMethod] = None,
+        emoji: Optional[bool] = None,
+        markup: Optional[bool] = None,
+        highlight: Optional[bool] = None,
+        log_locals: bool = False,
+        _stack_offset: int = 1,
+    ) -> None:
+        """Log rich content to the terminal.
+
+        Args:
+            objects (positional args): Objects to log to the terminal.
+            sep (str, optional): String to write between print data. Defaults to " ".
+            end (str, optional): String to write at end of print data. Defaults to "\\\\n".
+            style (Union[str, Style], optional): A style to apply to output. Defaults to None.
+            justify (str, optional): One of "left", "right", "center", or "full". Defaults to ``None``.
+            emoji (Optional[bool], optional): Enable emoji code, or ``None`` to use console default. Defaults to None.
+            markup (Optional[bool], optional): Enable markup, or ``None`` to use console default. Defaults to None.
+            highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default. Defaults to None.
+            log_locals (bool, optional): Boolean to enable logging of locals where ``log()``
+                was called. Defaults to False.
+            _stack_offset (int, optional): Offset of caller from end of call stack. Defaults to 1.
+        """
+        if not objects:
+            objects = (NewLine(),)
+
+        render_hooks = self._render_hooks[:]
+
+        with self:
+            renderables = self._collect_renderables(
+                objects,
+                sep,
+                end,
+                justify=justify,
+                emoji=emoji,
+                markup=markup,
+                highlight=highlight,
+            )
+            if style is not None:
+                renderables = [Styled(renderable, style) for renderable in renderables]
+
+            filename, line_no, locals = self._caller_frame_info(_stack_offset)
+            link_path = None if filename.startswith("<") else os.path.abspath(filename)
+            path = filename.rpartition(os.sep)[-1]
+            if log_locals:
+                locals_map = {
+                    key: value
+                    for key, value in locals.items()
+                    if not key.startswith("__")
+                }
+                renderables.append(render_scope(locals_map, title="[i]locals"))
+
+            renderables = [
+                self._log_render(
+                    self,
+                    renderables,
+                    log_time=self.get_datetime(),
+                    path=path,
+                    line_no=line_no,
+                    link_path=link_path,
+                )
+            ]
+            for hook in render_hooks:
+                renderables = hook.process_renderables(renderables)
+            new_segments: List[Segment] = []
+            extend = new_segments.extend
+            render = self.render
+            render_options = self.options
+            for renderable in renderables:
+                extend(render(renderable, render_options))
+            buffer_extend = self._buffer.extend
+            for line in Segment.split_and_crop_lines(
+                new_segments, self.width, pad=False
+            ):
+                buffer_extend(line)
+
+    def on_broken_pipe(self) -> None:
+        """This function is called when a `BrokenPipeError` is raised.
+
+        This can occur when piping Textual output in Linux and macOS.
+        The default implementation is to exit the app, but you could implement
+        this method in a subclass to change the behavior.
+
+        See https://docs.python.org/3/library/signal.html#note-on-sigpipe for details.
+        """
+        self.quiet = True
+        devnull = os.open(os.devnull, os.O_WRONLY)
+        os.dup2(devnull, sys.stdout.fileno())
+        raise SystemExit(1)
+
+    def _check_buffer(self) -> None:
+        """Check if the buffer may be rendered. Render it if it can (e.g. Console.quiet is False)
+        Rendering is supported on Windows, Unix and Jupyter environments. For
+        legacy Windows consoles, the win32 API is called directly.
+        This method will also record what it renders if recording is enabled via Console.record.
+        """
+        if self.quiet:
+            del self._buffer[:]
+            return
+
+        try:
+            self._write_buffer()
+        except BrokenPipeError:
+            self.on_broken_pipe()
+
+    def _write_buffer(self) -> None:
+        """Write the buffer to the output file."""
+
+        with self._lock:
+            if self.record and not self._buffer_index:
+                with self._record_buffer_lock:
+                    self._record_buffer.extend(self._buffer[:])
+
+            if self._buffer_index == 0:
+                if self.is_jupyter:  # pragma: no cover
+                    from .jupyter import display
+
+                    display(self._buffer, self._render_buffer(self._buffer[:]))
+                    del self._buffer[:]
+                else:
+                    if WINDOWS:
+                        use_legacy_windows_render = False
+                        if self.legacy_windows:
+                            fileno = get_fileno(self.file)
+                            if fileno is not None:
+                                use_legacy_windows_render = (
+                                    fileno in _STD_STREAMS_OUTPUT
+                                )
+
+                        if use_legacy_windows_render:
+                            from pip._vendor.rich._win32_console import LegacyWindowsTerm
+                            from pip._vendor.rich._windows_renderer import legacy_windows_render
+
+                            buffer = self._buffer[:]
+                            if self.no_color and self._color_system:
+                                buffer = list(Segment.remove_color(buffer))
+
+                            legacy_windows_render(buffer, LegacyWindowsTerm(self.file))
+                        else:
+                            # Either a non-std stream on legacy Windows, or modern Windows.
+                            text = self._render_buffer(self._buffer[:])
+                            # https://bugs.python.org/issue37871
+                            # https://github.com/python/cpython/issues/82052
+                            # We need to avoid writing more than 32Kb in a single write, due to the above bug
+                            write = self.file.write
+                            # Worse case scenario, every character is 4 bytes of utf-8
+                            MAX_WRITE = 32 * 1024 // 4
+                            try:
+                                if len(text) <= MAX_WRITE:
+                                    write(text)
+                                else:
+                                    batch: List[str] = []
+                                    batch_append = batch.append
+                                    size = 0
+                                    for line in text.splitlines(True):
+                                        if size + len(line) > MAX_WRITE and batch:
+                                            write("".join(batch))
+                                            batch.clear()
+                                            size = 0
+                                        batch_append(line)
+                                        size += len(line)
+                                    if batch:
+                                        write("".join(batch))
+                                        batch.clear()
+                            except UnicodeEncodeError as error:
+                                error.reason = f"{error.reason}\n*** You may need to add PYTHONIOENCODING=utf-8 to your environment ***"
+                                raise
+                    else:
+                        text = self._render_buffer(self._buffer[:])
+                        try:
+                            self.file.write(text)
+                        except UnicodeEncodeError as error:
+                            error.reason = f"{error.reason}\n*** You may need to add PYTHONIOENCODING=utf-8 to your environment ***"
+                            raise
+
+                    self.file.flush()
+                    del self._buffer[:]
+
+    def _render_buffer(self, buffer: Iterable[Segment]) -> str:
+        """Render buffered output, and clear buffer."""
+        output: List[str] = []
+        append = output.append
+        color_system = self._color_system
+        legacy_windows = self.legacy_windows
+        not_terminal = not self.is_terminal
+        if self.no_color and color_system:
+            buffer = Segment.remove_color(buffer)
+        for text, style, control in buffer:
+            if style:
+                append(
+                    style.render(
+                        text,
+                        color_system=color_system,
+                        legacy_windows=legacy_windows,
+                    )
+                )
+            elif not (not_terminal and control):
+                append(text)
+
+        rendered = "".join(output)
+        return rendered
+
+    def input(
+        self,
+        prompt: TextType = "",
+        *,
+        markup: bool = True,
+        emoji: bool = True,
+        password: bool = False,
+        stream: Optional[TextIO] = None,
+    ) -> str:
+        """Displays a prompt and waits for input from the user. The prompt may contain color / style.
+
+        It works in the same way as Python's builtin :func:`input` function and provides elaborate line editing and history features if Python's builtin :mod:`readline` module is previously loaded.
+
+        Args:
+            prompt (Union[str, Text]): Text to render in the prompt.
+            markup (bool, optional): Enable console markup (requires a str prompt). Defaults to True.
+            emoji (bool, optional): Enable emoji (requires a str prompt). Defaults to True.
+            password: (bool, optional): Hide typed text. Defaults to False.
+            stream: (TextIO, optional): Optional file to read input from (rather than stdin). Defaults to None.
+
+        Returns:
+            str: Text read from stdin.
+        """
+        if prompt:
+            self.print(prompt, markup=markup, emoji=emoji, end="")
+        if password:
+            result = getpass("", stream=stream)
+        else:
+            if stream:
+                result = stream.readline()
+            else:
+                result = input()
+        return result
+
+    def export_text(self, *, clear: bool = True, styles: bool = False) -> str:
+        """Generate text from console contents (requires record=True argument in constructor).
+
+        Args:
+            clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``.
+            styles (bool, optional): If ``True``, ansi escape codes will be included. ``False`` for plain text.
+                Defaults to ``False``.
+
+        Returns:
+            str: String containing console contents.
+
+        """
+        assert (
+            self.record
+        ), "To export console contents set record=True in the constructor or instance"
+
+        with self._record_buffer_lock:
+            if styles:
+                text = "".join(
+                    (style.render(text) if style else text)
+                    for text, style, _ in self._record_buffer
+                )
+            else:
+                text = "".join(
+                    segment.text
+                    for segment in self._record_buffer
+                    if not segment.control
+                )
+            if clear:
+                del self._record_buffer[:]
+        return text
+
+    def save_text(self, path: str, *, clear: bool = True, styles: bool = False) -> None:
+        """Generate text from console and save to a given location (requires record=True argument in constructor).
+
+        Args:
+            path (str): Path to write text files.
+            clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``.
+            styles (bool, optional): If ``True``, ansi style codes will be included. ``False`` for plain text.
+                Defaults to ``False``.
+
+        """
+        text = self.export_text(clear=clear, styles=styles)
+        with open(path, "w", encoding="utf-8") as write_file:
+            write_file.write(text)
+
+    def export_html(
+        self,
+        *,
+        theme: Optional[TerminalTheme] = None,
+        clear: bool = True,
+        code_format: Optional[str] = None,
+        inline_styles: bool = False,
+    ) -> str:
+        """Generate HTML from console contents (requires record=True argument in constructor).
+
+        Args:
+            theme (TerminalTheme, optional): TerminalTheme object containing console colors.
+            clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``.
+            code_format (str, optional): Format string to render HTML. In addition to '{foreground}',
+                '{background}', and '{code}', should contain '{stylesheet}' if inline_styles is ``False``.
+            inline_styles (bool, optional): If ``True`` styles will be inlined in to spans, which makes files
+                larger but easier to cut and paste markup. If ``False``, styles will be embedded in a style tag.
+                Defaults to False.
+
+        Returns:
+            str: String containing console contents as HTML.
+        """
+        assert (
+            self.record
+        ), "To export console contents set record=True in the constructor or instance"
+        fragments: List[str] = []
+        append = fragments.append
+        _theme = theme or DEFAULT_TERMINAL_THEME
+        stylesheet = ""
+
+        render_code_format = CONSOLE_HTML_FORMAT if code_format is None else code_format
+
+        with self._record_buffer_lock:
+            if inline_styles:
+                for text, style, _ in Segment.filter_control(
+                    Segment.simplify(self._record_buffer)
+                ):
+                    text = escape(text)
+                    if style:
+                        rule = style.get_html_style(_theme)
+                        if style.link:
+                            text = f'{text}'
+                        text = f'{text}' if rule else text
+                    append(text)
+            else:
+                styles: Dict[str, int] = {}
+                for text, style, _ in Segment.filter_control(
+                    Segment.simplify(self._record_buffer)
+                ):
+                    text = escape(text)
+                    if style:
+                        rule = style.get_html_style(_theme)
+                        style_number = styles.setdefault(rule, len(styles) + 1)
+                        if style.link:
+                            text = f'{text}'
+                        else:
+                            text = f'{text}'
+                    append(text)
+                stylesheet_rules: List[str] = []
+                stylesheet_append = stylesheet_rules.append
+                for style_rule, style_number in styles.items():
+                    if style_rule:
+                        stylesheet_append(f".r{style_number} {{{style_rule}}}")
+                stylesheet = "\n".join(stylesheet_rules)
+
+            rendered_code = render_code_format.format(
+                code="".join(fragments),
+                stylesheet=stylesheet,
+                foreground=_theme.foreground_color.hex,
+                background=_theme.background_color.hex,
+            )
+            if clear:
+                del self._record_buffer[:]
+        return rendered_code
+
+    def save_html(
+        self,
+        path: str,
+        *,
+        theme: Optional[TerminalTheme] = None,
+        clear: bool = True,
+        code_format: str = CONSOLE_HTML_FORMAT,
+        inline_styles: bool = False,
+    ) -> None:
+        """Generate HTML from console contents and write to a file (requires record=True argument in constructor).
+
+        Args:
+            path (str): Path to write html file.
+            theme (TerminalTheme, optional): TerminalTheme object containing console colors.
+            clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``.
+            code_format (str, optional): Format string to render HTML. In addition to '{foreground}',
+                '{background}', and '{code}', should contain '{stylesheet}' if inline_styles is ``False``.
+            inline_styles (bool, optional): If ``True`` styles will be inlined in to spans, which makes files
+                larger but easier to cut and paste markup. If ``False``, styles will be embedded in a style tag.
+                Defaults to False.
+
+        """
+        html = self.export_html(
+            theme=theme,
+            clear=clear,
+            code_format=code_format,
+            inline_styles=inline_styles,
+        )
+        with open(path, "w", encoding="utf-8") as write_file:
+            write_file.write(html)
+
+    def export_svg(
+        self,
+        *,
+        title: str = "Rich",
+        theme: Optional[TerminalTheme] = None,
+        clear: bool = True,
+        code_format: str = CONSOLE_SVG_FORMAT,
+        font_aspect_ratio: float = 0.61,
+        unique_id: Optional[str] = None,
+    ) -> str:
+        """
+        Generate an SVG from the console contents (requires record=True in Console constructor).
+
+        Args:
+            title (str, optional): The title of the tab in the output image
+            theme (TerminalTheme, optional): The ``TerminalTheme`` object to use to style the terminal
+            clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``
+            code_format (str, optional): Format string used to generate the SVG. Rich will inject a number of variables
+                into the string in order to form the final SVG output. The default template used and the variables
+                injected by Rich can be found by inspecting the ``console.CONSOLE_SVG_FORMAT`` variable.
+            font_aspect_ratio (float, optional): The width to height ratio of the font used in the ``code_format``
+                string. Defaults to 0.61, which is the width to height ratio of Fira Code (the default font).
+                If you aren't specifying a different font inside ``code_format``, you probably don't need this.
+            unique_id (str, optional): unique id that is used as the prefix for various elements (CSS styles, node
+                ids). If not set, this defaults to a computed value based on the recorded content.
+        """
+
+        from pip._vendor.rich.cells import cell_len
+
+        style_cache: Dict[Style, str] = {}
+
+        def get_svg_style(style: Style) -> str:
+            """Convert a Style to CSS rules for SVG."""
+            if style in style_cache:
+                return style_cache[style]
+            css_rules = []
+            color = (
+                _theme.foreground_color
+                if (style.color is None or style.color.is_default)
+                else style.color.get_truecolor(_theme)
+            )
+            bgcolor = (
+                _theme.background_color
+                if (style.bgcolor is None or style.bgcolor.is_default)
+                else style.bgcolor.get_truecolor(_theme)
+            )
+            if style.reverse:
+                color, bgcolor = bgcolor, color
+            if style.dim:
+                color = blend_rgb(color, bgcolor, 0.4)
+            css_rules.append(f"fill: {color.hex}")
+            if style.bold:
+                css_rules.append("font-weight: bold")
+            if style.italic:
+                css_rules.append("font-style: italic;")
+            if style.underline:
+                css_rules.append("text-decoration: underline;")
+            if style.strike:
+                css_rules.append("text-decoration: line-through;")
+
+            css = ";".join(css_rules)
+            style_cache[style] = css
+            return css
+
+        _theme = theme or SVG_EXPORT_THEME
+
+        width = self.width
+        char_height = 20
+        char_width = char_height * font_aspect_ratio
+        line_height = char_height * 1.22
+
+        margin_top = 1
+        margin_right = 1
+        margin_bottom = 1
+        margin_left = 1
+
+        padding_top = 40
+        padding_right = 8
+        padding_bottom = 8
+        padding_left = 8
+
+        padding_width = padding_left + padding_right
+        padding_height = padding_top + padding_bottom
+        margin_width = margin_left + margin_right
+        margin_height = margin_top + margin_bottom
+
+        text_backgrounds: List[str] = []
+        text_group: List[str] = []
+        classes: Dict[str, int] = {}
+        style_no = 1
+
+        def escape_text(text: str) -> str:
+            """HTML escape text and replace spaces with nbsp."""
+            return escape(text).replace(" ", " ")
+
+        def make_tag(
+            name: str, content: Optional[str] = None, **attribs: object
+        ) -> str:
+            """Make a tag from name, content, and attributes."""
+
+            def stringify(value: object) -> str:
+                if isinstance(value, (float)):
+                    return format(value, "g")
+                return str(value)
+
+            tag_attribs = " ".join(
+                f'{k.lstrip("_").replace("_", "-")}="{stringify(v)}"'
+                for k, v in attribs.items()
+            )
+            return (
+                f"<{name} {tag_attribs}>{content}"
+                if content
+                else f"<{name} {tag_attribs}/>"
+            )
+
+        with self._record_buffer_lock:
+            segments = list(Segment.filter_control(self._record_buffer))
+            if clear:
+                self._record_buffer.clear()
+
+        if unique_id is None:
+            unique_id = "terminal-" + str(
+                zlib.adler32(
+                    ("".join(repr(segment) for segment in segments)).encode(
+                        "utf-8",
+                        "ignore",
+                    )
+                    + title.encode("utf-8", "ignore")
+                )
+            )
+        y = 0
+        for y, line in enumerate(Segment.split_and_crop_lines(segments, length=width)):
+            x = 0
+            for text, style, _control in line:
+                style = style or Style()
+                rules = get_svg_style(style)
+                if rules not in classes:
+                    classes[rules] = style_no
+                    style_no += 1
+                class_name = f"r{classes[rules]}"
+
+                if style.reverse:
+                    has_background = True
+                    background = (
+                        _theme.foreground_color.hex
+                        if style.color is None
+                        else style.color.get_truecolor(_theme).hex
+                    )
+                else:
+                    bgcolor = style.bgcolor
+                    has_background = bgcolor is not None and not bgcolor.is_default
+                    background = (
+                        _theme.background_color.hex
+                        if style.bgcolor is None
+                        else style.bgcolor.get_truecolor(_theme).hex
+                    )
+
+                text_length = cell_len(text)
+                if has_background:
+                    text_backgrounds.append(
+                        make_tag(
+                            "rect",
+                            fill=background,
+                            x=x * char_width,
+                            y=y * line_height + 1.5,
+                            width=char_width * text_length,
+                            height=line_height + 0.25,
+                            shape_rendering="crispEdges",
+                        )
+                    )
+
+                if text != " " * len(text):
+                    text_group.append(
+                        make_tag(
+                            "text",
+                            escape_text(text),
+                            _class=f"{unique_id}-{class_name}",
+                            x=x * char_width,
+                            y=y * line_height + char_height,
+                            textLength=char_width * len(text),
+                            clip_path=f"url(#{unique_id}-line-{y})",
+                        )
+                    )
+                x += cell_len(text)
+
+        line_offsets = [line_no * line_height + 1.5 for line_no in range(y)]
+        lines = "\n".join(
+            f"""
+    {make_tag("rect", x=0, y=offset, width=char_width * width, height=line_height + 0.25)}
+            """
+            for line_no, offset in enumerate(line_offsets)
+        )
+
+        styles = "\n".join(
+            f".{unique_id}-r{rule_no} {{ {css} }}" for css, rule_no in classes.items()
+        )
+        backgrounds = "".join(text_backgrounds)
+        matrix = "".join(text_group)
+
+        terminal_width = ceil(width * char_width + padding_width)
+        terminal_height = (y + 1) * line_height + padding_height
+        chrome = make_tag(
+            "rect",
+            fill=_theme.background_color.hex,
+            stroke="rgba(255,255,255,0.35)",
+            stroke_width="1",
+            x=margin_left,
+            y=margin_top,
+            width=terminal_width,
+            height=terminal_height,
+            rx=8,
+        )
+
+        title_color = _theme.foreground_color.hex
+        if title:
+            chrome += make_tag(
+                "text",
+                escape_text(title),
+                _class=f"{unique_id}-title",
+                fill=title_color,
+                text_anchor="middle",
+                x=terminal_width // 2,
+                y=margin_top + char_height + 6,
+            )
+        chrome += f"""
+            
+            
+            
+            
+            
+        """
+
+        svg = code_format.format(
+            unique_id=unique_id,
+            char_width=char_width,
+            char_height=char_height,
+            line_height=line_height,
+            terminal_width=char_width * width - 1,
+            terminal_height=(y + 1) * line_height - 1,
+            width=terminal_width + margin_width,
+            height=terminal_height + margin_height,
+            terminal_x=margin_left + padding_left,
+            terminal_y=margin_top + padding_top,
+            styles=styles,
+            chrome=chrome,
+            backgrounds=backgrounds,
+            matrix=matrix,
+            lines=lines,
+        )
+        return svg
+
+    def save_svg(
+        self,
+        path: str,
+        *,
+        title: str = "Rich",
+        theme: Optional[TerminalTheme] = None,
+        clear: bool = True,
+        code_format: str = CONSOLE_SVG_FORMAT,
+        font_aspect_ratio: float = 0.61,
+        unique_id: Optional[str] = None,
+    ) -> None:
+        """Generate an SVG file from the console contents (requires record=True in Console constructor).
+
+        Args:
+            path (str): The path to write the SVG to.
+            title (str, optional): The title of the tab in the output image
+            theme (TerminalTheme, optional): The ``TerminalTheme`` object to use to style the terminal
+            clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``
+            code_format (str, optional): Format string used to generate the SVG. Rich will inject a number of variables
+                into the string in order to form the final SVG output. The default template used and the variables
+                injected by Rich can be found by inspecting the ``console.CONSOLE_SVG_FORMAT`` variable.
+            font_aspect_ratio (float, optional): The width to height ratio of the font used in the ``code_format``
+                string. Defaults to 0.61, which is the width to height ratio of Fira Code (the default font).
+                If you aren't specifying a different font inside ``code_format``, you probably don't need this.
+            unique_id (str, optional): unique id that is used as the prefix for various elements (CSS styles, node
+                ids). If not set, this defaults to a computed value based on the recorded content.
+        """
+        svg = self.export_svg(
+            title=title,
+            theme=theme,
+            clear=clear,
+            code_format=code_format,
+            font_aspect_ratio=font_aspect_ratio,
+            unique_id=unique_id,
+        )
+        with open(path, "w", encoding="utf-8") as write_file:
+            write_file.write(svg)
+
+
+def _svg_hash(svg_main_code: str) -> str:
+    """Returns a unique hash for the given SVG main code.
+
+    Args:
+        svg_main_code (str): The content we're going to inject in the SVG envelope.
+
+    Returns:
+        str: a hash of the given content
+    """
+    return str(zlib.adler32(svg_main_code.encode()))
+
+
+if __name__ == "__main__":  # pragma: no cover
+    console = Console(record=True)
+
+    console.log(
+        "JSONRPC [i]request[/i]",
+        5,
+        1.3,
+        True,
+        False,
+        None,
+        {
+            "jsonrpc": "2.0",
+            "method": "subtract",
+            "params": {"minuend": 42, "subtrahend": 23},
+            "id": 3,
+        },
+    )
+
+    console.log("Hello, World!", "{'a': 1}", repr(console))
+
+    console.print(
+        {
+            "name": None,
+            "empty": [],
+            "quiz": {
+                "sport": {
+                    "answered": True,
+                    "q1": {
+                        "question": "Which one is correct team name in NBA?",
+                        "options": [
+                            "New York Bulls",
+                            "Los Angeles Kings",
+                            "Golden State Warriors",
+                            "Huston Rocket",
+                        ],
+                        "answer": "Huston Rocket",
+                    },
+                },
+                "maths": {
+                    "answered": False,
+                    "q1": {
+                        "question": "5 + 7 = ?",
+                        "options": [10, 11, 12, 13],
+                        "answer": 12,
+                    },
+                    "q2": {
+                        "question": "12 - 8 = ?",
+                        "options": [1, 2, 3, 4],
+                        "answer": 4,
+                    },
+                },
+            },
+        }
+    )
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/constrain.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/constrain.py
new file mode 100644
index 0000000..65fdf56
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/constrain.py
@@ -0,0 +1,37 @@
+from typing import Optional, TYPE_CHECKING
+
+from .jupyter import JupyterMixin
+from .measure import Measurement
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderableType, RenderResult
+
+
+class Constrain(JupyterMixin):
+    """Constrain the width of a renderable to a given number of characters.
+
+    Args:
+        renderable (RenderableType): A renderable object.
+        width (int, optional): The maximum width (in characters) to render. Defaults to 80.
+    """
+
+    def __init__(self, renderable: "RenderableType", width: Optional[int] = 80) -> None:
+        self.renderable = renderable
+        self.width = width
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        if self.width is None:
+            yield self.renderable
+        else:
+            child_options = options.update_width(min(self.width, options.max_width))
+            yield from console.render(self.renderable, child_options)
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        if self.width is not None:
+            options = options.update_width(self.width)
+        measurement = Measurement.get(console, options, self.renderable)
+        return measurement
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/containers.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/containers.py
new file mode 100644
index 0000000..901ff8b
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/containers.py
@@ -0,0 +1,167 @@
+from itertools import zip_longest
+from typing import (
+    TYPE_CHECKING,
+    Iterable,
+    Iterator,
+    List,
+    Optional,
+    TypeVar,
+    Union,
+    overload,
+)
+
+if TYPE_CHECKING:
+    from .console import (
+        Console,
+        ConsoleOptions,
+        JustifyMethod,
+        OverflowMethod,
+        RenderResult,
+        RenderableType,
+    )
+    from .text import Text
+
+from .cells import cell_len
+from .measure import Measurement
+
+T = TypeVar("T")
+
+
+class Renderables:
+    """A list subclass which renders its contents to the console."""
+
+    def __init__(
+        self, renderables: Optional[Iterable["RenderableType"]] = None
+    ) -> None:
+        self._renderables: List["RenderableType"] = (
+            list(renderables) if renderables is not None else []
+        )
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        """Console render method to insert line-breaks."""
+        yield from self._renderables
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        dimensions = [
+            Measurement.get(console, options, renderable)
+            for renderable in self._renderables
+        ]
+        if not dimensions:
+            return Measurement(1, 1)
+        _min = max(dimension.minimum for dimension in dimensions)
+        _max = max(dimension.maximum for dimension in dimensions)
+        return Measurement(_min, _max)
+
+    def append(self, renderable: "RenderableType") -> None:
+        self._renderables.append(renderable)
+
+    def __iter__(self) -> Iterable["RenderableType"]:
+        return iter(self._renderables)
+
+
+class Lines:
+    """A list subclass which can render to the console."""
+
+    def __init__(self, lines: Iterable["Text"] = ()) -> None:
+        self._lines: List["Text"] = list(lines)
+
+    def __repr__(self) -> str:
+        return f"Lines({self._lines!r})"
+
+    def __iter__(self) -> Iterator["Text"]:
+        return iter(self._lines)
+
+    @overload
+    def __getitem__(self, index: int) -> "Text":
+        ...
+
+    @overload
+    def __getitem__(self, index: slice) -> List["Text"]:
+        ...
+
+    def __getitem__(self, index: Union[slice, int]) -> Union["Text", List["Text"]]:
+        return self._lines[index]
+
+    def __setitem__(self, index: int, value: "Text") -> "Lines":
+        self._lines[index] = value
+        return self
+
+    def __len__(self) -> int:
+        return self._lines.__len__()
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        """Console render method to insert line-breaks."""
+        yield from self._lines
+
+    def append(self, line: "Text") -> None:
+        self._lines.append(line)
+
+    def extend(self, lines: Iterable["Text"]) -> None:
+        self._lines.extend(lines)
+
+    def pop(self, index: int = -1) -> "Text":
+        return self._lines.pop(index)
+
+    def justify(
+        self,
+        console: "Console",
+        width: int,
+        justify: "JustifyMethod" = "left",
+        overflow: "OverflowMethod" = "fold",
+    ) -> None:
+        """Justify and overflow text to a given width.
+
+        Args:
+            console (Console): Console instance.
+            width (int): Number of cells available per line.
+            justify (str, optional): Default justify method for text: "left", "center", "full" or "right". Defaults to "left".
+            overflow (str, optional): Default overflow for text: "crop", "fold", or "ellipsis". Defaults to "fold".
+
+        """
+        from .text import Text
+
+        if justify == "left":
+            for line in self._lines:
+                line.truncate(width, overflow=overflow, pad=True)
+        elif justify == "center":
+            for line in self._lines:
+                line.rstrip()
+                line.truncate(width, overflow=overflow)
+                line.pad_left((width - cell_len(line.plain)) // 2)
+                line.pad_right(width - cell_len(line.plain))
+        elif justify == "right":
+            for line in self._lines:
+                line.rstrip()
+                line.truncate(width, overflow=overflow)
+                line.pad_left(width - cell_len(line.plain))
+        elif justify == "full":
+            for line_index, line in enumerate(self._lines):
+                if line_index == len(self._lines) - 1:
+                    break
+                words = line.split(" ")
+                words_size = sum(cell_len(word.plain) for word in words)
+                num_spaces = len(words) - 1
+                spaces = [1 for _ in range(num_spaces)]
+                index = 0
+                if spaces:
+                    while words_size + num_spaces < width:
+                        spaces[len(spaces) - index - 1] += 1
+                        num_spaces += 1
+                        index = (index + 1) % len(spaces)
+                tokens: List[Text] = []
+                for index, (word, next_word) in enumerate(
+                    zip_longest(words, words[1:])
+                ):
+                    tokens.append(word)
+                    if index < len(spaces):
+                        style = word.get_style_at_offset(console, -1)
+                        next_style = next_word.get_style_at_offset(console, 0)
+                        space_style = style if style == next_style else line.style
+                        tokens.append(Text(" " * spaces[index], style=space_style))
+                self[line_index] = Text("").join(tokens)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/control.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/control.py
new file mode 100644
index 0000000..88fcb92
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/control.py
@@ -0,0 +1,225 @@
+import sys
+import time
+from typing import TYPE_CHECKING, Callable, Dict, Iterable, List, Union
+
+if sys.version_info >= (3, 8):
+    from typing import Final
+else:
+    from pip._vendor.typing_extensions import Final  # pragma: no cover
+
+from .segment import ControlCode, ControlType, Segment
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderResult
+
+STRIP_CONTROL_CODES: Final = [
+    7,  # Bell
+    8,  # Backspace
+    11,  # Vertical tab
+    12,  # Form feed
+    13,  # Carriage return
+]
+_CONTROL_STRIP_TRANSLATE: Final = {
+    _codepoint: None for _codepoint in STRIP_CONTROL_CODES
+}
+
+CONTROL_ESCAPE: Final = {
+    7: "\\a",
+    8: "\\b",
+    11: "\\v",
+    12: "\\f",
+    13: "\\r",
+}
+
+CONTROL_CODES_FORMAT: Dict[int, Callable[..., str]] = {
+    ControlType.BELL: lambda: "\x07",
+    ControlType.CARRIAGE_RETURN: lambda: "\r",
+    ControlType.HOME: lambda: "\x1b[H",
+    ControlType.CLEAR: lambda: "\x1b[2J",
+    ControlType.ENABLE_ALT_SCREEN: lambda: "\x1b[?1049h",
+    ControlType.DISABLE_ALT_SCREEN: lambda: "\x1b[?1049l",
+    ControlType.SHOW_CURSOR: lambda: "\x1b[?25h",
+    ControlType.HIDE_CURSOR: lambda: "\x1b[?25l",
+    ControlType.CURSOR_UP: lambda param: f"\x1b[{param}A",
+    ControlType.CURSOR_DOWN: lambda param: f"\x1b[{param}B",
+    ControlType.CURSOR_FORWARD: lambda param: f"\x1b[{param}C",
+    ControlType.CURSOR_BACKWARD: lambda param: f"\x1b[{param}D",
+    ControlType.CURSOR_MOVE_TO_COLUMN: lambda param: f"\x1b[{param+1}G",
+    ControlType.ERASE_IN_LINE: lambda param: f"\x1b[{param}K",
+    ControlType.CURSOR_MOVE_TO: lambda x, y: f"\x1b[{y+1};{x+1}H",
+    ControlType.SET_WINDOW_TITLE: lambda title: f"\x1b]0;{title}\x07",
+}
+
+
+class Control:
+    """A renderable that inserts a control code (non printable but may move cursor).
+
+    Args:
+        *codes (str): Positional arguments are either a :class:`~rich.segment.ControlType` enum or a
+            tuple of ControlType and an integer parameter
+    """
+
+    __slots__ = ["segment"]
+
+    def __init__(self, *codes: Union[ControlType, ControlCode]) -> None:
+        control_codes: List[ControlCode] = [
+            (code,) if isinstance(code, ControlType) else code for code in codes
+        ]
+        _format_map = CONTROL_CODES_FORMAT
+        rendered_codes = "".join(
+            _format_map[code](*parameters) for code, *parameters in control_codes
+        )
+        self.segment = Segment(rendered_codes, None, control_codes)
+
+    @classmethod
+    def bell(cls) -> "Control":
+        """Ring the 'bell'."""
+        return cls(ControlType.BELL)
+
+    @classmethod
+    def home(cls) -> "Control":
+        """Move cursor to 'home' position."""
+        return cls(ControlType.HOME)
+
+    @classmethod
+    def move(cls, x: int = 0, y: int = 0) -> "Control":
+        """Move cursor relative to current position.
+
+        Args:
+            x (int): X offset.
+            y (int): Y offset.
+
+        Returns:
+            ~Control: Control object.
+
+        """
+
+        def get_codes() -> Iterable[ControlCode]:
+            control = ControlType
+            if x:
+                yield (
+                    control.CURSOR_FORWARD if x > 0 else control.CURSOR_BACKWARD,
+                    abs(x),
+                )
+            if y:
+                yield (
+                    control.CURSOR_DOWN if y > 0 else control.CURSOR_UP,
+                    abs(y),
+                )
+
+        control = cls(*get_codes())
+        return control
+
+    @classmethod
+    def move_to_column(cls, x: int, y: int = 0) -> "Control":
+        """Move to the given column, optionally add offset to row.
+
+        Returns:
+            x (int): absolute x (column)
+            y (int): optional y offset (row)
+
+        Returns:
+            ~Control: Control object.
+        """
+
+        return (
+            cls(
+                (ControlType.CURSOR_MOVE_TO_COLUMN, x),
+                (
+                    ControlType.CURSOR_DOWN if y > 0 else ControlType.CURSOR_UP,
+                    abs(y),
+                ),
+            )
+            if y
+            else cls((ControlType.CURSOR_MOVE_TO_COLUMN, x))
+        )
+
+    @classmethod
+    def move_to(cls, x: int, y: int) -> "Control":
+        """Move cursor to absolute position.
+
+        Args:
+            x (int): x offset (column)
+            y (int): y offset (row)
+
+        Returns:
+            ~Control: Control object.
+        """
+        return cls((ControlType.CURSOR_MOVE_TO, x, y))
+
+    @classmethod
+    def clear(cls) -> "Control":
+        """Clear the screen."""
+        return cls(ControlType.CLEAR)
+
+    @classmethod
+    def show_cursor(cls, show: bool) -> "Control":
+        """Show or hide the cursor."""
+        return cls(ControlType.SHOW_CURSOR if show else ControlType.HIDE_CURSOR)
+
+    @classmethod
+    def alt_screen(cls, enable: bool) -> "Control":
+        """Enable or disable alt screen."""
+        if enable:
+            return cls(ControlType.ENABLE_ALT_SCREEN, ControlType.HOME)
+        else:
+            return cls(ControlType.DISABLE_ALT_SCREEN)
+
+    @classmethod
+    def title(cls, title: str) -> "Control":
+        """Set the terminal window title
+
+        Args:
+            title (str): The new terminal window title
+        """
+        return cls((ControlType.SET_WINDOW_TITLE, title))
+
+    def __str__(self) -> str:
+        return self.segment.text
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        if self.segment.text:
+            yield self.segment
+
+
+def strip_control_codes(
+    text: str, _translate_table: Dict[int, None] = _CONTROL_STRIP_TRANSLATE
+) -> str:
+    """Remove control codes from text.
+
+    Args:
+        text (str): A string possibly contain control codes.
+
+    Returns:
+        str: String with control codes removed.
+    """
+    return text.translate(_translate_table)
+
+
+def escape_control_codes(
+    text: str,
+    _translate_table: Dict[int, str] = CONTROL_ESCAPE,
+) -> str:
+    """Replace control codes with their "escaped" equivalent in the given text.
+    (e.g. "\b" becomes "\\b")
+
+    Args:
+        text (str): A string possibly containing control codes.
+
+    Returns:
+        str: String with control codes replaced with their escaped version.
+    """
+    return text.translate(_translate_table)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Console
+
+    console = Console()
+    console.print("Look at the title of your terminal window ^")
+    # console.print(Control((ControlType.SET_WINDOW_TITLE, "Hello, world!")))
+    for i in range(10):
+        console.set_window_title("🚀 Loading" + "." * i)
+        time.sleep(0.5)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/default_styles.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/default_styles.py
new file mode 100644
index 0000000..6c0d732
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/default_styles.py
@@ -0,0 +1,191 @@
+from typing import Dict
+
+from .style import Style
+
+DEFAULT_STYLES: Dict[str, Style] = {
+    "none": Style.null(),
+    "reset": Style(
+        color="default",
+        bgcolor="default",
+        dim=False,
+        bold=False,
+        italic=False,
+        underline=False,
+        blink=False,
+        blink2=False,
+        reverse=False,
+        conceal=False,
+        strike=False,
+    ),
+    "dim": Style(dim=True),
+    "bright": Style(dim=False),
+    "bold": Style(bold=True),
+    "strong": Style(bold=True),
+    "code": Style(reverse=True, bold=True),
+    "italic": Style(italic=True),
+    "emphasize": Style(italic=True),
+    "underline": Style(underline=True),
+    "blink": Style(blink=True),
+    "blink2": Style(blink2=True),
+    "reverse": Style(reverse=True),
+    "strike": Style(strike=True),
+    "black": Style(color="black"),
+    "red": Style(color="red"),
+    "green": Style(color="green"),
+    "yellow": Style(color="yellow"),
+    "magenta": Style(color="magenta"),
+    "cyan": Style(color="cyan"),
+    "white": Style(color="white"),
+    "inspect.attr": Style(color="yellow", italic=True),
+    "inspect.attr.dunder": Style(color="yellow", italic=True, dim=True),
+    "inspect.callable": Style(bold=True, color="red"),
+    "inspect.async_def": Style(italic=True, color="bright_cyan"),
+    "inspect.def": Style(italic=True, color="bright_cyan"),
+    "inspect.class": Style(italic=True, color="bright_cyan"),
+    "inspect.error": Style(bold=True, color="red"),
+    "inspect.equals": Style(),
+    "inspect.help": Style(color="cyan"),
+    "inspect.doc": Style(dim=True),
+    "inspect.value.border": Style(color="green"),
+    "live.ellipsis": Style(bold=True, color="red"),
+    "layout.tree.row": Style(dim=False, color="red"),
+    "layout.tree.column": Style(dim=False, color="blue"),
+    "logging.keyword": Style(bold=True, color="yellow"),
+    "logging.level.notset": Style(dim=True),
+    "logging.level.debug": Style(color="green"),
+    "logging.level.info": Style(color="blue"),
+    "logging.level.warning": Style(color="yellow"),
+    "logging.level.error": Style(color="red", bold=True),
+    "logging.level.critical": Style(color="red", bold=True, reverse=True),
+    "log.level": Style.null(),
+    "log.time": Style(color="cyan", dim=True),
+    "log.message": Style.null(),
+    "log.path": Style(dim=True),
+    "repr.ellipsis": Style(color="yellow"),
+    "repr.indent": Style(color="green", dim=True),
+    "repr.error": Style(color="red", bold=True),
+    "repr.str": Style(color="green", italic=False, bold=False),
+    "repr.brace": Style(bold=True),
+    "repr.comma": Style(bold=True),
+    "repr.ipv4": Style(bold=True, color="bright_green"),
+    "repr.ipv6": Style(bold=True, color="bright_green"),
+    "repr.eui48": Style(bold=True, color="bright_green"),
+    "repr.eui64": Style(bold=True, color="bright_green"),
+    "repr.tag_start": Style(bold=True),
+    "repr.tag_name": Style(color="bright_magenta", bold=True),
+    "repr.tag_contents": Style(color="default"),
+    "repr.tag_end": Style(bold=True),
+    "repr.attrib_name": Style(color="yellow", italic=False),
+    "repr.attrib_equal": Style(bold=True),
+    "repr.attrib_value": Style(color="magenta", italic=False),
+    "repr.number": Style(color="cyan", bold=True, italic=False),
+    "repr.number_complex": Style(color="cyan", bold=True, italic=False),  # same
+    "repr.bool_true": Style(color="bright_green", italic=True),
+    "repr.bool_false": Style(color="bright_red", italic=True),
+    "repr.none": Style(color="magenta", italic=True),
+    "repr.url": Style(underline=True, color="bright_blue", italic=False, bold=False),
+    "repr.uuid": Style(color="bright_yellow", bold=False),
+    "repr.call": Style(color="magenta", bold=True),
+    "repr.path": Style(color="magenta"),
+    "repr.filename": Style(color="bright_magenta"),
+    "rule.line": Style(color="bright_green"),
+    "rule.text": Style.null(),
+    "json.brace": Style(bold=True),
+    "json.bool_true": Style(color="bright_green", italic=True),
+    "json.bool_false": Style(color="bright_red", italic=True),
+    "json.null": Style(color="magenta", italic=True),
+    "json.number": Style(color="cyan", bold=True, italic=False),
+    "json.str": Style(color="green", italic=False, bold=False),
+    "json.key": Style(color="blue", bold=True),
+    "prompt": Style.null(),
+    "prompt.choices": Style(color="magenta", bold=True),
+    "prompt.default": Style(color="cyan", bold=True),
+    "prompt.invalid": Style(color="red"),
+    "prompt.invalid.choice": Style(color="red"),
+    "pretty": Style.null(),
+    "scope.border": Style(color="blue"),
+    "scope.key": Style(color="yellow", italic=True),
+    "scope.key.special": Style(color="yellow", italic=True, dim=True),
+    "scope.equals": Style(color="red"),
+    "table.header": Style(bold=True),
+    "table.footer": Style(bold=True),
+    "table.cell": Style.null(),
+    "table.title": Style(italic=True),
+    "table.caption": Style(italic=True, dim=True),
+    "traceback.error": Style(color="red", italic=True),
+    "traceback.border.syntax_error": Style(color="bright_red"),
+    "traceback.border": Style(color="red"),
+    "traceback.text": Style.null(),
+    "traceback.title": Style(color="red", bold=True),
+    "traceback.exc_type": Style(color="bright_red", bold=True),
+    "traceback.exc_value": Style.null(),
+    "traceback.offset": Style(color="bright_red", bold=True),
+    "traceback.error_range": Style(underline=True, bold=True, dim=False),
+    "bar.back": Style(color="grey23"),
+    "bar.complete": Style(color="rgb(249,38,114)"),
+    "bar.finished": Style(color="rgb(114,156,31)"),
+    "bar.pulse": Style(color="rgb(249,38,114)"),
+    "progress.description": Style.null(),
+    "progress.filesize": Style(color="green"),
+    "progress.filesize.total": Style(color="green"),
+    "progress.download": Style(color="green"),
+    "progress.elapsed": Style(color="yellow"),
+    "progress.percentage": Style(color="magenta"),
+    "progress.remaining": Style(color="cyan"),
+    "progress.data.speed": Style(color="red"),
+    "progress.spinner": Style(color="green"),
+    "status.spinner": Style(color="green"),
+    "tree": Style(),
+    "tree.line": Style(),
+    "markdown.paragraph": Style(),
+    "markdown.text": Style(),
+    "markdown.em": Style(italic=True),
+    "markdown.emph": Style(italic=True),  # For commonmark backwards compatibility
+    "markdown.strong": Style(bold=True),
+    "markdown.code": Style(bold=True, color="cyan", bgcolor="black"),
+    "markdown.code_block": Style(color="cyan", bgcolor="black"),
+    "markdown.block_quote": Style(color="magenta"),
+    "markdown.list": Style(color="cyan"),
+    "markdown.item": Style(),
+    "markdown.item.bullet": Style(color="yellow", bold=True),
+    "markdown.item.number": Style(color="yellow", bold=True),
+    "markdown.hr": Style(color="yellow"),
+    "markdown.h1.border": Style(),
+    "markdown.h1": Style(bold=True),
+    "markdown.h2": Style(bold=True, underline=True),
+    "markdown.h3": Style(bold=True),
+    "markdown.h4": Style(bold=True, dim=True),
+    "markdown.h5": Style(underline=True),
+    "markdown.h6": Style(italic=True),
+    "markdown.h7": Style(italic=True, dim=True),
+    "markdown.link": Style(color="bright_blue"),
+    "markdown.link_url": Style(color="blue", underline=True),
+    "markdown.s": Style(strike=True),
+    "iso8601.date": Style(color="blue"),
+    "iso8601.time": Style(color="magenta"),
+    "iso8601.timezone": Style(color="yellow"),
+}
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import argparse
+    import io
+
+    from pip._vendor.rich.console import Console
+    from pip._vendor.rich.table import Table
+    from pip._vendor.rich.text import Text
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--html", action="store_true", help="Export as HTML table")
+    args = parser.parse_args()
+    html: bool = args.html
+    console = Console(record=True, width=70, file=io.StringIO()) if html else Console()
+
+    table = Table("Name", "Styling")
+
+    for style_name, style in DEFAULT_STYLES.items():
+        table.add_row(Text(style_name, style=style), str(style))
+
+    console.print(table)
+    if html:
+        print(console.export_html(inline_styles=True))
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/diagnose.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/diagnose.py
new file mode 100644
index 0000000..ad36183
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/diagnose.py
@@ -0,0 +1,37 @@
+import os
+import platform
+
+from pip._vendor.rich import inspect
+from pip._vendor.rich.console import Console, get_windows_console_features
+from pip._vendor.rich.panel import Panel
+from pip._vendor.rich.pretty import Pretty
+
+
+def report() -> None:  # pragma: no cover
+    """Print a report to the terminal with debugging information"""
+    console = Console()
+    inspect(console)
+    features = get_windows_console_features()
+    inspect(features)
+
+    env_names = (
+        "TERM",
+        "COLORTERM",
+        "CLICOLOR",
+        "NO_COLOR",
+        "TERM_PROGRAM",
+        "COLUMNS",
+        "LINES",
+        "JUPYTER_COLUMNS",
+        "JUPYTER_LINES",
+        "JPY_PARENT_PID",
+        "VSCODE_VERBOSE_LOGGING",
+    )
+    env = {name: os.getenv(name) for name in env_names}
+    console.print(Panel.fit((Pretty(env)), title="[b]Environment Variables"))
+
+    console.print(f'platform="{platform.system()}"')
+
+
+if __name__ == "__main__":  # pragma: no cover
+    report()
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/emoji.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/emoji.py
new file mode 100644
index 0000000..791f046
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/emoji.py
@@ -0,0 +1,96 @@
+import sys
+from typing import TYPE_CHECKING, Optional, Union
+
+from .jupyter import JupyterMixin
+from .segment import Segment
+from .style import Style
+from ._emoji_codes import EMOJI
+from ._emoji_replace import _emoji_replace
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from pip._vendor.typing_extensions import Literal  # pragma: no cover
+
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderResult
+
+
+EmojiVariant = Literal["emoji", "text"]
+
+
+class NoEmoji(Exception):
+    """No emoji by that name."""
+
+
+class Emoji(JupyterMixin):
+    __slots__ = ["name", "style", "_char", "variant"]
+
+    VARIANTS = {"text": "\uFE0E", "emoji": "\uFE0F"}
+
+    def __init__(
+        self,
+        name: str,
+        style: Union[str, Style] = "none",
+        variant: Optional[EmojiVariant] = None,
+    ) -> None:
+        """A single emoji character.
+
+        Args:
+            name (str): Name of emoji.
+            style (Union[str, Style], optional): Optional style. Defaults to None.
+
+        Raises:
+            NoEmoji: If the emoji doesn't exist.
+        """
+        self.name = name
+        self.style = style
+        self.variant = variant
+        try:
+            self._char = EMOJI[name]
+        except KeyError:
+            raise NoEmoji(f"No emoji called {name!r}")
+        if variant is not None:
+            self._char += self.VARIANTS.get(variant, "")
+
+    @classmethod
+    def replace(cls, text: str) -> str:
+        """Replace emoji markup with corresponding unicode characters.
+
+        Args:
+            text (str): A string with emojis codes, e.g. "Hello :smiley:!"
+
+        Returns:
+            str: A string with emoji codes replaces with actual emoji.
+        """
+        return _emoji_replace(text)
+
+    def __repr__(self) -> str:
+        return f""
+
+    def __str__(self) -> str:
+        return self._char
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        yield Segment(self._char, console.get_style(self.style))
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import sys
+
+    from pip._vendor.rich.columns import Columns
+    from pip._vendor.rich.console import Console
+
+    console = Console(record=True)
+
+    columns = Columns(
+        (f":{name}: {name}" for name in sorted(EMOJI.keys()) if "\u200D" not in name),
+        column_first=True,
+    )
+
+    console.print(columns)
+    if len(sys.argv) > 1:
+        console.save_html(sys.argv[1])
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/errors.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/errors.py
new file mode 100644
index 0000000..0bcbe53
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/errors.py
@@ -0,0 +1,34 @@
+class ConsoleError(Exception):
+    """An error in console operation."""
+
+
+class StyleError(Exception):
+    """An error in styles."""
+
+
+class StyleSyntaxError(ConsoleError):
+    """Style was badly formatted."""
+
+
+class MissingStyle(StyleError):
+    """No such style."""
+
+
+class StyleStackError(ConsoleError):
+    """Style stack is invalid."""
+
+
+class NotRenderableError(ConsoleError):
+    """Object is not renderable."""
+
+
+class MarkupError(ConsoleError):
+    """Markup was badly formatted."""
+
+
+class LiveError(ConsoleError):
+    """Error related to Live display."""
+
+
+class NoAltScreen(ConsoleError):
+    """Alt screen mode was required."""
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/file_proxy.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/file_proxy.py
new file mode 100644
index 0000000..4b0b0da
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/file_proxy.py
@@ -0,0 +1,57 @@
+import io
+from typing import IO, TYPE_CHECKING, Any, List
+
+from .ansi import AnsiDecoder
+from .text import Text
+
+if TYPE_CHECKING:
+    from .console import Console
+
+
+class FileProxy(io.TextIOBase):
+    """Wraps a file (e.g. sys.stdout) and redirects writes to a console."""
+
+    def __init__(self, console: "Console", file: IO[str]) -> None:
+        self.__console = console
+        self.__file = file
+        self.__buffer: List[str] = []
+        self.__ansi_decoder = AnsiDecoder()
+
+    @property
+    def rich_proxied_file(self) -> IO[str]:
+        """Get proxied file."""
+        return self.__file
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self.__file, name)
+
+    def write(self, text: str) -> int:
+        if not isinstance(text, str):
+            raise TypeError(f"write() argument must be str, not {type(text).__name__}")
+        buffer = self.__buffer
+        lines: List[str] = []
+        while text:
+            line, new_line, text = text.partition("\n")
+            if new_line:
+                lines.append("".join(buffer) + line)
+                buffer.clear()
+            else:
+                buffer.append(line)
+                break
+        if lines:
+            console = self.__console
+            with console:
+                output = Text("\n").join(
+                    self.__ansi_decoder.decode_line(line) for line in lines
+                )
+                console.print(output)
+        return len(text)
+
+    def flush(self) -> None:
+        output = "".join(self.__buffer)
+        if output:
+            self.__console.print(output)
+        del self.__buffer[:]
+
+    def fileno(self) -> int:
+        return self.__file.fileno()
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/filesize.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/filesize.py
new file mode 100644
index 0000000..83bc911
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/filesize.py
@@ -0,0 +1,88 @@
+"""Functions for reporting filesizes. Borrowed from https://github.com/PyFilesystem/pyfilesystem2
+
+The functions declared in this module should cover the different
+use cases needed to generate a string representation of a file size
+using several different units. Since there are many standards regarding
+file size units, three different functions have been implemented.
+
+See Also:
+    * `Wikipedia: Binary prefix `_
+
+"""
+
+__all__ = ["decimal"]
+
+from typing import Iterable, List, Optional, Tuple
+
+
+def _to_str(
+    size: int,
+    suffixes: Iterable[str],
+    base: int,
+    *,
+    precision: Optional[int] = 1,
+    separator: Optional[str] = " ",
+) -> str:
+    if size == 1:
+        return "1 byte"
+    elif size < base:
+        return f"{size:,} bytes"
+
+    for i, suffix in enumerate(suffixes, 2):  # noqa: B007
+        unit = base**i
+        if size < unit:
+            break
+    return "{:,.{precision}f}{separator}{}".format(
+        (base * size / unit),
+        suffix,
+        precision=precision,
+        separator=separator,
+    )
+
+
+def pick_unit_and_suffix(size: int, suffixes: List[str], base: int) -> Tuple[int, str]:
+    """Pick a suffix and base for the given size."""
+    for i, suffix in enumerate(suffixes):
+        unit = base**i
+        if size < unit * base:
+            break
+    return unit, suffix
+
+
+def decimal(
+    size: int,
+    *,
+    precision: Optional[int] = 1,
+    separator: Optional[str] = " ",
+) -> str:
+    """Convert a filesize in to a string (powers of 1000, SI prefixes).
+
+    In this convention, ``1000 B = 1 kB``.
+
+    This is typically the format used to advertise the storage
+    capacity of USB flash drives and the like (*256 MB* meaning
+    actually a storage capacity of more than *256 000 000 B*),
+    or used by **Mac OS X** since v10.6 to report file sizes.
+
+    Arguments:
+        int (size): A file size.
+        int (precision): The number of decimal places to include (default = 1).
+        str (separator): The string to separate the value from the units (default = " ").
+
+    Returns:
+        `str`: A string containing a abbreviated file size and units.
+
+    Example:
+        >>> filesize.decimal(30000)
+        '30.0 kB'
+        >>> filesize.decimal(30000, precision=2, separator="")
+        '30.00kB'
+
+    """
+    return _to_str(
+        size,
+        ("kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"),
+        1000,
+        precision=precision,
+        separator=separator,
+    )
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/highlighter.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/highlighter.py
new file mode 100644
index 0000000..e4c462e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/highlighter.py
@@ -0,0 +1,232 @@
+import re
+from abc import ABC, abstractmethod
+from typing import List, Union
+
+from .text import Span, Text
+
+
+def _combine_regex(*regexes: str) -> str:
+    """Combine a number of regexes in to a single regex.
+
+    Returns:
+        str: New regex with all regexes ORed together.
+    """
+    return "|".join(regexes)
+
+
+class Highlighter(ABC):
+    """Abstract base class for highlighters."""
+
+    def __call__(self, text: Union[str, Text]) -> Text:
+        """Highlight a str or Text instance.
+
+        Args:
+            text (Union[str, ~Text]): Text to highlight.
+
+        Raises:
+            TypeError: If not called with text or str.
+
+        Returns:
+            Text: A test instance with highlighting applied.
+        """
+        if isinstance(text, str):
+            highlight_text = Text(text)
+        elif isinstance(text, Text):
+            highlight_text = text.copy()
+        else:
+            raise TypeError(f"str or Text instance required, not {text!r}")
+        self.highlight(highlight_text)
+        return highlight_text
+
+    @abstractmethod
+    def highlight(self, text: Text) -> None:
+        """Apply highlighting in place to text.
+
+        Args:
+            text (~Text): A text object highlight.
+        """
+
+
+class NullHighlighter(Highlighter):
+    """A highlighter object that doesn't highlight.
+
+    May be used to disable highlighting entirely.
+
+    """
+
+    def highlight(self, text: Text) -> None:
+        """Nothing to do"""
+
+
+class RegexHighlighter(Highlighter):
+    """Applies highlighting from a list of regular expressions."""
+
+    highlights: List[str] = []
+    base_style: str = ""
+
+    def highlight(self, text: Text) -> None:
+        """Highlight :class:`rich.text.Text` using regular expressions.
+
+        Args:
+            text (~Text): Text to highlighted.
+
+        """
+
+        highlight_regex = text.highlight_regex
+        for re_highlight in self.highlights:
+            highlight_regex(re_highlight, style_prefix=self.base_style)
+
+
+class ReprHighlighter(RegexHighlighter):
+    """Highlights the text typically produced from ``__repr__`` methods."""
+
+    base_style = "repr."
+    highlights = [
+        r"(?P<)(?P[-\w.:|]*)(?P[\w\W]*)(?P>)",
+        r'(?P[\w_]{1,50})=(?P"?[\w_]+"?)?',
+        r"(?P[][{}()])",
+        _combine_regex(
+            r"(?P[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3})",
+            r"(?P([A-Fa-f0-9]{1,4}::?){1,7}[A-Fa-f0-9]{1,4})",
+            r"(?P(?:[0-9A-Fa-f]{1,2}-){7}[0-9A-Fa-f]{1,2}|(?:[0-9A-Fa-f]{1,2}:){7}[0-9A-Fa-f]{1,2}|(?:[0-9A-Fa-f]{4}\.){3}[0-9A-Fa-f]{4})",
+            r"(?P(?:[0-9A-Fa-f]{1,2}-){5}[0-9A-Fa-f]{1,2}|(?:[0-9A-Fa-f]{1,2}:){5}[0-9A-Fa-f]{1,2}|(?:[0-9A-Fa-f]{4}\.){2}[0-9A-Fa-f]{4})",
+            r"(?P[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})",
+            r"(?P[\w.]*?)\(",
+            r"\b(?PTrue)\b|\b(?PFalse)\b|\b(?PNone)\b",
+            r"(?P\.\.\.)",
+            r"(?P(?(?\B(/[-\w._+]+)*\/)(?P[-\w._+]*)?",
+            r"(?b?'''.*?(?(file|https|http|ws|wss)://[-0-9a-zA-Z$_+!`(),.?/;:&=%#~@]*)",
+        ),
+    ]
+
+
+class JSONHighlighter(RegexHighlighter):
+    """Highlights JSON"""
+
+    # Captures the start and end of JSON strings, handling escaped quotes
+    JSON_STR = r"(?b?\".*?(?[\{\[\(\)\]\}])",
+            r"\b(?Ptrue)\b|\b(?Pfalse)\b|\b(?Pnull)\b",
+            r"(?P(? None:
+        super().highlight(text)
+
+        # Additional work to handle highlighting JSON keys
+        plain = text.plain
+        append = text.spans.append
+        whitespace = self.JSON_WHITESPACE
+        for match in re.finditer(self.JSON_STR, plain):
+            start, end = match.span()
+            cursor = end
+            while cursor < len(plain):
+                char = plain[cursor]
+                cursor += 1
+                if char == ":":
+                    append(Span(start, end, "json.key"))
+                elif char in whitespace:
+                    continue
+                break
+
+
+class ISO8601Highlighter(RegexHighlighter):
+    """Highlights the ISO8601 date time strings.
+    Regex reference: https://www.oreilly.com/library/view/regular-expressions-cookbook/9781449327453/ch04s07.html
+    """
+
+    base_style = "iso8601."
+    highlights = [
+        #
+        # Dates
+        #
+        # Calendar month (e.g. 2008-08). The hyphen is required
+        r"^(?P[0-9]{4})-(?P1[0-2]|0[1-9])$",
+        # Calendar date w/o hyphens (e.g. 20080830)
+        r"^(?P(?P[0-9]{4})(?P1[0-2]|0[1-9])(?P3[01]|0[1-9]|[12][0-9]))$",
+        # Ordinal date (e.g. 2008-243). The hyphen is optional
+        r"^(?P(?P[0-9]{4})-?(?P36[0-6]|3[0-5][0-9]|[12][0-9]{2}|0[1-9][0-9]|00[1-9]))$",
+        #
+        # Weeks
+        #
+        # Week of the year (e.g., 2008-W35). The hyphen is optional
+        r"^(?P(?P[0-9]{4})-?W(?P5[0-3]|[1-4][0-9]|0[1-9]))$",
+        # Week date (e.g., 2008-W35-6). The hyphens are optional
+        r"^(?P(?P[0-9]{4})-?W(?P5[0-3]|[1-4][0-9]|0[1-9])-?(?P[1-7]))$",
+        #
+        # Times
+        #
+        # Hours and minutes (e.g., 17:21). The colon is optional
+        r"^(?P{text}'
+        append_fragment(text)
+
+    code = "".join(fragments)
+    html = JUPYTER_HTML_FORMAT.format(code=code)
+
+    return html
+
+
+def display(segments: Iterable[Segment], text: str) -> None:
+    """Render segments to Jupyter."""
+    html = _render_segments(segments)
+    jupyter_renderable = JupyterRenderable(html, text)
+    try:
+        from IPython.display import display as ipython_display
+
+        ipython_display(jupyter_renderable)
+    except ModuleNotFoundError:
+        # Handle the case where the Console has force_jupyter=True,
+        # but IPython is not installed.
+        pass
+
+
+def print(*args: Any, **kwargs: Any) -> None:
+    """Proxy for Console print."""
+    console = get_console()
+    return console.print(*args, **kwargs)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/layout.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/layout.py
new file mode 100644
index 0000000..a6f1a31
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/layout.py
@@ -0,0 +1,442 @@
+from abc import ABC, abstractmethod
+from itertools import islice
+from operator import itemgetter
+from threading import RLock
+from typing import (
+    TYPE_CHECKING,
+    Dict,
+    Iterable,
+    List,
+    NamedTuple,
+    Optional,
+    Sequence,
+    Tuple,
+    Union,
+)
+
+from ._ratio import ratio_resolve
+from .align import Align
+from .console import Console, ConsoleOptions, RenderableType, RenderResult
+from .highlighter import ReprHighlighter
+from .panel import Panel
+from .pretty import Pretty
+from .region import Region
+from .repr import Result, rich_repr
+from .segment import Segment
+from .style import StyleType
+
+if TYPE_CHECKING:
+    from pip._vendor.rich.tree import Tree
+
+
+class LayoutRender(NamedTuple):
+    """An individual layout render."""
+
+    region: Region
+    render: List[List[Segment]]
+
+
+RegionMap = Dict["Layout", Region]
+RenderMap = Dict["Layout", LayoutRender]
+
+
+class LayoutError(Exception):
+    """Layout related error."""
+
+
+class NoSplitter(LayoutError):
+    """Requested splitter does not exist."""
+
+
+class _Placeholder:
+    """An internal renderable used as a Layout placeholder."""
+
+    highlighter = ReprHighlighter()
+
+    def __init__(self, layout: "Layout", style: StyleType = "") -> None:
+        self.layout = layout
+        self.style = style
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        width = options.max_width
+        height = options.height or options.size.height
+        layout = self.layout
+        title = (
+            f"{layout.name!r} ({width} x {height})"
+            if layout.name
+            else f"({width} x {height})"
+        )
+        yield Panel(
+            Align.center(Pretty(layout), vertical="middle"),
+            style=self.style,
+            title=self.highlighter(title),
+            border_style="blue",
+            height=height,
+        )
+
+
+class Splitter(ABC):
+    """Base class for a splitter."""
+
+    name: str = ""
+
+    @abstractmethod
+    def get_tree_icon(self) -> str:
+        """Get the icon (emoji) used in layout.tree"""
+
+    @abstractmethod
+    def divide(
+        self, children: Sequence["Layout"], region: Region
+    ) -> Iterable[Tuple["Layout", Region]]:
+        """Divide a region amongst several child layouts.
+
+        Args:
+            children (Sequence(Layout)): A number of child layouts.
+            region (Region): A rectangular region to divide.
+        """
+
+
+class RowSplitter(Splitter):
+    """Split a layout region in to rows."""
+
+    name = "row"
+
+    def get_tree_icon(self) -> str:
+        return "[layout.tree.row]⬌"
+
+    def divide(
+        self, children: Sequence["Layout"], region: Region
+    ) -> Iterable[Tuple["Layout", Region]]:
+        x, y, width, height = region
+        render_widths = ratio_resolve(width, children)
+        offset = 0
+        _Region = Region
+        for child, child_width in zip(children, render_widths):
+            yield child, _Region(x + offset, y, child_width, height)
+            offset += child_width
+
+
+class ColumnSplitter(Splitter):
+    """Split a layout region in to columns."""
+
+    name = "column"
+
+    def get_tree_icon(self) -> str:
+        return "[layout.tree.column]⬍"
+
+    def divide(
+        self, children: Sequence["Layout"], region: Region
+    ) -> Iterable[Tuple["Layout", Region]]:
+        x, y, width, height = region
+        render_heights = ratio_resolve(height, children)
+        offset = 0
+        _Region = Region
+        for child, child_height in zip(children, render_heights):
+            yield child, _Region(x, y + offset, width, child_height)
+            offset += child_height
+
+
+@rich_repr
+class Layout:
+    """A renderable to divide a fixed height in to rows or columns.
+
+    Args:
+        renderable (RenderableType, optional): Renderable content, or None for placeholder. Defaults to None.
+        name (str, optional): Optional identifier for Layout. Defaults to None.
+        size (int, optional): Optional fixed size of layout. Defaults to None.
+        minimum_size (int, optional): Minimum size of layout. Defaults to 1.
+        ratio (int, optional): Optional ratio for flexible layout. Defaults to 1.
+        visible (bool, optional): Visibility of layout. Defaults to True.
+    """
+
+    splitters = {"row": RowSplitter, "column": ColumnSplitter}
+
+    def __init__(
+        self,
+        renderable: Optional[RenderableType] = None,
+        *,
+        name: Optional[str] = None,
+        size: Optional[int] = None,
+        minimum_size: int = 1,
+        ratio: int = 1,
+        visible: bool = True,
+    ) -> None:
+        self._renderable = renderable or _Placeholder(self)
+        self.size = size
+        self.minimum_size = minimum_size
+        self.ratio = ratio
+        self.name = name
+        self.visible = visible
+        self.splitter: Splitter = self.splitters["column"]()
+        self._children: List[Layout] = []
+        self._render_map: RenderMap = {}
+        self._lock = RLock()
+
+    def __rich_repr__(self) -> Result:
+        yield "name", self.name, None
+        yield "size", self.size, None
+        yield "minimum_size", self.minimum_size, 1
+        yield "ratio", self.ratio, 1
+
+    @property
+    def renderable(self) -> RenderableType:
+        """Layout renderable."""
+        return self if self._children else self._renderable
+
+    @property
+    def children(self) -> List["Layout"]:
+        """Gets (visible) layout children."""
+        return [child for child in self._children if child.visible]
+
+    @property
+    def map(self) -> RenderMap:
+        """Get a map of the last render."""
+        return self._render_map
+
+    def get(self, name: str) -> Optional["Layout"]:
+        """Get a named layout, or None if it doesn't exist.
+
+        Args:
+            name (str): Name of layout.
+
+        Returns:
+            Optional[Layout]: Layout instance or None if no layout was found.
+        """
+        if self.name == name:
+            return self
+        else:
+            for child in self._children:
+                named_layout = child.get(name)
+                if named_layout is not None:
+                    return named_layout
+        return None
+
+    def __getitem__(self, name: str) -> "Layout":
+        layout = self.get(name)
+        if layout is None:
+            raise KeyError(f"No layout with name {name!r}")
+        return layout
+
+    @property
+    def tree(self) -> "Tree":
+        """Get a tree renderable to show layout structure."""
+        from pip._vendor.rich.styled import Styled
+        from pip._vendor.rich.table import Table
+        from pip._vendor.rich.tree import Tree
+
+        def summary(layout: "Layout") -> Table:
+            icon = layout.splitter.get_tree_icon()
+
+            table = Table.grid(padding=(0, 1, 0, 0))
+
+            text: RenderableType = (
+                Pretty(layout) if layout.visible else Styled(Pretty(layout), "dim")
+            )
+            table.add_row(icon, text)
+            _summary = table
+            return _summary
+
+        layout = self
+        tree = Tree(
+            summary(layout),
+            guide_style=f"layout.tree.{layout.splitter.name}",
+            highlight=True,
+        )
+
+        def recurse(tree: "Tree", layout: "Layout") -> None:
+            for child in layout._children:
+                recurse(
+                    tree.add(
+                        summary(child),
+                        guide_style=f"layout.tree.{child.splitter.name}",
+                    ),
+                    child,
+                )
+
+        recurse(tree, self)
+        return tree
+
+    def split(
+        self,
+        *layouts: Union["Layout", RenderableType],
+        splitter: Union[Splitter, str] = "column",
+    ) -> None:
+        """Split the layout in to multiple sub-layouts.
+
+        Args:
+            *layouts (Layout): Positional arguments should be (sub) Layout instances.
+            splitter (Union[Splitter, str]): Splitter instance or name of splitter.
+        """
+        _layouts = [
+            layout if isinstance(layout, Layout) else Layout(layout)
+            for layout in layouts
+        ]
+        try:
+            self.splitter = (
+                splitter
+                if isinstance(splitter, Splitter)
+                else self.splitters[splitter]()
+            )
+        except KeyError:
+            raise NoSplitter(f"No splitter called {splitter!r}")
+        self._children[:] = _layouts
+
+    def add_split(self, *layouts: Union["Layout", RenderableType]) -> None:
+        """Add a new layout(s) to existing split.
+
+        Args:
+            *layouts (Union[Layout, RenderableType]): Positional arguments should be renderables or (sub) Layout instances.
+
+        """
+        _layouts = (
+            layout if isinstance(layout, Layout) else Layout(layout)
+            for layout in layouts
+        )
+        self._children.extend(_layouts)
+
+    def split_row(self, *layouts: Union["Layout", RenderableType]) -> None:
+        """Split the layout in to a row (layouts side by side).
+
+        Args:
+            *layouts (Layout): Positional arguments should be (sub) Layout instances.
+        """
+        self.split(*layouts, splitter="row")
+
+    def split_column(self, *layouts: Union["Layout", RenderableType]) -> None:
+        """Split the layout in to a column (layouts stacked on top of each other).
+
+        Args:
+            *layouts (Layout): Positional arguments should be (sub) Layout instances.
+        """
+        self.split(*layouts, splitter="column")
+
+    def unsplit(self) -> None:
+        """Reset splits to initial state."""
+        del self._children[:]
+
+    def update(self, renderable: RenderableType) -> None:
+        """Update renderable.
+
+        Args:
+            renderable (RenderableType): New renderable object.
+        """
+        with self._lock:
+            self._renderable = renderable
+
+    def refresh_screen(self, console: "Console", layout_name: str) -> None:
+        """Refresh a sub-layout.
+
+        Args:
+            console (Console): Console instance where Layout is to be rendered.
+            layout_name (str): Name of layout.
+        """
+        with self._lock:
+            layout = self[layout_name]
+            region, _lines = self._render_map[layout]
+            (x, y, width, height) = region
+            lines = console.render_lines(
+                layout, console.options.update_dimensions(width, height)
+            )
+            self._render_map[layout] = LayoutRender(region, lines)
+            console.update_screen_lines(lines, x, y)
+
+    def _make_region_map(self, width: int, height: int) -> RegionMap:
+        """Create a dict that maps layout on to Region."""
+        stack: List[Tuple[Layout, Region]] = [(self, Region(0, 0, width, height))]
+        push = stack.append
+        pop = stack.pop
+        layout_regions: List[Tuple[Layout, Region]] = []
+        append_layout_region = layout_regions.append
+        while stack:
+            append_layout_region(pop())
+            layout, region = layout_regions[-1]
+            children = layout.children
+            if children:
+                for child_and_region in layout.splitter.divide(children, region):
+                    push(child_and_region)
+
+        region_map = {
+            layout: region
+            for layout, region in sorted(layout_regions, key=itemgetter(1))
+        }
+        return region_map
+
+    def render(self, console: Console, options: ConsoleOptions) -> RenderMap:
+        """Render the sub_layouts.
+
+        Args:
+            console (Console): Console instance.
+            options (ConsoleOptions): Console options.
+
+        Returns:
+            RenderMap: A dict that maps Layout on to a tuple of Region, lines
+        """
+        render_width = options.max_width
+        render_height = options.height or console.height
+        region_map = self._make_region_map(render_width, render_height)
+        layout_regions = [
+            (layout, region)
+            for layout, region in region_map.items()
+            if not layout.children
+        ]
+        render_map: Dict["Layout", "LayoutRender"] = {}
+        render_lines = console.render_lines
+        update_dimensions = options.update_dimensions
+
+        for layout, region in layout_regions:
+            lines = render_lines(
+                layout.renderable, update_dimensions(region.width, region.height)
+            )
+            render_map[layout] = LayoutRender(region, lines)
+        return render_map
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        with self._lock:
+            width = options.max_width or console.width
+            height = options.height or console.height
+            render_map = self.render(console, options.update_dimensions(width, height))
+            self._render_map = render_map
+            layout_lines: List[List[Segment]] = [[] for _ in range(height)]
+            _islice = islice
+            for region, lines in render_map.values():
+                _x, y, _layout_width, layout_height = region
+                for row, line in zip(
+                    _islice(layout_lines, y, y + layout_height), lines
+                ):
+                    row.extend(line)
+
+            new_line = Segment.line()
+            for layout_row in layout_lines:
+                yield from layout_row
+                yield new_line
+
+
+if __name__ == "__main__":
+    from pip._vendor.rich.console import Console
+
+    console = Console()
+    layout = Layout()
+
+    layout.split_column(
+        Layout(name="header", size=3),
+        Layout(ratio=1, name="main"),
+        Layout(size=10, name="footer"),
+    )
+
+    layout["main"].split_row(Layout(name="side"), Layout(name="body", ratio=2))
+
+    layout["body"].split_row(Layout(name="content", ratio=2), Layout(name="s2"))
+
+    layout["s2"].split_column(
+        Layout(name="top"), Layout(name="middle"), Layout(name="bottom")
+    )
+
+    layout["side"].split_column(Layout(layout.tree, name="left1"), Layout(name="left2"))
+
+    layout["content"].update("foo")
+
+    console.print(layout)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/live.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/live.py
new file mode 100644
index 0000000..8738cf0
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/live.py
@@ -0,0 +1,375 @@
+import sys
+from threading import Event, RLock, Thread
+from types import TracebackType
+from typing import IO, Any, Callable, List, Optional, TextIO, Type, cast
+
+from . import get_console
+from .console import Console, ConsoleRenderable, RenderableType, RenderHook
+from .control import Control
+from .file_proxy import FileProxy
+from .jupyter import JupyterMixin
+from .live_render import LiveRender, VerticalOverflowMethod
+from .screen import Screen
+from .text import Text
+
+
+class _RefreshThread(Thread):
+    """A thread that calls refresh() at regular intervals."""
+
+    def __init__(self, live: "Live", refresh_per_second: float) -> None:
+        self.live = live
+        self.refresh_per_second = refresh_per_second
+        self.done = Event()
+        super().__init__(daemon=True)
+
+    def stop(self) -> None:
+        self.done.set()
+
+    def run(self) -> None:
+        while not self.done.wait(1 / self.refresh_per_second):
+            with self.live._lock:
+                if not self.done.is_set():
+                    self.live.refresh()
+
+
+class Live(JupyterMixin, RenderHook):
+    """Renders an auto-updating live display of any given renderable.
+
+    Args:
+        renderable (RenderableType, optional): The renderable to live display. Defaults to displaying nothing.
+        console (Console, optional): Optional Console instance. Defaults to an internal Console instance writing to stdout.
+        screen (bool, optional): Enable alternate screen mode. Defaults to False.
+        auto_refresh (bool, optional): Enable auto refresh. If disabled, you will need to call `refresh()` or `update()` with refresh flag. Defaults to True
+        refresh_per_second (float, optional): Number of times per second to refresh the live display. Defaults to 4.
+        transient (bool, optional): Clear the renderable on exit (has no effect when screen=True). Defaults to False.
+        redirect_stdout (bool, optional): Enable redirection of stdout, so ``print`` may be used. Defaults to True.
+        redirect_stderr (bool, optional): Enable redirection of stderr. Defaults to True.
+        vertical_overflow (VerticalOverflowMethod, optional): How to handle renderable when it is too tall for the console. Defaults to "ellipsis".
+        get_renderable (Callable[[], RenderableType], optional): Optional callable to get renderable. Defaults to None.
+    """
+
+    def __init__(
+        self,
+        renderable: Optional[RenderableType] = None,
+        *,
+        console: Optional[Console] = None,
+        screen: bool = False,
+        auto_refresh: bool = True,
+        refresh_per_second: float = 4,
+        transient: bool = False,
+        redirect_stdout: bool = True,
+        redirect_stderr: bool = True,
+        vertical_overflow: VerticalOverflowMethod = "ellipsis",
+        get_renderable: Optional[Callable[[], RenderableType]] = None,
+    ) -> None:
+        assert refresh_per_second > 0, "refresh_per_second must be > 0"
+        self._renderable = renderable
+        self.console = console if console is not None else get_console()
+        self._screen = screen
+        self._alt_screen = False
+
+        self._redirect_stdout = redirect_stdout
+        self._redirect_stderr = redirect_stderr
+        self._restore_stdout: Optional[IO[str]] = None
+        self._restore_stderr: Optional[IO[str]] = None
+
+        self._lock = RLock()
+        self.ipy_widget: Optional[Any] = None
+        self.auto_refresh = auto_refresh
+        self._started: bool = False
+        self.transient = True if screen else transient
+
+        self._refresh_thread: Optional[_RefreshThread] = None
+        self.refresh_per_second = refresh_per_second
+
+        self.vertical_overflow = vertical_overflow
+        self._get_renderable = get_renderable
+        self._live_render = LiveRender(
+            self.get_renderable(), vertical_overflow=vertical_overflow
+        )
+
+    @property
+    def is_started(self) -> bool:
+        """Check if live display has been started."""
+        return self._started
+
+    def get_renderable(self) -> RenderableType:
+        renderable = (
+            self._get_renderable()
+            if self._get_renderable is not None
+            else self._renderable
+        )
+        return renderable or ""
+
+    def start(self, refresh: bool = False) -> None:
+        """Start live rendering display.
+
+        Args:
+            refresh (bool, optional): Also refresh. Defaults to False.
+        """
+        with self._lock:
+            if self._started:
+                return
+            self.console.set_live(self)
+            self._started = True
+            if self._screen:
+                self._alt_screen = self.console.set_alt_screen(True)
+            self.console.show_cursor(False)
+            self._enable_redirect_io()
+            self.console.push_render_hook(self)
+            if refresh:
+                try:
+                    self.refresh()
+                except Exception:
+                    # If refresh fails, we want to stop the redirection of sys.stderr,
+                    # so the error stacktrace is properly displayed in the terminal.
+                    # (or, if the code that calls Rich captures the exception and wants to display something,
+                    # let this be displayed in the terminal).
+                    self.stop()
+                    raise
+            if self.auto_refresh:
+                self._refresh_thread = _RefreshThread(self, self.refresh_per_second)
+                self._refresh_thread.start()
+
+    def stop(self) -> None:
+        """Stop live rendering display."""
+        with self._lock:
+            if not self._started:
+                return
+            self.console.clear_live()
+            self._started = False
+
+            if self.auto_refresh and self._refresh_thread is not None:
+                self._refresh_thread.stop()
+                self._refresh_thread = None
+            # allow it to fully render on the last even if overflow
+            self.vertical_overflow = "visible"
+            with self.console:
+                try:
+                    if not self._alt_screen and not self.console.is_jupyter:
+                        self.refresh()
+                finally:
+                    self._disable_redirect_io()
+                    self.console.pop_render_hook()
+                    if not self._alt_screen and self.console.is_terminal:
+                        self.console.line()
+                    self.console.show_cursor(True)
+                    if self._alt_screen:
+                        self.console.set_alt_screen(False)
+
+                    if self.transient and not self._alt_screen:
+                        self.console.control(self._live_render.restore_cursor())
+                    if self.ipy_widget is not None and self.transient:
+                        self.ipy_widget.close()  # pragma: no cover
+
+    def __enter__(self) -> "Live":
+        self.start(refresh=self._renderable is not None)
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.stop()
+
+    def _enable_redirect_io(self) -> None:
+        """Enable redirecting of stdout / stderr."""
+        if self.console.is_terminal or self.console.is_jupyter:
+            if self._redirect_stdout and not isinstance(sys.stdout, FileProxy):
+                self._restore_stdout = sys.stdout
+                sys.stdout = cast("TextIO", FileProxy(self.console, sys.stdout))
+            if self._redirect_stderr and not isinstance(sys.stderr, FileProxy):
+                self._restore_stderr = sys.stderr
+                sys.stderr = cast("TextIO", FileProxy(self.console, sys.stderr))
+
+    def _disable_redirect_io(self) -> None:
+        """Disable redirecting of stdout / stderr."""
+        if self._restore_stdout:
+            sys.stdout = cast("TextIO", self._restore_stdout)
+            self._restore_stdout = None
+        if self._restore_stderr:
+            sys.stderr = cast("TextIO", self._restore_stderr)
+            self._restore_stderr = None
+
+    @property
+    def renderable(self) -> RenderableType:
+        """Get the renderable that is being displayed
+
+        Returns:
+            RenderableType: Displayed renderable.
+        """
+        renderable = self.get_renderable()
+        return Screen(renderable) if self._alt_screen else renderable
+
+    def update(self, renderable: RenderableType, *, refresh: bool = False) -> None:
+        """Update the renderable that is being displayed
+
+        Args:
+            renderable (RenderableType): New renderable to use.
+            refresh (bool, optional): Refresh the display. Defaults to False.
+        """
+        if isinstance(renderable, str):
+            renderable = self.console.render_str(renderable)
+        with self._lock:
+            self._renderable = renderable
+            if refresh:
+                self.refresh()
+
+    def refresh(self) -> None:
+        """Update the display of the Live Render."""
+        with self._lock:
+            self._live_render.set_renderable(self.renderable)
+            if self.console.is_jupyter:  # pragma: no cover
+                try:
+                    from IPython.display import display
+                    from ipywidgets import Output
+                except ImportError:
+                    import warnings
+
+                    warnings.warn('install "ipywidgets" for Jupyter support')
+                else:
+                    if self.ipy_widget is None:
+                        self.ipy_widget = Output()
+                        display(self.ipy_widget)
+
+                    with self.ipy_widget:
+                        self.ipy_widget.clear_output(wait=True)
+                        self.console.print(self._live_render.renderable)
+            elif self.console.is_terminal and not self.console.is_dumb_terminal:
+                with self.console:
+                    self.console.print(Control())
+            elif (
+                not self._started and not self.transient
+            ):  # if it is finished allow files or dumb-terminals to see final result
+                with self.console:
+                    self.console.print(Control())
+
+    def process_renderables(
+        self, renderables: List[ConsoleRenderable]
+    ) -> List[ConsoleRenderable]:
+        """Process renderables to restore cursor and display progress."""
+        self._live_render.vertical_overflow = self.vertical_overflow
+        if self.console.is_interactive:
+            # lock needs acquiring as user can modify live_render renderable at any time unlike in Progress.
+            with self._lock:
+                reset = (
+                    Control.home()
+                    if self._alt_screen
+                    else self._live_render.position_cursor()
+                )
+                renderables = [reset, *renderables, self._live_render]
+        elif (
+            not self._started and not self.transient
+        ):  # if it is finished render the final output for files or dumb_terminals
+            renderables = [*renderables, self._live_render]
+
+        return renderables
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import random
+    import time
+    from itertools import cycle
+    from typing import Dict, List, Tuple
+
+    from .align import Align
+    from .console import Console
+    from .live import Live as Live
+    from .panel import Panel
+    from .rule import Rule
+    from .syntax import Syntax
+    from .table import Table
+
+    console = Console()
+
+    syntax = Syntax(
+        '''def loop_last(values: Iterable[T]) -> Iterable[Tuple[bool, T]]:
+    """Iterate and generate a tuple with a flag for last value."""
+    iter_values = iter(values)
+    try:
+        previous_value = next(iter_values)
+    except StopIteration:
+        return
+    for value in iter_values:
+        yield False, previous_value
+        previous_value = value
+    yield True, previous_value''',
+        "python",
+        line_numbers=True,
+    )
+
+    table = Table("foo", "bar", "baz")
+    table.add_row("1", "2", "3")
+
+    progress_renderables = [
+        "You can make the terminal shorter and taller to see the live table hide"
+        "Text may be printed while the progress bars are rendering.",
+        Panel("In fact, [i]any[/i] renderable will work"),
+        "Such as [magenta]tables[/]...",
+        table,
+        "Pretty printed structures...",
+        {"type": "example", "text": "Pretty printed"},
+        "Syntax...",
+        syntax,
+        Rule("Give it a try!"),
+    ]
+
+    examples = cycle(progress_renderables)
+
+    exchanges = [
+        "SGD",
+        "MYR",
+        "EUR",
+        "USD",
+        "AUD",
+        "JPY",
+        "CNH",
+        "HKD",
+        "CAD",
+        "INR",
+        "DKK",
+        "GBP",
+        "RUB",
+        "NZD",
+        "MXN",
+        "IDR",
+        "TWD",
+        "THB",
+        "VND",
+    ]
+    with Live(console=console) as live_table:
+        exchange_rate_dict: Dict[Tuple[str, str], float] = {}
+
+        for index in range(100):
+            select_exchange = exchanges[index % len(exchanges)]
+
+            for exchange in exchanges:
+                if exchange == select_exchange:
+                    continue
+                time.sleep(0.4)
+                if random.randint(0, 10) < 1:
+                    console.log(next(examples))
+                exchange_rate_dict[(select_exchange, exchange)] = 200 / (
+                    (random.random() * 320) + 1
+                )
+                if len(exchange_rate_dict) > len(exchanges) - 1:
+                    exchange_rate_dict.pop(list(exchange_rate_dict.keys())[0])
+                table = Table(title="Exchange Rates")
+
+                table.add_column("Source Currency")
+                table.add_column("Destination Currency")
+                table.add_column("Exchange Rate")
+
+                for (source, dest), exchange_rate in exchange_rate_dict.items():
+                    table.add_row(
+                        source,
+                        dest,
+                        Text(
+                            f"{exchange_rate:.4f}",
+                            style="red" if exchange_rate < 1.0 else "green",
+                        ),
+                    )
+
+                live_table.update(Align.center(table))
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/live_render.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/live_render.py
new file mode 100644
index 0000000..e20745d
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/live_render.py
@@ -0,0 +1,112 @@
+import sys
+from typing import Optional, Tuple
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from pip._vendor.typing_extensions import Literal  # pragma: no cover
+
+
+from ._loop import loop_last
+from .console import Console, ConsoleOptions, RenderableType, RenderResult
+from .control import Control
+from .segment import ControlType, Segment
+from .style import StyleType
+from .text import Text
+
+VerticalOverflowMethod = Literal["crop", "ellipsis", "visible"]
+
+
+class LiveRender:
+    """Creates a renderable that may be updated.
+
+    Args:
+        renderable (RenderableType): Any renderable object.
+        style (StyleType, optional): An optional style to apply to the renderable. Defaults to "".
+    """
+
+    def __init__(
+        self,
+        renderable: RenderableType,
+        style: StyleType = "",
+        vertical_overflow: VerticalOverflowMethod = "ellipsis",
+    ) -> None:
+        self.renderable = renderable
+        self.style = style
+        self.vertical_overflow = vertical_overflow
+        self._shape: Optional[Tuple[int, int]] = None
+
+    def set_renderable(self, renderable: RenderableType) -> None:
+        """Set a new renderable.
+
+        Args:
+            renderable (RenderableType): Any renderable object, including str.
+        """
+        self.renderable = renderable
+
+    def position_cursor(self) -> Control:
+        """Get control codes to move cursor to beginning of live render.
+
+        Returns:
+            Control: A control instance that may be printed.
+        """
+        if self._shape is not None:
+            _, height = self._shape
+            return Control(
+                ControlType.CARRIAGE_RETURN,
+                (ControlType.ERASE_IN_LINE, 2),
+                *(
+                    (
+                        (ControlType.CURSOR_UP, 1),
+                        (ControlType.ERASE_IN_LINE, 2),
+                    )
+                    * (height - 1)
+                )
+            )
+        return Control()
+
+    def restore_cursor(self) -> Control:
+        """Get control codes to clear the render and restore the cursor to its previous position.
+
+        Returns:
+            Control: A Control instance that may be printed.
+        """
+        if self._shape is not None:
+            _, height = self._shape
+            return Control(
+                ControlType.CARRIAGE_RETURN,
+                *((ControlType.CURSOR_UP, 1), (ControlType.ERASE_IN_LINE, 2)) * height
+            )
+        return Control()
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        renderable = self.renderable
+        style = console.get_style(self.style)
+        lines = console.render_lines(renderable, options, style=style, pad=False)
+        shape = Segment.get_shape(lines)
+
+        _, height = shape
+        if height > options.size.height:
+            if self.vertical_overflow == "crop":
+                lines = lines[: options.size.height]
+                shape = Segment.get_shape(lines)
+            elif self.vertical_overflow == "ellipsis":
+                lines = lines[: (options.size.height - 1)]
+                overflow_text = Text(
+                    "...",
+                    overflow="crop",
+                    justify="center",
+                    end="",
+                    style="live.ellipsis",
+                )
+                lines.append(list(console.render(overflow_text)))
+                shape = Segment.get_shape(lines)
+        self._shape = shape
+
+        new_line = Segment.line()
+        for last, line in loop_last(lines):
+            yield from line
+            if not last:
+                yield new_line
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/logging.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/logging.py
new file mode 100644
index 0000000..ff8d5d9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/logging.py
@@ -0,0 +1,297 @@
+import logging
+from datetime import datetime
+from logging import Handler, LogRecord
+from pathlib import Path
+from types import ModuleType
+from typing import ClassVar, Iterable, List, Optional, Type, Union
+
+from pip._vendor.rich._null_file import NullFile
+
+from . import get_console
+from ._log_render import FormatTimeCallable, LogRender
+from .console import Console, ConsoleRenderable
+from .highlighter import Highlighter, ReprHighlighter
+from .text import Text
+from .traceback import Traceback
+
+
+class RichHandler(Handler):
+    """A logging handler that renders output with Rich. The time / level / message and file are displayed in columns.
+    The level is color coded, and the message is syntax highlighted.
+
+    Note:
+        Be careful when enabling console markup in log messages if you have configured logging for libraries not
+        under your control. If a dependency writes messages containing square brackets, it may not produce the intended output.
+
+    Args:
+        level (Union[int, str], optional): Log level. Defaults to logging.NOTSET.
+        console (:class:`~rich.console.Console`, optional): Optional console instance to write logs.
+            Default will use a global console instance writing to stdout.
+        show_time (bool, optional): Show a column for the time. Defaults to True.
+        omit_repeated_times (bool, optional): Omit repetition of the same time. Defaults to True.
+        show_level (bool, optional): Show a column for the level. Defaults to True.
+        show_path (bool, optional): Show the path to the original log call. Defaults to True.
+        enable_link_path (bool, optional): Enable terminal link of path column to file. Defaults to True.
+        highlighter (Highlighter, optional): Highlighter to style log messages, or None to use ReprHighlighter. Defaults to None.
+        markup (bool, optional): Enable console markup in log messages. Defaults to False.
+        rich_tracebacks (bool, optional): Enable rich tracebacks with syntax highlighting and formatting. Defaults to False.
+        tracebacks_width (Optional[int], optional): Number of characters used to render tracebacks, or None for full width. Defaults to None.
+        tracebacks_code_width (int, optional): Number of code characters used to render tracebacks, or None for full width. Defaults to 88.
+        tracebacks_extra_lines (int, optional): Additional lines of code to render tracebacks, or None for full width. Defaults to None.
+        tracebacks_theme (str, optional): Override pygments theme used in traceback.
+        tracebacks_word_wrap (bool, optional): Enable word wrapping of long tracebacks lines. Defaults to True.
+        tracebacks_show_locals (bool, optional): Enable display of locals in tracebacks. Defaults to False.
+        tracebacks_suppress (Sequence[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
+        tracebacks_max_frames (int, optional): Optional maximum number of frames returned by traceback.
+        locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to 10.
+        locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+        log_time_format (Union[str, TimeFormatterCallable], optional): If ``log_time`` is enabled, either string for strftime or callable that formats the time. Defaults to "[%x %X] ".
+        keywords (List[str], optional): List of words to highlight instead of ``RichHandler.KEYWORDS``.
+    """
+
+    KEYWORDS: ClassVar[Optional[List[str]]] = [
+        "GET",
+        "POST",
+        "HEAD",
+        "PUT",
+        "DELETE",
+        "OPTIONS",
+        "TRACE",
+        "PATCH",
+    ]
+    HIGHLIGHTER_CLASS: ClassVar[Type[Highlighter]] = ReprHighlighter
+
+    def __init__(
+        self,
+        level: Union[int, str] = logging.NOTSET,
+        console: Optional[Console] = None,
+        *,
+        show_time: bool = True,
+        omit_repeated_times: bool = True,
+        show_level: bool = True,
+        show_path: bool = True,
+        enable_link_path: bool = True,
+        highlighter: Optional[Highlighter] = None,
+        markup: bool = False,
+        rich_tracebacks: bool = False,
+        tracebacks_width: Optional[int] = None,
+        tracebacks_code_width: int = 88,
+        tracebacks_extra_lines: int = 3,
+        tracebacks_theme: Optional[str] = None,
+        tracebacks_word_wrap: bool = True,
+        tracebacks_show_locals: bool = False,
+        tracebacks_suppress: Iterable[Union[str, ModuleType]] = (),
+        tracebacks_max_frames: int = 100,
+        locals_max_length: int = 10,
+        locals_max_string: int = 80,
+        log_time_format: Union[str, FormatTimeCallable] = "[%x %X]",
+        keywords: Optional[List[str]] = None,
+    ) -> None:
+        super().__init__(level=level)
+        self.console = console or get_console()
+        self.highlighter = highlighter or self.HIGHLIGHTER_CLASS()
+        self._log_render = LogRender(
+            show_time=show_time,
+            show_level=show_level,
+            show_path=show_path,
+            time_format=log_time_format,
+            omit_repeated_times=omit_repeated_times,
+            level_width=None,
+        )
+        self.enable_link_path = enable_link_path
+        self.markup = markup
+        self.rich_tracebacks = rich_tracebacks
+        self.tracebacks_width = tracebacks_width
+        self.tracebacks_extra_lines = tracebacks_extra_lines
+        self.tracebacks_theme = tracebacks_theme
+        self.tracebacks_word_wrap = tracebacks_word_wrap
+        self.tracebacks_show_locals = tracebacks_show_locals
+        self.tracebacks_suppress = tracebacks_suppress
+        self.tracebacks_max_frames = tracebacks_max_frames
+        self.tracebacks_code_width = tracebacks_code_width
+        self.locals_max_length = locals_max_length
+        self.locals_max_string = locals_max_string
+        self.keywords = keywords
+
+    def get_level_text(self, record: LogRecord) -> Text:
+        """Get the level name from the record.
+
+        Args:
+            record (LogRecord): LogRecord instance.
+
+        Returns:
+            Text: A tuple of the style and level name.
+        """
+        level_name = record.levelname
+        level_text = Text.styled(
+            level_name.ljust(8), f"logging.level.{level_name.lower()}"
+        )
+        return level_text
+
+    def emit(self, record: LogRecord) -> None:
+        """Invoked by logging."""
+        message = self.format(record)
+        traceback = None
+        if (
+            self.rich_tracebacks
+            and record.exc_info
+            and record.exc_info != (None, None, None)
+        ):
+            exc_type, exc_value, exc_traceback = record.exc_info
+            assert exc_type is not None
+            assert exc_value is not None
+            traceback = Traceback.from_exception(
+                exc_type,
+                exc_value,
+                exc_traceback,
+                width=self.tracebacks_width,
+                code_width=self.tracebacks_code_width,
+                extra_lines=self.tracebacks_extra_lines,
+                theme=self.tracebacks_theme,
+                word_wrap=self.tracebacks_word_wrap,
+                show_locals=self.tracebacks_show_locals,
+                locals_max_length=self.locals_max_length,
+                locals_max_string=self.locals_max_string,
+                suppress=self.tracebacks_suppress,
+                max_frames=self.tracebacks_max_frames,
+            )
+            message = record.getMessage()
+            if self.formatter:
+                record.message = record.getMessage()
+                formatter = self.formatter
+                if hasattr(formatter, "usesTime") and formatter.usesTime():
+                    record.asctime = formatter.formatTime(record, formatter.datefmt)
+                message = formatter.formatMessage(record)
+
+        message_renderable = self.render_message(record, message)
+        log_renderable = self.render(
+            record=record, traceback=traceback, message_renderable=message_renderable
+        )
+        if isinstance(self.console.file, NullFile):
+            # Handles pythonw, where stdout/stderr are null, and we return NullFile
+            # instance from Console.file. In this case, we still want to make a log record
+            # even though we won't be writing anything to a file.
+            self.handleError(record)
+        else:
+            try:
+                self.console.print(log_renderable)
+            except Exception:
+                self.handleError(record)
+
+    def render_message(self, record: LogRecord, message: str) -> "ConsoleRenderable":
+        """Render message text in to Text.
+
+        Args:
+            record (LogRecord): logging Record.
+            message (str): String containing log message.
+
+        Returns:
+            ConsoleRenderable: Renderable to display log message.
+        """
+        use_markup = getattr(record, "markup", self.markup)
+        message_text = Text.from_markup(message) if use_markup else Text(message)
+
+        highlighter = getattr(record, "highlighter", self.highlighter)
+        if highlighter:
+            message_text = highlighter(message_text)
+
+        if self.keywords is None:
+            self.keywords = self.KEYWORDS
+
+        if self.keywords:
+            message_text.highlight_words(self.keywords, "logging.keyword")
+
+        return message_text
+
+    def render(
+        self,
+        *,
+        record: LogRecord,
+        traceback: Optional[Traceback],
+        message_renderable: "ConsoleRenderable",
+    ) -> "ConsoleRenderable":
+        """Render log for display.
+
+        Args:
+            record (LogRecord): logging Record.
+            traceback (Optional[Traceback]): Traceback instance or None for no Traceback.
+            message_renderable (ConsoleRenderable): Renderable (typically Text) containing log message contents.
+
+        Returns:
+            ConsoleRenderable: Renderable to display log.
+        """
+        path = Path(record.pathname).name
+        level = self.get_level_text(record)
+        time_format = None if self.formatter is None else self.formatter.datefmt
+        log_time = datetime.fromtimestamp(record.created)
+
+        log_renderable = self._log_render(
+            self.console,
+            [message_renderable] if not traceback else [message_renderable, traceback],
+            log_time=log_time,
+            time_format=time_format,
+            level=level,
+            path=path,
+            line_no=record.lineno,
+            link_path=record.pathname if self.enable_link_path else None,
+        )
+        return log_renderable
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from time import sleep
+
+    FORMAT = "%(message)s"
+    # FORMAT = "%(asctime)-15s - %(levelname)s - %(message)s"
+    logging.basicConfig(
+        level="NOTSET",
+        format=FORMAT,
+        datefmt="[%X]",
+        handlers=[RichHandler(rich_tracebacks=True, tracebacks_show_locals=True)],
+    )
+    log = logging.getLogger("rich")
+
+    log.info("Server starting...")
+    log.info("Listening on http://127.0.0.1:8080")
+    sleep(1)
+
+    log.info("GET /index.html 200 1298")
+    log.info("GET /imgs/backgrounds/back1.jpg 200 54386")
+    log.info("GET /css/styles.css 200 54386")
+    log.warning("GET /favicon.ico 404 242")
+    sleep(1)
+
+    log.debug(
+        "JSONRPC request\n--> %r\n<-- %r",
+        {
+            "version": "1.1",
+            "method": "confirmFruitPurchase",
+            "params": [["apple", "orange", "mangoes", "pomelo"], 1.123],
+            "id": "194521489",
+        },
+        {"version": "1.1", "result": True, "error": None, "id": "194521489"},
+    )
+    log.debug(
+        "Loading configuration file /adasd/asdasd/qeqwe/qwrqwrqwr/sdgsdgsdg/werwerwer/dfgerert/ertertert/ertetert/werwerwer"
+    )
+    log.error("Unable to find 'pomelo' in database!")
+    log.info("POST /jsonrpc/ 200 65532")
+    log.info("POST /admin/ 401 42234")
+    log.warning("password was rejected for admin site.")
+
+    def divide() -> None:
+        number = 1
+        divisor = 0
+        foos = ["foo"] * 100
+        log.debug("in divide")
+        try:
+            number / divisor
+        except:
+            log.exception("An error of some kind occurred!")
+
+    divide()
+    sleep(1)
+    log.critical("Out of memory!")
+    log.info("Server exited with code=-1")
+    log.info("[bold]EXITING...[/bold]", extra=dict(markup=True))
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/markup.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/markup.py
new file mode 100644
index 0000000..f617187
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/markup.py
@@ -0,0 +1,251 @@
+import re
+from ast import literal_eval
+from operator import attrgetter
+from typing import Callable, Iterable, List, Match, NamedTuple, Optional, Tuple, Union
+
+from ._emoji_replace import _emoji_replace
+from .emoji import EmojiVariant
+from .errors import MarkupError
+from .style import Style
+from .text import Span, Text
+
+RE_TAGS = re.compile(
+    r"""((\\*)\[([a-z#/@][^[]*?)])""",
+    re.VERBOSE,
+)
+
+RE_HANDLER = re.compile(r"^([\w.]*?)(\(.*?\))?$")
+
+
+class Tag(NamedTuple):
+    """A tag in console markup."""
+
+    name: str
+    """The tag name. e.g. 'bold'."""
+    parameters: Optional[str]
+    """Any additional parameters after the name."""
+
+    def __str__(self) -> str:
+        return (
+            self.name if self.parameters is None else f"{self.name} {self.parameters}"
+        )
+
+    @property
+    def markup(self) -> str:
+        """Get the string representation of this tag."""
+        return (
+            f"[{self.name}]"
+            if self.parameters is None
+            else f"[{self.name}={self.parameters}]"
+        )
+
+
+_ReStringMatch = Match[str]  # regex match object
+_ReSubCallable = Callable[[_ReStringMatch], str]  # Callable invoked by re.sub
+_EscapeSubMethod = Callable[[_ReSubCallable, str], str]  # Sub method of a compiled re
+
+
+def escape(
+    markup: str,
+    _escape: _EscapeSubMethod = re.compile(r"(\\*)(\[[a-z#/@][^[]*?])").sub,
+) -> str:
+    """Escapes text so that it won't be interpreted as markup.
+
+    Args:
+        markup (str): Content to be inserted in to markup.
+
+    Returns:
+        str: Markup with square brackets escaped.
+    """
+
+    def escape_backslashes(match: Match[str]) -> str:
+        """Called by re.sub replace matches."""
+        backslashes, text = match.groups()
+        return f"{backslashes}{backslashes}\\{text}"
+
+    markup = _escape(escape_backslashes, markup)
+    if markup.endswith("\\") and not markup.endswith("\\\\"):
+        return markup + "\\"
+
+    return markup
+
+
+def _parse(markup: str) -> Iterable[Tuple[int, Optional[str], Optional[Tag]]]:
+    """Parse markup in to an iterable of tuples of (position, text, tag).
+
+    Args:
+        markup (str): A string containing console markup
+
+    """
+    position = 0
+    _divmod = divmod
+    _Tag = Tag
+    for match in RE_TAGS.finditer(markup):
+        full_text, escapes, tag_text = match.groups()
+        start, end = match.span()
+        if start > position:
+            yield start, markup[position:start], None
+        if escapes:
+            backslashes, escaped = _divmod(len(escapes), 2)
+            if backslashes:
+                # Literal backslashes
+                yield start, "\\" * backslashes, None
+                start += backslashes * 2
+            if escaped:
+                # Escape of tag
+                yield start, full_text[len(escapes) :], None
+                position = end
+                continue
+        text, equals, parameters = tag_text.partition("=")
+        yield start, None, _Tag(text, parameters if equals else None)
+        position = end
+    if position < len(markup):
+        yield position, markup[position:], None
+
+
+def render(
+    markup: str,
+    style: Union[str, Style] = "",
+    emoji: bool = True,
+    emoji_variant: Optional[EmojiVariant] = None,
+) -> Text:
+    """Render console markup in to a Text instance.
+
+    Args:
+        markup (str): A string containing console markup.
+        style: (Union[str, Style]): The style to use.
+        emoji (bool, optional): Also render emoji code. Defaults to True.
+        emoji_variant (str, optional): Optional emoji variant, either "text" or "emoji". Defaults to None.
+
+
+    Raises:
+        MarkupError: If there is a syntax error in the markup.
+
+    Returns:
+        Text: A test instance.
+    """
+    emoji_replace = _emoji_replace
+    if "[" not in markup:
+        return Text(
+            emoji_replace(markup, default_variant=emoji_variant) if emoji else markup,
+            style=style,
+        )
+    text = Text(style=style)
+    append = text.append
+    normalize = Style.normalize
+
+    style_stack: List[Tuple[int, Tag]] = []
+    pop = style_stack.pop
+
+    spans: List[Span] = []
+    append_span = spans.append
+
+    _Span = Span
+    _Tag = Tag
+
+    def pop_style(style_name: str) -> Tuple[int, Tag]:
+        """Pop tag matching given style name."""
+        for index, (_, tag) in enumerate(reversed(style_stack), 1):
+            if tag.name == style_name:
+                return pop(-index)
+        raise KeyError(style_name)
+
+    for position, plain_text, tag in _parse(markup):
+        if plain_text is not None:
+            # Handle open brace escapes, where the brace is not part of a tag.
+            plain_text = plain_text.replace("\\[", "[")
+            append(emoji_replace(plain_text) if emoji else plain_text)
+        elif tag is not None:
+            if tag.name.startswith("/"):  # Closing tag
+                style_name = tag.name[1:].strip()
+
+                if style_name:  # explicit close
+                    style_name = normalize(style_name)
+                    try:
+                        start, open_tag = pop_style(style_name)
+                    except KeyError:
+                        raise MarkupError(
+                            f"closing tag '{tag.markup}' at position {position} doesn't match any open tag"
+                        ) from None
+                else:  # implicit close
+                    try:
+                        start, open_tag = pop()
+                    except IndexError:
+                        raise MarkupError(
+                            f"closing tag '[/]' at position {position} has nothing to close"
+                        ) from None
+
+                if open_tag.name.startswith("@"):
+                    if open_tag.parameters:
+                        handler_name = ""
+                        parameters = open_tag.parameters.strip()
+                        handler_match = RE_HANDLER.match(parameters)
+                        if handler_match is not None:
+                            handler_name, match_parameters = handler_match.groups()
+                            parameters = (
+                                "()" if match_parameters is None else match_parameters
+                            )
+
+                        try:
+                            meta_params = literal_eval(parameters)
+                        except SyntaxError as error:
+                            raise MarkupError(
+                                f"error parsing {parameters!r} in {open_tag.parameters!r}; {error.msg}"
+                            )
+                        except Exception as error:
+                            raise MarkupError(
+                                f"error parsing {open_tag.parameters!r}; {error}"
+                            ) from None
+
+                        if handler_name:
+                            meta_params = (
+                                handler_name,
+                                meta_params
+                                if isinstance(meta_params, tuple)
+                                else (meta_params,),
+                            )
+
+                    else:
+                        meta_params = ()
+
+                    append_span(
+                        _Span(
+                            start, len(text), Style(meta={open_tag.name: meta_params})
+                        )
+                    )
+                else:
+                    append_span(_Span(start, len(text), str(open_tag)))
+
+            else:  # Opening tag
+                normalized_tag = _Tag(normalize(tag.name), tag.parameters)
+                style_stack.append((len(text), normalized_tag))
+
+    text_length = len(text)
+    while style_stack:
+        start, tag = style_stack.pop()
+        style = str(tag)
+        if style:
+            append_span(_Span(start, text_length, style))
+
+    text.spans = sorted(spans[::-1], key=attrgetter("start"))
+    return text
+
+
+if __name__ == "__main__":  # pragma: no cover
+    MARKUP = [
+        "[red]Hello World[/red]",
+        "[magenta]Hello [b]World[/b]",
+        "[bold]Bold[italic] bold and italic [/bold]italic[/italic]",
+        "Click [link=https://www.willmcgugan.com]here[/link] to visit my Blog",
+        ":warning-emoji: [bold red blink] DANGER![/]",
+    ]
+
+    from pip._vendor.rich import print
+    from pip._vendor.rich.table import Table
+
+    grid = Table("Markup", "Result", padding=(0, 1))
+
+    for markup in MARKUP:
+        grid.add_row(Text(markup), markup)
+
+    print(grid)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/measure.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/measure.py
new file mode 100644
index 0000000..a508ffa
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/measure.py
@@ -0,0 +1,151 @@
+from operator import itemgetter
+from typing import TYPE_CHECKING, Callable, NamedTuple, Optional, Sequence
+
+from . import errors
+from .protocol import is_renderable, rich_cast
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderableType
+
+
+class Measurement(NamedTuple):
+    """Stores the minimum and maximum widths (in characters) required to render an object."""
+
+    minimum: int
+    """Minimum number of cells required to render."""
+    maximum: int
+    """Maximum number of cells required to render."""
+
+    @property
+    def span(self) -> int:
+        """Get difference between maximum and minimum."""
+        return self.maximum - self.minimum
+
+    def normalize(self) -> "Measurement":
+        """Get measurement that ensures that minimum <= maximum and minimum >= 0
+
+        Returns:
+            Measurement: A normalized measurement.
+        """
+        minimum, maximum = self
+        minimum = min(max(0, minimum), maximum)
+        return Measurement(max(0, minimum), max(0, max(minimum, maximum)))
+
+    def with_maximum(self, width: int) -> "Measurement":
+        """Get a RenderableWith where the widths are <= width.
+
+        Args:
+            width (int): Maximum desired width.
+
+        Returns:
+            Measurement: New Measurement object.
+        """
+        minimum, maximum = self
+        return Measurement(min(minimum, width), min(maximum, width))
+
+    def with_minimum(self, width: int) -> "Measurement":
+        """Get a RenderableWith where the widths are >= width.
+
+        Args:
+            width (int): Minimum desired width.
+
+        Returns:
+            Measurement: New Measurement object.
+        """
+        minimum, maximum = self
+        width = max(0, width)
+        return Measurement(max(minimum, width), max(maximum, width))
+
+    def clamp(
+        self, min_width: Optional[int] = None, max_width: Optional[int] = None
+    ) -> "Measurement":
+        """Clamp a measurement within the specified range.
+
+        Args:
+            min_width (int): Minimum desired width, or ``None`` for no minimum. Defaults to None.
+            max_width (int): Maximum desired width, or ``None`` for no maximum. Defaults to None.
+
+        Returns:
+            Measurement: New Measurement object.
+        """
+        measurement = self
+        if min_width is not None:
+            measurement = measurement.with_minimum(min_width)
+        if max_width is not None:
+            measurement = measurement.with_maximum(max_width)
+        return measurement
+
+    @classmethod
+    def get(
+        cls, console: "Console", options: "ConsoleOptions", renderable: "RenderableType"
+    ) -> "Measurement":
+        """Get a measurement for a renderable.
+
+        Args:
+            console (~rich.console.Console): Console instance.
+            options (~rich.console.ConsoleOptions): Console options.
+            renderable (RenderableType): An object that may be rendered with Rich.
+
+        Raises:
+            errors.NotRenderableError: If the object is not renderable.
+
+        Returns:
+            Measurement: Measurement object containing range of character widths required to render the object.
+        """
+        _max_width = options.max_width
+        if _max_width < 1:
+            return Measurement(0, 0)
+        if isinstance(renderable, str):
+            renderable = console.render_str(
+                renderable, markup=options.markup, highlight=False
+            )
+        renderable = rich_cast(renderable)
+        if is_renderable(renderable):
+            get_console_width: Optional[
+                Callable[["Console", "ConsoleOptions"], "Measurement"]
+            ] = getattr(renderable, "__rich_measure__", None)
+            if get_console_width is not None:
+                render_width = (
+                    get_console_width(console, options)
+                    .normalize()
+                    .with_maximum(_max_width)
+                )
+                if render_width.maximum < 1:
+                    return Measurement(0, 0)
+                return render_width.normalize()
+            else:
+                return Measurement(0, _max_width)
+        else:
+            raise errors.NotRenderableError(
+                f"Unable to get render width for {renderable!r}; "
+                "a str, Segment, or object with __rich_console__ method is required"
+            )
+
+
+def measure_renderables(
+    console: "Console",
+    options: "ConsoleOptions",
+    renderables: Sequence["RenderableType"],
+) -> "Measurement":
+    """Get a measurement that would fit a number of renderables.
+
+    Args:
+        console (~rich.console.Console): Console instance.
+        options (~rich.console.ConsoleOptions): Console options.
+        renderables (Iterable[RenderableType]): One or more renderable objects.
+
+    Returns:
+        Measurement: Measurement object containing range of character widths required to
+            contain all given renderables.
+    """
+    if not renderables:
+        return Measurement(0, 0)
+    get_measurement = Measurement.get
+    measurements = [
+        get_measurement(console, options, renderable) for renderable in renderables
+    ]
+    measured_width = Measurement(
+        max(measurements, key=itemgetter(0)).minimum,
+        max(measurements, key=itemgetter(1)).maximum,
+    )
+    return measured_width
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/padding.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/padding.py
new file mode 100644
index 0000000..0161cd1
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/padding.py
@@ -0,0 +1,141 @@
+from typing import TYPE_CHECKING, List, Optional, Tuple, Union
+
+if TYPE_CHECKING:
+    from .console import (
+        Console,
+        ConsoleOptions,
+        RenderableType,
+        RenderResult,
+    )
+
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment
+from .style import Style
+
+PaddingDimensions = Union[int, Tuple[int], Tuple[int, int], Tuple[int, int, int, int]]
+
+
+class Padding(JupyterMixin):
+    """Draw space around content.
+
+    Example:
+        >>> print(Padding("Hello", (2, 4), style="on blue"))
+
+    Args:
+        renderable (RenderableType): String or other renderable.
+        pad (Union[int, Tuple[int]]): Padding for top, right, bottom, and left borders.
+            May be specified with 1, 2, or 4 integers (CSS style).
+        style (Union[str, Style], optional): Style for padding characters. Defaults to "none".
+        expand (bool, optional): Expand padding to fit available width. Defaults to True.
+    """
+
+    def __init__(
+        self,
+        renderable: "RenderableType",
+        pad: "PaddingDimensions" = (0, 0, 0, 0),
+        *,
+        style: Union[str, Style] = "none",
+        expand: bool = True,
+    ):
+        self.renderable = renderable
+        self.top, self.right, self.bottom, self.left = self.unpack(pad)
+        self.style = style
+        self.expand = expand
+
+    @classmethod
+    def indent(cls, renderable: "RenderableType", level: int) -> "Padding":
+        """Make padding instance to render an indent.
+
+        Args:
+            renderable (RenderableType): String or other renderable.
+            level (int): Number of characters to indent.
+
+        Returns:
+            Padding: A Padding instance.
+        """
+
+        return Padding(renderable, pad=(0, 0, 0, level), expand=False)
+
+    @staticmethod
+    def unpack(pad: "PaddingDimensions") -> Tuple[int, int, int, int]:
+        """Unpack padding specified in CSS style."""
+        if isinstance(pad, int):
+            return (pad, pad, pad, pad)
+        if len(pad) == 1:
+            _pad = pad[0]
+            return (_pad, _pad, _pad, _pad)
+        if len(pad) == 2:
+            pad_top, pad_right = pad
+            return (pad_top, pad_right, pad_top, pad_right)
+        if len(pad) == 4:
+            top, right, bottom, left = pad
+            return (top, right, bottom, left)
+        raise ValueError(f"1, 2 or 4 integers required for padding; {len(pad)} given")
+
+    def __repr__(self) -> str:
+        return f"Padding({self.renderable!r}, ({self.top},{self.right},{self.bottom},{self.left}))"
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        style = console.get_style(self.style)
+        if self.expand:
+            width = options.max_width
+        else:
+            width = min(
+                Measurement.get(console, options, self.renderable).maximum
+                + self.left
+                + self.right,
+                options.max_width,
+            )
+        render_options = options.update_width(width - self.left - self.right)
+        if render_options.height is not None:
+            render_options = render_options.update_height(
+                height=render_options.height - self.top - self.bottom
+            )
+        lines = console.render_lines(
+            self.renderable, render_options, style=style, pad=True
+        )
+        _Segment = Segment
+
+        left = _Segment(" " * self.left, style) if self.left else None
+        right = (
+            [_Segment(f'{" " * self.right}', style), _Segment.line()]
+            if self.right
+            else [_Segment.line()]
+        )
+        blank_line: Optional[List[Segment]] = None
+        if self.top:
+            blank_line = [_Segment(f'{" " * width}\n', style)]
+            yield from blank_line * self.top
+        if left:
+            for line in lines:
+                yield left
+                yield from line
+                yield from right
+        else:
+            for line in lines:
+                yield from line
+                yield from right
+        if self.bottom:
+            blank_line = blank_line or [_Segment(f'{" " * width}\n', style)]
+            yield from blank_line * self.bottom
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        max_width = options.max_width
+        extra_width = self.left + self.right
+        if max_width - extra_width < 1:
+            return Measurement(max_width, max_width)
+        measure_min, measure_max = Measurement.get(console, options, self.renderable)
+        measurement = Measurement(measure_min + extra_width, measure_max + extra_width)
+        measurement = measurement.with_maximum(max_width)
+        return measurement
+
+
+if __name__ == "__main__":  #  pragma: no cover
+    from pip._vendor.rich import print
+
+    print(Padding("Hello, World", (2, 4), style="on blue"))
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/pager.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/pager.py
new file mode 100644
index 0000000..a3f7aa6
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/pager.py
@@ -0,0 +1,34 @@
+from abc import ABC, abstractmethod
+from typing import Any
+
+
+class Pager(ABC):
+    """Base class for a pager."""
+
+    @abstractmethod
+    def show(self, content: str) -> None:
+        """Show content in pager.
+
+        Args:
+            content (str): Content to be displayed.
+        """
+
+
+class SystemPager(Pager):
+    """Uses the pager installed on the system."""
+
+    def _pager(self, content: str) -> Any:  #  pragma: no cover
+        return __import__("pydoc").pager(content)
+
+    def show(self, content: str) -> None:
+        """Use the same pager used by pydoc."""
+        self._pager(content)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from .__main__ import make_test_card
+    from .console import Console
+
+    console = Console()
+    with console.pager(styles=True):
+        console.print(make_test_card())
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/palette.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/palette.py
new file mode 100644
index 0000000..fa0c4dd
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/palette.py
@@ -0,0 +1,100 @@
+from math import sqrt
+from functools import lru_cache
+from typing import Sequence, Tuple, TYPE_CHECKING
+
+from .color_triplet import ColorTriplet
+
+if TYPE_CHECKING:
+    from pip._vendor.rich.table import Table
+
+
+class Palette:
+    """A palette of available colors."""
+
+    def __init__(self, colors: Sequence[Tuple[int, int, int]]):
+        self._colors = colors
+
+    def __getitem__(self, number: int) -> ColorTriplet:
+        return ColorTriplet(*self._colors[number])
+
+    def __rich__(self) -> "Table":
+        from pip._vendor.rich.color import Color
+        from pip._vendor.rich.style import Style
+        from pip._vendor.rich.text import Text
+        from pip._vendor.rich.table import Table
+
+        table = Table(
+            "index",
+            "RGB",
+            "Color",
+            title="Palette",
+            caption=f"{len(self._colors)} colors",
+            highlight=True,
+            caption_justify="right",
+        )
+        for index, color in enumerate(self._colors):
+            table.add_row(
+                str(index),
+                repr(color),
+                Text(" " * 16, style=Style(bgcolor=Color.from_rgb(*color))),
+            )
+        return table
+
+    # This is somewhat inefficient and needs caching
+    @lru_cache(maxsize=1024)
+    def match(self, color: Tuple[int, int, int]) -> int:
+        """Find a color from a palette that most closely matches a given color.
+
+        Args:
+            color (Tuple[int, int, int]): RGB components in range 0 > 255.
+
+        Returns:
+            int: Index of closes matching color.
+        """
+        red1, green1, blue1 = color
+        _sqrt = sqrt
+        get_color = self._colors.__getitem__
+
+        def get_color_distance(index: int) -> float:
+            """Get the distance to a color."""
+            red2, green2, blue2 = get_color(index)
+            red_mean = (red1 + red2) // 2
+            red = red1 - red2
+            green = green1 - green2
+            blue = blue1 - blue2
+            return _sqrt(
+                (((512 + red_mean) * red * red) >> 8)
+                + 4 * green * green
+                + (((767 - red_mean) * blue * blue) >> 8)
+            )
+
+        min_index = min(range(len(self._colors)), key=get_color_distance)
+        return min_index
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import colorsys
+    from typing import Iterable
+    from pip._vendor.rich.color import Color
+    from pip._vendor.rich.console import Console, ConsoleOptions
+    from pip._vendor.rich.segment import Segment
+    from pip._vendor.rich.style import Style
+
+    class ColorBox:
+        def __rich_console__(
+            self, console: Console, options: ConsoleOptions
+        ) -> Iterable[Segment]:
+            height = console.size.height - 3
+            for y in range(0, height):
+                for x in range(options.max_width):
+                    h = x / options.max_width
+                    l = y / (height + 1)
+                    r1, g1, b1 = colorsys.hls_to_rgb(h, l, 1.0)
+                    r2, g2, b2 = colorsys.hls_to_rgb(h, l + (1 / height / 2), 1.0)
+                    bgcolor = Color.from_rgb(r1 * 255, g1 * 255, b1 * 255)
+                    color = Color.from_rgb(r2 * 255, g2 * 255, b2 * 255)
+                    yield Segment("▄", Style(color=color, bgcolor=bgcolor))
+                yield Segment.line()
+
+    console = Console()
+    console.print(ColorBox())
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/panel.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/panel.py
new file mode 100644
index 0000000..8cfa6f4
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/panel.py
@@ -0,0 +1,318 @@
+from typing import TYPE_CHECKING, Optional
+
+from .align import AlignMethod
+from .box import ROUNDED, Box
+from .cells import cell_len
+from .jupyter import JupyterMixin
+from .measure import Measurement, measure_renderables
+from .padding import Padding, PaddingDimensions
+from .segment import Segment
+from .style import Style, StyleType
+from .text import Text, TextType
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderableType, RenderResult
+
+
+class Panel(JupyterMixin):
+    """A console renderable that draws a border around its contents.
+
+    Example:
+        >>> console.print(Panel("Hello, World!"))
+
+    Args:
+        renderable (RenderableType): A console renderable object.
+        box (Box, optional): A Box instance that defines the look of the border (see :ref:`appendix_box`. Defaults to box.ROUNDED.
+        title (Optional[TextType], optional): Optional title displayed in panel header. Defaults to None.
+        title_align (AlignMethod, optional): Alignment of title. Defaults to "center".
+        subtitle (Optional[TextType], optional): Optional subtitle displayed in panel footer. Defaults to None.
+        subtitle_align (AlignMethod, optional): Alignment of subtitle. Defaults to "center".
+        safe_box (bool, optional): Disable box characters that don't display on windows legacy terminal with *raster* fonts. Defaults to True.
+        expand (bool, optional): If True the panel will stretch to fill the console width, otherwise it will be sized to fit the contents. Defaults to True.
+        style (str, optional): The style of the panel (border and contents). Defaults to "none".
+        border_style (str, optional): The style of the border. Defaults to "none".
+        width (Optional[int], optional): Optional width of panel. Defaults to None to auto-detect.
+        height (Optional[int], optional): Optional height of panel. Defaults to None to auto-detect.
+        padding (Optional[PaddingDimensions]): Optional padding around renderable. Defaults to 0.
+        highlight (bool, optional): Enable automatic highlighting of panel title (if str). Defaults to False.
+    """
+
+    def __init__(
+        self,
+        renderable: "RenderableType",
+        box: Box = ROUNDED,
+        *,
+        title: Optional[TextType] = None,
+        title_align: AlignMethod = "center",
+        subtitle: Optional[TextType] = None,
+        subtitle_align: AlignMethod = "center",
+        safe_box: Optional[bool] = None,
+        expand: bool = True,
+        style: StyleType = "none",
+        border_style: StyleType = "none",
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+        padding: PaddingDimensions = (0, 1),
+        highlight: bool = False,
+    ) -> None:
+        self.renderable = renderable
+        self.box = box
+        self.title = title
+        self.title_align: AlignMethod = title_align
+        self.subtitle = subtitle
+        self.subtitle_align = subtitle_align
+        self.safe_box = safe_box
+        self.expand = expand
+        self.style = style
+        self.border_style = border_style
+        self.width = width
+        self.height = height
+        self.padding = padding
+        self.highlight = highlight
+
+    @classmethod
+    def fit(
+        cls,
+        renderable: "RenderableType",
+        box: Box = ROUNDED,
+        *,
+        title: Optional[TextType] = None,
+        title_align: AlignMethod = "center",
+        subtitle: Optional[TextType] = None,
+        subtitle_align: AlignMethod = "center",
+        safe_box: Optional[bool] = None,
+        style: StyleType = "none",
+        border_style: StyleType = "none",
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+        padding: PaddingDimensions = (0, 1),
+        highlight: bool = False,
+    ) -> "Panel":
+        """An alternative constructor that sets expand=False."""
+        return cls(
+            renderable,
+            box,
+            title=title,
+            title_align=title_align,
+            subtitle=subtitle,
+            subtitle_align=subtitle_align,
+            safe_box=safe_box,
+            style=style,
+            border_style=border_style,
+            width=width,
+            height=height,
+            padding=padding,
+            highlight=highlight,
+            expand=False,
+        )
+
+    @property
+    def _title(self) -> Optional[Text]:
+        if self.title:
+            title_text = (
+                Text.from_markup(self.title)
+                if isinstance(self.title, str)
+                else self.title.copy()
+            )
+            title_text.end = ""
+            title_text.plain = title_text.plain.replace("\n", " ")
+            title_text.no_wrap = True
+            title_text.expand_tabs()
+            title_text.pad(1)
+            return title_text
+        return None
+
+    @property
+    def _subtitle(self) -> Optional[Text]:
+        if self.subtitle:
+            subtitle_text = (
+                Text.from_markup(self.subtitle)
+                if isinstance(self.subtitle, str)
+                else self.subtitle.copy()
+            )
+            subtitle_text.end = ""
+            subtitle_text.plain = subtitle_text.plain.replace("\n", " ")
+            subtitle_text.no_wrap = True
+            subtitle_text.expand_tabs()
+            subtitle_text.pad(1)
+            return subtitle_text
+        return None
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        _padding = Padding.unpack(self.padding)
+        renderable = (
+            Padding(self.renderable, _padding) if any(_padding) else self.renderable
+        )
+        style = console.get_style(self.style)
+        partial_border_style = console.get_style(self.border_style)
+        border_style = style + partial_border_style
+        width = (
+            options.max_width
+            if self.width is None
+            else min(options.max_width, self.width)
+        )
+
+        safe_box: bool = console.safe_box if self.safe_box is None else self.safe_box
+        box = self.box.substitute(options, safe=safe_box)
+
+        def align_text(
+            text: Text, width: int, align: str, character: str, style: Style
+        ) -> Text:
+            """Gets new aligned text.
+
+            Args:
+                text (Text): Title or subtitle text.
+                width (int): Desired width.
+                align (str): Alignment.
+                character (str): Character for alignment.
+                style (Style): Border style
+
+            Returns:
+                Text: New text instance
+            """
+            text = text.copy()
+            text.truncate(width)
+            excess_space = width - cell_len(text.plain)
+            if text.style:
+                text.stylize(console.get_style(text.style))
+
+            if excess_space:
+                if align == "left":
+                    return Text.assemble(
+                        text,
+                        (character * excess_space, style),
+                        no_wrap=True,
+                        end="",
+                    )
+                elif align == "center":
+                    left = excess_space // 2
+                    return Text.assemble(
+                        (character * left, style),
+                        text,
+                        (character * (excess_space - left), style),
+                        no_wrap=True,
+                        end="",
+                    )
+                else:
+                    return Text.assemble(
+                        (character * excess_space, style),
+                        text,
+                        no_wrap=True,
+                        end="",
+                    )
+            return text
+
+        title_text = self._title
+        if title_text is not None:
+            title_text.stylize_before(partial_border_style)
+
+        child_width = (
+            width - 2
+            if self.expand
+            else console.measure(
+                renderable, options=options.update_width(width - 2)
+            ).maximum
+        )
+        child_height = self.height or options.height or None
+        if child_height:
+            child_height -= 2
+        if title_text is not None:
+            child_width = min(
+                options.max_width - 2, max(child_width, title_text.cell_len + 2)
+            )
+
+        width = child_width + 2
+        child_options = options.update(
+            width=child_width, height=child_height, highlight=self.highlight
+        )
+        lines = console.render_lines(renderable, child_options, style=style)
+
+        line_start = Segment(box.mid_left, border_style)
+        line_end = Segment(f"{box.mid_right}", border_style)
+        new_line = Segment.line()
+        if title_text is None or width <= 4:
+            yield Segment(box.get_top([width - 2]), border_style)
+        else:
+            title_text = align_text(
+                title_text,
+                width - 4,
+                self.title_align,
+                box.top,
+                border_style,
+            )
+            yield Segment(box.top_left + box.top, border_style)
+            yield from console.render(title_text, child_options.update_width(width - 4))
+            yield Segment(box.top + box.top_right, border_style)
+
+        yield new_line
+        for line in lines:
+            yield line_start
+            yield from line
+            yield line_end
+            yield new_line
+
+        subtitle_text = self._subtitle
+        if subtitle_text is not None:
+            subtitle_text.stylize_before(partial_border_style)
+
+        if subtitle_text is None or width <= 4:
+            yield Segment(box.get_bottom([width - 2]), border_style)
+        else:
+            subtitle_text = align_text(
+                subtitle_text,
+                width - 4,
+                self.subtitle_align,
+                box.bottom,
+                border_style,
+            )
+            yield Segment(box.bottom_left + box.bottom, border_style)
+            yield from console.render(
+                subtitle_text, child_options.update_width(width - 4)
+            )
+            yield Segment(box.bottom + box.bottom_right, border_style)
+
+        yield new_line
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        _title = self._title
+        _, right, _, left = Padding.unpack(self.padding)
+        padding = left + right
+        renderables = [self.renderable, _title] if _title else [self.renderable]
+
+        if self.width is None:
+            width = (
+                measure_renderables(
+                    console,
+                    options.update_width(options.max_width - padding - 2),
+                    renderables,
+                ).maximum
+                + padding
+                + 2
+            )
+        else:
+            width = self.width
+        return Measurement(width, width)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from .console import Console
+
+    c = Console()
+
+    from .box import DOUBLE, ROUNDED
+    from .padding import Padding
+
+    p = Panel(
+        "Hello, World!",
+        title="rich.Panel",
+        style="white on blue",
+        box=DOUBLE,
+        padding=1,
+    )
+
+    c.print()
+    c.print(p)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/pretty.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/pretty.py
new file mode 100644
index 0000000..c4a274f
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/pretty.py
@@ -0,0 +1,1016 @@
+import builtins
+import collections
+import dataclasses
+import inspect
+import os
+import reprlib
+import sys
+from array import array
+from collections import Counter, UserDict, UserList, defaultdict, deque
+from dataclasses import dataclass, fields, is_dataclass
+from inspect import isclass
+from itertools import islice
+from types import MappingProxyType
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    DefaultDict,
+    Deque,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Union,
+)
+
+from pip._vendor.rich.repr import RichReprResult
+
+try:
+    import attr as _attr_module
+
+    _has_attrs = hasattr(_attr_module, "ib")
+except ImportError:  # pragma: no cover
+    _has_attrs = False
+
+from . import get_console
+from ._loop import loop_last
+from ._pick import pick_bool
+from .abc import RichRenderable
+from .cells import cell_len
+from .highlighter import ReprHighlighter
+from .jupyter import JupyterMixin, JupyterRenderable
+from .measure import Measurement
+from .text import Text
+
+if TYPE_CHECKING:
+    from .console import (
+        Console,
+        ConsoleOptions,
+        HighlighterType,
+        JustifyMethod,
+        OverflowMethod,
+        RenderResult,
+    )
+
+
+def _is_attr_object(obj: Any) -> bool:
+    """Check if an object was created with attrs module."""
+    return _has_attrs and _attr_module.has(type(obj))
+
+
+def _get_attr_fields(obj: Any) -> Sequence["_attr_module.Attribute[Any]"]:
+    """Get fields for an attrs object."""
+    return _attr_module.fields(type(obj)) if _has_attrs else []
+
+
+def _is_dataclass_repr(obj: object) -> bool:
+    """Check if an instance of a dataclass contains the default repr.
+
+    Args:
+        obj (object): A dataclass instance.
+
+    Returns:
+        bool: True if the default repr is used, False if there is a custom repr.
+    """
+    # Digging in to a lot of internals here
+    # Catching all exceptions in case something is missing on a non CPython implementation
+    try:
+        return obj.__repr__.__code__.co_filename in (
+            dataclasses.__file__,
+            reprlib.__file__,
+        )
+    except Exception:  # pragma: no coverage
+        return False
+
+
+_dummy_namedtuple = collections.namedtuple("_dummy_namedtuple", [])
+
+
+def _has_default_namedtuple_repr(obj: object) -> bool:
+    """Check if an instance of namedtuple contains the default repr
+
+    Args:
+        obj (object): A namedtuple
+
+    Returns:
+        bool: True if the default repr is used, False if there's a custom repr.
+    """
+    obj_file = None
+    try:
+        obj_file = inspect.getfile(obj.__repr__)
+    except (OSError, TypeError):
+        # OSError handles case where object is defined in __main__ scope, e.g. REPL - no filename available.
+        # TypeError trapped defensively, in case of object without filename slips through.
+        pass
+    default_repr_file = inspect.getfile(_dummy_namedtuple.__repr__)
+    return obj_file == default_repr_file
+
+
+def _ipy_display_hook(
+    value: Any,
+    console: Optional["Console"] = None,
+    overflow: "OverflowMethod" = "ignore",
+    crop: bool = False,
+    indent_guides: bool = False,
+    max_length: Optional[int] = None,
+    max_string: Optional[int] = None,
+    max_depth: Optional[int] = None,
+    expand_all: bool = False,
+) -> Union[str, None]:
+    # needed here to prevent circular import:
+    from .console import ConsoleRenderable
+
+    # always skip rich generated jupyter renderables or None values
+    if _safe_isinstance(value, JupyterRenderable) or value is None:
+        return None
+
+    console = console or get_console()
+
+    with console.capture() as capture:
+        # certain renderables should start on a new line
+        if _safe_isinstance(value, ConsoleRenderable):
+            console.line()
+        console.print(
+            (
+                value
+                if _safe_isinstance(value, RichRenderable)
+                else Pretty(
+                    value,
+                    overflow=overflow,
+                    indent_guides=indent_guides,
+                    max_length=max_length,
+                    max_string=max_string,
+                    max_depth=max_depth,
+                    expand_all=expand_all,
+                    margin=12,
+                )
+            ),
+            crop=crop,
+            new_line_start=True,
+            end="",
+        )
+    # strip trailing newline, not usually part of a text repr
+    # I'm not sure if this should be prevented at a lower level
+    return capture.get().rstrip("\n")
+
+
+def _safe_isinstance(
+    obj: object, class_or_tuple: Union[type, Tuple[type, ...]]
+) -> bool:
+    """isinstance can fail in rare cases, for example types with no __class__"""
+    try:
+        return isinstance(obj, class_or_tuple)
+    except Exception:
+        return False
+
+
+def install(
+    console: Optional["Console"] = None,
+    overflow: "OverflowMethod" = "ignore",
+    crop: bool = False,
+    indent_guides: bool = False,
+    max_length: Optional[int] = None,
+    max_string: Optional[int] = None,
+    max_depth: Optional[int] = None,
+    expand_all: bool = False,
+) -> None:
+    """Install automatic pretty printing in the Python REPL.
+
+    Args:
+        console (Console, optional): Console instance or ``None`` to use global console. Defaults to None.
+        overflow (Optional[OverflowMethod], optional): Overflow method. Defaults to "ignore".
+        crop (Optional[bool], optional): Enable cropping of long lines. Defaults to False.
+        indent_guides (bool, optional): Enable indentation guides. Defaults to False.
+        max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to None.
+        max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to None.
+        max_depth (int, optional): Maximum depth of nested data structures, or None for no maximum. Defaults to None.
+        expand_all (bool, optional): Expand all containers. Defaults to False.
+        max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
+    """
+    from pip._vendor.rich import get_console
+
+    console = console or get_console()
+    assert console is not None
+
+    def display_hook(value: Any) -> None:
+        """Replacement sys.displayhook which prettifies objects with Rich."""
+        if value is not None:
+            assert console is not None
+            builtins._ = None  # type: ignore[attr-defined]
+            console.print(
+                (
+                    value
+                    if _safe_isinstance(value, RichRenderable)
+                    else Pretty(
+                        value,
+                        overflow=overflow,
+                        indent_guides=indent_guides,
+                        max_length=max_length,
+                        max_string=max_string,
+                        max_depth=max_depth,
+                        expand_all=expand_all,
+                    )
+                ),
+                crop=crop,
+            )
+            builtins._ = value  # type: ignore[attr-defined]
+
+    try:
+        ip = get_ipython()  # type: ignore[name-defined]
+    except NameError:
+        sys.displayhook = display_hook
+    else:
+        from IPython.core.formatters import BaseFormatter
+
+        class RichFormatter(BaseFormatter):  # type: ignore[misc]
+            pprint: bool = True
+
+            def __call__(self, value: Any) -> Any:
+                if self.pprint:
+                    return _ipy_display_hook(
+                        value,
+                        console=get_console(),
+                        overflow=overflow,
+                        indent_guides=indent_guides,
+                        max_length=max_length,
+                        max_string=max_string,
+                        max_depth=max_depth,
+                        expand_all=expand_all,
+                    )
+                else:
+                    return repr(value)
+
+        # replace plain text formatter with rich formatter
+        rich_formatter = RichFormatter()
+        ip.display_formatter.formatters["text/plain"] = rich_formatter
+
+
+class Pretty(JupyterMixin):
+    """A rich renderable that pretty prints an object.
+
+    Args:
+        _object (Any): An object to pretty print.
+        highlighter (HighlighterType, optional): Highlighter object to apply to result, or None for ReprHighlighter. Defaults to None.
+        indent_size (int, optional): Number of spaces in indent. Defaults to 4.
+        justify (JustifyMethod, optional): Justify method, or None for default. Defaults to None.
+        overflow (OverflowMethod, optional): Overflow method, or None for default. Defaults to None.
+        no_wrap (Optional[bool], optional): Disable word wrapping. Defaults to False.
+        indent_guides (bool, optional): Enable indentation guides. Defaults to False.
+        max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to None.
+        max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to None.
+        max_depth (int, optional): Maximum depth of nested data structures, or None for no maximum. Defaults to None.
+        expand_all (bool, optional): Expand all containers. Defaults to False.
+        margin (int, optional): Subtrace a margin from width to force containers to expand earlier. Defaults to 0.
+        insert_line (bool, optional): Insert a new line if the output has multiple new lines. Defaults to False.
+    """
+
+    def __init__(
+        self,
+        _object: Any,
+        highlighter: Optional["HighlighterType"] = None,
+        *,
+        indent_size: int = 4,
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+        no_wrap: Optional[bool] = False,
+        indent_guides: bool = False,
+        max_length: Optional[int] = None,
+        max_string: Optional[int] = None,
+        max_depth: Optional[int] = None,
+        expand_all: bool = False,
+        margin: int = 0,
+        insert_line: bool = False,
+    ) -> None:
+        self._object = _object
+        self.highlighter = highlighter or ReprHighlighter()
+        self.indent_size = indent_size
+        self.justify: Optional["JustifyMethod"] = justify
+        self.overflow: Optional["OverflowMethod"] = overflow
+        self.no_wrap = no_wrap
+        self.indent_guides = indent_guides
+        self.max_length = max_length
+        self.max_string = max_string
+        self.max_depth = max_depth
+        self.expand_all = expand_all
+        self.margin = margin
+        self.insert_line = insert_line
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        pretty_str = pretty_repr(
+            self._object,
+            max_width=options.max_width - self.margin,
+            indent_size=self.indent_size,
+            max_length=self.max_length,
+            max_string=self.max_string,
+            max_depth=self.max_depth,
+            expand_all=self.expand_all,
+        )
+        pretty_text = Text.from_ansi(
+            pretty_str,
+            justify=self.justify or options.justify,
+            overflow=self.overflow or options.overflow,
+            no_wrap=pick_bool(self.no_wrap, options.no_wrap),
+            style="pretty",
+        )
+        pretty_text = (
+            self.highlighter(pretty_text)
+            if pretty_text
+            else Text(
+                f"{type(self._object)}.__repr__ returned empty string",
+                style="dim italic",
+            )
+        )
+        if self.indent_guides and not options.ascii_only:
+            pretty_text = pretty_text.with_indent_guides(
+                self.indent_size, style="repr.indent"
+            )
+        if self.insert_line and "\n" in pretty_text:
+            yield ""
+        yield pretty_text
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        pretty_str = pretty_repr(
+            self._object,
+            max_width=options.max_width,
+            indent_size=self.indent_size,
+            max_length=self.max_length,
+            max_string=self.max_string,
+            max_depth=self.max_depth,
+            expand_all=self.expand_all,
+        )
+        text_width = (
+            max(cell_len(line) for line in pretty_str.splitlines()) if pretty_str else 0
+        )
+        return Measurement(text_width, text_width)
+
+
+def _get_braces_for_defaultdict(_object: DefaultDict[Any, Any]) -> Tuple[str, str, str]:
+    return (
+        f"defaultdict({_object.default_factory!r}, {{",
+        "})",
+        f"defaultdict({_object.default_factory!r}, {{}})",
+    )
+
+
+def _get_braces_for_deque(_object: Deque[Any]) -> Tuple[str, str, str]:
+    if _object.maxlen is None:
+        return ("deque([", "])", "deque()")
+    return (
+        "deque([",
+        f"], maxlen={_object.maxlen})",
+        f"deque(maxlen={_object.maxlen})",
+    )
+
+
+def _get_braces_for_array(_object: "array[Any]") -> Tuple[str, str, str]:
+    return (f"array({_object.typecode!r}, [", "])", f"array({_object.typecode!r})")
+
+
+_BRACES: Dict[type, Callable[[Any], Tuple[str, str, str]]] = {
+    os._Environ: lambda _object: ("environ({", "})", "environ({})"),
+    array: _get_braces_for_array,
+    defaultdict: _get_braces_for_defaultdict,
+    Counter: lambda _object: ("Counter({", "})", "Counter()"),
+    deque: _get_braces_for_deque,
+    dict: lambda _object: ("{", "}", "{}"),
+    UserDict: lambda _object: ("{", "}", "{}"),
+    frozenset: lambda _object: ("frozenset({", "})", "frozenset()"),
+    list: lambda _object: ("[", "]", "[]"),
+    UserList: lambda _object: ("[", "]", "[]"),
+    set: lambda _object: ("{", "}", "set()"),
+    tuple: lambda _object: ("(", ")", "()"),
+    MappingProxyType: lambda _object: ("mappingproxy({", "})", "mappingproxy({})"),
+}
+_CONTAINERS = tuple(_BRACES.keys())
+_MAPPING_CONTAINERS = (dict, os._Environ, MappingProxyType, UserDict)
+
+
+def is_expandable(obj: Any) -> bool:
+    """Check if an object may be expanded by pretty print."""
+    return (
+        _safe_isinstance(obj, _CONTAINERS)
+        or (is_dataclass(obj))
+        or (hasattr(obj, "__rich_repr__"))
+        or _is_attr_object(obj)
+    ) and not isclass(obj)
+
+
+@dataclass
+class Node:
+    """A node in a repr tree. May be atomic or a container."""
+
+    key_repr: str = ""
+    value_repr: str = ""
+    open_brace: str = ""
+    close_brace: str = ""
+    empty: str = ""
+    last: bool = False
+    is_tuple: bool = False
+    is_namedtuple: bool = False
+    children: Optional[List["Node"]] = None
+    key_separator: str = ": "
+    separator: str = ", "
+
+    def iter_tokens(self) -> Iterable[str]:
+        """Generate tokens for this node."""
+        if self.key_repr:
+            yield self.key_repr
+            yield self.key_separator
+        if self.value_repr:
+            yield self.value_repr
+        elif self.children is not None:
+            if self.children:
+                yield self.open_brace
+                if self.is_tuple and not self.is_namedtuple and len(self.children) == 1:
+                    yield from self.children[0].iter_tokens()
+                    yield ","
+                else:
+                    for child in self.children:
+                        yield from child.iter_tokens()
+                        if not child.last:
+                            yield self.separator
+                yield self.close_brace
+            else:
+                yield self.empty
+
+    def check_length(self, start_length: int, max_length: int) -> bool:
+        """Check the length fits within a limit.
+
+        Args:
+            start_length (int): Starting length of the line (indent, prefix, suffix).
+            max_length (int): Maximum length.
+
+        Returns:
+            bool: True if the node can be rendered within max length, otherwise False.
+        """
+        total_length = start_length
+        for token in self.iter_tokens():
+            total_length += cell_len(token)
+            if total_length > max_length:
+                return False
+        return True
+
+    def __str__(self) -> str:
+        repr_text = "".join(self.iter_tokens())
+        return repr_text
+
+    def render(
+        self, max_width: int = 80, indent_size: int = 4, expand_all: bool = False
+    ) -> str:
+        """Render the node to a pretty repr.
+
+        Args:
+            max_width (int, optional): Maximum width of the repr. Defaults to 80.
+            indent_size (int, optional): Size of indents. Defaults to 4.
+            expand_all (bool, optional): Expand all levels. Defaults to False.
+
+        Returns:
+            str: A repr string of the original object.
+        """
+        lines = [_Line(node=self, is_root=True)]
+        line_no = 0
+        while line_no < len(lines):
+            line = lines[line_no]
+            if line.expandable and not line.expanded:
+                if expand_all or not line.check_length(max_width):
+                    lines[line_no : line_no + 1] = line.expand(indent_size)
+            line_no += 1
+
+        repr_str = "\n".join(str(line) for line in lines)
+        return repr_str
+
+
+@dataclass
+class _Line:
+    """A line in repr output."""
+
+    parent: Optional["_Line"] = None
+    is_root: bool = False
+    node: Optional[Node] = None
+    text: str = ""
+    suffix: str = ""
+    whitespace: str = ""
+    expanded: bool = False
+    last: bool = False
+
+    @property
+    def expandable(self) -> bool:
+        """Check if the line may be expanded."""
+        return bool(self.node is not None and self.node.children)
+
+    def check_length(self, max_length: int) -> bool:
+        """Check this line fits within a given number of cells."""
+        start_length = (
+            len(self.whitespace) + cell_len(self.text) + cell_len(self.suffix)
+        )
+        assert self.node is not None
+        return self.node.check_length(start_length, max_length)
+
+    def expand(self, indent_size: int) -> Iterable["_Line"]:
+        """Expand this line by adding children on their own line."""
+        node = self.node
+        assert node is not None
+        whitespace = self.whitespace
+        assert node.children
+        if node.key_repr:
+            new_line = yield _Line(
+                text=f"{node.key_repr}{node.key_separator}{node.open_brace}",
+                whitespace=whitespace,
+            )
+        else:
+            new_line = yield _Line(text=node.open_brace, whitespace=whitespace)
+        child_whitespace = self.whitespace + " " * indent_size
+        tuple_of_one = node.is_tuple and len(node.children) == 1
+        for last, child in loop_last(node.children):
+            separator = "," if tuple_of_one else node.separator
+            line = _Line(
+                parent=new_line,
+                node=child,
+                whitespace=child_whitespace,
+                suffix=separator,
+                last=last and not tuple_of_one,
+            )
+            yield line
+
+        yield _Line(
+            text=node.close_brace,
+            whitespace=whitespace,
+            suffix=self.suffix,
+            last=self.last,
+        )
+
+    def __str__(self) -> str:
+        if self.last:
+            return f"{self.whitespace}{self.text}{self.node or ''}"
+        else:
+            return (
+                f"{self.whitespace}{self.text}{self.node or ''}{self.suffix.rstrip()}"
+            )
+
+
+def _is_namedtuple(obj: Any) -> bool:
+    """Checks if an object is most likely a namedtuple. It is possible
+    to craft an object that passes this check and isn't a namedtuple, but
+    there is only a minuscule chance of this happening unintentionally.
+
+    Args:
+        obj (Any): The object to test
+
+    Returns:
+        bool: True if the object is a namedtuple. False otherwise.
+    """
+    try:
+        fields = getattr(obj, "_fields", None)
+    except Exception:
+        # Being very defensive - if we cannot get the attr then its not a namedtuple
+        return False
+    return isinstance(obj, tuple) and isinstance(fields, tuple)
+
+
+def traverse(
+    _object: Any,
+    max_length: Optional[int] = None,
+    max_string: Optional[int] = None,
+    max_depth: Optional[int] = None,
+) -> Node:
+    """Traverse object and generate a tree.
+
+    Args:
+        _object (Any): Object to be traversed.
+        max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to None.
+        max_string (int, optional): Maximum length of string before truncating, or None to disable truncating.
+            Defaults to None.
+        max_depth (int, optional): Maximum depth of data structures, or None for no maximum.
+            Defaults to None.
+
+    Returns:
+        Node: The root of a tree structure which can be used to render a pretty repr.
+    """
+
+    def to_repr(obj: Any) -> str:
+        """Get repr string for an object, but catch errors."""
+        if (
+            max_string is not None
+            and _safe_isinstance(obj, (bytes, str))
+            and len(obj) > max_string
+        ):
+            truncated = len(obj) - max_string
+            obj_repr = f"{obj[:max_string]!r}+{truncated}"
+        else:
+            try:
+                obj_repr = repr(obj)
+            except Exception as error:
+                obj_repr = f""
+        return obj_repr
+
+    visited_ids: Set[int] = set()
+    push_visited = visited_ids.add
+    pop_visited = visited_ids.remove
+
+    def _traverse(obj: Any, root: bool = False, depth: int = 0) -> Node:
+        """Walk the object depth first."""
+
+        obj_id = id(obj)
+        if obj_id in visited_ids:
+            # Recursion detected
+            return Node(value_repr="...")
+
+        obj_type = type(obj)
+        children: List[Node]
+        reached_max_depth = max_depth is not None and depth >= max_depth
+
+        def iter_rich_args(rich_args: Any) -> Iterable[Union[Any, Tuple[str, Any]]]:
+            for arg in rich_args:
+                if _safe_isinstance(arg, tuple):
+                    if len(arg) == 3:
+                        key, child, default = arg
+                        if default == child:
+                            continue
+                        yield key, child
+                    elif len(arg) == 2:
+                        key, child = arg
+                        yield key, child
+                    elif len(arg) == 1:
+                        yield arg[0]
+                else:
+                    yield arg
+
+        try:
+            fake_attributes = hasattr(
+                obj, "awehoi234_wdfjwljet234_234wdfoijsdfmmnxpi492"
+            )
+        except Exception:
+            fake_attributes = False
+
+        rich_repr_result: Optional[RichReprResult] = None
+        if not fake_attributes:
+            try:
+                if hasattr(obj, "__rich_repr__") and not isclass(obj):
+                    rich_repr_result = obj.__rich_repr__()
+            except Exception:
+                pass
+
+        if rich_repr_result is not None:
+            push_visited(obj_id)
+            angular = getattr(obj.__rich_repr__, "angular", False)
+            args = list(iter_rich_args(rich_repr_result))
+            class_name = obj.__class__.__name__
+
+            if args:
+                children = []
+                append = children.append
+
+                if reached_max_depth:
+                    if angular:
+                        node = Node(value_repr=f"<{class_name}...>")
+                    else:
+                        node = Node(value_repr=f"{class_name}(...)")
+                else:
+                    if angular:
+                        node = Node(
+                            open_brace=f"<{class_name} ",
+                            close_brace=">",
+                            children=children,
+                            last=root,
+                            separator=" ",
+                        )
+                    else:
+                        node = Node(
+                            open_brace=f"{class_name}(",
+                            close_brace=")",
+                            children=children,
+                            last=root,
+                        )
+                    for last, arg in loop_last(args):
+                        if _safe_isinstance(arg, tuple):
+                            key, child = arg
+                            child_node = _traverse(child, depth=depth + 1)
+                            child_node.last = last
+                            child_node.key_repr = key
+                            child_node.key_separator = "="
+                            append(child_node)
+                        else:
+                            child_node = _traverse(arg, depth=depth + 1)
+                            child_node.last = last
+                            append(child_node)
+            else:
+                node = Node(
+                    value_repr=f"<{class_name}>" if angular else f"{class_name}()",
+                    children=[],
+                    last=root,
+                )
+            pop_visited(obj_id)
+        elif _is_attr_object(obj) and not fake_attributes:
+            push_visited(obj_id)
+            children = []
+            append = children.append
+
+            attr_fields = _get_attr_fields(obj)
+            if attr_fields:
+                if reached_max_depth:
+                    node = Node(value_repr=f"{obj.__class__.__name__}(...)")
+                else:
+                    node = Node(
+                        open_brace=f"{obj.__class__.__name__}(",
+                        close_brace=")",
+                        children=children,
+                        last=root,
+                    )
+
+                    def iter_attrs() -> (
+                        Iterable[Tuple[str, Any, Optional[Callable[[Any], str]]]]
+                    ):
+                        """Iterate over attr fields and values."""
+                        for attr in attr_fields:
+                            if attr.repr:
+                                try:
+                                    value = getattr(obj, attr.name)
+                                except Exception as error:
+                                    # Can happen, albeit rarely
+                                    yield (attr.name, error, None)
+                                else:
+                                    yield (
+                                        attr.name,
+                                        value,
+                                        attr.repr if callable(attr.repr) else None,
+                                    )
+
+                    for last, (name, value, repr_callable) in loop_last(iter_attrs()):
+                        if repr_callable:
+                            child_node = Node(value_repr=str(repr_callable(value)))
+                        else:
+                            child_node = _traverse(value, depth=depth + 1)
+                        child_node.last = last
+                        child_node.key_repr = name
+                        child_node.key_separator = "="
+                        append(child_node)
+            else:
+                node = Node(
+                    value_repr=f"{obj.__class__.__name__}()", children=[], last=root
+                )
+            pop_visited(obj_id)
+        elif (
+            is_dataclass(obj)
+            and not _safe_isinstance(obj, type)
+            and not fake_attributes
+            and _is_dataclass_repr(obj)
+        ):
+            push_visited(obj_id)
+            children = []
+            append = children.append
+            if reached_max_depth:
+                node = Node(value_repr=f"{obj.__class__.__name__}(...)")
+            else:
+                node = Node(
+                    open_brace=f"{obj.__class__.__name__}(",
+                    close_brace=")",
+                    children=children,
+                    last=root,
+                    empty=f"{obj.__class__.__name__}()",
+                )
+
+                for last, field in loop_last(
+                    field
+                    for field in fields(obj)
+                    if field.repr and hasattr(obj, field.name)
+                ):
+                    child_node = _traverse(getattr(obj, field.name), depth=depth + 1)
+                    child_node.key_repr = field.name
+                    child_node.last = last
+                    child_node.key_separator = "="
+                    append(child_node)
+
+            pop_visited(obj_id)
+        elif _is_namedtuple(obj) and _has_default_namedtuple_repr(obj):
+            push_visited(obj_id)
+            class_name = obj.__class__.__name__
+            if reached_max_depth:
+                # If we've reached the max depth, we still show the class name, but not its contents
+                node = Node(
+                    value_repr=f"{class_name}(...)",
+                )
+            else:
+                children = []
+                append = children.append
+                node = Node(
+                    open_brace=f"{class_name}(",
+                    close_brace=")",
+                    children=children,
+                    empty=f"{class_name}()",
+                )
+                for last, (key, value) in loop_last(obj._asdict().items()):
+                    child_node = _traverse(value, depth=depth + 1)
+                    child_node.key_repr = key
+                    child_node.last = last
+                    child_node.key_separator = "="
+                    append(child_node)
+            pop_visited(obj_id)
+        elif _safe_isinstance(obj, _CONTAINERS):
+            for container_type in _CONTAINERS:
+                if _safe_isinstance(obj, container_type):
+                    obj_type = container_type
+                    break
+
+            push_visited(obj_id)
+
+            open_brace, close_brace, empty = _BRACES[obj_type](obj)
+
+            if reached_max_depth:
+                node = Node(value_repr=f"{open_brace}...{close_brace}")
+            elif obj_type.__repr__ != type(obj).__repr__:
+                node = Node(value_repr=to_repr(obj), last=root)
+            elif obj:
+                children = []
+                node = Node(
+                    open_brace=open_brace,
+                    close_brace=close_brace,
+                    children=children,
+                    last=root,
+                )
+                append = children.append
+                num_items = len(obj)
+                last_item_index = num_items - 1
+
+                if _safe_isinstance(obj, _MAPPING_CONTAINERS):
+                    iter_items = iter(obj.items())
+                    if max_length is not None:
+                        iter_items = islice(iter_items, max_length)
+                    for index, (key, child) in enumerate(iter_items):
+                        child_node = _traverse(child, depth=depth + 1)
+                        child_node.key_repr = to_repr(key)
+                        child_node.last = index == last_item_index
+                        append(child_node)
+                else:
+                    iter_values = iter(obj)
+                    if max_length is not None:
+                        iter_values = islice(iter_values, max_length)
+                    for index, child in enumerate(iter_values):
+                        child_node = _traverse(child, depth=depth + 1)
+                        child_node.last = index == last_item_index
+                        append(child_node)
+                if max_length is not None and num_items > max_length:
+                    append(Node(value_repr=f"... +{num_items - max_length}", last=True))
+            else:
+                node = Node(empty=empty, children=[], last=root)
+
+            pop_visited(obj_id)
+        else:
+            node = Node(value_repr=to_repr(obj), last=root)
+        node.is_tuple = type(obj) == tuple
+        node.is_namedtuple = _is_namedtuple(obj)
+        return node
+
+    node = _traverse(_object, root=True)
+    return node
+
+
+def pretty_repr(
+    _object: Any,
+    *,
+    max_width: int = 80,
+    indent_size: int = 4,
+    max_length: Optional[int] = None,
+    max_string: Optional[int] = None,
+    max_depth: Optional[int] = None,
+    expand_all: bool = False,
+) -> str:
+    """Prettify repr string by expanding on to new lines to fit within a given width.
+
+    Args:
+        _object (Any): Object to repr.
+        max_width (int, optional): Desired maximum width of repr string. Defaults to 80.
+        indent_size (int, optional): Number of spaces to indent. Defaults to 4.
+        max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to None.
+        max_string (int, optional): Maximum length of string before truncating, or None to disable truncating.
+            Defaults to None.
+        max_depth (int, optional): Maximum depth of nested data structure, or None for no depth.
+            Defaults to None.
+        expand_all (bool, optional): Expand all containers regardless of available width. Defaults to False.
+
+    Returns:
+        str: A possibly multi-line representation of the object.
+    """
+
+    if _safe_isinstance(_object, Node):
+        node = _object
+    else:
+        node = traverse(
+            _object, max_length=max_length, max_string=max_string, max_depth=max_depth
+        )
+    repr_str: str = node.render(
+        max_width=max_width, indent_size=indent_size, expand_all=expand_all
+    )
+    return repr_str
+
+
+def pprint(
+    _object: Any,
+    *,
+    console: Optional["Console"] = None,
+    indent_guides: bool = True,
+    max_length: Optional[int] = None,
+    max_string: Optional[int] = None,
+    max_depth: Optional[int] = None,
+    expand_all: bool = False,
+) -> None:
+    """A convenience function for pretty printing.
+
+    Args:
+        _object (Any): Object to pretty print.
+        console (Console, optional): Console instance, or None to use default. Defaults to None.
+        max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to None.
+        max_string (int, optional): Maximum length of strings before truncating, or None to disable. Defaults to None.
+        max_depth (int, optional): Maximum depth for nested data structures, or None for unlimited depth. Defaults to None.
+        indent_guides (bool, optional): Enable indentation guides. Defaults to True.
+        expand_all (bool, optional): Expand all containers. Defaults to False.
+    """
+    _console = get_console() if console is None else console
+    _console.print(
+        Pretty(
+            _object,
+            max_length=max_length,
+            max_string=max_string,
+            max_depth=max_depth,
+            indent_guides=indent_guides,
+            expand_all=expand_all,
+            overflow="ignore",
+        ),
+        soft_wrap=True,
+    )
+
+
+if __name__ == "__main__":  # pragma: no cover
+
+    class BrokenRepr:
+        def __repr__(self) -> str:
+            1 / 0
+            return "this will fail"
+
+    from typing import NamedTuple
+
+    class StockKeepingUnit(NamedTuple):
+        name: str
+        description: str
+        price: float
+        category: str
+        reviews: List[str]
+
+    d = defaultdict(int)
+    d["foo"] = 5
+    data = {
+        "foo": [
+            1,
+            "Hello World!",
+            100.123,
+            323.232,
+            432324.0,
+            {5, 6, 7, (1, 2, 3, 4), 8},
+        ],
+        "bar": frozenset({1, 2, 3}),
+        "defaultdict": defaultdict(
+            list, {"crumble": ["apple", "rhubarb", "butter", "sugar", "flour"]}
+        ),
+        "counter": Counter(
+            [
+                "apple",
+                "orange",
+                "pear",
+                "kumquat",
+                "kumquat",
+                "durian" * 100,
+            ]
+        ),
+        "atomic": (False, True, None),
+        "namedtuple": StockKeepingUnit(
+            "Sparkling British Spring Water",
+            "Carbonated spring water",
+            0.9,
+            "water",
+            ["its amazing!", "its terrible!"],
+        ),
+        "Broken": BrokenRepr(),
+    }
+    data["foo"].append(data)  # type: ignore[attr-defined]
+
+    from pip._vendor.rich import print
+
+    print(Pretty(data, indent_guides=True, max_string=20))
+
+    class Thing:
+        def __repr__(self) -> str:
+            return "Hello\x1b[38;5;239m World!"
+
+    print(Pretty(Thing()))
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/progress.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/progress.py
new file mode 100644
index 0000000..ec086d9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/progress.py
@@ -0,0 +1,1715 @@
+import io
+import sys
+import typing
+import warnings
+from abc import ABC, abstractmethod
+from collections import deque
+from dataclasses import dataclass, field
+from datetime import timedelta
+from io import RawIOBase, UnsupportedOperation
+from math import ceil
+from mmap import mmap
+from operator import length_hint
+from os import PathLike, stat
+from threading import Event, RLock, Thread
+from types import TracebackType
+from typing import (
+    Any,
+    BinaryIO,
+    Callable,
+    ContextManager,
+    Deque,
+    Dict,
+    Generic,
+    Iterable,
+    List,
+    NamedTuple,
+    NewType,
+    Optional,
+    Sequence,
+    TextIO,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from pip._vendor.typing_extensions import Literal  # pragma: no cover
+
+if sys.version_info >= (3, 11):
+    from typing import Self
+else:
+    from pip._vendor.typing_extensions import Self  # pragma: no cover
+
+from . import filesize, get_console
+from .console import Console, Group, JustifyMethod, RenderableType
+from .highlighter import Highlighter
+from .jupyter import JupyterMixin
+from .live import Live
+from .progress_bar import ProgressBar
+from .spinner import Spinner
+from .style import StyleType
+from .table import Column, Table
+from .text import Text, TextType
+
+TaskID = NewType("TaskID", int)
+
+ProgressType = TypeVar("ProgressType")
+
+GetTimeCallable = Callable[[], float]
+
+
+_I = typing.TypeVar("_I", TextIO, BinaryIO)
+
+
+class _TrackThread(Thread):
+    """A thread to periodically update progress."""
+
+    def __init__(self, progress: "Progress", task_id: "TaskID", update_period: float):
+        self.progress = progress
+        self.task_id = task_id
+        self.update_period = update_period
+        self.done = Event()
+
+        self.completed = 0
+        super().__init__(daemon=True)
+
+    def run(self) -> None:
+        task_id = self.task_id
+        advance = self.progress.advance
+        update_period = self.update_period
+        last_completed = 0
+        wait = self.done.wait
+        while not wait(update_period) and self.progress.live.is_started:
+            completed = self.completed
+            if last_completed != completed:
+                advance(task_id, completed - last_completed)
+                last_completed = completed
+
+        self.progress.update(self.task_id, completed=self.completed, refresh=True)
+
+    def __enter__(self) -> "_TrackThread":
+        self.start()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.done.set()
+        self.join()
+
+
+def track(
+    sequence: Union[Sequence[ProgressType], Iterable[ProgressType]],
+    description: str = "Working...",
+    total: Optional[float] = None,
+    completed: int = 0,
+    auto_refresh: bool = True,
+    console: Optional[Console] = None,
+    transient: bool = False,
+    get_time: Optional[Callable[[], float]] = None,
+    refresh_per_second: float = 10,
+    style: StyleType = "bar.back",
+    complete_style: StyleType = "bar.complete",
+    finished_style: StyleType = "bar.finished",
+    pulse_style: StyleType = "bar.pulse",
+    update_period: float = 0.1,
+    disable: bool = False,
+    show_speed: bool = True,
+) -> Iterable[ProgressType]:
+    """Track progress by iterating over a sequence.
+
+    Args:
+        sequence (Iterable[ProgressType]): A sequence (must support "len") you wish to iterate over.
+        description (str, optional): Description of task show next to progress bar. Defaults to "Working".
+        total: (float, optional): Total number of steps. Default is len(sequence).
+        completed (int, optional): Number of steps completed so far. Defaults to 0.
+        auto_refresh (bool, optional): Automatic refresh, disable to force a refresh after each iteration. Default is True.
+        transient: (bool, optional): Clear the progress on exit. Defaults to False.
+        console (Console, optional): Console to write to. Default creates internal Console instance.
+        refresh_per_second (float): Number of times per second to refresh the progress information. Defaults to 10.
+        style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
+        complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
+        pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
+        update_period (float, optional): Minimum time (in seconds) between calls to update(). Defaults to 0.1.
+        disable (bool, optional): Disable display of progress.
+        show_speed (bool, optional): Show speed if total isn't known. Defaults to True.
+    Returns:
+        Iterable[ProgressType]: An iterable of the values in the sequence.
+
+    """
+
+    columns: List["ProgressColumn"] = (
+        [TextColumn("[progress.description]{task.description}")] if description else []
+    )
+    columns.extend(
+        (
+            BarColumn(
+                style=style,
+                complete_style=complete_style,
+                finished_style=finished_style,
+                pulse_style=pulse_style,
+            ),
+            TaskProgressColumn(show_speed=show_speed),
+            TimeRemainingColumn(elapsed_when_finished=True),
+        )
+    )
+    progress = Progress(
+        *columns,
+        auto_refresh=auto_refresh,
+        console=console,
+        transient=transient,
+        get_time=get_time,
+        refresh_per_second=refresh_per_second or 10,
+        disable=disable,
+    )
+
+    with progress:
+        yield from progress.track(
+            sequence,
+            total=total,
+            completed=completed,
+            description=description,
+            update_period=update_period,
+        )
+
+
+class _Reader(RawIOBase, BinaryIO):
+    """A reader that tracks progress while it's being read from."""
+
+    def __init__(
+        self,
+        handle: BinaryIO,
+        progress: "Progress",
+        task: TaskID,
+        close_handle: bool = True,
+    ) -> None:
+        self.handle = handle
+        self.progress = progress
+        self.task = task
+        self.close_handle = close_handle
+        self._closed = False
+
+    def __enter__(self) -> "_Reader":
+        self.handle.__enter__()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.close()
+
+    def __iter__(self) -> BinaryIO:
+        return self
+
+    def __next__(self) -> bytes:
+        line = next(self.handle)
+        self.progress.advance(self.task, advance=len(line))
+        return line
+
+    @property
+    def closed(self) -> bool:
+        return self._closed
+
+    def fileno(self) -> int:
+        return self.handle.fileno()
+
+    def isatty(self) -> bool:
+        return self.handle.isatty()
+
+    @property
+    def mode(self) -> str:
+        return self.handle.mode
+
+    @property
+    def name(self) -> str:
+        return self.handle.name
+
+    def readable(self) -> bool:
+        return self.handle.readable()
+
+    def seekable(self) -> bool:
+        return self.handle.seekable()
+
+    def writable(self) -> bool:
+        return False
+
+    def read(self, size: int = -1) -> bytes:
+        block = self.handle.read(size)
+        self.progress.advance(self.task, advance=len(block))
+        return block
+
+    def readinto(self, b: Union[bytearray, memoryview, mmap]):  # type: ignore[no-untyped-def, override]
+        n = self.handle.readinto(b)  # type: ignore[attr-defined]
+        self.progress.advance(self.task, advance=n)
+        return n
+
+    def readline(self, size: int = -1) -> bytes:  # type: ignore[override]
+        line = self.handle.readline(size)
+        self.progress.advance(self.task, advance=len(line))
+        return line
+
+    def readlines(self, hint: int = -1) -> List[bytes]:
+        lines = self.handle.readlines(hint)
+        self.progress.advance(self.task, advance=sum(map(len, lines)))
+        return lines
+
+    def close(self) -> None:
+        if self.close_handle:
+            self.handle.close()
+        self._closed = True
+
+    def seek(self, offset: int, whence: int = 0) -> int:
+        pos = self.handle.seek(offset, whence)
+        self.progress.update(self.task, completed=pos)
+        return pos
+
+    def tell(self) -> int:
+        return self.handle.tell()
+
+    def write(self, s: Any) -> int:
+        raise UnsupportedOperation("write")
+
+    def writelines(self, lines: Iterable[Any]) -> None:
+        raise UnsupportedOperation("writelines")
+
+
+class _ReadContext(ContextManager[_I], Generic[_I]):
+    """A utility class to handle a context for both a reader and a progress."""
+
+    def __init__(self, progress: "Progress", reader: _I) -> None:
+        self.progress = progress
+        self.reader: _I = reader
+
+    def __enter__(self) -> _I:
+        self.progress.start()
+        return self.reader.__enter__()
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.progress.stop()
+        self.reader.__exit__(exc_type, exc_val, exc_tb)
+
+
+def wrap_file(
+    file: BinaryIO,
+    total: int,
+    *,
+    description: str = "Reading...",
+    auto_refresh: bool = True,
+    console: Optional[Console] = None,
+    transient: bool = False,
+    get_time: Optional[Callable[[], float]] = None,
+    refresh_per_second: float = 10,
+    style: StyleType = "bar.back",
+    complete_style: StyleType = "bar.complete",
+    finished_style: StyleType = "bar.finished",
+    pulse_style: StyleType = "bar.pulse",
+    disable: bool = False,
+) -> ContextManager[BinaryIO]:
+    """Read bytes from a file while tracking progress.
+
+    Args:
+        file (Union[str, PathLike[str], BinaryIO]): The path to the file to read, or a file-like object in binary mode.
+        total (int): Total number of bytes to read.
+        description (str, optional): Description of task show next to progress bar. Defaults to "Reading".
+        auto_refresh (bool, optional): Automatic refresh, disable to force a refresh after each iteration. Default is True.
+        transient: (bool, optional): Clear the progress on exit. Defaults to False.
+        console (Console, optional): Console to write to. Default creates internal Console instance.
+        refresh_per_second (float): Number of times per second to refresh the progress information. Defaults to 10.
+        style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
+        complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
+        pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
+        disable (bool, optional): Disable display of progress.
+    Returns:
+        ContextManager[BinaryIO]: A context manager yielding a progress reader.
+
+    """
+
+    columns: List["ProgressColumn"] = (
+        [TextColumn("[progress.description]{task.description}")] if description else []
+    )
+    columns.extend(
+        (
+            BarColumn(
+                style=style,
+                complete_style=complete_style,
+                finished_style=finished_style,
+                pulse_style=pulse_style,
+            ),
+            DownloadColumn(),
+            TimeRemainingColumn(),
+        )
+    )
+    progress = Progress(
+        *columns,
+        auto_refresh=auto_refresh,
+        console=console,
+        transient=transient,
+        get_time=get_time,
+        refresh_per_second=refresh_per_second or 10,
+        disable=disable,
+    )
+
+    reader = progress.wrap_file(file, total=total, description=description)
+    return _ReadContext(progress, reader)
+
+
+@typing.overload
+def open(
+    file: Union[str, "PathLike[str]", bytes],
+    mode: Union[Literal["rt"], Literal["r"]],
+    buffering: int = -1,
+    encoding: Optional[str] = None,
+    errors: Optional[str] = None,
+    newline: Optional[str] = None,
+    *,
+    total: Optional[int] = None,
+    description: str = "Reading...",
+    auto_refresh: bool = True,
+    console: Optional[Console] = None,
+    transient: bool = False,
+    get_time: Optional[Callable[[], float]] = None,
+    refresh_per_second: float = 10,
+    style: StyleType = "bar.back",
+    complete_style: StyleType = "bar.complete",
+    finished_style: StyleType = "bar.finished",
+    pulse_style: StyleType = "bar.pulse",
+    disable: bool = False,
+) -> ContextManager[TextIO]:
+    pass
+
+
+@typing.overload
+def open(
+    file: Union[str, "PathLike[str]", bytes],
+    mode: Literal["rb"],
+    buffering: int = -1,
+    encoding: Optional[str] = None,
+    errors: Optional[str] = None,
+    newline: Optional[str] = None,
+    *,
+    total: Optional[int] = None,
+    description: str = "Reading...",
+    auto_refresh: bool = True,
+    console: Optional[Console] = None,
+    transient: bool = False,
+    get_time: Optional[Callable[[], float]] = None,
+    refresh_per_second: float = 10,
+    style: StyleType = "bar.back",
+    complete_style: StyleType = "bar.complete",
+    finished_style: StyleType = "bar.finished",
+    pulse_style: StyleType = "bar.pulse",
+    disable: bool = False,
+) -> ContextManager[BinaryIO]:
+    pass
+
+
+def open(
+    file: Union[str, "PathLike[str]", bytes],
+    mode: Union[Literal["rb"], Literal["rt"], Literal["r"]] = "r",
+    buffering: int = -1,
+    encoding: Optional[str] = None,
+    errors: Optional[str] = None,
+    newline: Optional[str] = None,
+    *,
+    total: Optional[int] = None,
+    description: str = "Reading...",
+    auto_refresh: bool = True,
+    console: Optional[Console] = None,
+    transient: bool = False,
+    get_time: Optional[Callable[[], float]] = None,
+    refresh_per_second: float = 10,
+    style: StyleType = "bar.back",
+    complete_style: StyleType = "bar.complete",
+    finished_style: StyleType = "bar.finished",
+    pulse_style: StyleType = "bar.pulse",
+    disable: bool = False,
+) -> Union[ContextManager[BinaryIO], ContextManager[TextIO]]:
+    """Read bytes from a file while tracking progress.
+
+    Args:
+        path (Union[str, PathLike[str], BinaryIO]): The path to the file to read, or a file-like object in binary mode.
+        mode (str): The mode to use to open the file. Only supports "r", "rb" or "rt".
+        buffering (int): The buffering strategy to use, see :func:`io.open`.
+        encoding (str, optional): The encoding to use when reading in text mode, see :func:`io.open`.
+        errors (str, optional): The error handling strategy for decoding errors, see :func:`io.open`.
+        newline (str, optional): The strategy for handling newlines in text mode, see :func:`io.open`
+        total: (int, optional): Total number of bytes to read. Must be provided if reading from a file handle. Default for a path is os.stat(file).st_size.
+        description (str, optional): Description of task show next to progress bar. Defaults to "Reading".
+        auto_refresh (bool, optional): Automatic refresh, disable to force a refresh after each iteration. Default is True.
+        transient: (bool, optional): Clear the progress on exit. Defaults to False.
+        console (Console, optional): Console to write to. Default creates internal Console instance.
+        refresh_per_second (float): Number of times per second to refresh the progress information. Defaults to 10.
+        style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
+        complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
+        pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
+        disable (bool, optional): Disable display of progress.
+        encoding (str, optional): The encoding to use when reading in text mode.
+
+    Returns:
+        ContextManager[BinaryIO]: A context manager yielding a progress reader.
+
+    """
+
+    columns: List["ProgressColumn"] = (
+        [TextColumn("[progress.description]{task.description}")] if description else []
+    )
+    columns.extend(
+        (
+            BarColumn(
+                style=style,
+                complete_style=complete_style,
+                finished_style=finished_style,
+                pulse_style=pulse_style,
+            ),
+            DownloadColumn(),
+            TimeRemainingColumn(),
+        )
+    )
+    progress = Progress(
+        *columns,
+        auto_refresh=auto_refresh,
+        console=console,
+        transient=transient,
+        get_time=get_time,
+        refresh_per_second=refresh_per_second or 10,
+        disable=disable,
+    )
+
+    reader = progress.open(
+        file,
+        mode=mode,
+        buffering=buffering,
+        encoding=encoding,
+        errors=errors,
+        newline=newline,
+        total=total,
+        description=description,
+    )
+    return _ReadContext(progress, reader)  # type: ignore[return-value, type-var]
+
+
+class ProgressColumn(ABC):
+    """Base class for a widget to use in progress display."""
+
+    max_refresh: Optional[float] = None
+
+    def __init__(self, table_column: Optional[Column] = None) -> None:
+        self._table_column = table_column
+        self._renderable_cache: Dict[TaskID, Tuple[float, RenderableType]] = {}
+        self._update_time: Optional[float] = None
+
+    def get_table_column(self) -> Column:
+        """Get a table column, used to build tasks table."""
+        return self._table_column or Column()
+
+    def __call__(self, task: "Task") -> RenderableType:
+        """Called by the Progress object to return a renderable for the given task.
+
+        Args:
+            task (Task): An object containing information regarding the task.
+
+        Returns:
+            RenderableType: Anything renderable (including str).
+        """
+        current_time = task.get_time()
+        if self.max_refresh is not None and not task.completed:
+            try:
+                timestamp, renderable = self._renderable_cache[task.id]
+            except KeyError:
+                pass
+            else:
+                if timestamp + self.max_refresh > current_time:
+                    return renderable
+
+        renderable = self.render(task)
+        self._renderable_cache[task.id] = (current_time, renderable)
+        return renderable
+
+    @abstractmethod
+    def render(self, task: "Task") -> RenderableType:
+        """Should return a renderable object."""
+
+
+class RenderableColumn(ProgressColumn):
+    """A column to insert an arbitrary column.
+
+    Args:
+        renderable (RenderableType, optional): Any renderable. Defaults to empty string.
+    """
+
+    def __init__(
+        self, renderable: RenderableType = "", *, table_column: Optional[Column] = None
+    ):
+        self.renderable = renderable
+        super().__init__(table_column=table_column)
+
+    def render(self, task: "Task") -> RenderableType:
+        return self.renderable
+
+
+class SpinnerColumn(ProgressColumn):
+    """A column with a 'spinner' animation.
+
+    Args:
+        spinner_name (str, optional): Name of spinner animation. Defaults to "dots".
+        style (StyleType, optional): Style of spinner. Defaults to "progress.spinner".
+        speed (float, optional): Speed factor of spinner. Defaults to 1.0.
+        finished_text (TextType, optional): Text used when task is finished. Defaults to " ".
+    """
+
+    def __init__(
+        self,
+        spinner_name: str = "dots",
+        style: Optional[StyleType] = "progress.spinner",
+        speed: float = 1.0,
+        finished_text: TextType = " ",
+        table_column: Optional[Column] = None,
+    ):
+        self.spinner = Spinner(spinner_name, style=style, speed=speed)
+        self.finished_text = (
+            Text.from_markup(finished_text)
+            if isinstance(finished_text, str)
+            else finished_text
+        )
+        super().__init__(table_column=table_column)
+
+    def set_spinner(
+        self,
+        spinner_name: str,
+        spinner_style: Optional[StyleType] = "progress.spinner",
+        speed: float = 1.0,
+    ) -> None:
+        """Set a new spinner.
+
+        Args:
+            spinner_name (str): Spinner name, see python -m rich.spinner.
+            spinner_style (Optional[StyleType], optional): Spinner style. Defaults to "progress.spinner".
+            speed (float, optional): Speed factor of spinner. Defaults to 1.0.
+        """
+        self.spinner = Spinner(spinner_name, style=spinner_style, speed=speed)
+
+    def render(self, task: "Task") -> RenderableType:
+        text = (
+            self.finished_text
+            if task.finished
+            else self.spinner.render(task.get_time())
+        )
+        return text
+
+
+class TextColumn(ProgressColumn):
+    """A column containing text."""
+
+    def __init__(
+        self,
+        text_format: str,
+        style: StyleType = "none",
+        justify: JustifyMethod = "left",
+        markup: bool = True,
+        highlighter: Optional[Highlighter] = None,
+        table_column: Optional[Column] = None,
+    ) -> None:
+        self.text_format = text_format
+        self.justify: JustifyMethod = justify
+        self.style = style
+        self.markup = markup
+        self.highlighter = highlighter
+        super().__init__(table_column=table_column or Column(no_wrap=True))
+
+    def render(self, task: "Task") -> Text:
+        _text = self.text_format.format(task=task)
+        if self.markup:
+            text = Text.from_markup(_text, style=self.style, justify=self.justify)
+        else:
+            text = Text(_text, style=self.style, justify=self.justify)
+        if self.highlighter:
+            self.highlighter.highlight(text)
+        return text
+
+
+class BarColumn(ProgressColumn):
+    """Renders a visual progress bar.
+
+    Args:
+        bar_width (Optional[int], optional): Width of bar or None for full width. Defaults to 40.
+        style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
+        complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
+        pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
+    """
+
+    def __init__(
+        self,
+        bar_width: Optional[int] = 40,
+        style: StyleType = "bar.back",
+        complete_style: StyleType = "bar.complete",
+        finished_style: StyleType = "bar.finished",
+        pulse_style: StyleType = "bar.pulse",
+        table_column: Optional[Column] = None,
+    ) -> None:
+        self.bar_width = bar_width
+        self.style = style
+        self.complete_style = complete_style
+        self.finished_style = finished_style
+        self.pulse_style = pulse_style
+        super().__init__(table_column=table_column)
+
+    def render(self, task: "Task") -> ProgressBar:
+        """Gets a progress bar widget for a task."""
+        return ProgressBar(
+            total=max(0, task.total) if task.total is not None else None,
+            completed=max(0, task.completed),
+            width=None if self.bar_width is None else max(1, self.bar_width),
+            pulse=not task.started,
+            animation_time=task.get_time(),
+            style=self.style,
+            complete_style=self.complete_style,
+            finished_style=self.finished_style,
+            pulse_style=self.pulse_style,
+        )
+
+
+class TimeElapsedColumn(ProgressColumn):
+    """Renders time elapsed."""
+
+    def render(self, task: "Task") -> Text:
+        """Show time elapsed."""
+        elapsed = task.finished_time if task.finished else task.elapsed
+        if elapsed is None:
+            return Text("-:--:--", style="progress.elapsed")
+        delta = timedelta(seconds=max(0, int(elapsed)))
+        return Text(str(delta), style="progress.elapsed")
+
+
+class TaskProgressColumn(TextColumn):
+    """Show task progress as a percentage.
+
+    Args:
+        text_format (str, optional): Format for percentage display. Defaults to "[progress.percentage]{task.percentage:>3.0f}%".
+        text_format_no_percentage (str, optional): Format if percentage is unknown. Defaults to "".
+        style (StyleType, optional): Style of output. Defaults to "none".
+        justify (JustifyMethod, optional): Text justification. Defaults to "left".
+        markup (bool, optional): Enable markup. Defaults to True.
+        highlighter (Optional[Highlighter], optional): Highlighter to apply to output. Defaults to None.
+        table_column (Optional[Column], optional): Table Column to use. Defaults to None.
+        show_speed (bool, optional): Show speed if total is unknown. Defaults to False.
+    """
+
+    def __init__(
+        self,
+        text_format: str = "[progress.percentage]{task.percentage:>3.0f}%",
+        text_format_no_percentage: str = "",
+        style: StyleType = "none",
+        justify: JustifyMethod = "left",
+        markup: bool = True,
+        highlighter: Optional[Highlighter] = None,
+        table_column: Optional[Column] = None,
+        show_speed: bool = False,
+    ) -> None:
+        self.text_format_no_percentage = text_format_no_percentage
+        self.show_speed = show_speed
+        super().__init__(
+            text_format=text_format,
+            style=style,
+            justify=justify,
+            markup=markup,
+            highlighter=highlighter,
+            table_column=table_column,
+        )
+
+    @classmethod
+    def render_speed(cls, speed: Optional[float]) -> Text:
+        """Render the speed in iterations per second.
+
+        Args:
+            task (Task): A Task object.
+
+        Returns:
+            Text: Text object containing the task speed.
+        """
+        if speed is None:
+            return Text("", style="progress.percentage")
+        unit, suffix = filesize.pick_unit_and_suffix(
+            int(speed),
+            ["", "×10³", "×10⁶", "×10⁹", "×10¹²"],
+            1000,
+        )
+        data_speed = speed / unit
+        return Text(f"{data_speed:.1f}{suffix} it/s", style="progress.percentage")
+
+    def render(self, task: "Task") -> Text:
+        if task.total is None and self.show_speed:
+            return self.render_speed(task.finished_speed or task.speed)
+        text_format = (
+            self.text_format_no_percentage if task.total is None else self.text_format
+        )
+        _text = text_format.format(task=task)
+        if self.markup:
+            text = Text.from_markup(_text, style=self.style, justify=self.justify)
+        else:
+            text = Text(_text, style=self.style, justify=self.justify)
+        if self.highlighter:
+            self.highlighter.highlight(text)
+        return text
+
+
+class TimeRemainingColumn(ProgressColumn):
+    """Renders estimated time remaining.
+
+    Args:
+        compact (bool, optional): Render MM:SS when time remaining is less than an hour. Defaults to False.
+        elapsed_when_finished (bool, optional): Render time elapsed when the task is finished. Defaults to False.
+    """
+
+    # Only refresh twice a second to prevent jitter
+    max_refresh = 0.5
+
+    def __init__(
+        self,
+        compact: bool = False,
+        elapsed_when_finished: bool = False,
+        table_column: Optional[Column] = None,
+    ):
+        self.compact = compact
+        self.elapsed_when_finished = elapsed_when_finished
+        super().__init__(table_column=table_column)
+
+    def render(self, task: "Task") -> Text:
+        """Show time remaining."""
+        if self.elapsed_when_finished and task.finished:
+            task_time = task.finished_time
+            style = "progress.elapsed"
+        else:
+            task_time = task.time_remaining
+            style = "progress.remaining"
+
+        if task.total is None:
+            return Text("", style=style)
+
+        if task_time is None:
+            return Text("--:--" if self.compact else "-:--:--", style=style)
+
+        # Based on https://github.com/tqdm/tqdm/blob/master/tqdm/std.py
+        minutes, seconds = divmod(int(task_time), 60)
+        hours, minutes = divmod(minutes, 60)
+
+        if self.compact and not hours:
+            formatted = f"{minutes:02d}:{seconds:02d}"
+        else:
+            formatted = f"{hours:d}:{minutes:02d}:{seconds:02d}"
+
+        return Text(formatted, style=style)
+
+
+class FileSizeColumn(ProgressColumn):
+    """Renders completed filesize."""
+
+    def render(self, task: "Task") -> Text:
+        """Show data completed."""
+        data_size = filesize.decimal(int(task.completed))
+        return Text(data_size, style="progress.filesize")
+
+
+class TotalFileSizeColumn(ProgressColumn):
+    """Renders total filesize."""
+
+    def render(self, task: "Task") -> Text:
+        """Show data completed."""
+        data_size = filesize.decimal(int(task.total)) if task.total is not None else ""
+        return Text(data_size, style="progress.filesize.total")
+
+
+class MofNCompleteColumn(ProgressColumn):
+    """Renders completed count/total, e.g. '  10/1000'.
+
+    Best for bounded tasks with int quantities.
+
+    Space pads the completed count so that progress length does not change as task progresses
+    past powers of 10.
+
+    Args:
+        separator (str, optional): Text to separate completed and total values. Defaults to "/".
+    """
+
+    def __init__(self, separator: str = "/", table_column: Optional[Column] = None):
+        self.separator = separator
+        super().__init__(table_column=table_column)
+
+    def render(self, task: "Task") -> Text:
+        """Show completed/total."""
+        completed = int(task.completed)
+        total = int(task.total) if task.total is not None else "?"
+        total_width = len(str(total))
+        return Text(
+            f"{completed:{total_width}d}{self.separator}{total}",
+            style="progress.download",
+        )
+
+
+class DownloadColumn(ProgressColumn):
+    """Renders file size downloaded and total, e.g. '0.5/2.3 GB'.
+
+    Args:
+        binary_units (bool, optional): Use binary units, KiB, MiB etc. Defaults to False.
+    """
+
+    def __init__(
+        self, binary_units: bool = False, table_column: Optional[Column] = None
+    ) -> None:
+        self.binary_units = binary_units
+        super().__init__(table_column=table_column)
+
+    def render(self, task: "Task") -> Text:
+        """Calculate common unit for completed and total."""
+        completed = int(task.completed)
+
+        unit_and_suffix_calculation_base = (
+            int(task.total) if task.total is not None else completed
+        )
+        if self.binary_units:
+            unit, suffix = filesize.pick_unit_and_suffix(
+                unit_and_suffix_calculation_base,
+                ["bytes", "KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB"],
+                1024,
+            )
+        else:
+            unit, suffix = filesize.pick_unit_and_suffix(
+                unit_and_suffix_calculation_base,
+                ["bytes", "kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"],
+                1000,
+            )
+        precision = 0 if unit == 1 else 1
+
+        completed_ratio = completed / unit
+        completed_str = f"{completed_ratio:,.{precision}f}"
+
+        if task.total is not None:
+            total = int(task.total)
+            total_ratio = total / unit
+            total_str = f"{total_ratio:,.{precision}f}"
+        else:
+            total_str = "?"
+
+        download_status = f"{completed_str}/{total_str} {suffix}"
+        download_text = Text(download_status, style="progress.download")
+        return download_text
+
+
+class TransferSpeedColumn(ProgressColumn):
+    """Renders human readable transfer speed."""
+
+    def render(self, task: "Task") -> Text:
+        """Show data transfer speed."""
+        speed = task.finished_speed or task.speed
+        if speed is None:
+            return Text("?", style="progress.data.speed")
+        data_speed = filesize.decimal(int(speed))
+        return Text(f"{data_speed}/s", style="progress.data.speed")
+
+
+class ProgressSample(NamedTuple):
+    """Sample of progress for a given time."""
+
+    timestamp: float
+    """Timestamp of sample."""
+    completed: float
+    """Number of steps completed."""
+
+
+@dataclass
+class Task:
+    """Information regarding a progress task.
+
+    This object should be considered read-only outside of the :class:`~Progress` class.
+
+    """
+
+    id: TaskID
+    """Task ID associated with this task (used in Progress methods)."""
+
+    description: str
+    """str: Description of the task."""
+
+    total: Optional[float]
+    """Optional[float]: Total number of steps in this task."""
+
+    completed: float
+    """float: Number of steps completed"""
+
+    _get_time: GetTimeCallable
+    """Callable to get the current time."""
+
+    finished_time: Optional[float] = None
+    """float: Time task was finished."""
+
+    visible: bool = True
+    """bool: Indicates if this task is visible in the progress display."""
+
+    fields: Dict[str, Any] = field(default_factory=dict)
+    """dict: Arbitrary fields passed in via Progress.update."""
+
+    start_time: Optional[float] = field(default=None, init=False, repr=False)
+    """Optional[float]: Time this task was started, or None if not started."""
+
+    stop_time: Optional[float] = field(default=None, init=False, repr=False)
+    """Optional[float]: Time this task was stopped, or None if not stopped."""
+
+    finished_speed: Optional[float] = None
+    """Optional[float]: The last speed for a finished task."""
+
+    _progress: Deque[ProgressSample] = field(
+        default_factory=lambda: deque(maxlen=1000), init=False, repr=False
+    )
+
+    _lock: RLock = field(repr=False, default_factory=RLock)
+    """Thread lock."""
+
+    def get_time(self) -> float:
+        """float: Get the current time, in seconds."""
+        return self._get_time()
+
+    @property
+    def started(self) -> bool:
+        """bool: Check if the task as started."""
+        return self.start_time is not None
+
+    @property
+    def remaining(self) -> Optional[float]:
+        """Optional[float]: Get the number of steps remaining, if a non-None total was set."""
+        if self.total is None:
+            return None
+        return self.total - self.completed
+
+    @property
+    def elapsed(self) -> Optional[float]:
+        """Optional[float]: Time elapsed since task was started, or ``None`` if the task hasn't started."""
+        if self.start_time is None:
+            return None
+        if self.stop_time is not None:
+            return self.stop_time - self.start_time
+        return self.get_time() - self.start_time
+
+    @property
+    def finished(self) -> bool:
+        """Check if the task has finished."""
+        return self.finished_time is not None
+
+    @property
+    def percentage(self) -> float:
+        """float: Get progress of task as a percentage. If a None total was set, returns 0"""
+        if not self.total:
+            return 0.0
+        completed = (self.completed / self.total) * 100.0
+        completed = min(100.0, max(0.0, completed))
+        return completed
+
+    @property
+    def speed(self) -> Optional[float]:
+        """Optional[float]: Get the estimated speed in steps per second."""
+        if self.start_time is None:
+            return None
+        with self._lock:
+            progress = self._progress
+            if not progress:
+                return None
+            total_time = progress[-1].timestamp - progress[0].timestamp
+            if total_time == 0:
+                return None
+            iter_progress = iter(progress)
+            next(iter_progress)
+            total_completed = sum(sample.completed for sample in iter_progress)
+            speed = total_completed / total_time
+            return speed
+
+    @property
+    def time_remaining(self) -> Optional[float]:
+        """Optional[float]: Get estimated time to completion, or ``None`` if no data."""
+        if self.finished:
+            return 0.0
+        speed = self.speed
+        if not speed:
+            return None
+        remaining = self.remaining
+        if remaining is None:
+            return None
+        estimate = ceil(remaining / speed)
+        return estimate
+
+    def _reset(self) -> None:
+        """Reset progress."""
+        self._progress.clear()
+        self.finished_time = None
+        self.finished_speed = None
+
+
+class Progress(JupyterMixin):
+    """Renders an auto-updating progress bar(s).
+
+    Args:
+        console (Console, optional): Optional Console instance. Defaults to an internal Console instance writing to stdout.
+        auto_refresh (bool, optional): Enable auto refresh. If disabled, you will need to call `refresh()`.
+        refresh_per_second (Optional[float], optional): Number of times per second to refresh the progress information or None to use default (10). Defaults to None.
+        speed_estimate_period: (float, optional): Period (in seconds) used to calculate the speed estimate. Defaults to 30.
+        transient: (bool, optional): Clear the progress on exit. Defaults to False.
+        redirect_stdout: (bool, optional): Enable redirection of stdout, so ``print`` may be used. Defaults to True.
+        redirect_stderr: (bool, optional): Enable redirection of stderr. Defaults to True.
+        get_time: (Callable, optional): A callable that gets the current time, or None to use Console.get_time. Defaults to None.
+        disable (bool, optional): Disable progress display. Defaults to False
+        expand (bool, optional): Expand tasks table to fit width. Defaults to False.
+    """
+
+    def __init__(
+        self,
+        *columns: Union[str, ProgressColumn],
+        console: Optional[Console] = None,
+        auto_refresh: bool = True,
+        refresh_per_second: float = 10,
+        speed_estimate_period: float = 30.0,
+        transient: bool = False,
+        redirect_stdout: bool = True,
+        redirect_stderr: bool = True,
+        get_time: Optional[GetTimeCallable] = None,
+        disable: bool = False,
+        expand: bool = False,
+    ) -> None:
+        assert refresh_per_second > 0, "refresh_per_second must be > 0"
+        self._lock = RLock()
+        self.columns = columns or self.get_default_columns()
+        self.speed_estimate_period = speed_estimate_period
+
+        self.disable = disable
+        self.expand = expand
+        self._tasks: Dict[TaskID, Task] = {}
+        self._task_index: TaskID = TaskID(0)
+        self.live = Live(
+            console=console or get_console(),
+            auto_refresh=auto_refresh,
+            refresh_per_second=refresh_per_second,
+            transient=transient,
+            redirect_stdout=redirect_stdout,
+            redirect_stderr=redirect_stderr,
+            get_renderable=self.get_renderable,
+        )
+        self.get_time = get_time or self.console.get_time
+        self.print = self.console.print
+        self.log = self.console.log
+
+    @classmethod
+    def get_default_columns(cls) -> Tuple[ProgressColumn, ...]:
+        """Get the default columns used for a new Progress instance:
+           - a text column for the description (TextColumn)
+           - the bar itself (BarColumn)
+           - a text column showing completion percentage (TextColumn)
+           - an estimated-time-remaining column (TimeRemainingColumn)
+        If the Progress instance is created without passing a columns argument,
+        the default columns defined here will be used.
+
+        You can also create a Progress instance using custom columns before
+        and/or after the defaults, as in this example:
+
+            progress = Progress(
+                SpinnerColumn(),
+                *Progress.get_default_columns(),
+                "Elapsed:",
+                TimeElapsedColumn(),
+            )
+
+        This code shows the creation of a Progress display, containing
+        a spinner to the left, the default columns, and a labeled elapsed
+        time column.
+        """
+        return (
+            TextColumn("[progress.description]{task.description}"),
+            BarColumn(),
+            TaskProgressColumn(),
+            TimeRemainingColumn(),
+        )
+
+    @property
+    def console(self) -> Console:
+        return self.live.console
+
+    @property
+    def tasks(self) -> List[Task]:
+        """Get a list of Task instances."""
+        with self._lock:
+            return list(self._tasks.values())
+
+    @property
+    def task_ids(self) -> List[TaskID]:
+        """A list of task IDs."""
+        with self._lock:
+            return list(self._tasks.keys())
+
+    @property
+    def finished(self) -> bool:
+        """Check if all tasks have been completed."""
+        with self._lock:
+            if not self._tasks:
+                return True
+            return all(task.finished for task in self._tasks.values())
+
+    def start(self) -> None:
+        """Start the progress display."""
+        if not self.disable:
+            self.live.start(refresh=True)
+
+    def stop(self) -> None:
+        """Stop the progress display."""
+        self.live.stop()
+        if not self.console.is_interactive and not self.console.is_jupyter:
+            self.console.print()
+
+    def __enter__(self) -> Self:
+        self.start()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.stop()
+
+    def track(
+        self,
+        sequence: Union[Iterable[ProgressType], Sequence[ProgressType]],
+        total: Optional[float] = None,
+        completed: int = 0,
+        task_id: Optional[TaskID] = None,
+        description: str = "Working...",
+        update_period: float = 0.1,
+    ) -> Iterable[ProgressType]:
+        """Track progress by iterating over a sequence.
+
+        Args:
+            sequence (Sequence[ProgressType]): A sequence of values you want to iterate over and track progress.
+            total: (float, optional): Total number of steps. Default is len(sequence).
+            completed (int, optional): Number of steps completed so far. Defaults to 0.
+            task_id: (TaskID): Task to track. Default is new task.
+            description: (str, optional): Description of task, if new task is created.
+            update_period (float, optional): Minimum time (in seconds) between calls to update(). Defaults to 0.1.
+
+        Returns:
+            Iterable[ProgressType]: An iterable of values taken from the provided sequence.
+        """
+        if total is None:
+            total = float(length_hint(sequence)) or None
+
+        if task_id is None:
+            task_id = self.add_task(description, total=total, completed=completed)
+        else:
+            self.update(task_id, total=total, completed=completed)
+
+        if self.live.auto_refresh:
+            with _TrackThread(self, task_id, update_period) as track_thread:
+                for value in sequence:
+                    yield value
+                    track_thread.completed += 1
+        else:
+            advance = self.advance
+            refresh = self.refresh
+            for value in sequence:
+                yield value
+                advance(task_id, 1)
+                refresh()
+
+    def wrap_file(
+        self,
+        file: BinaryIO,
+        total: Optional[int] = None,
+        *,
+        task_id: Optional[TaskID] = None,
+        description: str = "Reading...",
+    ) -> BinaryIO:
+        """Track progress file reading from a binary file.
+
+        Args:
+            file (BinaryIO): A file-like object opened in binary mode.
+            total (int, optional): Total number of bytes to read. This must be provided unless a task with a total is also given.
+            task_id (TaskID): Task to track. Default is new task.
+            description (str, optional): Description of task, if new task is created.
+
+        Returns:
+            BinaryIO: A readable file-like object in binary mode.
+
+        Raises:
+            ValueError: When no total value can be extracted from the arguments or the task.
+        """
+        # attempt to recover the total from the task
+        total_bytes: Optional[float] = None
+        if total is not None:
+            total_bytes = total
+        elif task_id is not None:
+            with self._lock:
+                total_bytes = self._tasks[task_id].total
+        if total_bytes is None:
+            raise ValueError(
+                f"unable to get the total number of bytes, please specify 'total'"
+            )
+
+        # update total of task or create new task
+        if task_id is None:
+            task_id = self.add_task(description, total=total_bytes)
+        else:
+            self.update(task_id, total=total_bytes)
+
+        return _Reader(file, self, task_id, close_handle=False)
+
+    @typing.overload
+    def open(
+        self,
+        file: Union[str, "PathLike[str]", bytes],
+        mode: Literal["rb"],
+        buffering: int = -1,
+        encoding: Optional[str] = None,
+        errors: Optional[str] = None,
+        newline: Optional[str] = None,
+        *,
+        total: Optional[int] = None,
+        task_id: Optional[TaskID] = None,
+        description: str = "Reading...",
+    ) -> BinaryIO:
+        pass
+
+    @typing.overload
+    def open(
+        self,
+        file: Union[str, "PathLike[str]", bytes],
+        mode: Union[Literal["r"], Literal["rt"]],
+        buffering: int = -1,
+        encoding: Optional[str] = None,
+        errors: Optional[str] = None,
+        newline: Optional[str] = None,
+        *,
+        total: Optional[int] = None,
+        task_id: Optional[TaskID] = None,
+        description: str = "Reading...",
+    ) -> TextIO:
+        pass
+
+    def open(
+        self,
+        file: Union[str, "PathLike[str]", bytes],
+        mode: Union[Literal["rb"], Literal["rt"], Literal["r"]] = "r",
+        buffering: int = -1,
+        encoding: Optional[str] = None,
+        errors: Optional[str] = None,
+        newline: Optional[str] = None,
+        *,
+        total: Optional[int] = None,
+        task_id: Optional[TaskID] = None,
+        description: str = "Reading...",
+    ) -> Union[BinaryIO, TextIO]:
+        """Track progress while reading from a binary file.
+
+        Args:
+            path (Union[str, PathLike[str]]): The path to the file to read.
+            mode (str): The mode to use to open the file. Only supports "r", "rb" or "rt".
+            buffering (int): The buffering strategy to use, see :func:`io.open`.
+            encoding (str, optional): The encoding to use when reading in text mode, see :func:`io.open`.
+            errors (str, optional): The error handling strategy for decoding errors, see :func:`io.open`.
+            newline (str, optional): The strategy for handling newlines in text mode, see :func:`io.open`.
+            total (int, optional): Total number of bytes to read. If none given, os.stat(path).st_size is used.
+            task_id (TaskID): Task to track. Default is new task.
+            description (str, optional): Description of task, if new task is created.
+
+        Returns:
+            BinaryIO: A readable file-like object in binary mode.
+
+        Raises:
+            ValueError: When an invalid mode is given.
+        """
+        # normalize the mode (always rb, rt)
+        _mode = "".join(sorted(mode, reverse=False))
+        if _mode not in ("br", "rt", "r"):
+            raise ValueError(f"invalid mode {mode!r}")
+
+        # patch buffering to provide the same behaviour as the builtin `open`
+        line_buffering = buffering == 1
+        if _mode == "br" and buffering == 1:
+            warnings.warn(
+                "line buffering (buffering=1) isn't supported in binary mode, the default buffer size will be used",
+                RuntimeWarning,
+            )
+            buffering = -1
+        elif _mode in ("rt", "r"):
+            if buffering == 0:
+                raise ValueError("can't have unbuffered text I/O")
+            elif buffering == 1:
+                buffering = -1
+
+        # attempt to get the total with `os.stat`
+        if total is None:
+            total = stat(file).st_size
+
+        # update total of task or create new task
+        if task_id is None:
+            task_id = self.add_task(description, total=total)
+        else:
+            self.update(task_id, total=total)
+
+        # open the file in binary mode,
+        handle = io.open(file, "rb", buffering=buffering)
+        reader = _Reader(handle, self, task_id, close_handle=True)
+
+        # wrap the reader in a `TextIOWrapper` if text mode
+        if mode in ("r", "rt"):
+            return io.TextIOWrapper(
+                reader,
+                encoding=encoding,
+                errors=errors,
+                newline=newline,
+                line_buffering=line_buffering,
+            )
+
+        return reader
+
+    def start_task(self, task_id: TaskID) -> None:
+        """Start a task.
+
+        Starts a task (used when calculating elapsed time). You may need to call this manually,
+        if you called ``add_task`` with ``start=False``.
+
+        Args:
+            task_id (TaskID): ID of task.
+        """
+        with self._lock:
+            task = self._tasks[task_id]
+            if task.start_time is None:
+                task.start_time = self.get_time()
+
+    def stop_task(self, task_id: TaskID) -> None:
+        """Stop a task.
+
+        This will freeze the elapsed time on the task.
+
+        Args:
+            task_id (TaskID): ID of task.
+        """
+        with self._lock:
+            task = self._tasks[task_id]
+            current_time = self.get_time()
+            if task.start_time is None:
+                task.start_time = current_time
+            task.stop_time = current_time
+
+    def update(
+        self,
+        task_id: TaskID,
+        *,
+        total: Optional[float] = None,
+        completed: Optional[float] = None,
+        advance: Optional[float] = None,
+        description: Optional[str] = None,
+        visible: Optional[bool] = None,
+        refresh: bool = False,
+        **fields: Any,
+    ) -> None:
+        """Update information associated with a task.
+
+        Args:
+            task_id (TaskID): Task id (returned by add_task).
+            total (float, optional): Updates task.total if not None.
+            completed (float, optional): Updates task.completed if not None.
+            advance (float, optional): Add a value to task.completed if not None.
+            description (str, optional): Change task description if not None.
+            visible (bool, optional): Set visible flag if not None.
+            refresh (bool): Force a refresh of progress information. Default is False.
+            **fields (Any): Additional data fields required for rendering.
+        """
+        with self._lock:
+            task = self._tasks[task_id]
+            completed_start = task.completed
+
+            if total is not None and total != task.total:
+                task.total = total
+                task._reset()
+            if advance is not None:
+                task.completed += advance
+            if completed is not None:
+                task.completed = completed
+            if description is not None:
+                task.description = description
+            if visible is not None:
+                task.visible = visible
+            task.fields.update(fields)
+            update_completed = task.completed - completed_start
+
+            current_time = self.get_time()
+            old_sample_time = current_time - self.speed_estimate_period
+            _progress = task._progress
+
+            popleft = _progress.popleft
+            while _progress and _progress[0].timestamp < old_sample_time:
+                popleft()
+            if update_completed > 0:
+                _progress.append(ProgressSample(current_time, update_completed))
+            if (
+                task.total is not None
+                and task.completed >= task.total
+                and task.finished_time is None
+            ):
+                task.finished_time = task.elapsed
+
+        if refresh:
+            self.refresh()
+
+    def reset(
+        self,
+        task_id: TaskID,
+        *,
+        start: bool = True,
+        total: Optional[float] = None,
+        completed: int = 0,
+        visible: Optional[bool] = None,
+        description: Optional[str] = None,
+        **fields: Any,
+    ) -> None:
+        """Reset a task so completed is 0 and the clock is reset.
+
+        Args:
+            task_id (TaskID): ID of task.
+            start (bool, optional): Start the task after reset. Defaults to True.
+            total (float, optional): New total steps in task, or None to use current total. Defaults to None.
+            completed (int, optional): Number of steps completed. Defaults to 0.
+            visible (bool, optional): Enable display of the task. Defaults to True.
+            description (str, optional): Change task description if not None. Defaults to None.
+            **fields (str): Additional data fields required for rendering.
+        """
+        current_time = self.get_time()
+        with self._lock:
+            task = self._tasks[task_id]
+            task._reset()
+            task.start_time = current_time if start else None
+            if total is not None:
+                task.total = total
+            task.completed = completed
+            if visible is not None:
+                task.visible = visible
+            if fields:
+                task.fields = fields
+            if description is not None:
+                task.description = description
+            task.finished_time = None
+        self.refresh()
+
+    def advance(self, task_id: TaskID, advance: float = 1) -> None:
+        """Advance task by a number of steps.
+
+        Args:
+            task_id (TaskID): ID of task.
+            advance (float): Number of steps to advance. Default is 1.
+        """
+        current_time = self.get_time()
+        with self._lock:
+            task = self._tasks[task_id]
+            completed_start = task.completed
+            task.completed += advance
+            update_completed = task.completed - completed_start
+            old_sample_time = current_time - self.speed_estimate_period
+            _progress = task._progress
+
+            popleft = _progress.popleft
+            while _progress and _progress[0].timestamp < old_sample_time:
+                popleft()
+            while len(_progress) > 1000:
+                popleft()
+            _progress.append(ProgressSample(current_time, update_completed))
+            if (
+                task.total is not None
+                and task.completed >= task.total
+                and task.finished_time is None
+            ):
+                task.finished_time = task.elapsed
+                task.finished_speed = task.speed
+
+    def refresh(self) -> None:
+        """Refresh (render) the progress information."""
+        if not self.disable and self.live.is_started:
+            self.live.refresh()
+
+    def get_renderable(self) -> RenderableType:
+        """Get a renderable for the progress display."""
+        renderable = Group(*self.get_renderables())
+        return renderable
+
+    def get_renderables(self) -> Iterable[RenderableType]:
+        """Get a number of renderables for the progress display."""
+        table = self.make_tasks_table(self.tasks)
+        yield table
+
+    def make_tasks_table(self, tasks: Iterable[Task]) -> Table:
+        """Get a table to render the Progress display.
+
+        Args:
+            tasks (Iterable[Task]): An iterable of Task instances, one per row of the table.
+
+        Returns:
+            Table: A table instance.
+        """
+        table_columns = (
+            (
+                Column(no_wrap=True)
+                if isinstance(_column, str)
+                else _column.get_table_column().copy()
+            )
+            for _column in self.columns
+        )
+        table = Table.grid(*table_columns, padding=(0, 1), expand=self.expand)
+
+        for task in tasks:
+            if task.visible:
+                table.add_row(
+                    *(
+                        (
+                            column.format(task=task)
+                            if isinstance(column, str)
+                            else column(task)
+                        )
+                        for column in self.columns
+                    )
+                )
+        return table
+
+    def __rich__(self) -> RenderableType:
+        """Makes the Progress class itself renderable."""
+        with self._lock:
+            return self.get_renderable()
+
+    def add_task(
+        self,
+        description: str,
+        start: bool = True,
+        total: Optional[float] = 100.0,
+        completed: int = 0,
+        visible: bool = True,
+        **fields: Any,
+    ) -> TaskID:
+        """Add a new 'task' to the Progress display.
+
+        Args:
+            description (str): A description of the task.
+            start (bool, optional): Start the task immediately (to calculate elapsed time). If set to False,
+                you will need to call `start` manually. Defaults to True.
+            total (float, optional): Number of total steps in the progress if known.
+                Set to None to render a pulsing animation. Defaults to 100.
+            completed (int, optional): Number of steps completed so far. Defaults to 0.
+            visible (bool, optional): Enable display of the task. Defaults to True.
+            **fields (str): Additional data fields required for rendering.
+
+        Returns:
+            TaskID: An ID you can use when calling `update`.
+        """
+        with self._lock:
+            task = Task(
+                self._task_index,
+                description,
+                total,
+                completed,
+                visible=visible,
+                fields=fields,
+                _get_time=self.get_time,
+                _lock=self._lock,
+            )
+            self._tasks[self._task_index] = task
+            if start:
+                self.start_task(self._task_index)
+            new_task_index = self._task_index
+            self._task_index = TaskID(int(self._task_index) + 1)
+        self.refresh()
+        return new_task_index
+
+    def remove_task(self, task_id: TaskID) -> None:
+        """Delete a task if it exists.
+
+        Args:
+            task_id (TaskID): A task ID.
+
+        """
+        with self._lock:
+            del self._tasks[task_id]
+
+
+if __name__ == "__main__":  # pragma: no coverage
+    import random
+    import time
+
+    from .panel import Panel
+    from .rule import Rule
+    from .syntax import Syntax
+    from .table import Table
+
+    syntax = Syntax(
+        '''def loop_last(values: Iterable[T]) -> Iterable[Tuple[bool, T]]:
+    """Iterate and generate a tuple with a flag for last value."""
+    iter_values = iter(values)
+    try:
+        previous_value = next(iter_values)
+    except StopIteration:
+        return
+    for value in iter_values:
+        yield False, previous_value
+        previous_value = value
+    yield True, previous_value''',
+        "python",
+        line_numbers=True,
+    )
+
+    table = Table("foo", "bar", "baz")
+    table.add_row("1", "2", "3")
+
+    progress_renderables = [
+        "Text may be printed while the progress bars are rendering.",
+        Panel("In fact, [i]any[/i] renderable will work"),
+        "Such as [magenta]tables[/]...",
+        table,
+        "Pretty printed structures...",
+        {"type": "example", "text": "Pretty printed"},
+        "Syntax...",
+        syntax,
+        Rule("Give it a try!"),
+    ]
+
+    from itertools import cycle
+
+    examples = cycle(progress_renderables)
+
+    console = Console(record=True)
+
+    with Progress(
+        SpinnerColumn(),
+        *Progress.get_default_columns(),
+        TimeElapsedColumn(),
+        console=console,
+        transient=False,
+    ) as progress:
+        task1 = progress.add_task("[red]Downloading", total=1000)
+        task2 = progress.add_task("[green]Processing", total=1000)
+        task3 = progress.add_task("[yellow]Thinking", total=None)
+
+        while not progress.finished:
+            progress.update(task1, advance=0.5)
+            progress.update(task2, advance=0.3)
+            time.sleep(0.01)
+            if random.randint(0, 100) < 1:
+                progress.log(next(examples))
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/progress_bar.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/progress_bar.py
new file mode 100644
index 0000000..41794f7
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/progress_bar.py
@@ -0,0 +1,223 @@
+import math
+from functools import lru_cache
+from time import monotonic
+from typing import Iterable, List, Optional
+
+from .color import Color, blend_rgb
+from .color_triplet import ColorTriplet
+from .console import Console, ConsoleOptions, RenderResult
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment
+from .style import Style, StyleType
+
+# Number of characters before 'pulse' animation repeats
+PULSE_SIZE = 20
+
+
+class ProgressBar(JupyterMixin):
+    """Renders a (progress) bar. Used by rich.progress.
+
+    Args:
+        total (float, optional): Number of steps in the bar. Defaults to 100. Set to None to render a pulsing animation.
+        completed (float, optional): Number of steps completed. Defaults to 0.
+        width (int, optional): Width of the bar, or ``None`` for maximum width. Defaults to None.
+        pulse (bool, optional): Enable pulse effect. Defaults to False. Will pulse if a None total was passed.
+        style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
+        complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
+        pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
+        animation_time (Optional[float], optional): Time in seconds to use for animation, or None to use system time.
+    """
+
+    def __init__(
+        self,
+        total: Optional[float] = 100.0,
+        completed: float = 0,
+        width: Optional[int] = None,
+        pulse: bool = False,
+        style: StyleType = "bar.back",
+        complete_style: StyleType = "bar.complete",
+        finished_style: StyleType = "bar.finished",
+        pulse_style: StyleType = "bar.pulse",
+        animation_time: Optional[float] = None,
+    ):
+        self.total = total
+        self.completed = completed
+        self.width = width
+        self.pulse = pulse
+        self.style = style
+        self.complete_style = complete_style
+        self.finished_style = finished_style
+        self.pulse_style = pulse_style
+        self.animation_time = animation_time
+
+        self._pulse_segments: Optional[List[Segment]] = None
+
+    def __repr__(self) -> str:
+        return f""
+
+    @property
+    def percentage_completed(self) -> Optional[float]:
+        """Calculate percentage complete."""
+        if self.total is None:
+            return None
+        completed = (self.completed / self.total) * 100.0
+        completed = min(100, max(0.0, completed))
+        return completed
+
+    @lru_cache(maxsize=16)
+    def _get_pulse_segments(
+        self,
+        fore_style: Style,
+        back_style: Style,
+        color_system: str,
+        no_color: bool,
+        ascii: bool = False,
+    ) -> List[Segment]:
+        """Get a list of segments to render a pulse animation.
+
+        Returns:
+            List[Segment]: A list of segments, one segment per character.
+        """
+        bar = "-" if ascii else "━"
+        segments: List[Segment] = []
+        if color_system not in ("standard", "eight_bit", "truecolor") or no_color:
+            segments += [Segment(bar, fore_style)] * (PULSE_SIZE // 2)
+            segments += [Segment(" " if no_color else bar, back_style)] * (
+                PULSE_SIZE - (PULSE_SIZE // 2)
+            )
+            return segments
+
+        append = segments.append
+        fore_color = (
+            fore_style.color.get_truecolor()
+            if fore_style.color
+            else ColorTriplet(255, 0, 255)
+        )
+        back_color = (
+            back_style.color.get_truecolor()
+            if back_style.color
+            else ColorTriplet(0, 0, 0)
+        )
+        cos = math.cos
+        pi = math.pi
+        _Segment = Segment
+        _Style = Style
+        from_triplet = Color.from_triplet
+
+        for index in range(PULSE_SIZE):
+            position = index / PULSE_SIZE
+            fade = 0.5 + cos(position * pi * 2) / 2.0
+            color = blend_rgb(fore_color, back_color, cross_fade=fade)
+            append(_Segment(bar, _Style(color=from_triplet(color))))
+        return segments
+
+    def update(self, completed: float, total: Optional[float] = None) -> None:
+        """Update progress with new values.
+
+        Args:
+            completed (float): Number of steps completed.
+            total (float, optional): Total number of steps, or ``None`` to not change. Defaults to None.
+        """
+        self.completed = completed
+        self.total = total if total is not None else self.total
+
+    def _render_pulse(
+        self, console: Console, width: int, ascii: bool = False
+    ) -> Iterable[Segment]:
+        """Renders the pulse animation.
+
+        Args:
+            console (Console): Console instance.
+            width (int): Width in characters of pulse animation.
+
+        Returns:
+            RenderResult: [description]
+
+        Yields:
+            Iterator[Segment]: Segments to render pulse
+        """
+        fore_style = console.get_style(self.pulse_style, default="white")
+        back_style = console.get_style(self.style, default="black")
+
+        pulse_segments = self._get_pulse_segments(
+            fore_style, back_style, console.color_system, console.no_color, ascii=ascii
+        )
+        segment_count = len(pulse_segments)
+        current_time = (
+            monotonic() if self.animation_time is None else self.animation_time
+        )
+        segments = pulse_segments * (int(width / segment_count) + 2)
+        offset = int(-current_time * 15) % segment_count
+        segments = segments[offset : offset + width]
+        yield from segments
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        width = min(self.width or options.max_width, options.max_width)
+        ascii = options.legacy_windows or options.ascii_only
+        should_pulse = self.pulse or self.total is None
+        if should_pulse:
+            yield from self._render_pulse(console, width, ascii=ascii)
+            return
+
+        completed: Optional[float] = (
+            min(self.total, max(0, self.completed)) if self.total is not None else None
+        )
+
+        bar = "-" if ascii else "━"
+        half_bar_right = " " if ascii else "╸"
+        half_bar_left = " " if ascii else "╺"
+        complete_halves = (
+            int(width * 2 * completed / self.total)
+            if self.total and completed is not None
+            else width * 2
+        )
+        bar_count = complete_halves // 2
+        half_bar_count = complete_halves % 2
+        style = console.get_style(self.style)
+        is_finished = self.total is None or self.completed >= self.total
+        complete_style = console.get_style(
+            self.finished_style if is_finished else self.complete_style
+        )
+        _Segment = Segment
+        if bar_count:
+            yield _Segment(bar * bar_count, complete_style)
+        if half_bar_count:
+            yield _Segment(half_bar_right * half_bar_count, complete_style)
+
+        if not console.no_color:
+            remaining_bars = width - bar_count - half_bar_count
+            if remaining_bars and console.color_system is not None:
+                if not half_bar_count and bar_count:
+                    yield _Segment(half_bar_left, style)
+                    remaining_bars -= 1
+                if remaining_bars:
+                    yield _Segment(bar * remaining_bars, style)
+
+    def __rich_measure__(
+        self, console: Console, options: ConsoleOptions
+    ) -> Measurement:
+        return (
+            Measurement(self.width, self.width)
+            if self.width is not None
+            else Measurement(4, options.max_width)
+        )
+
+
+if __name__ == "__main__":  # pragma: no cover
+    console = Console()
+    bar = ProgressBar(width=50, total=100)
+
+    import time
+
+    console.show_cursor(False)
+    for n in range(0, 101, 1):
+        bar.update(n)
+        console.print(bar)
+        console.file.write("\r")
+        time.sleep(0.05)
+    console.show_cursor(True)
+    console.print()
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/prompt.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/prompt.py
new file mode 100644
index 0000000..fccb70d
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/prompt.py
@@ -0,0 +1,400 @@
+from typing import Any, Generic, List, Optional, TextIO, TypeVar, Union, overload
+
+from . import get_console
+from .console import Console
+from .text import Text, TextType
+
+PromptType = TypeVar("PromptType")
+DefaultType = TypeVar("DefaultType")
+
+
+class PromptError(Exception):
+    """Exception base class for prompt related errors."""
+
+
+class InvalidResponse(PromptError):
+    """Exception to indicate a response was invalid. Raise this within process_response() to indicate an error
+    and provide an error message.
+
+    Args:
+        message (Union[str, Text]): Error message.
+    """
+
+    def __init__(self, message: TextType) -> None:
+        self.message = message
+
+    def __rich__(self) -> TextType:
+        return self.message
+
+
+class PromptBase(Generic[PromptType]):
+    """Ask the user for input until a valid response is received. This is the base class, see one of
+    the concrete classes for examples.
+
+    Args:
+        prompt (TextType, optional): Prompt text. Defaults to "".
+        console (Console, optional): A Console instance or None to use global console. Defaults to None.
+        password (bool, optional): Enable password input. Defaults to False.
+        choices (List[str], optional): A list of valid choices. Defaults to None.
+        case_sensitive (bool, optional): Matching of choices should be case-sensitive. Defaults to True.
+        show_default (bool, optional): Show default in prompt. Defaults to True.
+        show_choices (bool, optional): Show choices in prompt. Defaults to True.
+    """
+
+    response_type: type = str
+
+    validate_error_message = "[prompt.invalid]Please enter a valid value"
+    illegal_choice_message = (
+        "[prompt.invalid.choice]Please select one of the available options"
+    )
+    prompt_suffix = ": "
+
+    choices: Optional[List[str]] = None
+
+    def __init__(
+        self,
+        prompt: TextType = "",
+        *,
+        console: Optional[Console] = None,
+        password: bool = False,
+        choices: Optional[List[str]] = None,
+        case_sensitive: bool = True,
+        show_default: bool = True,
+        show_choices: bool = True,
+    ) -> None:
+        self.console = console or get_console()
+        self.prompt = (
+            Text.from_markup(prompt, style="prompt")
+            if isinstance(prompt, str)
+            else prompt
+        )
+        self.password = password
+        if choices is not None:
+            self.choices = choices
+        self.case_sensitive = case_sensitive
+        self.show_default = show_default
+        self.show_choices = show_choices
+
+    @classmethod
+    @overload
+    def ask(
+        cls,
+        prompt: TextType = "",
+        *,
+        console: Optional[Console] = None,
+        password: bool = False,
+        choices: Optional[List[str]] = None,
+        case_sensitive: bool = True,
+        show_default: bool = True,
+        show_choices: bool = True,
+        default: DefaultType,
+        stream: Optional[TextIO] = None,
+    ) -> Union[DefaultType, PromptType]:
+        ...
+
+    @classmethod
+    @overload
+    def ask(
+        cls,
+        prompt: TextType = "",
+        *,
+        console: Optional[Console] = None,
+        password: bool = False,
+        choices: Optional[List[str]] = None,
+        case_sensitive: bool = True,
+        show_default: bool = True,
+        show_choices: bool = True,
+        stream: Optional[TextIO] = None,
+    ) -> PromptType:
+        ...
+
+    @classmethod
+    def ask(
+        cls,
+        prompt: TextType = "",
+        *,
+        console: Optional[Console] = None,
+        password: bool = False,
+        choices: Optional[List[str]] = None,
+        case_sensitive: bool = True,
+        show_default: bool = True,
+        show_choices: bool = True,
+        default: Any = ...,
+        stream: Optional[TextIO] = None,
+    ) -> Any:
+        """Shortcut to construct and run a prompt loop and return the result.
+
+        Example:
+            >>> filename = Prompt.ask("Enter a filename")
+
+        Args:
+            prompt (TextType, optional): Prompt text. Defaults to "".
+            console (Console, optional): A Console instance or None to use global console. Defaults to None.
+            password (bool, optional): Enable password input. Defaults to False.
+            choices (List[str], optional): A list of valid choices. Defaults to None.
+            case_sensitive (bool, optional): Matching of choices should be case-sensitive. Defaults to True.
+            show_default (bool, optional): Show default in prompt. Defaults to True.
+            show_choices (bool, optional): Show choices in prompt. Defaults to True.
+            stream (TextIO, optional): Optional text file open for reading to get input. Defaults to None.
+        """
+        _prompt = cls(
+            prompt,
+            console=console,
+            password=password,
+            choices=choices,
+            case_sensitive=case_sensitive,
+            show_default=show_default,
+            show_choices=show_choices,
+        )
+        return _prompt(default=default, stream=stream)
+
+    def render_default(self, default: DefaultType) -> Text:
+        """Turn the supplied default in to a Text instance.
+
+        Args:
+            default (DefaultType): Default value.
+
+        Returns:
+            Text: Text containing rendering of default value.
+        """
+        return Text(f"({default})", "prompt.default")
+
+    def make_prompt(self, default: DefaultType) -> Text:
+        """Make prompt text.
+
+        Args:
+            default (DefaultType): Default value.
+
+        Returns:
+            Text: Text to display in prompt.
+        """
+        prompt = self.prompt.copy()
+        prompt.end = ""
+
+        if self.show_choices and self.choices:
+            _choices = "/".join(self.choices)
+            choices = f"[{_choices}]"
+            prompt.append(" ")
+            prompt.append(choices, "prompt.choices")
+
+        if (
+            default != ...
+            and self.show_default
+            and isinstance(default, (str, self.response_type))
+        ):
+            prompt.append(" ")
+            _default = self.render_default(default)
+            prompt.append(_default)
+
+        prompt.append(self.prompt_suffix)
+
+        return prompt
+
+    @classmethod
+    def get_input(
+        cls,
+        console: Console,
+        prompt: TextType,
+        password: bool,
+        stream: Optional[TextIO] = None,
+    ) -> str:
+        """Get input from user.
+
+        Args:
+            console (Console): Console instance.
+            prompt (TextType): Prompt text.
+            password (bool): Enable password entry.
+
+        Returns:
+            str: String from user.
+        """
+        return console.input(prompt, password=password, stream=stream)
+
+    def check_choice(self, value: str) -> bool:
+        """Check value is in the list of valid choices.
+
+        Args:
+            value (str): Value entered by user.
+
+        Returns:
+            bool: True if choice was valid, otherwise False.
+        """
+        assert self.choices is not None
+        if self.case_sensitive:
+            return value.strip() in self.choices
+        return value.strip().lower() in [choice.lower() for choice in self.choices]
+
+    def process_response(self, value: str) -> PromptType:
+        """Process response from user, convert to prompt type.
+
+        Args:
+            value (str): String typed by user.
+
+        Raises:
+            InvalidResponse: If ``value`` is invalid.
+
+        Returns:
+            PromptType: The value to be returned from ask method.
+        """
+        value = value.strip()
+        try:
+            return_value: PromptType = self.response_type(value)
+        except ValueError:
+            raise InvalidResponse(self.validate_error_message)
+
+        if self.choices is not None:
+            if not self.check_choice(value):
+                raise InvalidResponse(self.illegal_choice_message)
+
+            if not self.case_sensitive:
+                # return the original choice, not the lower case version
+                return_value = self.response_type(
+                    self.choices[
+                        [choice.lower() for choice in self.choices].index(value.lower())
+                    ]
+                )
+        return return_value
+
+    def on_validate_error(self, value: str, error: InvalidResponse) -> None:
+        """Called to handle validation error.
+
+        Args:
+            value (str): String entered by user.
+            error (InvalidResponse): Exception instance the initiated the error.
+        """
+        self.console.print(error)
+
+    def pre_prompt(self) -> None:
+        """Hook to display something before the prompt."""
+
+    @overload
+    def __call__(self, *, stream: Optional[TextIO] = None) -> PromptType:
+        ...
+
+    @overload
+    def __call__(
+        self, *, default: DefaultType, stream: Optional[TextIO] = None
+    ) -> Union[PromptType, DefaultType]:
+        ...
+
+    def __call__(self, *, default: Any = ..., stream: Optional[TextIO] = None) -> Any:
+        """Run the prompt loop.
+
+        Args:
+            default (Any, optional): Optional default value.
+
+        Returns:
+            PromptType: Processed value.
+        """
+        while True:
+            self.pre_prompt()
+            prompt = self.make_prompt(default)
+            value = self.get_input(self.console, prompt, self.password, stream=stream)
+            if value == "" and default != ...:
+                return default
+            try:
+                return_value = self.process_response(value)
+            except InvalidResponse as error:
+                self.on_validate_error(value, error)
+                continue
+            else:
+                return return_value
+
+
+class Prompt(PromptBase[str]):
+    """A prompt that returns a str.
+
+    Example:
+        >>> name = Prompt.ask("Enter your name")
+
+
+    """
+
+    response_type = str
+
+
+class IntPrompt(PromptBase[int]):
+    """A prompt that returns an integer.
+
+    Example:
+        >>> burrito_count = IntPrompt.ask("How many burritos do you want to order")
+
+    """
+
+    response_type = int
+    validate_error_message = "[prompt.invalid]Please enter a valid integer number"
+
+
+class FloatPrompt(PromptBase[float]):
+    """A prompt that returns a float.
+
+    Example:
+        >>> temperature = FloatPrompt.ask("Enter desired temperature")
+
+    """
+
+    response_type = float
+    validate_error_message = "[prompt.invalid]Please enter a number"
+
+
+class Confirm(PromptBase[bool]):
+    """A yes / no confirmation prompt.
+
+    Example:
+        >>> if Confirm.ask("Continue"):
+                run_job()
+
+    """
+
+    response_type = bool
+    validate_error_message = "[prompt.invalid]Please enter Y or N"
+    choices: List[str] = ["y", "n"]
+
+    def render_default(self, default: DefaultType) -> Text:
+        """Render the default as (y) or (n) rather than True/False."""
+        yes, no = self.choices
+        return Text(f"({yes})" if default else f"({no})", style="prompt.default")
+
+    def process_response(self, value: str) -> bool:
+        """Convert choices to a bool."""
+        value = value.strip().lower()
+        if value not in self.choices:
+            raise InvalidResponse(self.validate_error_message)
+        return value == self.choices[0]
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich import print
+
+    if Confirm.ask("Run [i]prompt[/i] tests?", default=True):
+        while True:
+            result = IntPrompt.ask(
+                ":rocket: Enter a number between [b]1[/b] and [b]10[/b]", default=5
+            )
+            if result >= 1 and result <= 10:
+                break
+            print(":pile_of_poo: [prompt.invalid]Number must be between 1 and 10")
+        print(f"number={result}")
+
+        while True:
+            password = Prompt.ask(
+                "Please enter a password [cyan](must be at least 5 characters)",
+                password=True,
+            )
+            if len(password) >= 5:
+                break
+            print("[prompt.invalid]password too short")
+        print(f"password={password!r}")
+
+        fruit = Prompt.ask("Enter a fruit", choices=["apple", "orange", "pear"])
+        print(f"fruit={fruit!r}")
+
+        doggie = Prompt.ask(
+            "What's the best Dog? (Case INSENSITIVE)",
+            choices=["Border Terrier", "Collie", "Labradoodle"],
+            case_sensitive=False,
+        )
+        print(f"doggie={doggie!r}")
+
+    else:
+        print("[b]OK :loudly_crying_face:")
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/protocol.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/protocol.py
new file mode 100644
index 0000000..12ab237
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/protocol.py
@@ -0,0 +1,42 @@
+from typing import Any, cast, Set, TYPE_CHECKING
+from inspect import isclass
+
+if TYPE_CHECKING:
+    from pip._vendor.rich.console import RenderableType
+
+_GIBBERISH = """aihwerij235234ljsdnp34ksodfipwoe234234jlskjdf"""
+
+
+def is_renderable(check_object: Any) -> bool:
+    """Check if an object may be rendered by Rich."""
+    return (
+        isinstance(check_object, str)
+        or hasattr(check_object, "__rich__")
+        or hasattr(check_object, "__rich_console__")
+    )
+
+
+def rich_cast(renderable: object) -> "RenderableType":
+    """Cast an object to a renderable by calling __rich__ if present.
+
+    Args:
+        renderable (object): A potentially renderable object
+
+    Returns:
+        object: The result of recursively calling __rich__.
+    """
+    from pip._vendor.rich.console import RenderableType
+
+    rich_visited_set: Set[type] = set()  # Prevent potential infinite loop
+    while hasattr(renderable, "__rich__") and not isclass(renderable):
+        # Detect object which claim to have all the attributes
+        if hasattr(renderable, _GIBBERISH):
+            return repr(renderable)
+        cast_method = getattr(renderable, "__rich__")
+        renderable = cast_method()
+        renderable_type = type(renderable)
+        if renderable_type in rich_visited_set:
+            break
+        rich_visited_set.add(renderable_type)
+
+    return cast(RenderableType, renderable)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/py.typed b/env/lib/python3.12/site-packages/pip/_vendor/rich/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/region.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/region.py
new file mode 100644
index 0000000..75b3631
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/region.py
@@ -0,0 +1,10 @@
+from typing import NamedTuple
+
+
+class Region(NamedTuple):
+    """Defines a rectangular region of the screen."""
+
+    x: int
+    y: int
+    width: int
+    height: int
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/repr.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/repr.py
new file mode 100644
index 0000000..10efc42
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/repr.py
@@ -0,0 +1,149 @@
+import inspect
+from functools import partial
+from typing import (
+    Any,
+    Callable,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    overload,
+)
+
+T = TypeVar("T")
+
+
+Result = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]]
+RichReprResult = Result
+
+
+class ReprError(Exception):
+    """An error occurred when attempting to build a repr."""
+
+
+@overload
+def auto(cls: Optional[Type[T]]) -> Type[T]:
+    ...
+
+
+@overload
+def auto(*, angular: bool = False) -> Callable[[Type[T]], Type[T]]:
+    ...
+
+
+def auto(
+    cls: Optional[Type[T]] = None, *, angular: Optional[bool] = None
+) -> Union[Type[T], Callable[[Type[T]], Type[T]]]:
+    """Class decorator to create __repr__ from __rich_repr__"""
+
+    def do_replace(cls: Type[T], angular: Optional[bool] = None) -> Type[T]:
+        def auto_repr(self: T) -> str:
+            """Create repr string from __rich_repr__"""
+            repr_str: List[str] = []
+            append = repr_str.append
+
+            angular: bool = getattr(self.__rich_repr__, "angular", False)  # type: ignore[attr-defined]
+            for arg in self.__rich_repr__():  # type: ignore[attr-defined]
+                if isinstance(arg, tuple):
+                    if len(arg) == 1:
+                        append(repr(arg[0]))
+                    else:
+                        key, value, *default = arg
+                        if key is None:
+                            append(repr(value))
+                        else:
+                            if default and default[0] == value:
+                                continue
+                            append(f"{key}={value!r}")
+                else:
+                    append(repr(arg))
+            if angular:
+                return f"<{self.__class__.__name__} {' '.join(repr_str)}>"
+            else:
+                return f"{self.__class__.__name__}({', '.join(repr_str)})"
+
+        def auto_rich_repr(self: Type[T]) -> Result:
+            """Auto generate __rich_rep__ from signature of __init__"""
+            try:
+                signature = inspect.signature(self.__init__)
+                for name, param in signature.parameters.items():
+                    if param.kind == param.POSITIONAL_ONLY:
+                        yield getattr(self, name)
+                    elif param.kind in (
+                        param.POSITIONAL_OR_KEYWORD,
+                        param.KEYWORD_ONLY,
+                    ):
+                        if param.default is param.empty:
+                            yield getattr(self, param.name)
+                        else:
+                            yield param.name, getattr(self, param.name), param.default
+            except Exception as error:
+                raise ReprError(
+                    f"Failed to auto generate __rich_repr__; {error}"
+                ) from None
+
+        if not hasattr(cls, "__rich_repr__"):
+            auto_rich_repr.__doc__ = "Build a rich repr"
+            cls.__rich_repr__ = auto_rich_repr  # type: ignore[attr-defined]
+
+        auto_repr.__doc__ = "Return repr(self)"
+        cls.__repr__ = auto_repr  # type: ignore[assignment]
+        if angular is not None:
+            cls.__rich_repr__.angular = angular  # type: ignore[attr-defined]
+        return cls
+
+    if cls is None:
+        return partial(do_replace, angular=angular)
+    else:
+        return do_replace(cls, angular=angular)
+
+
+@overload
+def rich_repr(cls: Optional[Type[T]]) -> Type[T]:
+    ...
+
+
+@overload
+def rich_repr(*, angular: bool = False) -> Callable[[Type[T]], Type[T]]:
+    ...
+
+
+def rich_repr(
+    cls: Optional[Type[T]] = None, *, angular: bool = False
+) -> Union[Type[T], Callable[[Type[T]], Type[T]]]:
+    if cls is None:
+        return auto(angular=angular)
+    else:
+        return auto(cls)
+
+
+if __name__ == "__main__":
+
+    @auto
+    class Foo:
+        def __rich_repr__(self) -> Result:
+            yield "foo"
+            yield "bar", {"shopping": ["eggs", "ham", "pineapple"]}
+            yield "buy", "hand sanitizer"
+
+    foo = Foo()
+    from pip._vendor.rich.console import Console
+
+    console = Console()
+
+    console.rule("Standard repr")
+    console.print(foo)
+
+    console.print(foo, width=60)
+    console.print(foo, width=30)
+
+    console.rule("Angular repr")
+    Foo.__rich_repr__.angular = True  # type: ignore[attr-defined]
+
+    console.print(foo)
+
+    console.print(foo, width=60)
+    console.print(foo, width=30)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/rule.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/rule.py
new file mode 100644
index 0000000..fd00ce6
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/rule.py
@@ -0,0 +1,130 @@
+from typing import Union
+
+from .align import AlignMethod
+from .cells import cell_len, set_cell_size
+from .console import Console, ConsoleOptions, RenderResult
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .style import Style
+from .text import Text
+
+
+class Rule(JupyterMixin):
+    """A console renderable to draw a horizontal rule (line).
+
+    Args:
+        title (Union[str, Text], optional): Text to render in the rule. Defaults to "".
+        characters (str, optional): Character(s) used to draw the line. Defaults to "─".
+        style (StyleType, optional): Style of Rule. Defaults to "rule.line".
+        end (str, optional): Character at end of Rule. defaults to "\\\\n"
+        align (str, optional): How to align the title, one of "left", "center", or "right". Defaults to "center".
+    """
+
+    def __init__(
+        self,
+        title: Union[str, Text] = "",
+        *,
+        characters: str = "─",
+        style: Union[str, Style] = "rule.line",
+        end: str = "\n",
+        align: AlignMethod = "center",
+    ) -> None:
+        if cell_len(characters) < 1:
+            raise ValueError(
+                "'characters' argument must have a cell width of at least 1"
+            )
+        if align not in ("left", "center", "right"):
+            raise ValueError(
+                f'invalid value for align, expected "left", "center", "right" (not {align!r})'
+            )
+        self.title = title
+        self.characters = characters
+        self.style = style
+        self.end = end
+        self.align = align
+
+    def __repr__(self) -> str:
+        return f"Rule({self.title!r}, {self.characters!r})"
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        width = options.max_width
+
+        characters = (
+            "-"
+            if (options.ascii_only and not self.characters.isascii())
+            else self.characters
+        )
+
+        chars_len = cell_len(characters)
+        if not self.title:
+            yield self._rule_line(chars_len, width)
+            return
+
+        if isinstance(self.title, Text):
+            title_text = self.title
+        else:
+            title_text = console.render_str(self.title, style="rule.text")
+
+        title_text.plain = title_text.plain.replace("\n", " ")
+        title_text.expand_tabs()
+
+        required_space = 4 if self.align == "center" else 2
+        truncate_width = max(0, width - required_space)
+        if not truncate_width:
+            yield self._rule_line(chars_len, width)
+            return
+
+        rule_text = Text(end=self.end)
+        if self.align == "center":
+            title_text.truncate(truncate_width, overflow="ellipsis")
+            side_width = (width - cell_len(title_text.plain)) // 2
+            left = Text(characters * (side_width // chars_len + 1))
+            left.truncate(side_width - 1)
+            right_length = width - cell_len(left.plain) - cell_len(title_text.plain)
+            right = Text(characters * (side_width // chars_len + 1))
+            right.truncate(right_length)
+            rule_text.append(left.plain + " ", self.style)
+            rule_text.append(title_text)
+            rule_text.append(" " + right.plain, self.style)
+        elif self.align == "left":
+            title_text.truncate(truncate_width, overflow="ellipsis")
+            rule_text.append(title_text)
+            rule_text.append(" ")
+            rule_text.append(characters * (width - rule_text.cell_len), self.style)
+        elif self.align == "right":
+            title_text.truncate(truncate_width, overflow="ellipsis")
+            rule_text.append(characters * (width - title_text.cell_len - 1), self.style)
+            rule_text.append(" ")
+            rule_text.append(title_text)
+
+        rule_text.plain = set_cell_size(rule_text.plain, width)
+        yield rule_text
+
+    def _rule_line(self, chars_len: int, width: int) -> Text:
+        rule_text = Text(self.characters * ((width // chars_len) + 1), self.style)
+        rule_text.truncate(width)
+        rule_text.plain = set_cell_size(rule_text.plain, width)
+        return rule_text
+
+    def __rich_measure__(
+        self, console: Console, options: ConsoleOptions
+    ) -> Measurement:
+        return Measurement(1, 1)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import sys
+
+    from pip._vendor.rich.console import Console
+
+    try:
+        text = sys.argv[1]
+    except IndexError:
+        text = "Hello, World"
+    console = Console()
+    console.print(Rule(title=text))
+
+    console = Console()
+    console.print(Rule("foo"), width=4)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/scope.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/scope.py
new file mode 100644
index 0000000..c9d134c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/scope.py
@@ -0,0 +1,86 @@
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, Optional, Tuple
+
+from .highlighter import ReprHighlighter
+from .panel import Panel
+from .pretty import Pretty
+from .table import Table
+from .text import Text, TextType
+
+if TYPE_CHECKING:
+    from .console import ConsoleRenderable
+
+
+def render_scope(
+    scope: "Mapping[str, Any]",
+    *,
+    title: Optional[TextType] = None,
+    sort_keys: bool = True,
+    indent_guides: bool = False,
+    max_length: Optional[int] = None,
+    max_string: Optional[int] = None,
+) -> "ConsoleRenderable":
+    """Render python variables in a given scope.
+
+    Args:
+        scope (Mapping): A mapping containing variable names and values.
+        title (str, optional): Optional title. Defaults to None.
+        sort_keys (bool, optional): Enable sorting of items. Defaults to True.
+        indent_guides (bool, optional): Enable indentation guides. Defaults to False.
+        max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to None.
+        max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to None.
+
+    Returns:
+        ConsoleRenderable: A renderable object.
+    """
+    highlighter = ReprHighlighter()
+    items_table = Table.grid(padding=(0, 1), expand=False)
+    items_table.add_column(justify="right")
+
+    def sort_items(item: Tuple[str, Any]) -> Tuple[bool, str]:
+        """Sort special variables first, then alphabetically."""
+        key, _ = item
+        return (not key.startswith("__"), key.lower())
+
+    items = sorted(scope.items(), key=sort_items) if sort_keys else scope.items()
+    for key, value in items:
+        key_text = Text.assemble(
+            (key, "scope.key.special" if key.startswith("__") else "scope.key"),
+            (" =", "scope.equals"),
+        )
+        items_table.add_row(
+            key_text,
+            Pretty(
+                value,
+                highlighter=highlighter,
+                indent_guides=indent_guides,
+                max_length=max_length,
+                max_string=max_string,
+            ),
+        )
+    return Panel.fit(
+        items_table,
+        title=title,
+        border_style="scope.border",
+        padding=(0, 1),
+    )
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich import print
+
+    print()
+
+    def test(foo: float, bar: float) -> None:
+        list_of_things = [1, 2, 3, None, 4, True, False, "Hello World"]
+        dict_of_things = {
+            "version": "1.1",
+            "method": "confirmFruitPurchase",
+            "params": [["apple", "orange", "mangoes", "pomelo"], 1.123],
+            "id": "194521489",
+        }
+        print(render_scope(locals(), title="[i]locals", sort_keys=False))
+
+    test(20.3423, 3.1427)
+    print()
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/screen.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/screen.py
new file mode 100644
index 0000000..7f416e1
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/screen.py
@@ -0,0 +1,54 @@
+from typing import Optional, TYPE_CHECKING
+
+from .segment import Segment
+from .style import StyleType
+from ._loop import loop_last
+
+
+if TYPE_CHECKING:
+    from .console import (
+        Console,
+        ConsoleOptions,
+        RenderResult,
+        RenderableType,
+        Group,
+    )
+
+
+class Screen:
+    """A renderable that fills the terminal screen and crops excess.
+
+    Args:
+        renderable (RenderableType): Child renderable.
+        style (StyleType, optional): Optional background style. Defaults to None.
+    """
+
+    renderable: "RenderableType"
+
+    def __init__(
+        self,
+        *renderables: "RenderableType",
+        style: Optional[StyleType] = None,
+        application_mode: bool = False,
+    ) -> None:
+        from pip._vendor.rich.console import Group
+
+        self.renderable = Group(*renderables)
+        self.style = style
+        self.application_mode = application_mode
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        width, height = options.size
+        style = console.get_style(self.style) if self.style else None
+        render_options = options.update(width=width, height=height)
+        lines = console.render_lines(
+            self.renderable or "", render_options, style=style, pad=True
+        )
+        lines = Segment.set_shape(lines, width, height, style=style)
+        new_line = Segment("\n\r") if self.application_mode else Segment.line()
+        for last, line in loop_last(lines):
+            yield from line
+            if not last:
+                yield new_line
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/segment.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/segment.py
new file mode 100644
index 0000000..4b5f997
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/segment.py
@@ -0,0 +1,752 @@
+from enum import IntEnum
+from functools import lru_cache
+from itertools import filterfalse
+from logging import getLogger
+from operator import attrgetter
+from typing import (
+    TYPE_CHECKING,
+    Dict,
+    Iterable,
+    List,
+    NamedTuple,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+)
+
+from .cells import (
+    _is_single_cell_widths,
+    cached_cell_len,
+    cell_len,
+    get_character_cell_size,
+    set_cell_size,
+)
+from .repr import Result, rich_repr
+from .style import Style
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderResult
+
+log = getLogger("rich")
+
+
+class ControlType(IntEnum):
+    """Non-printable control codes which typically translate to ANSI codes."""
+
+    BELL = 1
+    CARRIAGE_RETURN = 2
+    HOME = 3
+    CLEAR = 4
+    SHOW_CURSOR = 5
+    HIDE_CURSOR = 6
+    ENABLE_ALT_SCREEN = 7
+    DISABLE_ALT_SCREEN = 8
+    CURSOR_UP = 9
+    CURSOR_DOWN = 10
+    CURSOR_FORWARD = 11
+    CURSOR_BACKWARD = 12
+    CURSOR_MOVE_TO_COLUMN = 13
+    CURSOR_MOVE_TO = 14
+    ERASE_IN_LINE = 15
+    SET_WINDOW_TITLE = 16
+
+
+ControlCode = Union[
+    Tuple[ControlType],
+    Tuple[ControlType, Union[int, str]],
+    Tuple[ControlType, int, int],
+]
+
+
+@rich_repr()
+class Segment(NamedTuple):
+    """A piece of text with associated style. Segments are produced by the Console render process and
+    are ultimately converted in to strings to be written to the terminal.
+
+    Args:
+        text (str): A piece of text.
+        style (:class:`~rich.style.Style`, optional): An optional style to apply to the text.
+        control (Tuple[ControlCode], optional): Optional sequence of control codes.
+
+    Attributes:
+        cell_length (int): The cell length of this Segment.
+    """
+
+    text: str
+    style: Optional[Style] = None
+    control: Optional[Sequence[ControlCode]] = None
+
+    @property
+    def cell_length(self) -> int:
+        """The number of terminal cells required to display self.text.
+
+        Returns:
+            int: A number of cells.
+        """
+        text, _style, control = self
+        return 0 if control else cell_len(text)
+
+    def __rich_repr__(self) -> Result:
+        yield self.text
+        if self.control is None:
+            if self.style is not None:
+                yield self.style
+        else:
+            yield self.style
+            yield self.control
+
+    def __bool__(self) -> bool:
+        """Check if the segment contains text."""
+        return bool(self.text)
+
+    @property
+    def is_control(self) -> bool:
+        """Check if the segment contains control codes."""
+        return self.control is not None
+
+    @classmethod
+    @lru_cache(1024 * 16)
+    def _split_cells(cls, segment: "Segment", cut: int) -> Tuple["Segment", "Segment"]:
+        """Split a segment in to two at a given cell position.
+
+        Note that splitting a double-width character, may result in that character turning
+        into two spaces.
+
+        Args:
+            segment (Segment): A segment to split.
+            cut (int): A cell position to cut on.
+
+        Returns:
+            A tuple of two segments.
+        """
+        text, style, control = segment
+        _Segment = Segment
+        cell_length = segment.cell_length
+        if cut >= cell_length:
+            return segment, _Segment("", style, control)
+
+        cell_size = get_character_cell_size
+
+        pos = int((cut / cell_length) * len(text))
+
+        while True:
+            before = text[:pos]
+            cell_pos = cell_len(before)
+            out_by = cell_pos - cut
+            if not out_by:
+                return (
+                    _Segment(before, style, control),
+                    _Segment(text[pos:], style, control),
+                )
+            if out_by == -1 and cell_size(text[pos]) == 2:
+                return (
+                    _Segment(text[:pos] + " ", style, control),
+                    _Segment(" " + text[pos + 1 :], style, control),
+                )
+            if out_by == +1 and cell_size(text[pos - 1]) == 2:
+                return (
+                    _Segment(text[: pos - 1] + " ", style, control),
+                    _Segment(" " + text[pos:], style, control),
+                )
+            if cell_pos < cut:
+                pos += 1
+            else:
+                pos -= 1
+
+    def split_cells(self, cut: int) -> Tuple["Segment", "Segment"]:
+        """Split segment in to two segments at the specified column.
+
+        If the cut point falls in the middle of a 2-cell wide character then it is replaced
+        by two spaces, to preserve the display width of the parent segment.
+
+        Args:
+            cut (int): Offset within the segment to cut.
+
+        Returns:
+            Tuple[Segment, Segment]: Two segments.
+        """
+        text, style, control = self
+        assert cut >= 0
+
+        if _is_single_cell_widths(text):
+            # Fast path with all 1 cell characters
+            if cut >= len(text):
+                return self, Segment("", style, control)
+            return (
+                Segment(text[:cut], style, control),
+                Segment(text[cut:], style, control),
+            )
+
+        return self._split_cells(self, cut)
+
+    @classmethod
+    def line(cls) -> "Segment":
+        """Make a new line segment."""
+        return cls("\n")
+
+    @classmethod
+    def apply_style(
+        cls,
+        segments: Iterable["Segment"],
+        style: Optional[Style] = None,
+        post_style: Optional[Style] = None,
+    ) -> Iterable["Segment"]:
+        """Apply style(s) to an iterable of segments.
+
+        Returns an iterable of segments where the style is replaced by ``style + segment.style + post_style``.
+
+        Args:
+            segments (Iterable[Segment]): Segments to process.
+            style (Style, optional): Base style. Defaults to None.
+            post_style (Style, optional): Style to apply on top of segment style. Defaults to None.
+
+        Returns:
+            Iterable[Segments]: A new iterable of segments (possibly the same iterable).
+        """
+        result_segments = segments
+        if style:
+            apply = style.__add__
+            result_segments = (
+                cls(text, None if control else apply(_style), control)
+                for text, _style, control in result_segments
+            )
+        if post_style:
+            result_segments = (
+                cls(
+                    text,
+                    (
+                        None
+                        if control
+                        else (_style + post_style if _style else post_style)
+                    ),
+                    control,
+                )
+                for text, _style, control in result_segments
+            )
+        return result_segments
+
+    @classmethod
+    def filter_control(
+        cls, segments: Iterable["Segment"], is_control: bool = False
+    ) -> Iterable["Segment"]:
+        """Filter segments by ``is_control`` attribute.
+
+        Args:
+            segments (Iterable[Segment]): An iterable of Segment instances.
+            is_control (bool, optional): is_control flag to match in search.
+
+        Returns:
+            Iterable[Segment]: And iterable of Segment instances.
+
+        """
+        if is_control:
+            return filter(attrgetter("control"), segments)
+        else:
+            return filterfalse(attrgetter("control"), segments)
+
+    @classmethod
+    def split_lines(cls, segments: Iterable["Segment"]) -> Iterable[List["Segment"]]:
+        """Split a sequence of segments in to a list of lines.
+
+        Args:
+            segments (Iterable[Segment]): Segments potentially containing line feeds.
+
+        Yields:
+            Iterable[List[Segment]]: Iterable of segment lists, one per line.
+        """
+        line: List[Segment] = []
+        append = line.append
+
+        for segment in segments:
+            if "\n" in segment.text and not segment.control:
+                text, style, _ = segment
+                while text:
+                    _text, new_line, text = text.partition("\n")
+                    if _text:
+                        append(cls(_text, style))
+                    if new_line:
+                        yield line
+                        line = []
+                        append = line.append
+            else:
+                append(segment)
+        if line:
+            yield line
+
+    @classmethod
+    def split_and_crop_lines(
+        cls,
+        segments: Iterable["Segment"],
+        length: int,
+        style: Optional[Style] = None,
+        pad: bool = True,
+        include_new_lines: bool = True,
+    ) -> Iterable[List["Segment"]]:
+        """Split segments in to lines, and crop lines greater than a given length.
+
+        Args:
+            segments (Iterable[Segment]): An iterable of segments, probably
+                generated from console.render.
+            length (int): Desired line length.
+            style (Style, optional): Style to use for any padding.
+            pad (bool): Enable padding of lines that are less than `length`.
+
+        Returns:
+            Iterable[List[Segment]]: An iterable of lines of segments.
+        """
+        line: List[Segment] = []
+        append = line.append
+
+        adjust_line_length = cls.adjust_line_length
+        new_line_segment = cls("\n")
+
+        for segment in segments:
+            if "\n" in segment.text and not segment.control:
+                text, segment_style, _ = segment
+                while text:
+                    _text, new_line, text = text.partition("\n")
+                    if _text:
+                        append(cls(_text, segment_style))
+                    if new_line:
+                        cropped_line = adjust_line_length(
+                            line, length, style=style, pad=pad
+                        )
+                        if include_new_lines:
+                            cropped_line.append(new_line_segment)
+                        yield cropped_line
+                        line.clear()
+            else:
+                append(segment)
+        if line:
+            yield adjust_line_length(line, length, style=style, pad=pad)
+
+    @classmethod
+    def adjust_line_length(
+        cls,
+        line: List["Segment"],
+        length: int,
+        style: Optional[Style] = None,
+        pad: bool = True,
+    ) -> List["Segment"]:
+        """Adjust a line to a given width (cropping or padding as required).
+
+        Args:
+            segments (Iterable[Segment]): A list of segments in a single line.
+            length (int): The desired width of the line.
+            style (Style, optional): The style of padding if used (space on the end). Defaults to None.
+            pad (bool, optional): Pad lines with spaces if they are shorter than `length`. Defaults to True.
+
+        Returns:
+            List[Segment]: A line of segments with the desired length.
+        """
+        line_length = sum(segment.cell_length for segment in line)
+        new_line: List[Segment]
+
+        if line_length < length:
+            if pad:
+                new_line = line + [cls(" " * (length - line_length), style)]
+            else:
+                new_line = line[:]
+        elif line_length > length:
+            new_line = []
+            append = new_line.append
+            line_length = 0
+            for segment in line:
+                segment_length = segment.cell_length
+                if line_length + segment_length < length or segment.control:
+                    append(segment)
+                    line_length += segment_length
+                else:
+                    text, segment_style, _ = segment
+                    text = set_cell_size(text, length - line_length)
+                    append(cls(text, segment_style))
+                    break
+        else:
+            new_line = line[:]
+        return new_line
+
+    @classmethod
+    def get_line_length(cls, line: List["Segment"]) -> int:
+        """Get the length of list of segments.
+
+        Args:
+            line (List[Segment]): A line encoded as a list of Segments (assumes no '\\\\n' characters),
+
+        Returns:
+            int: The length of the line.
+        """
+        _cell_len = cell_len
+        return sum(_cell_len(text) for text, style, control in line if not control)
+
+    @classmethod
+    def get_shape(cls, lines: List[List["Segment"]]) -> Tuple[int, int]:
+        """Get the shape (enclosing rectangle) of a list of lines.
+
+        Args:
+            lines (List[List[Segment]]): A list of lines (no '\\\\n' characters).
+
+        Returns:
+            Tuple[int, int]: Width and height in characters.
+        """
+        get_line_length = cls.get_line_length
+        max_width = max(get_line_length(line) for line in lines) if lines else 0
+        return (max_width, len(lines))
+
+    @classmethod
+    def set_shape(
+        cls,
+        lines: List[List["Segment"]],
+        width: int,
+        height: Optional[int] = None,
+        style: Optional[Style] = None,
+        new_lines: bool = False,
+    ) -> List[List["Segment"]]:
+        """Set the shape of a list of lines (enclosing rectangle).
+
+        Args:
+            lines (List[List[Segment]]): A list of lines.
+            width (int): Desired width.
+            height (int, optional): Desired height or None for no change.
+            style (Style, optional): Style of any padding added.
+            new_lines (bool, optional): Padded lines should include "\n". Defaults to False.
+
+        Returns:
+            List[List[Segment]]: New list of lines.
+        """
+        _height = height or len(lines)
+
+        blank = (
+            [cls(" " * width + "\n", style)] if new_lines else [cls(" " * width, style)]
+        )
+
+        adjust_line_length = cls.adjust_line_length
+        shaped_lines = lines[:_height]
+        shaped_lines[:] = [
+            adjust_line_length(line, width, style=style) for line in lines
+        ]
+        if len(shaped_lines) < _height:
+            shaped_lines.extend([blank] * (_height - len(shaped_lines)))
+        return shaped_lines
+
+    @classmethod
+    def align_top(
+        cls: Type["Segment"],
+        lines: List[List["Segment"]],
+        width: int,
+        height: int,
+        style: Style,
+        new_lines: bool = False,
+    ) -> List[List["Segment"]]:
+        """Aligns lines to top (adds extra lines to bottom as required).
+
+        Args:
+            lines (List[List[Segment]]): A list of lines.
+            width (int): Desired width.
+            height (int, optional): Desired height or None for no change.
+            style (Style): Style of any padding added.
+            new_lines (bool, optional): Padded lines should include "\n". Defaults to False.
+
+        Returns:
+            List[List[Segment]]: New list of lines.
+        """
+        extra_lines = height - len(lines)
+        if not extra_lines:
+            return lines[:]
+        lines = lines[:height]
+        blank = cls(" " * width + "\n", style) if new_lines else cls(" " * width, style)
+        lines = lines + [[blank]] * extra_lines
+        return lines
+
+    @classmethod
+    def align_bottom(
+        cls: Type["Segment"],
+        lines: List[List["Segment"]],
+        width: int,
+        height: int,
+        style: Style,
+        new_lines: bool = False,
+    ) -> List[List["Segment"]]:
+        """Aligns render to bottom (adds extra lines above as required).
+
+        Args:
+            lines (List[List[Segment]]): A list of lines.
+            width (int): Desired width.
+            height (int, optional): Desired height or None for no change.
+            style (Style): Style of any padding added. Defaults to None.
+            new_lines (bool, optional): Padded lines should include "\n". Defaults to False.
+
+        Returns:
+            List[List[Segment]]: New list of lines.
+        """
+        extra_lines = height - len(lines)
+        if not extra_lines:
+            return lines[:]
+        lines = lines[:height]
+        blank = cls(" " * width + "\n", style) if new_lines else cls(" " * width, style)
+        lines = [[blank]] * extra_lines + lines
+        return lines
+
+    @classmethod
+    def align_middle(
+        cls: Type["Segment"],
+        lines: List[List["Segment"]],
+        width: int,
+        height: int,
+        style: Style,
+        new_lines: bool = False,
+    ) -> List[List["Segment"]]:
+        """Aligns lines to middle (adds extra lines to above and below as required).
+
+        Args:
+            lines (List[List[Segment]]): A list of lines.
+            width (int): Desired width.
+            height (int, optional): Desired height or None for no change.
+            style (Style): Style of any padding added.
+            new_lines (bool, optional): Padded lines should include "\n". Defaults to False.
+
+        Returns:
+            List[List[Segment]]: New list of lines.
+        """
+        extra_lines = height - len(lines)
+        if not extra_lines:
+            return lines[:]
+        lines = lines[:height]
+        blank = cls(" " * width + "\n", style) if new_lines else cls(" " * width, style)
+        top_lines = extra_lines // 2
+        bottom_lines = extra_lines - top_lines
+        lines = [[blank]] * top_lines + lines + [[blank]] * bottom_lines
+        return lines
+
+    @classmethod
+    def simplify(cls, segments: Iterable["Segment"]) -> Iterable["Segment"]:
+        """Simplify an iterable of segments by combining contiguous segments with the same style.
+
+        Args:
+            segments (Iterable[Segment]): An iterable of segments.
+
+        Returns:
+            Iterable[Segment]: A possibly smaller iterable of segments that will render the same way.
+        """
+        iter_segments = iter(segments)
+        try:
+            last_segment = next(iter_segments)
+        except StopIteration:
+            return
+
+        _Segment = Segment
+        for segment in iter_segments:
+            if last_segment.style == segment.style and not segment.control:
+                last_segment = _Segment(
+                    last_segment.text + segment.text, last_segment.style
+                )
+            else:
+                yield last_segment
+                last_segment = segment
+        yield last_segment
+
+    @classmethod
+    def strip_links(cls, segments: Iterable["Segment"]) -> Iterable["Segment"]:
+        """Remove all links from an iterable of styles.
+
+        Args:
+            segments (Iterable[Segment]): An iterable segments.
+
+        Yields:
+            Segment: Segments with link removed.
+        """
+        for segment in segments:
+            if segment.control or segment.style is None:
+                yield segment
+            else:
+                text, style, _control = segment
+                yield cls(text, style.update_link(None) if style else None)
+
+    @classmethod
+    def strip_styles(cls, segments: Iterable["Segment"]) -> Iterable["Segment"]:
+        """Remove all styles from an iterable of segments.
+
+        Args:
+            segments (Iterable[Segment]): An iterable segments.
+
+        Yields:
+            Segment: Segments with styles replace with None
+        """
+        for text, _style, control in segments:
+            yield cls(text, None, control)
+
+    @classmethod
+    def remove_color(cls, segments: Iterable["Segment"]) -> Iterable["Segment"]:
+        """Remove all color from an iterable of segments.
+
+        Args:
+            segments (Iterable[Segment]): An iterable segments.
+
+        Yields:
+            Segment: Segments with colorless style.
+        """
+
+        cache: Dict[Style, Style] = {}
+        for text, style, control in segments:
+            if style:
+                colorless_style = cache.get(style)
+                if colorless_style is None:
+                    colorless_style = style.without_color
+                    cache[style] = colorless_style
+                yield cls(text, colorless_style, control)
+            else:
+                yield cls(text, None, control)
+
+    @classmethod
+    def divide(
+        cls, segments: Iterable["Segment"], cuts: Iterable[int]
+    ) -> Iterable[List["Segment"]]:
+        """Divides an iterable of segments in to portions.
+
+        Args:
+            cuts (Iterable[int]): Cell positions where to divide.
+
+        Yields:
+            [Iterable[List[Segment]]]: An iterable of Segments in List.
+        """
+        split_segments: List["Segment"] = []
+        add_segment = split_segments.append
+
+        iter_cuts = iter(cuts)
+
+        while True:
+            cut = next(iter_cuts, -1)
+            if cut == -1:
+                return
+            if cut != 0:
+                break
+            yield []
+        pos = 0
+
+        segments_clear = split_segments.clear
+        segments_copy = split_segments.copy
+
+        _cell_len = cached_cell_len
+        for segment in segments:
+            text, _style, control = segment
+            while text:
+                end_pos = pos if control else pos + _cell_len(text)
+                if end_pos < cut:
+                    add_segment(segment)
+                    pos = end_pos
+                    break
+
+                if end_pos == cut:
+                    add_segment(segment)
+                    yield segments_copy()
+                    segments_clear()
+                    pos = end_pos
+
+                    cut = next(iter_cuts, -1)
+                    if cut == -1:
+                        if split_segments:
+                            yield segments_copy()
+                        return
+
+                    break
+
+                else:
+                    before, segment = segment.split_cells(cut - pos)
+                    text, _style, control = segment
+                    add_segment(before)
+                    yield segments_copy()
+                    segments_clear()
+                    pos = cut
+
+                cut = next(iter_cuts, -1)
+                if cut == -1:
+                    if split_segments:
+                        yield segments_copy()
+                    return
+
+        yield segments_copy()
+
+
+class Segments:
+    """A simple renderable to render an iterable of segments. This class may be useful if
+    you want to print segments outside of a __rich_console__ method.
+
+    Args:
+        segments (Iterable[Segment]): An iterable of segments.
+        new_lines (bool, optional): Add new lines between segments. Defaults to False.
+    """
+
+    def __init__(self, segments: Iterable[Segment], new_lines: bool = False) -> None:
+        self.segments = list(segments)
+        self.new_lines = new_lines
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        if self.new_lines:
+            line = Segment.line()
+            for segment in self.segments:
+                yield segment
+                yield line
+        else:
+            yield from self.segments
+
+
+class SegmentLines:
+    def __init__(self, lines: Iterable[List[Segment]], new_lines: bool = False) -> None:
+        """A simple renderable containing a number of lines of segments. May be used as an intermediate
+        in rendering process.
+
+        Args:
+            lines (Iterable[List[Segment]]): Lists of segments forming lines.
+            new_lines (bool, optional): Insert new lines after each line. Defaults to False.
+        """
+        self.lines = list(lines)
+        self.new_lines = new_lines
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        if self.new_lines:
+            new_line = Segment.line()
+            for line in self.lines:
+                yield from line
+                yield new_line
+        else:
+            for line in self.lines:
+                yield from line
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Console
+    from pip._vendor.rich.syntax import Syntax
+    from pip._vendor.rich.text import Text
+
+    code = """from rich.console import Console
+console = Console()
+text = Text.from_markup("Hello, [bold magenta]World[/]!")
+console.print(text)"""
+
+    text = Text.from_markup("Hello, [bold magenta]World[/]!")
+
+    console = Console()
+
+    console.rule("rich.Segment")
+    console.print(
+        "A Segment is the last step in the Rich render process before generating text with ANSI codes."
+    )
+    console.print("\nConsider the following code:\n")
+    console.print(Syntax(code, "python", line_numbers=True))
+    console.print()
+    console.print(
+        "When you call [b]print()[/b], Rich [i]renders[/i] the object in to the following:\n"
+    )
+    fragments = list(console.render(text))
+    console.print(fragments)
+    console.print()
+    console.print("The Segments are then processed to produce the following output:\n")
+    console.print(text)
+    console.print(
+        "\nYou will only need to know this if you are implementing your own Rich renderables."
+    )
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/spinner.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/spinner.py
new file mode 100644
index 0000000..70570b6
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/spinner.py
@@ -0,0 +1,138 @@
+from typing import cast, List, Optional, TYPE_CHECKING, Union
+
+from ._spinners import SPINNERS
+from .measure import Measurement
+from .table import Table
+from .text import Text
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderResult, RenderableType
+    from .style import StyleType
+
+
+class Spinner:
+    """A spinner animation.
+
+    Args:
+        name (str): Name of spinner (run python -m rich.spinner).
+        text (RenderableType, optional): A renderable to display at the right of the spinner (str or Text typically). Defaults to "".
+        style (StyleType, optional): Style for spinner animation. Defaults to None.
+        speed (float, optional): Speed factor for animation. Defaults to 1.0.
+
+    Raises:
+        KeyError: If name isn't one of the supported spinner animations.
+    """
+
+    def __init__(
+        self,
+        name: str,
+        text: "RenderableType" = "",
+        *,
+        style: Optional["StyleType"] = None,
+        speed: float = 1.0,
+    ) -> None:
+        try:
+            spinner = SPINNERS[name]
+        except KeyError:
+            raise KeyError(f"no spinner called {name!r}")
+        self.text: "Union[RenderableType, Text]" = (
+            Text.from_markup(text) if isinstance(text, str) else text
+        )
+        self.name = name
+        self.frames = cast(List[str], spinner["frames"])[:]
+        self.interval = cast(float, spinner["interval"])
+        self.start_time: Optional[float] = None
+        self.style = style
+        self.speed = speed
+        self.frame_no_offset: float = 0.0
+        self._update_speed = 0.0
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        yield self.render(console.get_time())
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Measurement:
+        text = self.render(0)
+        return Measurement.get(console, options, text)
+
+    def render(self, time: float) -> "RenderableType":
+        """Render the spinner for a given time.
+
+        Args:
+            time (float): Time in seconds.
+
+        Returns:
+            RenderableType: A renderable containing animation frame.
+        """
+        if self.start_time is None:
+            self.start_time = time
+
+        frame_no = ((time - self.start_time) * self.speed) / (
+            self.interval / 1000.0
+        ) + self.frame_no_offset
+        frame = Text(
+            self.frames[int(frame_no) % len(self.frames)], style=self.style or ""
+        )
+
+        if self._update_speed:
+            self.frame_no_offset = frame_no
+            self.start_time = time
+            self.speed = self._update_speed
+            self._update_speed = 0.0
+
+        if not self.text:
+            return frame
+        elif isinstance(self.text, (str, Text)):
+            return Text.assemble(frame, " ", self.text)
+        else:
+            table = Table.grid(padding=1)
+            table.add_row(frame, self.text)
+            return table
+
+    def update(
+        self,
+        *,
+        text: "RenderableType" = "",
+        style: Optional["StyleType"] = None,
+        speed: Optional[float] = None,
+    ) -> None:
+        """Updates attributes of a spinner after it has been started.
+
+        Args:
+            text (RenderableType, optional): A renderable to display at the right of the spinner (str or Text typically). Defaults to "".
+            style (StyleType, optional): Style for spinner animation. Defaults to None.
+            speed (float, optional): Speed factor for animation. Defaults to None.
+        """
+        if text:
+            self.text = Text.from_markup(text) if isinstance(text, str) else text
+        if style:
+            self.style = style
+        if speed:
+            self._update_speed = speed
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from time import sleep
+
+    from .columns import Columns
+    from .panel import Panel
+    from .live import Live
+
+    all_spinners = Columns(
+        [
+            Spinner(spinner_name, text=Text(repr(spinner_name), style="green"))
+            for spinner_name in sorted(SPINNERS.keys())
+        ],
+        column_first=True,
+        expand=True,
+    )
+
+    with Live(
+        Panel(all_spinners, title="Spinners", border_style="blue"),
+        refresh_per_second=20,
+    ) as live:
+        while True:
+            sleep(0.1)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/status.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/status.py
new file mode 100644
index 0000000..6574483
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/status.py
@@ -0,0 +1,131 @@
+from types import TracebackType
+from typing import Optional, Type
+
+from .console import Console, RenderableType
+from .jupyter import JupyterMixin
+from .live import Live
+from .spinner import Spinner
+from .style import StyleType
+
+
+class Status(JupyterMixin):
+    """Displays a status indicator with a 'spinner' animation.
+
+    Args:
+        status (RenderableType): A status renderable (str or Text typically).
+        console (Console, optional): Console instance to use, or None for global console. Defaults to None.
+        spinner (str, optional): Name of spinner animation (see python -m rich.spinner). Defaults to "dots".
+        spinner_style (StyleType, optional): Style of spinner. Defaults to "status.spinner".
+        speed (float, optional): Speed factor for spinner animation. Defaults to 1.0.
+        refresh_per_second (float, optional): Number of refreshes per second. Defaults to 12.5.
+    """
+
+    def __init__(
+        self,
+        status: RenderableType,
+        *,
+        console: Optional[Console] = None,
+        spinner: str = "dots",
+        spinner_style: StyleType = "status.spinner",
+        speed: float = 1.0,
+        refresh_per_second: float = 12.5,
+    ):
+        self.status = status
+        self.spinner_style = spinner_style
+        self.speed = speed
+        self._spinner = Spinner(spinner, text=status, style=spinner_style, speed=speed)
+        self._live = Live(
+            self.renderable,
+            console=console,
+            refresh_per_second=refresh_per_second,
+            transient=True,
+        )
+
+    @property
+    def renderable(self) -> Spinner:
+        return self._spinner
+
+    @property
+    def console(self) -> "Console":
+        """Get the Console used by the Status objects."""
+        return self._live.console
+
+    def update(
+        self,
+        status: Optional[RenderableType] = None,
+        *,
+        spinner: Optional[str] = None,
+        spinner_style: Optional[StyleType] = None,
+        speed: Optional[float] = None,
+    ) -> None:
+        """Update status.
+
+        Args:
+            status (Optional[RenderableType], optional): New status renderable or None for no change. Defaults to None.
+            spinner (Optional[str], optional): New spinner or None for no change. Defaults to None.
+            spinner_style (Optional[StyleType], optional): New spinner style or None for no change. Defaults to None.
+            speed (Optional[float], optional): Speed factor for spinner animation or None for no change. Defaults to None.
+        """
+        if status is not None:
+            self.status = status
+        if spinner_style is not None:
+            self.spinner_style = spinner_style
+        if speed is not None:
+            self.speed = speed
+        if spinner is not None:
+            self._spinner = Spinner(
+                spinner, text=self.status, style=self.spinner_style, speed=self.speed
+            )
+            self._live.update(self.renderable, refresh=True)
+        else:
+            self._spinner.update(
+                text=self.status, style=self.spinner_style, speed=self.speed
+            )
+
+    def start(self) -> None:
+        """Start the status animation."""
+        self._live.start()
+
+    def stop(self) -> None:
+        """Stop the spinner animation."""
+        self._live.stop()
+
+    def __rich__(self) -> RenderableType:
+        return self.renderable
+
+    def __enter__(self) -> "Status":
+        self.start()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.stop()
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from time import sleep
+
+    from .console import Console
+
+    console = Console()
+    with console.status("[magenta]Covid detector booting up") as status:
+        sleep(3)
+        console.log("Importing advanced AI")
+        sleep(3)
+        console.log("Advanced Covid AI Ready")
+        sleep(3)
+        status.update(status="[bold blue] Scanning for Covid", spinner="earth")
+        sleep(3)
+        console.log("Found 10,000,000,000 copies of Covid32.exe")
+        sleep(3)
+        status.update(
+            status="[bold red]Moving Covid32.exe to Trash",
+            spinner="bouncingBall",
+            spinner_style="yellow",
+        )
+        sleep(5)
+    console.print("[bold green]Covid deleted successfully")
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/style.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/style.py
new file mode 100644
index 0000000..262fd6e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/style.py
@@ -0,0 +1,796 @@
+import sys
+from functools import lru_cache
+from marshal import dumps, loads
+from random import randint
+from typing import Any, Dict, Iterable, List, Optional, Type, Union, cast
+
+from . import errors
+from .color import Color, ColorParseError, ColorSystem, blend_rgb
+from .repr import Result, rich_repr
+from .terminal_theme import DEFAULT_TERMINAL_THEME, TerminalTheme
+
+# Style instances and style definitions are often interchangeable
+StyleType = Union[str, "Style"]
+
+
+class _Bit:
+    """A descriptor to get/set a style attribute bit."""
+
+    __slots__ = ["bit"]
+
+    def __init__(self, bit_no: int) -> None:
+        self.bit = 1 << bit_no
+
+    def __get__(self, obj: "Style", objtype: Type["Style"]) -> Optional[bool]:
+        if obj._set_attributes & self.bit:
+            return obj._attributes & self.bit != 0
+        return None
+
+
+@rich_repr
+class Style:
+    """A terminal style.
+
+    A terminal style consists of a color (`color`), a background color (`bgcolor`), and a number of attributes, such
+    as bold, italic etc. The attributes have 3 states: they can either be on
+    (``True``), off (``False``), or not set (``None``).
+
+    Args:
+        color (Union[Color, str], optional): Color of terminal text. Defaults to None.
+        bgcolor (Union[Color, str], optional): Color of terminal background. Defaults to None.
+        bold (bool, optional): Enable bold text. Defaults to None.
+        dim (bool, optional): Enable dim text. Defaults to None.
+        italic (bool, optional): Enable italic text. Defaults to None.
+        underline (bool, optional): Enable underlined text. Defaults to None.
+        blink (bool, optional): Enabled blinking text. Defaults to None.
+        blink2 (bool, optional): Enable fast blinking text. Defaults to None.
+        reverse (bool, optional): Enabled reverse text. Defaults to None.
+        conceal (bool, optional): Enable concealed text. Defaults to None.
+        strike (bool, optional): Enable strikethrough text. Defaults to None.
+        underline2 (bool, optional): Enable doubly underlined text. Defaults to None.
+        frame (bool, optional): Enable framed text. Defaults to None.
+        encircle (bool, optional): Enable encircled text. Defaults to None.
+        overline (bool, optional): Enable overlined text. Defaults to None.
+        link (str, link): Link URL. Defaults to None.
+
+    """
+
+    _color: Optional[Color]
+    _bgcolor: Optional[Color]
+    _attributes: int
+    _set_attributes: int
+    _hash: Optional[int]
+    _null: bool
+    _meta: Optional[bytes]
+
+    __slots__ = [
+        "_color",
+        "_bgcolor",
+        "_attributes",
+        "_set_attributes",
+        "_link",
+        "_link_id",
+        "_ansi",
+        "_style_definition",
+        "_hash",
+        "_null",
+        "_meta",
+    ]
+
+    # maps bits on to SGR parameter
+    _style_map = {
+        0: "1",
+        1: "2",
+        2: "3",
+        3: "4",
+        4: "5",
+        5: "6",
+        6: "7",
+        7: "8",
+        8: "9",
+        9: "21",
+        10: "51",
+        11: "52",
+        12: "53",
+    }
+
+    STYLE_ATTRIBUTES = {
+        "dim": "dim",
+        "d": "dim",
+        "bold": "bold",
+        "b": "bold",
+        "italic": "italic",
+        "i": "italic",
+        "underline": "underline",
+        "u": "underline",
+        "blink": "blink",
+        "blink2": "blink2",
+        "reverse": "reverse",
+        "r": "reverse",
+        "conceal": "conceal",
+        "c": "conceal",
+        "strike": "strike",
+        "s": "strike",
+        "underline2": "underline2",
+        "uu": "underline2",
+        "frame": "frame",
+        "encircle": "encircle",
+        "overline": "overline",
+        "o": "overline",
+    }
+
+    def __init__(
+        self,
+        *,
+        color: Optional[Union[Color, str]] = None,
+        bgcolor: Optional[Union[Color, str]] = None,
+        bold: Optional[bool] = None,
+        dim: Optional[bool] = None,
+        italic: Optional[bool] = None,
+        underline: Optional[bool] = None,
+        blink: Optional[bool] = None,
+        blink2: Optional[bool] = None,
+        reverse: Optional[bool] = None,
+        conceal: Optional[bool] = None,
+        strike: Optional[bool] = None,
+        underline2: Optional[bool] = None,
+        frame: Optional[bool] = None,
+        encircle: Optional[bool] = None,
+        overline: Optional[bool] = None,
+        link: Optional[str] = None,
+        meta: Optional[Dict[str, Any]] = None,
+    ):
+        self._ansi: Optional[str] = None
+        self._style_definition: Optional[str] = None
+
+        def _make_color(color: Union[Color, str]) -> Color:
+            return color if isinstance(color, Color) else Color.parse(color)
+
+        self._color = None if color is None else _make_color(color)
+        self._bgcolor = None if bgcolor is None else _make_color(bgcolor)
+        self._set_attributes = sum(
+            (
+                bold is not None,
+                dim is not None and 2,
+                italic is not None and 4,
+                underline is not None and 8,
+                blink is not None and 16,
+                blink2 is not None and 32,
+                reverse is not None and 64,
+                conceal is not None and 128,
+                strike is not None and 256,
+                underline2 is not None and 512,
+                frame is not None and 1024,
+                encircle is not None and 2048,
+                overline is not None and 4096,
+            )
+        )
+        self._attributes = (
+            sum(
+                (
+                    bold and 1 or 0,
+                    dim and 2 or 0,
+                    italic and 4 or 0,
+                    underline and 8 or 0,
+                    blink and 16 or 0,
+                    blink2 and 32 or 0,
+                    reverse and 64 or 0,
+                    conceal and 128 or 0,
+                    strike and 256 or 0,
+                    underline2 and 512 or 0,
+                    frame and 1024 or 0,
+                    encircle and 2048 or 0,
+                    overline and 4096 or 0,
+                )
+            )
+            if self._set_attributes
+            else 0
+        )
+
+        self._link = link
+        self._meta = None if meta is None else dumps(meta)
+        self._link_id = (
+            f"{randint(0, 999999)}{hash(self._meta)}" if (link or meta) else ""
+        )
+        self._hash: Optional[int] = None
+        self._null = not (self._set_attributes or color or bgcolor or link or meta)
+
+    @classmethod
+    def null(cls) -> "Style":
+        """Create an 'null' style, equivalent to Style(), but more performant."""
+        return NULL_STYLE
+
+    @classmethod
+    def from_color(
+        cls, color: Optional[Color] = None, bgcolor: Optional[Color] = None
+    ) -> "Style":
+        """Create a new style with colors and no attributes.
+
+        Returns:
+            color (Optional[Color]): A (foreground) color, or None for no color. Defaults to None.
+            bgcolor (Optional[Color]): A (background) color, or None for no color. Defaults to None.
+        """
+        style: Style = cls.__new__(Style)
+        style._ansi = None
+        style._style_definition = None
+        style._color = color
+        style._bgcolor = bgcolor
+        style._set_attributes = 0
+        style._attributes = 0
+        style._link = None
+        style._link_id = ""
+        style._meta = None
+        style._null = not (color or bgcolor)
+        style._hash = None
+        return style
+
+    @classmethod
+    def from_meta(cls, meta: Optional[Dict[str, Any]]) -> "Style":
+        """Create a new style with meta data.
+
+        Returns:
+            meta (Optional[Dict[str, Any]]): A dictionary of meta data. Defaults to None.
+        """
+        style: Style = cls.__new__(Style)
+        style._ansi = None
+        style._style_definition = None
+        style._color = None
+        style._bgcolor = None
+        style._set_attributes = 0
+        style._attributes = 0
+        style._link = None
+        style._meta = dumps(meta)
+        style._link_id = f"{randint(0, 999999)}{hash(style._meta)}"
+        style._hash = None
+        style._null = not (meta)
+        return style
+
+    @classmethod
+    def on(cls, meta: Optional[Dict[str, Any]] = None, **handlers: Any) -> "Style":
+        """Create a blank style with meta information.
+
+        Example:
+            style = Style.on(click=self.on_click)
+
+        Args:
+            meta (Optional[Dict[str, Any]], optional): An optional dict of meta information.
+            **handlers (Any): Keyword arguments are translated in to handlers.
+
+        Returns:
+            Style: A Style with meta information attached.
+        """
+        meta = {} if meta is None else meta
+        meta.update({f"@{key}": value for key, value in handlers.items()})
+        return cls.from_meta(meta)
+
+    bold = _Bit(0)
+    dim = _Bit(1)
+    italic = _Bit(2)
+    underline = _Bit(3)
+    blink = _Bit(4)
+    blink2 = _Bit(5)
+    reverse = _Bit(6)
+    conceal = _Bit(7)
+    strike = _Bit(8)
+    underline2 = _Bit(9)
+    frame = _Bit(10)
+    encircle = _Bit(11)
+    overline = _Bit(12)
+
+    @property
+    def link_id(self) -> str:
+        """Get a link id, used in ansi code for links."""
+        return self._link_id
+
+    def __str__(self) -> str:
+        """Re-generate style definition from attributes."""
+        if self._style_definition is None:
+            attributes: List[str] = []
+            append = attributes.append
+            bits = self._set_attributes
+            if bits & 0b0000000001111:
+                if bits & 1:
+                    append("bold" if self.bold else "not bold")
+                if bits & (1 << 1):
+                    append("dim" if self.dim else "not dim")
+                if bits & (1 << 2):
+                    append("italic" if self.italic else "not italic")
+                if bits & (1 << 3):
+                    append("underline" if self.underline else "not underline")
+            if bits & 0b0000111110000:
+                if bits & (1 << 4):
+                    append("blink" if self.blink else "not blink")
+                if bits & (1 << 5):
+                    append("blink2" if self.blink2 else "not blink2")
+                if bits & (1 << 6):
+                    append("reverse" if self.reverse else "not reverse")
+                if bits & (1 << 7):
+                    append("conceal" if self.conceal else "not conceal")
+                if bits & (1 << 8):
+                    append("strike" if self.strike else "not strike")
+            if bits & 0b1111000000000:
+                if bits & (1 << 9):
+                    append("underline2" if self.underline2 else "not underline2")
+                if bits & (1 << 10):
+                    append("frame" if self.frame else "not frame")
+                if bits & (1 << 11):
+                    append("encircle" if self.encircle else "not encircle")
+                if bits & (1 << 12):
+                    append("overline" if self.overline else "not overline")
+            if self._color is not None:
+                append(self._color.name)
+            if self._bgcolor is not None:
+                append("on")
+                append(self._bgcolor.name)
+            if self._link:
+                append("link")
+                append(self._link)
+            self._style_definition = " ".join(attributes) or "none"
+        return self._style_definition
+
+    def __bool__(self) -> bool:
+        """A Style is false if it has no attributes, colors, or links."""
+        return not self._null
+
+    def _make_ansi_codes(self, color_system: ColorSystem) -> str:
+        """Generate ANSI codes for this style.
+
+        Args:
+            color_system (ColorSystem): Color system.
+
+        Returns:
+            str: String containing codes.
+        """
+
+        if self._ansi is None:
+            sgr: List[str] = []
+            append = sgr.append
+            _style_map = self._style_map
+            attributes = self._attributes & self._set_attributes
+            if attributes:
+                if attributes & 1:
+                    append(_style_map[0])
+                if attributes & 2:
+                    append(_style_map[1])
+                if attributes & 4:
+                    append(_style_map[2])
+                if attributes & 8:
+                    append(_style_map[3])
+                if attributes & 0b0000111110000:
+                    for bit in range(4, 9):
+                        if attributes & (1 << bit):
+                            append(_style_map[bit])
+                if attributes & 0b1111000000000:
+                    for bit in range(9, 13):
+                        if attributes & (1 << bit):
+                            append(_style_map[bit])
+            if self._color is not None:
+                sgr.extend(self._color.downgrade(color_system).get_ansi_codes())
+            if self._bgcolor is not None:
+                sgr.extend(
+                    self._bgcolor.downgrade(color_system).get_ansi_codes(
+                        foreground=False
+                    )
+                )
+            self._ansi = ";".join(sgr)
+        return self._ansi
+
+    @classmethod
+    @lru_cache(maxsize=1024)
+    def normalize(cls, style: str) -> str:
+        """Normalize a style definition so that styles with the same effect have the same string
+        representation.
+
+        Args:
+            style (str): A style definition.
+
+        Returns:
+            str: Normal form of style definition.
+        """
+        try:
+            return str(cls.parse(style))
+        except errors.StyleSyntaxError:
+            return style.strip().lower()
+
+    @classmethod
+    def pick_first(cls, *values: Optional[StyleType]) -> StyleType:
+        """Pick first non-None style."""
+        for value in values:
+            if value is not None:
+                return value
+        raise ValueError("expected at least one non-None style")
+
+    def __rich_repr__(self) -> Result:
+        yield "color", self.color, None
+        yield "bgcolor", self.bgcolor, None
+        yield "bold", self.bold, None,
+        yield "dim", self.dim, None,
+        yield "italic", self.italic, None
+        yield "underline", self.underline, None,
+        yield "blink", self.blink, None
+        yield "blink2", self.blink2, None
+        yield "reverse", self.reverse, None
+        yield "conceal", self.conceal, None
+        yield "strike", self.strike, None
+        yield "underline2", self.underline2, None
+        yield "frame", self.frame, None
+        yield "encircle", self.encircle, None
+        yield "link", self.link, None
+        if self._meta:
+            yield "meta", self.meta
+
+    def __eq__(self, other: Any) -> bool:
+        if not isinstance(other, Style):
+            return NotImplemented
+        return self.__hash__() == other.__hash__()
+
+    def __ne__(self, other: Any) -> bool:
+        if not isinstance(other, Style):
+            return NotImplemented
+        return self.__hash__() != other.__hash__()
+
+    def __hash__(self) -> int:
+        if self._hash is not None:
+            return self._hash
+        self._hash = hash(
+            (
+                self._color,
+                self._bgcolor,
+                self._attributes,
+                self._set_attributes,
+                self._link,
+                self._meta,
+            )
+        )
+        return self._hash
+
+    @property
+    def color(self) -> Optional[Color]:
+        """The foreground color or None if it is not set."""
+        return self._color
+
+    @property
+    def bgcolor(self) -> Optional[Color]:
+        """The background color or None if it is not set."""
+        return self._bgcolor
+
+    @property
+    def link(self) -> Optional[str]:
+        """Link text, if set."""
+        return self._link
+
+    @property
+    def transparent_background(self) -> bool:
+        """Check if the style specified a transparent background."""
+        return self.bgcolor is None or self.bgcolor.is_default
+
+    @property
+    def background_style(self) -> "Style":
+        """A Style with background only."""
+        return Style(bgcolor=self.bgcolor)
+
+    @property
+    def meta(self) -> Dict[str, Any]:
+        """Get meta information (can not be changed after construction)."""
+        return {} if self._meta is None else cast(Dict[str, Any], loads(self._meta))
+
+    @property
+    def without_color(self) -> "Style":
+        """Get a copy of the style with color removed."""
+        if self._null:
+            return NULL_STYLE
+        style: Style = self.__new__(Style)
+        style._ansi = None
+        style._style_definition = None
+        style._color = None
+        style._bgcolor = None
+        style._attributes = self._attributes
+        style._set_attributes = self._set_attributes
+        style._link = self._link
+        style._link_id = f"{randint(0, 999999)}" if self._link else ""
+        style._null = False
+        style._meta = None
+        style._hash = None
+        return style
+
+    @classmethod
+    @lru_cache(maxsize=4096)
+    def parse(cls, style_definition: str) -> "Style":
+        """Parse a style definition.
+
+        Args:
+            style_definition (str): A string containing a style.
+
+        Raises:
+            errors.StyleSyntaxError: If the style definition syntax is invalid.
+
+        Returns:
+            `Style`: A Style instance.
+        """
+        if style_definition.strip() == "none" or not style_definition:
+            return cls.null()
+
+        STYLE_ATTRIBUTES = cls.STYLE_ATTRIBUTES
+        color: Optional[str] = None
+        bgcolor: Optional[str] = None
+        attributes: Dict[str, Optional[Any]] = {}
+        link: Optional[str] = None
+
+        words = iter(style_definition.split())
+        for original_word in words:
+            word = original_word.lower()
+            if word == "on":
+                word = next(words, "")
+                if not word:
+                    raise errors.StyleSyntaxError("color expected after 'on'")
+                try:
+                    Color.parse(word) is None
+                except ColorParseError as error:
+                    raise errors.StyleSyntaxError(
+                        f"unable to parse {word!r} as background color; {error}"
+                    ) from None
+                bgcolor = word
+
+            elif word == "not":
+                word = next(words, "")
+                attribute = STYLE_ATTRIBUTES.get(word)
+                if attribute is None:
+                    raise errors.StyleSyntaxError(
+                        f"expected style attribute after 'not', found {word!r}"
+                    )
+                attributes[attribute] = False
+
+            elif word == "link":
+                word = next(words, "")
+                if not word:
+                    raise errors.StyleSyntaxError("URL expected after 'link'")
+                link = word
+
+            elif word in STYLE_ATTRIBUTES:
+                attributes[STYLE_ATTRIBUTES[word]] = True
+
+            else:
+                try:
+                    Color.parse(word)
+                except ColorParseError as error:
+                    raise errors.StyleSyntaxError(
+                        f"unable to parse {word!r} as color; {error}"
+                    ) from None
+                color = word
+        style = Style(color=color, bgcolor=bgcolor, link=link, **attributes)
+        return style
+
+    @lru_cache(maxsize=1024)
+    def get_html_style(self, theme: Optional[TerminalTheme] = None) -> str:
+        """Get a CSS style rule."""
+        theme = theme or DEFAULT_TERMINAL_THEME
+        css: List[str] = []
+        append = css.append
+
+        color = self.color
+        bgcolor = self.bgcolor
+        if self.reverse:
+            color, bgcolor = bgcolor, color
+        if self.dim:
+            foreground_color = (
+                theme.foreground_color if color is None else color.get_truecolor(theme)
+            )
+            color = Color.from_triplet(
+                blend_rgb(foreground_color, theme.background_color, 0.5)
+            )
+        if color is not None:
+            theme_color = color.get_truecolor(theme)
+            append(f"color: {theme_color.hex}")
+            append(f"text-decoration-color: {theme_color.hex}")
+        if bgcolor is not None:
+            theme_color = bgcolor.get_truecolor(theme, foreground=False)
+            append(f"background-color: {theme_color.hex}")
+        if self.bold:
+            append("font-weight: bold")
+        if self.italic:
+            append("font-style: italic")
+        if self.underline:
+            append("text-decoration: underline")
+        if self.strike:
+            append("text-decoration: line-through")
+        if self.overline:
+            append("text-decoration: overline")
+        return "; ".join(css)
+
+    @classmethod
+    def combine(cls, styles: Iterable["Style"]) -> "Style":
+        """Combine styles and get result.
+
+        Args:
+            styles (Iterable[Style]): Styles to combine.
+
+        Returns:
+            Style: A new style instance.
+        """
+        iter_styles = iter(styles)
+        return sum(iter_styles, next(iter_styles))
+
+    @classmethod
+    def chain(cls, *styles: "Style") -> "Style":
+        """Combine styles from positional argument in to a single style.
+
+        Args:
+            *styles (Iterable[Style]): Styles to combine.
+
+        Returns:
+            Style: A new style instance.
+        """
+        iter_styles = iter(styles)
+        return sum(iter_styles, next(iter_styles))
+
+    def copy(self) -> "Style":
+        """Get a copy of this style.
+
+        Returns:
+            Style: A new Style instance with identical attributes.
+        """
+        if self._null:
+            return NULL_STYLE
+        style: Style = self.__new__(Style)
+        style._ansi = self._ansi
+        style._style_definition = self._style_definition
+        style._color = self._color
+        style._bgcolor = self._bgcolor
+        style._attributes = self._attributes
+        style._set_attributes = self._set_attributes
+        style._link = self._link
+        style._link_id = f"{randint(0, 999999)}" if self._link else ""
+        style._hash = self._hash
+        style._null = False
+        style._meta = self._meta
+        return style
+
+    @lru_cache(maxsize=128)
+    def clear_meta_and_links(self) -> "Style":
+        """Get a copy of this style with link and meta information removed.
+
+        Returns:
+            Style: New style object.
+        """
+        if self._null:
+            return NULL_STYLE
+        style: Style = self.__new__(Style)
+        style._ansi = self._ansi
+        style._style_definition = self._style_definition
+        style._color = self._color
+        style._bgcolor = self._bgcolor
+        style._attributes = self._attributes
+        style._set_attributes = self._set_attributes
+        style._link = None
+        style._link_id = ""
+        style._hash = None
+        style._null = False
+        style._meta = None
+        return style
+
+    def update_link(self, link: Optional[str] = None) -> "Style":
+        """Get a copy with a different value for link.
+
+        Args:
+            link (str, optional): New value for link. Defaults to None.
+
+        Returns:
+            Style: A new Style instance.
+        """
+        style: Style = self.__new__(Style)
+        style._ansi = self._ansi
+        style._style_definition = self._style_definition
+        style._color = self._color
+        style._bgcolor = self._bgcolor
+        style._attributes = self._attributes
+        style._set_attributes = self._set_attributes
+        style._link = link
+        style._link_id = f"{randint(0, 999999)}" if link else ""
+        style._hash = None
+        style._null = False
+        style._meta = self._meta
+        return style
+
+    def render(
+        self,
+        text: str = "",
+        *,
+        color_system: Optional[ColorSystem] = ColorSystem.TRUECOLOR,
+        legacy_windows: bool = False,
+    ) -> str:
+        """Render the ANSI codes for the style.
+
+        Args:
+            text (str, optional): A string to style. Defaults to "".
+            color_system (Optional[ColorSystem], optional): Color system to render to. Defaults to ColorSystem.TRUECOLOR.
+
+        Returns:
+            str: A string containing ANSI style codes.
+        """
+        if not text or color_system is None:
+            return text
+        attrs = self._ansi or self._make_ansi_codes(color_system)
+        rendered = f"\x1b[{attrs}m{text}\x1b[0m" if attrs else text
+        if self._link and not legacy_windows:
+            rendered = (
+                f"\x1b]8;id={self._link_id};{self._link}\x1b\\{rendered}\x1b]8;;\x1b\\"
+            )
+        return rendered
+
+    def test(self, text: Optional[str] = None) -> None:
+        """Write text with style directly to terminal.
+
+        This method is for testing purposes only.
+
+        Args:
+            text (Optional[str], optional): Text to style or None for style name.
+
+        """
+        text = text or str(self)
+        sys.stdout.write(f"{self.render(text)}\n")
+
+    @lru_cache(maxsize=1024)
+    def _add(self, style: Optional["Style"]) -> "Style":
+        if style is None or style._null:
+            return self
+        if self._null:
+            return style
+        new_style: Style = self.__new__(Style)
+        new_style._ansi = None
+        new_style._style_definition = None
+        new_style._color = style._color or self._color
+        new_style._bgcolor = style._bgcolor or self._bgcolor
+        new_style._attributes = (self._attributes & ~style._set_attributes) | (
+            style._attributes & style._set_attributes
+        )
+        new_style._set_attributes = self._set_attributes | style._set_attributes
+        new_style._link = style._link or self._link
+        new_style._link_id = style._link_id or self._link_id
+        new_style._null = style._null
+        if self._meta and style._meta:
+            new_style._meta = dumps({**self.meta, **style.meta})
+        else:
+            new_style._meta = self._meta or style._meta
+        new_style._hash = None
+        return new_style
+
+    def __add__(self, style: Optional["Style"]) -> "Style":
+        combined_style = self._add(style)
+        return combined_style.copy() if combined_style.link else combined_style
+
+
+NULL_STYLE = Style()
+
+
+class StyleStack:
+    """A stack of styles."""
+
+    __slots__ = ["_stack"]
+
+    def __init__(self, default_style: "Style") -> None:
+        self._stack: List[Style] = [default_style]
+
+    def __repr__(self) -> str:
+        return f""
+
+    @property
+    def current(self) -> Style:
+        """Get the Style at the top of the stack."""
+        return self._stack[-1]
+
+    def push(self, style: Style) -> None:
+        """Push a new style on to the stack.
+
+        Args:
+            style (Style): New style to combine with current style.
+        """
+        self._stack.append(self._stack[-1] + style)
+
+    def pop(self) -> Style:
+        """Pop last style and discard.
+
+        Returns:
+            Style: New current style (also available as stack.current)
+        """
+        self._stack.pop()
+        return self._stack[-1]
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/styled.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/styled.py
new file mode 100644
index 0000000..91cd0db
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/styled.py
@@ -0,0 +1,42 @@
+from typing import TYPE_CHECKING
+
+from .measure import Measurement
+from .segment import Segment
+from .style import StyleType
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderResult, RenderableType
+
+
+class Styled:
+    """Apply a style to a renderable.
+
+    Args:
+        renderable (RenderableType): Any renderable.
+        style (StyleType): A style to apply across the entire renderable.
+    """
+
+    def __init__(self, renderable: "RenderableType", style: "StyleType") -> None:
+        self.renderable = renderable
+        self.style = style
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        style = console.get_style(self.style)
+        rendered_segments = console.render(self.renderable, options)
+        segments = Segment.apply_style(rendered_segments, style)
+        return segments
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Measurement:
+        return Measurement.get(console, options, self.renderable)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich import print
+    from pip._vendor.rich.panel import Panel
+
+    panel = Styled(Panel("hello"), "on blue")
+    print(panel)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/syntax.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/syntax.py
new file mode 100644
index 0000000..f3d483c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/syntax.py
@@ -0,0 +1,966 @@
+import os.path
+import re
+import sys
+import textwrap
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import (
+    Any,
+    Dict,
+    Iterable,
+    List,
+    NamedTuple,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    Union,
+)
+
+from pip._vendor.pygments.lexer import Lexer
+from pip._vendor.pygments.lexers import get_lexer_by_name, guess_lexer_for_filename
+from pip._vendor.pygments.style import Style as PygmentsStyle
+from pip._vendor.pygments.styles import get_style_by_name
+from pip._vendor.pygments.token import (
+    Comment,
+    Error,
+    Generic,
+    Keyword,
+    Name,
+    Number,
+    Operator,
+    String,
+    Token,
+    Whitespace,
+)
+from pip._vendor.pygments.util import ClassNotFound
+
+from pip._vendor.rich.containers import Lines
+from pip._vendor.rich.padding import Padding, PaddingDimensions
+
+from ._loop import loop_first
+from .cells import cell_len
+from .color import Color, blend_rgb
+from .console import Console, ConsoleOptions, JustifyMethod, RenderResult
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment, Segments
+from .style import Style, StyleType
+from .text import Text
+
+TokenType = Tuple[str, ...]
+
+WINDOWS = sys.platform == "win32"
+DEFAULT_THEME = "monokai"
+
+# The following styles are based on https://github.com/pygments/pygments/blob/master/pygments/formatters/terminal.py
+# A few modifications were made
+
+ANSI_LIGHT: Dict[TokenType, Style] = {
+    Token: Style(),
+    Whitespace: Style(color="white"),
+    Comment: Style(dim=True),
+    Comment.Preproc: Style(color="cyan"),
+    Keyword: Style(color="blue"),
+    Keyword.Type: Style(color="cyan"),
+    Operator.Word: Style(color="magenta"),
+    Name.Builtin: Style(color="cyan"),
+    Name.Function: Style(color="green"),
+    Name.Namespace: Style(color="cyan", underline=True),
+    Name.Class: Style(color="green", underline=True),
+    Name.Exception: Style(color="cyan"),
+    Name.Decorator: Style(color="magenta", bold=True),
+    Name.Variable: Style(color="red"),
+    Name.Constant: Style(color="red"),
+    Name.Attribute: Style(color="cyan"),
+    Name.Tag: Style(color="bright_blue"),
+    String: Style(color="yellow"),
+    Number: Style(color="blue"),
+    Generic.Deleted: Style(color="bright_red"),
+    Generic.Inserted: Style(color="green"),
+    Generic.Heading: Style(bold=True),
+    Generic.Subheading: Style(color="magenta", bold=True),
+    Generic.Prompt: Style(bold=True),
+    Generic.Error: Style(color="bright_red"),
+    Error: Style(color="red", underline=True),
+}
+
+ANSI_DARK: Dict[TokenType, Style] = {
+    Token: Style(),
+    Whitespace: Style(color="bright_black"),
+    Comment: Style(dim=True),
+    Comment.Preproc: Style(color="bright_cyan"),
+    Keyword: Style(color="bright_blue"),
+    Keyword.Type: Style(color="bright_cyan"),
+    Operator.Word: Style(color="bright_magenta"),
+    Name.Builtin: Style(color="bright_cyan"),
+    Name.Function: Style(color="bright_green"),
+    Name.Namespace: Style(color="bright_cyan", underline=True),
+    Name.Class: Style(color="bright_green", underline=True),
+    Name.Exception: Style(color="bright_cyan"),
+    Name.Decorator: Style(color="bright_magenta", bold=True),
+    Name.Variable: Style(color="bright_red"),
+    Name.Constant: Style(color="bright_red"),
+    Name.Attribute: Style(color="bright_cyan"),
+    Name.Tag: Style(color="bright_blue"),
+    String: Style(color="yellow"),
+    Number: Style(color="bright_blue"),
+    Generic.Deleted: Style(color="bright_red"),
+    Generic.Inserted: Style(color="bright_green"),
+    Generic.Heading: Style(bold=True),
+    Generic.Subheading: Style(color="bright_magenta", bold=True),
+    Generic.Prompt: Style(bold=True),
+    Generic.Error: Style(color="bright_red"),
+    Error: Style(color="red", underline=True),
+}
+
+RICH_SYNTAX_THEMES = {"ansi_light": ANSI_LIGHT, "ansi_dark": ANSI_DARK}
+NUMBERS_COLUMN_DEFAULT_PADDING = 2
+
+
+class SyntaxTheme(ABC):
+    """Base class for a syntax theme."""
+
+    @abstractmethod
+    def get_style_for_token(self, token_type: TokenType) -> Style:
+        """Get a style for a given Pygments token."""
+        raise NotImplementedError  # pragma: no cover
+
+    @abstractmethod
+    def get_background_style(self) -> Style:
+        """Get the background color."""
+        raise NotImplementedError  # pragma: no cover
+
+
+class PygmentsSyntaxTheme(SyntaxTheme):
+    """Syntax theme that delegates to Pygments theme."""
+
+    def __init__(self, theme: Union[str, Type[PygmentsStyle]]) -> None:
+        self._style_cache: Dict[TokenType, Style] = {}
+        if isinstance(theme, str):
+            try:
+                self._pygments_style_class = get_style_by_name(theme)
+            except ClassNotFound:
+                self._pygments_style_class = get_style_by_name("default")
+        else:
+            self._pygments_style_class = theme
+
+        self._background_color = self._pygments_style_class.background_color
+        self._background_style = Style(bgcolor=self._background_color)
+
+    def get_style_for_token(self, token_type: TokenType) -> Style:
+        """Get a style from a Pygments class."""
+        try:
+            return self._style_cache[token_type]
+        except KeyError:
+            try:
+                pygments_style = self._pygments_style_class.style_for_token(token_type)
+            except KeyError:
+                style = Style.null()
+            else:
+                color = pygments_style["color"]
+                bgcolor = pygments_style["bgcolor"]
+                style = Style(
+                    color="#" + color if color else "#000000",
+                    bgcolor="#" + bgcolor if bgcolor else self._background_color,
+                    bold=pygments_style["bold"],
+                    italic=pygments_style["italic"],
+                    underline=pygments_style["underline"],
+                )
+            self._style_cache[token_type] = style
+        return style
+
+    def get_background_style(self) -> Style:
+        return self._background_style
+
+
+class ANSISyntaxTheme(SyntaxTheme):
+    """Syntax theme to use standard colors."""
+
+    def __init__(self, style_map: Dict[TokenType, Style]) -> None:
+        self.style_map = style_map
+        self._missing_style = Style.null()
+        self._background_style = Style.null()
+        self._style_cache: Dict[TokenType, Style] = {}
+
+    def get_style_for_token(self, token_type: TokenType) -> Style:
+        """Look up style in the style map."""
+        try:
+            return self._style_cache[token_type]
+        except KeyError:
+            # Styles form a hierarchy
+            # We need to go from most to least specific
+            # e.g. ("foo", "bar", "baz") to ("foo", "bar")  to ("foo",)
+            get_style = self.style_map.get
+            token = tuple(token_type)
+            style = self._missing_style
+            while token:
+                _style = get_style(token)
+                if _style is not None:
+                    style = _style
+                    break
+                token = token[:-1]
+            self._style_cache[token_type] = style
+            return style
+
+    def get_background_style(self) -> Style:
+        return self._background_style
+
+
+SyntaxPosition = Tuple[int, int]
+
+
+class _SyntaxHighlightRange(NamedTuple):
+    """
+    A range to highlight in a Syntax object.
+    `start` and `end` are 2-integers tuples, where the first integer is the line number
+    (starting from 1) and the second integer is the column index (starting from 0).
+    """
+
+    style: StyleType
+    start: SyntaxPosition
+    end: SyntaxPosition
+    style_before: bool = False
+
+
+class Syntax(JupyterMixin):
+    """Construct a Syntax object to render syntax highlighted code.
+
+    Args:
+        code (str): Code to highlight.
+        lexer (Lexer | str): Lexer to use (see https://pygments.org/docs/lexers/)
+        theme (str, optional): Color theme, aka Pygments style (see https://pygments.org/docs/styles/#getting-a-list-of-available-styles). Defaults to "monokai".
+        dedent (bool, optional): Enable stripping of initial whitespace. Defaults to False.
+        line_numbers (bool, optional): Enable rendering of line numbers. Defaults to False.
+        start_line (int, optional): Starting number for line numbers. Defaults to 1.
+        line_range (Tuple[int | None, int | None], optional): If given should be a tuple of the start and end line to render.
+            A value of None in the tuple indicates the range is open in that direction.
+        highlight_lines (Set[int]): A set of line numbers to highlight.
+        code_width: Width of code to render (not including line numbers), or ``None`` to use all available width.
+        tab_size (int, optional): Size of tabs. Defaults to 4.
+        word_wrap (bool, optional): Enable word wrapping.
+        background_color (str, optional): Optional background color, or None to use theme color. Defaults to None.
+        indent_guides (bool, optional): Show indent guides. Defaults to False.
+        padding (PaddingDimensions): Padding to apply around the syntax. Defaults to 0 (no padding).
+    """
+
+    _pygments_style_class: Type[PygmentsStyle]
+    _theme: SyntaxTheme
+
+    @classmethod
+    def get_theme(cls, name: Union[str, SyntaxTheme]) -> SyntaxTheme:
+        """Get a syntax theme instance."""
+        if isinstance(name, SyntaxTheme):
+            return name
+        theme: SyntaxTheme
+        if name in RICH_SYNTAX_THEMES:
+            theme = ANSISyntaxTheme(RICH_SYNTAX_THEMES[name])
+        else:
+            theme = PygmentsSyntaxTheme(name)
+        return theme
+
+    def __init__(
+        self,
+        code: str,
+        lexer: Union[Lexer, str],
+        *,
+        theme: Union[str, SyntaxTheme] = DEFAULT_THEME,
+        dedent: bool = False,
+        line_numbers: bool = False,
+        start_line: int = 1,
+        line_range: Optional[Tuple[Optional[int], Optional[int]]] = None,
+        highlight_lines: Optional[Set[int]] = None,
+        code_width: Optional[int] = None,
+        tab_size: int = 4,
+        word_wrap: bool = False,
+        background_color: Optional[str] = None,
+        indent_guides: bool = False,
+        padding: PaddingDimensions = 0,
+    ) -> None:
+        self.code = code
+        self._lexer = lexer
+        self.dedent = dedent
+        self.line_numbers = line_numbers
+        self.start_line = start_line
+        self.line_range = line_range
+        self.highlight_lines = highlight_lines or set()
+        self.code_width = code_width
+        self.tab_size = tab_size
+        self.word_wrap = word_wrap
+        self.background_color = background_color
+        self.background_style = (
+            Style(bgcolor=background_color) if background_color else Style()
+        )
+        self.indent_guides = indent_guides
+        self.padding = padding
+
+        self._theme = self.get_theme(theme)
+        self._stylized_ranges: List[_SyntaxHighlightRange] = []
+
+    @classmethod
+    def from_path(
+        cls,
+        path: str,
+        encoding: str = "utf-8",
+        lexer: Optional[Union[Lexer, str]] = None,
+        theme: Union[str, SyntaxTheme] = DEFAULT_THEME,
+        dedent: bool = False,
+        line_numbers: bool = False,
+        line_range: Optional[Tuple[int, int]] = None,
+        start_line: int = 1,
+        highlight_lines: Optional[Set[int]] = None,
+        code_width: Optional[int] = None,
+        tab_size: int = 4,
+        word_wrap: bool = False,
+        background_color: Optional[str] = None,
+        indent_guides: bool = False,
+        padding: PaddingDimensions = 0,
+    ) -> "Syntax":
+        """Construct a Syntax object from a file.
+
+        Args:
+            path (str): Path to file to highlight.
+            encoding (str): Encoding of file.
+            lexer (str | Lexer, optional): Lexer to use. If None, lexer will be auto-detected from path/file content.
+            theme (str, optional): Color theme, aka Pygments style (see https://pygments.org/docs/styles/#getting-a-list-of-available-styles). Defaults to "emacs".
+            dedent (bool, optional): Enable stripping of initial whitespace. Defaults to True.
+            line_numbers (bool, optional): Enable rendering of line numbers. Defaults to False.
+            start_line (int, optional): Starting number for line numbers. Defaults to 1.
+            line_range (Tuple[int, int], optional): If given should be a tuple of the start and end line to render.
+            highlight_lines (Set[int]): A set of line numbers to highlight.
+            code_width: Width of code to render (not including line numbers), or ``None`` to use all available width.
+            tab_size (int, optional): Size of tabs. Defaults to 4.
+            word_wrap (bool, optional): Enable word wrapping of code.
+            background_color (str, optional): Optional background color, or None to use theme color. Defaults to None.
+            indent_guides (bool, optional): Show indent guides. Defaults to False.
+            padding (PaddingDimensions): Padding to apply around the syntax. Defaults to 0 (no padding).
+
+        Returns:
+            [Syntax]: A Syntax object that may be printed to the console
+        """
+        code = Path(path).read_text(encoding=encoding)
+
+        if not lexer:
+            lexer = cls.guess_lexer(path, code=code)
+
+        return cls(
+            code,
+            lexer,
+            theme=theme,
+            dedent=dedent,
+            line_numbers=line_numbers,
+            line_range=line_range,
+            start_line=start_line,
+            highlight_lines=highlight_lines,
+            code_width=code_width,
+            tab_size=tab_size,
+            word_wrap=word_wrap,
+            background_color=background_color,
+            indent_guides=indent_guides,
+            padding=padding,
+        )
+
+    @classmethod
+    def guess_lexer(cls, path: str, code: Optional[str] = None) -> str:
+        """Guess the alias of the Pygments lexer to use based on a path and an optional string of code.
+        If code is supplied, it will use a combination of the code and the filename to determine the
+        best lexer to use. For example, if the file is ``index.html`` and the file contains Django
+        templating syntax, then "html+django" will be returned. If the file is ``index.html``, and no
+        templating language is used, the "html" lexer will be used. If no string of code
+        is supplied, the lexer will be chosen based on the file extension..
+
+        Args:
+             path (AnyStr): The path to the file containing the code you wish to know the lexer for.
+             code (str, optional): Optional string of code that will be used as a fallback if no lexer
+                is found for the supplied path.
+
+        Returns:
+            str: The name of the Pygments lexer that best matches the supplied path/code.
+        """
+        lexer: Optional[Lexer] = None
+        lexer_name = "default"
+        if code:
+            try:
+                lexer = guess_lexer_for_filename(path, code)
+            except ClassNotFound:
+                pass
+
+        if not lexer:
+            try:
+                _, ext = os.path.splitext(path)
+                if ext:
+                    extension = ext.lstrip(".").lower()
+                    lexer = get_lexer_by_name(extension)
+            except ClassNotFound:
+                pass
+
+        if lexer:
+            if lexer.aliases:
+                lexer_name = lexer.aliases[0]
+            else:
+                lexer_name = lexer.name
+
+        return lexer_name
+
+    def _get_base_style(self) -> Style:
+        """Get the base style."""
+        default_style = self._theme.get_background_style() + self.background_style
+        return default_style
+
+    def _get_token_color(self, token_type: TokenType) -> Optional[Color]:
+        """Get a color (if any) for the given token.
+
+        Args:
+            token_type (TokenType): A token type tuple from Pygments.
+
+        Returns:
+            Optional[Color]: Color from theme, or None for no color.
+        """
+        style = self._theme.get_style_for_token(token_type)
+        return style.color
+
+    @property
+    def lexer(self) -> Optional[Lexer]:
+        """The lexer for this syntax, or None if no lexer was found.
+
+        Tries to find the lexer by name if a string was passed to the constructor.
+        """
+
+        if isinstance(self._lexer, Lexer):
+            return self._lexer
+        try:
+            return get_lexer_by_name(
+                self._lexer,
+                stripnl=False,
+                ensurenl=True,
+                tabsize=self.tab_size,
+            )
+        except ClassNotFound:
+            return None
+
+    @property
+    def default_lexer(self) -> Lexer:
+        """A Pygments Lexer to use if one is not specified or invalid."""
+        return get_lexer_by_name(
+            "text",
+            stripnl=False,
+            ensurenl=True,
+            tabsize=self.tab_size,
+        )
+
+    def highlight(
+        self,
+        code: str,
+        line_range: Optional[Tuple[Optional[int], Optional[int]]] = None,
+    ) -> Text:
+        """Highlight code and return a Text instance.
+
+        Args:
+            code (str): Code to highlight.
+            line_range(Tuple[int, int], optional): Optional line range to highlight.
+
+        Returns:
+            Text: A text instance containing highlighted syntax.
+        """
+
+        base_style = self._get_base_style()
+        justify: JustifyMethod = (
+            "default" if base_style.transparent_background else "left"
+        )
+
+        text = Text(
+            justify=justify,
+            style=base_style,
+            tab_size=self.tab_size,
+            no_wrap=not self.word_wrap,
+        )
+        _get_theme_style = self._theme.get_style_for_token
+
+        lexer = self.lexer or self.default_lexer
+
+        if lexer is None:
+            text.append(code)
+        else:
+            if line_range:
+                # More complicated path to only stylize a portion of the code
+                # This speeds up further operations as there are less spans to process
+                line_start, line_end = line_range
+
+                def line_tokenize() -> Iterable[Tuple[Any, str]]:
+                    """Split tokens to one per line."""
+                    assert lexer  # required to make MyPy happy - we know lexer is not None at this point
+
+                    for token_type, token in lexer.get_tokens(code):
+                        while token:
+                            line_token, new_line, token = token.partition("\n")
+                            yield token_type, line_token + new_line
+
+                def tokens_to_spans() -> Iterable[Tuple[str, Optional[Style]]]:
+                    """Convert tokens to spans."""
+                    tokens = iter(line_tokenize())
+                    line_no = 0
+                    _line_start = line_start - 1 if line_start else 0
+
+                    # Skip over tokens until line start
+                    while line_no < _line_start:
+                        try:
+                            _token_type, token = next(tokens)
+                        except StopIteration:
+                            break
+                        yield (token, None)
+                        if token.endswith("\n"):
+                            line_no += 1
+                    # Generate spans until line end
+                    for token_type, token in tokens:
+                        yield (token, _get_theme_style(token_type))
+                        if token.endswith("\n"):
+                            line_no += 1
+                            if line_end and line_no >= line_end:
+                                break
+
+                text.append_tokens(tokens_to_spans())
+
+            else:
+                text.append_tokens(
+                    (token, _get_theme_style(token_type))
+                    for token_type, token in lexer.get_tokens(code)
+                )
+            if self.background_color is not None:
+                text.stylize(f"on {self.background_color}")
+
+        if self._stylized_ranges:
+            self._apply_stylized_ranges(text)
+
+        return text
+
+    def stylize_range(
+        self,
+        style: StyleType,
+        start: SyntaxPosition,
+        end: SyntaxPosition,
+        style_before: bool = False,
+    ) -> None:
+        """
+        Adds a custom style on a part of the code, that will be applied to the syntax display when it's rendered.
+        Line numbers are 1-based, while column indexes are 0-based.
+
+        Args:
+            style (StyleType): The style to apply.
+            start (Tuple[int, int]): The start of the range, in the form `[line number, column index]`.
+            end (Tuple[int, int]): The end of the range, in the form `[line number, column index]`.
+            style_before (bool): Apply the style before any existing styles.
+        """
+        self._stylized_ranges.append(
+            _SyntaxHighlightRange(style, start, end, style_before)
+        )
+
+    def _get_line_numbers_color(self, blend: float = 0.3) -> Color:
+        background_style = self._theme.get_background_style() + self.background_style
+        background_color = background_style.bgcolor
+        if background_color is None or background_color.is_system_defined:
+            return Color.default()
+        foreground_color = self._get_token_color(Token.Text)
+        if foreground_color is None or foreground_color.is_system_defined:
+            return foreground_color or Color.default()
+        new_color = blend_rgb(
+            background_color.get_truecolor(),
+            foreground_color.get_truecolor(),
+            cross_fade=blend,
+        )
+        return Color.from_triplet(new_color)
+
+    @property
+    def _numbers_column_width(self) -> int:
+        """Get the number of characters used to render the numbers column."""
+        column_width = 0
+        if self.line_numbers:
+            column_width = (
+                len(str(self.start_line + self.code.count("\n")))
+                + NUMBERS_COLUMN_DEFAULT_PADDING
+            )
+        return column_width
+
+    def _get_number_styles(self, console: Console) -> Tuple[Style, Style, Style]:
+        """Get background, number, and highlight styles for line numbers."""
+        background_style = self._get_base_style()
+        if background_style.transparent_background:
+            return Style.null(), Style(dim=True), Style.null()
+        if console.color_system in ("256", "truecolor"):
+            number_style = Style.chain(
+                background_style,
+                self._theme.get_style_for_token(Token.Text),
+                Style(color=self._get_line_numbers_color()),
+                self.background_style,
+            )
+            highlight_number_style = Style.chain(
+                background_style,
+                self._theme.get_style_for_token(Token.Text),
+                Style(bold=True, color=self._get_line_numbers_color(0.9)),
+                self.background_style,
+            )
+        else:
+            number_style = background_style + Style(dim=True)
+            highlight_number_style = background_style + Style(dim=False)
+        return background_style, number_style, highlight_number_style
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        _, right, _, left = Padding.unpack(self.padding)
+        padding = left + right
+        if self.code_width is not None:
+            width = self.code_width + self._numbers_column_width + padding + 1
+            return Measurement(self._numbers_column_width, width)
+        lines = self.code.splitlines()
+        width = (
+            self._numbers_column_width
+            + padding
+            + (max(cell_len(line) for line in lines) if lines else 0)
+        )
+        if self.line_numbers:
+            width += 1
+        return Measurement(self._numbers_column_width, width)
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        segments = Segments(self._get_syntax(console, options))
+        if self.padding:
+            yield Padding(segments, style=self._get_base_style(), pad=self.padding)
+        else:
+            yield segments
+
+    def _get_syntax(
+        self,
+        console: Console,
+        options: ConsoleOptions,
+    ) -> Iterable[Segment]:
+        """
+        Get the Segments for the Syntax object, excluding any vertical/horizontal padding
+        """
+        transparent_background = self._get_base_style().transparent_background
+        code_width = (
+            (
+                (options.max_width - self._numbers_column_width - 1)
+                if self.line_numbers
+                else options.max_width
+            )
+            if self.code_width is None
+            else self.code_width
+        )
+
+        ends_on_nl, processed_code = self._process_code(self.code)
+        text = self.highlight(processed_code, self.line_range)
+
+        if not self.line_numbers and not self.word_wrap and not self.line_range:
+            if not ends_on_nl:
+                text.remove_suffix("\n")
+            # Simple case of just rendering text
+            style = (
+                self._get_base_style()
+                + self._theme.get_style_for_token(Comment)
+                + Style(dim=True)
+                + self.background_style
+            )
+            if self.indent_guides and not options.ascii_only:
+                text = text.with_indent_guides(self.tab_size, style=style)
+                text.overflow = "crop"
+            if style.transparent_background:
+                yield from console.render(
+                    text, options=options.update(width=code_width)
+                )
+            else:
+                syntax_lines = console.render_lines(
+                    text,
+                    options.update(width=code_width, height=None, justify="left"),
+                    style=self.background_style,
+                    pad=True,
+                    new_lines=True,
+                )
+                for syntax_line in syntax_lines:
+                    yield from syntax_line
+            return
+
+        start_line, end_line = self.line_range or (None, None)
+        line_offset = 0
+        if start_line:
+            line_offset = max(0, start_line - 1)
+        lines: Union[List[Text], Lines] = text.split("\n", allow_blank=ends_on_nl)
+        if self.line_range:
+            if line_offset > len(lines):
+                return
+            lines = lines[line_offset:end_line]
+
+        if self.indent_guides and not options.ascii_only:
+            style = (
+                self._get_base_style()
+                + self._theme.get_style_for_token(Comment)
+                + Style(dim=True)
+                + self.background_style
+            )
+            lines = (
+                Text("\n")
+                .join(lines)
+                .with_indent_guides(self.tab_size, style=style + Style(italic=False))
+                .split("\n", allow_blank=True)
+            )
+
+        numbers_column_width = self._numbers_column_width
+        render_options = options.update(width=code_width)
+
+        highlight_line = self.highlight_lines.__contains__
+        _Segment = Segment
+        new_line = _Segment("\n")
+
+        line_pointer = "> " if options.legacy_windows else "❱ "
+
+        (
+            background_style,
+            number_style,
+            highlight_number_style,
+        ) = self._get_number_styles(console)
+
+        for line_no, line in enumerate(lines, self.start_line + line_offset):
+            if self.word_wrap:
+                wrapped_lines = console.render_lines(
+                    line,
+                    render_options.update(height=None, justify="left"),
+                    style=background_style,
+                    pad=not transparent_background,
+                )
+            else:
+                segments = list(line.render(console, end=""))
+                if options.no_wrap:
+                    wrapped_lines = [segments]
+                else:
+                    wrapped_lines = [
+                        _Segment.adjust_line_length(
+                            segments,
+                            render_options.max_width,
+                            style=background_style,
+                            pad=not transparent_background,
+                        )
+                    ]
+
+            if self.line_numbers:
+                wrapped_line_left_pad = _Segment(
+                    " " * numbers_column_width + " ", background_style
+                )
+                for first, wrapped_line in loop_first(wrapped_lines):
+                    if first:
+                        line_column = str(line_no).rjust(numbers_column_width - 2) + " "
+                        if highlight_line(line_no):
+                            yield _Segment(line_pointer, Style(color="red"))
+                            yield _Segment(line_column, highlight_number_style)
+                        else:
+                            yield _Segment("  ", highlight_number_style)
+                            yield _Segment(line_column, number_style)
+                    else:
+                        yield wrapped_line_left_pad
+                    yield from wrapped_line
+                    yield new_line
+            else:
+                for wrapped_line in wrapped_lines:
+                    yield from wrapped_line
+                    yield new_line
+
+    def _apply_stylized_ranges(self, text: Text) -> None:
+        """
+        Apply stylized ranges to a text instance,
+        using the given code to determine the right portion to apply the style to.
+
+        Args:
+            text (Text): Text instance to apply the style to.
+        """
+        code = text.plain
+        newlines_offsets = [
+            # Let's add outer boundaries at each side of the list:
+            0,
+            # N.B. using "\n" here is much faster than using metacharacters such as "^" or "\Z":
+            *[
+                match.start() + 1
+                for match in re.finditer("\n", code, flags=re.MULTILINE)
+            ],
+            len(code) + 1,
+        ]
+
+        for stylized_range in self._stylized_ranges:
+            start = _get_code_index_for_syntax_position(
+                newlines_offsets, stylized_range.start
+            )
+            end = _get_code_index_for_syntax_position(
+                newlines_offsets, stylized_range.end
+            )
+            if start is not None and end is not None:
+                if stylized_range.style_before:
+                    text.stylize_before(stylized_range.style, start, end)
+                else:
+                    text.stylize(stylized_range.style, start, end)
+
+    def _process_code(self, code: str) -> Tuple[bool, str]:
+        """
+        Applies various processing to a raw code string
+        (normalises it so it always ends with a line return, dedents it if necessary, etc.)
+
+        Args:
+            code (str): The raw code string to process
+
+        Returns:
+            Tuple[bool, str]: the boolean indicates whether the raw code ends with a line return,
+                while the string is the processed code.
+        """
+        ends_on_nl = code.endswith("\n")
+        processed_code = code if ends_on_nl else code + "\n"
+        processed_code = (
+            textwrap.dedent(processed_code) if self.dedent else processed_code
+        )
+        processed_code = processed_code.expandtabs(self.tab_size)
+        return ends_on_nl, processed_code
+
+
+def _get_code_index_for_syntax_position(
+    newlines_offsets: Sequence[int], position: SyntaxPosition
+) -> Optional[int]:
+    """
+    Returns the index of the code string for the given positions.
+
+    Args:
+        newlines_offsets (Sequence[int]): The offset of each newline character found in the code snippet.
+        position (SyntaxPosition): The position to search for.
+
+    Returns:
+        Optional[int]: The index of the code string for this position, or `None`
+            if the given position's line number is out of range (if it's the column that is out of range
+            we silently clamp its value so that it reaches the end of the line)
+    """
+    lines_count = len(newlines_offsets)
+
+    line_number, column_index = position
+    if line_number > lines_count or len(newlines_offsets) < (line_number + 1):
+        return None  # `line_number` is out of range
+    line_index = line_number - 1
+    line_length = newlines_offsets[line_index + 1] - newlines_offsets[line_index] - 1
+    # If `column_index` is out of range: let's silently clamp it:
+    column_index = min(line_length, column_index)
+    return newlines_offsets[line_index] + column_index
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import argparse
+    import sys
+
+    parser = argparse.ArgumentParser(
+        description="Render syntax to the console with Rich"
+    )
+    parser.add_argument(
+        "path",
+        metavar="PATH",
+        help="path to file, or - for stdin",
+    )
+    parser.add_argument(
+        "-c",
+        "--force-color",
+        dest="force_color",
+        action="store_true",
+        default=None,
+        help="force color for non-terminals",
+    )
+    parser.add_argument(
+        "-i",
+        "--indent-guides",
+        dest="indent_guides",
+        action="store_true",
+        default=False,
+        help="display indent guides",
+    )
+    parser.add_argument(
+        "-l",
+        "--line-numbers",
+        dest="line_numbers",
+        action="store_true",
+        help="render line numbers",
+    )
+    parser.add_argument(
+        "-w",
+        "--width",
+        type=int,
+        dest="width",
+        default=None,
+        help="width of output (default will auto-detect)",
+    )
+    parser.add_argument(
+        "-r",
+        "--wrap",
+        dest="word_wrap",
+        action="store_true",
+        default=False,
+        help="word wrap long lines",
+    )
+    parser.add_argument(
+        "-s",
+        "--soft-wrap",
+        action="store_true",
+        dest="soft_wrap",
+        default=False,
+        help="enable soft wrapping mode",
+    )
+    parser.add_argument(
+        "-t", "--theme", dest="theme", default="monokai", help="pygments theme"
+    )
+    parser.add_argument(
+        "-b",
+        "--background-color",
+        dest="background_color",
+        default=None,
+        help="Override background color",
+    )
+    parser.add_argument(
+        "-x",
+        "--lexer",
+        default=None,
+        dest="lexer_name",
+        help="Lexer name",
+    )
+    parser.add_argument(
+        "-p", "--padding", type=int, default=0, dest="padding", help="Padding"
+    )
+    parser.add_argument(
+        "--highlight-line",
+        type=int,
+        default=None,
+        dest="highlight_line",
+        help="The line number (not index!) to highlight",
+    )
+    args = parser.parse_args()
+
+    from pip._vendor.rich.console import Console
+
+    console = Console(force_terminal=args.force_color, width=args.width)
+
+    if args.path == "-":
+        code = sys.stdin.read()
+        syntax = Syntax(
+            code=code,
+            lexer=args.lexer_name,
+            line_numbers=args.line_numbers,
+            word_wrap=args.word_wrap,
+            theme=args.theme,
+            background_color=args.background_color,
+            indent_guides=args.indent_guides,
+            padding=args.padding,
+            highlight_lines={args.highlight_line},
+        )
+    else:
+        syntax = Syntax.from_path(
+            args.path,
+            lexer=args.lexer_name,
+            line_numbers=args.line_numbers,
+            word_wrap=args.word_wrap,
+            theme=args.theme,
+            background_color=args.background_color,
+            indent_guides=args.indent_guides,
+            padding=args.padding,
+            highlight_lines={args.highlight_line},
+        )
+    console.print(syntax, soft_wrap=args.soft_wrap)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/table.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/table.py
new file mode 100644
index 0000000..654c855
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/table.py
@@ -0,0 +1,1007 @@
+from dataclasses import dataclass, field, replace
+from typing import (
+    TYPE_CHECKING,
+    Dict,
+    Iterable,
+    List,
+    NamedTuple,
+    Optional,
+    Sequence,
+    Tuple,
+    Union,
+)
+
+from . import box, errors
+from ._loop import loop_first_last, loop_last
+from ._pick import pick_bool
+from ._ratio import ratio_distribute, ratio_reduce
+from .align import VerticalAlignMethod
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .padding import Padding, PaddingDimensions
+from .protocol import is_renderable
+from .segment import Segment
+from .style import Style, StyleType
+from .text import Text, TextType
+
+if TYPE_CHECKING:
+    from .console import (
+        Console,
+        ConsoleOptions,
+        JustifyMethod,
+        OverflowMethod,
+        RenderableType,
+        RenderResult,
+    )
+
+
+@dataclass
+class Column:
+    """Defines a column within a ~Table.
+
+    Args:
+        title (Union[str, Text], optional): The title of the table rendered at the top. Defaults to None.
+        caption (Union[str, Text], optional): The table caption rendered below. Defaults to None.
+        width (int, optional): The width in characters of the table, or ``None`` to automatically fit. Defaults to None.
+        min_width (Optional[int], optional): The minimum width of the table, or ``None`` for no minimum. Defaults to None.
+        box (box.Box, optional): One of the constants in box.py used to draw the edges (see :ref:`appendix_box`), or ``None`` for no box lines. Defaults to box.HEAVY_HEAD.
+        safe_box (Optional[bool], optional): Disable box characters that don't display on windows legacy terminal with *raster* fonts. Defaults to True.
+        padding (PaddingDimensions, optional): Padding for cells (top, right, bottom, left). Defaults to (0, 1).
+        collapse_padding (bool, optional): Enable collapsing of padding around cells. Defaults to False.
+        pad_edge (bool, optional): Enable padding of edge cells. Defaults to True.
+        expand (bool, optional): Expand the table to fit the available space if ``True``, otherwise the table width will be auto-calculated. Defaults to False.
+        show_header (bool, optional): Show a header row. Defaults to True.
+        show_footer (bool, optional): Show a footer row. Defaults to False.
+        show_edge (bool, optional): Draw a box around the outside of the table. Defaults to True.
+        show_lines (bool, optional): Draw lines between every row. Defaults to False.
+        leading (int, optional): Number of blank lines between rows (precludes ``show_lines``). Defaults to 0.
+        style (Union[str, Style], optional): Default style for the table. Defaults to "none".
+        row_styles (List[Union, str], optional): Optional list of row styles, if more than one style is given then the styles will alternate. Defaults to None.
+        header_style (Union[str, Style], optional): Style of the header. Defaults to "table.header".
+        footer_style (Union[str, Style], optional): Style of the footer. Defaults to "table.footer".
+        border_style (Union[str, Style], optional): Style of the border. Defaults to None.
+        title_style (Union[str, Style], optional): Style of the title. Defaults to None.
+        caption_style (Union[str, Style], optional): Style of the caption. Defaults to None.
+        title_justify (str, optional): Justify method for title. Defaults to "center".
+        caption_justify (str, optional): Justify method for caption. Defaults to "center".
+        highlight (bool, optional): Highlight cell contents (if str). Defaults to False.
+    """
+
+    header: "RenderableType" = ""
+    """RenderableType: Renderable for the header (typically a string)"""
+
+    footer: "RenderableType" = ""
+    """RenderableType: Renderable for the footer (typically a string)"""
+
+    header_style: StyleType = ""
+    """StyleType: The style of the header."""
+
+    footer_style: StyleType = ""
+    """StyleType: The style of the footer."""
+
+    style: StyleType = ""
+    """StyleType: The style of the column."""
+
+    justify: "JustifyMethod" = "left"
+    """str: How to justify text within the column ("left", "center", "right", or "full")"""
+
+    vertical: "VerticalAlignMethod" = "top"
+    """str: How to vertically align content ("top", "middle", or "bottom")"""
+
+    overflow: "OverflowMethod" = "ellipsis"
+    """str: Overflow method."""
+
+    width: Optional[int] = None
+    """Optional[int]: Width of the column, or ``None`` (default) to auto calculate width."""
+
+    min_width: Optional[int] = None
+    """Optional[int]: Minimum width of column, or ``None`` for no minimum. Defaults to None."""
+
+    max_width: Optional[int] = None
+    """Optional[int]: Maximum width of column, or ``None`` for no maximum. Defaults to None."""
+
+    ratio: Optional[int] = None
+    """Optional[int]: Ratio to use when calculating column width, or ``None`` (default) to adapt to column contents."""
+
+    no_wrap: bool = False
+    """bool: Prevent wrapping of text within the column. Defaults to ``False``."""
+
+    highlight: bool = False
+    """bool: Apply highlighter to column. Defaults to ``False``."""
+
+    _index: int = 0
+    """Index of column."""
+
+    _cells: List["RenderableType"] = field(default_factory=list)
+
+    def copy(self) -> "Column":
+        """Return a copy of this Column."""
+        return replace(self, _cells=[])
+
+    @property
+    def cells(self) -> Iterable["RenderableType"]:
+        """Get all cells in the column, not including header."""
+        yield from self._cells
+
+    @property
+    def flexible(self) -> bool:
+        """Check if this column is flexible."""
+        return self.ratio is not None
+
+
+@dataclass
+class Row:
+    """Information regarding a row."""
+
+    style: Optional[StyleType] = None
+    """Style to apply to row."""
+
+    end_section: bool = False
+    """Indicated end of section, which will force a line beneath the row."""
+
+
+class _Cell(NamedTuple):
+    """A single cell in a table."""
+
+    style: StyleType
+    """Style to apply to cell."""
+    renderable: "RenderableType"
+    """Cell renderable."""
+    vertical: VerticalAlignMethod
+    """Cell vertical alignment."""
+
+
+class Table(JupyterMixin):
+    """A console renderable to draw a table.
+
+    Args:
+        *headers (Union[Column, str]): Column headers, either as a string, or :class:`~rich.table.Column` instance.
+        title (Union[str, Text], optional): The title of the table rendered at the top. Defaults to None.
+        caption (Union[str, Text], optional): The table caption rendered below. Defaults to None.
+        width (int, optional): The width in characters of the table, or ``None`` to automatically fit. Defaults to None.
+        min_width (Optional[int], optional): The minimum width of the table, or ``None`` for no minimum. Defaults to None.
+        box (box.Box, optional): One of the constants in box.py used to draw the edges (see :ref:`appendix_box`), or ``None`` for no box lines. Defaults to box.HEAVY_HEAD.
+        safe_box (Optional[bool], optional): Disable box characters that don't display on windows legacy terminal with *raster* fonts. Defaults to True.
+        padding (PaddingDimensions, optional): Padding for cells (top, right, bottom, left). Defaults to (0, 1).
+        collapse_padding (bool, optional): Enable collapsing of padding around cells. Defaults to False.
+        pad_edge (bool, optional): Enable padding of edge cells. Defaults to True.
+        expand (bool, optional): Expand the table to fit the available space if ``True``, otherwise the table width will be auto-calculated. Defaults to False.
+        show_header (bool, optional): Show a header row. Defaults to True.
+        show_footer (bool, optional): Show a footer row. Defaults to False.
+        show_edge (bool, optional): Draw a box around the outside of the table. Defaults to True.
+        show_lines (bool, optional): Draw lines between every row. Defaults to False.
+        leading (int, optional): Number of blank lines between rows (precludes ``show_lines``). Defaults to 0.
+        style (Union[str, Style], optional): Default style for the table. Defaults to "none".
+        row_styles (List[Union, str], optional): Optional list of row styles, if more than one style is given then the styles will alternate. Defaults to None.
+        header_style (Union[str, Style], optional): Style of the header. Defaults to "table.header".
+        footer_style (Union[str, Style], optional): Style of the footer. Defaults to "table.footer".
+        border_style (Union[str, Style], optional): Style of the border. Defaults to None.
+        title_style (Union[str, Style], optional): Style of the title. Defaults to None.
+        caption_style (Union[str, Style], optional): Style of the caption. Defaults to None.
+        title_justify (str, optional): Justify method for title. Defaults to "center".
+        caption_justify (str, optional): Justify method for caption. Defaults to "center".
+        highlight (bool, optional): Highlight cell contents (if str). Defaults to False.
+    """
+
+    columns: List[Column]
+    rows: List[Row]
+
+    def __init__(
+        self,
+        *headers: Union[Column, str],
+        title: Optional[TextType] = None,
+        caption: Optional[TextType] = None,
+        width: Optional[int] = None,
+        min_width: Optional[int] = None,
+        box: Optional[box.Box] = box.HEAVY_HEAD,
+        safe_box: Optional[bool] = None,
+        padding: PaddingDimensions = (0, 1),
+        collapse_padding: bool = False,
+        pad_edge: bool = True,
+        expand: bool = False,
+        show_header: bool = True,
+        show_footer: bool = False,
+        show_edge: bool = True,
+        show_lines: bool = False,
+        leading: int = 0,
+        style: StyleType = "none",
+        row_styles: Optional[Iterable[StyleType]] = None,
+        header_style: Optional[StyleType] = "table.header",
+        footer_style: Optional[StyleType] = "table.footer",
+        border_style: Optional[StyleType] = None,
+        title_style: Optional[StyleType] = None,
+        caption_style: Optional[StyleType] = None,
+        title_justify: "JustifyMethod" = "center",
+        caption_justify: "JustifyMethod" = "center",
+        highlight: bool = False,
+    ) -> None:
+        self.columns: List[Column] = []
+        self.rows: List[Row] = []
+        self.title = title
+        self.caption = caption
+        self.width = width
+        self.min_width = min_width
+        self.box = box
+        self.safe_box = safe_box
+        self._padding = Padding.unpack(padding)
+        self.pad_edge = pad_edge
+        self._expand = expand
+        self.show_header = show_header
+        self.show_footer = show_footer
+        self.show_edge = show_edge
+        self.show_lines = show_lines
+        self.leading = leading
+        self.collapse_padding = collapse_padding
+        self.style = style
+        self.header_style = header_style or ""
+        self.footer_style = footer_style or ""
+        self.border_style = border_style
+        self.title_style = title_style
+        self.caption_style = caption_style
+        self.title_justify: "JustifyMethod" = title_justify
+        self.caption_justify: "JustifyMethod" = caption_justify
+        self.highlight = highlight
+        self.row_styles: Sequence[StyleType] = list(row_styles or [])
+        append_column = self.columns.append
+        for header in headers:
+            if isinstance(header, str):
+                self.add_column(header=header)
+            else:
+                header._index = len(self.columns)
+                append_column(header)
+
+    @classmethod
+    def grid(
+        cls,
+        *headers: Union[Column, str],
+        padding: PaddingDimensions = 0,
+        collapse_padding: bool = True,
+        pad_edge: bool = False,
+        expand: bool = False,
+    ) -> "Table":
+        """Get a table with no lines, headers, or footer.
+
+        Args:
+            *headers (Union[Column, str]): Column headers, either as a string, or :class:`~rich.table.Column` instance.
+            padding (PaddingDimensions, optional): Get padding around cells. Defaults to 0.
+            collapse_padding (bool, optional): Enable collapsing of padding around cells. Defaults to True.
+            pad_edge (bool, optional): Enable padding around edges of table. Defaults to False.
+            expand (bool, optional): Expand the table to fit the available space if ``True``, otherwise the table width will be auto-calculated. Defaults to False.
+
+        Returns:
+            Table: A table instance.
+        """
+        return cls(
+            *headers,
+            box=None,
+            padding=padding,
+            collapse_padding=collapse_padding,
+            show_header=False,
+            show_footer=False,
+            show_edge=False,
+            pad_edge=pad_edge,
+            expand=expand,
+        )
+
+    @property
+    def expand(self) -> bool:
+        """Setting a non-None self.width implies expand."""
+        return self._expand or self.width is not None
+
+    @expand.setter
+    def expand(self, expand: bool) -> None:
+        """Set expand."""
+        self._expand = expand
+
+    @property
+    def _extra_width(self) -> int:
+        """Get extra width to add to cell content."""
+        width = 0
+        if self.box and self.show_edge:
+            width += 2
+        if self.box:
+            width += len(self.columns) - 1
+        return width
+
+    @property
+    def row_count(self) -> int:
+        """Get the current number of rows."""
+        return len(self.rows)
+
+    def get_row_style(self, console: "Console", index: int) -> StyleType:
+        """Get the current row style."""
+        style = Style.null()
+        if self.row_styles:
+            style += console.get_style(self.row_styles[index % len(self.row_styles)])
+        row_style = self.rows[index].style
+        if row_style is not None:
+            style += console.get_style(row_style)
+        return style
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Measurement:
+        max_width = options.max_width
+        if self.width is not None:
+            max_width = self.width
+        if max_width < 0:
+            return Measurement(0, 0)
+
+        extra_width = self._extra_width
+        max_width = sum(
+            self._calculate_column_widths(
+                console, options.update_width(max_width - extra_width)
+            )
+        )
+        _measure_column = self._measure_column
+
+        measurements = [
+            _measure_column(console, options.update_width(max_width), column)
+            for column in self.columns
+        ]
+        minimum_width = (
+            sum(measurement.minimum for measurement in measurements) + extra_width
+        )
+        maximum_width = (
+            sum(measurement.maximum for measurement in measurements) + extra_width
+            if (self.width is None)
+            else self.width
+        )
+        measurement = Measurement(minimum_width, maximum_width)
+        measurement = measurement.clamp(self.min_width)
+        return measurement
+
+    @property
+    def padding(self) -> Tuple[int, int, int, int]:
+        """Get cell padding."""
+        return self._padding
+
+    @padding.setter
+    def padding(self, padding: PaddingDimensions) -> "Table":
+        """Set cell padding."""
+        self._padding = Padding.unpack(padding)
+        return self
+
+    def add_column(
+        self,
+        header: "RenderableType" = "",
+        footer: "RenderableType" = "",
+        *,
+        header_style: Optional[StyleType] = None,
+        highlight: Optional[bool] = None,
+        footer_style: Optional[StyleType] = None,
+        style: Optional[StyleType] = None,
+        justify: "JustifyMethod" = "left",
+        vertical: "VerticalAlignMethod" = "top",
+        overflow: "OverflowMethod" = "ellipsis",
+        width: Optional[int] = None,
+        min_width: Optional[int] = None,
+        max_width: Optional[int] = None,
+        ratio: Optional[int] = None,
+        no_wrap: bool = False,
+    ) -> None:
+        """Add a column to the table.
+
+        Args:
+            header (RenderableType, optional): Text or renderable for the header.
+                Defaults to "".
+            footer (RenderableType, optional): Text or renderable for the footer.
+                Defaults to "".
+            header_style (Union[str, Style], optional): Style for the header, or None for default. Defaults to None.
+            highlight (bool, optional): Whether to highlight the text. The default of None uses the value of the table (self) object.
+            footer_style (Union[str, Style], optional): Style for the footer, or None for default. Defaults to None.
+            style (Union[str, Style], optional): Style for the column cells, or None for default. Defaults to None.
+            justify (JustifyMethod, optional): Alignment for cells. Defaults to "left".
+            vertical (VerticalAlignMethod, optional): Vertical alignment, one of "top", "middle", or "bottom". Defaults to "top".
+            overflow (OverflowMethod): Overflow method: "crop", "fold", "ellipsis". Defaults to "ellipsis".
+            width (int, optional): Desired width of column in characters, or None to fit to contents. Defaults to None.
+            min_width (Optional[int], optional): Minimum width of column, or ``None`` for no minimum. Defaults to None.
+            max_width (Optional[int], optional): Maximum width of column, or ``None`` for no maximum. Defaults to None.
+            ratio (int, optional): Flexible ratio for the column (requires ``Table.expand`` or ``Table.width``). Defaults to None.
+            no_wrap (bool, optional): Set to ``True`` to disable wrapping of this column.
+        """
+
+        column = Column(
+            _index=len(self.columns),
+            header=header,
+            footer=footer,
+            header_style=header_style or "",
+            highlight=highlight if highlight is not None else self.highlight,
+            footer_style=footer_style or "",
+            style=style or "",
+            justify=justify,
+            vertical=vertical,
+            overflow=overflow,
+            width=width,
+            min_width=min_width,
+            max_width=max_width,
+            ratio=ratio,
+            no_wrap=no_wrap,
+        )
+        self.columns.append(column)
+
+    def add_row(
+        self,
+        *renderables: Optional["RenderableType"],
+        style: Optional[StyleType] = None,
+        end_section: bool = False,
+    ) -> None:
+        """Add a row of renderables.
+
+        Args:
+            *renderables (None or renderable): Each cell in a row must be a renderable object (including str),
+                or ``None`` for a blank cell.
+            style (StyleType, optional): An optional style to apply to the entire row. Defaults to None.
+            end_section (bool, optional): End a section and draw a line. Defaults to False.
+
+        Raises:
+            errors.NotRenderableError: If you add something that can't be rendered.
+        """
+
+        def add_cell(column: Column, renderable: "RenderableType") -> None:
+            column._cells.append(renderable)
+
+        cell_renderables: List[Optional["RenderableType"]] = list(renderables)
+
+        columns = self.columns
+        if len(cell_renderables) < len(columns):
+            cell_renderables = [
+                *cell_renderables,
+                *[None] * (len(columns) - len(cell_renderables)),
+            ]
+        for index, renderable in enumerate(cell_renderables):
+            if index == len(columns):
+                column = Column(_index=index, highlight=self.highlight)
+                for _ in self.rows:
+                    add_cell(column, Text(""))
+                self.columns.append(column)
+            else:
+                column = columns[index]
+            if renderable is None:
+                add_cell(column, "")
+            elif is_renderable(renderable):
+                add_cell(column, renderable)
+            else:
+                raise errors.NotRenderableError(
+                    f"unable to render {type(renderable).__name__}; a string or other renderable object is required"
+                )
+        self.rows.append(Row(style=style, end_section=end_section))
+
+    def add_section(self) -> None:
+        """Add a new section (draw a line after current row)."""
+
+        if self.rows:
+            self.rows[-1].end_section = True
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        if not self.columns:
+            yield Segment("\n")
+            return
+
+        max_width = options.max_width
+        if self.width is not None:
+            max_width = self.width
+
+        extra_width = self._extra_width
+        widths = self._calculate_column_widths(
+            console, options.update_width(max_width - extra_width)
+        )
+        table_width = sum(widths) + extra_width
+
+        render_options = options.update(
+            width=table_width, highlight=self.highlight, height=None
+        )
+
+        def render_annotation(
+            text: TextType, style: StyleType, justify: "JustifyMethod" = "center"
+        ) -> "RenderResult":
+            render_text = (
+                console.render_str(text, style=style, highlight=False)
+                if isinstance(text, str)
+                else text
+            )
+            return console.render(
+                render_text, options=render_options.update(justify=justify)
+            )
+
+        if self.title:
+            yield from render_annotation(
+                self.title,
+                style=Style.pick_first(self.title_style, "table.title"),
+                justify=self.title_justify,
+            )
+        yield from self._render(console, render_options, widths)
+        if self.caption:
+            yield from render_annotation(
+                self.caption,
+                style=Style.pick_first(self.caption_style, "table.caption"),
+                justify=self.caption_justify,
+            )
+
+    def _calculate_column_widths(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> List[int]:
+        """Calculate the widths of each column, including padding, not including borders."""
+        max_width = options.max_width
+        columns = self.columns
+        width_ranges = [
+            self._measure_column(console, options, column) for column in columns
+        ]
+        widths = [_range.maximum or 1 for _range in width_ranges]
+        get_padding_width = self._get_padding_width
+        extra_width = self._extra_width
+        if self.expand:
+            ratios = [col.ratio or 0 for col in columns if col.flexible]
+            if any(ratios):
+                fixed_widths = [
+                    0 if column.flexible else _range.maximum
+                    for _range, column in zip(width_ranges, columns)
+                ]
+                flex_minimum = [
+                    (column.width or 1) + get_padding_width(column._index)
+                    for column in columns
+                    if column.flexible
+                ]
+                flexible_width = max_width - sum(fixed_widths)
+                flex_widths = ratio_distribute(flexible_width, ratios, flex_minimum)
+                iter_flex_widths = iter(flex_widths)
+                for index, column in enumerate(columns):
+                    if column.flexible:
+                        widths[index] = fixed_widths[index] + next(iter_flex_widths)
+        table_width = sum(widths)
+
+        if table_width > max_width:
+            widths = self._collapse_widths(
+                widths,
+                [(column.width is None and not column.no_wrap) for column in columns],
+                max_width,
+            )
+            table_width = sum(widths)
+            # last resort, reduce columns evenly
+            if table_width > max_width:
+                excess_width = table_width - max_width
+                widths = ratio_reduce(excess_width, [1] * len(widths), widths, widths)
+                table_width = sum(widths)
+
+            width_ranges = [
+                self._measure_column(console, options.update_width(width), column)
+                for width, column in zip(widths, columns)
+            ]
+            widths = [_range.maximum or 0 for _range in width_ranges]
+
+        if (table_width < max_width and self.expand) or (
+            self.min_width is not None and table_width < (self.min_width - extra_width)
+        ):
+            _max_width = (
+                max_width
+                if self.min_width is None
+                else min(self.min_width - extra_width, max_width)
+            )
+            pad_widths = ratio_distribute(_max_width - table_width, widths)
+            widths = [_width + pad for _width, pad in zip(widths, pad_widths)]
+
+        return widths
+
+    @classmethod
+    def _collapse_widths(
+        cls, widths: List[int], wrapable: List[bool], max_width: int
+    ) -> List[int]:
+        """Reduce widths so that the total is under max_width.
+
+        Args:
+            widths (List[int]): List of widths.
+            wrapable (List[bool]): List of booleans that indicate if a column may shrink.
+            max_width (int): Maximum width to reduce to.
+
+        Returns:
+            List[int]: A new list of widths.
+        """
+        total_width = sum(widths)
+        excess_width = total_width - max_width
+        if any(wrapable):
+            while total_width and excess_width > 0:
+                max_column = max(
+                    width for width, allow_wrap in zip(widths, wrapable) if allow_wrap
+                )
+                second_max_column = max(
+                    width if allow_wrap and width != max_column else 0
+                    for width, allow_wrap in zip(widths, wrapable)
+                )
+                column_difference = max_column - second_max_column
+                ratios = [
+                    (1 if (width == max_column and allow_wrap) else 0)
+                    for width, allow_wrap in zip(widths, wrapable)
+                ]
+                if not any(ratios) or not column_difference:
+                    break
+                max_reduce = [min(excess_width, column_difference)] * len(widths)
+                widths = ratio_reduce(excess_width, ratios, max_reduce, widths)
+
+                total_width = sum(widths)
+                excess_width = total_width - max_width
+        return widths
+
+    def _get_cells(
+        self, console: "Console", column_index: int, column: Column
+    ) -> Iterable[_Cell]:
+        """Get all the cells with padding and optional header."""
+
+        collapse_padding = self.collapse_padding
+        pad_edge = self.pad_edge
+        padding = self.padding
+        any_padding = any(padding)
+
+        first_column = column_index == 0
+        last_column = column_index == len(self.columns) - 1
+
+        _padding_cache: Dict[Tuple[bool, bool], Tuple[int, int, int, int]] = {}
+
+        def get_padding(first_row: bool, last_row: bool) -> Tuple[int, int, int, int]:
+            cached = _padding_cache.get((first_row, last_row))
+            if cached:
+                return cached
+            top, right, bottom, left = padding
+
+            if collapse_padding:
+                if not first_column:
+                    left = max(0, left - right)
+                if not last_row:
+                    bottom = max(0, top - bottom)
+
+            if not pad_edge:
+                if first_column:
+                    left = 0
+                if last_column:
+                    right = 0
+                if first_row:
+                    top = 0
+                if last_row:
+                    bottom = 0
+            _padding = (top, right, bottom, left)
+            _padding_cache[(first_row, last_row)] = _padding
+            return _padding
+
+        raw_cells: List[Tuple[StyleType, "RenderableType"]] = []
+        _append = raw_cells.append
+        get_style = console.get_style
+        if self.show_header:
+            header_style = get_style(self.header_style or "") + get_style(
+                column.header_style
+            )
+            _append((header_style, column.header))
+        cell_style = get_style(column.style or "")
+        for cell in column.cells:
+            _append((cell_style, cell))
+        if self.show_footer:
+            footer_style = get_style(self.footer_style or "") + get_style(
+                column.footer_style
+            )
+            _append((footer_style, column.footer))
+
+        if any_padding:
+            _Padding = Padding
+            for first, last, (style, renderable) in loop_first_last(raw_cells):
+                yield _Cell(
+                    style,
+                    _Padding(renderable, get_padding(first, last)),
+                    getattr(renderable, "vertical", None) or column.vertical,
+                )
+        else:
+            for style, renderable in raw_cells:
+                yield _Cell(
+                    style,
+                    renderable,
+                    getattr(renderable, "vertical", None) or column.vertical,
+                )
+
+    def _get_padding_width(self, column_index: int) -> int:
+        """Get extra width from padding."""
+        _, pad_right, _, pad_left = self.padding
+        if self.collapse_padding:
+            if column_index > 0:
+                pad_left = max(0, pad_left - pad_right)
+        return pad_left + pad_right
+
+    def _measure_column(
+        self,
+        console: "Console",
+        options: "ConsoleOptions",
+        column: Column,
+    ) -> Measurement:
+        """Get the minimum and maximum width of the column."""
+
+        max_width = options.max_width
+        if max_width < 1:
+            return Measurement(0, 0)
+
+        padding_width = self._get_padding_width(column._index)
+
+        if column.width is not None:
+            # Fixed width column
+            return Measurement(
+                column.width + padding_width, column.width + padding_width
+            ).with_maximum(max_width)
+        # Flexible column, we need to measure contents
+        min_widths: List[int] = []
+        max_widths: List[int] = []
+        append_min = min_widths.append
+        append_max = max_widths.append
+        get_render_width = Measurement.get
+        for cell in self._get_cells(console, column._index, column):
+            _min, _max = get_render_width(console, options, cell.renderable)
+            append_min(_min)
+            append_max(_max)
+
+        measurement = Measurement(
+            max(min_widths) if min_widths else 1,
+            max(max_widths) if max_widths else max_width,
+        ).with_maximum(max_width)
+        measurement = measurement.clamp(
+            None if column.min_width is None else column.min_width + padding_width,
+            None if column.max_width is None else column.max_width + padding_width,
+        )
+        return measurement
+
+    def _render(
+        self, console: "Console", options: "ConsoleOptions", widths: List[int]
+    ) -> "RenderResult":
+        table_style = console.get_style(self.style or "")
+
+        border_style = table_style + console.get_style(self.border_style or "")
+        _column_cells = (
+            self._get_cells(console, column_index, column)
+            for column_index, column in enumerate(self.columns)
+        )
+        row_cells: List[Tuple[_Cell, ...]] = list(zip(*_column_cells))
+        _box = (
+            self.box.substitute(
+                options, safe=pick_bool(self.safe_box, console.safe_box)
+            )
+            if self.box
+            else None
+        )
+        _box = _box.get_plain_headed_box() if _box and not self.show_header else _box
+
+        new_line = Segment.line()
+
+        columns = self.columns
+        show_header = self.show_header
+        show_footer = self.show_footer
+        show_edge = self.show_edge
+        show_lines = self.show_lines
+        leading = self.leading
+
+        _Segment = Segment
+        if _box:
+            box_segments = [
+                (
+                    _Segment(_box.head_left, border_style),
+                    _Segment(_box.head_right, border_style),
+                    _Segment(_box.head_vertical, border_style),
+                ),
+                (
+                    _Segment(_box.mid_left, border_style),
+                    _Segment(_box.mid_right, border_style),
+                    _Segment(_box.mid_vertical, border_style),
+                ),
+                (
+                    _Segment(_box.foot_left, border_style),
+                    _Segment(_box.foot_right, border_style),
+                    _Segment(_box.foot_vertical, border_style),
+                ),
+            ]
+            if show_edge:
+                yield _Segment(_box.get_top(widths), border_style)
+                yield new_line
+        else:
+            box_segments = []
+
+        get_row_style = self.get_row_style
+        get_style = console.get_style
+
+        for index, (first, last, row_cell) in enumerate(loop_first_last(row_cells)):
+            header_row = first and show_header
+            footer_row = last and show_footer
+            row = (
+                self.rows[index - show_header]
+                if (not header_row and not footer_row)
+                else None
+            )
+            max_height = 1
+            cells: List[List[List[Segment]]] = []
+            if header_row or footer_row:
+                row_style = Style.null()
+            else:
+                row_style = get_style(
+                    get_row_style(console, index - 1 if show_header else index)
+                )
+            for width, cell, column in zip(widths, row_cell, columns):
+                render_options = options.update(
+                    width=width,
+                    justify=column.justify,
+                    no_wrap=column.no_wrap,
+                    overflow=column.overflow,
+                    height=None,
+                    highlight=column.highlight,
+                )
+                lines = console.render_lines(
+                    cell.renderable,
+                    render_options,
+                    style=get_style(cell.style) + row_style,
+                )
+                max_height = max(max_height, len(lines))
+                cells.append(lines)
+
+            row_height = max(len(cell) for cell in cells)
+
+            def align_cell(
+                cell: List[List[Segment]],
+                vertical: "VerticalAlignMethod",
+                width: int,
+                style: Style,
+            ) -> List[List[Segment]]:
+                if header_row:
+                    vertical = "bottom"
+                elif footer_row:
+                    vertical = "top"
+
+                if vertical == "top":
+                    return _Segment.align_top(cell, width, row_height, style)
+                elif vertical == "middle":
+                    return _Segment.align_middle(cell, width, row_height, style)
+                return _Segment.align_bottom(cell, width, row_height, style)
+
+            cells[:] = [
+                _Segment.set_shape(
+                    align_cell(
+                        cell,
+                        _cell.vertical,
+                        width,
+                        get_style(_cell.style) + row_style,
+                    ),
+                    width,
+                    max_height,
+                )
+                for width, _cell, cell, column in zip(widths, row_cell, cells, columns)
+            ]
+
+            if _box:
+                if last and show_footer:
+                    yield _Segment(
+                        _box.get_row(widths, "foot", edge=show_edge), border_style
+                    )
+                    yield new_line
+                left, right, _divider = box_segments[0 if first else (2 if last else 1)]
+
+                # If the column divider is whitespace also style it with the row background
+                divider = (
+                    _divider
+                    if _divider.text.strip()
+                    else _Segment(
+                        _divider.text, row_style.background_style + _divider.style
+                    )
+                )
+                for line_no in range(max_height):
+                    if show_edge:
+                        yield left
+                    for last_cell, rendered_cell in loop_last(cells):
+                        yield from rendered_cell[line_no]
+                        if not last_cell:
+                            yield divider
+                    if show_edge:
+                        yield right
+                    yield new_line
+            else:
+                for line_no in range(max_height):
+                    for rendered_cell in cells:
+                        yield from rendered_cell[line_no]
+                    yield new_line
+            if _box and first and show_header:
+                yield _Segment(
+                    _box.get_row(widths, "head", edge=show_edge), border_style
+                )
+                yield new_line
+            end_section = row and row.end_section
+            if _box and (show_lines or leading or end_section):
+                if (
+                    not last
+                    and not (show_footer and index >= len(row_cells) - 2)
+                    and not (show_header and header_row)
+                ):
+                    if leading:
+                        yield _Segment(
+                            _box.get_row(widths, "mid", edge=show_edge) * leading,
+                            border_style,
+                        )
+                    else:
+                        yield _Segment(
+                            _box.get_row(widths, "row", edge=show_edge), border_style
+                        )
+                    yield new_line
+
+        if _box and show_edge:
+            yield _Segment(_box.get_bottom(widths), border_style)
+            yield new_line
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Console
+    from pip._vendor.rich.highlighter import ReprHighlighter
+    from pip._vendor.rich.table import Table as Table
+
+    from ._timer import timer
+
+    with timer("Table render"):
+        table = Table(
+            title="Star Wars Movies",
+            caption="Rich example table",
+            caption_justify="right",
+        )
+
+        table.add_column(
+            "Released", header_style="bright_cyan", style="cyan", no_wrap=True
+        )
+        table.add_column("Title", style="magenta")
+        table.add_column("Box Office", justify="right", style="green")
+
+        table.add_row(
+            "Dec 20, 2019",
+            "Star Wars: The Rise of Skywalker",
+            "$952,110,690",
+        )
+        table.add_row("May 25, 2018", "Solo: A Star Wars Story", "$393,151,347")
+        table.add_row(
+            "Dec 15, 2017",
+            "Star Wars Ep. V111: The Last Jedi",
+            "$1,332,539,889",
+            style="on black",
+            end_section=True,
+        )
+        table.add_row(
+            "Dec 16, 2016",
+            "Rogue One: A Star Wars Story",
+            "$1,332,439,889",
+        )
+
+        def header(text: str) -> None:
+            console.print()
+            console.rule(highlight(text))
+            console.print()
+
+        console = Console()
+        highlight = ReprHighlighter()
+        header("Example Table")
+        console.print(table, justify="center")
+
+        table.expand = True
+        header("expand=True")
+        console.print(table)
+
+        table.width = 50
+        header("width=50")
+
+        console.print(table, justify="center")
+
+        table.width = None
+        table.expand = False
+        table.row_styles = ["dim", "none"]
+        header("row_styles=['dim', 'none']")
+
+        console.print(table, justify="center")
+
+        table.width = None
+        table.expand = False
+        table.row_styles = ["dim", "none"]
+        table.leading = 1
+        header("leading=1, row_styles=['dim', 'none']")
+        console.print(table, justify="center")
+
+        table.width = None
+        table.expand = False
+        table.row_styles = ["dim", "none"]
+        table.show_lines = True
+        table.leading = 0
+        header("show_lines=True, row_styles=['dim', 'none']")
+        console.print(table, justify="center")
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/terminal_theme.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/terminal_theme.py
new file mode 100644
index 0000000..565e9d9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/terminal_theme.py
@@ -0,0 +1,153 @@
+from typing import List, Optional, Tuple
+
+from .color_triplet import ColorTriplet
+from .palette import Palette
+
+_ColorTuple = Tuple[int, int, int]
+
+
+class TerminalTheme:
+    """A color theme used when exporting console content.
+
+    Args:
+        background (Tuple[int, int, int]): The background color.
+        foreground (Tuple[int, int, int]): The foreground (text) color.
+        normal (List[Tuple[int, int, int]]): A list of 8 normal intensity colors.
+        bright (List[Tuple[int, int, int]], optional): A list of 8 bright colors, or None
+            to repeat normal intensity. Defaults to None.
+    """
+
+    def __init__(
+        self,
+        background: _ColorTuple,
+        foreground: _ColorTuple,
+        normal: List[_ColorTuple],
+        bright: Optional[List[_ColorTuple]] = None,
+    ) -> None:
+        self.background_color = ColorTriplet(*background)
+        self.foreground_color = ColorTriplet(*foreground)
+        self.ansi_colors = Palette(normal + (bright or normal))
+
+
+DEFAULT_TERMINAL_THEME = TerminalTheme(
+    (255, 255, 255),
+    (0, 0, 0),
+    [
+        (0, 0, 0),
+        (128, 0, 0),
+        (0, 128, 0),
+        (128, 128, 0),
+        (0, 0, 128),
+        (128, 0, 128),
+        (0, 128, 128),
+        (192, 192, 192),
+    ],
+    [
+        (128, 128, 128),
+        (255, 0, 0),
+        (0, 255, 0),
+        (255, 255, 0),
+        (0, 0, 255),
+        (255, 0, 255),
+        (0, 255, 255),
+        (255, 255, 255),
+    ],
+)
+
+MONOKAI = TerminalTheme(
+    (12, 12, 12),
+    (217, 217, 217),
+    [
+        (26, 26, 26),
+        (244, 0, 95),
+        (152, 224, 36),
+        (253, 151, 31),
+        (157, 101, 255),
+        (244, 0, 95),
+        (88, 209, 235),
+        (196, 197, 181),
+        (98, 94, 76),
+    ],
+    [
+        (244, 0, 95),
+        (152, 224, 36),
+        (224, 213, 97),
+        (157, 101, 255),
+        (244, 0, 95),
+        (88, 209, 235),
+        (246, 246, 239),
+    ],
+)
+DIMMED_MONOKAI = TerminalTheme(
+    (25, 25, 25),
+    (185, 188, 186),
+    [
+        (58, 61, 67),
+        (190, 63, 72),
+        (135, 154, 59),
+        (197, 166, 53),
+        (79, 118, 161),
+        (133, 92, 141),
+        (87, 143, 164),
+        (185, 188, 186),
+        (136, 137, 135),
+    ],
+    [
+        (251, 0, 31),
+        (15, 114, 47),
+        (196, 112, 51),
+        (24, 109, 227),
+        (251, 0, 103),
+        (46, 112, 109),
+        (253, 255, 185),
+    ],
+)
+NIGHT_OWLISH = TerminalTheme(
+    (255, 255, 255),
+    (64, 63, 83),
+    [
+        (1, 22, 39),
+        (211, 66, 62),
+        (42, 162, 152),
+        (218, 170, 1),
+        (72, 118, 214),
+        (64, 63, 83),
+        (8, 145, 106),
+        (122, 129, 129),
+        (122, 129, 129),
+    ],
+    [
+        (247, 110, 110),
+        (73, 208, 197),
+        (218, 194, 107),
+        (92, 167, 228),
+        (105, 112, 152),
+        (0, 201, 144),
+        (152, 159, 177),
+    ],
+)
+
+SVG_EXPORT_THEME = TerminalTheme(
+    (41, 41, 41),
+    (197, 200, 198),
+    [
+        (75, 78, 85),
+        (204, 85, 90),
+        (152, 168, 75),
+        (208, 179, 68),
+        (96, 138, 177),
+        (152, 114, 159),
+        (104, 160, 179),
+        (197, 200, 198),
+        (154, 155, 153),
+    ],
+    [
+        (255, 38, 39),
+        (0, 130, 61),
+        (208, 132, 66),
+        (25, 132, 233),
+        (255, 44, 122),
+        (57, 130, 128),
+        (253, 253, 197),
+    ],
+)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/text.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/text.py
new file mode 100644
index 0000000..5a0c6b1
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/text.py
@@ -0,0 +1,1361 @@
+import re
+from functools import partial, reduce
+from math import gcd
+from operator import itemgetter
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    NamedTuple,
+    Optional,
+    Pattern,
+    Tuple,
+    Union,
+)
+
+from ._loop import loop_last
+from ._pick import pick_bool
+from ._wrap import divide_line
+from .align import AlignMethod
+from .cells import cell_len, set_cell_size
+from .containers import Lines
+from .control import strip_control_codes
+from .emoji import EmojiVariant
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment
+from .style import Style, StyleType
+
+if TYPE_CHECKING:  # pragma: no cover
+    from .console import Console, ConsoleOptions, JustifyMethod, OverflowMethod
+
+DEFAULT_JUSTIFY: "JustifyMethod" = "default"
+DEFAULT_OVERFLOW: "OverflowMethod" = "fold"
+
+
+_re_whitespace = re.compile(r"\s+$")
+
+TextType = Union[str, "Text"]
+"""A plain string or a :class:`Text` instance."""
+
+GetStyleCallable = Callable[[str], Optional[StyleType]]
+
+
+class Span(NamedTuple):
+    """A marked up region in some text."""
+
+    start: int
+    """Span start index."""
+    end: int
+    """Span end index."""
+    style: Union[str, Style]
+    """Style associated with the span."""
+
+    def __repr__(self) -> str:
+        return f"Span({self.start}, {self.end}, {self.style!r})"
+
+    def __bool__(self) -> bool:
+        return self.end > self.start
+
+    def split(self, offset: int) -> Tuple["Span", Optional["Span"]]:
+        """Split a span in to 2 from a given offset."""
+
+        if offset < self.start:
+            return self, None
+        if offset >= self.end:
+            return self, None
+
+        start, end, style = self
+        span1 = Span(start, min(end, offset), style)
+        span2 = Span(span1.end, end, style)
+        return span1, span2
+
+    def move(self, offset: int) -> "Span":
+        """Move start and end by a given offset.
+
+        Args:
+            offset (int): Number of characters to add to start and end.
+
+        Returns:
+            TextSpan: A new TextSpan with adjusted position.
+        """
+        start, end, style = self
+        return Span(start + offset, end + offset, style)
+
+    def right_crop(self, offset: int) -> "Span":
+        """Crop the span at the given offset.
+
+        Args:
+            offset (int): A value between start and end.
+
+        Returns:
+            Span: A new (possibly smaller) span.
+        """
+        start, end, style = self
+        if offset >= end:
+            return self
+        return Span(start, min(offset, end), style)
+
+    def extend(self, cells: int) -> "Span":
+        """Extend the span by the given number of cells.
+
+        Args:
+            cells (int): Additional space to add to end of span.
+
+        Returns:
+            Span: A span.
+        """
+        if cells:
+            start, end, style = self
+            return Span(start, end + cells, style)
+        else:
+            return self
+
+
+class Text(JupyterMixin):
+    """Text with color / style.
+
+    Args:
+        text (str, optional): Default unstyled text. Defaults to "".
+        style (Union[str, Style], optional): Base style for text. Defaults to "".
+        justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
+        overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
+        no_wrap (bool, optional): Disable text wrapping, or None for default. Defaults to None.
+        end (str, optional): Character to end text with. Defaults to "\\\\n".
+        tab_size (int): Number of spaces per tab, or ``None`` to use ``console.tab_size``. Defaults to None.
+        spans (List[Span], optional). A list of predefined style spans. Defaults to None.
+    """
+
+    __slots__ = [
+        "_text",
+        "style",
+        "justify",
+        "overflow",
+        "no_wrap",
+        "end",
+        "tab_size",
+        "_spans",
+        "_length",
+    ]
+
+    def __init__(
+        self,
+        text: str = "",
+        style: Union[str, Style] = "",
+        *,
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+        no_wrap: Optional[bool] = None,
+        end: str = "\n",
+        tab_size: Optional[int] = None,
+        spans: Optional[List[Span]] = None,
+    ) -> None:
+        sanitized_text = strip_control_codes(text)
+        self._text = [sanitized_text]
+        self.style = style
+        self.justify: Optional["JustifyMethod"] = justify
+        self.overflow: Optional["OverflowMethod"] = overflow
+        self.no_wrap = no_wrap
+        self.end = end
+        self.tab_size = tab_size
+        self._spans: List[Span] = spans or []
+        self._length: int = len(sanitized_text)
+
+    def __len__(self) -> int:
+        return self._length
+
+    def __bool__(self) -> bool:
+        return bool(self._length)
+
+    def __str__(self) -> str:
+        return self.plain
+
+    def __repr__(self) -> str:
+        return f""
+
+    def __add__(self, other: Any) -> "Text":
+        if isinstance(other, (str, Text)):
+            result = self.copy()
+            result.append(other)
+            return result
+        return NotImplemented
+
+    def __eq__(self, other: object) -> bool:
+        if not isinstance(other, Text):
+            return NotImplemented
+        return self.plain == other.plain and self._spans == other._spans
+
+    def __contains__(self, other: object) -> bool:
+        if isinstance(other, str):
+            return other in self.plain
+        elif isinstance(other, Text):
+            return other.plain in self.plain
+        return False
+
+    def __getitem__(self, slice: Union[int, slice]) -> "Text":
+        def get_text_at(offset: int) -> "Text":
+            _Span = Span
+            text = Text(
+                self.plain[offset],
+                spans=[
+                    _Span(0, 1, style)
+                    for start, end, style in self._spans
+                    if end > offset >= start
+                ],
+                end="",
+            )
+            return text
+
+        if isinstance(slice, int):
+            return get_text_at(slice)
+        else:
+            start, stop, step = slice.indices(len(self.plain))
+            if step == 1:
+                lines = self.divide([start, stop])
+                return lines[1]
+            else:
+                # This would be a bit of work to implement efficiently
+                # For now, its not required
+                raise TypeError("slices with step!=1 are not supported")
+
+    @property
+    def cell_len(self) -> int:
+        """Get the number of cells required to render this text."""
+        return cell_len(self.plain)
+
+    @property
+    def markup(self) -> str:
+        """Get console markup to render this Text.
+
+        Returns:
+            str: A string potentially creating markup tags.
+        """
+        from .markup import escape
+
+        output: List[str] = []
+
+        plain = self.plain
+        markup_spans = [
+            (0, False, self.style),
+            *((span.start, False, span.style) for span in self._spans),
+            *((span.end, True, span.style) for span in self._spans),
+            (len(plain), True, self.style),
+        ]
+        markup_spans.sort(key=itemgetter(0, 1))
+        position = 0
+        append = output.append
+        for offset, closing, style in markup_spans:
+            if offset > position:
+                append(escape(plain[position:offset]))
+                position = offset
+            if style:
+                append(f"[/{style}]" if closing else f"[{style}]")
+        markup = "".join(output)
+        return markup
+
+    @classmethod
+    def from_markup(
+        cls,
+        text: str,
+        *,
+        style: Union[str, Style] = "",
+        emoji: bool = True,
+        emoji_variant: Optional[EmojiVariant] = None,
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+        end: str = "\n",
+    ) -> "Text":
+        """Create Text instance from markup.
+
+        Args:
+            text (str): A string containing console markup.
+            style (Union[str, Style], optional): Base style for text. Defaults to "".
+            emoji (bool, optional): Also render emoji code. Defaults to True.
+            emoji_variant (str, optional): Optional emoji variant, either "text" or "emoji". Defaults to None.
+            justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
+            overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
+            end (str, optional): Character to end text with. Defaults to "\\\\n".
+
+        Returns:
+            Text: A Text instance with markup rendered.
+        """
+        from .markup import render
+
+        rendered_text = render(text, style, emoji=emoji, emoji_variant=emoji_variant)
+        rendered_text.justify = justify
+        rendered_text.overflow = overflow
+        rendered_text.end = end
+        return rendered_text
+
+    @classmethod
+    def from_ansi(
+        cls,
+        text: str,
+        *,
+        style: Union[str, Style] = "",
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+        no_wrap: Optional[bool] = None,
+        end: str = "\n",
+        tab_size: Optional[int] = 8,
+    ) -> "Text":
+        """Create a Text object from a string containing ANSI escape codes.
+
+        Args:
+            text (str): A string containing escape codes.
+            style (Union[str, Style], optional): Base style for text. Defaults to "".
+            justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
+            overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
+            no_wrap (bool, optional): Disable text wrapping, or None for default. Defaults to None.
+            end (str, optional): Character to end text with. Defaults to "\\\\n".
+            tab_size (int): Number of spaces per tab, or ``None`` to use ``console.tab_size``. Defaults to None.
+        """
+        from .ansi import AnsiDecoder
+
+        joiner = Text(
+            "\n",
+            justify=justify,
+            overflow=overflow,
+            no_wrap=no_wrap,
+            end=end,
+            tab_size=tab_size,
+            style=style,
+        )
+        decoder = AnsiDecoder()
+        result = joiner.join(line for line in decoder.decode(text))
+        return result
+
+    @classmethod
+    def styled(
+        cls,
+        text: str,
+        style: StyleType = "",
+        *,
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+    ) -> "Text":
+        """Construct a Text instance with a pre-applied styled. A style applied in this way won't be used
+        to pad the text when it is justified.
+
+        Args:
+            text (str): A string containing console markup.
+            style (Union[str, Style]): Style to apply to the text. Defaults to "".
+            justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
+            overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
+
+        Returns:
+            Text: A text instance with a style applied to the entire string.
+        """
+        styled_text = cls(text, justify=justify, overflow=overflow)
+        styled_text.stylize(style)
+        return styled_text
+
+    @classmethod
+    def assemble(
+        cls,
+        *parts: Union[str, "Text", Tuple[str, StyleType]],
+        style: Union[str, Style] = "",
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+        no_wrap: Optional[bool] = None,
+        end: str = "\n",
+        tab_size: int = 8,
+        meta: Optional[Dict[str, Any]] = None,
+    ) -> "Text":
+        """Construct a text instance by combining a sequence of strings with optional styles.
+        The positional arguments should be either strings, or a tuple of string + style.
+
+        Args:
+            style (Union[str, Style], optional): Base style for text. Defaults to "".
+            justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
+            overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
+            no_wrap (bool, optional): Disable text wrapping, or None for default. Defaults to None.
+            end (str, optional): Character to end text with. Defaults to "\\\\n".
+            tab_size (int): Number of spaces per tab, or ``None`` to use ``console.tab_size``. Defaults to None.
+            meta (Dict[str, Any], optional). Meta data to apply to text, or None for no meta data. Default to None
+
+        Returns:
+            Text: A new text instance.
+        """
+        text = cls(
+            style=style,
+            justify=justify,
+            overflow=overflow,
+            no_wrap=no_wrap,
+            end=end,
+            tab_size=tab_size,
+        )
+        append = text.append
+        _Text = Text
+        for part in parts:
+            if isinstance(part, (_Text, str)):
+                append(part)
+            else:
+                append(*part)
+        if meta:
+            text.apply_meta(meta)
+        return text
+
+    @property
+    def plain(self) -> str:
+        """Get the text as a single string."""
+        if len(self._text) != 1:
+            self._text[:] = ["".join(self._text)]
+        return self._text[0]
+
+    @plain.setter
+    def plain(self, new_text: str) -> None:
+        """Set the text to a new value."""
+        if new_text != self.plain:
+            sanitized_text = strip_control_codes(new_text)
+            self._text[:] = [sanitized_text]
+            old_length = self._length
+            self._length = len(sanitized_text)
+            if old_length > self._length:
+                self._trim_spans()
+
+    @property
+    def spans(self) -> List[Span]:
+        """Get a reference to the internal list of spans."""
+        return self._spans
+
+    @spans.setter
+    def spans(self, spans: List[Span]) -> None:
+        """Set spans."""
+        self._spans = spans[:]
+
+    def blank_copy(self, plain: str = "") -> "Text":
+        """Return a new Text instance with copied metadata (but not the string or spans)."""
+        copy_self = Text(
+            plain,
+            style=self.style,
+            justify=self.justify,
+            overflow=self.overflow,
+            no_wrap=self.no_wrap,
+            end=self.end,
+            tab_size=self.tab_size,
+        )
+        return copy_self
+
+    def copy(self) -> "Text":
+        """Return a copy of this instance."""
+        copy_self = Text(
+            self.plain,
+            style=self.style,
+            justify=self.justify,
+            overflow=self.overflow,
+            no_wrap=self.no_wrap,
+            end=self.end,
+            tab_size=self.tab_size,
+        )
+        copy_self._spans[:] = self._spans
+        return copy_self
+
+    def stylize(
+        self,
+        style: Union[str, Style],
+        start: int = 0,
+        end: Optional[int] = None,
+    ) -> None:
+        """Apply a style to the text, or a portion of the text.
+
+        Args:
+            style (Union[str, Style]): Style instance or style definition to apply.
+            start (int): Start offset (negative indexing is supported). Defaults to 0.
+            end (Optional[int], optional): End offset (negative indexing is supported), or None for end of text. Defaults to None.
+        """
+        if style:
+            length = len(self)
+            if start < 0:
+                start = length + start
+            if end is None:
+                end = length
+            if end < 0:
+                end = length + end
+            if start >= length or end <= start:
+                # Span not in text or not valid
+                return
+            self._spans.append(Span(start, min(length, end), style))
+
+    def stylize_before(
+        self,
+        style: Union[str, Style],
+        start: int = 0,
+        end: Optional[int] = None,
+    ) -> None:
+        """Apply a style to the text, or a portion of the text. Styles will be applied before other styles already present.
+
+        Args:
+            style (Union[str, Style]): Style instance or style definition to apply.
+            start (int): Start offset (negative indexing is supported). Defaults to 0.
+            end (Optional[int], optional): End offset (negative indexing is supported), or None for end of text. Defaults to None.
+        """
+        if style:
+            length = len(self)
+            if start < 0:
+                start = length + start
+            if end is None:
+                end = length
+            if end < 0:
+                end = length + end
+            if start >= length or end <= start:
+                # Span not in text or not valid
+                return
+            self._spans.insert(0, Span(start, min(length, end), style))
+
+    def apply_meta(
+        self, meta: Dict[str, Any], start: int = 0, end: Optional[int] = None
+    ) -> None:
+        """Apply metadata to the text, or a portion of the text.
+
+        Args:
+            meta (Dict[str, Any]): A dict of meta information.
+            start (int): Start offset (negative indexing is supported). Defaults to 0.
+            end (Optional[int], optional): End offset (negative indexing is supported), or None for end of text. Defaults to None.
+
+        """
+        style = Style.from_meta(meta)
+        self.stylize(style, start=start, end=end)
+
+    def on(self, meta: Optional[Dict[str, Any]] = None, **handlers: Any) -> "Text":
+        """Apply event handlers (used by Textual project).
+
+        Example:
+            >>> from rich.text import Text
+            >>> text = Text("hello world")
+            >>> text.on(click="view.toggle('world')")
+
+        Args:
+            meta (Dict[str, Any]): Mapping of meta information.
+            **handlers: Keyword args are prefixed with "@" to defined handlers.
+
+        Returns:
+            Text: Self is returned to method may be chained.
+        """
+        meta = {} if meta is None else meta
+        meta.update({f"@{key}": value for key, value in handlers.items()})
+        self.stylize(Style.from_meta(meta))
+        return self
+
+    def remove_suffix(self, suffix: str) -> None:
+        """Remove a suffix if it exists.
+
+        Args:
+            suffix (str): Suffix to remove.
+        """
+        if self.plain.endswith(suffix):
+            self.right_crop(len(suffix))
+
+    def get_style_at_offset(self, console: "Console", offset: int) -> Style:
+        """Get the style of a character at give offset.
+
+        Args:
+            console (~Console): Console where text will be rendered.
+            offset (int): Offset in to text (negative indexing supported)
+
+        Returns:
+            Style: A Style instance.
+        """
+        # TODO: This is a little inefficient, it is only used by full justify
+        if offset < 0:
+            offset = len(self) + offset
+        get_style = console.get_style
+        style = get_style(self.style).copy()
+        for start, end, span_style in self._spans:
+            if end > offset >= start:
+                style += get_style(span_style, default="")
+        return style
+
+    def extend_style(self, spaces: int) -> None:
+        """Extend the Text given number of spaces where the spaces have the same style as the last character.
+
+        Args:
+            spaces (int): Number of spaces to add to the Text.
+        """
+        if spaces <= 0:
+            return
+        spans = self.spans
+        new_spaces = " " * spaces
+        if spans:
+            end_offset = len(self)
+            self._spans[:] = [
+                span.extend(spaces) if span.end >= end_offset else span
+                for span in spans
+            ]
+            self._text.append(new_spaces)
+            self._length += spaces
+        else:
+            self.plain += new_spaces
+
+    def highlight_regex(
+        self,
+        re_highlight: Union[Pattern[str], str],
+        style: Optional[Union[GetStyleCallable, StyleType]] = None,
+        *,
+        style_prefix: str = "",
+    ) -> int:
+        """Highlight text with a regular expression, where group names are
+        translated to styles.
+
+        Args:
+            re_highlight (Union[re.Pattern, str]): A regular expression object or string.
+            style (Union[GetStyleCallable, StyleType]): Optional style to apply to whole match, or a callable
+                which accepts the matched text and returns a style. Defaults to None.
+            style_prefix (str, optional): Optional prefix to add to style group names.
+
+        Returns:
+            int: Number of regex matches
+        """
+        count = 0
+        append_span = self._spans.append
+        _Span = Span
+        plain = self.plain
+        if isinstance(re_highlight, str):
+            re_highlight = re.compile(re_highlight)
+        for match in re_highlight.finditer(plain):
+            get_span = match.span
+            if style:
+                start, end = get_span()
+                match_style = style(plain[start:end]) if callable(style) else style
+                if match_style is not None and end > start:
+                    append_span(_Span(start, end, match_style))
+
+            count += 1
+            for name in match.groupdict().keys():
+                start, end = get_span(name)
+                if start != -1 and end > start:
+                    append_span(_Span(start, end, f"{style_prefix}{name}"))
+        return count
+
+    def highlight_words(
+        self,
+        words: Iterable[str],
+        style: Union[str, Style],
+        *,
+        case_sensitive: bool = True,
+    ) -> int:
+        """Highlight words with a style.
+
+        Args:
+            words (Iterable[str]): Words to highlight.
+            style (Union[str, Style]): Style to apply.
+            case_sensitive (bool, optional): Enable case sensitive matching. Defaults to True.
+
+        Returns:
+            int: Number of words highlighted.
+        """
+        re_words = "|".join(re.escape(word) for word in words)
+        add_span = self._spans.append
+        count = 0
+        _Span = Span
+        for match in re.finditer(
+            re_words, self.plain, flags=0 if case_sensitive else re.IGNORECASE
+        ):
+            start, end = match.span(0)
+            add_span(_Span(start, end, style))
+            count += 1
+        return count
+
+    def rstrip(self) -> None:
+        """Strip whitespace from end of text."""
+        self.plain = self.plain.rstrip()
+
+    def rstrip_end(self, size: int) -> None:
+        """Remove whitespace beyond a certain width at the end of the text.
+
+        Args:
+            size (int): The desired size of the text.
+        """
+        text_length = len(self)
+        if text_length > size:
+            excess = text_length - size
+            whitespace_match = _re_whitespace.search(self.plain)
+            if whitespace_match is not None:
+                whitespace_count = len(whitespace_match.group(0))
+                self.right_crop(min(whitespace_count, excess))
+
+    def set_length(self, new_length: int) -> None:
+        """Set new length of the text, clipping or padding is required."""
+        length = len(self)
+        if length != new_length:
+            if length < new_length:
+                self.pad_right(new_length - length)
+            else:
+                self.right_crop(length - new_length)
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Iterable[Segment]:
+        tab_size: int = console.tab_size if self.tab_size is None else self.tab_size
+        justify = self.justify or options.justify or DEFAULT_JUSTIFY
+
+        overflow = self.overflow or options.overflow or DEFAULT_OVERFLOW
+
+        lines = self.wrap(
+            console,
+            options.max_width,
+            justify=justify,
+            overflow=overflow,
+            tab_size=tab_size or 8,
+            no_wrap=pick_bool(self.no_wrap, options.no_wrap, False),
+        )
+        all_lines = Text("\n").join(lines)
+        yield from all_lines.render(console, end=self.end)
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Measurement:
+        text = self.plain
+        lines = text.splitlines()
+        max_text_width = max(cell_len(line) for line in lines) if lines else 0
+        words = text.split()
+        min_text_width = (
+            max(cell_len(word) for word in words) if words else max_text_width
+        )
+        return Measurement(min_text_width, max_text_width)
+
+    def render(self, console: "Console", end: str = "") -> Iterable["Segment"]:
+        """Render the text as Segments.
+
+        Args:
+            console (Console): Console instance.
+            end (Optional[str], optional): Optional end character.
+
+        Returns:
+            Iterable[Segment]: Result of render that may be written to the console.
+        """
+        _Segment = Segment
+        text = self.plain
+        if not self._spans:
+            yield Segment(text)
+            if end:
+                yield _Segment(end)
+            return
+        get_style = partial(console.get_style, default=Style.null())
+
+        enumerated_spans = list(enumerate(self._spans, 1))
+        style_map = {index: get_style(span.style) for index, span in enumerated_spans}
+        style_map[0] = get_style(self.style)
+
+        spans = [
+            (0, False, 0),
+            *((span.start, False, index) for index, span in enumerated_spans),
+            *((span.end, True, index) for index, span in enumerated_spans),
+            (len(text), True, 0),
+        ]
+        spans.sort(key=itemgetter(0, 1))
+
+        stack: List[int] = []
+        stack_append = stack.append
+        stack_pop = stack.remove
+
+        style_cache: Dict[Tuple[Style, ...], Style] = {}
+        style_cache_get = style_cache.get
+        combine = Style.combine
+
+        def get_current_style() -> Style:
+            """Construct current style from stack."""
+            styles = tuple(style_map[_style_id] for _style_id in sorted(stack))
+            cached_style = style_cache_get(styles)
+            if cached_style is not None:
+                return cached_style
+            current_style = combine(styles)
+            style_cache[styles] = current_style
+            return current_style
+
+        for (offset, leaving, style_id), (next_offset, _, _) in zip(spans, spans[1:]):
+            if leaving:
+                stack_pop(style_id)
+            else:
+                stack_append(style_id)
+            if next_offset > offset:
+                yield _Segment(text[offset:next_offset], get_current_style())
+        if end:
+            yield _Segment(end)
+
+    def join(self, lines: Iterable["Text"]) -> "Text":
+        """Join text together with this instance as the separator.
+
+        Args:
+            lines (Iterable[Text]): An iterable of Text instances to join.
+
+        Returns:
+            Text: A new text instance containing join text.
+        """
+
+        new_text = self.blank_copy()
+
+        def iter_text() -> Iterable["Text"]:
+            if self.plain:
+                for last, line in loop_last(lines):
+                    yield line
+                    if not last:
+                        yield self
+            else:
+                yield from lines
+
+        extend_text = new_text._text.extend
+        append_span = new_text._spans.append
+        extend_spans = new_text._spans.extend
+        offset = 0
+        _Span = Span
+
+        for text in iter_text():
+            extend_text(text._text)
+            if text.style:
+                append_span(_Span(offset, offset + len(text), text.style))
+            extend_spans(
+                _Span(offset + start, offset + end, style)
+                for start, end, style in text._spans
+            )
+            offset += len(text)
+        new_text._length = offset
+        return new_text
+
+    def expand_tabs(self, tab_size: Optional[int] = None) -> None:
+        """Converts tabs to spaces.
+
+        Args:
+            tab_size (int, optional): Size of tabs. Defaults to 8.
+
+        """
+        if "\t" not in self.plain:
+            return
+        if tab_size is None:
+            tab_size = self.tab_size
+        if tab_size is None:
+            tab_size = 8
+
+        new_text: List[Text] = []
+        append = new_text.append
+
+        for line in self.split("\n", include_separator=True):
+            if "\t" not in line.plain:
+                append(line)
+            else:
+                cell_position = 0
+                parts = line.split("\t", include_separator=True)
+                for part in parts:
+                    if part.plain.endswith("\t"):
+                        part._text[-1] = part._text[-1][:-1] + " "
+                        cell_position += part.cell_len
+                        tab_remainder = cell_position % tab_size
+                        if tab_remainder:
+                            spaces = tab_size - tab_remainder
+                            part.extend_style(spaces)
+                            cell_position += spaces
+                    else:
+                        cell_position += part.cell_len
+                    append(part)
+
+        result = Text("").join(new_text)
+
+        self._text = [result.plain]
+        self._length = len(self.plain)
+        self._spans[:] = result._spans
+
+    def truncate(
+        self,
+        max_width: int,
+        *,
+        overflow: Optional["OverflowMethod"] = None,
+        pad: bool = False,
+    ) -> None:
+        """Truncate text if it is longer that a given width.
+
+        Args:
+            max_width (int): Maximum number of characters in text.
+            overflow (str, optional): Overflow method: "crop", "fold", or "ellipsis". Defaults to None, to use self.overflow.
+            pad (bool, optional): Pad with spaces if the length is less than max_width. Defaults to False.
+        """
+        _overflow = overflow or self.overflow or DEFAULT_OVERFLOW
+        if _overflow != "ignore":
+            length = cell_len(self.plain)
+            if length > max_width:
+                if _overflow == "ellipsis":
+                    self.plain = set_cell_size(self.plain, max_width - 1) + "…"
+                else:
+                    self.plain = set_cell_size(self.plain, max_width)
+            if pad and length < max_width:
+                spaces = max_width - length
+                self._text = [f"{self.plain}{' ' * spaces}"]
+                self._length = len(self.plain)
+
+    def _trim_spans(self) -> None:
+        """Remove or modify any spans that are over the end of the text."""
+        max_offset = len(self.plain)
+        _Span = Span
+        self._spans[:] = [
+            (
+                span
+                if span.end < max_offset
+                else _Span(span.start, min(max_offset, span.end), span.style)
+            )
+            for span in self._spans
+            if span.start < max_offset
+        ]
+
+    def pad(self, count: int, character: str = " ") -> None:
+        """Pad left and right with a given number of characters.
+
+        Args:
+            count (int): Width of padding.
+            character (str): The character to pad with. Must be a string of length 1.
+        """
+        assert len(character) == 1, "Character must be a string of length 1"
+        if count:
+            pad_characters = character * count
+            self.plain = f"{pad_characters}{self.plain}{pad_characters}"
+            _Span = Span
+            self._spans[:] = [
+                _Span(start + count, end + count, style)
+                for start, end, style in self._spans
+            ]
+
+    def pad_left(self, count: int, character: str = " ") -> None:
+        """Pad the left with a given character.
+
+        Args:
+            count (int): Number of characters to pad.
+            character (str, optional): Character to pad with. Defaults to " ".
+        """
+        assert len(character) == 1, "Character must be a string of length 1"
+        if count:
+            self.plain = f"{character * count}{self.plain}"
+            _Span = Span
+            self._spans[:] = [
+                _Span(start + count, end + count, style)
+                for start, end, style in self._spans
+            ]
+
+    def pad_right(self, count: int, character: str = " ") -> None:
+        """Pad the right with a given character.
+
+        Args:
+            count (int): Number of characters to pad.
+            character (str, optional): Character to pad with. Defaults to " ".
+        """
+        assert len(character) == 1, "Character must be a string of length 1"
+        if count:
+            self.plain = f"{self.plain}{character * count}"
+
+    def align(self, align: AlignMethod, width: int, character: str = " ") -> None:
+        """Align text to a given width.
+
+        Args:
+            align (AlignMethod): One of "left", "center", or "right".
+            width (int): Desired width.
+            character (str, optional): Character to pad with. Defaults to " ".
+        """
+        self.truncate(width)
+        excess_space = width - cell_len(self.plain)
+        if excess_space:
+            if align == "left":
+                self.pad_right(excess_space, character)
+            elif align == "center":
+                left = excess_space // 2
+                self.pad_left(left, character)
+                self.pad_right(excess_space - left, character)
+            else:
+                self.pad_left(excess_space, character)
+
+    def append(
+        self, text: Union["Text", str], style: Optional[Union[str, "Style"]] = None
+    ) -> "Text":
+        """Add text with an optional style.
+
+        Args:
+            text (Union[Text, str]): A str or Text to append.
+            style (str, optional): A style name. Defaults to None.
+
+        Returns:
+            Text: Returns self for chaining.
+        """
+
+        if not isinstance(text, (str, Text)):
+            raise TypeError("Only str or Text can be appended to Text")
+
+        if len(text):
+            if isinstance(text, str):
+                sanitized_text = strip_control_codes(text)
+                self._text.append(sanitized_text)
+                offset = len(self)
+                text_length = len(sanitized_text)
+                if style:
+                    self._spans.append(Span(offset, offset + text_length, style))
+                self._length += text_length
+            elif isinstance(text, Text):
+                _Span = Span
+                if style is not None:
+                    raise ValueError(
+                        "style must not be set when appending Text instance"
+                    )
+                text_length = self._length
+                if text.style:
+                    self._spans.append(
+                        _Span(text_length, text_length + len(text), text.style)
+                    )
+                self._text.append(text.plain)
+                self._spans.extend(
+                    _Span(start + text_length, end + text_length, style)
+                    for start, end, style in text._spans.copy()
+                )
+                self._length += len(text)
+        return self
+
+    def append_text(self, text: "Text") -> "Text":
+        """Append another Text instance. This method is more performant that Text.append, but
+        only works for Text.
+
+        Args:
+            text (Text): The Text instance to append to this instance.
+
+        Returns:
+            Text: Returns self for chaining.
+        """
+        _Span = Span
+        text_length = self._length
+        if text.style:
+            self._spans.append(_Span(text_length, text_length + len(text), text.style))
+        self._text.append(text.plain)
+        self._spans.extend(
+            _Span(start + text_length, end + text_length, style)
+            for start, end, style in text._spans.copy()
+        )
+        self._length += len(text)
+        return self
+
+    def append_tokens(
+        self, tokens: Iterable[Tuple[str, Optional[StyleType]]]
+    ) -> "Text":
+        """Append iterable of str and style. Style may be a Style instance or a str style definition.
+
+        Args:
+            tokens (Iterable[Tuple[str, Optional[StyleType]]]): An iterable of tuples containing str content and style.
+
+        Returns:
+            Text: Returns self for chaining.
+        """
+        append_text = self._text.append
+        append_span = self._spans.append
+        _Span = Span
+        offset = len(self)
+        for content, style in tokens:
+            content = strip_control_codes(content)
+            append_text(content)
+            if style:
+                append_span(_Span(offset, offset + len(content), style))
+            offset += len(content)
+        self._length = offset
+        return self
+
+    def copy_styles(self, text: "Text") -> None:
+        """Copy styles from another Text instance.
+
+        Args:
+            text (Text): A Text instance to copy styles from, must be the same length.
+        """
+        self._spans.extend(text._spans)
+
+    def split(
+        self,
+        separator: str = "\n",
+        *,
+        include_separator: bool = False,
+        allow_blank: bool = False,
+    ) -> Lines:
+        """Split rich text in to lines, preserving styles.
+
+        Args:
+            separator (str, optional): String to split on. Defaults to "\\\\n".
+            include_separator (bool, optional): Include the separator in the lines. Defaults to False.
+            allow_blank (bool, optional): Return a blank line if the text ends with a separator. Defaults to False.
+
+        Returns:
+            List[RichText]: A list of rich text, one per line of the original.
+        """
+        assert separator, "separator must not be empty"
+
+        text = self.plain
+        if separator not in text:
+            return Lines([self.copy()])
+
+        if include_separator:
+            lines = self.divide(
+                match.end() for match in re.finditer(re.escape(separator), text)
+            )
+        else:
+
+            def flatten_spans() -> Iterable[int]:
+                for match in re.finditer(re.escape(separator), text):
+                    start, end = match.span()
+                    yield start
+                    yield end
+
+            lines = Lines(
+                line for line in self.divide(flatten_spans()) if line.plain != separator
+            )
+
+        if not allow_blank and text.endswith(separator):
+            lines.pop()
+
+        return lines
+
+    def divide(self, offsets: Iterable[int]) -> Lines:
+        """Divide text in to a number of lines at given offsets.
+
+        Args:
+            offsets (Iterable[int]): Offsets used to divide text.
+
+        Returns:
+            Lines: New RichText instances between offsets.
+        """
+        _offsets = list(offsets)
+
+        if not _offsets:
+            return Lines([self.copy()])
+
+        text = self.plain
+        text_length = len(text)
+        divide_offsets = [0, *_offsets, text_length]
+        line_ranges = list(zip(divide_offsets, divide_offsets[1:]))
+
+        style = self.style
+        justify = self.justify
+        overflow = self.overflow
+        _Text = Text
+        new_lines = Lines(
+            _Text(
+                text[start:end],
+                style=style,
+                justify=justify,
+                overflow=overflow,
+            )
+            for start, end in line_ranges
+        )
+        if not self._spans:
+            return new_lines
+
+        _line_appends = [line._spans.append for line in new_lines._lines]
+        line_count = len(line_ranges)
+        _Span = Span
+
+        for span_start, span_end, style in self._spans:
+            lower_bound = 0
+            upper_bound = line_count
+            start_line_no = (lower_bound + upper_bound) // 2
+
+            while True:
+                line_start, line_end = line_ranges[start_line_no]
+                if span_start < line_start:
+                    upper_bound = start_line_no - 1
+                elif span_start > line_end:
+                    lower_bound = start_line_no + 1
+                else:
+                    break
+                start_line_no = (lower_bound + upper_bound) // 2
+
+            if span_end < line_end:
+                end_line_no = start_line_no
+            else:
+                end_line_no = lower_bound = start_line_no
+                upper_bound = line_count
+
+                while True:
+                    line_start, line_end = line_ranges[end_line_no]
+                    if span_end < line_start:
+                        upper_bound = end_line_no - 1
+                    elif span_end > line_end:
+                        lower_bound = end_line_no + 1
+                    else:
+                        break
+                    end_line_no = (lower_bound + upper_bound) // 2
+
+            for line_no in range(start_line_no, end_line_no + 1):
+                line_start, line_end = line_ranges[line_no]
+                new_start = max(0, span_start - line_start)
+                new_end = min(span_end - line_start, line_end - line_start)
+                if new_end > new_start:
+                    _line_appends[line_no](_Span(new_start, new_end, style))
+
+        return new_lines
+
+    def right_crop(self, amount: int = 1) -> None:
+        """Remove a number of characters from the end of the text."""
+        max_offset = len(self.plain) - amount
+        _Span = Span
+        self._spans[:] = [
+            (
+                span
+                if span.end < max_offset
+                else _Span(span.start, min(max_offset, span.end), span.style)
+            )
+            for span in self._spans
+            if span.start < max_offset
+        ]
+        self._text = [self.plain[:-amount]]
+        self._length -= amount
+
+    def wrap(
+        self,
+        console: "Console",
+        width: int,
+        *,
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+        tab_size: int = 8,
+        no_wrap: Optional[bool] = None,
+    ) -> Lines:
+        """Word wrap the text.
+
+        Args:
+            console (Console): Console instance.
+            width (int): Number of cells available per line.
+            justify (str, optional): Justify method: "default", "left", "center", "full", "right". Defaults to "default".
+            overflow (str, optional): Overflow method: "crop", "fold", or "ellipsis". Defaults to None.
+            tab_size (int, optional): Default tab size. Defaults to 8.
+            no_wrap (bool, optional): Disable wrapping, Defaults to False.
+
+        Returns:
+            Lines: Number of lines.
+        """
+        wrap_justify = justify or self.justify or DEFAULT_JUSTIFY
+        wrap_overflow = overflow or self.overflow or DEFAULT_OVERFLOW
+
+        no_wrap = pick_bool(no_wrap, self.no_wrap, False) or overflow == "ignore"
+
+        lines = Lines()
+        for line in self.split(allow_blank=True):
+            if "\t" in line:
+                line.expand_tabs(tab_size)
+            if no_wrap:
+                new_lines = Lines([line])
+            else:
+                offsets = divide_line(str(line), width, fold=wrap_overflow == "fold")
+                new_lines = line.divide(offsets)
+            for line in new_lines:
+                line.rstrip_end(width)
+            if wrap_justify:
+                new_lines.justify(
+                    console, width, justify=wrap_justify, overflow=wrap_overflow
+                )
+            for line in new_lines:
+                line.truncate(width, overflow=wrap_overflow)
+            lines.extend(new_lines)
+        return lines
+
+    def fit(self, width: int) -> Lines:
+        """Fit the text in to given width by chopping in to lines.
+
+        Args:
+            width (int): Maximum characters in a line.
+
+        Returns:
+            Lines: Lines container.
+        """
+        lines: Lines = Lines()
+        append = lines.append
+        for line in self.split():
+            line.set_length(width)
+            append(line)
+        return lines
+
+    def detect_indentation(self) -> int:
+        """Auto-detect indentation of code.
+
+        Returns:
+            int: Number of spaces used to indent code.
+        """
+
+        _indentations = {
+            len(match.group(1))
+            for match in re.finditer(r"^( *)(.*)$", self.plain, flags=re.MULTILINE)
+        }
+
+        try:
+            indentation = (
+                reduce(gcd, [indent for indent in _indentations if not indent % 2]) or 1
+            )
+        except TypeError:
+            indentation = 1
+
+        return indentation
+
+    def with_indent_guides(
+        self,
+        indent_size: Optional[int] = None,
+        *,
+        character: str = "│",
+        style: StyleType = "dim green",
+    ) -> "Text":
+        """Adds indent guide lines to text.
+
+        Args:
+            indent_size (Optional[int]): Size of indentation, or None to auto detect. Defaults to None.
+            character (str, optional): Character to use for indentation. Defaults to "│".
+            style (Union[Style, str], optional): Style of indent guides.
+
+        Returns:
+            Text: New text with indentation guides.
+        """
+
+        _indent_size = self.detect_indentation() if indent_size is None else indent_size
+
+        text = self.copy()
+        text.expand_tabs()
+        indent_line = f"{character}{' ' * (_indent_size - 1)}"
+
+        re_indent = re.compile(r"^( *)(.*)$")
+        new_lines: List[Text] = []
+        add_line = new_lines.append
+        blank_lines = 0
+        for line in text.split(allow_blank=True):
+            match = re_indent.match(line.plain)
+            if not match or not match.group(2):
+                blank_lines += 1
+                continue
+            indent = match.group(1)
+            full_indents, remaining_space = divmod(len(indent), _indent_size)
+            new_indent = f"{indent_line * full_indents}{' ' * remaining_space}"
+            line.plain = new_indent + line.plain[len(new_indent) :]
+            line.stylize(style, 0, len(new_indent))
+            if blank_lines:
+                new_lines.extend([Text(new_indent, style=style)] * blank_lines)
+                blank_lines = 0
+            add_line(line)
+        if blank_lines:
+            new_lines.extend([Text("", style=style)] * blank_lines)
+
+        new_text = text.blank_copy("\n").join(new_lines)
+        return new_text
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Console
+
+    text = Text(
+        """\nLorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.\n"""
+    )
+    text.highlight_words(["Lorem"], "bold")
+    text.highlight_words(["ipsum"], "italic")
+
+    console = Console()
+
+    console.rule("justify='left'")
+    console.print(text, style="red")
+    console.print()
+
+    console.rule("justify='center'")
+    console.print(text, style="green", justify="center")
+    console.print()
+
+    console.rule("justify='right'")
+    console.print(text, style="blue", justify="right")
+    console.print()
+
+    console.rule("justify='full'")
+    console.print(text, style="magenta", justify="full")
+    console.print()
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/theme.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/theme.py
new file mode 100644
index 0000000..227f1d8
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/theme.py
@@ -0,0 +1,115 @@
+import configparser
+from typing import IO, Dict, List, Mapping, Optional
+
+from .default_styles import DEFAULT_STYLES
+from .style import Style, StyleType
+
+
+class Theme:
+    """A container for style information, used by :class:`~rich.console.Console`.
+
+    Args:
+        styles (Dict[str, Style], optional): A mapping of style names on to styles. Defaults to None for a theme with no styles.
+        inherit (bool, optional): Inherit default styles. Defaults to True.
+    """
+
+    styles: Dict[str, Style]
+
+    def __init__(
+        self, styles: Optional[Mapping[str, StyleType]] = None, inherit: bool = True
+    ):
+        self.styles = DEFAULT_STYLES.copy() if inherit else {}
+        if styles is not None:
+            self.styles.update(
+                {
+                    name: style if isinstance(style, Style) else Style.parse(style)
+                    for name, style in styles.items()
+                }
+            )
+
+    @property
+    def config(self) -> str:
+        """Get contents of a config file for this theme."""
+        config = "[styles]\n" + "\n".join(
+            f"{name} = {style}" for name, style in sorted(self.styles.items())
+        )
+        return config
+
+    @classmethod
+    def from_file(
+        cls, config_file: IO[str], source: Optional[str] = None, inherit: bool = True
+    ) -> "Theme":
+        """Load a theme from a text mode file.
+
+        Args:
+            config_file (IO[str]): An open conf file.
+            source (str, optional): The filename of the open file. Defaults to None.
+            inherit (bool, optional): Inherit default styles. Defaults to True.
+
+        Returns:
+            Theme: A New theme instance.
+        """
+        config = configparser.ConfigParser()
+        config.read_file(config_file, source=source)
+        styles = {name: Style.parse(value) for name, value in config.items("styles")}
+        theme = Theme(styles, inherit=inherit)
+        return theme
+
+    @classmethod
+    def read(
+        cls, path: str, inherit: bool = True, encoding: Optional[str] = None
+    ) -> "Theme":
+        """Read a theme from a path.
+
+        Args:
+            path (str): Path to a config file readable by Python configparser module.
+            inherit (bool, optional): Inherit default styles. Defaults to True.
+            encoding (str, optional): Encoding of the config file. Defaults to None.
+
+        Returns:
+            Theme: A new theme instance.
+        """
+        with open(path, encoding=encoding) as config_file:
+            return cls.from_file(config_file, source=path, inherit=inherit)
+
+
+class ThemeStackError(Exception):
+    """Base exception for errors related to the theme stack."""
+
+
+class ThemeStack:
+    """A stack of themes.
+
+    Args:
+        theme (Theme): A theme instance
+    """
+
+    def __init__(self, theme: Theme) -> None:
+        self._entries: List[Dict[str, Style]] = [theme.styles]
+        self.get = self._entries[-1].get
+
+    def push_theme(self, theme: Theme, inherit: bool = True) -> None:
+        """Push a theme on the top of the stack.
+
+        Args:
+            theme (Theme): A Theme instance.
+            inherit (boolean, optional): Inherit styles from current top of stack.
+        """
+        styles: Dict[str, Style]
+        styles = (
+            {**self._entries[-1], **theme.styles} if inherit else theme.styles.copy()
+        )
+        self._entries.append(styles)
+        self.get = self._entries[-1].get
+
+    def pop_theme(self) -> None:
+        """Pop (and discard) the top-most theme."""
+        if len(self._entries) == 1:
+            raise ThemeStackError("Unable to pop base theme")
+        self._entries.pop()
+        self.get = self._entries[-1].get
+
+
+if __name__ == "__main__":  # pragma: no cover
+    theme = Theme()
+    print(theme.config)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/themes.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/themes.py
new file mode 100644
index 0000000..bf6db10
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/themes.py
@@ -0,0 +1,5 @@
+from .default_styles import DEFAULT_STYLES
+from .theme import Theme
+
+
+DEFAULT = Theme(DEFAULT_STYLES)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/traceback.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/traceback.py
new file mode 100644
index 0000000..28d742b
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/traceback.py
@@ -0,0 +1,797 @@
+import inspect
+import linecache
+import os
+import sys
+from dataclasses import dataclass, field
+from itertools import islice
+from traceback import walk_tb
+from types import ModuleType, TracebackType
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+)
+
+from pip._vendor.pygments.lexers import guess_lexer_for_filename
+from pip._vendor.pygments.token import Comment, Keyword, Name, Number, Operator, String
+from pip._vendor.pygments.token import Text as TextToken
+from pip._vendor.pygments.token import Token
+from pip._vendor.pygments.util import ClassNotFound
+
+from . import pretty
+from ._loop import loop_last
+from .columns import Columns
+from .console import Console, ConsoleOptions, ConsoleRenderable, RenderResult, group
+from .constrain import Constrain
+from .highlighter import RegexHighlighter, ReprHighlighter
+from .panel import Panel
+from .scope import render_scope
+from .style import Style
+from .syntax import Syntax
+from .text import Text
+from .theme import Theme
+
+WINDOWS = sys.platform == "win32"
+
+LOCALS_MAX_LENGTH = 10
+LOCALS_MAX_STRING = 80
+
+
+def install(
+    *,
+    console: Optional[Console] = None,
+    width: Optional[int] = 100,
+    code_width: Optional[int] = 88,
+    extra_lines: int = 3,
+    theme: Optional[str] = None,
+    word_wrap: bool = False,
+    show_locals: bool = False,
+    locals_max_length: int = LOCALS_MAX_LENGTH,
+    locals_max_string: int = LOCALS_MAX_STRING,
+    locals_hide_dunder: bool = True,
+    locals_hide_sunder: Optional[bool] = None,
+    indent_guides: bool = True,
+    suppress: Iterable[Union[str, ModuleType]] = (),
+    max_frames: int = 100,
+) -> Callable[[Type[BaseException], BaseException, Optional[TracebackType]], Any]:
+    """Install a rich traceback handler.
+
+    Once installed, any tracebacks will be printed with syntax highlighting and rich formatting.
+
+
+    Args:
+        console (Optional[Console], optional): Console to write exception to. Default uses internal Console instance.
+        width (Optional[int], optional): Width (in characters) of traceback. Defaults to 100.
+        code_width (Optional[int], optional): Code width (in characters) of traceback. Defaults to 88.
+        extra_lines (int, optional): Extra lines of code. Defaults to 3.
+        theme (Optional[str], optional): Pygments theme to use in traceback. Defaults to ``None`` which will pick
+            a theme appropriate for the platform.
+        word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False.
+        show_locals (bool, optional): Enable display of local variables. Defaults to False.
+        locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to 10.
+        locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+        locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
+        locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
+        indent_guides (bool, optional): Enable indent guides in code and locals. Defaults to True.
+        suppress (Sequence[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
+
+    Returns:
+        Callable: The previous exception handler that was replaced.
+
+    """
+    traceback_console = Console(stderr=True) if console is None else console
+
+    locals_hide_sunder = (
+        True
+        if (traceback_console.is_jupyter and locals_hide_sunder is None)
+        else locals_hide_sunder
+    )
+
+    def excepthook(
+        type_: Type[BaseException],
+        value: BaseException,
+        traceback: Optional[TracebackType],
+    ) -> None:
+        traceback_console.print(
+            Traceback.from_exception(
+                type_,
+                value,
+                traceback,
+                width=width,
+                code_width=code_width,
+                extra_lines=extra_lines,
+                theme=theme,
+                word_wrap=word_wrap,
+                show_locals=show_locals,
+                locals_max_length=locals_max_length,
+                locals_max_string=locals_max_string,
+                locals_hide_dunder=locals_hide_dunder,
+                locals_hide_sunder=bool(locals_hide_sunder),
+                indent_guides=indent_guides,
+                suppress=suppress,
+                max_frames=max_frames,
+            )
+        )
+
+    def ipy_excepthook_closure(ip: Any) -> None:  # pragma: no cover
+        tb_data = {}  # store information about showtraceback call
+        default_showtraceback = ip.showtraceback  # keep reference of default traceback
+
+        def ipy_show_traceback(*args: Any, **kwargs: Any) -> None:
+            """wrap the default ip.showtraceback to store info for ip._showtraceback"""
+            nonlocal tb_data
+            tb_data = kwargs
+            default_showtraceback(*args, **kwargs)
+
+        def ipy_display_traceback(
+            *args: Any, is_syntax: bool = False, **kwargs: Any
+        ) -> None:
+            """Internally called traceback from ip._showtraceback"""
+            nonlocal tb_data
+            exc_tuple = ip._get_exc_info()
+
+            # do not display trace on syntax error
+            tb: Optional[TracebackType] = None if is_syntax else exc_tuple[2]
+
+            # determine correct tb_offset
+            compiled = tb_data.get("running_compiled_code", False)
+            tb_offset = tb_data.get("tb_offset", 1 if compiled else 0)
+            # remove ipython internal frames from trace with tb_offset
+            for _ in range(tb_offset):
+                if tb is None:
+                    break
+                tb = tb.tb_next
+
+            excepthook(exc_tuple[0], exc_tuple[1], tb)
+            tb_data = {}  # clear data upon usage
+
+        # replace _showtraceback instead of showtraceback to allow ipython features such as debugging to work
+        # this is also what the ipython docs recommends to modify when subclassing InteractiveShell
+        ip._showtraceback = ipy_display_traceback
+        # add wrapper to capture tb_data
+        ip.showtraceback = ipy_show_traceback
+        ip.showsyntaxerror = lambda *args, **kwargs: ipy_display_traceback(
+            *args, is_syntax=True, **kwargs
+        )
+
+    try:  # pragma: no cover
+        # if within ipython, use customized traceback
+        ip = get_ipython()  # type: ignore[name-defined]
+        ipy_excepthook_closure(ip)
+        return sys.excepthook
+    except Exception:
+        # otherwise use default system hook
+        old_excepthook = sys.excepthook
+        sys.excepthook = excepthook
+        return old_excepthook
+
+
+@dataclass
+class Frame:
+    filename: str
+    lineno: int
+    name: str
+    line: str = ""
+    locals: Optional[Dict[str, pretty.Node]] = None
+    last_instruction: Optional[Tuple[Tuple[int, int], Tuple[int, int]]] = None
+
+
+@dataclass
+class _SyntaxError:
+    offset: int
+    filename: str
+    line: str
+    lineno: int
+    msg: str
+
+
+@dataclass
+class Stack:
+    exc_type: str
+    exc_value: str
+    syntax_error: Optional[_SyntaxError] = None
+    is_cause: bool = False
+    frames: List[Frame] = field(default_factory=list)
+
+
+@dataclass
+class Trace:
+    stacks: List[Stack]
+
+
+class PathHighlighter(RegexHighlighter):
+    highlights = [r"(?P.*/)(?P.+)"]
+
+
+class Traceback:
+    """A Console renderable that renders a traceback.
+
+    Args:
+        trace (Trace, optional): A `Trace` object produced from `extract`. Defaults to None, which uses
+            the last exception.
+        width (Optional[int], optional): Number of characters used to traceback. Defaults to 100.
+        code_width (Optional[int], optional): Number of code characters used to traceback. Defaults to 88.
+        extra_lines (int, optional): Additional lines of code to render. Defaults to 3.
+        theme (str, optional): Override pygments theme used in traceback.
+        word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False.
+        show_locals (bool, optional): Enable display of local variables. Defaults to False.
+        indent_guides (bool, optional): Enable indent guides in code and locals. Defaults to True.
+        locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to 10.
+        locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+        locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
+        locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
+        suppress (Sequence[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
+        max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
+
+    """
+
+    LEXERS = {
+        "": "text",
+        ".py": "python",
+        ".pxd": "cython",
+        ".pyx": "cython",
+        ".pxi": "pyrex",
+    }
+
+    def __init__(
+        self,
+        trace: Optional[Trace] = None,
+        *,
+        width: Optional[int] = 100,
+        code_width: Optional[int] = 88,
+        extra_lines: int = 3,
+        theme: Optional[str] = None,
+        word_wrap: bool = False,
+        show_locals: bool = False,
+        locals_max_length: int = LOCALS_MAX_LENGTH,
+        locals_max_string: int = LOCALS_MAX_STRING,
+        locals_hide_dunder: bool = True,
+        locals_hide_sunder: bool = False,
+        indent_guides: bool = True,
+        suppress: Iterable[Union[str, ModuleType]] = (),
+        max_frames: int = 100,
+    ):
+        if trace is None:
+            exc_type, exc_value, traceback = sys.exc_info()
+            if exc_type is None or exc_value is None or traceback is None:
+                raise ValueError(
+                    "Value for 'trace' required if not called in except: block"
+                )
+            trace = self.extract(
+                exc_type, exc_value, traceback, show_locals=show_locals
+            )
+        self.trace = trace
+        self.width = width
+        self.code_width = code_width
+        self.extra_lines = extra_lines
+        self.theme = Syntax.get_theme(theme or "ansi_dark")
+        self.word_wrap = word_wrap
+        self.show_locals = show_locals
+        self.indent_guides = indent_guides
+        self.locals_max_length = locals_max_length
+        self.locals_max_string = locals_max_string
+        self.locals_hide_dunder = locals_hide_dunder
+        self.locals_hide_sunder = locals_hide_sunder
+
+        self.suppress: Sequence[str] = []
+        for suppress_entity in suppress:
+            if not isinstance(suppress_entity, str):
+                assert (
+                    suppress_entity.__file__ is not None
+                ), f"{suppress_entity!r} must be a module with '__file__' attribute"
+                path = os.path.dirname(suppress_entity.__file__)
+            else:
+                path = suppress_entity
+            path = os.path.normpath(os.path.abspath(path))
+            self.suppress.append(path)
+        self.max_frames = max(4, max_frames) if max_frames > 0 else 0
+
+    @classmethod
+    def from_exception(
+        cls,
+        exc_type: Type[Any],
+        exc_value: BaseException,
+        traceback: Optional[TracebackType],
+        *,
+        width: Optional[int] = 100,
+        code_width: Optional[int] = 88,
+        extra_lines: int = 3,
+        theme: Optional[str] = None,
+        word_wrap: bool = False,
+        show_locals: bool = False,
+        locals_max_length: int = LOCALS_MAX_LENGTH,
+        locals_max_string: int = LOCALS_MAX_STRING,
+        locals_hide_dunder: bool = True,
+        locals_hide_sunder: bool = False,
+        indent_guides: bool = True,
+        suppress: Iterable[Union[str, ModuleType]] = (),
+        max_frames: int = 100,
+    ) -> "Traceback":
+        """Create a traceback from exception info
+
+        Args:
+            exc_type (Type[BaseException]): Exception type.
+            exc_value (BaseException): Exception value.
+            traceback (TracebackType): Python Traceback object.
+            width (Optional[int], optional): Number of characters used to traceback. Defaults to 100.
+            code_width (Optional[int], optional): Number of code characters used to traceback. Defaults to 88.
+            extra_lines (int, optional): Additional lines of code to render. Defaults to 3.
+            theme (str, optional): Override pygments theme used in traceback.
+            word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False.
+            show_locals (bool, optional): Enable display of local variables. Defaults to False.
+            indent_guides (bool, optional): Enable indent guides in code and locals. Defaults to True.
+            locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+                Defaults to 10.
+            locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+            locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
+            locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
+            suppress (Iterable[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
+            max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
+
+        Returns:
+            Traceback: A Traceback instance that may be printed.
+        """
+        rich_traceback = cls.extract(
+            exc_type,
+            exc_value,
+            traceback,
+            show_locals=show_locals,
+            locals_max_length=locals_max_length,
+            locals_max_string=locals_max_string,
+            locals_hide_dunder=locals_hide_dunder,
+            locals_hide_sunder=locals_hide_sunder,
+        )
+
+        return cls(
+            rich_traceback,
+            width=width,
+            code_width=code_width,
+            extra_lines=extra_lines,
+            theme=theme,
+            word_wrap=word_wrap,
+            show_locals=show_locals,
+            indent_guides=indent_guides,
+            locals_max_length=locals_max_length,
+            locals_max_string=locals_max_string,
+            locals_hide_dunder=locals_hide_dunder,
+            locals_hide_sunder=locals_hide_sunder,
+            suppress=suppress,
+            max_frames=max_frames,
+        )
+
+    @classmethod
+    def extract(
+        cls,
+        exc_type: Type[BaseException],
+        exc_value: BaseException,
+        traceback: Optional[TracebackType],
+        *,
+        show_locals: bool = False,
+        locals_max_length: int = LOCALS_MAX_LENGTH,
+        locals_max_string: int = LOCALS_MAX_STRING,
+        locals_hide_dunder: bool = True,
+        locals_hide_sunder: bool = False,
+    ) -> Trace:
+        """Extract traceback information.
+
+        Args:
+            exc_type (Type[BaseException]): Exception type.
+            exc_value (BaseException): Exception value.
+            traceback (TracebackType): Python Traceback object.
+            show_locals (bool, optional): Enable display of local variables. Defaults to False.
+            locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+                Defaults to 10.
+            locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+            locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
+            locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
+
+        Returns:
+            Trace: A Trace instance which you can use to construct a `Traceback`.
+        """
+
+        stacks: List[Stack] = []
+        is_cause = False
+
+        from pip._vendor.rich import _IMPORT_CWD
+
+        def safe_str(_object: Any) -> str:
+            """Don't allow exceptions from __str__ to propagate."""
+            try:
+                return str(_object)
+            except Exception:
+                return ""
+
+        while True:
+            stack = Stack(
+                exc_type=safe_str(exc_type.__name__),
+                exc_value=safe_str(exc_value),
+                is_cause=is_cause,
+            )
+
+            if isinstance(exc_value, SyntaxError):
+                stack.syntax_error = _SyntaxError(
+                    offset=exc_value.offset or 0,
+                    filename=exc_value.filename or "?",
+                    lineno=exc_value.lineno or 0,
+                    line=exc_value.text or "",
+                    msg=exc_value.msg,
+                )
+
+            stacks.append(stack)
+            append = stack.frames.append
+
+            def get_locals(
+                iter_locals: Iterable[Tuple[str, object]]
+            ) -> Iterable[Tuple[str, object]]:
+                """Extract locals from an iterator of key pairs."""
+                if not (locals_hide_dunder or locals_hide_sunder):
+                    yield from iter_locals
+                    return
+                for key, value in iter_locals:
+                    if locals_hide_dunder and key.startswith("__"):
+                        continue
+                    if locals_hide_sunder and key.startswith("_"):
+                        continue
+                    yield key, value
+
+            for frame_summary, line_no in walk_tb(traceback):
+                filename = frame_summary.f_code.co_filename
+
+                last_instruction: Optional[Tuple[Tuple[int, int], Tuple[int, int]]]
+                last_instruction = None
+                if sys.version_info >= (3, 11):
+                    instruction_index = frame_summary.f_lasti // 2
+                    instruction_position = next(
+                        islice(
+                            frame_summary.f_code.co_positions(),
+                            instruction_index,
+                            instruction_index + 1,
+                        )
+                    )
+                    (
+                        start_line,
+                        end_line,
+                        start_column,
+                        end_column,
+                    ) = instruction_position
+                    if (
+                        start_line is not None
+                        and end_line is not None
+                        and start_column is not None
+                        and end_column is not None
+                    ):
+                        last_instruction = (
+                            (start_line, start_column),
+                            (end_line, end_column),
+                        )
+
+                if filename and not filename.startswith("<"):
+                    if not os.path.isabs(filename):
+                        filename = os.path.join(_IMPORT_CWD, filename)
+                if frame_summary.f_locals.get("_rich_traceback_omit", False):
+                    continue
+
+                frame = Frame(
+                    filename=filename or "?",
+                    lineno=line_no,
+                    name=frame_summary.f_code.co_name,
+                    locals=(
+                        {
+                            key: pretty.traverse(
+                                value,
+                                max_length=locals_max_length,
+                                max_string=locals_max_string,
+                            )
+                            for key, value in get_locals(frame_summary.f_locals.items())
+                            if not (inspect.isfunction(value) or inspect.isclass(value))
+                        }
+                        if show_locals
+                        else None
+                    ),
+                    last_instruction=last_instruction,
+                )
+                append(frame)
+                if frame_summary.f_locals.get("_rich_traceback_guard", False):
+                    del stack.frames[:]
+
+            cause = getattr(exc_value, "__cause__", None)
+            if cause:
+                exc_type = cause.__class__
+                exc_value = cause
+                # __traceback__ can be None, e.g. for exceptions raised by the
+                # 'multiprocessing' module
+                traceback = cause.__traceback__
+                is_cause = True
+                continue
+
+            cause = exc_value.__context__
+            if cause and not getattr(exc_value, "__suppress_context__", False):
+                exc_type = cause.__class__
+                exc_value = cause
+                traceback = cause.__traceback__
+                is_cause = False
+                continue
+            # No cover, code is reached but coverage doesn't recognize it.
+            break  # pragma: no cover
+
+        trace = Trace(stacks=stacks)
+        return trace
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        theme = self.theme
+        background_style = theme.get_background_style()
+        token_style = theme.get_style_for_token
+
+        traceback_theme = Theme(
+            {
+                "pretty": token_style(TextToken),
+                "pygments.text": token_style(Token),
+                "pygments.string": token_style(String),
+                "pygments.function": token_style(Name.Function),
+                "pygments.number": token_style(Number),
+                "repr.indent": token_style(Comment) + Style(dim=True),
+                "repr.str": token_style(String),
+                "repr.brace": token_style(TextToken) + Style(bold=True),
+                "repr.number": token_style(Number),
+                "repr.bool_true": token_style(Keyword.Constant),
+                "repr.bool_false": token_style(Keyword.Constant),
+                "repr.none": token_style(Keyword.Constant),
+                "scope.border": token_style(String.Delimiter),
+                "scope.equals": token_style(Operator),
+                "scope.key": token_style(Name),
+                "scope.key.special": token_style(Name.Constant) + Style(dim=True),
+            },
+            inherit=False,
+        )
+
+        highlighter = ReprHighlighter()
+        for last, stack in loop_last(reversed(self.trace.stacks)):
+            if stack.frames:
+                stack_renderable: ConsoleRenderable = Panel(
+                    self._render_stack(stack),
+                    title="[traceback.title]Traceback [dim](most recent call last)",
+                    style=background_style,
+                    border_style="traceback.border",
+                    expand=True,
+                    padding=(0, 1),
+                )
+                stack_renderable = Constrain(stack_renderable, self.width)
+                with console.use_theme(traceback_theme):
+                    yield stack_renderable
+            if stack.syntax_error is not None:
+                with console.use_theme(traceback_theme):
+                    yield Constrain(
+                        Panel(
+                            self._render_syntax_error(stack.syntax_error),
+                            style=background_style,
+                            border_style="traceback.border.syntax_error",
+                            expand=True,
+                            padding=(0, 1),
+                            width=self.width,
+                        ),
+                        self.width,
+                    )
+                yield Text.assemble(
+                    (f"{stack.exc_type}: ", "traceback.exc_type"),
+                    highlighter(stack.syntax_error.msg),
+                )
+            elif stack.exc_value:
+                yield Text.assemble(
+                    (f"{stack.exc_type}: ", "traceback.exc_type"),
+                    highlighter(stack.exc_value),
+                )
+            else:
+                yield Text.assemble((f"{stack.exc_type}", "traceback.exc_type"))
+
+            if not last:
+                if stack.is_cause:
+                    yield Text.from_markup(
+                        "\n[i]The above exception was the direct cause of the following exception:\n",
+                    )
+                else:
+                    yield Text.from_markup(
+                        "\n[i]During handling of the above exception, another exception occurred:\n",
+                    )
+
+    @group()
+    def _render_syntax_error(self, syntax_error: _SyntaxError) -> RenderResult:
+        highlighter = ReprHighlighter()
+        path_highlighter = PathHighlighter()
+        if syntax_error.filename != "":
+            if os.path.exists(syntax_error.filename):
+                text = Text.assemble(
+                    (f" {syntax_error.filename}", "pygments.string"),
+                    (":", "pygments.text"),
+                    (str(syntax_error.lineno), "pygments.number"),
+                    style="pygments.text",
+                )
+                yield path_highlighter(text)
+        syntax_error_text = highlighter(syntax_error.line.rstrip())
+        syntax_error_text.no_wrap = True
+        offset = min(syntax_error.offset - 1, len(syntax_error_text))
+        syntax_error_text.stylize("bold underline", offset, offset)
+        syntax_error_text += Text.from_markup(
+            "\n" + " " * offset + "[traceback.offset]▲[/]",
+            style="pygments.text",
+        )
+        yield syntax_error_text
+
+    @classmethod
+    def _guess_lexer(cls, filename: str, code: str) -> str:
+        ext = os.path.splitext(filename)[-1]
+        if not ext:
+            # No extension, look at first line to see if it is a hashbang
+            # Note, this is an educated guess and not a guarantee
+            # If it fails, the only downside is that the code is highlighted strangely
+            new_line_index = code.index("\n")
+            first_line = code[:new_line_index] if new_line_index != -1 else code
+            if first_line.startswith("#!") and "python" in first_line.lower():
+                return "python"
+        try:
+            return cls.LEXERS.get(ext) or guess_lexer_for_filename(filename, code).name
+        except ClassNotFound:
+            return "text"
+
+    @group()
+    def _render_stack(self, stack: Stack) -> RenderResult:
+        path_highlighter = PathHighlighter()
+        theme = self.theme
+
+        def read_code(filename: str) -> str:
+            """Read files, and cache results on filename.
+
+            Args:
+                filename (str): Filename to read
+
+            Returns:
+                str: Contents of file
+            """
+            return "".join(linecache.getlines(filename))
+
+        def render_locals(frame: Frame) -> Iterable[ConsoleRenderable]:
+            if frame.locals:
+                yield render_scope(
+                    frame.locals,
+                    title="locals",
+                    indent_guides=self.indent_guides,
+                    max_length=self.locals_max_length,
+                    max_string=self.locals_max_string,
+                )
+
+        exclude_frames: Optional[range] = None
+        if self.max_frames != 0:
+            exclude_frames = range(
+                self.max_frames // 2,
+                len(stack.frames) - self.max_frames // 2,
+            )
+
+        excluded = False
+        for frame_index, frame in enumerate(stack.frames):
+            if exclude_frames and frame_index in exclude_frames:
+                excluded = True
+                continue
+
+            if excluded:
+                assert exclude_frames is not None
+                yield Text(
+                    f"\n... {len(exclude_frames)} frames hidden ...",
+                    justify="center",
+                    style="traceback.error",
+                )
+                excluded = False
+
+            first = frame_index == 0
+            frame_filename = frame.filename
+            suppressed = any(frame_filename.startswith(path) for path in self.suppress)
+
+            if os.path.exists(frame.filename):
+                text = Text.assemble(
+                    path_highlighter(Text(frame.filename, style="pygments.string")),
+                    (":", "pygments.text"),
+                    (str(frame.lineno), "pygments.number"),
+                    " in ",
+                    (frame.name, "pygments.function"),
+                    style="pygments.text",
+                )
+            else:
+                text = Text.assemble(
+                    "in ",
+                    (frame.name, "pygments.function"),
+                    (":", "pygments.text"),
+                    (str(frame.lineno), "pygments.number"),
+                    style="pygments.text",
+                )
+            if not frame.filename.startswith("<") and not first:
+                yield ""
+            yield text
+            if frame.filename.startswith("<"):
+                yield from render_locals(frame)
+                continue
+            if not suppressed:
+                try:
+                    code = read_code(frame.filename)
+                    if not code:
+                        # code may be an empty string if the file doesn't exist, OR
+                        # if the traceback filename is generated dynamically
+                        continue
+                    lexer_name = self._guess_lexer(frame.filename, code)
+                    syntax = Syntax(
+                        code,
+                        lexer_name,
+                        theme=theme,
+                        line_numbers=True,
+                        line_range=(
+                            frame.lineno - self.extra_lines,
+                            frame.lineno + self.extra_lines,
+                        ),
+                        highlight_lines={frame.lineno},
+                        word_wrap=self.word_wrap,
+                        code_width=self.code_width,
+                        indent_guides=self.indent_guides,
+                        dedent=False,
+                    )
+                    yield ""
+                except Exception as error:
+                    yield Text.assemble(
+                        (f"\n{error}", "traceback.error"),
+                    )
+                else:
+                    if frame.last_instruction is not None:
+                        start, end = frame.last_instruction
+                        syntax.stylize_range(
+                            style="traceback.error_range",
+                            start=start,
+                            end=end,
+                            style_before=True,
+                        )
+                    yield (
+                        Columns(
+                            [
+                                syntax,
+                                *render_locals(frame),
+                            ],
+                            padding=1,
+                        )
+                        if frame.locals
+                        else syntax
+                    )
+
+
+if __name__ == "__main__":  # pragma: no cover
+    install(show_locals=True)
+    import sys
+
+    def bar(
+        a: Any,
+    ) -> None:  # 这是对亚洲语言支持的测试。面对模棱两可的想法，拒绝猜测的诱惑
+        one = 1
+        print(one / a)
+
+    def foo(a: Any) -> None:
+        _rich_traceback_guard = True
+        zed = {
+            "characters": {
+                "Paul Atreides",
+                "Vladimir Harkonnen",
+                "Thufir Hawat",
+                "Duncan Idaho",
+            },
+            "atomic_types": (None, False, True),
+        }
+        bar(a)
+
+    def error() -> None:
+        foo(0)
+
+    error()
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/rich/tree.py b/env/lib/python3.12/site-packages/pip/_vendor/rich/tree.py
new file mode 100644
index 0000000..27c5cf7
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/rich/tree.py
@@ -0,0 +1,257 @@
+from typing import Iterator, List, Optional, Tuple
+
+from ._loop import loop_first, loop_last
+from .console import Console, ConsoleOptions, RenderableType, RenderResult
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment
+from .style import Style, StyleStack, StyleType
+from .styled import Styled
+
+GuideType = Tuple[str, str, str, str]
+
+
+class Tree(JupyterMixin):
+    """A renderable for a tree structure.
+
+    Attributes:
+        ASCII_GUIDES (GuideType): Guide lines used when Console.ascii_only is True.
+        TREE_GUIDES (List[GuideType, GuideType, GuideType]): Default guide lines.
+
+    Args:
+        label (RenderableType): The renderable or str for the tree label.
+        style (StyleType, optional): Style of this tree. Defaults to "tree".
+        guide_style (StyleType, optional): Style of the guide lines. Defaults to "tree.line".
+        expanded (bool, optional): Also display children. Defaults to True.
+        highlight (bool, optional): Highlight renderable (if str). Defaults to False.
+        hide_root (bool, optional): Hide the root node. Defaults to False.
+    """
+
+    ASCII_GUIDES = ("    ", "|   ", "+-- ", "`-- ")
+    TREE_GUIDES = [
+        ("    ", "│   ", "├── ", "└── "),
+        ("    ", "┃   ", "┣━━ ", "┗━━ "),
+        ("    ", "║   ", "╠══ ", "╚══ "),
+    ]
+
+    def __init__(
+        self,
+        label: RenderableType,
+        *,
+        style: StyleType = "tree",
+        guide_style: StyleType = "tree.line",
+        expanded: bool = True,
+        highlight: bool = False,
+        hide_root: bool = False,
+    ) -> None:
+        self.label = label
+        self.style = style
+        self.guide_style = guide_style
+        self.children: List[Tree] = []
+        self.expanded = expanded
+        self.highlight = highlight
+        self.hide_root = hide_root
+
+    def add(
+        self,
+        label: RenderableType,
+        *,
+        style: Optional[StyleType] = None,
+        guide_style: Optional[StyleType] = None,
+        expanded: bool = True,
+        highlight: Optional[bool] = False,
+    ) -> "Tree":
+        """Add a child tree.
+
+        Args:
+            label (RenderableType): The renderable or str for the tree label.
+            style (StyleType, optional): Style of this tree. Defaults to "tree".
+            guide_style (StyleType, optional): Style of the guide lines. Defaults to "tree.line".
+            expanded (bool, optional): Also display children. Defaults to True.
+            highlight (Optional[bool], optional): Highlight renderable (if str). Defaults to False.
+
+        Returns:
+            Tree: A new child Tree, which may be further modified.
+        """
+        node = Tree(
+            label,
+            style=self.style if style is None else style,
+            guide_style=self.guide_style if guide_style is None else guide_style,
+            expanded=expanded,
+            highlight=self.highlight if highlight is None else highlight,
+        )
+        self.children.append(node)
+        return node
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        stack: List[Iterator[Tuple[bool, Tree]]] = []
+        pop = stack.pop
+        push = stack.append
+        new_line = Segment.line()
+
+        get_style = console.get_style
+        null_style = Style.null()
+        guide_style = get_style(self.guide_style, default="") or null_style
+        SPACE, CONTINUE, FORK, END = range(4)
+
+        _Segment = Segment
+
+        def make_guide(index: int, style: Style) -> Segment:
+            """Make a Segment for a level of the guide lines."""
+            if options.ascii_only:
+                line = self.ASCII_GUIDES[index]
+            else:
+                guide = 1 if style.bold else (2 if style.underline2 else 0)
+                line = self.TREE_GUIDES[0 if options.legacy_windows else guide][index]
+            return _Segment(line, style)
+
+        levels: List[Segment] = [make_guide(CONTINUE, guide_style)]
+        push(iter(loop_last([self])))
+
+        guide_style_stack = StyleStack(get_style(self.guide_style))
+        style_stack = StyleStack(get_style(self.style))
+        remove_guide_styles = Style(bold=False, underline2=False)
+
+        depth = 0
+
+        while stack:
+            stack_node = pop()
+            try:
+                last, node = next(stack_node)
+            except StopIteration:
+                levels.pop()
+                if levels:
+                    guide_style = levels[-1].style or null_style
+                    levels[-1] = make_guide(FORK, guide_style)
+                    guide_style_stack.pop()
+                    style_stack.pop()
+                continue
+            push(stack_node)
+            if last:
+                levels[-1] = make_guide(END, levels[-1].style or null_style)
+
+            guide_style = guide_style_stack.current + get_style(node.guide_style)
+            style = style_stack.current + get_style(node.style)
+            prefix = levels[(2 if self.hide_root else 1) :]
+            renderable_lines = console.render_lines(
+                Styled(node.label, style),
+                options.update(
+                    width=options.max_width
+                    - sum(level.cell_length for level in prefix),
+                    highlight=self.highlight,
+                    height=None,
+                ),
+                pad=options.justify is not None,
+            )
+
+            if not (depth == 0 and self.hide_root):
+                for first, line in loop_first(renderable_lines):
+                    if prefix:
+                        yield from _Segment.apply_style(
+                            prefix,
+                            style.background_style,
+                            post_style=remove_guide_styles,
+                        )
+                    yield from line
+                    yield new_line
+                    if first and prefix:
+                        prefix[-1] = make_guide(
+                            SPACE if last else CONTINUE, prefix[-1].style or null_style
+                        )
+
+            if node.expanded and node.children:
+                levels[-1] = make_guide(
+                    SPACE if last else CONTINUE, levels[-1].style or null_style
+                )
+                levels.append(
+                    make_guide(END if len(node.children) == 1 else FORK, guide_style)
+                )
+                style_stack.push(get_style(node.style))
+                guide_style_stack.push(get_style(node.guide_style))
+                push(iter(loop_last(node.children)))
+                depth += 1
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        stack: List[Iterator[Tree]] = [iter([self])]
+        pop = stack.pop
+        push = stack.append
+        minimum = 0
+        maximum = 0
+        measure = Measurement.get
+        level = 0
+        while stack:
+            iter_tree = pop()
+            try:
+                tree = next(iter_tree)
+            except StopIteration:
+                level -= 1
+                continue
+            push(iter_tree)
+            min_measure, max_measure = measure(console, options, tree.label)
+            indent = level * 4
+            minimum = max(min_measure + indent, minimum)
+            maximum = max(max_measure + indent, maximum)
+            if tree.expanded and tree.children:
+                push(iter(tree.children))
+                level += 1
+        return Measurement(minimum, maximum)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Group
+    from pip._vendor.rich.markdown import Markdown
+    from pip._vendor.rich.panel import Panel
+    from pip._vendor.rich.syntax import Syntax
+    from pip._vendor.rich.table import Table
+
+    table = Table(row_styles=["", "dim"])
+
+    table.add_column("Released", style="cyan", no_wrap=True)
+    table.add_column("Title", style="magenta")
+    table.add_column("Box Office", justify="right", style="green")
+
+    table.add_row("Dec 20, 2019", "Star Wars: The Rise of Skywalker", "$952,110,690")
+    table.add_row("May 25, 2018", "Solo: A Star Wars Story", "$393,151,347")
+    table.add_row("Dec 15, 2017", "Star Wars Ep. V111: The Last Jedi", "$1,332,539,889")
+    table.add_row("Dec 16, 2016", "Rogue One: A Star Wars Story", "$1,332,439,889")
+
+    code = """\
+class Segment(NamedTuple):
+    text: str = ""
+    style: Optional[Style] = None
+    is_control: bool = False
+"""
+    syntax = Syntax(code, "python", theme="monokai", line_numbers=True)
+
+    markdown = Markdown(
+        """\
+### example.md
+> Hello, World!
+>
+> Markdown _all_ the things
+"""
+    )
+
+    root = Tree("🌲 [b green]Rich Tree", highlight=True, hide_root=True)
+
+    node = root.add(":file_folder: Renderables", guide_style="red")
+    simple_node = node.add(":file_folder: [bold yellow]Atomic", guide_style="uu green")
+    simple_node.add(Group("📄 Syntax", syntax))
+    simple_node.add(Group("📄 Markdown", Panel(markdown, border_style="green")))
+
+    containers_node = node.add(
+        ":file_folder: [bold magenta]Containers", guide_style="bold magenta"
+    )
+    containers_node.expanded = True
+    panel = Panel.fit("Just a panel", border_style="red")
+    containers_node.add(Group("📄 Panels", panel))
+
+    containers_node.add(Group("📄 [b magenta]Table", table))
+
+    console = Console()
+
+    console.print(root)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/tomli/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/tomli/__init__.py
new file mode 100644
index 0000000..2b08d6e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/tomli/__init__.py
@@ -0,0 +1,8 @@
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021 Taneli Hukkinen
+# Licensed to PSF under a Contributor Agreement.
+
+__all__ = ("loads", "load", "TOMLDecodeError")
+__version__ = "2.2.1"  # DO NOT EDIT THIS LINE MANUALLY. LET bump2version UTILITY DO IT
+
+from ._parser import TOMLDecodeError, load, loads
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/tomli/_parser.py b/env/lib/python3.12/site-packages/pip/_vendor/tomli/_parser.py
new file mode 100644
index 0000000..b548e8b
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/tomli/_parser.py
@@ -0,0 +1,770 @@
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021 Taneli Hukkinen
+# Licensed to PSF under a Contributor Agreement.
+
+from __future__ import annotations
+
+from collections.abc import Iterable
+import string
+import sys
+from types import MappingProxyType
+from typing import IO, Any, Final, NamedTuple
+import warnings
+
+from ._re import (
+    RE_DATETIME,
+    RE_LOCALTIME,
+    RE_NUMBER,
+    match_to_datetime,
+    match_to_localtime,
+    match_to_number,
+)
+from ._types import Key, ParseFloat, Pos
+
+# Inline tables/arrays are implemented using recursion. Pathologically
+# nested documents cause pure Python to raise RecursionError (which is OK),
+# but mypyc binary wheels will crash unrecoverably (not OK). According to
+# mypyc docs this will be fixed in the future:
+# https://mypyc.readthedocs.io/en/latest/differences_from_python.html#stack-overflows
+# Before mypyc's fix is in, recursion needs to be limited by this library.
+# Choosing `sys.getrecursionlimit()` as maximum inline table/array nesting
+# level, as it allows more nesting than pure Python, but still seems a far
+# lower number than where mypyc binaries crash.
+MAX_INLINE_NESTING: Final = sys.getrecursionlimit()
+
+ASCII_CTRL: Final = frozenset(chr(i) for i in range(32)) | frozenset(chr(127))
+
+# Neither of these sets include quotation mark or backslash. They are
+# currently handled as separate cases in the parser functions.
+ILLEGAL_BASIC_STR_CHARS: Final = ASCII_CTRL - frozenset("\t")
+ILLEGAL_MULTILINE_BASIC_STR_CHARS: Final = ASCII_CTRL - frozenset("\t\n")
+
+ILLEGAL_LITERAL_STR_CHARS: Final = ILLEGAL_BASIC_STR_CHARS
+ILLEGAL_MULTILINE_LITERAL_STR_CHARS: Final = ILLEGAL_MULTILINE_BASIC_STR_CHARS
+
+ILLEGAL_COMMENT_CHARS: Final = ILLEGAL_BASIC_STR_CHARS
+
+TOML_WS: Final = frozenset(" \t")
+TOML_WS_AND_NEWLINE: Final = TOML_WS | frozenset("\n")
+BARE_KEY_CHARS: Final = frozenset(string.ascii_letters + string.digits + "-_")
+KEY_INITIAL_CHARS: Final = BARE_KEY_CHARS | frozenset("\"'")
+HEXDIGIT_CHARS: Final = frozenset(string.hexdigits)
+
+BASIC_STR_ESCAPE_REPLACEMENTS: Final = MappingProxyType(
+    {
+        "\\b": "\u0008",  # backspace
+        "\\t": "\u0009",  # tab
+        "\\n": "\u000A",  # linefeed
+        "\\f": "\u000C",  # form feed
+        "\\r": "\u000D",  # carriage return
+        '\\"': "\u0022",  # quote
+        "\\\\": "\u005C",  # backslash
+    }
+)
+
+
+class DEPRECATED_DEFAULT:
+    """Sentinel to be used as default arg during deprecation
+    period of TOMLDecodeError's free-form arguments."""
+
+
+class TOMLDecodeError(ValueError):
+    """An error raised if a document is not valid TOML.
+
+    Adds the following attributes to ValueError:
+    msg: The unformatted error message
+    doc: The TOML document being parsed
+    pos: The index of doc where parsing failed
+    lineno: The line corresponding to pos
+    colno: The column corresponding to pos
+    """
+
+    def __init__(
+        self,
+        msg: str | type[DEPRECATED_DEFAULT] = DEPRECATED_DEFAULT,
+        doc: str | type[DEPRECATED_DEFAULT] = DEPRECATED_DEFAULT,
+        pos: Pos | type[DEPRECATED_DEFAULT] = DEPRECATED_DEFAULT,
+        *args: Any,
+    ):
+        if (
+            args
+            or not isinstance(msg, str)
+            or not isinstance(doc, str)
+            or not isinstance(pos, int)
+        ):
+            warnings.warn(
+                "Free-form arguments for TOMLDecodeError are deprecated. "
+                "Please set 'msg' (str), 'doc' (str) and 'pos' (int) arguments only.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            if pos is not DEPRECATED_DEFAULT:
+                args = pos, *args
+            if doc is not DEPRECATED_DEFAULT:
+                args = doc, *args
+            if msg is not DEPRECATED_DEFAULT:
+                args = msg, *args
+            ValueError.__init__(self, *args)
+            return
+
+        lineno = doc.count("\n", 0, pos) + 1
+        if lineno == 1:
+            colno = pos + 1
+        else:
+            colno = pos - doc.rindex("\n", 0, pos)
+
+        if pos >= len(doc):
+            coord_repr = "end of document"
+        else:
+            coord_repr = f"line {lineno}, column {colno}"
+        errmsg = f"{msg} (at {coord_repr})"
+        ValueError.__init__(self, errmsg)
+
+        self.msg = msg
+        self.doc = doc
+        self.pos = pos
+        self.lineno = lineno
+        self.colno = colno
+
+
+def load(__fp: IO[bytes], *, parse_float: ParseFloat = float) -> dict[str, Any]:
+    """Parse TOML from a binary file object."""
+    b = __fp.read()
+    try:
+        s = b.decode()
+    except AttributeError:
+        raise TypeError(
+            "File must be opened in binary mode, e.g. use `open('foo.toml', 'rb')`"
+        ) from None
+    return loads(s, parse_float=parse_float)
+
+
+def loads(__s: str, *, parse_float: ParseFloat = float) -> dict[str, Any]:  # noqa: C901
+    """Parse TOML from a string."""
+
+    # The spec allows converting "\r\n" to "\n", even in string
+    # literals. Let's do so to simplify parsing.
+    try:
+        src = __s.replace("\r\n", "\n")
+    except (AttributeError, TypeError):
+        raise TypeError(
+            f"Expected str object, not '{type(__s).__qualname__}'"
+        ) from None
+    pos = 0
+    out = Output(NestedDict(), Flags())
+    header: Key = ()
+    parse_float = make_safe_parse_float(parse_float)
+
+    # Parse one statement at a time
+    # (typically means one line in TOML source)
+    while True:
+        # 1. Skip line leading whitespace
+        pos = skip_chars(src, pos, TOML_WS)
+
+        # 2. Parse rules. Expect one of the following:
+        #    - end of file
+        #    - end of line
+        #    - comment
+        #    - key/value pair
+        #    - append dict to list (and move to its namespace)
+        #    - create dict (and move to its namespace)
+        # Skip trailing whitespace when applicable.
+        try:
+            char = src[pos]
+        except IndexError:
+            break
+        if char == "\n":
+            pos += 1
+            continue
+        if char in KEY_INITIAL_CHARS:
+            pos = key_value_rule(src, pos, out, header, parse_float)
+            pos = skip_chars(src, pos, TOML_WS)
+        elif char == "[":
+            try:
+                second_char: str | None = src[pos + 1]
+            except IndexError:
+                second_char = None
+            out.flags.finalize_pending()
+            if second_char == "[":
+                pos, header = create_list_rule(src, pos, out)
+            else:
+                pos, header = create_dict_rule(src, pos, out)
+            pos = skip_chars(src, pos, TOML_WS)
+        elif char != "#":
+            raise TOMLDecodeError("Invalid statement", src, pos)
+
+        # 3. Skip comment
+        pos = skip_comment(src, pos)
+
+        # 4. Expect end of line or end of file
+        try:
+            char = src[pos]
+        except IndexError:
+            break
+        if char != "\n":
+            raise TOMLDecodeError(
+                "Expected newline or end of document after a statement", src, pos
+            )
+        pos += 1
+
+    return out.data.dict
+
+
+class Flags:
+    """Flags that map to parsed keys/namespaces."""
+
+    # Marks an immutable namespace (inline array or inline table).
+    FROZEN: Final = 0
+    # Marks a nest that has been explicitly created and can no longer
+    # be opened using the "[table]" syntax.
+    EXPLICIT_NEST: Final = 1
+
+    def __init__(self) -> None:
+        self._flags: dict[str, dict] = {}
+        self._pending_flags: set[tuple[Key, int]] = set()
+
+    def add_pending(self, key: Key, flag: int) -> None:
+        self._pending_flags.add((key, flag))
+
+    def finalize_pending(self) -> None:
+        for key, flag in self._pending_flags:
+            self.set(key, flag, recursive=False)
+        self._pending_flags.clear()
+
+    def unset_all(self, key: Key) -> None:
+        cont = self._flags
+        for k in key[:-1]:
+            if k not in cont:
+                return
+            cont = cont[k]["nested"]
+        cont.pop(key[-1], None)
+
+    def set(self, key: Key, flag: int, *, recursive: bool) -> None:  # noqa: A003
+        cont = self._flags
+        key_parent, key_stem = key[:-1], key[-1]
+        for k in key_parent:
+            if k not in cont:
+                cont[k] = {"flags": set(), "recursive_flags": set(), "nested": {}}
+            cont = cont[k]["nested"]
+        if key_stem not in cont:
+            cont[key_stem] = {"flags": set(), "recursive_flags": set(), "nested": {}}
+        cont[key_stem]["recursive_flags" if recursive else "flags"].add(flag)
+
+    def is_(self, key: Key, flag: int) -> bool:
+        if not key:
+            return False  # document root has no flags
+        cont = self._flags
+        for k in key[:-1]:
+            if k not in cont:
+                return False
+            inner_cont = cont[k]
+            if flag in inner_cont["recursive_flags"]:
+                return True
+            cont = inner_cont["nested"]
+        key_stem = key[-1]
+        if key_stem in cont:
+            inner_cont = cont[key_stem]
+            return flag in inner_cont["flags"] or flag in inner_cont["recursive_flags"]
+        return False
+
+
+class NestedDict:
+    def __init__(self) -> None:
+        # The parsed content of the TOML document
+        self.dict: dict[str, Any] = {}
+
+    def get_or_create_nest(
+        self,
+        key: Key,
+        *,
+        access_lists: bool = True,
+    ) -> dict:
+        cont: Any = self.dict
+        for k in key:
+            if k not in cont:
+                cont[k] = {}
+            cont = cont[k]
+            if access_lists and isinstance(cont, list):
+                cont = cont[-1]
+            if not isinstance(cont, dict):
+                raise KeyError("There is no nest behind this key")
+        return cont
+
+    def append_nest_to_list(self, key: Key) -> None:
+        cont = self.get_or_create_nest(key[:-1])
+        last_key = key[-1]
+        if last_key in cont:
+            list_ = cont[last_key]
+            if not isinstance(list_, list):
+                raise KeyError("An object other than list found behind this key")
+            list_.append({})
+        else:
+            cont[last_key] = [{}]
+
+
+class Output(NamedTuple):
+    data: NestedDict
+    flags: Flags
+
+
+def skip_chars(src: str, pos: Pos, chars: Iterable[str]) -> Pos:
+    try:
+        while src[pos] in chars:
+            pos += 1
+    except IndexError:
+        pass
+    return pos
+
+
+def skip_until(
+    src: str,
+    pos: Pos,
+    expect: str,
+    *,
+    error_on: frozenset[str],
+    error_on_eof: bool,
+) -> Pos:
+    try:
+        new_pos = src.index(expect, pos)
+    except ValueError:
+        new_pos = len(src)
+        if error_on_eof:
+            raise TOMLDecodeError(f"Expected {expect!r}", src, new_pos) from None
+
+    if not error_on.isdisjoint(src[pos:new_pos]):
+        while src[pos] not in error_on:
+            pos += 1
+        raise TOMLDecodeError(f"Found invalid character {src[pos]!r}", src, pos)
+    return new_pos
+
+
+def skip_comment(src: str, pos: Pos) -> Pos:
+    try:
+        char: str | None = src[pos]
+    except IndexError:
+        char = None
+    if char == "#":
+        return skip_until(
+            src, pos + 1, "\n", error_on=ILLEGAL_COMMENT_CHARS, error_on_eof=False
+        )
+    return pos
+
+
+def skip_comments_and_array_ws(src: str, pos: Pos) -> Pos:
+    while True:
+        pos_before_skip = pos
+        pos = skip_chars(src, pos, TOML_WS_AND_NEWLINE)
+        pos = skip_comment(src, pos)
+        if pos == pos_before_skip:
+            return pos
+
+
+def create_dict_rule(src: str, pos: Pos, out: Output) -> tuple[Pos, Key]:
+    pos += 1  # Skip "["
+    pos = skip_chars(src, pos, TOML_WS)
+    pos, key = parse_key(src, pos)
+
+    if out.flags.is_(key, Flags.EXPLICIT_NEST) or out.flags.is_(key, Flags.FROZEN):
+        raise TOMLDecodeError(f"Cannot declare {key} twice", src, pos)
+    out.flags.set(key, Flags.EXPLICIT_NEST, recursive=False)
+    try:
+        out.data.get_or_create_nest(key)
+    except KeyError:
+        raise TOMLDecodeError("Cannot overwrite a value", src, pos) from None
+
+    if not src.startswith("]", pos):
+        raise TOMLDecodeError(
+            "Expected ']' at the end of a table declaration", src, pos
+        )
+    return pos + 1, key
+
+
+def create_list_rule(src: str, pos: Pos, out: Output) -> tuple[Pos, Key]:
+    pos += 2  # Skip "[["
+    pos = skip_chars(src, pos, TOML_WS)
+    pos, key = parse_key(src, pos)
+
+    if out.flags.is_(key, Flags.FROZEN):
+        raise TOMLDecodeError(f"Cannot mutate immutable namespace {key}", src, pos)
+    # Free the namespace now that it points to another empty list item...
+    out.flags.unset_all(key)
+    # ...but this key precisely is still prohibited from table declaration
+    out.flags.set(key, Flags.EXPLICIT_NEST, recursive=False)
+    try:
+        out.data.append_nest_to_list(key)
+    except KeyError:
+        raise TOMLDecodeError("Cannot overwrite a value", src, pos) from None
+
+    if not src.startswith("]]", pos):
+        raise TOMLDecodeError(
+            "Expected ']]' at the end of an array declaration", src, pos
+        )
+    return pos + 2, key
+
+
+def key_value_rule(
+    src: str, pos: Pos, out: Output, header: Key, parse_float: ParseFloat
+) -> Pos:
+    pos, key, value = parse_key_value_pair(src, pos, parse_float, nest_lvl=0)
+    key_parent, key_stem = key[:-1], key[-1]
+    abs_key_parent = header + key_parent
+
+    relative_path_cont_keys = (header + key[:i] for i in range(1, len(key)))
+    for cont_key in relative_path_cont_keys:
+        # Check that dotted key syntax does not redefine an existing table
+        if out.flags.is_(cont_key, Flags.EXPLICIT_NEST):
+            raise TOMLDecodeError(f"Cannot redefine namespace {cont_key}", src, pos)
+        # Containers in the relative path can't be opened with the table syntax or
+        # dotted key/value syntax in following table sections.
+        out.flags.add_pending(cont_key, Flags.EXPLICIT_NEST)
+
+    if out.flags.is_(abs_key_parent, Flags.FROZEN):
+        raise TOMLDecodeError(
+            f"Cannot mutate immutable namespace {abs_key_parent}", src, pos
+        )
+
+    try:
+        nest = out.data.get_or_create_nest(abs_key_parent)
+    except KeyError:
+        raise TOMLDecodeError("Cannot overwrite a value", src, pos) from None
+    if key_stem in nest:
+        raise TOMLDecodeError("Cannot overwrite a value", src, pos)
+    # Mark inline table and array namespaces recursively immutable
+    if isinstance(value, (dict, list)):
+        out.flags.set(header + key, Flags.FROZEN, recursive=True)
+    nest[key_stem] = value
+    return pos
+
+
+def parse_key_value_pair(
+    src: str, pos: Pos, parse_float: ParseFloat, nest_lvl: int
+) -> tuple[Pos, Key, Any]:
+    pos, key = parse_key(src, pos)
+    try:
+        char: str | None = src[pos]
+    except IndexError:
+        char = None
+    if char != "=":
+        raise TOMLDecodeError("Expected '=' after a key in a key/value pair", src, pos)
+    pos += 1
+    pos = skip_chars(src, pos, TOML_WS)
+    pos, value = parse_value(src, pos, parse_float, nest_lvl)
+    return pos, key, value
+
+
+def parse_key(src: str, pos: Pos) -> tuple[Pos, Key]:
+    pos, key_part = parse_key_part(src, pos)
+    key: Key = (key_part,)
+    pos = skip_chars(src, pos, TOML_WS)
+    while True:
+        try:
+            char: str | None = src[pos]
+        except IndexError:
+            char = None
+        if char != ".":
+            return pos, key
+        pos += 1
+        pos = skip_chars(src, pos, TOML_WS)
+        pos, key_part = parse_key_part(src, pos)
+        key += (key_part,)
+        pos = skip_chars(src, pos, TOML_WS)
+
+
+def parse_key_part(src: str, pos: Pos) -> tuple[Pos, str]:
+    try:
+        char: str | None = src[pos]
+    except IndexError:
+        char = None
+    if char in BARE_KEY_CHARS:
+        start_pos = pos
+        pos = skip_chars(src, pos, BARE_KEY_CHARS)
+        return pos, src[start_pos:pos]
+    if char == "'":
+        return parse_literal_str(src, pos)
+    if char == '"':
+        return parse_one_line_basic_str(src, pos)
+    raise TOMLDecodeError("Invalid initial character for a key part", src, pos)
+
+
+def parse_one_line_basic_str(src: str, pos: Pos) -> tuple[Pos, str]:
+    pos += 1
+    return parse_basic_str(src, pos, multiline=False)
+
+
+def parse_array(
+    src: str, pos: Pos, parse_float: ParseFloat, nest_lvl: int
+) -> tuple[Pos, list]:
+    pos += 1
+    array: list = []
+
+    pos = skip_comments_and_array_ws(src, pos)
+    if src.startswith("]", pos):
+        return pos + 1, array
+    while True:
+        pos, val = parse_value(src, pos, parse_float, nest_lvl)
+        array.append(val)
+        pos = skip_comments_and_array_ws(src, pos)
+
+        c = src[pos : pos + 1]
+        if c == "]":
+            return pos + 1, array
+        if c != ",":
+            raise TOMLDecodeError("Unclosed array", src, pos)
+        pos += 1
+
+        pos = skip_comments_and_array_ws(src, pos)
+        if src.startswith("]", pos):
+            return pos + 1, array
+
+
+def parse_inline_table(
+    src: str, pos: Pos, parse_float: ParseFloat, nest_lvl: int
+) -> tuple[Pos, dict]:
+    pos += 1
+    nested_dict = NestedDict()
+    flags = Flags()
+
+    pos = skip_chars(src, pos, TOML_WS)
+    if src.startswith("}", pos):
+        return pos + 1, nested_dict.dict
+    while True:
+        pos, key, value = parse_key_value_pair(src, pos, parse_float, nest_lvl)
+        key_parent, key_stem = key[:-1], key[-1]
+        if flags.is_(key, Flags.FROZEN):
+            raise TOMLDecodeError(f"Cannot mutate immutable namespace {key}", src, pos)
+        try:
+            nest = nested_dict.get_or_create_nest(key_parent, access_lists=False)
+        except KeyError:
+            raise TOMLDecodeError("Cannot overwrite a value", src, pos) from None
+        if key_stem in nest:
+            raise TOMLDecodeError(f"Duplicate inline table key {key_stem!r}", src, pos)
+        nest[key_stem] = value
+        pos = skip_chars(src, pos, TOML_WS)
+        c = src[pos : pos + 1]
+        if c == "}":
+            return pos + 1, nested_dict.dict
+        if c != ",":
+            raise TOMLDecodeError("Unclosed inline table", src, pos)
+        if isinstance(value, (dict, list)):
+            flags.set(key, Flags.FROZEN, recursive=True)
+        pos += 1
+        pos = skip_chars(src, pos, TOML_WS)
+
+
+def parse_basic_str_escape(
+    src: str, pos: Pos, *, multiline: bool = False
+) -> tuple[Pos, str]:
+    escape_id = src[pos : pos + 2]
+    pos += 2
+    if multiline and escape_id in {"\\ ", "\\\t", "\\\n"}:
+        # Skip whitespace until next non-whitespace character or end of
+        # the doc. Error if non-whitespace is found before newline.
+        if escape_id != "\\\n":
+            pos = skip_chars(src, pos, TOML_WS)
+            try:
+                char = src[pos]
+            except IndexError:
+                return pos, ""
+            if char != "\n":
+                raise TOMLDecodeError("Unescaped '\\' in a string", src, pos)
+            pos += 1
+        pos = skip_chars(src, pos, TOML_WS_AND_NEWLINE)
+        return pos, ""
+    if escape_id == "\\u":
+        return parse_hex_char(src, pos, 4)
+    if escape_id == "\\U":
+        return parse_hex_char(src, pos, 8)
+    try:
+        return pos, BASIC_STR_ESCAPE_REPLACEMENTS[escape_id]
+    except KeyError:
+        raise TOMLDecodeError("Unescaped '\\' in a string", src, pos) from None
+
+
+def parse_basic_str_escape_multiline(src: str, pos: Pos) -> tuple[Pos, str]:
+    return parse_basic_str_escape(src, pos, multiline=True)
+
+
+def parse_hex_char(src: str, pos: Pos, hex_len: int) -> tuple[Pos, str]:
+    hex_str = src[pos : pos + hex_len]
+    if len(hex_str) != hex_len or not HEXDIGIT_CHARS.issuperset(hex_str):
+        raise TOMLDecodeError("Invalid hex value", src, pos)
+    pos += hex_len
+    hex_int = int(hex_str, 16)
+    if not is_unicode_scalar_value(hex_int):
+        raise TOMLDecodeError(
+            "Escaped character is not a Unicode scalar value", src, pos
+        )
+    return pos, chr(hex_int)
+
+
+def parse_literal_str(src: str, pos: Pos) -> tuple[Pos, str]:
+    pos += 1  # Skip starting apostrophe
+    start_pos = pos
+    pos = skip_until(
+        src, pos, "'", error_on=ILLEGAL_LITERAL_STR_CHARS, error_on_eof=True
+    )
+    return pos + 1, src[start_pos:pos]  # Skip ending apostrophe
+
+
+def parse_multiline_str(src: str, pos: Pos, *, literal: bool) -> tuple[Pos, str]:
+    pos += 3
+    if src.startswith("\n", pos):
+        pos += 1
+
+    if literal:
+        delim = "'"
+        end_pos = skip_until(
+            src,
+            pos,
+            "'''",
+            error_on=ILLEGAL_MULTILINE_LITERAL_STR_CHARS,
+            error_on_eof=True,
+        )
+        result = src[pos:end_pos]
+        pos = end_pos + 3
+    else:
+        delim = '"'
+        pos, result = parse_basic_str(src, pos, multiline=True)
+
+    # Add at maximum two extra apostrophes/quotes if the end sequence
+    # is 4 or 5 chars long instead of just 3.
+    if not src.startswith(delim, pos):
+        return pos, result
+    pos += 1
+    if not src.startswith(delim, pos):
+        return pos, result + delim
+    pos += 1
+    return pos, result + (delim * 2)
+
+
+def parse_basic_str(src: str, pos: Pos, *, multiline: bool) -> tuple[Pos, str]:
+    if multiline:
+        error_on = ILLEGAL_MULTILINE_BASIC_STR_CHARS
+        parse_escapes = parse_basic_str_escape_multiline
+    else:
+        error_on = ILLEGAL_BASIC_STR_CHARS
+        parse_escapes = parse_basic_str_escape
+    result = ""
+    start_pos = pos
+    while True:
+        try:
+            char = src[pos]
+        except IndexError:
+            raise TOMLDecodeError("Unterminated string", src, pos) from None
+        if char == '"':
+            if not multiline:
+                return pos + 1, result + src[start_pos:pos]
+            if src.startswith('"""', pos):
+                return pos + 3, result + src[start_pos:pos]
+            pos += 1
+            continue
+        if char == "\\":
+            result += src[start_pos:pos]
+            pos, parsed_escape = parse_escapes(src, pos)
+            result += parsed_escape
+            start_pos = pos
+            continue
+        if char in error_on:
+            raise TOMLDecodeError(f"Illegal character {char!r}", src, pos)
+        pos += 1
+
+
+def parse_value(  # noqa: C901
+    src: str, pos: Pos, parse_float: ParseFloat, nest_lvl: int
+) -> tuple[Pos, Any]:
+    if nest_lvl > MAX_INLINE_NESTING:
+        # Pure Python should have raised RecursionError already.
+        # This ensures mypyc binaries eventually do the same.
+        raise RecursionError(  # pragma: no cover
+            "TOML inline arrays/tables are nested more than the allowed"
+            f" {MAX_INLINE_NESTING} levels"
+        )
+
+    try:
+        char: str | None = src[pos]
+    except IndexError:
+        char = None
+
+    # IMPORTANT: order conditions based on speed of checking and likelihood
+
+    # Basic strings
+    if char == '"':
+        if src.startswith('"""', pos):
+            return parse_multiline_str(src, pos, literal=False)
+        return parse_one_line_basic_str(src, pos)
+
+    # Literal strings
+    if char == "'":
+        if src.startswith("'''", pos):
+            return parse_multiline_str(src, pos, literal=True)
+        return parse_literal_str(src, pos)
+
+    # Booleans
+    if char == "t":
+        if src.startswith("true", pos):
+            return pos + 4, True
+    if char == "f":
+        if src.startswith("false", pos):
+            return pos + 5, False
+
+    # Arrays
+    if char == "[":
+        return parse_array(src, pos, parse_float, nest_lvl + 1)
+
+    # Inline tables
+    if char == "{":
+        return parse_inline_table(src, pos, parse_float, nest_lvl + 1)
+
+    # Dates and times
+    datetime_match = RE_DATETIME.match(src, pos)
+    if datetime_match:
+        try:
+            datetime_obj = match_to_datetime(datetime_match)
+        except ValueError as e:
+            raise TOMLDecodeError("Invalid date or datetime", src, pos) from e
+        return datetime_match.end(), datetime_obj
+    localtime_match = RE_LOCALTIME.match(src, pos)
+    if localtime_match:
+        return localtime_match.end(), match_to_localtime(localtime_match)
+
+    # Integers and "normal" floats.
+    # The regex will greedily match any type starting with a decimal
+    # char, so needs to be located after handling of dates and times.
+    number_match = RE_NUMBER.match(src, pos)
+    if number_match:
+        return number_match.end(), match_to_number(number_match, parse_float)
+
+    # Special floats
+    first_three = src[pos : pos + 3]
+    if first_three in {"inf", "nan"}:
+        return pos + 3, parse_float(first_three)
+    first_four = src[pos : pos + 4]
+    if first_four in {"-inf", "+inf", "-nan", "+nan"}:
+        return pos + 4, parse_float(first_four)
+
+    raise TOMLDecodeError("Invalid value", src, pos)
+
+
+def is_unicode_scalar_value(codepoint: int) -> bool:
+    return (0 <= codepoint <= 55295) or (57344 <= codepoint <= 1114111)
+
+
+def make_safe_parse_float(parse_float: ParseFloat) -> ParseFloat:
+    """A decorator to make `parse_float` safe.
+
+    `parse_float` must not return dicts or lists, because these types
+    would be mixed with parsed TOML tables and arrays, thus confusing
+    the parser. The returned decorated callable raises `ValueError`
+    instead of returning illegal types.
+    """
+    # The default `float` callable never returns illegal types. Optimize it.
+    if parse_float is float:
+        return float
+
+    def safe_parse_float(float_str: str) -> Any:
+        float_value = parse_float(float_str)
+        if isinstance(float_value, (dict, list)):
+            raise ValueError("parse_float must not return dicts or lists")
+        return float_value
+
+    return safe_parse_float
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/tomli/_re.py b/env/lib/python3.12/site-packages/pip/_vendor/tomli/_re.py
new file mode 100644
index 0000000..5134866
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/tomli/_re.py
@@ -0,0 +1,112 @@
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021 Taneli Hukkinen
+# Licensed to PSF under a Contributor Agreement.
+
+from __future__ import annotations
+
+from datetime import date, datetime, time, timedelta, timezone, tzinfo
+from functools import lru_cache
+import re
+from typing import Any, Final
+
+from ._types import ParseFloat
+
+# E.g.
+# - 00:32:00.999999
+# - 00:32:00
+_TIME_RE_STR: Final = (
+    r"([01][0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])(?:\.([0-9]{1,6})[0-9]*)?"
+)
+
+RE_NUMBER: Final = re.compile(
+    r"""
+0
+(?:
+    x[0-9A-Fa-f](?:_?[0-9A-Fa-f])*   # hex
+    |
+    b[01](?:_?[01])*                 # bin
+    |
+    o[0-7](?:_?[0-7])*               # oct
+)
+|
+[+-]?(?:0|[1-9](?:_?[0-9])*)         # dec, integer part
+(?P
+    (?:\.[0-9](?:_?[0-9])*)?         # optional fractional part
+    (?:[eE][+-]?[0-9](?:_?[0-9])*)?  # optional exponent part
+)
+""",
+    flags=re.VERBOSE,
+)
+RE_LOCALTIME: Final = re.compile(_TIME_RE_STR)
+RE_DATETIME: Final = re.compile(
+    rf"""
+([0-9]{{4}})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])  # date, e.g. 1988-10-27
+(?:
+    [Tt ]
+    {_TIME_RE_STR}
+    (?:([Zz])|([+-])([01][0-9]|2[0-3]):([0-5][0-9]))?  # optional time offset
+)?
+""",
+    flags=re.VERBOSE,
+)
+
+
+def match_to_datetime(match: re.Match) -> datetime | date:
+    """Convert a `RE_DATETIME` match to `datetime.datetime` or `datetime.date`.
+
+    Raises ValueError if the match does not correspond to a valid date
+    or datetime.
+    """
+    (
+        year_str,
+        month_str,
+        day_str,
+        hour_str,
+        minute_str,
+        sec_str,
+        micros_str,
+        zulu_time,
+        offset_sign_str,
+        offset_hour_str,
+        offset_minute_str,
+    ) = match.groups()
+    year, month, day = int(year_str), int(month_str), int(day_str)
+    if hour_str is None:
+        return date(year, month, day)
+    hour, minute, sec = int(hour_str), int(minute_str), int(sec_str)
+    micros = int(micros_str.ljust(6, "0")) if micros_str else 0
+    if offset_sign_str:
+        tz: tzinfo | None = cached_tz(
+            offset_hour_str, offset_minute_str, offset_sign_str
+        )
+    elif zulu_time:
+        tz = timezone.utc
+    else:  # local date-time
+        tz = None
+    return datetime(year, month, day, hour, minute, sec, micros, tzinfo=tz)
+
+
+# No need to limit cache size. This is only ever called on input
+# that matched RE_DATETIME, so there is an implicit bound of
+# 24 (hours) * 60 (minutes) * 2 (offset direction) = 2880.
+@lru_cache(maxsize=None)
+def cached_tz(hour_str: str, minute_str: str, sign_str: str) -> timezone:
+    sign = 1 if sign_str == "+" else -1
+    return timezone(
+        timedelta(
+            hours=sign * int(hour_str),
+            minutes=sign * int(minute_str),
+        )
+    )
+
+
+def match_to_localtime(match: re.Match) -> time:
+    hour_str, minute_str, sec_str, micros_str = match.groups()
+    micros = int(micros_str.ljust(6, "0")) if micros_str else 0
+    return time(int(hour_str), int(minute_str), int(sec_str), micros)
+
+
+def match_to_number(match: re.Match, parse_float: ParseFloat) -> Any:
+    if match.group("floatpart"):
+        return parse_float(match.group())
+    return int(match.group(), 0)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/tomli/_types.py b/env/lib/python3.12/site-packages/pip/_vendor/tomli/_types.py
new file mode 100644
index 0000000..d949412
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/tomli/_types.py
@@ -0,0 +1,10 @@
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021 Taneli Hukkinen
+# Licensed to PSF under a Contributor Agreement.
+
+from typing import Any, Callable, Tuple
+
+# Type annotations
+ParseFloat = Callable[[str], Any]
+Key = Tuple[str, ...]
+Pos = int
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/tomli/py.typed b/env/lib/python3.12/site-packages/pip/_vendor/tomli/py.typed
new file mode 100644
index 0000000..7632ecf
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/tomli/py.typed
@@ -0,0 +1 @@
+# Marker file for PEP 561
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/truststore/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/truststore/__init__.py
new file mode 100644
index 0000000..e468bf8
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/truststore/__init__.py
@@ -0,0 +1,36 @@
+"""Verify certificates using native system trust stores"""
+
+import sys as _sys
+
+if _sys.version_info < (3, 10):
+    raise ImportError("truststore requires Python 3.10 or later")
+
+# Detect Python runtimes which don't implement SSLObject.get_unverified_chain() API
+# This API only became public in Python 3.13 but was available in CPython and PyPy since 3.10.
+if _sys.version_info < (3, 13):
+    try:
+        import ssl as _ssl
+    except ImportError:
+        raise ImportError("truststore requires the 'ssl' module")
+    else:
+        _sslmem = _ssl.MemoryBIO()
+        _sslobj = _ssl.create_default_context().wrap_bio(
+            _sslmem,
+            _sslmem,
+        )
+        try:
+            while not hasattr(_sslobj, "get_unverified_chain"):
+                _sslobj = _sslobj._sslobj  # type: ignore[attr-defined]
+        except AttributeError:
+            raise ImportError(
+                "truststore requires peer certificate chain APIs to be available"
+            ) from None
+
+        del _ssl, _sslobj, _sslmem  # noqa: F821
+
+from ._api import SSLContext, extract_from_ssl, inject_into_ssl  # noqa: E402
+
+del _api, _sys  # type: ignore[name-defined] # noqa: F821
+
+__all__ = ["SSLContext", "inject_into_ssl", "extract_from_ssl"]
+__version__ = "0.10.0"
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/truststore/_api.py b/env/lib/python3.12/site-packages/pip/_vendor/truststore/_api.py
new file mode 100644
index 0000000..aeb023a
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/truststore/_api.py
@@ -0,0 +1,316 @@
+import os
+import platform
+import socket
+import ssl
+import sys
+import typing
+
+import _ssl  # type: ignore[import-not-found]
+
+from ._ssl_constants import (
+    _original_SSLContext,
+    _original_super_SSLContext,
+    _truststore_SSLContext_dunder_class,
+    _truststore_SSLContext_super_class,
+)
+
+if platform.system() == "Windows":
+    from ._windows import _configure_context, _verify_peercerts_impl
+elif platform.system() == "Darwin":
+    from ._macos import _configure_context, _verify_peercerts_impl
+else:
+    from ._openssl import _configure_context, _verify_peercerts_impl
+
+if typing.TYPE_CHECKING:
+    from pip._vendor.typing_extensions import Buffer
+
+# From typeshed/stdlib/ssl.pyi
+_StrOrBytesPath: typing.TypeAlias = str | bytes | os.PathLike[str] | os.PathLike[bytes]
+_PasswordType: typing.TypeAlias = str | bytes | typing.Callable[[], str | bytes]
+
+
+def inject_into_ssl() -> None:
+    """Injects the :class:`truststore.SSLContext` into the ``ssl``
+    module by replacing :class:`ssl.SSLContext`.
+    """
+    setattr(ssl, "SSLContext", SSLContext)
+    # urllib3 holds on to its own reference of ssl.SSLContext
+    # so we need to replace that reference too.
+    try:
+        import pip._vendor.urllib3.util.ssl_ as urllib3_ssl
+
+        setattr(urllib3_ssl, "SSLContext", SSLContext)
+    except ImportError:
+        pass
+
+
+def extract_from_ssl() -> None:
+    """Restores the :class:`ssl.SSLContext` class to its original state"""
+    setattr(ssl, "SSLContext", _original_SSLContext)
+    try:
+        import pip._vendor.urllib3.util.ssl_ as urllib3_ssl
+
+        urllib3_ssl.SSLContext = _original_SSLContext  # type: ignore[assignment]
+    except ImportError:
+        pass
+
+
+class SSLContext(_truststore_SSLContext_super_class):  # type: ignore[misc]
+    """SSLContext API that uses system certificates on all platforms"""
+
+    @property  # type: ignore[misc]
+    def __class__(self) -> type:
+        # Dirty hack to get around isinstance() checks
+        # for ssl.SSLContext instances in aiohttp/trustme
+        # when using non-CPython implementations.
+        return _truststore_SSLContext_dunder_class or SSLContext
+
+    def __init__(self, protocol: int = None) -> None:  # type: ignore[assignment]
+        self._ctx = _original_SSLContext(protocol)
+
+        class TruststoreSSLObject(ssl.SSLObject):
+            # This object exists because wrap_bio() doesn't
+            # immediately do the handshake so we need to do
+            # certificate verifications after SSLObject.do_handshake()
+
+            def do_handshake(self) -> None:
+                ret = super().do_handshake()
+                _verify_peercerts(self, server_hostname=self.server_hostname)
+                return ret
+
+        self._ctx.sslobject_class = TruststoreSSLObject
+
+    def wrap_socket(
+        self,
+        sock: socket.socket,
+        server_side: bool = False,
+        do_handshake_on_connect: bool = True,
+        suppress_ragged_eofs: bool = True,
+        server_hostname: str | None = None,
+        session: ssl.SSLSession | None = None,
+    ) -> ssl.SSLSocket:
+        # Use a context manager here because the
+        # inner SSLContext holds on to our state
+        # but also does the actual handshake.
+        with _configure_context(self._ctx):
+            ssl_sock = self._ctx.wrap_socket(
+                sock,
+                server_side=server_side,
+                server_hostname=server_hostname,
+                do_handshake_on_connect=do_handshake_on_connect,
+                suppress_ragged_eofs=suppress_ragged_eofs,
+                session=session,
+            )
+        try:
+            _verify_peercerts(ssl_sock, server_hostname=server_hostname)
+        except Exception:
+            ssl_sock.close()
+            raise
+        return ssl_sock
+
+    def wrap_bio(
+        self,
+        incoming: ssl.MemoryBIO,
+        outgoing: ssl.MemoryBIO,
+        server_side: bool = False,
+        server_hostname: str | None = None,
+        session: ssl.SSLSession | None = None,
+    ) -> ssl.SSLObject:
+        with _configure_context(self._ctx):
+            ssl_obj = self._ctx.wrap_bio(
+                incoming,
+                outgoing,
+                server_hostname=server_hostname,
+                server_side=server_side,
+                session=session,
+            )
+        return ssl_obj
+
+    def load_verify_locations(
+        self,
+        cafile: str | bytes | os.PathLike[str] | os.PathLike[bytes] | None = None,
+        capath: str | bytes | os.PathLike[str] | os.PathLike[bytes] | None = None,
+        cadata: typing.Union[str, "Buffer", None] = None,
+    ) -> None:
+        return self._ctx.load_verify_locations(
+            cafile=cafile, capath=capath, cadata=cadata
+        )
+
+    def load_cert_chain(
+        self,
+        certfile: _StrOrBytesPath,
+        keyfile: _StrOrBytesPath | None = None,
+        password: _PasswordType | None = None,
+    ) -> None:
+        return self._ctx.load_cert_chain(
+            certfile=certfile, keyfile=keyfile, password=password
+        )
+
+    def load_default_certs(
+        self, purpose: ssl.Purpose = ssl.Purpose.SERVER_AUTH
+    ) -> None:
+        return self._ctx.load_default_certs(purpose)
+
+    def set_alpn_protocols(self, alpn_protocols: typing.Iterable[str]) -> None:
+        return self._ctx.set_alpn_protocols(alpn_protocols)
+
+    def set_npn_protocols(self, npn_protocols: typing.Iterable[str]) -> None:
+        return self._ctx.set_npn_protocols(npn_protocols)
+
+    def set_ciphers(self, __cipherlist: str) -> None:
+        return self._ctx.set_ciphers(__cipherlist)
+
+    def get_ciphers(self) -> typing.Any:
+        return self._ctx.get_ciphers()
+
+    def session_stats(self) -> dict[str, int]:
+        return self._ctx.session_stats()
+
+    def cert_store_stats(self) -> dict[str, int]:
+        raise NotImplementedError()
+
+    def set_default_verify_paths(self) -> None:
+        self._ctx.set_default_verify_paths()
+
+    @typing.overload
+    def get_ca_certs(
+        self, binary_form: typing.Literal[False] = ...
+    ) -> list[typing.Any]: ...
+
+    @typing.overload
+    def get_ca_certs(self, binary_form: typing.Literal[True] = ...) -> list[bytes]: ...
+
+    @typing.overload
+    def get_ca_certs(self, binary_form: bool = ...) -> typing.Any: ...
+
+    def get_ca_certs(self, binary_form: bool = False) -> list[typing.Any] | list[bytes]:
+        raise NotImplementedError()
+
+    @property
+    def check_hostname(self) -> bool:
+        return self._ctx.check_hostname
+
+    @check_hostname.setter
+    def check_hostname(self, value: bool) -> None:
+        self._ctx.check_hostname = value
+
+    @property
+    def hostname_checks_common_name(self) -> bool:
+        return self._ctx.hostname_checks_common_name
+
+    @hostname_checks_common_name.setter
+    def hostname_checks_common_name(self, value: bool) -> None:
+        self._ctx.hostname_checks_common_name = value
+
+    @property
+    def keylog_filename(self) -> str:
+        return self._ctx.keylog_filename
+
+    @keylog_filename.setter
+    def keylog_filename(self, value: str) -> None:
+        self._ctx.keylog_filename = value
+
+    @property
+    def maximum_version(self) -> ssl.TLSVersion:
+        return self._ctx.maximum_version
+
+    @maximum_version.setter
+    def maximum_version(self, value: ssl.TLSVersion) -> None:
+        _original_super_SSLContext.maximum_version.__set__(  # type: ignore[attr-defined]
+            self._ctx, value
+        )
+
+    @property
+    def minimum_version(self) -> ssl.TLSVersion:
+        return self._ctx.minimum_version
+
+    @minimum_version.setter
+    def minimum_version(self, value: ssl.TLSVersion) -> None:
+        _original_super_SSLContext.minimum_version.__set__(  # type: ignore[attr-defined]
+            self._ctx, value
+        )
+
+    @property
+    def options(self) -> ssl.Options:
+        return self._ctx.options
+
+    @options.setter
+    def options(self, value: ssl.Options) -> None:
+        _original_super_SSLContext.options.__set__(  # type: ignore[attr-defined]
+            self._ctx, value
+        )
+
+    @property
+    def post_handshake_auth(self) -> bool:
+        return self._ctx.post_handshake_auth
+
+    @post_handshake_auth.setter
+    def post_handshake_auth(self, value: bool) -> None:
+        self._ctx.post_handshake_auth = value
+
+    @property
+    def protocol(self) -> ssl._SSLMethod:
+        return self._ctx.protocol
+
+    @property
+    def security_level(self) -> int:
+        return self._ctx.security_level
+
+    @property
+    def verify_flags(self) -> ssl.VerifyFlags:
+        return self._ctx.verify_flags
+
+    @verify_flags.setter
+    def verify_flags(self, value: ssl.VerifyFlags) -> None:
+        _original_super_SSLContext.verify_flags.__set__(  # type: ignore[attr-defined]
+            self._ctx, value
+        )
+
+    @property
+    def verify_mode(self) -> ssl.VerifyMode:
+        return self._ctx.verify_mode
+
+    @verify_mode.setter
+    def verify_mode(self, value: ssl.VerifyMode) -> None:
+        _original_super_SSLContext.verify_mode.__set__(  # type: ignore[attr-defined]
+            self._ctx, value
+        )
+
+
+# Python 3.13+ makes get_unverified_chain() a public API that only returns DER
+# encoded certificates. We detect whether we need to call public_bytes() for 3.10->3.12
+# Pre-3.13 returned None instead of an empty list from get_unverified_chain()
+if sys.version_info >= (3, 13):
+
+    def _get_unverified_chain_bytes(sslobj: ssl.SSLObject) -> list[bytes]:
+        unverified_chain = sslobj.get_unverified_chain() or ()  # type: ignore[attr-defined]
+        return [
+            cert if isinstance(cert, bytes) else cert.public_bytes(_ssl.ENCODING_DER)
+            for cert in unverified_chain
+        ]
+
+else:
+
+    def _get_unverified_chain_bytes(sslobj: ssl.SSLObject) -> list[bytes]:
+        unverified_chain = sslobj.get_unverified_chain() or ()  # type: ignore[attr-defined]
+        return [cert.public_bytes(_ssl.ENCODING_DER) for cert in unverified_chain]
+
+
+def _verify_peercerts(
+    sock_or_sslobj: ssl.SSLSocket | ssl.SSLObject, server_hostname: str | None
+) -> None:
+    """
+    Verifies the peer certificates from an SSLSocket or SSLObject
+    against the certificates in the OS trust store.
+    """
+    sslobj: ssl.SSLObject = sock_or_sslobj  # type: ignore[assignment]
+    try:
+        while not hasattr(sslobj, "get_unverified_chain"):
+            sslobj = sslobj._sslobj  # type: ignore[attr-defined]
+    except AttributeError:
+        pass
+
+    cert_bytes = _get_unverified_chain_bytes(sslobj)
+    _verify_peercerts_impl(
+        sock_or_sslobj.context, cert_bytes, server_hostname=server_hostname
+    )
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/truststore/_macos.py b/env/lib/python3.12/site-packages/pip/_vendor/truststore/_macos.py
new file mode 100644
index 0000000..3450307
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/truststore/_macos.py
@@ -0,0 +1,571 @@
+import contextlib
+import ctypes
+import platform
+import ssl
+import typing
+from ctypes import (
+    CDLL,
+    POINTER,
+    c_bool,
+    c_char_p,
+    c_int32,
+    c_long,
+    c_uint32,
+    c_ulong,
+    c_void_p,
+)
+from ctypes.util import find_library
+
+from ._ssl_constants import _set_ssl_context_verify_mode
+
+_mac_version = platform.mac_ver()[0]
+_mac_version_info = tuple(map(int, _mac_version.split(".")))
+if _mac_version_info < (10, 8):
+    raise ImportError(
+        f"Only OS X 10.8 and newer are supported, not {_mac_version_info[0]}.{_mac_version_info[1]}"
+    )
+
+_is_macos_version_10_14_or_later = _mac_version_info >= (10, 14)
+
+
+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 _mac_version_info >= (10, 16):
+            path = macos10_16_path
+        else:
+            path = find_library(name)
+        if not path:
+            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
+
+
+Security = _load_cdll(
+    "Security", "/System/Library/Frameworks/Security.framework/Security"
+)
+CoreFoundation = _load_cdll(
+    "CoreFoundation",
+    "/System/Library/Frameworks/CoreFoundation.framework/CoreFoundation",
+)
+
+Boolean = c_bool
+CFIndex = c_long
+CFStringEncoding = c_uint32
+CFData = c_void_p
+CFString = c_void_p
+CFArray = c_void_p
+CFMutableArray = c_void_p
+CFError = c_void_p
+CFType = c_void_p
+CFTypeID = c_ulong
+CFTypeRef = POINTER(CFType)
+CFAllocatorRef = c_void_p
+
+OSStatus = c_int32
+
+CFErrorRef = POINTER(CFError)
+CFDataRef = POINTER(CFData)
+CFStringRef = POINTER(CFString)
+CFArrayRef = POINTER(CFArray)
+CFMutableArrayRef = POINTER(CFMutableArray)
+CFArrayCallBacks = c_void_p
+CFOptionFlags = c_uint32
+
+SecCertificateRef = POINTER(c_void_p)
+SecPolicyRef = POINTER(c_void_p)
+SecTrustRef = POINTER(c_void_p)
+SecTrustResultType = c_uint32
+SecTrustOptionFlags = c_uint32
+
+try:
+    Security.SecCertificateCreateWithData.argtypes = [CFAllocatorRef, CFDataRef]
+    Security.SecCertificateCreateWithData.restype = SecCertificateRef
+
+    Security.SecCertificateCopyData.argtypes = [SecCertificateRef]
+    Security.SecCertificateCopyData.restype = CFDataRef
+
+    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
+    Security.SecCopyErrorMessageString.restype = CFStringRef
+
+    Security.SecTrustSetAnchorCertificates.argtypes = [SecTrustRef, CFArrayRef]
+    Security.SecTrustSetAnchorCertificates.restype = OSStatus
+
+    Security.SecTrustSetAnchorCertificatesOnly.argtypes = [SecTrustRef, Boolean]
+    Security.SecTrustSetAnchorCertificatesOnly.restype = OSStatus
+
+    Security.SecPolicyCreateRevocation.argtypes = [CFOptionFlags]
+    Security.SecPolicyCreateRevocation.restype = SecPolicyRef
+
+    Security.SecPolicyCreateSSL.argtypes = [Boolean, CFStringRef]
+    Security.SecPolicyCreateSSL.restype = SecPolicyRef
+
+    Security.SecTrustCreateWithCertificates.argtypes = [
+        CFTypeRef,
+        CFTypeRef,
+        POINTER(SecTrustRef),
+    ]
+    Security.SecTrustCreateWithCertificates.restype = OSStatus
+
+    Security.SecTrustGetTrustResult.argtypes = [
+        SecTrustRef,
+        POINTER(SecTrustResultType),
+    ]
+    Security.SecTrustGetTrustResult.restype = OSStatus
+
+    Security.SecTrustEvaluate.argtypes = [
+        SecTrustRef,
+        POINTER(SecTrustResultType),
+    ]
+    Security.SecTrustEvaluate.restype = OSStatus
+
+    Security.SecTrustRef = SecTrustRef  # type: ignore[attr-defined]
+    Security.SecTrustResultType = SecTrustResultType  # type: ignore[attr-defined]
+    Security.OSStatus = OSStatus  # type: ignore[attr-defined]
+
+    kSecRevocationUseAnyAvailableMethod = 3
+    kSecRevocationRequirePositiveResponse = 8
+
+    CoreFoundation.CFRelease.argtypes = [CFTypeRef]
+    CoreFoundation.CFRelease.restype = None
+
+    CoreFoundation.CFGetTypeID.argtypes = [CFTypeRef]
+    CoreFoundation.CFGetTypeID.restype = CFTypeID
+
+    CoreFoundation.CFStringCreateWithCString.argtypes = [
+        CFAllocatorRef,
+        c_char_p,
+        CFStringEncoding,
+    ]
+    CoreFoundation.CFStringCreateWithCString.restype = CFStringRef
+
+    CoreFoundation.CFStringGetCStringPtr.argtypes = [CFStringRef, CFStringEncoding]
+    CoreFoundation.CFStringGetCStringPtr.restype = c_char_p
+
+    CoreFoundation.CFStringGetCString.argtypes = [
+        CFStringRef,
+        c_char_p,
+        CFIndex,
+        CFStringEncoding,
+    ]
+    CoreFoundation.CFStringGetCString.restype = c_bool
+
+    CoreFoundation.CFDataCreate.argtypes = [CFAllocatorRef, c_char_p, CFIndex]
+    CoreFoundation.CFDataCreate.restype = CFDataRef
+
+    CoreFoundation.CFDataGetLength.argtypes = [CFDataRef]
+    CoreFoundation.CFDataGetLength.restype = CFIndex
+
+    CoreFoundation.CFDataGetBytePtr.argtypes = [CFDataRef]
+    CoreFoundation.CFDataGetBytePtr.restype = c_void_p
+
+    CoreFoundation.CFArrayCreate.argtypes = [
+        CFAllocatorRef,
+        POINTER(CFTypeRef),
+        CFIndex,
+        CFArrayCallBacks,
+    ]
+    CoreFoundation.CFArrayCreate.restype = CFArrayRef
+
+    CoreFoundation.CFArrayCreateMutable.argtypes = [
+        CFAllocatorRef,
+        CFIndex,
+        CFArrayCallBacks,
+    ]
+    CoreFoundation.CFArrayCreateMutable.restype = CFMutableArrayRef
+
+    CoreFoundation.CFArrayAppendValue.argtypes = [CFMutableArrayRef, c_void_p]
+    CoreFoundation.CFArrayAppendValue.restype = None
+
+    CoreFoundation.CFArrayGetCount.argtypes = [CFArrayRef]
+    CoreFoundation.CFArrayGetCount.restype = CFIndex
+
+    CoreFoundation.CFArrayGetValueAtIndex.argtypes = [CFArrayRef, CFIndex]
+    CoreFoundation.CFArrayGetValueAtIndex.restype = c_void_p
+
+    CoreFoundation.CFErrorGetCode.argtypes = [CFErrorRef]
+    CoreFoundation.CFErrorGetCode.restype = CFIndex
+
+    CoreFoundation.CFErrorCopyDescription.argtypes = [CFErrorRef]
+    CoreFoundation.CFErrorCopyDescription.restype = CFStringRef
+
+    CoreFoundation.kCFAllocatorDefault = CFAllocatorRef.in_dll(  # type: ignore[attr-defined]
+        CoreFoundation, "kCFAllocatorDefault"
+    )
+    CoreFoundation.kCFTypeArrayCallBacks = c_void_p.in_dll(  # type: ignore[attr-defined]
+        CoreFoundation, "kCFTypeArrayCallBacks"
+    )
+
+    CoreFoundation.CFTypeRef = CFTypeRef  # type: ignore[attr-defined]
+    CoreFoundation.CFArrayRef = CFArrayRef  # type: ignore[attr-defined]
+    CoreFoundation.CFStringRef = CFStringRef  # type: ignore[attr-defined]
+    CoreFoundation.CFErrorRef = CFErrorRef  # type: ignore[attr-defined]
+
+except AttributeError as e:
+    raise ImportError(f"Error initializing ctypes: {e}") from None
+
+# SecTrustEvaluateWithError is macOS 10.14+
+if _is_macos_version_10_14_or_later:
+    try:
+        Security.SecTrustEvaluateWithError.argtypes = [
+            SecTrustRef,
+            POINTER(CFErrorRef),
+        ]
+        Security.SecTrustEvaluateWithError.restype = c_bool
+    except AttributeError as e:
+        raise ImportError(f"Error initializing ctypes: {e}") from None
+
+
+def _handle_osstatus(result: OSStatus, _: typing.Any, args: typing.Any) -> typing.Any:
+    """
+    Raises an error if the OSStatus value is non-zero.
+    """
+    if int(result) == 0:
+        return args
+
+    # Returns a CFString which we need to transform
+    # into a UTF-8 Python string.
+    error_message_cfstring = None
+    try:
+        error_message_cfstring = Security.SecCopyErrorMessageString(result, None)
+
+        # First step is convert the CFString into a C string pointer.
+        # We try the fast no-copy way first.
+        error_message_cfstring_c_void_p = ctypes.cast(
+            error_message_cfstring, ctypes.POINTER(ctypes.c_void_p)
+        )
+        message = CoreFoundation.CFStringGetCStringPtr(
+            error_message_cfstring_c_void_p, CFConst.kCFStringEncodingUTF8
+        )
+
+        # Quoting the Apple dev docs:
+        #
+        # "A pointer to a C string or NULL if the internal
+        # storage of theString does not allow this to be
+        # returned efficiently."
+        #
+        # So we need to get our hands dirty.
+        if message is None:
+            buffer = ctypes.create_string_buffer(1024)
+            result = CoreFoundation.CFStringGetCString(
+                error_message_cfstring_c_void_p,
+                buffer,
+                1024,
+                CFConst.kCFStringEncodingUTF8,
+            )
+            if not result:
+                raise OSError("Error copying C string from CFStringRef")
+            message = buffer.value
+
+    finally:
+        if error_message_cfstring is not None:
+            CoreFoundation.CFRelease(error_message_cfstring)
+
+    # If no message can be found for this status we come
+    # up with a generic one that forwards the status code.
+    if message is None or message == "":
+        message = f"SecureTransport operation returned a non-zero OSStatus: {result}"
+
+    raise ssl.SSLError(message)
+
+
+Security.SecTrustCreateWithCertificates.errcheck = _handle_osstatus  # type: ignore[assignment]
+Security.SecTrustSetAnchorCertificates.errcheck = _handle_osstatus  # type: ignore[assignment]
+Security.SecTrustSetAnchorCertificatesOnly.errcheck = _handle_osstatus  # type: ignore[assignment]
+Security.SecTrustGetTrustResult.errcheck = _handle_osstatus  # type: ignore[assignment]
+Security.SecTrustEvaluate.errcheck = _handle_osstatus  # type: ignore[assignment]
+
+
+class CFConst:
+    """CoreFoundation constants"""
+
+    kCFStringEncodingUTF8 = CFStringEncoding(0x08000100)
+
+    errSecIncompleteCertRevocationCheck = -67635
+    errSecHostNameMismatch = -67602
+    errSecCertificateExpired = -67818
+    errSecNotTrusted = -67843
+
+
+def _bytes_to_cf_data_ref(value: bytes) -> CFDataRef:  # type: ignore[valid-type]
+    return CoreFoundation.CFDataCreate(  # type: ignore[no-any-return]
+        CoreFoundation.kCFAllocatorDefault, value, len(value)
+    )
+
+
+def _bytes_to_cf_string(value: bytes) -> CFString:
+    """
+    Given a Python binary data, create a CFString.
+    The string must be CFReleased by the caller.
+    """
+    c_str = ctypes.c_char_p(value)
+    cf_str = CoreFoundation.CFStringCreateWithCString(
+        CoreFoundation.kCFAllocatorDefault,
+        c_str,
+        CFConst.kCFStringEncodingUTF8,
+    )
+    return cf_str  # type: ignore[no-any-return]
+
+
+def _cf_string_ref_to_str(cf_string_ref: CFStringRef) -> str | None:  # type: ignore[valid-type]
+    """
+    Creates a Unicode string from a CFString object. Used entirely for error
+    reporting.
+    Yes, it annoys me quite a lot that this function is this complex.
+    """
+
+    string = CoreFoundation.CFStringGetCStringPtr(
+        cf_string_ref, CFConst.kCFStringEncodingUTF8
+    )
+    if string is None:
+        buffer = ctypes.create_string_buffer(1024)
+        result = CoreFoundation.CFStringGetCString(
+            cf_string_ref, buffer, 1024, CFConst.kCFStringEncodingUTF8
+        )
+        if not result:
+            raise OSError("Error copying C string from CFStringRef")
+        string = buffer.value
+    if string is not None:
+        string = string.decode("utf-8")
+    return string  # type: ignore[no-any-return]
+
+
+def _der_certs_to_cf_cert_array(certs: list[bytes]) -> CFMutableArrayRef:  # type: ignore[valid-type]
+    """Builds a CFArray of SecCertificateRefs from a list of DER-encoded certificates.
+    Responsibility of the caller to call CoreFoundation.CFRelease on the CFArray.
+    """
+    cf_array = CoreFoundation.CFArrayCreateMutable(
+        CoreFoundation.kCFAllocatorDefault,
+        0,
+        ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+    )
+    if not cf_array:
+        raise MemoryError("Unable to allocate memory!")
+
+    for cert_data in certs:
+        cf_data = None
+        sec_cert_ref = None
+        try:
+            cf_data = _bytes_to_cf_data_ref(cert_data)
+            sec_cert_ref = Security.SecCertificateCreateWithData(
+                CoreFoundation.kCFAllocatorDefault, cf_data
+            )
+            CoreFoundation.CFArrayAppendValue(cf_array, sec_cert_ref)
+        finally:
+            if cf_data:
+                CoreFoundation.CFRelease(cf_data)
+            if sec_cert_ref:
+                CoreFoundation.CFRelease(sec_cert_ref)
+
+    return cf_array  # type: ignore[no-any-return]
+
+
+@contextlib.contextmanager
+def _configure_context(ctx: ssl.SSLContext) -> typing.Iterator[None]:
+    check_hostname = ctx.check_hostname
+    verify_mode = ctx.verify_mode
+    ctx.check_hostname = False
+    _set_ssl_context_verify_mode(ctx, ssl.CERT_NONE)
+    try:
+        yield
+    finally:
+        ctx.check_hostname = check_hostname
+        _set_ssl_context_verify_mode(ctx, verify_mode)
+
+
+def _verify_peercerts_impl(
+    ssl_context: ssl.SSLContext,
+    cert_chain: list[bytes],
+    server_hostname: str | None = None,
+) -> None:
+    certs = None
+    policies = None
+    trust = None
+    try:
+        # Only set a hostname on the policy if we're verifying the hostname
+        # on the leaf certificate.
+        if server_hostname is not None and ssl_context.check_hostname:
+            cf_str_hostname = None
+            try:
+                cf_str_hostname = _bytes_to_cf_string(server_hostname.encode("ascii"))
+                ssl_policy = Security.SecPolicyCreateSSL(True, cf_str_hostname)
+            finally:
+                if cf_str_hostname:
+                    CoreFoundation.CFRelease(cf_str_hostname)
+        else:
+            ssl_policy = Security.SecPolicyCreateSSL(True, None)
+
+        policies = ssl_policy
+        if ssl_context.verify_flags & ssl.VERIFY_CRL_CHECK_CHAIN:
+            # Add explicit policy requiring positive revocation checks
+            policies = CoreFoundation.CFArrayCreateMutable(
+                CoreFoundation.kCFAllocatorDefault,
+                0,
+                ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+            )
+            CoreFoundation.CFArrayAppendValue(policies, ssl_policy)
+            CoreFoundation.CFRelease(ssl_policy)
+            revocation_policy = Security.SecPolicyCreateRevocation(
+                kSecRevocationUseAnyAvailableMethod
+                | kSecRevocationRequirePositiveResponse
+            )
+            CoreFoundation.CFArrayAppendValue(policies, revocation_policy)
+            CoreFoundation.CFRelease(revocation_policy)
+        elif ssl_context.verify_flags & ssl.VERIFY_CRL_CHECK_LEAF:
+            raise NotImplementedError("VERIFY_CRL_CHECK_LEAF not implemented for macOS")
+
+        certs = None
+        try:
+            certs = _der_certs_to_cf_cert_array(cert_chain)
+
+            # Now that we have certificates loaded and a SecPolicy
+            # we can finally create a SecTrust object!
+            trust = Security.SecTrustRef()
+            Security.SecTrustCreateWithCertificates(
+                certs, policies, ctypes.byref(trust)
+            )
+
+        finally:
+            # The certs are now being held by SecTrust so we can
+            # release our handles for the array.
+            if certs:
+                CoreFoundation.CFRelease(certs)
+
+        # If there are additional trust anchors to load we need to transform
+        # the list of DER-encoded certificates into a CFArray.
+        ctx_ca_certs_der: list[bytes] | None = ssl_context.get_ca_certs(
+            binary_form=True
+        )
+        if ctx_ca_certs_der:
+            ctx_ca_certs = None
+            try:
+                ctx_ca_certs = _der_certs_to_cf_cert_array(ctx_ca_certs_der)
+                Security.SecTrustSetAnchorCertificates(trust, ctx_ca_certs)
+            finally:
+                if ctx_ca_certs:
+                    CoreFoundation.CFRelease(ctx_ca_certs)
+
+        # We always want system certificates.
+        Security.SecTrustSetAnchorCertificatesOnly(trust, False)
+
+        # macOS 10.13 and earlier don't support SecTrustEvaluateWithError()
+        # so we use SecTrustEvaluate() which means we need to construct error
+        # messages ourselves.
+        if _is_macos_version_10_14_or_later:
+            _verify_peercerts_impl_macos_10_14(ssl_context, trust)
+        else:
+            _verify_peercerts_impl_macos_10_13(ssl_context, trust)
+    finally:
+        if policies:
+            CoreFoundation.CFRelease(policies)
+        if trust:
+            CoreFoundation.CFRelease(trust)
+
+
+def _verify_peercerts_impl_macos_10_13(
+    ssl_context: ssl.SSLContext, sec_trust_ref: typing.Any
+) -> None:
+    """Verify using 'SecTrustEvaluate' API for macOS 10.13 and earlier.
+    macOS 10.14 added the 'SecTrustEvaluateWithError' API.
+    """
+    sec_trust_result_type = Security.SecTrustResultType()
+    Security.SecTrustEvaluate(sec_trust_ref, ctypes.byref(sec_trust_result_type))
+
+    try:
+        sec_trust_result_type_as_int = int(sec_trust_result_type.value)
+    except (ValueError, TypeError):
+        sec_trust_result_type_as_int = -1
+
+    # Apple doesn't document these values in their own API docs.
+    # See: https://github.com/xybp888/iOS-SDKs/blob/master/iPhoneOS13.0.sdk/System/Library/Frameworks/Security.framework/Headers/SecTrust.h#L84
+    if (
+        ssl_context.verify_mode == ssl.CERT_REQUIRED
+        and sec_trust_result_type_as_int not in (1, 4)
+    ):
+        # Note that we're not able to ignore only hostname errors
+        # for macOS 10.13 and earlier, so check_hostname=False will
+        # still return an error.
+        sec_trust_result_type_to_message = {
+            0: "Invalid trust result type",
+            # 1: "Trust evaluation succeeded",
+            2: "User confirmation required",
+            3: "User specified that certificate is not trusted",
+            # 4: "Trust result is unspecified",
+            5: "Recoverable trust failure occurred",
+            6: "Fatal trust failure occurred",
+            7: "Other error occurred, certificate may be revoked",
+        }
+        error_message = sec_trust_result_type_to_message.get(
+            sec_trust_result_type_as_int,
+            f"Unknown trust result: {sec_trust_result_type_as_int}",
+        )
+
+        err = ssl.SSLCertVerificationError(error_message)
+        err.verify_message = error_message
+        err.verify_code = sec_trust_result_type_as_int
+        raise err
+
+
+def _verify_peercerts_impl_macos_10_14(
+    ssl_context: ssl.SSLContext, sec_trust_ref: typing.Any
+) -> None:
+    """Verify using 'SecTrustEvaluateWithError' API for macOS 10.14+."""
+    cf_error = CoreFoundation.CFErrorRef()
+    sec_trust_eval_result = Security.SecTrustEvaluateWithError(
+        sec_trust_ref, ctypes.byref(cf_error)
+    )
+    # sec_trust_eval_result is a bool (0 or 1)
+    # where 1 means that the certs are trusted.
+    if sec_trust_eval_result == 1:
+        is_trusted = True
+    elif sec_trust_eval_result == 0:
+        is_trusted = False
+    else:
+        raise ssl.SSLError(
+            f"Unknown result from Security.SecTrustEvaluateWithError: {sec_trust_eval_result!r}"
+        )
+
+    cf_error_code = 0
+    if not is_trusted:
+        cf_error_code = CoreFoundation.CFErrorGetCode(cf_error)
+
+        # If the error is a known failure that we're
+        # explicitly okay with from SSLContext configuration
+        # we can set is_trusted accordingly.
+        if ssl_context.verify_mode != ssl.CERT_REQUIRED and (
+            cf_error_code == CFConst.errSecNotTrusted
+            or cf_error_code == CFConst.errSecCertificateExpired
+        ):
+            is_trusted = True
+
+    # If we're still not trusted then we start to
+    # construct and raise the SSLCertVerificationError.
+    if not is_trusted:
+        cf_error_string_ref = None
+        try:
+            cf_error_string_ref = CoreFoundation.CFErrorCopyDescription(cf_error)
+
+            # Can this ever return 'None' if there's a CFError?
+            cf_error_message = (
+                _cf_string_ref_to_str(cf_error_string_ref)
+                or "Certificate verification failed"
+            )
+
+            # TODO: Not sure if we need the SecTrustResultType for anything?
+            # We only care whether or not it's a success or failure for now.
+            sec_trust_result_type = Security.SecTrustResultType()
+            Security.SecTrustGetTrustResult(
+                sec_trust_ref, ctypes.byref(sec_trust_result_type)
+            )
+
+            err = ssl.SSLCertVerificationError(cf_error_message)
+            err.verify_message = cf_error_message
+            err.verify_code = cf_error_code
+            raise err
+        finally:
+            if cf_error_string_ref:
+                CoreFoundation.CFRelease(cf_error_string_ref)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/truststore/_openssl.py b/env/lib/python3.12/site-packages/pip/_vendor/truststore/_openssl.py
new file mode 100644
index 0000000..9951cf7
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/truststore/_openssl.py
@@ -0,0 +1,66 @@
+import contextlib
+import os
+import re
+import ssl
+import typing
+
+# candidates based on https://github.com/tiran/certifi-system-store by Christian Heimes
+_CA_FILE_CANDIDATES = [
+    # Alpine, Arch, Fedora 34+, OpenWRT, RHEL 9+, BSD
+    "/etc/ssl/cert.pem",
+    # Fedora <= 34, RHEL <= 9, CentOS <= 9
+    "/etc/pki/tls/cert.pem",
+    # Debian, Ubuntu (requires ca-certificates)
+    "/etc/ssl/certs/ca-certificates.crt",
+    # SUSE
+    "/etc/ssl/ca-bundle.pem",
+]
+
+_HASHED_CERT_FILENAME_RE = re.compile(r"^[0-9a-fA-F]{8}\.[0-9]$")
+
+
+@contextlib.contextmanager
+def _configure_context(ctx: ssl.SSLContext) -> typing.Iterator[None]:
+    # First, check whether the default locations from OpenSSL
+    # seem like they will give us a usable set of CA certs.
+    # ssl.get_default_verify_paths already takes care of:
+    # - getting cafile from either the SSL_CERT_FILE env var
+    #   or the path configured when OpenSSL was compiled,
+    #   and verifying that that path exists
+    # - getting capath from either the SSL_CERT_DIR env var
+    #   or the path configured when OpenSSL was compiled,
+    #   and verifying that that path exists
+    # In addition we'll check whether capath appears to contain certs.
+    defaults = ssl.get_default_verify_paths()
+    if defaults.cafile or (defaults.capath and _capath_contains_certs(defaults.capath)):
+        ctx.set_default_verify_paths()
+    else:
+        # cafile from OpenSSL doesn't exist
+        # and capath from OpenSSL doesn't contain certs.
+        # Let's search other common locations instead.
+        for cafile in _CA_FILE_CANDIDATES:
+            if os.path.isfile(cafile):
+                ctx.load_verify_locations(cafile=cafile)
+                break
+
+    yield
+
+
+def _capath_contains_certs(capath: str) -> bool:
+    """Check whether capath exists and contains certs in the expected format."""
+    if not os.path.isdir(capath):
+        return False
+    for name in os.listdir(capath):
+        if _HASHED_CERT_FILENAME_RE.match(name):
+            return True
+    return False
+
+
+def _verify_peercerts_impl(
+    ssl_context: ssl.SSLContext,
+    cert_chain: list[bytes],
+    server_hostname: str | None = None,
+) -> None:
+    # This is a no-op because we've enabled SSLContext's built-in
+    # verification via verify_mode=CERT_REQUIRED, and don't need to repeat it.
+    pass
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/truststore/_ssl_constants.py b/env/lib/python3.12/site-packages/pip/_vendor/truststore/_ssl_constants.py
new file mode 100644
index 0000000..b1ee7a3
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/truststore/_ssl_constants.py
@@ -0,0 +1,31 @@
+import ssl
+import sys
+import typing
+
+# Hold on to the original class so we can create it consistently
+# even if we inject our own SSLContext into the ssl module.
+_original_SSLContext = ssl.SSLContext
+_original_super_SSLContext = super(_original_SSLContext, _original_SSLContext)
+
+# CPython is known to be good, but non-CPython implementations
+# may implement SSLContext differently so to be safe we don't
+# subclass the SSLContext.
+
+# This is returned by truststore.SSLContext.__class__()
+_truststore_SSLContext_dunder_class: typing.Optional[type]
+
+# This value is the superclass of truststore.SSLContext.
+_truststore_SSLContext_super_class: type
+
+if sys.implementation.name == "cpython":
+    _truststore_SSLContext_super_class = _original_SSLContext
+    _truststore_SSLContext_dunder_class = None
+else:
+    _truststore_SSLContext_super_class = object
+    _truststore_SSLContext_dunder_class = _original_SSLContext
+
+
+def _set_ssl_context_verify_mode(
+    ssl_context: ssl.SSLContext, verify_mode: ssl.VerifyMode
+) -> None:
+    _original_super_SSLContext.verify_mode.__set__(ssl_context, verify_mode)  # type: ignore[attr-defined]
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/truststore/_windows.py b/env/lib/python3.12/site-packages/pip/_vendor/truststore/_windows.py
new file mode 100644
index 0000000..a9bf9ab
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/truststore/_windows.py
@@ -0,0 +1,567 @@
+import contextlib
+import ssl
+import typing
+from ctypes import WinDLL  # type: ignore
+from ctypes import WinError  # type: ignore
+from ctypes import (
+    POINTER,
+    Structure,
+    c_char_p,
+    c_ulong,
+    c_void_p,
+    c_wchar_p,
+    cast,
+    create_unicode_buffer,
+    pointer,
+    sizeof,
+)
+from ctypes.wintypes import (
+    BOOL,
+    DWORD,
+    HANDLE,
+    LONG,
+    LPCSTR,
+    LPCVOID,
+    LPCWSTR,
+    LPFILETIME,
+    LPSTR,
+    LPWSTR,
+)
+from typing import TYPE_CHECKING, Any
+
+from ._ssl_constants import _set_ssl_context_verify_mode
+
+HCERTCHAINENGINE = HANDLE
+HCERTSTORE = HANDLE
+HCRYPTPROV_LEGACY = HANDLE
+
+
+class CERT_CONTEXT(Structure):
+    _fields_ = (
+        ("dwCertEncodingType", DWORD),
+        ("pbCertEncoded", c_void_p),
+        ("cbCertEncoded", DWORD),
+        ("pCertInfo", c_void_p),
+        ("hCertStore", HCERTSTORE),
+    )
+
+
+PCERT_CONTEXT = POINTER(CERT_CONTEXT)
+PCCERT_CONTEXT = POINTER(PCERT_CONTEXT)
+
+
+class CERT_ENHKEY_USAGE(Structure):
+    _fields_ = (
+        ("cUsageIdentifier", DWORD),
+        ("rgpszUsageIdentifier", POINTER(LPSTR)),
+    )
+
+
+PCERT_ENHKEY_USAGE = POINTER(CERT_ENHKEY_USAGE)
+
+
+class CERT_USAGE_MATCH(Structure):
+    _fields_ = (
+        ("dwType", DWORD),
+        ("Usage", CERT_ENHKEY_USAGE),
+    )
+
+
+class CERT_CHAIN_PARA(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("RequestedUsage", CERT_USAGE_MATCH),
+        ("RequestedIssuancePolicy", CERT_USAGE_MATCH),
+        ("dwUrlRetrievalTimeout", DWORD),
+        ("fCheckRevocationFreshnessTime", BOOL),
+        ("dwRevocationFreshnessTime", DWORD),
+        ("pftCacheResync", LPFILETIME),
+        ("pStrongSignPara", c_void_p),
+        ("dwStrongSignFlags", DWORD),
+    )
+
+
+if TYPE_CHECKING:
+    PCERT_CHAIN_PARA = pointer[CERT_CHAIN_PARA]  # type: ignore[misc]
+else:
+    PCERT_CHAIN_PARA = POINTER(CERT_CHAIN_PARA)
+
+
+class CERT_TRUST_STATUS(Structure):
+    _fields_ = (
+        ("dwErrorStatus", DWORD),
+        ("dwInfoStatus", DWORD),
+    )
+
+
+class CERT_CHAIN_ELEMENT(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("pCertContext", PCERT_CONTEXT),
+        ("TrustStatus", CERT_TRUST_STATUS),
+        ("pRevocationInfo", c_void_p),
+        ("pIssuanceUsage", PCERT_ENHKEY_USAGE),
+        ("pApplicationUsage", PCERT_ENHKEY_USAGE),
+        ("pwszExtendedErrorInfo", LPCWSTR),
+    )
+
+
+PCERT_CHAIN_ELEMENT = POINTER(CERT_CHAIN_ELEMENT)
+
+
+class CERT_SIMPLE_CHAIN(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("TrustStatus", CERT_TRUST_STATUS),
+        ("cElement", DWORD),
+        ("rgpElement", POINTER(PCERT_CHAIN_ELEMENT)),
+        ("pTrustListInfo", c_void_p),
+        ("fHasRevocationFreshnessTime", BOOL),
+        ("dwRevocationFreshnessTime", DWORD),
+    )
+
+
+PCERT_SIMPLE_CHAIN = POINTER(CERT_SIMPLE_CHAIN)
+
+
+class CERT_CHAIN_CONTEXT(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("TrustStatus", CERT_TRUST_STATUS),
+        ("cChain", DWORD),
+        ("rgpChain", POINTER(PCERT_SIMPLE_CHAIN)),
+        ("cLowerQualityChainContext", DWORD),
+        ("rgpLowerQualityChainContext", c_void_p),
+        ("fHasRevocationFreshnessTime", BOOL),
+        ("dwRevocationFreshnessTime", DWORD),
+    )
+
+
+PCERT_CHAIN_CONTEXT = POINTER(CERT_CHAIN_CONTEXT)
+PCCERT_CHAIN_CONTEXT = POINTER(PCERT_CHAIN_CONTEXT)
+
+
+class SSL_EXTRA_CERT_CHAIN_POLICY_PARA(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("dwAuthType", DWORD),
+        ("fdwChecks", DWORD),
+        ("pwszServerName", LPCWSTR),
+    )
+
+
+class CERT_CHAIN_POLICY_PARA(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("dwFlags", DWORD),
+        ("pvExtraPolicyPara", c_void_p),
+    )
+
+
+PCERT_CHAIN_POLICY_PARA = POINTER(CERT_CHAIN_POLICY_PARA)
+
+
+class CERT_CHAIN_POLICY_STATUS(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("dwError", DWORD),
+        ("lChainIndex", LONG),
+        ("lElementIndex", LONG),
+        ("pvExtraPolicyStatus", c_void_p),
+    )
+
+
+PCERT_CHAIN_POLICY_STATUS = POINTER(CERT_CHAIN_POLICY_STATUS)
+
+
+class CERT_CHAIN_ENGINE_CONFIG(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("hRestrictedRoot", HCERTSTORE),
+        ("hRestrictedTrust", HCERTSTORE),
+        ("hRestrictedOther", HCERTSTORE),
+        ("cAdditionalStore", DWORD),
+        ("rghAdditionalStore", c_void_p),
+        ("dwFlags", DWORD),
+        ("dwUrlRetrievalTimeout", DWORD),
+        ("MaximumCachedCertificates", DWORD),
+        ("CycleDetectionModulus", DWORD),
+        ("hExclusiveRoot", HCERTSTORE),
+        ("hExclusiveTrustedPeople", HCERTSTORE),
+        ("dwExclusiveFlags", DWORD),
+    )
+
+
+PCERT_CHAIN_ENGINE_CONFIG = POINTER(CERT_CHAIN_ENGINE_CONFIG)
+PHCERTCHAINENGINE = POINTER(HCERTCHAINENGINE)
+
+X509_ASN_ENCODING = 0x00000001
+PKCS_7_ASN_ENCODING = 0x00010000
+CERT_STORE_PROV_MEMORY = b"Memory"
+CERT_STORE_ADD_USE_EXISTING = 2
+USAGE_MATCH_TYPE_OR = 1
+OID_PKIX_KP_SERVER_AUTH = c_char_p(b"1.3.6.1.5.5.7.3.1")
+CERT_CHAIN_REVOCATION_CHECK_END_CERT = 0x10000000
+CERT_CHAIN_REVOCATION_CHECK_CHAIN = 0x20000000
+CERT_CHAIN_POLICY_IGNORE_ALL_NOT_TIME_VALID_FLAGS = 0x00000007
+CERT_CHAIN_POLICY_IGNORE_INVALID_BASIC_CONSTRAINTS_FLAG = 0x00000008
+CERT_CHAIN_POLICY_ALLOW_UNKNOWN_CA_FLAG = 0x00000010
+CERT_CHAIN_POLICY_IGNORE_INVALID_NAME_FLAG = 0x00000040
+CERT_CHAIN_POLICY_IGNORE_WRONG_USAGE_FLAG = 0x00000020
+CERT_CHAIN_POLICY_IGNORE_INVALID_POLICY_FLAG = 0x00000080
+CERT_CHAIN_POLICY_IGNORE_ALL_REV_UNKNOWN_FLAGS = 0x00000F00
+CERT_CHAIN_POLICY_ALLOW_TESTROOT_FLAG = 0x00008000
+CERT_CHAIN_POLICY_TRUST_TESTROOT_FLAG = 0x00004000
+SECURITY_FLAG_IGNORE_CERT_CN_INVALID = 0x00001000
+AUTHTYPE_SERVER = 2
+CERT_CHAIN_POLICY_SSL = 4
+FORMAT_MESSAGE_FROM_SYSTEM = 0x00001000
+FORMAT_MESSAGE_IGNORE_INSERTS = 0x00000200
+
+# Flags to set for SSLContext.verify_mode=CERT_NONE
+CERT_CHAIN_POLICY_VERIFY_MODE_NONE_FLAGS = (
+    CERT_CHAIN_POLICY_IGNORE_ALL_NOT_TIME_VALID_FLAGS
+    | CERT_CHAIN_POLICY_IGNORE_INVALID_BASIC_CONSTRAINTS_FLAG
+    | CERT_CHAIN_POLICY_ALLOW_UNKNOWN_CA_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_INVALID_NAME_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_WRONG_USAGE_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_INVALID_POLICY_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_ALL_REV_UNKNOWN_FLAGS
+    | CERT_CHAIN_POLICY_ALLOW_TESTROOT_FLAG
+    | CERT_CHAIN_POLICY_TRUST_TESTROOT_FLAG
+)
+
+wincrypt = WinDLL("crypt32.dll")
+kernel32 = WinDLL("kernel32.dll")
+
+
+def _handle_win_error(result: bool, _: Any, args: Any) -> Any:
+    if not result:
+        # Note, actually raises OSError after calling GetLastError and FormatMessage
+        raise WinError()
+    return args
+
+
+CertCreateCertificateChainEngine = wincrypt.CertCreateCertificateChainEngine
+CertCreateCertificateChainEngine.argtypes = (
+    PCERT_CHAIN_ENGINE_CONFIG,
+    PHCERTCHAINENGINE,
+)
+CertCreateCertificateChainEngine.errcheck = _handle_win_error
+
+CertOpenStore = wincrypt.CertOpenStore
+CertOpenStore.argtypes = (LPCSTR, DWORD, HCRYPTPROV_LEGACY, DWORD, c_void_p)
+CertOpenStore.restype = HCERTSTORE
+CertOpenStore.errcheck = _handle_win_error
+
+CertAddEncodedCertificateToStore = wincrypt.CertAddEncodedCertificateToStore
+CertAddEncodedCertificateToStore.argtypes = (
+    HCERTSTORE,
+    DWORD,
+    c_char_p,
+    DWORD,
+    DWORD,
+    PCCERT_CONTEXT,
+)
+CertAddEncodedCertificateToStore.restype = BOOL
+
+CertCreateCertificateContext = wincrypt.CertCreateCertificateContext
+CertCreateCertificateContext.argtypes = (DWORD, c_char_p, DWORD)
+CertCreateCertificateContext.restype = PCERT_CONTEXT
+CertCreateCertificateContext.errcheck = _handle_win_error
+
+CertGetCertificateChain = wincrypt.CertGetCertificateChain
+CertGetCertificateChain.argtypes = (
+    HCERTCHAINENGINE,
+    PCERT_CONTEXT,
+    LPFILETIME,
+    HCERTSTORE,
+    PCERT_CHAIN_PARA,
+    DWORD,
+    c_void_p,
+    PCCERT_CHAIN_CONTEXT,
+)
+CertGetCertificateChain.restype = BOOL
+CertGetCertificateChain.errcheck = _handle_win_error
+
+CertVerifyCertificateChainPolicy = wincrypt.CertVerifyCertificateChainPolicy
+CertVerifyCertificateChainPolicy.argtypes = (
+    c_ulong,
+    PCERT_CHAIN_CONTEXT,
+    PCERT_CHAIN_POLICY_PARA,
+    PCERT_CHAIN_POLICY_STATUS,
+)
+CertVerifyCertificateChainPolicy.restype = BOOL
+
+CertCloseStore = wincrypt.CertCloseStore
+CertCloseStore.argtypes = (HCERTSTORE, DWORD)
+CertCloseStore.restype = BOOL
+CertCloseStore.errcheck = _handle_win_error
+
+CertFreeCertificateChain = wincrypt.CertFreeCertificateChain
+CertFreeCertificateChain.argtypes = (PCERT_CHAIN_CONTEXT,)
+
+CertFreeCertificateContext = wincrypt.CertFreeCertificateContext
+CertFreeCertificateContext.argtypes = (PCERT_CONTEXT,)
+
+CertFreeCertificateChainEngine = wincrypt.CertFreeCertificateChainEngine
+CertFreeCertificateChainEngine.argtypes = (HCERTCHAINENGINE,)
+
+FormatMessageW = kernel32.FormatMessageW
+FormatMessageW.argtypes = (
+    DWORD,
+    LPCVOID,
+    DWORD,
+    DWORD,
+    LPWSTR,
+    DWORD,
+    c_void_p,
+)
+FormatMessageW.restype = DWORD
+
+
+def _verify_peercerts_impl(
+    ssl_context: ssl.SSLContext,
+    cert_chain: list[bytes],
+    server_hostname: str | None = None,
+) -> None:
+    """Verify the cert_chain from the server using Windows APIs."""
+
+    # If the peer didn't send any certificates then
+    # we can't do verification. Raise an error.
+    if not cert_chain:
+        raise ssl.SSLCertVerificationError("Peer sent no certificates to verify")
+
+    pCertContext = None
+    hIntermediateCertStore = CertOpenStore(CERT_STORE_PROV_MEMORY, 0, None, 0, None)
+    try:
+        # Add intermediate certs to an in-memory cert store
+        for cert_bytes in cert_chain[1:]:
+            CertAddEncodedCertificateToStore(
+                hIntermediateCertStore,
+                X509_ASN_ENCODING | PKCS_7_ASN_ENCODING,
+                cert_bytes,
+                len(cert_bytes),
+                CERT_STORE_ADD_USE_EXISTING,
+                None,
+            )
+
+        # Cert context for leaf cert
+        leaf_cert = cert_chain[0]
+        pCertContext = CertCreateCertificateContext(
+            X509_ASN_ENCODING | PKCS_7_ASN_ENCODING, leaf_cert, len(leaf_cert)
+        )
+
+        # Chain params to match certs for serverAuth extended usage
+        cert_enhkey_usage = CERT_ENHKEY_USAGE()
+        cert_enhkey_usage.cUsageIdentifier = 1
+        cert_enhkey_usage.rgpszUsageIdentifier = (c_char_p * 1)(OID_PKIX_KP_SERVER_AUTH)
+        cert_usage_match = CERT_USAGE_MATCH()
+        cert_usage_match.Usage = cert_enhkey_usage
+        chain_params = CERT_CHAIN_PARA()
+        chain_params.RequestedUsage = cert_usage_match
+        chain_params.cbSize = sizeof(chain_params)
+        pChainPara = pointer(chain_params)
+
+        if ssl_context.verify_flags & ssl.VERIFY_CRL_CHECK_CHAIN:
+            chain_flags = CERT_CHAIN_REVOCATION_CHECK_CHAIN
+        elif ssl_context.verify_flags & ssl.VERIFY_CRL_CHECK_LEAF:
+            chain_flags = CERT_CHAIN_REVOCATION_CHECK_END_CERT
+        else:
+            chain_flags = 0
+
+        try:
+            # First attempt to verify using the default Windows system trust roots
+            # (default chain engine).
+            _get_and_verify_cert_chain(
+                ssl_context,
+                None,
+                hIntermediateCertStore,
+                pCertContext,
+                pChainPara,
+                server_hostname,
+                chain_flags=chain_flags,
+            )
+        except ssl.SSLCertVerificationError as e:
+            # If that fails but custom CA certs have been added
+            # to the SSLContext using load_verify_locations,
+            # try verifying using a custom chain engine
+            # that trusts the custom CA certs.
+            custom_ca_certs: list[bytes] | None = ssl_context.get_ca_certs(
+                binary_form=True
+            )
+            if custom_ca_certs:
+                try:
+                    _verify_using_custom_ca_certs(
+                        ssl_context,
+                        custom_ca_certs,
+                        hIntermediateCertStore,
+                        pCertContext,
+                        pChainPara,
+                        server_hostname,
+                        chain_flags=chain_flags,
+                    )
+                # Raise the original error, not the new error.
+                except ssl.SSLCertVerificationError:
+                    raise e from None
+            else:
+                raise
+    finally:
+        CertCloseStore(hIntermediateCertStore, 0)
+        if pCertContext:
+            CertFreeCertificateContext(pCertContext)
+
+
+def _get_and_verify_cert_chain(
+    ssl_context: ssl.SSLContext,
+    hChainEngine: HCERTCHAINENGINE | None,
+    hIntermediateCertStore: HCERTSTORE,
+    pPeerCertContext: c_void_p,
+    pChainPara: PCERT_CHAIN_PARA,  # type: ignore[valid-type]
+    server_hostname: str | None,
+    chain_flags: int,
+) -> None:
+    ppChainContext = None
+    try:
+        # Get cert chain
+        ppChainContext = pointer(PCERT_CHAIN_CONTEXT())
+        CertGetCertificateChain(
+            hChainEngine,  # chain engine
+            pPeerCertContext,  # leaf cert context
+            None,  # current system time
+            hIntermediateCertStore,  # additional in-memory cert store
+            pChainPara,  # chain-building parameters
+            chain_flags,
+            None,  # reserved
+            ppChainContext,  # the resulting chain context
+        )
+        pChainContext = ppChainContext.contents
+
+        # Verify cert chain
+        ssl_extra_cert_chain_policy_para = SSL_EXTRA_CERT_CHAIN_POLICY_PARA()
+        ssl_extra_cert_chain_policy_para.cbSize = sizeof(
+            ssl_extra_cert_chain_policy_para
+        )
+        ssl_extra_cert_chain_policy_para.dwAuthType = AUTHTYPE_SERVER
+        ssl_extra_cert_chain_policy_para.fdwChecks = 0
+        if ssl_context.check_hostname is False:
+            ssl_extra_cert_chain_policy_para.fdwChecks = (
+                SECURITY_FLAG_IGNORE_CERT_CN_INVALID
+            )
+        if server_hostname:
+            ssl_extra_cert_chain_policy_para.pwszServerName = c_wchar_p(server_hostname)
+
+        chain_policy = CERT_CHAIN_POLICY_PARA()
+        chain_policy.pvExtraPolicyPara = cast(
+            pointer(ssl_extra_cert_chain_policy_para), c_void_p
+        )
+        if ssl_context.verify_mode == ssl.CERT_NONE:
+            chain_policy.dwFlags |= CERT_CHAIN_POLICY_VERIFY_MODE_NONE_FLAGS
+        chain_policy.cbSize = sizeof(chain_policy)
+
+        pPolicyPara = pointer(chain_policy)
+        policy_status = CERT_CHAIN_POLICY_STATUS()
+        policy_status.cbSize = sizeof(policy_status)
+        pPolicyStatus = pointer(policy_status)
+        CertVerifyCertificateChainPolicy(
+            CERT_CHAIN_POLICY_SSL,
+            pChainContext,
+            pPolicyPara,
+            pPolicyStatus,
+        )
+
+        # Check status
+        error_code = policy_status.dwError
+        if error_code:
+            # Try getting a human readable message for an error code.
+            error_message_buf = create_unicode_buffer(1024)
+            error_message_chars = FormatMessageW(
+                FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS,
+                None,
+                error_code,
+                0,
+                error_message_buf,
+                sizeof(error_message_buf),
+                None,
+            )
+
+            # See if we received a message for the error,
+            # otherwise we use a generic error with the
+            # error code and hope that it's search-able.
+            if error_message_chars <= 0:
+                error_message = f"Certificate chain policy error {error_code:#x} [{policy_status.lElementIndex}]"
+            else:
+                error_message = error_message_buf.value.strip()
+
+            err = ssl.SSLCertVerificationError(error_message)
+            err.verify_message = error_message
+            err.verify_code = error_code
+            raise err from None
+    finally:
+        if ppChainContext:
+            CertFreeCertificateChain(ppChainContext.contents)
+
+
+def _verify_using_custom_ca_certs(
+    ssl_context: ssl.SSLContext,
+    custom_ca_certs: list[bytes],
+    hIntermediateCertStore: HCERTSTORE,
+    pPeerCertContext: c_void_p,
+    pChainPara: PCERT_CHAIN_PARA,  # type: ignore[valid-type]
+    server_hostname: str | None,
+    chain_flags: int,
+) -> None:
+    hChainEngine = None
+    hRootCertStore = CertOpenStore(CERT_STORE_PROV_MEMORY, 0, None, 0, None)
+    try:
+        # Add custom CA certs to an in-memory cert store
+        for cert_bytes in custom_ca_certs:
+            CertAddEncodedCertificateToStore(
+                hRootCertStore,
+                X509_ASN_ENCODING | PKCS_7_ASN_ENCODING,
+                cert_bytes,
+                len(cert_bytes),
+                CERT_STORE_ADD_USE_EXISTING,
+                None,
+            )
+
+        # Create a custom cert chain engine which exclusively trusts
+        # certs from our hRootCertStore
+        cert_chain_engine_config = CERT_CHAIN_ENGINE_CONFIG()
+        cert_chain_engine_config.cbSize = sizeof(cert_chain_engine_config)
+        cert_chain_engine_config.hExclusiveRoot = hRootCertStore
+        pConfig = pointer(cert_chain_engine_config)
+        phChainEngine = pointer(HCERTCHAINENGINE())
+        CertCreateCertificateChainEngine(
+            pConfig,
+            phChainEngine,
+        )
+        hChainEngine = phChainEngine.contents
+
+        # Get and verify a cert chain using the custom chain engine
+        _get_and_verify_cert_chain(
+            ssl_context,
+            hChainEngine,
+            hIntermediateCertStore,
+            pPeerCertContext,
+            pChainPara,
+            server_hostname,
+            chain_flags,
+        )
+    finally:
+        if hChainEngine:
+            CertFreeCertificateChainEngine(hChainEngine)
+        CertCloseStore(hRootCertStore, 0)
+
+
+@contextlib.contextmanager
+def _configure_context(ctx: ssl.SSLContext) -> typing.Iterator[None]:
+    check_hostname = ctx.check_hostname
+    verify_mode = ctx.verify_mode
+    ctx.check_hostname = False
+    _set_ssl_context_verify_mode(ctx, ssl.CERT_NONE)
+    try:
+        yield
+    finally:
+        ctx.check_hostname = check_hostname
+        _set_ssl_context_verify_mode(ctx, verify_mode)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/truststore/py.typed b/env/lib/python3.12/site-packages/pip/_vendor/truststore/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/typing_extensions.py b/env/lib/python3.12/site-packages/pip/_vendor/typing_extensions.py
new file mode 100644
index 0000000..e429384
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/typing_extensions.py
@@ -0,0 +1,3641 @@
+import abc
+import collections
+import collections.abc
+import contextlib
+import functools
+import inspect
+import operator
+import sys
+import types as _types
+import typing
+import warnings
+
+__all__ = [
+    # Super-special typing primitives.
+    'Any',
+    'ClassVar',
+    'Concatenate',
+    'Final',
+    'LiteralString',
+    'ParamSpec',
+    'ParamSpecArgs',
+    'ParamSpecKwargs',
+    'Self',
+    'Type',
+    'TypeVar',
+    'TypeVarTuple',
+    'Unpack',
+
+    # ABCs (from collections.abc).
+    'Awaitable',
+    'AsyncIterator',
+    'AsyncIterable',
+    'Coroutine',
+    'AsyncGenerator',
+    'AsyncContextManager',
+    'Buffer',
+    'ChainMap',
+
+    # Concrete collection types.
+    'ContextManager',
+    'Counter',
+    'Deque',
+    'DefaultDict',
+    'NamedTuple',
+    'OrderedDict',
+    'TypedDict',
+
+    # Structural checks, a.k.a. protocols.
+    'SupportsAbs',
+    'SupportsBytes',
+    'SupportsComplex',
+    'SupportsFloat',
+    'SupportsIndex',
+    'SupportsInt',
+    'SupportsRound',
+
+    # One-off things.
+    'Annotated',
+    'assert_never',
+    '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',
+    'overload',
+    'override',
+    'Protocol',
+    'reveal_type',
+    'runtime',
+    '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',
+    'NoDefault',
+    'Optional',
+    'Pattern',
+    'Reversible',
+    'Sequence',
+    'Set',
+    'Sized',
+    'TextIO',
+    'Tuple',
+    'Union',
+    'ValuesView',
+    'cast',
+    'no_type_check',
+    'no_type_check_decorator',
+]
+
+# 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.
+
+
+class _Sentinel:
+    def __repr__(self):
+        return ""
+
+
+_marker = _Sentinel()
+
+
+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:
+    def _should_collect_from_parameters(t):
+        return isinstance(t, typing._GenericAlias) and not t._special
+
+
+NoReturn = typing.NoReturn
+
+# Some unconstrained type variables.  These are used by the container types.
+# (These are not for export.)
+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.
+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
+
+
+class _ExtensionsSpecialForm(typing._SpecialForm, _root=True):
+    def __repr__(self):
+        return 'typing_extensions.' + self._name
+
+
+Final = typing.Final
+
+if sys.version_info >= (3, 11):
+    final = typing.final
+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
+        cannot be subclassed. For example:
+
+            class Base:
+                @final
+                def done(self) -> None:
+                    ...
+            class Sub(Base):
+                def done(self) -> None:  # Error reported by type checker
+                    ...
+            @final
+            class Leaf:
+                ...
+            class Other(Leaf):  # Error reported by type checker
+                ...
+
+        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
+
+
+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):
+    Literal = typing.Literal
+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)
+
+    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):
+            if not isinstance(parameters, tuple):
+                parameters = (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
+                           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.""")
+
+
+_overload_dummy = typing._overload_dummy
+
+
+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.
+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
+AsyncIterator = typing.AsyncIterator
+Deque = typing.Deque
+DefaultDict = typing.DefaultDict
+OrderedDict = typing.OrderedDict
+Counter = typing.Counter
+ChainMap = typing.ChainMap
+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',
+        'Hashable', 'Sized', 'Container', 'Collection', 'Reversible', 'Buffer',
+    ],
+    'contextlib': ['AbstractContextManager', 'AbstractAsyncContextManager'],
+    'typing_extensions': ['Buffer'],
+}
+
+
+_EXCLUDED_ATTRS = frozenset(typing.EXCLUDED_ATTRIBUTES) | {
+    "__match_args__", "__protocol_attrs__", "__non_callable_proto_members__",
+    "__final__",
+}
+
+
+def _get_protocol_attrs(cls):
+    attrs = set()
+    for base in cls.__mro__[:-1]:  # without object
+        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):
+                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
+
+
+# `__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
+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, )`.
+
+        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 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
+
+            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
+
+            return False
+
+        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
+
+        # 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)
+
+    @classmethod
+    def _proto_hook(cls, other):
+        if not cls.__dict__.get('_is_protocol', False):
+            return NotImplemented
+
+        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
+
+                # ...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
+
+    class Protocol(typing.Generic, metaclass=_ProtocolMeta):
+        __doc__ = typing.Protocol.__doc__
+        __slots__ = ()
+        _is_protocol = True
+        _is_runtime_protocol = False
+
+        def __init_subclass__(cls, *args, **kwargs):
+            super().__init_subclass__(*args, **kwargs)
+
+            # Determine if this is a protocol or a concrete subclass.
+            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.
+            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
+
+
+if sys.version_info >= (3, 13):
+    runtime_checkable = typing.runtime_checkable
+else:
+    def runtime_checkable(cls):
+        """Mark a protocol class as a runtime protocol.
+
+        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 issubclass(cls, typing.Generic) or not getattr(cls, '_is_protocol', False):
+            raise TypeError(f'@runtime_checkable can be only applied to protocol classes,'
+                            f' got {cls!r}')
+        cls._is_runtime_protocol = True
+
+        # 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,
+            # 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.
+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
+    SupportsIndex = typing.SupportsIndex
+    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__ = ()
+
+        @abc.abstractmethod
+        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
+
+
+# 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"
+    # 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.
+    # 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.
+    # 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
+else:
+    # 3.10.0 and later
+    _TAKES_MODULE = "module" in inspect.signature(typing._type_check).parameters
+
+    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 __new__(cls, name, bases, ns, *, total=True, closed=False):
+            """Create new typed dict class object.
+
+            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(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 = {}
+            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 = {
+                    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:
+                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():
+                qualifiers = set(_get_typeddict_qualifiers(annotation_type))
+
+                if Required in qualifiers:
+                    required_keys.add(annotation_key)
+                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
+
+        __call__ = dict  # static method
+
+        def __subclasscheck__(cls, other):
+            # Typed dicts are only for static structural subtyping.
+            raise TypeError('TypedDict does not support instance and class checks')
+
+        __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.
+
+        Usage::
+
+            class Point2D(TypedDict):
+                x: int
+                y: int
+                label: str
+
+            a: Point2D = {'x': 1, 'y': 2, 'label': 'good'}  # OK
+            b: Point2D = {'z': 3, 'label': 'bad'}           # Fails type check
+
+            assert Point2D(x=1, y=2, label='first') == dict(x=1, y=2, label='first')
+
+        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::
+
+            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.
+        """
+        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)
+    else:
+        _TYPEDDICT_TYPES = (_TypedDictMeta,)
+
+    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
+        """
+        # 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, /):
+        """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, "ReadOnly"):  # 3.13+
+    get_type_hints = typing.get_type_hints
+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, ReadOnly):
+            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"):  # 3.9+
+            hint = typing.get_type_hints(
+                obj, globalns=globalns, localns=localns, include_extras=True
+            )
+        else:  # 3.8
+            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
+    # Not exported and not a public API, but needed for get_origin() and get_args()
+    # to work.
+    _AnnotatedAlias = typing._AnnotatedAlias
+# 3.8
+else:
+    class _AnnotatedAlias(typing._GenericAlias, _root=True):
+        """Runtime representation of an annotated type.
+
+        At its core 'Annotated[t, dec1, dec2, ...]' is an alias for the type 't'
+        with extra annotations. The alias behaves like a normal typing alias,
+        instantiating is the same as instantiating the underlying type, binding
+        it to types is also the same.
+        """
+        def __init__(self, origin, metadata):
+            if isinstance(origin, _AnnotatedAlias):
+                metadata = origin.__metadata__ + metadata
+                origin = origin.__origin__
+            super().__init__(origin, origin)
+            self.__metadata__ = metadata
+
+        def copy_with(self, params):
+            assert len(params) == 1
+            new_type = params[0]
+            return _AnnotatedAlias(new_type, self.__metadata__)
+
+        def __repr__(self):
+            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, (
+                Annotated, (self.__origin__, *self.__metadata__)
+            )
+
+        def __eq__(self, other):
+            if not isinstance(other, _AnnotatedAlias):
+                return NotImplemented
+            if self.__origin__ != other.__origin__:
+                return False
+            return self.__metadata__ == other.__metadata__
+
+        def __hash__(self):
+            return hash((self.__origin__, self.__metadata__))
+
+    class Annotated:
+        """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 (and will be in
+        the __origin__ field), the remaining arguments are kept as a tuple in
+        the __extra__ 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()]
+        """
+
+        __slots__ = ()
+
+        def __new__(cls, *args, **kwargs):
+            raise TypeError("Type Annotated cannot be instantiated.")
+
+        @typing._tp_cache
+        def __class_getitem__(cls, params):
+            if not isinstance(params, tuple) or len(params) < 2:
+                raise TypeError("Annotated[...] should be used "
+                                "with at least two arguments (a type and an "
+                                "annotation).")
+            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)
+
+        def __init_subclass__(cls, *args, **kwargs):
+            raise TypeError(
+                f"Cannot subclass {cls.__module__}.Annotated"
+            )
+
+# 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.
+if sys.version_info[:2] >= (3, 10):
+    get_origin = typing.get_origin
+    get_args = typing.get_args
+# 3.8-3.9
+else:
+    try:
+        # 3.9+
+        from typing import _BaseGenericAlias
+    except ImportError:
+        _BaseGenericAlias = typing._GenericAlias
+    try:
+        # 3.9+
+        from typing import GenericAlias as _typing_GenericAlias
+    except ImportError:
+        _typing_GenericAlias = typing._GenericAlias
+
+    def get_origin(tp):
+        """Get the unsubscripted version of a type.
+
+        This supports generic types, Callable, Tuple, Union, Literal, Final, ClassVar
+        and Annotated. Return None for unsupported types. Examples::
+
+            get_origin(Literal[42]) is Literal
+            get_origin(int) is None
+            get_origin(ClassVar[int]) is ClassVar
+            get_origin(Generic) is Generic
+            get_origin(Generic[T]) is Generic
+            get_origin(Union[T, int]) is Union
+            get_origin(List[Tuple[T, T]][int]) == list
+            get_origin(P.args) is P
+        """
+        if isinstance(tp, _AnnotatedAlias):
+            return Annotated
+        if isinstance(tp, (typing._GenericAlias, _typing_GenericAlias, _BaseGenericAlias,
+                           ParamSpecArgs, ParamSpecKwargs)):
+            return tp.__origin__
+        if tp is typing.Generic:
+            return typing.Generic
+        return None
+
+    def get_args(tp):
+        """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 isinstance(tp, _AnnotatedAlias):
+            return (tp.__origin__, *tp.__metadata__)
+        if isinstance(tp, (typing._GenericAlias, _typing_GenericAlias)):
+            if getattr(tp, "_special", False):
+                return ()
+            res = tp.__args__
+            if get_origin(tp) is collections.abc.Callable and res[0] is not Ellipsis:
+                res = (list(res[:-1]), res[-1])
+            return res
+        return ()
+
+
+# 3.10+
+if hasattr(typing, 'TypeAlias'):
+    TypeAlias = typing.TypeAlias
+# 3.9
+elif sys.version_info[:2] >= (3, 9):
+    @_ExtensionsSpecialForm
+    def TypeAlias(self, parameters):
+        """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.
+        """
+        raise TypeError(f"{self} is not subscriptable")
+# 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.
+
+        For example::
+
+            Predicate: TypeAlias = Callable[..., bool]
+
+        It's invalid when used anywhere except as in the example
+        above."""
+    )
+
+
+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):
+    type_param.has_default = lambda: default is not NoDefault
+    type_param.__default__ = default
+
+
+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
+
+
+# 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)
+
+
+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
+
+        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
+
+            _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
+if hasattr(typing, 'ParamSpecArgs'):
+    ParamSpecArgs = typing.ParamSpecArgs
+    ParamSpecKwargs = typing.ParamSpecKwargs
+# 3.8-3.9
+else:
+    class _Immutable:
+        """Mixin to indicate that object should not be copied."""
+        __slots__ = ()
+
+        def __copy__(self):
+            return self
+
+        def __deepcopy__(self, memo):
+            return self
+
+    class ParamSpecArgs(_Immutable):
+        """The args for a ParamSpec object.
+
+        Given a ParamSpec object P, P.args is an instance of ParamSpecArgs.
+
+        ParamSpecArgs objects have a reference back to their ParamSpec:
+
+        P.args.__origin__ is P
+
+        This type is meant for runtime introspection and has no special meaning to
+        static type checkers.
+        """
+        def __init__(self, origin):
+            self.__origin__ = origin
+
+        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.
+
+        Given a ParamSpec object P, P.kwargs is an instance of ParamSpecKwargs.
+
+        ParamSpecKwargs objects have a reference back to their ParamSpec:
+
+        P.kwargs.__origin__ is P
+
+        This type is meant for runtime introspection and has no special meaning to
+        static type checkers.
+        """
+        def __init__(self, origin):
+            self.__origin__ = origin
+
+        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__
+
+
+if _PEP_696_IMPLEMENTED:
+    from typing import ParamSpec
+
+# 3.10+
+elif hasattr(typing, 'ParamSpec'):
+
+    # Add default parameter - PEP 696
+    class ParamSpec(metaclass=_TypeVarLikeMeta):
+        """Parameter specification."""
+
+        _backported_typevarlike = typing.ParamSpec
+
+        def __new__(cls, name, *, bound=None,
+                    covariant=False, contravariant=False,
+                    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,
+                                             covariant=covariant,
+                                             contravariant=contravariant,
+                                             infer_variance=infer_variance)
+            else:
+                paramspec = typing.ParamSpec(name, bound=bound,
+                                             covariant=covariant,
+                                             contravariant=contravariant)
+                paramspec.__infer_variance__ = infer_variance
+
+            _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:
+            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.
+    class ParamSpec(list, _DefaultMixin):
+        """Parameter specification variable.
+
+        Usage::
+
+           P = ParamSpec('P')
+
+        Parameter specification variables exist primarily for the benefit of static
+        type checkers.  They are used to forward the parameter types of one
+        callable to another callable, a pattern commonly found in higher order
+        functions and decorators.  They are only valid when used in ``Concatenate``,
+        or s the first argument to ``Callable``. In Python 3.10 and higher,
+        they are also supported in user-defined Generics at runtime.
+        See class Generic for more information on generic types.  An
+        example for annotating a decorator::
+
+           T = TypeVar('T')
+           P = ParamSpec('P')
+
+           def add_logging(f: Callable[P, T]) -> Callable[P, T]:
+               '''A type-safe decorator to add logging to a function.'''
+               def inner(*args: P.args, **kwargs: P.kwargs) -> T:
+                   logging.info(f'{f.__name__} was called')
+                   return f(*args, **kwargs)
+               return inner
+
+           @add_logging
+           def add_two(x: float, y: float) -> float:
+               '''Add two numbers together.'''
+               return x + y
+
+        Parameter specification variables defined with covariant=True or
+        contravariant=True can be used to declare covariant or contravariant
+        generic types.  These keyword arguments are valid, but their actual semantics
+        are yet to be decided.  See PEP 612 for details.
+
+        Parameter specification variables can be introspected. e.g.:
+
+           P.__name__ == 'T'
+           P.__bound__ == None
+           P.__covariant__ == False
+           P.__contravariant__ == False
+
+        Note that only parameter specification variables defined in global scope can
+        be pickled.
+        """
+
+        # Trick Generic __parameters__.
+        __class__ = typing.TypeVar
+
+        @property
+        def args(self):
+            return ParamSpecArgs(self)
+
+        @property
+        def kwargs(self):
+            return ParamSpecKwargs(self)
+
+        def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
+                     infer_variance=False, default=NoDefault):
+            list.__init__(self, [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:
+                self.__bound__ = None
+            _DefaultMixin.__init__(self, default)
+
+            # for pickling:
+            def_mod = _caller()
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+
+        def __repr__(self):
+            if self.__infer_variance__:
+                prefix = ''
+            elif self.__covariant__:
+                prefix = '+'
+            elif self.__contravariant__:
+                prefix = '-'
+            else:
+                prefix = '~'
+            return prefix + self.__name__
+
+        def __hash__(self):
+            return object.__hash__(self)
+
+        def __eq__(self, other):
+            return self is other
+
+        def __reduce__(self):
+            return self.__name__
+
+        # Hack to get typing._type_check to pass.
+        def __call__(self, *args, **kwargs):
+            pass
+
+
+# 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):
+
+        # Trick Generic into looking into this for __parameters__.
+        __class__ = typing._GenericAlias
+
+        # Flag in 3.8.
+        _special = False
+
+        def __init__(self, origin, args):
+            super().__init__(args)
+            self.__origin__ = origin
+            self.__args__ = 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__))
+
+        # 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, (typing.TypeVar, ParamSpec))
+            )
+
+
+# 3.8-3.9
+@typing._tp_cache
+def _concatenate_getitem(self, parameters):
+    if parameters == ():
+        raise TypeError("Cannot take a Concatenate of no types.")
+    if not isinstance(parameters, tuple):
+        parameters = (parameters,)
+    if not isinstance(parameters[-1], ParamSpec):
+        raise TypeError("The last parameter to Concatenate should be a "
+                        "ParamSpec variable.")
+    msg = "Concatenate[arg, ...]: each arg must be a type."
+    parameters = tuple(typing._type_check(p, msg) for p in parameters)
+    return _ConcatenateGenericAlias(self, parameters)
+
+
+# 3.10+
+if hasattr(typing, 'Concatenate'):
+    Concatenate = typing.Concatenate
+    _ConcatenateGenericAlias = typing._ConcatenateGenericAlias
+# 3.9
+elif sys.version_info[:2] >= (3, 9):
+    @_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
+        callable.
+
+        For example::
+
+           Callable[Concatenate[int, P], int]
+
+        See PEP 612 for detailed information.
+        """
+        return _concatenate_getitem(self, parameters)
+# 3.8
+else:
+    class _ConcatenateForm(_ExtensionsSpecialForm, _root=True):
+        def __getitem__(self, parameters):
+            return _concatenate_getitem(self, parameters)
+
+    Concatenate = _ConcatenateForm(
+        'Concatenate',
+        doc="""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.
+        """)
+
+# 3.10+
+if hasattr(typing, 'TypeGuard'):
+    TypeGuard = typing.TypeGuard
+# 3.9
+elif sys.version_info[:2] >= (3, 9):
+    @_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.
+        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).
+        """
+        item = typing._type_check(parameters, f'{self} accepts only a single type.')
+        return typing._GenericAlias(self, (item,))
+# 3.8
+else:
+    class _TypeGuardForm(_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,))
+
+    TypeGuard = _TypeGuardForm(
+        'TypeGuard',
+        doc="""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).
+        """)
+
+# 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):
+    __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"):  # 3.11+
+    LiteralString = typing.LiteralString
+else:
+    @_SpecialForm
+    def LiteralString(self, params):
+        """Represents an arbitrary literal string.
+
+        Example::
+
+          from pip._vendor.typing_extensions import LiteralString
+
+          def query(sql: LiteralString) -> ...:
+              ...
+
+          query("SELECT * FROM table")  # ok
+          query(f"SELECT * FROM {input()}")  # not ok
+
+        See PEP 675 for details.
+
+        """
+        raise TypeError(f"{self} is not subscriptable")
+
+
+if hasattr(typing, "Self"):  # 3.11+
+    Self = typing.Self
+else:
+    @_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")
+
+
+if hasattr(typing, "Never"):  # 3.11+
+    Never = typing.Never
+else:
+    @_SpecialForm
+    def Never(self, params):
+        """The bottom type, a type that has no members.
+
+        This can be used to define a function that should never be
+        called, or a function that never returns::
+
+            from pip._vendor.typing_extensions import Never
+
+            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
+
+        """
+
+        raise TypeError(f"{self} is not subscriptable")
+
+
+if hasattr(typing, 'Required'):  # 3.11+
+    Required = typing.Required
+    NotRequired = typing.NotRequired
+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
+        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 a 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 a single type.')
+        return typing._GenericAlias(self, (item,))
+
+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.')
+            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,
+            )
+        """)
+
+
+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
+
+    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
+
+        @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.')
+        return _UnpackAlias(self, (item,))
+
+    def _is_unpack(obj):
+        return isinstance(obj, _UnpackAlias)
+
+else:  # 3.8
+    class _UnpackAlias(typing._GenericAlias, _root=True):
+        __class__ = typing.TypeVar
+
+    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=_UNPACK_DOC)
+
+    def _is_unpack(obj):
+        return isinstance(obj, _UnpackAlias)
+
+
+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):
+        """Type variable tuple."""
+
+        _backported_typevarlike = typing.TypeVarTuple
+
+        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):
+            raise TypeError("Cannot subclass special typing classes")
+
+else:  # <=3.10
+    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=NoDefault):
+            self.__name__ = name
+            _DefaultMixin.__init__(self, default)
+
+            # for pickling:
+            def_mod = _caller()
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+
+            self.__unpacked__ = Unpack[self]
+
+        def __repr__(self):
+            return self.__name__
+
+        def __hash__(self):
+            return object.__hash__(self)
+
+        def __eq__(self, other):
+            return self is other
+
+        def __reduce__(self):
+            return self.__name__
+
+        def __init_subclass__(self, *args, **kwds):
+            if '_root' not in kwds:
+                raise TypeError("Cannot subclass special typing classes")
+
+
+if hasattr(typing, "reveal_type"):  # 3.11+
+    reveal_type = typing.reveal_type
+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()``,
+        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
+
+
+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
+    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.
+
+        """
+        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+
+    # dataclass_transform exists in 3.11 but lacks the frozen_default parameter
+    dataclass_transform = typing.dataclass_transform
+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]],
+            ...
+        ] = (),
+        **kwargs: typing.Any,
+    ) -> typing.Callable[[T], T]:
+        """Decorator that marks a function, class, or metaclass as providing
+        dataclass-like behavior.
+
+        Example:
+
+            from pip._vendor.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.
+        - ``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()``.
+
+        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,
+                "frozen_default": frozen_default,
+                "field_specifiers": field_specifiers,
+                "kwargs": kwargs,
+            }
+            return cls_or_fn
+        return decorator
+
+
+if hasattr(typing, "override"):  # 3.12+
+    override = typing.override
+else:  # <=3.11
+    _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.
+
+        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}"
+                )
+
+
+# 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"):
+    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__', NoDefault)
+                        is not NoDefault
+                    ):
+                        return
+
+                    num_default_tv = sum(getattr(p, '__default__', NoDefault)
+                                         is not NoDefault 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__', NoDefault)
+                        is not NoDefault
+                    ):
+                        return
+
+                    num_default_tv = sum(getattr(p, '__default__', NoDefault)
+                                         is not NoDefault 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}")
+
+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'):
+    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 = []
+
+        # 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 _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):
+                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 = []
+
+        # 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.
+                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 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)
+
+    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.
+# 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):
+    NamedTuple = typing.NamedTuple
+else:
+    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)
+            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:
+                    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:
+                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, val in ns.items():
+                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
+
+            if typing.Generic in bases:
+                nm_tpl.__init_subclass__()
+            return nm_tpl
+
+    _NamedTuple = type.__new__(_NamedTupleMeta, 'NamedTuple', (), {})
+
+    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):  # noqa: B024
+        """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 pip._vendor.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
+
+
+_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
+# 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
+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/env/lib/python3.12/site-packages/pip/_vendor/urllib3/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/__init__.py
new file mode 100644
index 0000000..c6fa382
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/__init__.py
@@ -0,0 +1,102 @@
+"""
+Python HTTP library with thread-safe connection pooling, file post support, user friendly, and more
+"""
+from __future__ import absolute_import
+
+# Set default logging handler to avoid "No handler found" warnings.
+import logging
+import warnings
+from logging import NullHandler
+
+from . import exceptions
+from ._version import __version__
+from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, connection_from_url
+from .filepost import encode_multipart_formdata
+from .poolmanager import PoolManager, ProxyManager, proxy_from_url
+from .response import HTTPResponse
+from .util.request import make_headers
+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__
+
+__all__ = (
+    "HTTPConnectionPool",
+    "HTTPSConnectionPool",
+    "PoolManager",
+    "ProxyManager",
+    "HTTPResponse",
+    "Retry",
+    "Timeout",
+    "add_stderr_logger",
+    "connection_from_url",
+    "disable_warnings",
+    "encode_multipart_formdata",
+    "get_host",
+    "make_headers",
+    "proxy_from_url",
+)
+
+logging.getLogger(__name__).addHandler(NullHandler())
+
+
+def add_stderr_logger(level=logging.DEBUG):
+    """
+    Helper for quickly adding a StreamHandler to the logger. Useful for
+    debugging.
+
+    Returns the handler after adding it.
+    """
+    # This method needs to be in this __init__.py to get the __name__ correct
+    # even if urllib3 is vendored within another package.
+    logger = logging.getLogger(__name__)
+    handler = logging.StreamHandler()
+    handler.setFormatter(logging.Formatter("%(asctime)s %(levelname)s %(message)s"))
+    logger.addHandler(handler)
+    logger.setLevel(level)
+    logger.debug("Added a stderr logging handler to logger: %s", __name__)
+    return handler
+
+
+# ... Clean up.
+del NullHandler
+
+
+# All warning filters *must* be appended unless you're really certain that they
+# shouldn't be: otherwise, it's very hard for users to use most Python
+# 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):
+    """
+    Helper for quickly disabling all urllib3 warnings.
+    """
+    warnings.simplefilter("ignore", category)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/_collections.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/_collections.py
new file mode 100644
index 0000000..bceb845
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/_collections.py
@@ -0,0 +1,355 @@
+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 collections import OrderedDict
+
+from .exceptions import InvalidHeader
+from .packages import six
+from .packages.six import iterkeys, itervalues
+
+__all__ = ["RecentlyUsedContainer", "HTTPHeaderDict"]
+
+
+_Null = object()
+
+
+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
+    ``maxsize``.
+
+    :param maxsize:
+        Maximum number of recent elements to retain.
+
+    :param dispose_func:
+        Every time an item is evicted from the container,
+        ``dispose_func(value)`` is called.  Callback which will get called
+    """
+
+    ContainerCls = OrderedDict
+
+    def __init__(self, maxsize=10, dispose_func=None):
+        self._maxsize = maxsize
+        self.dispose_func = dispose_func
+
+        self._container = self.ContainerCls()
+        self.lock = RLock()
+
+    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, value):
+        evicted_value = _Null
+        with self.lock:
+            # Possibly evict the existing value of 'key'
+            evicted_value = self._container.get(key, _Null)
+            self._container[key] = value
+
+            # 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):
+        with self.lock:
+            value = self._container.pop(key)
+
+        if self.dispose_func:
+            self.dispose_func(value)
+
+    def __len__(self):
+        with self.lock:
+            return len(self._container)
+
+    def __iter__(self):
+        raise NotImplementedError(
+            "Iteration over this class is unlikely to be threadsafe."
+        )
+
+    def clear(self):
+        with self.lock:
+            # Copy pointers to all values, then wipe the mapping
+            values = list(itervalues(self._container))
+            self._container.clear()
+
+        if self.dispose_func:
+            for value in values:
+                self.dispose_func(value)
+
+    def keys(self):
+        with self.lock:
+            return list(iterkeys(self._container))
+
+
+class HTTPHeaderDict(MutableMapping):
+    """
+    :param headers:
+        An iterable of field-value pairs. Must not contain multiple field names
+        when compared case-insensitively.
+
+    :param kwargs:
+        Additional field-value pairs to pass in to ``dict.update``.
+
+    A ``dict`` like container for storing HTTP Headers.
+
+    Field names are stored and compared case-insensitively in compliance with
+    RFC 7230. Iteration provides the first case-sensitive key seen for each
+    case-insensitive pair.
+
+    Using ``__setitem__`` syntax overwrites fields that compare equal
+    case-insensitively in order to maintain ``dict``'s api. For fields that
+    compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add``
+    in a loop.
+
+    If multiple fields that are equal case-insensitively are passed to the
+    constructor or ``.update``, the behavior is undefined and some will be
+    lost.
+
+    >>> headers = HTTPHeaderDict()
+    >>> headers.add('Set-Cookie', 'foo=bar')
+    >>> headers.add('set-cookie', 'baz=quxx')
+    >>> headers['content-length'] = '7'
+    >>> headers['SET-cookie']
+    'foo=bar, baz=quxx'
+    >>> headers['Content-Length']
+    '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)
+            else:
+                self.extend(headers)
+        if kwargs:
+            self.extend(kwargs)
+
+    def __setitem__(self, key, val):
+        self._container[key.lower()] = [key, val]
+        return self._container[key.lower()]
+
+    def __getitem__(self, key):
+        val = self._container[key.lower()]
+        return ", ".join(val[1:])
+
+    def __delitem__(self, key):
+        del self._container[key.lower()]
+
+    def __contains__(self, key):
+        return key.lower() in self._container
+
+    def __eq__(self, other):
+        if not isinstance(other, Mapping) and not hasattr(other, "keys"):
+            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()
+        )
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    if six.PY2:  # Python 2
+        iterkeys = MutableMapping.iterkeys
+        itervalues = MutableMapping.itervalues
+
+    __marker = object()
+
+    def __len__(self):
+        return len(self._container)
+
+    def __iter__(self):
+        # 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):
+        try:
+            del self[key]
+        except KeyError:
+            pass
+
+    def add(self, key, val):
+        """Adds a (name, value) pair, doesn't overwrite the value if it already
+        exists.
+
+        >>> headers = HTTPHeaderDict(foo='bar')
+        >>> headers.add('Foo', 'baz')
+        >>> headers['foo']
+        'bar, baz'
+        """
+        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)
+
+    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(
+                "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, 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)
+
+    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 self.__marker:
+                return []
+            return default
+        else:
+            return vals[1:]
+
+    def _prepare_for_method_change(self):
+        """
+        Remove content-specific header fields before changing the request
+        method to GET or HEAD according to RFC 9110, Section 15.4.
+        """
+        content_specific_headers = [
+            "Content-Encoding",
+            "Content-Language",
+            "Content-Location",
+            "Content-Type",
+            "Content-Length",
+            "Digest",
+            "Last-Modified",
+        ]
+        for header in content_specific_headers:
+            self.discard(header)
+        return self
+
+    # Backwards compatibility for httplib
+    getheaders = getlist
+    getallmatchingheaders = getlist
+    iget = getlist
+
+    # Backwards compatibility for http.cookiejar
+    get_all = getlist
+
+    def __repr__(self):
+        return "%s(%s)" % (type(self).__name__, dict(self.itermerged()))
+
+    def _copy_from(self, other):
+        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
+
+    def copy(self):
+        clone = type(self)()
+        clone._copy_from(self)
+        return clone
+
+    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):
+        """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())
+
+    @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 = []
+
+        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
+
+            key, value = line.split(":", 1)
+            headers.append((key, value.strip()))
+
+        return cls(headers)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/_version.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/_version.py
new file mode 100644
index 0000000..d49df2a
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/_version.py
@@ -0,0 +1,2 @@
+# This file is protected via CODEOWNERS
+__version__ = "1.26.20"
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/connection.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/connection.py
new file mode 100644
index 0000000..de35b63
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/connection.py
@@ -0,0 +1,572 @@
+from __future__ import absolute_import
+
+import datetime
+import logging
+import os
+import re
+import socket
+import warnings
+from socket import error as SocketError
+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
+
+try:  # Compiled with SSL?
+    import ssl
+
+    BaseSSLError = ssl.SSLError
+except (ImportError, AttributeError):  # Platform-specific: No SSL.
+    ssl = None
+
+    class BaseSSLError(BaseException):
+        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 ._version import __version__
+from .exceptions import (
+    ConnectTimeoutError,
+    NewConnectionError,
+    SubjectAltNameWarning,
+    SystemTimeWarning,
+)
+from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection
+from .util.ssl_ import (
+    assert_fingerprint,
+    create_urllib3_context,
+    is_ipaddress,
+    resolve_cert_reqs,
+    resolve_ssl_version,
+    ssl_wrap_socket,
+)
+from .util.ssl_match_hostname import CertificateError, match_hostname
+
+log = logging.getLogger(__name__)
+
+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(2024, 1, 1)
+
+_CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]")
+
+
+class HTTPConnection(_HTTPConnection, object):
+    """
+    Based on :class:`http.client.HTTPConnection` but provides an extra constructor
+    backwards-compatibility layer between older and newer Pythons.
+
+    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
+      Nagle's algorithm (sets TCP_NODELAY to 1) unless the connection is behind a proxy.
+
+      For example, if you wish to enable TCP Keep Alive in addition to the defaults,
+      you might pass:
+
+      .. code-block:: python
+
+         HTTPConnection.default_socket_options + [
+             (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1),
+         ]
+
+      Or you may want to disable the defaults by passing an empty list (e.g., ``[]``).
+    """
+
+    default_port = port_by_scheme["http"]
+
+    #: Disable Nagle's algorithm by default.
+    #: ``[(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 = False
+
+    #: Whether this proxy connection (if used) verifies the proxy host's
+    #: certificate.
+    proxy_is_verified = None
+
+    def __init__(self, *args, **kw):
+        if not six.PY2:
+            kw.pop("strict", None)
+
+        # Pre-set source_address.
+        self.source_address = kw.get("source_address")
+
+        #: 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)
+
+        # 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)
+
+    @property
+    def host(self):
+        """
+        Getter method to remove any trailing dots that indicate the hostname is an FQDN.
+
+        In general, SSL certificates don't include the trailing dot indicating a
+        fully-qualified domain name, and thus, they don't validate properly when
+        checked against a domain name that includes the dot. In addition, some
+        servers may not expect to receive the trailing dot when provided.
+
+        However, the hostname with trailing dot is critical to DNS resolution; doing a
+        lookup with the trailing dot will properly only resolve the appropriate FQDN,
+        whereas a lookup without a trailing dot will search the system's search domain
+        list. Thus, it's important to keep the original host around for use only in
+        those cases where it's appropriate (i.e., when doing DNS lookup to establish the
+        actual TCP connection across which we're going to send HTTP requests).
+        """
+        return self._dns_host.rstrip(".")
+
+    @host.setter
+    def host(self, value):
+        """
+        Setter for the `host` property.
+
+        We assume that only urllib3 uses the _dns_host attribute; httplib itself
+        only uses `host`, and it seems reasonable that other libraries follow suit.
+        """
+        self._dns_host = value
+
+    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:
+            conn = connection.create_connection(
+                (self._dns_host, self.port), self.timeout, **extra_kw
+            )
+
+        except SocketTimeout:
+            raise ConnectTimeoutError(
+                self,
+                "Connection to %s timed out. (connect timeout=%s)"
+                % (self.host, self.timeout),
+            )
+
+        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()
+            # Mark this connection as not reusable
+            self.auto_open = 0
+
+    def connect(self):
+        conn = self._new_conn()
+        self._prepare_conn(conn)
+
+    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(
+                "Method cannot contain non-token characters %r (found at least %r)"
+                % (method, match.group())
+            )
+
+        return _HTTPConnection.putrequest(self, method, url, *args, **kwargs)
+
+    def putheader(self, header, *values):
+        """ """
+        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:
+            raise ValueError(
+                "urllib3.util.SKIP_HEADER only supports '%s'"
+                % ("', '".join(map(str.title, sorted(SKIPPABLE_HEADERS))),)
+            )
+
+    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:
+            # 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
+        )
+        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 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)
+
+        # After the if clause, to always have a closed body
+        self.send(b"0\r\n\r\n")
+
+
+class HTTPSConnection(HTTPConnection):
+    """
+    Many of the parameters to this constructor are passed to the underlying SSL
+    socket by means of :py:func:`urllib3.util.ssl_wrap_socket`.
+    """
+
+    default_port = port_by_scheme["https"]
+
+    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,
+        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
+
+        # 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=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.
+        """
+        # 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:
+            if self.ssl_context is not None:
+                cert_reqs = self.ssl_context.verify_mode
+            else:
+                cert_reqs = resolve_cert_reqs(None)
+
+        self.key_file = key_file
+        self.cert_file = cert_file
+        self.cert_reqs = cert_reqs
+        self.key_password = key_password
+        self.assert_hostname = assert_hostname
+        self.assert_fingerprint = assert_fingerprint
+        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
+
+    def connect(self):
+        # Add certificate verification
+        self.sock = conn = self._new_conn()
+        hostname = 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)
+                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
+
+            # Override the host with the one we're requesting data from.
+            hostname = self._tunnel_host
+
+        server_hostname = hostname
+        if self.server_hostname is not None:
+            server_hostname = self.server_hostname
+
+        is_time_off = datetime.date.today() < RECENT_DATE
+        if is_time_off:
+            warnings.warn(
+                (
+                    "System time is way off (before {0}). 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,
+            ca_certs=self.ca_certs,
+            ca_cert_dir=self.ca_cert_dir,
+            ca_cert_data=self.ca_cert_data,
+            server_hostname=server_hostname,
+            ssl_context=context,
+            tls_in_tls=tls_in_tls,
+        )
+
+        # 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"}
+        ):  # Defensive:
+            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 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.
+        """
+        proxy_config = 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,
+            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,
+        )
+
+        if ssl_context.verify_mode != ssl.CERT_NONE and not getattr(
+            ssl_context, "check_hostname", 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)
+
+        self.proxy_is_verified = ssl_context.verify_mode == ssl.CERT_REQUIRED
+        return socket
+
+
+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("u[]")
+    if is_ipaddress(stripped_hostname):
+        asserted_hostname = stripped_hostname
+
+    try:
+        match_hostname(cert, asserted_hostname)
+    except CertificateError as e:
+        log.warning(
+            "Certificate did not match expected hostname: %s. Certificate: %s",
+            asserted_hostname,
+            cert,
+        )
+        # 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
+        raise
+
+
+def _get_default_user_agent():
+    return "python-urllib3/%s" % __version__
+
+
+class DummyConnection(object):
+    """Used to detect a failed ConnectionCls import."""
+
+    pass
+
+
+if not ssl:
+    HTTPSConnection = DummyConnection  # noqa: F811
+
+
+VerifiedHTTPSConnection = HTTPSConnection
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/connectionpool.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/connectionpool.py
new file mode 100644
index 0000000..0872ed7
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/connectionpool.py
@@ -0,0 +1,1140 @@
+from __future__ import absolute_import
+
+import errno
+import logging
+import re
+import socket
+import sys
+import warnings
+from socket import error as SocketError
+from socket import timeout as SocketTimeout
+
+from ._collections import HTTPHeaderDict
+from .connection import (
+    BaseSSLError,
+    BrokenPipeError,
+    DummyConnection,
+    HTTPConnection,
+    HTTPException,
+    HTTPSConnection,
+    VerifiedHTTPSConnection,
+    port_by_scheme,
+)
+from .exceptions import (
+    ClosedPoolError,
+    EmptyPoolError,
+    HeaderParsingError,
+    HostChangedError,
+    InsecureRequestWarning,
+    LocationValueError,
+    MaxRetryError,
+    NewConnectionError,
+    ProtocolError,
+    ProxyError,
+    ReadTimeoutError,
+    SSLError,
+    TimeoutError,
+)
+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.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 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
+
+try:  # Platform-specific: Python 3
+    import weakref
+
+    weakref_finalize = weakref.finalize
+except AttributeError:  # Platform-specific: Python 2
+    from .packages.backports.weakref_finalize import weakref_finalize
+
+xrange = six.moves.xrange
+
+log = logging.getLogger(__name__)
+
+_Default = object()
+
+
+# Pool objects
+class ConnectionPool(object):
+    """
+    Base class for all connection pools, such as
+    :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`.
+
+    .. note::
+       ConnectionPool.urlopen() does not normalize or percent-encode target URIs
+       which is useful if your target server doesn't support percent-encoded
+       target URIs.
+    """
+
+    scheme = None
+    QueueCls = LifoQueue
+
+    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
+
+    def __str__(self):
+        return "%s(host=%r, port=%r)" % (type(self).__name__, self.host, self.port)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        # Return False to re-raise any potential exceptions
+        return False
+
+    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
+_blocking_errnos = {errno.EAGAIN, errno.EWOULDBLOCK}
+
+
+class HTTPConnectionPool(ConnectionPool, RequestMethods):
+    """
+    Thread-safe connection pool for one host.
+
+    :param host:
+        Host used for this HTTP Connection (e.g. "localhost"), passed into
+        :class:`http.client.HTTPConnection`.
+
+    :param port:
+        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,
+        or an instance of :class:`urllib3.util.Timeout` which gives you more
+        fine-grained control over request timeouts. After the constructor has
+        been parsed, this is always a `urllib3.util.Timeout` object.
+
+    :param maxsize:
+        Number of connections to save that can be reused. More than 1 is useful
+        in multithreaded situations. If ``block`` is set to False, more
+        connections will be created but they will not be saved once they've
+        been used.
+
+    :param block:
+        If set to True, no more than ``maxsize`` connections will be used at
+        a time. When no free connections are available, the call will block
+        until a connection has been released. This is a useful side effect for
+        particular multithreaded situations where one does not want to use more
+        than maxsize connections per host to prevent flooding.
+
+    :param headers:
+        Headers to include with all requests, unless other headers are given
+        explicitly.
+
+    :param retries:
+        Retry configuration to use by default with requests in this pool.
+
+    :param _proxy:
+        Parsed proxy URL, should not be used directly, instead, see
+        :class:`urllib3.ProxyManager`
+
+    :param _proxy_headers:
+        A dictionary with proxy headers, should not be used directly,
+        instead, see :class:`urllib3.ProxyManager`
+
+    :param \\**conn_kw:
+        Additional parameters are used to create fresh :class:`urllib3.connection.HTTPConnection`,
+        :class:`urllib3.connection.HTTPSConnection` instances.
+    """
+
+    scheme = "http"
+    ConnectionCls = HTTPConnection
+    ResponseCls = HTTPResponse
+
+    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
+    ):
+        ConnectionPool.__init__(self, host, port)
+        RequestMethods.__init__(self, headers)
+
+        self.strict = strict
+
+        if not isinstance(timeout, Timeout):
+            timeout = Timeout.from_float(timeout)
+
+        if retries is None:
+            retries = Retry.DEFAULT
+
+        self.timeout = timeout
+        self.retries = retries
+
+        self.pool = self.QueueCls(maxsize)
+        self.block = block
+
+        self.proxy = _proxy
+        self.proxy_headers = _proxy_headers or {}
+        self.proxy_config = _proxy_config
+
+        # Fill the queue up so that doing get() on it will block properly
+        for _ in xrange(maxsize):
+            self.pool.put(None)
+
+        # These are mostly for testing and debugging purposes.
+        self.num_connections = 0
+        self.num_requests = 0
+        self.conn_kw = conn_kw
+
+        if self.proxy:
+            # Enable Nagle's algorithm for proxies, to avoid packet fragmentation.
+            # We cannot know if the user has added default socket options, so we cannot replace the
+            # list.
+            self.conn_kw.setdefault("socket_options", [])
+
+            self.conn_kw["proxy"] = self.proxy
+            self.conn_kw["proxy_config"] = self.proxy_config
+
+        # 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):
+        """
+        Return a fresh :class:`HTTPConnection`.
+        """
+        self.num_connections += 1
+        log.debug(
+            "Starting new HTTP connection (%d): %s:%s",
+            self.num_connections,
+            self.host,
+            self.port or "80",
+        )
+
+        conn = self.ConnectionCls(
+            host=self.host,
+            port=self.port,
+            timeout=self.timeout.connect_timeout,
+            strict=self.strict,
+            **self.conn_kw
+        )
+        return conn
+
+    def _get_conn(self, timeout=None):
+        """
+        Get a connection. Will return a pooled connection if one is available.
+
+        If no connections are available and :prop:`.block` is ``False``, then a
+        fresh connection is returned.
+
+        :param timeout:
+            Seconds to wait before giving up and raising
+            :class:`urllib3.exceptions.EmptyPoolError` if the pool is empty and
+            :prop:`.block` is ``True``.
+        """
+        conn = None
+        try:
+            conn = self.pool.get(block=self.block, timeout=timeout)
+
+        except AttributeError:  # self.pool is None
+            raise ClosedPoolError(self, "Pool is closed.")
+
+        except queue.Empty:
+            if self.block:
+                raise EmptyPoolError(
+                    self,
+                    "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):
+        """
+        Put a connection back into the pool.
+
+        :param conn:
+            Connection object for the current host and port as returned by
+            :meth:`._new_conn` or :meth:`._get_conn`.
+
+        If the pool is already full, the connection is closed and discarded
+        because we exceeded maxsize. If connections are discarded frequently,
+        then maxsize should be increased.
+
+        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(),
+            )
+        # Connection never got put back into the pool, close it.
+        if conn:
+            conn.close()
+
+    def _validate_conn(self, conn):
+        """
+        Called right before a request is made, after the socket is created.
+        """
+        pass
+
+    def _prepare_proxy(self, conn):
+        # Nothing to do for HTTP connections.
+        pass
+
+    def _get_timeout(self, timeout):
+        """Helper that always returns a :class:`urllib3.util.Timeout`"""
+        if timeout is _Default:
+            return self.timeout.clone()
+
+        if isinstance(timeout, Timeout):
+            return timeout.clone()
+        else:
+            # User passed us an int/float. This is for backwards compatibility,
+            # can be removed later
+            return Timeout.from_float(timeout)
+
+    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, "Read timed out. (read timeout=%s)" % timeout_value
+            )
+
+        # 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, "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, method, url, timeout=_Default, chunked=False, **httplib_request_kw
+    ):
+        """
+        Perform a request on a given urllib connection object taken from our
+        pool.
+
+        :param conn:
+            a connection from one of our connection pools
+
+        :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.
+        """
+        self.num_requests += 1
+
+        timeout_obj = self._get_timeout(timeout)
+        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
+
+        # 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)
+
+        # 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/ECONNRESET are 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,
+                errno.ECONNRESET,
+            }:
+                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):
+            # 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
+            # the exception and assuming all BadStatusLine exceptions are read
+            # 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
+                )
+            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:
+            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
+
+        # 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,
+            self.host,
+            self.port,
+            method,
+            url,
+            http_version,
+            httplib_response.status,
+            httplib_response.length,
+        )
+
+        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 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.
+        """
+        if self.pool is None:
+            return
+        # Disable access to the pool
+        old_pool, self.pool = self.pool, None
+
+        # Close all the HTTPConnections in the pool.
+        _close_pool_connections(old_pool)
+
+    def is_same_host(self, url):
+        """
+        Check if the given ``url`` is a member of the same host as this
+        connection pool.
+        """
+        if url.startswith("/"):
+            return True
+
+        # TODO: Add optional support for socket.gethostbyname checking.
+        scheme, host, port = get_host(url)
+        if host is not None:
+            host = _normalize_host(host, scheme=scheme)
+
+        # Use explicit default port for comparison when none is given
+        if self.port and not port:
+            port = port_by_scheme.get(scheme)
+        elif not self.port and port == port_by_scheme.get(scheme):
+            port = None
+
+        return (scheme, host, port) == (self.scheme, self.host, self.port)
+
+    def urlopen(
+        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
+    ):
+        """
+        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
+        the raw details.
+
+        .. note::
+
+           More commonly, it's appropriate to use a convenience method provided
+           by :class:`.RequestMethods`, such as :meth:`request`.
+
+        .. note::
+
+           `release_conn` will only behave as expected if
+           `preload_content=False` because we want to make
+           `preload_content=False` the default behaviour someday soon without
+           breaking backwards compatibility.
+
+        :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 redirect:
+            If True, automatically handle redirects (status codes 301, 302,
+            303, 307, 308). Each redirect counts as a retry. Disabling retries
+            will disable redirect, too.
+
+        :param assert_same_host:
+            If ``True``, will make sure that the host of the pool requests is
+            consistent else will raise HostChangedError. When ``False``, you can
+            use the pool on an HTTP proxy and request foreign hosts.
+
+        :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 pool_timeout:
+            If set and the pool is set to block=True, then this method will
+            block for ``pool_timeout`` seconds and raise EmptyPoolError if no
+            connection is available within the time period.
+
+        :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
+            you read the entire contents of the response such as when
+            `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)``.
+
+        :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 int body_pos:
+            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
+
+        if headers is None:
+            headers = self.headers
+
+        if not isinstance(retries, Retry):
+            retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
+
+        if release_conn is None:
+            release_conn = response_kw.get("preload_content", True)
+
+        # Check host
+        if assert_same_host and not self.is_same_host(url):
+            raise HostChangedError(self, url, retries)
+
+        # Ensure that the URL we're connecting to is properly encoded
+        if url.startswith("/"):
+            url = six.ensure_str(_encode_target(url))
+        else:
+            url = six.ensure_str(parsed_url.url)
+
+        conn = None
+
+        # Track whether `conn` needs to be released before
+        # returning/raising/recursing. Update this variable if necessary, and
+        # leave `release_conn` constant throughout the function. That way, if
+        # the function recurses, the original value of `release_conn` will be
+        # passed down into the recursive call, and its value will be respected.
+        #
+        # See issue #651 [1] for details.
+        #
+        # [1] 
+        release_this_conn = release_conn
+
+        http_tunnel_required = connection_requires_http_tunnel(
+            self.proxy, self.proxy_config, destination_scheme
+        )
+
+        # Merge the proxy headers. Only done when not using HTTP CONNECT. We
+        # 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)
+
+        # Must keep the exception bound to a separate variable or else Python 3
+        # complains about UnboundLocalError.
+        err = None
+
+        # Keep track of whether we cleanly exited the except block. This
+        # ensures we do proper cleanup in finally.
+        clean_exit = False
+
+        # Rewind body position, if needed. Record current position
+        # for future rewinds in the event of a redirect/retry.
+        body_pos = set_file_position(body, body_pos)
+
+        try:
+            # Request a connection from the queue.
+            timeout_obj = self._get_timeout(timeout)
+            conn = self._get_conn(timeout=pool_timeout)
+
+            conn.timeout = timeout_obj.connect_timeout
+
+            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,
+            )
+
+            # 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_kw
+            )
+
+            # Everything went great!
+            clean_exit = True
+
+        except EmptyPoolError:
+            # Didn't get a connection from the pool, no need to clean up
+            clean_exit = True
+            release_this_conn = False
+            raise
+
+        except (
+            TimeoutError,
+            HTTPException,
+            SocketError,
+            ProtocolError,
+            BaseSSLError,
+            SSLError,
+            CertificateError,
+        ) 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
+                    or "record layer failure" 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=e, _pool=self, _stacktrace=sys.exc_info()[2]
+            )
+            retries.sleep()
+
+            # Keep track of the error for the retry warning.
+            err = e
+
+        finally:
+            if not clean_exit:
+                # We hit some kind of exception, handled or otherwise. We need
+                # 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()
+                release_this_conn = True
+
+            if release_this_conn:
+                # Put the connection back to be reused. If the connection is
+                # expired then it will be None, which will get replaced with a
+                # fresh connection during _get_conn.
+                self._put_conn(conn)
+
+        if not conn:
+            # Try again
+            log.warning(
+                "Retrying (%r) after connection broken by '%r': %s", retries, err, url
+            )
+            return self.urlopen(
+                method,
+                url,
+                body,
+                headers,
+                retries,
+                redirect,
+                assert_same_host,
+                timeout=timeout,
+                pool_timeout=pool_timeout,
+                release_conn=release_conn,
+                chunked=chunked,
+                body_pos=body_pos,
+                **response_kw
+            )
+
+        # Handle redirect?
+        redirect_location = redirect and response.get_redirect_location()
+        if redirect_location:
+            if response.status == 303:
+                # Change the method according to RFC 9110, Section 15.4.4.
+                method = "GET"
+                # And lose the body not to transfer anything sensitive.
+                body = None
+                headers = HTTPHeaderDict(headers)._prepare_for_method_change()
+
+            try:
+                retries = retries.increment(method, url, response=response, _pool=self)
+            except MaxRetryError:
+                if retries.raise_on_redirect:
+                    response.drain_conn()
+                    raise
+                return response
+
+            response.drain_conn()
+            retries.sleep_for_retry(response)
+            log.debug("Redirecting %s -> %s", url, redirect_location)
+            return self.urlopen(
+                method,
+                redirect_location,
+                body,
+                headers,
+                retries=retries,
+                redirect=redirect,
+                assert_same_host=assert_same_host,
+                timeout=timeout,
+                pool_timeout=pool_timeout,
+                release_conn=release_conn,
+                chunked=chunked,
+                body_pos=body_pos,
+                **response_kw
+            )
+
+        # Check if we should retry the HTTP response.
+        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)
+            except MaxRetryError:
+                if retries.raise_on_status:
+                    response.drain_conn()
+                    raise
+                return response
+
+            response.drain_conn()
+            retries.sleep(response)
+            log.debug("Retry: %s", url)
+            return self.urlopen(
+                method,
+                url,
+                body,
+                headers,
+                retries=retries,
+                redirect=redirect,
+                assert_same_host=assert_same_host,
+                timeout=timeout,
+                pool_timeout=pool_timeout,
+                release_conn=release_conn,
+                chunked=chunked,
+                body_pos=body_pos,
+                **response_kw
+            )
+
+        return response
+
+
+class HTTPSConnectionPool(HTTPConnectionPool):
+    """
+    Same as :class:`.HTTPConnectionPool`, but HTTPS.
+
+    :class:`.HTTPSConnection` uses one of ``assert_fingerprint``,
+    ``assert_hostname`` and ``host`` in this order to verify connections.
+    If ``assert_hostname`` is False, no verification is done.
+
+    The ``key_file``, ``cert_file``, ``cert_reqs``, ``ca_certs``,
+    ``ca_cert_dir``, ``ssl_version``, ``key_password`` are only used if :mod:`ssl`
+    is available and are fed into :meth:`urllib3.util.ssl_wrap_socket` to upgrade
+    the connection socket into an SSL socket.
+    """
+
+    scheme = "https"
+    ConnectionCls = 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,
+            port,
+            strict,
+            timeout,
+            maxsize,
+            block,
+            headers,
+            retries,
+            _proxy,
+            _proxy_headers,
+            **conn_kw
+        )
+
+        self.key_file = key_file
+        self.cert_file = cert_file
+        self.cert_reqs = cert_reqs
+        self.key_password = key_password
+        self.ca_certs = ca_certs
+        self.ca_cert_dir = ca_cert_dir
+        self.ssl_version = ssl_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
+
+        conn.connect()
+
+    def _new_conn(self):
+        """
+        Return a fresh :class:`http.client.HTTPSConnection`.
+        """
+        self.num_connections += 1
+        log.debug(
+            "Starting new HTTPS connection (%d): %s:%s",
+            self.num_connections,
+            self.host,
+            self.port or "443",
+        )
+
+        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 = self.host
+        actual_port = self.port
+        if self.proxy is not None:
+            actual_host = self.proxy.host
+            actual_port = self.proxy.port
+
+        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,
+            **self.conn_kw
+        )
+
+        return self._prepare_conn(conn)
+
+    def _validate_conn(self, conn):
+        """
+        Called right before a request is made, after the socket is created.
+        """
+        super(HTTPSConnectionPool, self)._validate_conn(conn)
+
+        # Force connect early to allow us to validate the connection.
+        if not getattr(conn, "sock", None):  # AppEngine might not have  `.sock`
+            conn.connect()
+
+        if not conn.is_verified:
+            warnings.warn(
+                (
+                    "Unverified HTTPS request is being made to host '%s'. "
+                    "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"
+                ),
+                InsecureRequestWarning,
+            )
+
+
+def connection_from_url(url, **kw):
+    """
+    Given a url, return an :class:`.ConnectionPool` instance of its host.
+
+    This is a shortcut for not having to parse out the scheme, host, and port
+    of the url before creating an :class:`.ConnectionPool` instance.
+
+    :param url:
+        Absolute URL string that must include the scheme. Port is optional.
+
+    :param \\**kw:
+        Passes additional parameters to the constructor of the appropriate
+        :class:`.ConnectionPool`. Useful for specifying things like
+        timeout, maxsize, headers, etc.
+
+    Example::
+
+        >>> conn = connection_from_url('http://google.com/')
+        >>> r = conn.request('GET', '/')
+    """
+    scheme, host, port = get_host(url)
+    port = port or port_by_scheme.get(scheme, 80)
+    if scheme == "https":
+        return HTTPSConnectionPool(host, port=port, **kw)
+    else:
+        return HTTPConnectionPool(host, port=port, **kw)
+
+
+def _normalize_host(host, scheme):
+    """
+    Normalize hosts for comparisons and use with sockets.
+    """
+
+    host = normalize_host(host, scheme)
+
+    # httplib doesn't like it when we include brackets in IPv6 addresses
+    # Specifically, if we include brackets but also pass the port then
+    # httplib crazily doubles up the square brackets on the Host header.
+    # 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("]"):
+        host = host[1:-1]
+    return host
+
+
+def _close_pool_connections(pool):
+    """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/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py
new file mode 100644
index 0000000..8765b90
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/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/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py
new file mode 100644
index 0000000..264d564
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py
@@ -0,0 +1,519 @@
+"""
+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
+SecureTransport. These are essentially the C-level functions and constants, and
+they're pretty gross to work with.
+
+This code is a bastardised version of the code found in Will Bond's oscrypto
+library. An enormous debt is owed to him for blazing this trail for us. For
+that reason, this code should be considered to be covered both by urllib3's
+license and by oscrypto's:
+
+    Copyright (c) 2015-2016 Will Bond 
+
+    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.
+"""
+from __future__ import absolute_import
+
+import platform
+from ctypes import (
+    CDLL,
+    CFUNCTYPE,
+    POINTER,
+    c_bool,
+    c_byte,
+    c_char_p,
+    c_int32,
+    c_long,
+    c_size_t,
+    c_uint32,
+    c_ulong,
+    c_void_p,
+)
+from ctypes.util import find_library
+
+from ...packages.six import raise_from
+
+if platform.system() != "Darwin":
+    raise ImportError("Only macOS is supported")
+
+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])
+    )
+
+
+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.
+        if version_info >= (10, 16):
+            path = macos10_16_path
+        else:
+            path = find_library(name)
+        if not 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)
+
+
+Security = load_cdll(
+    "Security", "/System/Library/Frameworks/Security.framework/Security"
+)
+CoreFoundation = load_cdll(
+    "CoreFoundation",
+    "/System/Library/Frameworks/CoreFoundation.framework/CoreFoundation",
+)
+
+
+Boolean = c_bool
+CFIndex = c_long
+CFStringEncoding = c_uint32
+CFData = c_void_p
+CFString = c_void_p
+CFArray = c_void_p
+CFMutableArray = c_void_p
+CFDictionary = c_void_p
+CFError = c_void_p
+CFType = c_void_p
+CFTypeID = c_ulong
+
+CFTypeRef = POINTER(CFType)
+CFAllocatorRef = c_void_p
+
+OSStatus = c_int32
+
+CFDataRef = POINTER(CFData)
+CFStringRef = POINTER(CFString)
+CFArrayRef = POINTER(CFArray)
+CFMutableArrayRef = POINTER(CFMutableArray)
+CFDictionaryRef = POINTER(CFDictionary)
+CFArrayCallBacks = c_void_p
+CFDictionaryKeyCallBacks = c_void_p
+CFDictionaryValueCallBacks = c_void_p
+
+SecCertificateRef = POINTER(c_void_p)
+SecExternalFormat = c_uint32
+SecExternalItemType = c_uint32
+SecIdentityRef = POINTER(c_void_p)
+SecItemImportExportFlags = c_uint32
+SecItemImportExportKeyParameters = c_void_p
+SecKeychainRef = POINTER(c_void_p)
+SSLProtocol = c_uint32
+SSLCipherSuite = c_uint32
+SSLContextRef = POINTER(c_void_p)
+SecTrustRef = POINTER(c_void_p)
+SSLConnectionRef = c_uint32
+SecTrustResultType = c_uint32
+SecTrustOptionFlags = c_uint32
+SSLProtocolSide = c_uint32
+SSLConnectionType = c_uint32
+SSLSessionOption = c_uint32
+
+
+try:
+    Security.SecItemImport.argtypes = [
+        CFDataRef,
+        CFStringRef,
+        POINTER(SecExternalFormat),
+        POINTER(SecExternalItemType),
+        SecItemImportExportFlags,
+        POINTER(SecItemImportExportKeyParameters),
+        SecKeychainRef,
+        POINTER(CFArrayRef),
+    ]
+    Security.SecItemImport.restype = OSStatus
+
+    Security.SecCertificateGetTypeID.argtypes = []
+    Security.SecCertificateGetTypeID.restype = CFTypeID
+
+    Security.SecIdentityGetTypeID.argtypes = []
+    Security.SecIdentityGetTypeID.restype = CFTypeID
+
+    Security.SecKeyGetTypeID.argtypes = []
+    Security.SecKeyGetTypeID.restype = CFTypeID
+
+    Security.SecCertificateCreateWithData.argtypes = [CFAllocatorRef, CFDataRef]
+    Security.SecCertificateCreateWithData.restype = SecCertificateRef
+
+    Security.SecCertificateCopyData.argtypes = [SecCertificateRef]
+    Security.SecCertificateCopyData.restype = CFDataRef
+
+    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
+    Security.SecCopyErrorMessageString.restype = CFStringRef
+
+    Security.SecIdentityCreateWithCertificate.argtypes = [
+        CFTypeRef,
+        SecCertificateRef,
+        POINTER(SecIdentityRef),
+    ]
+    Security.SecIdentityCreateWithCertificate.restype = OSStatus
+
+    Security.SecKeychainCreate.argtypes = [
+        c_char_p,
+        c_uint32,
+        c_void_p,
+        Boolean,
+        c_void_p,
+        POINTER(SecKeychainRef),
+    ]
+    Security.SecKeychainCreate.restype = OSStatus
+
+    Security.SecKeychainDelete.argtypes = [SecKeychainRef]
+    Security.SecKeychainDelete.restype = OSStatus
+
+    Security.SecPKCS12Import.argtypes = [
+        CFDataRef,
+        CFDictionaryRef,
+        POINTER(CFArrayRef),
+    ]
+    Security.SecPKCS12Import.restype = OSStatus
+
+    SSLReadFunc = CFUNCTYPE(OSStatus, SSLConnectionRef, c_void_p, POINTER(c_size_t))
+    SSLWriteFunc = CFUNCTYPE(
+        OSStatus, SSLConnectionRef, POINTER(c_byte), POINTER(c_size_t)
+    )
+
+    Security.SSLSetIOFuncs.argtypes = [SSLContextRef, SSLReadFunc, SSLWriteFunc]
+    Security.SSLSetIOFuncs.restype = OSStatus
+
+    Security.SSLSetPeerID.argtypes = [SSLContextRef, c_char_p, c_size_t]
+    Security.SSLSetPeerID.restype = OSStatus
+
+    Security.SSLSetCertificate.argtypes = [SSLContextRef, CFArrayRef]
+    Security.SSLSetCertificate.restype = OSStatus
+
+    Security.SSLSetCertificateAuthorities.argtypes = [SSLContextRef, CFTypeRef, Boolean]
+    Security.SSLSetCertificateAuthorities.restype = OSStatus
+
+    Security.SSLSetConnection.argtypes = [SSLContextRef, SSLConnectionRef]
+    Security.SSLSetConnection.restype = OSStatus
+
+    Security.SSLSetPeerDomainName.argtypes = [SSLContextRef, c_char_p, c_size_t]
+    Security.SSLSetPeerDomainName.restype = OSStatus
+
+    Security.SSLHandshake.argtypes = [SSLContextRef]
+    Security.SSLHandshake.restype = OSStatus
+
+    Security.SSLRead.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)]
+    Security.SSLRead.restype = OSStatus
+
+    Security.SSLWrite.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)]
+    Security.SSLWrite.restype = OSStatus
+
+    Security.SSLClose.argtypes = [SSLContextRef]
+    Security.SSLClose.restype = OSStatus
+
+    Security.SSLGetNumberSupportedCiphers.argtypes = [SSLContextRef, POINTER(c_size_t)]
+    Security.SSLGetNumberSupportedCiphers.restype = OSStatus
+
+    Security.SSLGetSupportedCiphers.argtypes = [
+        SSLContextRef,
+        POINTER(SSLCipherSuite),
+        POINTER(c_size_t),
+    ]
+    Security.SSLGetSupportedCiphers.restype = OSStatus
+
+    Security.SSLSetEnabledCiphers.argtypes = [
+        SSLContextRef,
+        POINTER(SSLCipherSuite),
+        c_size_t,
+    ]
+    Security.SSLSetEnabledCiphers.restype = OSStatus
+
+    Security.SSLGetNumberEnabledCiphers.argtype = [SSLContextRef, POINTER(c_size_t)]
+    Security.SSLGetNumberEnabledCiphers.restype = OSStatus
+
+    Security.SSLGetEnabledCiphers.argtypes = [
+        SSLContextRef,
+        POINTER(SSLCipherSuite),
+        POINTER(c_size_t),
+    ]
+    Security.SSLGetEnabledCiphers.restype = OSStatus
+
+    Security.SSLGetNegotiatedCipher.argtypes = [SSLContextRef, POINTER(SSLCipherSuite)]
+    Security.SSLGetNegotiatedCipher.restype = OSStatus
+
+    Security.SSLGetNegotiatedProtocolVersion.argtypes = [
+        SSLContextRef,
+        POINTER(SSLProtocol),
+    ]
+    Security.SSLGetNegotiatedProtocolVersion.restype = OSStatus
+
+    Security.SSLCopyPeerTrust.argtypes = [SSLContextRef, POINTER(SecTrustRef)]
+    Security.SSLCopyPeerTrust.restype = OSStatus
+
+    Security.SecTrustSetAnchorCertificates.argtypes = [SecTrustRef, CFArrayRef]
+    Security.SecTrustSetAnchorCertificates.restype = OSStatus
+
+    Security.SecTrustSetAnchorCertificatesOnly.argstypes = [SecTrustRef, Boolean]
+    Security.SecTrustSetAnchorCertificatesOnly.restype = OSStatus
+
+    Security.SecTrustEvaluate.argtypes = [SecTrustRef, POINTER(SecTrustResultType)]
+    Security.SecTrustEvaluate.restype = OSStatus
+
+    Security.SecTrustGetCertificateCount.argtypes = [SecTrustRef]
+    Security.SecTrustGetCertificateCount.restype = CFIndex
+
+    Security.SecTrustGetCertificateAtIndex.argtypes = [SecTrustRef, CFIndex]
+    Security.SecTrustGetCertificateAtIndex.restype = SecCertificateRef
+
+    Security.SSLCreateContext.argtypes = [
+        CFAllocatorRef,
+        SSLProtocolSide,
+        SSLConnectionType,
+    ]
+    Security.SSLCreateContext.restype = SSLContextRef
+
+    Security.SSLSetSessionOption.argtypes = [SSLContextRef, SSLSessionOption, Boolean]
+    Security.SSLSetSessionOption.restype = OSStatus
+
+    Security.SSLSetProtocolVersionMin.argtypes = [SSLContextRef, SSLProtocol]
+    Security.SSLSetProtocolVersionMin.restype = OSStatus
+
+    Security.SSLSetProtocolVersionMax.argtypes = [SSLContextRef, SSLProtocol]
+    Security.SSLSetProtocolVersionMax.restype = OSStatus
+
+    try:
+        Security.SSLSetALPNProtocols.argtypes = [SSLContextRef, CFArrayRef]
+        Security.SSLSetALPNProtocols.restype = OSStatus
+    except AttributeError:
+        # Supported only in 10.12+
+        pass
+
+    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
+    Security.SecCopyErrorMessageString.restype = CFStringRef
+
+    Security.SSLReadFunc = SSLReadFunc
+    Security.SSLWriteFunc = SSLWriteFunc
+    Security.SSLContextRef = SSLContextRef
+    Security.SSLProtocol = SSLProtocol
+    Security.SSLCipherSuite = SSLCipherSuite
+    Security.SecIdentityRef = SecIdentityRef
+    Security.SecKeychainRef = SecKeychainRef
+    Security.SecTrustRef = SecTrustRef
+    Security.SecTrustResultType = SecTrustResultType
+    Security.SecExternalFormat = SecExternalFormat
+    Security.OSStatus = OSStatus
+
+    Security.kSecImportExportPassphrase = CFStringRef.in_dll(
+        Security, "kSecImportExportPassphrase"
+    )
+    Security.kSecImportItemIdentity = CFStringRef.in_dll(
+        Security, "kSecImportItemIdentity"
+    )
+
+    # CoreFoundation time!
+    CoreFoundation.CFRetain.argtypes = [CFTypeRef]
+    CoreFoundation.CFRetain.restype = CFTypeRef
+
+    CoreFoundation.CFRelease.argtypes = [CFTypeRef]
+    CoreFoundation.CFRelease.restype = None
+
+    CoreFoundation.CFGetTypeID.argtypes = [CFTypeRef]
+    CoreFoundation.CFGetTypeID.restype = CFTypeID
+
+    CoreFoundation.CFStringCreateWithCString.argtypes = [
+        CFAllocatorRef,
+        c_char_p,
+        CFStringEncoding,
+    ]
+    CoreFoundation.CFStringCreateWithCString.restype = CFStringRef
+
+    CoreFoundation.CFStringGetCStringPtr.argtypes = [CFStringRef, CFStringEncoding]
+    CoreFoundation.CFStringGetCStringPtr.restype = c_char_p
+
+    CoreFoundation.CFStringGetCString.argtypes = [
+        CFStringRef,
+        c_char_p,
+        CFIndex,
+        CFStringEncoding,
+    ]
+    CoreFoundation.CFStringGetCString.restype = c_bool
+
+    CoreFoundation.CFDataCreate.argtypes = [CFAllocatorRef, c_char_p, CFIndex]
+    CoreFoundation.CFDataCreate.restype = CFDataRef
+
+    CoreFoundation.CFDataGetLength.argtypes = [CFDataRef]
+    CoreFoundation.CFDataGetLength.restype = CFIndex
+
+    CoreFoundation.CFDataGetBytePtr.argtypes = [CFDataRef]
+    CoreFoundation.CFDataGetBytePtr.restype = c_void_p
+
+    CoreFoundation.CFDictionaryCreate.argtypes = [
+        CFAllocatorRef,
+        POINTER(CFTypeRef),
+        POINTER(CFTypeRef),
+        CFIndex,
+        CFDictionaryKeyCallBacks,
+        CFDictionaryValueCallBacks,
+    ]
+    CoreFoundation.CFDictionaryCreate.restype = CFDictionaryRef
+
+    CoreFoundation.CFDictionaryGetValue.argtypes = [CFDictionaryRef, CFTypeRef]
+    CoreFoundation.CFDictionaryGetValue.restype = CFTypeRef
+
+    CoreFoundation.CFArrayCreate.argtypes = [
+        CFAllocatorRef,
+        POINTER(CFTypeRef),
+        CFIndex,
+        CFArrayCallBacks,
+    ]
+    CoreFoundation.CFArrayCreate.restype = CFArrayRef
+
+    CoreFoundation.CFArrayCreateMutable.argtypes = [
+        CFAllocatorRef,
+        CFIndex,
+        CFArrayCallBacks,
+    ]
+    CoreFoundation.CFArrayCreateMutable.restype = CFMutableArrayRef
+
+    CoreFoundation.CFArrayAppendValue.argtypes = [CFMutableArrayRef, c_void_p]
+    CoreFoundation.CFArrayAppendValue.restype = None
+
+    CoreFoundation.CFArrayGetCount.argtypes = [CFArrayRef]
+    CoreFoundation.CFArrayGetCount.restype = CFIndex
+
+    CoreFoundation.CFArrayGetValueAtIndex.argtypes = [CFArrayRef, CFIndex]
+    CoreFoundation.CFArrayGetValueAtIndex.restype = c_void_p
+
+    CoreFoundation.kCFAllocatorDefault = CFAllocatorRef.in_dll(
+        CoreFoundation, "kCFAllocatorDefault"
+    )
+    CoreFoundation.kCFTypeArrayCallBacks = c_void_p.in_dll(
+        CoreFoundation, "kCFTypeArrayCallBacks"
+    )
+    CoreFoundation.kCFTypeDictionaryKeyCallBacks = c_void_p.in_dll(
+        CoreFoundation, "kCFTypeDictionaryKeyCallBacks"
+    )
+    CoreFoundation.kCFTypeDictionaryValueCallBacks = c_void_p.in_dll(
+        CoreFoundation, "kCFTypeDictionaryValueCallBacks"
+    )
+
+    CoreFoundation.CFTypeRef = CFTypeRef
+    CoreFoundation.CFArrayRef = CFArrayRef
+    CoreFoundation.CFStringRef = CFStringRef
+    CoreFoundation.CFDictionaryRef = CFDictionaryRef
+
+except (AttributeError):
+    raise ImportError("Error initializing ctypes")
+
+
+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/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py
new file mode 100644
index 0000000..fa0b245
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py
@@ -0,0 +1,397 @@
+"""
+Low-level helpers for the SecureTransport bindings.
+
+These are Python functions that are not directly related to the high-level APIs
+but are necessary to get them to work. They include a whole bunch of low-level
+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.
+"""
+import base64
+import ctypes
+import itertools
+import os
+import re
+import ssl
+import struct
+import tempfile
+
+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(
+    b"-----BEGIN CERTIFICATE-----\n(.*?)\n-----END CERTIFICATE-----", re.DOTALL
+)
+
+
+def _cf_data_from_bytes(bytestring):
+    """
+    Given a bytestring, create a CFData object from it. This CFData object must
+    be CFReleased by the caller.
+    """
+    return CoreFoundation.CFDataCreate(
+        CoreFoundation.kCFAllocatorDefault, bytestring, len(bytestring)
+    )
+
+
+def _cf_dictionary_from_tuples(tuples):
+    """
+    Given a list of Python tuples, create an associated CFDictionary.
+    """
+    dictionary_size = len(tuples)
+
+    # We need to get the dictionary keys and values out in the same order.
+    keys = (t[0] for t in tuples)
+    values = (t[1] for t in tuples)
+    cf_keys = (CoreFoundation.CFTypeRef * dictionary_size)(*keys)
+    cf_values = (CoreFoundation.CFTypeRef * dictionary_size)(*values)
+
+    return CoreFoundation.CFDictionaryCreate(
+        CoreFoundation.kCFAllocatorDefault,
+        cf_keys,
+        cf_values,
+        dictionary_size,
+        CoreFoundation.kCFTypeDictionaryKeyCallBacks,
+        CoreFoundation.kCFTypeDictionaryValueCallBacks,
+    )
+
+
+def _cfstr(py_bstr):
+    """
+    Given a Python binary data, create a CFString.
+    The string must be CFReleased by the caller.
+    """
+    c_str = ctypes.c_char_p(py_bstr)
+    cf_str = CoreFoundation.CFStringCreateWithCString(
+        CoreFoundation.kCFAllocatorDefault,
+        c_str,
+        CFConst.kCFStringEncodingUTF8,
+    )
+    return cf_str
+
+
+def _create_cfstring_array(lst):
+    """
+    Given a list of Python binary data, create an associated CFMutableArray.
+    The array must be CFReleased by the caller.
+
+    Raises an ssl.SSLError on failure.
+    """
+    cf_arr = None
+    try:
+        cf_arr = CoreFoundation.CFArrayCreateMutable(
+            CoreFoundation.kCFAllocatorDefault,
+            0,
+            ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+        )
+        if not cf_arr:
+            raise MemoryError("Unable to allocate memory!")
+        for item in lst:
+            cf_str = _cfstr(item)
+            if not cf_str:
+                raise MemoryError("Unable to allocate memory!")
+            try:
+                CoreFoundation.CFArrayAppendValue(cf_arr, cf_str)
+            finally:
+                CoreFoundation.CFRelease(cf_str)
+    except BaseException as e:
+        if cf_arr:
+            CoreFoundation.CFRelease(cf_arr)
+        raise ssl.SSLError("Unable to allocate array: %s" % (e,))
+    return cf_arr
+
+
+def _cf_string_to_unicode(value):
+    """
+    Creates a Unicode string from a CFString object. Used entirely for error
+    reporting.
+
+    Yes, it annoys me quite a lot that this function is this complex.
+    """
+    value_as_void_p = ctypes.cast(value, ctypes.POINTER(ctypes.c_void_p))
+
+    string = CoreFoundation.CFStringGetCStringPtr(
+        value_as_void_p, CFConst.kCFStringEncodingUTF8
+    )
+    if string is None:
+        buffer = ctypes.create_string_buffer(1024)
+        result = CoreFoundation.CFStringGetCString(
+            value_as_void_p, buffer, 1024, CFConst.kCFStringEncodingUTF8
+        )
+        if not result:
+            raise OSError("Error copying C string from CFStringRef")
+        string = buffer.value
+    if string is not None:
+        string = string.decode("utf-8")
+    return string
+
+
+def _assert_no_error(error, exception_class=None):
+    """
+    Checks the return code and throws an exception if there is an error to
+    report
+    """
+    if error == 0:
+        return
+
+    cf_error_string = Security.SecCopyErrorMessageString(error, 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 exception_class is None:
+        exception_class = ssl.SSLError
+
+    raise exception_class(output)
+
+
+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.
+    """
+    # Normalize the PEM bundle's line endings.
+    pem_bundle = pem_bundle.replace(b"\r\n", b"\n")
+
+    der_certs = [
+        base64.b64decode(match.group(1)) for match in _PEM_CERTS_RE.finditer(pem_bundle)
+    ]
+    if not der_certs:
+        raise ssl.SSLError("No root certificates specified")
+
+    cert_array = CoreFoundation.CFArrayCreateMutable(
+        CoreFoundation.kCFAllocatorDefault,
+        0,
+        ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+    )
+    if not cert_array:
+        raise ssl.SSLError("Unable to allocate memory!")
+
+    try:
+        for der_bytes in der_certs:
+            certdata = _cf_data_from_bytes(der_bytes)
+            if not certdata:
+                raise ssl.SSLError("Unable to allocate memory!")
+            cert = Security.SecCertificateCreateWithData(
+                CoreFoundation.kCFAllocatorDefault, certdata
+            )
+            CoreFoundation.CFRelease(certdata)
+            if not cert:
+                raise ssl.SSLError("Unable to build cert object!")
+
+            CoreFoundation.CFArrayAppendValue(cert_array, cert)
+            CoreFoundation.CFRelease(cert)
+    except Exception:
+        # We need to free the array before the exception bubbles further.
+        # We only want to do that if an error occurs: otherwise, the caller
+        # should free.
+        CoreFoundation.CFRelease(cert_array)
+        raise
+
+    return cert_array
+
+
+def _is_cert(item):
+    """
+    Returns True if a given CFTypeRef is a certificate.
+    """
+    expected = Security.SecCertificateGetTypeID()
+    return CoreFoundation.CFGetTypeID(item) == expected
+
+
+def _is_identity(item):
+    """
+    Returns True if a given CFTypeRef is an identity.
+    """
+    expected = Security.SecIdentityGetTypeID()
+    return CoreFoundation.CFGetTypeID(item) == expected
+
+
+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
+    store the data. We expect to have one keychain per socket. The returned
+    SecKeychainRef must be freed by the caller, including calling
+    SecKeychainDelete.
+
+    Returns a tuple of the SecKeychainRef and the path to the temporary
+    directory that contains it.
+    """
+    # Unfortunately, SecKeychainCreate requires a path to a keychain. This
+    # means we cannot use mkstemp to use a generic temporary file. Instead,
+    # we're going to create a temporary directory and a filename to use there.
+    # This filename will be 8 random bytes expanded into base64. We also need
+    # some random bytes to password-protect the keychain we're creating, so we
+    # ask for 40 random bytes.
+    random_bytes = os.urandom(40)
+    filename = base64.b16encode(random_bytes[:8]).decode("utf-8")
+    password = base64.b16encode(random_bytes[8:])  # Must be valid UTF-8
+    tempdirectory = tempfile.mkdtemp()
+
+    keychain_path = os.path.join(tempdirectory, filename).encode("utf-8")
+
+    # We now want to create the keychain itself.
+    keychain = Security.SecKeychainRef()
+    status = Security.SecKeychainCreate(
+        keychain_path, len(password), password, False, None, ctypes.byref(keychain)
+    )
+    _assert_no_error(status)
+
+    # Having created the keychain, we want to pass it off to the caller.
+    return keychain, tempdirectory
+
+
+def _load_items_from_file(keychain, path):
+    """
+    Given a single file, loads all the trust objects from it into arrays and
+    the keychain.
+    Returns a tuple of lists: the first list is a list of identities, the
+    second a list of certs.
+    """
+    certificates = []
+    identities = []
+    result_array = None
+
+    with open(path, "rb") as f:
+        raw_filedata = f.read()
+
+    try:
+        filedata = CoreFoundation.CFDataCreate(
+            CoreFoundation.kCFAllocatorDefault, raw_filedata, len(raw_filedata)
+        )
+        result_array = CoreFoundation.CFArrayRef()
+        result = Security.SecItemImport(
+            filedata,  # cert data
+            None,  # Filename, leaving it out for now
+            None,  # What the type of the file is, we don't care
+            None,  # what's in the file, we don't care
+            0,  # import flags
+            None,  # key params, can include passphrase in the future
+            keychain,  # The keychain to insert into
+            ctypes.byref(result_array),  # Results
+        )
+        _assert_no_error(result)
+
+        # A CFArray is not very useful to us as an intermediary
+        # representation, so we are going to extract the objects we want
+        # and then free the array. We don't need to keep hold of keys: the
+        # keychain already has them!
+        result_count = CoreFoundation.CFArrayGetCount(result_array)
+        for index in range(result_count):
+            item = CoreFoundation.CFArrayGetValueAtIndex(result_array, index)
+            item = ctypes.cast(item, CoreFoundation.CFTypeRef)
+
+            if _is_cert(item):
+                CoreFoundation.CFRetain(item)
+                certificates.append(item)
+            elif _is_identity(item):
+                CoreFoundation.CFRetain(item)
+                identities.append(item)
+    finally:
+        if result_array:
+            CoreFoundation.CFRelease(result_array)
+
+        CoreFoundation.CFRelease(filedata)
+
+    return (identities, certificates)
+
+
+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
+    SecCertificateRef objects, suitable for use as a client certificate trust
+    chain.
+    """
+    # Ok, the strategy.
+    #
+    # This relies on knowing that macOS will not give you a SecIdentityRef
+    # unless you have imported a key into a keychain. This is a somewhat
+    # artificial limitation of macOS (for example, it doesn't necessarily
+    # affect iOS), but there is nothing inside Security.framework that lets you
+    # get a SecIdentityRef without having a key in a keychain.
+    #
+    # So the policy here is we take all the files and iterate them in order.
+    # Each one will use SecItemImport to have one or more objects loaded from
+    # it. We will also point at a keychain that macOS can use to work with the
+    # private key.
+    #
+    # Once we have all the objects, we'll check what we actually have. If we
+    # already have a SecIdentityRef in hand, fab: we'll use that. Otherwise,
+    # we'll take the first certificate (which we assume to be our leaf) and
+    # ask the keychain to give us a SecIdentityRef with that cert's associated
+    # key.
+    #
+    # We'll then return a CFArray containing the trust chain: one
+    # SecIdentityRef and then zero-or-more SecCertificateRef objects. The
+    # responsibility for freeing this CFArray will be with the caller. This
+    # CFArray must remain alive for the entire connection, so in practice it
+    # will be stored with a single SSLSocket, along with the reference to the
+    # keychain.
+    certificates = []
+    identities = []
+
+    # Filter out bad paths.
+    paths = (path for path in paths if path)
+
+    try:
+        for file_path in paths:
+            new_identities, new_certs = _load_items_from_file(keychain, file_path)
+            identities.extend(new_identities)
+            certificates.extend(new_certs)
+
+        # Ok, we have everything. The question is: do we have an identity? If
+        # not, we want to grab one from the first cert we have.
+        if not identities:
+            new_identity = Security.SecIdentityRef()
+            status = Security.SecIdentityCreateWithCertificate(
+                keychain, certificates[0], ctypes.byref(new_identity)
+            )
+            _assert_no_error(status)
+            identities.append(new_identity)
+
+            # We now want to release the original certificate, as we no longer
+            # need it.
+            CoreFoundation.CFRelease(certificates.pop(0))
+
+        # We now need to build a new CFArray that holds the trust chain.
+        trust_chain = CoreFoundation.CFArrayCreateMutable(
+            CoreFoundation.kCFAllocatorDefault,
+            0,
+            ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+        )
+        for item in itertools.chain(identities, certificates):
+            # ArrayAppendValue does a CFRetain on the item. That's fine,
+            # because the finally block will release our other refs to them.
+            CoreFoundation.CFArrayAppendValue(trust_chain, item)
+
+        return trust_chain
+    finally:
+        for obj in itertools.chain(identities, certificates):
+            CoreFoundation.CFRelease(obj)
+
+
+TLS_PROTOCOL_VERSIONS = {
+    "SSLv2": (0, 2),
+    "SSLv3": (3, 0),
+    "TLSv1": (3, 1),
+    "TLSv1.1": (3, 2),
+    "TLSv1.2": (3, 3),
+}
+
+
+def _build_tls_unknown_ca_alert(version):
+    """
+    Builds a TLS alert record for an unknown CA.
+    """
+    ver_maj, ver_min = TLS_PROTOCOL_VERSIONS[version]
+    severity_fatal = 0x02
+    description_unknown_ca = 0x30
+    msg = struct.pack(">BB", severity_fatal, description_unknown_ca)
+    msg_len = len(msg)
+    record_type_alert = 0x15
+    record = struct.pack(">BBBH", record_type_alert, ver_maj, ver_min, msg_len) + msg
+    return record
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/appengine.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/appengine.py
new file mode 100644
index 0000000..1717ee2
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/appengine.py
@@ -0,0 +1,314 @@
+"""
+This module provides a pool manager that uses Google App Engine's
+`URLFetch Service `_.
+
+Example usage::
+
+    from pip._vendor.urllib3 import PoolManager
+    from pip._vendor.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 `_ 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
+   `_ 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
+`_, 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
+    `_.
+
+    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/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py
new file mode 100644
index 0000000..4716657
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/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/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py
new file mode 100644
index 0000000..19e4aa9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py
@@ -0,0 +1,518 @@
+"""
+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:
+
+* `pyOpenSSL`_ (tested with 16.0.0)
+* `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
+use all three directly here we end up having relatively few packages required.
+
+You can install them with the following command:
+
+.. code-block:: bash
+
+    $ python -m pip install pyopenssl cryptography idna
+
+To activate certificate checking, call
+:func:`~urllib3.contrib.pyopenssl.inject_into_urllib3` from your Python code
+before you begin making HTTP requests. This can be done in a ``sitecustomize``
+module, or at any other time before your application begins using ``urllib3``,
+like this:
+
+.. code-block:: python
+
+    try:
+        import pip._vendor.urllib3.contrib.pyopenssl as pyopenssl
+        pyopenssl.inject_into_urllib3()
+    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 cryptography import x509
+from cryptography.hazmat.backends.openssl import backend as openssl_backend
+
+try:
+    from cryptography.x509 import UnsupportedExtension
+except ImportError:
+    # UnsupportedExtension is gone in cryptography >= 2.1.0
+    class UnsupportedExtension(Exception):
+        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 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.
+HAS_SNI = True
+
+# Map from urllib3 to PyOpenSSL compatible parameter-values.
+_openssl_versions = {
+    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
+
+if hasattr(ssl, "PROTOCOL_TLSv1_2") and hasattr(OpenSSL.SSL, "TLSv1_2_METHOD"):
+    _openssl_versions[ssl.PROTOCOL_TLSv1_2] = OpenSSL.SSL.TLSv1_2_METHOD
+
+
+_stdlib_to_openssl_verify = {
+    ssl.CERT_NONE: OpenSSL.SSL.VERIFY_NONE,
+    ssl.CERT_OPTIONAL: OpenSSL.SSL.VERIFY_PEER,
+    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 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():
+    "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.IS_PYOPENSSL = True
+    util.ssl_.IS_PYOPENSSL = True
+
+
+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():
+    """
+    Verifies that PyOpenSSL's package-level dependencies have been met.
+    Throws `ImportError` if they are not met.
+    """
+    # Method added in `cryptography==1.1`; not available in older versions
+    from cryptography.x509.extensions import Extensions
+
+    if getattr(Extensions, "get_extension_for_class", None) is None:
+        raise ImportError(
+            "'cryptography' module missing required functionality.  "
+            "Try upgrading to v1.3.4 or newer."
+        )
+
+    # pyOpenSSL 0.14 and above use cryptography for OpenSSL bindings. The _x509
+    # attribute is only present on those versions.
+    from OpenSSL.crypto import X509
+
+    x509 = X509()
+    if getattr(x509, "_x509", None) is None:
+        raise ImportError(
+            "'pyOpenSSL' module missing required functionality. "
+            "Try upgrading to v0.14 or newer."
+        )
+
+
+def _dnsname_to_stdlib(name):
+    """
+    Converts a dNSName SubjectAlternativeName field to the form used by the
+    standard library on the given Python version.
+
+    Cryptography produces a dNSName as a unicode string that was idna-decoded
+    from ASCII bytes. We need to idna-encode that string to get it back, and
+    then on Python 3 we also need to convert to unicode via UTF-8 (the stdlib
+    uses PyUnicode_FromStringAndSize on it, which decodes via UTF-8).
+
+    If the name cannot be idna-encoded then we return None signalling that
+    the name given should be skipped.
+    """
+
+    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
+        wildcard names. This avoids that problem.
+        """
+        from pip._vendor import idna
+
+        try:
+            for prefix in [u"*.", u"."]:
+                if name.startswith(prefix):
+                    name = name[len(prefix) :]
+                    return prefix.encode("ascii") + idna.encode(name)
+            return idna.encode(name)
+        except idna.core.IDNAError:
+            return None
+
+    # Don't send IPv6 addresses through the IDNA encoder.
+    if ":" in name:
+        return name
+
+    name = idna_encode(name)
+    if name is None:
+        return None
+    elif sys.version_info >= (3, 0):
+        name = name.decode("utf-8")
+    return name
+
+
+def get_subj_alt_name(peer_cert):
+    """
+    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)
+
+    # We want to find the SAN extension. Ask Cryptography to locate it (it's
+    # faster than looping in Python)
+    try:
+        ext = cert.extensions.get_extension_for_class(x509.SubjectAlternativeName).value
+    except x509.ExtensionNotFound:
+        # No such extension, return the empty list.
+        return []
+    except (
+        x509.DuplicateExtension,
+        UnsupportedExtension,
+        x509.UnsupportedGeneralNameType,
+        UnicodeError,
+    ) as e:
+        # A problem has been found with the quality of the certificate. Assume
+        # no SAN field is present.
+        log.warning(
+            "A problem was encountered with the certificate that prevented "
+            "urllib3 from finding the SubjectAlternativeName field. This can "
+            "affect certificate validation. The error was %s",
+            e,
+        )
+        return []
+
+    # We want to return dNSName and iPAddress fields. We need to cast the IPs
+    # back to strings because the match_hostname function wants them as
+    # strings.
+    # Sadly the DNS names need to be idna encoded and then, on Python 3, UTF-8
+    # decoded. This is pretty frustrating, but that's what the standard library
+    # does with certificates, and so we need to attempt to do the same.
+    # We also want to skip over names which cannot be idna encoded.
+    names = [
+        ("DNS", name)
+        for name in map(_dnsname_to_stdlib, ext.get_values_for_type(x509.DNSName))
+        if name is not None
+    ]
+    names.extend(
+        ("IP Address", str(name)) for name in ext.get_values_for_type(x509.IPAddress)
+    )
+
+    return names
+
+
+class WrappedSocket(object):
+    """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):
+        self.connection = connection
+        self.socket = socket
+        self.suppress_ragged_eofs = suppress_ragged_eofs
+        self._makefile_refs = 0
+        self._closed = False
+
+    def fileno(self):
+        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
+        if self._closed:
+            self.close()
+
+    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 SocketError(str(e))
+        except OpenSSL.SSL.ZeroReturnError:
+            if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
+                return b""
+            else:
+                raise
+        except OpenSSL.SSL.WantReadError:
+            if not util.wait_for_read(self.socket, self.socket.gettimeout()):
+                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("read error: %r" % e)
+        else:
+            return data
+
+    def recv_into(self, *args, **kwargs):
+        try:
+            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 SocketError(str(e))
+        except OpenSSL.SSL.ZeroReturnError:
+            if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
+                return 0
+            else:
+                raise
+        except OpenSSL.SSL.WantReadError:
+            if not util.wait_for_read(self.socket, self.socket.gettimeout()):
+                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("read error: %r" % e)
+
+    def settimeout(self, timeout):
+        return self.socket.settimeout(timeout)
+
+    def _send_until_done(self, data):
+        while True:
+            try:
+                return self.connection.send(data)
+            except OpenSSL.SSL.WantWriteError:
+                if not util.wait_for_write(self.socket, self.socket.gettimeout()):
+                    raise timeout()
+                continue
+            except OpenSSL.SSL.SysCallError as e:
+                raise SocketError(str(e))
+
+    def sendall(self, data):
+        total_sent = 0
+        while total_sent < len(data):
+            sent = self._send_until_done(
+                data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE]
+            )
+            total_sent += sent
+
+    def shutdown(self):
+        # 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 getpeercert(self, binary_form=False):
+        x509 = self.connection.get_peer_certificate()
+
+        if not x509:
+            return x509
+
+        if binary_form:
+            return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509)
+
+        return {
+            "subject": ((("commonName", x509.get_subject().CN),),),
+            "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
+
+
+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(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):
+        self.protocol = _openssl_versions[protocol]
+        self._ctx = OpenSSL.SSL.Context(self.protocol)
+        self._options = 0
+        self.check_hostname = False
+
+    @property
+    def options(self):
+        return self._options
+
+    @options.setter
+    def options(self, value):
+        self._options = value
+        self._ctx.set_options(value)
+
+    @property
+    def verify_mode(self):
+        return _openssl_to_stdlib_verify[self._ctx.get_verify_mode()]
+
+    @verify_mode.setter
+    def verify_mode(self, value):
+        self._ctx.set_verify(_stdlib_to_openssl_verify[value], _verify_callback)
+
+    def set_default_verify_paths(self):
+        self._ctx.set_default_verify_paths()
+
+    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=None, capath=None, cadata=None):
+        if cafile is not None:
+            cafile = cafile.encode("utf-8")
+        if capath is not None:
+            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("unable to load trusted certificates: %r" % 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):
+        protocols = [six.ensure_binary(p) for p in protocols]
+        return self._ctx.set_alpn_protos(protocols)
+
+    def wrap_socket(
+        self,
+        sock,
+        server_side=False,
+        do_handshake_on_connect=True,
+        suppress_ragged_eofs=True,
+        server_hostname=None,
+    ):
+        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:
+            cnx.set_tlsext_host_name(server_hostname)
+
+        cnx.set_connect_state()
+
+        while True:
+            try:
+                cnx.do_handshake()
+            except OpenSSL.SSL.WantReadError:
+                if not util.wait_for_read(sock, sock.gettimeout()):
+                    raise timeout("select timed out")
+                continue
+            except OpenSSL.SSL.Error as e:
+                raise ssl.SSLError("bad handshake: %r" % e)
+            break
+
+        return WrappedSocket(cnx, sock)
+
+
+def _verify_callback(cnx, x509, err_no, err_depth, return_code):
+    return err_no == 0
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/securetransport.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/securetransport.py
new file mode 100644
index 0000000..722ee4e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/securetransport.py
@@ -0,0 +1,920 @@
+"""
+SecureTranport support for urllib3 via ctypes.
+
+This makes platform-native TLS available to urllib3 users on macOS without the
+use of a compiler. This is an important feature because the Python Package
+Index is moving to become a TLSv1.2-or-higher server, and the default OpenSSL
+that ships with macOS is not capable of doing TLSv1.2. The only way to resolve
+this is to give macOS users an alternative solution to the problem, and that
+solution is to use SecureTransport.
+
+We use ctypes here because this solution must not require a compiler. That's
+because pip is not allowed to require a compiler either.
+
+This is not intended to be a seriously long-term solution to this problem.
+The hope is that PEP 543 will eventually solve this issue for us, at which
+point we can retire this contrib module. But in the short term, we need to
+solve the impending tire fire that is Python on Mac without this kind of
+contrib module. So...here we are.
+
+To use this module, simply import and inject it::
+
+    import pip._vendor.urllib3.contrib.securetransport as securetransport
+    securetransport.inject_into_urllib3()
+
+Happy TLSing!
+
+This code is a bastardised version of the code found in Will Bond's oscrypto
+library. An enormous debt is owed to him for blazing this trail for us. For
+that reason, this code should be considered to be covered both by urllib3's
+license and by oscrypto's:
+
+.. code-block::
+
+    Copyright (c) 2015-2016 Will Bond 
+
+    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.
+"""
+from __future__ import absolute_import
+
+import contextlib
+import ctypes
+import errno
+import os.path
+import shutil
+import socket
+import ssl
+import struct
+import threading
+import weakref
+
+from .. import util
+from ..packages import six
+from ..util.ssl_ import PROTOCOL_TLS_CLIENT
+from ._securetransport.bindings import CoreFoundation, Security, SecurityConst
+from ._securetransport.low_level import (
+    _assert_no_error,
+    _build_tls_unknown_ca_alert,
+    _cert_array_from_pem,
+    _create_cfstring_array,
+    _load_client_cert_chain,
+    _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
+
+__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
+# calling wrapped socket. This is a pretty silly approach, but for now it'll
+# do. I feel like I should be able to smuggle a handle to the wrapped socket
+# directly in the SSLConnectionRef, but for now this approach will work I
+# guess.
+#
+# We need to lock around this structure for inserts, but we don't do it for
+# reads/writes in the callbacks. The reasoning here goes as follows:
+#
+#    1. It is not possible to call into the callbacks before the dictionary is
+#       populated, so once in the callback the id must be in the dictionary.
+#    2. The callbacks don't mutate the dictionary, they only read from it, and
+#       so cannot conflict with any of the insertions.
+#
+# 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_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),
+}
+
+if hasattr(ssl, "PROTOCOL_SSLv2"):
+    _protocol_to_min_max[ssl.PROTOCOL_SSLv2] = (
+        SecurityConst.kSSLProtocol2,
+        SecurityConst.kSSLProtocol2,
+    )
+if hasattr(ssl, "PROTOCOL_SSLv3"):
+    _protocol_to_min_max[ssl.PROTOCOL_SSLv3] = (
+        SecurityConst.kSSLProtocol3,
+        SecurityConst.kSSLProtocol3,
+    )
+if hasattr(ssl, "PROTOCOL_TLSv1"):
+    _protocol_to_min_max[ssl.PROTOCOL_TLSv1] = (
+        SecurityConst.kTLSProtocol1,
+        SecurityConst.kTLSProtocol1,
+    )
+if hasattr(ssl, "PROTOCOL_TLSv1_1"):
+    _protocol_to_min_max[ssl.PROTOCOL_TLSv1_1] = (
+        SecurityConst.kTLSProtocol11,
+        SecurityConst.kTLSProtocol11,
+    )
+if hasattr(ssl, "PROTOCOL_TLSv1_2"):
+    _protocol_to_min_max[ssl.PROTOCOL_TLSv1_2] = (
+        SecurityConst.kTLSProtocol12,
+        SecurityConst.kTLSProtocol12,
+    )
+
+
+def inject_into_urllib3():
+    """
+    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.IS_SECURETRANSPORT = True
+    util.ssl_.IS_SECURETRANSPORT = True
+
+
+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, data_buffer, data_length_pointer):
+    """
+    SecureTransport read callback. This is called by ST to request that data
+    be returned from the socket.
+    """
+    wrapped_socket = None
+    try:
+        wrapped_socket = _connection_refs.get(connection_id)
+        if wrapped_socket is None:
+            return SecurityConst.errSSLInternal
+        base_socket = wrapped_socket.socket
+
+        requested_length = data_length_pointer[0]
+
+        timeout = wrapped_socket.gettimeout()
+        error = None
+        read_count = 0
+
+        try:
+            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")
+
+                remaining = requested_length - read_count
+                buffer = (ctypes.c_char * remaining).from_address(
+                    data_buffer + read_count
+                )
+                chunk_size = base_socket.recv_into(buffer, remaining)
+                read_count += chunk_size
+                if not chunk_size:
+                    if not read_count:
+                        return SecurityConst.errSSLClosedGraceful
+                    break
+        except (socket.error) as e:
+            error = e.errno
+
+            if error is not None and error != errno.EAGAIN:
+                data_length_pointer[0] = read_count
+                if error == errno.ECONNRESET or error == errno.EPIPE:
+                    return SecurityConst.errSSLClosedAbort
+                raise
+
+        data_length_pointer[0] = read_count
+
+        if read_count != requested_length:
+            return SecurityConst.errSSLWouldBlock
+
+        return 0
+    except Exception as e:
+        if wrapped_socket is not None:
+            wrapped_socket._exception = e
+        return SecurityConst.errSSLInternal
+
+
+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.
+    """
+    wrapped_socket = None
+    try:
+        wrapped_socket = _connection_refs.get(connection_id)
+        if wrapped_socket is None:
+            return SecurityConst.errSSLInternal
+        base_socket = wrapped_socket.socket
+
+        bytes_to_write = data_length_pointer[0]
+        data = ctypes.string_at(data_buffer, bytes_to_write)
+
+        timeout = wrapped_socket.gettimeout()
+        error = None
+        sent = 0
+
+        try:
+            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")
+                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:
+            error = e.errno
+
+            if error is not None and error != errno.EAGAIN:
+                data_length_pointer[0] = sent
+                if error == errno.ECONNRESET or error == errno.EPIPE:
+                    return SecurityConst.errSSLClosedAbort
+                raise
+
+        data_length_pointer[0] = sent
+
+        if sent != bytes_to_write:
+            return SecurityConst.errSSLWouldBlock
+
+        return 0
+    except Exception as e:
+        if wrapped_socket is not None:
+            wrapped_socket._exception = e
+        return SecurityConst.errSSLInternal
+
+
+# We need to keep these two objects references alive: if they get GC'd while
+# in use then SecureTransport could attempt to call a function that is in freed
+# memory. That would be...uh...bad. Yeah, that's the word. Bad.
+_read_callback_pointer = Security.SSLReadFunc(_read_callback)
+_write_callback_pointer = Security.SSLWriteFunc(_write_callback)
+
+
+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):
+        self.socket = socket
+        self.context = None
+        self._makefile_refs = 0
+        self._closed = False
+        self._exception = None
+        self._keychain = None
+        self._keychain_dir = None
+        self._client_cert_chain = None
+
+        # We save off the previously-configured timeout and then set it to
+        # zero. This is done because we use select and friends to handle the
+        # timeouts, but if we leave the timeout set on the lower socket then
+        # Python will "kindly" call select on that socket again for us. Avoid
+        # that by forcing the timeout to zero.
+        self._timeout = self.socket.gettimeout()
+        self.socket.settimeout(0)
+
+    @contextlib.contextmanager
+    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
+        context manager will correctly propagate the exception after the fact.
+        This avoids silently swallowing those exceptions.
+
+        It also correctly forces the socket closed.
+        """
+        self._exception = None
+
+        # We explicitly don't catch around this yield because in the unlikely
+        # event that an exception was hit in the block we don't want to swallow
+        # it.
+        yield
+        if self._exception is not None:
+            exception, self._exception = self._exception, None
+            self.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):
+        """
+        Sets up the ALPN protocols on the context.
+        """
+        if not protocols:
+            return
+        protocols_arr = _create_cfstring_array(protocols)
+        try:
+            result = Security.SSLSetALPNProtocols(self.context, protocols_arr)
+            _assert_no_error(result)
+        finally:
+            CoreFoundation.CFRelease(protocols_arr)
+
+    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
+        using a custom trust DB.
+        Raises an SSLError if the connection is not trusted.
+        """
+        # If we disabled cert validation, just say: cool.
+        if not verify:
+            return
+
+        successes = (
+            SecurityConst.kSecTrustResultUnspecified,
+            SecurityConst.kSecTrustResultProceed,
+        )
+        try:
+            trust_result = self._evaluate_trust(trust_bundle)
+            if trust_result in successes:
+                return
+            reason = "error code: %d" % (trust_result,)
+        except Exception as e:
+            # Do not trust on error
+            reason = "exception: %r" % (e,)
+
+        # SecureTransport does not send an alert nor shuts down the connection.
+        rec = _build_tls_unknown_ca_alert(self.version())
+        self.socket.sendall(rec)
+        # close the connection immediately
+        # l_onoff = 1, activate linger
+        # 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)
+
+    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:
+                trust_bundle = f.read()
+
+        cert_array = None
+        trust = Security.SecTrustRef()
+
+        try:
+            # Get a CFArray that contains the certs we want.
+            cert_array = _cert_array_from_pem(trust_bundle)
+
+            # Ok, now the hard part. We want to get the SecTrustRef that ST has
+            # created for this connection, shove our CAs into it, tell ST to
+            # ignore everything else it knows, and then ask if it can build a
+            # chain. This is a buuuunch of code.
+            result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust))
+            _assert_no_error(result)
+            if not trust:
+                raise ssl.SSLError("Failed to copy trust reference")
+
+            result = Security.SecTrustSetAnchorCertificates(trust, cert_array)
+            _assert_no_error(result)
+
+            result = Security.SecTrustSetAnchorCertificatesOnly(trust, True)
+            _assert_no_error(result)
+
+            trust_result = Security.SecTrustResultType()
+            result = Security.SecTrustEvaluate(trust, ctypes.byref(trust_result))
+            _assert_no_error(result)
+        finally:
+            if trust:
+                CoreFoundation.CFRelease(trust)
+
+            if cert_array is not None:
+                CoreFoundation.CFRelease(cert_array)
+
+        return trust_result.value
+
+    def handshake(
+        self,
+        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.
+        """
+        # First, we do the initial bits of connection setup. We need to create
+        # a context, set its I/O funcs, and set the connection reference.
+        self.context = Security.SSLCreateContext(
+            None, SecurityConst.kSSLClientSide, SecurityConst.kSSLStreamType
+        )
+        result = Security.SSLSetIOFuncs(
+            self.context, _read_callback_pointer, _write_callback_pointer
+        )
+        _assert_no_error(result)
+
+        # Here we need to compute the handle to use. We do this by taking the
+        # id of self modulo 2**31 - 1. If this is already in the dictionary, we
+        # just keep incrementing by one until we find a free space.
+        with _connection_ref_lock:
+            handle = id(self) % 2147483647
+            while handle in _connection_refs:
+                handle = (handle + 1) % 2147483647
+            _connection_refs[handle] = self
+
+        result = Security.SSLSetConnection(self.context, handle)
+        _assert_no_error(result)
+
+        # If we have a server hostname, we should set that too.
+        if server_hostname:
+            if not isinstance(server_hostname, bytes):
+                server_hostname = server_hostname.encode("utf-8")
+
+            result = Security.SSLSetPeerDomainName(
+                self.context, server_hostname, len(server_hostname)
+            )
+            _assert_no_error(result)
+
+        # Setup the ciphers.
+        self._set_ciphers()
+
+        # Setup the ALPN protocols.
+        self._set_alpn_protocols(alpn_protocols)
+
+        # Set the minimum and maximum TLS versions.
+        result = Security.SSLSetProtocolVersionMin(self.context, min_version)
+        _assert_no_error(result)
+
+        result = Security.SSLSetProtocolVersionMax(self.context, max_version)
+        _assert_no_error(result)
+
+        # If there's a trust DB, we need to use it. We do that by telling
+        # SecureTransport to break on server auth. We also do that if we don't
+        # want to validate the certs at all: we just won't actually do any
+        # authing in that case.
+        if not verify or trust_bundle is not None:
+            result = Security.SSLSetSessionOption(
+                self.context, SecurityConst.kSSLSessionOptionBreakOnServerAuth, True
+            )
+            _assert_no_error(result)
+
+        # If there's a client cert, we need to use it.
+        if client_cert:
+            self._keychain, self._keychain_dir = _temporary_keychain()
+            self._client_cert_chain = _load_client_cert_chain(
+                self._keychain, client_cert, client_key
+            )
+            result = Security.SSLSetCertificate(self.context, self._client_cert_chain)
+            _assert_no_error(result)
+
+        while True:
+            with self._raise_on_error():
+                result = Security.SSLHandshake(self.context)
+
+                if result == SecurityConst.errSSLWouldBlock:
+                    raise socket.timeout("handshake timed out")
+                elif result == SecurityConst.errSSLServerAuthCompleted:
+                    self._custom_validate(verify, trust_bundle)
+                    continue
+                else:
+                    _assert_no_error(result)
+                    break
+
+    def fileno(self):
+        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
+        if self._closed:
+            self.close()
+
+    def recv(self, bufsiz):
+        buffer = ctypes.create_string_buffer(bufsiz)
+        bytes_read = self.recv_into(buffer, bufsiz)
+        data = buffer[:bytes_read]
+        return data
+
+    def recv_into(self, buffer, nbytes=None):
+        # Read short on EOF.
+        if self._closed:
+            return 0
+
+        if nbytes is None:
+            nbytes = len(buffer)
+
+        buffer = (ctypes.c_char * nbytes).from_buffer(buffer)
+        processed_bytes = ctypes.c_size_t(0)
+
+        with self._raise_on_error():
+            result = Security.SSLRead(
+                self.context, buffer, nbytes, ctypes.byref(processed_bytes)
+            )
+
+        # There are some result codes that we want to treat as "not always
+        # errors". Specifically, those are errSSLWouldBlock,
+        # errSSLClosedGraceful, and errSSLClosedNoNotify.
+        if result == SecurityConst.errSSLWouldBlock:
+            # If we didn't process any bytes, then this was just a time out.
+            # However, we can get errSSLWouldBlock in situations when we *did*
+            # read some data, and in those cases we should just read "short"
+            # and return.
+            if processed_bytes.value == 0:
+                # Timed out, no data read.
+                raise socket.timeout("recv timed out")
+        elif result in (
+            SecurityConst.errSSLClosedGraceful,
+            SecurityConst.errSSLClosedNoNotify,
+        ):
+            # The remote peer has closed this connection. We should do so as
+            # 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()
+        else:
+            _assert_no_error(result)
+
+        # Ok, we read and probably succeeded. We should return whatever data
+        # was actually read.
+        return processed_bytes.value
+
+    def settimeout(self, timeout):
+        self._timeout = timeout
+
+    def gettimeout(self):
+        return self._timeout
+
+    def send(self, data):
+        processed_bytes = ctypes.c_size_t(0)
+
+        with self._raise_on_error():
+            result = Security.SSLWrite(
+                self.context, data, len(data), ctypes.byref(processed_bytes)
+            )
+
+        if result == SecurityConst.errSSLWouldBlock and processed_bytes.value == 0:
+            # Timed out
+            raise socket.timeout("send timed out")
+        else:
+            _assert_no_error(result)
+
+        # We sent, and probably succeeded. Tell them how much we sent.
+        return processed_bytes.value
+
+    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):
+        with self._raise_on_error():
+            Security.SSLClose(self.context)
+
+    def close(self):
+        # 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
+
+    def getpeercert(self, binary_form=False):
+        # Urgh, annoying.
+        #
+        # Here's how we do this:
+        #
+        # 1. Call SSLCopyPeerTrust to get hold of the trust object for this
+        #    connection.
+        # 2. Call SecTrustGetCertificateAtIndex for index 0 to get the leaf.
+        # 3. To get the CN, call SecCertificateCopyCommonName and process that
+        #    string so that it's of the appropriate type.
+        # 4. To get the SAN, we need to do something a bit more complex:
+        #    a. Call SecCertificateCopyValues to get the data, requesting
+        #       kSecOIDSubjectAltName.
+        #    b. Mess about with this dictionary to try to get the SANs out.
+        #
+        # This is gross. Really gross. It's going to be a few hundred LoC extra
+        # just to repeat something that SecureTransport can *already do*. So my
+        # operating assumption at this time is that what we want to do is
+        # instead to just flag to urllib3 that it shouldn't do its own hostname
+        # validation when using SecureTransport.
+        if not binary_form:
+            raise ValueError("SecureTransport only supports dumping binary certs")
+        trust = Security.SecTrustRef()
+        certdata = None
+        der_bytes = None
+
+        try:
+            # Grab the trust store.
+            result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust))
+            _assert_no_error(result)
+            if not trust:
+                # Probably we haven't done the handshake yet. No biggie.
+                return None
+
+            cert_count = Security.SecTrustGetCertificateCount(trust)
+            if not cert_count:
+                # Also a case that might happen if we haven't handshaked.
+                # Handshook? Handshaken?
+                return None
+
+            leaf = Security.SecTrustGetCertificateAtIndex(trust, 0)
+            assert leaf
+
+            # Ok, now we want the DER bytes.
+            certdata = Security.SecCertificateCopyData(leaf)
+            assert certdata
+
+            data_length = CoreFoundation.CFDataGetLength(certdata)
+            data_buffer = CoreFoundation.CFDataGetBytePtr(certdata)
+            der_bytes = ctypes.string_at(data_buffer, data_length)
+        finally:
+            if certdata:
+                CoreFoundation.CFRelease(certdata)
+            if trust:
+                CoreFoundation.CFRelease(trust)
+
+        return der_bytes
+
+    def version(self):
+        protocol = Security.SSLProtocol()
+        result = Security.SSLGetNegotiatedProtocolVersion(
+            self.context, ctypes.byref(protocol)
+        )
+        _assert_no_error(result)
+        if protocol.value == SecurityConst.kTLSProtocol13:
+            raise ssl.SSLError("SecureTransport does not support TLS 1.3")
+        elif protocol.value == SecurityConst.kTLSProtocol12:
+            return "TLSv1.2"
+        elif protocol.value == SecurityConst.kTLSProtocol11:
+            return "TLSv1.1"
+        elif protocol.value == SecurityConst.kTLSProtocol1:
+            return "TLSv1"
+        elif protocol.value == SecurityConst.kSSLProtocol3:
+            return "SSLv3"
+        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
+
+
+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
+
+
+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):
+        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._client_key_passphrase = None
+        self._alpn_protocols = None
+
+    @property
+    def check_hostname(self):
+        """
+        SecureTransport cannot have its hostname checking disabled. For more,
+        see the comment on getpeercert() in this file.
+        """
+        return True
+
+    @check_hostname.setter
+    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):
+        # TODO: Well, crap.
+        #
+        # So this is the bit of the code that is the most likely to cause us
+        # trouble. Essentially we need to enumerate all of the SSL options that
+        # users might want to use and try to see if we can sensibly translate
+        # them, or whether we should just ignore them.
+        return self._options
+
+    @options.setter
+    def options(self, value):
+        # TODO: Update in line with above.
+        self._options = value
+
+    @property
+    def verify_mode(self):
+        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 set_default_verify_paths(self):
+        # So, this has to do something a bit weird. Specifically, what it does
+        # is nothing.
+        #
+        # This means that, if we had previously had load_verify_locations
+        # called, this does not undo that. We need to do that because it turns
+        # out that the rest of the urllib3 code will attempt to load the
+        # default verify paths if it hasn't been told about any paths, even if
+        # the context itself was sometime earlier. We resolve that by just
+        # ignoring it.
+        pass
+
+    def load_default_certs(self):
+        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 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")
+
+        # Raise if cafile does not exist.
+        if cafile is not None:
+            with open(cafile):
+                pass
+
+        self._trust_bundle = cafile or cadata
+
+    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):
+        """
+        Sets the ALPN protocols that will later be set on the context.
+
+        Raises a NotImplementedError if ALPN is not supported.
+        """
+        if not hasattr(Security, "SSLSetALPNProtocols"):
+            raise NotImplementedError(
+                "SecureTransport supports ALPN only in macOS 10.12+"
+            )
+        self._alpn_protocols = [six.ensure_binary(p) for p in protocols]
+
+    def wrap_socket(
+        self,
+        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.
+        assert not server_side
+        assert do_handshake_on_connect
+        assert suppress_ragged_eofs
+
+        # Ok, we're good to go. Now we want to create the wrapped socket object
+        # and store it in the appropriate place.
+        wrapped_socket = WrappedSocket(sock)
+
+        # Now we can handshake
+        wrapped_socket.handshake(
+            server_hostname,
+            self._verify,
+            self._trust_bundle,
+            self._min_version,
+            self._max_version,
+            self._client_cert,
+            self._client_key,
+            self._client_key_passphrase,
+            self._alpn_protocols,
+        )
+        return wrapped_socket
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/socks.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/socks.py
new file mode 100644
index 0000000..c326e80
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/socks.py
@@ -0,0 +1,216 @@
+# -*- coding: utf-8 -*-
+"""
+This module contains provisional support for SOCKS proxies from within
+urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and
+SOCKS5. To enable its functionality, either install PySocks or install this
+module with the ``socks`` extra.
+
+The SOCKS implementation supports the full range of urllib3 features. It also
+supports the following SOCKS features:
+
+- SOCKS4A (``proxy_url='socks4a://...``)
+- SOCKS4 (``proxy_url='socks4://...``)
+- SOCKS5 with remote DNS (``proxy_url='socks5h://...``)
+- SOCKS5 with local DNS (``proxy_url='socks5://...``)
+- Usernames and passwords for the SOCKS proxy
+
+.. note::
+   It is recommended to use ``socks5h://`` or ``socks4a://`` schemes in
+   your ``proxy_url`` to ensure that DNS resolution is done from the remote
+   server instead of client-side when connecting to a domain name.
+
+SOCKS4 supports IPv4 and domain names with the SOCKS4A extension. SOCKS5
+supports IPv4, IPv6, and domain names.
+
+When connecting to a SOCKS4 proxy the ``username`` portion of the ``proxy_url``
+will be sent as the ``userid`` section of the SOCKS request:
+
+.. code-block:: python
+
+    proxy_url="socks4a://@proxy-host"
+
+When connecting to a SOCKS5 proxy the ``username`` and ``password`` portion
+of the ``proxy_url`` will be sent as the username/password to authenticate
+with the proxy:
+
+.. code-block:: python
+
+    proxy_url="socks5h://:@proxy-host"
+
+"""
+from __future__ import absolute_import
+
+try:
+    import socks
+except ImportError:
+    import warnings
+
+    from ..exceptions import DependencyWarning
+
+    warnings.warn(
+        (
+            "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"
+        ),
+        DependencyWarning,
+    )
+    raise
+
+from socket import error as SocketError
+from socket import timeout as SocketTimeout
+
+from ..connection import HTTPConnection, HTTPSConnection
+from ..connectionpool import HTTPConnectionPool, HTTPSConnectionPool
+from ..exceptions import ConnectTimeoutError, NewConnectionError
+from ..poolmanager import PoolManager
+from ..util.url import parse_url
+
+try:
+    import ssl
+except ImportError:
+    ssl = None
+
+
+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 _new_conn(self):
+        """
+        Establish a new connection via the SOCKS proxy.
+        """
+        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 = socks.create_connection(
+                (self.host, self.port),
+                proxy_type=self._socks_options["socks_version"],
+                proxy_addr=self._socks_options["proxy_host"],
+                proxy_port=self._socks_options["proxy_port"],
+                proxy_username=self._socks_options["username"],
+                proxy_password=self._socks_options["password"],
+                proxy_rdns=self._socks_options["rdns"],
+                timeout=self.timeout,
+                **extra_kw
+            )
+
+        except SocketTimeout:
+            raise ConnectTimeoutError(
+                self,
+                "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
+            # useful errors here.
+            if e.socket_err:
+                error = e.socket_err
+                if isinstance(error, SocketTimeout):
+                    raise ConnectTimeoutError(
+                        self,
+                        "Connection to %s timed out. (connect timeout=%s)"
+                        % (self.host, self.timeout),
+                    )
+                else:
+                    raise NewConnectionError(
+                        self, "Failed to establish a new connection: %s" % error
+                    )
+            else:
+                raise NewConnectionError(
+                    self, "Failed to establish a new connection: %s" % e
+                )
+
+        except SocketError as e:  # Defensive: PySocks should catch all these.
+            raise NewConnectionError(
+                self, "Failed to establish a new connection: %s" % e
+            )
+
+        return conn
+
+
+# We don't need to duplicate the Verified/Unverified distinction from
+# urllib3/connection.py here because the HTTPSConnection will already have been
+# correctly set to either the Verified or Unverified form by that module. This
+# means the SOCKSHTTPSConnection will automatically be the correct type.
+class SOCKSHTTPSConnection(SOCKSConnection, HTTPSConnection):
+    pass
+
+
+class SOCKSHTTPConnectionPool(HTTPConnectionPool):
+    ConnectionCls = SOCKSConnection
+
+
+class SOCKSHTTPSConnectionPool(HTTPSConnectionPool):
+    ConnectionCls = SOCKSHTTPSConnection
+
+
+class SOCKSProxyManager(PoolManager):
+    """
+    A version of the urllib3 ProxyManager that routes connections via the
+    defined SOCKS proxy.
+    """
+
+    pool_classes_by_scheme = {
+        "http": SOCKSHTTPConnectionPool,
+        "https": SOCKSHTTPSConnectionPool,
+    }
+
+    def __init__(
+        self,
+        proxy_url,
+        username=None,
+        password=None,
+        num_pools=10,
+        headers=None,
+        **connection_pool_kw
+    ):
+        parsed = parse_url(proxy_url)
+
+        if username is None and password is None and parsed.auth is not None:
+            split = parsed.auth.split(":")
+            if len(split) == 2:
+                username, password = split
+        if parsed.scheme == "socks5":
+            socks_version = socks.PROXY_TYPE_SOCKS5
+            rdns = False
+        elif parsed.scheme == "socks5h":
+            socks_version = socks.PROXY_TYPE_SOCKS5
+            rdns = True
+        elif parsed.scheme == "socks4":
+            socks_version = socks.PROXY_TYPE_SOCKS4
+            rdns = False
+        elif parsed.scheme == "socks4a":
+            socks_version = socks.PROXY_TYPE_SOCKS4
+            rdns = True
+        else:
+            raise ValueError("Unable to determine SOCKS version from %s" % proxy_url)
+
+        self.proxy_url = proxy_url
+
+        socks_options = {
+            "socks_version": socks_version,
+            "proxy_host": parsed.host,
+            "proxy_port": parsed.port,
+            "username": username,
+            "password": password,
+            "rdns": rdns,
+        }
+        connection_pool_kw["_socks_options"] = socks_options
+
+        super(SOCKSProxyManager, self).__init__(
+            num_pools, headers, **connection_pool_kw
+        )
+
+        self.pool_classes_by_scheme = SOCKSProxyManager.pool_classes_by_scheme
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/exceptions.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/exceptions.py
new file mode 100644
index 0000000..cba6f3f
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/exceptions.py
@@ -0,0 +1,323 @@
+from __future__ import absolute_import
+
+from .packages.six.moves.http_client import IncompleteRead as httplib_IncompleteRead
+
+# Base Exceptions
+
+
+class HTTPError(Exception):
+    """Base exception used by this module."""
+
+    pass
+
+
+class HTTPWarning(Warning):
+    """Base warning used by this module."""
+
+    pass
+
+
+class PoolError(HTTPError):
+    """Base exception for errors caused within a pool."""
+
+    def __init__(self, pool, message):
+        self.pool = pool
+        HTTPError.__init__(self, "%s: %s" % (pool, message))
+
+    def __reduce__(self):
+        # For pickling purposes.
+        return self.__class__, (None, None)
+
+
+class RequestError(PoolError):
+    """Base exception for PoolErrors that have associated URLs."""
+
+    def __init__(self, pool, url, message):
+        self.url = url
+        PoolError.__init__(self, pool, message)
+
+    def __reduce__(self):
+        # For pickling purposes.
+        return self.__class__, (None, self.url, None)
+
+
+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)
+        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
+
+
+# Leaf Exceptions
+
+
+class MaxRetryError(RequestError):
+    """Raised when the maximum number of retries is exceeded.
+
+    :param pool: The connection pool
+    :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool`
+    :param string url: The requested Url
+    :param exceptions.Exception reason: The underlying error
+
+    """
+
+    def __init__(self, pool, url, reason=None):
+        self.reason = reason
+
+        message = "Max retries exceeded with url: %s (Caused by %r)" % (url, reason)
+
+        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, 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.
+
+    Catching this error will catch both :exc:`ReadTimeoutErrors
+    ` and :exc:`ConnectTimeoutErrors `.
+    """
+
+    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):
+    """Raised when we fail to establish a new connection. Usually ECONNREFUSED."""
+
+    pass
+
+
+class EmptyPoolError(PoolError):
+    """Raised when a pool runs out of connections and no more are allowed."""
+
+    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):
+        message = "Failed to parse: %s" % location
+        HTTPError.__init__(self, message)
+
+        self.location = location
+
+
+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)
+
+        self.scheme = scheme
+
+
+class ResponseError(HTTPError):
+    """Used as a container for an error reason supplied in a MaxRetryError."""
+
+    GENERIC_ERROR = "too many error responses"
+    SPECIFIC_ERROR = "too many {status_code} error responses"
+
+
+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 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):
+    """
+    Warned when an attempt is made to import a module with missing optional
+    dependencies.
+    """
+
+    pass
+
+
+class ResponseNotChunked(ProtocolError, ValueError):
+    """Response needs to be chunked in order to read it as chunks."""
+
+    pass
+
+
+class BodyNotHttplibCompatible(HTTPError):
+    """
+    Body should be :class:`http.client.HTTPResponse` like
+    (have an fp attribute which returns raw chunks) for read_chunked().
+    """
+
+    pass
+
+
+class IncompleteRead(HTTPError, httplib_IncompleteRead):
+    """
+    Response length doesn't match expected Content-Length
+
+    Subclass of :class:`http.client.IncompleteRead` to allow int value
+    for ``partial`` to avoid creating large objects on streamed reads.
+    """
+
+    def __init__(self, partial, expected):
+        super(IncompleteRead, self).__init__(partial, expected)
+
+    def __repr__(self):
+        return "IncompleteRead(%i bytes read, %i more expected)" % (
+            self.partial,
+            self.expected,
+        )
+
+
+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
+        )
+        self.response = response
+        self.length = length
+
+    def __repr__(self):
+        return "InvalidChunkLength(got length %r, %i bytes read)" % (
+            self.length,
+            self.partial,
+        )
+
+
+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):
+        # 'localhost' is here because our URL parser parses
+        # localhost:8080 -> scheme=localhost, remove if we fix this.
+        if scheme == "localhost":
+            scheme = None
+        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)
+
+
+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)
+
+
+class UnrewindableBodyError(HTTPError):
+    """urllib3 encountered an error when trying to rewind a body"""
+
+    pass
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/fields.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/fields.py
new file mode 100644
index 0000000..9d630f4
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/fields.py
@@ -0,0 +1,274 @@
+from __future__ import absolute_import
+
+import email.utils
+import mimetypes
+import re
+
+from .packages import six
+
+
+def guess_content_type(filename, default="application/octet-stream"):
+    """
+    Guess the "Content-Type" of a file.
+
+    :param filename:
+        The filename to guess the "Content-Type" of using :mod:`mimetypes`.
+    :param default:
+        If no "Content-Type" can be guessed, default to `default`.
+    """
+    if filename:
+        return mimetypes.guess_type(filename)[0] or default
+    return default
+
+
+def format_header_param_rfc2231(name, value):
+    """
+    Helper function to format and quote a single header parameter using the
+    strategy defined in RFC 2231.
+
+    Particularly useful for header parameters which might contain
+    non-ASCII values, like file names. This follows
+    `RFC 2388 Section 4.4 `_.
+
+    :param name:
+        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:
+        An RFC-2231-formatted unicode string.
+    """
+    if isinstance(value, six.binary_type):
+        value = value.decode("utf-8")
+
+    if not any(ch in value for ch in '"\\\r\n'):
+        result = u'%s="%s"' % (name, value)
+        try:
+            result.encode("ascii")
+        except (UnicodeEncodeError, UnicodeDecodeError):
+            pass
+        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")
+
+    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):
+    """
+    Helper function to format and quote a single header parameter using the
+    HTML5 strategy.
+
+    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.
+
+    .. _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, a string expected to be ASCII only.
+    :param value:
+        The value of the parameter, provided as ``bytes`` or `str``.
+    :ret:
+        A unicode string, stripped of troublesome characters.
+    """
+    if isinstance(value, six.binary_type):
+        value = value.decode("utf-8")
+
+    value = _replace_multiple(value, _HTML5_REPLACEMENTS)
+
+    return u'%s="%s"' % (name, value)
+
+
+# For backwards-compatibility.
+format_header_param = format_header_param_html5
+
+
+class RequestField(object):
+    """
+    A data container for request body parameters.
+
+    :param name:
+        The name of this request field. Must be unicode.
+    :param data:
+        The data/value body.
+    :param filename:
+        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`.
+    """
+
+    def __init__(
+        self,
+        name,
+        data,
+        filename=None,
+        headers=None,
+        header_formatter=format_header_param_html5,
+    ):
+        self._name = name
+        self._filename = filename
+        self.data = data
+        self.headers = {}
+        if headers:
+            self.headers = dict(headers)
+        self.header_formatter = header_formatter
+
+    @classmethod
+    def from_tuples(cls, fieldname, value, header_formatter=format_header_param_html5):
+        """
+        A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters.
+
+        Supports constructing :class:`~urllib3.fields.RequestField` from
+        parameter of key/value strings AND key/filetuple. A filetuple is a
+        (filename, data, MIME type) tuple where the MIME type is optional.
+        For example::
+
+            'foo': 'bar',
+            'fakefile': ('foofile.txt', 'contents of foofile'),
+            'realfile': ('barfile.txt', open('realfile').read()),
+            'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'),
+            'nonamefile': 'contents of nonamefile field',
+
+        Field names and filenames must be unicode.
+        """
+        if isinstance(value, tuple):
+            if len(value) == 3:
+                filename, data, content_type = value
+            else:
+                filename, data = value
+                content_type = guess_content_type(filename)
+        else:
+            filename = None
+            content_type = None
+            data = value
+
+        request_param = cls(
+            fieldname, data, filename=filename, header_formatter=header_formatter
+        )
+        request_param.make_multipart(content_type=content_type)
+
+        return request_param
+
+    def _render_part(self, name, value):
+        """
+        Overridable helper function to format a single header parameter. By
+        default, this calls ``self.header_formatter``.
+
+        :param name:
+            The name of the parameter, a string expected to be ASCII only.
+        :param value:
+            The value of the parameter, provided as a unicode string.
+        """
+
+        return self.header_formatter(name, value)
+
+    def _render_parts(self, header_parts):
+        """
+        Helper function to format and quote a single header.
+
+        Useful for single headers that are composed of multiple items. E.g.,
+        'Content-Disposition' fields.
+
+        :param header_parts:
+            A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format
+            as `k1="v1"; k2="v2"; ...`.
+        """
+        parts = []
+        iterable = header_parts
+        if isinstance(header_parts, dict):
+            iterable = header_parts.items()
+
+        for name, value in iterable:
+            if value is not None:
+                parts.append(self._render_part(name, value))
+
+        return u"; ".join(parts)
+
+    def render_headers(self):
+        """
+        Renders the headers for this request field.
+        """
+        lines = []
+
+        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]))
+
+        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(u"\r\n")
+        return u"\r\n".join(lines)
+
+    def make_multipart(
+        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_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(
+            [
+                u"",
+                self._render_parts(
+                    ((u"name", self._name), (u"filename", self._filename))
+                ),
+            ]
+        )
+        self.headers["Content-Type"] = content_type
+        self.headers["Content-Location"] = content_location
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/filepost.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/filepost.py
new file mode 100644
index 0000000..36c9252
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/filepost.py
@@ -0,0 +1,98 @@
+from __future__ import absolute_import
+
+import binascii
+import codecs
+import os
+from io import BytesIO
+
+from .fields import RequestField
+from .packages import six
+from .packages.six import b
+
+writer = codecs.lookup("utf-8")[3]
+
+
+def choose_boundary():
+    """
+    Our embarrassingly-simple replacement for mimetools.choose_boundary.
+    """
+    boundary = binascii.hexlify(os.urandom(16))
+    if not six.PY2:
+        boundary = boundary.decode("ascii")
+    return boundary
+
+
+def iter_field_objects(fields):
+    """
+    Iterate over fields.
+
+    Supports list of (k, v) tuples and dicts, and lists of
+    :class:`~urllib3.fields.RequestField`.
+
+    """
+    if isinstance(fields, dict):
+        i = six.iteritems(fields)
+    else:
+        i = iter(fields)
+
+    for field in i:
+        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):
+    """
+    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`).
+
+    :param boundary:
+        If not specified, then a random boundary will be generated using
+        :func:`urllib3.filepost.choose_boundary`.
+    """
+    body = BytesIO()
+    if boundary is None:
+        boundary = choose_boundary()
+
+    for field in iter_field_objects(fields):
+        body.write(b("--%s\r\n" % (boundary)))
+
+        writer(body).write(field.render_headers())
+        data = field.data
+
+        if isinstance(data, int):
+            data = str(data)  # Backwards compatibility
+
+        if isinstance(data, six.text_type):
+            writer(body).write(data)
+        else:
+            body.write(data)
+
+        body.write(b"\r\n")
+
+    body.write(b("--%s--\r\n" % (boundary)))
+
+    content_type = str("multipart/form-data; boundary=%s" % boundary)
+
+    return body.getvalue(), content_type
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py
new file mode 100644
index 0000000..b8fb215
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/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/env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/weakref_finalize.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/weakref_finalize.py
new file mode 100644
index 0000000..a2f2966
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/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/env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/six.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/six.py
new file mode 100644
index 0000000..f099a3d
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/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 "
+__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/env/lib/python3.12/site-packages/pip/_vendor/urllib3/poolmanager.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/poolmanager.py
new file mode 100644
index 0000000..fb51bf7
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/poolmanager.py
@@ -0,0 +1,540 @@
+from __future__ import absolute_import
+
+import collections
+import functools
+import logging
+
+from ._collections import HTTPHeaderDict, RecentlyUsedContainer
+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 .util.proxy import connection_requires_http_tunnel
+from .util.retry import Retry
+from .util.url import parse_url
+
+__all__ = ["PoolManager", "ProxyManager", "proxy_from_url"]
+
+
+log = logging.getLogger(__name__)
+
+SSL_KEYWORDS = (
+    "key_file",
+    "cert_file",
+    "cert_reqs",
+    "ca_certs",
+    "ssl_version",
+    "ca_cert_dir",
+    "ssl_context",
+    "key_password",
+    "server_hostname",
+)
+
+# 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)
+
+
+def _default_key_normalizer(key_class, request_context):
+    """
+    Create a pool key out of a request context dictionary.
+
+    According to RFC 3986, both the scheme and host are case-insensitive.
+    Therefore, this function normalizes both before constructing the pool
+    key for an HTTPS request. If you wish to change this behaviour, provide
+    alternate callables to ``key_fn_by_scheme``.
+
+    :param key_class:
+        The class to use when constructing the key. This should be a namedtuple
+        with the ``scheme`` and ``host`` keys at a minimum.
+    :type  key_class: namedtuple
+    :param request_context:
+        A dictionary-like object that contain the context for a request.
+    :type  request_context: dict
+
+    :return: A namedtuple that can be used as a connection pool key.
+    :rtype:  PoolKey
+    """
+    # Since we mutate the dictionary, make a copy first
+    context = request_context.copy()
+    context["scheme"] = context["scheme"].lower()
+    context["host"] = context["host"].lower()
+
+    # These are both dictionaries and need to be transformed into frozensets
+    for key in ("headers", "_proxy_headers", "_socks_options"):
+        if key in context and context[key] is not None:
+            context[key] = frozenset(context[key].items())
+
+    # The socket_options key may be a list and needs to be transformed into a
+    # tuple.
+    socket_opts = context.get("socket_options")
+    if socket_opts is not None:
+        context["socket_options"] = tuple(socket_opts)
+
+    # Map the kwargs to the names in the namedtuple - this is necessary since
+    # namedtuples can't have fields starting with '_'.
+    for key in list(context.keys()):
+        context["key_" + key] = context.pop(key)
+
+    # Default to ``None`` for keys missing from the context
+    for field in key_class._fields:
+        if field not in context:
+            context[field] = None
+
+    return key_class(**context)
+
+
+#: A dictionary that maps a scheme to a callable that creates a pool key.
+#: This can be used to alter the way pool keys are constructed, if desired.
+#: Each PoolManager makes a copy of this dictionary so they can be configured
+#: globally here, or individually on the instance.
+key_fn_by_scheme = {
+    "http": functools.partial(_default_key_normalizer, PoolKey),
+    "https": functools.partial(_default_key_normalizer, PoolKey),
+}
+
+pool_classes_by_scheme = {"http": HTTPConnectionPool, "https": HTTPSConnectionPool}
+
+
+class PoolManager(RequestMethods):
+    """
+    Allows for arbitrary requests while transparently keeping track of
+    necessary connection pools for you.
+
+    :param num_pools:
+        Number of connection pools to cache before discarding the least
+        recently used pool.
+
+    :param headers:
+        Headers to include with all requests, unless other headers are given
+        explicitly.
+
+    :param \\**connection_pool_kw:
+        Additional parameters are used to create fresh
+        :class:`urllib3.connectionpool.ConnectionPool` instances.
+
+    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
+
+    """
+
+    proxy = None
+    proxy_config = None
+
+    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(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):
+        return self
+
+    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, host, port, request_context=None):
+        """
+        Create a new :class:`urllib3.connectionpool.ConnectionPool` based on host, port, scheme, and
+        any additional pool keyword arguments.
+
+        If ``request_context`` is provided, it is provided as keyword arguments
+        to the pool class used. This method is used to actually create the
+        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]
+        if request_context is None:
+            request_context = self.connection_pool_kw.copy()
+
+        # 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
+        # be removed.
+        for key in ("scheme", "host", "port"):
+            request_context.pop(key, None)
+
+        if scheme == "http":
+            for kw in SSL_KEYWORDS:
+                request_context.pop(kw, None)
+
+        return pool_cls(host, port, **request_context)
+
+    def clear(self):
+        """
+        Empty our store of pools and direct them all to close.
+
+        This will not affect in-flight connections, but they will not be
+        re-used after completion.
+        """
+        self.pools.clear()
+
+    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.
+
+        If ``port`` isn't given, it will be derived from the ``scheme`` using
+        ``urllib3.connectionpool.port_by_scheme``. If ``pool_kwargs`` is
+        provided, it is merged with the instance's ``connection_pool_kw``
+        variable and used to create the new connection pool, if one is
+        needed.
+        """
+
+        if not host:
+            raise LocationValueError("No host specified.")
+
+        request_context = self._merge_pool_kwargs(pool_kwargs)
+        request_context["scheme"] = scheme or "http"
+        if not port:
+            port = port_by_scheme.get(request_context["scheme"].lower(), 80)
+        request_context["port"] = port
+        request_context["host"] = host
+
+        return self.connection_from_context(request_context)
+
+    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.
+        """
+        scheme = request_context["scheme"].lower()
+        pool_key_constructor = self.key_fn_by_scheme.get(scheme)
+        if not pool_key_constructor:
+            raise URLSchemeUnknown(scheme)
+        pool_key = pool_key_constructor(request_context)
+
+        return self.connection_from_pool_key(pool_key, request_context=request_context)
+
+    def connection_from_pool_key(self, pool_key, request_context=None):
+        """
+        Get a :class:`urllib3.connectionpool.ConnectionPool` based on the provided pool key.
+
+        ``pool_key`` should be a namedtuple that only contains immutable
+        objects. At a minimum it must have the ``scheme``, ``host``, and
+        ``port`` fields.
+        """
+        with self.pools.lock:
+            # If the scheme, host, or port doesn't match existing open
+            # connections, open a new ConnectionPool.
+            pool = self.pools.get(pool_key)
+            if pool:
+                return pool
+
+            # Make a fresh ConnectionPool of the desired type
+            scheme = request_context["scheme"]
+            host = request_context["host"]
+            port = request_context["port"]
+            pool = self._new_pool(scheme, host, port, request_context=request_context)
+            self.pools[pool_key] = pool
+
+        return pool
+
+    def connection_from_url(self, url, pool_kwargs=None):
+        """
+        Similar to :func:`urllib3.connectionpool.connection_from_url`.
+
+        If ``pool_kwargs`` is not provided and a new pool needs to be
+        constructed, ``self.connection_pool_kw`` is used to initialize
+        the :class:`urllib3.connectionpool.ConnectionPool`. If ``pool_kwargs``
+        is provided, it is used instead. Note that if a new pool does not
+        need to be created for the request, the provided ``pool_kwargs`` are
+        not used.
+        """
+        u = parse_url(url)
+        return self.connection_from_host(
+            u.host, port=u.port, scheme=u.scheme, pool_kwargs=pool_kwargs
+        )
+
+    def _merge_pool_kwargs(self, override):
+        """
+        Merge a dictionary of override values for self.connection_pool_kw.
+
+        This does not modify self.connection_pool_kw and returns a new dict.
+        Any keys in the override dictionary with a value of ``None`` are
+        removed from the merged dictionary.
+        """
+        base_pool_kwargs = self.connection_pool_kw.copy()
+        if override:
+            for key, value in override.items():
+                if value is None:
+                    try:
+                        del base_pool_kwargs[key]
+                    except KeyError:
+                        pass
+                else:
+                    base_pool_kwargs[key] = value
+        return base_pool_kwargs
+
+    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
+        tunnel.
+        """
+        if self.proxy is None:
+            return False
+
+        return not connection_requires_http_tunnel(
+            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):
+        """
+        Same as :meth:`urllib3.HTTPConnectionPool.urlopen`
+        with custom cross-host redirect logic and only sends the request-uri
+        portion of the ``url``.
+
+        The given ``url`` parameter must be absolute, such that an appropriate
+        :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it.
+        """
+        u = parse_url(url)
+        self._validate_proxy_scheme_url_selection(u.scheme)
+
+        conn = self.connection_from_host(u.host, port=u.port, scheme=u.scheme)
+
+        kw["assert_same_host"] = False
+        kw["redirect"] = False
+
+        if "headers" not in kw:
+            kw["headers"] = self.headers.copy()
+
+        if self._proxy_requires_url_absolute_form(u):
+            response = conn.urlopen(method, url, **kw)
+        else:
+            response = conn.urlopen(method, u.request_uri, **kw)
+
+        redirect_location = redirect and response.get_redirect_location()
+        if not redirect_location:
+            return response
+
+        # Support relative URLs for redirecting.
+        redirect_location = urljoin(url, redirect_location)
+
+        if response.status == 303:
+            # Change the method according to RFC 9110, Section 15.4.4.
+            method = "GET"
+            # And lose the body not to transfer anything sensitive.
+            kw["body"] = None
+            kw["headers"] = HTTPHeaderDict(kw["headers"])._prepare_for_method_change()
+
+        retries = kw.get("retries")
+        if not isinstance(retries, Retry):
+            retries = Retry.from_int(retries, redirect=redirect)
+
+        # Strip headers marked as unsafe to forward to the redirected location.
+        # Check remove_headers_on_redirect to avoid a potential network call within
+        # conn.is_same_host() which may use socket.gethostbyname() in the future.
+        if retries.remove_headers_on_redirect and not conn.is_same_host(
+            redirect_location
+        ):
+            headers = list(six.iterkeys(kw["headers"]))
+            for header in headers:
+                if header.lower() in retries.remove_headers_on_redirect:
+                    kw["headers"].pop(header, None)
+
+        try:
+            retries = retries.increment(method, url, response=response, _pool=conn)
+        except MaxRetryError:
+            if retries.raise_on_redirect:
+                response.drain_conn()
+                raise
+            return response
+
+        kw["retries"] = retries
+        kw["redirect"] = redirect
+
+        log.info("Redirecting %s -> %s", url, redirect_location)
+
+        response.drain_conn()
+        return self.urlopen(method, redirect_location, **kw)
+
+
+class ProxyManager(PoolManager):
+    """
+    Behaves just like :class:`PoolManager`, but sends all requests through
+    the defined proxy, using the CONNECT method for HTTPS URLs.
+
+    :param proxy_url:
+        The URL of the proxy to be used.
+
+    :param proxy_headers:
+        A dictionary containing headers that will be sent to the proxy. In case
+        of HTTP they are being sent with each request, while in the
+        HTTPS/CONNECT case they are sent only once. Could be used for proxy
+        authentication.
+
+    :param proxy_ssl_context:
+        The proxy SSL context is used to establish the TLS connection to the
+        proxy when using HTTPS proxies.
+
+    :param use_forwarding_for_https:
+        (Defaults to False) If set to True will forward requests to the HTTPS
+        proxy to be made on behalf of the client instead of creating a TLS
+        tunnel via the CONNECT method. **Enabling this flag means that request
+        and response headers and content will be visible from the HTTPS proxy**
+        whereas tunneling keeps request and response headers and content
+        private.  IP address, target hostname, SNI, and port are always visible
+        to an HTTPS proxy even when this flag is disabled.
+
+    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
+
+    """
+
+    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
+    ):
+
+        if isinstance(proxy_url, HTTPConnectionPool):
+            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)
+
+        if not proxy.port:
+            port = port_by_scheme.get(proxy.scheme, 80)
+            proxy = proxy._replace(port=port)
+
+        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)
+
+        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)
+
+    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
+        if scheme == "https":
+            return super(ProxyManager, self).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
+        )
+
+    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.
+        """
+        headers_ = {"Accept": "*/*"}
+
+        netloc = parse_url(url).netloc
+        if netloc:
+            headers_["Host"] = netloc
+
+        if headers:
+            headers_.update(headers)
+        return headers_
+
+    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):
+            # For connections using HTTP CONNECT, httplib sets the necessary
+            # headers on the CONNECT to the proxy. If we're not using CONNECT,
+            # we'll definitely need to set 'Host' at the very least.
+            headers = kw.get("headers", self.headers)
+            kw["headers"] = self._set_proxy_headers(url, headers)
+
+        return super(ProxyManager, self).urlopen(method, url, redirect=redirect, **kw)
+
+
+def proxy_from_url(url, **kw):
+    return ProxyManager(proxy_url=url, **kw)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/request.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/request.py
new file mode 100644
index 0000000..3b4cf99
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/request.py
@@ -0,0 +1,191 @@
+from __future__ import absolute_import
+
+import sys
+
+from .filepost import encode_multipart_formdata
+from .packages import six
+from .packages.six.moves.urllib.parse import urlencode
+
+__all__ = ["RequestMethods"]
+
+
+class RequestMethods(object):
+    """
+    Convenience mixin for classes who implement a :meth:`urlopen` method, such
+    as :class:`urllib3.HTTPConnectionPool` and
+    :class:`urllib3.PoolManager`.
+
+    Provides behavior for making common types of HTTP request methods and
+    decides which type of request field encoding to use.
+
+    Specifically,
+
+    :meth:`.request_encode_url` is for sending requests whose fields are
+    encoded in the URL (such as GET, HEAD, DELETE).
+
+    :meth:`.request_encode_body` is for sending requests whose fields are
+    encoded in the *body* of the request using multipart or www-form-urlencoded
+    (such as for POST, PUT, PATCH).
+
+    :meth:`.request` is for making any kind of request, it will look up the
+    appropriate encoding format and use one of the above two methods to make
+    the request.
+
+    Initializer parameters:
+
+    :param headers:
+        Headers to include with all requests, unless other headers are given
+        explicitly.
+    """
+
+    _encode_url_methods = {"DELETE", "GET", "HEAD", "OPTIONS"}
+
+    def __init__(self, headers=None):
+        self.headers = headers or {}
+
+    def urlopen(
+        self,
+        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, url, fields=None, headers=None, **urlopen_kw):
+        """
+        Make a request using :meth:`urlopen` with the appropriate encoding of
+        ``fields`` based on the ``method`` used.
+
+        This is a convenience method that requires the least amount of manual
+        effort. It can be used in most situations, while still having the
+        option to drop down to more specific methods when necessary, such as
+        :meth:`request_encode_url`, :meth:`request_encode_body`,
+        or even the lowest level :meth:`urlopen`.
+        """
+        method = method.upper()
+
+        urlopen_kw["request_url"] = url
+
+        if method in self._encode_url_methods:
+            return self.request_encode_url(
+                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, 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.
+        """
+        if headers is None:
+            headers = self.headers
+
+        extra_kw = {"headers": headers}
+        extra_kw.update(urlopen_kw)
+
+        if fields:
+            url += "?" + urlencode(fields)
+
+        return self.urlopen(method, url, **extra_kw)
+
+    def request_encode_body(
+        self,
+        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.
+
+        When ``encode_multipart=True`` (default), then
+        :func:`urllib3.encode_multipart_formdata` is used to encode
+        the payload with the appropriate content type. Otherwise
+        :func:`urllib.parse.urlencode` is used with the
+        'application/x-www-form-urlencoded' content type.
+
+        Multipart encoding must be used when posting files, and it's reasonably
+        safe to use it in other times too. However, it may break request
+        signing, such as with OAuth.
+
+        Supports an optional ``fields`` parameter of key/value strings AND
+        key/filetuple. A filetuple is a (filename, data, MIME type) tuple where
+        the MIME type is optional. For example::
+
+            fields = {
+                'foo': 'bar',
+                'fakefile': ('foofile.txt', 'contents of foofile'),
+                'realfile': ('barfile.txt', open('realfile').read()),
+                'typedfile': ('bazfile.bin', open('bazfile').read(),
+                              'image/jpeg'),
+                'nonamefile': 'contents of nonamefile field',
+            }
+
+        When uploading a file, providing a filename (the first parameter of the
+        tuple) is optional but recommended to best mimic behavior of browsers.
+
+        Note that if ``headers`` are supplied, the 'Content-Type' header will
+        be overwritten because it depends on the dynamic random boundary string
+        which is used to compose the body of the request. The random boundary
+        string can be explicitly set with the ``multipart_boundary`` parameter.
+        """
+        if headers is None:
+            headers = self.headers
+
+        extra_kw = {"headers": {}}
+
+        if fields:
+            if "body" in urlopen_kw:
+                raise TypeError(
+                    "request got values for both 'fields' and 'body', can only specify one."
+                )
+
+            if encode_multipart:
+                body, content_type = encode_multipart_formdata(
+                    fields, boundary=multipart_boundary
+                )
+            else:
+                body, content_type = (
+                    urlencode(fields),
+                    "application/x-www-form-urlencoded",
+                )
+
+            extra_kw["body"] = body
+            extra_kw["headers"] = {"Content-Type": content_type}
+
+        extra_kw["headers"].update(headers)
+        extra_kw.update(urlopen_kw)
+
+        return self.urlopen(method, url, **extra_kw)
+
+
+if not six.PY2:
+
+    class RequestModule(sys.modules[__name__].__class__):
+        def __call__(self, *args, **kwargs):
+            """
+            If user tries to call this module directly urllib3 v2.x style raise an error to the user
+            suggesting they may need urllib3 v2
+            """
+            raise TypeError(
+                "'module' object is not callable\n"
+                "urllib3.request() method is not supported in this release, "
+                "upgrade to urllib3 v2 to use it\n"
+                "see https://urllib3.readthedocs.io/en/stable/v2-migration-guide.html"
+            )
+
+    sys.modules[__name__].__class__ = RequestModule
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/response.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/response.py
new file mode 100644
index 0000000..8909f84
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/response.py
@@ -0,0 +1,879 @@
+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
+from socket import timeout as SocketTimeout
+
+brotli = None
+
+from . import util
+from ._collections import HTTPHeaderDict
+from .connection import BaseSSLError, HTTPException
+from .exceptions import (
+    BodyNotHttplibCompatible,
+    DecodeError,
+    HTTPError,
+    IncompleteRead,
+    InvalidChunkLength,
+    InvalidHeader,
+    ProtocolError,
+    ReadTimeoutError,
+    ResponseNotChunked,
+    SSLError,
+)
+from .packages import six
+from .util.response import is_fp_closed, is_response_to_head
+
+log = logging.getLogger(__name__)
+
+
+class DeflateDecoder(object):
+    def __init__(self):
+        self._first_try = True
+        self._data = b""
+        self._obj = zlib.decompressobj()
+
+    def __getattr__(self, name):
+        return getattr(self._obj, name)
+
+    def decompress(self, data):
+        if not data:
+            return data
+
+        if not self._first_try:
+            return self._obj.decompress(data)
+
+        self._data += data
+        try:
+            decompressed = self._obj.decompress(data)
+            if decompressed:
+                self._first_try = False
+                self._data = None
+            return decompressed
+        except zlib.error:
+            self._first_try = False
+            self._obj = zlib.decompressobj(-zlib.MAX_WBITS)
+            try:
+                return self.decompress(self._data)
+            finally:
+                self._data = None
+
+
+class GzipDecoderState(object):
+
+    FIRST_MEMBER = 0
+    OTHER_MEMBERS = 1
+    SWALLOW_DATA = 2
+
+
+class GzipDecoder(object):
+    def __init__(self):
+        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):
+        ret = bytearray()
+        if self._state == GzipDecoderState.SWALLOW_DATA or not data:
+            return bytes(ret)
+        while True:
+            try:
+                ret += self._obj.decompress(data)
+            except zlib.error:
+                previous_state = self._state
+                # Ignore data after the first error
+                self._state = GzipDecoderState.SWALLOW_DATA
+                if previous_state == GzipDecoderState.OTHER_MEMBERS:
+                    # Allow trailing garbage acceptable in other gzip clients
+                    return bytes(ret)
+                raise
+            data = self._obj.unused_data
+            if not data:
+                return bytes(ret)
+            self._state = GzipDecoderState.OTHER_MEMBERS
+            self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
+
+
+if brotli is not None:
+
+    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):
+            self._obj = brotli.Decompressor()
+            if hasattr(self._obj, "decompress"):
+                self.decompress = self._obj.decompress
+            else:
+                self.decompress = self._obj.process
+
+        def flush(self):
+            if hasattr(self._obj, "flush"):
+                return self._obj.flush()
+            return b""
+
+
+class MultiDecoder(object):
+    """
+    From RFC7231:
+        If one or more encodings have been applied to a representation, the
+        sender that applied the encodings MUST generate a Content-Encoding
+        header field that lists the content codings in the order in which
+        they were applied.
+    """
+
+    def __init__(self, modes):
+        self._decoders = [_get_decoder(m.strip()) for m in modes.split(",")]
+
+    def flush(self):
+        return self._decoders[0].flush()
+
+    def decompress(self, data):
+        for d in reversed(self._decoders):
+            data = d.decompress(data)
+        return data
+
+
+def _get_decoder(mode):
+    if "," in mode:
+        return MultiDecoder(mode)
+
+    if mode == "gzip":
+        return GzipDecoder()
+
+    if brotli is not None and mode == "br":
+        return BrotliDecoder()
+
+    return DeflateDecoder()
+
+
+class HTTPResponse(io.IOBase):
+    """
+    HTTP Response container.
+
+    Backwards-compatible with :class:`http.client.HTTPResponse` but the response ``body`` is
+    loaded and decoded on-demand when the ``data`` property is accessed.  This
+    class is also compatible with the Python standard library's :mod:`io`
+    module, and can hence be treated as a readable object in the context of that
+    framework.
+
+    Extra parameters for behaviour not present in :class:`http.client.HTTPResponse`:
+
+    :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 original_response:
+        When this HTTPResponse wrapper is generated from an :class:`http.client.HTTPResponse`
+        object, it's convenient to include the original for debug purposes. It's
+        otherwise unused.
+
+    :param retries:
+        The retries contains the last :class:`~urllib3.util.retry.Retry` that
+        was used during the request.
+
+    :param enforce_content_length:
+        Enforce content length checking. Body returned by server must match
+        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,
+    ):
+
+        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._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)):
+            self._body = body
+
+        self._pool = pool
+        self._connection = connection
+
+        if hasattr(body, "read"):
+            self._fp = body
+
+        # 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
+
+        # Determine length of response
+        self.length_remaining = self._init_length(request_method)
+
+        # 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):
+        if not self._pool or not self._connection:
+            return
+
+        self._pool._put_conn(self._connection)
+        self._connection = None
+
+    def drain_conn(self):
+        """
+        Read and discard any remaining HTTP response data in the response connection.
+
+        Unread data in the HTTPResponse connection blocks the connection from being released back to the pool.
+        """
+        try:
+            self.read()
+        except (HTTPError, SocketError, BaseSSLError, HTTPException):
+            pass
+
+    @property
+    def data(self):
+        # For backwards-compat with earlier urllib3 0.4 and earlier.
+        if self._body:
+            return self._body
+
+        if self._fp:
+            return self.read(cache_content=True)
+
+    @property
+    def connection(self):
+        return self._connection
+
+    def isclosed(self):
+        return is_fp_closed(self._fp)
+
+    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``
+        if bytes are encoded on the wire (e.g, compressed).
+        """
+        return self._fp_bytes_read
+
+    def _init_length(self, request_method):
+        """
+        Set initial length value for Response content if available.
+        """
+        length = self.headers.get("content-length")
+
+        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
+                # the response before raising an exception.
+                log.warning(
+                    "Received response with both Content-Length and "
+                    "Transfer-Encoding set. This is expressly forbidden "
+                    "by RFC 7230 sec 3.3.2. Ignoring Content-Length and "
+                    "attempting to process response as Transfer-Encoding: "
+                    "chunked."
+                )
+                return None
+
+            try:
+                # RFC 7230 section 3.3.2 specifies multiple content lengths can
+                # be sent in a single Content-Length header
+                # (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(",")])
+                if len(lengths) > 1:
+                    raise InvalidHeader(
+                        "Content-Length contained multiple "
+                        "unmatching values (%s)" % length
+                    )
+                length = lengths.pop()
+            except ValueError:
+                length = None
+            else:
+                if length < 0:
+                    length = None
+
+        # Convert status to int for comparison
+        # In some cases, httplib returns a status of "_UNKNOWN"
+        try:
+            status = int(self.status)
+        except ValueError:
+            status = 0
+
+        # Check for responses that shouldn't include a body
+        if status in (204, 304) or 100 <= status < 200 or request_method == "HEAD":
+            length = 0
+
+        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):
+        """
+        Catch low-level python exceptions, instead re-raising urllib3
+        variants, so that low-level exceptions are not leaked in the
+        high-level api.
+
+        On exit, release the connection back to the pool.
+        """
+        clean_exit = False
+
+        try:
+            try:
+                yield
+
+            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.")
+
+            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 ReadTimeoutError(self._pool, None, "Read timed out.")
+
+            except (HTTPException, SocketError) as e:
+                # This includes IncompleteRead.
+                raise ProtocolError("Connection broken: %r" % e, e)
+
+            # If no exception is thrown, we should avoid cleaning up
+            # unnecessarily.
+            clean_exit = True
+        finally:
+            # If we didn't terminate cleanly, we need to throw away our
+            # connection.
+            if not clean_exit:
+                # The response may not be closed but we're not going to use it
+                # anymore so close it now to ensure that the connection is
+                # released back to the pool.
+                if self._original_response:
+                    self._original_response.close()
+
+                # Closing the response may not actually be sufficient to close
+                # everything, so if we have a hold of the connection close that
+                # too.
+                if self._connection:
+                    self._connection.close()
+
+            # If we hold the original response but it's closed now, we should
+            # return the connection back to the pool.
+            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
+        parameters: ``decode_content`` and ``cache_content``.
+
+        :param amt:
+            How much of the content to read. If specified, caching is skipped
+            because it doesn't make sense to cache partial content as the full
+            response.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+
+        :param cache_content:
+            If True, will save the returned data such that the same result is
+            returned despite of the state of the underlying file object. This
+            is useful if you want the ``.data`` property to continue working
+            after having ``.read()`` the file object. (Overridden if ``amt`` is
+            set.)
+        """
+        self._init_decoder()
+        if decode_content is None:
+            decode_content = self.decode_content
+
+        if self._fp is None:
+            return
+
+        flush_decoder = False
+        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:
+                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)
+
+            data = self._decode(data, decode_content, flush_decoder)
+
+            if cache_content:
+                self._body = data
+
+        return data
+
+    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
+        connection is closed.
+
+        :param amt:
+            How much of the content to read. The generator will return up to
+            much data per iteration, but may return less. This is particularly
+            likely when using compressed data. However, the empty string will
+            never be returned.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+        """
+        if self.chunked and self.supports_chunked_reads():
+            for line in self.read_chunked(amt, decode_content=decode_content):
+                yield line
+        else:
+            while not is_fp_closed(self._fp):
+                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:
+            self._fp.close()
+
+        if self._connection:
+            self._connection.close()
+
+        if not self.auto_close:
+            io.IOBase.close(self)
+
+    @property
+    def closed(self):
+        if not self.auto_close:
+            return io.IOBase.closed.__get__(self)
+        elif self._fp is None:
+            return True
+        elif hasattr(self._fp, "isclosed"):
+            return self._fp.isclosed()
+        elif hasattr(self._fp, "closed"):
+            return self._fp.closed
+        else:
+            return True
+
+    def fileno(self):
+        if self._fp is None:
+            raise IOError("HTTPResponse has no file to get a fileno from")
+        elif hasattr(self._fp, "fileno"):
+            return self._fp.fileno()
+        else:
+            raise IOError(
+                "The file-like object this HTTPResponse is wrapped "
+                "around has no file descriptor"
+            )
+
+    def flush(self):
+        if (
+            self._fp is not None
+            and hasattr(self._fp, "flush")
+            and not getattr(self._fp, "closed", False)
+        ):
+            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):
+        """
+        Checks if the underlying file-like object looks like a
+        :class:`http.client.HTTPResponse` object. We do this by testing for
+        the fp attribute. If it is present we assume it returns raw chunks as
+        processed by read_chunked().
+        """
+        return hasattr(self._fp, "fp")
+
+    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
+        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)
+
+    def _handle_chunk(self, amt):
+        returned_chunk = None
+        if amt is None:
+            chunk = self._fp._safe_read(self.chunk_left)
+            returned_chunk = chunk
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self.chunk_left = None
+        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)
+            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)
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self.chunk_left = None
+        return returned_chunk
+
+    def read_chunked(self, amt=None, decode_content=None):
+        """
+        Similar to :meth:`HTTPResponse.read`, but with an additional
+        parameter: ``decode_content``.
+
+        :param amt:
+            How much of the content to read. If specified, caching is skipped
+            because it doesn't make sense to cache partial content as the full
+            response.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+        """
+        self._init_decoder()
+        # FIXME: Rewrite this method and make it a class with a better structured logic.
+        if not self.chunked:
+            raise ResponseNotChunked(
+                "Response is not chunked. "
+                "Header 'transfer-encoding: chunked' is missing."
+            )
+        if not self.supports_chunked_reads():
+            raise BodyNotHttplibCompatible(
+                "Body should be http.client.HTTPResponse like. "
+                "It should have have an fp attribute which returns raw chunks."
+            )
+
+        with self._error_catcher():
+            # 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
+
+            # If a response is already read and closed
+            # then return immediately.
+            if self._fp.fp is None:
+                return
+
+            while True:
+                self._update_chunk_length()
+                if self.chunk_left == 0:
+                    break
+                chunk = self._handle_chunk(amt)
+                decoded = self._decode(
+                    chunk, decode_content=decode_content, flush_decoder=False
+                )
+                if decoded:
+                    yield decoded
+
+            if decode_content:
+                # On CPython and PyPy, we should never need to flush the
+                # decoder. However, on Jython we *might* need to, so
+                # lets defensively do it anyway.
+                decoded = self._flush_decoder()
+                if decoded:  # Platform-specific: Jython.
+                    yield decoded
+
+            # Chunk content ends with \r\n: discard it.
+            while True:
+                line = self._fp.fp.readline()
+                if not line:
+                    # Some sites may not end with '\r\n'.
+                    break
+                if line == b"\r\n":
+                    break
+
+            # We read everything; close the "file".
+            if self._original_response:
+                self._original_response.close()
+
+    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.
+        """
+        if self.retries is not None and len(self.retries.history):
+            return self.retries.history[-1].redirect_location
+        else:
+            return self._request_url
+
+    def __iter__(self):
+        buffer = []
+        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]:
+                    yield x + b"\n"
+                if chunk[-1]:
+                    buffer = [chunk[-1]]
+                else:
+                    buffer = []
+            else:
+                buffer.append(chunk)
+        if buffer:
+            yield b"".join(buffer)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__init__.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__init__.py
new file mode 100644
index 0000000..4547fc5
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__init__.py
@@ -0,0 +1,49 @@
+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,
+    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 .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",
+    "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",
+    "SKIP_HEADER",
+    "SKIPPABLE_HEADERS",
+)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/connection.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/connection.py
new file mode 100644
index 0000000..6af1138
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/connection.py
@@ -0,0 +1,149 @@
+from __future__ import absolute_import
+
+import socket
+
+from ..contrib import _appengine_environ
+from ..exceptions import LocationParseError
+from ..packages import six
+from .wait import NoWayToWaitForSocketError, wait_for_read
+
+
+def is_connection_dropped(conn):  # 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.
+    """
+    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
+# library test suite. Added to its signature is only `socket_options`.
+# 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,
+):
+    """Connect to *address* and return the socket object.
+
+    Convenience function.  Connect to *address* (a 2-tuple ``(host,
+    port)``) and return the socket object.  Passing the optional
+    *timeout* parameter will set the timeout on the socket instance
+    before attempting to connect.  If no *timeout* is supplied, the
+    global default timeout setting returned by :func:`socket.getdefaulttimeout`
+    is used.  If *source_address* is set it must be a tuple of (host, port)
+    for the socket to bind as a source address before making the connection.
+    An host of '' or port 0 tells the OS to use the default.
+    """
+
+    host, port = address
+    if host.startswith("["):
+        host = host.strip("[]")
+    err = None
+
+    # Using the value from allowed_gai_family() in the context of getaddrinfo lets
+    # us select whether to work with IPv4 DNS records, IPv6 records, or both.
+    # The original create_connection function always returns all records.
+    family = allowed_gai_family()
+
+    try:
+        host.encode("idna")
+    except UnicodeError:
+        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
+        sock = None
+        try:
+            sock = socket.socket(af, socktype, proto)
+
+            # If provided, set socket level options before connecting.
+            _set_socket_options(sock, socket_options)
+
+            if timeout is not socket._GLOBAL_DEFAULT_TIMEOUT:
+                sock.settimeout(timeout)
+            if source_address:
+                sock.bind(source_address)
+            sock.connect(sa)
+            return sock
+
+        except socket.error as e:
+            err = e
+            if sock is not None:
+                sock.close()
+                sock = None
+
+    if err is not None:
+        raise err
+
+    raise socket.error("getaddrinfo returns an empty list")
+
+
+def _set_socket_options(sock, options):
+    if options is None:
+        return
+
+    for opt in options:
+        sock.setsockopt(*opt)
+
+
+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."""
+
+    family = socket.AF_INET
+    if HAS_IPV6:
+        family = socket.AF_UNSPEC
+    return family
+
+
+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
+        # determine that we must bind to an IPv6 address.
+        # https://github.com/urllib3/urllib3/pull/611
+        # https://bugs.python.org/issue658327
+        try:
+            sock = socket.socket(socket.AF_INET6)
+            sock.bind((host, 0))
+            has_ipv6 = True
+        except Exception:
+            pass
+
+    if sock:
+        sock.close()
+    return has_ipv6
+
+
+HAS_IPV6 = _has_ipv6("::1")
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/proxy.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/proxy.py
new file mode 100644
index 0000000..2199cc7
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/proxy.py
@@ -0,0 +1,57 @@
+from .ssl_ import create_urllib3_context, resolve_cert_reqs, resolve_ssl_version
+
+
+def connection_requires_http_tunnel(
+    proxy_url=None, proxy_config=None, destination_scheme=None
+):
+    """
+    Returns True if the connection requires an HTTP CONNECT through the proxy.
+
+    :param URL proxy_url:
+        URL of the proxy.
+    :param ProxyConfig proxy_config:
+        Proxy configuration from poolmanager.py
+    :param str destination_scheme:
+        The scheme of the destination. (i.e https, http, etc)
+    """
+    # If we're not using a proxy, no way to use a tunnel.
+    if proxy_url is None:
+        return False
+
+    # HTTP destinations never require tunneling, we always forward.
+    if destination_scheme == "http":
+        return False
+
+    # Support for forwarding with HTTPS proxies and HTTPS destinations.
+    if (
+        proxy_url.scheme == "https"
+        and proxy_config
+        and proxy_config.use_forwarding_for_https
+    ):
+        return False
+
+    # 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/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/queue.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/queue.py
new file mode 100644
index 0000000..4178410
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/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/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/request.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/request.py
new file mode 100644
index 0000000..330766e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/request.py
@@ -0,0 +1,137 @@
+from __future__ import absolute_import
+
+from base64 import b64encode
+
+from ..exceptions import UnrewindableBodyError
+from ..packages.six import b, integer_types
+
+# Pass as a value within ``headers`` to skip
+# emitting some HTTP headers that are added automatically.
+# The only headers that are supported are ``Accept-Encoding``,
+# ``Host``, and ``User-Agent``.
+SKIP_HEADER = "@@@SKIP_HEADER@@@"
+SKIPPABLE_HEADERS = frozenset(["accept-encoding", "host", "user-agent"])
+
+ACCEPT_ENCODING = "gzip,deflate"
+
+_FAILEDTELL = object()
+
+
+def make_headers(
+    keep_alive=None,
+    accept_encoding=None,
+    user_agent=None,
+    basic_auth=None,
+    proxy_basic_auth=None,
+    disable_cache=None,
+):
+    """
+    Shortcuts for generating request headers.
+
+    :param keep_alive:
+        If ``True``, adds 'connection: keep-alive' header.
+
+    :param accept_encoding:
+        Can be a boolean, list, or string.
+        ``True`` translates to 'gzip,deflate'.
+        List will get joined by comma.
+        String will be used as provided.
+
+    :param user_agent:
+        String representing the user-agent you want, such as
+        "python-urllib3/0.6"
+
+    :param basic_auth:
+        Colon-separated username:password string for 'authorization: basic ...'
+        auth header.
+
+    :param proxy_basic_auth:
+        Colon-separated username:password string for 'proxy-authorization: basic ...'
+        auth header.
+
+    :param disable_cache:
+        If ``True``, adds 'cache-control: no-cache' header.
+
+    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'}
+    """
+    headers = {}
+    if accept_encoding:
+        if isinstance(accept_encoding, str):
+            pass
+        elif isinstance(accept_encoding, list):
+            accept_encoding = ",".join(accept_encoding)
+        else:
+            accept_encoding = ACCEPT_ENCODING
+        headers["accept-encoding"] = accept_encoding
+
+    if user_agent:
+        headers["user-agent"] = user_agent
+
+    if keep_alive:
+        headers["connection"] = "keep-alive"
+
+    if basic_auth:
+        headers["authorization"] = "Basic " + b64encode(b(basic_auth)).decode("utf-8")
+
+    if proxy_basic_auth:
+        headers["proxy-authorization"] = "Basic " + b64encode(
+            b(proxy_basic_auth)
+        ).decode("utf-8")
+
+    if disable_cache:
+        headers["cache-control"] = "no-cache"
+
+    return headers
+
+
+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.
+    """
+    if pos is not None:
+        rewind_body(body, pos)
+    elif getattr(body, "tell", None) is not None:
+        try:
+            pos = body.tell()
+        except (IOError, OSError):
+            # This differentiates from None, allowing us to catch
+            # a failed `tell()` later when trying to rewind the body.
+            pos = _FAILEDTELL
+
+    return pos
+
+
+def rewind_body(body, body_pos):
+    """
+    Attempt to rewind body to a certain position.
+    Primarily used for request redirects and retries.
+
+    :param body:
+        File-like object that supports seek.
+
+    :param int 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):
+        try:
+            body_seek(body_pos)
+        except (IOError, OSError):
+            raise UnrewindableBodyError(
+                "An error occurred when rewinding request body for redirect/retry."
+            )
+    elif body_pos is _FAILEDTELL:
+        raise UnrewindableBodyError(
+            "Unable to record file position for rewinding "
+            "request body during a redirect/retry."
+        )
+    else:
+        raise ValueError(
+            "body_pos must be of type integer, instead it was %s." % type(body_pos)
+        )
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/response.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/response.py
new file mode 100644
index 0000000..5ea609c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/response.py
@@ -0,0 +1,107 @@
+from __future__ import absolute_import
+
+from email.errors import MultipartInvariantViolationDefect, StartBoundaryNotFoundDefect
+
+from ..exceptions import HeaderParsingError
+from ..packages.six.moves import http_client as httplib
+
+
+def is_fp_closed(obj):
+    """
+    Checks whether a given file-like object is closed.
+
+    :param obj:
+        The file-like object to check.
+    """
+
+    try:
+        # Check `isclosed()` first, in case Python3 doesn't set `closed`.
+        # GH Issue #928
+        return obj.isclosed()
+    except AttributeError:
+        pass
+
+    try:
+        # Check via the official file-like-object way.
+        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
+    except AttributeError:
+        pass
+
+    raise ValueError("Unable to determine whether fp is closed.")
+
+
+def assert_header_parsing(headers):
+    """
+    Asserts whether all headers have been successfully parsed.
+    Extracts encountered errors from the result of parsing headers.
+
+    Only works on Python 3.
+
+    :param http.client.HTTPMessage headers: Headers to verify.
+
+    :raises urllib3.exceptions.HeaderParsingError:
+        If parsing errors are found.
+    """
+
+    # 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)
+
+    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
+
+        # 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):
+    """
+    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"
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/retry.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/retry.py
new file mode 100644
index 0000000..9a1e90d
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/retry.py
@@ -0,0 +1,622 @@
+from __future__ import absolute_import
+
+import email
+import logging
+import re
+import time
+import warnings
+from collections import namedtuple
+from itertools import takewhile
+
+from ..exceptions import (
+    ConnectTimeoutError,
+    InvalidHeader,
+    MaxRetryError,
+    ProtocolError,
+    ProxyError,
+    ReadTimeoutError,
+    ResponseError,
+)
+from ..packages import six
+
+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"]
+)
+
+
+# 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::
+
+        retries = Retry(connect=5, read=2, redirect=5)
+        http = PoolManager(retries=retries)
+        response = http.request('GET', 'http://example.com/')
+
+    Or per-request (which overrides the default for the pool)::
+
+        response = http.request('GET', 'http://example.com/', retries=Retry(10))
+
+    Retries can be disabled by passing ``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.
+
+    :param int total:
+        Total number of retries to allow. Takes precedence over other counts.
+
+        Set to ``None`` to remove this constraint and fall back on other
+        counts.
+
+        Set to ``0`` to fail on the first retry.
+
+        Set to ``False`` to disable and imply ``raise_on_redirect=False``.
+
+    :param int connect:
+        How many connection-related errors to retry on.
+
+        These are errors raised before the request is sent to the remote server,
+        which we assume has not triggered the server to process the request.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+    :param int read:
+        How many times to retry on read errors.
+
+        These errors are raised after the request was sent to the server, so the
+        request may have side-effects.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+    :param int redirect:
+        How many redirects to perform. Limit this to avoid infinite redirect
+        loops.
+
+        A redirect is a HTTP response with a status code 301, 302, 303, 307 or
+        308.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+        Set to ``False`` to disable and imply ``raise_on_redirect=False``.
+
+    :param int status:
+        How many times to retry on bad status codes.
+
+        These are retries made on responses, where status code matches
+        ``status_forcelist``.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+    :param int other:
+        How many times to retry on other errors.
+
+        Other errors are errors that are not connect, read, redirect or status errors.
+        These errors might be raised after the request was sent to the server, so the
+        request might have side-effects.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+        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:
+        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.
+
+        .. 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``.
+
+        By default, this is disabled with ``None``.
+
+    :param float backoff_factor:
+        A backoff factor to apply between attempts after the second try
+        (most errors are resolved immediately by a second try without a
+        delay). urllib3 will sleep for::
+
+            {backoff factor} * (2 ** ({number of total retries} - 1))
+
+        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`.
+
+        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
+        response code in the 3xx range.
+
+    :param bool raise_on_status: Similar meaning to ``raise_on_redirect``:
+        whether we should raise an exception, or return a response,
+        if status falls in ``status_forcelist`` range and retries have
+        been exhausted.
+
+    :param tuple history: The history of the request encountered during
+        each call to :meth:`~Retry.increment`. The list is in the order
+        the requests occurred. Each list item is of class :class:`RequestHistory`.
+
+    :param bool respect_retry_after_header:
+        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:
+        Sequence of headers to remove from the request when a response
+        indicating a redirect is returned before firing off the redirected
+        request.
+    """
+
+    #: Default methods to be used for ``allowed_methods``
+    DEFAULT_ALLOWED_METHODS = frozenset(
+        ["HEAD", "GET", "PUT", "DELETE", "OPTIONS", "TRACE"]
+    )
+
+    #: Default status codes to be used for ``status_forcelist``
+    RETRY_AFTER_STATUS_CODES = frozenset([413, 429, 503])
+
+    #: Default headers to be used for ``remove_headers_on_redirect``
+    DEFAULT_REMOVE_HEADERS_ON_REDIRECT = frozenset(
+        ["Cookie", "Authorization", "Proxy-Authorization"]
+    )
+
+    #: Maximum backoff time.
+    DEFAULT_BACKOFF_MAX = 120
+
+    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
+
+        self.total = total
+        self.connect = connect
+        self.read = read
+        self.status = status
+        self.other = other
+
+        if redirect is False or total is False:
+            redirect = 0
+            raise_on_redirect = False
+
+        self.redirect = redirect
+        self.status_forcelist = status_forcelist or set()
+        self.allowed_methods = allowed_methods
+        self.backoff_factor = backoff_factor
+        self.raise_on_redirect = raise_on_redirect
+        self.raise_on_status = raise_on_status
+        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]
+        )
+
+    def new(self, **kw):
+        params = dict(
+            total=self.total,
+            connect=self.connect,
+            read=self.read,
+            redirect=self.redirect,
+            status=self.status,
+            other=self.other,
+            status_forcelist=self.status_forcelist,
+            backoff_factor=self.backoff_factor,
+            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,
+        )
+
+        # 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)
+
+    @classmethod
+    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
+
+        if isinstance(retries, Retry):
+            return retries
+
+        redirect = bool(redirect) and None
+        new_retries = cls(retries, redirect=redirect)
+        log.debug("Converted retries value: %r -> %r", retries, new_retries)
+        return new_retries
+
+    def get_backoff_time(self):
+        """Formula for computing the current backoff
+
+        :rtype: float
+        """
+        # We want to consider only the last consecutive errors sequence (Ignore redirects).
+        consecutive_errors_len = len(
+            list(
+                takewhile(lambda x: x.redirect_location is None, reversed(self.history))
+            )
+        )
+        if consecutive_errors_len <= 1:
+            return 0
+
+        backoff_value = self.backoff_factor * (2 ** (consecutive_errors_len - 1))
+        return min(self.DEFAULT_BACKOFF_MAX, backoff_value)
+
+    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("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()
+
+        if seconds < 0:
+            seconds = 0
+
+        return seconds
+
+    def get_retry_after(self, response):
+        """Get the value of Retry-After in seconds."""
+
+        retry_after = response.headers.get("Retry-After")
+
+        if retry_after is None:
+            return None
+
+        return self.parse_retry_after(retry_after)
+
+    def sleep_for_retry(self, response=None):
+        retry_after = self.get_retry_after(response)
+        if retry_after:
+            time.sleep(retry_after)
+            return True
+
+        return False
+
+    def _sleep_backoff(self):
+        backoff = self.get_backoff_time()
+        if backoff <= 0:
+            return
+        time.sleep(backoff)
+
+    def sleep(self, response=None):
+        """Sleep between retry attempts.
+
+        This method will respect a server's ``Retry-After`` response header
+        and sleep the duration of the time requested. If that is not present, it
+        will use an exponential backoff. By default, the backoff factor is 0 and
+        this method will return immediately.
+        """
+
+        if self.respect_retry_after_header and response:
+            slept = self.sleep_for_retry(response)
+            if slept:
+                return
+
+        self._sleep_backoff()
+
+    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.
+        """
+        if isinstance(err, ProxyError):
+            err = err.original_error
+        return isinstance(err, ConnectTimeoutError)
+
+    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):
+        """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:
+            return False
+        return True
+
+    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
+        whether the returned status code is on the list of status codes to
+        be retried upon on the presence of the aforementioned header)
+        """
+        if not self._is_method_retryable(method):
+            return False
+
+        if self.status_forcelist and status_code in self.status_forcelist:
+            return True
+
+        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):
+        """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))
+        if not retry_counts:
+            return False
+
+        return min(retry_counts) < 0
+
+    def increment(
+        self,
+        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.HTTPResponse`
+        :param Exception error: An error encountered during the request, or
+            None if the response was received successfully.
+
+        :return: A new ``Retry`` object.
+        """
+        if self.total is False and error:
+            # Disabled, indicate to re-raise the error.
+            raise six.reraise(type(error), error, _stacktrace)
+
+        total = self.total
+        if total is not None:
+            total -= 1
+
+        connect = self.connect
+        read = self.read
+        redirect = self.redirect
+        status_count = self.status
+        other = self.other
+        cause = "unknown"
+        status = None
+        redirect_location = None
+
+        if error and self._is_connection_error(error):
+            # Connect retry?
+            if connect is False:
+                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 not self._is_method_retryable(method):
+                raise six.reraise(type(error), error, _stacktrace)
+            elif read is not None:
+                read -= 1
+
+        elif error:
+            # Other retry?
+            if other is not None:
+                other -= 1
+
+        elif response and response.get_redirect_location():
+            # Redirect retry?
+            if redirect is not None:
+                redirect -= 1
+            cause = "too many redirects"
+            redirect_location = response.get_redirect_location()
+            status = response.status
+
+        else:
+            # Incrementing because of a server error like a 500 in
+            # status_forcelist and the given method is in the allowed_methods
+            cause = ResponseError.GENERIC_ERROR
+            if response and response.status:
+                if status_count is not None:
+                    status_count -= 1
+                cause = ResponseError.SPECIFIC_ERROR.format(status_code=response.status)
+                status = response.status
+
+        history = self.history + (
+            RequestHistory(method, url, error, status, redirect_location),
+        )
+
+        new_retry = self.new(
+            total=total,
+            connect=connect,
+            read=read,
+            redirect=redirect,
+            status=status_count,
+            other=other,
+            history=history,
+        )
+
+        if new_retry.is_exhausted():
+            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):
+        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)
+
+
+# For backwards compatibility (equivalent to pre-v1.9):
+Retry.DEFAULT = Retry(3)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_.py
new file mode 100644
index 0000000..0a6a0e0
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_.py
@@ -0,0 +1,504 @@
+from __future__ import absolute_import
+
+import hashlib
+import hmac
+import os
+import sys
+import warnings
+from binascii import hexlify, unhexlify
+
+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_SNI = False
+IS_PYOPENSSL = False
+IS_SECURETRANSPORT = False
+ALPN_PROTOCOLS = ["http/1.1"]
+
+# Maps the length of a digest to a possible hash function producing this digest
+HASHFUNC_MAP = {
+    length: getattr(hashlib, algorithm, None)
+    for length, algorithm in ((32, "md5"), (40, "sha1"), (64, "sha256"))
+}
+
+
+def _const_compare_digest_backport(a, b):
+    """
+    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
+
+
+_const_compare_digest = getattr(hmac, "compare_digest", _const_compare_digest_backport)
+
+try:  # Test for SSL features
+    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
+
+    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
+
+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,
+            )
+            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.
+
+    :param cert:
+        Certificate as bytes object.
+    :param fingerprint:
+        Fingerprint as string of hexdigits, can be interspersed by colons.
+    """
+
+    fingerprint = fingerprint.replace(":", "").lower()
+    digest_length = len(fingerprint)
+    if digest_length not in HASHFUNC_MAP:
+        raise SSLError("Fingerprint of invalid length: {0}".format(fingerprint))
+    hashfunc = HASHFUNC_MAP.get(digest_length)
+    if hashfunc is None:
+        raise SSLError(
+            "Hash function implementation unavailable for fingerprint length: {0}".format(
+                digest_length
+            )
+        )
+
+    # 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):
+        raise SSLError(
+            'Fingerprints did not match. Expected "{0}", got "{1}".'.format(
+                fingerprint, hexlify(cert_digest)
+            )
+        )
+
+
+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.
+    Defaults to :data:`ssl.CERT_REQUIRED`.
+    If given a string it is assumed to be the name of the constant in the
+    :mod:`ssl` module or its abbreviation.
+    (So you can specify `REQUIRED` instead of `CERT_REQUIRED`.
+    If it's neither `None` nor a string we assume it is already the numeric
+    constant which can directly be passed to wrap_socket.
+    """
+    if candidate is None:
+        return CERT_REQUIRED
+
+    if isinstance(candidate, str):
+        res = getattr(ssl, candidate, None)
+        if res is None:
+            res = getattr(ssl, "CERT_" + candidate)
+        return res
+
+    return candidate
+
+
+def resolve_ssl_version(candidate):
+    """
+    like resolve_cert_reqs
+    """
+    if candidate is None:
+        return PROTOCOL_TLS
+
+    if isinstance(candidate, str):
+        res = getattr(ssl, candidate, None)
+        if res is None:
+            res = getattr(ssl, "PROTOCOL_" + candidate)
+        return 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 pip._vendor.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.
+    :param cert_reqs:
+        Whether to require the certificate verification. This defaults to
+        ``ssl.CERT_REQUIRED``.
+    :param options:
+        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.
+    :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
+
+    context = SSLContext(ssl_version)
+
+    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
+
+    if options is None:
+        options = 0
+        # SSLv2 is easily broken and is considered harmful and dangerous
+        options |= OP_NO_SSLv2
+        # SSLv3 has several problems and is now dangerous
+        options |= OP_NO_SSLv3
+        # Disable compression to prevent CRIME attacks for OpenSSL 1.0+
+        # (issue #309)
+        options |= OP_NO_COMPRESSION
+        # TLSv1.2 only. Unless set explicitly, do not request tickets.
+        # This may save some bandwidth on wire, and although the ticket is encrypted,
+        # there is a risk associated with it being on wire,
+        # if the server is not rotating its ticketing keys properly.
+        options |= OP_NO_TICKET
+
+    context.options |= options
+
+    # Enable post-handshake authentication for TLS 1.3, see GH #1634. PHA is
+    # necessary for conditional client cert authentication with TLS 1.3.
+    # The attribute is None for OpenSSL <= 1.1.0 or does not exist in older
+    # versions of Python.  We only enable on Python 3.7.4+ or if certificate
+    # verification is enabled to work around Python issue #37428
+    # See: https://bugs.python.org/issue37428
+    if (cert_reqs == ssl.CERT_REQUIRED or sys.version_info >= (3, 7, 4)) and getattr(
+        context, "post_handshake_auth", None
+    ) 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:
+        context.verify_mode = cert_reqs
+        disable_check_hostname()
+    else:
+        disable_check_hostname()
+        context.verify_mode = cert_reqs
+
+    # 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"):
+        sslkeylogfile = os.environ.get("SSLKEYLOGFILE")
+        if sslkeylogfile:
+            context.keylog_filename = sslkeylogfile
+
+    return context
+
+
+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,
+):
+    """
+    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`.
+
+    :param server_hostname:
+        When SNI is supported, the expected hostname of the certificate
+    :param ssl_context:
+        A pre-made :class:`SSLContext` object. If none is provided, one will
+        be created using :func:`create_urllib3_context`.
+    :param ciphers:
+        A string of ciphers we wish the client to support.
+    :param ca_cert_dir:
+        A directory containing CA certificates in multiple separate files, as
+        supported by OpenSSL's -CApath flag or the capath argument to
+        SSLContext.load_verify_locations().
+    :param key_password:
+        Optional password if the keyfile is encrypted.
+    :param ca_cert_data:
+        Optional string containing CA certificates in PEM format suitable for
+        passing as the cadata parameter to SSLContext.load_verify_locations()
+    :param tls_in_tls:
+        Use SSLTransport to wrap the existing 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.
+        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)
+
+    elif ssl_context is None and hasattr(context, "load_default_certs"):
+        # 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
+    # keyfile being encrypted and OpenSSL asking for the
+    # passphrase via the terminal and instead error out.
+    if keyfile and key_password is None and _is_key_file_encrypted(keyfile):
+        raise SSLError("Client private key is encrypted, password is required")
+
+    if certfile:
+        if key_password is None:
+            context.load_cert_chain(certfile, keyfile)
+        else:
+            context.load_cert_chain(certfile, keyfile, key_password)
+
+    try:
+        if hasattr(context, "set_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)
+    return ssl_sock
+
+
+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 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))
+
+
+def _is_key_file_encrypted(key_file):
+    """Detects if a key file is encrypted or not."""
+    with open(key_file, "r") as f:
+        for line in f:
+            # Look for Proc-Type: 4,ENCRYPTED
+            if "ENCRYPTED" in line:
+                return True
+
+    return False
+
+
+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.
+            raise ProxySchemeUnsupported(
+                "TLS in TLS requires support for the 'ssl' module"
+            )
+
+        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)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py
new file mode 100644
index 0000000..1dd950c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py
@@ -0,0 +1,159 @@
+"""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
+
+import re
+import sys
+
+# 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"
+
+
+class CertificateError(ValueError):
+    pass
+
+
+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
+    """
+    pats = []
+    if not dn:
+        return False
+
+    # Ported from python3-syntax:
+    # leftmost, *remainder = dn.split(r'.')
+    parts = dn.split(r".")
+    leftmost = parts[0]
+    remainder = parts[1:]
+
+    wildcards = leftmost.count("*")
+    if wildcards > max_wildcards:
+        # Issue #17980: avoid denials of service by refusing more
+        # than one wildcard per fragment.  A survey of established
+        # policy among SSL implementations showed it to be a
+        # reasonable choice.
+        raise CertificateError(
+            "too many wildcards in certificate DNS name: " + repr(dn)
+        )
+
+    # speed up common case w/o wildcards
+    if not wildcards:
+        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
+    # the wildcard character comprises a label other than the left-most label.
+    if leftmost == "*":
+        # When '*' is a fragment by itself, it matches a non-empty dotless
+        # fragment.
+        pats.append("[^.]+")
+    elif leftmost.startswith("xn--") or hostname.startswith("xn--"):
+        # RFC 6125, section 6.4.3, subitem 3.
+        # The client SHOULD NOT attempt to match a presented identifier
+        # where the wildcard character is embedded within an A-label or
+        # U-label of an internationalized domain name.
+        pats.append(re.escape(leftmost))
+    else:
+        # Otherwise, '*' matches any dotless string, e.g. www*
+        pats.append(re.escape(leftmost).replace(r"\*", "[^.]*"))
+
+    # add the remaining fragments, ignore any wildcards
+    for frag in remainder:
+        pats.append(re.escape(frag))
+
+    pat = re.compile(r"\A" + r"\.".join(pats) + r"\Z", re.IGNORECASE)
+    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):
+    """Exact matching of IP addresses.
+
+    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(_to_unicode(ipname).rstrip())
+    return ip == host_ip
+
+
+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*.
+
+    CertificateError is raised on failure. On success, the function
+    returns nothing.
+    """
+    if not cert:
+        raise ValueError(
+            "empty or no certificate, match_hostname needs a "
+            "SSL socket or SSL context with either "
+            "CERT_OPTIONAL or CERT_REQUIRED"
+        )
+    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
+        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", ())
+    for key, value in san:
+        if key == "DNS":
+            if host_ip is None and _dnsname_match(value, hostname):
+                return
+            dnsnames.append(value)
+        elif key == "IP Address":
+            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
+        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]))
+    else:
+        raise CertificateError(
+            "no appropriate commonName or subjectAltName fields were found"
+        )
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssltransport.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssltransport.py
new file mode 100644
index 0000000..4a7105d
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssltransport.py
@@ -0,0 +1,221 @@
+import io
+import socket
+import ssl
+
+from ..exceptions import ProxySchemeUnsupported
+from ..packages import six
+
+SSL_BLOCKSIZE = 16384
+
+
+class SSLTransport:
+    """
+    The SSLTransport wraps an existing socket and establishes an SSL connection.
+
+    Contrary to Python's implementation of SSLSocket, it allows you to chain
+    multiple TLS connections together. It's particularly useful if you need to
+    implement TLS within TLS.
+
+    The class supports most of the socket API operations.
+    """
+
+    @staticmethod
+    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.
+
+        The only requirement is that the ssl_context provides the 'wrap_bio'
+        methods.
+        """
+
+        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"
+                )
+
+    def __init__(
+        self, socket, ssl_context, server_hostname=None, suppress_ragged_eofs=True
+    ):
+        """
+        Create an SSLTransport around socket using the provided ssl_context.
+        """
+        self.incoming = ssl.MemoryBIO()
+        self.outgoing = ssl.MemoryBIO()
+
+        self.suppress_ragged_eofs = suppress_ragged_eofs
+        self.socket = socket
+
+        self.sslobj = ssl_context.wrap_bio(
+            self.incoming, self.outgoing, server_hostname=server_hostname
+        )
+
+        # Perform initial handshake.
+        self._ssl_io_loop(self.sslobj.do_handshake)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *_):
+        self.close()
+
+    def fileno(self):
+        return self.socket.fileno()
+
+    def read(self, len=1024, buffer=None):
+        return self._wrap_ssl_read(len, buffer)
+
+    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(len)
+
+    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 buffer and (nbytes is None):
+            nbytes = len(buffer)
+        elif nbytes is None:
+            nbytes = 1024
+        return self.read(nbytes, buffer)
+
+    def sendall(self, data, flags=0):
+        if flags != 0:
+            raise ValueError("non-zero flags not allowed in calls to sendall")
+        count = 0
+        with memoryview(data) as view, view.cast("B") as byte_view:
+            amount = len(byte_view)
+            while count < amount:
+                v = self.send(byte_view[count:])
+                count += v
+
+    def send(self, data, flags=0):
+        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
+
+    def makefile(
+        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.
+
+        This is unfortunately a copy and paste of socket.py makefile with small
+        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,))
+
+        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 = socket.SocketIO(self, rawmode)
+        self.socket._io_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
+
+    def unwrap(self):
+        self._ssl_io_loop(self.sslobj.unwrap)
+
+    def close(self):
+        self.socket.close()
+
+    def getpeercert(self, binary_form=False):
+        return self.sslobj.getpeercert(binary_form)
+
+    def version(self):
+        return self.sslobj.version()
+
+    def cipher(self):
+        return self.sslobj.cipher()
+
+    def selected_alpn_protocol(self):
+        return self.sslobj.selected_alpn_protocol()
+
+    def selected_npn_protocol(self):
+        return self.sslobj.selected_npn_protocol()
+
+    def shared_ciphers(self):
+        return self.sslobj.shared_ciphers()
+
+    def compression(self):
+        return self.sslobj.compression()
+
+    def settimeout(self, value):
+        self.socket.settimeout(value)
+
+    def gettimeout(self):
+        return self.socket.gettimeout()
+
+    def _decref_socketios(self):
+        self.socket._decref_socketios()
+
+    def _wrap_ssl_read(self, len, buffer=None):
+        try:
+            return self._ssl_io_loop(self.sslobj.read, len, buffer)
+        except ssl.SSLError as e:
+            if e.errno == ssl.SSL_ERROR_EOF and self.suppress_ragged_eofs:
+                return 0  # eof, return 0.
+            else:
+                raise
+
+    def _ssl_io_loop(self, func, *args):
+        """Performs an I/O loop between incoming/outgoing and the socket."""
+        should_loop = True
+        ret = None
+
+        while should_loop:
+            errno = None
+            try:
+                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.
+                    raise e
+                errno = e.errno
+
+            buf = self.outgoing.read()
+            self.socket.sendall(buf)
+
+            if errno is None:
+                should_loop = False
+            elif errno == ssl.SSL_ERROR_WANT_READ:
+                buf = self.socket.recv(SSL_BLOCKSIZE)
+                if buf:
+                    self.incoming.write(buf)
+                else:
+                    self.incoming.write_eof()
+        return ret
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/timeout.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/timeout.py
new file mode 100644
index 0000000..78e18a6
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/timeout.py
@@ -0,0 +1,271 @@
+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, getdefaulttimeout
+
+from ..exceptions import TimeoutStateError
+
+# A sentinel value to indicate that no timeout was specified by the user in
+# urllib3
+_Default = object()
+
+
+# Use time.monotonic if available.
+current_time = getattr(time, "monotonic", time.time)
+
+
+class Timeout(object):
+    """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/')
+
+    Or per-request (which overrides the default for the pool):
+
+    .. code-block:: python
+
+       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', 'http://example.com/, timeout=no_timeout)
+
+
+    :param total:
+        This combines the connect and read timeouts into one; the read timeout
+        will be set to the time leftover from the connect attempt. In the
+        event that both a connect timeout and a total are specified, or a read
+        timeout and a total are specified, the shorter timeout will be applied.
+
+        Defaults to None.
+
+    :type total: int, float, or None
+
+    :param connect:
+        The maximum amount of time (in seconds) to wait for a connection
+        attempt to a server to succeed. Omitting the parameter will default the
+        connect timeout to the system default, probably `the global default
+        timeout in socket.py
+        `_.
+        None will set an infinite timeout for connection attempts.
+
+    :type connect: int, float, or None
+
+    :param read:
+        The maximum amount of time (in seconds) to wait between consecutive
+        read operations for a response from the server. Omitting the parameter
+        will default the read timeout to the system default, probably `the
+        global default timeout in socket.py
+        `_.
+        None will set an infinite timeout.
+
+    :type read: int, float, or None
+
+    .. note::
+
+        Many factors can affect the total amount of time for urllib3 to return
+        an HTTP response.
+
+        For example, Python's DNS resolver does not obey the timeout specified
+        on the socket. Other factors that can affect total request time include
+        high CPU load, high swap, the program running at a low priority level,
+        or other behaviors.
+
+        In addition, the read and total timeouts only measure the time between
+        read operations on the socket connecting the client and the server,
+        not the total amount of time for the request to return a complete
+        response. For most requests, the timeout is raised because the server
+        has not sent the first byte in the specified time. This is not always
+        the case; if a server streams one byte every fifteen seconds, a timeout
+        of 20 seconds will not trigger, even though the request will take
+        several minutes to complete.
+
+        If your goal is to cut off any request after a set amount of wall clock
+        time, consider having a second "watcher" thread to cut off a slow
+        request.
+    """
+
+    #: A sentinel object representing the default timeout value
+    DEFAULT_TIMEOUT = _GLOBAL_DEFAULT_TIMEOUT
+
+    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 = None
+
+    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__
+
+    @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.
+
+        :param value: The timeout value to validate
+        :param name: The name of the timeout attribute to validate. This is
+            used to specify in error messages.
+        :return: The validated and casted version of the given value.
+        :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:
+            return value
+
+        if isinstance(value, bool):
+            raise ValueError(
+                "Timeout cannot be a boolean value. It must "
+                "be an int, float or None."
+            )
+        try:
+            float(value)
+        except (TypeError, ValueError):
+            raise ValueError(
+                "Timeout value %s was %s, but it must be an "
+                "int, float or None." % (name, value)
+            )
+
+        try:
+            if value <= 0:
+                raise ValueError(
+                    "Attempted to set %s timeout to %s, but the "
+                    "timeout cannot be set to a value less "
+                    "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)
+            )
+
+        return value
+
+    @classmethod
+    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
+        connect(), and recv() socket requests. This creates a :class:`Timeout`
+        object that sets the individual timeouts to the ``timeout`` value
+        passed to this function.
+
+        :param timeout: The legacy timeout value.
+        :type timeout: integer, float, sentinel default object, or None
+        :return: Timeout object
+        :rtype: :class:`Timeout`
+        """
+        return Timeout(read=timeout, connect=timeout)
+
+    def clone(self):
+        """Create a copy of the timeout object
+
+        Timeout properties are stored per-pool but each request needs a fresh
+        Timeout object to ensure each one has its own start/stop configured.
+
+        :return: a copy of the timeout object
+        :rtype: :class:`Timeout`
+        """
+        # We can't use copy.deepcopy because that will also create a new object
+        # for _GLOBAL_DEFAULT_TIMEOUT, which socket.py uses as a sentinel to
+        # detect the user default.
+        return Timeout(connect=self._connect, read=self._read, total=self.total)
+
+    def start_connect(self):
+        """Start the timeout clock, used during a connect() attempt
+
+        :raises urllib3.exceptions.TimeoutStateError: if you attempt
+            to start a timer that has been started already.
+        """
+        if self._start_connect is not None:
+            raise TimeoutStateError("Timeout timer has already been started.")
+        self._start_connect = current_time()
+        return self._start_connect
+
+    def get_connect_duration(self):
+        """Gets the time elapsed since the call to :meth:`start_connect`.
+
+        :return: Elapsed time in seconds.
+        :rtype: float
+        :raises urllib3.exceptions.TimeoutStateError: if you attempt
+            to get duration for a timer that hasn't been started.
+        """
+        if self._start_connect is None:
+            raise TimeoutStateError(
+                "Can't get connect duration for timer that has not started."
+            )
+        return current_time() - self._start_connect
+
+    @property
+    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
+        (never timeout), or the default system timeout.
+
+        :return: Connect timeout.
+        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
+        """
+        if self.total is None:
+            return self._connect
+
+        if self._connect is None or self._connect is self.DEFAULT_TIMEOUT:
+            return self.total
+
+        return min(self._connect, self.total)
+
+    @property
+    def read_timeout(self):
+        """Get the value for the read timeout.
+
+        This assumes some time has elapsed in the connection timeout and
+        computes the read timeout appropriately.
+
+        If self.total is set, the read timeout is dependent on the amount of
+        time taken by the connect timeout. If the connection time has not been
+        established, a :exc:`~urllib3.exceptions.TimeoutStateError` will be
+        raised.
+
+        :return: Value to use for the read timeout.
+        :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 self.DEFAULT_TIMEOUT
+            and self._read is not None
+            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 self.DEFAULT_TIMEOUT:
+            return max(0, self.total - self.get_connect_duration())
+        else:
+            return self._read
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/url.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/url.py
new file mode 100644
index 0000000..a960b2f
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/url.py
@@ -0,0 +1,435 @@
+from __future__ import absolute_import
+
+import re
+from collections import namedtuple
+
+from ..exceptions import LocationParseError
+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)
+
+# 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(
+    r"^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?"
+    r"(?://([^\\/?#]*))?"
+    r"([^?#]*)"
+    r"(?:\?([^#]*))?"
+    r"(?:#(.*))?$",
+    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}
+_variations = [
+    #                            6( h16 ":" ) ls32
+    "(?:%(hex)s:){6}%(ls32)s",
+    #                       "::" 5( h16 ":" ) ls32
+    "::(?:%(hex)s:){5}%(ls32)s",
+    # [               h16 ] "::" 4( h16 ":" ) ls32
+    "(?:%(hex)s)?::(?:%(hex)s:){4}%(ls32)s",
+    # [ *1( h16 ":" ) h16 ] "::" 3( h16 ":" ) ls32
+    "(?:(?:%(hex)s:)?%(hex)s)?::(?:%(hex)s:){3}%(ls32)s",
+    # [ *2( h16 ":" ) h16 ] "::" 2( h16 ":" ) ls32
+    "(?:(?:%(hex)s:){0,2}%(hex)s)?::(?:%(hex)s:){2}%(ls32)s",
+    # [ *3( h16 ":" ) h16 ] "::"    h16 ":"   ls32
+    "(?:(?:%(hex)s:){0,3}%(hex)s)?::%(hex)s:%(ls32)s",
+    # [ *4( h16 ":" ) h16 ] "::"              ls32
+    "(?:(?:%(hex)s:){0,4}%(hex)s)?::%(ls32)s",
+    # [ *5( h16 ":" ) h16 ] "::"              h16
+    "(?:(?:%(hex)s:){0,5}%(hex)s)?::%(hex)s",
+    # [ *6( h16 ":" ) h16 ] "::"
+    "(?:(?:%(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"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$")
+
+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,
+)
+_HOST_PORT_RE = re.compile(_HOST_PORT_PAT, re.UNICODE | re.DOTALL)
+
+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 | {"?"}
+
+
+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.
+    """
+
+    __slots__ = ()
+
+    def __new__(
+        cls,
+        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(Url, cls).__new__(
+            cls, scheme, auth, host, port, path, query, fragment
+        )
+
+    @property
+    def hostname(self):
+        """For backwards-compatibility with urlparse. We're nice like that."""
+        return self.host
+
+    @property
+    def request_uri(self):
+        """Absolute path including the query string."""
+        uri = self.path or "/"
+
+        if self.query is not None:
+            uri += "?" + self.query
+
+        return uri
+
+    @property
+    def netloc(self):
+        """Network location including host and port"""
+        if self.port:
+            return "%s:%d" % (self.host, self.port)
+        return self.host
+
+    @property
+    def url(self):
+        """
+        Convert self into a url
+
+        This function should more or less round-trip with :func:`.parse_url`. The
+        returned url may not be exactly the same as the url inputted to
+        :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls
+        with a blank port will have : removed).
+
+        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'
+        """
+        scheme, auth, host, port, path, query, fragment = self
+        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 + u"://"
+        if auth is not None:
+            url += auth + u"@"
+        if host is not None:
+            url += host
+        if port is not None:
+            url += u":" + str(port)
+        if path is not None:
+            url += path
+        if query is not None:
+            url += u"?" + query
+        if fragment is not None:
+            url += u"#" + fragment
+
+        return url
+
+    def __str__(self):
+        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
+
+
+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 = 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(
+        lambda match: match.group(0).upper(), component
+    )
+
+    uri_bytes = component.encode("utf-8", "surrogatepass")
+    is_percent_encoded = percent_encodings == uri_bytes.count(b"%")
+    encoded_component = bytearray()
+
+    for i in range(0, len(uri_bytes)):
+        # 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 (
+            byte_ord < 128 and byte.decode() in allowed_chars
+        ):
+            encoded_component += byte
+            continue
+        encoded_component.extend(b"%" + (hex(byte_ord)[2:].encode().zfill(2).upper()))
+
+    return encoded_component.decode(encoding)
+
+
+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
+
+    for segment in segments:
+        # '.' is the current directory, so ignore it, it is superfluous
+        if segment == ".":
+            continue
+        # Anything other than '..', should be appended to the output
+        elif segment != "..":
+            output.append(segment)
+        # In this case segment == '..', if we can, we should pop the last
+        # element
+        elif output:
+            output.pop()
+
+    # If the path starts with '/' and the output is empty or the first string
+    # is non-empty
+    if path.startswith("/") and (not output or output[0]):
+        output.insert(0, "")
+
+    # If the path starts with '/.' or '/..' ensure we add one more empty
+    # string to add a trailing '/'
+    if path.endswith(("/.", "/..")):
+        output.append("")
+
+    return "/".join(output)
+
+
+def _normalize_host(host, scheme):
+    if 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)
+                if match:
+                    start, end = match.span(1)
+                    zone_id = host[start:end]
+
+                    if zone_id.startswith("%25") and zone_id != "%25":
+                        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:]
+                else:
+                    return host.lower()
+            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):
+    if name and any(ord(x) >= 128 for x in name):
+        try:
+            from pip._vendor import idna
+        except ImportError:
+            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:
+            six.raise_from(
+                LocationParseError(u"Name '%s' is not a valid IDNA label" % name), 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)
+    if query is not None:
+        target += "?" + query
+    return target
+
+
+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 and RFC 6874 compliant.
+
+    The parser logic and helper functions are based heavily on
+    work done in the ``rfc3986`` module.
+
+    :param str url: URL to parse into a :class:`.Url` namedtuple.
+
+    Partly backwards-compatible with :mod:`urlparse`.
+
+    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', ...)
+    """
+    if not url:
+        # Empty
+        return Url()
+
+    source_url = url
+    if not SCHEME_RE.search(url):
+        url = "//" + url
+
+    try:
+        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()
+
+        if authority:
+            auth, _, host_port = authority.rpartition("@")
+            auth = auth or None
+            host, port = _HOST_PORT_RE.match(host_port).groups()
+            if auth and normalize_uri:
+                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):
+                raise LocationParseError(url)
+
+        host = _normalize_host(host, scheme)
+
+        if normalize_uri and path:
+            path = _remove_path_dot_segments(path)
+            path = _encode_invalid_chars(path, PATH_CHARS)
+        if normalize_uri and query:
+            query = _encode_invalid_chars(query, QUERY_CHARS)
+        if normalize_uri and fragment:
+            fragment = _encode_invalid_chars(fragment, FRAGMENT_CHARS)
+
+    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
+    # beyond the path in the URL.
+    # TODO: Remove this when we break backwards compatibility.
+    if not path:
+        if query is not None or fragment is not None:
+            path = ""
+        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),
+    )
+
+
+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/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/wait.py b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/wait.py
new file mode 100644
index 0000000..21b4590
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/urllib3/util/wait.py
@@ -0,0 +1,152 @@
+import errno
+import select
+import sys
+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
+
+
+# How should we wait on sockets?
+#
+# There are two types of APIs you can use for waiting on sockets: the fancy
+# modern stateful APIs like epoll/kqueue, and the older stateless APIs like
+# select/poll. The stateful APIs are more efficient when you have a lots of
+# sockets to keep track of, because you can set them up once and then use them
+# lots of times. But we only ever want to wait on a single socket at a time
+# and don't want to keep track of state, so the stateless APIs are actually
+# more efficient. So we want to use select() or poll().
+#
+# Now, how do we choose between select() and poll()? On traditional Unixes,
+# select() has a strange calling convention that makes it slow, or fail
+# altogether, for high-numbered file descriptors. The point of poll() is to fix
+# that, so on Unixes, we prefer poll().
+#
+# On Windows, there is no poll() (or at least Python doesn't provide a wrapper
+# for it), but that's OK, because on Windows, select() doesn't have this
+# strange calling convention; plain select() works fine.
+#
+# 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):
+    if not read and not write:
+        raise RuntimeError("must specify at least one of read=True, write=True")
+    rcheck = []
+    wcheck = []
+    if read:
+        rcheck.append(sock)
+    if write:
+        wcheck.append(sock)
+    # When doing a non-blocking connect, most systems signal success by
+    # marking the socket writable. Windows, though, signals success by marked
+    # it as "exceptional". We paper over the difference by checking the write
+    # 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)
+    return bool(rready or wready or xready)
+
+
+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
+    if read:
+        mask |= select.POLLIN
+    if write:
+        mask |= select.POLLOUT
+    poll_obj = select.poll()
+    poll_obj.register(sock, mask)
+
+    # For some reason, poll() takes timeout in milliseconds
+    def do_poll(t):
+        if t is not None:
+            t *= 1000
+        return poll_obj.poll(t)
+
+    return bool(_retry_on_intr(do_poll, timeout))
+
+
+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()
+        _retry_on_intr(poll_obj.poll, 0)
+    except (AttributeError, OSError):
+        return False
+    else:
+        return True
+
+
+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
+    # we're imported.
+    global wait_for_socket
+    if _have_working_poll():
+        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)
+
+
+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, 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.
+    """
+    return wait_for_socket(sock, write=True, timeout=timeout)
diff --git a/env/lib/python3.12/site-packages/pip/_vendor/vendor.txt b/env/lib/python3.12/site-packages/pip/_vendor/vendor.txt
new file mode 100644
index 0000000..f04a9c1
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/_vendor/vendor.txt
@@ -0,0 +1,18 @@
+CacheControl==0.14.1
+distlib==0.3.9
+distro==1.9.0
+msgpack==1.1.0
+packaging==24.2
+platformdirs==4.3.6
+pyproject-hooks==1.2.0
+requests==2.32.3
+    certifi==2024.8.30
+    idna==3.10
+    urllib3==1.26.20
+rich==13.9.4
+    pygments==2.18.0
+    typing_extensions==4.12.2
+resolvelib==1.0.1
+setuptools==70.3.0
+tomli==2.2.1
+truststore==0.10.0
diff --git a/env/lib/python3.12/site-packages/pip/py.typed b/env/lib/python3.12/site-packages/pip/py.typed
new file mode 100644
index 0000000..493b53e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pip/py.typed
@@ -0,0 +1,4 @@
+pip is a command line program. While it is implemented in Python, and so is
+available for import, you must not use pip's internal APIs in this way. Typing
+information is provided as a convenience only and is not a guarantee. Expect
+unannounced changes to the API and types in releases.
diff --git a/env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/METADATA b/env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/METADATA
new file mode 100644
index 0000000..c81c4f3
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/METADATA
@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: platformdirs
+Version: 4.9.2
+Summary: A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`.
+Project-URL: Changelog, https://platformdirs.readthedocs.io/en/latest/changelog.html
+Project-URL: Documentation, https://platformdirs.readthedocs.io
+Project-URL: Homepage, https://github.com/tox-dev/platformdirs
+Project-URL: Source, https://github.com/tox-dev/platformdirs
+Project-URL: Tracker, https://github.com/tox-dev/platformdirs/issues
+Maintainer-email: Bernát Gábor , Julian Berman , Ofek Lev , Ronny Pfannschmidt 
+License-Expression: MIT
+License-File: LICENSE
+Keywords: appdirs,application,cache,directory,log,user
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# platformdirs
+
+[![PyPI version](https://badge.fury.io/py/platformdirs.svg)](https://badge.fury.io/py/platformdirs)
+[![Python versions](https://img.shields.io/pypi/pyversions/platformdirs.svg)](https://pypi.python.org/pypi/platformdirs/)
+[![CI](https://github.com/tox-dev/platformdirs/actions/workflows/check.yaml/badge.svg)](https://github.com/platformdirs/platformdirs/actions)
+[![Downloads](https://static.pepy.tech/badge/platformdirs/month)](https://pepy.tech/project/platformdirs)
+
+A Python package for determining platform-specific directories (e.g. user data, config, cache, logs). Handles the
+differences between macOS, Windows, Linux/Unix, and Android so you don't have to.
+
+## Quick start
+
+```python
+from platformdirs import PlatformDirs
+
+dirs = PlatformDirs("MyApp", "MyCompany")
+dirs.user_data_dir  # ~/.local/share/MyApp (Linux)
+dirs.user_config_dir  # ~/.config/MyApp (Linux)
+dirs.user_cache_dir  # ~/.cache/MyApp (Linux)
+dirs.user_state_dir  # ~/.local/state/MyApp (Linux)
+dirs.user_log_dir  # ~/.local/state/MyApp/log (Linux)
+dirs.user_documents_dir  # ~/Documents
+dirs.user_downloads_dir  # ~/Downloads
+dirs.user_runtime_dir  # /run/user//MyApp (Linux)
+```
+
+For Path objects instead of strings:
+
+```python
+from platformdirs import PlatformDirs
+
+dirs = PlatformDirs("MyApp", "MyCompany")
+dirs.user_data_path  # pathlib.Path('~/.local/share/MyApp')
+dirs.user_config_path  # pathlib.Path('~/.config/MyApp')
+```
+
+Convenience functions for quick access:
+
+```python
+from platformdirs import user_data_dir, user_config_path
+
+user_data_dir("MyApp", "MyCompany")  # returns str
+user_config_path("MyApp", "MyCompany")  # returns pathlib.Path
+```
+
+## Directory types
+
+- **Data**: Persistent application data (`user_data_dir`, `site_data_dir`)
+- **Config**: Configuration files and settings (`user_config_dir`, `site_config_dir`)
+- **Cache**: Cached data that can be regenerated (`user_cache_dir`, `site_cache_dir`)
+- **State**: Non-essential runtime state like window positions (`user_state_dir`, `site_state_dir`)
+- **Logs**: Log files (`user_log_dir`, `site_log_dir`)
+- **Runtime**: Runtime files like sockets and PIDs (`user_runtime_dir`, `site_runtime_dir`)
+
+Each type has both `user_*` (per-user, writable) and `site_*` (system-wide, read-only for users) variants.
+
+## Documentation
+
+Full documentation is available at [platformdirs.readthedocs.io](https://platformdirs.readthedocs.io):
+
+- **[Getting started tutorial](https://platformdirs.readthedocs.io/en/latest/usage.html)** -- learn core concepts
+  through real-world examples
+- **[How-to guides](https://platformdirs.readthedocs.io/en/latest/howto.html)** -- recipes for common tasks and
+  platform-specific tips
+- **[API reference](https://platformdirs.readthedocs.io/en/latest/api.html)** -- complete list of functions and classes
+- **[Platform details](https://platformdirs.readthedocs.io/en/latest/platforms.html)** -- default paths for each
+  operating system
+
+Contributions are welcome! See [CONTRIBUTING.md](https://github.com/tox-dev/platformdirs/blob/main/CONTRIBUTING.md) for
+details.
diff --git a/env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/RECORD b/env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/RECORD
new file mode 100644
index 0000000..dad1183
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/RECORD
@@ -0,0 +1,14 @@
+platformdirs/__init__.py,sha256=hL_ZyhsQ5EfYf4W_Tr4O6F0lAOKLvQi0TZ4e_WGCIc4,30718
+platformdirs/__main__.py,sha256=MvM6fKJpBAeiTZckNJGSihXFKkS46tS9_P5gySZg3RI,1633
+platformdirs/_xdg.py,sha256=zzf6nX5N329OzNe2PhFEFWAUhN7ijmghapDb81ll2Us,6457
+platformdirs/android.py,sha256=rYE9JorFw9NxTKPZHNIkKDAeu85zy7kZgR7bod2SiTk,10487
+platformdirs/api.py,sha256=iuNVDTrHntrQjBknqA-BSCsxWqix8aJugdYo4SbuBAo,12734
+platformdirs/macos.py,sha256=YP2C4B1krgWVSA7yOq1T6NrUqduZqaFXIUxVtB4FuEg,7869
+platformdirs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+platformdirs/unix.py,sha256=gVnPoy-Jbm1rWHEUxgcK-Srn70bIvz8LmBmSYB7-eyw,12110
+platformdirs/version.py,sha256=wuzaZFYcYt9Do21p5E5Jf8Zdv2fnX7054ADz3-SK0FM,704
+platformdirs/windows.py,sha256=eQFkbOcRcI5YplmPx59FOd7yXJlhq27PpL7HVaC7se4,14564
+platformdirs-4.9.2.dist-info/METADATA,sha256=fGO65HRycWSMB9zg6dRFGXBMSRSynsrPc2hb03db2nQ,4680
+platformdirs-4.9.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+platformdirs-4.9.2.dist-info/licenses/LICENSE,sha256=KeD9YukphQ6G6yjD_czwzv30-pSHkBHP-z0NS-1tTbY,1089
+platformdirs-4.9.2.dist-info/RECORD,,
diff --git a/env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/WHEEL b/env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/WHEEL
new file mode 100644
index 0000000..ae8ec1b
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/licenses/LICENSE b/env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/licenses/LICENSE
new file mode 100644
index 0000000..f35fed9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs-4.9.2.dist-info/licenses/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2010-202x The platformdirs developers
+
+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/env/lib/python3.12/site-packages/platformdirs/__init__.py b/env/lib/python3.12/site-packages/platformdirs/__init__.py
new file mode 100644
index 0000000..4ab450e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs/__init__.py
@@ -0,0 +1,857 @@
+"""Utilities for determining application-specific dirs.
+
+Provides convenience functions (e.g. :func:`user_data_dir`, :func:`user_config_path`), a :data:`PlatformDirs` class that
+auto-detects the current platform, and the :class:`~platformdirs.api.PlatformDirsABC` base class.
+
+See  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
+    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 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  # noqa: PLC0415
+
+        if _android_folder() is not None:
+            from platformdirs.android import Android  # noqa: PLC0415
+
+            return Android  # return to avoid redefinition of a result
+
+    return _Result
+
+
+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
+
+
+def user_data_dir(  # noqa: PLR0913, PLR0917
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    use_site_for_root: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: data directory tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_data_dir
+
+
+def site_data_dir(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `multipath `.
+    :param ensure_exists: See `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(  # noqa: PLR0913, PLR0917
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    use_site_for_root: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: config directory tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_config_dir
+
+
+def site_config_dir(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `multipath `.
+    :param ensure_exists: See `ensure_exists `.
+
+    :returns: config directory shared by users
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_config_dir
+
+
+def user_cache_dir(  # noqa: PLR0913, PLR0917
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    use_site_for_root: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: cache directory tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_cache_dir
+
+
+def site_cache_dir(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+
+    :returns: cache directory shared by users
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_cache_dir
+
+
+def user_state_dir(  # noqa: PLR0913, PLR0917
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    use_site_for_root: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: state directory tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_state_dir
+
+
+def site_state_dir(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param ensure_exists: See `ensure_exists `.
+
+    :returns: state directory shared by users
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        ensure_exists=ensure_exists,
+    ).site_state_dir
+
+
+def user_log_dir(  # noqa: PLR0913, PLR0917
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    use_site_for_root: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: log directory tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_log_dir
+
+
+def site_log_dir(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+
+    :returns: log directory shared by users
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_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_bin_dir() -> str:
+    """:returns: bin directory tied to the user"""
+    return PlatformDirs().user_bin_dir
+
+
+def site_bin_dir() -> str:
+    """:returns: bin directory shared by users"""
+    return PlatformDirs().site_bin_dir
+
+
+def user_applications_dir() -> str:
+    """:returns: applications directory tied to the user"""
+    return PlatformDirs().user_applications_dir
+
+
+def site_applications_dir(
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param multipath: See `multipath `.
+    :param ensure_exists: See `ensure_exists `.
+
+    :returns: applications directory shared by users
+
+    """
+    return PlatformDirs(
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_applications_dir
+
+
+def user_runtime_dir(  # noqa: PLR0913, PLR0917
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    use_site_for_root: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: runtime directory tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_runtime_dir
+
+
+def site_runtime_dir(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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(  # noqa: PLR0913, PLR0917
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    use_site_for_root: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: data path tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_data_path
+
+
+def site_data_path(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `multipath `.
+    :param ensure_exists: See `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(  # noqa: PLR0913, PLR0917
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    use_site_for_root: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: config path tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_config_path
+
+
+def site_config_path(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `multipath `.
+    :param ensure_exists: See `ensure_exists `.
+
+    :returns: config path shared by 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 | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+
+    :returns: cache path shared by users
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_cache_path
+
+
+def user_cache_path(  # noqa: PLR0913, PLR0917
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    use_site_for_root: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: cache path tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_cache_path
+
+
+def user_state_path(  # noqa: PLR0913, PLR0917
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    use_site_for_root: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: state path tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_state_path
+
+
+def site_state_path(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param ensure_exists: See `ensure_exists `.
+
+    :returns: state path shared by users
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        ensure_exists=ensure_exists,
+    ).site_state_path
+
+
+def user_log_path(  # noqa: PLR0913, PLR0917
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    use_site_for_root: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: log path tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_log_path
+
+
+def site_log_path(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+
+    :returns: log path shared by users
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_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_bin_path() -> Path:
+    """:returns: bin path tied to the user"""
+    return PlatformDirs().user_bin_path
+
+
+def site_bin_path() -> Path:
+    """:returns: bin path shared by users"""
+    return PlatformDirs().site_bin_path
+
+
+def user_applications_path() -> Path:
+    """:returns: applications path tied to the user"""
+    return PlatformDirs().user_applications_path
+
+
+def site_applications_path(
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param multipath: See `multipath `.
+    :param ensure_exists: See `ensure_exists `.
+
+    :returns: applications path shared by users
+
+    """
+    return PlatformDirs(
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_applications_path
+
+
+def user_runtime_path(  # noqa: PLR0913, PLR0917
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    use_site_for_root: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: runtime path tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_runtime_path
+
+
+def site_runtime_path(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `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__ = [
+    "AppDirs",
+    "PlatformDirs",
+    "PlatformDirsABC",
+    "__version__",
+    "__version_info__",
+    "site_applications_dir",
+    "site_applications_path",
+    "site_bin_dir",
+    "site_bin_path",
+    "site_cache_dir",
+    "site_cache_path",
+    "site_config_dir",
+    "site_config_path",
+    "site_data_dir",
+    "site_data_path",
+    "site_log_dir",
+    "site_log_path",
+    "site_runtime_dir",
+    "site_runtime_path",
+    "site_state_dir",
+    "site_state_path",
+    "user_applications_dir",
+    "user_applications_path",
+    "user_bin_dir",
+    "user_bin_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/env/lib/python3.12/site-packages/platformdirs/__main__.py b/env/lib/python3.12/site-packages/platformdirs/__main__.py
new file mode 100644
index 0000000..2490ffb
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs/__main__.py
@@ -0,0 +1,61 @@
+"""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_bin_dir",
+    "site_bin_dir",
+    "user_applications_dir",
+    "user_runtime_dir",
+    "site_data_dir",
+    "site_config_dir",
+    "site_cache_dir",
+    "site_state_dir",
+    "site_log_dir",
+    "site_applications_dir",
+    "site_runtime_dir",
+)
+
+
+def main() -> None:
+    """Run the 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/env/lib/python3.12/site-packages/platformdirs/_xdg.py b/env/lib/python3.12/site-packages/platformdirs/_xdg.py
new file mode 100644
index 0000000..c4aadd6
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs/_xdg.py
@@ -0,0 +1,143 @@
+"""XDG environment variable mixin for Unix and macOS."""
+
+from __future__ import annotations
+
+import os
+
+from .api import PlatformDirsABC
+
+
+class XDGMixin(PlatformDirsABC):
+    """Mixin that checks XDG environment variables, falling back to platform-specific defaults via ``super()``."""
+
+    @property
+    def user_data_dir(self) -> str:
+        """:returns: data directory tied to the user, from ``$XDG_DATA_HOME`` if set, else platform default"""
+        if path := os.environ.get("XDG_DATA_HOME", "").strip():
+            return self._append_app_name_and_version(path)
+        return super().user_data_dir
+
+    @property
+    def _site_data_dirs(self) -> list[str]:
+        if xdg_dirs := os.environ.get("XDG_DATA_DIRS", "").strip():
+            return [self._append_app_name_and_version(p) for p in xdg_dirs.split(os.pathsep) if p.strip()]
+        return super()._site_data_dirs  # type: ignore[misc]
+
+    @property
+    def site_data_dir(self) -> str:
+        """:returns: data directories shared by users, from ``$XDG_DATA_DIRS`` if set, else platform default"""
+        dirs = self._site_data_dirs
+        return os.pathsep.join(dirs) if self.multipath else dirs[0]
+
+    @property
+    def user_config_dir(self) -> str:
+        """:returns: config directory tied to the user, from ``$XDG_CONFIG_HOME`` if set, else platform default"""
+        if path := os.environ.get("XDG_CONFIG_HOME", "").strip():
+            return self._append_app_name_and_version(path)
+        return super().user_config_dir
+
+    @property
+    def _site_config_dirs(self) -> list[str]:
+        if xdg_dirs := os.environ.get("XDG_CONFIG_DIRS", "").strip():
+            return [self._append_app_name_and_version(p) for p in xdg_dirs.split(os.pathsep) if p.strip()]
+        return super()._site_config_dirs  # type: ignore[misc]
+
+    @property
+    def site_config_dir(self) -> str:
+        """:returns: config directories shared by users, from ``$XDG_CONFIG_DIRS`` if set, else platform default"""
+        dirs = self._site_config_dirs
+        return os.pathsep.join(dirs) if self.multipath else dirs[0]
+
+    @property
+    def user_cache_dir(self) -> str:
+        """:returns: cache directory tied to the user, from ``$XDG_CACHE_HOME`` if set, else platform default"""
+        if path := os.environ.get("XDG_CACHE_HOME", "").strip():
+            return self._append_app_name_and_version(path)
+        return super().user_cache_dir
+
+    @property
+    def user_state_dir(self) -> str:
+        """:returns: state directory tied to the user, from ``$XDG_STATE_HOME`` if set, else platform default"""
+        if path := os.environ.get("XDG_STATE_HOME", "").strip():
+            return self._append_app_name_and_version(path)
+        return super().user_state_dir
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """:returns: runtime directory tied to the user, from ``$XDG_RUNTIME_DIR`` if set, else platform default"""
+        if path := os.environ.get("XDG_RUNTIME_DIR", "").strip():
+            return self._append_app_name_and_version(path)
+        return super().user_runtime_dir
+
+    @property
+    def site_runtime_dir(self) -> str:
+        """:returns: runtime directory shared by users, from ``$XDG_RUNTIME_DIR`` if set, else platform default"""
+        if path := os.environ.get("XDG_RUNTIME_DIR", "").strip():
+            return self._append_app_name_and_version(path)
+        return super().site_runtime_dir
+
+    @property
+    def user_documents_dir(self) -> str:
+        """:returns: documents directory tied to the user, from ``$XDG_DOCUMENTS_DIR`` if set, else platform default"""
+        if path := os.environ.get("XDG_DOCUMENTS_DIR", "").strip():
+            return os.path.expanduser(path)  # noqa: PTH111
+        return super().user_documents_dir
+
+    @property
+    def user_downloads_dir(self) -> str:
+        """:returns: downloads directory tied to the user, from ``$XDG_DOWNLOAD_DIR`` if set, else platform default"""
+        if path := os.environ.get("XDG_DOWNLOAD_DIR", "").strip():
+            return os.path.expanduser(path)  # noqa: PTH111
+        return super().user_downloads_dir
+
+    @property
+    def user_pictures_dir(self) -> str:
+        """:returns: pictures directory tied to the user, from ``$XDG_PICTURES_DIR`` if set, else platform default"""
+        if path := os.environ.get("XDG_PICTURES_DIR", "").strip():
+            return os.path.expanduser(path)  # noqa: PTH111
+        return super().user_pictures_dir
+
+    @property
+    def user_videos_dir(self) -> str:
+        """:returns: videos directory tied to the user, from ``$XDG_VIDEOS_DIR`` if set, else platform default"""
+        if path := os.environ.get("XDG_VIDEOS_DIR", "").strip():
+            return os.path.expanduser(path)  # noqa: PTH111
+        return super().user_videos_dir
+
+    @property
+    def user_music_dir(self) -> str:
+        """:returns: music directory tied to the user, from ``$XDG_MUSIC_DIR`` if set, else platform default"""
+        if path := os.environ.get("XDG_MUSIC_DIR", "").strip():
+            return os.path.expanduser(path)  # noqa: PTH111
+        return super().user_music_dir
+
+    @property
+    def user_desktop_dir(self) -> str:
+        """:returns: desktop directory tied to the user, from ``$XDG_DESKTOP_DIR`` if set, else platform default"""
+        if path := os.environ.get("XDG_DESKTOP_DIR", "").strip():
+            return os.path.expanduser(path)  # noqa: PTH111
+        return super().user_desktop_dir
+
+    @property
+    def user_applications_dir(self) -> str:
+        """:returns: applications directory tied to the user, from ``$XDG_DATA_HOME`` if set, else platform default"""
+        if path := os.environ.get("XDG_DATA_HOME", "").strip():
+            return os.path.join(os.path.expanduser(path), "applications")  # noqa: PTH111, PTH118
+        return super().user_applications_dir
+
+    @property
+    def _site_applications_dirs(self) -> list[str]:
+        if xdg_dirs := os.environ.get("XDG_DATA_DIRS", "").strip():
+            return [os.path.join(p, "applications") for p in xdg_dirs.split(os.pathsep) if p.strip()]  # noqa: PTH118
+        return super()._site_applications_dirs  # type: ignore[misc]
+
+    @property
+    def site_applications_dir(self) -> str:
+        """:returns: applications directories shared by users, from ``$XDG_DATA_DIRS`` if set, else platform default"""
+        dirs = self._site_applications_dirs
+        return os.pathsep.join(dirs) if self.multipath else dirs[0]
+
+
+__all__ = [
+    "XDGMixin",
+]
diff --git a/env/lib/python3.12/site-packages/platformdirs/android.py b/env/lib/python3.12/site-packages/platformdirs/android.py
new file mode 100644
index 0000000..38243df
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs/android.py
@@ -0,0 +1,273 @@
+"""Android."""
+
+from __future__ import annotations
+
+import os
+import re
+import sys
+from functools import lru_cache
+from typing import TYPE_CHECKING, cast
+
+from .api import PlatformDirsABC
+
+
+class Android(PlatformDirsABC):  # noqa: PLR0904
+    """Platform directories for Android.
+
+    Follows the guidance `from here `_. Directories are typically located
+    under the app's private storage (``/data/user///``).
+
+    Makes use of the `appname `, `version
+    `, `opinion `, `ensure_exists
+    `.
+
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """:returns: data directory tied to the user, e.g. ``/data/user///files/``"""
+        return self._append_app_name_and_version(cast("str", _android_folder()), "files")
+
+    @property
+    def site_data_dir(self) -> str:
+        """:returns: data directory shared by users, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def user_config_dir(self) -> str:
+        """:returns: config directory tied to the user, e.g. ``/data/user///shared_prefs/``"""
+        return self._append_app_name_and_version(cast("str", _android_folder()), "shared_prefs")
+
+    @property
+    def site_config_dir(self) -> str:
+        """:returns: config directory shared by users, same as `user_config_dir`"""
+        return self.user_config_dir
+
+    @property
+    def user_cache_dir(self) -> str:
+        """:returns: cache directory tied to the user, e.g.,``/data/user///cache/``"""
+        return self._append_app_name_and_version(cast("str", _android_folder()), "cache")
+
+    @property
+    def site_cache_dir(self) -> str:
+        """:returns: cache directory shared by users, same as `user_cache_dir`"""
+        return self.user_cache_dir
+
+    @property
+    def user_state_dir(self) -> str:
+        """:returns: state directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def site_state_dir(self) -> str:
+        """:returns: state directory shared by users, same as `user_state_dir`"""
+        return self.user_state_dir
+
+    @property
+    def user_log_dir(self) -> str:
+        """:returns: log directory tied to the user, same as `user_cache_dir` if not opinionated else ``log`` in it, e.g. ``/data/user///cache//log``"""
+        path = self.user_cache_dir
+        if self.opinion:
+            path = os.path.join(path, "log")  # noqa: PTH118
+        return path
+
+    @property
+    def site_log_dir(self) -> str:
+        """:returns: log directory shared by users, same as `user_log_dir`"""
+        return self.user_log_dir
+
+    @property
+    def user_documents_dir(self) -> str:
+        """:returns: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``"""
+        return _android_documents_folder()
+
+    @property
+    def user_downloads_dir(self) -> str:
+        """:returns: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``"""
+        return _android_downloads_folder()
+
+    @property
+    def user_pictures_dir(self) -> str:
+        """:returns: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``"""
+        return _android_pictures_folder()
+
+    @property
+    def user_videos_dir(self) -> str:
+        """:returns: videos directory tied to the user e.g. ``/storage/emulated/0/DCIM/Camera``"""
+        return _android_videos_folder()
+
+    @property
+    def user_music_dir(self) -> str:
+        """:returns: music directory tied to the user e.g. ``/storage/emulated/0/Music``"""
+        return _android_music_folder()
+
+    @property
+    def user_desktop_dir(self) -> str:
+        """:returns: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``"""
+        return "/storage/emulated/0/Desktop"
+
+    @property
+    def user_bin_dir(self) -> str:
+        """:returns: bin directory tied to the user, e.g. ``/data/user///files/bin``"""
+        return os.path.join(cast("str", _android_folder()), "files", "bin")  # noqa: PTH118
+
+    @property
+    def site_bin_dir(self) -> str:
+        """:returns: bin directory shared by users, same as `user_bin_dir`"""
+        return self.user_bin_dir
+
+    @property
+    def user_applications_dir(self) -> str:
+        """:returns: applications directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def site_applications_dir(self) -> str:
+        """:returns: applications directory shared by users, same as `user_applications_dir`"""
+        return self.user_applications_dir
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """:returns: runtime directory tied to the user, same as `user_cache_dir` if not opinionated else ``tmp`` in it, e.g. ``/data/user///cache//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:
+        """:returns: runtime directory shared by users, same as `user_runtime_dir`"""
+        return self.user_runtime_dir
+
+
+@lru_cache(maxsize=1)
+def _android_folder() -> str | None:  # noqa: C901
+    """:returns: 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
+    # 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 = 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  # ty: ignore[unresolved-import]
+
+            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):
+                result = path.split("/files")[0]
+                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
+
+
+@lru_cache(maxsize=1)
+def _android_documents_folder() -> str:
+    """:returns: documents folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass  # noqa: PLC0415  # ty: ignore[unresolved-import]
+
+        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:
+    """:returns: downloads folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass  # noqa: PLC0415  # ty: ignore[unresolved-import]
+
+        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:
+    """:returns: pictures folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass  # noqa: PLC0415  # ty: ignore[unresolved-import]
+
+        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:
+    """:returns: videos folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass  # noqa: PLC0415  # ty: ignore[unresolved-import]
+
+        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:
+    """:returns: music folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass  # noqa: PLC0415  # ty: ignore[unresolved-import]
+
+        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/env/lib/python3.12/site-packages/platformdirs/api.py b/env/lib/python3.12/site-packages/platformdirs/api.py
new file mode 100644
index 0000000..1ee29ad
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs/api.py
@@ -0,0 +1,394 @@
+"""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:
+    from collections.abc import Iterator
+    from typing import Literal
+
+
+class PlatformDirsABC(ABC):  # noqa: PLR0904
+    """Abstract base class defining all platform directory properties, their :class:`~pathlib.Path` variants, and iterators.
+
+    Platform-specific subclasses (e.g. :class:`~platformdirs.windows.Windows`, :class:`~platformdirs.macos.MacOS`,
+    :class:`~platformdirs.unix.Unix`) implement the abstract properties to return the appropriate paths for each
+    operating system.
+
+    """
+
+    def __init__(  # noqa: PLR0913, PLR0917
+        self,
+        appname: str | None = None,
+        appauthor: str | Literal[False] | None = 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
+        use_site_for_root: 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`.
+        :param use_site_for_root: See `use_site_for_root`.
+
+        """
+        self.appname = appname  #: The name of the 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 ``.``.
+
+        """
+        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 `_).
+
+        """
+        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. Only affects ``site_data_dir`` and ``site_config_dir`` on
+        Unix and macOS.
+
+        """
+        self.opinion = opinion
+        """Whether to use opinionated values.
+
+        When enabled, appends an additional subdirectory for certain directories: e.g. ``Cache`` for cache and ``Logs``
+        for logs on Windows, ``log`` for logs on Unix.
+
+        """
+        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.
+
+        """
+        self.use_site_for_root = use_site_for_root
+        """Whether to redirect ``user_*_dir`` calls to their ``site_*_dir`` equivalents when running as root (uid 0).
+
+        Only has an effect on Unix. Disabled by default for backwards compatibility. When enabled, XDG user environment
+        variables (e.g. ``XDG_DATA_HOME``) are bypassed for the redirected directories.
+
+        """
+
+    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)
+
+    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.partition(os.pathsep)[0]
+        return Path(directory)
+
+    @property
+    @abstractmethod
+    def user_data_dir(self) -> str:
+        """:returns: data directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_data_dir(self) -> str:
+        """:returns: data directory shared by users"""
+
+    @property
+    @abstractmethod
+    def user_config_dir(self) -> str:
+        """:returns: config directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_config_dir(self) -> str:
+        """:returns: config directory shared by users"""
+
+    @property
+    @abstractmethod
+    def user_cache_dir(self) -> str:
+        """:returns: cache directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_cache_dir(self) -> str:
+        """:returns: cache directory shared by users"""
+
+    @property
+    @abstractmethod
+    def user_state_dir(self) -> str:
+        """:returns: state directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_state_dir(self) -> str:
+        """:returns: state directory shared by users"""
+
+    @property
+    @abstractmethod
+    def user_log_dir(self) -> str:
+        """:returns: log directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_log_dir(self) -> str:
+        """:returns: log directory shared by users"""
+
+    @property
+    @abstractmethod
+    def user_documents_dir(self) -> str:
+        """:returns: documents directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_downloads_dir(self) -> str:
+        """:returns: downloads directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_pictures_dir(self) -> str:
+        """:returns: pictures directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_videos_dir(self) -> str:
+        """:returns: videos directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_music_dir(self) -> str:
+        """:returns: music directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_desktop_dir(self) -> str:
+        """:returns: desktop directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_bin_dir(self) -> str:
+        """:returns: bin directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_bin_dir(self) -> str:
+        """:returns: bin directory shared by users"""
+
+    @property
+    @abstractmethod
+    def user_applications_dir(self) -> str:
+        """:returns: applications directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_applications_dir(self) -> str:
+        """:returns: applications directory shared by users"""
+
+    @property
+    @abstractmethod
+    def user_runtime_dir(self) -> str:
+        """:returns: runtime directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_runtime_dir(self) -> str:
+        """:returns: runtime directory shared by users"""
+
+    @property
+    def user_data_path(self) -> Path:
+        """:returns: data path tied to the user"""
+        return Path(self.user_data_dir)
+
+    @property
+    def site_data_path(self) -> Path:
+        """:returns: data path shared by users"""
+        return Path(self.site_data_dir)
+
+    @property
+    def user_config_path(self) -> Path:
+        """:returns: config path tied to the user"""
+        return Path(self.user_config_dir)
+
+    @property
+    def site_config_path(self) -> Path:
+        """:returns: config path shared by users"""
+        return Path(self.site_config_dir)
+
+    @property
+    def user_cache_path(self) -> Path:
+        """:returns: cache path tied to the user"""
+        return Path(self.user_cache_dir)
+
+    @property
+    def site_cache_path(self) -> Path:
+        """:returns: cache path shared by users"""
+        return Path(self.site_cache_dir)
+
+    @property
+    def user_state_path(self) -> Path:
+        """:returns: state path tied to the user"""
+        return Path(self.user_state_dir)
+
+    @property
+    def site_state_path(self) -> Path:
+        """:returns: state path shared by users"""
+        return Path(self.site_state_dir)
+
+    @property
+    def user_log_path(self) -> Path:
+        """:returns: log path tied to the user"""
+        return Path(self.user_log_dir)
+
+    @property
+    def site_log_path(self) -> Path:
+        """:returns: log path shared by users"""
+        return Path(self.site_log_dir)
+
+    @property
+    def user_documents_path(self) -> Path:
+        """:returns: documents path tied to the user"""
+        return Path(self.user_documents_dir)
+
+    @property
+    def user_downloads_path(self) -> Path:
+        """:returns: downloads path tied to the user"""
+        return Path(self.user_downloads_dir)
+
+    @property
+    def user_pictures_path(self) -> Path:
+        """:returns: pictures path tied to the user"""
+        return Path(self.user_pictures_dir)
+
+    @property
+    def user_videos_path(self) -> Path:
+        """:returns: videos path tied to the user"""
+        return Path(self.user_videos_dir)
+
+    @property
+    def user_music_path(self) -> Path:
+        """:returns: music path tied to the user"""
+        return Path(self.user_music_dir)
+
+    @property
+    def user_desktop_path(self) -> Path:
+        """:returns: desktop path tied to the user"""
+        return Path(self.user_desktop_dir)
+
+    @property
+    def user_bin_path(self) -> Path:
+        """:returns: bin path tied to the user"""
+        return Path(self.user_bin_dir)
+
+    @property
+    def site_bin_path(self) -> Path:
+        """:returns: bin path shared by users"""
+        return Path(self.site_bin_dir)
+
+    @property
+    def user_applications_path(self) -> Path:
+        """:returns: applications path tied to the user"""
+        return Path(self.user_applications_dir)
+
+    @property
+    def site_applications_path(self) -> Path:
+        """:returns: applications path shared by users"""
+        return Path(self.site_applications_dir)
+
+    @property
+    def user_runtime_path(self) -> Path:
+        """:returns: runtime path tied to the user"""
+        return Path(self.user_runtime_dir)
+
+    @property
+    def site_runtime_path(self) -> Path:
+        """:returns: 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_state_dirs(self) -> Iterator[str]:
+        """:yield: all user and site state directories."""
+        yield self.user_state_dir
+        yield self.site_state_dir
+
+    def iter_log_dirs(self) -> Iterator[str]:
+        """:yield: all user and site log directories."""
+        yield self.user_log_dir
+        yield self.site_log_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_state_paths(self) -> Iterator[Path]:
+        """:yield: all user and site state paths."""
+        for path in self.iter_state_dirs():
+            yield Path(path)
+
+    def iter_log_paths(self) -> Iterator[Path]:
+        """:yield: all user and site log paths."""
+        for path in self.iter_log_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/env/lib/python3.12/site-packages/platformdirs/macos.py b/env/lib/python3.12/site-packages/platformdirs/macos.py
new file mode 100644
index 0000000..2493246
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs/macos.py
@@ -0,0 +1,187 @@
+"""macOS."""
+
+from __future__ import annotations
+
+import os.path
+import sys
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from collections.abc import Iterator
+
+from ._xdg import XDGMixin
+from .api import PlatformDirsABC
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+class _MacOSDefaults(PlatformDirsABC):  # noqa: PLR0904
+    """Default platform directories for macOS without XDG environment variable overrides.
+
+    Follows the guidance from `Apple's File System Programming Guide
+    `_.
+    The XDG env var handling is in :class:`~platformdirs._xdg.XDGMixin`.
+
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """:returns: 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_dirs(self) -> list[str]:
+        is_homebrew = "/opt/python" in sys.prefix
+        homebrew_prefix = sys.prefix.split("/opt/python")[0] if is_homebrew else ""
+        path_list = [self._append_app_name_and_version(f"{homebrew_prefix}/share")] if is_homebrew else []
+        path_list.append(self._append_app_name_and_version("/Library/Application Support"))
+        return path_list
+
+    @property
+    def site_data_path(self) -> Path:
+        """:returns: 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:
+        """:returns: config directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def _site_config_dirs(self) -> list[str]:
+        return self._site_data_dirs
+
+    @property
+    def user_cache_dir(self) -> str:
+        """:returns: 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:
+        """:returns: cache directory shared by users, e.g. ``/Library/Caches/$appname/$version``. If we're using a Python binary managed by `Homebrew `_, the directory will be under the Homebrew prefix, e.g. ``$homebrew_prefix/var/cache/$appname/$version``. If `multipath ` is enabled, and we're in Homebrew, the response is a multi-path string separated by ":", e.g. ``$homebrew_prefix/var/cache/$appname/$version:/Library/Caches/$appname/$version``"""
+        is_homebrew = "/opt/python" in sys.prefix
+        homebrew_prefix = sys.prefix.split("/opt/python")[0] if is_homebrew else ""
+        path_list = [self._append_app_name_and_version(f"{homebrew_prefix}/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 site_cache_path(self) -> Path:
+        """:returns: 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:
+        """:returns: state directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def site_state_dir(self) -> str:
+        """:returns: state directory shared by users, same as `site_data_dir`"""
+        return self.site_data_dir
+
+    @property
+    def user_log_dir(self) -> str:
+        """:returns: 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 site_log_dir(self) -> str:
+        """:returns: log directory shared by users, e.g. ``/Library/Logs/$appname/$version``"""
+        return self._append_app_name_and_version("/Library/Logs")
+
+    @property
+    def user_documents_dir(self) -> str:
+        """:returns: documents directory tied to the user, e.g. ``~/Documents``"""
+        return os.path.expanduser("~/Documents")  # noqa: PTH111
+
+    @property
+    def user_downloads_dir(self) -> str:
+        """:returns: downloads directory tied to the user, e.g. ``~/Downloads``"""
+        return os.path.expanduser("~/Downloads")  # noqa: PTH111
+
+    @property
+    def user_pictures_dir(self) -> str:
+        """:returns: pictures directory tied to the user, e.g. ``~/Pictures``"""
+        return os.path.expanduser("~/Pictures")  # noqa: PTH111
+
+    @property
+    def user_videos_dir(self) -> str:
+        """:returns: videos directory tied to the user, e.g. ``~/Movies``"""
+        return os.path.expanduser("~/Movies")  # noqa: PTH111
+
+    @property
+    def user_music_dir(self) -> str:
+        """:returns: music directory tied to the user, e.g. ``~/Music``"""
+        return os.path.expanduser("~/Music")  # noqa: PTH111
+
+    @property
+    def user_desktop_dir(self) -> str:
+        """:returns: desktop directory tied to the user, e.g. ``~/Desktop``"""
+        return os.path.expanduser("~/Desktop")  # noqa: PTH111
+
+    @property
+    def user_bin_dir(self) -> str:
+        """:returns: bin directory tied to the user, e.g. ``~/.local/bin``"""
+        return os.path.expanduser("~/.local/bin")  # noqa: PTH111
+
+    @property
+    def site_bin_dir(self) -> str:
+        """:returns: bin directory shared by users, e.g. ``/usr/local/bin``"""
+        return "/usr/local/bin"
+
+    @property
+    def user_applications_dir(self) -> str:
+        """:returns: applications directory tied to the user, e.g. ``~/Applications``"""
+        return os.path.expanduser("~/Applications")  # noqa: PTH111
+
+    @property
+    def _site_applications_dirs(self) -> list[str]:
+        return ["/Applications"]
+
+    @property
+    def site_applications_dir(self) -> str:
+        """:returns: applications directory shared by users, e.g. ``/Applications``"""
+        dirs = self._site_applications_dirs
+        return os.pathsep.join(dirs) if self.multipath else dirs[0]
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """:returns: 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:
+        """:returns: runtime directory shared by users, same as `user_runtime_dir`"""
+        return self.user_runtime_dir
+
+    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
+
+
+class MacOS(XDGMixin, _MacOSDefaults):
+    """Platform directories for the macOS operating system.
+
+    Follows the guidance from `Apple documentation
+    `_.
+    Makes use of the `appname `, `version
+    `, `ensure_exists `.
+
+    XDG environment variables (e.g. ``$XDG_DATA_HOME``) are supported and take precedence over macOS defaults.
+
+    """
+
+
+__all__ = [
+    "MacOS",
+]
diff --git a/env/lib/python3.12/site-packages/platformdirs/py.typed b/env/lib/python3.12/site-packages/platformdirs/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/env/lib/python3.12/site-packages/platformdirs/unix.py b/env/lib/python3.12/site-packages/platformdirs/unix.py
new file mode 100644
index 0000000..53cba33
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs/unix.py
@@ -0,0 +1,293 @@
+"""Unix."""
+
+from __future__ import annotations
+
+import os
+import sys
+from configparser import ConfigParser
+from functools import cached_property
+from pathlib import Path
+from tempfile import gettempdir
+from typing import TYPE_CHECKING, NoReturn
+
+from ._xdg import XDGMixin
+from .api import PlatformDirsABC
+
+if TYPE_CHECKING:
+    from collections.abc import Iterator
+
+if sys.platform == "win32":
+
+    def getuid() -> NoReturn:
+        msg = "should only be used on Unix"
+        raise RuntimeError(msg)
+
+else:
+    from os import getuid
+
+
+class _UnixDefaults(PlatformDirsABC):  # noqa: PLR0904
+    """Default directories for Unix/Linux without XDG environment variable overrides.
+
+    The XDG env var handling is in :class:`~platformdirs._xdg.XDGMixin`.
+
+    """
+
+    @cached_property
+    def _use_site(self) -> bool:
+        return self.use_site_for_root and getuid() == 0
+
+    @property
+    def user_data_dir(self) -> str:
+        """:returns: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or ``$XDG_DATA_HOME/$appname/$version``"""
+        return self._append_app_name_and_version(os.path.expanduser("~/.local/share"))  # noqa: PTH111
+
+    @property
+    def _site_data_dirs(self) -> list[str]:
+        return [self._append_app_name_and_version("/usr/local/share"), self._append_app_name_and_version("/usr/share")]
+
+    @property
+    def user_config_dir(self) -> str:
+        """:returns: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version``"""
+        return self._append_app_name_and_version(os.path.expanduser("~/.config"))  # noqa: PTH111
+
+    @property
+    def _site_config_dirs(self) -> list[str]:
+        return [self._append_app_name_and_version("/etc/xdg")]
+
+    @property
+    def user_cache_dir(self) -> str:
+        """:returns: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``$XDG_CACHE_HOME/$appname/$version``"""
+        return self._append_app_name_and_version(os.path.expanduser("~/.cache"))  # noqa: PTH111
+
+    @property
+    def site_cache_dir(self) -> str:
+        """:returns: 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:
+        """:returns: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version``"""
+        return self._append_app_name_and_version(os.path.expanduser("~/.local/state"))  # noqa: PTH111
+
+    @property
+    def site_state_dir(self) -> str:
+        """:returns: state directory shared by users, e.g. ``/var/lib/$appname/$version``"""
+        return self._append_app_name_and_version("/var/lib")
+
+    @property
+    def user_log_dir(self) -> str:
+        """:returns: 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 site_log_dir(self) -> str:
+        """:returns: log directory shared by users, e.g. ``/var/log/$appname/$version``
+
+        Unlike `user_log_dir`, ``opinion`` has no effect since ``/var/log`` is inherently a log directory.
+
+        """
+        return self._append_app_name_and_version("/var/log")
+
+    @property
+    def user_documents_dir(self) -> str:
+        """:returns: 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:
+        """:returns: 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:
+        """:returns: 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:
+        """:returns: 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:
+        """:returns: 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:
+        """:returns: desktop directory tied to the user, e.g. ``~/Desktop``"""
+        return _get_user_media_dir("XDG_DESKTOP_DIR", "~/Desktop")
+
+    @property
+    def user_bin_dir(self) -> str:
+        """:returns: bin directory tied to the user, e.g. ``~/.local/bin``"""
+        return os.path.expanduser("~/.local/bin")  # noqa: PTH111
+
+    @property
+    def site_bin_dir(self) -> str:
+        """:returns: bin directory shared by users, e.g. ``/usr/local/bin``"""
+        return "/usr/local/bin"
+
+    @property
+    def user_applications_dir(self) -> str:
+        """:returns: applications directory tied to the user, e.g. ``~/.local/share/applications``"""
+        return os.path.join(os.path.expanduser("~/.local/share"), "applications")  # noqa: PTH111, PTH118
+
+    @property
+    def _site_applications_dirs(self) -> list[str]:
+        return [os.path.join(p, "applications") for p in ["/usr/local/share", "/usr/share"]]  # noqa: PTH118
+
+    @property
+    def site_applications_dir(self) -> str:
+        """:returns: applications directory shared by users, e.g. ``/usr/share/applications``"""
+        dirs = self._site_applications_dirs
+        return os.pathsep.join(dirs) if self.multipath else dirs[0]
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """:returns: runtime directory tied to the user, e.g. ``$XDG_RUNTIME_DIR/$appname/$version``.
+
+        If ``$XDG_RUNTIME_DIR`` is unset, tries the platform default (``/tmp/run/user/$(id -u)`` on OpenBSD, ``/var/run/user/$(id -u)`` on FreeBSD/NetBSD, ``/run/user/$(id -u)`` otherwise). If the default is not writable, falls back to a temporary directory.
+
+        """
+        if sys.platform.startswith("openbsd"):
+            path = f"/tmp/run/user/{getuid()}"  # noqa: S108
+        elif sys.platform.startswith(("freebsd", "netbsd")):
+            path = f"/var/run/user/{getuid()}"
+        else:
+            path = f"/run/user/{getuid()}"
+        if not os.access(path, os.W_OK):
+            path = f"{gettempdir()}/runtime-{getuid()}"
+        return self._append_app_name_and_version(path)
+
+    @property
+    def site_runtime_dir(self) -> str:
+        """:returns: 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.
+
+        """
+        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:
+        """:returns: 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:
+        """:returns: config path shared by 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:
+        """:returns: 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 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
+
+
+class Unix(XDGMixin, _UnixDefaults):
+    """On Unix/Linux, we follow the `XDG Basedir Spec `_.
+
+    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
+    `, `version `, `multipath
+    `, `opinion `, `ensure_exists
+    `.
+
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """:returns: data directory tied to the user, or site equivalent when root with ``use_site_for_root``"""
+        return self.site_data_dir if self._use_site else super().user_data_dir
+
+    @property
+    def user_config_dir(self) -> str:
+        """:returns: config directory tied to the user, or site equivalent when root with ``use_site_for_root``"""
+        return self.site_config_dir if self._use_site else super().user_config_dir
+
+    @property
+    def user_cache_dir(self) -> str:
+        """:returns: cache directory tied to the user, or site equivalent when root with ``use_site_for_root``"""
+        return self.site_cache_dir if self._use_site else super().user_cache_dir
+
+    @property
+    def user_state_dir(self) -> str:
+        """:returns: state directory tied to the user, or site equivalent when root with ``use_site_for_root``"""
+        return self.site_state_dir if self._use_site else super().user_state_dir
+
+    @property
+    def user_log_dir(self) -> str:
+        """:returns: log directory tied to the user, or site equivalent when root with ``use_site_for_root``"""
+        return self.site_log_dir if self._use_site else super().user_log_dir
+
+    @property
+    def user_applications_dir(self) -> str:
+        """:returns: applications directory tied to the user, or site equivalent when root with ``use_site_for_root``"""
+        return self.site_applications_dir if self._use_site else super().user_applications_dir
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """:returns: runtime directory tied to the user, or site equivalent when root with ``use_site_for_root``"""
+        return self.site_runtime_dir if self._use_site else super().user_runtime_dir
+
+    @property
+    def user_bin_dir(self) -> str:
+        """:returns: bin directory tied to the user, or site equivalent when root with ``use_site_for_root``"""
+        return self.site_bin_dir if self._use_site else super().user_bin_dir
+
+
+def _get_user_media_dir(env_var: str, fallback_tilde_path: str) -> str:
+    if media_dir := _get_user_dirs_folder(env_var):
+        return media_dir
+    return os.path.expanduser(fallback_tilde_path)  # noqa: PTH111
+
+
+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(os.path.expanduser("~/.config")) / "user-dirs.dirs"  # noqa: PTH111
+    if user_dirs_config_path.exists():
+        parser = ConfigParser()
+
+        with user_dirs_config_path.open() as stream:
+            parser.read_string(f"[top]\n{stream.read()}")
+
+        if key not in parser["top"]:
+            return None
+
+        path = parser["top"][key].strip('"')
+        return path.replace("$HOME", os.path.expanduser("~"))  # noqa: PTH111
+
+    return None
+
+
+__all__ = [
+    "Unix",
+]
diff --git a/env/lib/python3.12/site-packages/platformdirs/version.py b/env/lib/python3.12/site-packages/platformdirs/version.py
new file mode 100644
index 0000000..db2fb3f
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs/version.py
@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '4.9.2'
+__version_tuple__ = version_tuple = (4, 9, 2)
+
+__commit_id__ = commit_id = None
diff --git a/env/lib/python3.12/site-packages/platformdirs/windows.py b/env/lib/python3.12/site-packages/platformdirs/windows.py
new file mode 100644
index 0000000..47403de
--- /dev/null
+++ b/env/lib/python3.12/site-packages/platformdirs/windows.py
@@ -0,0 +1,369 @@
+"""Windows."""
+
+from __future__ import annotations
+
+import os
+import sys
+from typing import TYPE_CHECKING, Final
+
+from .api import PlatformDirsABC
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+# Not exposed by CPython; defined in the Windows SDK (shlobj_core.h)
+_KF_FLAG_DONT_VERIFY: Final[int] = 0x00004000
+
+
+class Windows(PlatformDirsABC):  # noqa: PLR0904
+    """`MSDN on where to store app data files `_.
+
+    Makes use of the `appname `, `appauthor
+    `, `version `, `roaming
+    `, `opinion `, `ensure_exists
+    `.
+
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        r""":returns: 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:
+        r""":returns: 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:
+        """:returns: config directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def site_config_dir(self) -> str:
+        """:returns: config directory shared by users, same as `site_data_dir`"""
+        return self.site_data_dir
+
+    @property
+    def user_cache_dir(self) -> str:
+        r""":returns: 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:
+        r""":returns: 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:
+        """:returns: state directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def site_state_dir(self) -> str:
+        """:returns: state directory shared by users, same as `site_data_dir`"""
+        return self.site_data_dir
+
+    @property
+    def user_log_dir(self) -> str:
+        """:returns: 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 site_log_dir(self) -> str:
+        """:returns: log directory shared by users, same as `site_data_dir` if not opinionated else ``Logs`` in it"""
+        path = self.site_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:
+        r""":returns: 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:
+        r""":returns: 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:
+        r""":returns: 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:
+        r""":returns: 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:
+        r""":returns: 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:
+        r""":returns: desktop directory tied to the user, e.g. ``%USERPROFILE%\Desktop``"""
+        return os.path.normpath(get_win_folder("CSIDL_DESKTOPDIRECTORY"))
+
+    @property
+    def user_bin_dir(self) -> str:
+        r""":returns: bin directory tied to the user, e.g. ``%LOCALAPPDATA%\Programs``"""
+        return os.path.normpath(os.path.join(get_win_folder("CSIDL_LOCAL_APPDATA"), "Programs"))  # noqa: PTH118
+
+    @property
+    def site_bin_dir(self) -> str:
+        """:returns: bin directory shared by users, e.g. ``C:\\ProgramData\bin``"""
+        return os.path.normpath(os.path.join(get_win_folder("CSIDL_COMMON_APPDATA"), "bin"))  # noqa: PTH118
+
+    @property
+    def user_applications_dir(self) -> str:
+        r""":returns: applications directory tied to the user, e.g. ``Start Menu\Programs``"""
+        return os.path.normpath(get_win_folder("CSIDL_PROGRAMS"))
+
+    @property
+    def site_applications_dir(self) -> str:
+        r""":returns: applications directory shared by users, e.g. ``C:\ProgramData\Microsoft\Windows\Start Menu\Programs``"""
+        return os.path.normpath(get_win_folder("CSIDL_COMMON_PROGRAMS"))
+
+    @property
+    def user_runtime_dir(self) -> str:
+        r""":returns: 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:
+        """:returns: 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:  # noqa: PLR0911
+    """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
+
+    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
+
+    if csidl_name == "CSIDL_PROGRAMS":
+        return os.path.join(  # noqa: PTH118
+            os.path.normpath(os.environ["APPDATA"]),
+            "Microsoft",
+            "Windows",
+            "Start Menu",
+            "Programs",
+        )
+
+    if csidl_name == "CSIDL_COMMON_PROGRAMS":
+        return os.path.join(  # noqa: PTH118
+            os.path.normpath(os.environ.get("PROGRAMDATA", os.environ.get("ALLUSERSPROFILE", "C:\\ProgramData"))),
+            "Microsoft",
+            "Windows",
+            "Start Menu",
+            "Programs",
+        )
+    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.
+
+    """
+    machine_names = {
+        "CSIDL_COMMON_APPDATA",
+        "CSIDL_COMMON_PROGRAMS",
+    }
+    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",
+        "CSIDL_PROGRAMS": "Programs",
+        "CSIDL_COMMON_PROGRAMS": "Common Programs",
+    }.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  # noqa: PLC0415
+
+    # Use HKEY_LOCAL_MACHINE for system-wide folders, HKEY_CURRENT_USER for user-specific folders
+    hkey = winreg.HKEY_LOCAL_MACHINE if csidl_name in machine_names else winreg.HKEY_CURRENT_USER
+
+    key = winreg.OpenKey(hkey, r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders")
+    directory, _ = winreg.QueryValueEx(key, shell_folder_name)
+    return str(directory)
+
+
+_KNOWN_FOLDER_GUIDS: dict[str, str] = {
+    "CSIDL_APPDATA": "{3EB685DB-65F9-4CF6-A03A-E3EF65729F3D}",
+    "CSIDL_COMMON_APPDATA": "{62AB5D82-FDC1-4DC3-A9DD-070D1D495D97}",
+    "CSIDL_LOCAL_APPDATA": "{F1B32785-6FBA-4FCF-9D55-7B8E7F157091}",
+    "CSIDL_PERSONAL": "{FDD39AD0-238F-46AF-ADB4-6C85480369C7}",
+    "CSIDL_MYPICTURES": "{33E28130-4E1E-4676-835A-98395C3BC3BB}",
+    "CSIDL_MYVIDEO": "{18989B1D-99B5-455B-841C-AB7C74E4DDFC}",
+    "CSIDL_MYMUSIC": "{4BD8D571-6D19-48D3-BE97-422220080E43}",
+    "CSIDL_DOWNLOADS": "{374DE290-123F-4565-9164-39C4925E467B}",
+    "CSIDL_DESKTOPDIRECTORY": "{B4BFCC3A-DB2C-424C-B029-7FE99A87C641}",
+    "CSIDL_PROGRAMS": "{A77F5D77-2E2B-44C3-A6A2-ABA601054A51}",
+    "CSIDL_COMMON_PROGRAMS": "{0139D44E-6AFE-49F2-8690-3DAFCAE6FFB8}",
+}
+
+
+def get_win_folder_via_ctypes(csidl_name: str) -> str:
+    """Get folder via :func:`SHGetKnownFolderPath`.
+
+    See https://learn.microsoft.com/en-us/windows/win32/api/shlobj_core/nf-shlobj_core-shgetknownfolderpath.
+
+    """
+    if sys.platform != "win32":  # only needed for type checker to know that this code runs only on Windows
+        raise NotImplementedError
+    from ctypes import HRESULT, POINTER, Structure, WinDLL, byref, create_unicode_buffer, wintypes  # noqa: PLC0415
+
+    class _GUID(Structure):
+        _fields_ = [
+            ("Data1", wintypes.DWORD),
+            ("Data2", wintypes.WORD),
+            ("Data3", wintypes.WORD),
+            ("Data4", wintypes.BYTE * 8),
+        ]
+
+    ole32 = WinDLL("ole32")
+    ole32.CLSIDFromString.restype = HRESULT
+    ole32.CLSIDFromString.argtypes = [wintypes.LPCOLESTR, POINTER(_GUID)]
+    ole32.CoTaskMemFree.restype = None
+    ole32.CoTaskMemFree.argtypes = [wintypes.LPVOID]
+
+    shell32 = WinDLL("shell32")
+    shell32.SHGetKnownFolderPath.restype = HRESULT
+    shell32.SHGetKnownFolderPath.argtypes = [POINTER(_GUID), wintypes.DWORD, wintypes.HANDLE, POINTER(wintypes.LPWSTR)]
+
+    kernel32 = WinDLL("kernel32")
+    kernel32.GetShortPathNameW.restype = wintypes.DWORD
+    kernel32.GetShortPathNameW.argtypes = [wintypes.LPWSTR, wintypes.LPWSTR, wintypes.DWORD]
+
+    folder_guid = _KNOWN_FOLDER_GUIDS.get(csidl_name)
+    if folder_guid is None:
+        msg = f"Unknown CSIDL name: {csidl_name}"
+        raise ValueError(msg)
+
+    guid = _GUID()
+    ole32.CLSIDFromString(folder_guid, byref(guid))
+
+    path_ptr = wintypes.LPWSTR()
+    shell32.SHGetKnownFolderPath(byref(guid), _KF_FLAG_DONT_VERIFY, None, byref(path_ptr))
+    result = path_ptr.value
+    ole32.CoTaskMemFree(path_ptr)
+
+    if result is None:
+        msg = f"SHGetKnownFolderPath returned NULL for {csidl_name}"
+        raise ValueError(msg)
+
+    if any(ord(c) > 255 for c in result):  # noqa: PLR2004
+        buf = create_unicode_buffer(1024)
+        if kernel32.GetShortPathNameW(result, buf, 1024):
+            result = buf.value
+
+    return result
+
+
+def _pick_get_win_folder() -> Callable[[str], str]:
+    """Select the best method to resolve Windows folder paths: ctypes, then registry, then environment variables."""
+    try:
+        import ctypes  # noqa: PLC0415, F401
+    except ImportError:
+        pass
+    else:
+        return get_win_folder_via_ctypes
+    try:
+        import winreg  # noqa: PLC0415, F401
+    except ImportError:
+        return get_win_folder_from_env_vars
+    else:
+        return get_win_folder_from_registry
+
+
+_resolve_win_folder = _pick_get_win_folder()
+
+
+def get_win_folder(csidl_name: str) -> str:
+    """Get a Windows folder path, checking for ``WIN_PD_OVERRIDE_*`` environment variable overrides first.
+
+    For example, ``CSIDL_LOCAL_APPDATA`` can be overridden by setting ``WIN_PD_OVERRIDE_LOCAL_APPDATA``.
+
+    """
+    env_var = f"WIN_PD_OVERRIDE_{csidl_name.removeprefix('CSIDL_')}"
+    if override := os.environ.get(env_var, "").strip():
+        return override
+    return _resolve_win_folder(csidl_name)
+
+
+__all__ = [
+    "Windows",
+]
diff --git a/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/INSTALLER b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/METADATA b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/METADATA
new file mode 100644
index 0000000..0dd40dc
--- /dev/null
+++ b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/METADATA
@@ -0,0 +1,443 @@
+Metadata-Version: 2.4
+Name: propcache
+Version: 0.4.1
+Summary: Accelerated property cache
+Home-page: https://github.com/aio-libs/propcache
+Author: Andrew Svetlov
+Author-email: andrew.svetlov@gmail.com
+Maintainer: aiohttp team 
+Maintainer-email: team@aiohttp.org
+License: Apache-2.0
+Project-URL: Chat: Matrix, https://matrix.to/#/#aio-libs:matrix.org
+Project-URL: Chat: Matrix Space, https://matrix.to/#/#aio-libs-space:matrix.org
+Project-URL: CI: GitHub Workflows, https://github.com/aio-libs/propcache/actions?query=branch:master
+Project-URL: Code of Conduct, https://github.com/aio-libs/.github/blob/master/CODE_OF_CONDUCT.md
+Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/propcache
+Project-URL: Docs: Changelog, https://propcache.readthedocs.io/en/latest/changes/
+Project-URL: Docs: RTD, https://propcache.readthedocs.io
+Project-URL: GitHub: issues, https://github.com/aio-libs/propcache/issues
+Project-URL: GitHub: repo, https://github.com/aio-libs/propcache
+Keywords: cython,cext,propcache
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Cython
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+License-File: NOTICE
+Dynamic: license-file
+
+propcache
+=========
+
+The module provides a fast implementation of cached properties for Python 3.9+.
+
+.. image:: https://github.com/aio-libs/propcache/actions/workflows/ci-cd.yml/badge.svg
+  :target: https://github.com/aio-libs/propcache/actions?query=workflow%3ACI
+  :align: right
+
+.. image:: https://codecov.io/gh/aio-libs/propcache/branch/master/graph/badge.svg
+  :target: https://codecov.io/gh/aio-libs/propcache
+
+.. image:: https://badge.fury.io/py/propcache.svg
+    :target: https://badge.fury.io/py/propcache
+
+
+.. image:: https://readthedocs.org/projects/propcache/badge/?version=latest
+    :target: https://propcache.readthedocs.io
+
+
+.. image:: https://img.shields.io/pypi/pyversions/propcache.svg
+    :target: https://pypi.python.org/pypi/propcache
+
+.. image:: https://img.shields.io/matrix/aio-libs:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat
+   :target: https://matrix.to/#/%23aio-libs:matrix.org
+   :alt: Matrix Room — #aio-libs:matrix.org
+
+.. image:: https://img.shields.io/matrix/aio-libs-space:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs-space%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat
+   :target: https://matrix.to/#/%23aio-libs-space:matrix.org
+   :alt: Matrix Space — #aio-libs-space:matrix.org
+
+Introduction
+------------
+
+The API is designed to be nearly identical to the built-in ``functools.cached_property`` class,
+except for the additional ``under_cached_property`` class which uses ``self._cache``
+instead of ``self.__dict__`` to store the cached values and prevents ``__set__`` from being called.
+
+For full documentation please read https://propcache.readthedocs.io.
+
+Installation
+------------
+
+::
+
+   $ pip install propcache
+
+The library is Python 3 only!
+
+PyPI contains binary wheels for Linux, Windows and MacOS.  If you want to install
+``propcache`` on another operating system where wheels are not provided,
+the the tarball will be used to compile the library from
+the source code. It requires a C compiler and and Python headers installed.
+
+To skip the compilation you must explicitly opt-in by using a PEP 517
+configuration setting ``pure-python``, or setting the ``PROPCACHE_NO_EXTENSIONS``
+environment variable to a non-empty value, e.g.:
+
+.. code-block:: console
+
+   $ pip install propcache --config-settings=pure-python=false
+
+Please note that the pure-Python (uncompiled) version is much slower. However,
+PyPy always uses a pure-Python implementation, and, as such, it is unaffected
+by this variable.
+
+
+API documentation
+------------------
+
+The documentation is located at https://propcache.readthedocs.io.
+
+Source code
+-----------
+
+The project is hosted on GitHub_
+
+Please file an issue on the `bug tracker
+`_ if you have found a bug
+or have some suggestion in order to improve the library.
+
+Discussion list
+---------------
+
+*aio-libs* google group: https://groups.google.com/forum/#!forum/aio-libs
+
+Feel free to post your questions and ideas here.
+
+
+Authors and License
+-------------------
+
+The ``propcache`` package is derived from ``yarl`` which is written by Andrew Svetlov.
+
+It's *Apache 2* licensed and freely available.
+
+
+.. _GitHub: https://github.com/aio-libs/propcache
+
+=========
+Changelog
+=========
+
+..
+    You should *NOT* be adding new change log entries to this file, this
+    file is managed by towncrier. You *may* edit previous change logs to
+    fix problems like typo corrections or such.
+    To add a new change log entry, please see
+    https://pip.pypa.io/en/latest/development/#adding-a-news-entry
+    we named the news folder "changes".
+
+    WARNING: Don't drop the next directive!
+
+.. towncrier release notes start
+
+0.4.1
+=====
+
+*(2025-10-08)*
+
+
+Bug fixes
+---------
+
+- Fixed reference leak caused by ``Py_INCREF`` because Cython has its own reference counter systems -- by `@Vizonex `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#162 `__.
+
+
+Contributor-facing changes
+--------------------------
+
+- Fixes the default value for the ``os``
+  parameter in ``reusable-build-wheel.yml``
+  to be ``ubuntu-latest`` instead of
+  ``ubuntu``.
+
+  *Related issues and pull requests on GitHub:*
+  `#155 `__.
+
+
+----
+
+
+0.4.0
+=====
+
+*(2025-10-04)*
+
+
+Features
+--------
+
+- Optimized propcache by replacing sentinel ``object`` for checking if
+  the ``object`` is ``NULL`` and changed ``dict`` API for
+  Python C-API -- by `@Vizonex `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#121 `__.
+
+
+Contributor-facing changes
+--------------------------
+
+- Builds have been added for arm64 Windows
+  wheels and the ``reusable-build-wheel.yml``
+  workflow has been modified to allow for
+  an OS value (``windows-11-arm``) which
+  does not include the ``-latest`` postfix
+  -- by `@finnagin `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#133 `__.
+
+- Added CI for CPython 3.14 -- by `@kumaraditya303 `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#140 `__.
+
+
+----
+
+
+0.3.2
+=====
+
+*(2025-06-09)*
+
+
+Improved documentation
+----------------------
+
+- Fixed incorrect decorator usage in the ``~propcache.api.under_cached_property`` example code -- by `@meanmail `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#109 `__.
+
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Updated to use Cython 3.1 universally across the build path -- by `@lysnikolaou `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#117 `__.
+
+- Made Cython line tracing opt-in via the ``with-cython-tracing`` build config setting -- by `@bdraco `__.
+
+  Previously, line tracing was enabled by default in ``pyproject.toml``, which caused build issues for some users and made wheels nearly twice as slow.
+
+  Now line tracing is only enabled when explicitly requested via ``pip install . --config-setting=with-cython-tracing=true`` or by setting the ``PROPCACHE_CYTHON_TRACING`` environment variable.
+
+  *Related issues and pull requests on GitHub:*
+  `#118 `__.
+
+
+----
+
+
+0.3.1
+=====
+
+*(2025-03-25)*
+
+
+Bug fixes
+---------
+
+- Improved typing annotations, fixing some type errors under correct usage
+  and improving typing robustness generally -- by `@Dreamsorcerer `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#103 `__.
+
+
+----
+
+
+0.3.0
+=====
+
+*(2025-02-20)*
+
+
+Features
+--------
+
+- Implemented support for the free-threaded build of CPython 3.13 -- by `@lysnikolaou `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#84 `__.
+
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Started building wheels for the free-threaded build of CPython 3.13 -- by `@lysnikolaou `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#84 `__.
+
+
+Contributor-facing changes
+--------------------------
+
+- GitHub Actions CI/CD is now configured to manage caching pip-ecosystem
+  dependencies using `re-actors/cache-python-deps`_ -- an action by
+  `@webknjaz `__ that takes into account ABI stability and the exact
+  version of Python runtime.
+
+  .. _`re-actors/cache-python-deps`:
+     https://github.com/marketplace/actions/cache-python-deps
+
+  *Related issues and pull requests on GitHub:*
+  `#93 `__.
+
+
+----
+
+
+0.2.1
+=====
+
+*(2024-12-01)*
+
+
+Bug fixes
+---------
+
+- Stopped implicitly allowing the use of Cython pre-release versions when
+  building the distribution package -- by `@ajsanchezsanz `__ and
+  `@markgreene74 `__.
+
+  *Related commits on GitHub:*
+  `64df0a6 `__.
+
+- Fixed ``wrapped`` and ``func`` not being accessible in the Cython versions of ``propcache.api.cached_property`` and ``propcache.api.under_cached_property`` decorators -- by `@bdraco `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#72 `__.
+
+
+Removals and backward incompatible breaking changes
+---------------------------------------------------
+
+- Removed support for Python 3.8 as it has reached end of life -- by `@bdraco `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#57 `__.
+
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Stopped implicitly allowing the use of Cython pre-release versions when
+  building the distribution package -- by `@ajsanchezsanz `__ and
+  `@markgreene74 `__.
+
+  *Related commits on GitHub:*
+  `64df0a6 `__.
+
+
+----
+
+
+0.2.0
+=====
+
+*(2024-10-07)*
+
+
+Bug fixes
+---------
+
+- Fixed loading the C-extensions on Python 3.8 -- by `@bdraco `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#26 `__.
+
+
+Features
+--------
+
+- Improved typing for the ``propcache.api.under_cached_property`` decorator -- by `@bdraco `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#38 `__.
+
+
+Improved documentation
+----------------------
+
+- Added API documentation for the ``propcache.api.cached_property`` and ``propcache.api.under_cached_property`` decorators -- by `@bdraco `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#16 `__.
+
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Moved ``propcache.api.under_cached_property`` and ``propcache.api.cached_property`` to `propcache.api` -- by `@bdraco `__.
+
+  Both decorators remain importable from the top-level package, however importing from `propcache.api` is now the recommended way to use them.
+
+  *Related issues and pull requests on GitHub:*
+  `#19 `__, `#24 `__, `#32 `__.
+
+- Converted project to use a src layout -- by `@bdraco `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#22 `__, `#29 `__, `#37 `__.
+
+
+----
+
+
+0.1.0
+=====
+
+*(2024-10-03)*
+
+
+Features
+--------
+
+- Added ``armv7l`` wheels -- by `@bdraco `__.
+
+  *Related issues and pull requests on GitHub:*
+  `#5 `__.
+
+
+----
+
+
+0.0.0
+=====
+
+*(2024-10-02)*
+
+
+- Initial release.
diff --git a/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/RECORD b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/RECORD
new file mode 100644
index 0000000..403567c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/RECORD
@@ -0,0 +1,18 @@
+propcache-0.4.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+propcache-0.4.1.dist-info/METADATA,sha256=_CPzxSszbVM1zQU_R9kf9jFpSeZa0fHj38zVKE9Nbs4,13745
+propcache-0.4.1.dist-info/RECORD,,
+propcache-0.4.1.dist-info/WHEEL,sha256=AwHYJA1Do1jwgPIoLQR4DiHSeYY_vU6Ht9Vljq5Yt_M,112
+propcache-0.4.1.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+propcache-0.4.1.dist-info/licenses/NOTICE,sha256=VtasbIEFwKUTBMIdsGDjYa-ajqCvmnXCOcKLXRNpODg,609
+propcache-0.4.1.dist-info/top_level.txt,sha256=pVF_GbqSAITPMiX27kfU3QP9-ufhRvkADmudDxWdF3w,10
+propcache/__init__.py,sha256=8kebeGvYn7s-ow1AFmK0A4EvonZMpyM7Lkzs2Ktia3Y,965
+propcache/__pycache__/__init__.cpython-312.pyc,,
+propcache/__pycache__/_helpers.cpython-312.pyc,,
+propcache/__pycache__/_helpers_py.cpython-312.pyc,,
+propcache/__pycache__/api.cpython-312.pyc,,
+propcache/_helpers.py,sha256=68SQm6kETN8Mnt9Ol26LJYgHgmB0mKy1tp92888zN4k,1553
+propcache/_helpers_c.cpython-312-x86_64-linux-musl.so,sha256=T1Gldl8ngpudzNUlerhFL-eA66RMhM8vPZXiSWGnUCI,553056
+propcache/_helpers_c.pyx,sha256=kcJa1U5lh54TPCqAeZ0cVB7URcb3I8ZbJieOrkNhLQE,3265
+propcache/_helpers_py.py,sha256=Wixs2zWA-FBU-j4zLPyBUU24FEfPhKk-UunFSp9q95U,1909
+propcache/api.py,sha256=wvgB-ypkkI5uf72VVYl2NFGc_TnzUQA2CxC7dTlL5ak,179
+propcache/py.typed,sha256=ay5OMO475PlcZ_Fbun9maHW7Y6MBTk0UXL4ztHx3Iug,14
diff --git a/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/WHEEL b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/WHEEL
new file mode 100644
index 0000000..5b148ea
--- /dev/null
+++ b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp312-cp312-musllinux_1_2_x86_64
+
diff --git a/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/licenses/LICENSE b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/licenses/LICENSE
new file mode 100644
index 0000000..d645695
--- /dev/null
+++ b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/licenses/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   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.
diff --git a/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/licenses/NOTICE b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/licenses/NOTICE
new file mode 100644
index 0000000..fa53b2b
--- /dev/null
+++ b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/licenses/NOTICE
@@ -0,0 +1,13 @@
+   Copyright 2016-2021, Andrew Svetlov and aio-libs team
+
+   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.
diff --git a/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/top_level.txt b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/top_level.txt
new file mode 100644
index 0000000..8c9accf
--- /dev/null
+++ b/env/lib/python3.12/site-packages/propcache-0.4.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+propcache
diff --git a/env/lib/python3.12/site-packages/propcache/__init__.py b/env/lib/python3.12/site-packages/propcache/__init__.py
new file mode 100644
index 0000000..a6444d1
--- /dev/null
+++ b/env/lib/python3.12/site-packages/propcache/__init__.py
@@ -0,0 +1,32 @@
+"""propcache: An accelerated property cache for Python classes."""
+
+from typing import TYPE_CHECKING
+
+_PUBLIC_API = ("cached_property", "under_cached_property")
+
+__version__ = "0.4.1"
+__all__ = ()
+
+# Imports have moved to `propcache.api` in 0.2.0+.
+# This module is now a facade for the API.
+if TYPE_CHECKING:
+    from .api import cached_property as cached_property  # noqa: F401
+    from .api import under_cached_property as under_cached_property  # noqa: F401
+
+
+def _import_facade(attr: str) -> object:
+    """Import the public API from the `api` module."""
+    if attr in _PUBLIC_API:
+        from . import api  # pylint: disable=import-outside-toplevel
+
+        return getattr(api, attr)
+    raise AttributeError(f"module '{__package__}' has no attribute '{attr}'")
+
+
+def _dir_facade() -> list[str]:
+    """Include the public API in the module's dir() output."""
+    return [*_PUBLIC_API, *globals().keys()]
+
+
+__getattr__ = _import_facade
+__dir__ = _dir_facade
diff --git a/env/lib/python3.12/site-packages/propcache/_helpers.py b/env/lib/python3.12/site-packages/propcache/_helpers.py
new file mode 100644
index 0000000..1e52895
--- /dev/null
+++ b/env/lib/python3.12/site-packages/propcache/_helpers.py
@@ -0,0 +1,39 @@
+import os
+import sys
+from typing import TYPE_CHECKING
+
+__all__ = ("cached_property", "under_cached_property")
+
+
+NO_EXTENSIONS = bool(os.environ.get("PROPCACHE_NO_EXTENSIONS"))  # type: bool
+if sys.implementation.name != "cpython":
+    NO_EXTENSIONS = True
+
+
+# isort: off
+if TYPE_CHECKING:
+    from ._helpers_py import cached_property as cached_property_py
+    from ._helpers_py import under_cached_property as under_cached_property_py
+
+    cached_property = cached_property_py
+    under_cached_property = under_cached_property_py
+elif not NO_EXTENSIONS:  # pragma: no branch
+    try:
+        from ._helpers_c import cached_property as cached_property_c  # type: ignore[attr-defined, unused-ignore]
+        from ._helpers_c import under_cached_property as under_cached_property_c  # type: ignore[attr-defined, unused-ignore]
+
+        cached_property = cached_property_c
+        under_cached_property = under_cached_property_c
+    except ImportError:  # pragma: no cover
+        from ._helpers_py import cached_property as cached_property_py
+        from ._helpers_py import under_cached_property as under_cached_property_py
+
+        cached_property = cached_property_py  # type: ignore[assignment, misc]
+        under_cached_property = under_cached_property_py
+else:
+    from ._helpers_py import cached_property as cached_property_py
+    from ._helpers_py import under_cached_property as under_cached_property_py
+
+    cached_property = cached_property_py  # type: ignore[assignment, misc]
+    under_cached_property = under_cached_property_py
+# isort: on
diff --git a/env/lib/python3.12/site-packages/propcache/_helpers_c.cpython-312-x86_64-linux-musl.so b/env/lib/python3.12/site-packages/propcache/_helpers_c.cpython-312-x86_64-linux-musl.so
new file mode 100755
index 0000000000000000000000000000000000000000..84d0694bf0b84a4901b0ca99b717284c2912d76b
GIT binary patch
literal 553056
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	+Kyyf#1#AE`+nWrdma&pjFZDhW%VffO
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
$mauwzQDNSdZrWLsJBebfD^3;YrRvfN1Vo
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
ZD%yHCztL1ie6h&lQk;YIvWHe&T?!?t6KP_
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®?8`LsH@3$Xb((0N4T
zC~KFJ@x&`L(X1-IL%E11;9WGye!lK>w{07BNAav07RF*7Ii4Xm7`STxiStS~!<6J#
z{)s0);!yv?{EDY)|6}}$r}6!>`V~(#{3q}$evj6wzk^@#$5i%Q?U379O>3zv4lZH;$p88plvfFpi-JYaHW;+OZtX89N;=^GT1+eA2}-
zp0XTpf6$)OFrUJ&xCv~HV{Ayj;wB0#B|e2;@l?QP@++Q-q4~8A`4taAGR83i629MU
zC1F`vm}O>RmYsn)_m|ajwgg$q>+~zWzt)oV_A8z${}1#lZX#v+KDA%*i9X$a&v~*3
z{a&X9F<@Cx1}sHzuXCCYYxbN2y<)G^?>Wz3%JSmI0{5J=e#OTtt)^e`lnm$J+~=wA
zD{kmnC*tk;6;DI0+pl=ayPc_mwfu?)PQTe~L2Ops>?b6Cv-wsJ`U0>Z3c!L=0E%D%
z+~dQV8AG5~6ae?pl9L~I*2g4FQAUo|1Tl3@Lcrxdx?*|0J9
zFx9VkpyHaT+ul(G_b^}fQq3M_ptt2$yq{OCEx+O^y{2DrOU`)SZp*K@4PZM9x+^!Z
zk0wzO}@GVT1Y=4?-C$Ho@=LK@uC^SrC1+rAi;I2;T8|Ob1E5
z)gS2WqbvQ2zvqWR-OBz*$Hhv&;yK^@)6|spD<1INwRAhv@eV3PZdtYASNut@YLsik
zuXxIUN;RRDU-6Vg0NQ^|iU<6bqPrY<3#bae;ye2~SLs(=@!U{mQhM7{zy@?gUMFu&pl-W{sD
zoWJ`Ne#O&F_@C@oJWa(vgGYv2EXjbfnK$tfrWKo=hY?)qEpSln1of&7Z6;@bBseynETUdhhBOQJaoTD}M}ykBtzy+Vv~Gx2AN%`4vxPw&PdaFs;L{c;M8#^IA>$5*M}a{>*;G&%e)!uJkK@jmKv_
z%~r&{zJA41z2R1{qkhG0pbq;LPXn!=U-2~D`uP=4!?o>K-11a91n1p5^lO%-Ex+QH
zr&0`jwtnmj&iib&Ag)>{=zX>-tUg;6V|=zYE%NmbXP0npQ9<>fs+i!jwU>s#-NJIB
zp!eCTu=;FO441i4(%Xc$pvI^Ssn6COeV7`4#SMvbYw^mS
zKM@);HhJLTZiQ9_6hdCX;EXtsJE=3`w={r1V*8?(U*%Wa5`u?sx0^wQ;#C^Xokm@U
zU-6VZ<5xUH;=IH{Y(P}_6%S~C7x#$!U8Z=y;sI2@;@!3Ptn@2xD6A$Kzv3ya(y#cY
zUY@fM>Eed6Y0tV&zv3xtwO{d+)}CMS(SC`$4!`1oP5p|Wui+Z8gsJo^K0~QxP}k*G
z{MVuOg9RA;`{h)PW_4p49{=Y_ACAuO+W|yif5SDJ(
zivvAlKM=htNAbY!{faAyv}MWaS6o@z@+9V7ulVo%
z1jYLmzb+_8^BwtQjt99P!5%F|a8-Ysr@FG2rWOL!TGa=3@6=U6U-k+ku9$ws6;a_=
ze34NKQ>}cW2rBhxMk!fL1bQu{0=xGsuAtv)P&g1HBoYOgc@{=x$El7$#&#?xy!nN0GUi?ID(GGCDjdGIvMGM7
zdP>7p&}WRo=*(a`A%NXoGfy-^39KL!3E2u`X9|G>$O8=(e#M);py)IC74LwQHvEdG
zA#tq>M(f)4D_+t`MVo%bH`l~u{fa9dcaXea@!gfRO~2ypv3S4YDNCDv#Siomp_fd~
zzQR0@@Ae!QS7iJ}_uyQvr#8&B7JmA%@_yWy~
zT7JcsDOEe&8h*u}SFUWQTLUkhZVi0db-IR9yVErcZFRb5`cBvT6_0$rJ1eP4;z8|n
z6~X?kH55{jCnluR4fI<5TVVIyje;x&v_yqn|CWmtk@YLy%jhJ1t|F+@HW{6y&kgii
zIt6y`S6o5gwJ02P3W%&<@$G!1zEe}scWMgTPVH+xjL!`PeZQoz^h=mBC?exme0Pmm
z`eFr{r|63nc71UGaZ!~y{$o`k3;M*TWa(D}NV8^`GdBBHROwe-@swiuLTf`>0#93h
z#RGjuh7rHw0fS1`reE>!NttJXq*(_9EvsexiU)$68uA@Y`iPgDNeVwx~;f^
z*F9k^YDKj@sV8Yq>Ph%4@f_vb>wvhu?&1bP1kvWkpozoUk{a)ANsTYe<)zcP1&I{5
zP*()gQ4$9c<+U^&wYDsARGW@U)9^E#|Na@QPwpL!uQnYe;$S*zMfn2SmcF1t#P!9Y
zdzy_>(^1Ivk2O=qh)t(4g;~yc)J?^Oa*$_XadDf*qgIKvr&;CKQzKFh<3c9GR`uX$
zdT~XC5vi2nWRX8TV?+wRpBKU46)H$Hz5HyY5vlgVW{pT?MWDaP#m9~hn$f`VDjMX&
z3{-#dcB;7;k-Dkch}7xj=Q2j5_R$cdtBpuK8=uRR^A~S?j*EsT#Zn_u{XDkPh?L@e
zQ%hkq8%$I87Q`IUAlUov<-?kD
z&LKcm@5|7VXq!7MPufS~lSYg9WCr1x8jG<3P-(@Uk{Xec>@-HCEb}^~QyV?A7^eX<
zMx;i!V?^rN_*EK_dNm#+7IC66<#X$ukpr$qs}k$1dekx^#Y70TjYL-(k@9t@W-OQ>
zNe-zIsb}LkterKP&4pV%k2+S{2=+FO|OV%@NccO9}rv8B?*g4B`jY6D|&Z&b^@
zQ88EMh^s0(SL7}nO}e;nd~@Mw+@)4H^ahfo!7fRIU6PFXs8qotQQ*Qm$ng$xyvBNz
z;Wgzafhu)T;7o+KyTck!qs|wxfn=p;y?B
z`abq2etB@l7Kqm0G~y#IgQO>eV1hCTrpO}1c#FT-FN1YuqUsOAh;YylvB)yyNW8aU
zIf{a1&`9R_6!}{`3q0sMR|}$ZwV-saieTru*oQT@cmlnmbM?1)ZamwSkh{f`wH!4@
zX~uHYJs84KDvL4K(Nc+1PH#Et9!`aLwMVMArQ5uW$Yv3)F+d{|q6_9_!E%&D-cKSo
zmZMDUrtXPw1B<6ypCW&mCj=yjjm5uts=v&W_XD9X2MeMcEGXrm2$n;=4{HXwK(8nV
z|HW>uj=C3!<*1wTvpA!1g#-J>N){_h@UOXdL>BZ|;g{h_ttegK$0BmO5@7(tOa^u?
zj)9#^6$5$}iOkPHQe~jWAdr@*PkN?q
zwXEtiGeEm(u3|{jTust6SCLE_tI`Y=d_M?X?$rXVupG6c7>fG0AEVaqe*pd*@ZW-%
zk-uIoN7+oatw&{%JA)f48XEGWxV7jc}1=$JjLl)sNjZ?!$Ez!&UUWniSYn7rr5
z6Y=dzxrSQ7VnBsU+uo)8Y1ktOL)hzYcNv$e=BumYYu;$~M
z3f7~-O0u@~s5p?V<)|mT<)|m}CvXveLSec$6g52wX)5aS=uR58egk$ZQ;Sh4r?VJEUbzBvIc)FCtr0BxikNEs
zSw+fnzCcwcMVCg!y0w#X4QR=E{`Ehjzz>;GKm0Fn|JP8yG6Fs?hv6zducuZ6pw;m-
zp?Owm5~u6APWXqP_&_wmDkR(~65c>yN_qpKi^nSz!)oKB^=>&$6|+{HDb&KW9)-B|KQ-f~^=&xTIzX9-gZI;A$!!l5~>
z^HD6Qv*_ajo>f@1|Bf=Y;_mA+(F^R*W#lpxtiFWARhWc2NJCNlGqh7K;sf3{n0q~2
zr5P>7vyGr(DU59le5zECWSG%X*lskyxyVlr7Hv?~F?YtKiTXPwRU#fbDetu==Fun)?AjizvD#<1uqQ3kr!KRlCMT);m8CG
z_?s(4Nx-}LCMwp@KZMA)Mtoau`N}sKTE{3`4=4`|C|$1
zv8iZ8Y>X|%jh|p2^aMrp4rCZKRH9oOugZ-J=(3%>1EaNy>;8wAMF-zk!n(bsVxlffZAbtd{4X!Vb?
zI)!CgV?b%$DOG%$SP+|q7DOXfuy7Uw8>v@)JDDgWDrhxT}vij?*~Y(AA2m
zbZeL5VY0kQ0<{ahp5&502WIIQ73={JU#BeG^P&#Q0N<)jOKmF9ek43yMI#Hdd9!Ucl2<(9*ONj5!EkfoT~2}CMM9u25RxE>aNlBp
zSW%ur-yTz(w%R+?Qrc*F5Oh0eD5{kxh!%I~F~A%H^#%m>fL!x`TYC?{sH)|E{NCNU
zcQ+(J2mt|6g9s`L0#60&qZg$~v!P1}i$u~)QShq*q5=Yfg(4!xjs?Yr@DxP_8y0Ll
zD`H1%V8i;6oY>#fp^(hg?{I{g`@s@V#KS0;XfUCLouXbNHwg0kv8Q1bz6h4IpB=EMPmtClJ3Vj@z&+jgpAH5b{DBgm;4vDB2
zwNFQI4^MPKYua
zYGfCp<`v~=O*z_7`X!V-jdHTqv<2hOTvQ;=%GJ_d)J(H~V+`u!DHav5AEqbHW+PkY(I!
z8)j5h8RV)tv{4y4gPladp&U1V{|ixUZxCMYE#_A%VOGH6SqNfGTVcp@plG+p^QSjp$Tt@_7S4{yyxC-vuWQn0LZ
z`~?gw@Ru53se1LulBtqtD4nk8I+wbuTzsu^VFkGdZN>YfR1Xpc^CN|CBvkW}?Y1p$
z&=N*M!dH>#1qgo?S?Ad}R@DC9>MivZ0jp#{NhC%3Nm}MfkjbwS+G(}gd6Cegri1c2
z2z}uoE-DzsOWmFNL2(_|27u?iO)#4_6MZW6FLKnoTh`zycKb#2D&FtKKM)r`&QRbH
zTFp5kB@2=B1z*YhMRW~m*&FF;JdU!V(6+*+GFnpE%|>;%yHq_SUyoifIG#Hd|d6@27SzK~XN4ic7NZ)IaW|O?XWt{=Cd4^kw>#
zL!Z)ORLBC;k#x4&iGJOnR5x|<;7%9g;~07`vWve~Mz><0hpix$8$aM0%o7rWf8*8r
z-{6#RXcpd{g`!mKXKHpehwkE~e)#w`l7nNJyrc#i*3_uEtsCiPHN$ZiJ;~1+LB9P{
zMbDP%1SPe^jsd*vn?0j5=nmc%at8ezxf5@rGt)Dn8q32pdERZhoOJ`>juMGqXoNbP
zmK&dCf^zY^06b-Tr6rD@1AiKiysmHK`9VAN;(1&iFT&KOn-IV^rQVPtj2oG68CY28
zrc~b4E95+%l@dHNH8_l2cPqP*sWrbzwQYmBXjSQs&yC=jqJ=@?Tp$HD
zIw)NmkJkuFflwTSJ(RcPIO>xUL`sh5r9^8T{GKKOHk+7r_?%z2`+4L`?bK)*Cq&c{
z)~Dka{I2ycG?DR;Q%Fvtj$gvMudzc@O5||r_zCx)Pc;8OVlt#DYs^E+LgJ6RnlzT7CT+ikqo1aowo
zmmp3w=m{r_@QJDm?2Y)m+=8yW)-b~nK<%Kx2tWXQcBcf%Vnp5G&j!c!-!QyrchRbC
zn40BHA?#s=V+b)mqWEPPYWge0mBn%Tl>iivU8q%KCEhcV`4!^G@P{VYK#em&FmkSu
zX$jaQ*gOBd2Ao5@dCAm%OB5bN+hBNc6dLDZl7c_vC}(W3c`{neuVfiT_hU{fa^(O_
zN~xDRj6(Z~#=966ei)C&LqYVkP*CqwiG`481>Tj)AHP~sF&-fi1wTBMq`+{yiNXJj{b{yI;-ejw=}
zH1&f{gAF)soc5N+!P88@r<=)~@XTgLu4WT)wHBqHU)A2gkdV`OkQ+CN|4#adpOa@s
zU>9^(P^t%ic+oPQeU8hVbKGnA@#GqIbIt@u_gIRJ8f6X&#gWR2FiKHB*@g#RZvY
zz;7sOkYhKmvj!o$I(cD}s~%j(NkVN@CeAEWO(#7LSva#08BpG!;|E-gP{NJcpnW1b
zQAZ>i3Lub83(p0=CK4RJ+MB&%y
z7hU3D>2#y6n#v6Y<(#PyL~Hof+HU*`!;#JN7@h=q!o>^4@;xfyu+{=@mqSfZz-u``thc9CoMFUHu_3D2nayz*79x-6|A=@*P+TeU&2+#sgt>
zq6`aHm%mQZ?}icQxI*~2s?$6zctcLSVJ9`%#Vy=Pjhyi(Efv_{*VtfJ1o1RrgX(}Q
zRv}?R`GdUy_>1N4eGR~~exs=HS2VJ^5hGOu3eRXl%E
zWS>S!JSCo1H{v8(%q%BCn-q2a1$9<(4D?Bh;nX;a>mof41*o`K9z4T9(G+=UF(IB5
zwf}|ZrFE>sa7c^yFh!*gdVp}dl%1}hF1mg!jL9jKSNvm31u3W>8$1$0)Q=4kf^LKO
zLxz~we$gAkK`#^=IS0KV6xO{VD}?yxNS}N%BojSEg3=`fiJpTl0i~vj%3SBMa50{U
z#$Je;M8Q
zdXA#$?mTS(HNE=l2iyliz2T?f&uL@81#@@yMF?D^c+y99%5_@#oF5HE=8b}X<5ri
ze2USHt2Yu0f?U1fu)fF34^c?aWkMrF>dKxdQzjAe7r;
z!MQ$LAZGAo|WOeE@h^kYcK~%>2wDXkzs6NBYf2%$N#y!>N
z&nDBRJ|$@CQ^Hc8f`sbRpQ>A*sZR+?eOjdc`fO_0`Sen_KKBwlwLV)59hR)}D=>Zo4(XpQiBc!E98%pPD5qAW`UJgw0A&YR84XtQ~jB2P8x
zj~~!r*FUvCPjxyv&%ERAF}CaIgsOwwDk{{uVH_RdA&KS5$aaUpM^N6{qk=aBzVAU6
ze?oAckZ9Q!I68<$qwHct;y)WAwZ$_Q1bKHDdcH(!!;YRWh&`hN9bCW3G@V8E>aW2rA<6nyW#1qlKNAM!`(Ri2n99DX6
z^d?@~y(x;fbgSX_mgpS}+`)MoY4e1{o{WCNY@hJkNwM34^E8rvjsB+D*n3F%gmSP}
z&0ekLX)7#|)vv^ZYFX|w`+!hKZn#Kk5Jo>h)hRw!~*5UFleN{Lmz
zazLP6XE=8u0sKH4Q1};U|J#kZvG|6N23LhOh($w@%88Fly!Pq+7@D~7t2Bhdrh(>3
z@s~qs+z?75HB#q8;_V|qG{nyrK*fbZUkAlAla9aDBtg#J+#2@oh1y&ky#bYq*!X8Q
z7ETYImcB4SUWE<^b&^27H3Yo+#vi|-(V84gDbe=G|4`eo(}?LVF}zFb0^a`UpzaE6
zHrY0W!`e2Wa)iR#2Hucrx!4rD@k30oA%eUR7XbY73!8H2{v6A|W4*lmg6E-KR`oei
zH5aP>AI3p7_hVt6`@u8eR!hZ&HRLJGyMo=gN4W29F62)4WGwptlOB5fP&Hj+I|C7c9Jjq*NM_>!=J=#L4
zih=lhg`B62o43QCc3mP@PBc>m{y2%pln@NaX4REvM(3*j$+c@gX(>yB-y03CfZ^2U
z=(fmC^XuCP-eJUMRSEHPF4e+x3(Cp!s?Z6?nnMjbDx3;8Vorv?KXkv~>5DJi?>U>d
zMc(FJPb?l4hN7~i!aEjGLxW7NRND;&sYf3?^r6CpK&^^kw(nHK!50L=_Xr2^z#R@E
zH3{-2Q{J2ITZ9{(-DIjB03rH7n`_lwQi7^UPO$OL;mFgV8QdiKr|D
zcyWuWRq;?z@+Jf-Z)nXg8ab^Y7*De{sMsIcqIboffiTKi}fHV>68aQT}nd7Fu9+@h-WHI(xQKCOlvP}RczZo|zs
z?wHbJYlq+>!^A<{O>nr0Wp^mvFbJ~A3x{>>p@0Q^NzaHbvy}ylg7ftj7{QK@_udhL0TW*NX>^)AABRhr(J`w6$n(^
zZ$^By-F_ymEEUg%F9`PYjB1PdC{$M+43i{vFqDU2e8G&`oNbX5W6cvM+Jp}3f=e#bBhfl9R_u;&T;
zUU2FrO@_;p`ti3&&Ux=qv>TQ(x^+hxbRU6VSGuq9V&j|a6OMvUh~9dJ@cXw2t6HwZ
zJlO~=NMa>&1YORHj;2i+27j55p95XasYElVJQu$<@!^aybQLdGj>K{$`^G#f-(l$a
zMne>Q2;dtHSDV<-sB9VP+-Qh?Xvv#Et8kEOBpgOss=ruza?VF~?sMmIc9ba%3M?Nn
zSGu>e1%n8Sb6;XY{qet(T(?3=w&Lcs_kQ^Gi2FE~>EkXIO4a=X^)ZZLhLOxLMl*~A
z0~UU@lBnO1^vH#AQ1iJP7R@U*m^`-e4$|P}9%>ML4I>(a+E*&gL-1g
z9u^MbHAoWV4u>O661JWZ_kg2JJM5(DQi9l^ZnAB^{GHNb*^6n{31!@=hc-VwiV!H8
zW_*EZ?)BW@u6JjLhJP(4MaW2McNB{6C>8=+)T0jyw9jnb&t^Y<%Q^Zdx*zu*tg%oh
z_yD8nXLlQSdu=FEq(ZfWk$R5-C?ab|QV5Xj!AMpoHvp-jAZ^|vTsv59vthMTX0>tr
z9->ZDB+<09&V6SdHV40Ga{sEkR{KASEyVI7_a%-EWf1lLvdC23JQqu>U602f%(y17
zqBvU(ovM9T2xTr0oVhJSmeLO*_u27b0*+IR=zmJbA+!tGKjw`H>J;}h6v4_m*m51W9vjEJ_+Q0)bWNgT~mUoq1+h92#
zz5=kk!A!mgYi9N$eRmfv%AS`4U|!Dh97B=w6o3@{Qxt_Mo6Wn*XJdmmIM5vz;AO}F
zR{Ba&0Bd}R2>ND-TyyS+52DU0S{Oacd~O4=n*c7vF&+fwTiEBJ@Gl4jy86
zWG%`@Xi@gHyierX?58>OboTokdOv$Nhgflz&6*>~Y9okNo&E{w__WgIX>SW#zb)Q$
zz4!iBbuSsW8m{7H@_7w@Itq53=_A1m_lLhle^pgRb(g
z=Y1!2OAGyY&^#@Hy&Ony*ay!dea5QYhF{VzSQo{gPq1+ryAMD2A5aSY6x)R3HUOT_
zn%_YESl-|+{o~aJ->4tqVK_+PY3#0`FCh+J-+OQP`1;(xs{y_q1)ti8VY8#ZL)x`s
z?OKh74N_|1B@1+&D!f3e$Kr^6KI@k(e6b?nz$$dycGvbCX4}P|P;p(!X8TLJ4BLC@
zmFy3*@wG4q1;!Ua>rV=CgJ?m8b~0{IT;VXYhr=u<6jqNje>rt{s|U>23ZPl4AO5~l
zTijs2kIvwY+WOp;G&aXeOK>2b4H{)uEAzuR0vvpnkW0Oy6%Jeg@35u=B~~P6VaG&j~3q{OIJV
zH;{ii%r9;%8AgeT_@#0@N~g~&5-FtzFHs89?h^AY!h2Zl4o{zt19MODyGdCOLLZv$
z&F7Oq=`nuo_cMX1X!E-s8tly%8uhy#nnocS^;?ym-$%6gH}@L47@dbRH_GA&M%?(R
zCYYtRIlyBVfcJBbGqKuZhnMa8Hl82NLL1)AWAy|p-Pwmb6VB=D{ea~L&qokND!~ZW
z`IK8=5k8K4kv)!!U5QRKqW|+}i0GDF{ZG+r>d?XcI3UL1Ct_RK$Y4SYMTS3-NSFhL
z?|&82vIZjnPaeX(k-mWF|CjW>T$M&%Wstk!nhcqp4*}JrJps
zM`20c4}PdJJcWv!VwXFMuAWPjC+kUR49rJPdzo@pd1Y
zM$?Ybv|}`FxG#jL4`nlU
zXcbm*Sw06?8UAK%@SWO)0`)cH@vz}Ts_-WhcThimbIE#pxE-hS%*35|UpIbFkIjPh
zpl{=|coob3igp8B{HN!HdLVO>|h6Y3SnJM@C?F(@%|;}MdumoX&RZ$>6Kc?vd-_*8ZpK|c-DXUouX-Ko2?0|teLS+?_T~|ZivuTExlchqi
zDS(a|fxzmr61`Rk(pCQ`PE-
z#qrFpG~%HJiM}i3Ezp4GL>KWf(EsqAQN!s9Z=r{;h2C}QF-YmD?bP35W9>2X5TwLO
z%!yv1Q(A|V;3Me&;@=x}95)fKG?m7`+gzp8g2
zT1hYR0n|IaXV`btGa%3;pk<=}MW$=oRhky(Z{b+tKR<5D7BASr@Vb^B)4m`|t%=0&
zI~evZKubeAv?vd|_T#T#u78p<4i;*h+N^+ija#B?*+W|CV?)<)s4;64?k&S|SA
z#`l!J$J3VY85KyY@SQaA%OjC4H_$yemCoM_qOW@R=G*Ghb-h?+oA+5o<44wQM~(Ny
z5xx>Hy#eN?CuGYxwVmS8cZX3LbE-TTgaF=CVzZ>5g?V+$w+wq)rpz;qpPWT*gXM8{
zF7TN~^CK%G;qb1=A_|8ep?6ZkU(g&c6t6}rEz1ul!8OC8`I|-ZH;dwL7J+ZJ1?H2&
zidtk&d@&=wm=9mfrba!>Wxqq*7vpB$HJDnt*u9GPpk3uIGQj-EbrBtPUE~g4EW86r
zXn<4Ezc?ZNi_=oSU^h6KP!eCb+<@jsUR4cgSL6ZJkg(Qnv#-|LQ+dwB6#}~=FGX>*
zh3Di#($2&ns$#Hphhw@*H60HnUy0m
z2*RhbLB7rq&Ys!$f@Oe{xS7?~vI-7v^&7^)^|dObf|#(m%t*%D84!!UT49sILO*IJ
z`aAn1{K0fo5O+ATexJJur+PHWsXW_rkztKTrgZ0|tZcP|0%yrgw1e`Bgo1=ML!8hL
zA<-%J6xKJjDs3cwRH%8<6*%!03ad8fhiJJyG7Yy!{)FR@D~{5=Fk?*IN;?d$oD%WB
zTJ;T8hT;i)D(~#n08YZ(Xrl;5mEg@&f_Gc-$N#QYeS_}^OxRt{%VO#vpvCpe(%H>K
z39pdS=Y^HU?xSoer$uYoLjDk4f(`@AX8sFkId-wTRMXDTwAe^#)~8<2=W3xjeoo2M6
zL6#MXdTvc8sUwDm`n06d#o&drRukT~fmerwgLvVr1hM7A35WG|;f5g!|3WzeI88E)
zEj(C|vO&B5H$b8nvOSK)udpOsrlFuJ(@@y%QVua-bfNgQA^vbsQWS#dxq1X}{o4!=
zzqs)XI&YTR$bu3}iD7%sQLsVjQK${XKw)lL^-HT0V_DD-Tz{n~zz1#9b{B
zdX3VY#I>+FiF?1L0vo!c4Vsglv9{yw4y=I6^U5>Fi9OT#`1@0(#62?+h}9?!$DYj2^z~UVX^#zge-r#WLQ~#
z35p#S#9ICfg+p0>2^z~UVX^#z@N)&lXNCB~K}k^v0?WTp>fjjE!L9Dp;$`6SwezYKbs@
ztEJNR-v$ps5RYy)Xzc&dk8%&>XEpVRFx3Q&{SSg-|7RGA`s}}rGxpzd8~bmA#{SzN
z$08H=hZG3~#s0rxbLF&!QJ9JW)(ill2rd-Fut8QMKoHdk{dnqSxW;jt8UnT&VOXK!
zv|E_8_cnGOnELqJB(rQ=^V-7%wm(ph3I`sA0H)nX(Q(Hs1RU|*hJGJZ49vuDCTJEW
z!a>wTIH-=-TY!reYcyHe>J~cnpdUnq?)by~wN}yCI{k|Wff1CacFgak)!GL!NKM7Z
zoF1CajqMvzwijyt)GHwHc1_R(gh_bcrv^sZHI-_J^Q$ieXs){p*FtO-+@VuWal9VI
zmd>Fj%^Yu9C`@r`cpxosuLIwD!HF7naJ&s?TRz;MmQ4-wA*#eedDNzt;|-K>7Ii+#
z@oFWE_yII*tmEAwP!=8eZyI&7ODZW4SZd0xV!2oyalB&(+VI}A@9A_V3UY%$D2{Au+?bj+qZX~PgPA%X
zL&uMy!V*-_36?KLIs2jjB#fJ)VBLaO6JUq-ba$qU$&V{h*5wtJ4{a@`8g+0Pbqi{}
zKONfL@eVr2Qk{lL>?IL;(SO^gYhu^MXnCwQ=6G^PveO(ZX|F@@PGMTn%`(YI0)gfdZZf$kEipf@}Lyhyo;cUulMV*iE)`uvlJt|$o+0<+w>VBNpV@e={
zDT2$F2GG!Qyh7%27uRNPhemP_lGBxL$DE+!6`XH*2U6nu6rcx8S1Qtl?o!AB|7V#}
zjpHi8wQ=lpfu-Arx^|@_k9WKy1!_heI#8!09q$-{a;aTAI=GADtq`a!bsyk(p*vit
z!_kgsZ)xGS)b0qhwF_-RQQUz>W5zh%zXWPVgHNRkFG1eA3zkcRN7Ce}VJJ$2F_a7t
z5}1>wGzcdCbb*>t-xC~ftb}u^2khMI5|+e25-3P~yI_)d0O`bk5)w%qF9cH`9L-mW
z=So;7K3~H7(7_laLbsz(8GzUwGezH8!kYdb3Ad%Ly&UgR
z2{)qy4tG3zeFV$j?=Z(Jn`Y%}`U@ni>8DFr(>I=O>5V=THu^|d>$6zGL6Ax=RO@hux>awaN3&67D1LhBFg%X
zo#1$(A6kbJrmQ%V?D1vv!0U=@(J
z1j)xD>$O0>5~K|s0{`hp2_x$*X#WG#AY?piwk;jl3OKHzQ@7OdX_w~VXf6)sz8S$i
z5h^=EpQmnv$99L$kn#e7uXS;s39iaq9=Qv6aKe+Q5uUW{`AzIvqNP~2gHI-$`{7LG
zvq0pWBrI6jMUHooP(<-^KzakOlR;m*-0JO6{=qmR2wNbh#&CX*59h(v5$H-6{?Xko
zUQzS;L7n
z95myH^>9p-di4d2L36IvAKv;cF8xLeJbEYl%WS$K=XMyf&=C)H+(8|7K--yT*&0#v
zmT;<{BK-d>(PrMG{*aG->3G*qjNZW>a@cX9#%nwL&wTnVc59sO$$B=+@j{!w)z)vi
zBt9E=9R~Zk^VN25><7Oj1&#u~&v!h#YnyBGt=Jba+8O%=Nv6Y&7uwBD%l#F;+R*KI
zcFQ*NU+dqDcNJncx8nu7mzPIiryq)7-|{^kwp_pDs}0v`yS3VE?Rde~(kiu^RBc36
zyHIg+gxOce^?Cr>{mBb#!L_B%-4K@e=GdBu?E`P2F$5rC;=}Rm7DCps--$Rw{hCWp
z;iX3P#yDQE;je|-Sg5uYVpHLDc-#r%qG~H3;?}|N20Qce)gC^zgHP?>3&%y(o;}2^
zBE+qPxL~JVXYAACapqOCNf76<(f8@72O_kZUkLSe^t&i@_^(gXV#{Onacn7i{oz;J
z(sMN)ob7JP$q01^*WW#z@zZkg*N#l-YjvaizUAMT>3e>2>D1#-2QaPa2$N%
z5$qcQ_on^!NAFl<1>Ee?dUrK!aR9|ACg^q{#6xfabvg&`%(j?=qwNi9rdHgt|!|f7slv@*z;&y8-!znOaH~IP;9e&00zU~
z4ukcHP@r~KWAN8)bD94PB0rZ%w9Ok#+guZS0~X~EiJI+(8s|;1#}P?Ot)d^~T*@
zhx%iM&~lrMN1d>e>va`Cx7*IwTLNk8cZzCg%7Yzmkz`jje54zA0p@}zZ3Rsz6z#aq_|_$xGA;3{owaRHb&@*=siSRFttT9yxTyRb%U)2^jtJe
zyV;GLGx2=Kt*AmMx?`so_t*ewZjf(kt(2p%wdy`pcd#|71vVzFhXaExOxV4=1pGl<
zRBc*9+zgKU6{*RVB+TjEh>c2^iMr9sZa@t%PHccjg?BV!qx6H(8OXtIi6_c#OV`pJ
zNMiI&mMI_3)!R_$JVErM=(Q5gr$5~JsFW83iBe8WOmFkFa0&=d=My2yqZ#hiporaU
zlgg!|deTJ~(IxQJ;Dz!Sof_$Qn}oO>omLqRN9nXP9Piv)tgskmHKJ};xU>i_pQDG}
zckmeQEydJl{L(D?q0tMuG(Yc`rZl(pO|2d8wGdkjhTp5Cu<>2D{<_Lt_+u7(dbrW=~v*OH!T`Eo1A`=3x9K##(qL!sO7e-qk+sivJNurXI|q
zO-(j6q0LRUH=zgfAH`x!;x4O03mAq=*f_0?(i_=dWz*V5Pc#Y>aNG)xdlSxEI0+nP
zx*F~{ZH@1W(;xBqS@dAm<5~1xqstrX^tLzot_eMw|3p45Zgwvgj{@dBa4IHEf1W5A
zr7t7jMCkeWi*cn0UD9}F)`
zF!$kH+L5;#v(n@5vkd#g&VPvVuZvU)O+I#5ybhZG6Nyb}S?>B=+LZSuge?}r1MpJX
zM?qK@xm9Rj7bEw8=3x<*Ma`N~s}tyl?8|fL;oJ{$(Q8;^s+z0>Bvp@v=P
zCjV9xM&nH=qm&pFPAj2ofm=G}`gDKe`$5)KUGsI
zn8V^nj+KJE?qajyA1*Fiy_L`peKm5JdD&L(iY
zz%Mskz>g=I_(2h@htPEr#+vaN7zk#er?tA*7I$|%xnhatU7W-$g!N7cd{y{~Jc`9|h4aL5l~i#C+UuwjC6M1c6Ji
z4?T#Ba??NzfyF|Uk2NG-)tVV*l^zoT=k5+Sd+fVLCO@-BvehXvOzAs%ACi!3C1f<7SJ
z6LE)!mCh|t>S>|V?fGR17or#NBxUE-R?Y6TSUms+NOObCf7sF-hc{9F52Z3uxbpFS
zV~ij_VKx^XY9l&B5En(-kv
z^{(1DOw%KC;UKH&Kf76$oEo)Vm)^pDUdIdVGvy7V@H|C`N8V9%@_0Ob3v>t#!?sDg
z`>(ARf5fJ^6aGeIK?K{{_<1Y98)31PM~c0L@;#Tn;mN%v?3uqD;faCp&Nno|PhBW}
zZA5LSQ=91=&u-@;r;_e=|Knn-@mH?eb>?`XO-xiX!^LK$)yRizF>(%}WEC9rg#b5;
z7RcN|xbJHLK)VlzoK|`jCU>3974AL8Am3ZUXviDs{TTfan-{0A*eRWtbz37^*Jvq*
zjPryHZ)t=PzgWV3=n3rlqnF~3<HE
zHUim~K=xQsv^h@qUgpxO=#x=gcD^%;mn6e9ugF@FMY9{sP9tS1tYHar3q0Vzh>XOy
z!aE7zDBv{=KMS~4s9OO>wx5n~PJtbC>o6I@Xe*Bkn*-1C;Rt4(c13A={7Ud{TW_nW
zIc@WHqH;-)4!F|lZ9M!W1#yV0DhOl88d~S2p?I#U=+jo_9!*F$A=4(LmxT9ZLPi*>
z4qo&bo6Md}NSLZ#6A}=FO~@xNTH(fogvmlC?@!(A+?(>{}D^h9KI61YvDLc8B7*T?S!oLgLTb3~K%${0~gXUu8}=At`(rOh|z!`llu&
zOsY-D0AWrsApx9XLdFVpiU|o|Z9-DQFd+M1AdLZeMc5Y{H7
zZz!Hk$O|u7nQ+|q_tw8+gIzEgvH%11^MV{mKf0Fzc~6jh`pEqbqyD!d1dCai;m7&Y
zm#rL+vI;!sRU14UyJNP2rJ*1P;#T9=fD{OlkN2;x2hu@=~P#0
z9G4Em%W#*}2QQ8+!3b0En$2Sqx&lY3;b4n)>e;E*Uxn*I4&1ECT6o*cFLI8gC$P+k
zWqd&nrU(5efH+dtn5*#b0rGF5sm9{v2N66--$rz!cOOc9g2c7Lqxj`OrU`<%`A99s
zx9FSDHGrdluZFJI2q89rMqdHVexaln~q<2oZkdeF>TXaY!RKy>1I9
zMh6~BM_d3e`6d?!3jPBJHj0I^1^!n)t&Pothx>VmmS3KY5&|D9DS|3u?
zajcMFw)GMhlc!fk;fCGr(G9pz6?=UpUQM^2R!Zk!XK2M1tIHYK^7U4P-ivIDU~>Nw
zw6PkAYfk%}fOWh-P|)}P*D~no*6KHH7}KhcfMA;dYBKe(A&xiqElcB3`F5d^XQAb_wwoaW^e69zwfmK^Yr(JL~<*6Qo={jaii%}
zyzFXgWP22sx-9o-t9PkSm-`!h`XlRs2DG*DuZ?M4?h8%mnJDmef>JO2CCe@N!Pj}%3!jRmE
z=^MJS@ndkto4sQTB1--w%w%9g+Z^wHkLEO9f#`iC+M}Ze(J&mHD|pv(B(b=&I7-(=
zm&5sPcs=~Vb`qynC4bFX0AFA(Z-5jH8nF%Zb3W3cJwN;UP+^0i|=0TMpDypJ-0OwtT_e%3@L+yJ~zd~$25~ww`KbHDo
zmq7qUsr|v!5A&4=Z?$>G>M&MtKfrn>&8N-q>f*cObWPTlEc&FuEKD)veAbYDY`hSj
zZwe2>y+j69y!XLT9|_}>!G5@oigy;KfS5bDREXdW@p6KMd(kHUO&>d3cEHv=DsVn7
z*n9vjAp3o*F(%}^uh9ZJ2;yMOxWc0ccry4NjN!D)-{m7S$WCqct=aTe_NUo2ztMc8
zA7+ZSq_6O5Gw`ipK5U2B<^RZhm|vgY=o(OWlq8zd4tF;ysbrf~qX+#jItO*LL=ddr
zM&C!C?-oQ&#NHR>dA}48y{f15IGjgln-+$Vc{~(91vkp9ai4VYrXT#dnYS!|?CnAk
z)Jv2e<$(BO5Kk8~FavQ;kb~O9Kb1Fav0WL@-~rez2sG*UC2xR%z!Pt+8tII>m{!g#Cpl=1+iZ8
zA0o7_m)u^ct(V+GkQ6UDfUTE2QV6Y={C)@tdC6f|d&xh92(?cfAl6GB_qEOIpL@x7
zglO6SSu5d;Uh>;QlF>^}A%PwER9G^4$-fCn{a$hqANGm?r{aUn0ca+hV$
zZq4D}+OYAGYXuN5dC+&3#(2q<0%$LJ**BJ;u9y6x#91%-13|2pyh{-4C9f9Ut(W|W
zAR#Y#y?`Mv+5g^Z^Z%QdTp1F{t>j_}|3feN0TJ+5z2p=QG^xi$LPjt74I!!5OMXwH
z#Y^7ygDtvb9WVJ4i3@qjV|QBy-JBl(&4yE5;Q+7WCGQj#@siK~-AWNJ`F?@KOMY0O
zu$TO;pw>%nE;^aT
zC8zMfOOE_x6W3mH6A6dBHjPVtg25ZHRjn?i{8l6MI5H@xI9)1Q0E
zUr7?yOFr}$n`!GMpCX9$l1l^$dC4gtOqnY^PJ78IVR*??L-85C7ccq7ldRA-)D{m7Lx-n^
z4;X2~dDMZ==zS@`R+nZ(Kg5GbqfwS7MtO5V69)EXpz>r((UiIkp%UI+uwJlz>FB|j
z)jrMAB-NS4E~nct)=mz=>{d98ZqR#-jb9w0TX6fO<1IhKLWk48hhrXG!f|Ta-ig&F
zb^QOEEZs>(Fi{yP6Nkgy|0O4?HJ!_ip1ix4BlgcCTwEpZ!pQXc=9+wa(e1XAD
z6LfAf_)deHs&m#GT&mrq`(K0in5Y3Wo;r94Rq}fjYkV(+`O^e-!1|0mTZbPoct?X5
zlxUo5l0W?oZZGrbqhY7e;0p|Wj=}k@H7ws=?lI2bwFb{E)c{ILeXt!+(MuyX_;Uug
zcYQ1~IL`km`prhp27?!%yj8ko8nAf6;L
z+*P`^W0e^CCxE+7J}z<7K-|#(SK-Z^9u=uLW=XXEMxRd%{m%wpP@w@^FFB;?r579e
zb_QQ%=ubhIKfMhueO<#&p}}p>xB6df@Phx-gtlGXYH)jN!-Yo9+XlDyKUh5OX+3jm
zG@*G$b`CbUH8ba#avNfB=Uh#1`{^8m7o_2@7`#Us{<*=&8r(y>;ZM}p`czEOVVnw8
zpF<5^aDfgR>*n+|_%wsh)6vcZgXfxz-fr;g4Zc1Nf7{>{7iq%DhW;mm?@YtW%*wx1
zha+g0{K26o)oz{HI()GHa=tdWeeLl5Moum|0{2sUq;|H!+Zf!wRjoJ5g+DzEzWFL0
zz7h4xpBa|kWVBGj&U03N8jiy;D&4WyYQmF@oPGwkFA`{A@--7U+w<;e{qzC5?Y;^nBLhuWQ`u
z-y8!0=c~ut8sFEH!x;u2yFFD7jvwoK`8rk3HwJgUPnFZTp{5s4#N@ZP!L3_zsxcf1
z;I7lesU4*YvIp!Ge<~E7f;4=Q!JRbxErV~Hq~%*V
zZF04o^=bGdgV(0v4;p-08ot}on|hpR^o*fhsB%s#&&CSRcY2I9`8D(%48G0aJq+I4
z;01-6{#k>MF*x2wqL80V`>e6_Y3*u}!Fw2dn31za;W^GzrhbiCa-J}Fk3+P46r=jQ
zY4B+WYP^TR-8`M&0)r1Qcn5<&YviC=s?Wa-zP`PdGs@r-4PM($m!sN>okF&wxkEh`;8+?hu&9LCSWAM$Uoi{b|e>8XxLyuudeFy|x
z@12dFXddd*+TiO=`Rs4-J_g@u`pZ5BKg;0LO!*vO@C631NTYwq;wD|Fr#_nuzA8=s
zPYpiV=#ODVeZDjJL22a>LD%JcZ8PO;?O2|{7Z`er?`!ZjY30+=;O7|Jn0e=DgSRla
z)n}l=A2qmbpCb+atkK7|tE9o#m~wy_QJ?b-J~6GG%(Zx0y4M;!Zg31k>a)V&r=-z8
zWblZ=ZN4@be3rp&`D`}$(FV8eZL7h5HG0~1^_9V=8+tRmI6oVFfvI2nywe;%xW01J
z+CwLUuQ0gn*S!tiJ*_-P8~hZ5+kQ9E;A;$S%V&zghne=dpDDNH26qhJ&fpsjz9KE%
zEe7A2CjS#FKP_Ls8hn7ExAl%2?^HRQlvXdT489~S-9rpMD-A!^;5$t@quAAFq`^C<
z^~Wg&KRm5|XBvD-TKO+C_y9w1+y5N~@02FzVS`r~eGpWiHw@mx*o}h>{y&2|2Jc|-
z1NYM9v)$y^wznepJ`wB0T+@{1LY@p^*BI~#ne!KY2s
z_%wq*WN^pelMVib!eM_7NR`vEh1S2;;5NV21|MtiZbr^Jg+rf7TFzL5|7`Huvo${1
z;77F7^2eI-sFT4jHh6)-k2Cly2Cp^a{$PVQZKdTnMxPM|KMi<&^HE7f-^h8kv)0Fu
zJClL4-@9PEMfCUi24A0s&oj7_Or^hB$#3S2HT7jvxmV%2&JyFtTCOcd&e$|L9~wE+
zj2v6PUnsn>vmi}Qru;V8o6Dz>Gp3i-#HL(-`Ls~D{v0k>nirRDGP4EVGR_`D4GvJCj08SqCk;4fvsKgxjr
zlmTzty8is`n*l#G1Abfvd{_p&JOe%rxbJMuPLk9fl4EUf7_}C11RR;W`4EUT3_$?Xm)fw>rX23tnfPW9XzJBp*2Kwwa
z^_S;f8Sq0g;KyXZajizZ^>t?ZgI9g+ws{8pkPP^78Svp5@MH$OG6Q}|27Dp#JSW=;-j|@u=ei8^4`je!
z$bi3-0sk%oPHpQi&lVZ*gEHVfGvKFWz$XE3g7t;<#y_|728%M#-;@DgnE`($1O841
ze0K)C!2ub{Cj)*^2K=}T_`nSKX&LZI8SuFo@LMwAt25xQWWYbofbY(LhPWrd|l$gL;#tdjC^g(X$>M;4WoSJhNz;4CU1&oL&iWy$k0X0xuE%v4%cU09t=
zXay1+C=Qj~p5$dJwtBKxSXNfflFQ37WO00PQMJkZ=wxN_gekqbn#PZuQc+K~M<Y|A!Ca0WNUOB#Jdy^N%m*QcWwG
z%4CIAa@Z6Wm>8Zc9M4TJjZjHQPAIG?spbM?Ezq#XCy|}Ab6wxp`7Hk7UbdUF+})O$z@w~3yq
zvBRbeDz2(d3@a>})TszQr1+S*SA0
z^@Enjna|k9x*U;aRuU6n^`OFEVeZX!L609c
zrEg_rqJQzZ$+Etai;@*=cocQAs#8T_Wp#a3S(T}iazv{AGTpDJBw1LQv0&1Q#gqs-
z-=5j(Es(nP&q`$;Q8>2#v4&$Noi{!(CBxXD1tS&5|4D3MsfQO9S0(FdSRr|Axay>b
z?p0oPR-$KBq6FU=YeW@P-K-m{S2u#wD#qAfURhpKU0i0H$-vTz^2%y%-G-&-`0*nv
z3yYHD>UM9g*^0~~Xr}hsB>}5dT%AZDh5wg!pWtEQFH5Q0^-}rwkdeBq=~+;tL{(8`
zf?LEtah%506qleD5z8CW=e&
zZxukdgiW<*3Y?!ZDTO^q$<)>}%9@a|B6XeDlvNZLO)5#&?{4cVQog8ZBmY3Rqm&fw
z(EjzDqUm#q?pZ&h)L+hIS`+zO*{j<-|5?V+?o%?BrW3N1-YRX;E2k_u8U9-Em}KHG
z$`-?TR~L?}10<4Vcp5>h^-%-oBIGHv8)#UAfkHXIp_oaDk%^v({$2Vd3KQp^+%s`b
zqWZ|hh{Qnk^T_cD>lIE){HqIlot)1};5hu;5#a2S;D-r~)hnkT1a?mJJo&`)9A$?(
z9WL}IP3S4VC$h*ciOG}CKR?ke(e0e>!-gdii7x5!H8tm*HyL!@@ULs1A;U)qNj3ZQ
z|HQuSk+E()a#l+*Zf8vEZ};YZByA7PbdU1tHu(BX_TLnd(NO(OIsZ6QX}vF#XZNRd
z_vhVMiBRJN+JI@%ww0#$v66Cmgbbn*rRt$r`fcD4mL^NbVe-T@`49(2Zj5IVQQtFh
zRXDBs2(%38PV%E(pJ7s>w{pW1c$OKij`JiwqhIxE6hR^O{%IXtx9yBoS2+A7vIADXM~BaLOM(h
zebyN;mMP8kn3M=HB>pA5g=Op{Xr98VDP={)<$;qMsI77;glYNCgu|Q}e?*U$d!S=S
zkUf??lY|D}jD&D~@Vq}hQC?PJr`aaqvB*rL6k~EBU@d_ok4oc7JngYdl$kQp<-&nb
z>5VV0Dn#uCv}*Q6lP1ejqC$_Wlhm_oNX%Jwpqj*vYS=lMl>VflW#f5BNe?QFr!+*3
zl$no7sinz98%i1zZ^Bl79$Kk{v=YuP)qv`2hOD`5<$)xCmB}j1
zH>E(SMZlaqP^FNF8#kDOD2Q@X>FKI
z7|(x(DMC#+sJg1kA~iLvauxE5xL5<`R8h)Psw%IkR8tmO?doJzP^4UVK?kl=7NKeA
zNtwK6>As>wy<*VM>twa2VthE~Y%S~11T!(Le(ETpTQhqdVMA|dGI}EQHw!bG{7o)?
zTF&HM)%7X5YA0NEH2b9f_aq#dW-aA8>hFo^9#n>Dzar?*O0V9^HC6v-Wweb`R?W)RnELT(|3Tq}i>{*mxYI{6h55TiEbtn=OFq4!h
ztgI}Yg2$=q$|=r-N*)=;*OZn{amv+Vg_^z$!Fuv3%#$!0_8roPn^vDwhx8mgus2d1
zIkLf5@nWWNbj6;ZCCeprO5b4oVE|*Kb7Mk%^H#dkyNFz*Ila
z_+y5BGEe*Kxe1=7P%{$%lBJ2kYEi<$vt?prWla(*Dm7}2V6bvA6C-)RNS`VJfQj0~
z@S3vf;!-molLDPwSXqV#OVEufE9NDy1W)MoE3YiYOT+baZ~9EH(qIVcLNqW-Jv`wb
z7G#C!iNXY?2X($c!%In{3rmXGPzI|@HKnMTDnuKB0}89yV|Cyw7vapM;K9tk&U+|P
zQwpjuN9Y9=sHtfTsl={>O!ZW7ud4=P2I
z3%M~t`}4WLxqOFW9dtrT`FU2NEfAi_J~>%9X?Su1XA9B1$|DL%GQ2{NqNP#Y@UU`y
zCnKQCuMb9sftVHrpyqqI#`p)qBPX&0ID&^uZas#7Xi-s3B}Q-rdlgnCjdrG}5`B4H
zXm}DNRhZaUl?XeE^*8vAcu=2ESj@F*7oPf-R$vWRssdFs(NX;bSU=UHcy$U1O~Ht)
z8k5dh&$96&bb*=VrHz^Jz^V~7~EeymZraOdDYH(yubf&3R-E>?pS#l{Wf9xYs03
zEQ8Oi>Rd9T^CUf6YLjgg>yEM>F$FffG_7->7)O=ydch=6r56k!m9B0}S|?sLWYS<6
zQ`-5!J|-nC$EIYYhBX|NJU3aQbz~M4Y;W$Qh8-rU##l+VIe5vU&Hxva6$-uk>L;CH
zQ-;*=Lp(a;uo65)!N4io*bf^H0^>M}AB_2l*Y+SbJ;TbYhTW+a
zVl9@g7p~j1DFqmcU`<#p7)ui!UaVF{u};YCLR)U##f)&S4Y3MJX|!q>J6@d!M{n8o
zq3G3s4%ie!FeVtip`2czWRolFQefa@hLoepm%|AVeluf%e4BoxSbDJ)8~`^YAY_{~
zv@D6L1IC&p(DsWb6f5&;>mpC-a|Q>hxU-y^DE9A$R3RLwc@qp(`J4?TW{
zoe#uxI$-i#f2%ymw5&j@sZ6^GAYZEzxGI8YS@CsbFD)2V7oDNp}*s;aKk-xKXG?D9!=I;*Uv
z6E_9*_}WPzUU3`Wv3R_r2qyA?+-dxjG6>V(aG*L>CQAw#G`}j)p*r!(s?({OJYDLK*TIdMFAZAf!y7g}@J-^|5HK!8fJuoPRJI-OMx!CK(BswxNT*`?eX
zfhEV)oCV&(va{gNo1hvYZPd7NmC18$49`^A-zX3JQ%zun!{tRKcvcXBm1Sq?a6KE{
z{w9QDG!CDkix|EY=7;_6oF>nnpR+KZFAMX(Y546owgIMmC?(`LJrVx#k3Y(7`VRI7
zs*m|T+ypIOdip0Kp3ibx{_ciPzRf{E4>T_RS$-U!Qy)Ip#w?bG;dKS^gC`N5&ufy~-SPOxNG0p9C$(^HV4bbwBgTm1Q@gB@8lW^^Sv48bHbm3Z~(t&<6oHHo~yIp
z4~k&TXzS66S)9f{%bb6--+cc-_+#6j#csq8KKpC)Y0n=n=&SRQPH)5ZdnI`JOtj^<
z=OCB-MgFzm<&-SHy$__;@DEGNZ~$FC9BZ^KZ8ihM~ZG
z+pqWWgDE>(zXYfm_fC~;)3qpvQ&Z3}
zEB4a`&*yUZQ-FVO;h(JzJAUx+kd{Rtpzoval
+
+    def __set__(self, inst, value):
+        raise AttributeError("cached property is read-only")
+
+    __class_getitem__ = classmethod(GenericAlias)
+
+
+cdef class cached_property:
+    """Use as a class method decorator.  It operates almost exactly like
+    the Python `@property` decorator, but it puts the result of the
+    method it decorates into the instance dict after the first call,
+    effectively replacing the function it decorates with an instance
+    variable.  It is, in Python parlance, a data descriptor.
+
+    """
+
+    cdef readonly object func
+    cdef object name
+
+    def __init__(self, func):
+        self.func = func
+        self.name = None
+
+    @property
+    def __doc__(self):
+        return self.func.__doc__
+
+    def __set_name__(self, owner, object name):
+        if self.name is None:
+            self.name = name
+        elif name != self.name:
+            raise TypeError(
+                "Cannot assign the same cached_property to two different names "
+                f"({self.name!r} and {name!r})."
+            )
+
+    def __get__(self, inst, owner):
+        if inst is None:
+            return self
+        if self.name is None:
+            raise TypeError(
+                "Cannot use cached_property instance"
+                " without calling __set_name__ on it.")
+        cdef dict cache = inst.__dict__
+        cdef PyObject* val = PyDict_GetItem(cache, self.name)
+        if val is NULL:
+            val = PyObject_CallOneArg(self.func, inst)
+            PyDict_SetItem(cache, self.name, val)
+            Py_DECREF(val)
+        return val
+
+    __class_getitem__ = classmethod(GenericAlias)
diff --git a/env/lib/python3.12/site-packages/propcache/_helpers_py.py b/env/lib/python3.12/site-packages/propcache/_helpers_py.py
new file mode 100644
index 0000000..1374fc6
--- /dev/null
+++ b/env/lib/python3.12/site-packages/propcache/_helpers_py.py
@@ -0,0 +1,62 @@
+"""Various helper functions."""
+
+import sys
+from collections.abc import Mapping
+from functools import cached_property
+from typing import Any, Callable, Generic, Optional, Protocol, TypeVar, Union, overload
+
+__all__ = ("under_cached_property", "cached_property")
+
+
+if sys.version_info >= (3, 11):
+    from typing import Self
+else:
+    Self = Any
+
+_T = TypeVar("_T")
+# We use Mapping to make it possible to use TypedDict, but this isn't
+# technically type safe as we need to assign into the dict.
+_Cache = TypeVar("_Cache", bound=Mapping[str, Any])
+
+
+class _CacheImpl(Protocol[_Cache]):
+    _cache: _Cache
+
+
+class under_cached_property(Generic[_T]):
+    """Use as a class method decorator.
+
+    It operates almost exactly like
+    the Python `@property` decorator, but it puts the result of the
+    method it decorates into the instance dict after the first call,
+    effectively replacing the function it decorates with an instance
+    variable.  It is, in Python parlance, a data descriptor.
+    """
+
+    def __init__(self, wrapped: Callable[[Any], _T]) -> None:
+        self.wrapped = wrapped
+        self.__doc__ = wrapped.__doc__
+        self.name = wrapped.__name__
+
+    @overload
+    def __get__(self, inst: None, owner: Optional[type[object]] = None) -> Self: ...
+
+    @overload
+    def __get__(
+        self, inst: _CacheImpl[Any], owner: Optional[type[object]] = None
+    ) -> _T: ...
+
+    def __get__(
+        self, inst: Optional[_CacheImpl[Any]], owner: Optional[type[object]] = None
+    ) -> Union[_T, Self]:
+        if inst is None:
+            return self
+        try:
+            return inst._cache[self.name]  # type: ignore[no-any-return]
+        except KeyError:
+            val = self.wrapped(inst)
+            inst._cache[self.name] = val
+            return val
+
+    def __set__(self, inst: _CacheImpl[Any], value: _T) -> None:
+        raise AttributeError("cached property is read-only")
diff --git a/env/lib/python3.12/site-packages/propcache/api.py b/env/lib/python3.12/site-packages/propcache/api.py
new file mode 100644
index 0000000..22389e6
--- /dev/null
+++ b/env/lib/python3.12/site-packages/propcache/api.py
@@ -0,0 +1,8 @@
+"""Public API of the property caching library."""
+
+from ._helpers import cached_property, under_cached_property
+
+__all__ = (
+    "cached_property",
+    "under_cached_property",
+)
diff --git a/env/lib/python3.12/site-packages/propcache/py.typed b/env/lib/python3.12/site-packages/propcache/py.typed
new file mode 100644
index 0000000..dcf2c80
--- /dev/null
+++ b/env/lib/python3.12/site-packages/propcache/py.typed
@@ -0,0 +1 @@
+# Placeholder
diff --git a/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/INSTALLER b/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/LICENSE b/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/LICENSE
new file mode 100644
index 0000000..9c77274
--- /dev/null
+++ b/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/LICENSE
@@ -0,0 +1,16 @@
+Ptyprocess is under the ISC license, as code derived from Pexpect.
+    http://opensource.org/licenses/ISC
+
+Copyright (c) 2013-2014, Pexpect development team
+Copyright (c) 2012, Noah Spurrier 
+
+PERMISSION TO USE, COPY, MODIFY, AND/OR DISTRIBUTE THIS SOFTWARE 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 THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE
+INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT
+SHALL THE AUTHOR 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.
+
diff --git a/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/METADATA b/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/METADATA
new file mode 100644
index 0000000..ab1d4e0
--- /dev/null
+++ b/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/METADATA
@@ -0,0 +1,37 @@
+Metadata-Version: 2.1
+Name: ptyprocess
+Version: 0.7.0
+Summary: Run a subprocess in a pseudo terminal
+Home-page: https://github.com/pexpect/ptyprocess
+License: UNKNOWN
+Author: Thomas Kluyver
+Author-email: thomas@kluyver.me.uk
+Description-Content-Type: text/x-rst
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: ISC License (ISCL)
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Terminals
+
+Launch a subprocess in a pseudo terminal (pty), and interact with both the
+process and its pty.
+
+Sometimes, piping stdin and stdout is not enough. There might be a password
+prompt that doesn't read from stdin, output that changes when it's going to a
+pipe rather than a terminal, or curses-style interfaces that rely on a terminal.
+If you need to automate these things, running the process in a pseudo terminal
+(pty) is the answer.
+
+Interface::
+
+    p = PtyProcessUnicode.spawn(['python'])
+    p.read(20)
+    p.write('6+6\n')
+    p.read(20)
+
diff --git a/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/RECORD b/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/RECORD
new file mode 100644
index 0000000..c594bd5
--- /dev/null
+++ b/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/RECORD
@@ -0,0 +1,13 @@
+ptyprocess-0.7.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+ptyprocess-0.7.0.dist-info/LICENSE,sha256=yCLThbGnMymEYkF5m-zxhpC11Edkwb7WkwC1NqQFAwo,905
+ptyprocess-0.7.0.dist-info/METADATA,sha256=w8K5a12aVdpZWMNNCMGKCEn1ZgkCbMRtXJW4t3_PPgw,1312
+ptyprocess-0.7.0.dist-info/RECORD,,
+ptyprocess-0.7.0.dist-info/WHEEL,sha256=NLqmsx-ZFZ6gDavYgh2oH0ZSN-KRmpcdEXIZDnYy9Pg,99
+ptyprocess/__init__.py,sha256=sn-W_1nNRTuIOi2aCEHVL06wCVJcR-LOZdgpXzwFuTU,138
+ptyprocess/__pycache__/__init__.cpython-312.pyc,,
+ptyprocess/__pycache__/_fork_pty.cpython-312.pyc,,
+ptyprocess/__pycache__/ptyprocess.cpython-312.pyc,,
+ptyprocess/__pycache__/util.cpython-312.pyc,,
+ptyprocess/_fork_pty.py,sha256=VVvMy8c4ZpjDMiIMSg8T1BQ1g3SBexDpey_cxi0n5aw,2362
+ptyprocess/ptyprocess.py,sha256=sk2sU2I22Yyl1gU3FjFmpWL3B43o0KqG3d3CI8r0Nq8,31686
+ptyprocess/util.py,sha256=rQAdDRZfoOiOn6vykWth0wI6FFKAp7aJtBSdt-KBWdU,2785
diff --git a/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/WHEEL b/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/WHEEL
new file mode 100644
index 0000000..3825653
--- /dev/null
+++ b/env/lib/python3.12/site-packages/ptyprocess-0.7.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: flit 3.0.0
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
diff --git a/env/lib/python3.12/site-packages/ptyprocess/__init__.py b/env/lib/python3.12/site-packages/ptyprocess/__init__.py
new file mode 100644
index 0000000..3a6268e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/ptyprocess/__init__.py
@@ -0,0 +1,4 @@
+"""Run a subprocess in a pseudo terminal"""
+from .ptyprocess import PtyProcess, PtyProcessUnicode, PtyProcessError
+
+__version__ = '0.7.0'
diff --git a/env/lib/python3.12/site-packages/ptyprocess/_fork_pty.py b/env/lib/python3.12/site-packages/ptyprocess/_fork_pty.py
new file mode 100644
index 0000000..a8d05fe
--- /dev/null
+++ b/env/lib/python3.12/site-packages/ptyprocess/_fork_pty.py
@@ -0,0 +1,78 @@
+"""Substitute for the forkpty system call, to support Solaris.
+"""
+import os
+import errno
+
+from pty import (STDIN_FILENO, STDOUT_FILENO, STDERR_FILENO, CHILD)
+from .util import PtyProcessError
+
+def fork_pty():
+    '''This implements a substitute for the forkpty system call. This
+    should be more portable than the pty.fork() function. Specifically,
+    this should work on Solaris.
+
+    Modified 10.06.05 by Geoff Marshall: Implemented __fork_pty() method to
+    resolve the issue with Python's pty.fork() not supporting Solaris,
+    particularly ssh. Based on patch to posixmodule.c authored by Noah
+    Spurrier::
+
+        http://mail.python.org/pipermail/python-dev/2003-May/035281.html
+
+    '''
+
+    parent_fd, child_fd = os.openpty()
+    if parent_fd < 0 or child_fd < 0:
+        raise OSError("os.openpty() failed")
+
+    pid = os.fork()
+    if pid == CHILD:
+        # Child.
+        os.close(parent_fd)
+        pty_make_controlling_tty(child_fd)
+
+        os.dup2(child_fd, STDIN_FILENO)
+        os.dup2(child_fd, STDOUT_FILENO)
+        os.dup2(child_fd, STDERR_FILENO)
+
+    else:
+        # Parent.
+        os.close(child_fd)
+
+    return pid, parent_fd
+
+def pty_make_controlling_tty(tty_fd):
+    '''This makes the pseudo-terminal the controlling tty. This should be
+    more portable than the pty.fork() function. Specifically, this should
+    work on Solaris. '''
+
+    child_name = os.ttyname(tty_fd)
+
+    # Disconnect from controlling tty, if any.  Raises OSError of ENXIO
+    # if there was no controlling tty to begin with, such as when
+    # executed by a cron(1) job.
+    try:
+        fd = os.open("/dev/tty", os.O_RDWR | os.O_NOCTTY)
+        os.close(fd)
+    except OSError as err:
+        if err.errno != errno.ENXIO:
+            raise
+
+    os.setsid()
+
+    # Verify we are disconnected from controlling tty by attempting to open
+    # it again.  We expect that OSError of ENXIO should always be raised.
+    try:
+        fd = os.open("/dev/tty", os.O_RDWR | os.O_NOCTTY)
+        os.close(fd)
+        raise PtyProcessError("OSError of errno.ENXIO should be raised.")
+    except OSError as err:
+        if err.errno != errno.ENXIO:
+            raise
+
+    # Verify we can open child pty.
+    fd = os.open(child_name, os.O_RDWR)
+    os.close(fd)
+
+    # Verify we now have a controlling tty.
+    fd = os.open("/dev/tty", os.O_WRONLY)
+    os.close(fd)
diff --git a/env/lib/python3.12/site-packages/ptyprocess/ptyprocess.py b/env/lib/python3.12/site-packages/ptyprocess/ptyprocess.py
new file mode 100644
index 0000000..78d19fd
--- /dev/null
+++ b/env/lib/python3.12/site-packages/ptyprocess/ptyprocess.py
@@ -0,0 +1,842 @@
+import codecs
+import errno
+import fcntl
+import io
+import os
+import pty
+import resource
+import signal
+import struct
+import sys
+import termios
+import time
+
+try:
+    import builtins  # Python 3
+except ImportError:
+    import __builtin__ as builtins  # Python 2
+
+# Constants
+from pty import (STDIN_FILENO, CHILD)
+
+from .util import which, PtyProcessError
+
+_platform = sys.platform.lower()
+
+# Solaris uses internal __fork_pty(). All others use pty.fork().
+_is_solaris = (
+    _platform.startswith('solaris') or
+    _platform.startswith('sunos'))
+
+if _is_solaris:
+    use_native_pty_fork = False
+    from . import _fork_pty
+else:
+    use_native_pty_fork = True
+
+PY3 = sys.version_info[0] >= 3
+
+if PY3:
+    def _byte(i):
+        return bytes([i])
+else:
+    def _byte(i):
+        return chr(i)
+    
+    class FileNotFoundError(OSError): pass
+    class TimeoutError(OSError): pass
+
+_EOF, _INTR = None, None
+
+def _make_eof_intr():
+    """Set constants _EOF and _INTR.
+    
+    This avoids doing potentially costly operations on module load.
+    """
+    global _EOF, _INTR
+    if (_EOF is not None) and (_INTR is not None):
+        return
+
+    # inherit EOF and INTR definitions from controlling process.
+    try:
+        from termios import VEOF, VINTR
+        fd = None
+        for name in 'stdin', 'stdout':
+            stream = getattr(sys, '__%s__' % name, None)
+            if stream is None or not hasattr(stream, 'fileno'):
+                continue
+            try:
+                fd = stream.fileno()
+            except ValueError:
+                continue
+        if fd is None:
+            # no fd, raise ValueError to fallback on CEOF, CINTR
+            raise ValueError("No stream has a fileno")
+        intr = ord(termios.tcgetattr(fd)[6][VINTR])
+        eof = ord(termios.tcgetattr(fd)[6][VEOF])
+    except (ImportError, OSError, IOError, ValueError, termios.error):
+        # unless the controlling process is also not a terminal,
+        # such as cron(1), or when stdin and stdout are both closed.
+        # Fall-back to using CEOF and CINTR. There
+        try:
+            from termios import CEOF, CINTR
+            (intr, eof) = (CINTR, CEOF)
+        except ImportError:
+            #                         ^C, ^D
+            (intr, eof) = (3, 4)
+    
+    _INTR = _byte(intr)
+    _EOF = _byte(eof)
+
+# setecho and setwinsize are pulled out here because on some platforms, we need
+# to do this from the child before we exec()
+    
+def _setecho(fd, state):
+    errmsg = 'setecho() may not be called on this platform (it may still be possible to enable/disable echo when spawning the child process)'
+
+    try:
+        attr = termios.tcgetattr(fd)
+    except termios.error as err:
+        if err.args[0] == errno.EINVAL:
+            raise IOError(err.args[0], '%s: %s.' % (err.args[1], errmsg))
+        raise
+
+    if state:
+        attr[3] = attr[3] | termios.ECHO
+    else:
+        attr[3] = attr[3] & ~termios.ECHO
+
+    try:
+        # I tried TCSADRAIN and TCSAFLUSH, but these were inconsistent and
+        # blocked on some platforms. TCSADRAIN would probably be ideal.
+        termios.tcsetattr(fd, termios.TCSANOW, attr)
+    except IOError as err:
+        if err.args[0] == errno.EINVAL:
+            raise IOError(err.args[0], '%s: %s.' % (err.args[1], errmsg))
+        raise
+
+def _setwinsize(fd, rows, cols):
+    # Some very old platforms have a bug that causes the value for
+    # termios.TIOCSWINSZ to be truncated. There was a hack here to work
+    # around this, but it caused problems with newer platforms so has been
+    # removed. For details see https://github.com/pexpect/pexpect/issues/39
+    TIOCSWINSZ = getattr(termios, 'TIOCSWINSZ', -2146929561)
+    # Note, assume ws_xpixel and ws_ypixel are zero.
+    s = struct.pack('HHHH', rows, cols, 0, 0)
+    fcntl.ioctl(fd, TIOCSWINSZ, s)
+
+class PtyProcess(object):
+    '''This class represents a process running in a pseudoterminal.
+    
+    The main constructor is the :meth:`spawn` classmethod.
+    '''
+    string_type = bytes
+    if PY3:
+        linesep = os.linesep.encode('ascii')
+        crlf = '\r\n'.encode('ascii')
+
+        @staticmethod
+        def write_to_stdout(b):
+            try:
+                return sys.stdout.buffer.write(b)
+            except AttributeError:
+                # If stdout has been replaced, it may not have .buffer
+                return sys.stdout.write(b.decode('ascii', 'replace'))
+    else:
+        linesep = os.linesep
+        crlf = '\r\n'
+        write_to_stdout = sys.stdout.write
+
+    encoding = None
+    
+    argv = None
+    env = None
+    launch_dir = None
+
+    def __init__(self, pid, fd):
+        _make_eof_intr()  # Ensure _EOF and _INTR are calculated
+        self.pid = pid
+        self.fd = fd
+        readf = io.open(fd, 'rb', buffering=0)
+        writef = io.open(fd, 'wb', buffering=0, closefd=False)
+        self.fileobj = io.BufferedRWPair(readf, writef)
+
+        self.terminated = False
+        self.closed = False
+        self.exitstatus = None
+        self.signalstatus = None
+        # status returned by os.waitpid
+        self.status = None
+        self.flag_eof = False
+        # Used by close() to give kernel time to update process status.
+        # Time in seconds.
+        self.delayafterclose = 0.1
+        # Used by terminate() to give kernel time to update process status.
+        # Time in seconds.
+        self.delayafterterminate = 0.1
+
+    @classmethod
+    def spawn(
+            cls, argv, cwd=None, env=None, echo=True, preexec_fn=None,
+            dimensions=(24, 80), pass_fds=()):
+        '''Start the given command in a child process in a pseudo terminal.
+
+        This does all the fork/exec type of stuff for a pty, and returns an
+        instance of PtyProcess.
+
+        If preexec_fn is supplied, it will be called with no arguments in the
+        child process before exec-ing the specified command.
+        It may, for instance, set signal handlers to SIG_DFL or SIG_IGN.
+
+        Dimensions of the psuedoterminal used for the subprocess can be
+        specified as a tuple (rows, cols), or the default (24, 80) will be used.
+
+        By default, all file descriptors except 0, 1 and 2 are closed. This
+        behavior can be overridden with pass_fds, a list of file descriptors to
+        keep open between the parent and the child.
+        '''
+        # Note that it is difficult for this method to fail.
+        # You cannot detect if the child process cannot start.
+        # So the only way you can tell if the child process started
+        # or not is to try to read from the file descriptor. If you get
+        # EOF immediately then it means that the child is already dead.
+        # That may not necessarily be bad because you may have spawned a child
+        # that performs some task; creates no stdout output; and then dies.
+
+        if not isinstance(argv, (list, tuple)):
+            raise TypeError("Expected a list or tuple for argv, got %r" % argv)
+
+        # Shallow copy of argv so we can modify it
+        argv = argv[:]
+        command = argv[0]
+
+        command_with_path = which(command)
+        if command_with_path is None:
+            raise FileNotFoundError('The command was not found or was not ' +
+                                    'executable: %s.' % command)
+        command = command_with_path
+        argv[0] = command
+
+        # [issue #119] To prevent the case where exec fails and the user is
+        # stuck interacting with a python child process instead of whatever
+        # was expected, we implement the solution from
+        # http://stackoverflow.com/a/3703179 to pass the exception to the
+        # parent process
+
+        # [issue #119] 1. Before forking, open a pipe in the parent process.
+        exec_err_pipe_read, exec_err_pipe_write = os.pipe()
+
+        if use_native_pty_fork:
+            pid, fd = pty.fork()
+        else:
+            # Use internal fork_pty, for Solaris
+            pid, fd = _fork_pty.fork_pty()
+
+        # Some platforms must call setwinsize() and setecho() from the
+        # child process, and others from the master process. We do both,
+        # allowing IOError for either.
+
+        if pid == CHILD:
+            # set window size
+            try:
+                _setwinsize(STDIN_FILENO, *dimensions)
+            except IOError as err:
+                if err.args[0] not in (errno.EINVAL, errno.ENOTTY):
+                    raise
+
+            # disable echo if spawn argument echo was unset
+            if not echo:
+                try:
+                    _setecho(STDIN_FILENO, False)
+                except (IOError, termios.error) as err:
+                    if err.args[0] not in (errno.EINVAL, errno.ENOTTY):
+                        raise
+
+            # [issue #119] 3. The child closes the reading end and sets the
+            # close-on-exec flag for the writing end.
+            os.close(exec_err_pipe_read)
+            fcntl.fcntl(exec_err_pipe_write, fcntl.F_SETFD, fcntl.FD_CLOEXEC)
+
+            # Do not allow child to inherit open file descriptors from parent,
+            # with the exception of the exec_err_pipe_write of the pipe
+            # and pass_fds.
+            # Impose ceiling on max_fd: AIX bugfix for users with unlimited
+            # nofiles where resource.RLIMIT_NOFILE is 2^63-1 and os.closerange()
+            # occasionally raises out of range error
+            max_fd = min(1048576, resource.getrlimit(resource.RLIMIT_NOFILE)[0])
+            spass_fds = sorted(set(pass_fds) | {exec_err_pipe_write})
+            for pair in zip([2] + spass_fds, spass_fds + [max_fd]):
+                os.closerange(pair[0]+1, pair[1])
+
+            if cwd is not None:
+                os.chdir(cwd)
+
+            if preexec_fn is not None:
+                try:
+                    preexec_fn()
+                except Exception as e:
+                    ename = type(e).__name__
+                    tosend = '{}:0:{}'.format(ename, str(e))
+                    if PY3:
+                        tosend = tosend.encode('utf-8')
+
+                    os.write(exec_err_pipe_write, tosend)
+                    os.close(exec_err_pipe_write)
+                    os._exit(1)
+
+            try:
+                if env is None:
+                    os.execv(command, argv)
+                else:
+                    os.execvpe(command, argv, env)
+            except OSError as err:
+                # [issue #119] 5. If exec fails, the child writes the error
+                # code back to the parent using the pipe, then exits.
+                tosend = 'OSError:{}:{}'.format(err.errno, str(err))
+                if PY3:
+                    tosend = tosend.encode('utf-8')
+                os.write(exec_err_pipe_write, tosend)
+                os.close(exec_err_pipe_write)
+                os._exit(os.EX_OSERR)
+
+        # Parent
+        inst = cls(pid, fd)
+        
+        # Set some informational attributes
+        inst.argv = argv
+        if env is not None:
+            inst.env = env
+        if cwd is not None:
+            inst.launch_dir = cwd
+
+        # [issue #119] 2. After forking, the parent closes the writing end
+        # of the pipe and reads from the reading end.
+        os.close(exec_err_pipe_write)
+        exec_err_data = os.read(exec_err_pipe_read, 4096)
+        os.close(exec_err_pipe_read)
+
+        # [issue #119] 6. The parent reads eof (a zero-length read) if the
+        # child successfully performed exec, since close-on-exec made
+        # successful exec close the writing end of the pipe. Or, if exec
+        # failed, the parent reads the error code and can proceed
+        # accordingly. Either way, the parent blocks until the child calls
+        # exec.
+        if len(exec_err_data) != 0:
+            try:
+                errclass, errno_s, errmsg = exec_err_data.split(b':', 2)
+                exctype = getattr(builtins, errclass.decode('ascii'), Exception)
+
+                exception = exctype(errmsg.decode('utf-8', 'replace'))
+                if exctype is OSError:
+                    exception.errno = int(errno_s)
+            except:
+                raise Exception('Subprocess failed, got bad error data: %r'
+                                    % exec_err_data)
+            else:
+                raise exception
+
+        try:
+            inst.setwinsize(*dimensions)
+        except IOError as err:
+            if err.args[0] not in (errno.EINVAL, errno.ENOTTY, errno.ENXIO):
+                raise
+
+        return inst
+
+    def __repr__(self):
+        clsname = type(self).__name__
+        if self.argv is not None:
+            args = [repr(self.argv)]
+            if self.env is not None:
+                args.append("env=%r" % self.env)
+            if self.launch_dir is not None:
+                args.append("cwd=%r" % self.launch_dir)
+            
+            return "{}.spawn({})".format(clsname, ", ".join(args))
+        
+        else:
+            return "{}(pid={}, fd={})".format(clsname, self.pid, self.fd)
+
+    @staticmethod
+    def _coerce_send_string(s):
+        if not isinstance(s, bytes):
+            return s.encode('utf-8')
+        return s
+
+    @staticmethod
+    def _coerce_read_string(s):
+        return s
+
+    def __del__(self):
+        '''This makes sure that no system resources are left open. Python only
+        garbage collects Python objects. OS file descriptors are not Python
+        objects, so they must be handled explicitly. If the child file
+        descriptor was opened outside of this class (passed to the constructor)
+        then this does not close it. '''
+
+        if not self.closed:
+            # It is possible for __del__ methods to execute during the
+            # teardown of the Python VM itself. Thus self.close() may
+            # trigger an exception because os.close may be None.
+            try:
+                self.close()
+            # which exception, shouldn't we catch explicitly .. ?
+            except:
+                pass
+
+
+    def fileno(self):
+        '''This returns the file descriptor of the pty for the child.
+        '''
+        return self.fd
+
+    def close(self, force=True):
+        '''This closes the connection with the child application. Note that
+        calling close() more than once is valid. This emulates standard Python
+        behavior with files. Set force to True if you want to make sure that
+        the child is terminated (SIGKILL is sent if the child ignores SIGHUP
+        and SIGINT). '''
+        if not self.closed:
+            self.flush()
+            self.fileobj.close() # Closes the file descriptor
+            # Give kernel time to update process status.
+            time.sleep(self.delayafterclose)
+            if self.isalive():
+                if not self.terminate(force):
+                    raise PtyProcessError('Could not terminate the child.')
+            self.fd = -1
+            self.closed = True
+            #self.pid = None
+
+    def flush(self):
+        '''This does nothing. It is here to support the interface for a
+        File-like object. '''
+
+        pass
+
+    def isatty(self):
+        '''This returns True if the file descriptor is open and connected to a
+        tty(-like) device, else False.
+
+        On SVR4-style platforms implementing streams, such as SunOS and HP-UX,
+        the child pty may not appear as a terminal device.  This means
+        methods such as setecho(), setwinsize(), getwinsize() may raise an
+        IOError. '''
+
+        return os.isatty(self.fd)
+
+    def waitnoecho(self, timeout=None):
+        '''This waits until the terminal ECHO flag is set False. This returns
+        True if the echo mode is off. This returns False if the ECHO flag was
+        not set False before the timeout. This can be used to detect when the
+        child is waiting for a password. Usually a child application will turn
+        off echo mode when it is waiting for the user to enter a password. For
+        example, instead of expecting the "password:" prompt you can wait for
+        the child to set ECHO off::
+
+            p = pexpect.spawn('ssh user@example.com')
+            p.waitnoecho()
+            p.sendline(mypassword)
+
+        If timeout==None then this method to block until ECHO flag is False.
+        '''
+
+        if timeout is not None:
+            end_time = time.time() + timeout
+        while True:
+            if not self.getecho():
+                return True
+            if timeout < 0 and timeout is not None:
+                return False
+            if timeout is not None:
+                timeout = end_time - time.time()
+            time.sleep(0.1)
+
+    def getecho(self):
+        '''This returns the terminal echo mode. This returns True if echo is
+        on or False if echo is off. Child applications that are expecting you
+        to enter a password often set ECHO False. See waitnoecho().
+
+        Not supported on platforms where ``isatty()`` returns False.  '''
+
+        try:
+            attr = termios.tcgetattr(self.fd)
+        except termios.error as err:
+            errmsg = 'getecho() may not be called on this platform'
+            if err.args[0] == errno.EINVAL:
+                raise IOError(err.args[0], '%s: %s.' % (err.args[1], errmsg))
+            raise
+
+        self.echo = bool(attr[3] & termios.ECHO)
+        return self.echo
+
+    def setecho(self, state):
+        '''This sets the terminal echo mode on or off. Note that anything the
+        child sent before the echo will be lost, so you should be sure that
+        your input buffer is empty before you call setecho(). For example, the
+        following will work as expected::
+
+            p = pexpect.spawn('cat') # Echo is on by default.
+            p.sendline('1234') # We expect see this twice from the child...
+            p.expect(['1234']) # ... once from the tty echo...
+            p.expect(['1234']) # ... and again from cat itself.
+            p.setecho(False) # Turn off tty echo
+            p.sendline('abcd') # We will set this only once (echoed by cat).
+            p.sendline('wxyz') # We will set this only once (echoed by cat)
+            p.expect(['abcd'])
+            p.expect(['wxyz'])
+
+        The following WILL NOT WORK because the lines sent before the setecho
+        will be lost::
+
+            p = pexpect.spawn('cat')
+            p.sendline('1234')
+            p.setecho(False) # Turn off tty echo
+            p.sendline('abcd') # We will set this only once (echoed by cat).
+            p.sendline('wxyz') # We will set this only once (echoed by cat)
+            p.expect(['1234'])
+            p.expect(['1234'])
+            p.expect(['abcd'])
+            p.expect(['wxyz'])
+
+
+        Not supported on platforms where ``isatty()`` returns False.
+        '''
+        _setecho(self.fd, state)
+
+        self.echo = state
+
+    def read(self, size=1024):
+        """Read and return at most ``size`` bytes from the pty.
+
+        Can block if there is nothing to read. Raises :exc:`EOFError` if the
+        terminal was closed.
+        
+        Unlike Pexpect's ``read_nonblocking`` method, this doesn't try to deal
+        with the vagaries of EOF on platforms that do strange things, like IRIX
+        or older Solaris systems. It handles the errno=EIO pattern used on
+        Linux, and the empty-string return used on BSD platforms and (seemingly)
+        on recent Solaris.
+        """
+        try:
+            s = self.fileobj.read1(size)
+        except (OSError, IOError) as err:
+            if err.args[0] == errno.EIO:
+                # Linux-style EOF
+                self.flag_eof = True
+                raise EOFError('End Of File (EOF). Exception style platform.')
+            raise
+        if s == b'':
+            # BSD-style EOF (also appears to work on recent Solaris (OpenIndiana))
+            self.flag_eof = True
+            raise EOFError('End Of File (EOF). Empty string style platform.')
+
+        return s
+
+    def readline(self):
+        """Read one line from the pseudoterminal, and return it as unicode.
+
+        Can block if there is nothing to read. Raises :exc:`EOFError` if the
+        terminal was closed.
+        """
+        try:
+            s = self.fileobj.readline()
+        except (OSError, IOError) as err:
+            if err.args[0] == errno.EIO:
+                # Linux-style EOF
+                self.flag_eof = True
+                raise EOFError('End Of File (EOF). Exception style platform.')
+            raise
+        if s == b'':
+            # BSD-style EOF (also appears to work on recent Solaris (OpenIndiana))
+            self.flag_eof = True
+            raise EOFError('End Of File (EOF). Empty string style platform.')
+
+        return s
+
+    def _writeb(self, b, flush=True):
+        n = self.fileobj.write(b)
+        if flush:
+            self.fileobj.flush()
+        return n
+
+    def write(self, s, flush=True):
+        """Write bytes to the pseudoterminal.
+        
+        Returns the number of bytes written.
+        """
+        return self._writeb(s, flush=flush)
+
+    def sendcontrol(self, char):
+        '''Helper method that wraps send() with mnemonic access for sending control
+        character to the child (such as Ctrl-C or Ctrl-D).  For example, to send
+        Ctrl-G (ASCII 7, bell, '\a')::
+
+            child.sendcontrol('g')
+
+        See also, sendintr() and sendeof().
+        '''
+        char = char.lower()
+        a = ord(char)
+        if 97 <= a <= 122:
+            a = a - ord('a') + 1
+            byte = _byte(a)
+            return self._writeb(byte), byte
+        d = {'@': 0, '`': 0,
+            '[': 27, '{': 27,
+            '\\': 28, '|': 28,
+            ']': 29, '}': 29,
+            '^': 30, '~': 30,
+            '_': 31,
+            '?': 127}
+        if char not in d:
+            return 0, b''
+
+        byte = _byte(d[char])
+        return self._writeb(byte), byte
+
+    def sendeof(self):
+        '''This sends an EOF to the child. This sends a character which causes
+        the pending parent output buffer to be sent to the waiting child
+        program without waiting for end-of-line. If it is the first character
+        of the line, the read() in the user program returns 0, which signifies
+        end-of-file. This means to work as expected a sendeof() has to be
+        called at the beginning of a line. This method does not send a newline.
+        It is the responsibility of the caller to ensure the eof is sent at the
+        beginning of a line. '''
+
+        return self._writeb(_EOF), _EOF
+
+    def sendintr(self):
+        '''This sends a SIGINT to the child. It does not require
+        the SIGINT to be the first character on a line. '''
+
+        return self._writeb(_INTR), _INTR
+
+    def eof(self):
+        '''This returns True if the EOF exception was ever raised.
+        '''
+
+        return self.flag_eof
+
+    def terminate(self, force=False):
+        '''This forces a child process to terminate. It starts nicely with
+        SIGHUP and SIGINT. If "force" is True then moves onto SIGKILL. This
+        returns True if the child was terminated. This returns False if the
+        child could not be terminated. '''
+
+        if not self.isalive():
+            return True
+        try:
+            self.kill(signal.SIGHUP)
+            time.sleep(self.delayafterterminate)
+            if not self.isalive():
+                return True
+            self.kill(signal.SIGCONT)
+            time.sleep(self.delayafterterminate)
+            if not self.isalive():
+                return True
+            self.kill(signal.SIGINT)
+            time.sleep(self.delayafterterminate)
+            if not self.isalive():
+                return True
+            if force:
+                self.kill(signal.SIGKILL)
+                time.sleep(self.delayafterterminate)
+                if not self.isalive():
+                    return True
+                else:
+                    return False
+            return False
+        except OSError:
+            # I think there are kernel timing issues that sometimes cause
+            # this to happen. I think isalive() reports True, but the
+            # process is dead to the kernel.
+            # Make one last attempt to see if the kernel is up to date.
+            time.sleep(self.delayafterterminate)
+            if not self.isalive():
+                return True
+            else:
+                return False
+
+    def wait(self):
+        '''This waits until the child exits. This is a blocking call. This will
+        not read any data from the child, so this will block forever if the
+        child has unread output and has terminated. In other words, the child
+        may have printed output then called exit(), but, the child is
+        technically still alive until its output is read by the parent. '''
+
+        if self.isalive():
+            pid, status = os.waitpid(self.pid, 0)
+        else:
+            return self.exitstatus
+        self.exitstatus = os.WEXITSTATUS(status)
+        if os.WIFEXITED(status):
+            self.status = status
+            self.exitstatus = os.WEXITSTATUS(status)
+            self.signalstatus = None
+            self.terminated = True
+        elif os.WIFSIGNALED(status):
+            self.status = status
+            self.exitstatus = None
+            self.signalstatus = os.WTERMSIG(status)
+            self.terminated = True
+        elif os.WIFSTOPPED(status):  # pragma: no cover
+            # You can't call wait() on a child process in the stopped state.
+            raise PtyProcessError('Called wait() on a stopped child ' +
+                    'process. This is not supported. Is some other ' +
+                    'process attempting job control with our child pid?')
+        return self.exitstatus
+
+    def isalive(self):
+        '''This tests if the child process is running or not. This is
+        non-blocking. If the child was terminated then this will read the
+        exitstatus or signalstatus of the child. This returns True if the child
+        process appears to be running or False if not. It can take literally
+        SECONDS for Solaris to return the right status. '''
+
+        if self.terminated:
+            return False
+
+        if self.flag_eof:
+            # This is for Linux, which requires the blocking form
+            # of waitpid to get the status of a defunct process.
+            # This is super-lame. The flag_eof would have been set
+            # in read_nonblocking(), so this should be safe.
+            waitpid_options = 0
+        else:
+            waitpid_options = os.WNOHANG
+
+        try:
+            pid, status = os.waitpid(self.pid, waitpid_options)
+        except OSError as e:
+            # No child processes
+            if e.errno == errno.ECHILD:
+                raise PtyProcessError('isalive() encountered condition ' +
+                        'where "terminated" is 0, but there was no child ' +
+                        'process. Did someone else call waitpid() ' +
+                        'on our process?')
+            else:
+                raise
+
+        # I have to do this twice for Solaris.
+        # I can't even believe that I figured this out...
+        # If waitpid() returns 0 it means that no child process
+        # wishes to report, and the value of status is undefined.
+        if pid == 0:
+            try:
+                ### os.WNOHANG) # Solaris!
+                pid, status = os.waitpid(self.pid, waitpid_options)
+            except OSError as e:  # pragma: no cover
+                # This should never happen...
+                if e.errno == errno.ECHILD:
+                    raise PtyProcessError('isalive() encountered condition ' +
+                            'that should never happen. There was no child ' +
+                            'process. Did someone else call waitpid() ' +
+                            'on our process?')
+                else:
+                    raise
+
+            # If pid is still 0 after two calls to waitpid() then the process
+            # really is alive. This seems to work on all platforms, except for
+            # Irix which seems to require a blocking call on waitpid or select,
+            # so I let read_nonblocking take care of this situation
+            # (unfortunately, this requires waiting through the timeout).
+            if pid == 0:
+                return True
+
+        if pid == 0:
+            return True
+
+        if os.WIFEXITED(status):
+            self.status = status
+            self.exitstatus = os.WEXITSTATUS(status)
+            self.signalstatus = None
+            self.terminated = True
+        elif os.WIFSIGNALED(status):
+            self.status = status
+            self.exitstatus = None
+            self.signalstatus = os.WTERMSIG(status)
+            self.terminated = True
+        elif os.WIFSTOPPED(status):
+            raise PtyProcessError('isalive() encountered condition ' +
+                    'where child process is stopped. This is not ' +
+                    'supported. Is some other process attempting ' +
+                    'job control with our child pid?')
+        return False
+
+    def kill(self, sig):
+        """Send the given signal to the child application.
+
+        In keeping with UNIX tradition it has a misleading name. It does not
+        necessarily kill the child unless you send the right signal. See the
+        :mod:`signal` module for constants representing signal numbers.
+        """
+
+        # Same as os.kill, but the pid is given for you.
+        if self.isalive():
+            os.kill(self.pid, sig)
+
+    def getwinsize(self):
+        """Return the window size of the pseudoterminal as a tuple (rows, cols).
+        """
+        TIOCGWINSZ = getattr(termios, 'TIOCGWINSZ', 1074295912)
+        s = struct.pack('HHHH', 0, 0, 0, 0)
+        x = fcntl.ioctl(self.fd, TIOCGWINSZ, s)
+        return struct.unpack('HHHH', x)[0:2]
+
+    def setwinsize(self, rows, cols):
+        """Set the terminal window size of the child tty.
+
+        This will cause a SIGWINCH signal to be sent to the child. This does not
+        change the physical window size. It changes the size reported to
+        TTY-aware applications like vi or curses -- applications that respond to
+        the SIGWINCH signal.
+        """
+        return _setwinsize(self.fd, rows, cols)
+
+
+class PtyProcessUnicode(PtyProcess):
+    """Unicode wrapper around a process running in a pseudoterminal.
+
+    This class exposes a similar interface to :class:`PtyProcess`, but its read
+    methods return unicode, and its :meth:`write` accepts unicode.
+    """
+    if PY3:
+        string_type = str
+    else:
+        string_type = unicode   # analysis:ignore
+
+    def __init__(self, pid, fd, encoding='utf-8', codec_errors='strict'):
+        super(PtyProcessUnicode, self).__init__(pid, fd)
+        self.encoding = encoding
+        self.codec_errors = codec_errors
+        self.decoder = codecs.getincrementaldecoder(encoding)(errors=codec_errors)
+
+    def read(self, size=1024):
+        """Read at most ``size`` bytes from the pty, return them as unicode.
+
+        Can block if there is nothing to read. Raises :exc:`EOFError` if the
+        terminal was closed.
+
+        The size argument still refers to bytes, not unicode code points.
+        """
+        b = super(PtyProcessUnicode, self).read(size)
+        return self.decoder.decode(b, final=False)
+
+    def readline(self):
+        """Read one line from the pseudoterminal, and return it as unicode.
+
+        Can block if there is nothing to read. Raises :exc:`EOFError` if the
+        terminal was closed.
+        """
+        b = super(PtyProcessUnicode, self).readline()
+        return self.decoder.decode(b, final=False)
+
+    def write(self, s):
+        """Write the unicode string ``s`` to the pseudoterminal.
+
+        Returns the number of bytes written.
+        """
+        b = s.encode(self.encoding)
+        return super(PtyProcessUnicode, self).write(b)
diff --git a/env/lib/python3.12/site-packages/ptyprocess/util.py b/env/lib/python3.12/site-packages/ptyprocess/util.py
new file mode 100644
index 0000000..aadbd62
--- /dev/null
+++ b/env/lib/python3.12/site-packages/ptyprocess/util.py
@@ -0,0 +1,71 @@
+try:
+    from shutil import which  # Python >= 3.3
+except ImportError:
+    import os, sys
+    
+    # This is copied from Python 3.4.1
+    def which(cmd, mode=os.F_OK | os.X_OK, path=None):
+        """Given a command, mode, and a PATH string, return the path which
+        conforms to the given mode on the PATH, or None if there is no such
+        file.
+    
+        `mode` defaults to os.F_OK | os.X_OK. `path` defaults to the result
+        of os.environ.get("PATH"), or can be overridden with a custom search
+        path.
+    
+        """
+        # Check that a given file can be accessed with the correct mode.
+        # Additionally check that `file` is not a directory, as on Windows
+        # directories pass the os.access check.
+        def _access_check(fn, mode):
+            return (os.path.exists(fn) and os.access(fn, mode)
+                    and not os.path.isdir(fn))
+    
+        # If we're given a path with a directory part, look it up directly rather
+        # than referring to PATH directories. This includes checking relative to the
+        # current directory, e.g. ./script
+        if os.path.dirname(cmd):
+            if _access_check(cmd, mode):
+                return cmd
+            return None
+    
+        if path is None:
+            path = os.environ.get("PATH", os.defpath)
+        if not path:
+            return None
+        path = path.split(os.pathsep)
+    
+        if sys.platform == "win32":
+            # The current directory takes precedence on Windows.
+            if not os.curdir in path:
+                path.insert(0, os.curdir)
+    
+            # PATHEXT is necessary to check on Windows.
+            pathext = os.environ.get("PATHEXT", "").split(os.pathsep)
+            # See if the given file matches any of the expected path extensions.
+            # This will allow us to short circuit when given "python.exe".
+            # If it does match, only test that one, otherwise we have to try
+            # others.
+            if any(cmd.lower().endswith(ext.lower()) for ext in pathext):
+                files = [cmd]
+            else:
+                files = [cmd + ext for ext in pathext]
+        else:
+            # On other platforms you don't have things like PATHEXT to tell you
+            # what file suffixes are executable, so just pass on cmd as-is.
+            files = [cmd]
+    
+        seen = set()
+        for dir in path:
+            normdir = os.path.normcase(dir)
+            if not normdir in seen:
+                seen.add(normdir)
+                for thefile in files:
+                    name = os.path.join(dir, thefile)
+                    if _access_check(name, mode):
+                        return name
+        return None
+
+
+class PtyProcessError(Exception):
+    """Generic error class for this package."""
diff --git a/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/INSTALLER b/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/LICENSE.txt b/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/LICENSE.txt
new file mode 100644
index 0000000..473e36e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/LICENSE.txt
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Alex Hall
+
+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/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/METADATA b/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/METADATA
new file mode 100644
index 0000000..1f086de
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/METADATA
@@ -0,0 +1,227 @@
+Metadata-Version: 2.1
+Name: pure_eval
+Version: 0.2.3
+Summary: Safely evaluate AST nodes without side effects
+Home-page: http://github.com/alexmojaki/pure_eval
+Author: Alex Hall
+Author-email: alex.mojaki@gmail.com
+License: MIT
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Provides-Extra: tests
+Requires-Dist: pytest ; extra == 'tests'
+
+# `pure_eval`
+
+[![Build Status](https://travis-ci.org/alexmojaki/pure_eval.svg?branch=master)](https://travis-ci.org/alexmojaki/pure_eval) [![Coverage Status](https://coveralls.io/repos/github/alexmojaki/pure_eval/badge.svg?branch=master)](https://coveralls.io/github/alexmojaki/pure_eval?branch=master) [![Supports Python versions 3.7+](https://img.shields.io/pypi/pyversions/pure_eval.svg)](https://pypi.python.org/pypi/pure_eval)
+
+This is a Python package that lets you safely evaluate certain AST nodes without triggering arbitrary code that may have unwanted side effects.
+
+It can be installed from PyPI:
+
+    pip install pure_eval
+
+To demonstrate usage, suppose we have an object defined as follows:
+
+```python
+class Rectangle:
+    def __init__(self, width, height):
+        self.width = width
+        self.height = height
+
+    @property
+    def area(self):
+        print("Calculating area...")
+        return self.width * self.height
+
+
+rect = Rectangle(3, 5)
+```
+
+Given the `rect` object, we want to evaluate whatever expressions we can in this source code:
+
+```python
+source = "(rect.width, rect.height, rect.area)"
+```
+
+This library works with the AST, so let's parse the source code and peek inside:
+
+```python
+import ast
+
+tree = ast.parse(source)
+the_tuple = tree.body[0].value
+for node in the_tuple.elts:
+    print(ast.dump(node))
+```
+
+Output:
+
+```python
+Attribute(value=Name(id='rect', ctx=Load()), attr='width', ctx=Load())
+Attribute(value=Name(id='rect', ctx=Load()), attr='height', ctx=Load())
+Attribute(value=Name(id='rect', ctx=Load()), attr='area', ctx=Load())
+```
+
+Now to actually use the library. First construct an Evaluator:
+
+```python
+from pure_eval import Evaluator
+
+evaluator = Evaluator({"rect": rect})
+```
+
+The argument to `Evaluator` should be a mapping from variable names to their values. Or if you have access to the stack frame where `rect` is defined, you can instead use:
+
+```python
+evaluator = Evaluator.from_frame(frame)
+```
+
+Now to evaluate some nodes, using `evaluator[node]`:
+
+```python
+print("rect.width:", evaluator[the_tuple.elts[0]])
+print("rect:", evaluator[the_tuple.elts[0].value])
+```
+
+Output:
+
+```
+rect.width: 3
+rect: <__main__.Rectangle object at 0x105b0dd30>
+```
+
+OK, but you could have done the same thing with `eval`. The useful part is that it will refuse to evaluate the property `rect.area` because that would trigger unknown code. If we try, it'll raise a `CannotEval` exception.
+
+```python
+from pure_eval import CannotEval
+
+try:
+    print("rect.area:", evaluator[the_tuple.elts[2]])  # fails
+except CannotEval as e:
+    print(e)  # prints CannotEval
+```
+
+To find all the expressions that can be evaluated in a tree:
+
+```python
+for node, value in evaluator.find_expressions(tree):
+    print(ast.dump(node), value)
+```
+
+Output:
+
+```python
+Attribute(value=Name(id='rect', ctx=Load()), attr='width', ctx=Load()) 3
+Attribute(value=Name(id='rect', ctx=Load()), attr='height', ctx=Load()) 5
+Name(id='rect', ctx=Load()) <__main__.Rectangle object at 0x105568d30>
+Name(id='rect', ctx=Load()) <__main__.Rectangle object at 0x105568d30>
+Name(id='rect', ctx=Load()) <__main__.Rectangle object at 0x105568d30>
+```
+
+Note that this includes `rect` three times, once for each appearance in the source code. Since all these nodes are equivalent, we can group them together:
+
+```python
+from pure_eval import group_expressions
+
+for nodes, values in group_expressions(evaluator.find_expressions(tree)):
+    print(len(nodes), "nodes with value:", values)
+```
+
+Output:
+
+```
+1 nodes with value: 3
+1 nodes with value: 5
+3 nodes with value: <__main__.Rectangle object at 0x10d374d30>
+```
+
+If we want to list all the expressions in a tree, we may want to filter out certain expressions whose values are obvious. For example, suppose we have a function `foo`:
+
+```python
+def foo():
+    pass
+```
+
+If we refer to `foo` by its name as usual, then that's not interesting:
+
+```python
+from pure_eval import is_expression_interesting
+
+node = ast.parse('foo').body[0].value
+print(ast.dump(node))
+print(is_expression_interesting(node, foo))
+```
+
+Output:
+
+```python
+Name(id='foo', ctx=Load())
+False
+```
+
+But if we refer to it by a different name, then it's interesting:
+
+```python
+node = ast.parse('bar').body[0].value
+print(ast.dump(node))
+print(is_expression_interesting(node, foo))
+```
+
+Output:
+
+```python
+Name(id='bar', ctx=Load())
+True
+```
+
+In general `is_expression_interesting` returns False for the following values:
+- Literals (e.g. `123`, `'abc'`, `[1, 2, 3]`, `{'a': (), 'b': ([1, 2], [3])}`)
+- Variables or attributes whose name is equal to the value's `__name__`, such as `foo` above or `self.foo` if it was a method.
+- Builtins (e.g. `len`) referred to by their usual name.
+
+To make things easier, you can combine finding expressions, grouping them, and filtering out the obvious ones with:
+
+```python
+evaluator.interesting_expressions_grouped(root)
+```
+
+To get the source code of an AST node, I recommend [asttokens](https://github.com/gristlabs/asttokens).
+
+Here's a complete example that brings it all together:
+
+```python
+from asttokens import ASTTokens
+from pure_eval import Evaluator
+
+source = """
+x = 1
+d = {x: 2}
+y = d[x]
+"""
+
+names = {}
+exec(source, names)
+atok = ASTTokens(source, parse=True)
+for nodes, value in Evaluator(names).interesting_expressions_grouped(atok.tree):
+    print(atok.get_text(nodes[0]), "=", value)
+```
+
+Output:
+
+```python
+x = 1
+d = {1: 2}
+y = 2
+d[x] = 2
+```
diff --git a/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/RECORD b/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/RECORD
new file mode 100644
index 0000000..9831042
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/RECORD
@@ -0,0 +1,17 @@
+pure_eval-0.2.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+pure_eval-0.2.3.dist-info/LICENSE.txt,sha256=pHaiyw70xBRQNApXeii5GsTH9mkTay7hSAR_q9X8QYE,1066
+pure_eval-0.2.3.dist-info/METADATA,sha256=l82tM1W_MINmjopemK0qlYzWiDmzaaNbFx43KrSO6YY,6278
+pure_eval-0.2.3.dist-info/RECORD,,
+pure_eval-0.2.3.dist-info/WHEEL,sha256=rWxmBtp7hEUqVLOnTaDOPpR-cZpCDkzhhcBce-Zyd5k,91
+pure_eval-0.2.3.dist-info/top_level.txt,sha256=aj24vzw3wc3XsL3Q0sHidIX6N7TaViEDr1R_R4Qbgjo,10
+pure_eval/__init__.py,sha256=DpFIfiwokBuz5-L8P-g_j7hrkbhbFg_PR6F97UFgA5E,434
+pure_eval/__pycache__/__init__.cpython-312.pyc,,
+pure_eval/__pycache__/core.cpython-312.pyc,,
+pure_eval/__pycache__/my_getattr_static.cpython-312.pyc,,
+pure_eval/__pycache__/utils.cpython-312.pyc,,
+pure_eval/__pycache__/version.cpython-312.pyc,,
+pure_eval/core.py,sha256=bxshWghVwCawdVfrNdXLqHj5UOpaPz1aAkB0T3xh_3Q,15309
+pure_eval/my_getattr_static.py,sha256=6FwKIbg3hLXgY8onaK_L1lyRJKjLVNGggs5Sz6uhWMc,4161
+pure_eval/py.typed,sha256=w3xYJo71zA7pDnF65xr6u8FL8gvJ7GdAKMJSLuv2IPU,68
+pure_eval/utils.py,sha256=sPZn0PAiR24_bijsaVtnv7GZKT2axv86rFb3cGhB_5Y,4612
+pure_eval/version.py,sha256=zobUzQ8dmi7v_frbQtjAC1pacNJVbwA_3bMaeLotBMU,21
diff --git a/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/WHEEL b/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/WHEEL
new file mode 100644
index 0000000..fd680b3
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (71.0.4)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/top_level.txt b/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/top_level.txt
new file mode 100644
index 0000000..e50c81f
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pure_eval-0.2.3.dist-info/top_level.txt
@@ -0,0 +1 @@
+pure_eval
diff --git a/env/lib/python3.12/site-packages/pure_eval/__init__.py b/env/lib/python3.12/site-packages/pure_eval/__init__.py
new file mode 100644
index 0000000..ec4ba73
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pure_eval/__init__.py
@@ -0,0 +1,17 @@
+from .core import Evaluator, CannotEval, group_expressions, is_expression_interesting
+from .my_getattr_static import getattr_static
+
+try:
+    from .version import __version__
+except ImportError:
+    # version.py is auto-generated with the git tag when building
+    __version__ = "???"
+
+__all__ = [
+    "Evaluator",
+    "CannotEval",
+    "group_expressions",
+    "is_expression_interesting",
+    "getattr_static",
+    "__version__",
+]
diff --git a/env/lib/python3.12/site-packages/pure_eval/core.py b/env/lib/python3.12/site-packages/pure_eval/core.py
new file mode 100644
index 0000000..748f051
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pure_eval/core.py
@@ -0,0 +1,449 @@
+import ast
+import builtins
+import operator
+from collections import ChainMap, OrderedDict, deque
+from contextlib import suppress
+from types import FrameType
+from typing import Any, Tuple, Iterable, List, Mapping, Dict, Union, Set
+
+from pure_eval.my_getattr_static import getattr_static
+from pure_eval.utils import (
+    CannotEval,
+    has_ast_name,
+    copy_ast_without_context,
+    is_standard_types,
+    of_standard_types,
+    is_any,
+    of_type,
+    ensure_dict,
+)
+
+
+class Evaluator:
+    def __init__(self, names: Mapping[str, Any]):
+        """
+        Construct a new evaluator with the given variable names.
+        This is a low level API, typically you will use `Evaluator.from_frame(frame)`.
+
+        :param names: a mapping from variable names to their values.
+        """
+
+        self.names = names
+        self._cache = {}  # type: Dict[ast.expr, Any]
+
+    @classmethod
+    def from_frame(cls, frame: FrameType) -> 'Evaluator':
+        """
+        Construct an Evaluator that can look up variables from the given frame.
+
+        :param frame: a frame object, e.g. from a traceback or `inspect.currentframe().f_back`.
+        """
+
+        return cls(ChainMap(
+            ensure_dict(frame.f_locals),
+            ensure_dict(frame.f_globals),
+            ensure_dict(frame.f_builtins),
+        ))
+
+    def __getitem__(self, node: ast.expr) -> Any:
+        """
+        Find the value of the given node.
+        If it cannot be evaluated safely, this raises `CannotEval`.
+        The result is cached either way.
+
+        :param node: an AST expression to evaluate
+        :return: the value of the node
+        """
+
+        if not isinstance(node, ast.expr):
+            raise TypeError("node should be an ast.expr, not {!r}".format(type(node).__name__))
+
+        with suppress(KeyError):
+            result = self._cache[node]
+            if result is CannotEval:
+                raise CannotEval
+            else:
+                return result
+
+        try:
+            self._cache[node] = result = self._handle(node)
+            return result
+        except CannotEval:
+            self._cache[node] = CannotEval
+            raise
+
+    def _handle(self, node: ast.expr) -> Any:
+        """
+        This is where the evaluation happens.
+        Users should use `__getitem__`, i.e. `evaluator[node]`,
+        as it provides caching.
+
+        :param node: an AST expression to evaluate
+        :return: the value of the node
+        """
+
+        with suppress(Exception):
+            return ast.literal_eval(node)
+
+        if isinstance(node, ast.Name):
+            try:
+                return self.names[node.id]
+            except KeyError:
+                raise CannotEval
+        elif isinstance(node, ast.Attribute):
+            value = self[node.value]
+            attr = node.attr
+            return getattr_static(value, attr)
+        elif isinstance(node, ast.Subscript):
+            return self._handle_subscript(node)
+        elif isinstance(node, (ast.List, ast.Tuple, ast.Set, ast.Dict)):
+            return self._handle_container(node)
+        elif isinstance(node, ast.UnaryOp):
+            return self._handle_unary(node)
+        elif isinstance(node, ast.BinOp):
+            return self._handle_binop(node)
+        elif isinstance(node, ast.BoolOp):
+            return self._handle_boolop(node)
+        elif isinstance(node, ast.Compare):
+            return self._handle_compare(node)
+        elif isinstance(node, ast.Call):
+            return self._handle_call(node)
+        raise CannotEval
+
+    def _handle_call(self, node):
+        if node.keywords:
+            raise CannotEval
+        func = self[node.func]
+        args = [self[arg] for arg in node.args]
+
+        if (
+            is_any(
+                func,
+                slice,
+                int,
+                range,
+                round,
+                complex,
+                list,
+                tuple,
+                abs,
+                hex,
+                bin,
+                oct,
+                bool,
+                ord,
+                float,
+                len,
+                chr,
+            )
+            or len(args) == 0
+            and is_any(func, set, dict, str, frozenset, bytes, bytearray, object)
+            or len(args) >= 2
+            and is_any(func, str, divmod, bytes, bytearray, pow)
+        ):
+            args = [
+                of_standard_types(arg, check_dict_values=False, deep=False)
+                for arg in args
+            ]
+            try:
+                return func(*args)
+            except Exception as e:
+                raise CannotEval from e
+
+        if len(args) == 1:
+            arg = args[0]
+            if is_any(func, id, type):
+                try:
+                    return func(arg)
+                except Exception as e:
+                    raise CannotEval from e
+            if is_any(func, all, any, sum):
+                of_type(arg, tuple, frozenset, list, set, dict, OrderedDict, deque)
+                for x in arg:
+                    of_standard_types(x, check_dict_values=False, deep=False)
+                try:
+                    return func(arg)
+                except Exception as e:
+                    raise CannotEval from e
+
+            if is_any(
+                func, sorted, min, max, hash, set, dict, ascii, str, repr, frozenset
+            ):
+                of_standard_types(arg, check_dict_values=True, deep=True)
+                try:
+                    return func(arg)
+                except Exception as e:
+                    raise CannotEval from e
+        raise CannotEval
+
+    def _handle_compare(self, node):
+        left = self[node.left]
+        result = True
+
+        for op, right in zip(node.ops, node.comparators):
+            right = self[right]
+
+            op_type = type(op)
+            op_func = {
+                ast.Eq: operator.eq,
+                ast.NotEq: operator.ne,
+                ast.Lt: operator.lt,
+                ast.LtE: operator.le,
+                ast.Gt: operator.gt,
+                ast.GtE: operator.ge,
+                ast.Is: operator.is_,
+                ast.IsNot: operator.is_not,
+                ast.In: (lambda a, b: a in b),
+                ast.NotIn: (lambda a, b: a not in b),
+            }[op_type]
+
+            if op_type not in (ast.Is, ast.IsNot):
+                of_standard_types(left, check_dict_values=False, deep=True)
+                of_standard_types(right, check_dict_values=False, deep=True)
+
+            try:
+                result = op_func(left, right)
+            except Exception as e:
+                raise CannotEval from e
+            if not result:
+                return result
+            left = right
+
+        return result
+
+    def _handle_boolop(self, node):
+        left = of_standard_types(
+            self[node.values[0]], check_dict_values=False, deep=False
+        )
+
+        for right in node.values[1:]:
+            # We need short circuiting so that the whole operation can be evaluated
+            # even if the right operand can't
+            if isinstance(node.op, ast.Or):
+                left = left or of_standard_types(
+                    self[right], check_dict_values=False, deep=False
+                )
+            else:
+                assert isinstance(node.op, ast.And)
+                left = left and of_standard_types(
+                    self[right], check_dict_values=False, deep=False
+                )
+        return left
+
+    def _handle_binop(self, node):
+        op_type = type(node.op)
+        op = {
+            ast.Add: operator.add,
+            ast.Sub: operator.sub,
+            ast.Mult: operator.mul,
+            ast.Div: operator.truediv,
+            ast.FloorDiv: operator.floordiv,
+            ast.Mod: operator.mod,
+            ast.Pow: operator.pow,
+            ast.LShift: operator.lshift,
+            ast.RShift: operator.rshift,
+            ast.BitOr: operator.or_,
+            ast.BitXor: operator.xor,
+            ast.BitAnd: operator.and_,
+        }.get(op_type)
+        if not op:
+            raise CannotEval
+        left = self[node.left]
+        hash_type = is_any(type(left), set, frozenset, dict, OrderedDict)
+        left = of_standard_types(left, check_dict_values=False, deep=hash_type)
+        formatting = type(left) in (str, bytes) and op_type == ast.Mod
+
+        right = of_standard_types(
+            self[node.right],
+            check_dict_values=formatting,
+            deep=formatting or hash_type,
+        )
+        try:
+            return op(left, right)
+        except Exception as e:
+            raise CannotEval from e
+
+    def _handle_unary(self, node: ast.UnaryOp):
+        value = of_standard_types(
+            self[node.operand], check_dict_values=False, deep=False
+        )
+        op_type = type(node.op)
+        op = {
+            ast.USub: operator.neg,
+            ast.UAdd: operator.pos,
+            ast.Not: operator.not_,
+            ast.Invert: operator.invert,
+        }[op_type]
+        try:
+            return op(value)
+        except Exception as e:
+            raise CannotEval from e
+
+    def _handle_subscript(self, node):
+        value = self[node.value]
+        of_standard_types(
+            value, check_dict_values=False, deep=is_any(type(value), dict, OrderedDict)
+        )
+        index = node.slice
+        if isinstance(index, ast.Slice):
+            index = slice(
+                *[
+                    None if p is None else self[p]
+                    for p in [index.lower, index.upper, index.step]
+                ]
+            )
+        elif isinstance(index, ast.ExtSlice):
+            raise CannotEval
+        else:
+            if isinstance(index, ast.Index):
+                index = index.value
+            index = self[index]
+        of_standard_types(index, check_dict_values=False, deep=True)
+
+        try:
+            return value[index]
+        except Exception:
+            raise CannotEval
+
+    def _handle_container(
+            self,
+            node: Union[ast.List, ast.Tuple, ast.Set, ast.Dict]
+    ) -> Union[List, Tuple, Set, Dict]:
+        """Handle container nodes, including List, Set, Tuple and Dict"""
+        if isinstance(node, ast.Dict):
+            elts = node.keys
+            if None in elts:  # ** unpacking inside {}, not yet supported
+                raise CannotEval
+        else:
+            elts = node.elts
+        elts = [self[elt] for elt in elts]
+        if isinstance(node, ast.List):
+            return elts
+        if isinstance(node, ast.Tuple):
+            return tuple(elts)
+
+        # Set and Dict
+        if not all(
+            is_standard_types(elt, check_dict_values=False, deep=True) for elt in elts
+        ):
+            raise CannotEval
+
+        if isinstance(node, ast.Set):
+            try:
+                return set(elts)
+            except TypeError:
+                raise CannotEval
+
+        assert isinstance(node, ast.Dict)
+
+        pairs = [(elt, self[val]) for elt, val in zip(elts, node.values)]
+        try:
+            return dict(pairs)
+        except TypeError:
+            raise CannotEval
+
+    def find_expressions(self, root: ast.AST) -> Iterable[Tuple[ast.expr, Any]]:
+        """
+        Find all expressions in the given tree that can be safely evaluated.
+        This is a low level API, typically you will use `interesting_expressions_grouped`.
+
+        :param root: any AST node
+        :return: generator of pairs (tuples) of expression nodes and their corresponding values.
+        """
+
+        for node in ast.walk(root):
+            if not isinstance(node, ast.expr):
+                continue
+
+            try:
+                value = self[node]
+            except CannotEval:
+                continue
+
+            yield node, value
+
+    def interesting_expressions_grouped(self, root: ast.AST) -> List[Tuple[List[ast.expr], Any]]:
+        """
+        Find all interesting expressions in the given tree that can be safely evaluated,
+        grouping equivalent nodes together.
+
+        For more control and details, see:
+         - Evaluator.find_expressions
+         - is_expression_interesting
+         - group_expressions
+
+        :param root: any AST node
+        :return: A list of pairs (tuples) containing:
+                    - A list of equivalent AST expressions
+                    - The value of the first expression node
+                       (which should be the same for all nodes, unless threads are involved)
+        """
+
+        return group_expressions(
+            pair
+            for pair in self.find_expressions(root)
+            if is_expression_interesting(*pair)
+        )
+
+
+def is_expression_interesting(node: ast.expr, value: Any) -> bool:
+    """
+    Determines if an expression is potentially interesting, at least in my opinion.
+    Returns False for the following expressions whose value is generally obvious:
+        - Literals (e.g. 123, 'abc', [1, 2, 3], {'a': (), 'b': ([1, 2], [3])})
+        - Variables or attributes whose name is equal to the value's __name__.
+            For example, a function `def foo(): ...` is not interesting when referred to
+            as `foo` as it usually would, but `bar` can be interesting if `bar is foo`.
+            Similarly the method `self.foo` is not interesting.
+        - Builtins (e.g. `len`) referred to by their usual name.
+
+    This is a low level API, typically you will use `interesting_expressions_grouped`.
+
+    :param node: an AST expression
+    :param value: the value of the node
+    :return: a boolean: True if the expression is interesting, False otherwise
+    """
+
+    with suppress(ValueError):
+        ast.literal_eval(node)
+        return False
+
+    # TODO exclude inner modules, e.g. numpy.random.__name__ == 'numpy.random' != 'random'
+    # TODO exclude common module abbreviations, e.g. numpy as np, pandas as pd
+    if has_ast_name(value, node):
+        return False
+
+    if (
+            isinstance(node, ast.Name)
+            and getattr(builtins, node.id, object()) is value
+    ):
+        return False
+
+    return True
+
+
+def group_expressions(expressions: Iterable[Tuple[ast.expr, Any]]) -> List[Tuple[List[ast.expr], Any]]:
+    """
+    Organise expression nodes and their values such that equivalent nodes are together.
+    Two nodes are considered equivalent if they have the same structure,
+    ignoring context (Load, Store, or Delete) and location (lineno, col_offset).
+    For example, this will group together the same variable name mentioned multiple times in an expression.
+
+    This will not check the values of the nodes. Equivalent nodes should have the same values,
+    unless threads are involved.
+
+    This is a low level API, typically you will use `interesting_expressions_grouped`.
+
+    :param expressions: pairs of AST expressions and their values, as obtained from
+                          `Evaluator.find_expressions`, or `(node, evaluator[node])`.
+    :return: A list of pairs (tuples) containing:
+                - A list of equivalent AST expressions
+                - The value of the first expression node
+                   (which should be the same for all nodes, unless threads are involved)
+    """
+
+    result = {}
+    for node, value in expressions:
+        dump = ast.dump(copy_ast_without_context(node))
+        result.setdefault(dump, ([], value))[0].append(node)
+    return list(result.values())
diff --git a/env/lib/python3.12/site-packages/pure_eval/my_getattr_static.py b/env/lib/python3.12/site-packages/pure_eval/my_getattr_static.py
new file mode 100644
index 0000000..5490b90
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pure_eval/my_getattr_static.py
@@ -0,0 +1,140 @@
+import types
+
+from pure_eval.utils import of_type, CannotEval
+
+_sentinel = object()
+
+
+def _static_getmro(klass):
+    return type.__dict__['__mro__'].__get__(klass)
+
+
+def _check_instance(obj, attr):
+    instance_dict = {}
+    try:
+        instance_dict = object.__getattribute__(obj, "__dict__")
+    except AttributeError:
+        pass
+    return dict.get(instance_dict, attr, _sentinel)
+
+
+def _check_class(klass, attr):
+    for entry in _static_getmro(klass):
+        if _shadowed_dict(type(entry)) is _sentinel:
+            try:
+                return entry.__dict__[attr]
+            except KeyError:
+                pass
+        else:
+            break
+    return _sentinel
+
+
+def _is_type(obj):
+    try:
+        _static_getmro(obj)
+    except TypeError:
+        return False
+    return True
+
+
+def _shadowed_dict(klass):
+    dict_attr = type.__dict__["__dict__"]
+    for entry in _static_getmro(klass):
+        try:
+            class_dict = dict_attr.__get__(entry)["__dict__"]
+        except KeyError:
+            pass
+        else:
+            if not (type(class_dict) is types.GetSetDescriptorType and
+                    class_dict.__name__ == "__dict__" and
+                    class_dict.__objclass__ is entry):
+                return class_dict
+    return _sentinel
+
+
+def getattr_static(obj, attr):
+    """Retrieve attributes without triggering dynamic lookup via the
+       descriptor protocol,  __getattr__ or __getattribute__.
+
+       Note: this function may not be able to retrieve all attributes
+       that getattr can fetch (like dynamically created attributes)
+       and may find attributes that getattr can't (like descriptors
+       that raise AttributeError). It can also return descriptor objects
+       instead of instance members in some cases. See the
+       documentation for details.
+    """
+    instance_result = _sentinel
+    if not _is_type(obj):
+        klass = type(obj)
+        dict_attr = _shadowed_dict(klass)
+        if (dict_attr is _sentinel or
+                type(dict_attr) is types.MemberDescriptorType):
+            instance_result = _check_instance(obj, attr)
+        else:
+            raise CannotEval
+    else:
+        klass = obj
+
+    klass_result = _check_class(klass, attr)
+
+    if instance_result is not _sentinel and klass_result is not _sentinel:
+        if _check_class(type(klass_result), "__get__") is not _sentinel and (
+            _check_class(type(klass_result), "__set__") is not _sentinel
+            or _check_class(type(klass_result), "__delete__") is not _sentinel
+        ):
+            return _resolve_descriptor(klass_result, obj, klass)
+
+    if instance_result is not _sentinel:
+        return instance_result
+    if klass_result is not _sentinel:
+        get = _check_class(type(klass_result), '__get__')
+        if get is _sentinel:
+            return klass_result
+        else:
+            if obj is klass:
+                instance = None
+            else:
+                instance = obj
+            return _resolve_descriptor(klass_result, instance, klass)
+
+    if obj is klass:
+        # for types we check the metaclass too
+        for entry in _static_getmro(type(klass)):
+            if _shadowed_dict(type(entry)) is _sentinel:
+                try:
+                    result = entry.__dict__[attr]
+                    get = _check_class(type(result), '__get__')
+                    if get is not _sentinel:
+                        raise CannotEval
+                    return result
+                except KeyError:
+                    pass
+    raise CannotEval
+
+
+class _foo:
+    __slots__ = ['foo']
+    method = lambda: 0
+
+
+slot_descriptor = _foo.foo
+wrapper_descriptor = str.__dict__['__add__']
+method_descriptor = str.__dict__['startswith']
+user_method_descriptor = _foo.__dict__['method']
+
+safe_descriptors_raw = [
+    slot_descriptor,
+    wrapper_descriptor,
+    method_descriptor,
+    user_method_descriptor,
+]
+
+safe_descriptor_types = list(map(type, safe_descriptors_raw))
+
+
+def _resolve_descriptor(d, instance, owner):
+    try:
+        return type(of_type(d, *safe_descriptor_types)).__get__(d, instance, owner)
+    except AttributeError as e:
+        raise CannotEval from e
diff --git a/env/lib/python3.12/site-packages/pure_eval/py.typed b/env/lib/python3.12/site-packages/pure_eval/py.typed
new file mode 100644
index 0000000..298c64a
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pure_eval/py.typed
@@ -0,0 +1 @@
+# Marker file for PEP 561. The pure_eval package uses inline types.
diff --git a/env/lib/python3.12/site-packages/pure_eval/utils.py b/env/lib/python3.12/site-packages/pure_eval/utils.py
new file mode 100644
index 0000000..19ead65
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pure_eval/utils.py
@@ -0,0 +1,206 @@
+from collections import OrderedDict, deque
+from datetime import date, time, datetime
+from decimal import Decimal
+from fractions import Fraction
+import ast
+import enum
+import typing
+
+
+class CannotEval(Exception):
+    def __repr__(self):
+        return self.__class__.__name__
+
+    __str__ = __repr__
+
+
+def is_any(x, *args):
+    return any(
+        x is arg
+        for arg in args
+    )
+
+
+def of_type(x, *types):
+    if is_any(type(x), *types):
+        return x
+    else:
+        raise CannotEval
+
+
+def of_standard_types(x, *, check_dict_values: bool, deep: bool):
+    if is_standard_types(x, check_dict_values=check_dict_values, deep=deep):
+        return x
+    else:
+        raise CannotEval
+
+
+def is_standard_types(x, *, check_dict_values: bool, deep: bool):
+    try:
+        return _is_standard_types_deep(x, check_dict_values, deep)[0]
+    except RecursionError:
+        return False
+
+
+def _is_standard_types_deep(x, check_dict_values: bool, deep: bool):
+    typ = type(x)
+    if is_any(
+        typ,
+        str,
+        int,
+        bool,
+        float,
+        bytes,
+        complex,
+        date,
+        time,
+        datetime,
+        Fraction,
+        Decimal,
+        type(None),
+        object,
+    ):
+        return True, 0
+
+    if is_any(typ, tuple, frozenset, list, set, dict, OrderedDict, deque, slice):
+        if typ in [slice]:
+            length = 0
+        else:
+            length = len(x)
+        assert isinstance(deep, bool)
+        if not deep:
+            return True, length
+
+        if check_dict_values and typ in (dict, OrderedDict):
+            items = (v for pair in x.items() for v in pair)
+        elif typ is slice:
+            items = [x.start, x.stop, x.step]
+        else:
+            items = x
+        for item in items:
+            if length > 100000:
+                return False, length
+            is_standard, item_length = _is_standard_types_deep(
+                item, check_dict_values, deep
+            )
+            if not is_standard:
+                return False, length
+            length += item_length
+        return True, length
+
+    return False, 0
+
+
+class _E(enum.Enum):
+    pass
+
+
+class _C:
+    def foo(self): pass  # pragma: nocover
+
+    def bar(self): pass  # pragma: nocover
+
+    @classmethod
+    def cm(cls): pass  # pragma: nocover
+
+    @staticmethod
+    def sm(): pass  # pragma: nocover
+
+
+safe_name_samples = {
+    "len": len,
+    "append": list.append,
+    "__add__": list.__add__,
+    "insert": [].insert,
+    "__mul__": [].__mul__,
+    "fromkeys": dict.__dict__['fromkeys'],
+    "is_any": is_any,
+    "__repr__": CannotEval.__repr__,
+    "foo": _C().foo,
+    "bar": _C.bar,
+    "cm": _C.cm,
+    "sm": _C.sm,
+    "ast": ast,
+    "CannotEval": CannotEval,
+    "_E": _E,
+}
+
+typing_annotation_samples = {
+    name: getattr(typing, name)
+    for name in "List Dict Tuple Set Callable Mapping".split()
+}
+
+safe_name_types = tuple({
+    type(f)
+    for f in safe_name_samples.values()
+})
+
+
+typing_annotation_types = tuple({
+    type(f)
+    for f in typing_annotation_samples.values()
+})
+
+
+def eq_checking_types(a, b):
+    return type(a) is type(b) and a == b
+
+
+def ast_name(node):
+    if isinstance(node, ast.Name):
+        return node.id
+    elif isinstance(node, ast.Attribute):
+        return node.attr
+    else:
+        return None
+
+
+def safe_name(value):
+    typ = type(value)
+    if is_any(typ, *safe_name_types):
+        return value.__name__
+    elif value is typing.Optional:
+        return "Optional"
+    elif value is typing.Union:
+        return "Union"
+    elif is_any(typ, *typing_annotation_types):
+        return getattr(value, "__name__", None) or getattr(value, "_name", None)
+    else:
+        return None
+
+
+def has_ast_name(value, node):
+    value_name = safe_name(value)
+    if type(value_name) is not str:
+        return False
+    return eq_checking_types(ast_name(node), value_name)
+
+
+def copy_ast_without_context(x):
+    if isinstance(x, ast.AST):
+        kwargs = {
+            field: copy_ast_without_context(getattr(x, field))
+            for field in x._fields
+            if field != 'ctx'
+            if hasattr(x, field)
+        }
+        a = type(x)(**kwargs)
+        if hasattr(a, 'ctx'):
+            # Python 3.13.0b2+ defaults to Load when we don't pass ctx
+            # https://github.com/python/cpython/pull/118871
+            del a.ctx
+        return a
+    elif isinstance(x, list):
+        return list(map(copy_ast_without_context, x))
+    else:
+        return x
+
+
+def ensure_dict(x):
+    """
+    Handles invalid non-dict inputs
+    """
+    try:
+        return dict(x)
+    except Exception:
+        return {}
diff --git a/env/lib/python3.12/site-packages/pure_eval/version.py b/env/lib/python3.12/site-packages/pure_eval/version.py
new file mode 100644
index 0000000..db9cf74
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pure_eval/version.py
@@ -0,0 +1 @@
+__version__ = '0.2.3'
\ No newline at end of file
diff --git a/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/INSTALLER b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/METADATA b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/METADATA
new file mode 100644
index 0000000..2eff6a0
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/METADATA
@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: Pygments
+Version: 2.19.2
+Summary: Pygments is a syntax highlighting package written in Python.
+Project-URL: Homepage, https://pygments.org
+Project-URL: Documentation, https://pygments.org/docs
+Project-URL: Source, https://github.com/pygments/pygments
+Project-URL: Bug Tracker, https://github.com/pygments/pygments/issues
+Project-URL: Changelog, https://github.com/pygments/pygments/blob/master/CHANGES
+Author-email: Georg Brandl 
+Maintainer: Matthäus G. Chajdas
+Maintainer-email: Georg Brandl , Jean Abou Samra 
+License: BSD-2-Clause
+License-File: AUTHORS
+License-File: LICENSE
+Keywords: syntax highlighting
+Classifier: Development Status :: 6 - Mature
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Text Processing :: Filters
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Provides-Extra: plugins
+Provides-Extra: windows-terminal
+Requires-Dist: colorama>=0.4.6; extra == 'windows-terminal'
+Description-Content-Type: text/x-rst
+
+Pygments
+~~~~~~~~
+
+Pygments is a syntax highlighting package written in Python.
+
+It is a generic syntax highlighter suitable for use in code hosting, forums,
+wikis or other applications that need to prettify source code.  Highlights
+are:
+
+* a wide range of over 500 languages and other text formats is supported
+* special attention is paid to details, increasing quality by a fair amount
+* support for new languages and formats are added easily
+* a number of output formats, presently HTML, LaTeX, RTF, SVG, all image
+  formats that PIL supports and ANSI sequences
+* it is usable as a command-line tool and as a library
+
+Copyright 2006-2025 by the Pygments team, see ``AUTHORS``.
+Licensed under the BSD, see ``LICENSE`` for details.
diff --git a/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/RECORD b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/RECORD
new file mode 100644
index 0000000..ae3289c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/RECORD
@@ -0,0 +1,684 @@
+../../../bin/pygmentize,sha256=5HsQbUNY1GOA5VARqXwXlO9U2PYZdobvtrH4e7YVtdw,236
+pygments-2.19.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+pygments-2.19.2.dist-info/METADATA,sha256=euEA1n1nAGxkeYA92DX89HqbWfrHlEQeqOZqp_WYTYI,2512
+pygments-2.19.2.dist-info/RECORD,,
+pygments-2.19.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pygments-2.19.2.dist-info/entry_points.txt,sha256=uUXw-XhMKBEX4pWcCtpuTTnPhL3h7OEE2jWi51VQsa8,53
+pygments-2.19.2.dist-info/licenses/AUTHORS,sha256=BmDjGKbyFYAq3Icxq4XQxl_yfPzKP10oWX8wZHYZW9k,10824
+pygments-2.19.2.dist-info/licenses/LICENSE,sha256=qdZvHVJt8C4p3Oc0NtNOVuhjL0bCdbvf_HBWnogvnxc,1331
+pygments/__init__.py,sha256=_3UT86TGpHuW8FekdZ8uLidEZH1NhmcLiOy2KKNPCt4,2959
+pygments/__main__.py,sha256=p8AJyoyCOMYGvzWHdnq0_A9qaaVqaj02nIu3xhJp1_4,348
+pygments/__pycache__/__init__.cpython-312.pyc,,
+pygments/__pycache__/__main__.cpython-312.pyc,,
+pygments/__pycache__/cmdline.cpython-312.pyc,,
+pygments/__pycache__/console.cpython-312.pyc,,
+pygments/__pycache__/filter.cpython-312.pyc,,
+pygments/__pycache__/formatter.cpython-312.pyc,,
+pygments/__pycache__/lexer.cpython-312.pyc,,
+pygments/__pycache__/modeline.cpython-312.pyc,,
+pygments/__pycache__/plugin.cpython-312.pyc,,
+pygments/__pycache__/regexopt.cpython-312.pyc,,
+pygments/__pycache__/scanner.cpython-312.pyc,,
+pygments/__pycache__/sphinxext.cpython-312.pyc,,
+pygments/__pycache__/style.cpython-312.pyc,,
+pygments/__pycache__/token.cpython-312.pyc,,
+pygments/__pycache__/unistring.cpython-312.pyc,,
+pygments/__pycache__/util.cpython-312.pyc,,
+pygments/cmdline.py,sha256=4pL9Kpn2PUEKPobgrsQgg-vCx2NjsrapKzQ6LxQR7Q0,23536
+pygments/console.py,sha256=AagDWqwea2yBWf10KC9ptBgMpMjxKp8yABAmh-NQOVk,1718
+pygments/filter.py,sha256=YLtpTnZiu07nY3oK9nfR6E9Y1FBHhP5PX8gvkJWcfag,1910
+pygments/filters/__init__.py,sha256=B00KqPCQh5E0XhzaDK74Qa1E4fDSTlD6b0Pvr1v-vEQ,40344
+pygments/filters/__pycache__/__init__.cpython-312.pyc,,
+pygments/formatter.py,sha256=H_4J-moKkKfRWUOW9J0u7hhw6n1LiO-2Xu1q2B0sE5w,4366
+pygments/formatters/__init__.py,sha256=7OuvmoYLyoPzoOQV_brHG8GSKYB_wjFSkAQng6x2y9g,5349
+pygments/formatters/__pycache__/__init__.cpython-312.pyc,,
+pygments/formatters/__pycache__/_mapping.cpython-312.pyc,,
+pygments/formatters/__pycache__/bbcode.cpython-312.pyc,,
+pygments/formatters/__pycache__/groff.cpython-312.pyc,,
+pygments/formatters/__pycache__/html.cpython-312.pyc,,
+pygments/formatters/__pycache__/img.cpython-312.pyc,,
+pygments/formatters/__pycache__/irc.cpython-312.pyc,,
+pygments/formatters/__pycache__/latex.cpython-312.pyc,,
+pygments/formatters/__pycache__/other.cpython-312.pyc,,
+pygments/formatters/__pycache__/pangomarkup.cpython-312.pyc,,
+pygments/formatters/__pycache__/rtf.cpython-312.pyc,,
+pygments/formatters/__pycache__/svg.cpython-312.pyc,,
+pygments/formatters/__pycache__/terminal.cpython-312.pyc,,
+pygments/formatters/__pycache__/terminal256.cpython-312.pyc,,
+pygments/formatters/_mapping.py,sha256=1Cw37FuQlNacnxRKmtlPX4nyLoX9_ttko5ZwscNUZZ4,4176
+pygments/formatters/bbcode.py,sha256=s0Ka35OKuIchoSgEAGf6rj0rl2a9ym9L31JVNSRbZFQ,3296
+pygments/formatters/groff.py,sha256=pLcIHj4jJS_lRAVFnyJODKDu1Xlyl9_AEIdOtbl3DT0,5082
+pygments/formatters/html.py,sha256=FrHJ69FUliEyPY0zTfab0C1gPf7LXsKgeRlhwkniqIs,35953
+pygments/formatters/img.py,sha256=aRpFo8mBmWTL3sBUjRCWkeS3rc6FZrSFC4EksDrl53g,23301
+pygments/formatters/irc.py,sha256=R0Js0TYWySlI2yE9sW6tN4d4X-x3k9ZmudsijGPnLmU,4945
+pygments/formatters/latex.py,sha256=BRYtbLeW_YD1kwhhnFInhJIKylurnri8CF1lP069KWE,19258
+pygments/formatters/other.py,sha256=8pYW27sU_7XicLUqOEt2yWSO0h1IEUM3TIv34KODLwo,4986
+pygments/formatters/pangomarkup.py,sha256=pcFvEC7K1Me0EjGeOZth4oCnEY85bfqc77XzZASEPpY,2206
+pygments/formatters/rtf.py,sha256=kcKMCxTXu-2-hpgEftlGJRm7Ss-yA_Sy8OsHH_qzykA,11921
+pygments/formatters/svg.py,sha256=R6A2ME6JsMQWFiyn8wcKwFUOD6vsu-HLwiIztLu-77E,7138
+pygments/formatters/terminal.py,sha256=J_F_dFXwR9LHWvatIDnwqRYJyjVmSo1Zx8K_XDh6SyM,4626
+pygments/formatters/terminal256.py,sha256=7GQFLE5cfmeu53CAzANO74-kBk2BFkXfn5phmZjYkhM,11717
+pygments/lexer.py,sha256=ib-F_0GxHkwGpb6vWP0DeLMLc7EYgjo3hWFKN5IgOq0,35109
+pygments/lexers/__init__.py,sha256=6YhzxGKlWk38P6JpIJUQ1rVvV0DEZjEmdYsdMQ58hSk,12067
+pygments/lexers/__pycache__/__init__.cpython-312.pyc,,
+pygments/lexers/__pycache__/_ada_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_asy_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_cl_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_cocoa_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_csound_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_css_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_googlesql_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_julia_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_lasso_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_lilypond_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_lua_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_luau_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_mapping.cpython-312.pyc,,
+pygments/lexers/__pycache__/_mql_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_mysql_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_openedge_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_php_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_postgres_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_qlik_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_scheme_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_scilab_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_sourcemod_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_sql_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_stan_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_stata_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_tsql_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_usd_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_vbscript_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/_vim_builtins.cpython-312.pyc,,
+pygments/lexers/__pycache__/actionscript.cpython-312.pyc,,
+pygments/lexers/__pycache__/ada.cpython-312.pyc,,
+pygments/lexers/__pycache__/agile.cpython-312.pyc,,
+pygments/lexers/__pycache__/algebra.cpython-312.pyc,,
+pygments/lexers/__pycache__/ambient.cpython-312.pyc,,
+pygments/lexers/__pycache__/amdgpu.cpython-312.pyc,,
+pygments/lexers/__pycache__/ampl.cpython-312.pyc,,
+pygments/lexers/__pycache__/apdlexer.cpython-312.pyc,,
+pygments/lexers/__pycache__/apl.cpython-312.pyc,,
+pygments/lexers/__pycache__/archetype.cpython-312.pyc,,
+pygments/lexers/__pycache__/arrow.cpython-312.pyc,,
+pygments/lexers/__pycache__/arturo.cpython-312.pyc,,
+pygments/lexers/__pycache__/asc.cpython-312.pyc,,
+pygments/lexers/__pycache__/asm.cpython-312.pyc,,
+pygments/lexers/__pycache__/asn1.cpython-312.pyc,,
+pygments/lexers/__pycache__/automation.cpython-312.pyc,,
+pygments/lexers/__pycache__/bare.cpython-312.pyc,,
+pygments/lexers/__pycache__/basic.cpython-312.pyc,,
+pygments/lexers/__pycache__/bdd.cpython-312.pyc,,
+pygments/lexers/__pycache__/berry.cpython-312.pyc,,
+pygments/lexers/__pycache__/bibtex.cpython-312.pyc,,
+pygments/lexers/__pycache__/blueprint.cpython-312.pyc,,
+pygments/lexers/__pycache__/boa.cpython-312.pyc,,
+pygments/lexers/__pycache__/bqn.cpython-312.pyc,,
+pygments/lexers/__pycache__/business.cpython-312.pyc,,
+pygments/lexers/__pycache__/c_cpp.cpython-312.pyc,,
+pygments/lexers/__pycache__/c_like.cpython-312.pyc,,
+pygments/lexers/__pycache__/capnproto.cpython-312.pyc,,
+pygments/lexers/__pycache__/carbon.cpython-312.pyc,,
+pygments/lexers/__pycache__/cddl.cpython-312.pyc,,
+pygments/lexers/__pycache__/chapel.cpython-312.pyc,,
+pygments/lexers/__pycache__/clean.cpython-312.pyc,,
+pygments/lexers/__pycache__/codeql.cpython-312.pyc,,
+pygments/lexers/__pycache__/comal.cpython-312.pyc,,
+pygments/lexers/__pycache__/compiled.cpython-312.pyc,,
+pygments/lexers/__pycache__/configs.cpython-312.pyc,,
+pygments/lexers/__pycache__/console.cpython-312.pyc,,
+pygments/lexers/__pycache__/cplint.cpython-312.pyc,,
+pygments/lexers/__pycache__/crystal.cpython-312.pyc,,
+pygments/lexers/__pycache__/csound.cpython-312.pyc,,
+pygments/lexers/__pycache__/css.cpython-312.pyc,,
+pygments/lexers/__pycache__/d.cpython-312.pyc,,
+pygments/lexers/__pycache__/dalvik.cpython-312.pyc,,
+pygments/lexers/__pycache__/data.cpython-312.pyc,,
+pygments/lexers/__pycache__/dax.cpython-312.pyc,,
+pygments/lexers/__pycache__/devicetree.cpython-312.pyc,,
+pygments/lexers/__pycache__/diff.cpython-312.pyc,,
+pygments/lexers/__pycache__/dns.cpython-312.pyc,,
+pygments/lexers/__pycache__/dotnet.cpython-312.pyc,,
+pygments/lexers/__pycache__/dsls.cpython-312.pyc,,
+pygments/lexers/__pycache__/dylan.cpython-312.pyc,,
+pygments/lexers/__pycache__/ecl.cpython-312.pyc,,
+pygments/lexers/__pycache__/eiffel.cpython-312.pyc,,
+pygments/lexers/__pycache__/elm.cpython-312.pyc,,
+pygments/lexers/__pycache__/elpi.cpython-312.pyc,,
+pygments/lexers/__pycache__/email.cpython-312.pyc,,
+pygments/lexers/__pycache__/erlang.cpython-312.pyc,,
+pygments/lexers/__pycache__/esoteric.cpython-312.pyc,,
+pygments/lexers/__pycache__/ezhil.cpython-312.pyc,,
+pygments/lexers/__pycache__/factor.cpython-312.pyc,,
+pygments/lexers/__pycache__/fantom.cpython-312.pyc,,
+pygments/lexers/__pycache__/felix.cpython-312.pyc,,
+pygments/lexers/__pycache__/fift.cpython-312.pyc,,
+pygments/lexers/__pycache__/floscript.cpython-312.pyc,,
+pygments/lexers/__pycache__/forth.cpython-312.pyc,,
+pygments/lexers/__pycache__/fortran.cpython-312.pyc,,
+pygments/lexers/__pycache__/foxpro.cpython-312.pyc,,
+pygments/lexers/__pycache__/freefem.cpython-312.pyc,,
+pygments/lexers/__pycache__/func.cpython-312.pyc,,
+pygments/lexers/__pycache__/functional.cpython-312.pyc,,
+pygments/lexers/__pycache__/futhark.cpython-312.pyc,,
+pygments/lexers/__pycache__/gcodelexer.cpython-312.pyc,,
+pygments/lexers/__pycache__/gdscript.cpython-312.pyc,,
+pygments/lexers/__pycache__/gleam.cpython-312.pyc,,
+pygments/lexers/__pycache__/go.cpython-312.pyc,,
+pygments/lexers/__pycache__/grammar_notation.cpython-312.pyc,,
+pygments/lexers/__pycache__/graph.cpython-312.pyc,,
+pygments/lexers/__pycache__/graphics.cpython-312.pyc,,
+pygments/lexers/__pycache__/graphql.cpython-312.pyc,,
+pygments/lexers/__pycache__/graphviz.cpython-312.pyc,,
+pygments/lexers/__pycache__/gsql.cpython-312.pyc,,
+pygments/lexers/__pycache__/hare.cpython-312.pyc,,
+pygments/lexers/__pycache__/haskell.cpython-312.pyc,,
+pygments/lexers/__pycache__/haxe.cpython-312.pyc,,
+pygments/lexers/__pycache__/hdl.cpython-312.pyc,,
+pygments/lexers/__pycache__/hexdump.cpython-312.pyc,,
+pygments/lexers/__pycache__/html.cpython-312.pyc,,
+pygments/lexers/__pycache__/idl.cpython-312.pyc,,
+pygments/lexers/__pycache__/igor.cpython-312.pyc,,
+pygments/lexers/__pycache__/inferno.cpython-312.pyc,,
+pygments/lexers/__pycache__/installers.cpython-312.pyc,,
+pygments/lexers/__pycache__/int_fiction.cpython-312.pyc,,
+pygments/lexers/__pycache__/iolang.cpython-312.pyc,,
+pygments/lexers/__pycache__/j.cpython-312.pyc,,
+pygments/lexers/__pycache__/javascript.cpython-312.pyc,,
+pygments/lexers/__pycache__/jmespath.cpython-312.pyc,,
+pygments/lexers/__pycache__/jslt.cpython-312.pyc,,
+pygments/lexers/__pycache__/json5.cpython-312.pyc,,
+pygments/lexers/__pycache__/jsonnet.cpython-312.pyc,,
+pygments/lexers/__pycache__/jsx.cpython-312.pyc,,
+pygments/lexers/__pycache__/julia.cpython-312.pyc,,
+pygments/lexers/__pycache__/jvm.cpython-312.pyc,,
+pygments/lexers/__pycache__/kuin.cpython-312.pyc,,
+pygments/lexers/__pycache__/kusto.cpython-312.pyc,,
+pygments/lexers/__pycache__/ldap.cpython-312.pyc,,
+pygments/lexers/__pycache__/lean.cpython-312.pyc,,
+pygments/lexers/__pycache__/lilypond.cpython-312.pyc,,
+pygments/lexers/__pycache__/lisp.cpython-312.pyc,,
+pygments/lexers/__pycache__/macaulay2.cpython-312.pyc,,
+pygments/lexers/__pycache__/make.cpython-312.pyc,,
+pygments/lexers/__pycache__/maple.cpython-312.pyc,,
+pygments/lexers/__pycache__/markup.cpython-312.pyc,,
+pygments/lexers/__pycache__/math.cpython-312.pyc,,
+pygments/lexers/__pycache__/matlab.cpython-312.pyc,,
+pygments/lexers/__pycache__/maxima.cpython-312.pyc,,
+pygments/lexers/__pycache__/meson.cpython-312.pyc,,
+pygments/lexers/__pycache__/mime.cpython-312.pyc,,
+pygments/lexers/__pycache__/minecraft.cpython-312.pyc,,
+pygments/lexers/__pycache__/mips.cpython-312.pyc,,
+pygments/lexers/__pycache__/ml.cpython-312.pyc,,
+pygments/lexers/__pycache__/modeling.cpython-312.pyc,,
+pygments/lexers/__pycache__/modula2.cpython-312.pyc,,
+pygments/lexers/__pycache__/mojo.cpython-312.pyc,,
+pygments/lexers/__pycache__/monte.cpython-312.pyc,,
+pygments/lexers/__pycache__/mosel.cpython-312.pyc,,
+pygments/lexers/__pycache__/ncl.cpython-312.pyc,,
+pygments/lexers/__pycache__/nimrod.cpython-312.pyc,,
+pygments/lexers/__pycache__/nit.cpython-312.pyc,,
+pygments/lexers/__pycache__/nix.cpython-312.pyc,,
+pygments/lexers/__pycache__/numbair.cpython-312.pyc,,
+pygments/lexers/__pycache__/oberon.cpython-312.pyc,,
+pygments/lexers/__pycache__/objective.cpython-312.pyc,,
+pygments/lexers/__pycache__/ooc.cpython-312.pyc,,
+pygments/lexers/__pycache__/openscad.cpython-312.pyc,,
+pygments/lexers/__pycache__/other.cpython-312.pyc,,
+pygments/lexers/__pycache__/parasail.cpython-312.pyc,,
+pygments/lexers/__pycache__/parsers.cpython-312.pyc,,
+pygments/lexers/__pycache__/pascal.cpython-312.pyc,,
+pygments/lexers/__pycache__/pawn.cpython-312.pyc,,
+pygments/lexers/__pycache__/pddl.cpython-312.pyc,,
+pygments/lexers/__pycache__/perl.cpython-312.pyc,,
+pygments/lexers/__pycache__/phix.cpython-312.pyc,,
+pygments/lexers/__pycache__/php.cpython-312.pyc,,
+pygments/lexers/__pycache__/pointless.cpython-312.pyc,,
+pygments/lexers/__pycache__/pony.cpython-312.pyc,,
+pygments/lexers/__pycache__/praat.cpython-312.pyc,,
+pygments/lexers/__pycache__/procfile.cpython-312.pyc,,
+pygments/lexers/__pycache__/prolog.cpython-312.pyc,,
+pygments/lexers/__pycache__/promql.cpython-312.pyc,,
+pygments/lexers/__pycache__/prql.cpython-312.pyc,,
+pygments/lexers/__pycache__/ptx.cpython-312.pyc,,
+pygments/lexers/__pycache__/python.cpython-312.pyc,,
+pygments/lexers/__pycache__/q.cpython-312.pyc,,
+pygments/lexers/__pycache__/qlik.cpython-312.pyc,,
+pygments/lexers/__pycache__/qvt.cpython-312.pyc,,
+pygments/lexers/__pycache__/r.cpython-312.pyc,,
+pygments/lexers/__pycache__/rdf.cpython-312.pyc,,
+pygments/lexers/__pycache__/rebol.cpython-312.pyc,,
+pygments/lexers/__pycache__/rego.cpython-312.pyc,,
+pygments/lexers/__pycache__/resource.cpython-312.pyc,,
+pygments/lexers/__pycache__/ride.cpython-312.pyc,,
+pygments/lexers/__pycache__/rita.cpython-312.pyc,,
+pygments/lexers/__pycache__/rnc.cpython-312.pyc,,
+pygments/lexers/__pycache__/roboconf.cpython-312.pyc,,
+pygments/lexers/__pycache__/robotframework.cpython-312.pyc,,
+pygments/lexers/__pycache__/ruby.cpython-312.pyc,,
+pygments/lexers/__pycache__/rust.cpython-312.pyc,,
+pygments/lexers/__pycache__/sas.cpython-312.pyc,,
+pygments/lexers/__pycache__/savi.cpython-312.pyc,,
+pygments/lexers/__pycache__/scdoc.cpython-312.pyc,,
+pygments/lexers/__pycache__/scripting.cpython-312.pyc,,
+pygments/lexers/__pycache__/sgf.cpython-312.pyc,,
+pygments/lexers/__pycache__/shell.cpython-312.pyc,,
+pygments/lexers/__pycache__/sieve.cpython-312.pyc,,
+pygments/lexers/__pycache__/slash.cpython-312.pyc,,
+pygments/lexers/__pycache__/smalltalk.cpython-312.pyc,,
+pygments/lexers/__pycache__/smithy.cpython-312.pyc,,
+pygments/lexers/__pycache__/smv.cpython-312.pyc,,
+pygments/lexers/__pycache__/snobol.cpython-312.pyc,,
+pygments/lexers/__pycache__/solidity.cpython-312.pyc,,
+pygments/lexers/__pycache__/soong.cpython-312.pyc,,
+pygments/lexers/__pycache__/sophia.cpython-312.pyc,,
+pygments/lexers/__pycache__/special.cpython-312.pyc,,
+pygments/lexers/__pycache__/spice.cpython-312.pyc,,
+pygments/lexers/__pycache__/sql.cpython-312.pyc,,
+pygments/lexers/__pycache__/srcinfo.cpython-312.pyc,,
+pygments/lexers/__pycache__/stata.cpython-312.pyc,,
+pygments/lexers/__pycache__/supercollider.cpython-312.pyc,,
+pygments/lexers/__pycache__/tablegen.cpython-312.pyc,,
+pygments/lexers/__pycache__/tact.cpython-312.pyc,,
+pygments/lexers/__pycache__/tal.cpython-312.pyc,,
+pygments/lexers/__pycache__/tcl.cpython-312.pyc,,
+pygments/lexers/__pycache__/teal.cpython-312.pyc,,
+pygments/lexers/__pycache__/templates.cpython-312.pyc,,
+pygments/lexers/__pycache__/teraterm.cpython-312.pyc,,
+pygments/lexers/__pycache__/testing.cpython-312.pyc,,
+pygments/lexers/__pycache__/text.cpython-312.pyc,,
+pygments/lexers/__pycache__/textedit.cpython-312.pyc,,
+pygments/lexers/__pycache__/textfmts.cpython-312.pyc,,
+pygments/lexers/__pycache__/theorem.cpython-312.pyc,,
+pygments/lexers/__pycache__/thingsdb.cpython-312.pyc,,
+pygments/lexers/__pycache__/tlb.cpython-312.pyc,,
+pygments/lexers/__pycache__/tls.cpython-312.pyc,,
+pygments/lexers/__pycache__/tnt.cpython-312.pyc,,
+pygments/lexers/__pycache__/trafficscript.cpython-312.pyc,,
+pygments/lexers/__pycache__/typoscript.cpython-312.pyc,,
+pygments/lexers/__pycache__/typst.cpython-312.pyc,,
+pygments/lexers/__pycache__/ul4.cpython-312.pyc,,
+pygments/lexers/__pycache__/unicon.cpython-312.pyc,,
+pygments/lexers/__pycache__/urbi.cpython-312.pyc,,
+pygments/lexers/__pycache__/usd.cpython-312.pyc,,
+pygments/lexers/__pycache__/varnish.cpython-312.pyc,,
+pygments/lexers/__pycache__/verification.cpython-312.pyc,,
+pygments/lexers/__pycache__/verifpal.cpython-312.pyc,,
+pygments/lexers/__pycache__/vip.cpython-312.pyc,,
+pygments/lexers/__pycache__/vyper.cpython-312.pyc,,
+pygments/lexers/__pycache__/web.cpython-312.pyc,,
+pygments/lexers/__pycache__/webassembly.cpython-312.pyc,,
+pygments/lexers/__pycache__/webidl.cpython-312.pyc,,
+pygments/lexers/__pycache__/webmisc.cpython-312.pyc,,
+pygments/lexers/__pycache__/wgsl.cpython-312.pyc,,
+pygments/lexers/__pycache__/whiley.cpython-312.pyc,,
+pygments/lexers/__pycache__/wowtoc.cpython-312.pyc,,
+pygments/lexers/__pycache__/wren.cpython-312.pyc,,
+pygments/lexers/__pycache__/x10.cpython-312.pyc,,
+pygments/lexers/__pycache__/xorg.cpython-312.pyc,,
+pygments/lexers/__pycache__/yang.cpython-312.pyc,,
+pygments/lexers/__pycache__/yara.cpython-312.pyc,,
+pygments/lexers/__pycache__/zig.cpython-312.pyc,,
+pygments/lexers/_ada_builtins.py,sha256=CA_OnShtdc7wWh9oYcRlcrkDAQwYUKl6w7tdSbALQd4,1543
+pygments/lexers/_asy_builtins.py,sha256=cd9M00YH19w5ZL7aqucmC3nwpJGTS04U-01NLy5E2_4,27287
+pygments/lexers/_cl_builtins.py,sha256=kQeUIyZjP4kX0frkICDcKxBYQCLqzIDXa5WV5cevhDo,13994
+pygments/lexers/_cocoa_builtins.py,sha256=Ka1lLJe7JfWtdho4IFIB82X9yBvrbfHCCmEG-peXXhQ,105173
+pygments/lexers/_csound_builtins.py,sha256=qnQYKeI26ZHim316uqy_hDiRiCoHo2RHjD3sYBALyXs,18414
+pygments/lexers/_css_builtins.py,sha256=aD-dhLFXVd1Atn_bZd7gEdQn7Mhe60_VHpvZ340WzDI,12446
+pygments/lexers/_googlesql_builtins.py,sha256=IkrOk-T2v1yzbGzUEEQh5_Cf4uC_cmL_uuhwDpZlTug,16132
+pygments/lexers/_julia_builtins.py,sha256=N2WdSw5zgI2fhDat_i4YeVqurRTC_P8x71ez00SCN6U,11883
+pygments/lexers/_lasso_builtins.py,sha256=8q1gbsrMJeaeUhxIYKhaOxC9j_B-NBpq_XFj2Ze41X0,134510
+pygments/lexers/_lilypond_builtins.py,sha256=XTbGL1z1oKMoqWLEktG33jx5GdGTI9CpeO5NheEi4Y0,108094
+pygments/lexers/_lua_builtins.py,sha256=PhFdZV5-Tzz2j_q4lvG9lr84ELGfL41BhnrSDNNTaG4,8108
+pygments/lexers/_luau_builtins.py,sha256=-IDrU04kUVfjXwSQzMMpXmMYhNsQxZVVZk8cuAA0Lo0,955
+pygments/lexers/_mapping.py,sha256=9fv7xYOUAOr6LzfdFS4MDbPu78o4OQQH-2nsI1bNZf4,70438
+pygments/lexers/_mql_builtins.py,sha256=ybRQjlb7Cul0sDstnzxJl3h0qS6Ieqsr811fqrxyumU,24713
+pygments/lexers/_mysql_builtins.py,sha256=y0kAWZVAs0z2dTFJJV42OZpILgRnd8T3zSlBFv-g_oA,25838
+pygments/lexers/_openedge_builtins.py,sha256=Sz4j9-CPWIaxMa-2fZgY66j7igcu1ob1GR2UtI8zAkg,49398
+pygments/lexers/_php_builtins.py,sha256=Jd4BZpjMDELPi4EVoSxK1-8BFTc63HUwYfm1rLrGj0M,107922
+pygments/lexers/_postgres_builtins.py,sha256=Pqh4z0RBRbnW6rCQtWUdzWCJxNyqpJ7_0HOktxHDxk4,13343
+pygments/lexers/_qlik_builtins.py,sha256=xuJy9c9uZDXv6h8z582P5PrxqkxTZ_nS8gPl9OD9VN8,12595
+pygments/lexers/_scheme_builtins.py,sha256=2hNtJOJmP21lUsikpqMJ2gAmLT3Rwn_KEeqhXwCjgfk,32564
+pygments/lexers/_scilab_builtins.py,sha256=oZYPB1XPdIEz3pII11pFDe6extRRyWGA7pY06X8KZ8w,52411
+pygments/lexers/_sourcemod_builtins.py,sha256=H8AFLsNDdEpymIWOpDwbDJGCP1w-x-1gSlzPDioMF4o,26777
+pygments/lexers/_sql_builtins.py,sha256=oe8F9wWuO2iS6nEsZAdJtCUChBTjgM1Sq_aipu74jXM,6767
+pygments/lexers/_stan_builtins.py,sha256=dwi1hllM_NsaCv-aXJy7lEi57X5Hh5gSD97aCQyT9KM,13445
+pygments/lexers/_stata_builtins.py,sha256=Hqrr6j77zWU3cGGpBPohwexZci43YA4_sVYE4E1sNow,27227
+pygments/lexers/_tsql_builtins.py,sha256=Pi2RhTXcLE3glI9oxNhyVsOMn-fK_1TRxJ-EsYP5LcI,15460
+pygments/lexers/_usd_builtins.py,sha256=c9hbU1cwqBUCFIhNfu_Dob8ywv1rlPhi9w2OTj3kR8s,1658
+pygments/lexers/_vbscript_builtins.py,sha256=MqJ2ABywD21aSRtWYZRG64CCbGstC1kfsiHGJmZzxiw,4225
+pygments/lexers/_vim_builtins.py,sha256=bA4mH8t1mPPQfEiUCKEqRO1O0rL2DUG0Ux1Bt8ZSu0E,57066
+pygments/lexers/actionscript.py,sha256=JBngCe5UhYT_0dLD2j7PnPO0xRRJhmypEuQ-C5in8pY,11727
+pygments/lexers/ada.py,sha256=58k5ra1vGS4iLpW3h1ItY9ftzF3WevaeAAXzAYTiYkQ,5353
+pygments/lexers/agile.py,sha256=DN-7AVIqtG1MshA94rtSGYI_884hVHgzq405wD0_dl8,896
+pygments/lexers/algebra.py,sha256=yGTu9Tt-cQzAISQYIC5MS5a3z4QmL-tGcXnd_pkWGbk,9952
+pygments/lexers/ambient.py,sha256=UnzKpIlfSm3iitHvMd7XTMSY8TjZYYhKOC3AiARS_cE,2605
+pygments/lexers/amdgpu.py,sha256=S8qjn2UMLhBFm3Yn_c06XAGf8cl5x_ZeluelWG_-JAw,1723
+pygments/lexers/ampl.py,sha256=ZBRfDXm760gR1a1gqItnsHuoO3JdUcTBjJ5tFY9UtPA,4176
+pygments/lexers/apdlexer.py,sha256=Zr5-jgjxC8PKzRlEeclakZXPHci7FHBZghQ6wwiuT7A,30800
+pygments/lexers/apl.py,sha256=PTQMp-bxT5P-DbrEvFha10HBTcsDJ5srL3I1s9ljz58,3404
+pygments/lexers/archetype.py,sha256=pQVlP1Fb5OA8nn7QwmFaaaOSvvpoIsQVw43FVCQCve4,11538
+pygments/lexers/arrow.py,sha256=2PKdbWq3xQLF1KoDbWvSxpjwKRrznnDiArTflRGZzBo,3564
+pygments/lexers/arturo.py,sha256=U5MtRNHJtnBn4ZOeWmW6MKlVRG7SX6KhTRamDqzn9tA,11414
+pygments/lexers/asc.py,sha256=-DgZl9jccBDHPlDmjCsrEqx0-Q7ap7XVdNKtxLNWG1w,1693
+pygments/lexers/asm.py,sha256=xm2Y5mcT-sF3oQvair4SWs9EWTyndoaUoSsDy5v6shI,41967
+pygments/lexers/asn1.py,sha256=BlcloIX2bu6Q7BxGcksuhYFHGsXLVKyB4B9mFd4Pj6E,4262
+pygments/lexers/automation.py,sha256=Q61qon8EwpfakMh_2MS2E2zUUT16rG3UNIKPYjITeTs,19831
+pygments/lexers/bare.py,sha256=tWoei86JJX1k-ADhaXd5TgX6ItDTici9yFWpkTPhnfM,3020
+pygments/lexers/basic.py,sha256=qpVe5h8Fa7NJo1EihN-4R_UZpHO6my2Ssgkb-BktkKs,27989
+pygments/lexers/bdd.py,sha256=yysefcOFAEyk9kJ2y4EXmzJTecgLYUHlWixt_3YzPMU,1641
+pygments/lexers/berry.py,sha256=zxGowFb8HMIyN15-m8nmWnW6bPRR4esKtSEVugc9uXM,3209
+pygments/lexers/bibtex.py,sha256=yuNoPxwrJf9DCGUT17hxfDzbq_HtCLkQkRbBtiTVmeQ,4811
+pygments/lexers/blueprint.py,sha256=NzvWHMxCLDWt8hc6gB5jokltxVJgNa7Jwh4c61ng388,6188
+pygments/lexers/boa.py,sha256=dOot1XWNZThPIio2UyAX67K6EpISjSRCFjotD7dcnwE,3921
+pygments/lexers/bqn.py,sha256=nJiwrPKKbRF-qdai5tfqipwBkkko2P3weiZAjHUMimY,3671
+pygments/lexers/business.py,sha256=lRtekOJfsDkb12AGbuz10-G67OJrVJgCBtihTQ8_aoY,28345
+pygments/lexers/c_cpp.py,sha256=D7ZIswaHASlGBgoTlwnSqTQHf8_JyvvSt2L2q1W-F6g,18059
+pygments/lexers/c_like.py,sha256=FTGp17ds6X2rDZOHup2hH6BEn3gKK4nLm9pydNEhm0E,32021
+pygments/lexers/capnproto.py,sha256=XQJAh1WS-0ulqbTn9TdzR6gEgWLcuBqb4sj3jNsrhsY,2174
+pygments/lexers/carbon.py,sha256=av12YuTGZGpOa1Cmxp3lppx3LfSJUWbvOu0ixmUVll0,3211
+pygments/lexers/cddl.py,sha256=MKa70IwABgjBjYu15_Q9v8rsu2sr1a-i2jkiaPTI6sM,5076
+pygments/lexers/chapel.py,sha256=0n_fL3ehLC4pw4YKnmq9jxIXOJcxGPka1Wr1t1zsXPc,5156
+pygments/lexers/clean.py,sha256=dkDPAwF5BTALPeuKFoRKOSD3RfsKcGWbaRo6_G8LHng,6418
+pygments/lexers/codeql.py,sha256=ebvghn2zbrnETV4buVozMDmRCVKSdGiIN8ycLlHpGsE,2576
+pygments/lexers/comal.py,sha256=TC3NzcJ58ew5jw7qwK0kJ-okTA47psZje0yAIS39HR4,3179
+pygments/lexers/compiled.py,sha256=Slfo1sjWqcPawUwf0dIIZLBCL5pkOIoAX2S8Lxs02Mc,1426
+pygments/lexers/configs.py,sha256=wW8pY0Sa5a10pnAeTLGf48HhixQTVageIyHEf1aYMCc,50913
+pygments/lexers/console.py,sha256=-jAG120dupvV3kG3zC70brLJvSLwTFqMubBQuj_GVnU,4180
+pygments/lexers/cplint.py,sha256=DkbyE5EKydLgf6BRr1FhQrK-IeQPL7Zmjk0DVdlRFnQ,1389
+pygments/lexers/crystal.py,sha256=xU-RnpIkpjrquoxtOuOcP8fcesSJl4xhU7kO9m42LZY,15754
+pygments/lexers/csound.py,sha256=ioSw4Q04wdwjUAbnTZ1qLhUq1vxdWFxhh3QtEl5RAJc,16998
+pygments/lexers/css.py,sha256=JN1RBYsee-jrpHWrSmhN3TKc4TkOBn-_BEGpgTCzcqE,25376
+pygments/lexers/d.py,sha256=piOy0EJeiAwPHugiM3gVv0z7HNh3u2gZQoCUSASRbY4,9920
+pygments/lexers/dalvik.py,sha256=deFg2JPBktJ9mEGb9EgxNkmd6vaMjJFQVzUHo8NKIa8,4606
+pygments/lexers/data.py,sha256=o0x0SmB5ms_CPUPljEEEenOON4IQWn86DkwFjkJYCOg,27026
+pygments/lexers/dax.py,sha256=ASi73qmr7OA7cVZXF2GTYGt01Ly1vY8CgD_Pnpm8k-4,8098
+pygments/lexers/devicetree.py,sha256=RecSQCidt8DRE1QFCPUbwwR0hiRlNtsFihdGldeUn3k,4019
+pygments/lexers/diff.py,sha256=F6vxZ64wm5Nag_97de1H_3F700ZwCVnYjKvtT5jilww,5382
+pygments/lexers/dns.py,sha256=Hh5hJ7MXfrq36KgfyIRwK3X8o1LdR98IKERcV4eZ7HY,3891
+pygments/lexers/dotnet.py,sha256=NDE0kOmpe96GLO-zwNLazmj77E9ORGmKpa4ZMCXDXxQ,39441
+pygments/lexers/dsls.py,sha256=GnHKhGL5GxsRFnqC7-65NTPZLOZdmnllNrGP86x_fQE,36746
+pygments/lexers/dylan.py,sha256=7zZ1EbHWXeVHqTD36AqykKqo3fhuIh4sM-whcxUaH_Y,10409
+pygments/lexers/ecl.py,sha256=vhmpa2LBrHxsPkYcf3kPZ1ItVaLRDTebi186wY0xGZA,6371
+pygments/lexers/eiffel.py,sha256=5ydYIEFcgcMoEj4BlK31hZ0aJb8OX0RdAvuCNdlxwqw,2690
+pygments/lexers/elm.py,sha256=uRCddU8jK5vVkH6Y66y8KOsDJprIfrOgeYq3hv1PxAM,3152
+pygments/lexers/elpi.py,sha256=O9j_WKBPyvNFjCRuPciVpW4etVSnILm_T79BhCPZYmo,6877
+pygments/lexers/email.py,sha256=ZZL6yvwCRl1CEQyysuOu0lbabp5tjMutS7f3efFKGR4,4804
+pygments/lexers/erlang.py,sha256=bU11eVHvooLwmVknzN6Xkb2DMk7HbenqdNlYSzhThDM,19147
+pygments/lexers/esoteric.py,sha256=Jfp8UUKyKYsqLaqXRZT3GSM9dzkF65zduwfnH1GoGhU,10500
+pygments/lexers/ezhil.py,sha256=22r-xjvvBVpExTqCI-HycAwunDb1p5gY4tIfDmM0vDw,3272
+pygments/lexers/factor.py,sha256=urZ4En4uKFCLXdEkXLWg9EYUFGHQTTDCwNXtyq-ngok,19530
+pygments/lexers/fantom.py,sha256=JJ13-NwykD-iIESnuzCefCYeQDO95cHMJA8TasF4gHA,10231
+pygments/lexers/felix.py,sha256=F-v0si4zPtRelqzDQWXI1-tarCE-BvawziODxRU7378,9655
+pygments/lexers/fift.py,sha256=rOCwp3v5ocK5YOWvt7Td3Md--97_8e-7Sonx52uS8mA,1644
+pygments/lexers/floscript.py,sha256=aHh82k52jMuDuzl9LatrcSANJiXTCyjGU3SO53bwbb0,2667
+pygments/lexers/forth.py,sha256=ZMtsHdNbnS_0IdSYlfAlfTSPEr0MEsRo-YZriQNueTQ,7193
+pygments/lexers/fortran.py,sha256=1PE5dTxf4Df6LUeXFcmNtyeXWsC8tSiK5dYwPHIJeeQ,10382
+pygments/lexers/foxpro.py,sha256=CBkW62Fuibz3yfyelZCaEO8GGdFJWsuRhqwtsSeBwLM,26295
+pygments/lexers/freefem.py,sha256=LFBQk-m1-nNCgrl-VDH3QwnVWurvb7W29i06LoT207A,26913
+pygments/lexers/func.py,sha256=OR2rkM7gf9fKvad5WcFQln-_U_pb-RUCM9eQatToF4A,3700
+pygments/lexers/functional.py,sha256=fYT2AGZ642cRkIAId0rnXFBsx1c8LLEDRN_VuCEkUyM,693
+pygments/lexers/futhark.py,sha256=Vf1i4t-tR3zqaktVjhTzFNg_ts_9CcyA4ZDfDizbCmk,3743
+pygments/lexers/gcodelexer.py,sha256=4Xs9ax4-JZGupW_qSnHon39wQGpb-tNA3xorMKg841E,874
+pygments/lexers/gdscript.py,sha256=Ws7JKxy0M0IyZ_1iMfRvJPrizEwmeCNLDoeMIFaM-CU,7566
+pygments/lexers/gleam.py,sha256=XIlTcq6cB743pCqbNYo8PocSkjZyDPR6hHgdaJNJ1Vc,2392
+pygments/lexers/go.py,sha256=4LezefgyuqZWHzLZHieUkKTi-ssY6aHJxx7Z-LFaLK0,3783
+pygments/lexers/grammar_notation.py,sha256=LvzhRQHgwZzq9oceukZS_hwnKK58ee7Z5d0cwXOR734,8043
+pygments/lexers/graph.py,sha256=WFqoPA1c_hHYrV0i_F7-eUw3Co4_HmZY3GJ-TyDr670,4108
+pygments/lexers/graphics.py,sha256=tmF9NNALnvPnax8ywYC3pLOla45YXtp9UA0H-5EiTQY,39145
+pygments/lexers/graphql.py,sha256=O_zcrGrBaDaKTlUoJGRruxqk7CJi-NR92Y0Cs-KkCvw,5601
+pygments/lexers/graphviz.py,sha256=mzdXOMpwz9_V-be1eTAMyhkKCBl6UxCIXuq6C2yrtsw,1934
+pygments/lexers/gsql.py,sha256=VPZk9sb26-DumRkWfEaSTeoc0lx5xt5n-6eDDLezMtc,3990
+pygments/lexers/hare.py,sha256=PGCOuILktJsmtTpCZZKkMFtObfJuBpei8HM8HHuq1Tw,2649
+pygments/lexers/haskell.py,sha256=MYr74-PAC8kGJRX-dZmvZsHTc7a2u6yFS2B19LfDD7g,33262
+pygments/lexers/haxe.py,sha256=WHCy_nrXHnfLITfbdp3Ji3lqQU4HAsTUpXsLCp2_4sk,30974
+pygments/lexers/hdl.py,sha256=MOWxhmAuE4Ei0CKDqqaON7T8tl43geancrNYM136Z0U,22738
+pygments/lexers/hexdump.py,sha256=1lj9oJ-KiZXSVYvTMfGmEAQzNEW08WlMcC2I5aYvHK4,3653
+pygments/lexers/html.py,sha256=MxYTI4EeT7QxoGleCAyQq-8n_Sgly6tD95H5zanCNmk,21977
+pygments/lexers/idl.py,sha256=rcihUAGhfuGEaSW6pgFq6NzplT_pv0DagUoefg4zAmk,15449
+pygments/lexers/igor.py,sha256=wVefbUjb3ftaW3LCKGtX1JgLgiY4EmRor5gVOn8vQA8,31633
+pygments/lexers/inferno.py,sha256=ChE_5y5SLH_75Uv7D2dKWQMk2dlN6z1gY1IDjlJZ8rU,3135
+pygments/lexers/installers.py,sha256=ZHliit4Pxz1tYKOIjKkDXI5djTkpzYUMVIPR1xvUrL8,14435
+pygments/lexers/int_fiction.py,sha256=0ZzIa1sZDUQsltd1oHuS-BoNiOF8zKQfcVuDyK1Ttv8,56544
+pygments/lexers/iolang.py,sha256=L6dNDCLH0kxkIUi00fI4Z14QnRu79UcNDrgv02c5Zw8,1905
+pygments/lexers/j.py,sha256=DqNdwQGFLiZW3mCNLRg81gpmsy4Hgcai_9NP3LbWhNU,4853
+pygments/lexers/javascript.py,sha256=TGKQLSrCprCKfhLLGAq_0EOdvqvJKX9pOdKo7tCRurQ,63243
+pygments/lexers/jmespath.py,sha256=R5yA5LJ2nTIaDwnFIpSNGAThd0sAYFccwawA9xBptlg,2082
+pygments/lexers/jslt.py,sha256=OeYQf8O2_9FCaf9W6Q3a7rPdAFLthePCtVSgCrOTcl8,3700
+pygments/lexers/json5.py,sha256=8JZbc8EiTEZdKaIdQg3hXEh0mHWSzPlwd473a0nUuT0,2502
+pygments/lexers/jsonnet.py,sha256=bx2G6J4tJqGrJV1PyZrIWzWHXcoefCX-4lIxxtbn2gw,5636
+pygments/lexers/jsx.py,sha256=wGsoGSB40qAJrVfXwRPtan7OcK0O87RVsHHk0m6gogk,2693
+pygments/lexers/julia.py,sha256=0ZDJ9X83V5GqJzA6T6p0TTN8WHy2JAjvu-FSBXvfXdc,11710
+pygments/lexers/jvm.py,sha256=Yt1iQ3QodXRY-x_HUOGedhyuBBHn5jYH-I8NzOzHTlE,72667
+pygments/lexers/kuin.py,sha256=3dKKJVJlskgrvMKv2tY9NOsFfDjyo-3MLcJ1lFKdXSg,11405
+pygments/lexers/kusto.py,sha256=kaxkoPpEBDsBTCvCOkZZx7oGfv0jk_UNIRIRbfVAsBE,3477
+pygments/lexers/ldap.py,sha256=77vF4t_19x9V522cxRCM5d3HW8Ne3giYsFsMPVYYBw4,6551
+pygments/lexers/lean.py,sha256=7HWRgxFsxS1N9XKqw0vfKwaxl27s5YiVYtZeRUoTHFo,8570
+pygments/lexers/lilypond.py,sha256=yd2Tuv67um6EyCIr-VwBnlPhTHxMaQsBJ4nGgO5fjIk,9752
+pygments/lexers/lisp.py,sha256=EHUy1g4pzEsYPE-zGj2rAXm3YATE1j9dCQOr5-JPSkU,157668
+pygments/lexers/macaulay2.py,sha256=zkV-vxjQYa0Jj9TGfFP1iMgpTZ4ApQuAAIdJVGWb2is,33366
+pygments/lexers/make.py,sha256=YMI5DBCrxWca-pz9cVXcyfuHLcikPx9R_3pW_98Myqo,7831
+pygments/lexers/maple.py,sha256=Rs0dEmOMD3C1YQPd0mntN-vzReq4XfHegH6xV4lvJWo,7960
+pygments/lexers/markup.py,sha256=zWtxsyIx_1OxQzS6wLe8bEqglePv4RqvJjbia8AvV5c,65088
+pygments/lexers/math.py,sha256=P3ZK1ePd8ZnLdlmHezo2irCA8T2-nlHBoSaBoT5mEVI,695
+pygments/lexers/matlab.py,sha256=F9KO4qowIhfP8oVhCRRzE_1sqg4zmQbsB2NZH193PiM,133027
+pygments/lexers/maxima.py,sha256=a0h9Ggs9JEovTrzbJT-BLVbOqI29yPnaMZlkU5f_FeY,2715
+pygments/lexers/meson.py,sha256=BMrsDo6BH2lzTFw7JDwQ9SDNMTrRkXCNRDVf4aFHdsI,4336
+pygments/lexers/mime.py,sha256=yGrf3h37LK4b6ERBpFiL_qzn3JgOfGR5KLagnbWFl6c,7582
+pygments/lexers/minecraft.py,sha256=Nu88snDDPzM0D-742fFdUriczL-EE911pAd4_I4-pAw,13696
+pygments/lexers/mips.py,sha256=STKiZT67b3QERXXn7XKVxlPBu7vwbPC5EyCpuf3Jfbw,4656
+pygments/lexers/ml.py,sha256=t8sCv4BjvuBq6AihKKUwStEONIgdXCC2RMtO0RopNbM,35390
+pygments/lexers/modeling.py,sha256=M7B58bGB-Zwd1EmPxKqtRvg7TgNCyem3MVUHv0_H2SQ,13683
+pygments/lexers/modula2.py,sha256=NtpXBRoUCeHfflgB39LknSkCwhBHBKv2Er_pinjVsNE,53072
+pygments/lexers/mojo.py,sha256=8JRVoftN1E-W2woG0K-4n8PQXTUM9iY6Sl5sWb2uGNg,24233
+pygments/lexers/monte.py,sha256=baWU6zlXloenw9MO1MtEVGE9i3CfiXAYhqU621MIjRk,6289
+pygments/lexers/mosel.py,sha256=gjRdedhA1jTjoYoM1Gpaoog_I9o7TRbYMHk97N1TXwg,9297
+pygments/lexers/ncl.py,sha256=zJ6ahlitit4S0pBXc7Wu96PB7xOn59MwfR2HdY5_C60,63999
+pygments/lexers/nimrod.py,sha256=Q1NSqEkLC5wWt7xJyKC-vzWw_Iw2SfDNP_pyMFBuIfA,6413
+pygments/lexers/nit.py,sha256=p_hVD8GzMRl3CABVKHtYgnXFUQk0i5F2FbWFA6WXm6s,2725
+pygments/lexers/nix.py,sha256=NOrv20gdq-2A7eZ6c2gElPHv1Xx2pvv20-qOymL9GMg,4421
+pygments/lexers/numbair.py,sha256=fxkp2CXeXWKBMewfi1H4JSYkmm4kU58wZ2Sh9BDYAWQ,1758
+pygments/lexers/oberon.py,sha256=jw403qUUs7zpTHAs5CbLjb8qiuwtxLk0spDIYqGZwAw,4210
+pygments/lexers/objective.py,sha256=Fo1WB3JMj8sNeYnvB84H4_qwhOt4WNJtJWjVEOwrJGk,23297
+pygments/lexers/ooc.py,sha256=kD1XaJZaihDF_s-Vyu1Bx68S_9zFt2rhox7NF8LpOZM,3002
+pygments/lexers/openscad.py,sha256=h9I1k8kiuQmhX5vZm6VDSr2fa5Finy0sN8ZDIE-jx1c,3700
+pygments/lexers/other.py,sha256=WLVyqPsvm9oSXIbZwbfyJloS6HGgoFW5nVTaU1uQpTw,1763
+pygments/lexers/parasail.py,sha256=DWMGhtyQgGTXbIgQl_mID6CKqi-Dhbvs_dTkmvrZXfE,2719
+pygments/lexers/parsers.py,sha256=feNgxroPoWRf0NEsON2mtmKDUfslIQppukw6ndEsQ3M,26596
+pygments/lexers/pascal.py,sha256=N2tRAjlXnTxggAzzk2tOOAVzeC2MBzrXy97_HQl5n44,30989
+pygments/lexers/pawn.py,sha256=LWUYQYsebMMt2d5oxX1HYWvBqbakR1h7Av_z8Vw94Wg,8253
+pygments/lexers/pddl.py,sha256=Mk4_BzlROJCd0xR4KKRRSrbj0F7LLQcBRjmsmtWmrCg,2989
+pygments/lexers/perl.py,sha256=9BXn3tyHMA49NvzbM9E2czSCHjeU7bvaPLUcoZrhz-4,39192
+pygments/lexers/phix.py,sha256=hZqychqo5sFMBDESzDPXg1DYHQe_9sn294UfbjihaFk,23249
+pygments/lexers/php.py,sha256=l4hzQrlm0525i5dSw9Vmjcai3TzbPT6DkjzxPg9l6Zc,13061
+pygments/lexers/pointless.py,sha256=WSDjqQyGrNIGmTCdaMxl4zk7OZTlJAMzeUZ02kfgcTI,1974
+pygments/lexers/pony.py,sha256=EXrMkacqMZblI7v4AvBRQe-3Py8__bx5FOgjCLdfXxQ,3279
+pygments/lexers/praat.py,sha256=4UFK-nbC6WkZBhJgcQqEGqq9CocJkW7AmT_OJQbjWzk,12676
+pygments/lexers/procfile.py,sha256=05W2fyofLTP-FbEdSXD1eles-PPqVNfF6RWXjQdW2us,1155
+pygments/lexers/prolog.py,sha256=9Kc5YNUFqkfWu2sYoyzC3RX65abf1bm7oHr86z1s4kQ,12866
+pygments/lexers/promql.py,sha256=n-0vo-o8-ZasqP3Va4ujs562UfZSLfZF-RzT71yL0Tk,4738
+pygments/lexers/prql.py,sha256=PFReuvhbv4K5aeu6lvDfw4m-3hULkB3r43bKAy948os,8747
+pygments/lexers/ptx.py,sha256=KSHAvbiNVUntKilQ6EPYoLFocmJpRsBy_7fW6_Nrs1Y,4501
+pygments/lexers/python.py,sha256=WZe7fBAHKZ_BxPg8qIU26UGhk8qwUYyENJ3IyPW64mc,53805
+pygments/lexers/q.py,sha256=WQFUh3JrpK2j-VGW_Ytn3uJ5frUNmQIFnLtMVGRA9DI,6936
+pygments/lexers/qlik.py,sha256=2wqwdfIjrAz6RNBsP4MyeLX8Z7QpIGzxtf1CvaOlr_g,3693
+pygments/lexers/qvt.py,sha256=XMBnsWRrvCDf989OuDeb-KpszAkeETiACyaghZeL1ns,6103
+pygments/lexers/r.py,sha256=B6WgrD9SY1UTCV1fQBSlZbezPfpYsARn3FQIHcFYOiM,6474
+pygments/lexers/rdf.py,sha256=qUzxLna9v071bHhZAjdsBi8dKaJNk_h9g1ZRUAYCfoo,16056
+pygments/lexers/rebol.py,sha256=4u3N4kzui55HapopXDu3Kt0jczxDZ4buzwR7Mt4tQiM,18259
+pygments/lexers/rego.py,sha256=Rx5Gphbktr9ojg5DbqlyxHeQqqtF7g8W-oF0rmloDNY,1748
+pygments/lexers/resource.py,sha256=ioEzgWksB5HCjoz85XNkQPSd7n5kL0SZiuPkJP1hunQ,2927
+pygments/lexers/ride.py,sha256=kCWdxuR3PclVi4wiA0uUx4CYEFwuTqoMsKjhSW4X3yg,5035
+pygments/lexers/rita.py,sha256=Mj1QNxx1sWAZYC02kw8piVckaiw9B0MqQtiIiDFH0pA,1127
+pygments/lexers/rnc.py,sha256=g7ZD334PMGUqy_Ij64laSN1vJerwHqVkegfMCa3E-y8,1972
+pygments/lexers/roboconf.py,sha256=HbYuK5CqmQdd63SRY2nle01r7-p7mil0SnoauYDmEOY,2074
+pygments/lexers/robotframework.py,sha256=c4U1B9Q9ITBCTohqJTZOvkfyeVbenN4xhzSWIoZh5eU,18448
+pygments/lexers/ruby.py,sha256=uG617E5abBZcECRCqkhIfc-IbZcRb5cGuUZq_xpax90,22753
+pygments/lexers/rust.py,sha256=ZY-9vtsreBP0NfDd0WCouLSp_9MChAL8U8Abe-m9PB8,8260
+pygments/lexers/sas.py,sha256=C1Uz2s9DU6_s2kL-cB_PAGPtpyK5THlmhNmCumC1l48,9456
+pygments/lexers/savi.py,sha256=jrmruK0GnXktgBTWXW3oN3TXtofn3HBbkMlHnR84cko,4878
+pygments/lexers/scdoc.py,sha256=DXRmFDmYuc7h3gPAAVhfcL1OEbNBK5RdPpJqQzF3ZTk,2524
+pygments/lexers/scripting.py,sha256=eaYlkDK-_cAwTcCBHP6QXBCz8n6OzbhzdkRe0uV0xWY,81814
+pygments/lexers/sgf.py,sha256=w6C513ENaO2YCnqrduK7k03NaMDf-pgygvfzq2NaSRk,1985
+pygments/lexers/shell.py,sha256=dCS1zwkf5KwTog4__MnMC7h3Xmwv4_d3fnEV29tSwXI,36381
+pygments/lexers/sieve.py,sha256=eob-L84yf2jmhdNyYZUlbUJozdcd6GXcHW68lmAe8WE,2514
+pygments/lexers/slash.py,sha256=I-cRepmaxhL1SgYvD1hHX3gNBFI8NPszdU7hn1o5JlA,8484
+pygments/lexers/smalltalk.py,sha256=ue2PmqDK2sw0j75WdseiiENJBdZ1OwysH2Op1QN1r24,7204
+pygments/lexers/smithy.py,sha256=VREWoeuz7ANap_Uiopn7rs0Tnsfc-xBisDJKRGQY_y8,2659
+pygments/lexers/smv.py,sha256=He_VBSMbWONMWZmkrB5RYR0cfHVnMyKIXz68IFYl-a8,2805
+pygments/lexers/snobol.py,sha256=qDzb41xQQWMNmjB2MtZs23pFoFgZ2gbRZhK_Ir03r7I,2778
+pygments/lexers/solidity.py,sha256=Tixfnwku4Yezj6nNm8xVaw7EdV1qgAgdwahdTFP0St8,3163
+pygments/lexers/soong.py,sha256=Vm18vV4g6T8UPgjjY2yTRlSXGDpZowmuqQUBFfm4A9A,2339
+pygments/lexers/sophia.py,sha256=2YtYIT8iwAoW0B7TZuuoG_ZILhJV-2A7oBGat-98naE,3376
+pygments/lexers/special.py,sha256=8JuR2Vex8X-RWnC36S0HXTHWp2qmZclc90-TrLUWyaY,3585
+pygments/lexers/spice.py,sha256=m4nK0q4Sq_OFQez7kGWfki0No4ZV24YrONfHVj1Piqs,2790
+pygments/lexers/sql.py,sha256=WSG6vOsR87EEEwSQefP_Z7TauUG_BjqMHUFmPaSOVj4,41476
+pygments/lexers/srcinfo.py,sha256=B8vDs-sJogG3mWa5Hp_7JfHHUMyYRwGvKv6cKbFQXLM,1746
+pygments/lexers/stata.py,sha256=Zr9BC52D5O_3BbdW0N-tzoUmy0NTguL2sC-saXRVM-c,6415
+pygments/lexers/supercollider.py,sha256=_H5wDrn0DiGnlhB_cz6Rt_lo2TvqjSm0o6NPTd9R4Ko,3697
+pygments/lexers/tablegen.py,sha256=1JjedXYY18BNiY9JtNGLOtGfiwduNDZpQLBGTeQ6jAw,3987
+pygments/lexers/tact.py,sha256=X_lsxjFUMaC1TmYysXJq9tmAGifRnil83Bt1zA86Xdo,10809
+pygments/lexers/tal.py,sha256=xS9PlaWQOPj8MVr56fUNq31vUQKRWoLTlyWj9ZHm8AM,2904
+pygments/lexers/tcl.py,sha256=lK97ju4nikkt-oGOzIeyFEM98yq4dZSI8uEmYsq0R6c,5512
+pygments/lexers/teal.py,sha256=t3dqy_Arwv8_yExbX_xiFxv1TqJLPv4vh1MVKjKwS4Y,3522
+pygments/lexers/templates.py,sha256=BVdjYeoacIUuFyHTG39j4PxeNCe5E1oUURjH1rITrI4,75731
+pygments/lexers/teraterm.py,sha256=ciwztagW5Drg2gr17Qykrh6GwMsKy7e4xdQshX95GyQ,9718
+pygments/lexers/testing.py,sha256=YZgDgUEaLEYKSKEqpDsUi3Bn-Db_D42IlyiSsr1oX8U,10810
+pygments/lexers/text.py,sha256=nOCQPssIlKdVWU3PKxZiBPkf_KFM2V48IOssSyqhFY8,1068
+pygments/lexers/textedit.py,sha256=ttT4Ph-hIdgFLG6maRy_GskkziTFK0Wcg28yU0s6lek,7760
+pygments/lexers/textfmts.py,sha256=mi9KLEq4mrzDJbEc8G3VM-mSki_Tylkzodu47yH6z84,15524
+pygments/lexers/theorem.py,sha256=51ppBAEdhJmwU_lC916zMyjEoKLXqf89VAE_Lr0PNCc,17855
+pygments/lexers/thingsdb.py,sha256=x_fHNkLA-hIJyeIs6rg_X8n5OLYvFqaSu1FhI3apI5Y,6017
+pygments/lexers/tlb.py,sha256=ue2gqm45BI512lM13O8skAky9zAb7pLMrxZ8pbt5zRU,1450
+pygments/lexers/tls.py,sha256=_uQUVuMRDOhN-XUyGR5DIlVCk1CUZ1fIOSN4_WQYPKk,1540
+pygments/lexers/tnt.py,sha256=pK4LgoKON7u1xF66JYFncAPSbD8DZaeI_WTZ9HqEFlY,10456
+pygments/lexers/trafficscript.py,sha256=X3B8kgxS54ecuok9ic6Hkp-UMn5DvOmCK0p70Tz27Cw,1506
+pygments/lexers/typoscript.py,sha256=mBuePiVZUoAORPKsHwrx6fBWiy3fAIqG-2O67QmMiFI,8332
+pygments/lexers/typst.py,sha256=zIJBEhUXtWp5OiyAmvFA5m8d1EQG-ocwrJ677dvTUAk,7167
+pygments/lexers/ul4.py,sha256=rCaw0J9j3cdql9lX_HTilg65k9-9S118zOA6TAYfxaM,10499
+pygments/lexers/unicon.py,sha256=RAqoCnAAJBYOAGdR8ng0g6FtB39bGemLRlIqv5mcg9E,18625
+pygments/lexers/urbi.py,sha256=ajNP70NJg32jNnFDZsLvr_-4TToSGqRGkFyAPIJLfCU,6082
+pygments/lexers/usd.py,sha256=2eEGouolodYS402P_gtBrn4lLzpg1z8uHwPCKqjUb_k,3304
+pygments/lexers/varnish.py,sha256=dSh0Ku9SrjmlB29Fi_mWdWavN7M0cMKeepR4a34sOyI,7473
+pygments/lexers/verification.py,sha256=Qu433Q_h3EK3uS4bJoLRFZK0kIVwzX5AFKsa4Z-qnxA,3934
+pygments/lexers/verifpal.py,sha256=buyOOzCo_dGnoC40h0tthylHVVpgDt8qXu4olLvYy_4,2661
+pygments/lexers/vip.py,sha256=2lEV4cLV9p4E37wctBL7zkZ4ZU4p3HVsiLJFzB1bie0,5711
+pygments/lexers/vyper.py,sha256=Zq6sQIUBk6mBdpgOVgu3A6swGoBne0kDlRyjZznm2BY,5615
+pygments/lexers/web.py,sha256=4W9a7vcskrGJnxt4KmoE3SZydWB1qLq7lP2XS85J_m8,913
+pygments/lexers/webassembly.py,sha256=zgcMouzLawcbeFr6w_SOvGoUR68ZtqnnsbOcWEVleLk,5698
+pygments/lexers/webidl.py,sha256=ODtVmw4gVzI8HQWxuEckP6KMwm8WP2G2lSZEjagDXts,10516
+pygments/lexers/webmisc.py,sha256=-_-INDVdk47e2jlj-9bFcuLtntqVorBqIjlnwPfZFdI,40564
+pygments/lexers/wgsl.py,sha256=9igd9dzixGIgNewruv9mPnFms-c9BahkZcCCrZygv84,11880
+pygments/lexers/whiley.py,sha256=lMr750lA4MZsB4xqzVsIRtVMJIC3_dArhFYTHvOPwvA,4017
+pygments/lexers/wowtoc.py,sha256=8xxvf0xGeYtf4PE7KtkHZ_ly9xY_XXHrpCitdKE42Ro,4076
+pygments/lexers/wren.py,sha256=goGXnAMKKa13LLL40ybT3aMGPrk3gCRwZQFYAkKB_w0,3229
+pygments/lexers/x10.py,sha256=Q-AmgdF2E-N7mtOPpZ07CsxrTVnikyqC4uRRv6H75sk,1943
+pygments/lexers/xorg.py,sha256=9ttrBd3_Y2nXANsqtMposSgblYmMYqWXQ-Iz5RH9RsU,925
+pygments/lexers/yang.py,sha256=13CWbSaNr9giOHz4o0SXSklh0bfWt0ah14jJGpTvcn0,4499
+pygments/lexers/yara.py,sha256=jUSv78KTDfguCoAoAZKbYzQERkkyxBBWv5dInVrkDxo,2427
+pygments/lexers/zig.py,sha256=f-80MVOSp1KnczAMokQLVM-_wAEOD16EcGFnaCNlsN0,3976
+pygments/modeline.py,sha256=K5eSkR8GS1r5OkXXTHOcV0aM_6xpk9eWNEIAW-OOJ2g,1005
+pygments/plugin.py,sha256=tPx0rJCTIZ9ioRgLNYG4pifCbAwTRUZddvLw-NfAk2w,1891
+pygments/regexopt.py,sha256=wXaP9Gjp_hKAdnICqoDkRxAOQJSc4v3X6mcxx3z-TNs,3072
+pygments/scanner.py,sha256=nNcETRR1tRuiTaHmHSTTECVYFPcLf6mDZu1e4u91A9E,3092
+pygments/sphinxext.py,sha256=VEe_oHNgLoEGMHc2ROfbee2mF2PPREFyE6_m_JN5FvQ,7898
+pygments/style.py,sha256=Cpw9dCAyW3_JAwFRXOJXmtKb5ZwO2_5KSmlq6q4fZw4,6408
+pygments/styles/__init__.py,sha256=f9KCQXN4uKbe8aI8-L3qTC-_XPfT563FwTg6VTGVfwI,2006
+pygments/styles/__pycache__/__init__.cpython-312.pyc,,
+pygments/styles/__pycache__/_mapping.cpython-312.pyc,,
+pygments/styles/__pycache__/abap.cpython-312.pyc,,
+pygments/styles/__pycache__/algol.cpython-312.pyc,,
+pygments/styles/__pycache__/algol_nu.cpython-312.pyc,,
+pygments/styles/__pycache__/arduino.cpython-312.pyc,,
+pygments/styles/__pycache__/autumn.cpython-312.pyc,,
+pygments/styles/__pycache__/borland.cpython-312.pyc,,
+pygments/styles/__pycache__/bw.cpython-312.pyc,,
+pygments/styles/__pycache__/coffee.cpython-312.pyc,,
+pygments/styles/__pycache__/colorful.cpython-312.pyc,,
+pygments/styles/__pycache__/default.cpython-312.pyc,,
+pygments/styles/__pycache__/dracula.cpython-312.pyc,,
+pygments/styles/__pycache__/emacs.cpython-312.pyc,,
+pygments/styles/__pycache__/friendly.cpython-312.pyc,,
+pygments/styles/__pycache__/friendly_grayscale.cpython-312.pyc,,
+pygments/styles/__pycache__/fruity.cpython-312.pyc,,
+pygments/styles/__pycache__/gh_dark.cpython-312.pyc,,
+pygments/styles/__pycache__/gruvbox.cpython-312.pyc,,
+pygments/styles/__pycache__/igor.cpython-312.pyc,,
+pygments/styles/__pycache__/inkpot.cpython-312.pyc,,
+pygments/styles/__pycache__/lightbulb.cpython-312.pyc,,
+pygments/styles/__pycache__/lilypond.cpython-312.pyc,,
+pygments/styles/__pycache__/lovelace.cpython-312.pyc,,
+pygments/styles/__pycache__/manni.cpython-312.pyc,,
+pygments/styles/__pycache__/material.cpython-312.pyc,,
+pygments/styles/__pycache__/monokai.cpython-312.pyc,,
+pygments/styles/__pycache__/murphy.cpython-312.pyc,,
+pygments/styles/__pycache__/native.cpython-312.pyc,,
+pygments/styles/__pycache__/nord.cpython-312.pyc,,
+pygments/styles/__pycache__/onedark.cpython-312.pyc,,
+pygments/styles/__pycache__/paraiso_dark.cpython-312.pyc,,
+pygments/styles/__pycache__/paraiso_light.cpython-312.pyc,,
+pygments/styles/__pycache__/pastie.cpython-312.pyc,,
+pygments/styles/__pycache__/perldoc.cpython-312.pyc,,
+pygments/styles/__pycache__/rainbow_dash.cpython-312.pyc,,
+pygments/styles/__pycache__/rrt.cpython-312.pyc,,
+pygments/styles/__pycache__/sas.cpython-312.pyc,,
+pygments/styles/__pycache__/solarized.cpython-312.pyc,,
+pygments/styles/__pycache__/staroffice.cpython-312.pyc,,
+pygments/styles/__pycache__/stata_dark.cpython-312.pyc,,
+pygments/styles/__pycache__/stata_light.cpython-312.pyc,,
+pygments/styles/__pycache__/tango.cpython-312.pyc,,
+pygments/styles/__pycache__/trac.cpython-312.pyc,,
+pygments/styles/__pycache__/vim.cpython-312.pyc,,
+pygments/styles/__pycache__/vs.cpython-312.pyc,,
+pygments/styles/__pycache__/xcode.cpython-312.pyc,,
+pygments/styles/__pycache__/zenburn.cpython-312.pyc,,
+pygments/styles/_mapping.py,sha256=6lovFUE29tz6EsV3XYY4hgozJ7q1JL7cfO3UOlgnS8w,3312
+pygments/styles/abap.py,sha256=64Uwr8uPdEdcT-tE-Y2VveTXfH3SkqH9qdMgY49YHQI,749
+pygments/styles/algol.py,sha256=fCuk8ITTehvbJSufiaKlgnFsKbl-xFxxR82xhltc-cQ,2262
+pygments/styles/algol_nu.py,sha256=Gv9WfHJvYegGcUk1zcufQgsdXPNjCUNk8sAHyrSGGh4,2283
+pygments/styles/arduino.py,sha256=NoUB8xk7M1HGPoLfuySOLU0sVwoTuLcZqllXl2EO_iE,4557
+pygments/styles/autumn.py,sha256=fLLfjHXjxCl6crBAxEsBLH372ALMkFacA2bG6KFbJi4,2195
+pygments/styles/borland.py,sha256=_0ySKp4KGCSgtYjPe8uzD6gQhlmAIR4T43i-FoRYNOM,1611
+pygments/styles/bw.py,sha256=vhk8Xoj64fLPdA9IQU6mUVsYMel255jR-FDU7BjIHtI,1406
+pygments/styles/coffee.py,sha256=NqLt-fc7LONma1BGggbceVRY9uDE70WBuZXqK4zwaco,2308
+pygments/styles/colorful.py,sha256=mYcSbehtH7itH_QV9NqJp4Wna1X4lrwl2wkVXS2u-5A,2832
+pygments/styles/default.py,sha256=RTgG2zKWWUxPTDCFxhTnyZI_WZBIVgu5XsUpNvFisCA,2588
+pygments/styles/dracula.py,sha256=vRJmixBoSKV9o8NVQhXGViQqchhIYugfikLmvX0DoBw,2182
+pygments/styles/emacs.py,sha256=TiOG9oc83qToMCRMnJrXtWYqnzAqYycRz_50OoCKtxc,2535
+pygments/styles/friendly.py,sha256=oAi-l9anQTs9STDmUzXGDlOegatEOH4hpD0j6o6dZGM,2604
+pygments/styles/friendly_grayscale.py,sha256=a7Cqkzt6-uTiXvj6GoYBXzRvX5_zviCjjRB04Kf_-Q0,2828
+pygments/styles/fruity.py,sha256=GfSUTG0stlJr5Ow_saCaxbI2IB4-34Dp2TuRTpfUJBs,1324
+pygments/styles/gh_dark.py,sha256=ruNX3d4rf22rx-8HnwvGbNbXRQpXCNcHU1HNq6N4uNg,3590
+pygments/styles/gruvbox.py,sha256=KrFoHEoVnZW6XM9udyXncPomeGyZgIDsNWOH3kCrxFQ,3387
+pygments/styles/igor.py,sha256=fYYPhM0dRCvcDTMVrMVO5oFKnYm-8YVlsuVBoczFLtY,737
+pygments/styles/inkpot.py,sha256=jggSeX9NV15eOL2oJaVmZ6vmV7LWRzXJQRUqcWEqGRs,2404
+pygments/styles/lightbulb.py,sha256=Y8u1qdvlHfBqI2jJex55SkvVatVo_FjEUzE6h-X7m-0,3172
+pygments/styles/lilypond.py,sha256=Y6fp_sEL-zESmxAaMxzjtrKk90cuDC_DalNdC8wj0nw,2066
+pygments/styles/lovelace.py,sha256=cA9uhmbnzY04MccsiYSgMY7fvb4WMRbegWBUrGvXh1M,3178
+pygments/styles/manni.py,sha256=g9FyO7plTwfMm2cU4iiKgdlkMlvQLG6l2Lwkgz5ITS4,2443
+pygments/styles/material.py,sha256=LDmgomAbgtJDZhbv446_zIwgYh50UAqEEtgYNUns1rQ,4201
+pygments/styles/monokai.py,sha256=lrxTJpkBarV9gTLkBQryZ6oNSjekAVheJueKJP5iEYA,5184
+pygments/styles/murphy.py,sha256=-AKZiLkpiWej-otjHMsYCE-I-_IzCOLJY-_GBdKRZRw,2805
+pygments/styles/native.py,sha256=l6tezGSQTB8p_SyOXJ0PWI7KzCeEdtsPmVc4Yn4_CwU,2043
+pygments/styles/nord.py,sha256=GDt3WAaqaWsiCeqpIBPxd8TEUX708fGfwaA7S0w0oy0,5391
+pygments/styles/onedark.py,sha256=k80cZEppCEF-HLoxy_FEA0QmQDZze68nHVMNGyUVa28,1719
+pygments/styles/paraiso_dark.py,sha256=Jkrg4nUKIVNF8U4fPNV_Smq_g9NFbb9eiUrjYpVgQZg,5662
+pygments/styles/paraiso_light.py,sha256=MxN964ZEpze3wF0ss-igaa2I7E684MHe-Zq0rWPH3wo,5668
+pygments/styles/pastie.py,sha256=ZvAs9UpBNYFC-5PFrCRGYnm3FoPKb-eKR-ozbWZP-4g,2525
+pygments/styles/perldoc.py,sha256=HSxB93e4UpQkZspReQ34FeJbZ-59ksGvdaH-hToehi8,2230
+pygments/styles/rainbow_dash.py,sha256=4ugL18Or7aNtaLfPfCLFRiFy0Gu2RA4a9G2LQUE9SrM,2390
+pygments/styles/rrt.py,sha256=fgzfpC0PC_SCcLOMCNEIQTjPUMOncRe7SR10GfSRbXY,1006
+pygments/styles/sas.py,sha256=yzoXmbfQ2ND1WWq93b4vVGYkQSZHPqb4ymes9YYRT3w,1440
+pygments/styles/solarized.py,sha256=qupILFZn02WspnAF5SPYb-W8guo9xnUtjb1HeLw3XgE,4247
+pygments/styles/staroffice.py,sha256=CLbBeMoxay21Xyu3Af2p4xUXyG1_6ydCbvs5RJKYe5w,831
+pygments/styles/stata_dark.py,sha256=vX8SwHV__sG92F4CKribG08MJfSVq98dgs7gEA_n9yc,1257
+pygments/styles/stata_light.py,sha256=uV3GE-ylvffQ0yN3py1YAVqBB5wflIKZbceyK1Lqvrc,1289
+pygments/styles/tango.py,sha256=O2wcM4hHuU1Yt071M9CK7JPtiiSCqyxtT9tbiQICV28,7137
+pygments/styles/trac.py,sha256=9kMv1ZZyMKACWlx2fQVjRP0I2pgcRYCNrd7iGGZg9qk,1981
+pygments/styles/vim.py,sha256=J7_TqvrGkTX_XuTHW0In5wqPLAUPRWyr1122XueZWmM,2019
+pygments/styles/vs.py,sha256=s7YnzbIPuFU3LIke27mc4lAQSn2R3vbbHc1baMGSU_U,1130
+pygments/styles/xcode.py,sha256=PbQdzgGaA4a9LAU1i58alY9kM4IFlQX5jHQwOYmf_Rk,1504
+pygments/styles/zenburn.py,sha256=suZEKzBTCYdhf2cxNwcY7UATJK1tq5eYhGdBcXdf6MU,2203
+pygments/token.py,sha256=WbdWGhYm_Vosb0DDxW9lHNPgITXfWTsQmHt6cy9RbcM,6226
+pygments/unistring.py,sha256=al-_rBemRuGvinsrM6atNsHTmJ6DUbw24q2O2Ru1cBc,63208
+pygments/util.py,sha256=oRtSpiAo5jM9ulntkvVbgXUdiAW57jnuYGB7t9fYuhc,10031
diff --git a/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/WHEEL b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/WHEEL
new file mode 100644
index 0000000..12228d4
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/entry_points.txt b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/entry_points.txt
new file mode 100644
index 0000000..15498e3
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/entry_points.txt
@@ -0,0 +1,2 @@
+[console_scripts]
+pygmentize = pygments.cmdline:main
diff --git a/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/licenses/AUTHORS b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/licenses/AUTHORS
new file mode 100644
index 0000000..811c66a
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/licenses/AUTHORS
@@ -0,0 +1,291 @@
+Pygments is written and maintained by Georg Brandl .
+
+Major developers are Tim Hatch  and Armin Ronacher
+.
+
+Other contributors, listed alphabetically, are:
+
+* Sam Aaron -- Ioke lexer
+* Jean Abou Samra -- LilyPond lexer
+* João Abecasis -- JSLT lexer
+* Ali Afshar -- image formatter
+* Thomas Aglassinger -- Easytrieve, JCL, Rexx, Transact-SQL and VBScript
+  lexers
+* Maxence Ahlouche -- PostgreSQL Explain lexer
+* Muthiah Annamalai -- Ezhil lexer
+* Nikolay Antipov -- OpenSCAD lexer
+* Kumar Appaiah -- Debian control lexer
+* Andreas Amann -- AppleScript lexer
+* Timothy Armstrong -- Dart lexer fixes
+* Jeffrey Arnold -- R/S, Rd, BUGS, Jags, and Stan lexers
+* Eiríkr Åsheim -- Uxntal lexer
+* Jeremy Ashkenas -- CoffeeScript lexer
+* José Joaquín Atria -- Praat lexer
+* Stefan Matthias Aust -- Smalltalk lexer
+* Lucas Bajolet -- Nit lexer
+* Ben Bangert -- Mako lexers
+* Max Battcher -- Darcs patch lexer
+* Thomas Baruchel -- APL lexer
+* Tim Baumann -- (Literate) Agda lexer
+* Paul Baumgart, 280 North, Inc. -- Objective-J lexer
+* Michael Bayer -- Myghty lexers
+* Thomas Beale -- Archetype lexers
+* John Benediktsson -- Factor lexer
+* David Benjamin, Google LLC -- TLS lexer
+* Trevor Bergeron -- mIRC formatter
+* Vincent Bernat -- LessCSS lexer
+* Christopher Bertels -- Fancy lexer
+* Sébastien Bigaret -- QVT Operational lexer
+* Jarrett Billingsley -- MiniD lexer
+* Adam Blinkinsop -- Haskell, Redcode lexers
+* Stéphane Blondon -- Procfile, SGF and Sieve lexers
+* Frits van Bommel -- assembler lexers
+* Pierre Bourdon -- bugfixes
+* Martijn Braam -- Kernel log lexer, BARE lexer
+* JD Browne, Google LLC -- GoogleSQL lexer
+* Matthias Bussonnier -- ANSI style handling for terminal-256 formatter
+* chebee7i -- Python traceback lexer improvements
+* Hiram Chirino -- Scaml and Jade lexers
+* Mauricio Caceres -- SAS and Stata lexers.
+* Michael Camilleri, John Gabriele, sogaiu -- Janet lexer
+* Daren Chandisingh -- Gleam lexer
+* Ian Cooper -- VGL lexer
+* David Corbett -- Inform, Jasmin, JSGF, Snowball, and TADS 3 lexers
+* Leaf Corcoran -- MoonScript lexer
+* Fraser Cormack -- TableGen lexer
+* Gabriel Corona -- ASN.1 lexer
+* Christopher Creutzig -- MuPAD lexer
+* Daniël W. Crompton -- Pike lexer
+* Pete Curry -- bugfixes
+* Bryan Davis -- EBNF lexer
+* Bruno Deferrari -- Shen lexer
+* Walter Dörwald -- UL4 lexer
+* Luke Drummond -- Meson lexer
+* Giedrius Dubinskas -- HTML formatter improvements
+* Owen Durni -- Haxe lexer
+* Alexander Dutton, Oxford University Computing Services -- SPARQL lexer
+* James Edwards -- Terraform lexer
+* Nick Efford -- Python 3 lexer
+* Sven Efftinge -- Xtend lexer
+* Artem Egorkine -- terminal256 formatter
+* Matthew Fernandez -- CAmkES lexer
+* Paweł Fertyk -- GDScript lexer, HTML formatter improvements
+* Michael Ficarra -- CPSA lexer
+* James H. Fisher -- PostScript lexer
+* Amanda Fitch, Google LLC -- GoogleSQL lexer
+* William S. Fulton -- SWIG lexer
+* Carlos Galdino -- Elixir and Elixir Console lexers
+* Michael Galloy -- IDL lexer
+* Naveen Garg -- Autohotkey lexer
+* Simon Garnotel -- FreeFem++ lexer
+* Laurent Gautier -- R/S lexer
+* Alex Gaynor -- PyPy log lexer
+* Richard Gerkin -- Igor Pro lexer
+* Alain Gilbert -- TypeScript lexer
+* Alex Gilding -- BlitzBasic lexer
+* GitHub, Inc -- DASM16, Augeas, TOML, and Slash lexers
+* Bertrand Goetzmann -- Groovy lexer
+* Krzysiek Goj -- Scala lexer
+* Rostyslav Golda -- FloScript lexer
+* Andrey Golovizin -- BibTeX lexers
+* Matt Good -- Genshi, Cheetah lexers
+* Michał Górny -- vim modeline support
+* Alex Gosse -- TrafficScript lexer
+* Patrick Gotthardt -- PHP namespaces support
+* Hubert Gruniaux -- C and C++ lexer improvements
+* Olivier Guibe -- Asymptote lexer
+* Phil Hagelberg -- Fennel lexer
+* Florian Hahn -- Boogie lexer
+* Martin Harriman -- SNOBOL lexer
+* Matthew Harrison -- SVG formatter
+* Steven Hazel -- Tcl lexer
+* Dan Michael Heggø -- Turtle lexer
+* Aslak Hellesøy -- Gherkin lexer
+* Greg Hendershott -- Racket lexer
+* Justin Hendrick -- ParaSail lexer
+* Jordi Gutiérrez Hermoso -- Octave lexer
+* David Hess, Fish Software, Inc. -- Objective-J lexer
+* Ken Hilton -- Typographic Number Theory and Arrow lexers
+* Varun Hiremath -- Debian control lexer
+* Rob Hoelz -- Perl 6 lexer
+* Doug Hogan -- Mscgen lexer
+* Ben Hollis -- Mason lexer
+* Max Horn -- GAP lexer
+* Fred Hornsey -- OMG IDL Lexer
+* Alastair Houghton -- Lexer inheritance facility
+* Tim Howard -- BlitzMax lexer
+* Dustin Howett -- Logos lexer
+* Ivan Inozemtsev -- Fantom lexer
+* Hiroaki Itoh -- Shell console rewrite, Lexers for PowerShell session,
+  MSDOS session, BC, WDiff
+* Brian R. Jackson -- Tea lexer
+* Christian Jann -- ShellSession lexer
+* Jonas Camillus Jeppesen -- Line numbers and line highlighting for 
+  RTF-formatter
+* Dennis Kaarsemaker -- sources.list lexer
+* Dmitri Kabak -- Inferno Limbo lexer
+* Igor Kalnitsky -- vhdl lexer
+* Colin Kennedy - USD lexer
+* Alexander Kit -- MaskJS lexer
+* Pekka Klärck -- Robot Framework lexer
+* Gerwin Klein -- Isabelle lexer
+* Eric Knibbe -- Lasso lexer
+* Stepan Koltsov -- Clay lexer
+* Oliver Kopp - Friendly grayscale style
+* Adam Koprowski -- Opa lexer
+* Benjamin Kowarsch -- Modula-2 lexer
+* Domen Kožar -- Nix lexer
+* Oleh Krekel -- Emacs Lisp lexer
+* Alexander Kriegisch -- Kconfig and AspectJ lexers
+* Marek Kubica -- Scheme lexer
+* Jochen Kupperschmidt -- Markdown processor
+* Gerd Kurzbach -- Modelica lexer
+* Jon Larimer, Google Inc. -- Smali lexer
+* Olov Lassus -- Dart lexer
+* Matt Layman -- TAP lexer
+* Dan Lazin, Google LLC -- GoogleSQL lexer
+* Kristian Lyngstøl -- Varnish lexers
+* Sylvestre Ledru -- Scilab lexer
+* Chee Sing Lee -- Flatline lexer
+* Mark Lee -- Vala lexer
+* Thomas Linder Puls -- Visual Prolog lexer
+* Pete Lomax -- Phix lexer
+* Valentin Lorentz -- C++ lexer improvements
+* Ben Mabey -- Gherkin lexer
+* Angus MacArthur -- QML lexer
+* Louis Mandel -- X10 lexer
+* Louis Marchand -- Eiffel lexer
+* Simone Margaritelli -- Hybris lexer
+* Tim Martin - World of Warcraft TOC lexer
+* Kirk McDonald -- D lexer
+* Gordon McGregor -- SystemVerilog lexer
+* Stephen McKamey -- Duel/JBST lexer
+* Brian McKenna -- F# lexer
+* Charles McLaughlin -- Puppet lexer
+* Kurt McKee -- Tera Term macro lexer, PostgreSQL updates, MySQL overhaul, JSON lexer
+* Joe Eli McIlvain -- Savi lexer
+* Lukas Meuser -- BBCode formatter, Lua lexer
+* Cat Miller -- Pig lexer
+* Paul Miller -- LiveScript lexer
+* Hong Minhee -- HTTP lexer
+* Michael Mior -- Awk lexer
+* Bruce Mitchener -- Dylan lexer rewrite
+* Reuben Morais -- SourcePawn lexer
+* Jon Morton -- Rust lexer
+* Paulo Moura -- Logtalk lexer
+* Mher Movsisyan -- DTD lexer
+* Dejan Muhamedagic -- Crmsh lexer
+* Adrien Nayrat -- PostgreSQL Explain lexer
+* Ana Nelson -- Ragel, ANTLR, R console lexers
+* David Neto, Google LLC -- WebGPU Shading Language lexer
+* Kurt Neufeld -- Markdown lexer
+* Nam T. Nguyen -- Monokai style
+* Jesper Noehr -- HTML formatter "anchorlinenos"
+* Mike Nolta -- Julia lexer
+* Avery Nortonsmith -- Pointless lexer
+* Jonas Obrist -- BBCode lexer
+* Edward O'Callaghan -- Cryptol lexer
+* David Oliva -- Rebol lexer
+* Pat Pannuto -- nesC lexer
+* Jon Parise -- Protocol buffers and Thrift lexers
+* Benjamin Peterson -- Test suite refactoring
+* Ronny Pfannschmidt -- BBCode lexer
+* Dominik Picheta -- Nimrod lexer
+* Andrew Pinkham -- RTF Formatter Refactoring
+* Clément Prévost -- UrbiScript lexer
+* Tanner Prynn -- cmdline -x option and loading lexers from files
+* Oleh Prypin -- Crystal lexer (based on Ruby lexer)
+* Nick Psaris -- K and Q lexers
+* Xidorn Quan -- Web IDL lexer
+* Elias Rabel -- Fortran fixed form lexer
+* raichoo -- Idris lexer
+* Daniel Ramirez -- GDScript lexer
+* Kashif Rasul -- CUDA lexer
+* Nathan Reed -- HLSL lexer
+* Justin Reidy -- MXML lexer
+* Jonathon Reinhart, Google LLC -- Soong lexer
+* Norman Richards -- JSON lexer
+* Corey Richardson -- Rust lexer updates
+* Fabrizio Riguzzi -- cplint leder
+* Lubomir Rintel -- GoodData MAQL and CL lexers
+* Andre Roberge -- Tango style
+* Georg Rollinger -- HSAIL lexer
+* Michiel Roos -- TypoScript lexer
+* Konrad Rudolph -- LaTeX formatter enhancements
+* Mario Ruggier -- Evoque lexers
+* Miikka Salminen -- Lovelace style, Hexdump lexer, lexer enhancements
+* Stou Sandalski -- NumPy, FORTRAN, tcsh and XSLT lexers
+* Matteo Sasso -- Common Lisp lexer
+* Joe Schafer -- Ada lexer
+* Max Schillinger -- TiddlyWiki5 lexer
+* Andrew Schmidt -- X++ lexer
+* Ken Schutte -- Matlab lexers
+* René Schwaiger -- Rainbow Dash style
+* Sebastian Schweizer -- Whiley lexer
+* Tassilo Schweyer -- Io, MOOCode lexers
+* Pablo Seminario -- PromQL lexer
+* Ted Shaw -- AutoIt lexer
+* Joerg Sieker -- ABAP lexer
+* Robert Simmons -- Standard ML lexer
+* Kirill Simonov -- YAML lexer
+* Corbin Simpson -- Monte lexer
+* Ville Skyttä -- ASCII armored lexer
+* Alexander Smishlajev -- Visual FoxPro lexer
+* Steve Spigarelli -- XQuery lexer
+* Jerome St-Louis -- eC lexer
+* Camil Staps -- Clean and NuSMV lexers; Solarized style
+* James Strachan -- Kotlin lexer
+* Tom Stuart -- Treetop lexer
+* Colin Sullivan -- SuperCollider lexer
+* Ben Swift -- Extempore lexer
+* tatt61880 -- Kuin lexer
+* Edoardo Tenani -- Arduino lexer
+* Tiberius Teng -- default style overhaul
+* Jeremy Thurgood -- Erlang, Squid config lexers
+* Brian Tiffin -- OpenCOBOL lexer
+* Bob Tolbert -- Hy lexer
+* Doug Torrance -- Macaulay2 lexer
+* Matthias Trute -- Forth lexer
+* Tuoa Spi T4 -- Bdd lexer
+* Erick Tryzelaar -- Felix lexer
+* Alexander Udalov -- Kotlin lexer improvements
+* Thomas Van Doren -- Chapel lexer
+* Dave Van Ee -- Uxntal lexer updates
+* Daniele Varrazzo -- PostgreSQL lexers
+* Abe Voelker -- OpenEdge ABL lexer
+* Pepijn de Vos -- HTML formatter CTags support
+* Matthias Vallentin -- Bro lexer
+* Benoît Vinot -- AMPL lexer
+* Linh Vu Hong -- RSL lexer
+* Taavi Väänänen -- Debian control lexer
+* Immanuel Washington -- Smithy lexer
+* Nathan Weizenbaum -- Haml and Sass lexers
+* Nathan Whetsell -- Csound lexers
+* Dietmar Winkler -- Modelica lexer
+* Nils Winter -- Smalltalk lexer
+* Davy Wybiral -- Clojure lexer
+* Whitney Young -- ObjectiveC lexer
+* Diego Zamboni -- CFengine3 lexer
+* Enrique Zamudio -- Ceylon lexer
+* Alex Zimin -- Nemerle lexer
+* Rob Zimmerman -- Kal lexer
+* Evgenii Zheltonozhskii -- Maple lexer
+* Vincent Zurczak -- Roboconf lexer
+* Hubert Gruniaux -- C and C++ lexer improvements
+* Thomas Symalla -- AMDGPU Lexer
+* 15b3 -- Image Formatter improvements
+* Fabian Neumann -- CDDL lexer
+* Thomas Duboucher -- CDDL lexer
+* Philipp Imhof -- Pango Markup formatter
+* Thomas Voss -- Sed lexer
+* Martin Fischer -- WCAG contrast testing
+* Marc Auberer -- Spice lexer
+* Amr Hesham -- Carbon lexer
+* diskdance -- Wikitext lexer
+* vanillajonathan -- PRQL lexer
+* Nikolay Antipov -- OpenSCAD lexer
+* Markus Meyer, Nextron Systems -- YARA lexer
+* Hannes Römer -- Mojo lexer
+* Jan Frederik Schaefer -- PDDL lexer
+
+Many thanks for all contributions!
diff --git a/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/licenses/LICENSE b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/licenses/LICENSE
new file mode 100644
index 0000000..446a1a8
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments-2.19.2.dist-info/licenses/LICENSE
@@ -0,0 +1,25 @@
+Copyright (c) 2006-2022 by the respective authors (see AUTHORS file).
+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.
+
+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 COPYRIGHT
+OWNER 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/env/lib/python3.12/site-packages/pygments/__init__.py b/env/lib/python3.12/site-packages/pygments/__init__.py
new file mode 100644
index 0000000..2a391c3
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/__init__.py
@@ -0,0 +1,82 @@
+"""
+    Pygments
+    ~~~~~~~~
+
+    Pygments is a syntax highlighting package written in Python.
+
+    It is a generic syntax highlighter for general use in all kinds of software
+    such as forum systems, wikis or other applications that need to prettify
+    source code. Highlights are:
+
+    * a wide range of common languages and markup formats is supported
+    * special attention is paid to details, increasing quality by a fair amount
+    * support for new languages and formats are added easily
+    * a number of output formats, presently HTML, LaTeX, RTF, SVG, all image
+      formats that PIL supports, and ANSI sequences
+    * it is usable as a command-line tool and as a library
+    * ... and it highlights even Brainfuck!
+
+    The `Pygments master branch`_ is installable with ``easy_install Pygments==dev``.
+
+    .. _Pygments master branch:
+       https://github.com/pygments/pygments/archive/master.zip#egg=Pygments-dev
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+from io import StringIO, BytesIO
+
+__version__ = '2.19.2'
+__docformat__ = 'restructuredtext'
+
+__all__ = ['lex', 'format', 'highlight']
+
+
+def lex(code, lexer):
+    """
+    Lex `code` with the `lexer` (must be a `Lexer` instance)
+    and return an iterable of tokens. Currently, this only calls
+    `lexer.get_tokens()`.
+    """
+    try:
+        return lexer.get_tokens(code)
+    except TypeError:
+        # Heuristic to catch a common mistake.
+        from pygments.lexer import RegexLexer
+        if isinstance(lexer, type) and issubclass(lexer, RegexLexer):
+            raise TypeError('lex() argument must be a lexer instance, '
+                            'not a class')
+        raise
+
+
+def format(tokens, formatter, outfile=None):  # pylint: disable=redefined-builtin
+    """
+    Format ``tokens`` (an iterable of tokens) with the formatter ``formatter``
+    (a `Formatter` instance).
+
+    If ``outfile`` is given and a valid file object (an object with a
+    ``write`` method), the result will be written to it, otherwise it
+    is returned as a string.
+    """
+    try:
+        if not outfile:
+            realoutfile = getattr(formatter, 'encoding', None) and BytesIO() or StringIO()
+            formatter.format(tokens, realoutfile)
+            return realoutfile.getvalue()
+        else:
+            formatter.format(tokens, outfile)
+    except TypeError:
+        # Heuristic to catch a common mistake.
+        from pygments.formatter import Formatter
+        if isinstance(formatter, type) and issubclass(formatter, Formatter):
+            raise TypeError('format() argument must be a formatter instance, '
+                            'not a class')
+        raise
+
+
+def highlight(code, lexer, formatter, outfile=None):
+    """
+    This is the most high-level highlighting function. It combines `lex` and
+    `format` in one function.
+    """
+    return format(lex(code, lexer), formatter, outfile)
diff --git a/env/lib/python3.12/site-packages/pygments/__main__.py b/env/lib/python3.12/site-packages/pygments/__main__.py
new file mode 100644
index 0000000..4890a6c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/__main__.py
@@ -0,0 +1,17 @@
+"""
+    pygments.__main__
+    ~~~~~~~~~~~~~~~~~
+
+    Main entry point for ``python -m pygments``.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import sys
+import pygments.cmdline
+
+try:
+    sys.exit(pygments.cmdline.main(sys.argv))
+except KeyboardInterrupt:
+    sys.exit(1)
diff --git a/env/lib/python3.12/site-packages/pygments/cmdline.py b/env/lib/python3.12/site-packages/pygments/cmdline.py
new file mode 100644
index 0000000..2878fd5
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/cmdline.py
@@ -0,0 +1,668 @@
+"""
+    pygments.cmdline
+    ~~~~~~~~~~~~~~~~
+
+    Command line interface.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import os
+import sys
+import shutil
+import argparse
+from textwrap import dedent
+
+from pygments import __version__, highlight
+from pygments.util import ClassNotFound, OptionError, docstring_headline, \
+    guess_decode, guess_decode_from_terminal, terminal_encoding, \
+    UnclosingTextIOWrapper
+from pygments.lexers import get_all_lexers, get_lexer_by_name, guess_lexer, \
+    load_lexer_from_file, get_lexer_for_filename, find_lexer_class_for_filename
+from pygments.lexers.special import TextLexer
+from pygments.formatters.latex import LatexEmbeddedLexer, LatexFormatter
+from pygments.formatters import get_all_formatters, get_formatter_by_name, \
+    load_formatter_from_file, get_formatter_for_filename, find_formatter_class
+from pygments.formatters.terminal import TerminalFormatter
+from pygments.formatters.terminal256 import Terminal256Formatter, TerminalTrueColorFormatter
+from pygments.filters import get_all_filters, find_filter_class
+from pygments.styles import get_all_styles, get_style_by_name
+
+
+def _parse_options(o_strs):
+    opts = {}
+    if not o_strs:
+        return opts
+    for o_str in o_strs:
+        if not o_str.strip():
+            continue
+        o_args = o_str.split(',')
+        for o_arg in o_args:
+            o_arg = o_arg.strip()
+            try:
+                o_key, o_val = o_arg.split('=', 1)
+                o_key = o_key.strip()
+                o_val = o_val.strip()
+            except ValueError:
+                opts[o_arg] = True
+            else:
+                opts[o_key] = o_val
+    return opts
+
+
+def _parse_filters(f_strs):
+    filters = []
+    if not f_strs:
+        return filters
+    for f_str in f_strs:
+        if ':' in f_str:
+            fname, fopts = f_str.split(':', 1)
+            filters.append((fname, _parse_options([fopts])))
+        else:
+            filters.append((f_str, {}))
+    return filters
+
+
+def _print_help(what, name):
+    try:
+        if what == 'lexer':
+            cls = get_lexer_by_name(name)
+            print(f"Help on the {cls.name} lexer:")
+            print(dedent(cls.__doc__))
+        elif what == 'formatter':
+            cls = find_formatter_class(name)
+            print(f"Help on the {cls.name} formatter:")
+            print(dedent(cls.__doc__))
+        elif what == 'filter':
+            cls = find_filter_class(name)
+            print(f"Help on the {name} filter:")
+            print(dedent(cls.__doc__))
+        return 0
+    except (AttributeError, ValueError):
+        print(f"{what} not found!", file=sys.stderr)
+        return 1
+
+
+def _print_list(what):
+    if what == 'lexer':
+        print()
+        print("Lexers:")
+        print("~~~~~~~")
+
+        info = []
+        for fullname, names, exts, _ in get_all_lexers():
+            tup = (', '.join(names)+':', fullname,
+                   exts and '(filenames ' + ', '.join(exts) + ')' or '')
+            info.append(tup)
+        info.sort()
+        for i in info:
+            print(('* {}\n    {} {}').format(*i))
+
+    elif what == 'formatter':
+        print()
+        print("Formatters:")
+        print("~~~~~~~~~~~")
+
+        info = []
+        for cls in get_all_formatters():
+            doc = docstring_headline(cls)
+            tup = (', '.join(cls.aliases) + ':', doc, cls.filenames and
+                   '(filenames ' + ', '.join(cls.filenames) + ')' or '')
+            info.append(tup)
+        info.sort()
+        for i in info:
+            print(('* {}\n    {} {}').format(*i))
+
+    elif what == 'filter':
+        print()
+        print("Filters:")
+        print("~~~~~~~~")
+
+        for name in get_all_filters():
+            cls = find_filter_class(name)
+            print("* " + name + ':')
+            print(f"    {docstring_headline(cls)}")
+
+    elif what == 'style':
+        print()
+        print("Styles:")
+        print("~~~~~~~")
+
+        for name in get_all_styles():
+            cls = get_style_by_name(name)
+            print("* " + name + ':')
+            print(f"    {docstring_headline(cls)}")
+
+
+def _print_list_as_json(requested_items):
+    import json
+    result = {}
+    if 'lexer' in requested_items:
+        info = {}
+        for fullname, names, filenames, mimetypes in get_all_lexers():
+            info[fullname] = {
+                'aliases': names,
+                'filenames': filenames,
+                'mimetypes': mimetypes
+            }
+        result['lexers'] = info
+
+    if 'formatter' in requested_items:
+        info = {}
+        for cls in get_all_formatters():
+            doc = docstring_headline(cls)
+            info[cls.name] = {
+                'aliases': cls.aliases,
+                'filenames': cls.filenames,
+                'doc': doc
+            }
+        result['formatters'] = info
+
+    if 'filter' in requested_items:
+        info = {}
+        for name in get_all_filters():
+            cls = find_filter_class(name)
+            info[name] = {
+                'doc': docstring_headline(cls)
+            }
+        result['filters'] = info
+
+    if 'style' in requested_items:
+        info = {}
+        for name in get_all_styles():
+            cls = get_style_by_name(name)
+            info[name] = {
+                'doc': docstring_headline(cls)
+            }
+        result['styles'] = info
+
+    json.dump(result, sys.stdout)
+
+def main_inner(parser, argns):
+    if argns.help:
+        parser.print_help()
+        return 0
+
+    if argns.V:
+        print(f'Pygments version {__version__}, (c) 2006-2024 by Georg Brandl, Matthäus '
+              'Chajdas and contributors.')
+        return 0
+
+    def is_only_option(opt):
+        return not any(v for (k, v) in vars(argns).items() if k != opt)
+
+    # handle ``pygmentize -L``
+    if argns.L is not None:
+        arg_set = set()
+        for k, v in vars(argns).items():
+            if v:
+                arg_set.add(k)
+
+        arg_set.discard('L')
+        arg_set.discard('json')
+
+        if arg_set:
+            parser.print_help(sys.stderr)
+            return 2
+
+        # print version
+        if not argns.json:
+            main(['', '-V'])
+        allowed_types = {'lexer', 'formatter', 'filter', 'style'}
+        largs = [arg.rstrip('s') for arg in argns.L]
+        if any(arg not in allowed_types for arg in largs):
+            parser.print_help(sys.stderr)
+            return 0
+        if not largs:
+            largs = allowed_types
+        if not argns.json:
+            for arg in largs:
+                _print_list(arg)
+        else:
+            _print_list_as_json(largs)
+        return 0
+
+    # handle ``pygmentize -H``
+    if argns.H:
+        if not is_only_option('H'):
+            parser.print_help(sys.stderr)
+            return 2
+        what, name = argns.H
+        if what not in ('lexer', 'formatter', 'filter'):
+            parser.print_help(sys.stderr)
+            return 2
+        return _print_help(what, name)
+
+    # parse -O options
+    parsed_opts = _parse_options(argns.O or [])
+
+    # parse -P options
+    for p_opt in argns.P or []:
+        try:
+            name, value = p_opt.split('=', 1)
+        except ValueError:
+            parsed_opts[p_opt] = True
+        else:
+            parsed_opts[name] = value
+
+    # encodings
+    inencoding = parsed_opts.get('inencoding', parsed_opts.get('encoding'))
+    outencoding = parsed_opts.get('outencoding', parsed_opts.get('encoding'))
+
+    # handle ``pygmentize -N``
+    if argns.N:
+        lexer = find_lexer_class_for_filename(argns.N)
+        if lexer is None:
+            lexer = TextLexer
+
+        print(lexer.aliases[0])
+        return 0
+
+    # handle ``pygmentize -C``
+    if argns.C:
+        inp = sys.stdin.buffer.read()
+        try:
+            lexer = guess_lexer(inp, inencoding=inencoding)
+        except ClassNotFound:
+            lexer = TextLexer
+
+        print(lexer.aliases[0])
+        return 0
+
+    # handle ``pygmentize -S``
+    S_opt = argns.S
+    a_opt = argns.a
+    if S_opt is not None:
+        f_opt = argns.f
+        if not f_opt:
+            parser.print_help(sys.stderr)
+            return 2
+        if argns.l or argns.INPUTFILE:
+            parser.print_help(sys.stderr)
+            return 2
+
+        try:
+            parsed_opts['style'] = S_opt
+            fmter = get_formatter_by_name(f_opt, **parsed_opts)
+        except ClassNotFound as err:
+            print(err, file=sys.stderr)
+            return 1
+
+        print(fmter.get_style_defs(a_opt or ''))
+        return 0
+
+    # if no -S is given, -a is not allowed
+    if argns.a is not None:
+        parser.print_help(sys.stderr)
+        return 2
+
+    # parse -F options
+    F_opts = _parse_filters(argns.F or [])
+
+    # -x: allow custom (eXternal) lexers and formatters
+    allow_custom_lexer_formatter = bool(argns.x)
+
+    # select lexer
+    lexer = None
+
+    # given by name?
+    lexername = argns.l
+    if lexername:
+        # custom lexer, located relative to user's cwd
+        if allow_custom_lexer_formatter and '.py' in lexername:
+            try:
+                filename = None
+                name = None
+                if ':' in lexername:
+                    filename, name = lexername.rsplit(':', 1)
+
+                    if '.py' in name:
+                        # This can happen on Windows: If the lexername is
+                        # C:\lexer.py -- return to normal load path in that case
+                        name = None
+
+                if filename and name:
+                    lexer = load_lexer_from_file(filename, name,
+                                                 **parsed_opts)
+                else:
+                    lexer = load_lexer_from_file(lexername, **parsed_opts)
+            except ClassNotFound as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+        else:
+            try:
+                lexer = get_lexer_by_name(lexername, **parsed_opts)
+            except (OptionError, ClassNotFound) as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+
+    # read input code
+    code = None
+
+    if argns.INPUTFILE:
+        if argns.s:
+            print('Error: -s option not usable when input file specified',
+                  file=sys.stderr)
+            return 2
+
+        infn = argns.INPUTFILE
+        try:
+            with open(infn, 'rb') as infp:
+                code = infp.read()
+        except Exception as err:
+            print('Error: cannot read infile:', err, file=sys.stderr)
+            return 1
+        if not inencoding:
+            code, inencoding = guess_decode(code)
+
+        # do we have to guess the lexer?
+        if not lexer:
+            try:
+                lexer = get_lexer_for_filename(infn, code, **parsed_opts)
+            except ClassNotFound as err:
+                if argns.g:
+                    try:
+                        lexer = guess_lexer(code, **parsed_opts)
+                    except ClassNotFound:
+                        lexer = TextLexer(**parsed_opts)
+                else:
+                    print('Error:', err, file=sys.stderr)
+                    return 1
+            except OptionError as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+
+    elif not argns.s:  # treat stdin as full file (-s support is later)
+        # read code from terminal, always in binary mode since we want to
+        # decode ourselves and be tolerant with it
+        code = sys.stdin.buffer.read()  # use .buffer to get a binary stream
+        if not inencoding:
+            code, inencoding = guess_decode_from_terminal(code, sys.stdin)
+            # else the lexer will do the decoding
+        if not lexer:
+            try:
+                lexer = guess_lexer(code, **parsed_opts)
+            except ClassNotFound:
+                lexer = TextLexer(**parsed_opts)
+
+    else:  # -s option needs a lexer with -l
+        if not lexer:
+            print('Error: when using -s a lexer has to be selected with -l',
+                  file=sys.stderr)
+            return 2
+
+    # process filters
+    for fname, fopts in F_opts:
+        try:
+            lexer.add_filter(fname, **fopts)
+        except ClassNotFound as err:
+            print('Error:', err, file=sys.stderr)
+            return 1
+
+    # select formatter
+    outfn = argns.o
+    fmter = argns.f
+    if fmter:
+        # custom formatter, located relative to user's cwd
+        if allow_custom_lexer_formatter and '.py' in fmter:
+            try:
+                filename = None
+                name = None
+                if ':' in fmter:
+                    # Same logic as above for custom lexer
+                    filename, name = fmter.rsplit(':', 1)
+
+                    if '.py' in name:
+                        name = None
+
+                if filename and name:
+                    fmter = load_formatter_from_file(filename, name,
+                                                     **parsed_opts)
+                else:
+                    fmter = load_formatter_from_file(fmter, **parsed_opts)
+            except ClassNotFound as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+        else:
+            try:
+                fmter = get_formatter_by_name(fmter, **parsed_opts)
+            except (OptionError, ClassNotFound) as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+
+    if outfn:
+        if not fmter:
+            try:
+                fmter = get_formatter_for_filename(outfn, **parsed_opts)
+            except (OptionError, ClassNotFound) as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+        try:
+            outfile = open(outfn, 'wb')
+        except Exception as err:
+            print('Error: cannot open outfile:', err, file=sys.stderr)
+            return 1
+    else:
+        if not fmter:
+            if os.environ.get('COLORTERM','') in ('truecolor', '24bit'):
+                fmter = TerminalTrueColorFormatter(**parsed_opts)
+            elif '256' in os.environ.get('TERM', ''):
+                fmter = Terminal256Formatter(**parsed_opts)
+            else:
+                fmter = TerminalFormatter(**parsed_opts)
+        outfile = sys.stdout.buffer
+
+    # determine output encoding if not explicitly selected
+    if not outencoding:
+        if outfn:
+            # output file? use lexer encoding for now (can still be None)
+            fmter.encoding = inencoding
+        else:
+            # else use terminal encoding
+            fmter.encoding = terminal_encoding(sys.stdout)
+
+    # provide coloring under Windows, if possible
+    if not outfn and sys.platform in ('win32', 'cygwin') and \
+       fmter.name in ('Terminal', 'Terminal256'):  # pragma: no cover
+        # unfortunately colorama doesn't support binary streams on Py3
+        outfile = UnclosingTextIOWrapper(outfile, encoding=fmter.encoding)
+        fmter.encoding = None
+        try:
+            import colorama.initialise
+        except ImportError:
+            pass
+        else:
+            outfile = colorama.initialise.wrap_stream(
+                outfile, convert=None, strip=None, autoreset=False, wrap=True)
+
+    # When using the LaTeX formatter and the option `escapeinside` is
+    # specified, we need a special lexer which collects escaped text
+    # before running the chosen language lexer.
+    escapeinside = parsed_opts.get('escapeinside', '')
+    if len(escapeinside) == 2 and isinstance(fmter, LatexFormatter):
+        left = escapeinside[0]
+        right = escapeinside[1]
+        lexer = LatexEmbeddedLexer(left, right, lexer)
+
+    # ... and do it!
+    if not argns.s:
+        # process whole input as per normal...
+        try:
+            highlight(code, lexer, fmter, outfile)
+        finally:
+            if outfn:
+                outfile.close()
+        return 0
+    else:
+        # line by line processing of stdin (eg: for 'tail -f')...
+        try:
+            while 1:
+                line = sys.stdin.buffer.readline()
+                if not line:
+                    break
+                if not inencoding:
+                    line = guess_decode_from_terminal(line, sys.stdin)[0]
+                highlight(line, lexer, fmter, outfile)
+                if hasattr(outfile, 'flush'):
+                    outfile.flush()
+            return 0
+        except KeyboardInterrupt:  # pragma: no cover
+            return 0
+        finally:
+            if outfn:
+                outfile.close()
+
+
+class HelpFormatter(argparse.HelpFormatter):
+    def __init__(self, prog, indent_increment=2, max_help_position=16, width=None):
+        if width is None:
+            try:
+                width = shutil.get_terminal_size().columns - 2
+            except Exception:
+                pass
+        argparse.HelpFormatter.__init__(self, prog, indent_increment,
+                                        max_help_position, width)
+
+
+def main(args=sys.argv):
+    """
+    Main command line entry point.
+    """
+    desc = "Highlight an input file and write the result to an output file."
+    parser = argparse.ArgumentParser(description=desc, add_help=False,
+                                     formatter_class=HelpFormatter)
+
+    operation = parser.add_argument_group('Main operation')
+    lexersel = operation.add_mutually_exclusive_group()
+    lexersel.add_argument(
+        '-l', metavar='LEXER',
+        help='Specify the lexer to use.  (Query names with -L.)  If not '
+        'given and -g is not present, the lexer is guessed from the filename.')
+    lexersel.add_argument(
+        '-g', action='store_true',
+        help='Guess the lexer from the file contents, or pass through '
+        'as plain text if nothing can be guessed.')
+    operation.add_argument(
+        '-F', metavar='FILTER[:options]', action='append',
+        help='Add a filter to the token stream.  (Query names with -L.) '
+        'Filter options are given after a colon if necessary.')
+    operation.add_argument(
+        '-f', metavar='FORMATTER',
+        help='Specify the formatter to use.  (Query names with -L.) '
+        'If not given, the formatter is guessed from the output filename, '
+        'and defaults to the terminal formatter if the output is to the '
+        'terminal or an unknown file extension.')
+    operation.add_argument(
+        '-O', metavar='OPTION=value[,OPTION=value,...]', action='append',
+        help='Give options to the lexer and formatter as a comma-separated '
+        'list of key-value pairs. '
+        'Example: `-O bg=light,python=cool`.')
+    operation.add_argument(
+        '-P', metavar='OPTION=value', action='append',
+        help='Give a single option to the lexer and formatter - with this '
+        'you can pass options whose value contains commas and equal signs. '
+        'Example: `-P "heading=Pygments, the Python highlighter"`.')
+    operation.add_argument(
+        '-o', metavar='OUTPUTFILE',
+        help='Where to write the output.  Defaults to standard output.')
+
+    operation.add_argument(
+        'INPUTFILE', nargs='?',
+        help='Where to read the input.  Defaults to standard input.')
+
+    flags = parser.add_argument_group('Operation flags')
+    flags.add_argument(
+        '-v', action='store_true',
+        help='Print a detailed traceback on unhandled exceptions, which '
+        'is useful for debugging and bug reports.')
+    flags.add_argument(
+        '-s', action='store_true',
+        help='Process lines one at a time until EOF, rather than waiting to '
+        'process the entire file.  This only works for stdin, only for lexers '
+        'with no line-spanning constructs, and is intended for streaming '
+        'input such as you get from `tail -f`. '
+        'Example usage: `tail -f sql.log | pygmentize -s -l sql`.')
+    flags.add_argument(
+        '-x', action='store_true',
+        help='Allow custom lexers and formatters to be loaded from a .py file '
+        'relative to the current working directory. For example, '
+        '`-l ./customlexer.py -x`. By default, this option expects a file '
+        'with a class named CustomLexer or CustomFormatter; you can also '
+        'specify your own class name with a colon (`-l ./lexer.py:MyLexer`). '
+        'Users should be very careful not to use this option with untrusted '
+        'files, because it will import and run them.')
+    flags.add_argument('--json', help='Output as JSON. This can '
+        'be only used in conjunction with -L.',
+        default=False,
+        action='store_true')
+
+    special_modes_group = parser.add_argument_group(
+        'Special modes - do not do any highlighting')
+    special_modes = special_modes_group.add_mutually_exclusive_group()
+    special_modes.add_argument(
+        '-S', metavar='STYLE -f formatter',
+        help='Print style definitions for STYLE for a formatter '
+        'given with -f. The argument given by -a is formatter '
+        'dependent.')
+    special_modes.add_argument(
+        '-L', nargs='*', metavar='WHAT',
+        help='List lexers, formatters, styles or filters -- '
+        'give additional arguments for the thing(s) you want to list '
+        '(e.g. "styles"), or omit them to list everything.')
+    special_modes.add_argument(
+        '-N', metavar='FILENAME',
+        help='Guess and print out a lexer name based solely on the given '
+        'filename. Does not take input or highlight anything. If no specific '
+        'lexer can be determined, "text" is printed.')
+    special_modes.add_argument(
+        '-C', action='store_true',
+        help='Like -N, but print out a lexer name based solely on '
+        'a given content from standard input.')
+    special_modes.add_argument(
+        '-H', action='store', nargs=2, metavar=('NAME', 'TYPE'),
+        help='Print detailed help for the object  of type , '
+        'where  is one of "lexer", "formatter" or "filter".')
+    special_modes.add_argument(
+        '-V', action='store_true',
+        help='Print the package version.')
+    special_modes.add_argument(
+        '-h', '--help', action='store_true',
+        help='Print this help.')
+    special_modes_group.add_argument(
+        '-a', metavar='ARG',
+        help='Formatter-specific additional argument for the -S (print '
+        'style sheet) mode.')
+
+    argns = parser.parse_args(args[1:])
+
+    try:
+        return main_inner(parser, argns)
+    except BrokenPipeError:
+        # someone closed our stdout, e.g. by quitting a pager.
+        return 0
+    except Exception:
+        if argns.v:
+            print(file=sys.stderr)
+            print('*' * 65, file=sys.stderr)
+            print('An unhandled exception occurred while highlighting.',
+                  file=sys.stderr)
+            print('Please report the whole traceback to the issue tracker at',
+                  file=sys.stderr)
+            print('.',
+                  file=sys.stderr)
+            print('*' * 65, file=sys.stderr)
+            print(file=sys.stderr)
+            raise
+        import traceback
+        info = traceback.format_exception(*sys.exc_info())
+        msg = info[-1].strip()
+        if len(info) >= 3:
+            # extract relevant file and position info
+            msg += '\n   (f{})'.format(info[-2].split('\n')[0].strip()[1:])
+        print(file=sys.stderr)
+        print('*** Error while highlighting:', file=sys.stderr)
+        print(msg, file=sys.stderr)
+        print('*** If this is a bug you want to report, please rerun with -v.',
+              file=sys.stderr)
+        return 1
diff --git a/env/lib/python3.12/site-packages/pygments/console.py b/env/lib/python3.12/site-packages/pygments/console.py
new file mode 100644
index 0000000..ee1ac27
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/console.py
@@ -0,0 +1,70 @@
+"""
+    pygments.console
+    ~~~~~~~~~~~~~~~~
+
+    Format colored console output.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+esc = "\x1b["
+
+codes = {}
+codes[""] = ""
+codes["reset"] = esc + "39;49;00m"
+
+codes["bold"] = esc + "01m"
+codes["faint"] = esc + "02m"
+codes["standout"] = esc + "03m"
+codes["underline"] = esc + "04m"
+codes["blink"] = esc + "05m"
+codes["overline"] = esc + "06m"
+
+dark_colors = ["black", "red", "green", "yellow", "blue",
+               "magenta", "cyan", "gray"]
+light_colors = ["brightblack", "brightred", "brightgreen", "brightyellow", "brightblue",
+                "brightmagenta", "brightcyan", "white"]
+
+x = 30
+for dark, light in zip(dark_colors, light_colors):
+    codes[dark] = esc + "%im" % x
+    codes[light] = esc + "%im" % (60 + x)
+    x += 1
+
+del dark, light, x
+
+codes["white"] = codes["bold"]
+
+
+def reset_color():
+    return codes["reset"]
+
+
+def colorize(color_key, text):
+    return codes[color_key] + text + codes["reset"]
+
+
+def ansiformat(attr, text):
+    """
+    Format ``text`` with a color and/or some attributes::
+
+        color       normal color
+        *color*     bold color
+        _color_     underlined color
+        +color+     blinking color
+    """
+    result = []
+    if attr[:1] == attr[-1:] == '+':
+        result.append(codes['blink'])
+        attr = attr[1:-1]
+    if attr[:1] == attr[-1:] == '*':
+        result.append(codes['bold'])
+        attr = attr[1:-1]
+    if attr[:1] == attr[-1:] == '_':
+        result.append(codes['underline'])
+        attr = attr[1:-1]
+    result.append(codes[attr])
+    result.append(text)
+    result.append(codes['reset'])
+    return ''.join(result)
diff --git a/env/lib/python3.12/site-packages/pygments/filter.py b/env/lib/python3.12/site-packages/pygments/filter.py
new file mode 100644
index 0000000..5efff43
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/filter.py
@@ -0,0 +1,70 @@
+"""
+    pygments.filter
+    ~~~~~~~~~~~~~~~
+
+    Module that implements the default filter.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+
+def apply_filters(stream, filters, lexer=None):
+    """
+    Use this method to apply an iterable of filters to
+    a stream. If lexer is given it's forwarded to the
+    filter, otherwise the filter receives `None`.
+    """
+    def _apply(filter_, stream):
+        yield from filter_.filter(lexer, stream)
+    for filter_ in filters:
+        stream = _apply(filter_, stream)
+    return stream
+
+
+def simplefilter(f):
+    """
+    Decorator that converts a function into a filter::
+
+        @simplefilter
+        def lowercase(self, lexer, stream, options):
+            for ttype, value in stream:
+                yield ttype, value.lower()
+    """
+    return type(f.__name__, (FunctionFilter,), {
+        '__module__': getattr(f, '__module__'),
+        '__doc__': f.__doc__,
+        'function': f,
+    })
+
+
+class Filter:
+    """
+    Default filter. Subclass this class or use the `simplefilter`
+    decorator to create own filters.
+    """
+
+    def __init__(self, **options):
+        self.options = options
+
+    def filter(self, lexer, stream):
+        raise NotImplementedError()
+
+
+class FunctionFilter(Filter):
+    """
+    Abstract class used by `simplefilter` to create simple
+    function filters on the fly. The `simplefilter` decorator
+    automatically creates subclasses of this class for
+    functions passed to it.
+    """
+    function = None
+
+    def __init__(self, **options):
+        if not hasattr(self, 'function'):
+            raise TypeError(f'{self.__class__.__name__!r} used without bound function')
+        Filter.__init__(self, **options)
+
+    def filter(self, lexer, stream):
+        # pylint: disable=not-callable
+        yield from self.function(lexer, stream, self.options)
diff --git a/env/lib/python3.12/site-packages/pygments/filters/__init__.py b/env/lib/python3.12/site-packages/pygments/filters/__init__.py
new file mode 100644
index 0000000..2fed761
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/filters/__init__.py
@@ -0,0 +1,940 @@
+"""
+    pygments.filters
+    ~~~~~~~~~~~~~~~~
+
+    Module containing filter lookup functions and default
+    filters.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.token import String, Comment, Keyword, Name, Error, Whitespace, \
+    string_to_tokentype
+from pygments.filter import Filter
+from pygments.util import get_list_opt, get_int_opt, get_bool_opt, \
+    get_choice_opt, ClassNotFound, OptionError
+from pygments.plugin import find_plugin_filters
+
+
+def find_filter_class(filtername):
+    """Lookup a filter by name. Return None if not found."""
+    if filtername in FILTERS:
+        return FILTERS[filtername]
+    for name, cls in find_plugin_filters():
+        if name == filtername:
+            return cls
+    return None
+
+
+def get_filter_by_name(filtername, **options):
+    """Return an instantiated filter.
+
+    Options are passed to the filter initializer if wanted.
+    Raise a ClassNotFound if not found.
+    """
+    cls = find_filter_class(filtername)
+    if cls:
+        return cls(**options)
+    else:
+        raise ClassNotFound(f'filter {filtername!r} not found')
+
+
+def get_all_filters():
+    """Return a generator of all filter names."""
+    yield from FILTERS
+    for name, _ in find_plugin_filters():
+        yield name
+
+
+def _replace_special(ttype, value, regex, specialttype,
+                     replacefunc=lambda x: x):
+    last = 0
+    for match in regex.finditer(value):
+        start, end = match.start(), match.end()
+        if start != last:
+            yield ttype, value[last:start]
+        yield specialttype, replacefunc(value[start:end])
+        last = end
+    if last != len(value):
+        yield ttype, value[last:]
+
+
+class CodeTagFilter(Filter):
+    """Highlight special code tags in comments and docstrings.
+
+    Options accepted:
+
+    `codetags` : list of strings
+       A list of strings that are flagged as code tags.  The default is to
+       highlight ``XXX``, ``TODO``, ``FIXME``, ``BUG`` and ``NOTE``.
+
+    .. versionchanged:: 2.13
+       Now recognizes ``FIXME`` by default.
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        tags = get_list_opt(options, 'codetags',
+                            ['XXX', 'TODO', 'FIXME', 'BUG', 'NOTE'])
+        self.tag_re = re.compile(r'\b({})\b'.format('|'.join([
+            re.escape(tag) for tag in tags if tag
+        ])))
+
+    def filter(self, lexer, stream):
+        regex = self.tag_re
+        for ttype, value in stream:
+            if ttype in String.Doc or \
+               ttype in Comment and \
+               ttype not in Comment.Preproc:
+                yield from _replace_special(ttype, value, regex, Comment.Special)
+            else:
+                yield ttype, value
+
+
+class SymbolFilter(Filter):
+    """Convert mathematical symbols such as \\ in Isabelle
+    or \\longrightarrow in LaTeX into Unicode characters.
+
+    This is mostly useful for HTML or console output when you want to
+    approximate the source rendering you'd see in an IDE.
+
+    Options accepted:
+
+    `lang` : string
+       The symbol language. Must be one of ``'isabelle'`` or
+       ``'latex'``.  The default is ``'isabelle'``.
+    """
+
+    latex_symbols = {
+        '\\alpha'                : '\U000003b1',
+        '\\beta'                 : '\U000003b2',
+        '\\gamma'                : '\U000003b3',
+        '\\delta'                : '\U000003b4',
+        '\\varepsilon'           : '\U000003b5',
+        '\\zeta'                 : '\U000003b6',
+        '\\eta'                  : '\U000003b7',
+        '\\vartheta'             : '\U000003b8',
+        '\\iota'                 : '\U000003b9',
+        '\\kappa'                : '\U000003ba',
+        '\\lambda'               : '\U000003bb',
+        '\\mu'                   : '\U000003bc',
+        '\\nu'                   : '\U000003bd',
+        '\\xi'                   : '\U000003be',
+        '\\pi'                   : '\U000003c0',
+        '\\varrho'               : '\U000003c1',
+        '\\sigma'                : '\U000003c3',
+        '\\tau'                  : '\U000003c4',
+        '\\upsilon'              : '\U000003c5',
+        '\\varphi'               : '\U000003c6',
+        '\\chi'                  : '\U000003c7',
+        '\\psi'                  : '\U000003c8',
+        '\\omega'                : '\U000003c9',
+        '\\Gamma'                : '\U00000393',
+        '\\Delta'                : '\U00000394',
+        '\\Theta'                : '\U00000398',
+        '\\Lambda'               : '\U0000039b',
+        '\\Xi'                   : '\U0000039e',
+        '\\Pi'                   : '\U000003a0',
+        '\\Sigma'                : '\U000003a3',
+        '\\Upsilon'              : '\U000003a5',
+        '\\Phi'                  : '\U000003a6',
+        '\\Psi'                  : '\U000003a8',
+        '\\Omega'                : '\U000003a9',
+        '\\leftarrow'            : '\U00002190',
+        '\\longleftarrow'        : '\U000027f5',
+        '\\rightarrow'           : '\U00002192',
+        '\\longrightarrow'       : '\U000027f6',
+        '\\Leftarrow'            : '\U000021d0',
+        '\\Longleftarrow'        : '\U000027f8',
+        '\\Rightarrow'           : '\U000021d2',
+        '\\Longrightarrow'       : '\U000027f9',
+        '\\leftrightarrow'       : '\U00002194',
+        '\\longleftrightarrow'   : '\U000027f7',
+        '\\Leftrightarrow'       : '\U000021d4',
+        '\\Longleftrightarrow'   : '\U000027fa',
+        '\\mapsto'               : '\U000021a6',
+        '\\longmapsto'           : '\U000027fc',
+        '\\relbar'               : '\U00002500',
+        '\\Relbar'               : '\U00002550',
+        '\\hookleftarrow'        : '\U000021a9',
+        '\\hookrightarrow'       : '\U000021aa',
+        '\\leftharpoondown'      : '\U000021bd',
+        '\\rightharpoondown'     : '\U000021c1',
+        '\\leftharpoonup'        : '\U000021bc',
+        '\\rightharpoonup'       : '\U000021c0',
+        '\\rightleftharpoons'    : '\U000021cc',
+        '\\leadsto'              : '\U0000219d',
+        '\\downharpoonleft'      : '\U000021c3',
+        '\\downharpoonright'     : '\U000021c2',
+        '\\upharpoonleft'        : '\U000021bf',
+        '\\upharpoonright'       : '\U000021be',
+        '\\restriction'          : '\U000021be',
+        '\\uparrow'              : '\U00002191',
+        '\\Uparrow'              : '\U000021d1',
+        '\\downarrow'            : '\U00002193',
+        '\\Downarrow'            : '\U000021d3',
+        '\\updownarrow'          : '\U00002195',
+        '\\Updownarrow'          : '\U000021d5',
+        '\\langle'               : '\U000027e8',
+        '\\rangle'               : '\U000027e9',
+        '\\lceil'                : '\U00002308',
+        '\\rceil'                : '\U00002309',
+        '\\lfloor'               : '\U0000230a',
+        '\\rfloor'               : '\U0000230b',
+        '\\flqq'                 : '\U000000ab',
+        '\\frqq'                 : '\U000000bb',
+        '\\bot'                  : '\U000022a5',
+        '\\top'                  : '\U000022a4',
+        '\\wedge'                : '\U00002227',
+        '\\bigwedge'             : '\U000022c0',
+        '\\vee'                  : '\U00002228',
+        '\\bigvee'               : '\U000022c1',
+        '\\forall'               : '\U00002200',
+        '\\exists'               : '\U00002203',
+        '\\nexists'              : '\U00002204',
+        '\\neg'                  : '\U000000ac',
+        '\\Box'                  : '\U000025a1',
+        '\\Diamond'              : '\U000025c7',
+        '\\vdash'                : '\U000022a2',
+        '\\models'               : '\U000022a8',
+        '\\dashv'                : '\U000022a3',
+        '\\surd'                 : '\U0000221a',
+        '\\le'                   : '\U00002264',
+        '\\ge'                   : '\U00002265',
+        '\\ll'                   : '\U0000226a',
+        '\\gg'                   : '\U0000226b',
+        '\\lesssim'              : '\U00002272',
+        '\\gtrsim'               : '\U00002273',
+        '\\lessapprox'           : '\U00002a85',
+        '\\gtrapprox'            : '\U00002a86',
+        '\\in'                   : '\U00002208',
+        '\\notin'                : '\U00002209',
+        '\\subset'               : '\U00002282',
+        '\\supset'               : '\U00002283',
+        '\\subseteq'             : '\U00002286',
+        '\\supseteq'             : '\U00002287',
+        '\\sqsubset'             : '\U0000228f',
+        '\\sqsupset'             : '\U00002290',
+        '\\sqsubseteq'           : '\U00002291',
+        '\\sqsupseteq'           : '\U00002292',
+        '\\cap'                  : '\U00002229',
+        '\\bigcap'               : '\U000022c2',
+        '\\cup'                  : '\U0000222a',
+        '\\bigcup'               : '\U000022c3',
+        '\\sqcup'                : '\U00002294',
+        '\\bigsqcup'             : '\U00002a06',
+        '\\sqcap'                : '\U00002293',
+        '\\Bigsqcap'             : '\U00002a05',
+        '\\setminus'             : '\U00002216',
+        '\\propto'               : '\U0000221d',
+        '\\uplus'                : '\U0000228e',
+        '\\bigplus'              : '\U00002a04',
+        '\\sim'                  : '\U0000223c',
+        '\\doteq'                : '\U00002250',
+        '\\simeq'                : '\U00002243',
+        '\\approx'               : '\U00002248',
+        '\\asymp'                : '\U0000224d',
+        '\\cong'                 : '\U00002245',
+        '\\equiv'                : '\U00002261',
+        '\\Join'                 : '\U000022c8',
+        '\\bowtie'               : '\U00002a1d',
+        '\\prec'                 : '\U0000227a',
+        '\\succ'                 : '\U0000227b',
+        '\\preceq'               : '\U0000227c',
+        '\\succeq'               : '\U0000227d',
+        '\\parallel'             : '\U00002225',
+        '\\mid'                  : '\U000000a6',
+        '\\pm'                   : '\U000000b1',
+        '\\mp'                   : '\U00002213',
+        '\\times'                : '\U000000d7',
+        '\\div'                  : '\U000000f7',
+        '\\cdot'                 : '\U000022c5',
+        '\\star'                 : '\U000022c6',
+        '\\circ'                 : '\U00002218',
+        '\\dagger'               : '\U00002020',
+        '\\ddagger'              : '\U00002021',
+        '\\lhd'                  : '\U000022b2',
+        '\\rhd'                  : '\U000022b3',
+        '\\unlhd'                : '\U000022b4',
+        '\\unrhd'                : '\U000022b5',
+        '\\triangleleft'         : '\U000025c3',
+        '\\triangleright'        : '\U000025b9',
+        '\\triangle'             : '\U000025b3',
+        '\\triangleq'            : '\U0000225c',
+        '\\oplus'                : '\U00002295',
+        '\\bigoplus'             : '\U00002a01',
+        '\\otimes'               : '\U00002297',
+        '\\bigotimes'            : '\U00002a02',
+        '\\odot'                 : '\U00002299',
+        '\\bigodot'              : '\U00002a00',
+        '\\ominus'               : '\U00002296',
+        '\\oslash'               : '\U00002298',
+        '\\dots'                 : '\U00002026',
+        '\\cdots'                : '\U000022ef',
+        '\\sum'                  : '\U00002211',
+        '\\prod'                 : '\U0000220f',
+        '\\coprod'               : '\U00002210',
+        '\\infty'                : '\U0000221e',
+        '\\int'                  : '\U0000222b',
+        '\\oint'                 : '\U0000222e',
+        '\\clubsuit'             : '\U00002663',
+        '\\diamondsuit'          : '\U00002662',
+        '\\heartsuit'            : '\U00002661',
+        '\\spadesuit'            : '\U00002660',
+        '\\aleph'                : '\U00002135',
+        '\\emptyset'             : '\U00002205',
+        '\\nabla'                : '\U00002207',
+        '\\partial'              : '\U00002202',
+        '\\flat'                 : '\U0000266d',
+        '\\natural'              : '\U0000266e',
+        '\\sharp'                : '\U0000266f',
+        '\\angle'                : '\U00002220',
+        '\\copyright'            : '\U000000a9',
+        '\\textregistered'       : '\U000000ae',
+        '\\textonequarter'       : '\U000000bc',
+        '\\textonehalf'          : '\U000000bd',
+        '\\textthreequarters'    : '\U000000be',
+        '\\textordfeminine'      : '\U000000aa',
+        '\\textordmasculine'     : '\U000000ba',
+        '\\euro'                 : '\U000020ac',
+        '\\pounds'               : '\U000000a3',
+        '\\yen'                  : '\U000000a5',
+        '\\textcent'             : '\U000000a2',
+        '\\textcurrency'         : '\U000000a4',
+        '\\textdegree'           : '\U000000b0',
+    }
+
+    isabelle_symbols = {
+        '\\'                 : '\U0001d7ec',
+        '\\'                  : '\U0001d7ed',
+        '\\'                  : '\U0001d7ee',
+        '\\'                : '\U0001d7ef',
+        '\\'                 : '\U0001d7f0',
+        '\\'                 : '\U0001d7f1',
+        '\\'                  : '\U0001d7f2',
+        '\\'                : '\U0001d7f3',
+        '\\'                : '\U0001d7f4',
+        '\\'                 : '\U0001d7f5',
+        '\\'                    : '\U0001d49c',
+        '\\'                    : '\U0000212c',
+        '\\'                    : '\U0001d49e',
+        '\\'                    : '\U0001d49f',
+        '\\'                    : '\U00002130',
+        '\\'                    : '\U00002131',
+        '\\'                    : '\U0001d4a2',
+        '\\'                    : '\U0000210b',
+        '\\'                    : '\U00002110',
+        '\\'                    : '\U0001d4a5',
+        '\\'                    : '\U0001d4a6',
+        '\\'                    : '\U00002112',
+        '\\'                    : '\U00002133',
+        '\\'                    : '\U0001d4a9',
+        '\\'                    : '\U0001d4aa',
+        '\\
'                    : '\U0001d5c9',
+        '\\'                    : '\U0001d5ca',
+        '\\'                    : '\U0001d5cb',
+        '\\'                    : '\U0001d5cc',
+        '\\'                    : '\U0001d5cd',
+        '\\'                    : '\U0001d5ce',
+        '\\'                    : '\U0001d5cf',
+        '\\'                    : '\U0001d5d0',
+        '\\'                    : '\U0001d5d1',
+        '\\'                    : '\U0001d5d2',
+        '\\'                    : '\U0001d5d3',
+        '\\'                   : '\U0001d504',
+        '\\'                   : '\U0001d505',
+        '\\'                   : '\U0000212d',
+        '\\
'                   : '\U0001d507',
+        '\\'                   : '\U0001d508',
+        '\\'                   : '\U0001d509',
+        '\\'                   : '\U0001d50a',
+        '\\'                   : '\U0000210c',
+        '\\'                   : '\U00002111',
+        '\\'                   : '\U0001d50d',
+        '\\'                   : '\U0001d50e',
+        '\\'                   : '\U0001d50f',
+        '\\'                   : '\U0001d510',
+        '\\'                   : '\U0001d511',
+        '\\'                   : '\U0001d512',
+        '\\'                   : '\U0001d513',
+        '\\'                   : '\U0001d514',
+        '\\'                   : '\U0000211c',
+        '\\'                   : '\U0001d516',
+        '\\'                   : '\U0001d517',
+        '\\'                   : '\U0001d518',
+        '\\'                   : '\U0001d519',
+        '\\'                   : '\U0001d51a',
+        '\\'                   : '\U0001d51b',
+        '\\'                   : '\U0001d51c',
+        '\\'                   : '\U00002128',
+        '\\'                   : '\U0001d51e',
+        '\\'                   : '\U0001d51f',
+        '\\'                   : '\U0001d520',
+        '\\
'                   : '\U0001d521',
+        '\\'                   : '\U0001d522',
+        '\\'                   : '\U0001d523',
+        '\\'                   : '\U0001d524',
+        '\\'                   : '\U0001d525',
+        '\\'                   : '\U0001d526',
+        '\\'                   : '\U0001d527',
+        '\\'                   : '\U0001d528',
+        '\\'                   : '\U0001d529',
+        '\\'                   : '\U0001d52a',
+        '\\'                   : '\U0001d52b',
+        '\\'                   : '\U0001d52c',
+        '\\'                   : '\U0001d52d',
+        '\\'                   : '\U0001d52e',
+        '\\'                   : '\U0001d52f',
+        '\\'                   : '\U0001d530',
+        '\\'                   : '\U0001d531',
+        '\\'                   : '\U0001d532',
+        '\\'                   : '\U0001d533',
+        '\\'                   : '\U0001d534',
+        '\\'                   : '\U0001d535',
+        '\\'                   : '\U0001d536',
+        '\\'                   : '\U0001d537',
+        '\\'                : '\U000003b1',
+        '\\'                 : '\U000003b2',
+        '\\'                : '\U000003b3',
+        '\\'                : '\U000003b4',
+        '\\'              : '\U000003b5',
+        '\\'                 : '\U000003b6',
+        '\\'                  : '\U000003b7',
+        '\\'                : '\U000003b8',
+        '\\'                 : '\U000003b9',
+        '\\'                : '\U000003ba',
+        '\\'               : '\U000003bb',
+        '\\'                   : '\U000003bc',
+        '\\'                   : '\U000003bd',
+        '\\'                   : '\U000003be',
+        '\\'                   : '\U000003c0',
+        '\\'                  : '\U000003c1',
+        '\\'                : '\U000003c3',
+        '\\'                  : '\U000003c4',
+        '\\'              : '\U000003c5',
+        '\\'                  : '\U000003c6',
+        '\\'                  : '\U000003c7',
+        '\\'                  : '\U000003c8',
+        '\\'                : '\U000003c9',
+        '\\'                : '\U00000393',
+        '\\'                : '\U00000394',
+        '\\'                : '\U00000398',
+        '\\'               : '\U0000039b',
+        '\\'                   : '\U0000039e',
+        '\\'                   : '\U000003a0',
+        '\\'                : '\U000003a3',
+        '\\'              : '\U000003a5',
+        '\\'                  : '\U000003a6',
+        '\\'                  : '\U000003a8',
+        '\\'                : '\U000003a9',
+        '\\'                 : '\U0001d539',
+        '\\'              : '\U00002102',
+        '\\'                  : '\U00002115',
+        '\\'                  : '\U0000211a',
+        '\\'                 : '\U0000211d',
+        '\\'                  : '\U00002124',
+        '\\'            : '\U00002190',
+        '\\'        : '\U000027f5',
+        '\\'           : '\U00002192',
+        '\\'       : '\U000027f6',
+        '\\'            : '\U000021d0',
+        '\\'        : '\U000027f8',
+        '\\'           : '\U000021d2',
+        '\\'       : '\U000027f9',
+        '\\'       : '\U00002194',
+        '\\'   : '\U000027f7',
+        '\\'       : '\U000021d4',
+        '\\'   : '\U000027fa',
+        '\\'               : '\U000021a6',
+        '\\'           : '\U000027fc',
+        '\\'             : '\U00002500',
+        '\\'             : '\U00002550',
+        '\\'        : '\U000021a9',
+        '\\'       : '\U000021aa',
+        '\\'      : '\U000021bd',
+        '\\'     : '\U000021c1',
+        '\\'        : '\U000021bc',
+        '\\'       : '\U000021c0',
+        '\\'    : '\U000021cc',
+        '\\'              : '\U0000219d',
+        '\\'      : '\U000021c3',
+        '\\'     : '\U000021c2',
+        '\\'        : '\U000021bf',
+        '\\'       : '\U000021be',
+        '\\'          : '\U000021be',
+        '\\'                : '\U00002237',
+        '\\'                   : '\U00002191',
+        '\\'                   : '\U000021d1',
+        '\\'                 : '\U00002193',
+        '\\'                 : '\U000021d3',
+        '\\'               : '\U00002195',
+        '\\'               : '\U000021d5',
+        '\\'               : '\U000027e8',
+        '\\'               : '\U000027e9',
+        '\\'                : '\U00002308',
+        '\\'                : '\U00002309',
+        '\\'               : '\U0000230a',
+        '\\'               : '\U0000230b',
+        '\\'                : '\U00002987',
+        '\\'                : '\U00002988',
+        '\\'               : '\U000027e6',
+        '\\'               : '\U000027e7',
+        '\\'               : '\U00002983',
+        '\\'               : '\U00002984',
+        '\\'        : '\U000000ab',
+        '\\'       : '\U000000bb',
+        '\\'               : '\U000022a5',
+        '\\'                  : '\U000022a4',
+        '\\'                  : '\U00002227',
+        '\\'                  : '\U000022c0',
+        '\\'                   : '\U00002228',
+        '\\'                   : '\U000022c1',
+        '\\'               : '\U00002200',
+        '\\'               : '\U00002203',
+        '\\'              : '\U00002204',
+        '\\'                  : '\U000000ac',
+        '\\'                  : '\U000025a1',
+        '\\'              : '\U000025c7',
+        '\\'            : '\U000022a2',
+        '\\'            : '\U000022a8',
+        '\\'           : '\U000022a9',
+        '\\'           : '\U000022ab',
+        '\\'            : '\U000022a3',
+        '\\'                 : '\U0000221a',
+        '\\'                   : '\U00002264',
+        '\\'                   : '\U00002265',
+        '\\'                : '\U0000226a',
+        '\\'             : '\U0000226b',
+        '\\'              : '\U00002272',
+        '\\'           : '\U00002273',
+        '\\'           : '\U00002a85',
+        '\\'        : '\U00002a86',
+        '\\'                   : '\U00002208',
+        '\\'                : '\U00002209',
+        '\\'               : '\U00002282',
+        '\\'               : '\U00002283',
+        '\\'             : '\U00002286',
+        '\\'             : '\U00002287',
+        '\\'             : '\U0000228f',
+        '\\'             : '\U00002290',
+        '\\'           : '\U00002291',
+        '\\'           : '\U00002292',
+        '\\'                : '\U00002229',
+        '\\'                : '\U000022c2',
+        '\\'                : '\U0000222a',
+        '\\'                : '\U000022c3',
+        '\\'              : '\U00002294',
+        '\\'              : '\U00002a06',
+        '\\'              : '\U00002293',
+        '\\'              : '\U00002a05',
+        '\\'             : '\U00002216',
+        '\\'               : '\U0000221d',
+        '\\'                : '\U0000228e',
+        '\\'                : '\U00002a04',
+        '\\'                : '\U00002260',
+        '\\'                  : '\U0000223c',
+        '\\'                : '\U00002250',
+        '\\'                : '\U00002243',
+        '\\'               : '\U00002248',
+        '\\'                : '\U0000224d',
+        '\\'                 : '\U00002245',
+        '\\'                : '\U00002323',
+        '\\'                : '\U00002261',
+        '\\'                : '\U00002322',
+        '\\'                 : '\U000022c8',
+        '\\'               : '\U00002a1d',
+        '\\'                 : '\U0000227a',
+        '\\'                 : '\U0000227b',
+        '\\'               : '\U0000227c',
+        '\\'               : '\U0000227d',
+        '\\'             : '\U00002225',
+        '\\'                  : '\U000000a6',
+        '\\'            : '\U000000b1',
+        '\\'            : '\U00002213',
+        '\\'                : '\U000000d7',
+        '\\
'                  : '\U000000f7',
+        '\\'                 : '\U000022c5',
+        '\\'                 : '\U000022c6',
+        '\\'               : '\U00002219',
+        '\\'                 : '\U00002218',
+        '\\'               : '\U00002020',
+        '\\'              : '\U00002021',
+        '\\'                  : '\U000022b2',
+        '\\'                  : '\U000022b3',
+        '\\'                : '\U000022b4',
+        '\\'                : '\U000022b5',
+        '\\'         : '\U000025c3',
+        '\\'        : '\U000025b9',
+        '\\'             : '\U000025b3',
+        '\\'            : '\U0000225c',
+        '\\'                : '\U00002295',
+        '\\'                : '\U00002a01',
+        '\\'               : '\U00002297',
+        '\\'               : '\U00002a02',
+        '\\'                 : '\U00002299',
+        '\\'                 : '\U00002a00',
+        '\\'               : '\U00002296',
+        '\\'               : '\U00002298',
+        '\\'                 : '\U00002026',
+        '\\'                : '\U000022ef',
+        '\\'                  : '\U00002211',
+        '\\'                 : '\U0000220f',
+        '\\'               : '\U00002210',
+        '\\'             : '\U0000221e',
+        '\\'             : '\U0000222b',
+        '\\'            : '\U0000222e',
+        '\\'             : '\U00002663',
+        '\\'          : '\U00002662',
+        '\\'            : '\U00002661',
+        '\\'            : '\U00002660',
+        '\\'                : '\U00002135',
+        '\\'             : '\U00002205',
+        '\\'                : '\U00002207',
+        '\\'              : '\U00002202',
+        '\\'                 : '\U0000266d',
+        '\\'              : '\U0000266e',
+        '\\'                : '\U0000266f',
+        '\\'                : '\U00002220',
+        '\\'            : '\U000000a9',
+        '\\'           : '\U000000ae',
+        '\\'               : '\U000000ad',
+        '\\'              : '\U000000af',
+        '\\'           : '\U000000bc',
+        '\\'              : '\U000000bd',
+        '\\'        : '\U000000be',
+        '\\'          : '\U000000aa',
+        '\\'         : '\U000000ba',
+        '\\
'              : '\U000000a7',
+        '\\'            : '\U000000b6',
+        '\\'           : '\U000000a1',
+        '\\'         : '\U000000bf',
+        '\\'                 : '\U000020ac',
+        '\\'               : '\U000000a3',
+        '\\'                  : '\U000000a5',
+        '\\'                 : '\U000000a2',
+        '\\'             : '\U000000a4',
+        '\\'               : '\U000000b0',
+        '\\'                : '\U00002a3f',
+        '\\'                  : '\U00002127',
+        '\\'              : '\U000025ca',
+        '\\'                   : '\U00002118',
+        '\\'                : '\U00002240',
+        '\\'               : '\U000022c4',
+        '\\'                : '\U000000b4',
+        '\\'                : '\U00000131',
+        '\\'             : '\U000000a8',
+        '\\'              : '\U000000b8',
+        '\\'         : '\U000002dd',
+        '\\'                 : '\U000003f5',
+        '\\'              : '\U000023ce',
+        '\\'                 : '\U00002039',
+        '\\'                : '\U0000203a',
+        '\\'                 : '\U00002302',
+        '\\<^sub>'                 : '\U000021e9',
+        '\\<^sup>'                 : '\U000021e7',
+        '\\<^bold>'                : '\U00002759',
+        '\\<^bsub>'                : '\U000021d8',
+        '\\<^esub>'                : '\U000021d9',
+        '\\<^bsup>'                : '\U000021d7',
+        '\\<^esup>'                : '\U000021d6',
+    }
+
+    lang_map = {'isabelle' : isabelle_symbols, 'latex' : latex_symbols}
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        lang = get_choice_opt(options, 'lang',
+                              ['isabelle', 'latex'], 'isabelle')
+        self.symbols = self.lang_map[lang]
+
+    def filter(self, lexer, stream):
+        for ttype, value in stream:
+            if value in self.symbols:
+                yield ttype, self.symbols[value]
+            else:
+                yield ttype, value
+
+
+class KeywordCaseFilter(Filter):
+    """Convert keywords to lowercase or uppercase or capitalize them, which
+    means first letter uppercase, rest lowercase.
+
+    This can be useful e.g. if you highlight Pascal code and want to adapt the
+    code to your styleguide.
+
+    Options accepted:
+
+    `case` : string
+       The casing to convert keywords to. Must be one of ``'lower'``,
+       ``'upper'`` or ``'capitalize'``.  The default is ``'lower'``.
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        case = get_choice_opt(options, 'case',
+                              ['lower', 'upper', 'capitalize'], 'lower')
+        self.convert = getattr(str, case)
+
+    def filter(self, lexer, stream):
+        for ttype, value in stream:
+            if ttype in Keyword:
+                yield ttype, self.convert(value)
+            else:
+                yield ttype, value
+
+
+class NameHighlightFilter(Filter):
+    """Highlight a normal Name (and Name.*) token with a different token type.
+
+    Example::
+
+        filter = NameHighlightFilter(
+            names=['foo', 'bar', 'baz'],
+            tokentype=Name.Function,
+        )
+
+    This would highlight the names "foo", "bar" and "baz"
+    as functions. `Name.Function` is the default token type.
+
+    Options accepted:
+
+    `names` : list of strings
+      A list of names that should be given the different token type.
+      There is no default.
+    `tokentype` : TokenType or string
+      A token type or a string containing a token type name that is
+      used for highlighting the strings in `names`.  The default is
+      `Name.Function`.
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        self.names = set(get_list_opt(options, 'names', []))
+        tokentype = options.get('tokentype')
+        if tokentype:
+            self.tokentype = string_to_tokentype(tokentype)
+        else:
+            self.tokentype = Name.Function
+
+    def filter(self, lexer, stream):
+        for ttype, value in stream:
+            if ttype in Name and value in self.names:
+                yield self.tokentype, value
+            else:
+                yield ttype, value
+
+
+class ErrorToken(Exception):
+    pass
+
+
+class RaiseOnErrorTokenFilter(Filter):
+    """Raise an exception when the lexer generates an error token.
+
+    Options accepted:
+
+    `excclass` : Exception class
+      The exception class to raise.
+      The default is `pygments.filters.ErrorToken`.
+
+    .. versionadded:: 0.8
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        self.exception = options.get('excclass', ErrorToken)
+        try:
+            # issubclass() will raise TypeError if first argument is not a class
+            if not issubclass(self.exception, Exception):
+                raise TypeError
+        except TypeError:
+            raise OptionError('excclass option is not an exception class')
+
+    def filter(self, lexer, stream):
+        for ttype, value in stream:
+            if ttype is Error:
+                raise self.exception(value)
+            yield ttype, value
+
+
+class VisibleWhitespaceFilter(Filter):
+    """Convert tabs, newlines and/or spaces to visible characters.
+
+    Options accepted:
+
+    `spaces` : string or bool
+      If this is a one-character string, spaces will be replaces by this string.
+      If it is another true value, spaces will be replaced by ``·`` (unicode
+      MIDDLE DOT).  If it is a false value, spaces will not be replaced.  The
+      default is ``False``.
+    `tabs` : string or bool
+      The same as for `spaces`, but the default replacement character is ``»``
+      (unicode RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK).  The default value
+      is ``False``.  Note: this will not work if the `tabsize` option for the
+      lexer is nonzero, as tabs will already have been expanded then.
+    `tabsize` : int
+      If tabs are to be replaced by this filter (see the `tabs` option), this
+      is the total number of characters that a tab should be expanded to.
+      The default is ``8``.
+    `newlines` : string or bool
+      The same as for `spaces`, but the default replacement character is ``¶``
+      (unicode PILCROW SIGN).  The default value is ``False``.
+    `wstokentype` : bool
+      If true, give whitespace the special `Whitespace` token type.  This allows
+      styling the visible whitespace differently (e.g. greyed out), but it can
+      disrupt background colors.  The default is ``True``.
+
+    .. versionadded:: 0.8
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        for name, default in [('spaces',   '·'),
+                              ('tabs',     '»'),
+                              ('newlines', '¶')]:
+            opt = options.get(name, False)
+            if isinstance(opt, str) and len(opt) == 1:
+                setattr(self, name, opt)
+            else:
+                setattr(self, name, (opt and default or ''))
+        tabsize = get_int_opt(options, 'tabsize', 8)
+        if self.tabs:
+            self.tabs += ' ' * (tabsize - 1)
+        if self.newlines:
+            self.newlines += '\n'
+        self.wstt = get_bool_opt(options, 'wstokentype', True)
+
+    def filter(self, lexer, stream):
+        if self.wstt:
+            spaces = self.spaces or ' '
+            tabs = self.tabs or '\t'
+            newlines = self.newlines or '\n'
+            regex = re.compile(r'\s')
+
+            def replacefunc(wschar):
+                if wschar == ' ':
+                    return spaces
+                elif wschar == '\t':
+                    return tabs
+                elif wschar == '\n':
+                    return newlines
+                return wschar
+
+            for ttype, value in stream:
+                yield from _replace_special(ttype, value, regex, Whitespace,
+                                            replacefunc)
+        else:
+            spaces, tabs, newlines = self.spaces, self.tabs, self.newlines
+            # simpler processing
+            for ttype, value in stream:
+                if spaces:
+                    value = value.replace(' ', spaces)
+                if tabs:
+                    value = value.replace('\t', tabs)
+                if newlines:
+                    value = value.replace('\n', newlines)
+                yield ttype, value
+
+
+class GobbleFilter(Filter):
+    """Gobbles source code lines (eats initial characters).
+
+    This filter drops the first ``n`` characters off every line of code.  This
+    may be useful when the source code fed to the lexer is indented by a fixed
+    amount of space that isn't desired in the output.
+
+    Options accepted:
+
+    `n` : int
+       The number of characters to gobble.
+
+    .. versionadded:: 1.2
+    """
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        self.n = get_int_opt(options, 'n', 0)
+
+    def gobble(self, value, left):
+        if left < len(value):
+            return value[left:], 0
+        else:
+            return '', left - len(value)
+
+    def filter(self, lexer, stream):
+        n = self.n
+        left = n  # How many characters left to gobble.
+        for ttype, value in stream:
+            # Remove ``left`` tokens from first line, ``n`` from all others.
+            parts = value.split('\n')
+            (parts[0], left) = self.gobble(parts[0], left)
+            for i in range(1, len(parts)):
+                (parts[i], left) = self.gobble(parts[i], n)
+            value = '\n'.join(parts)
+
+            if value != '':
+                yield ttype, value
+
+
+class TokenMergeFilter(Filter):
+    """Merges consecutive tokens with the same token type in the output
+    stream of a lexer.
+
+    .. versionadded:: 1.2
+    """
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+
+    def filter(self, lexer, stream):
+        current_type = None
+        current_value = None
+        for ttype, value in stream:
+            if ttype is current_type:
+                current_value += value
+            else:
+                if current_type is not None:
+                    yield current_type, current_value
+                current_type = ttype
+                current_value = value
+        if current_type is not None:
+            yield current_type, current_value
+
+
+FILTERS = {
+    'codetagify':     CodeTagFilter,
+    'keywordcase':    KeywordCaseFilter,
+    'highlight':      NameHighlightFilter,
+    'raiseonerror':   RaiseOnErrorTokenFilter,
+    'whitespace':     VisibleWhitespaceFilter,
+    'gobble':         GobbleFilter,
+    'tokenmerge':     TokenMergeFilter,
+    'symbols':        SymbolFilter,
+}
diff --git a/env/lib/python3.12/site-packages/pygments/formatter.py b/env/lib/python3.12/site-packages/pygments/formatter.py
new file mode 100644
index 0000000..a20d303
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/formatter.py
@@ -0,0 +1,129 @@
+"""
+    pygments.formatter
+    ~~~~~~~~~~~~~~~~~~
+
+    Base formatter class.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import codecs
+
+from pygments.util import get_bool_opt
+from pygments.styles import get_style_by_name
+
+__all__ = ['Formatter']
+
+
+def _lookup_style(style):
+    if isinstance(style, str):
+        return get_style_by_name(style)
+    return style
+
+
+class Formatter:
+    """
+    Converts a token stream to text.
+
+    Formatters should have attributes to help selecting them. These
+    are similar to the corresponding :class:`~pygments.lexer.Lexer`
+    attributes.
+
+    .. autoattribute:: name
+       :no-value:
+
+    .. autoattribute:: aliases
+       :no-value:
+
+    .. autoattribute:: filenames
+       :no-value:
+
+    You can pass options as keyword arguments to the constructor.
+    All formatters accept these basic options:
+
+    ``style``
+        The style to use, can be a string or a Style subclass
+        (default: "default"). Not used by e.g. the
+        TerminalFormatter.
+    ``full``
+        Tells the formatter to output a "full" document, i.e.
+        a complete self-contained document. This doesn't have
+        any effect for some formatters (default: false).
+    ``title``
+        If ``full`` is true, the title that should be used to
+        caption the document (default: '').
+    ``encoding``
+        If given, must be an encoding name. This will be used to
+        convert the Unicode token strings to byte strings in the
+        output. If it is "" or None, Unicode strings will be written
+        to the output file, which most file-like objects do not
+        support (default: None).
+    ``outencoding``
+        Overrides ``encoding`` if given.
+
+    """
+
+    #: Full name for the formatter, in human-readable form.
+    name = None
+
+    #: A list of short, unique identifiers that can be used to lookup
+    #: the formatter from a list, e.g. using :func:`.get_formatter_by_name()`.
+    aliases = []
+
+    #: A list of fnmatch patterns that match filenames for which this
+    #: formatter can produce output. The patterns in this list should be unique
+    #: among all formatters.
+    filenames = []
+
+    #: If True, this formatter outputs Unicode strings when no encoding
+    #: option is given.
+    unicodeoutput = True
+
+    def __init__(self, **options):
+        """
+        As with lexers, this constructor takes arbitrary optional arguments,
+        and if you override it, you should first process your own options, then
+        call the base class implementation.
+        """
+        self.style = _lookup_style(options.get('style', 'default'))
+        self.full = get_bool_opt(options, 'full', False)
+        self.title = options.get('title', '')
+        self.encoding = options.get('encoding', None) or None
+        if self.encoding in ('guess', 'chardet'):
+            # can happen for e.g. pygmentize -O encoding=guess
+            self.encoding = 'utf-8'
+        self.encoding = options.get('outencoding') or self.encoding
+        self.options = options
+
+    def get_style_defs(self, arg=''):
+        """
+        This method must return statements or declarations suitable to define
+        the current style for subsequent highlighted text (e.g. CSS classes
+        in the `HTMLFormatter`).
+
+        The optional argument `arg` can be used to modify the generation and
+        is formatter dependent (it is standardized because it can be given on
+        the command line).
+
+        This method is called by the ``-S`` :doc:`command-line option `,
+        the `arg` is then given by the ``-a`` option.
+        """
+        return ''
+
+    def format(self, tokensource, outfile):
+        """
+        This method must format the tokens from the `tokensource` iterable and
+        write the formatted version to the file object `outfile`.
+
+        Formatter options can control how exactly the tokens are converted.
+        """
+        if self.encoding:
+            # wrap the outfile in a StreamWriter
+            outfile = codecs.lookup(self.encoding)[3](outfile)
+        return self.format_unencoded(tokensource, outfile)
+
+    # Allow writing Formatter[str] or Formatter[bytes]. That's equivalent to
+    # Formatter. This helps when using third-party type stubs from typeshed.
+    def __class_getitem__(cls, name):
+        return cls
diff --git a/env/lib/python3.12/site-packages/pygments/formatters/__init__.py b/env/lib/python3.12/site-packages/pygments/formatters/__init__.py
new file mode 100644
index 0000000..b24931c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/formatters/__init__.py
@@ -0,0 +1,157 @@
+"""
+    pygments.formatters
+    ~~~~~~~~~~~~~~~~~~~
+
+    Pygments formatters.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+import sys
+import types
+import fnmatch
+from os.path import basename
+
+from pygments.formatters._mapping import FORMATTERS
+from pygments.plugin import find_plugin_formatters
+from pygments.util import ClassNotFound
+
+__all__ = ['get_formatter_by_name', 'get_formatter_for_filename',
+           'get_all_formatters', 'load_formatter_from_file'] + list(FORMATTERS)
+
+_formatter_cache = {}  # classes by name
+_pattern_cache = {}
+
+
+def _fn_matches(fn, glob):
+    """Return whether the supplied file name fn matches pattern filename."""
+    if glob not in _pattern_cache:
+        pattern = _pattern_cache[glob] = re.compile(fnmatch.translate(glob))
+        return pattern.match(fn)
+    return _pattern_cache[glob].match(fn)
+
+
+def _load_formatters(module_name):
+    """Load a formatter (and all others in the module too)."""
+    mod = __import__(module_name, None, None, ['__all__'])
+    for formatter_name in mod.__all__:
+        cls = getattr(mod, formatter_name)
+        _formatter_cache[cls.name] = cls
+
+
+def get_all_formatters():
+    """Return a generator for all formatter classes."""
+    # NB: this returns formatter classes, not info like get_all_lexers().
+    for info in FORMATTERS.values():
+        if info[1] not in _formatter_cache:
+            _load_formatters(info[0])
+        yield _formatter_cache[info[1]]
+    for _, formatter in find_plugin_formatters():
+        yield formatter
+
+
+def find_formatter_class(alias):
+    """Lookup a formatter by alias.
+
+    Returns None if not found.
+    """
+    for module_name, name, aliases, _, _ in FORMATTERS.values():
+        if alias in aliases:
+            if name not in _formatter_cache:
+                _load_formatters(module_name)
+            return _formatter_cache[name]
+    for _, cls in find_plugin_formatters():
+        if alias in cls.aliases:
+            return cls
+
+
+def get_formatter_by_name(_alias, **options):
+    """
+    Return an instance of a :class:`.Formatter` subclass that has `alias` in its
+    aliases list. The formatter is given the `options` at its instantiation.
+
+    Will raise :exc:`pygments.util.ClassNotFound` if no formatter with that
+    alias is found.
+    """
+    cls = find_formatter_class(_alias)
+    if cls is None:
+        raise ClassNotFound(f"no formatter found for name {_alias!r}")
+    return cls(**options)
+
+
+def load_formatter_from_file(filename, formattername="CustomFormatter", **options):
+    """
+    Return a `Formatter` subclass instance loaded from the provided file, relative
+    to the current directory.
+
+    The file is expected to contain a Formatter class named ``formattername``
+    (by default, CustomFormatter). Users should be very careful with the input, because
+    this method is equivalent to running ``eval()`` on the input file. The formatter is
+    given the `options` at its instantiation.
+
+    :exc:`pygments.util.ClassNotFound` is raised if there are any errors loading
+    the formatter.
+
+    .. versionadded:: 2.2
+    """
+    try:
+        # This empty dict will contain the namespace for the exec'd file
+        custom_namespace = {}
+        with open(filename, 'rb') as f:
+            exec(f.read(), custom_namespace)
+        # Retrieve the class `formattername` from that namespace
+        if formattername not in custom_namespace:
+            raise ClassNotFound(f'no valid {formattername} class found in {filename}')
+        formatter_class = custom_namespace[formattername]
+        # And finally instantiate it with the options
+        return formatter_class(**options)
+    except OSError as err:
+        raise ClassNotFound(f'cannot read {filename}: {err}')
+    except ClassNotFound:
+        raise
+    except Exception as err:
+        raise ClassNotFound(f'error when loading custom formatter: {err}')
+
+
+def get_formatter_for_filename(fn, **options):
+    """
+    Return a :class:`.Formatter` subclass instance that has a filename pattern
+    matching `fn`. The formatter is given the `options` at its instantiation.
+
+    Will raise :exc:`pygments.util.ClassNotFound` if no formatter for that filename
+    is found.
+    """
+    fn = basename(fn)
+    for modname, name, _, filenames, _ in FORMATTERS.values():
+        for filename in filenames:
+            if _fn_matches(fn, filename):
+                if name not in _formatter_cache:
+                    _load_formatters(modname)
+                return _formatter_cache[name](**options)
+    for _name, cls in find_plugin_formatters():
+        for filename in cls.filenames:
+            if _fn_matches(fn, filename):
+                return cls(**options)
+    raise ClassNotFound(f"no formatter found for file name {fn!r}")
+
+
+class _automodule(types.ModuleType):
+    """Automatically import formatters."""
+
+    def __getattr__(self, name):
+        info = FORMATTERS.get(name)
+        if info:
+            _load_formatters(info[0])
+            cls = _formatter_cache[info[1]]
+            setattr(self, name, cls)
+            return cls
+        raise AttributeError(name)
+
+
+oldmod = sys.modules[__name__]
+newmod = _automodule(__name__)
+newmod.__dict__.update(oldmod.__dict__)
+sys.modules[__name__] = newmod
+del newmod.newmod, newmod.oldmod, newmod.sys, newmod.types
diff --git a/env/lib/python3.12/site-packages/pygments/formatters/_mapping.py b/env/lib/python3.12/site-packages/pygments/formatters/_mapping.py
new file mode 100644
index 0000000..72ca840
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/formatters/_mapping.py
@@ -0,0 +1,23 @@
+# Automatically generated by scripts/gen_mapfiles.py.
+# DO NOT EDIT BY HAND; run `tox -e mapfiles` instead.
+
+FORMATTERS = {
+    'BBCodeFormatter': ('pygments.formatters.bbcode', 'BBCode', ('bbcode', 'bb'), (), 'Format tokens with BBcodes. These formatting codes are used by many bulletin boards, so you can highlight your sourcecode with pygments before posting it there.'),
+    'BmpImageFormatter': ('pygments.formatters.img', 'img_bmp', ('bmp', 'bitmap'), ('*.bmp',), 'Create a bitmap image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'),
+    'GifImageFormatter': ('pygments.formatters.img', 'img_gif', ('gif',), ('*.gif',), 'Create a GIF image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'),
+    'GroffFormatter': ('pygments.formatters.groff', 'groff', ('groff', 'troff', 'roff'), (), 'Format tokens with groff escapes to change their color and font style.'),
+    'HtmlFormatter': ('pygments.formatters.html', 'HTML', ('html',), ('*.html', '*.htm'), "Format tokens as HTML 4 ```` tags. By default, the content is enclosed in a ``
`` tag, itself wrapped in a ``
`` tag (but see the `nowrap` option). The ``
``'s CSS class can be set by the `cssclass` option."),
+    'IRCFormatter': ('pygments.formatters.irc', 'IRC', ('irc', 'IRC'), (), 'Format tokens with IRC color sequences'),
+    'ImageFormatter': ('pygments.formatters.img', 'img', ('img', 'IMG', 'png'), ('*.png',), 'Create a PNG image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'),
+    'JpgImageFormatter': ('pygments.formatters.img', 'img_jpg', ('jpg', 'jpeg'), ('*.jpg',), 'Create a JPEG image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'),
+    'LatexFormatter': ('pygments.formatters.latex', 'LaTeX', ('latex', 'tex'), ('*.tex',), 'Format tokens as LaTeX code. This needs the `fancyvrb` and `color` standard packages.'),
+    'NullFormatter': ('pygments.formatters.other', 'Text only', ('text', 'null'), ('*.txt',), 'Output the text unchanged without any formatting.'),
+    'PangoMarkupFormatter': ('pygments.formatters.pangomarkup', 'Pango Markup', ('pango', 'pangomarkup'), (), 'Format tokens as Pango Markup code. It can then be rendered to an SVG.'),
+    'RawTokenFormatter': ('pygments.formatters.other', 'Raw tokens', ('raw', 'tokens'), ('*.raw',), 'Format tokens as a raw representation for storing token streams.'),
+    'RtfFormatter': ('pygments.formatters.rtf', 'RTF', ('rtf',), ('*.rtf',), 'Format tokens as RTF markup. This formatter automatically outputs full RTF documents with color information and other useful stuff. Perfect for Copy and Paste into Microsoft(R) Word(R) documents.'),
+    'SvgFormatter': ('pygments.formatters.svg', 'SVG', ('svg',), ('*.svg',), 'Format tokens as an SVG graphics file.  This formatter is still experimental. Each line of code is a ```` element with explicit ``x`` and ``y`` coordinates containing ```` elements with the individual token styles.'),
+    'Terminal256Formatter': ('pygments.formatters.terminal256', 'Terminal256', ('terminal256', 'console256', '256'), (), 'Format tokens with ANSI color sequences, for output in a 256-color terminal or console.  Like in `TerminalFormatter` color sequences are terminated at newlines, so that paging the output works correctly.'),
+    'TerminalFormatter': ('pygments.formatters.terminal', 'Terminal', ('terminal', 'console'), (), 'Format tokens with ANSI color sequences, for output in a text console. Color sequences are terminated at newlines, so that paging the output works correctly.'),
+    'TerminalTrueColorFormatter': ('pygments.formatters.terminal256', 'TerminalTrueColor', ('terminal16m', 'console16m', '16m'), (), 'Format tokens with ANSI color sequences, for output in a true-color terminal or console.  Like in `TerminalFormatter` color sequences are terminated at newlines, so that paging the output works correctly.'),
+    'TestcaseFormatter': ('pygments.formatters.other', 'Testcase', ('testcase',), (), 'Format tokens as appropriate for a new testcase.'),
+}
diff --git a/env/lib/python3.12/site-packages/pygments/formatters/bbcode.py b/env/lib/python3.12/site-packages/pygments/formatters/bbcode.py
new file mode 100644
index 0000000..339edf9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/formatters/bbcode.py
@@ -0,0 +1,108 @@
+"""
+    pygments.formatters.bbcode
+    ~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    BBcode formatter.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+
+from pygments.formatter import Formatter
+from pygments.util import get_bool_opt
+
+__all__ = ['BBCodeFormatter']
+
+
+class BBCodeFormatter(Formatter):
+    """
+    Format tokens with BBcodes. These formatting codes are used by many
+    bulletin boards, so you can highlight your sourcecode with pygments before
+    posting it there.
+
+    This formatter has no support for background colors and borders, as there
+    are no common BBcode tags for that.
+
+    Some board systems (e.g. phpBB) don't support colors in their [code] tag,
+    so you can't use the highlighting together with that tag.
+    Text in a [code] tag usually is shown with a monospace font (which this
+    formatter can do with the ``monofont`` option) and no spaces (which you
+    need for indentation) are removed.
+
+    Additional options accepted:
+
+    `style`
+        The style to use, can be a string or a Style subclass (default:
+        ``'default'``).
+
+    `codetag`
+        If set to true, put the output into ``[code]`` tags (default:
+        ``false``)
+
+    `monofont`
+        If set to true, add a tag to show the code with a monospace font
+        (default: ``false``).
+    """
+    name = 'BBCode'
+    aliases = ['bbcode', 'bb']
+    filenames = []
+
+    def __init__(self, **options):
+        Formatter.__init__(self, **options)
+        self._code = get_bool_opt(options, 'codetag', False)
+        self._mono = get_bool_opt(options, 'monofont', False)
+
+        self.styles = {}
+        self._make_styles()
+
+    def _make_styles(self):
+        for ttype, ndef in self.style:
+            start = end = ''
+            if ndef['color']:
+                start += '[color=#{}]'.format(ndef['color'])
+                end = '[/color]' + end
+            if ndef['bold']:
+                start += '[b]'
+                end = '[/b]' + end
+            if ndef['italic']:
+                start += '[i]'
+                end = '[/i]' + end
+            if ndef['underline']:
+                start += '[u]'
+                end = '[/u]' + end
+            # there are no common BBcodes for background-color and border
+
+            self.styles[ttype] = start, end
+
+    def format_unencoded(self, tokensource, outfile):
+        if self._code:
+            outfile.write('[code]')
+        if self._mono:
+            outfile.write('[font=monospace]')
+
+        lastval = ''
+        lasttype = None
+
+        for ttype, value in tokensource:
+            while ttype not in self.styles:
+                ttype = ttype.parent
+            if ttype == lasttype:
+                lastval += value
+            else:
+                if lastval:
+                    start, end = self.styles[lasttype]
+                    outfile.write(''.join((start, lastval, end)))
+                lastval = value
+                lasttype = ttype
+
+        if lastval:
+            start, end = self.styles[lasttype]
+            outfile.write(''.join((start, lastval, end)))
+
+        if self._mono:
+            outfile.write('[/font]')
+        if self._code:
+            outfile.write('[/code]')
+        if self._code or self._mono:
+            outfile.write('\n')
diff --git a/env/lib/python3.12/site-packages/pygments/formatters/groff.py b/env/lib/python3.12/site-packages/pygments/formatters/groff.py
new file mode 100644
index 0000000..028fec4
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/formatters/groff.py
@@ -0,0 +1,170 @@
+"""
+    pygments.formatters.groff
+    ~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Formatter for groff output.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import math
+from pygments.formatter import Formatter
+from pygments.util import get_bool_opt, get_int_opt
+
+__all__ = ['GroffFormatter']
+
+
+class GroffFormatter(Formatter):
+    """
+    Format tokens with groff escapes to change their color and font style.
+
+    .. versionadded:: 2.11
+
+    Additional options accepted:
+
+    `style`
+        The style to use, can be a string or a Style subclass (default:
+        ``'default'``).
+
+    `monospaced`
+        If set to true, monospace font will be used (default: ``true``).
+
+    `linenos`
+        If set to true, print the line numbers (default: ``false``).
+
+    `wrap`
+        Wrap lines to the specified number of characters. Disabled if set to 0
+        (default: ``0``).
+    """
+
+    name = 'groff'
+    aliases = ['groff','troff','roff']
+    filenames = []
+
+    def __init__(self, **options):
+        Formatter.__init__(self, **options)
+
+        self.monospaced = get_bool_opt(options, 'monospaced', True)
+        self.linenos = get_bool_opt(options, 'linenos', False)
+        self._lineno = 0
+        self.wrap = get_int_opt(options, 'wrap', 0)
+        self._linelen = 0
+
+        self.styles = {}
+        self._make_styles()
+
+
+    def _make_styles(self):
+        regular = '\\f[CR]' if self.monospaced else '\\f[R]'
+        bold = '\\f[CB]' if self.monospaced else '\\f[B]'
+        italic = '\\f[CI]' if self.monospaced else '\\f[I]'
+
+        for ttype, ndef in self.style:
+            start = end = ''
+            if ndef['color']:
+                start += '\\m[{}]'.format(ndef['color'])
+                end = '\\m[]' + end
+            if ndef['bold']:
+                start += bold
+                end = regular + end
+            if ndef['italic']:
+                start += italic
+                end = regular + end
+            if ndef['bgcolor']:
+                start += '\\M[{}]'.format(ndef['bgcolor'])
+                end = '\\M[]' + end
+
+            self.styles[ttype] = start, end
+
+
+    def _define_colors(self, outfile):
+        colors = set()
+        for _, ndef in self.style:
+            if ndef['color'] is not None:
+                colors.add(ndef['color'])
+
+        for color in sorted(colors):
+            outfile.write('.defcolor ' + color + ' rgb #' + color + '\n')
+
+
+    def _write_lineno(self, outfile):
+        self._lineno += 1
+        outfile.write("%s% 4d " % (self._lineno != 1 and '\n' or '', self._lineno))
+
+
+    def _wrap_line(self, line):
+        length = len(line.rstrip('\n'))
+        space = '     ' if self.linenos else ''
+        newline = ''
+
+        if length > self.wrap:
+            for i in range(0, math.floor(length / self.wrap)):
+                chunk = line[i*self.wrap:i*self.wrap+self.wrap]
+                newline += (chunk + '\n' + space)
+            remainder = length % self.wrap
+            if remainder > 0:
+                newline += line[-remainder-1:]
+                self._linelen = remainder
+        elif self._linelen + length > self.wrap:
+            newline = ('\n' + space) + line
+            self._linelen = length
+        else:
+            newline = line
+            self._linelen += length
+
+        return newline
+
+
+    def _escape_chars(self, text):
+        text = text.replace('\\', '\\[u005C]'). \
+                    replace('.', '\\[char46]'). \
+                    replace('\'', '\\[u0027]'). \
+                    replace('`', '\\[u0060]'). \
+                    replace('~', '\\[u007E]')
+        copy = text
+
+        for char in copy:
+            if len(char) != len(char.encode()):
+                uni = char.encode('unicode_escape') \
+                    .decode()[1:] \
+                    .replace('x', 'u00') \
+                    .upper()
+                text = text.replace(char, '\\[u' + uni[1:] + ']')
+
+        return text
+
+
+    def format_unencoded(self, tokensource, outfile):
+        self._define_colors(outfile)
+
+        outfile.write('.nf\n\\f[CR]\n')
+
+        if self.linenos:
+            self._write_lineno(outfile)
+
+        for ttype, value in tokensource:
+            while ttype not in self.styles:
+                ttype = ttype.parent
+            start, end = self.styles[ttype]
+
+            for line in value.splitlines(True):
+                if self.wrap > 0:
+                    line = self._wrap_line(line)
+
+                if start and end:
+                    text = self._escape_chars(line.rstrip('\n'))
+                    if text != '':
+                        outfile.write(''.join((start, text, end)))
+                else:
+                    outfile.write(self._escape_chars(line.rstrip('\n')))
+
+                if line.endswith('\n'):
+                    if self.linenos:
+                        self._write_lineno(outfile)
+                        self._linelen = 0
+                    else:
+                        outfile.write('\n')
+                        self._linelen = 0
+
+        outfile.write('\n.fi')
diff --git a/env/lib/python3.12/site-packages/pygments/formatters/html.py b/env/lib/python3.12/site-packages/pygments/formatters/html.py
new file mode 100644
index 0000000..4ef1836
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/formatters/html.py
@@ -0,0 +1,995 @@
+"""
+    pygments.formatters.html
+    ~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Formatter for HTML output.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import functools
+import os
+import sys
+import os.path
+from io import StringIO
+
+from pygments.formatter import Formatter
+from pygments.token import Token, Text, STANDARD_TYPES
+from pygments.util import get_bool_opt, get_int_opt, get_list_opt
+
+try:
+    import ctags
+except ImportError:
+    ctags = None
+
+__all__ = ['HtmlFormatter']
+
+
+_escape_html_table = {
+    ord('&'): '&',
+    ord('<'): '<',
+    ord('>'): '>',
+    ord('"'): '"',
+    ord("'"): ''',
+}
+
+
+def escape_html(text, table=_escape_html_table):
+    """Escape &, <, > as well as single and double quotes for HTML."""
+    return text.translate(table)
+
+
+def webify(color):
+    if color.startswith('calc') or color.startswith('var'):
+        return color
+    else:
+        # Check if the color can be shortened from 6 to 3 characters
+        color = color.upper()
+        if (len(color) == 6 and
+            (    color[0] == color[1]
+             and color[2] == color[3]
+             and color[4] == color[5])):
+            return f'#{color[0]}{color[2]}{color[4]}'
+        else:
+            return f'#{color}'
+
+
+def _get_ttype_class(ttype):
+    fname = STANDARD_TYPES.get(ttype)
+    if fname:
+        return fname
+    aname = ''
+    while fname is None:
+        aname = '-' + ttype[-1] + aname
+        ttype = ttype.parent
+        fname = STANDARD_TYPES.get(ttype)
+    return fname + aname
+
+
+CSSFILE_TEMPLATE = '''\
+/*
+generated by Pygments 
+Copyright 2006-2025 by the Pygments team.
+Licensed under the BSD license, see LICENSE for details.
+*/
+%(styledefs)s
+'''
+
+DOC_HEADER = '''\
+
+
+
+
+  %(title)s
+  
+  
+
+
+
%(title)s

+
+'''
+
+DOC_HEADER_EXTERNALCSS = '''\
+
+
+
+
+  %(title)s
+  
+  
+
+
+
%(title)s

+
+'''
+
+DOC_FOOTER = '''\
+
+
+'''
+
+
+class HtmlFormatter(Formatter):
+    r"""
+    Format tokens as HTML 4 ```` tags. By default, the content is enclosed
+    in a ``
`` tag, itself wrapped in a ``
`` tag (but see the `nowrap` option).
+    The ``
``'s CSS class can be set by the `cssclass` option.
+
+    If the `linenos` option is set to ``"table"``, the ``
`` is
+    additionally wrapped inside a ```` which has one row and two
+    cells: one containing the line numbers and one containing the code.
+    Example:
+
+    .. sourcecode:: html
+
+        

+        

+          
+          
+        

+            
1
+            2

+          		
+            
def foo(bar):
+              pass
+            

+          

+
+    (whitespace added to improve clarity).
+
+    A list of lines can be specified using the `hl_lines` option to make these
+    lines highlighted (as of Pygments 0.11).
+
+    With the `full` option, a complete HTML 4 document is output, including
+    the style definitions inside a ``$)', _handle_cssblock),
+
+            include('keywords'),
+            include('inline'),
+        ],
+        'keywords': [
+            (words((
+                '\\define', '\\end', 'caption', 'created', 'modified', 'tags',
+                'title', 'type'), prefix=r'^', suffix=r'\b'),
+             Keyword),
+        ],
+        'inline': [
+            # escape
+            (r'\\.', Text),
+            # created or modified date
+            (r'\d{17}', Number.Integer),
+            # italics
+            (r'(\s)(//[^/]+//)((?=\W|\n))',
+             bygroups(Text, Generic.Emph, Text)),
+            # superscript
+            (r'(\s)(\^\^[^\^]+\^\^)', bygroups(Text, Generic.Emph)),
+            # subscript
+            (r'(\s)(,,[^,]+,,)', bygroups(Text, Generic.Emph)),
+            # underscore
+            (r'(\s)(__[^_]+__)', bygroups(Text, Generic.Strong)),
+            # bold
+            (r"(\s)(''[^']+'')((?=\W|\n))",
+             bygroups(Text, Generic.Strong, Text)),
+            # strikethrough
+            (r'(\s)(~~[^~]+~~)((?=\W|\n))',
+             bygroups(Text, Generic.Deleted, Text)),
+            # TiddlyWiki variables
+            (r'<<[^>]+>>', Name.Tag),
+            (r'\$\$[^$]+\$\$', Name.Tag),
+            (r'\$\([^)]+\)\$', Name.Tag),
+            # TiddlyWiki style or class
+            (r'^@@.*$', Name.Tag),
+            # HTML tags
+            (r']+>', Name.Tag),
+            # inline code
+            (r'`[^`]+`', String.Backtick),
+            # HTML escaped symbols
+            (r'&\S*?;', String.Regex),
+            # Wiki links
+            (r'(\[{2})([^]\|]+)(\]{2})', bygroups(Text, Name.Tag, Text)),
+            # External links
+            (r'(\[{2})([^]\|]+)(\|)([^]\|]+)(\]{2})',
+            bygroups(Text, Name.Tag, Text, Name.Attribute, Text)),
+            # Transclusion
+            (r'(\{{2})([^}]+)(\}{2})', bygroups(Text, Name.Tag, Text)),
+            # URLs
+            (r'(\b.?.?tps?://[^\s"]+)', bygroups(Name.Attribute)),
+
+            # general text, must come last!
+            (r'[\w]+', Text),
+            (r'.', Text)
+        ],
+    }
+
+    def __init__(self, **options):
+        self.handlecodeblocks = get_bool_opt(options, 'handlecodeblocks', True)
+        RegexLexer.__init__(self, **options)
+
+
+class WikitextLexer(RegexLexer):
+    """
+    For MediaWiki Wikitext.
+
+    Parsing Wikitext is tricky, and results vary between different MediaWiki
+    installations, so we only highlight common syntaxes (built-in or from
+    popular extensions), and also assume templates produce no unbalanced
+    syntaxes.
+    """
+    name = 'Wikitext'
+    url = 'https://www.mediawiki.org/wiki/Wikitext'
+    aliases = ['wikitext', 'mediawiki']
+    filenames = []
+    mimetypes = ['text/x-wiki']
+    version_added = '2.15'
+    flags = re.MULTILINE
+
+    def nowiki_tag_rules(tag_name):
+        return [
+            (rf'(?i)()', bygroups(Punctuation,
+             Name.Tag, Whitespace, Punctuation), '#pop'),
+            include('entity'),
+            include('text'),
+        ]
+
+    def plaintext_tag_rules(tag_name):
+        return [
+            (rf'(?si)(.*?)()', bygroups(Text,
+             Punctuation, Name.Tag, Whitespace, Punctuation), '#pop'),
+        ]
+
+    def delegate_tag_rules(tag_name, lexer, **lexer_kwargs):
+        return [
+            (rf'(?i)()', bygroups(Punctuation,
+             Name.Tag, Whitespace, Punctuation), '#pop'),
+            (rf'(?si).+?(?=)', using(lexer, **lexer_kwargs)),
+        ]
+
+    def text_rules(token):
+        return [
+            (r'\w+', token),
+            (r'[^\S\n]+', token),
+            (r'(?s).', token),
+        ]
+
+    def handle_syntaxhighlight(self, match, ctx):
+        from pygments.lexers import get_lexer_by_name
+
+        attr_content = match.group()
+        start = 0
+        index = 0
+        while True:
+            index = attr_content.find('>', start)
+            # Exclude comment end (-->)
+            if attr_content[index-2:index] != '--':
+                break
+            start = index + 1
+
+        if index == -1:
+            # No tag end
+            yield from self.get_tokens_unprocessed(attr_content, stack=['root', 'attr'])
+            return
+        attr = attr_content[:index]
+        yield from self.get_tokens_unprocessed(attr, stack=['root', 'attr'])
+        yield match.start(3) + index, Punctuation, '>'
+
+        lexer = None
+        content = attr_content[index+1:]
+        lang_match = re.findall(r'\blang=("|\'|)(\w+)(\1)', attr)
+
+        if len(lang_match) >= 1:
+            # Pick the last match in case of multiple matches
+            lang = lang_match[-1][1]
+            try:
+                lexer = get_lexer_by_name(lang)
+            except ClassNotFound:
+                pass
+
+        if lexer is None:
+            yield match.start() + index + 1, Text, content
+        else:
+            yield from lexer.get_tokens_unprocessed(content)
+
+    def handle_score(self, match, ctx):
+        attr_content = match.group()
+        start = 0
+        index = 0
+        while True:
+            index = attr_content.find('>', start)
+            # Exclude comment end (-->)
+            if attr_content[index-2:index] != '--':
+                break
+            start = index + 1
+
+        if index == -1:
+            # No tag end
+            yield from self.get_tokens_unprocessed(attr_content, stack=['root', 'attr'])
+            return
+        attr = attr_content[:index]
+        content = attr_content[index+1:]
+        yield from self.get_tokens_unprocessed(attr, stack=['root', 'attr'])
+        yield match.start(3) + index, Punctuation, '>'
+
+        lang_match = re.findall(r'\blang=("|\'|)(\w+)(\1)', attr)
+        # Pick the last match in case of multiple matches
+        lang = lang_match[-1][1] if len(lang_match) >= 1 else 'lilypond'
+
+        if lang == 'lilypond':  # Case sensitive
+            yield from LilyPondLexer().get_tokens_unprocessed(content)
+        else:  # ABC
+            # FIXME: Use ABC lexer in the future
+            yield match.start() + index + 1, Text, content
+
+    # a-z removed to prevent linter from complaining, REMEMBER to use (?i)
+    title_char = r' %!"$&\'()*,\-./0-9:;=?@A-Z\\\^_`~+\u0080-\uFFFF'
+    nbsp_char = r'(?:\t| |&\#0*160;|&\#[Xx]0*[Aa]0;|[ \xA0\u1680\u2000-\u200A\u202F\u205F\u3000])'
+    link_address = r'(?:[0-9.]+|\[[0-9a-f:.]+\]|[^\x00-\x20"<>\[\]\x7F\xA0\u1680\u2000-\u200A\u202F\u205F\u3000\uFFFD])'
+    link_char_class = r'[^\x00-\x20"<>\[\]\x7F\xA0\u1680\u2000-\u200A\u202F\u205F\u3000\uFFFD]'
+    double_slashes_i = {
+        '__FORCETOC__', '__NOCONTENTCONVERT__', '__NOCC__', '__NOEDITSECTION__', '__NOGALLERY__',
+        '__NOTITLECONVERT__', '__NOTC__', '__NOTOC__', '__TOC__',
+    }
+    double_slashes = {
+        '__EXPECTUNUSEDCATEGORY__',  '__HIDDENCAT__', '__INDEX__',  '__NEWSECTIONLINK__',
+        '__NOINDEX__',  '__NONEWSECTIONLINK__',  '__STATICREDIRECT__', '__NOGLOBAL__',
+        '__DISAMBIG__', '__EXPECTED_UNCONNECTED_PAGE__',
+    }
+    protocols = {
+        'bitcoin:', 'ftp://', 'ftps://', 'geo:', 'git://', 'gopher://', 'http://', 'https://',
+        'irc://', 'ircs://', 'magnet:', 'mailto:', 'mms://', 'news:', 'nntp://', 'redis://',
+        'sftp://', 'sip:', 'sips:', 'sms:', 'ssh://', 'svn://', 'tel:', 'telnet://', 'urn:',
+        'worldwind://', 'xmpp:', '//',
+    }
+    non_relative_protocols = protocols - {'//'}
+    html_tags = {
+        'abbr', 'b', 'bdi', 'bdo', 'big', 'blockquote', 'br', 'caption', 'center', 'cite', 'code',
+        'data', 'dd', 'del', 'dfn', 'div', 'dl', 'dt', 'em', 'font', 'h1', 'h2', 'h3', 'h4', 'h5',
+        'h6', 'hr', 'i', 'ins', 'kbd', 'li', 'link', 'mark', 'meta', 'ol', 'p', 'q', 'rb', 'rp',
+        'rt', 'rtc', 'ruby', 's', 'samp', 'small', 'span', 'strike', 'strong', 'sub', 'sup',
+        'table', 'td', 'th', 'time', 'tr', 'tt', 'u', 'ul', 'var', 'wbr',
+    }
+    parser_tags = {
+        'graph', 'charinsert', 'rss', 'chem', 'categorytree', 'nowiki', 'inputbox', 'math',
+        'hiero', 'score', 'pre', 'ref', 'translate', 'imagemap', 'templatestyles', 'languages',
+        'noinclude', 'mapframe', 'section', 'poem', 'syntaxhighlight', 'includeonly', 'tvar',
+        'onlyinclude', 'templatedata', 'langconvert', 'timeline', 'dynamicpagelist', 'gallery',
+        'maplink', 'ce', 'references',
+    }
+    variant_langs = {
+        # ZhConverter.php
+        'zh', 'zh-hans', 'zh-hant', 'zh-cn', 'zh-hk', 'zh-mo', 'zh-my', 'zh-sg', 'zh-tw',
+        # WuuConverter.php
+        'wuu', 'wuu-hans', 'wuu-hant',
+        # UzConverter.php
+        'uz', 'uz-latn', 'uz-cyrl',
+        # TlyConverter.php
+        'tly', 'tly-cyrl',
+        # TgConverter.php
+        'tg', 'tg-latn',
+        # SrConverter.php
+        'sr', 'sr-ec', 'sr-el',
+        # ShiConverter.php
+        'shi', 'shi-tfng', 'shi-latn',
+        # ShConverter.php
+        'sh-latn', 'sh-cyrl',
+        # KuConverter.php
+        'ku', 'ku-arab', 'ku-latn',
+        # IuConverter.php
+        'iu', 'ike-cans', 'ike-latn',
+        # GanConverter.php
+        'gan', 'gan-hans', 'gan-hant',
+        # EnConverter.php
+        'en', 'en-x-piglatin',
+        # CrhConverter.php
+        'crh', 'crh-cyrl', 'crh-latn',
+        # BanConverter.php
+        'ban', 'ban-bali', 'ban-x-dharma', 'ban-x-palmleaf', 'ban-x-pku',
+    }
+    magic_vars_i = {
+        'ARTICLEPATH', 'INT', 'PAGEID', 'SCRIPTPATH', 'SERVER', 'SERVERNAME', 'STYLEPATH',
+    }
+    magic_vars = {
+        '!', '=', 'BASEPAGENAME', 'BASEPAGENAMEE', 'CASCADINGSOURCES', 'CONTENTLANGUAGE',
+        'CONTENTLANG', 'CURRENTDAY', 'CURRENTDAY2', 'CURRENTDAYNAME', 'CURRENTDOW', 'CURRENTHOUR',
+        'CURRENTMONTH', 'CURRENTMONTH2', 'CURRENTMONTH1', 'CURRENTMONTHABBREV', 'CURRENTMONTHNAME',
+        'CURRENTMONTHNAMEGEN', 'CURRENTTIME', 'CURRENTTIMESTAMP', 'CURRENTVERSION', 'CURRENTWEEK',
+        'CURRENTYEAR', 'DIRECTIONMARK', 'DIRMARK', 'FULLPAGENAME', 'FULLPAGENAMEE', 'LOCALDAY',
+        'LOCALDAY2', 'LOCALDAYNAME', 'LOCALDOW', 'LOCALHOUR', 'LOCALMONTH', 'LOCALMONTH2',
+        'LOCALMONTH1', 'LOCALMONTHABBREV', 'LOCALMONTHNAME', 'LOCALMONTHNAMEGEN', 'LOCALTIME',
+        'LOCALTIMESTAMP', 'LOCALWEEK', 'LOCALYEAR', 'NAMESPACE', 'NAMESPACEE', 'NAMESPACENUMBER',
+        'NUMBEROFACTIVEUSERS', 'NUMBEROFADMINS', 'NUMBEROFARTICLES', 'NUMBEROFEDITS',
+        'NUMBEROFFILES', 'NUMBEROFPAGES', 'NUMBEROFUSERS', 'PAGELANGUAGE', 'PAGENAME', 'PAGENAMEE',
+        'REVISIONDAY', 'REVISIONDAY2', 'REVISIONID', 'REVISIONMONTH', 'REVISIONMONTH1',
+        'REVISIONSIZE', 'REVISIONTIMESTAMP', 'REVISIONUSER', 'REVISIONYEAR', 'ROOTPAGENAME',
+        'ROOTPAGENAMEE', 'SITENAME', 'SUBJECTPAGENAME', 'ARTICLEPAGENAME', 'SUBJECTPAGENAMEE',
+        'ARTICLEPAGENAMEE', 'SUBJECTSPACE', 'ARTICLESPACE', 'SUBJECTSPACEE', 'ARTICLESPACEE',
+        'SUBPAGENAME', 'SUBPAGENAMEE', 'TALKPAGENAME', 'TALKPAGENAMEE', 'TALKSPACE', 'TALKSPACEE',
+    }
+    parser_functions_i = {
+        'ANCHORENCODE', 'BIDI', 'CANONICALURL', 'CANONICALURLE', 'FILEPATH', 'FORMATNUM',
+        'FULLURL', 'FULLURLE', 'GENDER', 'GRAMMAR', 'INT', r'\#LANGUAGE', 'LC', 'LCFIRST', 'LOCALURL',
+        'LOCALURLE', 'NS', 'NSE', 'PADLEFT', 'PADRIGHT', 'PAGEID', 'PLURAL', 'UC', 'UCFIRST',
+        'URLENCODE',
+    }
+    parser_functions = {
+        'BASEPAGENAME', 'BASEPAGENAMEE', 'CASCADINGSOURCES', 'DEFAULTSORT', 'DEFAULTSORTKEY',
+        'DEFAULTCATEGORYSORT', 'FULLPAGENAME', 'FULLPAGENAMEE', 'NAMESPACE', 'NAMESPACEE',
+        'NAMESPACENUMBER', 'NUMBERINGROUP', 'NUMINGROUP', 'NUMBEROFACTIVEUSERS', 'NUMBEROFADMINS',
+        'NUMBEROFARTICLES', 'NUMBEROFEDITS', 'NUMBEROFFILES', 'NUMBEROFPAGES', 'NUMBEROFUSERS',
+        'PAGENAME', 'PAGENAMEE', 'PAGESINCATEGORY', 'PAGESINCAT', 'PAGESIZE', 'PROTECTIONEXPIRY',
+        'PROTECTIONLEVEL', 'REVISIONDAY', 'REVISIONDAY2', 'REVISIONID', 'REVISIONMONTH',
+        'REVISIONMONTH1', 'REVISIONTIMESTAMP', 'REVISIONUSER', 'REVISIONYEAR', 'ROOTPAGENAME',
+        'ROOTPAGENAMEE', 'SUBJECTPAGENAME', 'ARTICLEPAGENAME', 'SUBJECTPAGENAMEE',
+        'ARTICLEPAGENAMEE', 'SUBJECTSPACE', 'ARTICLESPACE', 'SUBJECTSPACEE', 'ARTICLESPACEE',
+        'SUBPAGENAME', 'SUBPAGENAMEE', 'TALKPAGENAME', 'TALKPAGENAMEE', 'TALKSPACE', 'TALKSPACEE',
+        'INT', 'DISPLAYTITLE', 'PAGESINNAMESPACE', 'PAGESINNS',
+    }
+
+    tokens = {
+        'root': [
+            # Redirects
+            (r"""(?xi)
+                (\A\s*?)(\#REDIRECT:?) # may contain a colon
+                (\s+)(\[\[) (?=[^\]\n]* \]\]$)
+            """,
+             bygroups(Whitespace, Keyword, Whitespace, Punctuation), 'redirect-inner'),
+            # Subheadings
+            (r'^(={2,6})(.+?)(\1)(\s*$\n)',
+             bygroups(Generic.Subheading, Generic.Subheading, Generic.Subheading, Whitespace)),
+            # Headings
+            (r'^(=.+?=)(\s*$\n)',
+             bygroups(Generic.Heading, Whitespace)),
+            # Double-slashed magic words
+            (words(double_slashes_i, prefix=r'(?i)'), Name.Function.Magic),
+            (words(double_slashes), Name.Function.Magic),
+            # Raw URLs
+            (r'(?i)\b(?:{}){}{}*'.format('|'.join(protocols),
+             link_address, link_char_class), Name.Label),
+            # Magic links
+            (rf'\b(?:RFC|PMID){nbsp_char}+[0-9]+\b',
+             Name.Function.Magic),
+            (r"""(?x)
+                \bISBN {nbsp_char}
+                (?: 97[89] {nbsp_dash}? )?
+                (?: [0-9] {nbsp_dash}? ){{9}} # escape format()
+                [0-9Xx]\b
+            """.format(nbsp_char=nbsp_char, nbsp_dash=f'(?:-|{nbsp_char})'), Name.Function.Magic),
+            include('list'),
+            include('inline'),
+            include('text'),
+        ],
+        'redirect-inner': [
+            (r'(\]\])(\s*?\n)', bygroups(Punctuation, Whitespace), '#pop'),
+            (r'(\#)([^#]*?)', bygroups(Punctuation, Name.Label)),
+            (rf'(?i)[{title_char}]+', Name.Tag),
+        ],
+        'list': [
+            # Description lists
+            (r'^;', Keyword, 'dt'),
+            # Ordered lists, unordered lists and indents
+            (r'^[#:*]+', Keyword),
+            # Horizontal rules
+            (r'^-{4,}', Keyword),
+        ],
+        'inline': [
+            # Signatures
+            (r'~{3,5}', Keyword),
+            # Entities
+            include('entity'),
+            # Bold & italic
+            (r"('')(''')(?!')", bygroups(Generic.Emph,
+             Generic.EmphStrong), 'inline-italic-bold'),
+            (r"'''(?!')", Generic.Strong, 'inline-bold'),
+            (r"''(?!')", Generic.Emph, 'inline-italic'),
+            # Comments & parameters & templates
+            include('replaceable'),
+            # Media links
+            (
+                r"""(?xi)
+                (\[\[)
+                    (File|Image) (:)
+                    ((?: [{}] | \{{{{2,3}}[^{{}}]*?\}}{{2,3}} |  )*)
+                    (?: (\#) ([{}]*?) )?
+                """.format(title_char, f'{title_char}#'),
+                bygroups(Punctuation, Name.Namespace,  Punctuation,
+                         using(this, state=['wikilink-name']), Punctuation, Name.Label),
+                'medialink-inner'
+            ),
+            # Wikilinks
+            (
+                r"""(?xi)
+                (\[\[)(?!{}) # Should not contain URLs
+                    (?: ([{}]*) (:))?
+                    ((?: [{}] | \{{{{2,3}}[^{{}}]*?\}}{{2,3}} |  )*?)
+                    (?: (\#) ([{}]*?) )?
+                (\]\])
+                """.format('|'.join(protocols), title_char.replace('/', ''),
+                       title_char, f'{title_char}#'),
+                bygroups(Punctuation, Name.Namespace,  Punctuation,
+                         using(this, state=['wikilink-name']), Punctuation, Name.Label, Punctuation)
+            ),
+            (
+                r"""(?xi)
+                (\[\[)(?!{})
+                    (?: ([{}]*) (:))?
+                    ((?: [{}] | \{{{{2,3}}[^{{}}]*?\}}{{2,3}} |  )*?)
+                    (?: (\#) ([{}]*?) )?
+                    (\|)
+                """.format('|'.join(protocols), title_char.replace('/', ''),
+                       title_char, f'{title_char}#'),
+                bygroups(Punctuation, Name.Namespace,  Punctuation,
+                         using(this, state=['wikilink-name']), Punctuation, Name.Label, Punctuation),
+                'wikilink-inner'
+            ),
+            # External links
+            (
+                r"""(?xi)
+                (\[)
+                    ((?:{}) {} {}*)
+                    (\s*)
+                """.format('|'.join(protocols), link_address, link_char_class),
+                bygroups(Punctuation, Name.Label, Whitespace),
+                'extlink-inner'
+            ),
+            # Tables
+            (r'^(:*)(\s*?)(\{\|)([^\n]*)$', bygroups(Keyword,
+             Whitespace, Punctuation, using(this, state=['root', 'attr'])), 'table'),
+            # HTML tags
+            (r'(?i)(<)({})\b'.format('|'.join(html_tags)),
+             bygroups(Punctuation, Name.Tag), 'tag-inner-ordinary'),
+            (r'(?i)()'.format('|'.join(html_tags)),
+             bygroups(Punctuation, Name.Tag, Whitespace, Punctuation)),
+            # 
+            (r'(?i)(<)(nowiki)\b', bygroups(Punctuation,
+             Name.Tag), ('tag-nowiki', 'tag-inner')),
+            # 
+            (r'(?i)(<)(pre)\b', bygroups(Punctuation,
+             Name.Tag), ('tag-pre', 'tag-inner')),
+            # 
+            (r'(?i)(<)(categorytree)\b', bygroups(
+                Punctuation, Name.Tag), ('tag-categorytree', 'tag-inner')),
+            # 
+            (r'(?i)(<)(hiero)\b', bygroups(Punctuation,
+             Name.Tag), ('tag-hiero', 'tag-inner')),
+            # 
+            (r'(?i)(<)(math)\b', bygroups(Punctuation,
+             Name.Tag), ('tag-math', 'tag-inner')),
+            # 
+            (r'(?i)(<)(chem)\b', bygroups(Punctuation,
+             Name.Tag), ('tag-chem', 'tag-inner')),
+            # 
+            (r'(?i)(<)(ce)\b', bygroups(Punctuation,
+             Name.Tag), ('tag-ce', 'tag-inner')),
+            # 
+            (r'(?i)(<)(charinsert)\b', bygroups(
+                Punctuation, Name.Tag), ('tag-charinsert', 'tag-inner')),
+            # 
+            (r'(?i)(<)(templatedata)\b', bygroups(
+                Punctuation, Name.Tag), ('tag-templatedata', 'tag-inner')),
+            # 
+            (r'(?i)(<)(gallery)\b', bygroups(
+                Punctuation, Name.Tag), ('tag-gallery', 'tag-inner')),
+            # 
+            (r'(?i)(<)(gallery)\b', bygroups(
+                Punctuation, Name.Tag), ('tag-graph', 'tag-inner')),
+            # 
+            (r'(?i)(<)(dynamicpagelist)\b', bygroups(
+                Punctuation, Name.Tag), ('tag-dynamicpagelist', 'tag-inner')),
+            # 
+            (r'(?i)(<)(inputbox)\b', bygroups(
+                Punctuation, Name.Tag), ('tag-inputbox', 'tag-inner')),
+            # 
+            (r'(?i)(<)(rss)\b', bygroups(
+                Punctuation, Name.Tag), ('tag-rss', 'tag-inner')),
+            # 
+            (r'(?i)(<)(imagemap)\b', bygroups(
+                Punctuation, Name.Tag), ('tag-imagemap', 'tag-inner')),
+            # 
+            (r'(?i)()',
+             bygroups(Punctuation, Name.Tag, Whitespace, Punctuation)),
+            (r'(?si)(<)(syntaxhighlight)\b([^>]*?(?.*?)(?=)',
+             bygroups(Punctuation, Name.Tag, handle_syntaxhighlight)),
+            # : Fallback case for self-closing tags
+            (r'(?i)(<)(syntaxhighlight)\b(\s*?)((?:[^>]|-->)*?)(/\s*?(?)*?)(/\s*?(?)*?)(/\s*?(?|\Z)', Comment.Multiline),
+            # Parameters
+            (
+                r"""(?x)
+                (\{{3})
+                    ([^|]*?)
+                    (?=\}{3}|\|)
+                """,
+                bygroups(Punctuation, Name.Variable),
+                'parameter-inner',
+            ),
+            # Magic variables
+            (r'(?i)(\{{\{{)(\s*)({})(\s*)(\}}\}})'.format('|'.join(magic_vars_i)),
+             bygroups(Punctuation, Whitespace, Name.Function, Whitespace, Punctuation)),
+            (r'(\{{\{{)(\s*)({})(\s*)(\}}\}})'.format('|'.join(magic_vars)),
+                bygroups(Punctuation, Whitespace, Name.Function, Whitespace, Punctuation)),
+            # Parser functions & templates
+            (r'\{\{', Punctuation, 'template-begin-space'),
+            #  legacy syntax
+            (r'(?i)(<)(tvar)\b(\|)([^>]*?)(>)', bygroups(Punctuation,
+             Name.Tag, Punctuation, String, Punctuation)),
+            (r'', Punctuation, '#pop'),
+            # 
+            (r'(?i)(<)(tvar)\b', bygroups(Punctuation, Name.Tag), 'tag-inner-ordinary'),
+            (r'(?i)()',
+             bygroups(Punctuation, Name.Tag, Whitespace, Punctuation)),
+        ],
+        'parameter-inner': [
+            (r'\}{3}', Punctuation, '#pop'),
+            (r'\|', Punctuation),
+            include('inline'),
+            include('text'),
+        ],
+        'template-begin-space': [
+            # Templates allow line breaks at the beginning, and due to how MediaWiki handles
+            # comments, an extra state is required to handle things like {{\n\n name}}
+            (r'|\Z)', Comment.Multiline),
+            (r'\s+', Whitespace),
+            # Parser functions
+            (
+                r'(?i)(\#[{}]*?|{})(:)'.format(title_char,
+                                           '|'.join(parser_functions_i)),
+                bygroups(Name.Function, Punctuation), ('#pop', 'template-inner')
+            ),
+            (
+                r'({})(:)'.format('|'.join(parser_functions)),
+                bygroups(Name.Function, Punctuation), ('#pop', 'template-inner')
+            ),
+            # Templates
+            (
+                rf'(?i)([{title_char}]*?)(:)',
+                bygroups(Name.Namespace, Punctuation), ('#pop', 'template-name')
+            ),
+            default(('#pop', 'template-name'),),
+        ],
+        'template-name': [
+            (r'(\s*?)(\|)', bygroups(Text, Punctuation), ('#pop', 'template-inner')),
+            (r'\}\}', Punctuation, '#pop'),
+            (r'\n', Text, '#pop'),
+            include('replaceable'),
+            *text_rules(Name.Tag),
+        ],
+        'template-inner': [
+            (r'\}\}', Punctuation, '#pop'),
+            (r'\|', Punctuation),
+            (
+                r"""(?x)
+                    (?<=\|)
+                    ( (?: (?! \{\{ | \}\} )[^=\|<])*? ) # Exclude templates and tags
+                    (=)
+                """,
+                bygroups(Name.Label, Operator)
+            ),
+            include('inline'),
+            include('text'),
+        ],
+        'table': [
+            # Use [ \t\n\r\0\x0B] instead of \s to follow PHP trim() behavior
+            # Endings
+            (r'^([ \t\n\r\0\x0B]*?)(\|\})',
+             bygroups(Whitespace, Punctuation), '#pop'),
+            # Table rows
+            (r'^([ \t\n\r\0\x0B]*?)(\|-+)(.*)$', bygroups(Whitespace, Punctuation,
+             using(this, state=['root', 'attr']))),
+            # Captions
+            (
+                r"""(?x)
+                ^([ \t\n\r\0\x0B]*?)(\|\+)
+                # Exclude links, template and tags
+                (?: ( (?: (?! \[\[ | \{\{ )[^|\n<] )*? )(\|) )?
+                (.*?)$
+                """,
+                bygroups(Whitespace, Punctuation, using(this, state=[
+                         'root', 'attr']), Punctuation, Generic.Heading),
+            ),
+            # Table data
+            (
+                r"""(?x)
+                ( ^(?:[ \t\n\r\0\x0B]*?)\| | \|\| )
+                (?: ( (?: (?! \[\[ | \{\{ )[^|\n<] )*? )(\|)(?!\|) )?
+                """,
+                bygroups(Punctuation, using(this, state=[
+                         'root', 'attr']), Punctuation),
+            ),
+            # Table headers
+            (
+                r"""(?x)
+                ( ^(?:[ \t\n\r\0\x0B]*?)!  )
+                (?: ( (?: (?! \[\[ | \{\{ )[^|\n<] )*? )(\|)(?!\|) )?
+                """,
+                bygroups(Punctuation, using(this, state=[
+                         'root', 'attr']), Punctuation),
+                'table-header',
+            ),
+            include('list'),
+            include('inline'),
+            include('text'),
+        ],
+        'table-header': [
+            # Requires another state for || handling inside headers
+            (r'\n', Text, '#pop'),
+            (
+                r"""(?x)
+                (!!|\|\|)
+                (?:
+                    ( (?: (?! \[\[ | \{\{ )[^|\n<] )*? )
+                    (\|)(?!\|)
+                )?
+                """,
+                bygroups(Punctuation, using(this, state=[
+                         'root', 'attr']), Punctuation)
+            ),
+            *text_rules(Generic.Subheading),
+        ],
+        'entity': [
+            (r'&\S*?;', Name.Entity),
+        ],
+        'dt': [
+            (r'\n', Text, '#pop'),
+            include('inline'),
+            (r':', Keyword, '#pop'),
+            include('text'),
+        ],
+        'extlink-inner': [
+            (r'\]', Punctuation, '#pop'),
+            include('inline'),
+            include('text'),
+        ],
+        'nowiki-ish': [
+            include('entity'),
+            include('text'),
+        ],
+        'attr': [
+            include('replaceable'),
+            (r'\s+', Whitespace),
+            (r'(=)(\s*)(")', bygroups(Operator, Whitespace, String.Double), 'attr-val-2'),
+            (r"(=)(\s*)(')", bygroups(Operator, Whitespace, String.Single), 'attr-val-1'),
+            (r'(=)(\s*)', bygroups(Operator, Whitespace), 'attr-val-0'),
+            (r'[\w:-]+', Name.Attribute),
+
+        ],
+        'attr-val-0': [
+            (r'\s', Whitespace, '#pop'),
+            include('replaceable'),
+            *text_rules(String),
+        ],
+        'attr-val-1': [
+            (r"'", String.Single, '#pop'),
+            include('replaceable'),
+            *text_rules(String.Single),
+        ],
+        'attr-val-2': [
+            (r'"', String.Double, '#pop'),
+            include('replaceable'),
+            *text_rules(String.Double),
+        ],
+        'tag-inner-ordinary': [
+            (r'/?\s*>', Punctuation, '#pop'),
+            include('tag-attr'),
+        ],
+        'tag-inner': [
+            # Return to root state for self-closing tags
+            (r'/\s*>', Punctuation, '#pop:2'),
+            (r'\s*>', Punctuation, '#pop'),
+            include('tag-attr'),
+        ],
+        # There states below are just like their non-tag variants, the key difference is
+        # they forcibly quit when encountering tag closing markup
+        'tag-attr': [
+            include('replaceable'),
+            (r'\s+', Whitespace),
+            (r'(=)(\s*)(")', bygroups(Operator,
+             Whitespace, String.Double), 'tag-attr-val-2'),
+            (r"(=)(\s*)(')", bygroups(Operator,
+             Whitespace, String.Single), 'tag-attr-val-1'),
+            (r'(=)(\s*)', bygroups(Operator, Whitespace), 'tag-attr-val-0'),
+            (r'[\w:-]+', Name.Attribute),
+
+        ],
+        'tag-attr-val-0': [
+            (r'\s', Whitespace, '#pop'),
+            (r'/?>', Punctuation, '#pop:2'),
+            include('replaceable'),
+            *text_rules(String),
+        ],
+        'tag-attr-val-1': [
+            (r"'", String.Single, '#pop'),
+            (r'/?>', Punctuation, '#pop:2'),
+            include('replaceable'),
+            *text_rules(String.Single),
+        ],
+        'tag-attr-val-2': [
+            (r'"', String.Double, '#pop'),
+            (r'/?>', Punctuation, '#pop:2'),
+            include('replaceable'),
+            *text_rules(String.Double),
+        ],
+        'tag-nowiki': nowiki_tag_rules('nowiki'),
+        'tag-pre': nowiki_tag_rules('pre'),
+        'tag-categorytree': plaintext_tag_rules('categorytree'),
+        'tag-dynamicpagelist': plaintext_tag_rules('dynamicpagelist'),
+        'tag-hiero': plaintext_tag_rules('hiero'),
+        'tag-inputbox': plaintext_tag_rules('inputbox'),
+        'tag-imagemap': plaintext_tag_rules('imagemap'),
+        'tag-charinsert': plaintext_tag_rules('charinsert'),
+        'tag-timeline': plaintext_tag_rules('timeline'),
+        'tag-gallery': plaintext_tag_rules('gallery'),
+        'tag-graph': plaintext_tag_rules('graph'),
+        'tag-rss': plaintext_tag_rules('rss'),
+        'tag-math': delegate_tag_rules('math', TexLexer, state='math'),
+        'tag-chem': delegate_tag_rules('chem', TexLexer, state='math'),
+        'tag-ce': delegate_tag_rules('ce', TexLexer, state='math'),
+        'tag-templatedata': delegate_tag_rules('templatedata', JsonLexer),
+        'text-italic': text_rules(Generic.Emph),
+        'text-bold': text_rules(Generic.Strong),
+        'text-bold-italic': text_rules(Generic.EmphStrong),
+        'text': text_rules(Text),
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/math.py b/env/lib/python3.12/site-packages/pygments/lexers/math.py
new file mode 100644
index 0000000..b225ffc
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/math.py
@@ -0,0 +1,21 @@
+"""
+    pygments.lexers.math
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Just export lexers that were contained in this module.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+# ruff: noqa: F401
+from pygments.lexers.python import NumPyLexer
+from pygments.lexers.matlab import MatlabLexer, MatlabSessionLexer, \
+    OctaveLexer, ScilabLexer
+from pygments.lexers.julia import JuliaLexer, JuliaConsoleLexer
+from pygments.lexers.r import RConsoleLexer, SLexer, RdLexer
+from pygments.lexers.modeling import BugsLexer, JagsLexer, StanLexer
+from pygments.lexers.idl import IDLLexer
+from pygments.lexers.algebra import MuPADLexer
+
+__all__ = []
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/matlab.py b/env/lib/python3.12/site-packages/pygments/lexers/matlab.py
new file mode 100644
index 0000000..8eeffc9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/matlab.py
@@ -0,0 +1,3307 @@
+"""
+    pygments.lexers.matlab
+    ~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Matlab and related languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import Lexer, RegexLexer, bygroups, default, words, \
+    do_insertions, include
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Generic, Whitespace
+
+from pygments.lexers import _scilab_builtins
+
+__all__ = ['MatlabLexer', 'MatlabSessionLexer', 'OctaveLexer', 'ScilabLexer']
+
+
+class MatlabLexer(RegexLexer):
+    """
+    For Matlab source code.
+    """
+    name = 'Matlab'
+    aliases = ['matlab']
+    filenames = ['*.m']
+    mimetypes = ['text/matlab']
+    url = 'https://www.mathworks.com/products/matlab.html'
+    version_added = '0.10'
+
+    _operators = r'-|==|~=|<=|>=|<|>|&&|&|~|\|\|?|\.\*|\*|\+|\.\^|\^|\.\\|\./|/|\\'
+
+    tokens = {
+        'expressions': [
+            # operators:
+            (_operators, Operator),
+
+            # numbers (must come before punctuation to handle `.5`; cannot use
+            # `\b` due to e.g. `5. + .5`).  The negative lookahead on operators
+            # avoids including the dot in `1./x` (the dot is part of `./`).
+            (rf'(? and then
+            # (equal | open-parenthesis |  | ).
+            (rf'(?:^|(?<=;))(\s*)(\w+)(\s+)(?!=|\(|{_operators}\s|\s)',
+             bygroups(Whitespace, Name, Whitespace), 'commandargs'),
+
+            include('expressions')
+        ],
+        'blockcomment': [
+            (r'^\s*%\}', Comment.Multiline, '#pop'),
+            (r'^.*\n', Comment.Multiline),
+            (r'.', Comment.Multiline),
+        ],
+        'deffunc': [
+            (r'(\s*)(?:(\S+)(\s*)(=)(\s*))?(.+)(\()(.*)(\))(\s*)',
+             bygroups(Whitespace, Text, Whitespace, Punctuation,
+                      Whitespace, Name.Function, Punctuation, Text,
+                      Punctuation, Whitespace), '#pop'),
+            # function with no args
+            (r'(\s*)([a-zA-Z_]\w*)',
+             bygroups(Whitespace, Name.Function), '#pop'),
+        ],
+        'propattrs': [
+            (r'(\w+)(\s*)(=)(\s*)(\d+)',
+             bygroups(Name.Builtin, Whitespace, Punctuation, Whitespace,
+                      Number)),
+            (r'(\w+)(\s*)(=)(\s*)([a-zA-Z]\w*)',
+             bygroups(Name.Builtin, Whitespace, Punctuation, Whitespace,
+                      Keyword)),
+            (r',', Punctuation),
+            (r'\)', Punctuation, '#pop'),
+            (r'\s+', Whitespace),
+            (r'.', Text),
+        ],
+        'defprops': [
+            (r'%\{\s*\n', Comment.Multiline, 'blockcomment'),
+            (r'%.*$', Comment),
+            (r'(?.
+    """
+    name = 'Matlab session'
+    aliases = ['matlabsession']
+    url = 'https://www.mathworks.com/products/matlab.html'
+    version_added = '0.10'
+    _example = "matlabsession/matlabsession_sample.txt"
+
+    def get_tokens_unprocessed(self, text):
+        mlexer = MatlabLexer(**self.options)
+
+        curcode = ''
+        insertions = []
+        continuation = False
+
+        for match in line_re.finditer(text):
+            line = match.group()
+
+            if line.startswith('>> '):
+                insertions.append((len(curcode),
+                                   [(0, Generic.Prompt, line[:3])]))
+                curcode += line[3:]
+
+            elif line.startswith('>>'):
+                insertions.append((len(curcode),
+                                   [(0, Generic.Prompt, line[:2])]))
+                curcode += line[2:]
+
+            elif line.startswith('???'):
+
+                idx = len(curcode)
+
+                # without is showing error on same line as before...?
+                # line = "\n" + line
+                token = (0, Generic.Traceback, line)
+                insertions.append((idx, [token]))
+            elif continuation and insertions:
+                # line_start is the length of the most recent prompt symbol
+                line_start = len(insertions[-1][-1][-1])
+                # Set leading spaces with the length of the prompt to be a generic prompt
+                # This keeps code aligned when prompts are removed, say with some Javascript
+                if line.startswith(' '*line_start):
+                    insertions.append(
+                        (len(curcode), [(0, Generic.Prompt, line[:line_start])]))
+                    curcode += line[line_start:]
+                else:
+                    curcode += line
+            else:
+                if curcode:
+                    yield from do_insertions(
+                        insertions, mlexer.get_tokens_unprocessed(curcode))
+                    curcode = ''
+                    insertions = []
+
+                yield match.start(), Generic.Output, line
+
+            # Does not allow continuation if a comment is included after the ellipses.
+            # Continues any line that ends with ..., even comments (lines that start with %)
+            if line.strip().endswith('...'):
+                continuation = True
+            else:
+                continuation = False
+
+        if curcode:  # or item:
+            yield from do_insertions(
+                insertions, mlexer.get_tokens_unprocessed(curcode))
+
+
+class OctaveLexer(RegexLexer):
+    """
+    For GNU Octave source code.
+    """
+    name = 'Octave'
+    url = 'https://www.gnu.org/software/octave/index'
+    aliases = ['octave']
+    filenames = ['*.m']
+    mimetypes = ['text/octave']
+    version_added = '1.5'
+
+    # These lists are generated automatically.
+    # Run the following in bash shell:
+    #
+    # First dump all of the Octave manual into a plain text file:
+    #
+    #   $ info octave --subnodes -o octave-manual
+    #
+    # Now grep through it:
+
+    # for i in \
+    #     "Built-in Function" "Command" "Function File" \
+    #     "Loadable Function" "Mapping Function";
+    # do
+    #     perl -e '@name = qw('"$i"');
+    #              print lc($name[0]),"_kw = [\n"';
+    #
+    #     perl -n -e 'print "\"$1\",\n" if /-- '"$i"': .* (\w*) \(/;' \
+    #         octave-manual | sort | uniq ;
+    #     echo "]" ;
+    #     echo;
+    # done
+
+    # taken from Octave Mercurial changeset 8cc154f45e37 (30-jan-2011)
+
+    builtin_kw = (
+        "addlistener", "addpath", "addproperty", "all",
+        "and", "any", "argnames", "argv", "assignin",
+        "atexit", "autoload",
+        "available_graphics_toolkits", "beep_on_error",
+        "bitand", "bitmax", "bitor", "bitshift", "bitxor",
+        "cat", "cell", "cellstr", "char", "class", "clc",
+        "columns", "command_line_path",
+        "completion_append_char", "completion_matches",
+        "complex", "confirm_recursive_rmdir", "cputime",
+        "crash_dumps_octave_core", "ctranspose", "cumprod",
+        "cumsum", "debug_on_error", "debug_on_interrupt",
+        "debug_on_warning", "default_save_options",
+        "dellistener", "diag", "diff", "disp",
+        "doc_cache_file", "do_string_escapes", "double",
+        "drawnow", "e", "echo_executing_commands", "eps",
+        "eq", "errno", "errno_list", "error", "eval",
+        "evalin", "exec", "exist", "exit", "eye", "false",
+        "fclear", "fclose", "fcntl", "fdisp", "feof",
+        "ferror", "feval", "fflush", "fgetl", "fgets",
+        "fieldnames", "file_in_loadpath", "file_in_path",
+        "filemarker", "filesep", "find_dir_in_path",
+        "fixed_point_format", "fnmatch", "fopen", "fork",
+        "formula", "fprintf", "fputs", "fread", "freport",
+        "frewind", "fscanf", "fseek", "fskipl", "ftell",
+        "functions", "fwrite", "ge", "genpath", "get",
+        "getegid", "getenv", "geteuid", "getgid",
+        "getpgrp", "getpid", "getppid", "getuid", "glob",
+        "gt", "gui_mode", "history_control",
+        "history_file", "history_size",
+        "history_timestamp_format_string", "home",
+        "horzcat", "hypot", "ifelse",
+        "ignore_function_time_stamp", "inferiorto",
+        "info_file", "info_program", "inline", "input",
+        "intmax", "intmin", "ipermute",
+        "is_absolute_filename", "isargout", "isbool",
+        "iscell", "iscellstr", "ischar", "iscomplex",
+        "isempty", "isfield", "isfloat", "isglobal",
+        "ishandle", "isieee", "isindex", "isinteger",
+        "islogical", "ismatrix", "ismethod", "isnull",
+        "isnumeric", "isobject", "isreal",
+        "is_rooted_relative_filename", "issorted",
+        "isstruct", "isvarname", "kbhit", "keyboard",
+        "kill", "lasterr", "lasterror", "lastwarn",
+        "ldivide", "le", "length", "link", "linspace",
+        "logical", "lstat", "lt", "make_absolute_filename",
+        "makeinfo_program", "max_recursion_depth", "merge",
+        "methods", "mfilename", "minus", "mislocked",
+        "mkdir", "mkfifo", "mkstemp", "mldivide", "mlock",
+        "mouse_wheel_zoom", "mpower", "mrdivide", "mtimes",
+        "munlock", "nargin", "nargout",
+        "native_float_format", "ndims", "ne", "nfields",
+        "nnz", "norm", "not", "numel", "nzmax",
+        "octave_config_info", "octave_core_file_limit",
+        "octave_core_file_name",
+        "octave_core_file_options", "ones", "or",
+        "output_max_field_width", "output_precision",
+        "page_output_immediately", "page_screen_output",
+        "path", "pathsep", "pause", "pclose", "permute",
+        "pi", "pipe", "plus", "popen", "power",
+        "print_empty_dimensions", "printf",
+        "print_struct_array_contents", "prod",
+        "program_invocation_name", "program_name",
+        "putenv", "puts", "pwd", "quit", "rats", "rdivide",
+        "readdir", "readlink", "read_readline_init_file",
+        "realmax", "realmin", "rehash", "rename",
+        "repelems", "re_read_readline_init_file", "reset",
+        "reshape", "resize", "restoredefaultpath",
+        "rethrow", "rmdir", "rmfield", "rmpath", "rows",
+        "save_header_format_string", "save_precision",
+        "saving_history", "scanf", "set", "setenv",
+        "shell_cmd", "sighup_dumps_octave_core",
+        "sigterm_dumps_octave_core", "silent_functions",
+        "single", "size", "size_equal", "sizemax",
+        "sizeof", "sleep", "source", "sparse_auto_mutate",
+        "split_long_rows", "sprintf", "squeeze", "sscanf",
+        "stat", "stderr", "stdin", "stdout", "strcmp",
+        "strcmpi", "string_fill_char", "strncmp",
+        "strncmpi", "struct", "struct_levels_to_print",
+        "strvcat", "subsasgn", "subsref", "sum", "sumsq",
+        "superiorto", "suppress_verbose_help_message",
+        "symlink", "system", "tic", "tilde_expand",
+        "times", "tmpfile", "tmpnam", "toc", "toupper",
+        "transpose", "true", "typeinfo", "umask", "uminus",
+        "uname", "undo_string_escapes", "unlink", "uplus",
+        "upper", "usage", "usleep", "vec", "vectorize",
+        "vertcat", "waitpid", "warning", "warranty",
+        "whos_line_format", "yes_or_no", "zeros",
+        "inf", "Inf", "nan", "NaN")
+
+    command_kw = ("close", "load", "who", "whos")
+
+    function_kw = (
+        "accumarray", "accumdim", "acosd", "acotd",
+        "acscd", "addtodate", "allchild", "ancestor",
+        "anova", "arch_fit", "arch_rnd", "arch_test",
+        "area", "arma_rnd", "arrayfun", "ascii", "asctime",
+        "asecd", "asind", "assert", "atand",
+        "autoreg_matrix", "autumn", "axes", "axis", "bar",
+        "barh", "bartlett", "bartlett_test", "beep",
+        "betacdf", "betainv", "betapdf", "betarnd",
+        "bicgstab", "bicubic", "binary", "binocdf",
+        "binoinv", "binopdf", "binornd", "bitcmp",
+        "bitget", "bitset", "blackman", "blanks",
+        "blkdiag", "bone", "box", "brighten", "calendar",
+        "cast", "cauchy_cdf", "cauchy_inv", "cauchy_pdf",
+        "cauchy_rnd", "caxis", "celldisp", "center", "cgs",
+        "chisquare_test_homogeneity",
+        "chisquare_test_independence", "circshift", "cla",
+        "clabel", "clf", "clock", "cloglog", "closereq",
+        "colon", "colorbar", "colormap", "colperm",
+        "comet", "common_size", "commutation_matrix",
+        "compan", "compare_versions", "compass",
+        "computer", "cond", "condest", "contour",
+        "contourc", "contourf", "contrast", "conv",
+        "convhull", "cool", "copper", "copyfile", "cor",
+        "corrcoef", "cor_test", "cosd", "cotd", "cov",
+        "cplxpair", "cross", "cscd", "cstrcat", "csvread",
+        "csvwrite", "ctime", "cumtrapz", "curl", "cut",
+        "cylinder", "date", "datenum", "datestr",
+        "datetick", "datevec", "dblquad", "deal",
+        "deblank", "deconv", "delaunay", "delaunayn",
+        "delete", "demo", "detrend", "diffpara", "diffuse",
+        "dir", "discrete_cdf", "discrete_inv",
+        "discrete_pdf", "discrete_rnd", "display",
+        "divergence", "dlmwrite", "dos", "dsearch",
+        "dsearchn", "duplication_matrix", "durbinlevinson",
+        "ellipsoid", "empirical_cdf", "empirical_inv",
+        "empirical_pdf", "empirical_rnd", "eomday",
+        "errorbar", "etime", "etreeplot", "example",
+        "expcdf", "expinv", "expm", "exppdf", "exprnd",
+        "ezcontour", "ezcontourf", "ezmesh", "ezmeshc",
+        "ezplot", "ezpolar", "ezsurf", "ezsurfc", "factor",
+        "factorial", "fail", "fcdf", "feather", "fftconv",
+        "fftfilt", "fftshift", "figure", "fileattrib",
+        "fileparts", "fill", "findall", "findobj",
+        "findstr", "finv", "flag", "flipdim", "fliplr",
+        "flipud", "fpdf", "fplot", "fractdiff", "freqz",
+        "freqz_plot", "frnd", "fsolve",
+        "f_test_regression", "ftp", "fullfile", "fzero",
+        "gamcdf", "gaminv", "gampdf", "gamrnd", "gca",
+        "gcbf", "gcbo", "gcf", "genvarname", "geocdf",
+        "geoinv", "geopdf", "geornd", "getfield", "ginput",
+        "glpk", "gls", "gplot", "gradient",
+        "graphics_toolkit", "gray", "grid", "griddata",
+        "griddatan", "gtext", "gunzip", "gzip", "hadamard",
+        "hamming", "hankel", "hanning", "hggroup",
+        "hidden", "hilb", "hist", "histc", "hold", "hot",
+        "hotelling_test", "housh", "hsv", "hurst",
+        "hygecdf", "hygeinv", "hygepdf", "hygernd",
+        "idivide", "ifftshift", "image", "imagesc",
+        "imfinfo", "imread", "imshow", "imwrite", "index",
+        "info", "inpolygon", "inputname", "interpft",
+        "interpn", "intersect", "invhilb", "iqr", "isa",
+        "isdefinite", "isdir", "is_duplicate_entry",
+        "isequal", "isequalwithequalnans", "isfigure",
+        "ishermitian", "ishghandle", "is_leap_year",
+        "isletter", "ismac", "ismember", "ispc", "isprime",
+        "isprop", "isscalar", "issquare", "isstrprop",
+        "issymmetric", "isunix", "is_valid_file_id",
+        "isvector", "jet", "kendall",
+        "kolmogorov_smirnov_cdf",
+        "kolmogorov_smirnov_test", "kruskal_wallis_test",
+        "krylov", "kurtosis", "laplace_cdf", "laplace_inv",
+        "laplace_pdf", "laplace_rnd", "legend", "legendre",
+        "license", "line", "linkprop", "list_primes",
+        "loadaudio", "loadobj", "logistic_cdf",
+        "logistic_inv", "logistic_pdf", "logistic_rnd",
+        "logit", "loglog", "loglogerr", "logm", "logncdf",
+        "logninv", "lognpdf", "lognrnd", "logspace",
+        "lookfor", "ls_command", "lsqnonneg", "magic",
+        "mahalanobis", "manova", "matlabroot",
+        "mcnemar_test", "mean", "meansq", "median", "menu",
+        "mesh", "meshc", "meshgrid", "meshz", "mexext",
+        "mget", "mkpp", "mode", "moment", "movefile",
+        "mpoles", "mput", "namelengthmax", "nargchk",
+        "nargoutchk", "nbincdf", "nbininv", "nbinpdf",
+        "nbinrnd", "nchoosek", "ndgrid", "newplot", "news",
+        "nonzeros", "normcdf", "normest", "norminv",
+        "normpdf", "normrnd", "now", "nthroot", "null",
+        "ocean", "ols", "onenormest", "optimget",
+        "optimset", "orderfields", "orient", "orth",
+        "pack", "pareto", "parseparams", "pascal", "patch",
+        "pathdef", "pcg", "pchip", "pcolor", "pcr",
+        "peaks", "periodogram", "perl", "perms", "pie",
+        "pink", "planerot", "playaudio", "plot",
+        "plotmatrix", "plotyy", "poisscdf", "poissinv",
+        "poisspdf", "poissrnd", "polar", "poly",
+        "polyaffine", "polyarea", "polyderiv", "polyfit",
+        "polygcd", "polyint", "polyout", "polyreduce",
+        "polyval", "polyvalm", "postpad", "powerset",
+        "ppder", "ppint", "ppjumps", "ppplot", "ppval",
+        "pqpnonneg", "prepad", "primes", "print",
+        "print_usage", "prism", "probit", "qp", "qqplot",
+        "quadcc", "quadgk", "quadl", "quadv", "quiver",
+        "qzhess", "rainbow", "randi", "range", "rank",
+        "ranks", "rat", "reallog", "realpow", "realsqrt",
+        "record", "rectangle_lw", "rectangle_sw",
+        "rectint", "refresh", "refreshdata",
+        "regexptranslate", "repmat", "residue", "ribbon",
+        "rindex", "roots", "rose", "rosser", "rotdim",
+        "rref", "run", "run_count", "rundemos", "run_test",
+        "runtests", "saveas", "saveaudio", "saveobj",
+        "savepath", "scatter", "secd", "semilogx",
+        "semilogxerr", "semilogy", "semilogyerr",
+        "setaudio", "setdiff", "setfield", "setxor",
+        "shading", "shift", "shiftdim", "sign_test",
+        "sinc", "sind", "sinetone", "sinewave", "skewness",
+        "slice", "sombrero", "sortrows", "spaugment",
+        "spconvert", "spdiags", "spearman", "spectral_adf",
+        "spectral_xdf", "specular", "speed", "spencer",
+        "speye", "spfun", "sphere", "spinmap", "spline",
+        "spones", "sprand", "sprandn", "sprandsym",
+        "spring", "spstats", "spy", "sqp", "stairs",
+        "statistics", "std", "stdnormal_cdf",
+        "stdnormal_inv", "stdnormal_pdf", "stdnormal_rnd",
+        "stem", "stft", "strcat", "strchr", "strjust",
+        "strmatch", "strread", "strsplit", "strtok",
+        "strtrim", "strtrunc", "structfun", "studentize",
+        "subplot", "subsindex", "subspace", "substr",
+        "substruct", "summer", "surf", "surface", "surfc",
+        "surfl", "surfnorm", "svds", "swapbytes",
+        "sylvester_matrix", "symvar", "synthesis", "table",
+        "tand", "tar", "tcdf", "tempdir", "tempname",
+        "test", "text", "textread", "textscan", "tinv",
+        "title", "toeplitz", "tpdf", "trace", "trapz",
+        "treelayout", "treeplot", "triangle_lw",
+        "triangle_sw", "tril", "trimesh", "triplequad",
+        "triplot", "trisurf", "triu", "trnd", "tsearchn",
+        "t_test", "t_test_regression", "type", "unidcdf",
+        "unidinv", "unidpdf", "unidrnd", "unifcdf",
+        "unifinv", "unifpdf", "unifrnd", "union", "unique",
+        "unix", "unmkpp", "unpack", "untabify", "untar",
+        "unwrap", "unzip", "u_test", "validatestring",
+        "vander", "var", "var_test", "vech", "ver",
+        "version", "view", "voronoi", "voronoin",
+        "waitforbuttonpress", "wavread", "wavwrite",
+        "wblcdf", "wblinv", "wblpdf", "wblrnd", "weekday",
+        "welch_test", "what", "white", "whitebg",
+        "wienrnd", "wilcoxon_test", "wilkinson", "winter",
+        "xlabel", "xlim", "ylabel", "yulewalker", "zip",
+        "zlabel", "z_test")
+
+    loadable_kw = (
+        "airy", "amd", "balance", "besselh", "besseli",
+        "besselj", "besselk", "bessely", "bitpack",
+        "bsxfun", "builtin", "ccolamd", "cellfun",
+        "cellslices", "chol", "choldelete", "cholinsert",
+        "cholinv", "cholshift", "cholupdate", "colamd",
+        "colloc", "convhulln", "convn", "csymamd",
+        "cummax", "cummin", "daspk", "daspk_options",
+        "dasrt", "dasrt_options", "dassl", "dassl_options",
+        "dbclear", "dbdown", "dbstack", "dbstatus",
+        "dbstop", "dbtype", "dbup", "dbwhere", "det",
+        "dlmread", "dmperm", "dot", "eig", "eigs",
+        "endgrent", "endpwent", "etree", "fft", "fftn",
+        "fftw", "filter", "find", "full", "gcd",
+        "getgrent", "getgrgid", "getgrnam", "getpwent",
+        "getpwnam", "getpwuid", "getrusage", "givens",
+        "gmtime", "gnuplot_binary", "hess", "ifft",
+        "ifftn", "inv", "isdebugmode", "issparse", "kron",
+        "localtime", "lookup", "lsode", "lsode_options",
+        "lu", "luinc", "luupdate", "matrix_type", "max",
+        "min", "mktime", "pinv", "qr", "qrdelete",
+        "qrinsert", "qrshift", "qrupdate", "quad",
+        "quad_options", "qz", "rand", "rande", "randg",
+        "randn", "randp", "randperm", "rcond", "regexp",
+        "regexpi", "regexprep", "schur", "setgrent",
+        "setpwent", "sort", "spalloc", "sparse", "spparms",
+        "sprank", "sqrtm", "strfind", "strftime",
+        "strptime", "strrep", "svd", "svd_driver", "syl",
+        "symamd", "symbfact", "symrcm", "time", "tsearch",
+        "typecast", "urlread", "urlwrite")
+
+    mapping_kw = (
+        "abs", "acos", "acosh", "acot", "acoth", "acsc",
+        "acsch", "angle", "arg", "asec", "asech", "asin",
+        "asinh", "atan", "atanh", "beta", "betainc",
+        "betaln", "bincoeff", "cbrt", "ceil", "conj", "cos",
+        "cosh", "cot", "coth", "csc", "csch", "erf", "erfc",
+        "erfcx", "erfinv", "exp", "finite", "fix", "floor",
+        "fmod", "gamma", "gammainc", "gammaln", "imag",
+        "isalnum", "isalpha", "isascii", "iscntrl",
+        "isdigit", "isfinite", "isgraph", "isinf",
+        "islower", "isna", "isnan", "isprint", "ispunct",
+        "isspace", "isupper", "isxdigit", "lcm", "lgamma",
+        "log", "lower", "mod", "real", "rem", "round",
+        "roundb", "sec", "sech", "sign", "sin", "sinh",
+        "sqrt", "tan", "tanh", "toascii", "tolower", "xor")
+
+    builtin_consts = (
+        "EDITOR", "EXEC_PATH", "I", "IMAGE_PATH", "NA",
+        "OCTAVE_HOME", "OCTAVE_VERSION", "PAGER",
+        "PAGER_FLAGS", "SEEK_CUR", "SEEK_END", "SEEK_SET",
+        "SIG", "S_ISBLK", "S_ISCHR", "S_ISDIR", "S_ISFIFO",
+        "S_ISLNK", "S_ISREG", "S_ISSOCK", "WCONTINUE",
+        "WCOREDUMP", "WEXITSTATUS", "WIFCONTINUED",
+        "WIFEXITED", "WIFSIGNALED", "WIFSTOPPED", "WNOHANG",
+        "WSTOPSIG", "WTERMSIG", "WUNTRACED")
+
+    tokens = {
+        'root': [
+            (r'%\{\s*\n', Comment.Multiline, 'percentblockcomment'),
+            (r'#\{\s*\n', Comment.Multiline, 'hashblockcomment'),
+            (r'[%#].*$', Comment),
+            (r'^\s*function\b', Keyword, 'deffunc'),
+
+            # from 'iskeyword' on hg changeset 8cc154f45e37
+            (words((
+                '__FILE__', '__LINE__', 'break', 'case', 'catch', 'classdef',
+                'continue', 'do', 'else', 'elseif', 'end', 'end_try_catch',
+                'end_unwind_protect', 'endclassdef', 'endevents', 'endfor',
+                'endfunction', 'endif', 'endmethods', 'endproperties', 'endswitch',
+                'endwhile', 'events', 'for', 'function', 'get', 'global', 'if',
+                'methods', 'otherwise', 'persistent', 'properties', 'return',
+                'set', 'static', 'switch', 'try', 'until', 'unwind_protect',
+                'unwind_protect_cleanup', 'while'), suffix=r'\b'),
+             Keyword),
+
+            (words(builtin_kw + command_kw + function_kw + loadable_kw + mapping_kw,
+                   suffix=r'\b'),  Name.Builtin),
+
+            (words(builtin_consts, suffix=r'\b'), Name.Constant),
+
+            # operators in Octave but not Matlab:
+            (r'-=|!=|!|/=|--', Operator),
+            # operators:
+            (r'-|==|~=|<|>|<=|>=|&&|&|~|\|\|?', Operator),
+            # operators in Octave but not Matlab requiring escape for re:
+            (r'\*=|\+=|\^=|\/=|\\=|\*\*|\+\+|\.\*\*', Operator),
+            # operators requiring escape for re:
+            (r'\.\*|\*|\+|\.\^|\^|\.\\|\.\/|\/|\\', Operator),
+
+
+            # punctuation:
+            (r'[\[\](){}:@.,]', Punctuation),
+            (r'=|:|;', Punctuation),
+
+            (r'"[^"]*"', String),
+
+            (r'(\d+\.\d*|\d*\.\d+)([eEf][+-]?[0-9]+)?', Number.Float),
+            (r'\d+[eEf][+-]?[0-9]+', Number.Float),
+            (r'\d+', Number.Integer),
+
+            # quote can be transpose, instead of string:
+            # (not great, but handles common cases...)
+            (r'(?<=[\w)\].])\'+', Operator),
+            (r'(?|<=|>=|&&|&|~|\|\|?', Operator),
+            # operators requiring escape for re:
+            (r'\.\*|\*|\+|\.\^|\^|\.\\|\.\/|\/|\\', Operator),
+
+            # punctuation:
+            (r'[\[\](){}@.,=:;]+', Punctuation),
+
+            (r'"[^"]*"', String),
+
+            # quote can be transpose, instead of string:
+            # (not great, but handles common cases...)
+            (r'(?<=[\w)\].])\'+', Operator),
+            (r'(?', r'<', r'|', r'!', r"'")
+
+    operator_words = ('and', 'or', 'not')
+
+    tokens = {
+        'root': [
+            (r'/\*', Comment.Multiline, 'comment'),
+            (r'"(?:[^"\\]|\\.)*"', String),
+            (r'\(|\)|\[|\]|\{|\}', Punctuation),
+            (r'[,;$]', Punctuation),
+            (words (constants), Name.Constant),
+            (words (keywords), Keyword),
+            (words (operators), Operator),
+            (words (operator_words), Operator.Word),
+            (r'''(?x)
+              ((?:[a-zA-Z_#][\w#]*|`[^`]*`)
+              (?:::[a-zA-Z_#][\w#]*|`[^`]*`)*)(\s*)([(])''',
+             bygroups(Name.Function, Text.Whitespace, Punctuation)),
+            (r'''(?x)
+              (?:[a-zA-Z_#%][\w#%]*|`[^`]*`)
+              (?:::[a-zA-Z_#%][\w#%]*|`[^`]*`)*''', Name.Variable),
+            (r'[-+]?(\d*\.\d+([bdefls][-+]?\d+)?|\d+(\.\d*)?[bdefls][-+]?\d+)', Number.Float),
+            (r'[-+]?\d+', Number.Integer),
+            (r'\s+', Text.Whitespace),
+            (r'.', Text)
+        ],
+        'comment': [
+            (r'[^*/]+', Comment.Multiline),
+            (r'/\*', Comment.Multiline, '#push'),
+            (r'\*/', Comment.Multiline, '#pop'),
+            (r'[*/]', Comment.Multiline)
+        ]
+    }
+
+    def analyse_text (text):
+        strength = 0.0
+        # Input expression terminator.
+        if re.search (r'\$\s*$', text, re.MULTILINE):
+            strength += 0.05
+        # Function definition operator.
+        if ':=' in text:
+            strength += 0.02
+        return strength
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/meson.py b/env/lib/python3.12/site-packages/pygments/lexers/meson.py
new file mode 100644
index 0000000..6f2c6da
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/meson.py
@@ -0,0 +1,139 @@
+"""
+    pygments.lexers.meson
+    ~~~~~~~~~~~~~~~~~~~~~
+
+    Pygments lexer for the Meson build system
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, words, include
+from pygments.token import Comment, Name, Number, Punctuation, Operator, \
+    Keyword, String, Whitespace
+
+__all__ = ['MesonLexer']
+
+
+class MesonLexer(RegexLexer):
+    """Meson language lexer.
+
+    The grammar definition use to transcribe the syntax was retrieved from
+    https://mesonbuild.com/Syntax.html#grammar for version 0.58.
+    Some of those definitions are improperly transcribed, so the Meson++
+    implementation was also checked: https://github.com/dcbaker/meson-plus-plus.
+    """
+
+    # TODO String interpolation @VARNAME@ inner matches
+    # TODO keyword_arg: value inner matches
+
+    name = 'Meson'
+    url = 'https://mesonbuild.com/'
+    aliases = ['meson', 'meson.build']
+    filenames = ['meson.build', 'meson_options.txt']
+    mimetypes = ['text/x-meson']
+    version_added = '2.10'
+
+    tokens = {
+        'root': [
+            (r'#.*?$', Comment),
+            (r"'''.*'''", String.Single),
+            (r'[1-9][0-9]*', Number.Integer),
+            (r'0o[0-7]+', Number.Oct),
+            (r'0x[a-fA-F0-9]+', Number.Hex),
+            include('string'),
+            include('keywords'),
+            include('expr'),
+            (r'[a-zA-Z_][a-zA-Z_0-9]*', Name),
+            (r'\s+', Whitespace),
+        ],
+        'string': [
+            (r"[']{3}([']{0,2}([^\\']|\\(.|\n)))*[']{3}", String),
+            (r"'.*?(?`_.
+    """
+
+    name = "MCFunction"
+    url = "https://minecraft.wiki/w/Commands"
+    aliases = ["mcfunction", "mcf"]
+    filenames = ["*.mcfunction"]
+    mimetypes = ["text/mcfunction"]
+    version_added = '2.12'
+
+    # Used to denotate the start of a block comment, borrowed from Github's mcfunction
+    _block_comment_prefix = "[>!]"
+
+    tokens = {
+        "root": [
+            include("names"),
+            include("comments"),
+            include("literals"),
+            include("whitespace"),
+            include("property"),
+            include("operators"),
+            include("selectors"),
+        ],
+
+        "names": [
+            # The start of a command (either beginning of line OR after the run keyword)
+            #  We don't encode a list of keywords since mods, plugins, or even pre-processors
+            #  may add new commands, so we have a 'close-enough' regex which catches them.
+            (r"^(\s*)([a-z_]+)", bygroups(Whitespace, Name.Builtin)),
+            (r"(?<=run)\s+[a-z_]+", Name.Builtin),
+
+            # UUID
+            (r"\b[0-9a-fA-F]+(?:-[0-9a-fA-F]+){4}\b", Name.Variable),
+            include("resource-name"),
+            # normal command names and scoreboards
+            #  there's no way to know the differences unfortuntely
+            (r"[A-Za-z_][\w.#%$]+", Keyword.Constant),
+            (r"[#%$][\w.#%$]+", Name.Variable.Magic),
+        ],
+
+        "resource-name": [
+            # resource names have to be lowercase
+            (r"#?[a-z_][a-z_.-]*:[a-z0-9_./-]+", Name.Function),
+            # similar to above except optional `:``
+            #  a `/` must be present "somewhere"
+            (r"#?[a-z0-9_\.\-]+\/[a-z0-9_\.\-\/]+", Name.Function),
+        ],
+
+        "whitespace": [
+            (r"\s+", Whitespace),
+        ],
+
+        "comments": [
+            (rf"^\s*(#{_block_comment_prefix})", Comment.Multiline,
+             ("comments.block", "comments.block.emphasized")),
+            (r"#.*$", Comment.Single),
+        ],
+        "comments.block": [
+            (rf"^\s*#{_block_comment_prefix}", Comment.Multiline,
+             "comments.block.emphasized"),
+            (r"^\s*#", Comment.Multiline, "comments.block.normal"),
+            default("#pop"),
+        ],
+        "comments.block.normal": [
+            include("comments.block.special"),
+            (r"\S+", Comment.Multiline),
+            (r"\n", Text, "#pop"),
+            include("whitespace"),
+        ],
+        "comments.block.emphasized": [
+            include("comments.block.special"),
+            (r"\S+", String.Doc),
+            (r"\n", Text, "#pop"),
+            include("whitespace"),
+        ],
+        "comments.block.special": [
+            # Params
+            (r"@\S+", Name.Decorator),
+
+            include("resource-name"),
+
+            # Scoreboard player names
+            (r"[#%$][\w.#%$]+", Name.Variable.Magic),
+        ],
+
+        "operators": [
+            (r"[\-~%^?!+*<>\\/|&=.]", Operator),
+        ],
+
+        "literals": [
+            (r"\.\.", Literal),
+            (r"(true|false)", Keyword.Pseudo),
+
+            # these are like unquoted strings and appear in many places
+            (r"[A-Za-z_]+", Name.Variable.Class),
+
+            (r"[0-7]b", Number.Byte),
+            (r"[+-]?\d*\.?\d+([eE]?[+-]?\d+)?[df]?\b", Number.Float),
+            (r"[+-]?\d+\b", Number.Integer),
+            (r'"', String.Double, "literals.string-double"),
+            (r"'", String.Single, "literals.string-single"),
+        ],
+        "literals.string-double": [
+            (r"\\.", String.Escape),
+            (r'[^\\"\n]+', String.Double),
+            (r'"', String.Double, "#pop"),
+        ],
+        "literals.string-single": [
+            (r"\\.", String.Escape),
+            (r"[^\\'\n]+", String.Single),
+            (r"'", String.Single, "#pop"),
+        ],
+
+        "selectors": [
+            (r"@[a-z]", Name.Variable),
+        ],
+
+
+        ## Generic Property Container
+        # There are several, differing instances where the language accepts
+        #  specific contained keys or contained key, value pairings.
+        #
+        # Property Maps:
+        # - Starts with either `[` or `{`
+        # - Key separated by `:` or `=`
+        # - Deliminated by `,`
+        #
+        # Property Lists:
+        # - Starts with `[`
+        # - Deliminated by `,`
+        #
+        # For simplicity, these patterns match a generic, nestable structure
+        #  which follow a key, value pattern. For normal lists, there's only keys.
+        # This allow some "illegal" structures, but we'll accept those for
+        #  sake of simplicity
+        #
+        # Examples:
+        # - `[facing=up, powered=true]` (blockstate)
+        # - `[name="hello world", nbt={key: 1b}]` (selector + nbt)
+        # - `[{"text": "value"}, "literal"]` (json)
+        ##
+        "property": [
+            # This state gets included in root and also several substates
+            # We do this to shortcut the starting of new properties
+            #  within other properties. Lists can have sublists and compounds
+            #  and values can start a new property (see the `difficult_1.txt`
+            #  snippet).
+            (r"\{", Punctuation, ("property.curly", "property.key")),
+            (r"\[", Punctuation, ("property.square", "property.key")),
+        ],
+        "property.curly": [
+            include("whitespace"),
+            include("property"),
+            (r"\}", Punctuation, "#pop"),
+        ],
+        "property.square": [
+            include("whitespace"),
+            include("property"),
+            (r"\]", Punctuation, "#pop"),
+
+            # lists can have sequences of items
+            (r",", Punctuation),
+        ],
+        "property.key": [
+            include("whitespace"),
+
+            # resource names (for advancements)
+            #  can omit `:` to default `minecraft:`
+            # must check if there is a future equals sign if `:` is in the name
+            (r"#?[a-z_][a-z_\.\-]*\:[a-z0-9_\.\-/]+(?=\s*\=)", Name.Attribute, "property.delimiter"),
+            (r"#?[a-z_][a-z0-9_\.\-/]+", Name.Attribute, "property.delimiter"),
+
+            # unquoted NBT key
+            (r"[A-Za-z_\-\+]+", Name.Attribute, "property.delimiter"),
+
+            # quoted JSON or NBT key
+            (r'"', Name.Attribute, "property.delimiter", "literals.string-double"),
+            (r"'", Name.Attribute, "property.delimiter", "literals.string-single"),
+
+            # index for a list
+            (r"-?\d+", Number.Integer, "property.delimiter"),
+
+            default("#pop"),
+        ],
+        "property.key.string-double": [
+            (r"\\.", String.Escape),
+            (r'[^\\"\n]+', Name.Attribute),
+            (r'"', Name.Attribute, "#pop"),
+        ],
+        "property.key.string-single": [
+            (r"\\.", String.Escape),
+            (r"[^\\'\n]+", Name.Attribute),
+            (r"'", Name.Attribute, "#pop"),
+        ],
+        "property.delimiter": [
+            include("whitespace"),
+
+            (r"[:=]!?", Punctuation, "property.value"),
+            (r",", Punctuation),
+
+            default("#pop"),
+        ],
+        "property.value": [
+            include("whitespace"),
+
+            # unquoted resource names are valid literals here
+            (r"#?[a-z_][a-z_\.\-]*\:[a-z0-9_\.\-/]+", Name.Tag),
+            (r"#?[a-z_][a-z0-9_\.\-/]+", Name.Tag),
+
+            include("literals"),
+            include("property"),
+
+            default("#pop"),
+        ],
+    }
+
+
+class MCSchemaLexer(RegexLexer):
+    """Lexer for Minecraft Add-ons data Schemas, an interface structure standard used in Minecraft
+    """
+
+    name = 'MCSchema'
+    url = 'https://learn.microsoft.com/en-us/minecraft/creator/reference/content/schemasreference/'
+    aliases = ['mcschema']
+    filenames = ['*.mcschema']
+    mimetypes = ['text/mcschema']
+    version_added = '2.14'
+
+    tokens = {
+        'commentsandwhitespace': [
+            (r'\s+', Whitespace),
+            (r'//.*?$', Comment.Single),
+            (r'/\*.*?\*/', Comment.Multiline)
+        ],
+        'slashstartsregex': [
+            include('commentsandwhitespace'),
+            (r'/(\\.|[^[/\\\n]|\[(\\.|[^\]\\\n])*])+/'
+             r'([gimuysd]+\b|\B)', String.Regex, '#pop'),
+            (r'(?=/)', Text, ('#pop', 'badregex')),
+            default('#pop')
+        ],
+        'badregex': [
+            (r'\n', Whitespace, '#pop')
+        ],
+        'singlestring': [
+            (r'\\.', String.Escape),
+            (r"'", String.Single, '#pop'),
+            (r"[^\\']+", String.Single),
+        ],
+        'doublestring': [
+            (r'\\.', String.Escape),
+            (r'"', String.Double, '#pop'),
+            (r'[^\\"]+', String.Double),
+        ],
+        'root': [
+            (r'^(?=\s|/|', Comment, '#pop'),
+            (r'[^\-]+|-', Comment),
+        ],
+    }
+
+
+class ReasonLexer(RegexLexer):
+    """
+    For the ReasonML language.
+    """
+
+    name = 'ReasonML'
+    url = 'https://reasonml.github.io/'
+    aliases = ['reasonml', 'reason']
+    filenames = ['*.re', '*.rei']
+    mimetypes = ['text/x-reasonml']
+    version_added = '2.6'
+
+    keywords = (
+        'as', 'assert', 'begin', 'class', 'constraint', 'do', 'done', 'downto',
+        'else', 'end', 'exception', 'external', 'false', 'for', 'fun', 'esfun',
+        'function', 'functor', 'if', 'in', 'include', 'inherit', 'initializer', 'lazy',
+        'let', 'switch', 'module', 'pub', 'mutable', 'new', 'nonrec', 'object', 'of',
+        'open', 'pri', 'rec', 'sig', 'struct', 'then', 'to', 'true', 'try',
+        'type', 'val', 'virtual', 'when', 'while', 'with',
+    )
+    keyopts = (
+        '!=', '#', '&', '&&', r'\(', r'\)', r'\*', r'\+', ',', '-',
+        r'-\.', '=>', r'\.', r'\.\.', r'\.\.\.', ':', '::', ':=', ':>', ';', ';;', '<',
+        '<-', '=', '>', '>]', r'>\}', r'\?', r'\?\?', r'\[', r'\[<', r'\[>',
+        r'\[\|', ']', '_', '`', r'\{', r'\{<', r'\|', r'\|\|', r'\|]', r'\}', '~'
+    )
+
+    operators = r'[!$%&*+\./:<=>?@^|~-]'
+    word_operators = ('and', 'asr', 'land', 'lor', 'lsl', 'lsr', 'lxor', 'mod', 'or')
+    prefix_syms = r'[!?~]'
+    infix_syms = r'[=<>@^|&+\*/$%-]'
+    primitives = ('unit', 'int', 'float', 'bool', 'string', 'char', 'list', 'array')
+
+    tokens = {
+        'escape-sequence': [
+            (r'\\[\\"\'ntbr]', String.Escape),
+            (r'\\[0-9]{3}', String.Escape),
+            (r'\\x[0-9a-fA-F]{2}', String.Escape),
+        ],
+        'root': [
+            (r'\s+', Text),
+            (r'false|true|\(\)|\[\]', Name.Builtin.Pseudo),
+            (r'\b([A-Z][\w\']*)(?=\s*\.)', Name.Namespace, 'dotted'),
+            (r'\b([A-Z][\w\']*)', Name.Class),
+            (r'//.*?\n', Comment.Single),
+            (r'\/\*(?!/)', Comment.Multiline, 'comment'),
+            (r'\b({})\b'.format('|'.join(keywords)), Keyword),
+            (r'({})'.format('|'.join(keyopts[::-1])), Operator.Word),
+            (rf'({infix_syms}|{prefix_syms})?{operators}', Operator),
+            (r'\b({})\b'.format('|'.join(word_operators)), Operator.Word),
+            (r'\b({})\b'.format('|'.join(primitives)), Keyword.Type),
+
+            (r"[^\W\d][\w']*", Name),
+
+            (r'-?\d[\d_]*(.[\d_]*)?([eE][+\-]?\d[\d_]*)', Number.Float),
+            (r'0[xX][\da-fA-F][\da-fA-F_]*', Number.Hex),
+            (r'0[oO][0-7][0-7_]*', Number.Oct),
+            (r'0[bB][01][01_]*', Number.Bin),
+            (r'\d[\d_]*', Number.Integer),
+
+            (r"'(?:(\\[\\\"'ntbr ])|(\\[0-9]{3})|(\\x[0-9a-fA-F]{2}))'",
+             String.Char),
+            (r"'.'", String.Char),
+            (r"'", Keyword),
+
+            (r'"', String.Double, 'string'),
+
+            (r'[~?][a-z][\w\']*:', Name.Variable),
+        ],
+        'comment': [
+            (r'[^/*]+', Comment.Multiline),
+            (r'\/\*', Comment.Multiline, '#push'),
+            (r'\*\/', Comment.Multiline, '#pop'),
+            (r'\*', Comment.Multiline),
+        ],
+        'string': [
+            (r'[^\\"]+', String.Double),
+            include('escape-sequence'),
+            (r'\\\n', String.Double),
+            (r'"', String.Double, '#pop'),
+        ],
+        'dotted': [
+            (r'\s+', Text),
+            (r'\.', Punctuation),
+            (r'[A-Z][\w\']*(?=\s*\.)', Name.Namespace),
+            (r'[A-Z][\w\']*', Name.Class, '#pop'),
+            (r'[a-z_][\w\']*', Name, '#pop'),
+            default('#pop'),
+        ],
+    }
+
+
+class FStarLexer(RegexLexer):
+    """
+    For the F* language.
+    """
+
+    name = 'FStar'
+    url = 'https://www.fstar-lang.org/'
+    aliases = ['fstar']
+    filenames = ['*.fst', '*.fsti']
+    mimetypes = ['text/x-fstar']
+    version_added = '2.7'
+
+    keywords = (
+        'abstract', 'attributes', 'noeq', 'unopteq', 'and'
+        'begin', 'by', 'default', 'effect', 'else', 'end', 'ensures',
+        'exception', 'exists', 'false', 'forall', 'fun', 'function', 'if',
+        'in', 'include', 'inline', 'inline_for_extraction', 'irreducible',
+        'logic', 'match', 'module', 'mutable', 'new', 'new_effect', 'noextract',
+        'of', 'open', 'opaque', 'private', 'range_of', 'reifiable',
+        'reify', 'reflectable', 'requires', 'set_range_of', 'sub_effect',
+        'synth', 'then', 'total', 'true', 'try', 'type', 'unfold', 'unfoldable',
+        'val', 'when', 'with', 'not'
+    )
+    decl_keywords = ('let', 'rec')
+    assume_keywords = ('assume', 'admit', 'assert', 'calc')
+    keyopts = (
+        r'~', r'-', r'/\\', r'\\/', r'<:', r'<@', r'\(\|', r'\|\)', r'#', r'u#',
+        r'&', r'\(', r'\)', r'\(\)', r',', r'~>', r'->', r'<-', r'<--', r'<==>',
+        r'==>', r'\.', r'\?', r'\?\.', r'\.\[', r'\.\(', r'\.\(\|', r'\.\[\|',
+        r'\{:pattern', r':', r'::', r':=', r';', r';;', r'=', r'%\[', r'!\{',
+        r'\[', r'\[@', r'\[\|', r'\|>', r'\]', r'\|\]', r'\{', r'\|', r'\}', r'\$'
+    )
+
+    operators = r'[!$%&*+\./:<=>?@^|~-]'
+    prefix_syms = r'[!?~]'
+    infix_syms = r'[=<>@^|&+\*/$%-]'
+    primitives = ('unit', 'int', 'float', 'bool', 'string', 'char', 'list', 'array')
+
+    tokens = {
+        'escape-sequence': [
+            (r'\\[\\"\'ntbr]', String.Escape),
+            (r'\\[0-9]{3}', String.Escape),
+            (r'\\x[0-9a-fA-F]{2}', String.Escape),
+        ],
+        'root': [
+            (r'\s+', Text),
+            (r'false|true|False|True|\(\)|\[\]', Name.Builtin.Pseudo),
+            (r'\b([A-Z][\w\']*)(?=\s*\.)', Name.Namespace, 'dotted'),
+            (r'\b([A-Z][\w\']*)', Name.Class),
+            (r'\(\*(?![)])', Comment, 'comment'),
+            (r'\/\/.+$', Comment),
+            (r'\b({})\b'.format('|'.join(keywords)), Keyword),
+            (r'\b({})\b'.format('|'.join(assume_keywords)), Name.Exception),
+            (r'\b({})\b'.format('|'.join(decl_keywords)), Keyword.Declaration),
+            (r'({})'.format('|'.join(keyopts[::-1])), Operator),
+            (rf'({infix_syms}|{prefix_syms})?{operators}', Operator),
+            (r'\b({})\b'.format('|'.join(primitives)), Keyword.Type),
+
+            (r"[^\W\d][\w']*", Name),
+
+            (r'-?\d[\d_]*(.[\d_]*)?([eE][+\-]?\d[\d_]*)', Number.Float),
+            (r'0[xX][\da-fA-F][\da-fA-F_]*', Number.Hex),
+            (r'0[oO][0-7][0-7_]*', Number.Oct),
+            (r'0[bB][01][01_]*', Number.Bin),
+            (r'\d[\d_]*', Number.Integer),
+
+            (r"'(?:(\\[\\\"'ntbr ])|(\\[0-9]{3})|(\\x[0-9a-fA-F]{2}))'",
+             String.Char),
+            (r"'.'", String.Char),
+            (r"'", Keyword),  # a stray quote is another syntax element
+            (r"\`([\w\'.]+)\`", Operator.Word),  # for infix applications
+            (r"\`", Keyword),  # for quoting
+            (r'"', String.Double, 'string'),
+
+            (r'[~?][a-z][\w\']*:', Name.Variable),
+        ],
+        'comment': [
+            (r'[^(*)]+', Comment),
+            (r'\(\*', Comment, '#push'),
+            (r'\*\)', Comment, '#pop'),
+            (r'[(*)]', Comment),
+        ],
+        'string': [
+            (r'[^\\"]+', String.Double),
+            include('escape-sequence'),
+            (r'\\\n', String.Double),
+            (r'"', String.Double, '#pop'),
+        ],
+        'dotted': [
+            (r'\s+', Text),
+            (r'\.', Punctuation),
+            (r'[A-Z][\w\']*(?=\s*\.)', Name.Namespace),
+            (r'[A-Z][\w\']*', Name.Class, '#pop'),
+            (r'[a-z_][\w\']*', Name, '#pop'),
+            default('#pop'),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/modeling.py b/env/lib/python3.12/site-packages/pygments/lexers/modeling.py
new file mode 100644
index 0000000..d681e7f
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/modeling.py
@@ -0,0 +1,366 @@
+"""
+    pygments.lexers.modeling
+    ~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for modeling languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, include, bygroups, using, default
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Whitespace
+
+from pygments.lexers.html import HtmlLexer
+from pygments.lexers import _stan_builtins
+
+__all__ = ['ModelicaLexer', 'BugsLexer', 'JagsLexer', 'StanLexer']
+
+
+class ModelicaLexer(RegexLexer):
+    """
+    For Modelica source code.
+    """
+    name = 'Modelica'
+    url = 'http://www.modelica.org/'
+    aliases = ['modelica']
+    filenames = ['*.mo']
+    mimetypes = ['text/x-modelica']
+    version_added = '1.1'
+
+    flags = re.DOTALL | re.MULTILINE
+
+    _name = r"(?:'(?:[^\\']|\\.)+'|[a-zA-Z_]\w*)"
+
+    tokens = {
+        'whitespace': [
+            (r'[\s\ufeff]+', Text),
+            (r'//[^\n]*\n?', Comment.Single),
+            (r'/\*.*?\*/', Comment.Multiline)
+        ],
+        'root': [
+            include('whitespace'),
+            (r'"', String.Double, 'string'),
+            (r'[()\[\]{},;]+', Punctuation),
+            (r'\.?[*^/+-]|\.|<>|[<>:=]=?', Operator),
+            (r'\d+(\.?\d*[eE][-+]?\d+|\.\d*)', Number.Float),
+            (r'\d+', Number.Integer),
+            (r'(abs|acos|actualStream|array|asin|assert|AssertionLevel|atan|'
+             r'atan2|backSample|Boolean|cardinality|cat|ceil|change|Clock|'
+             r'Connections|cos|cosh|cross|delay|diagonal|div|edge|exp|'
+             r'ExternalObject|fill|floor|getInstanceName|hold|homotopy|'
+             r'identity|inStream|integer|Integer|interval|inverse|isPresent|'
+             r'linspace|log|log10|matrix|max|min|mod|ndims|noClock|noEvent|'
+             r'ones|outerProduct|pre|previous|product|Real|reinit|rem|rooted|'
+             r'sample|scalar|semiLinear|shiftSample|sign|sin|sinh|size|skew|'
+             r'smooth|spatialDistribution|sqrt|StateSelect|String|subSample|'
+             r'sum|superSample|symmetric|tan|tanh|terminal|terminate|time|'
+             r'transpose|vector|zeros)\b', Name.Builtin),
+            (r'(algorithm|annotation|break|connect|constant|constrainedby|der|'
+             r'discrete|each|else|elseif|elsewhen|encapsulated|enumeration|'
+             r'equation|exit|expandable|extends|external|firstTick|final|flow|for|if|'
+             r'import|impure|in|initial|inner|input|interval|loop|nondiscrete|outer|'
+             r'output|parameter|partial|protected|public|pure|redeclare|'
+             r'replaceable|return|stream|then|when|while)\b',
+             Keyword.Reserved),
+            (r'(and|not|or)\b', Operator.Word),
+            (r'(block|class|connector|end|function|model|operator|package|'
+             r'record|type)\b', Keyword.Reserved, 'class'),
+            (r'(false|true)\b', Keyword.Constant),
+            (r'within\b', Keyword.Reserved, 'package-prefix'),
+            (_name, Name)
+        ],
+        'class': [
+            include('whitespace'),
+            (r'(function|record)\b', Keyword.Reserved),
+            (r'(if|for|when|while)\b', Keyword.Reserved, '#pop'),
+            (_name, Name.Class, '#pop'),
+            default('#pop')
+        ],
+        'package-prefix': [
+            include('whitespace'),
+            (_name, Name.Namespace, '#pop'),
+            default('#pop')
+        ],
+        'string': [
+            (r'"', String.Double, '#pop'),
+            (r'\\[\'"?\\abfnrtv]', String.Escape),
+            (r'(?i)<\s*html\s*>([^\\"]|\\.)+?(<\s*/\s*html\s*>|(?="))',
+             using(HtmlLexer)),
+            (r'<|\\?[^"\\<]+', String.Double)
+        ]
+    }
+
+
+class BugsLexer(RegexLexer):
+    """
+    Pygments Lexer for OpenBugs and WinBugs
+    models.
+    """
+
+    name = 'BUGS'
+    aliases = ['bugs', 'winbugs', 'openbugs']
+    filenames = ['*.bug']
+    url = 'https://www.mrc-bsu.cam.ac.uk/software/bugs/openbugs'
+    version_added = '1.6'
+
+    _FUNCTIONS = (
+        # Scalar functions
+        'abs', 'arccos', 'arccosh', 'arcsin', 'arcsinh', 'arctan', 'arctanh',
+        'cloglog', 'cos', 'cosh', 'cumulative', 'cut', 'density', 'deviance',
+        'equals', 'expr', 'gammap', 'ilogit', 'icloglog', 'integral', 'log',
+        'logfact', 'loggam', 'logit', 'max', 'min', 'phi', 'post.p.value',
+        'pow', 'prior.p.value', 'probit', 'replicate.post', 'replicate.prior',
+        'round', 'sin', 'sinh', 'solution', 'sqrt', 'step', 'tan', 'tanh',
+        'trunc',
+        # Vector functions
+        'inprod', 'interp.lin', 'inverse', 'logdet', 'mean', 'eigen.vals',
+        'ode', 'prod', 'p.valueM', 'rank', 'ranked', 'replicate.postM',
+        'sd', 'sort', 'sum',
+        # Special
+        'D', 'I', 'F', 'T', 'C')
+    """ OpenBUGS built-in functions
+
+    From http://www.openbugs.info/Manuals/ModelSpecification.html#ContentsAII
+
+    This also includes
+
+    - T, C, I : Truncation and censoring.
+      ``T`` and ``C`` are in OpenBUGS. ``I`` in WinBUGS.
+    - D : ODE
+    - F : Functional http://www.openbugs.info/Examples/Functionals.html
+
+    """
+
+    _DISTRIBUTIONS = ('dbern', 'dbin', 'dcat', 'dnegbin', 'dpois',
+                      'dhyper', 'dbeta', 'dchisqr', 'ddexp', 'dexp',
+                      'dflat', 'dgamma', 'dgev', 'df', 'dggamma', 'dgpar',
+                      'dloglik', 'dlnorm', 'dlogis', 'dnorm', 'dpar',
+                      'dt', 'dunif', 'dweib', 'dmulti', 'ddirch', 'dmnorm',
+                      'dmt', 'dwish')
+    """ OpenBUGS built-in distributions
+
+    Functions from
+    http://www.openbugs.info/Manuals/ModelSpecification.html#ContentsAI
+    """
+
+    tokens = {
+        'whitespace': [
+            (r"\s+", Text),
+        ],
+        'comments': [
+            # Comments
+            (r'#.*$', Comment.Single),
+        ],
+        'root': [
+            # Comments
+            include('comments'),
+            include('whitespace'),
+            # Block start
+            (r'(model)(\s+)(\{)',
+             bygroups(Keyword.Namespace, Text, Punctuation)),
+            # Reserved Words
+            (r'(for|in)(?![\w.])', Keyword.Reserved),
+            # Built-in Functions
+            (r'({})(?=\s*\()'.format(r'|'.join(_FUNCTIONS + _DISTRIBUTIONS)),
+             Name.Builtin),
+            # Regular variable names
+            (r'[A-Za-z][\w.]*', Name),
+            # Number Literals
+            (r'[-+]?[0-9]*\.?[0-9]+([eE][-+]?[0-9]+)?', Number),
+            # Punctuation
+            (r'\[|\]|\(|\)|:|,|;', Punctuation),
+            # Assignment operators
+            # SLexer makes these tokens Operators.
+            (r'<-|~', Operator),
+            # Infix and prefix operators
+            (r'\+|-|\*|/', Operator),
+            # Block
+            (r'[{}]', Punctuation),
+        ]
+    }
+
+    def analyse_text(text):
+        if re.search(r"^\s*model\s*{", text, re.M):
+            return 0.7
+        else:
+            return 0.0
+
+
+class JagsLexer(RegexLexer):
+    """
+    Pygments Lexer for JAGS.
+    """
+
+    name = 'JAGS'
+    aliases = ['jags']
+    filenames = ['*.jag', '*.bug']
+    url = 'https://mcmc-jags.sourceforge.io'
+    version_added = '1.6'
+
+    # JAGS
+    _FUNCTIONS = (
+        'abs', 'arccos', 'arccosh', 'arcsin', 'arcsinh', 'arctan', 'arctanh',
+        'cos', 'cosh', 'cloglog',
+        'equals', 'exp', 'icloglog', 'ifelse', 'ilogit', 'log', 'logfact',
+        'loggam', 'logit', 'phi', 'pow', 'probit', 'round', 'sin', 'sinh',
+        'sqrt', 'step', 'tan', 'tanh', 'trunc', 'inprod', 'interp.lin',
+        'logdet', 'max', 'mean', 'min', 'prod', 'sum', 'sd', 'inverse',
+        'rank', 'sort', 't', 'acos', 'acosh', 'asin', 'asinh', 'atan',
+        # Truncation/Censoring (should I include)
+        'T', 'I')
+    # Distributions with density, probability and quartile functions
+    _DISTRIBUTIONS = tuple(f'[dpq]{x}' for x in
+                           ('bern', 'beta', 'dchiqsqr', 'ddexp', 'dexp',
+                            'df', 'gamma', 'gen.gamma', 'logis', 'lnorm',
+                            'negbin', 'nchisqr', 'norm', 'par', 'pois', 'weib'))
+    # Other distributions without density and probability
+    _OTHER_DISTRIBUTIONS = (
+        'dt', 'dunif', 'dbetabin', 'dbern', 'dbin', 'dcat', 'dhyper',
+        'ddirch', 'dmnorm', 'dwish', 'dmt', 'dmulti', 'dbinom', 'dchisq',
+        'dnbinom', 'dweibull', 'ddirich')
+
+    tokens = {
+        'whitespace': [
+            (r"\s+", Text),
+        ],
+        'names': [
+            # Regular variable names
+            (r'[a-zA-Z][\w.]*\b', Name),
+        ],
+        'comments': [
+            # do not use stateful comments
+            (r'(?s)/\*.*?\*/', Comment.Multiline),
+            # Comments
+            (r'#.*$', Comment.Single),
+        ],
+        'root': [
+            # Comments
+            include('comments'),
+            include('whitespace'),
+            # Block start
+            (r'(model|data)(\s+)(\{)',
+             bygroups(Keyword.Namespace, Text, Punctuation)),
+            (r'var(?![\w.])', Keyword.Declaration),
+            # Reserved Words
+            (r'(for|in)(?![\w.])', Keyword.Reserved),
+            # Builtins
+            # Need to use lookahead because . is a valid char
+            (r'({})(?=\s*\()'.format(r'|'.join(_FUNCTIONS
+                                          + _DISTRIBUTIONS
+                                          + _OTHER_DISTRIBUTIONS)),
+             Name.Builtin),
+            # Names
+            include('names'),
+            # Number Literals
+            (r'[-+]?[0-9]*\.?[0-9]+([eE][-+]?[0-9]+)?', Number),
+            (r'\[|\]|\(|\)|:|,|;', Punctuation),
+            # Assignment operators
+            (r'<-|~', Operator),
+            # # JAGS includes many more than OpenBUGS
+            (r'\+|-|\*|\/|\|\|[&]{2}|[<>=]=?|\^|%.*?%', Operator),
+            (r'[{}]', Punctuation),
+        ]
+    }
+
+    def analyse_text(text):
+        if re.search(r'^\s*model\s*\{', text, re.M):
+            if re.search(r'^\s*data\s*\{', text, re.M):
+                return 0.9
+            elif re.search(r'^\s*var', text, re.M):
+                return 0.9
+            else:
+                return 0.3
+        else:
+            return 0
+
+
+class StanLexer(RegexLexer):
+    """Pygments Lexer for Stan models.
+
+    The Stan modeling language is specified in the *Stan Modeling Language
+    User's Guide and Reference Manual, v2.17.0*,
+    `pdf `__.
+    """
+
+    name = 'Stan'
+    aliases = ['stan']
+    filenames = ['*.stan']
+    url = 'https://mc-stan.org'
+    version_added = '1.6'
+
+    tokens = {
+        'whitespace': [
+            (r"\s+", Text),
+        ],
+        'comments': [
+            (r'(?s)/\*.*?\*/', Comment.Multiline),
+            # Comments
+            (r'(//|#).*$', Comment.Single),
+        ],
+        'root': [
+            (r'"[^"]*"', String),
+            # Comments
+            include('comments'),
+            # block start
+            include('whitespace'),
+            # Block start
+            (r'({})(\s*)(\{{)'.format(r'|'.join(('functions', 'data', r'transformed\s+?data',
+                        'parameters', r'transformed\s+parameters',
+                        'model', r'generated\s+quantities'))),
+             bygroups(Keyword.Namespace, Text, Punctuation)),
+            # target keyword
+            (r'target\s*\+=', Keyword),
+            # Reserved Words
+            (r'({})\b'.format(r'|'.join(_stan_builtins.KEYWORDS)), Keyword),
+            # Truncation
+            (r'T(?=\s*\[)', Keyword),
+            # Data types
+            (r'({})\b'.format(r'|'.join(_stan_builtins.TYPES)), Keyword.Type),
+             # < should be punctuation, but elsewhere I can't tell if it is in
+             # a range constraint
+            (r'(<)(\s*)(upper|lower|offset|multiplier)(\s*)(=)',
+             bygroups(Operator, Whitespace, Keyword, Whitespace, Punctuation)),
+            (r'(,)(\s*)(upper)(\s*)(=)',
+             bygroups(Punctuation, Whitespace, Keyword, Whitespace, Punctuation)),
+            # Punctuation
+            (r"[;,\[\]()]", Punctuation),
+            # Builtin
+            (r'({})(?=\s*\()'.format('|'.join(_stan_builtins.FUNCTIONS)), Name.Builtin),
+            (r'(~)(\s*)({})(?=\s*\()'.format('|'.join(_stan_builtins.DISTRIBUTIONS)),
+                bygroups(Operator, Whitespace, Name.Builtin)),
+            # Special names ending in __, like lp__
+            (r'[A-Za-z]\w*__\b', Name.Builtin.Pseudo),
+            (r'({})\b'.format(r'|'.join(_stan_builtins.RESERVED)), Keyword.Reserved),
+            # user-defined functions
+            (r'[A-Za-z]\w*(?=\s*\()]', Name.Function),
+            # Imaginary Literals
+            (r'[0-9]+(\.[0-9]*)?([eE][+-]?[0-9]+)?i', Number.Float),
+            (r'\.[0-9]+([eE][+-]?[0-9]+)?i', Number.Float),
+            (r'[0-9]+i', Number.Float),
+            # Real Literals
+            (r'[0-9]+(\.[0-9]*)?([eE][+-]?[0-9]+)?', Number.Float),
+            (r'\.[0-9]+([eE][+-]?[0-9]+)?', Number.Float),
+            # Integer Literals
+            (r'[0-9]+', Number.Integer),
+            # Regular variable names
+            (r'[A-Za-z]\w*\b', Name),
+            # Assignment operators
+            (r'<-|(?:\+|-|\.?/|\.?\*|=)?=|~', Operator),
+            # Infix, prefix and postfix operators (and = )
+            (r"\+|-|\.?\*|\.?/|\\|'|\.?\^|!=?|<=?|>=?|\|\||&&|%|\?|:|%/%|!", Operator),
+            # Block delimiters
+            (r'[{}]', Punctuation),
+            # Distribution |
+            (r'\|', Punctuation)
+        ]
+    }
+
+    def analyse_text(text):
+        if re.search(r'^\s*parameters\s*\{', text, re.M):
+            return 1.0
+        else:
+            return 0.0
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/modula2.py b/env/lib/python3.12/site-packages/pygments/lexers/modula2.py
new file mode 100644
index 0000000..713f472
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/modula2.py
@@ -0,0 +1,1579 @@
+"""
+    pygments.lexers.modula2
+    ~~~~~~~~~~~~~~~~~~~~~~~
+
+    Multi-Dialect Lexer for Modula-2.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, include
+from pygments.util import get_bool_opt, get_list_opt
+from pygments.token import Text, Comment, Operator, Keyword, Name, \
+    String, Number, Punctuation, Error
+
+__all__ = ['Modula2Lexer']
+
+
+# Multi-Dialect Modula-2 Lexer
+class Modula2Lexer(RegexLexer):
+    """
+    For Modula-2 source code.
+
+    The Modula-2 lexer supports several dialects.  By default, it operates in
+    fallback mode, recognising the *combined* literals, punctuation symbols
+    and operators of all supported dialects, and the *combined* reserved words
+    and builtins of PIM Modula-2, ISO Modula-2 and Modula-2 R10, while not
+    differentiating between library defined identifiers.
+
+    To select a specific dialect, a dialect option may be passed
+    or a dialect tag may be embedded into a source file.
+
+    Dialect Options:
+
+    `m2pim`
+        Select PIM Modula-2 dialect.
+    `m2iso`
+        Select ISO Modula-2 dialect.
+    `m2r10`
+        Select Modula-2 R10 dialect.
+    `objm2`
+        Select Objective Modula-2 dialect.
+
+    The PIM and ISO dialect options may be qualified with a language extension.
+
+    Language Extensions:
+
+    `+aglet`
+        Select Aglet Modula-2 extensions, available with m2iso.
+    `+gm2`
+        Select GNU Modula-2 extensions, available with m2pim.
+    `+p1`
+        Select p1 Modula-2 extensions, available with m2iso.
+    `+xds`
+        Select XDS Modula-2 extensions, available with m2iso.
+
+
+    Passing a Dialect Option via Unix Commandline Interface
+
+    Dialect options may be passed to the lexer using the `dialect` key.
+    Only one such option should be passed. If multiple dialect options are
+    passed, the first valid option is used, any subsequent options are ignored.
+
+    Examples:
+
+    `$ pygmentize -O full,dialect=m2iso -f html -o /path/to/output /path/to/input`
+        Use ISO dialect to render input to HTML output
+    `$ pygmentize -O full,dialect=m2iso+p1 -f rtf -o /path/to/output /path/to/input`
+        Use ISO dialect with p1 extensions to render input to RTF output
+
+
+    Embedding a Dialect Option within a source file
+
+    A dialect option may be embedded in a source file in form of a dialect
+    tag, a specially formatted comment that specifies a dialect option.
+
+    Dialect Tag EBNF::
+
+       dialectTag :
+           OpeningCommentDelim Prefix dialectOption ClosingCommentDelim ;
+
+       dialectOption :
+           'm2pim' | 'm2iso' | 'm2r10' | 'objm2' |
+           'm2iso+aglet' | 'm2pim+gm2' | 'm2iso+p1' | 'm2iso+xds' ;
+
+       Prefix : '!' ;
+
+       OpeningCommentDelim : '(*' ;
+
+       ClosingCommentDelim : '*)' ;
+
+    No whitespace is permitted between the tokens of a dialect tag.
+
+    In the event that a source file contains multiple dialect tags, the first
+    tag that contains a valid dialect option will be used and any subsequent
+    dialect tags will be ignored.  Ideally, a dialect tag should be placed
+    at the beginning of a source file.
+
+    An embedded dialect tag overrides a dialect option set via command line.
+
+    Examples:
+
+    ``(*!m2r10*) DEFINITION MODULE Foobar; ...``
+        Use Modula2 R10 dialect to render this source file.
+    ``(*!m2pim+gm2*) DEFINITION MODULE Bazbam; ...``
+        Use PIM dialect with GNU extensions to render this source file.
+
+
+    Algol Publication Mode:
+
+    In Algol publication mode, source text is rendered for publication of
+    algorithms in scientific papers and academic texts, following the format
+    of the Revised Algol-60 Language Report.  It is activated by passing
+    one of two corresponding styles as an option:
+
+    `algol`
+        render reserved words lowercase underline boldface
+        and builtins lowercase boldface italic
+    `algol_nu`
+        render reserved words lowercase boldface (no underlining)
+        and builtins lowercase boldface italic
+
+    The lexer automatically performs the required lowercase conversion when
+    this mode is activated.
+
+    Example:
+
+    ``$ pygmentize -O full,style=algol -f latex -o /path/to/output /path/to/input``
+        Render input file in Algol publication mode to LaTeX output.
+
+
+    Rendering Mode of First Class ADT Identifiers:
+
+    The rendering of standard library first class ADT identifiers is controlled
+    by option flag "treat_stdlib_adts_as_builtins".
+
+    When this option is turned on, standard library ADT identifiers are rendered
+    as builtins.  When it is turned off, they are rendered as ordinary library
+    identifiers.
+
+    `treat_stdlib_adts_as_builtins` (default: On)
+
+    The option is useful for dialects that support ADTs as first class objects
+    and provide ADTs in the standard library that would otherwise be built-in.
+
+    At present, only Modula-2 R10 supports library ADTs as first class objects
+    and therefore, no ADT identifiers are defined for any other dialects.
+
+    Example:
+
+    ``$ pygmentize -O full,dialect=m2r10,treat_stdlib_adts_as_builtins=Off ...``
+        Render standard library ADTs as ordinary library types.
+
+    .. versionchanged:: 2.1
+       Added multi-dialect support.
+    """
+    name = 'Modula-2'
+    url = 'http://www.modula2.org/'
+    aliases = ['modula2', 'm2']
+    filenames = ['*.def', '*.mod']
+    mimetypes = ['text/x-modula2']
+    version_added = '1.3'
+
+    flags = re.MULTILINE | re.DOTALL
+
+    tokens = {
+        'whitespace': [
+            (r'\n+', Text),  # blank lines
+            (r'\s+', Text),  # whitespace
+        ],
+        'dialecttags': [
+            # PIM Dialect Tag
+            (r'\(\*!m2pim\*\)', Comment.Special),
+            # ISO Dialect Tag
+            (r'\(\*!m2iso\*\)', Comment.Special),
+            # M2R10 Dialect Tag
+            (r'\(\*!m2r10\*\)', Comment.Special),
+            # ObjM2 Dialect Tag
+            (r'\(\*!objm2\*\)', Comment.Special),
+            # Aglet Extensions Dialect Tag
+            (r'\(\*!m2iso\+aglet\*\)', Comment.Special),
+            # GNU Extensions Dialect Tag
+            (r'\(\*!m2pim\+gm2\*\)', Comment.Special),
+            # p1 Extensions Dialect Tag
+            (r'\(\*!m2iso\+p1\*\)', Comment.Special),
+            # XDS Extensions Dialect Tag
+            (r'\(\*!m2iso\+xds\*\)', Comment.Special),
+        ],
+        'identifiers': [
+            (r'([a-zA-Z_$][\w$]*)', Name),
+        ],
+        'prefixed_number_literals': [
+            #
+            # Base-2, whole number
+            (r'0b[01]+(\'[01]+)*', Number.Bin),
+            #
+            # Base-16, whole number
+            (r'0[ux][0-9A-F]+(\'[0-9A-F]+)*', Number.Hex),
+        ],
+        'plain_number_literals': [
+            #
+            # Base-10, real number with exponent
+            (r'[0-9]+(\'[0-9]+)*'  # integral part
+             r'\.[0-9]+(\'[0-9]+)*'  # fractional part
+             r'[eE][+-]?[0-9]+(\'[0-9]+)*',  # exponent
+             Number.Float),
+            #
+            # Base-10, real number without exponent
+            (r'[0-9]+(\'[0-9]+)*'  # integral part
+             r'\.[0-9]+(\'[0-9]+)*',  # fractional part
+             Number.Float),
+            #
+            # Base-10, whole number
+            (r'[0-9]+(\'[0-9]+)*', Number.Integer),
+        ],
+        'suffixed_number_literals': [
+            #
+            # Base-8, whole number
+            (r'[0-7]+B', Number.Oct),
+            #
+            # Base-8, character code
+            (r'[0-7]+C', Number.Oct),
+            #
+            # Base-16, number
+            (r'[0-9A-F]+H', Number.Hex),
+        ],
+        'string_literals': [
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String.Double),
+            (r"'(\\\\|\\[^\\]|[^'\\])*'", String.Single),
+        ],
+        'digraph_operators': [
+            # Dot Product Operator
+            (r'\*\.', Operator),
+            # Array Concatenation Operator
+            (r'\+>', Operator),  # M2R10 + ObjM2
+            # Inequality Operator
+            (r'<>', Operator),  # ISO + PIM
+            # Less-Or-Equal, Subset
+            (r'<=', Operator),
+            # Greater-Or-Equal, Superset
+            (r'>=', Operator),
+            # Identity Operator
+            (r'==', Operator),  # M2R10 + ObjM2
+            # Type Conversion Operator
+            (r'::', Operator),  # M2R10 + ObjM2
+            # Assignment Symbol
+            (r':=', Operator),
+            # Postfix Increment Mutator
+            (r'\+\+', Operator),  # M2R10 + ObjM2
+            # Postfix Decrement Mutator
+            (r'--', Operator),  # M2R10 + ObjM2
+        ],
+        'unigraph_operators': [
+            # Arithmetic Operators
+            (r'[+-]', Operator),
+            (r'[*/]', Operator),
+            # ISO 80000-2 compliant Set Difference Operator
+            (r'\\', Operator),  # M2R10 + ObjM2
+            # Relational Operators
+            (r'[=#<>]', Operator),
+            # Dereferencing Operator
+            (r'\^', Operator),
+            # Dereferencing Operator Synonym
+            (r'@', Operator),  # ISO
+            # Logical AND Operator Synonym
+            (r'&', Operator),  # PIM + ISO
+            # Logical NOT Operator Synonym
+            (r'~', Operator),  # PIM + ISO
+            # Smalltalk Message Prefix
+            (r'`', Operator),  # ObjM2
+        ],
+        'digraph_punctuation': [
+            # Range Constructor
+            (r'\.\.', Punctuation),
+            # Opening Chevron Bracket
+            (r'<<', Punctuation),  # M2R10 + ISO
+            # Closing Chevron Bracket
+            (r'>>', Punctuation),  # M2R10 + ISO
+            # Blueprint Punctuation
+            (r'->', Punctuation),  # M2R10 + ISO
+            # Distinguish |# and # in M2 R10
+            (r'\|#', Punctuation),
+            # Distinguish ## and # in M2 R10
+            (r'##', Punctuation),
+            # Distinguish |* and * in M2 R10
+            (r'\|\*', Punctuation),
+        ],
+        'unigraph_punctuation': [
+            # Common Punctuation
+            (r'[()\[\]{},.:;|]', Punctuation),
+            # Case Label Separator Synonym
+            (r'!', Punctuation),  # ISO
+            # Blueprint Punctuation
+            (r'\?', Punctuation),  # M2R10 + ObjM2
+        ],
+        'comments': [
+            # Single Line Comment
+            (r'^//.*?\n', Comment.Single),  # M2R10 + ObjM2
+            # Block Comment
+            (r'\(\*([^$].*?)\*\)', Comment.Multiline),
+            # Template Block Comment
+            (r'/\*(.*?)\*/', Comment.Multiline),  # M2R10 + ObjM2
+        ],
+        'pragmas': [
+            # ISO Style Pragmas
+            (r'<\*.*?\*>', Comment.Preproc),  # ISO, M2R10 + ObjM2
+            # Pascal Style Pragmas
+            (r'\(\*\$.*?\*\)', Comment.Preproc),  # PIM
+        ],
+        'root': [
+            include('whitespace'),
+            include('dialecttags'),
+            include('pragmas'),
+            include('comments'),
+            include('identifiers'),
+            include('suffixed_number_literals'),  # PIM + ISO
+            include('prefixed_number_literals'),  # M2R10 + ObjM2
+            include('plain_number_literals'),
+            include('string_literals'),
+            include('digraph_punctuation'),
+            include('digraph_operators'),
+            include('unigraph_punctuation'),
+            include('unigraph_operators'),
+        ]
+    }
+
+#  C o m m o n   D a t a s e t s
+
+    # Common Reserved Words Dataset
+    common_reserved_words = (
+        # 37 common reserved words
+        'AND', 'ARRAY', 'BEGIN', 'BY', 'CASE', 'CONST', 'DEFINITION', 'DIV',
+        'DO', 'ELSE', 'ELSIF', 'END', 'EXIT', 'FOR', 'FROM', 'IF',
+        'IMPLEMENTATION', 'IMPORT', 'IN', 'LOOP', 'MOD', 'MODULE', 'NOT',
+        'OF', 'OR', 'POINTER', 'PROCEDURE', 'RECORD', 'REPEAT', 'RETURN',
+        'SET', 'THEN', 'TO', 'TYPE', 'UNTIL', 'VAR', 'WHILE',
+    )
+
+    # Common Builtins Dataset
+    common_builtins = (
+        # 16 common builtins
+        'ABS', 'BOOLEAN', 'CARDINAL', 'CHAR', 'CHR', 'FALSE', 'INTEGER',
+        'LONGINT', 'LONGREAL', 'MAX', 'MIN', 'NIL', 'ODD', 'ORD', 'REAL',
+        'TRUE',
+    )
+
+    # Common Pseudo-Module Builtins Dataset
+    common_pseudo_builtins = (
+        # 4 common pseudo builtins
+        'ADDRESS', 'BYTE', 'WORD', 'ADR'
+    )
+
+#  P I M   M o d u l a - 2   D a t a s e t s
+
+    # Lexemes to Mark as Error Tokens for PIM Modula-2
+    pim_lexemes_to_reject = (
+        '!', '`', '@', '$', '%', '?', '\\', '==', '++', '--', '::', '*.',
+        '+>', '->', '<<', '>>', '|#', '##',
+    )
+
+    # PIM Modula-2 Additional Reserved Words Dataset
+    pim_additional_reserved_words = (
+        # 3 additional reserved words
+        'EXPORT', 'QUALIFIED', 'WITH',
+    )
+
+    # PIM Modula-2 Additional Builtins Dataset
+    pim_additional_builtins = (
+        # 16 additional builtins
+        'BITSET', 'CAP', 'DEC', 'DISPOSE', 'EXCL', 'FLOAT', 'HALT', 'HIGH',
+        'INC', 'INCL', 'NEW', 'NIL', 'PROC', 'SIZE', 'TRUNC', 'VAL',
+    )
+
+    # PIM Modula-2 Additional Pseudo-Module Builtins Dataset
+    pim_additional_pseudo_builtins = (
+        # 5 additional pseudo builtins
+        'SYSTEM', 'PROCESS', 'TSIZE', 'NEWPROCESS', 'TRANSFER',
+    )
+
+#  I S O   M o d u l a - 2   D a t a s e t s
+
+    # Lexemes to Mark as Error Tokens for ISO Modula-2
+    iso_lexemes_to_reject = (
+        '`', '$', '%', '?', '\\', '==', '++', '--', '::', '*.', '+>', '->',
+        '<<', '>>', '|#', '##',
+    )
+
+    # ISO Modula-2 Additional Reserved Words Dataset
+    iso_additional_reserved_words = (
+        # 9 additional reserved words (ISO 10514-1)
+        'EXCEPT', 'EXPORT', 'FINALLY', 'FORWARD', 'PACKEDSET', 'QUALIFIED',
+        'REM', 'RETRY', 'WITH',
+        # 10 additional reserved words (ISO 10514-2 & ISO 10514-3)
+        'ABSTRACT', 'AS', 'CLASS', 'GUARD', 'INHERIT', 'OVERRIDE', 'READONLY',
+        'REVEAL', 'TRACED', 'UNSAFEGUARDED',
+    )
+
+    # ISO Modula-2 Additional Builtins Dataset
+    iso_additional_builtins = (
+        # 26 additional builtins (ISO 10514-1)
+        'BITSET', 'CAP', 'CMPLX', 'COMPLEX', 'DEC', 'DISPOSE', 'EXCL', 'FLOAT',
+        'HALT', 'HIGH', 'IM', 'INC', 'INCL', 'INT', 'INTERRUPTIBLE',  'LENGTH',
+        'LFLOAT', 'LONGCOMPLEX', 'NEW', 'PROC', 'PROTECTION', 'RE', 'SIZE',
+        'TRUNC', 'UNINTERRUBTIBLE', 'VAL',
+        # 5 additional builtins (ISO 10514-2 & ISO 10514-3)
+        'CREATE', 'DESTROY', 'EMPTY', 'ISMEMBER', 'SELF',
+    )
+
+    # ISO Modula-2 Additional Pseudo-Module Builtins Dataset
+    iso_additional_pseudo_builtins = (
+        # 14 additional builtins (SYSTEM)
+        'SYSTEM', 'BITSPERLOC', 'LOCSPERBYTE', 'LOCSPERWORD', 'LOC',
+        'ADDADR', 'SUBADR', 'DIFADR', 'MAKEADR', 'ADR',
+        'ROTATE', 'SHIFT', 'CAST', 'TSIZE',
+        # 13 additional builtins (COROUTINES)
+        'COROUTINES', 'ATTACH', 'COROUTINE', 'CURRENT', 'DETACH', 'HANDLER',
+        'INTERRUPTSOURCE', 'IOTRANSFER', 'IsATTACHED', 'LISTEN',
+        'NEWCOROUTINE', 'PROT', 'TRANSFER',
+        # 9 additional builtins (EXCEPTIONS)
+        'EXCEPTIONS', 'AllocateSource', 'CurrentNumber', 'ExceptionNumber',
+        'ExceptionSource', 'GetMessage', 'IsCurrentSource',
+        'IsExceptionalExecution', 'RAISE',
+        # 3 additional builtins (TERMINATION)
+        'TERMINATION', 'IsTerminating', 'HasHalted',
+        # 4 additional builtins (M2EXCEPTION)
+        'M2EXCEPTION', 'M2Exceptions', 'M2Exception', 'IsM2Exception',
+        'indexException', 'rangeException', 'caseSelectException',
+        'invalidLocation', 'functionException', 'wholeValueException',
+        'wholeDivException', 'realValueException', 'realDivException',
+        'complexValueException', 'complexDivException', 'protException',
+        'sysException', 'coException', 'exException',
+    )
+
+#  M o d u l a - 2   R 1 0   D a t a s e t s
+
+    # Lexemes to Mark as Error Tokens for Modula-2 R10
+    m2r10_lexemes_to_reject = (
+        '!', '`', '@', '$', '%', '&', '<>',
+    )
+
+    # Modula-2 R10 reserved words in addition to the common set
+    m2r10_additional_reserved_words = (
+        # 12 additional reserved words
+        'ALIAS', 'ARGLIST', 'BLUEPRINT', 'COPY', 'GENLIB', 'INDETERMINATE',
+        'NEW', 'NONE', 'OPAQUE', 'REFERENTIAL', 'RELEASE', 'RETAIN',
+        # 2 additional reserved words with symbolic assembly option
+        'ASM', 'REG',
+    )
+
+    # Modula-2 R10 builtins in addition to the common set
+    m2r10_additional_builtins = (
+        # 26 additional builtins
+        'CARDINAL', 'COUNT', 'EMPTY', 'EXISTS', 'INSERT', 'LENGTH', 'LONGCARD',
+        'OCTET', 'PTR', 'PRED', 'READ', 'READNEW', 'REMOVE', 'RETRIEVE', 'SORT',
+        'STORE', 'SUBSET', 'SUCC', 'TLIMIT', 'TMAX', 'TMIN', 'TRUE', 'TSIZE',
+        'UNICHAR', 'WRITE', 'WRITEF',
+    )
+
+    # Modula-2 R10 Additional Pseudo-Module Builtins Dataset
+    m2r10_additional_pseudo_builtins = (
+        # 13 additional builtins (TPROPERTIES)
+        'TPROPERTIES', 'PROPERTY', 'LITERAL', 'TPROPERTY', 'TLITERAL',
+        'TBUILTIN', 'TDYN', 'TREFC', 'TNIL', 'TBASE', 'TPRECISION',
+        'TMAXEXP', 'TMINEXP',
+        # 4 additional builtins (CONVERSION)
+        'CONVERSION', 'TSXFSIZE', 'SXF', 'VAL',
+        # 35 additional builtins (UNSAFE)
+        'UNSAFE', 'CAST', 'INTRINSIC', 'AVAIL', 'ADD', 'SUB', 'ADDC', 'SUBC',
+        'FETCHADD', 'FETCHSUB', 'SHL', 'SHR', 'ASHR', 'ROTL', 'ROTR', 'ROTLC',
+        'ROTRC', 'BWNOT', 'BWAND', 'BWOR', 'BWXOR', 'BWNAND', 'BWNOR',
+        'SETBIT', 'TESTBIT', 'LSBIT', 'MSBIT', 'CSBITS', 'BAIL', 'HALT',
+        'TODO', 'FFI', 'ADDR', 'VARGLIST', 'VARGC',
+        # 11 additional builtins (ATOMIC)
+        'ATOMIC', 'INTRINSIC', 'AVAIL', 'SWAP', 'CAS', 'INC', 'DEC', 'BWAND',
+        'BWNAND', 'BWOR', 'BWXOR',
+        # 7 additional builtins (COMPILER)
+        'COMPILER', 'DEBUG', 'MODNAME', 'PROCNAME', 'LINENUM', 'DEFAULT',
+        'HASH',
+        # 5 additional builtins (ASSEMBLER)
+        'ASSEMBLER', 'REGISTER', 'SETREG', 'GETREG', 'CODE',
+    )
+
+#  O b j e c t i v e   M o d u l a - 2   D a t a s e t s
+
+    # Lexemes to Mark as Error Tokens for Objective Modula-2
+    objm2_lexemes_to_reject = (
+        '!', '$', '%', '&', '<>',
+    )
+
+    # Objective Modula-2 Extensions
+    # reserved words in addition to Modula-2 R10
+    objm2_additional_reserved_words = (
+        # 16 additional reserved words
+        'BYCOPY', 'BYREF', 'CLASS', 'CONTINUE', 'CRITICAL', 'INOUT', 'METHOD',
+        'ON', 'OPTIONAL', 'OUT', 'PRIVATE', 'PROTECTED', 'PROTOCOL', 'PUBLIC',
+        'SUPER', 'TRY',
+    )
+
+    # Objective Modula-2 Extensions
+    # builtins in addition to Modula-2 R10
+    objm2_additional_builtins = (
+        # 3 additional builtins
+        'OBJECT', 'NO', 'YES',
+    )
+
+    # Objective Modula-2 Extensions
+    # pseudo-module builtins in addition to Modula-2 R10
+    objm2_additional_pseudo_builtins = (
+        # None
+    )
+
+#  A g l e t   M o d u l a - 2   D a t a s e t s
+
+    # Aglet Extensions
+    # reserved words in addition to ISO Modula-2
+    aglet_additional_reserved_words = (
+        # None
+    )
+
+    # Aglet Extensions
+    # builtins in addition to ISO Modula-2
+    aglet_additional_builtins = (
+        # 9 additional builtins
+        'BITSET8', 'BITSET16', 'BITSET32', 'CARDINAL8', 'CARDINAL16',
+        'CARDINAL32', 'INTEGER8', 'INTEGER16', 'INTEGER32',
+    )
+
+    # Aglet Modula-2 Extensions
+    # pseudo-module builtins in addition to ISO Modula-2
+    aglet_additional_pseudo_builtins = (
+        # None
+    )
+
+#  G N U   M o d u l a - 2   D a t a s e t s
+
+    # GNU Extensions
+    # reserved words in addition to PIM Modula-2
+    gm2_additional_reserved_words = (
+        # 10 additional reserved words
+        'ASM', '__ATTRIBUTE__', '__BUILTIN__', '__COLUMN__', '__DATE__',
+        '__FILE__', '__FUNCTION__', '__LINE__', '__MODULE__', 'VOLATILE',
+    )
+
+    # GNU Extensions
+    # builtins in addition to PIM Modula-2
+    gm2_additional_builtins = (
+        # 21 additional builtins
+        'BITSET8', 'BITSET16', 'BITSET32', 'CARDINAL8', 'CARDINAL16',
+        'CARDINAL32', 'CARDINAL64', 'COMPLEX32', 'COMPLEX64', 'COMPLEX96',
+        'COMPLEX128', 'INTEGER8', 'INTEGER16', 'INTEGER32', 'INTEGER64',
+        'REAL8', 'REAL16', 'REAL32', 'REAL96', 'REAL128', 'THROW',
+    )
+
+    # GNU Extensions
+    # pseudo-module builtins in addition to PIM Modula-2
+    gm2_additional_pseudo_builtins = (
+        # None
+    )
+
+#  p 1   M o d u l a - 2   D a t a s e t s
+
+    # p1 Extensions
+    # reserved words in addition to ISO Modula-2
+    p1_additional_reserved_words = (
+        # None
+    )
+
+    # p1 Extensions
+    # builtins in addition to ISO Modula-2
+    p1_additional_builtins = (
+        # None
+    )
+
+    # p1 Modula-2 Extensions
+    # pseudo-module builtins in addition to ISO Modula-2
+    p1_additional_pseudo_builtins = (
+        # 1 additional builtin
+        'BCD',
+    )
+
+#  X D S   M o d u l a - 2   D a t a s e t s
+
+    # XDS Extensions
+    # reserved words in addition to ISO Modula-2
+    xds_additional_reserved_words = (
+        # 1 additional reserved word
+        'SEQ',
+    )
+
+    # XDS Extensions
+    # builtins in addition to ISO Modula-2
+    xds_additional_builtins = (
+        # 9 additional builtins
+        'ASH', 'ASSERT', 'DIFFADR_TYPE', 'ENTIER', 'INDEX', 'LEN',
+        'LONGCARD', 'SHORTCARD', 'SHORTINT',
+    )
+
+    # XDS Modula-2 Extensions
+    # pseudo-module builtins in addition to ISO Modula-2
+    xds_additional_pseudo_builtins = (
+        # 22 additional builtins (SYSTEM)
+        'PROCESS', 'NEWPROCESS', 'BOOL8', 'BOOL16', 'BOOL32', 'CARD8',
+        'CARD16', 'CARD32', 'INT8', 'INT16', 'INT32', 'REF', 'MOVE',
+        'FILL', 'GET', 'PUT', 'CC', 'int', 'unsigned', 'size_t', 'void'
+        # 3 additional builtins (COMPILER)
+        'COMPILER', 'OPTION', 'EQUATION'
+    )
+
+#  P I M   S t a n d a r d   L i b r a r y   D a t a s e t s
+
+    # PIM Modula-2 Standard Library Modules Dataset
+    pim_stdlib_module_identifiers = (
+        'Terminal', 'FileSystem', 'InOut', 'RealInOut', 'MathLib0', 'Storage',
+    )
+
+    # PIM Modula-2 Standard Library Types Dataset
+    pim_stdlib_type_identifiers = (
+        'Flag', 'FlagSet', 'Response', 'Command', 'Lock', 'Permission',
+        'MediumType', 'File', 'FileProc', 'DirectoryProc', 'FileCommand',
+        'DirectoryCommand',
+    )
+
+    # PIM Modula-2 Standard Library Procedures Dataset
+    pim_stdlib_proc_identifiers = (
+        'Read', 'BusyRead', 'ReadAgain', 'Write', 'WriteString', 'WriteLn',
+        'Create', 'Lookup', 'Close', 'Delete', 'Rename', 'SetRead', 'SetWrite',
+        'SetModify', 'SetOpen', 'Doio', 'SetPos', 'GetPos', 'Length', 'Reset',
+        'Again', 'ReadWord', 'WriteWord', 'ReadChar', 'WriteChar',
+        'CreateMedium', 'DeleteMedium', 'AssignName', 'DeassignName',
+        'ReadMedium', 'LookupMedium', 'OpenInput', 'OpenOutput', 'CloseInput',
+        'CloseOutput', 'ReadString', 'ReadInt', 'ReadCard', 'ReadWrd',
+        'WriteInt', 'WriteCard', 'WriteOct', 'WriteHex', 'WriteWrd',
+        'ReadReal', 'WriteReal', 'WriteFixPt', 'WriteRealOct', 'sqrt', 'exp',
+        'ln', 'sin', 'cos', 'arctan', 'entier', 'ALLOCATE', 'DEALLOCATE',
+    )
+
+    # PIM Modula-2 Standard Library Variables Dataset
+    pim_stdlib_var_identifiers = (
+        'Done', 'termCH', 'in', 'out'
+    )
+
+    # PIM Modula-2 Standard Library Constants Dataset
+    pim_stdlib_const_identifiers = (
+        'EOL',
+    )
+
+#  I S O   S t a n d a r d   L i b r a r y   D a t a s e t s
+
+    # ISO Modula-2 Standard Library Modules Dataset
+    iso_stdlib_module_identifiers = (
+        # TO DO
+    )
+
+    # ISO Modula-2 Standard Library Types Dataset
+    iso_stdlib_type_identifiers = (
+        # TO DO
+    )
+
+    # ISO Modula-2 Standard Library Procedures Dataset
+    iso_stdlib_proc_identifiers = (
+        # TO DO
+    )
+
+    # ISO Modula-2 Standard Library Variables Dataset
+    iso_stdlib_var_identifiers = (
+        # TO DO
+    )
+
+    # ISO Modula-2 Standard Library Constants Dataset
+    iso_stdlib_const_identifiers = (
+        # TO DO
+    )
+
+#  M 2   R 1 0   S t a n d a r d   L i b r a r y   D a t a s e t s
+
+    # Modula-2 R10 Standard Library ADTs Dataset
+    m2r10_stdlib_adt_identifiers = (
+        'BCD', 'LONGBCD', 'BITSET', 'SHORTBITSET', 'LONGBITSET',
+        'LONGLONGBITSET', 'COMPLEX', 'LONGCOMPLEX', 'SHORTCARD', 'LONGLONGCARD',
+        'SHORTINT', 'LONGLONGINT', 'POSINT', 'SHORTPOSINT', 'LONGPOSINT',
+        'LONGLONGPOSINT', 'BITSET8', 'BITSET16', 'BITSET32', 'BITSET64',
+        'BITSET128', 'BS8', 'BS16', 'BS32', 'BS64', 'BS128', 'CARDINAL8',
+        'CARDINAL16', 'CARDINAL32', 'CARDINAL64', 'CARDINAL128', 'CARD8',
+        'CARD16', 'CARD32', 'CARD64', 'CARD128', 'INTEGER8', 'INTEGER16',
+        'INTEGER32', 'INTEGER64', 'INTEGER128', 'INT8', 'INT16', 'INT32',
+        'INT64', 'INT128', 'STRING', 'UNISTRING',
+    )
+
+    # Modula-2 R10 Standard Library Blueprints Dataset
+    m2r10_stdlib_blueprint_identifiers = (
+        'ProtoRoot', 'ProtoComputational', 'ProtoNumeric', 'ProtoScalar',
+        'ProtoNonScalar', 'ProtoCardinal', 'ProtoInteger', 'ProtoReal',
+        'ProtoComplex', 'ProtoVector', 'ProtoTuple', 'ProtoCompArray',
+        'ProtoCollection', 'ProtoStaticArray', 'ProtoStaticSet',
+        'ProtoStaticString', 'ProtoArray', 'ProtoString', 'ProtoSet',
+        'ProtoMultiSet', 'ProtoDictionary', 'ProtoMultiDict', 'ProtoExtension',
+        'ProtoIO', 'ProtoCardMath', 'ProtoIntMath', 'ProtoRealMath',
+    )
+
+    # Modula-2 R10 Standard Library Modules Dataset
+    m2r10_stdlib_module_identifiers = (
+        'ASCII', 'BooleanIO', 'CharIO', 'UnicharIO', 'OctetIO',
+        'CardinalIO', 'LongCardIO', 'IntegerIO', 'LongIntIO', 'RealIO',
+        'LongRealIO', 'BCDIO', 'LongBCDIO', 'CardMath', 'LongCardMath',
+        'IntMath', 'LongIntMath', 'RealMath', 'LongRealMath', 'BCDMath',
+        'LongBCDMath', 'FileIO', 'FileSystem', 'Storage', 'IOSupport',
+    )
+
+    # Modula-2 R10 Standard Library Types Dataset
+    m2r10_stdlib_type_identifiers = (
+        'File', 'Status',
+        # TO BE COMPLETED
+    )
+
+    # Modula-2 R10 Standard Library Procedures Dataset
+    m2r10_stdlib_proc_identifiers = (
+        'ALLOCATE', 'DEALLOCATE', 'SIZE',
+        # TO BE COMPLETED
+    )
+
+    # Modula-2 R10 Standard Library Variables Dataset
+    m2r10_stdlib_var_identifiers = (
+        'stdIn', 'stdOut', 'stdErr',
+    )
+
+    # Modula-2 R10 Standard Library Constants Dataset
+    m2r10_stdlib_const_identifiers = (
+        'pi', 'tau',
+    )
+
+#  D i a l e c t s
+
+    # Dialect modes
+    dialects = (
+        'unknown',
+        'm2pim', 'm2iso', 'm2r10', 'objm2',
+        'm2iso+aglet', 'm2pim+gm2', 'm2iso+p1', 'm2iso+xds',
+    )
+
+#   D a t a b a s e s
+
+    # Lexemes to Mark as Errors Database
+    lexemes_to_reject_db = {
+        # Lexemes to reject for unknown dialect
+        'unknown': (
+            # LEAVE THIS EMPTY
+        ),
+        # Lexemes to reject for PIM Modula-2
+        'm2pim': (
+            pim_lexemes_to_reject,
+        ),
+        # Lexemes to reject for ISO Modula-2
+        'm2iso': (
+            iso_lexemes_to_reject,
+        ),
+        # Lexemes to reject for Modula-2 R10
+        'm2r10': (
+            m2r10_lexemes_to_reject,
+        ),
+        # Lexemes to reject for Objective Modula-2
+        'objm2': (
+            objm2_lexemes_to_reject,
+        ),
+        # Lexemes to reject for Aglet Modula-2
+        'm2iso+aglet': (
+            iso_lexemes_to_reject,
+        ),
+        # Lexemes to reject for GNU Modula-2
+        'm2pim+gm2': (
+            pim_lexemes_to_reject,
+        ),
+        # Lexemes to reject for p1 Modula-2
+        'm2iso+p1': (
+            iso_lexemes_to_reject,
+        ),
+        # Lexemes to reject for XDS Modula-2
+        'm2iso+xds': (
+            iso_lexemes_to_reject,
+        ),
+    }
+
+    # Reserved Words Database
+    reserved_words_db = {
+        # Reserved words for unknown dialect
+        'unknown': (
+            common_reserved_words,
+            pim_additional_reserved_words,
+            iso_additional_reserved_words,
+            m2r10_additional_reserved_words,
+        ),
+
+        # Reserved words for PIM Modula-2
+        'm2pim': (
+            common_reserved_words,
+            pim_additional_reserved_words,
+        ),
+
+        # Reserved words for Modula-2 R10
+        'm2iso': (
+            common_reserved_words,
+            iso_additional_reserved_words,
+        ),
+
+        # Reserved words for ISO Modula-2
+        'm2r10': (
+            common_reserved_words,
+            m2r10_additional_reserved_words,
+        ),
+
+        # Reserved words for Objective Modula-2
+        'objm2': (
+            common_reserved_words,
+            m2r10_additional_reserved_words,
+            objm2_additional_reserved_words,
+        ),
+
+        # Reserved words for Aglet Modula-2 Extensions
+        'm2iso+aglet': (
+            common_reserved_words,
+            iso_additional_reserved_words,
+            aglet_additional_reserved_words,
+        ),
+
+        # Reserved words for GNU Modula-2 Extensions
+        'm2pim+gm2': (
+            common_reserved_words,
+            pim_additional_reserved_words,
+            gm2_additional_reserved_words,
+        ),
+
+        # Reserved words for p1 Modula-2 Extensions
+        'm2iso+p1': (
+            common_reserved_words,
+            iso_additional_reserved_words,
+            p1_additional_reserved_words,
+        ),
+
+        # Reserved words for XDS Modula-2 Extensions
+        'm2iso+xds': (
+            common_reserved_words,
+            iso_additional_reserved_words,
+            xds_additional_reserved_words,
+        ),
+    }
+
+    # Builtins Database
+    builtins_db = {
+        # Builtins for unknown dialect
+        'unknown': (
+            common_builtins,
+            pim_additional_builtins,
+            iso_additional_builtins,
+            m2r10_additional_builtins,
+        ),
+
+        # Builtins for PIM Modula-2
+        'm2pim': (
+            common_builtins,
+            pim_additional_builtins,
+        ),
+
+        # Builtins for ISO Modula-2
+        'm2iso': (
+            common_builtins,
+            iso_additional_builtins,
+        ),
+
+        # Builtins for ISO Modula-2
+        'm2r10': (
+            common_builtins,
+            m2r10_additional_builtins,
+        ),
+
+        # Builtins for Objective Modula-2
+        'objm2': (
+            common_builtins,
+            m2r10_additional_builtins,
+            objm2_additional_builtins,
+        ),
+
+        # Builtins for Aglet Modula-2 Extensions
+        'm2iso+aglet': (
+            common_builtins,
+            iso_additional_builtins,
+            aglet_additional_builtins,
+        ),
+
+        # Builtins for GNU Modula-2 Extensions
+        'm2pim+gm2': (
+            common_builtins,
+            pim_additional_builtins,
+            gm2_additional_builtins,
+        ),
+
+        # Builtins for p1 Modula-2 Extensions
+        'm2iso+p1': (
+            common_builtins,
+            iso_additional_builtins,
+            p1_additional_builtins,
+        ),
+
+        # Builtins for XDS Modula-2 Extensions
+        'm2iso+xds': (
+            common_builtins,
+            iso_additional_builtins,
+            xds_additional_builtins,
+        ),
+    }
+
+    # Pseudo-Module Builtins Database
+    pseudo_builtins_db = {
+        # Builtins for unknown dialect
+        'unknown': (
+            common_pseudo_builtins,
+            pim_additional_pseudo_builtins,
+            iso_additional_pseudo_builtins,
+            m2r10_additional_pseudo_builtins,
+        ),
+
+        # Builtins for PIM Modula-2
+        'm2pim': (
+            common_pseudo_builtins,
+            pim_additional_pseudo_builtins,
+        ),
+
+        # Builtins for ISO Modula-2
+        'm2iso': (
+            common_pseudo_builtins,
+            iso_additional_pseudo_builtins,
+        ),
+
+        # Builtins for ISO Modula-2
+        'm2r10': (
+            common_pseudo_builtins,
+            m2r10_additional_pseudo_builtins,
+        ),
+
+        # Builtins for Objective Modula-2
+        'objm2': (
+            common_pseudo_builtins,
+            m2r10_additional_pseudo_builtins,
+            objm2_additional_pseudo_builtins,
+        ),
+
+        # Builtins for Aglet Modula-2 Extensions
+        'm2iso+aglet': (
+            common_pseudo_builtins,
+            iso_additional_pseudo_builtins,
+            aglet_additional_pseudo_builtins,
+        ),
+
+        # Builtins for GNU Modula-2 Extensions
+        'm2pim+gm2': (
+            common_pseudo_builtins,
+            pim_additional_pseudo_builtins,
+            gm2_additional_pseudo_builtins,
+        ),
+
+        # Builtins for p1 Modula-2 Extensions
+        'm2iso+p1': (
+            common_pseudo_builtins,
+            iso_additional_pseudo_builtins,
+            p1_additional_pseudo_builtins,
+        ),
+
+        # Builtins for XDS Modula-2 Extensions
+        'm2iso+xds': (
+            common_pseudo_builtins,
+            iso_additional_pseudo_builtins,
+            xds_additional_pseudo_builtins,
+        ),
+    }
+
+    # Standard Library ADTs Database
+    stdlib_adts_db = {
+        # Empty entry for unknown dialect
+        'unknown': (
+            # LEAVE THIS EMPTY
+        ),
+        # Standard Library ADTs for PIM Modula-2
+        'm2pim': (
+            # No first class library types
+        ),
+
+        # Standard Library ADTs for ISO Modula-2
+        'm2iso': (
+            # No first class library types
+        ),
+
+        # Standard Library ADTs for Modula-2 R10
+        'm2r10': (
+            m2r10_stdlib_adt_identifiers,
+        ),
+
+        # Standard Library ADTs for Objective Modula-2
+        'objm2': (
+            m2r10_stdlib_adt_identifiers,
+        ),
+
+        # Standard Library ADTs for Aglet Modula-2
+        'm2iso+aglet': (
+            # No first class library types
+        ),
+
+        # Standard Library ADTs for GNU Modula-2
+        'm2pim+gm2': (
+            # No first class library types
+        ),
+
+        # Standard Library ADTs for p1 Modula-2
+        'm2iso+p1': (
+            # No first class library types
+        ),
+
+        # Standard Library ADTs for XDS Modula-2
+        'm2iso+xds': (
+            # No first class library types
+        ),
+    }
+
+    # Standard Library Modules Database
+    stdlib_modules_db = {
+        # Empty entry for unknown dialect
+        'unknown': (
+            # LEAVE THIS EMPTY
+        ),
+        # Standard Library Modules for PIM Modula-2
+        'm2pim': (
+            pim_stdlib_module_identifiers,
+        ),
+
+        # Standard Library Modules for ISO Modula-2
+        'm2iso': (
+            iso_stdlib_module_identifiers,
+        ),
+
+        # Standard Library Modules for Modula-2 R10
+        'm2r10': (
+            m2r10_stdlib_blueprint_identifiers,
+            m2r10_stdlib_module_identifiers,
+            m2r10_stdlib_adt_identifiers,
+        ),
+
+        # Standard Library Modules for Objective Modula-2
+        'objm2': (
+            m2r10_stdlib_blueprint_identifiers,
+            m2r10_stdlib_module_identifiers,
+        ),
+
+        # Standard Library Modules for Aglet Modula-2
+        'm2iso+aglet': (
+            iso_stdlib_module_identifiers,
+        ),
+
+        # Standard Library Modules for GNU Modula-2
+        'm2pim+gm2': (
+            pim_stdlib_module_identifiers,
+        ),
+
+        # Standard Library Modules for p1 Modula-2
+        'm2iso+p1': (
+            iso_stdlib_module_identifiers,
+        ),
+
+        # Standard Library Modules for XDS Modula-2
+        'm2iso+xds': (
+            iso_stdlib_module_identifiers,
+        ),
+    }
+
+    # Standard Library Types Database
+    stdlib_types_db = {
+        # Empty entry for unknown dialect
+        'unknown': (
+            # LEAVE THIS EMPTY
+        ),
+        # Standard Library Types for PIM Modula-2
+        'm2pim': (
+            pim_stdlib_type_identifiers,
+        ),
+
+        # Standard Library Types for ISO Modula-2
+        'm2iso': (
+            iso_stdlib_type_identifiers,
+        ),
+
+        # Standard Library Types for Modula-2 R10
+        'm2r10': (
+            m2r10_stdlib_type_identifiers,
+        ),
+
+        # Standard Library Types for Objective Modula-2
+        'objm2': (
+            m2r10_stdlib_type_identifiers,
+        ),
+
+        # Standard Library Types for Aglet Modula-2
+        'm2iso+aglet': (
+            iso_stdlib_type_identifiers,
+        ),
+
+        # Standard Library Types for GNU Modula-2
+        'm2pim+gm2': (
+            pim_stdlib_type_identifiers,
+        ),
+
+        # Standard Library Types for p1 Modula-2
+        'm2iso+p1': (
+            iso_stdlib_type_identifiers,
+        ),
+
+        # Standard Library Types for XDS Modula-2
+        'm2iso+xds': (
+            iso_stdlib_type_identifiers,
+        ),
+    }
+
+    # Standard Library Procedures Database
+    stdlib_procedures_db = {
+        # Empty entry for unknown dialect
+        'unknown': (
+            # LEAVE THIS EMPTY
+        ),
+        # Standard Library Procedures for PIM Modula-2
+        'm2pim': (
+            pim_stdlib_proc_identifiers,
+        ),
+
+        # Standard Library Procedures for ISO Modula-2
+        'm2iso': (
+            iso_stdlib_proc_identifiers,
+        ),
+
+        # Standard Library Procedures for Modula-2 R10
+        'm2r10': (
+            m2r10_stdlib_proc_identifiers,
+        ),
+
+        # Standard Library Procedures for Objective Modula-2
+        'objm2': (
+            m2r10_stdlib_proc_identifiers,
+        ),
+
+        # Standard Library Procedures for Aglet Modula-2
+        'm2iso+aglet': (
+            iso_stdlib_proc_identifiers,
+        ),
+
+        # Standard Library Procedures for GNU Modula-2
+        'm2pim+gm2': (
+            pim_stdlib_proc_identifiers,
+        ),
+
+        # Standard Library Procedures for p1 Modula-2
+        'm2iso+p1': (
+            iso_stdlib_proc_identifiers,
+        ),
+
+        # Standard Library Procedures for XDS Modula-2
+        'm2iso+xds': (
+            iso_stdlib_proc_identifiers,
+        ),
+    }
+
+    # Standard Library Variables Database
+    stdlib_variables_db = {
+        # Empty entry for unknown dialect
+        'unknown': (
+            # LEAVE THIS EMPTY
+        ),
+        # Standard Library Variables for PIM Modula-2
+        'm2pim': (
+            pim_stdlib_var_identifiers,
+        ),
+
+        # Standard Library Variables for ISO Modula-2
+        'm2iso': (
+            iso_stdlib_var_identifiers,
+        ),
+
+        # Standard Library Variables for Modula-2 R10
+        'm2r10': (
+            m2r10_stdlib_var_identifiers,
+        ),
+
+        # Standard Library Variables for Objective Modula-2
+        'objm2': (
+            m2r10_stdlib_var_identifiers,
+        ),
+
+        # Standard Library Variables for Aglet Modula-2
+        'm2iso+aglet': (
+            iso_stdlib_var_identifiers,
+        ),
+
+        # Standard Library Variables for GNU Modula-2
+        'm2pim+gm2': (
+            pim_stdlib_var_identifiers,
+        ),
+
+        # Standard Library Variables for p1 Modula-2
+        'm2iso+p1': (
+            iso_stdlib_var_identifiers,
+        ),
+
+        # Standard Library Variables for XDS Modula-2
+        'm2iso+xds': (
+            iso_stdlib_var_identifiers,
+        ),
+    }
+
+    # Standard Library Constants Database
+    stdlib_constants_db = {
+        # Empty entry for unknown dialect
+        'unknown': (
+            # LEAVE THIS EMPTY
+        ),
+        # Standard Library Constants for PIM Modula-2
+        'm2pim': (
+            pim_stdlib_const_identifiers,
+        ),
+
+        # Standard Library Constants for ISO Modula-2
+        'm2iso': (
+            iso_stdlib_const_identifiers,
+        ),
+
+        # Standard Library Constants for Modula-2 R10
+        'm2r10': (
+            m2r10_stdlib_const_identifiers,
+        ),
+
+        # Standard Library Constants for Objective Modula-2
+        'objm2': (
+            m2r10_stdlib_const_identifiers,
+        ),
+
+        # Standard Library Constants for Aglet Modula-2
+        'm2iso+aglet': (
+            iso_stdlib_const_identifiers,
+        ),
+
+        # Standard Library Constants for GNU Modula-2
+        'm2pim+gm2': (
+            pim_stdlib_const_identifiers,
+        ),
+
+        # Standard Library Constants for p1 Modula-2
+        'm2iso+p1': (
+            iso_stdlib_const_identifiers,
+        ),
+
+        # Standard Library Constants for XDS Modula-2
+        'm2iso+xds': (
+            iso_stdlib_const_identifiers,
+        ),
+    }
+
+#   M e t h o d s
+
+    # initialise a lexer instance
+    def __init__(self, **options):
+        #
+        # check dialect options
+        #
+        dialects = get_list_opt(options, 'dialect', [])
+        #
+        for dialect_option in dialects:
+            if dialect_option in self.dialects[1:-1]:
+                # valid dialect option found
+                self.set_dialect(dialect_option)
+                break
+        #
+        # Fallback Mode (DEFAULT)
+        else:
+            # no valid dialect option
+            self.set_dialect('unknown')
+        #
+        self.dialect_set_by_tag = False
+        #
+        # check style options
+        #
+        styles = get_list_opt(options, 'style', [])
+        #
+        # use lowercase mode for Algol style
+        if 'algol' in styles or 'algol_nu' in styles:
+            self.algol_publication_mode = True
+        else:
+            self.algol_publication_mode = False
+        #
+        # Check option flags
+        #
+        self.treat_stdlib_adts_as_builtins = get_bool_opt(
+            options, 'treat_stdlib_adts_as_builtins', True)
+        #
+        # call superclass initialiser
+        RegexLexer.__init__(self, **options)
+
+    # Set lexer to a specified dialect
+    def set_dialect(self, dialect_id):
+        #
+        # if __debug__:
+        #    print 'entered set_dialect with arg: ', dialect_id
+        #
+        # check dialect name against known dialects
+        if dialect_id not in self.dialects:
+            dialect = 'unknown'  # default
+        else:
+            dialect = dialect_id
+        #
+        # compose lexemes to reject set
+        lexemes_to_reject_set = set()
+        # add each list of reject lexemes for this dialect
+        for list in self.lexemes_to_reject_db[dialect]:
+            lexemes_to_reject_set.update(set(list))
+        #
+        # compose reserved words set
+        reswords_set = set()
+        # add each list of reserved words for this dialect
+        for list in self.reserved_words_db[dialect]:
+            reswords_set.update(set(list))
+        #
+        # compose builtins set
+        builtins_set = set()
+        # add each list of builtins for this dialect excluding reserved words
+        for list in self.builtins_db[dialect]:
+            builtins_set.update(set(list).difference(reswords_set))
+        #
+        # compose pseudo-builtins set
+        pseudo_builtins_set = set()
+        # add each list of builtins for this dialect excluding reserved words
+        for list in self.pseudo_builtins_db[dialect]:
+            pseudo_builtins_set.update(set(list).difference(reswords_set))
+        #
+        # compose ADTs set
+        adts_set = set()
+        # add each list of ADTs for this dialect excluding reserved words
+        for list in self.stdlib_adts_db[dialect]:
+            adts_set.update(set(list).difference(reswords_set))
+        #
+        # compose modules set
+        modules_set = set()
+        # add each list of builtins for this dialect excluding builtins
+        for list in self.stdlib_modules_db[dialect]:
+            modules_set.update(set(list).difference(builtins_set))
+        #
+        # compose types set
+        types_set = set()
+        # add each list of types for this dialect excluding builtins
+        for list in self.stdlib_types_db[dialect]:
+            types_set.update(set(list).difference(builtins_set))
+        #
+        # compose procedures set
+        procedures_set = set()
+        # add each list of procedures for this dialect excluding builtins
+        for list in self.stdlib_procedures_db[dialect]:
+            procedures_set.update(set(list).difference(builtins_set))
+        #
+        # compose variables set
+        variables_set = set()
+        # add each list of variables for this dialect excluding builtins
+        for list in self.stdlib_variables_db[dialect]:
+            variables_set.update(set(list).difference(builtins_set))
+        #
+        # compose constants set
+        constants_set = set()
+        # add each list of constants for this dialect excluding builtins
+        for list in self.stdlib_constants_db[dialect]:
+            constants_set.update(set(list).difference(builtins_set))
+        #
+        # update lexer state
+        self.dialect = dialect
+        self.lexemes_to_reject = lexemes_to_reject_set
+        self.reserved_words = reswords_set
+        self.builtins = builtins_set
+        self.pseudo_builtins = pseudo_builtins_set
+        self.adts = adts_set
+        self.modules = modules_set
+        self.types = types_set
+        self.procedures = procedures_set
+        self.variables = variables_set
+        self.constants = constants_set
+        #
+        # if __debug__:
+        #    print 'exiting set_dialect'
+        #    print ' self.dialect: ', self.dialect
+        #    print ' self.lexemes_to_reject: ', self.lexemes_to_reject
+        #    print ' self.reserved_words: ', self.reserved_words
+        #    print ' self.builtins: ', self.builtins
+        #    print ' self.pseudo_builtins: ', self.pseudo_builtins
+        #    print ' self.adts: ', self.adts
+        #    print ' self.modules: ', self.modules
+        #    print ' self.types: ', self.types
+        #    print ' self.procedures: ', self.procedures
+        #    print ' self.variables: ', self.variables
+        #    print ' self.types: ', self.types
+        #    print ' self.constants: ', self.constants
+
+    # Extracts a dialect name from a dialect tag comment string  and checks
+    # the extracted name against known dialects.  If a match is found,  the
+    # matching name is returned, otherwise dialect id 'unknown' is returned
+    def get_dialect_from_dialect_tag(self, dialect_tag):
+        #
+        # if __debug__:
+        #    print 'entered get_dialect_from_dialect_tag with arg: ', dialect_tag
+        #
+        # constants
+        left_tag_delim = '(*!'
+        right_tag_delim = '*)'
+        left_tag_delim_len = len(left_tag_delim)
+        right_tag_delim_len = len(right_tag_delim)
+        indicator_start = left_tag_delim_len
+        indicator_end = -(right_tag_delim_len)
+        #
+        # check comment string for dialect indicator
+        if len(dialect_tag) > (left_tag_delim_len + right_tag_delim_len) \
+           and dialect_tag.startswith(left_tag_delim) \
+           and dialect_tag.endswith(right_tag_delim):
+            #
+            # if __debug__:
+            #    print 'dialect tag found'
+            #
+            # extract dialect indicator
+            indicator = dialect_tag[indicator_start:indicator_end]
+            #
+            # if __debug__:
+            #    print 'extracted: ', indicator
+            #
+            # check against known dialects
+            for index in range(1, len(self.dialects)):
+                #
+                # if __debug__:
+                #    print 'dialects[', index, ']: ', self.dialects[index]
+                #
+                if indicator == self.dialects[index]:
+                    #
+                    # if __debug__:
+                    #    print 'matching dialect found'
+                    #
+                    # indicator matches known dialect
+                    return indicator
+            else:
+                # indicator does not match any dialect
+                return 'unknown'  # default
+        else:
+            # invalid indicator string
+            return 'unknown'  # default
+
+    # intercept the token stream, modify token attributes and return them
+    def get_tokens_unprocessed(self, text):
+        for index, token, value in RegexLexer.get_tokens_unprocessed(self, text):
+            #
+            # check for dialect tag if dialect has not been set by tag
+            if not self.dialect_set_by_tag and token == Comment.Special:
+                indicated_dialect = self.get_dialect_from_dialect_tag(value)
+                if indicated_dialect != 'unknown':
+                    # token is a dialect indicator
+                    # reset reserved words and builtins
+                    self.set_dialect(indicated_dialect)
+                    self.dialect_set_by_tag = True
+            #
+            # check for reserved words, predefined and stdlib identifiers
+            if token is Name:
+                if value in self.reserved_words:
+                    token = Keyword.Reserved
+                    if self.algol_publication_mode:
+                        value = value.lower()
+                #
+                elif value in self.builtins:
+                    token = Name.Builtin
+                    if self.algol_publication_mode:
+                        value = value.lower()
+                #
+                elif value in self.pseudo_builtins:
+                    token = Name.Builtin.Pseudo
+                    if self.algol_publication_mode:
+                        value = value.lower()
+                #
+                elif value in self.adts:
+                    if not self.treat_stdlib_adts_as_builtins:
+                        token = Name.Namespace
+                    else:
+                        token = Name.Builtin.Pseudo
+                        if self.algol_publication_mode:
+                            value = value.lower()
+                #
+                elif value in self.modules:
+                    token = Name.Namespace
+                #
+                elif value in self.types:
+                    token = Name.Class
+                #
+                elif value in self.procedures:
+                    token = Name.Function
+                #
+                elif value in self.variables:
+                    token = Name.Variable
+                #
+                elif value in self.constants:
+                    token = Name.Constant
+            #
+            elif token in Number:
+                #
+                # mark prefix number literals as error for PIM and ISO dialects
+                if self.dialect not in ('unknown', 'm2r10', 'objm2'):
+                    if "'" in value or value[0:2] in ('0b', '0x', '0u'):
+                        token = Error
+                #
+                elif self.dialect in ('m2r10', 'objm2'):
+                    # mark base-8 number literals as errors for M2 R10 and ObjM2
+                    if token is Number.Oct:
+                        token = Error
+                    # mark suffix base-16 literals as errors for M2 R10 and ObjM2
+                    elif token is Number.Hex and 'H' in value:
+                        token = Error
+                    # mark real numbers with E as errors for M2 R10 and ObjM2
+                    elif token is Number.Float and 'E' in value:
+                        token = Error
+            #
+            elif token in Comment:
+                #
+                # mark single line comment as error for PIM and ISO dialects
+                if token is Comment.Single:
+                    if self.dialect not in ('unknown', 'm2r10', 'objm2'):
+                        token = Error
+                #
+                if token is Comment.Preproc:
+                    # mark ISO pragma as error for PIM dialects
+                    if value.startswith('<*') and \
+                       self.dialect.startswith('m2pim'):
+                        token = Error
+                    # mark PIM pragma as comment for other dialects
+                    elif value.startswith('(*$') and \
+                            self.dialect != 'unknown' and \
+                            not self.dialect.startswith('m2pim'):
+                        token = Comment.Multiline
+            #
+            else:  # token is neither Name nor Comment
+                #
+                # mark lexemes matching the dialect's error token set as errors
+                if value in self.lexemes_to_reject:
+                    token = Error
+                #
+                # substitute lexemes when in Algol mode
+                if self.algol_publication_mode:
+                    if value == '#':
+                        value = '≠'
+                    elif value == '<=':
+                        value = '≤'
+                    elif value == '>=':
+                        value = '≥'
+                    elif value == '==':
+                        value = '≡'
+                    elif value == '*.':
+                        value = '•'
+
+            # return result
+            yield index, token, value
+
+    def analyse_text(text):
+        """It's Pascal-like, but does not use FUNCTION -- uses PROCEDURE
+        instead."""
+
+        # Check if this looks like Pascal, if not, bail out early
+        if not ('(*' in text and '*)' in text and ':=' in text):
+            return
+
+        result = 0
+        # Procedure is in Modula2
+        if re.search(r'\bPROCEDURE\b', text):
+            result += 0.6
+
+        # FUNCTION is only valid in Pascal, but not in Modula2
+        if re.search(r'\bFUNCTION\b', text):
+            result = 0.0
+
+        return result
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/mojo.py b/env/lib/python3.12/site-packages/pygments/lexers/mojo.py
new file mode 100644
index 0000000..4df18c4
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/mojo.py
@@ -0,0 +1,707 @@
+"""
+    pygments.lexers.mojo
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Mojo and related languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import keyword
+
+from pygments import unistring as uni
+from pygments.lexer import (
+    RegexLexer,
+    bygroups,
+    combined,
+    default,
+    include,
+    this,
+    using,
+    words,
+)
+from pygments.token import (
+    Comment,
+    # Error,
+    Keyword,
+    Name,
+    Number,
+    Operator,
+    Punctuation,
+    String,
+    Text,
+    Whitespace,
+)
+from pygments.util import shebang_matches
+
+__all__ = ["MojoLexer"]
+
+
+class MojoLexer(RegexLexer):
+    """
+    For Mojo source code (version 24.2.1).
+    """
+
+    name = "Mojo"
+    url = "https://docs.modular.com/mojo/"
+    aliases = ["mojo", "🔥"]
+    filenames = [
+        "*.mojo",
+        "*.🔥",
+    ]
+    mimetypes = [
+        "text/x-mojo",
+        "application/x-mojo",
+    ]
+    version_added = "2.18"
+
+    uni_name = f"[{uni.xid_start}][{uni.xid_continue}]*"
+
+    def innerstring_rules(ttype):
+        return [
+            # the old style '%s' % (...) string formatting (still valid in Py3)
+            (
+                r"%(\(\w+\))?[-#0 +]*([0-9]+|[*])?(\.([0-9]+|[*]))?"
+                "[hlL]?[E-GXc-giorsaux%]",
+                String.Interpol,
+            ),
+            # the new style '{}'.format(...) string formatting
+            (
+                r"\{"
+                r"((\w+)((\.\w+)|(\[[^\]]+\]))*)?"  # field name
+                r"(\![sra])?"  # conversion
+                r"(\:(.?[<>=\^])?[-+ ]?#?0?(\d+)?,?(\.\d+)?[E-GXb-gnosx%]?)?"
+                r"\}",
+                String.Interpol,
+            ),
+            # backslashes, quotes and formatting signs must be parsed one at a time
+            (r'[^\\\'"%{\n]+', ttype),
+            (r'[\'"\\]', ttype),
+            # unhandled string formatting sign
+            (r"%|(\{{1,2})", ttype),
+            # newlines are an error (use "nl" state)
+        ]
+
+    def fstring_rules(ttype):
+        return [
+            # Assuming that a '}' is the closing brace after format specifier.
+            # Sadly, this means that we won't detect syntax error. But it's
+            # more important to parse correct syntax correctly, than to
+            # highlight invalid syntax.
+            (r"\}", String.Interpol),
+            (r"\{", String.Interpol, "expr-inside-fstring"),
+            # backslashes, quotes and formatting signs must be parsed one at a time
+            (r'[^\\\'"{}\n]+', ttype),
+            (r'[\'"\\]', ttype),
+            # newlines are an error (use "nl" state)
+        ]
+
+    tokens = {
+        "root": [
+            (r"\s+", Whitespace),
+            (
+                r'^(\s*)([rRuUbB]{,2})("""(?:.|\n)*?""")',
+                bygroups(Whitespace, String.Affix, String.Doc),
+            ),
+            (
+                r"^(\s*)([rRuUbB]{,2})('''(?:.|\n)*?''')",
+                bygroups(Whitespace, String.Affix, String.Doc),
+            ),
+            (r"\A#!.+$", Comment.Hashbang),
+            (r"#.*$", Comment.Single),
+            (r"\\\n", Whitespace),
+            (r"\\", Whitespace),
+            include("keywords"),
+            include("soft-keywords"),
+            # In the original PR, all the below here used ((?:\s|\\\s)+) to
+            # designate whitespace, but I can't find any example of this being
+            # needed in the example file, so we're replacing it with `\s+`.
+            (
+                r"(alias)(\s+)",
+                bygroups(Keyword, Whitespace),
+                "varname",  # TODO varname the right fit?
+            ),
+            (r"(var)(\s+)", bygroups(Keyword, Whitespace), "varname"),
+            (r"(def)(\s+)", bygroups(Keyword, Whitespace), "funcname"),
+            (r"(fn)(\s+)", bygroups(Keyword, Whitespace), "funcname"),
+            (
+                r"(class)(\s+)",
+                bygroups(Keyword, Whitespace),
+                "classname",
+            ),  # not implemented yet
+            (r"(struct)(\s+)", bygroups(Keyword, Whitespace), "structname"),
+            (r"(trait)(\s+)", bygroups(Keyword, Whitespace), "structname"),
+            (r"(from)(\s+)", bygroups(Keyword.Namespace, Whitespace), "fromimport"),
+            (r"(import)(\s+)", bygroups(Keyword.Namespace, Whitespace), "import"),
+            include("expr"),
+        ],
+        "expr": [
+            # raw f-strings
+            (
+                '(?i)(rf|fr)(""")',
+                bygroups(String.Affix, String.Double),
+                combined("rfstringescape", "tdqf"),
+            ),
+            (
+                "(?i)(rf|fr)(''')",
+                bygroups(String.Affix, String.Single),
+                combined("rfstringescape", "tsqf"),
+            ),
+            (
+                '(?i)(rf|fr)(")',
+                bygroups(String.Affix, String.Double),
+                combined("rfstringescape", "dqf"),
+            ),
+            (
+                "(?i)(rf|fr)(')",
+                bygroups(String.Affix, String.Single),
+                combined("rfstringescape", "sqf"),
+            ),
+            # non-raw f-strings
+            (
+                '([fF])(""")',
+                bygroups(String.Affix, String.Double),
+                combined("fstringescape", "tdqf"),
+            ),
+            (
+                "([fF])(''')",
+                bygroups(String.Affix, String.Single),
+                combined("fstringescape", "tsqf"),
+            ),
+            (
+                '([fF])(")',
+                bygroups(String.Affix, String.Double),
+                combined("fstringescape", "dqf"),
+            ),
+            (
+                "([fF])(')",
+                bygroups(String.Affix, String.Single),
+                combined("fstringescape", "sqf"),
+            ),
+            # raw bytes and strings
+            ('(?i)(rb|br|r)(""")', bygroups(String.Affix, String.Double), "tdqs"),
+            ("(?i)(rb|br|r)(''')", bygroups(String.Affix, String.Single), "tsqs"),
+            ('(?i)(rb|br|r)(")', bygroups(String.Affix, String.Double), "dqs"),
+            ("(?i)(rb|br|r)(')", bygroups(String.Affix, String.Single), "sqs"),
+            # non-raw strings
+            (
+                '([uU]?)(""")',
+                bygroups(String.Affix, String.Double),
+                combined("stringescape", "tdqs"),
+            ),
+            (
+                "([uU]?)(''')",
+                bygroups(String.Affix, String.Single),
+                combined("stringescape", "tsqs"),
+            ),
+            (
+                '([uU]?)(")',
+                bygroups(String.Affix, String.Double),
+                combined("stringescape", "dqs"),
+            ),
+            (
+                "([uU]?)(')",
+                bygroups(String.Affix, String.Single),
+                combined("stringescape", "sqs"),
+            ),
+            # non-raw bytes
+            (
+                '([bB])(""")',
+                bygroups(String.Affix, String.Double),
+                combined("bytesescape", "tdqs"),
+            ),
+            (
+                "([bB])(''')",
+                bygroups(String.Affix, String.Single),
+                combined("bytesescape", "tsqs"),
+            ),
+            (
+                '([bB])(")',
+                bygroups(String.Affix, String.Double),
+                combined("bytesescape", "dqs"),
+            ),
+            (
+                "([bB])(')",
+                bygroups(String.Affix, String.Single),
+                combined("bytesescape", "sqs"),
+            ),
+            (r"[^\S\n]+", Text),
+            include("numbers"),
+            (r"!=|==|<<|>>|:=|[-~+/*%=<>&^|.]", Operator),
+            (r"([]{}:\(\),;[])+", Punctuation),
+            (r"(in|is|and|or|not)\b", Operator.Word),
+            include("expr-keywords"),
+            include("builtins"),
+            include("magicfuncs"),
+            include("magicvars"),
+            include("name"),
+        ],
+        "expr-inside-fstring": [
+            (r"[{([]", Punctuation, "expr-inside-fstring-inner"),
+            # without format specifier
+            (
+                r"(=\s*)?"  # debug (https://bugs.python.org/issue36817)
+                r"(\![sraf])?"  # conversion
+                r"\}",
+                String.Interpol,
+                "#pop",
+            ),
+            # with format specifier
+            # we'll catch the remaining '}' in the outer scope
+            (
+                r"(=\s*)?"  # debug (https://bugs.python.org/issue36817)
+                r"(\![sraf])?"  # conversion
+                r":",
+                String.Interpol,
+                "#pop",
+            ),
+            (r"\s+", Whitespace),  # allow new lines
+            include("expr"),
+        ],
+        "expr-inside-fstring-inner": [
+            (r"[{([]", Punctuation, "expr-inside-fstring-inner"),
+            (r"[])}]", Punctuation, "#pop"),
+            (r"\s+", Whitespace),  # allow new lines
+            include("expr"),
+        ],
+        "expr-keywords": [
+            # Based on https://docs.python.org/3/reference/expressions.html
+            (
+                words(
+                    (
+                        "async for",  # TODO https://docs.modular.com/mojo/roadmap#no-async-for-or-async-with
+                        "async with",  # TODO https://docs.modular.com/mojo/roadmap#no-async-for-or-async-with
+                        "await",
+                        "else",
+                        "for",
+                        "if",
+                        "lambda",
+                        "yield",
+                        "yield from",
+                    ),
+                    suffix=r"\b",
+                ),
+                Keyword,
+            ),
+            (words(("True", "False", "None"), suffix=r"\b"), Keyword.Constant),
+        ],
+        "keywords": [
+            (
+                words(
+                    (
+                        "assert",
+                        "async",
+                        "await",
+                        "borrowed",
+                        "break",
+                        "continue",
+                        "del",
+                        "elif",
+                        "else",
+                        "except",
+                        "finally",
+                        "for",
+                        "global",
+                        "if",
+                        "lambda",
+                        "pass",
+                        "raise",
+                        "nonlocal",
+                        "return",
+                        "try",
+                        "while",
+                        "yield",
+                        "yield from",
+                        "as",
+                        "with",
+                    ),
+                    suffix=r"\b",
+                ),
+                Keyword,
+            ),
+            (words(("True", "False", "None"), suffix=r"\b"), Keyword.Constant),
+        ],
+        "soft-keywords": [
+            # `match`, `case` and `_` soft keywords
+            (
+                r"(^[ \t]*)"  # at beginning of line + possible indentation
+                r"(match|case)\b"  # a possible keyword
+                r"(?![ \t]*(?:"  # not followed by...
+                r"[:,;=^&|@~)\]}]|(?:" +  # characters and keywords that mean this isn't
+                # pattern matching (but None/True/False is ok)
+                r"|".join(k for k in keyword.kwlist if k[0].islower())
+                + r")\b))",
+                bygroups(Whitespace, Keyword),
+                "soft-keywords-inner",
+            ),
+        ],
+        "soft-keywords-inner": [
+            # optional `_` keyword
+            (r"(\s+)([^\n_]*)(_\b)", bygroups(Whitespace, using(this), Keyword)),
+            default("#pop"),
+        ],
+        "builtins": [
+            (
+                words(
+                    (
+                        "__import__",
+                        "abs",
+                        "aiter",
+                        "all",
+                        "any",
+                        "bin",
+                        "bool",
+                        "bytearray",
+                        "breakpoint",
+                        "bytes",
+                        "callable",
+                        "chr",
+                        "classmethod",
+                        "compile",
+                        "complex",
+                        "delattr",
+                        "dict",
+                        "dir",
+                        "divmod",
+                        "enumerate",
+                        "eval",
+                        "filter",
+                        "float",
+                        "format",
+                        "frozenset",
+                        "getattr",
+                        "globals",
+                        "hasattr",
+                        "hash",
+                        "hex",
+                        "id",
+                        "input",
+                        "int",
+                        "isinstance",
+                        "issubclass",
+                        "iter",
+                        "len",
+                        "list",
+                        "locals",
+                        "map",
+                        "max",
+                        "memoryview",
+                        "min",
+                        "next",
+                        "object",
+                        "oct",
+                        "open",
+                        "ord",
+                        "pow",
+                        "print",
+                        "property",
+                        "range",
+                        "repr",
+                        "reversed",
+                        "round",
+                        "set",
+                        "setattr",
+                        "slice",
+                        "sorted",
+                        "staticmethod",
+                        "str",
+                        "sum",
+                        "super",
+                        "tuple",
+                        "type",
+                        "vars",
+                        "zip",
+                        # Mojo builtin types: https://docs.modular.com/mojo/stdlib/builtin/
+                        "AnyType",
+                        "Coroutine",
+                        "DType",
+                        "Error",
+                        "Int",
+                        "List",
+                        "ListLiteral",
+                        "Scalar",
+                        "Int8",
+                        "UInt8",
+                        "Int16",
+                        "UInt16",
+                        "Int32",
+                        "UInt32",
+                        "Int64",
+                        "UInt64",
+                        "BFloat16",
+                        "Float16",
+                        "Float32",
+                        "Float64",
+                        "SIMD",
+                        "String",
+                        "Tensor",
+                        "Tuple",
+                        "Movable",
+                        "Copyable",
+                        "CollectionElement",
+                    ),
+                    prefix=r"(?>',
+    # Binary augmented
+    '+=', '-=', '*=', '/=', '%=', '**=', '&=', '|=', '^=', '<<=', '>>=',
+    # Comparison
+    '==', '!=', '<', '<=', '>', '>=', '<=>',
+    # Patterns and assignment
+    ':=', '?', '=~', '!~', '=>',
+    # Calls and sends
+    '.', '<-', '->',
+]
+_escape_pattern = (
+    r'(?:\\x[0-9a-fA-F]{2}|\\u[0-9a-fA-F]{4}|\\U[0-9a-fA-F]{8}|'
+    r'\\["\'\\bftnr])')
+# _char = _escape_chars + [('.', String.Char)]
+_identifier = r'[_a-zA-Z]\w*'
+
+_constants = [
+    # Void constants
+    'null',
+    # Bool constants
+    'false', 'true',
+    # Double constants
+    'Infinity', 'NaN',
+    # Special objects
+    'M', 'Ref', 'throw', 'traceln',
+]
+
+_guards = [
+    'Any', 'Binding', 'Bool', 'Bytes', 'Char', 'DeepFrozen', 'Double',
+    'Empty', 'Int', 'List', 'Map', 'Near', 'NullOk', 'Same', 'Selfless',
+    'Set', 'Str', 'SubrangeGuard', 'Transparent', 'Void',
+]
+
+_safeScope = [
+    '_accumulateList', '_accumulateMap', '_auditedBy', '_bind',
+    '_booleanFlow', '_comparer', '_equalizer', '_iterForever', '_loop',
+    '_makeBytes', '_makeDouble', '_makeFinalSlot', '_makeInt', '_makeList',
+    '_makeMap', '_makeMessageDesc', '_makeOrderedSpace', '_makeParamDesc',
+    '_makeProtocolDesc', '_makeSourceSpan', '_makeString', '_makeVarSlot',
+    '_makeVerbFacet', '_mapExtract', '_matchSame', '_quasiMatcher',
+    '_slotToBinding', '_splitList', '_suchThat', '_switchFailed',
+    '_validateFor', 'b__quasiParser', 'eval', 'import', 'm__quasiParser',
+    'makeBrandPair', 'makeLazySlot', 'safeScope', 'simple__quasiParser',
+]
+
+
+class MonteLexer(RegexLexer):
+    """
+    Lexer for the Monte programming language.
+    """
+    name = 'Monte'
+    url = 'https://monte.readthedocs.io/'
+    aliases = ['monte']
+    filenames = ['*.mt']
+    version_added = '2.2'
+
+    tokens = {
+        'root': [
+            # Comments
+            (r'#[^\n]*\n', Comment),
+
+            # Docstrings
+            # Apologies for the non-greedy matcher here.
+            (r'/\*\*.*?\*/', String.Doc),
+
+            # `var` declarations
+            (r'\bvar\b', Keyword.Declaration, 'var'),
+
+            # `interface` declarations
+            (r'\binterface\b', Keyword.Declaration, 'interface'),
+
+            # method declarations
+            (words(_methods, prefix='\\b', suffix='\\b'),
+             Keyword, 'method'),
+
+            # All other declarations
+            (words(_declarations, prefix='\\b', suffix='\\b'),
+             Keyword.Declaration),
+
+            # Keywords
+            (words(_keywords, prefix='\\b', suffix='\\b'), Keyword),
+
+            # Literals
+            ('[+-]?0x[_0-9a-fA-F]+', Number.Hex),
+            (r'[+-]?[_0-9]+\.[_0-9]*([eE][+-]?[_0-9]+)?', Number.Float),
+            ('[+-]?[_0-9]+', Number.Integer),
+            ("'", String.Double, 'char'),
+            ('"', String.Double, 'string'),
+
+            # Quasiliterals
+            ('`', String.Backtick, 'ql'),
+
+            # Operators
+            (words(_operators), Operator),
+
+            # Verb operators
+            (_identifier + '=', Operator.Word),
+
+            # Safe scope constants
+            (words(_constants, prefix='\\b', suffix='\\b'),
+             Keyword.Pseudo),
+
+            # Safe scope guards
+            (words(_guards, prefix='\\b', suffix='\\b'), Keyword.Type),
+
+            # All other safe scope names
+            (words(_safeScope, prefix='\\b', suffix='\\b'),
+             Name.Builtin),
+
+            # Identifiers
+            (_identifier, Name),
+
+            # Punctuation
+            (r'\(|\)|\{|\}|\[|\]|:|,', Punctuation),
+
+            # Whitespace
+            (' +', Whitespace),
+
+            # Definite lexer errors
+            ('=', Error),
+        ],
+        'char': [
+            # It is definitely an error to have a char of width == 0.
+            ("'", Error, 'root'),
+            (_escape_pattern, String.Escape, 'charEnd'),
+            ('.', String.Char, 'charEnd'),
+        ],
+        'charEnd': [
+            ("'", String.Char, '#pop:2'),
+            # It is definitely an error to have a char of width > 1.
+            ('.', Error),
+        ],
+        # The state of things coming into an interface.
+        'interface': [
+            (' +', Whitespace),
+            (_identifier, Name.Class, '#pop'),
+            include('root'),
+        ],
+        # The state of things coming into a method.
+        'method': [
+            (' +', Whitespace),
+            (_identifier, Name.Function, '#pop'),
+            include('root'),
+        ],
+        'string': [
+            ('"', String.Double, 'root'),
+            (_escape_pattern, String.Escape),
+            (r'\n', String.Double),
+            ('.', String.Double),
+        ],
+        'ql': [
+            ('`', String.Backtick, 'root'),
+            (r'\$' + _escape_pattern, String.Escape),
+            (r'\$\$', String.Escape),
+            (r'@@', String.Escape),
+            (r'\$\{', String.Interpol, 'qlNest'),
+            (r'@\{', String.Interpol, 'qlNest'),
+            (r'\$' + _identifier, Name),
+            ('@' + _identifier, Name),
+            ('.', String.Backtick),
+        ],
+        'qlNest': [
+            (r'\}', String.Interpol, '#pop'),
+            include('root'),
+        ],
+        # The state of things immediately following `var`.
+        'var': [
+            (' +', Whitespace),
+            (_identifier, Name.Variable, '#pop'),
+            include('root'),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/mosel.py b/env/lib/python3.12/site-packages/pygments/lexers/mosel.py
new file mode 100644
index 0000000..426c9a1
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/mosel.py
@@ -0,0 +1,447 @@
+"""
+    pygments.lexers.mosel
+    ~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for the mosel language.
+    http://www.fico.com/en/products/fico-xpress-optimization
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, words
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation
+
+__all__ = ['MoselLexer']
+
+FUNCTIONS = (
+    # core functions
+    '_',
+    'abs',
+    'arctan',
+    'asproc',
+    'assert',
+    'bitflip',
+    'bitneg',
+    'bitset',
+    'bitshift',
+    'bittest',
+    'bitval',
+    'ceil',
+    'cos',
+    'create',
+    'currentdate',
+    'currenttime',
+    'cutelt',
+    'cutfirst',
+    'cuthead',
+    'cutlast',
+    'cuttail',
+    'datablock',
+    'delcell',
+    'exists',
+    'exit',
+    'exp',
+    'exportprob',
+    'fclose',
+    'fflush',
+    'finalize',
+    'findfirst',
+    'findlast',
+    'floor',
+    'fopen',
+    'fselect',
+    'fskipline',
+    'fwrite',
+    'fwrite_',
+    'fwriteln',
+    'fwriteln_',
+    'getact',
+    'getcoeff',
+    'getcoeffs',
+    'getdual',
+    'getelt',
+    'getfid',
+    'getfirst',
+    'getfname',
+    'gethead',
+    'getlast',
+    'getobjval',
+    'getparam',
+    'getrcost',
+    'getreadcnt',
+    'getreverse',
+    'getsize',
+    'getslack',
+    'getsol',
+    'gettail',
+    'gettype',
+    'getvars',
+    'isdynamic',
+    'iseof',
+    'isfinite',
+    'ishidden',
+    'isinf',
+    'isnan',
+    'isodd',
+    'ln',
+    'localsetparam',
+    'log',
+    'makesos1',
+    'makesos2',
+    'maxlist',
+    'memoryuse',
+    'minlist',
+    'newmuid',
+    'publish',
+    'random',
+    'read',
+    'readln',
+    'reset',
+    'restoreparam',
+    'reverse',
+    'round',
+    'setcoeff',
+    'sethidden',
+    'setioerr',
+    'setmatherr',
+    'setname',
+    'setparam',
+    'setrandseed',
+    'setrange',
+    'settype',
+    'sin',
+    'splithead',
+    'splittail',
+    'sqrt',
+    'strfmt',
+    'substr',
+    'timestamp',
+    'unpublish',
+    'versionnum',
+    'versionstr',
+    'write',
+    'write_',
+    'writeln',
+    'writeln_',
+
+    # mosel exam mmxprs | sed -n -e "s/ [pf][a-z]* \([a-zA-Z0-9_]*\).*/'\1',/p" | sort -u
+    'addcut',
+    'addcuts',
+    'addmipsol',
+    'basisstability',
+    'calcsolinfo',
+    'clearmipdir',
+    'clearmodcut',
+    'command',
+    'copysoltoinit',
+    'crossoverlpsol',
+    'defdelayedrows',
+    'defsecurevecs',
+    'delcuts',
+    'dropcuts',
+    'estimatemarginals',
+    'fixglobal',
+    'flushmsgq',
+    'getbstat',
+    'getcnlist',
+    'getcplist',
+    'getdualray',
+    'getiis',
+    'getiissense',
+    'getiistype',
+    'getinfcause',
+    'getinfeas',
+    'getlb',
+    'getlct',
+    'getleft',
+    'getloadedlinctrs',
+    'getloadedmpvars',
+    'getname',
+    'getprimalray',
+    'getprobstat',
+    'getrange',
+    'getright',
+    'getsensrng',
+    'getsize',
+    'getsol',
+    'gettype',
+    'getub',
+    'getvars',
+    'gety',
+    'hasfeature',
+    'implies',
+    'indicator',
+    'initglobal',
+    'ishidden',
+    'isiisvalid',
+    'isintegral',
+    'loadbasis',
+    'loadcuts',
+    'loadlpsol',
+    'loadmipsol',
+    'loadprob',
+    'maximise',
+    'maximize',
+    'minimise',
+    'minimize',
+    'postsolve',
+    'readbasis',
+    'readdirs',
+    'readsol',
+    'refinemipsol',
+    'rejectintsol',
+    'repairinfeas',
+    'repairinfeas_deprec',
+    'resetbasis',
+    'resetiis',
+    'resetsol',
+    'savebasis',
+    'savemipsol',
+    'savesol',
+    'savestate',
+    'selectsol',
+    'setarchconsistency',
+    'setbstat',
+    'setcallback',
+    'setcbcutoff',
+    'setgndata',
+    'sethidden',
+    'setlb',
+    'setmipdir',
+    'setmodcut',
+    'setsol',
+    'setub',
+    'setucbdata',
+    'stopoptimise',
+    'stopoptimize',
+    'storecut',
+    'storecuts',
+    'unloadprob',
+    'uselastbarsol',
+    'writebasis',
+    'writedirs',
+    'writeprob',
+    'writesol',
+    'xor',
+    'xprs_addctr',
+    'xprs_addindic',
+
+    # mosel exam mmsystem | sed -n -e "s/ [pf][a-z]* \([a-zA-Z0-9_]*\).*/'\1',/p" | sort -u
+    'addmonths',
+    'copytext',
+    'cuttext',
+    'deltext',
+    'endswith',
+    'erase',
+    'expandpath',
+    'fcopy',
+    'fdelete',
+    'findfiles',
+    'findtext',
+    'fmove',
+    'formattext',
+    'getasnumber',
+    'getchar',
+    'getcwd',
+    'getdate',
+    'getday',
+    'getdaynum',
+    'getdays',
+    'getdirsep',
+    'getdsoparam',
+    'getendparse',
+    'getenv',
+    'getfsize',
+    'getfstat',
+    'getftime',
+    'gethour',
+    'getminute',
+    'getmonth',
+    'getmsec',
+    'getoserrmsg',
+    'getoserror',
+    'getpathsep',
+    'getqtype',
+    'getsecond',
+    'getsepchar',
+    'getsize',
+    'getstart',
+    'getsucc',
+    'getsysinfo',
+    'getsysstat',
+    'gettime',
+    'gettmpdir',
+    'gettrim',
+    'getweekday',
+    'getyear',
+    'inserttext',
+    'isvalid',
+    'jointext',
+    'makedir',
+    'makepath',
+    'newtar',
+    'newzip',
+    'nextfield',
+    'openpipe',
+    'parseextn',
+    'parseint',
+    'parsereal',
+    'parsetext',
+    'pastetext',
+    'pathmatch',
+    'pathsplit',
+    'qsort',
+    'quote',
+    'readtextline',
+    'regmatch',
+    'regreplace',
+    'removedir',
+    'removefiles',
+    'setchar',
+    'setdate',
+    'setday',
+    'setdsoparam',
+    'setendparse',
+    'setenv',
+    'sethour',
+    'setminute',
+    'setmonth',
+    'setmsec',
+    'setoserror',
+    'setqtype',
+    'setsecond',
+    'setsepchar',
+    'setstart',
+    'setsucc',
+    'settime',
+    'settrim',
+    'setyear',
+    'sleep',
+    'splittext',
+    'startswith',
+    'system',
+    'tarlist',
+    'textfmt',
+    'tolower',
+    'toupper',
+    'trim',
+    'untar',
+    'unzip',
+    'ziplist',
+
+    # mosel exam mmjobs | sed -n -e "s/ [pf][a-z]* \([a-zA-Z0-9_]*\).*/'\1',/p" | sort -u
+    'canceltimer',
+    'clearaliases',
+    'compile',
+    'connect',
+    'detach',
+    'disconnect',
+    'dropnextevent',
+    'findxsrvs',
+    'getaliases',
+    'getannidents',
+    'getannotations',
+    'getbanner',
+    'getclass',
+    'getdsoprop',
+    'getdsopropnum',
+    'getexitcode',
+    'getfromgid',
+    'getfromid',
+    'getfromuid',
+    'getgid',
+    'gethostalias',
+    'getid',
+    'getmodprop',
+    'getmodpropnum',
+    'getnextevent',
+    'getnode',
+    'getrmtid',
+    'getstatus',
+    'getsysinfo',
+    'gettimer',
+    'getuid',
+    'getvalue',
+    'isqueueempty',
+    'load',
+    'nullevent',
+    'peeknextevent',
+    'resetmodpar',
+    'run',
+    'send',
+    'setcontrol',
+    'setdefstream',
+    'setgid',
+    'sethostalias',
+    'setmodpar',
+    'settimer',
+    'setuid',
+    'setworkdir',
+    'stop',
+    'unload',
+    'wait',
+    'waitexpired',
+    'waitfor',
+    'waitforend',
+)
+
+
+class MoselLexer(RegexLexer):
+    """
+    For the Mosel optimization language.
+    """
+    name = 'Mosel'
+    aliases = ['mosel']
+    filenames = ['*.mos']
+    url = 'https://www.fico.com/fico-xpress-optimization/docs/latest/mosel/mosel_lang/dhtml/moselreflang.html'
+    version_added = '2.6'
+
+    tokens = {
+        'root': [
+            (r'\n', Text),
+            (r'\s+', Text.Whitespace),
+            (r'!.*?\n', Comment.Single),
+            (r'\(!(.|\n)*?!\)', Comment.Multiline),
+            (words((
+                'and', 'as', 'break', 'case', 'count', 'declarations', 'do',
+                'dynamic', 'elif', 'else', 'end-', 'end', 'evaluation', 'false',
+                'forall', 'forward', 'from', 'function', 'hashmap', 'if',
+                'imports', 'include', 'initialisations', 'initializations', 'inter',
+                'max', 'min', 'model', 'namespace', 'next', 'not', 'nsgroup',
+                'nssearch', 'of', 'options', 'or', 'package', 'parameters',
+                'procedure', 'public', 'prod', 'record', 'repeat', 'requirements',
+                'return', 'sum', 'then', 'to', 'true', 'union', 'until', 'uses',
+                'version', 'while', 'with'), prefix=r'\b', suffix=r'\b'),
+             Keyword.Builtin),
+            (words((
+                'range', 'array', 'set', 'list', 'mpvar', 'mpproblem', 'linctr',
+                'nlctr', 'integer', 'string', 'real', 'boolean', 'text', 'time',
+                'date', 'datetime', 'returned', 'Model', 'Mosel', 'counter',
+                'xmldoc', 'is_sos1', 'is_sos2', 'is_integer', 'is_binary',
+                'is_continuous', 'is_free', 'is_semcont', 'is_semint',
+                'is_partint'), prefix=r'\b', suffix=r'\b'),
+             Keyword.Type),
+            (r'(\+|\-|\*|/|=|<=|>=|\||\^|<|>|<>|\.\.|\.|:=|::|:|in|mod|div)',
+             Operator),
+            (r'[()\[\]{},;]+', Punctuation),
+            (words(FUNCTIONS,  prefix=r'\b', suffix=r'\b'), Name.Function),
+            (r'(\d+\.(?!\.)\d*|\.(?!.)\d+)([eE][+-]?\d+)?', Number.Float),
+            (r'\d+([eE][+-]?\d+)?', Number.Integer),
+            (r'[+-]?Infinity', Number.Integer),
+            (r'0[xX][0-9a-fA-F]+', Number),
+            (r'"', String.Double, 'double_quote'),
+            (r'\'', String.Single, 'single_quote'),
+            (r'(\w+|(\.(?!\.)))', Text),
+        ],
+        'single_quote': [
+            (r'\'', String.Single, '#pop'),
+            (r'[^\']+', String.Single),
+        ],
+        'double_quote': [
+            (r'(\\"|\\[0-7]{1,3}\D|\\[abfnrtv]|\\\\)', String.Escape),
+            (r'\"', String.Double, '#pop'),
+            (r'[^"\\]+', String.Double),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/ncl.py b/env/lib/python3.12/site-packages/pygments/lexers/ncl.py
new file mode 100644
index 0000000..d2f4760
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/ncl.py
@@ -0,0 +1,894 @@
+"""
+    pygments.lexers.ncl
+    ~~~~~~~~~~~~~~~~~~~
+
+    Lexers for NCAR Command Language.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, include, words
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation
+
+__all__ = ['NCLLexer']
+
+
+class NCLLexer(RegexLexer):
+    """
+    Lexer for NCL code.
+    """
+    name = 'NCL'
+    aliases = ['ncl']
+    filenames = ['*.ncl']
+    mimetypes = ['text/ncl']
+    url = 'https://www.ncl.ucar.edu'
+    version_added = '2.2'
+
+    flags = re.MULTILINE
+
+    tokens = {
+        'root': [
+            (r';.*\n', Comment),
+            include('strings'),
+            include('core'),
+            (r'[a-zA-Z_]\w*', Name),
+            include('nums'),
+            (r'[\s]+', Text),
+        ],
+        'core': [
+            # Statements
+            (words((
+                'begin', 'break', 'continue', 'create', 'defaultapp', 'do',
+                'else', 'end', 'external', 'exit', 'True', 'False', 'file', 'function',
+                'getvalues', 'graphic', 'group', 'if', 'list', 'load', 'local',
+                'new', '_Missing', 'Missing', 'noparent', 'procedure',
+                'quit', 'QUIT', 'Quit', 'record', 'return', 'setvalues', 'stop',
+                'then', 'while'), prefix=r'\b', suffix=r'\s*\b'),
+             Keyword),
+
+            # Data Types
+            (words((
+                'ubyte', 'uint', 'uint64', 'ulong', 'string', 'byte',
+                'character', 'double', 'float', 'integer', 'int64', 'logical',
+                'long', 'short', 'ushort', 'enumeric', 'numeric', 'snumeric'),
+                prefix=r'\b', suffix=r'\s*\b'),
+             Keyword.Type),
+
+            # Operators
+            (r'[\%^*+\-/<>]', Operator),
+
+            # punctuation:
+            (r'[\[\]():@$!&|.,\\{}]', Punctuation),
+            (r'[=:]', Punctuation),
+
+            # Intrinsics
+            (words((
+                'abs', 'acos', 'addfile', 'addfiles', 'all', 'angmom_atm', 'any',
+                'area_conserve_remap', 'area_hi2lores', 'area_poly_sphere',
+                'asciiread', 'asciiwrite', 'asin', 'atan', 'atan2', 'attsetvalues',
+                'avg', 'betainc', 'bin_avg', 'bin_sum', 'bw_bandpass_filter',
+                'cancor', 'cbinread', 'cbinwrite', 'cd_calendar', 'cd_inv_calendar',
+                'cdfbin_p', 'cdfbin_pr', 'cdfbin_s', 'cdfbin_xn', 'cdfchi_p',
+                'cdfchi_x', 'cdfgam_p', 'cdfgam_x', 'cdfnor_p', 'cdfnor_x',
+                'cdft_p', 'cdft_t', 'ceil', 'center_finite_diff',
+                'center_finite_diff_n', 'cfftb', 'cfftf', 'cfftf_frq_reorder',
+                'charactertodouble', 'charactertofloat', 'charactertointeger',
+                'charactertolong', 'charactertoshort', 'charactertostring',
+                'chartodouble', 'chartofloat', 'chartoint', 'chartointeger',
+                'chartolong', 'chartoshort', 'chartostring', 'chiinv', 'clear',
+                'color_index_to_rgba', 'conform', 'conform_dims', 'cos', 'cosh',
+                'count_unique_values', 'covcorm', 'covcorm_xy', 'craybinnumrec',
+                'craybinrecread', 'create_graphic', 'csa1', 'csa1d', 'csa1s',
+                'csa1x', 'csa1xd', 'csa1xs', 'csa2', 'csa2d', 'csa2l', 'csa2ld',
+                'csa2ls', 'csa2lx', 'csa2lxd', 'csa2lxs', 'csa2s', 'csa2x',
+                'csa2xd', 'csa2xs', 'csa3', 'csa3d', 'csa3l', 'csa3ld', 'csa3ls',
+                'csa3lx', 'csa3lxd', 'csa3lxs', 'csa3s', 'csa3x', 'csa3xd',
+                'csa3xs', 'csc2s', 'csgetp', 'css2c', 'cssetp', 'cssgrid', 'csstri',
+                'csvoro', 'cumsum', 'cz2ccm', 'datatondc', 'day_of_week',
+                'day_of_year', 'days_in_month', 'default_fillvalue', 'delete',
+                'depth_to_pres', 'destroy', 'determinant', 'dewtemp_trh',
+                'dgeevx_lapack', 'dim_acumrun_n', 'dim_avg', 'dim_avg_n',
+                'dim_avg_wgt', 'dim_avg_wgt_n', 'dim_cumsum', 'dim_cumsum_n',
+                'dim_gamfit_n', 'dim_gbits', 'dim_max', 'dim_max_n', 'dim_median',
+                'dim_median_n', 'dim_min', 'dim_min_n', 'dim_num', 'dim_num_n',
+                'dim_numrun_n', 'dim_pqsort', 'dim_pqsort_n', 'dim_product',
+                'dim_product_n', 'dim_rmsd', 'dim_rmsd_n', 'dim_rmvmean',
+                'dim_rmvmean_n', 'dim_rmvmed', 'dim_rmvmed_n', 'dim_spi_n',
+                'dim_standardize', 'dim_standardize_n', 'dim_stat4', 'dim_stat4_n',
+                'dim_stddev', 'dim_stddev_n', 'dim_sum', 'dim_sum_n', 'dim_sum_wgt',
+                'dim_sum_wgt_n', 'dim_variance', 'dim_variance_n', 'dimsizes',
+                'doubletobyte', 'doubletochar', 'doubletocharacter',
+                'doubletofloat', 'doubletoint', 'doubletointeger', 'doubletolong',
+                'doubletoshort', 'dpres_hybrid_ccm', 'dpres_plevel', 'draw',
+                'draw_color_palette', 'dsgetp', 'dsgrid2', 'dsgrid2d', 'dsgrid2s',
+                'dsgrid3', 'dsgrid3d', 'dsgrid3s', 'dspnt2', 'dspnt2d', 'dspnt2s',
+                'dspnt3', 'dspnt3d', 'dspnt3s', 'dssetp', 'dtrend', 'dtrend_msg',
+                'dtrend_msg_n', 'dtrend_n', 'dtrend_quadratic',
+                'dtrend_quadratic_msg_n', 'dv2uvf', 'dv2uvg', 'dz_height',
+                'echo_off', 'echo_on', 'eof2data', 'eof_varimax', 'eofcor',
+                'eofcor_pcmsg', 'eofcor_ts', 'eofcov', 'eofcov_pcmsg', 'eofcov_ts',
+                'eofunc', 'eofunc_ts', 'eofunc_varimax', 'equiv_sample_size', 'erf',
+                'erfc', 'esacr', 'esacv', 'esccr', 'esccv', 'escorc', 'escorc_n',
+                'escovc', 'exit', 'exp', 'exp_tapersh', 'exp_tapersh_wgts',
+                'exp_tapershC', 'ezfftb', 'ezfftb_n', 'ezfftf', 'ezfftf_n',
+                'f2fosh', 'f2foshv', 'f2fsh', 'f2fshv', 'f2gsh', 'f2gshv', 'fabs',
+                'fbindirread', 'fbindirwrite', 'fbinnumrec', 'fbinread',
+                'fbinrecread', 'fbinrecwrite', 'fbinwrite', 'fft2db', 'fft2df',
+                'fftshift', 'fileattdef', 'filechunkdimdef', 'filedimdef',
+                'fileexists', 'filegrpdef', 'filevarattdef', 'filevarchunkdef',
+                'filevarcompressleveldef', 'filevardef', 'filevardimsizes',
+                'filwgts_lancos', 'filwgts_lanczos', 'filwgts_normal',
+                'floattobyte', 'floattochar', 'floattocharacter', 'floattoint',
+                'floattointeger', 'floattolong', 'floattoshort', 'floor',
+                'fluxEddy', 'fo2fsh', 'fo2fshv', 'fourier_info', 'frame', 'fspan',
+                'ftcurv', 'ftcurvd', 'ftcurvi', 'ftcurvp', 'ftcurvpi', 'ftcurvps',
+                'ftcurvs', 'ftest', 'ftgetp', 'ftkurv', 'ftkurvd', 'ftkurvp',
+                'ftkurvpd', 'ftsetp', 'ftsurf', 'g2fsh', 'g2fshv', 'g2gsh',
+                'g2gshv', 'gamma', 'gammainc', 'gaus', 'gaus_lobat',
+                'gaus_lobat_wgt', 'gc_aangle', 'gc_clkwise', 'gc_dangle',
+                'gc_inout', 'gc_latlon', 'gc_onarc', 'gc_pnt2gc', 'gc_qarea',
+                'gc_tarea', 'generate_2d_array', 'get_color_index',
+                'get_color_rgba', 'get_cpu_time', 'get_isolines', 'get_ncl_version',
+                'get_script_name', 'get_script_prefix_name', 'get_sphere_radius',
+                'get_unique_values', 'getbitsone', 'getenv', 'getfiledimsizes',
+                'getfilegrpnames', 'getfilepath', 'getfilevaratts',
+                'getfilevarchunkdimsizes', 'getfilevardims', 'getfilevardimsizes',
+                'getfilevarnames', 'getfilevartypes', 'getvaratts', 'getvardims',
+                'gradsf', 'gradsg', 'greg2jul', 'grid2triple', 'hlsrgb', 'hsvrgb',
+                'hydro', 'hyi2hyo', 'idsfft', 'igradsf', 'igradsg', 'ilapsf',
+                'ilapsg', 'ilapvf', 'ilapvg', 'ind', 'ind_resolve', 'int2p',
+                'int2p_n', 'integertobyte', 'integertochar', 'integertocharacter',
+                'integertoshort', 'inttobyte', 'inttochar', 'inttoshort',
+                'inverse_matrix', 'isatt', 'isbigendian', 'isbyte', 'ischar',
+                'iscoord', 'isdefined', 'isdim', 'isdimnamed', 'isdouble',
+                'isenumeric', 'isfile', 'isfilepresent', 'isfilevar',
+                'isfilevaratt', 'isfilevarcoord', 'isfilevardim', 'isfloat',
+                'isfunc', 'isgraphic', 'isint', 'isint64', 'isinteger',
+                'isleapyear', 'islogical', 'islong', 'ismissing', 'isnan_ieee',
+                'isnumeric', 'ispan', 'isproc', 'isshort', 'issnumeric', 'isstring',
+                'isubyte', 'isuint', 'isuint64', 'isulong', 'isunlimited',
+                'isunsigned', 'isushort', 'isvar', 'jul2greg', 'kmeans_as136',
+                'kolsm2_n', 'kron_product', 'lapsf', 'lapsg', 'lapvf', 'lapvg',
+                'latlon2utm', 'lclvl', 'lderuvf', 'lderuvg', 'linint1', 'linint1_n',
+                'linint2', 'linint2_points', 'linmsg', 'linmsg_n', 'linrood_latwgt',
+                'linrood_wgt', 'list_files', 'list_filevars', 'list_hlus',
+                'list_procfuncs', 'list_vars', 'ListAppend', 'ListCount',
+                'ListGetType', 'ListIndex', 'ListIndexFromName', 'ListPop',
+                'ListPush', 'ListSetType', 'loadscript', 'local_max', 'local_min',
+                'log', 'log10', 'longtobyte', 'longtochar', 'longtocharacter',
+                'longtoint', 'longtointeger', 'longtoshort', 'lspoly', 'lspoly_n',
+                'mask', 'max', 'maxind', 'min', 'minind', 'mixed_layer_depth',
+                'mixhum_ptd', 'mixhum_ptrh', 'mjo_cross_coh2pha',
+                'mjo_cross_segment', 'moc_globe_atl', 'monthday', 'natgrid',
+                'natgridd', 'natgrids', 'ncargpath', 'ncargversion', 'ndctodata',
+                'ndtooned', 'new', 'NewList', 'ngezlogo', 'nggcog', 'nggetp',
+                'nglogo', 'ngsetp', 'NhlAddAnnotation', 'NhlAddData',
+                'NhlAddOverlay', 'NhlAddPrimitive', 'NhlAppGetDefaultParentId',
+                'NhlChangeWorkstation', 'NhlClassName', 'NhlClearWorkstation',
+                'NhlDataPolygon', 'NhlDataPolyline', 'NhlDataPolymarker',
+                'NhlDataToNDC', 'NhlDestroy', 'NhlDraw', 'NhlFrame', 'NhlFreeColor',
+                'NhlGetBB', 'NhlGetClassResources', 'NhlGetErrorObjectId',
+                'NhlGetNamedColorIndex', 'NhlGetParentId',
+                'NhlGetParentWorkstation', 'NhlGetWorkspaceObjectId',
+                'NhlIsAllocatedColor', 'NhlIsApp', 'NhlIsDataComm', 'NhlIsDataItem',
+                'NhlIsDataSpec', 'NhlIsTransform', 'NhlIsView', 'NhlIsWorkstation',
+                'NhlName', 'NhlNDCPolygon', 'NhlNDCPolyline', 'NhlNDCPolymarker',
+                'NhlNDCToData', 'NhlNewColor', 'NhlNewDashPattern', 'NhlNewMarker',
+                'NhlPalGetDefined', 'NhlRemoveAnnotation', 'NhlRemoveData',
+                'NhlRemoveOverlay', 'NhlRemovePrimitive', 'NhlSetColor',
+                'NhlSetDashPattern', 'NhlSetMarker', 'NhlUpdateData',
+                'NhlUpdateWorkstation', 'nice_mnmxintvl', 'nngetaspectd',
+                'nngetaspects', 'nngetp', 'nngetsloped', 'nngetslopes', 'nngetwts',
+                'nngetwtsd', 'nnpnt', 'nnpntd', 'nnpntend', 'nnpntendd',
+                'nnpntinit', 'nnpntinitd', 'nnpntinits', 'nnpnts', 'nnsetp', 'num',
+                'obj_anal_ic', 'omega_ccm', 'onedtond', 'overlay', 'paleo_outline',
+                'pdfxy_bin', 'poisson_grid_fill', 'pop_remap', 'potmp_insitu_ocn',
+                'prcwater_dp', 'pres2hybrid', 'pres_hybrid_ccm', 'pres_sigma',
+                'print', 'print_table', 'printFileVarSummary', 'printVarSummary',
+                'product', 'pslec', 'pslhor', 'pslhyp', 'qsort', 'rand',
+                'random_chi', 'random_gamma', 'random_normal', 'random_setallseed',
+                'random_uniform', 'rcm2points', 'rcm2rgrid', 'rdsstoi',
+                'read_colormap_file', 'reg_multlin', 'regcoef', 'regCoef_n',
+                'regline', 'relhum', 'replace_ieeenan', 'reshape', 'reshape_ind',
+                'rgba_to_color_index', 'rgbhls', 'rgbhsv', 'rgbyiq', 'rgrid2rcm',
+                'rhomb_trunc', 'rip_cape_2d', 'rip_cape_3d', 'round', 'rtest',
+                'runave', 'runave_n', 'set_default_fillvalue', 'set_sphere_radius',
+                'setfileoption', 'sfvp2uvf', 'sfvp2uvg', 'shaec', 'shagc',
+                'shgetnp', 'shgetp', 'shgrid', 'shorttobyte', 'shorttochar',
+                'shorttocharacter', 'show_ascii', 'shsec', 'shsetp', 'shsgc',
+                'shsgc_R42', 'sigma2hybrid', 'simpeq', 'simpne', 'sin',
+                'sindex_yrmo', 'sinh', 'sizeof', 'sleep', 'smth9', 'snindex_yrmo',
+                'solve_linsys', 'span_color_indexes', 'span_color_rgba',
+                'sparse_matrix_mult', 'spcorr', 'spcorr_n', 'specx_anal',
+                'specxy_anal', 'spei', 'sprintf', 'sprinti', 'sqrt', 'sqsort',
+                'srand', 'stat2', 'stat4', 'stat_medrng', 'stat_trim',
+                'status_exit', 'stdatmus_p2tdz', 'stdatmus_z2tdp', 'stddev',
+                'str_capital', 'str_concat', 'str_fields_count', 'str_get_cols',
+                'str_get_dq', 'str_get_field', 'str_get_nl', 'str_get_sq',
+                'str_get_tab', 'str_index_of_substr', 'str_insert', 'str_is_blank',
+                'str_join', 'str_left_strip', 'str_lower', 'str_match',
+                'str_match_ic', 'str_match_ic_regex', 'str_match_ind',
+                'str_match_ind_ic', 'str_match_ind_ic_regex', 'str_match_ind_regex',
+                'str_match_regex', 'str_right_strip', 'str_split',
+                'str_split_by_length', 'str_split_csv', 'str_squeeze', 'str_strip',
+                'str_sub_str', 'str_switch', 'str_upper', 'stringtochar',
+                'stringtocharacter', 'stringtodouble', 'stringtofloat',
+                'stringtoint', 'stringtointeger', 'stringtolong', 'stringtoshort',
+                'strlen', 'student_t', 'sum', 'svd_lapack', 'svdcov', 'svdcov_sv',
+                'svdstd', 'svdstd_sv', 'system', 'systemfunc', 'tan', 'tanh',
+                'taper', 'taper_n', 'tdclrs', 'tdctri', 'tdcudp', 'tdcurv',
+                'tddtri', 'tdez2d', 'tdez3d', 'tdgetp', 'tdgrds', 'tdgrid',
+                'tdgtrs', 'tdinit', 'tditri', 'tdlbla', 'tdlblp', 'tdlbls',
+                'tdline', 'tdlndp', 'tdlnpa', 'tdlpdp', 'tdmtri', 'tdotri',
+                'tdpara', 'tdplch', 'tdprpa', 'tdprpi', 'tdprpt', 'tdsetp',
+                'tdsort', 'tdstri', 'tdstrs', 'tdttri', 'thornthwaite', 'tobyte',
+                'tochar', 'todouble', 'tofloat', 'toint', 'toint64', 'tointeger',
+                'tolong', 'toshort', 'tosigned', 'tostring', 'tostring_with_format',
+                'totype', 'toubyte', 'touint', 'touint64', 'toulong', 'tounsigned',
+                'toushort', 'trend_manken', 'tri_trunc', 'triple2grid',
+                'triple2grid2d', 'trop_wmo', 'ttest', 'typeof', 'undef',
+                'unique_string', 'update', 'ushorttoint', 'ut_calendar',
+                'ut_inv_calendar', 'utm2latlon', 'uv2dv_cfd', 'uv2dvf', 'uv2dvg',
+                'uv2sfvpf', 'uv2sfvpg', 'uv2vr_cfd', 'uv2vrdvf', 'uv2vrdvg',
+                'uv2vrf', 'uv2vrg', 'v5d_close', 'v5d_create', 'v5d_setLowLev',
+                'v5d_setUnits', 'v5d_write', 'v5d_write_var', 'variance', 'vhaec',
+                'vhagc', 'vhsec', 'vhsgc', 'vibeta', 'vinth2p', 'vinth2p_ecmwf',
+                'vinth2p_ecmwf_nodes', 'vinth2p_nodes', 'vintp2p_ecmwf', 'vr2uvf',
+                'vr2uvg', 'vrdv2uvf', 'vrdv2uvg', 'wavelet', 'wavelet_default',
+                'weibull', 'wgt_area_smooth', 'wgt_areaave', 'wgt_areaave2',
+                'wgt_arearmse', 'wgt_arearmse2', 'wgt_areasum2', 'wgt_runave',
+                'wgt_runave_n', 'wgt_vert_avg_beta', 'wgt_volave', 'wgt_volave_ccm',
+                'wgt_volrmse', 'wgt_volrmse_ccm', 'where', 'wk_smooth121', 'wmbarb',
+                'wmbarbmap', 'wmdrft', 'wmgetp', 'wmlabs', 'wmsetp', 'wmstnm',
+                'wmvect', 'wmvectmap', 'wmvlbl', 'wrf_avo', 'wrf_cape_2d',
+                'wrf_cape_3d', 'wrf_dbz', 'wrf_eth', 'wrf_helicity', 'wrf_ij_to_ll',
+                'wrf_interp_1d', 'wrf_interp_2d_xy', 'wrf_interp_3d_z',
+                'wrf_latlon_to_ij', 'wrf_ll_to_ij', 'wrf_omega', 'wrf_pvo',
+                'wrf_rh', 'wrf_slp', 'wrf_smooth_2d', 'wrf_td', 'wrf_tk',
+                'wrf_updraft_helicity', 'wrf_uvmet', 'wrf_virtual_temp',
+                'wrf_wetbulb', 'wrf_wps_close_int', 'wrf_wps_open_int',
+                'wrf_wps_rddata_int', 'wrf_wps_rdhead_int', 'wrf_wps_read_int',
+                'wrf_wps_write_int', 'write_matrix', 'write_table', 'yiqrgb',
+                'z2geouv', 'zonal_mpsi', 'addfiles_GetVar', 'advect_variable',
+                'area_conserve_remap_Wrap', 'area_hi2lores_Wrap',
+                'array_append_record', 'assignFillValue', 'byte2flt',
+                'byte2flt_hdf', 'calcDayAnomTLL', 'calcMonAnomLLLT',
+                'calcMonAnomLLT', 'calcMonAnomTLL', 'calcMonAnomTLLL',
+                'calculate_monthly_values', 'cd_convert', 'changeCase',
+                'changeCaseChar', 'clmDayTLL', 'clmDayTLLL', 'clmMon2clmDay',
+                'clmMonLLLT', 'clmMonLLT', 'clmMonTLL', 'clmMonTLLL', 'closest_val',
+                'copy_VarAtts', 'copy_VarCoords', 'copy_VarCoords_1',
+                'copy_VarCoords_2', 'copy_VarMeta', 'copyatt', 'crossp3',
+                'cshstringtolist', 'cssgrid_Wrap', 'dble2flt', 'decimalPlaces',
+                'delete_VarAtts', 'dim_avg_n_Wrap', 'dim_avg_wgt_n_Wrap',
+                'dim_avg_wgt_Wrap', 'dim_avg_Wrap', 'dim_cumsum_n_Wrap',
+                'dim_cumsum_Wrap', 'dim_max_n_Wrap', 'dim_min_n_Wrap',
+                'dim_rmsd_n_Wrap', 'dim_rmsd_Wrap', 'dim_rmvmean_n_Wrap',
+                'dim_rmvmean_Wrap', 'dim_rmvmed_n_Wrap', 'dim_rmvmed_Wrap',
+                'dim_standardize_n_Wrap', 'dim_standardize_Wrap',
+                'dim_stddev_n_Wrap', 'dim_stddev_Wrap', 'dim_sum_n_Wrap',
+                'dim_sum_wgt_n_Wrap', 'dim_sum_wgt_Wrap', 'dim_sum_Wrap',
+                'dim_variance_n_Wrap', 'dim_variance_Wrap', 'dpres_plevel_Wrap',
+                'dtrend_leftdim', 'dv2uvF_Wrap', 'dv2uvG_Wrap', 'eof_north',
+                'eofcor_Wrap', 'eofcov_Wrap', 'eofunc_north', 'eofunc_ts_Wrap',
+                'eofunc_varimax_reorder', 'eofunc_varimax_Wrap', 'eofunc_Wrap',
+                'epsZero', 'f2fosh_Wrap', 'f2foshv_Wrap', 'f2fsh_Wrap',
+                'f2fshv_Wrap', 'f2gsh_Wrap', 'f2gshv_Wrap', 'fbindirSwap',
+                'fbinseqSwap1', 'fbinseqSwap2', 'flt2dble', 'flt2string',
+                'fo2fsh_Wrap', 'fo2fshv_Wrap', 'g2fsh_Wrap', 'g2fshv_Wrap',
+                'g2gsh_Wrap', 'g2gshv_Wrap', 'generate_resample_indices',
+                'generate_sample_indices', 'generate_unique_indices',
+                'genNormalDist', 'get1Dindex', 'get1Dindex_Collapse',
+                'get1Dindex_Exclude', 'get_file_suffix', 'GetFillColor',
+                'GetFillColorIndex', 'getFillValue', 'getind_latlon2d',
+                'getVarDimNames', 'getVarFillValue', 'grib_stime2itime',
+                'hyi2hyo_Wrap', 'ilapsF_Wrap', 'ilapsG_Wrap', 'ind_nearest_coord',
+                'indStrSubset', 'int2dble', 'int2flt', 'int2p_n_Wrap', 'int2p_Wrap',
+                'isMonotonic', 'isStrSubset', 'latGau', 'latGauWgt', 'latGlobeF',
+                'latGlobeFo', 'latRegWgt', 'linint1_n_Wrap', 'linint1_Wrap',
+                'linint2_points_Wrap', 'linint2_Wrap', 'local_max_1d',
+                'local_min_1d', 'lonFlip', 'lonGlobeF', 'lonGlobeFo', 'lonPivot',
+                'merge_levels_sfc', 'mod', 'month_to_annual',
+                'month_to_annual_weighted', 'month_to_season', 'month_to_season12',
+                'month_to_seasonN', 'monthly_total_to_daily_mean', 'nameDim',
+                'natgrid_Wrap', 'NewCosWeight', 'niceLatLon2D', 'NormCosWgtGlobe',
+                'numAsciiCol', 'numAsciiRow', 'numeric2int',
+                'obj_anal_ic_deprecated', 'obj_anal_ic_Wrap', 'omega_ccm_driver',
+                'omega_to_w', 'oneDtostring', 'pack_values', 'pattern_cor', 'pdfx',
+                'pdfxy', 'pdfxy_conform', 'pot_temp', 'pot_vort_hybrid',
+                'pot_vort_isobaric', 'pres2hybrid_Wrap', 'print_clock',
+                'printMinMax', 'quadroots', 'rcm2points_Wrap', 'rcm2rgrid_Wrap',
+                'readAsciiHead', 'readAsciiTable', 'reg_multlin_stats',
+                'region_ind', 'regline_stats', 'relhum_ttd', 'replaceSingleChar',
+                'RGBtoCmap', 'rgrid2rcm_Wrap', 'rho_mwjf', 'rm_single_dims',
+                'rmAnnCycle1D', 'rmInsufData', 'rmMonAnnCycLLLT', 'rmMonAnnCycLLT',
+                'rmMonAnnCycTLL', 'runave_n_Wrap', 'runave_Wrap', 'short2flt',
+                'short2flt_hdf', 'shsgc_R42_Wrap', 'sign_f90', 'sign_matlab',
+                'smth9_Wrap', 'smthClmDayTLL', 'smthClmDayTLLL', 'SqrtCosWeight',
+                'stat_dispersion', 'static_stability', 'stdMonLLLT', 'stdMonLLT',
+                'stdMonTLL', 'stdMonTLLL', 'symMinMaxPlt', 'table_attach_columns',
+                'table_attach_rows', 'time_to_newtime', 'transpose',
+                'triple2grid_Wrap', 'ut_convert', 'uv2dvF_Wrap', 'uv2dvG_Wrap',
+                'uv2vrF_Wrap', 'uv2vrG_Wrap', 'vr2uvF_Wrap', 'vr2uvG_Wrap',
+                'w_to_omega', 'wallClockElapseTime', 'wave_number_spc',
+                'wgt_areaave_Wrap', 'wgt_runave_leftdim', 'wgt_runave_n_Wrap',
+                'wgt_runave_Wrap', 'wgt_vertical_n', 'wind_component',
+                'wind_direction', 'yyyyddd_to_yyyymmdd', 'yyyymm_time',
+                'yyyymm_to_yyyyfrac', 'yyyymmdd_time', 'yyyymmdd_to_yyyyddd',
+                'yyyymmdd_to_yyyyfrac', 'yyyymmddhh_time', 'yyyymmddhh_to_yyyyfrac',
+                'zonal_mpsi_Wrap', 'zonalAve', 'calendar_decode2', 'cd_string',
+                'kf_filter', 'run_cor', 'time_axis_labels', 'ut_string',
+                'wrf_contour', 'wrf_map', 'wrf_map_overlay', 'wrf_map_overlays',
+                'wrf_map_resources', 'wrf_map_zoom', 'wrf_overlay', 'wrf_overlays',
+                'wrf_user_getvar', 'wrf_user_ij_to_ll', 'wrf_user_intrp2d',
+                'wrf_user_intrp3d', 'wrf_user_latlon_to_ij', 'wrf_user_list_times',
+                'wrf_user_ll_to_ij', 'wrf_user_unstagger', 'wrf_user_vert_interp',
+                'wrf_vector', 'gsn_add_annotation', 'gsn_add_polygon',
+                'gsn_add_polyline', 'gsn_add_polymarker',
+                'gsn_add_shapefile_polygons', 'gsn_add_shapefile_polylines',
+                'gsn_add_shapefile_polymarkers', 'gsn_add_text', 'gsn_attach_plots',
+                'gsn_blank_plot', 'gsn_contour', 'gsn_contour_map',
+                'gsn_contour_shade', 'gsn_coordinates', 'gsn_create_labelbar',
+                'gsn_create_legend', 'gsn_create_text',
+                'gsn_csm_attach_zonal_means', 'gsn_csm_blank_plot',
+                'gsn_csm_contour', 'gsn_csm_contour_map', 'gsn_csm_contour_map_ce',
+                'gsn_csm_contour_map_overlay', 'gsn_csm_contour_map_polar',
+                'gsn_csm_hov', 'gsn_csm_lat_time', 'gsn_csm_map', 'gsn_csm_map_ce',
+                'gsn_csm_map_polar', 'gsn_csm_pres_hgt',
+                'gsn_csm_pres_hgt_streamline', 'gsn_csm_pres_hgt_vector',
+                'gsn_csm_streamline', 'gsn_csm_streamline_contour_map',
+                'gsn_csm_streamline_contour_map_ce',
+                'gsn_csm_streamline_contour_map_polar', 'gsn_csm_streamline_map',
+                'gsn_csm_streamline_map_ce', 'gsn_csm_streamline_map_polar',
+                'gsn_csm_streamline_scalar', 'gsn_csm_streamline_scalar_map',
+                'gsn_csm_streamline_scalar_map_ce',
+                'gsn_csm_streamline_scalar_map_polar', 'gsn_csm_time_lat',
+                'gsn_csm_vector', 'gsn_csm_vector_map', 'gsn_csm_vector_map_ce',
+                'gsn_csm_vector_map_polar', 'gsn_csm_vector_scalar',
+                'gsn_csm_vector_scalar_map', 'gsn_csm_vector_scalar_map_ce',
+                'gsn_csm_vector_scalar_map_polar', 'gsn_csm_x2y', 'gsn_csm_x2y2',
+                'gsn_csm_xy', 'gsn_csm_xy2', 'gsn_csm_xy3', 'gsn_csm_y',
+                'gsn_define_colormap', 'gsn_draw_colormap', 'gsn_draw_named_colors',
+                'gsn_histogram', 'gsn_labelbar_ndc', 'gsn_legend_ndc', 'gsn_map',
+                'gsn_merge_colormaps', 'gsn_open_wks', 'gsn_panel', 'gsn_polygon',
+                'gsn_polygon_ndc', 'gsn_polyline', 'gsn_polyline_ndc',
+                'gsn_polymarker', 'gsn_polymarker_ndc', 'gsn_retrieve_colormap',
+                'gsn_reverse_colormap', 'gsn_streamline', 'gsn_streamline_map',
+                'gsn_streamline_scalar', 'gsn_streamline_scalar_map', 'gsn_table',
+                'gsn_text', 'gsn_text_ndc', 'gsn_vector', 'gsn_vector_map',
+                'gsn_vector_scalar', 'gsn_vector_scalar_map', 'gsn_xy', 'gsn_y',
+                'hsv2rgb', 'maximize_output', 'namedcolor2rgb', 'namedcolor2rgba',
+                'reset_device_coordinates', 'span_named_colors'), prefix=r'\b'),
+             Name.Builtin),
+
+            # Resources
+            (words((
+                'amDataXF', 'amDataYF', 'amJust', 'amOn', 'amOrthogonalPosF',
+                'amParallelPosF', 'amResizeNotify', 'amSide', 'amTrackData',
+                'amViewId', 'amZone', 'appDefaultParent', 'appFileSuffix',
+                'appResources', 'appSysDir', 'appUsrDir', 'caCopyArrays',
+                'caXArray', 'caXCast', 'caXMaxV', 'caXMinV', 'caXMissingV',
+                'caYArray', 'caYCast', 'caYMaxV', 'caYMinV', 'caYMissingV',
+                'cnCellFillEdgeColor', 'cnCellFillMissingValEdgeColor',
+                'cnConpackParams', 'cnConstFEnableFill', 'cnConstFLabelAngleF',
+                'cnConstFLabelBackgroundColor', 'cnConstFLabelConstantSpacingF',
+                'cnConstFLabelFont', 'cnConstFLabelFontAspectF',
+                'cnConstFLabelFontColor', 'cnConstFLabelFontHeightF',
+                'cnConstFLabelFontQuality', 'cnConstFLabelFontThicknessF',
+                'cnConstFLabelFormat', 'cnConstFLabelFuncCode', 'cnConstFLabelJust',
+                'cnConstFLabelOn', 'cnConstFLabelOrthogonalPosF',
+                'cnConstFLabelParallelPosF', 'cnConstFLabelPerimColor',
+                'cnConstFLabelPerimOn', 'cnConstFLabelPerimSpaceF',
+                'cnConstFLabelPerimThicknessF', 'cnConstFLabelSide',
+                'cnConstFLabelString', 'cnConstFLabelTextDirection',
+                'cnConstFLabelZone', 'cnConstFUseInfoLabelRes',
+                'cnExplicitLabelBarLabelsOn', 'cnExplicitLegendLabelsOn',
+                'cnExplicitLineLabelsOn', 'cnFillBackgroundColor', 'cnFillColor',
+                'cnFillColors', 'cnFillDotSizeF', 'cnFillDrawOrder', 'cnFillMode',
+                'cnFillOn', 'cnFillOpacityF', 'cnFillPalette', 'cnFillPattern',
+                'cnFillPatterns', 'cnFillScaleF', 'cnFillScales', 'cnFixFillBleed',
+                'cnGridBoundFillColor', 'cnGridBoundFillPattern',
+                'cnGridBoundFillScaleF', 'cnGridBoundPerimColor',
+                'cnGridBoundPerimDashPattern', 'cnGridBoundPerimOn',
+                'cnGridBoundPerimThicknessF', 'cnHighLabelAngleF',
+                'cnHighLabelBackgroundColor', 'cnHighLabelConstantSpacingF',
+                'cnHighLabelCount', 'cnHighLabelFont', 'cnHighLabelFontAspectF',
+                'cnHighLabelFontColor', 'cnHighLabelFontHeightF',
+                'cnHighLabelFontQuality', 'cnHighLabelFontThicknessF',
+                'cnHighLabelFormat', 'cnHighLabelFuncCode', 'cnHighLabelPerimColor',
+                'cnHighLabelPerimOn', 'cnHighLabelPerimSpaceF',
+                'cnHighLabelPerimThicknessF', 'cnHighLabelString', 'cnHighLabelsOn',
+                'cnHighLowLabelOverlapMode', 'cnHighUseLineLabelRes',
+                'cnInfoLabelAngleF', 'cnInfoLabelBackgroundColor',
+                'cnInfoLabelConstantSpacingF', 'cnInfoLabelFont',
+                'cnInfoLabelFontAspectF', 'cnInfoLabelFontColor',
+                'cnInfoLabelFontHeightF', 'cnInfoLabelFontQuality',
+                'cnInfoLabelFontThicknessF', 'cnInfoLabelFormat',
+                'cnInfoLabelFuncCode', 'cnInfoLabelJust', 'cnInfoLabelOn',
+                'cnInfoLabelOrthogonalPosF', 'cnInfoLabelParallelPosF',
+                'cnInfoLabelPerimColor', 'cnInfoLabelPerimOn',
+                'cnInfoLabelPerimSpaceF', 'cnInfoLabelPerimThicknessF',
+                'cnInfoLabelSide', 'cnInfoLabelString', 'cnInfoLabelTextDirection',
+                'cnInfoLabelZone', 'cnLabelBarEndLabelsOn', 'cnLabelBarEndStyle',
+                'cnLabelDrawOrder', 'cnLabelMasking', 'cnLabelScaleFactorF',
+                'cnLabelScaleValueF', 'cnLabelScalingMode', 'cnLegendLevelFlags',
+                'cnLevelCount', 'cnLevelFlag', 'cnLevelFlags', 'cnLevelSelectionMode',
+                'cnLevelSpacingF', 'cnLevels', 'cnLineColor', 'cnLineColors',
+                'cnLineDashPattern', 'cnLineDashPatterns', 'cnLineDashSegLenF',
+                'cnLineDrawOrder', 'cnLineLabelAngleF', 'cnLineLabelBackgroundColor',
+                'cnLineLabelConstantSpacingF', 'cnLineLabelCount',
+                'cnLineLabelDensityF', 'cnLineLabelFont', 'cnLineLabelFontAspectF',
+                'cnLineLabelFontColor', 'cnLineLabelFontColors',
+                'cnLineLabelFontHeightF', 'cnLineLabelFontQuality',
+                'cnLineLabelFontThicknessF', 'cnLineLabelFormat',
+                'cnLineLabelFuncCode', 'cnLineLabelInterval', 'cnLineLabelPerimColor',
+                'cnLineLabelPerimOn', 'cnLineLabelPerimSpaceF',
+                'cnLineLabelPerimThicknessF', 'cnLineLabelPlacementMode',
+                'cnLineLabelStrings', 'cnLineLabelsOn', 'cnLinePalette',
+                'cnLineThicknessF', 'cnLineThicknesses', 'cnLinesOn',
+                'cnLowLabelAngleF', 'cnLowLabelBackgroundColor',
+                'cnLowLabelConstantSpacingF', 'cnLowLabelCount', 'cnLowLabelFont',
+                'cnLowLabelFontAspectF', 'cnLowLabelFontColor',
+                'cnLowLabelFontHeightF', 'cnLowLabelFontQuality',
+                'cnLowLabelFontThicknessF', 'cnLowLabelFormat', 'cnLowLabelFuncCode',
+                'cnLowLabelPerimColor', 'cnLowLabelPerimOn', 'cnLowLabelPerimSpaceF',
+                'cnLowLabelPerimThicknessF', 'cnLowLabelString', 'cnLowLabelsOn',
+                'cnLowUseHighLabelRes', 'cnMaxDataValueFormat', 'cnMaxLevelCount',
+                'cnMaxLevelValF', 'cnMaxPointDistanceF', 'cnMinLevelValF',
+                'cnMissingValFillColor', 'cnMissingValFillPattern',
+                'cnMissingValFillScaleF', 'cnMissingValPerimColor',
+                'cnMissingValPerimDashPattern', 'cnMissingValPerimGridBoundOn',
+                'cnMissingValPerimOn', 'cnMissingValPerimThicknessF',
+                'cnMonoFillColor', 'cnMonoFillPattern', 'cnMonoFillScale',
+                'cnMonoLevelFlag', 'cnMonoLineColor', 'cnMonoLineDashPattern',
+                'cnMonoLineLabelFontColor', 'cnMonoLineThickness', 'cnNoDataLabelOn',
+                'cnNoDataLabelString', 'cnOutOfRangeFillColor',
+                'cnOutOfRangeFillPattern', 'cnOutOfRangeFillScaleF',
+                'cnOutOfRangePerimColor', 'cnOutOfRangePerimDashPattern',
+                'cnOutOfRangePerimOn', 'cnOutOfRangePerimThicknessF',
+                'cnRasterCellSizeF', 'cnRasterMinCellSizeF', 'cnRasterModeOn',
+                'cnRasterSampleFactorF', 'cnRasterSmoothingOn', 'cnScalarFieldData',
+                'cnSmoothingDistanceF', 'cnSmoothingOn', 'cnSmoothingTensionF',
+                'cnSpanFillPalette', 'cnSpanLinePalette', 'ctCopyTables',
+                'ctXElementSize', 'ctXMaxV', 'ctXMinV', 'ctXMissingV', 'ctXTable',
+                'ctXTableLengths', 'ctXTableType', 'ctYElementSize', 'ctYMaxV',
+                'ctYMinV', 'ctYMissingV', 'ctYTable', 'ctYTableLengths',
+                'ctYTableType', 'dcDelayCompute', 'errBuffer',
+                'errFileName', 'errFilePtr', 'errLevel', 'errPrint', 'errUnitNumber',
+                'gsClipOn', 'gsColors', 'gsEdgeColor', 'gsEdgeDashPattern',
+                'gsEdgeDashSegLenF', 'gsEdgeThicknessF', 'gsEdgesOn',
+                'gsFillBackgroundColor', 'gsFillColor', 'gsFillDotSizeF',
+                'gsFillIndex', 'gsFillLineThicknessF', 'gsFillOpacityF',
+                'gsFillScaleF', 'gsFont', 'gsFontAspectF', 'gsFontColor',
+                'gsFontHeightF', 'gsFontOpacityF', 'gsFontQuality',
+                'gsFontThicknessF', 'gsLineColor', 'gsLineDashPattern',
+                'gsLineDashSegLenF', 'gsLineLabelConstantSpacingF', 'gsLineLabelFont',
+                'gsLineLabelFontAspectF', 'gsLineLabelFontColor',
+                'gsLineLabelFontHeightF', 'gsLineLabelFontQuality',
+                'gsLineLabelFontThicknessF', 'gsLineLabelFuncCode',
+                'gsLineLabelString', 'gsLineOpacityF', 'gsLineThicknessF',
+                'gsMarkerColor', 'gsMarkerIndex', 'gsMarkerOpacityF', 'gsMarkerSizeF',
+                'gsMarkerThicknessF', 'gsSegments', 'gsTextAngleF',
+                'gsTextConstantSpacingF', 'gsTextDirection', 'gsTextFuncCode',
+                'gsTextJustification', 'gsnAboveYRefLineBarColors',
+                'gsnAboveYRefLineBarFillScales', 'gsnAboveYRefLineBarPatterns',
+                'gsnAboveYRefLineColor', 'gsnAddCyclic', 'gsnAttachBorderOn',
+                'gsnAttachPlotsXAxis', 'gsnBelowYRefLineBarColors',
+                'gsnBelowYRefLineBarFillScales', 'gsnBelowYRefLineBarPatterns',
+                'gsnBelowYRefLineColor', 'gsnBoxMargin', 'gsnCenterString',
+                'gsnCenterStringFontColor', 'gsnCenterStringFontHeightF',
+                'gsnCenterStringFuncCode', 'gsnCenterStringOrthogonalPosF',
+                'gsnCenterStringParallelPosF', 'gsnContourLineThicknessesScale',
+                'gsnContourNegLineDashPattern', 'gsnContourPosLineDashPattern',
+                'gsnContourZeroLineThicknessF', 'gsnDebugWriteFileName', 'gsnDraw',
+                'gsnFrame', 'gsnHistogramBarWidthPercent', 'gsnHistogramBinIntervals',
+                'gsnHistogramBinMissing', 'gsnHistogramBinWidth',
+                'gsnHistogramClassIntervals', 'gsnHistogramCompare',
+                'gsnHistogramComputePercentages',
+                'gsnHistogramComputePercentagesNoMissing',
+                'gsnHistogramDiscreteBinValues', 'gsnHistogramDiscreteClassValues',
+                'gsnHistogramHorizontal', 'gsnHistogramMinMaxBinsOn',
+                'gsnHistogramNumberOfBins', 'gsnHistogramPercentSign',
+                'gsnHistogramSelectNiceIntervals', 'gsnLeftString',
+                'gsnLeftStringFontColor', 'gsnLeftStringFontHeightF',
+                'gsnLeftStringFuncCode', 'gsnLeftStringOrthogonalPosF',
+                'gsnLeftStringParallelPosF', 'gsnMajorLatSpacing',
+                'gsnMajorLonSpacing', 'gsnMaskLambertConformal',
+                'gsnMaskLambertConformalOutlineOn', 'gsnMaximize',
+                'gsnMinorLatSpacing', 'gsnMinorLonSpacing', 'gsnPanelBottom',
+                'gsnPanelCenter', 'gsnPanelDebug', 'gsnPanelFigureStrings',
+                'gsnPanelFigureStringsBackgroundFillColor',
+                'gsnPanelFigureStringsFontHeightF', 'gsnPanelFigureStringsJust',
+                'gsnPanelFigureStringsPerimOn', 'gsnPanelLabelBar', 'gsnPanelLeft',
+                'gsnPanelMainFont', 'gsnPanelMainFontColor',
+                'gsnPanelMainFontHeightF', 'gsnPanelMainString', 'gsnPanelRight',
+                'gsnPanelRowSpec', 'gsnPanelScalePlotIndex', 'gsnPanelTop',
+                'gsnPanelXF', 'gsnPanelXWhiteSpacePercent', 'gsnPanelYF',
+                'gsnPanelYWhiteSpacePercent', 'gsnPaperHeight', 'gsnPaperMargin',
+                'gsnPaperOrientation', 'gsnPaperWidth', 'gsnPolar',
+                'gsnPolarLabelDistance', 'gsnPolarLabelFont',
+                'gsnPolarLabelFontHeightF', 'gsnPolarLabelSpacing', 'gsnPolarTime',
+                'gsnPolarUT', 'gsnRightString', 'gsnRightStringFontColor',
+                'gsnRightStringFontHeightF', 'gsnRightStringFuncCode',
+                'gsnRightStringOrthogonalPosF', 'gsnRightStringParallelPosF',
+                'gsnScalarContour', 'gsnScale', 'gsnShape', 'gsnSpreadColorEnd',
+                'gsnSpreadColorStart', 'gsnSpreadColors', 'gsnStringFont',
+                'gsnStringFontColor', 'gsnStringFontHeightF', 'gsnStringFuncCode',
+                'gsnTickMarksOn', 'gsnXAxisIrregular2Linear', 'gsnXAxisIrregular2Log',
+                'gsnXRefLine', 'gsnXRefLineColor', 'gsnXRefLineDashPattern',
+                'gsnXRefLineThicknessF', 'gsnXYAboveFillColors', 'gsnXYBarChart',
+                'gsnXYBarChartBarWidth', 'gsnXYBarChartColors',
+                'gsnXYBarChartColors2', 'gsnXYBarChartFillDotSizeF',
+                'gsnXYBarChartFillLineThicknessF', 'gsnXYBarChartFillOpacityF',
+                'gsnXYBarChartFillScaleF', 'gsnXYBarChartOutlineOnly',
+                'gsnXYBarChartOutlineThicknessF', 'gsnXYBarChartPatterns',
+                'gsnXYBarChartPatterns2', 'gsnXYBelowFillColors', 'gsnXYFillColors',
+                'gsnXYFillOpacities', 'gsnXYLeftFillColors', 'gsnXYRightFillColors',
+                'gsnYAxisIrregular2Linear', 'gsnYAxisIrregular2Log', 'gsnYRefLine',
+                'gsnYRefLineColor', 'gsnYRefLineColors', 'gsnYRefLineDashPattern',
+                'gsnYRefLineDashPatterns', 'gsnYRefLineThicknessF',
+                'gsnYRefLineThicknesses', 'gsnZonalMean', 'gsnZonalMeanXMaxF',
+                'gsnZonalMeanXMinF', 'gsnZonalMeanYRefLine', 'lbAutoManage',
+                'lbBottomMarginF', 'lbBoxCount', 'lbBoxEndCapStyle', 'lbBoxFractions',
+                'lbBoxLineColor', 'lbBoxLineDashPattern', 'lbBoxLineDashSegLenF',
+                'lbBoxLineThicknessF', 'lbBoxLinesOn', 'lbBoxMajorExtentF',
+                'lbBoxMinorExtentF', 'lbBoxSeparatorLinesOn', 'lbBoxSizing',
+                'lbFillBackground', 'lbFillColor', 'lbFillColors', 'lbFillDotSizeF',
+                'lbFillLineThicknessF', 'lbFillPattern', 'lbFillPatterns',
+                'lbFillScaleF', 'lbFillScales', 'lbJustification', 'lbLabelAlignment',
+                'lbLabelAngleF', 'lbLabelAutoStride', 'lbLabelBarOn',
+                'lbLabelConstantSpacingF', 'lbLabelDirection', 'lbLabelFont',
+                'lbLabelFontAspectF', 'lbLabelFontColor', 'lbLabelFontHeightF',
+                'lbLabelFontQuality', 'lbLabelFontThicknessF', 'lbLabelFuncCode',
+                'lbLabelJust', 'lbLabelOffsetF', 'lbLabelPosition', 'lbLabelStride',
+                'lbLabelStrings', 'lbLabelsOn', 'lbLeftMarginF', 'lbMaxLabelLenF',
+                'lbMinLabelSpacingF', 'lbMonoFillColor', 'lbMonoFillPattern',
+                'lbMonoFillScale', 'lbOrientation', 'lbPerimColor',
+                'lbPerimDashPattern', 'lbPerimDashSegLenF', 'lbPerimFill',
+                'lbPerimFillColor', 'lbPerimOn', 'lbPerimThicknessF',
+                'lbRasterFillOn', 'lbRightMarginF', 'lbTitleAngleF',
+                'lbTitleConstantSpacingF', 'lbTitleDirection', 'lbTitleExtentF',
+                'lbTitleFont', 'lbTitleFontAspectF', 'lbTitleFontColor',
+                'lbTitleFontHeightF', 'lbTitleFontQuality', 'lbTitleFontThicknessF',
+                'lbTitleFuncCode', 'lbTitleJust', 'lbTitleOffsetF', 'lbTitleOn',
+                'lbTitlePosition', 'lbTitleString', 'lbTopMarginF', 'lgAutoManage',
+                'lgBottomMarginF', 'lgBoxBackground', 'lgBoxLineColor',
+                'lgBoxLineDashPattern', 'lgBoxLineDashSegLenF', 'lgBoxLineThicknessF',
+                'lgBoxLinesOn', 'lgBoxMajorExtentF', 'lgBoxMinorExtentF',
+                'lgDashIndex', 'lgDashIndexes', 'lgItemCount', 'lgItemOrder',
+                'lgItemPlacement', 'lgItemPositions', 'lgItemType', 'lgItemTypes',
+                'lgJustification', 'lgLabelAlignment', 'lgLabelAngleF',
+                'lgLabelAutoStride', 'lgLabelConstantSpacingF', 'lgLabelDirection',
+                'lgLabelFont', 'lgLabelFontAspectF', 'lgLabelFontColor',
+                'lgLabelFontHeightF', 'lgLabelFontQuality', 'lgLabelFontThicknessF',
+                'lgLabelFuncCode', 'lgLabelJust', 'lgLabelOffsetF', 'lgLabelPosition',
+                'lgLabelStride', 'lgLabelStrings', 'lgLabelsOn', 'lgLeftMarginF',
+                'lgLegendOn', 'lgLineColor', 'lgLineColors', 'lgLineDashSegLenF',
+                'lgLineDashSegLens', 'lgLineLabelConstantSpacingF', 'lgLineLabelFont',
+                'lgLineLabelFontAspectF', 'lgLineLabelFontColor',
+                'lgLineLabelFontColors', 'lgLineLabelFontHeightF',
+                'lgLineLabelFontHeights', 'lgLineLabelFontQuality',
+                'lgLineLabelFontThicknessF', 'lgLineLabelFuncCode',
+                'lgLineLabelStrings', 'lgLineLabelsOn', 'lgLineThicknessF',
+                'lgLineThicknesses', 'lgMarkerColor', 'lgMarkerColors',
+                'lgMarkerIndex', 'lgMarkerIndexes', 'lgMarkerSizeF', 'lgMarkerSizes',
+                'lgMarkerThicknessF', 'lgMarkerThicknesses', 'lgMonoDashIndex',
+                'lgMonoItemType', 'lgMonoLineColor', 'lgMonoLineDashSegLen',
+                'lgMonoLineLabelFontColor', 'lgMonoLineLabelFontHeight',
+                'lgMonoLineThickness', 'lgMonoMarkerColor', 'lgMonoMarkerIndex',
+                'lgMonoMarkerSize', 'lgMonoMarkerThickness', 'lgOrientation',
+                'lgPerimColor', 'lgPerimDashPattern', 'lgPerimDashSegLenF',
+                'lgPerimFill', 'lgPerimFillColor', 'lgPerimOn', 'lgPerimThicknessF',
+                'lgRightMarginF', 'lgTitleAngleF', 'lgTitleConstantSpacingF',
+                'lgTitleDirection', 'lgTitleExtentF', 'lgTitleFont',
+                'lgTitleFontAspectF', 'lgTitleFontColor', 'lgTitleFontHeightF',
+                'lgTitleFontQuality', 'lgTitleFontThicknessF', 'lgTitleFuncCode',
+                'lgTitleJust', 'lgTitleOffsetF', 'lgTitleOn', 'lgTitlePosition',
+                'lgTitleString', 'lgTopMarginF', 'mpAreaGroupCount',
+                'mpAreaMaskingOn', 'mpAreaNames', 'mpAreaTypes', 'mpBottomAngleF',
+                'mpBottomMapPosF', 'mpBottomNDCF', 'mpBottomNPCF',
+                'mpBottomPointLatF', 'mpBottomPointLonF', 'mpBottomWindowF',
+                'mpCenterLatF', 'mpCenterLonF', 'mpCenterRotF', 'mpCountyLineColor',
+                'mpCountyLineDashPattern', 'mpCountyLineDashSegLenF',
+                'mpCountyLineThicknessF', 'mpDataBaseVersion', 'mpDataResolution',
+                'mpDataSetName', 'mpDefaultFillColor', 'mpDefaultFillPattern',
+                'mpDefaultFillScaleF', 'mpDynamicAreaGroups', 'mpEllipticalBoundary',
+                'mpFillAreaSpecifiers', 'mpFillBoundarySets', 'mpFillColor',
+                'mpFillColors', 'mpFillColors-default', 'mpFillDotSizeF',
+                'mpFillDrawOrder', 'mpFillOn', 'mpFillPatternBackground',
+                'mpFillPattern', 'mpFillPatterns', 'mpFillPatterns-default',
+                'mpFillScaleF', 'mpFillScales', 'mpFillScales-default',
+                'mpFixedAreaGroups', 'mpGeophysicalLineColor',
+                'mpGeophysicalLineDashPattern', 'mpGeophysicalLineDashSegLenF',
+                'mpGeophysicalLineThicknessF', 'mpGreatCircleLinesOn',
+                'mpGridAndLimbDrawOrder', 'mpGridAndLimbOn', 'mpGridLatSpacingF',
+                'mpGridLineColor', 'mpGridLineDashPattern', 'mpGridLineDashSegLenF',
+                'mpGridLineThicknessF', 'mpGridLonSpacingF', 'mpGridMaskMode',
+                'mpGridMaxLatF', 'mpGridPolarLonSpacingF', 'mpGridSpacingF',
+                'mpInlandWaterFillColor', 'mpInlandWaterFillPattern',
+                'mpInlandWaterFillScaleF', 'mpLabelDrawOrder', 'mpLabelFontColor',
+                'mpLabelFontHeightF', 'mpLabelsOn', 'mpLambertMeridianF',
+                'mpLambertParallel1F', 'mpLambertParallel2F', 'mpLandFillColor',
+                'mpLandFillPattern', 'mpLandFillScaleF', 'mpLeftAngleF',
+                'mpLeftCornerLatF', 'mpLeftCornerLonF', 'mpLeftMapPosF',
+                'mpLeftNDCF', 'mpLeftNPCF', 'mpLeftPointLatF',
+                'mpLeftPointLonF', 'mpLeftWindowF', 'mpLimbLineColor',
+                'mpLimbLineDashPattern', 'mpLimbLineDashSegLenF',
+                'mpLimbLineThicknessF', 'mpLimitMode', 'mpMaskAreaSpecifiers',
+                'mpMaskOutlineSpecifiers', 'mpMaxLatF', 'mpMaxLonF',
+                'mpMinLatF', 'mpMinLonF', 'mpMonoFillColor', 'mpMonoFillPattern',
+                'mpMonoFillScale', 'mpNationalLineColor', 'mpNationalLineDashPattern',
+                'mpNationalLineThicknessF', 'mpOceanFillColor', 'mpOceanFillPattern',
+                'mpOceanFillScaleF', 'mpOutlineBoundarySets', 'mpOutlineDrawOrder',
+                'mpOutlineMaskingOn', 'mpOutlineOn', 'mpOutlineSpecifiers',
+                'mpPerimDrawOrder', 'mpPerimLineColor', 'mpPerimLineDashPattern',
+                'mpPerimLineDashSegLenF', 'mpPerimLineThicknessF', 'mpPerimOn',
+                'mpPolyMode', 'mpProjection', 'mpProvincialLineColor',
+                'mpProvincialLineDashPattern', 'mpProvincialLineDashSegLenF',
+                'mpProvincialLineThicknessF', 'mpRelativeCenterLat',
+                'mpRelativeCenterLon', 'mpRightAngleF', 'mpRightCornerLatF',
+                'mpRightCornerLonF', 'mpRightMapPosF', 'mpRightNDCF',
+                'mpRightNPCF', 'mpRightPointLatF', 'mpRightPointLonF',
+                'mpRightWindowF', 'mpSatelliteAngle1F', 'mpSatelliteAngle2F',
+                'mpSatelliteDistF', 'mpShapeMode', 'mpSpecifiedFillColors',
+                'mpSpecifiedFillDirectIndexing', 'mpSpecifiedFillPatterns',
+                'mpSpecifiedFillPriority', 'mpSpecifiedFillScales',
+                'mpTopAngleF', 'mpTopMapPosF', 'mpTopNDCF', 'mpTopNPCF',
+                'mpTopPointLatF', 'mpTopPointLonF', 'mpTopWindowF',
+                'mpUSStateLineColor', 'mpUSStateLineDashPattern',
+                'mpUSStateLineDashSegLenF', 'mpUSStateLineThicknessF',
+                'pmAnnoManagers', 'pmAnnoViews', 'pmLabelBarDisplayMode',
+                'pmLabelBarHeightF', 'pmLabelBarKeepAspect', 'pmLabelBarOrthogonalPosF',
+                'pmLabelBarParallelPosF', 'pmLabelBarSide', 'pmLabelBarWidthF',
+                'pmLabelBarZone', 'pmLegendDisplayMode', 'pmLegendHeightF',
+                'pmLegendKeepAspect', 'pmLegendOrthogonalPosF',
+                'pmLegendParallelPosF', 'pmLegendSide', 'pmLegendWidthF',
+                'pmLegendZone', 'pmOverlaySequenceIds', 'pmTickMarkDisplayMode',
+                'pmTickMarkZone', 'pmTitleDisplayMode', 'pmTitleZone',
+                'prGraphicStyle', 'prPolyType', 'prXArray', 'prYArray',
+                'sfCopyData', 'sfDataArray', 'sfDataMaxV', 'sfDataMinV',
+                'sfElementNodes', 'sfExchangeDimensions', 'sfFirstNodeIndex',
+                'sfMissingValueV', 'sfXArray', 'sfXCActualEndF', 'sfXCActualStartF',
+                'sfXCEndIndex', 'sfXCEndSubsetV', 'sfXCEndV', 'sfXCStartIndex',
+                'sfXCStartSubsetV', 'sfXCStartV', 'sfXCStride', 'sfXCellBounds',
+                'sfYArray', 'sfYCActualEndF', 'sfYCActualStartF', 'sfYCEndIndex',
+                'sfYCEndSubsetV', 'sfYCEndV', 'sfYCStartIndex', 'sfYCStartSubsetV',
+                'sfYCStartV', 'sfYCStride', 'sfYCellBounds', 'stArrowLengthF',
+                'stArrowStride', 'stCrossoverCheckCount',
+                'stExplicitLabelBarLabelsOn', 'stLabelBarEndLabelsOn',
+                'stLabelFormat', 'stLengthCheckCount', 'stLevelColors',
+                'stLevelCount', 'stLevelPalette', 'stLevelSelectionMode',
+                'stLevelSpacingF', 'stLevels', 'stLineColor', 'stLineOpacityF',
+                'stLineStartStride', 'stLineThicknessF', 'stMapDirection',
+                'stMaxLevelCount', 'stMaxLevelValF', 'stMinArrowSpacingF',
+                'stMinDistanceF', 'stMinLevelValF', 'stMinLineSpacingF',
+                'stMinStepFactorF', 'stMonoLineColor', 'stNoDataLabelOn',
+                'stNoDataLabelString', 'stScalarFieldData', 'stScalarMissingValColor',
+                'stSpanLevelPalette', 'stStepSizeF', 'stStreamlineDrawOrder',
+                'stUseScalarArray', 'stVectorFieldData', 'stZeroFLabelAngleF',
+                'stZeroFLabelBackgroundColor', 'stZeroFLabelConstantSpacingF',
+                'stZeroFLabelFont', 'stZeroFLabelFontAspectF',
+                'stZeroFLabelFontColor', 'stZeroFLabelFontHeightF',
+                'stZeroFLabelFontQuality', 'stZeroFLabelFontThicknessF',
+                'stZeroFLabelFuncCode', 'stZeroFLabelJust', 'stZeroFLabelOn',
+                'stZeroFLabelOrthogonalPosF', 'stZeroFLabelParallelPosF',
+                'stZeroFLabelPerimColor', 'stZeroFLabelPerimOn',
+                'stZeroFLabelPerimSpaceF', 'stZeroFLabelPerimThicknessF',
+                'stZeroFLabelSide', 'stZeroFLabelString', 'stZeroFLabelTextDirection',
+                'stZeroFLabelZone', 'tfDoNDCOverlay', 'tfPlotManagerOn',
+                'tfPolyDrawList', 'tfPolyDrawOrder', 'tiDeltaF', 'tiMainAngleF',
+                'tiMainConstantSpacingF', 'tiMainDirection', 'tiMainFont',
+                'tiMainFontAspectF', 'tiMainFontColor', 'tiMainFontHeightF',
+                'tiMainFontQuality', 'tiMainFontThicknessF', 'tiMainFuncCode',
+                'tiMainJust', 'tiMainOffsetXF', 'tiMainOffsetYF', 'tiMainOn',
+                'tiMainPosition', 'tiMainSide', 'tiMainString', 'tiUseMainAttributes',
+                'tiXAxisAngleF', 'tiXAxisConstantSpacingF', 'tiXAxisDirection',
+                'tiXAxisFont', 'tiXAxisFontAspectF', 'tiXAxisFontColor',
+                'tiXAxisFontHeightF', 'tiXAxisFontQuality', 'tiXAxisFontThicknessF',
+                'tiXAxisFuncCode', 'tiXAxisJust', 'tiXAxisOffsetXF',
+                'tiXAxisOffsetYF', 'tiXAxisOn', 'tiXAxisPosition', 'tiXAxisSide',
+                'tiXAxisString', 'tiYAxisAngleF', 'tiYAxisConstantSpacingF',
+                'tiYAxisDirection', 'tiYAxisFont', 'tiYAxisFontAspectF',
+                'tiYAxisFontColor', 'tiYAxisFontHeightF', 'tiYAxisFontQuality',
+                'tiYAxisFontThicknessF', 'tiYAxisFuncCode', 'tiYAxisJust',
+                'tiYAxisOffsetXF', 'tiYAxisOffsetYF', 'tiYAxisOn', 'tiYAxisPosition',
+                'tiYAxisSide', 'tiYAxisString', 'tmBorderLineColor',
+                'tmBorderThicknessF', 'tmEqualizeXYSizes', 'tmLabelAutoStride',
+                'tmSciNoteCutoff', 'tmXBAutoPrecision', 'tmXBBorderOn',
+                'tmXBDataLeftF', 'tmXBDataRightF', 'tmXBFormat', 'tmXBIrrTensionF',
+                'tmXBIrregularPoints', 'tmXBLabelAngleF', 'tmXBLabelConstantSpacingF',
+                'tmXBLabelDeltaF', 'tmXBLabelDirection', 'tmXBLabelFont',
+                'tmXBLabelFontAspectF', 'tmXBLabelFontColor', 'tmXBLabelFontHeightF',
+                'tmXBLabelFontQuality', 'tmXBLabelFontThicknessF',
+                'tmXBLabelFuncCode', 'tmXBLabelJust', 'tmXBLabelStride', 'tmXBLabels',
+                'tmXBLabelsOn', 'tmXBMajorLengthF', 'tmXBMajorLineColor',
+                'tmXBMajorOutwardLengthF', 'tmXBMajorThicknessF', 'tmXBMaxLabelLenF',
+                'tmXBMaxTicks', 'tmXBMinLabelSpacingF', 'tmXBMinorLengthF',
+                'tmXBMinorLineColor', 'tmXBMinorOn', 'tmXBMinorOutwardLengthF',
+                'tmXBMinorPerMajor', 'tmXBMinorThicknessF', 'tmXBMinorValues',
+                'tmXBMode', 'tmXBOn', 'tmXBPrecision', 'tmXBStyle', 'tmXBTickEndF',
+                'tmXBTickSpacingF', 'tmXBTickStartF', 'tmXBValues', 'tmXMajorGrid',
+                'tmXMajorGridLineColor', 'tmXMajorGridLineDashPattern',
+                'tmXMajorGridThicknessF', 'tmXMinorGrid', 'tmXMinorGridLineColor',
+                'tmXMinorGridLineDashPattern', 'tmXMinorGridThicknessF',
+                'tmXTAutoPrecision', 'tmXTBorderOn', 'tmXTDataLeftF',
+                'tmXTDataRightF', 'tmXTFormat', 'tmXTIrrTensionF',
+                'tmXTIrregularPoints', 'tmXTLabelAngleF', 'tmXTLabelConstantSpacingF',
+                'tmXTLabelDeltaF', 'tmXTLabelDirection', 'tmXTLabelFont',
+                'tmXTLabelFontAspectF', 'tmXTLabelFontColor', 'tmXTLabelFontHeightF',
+                'tmXTLabelFontQuality', 'tmXTLabelFontThicknessF',
+                'tmXTLabelFuncCode', 'tmXTLabelJust', 'tmXTLabelStride', 'tmXTLabels',
+                'tmXTLabelsOn', 'tmXTMajorLengthF', 'tmXTMajorLineColor',
+                'tmXTMajorOutwardLengthF', 'tmXTMajorThicknessF', 'tmXTMaxLabelLenF',
+                'tmXTMaxTicks', 'tmXTMinLabelSpacingF', 'tmXTMinorLengthF',
+                'tmXTMinorLineColor', 'tmXTMinorOn', 'tmXTMinorOutwardLengthF',
+                'tmXTMinorPerMajor', 'tmXTMinorThicknessF', 'tmXTMinorValues',
+                'tmXTMode', 'tmXTOn', 'tmXTPrecision', 'tmXTStyle', 'tmXTTickEndF',
+                'tmXTTickSpacingF', 'tmXTTickStartF', 'tmXTValues', 'tmXUseBottom',
+                'tmYLAutoPrecision', 'tmYLBorderOn', 'tmYLDataBottomF',
+                'tmYLDataTopF', 'tmYLFormat', 'tmYLIrrTensionF',
+                'tmYLIrregularPoints', 'tmYLLabelAngleF', 'tmYLLabelConstantSpacingF',
+                'tmYLLabelDeltaF', 'tmYLLabelDirection', 'tmYLLabelFont',
+                'tmYLLabelFontAspectF', 'tmYLLabelFontColor', 'tmYLLabelFontHeightF',
+                'tmYLLabelFontQuality', 'tmYLLabelFontThicknessF',
+                'tmYLLabelFuncCode', 'tmYLLabelJust', 'tmYLLabelStride', 'tmYLLabels',
+                'tmYLLabelsOn', 'tmYLMajorLengthF', 'tmYLMajorLineColor',
+                'tmYLMajorOutwardLengthF', 'tmYLMajorThicknessF', 'tmYLMaxLabelLenF',
+                'tmYLMaxTicks', 'tmYLMinLabelSpacingF', 'tmYLMinorLengthF',
+                'tmYLMinorLineColor', 'tmYLMinorOn', 'tmYLMinorOutwardLengthF',
+                'tmYLMinorPerMajor', 'tmYLMinorThicknessF', 'tmYLMinorValues',
+                'tmYLMode', 'tmYLOn', 'tmYLPrecision', 'tmYLStyle', 'tmYLTickEndF',
+                'tmYLTickSpacingF', 'tmYLTickStartF', 'tmYLValues', 'tmYMajorGrid',
+                'tmYMajorGridLineColor', 'tmYMajorGridLineDashPattern',
+                'tmYMajorGridThicknessF', 'tmYMinorGrid', 'tmYMinorGridLineColor',
+                'tmYMinorGridLineDashPattern', 'tmYMinorGridThicknessF',
+                'tmYRAutoPrecision', 'tmYRBorderOn', 'tmYRDataBottomF',
+                'tmYRDataTopF', 'tmYRFormat', 'tmYRIrrTensionF',
+                'tmYRIrregularPoints', 'tmYRLabelAngleF', 'tmYRLabelConstantSpacingF',
+                'tmYRLabelDeltaF', 'tmYRLabelDirection', 'tmYRLabelFont',
+                'tmYRLabelFontAspectF', 'tmYRLabelFontColor', 'tmYRLabelFontHeightF',
+                'tmYRLabelFontQuality', 'tmYRLabelFontThicknessF',
+                'tmYRLabelFuncCode', 'tmYRLabelJust', 'tmYRLabelStride', 'tmYRLabels',
+                'tmYRLabelsOn', 'tmYRMajorLengthF', 'tmYRMajorLineColor',
+                'tmYRMajorOutwardLengthF', 'tmYRMajorThicknessF', 'tmYRMaxLabelLenF',
+                'tmYRMaxTicks', 'tmYRMinLabelSpacingF', 'tmYRMinorLengthF',
+                'tmYRMinorLineColor', 'tmYRMinorOn', 'tmYRMinorOutwardLengthF',
+                'tmYRMinorPerMajor', 'tmYRMinorThicknessF', 'tmYRMinorValues',
+                'tmYRMode', 'tmYROn', 'tmYRPrecision', 'tmYRStyle', 'tmYRTickEndF',
+                'tmYRTickSpacingF', 'tmYRTickStartF', 'tmYRValues', 'tmYUseLeft',
+                'trGridType', 'trLineInterpolationOn',
+                'trXAxisType', 'trXCoordPoints', 'trXInterPoints', 'trXLog',
+                'trXMaxF', 'trXMinF', 'trXReverse', 'trXSamples', 'trXTensionF',
+                'trYAxisType', 'trYCoordPoints', 'trYInterPoints', 'trYLog',
+                'trYMaxF', 'trYMinF', 'trYReverse', 'trYSamples', 'trYTensionF',
+                'txAngleF', 'txBackgroundFillColor', 'txConstantSpacingF', 'txDirection',
+                'txFont', 'HLU-Fonts', 'txFontAspectF', 'txFontColor',
+                'txFontHeightF', 'txFontOpacityF', 'txFontQuality',
+                'txFontThicknessF', 'txFuncCode', 'txJust', 'txPerimColor',
+                'txPerimDashLengthF', 'txPerimDashPattern', 'txPerimOn',
+                'txPerimSpaceF', 'txPerimThicknessF', 'txPosXF', 'txPosYF',
+                'txString', 'vcExplicitLabelBarLabelsOn', 'vcFillArrowEdgeColor',
+                'vcFillArrowEdgeThicknessF', 'vcFillArrowFillColor',
+                'vcFillArrowHeadInteriorXF', 'vcFillArrowHeadMinFracXF',
+                'vcFillArrowHeadMinFracYF', 'vcFillArrowHeadXF', 'vcFillArrowHeadYF',
+                'vcFillArrowMinFracWidthF', 'vcFillArrowWidthF', 'vcFillArrowsOn',
+                'vcFillOverEdge', 'vcGlyphOpacityF', 'vcGlyphStyle',
+                'vcLabelBarEndLabelsOn', 'vcLabelFontColor', 'vcLabelFontHeightF',
+                'vcLabelsOn', 'vcLabelsUseVectorColor', 'vcLevelColors',
+                'vcLevelCount', 'vcLevelPalette', 'vcLevelSelectionMode',
+                'vcLevelSpacingF', 'vcLevels', 'vcLineArrowColor',
+                'vcLineArrowHeadMaxSizeF', 'vcLineArrowHeadMinSizeF',
+                'vcLineArrowThicknessF', 'vcMagnitudeFormat',
+                'vcMagnitudeScaleFactorF', 'vcMagnitudeScaleValueF',
+                'vcMagnitudeScalingMode', 'vcMapDirection', 'vcMaxLevelCount',
+                'vcMaxLevelValF', 'vcMaxMagnitudeF', 'vcMinAnnoAngleF',
+                'vcMinAnnoArrowAngleF', 'vcMinAnnoArrowEdgeColor',
+                'vcMinAnnoArrowFillColor', 'vcMinAnnoArrowLineColor',
+                'vcMinAnnoArrowMinOffsetF', 'vcMinAnnoArrowSpaceF',
+                'vcMinAnnoArrowUseVecColor', 'vcMinAnnoBackgroundColor',
+                'vcMinAnnoConstantSpacingF', 'vcMinAnnoExplicitMagnitudeF',
+                'vcMinAnnoFont', 'vcMinAnnoFontAspectF', 'vcMinAnnoFontColor',
+                'vcMinAnnoFontHeightF', 'vcMinAnnoFontQuality',
+                'vcMinAnnoFontThicknessF', 'vcMinAnnoFuncCode', 'vcMinAnnoJust',
+                'vcMinAnnoOn', 'vcMinAnnoOrientation', 'vcMinAnnoOrthogonalPosF',
+                'vcMinAnnoParallelPosF', 'vcMinAnnoPerimColor', 'vcMinAnnoPerimOn',
+                'vcMinAnnoPerimSpaceF', 'vcMinAnnoPerimThicknessF', 'vcMinAnnoSide',
+                'vcMinAnnoString1', 'vcMinAnnoString1On', 'vcMinAnnoString2',
+                'vcMinAnnoString2On', 'vcMinAnnoTextDirection', 'vcMinAnnoZone',
+                'vcMinDistanceF', 'vcMinFracLengthF', 'vcMinLevelValF',
+                'vcMinMagnitudeF', 'vcMonoFillArrowEdgeColor',
+                'vcMonoFillArrowFillColor', 'vcMonoLineArrowColor',
+                'vcMonoWindBarbColor', 'vcNoDataLabelOn', 'vcNoDataLabelString',
+                'vcPositionMode', 'vcRefAnnoAngleF', 'vcRefAnnoArrowAngleF',
+                'vcRefAnnoArrowEdgeColor', 'vcRefAnnoArrowFillColor',
+                'vcRefAnnoArrowLineColor', 'vcRefAnnoArrowMinOffsetF',
+                'vcRefAnnoArrowSpaceF', 'vcRefAnnoArrowUseVecColor',
+                'vcRefAnnoBackgroundColor', 'vcRefAnnoConstantSpacingF',
+                'vcRefAnnoExplicitMagnitudeF', 'vcRefAnnoFont',
+                'vcRefAnnoFontAspectF', 'vcRefAnnoFontColor', 'vcRefAnnoFontHeightF',
+                'vcRefAnnoFontQuality', 'vcRefAnnoFontThicknessF',
+                'vcRefAnnoFuncCode', 'vcRefAnnoJust', 'vcRefAnnoOn',
+                'vcRefAnnoOrientation', 'vcRefAnnoOrthogonalPosF',
+                'vcRefAnnoParallelPosF', 'vcRefAnnoPerimColor', 'vcRefAnnoPerimOn',
+                'vcRefAnnoPerimSpaceF', 'vcRefAnnoPerimThicknessF', 'vcRefAnnoSide',
+                'vcRefAnnoString1', 'vcRefAnnoString1On', 'vcRefAnnoString2',
+                'vcRefAnnoString2On', 'vcRefAnnoTextDirection', 'vcRefAnnoZone',
+                'vcRefLengthF', 'vcRefMagnitudeF', 'vcScalarFieldData',
+                'vcScalarMissingValColor', 'vcScalarValueFormat',
+                'vcScalarValueScaleFactorF', 'vcScalarValueScaleValueF',
+                'vcScalarValueScalingMode', 'vcSpanLevelPalette', 'vcUseRefAnnoRes',
+                'vcUseScalarArray', 'vcVectorDrawOrder', 'vcVectorFieldData',
+                'vcWindBarbCalmCircleSizeF', 'vcWindBarbColor',
+                'vcWindBarbLineThicknessF', 'vcWindBarbScaleFactorF',
+                'vcWindBarbTickAngleF', 'vcWindBarbTickLengthF',
+                'vcWindBarbTickSpacingF', 'vcZeroFLabelAngleF',
+                'vcZeroFLabelBackgroundColor', 'vcZeroFLabelConstantSpacingF',
+                'vcZeroFLabelFont', 'vcZeroFLabelFontAspectF',
+                'vcZeroFLabelFontColor', 'vcZeroFLabelFontHeightF',
+                'vcZeroFLabelFontQuality', 'vcZeroFLabelFontThicknessF',
+                'vcZeroFLabelFuncCode', 'vcZeroFLabelJust', 'vcZeroFLabelOn',
+                'vcZeroFLabelOrthogonalPosF', 'vcZeroFLabelParallelPosF',
+                'vcZeroFLabelPerimColor', 'vcZeroFLabelPerimOn',
+                'vcZeroFLabelPerimSpaceF', 'vcZeroFLabelPerimThicknessF',
+                'vcZeroFLabelSide', 'vcZeroFLabelString', 'vcZeroFLabelTextDirection',
+                'vcZeroFLabelZone', 'vfCopyData', 'vfDataArray',
+                'vfExchangeDimensions', 'vfExchangeUVData', 'vfMagMaxV', 'vfMagMinV',
+                'vfMissingUValueV', 'vfMissingVValueV', 'vfPolarData',
+                'vfSingleMissingValue', 'vfUDataArray', 'vfUMaxV', 'vfUMinV',
+                'vfVDataArray', 'vfVMaxV', 'vfVMinV', 'vfXArray', 'vfXCActualEndF',
+                'vfXCActualStartF', 'vfXCEndIndex', 'vfXCEndSubsetV', 'vfXCEndV',
+                'vfXCStartIndex', 'vfXCStartSubsetV', 'vfXCStartV', 'vfXCStride',
+                'vfYArray', 'vfYCActualEndF', 'vfYCActualStartF', 'vfYCEndIndex',
+                'vfYCEndSubsetV', 'vfYCEndV', 'vfYCStartIndex', 'vfYCStartSubsetV',
+                'vfYCStartV', 'vfYCStride', 'vpAnnoManagerId', 'vpClipOn',
+                'vpHeightF', 'vpKeepAspect', 'vpOn', 'vpUseSegments', 'vpWidthF',
+                'vpXF', 'vpYF', 'wkAntiAlias', 'wkBackgroundColor', 'wkBackgroundOpacityF',
+                'wkColorMapLen', 'wkColorMap', 'wkColorModel', 'wkDashTableLength',
+                'wkDefGraphicStyleId', 'wkDeviceLowerX', 'wkDeviceLowerY',
+                'wkDeviceUpperX', 'wkDeviceUpperY', 'wkFileName', 'wkFillTableLength',
+                'wkForegroundColor', 'wkFormat', 'wkFullBackground', 'wkGksWorkId',
+                'wkHeight', 'wkMarkerTableLength', 'wkMetaName', 'wkOrientation',
+                'wkPDFFileName', 'wkPDFFormat', 'wkPDFResolution', 'wkPSFileName',
+                'wkPSFormat', 'wkPSResolution', 'wkPaperHeightF', 'wkPaperSize',
+                'wkPaperWidthF', 'wkPause', 'wkTopLevelViews', 'wkViews',
+                'wkVisualType', 'wkWidth', 'wkWindowId', 'wkXColorMode', 'wsCurrentSize',
+                'wsMaximumSize', 'wsThresholdSize', 'xyComputeXMax',
+                'xyComputeXMin', 'xyComputeYMax', 'xyComputeYMin', 'xyCoordData',
+                'xyCoordDataSpec', 'xyCurveDrawOrder', 'xyDashPattern',
+                'xyDashPatterns', 'xyExplicitLabels', 'xyExplicitLegendLabels',
+                'xyLabelMode', 'xyLineColor', 'xyLineColors', 'xyLineDashSegLenF',
+                'xyLineLabelConstantSpacingF', 'xyLineLabelFont',
+                'xyLineLabelFontAspectF', 'xyLineLabelFontColor',
+                'xyLineLabelFontColors', 'xyLineLabelFontHeightF',
+                'xyLineLabelFontQuality', 'xyLineLabelFontThicknessF',
+                'xyLineLabelFuncCode', 'xyLineThicknessF', 'xyLineThicknesses',
+                'xyMarkLineMode', 'xyMarkLineModes', 'xyMarker', 'xyMarkerColor',
+                'xyMarkerColors', 'xyMarkerSizeF', 'xyMarkerSizes',
+                'xyMarkerThicknessF', 'xyMarkerThicknesses', 'xyMarkers',
+                'xyMonoDashPattern', 'xyMonoLineColor', 'xyMonoLineLabelFontColor',
+                'xyMonoLineThickness', 'xyMonoMarkLineMode', 'xyMonoMarker',
+                'xyMonoMarkerColor', 'xyMonoMarkerSize', 'xyMonoMarkerThickness',
+                'xyXIrrTensionF', 'xyXIrregularPoints', 'xyXStyle', 'xyYIrrTensionF',
+                'xyYIrregularPoints', 'xyYStyle'), prefix=r'\b'),
+             Name.Builtin),
+
+            # Booleans
+            (r'\.(True|False)\.', Name.Builtin),
+            # Comparing Operators
+            (r'\.(eq|ne|lt|le|gt|ge|not|and|or|xor)\.', Operator.Word),
+        ],
+
+        'strings': [
+            (r'(?s)"(\\\\|\\[0-7]+|\\.|[^"\\])*"', String.Double),
+        ],
+
+        'nums': [
+            (r'\d+(?![.e])(_[a-z]\w+)?', Number.Integer),
+            (r'[+-]?\d*\.\d+(e[-+]?\d+)?(_[a-z]\w+)?', Number.Float),
+            (r'[+-]?\d+\.\d*(e[-+]?\d+)?(_[a-z]\w+)?', Number.Float),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/nimrod.py b/env/lib/python3.12/site-packages/pygments/lexers/nimrod.py
new file mode 100644
index 0000000..365a8dc
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/nimrod.py
@@ -0,0 +1,199 @@
+"""
+    pygments.lexers.nimrod
+    ~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for the Nim language (formerly known as Nimrod).
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, include, default, bygroups
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Error
+
+__all__ = ['NimrodLexer']
+
+
+class NimrodLexer(RegexLexer):
+    """
+    For Nim source code.
+    """
+
+    name = 'Nimrod'
+    url = 'http://nim-lang.org/'
+    aliases = ['nimrod', 'nim']
+    filenames = ['*.nim', '*.nimrod']
+    mimetypes = ['text/x-nim']
+    version_added = '1.5'
+
+    flags = re.MULTILINE | re.IGNORECASE
+
+    def underscorize(words):
+        newWords = []
+        new = []
+        for word in words:
+            for ch in word:
+                new.append(ch)
+                new.append("_?")
+            newWords.append(''.join(new))
+            new = []
+        return "|".join(newWords)
+
+    keywords = [
+        'addr', 'and', 'as', 'asm', 'bind', 'block', 'break', 'case',
+        'cast', 'concept', 'const', 'continue', 'converter', 'defer', 'discard',
+        'distinct', 'div', 'do', 'elif', 'else', 'end', 'enum', 'except',
+        'export', 'finally', 'for', 'if', 'in', 'yield', 'interface',
+        'is', 'isnot', 'iterator', 'let', 'mixin', 'mod',
+        'not', 'notin', 'object', 'of', 'or', 'out', 'ptr', 'raise',
+        'ref', 'return', 'shl', 'shr', 'static', 'try',
+        'tuple', 'type', 'using', 'when', 'while', 'xor'
+    ]
+
+    keywordsPseudo = [
+        'nil', 'true', 'false'
+    ]
+
+    opWords = [
+        'and', 'or', 'not', 'xor', 'shl', 'shr', 'div', 'mod', 'in',
+        'notin', 'is', 'isnot'
+    ]
+
+    types = [
+        'int', 'int8', 'int16', 'int32', 'int64', 'float', 'float32', 'float64',
+        'bool', 'char', 'range', 'array', 'seq', 'set', 'string'
+    ]
+
+    tokens = {
+        'root': [
+            # Comments
+            (r'##\[', String.Doc, 'doccomment'),
+            (r'##.*$', String.Doc),
+            (r'#\[', Comment.Multiline, 'comment'),
+            (r'#.*$', Comment),
+
+            # Pragmas
+            (r'\{\.', String.Other, 'pragma'),
+
+            # Operators
+            (r'[*=><+\-/@$~&%!?|\\\[\]]', Operator),
+            (r'\.\.|\.|,|\[\.|\.\]|\{\.|\.\}|\(\.|\.\)|\{|\}|\(|\)|:|\^|`|;',
+             Punctuation),
+
+            # Case statement branch
+            (r'(\n\s*)(of)(\s)', bygroups(Text.Whitespace, Keyword,
+                                          Text.Whitespace), 'casebranch'),
+
+            # Strings
+            (r'(?:[\w]+)"', String, 'rdqs'),
+            (r'"""', String.Double, 'tdqs'),
+            ('"', String, 'dqs'),
+
+            # Char
+            ("'", String.Char, 'chars'),
+
+            # Keywords
+            (rf'({underscorize(opWords)})\b', Operator.Word),
+            (r'(proc|func|method|macro|template)(\s)(?![(\[\]])',
+             bygroups(Keyword, Text.Whitespace), 'funcname'),
+            (rf'({underscorize(keywords)})\b', Keyword),
+            (r'({})\b'.format(underscorize(['from', 'import', 'include', 'export'])),
+             Keyword.Namespace),
+            (r'(v_?a_?r)\b', Keyword.Declaration),
+            (rf'({underscorize(types)})\b', Name.Builtin),
+            (rf'({underscorize(keywordsPseudo)})\b', Keyword.Pseudo),
+
+            # Identifiers
+            (r'\b((?![_\d])\w)(((?!_)\w)|(_(?!_)\w))*', Name),
+
+            # Numbers
+            (r'[0-9][0-9_]*(?=([e.]|\'f(32|64)))',
+             Number.Float, ('float-suffix', 'float-number')),
+            (r'0x[a-f0-9][a-f0-9_]*', Number.Hex, 'int-suffix'),
+            (r'0b[01][01_]*', Number.Bin, 'int-suffix'),
+            (r'0o[0-7][0-7_]*', Number.Oct, 'int-suffix'),
+            (r'[0-9][0-9_]*', Number.Integer, 'int-suffix'),
+
+            # Whitespace
+            (r'\s+', Text.Whitespace),
+            (r'.+$', Error),
+        ],
+        'chars': [
+            (r'\\([\\abcefnrtvl"\']|x[a-f0-9]{2}|[0-9]{1,3})', String.Escape),
+            (r"'", String.Char, '#pop'),
+            (r".", String.Char)
+        ],
+        'strings': [
+            (r'(?|>=|>>|>|<=|<<|<|\+|-|=|/|\*|%|\+=|-=|!|@', Operator),
+            (r'\(|\)|\[|\]|,|\.\.\.|\.\.|\.|::|:', Punctuation),
+            (r'`\{[^`]*`\}', Text),  # Extern blocks won't be Lexed by Nit
+            (r'[\r\n\t ]+', Text),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/nix.py b/env/lib/python3.12/site-packages/pygments/lexers/nix.py
new file mode 100644
index 0000000..3fa88c6
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/nix.py
@@ -0,0 +1,144 @@
+"""
+    pygments.lexers.nix
+    ~~~~~~~~~~~~~~~~~~~
+
+    Lexers for the NixOS Nix language.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, include
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Literal
+
+__all__ = ['NixLexer']
+
+
+class NixLexer(RegexLexer):
+    """
+    For the Nix language.
+    """
+
+    name = 'Nix'
+    url = 'http://nixos.org/nix/'
+    aliases = ['nixos', 'nix']
+    filenames = ['*.nix']
+    mimetypes = ['text/x-nix']
+    version_added = '2.0'
+
+    keywords = ['rec', 'with', 'let', 'in', 'inherit', 'assert', 'if',
+                'else', 'then', '...']
+    builtins = ['import', 'abort', 'baseNameOf', 'dirOf', 'isNull', 'builtins',
+                'map', 'removeAttrs', 'throw', 'toString', 'derivation']
+    operators = ['++', '+', '?', '.', '!', '//', '==', '/',
+                 '!=', '&&', '||', '->', '=', '<', '>', '*', '-']
+
+    punctuations = ["(", ")", "[", "]", ";", "{", "}", ":", ",", "@"]
+
+    tokens = {
+        'root': [
+            # comments starting with #
+            (r'#.*$', Comment.Single),
+
+            # multiline comments
+            (r'/\*', Comment.Multiline, 'comment'),
+
+            # whitespace
+            (r'\s+', Text),
+
+            # keywords
+            ('({})'.format('|'.join(re.escape(entry) + '\\b' for entry in keywords)), Keyword),
+
+            # highlight the builtins
+            ('({})'.format('|'.join(re.escape(entry) + '\\b' for entry in builtins)),
+             Name.Builtin),
+
+            (r'\b(true|false|null)\b', Name.Constant),
+
+            # floats
+            (r'-?(\d+\.\d*|\.\d+)([eE][-+]?\d+)?', Number.Float),
+
+            # integers
+            (r'-?[0-9]+', Number.Integer),
+
+            # paths
+            (r'[\w.+-]*(\/[\w.+-]+)+', Literal),
+            (r'~(\/[\w.+-]+)+', Literal),
+            (r'\<[\w.+-]+(\/[\w.+-]+)*\>', Literal),
+
+            # operators
+            ('({})'.format('|'.join(re.escape(entry) for entry in operators)),
+             Operator),
+
+            # word operators
+            (r'\b(or|and)\b', Operator.Word),
+
+            (r'\{', Punctuation, 'block'),
+
+            # punctuations
+            ('({})'.format('|'.join(re.escape(entry) for entry in punctuations)), Punctuation),
+
+            # strings
+            (r'"', String.Double, 'doublequote'),
+            (r"''", String.Multiline, 'multiline'),
+
+            # urls
+            (r'[a-zA-Z][a-zA-Z0-9\+\-\.]*\:[\w%/?:@&=+$,\\.!~*\'-]+', Literal),
+
+            # names of variables
+            (r'[\w-]+(?=\s*=)', String.Symbol),
+            (r'[a-zA-Z_][\w\'-]*', Text),
+
+            (r"\$\{", String.Interpol, 'antiquote'),
+        ],
+        'comment': [
+            (r'[^/*]+', Comment.Multiline),
+            (r'/\*', Comment.Multiline, '#push'),
+            (r'\*/', Comment.Multiline, '#pop'),
+            (r'[*/]', Comment.Multiline),
+        ],
+        'multiline': [
+            (r"''(\$|'|\\n|\\r|\\t|\\)", String.Escape),
+            (r"''", String.Multiline, '#pop'),
+            (r'\$\{', String.Interpol, 'antiquote'),
+            (r"[^'\$]+", String.Multiline),
+            (r"\$[^\{']", String.Multiline),
+            (r"'[^']", String.Multiline),
+            (r"\$(?=')", String.Multiline),
+        ],
+        'doublequote': [
+            (r'\\(\\|"|\$|n)', String.Escape),
+            (r'"', String.Double, '#pop'),
+            (r'\$\{', String.Interpol, 'antiquote'),
+            (r'[^"\\\$]+', String.Double),
+            (r'\$[^\{"]', String.Double),
+            (r'\$(?=")', String.Double),
+            (r'\\', String.Double),
+        ],
+        'antiquote': [
+            (r"\}", String.Interpol, '#pop'),
+            # TODO: we should probably escape also here ''${ \${
+            (r"\$\{", String.Interpol, '#push'),
+            include('root'),
+        ],
+        'block': [
+            (r"\}", Punctuation, '#pop'),
+            include('root'),
+        ],
+    }
+
+    def analyse_text(text):
+        rv = 0.0
+        # TODO: let/in
+        if re.search(r'import.+?<[^>]+>', text):
+            rv += 0.4
+        if re.search(r'mkDerivation\s+(\(|\{|rec)', text):
+            rv += 0.4
+        if re.search(r'=\s+mkIf\s+', text):
+            rv += 0.4
+        if re.search(r'\{[a-zA-Z,\s]+\}:', text):
+            rv += 0.1
+        return rv
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/numbair.py b/env/lib/python3.12/site-packages/pygments/lexers/numbair.py
new file mode 100644
index 0000000..435863e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/numbair.py
@@ -0,0 +1,63 @@
+"""
+    pygments.lexers.numbair
+    ~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for other Numba Intermediate Representation.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, include, bygroups, words
+from pygments.token import Whitespace, Name, String,  Punctuation, Keyword, \
+    Operator, Number
+
+__all__ = ["NumbaIRLexer"]
+
+class NumbaIRLexer(RegexLexer):
+    """
+    Lexer for Numba IR
+    """
+    name = 'Numba_IR'
+    url = "https://numba.readthedocs.io/en/stable/developer/architecture.html#stage-2-generate-the-numba-ir"
+    aliases = ['numba_ir', 'numbair']
+    filenames = ['*.numba_ir']
+    mimetypes = ['text/x-numba_ir', 'text/x-numbair']
+    version_added = '2.19'
+
+    identifier = r'\$[a-zA-Z0-9._]+'
+    fun_or_var = r'([a-zA-Z_]+[a-zA-Z0-9]*)'
+
+    tokens = {
+        'root' : [
+            (r'(label)(\ [0-9]+)(:)$',
+                bygroups(Keyword, Name.Label, Punctuation)),
+
+            (r'=', Operator),
+            include('whitespace'),
+            include('keyword'),
+
+            (identifier, Name.Variable),
+            (fun_or_var + r'(\()',
+                bygroups(Name.Function, Punctuation)),
+            (fun_or_var + r'(\=)',
+                bygroups(Name.Attribute, Punctuation)),
+            (fun_or_var, Name.Constant),
+            (r'[0-9]+', Number),
+
+            # 
+            (r'<[^>\n]*>', String),
+
+            (r'[=<>{}\[\]()*.,!\':]|x\b', Punctuation)
+        ],
+
+        'keyword':[
+            (words((
+                'del', 'jump', 'call', 'branch',
+            ), suffix=' '), Keyword),
+        ],
+
+        'whitespace': [
+            (r'(\n|\s)+', Whitespace),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/oberon.py b/env/lib/python3.12/site-packages/pygments/lexers/oberon.py
new file mode 100644
index 0000000..61f3c2d
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/oberon.py
@@ -0,0 +1,120 @@
+"""
+    pygments.lexers.oberon
+    ~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Oberon family languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, include, words
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation
+
+__all__ = ['ComponentPascalLexer']
+
+
+class ComponentPascalLexer(RegexLexer):
+    """
+    For Component Pascal source code.
+    """
+    name = 'Component Pascal'
+    aliases = ['componentpascal', 'cp']
+    filenames = ['*.cp', '*.cps']
+    mimetypes = ['text/x-component-pascal']
+    url = 'https://blackboxframework.org'
+    version_added = '2.1'
+
+    flags = re.MULTILINE | re.DOTALL
+
+    tokens = {
+        'root': [
+            include('whitespace'),
+            include('comments'),
+            include('punctuation'),
+            include('numliterals'),
+            include('strings'),
+            include('operators'),
+            include('builtins'),
+            include('identifiers'),
+        ],
+        'whitespace': [
+            (r'\n+', Text),  # blank lines
+            (r'\s+', Text),  # whitespace
+        ],
+        'comments': [
+            (r'\(\*([^$].*?)\*\)', Comment.Multiline),
+            # TODO: nested comments (* (* ... *) ... (* ... *) *) not supported!
+        ],
+        'punctuation': [
+            (r'[()\[\]{},.:;|]', Punctuation),
+        ],
+        'numliterals': [
+            (r'[0-9A-F]+X\b', Number.Hex),                 # char code
+            (r'[0-9A-F]+[HL]\b', Number.Hex),              # hexadecimal number
+            (r'[0-9]+\.[0-9]+E[+-][0-9]+', Number.Float),  # real number
+            (r'[0-9]+\.[0-9]+', Number.Float),             # real number
+            (r'[0-9]+', Number.Integer),                   # decimal whole number
+        ],
+        'strings': [
+            (r"'[^\n']*'", String),  # single quoted string
+            (r'"[^\n"]*"', String),  # double quoted string
+        ],
+        'operators': [
+            # Arithmetic Operators
+            (r'[+-]', Operator),
+            (r'[*/]', Operator),
+            # Relational Operators
+            (r'[=#<>]', Operator),
+            # Dereferencing Operator
+            (r'\^', Operator),
+            # Logical AND Operator
+            (r'&', Operator),
+            # Logical NOT Operator
+            (r'~', Operator),
+            # Assignment Symbol
+            (r':=', Operator),
+            # Range Constructor
+            (r'\.\.', Operator),
+            (r'\$', Operator),
+        ],
+        'identifiers': [
+            (r'([a-zA-Z_$][\w$]*)', Name),
+        ],
+        'builtins': [
+            (words((
+                'ANYPTR', 'ANYREC', 'BOOLEAN', 'BYTE', 'CHAR', 'INTEGER', 'LONGINT',
+                'REAL', 'SET', 'SHORTCHAR', 'SHORTINT', 'SHORTREAL'
+                ), suffix=r'\b'), Keyword.Type),
+            (words((
+                'ABS', 'ABSTRACT', 'ARRAY', 'ASH', 'ASSERT', 'BEGIN', 'BITS', 'BY',
+                'CAP', 'CASE', 'CHR', 'CLOSE', 'CONST', 'DEC', 'DIV', 'DO', 'ELSE',
+                'ELSIF', 'EMPTY', 'END', 'ENTIER', 'EXCL', 'EXIT', 'EXTENSIBLE', 'FOR',
+                'HALT', 'IF', 'IMPORT', 'IN', 'INC', 'INCL', 'IS', 'LEN', 'LIMITED',
+                'LONG', 'LOOP', 'MAX', 'MIN', 'MOD', 'MODULE', 'NEW', 'ODD', 'OF',
+                'OR', 'ORD', 'OUT', 'POINTER', 'PROCEDURE', 'RECORD', 'REPEAT', 'RETURN',
+                'SHORT', 'SHORTCHAR', 'SHORTINT', 'SIZE', 'THEN', 'TYPE', 'TO', 'UNTIL',
+                'VAR', 'WHILE', 'WITH'
+                ), suffix=r'\b'), Keyword.Reserved),
+            (r'(TRUE|FALSE|NIL|INF)\b', Keyword.Constant),
+        ]
+    }
+
+    def analyse_text(text):
+        """The only other lexer using .cp is the C++ one, so we check if for
+        a few common Pascal keywords here. Those are unfortunately quite
+        common across various business languages as well."""
+        result = 0
+        if 'BEGIN' in text:
+            result += 0.01
+        if 'END' in text:
+            result += 0.01
+        if 'PROCEDURE' in text:
+            result += 0.01
+        if 'END' in text:
+            result += 0.01
+
+        return result
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/objective.py b/env/lib/python3.12/site-packages/pygments/lexers/objective.py
new file mode 100644
index 0000000..899c2c4
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/objective.py
@@ -0,0 +1,513 @@
+"""
+    pygments.lexers.objective
+    ~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Objective-C family languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, include, bygroups, using, this, words, \
+    inherit, default
+from pygments.token import Text, Keyword, Name, String, Operator, \
+    Number, Punctuation, Literal, Comment, Whitespace
+
+from pygments.lexers.c_cpp import CLexer, CppLexer
+
+__all__ = ['ObjectiveCLexer', 'ObjectiveCppLexer', 'LogosLexer', 'SwiftLexer']
+
+
+def objective(baselexer):
+    """
+    Generate a subclass of baselexer that accepts the Objective-C syntax
+    extensions.
+    """
+
+    # Have to be careful not to accidentally match JavaDoc/Doxygen syntax here,
+    # since that's quite common in ordinary C/C++ files.  It's OK to match
+    # JavaDoc/Doxygen keywords that only apply to Objective-C, mind.
+    #
+    # The upshot of this is that we CANNOT match @class or @interface
+    _oc_keywords = re.compile(r'@(?:end|implementation|protocol)')
+
+    # Matches [ ? identifier  ( identifier ? ] |  identifier? : )
+    # (note the identifier is *optional* when there is a ':'!)
+    _oc_message = re.compile(r'\[\s*[a-zA-Z_]\w*\s+'
+                             r'(?:[a-zA-Z_]\w*\s*\]|'
+                             r'(?:[a-zA-Z_]\w*)?:)')
+
+    class GeneratedObjectiveCVariant(baselexer):
+        """
+        Implements Objective-C syntax on top of an existing C family lexer.
+        """
+
+        tokens = {
+            'statements': [
+                (r'@"', String, 'string'),
+                (r'@(YES|NO)', Number),
+                (r"@'(\\.|\\[0-7]{1,3}|\\x[a-fA-F0-9]{1,2}|[^\\\'\n])'", String.Char),
+                (r'@(\d+\.\d*|\.\d+|\d+)[eE][+-]?\d+[lL]?', Number.Float),
+                (r'@(\d+\.\d*|\.\d+|\d+[fF])[fF]?', Number.Float),
+                (r'@0x[0-9a-fA-F]+[Ll]?', Number.Hex),
+                (r'@0[0-7]+[Ll]?', Number.Oct),
+                (r'@\d+[Ll]?', Number.Integer),
+                (r'@\(', Literal, 'literal_number'),
+                (r'@\[', Literal, 'literal_array'),
+                (r'@\{', Literal, 'literal_dictionary'),
+                (words((
+                    '@selector', '@private', '@protected', '@public', '@encode',
+                    '@synchronized', '@try', '@throw', '@catch', '@finally',
+                    '@end', '@property', '@synthesize', '__bridge', '__bridge_transfer',
+                    '__autoreleasing', '__block', '__weak', '__strong', 'weak', 'strong',
+                    'copy', 'retain', 'assign', 'unsafe_unretained', 'atomic', 'nonatomic',
+                    'readonly', 'readwrite', 'setter', 'getter', 'typeof', 'in',
+                    'out', 'inout', 'release', 'class', '@dynamic', '@optional',
+                    '@required', '@autoreleasepool', '@import'), suffix=r'\b'),
+                 Keyword),
+                (words(('id', 'instancetype', 'Class', 'IMP', 'SEL', 'BOOL',
+                        'IBOutlet', 'IBAction', 'unichar'), suffix=r'\b'),
+                 Keyword.Type),
+                (r'@(true|false|YES|NO)\n', Name.Builtin),
+                (r'(YES|NO|nil|self|super)\b', Name.Builtin),
+                # Carbon types
+                (r'(Boolean|UInt8|SInt8|UInt16|SInt16|UInt32|SInt32)\b', Keyword.Type),
+                # Carbon built-ins
+                (r'(TRUE|FALSE)\b', Name.Builtin),
+                (r'(@interface|@implementation)(\s+)', bygroups(Keyword, Text),
+                 ('#pop', 'oc_classname')),
+                (r'(@class|@protocol)(\s+)', bygroups(Keyword, Text),
+                 ('#pop', 'oc_forward_classname')),
+                # @ can also prefix other expressions like @{...} or @(...)
+                (r'@', Punctuation),
+                inherit,
+            ],
+            'oc_classname': [
+                # interface definition that inherits
+                (r'([a-zA-Z$_][\w$]*)(\s*:\s*)([a-zA-Z$_][\w$]*)?(\s*)(\{)',
+                 bygroups(Name.Class, Text, Name.Class, Text, Punctuation),
+                 ('#pop', 'oc_ivars')),
+                (r'([a-zA-Z$_][\w$]*)(\s*:\s*)([a-zA-Z$_][\w$]*)?',
+                 bygroups(Name.Class, Text, Name.Class), '#pop'),
+                # interface definition for a category
+                (r'([a-zA-Z$_][\w$]*)(\s*)(\([a-zA-Z$_][\w$]*\))(\s*)(\{)',
+                 bygroups(Name.Class, Text, Name.Label, Text, Punctuation),
+                 ('#pop', 'oc_ivars')),
+                (r'([a-zA-Z$_][\w$]*)(\s*)(\([a-zA-Z$_][\w$]*\))',
+                 bygroups(Name.Class, Text, Name.Label), '#pop'),
+                # simple interface / implementation
+                (r'([a-zA-Z$_][\w$]*)(\s*)(\{)',
+                 bygroups(Name.Class, Text, Punctuation), ('#pop', 'oc_ivars')),
+                (r'([a-zA-Z$_][\w$]*)', Name.Class, '#pop')
+            ],
+            'oc_forward_classname': [
+                (r'([a-zA-Z$_][\w$]*)(\s*,\s*)',
+                 bygroups(Name.Class, Text), 'oc_forward_classname'),
+                (r'([a-zA-Z$_][\w$]*)(\s*;?)',
+                 bygroups(Name.Class, Text), '#pop')
+            ],
+            'oc_ivars': [
+                include('whitespace'),
+                include('statements'),
+                (';', Punctuation),
+                (r'\{', Punctuation, '#push'),
+                (r'\}', Punctuation, '#pop'),
+            ],
+            'root': [
+                # methods
+                (r'^([-+])(\s*)'                         # method marker
+                 r'(\(.*?\))?(\s*)'                      # return type
+                 r'([a-zA-Z$_][\w$]*:?)',        # begin of method name
+                 bygroups(Punctuation, Text, using(this),
+                          Text, Name.Function),
+                 'method'),
+                inherit,
+            ],
+            'method': [
+                include('whitespace'),
+                # TODO unsure if ellipses are allowed elsewhere, see
+                # discussion in Issue 789
+                (r',', Punctuation),
+                (r'\.\.\.', Punctuation),
+                (r'(\(.*?\))(\s*)([a-zA-Z$_][\w$]*)',
+                 bygroups(using(this), Text, Name.Variable)),
+                (r'[a-zA-Z$_][\w$]*:', Name.Function),
+                (';', Punctuation, '#pop'),
+                (r'\{', Punctuation, 'function'),
+                default('#pop'),
+            ],
+            'literal_number': [
+                (r'\(', Punctuation, 'literal_number_inner'),
+                (r'\)', Literal, '#pop'),
+                include('statement'),
+            ],
+            'literal_number_inner': [
+                (r'\(', Punctuation, '#push'),
+                (r'\)', Punctuation, '#pop'),
+                include('statement'),
+            ],
+            'literal_array': [
+                (r'\[', Punctuation, 'literal_array_inner'),
+                (r'\]', Literal, '#pop'),
+                include('statement'),
+            ],
+            'literal_array_inner': [
+                (r'\[', Punctuation, '#push'),
+                (r'\]', Punctuation, '#pop'),
+                include('statement'),
+            ],
+            'literal_dictionary': [
+                (r'\}', Literal, '#pop'),
+                include('statement'),
+            ],
+        }
+
+        def analyse_text(text):
+            if _oc_keywords.search(text):
+                return 1.0
+            elif '@"' in text:  # strings
+                return 0.8
+            elif re.search('@[0-9]+', text):
+                return 0.7
+            elif _oc_message.search(text):
+                return 0.8
+            return 0
+
+        def get_tokens_unprocessed(self, text, stack=('root',)):
+            from pygments.lexers._cocoa_builtins import COCOA_INTERFACES, \
+                COCOA_PROTOCOLS, COCOA_PRIMITIVES
+
+            for index, token, value in \
+                    baselexer.get_tokens_unprocessed(self, text, stack):
+                if token is Name or token is Name.Class:
+                    if value in COCOA_INTERFACES or value in COCOA_PROTOCOLS \
+                       or value in COCOA_PRIMITIVES:
+                        token = Name.Builtin.Pseudo
+
+                yield index, token, value
+
+    return GeneratedObjectiveCVariant
+
+
+class ObjectiveCLexer(objective(CLexer)):
+    """
+    For Objective-C source code with preprocessor directives.
+    """
+
+    name = 'Objective-C'
+    url = 'https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/Introduction/Introduction.html'
+    aliases = ['objective-c', 'objectivec', 'obj-c', 'objc']
+    filenames = ['*.m', '*.h']
+    mimetypes = ['text/x-objective-c']
+    version_added = ''
+    priority = 0.05    # Lower than C
+
+
+class ObjectiveCppLexer(objective(CppLexer)):
+    """
+    For Objective-C++ source code with preprocessor directives.
+    """
+
+    name = 'Objective-C++'
+    aliases = ['objective-c++', 'objectivec++', 'obj-c++', 'objc++']
+    filenames = ['*.mm', '*.hh']
+    mimetypes = ['text/x-objective-c++']
+    version_added = ''
+    priority = 0.05    # Lower than C++
+
+
+class LogosLexer(ObjectiveCppLexer):
+    """
+    For Logos + Objective-C source code with preprocessor directives.
+    """
+
+    name = 'Logos'
+    aliases = ['logos']
+    filenames = ['*.x', '*.xi', '*.xm', '*.xmi']
+    mimetypes = ['text/x-logos']
+    version_added = '1.6'
+    priority = 0.25
+
+    tokens = {
+        'statements': [
+            (r'(%orig|%log)\b', Keyword),
+            (r'(%c)\b(\()(\s*)([a-zA-Z$_][\w$]*)(\s*)(\))',
+             bygroups(Keyword, Punctuation, Text, Name.Class, Text, Punctuation)),
+            (r'(%init)\b(\()',
+             bygroups(Keyword, Punctuation), 'logos_init_directive'),
+            (r'(%init)(?=\s*;)', bygroups(Keyword)),
+            (r'(%hook|%group)(\s+)([a-zA-Z$_][\w$]+)',
+             bygroups(Keyword, Text, Name.Class), '#pop'),
+            (r'(%subclass)(\s+)', bygroups(Keyword, Text),
+             ('#pop', 'logos_classname')),
+            inherit,
+        ],
+        'logos_init_directive': [
+            (r'\s+', Text),
+            (',', Punctuation, ('logos_init_directive', '#pop')),
+            (r'([a-zA-Z$_][\w$]*)(\s*)(=)(\s*)([^);]*)',
+             bygroups(Name.Class, Text, Punctuation, Text, Text)),
+            (r'([a-zA-Z$_][\w$]*)', Name.Class),
+            (r'\)', Punctuation, '#pop'),
+        ],
+        'logos_classname': [
+            (r'([a-zA-Z$_][\w$]*)(\s*:\s*)([a-zA-Z$_][\w$]*)?',
+             bygroups(Name.Class, Text, Name.Class), '#pop'),
+            (r'([a-zA-Z$_][\w$]*)', Name.Class, '#pop')
+        ],
+        'root': [
+            (r'(%subclass)(\s+)', bygroups(Keyword, Text),
+             'logos_classname'),
+            (r'(%hook|%group)(\s+)([a-zA-Z$_][\w$]+)',
+             bygroups(Keyword, Text, Name.Class)),
+            (r'(%config)(\s*\(\s*)(\w+)(\s*=)(.*?)(\)\s*)',
+             bygroups(Keyword, Text, Name.Variable, Text, String, Text)),
+            (r'(%ctor)(\s*)(\{)', bygroups(Keyword, Text, Punctuation),
+             'function'),
+            (r'(%new)(\s*)(\()(.*?)(\))',
+             bygroups(Keyword, Text, Keyword, String, Keyword)),
+            (r'(\s*)(%end)(\s*)', bygroups(Text, Keyword, Text)),
+            inherit,
+        ],
+    }
+
+    _logos_keywords = re.compile(r'%(?:hook|ctor|init|c\()')
+
+    def analyse_text(text):
+        if LogosLexer._logos_keywords.search(text):
+            return 1.0
+        return 0
+
+
+class SwiftLexer(RegexLexer):
+    """
+    For Swift source.
+    """
+    name = 'Swift'
+    url = 'https://www.swift.org/'
+    filenames = ['*.swift']
+    aliases = ['swift']
+    mimetypes = ['text/x-swift']
+    version_added = '2.0'
+
+    tokens = {
+        'root': [
+            # Whitespace and Comments
+            (r'\n', Text),
+            (r'\s+', Whitespace),
+            (r'//', Comment.Single, 'comment-single'),
+            (r'/\*', Comment.Multiline, 'comment-multi'),
+            (r'#(if|elseif|else|endif|available)\b', Comment.Preproc, 'preproc'),
+
+            # Keywords
+            include('keywords'),
+
+            # Global Types
+            (words((
+                'Array', 'AutoreleasingUnsafeMutablePointer', 'BidirectionalReverseView',
+                'Bit', 'Bool', 'CFunctionPointer', 'COpaquePointer', 'CVaListPointer',
+                'Character', 'ClosedInterval', 'CollectionOfOne', 'ContiguousArray',
+                'Dictionary', 'DictionaryGenerator', 'DictionaryIndex', 'Double',
+                'EmptyCollection', 'EmptyGenerator', 'EnumerateGenerator',
+                'EnumerateSequence', 'FilterCollectionView',
+                'FilterCollectionViewIndex', 'FilterGenerator', 'FilterSequenceView',
+                'Float', 'Float80', 'FloatingPointClassification', 'GeneratorOf',
+                'GeneratorOfOne', 'GeneratorSequence', 'HalfOpenInterval', 'HeapBuffer',
+                'HeapBufferStorage', 'ImplicitlyUnwrappedOptional', 'IndexingGenerator',
+                'Int', 'Int16', 'Int32', 'Int64', 'Int8', 'LazyBidirectionalCollection',
+                'LazyForwardCollection', 'LazyRandomAccessCollection',
+                'LazySequence', 'MapCollectionView', 'MapSequenceGenerator',
+                'MapSequenceView', 'MirrorDisposition', 'ObjectIdentifier', 'OnHeap',
+                'Optional', 'PermutationGenerator', 'QuickLookObject',
+                'RandomAccessReverseView', 'Range', 'RangeGenerator', 'RawByte', 'Repeat',
+                'ReverseBidirectionalIndex', 'ReverseRandomAccessIndex', 'SequenceOf',
+                'SinkOf', 'Slice', 'StaticString', 'StrideThrough', 'StrideThroughGenerator',
+                'StrideTo', 'StrideToGenerator', 'String', 'UInt', 'UInt16', 'UInt32',
+                'UInt64', 'UInt8', 'UTF16', 'UTF32', 'UTF8', 'UnicodeDecodingResult',
+                'UnicodeScalar', 'Unmanaged', 'UnsafeBufferPointer',
+                'UnsafeBufferPointerGenerator', 'UnsafeMutableBufferPointer',
+                'UnsafeMutablePointer', 'UnsafePointer', 'Zip2', 'ZipGenerator2',
+                # Protocols
+                'AbsoluteValuable', 'AnyObject', 'ArrayLiteralConvertible',
+                'BidirectionalIndexType', 'BitwiseOperationsType',
+                'BooleanLiteralConvertible', 'BooleanType', 'CVarArgType',
+                'CollectionType', 'Comparable', 'DebugPrintable',
+                'DictionaryLiteralConvertible', 'Equatable',
+                'ExtendedGraphemeClusterLiteralConvertible',
+                'ExtensibleCollectionType', 'FloatLiteralConvertible',
+                'FloatingPointType', 'ForwardIndexType', 'GeneratorType', 'Hashable',
+                'IntegerArithmeticType', 'IntegerLiteralConvertible', 'IntegerType',
+                'IntervalType', 'MirrorType', 'MutableCollectionType', 'MutableSliceable',
+                'NilLiteralConvertible', 'OutputStreamType', 'Printable',
+                'RandomAccessIndexType', 'RangeReplaceableCollectionType',
+                'RawOptionSetType', 'RawRepresentable', 'Reflectable', 'SequenceType',
+                'SignedIntegerType', 'SignedNumberType', 'SinkType', 'Sliceable',
+                'Streamable', 'Strideable', 'StringInterpolationConvertible',
+                'StringLiteralConvertible', 'UnicodeCodecType',
+                'UnicodeScalarLiteralConvertible', 'UnsignedIntegerType',
+                '_ArrayBufferType', '_BidirectionalIndexType', '_CocoaStringType',
+                '_CollectionType', '_Comparable', '_ExtensibleCollectionType',
+                '_ForwardIndexType', '_Incrementable', '_IntegerArithmeticType',
+                '_IntegerType', '_ObjectiveCBridgeable', '_RandomAccessIndexType',
+                '_RawOptionSetType', '_SequenceType', '_Sequence_Type',
+                '_SignedIntegerType', '_SignedNumberType', '_Sliceable', '_Strideable',
+                '_SwiftNSArrayRequiredOverridesType', '_SwiftNSArrayType',
+                '_SwiftNSCopyingType', '_SwiftNSDictionaryRequiredOverridesType',
+                '_SwiftNSDictionaryType', '_SwiftNSEnumeratorType',
+                '_SwiftNSFastEnumerationType', '_SwiftNSStringRequiredOverridesType',
+                '_SwiftNSStringType', '_UnsignedIntegerType',
+                # Variables
+                'C_ARGC', 'C_ARGV', 'Process',
+                # Typealiases
+                'Any', 'AnyClass', 'BooleanLiteralType', 'CBool', 'CChar', 'CChar16',
+                'CChar32', 'CDouble', 'CFloat', 'CInt', 'CLong', 'CLongLong', 'CShort',
+                'CSignedChar', 'CUnsignedInt', 'CUnsignedLong', 'CUnsignedShort',
+                'CWideChar', 'ExtendedGraphemeClusterType', 'Float32', 'Float64',
+                'FloatLiteralType', 'IntMax', 'IntegerLiteralType', 'StringLiteralType',
+                'UIntMax', 'UWord', 'UnicodeScalarType', 'Void', 'Word',
+                # Foundation/Cocoa
+                'NSErrorPointer', 'NSObjectProtocol', 'Selector'), suffix=r'\b'),
+             Name.Builtin),
+            # Functions
+            (words((
+                'abs', 'advance', 'alignof', 'alignofValue', 'assert', 'assertionFailure',
+                'contains', 'count', 'countElements', 'debugPrint', 'debugPrintln',
+                'distance', 'dropFirst', 'dropLast', 'dump', 'enumerate', 'equal',
+                'extend', 'fatalError', 'filter', 'find', 'first', 'getVaList', 'indices',
+                'insert', 'isEmpty', 'join', 'last', 'lazy', 'lexicographicalCompare',
+                'map', 'max', 'maxElement', 'min', 'minElement', 'numericCast', 'overlaps',
+                'partition', 'precondition', 'preconditionFailure', 'prefix', 'print',
+                'println', 'reduce', 'reflect', 'removeAll', 'removeAtIndex', 'removeLast',
+                'removeRange', 'reverse', 'sizeof', 'sizeofValue', 'sort', 'sorted',
+                'splice', 'split', 'startsWith', 'stride', 'strideof', 'strideofValue',
+                'suffix', 'swap', 'toDebugString', 'toString', 'transcode',
+                'underestimateCount', 'unsafeAddressOf', 'unsafeBitCast', 'unsafeDowncast',
+                'withExtendedLifetime', 'withUnsafeMutablePointer',
+                'withUnsafeMutablePointers', 'withUnsafePointer', 'withUnsafePointers',
+                'withVaList'), suffix=r'\b'),
+             Name.Builtin.Pseudo),
+
+            # Implicit Block Variables
+            (r'\$\d+', Name.Variable),
+
+            # Binary Literal
+            (r'0b[01_]+', Number.Bin),
+            # Octal Literal
+            (r'0o[0-7_]+', Number.Oct),
+            # Hexadecimal Literal
+            (r'0x[0-9a-fA-F_]+', Number.Hex),
+            # Decimal Literal
+            (r'[0-9][0-9_]*(\.[0-9_]+[eE][+\-]?[0-9_]+|'
+             r'\.[0-9_]*|[eE][+\-]?[0-9_]+)', Number.Float),
+            (r'[0-9][0-9_]*', Number.Integer),
+            # String Literal
+            (r'"""', String, 'string-multi'),
+            (r'"', String, 'string'),
+
+            # Operators and Punctuation
+            (r'[(){}\[\].,:;=@#`?]|->|[<&?](?=\w)|(?<=\w)[>!?]', Punctuation),
+            (r'[/=\-+!*%<>&|^?~]+', Operator),
+
+            # Identifier
+            (r'[a-zA-Z_]\w*', Name)
+        ],
+        'keywords': [
+            (words((
+                'as', 'async', 'await', 'break', 'case', 'catch', 'continue', 'default', 'defer',
+                'do', 'else', 'fallthrough', 'for', 'guard', 'if', 'in', 'is',
+                'repeat', 'return', '#selector', 'switch', 'throw', 'try',
+                'where', 'while'), suffix=r'\b'),
+             Keyword),
+            (r'@availability\([^)]+\)', Keyword.Reserved),
+            (words((
+                'associativity', 'convenience', 'dynamic', 'didSet', 'final',
+                'get', 'indirect', 'infix', 'inout', 'lazy', 'left', 'mutating',
+                'none', 'nonmutating', 'optional', 'override', 'postfix',
+                'precedence', 'prefix', 'Protocol', 'required', 'rethrows',
+                'right', 'set', 'throws', 'Type', 'unowned', 'weak', 'willSet',
+                '@availability', '@autoclosure', '@noreturn',
+                '@NSApplicationMain', '@NSCopying', '@NSManaged', '@objc',
+                '@UIApplicationMain', '@IBAction', '@IBDesignable',
+                '@IBInspectable', '@IBOutlet'), suffix=r'\b'),
+             Keyword.Reserved),
+            (r'(as|dynamicType|false|is|nil|self|Self|super|true|__COLUMN__'
+             r'|__FILE__|__FUNCTION__|__LINE__|_'
+             r'|#(?:file|line|column|function))\b', Keyword.Constant),
+            (r'import\b', Keyword.Declaration, 'module'),
+            (r'(class|enum|extension|struct|protocol)(\s+)([a-zA-Z_]\w*)',
+             bygroups(Keyword.Declaration, Whitespace, Name.Class)),
+            (r'(func)(\s+)([a-zA-Z_]\w*)',
+             bygroups(Keyword.Declaration, Whitespace, Name.Function)),
+            (r'(var|let)(\s+)([a-zA-Z_]\w*)', bygroups(Keyword.Declaration,
+             Whitespace, Name.Variable)),
+            (words((
+                'actor', 'associatedtype', 'class', 'deinit', 'enum', 'extension', 'func', 'import',
+                'init', 'internal', 'let', 'operator', 'private', 'protocol', 'public',
+                'static', 'struct', 'subscript', 'typealias', 'var'), suffix=r'\b'),
+             Keyword.Declaration)
+        ],
+        'comment': [
+            (r':param: [a-zA-Z_]\w*|:returns?:|(FIXME|MARK|TODO):',
+             Comment.Special)
+        ],
+
+        # Nested
+        'comment-single': [
+            (r'\n', Whitespace, '#pop'),
+            include('comment'),
+            (r'[^\n]+', Comment.Single)
+        ],
+        'comment-multi': [
+            include('comment'),
+            (r'[^*/]+', Comment.Multiline),
+            (r'/\*', Comment.Multiline, '#push'),
+            (r'\*/', Comment.Multiline, '#pop'),
+            (r'[*/]+', Comment.Multiline)
+        ],
+        'module': [
+            (r'\n', Whitespace, '#pop'),
+            (r'[a-zA-Z_]\w*', Name.Class),
+            include('root')
+        ],
+        'preproc': [
+            (r'\n', Whitespace, '#pop'),
+            include('keywords'),
+            (r'[A-Za-z]\w*', Comment.Preproc),
+            include('root')
+        ],
+        'string': [
+            (r'"', String, '#pop'),
+            include("string-common"),
+        ],
+        'string-multi': [
+            (r'"""', String, '#pop'),
+            include("string-common"),
+        ],
+        'string-common': [
+            (r'\\\(', String.Interpol, 'string-intp'),
+            (r"""\\['"\\nrt]|\\x[0-9a-fA-F]{2}|\\[0-7]{1,3}"""
+             r"""|\\u[0-9a-fA-F]{4}|\\U[0-9a-fA-F]{8}""", String.Escape),
+            (r'[^\\"]+', String),
+            (r'\\', String)
+        ],
+        'string-intp': [
+            (r'\(', String.Interpol, '#push'),
+            (r'\)', String.Interpol, '#pop'),
+            include('root')
+        ]
+    }
+
+    def get_tokens_unprocessed(self, text):
+        from pygments.lexers._cocoa_builtins import COCOA_INTERFACES, \
+            COCOA_PROTOCOLS, COCOA_PRIMITIVES
+
+        for index, token, value in \
+                RegexLexer.get_tokens_unprocessed(self, text):
+            if token is Name or token is Name.Class:
+                if value in COCOA_INTERFACES or value in COCOA_PROTOCOLS \
+                   or value in COCOA_PRIMITIVES:
+                    token = Name.Builtin.Pseudo
+
+            yield index, token, value
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/ooc.py b/env/lib/python3.12/site-packages/pygments/lexers/ooc.py
new file mode 100644
index 0000000..8a99080
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/ooc.py
@@ -0,0 +1,84 @@
+"""
+    pygments.lexers.ooc
+    ~~~~~~~~~~~~~~~~~~~
+
+    Lexers for the Ooc language.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups, words
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation
+
+__all__ = ['OocLexer']
+
+
+class OocLexer(RegexLexer):
+    """
+    For Ooc source code
+    """
+    name = 'Ooc'
+    url = 'https://ooc-lang.github.io/'
+    aliases = ['ooc']
+    filenames = ['*.ooc']
+    mimetypes = ['text/x-ooc']
+    version_added = '1.2'
+
+    tokens = {
+        'root': [
+            (words((
+                'class', 'interface', 'implement', 'abstract', 'extends', 'from',
+                'this', 'super', 'new', 'const', 'final', 'static', 'import',
+                'use', 'extern', 'inline', 'proto', 'break', 'continue',
+                'fallthrough', 'operator', 'if', 'else', 'for', 'while', 'do',
+                'switch', 'case', 'as', 'in', 'version', 'return', 'true',
+                'false', 'null'), prefix=r'\b', suffix=r'\b'),
+             Keyword),
+            (r'include\b', Keyword, 'include'),
+            (r'(cover)([ \t]+)(from)([ \t]+)(\w+[*@]?)',
+             bygroups(Keyword, Text, Keyword, Text, Name.Class)),
+            (r'(func)((?:[ \t]|\\\n)+)(~[a-z_]\w*)',
+             bygroups(Keyword, Text, Name.Function)),
+            (r'\bfunc\b', Keyword),
+            # Note: %= not listed on https://ooc-lang.github.io/docs/lang/operators/
+            (r'//.*', Comment),
+            (r'(?s)/\*.*?\*/', Comment.Multiline),
+            (r'(==?|\+=?|-[=>]?|\*=?|/=?|:=|!=?|%=?|\?|>{1,3}=?|<{1,3}=?|\.\.|'
+             r'&&?|\|\|?|\^=?)', Operator),
+            (r'(\.)([ \t]*)([a-z]\w*)', bygroups(Operator, Text,
+                                                 Name.Function)),
+            (r'[A-Z][A-Z0-9_]+', Name.Constant),
+            (r'[A-Z]\w*([@*]|\[[ \t]*\])?', Name.Class),
+
+            (r'([a-z]\w*(?:~[a-z]\w*)?)((?:[ \t]|\\\n)*)(?=\()',
+             bygroups(Name.Function, Text)),
+            (r'[a-z]\w*', Name.Variable),
+
+            # : introduces types
+            (r'[:(){}\[\];,]', Punctuation),
+
+            (r'0x[0-9a-fA-F]+', Number.Hex),
+            (r'0c[0-9]+', Number.Oct),
+            (r'0b[01]+', Number.Bin),
+            (r'[0-9_]\.[0-9_]*(?!\.)', Number.Float),
+            (r'[0-9_]+', Number.Decimal),
+
+            (r'"(?:\\.|\\[0-7]{1,3}|\\x[a-fA-F0-9]{1,2}|[^\\"])*"',
+             String.Double),
+            (r"'(?:\\.|\\[0-9]{1,3}|\\x[a-fA-F0-9]{1,2}|[^\\\'\n])'",
+             String.Char),
+            (r'@', Punctuation),  # pointer dereference
+            (r'\.', Punctuation),  # imports or chain operator
+
+            (r'\\[ \t\n]', Text),
+            (r'[ \t]+', Text),
+        ],
+        'include': [
+            (r'[\w/]+', Name),
+            (r',', Punctuation),
+            (r'[ \t]', Text),
+            (r'[;\n]', Text, '#pop'),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/openscad.py b/env/lib/python3.12/site-packages/pygments/lexers/openscad.py
new file mode 100644
index 0000000..b06de22
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/openscad.py
@@ -0,0 +1,96 @@
+"""
+    pygments.lexers.openscad
+    ~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for the OpenSCAD languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups, words, include
+from pygments.token import Text, Comment, Punctuation, Operator, Keyword, Name, Number, Whitespace, Literal, String
+
+__all__ = ['OpenScadLexer']
+
+
+class OpenScadLexer(RegexLexer):
+    """For openSCAD code.
+    """
+    name = "OpenSCAD"
+    url = "https://openscad.org/"
+    aliases = ["openscad"]
+    filenames = ["*.scad"]
+    mimetypes = ["application/x-openscad"]
+    version_added = '2.16'
+
+    tokens = {
+        "root": [
+            (r"[^\S\n]+", Whitespace),
+            (r'//', Comment.Single, 'comment-single'),
+            (r'/\*', Comment.Multiline, 'comment-multi'),
+            (r"[{}\[\]\(\),;:]", Punctuation),
+            (r"[*!#%\-+=?/]", Operator),
+            (r"<=|<|==|!=|>=|>|&&|\|\|", Operator),
+            (r"\$(f[asn]|t|vp[rtd]|children)", Operator),
+            (r"(undef|PI)\b", Keyword.Constant),
+            (
+                r"(use|include)((?:\s|\\\\s)+)",
+                bygroups(Keyword.Namespace, Text),
+                "includes",
+            ),
+            (r"(module)(\s*)([^\s\(]+)",
+             bygroups(Keyword.Namespace, Whitespace, Name.Namespace)),
+            (r"(function)(\s*)([^\s\(]+)",
+             bygroups(Keyword.Declaration, Whitespace, Name.Function)),
+            (words(("true", "false"), prefix=r"\b", suffix=r"\b"), Literal),
+            (words((
+                "function", "module", "include", "use", "for",
+                "intersection_for", "if", "else", "return"
+                ), prefix=r"\b", suffix=r"\b"), Keyword
+            ),
+            (words((
+                "circle", "square", "polygon", "text", "sphere", "cube",
+                "cylinder", "polyhedron", "translate", "rotate", "scale",
+                "resize", "mirror", "multmatrix", "color", "offset", "hull",
+                "minkowski", "union", "difference", "intersection", "abs",
+                "sign", "sin", "cos", "tan", "acos", "asin", "atan", "atan2",
+                "floor", "round", "ceil", "ln", "log", "pow", "sqrt", "exp",
+                "rands", "min", "max", "concat", "lookup", "str", "chr",
+                "search", "version", "version_num", "norm", "cross",
+                "parent_module", "echo", "import", "import_dxf",
+                "dxf_linear_extrude", "linear_extrude", "rotate_extrude",
+                "surface", "projection", "render", "dxf_cross",
+                "dxf_dim", "let", "assign", "len"
+                ), prefix=r"\b", suffix=r"\b"),
+                Name.Builtin
+            ),
+            (r"\bchildren\b", Name.Builtin.Pseudo),
+            (r'""".*?"""', String.Double),
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String.Double),
+            (r"-?\d+(\.\d+)?(e[+-]?\d+)?", Number),
+            (r"\w+", Name),
+        ],
+        "includes": [
+            (
+                r"(<)([^>]*)(>)",
+                bygroups(Punctuation, Comment.PreprocFile, Punctuation),
+            ),
+        ],
+        'comment': [
+            (r':param: [a-zA-Z_]\w*|:returns?:|(FIXME|MARK|TODO):',
+             Comment.Special)
+        ],
+        'comment-single': [
+            (r'\n', Text, '#pop'),
+            include('comment'),
+            (r'[^\n]+', Comment.Single)
+        ],
+        'comment-multi': [
+            include('comment'),
+            (r'[^*/]+', Comment.Multiline),
+            (r'/\*', Comment.Multiline, '#push'),
+            (r'\*/', Comment.Multiline, '#pop'),
+            (r'[*/]', Comment.Multiline)
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/other.py b/env/lib/python3.12/site-packages/pygments/lexers/other.py
new file mode 100644
index 0000000..2b7dfb4
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/other.py
@@ -0,0 +1,41 @@
+"""
+    pygments.lexers.other
+    ~~~~~~~~~~~~~~~~~~~~~
+
+    Just export lexer classes previously contained in this module.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+# ruff: noqa: F401
+from pygments.lexers.sql import SqlLexer, MySqlLexer, SqliteConsoleLexer
+from pygments.lexers.shell import BashLexer, BashSessionLexer, BatchLexer, \
+    TcshLexer
+from pygments.lexers.robotframework import RobotFrameworkLexer
+from pygments.lexers.testing import GherkinLexer
+from pygments.lexers.esoteric import BrainfuckLexer, BefungeLexer, RedcodeLexer
+from pygments.lexers.prolog import LogtalkLexer
+from pygments.lexers.snobol import SnobolLexer
+from pygments.lexers.rebol import RebolLexer
+from pygments.lexers.configs import KconfigLexer, Cfengine3Lexer
+from pygments.lexers.modeling import ModelicaLexer
+from pygments.lexers.scripting import AppleScriptLexer, MOOCodeLexer, \
+    HybrisLexer
+from pygments.lexers.graphics import PostScriptLexer, GnuplotLexer, \
+    AsymptoteLexer, PovrayLexer
+from pygments.lexers.business import ABAPLexer, OpenEdgeLexer, \
+    GoodDataCLLexer, MaqlLexer
+from pygments.lexers.automation import AutoItLexer, AutohotkeyLexer
+from pygments.lexers.dsls import ProtoBufLexer, BroLexer, PuppetLexer, \
+    MscgenLexer, VGLLexer
+from pygments.lexers.basic import CbmBasicV2Lexer
+from pygments.lexers.pawn import SourcePawnLexer, PawnLexer
+from pygments.lexers.ecl import ECLLexer
+from pygments.lexers.urbi import UrbiscriptLexer
+from pygments.lexers.smalltalk import SmalltalkLexer, NewspeakLexer
+from pygments.lexers.installers import NSISLexer, RPMSpecLexer
+from pygments.lexers.textedit import AwkLexer
+from pygments.lexers.smv import NuSMVLexer
+
+__all__ = []
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/parasail.py b/env/lib/python3.12/site-packages/pygments/lexers/parasail.py
new file mode 100644
index 0000000..150d6a9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/parasail.py
@@ -0,0 +1,78 @@
+"""
+    pygments.lexers.parasail
+    ~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for ParaSail.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, include
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Literal
+
+__all__ = ['ParaSailLexer']
+
+
+class ParaSailLexer(RegexLexer):
+    """
+    For ParaSail source code.
+    """
+
+    name = 'ParaSail'
+    url = 'http://www.parasail-lang.org'
+    aliases = ['parasail']
+    filenames = ['*.psi', '*.psl']
+    mimetypes = ['text/x-parasail']
+    version_added = '2.1'
+
+    flags = re.MULTILINE
+
+    tokens = {
+        'root': [
+            (r'[^\S\n]+', Text),
+            (r'//.*?\n', Comment.Single),
+            (r'\b(and|or|xor)=', Operator.Word),
+            (r'\b(and(\s+then)?|or(\s+else)?|xor|rem|mod|'
+             r'(is|not)\s+null)\b',
+             Operator.Word),
+            # Keywords
+            (r'\b(abs|abstract|all|block|class|concurrent|const|continue|'
+             r'each|end|exit|extends|exports|forward|func|global|implements|'
+             r'import|in|interface|is|lambda|locked|new|not|null|of|op|'
+             r'optional|private|queued|ref|return|reverse|separate|some|'
+             r'type|until|var|with|'
+             # Control flow
+             r'if|then|else|elsif|case|for|while|loop)\b',
+             Keyword.Reserved),
+            (r'(abstract\s+)?(interface|class|op|func|type)',
+             Keyword.Declaration),
+            # Literals
+            (r'"[^"]*"', String),
+            (r'\\[\'ntrf"0]', String.Escape),
+            (r'#[a-zA-Z]\w*', Literal),       # Enumeration
+            include('numbers'),
+            (r"'[^']'", String.Char),
+            (r'[a-zA-Z]\w*', Name),
+            # Operators and Punctuation
+            (r'(<==|==>|<=>|\*\*=|<\|=|<<=|>>=|==|!=|=\?|<=|>=|'
+             r'\*\*|<<|>>|=>|:=|\+=|-=|\*=|\|=|\||/=|\+|-|\*|/|'
+             r'\.\.|<\.\.|\.\.<|<\.\.<)',
+             Operator),
+            (r'(<|>|\[|\]|\(|\)|\||:|;|,|.|\{|\}|->)',
+             Punctuation),
+            (r'\n+', Text),
+        ],
+        'numbers': [
+            (r'\d[0-9_]*#[0-9a-fA-F][0-9a-fA-F_]*#', Number.Hex),  # any base
+            (r'0[xX][0-9a-fA-F][0-9a-fA-F_]*', Number.Hex),        # C-like hex
+            (r'0[bB][01][01_]*', Number.Bin),                      # C-like bin
+            (r'\d[0-9_]*\.\d[0-9_]*[eE][+-]\d[0-9_]*',             # float exp
+             Number.Float),
+            (r'\d[0-9_]*\.\d[0-9_]*', Number.Float),               # float
+            (r'\d[0-9_]*', Number.Integer),                        # integer
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/parsers.py b/env/lib/python3.12/site-packages/pygments/lexers/parsers.py
new file mode 100644
index 0000000..7a4ed9d
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/parsers.py
@@ -0,0 +1,798 @@
+"""
+    pygments.lexers.parsers
+    ~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for parser generators.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, DelegatingLexer, \
+    include, bygroups, using
+from pygments.token import Punctuation, Other, Text, Comment, Operator, \
+    Keyword, Name, String, Number, Whitespace
+from pygments.lexers.jvm import JavaLexer
+from pygments.lexers.c_cpp import CLexer, CppLexer
+from pygments.lexers.objective import ObjectiveCLexer
+from pygments.lexers.d import DLexer
+from pygments.lexers.dotnet import CSharpLexer
+from pygments.lexers.ruby import RubyLexer
+from pygments.lexers.python import PythonLexer
+from pygments.lexers.perl import PerlLexer
+
+__all__ = ['RagelLexer', 'RagelEmbeddedLexer', 'RagelCLexer', 'RagelDLexer',
+           'RagelCppLexer', 'RagelObjectiveCLexer', 'RagelRubyLexer',
+           'RagelJavaLexer', 'AntlrLexer', 'AntlrPythonLexer',
+           'AntlrPerlLexer', 'AntlrRubyLexer', 'AntlrCppLexer',
+           'AntlrCSharpLexer', 'AntlrObjectiveCLexer',
+           'AntlrJavaLexer', 'AntlrActionScriptLexer',
+           'TreetopLexer', 'EbnfLexer']
+
+
+class RagelLexer(RegexLexer):
+    """A pure `Ragel `_ lexer.  Use this
+    for fragments of Ragel.  For ``.rl`` files, use
+    :class:`RagelEmbeddedLexer` instead (or one of the
+    language-specific subclasses).
+
+    """
+
+    name = 'Ragel'
+    url = 'http://www.colm.net/open-source/ragel/'
+    aliases = ['ragel']
+    filenames = []
+    version_added = '1.1'
+
+    tokens = {
+        'whitespace': [
+            (r'\s+', Whitespace)
+        ],
+        'comments': [
+            (r'\#.*$', Comment),
+        ],
+        'keywords': [
+            (r'(access|action|alphtype)\b', Keyword),
+            (r'(getkey|write|machine|include)\b', Keyword),
+            (r'(any|ascii|extend|alpha|digit|alnum|lower|upper)\b', Keyword),
+            (r'(xdigit|cntrl|graph|print|punct|space|zlen|empty)\b', Keyword)
+        ],
+        'numbers': [
+            (r'0x[0-9A-Fa-f]+', Number.Hex),
+            (r'[+-]?[0-9]+', Number.Integer),
+        ],
+        'literals': [
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String.Double),
+            (r"'(\\\\|\\[^\\]|[^'\\])*'", String.Single),
+            (r'\[(\\\\|\\[^\\]|[^\\\]])*\]', String),          # square bracket literals
+            (r'/(?!\*)(\\\\|\\[^\\]|[^/\\])*/', String.Regex),  # regular expressions
+        ],
+        'identifiers': [
+            (r'[a-zA-Z_]\w*', Name.Variable),
+        ],
+        'operators': [
+            (r',', Operator),                           # Join
+            (r'\||&|--?', Operator),                    # Union, Intersection and Subtraction
+            (r'\.|<:|:>>?', Operator),                  # Concatention
+            (r':', Operator),                           # Label
+            (r'->', Operator),                          # Epsilon Transition
+            (r'(>|\$|%|<|@|<>)(/|eof\b)', Operator),    # EOF Actions
+            (r'(>|\$|%|<|@|<>)(!|err\b)', Operator),    # Global Error Actions
+            (r'(>|\$|%|<|@|<>)(\^|lerr\b)', Operator),  # Local Error Actions
+            (r'(>|\$|%|<|@|<>)(~|to\b)', Operator),     # To-State Actions
+            (r'(>|\$|%|<|@|<>)(\*|from\b)', Operator),  # From-State Actions
+            (r'>|@|\$|%', Operator),                    # Transition Actions and Priorities
+            (r'\*|\?|\+|\{[0-9]*,[0-9]*\}', Operator),  # Repetition
+            (r'!|\^', Operator),                        # Negation
+            (r'\(|\)', Operator),                       # Grouping
+        ],
+        'root': [
+            include('literals'),
+            include('whitespace'),
+            include('comments'),
+            include('keywords'),
+            include('numbers'),
+            include('identifiers'),
+            include('operators'),
+            (r'\{', Punctuation, 'host'),
+            (r'=', Operator),
+            (r';', Punctuation),
+        ],
+        'host': [
+            (r'(' + r'|'.join((  # keep host code in largest possible chunks
+                r'[^{}\'"/#]+',  # exclude unsafe characters
+                r'[^\\]\\[{}]',  # allow escaped { or }
+
+                # strings and comments may safely contain unsafe characters
+                r'"(\\\\|\\[^\\]|[^"\\])*"',
+                r"'(\\\\|\\[^\\]|[^'\\])*'",
+                r'//.*$\n?',            # single line comment
+                r'/\*(.|\n)*?\*/',      # multi-line javadoc-style comment
+                r'\#.*$\n?',            # ruby comment
+
+                # regular expression: There's no reason for it to start
+                # with a * and this stops confusion with comments.
+                r'/(?!\*)(\\\\|\\[^\\]|[^/\\])*/',
+
+                # / is safe now that we've handled regex and javadoc comments
+                r'/',
+            )) + r')+', Other),
+
+            (r'\{', Punctuation, '#push'),
+            (r'\}', Punctuation, '#pop'),
+        ],
+    }
+
+
+class RagelEmbeddedLexer(RegexLexer):
+    """
+    A lexer for Ragel embedded in a host language file.
+
+    This will only highlight Ragel statements. If you want host language
+    highlighting then call the language-specific Ragel lexer.
+    """
+
+    name = 'Embedded Ragel'
+    aliases = ['ragel-em']
+    filenames = ['*.rl']
+    url = 'http://www.colm.net/open-source/ragel/'
+    version_added = '1.1'
+
+    tokens = {
+        'root': [
+            (r'(' + r'|'.join((   # keep host code in largest possible chunks
+                r'[^%\'"/#]+',    # exclude unsafe characters
+                r'%(?=[^%]|$)',   # a single % sign is okay, just not 2 of them
+
+                # strings and comments may safely contain unsafe characters
+                r'"(\\\\|\\[^\\]|[^"\\])*"',
+                r"'(\\\\|\\[^\\]|[^'\\])*'",
+                r'/\*(.|\n)*?\*/',      # multi-line javadoc-style comment
+                r'//.*$\n?',  # single line comment
+                r'\#.*$\n?',  # ruby/ragel comment
+                r'/(?!\*)(\\\\|\\[^\\]|[^/\\])*/',  # regular expression
+
+                # / is safe now that we've handled regex and javadoc comments
+                r'/',
+            )) + r')+', Other),
+
+            # Single Line FSM.
+            # Please don't put a quoted newline in a single line FSM.
+            # That's just mean. It will break this.
+            (r'(%%)(?![{%])(.*)($|;)(\n?)', bygroups(Punctuation,
+                                                     using(RagelLexer),
+                                                     Punctuation, Text)),
+
+            # Multi Line FSM.
+            (r'(%%%%|%%)\{', Punctuation, 'multi-line-fsm'),
+        ],
+        'multi-line-fsm': [
+            (r'(' + r'|'.join((  # keep ragel code in largest possible chunks.
+                r'(' + r'|'.join((
+                    r'[^}\'"\[/#]',   # exclude unsafe characters
+                    r'\}(?=[^%]|$)',   # } is okay as long as it's not followed by %
+                    r'\}%(?=[^%]|$)',  # ...well, one %'s okay, just not two...
+                    r'[^\\]\\[{}]',   # ...and } is okay if it's escaped
+
+                    # allow / if it's preceded with one of these symbols
+                    # (ragel EOF actions)
+                    r'(>|\$|%|<|@|<>)/',
+
+                    # specifically allow regex followed immediately by *
+                    # so it doesn't get mistaken for a comment
+                    r'/(?!\*)(\\\\|\\[^\\]|[^/\\])*/\*',
+
+                    # allow / as long as it's not followed by another / or by a *
+                    r'/(?=[^/*]|$)',
+
+                    # We want to match as many of these as we can in one block.
+                    # Not sure if we need the + sign here,
+                    # does it help performance?
+                )) + r')+',
+
+                # strings and comments may safely contain unsafe characters
+                r'"(\\\\|\\[^\\]|[^"\\])*"',
+                r"'(\\\\|\\[^\\]|[^'\\])*'",
+                r"\[(\\\\|\\[^\\]|[^\]\\])*\]",  # square bracket literal
+                r'/\*(.|\n)*?\*/',          # multi-line javadoc-style comment
+                r'//.*$\n?',                # single line comment
+                r'\#.*$\n?',                # ruby/ragel comment
+            )) + r')+', using(RagelLexer)),
+
+            (r'\}%%', Punctuation, '#pop'),
+        ]
+    }
+
+    def analyse_text(text):
+        return '@LANG: indep' in text
+
+
+class RagelRubyLexer(DelegatingLexer):
+    """
+    A lexer for Ragel in a Ruby host file.
+    """
+
+    name = 'Ragel in Ruby Host'
+    aliases = ['ragel-ruby', 'ragel-rb']
+    filenames = ['*.rl']
+    url = 'http://www.colm.net/open-source/ragel/'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(RubyLexer, RagelEmbeddedLexer, **options)
+
+    def analyse_text(text):
+        return '@LANG: ruby' in text
+
+
+class RagelCLexer(DelegatingLexer):
+    """
+    A lexer for Ragel in a C host file.
+    """
+
+    name = 'Ragel in C Host'
+    aliases = ['ragel-c']
+    filenames = ['*.rl']
+    url = 'http://www.colm.net/open-source/ragel/'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(CLexer, RagelEmbeddedLexer, **options)
+
+    def analyse_text(text):
+        return '@LANG: c' in text
+
+
+class RagelDLexer(DelegatingLexer):
+    """
+    A lexer for Ragel in a D host file.
+    """
+
+    name = 'Ragel in D Host'
+    aliases = ['ragel-d']
+    filenames = ['*.rl']
+    url = 'http://www.colm.net/open-source/ragel/'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(DLexer, RagelEmbeddedLexer, **options)
+
+    def analyse_text(text):
+        return '@LANG: d' in text
+
+
+class RagelCppLexer(DelegatingLexer):
+    """
+    A lexer for Ragel in a C++ host file.
+    """
+
+    name = 'Ragel in CPP Host'
+    aliases = ['ragel-cpp']
+    filenames = ['*.rl']
+    url = 'http://www.colm.net/open-source/ragel/'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(CppLexer, RagelEmbeddedLexer, **options)
+
+    def analyse_text(text):
+        return '@LANG: c++' in text
+
+
+class RagelObjectiveCLexer(DelegatingLexer):
+    """
+    A lexer for Ragel in an Objective C host file.
+    """
+
+    name = 'Ragel in Objective C Host'
+    aliases = ['ragel-objc']
+    filenames = ['*.rl']
+    url = 'http://www.colm.net/open-source/ragel/'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(ObjectiveCLexer, RagelEmbeddedLexer, **options)
+
+    def analyse_text(text):
+        return '@LANG: objc' in text
+
+
+class RagelJavaLexer(DelegatingLexer):
+    """
+    A lexer for Ragel in a Java host file.
+    """
+
+    name = 'Ragel in Java Host'
+    aliases = ['ragel-java']
+    filenames = ['*.rl']
+    url = 'http://www.colm.net/open-source/ragel/'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(JavaLexer, RagelEmbeddedLexer, **options)
+
+    def analyse_text(text):
+        return '@LANG: java' in text
+
+
+class AntlrLexer(RegexLexer):
+    """
+    Generic ANTLR Lexer.
+    Should not be called directly, instead
+    use DelegatingLexer for your target language.
+    """
+
+    name = 'ANTLR'
+    aliases = ['antlr']
+    filenames = []
+    url = 'https://www.antlr.org'
+    version_added = '1.1'
+
+    _id = r'[A-Za-z]\w*'
+    _TOKEN_REF = r'[A-Z]\w*'
+    _RULE_REF = r'[a-z]\w*'
+    _STRING_LITERAL = r'\'(?:\\\\|\\\'|[^\']*)\''
+    _INT = r'[0-9]+'
+
+    tokens = {
+        'whitespace': [
+            (r'\s+', Whitespace),
+        ],
+        'comments': [
+            (r'//.*$', Comment),
+            (r'/\*(.|\n)*?\*/', Comment),
+        ],
+        'root': [
+            include('whitespace'),
+            include('comments'),
+
+            (r'(lexer|parser|tree)?(\s*)(grammar\b)(\s*)(' + _id + ')(;)',
+             bygroups(Keyword, Whitespace, Keyword, Whitespace, Name.Class,
+                      Punctuation)),
+            # optionsSpec
+            (r'options\b', Keyword, 'options'),
+            # tokensSpec
+            (r'tokens\b', Keyword, 'tokens'),
+            # attrScope
+            (r'(scope)(\s*)(' + _id + r')(\s*)(\{)',
+             bygroups(Keyword, Whitespace, Name.Variable, Whitespace,
+                      Punctuation), 'action'),
+            # exception
+            (r'(catch|finally)\b', Keyword, 'exception'),
+            # action
+            (r'(@' + _id + r')(\s*)(::)?(\s*)(' + _id + r')(\s*)(\{)',
+             bygroups(Name.Label, Whitespace, Punctuation, Whitespace,
+                      Name.Label, Whitespace, Punctuation), 'action'),
+            # rule
+            (r'((?:protected|private|public|fragment)\b)?(\s*)(' + _id + ')(!)?',
+             bygroups(Keyword, Whitespace, Name.Label, Punctuation),
+             ('rule-alts', 'rule-prelims')),
+        ],
+        'exception': [
+            (r'\n', Whitespace, '#pop'),
+            (r'\s', Whitespace),
+            include('comments'),
+
+            (r'\[', Punctuation, 'nested-arg-action'),
+            (r'\{', Punctuation, 'action'),
+        ],
+        'rule-prelims': [
+            include('whitespace'),
+            include('comments'),
+
+            (r'returns\b', Keyword),
+            (r'\[', Punctuation, 'nested-arg-action'),
+            (r'\{', Punctuation, 'action'),
+            # throwsSpec
+            (r'(throws)(\s+)(' + _id + ')',
+             bygroups(Keyword, Whitespace, Name.Label)),
+            (r'(,)(\s*)(' + _id + ')',
+             bygroups(Punctuation, Whitespace, Name.Label)),  # Additional throws
+            # optionsSpec
+            (r'options\b', Keyword, 'options'),
+            # ruleScopeSpec - scope followed by target language code or name of action
+            # TODO finish implementing other possibilities for scope
+            # L173 ANTLRv3.g from ANTLR book
+            (r'(scope)(\s+)(\{)', bygroups(Keyword, Whitespace, Punctuation),
+             'action'),
+            (r'(scope)(\s+)(' + _id + r')(\s*)(;)',
+             bygroups(Keyword, Whitespace, Name.Label, Whitespace, Punctuation)),
+            # ruleAction
+            (r'(@' + _id + r')(\s*)(\{)',
+             bygroups(Name.Label, Whitespace, Punctuation), 'action'),
+            # finished prelims, go to rule alts!
+            (r':', Punctuation, '#pop')
+        ],
+        'rule-alts': [
+            include('whitespace'),
+            include('comments'),
+
+            # These might need to go in a separate 'block' state triggered by (
+            (r'options\b', Keyword, 'options'),
+            (r':', Punctuation),
+
+            # literals
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String.Double),
+            (r"'(\\\\|\\[^\\]|[^'\\])*'", String.Single),
+            (r'<<([^>]|>[^>])>>', String),
+            # identifiers
+            # Tokens start with capital letter.
+            (r'\$?[A-Z_]\w*', Name.Constant),
+            # Rules start with small letter.
+            (r'\$?[a-z_]\w*', Name.Variable),
+            # operators
+            (r'(\+|\||->|=>|=|\(|\)|\.\.|\.|\?|\*|\^|!|\#|~)', Operator),
+            (r',', Punctuation),
+            (r'\[', Punctuation, 'nested-arg-action'),
+            (r'\{', Punctuation, 'action'),
+            (r';', Punctuation, '#pop')
+        ],
+        'tokens': [
+            include('whitespace'),
+            include('comments'),
+            (r'\{', Punctuation),
+            (r'(' + _TOKEN_REF + r')(\s*)(=)?(\s*)(' + _STRING_LITERAL
+             + r')?(\s*)(;)',
+             bygroups(Name.Label, Whitespace, Punctuation, Whitespace,
+                      String, Whitespace, Punctuation)),
+            (r'\}', Punctuation, '#pop'),
+        ],
+        'options': [
+            include('whitespace'),
+            include('comments'),
+            (r'\{', Punctuation),
+            (r'(' + _id + r')(\s*)(=)(\s*)(' +
+             '|'.join((_id, _STRING_LITERAL, _INT, r'\*')) + r')(\s*)(;)',
+             bygroups(Name.Variable, Whitespace, Punctuation, Whitespace,
+                      Text, Whitespace, Punctuation)),
+            (r'\}', Punctuation, '#pop'),
+        ],
+        'action': [
+            (r'(' + r'|'.join((    # keep host code in largest possible chunks
+                r'[^${}\'"/\\]+',  # exclude unsafe characters
+
+                # strings and comments may safely contain unsafe characters
+                r'"(\\\\|\\[^\\]|[^"\\])*"',
+                r"'(\\\\|\\[^\\]|[^'\\])*'",
+                r'//.*$\n?',            # single line comment
+                r'/\*(.|\n)*?\*/',      # multi-line javadoc-style comment
+
+                # regular expression: There's no reason for it to start
+                # with a * and this stops confusion with comments.
+                r'/(?!\*)(\\\\|\\[^\\]|[^/\\])*/',
+
+                # backslashes are okay, as long as we are not backslashing a %
+                r'\\(?!%)',
+
+                # Now that we've handled regex and javadoc comments
+                # it's safe to let / through.
+                r'/',
+            )) + r')+', Other),
+            (r'(\\)(%)', bygroups(Punctuation, Other)),
+            (r'(\$[a-zA-Z]+)(\.?)(text|value)?',
+             bygroups(Name.Variable, Punctuation, Name.Property)),
+            (r'\{', Punctuation, '#push'),
+            (r'\}', Punctuation, '#pop'),
+        ],
+        'nested-arg-action': [
+            (r'(' + r'|'.join((    # keep host code in largest possible chunks.
+                r'[^$\[\]\'"/]+',  # exclude unsafe characters
+
+                # strings and comments may safely contain unsafe characters
+                r'"(\\\\|\\[^\\]|[^"\\])*"',
+                r"'(\\\\|\\[^\\]|[^'\\])*'",
+                r'//.*$\n?',            # single line comment
+                r'/\*(.|\n)*?\*/',      # multi-line javadoc-style comment
+
+                # regular expression: There's no reason for it to start
+                # with a * and this stops confusion with comments.
+                r'/(?!\*)(\\\\|\\[^\\]|[^/\\])*/',
+
+                # Now that we've handled regex and javadoc comments
+                # it's safe to let / through.
+                r'/',
+            )) + r')+', Other),
+
+
+            (r'\[', Punctuation, '#push'),
+            (r'\]', Punctuation, '#pop'),
+            (r'(\$[a-zA-Z]+)(\.?)(text|value)?',
+             bygroups(Name.Variable, Punctuation, Name.Property)),
+            (r'(\\\\|\\\]|\\\[|[^\[\]])+', Other),
+        ]
+    }
+
+    def analyse_text(text):
+        return re.search(r'^\s*grammar\s+[a-zA-Z0-9]+\s*;', text, re.M)
+
+
+# http://www.antlr.org/wiki/display/ANTLR3/Code+Generation+Targets
+
+class AntlrCppLexer(DelegatingLexer):
+    """
+    ANTLR with C++ Target
+    """
+
+    name = 'ANTLR With CPP Target'
+    aliases = ['antlr-cpp']
+    filenames = ['*.G', '*.g']
+    url = 'https://www.antlr.org'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(CppLexer, AntlrLexer, **options)
+
+    def analyse_text(text):
+        return AntlrLexer.analyse_text(text) and \
+            re.search(r'^\s*language\s*=\s*C\s*;', text, re.M)
+
+
+class AntlrObjectiveCLexer(DelegatingLexer):
+    """
+    ANTLR with Objective-C Target
+    """
+
+    name = 'ANTLR With ObjectiveC Target'
+    aliases = ['antlr-objc']
+    filenames = ['*.G', '*.g']
+    url = 'https://www.antlr.org'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(ObjectiveCLexer, AntlrLexer, **options)
+
+    def analyse_text(text):
+        return AntlrLexer.analyse_text(text) and \
+            re.search(r'^\s*language\s*=\s*ObjC\s*;', text)
+
+
+class AntlrCSharpLexer(DelegatingLexer):
+    """
+    ANTLR with C# Target
+    """
+
+    name = 'ANTLR With C# Target'
+    aliases = ['antlr-csharp', 'antlr-c#']
+    filenames = ['*.G', '*.g']
+    url = 'https://www.antlr.org'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(CSharpLexer, AntlrLexer, **options)
+
+    def analyse_text(text):
+        return AntlrLexer.analyse_text(text) and \
+            re.search(r'^\s*language\s*=\s*CSharp2\s*;', text, re.M)
+
+
+class AntlrPythonLexer(DelegatingLexer):
+    """
+    ANTLR with Python Target
+    """
+
+    name = 'ANTLR With Python Target'
+    aliases = ['antlr-python']
+    filenames = ['*.G', '*.g']
+    url = 'https://www.antlr.org'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(PythonLexer, AntlrLexer, **options)
+
+    def analyse_text(text):
+        return AntlrLexer.analyse_text(text) and \
+            re.search(r'^\s*language\s*=\s*Python\s*;', text, re.M)
+
+
+class AntlrJavaLexer(DelegatingLexer):
+    """
+    ANTLR with Java Target
+    """
+
+    name = 'ANTLR With Java Target'
+    aliases = ['antlr-java']
+    filenames = ['*.G', '*.g']
+    url = 'https://www.antlr.org'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(JavaLexer, AntlrLexer, **options)
+
+    def analyse_text(text):
+        # Antlr language is Java by default
+        return AntlrLexer.analyse_text(text) and 0.9
+
+
+class AntlrRubyLexer(DelegatingLexer):
+    """
+    ANTLR with Ruby Target
+    """
+
+    name = 'ANTLR With Ruby Target'
+    aliases = ['antlr-ruby', 'antlr-rb']
+    filenames = ['*.G', '*.g']
+    url = 'https://www.antlr.org'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(RubyLexer, AntlrLexer, **options)
+
+    def analyse_text(text):
+        return AntlrLexer.analyse_text(text) and \
+            re.search(r'^\s*language\s*=\s*Ruby\s*;', text, re.M)
+
+
+class AntlrPerlLexer(DelegatingLexer):
+    """
+    ANTLR with Perl Target
+    """
+
+    name = 'ANTLR With Perl Target'
+    aliases = ['antlr-perl']
+    filenames = ['*.G', '*.g']
+    url = 'https://www.antlr.org'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        super().__init__(PerlLexer, AntlrLexer, **options)
+
+    def analyse_text(text):
+        return AntlrLexer.analyse_text(text) and \
+            re.search(r'^\s*language\s*=\s*Perl5\s*;', text, re.M)
+
+
+class AntlrActionScriptLexer(DelegatingLexer):
+    """
+    ANTLR with ActionScript Target
+    """
+
+    name = 'ANTLR With ActionScript Target'
+    aliases = ['antlr-actionscript', 'antlr-as']
+    filenames = ['*.G', '*.g']
+    url = 'https://www.antlr.org'
+    version_added = '1.1'
+
+    def __init__(self, **options):
+        from pygments.lexers.actionscript import ActionScriptLexer
+        super().__init__(ActionScriptLexer, AntlrLexer, **options)
+
+    def analyse_text(text):
+        return AntlrLexer.analyse_text(text) and \
+            re.search(r'^\s*language\s*=\s*ActionScript\s*;', text, re.M)
+
+
+class TreetopBaseLexer(RegexLexer):
+    """
+    A base lexer for `Treetop `_ grammars.
+    Not for direct use; use :class:`TreetopLexer` instead.
+
+    .. versionadded:: 1.6
+    """
+
+    tokens = {
+        'root': [
+            include('space'),
+            (r'require[ \t]+[^\n\r]+[\n\r]', Other),
+            (r'module\b', Keyword.Namespace, 'module'),
+            (r'grammar\b', Keyword, 'grammar'),
+        ],
+        'module': [
+            include('space'),
+            include('end'),
+            (r'module\b', Keyword, '#push'),
+            (r'grammar\b', Keyword, 'grammar'),
+            (r'[A-Z]\w*(?:::[A-Z]\w*)*', Name.Namespace),
+        ],
+        'grammar': [
+            include('space'),
+            include('end'),
+            (r'rule\b', Keyword, 'rule'),
+            (r'include\b', Keyword, 'include'),
+            (r'[A-Z]\w*', Name),
+        ],
+        'include': [
+            include('space'),
+            (r'[A-Z]\w*(?:::[A-Z]\w*)*', Name.Class, '#pop'),
+        ],
+        'rule': [
+            include('space'),
+            include('end'),
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String.Double),
+            (r"'(\\\\|\\[^\\]|[^'\\])*'", String.Single),
+            (r'([A-Za-z_]\w*)(:)', bygroups(Name.Label, Punctuation)),
+            (r'[A-Za-z_]\w*', Name),
+            (r'[()]', Punctuation),
+            (r'[?+*/&!~]', Operator),
+            (r'\[(?:\\.|\[:\^?[a-z]+:\]|[^\\\]])+\]', String.Regex),
+            (r'([0-9]*)(\.\.)([0-9]*)',
+             bygroups(Number.Integer, Operator, Number.Integer)),
+            (r'(<)([^>]+)(>)', bygroups(Punctuation, Name.Class, Punctuation)),
+            (r'\{', Punctuation, 'inline_module'),
+            (r'\.', String.Regex),
+        ],
+        'inline_module': [
+            (r'\{', Other, 'ruby'),
+            (r'\}', Punctuation, '#pop'),
+            (r'[^{}]+', Other),
+        ],
+        'ruby': [
+            (r'\{', Other, '#push'),
+            (r'\}', Other, '#pop'),
+            (r'[^{}]+', Other),
+        ],
+        'space': [
+            (r'[ \t\n\r]+', Whitespace),
+            (r'#[^\n]*', Comment.Single),
+        ],
+        'end': [
+            (r'end\b', Keyword, '#pop'),
+        ],
+    }
+
+
+class TreetopLexer(DelegatingLexer):
+    """
+    A lexer for Treetop grammars.
+    """
+
+    name = 'Treetop'
+    aliases = ['treetop']
+    filenames = ['*.treetop', '*.tt']
+    url = 'https://cjheath.github.io/treetop'
+    version_added = '1.6'
+
+    def __init__(self, **options):
+        super().__init__(RubyLexer, TreetopBaseLexer, **options)
+
+
+class EbnfLexer(RegexLexer):
+    """
+    Lexer for `ISO/IEC 14977 EBNF
+    `_
+    grammars.
+    """
+
+    name = 'EBNF'
+    aliases = ['ebnf']
+    filenames = ['*.ebnf']
+    mimetypes = ['text/x-ebnf']
+    url = 'https://en.wikipedia.org/wiki/Extended_Backus%E2%80%93Naur_Form'
+    version_added = '2.0'
+
+    tokens = {
+        'root': [
+            include('whitespace'),
+            include('comment_start'),
+            include('identifier'),
+            (r'=', Operator, 'production'),
+        ],
+        'production': [
+            include('whitespace'),
+            include('comment_start'),
+            include('identifier'),
+            (r'"[^"]*"', String.Double),
+            (r"'[^']*'", String.Single),
+            (r'(\?[^?]*\?)', Name.Entity),
+            (r'[\[\]{}(),|]', Punctuation),
+            (r'-', Operator),
+            (r';', Punctuation, '#pop'),
+            (r'\.', Punctuation, '#pop'),
+        ],
+        'whitespace': [
+            (r'\s+', Text),
+        ],
+        'comment_start': [
+            (r'\(\*', Comment.Multiline, 'comment'),
+        ],
+        'comment': [
+            (r'[^*)]', Comment.Multiline),
+            include('comment_start'),
+            (r'\*\)', Comment.Multiline, '#pop'),
+            (r'[*)]', Comment.Multiline),
+        ],
+        'identifier': [
+            (r'([a-zA-Z][\w \-]*)', Keyword),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/pascal.py b/env/lib/python3.12/site-packages/pygments/lexers/pascal.py
new file mode 100644
index 0000000..5f40dcc
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/pascal.py
@@ -0,0 +1,644 @@
+"""
+    pygments.lexers.pascal
+    ~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Pascal family languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import Lexer
+from pygments.util import get_bool_opt, get_list_opt
+from pygments.token import Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Error, Whitespace
+from pygments.scanner import Scanner
+
+# compatibility import
+from pygments.lexers.modula2 import Modula2Lexer # noqa: F401
+
+__all__ = ['DelphiLexer', 'PortugolLexer']
+
+
+class PortugolLexer(Lexer):
+    """For Portugol, a Pascal dialect with keywords in Portuguese."""
+    name = 'Portugol'
+    aliases = ['portugol']
+    filenames = ['*.alg', '*.portugol']
+    mimetypes = []
+    url = "https://www.apoioinformatica.inf.br/produtos/visualg/linguagem"
+    version_added = ''
+
+    def __init__(self, **options):
+        Lexer.__init__(self, **options)
+        self.lexer = DelphiLexer(**options, portugol=True)
+
+    def get_tokens_unprocessed(self, text):
+        return self.lexer.get_tokens_unprocessed(text)
+
+
+class DelphiLexer(Lexer):
+    """
+    For Delphi (Borland Object Pascal),
+    Turbo Pascal and Free Pascal source code.
+
+    Additional options accepted:
+
+    `turbopascal`
+        Highlight Turbo Pascal specific keywords (default: ``True``).
+    `delphi`
+        Highlight Borland Delphi specific keywords (default: ``True``).
+    `freepascal`
+        Highlight Free Pascal specific keywords (default: ``True``).
+    `units`
+        A list of units that should be considered builtin, supported are
+        ``System``, ``SysUtils``, ``Classes`` and ``Math``.
+        Default is to consider all of them builtin.
+    """
+    name = 'Delphi'
+    aliases = ['delphi', 'pas', 'pascal', 'objectpascal']
+    filenames = ['*.pas', '*.dpr']
+    mimetypes = ['text/x-pascal']
+    url = 'https://www.embarcadero.com/products/delphi'
+    version_added = ''
+
+    TURBO_PASCAL_KEYWORDS = (
+        'absolute', 'and', 'array', 'asm', 'begin', 'break', 'case',
+        'const', 'constructor', 'continue', 'destructor', 'div', 'do',
+        'downto', 'else', 'end', 'file', 'for', 'function', 'goto',
+        'if', 'implementation', 'in', 'inherited', 'inline', 'interface',
+        'label', 'mod', 'nil', 'not', 'object', 'of', 'on', 'operator',
+        'or', 'packed', 'procedure', 'program', 'record', 'reintroduce',
+        'repeat', 'self', 'set', 'shl', 'shr', 'string', 'then', 'to',
+        'type', 'unit', 'until', 'uses', 'var', 'while', 'with', 'xor'
+    )
+
+    DELPHI_KEYWORDS = (
+        'as', 'class', 'except', 'exports', 'finalization', 'finally',
+        'initialization', 'is', 'library', 'on', 'property', 'raise',
+        'threadvar', 'try'
+    )
+
+    FREE_PASCAL_KEYWORDS = (
+        'dispose', 'exit', 'false', 'new', 'true'
+    )
+
+    BLOCK_KEYWORDS = {
+        'begin', 'class', 'const', 'constructor', 'destructor', 'end',
+        'finalization', 'function', 'implementation', 'initialization',
+        'label', 'library', 'operator', 'procedure', 'program', 'property',
+        'record', 'threadvar', 'type', 'unit', 'uses', 'var'
+    }
+
+    FUNCTION_MODIFIERS = {
+        'alias', 'cdecl', 'export', 'inline', 'interrupt', 'nostackframe',
+        'pascal', 'register', 'safecall', 'softfloat', 'stdcall',
+        'varargs', 'name', 'dynamic', 'near', 'virtual', 'external',
+        'override', 'assembler'
+    }
+
+    # XXX: those aren't global. but currently we know no way for defining
+    #      them just for the type context.
+    DIRECTIVES = {
+        'absolute', 'abstract', 'assembler', 'cppdecl', 'default', 'far',
+        'far16', 'forward', 'index', 'oldfpccall', 'private', 'protected',
+        'published', 'public'
+    }
+
+    BUILTIN_TYPES = {
+        'ansichar', 'ansistring', 'bool', 'boolean', 'byte', 'bytebool',
+        'cardinal', 'char', 'comp', 'currency', 'double', 'dword',
+        'extended', 'int64', 'integer', 'iunknown', 'longbool', 'longint',
+        'longword', 'pansichar', 'pansistring', 'pbool', 'pboolean',
+        'pbyte', 'pbytearray', 'pcardinal', 'pchar', 'pcomp', 'pcurrency',
+        'pdate', 'pdatetime', 'pdouble', 'pdword', 'pextended', 'phandle',
+        'pint64', 'pinteger', 'plongint', 'plongword', 'pointer',
+        'ppointer', 'pshortint', 'pshortstring', 'psingle', 'psmallint',
+        'pstring', 'pvariant', 'pwidechar', 'pwidestring', 'pword',
+        'pwordarray', 'pwordbool', 'real', 'real48', 'shortint',
+        'shortstring', 'single', 'smallint', 'string', 'tclass', 'tdate',
+        'tdatetime', 'textfile', 'thandle', 'tobject', 'ttime', 'variant',
+        'widechar', 'widestring', 'word', 'wordbool'
+    }
+
+    BUILTIN_UNITS = {
+        'System': (
+            'abs', 'acquireexceptionobject', 'addr', 'ansitoutf8',
+            'append', 'arctan', 'assert', 'assigned', 'assignfile',
+            'beginthread', 'blockread', 'blockwrite', 'break', 'chdir',
+            'chr', 'close', 'closefile', 'comptocurrency', 'comptodouble',
+            'concat', 'continue', 'copy', 'cos', 'dec', 'delete',
+            'dispose', 'doubletocomp', 'endthread', 'enummodules',
+            'enumresourcemodules', 'eof', 'eoln', 'erase', 'exceptaddr',
+            'exceptobject', 'exclude', 'exit', 'exp', 'filepos', 'filesize',
+            'fillchar', 'finalize', 'findclasshinstance', 'findhinstance',
+            'findresourcehinstance', 'flush', 'frac', 'freemem',
+            'get8087cw', 'getdir', 'getlasterror', 'getmem',
+            'getmemorymanager', 'getmodulefilename', 'getvariantmanager',
+            'halt', 'hi', 'high', 'inc', 'include', 'initialize', 'insert',
+            'int', 'ioresult', 'ismemorymanagerset', 'isvariantmanagerset',
+            'length', 'ln', 'lo', 'low', 'mkdir', 'move', 'new', 'odd',
+            'olestrtostring', 'olestrtostrvar', 'ord', 'paramcount',
+            'paramstr', 'pi', 'pos', 'pred', 'ptr', 'pucs4chars', 'random',
+            'randomize', 'read', 'readln', 'reallocmem',
+            'releaseexceptionobject', 'rename', 'reset', 'rewrite', 'rmdir',
+            'round', 'runerror', 'seek', 'seekeof', 'seekeoln',
+            'set8087cw', 'setlength', 'setlinebreakstyle',
+            'setmemorymanager', 'setstring', 'settextbuf',
+            'setvariantmanager', 'sin', 'sizeof', 'slice', 'sqr', 'sqrt',
+            'str', 'stringofchar', 'stringtoolestr', 'stringtowidechar',
+            'succ', 'swap', 'trunc', 'truncate', 'typeinfo',
+            'ucs4stringtowidestring', 'unicodetoutf8', 'uniquestring',
+            'upcase', 'utf8decode', 'utf8encode', 'utf8toansi',
+            'utf8tounicode', 'val', 'vararrayredim', 'varclear',
+            'widecharlentostring', 'widecharlentostrvar',
+            'widechartostring', 'widechartostrvar',
+            'widestringtoucs4string', 'write', 'writeln'
+        ),
+        'SysUtils': (
+            'abort', 'addexitproc', 'addterminateproc', 'adjustlinebreaks',
+            'allocmem', 'ansicomparefilename', 'ansicomparestr',
+            'ansicomparetext', 'ansidequotedstr', 'ansiextractquotedstr',
+            'ansilastchar', 'ansilowercase', 'ansilowercasefilename',
+            'ansipos', 'ansiquotedstr', 'ansisamestr', 'ansisametext',
+            'ansistrcomp', 'ansistricomp', 'ansistrlastchar', 'ansistrlcomp',
+            'ansistrlicomp', 'ansistrlower', 'ansistrpos', 'ansistrrscan',
+            'ansistrscan', 'ansistrupper', 'ansiuppercase',
+            'ansiuppercasefilename', 'appendstr', 'assignstr', 'beep',
+            'booltostr', 'bytetocharindex', 'bytetocharlen', 'bytetype',
+            'callterminateprocs', 'changefileext', 'charlength',
+            'chartobyteindex', 'chartobytelen', 'comparemem', 'comparestr',
+            'comparetext', 'createdir', 'createguid', 'currentyear',
+            'currtostr', 'currtostrf', 'date', 'datetimetofiledate',
+            'datetimetostr', 'datetimetostring', 'datetimetosystemtime',
+            'datetimetotimestamp', 'datetostr', 'dayofweek', 'decodedate',
+            'decodedatefully', 'decodetime', 'deletefile', 'directoryexists',
+            'diskfree', 'disksize', 'disposestr', 'encodedate', 'encodetime',
+            'exceptionerrormessage', 'excludetrailingbackslash',
+            'excludetrailingpathdelimiter', 'expandfilename',
+            'expandfilenamecase', 'expanduncfilename', 'extractfiledir',
+            'extractfiledrive', 'extractfileext', 'extractfilename',
+            'extractfilepath', 'extractrelativepath', 'extractshortpathname',
+            'fileage', 'fileclose', 'filecreate', 'filedatetodatetime',
+            'fileexists', 'filegetattr', 'filegetdate', 'fileisreadonly',
+            'fileopen', 'fileread', 'filesearch', 'fileseek', 'filesetattr',
+            'filesetdate', 'filesetreadonly', 'filewrite', 'finalizepackage',
+            'findclose', 'findcmdlineswitch', 'findfirst', 'findnext',
+            'floattocurr', 'floattodatetime', 'floattodecimal', 'floattostr',
+            'floattostrf', 'floattotext', 'floattotextfmt', 'fmtloadstr',
+            'fmtstr', 'forcedirectories', 'format', 'formatbuf', 'formatcurr',
+            'formatdatetime', 'formatfloat', 'freeandnil', 'getcurrentdir',
+            'getenvironmentvariable', 'getfileversion', 'getformatsettings',
+            'getlocaleformatsettings', 'getmodulename', 'getpackagedescription',
+            'getpackageinfo', 'gettime', 'guidtostring', 'incamonth',
+            'includetrailingbackslash', 'includetrailingpathdelimiter',
+            'incmonth', 'initializepackage', 'interlockeddecrement',
+            'interlockedexchange', 'interlockedexchangeadd',
+            'interlockedincrement', 'inttohex', 'inttostr', 'isdelimiter',
+            'isequalguid', 'isleapyear', 'ispathdelimiter', 'isvalidident',
+            'languages', 'lastdelimiter', 'loadpackage', 'loadstr',
+            'lowercase', 'msecstotimestamp', 'newstr', 'nextcharindex', 'now',
+            'outofmemoryerror', 'quotedstr', 'raiselastoserror',
+            'raiselastwin32error', 'removedir', 'renamefile', 'replacedate',
+            'replacetime', 'safeloadlibrary', 'samefilename', 'sametext',
+            'setcurrentdir', 'showexception', 'sleep', 'stralloc', 'strbufsize',
+            'strbytetype', 'strcat', 'strcharlength', 'strcomp', 'strcopy',
+            'strdispose', 'strecopy', 'strend', 'strfmt', 'stricomp',
+            'stringreplace', 'stringtoguid', 'strlcat', 'strlcomp', 'strlcopy',
+            'strlen', 'strlfmt', 'strlicomp', 'strlower', 'strmove', 'strnew',
+            'strnextchar', 'strpas', 'strpcopy', 'strplcopy', 'strpos',
+            'strrscan', 'strscan', 'strtobool', 'strtobooldef', 'strtocurr',
+            'strtocurrdef', 'strtodate', 'strtodatedef', 'strtodatetime',
+            'strtodatetimedef', 'strtofloat', 'strtofloatdef', 'strtoint',
+            'strtoint64', 'strtoint64def', 'strtointdef', 'strtotime',
+            'strtotimedef', 'strupper', 'supports', 'syserrormessage',
+            'systemtimetodatetime', 'texttofloat', 'time', 'timestamptodatetime',
+            'timestamptomsecs', 'timetostr', 'trim', 'trimleft', 'trimright',
+            'tryencodedate', 'tryencodetime', 'tryfloattocurr', 'tryfloattodatetime',
+            'trystrtobool', 'trystrtocurr', 'trystrtodate', 'trystrtodatetime',
+            'trystrtofloat', 'trystrtoint', 'trystrtoint64', 'trystrtotime',
+            'unloadpackage', 'uppercase', 'widecomparestr', 'widecomparetext',
+            'widefmtstr', 'wideformat', 'wideformatbuf', 'widelowercase',
+            'widesamestr', 'widesametext', 'wideuppercase', 'win32check',
+            'wraptext'
+        ),
+        'Classes': (
+            'activateclassgroup', 'allocatehwnd', 'bintohex', 'checksynchronize',
+            'collectionsequal', 'countgenerations', 'deallocatehwnd', 'equalrect',
+            'extractstrings', 'findclass', 'findglobalcomponent', 'getclass',
+            'groupdescendantswith', 'hextobin', 'identtoint',
+            'initinheritedcomponent', 'inttoident', 'invalidpoint',
+            'isuniqueglobalcomponentname', 'linestart', 'objectbinarytotext',
+            'objectresourcetotext', 'objecttexttobinary', 'objecttexttoresource',
+            'pointsequal', 'readcomponentres', 'readcomponentresex',
+            'readcomponentresfile', 'rect', 'registerclass', 'registerclassalias',
+            'registerclasses', 'registercomponents', 'registerintegerconsts',
+            'registernoicon', 'registernonactivex', 'smallpoint', 'startclassgroup',
+            'teststreamformat', 'unregisterclass', 'unregisterclasses',
+            'unregisterintegerconsts', 'unregistermoduleclasses',
+            'writecomponentresfile'
+        ),
+        'Math': (
+            'arccos', 'arccosh', 'arccot', 'arccoth', 'arccsc', 'arccsch', 'arcsec',
+            'arcsech', 'arcsin', 'arcsinh', 'arctan2', 'arctanh', 'ceil',
+            'comparevalue', 'cosecant', 'cosh', 'cot', 'cotan', 'coth', 'csc',
+            'csch', 'cycletodeg', 'cycletograd', 'cycletorad', 'degtocycle',
+            'degtograd', 'degtorad', 'divmod', 'doubledecliningbalance',
+            'ensurerange', 'floor', 'frexp', 'futurevalue', 'getexceptionmask',
+            'getprecisionmode', 'getroundmode', 'gradtocycle', 'gradtodeg',
+            'gradtorad', 'hypot', 'inrange', 'interestpayment', 'interestrate',
+            'internalrateofreturn', 'intpower', 'isinfinite', 'isnan', 'iszero',
+            'ldexp', 'lnxp1', 'log10', 'log2', 'logn', 'max', 'maxintvalue',
+            'maxvalue', 'mean', 'meanandstddev', 'min', 'minintvalue', 'minvalue',
+            'momentskewkurtosis', 'netpresentvalue', 'norm', 'numberofperiods',
+            'payment', 'periodpayment', 'poly', 'popnstddev', 'popnvariance',
+            'power', 'presentvalue', 'radtocycle', 'radtodeg', 'radtograd',
+            'randg', 'randomrange', 'roundto', 'samevalue', 'sec', 'secant',
+            'sech', 'setexceptionmask', 'setprecisionmode', 'setroundmode',
+            'sign', 'simpleroundto', 'sincos', 'sinh', 'slndepreciation', 'stddev',
+            'sum', 'sumint', 'sumofsquares', 'sumsandsquares', 'syddepreciation',
+            'tan', 'tanh', 'totalvariance', 'variance'
+        )
+    }
+
+    ASM_REGISTERS = {
+        'ah', 'al', 'ax', 'bh', 'bl', 'bp', 'bx', 'ch', 'cl', 'cr0',
+        'cr1', 'cr2', 'cr3', 'cr4', 'cs', 'cx', 'dh', 'di', 'dl', 'dr0',
+        'dr1', 'dr2', 'dr3', 'dr4', 'dr5', 'dr6', 'dr7', 'ds', 'dx',
+        'eax', 'ebp', 'ebx', 'ecx', 'edi', 'edx', 'es', 'esi', 'esp',
+        'fs', 'gs', 'mm0', 'mm1', 'mm2', 'mm3', 'mm4', 'mm5', 'mm6',
+        'mm7', 'si', 'sp', 'ss', 'st0', 'st1', 'st2', 'st3', 'st4', 'st5',
+        'st6', 'st7', 'xmm0', 'xmm1', 'xmm2', 'xmm3', 'xmm4', 'xmm5',
+        'xmm6', 'xmm7'
+    }
+
+    ASM_INSTRUCTIONS = {
+        'aaa', 'aad', 'aam', 'aas', 'adc', 'add', 'and', 'arpl', 'bound',
+        'bsf', 'bsr', 'bswap', 'bt', 'btc', 'btr', 'bts', 'call', 'cbw',
+        'cdq', 'clc', 'cld', 'cli', 'clts', 'cmc', 'cmova', 'cmovae',
+        'cmovb', 'cmovbe', 'cmovc', 'cmovcxz', 'cmove', 'cmovg',
+        'cmovge', 'cmovl', 'cmovle', 'cmovna', 'cmovnae', 'cmovnb',
+        'cmovnbe', 'cmovnc', 'cmovne', 'cmovng', 'cmovnge', 'cmovnl',
+        'cmovnle', 'cmovno', 'cmovnp', 'cmovns', 'cmovnz', 'cmovo',
+        'cmovp', 'cmovpe', 'cmovpo', 'cmovs', 'cmovz', 'cmp', 'cmpsb',
+        'cmpsd', 'cmpsw', 'cmpxchg', 'cmpxchg486', 'cmpxchg8b', 'cpuid',
+        'cwd', 'cwde', 'daa', 'das', 'dec', 'div', 'emms', 'enter', 'hlt',
+        'ibts', 'icebp', 'idiv', 'imul', 'in', 'inc', 'insb', 'insd',
+        'insw', 'int', 'int01', 'int03', 'int1', 'int3', 'into', 'invd',
+        'invlpg', 'iret', 'iretd', 'iretw', 'ja', 'jae', 'jb', 'jbe',
+        'jc', 'jcxz', 'jcxz', 'je', 'jecxz', 'jg', 'jge', 'jl', 'jle',
+        'jmp', 'jna', 'jnae', 'jnb', 'jnbe', 'jnc', 'jne', 'jng', 'jnge',
+        'jnl', 'jnle', 'jno', 'jnp', 'jns', 'jnz', 'jo', 'jp', 'jpe',
+        'jpo', 'js', 'jz', 'lahf', 'lar', 'lcall', 'lds', 'lea', 'leave',
+        'les', 'lfs', 'lgdt', 'lgs', 'lidt', 'ljmp', 'lldt', 'lmsw',
+        'loadall', 'loadall286', 'lock', 'lodsb', 'lodsd', 'lodsw',
+        'loop', 'loope', 'loopne', 'loopnz', 'loopz', 'lsl', 'lss', 'ltr',
+        'mov', 'movd', 'movq', 'movsb', 'movsd', 'movsw', 'movsx',
+        'movzx', 'mul', 'neg', 'nop', 'not', 'or', 'out', 'outsb', 'outsd',
+        'outsw', 'pop', 'popa', 'popad', 'popaw', 'popf', 'popfd', 'popfw',
+        'push', 'pusha', 'pushad', 'pushaw', 'pushf', 'pushfd', 'pushfw',
+        'rcl', 'rcr', 'rdmsr', 'rdpmc', 'rdshr', 'rdtsc', 'rep', 'repe',
+        'repne', 'repnz', 'repz', 'ret', 'retf', 'retn', 'rol', 'ror',
+        'rsdc', 'rsldt', 'rsm', 'sahf', 'sal', 'salc', 'sar', 'sbb',
+        'scasb', 'scasd', 'scasw', 'seta', 'setae', 'setb', 'setbe',
+        'setc', 'setcxz', 'sete', 'setg', 'setge', 'setl', 'setle',
+        'setna', 'setnae', 'setnb', 'setnbe', 'setnc', 'setne', 'setng',
+        'setnge', 'setnl', 'setnle', 'setno', 'setnp', 'setns', 'setnz',
+        'seto', 'setp', 'setpe', 'setpo', 'sets', 'setz', 'sgdt', 'shl',
+        'shld', 'shr', 'shrd', 'sidt', 'sldt', 'smi', 'smint', 'smintold',
+        'smsw', 'stc', 'std', 'sti', 'stosb', 'stosd', 'stosw', 'str',
+        'sub', 'svdc', 'svldt', 'svts', 'syscall', 'sysenter', 'sysexit',
+        'sysret', 'test', 'ud1', 'ud2', 'umov', 'verr', 'verw', 'wait',
+        'wbinvd', 'wrmsr', 'wrshr', 'xadd', 'xbts', 'xchg', 'xlat',
+        'xlatb', 'xor'
+    }
+
+    PORTUGOL_KEYWORDS = (
+        'aleatorio',
+        'algoritmo',
+        'arquivo',
+        'ate',
+        'caso',
+        'cronometro',
+        'debug',
+        'e',
+        'eco',
+        'enquanto',
+        'entao',
+        'escolha',
+        'escreva',
+        'escreval',
+        'faca',
+        'falso',
+        'fimalgoritmo',
+        'fimenquanto',
+        'fimescolha',
+        'fimfuncao',
+        'fimpara',
+        'fimprocedimento',
+        'fimrepita',
+        'fimse',
+        'funcao',
+        'inicio',
+        'int',
+        'interrompa',
+        'leia',
+        'limpatela',
+        'mod',
+        'nao',
+        'ou',
+        'outrocaso',
+        'para',
+        'passo',
+        'pausa',
+        'procedimento',
+        'repita',
+        'retorne',
+        'se',
+        'senao',
+        'timer',
+        'var',
+        'vetor',
+        'verdadeiro',
+        'xou',
+        'div',
+        'mod',
+        'abs',
+        'arccos',
+        'arcsen',
+        'arctan',
+        'cos',
+        'cotan',
+        'Exp',
+        'grauprad',
+        'int',
+        'log',
+        'logn',
+        'pi',
+        'quad',
+        'radpgrau',
+        'raizq',
+        'rand',
+        'randi',
+        'sen',
+        'Tan',
+        'asc',
+        'carac',
+        'caracpnum',
+        'compr',
+        'copia',
+        'maiusc',
+        'minusc',
+        'numpcarac',
+        'pos',
+    )
+
+    PORTUGOL_BUILTIN_TYPES = {
+        'inteiro', 'real', 'caractere', 'logico'
+    }
+
+    def __init__(self, **options):
+        Lexer.__init__(self, **options)
+        self.keywords = set()
+        self.builtins = set()
+        if get_bool_opt(options, 'portugol', False):
+            self.keywords.update(self.PORTUGOL_KEYWORDS)
+            self.builtins.update(self.PORTUGOL_BUILTIN_TYPES)
+            self.is_portugol = True
+        else:
+            self.is_portugol = False
+
+            if get_bool_opt(options, 'turbopascal', True):
+                self.keywords.update(self.TURBO_PASCAL_KEYWORDS)
+            if get_bool_opt(options, 'delphi', True):
+                self.keywords.update(self.DELPHI_KEYWORDS)
+            if get_bool_opt(options, 'freepascal', True):
+                self.keywords.update(self.FREE_PASCAL_KEYWORDS)
+            for unit in get_list_opt(options, 'units', list(self.BUILTIN_UNITS)):
+                self.builtins.update(self.BUILTIN_UNITS[unit])
+
+    def get_tokens_unprocessed(self, text):
+        scanner = Scanner(text, re.DOTALL | re.MULTILINE | re.IGNORECASE)
+        stack = ['initial']
+        in_function_block = False
+        in_property_block = False
+        was_dot = False
+        next_token_is_function = False
+        next_token_is_property = False
+        collect_labels = False
+        block_labels = set()
+        brace_balance = [0, 0]
+
+        while not scanner.eos:
+            token = Error
+
+            if stack[-1] == 'initial':
+                if scanner.scan(r'\s+'):
+                    token = Whitespace
+                elif not self.is_portugol and scanner.scan(r'\{.*?\}|\(\*.*?\*\)'):
+                    if scanner.match.startswith('$'):
+                        token = Comment.Preproc
+                    else:
+                        token = Comment.Multiline
+                elif scanner.scan(r'//.*?$'):
+                    token = Comment.Single
+                elif self.is_portugol and scanner.scan(r'(<\-)|(>=)|(<=)|%|<|>|-|\+|\*|\=|(<>)|\/|\.|:|,'):
+                    token = Operator
+                elif not self.is_portugol and scanner.scan(r'[-+*\/=<>:;,.@\^]'):
+                    token = Operator
+                    # stop label highlighting on next ";"
+                    if collect_labels and scanner.match == ';':
+                        collect_labels = False
+                elif scanner.scan(r'[\(\)\[\]]+'):
+                    token = Punctuation
+                    # abort function naming ``foo = Function(...)``
+                    next_token_is_function = False
+                    # if we are in a function block we count the open
+                    # braces because ootherwise it's impossible to
+                    # determine the end of the modifier context
+                    if in_function_block or in_property_block:
+                        if scanner.match == '(':
+                            brace_balance[0] += 1
+                        elif scanner.match == ')':
+                            brace_balance[0] -= 1
+                        elif scanner.match == '[':
+                            brace_balance[1] += 1
+                        elif scanner.match == ']':
+                            brace_balance[1] -= 1
+                elif scanner.scan(r'[A-Za-z_][A-Za-z_0-9]*'):
+                    lowercase_name = scanner.match.lower()
+                    if lowercase_name == 'result':
+                        token = Name.Builtin.Pseudo
+                    elif lowercase_name in self.keywords:
+                        token = Keyword
+                        # if we are in a special block and a
+                        # block ending keyword occurs (and the parenthesis
+                        # is balanced) we end the current block context
+                        if self.is_portugol:
+                            if lowercase_name in ('funcao', 'procedimento'):
+                                in_function_block = True
+                                next_token_is_function = True
+                        else:
+                            if (in_function_block or in_property_block) and \
+                                    lowercase_name in self.BLOCK_KEYWORDS and \
+                                    brace_balance[0] <= 0 and \
+                                    brace_balance[1] <= 0:
+                                in_function_block = False
+                                in_property_block = False
+                                brace_balance = [0, 0]
+                                block_labels = set()
+                            if lowercase_name in ('label', 'goto'):
+                                collect_labels = True
+                            elif lowercase_name == 'asm':
+                                stack.append('asm')
+                            elif lowercase_name == 'property':
+                                in_property_block = True
+                                next_token_is_property = True
+                            elif lowercase_name in ('procedure', 'operator',
+                                                    'function', 'constructor',
+                                                    'destructor'):
+                                in_function_block = True
+                                next_token_is_function = True
+                    # we are in a function block and the current name
+                    # is in the set of registered modifiers. highlight
+                    # it as pseudo keyword
+                    elif not self.is_portugol and in_function_block and \
+                            lowercase_name in self.FUNCTION_MODIFIERS:
+                        token = Keyword.Pseudo
+                    # if we are in a property highlight some more
+                    # modifiers
+                    elif not self.is_portugol and in_property_block and \
+                            lowercase_name in ('read', 'write'):
+                        token = Keyword.Pseudo
+                        next_token_is_function = True
+                    # if the last iteration set next_token_is_function
+                    # to true we now want this name highlighted as
+                    # function. so do that and reset the state
+                    elif next_token_is_function:
+                        # Look if the next token is a dot. If yes it's
+                        # not a function, but a class name and the
+                        # part after the dot a function name
+                        if not self.is_portugol and scanner.test(r'\s*\.\s*'):
+                            token = Name.Class
+                        # it's not a dot, our job is done
+                        else:
+                            token = Name.Function
+                            next_token_is_function = False
+
+                            if self.is_portugol:
+                                block_labels.add(scanner.match.lower())
+
+                    # same for properties
+                    elif not self.is_portugol and next_token_is_property:
+                        token = Name.Property
+                        next_token_is_property = False
+                    # Highlight this token as label and add it
+                    # to the list of known labels
+                    elif not self.is_portugol and collect_labels:
+                        token = Name.Label
+                        block_labels.add(scanner.match.lower())
+                    # name is in list of known labels
+                    elif lowercase_name in block_labels:
+                        token = Name.Label
+                    elif self.is_portugol and lowercase_name in self.PORTUGOL_BUILTIN_TYPES:
+                        token = Keyword.Type
+                    elif not self.is_portugol and lowercase_name in self.BUILTIN_TYPES:
+                        token = Keyword.Type
+                    elif not self.is_portugol and lowercase_name in self.DIRECTIVES:
+                        token = Keyword.Pseudo
+                    # builtins are just builtins if the token
+                    # before isn't a dot
+                    elif not self.is_portugol and not was_dot and lowercase_name in self.builtins:
+                        token = Name.Builtin
+                    else:
+                        token = Name
+                elif self.is_portugol and scanner.scan(r"\""):
+                    token = String
+                    stack.append('string')
+                elif not self.is_portugol and scanner.scan(r"'"):
+                    token = String
+                    stack.append('string')
+                elif not self.is_portugol and scanner.scan(r'\#(\d+|\$[0-9A-Fa-f]+)'):
+                    token = String.Char
+                elif not self.is_portugol and scanner.scan(r'\$[0-9A-Fa-f]+'):
+                    token = Number.Hex
+                elif scanner.scan(r'\d+(?![eE]|\.[^.])'):
+                    token = Number.Integer
+                elif scanner.scan(r'\d+(\.\d+([eE][+-]?\d+)?|[eE][+-]?\d+)'):
+                    token = Number.Float
+                else:
+                    # if the stack depth is deeper than once, pop
+                    if len(stack) > 1:
+                        stack.pop()
+                    scanner.get_char()
+
+            elif stack[-1] == 'string':
+                if self.is_portugol:
+                    if scanner.scan(r"''"):
+                        token = String.Escape
+                    elif scanner.scan(r"\""):
+                        token = String
+                        stack.pop()
+                    elif scanner.scan(r"[^\"]*"):
+                        token = String
+                    else:
+                        scanner.get_char()
+                        stack.pop()
+                else:
+                    if scanner.scan(r"''"):
+                        token = String.Escape
+                    elif scanner.scan(r"'"):
+                        token = String
+                        stack.pop()
+                    elif scanner.scan(r"[^']*"):
+                        token = String
+                    else:
+                        scanner.get_char()
+                        stack.pop()
+            elif not self.is_portugol and stack[-1] == 'asm':
+                if scanner.scan(r'\s+'):
+                    token = Whitespace
+                elif scanner.scan(r'end'):
+                    token = Keyword
+                    stack.pop()
+                elif scanner.scan(r'\{.*?\}|\(\*.*?\*\)'):
+                    if scanner.match.startswith('$'):
+                        token = Comment.Preproc
+                    else:
+                        token = Comment.Multiline
+                elif scanner.scan(r'//.*?$'):
+                    token = Comment.Single
+                elif scanner.scan(r"'"):
+                    token = String
+                    stack.append('string')
+                elif scanner.scan(r'@@[A-Za-z_][A-Za-z_0-9]*'):
+                    token = Name.Label
+                elif scanner.scan(r'[A-Za-z_][A-Za-z_0-9]*'):
+                    lowercase_name = scanner.match.lower()
+                    if lowercase_name in self.ASM_INSTRUCTIONS:
+                        token = Keyword
+                    elif lowercase_name in self.ASM_REGISTERS:
+                        token = Name.Builtin
+                    else:
+                        token = Name
+                elif scanner.scan(r'[-+*\/=<>:;,.@\^]+'):
+                    token = Operator
+                elif scanner.scan(r'[\(\)\[\]]+'):
+                    token = Punctuation
+                elif scanner.scan(r'\$[0-9A-Fa-f]+'):
+                    token = Number.Hex
+                elif scanner.scan(r'\d+(?![eE]|\.[^.])'):
+                    token = Number.Integer
+                elif scanner.scan(r'\d+(\.\d+([eE][+-]?\d+)?|[eE][+-]?\d+)'):
+                    token = Number.Float
+                else:
+                    scanner.get_char()
+                    stack.pop()
+
+            # save the dot!!!11
+            if not self.is_portugol and scanner.match.strip():
+                was_dot = scanner.match == '.'
+
+            yield scanner.start_pos, token, scanner.match or ''
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/pawn.py b/env/lib/python3.12/site-packages/pygments/lexers/pawn.py
new file mode 100644
index 0000000..99d9c96
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/pawn.py
@@ -0,0 +1,202 @@
+"""
+    pygments.lexers.pawn
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for the Pawn languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation
+from pygments.util import get_bool_opt
+
+__all__ = ['SourcePawnLexer', 'PawnLexer']
+
+
+class SourcePawnLexer(RegexLexer):
+    """
+    For SourcePawn source code with preprocessor directives.
+    """
+    name = 'SourcePawn'
+    aliases = ['sp']
+    filenames = ['*.sp']
+    mimetypes = ['text/x-sourcepawn']
+    url = 'https://github.com/alliedmodders/sourcepawn'
+    version_added = '1.6'
+
+    #: optional Comment or Whitespace
+    _ws = r'(?:\s|//.*?\n|/\*.*?\*/)+'
+    #: only one /* */ style comment
+    _ws1 = r'\s*(?:/[*].*?[*]/\s*)*'
+
+    tokens = {
+        'root': [
+            # preprocessor directives: without whitespace
+            (r'^#if\s+0', Comment.Preproc, 'if0'),
+            ('^#', Comment.Preproc, 'macro'),
+            # or with whitespace
+            ('^' + _ws1 + r'#if\s+0', Comment.Preproc, 'if0'),
+            ('^' + _ws1 + '#', Comment.Preproc, 'macro'),
+            (r'\n', Text),
+            (r'\s+', Text),
+            (r'\\\n', Text),  # line continuation
+            (r'/(\\\n)?/(\n|(.|\n)*?[^\\]\n)', Comment.Single),
+            (r'/(\\\n)?\*(.|\n)*?\*(\\\n)?/', Comment.Multiline),
+            (r'[{}]', Punctuation),
+            (r'L?"', String, 'string'),
+            (r"L?'(\\.|\\[0-7]{1,3}|\\x[a-fA-F0-9]{1,2}|[^\\\'\n])'", String.Char),
+            (r'(\d+\.\d*|\.\d+|\d+)[eE][+-]?\d+[LlUu]*', Number.Float),
+            (r'(\d+\.\d*|\.\d+|\d+[fF])[fF]?', Number.Float),
+            (r'0x[0-9a-fA-F]+[LlUu]*', Number.Hex),
+            (r'0[0-7]+[LlUu]*', Number.Oct),
+            (r'\d+[LlUu]*', Number.Integer),
+            (r'[~!%^&*+=|?:<>/-]', Operator),
+            (r'[()\[\],.;]', Punctuation),
+            (r'(case|const|continue|native|'
+             r'default|else|enum|for|if|new|operator|'
+             r'public|return|sizeof|static|decl|struct|switch)\b', Keyword),
+            (r'(bool|Float)\b', Keyword.Type),
+            (r'(true|false)\b', Keyword.Constant),
+            (r'[a-zA-Z_]\w*', Name),
+        ],
+        'string': [
+            (r'"', String, '#pop'),
+            (r'\\([\\abfnrtv"\']|x[a-fA-F0-9]{2,4}|[0-7]{1,3})', String.Escape),
+            (r'[^\\"\n]+', String),  # all other characters
+            (r'\\\n', String),       # line continuation
+            (r'\\', String),         # stray backslash
+        ],
+        'macro': [
+            (r'[^/\n]+', Comment.Preproc),
+            (r'/\*(.|\n)*?\*/', Comment.Multiline),
+            (r'//.*?\n', Comment.Single, '#pop'),
+            (r'/', Comment.Preproc),
+            (r'(?<=\\)\n', Comment.Preproc),
+            (r'\n', Comment.Preproc, '#pop'),
+        ],
+        'if0': [
+            (r'^\s*#if.*?(?/-]', Operator),
+            (r'[()\[\],.;]', Punctuation),
+            (r'(switch|case|default|const|new|static|char|continue|break|'
+             r'if|else|for|while|do|operator|enum|'
+             r'public|return|sizeof|tagof|state|goto)\b', Keyword),
+            (r'(bool|Float)\b', Keyword.Type),
+            (r'(true|false)\b', Keyword.Constant),
+            (r'[a-zA-Z_]\w*', Name),
+        ],
+        'string': [
+            (r'"', String, '#pop'),
+            (r'\\([\\abfnrtv"\']|x[a-fA-F0-9]{2,4}|[0-7]{1,3})', String.Escape),
+            (r'[^\\"\n]+', String),  # all other characters
+            (r'\\\n', String),       # line continuation
+            (r'\\', String),         # stray backslash
+        ],
+        'macro': [
+            (r'[^/\n]+', Comment.Preproc),
+            (r'/\*(.|\n)*?\*/', Comment.Multiline),
+            (r'//.*?\n', Comment.Single, '#pop'),
+            (r'/', Comment.Preproc),
+            (r'(?<=\\)\n', Comment.Preproc),
+            (r'\n', Comment.Preproc, '#pop'),
+        ],
+        'if0': [
+            (r'^\s*#if.*?(?<-]', Operator),
+            (r'[a-zA-Z][a-zA-Z0-9_-]*', Name),
+            (r'\?[a-zA-Z][a-zA-Z0-9_-]*', Name.Variable),
+            (r'[0-9]+\.[0-9]+', Number.Float),
+            (r'[0-9]+', Number.Integer),
+        ],
+        'keywords': [
+            (words((
+                ':requirements', ':types', ':constants',
+                ':predicates', ':functions', ':action', ':agent',
+                ':parameters', ':precondition', ':effect',
+                ':durative-action', ':duration', ':condition',
+                ':derived', ':domain', ':objects', ':init',
+                ':goal', ':metric', ':length', ':serial', ':parallel',
+                # the following are requirements
+                ':strips', ':typing', ':negative-preconditions',
+                ':disjunctive-preconditions', ':equality',
+                ':existential-preconditions', ':universal-preconditions',
+                ':conditional-effects', ':fluents', ':numeric-fluents',
+                ':object-fluents', ':adl', ':durative-actions',
+                ':continuous-effects', ':derived-predicates',
+                ':time-intial-literals', ':preferences',
+                ':constraints', ':action-costs', ':multi-agent',
+                ':unfactored-privacy', ':factored-privacy',
+                ':non-deterministic'
+                ), suffix=r'\b'), Keyword)
+        ],
+        'builtins': [
+            (words((
+                'define', 'domain', 'object', 'either', 'and',
+                'forall', 'preference', 'imply', 'or', 'exists',
+                'not', 'when', 'assign', 'scale-up', 'scale-down',
+                'increase', 'decrease', 'at', 'over', 'start',
+                'end', 'all', 'problem', 'always', 'sometime',
+                'within', 'at-most-once', 'sometime-after',
+                'sometime-before', 'always-within', 'hold-during',
+                'hold-after', 'minimize', 'maximize',
+                'total-time', 'is-violated'), suffix=r'\b'),
+                Name.Builtin)
+        ]
+    }
+
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/perl.py b/env/lib/python3.12/site-packages/pygments/lexers/perl.py
new file mode 100644
index 0000000..33f91f5
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/perl.py
@@ -0,0 +1,733 @@
+"""
+    pygments.lexers.perl
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Perl, Raku and related languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, ExtendedRegexLexer, include, bygroups, \
+    using, this, default, words
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Whitespace
+from pygments.util import shebang_matches
+
+__all__ = ['PerlLexer', 'Perl6Lexer']
+
+
+class PerlLexer(RegexLexer):
+    """
+    For Perl source code.
+    """
+
+    name = 'Perl'
+    url = 'https://www.perl.org'
+    aliases = ['perl', 'pl']
+    filenames = ['*.pl', '*.pm', '*.t', '*.perl']
+    mimetypes = ['text/x-perl', 'application/x-perl']
+    version_added = ''
+
+    flags = re.DOTALL | re.MULTILINE
+    # TODO: give this to a perl guy who knows how to parse perl...
+    tokens = {
+        'balanced-regex': [
+            (r'/(\\\\|\\[^\\]|[^\\/])*/[egimosx]*', String.Regex, '#pop'),
+            (r'!(\\\\|\\[^\\]|[^\\!])*![egimosx]*', String.Regex, '#pop'),
+            (r'\\(\\\\|[^\\])*\\[egimosx]*', String.Regex, '#pop'),
+            (r'\{(\\\\|\\[^\\]|[^\\}])*\}[egimosx]*', String.Regex, '#pop'),
+            (r'<(\\\\|\\[^\\]|[^\\>])*>[egimosx]*', String.Regex, '#pop'),
+            (r'\[(\\\\|\\[^\\]|[^\\\]])*\][egimosx]*', String.Regex, '#pop'),
+            (r'\((\\\\|\\[^\\]|[^\\)])*\)[egimosx]*', String.Regex, '#pop'),
+            (r'@(\\\\|\\[^\\]|[^\\@])*@[egimosx]*', String.Regex, '#pop'),
+            (r'%(\\\\|\\[^\\]|[^\\%])*%[egimosx]*', String.Regex, '#pop'),
+            (r'\$(\\\\|\\[^\\]|[^\\$])*\$[egimosx]*', String.Regex, '#pop'),
+        ],
+        'root': [
+            (r'\A\#!.+?$', Comment.Hashbang),
+            (r'\#.*?$', Comment.Single),
+            (r'^=[a-zA-Z0-9]+\s+.*?\n=cut', Comment.Multiline),
+            (words((
+                'case', 'continue', 'do', 'else', 'elsif', 'for', 'foreach',
+                'if', 'last', 'my', 'next', 'our', 'redo', 'reset', 'then',
+                'unless', 'until', 'while', 'print', 'new', 'BEGIN',
+                'CHECK', 'INIT', 'END', 'return'), suffix=r'\b'),
+             Keyword),
+            (r'(format)(\s+)(\w+)(\s*)(=)(\s*\n)',
+             bygroups(Keyword, Whitespace, Name, Whitespace, Punctuation, Whitespace), 'format'),
+            (r'(eq|lt|gt|le|ge|ne|not|and|or|cmp)\b', Operator.Word),
+            # common delimiters
+            (r's/(\\\\|\\[^\\]|[^\\/])*/(\\\\|\\[^\\]|[^\\/])*/[egimosx]*',
+                String.Regex),
+            (r's!(\\\\|\\!|[^!])*!(\\\\|\\!|[^!])*![egimosx]*', String.Regex),
+            (r's\\(\\\\|[^\\])*\\(\\\\|[^\\])*\\[egimosx]*', String.Regex),
+            (r's@(\\\\|\\[^\\]|[^\\@])*@(\\\\|\\[^\\]|[^\\@])*@[egimosx]*',
+                String.Regex),
+            (r's%(\\\\|\\[^\\]|[^\\%])*%(\\\\|\\[^\\]|[^\\%])*%[egimosx]*',
+                String.Regex),
+            # balanced delimiters
+            (r's\{(\\\\|\\[^\\]|[^\\}])*\}\s*', String.Regex, 'balanced-regex'),
+            (r's<(\\\\|\\[^\\]|[^\\>])*>\s*', String.Regex, 'balanced-regex'),
+            (r's\[(\\\\|\\[^\\]|[^\\\]])*\]\s*', String.Regex,
+                'balanced-regex'),
+            (r's\((\\\\|\\[^\\]|[^\\)])*\)\s*', String.Regex,
+                'balanced-regex'),
+
+            (r'm?/(\\\\|\\[^\\]|[^\\/\n])*/[gcimosx]*', String.Regex),
+            (r'm(?=[/!\\{<\[(@%$])', String.Regex, 'balanced-regex'),
+            (r'((?<==~)|(?<=\())\s*/(\\\\|\\[^\\]|[^\\/])*/[gcimosx]*',
+                String.Regex),
+            (r'\s+', Whitespace),
+            (words((
+                'abs', 'accept', 'alarm', 'atan2', 'bind', 'binmode', 'bless', 'caller', 'chdir',
+                'chmod', 'chomp', 'chop', 'chown', 'chr', 'chroot', 'close', 'closedir', 'connect',
+                'continue', 'cos', 'crypt', 'dbmclose', 'dbmopen', 'defined', 'delete', 'die',
+                'dump', 'each', 'endgrent', 'endhostent', 'endnetent', 'endprotoent',
+                'endpwent', 'endservent', 'eof', 'eval', 'exec', 'exists', 'exit', 'exp', 'fcntl',
+                'fileno', 'flock', 'fork', 'format', 'formline', 'getc', 'getgrent', 'getgrgid',
+                'getgrnam', 'gethostbyaddr', 'gethostbyname', 'gethostent', 'getlogin',
+                'getnetbyaddr', 'getnetbyname', 'getnetent', 'getpeername', 'getpgrp',
+                'getppid', 'getpriority', 'getprotobyname', 'getprotobynumber',
+                'getprotoent', 'getpwent', 'getpwnam', 'getpwuid', 'getservbyname',
+                'getservbyport', 'getservent', 'getsockname', 'getsockopt', 'glob', 'gmtime',
+                'goto', 'grep', 'hex', 'import', 'index', 'int', 'ioctl', 'join', 'keys', 'kill', 'last',
+                'lc', 'lcfirst', 'length', 'link', 'listen', 'local', 'localtime', 'log', 'lstat',
+                'map', 'mkdir', 'msgctl', 'msgget', 'msgrcv', 'msgsnd', 'my', 'next', 'oct', 'open',
+                'opendir', 'ord', 'our', 'pack', 'pipe', 'pop', 'pos', 'printf',
+                'prototype', 'push', 'quotemeta', 'rand', 'read', 'readdir',
+                'readline', 'readlink', 'readpipe', 'recv', 'redo', 'ref', 'rename',
+                'reverse', 'rewinddir', 'rindex', 'rmdir', 'scalar', 'seek', 'seekdir',
+                'select', 'semctl', 'semget', 'semop', 'send', 'setgrent', 'sethostent', 'setnetent',
+                'setpgrp', 'setpriority', 'setprotoent', 'setpwent', 'setservent',
+                'setsockopt', 'shift', 'shmctl', 'shmget', 'shmread', 'shmwrite', 'shutdown',
+                'sin', 'sleep', 'socket', 'socketpair', 'sort', 'splice', 'split', 'sprintf', 'sqrt',
+                'srand', 'stat', 'study', 'substr', 'symlink', 'syscall', 'sysopen', 'sysread',
+                'sysseek', 'system', 'syswrite', 'tell', 'telldir', 'tie', 'tied', 'time', 'times', 'tr',
+                'truncate', 'uc', 'ucfirst', 'umask', 'undef', 'unlink', 'unpack', 'unshift', 'untie',
+                'utime', 'values', 'vec', 'wait', 'waitpid', 'wantarray', 'warn', 'write'), suffix=r'\b'),
+             Name.Builtin),
+            (r'((__(DATA|DIE|WARN)__)|(STD(IN|OUT|ERR)))\b', Name.Builtin.Pseudo),
+            (r'(<<)([\'"]?)([a-zA-Z_]\w*)(\2;?\n.*?\n)(\3)(\n)',
+             bygroups(String, String, String.Delimiter, String, String.Delimiter, Whitespace)),
+            (r'__END__', Comment.Preproc, 'end-part'),
+            (r'\$\^[ADEFHILMOPSTWX]', Name.Variable.Global),
+            (r"\$[\\\"\[\]'&`+*.,;=%~?@$!<>(^|/-](?!\w)", Name.Variable.Global),
+            (r'[$@%#]+', Name.Variable, 'varname'),
+            (r'0_?[0-7]+(_[0-7]+)*', Number.Oct),
+            (r'0x[0-9A-Fa-f]+(_[0-9A-Fa-f]+)*', Number.Hex),
+            (r'0b[01]+(_[01]+)*', Number.Bin),
+            (r'(?i)(\d*(_\d*)*\.\d+(_\d*)*|\d+(_\d*)*\.\d+(_\d*)*)(e[+-]?\d+)?',
+             Number.Float),
+            (r'(?i)\d+(_\d*)*e[+-]?\d+(_\d*)*', Number.Float),
+            (r'\d+(_\d+)*', Number.Integer),
+            (r"'(\\\\|\\[^\\]|[^'\\])*'", String),
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String),
+            (r'`(\\\\|\\[^\\]|[^`\\])*`', String.Backtick),
+            (r'<([^\s>]+)>', String.Regex),
+            (r'(q|qq|qw|qr|qx)\{', String.Other, 'cb-string'),
+            (r'(q|qq|qw|qr|qx)\(', String.Other, 'rb-string'),
+            (r'(q|qq|qw|qr|qx)\[', String.Other, 'sb-string'),
+            (r'(q|qq|qw|qr|qx)\<', String.Other, 'lt-string'),
+            (r'(q|qq|qw|qr|qx)([\W_])(.|\n)*?\2', String.Other),
+            (r'(package)(\s+)([a-zA-Z_]\w*(?:::[a-zA-Z_]\w*)*)',
+             bygroups(Keyword, Whitespace, Name.Namespace)),
+            (r'(use|require|no)(\s+)([a-zA-Z_]\w*(?:::[a-zA-Z_]\w*)*)',
+             bygroups(Keyword, Whitespace, Name.Namespace)),
+            (r'(sub)(\s+)', bygroups(Keyword, Whitespace), 'funcname'),
+            (words((
+                'no', 'package', 'require', 'use'), suffix=r'\b'),
+             Keyword),
+            (r'(\[\]|\*\*|::|<<|>>|>=|<=>|<=|={3}|!=|=~|'
+             r'!~|&&?|\|\||\.{1,3})', Operator),
+            (r'[-+/*%=<>&^|!\\~]=?', Operator),
+            (r'[()\[\]:;,<>/?{}]', Punctuation),  # yes, there's no shortage
+                                                  # of punctuation in Perl!
+            (r'(?=\w)', Name, 'name'),
+        ],
+        'format': [
+            (r'\.\n', String.Interpol, '#pop'),
+            (r'[^\n]*\n', String.Interpol),
+        ],
+        'varname': [
+            (r'\s+', Whitespace),
+            (r'\{', Punctuation, '#pop'),    # hash syntax?
+            (r'\)|,', Punctuation, '#pop'),  # argument specifier
+            (r'\w+::', Name.Namespace),
+            (r'[\w:]+', Name.Variable, '#pop'),
+        ],
+        'name': [
+            (r'[a-zA-Z_]\w*(::[a-zA-Z_]\w*)*(::)?(?=\s*->)', Name.Namespace, '#pop'),
+            (r'[a-zA-Z_]\w*(::[a-zA-Z_]\w*)*::', Name.Namespace, '#pop'),
+            (r'[\w:]+', Name, '#pop'),
+            (r'[A-Z_]+(?=\W)', Name.Constant, '#pop'),
+            (r'(?=\W)', Text, '#pop'),
+        ],
+        'funcname': [
+            (r'[a-zA-Z_]\w*[!?]?', Name.Function),
+            (r'\s+', Whitespace),
+            # argument declaration
+            (r'(\([$@%]*\))(\s*)', bygroups(Punctuation, Whitespace)),
+            (r';', Punctuation, '#pop'),
+            (r'.*?\{', Punctuation, '#pop'),
+        ],
+        'cb-string': [
+            (r'\\[{}\\]', String.Other),
+            (r'\\', String.Other),
+            (r'\{', String.Other, 'cb-string'),
+            (r'\}', String.Other, '#pop'),
+            (r'[^{}\\]+', String.Other)
+        ],
+        'rb-string': [
+            (r'\\[()\\]', String.Other),
+            (r'\\', String.Other),
+            (r'\(', String.Other, 'rb-string'),
+            (r'\)', String.Other, '#pop'),
+            (r'[^()]+', String.Other)
+        ],
+        'sb-string': [
+            (r'\\[\[\]\\]', String.Other),
+            (r'\\', String.Other),
+            (r'\[', String.Other, 'sb-string'),
+            (r'\]', String.Other, '#pop'),
+            (r'[^\[\]]+', String.Other)
+        ],
+        'lt-string': [
+            (r'\\[<>\\]', String.Other),
+            (r'\\', String.Other),
+            (r'\<', String.Other, 'lt-string'),
+            (r'\>', String.Other, '#pop'),
+            (r'[^<>]+', String.Other)
+        ],
+        'end-part': [
+            (r'.+', Comment.Preproc, '#pop')
+        ]
+    }
+
+    def analyse_text(text):
+        if shebang_matches(text, r'perl'):
+            return True
+
+        result = 0
+
+        if re.search(r'(?:my|our)\s+[$@%(]', text):
+            result += 0.9
+
+        if ':=' in text:
+            # := is not valid Perl, but it appears in unicon, so we should
+            # become less confident if we think we found Perl with :=
+            result /= 2
+
+        return result
+
+
+class Perl6Lexer(ExtendedRegexLexer):
+    """
+    For Raku (a.k.a. Perl 6) source code.
+    """
+
+    name = 'Perl6'
+    url = 'https://www.raku.org'
+    aliases = ['perl6', 'pl6', 'raku']
+    filenames = ['*.pl', '*.pm', '*.nqp', '*.p6', '*.6pl', '*.p6l', '*.pl6',
+                 '*.6pm', '*.p6m', '*.pm6', '*.t', '*.raku', '*.rakumod',
+                 '*.rakutest', '*.rakudoc']
+    mimetypes = ['text/x-perl6', 'application/x-perl6']
+    version_added = '2.0'
+    flags = re.MULTILINE | re.DOTALL
+
+    PERL6_IDENTIFIER_RANGE = r"['\w:-]"
+
+    PERL6_KEYWORDS = (
+        #Phasers
+        'BEGIN','CATCH','CHECK','CLOSE','CONTROL','DOC','END','ENTER','FIRST',
+        'INIT','KEEP','LAST','LEAVE','NEXT','POST','PRE','QUIT','UNDO',
+        #Keywords
+        'anon','augment','but','class','constant','default','does','else',
+        'elsif','enum','for','gather','given','grammar','has','if','import',
+        'is','let','loop','made','make','method','module','multi','my','need',
+        'orwith','our','proceed','proto','repeat','require','return',
+        'return-rw','returns','role','rule','state','sub','submethod','subset',
+        'succeed','supersede','token','try','unit','unless','until','use',
+        'when','while','with','without',
+        #Traits
+        'export','native','repr','required','rw','symbol',
+    )
+
+    PERL6_BUILTINS = (
+        'ACCEPTS','abs','abs2rel','absolute','accept','accessed','acos',
+        'acosec','acosech','acosh','acotan','acotanh','acquire','act','action',
+        'actions','add','add_attribute','add_enum_value','add_fallback',
+        'add_method','add_parent','add_private_method','add_role','add_trustee',
+        'adverb','after','all','allocate','allof','allowed','alternative-names',
+        'annotations','antipair','antipairs','any','anyof','app_lifetime',
+        'append','arch','archname','args','arity','Array','asec','asech','asin',
+        'asinh','ASSIGN-KEY','ASSIGN-POS','assuming','ast','at','atan','atan2',
+        'atanh','AT-KEY','atomic-assign','atomic-dec-fetch','atomic-fetch',
+        'atomic-fetch-add','atomic-fetch-dec','atomic-fetch-inc',
+        'atomic-fetch-sub','atomic-inc-fetch','AT-POS','attributes','auth',
+        'await','backtrace','Bag','BagHash','bail-out','base','basename',
+        'base-repeating','batch','BIND-KEY','BIND-POS','bind-stderr',
+        'bind-stdin','bind-stdout','bind-udp','bits','bless','block','Bool',
+        'bool-only','bounds','break','Bridge','broken','BUILD','build-date',
+        'bytes','cache','callframe','calling-package','CALL-ME','callsame',
+        'callwith','can','cancel','candidates','cando','can-ok','canonpath',
+        'caps','caption','Capture','cas','catdir','categorize','categorize-list',
+        'catfile','catpath','cause','ceiling','cglobal','changed','Channel',
+        'chars','chdir','child','child-name','child-typename','chmod','chomp',
+        'chop','chr','chrs','chunks','cis','classify','classify-list','cleanup',
+        'clone','close','closed','close-stdin','cmp-ok','code','codes','collate',
+        'column','comb','combinations','command','comment','compiler','Complex',
+        'compose','compose_type','composer','condition','config',
+        'configure_destroy','configure_type_checking','conj','connect',
+        'constraints','construct','contains','contents','copy','cos','cosec',
+        'cosech','cosh','cotan','cotanh','count','count-only','cpu-cores',
+        'cpu-usage','CREATE','create_type','cross','cue','curdir','curupdir','d',
+        'Date','DateTime','day','daycount','day-of-month','day-of-week',
+        'day-of-year','days-in-month','declaration','decode','decoder','deepmap',
+        'default','defined','DEFINITE','delayed','DELETE-KEY','DELETE-POS',
+        'denominator','desc','DESTROY','destroyers','devnull','diag',
+        'did-you-mean','die','dies-ok','dir','dirname','dir-sep','DISTROnames',
+        'do','does','does-ok','done','done-testing','duckmap','dynamic','e',
+        'eager','earlier','elems','emit','enclosing','encode','encoder',
+        'encoding','end','ends-with','enum_from_value','enum_value_list',
+        'enum_values','enums','eof','EVAL','eval-dies-ok','EVALFILE',
+        'eval-lives-ok','exception','excludes-max','excludes-min','EXISTS-KEY',
+        'EXISTS-POS','exit','exitcode','exp','expected','explicitly-manage',
+        'expmod','extension','f','fail','fails-like','fc','feature','file',
+        'filename','find_method','find_method_qualified','finish','first','flat',
+        'flatmap','flip','floor','flunk','flush','fmt','format','formatter',
+        'freeze','from','from-list','from-loop','from-posix','full',
+        'full-barrier','get','get_value','getc','gist','got','grab','grabpairs',
+        'grep','handle','handled','handles','hardware','has_accessor','Hash',
+        'head','headers','hh-mm-ss','hidden','hides','hour','how','hyper','id',
+        'illegal','im','in','indent','index','indices','indir','infinite',
+        'infix','infix:<+>','infix:<->','install_method_cache','Instant',
+        'instead','Int','int-bounds','interval','in-timezone','invalid-str',
+        'invert','invocant','IO','IO::Notification.watch-path','is_trusted',
+        'is_type','isa','is-absolute','isa-ok','is-approx','is-deeply',
+        'is-hidden','is-initial-thread','is-int','is-lazy','is-leap-year',
+        'isNaN','isnt','is-prime','is-relative','is-routine','is-setting',
+        'is-win','item','iterator','join','keep','kept','KERNELnames','key',
+        'keyof','keys','kill','kv','kxxv','l','lang','last','lastcall','later',
+        'lazy','lc','leading','level','like','line','lines','link','List',
+        'listen','live','lives-ok','local','lock','log','log10','lookup','lsb',
+        'made','MAIN','make','Map','match','max','maxpairs','merge','message',
+        'method','method_table','methods','migrate','min','minmax','minpairs',
+        'minute','misplaced','Mix','MixHash','mkdir','mode','modified','month',
+        'move','mro','msb','multi','multiness','my','name','named','named_names',
+        'narrow','nativecast','native-descriptor','nativesizeof','new','new_type',
+        'new-from-daycount','new-from-pairs','next','nextcallee','next-handle',
+        'nextsame','nextwith','NFC','NFD','NFKC','NFKD','nl-in','nl-out',
+        'nodemap','nok','none','norm','not','note','now','nude','Num',
+        'numerator','Numeric','of','offset','offset-in-hours','offset-in-minutes',
+        'ok','old','on-close','one','on-switch','open','opened','operation',
+        'optional','ord','ords','orig','os-error','osname','out-buffer','pack',
+        'package','package-kind','package-name','packages','pair','pairs',
+        'pairup','parameter','params','parent','parent-name','parents','parse',
+        'parse-base','parsefile','parse-names','parts','pass','path','path-sep',
+        'payload','peer-host','peer-port','periods','perl','permutations','phaser',
+        'pick','pickpairs','pid','placeholder','plan','plus','polar','poll',
+        'polymod','pop','pos','positional','posix','postfix','postmatch',
+        'precomp-ext','precomp-target','pred','prefix','prematch','prepend',
+        'print','printf','print-nl','print-to','private','private_method_table',
+        'proc','produce','Promise','prompt','protect','pull-one','push',
+        'push-all','push-at-least','push-exactly','push-until-lazy','put',
+        'qualifier-type','quit','r','race','radix','rand','range','Rat','raw',
+        're','read','readchars','readonly','ready','Real','reallocate','reals',
+        'reason','rebless','receive','recv','redispatcher','redo','reduce',
+        'rel2abs','relative','release','rename','repeated','replacement',
+        'report','reserved','resolve','restore','result','resume','rethrow',
+        'reverse','right','rindex','rmdir','role','roles_to_compose','rolish',
+        'roll','rootdir','roots','rotate','rotor','round','roundrobin',
+        'routine-type','run','rwx','s','samecase','samemark','samewith','say',
+        'schedule-on','scheduler','scope','sec','sech','second','seek','self',
+        'send','Set','set_hidden','set_name','set_package','set_rw','set_value',
+        'SetHash','set-instruments','setup_finalization','shape','share','shell',
+        'shift','sibling','sigil','sign','signal','signals','signature','sin',
+        'sinh','sink','sink-all','skip','skip-at-least','skip-at-least-pull-one',
+        'skip-one','skip-rest','sleep','sleep-timer','sleep-until','Slip','slurp',
+        'slurp-rest','slurpy','snap','snapper','so','socket-host','socket-port',
+        'sort','source','source-package','spawn','SPEC','splice','split',
+        'splitdir','splitpath','sprintf','spurt','sqrt','squish','srand','stable',
+        'start','started','starts-with','status','stderr','stdout','Str',
+        'sub_signature','subbuf','subbuf-rw','subname','subparse','subst',
+        'subst-mutate','substr','substr-eq','substr-rw','subtest','succ','sum',
+        'Supply','symlink','t','tail','take','take-rw','tan','tanh','tap',
+        'target','target-name','tc','tclc','tell','then','throttle','throw',
+        'throws-like','timezone','tmpdir','to','today','todo','toggle','to-posix',
+        'total','trailing','trans','tree','trim','trim-leading','trim-trailing',
+        'truncate','truncated-to','trusts','try_acquire','trying','twigil','type',
+        'type_captures','typename','uc','udp','uncaught_handler','unimatch',
+        'uniname','uninames','uniparse','uniprop','uniprops','unique','unival',
+        'univals','unlike','unlink','unlock','unpack','unpolar','unshift',
+        'unwrap','updir','USAGE','use-ok','utc','val','value','values','VAR',
+        'variable','verbose-config','version','VMnames','volume','vow','w','wait',
+        'warn','watch','watch-path','week','weekday-of-month','week-number',
+        'week-year','WHAT','when','WHERE','WHEREFORE','WHICH','WHO',
+        'whole-second','WHY','wordcase','words','workaround','wrap','write',
+        'write-to','x','yada','year','yield','yyyy-mm-dd','z','zip','zip-latest',
+
+    )
+
+    PERL6_BUILTIN_CLASSES = (
+        #Booleans
+        'False','True',
+        #Classes
+        'Any','Array','Associative','AST','atomicint','Attribute','Backtrace',
+        'Backtrace::Frame','Bag','Baggy','BagHash','Blob','Block','Bool','Buf',
+        'Callable','CallFrame','Cancellation','Capture','CArray','Channel','Code',
+        'compiler','Complex','ComplexStr','Cool','CurrentThreadScheduler',
+        'Cursor','Date','Dateish','DateTime','Distro','Duration','Encoding',
+        'Exception','Failure','FatRat','Grammar','Hash','HyperWhatever','Instant',
+        'Int','int16','int32','int64','int8','IntStr','IO','IO::ArgFiles',
+        'IO::CatHandle','IO::Handle','IO::Notification','IO::Path',
+        'IO::Path::Cygwin','IO::Path::QNX','IO::Path::Unix','IO::Path::Win32',
+        'IO::Pipe','IO::Socket','IO::Socket::Async','IO::Socket::INET','IO::Spec',
+        'IO::Spec::Cygwin','IO::Spec::QNX','IO::Spec::Unix','IO::Spec::Win32',
+        'IO::Special','Iterable','Iterator','Junction','Kernel','Label','List',
+        'Lock','Lock::Async','long','longlong','Macro','Map','Match',
+        'Metamodel::AttributeContainer','Metamodel::C3MRO','Metamodel::ClassHOW',
+        'Metamodel::EnumHOW','Metamodel::Finalization','Metamodel::MethodContainer',
+        'Metamodel::MROBasedMethodDispatch','Metamodel::MultipleInheritance',
+        'Metamodel::Naming','Metamodel::Primitives','Metamodel::PrivateMethodContainer',
+        'Metamodel::RoleContainer','Metamodel::Trusting','Method','Mix','MixHash',
+        'Mixy','Mu','NFC','NFD','NFKC','NFKD','Nil','Num','num32','num64',
+        'Numeric','NumStr','ObjAt','Order','Pair','Parameter','Perl','Pod::Block',
+        'Pod::Block::Code','Pod::Block::Comment','Pod::Block::Declarator',
+        'Pod::Block::Named','Pod::Block::Para','Pod::Block::Table','Pod::Heading',
+        'Pod::Item','Pointer','Positional','PositionalBindFailover','Proc',
+        'Proc::Async','Promise','Proxy','PseudoStash','QuantHash','Range','Rat',
+        'Rational','RatStr','Real','Regex','Routine','Scalar','Scheduler',
+        'Semaphore','Seq','Set','SetHash','Setty','Signature','size_t','Slip',
+        'Stash','Str','StrDistance','Stringy','Sub','Submethod','Supplier',
+        'Supplier::Preserving','Supply','Systemic','Tap','Telemetry',
+        'Telemetry::Instrument::Thread','Telemetry::Instrument::Usage',
+        'Telemetry::Period','Telemetry::Sampler','Thread','ThreadPoolScheduler',
+        'UInt','uint16','uint32','uint64','uint8','Uni','utf8','Variable',
+        'Version','VM','Whatever','WhateverCode','WrapHandle'
+    )
+
+    PERL6_OPERATORS = (
+        'X', 'Z', 'after', 'also', 'and', 'andthen', 'before', 'cmp', 'div',
+        'eq', 'eqv', 'extra', 'ff', 'fff', 'ge', 'gt', 'le', 'leg', 'lt', 'm',
+        'mm', 'mod', 'ne', 'or', 'orelse', 'rx', 's', 'tr', 'x', 'xor', 'xx',
+        '++', '--', '**', '!', '+', '-', '~', '?', '|', '||', '+^', '~^', '?^',
+        '^', '*', '/', '%', '%%', '+&', '+<', '+>', '~&', '~<', '~>', '?&',
+        'gcd', 'lcm', '+', '-', '+|', '+^', '~|', '~^', '?|', '?^',
+        '~', '&', '^', 'but', 'does', '<=>', '..', '..^', '^..', '^..^',
+        '!=', '==', '<', '<=', '>', '>=', '~~', '===', '!eqv',
+        '&&', '||', '^^', '//', 'min', 'max', '??', '!!', 'ff', 'fff', 'so',
+        'not', '<==', '==>', '<<==', '==>>','unicmp',
+    )
+
+    # Perl 6 has a *lot* of possible bracketing characters
+    # this list was lifted from STD.pm6 (https://github.com/perl6/std)
+    PERL6_BRACKETS = {
+        '\u0028': '\u0029', '\u003c': '\u003e', '\u005b': '\u005d',
+        '\u007b': '\u007d', '\u00ab': '\u00bb', '\u0f3a': '\u0f3b',
+        '\u0f3c': '\u0f3d', '\u169b': '\u169c', '\u2018': '\u2019',
+        '\u201a': '\u2019', '\u201b': '\u2019', '\u201c': '\u201d',
+        '\u201e': '\u201d', '\u201f': '\u201d', '\u2039': '\u203a',
+        '\u2045': '\u2046', '\u207d': '\u207e', '\u208d': '\u208e',
+        '\u2208': '\u220b', '\u2209': '\u220c', '\u220a': '\u220d',
+        '\u2215': '\u29f5', '\u223c': '\u223d', '\u2243': '\u22cd',
+        '\u2252': '\u2253', '\u2254': '\u2255', '\u2264': '\u2265',
+        '\u2266': '\u2267', '\u2268': '\u2269', '\u226a': '\u226b',
+        '\u226e': '\u226f', '\u2270': '\u2271', '\u2272': '\u2273',
+        '\u2274': '\u2275', '\u2276': '\u2277', '\u2278': '\u2279',
+        '\u227a': '\u227b', '\u227c': '\u227d', '\u227e': '\u227f',
+        '\u2280': '\u2281', '\u2282': '\u2283', '\u2284': '\u2285',
+        '\u2286': '\u2287', '\u2288': '\u2289', '\u228a': '\u228b',
+        '\u228f': '\u2290', '\u2291': '\u2292', '\u2298': '\u29b8',
+        '\u22a2': '\u22a3', '\u22a6': '\u2ade', '\u22a8': '\u2ae4',
+        '\u22a9': '\u2ae3', '\u22ab': '\u2ae5', '\u22b0': '\u22b1',
+        '\u22b2': '\u22b3', '\u22b4': '\u22b5', '\u22b6': '\u22b7',
+        '\u22c9': '\u22ca', '\u22cb': '\u22cc', '\u22d0': '\u22d1',
+        '\u22d6': '\u22d7', '\u22d8': '\u22d9', '\u22da': '\u22db',
+        '\u22dc': '\u22dd', '\u22de': '\u22df', '\u22e0': '\u22e1',
+        '\u22e2': '\u22e3', '\u22e4': '\u22e5', '\u22e6': '\u22e7',
+        '\u22e8': '\u22e9', '\u22ea': '\u22eb', '\u22ec': '\u22ed',
+        '\u22f0': '\u22f1', '\u22f2': '\u22fa', '\u22f3': '\u22fb',
+        '\u22f4': '\u22fc', '\u22f6': '\u22fd', '\u22f7': '\u22fe',
+        '\u2308': '\u2309', '\u230a': '\u230b', '\u2329': '\u232a',
+        '\u23b4': '\u23b5', '\u2768': '\u2769', '\u276a': '\u276b',
+        '\u276c': '\u276d', '\u276e': '\u276f', '\u2770': '\u2771',
+        '\u2772': '\u2773', '\u2774': '\u2775', '\u27c3': '\u27c4',
+        '\u27c5': '\u27c6', '\u27d5': '\u27d6', '\u27dd': '\u27de',
+        '\u27e2': '\u27e3', '\u27e4': '\u27e5', '\u27e6': '\u27e7',
+        '\u27e8': '\u27e9', '\u27ea': '\u27eb', '\u2983': '\u2984',
+        '\u2985': '\u2986', '\u2987': '\u2988', '\u2989': '\u298a',
+        '\u298b': '\u298c', '\u298d': '\u298e', '\u298f': '\u2990',
+        '\u2991': '\u2992', '\u2993': '\u2994', '\u2995': '\u2996',
+        '\u2997': '\u2998', '\u29c0': '\u29c1', '\u29c4': '\u29c5',
+        '\u29cf': '\u29d0', '\u29d1': '\u29d2', '\u29d4': '\u29d5',
+        '\u29d8': '\u29d9', '\u29da': '\u29db', '\u29f8': '\u29f9',
+        '\u29fc': '\u29fd', '\u2a2b': '\u2a2c', '\u2a2d': '\u2a2e',
+        '\u2a34': '\u2a35', '\u2a3c': '\u2a3d', '\u2a64': '\u2a65',
+        '\u2a79': '\u2a7a', '\u2a7d': '\u2a7e', '\u2a7f': '\u2a80',
+        '\u2a81': '\u2a82', '\u2a83': '\u2a84', '\u2a8b': '\u2a8c',
+        '\u2a91': '\u2a92', '\u2a93': '\u2a94', '\u2a95': '\u2a96',
+        '\u2a97': '\u2a98', '\u2a99': '\u2a9a', '\u2a9b': '\u2a9c',
+        '\u2aa1': '\u2aa2', '\u2aa6': '\u2aa7', '\u2aa8': '\u2aa9',
+        '\u2aaa': '\u2aab', '\u2aac': '\u2aad', '\u2aaf': '\u2ab0',
+        '\u2ab3': '\u2ab4', '\u2abb': '\u2abc', '\u2abd': '\u2abe',
+        '\u2abf': '\u2ac0', '\u2ac1': '\u2ac2', '\u2ac3': '\u2ac4',
+        '\u2ac5': '\u2ac6', '\u2acd': '\u2ace', '\u2acf': '\u2ad0',
+        '\u2ad1': '\u2ad2', '\u2ad3': '\u2ad4', '\u2ad5': '\u2ad6',
+        '\u2aec': '\u2aed', '\u2af7': '\u2af8', '\u2af9': '\u2afa',
+        '\u2e02': '\u2e03', '\u2e04': '\u2e05', '\u2e09': '\u2e0a',
+        '\u2e0c': '\u2e0d', '\u2e1c': '\u2e1d', '\u2e20': '\u2e21',
+        '\u3008': '\u3009', '\u300a': '\u300b', '\u300c': '\u300d',
+        '\u300e': '\u300f', '\u3010': '\u3011', '\u3014': '\u3015',
+        '\u3016': '\u3017', '\u3018': '\u3019', '\u301a': '\u301b',
+        '\u301d': '\u301e', '\ufd3e': '\ufd3f', '\ufe17': '\ufe18',
+        '\ufe35': '\ufe36', '\ufe37': '\ufe38', '\ufe39': '\ufe3a',
+        '\ufe3b': '\ufe3c', '\ufe3d': '\ufe3e', '\ufe3f': '\ufe40',
+        '\ufe41': '\ufe42', '\ufe43': '\ufe44', '\ufe47': '\ufe48',
+        '\ufe59': '\ufe5a', '\ufe5b': '\ufe5c', '\ufe5d': '\ufe5e',
+        '\uff08': '\uff09', '\uff1c': '\uff1e', '\uff3b': '\uff3d',
+        '\uff5b': '\uff5d', '\uff5f': '\uff60', '\uff62': '\uff63',
+    }
+
+    def _build_word_match(words, boundary_regex_fragment=None, prefix='', suffix=''):
+        if boundary_regex_fragment is None:
+            return r'\b(' + prefix + r'|'.join(re.escape(x) for x in words) + \
+                suffix + r')\b'
+        else:
+            return r'(? 0:
+                    next_open_pos = text.find(opening_chars, search_pos + n_chars)
+                    next_close_pos = text.find(closing_chars, search_pos + n_chars)
+
+                    if next_close_pos == -1:
+                        next_close_pos = len(text)
+                        nesting_level = 0
+                    elif next_open_pos != -1 and next_open_pos < next_close_pos:
+                        nesting_level += 1
+                        search_pos = next_open_pos
+                    else:  # next_close_pos < next_open_pos
+                        nesting_level -= 1
+                        search_pos = next_close_pos
+
+                end_pos = next_close_pos
+
+            if end_pos < 0:     # if we didn't find a closer, just highlight the
+                                # rest of the text in this class
+                end_pos = len(text)
+
+            if adverbs is not None and re.search(r':to\b', adverbs):
+                heredoc_terminator = text[match.start('delimiter') + n_chars:end_pos]
+                end_heredoc = re.search(r'^\s*' + re.escape(heredoc_terminator) +
+                                        r'\s*$', text[end_pos:], re.MULTILINE)
+
+                if end_heredoc:
+                    end_pos += end_heredoc.end()
+                else:
+                    end_pos = len(text)
+
+            yield match.start(), token_class, text[match.start():end_pos + n_chars]
+            context.pos = end_pos + n_chars
+
+        return callback
+
+    def opening_brace_callback(lexer, match, context):
+        stack = context.stack
+
+        yield match.start(), Text, context.text[match.start():match.end()]
+        context.pos = match.end()
+
+        # if we encounter an opening brace and we're one level
+        # below a token state, it means we need to increment
+        # the nesting level for braces so we know later when
+        # we should return to the token rules.
+        if len(stack) > 2 and stack[-2] == 'token':
+            context.perl6_token_nesting_level += 1
+
+    def closing_brace_callback(lexer, match, context):
+        stack = context.stack
+
+        yield match.start(), Text, context.text[match.start():match.end()]
+        context.pos = match.end()
+
+        # if we encounter a free closing brace and we're one level
+        # below a token state, it means we need to check the nesting
+        # level to see if we need to return to the token state.
+        if len(stack) > 2 and stack[-2] == 'token':
+            context.perl6_token_nesting_level -= 1
+            if context.perl6_token_nesting_level == 0:
+                stack.pop()
+
+    def embedded_perl6_callback(lexer, match, context):
+        context.perl6_token_nesting_level = 1
+        yield match.start(), Text, context.text[match.start():match.end()]
+        context.pos = match.end()
+        context.stack.append('root')
+
+    # If you're modifying these rules, be careful if you need to process '{' or '}'
+    # characters. We have special logic for processing these characters (due to the fact
+    # that you can nest Perl 6 code in regex blocks), so if you need to process one of
+    # them, make sure you also process the corresponding one!
+    tokens = {
+        'common': [
+            (r'#[`|=](?P(?P[' + ''.join(PERL6_BRACKETS) + r'])(?P=first_char)*)',
+             brackets_callback(Comment.Multiline)),
+            (r'#[^\n]*$', Comment.Single),
+            (r'^(\s*)=begin\s+(\w+)\b.*?^\1=end\s+\2', Comment.Multiline),
+            (r'^(\s*)=for.*?\n\s*?\n', Comment.Multiline),
+            (r'^=.*?\n\s*?\n', Comment.Multiline),
+            (r'(regex|token|rule)(\s*' + PERL6_IDENTIFIER_RANGE + '+:sym)',
+             bygroups(Keyword, Name), 'token-sym-brackets'),
+            (r'(regex|token|rule)(?!' + PERL6_IDENTIFIER_RANGE + r')(\s*' + PERL6_IDENTIFIER_RANGE + '+)?',
+             bygroups(Keyword, Name), 'pre-token'),
+            # deal with a special case in the Perl 6 grammar (role q { ... })
+            (r'(role)(\s+)(q)(\s*)', bygroups(Keyword, Whitespace, Name, Whitespace)),
+            (_build_word_match(PERL6_KEYWORDS, PERL6_IDENTIFIER_RANGE), Keyword),
+            (_build_word_match(PERL6_BUILTIN_CLASSES, PERL6_IDENTIFIER_RANGE, suffix='(?::[UD])?'),
+             Name.Builtin),
+            (_build_word_match(PERL6_BUILTINS, PERL6_IDENTIFIER_RANGE), Name.Builtin),
+            # copied from PerlLexer
+            (r'[$@%&][.^:?=!~]?' + PERL6_IDENTIFIER_RANGE + '+(?:<<.*?>>|<.*?>|«.*?»)*',
+             Name.Variable),
+            (r'\$[!/](?:<<.*?>>|<.*?>|«.*?»)*', Name.Variable.Global),
+            (r'::\?\w+', Name.Variable.Global),
+            (r'[$@%&]\*' + PERL6_IDENTIFIER_RANGE + '+(?:<<.*?>>|<.*?>|«.*?»)*',
+             Name.Variable.Global),
+            (r'\$(?:<.*?>)+', Name.Variable),
+            (r'(?:q|qq|Q)[a-zA-Z]?\s*(?P:[\w\s:]+)?\s*(?P(?P[^0-9a-zA-Z:\s])'
+             r'(?P=first_char)*)', brackets_callback(String)),
+            # copied from PerlLexer
+            (r'0_?[0-7]+(_[0-7]+)*', Number.Oct),
+            (r'0x[0-9A-Fa-f]+(_[0-9A-Fa-f]+)*', Number.Hex),
+            (r'0b[01]+(_[01]+)*', Number.Bin),
+            (r'(?i)(\d*(_\d*)*\.\d+(_\d*)*|\d+(_\d*)*\.\d+(_\d*)*)(e[+-]?\d+)?',
+             Number.Float),
+            (r'(?i)\d+(_\d*)*e[+-]?\d+(_\d*)*', Number.Float),
+            (r'\d+(_\d+)*', Number.Integer),
+            (r'(?<=~~)\s*/(?:\\\\|\\/|.)*?/', String.Regex),
+            (r'(?<=[=(,])\s*/(?:\\\\|\\/|.)*?/', String.Regex),
+            (r'm\w+(?=\()', Name),
+            (r'(?:m|ms|rx)\s*(?P:[\w\s:]+)?\s*(?P(?P[^\w:\s])'
+             r'(?P=first_char)*)', brackets_callback(String.Regex)),
+            (r'(?:s|ss|tr)\s*(?::[\w\s:]+)?\s*/(?:\\\\|\\/|.)*?/(?:\\\\|\\/|.)*?/',
+             String.Regex),
+            (r'<[^\s=].*?\S>', String),
+            (_build_word_match(PERL6_OPERATORS), Operator),
+            (r'\w' + PERL6_IDENTIFIER_RANGE + '*', Name),
+            (r"'(\\\\|\\[^\\]|[^'\\])*'", String),
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String),
+        ],
+        'root': [
+            include('common'),
+            (r'\{', opening_brace_callback),
+            (r'\}', closing_brace_callback),
+            (r'.+?', Text),
+        ],
+        'pre-token': [
+            include('common'),
+            (r'\{', Text, ('#pop', 'token')),
+            (r'.+?', Text),
+        ],
+        'token-sym-brackets': [
+            (r'(?P(?P[' + ''.join(PERL6_BRACKETS) + '])(?P=first_char)*)',
+             brackets_callback(Name), ('#pop', 'pre-token')),
+            default(('#pop', 'pre-token')),
+        ],
+        'token': [
+            (r'\}', Text, '#pop'),
+            (r'(?<=:)(?:my|our|state|constant|temp|let).*?;', using(this)),
+            # make sure that quotes in character classes aren't treated as strings
+            (r'<(?:[-!?+.]\s*)?\[.*?\]>', String.Regex),
+            # make sure that '#' characters in quotes aren't treated as comments
+            (r"(?my|our)\s+)?(?:module|class|role|enum|grammar)', line)
+            if class_decl:
+                if saw_perl_decl or class_decl.group('scope') is not None:
+                    return True
+                rating = 0.05
+                continue
+            break
+
+        if ':=' in text:
+            # Same logic as above for PerlLexer
+            rating /= 2
+
+        return rating
+
+    def __init__(self, **options):
+        super().__init__(**options)
+        self.encoding = options.get('encoding', 'utf-8')
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/phix.py b/env/lib/python3.12/site-packages/pygments/lexers/phix.py
new file mode 100644
index 0000000..f0b0377
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/phix.py
@@ -0,0 +1,363 @@
+"""
+    pygments.lexers.phix
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Phix.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, words
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Whitespace
+
+__all__ = ['PhixLexer']
+
+
+class PhixLexer(RegexLexer):
+    """
+    Pygments Lexer for Phix files (.exw).
+    See http://phix.x10.mx
+    """
+
+    name = 'Phix'
+    url = 'http://phix.x10.mx'
+    aliases = ['phix']
+    filenames = ['*.exw']
+    mimetypes = ['text/x-phix']
+    version_added = '2.14'
+
+    flags = re.MULTILINE    # nb: **NOT** re.DOTALL! (totally spanners comment handling)
+
+    preproc = (
+        'ifdef', 'elsifdef', 'elsedef'
+    )
+    # Note these lists are auto-generated by pwa/p2js.exw, when pwa\src\p2js_keywords.e (etc)
+    #     change, though of course subsequent copy/commit/pull requests are all manual steps.
+    types = (
+        'string', 'nullable_string', 'atom_string', 'atom', 'bool', 'boolean',
+        'cdCanvan', 'cdCanvas', 'complex', 'CURLcode', 'dictionary', 'int',
+        'integer', 'Ihandle', 'Ihandles', 'Ihandln', 'mpfr', 'mpq', 'mpz',
+        'mpz_or_string', 'number', 'rid_string', 'seq', 'sequence', 'timedate',
+        'object'
+    )
+    keywords = (
+        'abstract', 'class', 'continue', 'export', 'extends', 'nullable',
+        'private', 'public', 'static', 'struct', 'trace',
+        'and', 'break', 'by', 'case', 'catch', 'const', 'constant', 'debug',
+        'default', 'do', 'else', 'elsif', 'end', 'enum', 'exit', 'fallthru',
+        'fallthrough', 'for', 'forward', 'function', 'global', 'if', 'in',
+        'include', 'js', 'javascript', 'javascript_semantics', 'let', 'not',
+        'or', 'procedure', 'profile', 'profile_time', 'return', 'safe_mode',
+        'switch', 'then', 'to', 'try', 'type', 'type_check', 'until', 'warning',
+        'while', 'with', 'without', 'xor'
+    )
+    routines = (
+        'abort', 'abs', 'adjust_timedate', 'and_bits', 'and_bitsu', 'apply',
+        'append', 'arccos', 'arcsin', 'arctan', 'assert', 'atan2',
+        'atom_to_float32', 'atom_to_float64', 'bankers_rounding', 'beep',
+        'begins', 'binary_search', 'bits_to_int', 'bk_color', 'bytes_to_int',
+        'call_func', 'call_proc', 'cdCanvasActivate', 'cdCanvasArc',
+        'cdCanvasBegin', 'cdCanvasBox', 'cdCanvasChord', 'cdCanvasCircle',
+        'cdCanvasClear', 'cdCanvasEnd', 'cdCanvasFlush', 'cdCanvasFont',
+        'cdCanvasGetImageRGB', 'cdCanvasGetSize', 'cdCanvasGetTextAlignment',
+        'cdCanvasGetTextSize', 'cdCanvasLine', 'cdCanvasMark',
+        'cdCanvasMarkSize', 'cdCanvasMultiLineVectorText', 'cdCanvasPixel',
+        'cdCanvasRect', 'cdCanvasRoundedBox', 'cdCanvasRoundedRect',
+        'cdCanvasSector', 'cdCanvasSetAttribute', 'cdCanvasSetBackground',
+        'cdCanvasSetFillMode', 'cdCanvasSetForeground',
+        'cdCanvasSetInteriorStyle', 'cdCanvasSetLineStyle',
+        'cdCanvasSetLineWidth', 'cdCanvasSetTextAlignment', 'cdCanvasText',
+        'cdCanvasSetTextOrientation', 'cdCanvasGetTextOrientation',
+        'cdCanvasVectorText', 'cdCanvasVectorTextDirection',
+        'cdCanvasVectorTextSize', 'cdCanvasVertex', 'cdCreateCanvas',
+        'cdDecodeAlpha', 'cdDecodeColor', 'cdDecodeColorAlpha', 'cdEncodeAlpha',
+        'cdEncodeColor', 'cdEncodeColorAlpha', 'cdKillCanvas', 'cdVersion',
+        'cdVersionDate', 'ceil', 'change_timezone', 'choose', 'clear_screen',
+        'columnize', 'command_line', 'compare', 'complex_abs', 'complex_add',
+        'complex_arg', 'complex_conjugate', 'complex_cos', 'complex_cosh',
+        'complex_div', 'complex_exp', 'complex_imag', 'complex_inv',
+        'complex_log', 'complex_mul', 'complex_neg', 'complex_new',
+        'complex_norm', 'complex_power', 'complex_rho', 'complex_real',
+        'complex_round', 'complex_sin', 'complex_sinh', 'complex_sprint',
+        'complex_sqrt', 'complex_sub', 'complex_theta', 'concat', 'cos',
+        'crash', 'custom_sort', 'date', 'day_of_week', 'day_of_year',
+        'days_in_month', 'decode_base64', 'decode_flags', 'deep_copy', 'deld',
+        'deserialize', 'destroy_dict', 'destroy_queue', 'destroy_stack',
+        'dict_name', 'dict_size', 'elapsed', 'elapsed_short', 'encode_base64',
+        'equal', 'even', 'exp', 'extract', 'factorial', 'factors',
+        'file_size_k', 'find', 'find_all', 'find_any', 'find_replace', 'filter',
+        'flatten', 'float32_to_atom', 'float64_to_atom', 'floor',
+        'format_timedate', 'free_console', 'from_polar', 'gcd', 'get_file_base',
+        'get_file_extension', 'get_file_name', 'get_file_name_and_path',
+        'get_file_path', 'get_file_path_and_name', 'get_maxprime', 'get_prime',
+        'get_primes', 'get_primes_le', 'get_proper_dir', 'get_proper_path',
+        'get_rand', 'get_routine_info', 'get_test_abort', 'get_test_logfile',
+        'get_test_pause', 'get_test_verbosity', 'get_tzid', 'getd', 'getdd',
+        'getd_all_keys', 'getd_by_index', 'getd_index', 'getd_partial_key',
+        'glAttachShader', 'glBindBuffer', 'glBindTexture', 'glBufferData',
+        'glCanvasSpecialText', 'glClear', 'glClearColor', 'glColor',
+        'glCompileShader', 'glCreateBuffer', 'glCreateProgram',
+        'glCreateShader', 'glCreateTexture', 'glDeleteProgram',
+        'glDeleteShader', 'glDrawArrays', 'glEnable',
+        'glEnableVertexAttribArray', 'glFloat32Array', 'glInt32Array',
+        'glFlush', 'glGetAttribLocation', 'glGetError', 'glGetProgramInfoLog',
+        'glGetProgramParameter', 'glGetShaderInfoLog', 'glGetShaderParameter',
+        'glGetUniformLocation', 'glLinkProgram', 'glLoadIdentity',
+        'glMatrixMode', 'glOrtho', 'glRotatef', 'glShadeModel',
+        'glShaderSource', 'glSimpleA7texcoords', 'glTexImage2Dc',
+        'glTexParameteri', 'glTranslate', 'glUniform1f', 'glUniform1i',
+        'glUniformMatrix4fv', 'glUseProgram', 'glVertex',
+        'glVertexAttribPointer', 'glViewport', 'head', 'hsv_to_rgb', 'iff',
+        'iif', 'include_file', 'incl0de_file', 'insert', 'instance',
+        'int_to_bits', 'int_to_bytes', 'is_dict', 'is_integer', 's_leap_year',
+        'is_prime', 'is_prime2', 'islower', 'isupper', 'Icallback',
+        'iup_isdouble', 'iup_isprint', 'iup_XkeyBase', 'IupAppend', 'IupAlarm',
+        'IupBackgroundBox', 'IupButton', 'IupCalendar', 'IupCanvas',
+        'IupClipboard', 'IupClose', 'IupCloseOnEscape', 'IupControlsOpen',
+        'IupDatePick', 'IupDestroy', 'IupDialog', 'IupDrawArc', 'IupDrawBegin',
+        'IupDrawEnd', 'IupDrawGetSize', 'IupDrawGetTextSize', 'IupDrawLine',
+        'IupDrawRectangle', 'IupDrawText', 'IupExpander', 'IupFill',
+        'IupFlatLabel', 'IupFlatList', 'IupFlatTree', 'IupFlush', 'IupFrame',
+        'IupGetAttribute', 'IupGetAttributeId', 'IupGetAttributePtr',
+        'IupGetBrother', 'IupGetChild', 'IupGetChildCount', 'IupGetClassName',
+        'IupGetDialog', 'IupGetDialogChild', 'IupGetDouble', 'IupGetFocus',
+        'IupGetGlobal', 'IupGetGlobalInt', 'IupGetGlobalIntInt', 'IupGetInt',
+        'IupGetInt2', 'IupGetIntId', 'IupGetIntInt', 'IupGetParent',
+        'IupGLCanvas', 'IupGLCanvasOpen', 'IupGLMakeCurrent', 'IupGraph',
+        'IupHbox', 'IupHide', 'IupImage', 'IupImageRGBA', 'IupItem',
+        'iupKeyCodeToName', 'IupLabel', 'IupLink', 'IupList', 'IupMap',
+        'IupMenu', 'IupMenuItem', 'IupMessage', 'IupMessageDlg', 'IupMultiBox',
+        'IupMultiLine', 'IupNextField', 'IupNormaliser', 'IupOpen',
+        'IupPlayInput', 'IupPopup', 'IupPreviousField', 'IupProgressBar',
+        'IupRadio', 'IupRecordInput', 'IupRedraw', 'IupRefresh',
+        'IupRefreshChildren', 'IupSeparator', 'IupSetAttribute',
+        'IupSetAttributes', 'IupSetAttributeHandle', 'IupSetAttributeId',
+        'IupSetAttributePtr', 'IupSetCallback', 'IupSetCallbacks',
+        'IupSetDouble', 'IupSetFocus', 'IupSetGlobal', 'IupSetGlobalInt',
+        'IupSetGlobalFunction', 'IupSetHandle', 'IupSetInt',
+        'IupSetStrAttribute', 'IupSetStrGlobal', 'IupShow', 'IupShowXY',
+        'IupSplit', 'IupStoreAttribute', 'IupSubmenu', 'IupTable',
+        'IupTableClearSelected', 'IupTableClick_cb', 'IupTableGetSelected',
+        'IupTableResize_cb', 'IupTableSetData', 'IupTabs', 'IupText',
+        'IupTimer', 'IupToggle', 'IupTreeAddNodes', 'IupTreeView', 'IupUpdate',
+        'IupValuator', 'IupVbox', 'join', 'join_by', 'join_path', 'k_perm',
+        'largest', 'lcm', 'length', 'log', 'log10', 'log2', 'lower',
+        'm4_crossProduct', 'm4_inverse', 'm4_lookAt', 'm4_multiply',
+        'm4_normalize', 'm4_perspective', 'm4_subtractVectors', 'm4_xRotate',
+        'm4_yRotate', 'machine_bits', 'machine_word', 'match', 'match_all',
+        'match_replace', 'max', 'maxsq', 'min', 'minsq', 'mod', 'mpfr_add',
+        'mpfr_ceil', 'mpfr_cmp', 'mpfr_cmp_si', 'mpfr_const_pi', 'mpfr_div',
+        'mpfr_div_si', 'mpfr_div_z', 'mpfr_floor', 'mpfr_free', 'mpfr_get_d',
+        'mpfr_get_default_precision', 'mpfr_get_default_rounding_mode',
+        'mpfr_get_fixed', 'mpfr_get_precision', 'mpfr_get_si', 'mpfr_init',
+        'mpfr_inits', 'mpfr_init_set', 'mpfr_init_set_q', 'mpfr_init_set_z',
+        'mpfr_mul', 'mpfr_mul_si', 'mpfr_pow_si', 'mpfr_set', 'mpfr_set_d',
+        'mpfr_set_default_precision', 'mpfr_set_default_rounding_mode',
+        'mpfr_set_precision', 'mpfr_set_q', 'mpfr_set_si', 'mpfr_set_str',
+        'mpfr_set_z', 'mpfr_si_div', 'mpfr_si_sub', 'mpfr_sqrt', 'mpfr_sub',
+        'mpfr_sub_si', 'mpq_abs', 'mpq_add', 'mpq_add_si', 'mpq_canonicalize',
+        'mpq_cmp', 'mpq_cmp_si', 'mpq_div', 'mpq_div_2exp', 'mpq_free',
+        'mpq_get_den', 'mpq_get_num', 'mpq_get_str', 'mpq_init', 'mpq_init_set',
+        'mpq_init_set_si', 'mpq_init_set_str', 'mpq_init_set_z', 'mpq_inits',
+        'mpq_inv', 'mpq_mul', 'mpq_neg', 'mpq_set', 'mpq_set_si', 'mpq_set_str',
+        'mpq_set_z', 'mpq_sub', 'mpz_abs', 'mpz_add', 'mpz_addmul',
+        'mpz_addmul_ui', 'mpz_addmul_si', 'mpz_add_si', 'mpz_add_ui', 'mpz_and',
+        'mpz_bin_uiui', 'mpz_cdiv_q', 'mpz_cmp', 'mpz_cmp_si', 'mpz_divexact',
+        'mpz_divexact_ui', 'mpz_divisible_p', 'mpz_divisible_ui_p', 'mpz_even',
+        'mpz_fac_ui', 'mpz_factorstring', 'mpz_fdiv_q', 'mpz_fdiv_q_2exp',
+        'mpz_fdiv_q_ui', 'mpz_fdiv_qr', 'mpz_fdiv_r', 'mpz_fdiv_ui',
+        'mpz_fib_ui', 'mpz_fib2_ui', 'mpz_fits_atom', 'mpz_fits_integer',
+        'mpz_free', 'mpz_gcd', 'mpz_gcd_ui', 'mpz_get_atom', 'mpz_get_integer',
+        'mpz_get_short_str', 'mpz_get_str', 'mpz_init', 'mpz_init_set',
+        'mpz_inits', 'mpz_invert', 'mpz_lcm', 'mpz_lcm_ui', 'mpz_max',
+        'mpz_min', 'mpz_mod', 'mpz_mod_ui', 'mpz_mul', 'mpz_mul_2exp',
+        'mpz_mul_d', 'mpz_mul_si', 'mpz_neg', 'mpz_nthroot', 'mpz_odd',
+        'mpz_pollard_rho', 'mpz_pow_ui', 'mpz_powm', 'mpz_powm_ui', 'mpz_prime',
+        'mpz_prime_factors', 'mpz_prime_mr', 'mpz_rand', 'mpz_rand_ui',
+        'mpz_re_compose', 'mpz_remove', 'mpz_scan0', 'mpz_scan1', 'mpz_set',
+        'mpz_set_d', 'mpz_set_si', 'mpz_set_str', 'mpz_set_v', 'mpz_sign',
+        'mpz_sizeinbase', 'mpz_sqrt', 'mpz_sub', 'mpz_sub_si', 'mpz_sub_ui',
+        'mpz_si_sub', 'mpz_tdiv_q_2exp', 'mpz_tdiv_r_2exp', 'mpz_tstbit',
+        'mpz_ui_pow_ui', 'mpz_xor', 'named_dict', 'new_dict', 'new_queue',
+        'new_stack', 'not_bits', 'not_bitsu', 'odd', 'or_all', 'or_allu',
+        'or_bits', 'or_bitsu', 'ord', 'ordinal', 'ordinant',
+        'override_timezone', 'pad', 'pad_head', 'pad_tail', 'parse_date_string',
+        'papply', 'peep', 'peepn', 'peep_dict', 'permute', 'permutes',
+        'platform', 'pop', 'popn', 'pop_dict', 'power', 'pp', 'ppEx', 'ppExf',
+        'ppf', 'ppOpt', 'pq_add', 'pq_destroy', 'pq_empty', 'pq_new', 'pq_peek',
+        'pq_pop', 'pq_pop_data', 'pq_size', 'prepend', 'prime_factors',
+        'printf', 'product', 'proper', 'push', 'pushn', 'putd', 'puts',
+        'queue_empty', 'queue_size', 'rand', 'rand_range', 'reinstate',
+        'remainder', 'remove', 'remove_all', 'repeat', 'repeatch', 'replace',
+        'requires', 'reverse', 'rfind', 'rgb', 'rmatch', 'rmdr', 'rnd', 'round',
+        'routine_id', 'scanf', 'serialize', 'series', 'set_rand',
+        'set_test_abort', 'set_test_logfile', 'set_test_module',
+        'set_test_pause', 'set_test_verbosity', 'set_timedate_formats',
+        'set_timezone', 'setd', 'setd_default', 'shorten', 'sha256',
+        'shift_bits', 'shuffle', 'sign', 'sin', 'smallest', 'sort',
+        'sort_columns', 'speak', 'splice', 'split', 'split_any', 'split_by',
+        'sprint', 'sprintf', 'sq_abs', 'sq_add', 'sq_and', 'sq_and_bits',
+        'sq_arccos', 'sq_arcsin', 'sq_arctan', 'sq_atom', 'sq_ceil', 'sq_cmp',
+        'sq_cos', 'sq_div', 'sq_even', 'sq_eq', 'sq_floor', 'sq_floor_div',
+        'sq_ge', 'sq_gt', 'sq_int', 'sq_le', 'sq_log', 'sq_log10', 'sq_log2',
+        'sq_lt', 'sq_max', 'sq_min', 'sq_mod', 'sq_mul', 'sq_ne', 'sq_not',
+        'sq_not_bits', 'sq_odd', 'sq_or', 'sq_or_bits', 'sq_power', 'sq_rand',
+        'sq_remainder', 'sq_rmdr', 'sq_rnd', 'sq_round', 'sq_seq', 'sq_sign',
+        'sq_sin', 'sq_sqrt', 'sq_str', 'sq_sub', 'sq_tan', 'sq_trunc',
+        'sq_uminus', 'sq_xor', 'sq_xor_bits', 'sqrt', 'square_free',
+        'stack_empty', 'stack_size', 'substitute', 'substitute_all', 'sum',
+        'tail', 'tan', 'test_equal', 'test_fail', 'test_false',
+        'test_not_equal', 'test_pass', 'test_summary', 'test_true',
+        'text_color', 'throw', 'time', 'timedate_diff', 'timedelta',
+        'to_integer', 'to_number', 'to_rgb', 'to_string', 'traverse_dict',
+        'traverse_dict_partial_key', 'trim', 'trim_head', 'trim_tail', 'trunc',
+        'tagset', 'tagstart', 'typeof', 'unique', 'unix_dict', 'upper',
+        'utf8_to_utf32', 'utf32_to_utf8', 'version', 'vlookup', 'vslice',
+        'wglGetProcAddress', 'wildcard_file', 'wildcard_match', 'with_rho',
+        'with_theta', 'xml_new_doc', 'xml_new_element', 'xml_set_attribute',
+        'xml_sprint', 'xor_bits', 'xor_bitsu',
+        'accept', 'allocate', 'allocate_string', 'allow_break', 'ARM',
+        'atom_to_float80', 'c_func', 'c_proc', 'call_back', 'chdir',
+        'check_break', 'clearDib', 'close', 'closesocket', 'console',
+        'copy_file', 'create', 'create_directory', 'create_thread',
+        'curl_easy_cleanup', 'curl_easy_get_file', 'curl_easy_init',
+        'curl_easy_perform', 'curl_easy_perform_ex', 'curl_easy_setopt',
+        'curl_easy_strerror', 'curl_global_cleanup', 'curl_global_init',
+        'curl_slist_append', 'curl_slist_free_all', 'current_dir', 'cursor',
+        'define_c_func', 'define_c_proc', 'delete', 'delete_cs', 'delete_file',
+        'dir', 'DLL', 'drawDib', 'drawShadedPolygonToDib', 'ELF32', 'ELF64',
+        'enter_cs', 'eval', 'exit_thread', 'free', 'file_exists', 'final',
+        'float80_to_atom', 'format', 'get_bytes', 'get_file_date',
+        'get_file_size', 'get_file_type', 'get_interpreter', 'get_key',
+        'get_socket_error', 'get_text', 'get_thread_exitcode', 'get_thread_id',
+        'getc', 'getenv', 'gets', 'getsockaddr', 'glBegin', 'glCallList',
+        'glFrustum', 'glGenLists', 'glGetString', 'glLight', 'glMaterial',
+        'glNewList', 'glNormal', 'glPopMatrix', 'glPushMatrix', 'glRotate',
+        'glEnd', 'glEndList', 'glTexImage2D', 'goto', 'GUI', 'icons', 'ilASM',
+        'include_files', 'include_paths', 'init_cs', 'ip_to_string',
+        'IupConfig', 'IupConfigDialogClosed', 'IupConfigDialogShow',
+        'IupConfigGetVariableInt', 'IupConfigLoad', 'IupConfigSave',
+        'IupConfigSetVariableInt', 'IupExitLoop', 'IupFileDlg', 'IupFileList',
+        'IupGLSwapBuffers', 'IupHelp', 'IupLoopStep', 'IupMainLoop',
+        'IupNormalizer', 'IupPlot', 'IupPlotAdd', 'IupPlotBegin', 'IupPlotEnd',
+        'IupPlotInsert', 'IupSaveImage', 'IupTreeGetUserId', 'IupUser',
+        'IupVersion', 'IupVersionDate', 'IupVersionNumber', 'IupVersionShow',
+        'killDib', 'leave_cs', 'listen', 'manifest', 'mem_copy', 'mem_set',
+        'mpfr_gamma', 'mpfr_printf', 'mpfr_sprintf', 'mpz_export', 'mpz_import',
+        'namespace', 'new', 'newDib', 'open', 'open_dll', 'PE32', 'PE64',
+        'peek', 'peek_string', 'peek1s', 'peek1u', 'peek2s', 'peek2u', 'peek4s',
+        'peek4u', 'peek8s', 'peek8u', 'peekNS', 'peekns', 'peeknu', 'poke',
+        'poke2', 'poke4', 'poke8', 'pokeN', 'poke_string', 'poke_wstring',
+        'position', 'progress', 'prompt_number', 'prompt_string', 'read_file',
+        'read_lines', 'recv', 'resume_thread', 'seek', 'select', 'send',
+        'setHandler', 'shutdown', 'sleep', 'SO', 'sockaddr_in', 'socket',
+        'split_path', 'suspend_thread', 'system', 'system_exec', 'system_open',
+        'system_wait', 'task_clock_start', 'task_clock_stop', 'task_create',
+        'task_delay', 'task_list', 'task_schedule', 'task_self', 'task_status',
+        'task_suspend', 'task_yield', 'thread_safe_string', 'try_cs',
+        'utf8_to_utf16', 'utf16_to_utf8', 'utf16_to_utf32', 'utf32_to_utf16',
+        'video_config', 'WSACleanup', 'wait_thread', 'walk_dir', 'where',
+        'write_lines', 'wait_key'
+    )
+    constants = (
+        'ANY_QUEUE', 'ASCENDING', 'BLACK', 'BLOCK_CURSOR', 'BLUE',
+        'BRIGHT_CYAN', 'BRIGHT_BLUE', 'BRIGHT_GREEN', 'BRIGHT_MAGENTA',
+        'BRIGHT_RED', 'BRIGHT_WHITE', 'BROWN', 'C_DWORD', 'C_INT', 'C_POINTER',
+        'C_USHORT', 'C_WORD', 'CD_AMBER', 'CD_BLACK', 'CD_BLUE', 'CD_BOLD',
+        'CD_BOLD_ITALIC', 'CD_BOX', 'CD_CENTER', 'CD_CIRCLE', 'CD_CLOSED_LINES',
+        'CD_CONTINUOUS', 'CD_CUSTOM', 'CD_CYAN', 'CD_DARK_BLUE', 'CD_DARK_CYAN',
+        'CD_DARK_GRAY', 'CD_DARK_GREY', 'CD_DARK_GREEN', 'CD_DARK_MAGENTA',
+        'CD_DARK_RED', 'CD_DARK_YELLOW', 'CD_DASH_DOT', 'CD_DASH_DOT_DOT',
+        'CD_DASHED', 'CD_DBUFFER', 'CD_DEG2RAD', 'CD_DIAMOND', 'CD_DOTTED',
+        'CD_EAST', 'CD_EVENODD', 'CD_FILL', 'CD_GL', 'CD_GRAY', 'CD_GREY',
+        'CD_GREEN', 'CD_HATCH', 'CD_HOLLOW', 'CD_HOLLOW_BOX',
+        'CD_HOLLOW_CIRCLE', 'CD_HOLLOW_DIAMOND', 'CD_INDIGO', 'CD_ITALIC',
+        'CD_IUP', 'CD_IUPDBUFFER', 'CD_LIGHT_BLUE', 'CD_LIGHT_GRAY',
+        'CD_LIGHT_GREY', 'CD_LIGHT_GREEN', 'CD_LIGHT_PARCHMENT', 'CD_MAGENTA',
+        'CD_NAVY', 'CD_NORTH', 'CD_NORTH_EAST', 'CD_NORTH_WEST', 'CD_OLIVE',
+        'CD_OPEN_LINES', 'CD_ORANGE', 'CD_PARCHMENT', 'CD_PATTERN',
+        'CD_PRINTER', 'CD_PURPLE', 'CD_PLAIN', 'CD_PLUS', 'CD_QUERY',
+        'CD_RAD2DEG', 'CD_RED', 'CD_SILVER', 'CD_SOLID', 'CD_SOUTH_EAST',
+        'CD_SOUTH_WEST', 'CD_STAR', 'CD_STIPPLE', 'CD_STRIKEOUT',
+        'CD_UNDERLINE', 'CD_WEST', 'CD_WHITE', 'CD_WINDING', 'CD_VIOLET',
+        'CD_X', 'CD_YELLOW', 'CURLE_OK', 'CURLOPT_MAIL_FROM',
+        'CURLOPT_MAIL_RCPT', 'CURLOPT_PASSWORD', 'CURLOPT_READDATA',
+        'CURLOPT_READFUNCTION', 'CURLOPT_SSL_VERIFYPEER',
+        'CURLOPT_SSL_VERIFYHOST', 'CURLOPT_UPLOAD', 'CURLOPT_URL',
+        'CURLOPT_USE_SSL', 'CURLOPT_USERNAME', 'CURLOPT_VERBOSE',
+        'CURLOPT_WRITEFUNCTION', 'CURLUSESSL_ALL', 'CYAN', 'D_NAME',
+        'D_ATTRIBUTES', 'D_SIZE', 'D_YEAR', 'D_MONTH', 'D_DAY', 'D_HOUR',
+        'D_MINUTE', 'D_SECOND', 'D_CREATION', 'D_LASTACCESS', 'D_MODIFICATION',
+        'DT_YEAR', 'DT_MONTH', 'DT_DAY', 'DT_HOUR', 'DT_MINUTE', 'DT_SECOND',
+        'DT_DOW', 'DT_MSEC', 'DT_DOY', 'DT_GMT', 'EULER', 'E_CODE', 'E_ADDR',
+        'E_LINE', 'E_RTN', 'E_NAME', 'E_FILE', 'E_PATH', 'E_USER', 'false',
+        'False', 'FALSE', 'FIFO_QUEUE', 'FILETYPE_DIRECTORY', 'FILETYPE_FILE',
+        'GET_EOF', 'GET_FAIL', 'GET_IGNORE', 'GET_SUCCESS',
+        'GL_AMBIENT_AND_DIFFUSE', 'GL_ARRAY_BUFFER', 'GL_CLAMP',
+        'GL_CLAMP_TO_BORDER', 'GL_CLAMP_TO_EDGE', 'GL_COLOR_BUFFER_BIT',
+        'GL_COMPILE', 'GL_COMPILE_STATUS', 'GL_CULL_FACE',
+        'GL_DEPTH_BUFFER_BIT', 'GL_DEPTH_TEST', 'GL_EXTENSIONS', 'GL_FLAT',
+        'GL_FLOAT', 'GL_FRAGMENT_SHADER', 'GL_FRONT', 'GL_LIGHT0',
+        'GL_LIGHTING', 'GL_LINEAR', 'GL_LINK_STATUS', 'GL_MODELVIEW',
+        'GL_NEAREST', 'GL_NO_ERROR', 'GL_NORMALIZE', 'GL_POSITION',
+        'GL_PROJECTION', 'GL_QUAD_STRIP', 'GL_QUADS', 'GL_RENDERER',
+        'GL_REPEAT', 'GL_RGB', 'GL_RGBA', 'GL_SMOOTH', 'GL_STATIC_DRAW',
+        'GL_TEXTURE_2D', 'GL_TEXTURE_MAG_FILTER', 'GL_TEXTURE_MIN_FILTER',
+        'GL_TEXTURE_WRAP_S', 'GL_TEXTURE_WRAP_T', 'GL_TRIANGLES',
+        'GL_UNSIGNED_BYTE', 'GL_VENDOR', 'GL_VERSION', 'GL_VERTEX_SHADER',
+        'GRAY', 'GREEN', 'GT_LF_STRIPPED', 'GT_WHOLE_FILE', 'INVLN10',
+        'IUP_CLOSE', 'IUP_CONTINUE', 'IUP_DEFAULT', 'IUP_BLACK', 'IUP_BLUE',
+        'IUP_BUTTON1', 'IUP_BUTTON3', 'IUP_CENTER', 'IUP_CYAN', 'IUP_DARK_BLUE',
+        'IUP_DARK_CYAN', 'IUP_DARK_GRAY', 'IUP_DARK_GREY', 'IUP_DARK_GREEN',
+        'IUP_DARK_MAGENTA', 'IUP_DARK_RED', 'IUP_GRAY', 'IUP_GREY', 'IUP_GREEN',
+        'IUP_IGNORE', 'IUP_INDIGO', 'IUP_MAGENTA', 'IUP_MASK_INT',
+        'IUP_MASK_UINT', 'IUP_MOUSEPOS', 'IUP_NAVY', 'IUP_OLIVE', 'IUP_RECTEXT',
+        'IUP_RED', 'IUP_LIGHT_BLUE', 'IUP_LIGHT_GRAY', 'IUP_LIGHT_GREY',
+        'IUP_LIGHT_GREEN', 'IUP_ORANGE', 'IUP_PARCHMENT', 'IUP_PURPLE',
+        'IUP_SILVER', 'IUP_TEAL', 'IUP_VIOLET', 'IUP_WHITE', 'IUP_YELLOW',
+        'K_BS', 'K_cA', 'K_cC', 'K_cD', 'K_cF5', 'K_cK', 'K_cM', 'K_cN', 'K_cO',
+        'K_cP', 'K_cR', 'K_cS', 'K_cT', 'K_cW', 'K_CR', 'K_DEL', 'K_DOWN',
+        'K_END', 'K_ESC', 'K_F1', 'K_F2', 'K_F3', 'K_F4', 'K_F5', 'K_F6',
+        'K_F7', 'K_F8', 'K_F9', 'K_F10', 'K_F11', 'K_F12', 'K_HOME', 'K_INS',
+        'K_LEFT', 'K_MIDDLE', 'K_PGDN', 'K_PGUP', 'K_RIGHT', 'K_SP', 'K_TAB',
+        'K_UP', 'K_h', 'K_i', 'K_j', 'K_p', 'K_r', 'K_s', 'JS', 'LIFO_QUEUE',
+        'LINUX', 'MAX_HEAP', 'MAGENTA', 'MIN_HEAP', 'Nan', 'NO_CURSOR', 'null',
+        'NULL', 'PI', 'pp_Ascii', 'pp_Brkt', 'pp_Date', 'pp_File', 'pp_FltFmt',
+        'pp_Indent', 'pp_IntCh', 'pp_IntFmt', 'pp_Maxlen', 'pp_Nest',
+        'pp_Pause', 'pp_Q22', 'pp_StrFmt', 'RED', 'SEEK_OK', 'SLASH',
+        'TEST_ABORT', 'TEST_CRASH', 'TEST_PAUSE', 'TEST_PAUSE_FAIL',
+        'TEST_QUIET', 'TEST_SHOW_ALL', 'TEST_SHOW_FAILED', 'TEST_SUMMARY',
+        'true', 'True', 'TRUE', 'VC_SCRNLINES', 'WHITE', 'WINDOWS', 'YELLOW'
+    )
+
+    tokens = {
+        'root': [
+            (r"\s+", Whitespace),
+            (r'/\*|--/\*|#\[', Comment.Multiline, 'comment'),
+            (r'(?://|--|#!).*$', Comment.Single),
+#Alt:
+#           (r'//.*$|--.*$|#!.*$', Comment.Single),
+            (r'"([^"\\]|\\.)*"', String.Other),
+            (r'\'[^\']*\'', String.Other),
+            (r'`[^`]*`', String.Other),
+
+            (words(types, prefix=r'\b', suffix=r'\b'), Name.Function),
+            (words(routines, prefix=r'\b', suffix=r'\b'), Name.Function),
+            (words(preproc, prefix=r'\b', suffix=r'\b'), Keyword.Declaration),
+            (words(keywords, prefix=r'\b', suffix=r'\b'), Keyword.Declaration),
+            (words(constants, prefix=r'\b', suffix=r'\b'), Name.Constant),
+            # Aside: Phix only supports/uses the ascii/non-unicode tilde
+            (r'!=|==|<<|>>|:=|[-~+/*%=<>&^|\.(){},?:\[\]$\\;#]', Operator),
+            (r'[\w-]+', Text)
+        ],
+        'comment': [
+            (r'[^*/#]+', Comment.Multiline),
+            (r'/\*|#\[', Comment.Multiline, '#push'),
+            (r'\*/|#\]', Comment.Multiline, '#pop'),
+            (r'[*/#]', Comment.Multiline)
+        ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/php.py b/env/lib/python3.12/site-packages/pygments/lexers/php.py
new file mode 100644
index 0000000..82d4aeb
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/php.py
@@ -0,0 +1,334 @@
+"""
+    pygments.lexers.php
+    ~~~~~~~~~~~~~~~~~~~
+
+    Lexers for PHP and related languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import Lexer, RegexLexer, include, bygroups, default, \
+    using, this, words, do_insertions, line_re
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Other, Generic
+from pygments.util import get_bool_opt, get_list_opt, shebang_matches
+
+__all__ = ['ZephirLexer', 'PsyshConsoleLexer', 'PhpLexer']
+
+
+class ZephirLexer(RegexLexer):
+    """
+    For Zephir language source code.
+
+    Zephir is a compiled high level language aimed
+    to the creation of C-extensions for PHP.
+    """
+
+    name = 'Zephir'
+    url = 'http://zephir-lang.com/'
+    aliases = ['zephir']
+    filenames = ['*.zep']
+    version_added = '2.0'
+
+    zephir_keywords = ['fetch', 'echo', 'isset', 'empty']
+    zephir_type = ['bit', 'bits', 'string']
+
+    flags = re.DOTALL | re.MULTILINE
+
+    tokens = {
+        'commentsandwhitespace': [
+            (r'\s+', Text),
+            (r'//.*?\n', Comment.Single),
+            (r'/\*.*?\*/', Comment.Multiline)
+        ],
+        'slashstartsregex': [
+            include('commentsandwhitespace'),
+            (r'/(\\.|[^[/\\\n]|\[(\\.|[^\]\\\n])*])+/'
+             r'([gim]+\b|\B)', String.Regex, '#pop'),
+            (r'/', Operator, '#pop'),
+            default('#pop')
+        ],
+        'badregex': [
+            (r'\n', Text, '#pop')
+        ],
+        'root': [
+            (r'^(?=\s|/)', Text, 'slashstartsregex'),
+            include('commentsandwhitespace'),
+            (r'\+\+|--|~|&&|\?|:|\|\||\\(?=\n)|'
+             r'(<<|>>>?|==?|!=?|->|[-<>+*%&|^/])=?', Operator, 'slashstartsregex'),
+            (r'[{(\[;,]', Punctuation, 'slashstartsregex'),
+            (r'[})\].]', Punctuation),
+            (r'(for|in|while|do|break|return|continue|switch|case|default|if|else|loop|'
+             r'require|inline|throw|try|catch|finally|new|delete|typeof|instanceof|void|'
+             r'namespace|use|extends|this|fetch|isset|unset|echo|fetch|likely|unlikely|'
+             r'empty)\b', Keyword, 'slashstartsregex'),
+            (r'(var|let|with|function)\b', Keyword.Declaration, 'slashstartsregex'),
+            (r'(abstract|boolean|bool|char|class|const|double|enum|export|extends|final|'
+             r'native|goto|implements|import|int|string|interface|long|ulong|char|uchar|'
+             r'float|unsigned|private|protected|public|short|static|self|throws|reverse|'
+             r'transient|volatile|readonly)\b', Keyword.Reserved),
+            (r'(true|false|null|undefined)\b', Keyword.Constant),
+            (r'(Array|Boolean|Date|_REQUEST|_COOKIE|_SESSION|'
+             r'_GET|_POST|_SERVER|this|stdClass|range|count|iterator|'
+             r'window)\b', Name.Builtin),
+            (r'[$a-zA-Z_][\w\\]*', Name.Other),
+            (r'[0-9][0-9]*\.[0-9]+([eE][0-9]+)?[fd]?', Number.Float),
+            (r'0x[0-9a-fA-F]+', Number.Hex),
+            (r'[0-9]+', Number.Integer),
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String.Double),
+            (r"'(\\\\|\\[^\\]|[^'\\])*'", String.Single),
+        ]
+    }
+
+
+class PsyshConsoleLexer(Lexer):
+    """
+    For PsySH console output, such as:
+
+    .. sourcecode:: psysh
+
+        >>> $greeting = function($name): string {
+        ...     return "Hello, {$name}";
+        ... };
+        => Closure($name): string {#2371 …3}
+        >>> $greeting('World')
+        => "Hello, World"
+    """
+    name = 'PsySH console session for PHP'
+    url = 'https://psysh.org/'
+    aliases = ['psysh']
+    version_added = '2.7'
+
+    def __init__(self, **options):
+        options['startinline'] = True
+        Lexer.__init__(self, **options)
+
+    def get_tokens_unprocessed(self, text):
+        phplexer = PhpLexer(**self.options)
+        curcode = ''
+        insertions = []
+        for match in line_re.finditer(text):
+            line = match.group()
+            if line.startswith('>>> ') or line.startswith('... '):
+                insertions.append((len(curcode),
+                                   [(0, Generic.Prompt, line[:4])]))
+                curcode += line[4:]
+            elif line.rstrip() == '...':
+                insertions.append((len(curcode),
+                                   [(0, Generic.Prompt, '...')]))
+                curcode += line[3:]
+            else:
+                if curcode:
+                    yield from do_insertions(
+                        insertions, phplexer.get_tokens_unprocessed(curcode))
+                    curcode = ''
+                    insertions = []
+                yield match.start(), Generic.Output, line
+        if curcode:
+            yield from do_insertions(insertions,
+                                     phplexer.get_tokens_unprocessed(curcode))
+
+
+class PhpLexer(RegexLexer):
+    """
+    For PHP source code.
+    For PHP embedded in HTML, use the `HtmlPhpLexer`.
+
+    Additional options accepted:
+
+    `startinline`
+        If given and ``True`` the lexer starts highlighting with
+        php code (i.e.: no starting ``>> from pygments.lexers._php_builtins import MODULES
+            >>> MODULES.keys()
+            ['PHP Options/Info', 'Zip', 'dba', ...]
+
+        In fact the names of those modules match the module names from
+        the php documentation.
+    """
+
+    name = 'PHP'
+    url = 'https://www.php.net/'
+    aliases = ['php', 'php3', 'php4', 'php5']
+    filenames = ['*.php', '*.php[345]', '*.inc']
+    mimetypes = ['text/x-php']
+    version_added = ''
+
+    # Note that a backslash is included, PHP uses a backslash as a namespace
+    # separator.
+    _ident_inner = r'(?:[\\_a-z]|[^\x00-\x7f])(?:[\\\w]|[^\x00-\x7f])*'
+    # But not inside strings.
+    _ident_nons = r'(?:[_a-z]|[^\x00-\x7f])(?:\w|[^\x00-\x7f])*'
+
+    flags = re.IGNORECASE | re.DOTALL | re.MULTILINE
+    tokens = {
+        'root': [
+            (r'<\?(php)?', Comment.Preproc, 'php'),
+            (r'[^<]+', Other),
+            (r'<', Other)
+        ],
+        'php': [
+            (r'\?>', Comment.Preproc, '#pop'),
+            (r'(<<<)([\'"]?)(' + _ident_nons + r')(\2\n.*?\n\s*)(\3)(;?)(\n)',
+             bygroups(String, String, String.Delimiter, String, String.Delimiter,
+                      Punctuation, Text)),
+            (r'\s+', Text),
+            (r'#\[', Punctuation, 'attribute'),
+            (r'#.*?\n', Comment.Single),
+            (r'//.*?\n', Comment.Single),
+            # put the empty comment here, it is otherwise seen as
+            # the start of a docstring
+            (r'/\*\*/', Comment.Multiline),
+            (r'/\*\*.*?\*/', String.Doc),
+            (r'/\*.*?\*/', Comment.Multiline),
+            (r'(->|::)(\s*)(' + _ident_nons + ')',
+             bygroups(Operator, Text, Name.Attribute)),
+            (r'[~!%^&*+=|:.<>/@-]+', Operator),
+            (r'\?', Operator),  # don't add to the charclass above!
+            (r'[\[\]{}();,]+', Punctuation),
+            (r'(new)(\s+)(class)\b', bygroups(Keyword, Text, Keyword)),
+            (r'(class)(\s+)', bygroups(Keyword, Text), 'classname'),
+            (r'(function)(\s*)(?=\()', bygroups(Keyword, Text)),
+            (r'(function)(\s+)(&?)(\s*)',
+             bygroups(Keyword, Text, Operator, Text), 'functionname'),
+            (r'(const)(\s+)(' + _ident_inner + ')',
+             bygroups(Keyword, Text, Name.Constant)),
+            (r'(and|E_PARSE|old_function|E_ERROR|or|as|E_WARNING|parent|'
+             r'eval|PHP_OS|break|exit|case|extends|PHP_VERSION|cfunction|'
+             r'FALSE|print|for|require|continue|foreach|require_once|'
+             r'declare|return|default|static|do|switch|die|stdClass|'
+             r'echo|else|TRUE|elseif|var|empty|if|xor|enddeclare|include|'
+             r'virtual|endfor|include_once|while|endforeach|global|'
+             r'endif|list|endswitch|new|endwhile|not|'
+             r'array|E_ALL|NULL|final|php_user_filter|interface|'
+             r'implements|public|private|protected|abstract|clone|try|'
+             r'catch|throw|this|use|namespace|trait|yield|'
+             r'finally|match)\b', Keyword),
+            (r'(true|false|null)\b', Keyword.Constant),
+            include('magicconstants'),
+            (r'\$\{', Name.Variable, 'variablevariable'),
+            (r'\$+' + _ident_inner, Name.Variable),
+            (_ident_inner, Name.Other),
+            (r'(\d+\.\d*|\d*\.\d+)(e[+-]?[0-9]+)?', Number.Float),
+            (r'\d+e[+-]?[0-9]+', Number.Float),
+            (r'0[0-7]+', Number.Oct),
+            (r'0x[a-f0-9]+', Number.Hex),
+            (r'\d+', Number.Integer),
+            (r'0b[01]+', Number.Bin),
+            (r"'([^'\\]*(?:\\.[^'\\]*)*)'", String.Single),
+            (r'`([^`\\]*(?:\\.[^`\\]*)*)`', String.Backtick),
+            (r'"', String.Double, 'string'),
+        ],
+        'variablevariable': [
+            (r'\}', Name.Variable, '#pop'),
+            include('php')
+        ],
+        'magicfuncs': [
+            # source: http://php.net/manual/en/language.oop5.magic.php
+            (words((
+                '__construct', '__destruct', '__call', '__callStatic', '__get', '__set',
+                '__isset', '__unset', '__sleep', '__wakeup', '__toString', '__invoke',
+                '__set_state', '__clone', '__debugInfo',), suffix=r'\b'),
+             Name.Function.Magic),
+        ],
+        'magicconstants': [
+            # source: http://php.net/manual/en/language.constants.predefined.php
+            (words((
+                '__LINE__', '__FILE__', '__DIR__', '__FUNCTION__', '__CLASS__',
+                '__TRAIT__', '__METHOD__', '__NAMESPACE__',),
+                suffix=r'\b'),
+             Name.Constant),
+        ],
+        'classname': [
+            (_ident_inner, Name.Class, '#pop')
+        ],
+        'functionname': [
+            include('magicfuncs'),
+            (_ident_inner, Name.Function, '#pop'),
+            default('#pop')
+        ],
+        'string': [
+            (r'"', String.Double, '#pop'),
+            (r'[^{$"\\]+', String.Double),
+            (r'\\([nrt"$\\]|[0-7]{1,3}|x[0-9a-f]{1,2})', String.Escape),
+            (r'\$' + _ident_nons + r'(\[\S+?\]|->' + _ident_nons + ')?',
+             String.Interpol),
+            (r'(\{\$\{)(.*?)(\}\})',
+             bygroups(String.Interpol, using(this, _startinline=True),
+                      String.Interpol)),
+            (r'(\{)(\$.*?)(\})',
+             bygroups(String.Interpol, using(this, _startinline=True),
+                      String.Interpol)),
+            (r'(\$\{)(\S+)(\})',
+             bygroups(String.Interpol, Name.Variable, String.Interpol)),
+            (r'[${\\]', String.Double)
+        ],
+        'attribute': [
+            (r'\]', Punctuation, '#pop'),
+            (r'\(', Punctuation, 'attributeparams'),
+            (_ident_inner, Name.Decorator),
+            include('php')
+        ],
+        'attributeparams': [
+            (r'\)', Punctuation, '#pop'),
+            include('php')
+        ],
+    }
+
+    def __init__(self, **options):
+        self.funcnamehighlighting = get_bool_opt(
+            options, 'funcnamehighlighting', True)
+        self.disabledmodules = get_list_opt(
+            options, 'disabledmodules', ['unknown'])
+        self.startinline = get_bool_opt(options, 'startinline', False)
+
+        # private option argument for the lexer itself
+        if '_startinline' in options:
+            self.startinline = options.pop('_startinline')
+
+        # collect activated functions in a set
+        self._functions = set()
+        if self.funcnamehighlighting:
+            from pygments.lexers._php_builtins import MODULES
+            for key, value in MODULES.items():
+                if key not in self.disabledmodules:
+                    self._functions.update(value)
+        RegexLexer.__init__(self, **options)
+
+    def get_tokens_unprocessed(self, text):
+        stack = ['root']
+        if self.startinline:
+            stack.append('php')
+        for index, token, value in \
+                RegexLexer.get_tokens_unprocessed(self, text, stack):
+            if token is Name.Other:
+                if value in self._functions:
+                    yield index, Name.Builtin, value
+                    continue
+            yield index, token, value
+
+    def analyse_text(text):
+        if shebang_matches(text, r'php'):
+            return True
+        rv = 0.0
+        if re.search(r'<\?(?!xml)', text):
+            rv += 0.3
+        return rv
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/pointless.py b/env/lib/python3.12/site-packages/pygments/lexers/pointless.py
new file mode 100644
index 0000000..adedb75
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/pointless.py
@@ -0,0 +1,70 @@
+"""
+    pygments.lexers.pointless
+    ~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Pointless.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, words
+from pygments.token import Comment, Error, Keyword, Name, Number, Operator, \
+    Punctuation, String, Text
+
+__all__ = ['PointlessLexer']
+
+
+class PointlessLexer(RegexLexer):
+    """
+    For Pointless source code.
+    """
+
+    name = 'Pointless'
+    url = 'https://ptls.dev'
+    aliases = ['pointless']
+    filenames = ['*.ptls']
+    version_added = '2.7'
+
+    ops = words([
+        "+", "-", "*", "/", "**", "%", "+=", "-=", "*=",
+        "/=", "**=", "%=", "|>", "=", "==", "!=", "<", ">",
+        "<=", ">=", "=>", "$", "++",
+    ])
+
+    keywords = words([
+        "if", "then", "else", "where", "with", "cond",
+        "case", "and", "or", "not", "in", "as", "for",
+        "requires", "throw", "try", "catch", "when",
+        "yield", "upval",
+    ], suffix=r'\b')
+
+    tokens = {
+        'root': [
+            (r'[ \n\r]+', Text),
+            (r'--.*$', Comment.Single),
+            (r'"""', String, 'multiString'),
+            (r'"', String, 'string'),
+            (r'[\[\](){}:;,.]', Punctuation),
+            (ops, Operator),
+            (keywords, Keyword),
+            (r'\d+|\d*\.\d+', Number),
+            (r'(true|false)\b', Name.Builtin),
+            (r'[A-Z][a-zA-Z0-9]*\b', String.Symbol),
+            (r'output\b', Name.Variable.Magic),
+            (r'(export|import)\b', Keyword.Namespace),
+            (r'[a-z][a-zA-Z0-9]*\b', Name.Variable)
+        ],
+        'multiString': [
+            (r'\\.', String.Escape),
+            (r'"""', String, '#pop'),
+            (r'"', String),
+            (r'[^\\"]+', String),
+        ],
+        'string': [
+            (r'\\.', String.Escape),
+            (r'"', String, '#pop'),
+            (r'\n', Error),
+            (r'[^\\"]+', String),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/pony.py b/env/lib/python3.12/site-packages/pygments/lexers/pony.py
new file mode 100644
index 0000000..055423a
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/pony.py
@@ -0,0 +1,93 @@
+"""
+    pygments.lexers.pony
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Pony and related languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups, words
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation
+
+__all__ = ['PonyLexer']
+
+
+class PonyLexer(RegexLexer):
+    """
+    For Pony source code.
+    """
+
+    name = 'Pony'
+    aliases = ['pony']
+    filenames = ['*.pony']
+    url = 'https://www.ponylang.io'
+    version_added = '2.4'
+
+    _caps = r'(iso|trn|ref|val|box|tag)'
+
+    tokens = {
+        'root': [
+            (r'\n', Text),
+            (r'[^\S\n]+', Text),
+            (r'//.*\n', Comment.Single),
+            (r'/\*', Comment.Multiline, 'nested_comment'),
+            (r'"""(?:.|\n)*?"""', String.Doc),
+            (r'"', String, 'string'),
+            (r'\'.*\'', String.Char),
+            (r'=>|[]{}:().~;,|&!^?[]', Punctuation),
+            (words((
+                'addressof', 'and', 'as', 'consume', 'digestof', 'is', 'isnt',
+                'not', 'or'),
+                suffix=r'\b'),
+             Operator.Word),
+            (r'!=|==|<<|>>|[-+/*%=<>]', Operator),
+            (words((
+                'box', 'break', 'compile_error', 'compile_intrinsic',
+                'continue', 'do', 'else', 'elseif', 'embed', 'end', 'error',
+                'for', 'if', 'ifdef', 'in', 'iso', 'lambda', 'let', 'match',
+                'object', 'recover', 'ref', 'repeat', 'return', 'tag', 'then',
+                'this', 'trn', 'try', 'until', 'use', 'var', 'val', 'where',
+                'while', 'with', '#any', '#read', '#send', '#share'),
+                suffix=r'\b'),
+             Keyword),
+            (r'(actor|class|struct|primitive|interface|trait|type)((?:\s)+)',
+             bygroups(Keyword, Text), 'typename'),
+            (r'(new|fun|be)((?:\s)+)', bygroups(Keyword, Text), 'methodname'),
+            (words((
+                'I8', 'U8', 'I16', 'U16', 'I32', 'U32', 'I64', 'U64', 'I128',
+                'U128', 'ILong', 'ULong', 'ISize', 'USize', 'F32', 'F64',
+                'Bool', 'Pointer', 'None', 'Any', 'Array', 'String',
+                'Iterator'),
+                suffix=r'\b'),
+             Name.Builtin.Type),
+            (r'_?[A-Z]\w*', Name.Type),
+            (r'(\d+\.\d*|\.\d+|\d+)[eE][+-]?\d+', Number.Float),
+            (r'0x[0-9a-fA-F]+', Number.Hex),
+            (r'\d+', Number.Integer),
+            (r'(true|false)\b', Name.Builtin),
+            (r'_\d*', Name),
+            (r'_?[a-z][\w\']*', Name)
+        ],
+        'typename': [
+            (_caps + r'?((?:\s)*)(_?[A-Z]\w*)',
+             bygroups(Keyword, Text, Name.Class), '#pop')
+        ],
+        'methodname': [
+            (_caps + r'?((?:\s)*)(_?[a-z]\w*)',
+             bygroups(Keyword, Text, Name.Function), '#pop')
+        ],
+        'nested_comment': [
+            (r'[^*/]+', Comment.Multiline),
+            (r'/\*', Comment.Multiline, '#push'),
+            (r'\*/', Comment.Multiline, '#pop'),
+            (r'[*/]', Comment.Multiline)
+        ],
+        'string': [
+            (r'"', String, '#pop'),
+            (r'\\"', String),
+            (r'[^\\"]+', String)
+        ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/praat.py b/env/lib/python3.12/site-packages/pygments/lexers/praat.py
new file mode 100644
index 0000000..054f5b6
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/praat.py
@@ -0,0 +1,303 @@
+"""
+    pygments.lexers.praat
+    ~~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for Praat
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, words, bygroups, include
+from pygments.token import Name, Text, Comment, Keyword, String, Punctuation, \
+    Number, Operator, Whitespace
+
+__all__ = ['PraatLexer']
+
+
+class PraatLexer(RegexLexer):
+    """
+    For Praat scripts.
+    """
+
+    name = 'Praat'
+    url = 'http://www.praat.org'
+    aliases = ['praat']
+    filenames = ['*.praat', '*.proc', '*.psc']
+    version_added = '2.1'
+
+    keywords = (
+        'if', 'then', 'else', 'elsif', 'elif', 'endif', 'fi', 'for', 'from', 'to',
+        'endfor', 'endproc', 'while', 'endwhile', 'repeat', 'until', 'select', 'plus',
+        'minus', 'demo', 'assert', 'stopwatch', 'nocheck', 'nowarn', 'noprogress',
+        'editor', 'endeditor', 'clearinfo',
+    )
+
+    functions_string = (
+        'backslashTrigraphsToUnicode', 'chooseDirectory', 'chooseReadFile',
+        'chooseWriteFile', 'date', 'demoKey', 'do', 'environment', 'extractLine',
+        'extractWord', 'fixed', 'info', 'left', 'mid', 'percent', 'readFile', 'replace',
+        'replace_regex', 'right', 'selected', 'string', 'unicodeToBackslashTrigraphs',
+    )
+
+    functions_numeric = (
+        'abs', 'appendFile', 'appendFileLine', 'appendInfo', 'appendInfoLine', 'arccos',
+        'arccosh', 'arcsin', 'arcsinh', 'arctan', 'arctan2', 'arctanh', 'barkToHertz',
+        'beginPause', 'beginSendPraat', 'besselI', 'besselK', 'beta', 'beta2',
+        'binomialP', 'binomialQ', 'boolean', 'ceiling', 'chiSquareP', 'chiSquareQ',
+        'choice', 'comment', 'cos', 'cosh', 'createDirectory', 'deleteFile',
+        'demoClicked', 'demoClickedIn', 'demoCommandKeyPressed',
+        'demoExtraControlKeyPressed', 'demoInput', 'demoKeyPressed',
+        'demoOptionKeyPressed', 'demoShiftKeyPressed', 'demoShow', 'demoWaitForInput',
+        'demoWindowTitle', 'demoX', 'demoY', 'differenceLimensToPhon', 'do', 'editor',
+        'endPause', 'endSendPraat', 'endsWith', 'erb', 'erbToHertz', 'erf', 'erfc',
+        'exitScript', 'exp', 'extractNumber', 'fileReadable', 'fisherP', 'fisherQ',
+        'floor', 'gaussP', 'gaussQ', 'hertzToBark', 'hertzToErb', 'hertzToMel',
+        'hertzToSemitones', 'imax', 'imin', 'incompleteBeta', 'incompleteGammaP', 'index',
+        'index_regex', 'integer', 'invBinomialP', 'invBinomialQ', 'invChiSquareQ', 'invFisherQ',
+        'invGaussQ', 'invSigmoid', 'invStudentQ', 'length', 'ln', 'lnBeta', 'lnGamma',
+        'log10', 'log2', 'max', 'melToHertz', 'min', 'minusObject', 'natural', 'number',
+        'numberOfColumns', 'numberOfRows', 'numberOfSelected', 'objectsAreIdentical',
+        'option', 'optionMenu', 'pauseScript', 'phonToDifferenceLimens', 'plusObject',
+        'positive', 'randomBinomial', 'randomGauss', 'randomInteger', 'randomPoisson',
+        'randomUniform', 'real', 'readFile', 'removeObject', 'rindex', 'rindex_regex',
+        'round', 'runScript', 'runSystem', 'runSystem_nocheck', 'selectObject',
+        'selected', 'semitonesToHertz', 'sentence', 'sentencetext', 'sigmoid', 'sin', 'sinc',
+        'sincpi', 'sinh', 'soundPressureToPhon', 'sqrt', 'startsWith', 'studentP',
+        'studentQ', 'tan', 'tanh', 'text', 'variableExists', 'word', 'writeFile', 'writeFileLine',
+        'writeInfo', 'writeInfoLine',
+    )
+
+    functions_array = (
+        'linear', 'randomGauss', 'randomInteger', 'randomUniform', 'zero',
+    )
+
+    objects = (
+        'Activation', 'AffineTransform', 'AmplitudeTier', 'Art', 'Artword',
+        'Autosegment', 'BarkFilter', 'BarkSpectrogram', 'CCA', 'Categories',
+        'Cepstrogram', 'Cepstrum', 'Cepstrumc', 'ChebyshevSeries', 'ClassificationTable',
+        'Cochleagram', 'Collection', 'ComplexSpectrogram', 'Configuration', 'Confusion',
+        'ContingencyTable', 'Corpus', 'Correlation', 'Covariance',
+        'CrossCorrelationTable', 'CrossCorrelationTables', 'DTW', 'DataModeler',
+        'Diagonalizer', 'Discriminant', 'Dissimilarity', 'Distance', 'Distributions',
+        'DurationTier', 'EEG', 'ERP', 'ERPTier', 'EditCostsTable', 'EditDistanceTable',
+        'Eigen', 'Excitation', 'Excitations', 'ExperimentMFC', 'FFNet', 'FeatureWeights',
+        'FileInMemory', 'FilesInMemory', 'Formant', 'FormantFilter', 'FormantGrid',
+        'FormantModeler', 'FormantPoint', 'FormantTier', 'GaussianMixture', 'HMM',
+        'HMM_Observation', 'HMM_ObservationSequence', 'HMM_State', 'HMM_StateSequence',
+        'Harmonicity', 'ISpline', 'Index', 'Intensity', 'IntensityTier', 'IntervalTier',
+        'KNN', 'KlattGrid', 'KlattTable', 'LFCC', 'LPC', 'Label', 'LegendreSeries',
+        'LinearRegression', 'LogisticRegression', 'LongSound', 'Ltas', 'MFCC', 'MSpline',
+        'ManPages', 'Manipulation', 'Matrix', 'MelFilter', 'MelSpectrogram',
+        'MixingMatrix', 'Movie', 'Network', 'Object', 'OTGrammar', 'OTHistory', 'OTMulti',
+        'PCA', 'PairDistribution', 'ParamCurve', 'Pattern', 'Permutation', 'Photo',
+        'Pitch', 'PitchModeler', 'PitchTier', 'PointProcess', 'Polygon', 'Polynomial',
+        'PowerCepstrogram', 'PowerCepstrum', 'Procrustes', 'RealPoint', 'RealTier',
+        'ResultsMFC', 'Roots', 'SPINET', 'SSCP', 'SVD', 'Salience', 'ScalarProduct',
+        'Similarity', 'SimpleString', 'SortedSetOfString', 'Sound', 'Speaker',
+        'Spectrogram', 'Spectrum', 'SpectrumTier', 'SpeechSynthesizer', 'SpellingChecker',
+        'Strings', 'StringsIndex', 'Table', 'TableOfReal', 'TextGrid', 'TextInterval',
+        'TextPoint', 'TextTier', 'Tier', 'Transition', 'VocalTract', 'VocalTractTier',
+        'Weight', 'WordList',
+    )
+
+    variables_numeric = (
+        'macintosh', 'windows', 'unix', 'praatVersion', 'pi', 'e', 'undefined',
+    )
+
+    variables_string = (
+        'praatVersion', 'tab', 'shellDirectory', 'homeDirectory',
+        'preferencesDirectory', 'newline', 'temporaryDirectory',
+        'defaultDirectory',
+    )
+
+    object_attributes = (
+        'ncol', 'nrow', 'xmin', 'ymin', 'xmax', 'ymax', 'nx', 'ny', 'dx', 'dy',
+    )
+
+    tokens = {
+        'root': [
+            (r'(\s+)(#.*?$)',  bygroups(Whitespace, Comment.Single)),
+            (r'^#.*?$',        Comment.Single),
+            (r';[^\n]*',       Comment.Single),
+            (r'\s+',           Whitespace),
+
+            (r'\bprocedure\b', Keyword,       'procedure_definition'),
+            (r'\bcall\b',      Keyword,       'procedure_call'),
+            (r'@',             Name.Function, 'procedure_call'),
+
+            include('function_call'),
+
+            (words(keywords, suffix=r'\b'), Keyword),
+
+            (r'(\bform\b)(\s+)([^\n]+)',
+             bygroups(Keyword, Whitespace, String), 'old_form'),
+
+            (r'(print(?:line|tab)?|echo|exit|asserterror|pause|send(?:praat|socket)|'
+             r'include|execute|system(?:_nocheck)?)(\s+)',
+             bygroups(Keyword, Whitespace), 'string_unquoted'),
+
+            (r'(goto|label)(\s+)(\w+)', bygroups(Keyword, Whitespace, Name.Label)),
+
+            include('variable_name'),
+            include('number'),
+
+            (r'"', String, 'string'),
+
+            (words((objects), suffix=r'(?=\s+\S+\n)'), Name.Class, 'string_unquoted'),
+
+            (r'\b[A-Z]', Keyword, 'command'),
+            (r'(\.{3}|[)(,])', Punctuation),
+        ],
+        'command': [
+            (r'( ?[\w()-]+ ?)', Keyword),
+
+            include('string_interpolated'),
+
+            (r'\.{3}', Keyword, ('#pop', 'old_arguments')),
+            (r':', Keyword, ('#pop', 'comma_list')),
+            (r'\s', Whitespace, '#pop'),
+        ],
+        'procedure_call': [
+            (r'\s+', Whitespace),
+            (r'([\w.]+)(?:(:)|(?:(\s*)(\()))',
+             bygroups(Name.Function, Punctuation,
+                      Text.Whitespace, Punctuation), '#pop'),
+            (r'([\w.]+)', Name.Function, ('#pop', 'old_arguments')),
+        ],
+        'procedure_definition': [
+            (r'\s', Whitespace),
+            (r'([\w.]+)(\s*?[(:])',
+             bygroups(Name.Function, Whitespace), '#pop'),
+            (r'([\w.]+)([^\n]*)',
+             bygroups(Name.Function, Text), '#pop'),
+        ],
+        'function_call': [
+            (words(functions_string, suffix=r'\$(?=\s*[:(])'), Name.Function, 'function'),
+            (words(functions_array, suffix=r'#(?=\s*[:(])'),   Name.Function, 'function'),
+            (words(functions_numeric, suffix=r'(?=\s*[:(])'),  Name.Function, 'function'),
+        ],
+        'function': [
+            (r'\s+',   Whitespace),
+            (r':',     Punctuation, ('#pop', 'comma_list')),
+            (r'\s*\(', Punctuation, ('#pop', 'comma_list')),
+        ],
+        'comma_list': [
+            (r'(\s*\n\s*)(\.{3})', bygroups(Whitespace, Punctuation)),
+
+            (r'(\s*)(?:([)\]])|(\n))', bygroups(
+                Whitespace, Punctuation, Whitespace), '#pop'),
+
+            (r'\s+', Whitespace),
+            (r'"',   String, 'string'),
+            (r'\b(if|then|else|fi|endif)\b', Keyword),
+
+            include('function_call'),
+            include('variable_name'),
+            include('operator'),
+            include('number'),
+
+            (r'[()]', Text),
+            (r',', Punctuation),
+        ],
+        'old_arguments': [
+            (r'\n', Whitespace, '#pop'),
+
+            include('variable_name'),
+            include('operator'),
+            include('number'),
+
+            (r'"', String, 'string'),
+            (r'[^\n]', Text),
+        ],
+        'number': [
+            (r'\n', Whitespace, '#pop'),
+            (r'\b\d+(\.\d*)?([eE][-+]?\d+)?%?', Number),
+        ],
+        'object_reference': [
+            include('string_interpolated'),
+            (r'([a-z][a-zA-Z0-9_]*|\d+)', Name.Builtin),
+
+            (words(object_attributes, prefix=r'\.'), Name.Builtin, '#pop'),
+
+            (r'\$', Name.Builtin),
+            (r'\[', Text, '#pop'),
+        ],
+        'variable_name': [
+            include('operator'),
+            include('number'),
+
+            (words(variables_string,  suffix=r'\$'), Name.Variable.Global),
+            (words(variables_numeric,
+             suffix=r'(?=[^a-zA-Z0-9_."\'$#\[:(]|\s|^|$)'),
+             Name.Variable.Global),
+
+            (words(objects, prefix=r'\b', suffix=r"(_)"),
+             bygroups(Name.Builtin, Name.Builtin),
+             'object_reference'),
+
+            (r'\.?_?[a-z][\w.]*(\$|#)?', Text),
+            (r'[\[\]]', Punctuation, 'comma_list'),
+
+            include('string_interpolated'),
+        ],
+        'operator': [
+            (r'([+\/*<>=!-]=?|[&*|][&*|]?|\^|<>)',       Operator),
+            (r'(?', Punctuation),
+            (r'"(?:\\x[0-9a-fA-F]+\\|\\u[0-9a-fA-F]{4}|\\U[0-9a-fA-F]{8}|'
+             r'\\[0-7]+\\|\\["\\abcefnrstv]|[^\\"])*"', String.Double),
+            (r"'(?:''|[^'])*'", String.Atom),  # quoted atom
+            # Needs to not be followed by an atom.
+            # (r'=(?=\s|[a-zA-Z\[])', Operator),
+            (r'is\b', Operator),
+            (r'(<|>|=<|>=|==|=:=|=|/|//|\*|\+|-)(?=\s|[a-zA-Z0-9\[])',
+             Operator),
+            (r'(mod|div|not)\b', Operator),
+            (r'_', Keyword),  # The don't-care variable
+            (r'([a-z]+)(:)', bygroups(Name.Namespace, Punctuation)),
+            (r'([a-z\u00c0-\u1fff\u3040-\ud7ff\ue000-\uffef]'
+             r'[\w$\u00c0-\u1fff\u3040-\ud7ff\ue000-\uffef]*)'
+             r'(\s*)(:-|-->)',
+             bygroups(Name.Function, Text, Operator)),  # function defn
+            (r'([a-z\u00c0-\u1fff\u3040-\ud7ff\ue000-\uffef]'
+             r'[\w$\u00c0-\u1fff\u3040-\ud7ff\ue000-\uffef]*)'
+             r'(\s*)(\()',
+             bygroups(Name.Function, Text, Punctuation)),
+            (r'[a-z\u00c0-\u1fff\u3040-\ud7ff\ue000-\uffef]'
+             r'[\w$\u00c0-\u1fff\u3040-\ud7ff\ue000-\uffef]*',
+             String.Atom),  # atom, characters
+            # This one includes !
+            (r'[#&*+\-./:<=>?@\\^~\u00a1-\u00bf\u2010-\u303f]+',
+             String.Atom),  # atom, graphics
+            (r'[A-Z_]\w*', Name.Variable),
+            (r'\s+|[\u2000-\u200f\ufff0-\ufffe\uffef]', Text),
+        ],
+        'nested-comment': [
+            (r'\*/', Comment.Multiline, '#pop'),
+            (r'/\*', Comment.Multiline, '#push'),
+            (r'[^*/]+', Comment.Multiline),
+            (r'[*/]', Comment.Multiline),
+        ],
+    }
+
+    def analyse_text(text):
+        """Competes with IDL and Visual Prolog on *.pro"""
+        if ':-' in text:
+            # Visual Prolog also uses :-
+            return 0.5
+        else:
+            return 0
+
+
+class LogtalkLexer(RegexLexer):
+    """
+    For Logtalk source code.
+    """
+
+    name = 'Logtalk'
+    url = 'http://logtalk.org/'
+    aliases = ['logtalk']
+    filenames = ['*.lgt', '*.logtalk']
+    mimetypes = ['text/x-logtalk']
+    version_added = '0.10'
+
+    tokens = {
+        'root': [
+            # Directives
+            (r'^\s*:-\s', Punctuation, 'directive'),
+            # Comments
+            (r'%.*?\n', Comment),
+            (r'/\*(.|\n)*?\*/', Comment),
+            # Whitespace
+            (r'\n', Text),
+            (r'\s+', Text),
+            # Numbers
+            (r"0'[\\]?.", Number),
+            (r'0b[01]+', Number.Bin),
+            (r'0o[0-7]+', Number.Oct),
+            (r'0x[0-9a-fA-F]+', Number.Hex),
+            (r'\d+\.?\d*((e|E)(\+|-)?\d+)?', Number),
+            # Variables
+            (r'([A-Z_][a-zA-Z0-9_]*)', Name.Variable),
+            # Event handlers
+            (r'(after|before)(?=[(])', Keyword),
+            # Message forwarding handler
+            (r'forward(?=[(])', Keyword),
+            # Execution-context methods
+            (r'(context|parameter|this|se(lf|nder))(?=[(])', Keyword),
+            # Reflection
+            (r'(current_predicate|predicate_property)(?=[(])', Keyword),
+            # DCGs and term expansion
+            (r'(expand_(goal|term)|(goal|term)_expansion|phrase)(?=[(])', Keyword),
+            # Entity
+            (r'(abolish|c(reate|urrent))_(object|protocol|category)(?=[(])', Keyword),
+            (r'(object|protocol|category)_property(?=[(])', Keyword),
+            # Entity relations
+            (r'co(mplements_object|nforms_to_protocol)(?=[(])', Keyword),
+            (r'extends_(object|protocol|category)(?=[(])', Keyword),
+            (r'imp(lements_protocol|orts_category)(?=[(])', Keyword),
+            (r'(instantiat|specializ)es_class(?=[(])', Keyword),
+            # Events
+            (r'(current_event|(abolish|define)_events)(?=[(])', Keyword),
+            # Flags
+            (r'(create|current|set)_logtalk_flag(?=[(])', Keyword),
+            # Compiling, loading, and library paths
+            (r'logtalk_(compile|l(ibrary_path|oad|oad_context)|make(_target_action)?)(?=[(])', Keyword),
+            (r'\blogtalk_make\b', Keyword),
+            # Database
+            (r'(clause|retract(all)?)(?=[(])', Keyword),
+            (r'a(bolish|ssert(a|z))(?=[(])', Keyword),
+            # Control constructs
+            (r'(ca(ll|tch)|throw)(?=[(])', Keyword),
+            (r'(fa(il|lse)|true|(instantiation|system)_error)\b', Keyword),
+            (r'(uninstantiation|type|domain|existence|permission|representation|evaluation|resource|syntax)_error(?=[(])', Keyword),
+            # All solutions
+            (r'((bag|set)of|f(ind|or)all)(?=[(])', Keyword),
+            # Multi-threading predicates
+            (r'threaded(_(ca(ll|ncel)|once|ignore|exit|peek|wait|notify))?(?=[(])', Keyword),
+            # Engine predicates
+            (r'threaded_engine(_(create|destroy|self|next|next_reified|yield|post|fetch))?(?=[(])', Keyword),
+            # Term unification
+            (r'(subsumes_term|unify_with_occurs_check)(?=[(])', Keyword),
+            # Term creation and decomposition
+            (r'(functor|arg|copy_term|numbervars|term_variables)(?=[(])', Keyword),
+            # Evaluable functors
+            (r'(div|rem|m(ax|in|od)|abs|sign)(?=[(])', Keyword),
+            (r'float(_(integer|fractional)_part)?(?=[(])', Keyword),
+            (r'(floor|t(an|runcate)|round|ceiling)(?=[(])', Keyword),
+            # Other arithmetic functors
+            (r'(cos|a(cos|sin|tan|tan2)|exp|log|s(in|qrt)|xor)(?=[(])', Keyword),
+            # Term testing
+            (r'(var|atom(ic)?|integer|float|c(allable|ompound)|n(onvar|umber)|ground|acyclic_term)(?=[(])', Keyword),
+            # Term comparison
+            (r'compare(?=[(])', Keyword),
+            # Stream selection and control
+            (r'(curren|se)t_(in|out)put(?=[(])', Keyword),
+            (r'(open|close)(?=[(])', Keyword),
+            (r'flush_output(?=[(])', Keyword),
+            (r'(at_end_of_stream|flush_output)\b', Keyword),
+            (r'(stream_property|at_end_of_stream|set_stream_position)(?=[(])', Keyword),
+            # Character and byte input/output
+            (r'(nl|(get|peek|put)_(byte|c(har|ode)))(?=[(])', Keyword),
+            (r'\bnl\b', Keyword),
+            # Term input/output
+            (r'read(_term)?(?=[(])', Keyword),
+            (r'write(q|_(canonical|term))?(?=[(])', Keyword),
+            (r'(current_)?op(?=[(])', Keyword),
+            (r'(current_)?char_conversion(?=[(])', Keyword),
+            # Atomic term processing
+            (r'atom_(length|c(hars|o(ncat|des)))(?=[(])', Keyword),
+            (r'(char_code|sub_atom)(?=[(])', Keyword),
+            (r'number_c(har|ode)s(?=[(])', Keyword),
+            # Implementation defined hooks functions
+            (r'(se|curren)t_prolog_flag(?=[(])', Keyword),
+            (r'\bhalt\b', Keyword),
+            (r'halt(?=[(])', Keyword),
+            # Message sending operators
+            (r'(::|:|\^\^)', Operator),
+            # External call
+            (r'[{}]', Keyword),
+            # Logic and control
+            (r'(ignore|once)(?=[(])', Keyword),
+            (r'\brepeat\b', Keyword),
+            # Sorting
+            (r'(key)?sort(?=[(])', Keyword),
+            # Bitwise functors
+            (r'(>>|<<|/\\|\\\\|\\)', Operator),
+            # Predicate aliases
+            (r'\bas\b', Operator),
+            # Arithmetic evaluation
+            (r'\bis\b', Keyword),
+            # Arithmetic comparison
+            (r'(=:=|=\\=|<|=<|>=|>)', Operator),
+            # Term creation and decomposition
+            (r'=\.\.', Operator),
+            # Term unification
+            (r'(=|\\=)', Operator),
+            # Term comparison
+            (r'(==|\\==|@=<|@<|@>=|@>)', Operator),
+            # Evaluable functors
+            (r'(//|[-+*/])', Operator),
+            (r'\b(e|pi|div|mod|rem)\b', Operator),
+            # Other arithmetic functors
+            (r'\b\*\*\b', Operator),
+            # DCG rules
+            (r'-->', Operator),
+            # Control constructs
+            (r'([!;]|->)', Operator),
+            # Logic and control
+            (r'\\+', Operator),
+            # Mode operators
+            (r'[?@]', Operator),
+            # Existential quantifier
+            (r'\^', Operator),
+            # Punctuation
+            (r'[()\[\],.|]', Text),
+            # Atoms
+            (r"[a-z][a-zA-Z0-9_]*", Text),
+            (r"'", String, 'quoted_atom'),
+            # Double-quoted terms
+            (r'"', String, 'double_quoted_term'),
+        ],
+
+        'quoted_atom': [
+            (r"''", String),
+            (r"'", String, '#pop'),
+            (r'\\([\\abfnrtv"\']|(x[a-fA-F0-9]+|[0-7]+)\\)', String.Escape),
+            (r"[^\\'\n]+", String),
+            (r'\\', String),
+        ],
+
+        'double_quoted_term': [
+            (r'""', String),
+            (r'"', String, '#pop'),
+            (r'\\([\\abfnrtv"\']|(x[a-fA-F0-9]+|[0-7]+)\\)', String.Escape),
+            (r'[^\\"\n]+', String),
+            (r'\\', String),
+        ],
+
+        'directive': [
+            # Conditional compilation directives
+            (r'(el)?if(?=[(])', Keyword, 'root'),
+            (r'(e(lse|ndif))(?=[.])', Keyword, 'root'),
+            # Entity directives
+            (r'(category|object|protocol)(?=[(])', Keyword, 'entityrelations'),
+            (r'(end_(category|object|protocol))(?=[.])', Keyword, 'root'),
+            # Predicate scope directives
+            (r'(public|protected|private)(?=[(])', Keyword, 'root'),
+            # Other directives
+            (r'e(n(coding|sure_loaded)|xport)(?=[(])', Keyword, 'root'),
+            (r'in(clude|itialization|fo)(?=[(])', Keyword, 'root'),
+            (r'(built_in|dynamic|synchronized|threaded)(?=[.])', Keyword, 'root'),
+            (r'(alias|d(ynamic|iscontiguous)|m(eta_(non_terminal|predicate)|ode|ultifile)|s(et_(logtalk|prolog)_flag|ynchronized))(?=[(])', Keyword, 'root'),
+            (r'op(?=[(])', Keyword, 'root'),
+            (r'(c(alls|oinductive)|module|reexport|use(s|_module))(?=[(])', Keyword, 'root'),
+            (r'[a-z][a-zA-Z0-9_]*(?=[(])', Text, 'root'),
+            (r'[a-z][a-zA-Z0-9_]*(?=[.])', Text, 'root'),
+        ],
+
+        'entityrelations': [
+            (r'(complements|extends|i(nstantiates|mp(lements|orts))|specializes)(?=[(])', Keyword),
+            # Numbers
+            (r"0'[\\]?.", Number),
+            (r'0b[01]+', Number.Bin),
+            (r'0o[0-7]+', Number.Oct),
+            (r'0x[0-9a-fA-F]+', Number.Hex),
+            (r'\d+\.?\d*((e|E)(\+|-)?\d+)?', Number),
+            # Variables
+            (r'([A-Z_][a-zA-Z0-9_]*)', Name.Variable),
+            # Atoms
+            (r"[a-z][a-zA-Z0-9_]*", Text),
+            (r"'", String, 'quoted_atom'),
+            # Double-quoted terms
+            (r'"', String, 'double_quoted_term'),
+            # End of entity-opening directive
+            (r'([)]\.)', Text, 'root'),
+            # Scope operator
+            (r'(::)', Operator),
+            # Punctuation
+            (r'[()\[\],.|]', Text),
+            # Comments
+            (r'%.*?\n', Comment),
+            (r'/\*(.|\n)*?\*/', Comment),
+            # Whitespace
+            (r'\n', Text),
+            (r'\s+', Text),
+        ]
+    }
+
+    def analyse_text(text):
+        if ':- object(' in text:
+            return 1.0
+        elif ':- protocol(' in text:
+            return 1.0
+        elif ':- category(' in text:
+            return 1.0
+        elif re.search(r'^:-\s[a-z]', text, re.M):
+            return 0.9
+        else:
+            return 0.0
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/promql.py b/env/lib/python3.12/site-packages/pygments/lexers/promql.py
new file mode 100644
index 0000000..cad3c25
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/promql.py
@@ -0,0 +1,176 @@
+"""
+    pygments.lexers.promql
+    ~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for Prometheus Query Language.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups, default, words
+from pygments.token import Comment, Keyword, Name, Number, Operator, \
+    Punctuation, String, Whitespace
+
+__all__ = ["PromQLLexer"]
+
+
+class PromQLLexer(RegexLexer):
+    """
+    For PromQL queries.
+
+    For details about the grammar see:
+    https://github.com/prometheus/prometheus/tree/master/promql/parser
+
+    .. versionadded: 2.7
+    """
+
+    name = "PromQL"
+    url = 'https://prometheus.io/docs/prometheus/latest/querying/basics/'
+    aliases = ["promql"]
+    filenames = ["*.promql"]
+    version_added = ''
+
+    base_keywords = (
+        words(
+            (
+                "bool",
+                "by",
+                "group_left",
+                "group_right",
+                "ignoring",
+                "offset",
+                "on",
+                "without",
+            ),
+            suffix=r"\b",
+        ),
+        Keyword,
+    )
+
+    aggregator_keywords = (
+        words(
+            (
+                "sum",
+                "min",
+                "max",
+                "avg",
+                "group",
+                "stddev",
+                "stdvar",
+                "count",
+                "count_values",
+                "bottomk",
+                "topk",
+                "quantile",
+            ),
+            suffix=r"\b",
+        ),
+        Keyword,
+    )
+
+    function_keywords = (
+        words(
+            (
+                "abs",
+                "absent",
+                "absent_over_time",
+                "avg_over_time",
+                "ceil",
+                "changes",
+                "clamp_max",
+                "clamp_min",
+                "count_over_time",
+                "day_of_month",
+                "day_of_week",
+                "days_in_month",
+                "delta",
+                "deriv",
+                "exp",
+                "floor",
+                "histogram_quantile",
+                "holt_winters",
+                "hour",
+                "idelta",
+                "increase",
+                "irate",
+                "label_join",
+                "label_replace",
+                "ln",
+                "log10",
+                "log2",
+                "max_over_time",
+                "min_over_time",
+                "minute",
+                "month",
+                "predict_linear",
+                "quantile_over_time",
+                "rate",
+                "resets",
+                "round",
+                "scalar",
+                "sort",
+                "sort_desc",
+                "sqrt",
+                "stddev_over_time",
+                "stdvar_over_time",
+                "sum_over_time",
+                "time",
+                "timestamp",
+                "vector",
+                "year",
+            ),
+            suffix=r"\b",
+        ),
+        Keyword.Reserved,
+    )
+
+    tokens = {
+        "root": [
+            (r"\n", Whitespace),
+            (r"\s+", Whitespace),
+            (r",", Punctuation),
+            # Keywords
+            base_keywords,
+            aggregator_keywords,
+            function_keywords,
+            # Offsets
+            (r"[1-9][0-9]*[smhdwy]", String),
+            # Numbers
+            (r"-?[0-9]+\.[0-9]+", Number.Float),
+            (r"-?[0-9]+", Number.Integer),
+            # Comments
+            (r"#.*?$", Comment.Single),
+            # Operators
+            (r"(\+|\-|\*|\/|\%|\^)", Operator),
+            (r"==|!=|>=|<=|<|>", Operator),
+            (r"and|or|unless", Operator.Word),
+            # Metrics
+            (r"[_a-zA-Z][a-zA-Z0-9_]+", Name.Variable),
+            # Params
+            (r'(["\'])(.*?)(["\'])', bygroups(Punctuation, String, Punctuation)),
+            # Other states
+            (r"\(", Operator, "function"),
+            (r"\)", Operator),
+            (r"\{", Punctuation, "labels"),
+            (r"\[", Punctuation, "range"),
+        ],
+        "labels": [
+            (r"\}", Punctuation, "#pop"),
+            (r"\n", Whitespace),
+            (r"\s+", Whitespace),
+            (r",", Punctuation),
+            (r'([_a-zA-Z][a-zA-Z0-9_]*?)(\s*?)(=~|!=|=|!~)(\s*?)("|\')(.*?)("|\')',
+             bygroups(Name.Label, Whitespace, Operator, Whitespace,
+                      Punctuation, String, Punctuation)),
+        ],
+        "range": [
+            (r"\]", Punctuation, "#pop"),
+            (r"[1-9][0-9]*[smhdwy]", String),
+        ],
+        "function": [
+            (r"\)", Operator, "#pop"),
+            (r"\(", Operator, "#push"),
+            default("#pop"),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/prql.py b/env/lib/python3.12/site-packages/pygments/lexers/prql.py
new file mode 100644
index 0000000..ee95d2d
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/prql.py
@@ -0,0 +1,251 @@
+"""
+    pygments.lexers.prql
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for the PRQL query language.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, combined, words, include, bygroups
+from pygments.token import Comment, Literal, Keyword, Name, Number, Operator, \
+    Punctuation, String, Text, Whitespace
+
+__all__ = ['PrqlLexer']
+
+
+class PrqlLexer(RegexLexer):
+    """
+    For PRQL source code.
+
+    grammar: https://github.com/PRQL/prql/tree/main/grammars
+    """
+
+    name = 'PRQL'
+    url = 'https://prql-lang.org/'
+    aliases = ['prql']
+    filenames = ['*.prql']
+    mimetypes = ['application/prql', 'application/x-prql']
+    version_added = '2.17'
+
+    builtinTypes = words((
+        "bool",
+        "int",
+        "int8", "int16", "int32", "int64", "int128",
+        "float",
+        "text",
+        "set"), suffix=r'\b')
+
+    def innerstring_rules(ttype):
+        return [
+            # the new style '{}'.format(...) string formatting
+            (r'\{'
+             r'((\w+)((\.\w+)|(\[[^\]]+\]))*)?'  # field name
+             r'(\:(.?[<>=\^])?[-+ ]?#?0?(\d+)?,?(\.\d+)?[E-GXb-gnosx%]?)?'
+             r'\}', String.Interpol),
+
+            (r'[^\\\'"%{\n]+', ttype),
+            (r'[\'"\\]', ttype),
+            (r'%|(\{{1,2})', ttype)
+        ]
+
+    def fstring_rules(ttype):
+        return [
+            (r'\}', String.Interpol),
+            (r'\{', String.Interpol, 'expr-inside-fstring'),
+            (r'[^\\\'"{}\n]+', ttype),
+            (r'[\'"\\]', ttype),
+        ]
+
+    tokens = {
+        'root': [
+
+            # Comments
+            (r'#!.*', String.Doc),
+            (r'#.*', Comment.Single),
+
+            # Whitespace
+            (r'\s+', Whitespace),
+
+            # Modules
+            (r'^(\s*)(module)(\s*)',
+             bygroups(Whitespace, Keyword.Namespace, Whitespace),
+             'imports'),
+
+            (builtinTypes, Keyword.Type),
+
+            # Main
+            (r'^prql ', Keyword.Reserved),
+
+            ('let', Keyword.Declaration),
+
+            include('keywords'),
+            include('expr'),
+
+            # Transforms
+            (r'^[A-Za-z_][a-zA-Z0-9_]*', Keyword),
+        ],
+        'expr': [
+            # non-raw f-strings
+            ('(f)(""")', bygroups(String.Affix, String.Double),
+             combined('fstringescape', 'tdqf')),
+            ("(f)(''')", bygroups(String.Affix, String.Single),
+             combined('fstringescape', 'tsqf')),
+            ('(f)(")', bygroups(String.Affix, String.Double),
+             combined('fstringescape', 'dqf')),
+            ("(f)(')", bygroups(String.Affix, String.Single),
+             combined('fstringescape', 'sqf')),
+
+            # non-raw s-strings
+            ('(s)(""")', bygroups(String.Affix, String.Double),
+             combined('stringescape', 'tdqf')),
+            ("(s)(''')", bygroups(String.Affix, String.Single),
+             combined('stringescape', 'tsqf')),
+            ('(s)(")', bygroups(String.Affix, String.Double),
+             combined('stringescape', 'dqf')),
+            ("(s)(')", bygroups(String.Affix, String.Single),
+             combined('stringescape', 'sqf')),
+
+            # raw strings
+            ('(?i)(r)(""")',
+             bygroups(String.Affix, String.Double), 'tdqs'),
+            ("(?i)(r)(''')",
+             bygroups(String.Affix, String.Single), 'tsqs'),
+            ('(?i)(r)(")',
+             bygroups(String.Affix, String.Double), 'dqs'),
+            ("(?i)(r)(')",
+             bygroups(String.Affix, String.Single), 'sqs'),
+
+            # non-raw strings
+            ('"""', String.Double, combined('stringescape', 'tdqs')),
+            ("'''", String.Single, combined('stringescape', 'tsqs')),
+            ('"', String.Double, combined('stringescape', 'dqs')),
+            ("'", String.Single, combined('stringescape', 'sqs')),
+
+            # Time and dates
+            (r'@\d{4}-\d{2}-\d{2}T\d{2}(:\d{2})?(:\d{2})?(\.\d{1,6})?(Z|[+-]\d{1,2}(:\d{1,2})?)?', Literal.Date),
+            (r'@\d{4}-\d{2}-\d{2}', Literal.Date),
+            (r'@\d{2}(:\d{2})?(:\d{2})?(\.\d{1,6})?(Z|[+-]\d{1,2}(:\d{1,2})?)?', Literal.Date),
+
+            (r'[^\S\n]+', Text),
+            include('numbers'),
+            (r'->|=>|==|!=|>=|<=|~=|&&|\|\||\?\?|\/\/', Operator),
+            (r'[-~+/*%=<>&^|.@]', Operator),
+            (r'[]{}:(),;[]', Punctuation),
+            include('functions'),
+
+            # Variable Names
+            (r'[A-Za-z_][a-zA-Z0-9_]*', Name.Variable),
+        ],
+        'numbers': [
+            (r'(\d(?:_?\d)*\.(?:\d(?:_?\d)*)?|(?:\d(?:_?\d)*)?\.\d(?:_?\d)*)'
+             r'([eE][+-]?\d(?:_?\d)*)?', Number.Float),
+            (r'\d(?:_?\d)*[eE][+-]?\d(?:_?\d)*j?', Number.Float),
+            (r'0[oO](?:_?[0-7])+', Number.Oct),
+            (r'0[bB](?:_?[01])+', Number.Bin),
+            (r'0[xX](?:_?[a-fA-F0-9])+', Number.Hex),
+            (r'\d(?:_?\d)*', Number.Integer),
+        ],
+        'fstringescape': [
+            include('stringescape'),
+        ],
+        'bytesescape': [
+            (r'\\([\\bfnrt"\']|\n|x[a-fA-F0-9]{2}|[0-7]{1,3})', String.Escape)
+        ],
+        'stringescape': [
+            (r'\\(N\{.*?\}|u\{[a-fA-F0-9]{1,6}\})', String.Escape),
+            include('bytesescape')
+        ],
+        'fstrings-single': fstring_rules(String.Single),
+        'fstrings-double': fstring_rules(String.Double),
+        'strings-single': innerstring_rules(String.Single),
+        'strings-double': innerstring_rules(String.Double),
+        'dqf': [
+            (r'"', String.Double, '#pop'),
+            (r'\\\\|\\"|\\\n', String.Escape),  # included here for raw strings
+            include('fstrings-double')
+        ],
+        'sqf': [
+            (r"'", String.Single, '#pop'),
+            (r"\\\\|\\'|\\\n", String.Escape),  # included here for raw strings
+            include('fstrings-single')
+        ],
+        'dqs': [
+            (r'"', String.Double, '#pop'),
+            (r'\\\\|\\"|\\\n', String.Escape),  # included here for raw strings
+            include('strings-double')
+        ],
+        'sqs': [
+            (r"'", String.Single, '#pop'),
+            (r"\\\\|\\'|\\\n", String.Escape),  # included here for raw strings
+            include('strings-single')
+        ],
+        'tdqf': [
+            (r'"""', String.Double, '#pop'),
+            include('fstrings-double'),
+            (r'\n', String.Double)
+        ],
+        'tsqf': [
+            (r"'''", String.Single, '#pop'),
+            include('fstrings-single'),
+            (r'\n', String.Single)
+        ],
+        'tdqs': [
+            (r'"""', String.Double, '#pop'),
+            include('strings-double'),
+            (r'\n', String.Double)
+        ],
+        'tsqs': [
+            (r"'''", String.Single, '#pop'),
+            include('strings-single'),
+            (r'\n', String.Single)
+        ],
+
+        'expr-inside-fstring': [
+            (r'[{([]', Punctuation, 'expr-inside-fstring-inner'),
+            # without format specifier
+            (r'(=\s*)?'         # debug (https://bugs.python.org/issue36817)
+             r'\}', String.Interpol, '#pop'),
+            # with format specifier
+            # we'll catch the remaining '}' in the outer scope
+            (r'(=\s*)?'         # debug (https://bugs.python.org/issue36817)
+             r':', String.Interpol, '#pop'),
+            (r'\s+', Whitespace),  # allow new lines
+            include('expr'),
+        ],
+        'expr-inside-fstring-inner': [
+            (r'[{([]', Punctuation, 'expr-inside-fstring-inner'),
+            (r'[])}]', Punctuation, '#pop'),
+            (r'\s+', Whitespace),  # allow new lines
+            include('expr'),
+        ],
+        'keywords': [
+            (words((
+                'into', 'case', 'type', 'module', 'internal',
+            ), suffix=r'\b'),
+                Keyword),
+            (words(('true', 'false', 'null'), suffix=r'\b'), Keyword.Constant),
+        ],
+        'functions': [
+            (words((
+                "min", "max", "sum", "average", "stddev", "every", "any",
+                "concat_array", "count", "lag", "lead", "first", "last",
+                "rank", "rank_dense", "row_number", "round", "as", "in",
+                "tuple_every", "tuple_map", "tuple_zip", "_eq", "_is_null",
+                "from_text", "lower", "upper", "read_parquet", "read_csv"),
+                suffix=r'\b'),
+             Name.Function),
+        ],
+
+        'comment': [
+            (r'-(?!\})', Comment.Multiline),
+            (r'\{-', Comment.Multiline, 'comment'),
+            (r'[^-}]', Comment.Multiline),
+            (r'-\}', Comment.Multiline, '#pop'),
+        ],
+
+        'imports': [
+            (r'\w+(\.\w+)*', Name.Class, '#pop'),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/ptx.py b/env/lib/python3.12/site-packages/pygments/lexers/ptx.py
new file mode 100644
index 0000000..784ca13
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/ptx.py
@@ -0,0 +1,119 @@
+"""
+    pygments.lexers.ptx
+    ~~~~~~~~~~~~~~~~~~~
+
+    Lexer for other PTX language.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, include, words
+from pygments.token import Comment, Keyword, Name, String, Number, \
+    Punctuation, Whitespace, Operator
+
+__all__ = ["PtxLexer"]
+
+
+class PtxLexer(RegexLexer):
+    """
+    For NVIDIA `PTX `_
+    source.
+    """
+    name = 'PTX'
+    url = "https://docs.nvidia.com/cuda/parallel-thread-execution/"
+    filenames = ['*.ptx']
+    aliases = ['ptx']
+    mimetypes = ['text/x-ptx']
+    version_added = '2.16'
+
+    #: optional Comment or Whitespace
+    string = r'"[^"]*?"'
+    followsym = r'[a-zA-Z0-9_$]'
+    identifier = r'([-a-zA-Z$._][\w\-$.]*|' + string + ')'
+    block_label = r'(' + identifier + r'|(\d+))'
+
+    tokens = {
+        'root': [
+            include('whitespace'),
+
+            (block_label + r'\s*:', Name.Label),
+
+            include('keyword'),
+
+            (r'%' + identifier, Name.Variable),
+            (r'%\d+', Name.Variable.Anonymous),
+            (r'c?' + string, String),
+            (identifier, Name.Variable),
+            (r';', Punctuation),
+            (r'[*+-/]', Operator),
+
+            (r'0[xX][a-fA-F0-9]+', Number),
+            (r'-?\d+(?:[.]\d+)?(?:[eE][-+]?\d+(?:[.]\d+)?)?', Number),
+
+            (r'[=<>{}\[\]()*.,!]|x\b', Punctuation)
+
+        ],
+        'whitespace': [
+            (r'(\n|\s+)+', Whitespace),
+            (r'//.*?\n', Comment)
+        ],
+
+        'keyword': [
+            # Instruction keywords
+            (words((
+                'abs', 'discard', 'min', 'shf', 'vadd',
+                'activemask', 'div', 'mma', 'shfl', 'vadd2',
+                'add', 'dp2a', 'mov', 'shl', 'vadd4',
+                'addc', 'dp4a', 'movmatrix', 'shr', 'vavrg2',
+                'alloca', 'elect', 'mul', 'sin', 'vavrg4',
+                'and', 'ex2', 'mul24', 'slct', 'vmad',
+                'applypriority', 'exit', 'multimem', 'sqrt', 'vmax',
+                'atom', 'fence', 'nanosleep', 'st', 'vmax2',
+                'bar', 'fma', 'neg', 'stackrestore', 'vmax4',
+                'barrier', 'fns', 'not', 'stacksave', 'vmin',
+                'bfe', 'getctarank', 'or', 'stmatrix', 'vmin2',
+                'bfi', 'griddepcontrol', 'pmevent', 'sub', 'vmin4',
+                'bfind', 'isspacep', 'popc', 'subc', 'vote',
+                'bmsk', 'istypep', 'prefetch', 'suld', 'vset',
+                'bra', 'ld', 'prefetchu', 'suq', 'vset2',
+                'brev', 'ldmatrix', 'prmt', 'sured', 'vset4',
+                'brkpt', 'ldu', 'rcp', 'sust', 'vshl',
+                'brx', 'lg2', 'red', 'szext', 'vshr',
+                'call', 'lop3', 'redux', 'tanh', 'vsub',
+                'clz', 'mad', 'rem', 'testp', 'vsub2',
+                'cnot', 'mad24', 'ret', 'tex', 'vsub4',
+                'copysign', 'madc', 'rsqrt', 'tld4', 'wgmma',
+                'cos', 'mapa', 'sad', 'trap', 'wmma',
+                'cp', 'match', 'selp', 'txq', 'xor',
+                'createpolicy', 'max', 'set', 'vabsdiff', 'cvt',
+                'mbarrier', 'setmaxnreg', 'vabsdiff2', 'cvta',
+                'membar', 'setp', 'vabsdiff4')), Keyword),
+            # State Spaces and Suffixes
+            (words((
+                'reg', '.sreg', '.const', '.global',
+                '.local', '.param', '.shared', '.tex',
+                '.wide', '.loc'
+            )), Keyword.Pseudo),
+            # PTX Directives
+            (words((
+                '.address_size', '.explicitcluster', '.maxnreg', '.section',
+                '.alias', '.extern', '.maxntid', '.shared',
+                '.align', '.file', '.minnctapersm', '.sreg',
+                '.branchtargets', '.func', '.noreturn', '.target',
+                '.callprototype', '.global', '.param', '.tex',
+                '.calltargets', '.loc', '.pragma', '.version',
+                '.common', '.local', '.reg', '.visible',
+                '.const', '.maxclusterrank', '.reqnctapercluster', '.weak',
+                '.entry', '.maxnctapersm', '.reqntid')), Keyword.Reserved),
+            # Fundamental Types
+            (words((
+                '.s8', '.s16', '.s32', '.s64',
+                '.u8', '.u16', '.u32', '.u64',
+                '.f16', '.f16x2', '.f32', '.f64',
+                '.b8', '.b16', '.b32', '.b64',
+                '.pred'
+            )), Keyword.Type)
+        ],
+
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/python.py b/env/lib/python3.12/site-packages/pygments/lexers/python.py
new file mode 100644
index 0000000..805f6ff
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/python.py
@@ -0,0 +1,1201 @@
+"""
+    pygments.lexers.python
+    ~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Python and related languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import keyword
+
+from pygments.lexer import DelegatingLexer, RegexLexer, include, \
+    bygroups, using, default, words, combined, this
+from pygments.util import get_bool_opt, shebang_matches
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Generic, Other, Error, Whitespace
+from pygments import unistring as uni
+
+__all__ = ['PythonLexer', 'PythonConsoleLexer', 'PythonTracebackLexer',
+           'Python2Lexer', 'Python2TracebackLexer',
+           'CythonLexer', 'DgLexer', 'NumPyLexer']
+
+
+class PythonLexer(RegexLexer):
+    """
+    For Python source code (version 3.x).
+
+    .. versionchanged:: 2.5
+       This is now the default ``PythonLexer``.  It is still available as the
+       alias ``Python3Lexer``.
+    """
+
+    name = 'Python'
+    url = 'https://www.python.org'
+    aliases = ['python', 'py', 'sage', 'python3', 'py3', 'bazel', 'starlark', 'pyi']
+    filenames = [
+        '*.py',
+        '*.pyw',
+        # Type stubs
+        '*.pyi',
+        # Jython
+        '*.jy',
+        # Sage
+        '*.sage',
+        # SCons
+        '*.sc',
+        'SConstruct',
+        'SConscript',
+        # Skylark/Starlark (used by Bazel, Buck, and Pants)
+        '*.bzl',
+        'BUCK',
+        'BUILD',
+        'BUILD.bazel',
+        'WORKSPACE',
+        # Twisted Application infrastructure
+        '*.tac',
+    ]
+    mimetypes = ['text/x-python', 'application/x-python',
+                 'text/x-python3', 'application/x-python3']
+    version_added = '0.10'
+
+    uni_name = f"[{uni.xid_start}][{uni.xid_continue}]*"
+
+    def innerstring_rules(ttype):
+        return [
+            # the old style '%s' % (...) string formatting (still valid in Py3)
+            (r'%(\(\w+\))?[-#0 +]*([0-9]+|[*])?(\.([0-9]+|[*]))?'
+             '[hlL]?[E-GXc-giorsaux%]', String.Interpol),
+            # the new style '{}'.format(...) string formatting
+            (r'\{'
+             r'((\w+)((\.\w+)|(\[[^\]]+\]))*)?'  # field name
+             r'(\![sra])?'                       # conversion
+             r'(\:(.?[<>=\^])?[-+ ]?#?0?(\d+)?,?(\.\d+)?[E-GXb-gnosx%]?)?'
+             r'\}', String.Interpol),
+
+            # backslashes, quotes and formatting signs must be parsed one at a time
+            (r'[^\\\'"%{\n]+', ttype),
+            (r'[\'"\\]', ttype),
+            # unhandled string formatting sign
+            (r'%|(\{{1,2})', ttype)
+            # newlines are an error (use "nl" state)
+        ]
+
+    def fstring_rules(ttype):
+        return [
+            # Assuming that a '}' is the closing brace after format specifier.
+            # Sadly, this means that we won't detect syntax error. But it's
+            # more important to parse correct syntax correctly, than to
+            # highlight invalid syntax.
+            (r'\}', String.Interpol),
+            (r'\{', String.Interpol, 'expr-inside-fstring'),
+            # backslashes, quotes and formatting signs must be parsed one at a time
+            (r'[^\\\'"{}\n]+', ttype),
+            (r'[\'"\\]', ttype),
+            # newlines are an error (use "nl" state)
+        ]
+
+    tokens = {
+        'root': [
+            (r'\n', Whitespace),
+            (r'^(\s*)([rRuUbB]{,2})("""(?:.|\n)*?""")',
+             bygroups(Whitespace, String.Affix, String.Doc)),
+            (r"^(\s*)([rRuUbB]{,2})('''(?:.|\n)*?''')",
+             bygroups(Whitespace, String.Affix, String.Doc)),
+            (r'\A#!.+$', Comment.Hashbang),
+            (r'#.*$', Comment.Single),
+            (r'\\\n', Text),
+            (r'\\', Text),
+            include('keywords'),
+            include('soft-keywords'),
+            (r'(def)((?:\s|\\\s)+)', bygroups(Keyword, Whitespace), 'funcname'),
+            (r'(class)((?:\s|\\\s)+)', bygroups(Keyword, Whitespace), 'classname'),
+            (r'(from)((?:\s|\\\s)+)', bygroups(Keyword.Namespace, Whitespace),
+             'fromimport'),
+            (r'(import)((?:\s|\\\s)+)', bygroups(Keyword.Namespace, Whitespace),
+             'import'),
+            include('expr'),
+        ],
+        'expr': [
+            # raw f-strings
+            ('(?i)(rf|fr)(""")',
+             bygroups(String.Affix, String.Double),
+             combined('rfstringescape', 'tdqf')),
+            ("(?i)(rf|fr)(''')",
+             bygroups(String.Affix, String.Single),
+             combined('rfstringescape', 'tsqf')),
+            ('(?i)(rf|fr)(")',
+             bygroups(String.Affix, String.Double),
+             combined('rfstringescape', 'dqf')),
+            ("(?i)(rf|fr)(')",
+             bygroups(String.Affix, String.Single),
+             combined('rfstringescape', 'sqf')),
+            # non-raw f-strings
+            ('([fF])(""")', bygroups(String.Affix, String.Double),
+             combined('fstringescape', 'tdqf')),
+            ("([fF])(''')", bygroups(String.Affix, String.Single),
+             combined('fstringescape', 'tsqf')),
+            ('([fF])(")', bygroups(String.Affix, String.Double),
+             combined('fstringescape', 'dqf')),
+            ("([fF])(')", bygroups(String.Affix, String.Single),
+             combined('fstringescape', 'sqf')),
+            # raw bytes and strings
+            ('(?i)(rb|br|r)(""")',
+             bygroups(String.Affix, String.Double), 'tdqs'),
+            ("(?i)(rb|br|r)(''')",
+             bygroups(String.Affix, String.Single), 'tsqs'),
+            ('(?i)(rb|br|r)(")',
+             bygroups(String.Affix, String.Double), 'dqs'),
+            ("(?i)(rb|br|r)(')",
+             bygroups(String.Affix, String.Single), 'sqs'),
+            # non-raw strings
+            ('([uU]?)(""")', bygroups(String.Affix, String.Double),
+             combined('stringescape', 'tdqs')),
+            ("([uU]?)(''')", bygroups(String.Affix, String.Single),
+             combined('stringescape', 'tsqs')),
+            ('([uU]?)(")', bygroups(String.Affix, String.Double),
+             combined('stringescape', 'dqs')),
+            ("([uU]?)(')", bygroups(String.Affix, String.Single),
+             combined('stringescape', 'sqs')),
+            # non-raw bytes
+            ('([bB])(""")', bygroups(String.Affix, String.Double),
+             combined('bytesescape', 'tdqs')),
+            ("([bB])(''')", bygroups(String.Affix, String.Single),
+             combined('bytesescape', 'tsqs')),
+            ('([bB])(")', bygroups(String.Affix, String.Double),
+             combined('bytesescape', 'dqs')),
+            ("([bB])(')", bygroups(String.Affix, String.Single),
+             combined('bytesescape', 'sqs')),
+
+            (r'[^\S\n]+', Text),
+            include('numbers'),
+            (r'!=|==|<<|>>|:=|[-~+/*%=<>&^|.]', Operator),
+            (r'[]{}:(),;[]', Punctuation),
+            (r'(in|is|and|or|not)\b', Operator.Word),
+            include('expr-keywords'),
+            include('builtins'),
+            include('magicfuncs'),
+            include('magicvars'),
+            include('name'),
+        ],
+        'expr-inside-fstring': [
+            (r'[{([]', Punctuation, 'expr-inside-fstring-inner'),
+            # without format specifier
+            (r'(=\s*)?'         # debug (https://bugs.python.org/issue36817)
+             r'(\![sraf])?'     # conversion
+             r'\}', String.Interpol, '#pop'),
+            # with format specifier
+            # we'll catch the remaining '}' in the outer scope
+            (r'(=\s*)?'         # debug (https://bugs.python.org/issue36817)
+             r'(\![sraf])?'     # conversion
+             r':', String.Interpol, '#pop'),
+            (r'\s+', Whitespace),  # allow new lines
+            include('expr'),
+        ],
+        'expr-inside-fstring-inner': [
+            (r'[{([]', Punctuation, 'expr-inside-fstring-inner'),
+            (r'[])}]', Punctuation, '#pop'),
+            (r'\s+', Whitespace),  # allow new lines
+            include('expr'),
+        ],
+        'expr-keywords': [
+            # Based on https://docs.python.org/3/reference/expressions.html
+            (words((
+                'async for', 'await', 'else', 'for', 'if', 'lambda',
+                'yield', 'yield from'), suffix=r'\b'),
+             Keyword),
+            (words(('True', 'False', 'None'), suffix=r'\b'), Keyword.Constant),
+        ],
+        'keywords': [
+            (words((
+                'assert', 'async', 'await', 'break', 'continue', 'del', 'elif',
+                'else', 'except', 'finally', 'for', 'global', 'if', 'lambda',
+                'pass', 'raise', 'nonlocal', 'return', 'try', 'while', 'yield',
+                'yield from', 'as', 'with'), suffix=r'\b'),
+             Keyword),
+            (words(('True', 'False', 'None'), suffix=r'\b'), Keyword.Constant),
+        ],
+        'soft-keywords': [
+            # `match`, `case` and `_` soft keywords
+            (r'(^[ \t]*)'              # at beginning of line + possible indentation
+             r'(match|case)\b'         # a possible keyword
+             r'(?![ \t]*(?:'           # not followed by...
+             r'[:,;=^&|@~)\]}]|(?:' +  # characters and keywords that mean this isn't
+                                       # pattern matching (but None/True/False is ok)
+             r'|'.join(k for k in keyword.kwlist if k[0].islower()) + r')\b))',
+             bygroups(Text, Keyword), 'soft-keywords-inner'),
+        ],
+        'soft-keywords-inner': [
+            # optional `_` keyword
+            (r'(\s+)([^\n_]*)(_\b)', bygroups(Whitespace, using(this), Keyword)),
+            default('#pop')
+        ],
+        'builtins': [
+            (words((
+                '__import__', 'abs', 'aiter', 'all', 'any', 'bin', 'bool', 'bytearray',
+                'breakpoint', 'bytes', 'callable', 'chr', 'classmethod', 'compile',
+                'complex', 'delattr', 'dict', 'dir', 'divmod', 'enumerate', 'eval',
+                'filter', 'float', 'format', 'frozenset', 'getattr', 'globals',
+                'hasattr', 'hash', 'hex', 'id', 'input', 'int', 'isinstance',
+                'issubclass', 'iter', 'len', 'list', 'locals', 'map', 'max',
+                'memoryview', 'min', 'next', 'object', 'oct', 'open', 'ord', 'pow',
+                'print', 'property', 'range', 'repr', 'reversed', 'round', 'set',
+                'setattr', 'slice', 'sorted', 'staticmethod', 'str', 'sum', 'super',
+                'tuple', 'type', 'vars', 'zip'), prefix=r'(?>|[-~+/*%=<>&^|.]', Operator),
+            include('keywords'),
+            (r'(def)((?:\s|\\\s)+)', bygroups(Keyword, Whitespace), 'funcname'),
+            (r'(class)((?:\s|\\\s)+)', bygroups(Keyword, Whitespace), 'classname'),
+            (r'(from)((?:\s|\\\s)+)', bygroups(Keyword.Namespace, Whitespace),
+             'fromimport'),
+            (r'(import)((?:\s|\\\s)+)', bygroups(Keyword.Namespace, Whitespace),
+             'import'),
+            include('builtins'),
+            include('magicfuncs'),
+            include('magicvars'),
+            include('backtick'),
+            ('([rR]|[uUbB][rR]|[rR][uUbB])(""")',
+             bygroups(String.Affix, String.Double), 'tdqs'),
+            ("([rR]|[uUbB][rR]|[rR][uUbB])(''')",
+             bygroups(String.Affix, String.Single), 'tsqs'),
+            ('([rR]|[uUbB][rR]|[rR][uUbB])(")',
+             bygroups(String.Affix, String.Double), 'dqs'),
+            ("([rR]|[uUbB][rR]|[rR][uUbB])(')",
+             bygroups(String.Affix, String.Single), 'sqs'),
+            ('([uUbB]?)(""")', bygroups(String.Affix, String.Double),
+             combined('stringescape', 'tdqs')),
+            ("([uUbB]?)(''')", bygroups(String.Affix, String.Single),
+             combined('stringescape', 'tsqs')),
+            ('([uUbB]?)(")', bygroups(String.Affix, String.Double),
+             combined('stringescape', 'dqs')),
+            ("([uUbB]?)(')", bygroups(String.Affix, String.Single),
+             combined('stringescape', 'sqs')),
+            include('name'),
+            include('numbers'),
+        ],
+        'keywords': [
+            (words((
+                'assert', 'break', 'continue', 'del', 'elif', 'else', 'except',
+                'exec', 'finally', 'for', 'global', 'if', 'lambda', 'pass',
+                'print', 'raise', 'return', 'try', 'while', 'yield',
+                'yield from', 'as', 'with'), suffix=r'\b'),
+             Keyword),
+        ],
+        'builtins': [
+            (words((
+                '__import__', 'abs', 'all', 'any', 'apply', 'basestring', 'bin',
+                'bool', 'buffer', 'bytearray', 'bytes', 'callable', 'chr', 'classmethod',
+                'cmp', 'coerce', 'compile', 'complex', 'delattr', 'dict', 'dir', 'divmod',
+                'enumerate', 'eval', 'execfile', 'exit', 'file', 'filter', 'float',
+                'frozenset', 'getattr', 'globals', 'hasattr', 'hash', 'hex', 'id',
+                'input', 'int', 'intern', 'isinstance', 'issubclass', 'iter', 'len',
+                'list', 'locals', 'long', 'map', 'max', 'min', 'next', 'object',
+                'oct', 'open', 'ord', 'pow', 'property', 'range', 'raw_input', 'reduce',
+                'reload', 'repr', 'reversed', 'round', 'set', 'setattr', 'slice',
+                'sorted', 'staticmethod', 'str', 'sum', 'super', 'tuple', 'type',
+                'unichr', 'unicode', 'vars', 'xrange', 'zip'),
+                prefix=r'(?>> )(.*\n)', bygroups(Generic.Prompt, Other.Code), 'continuations'),
+            # This happens, e.g., when tracebacks are embedded in documentation;
+            # trailing whitespaces are often stripped in such contexts.
+            (r'(>>>)(\n)', bygroups(Generic.Prompt, Whitespace)),
+            (r'(\^C)?Traceback \(most recent call last\):\n', Other.Traceback, 'traceback'),
+            # SyntaxError starts with this
+            (r'  File "[^"]+", line \d+', Other.Traceback, 'traceback'),
+            (r'.*\n', Generic.Output),
+        ],
+        'continuations': [
+            (r'(\.\.\. )(.*\n)', bygroups(Generic.Prompt, Other.Code)),
+            # See above.
+            (r'(\.\.\.)(\n)', bygroups(Generic.Prompt, Whitespace)),
+            default('#pop'),
+        ],
+        'traceback': [
+            # As soon as we see a traceback, consume everything until the next
+            # >>> prompt.
+            (r'(?=>>>( |$))', Text, '#pop'),
+            (r'(KeyboardInterrupt)(\n)', bygroups(Name.Class, Whitespace)),
+            (r'.*\n', Other.Traceback),
+        ],
+    }
+
+
+class PythonConsoleLexer(DelegatingLexer):
+    """
+    For Python console output or doctests, such as:
+
+    .. sourcecode:: pycon
+
+        >>> a = 'foo'
+        >>> print(a)
+        foo
+        >>> 1 / 0
+        Traceback (most recent call last):
+          File "", line 1, in 
+        ZeroDivisionError: integer division or modulo by zero
+
+    Additional options:
+
+    `python3`
+        Use Python 3 lexer for code.  Default is ``True``.
+
+        .. versionadded:: 1.0
+        .. versionchanged:: 2.5
+           Now defaults to ``True``.
+    """
+
+    name = 'Python console session'
+    aliases = ['pycon', 'python-console']
+    mimetypes = ['text/x-python-doctest']
+    url = 'https://python.org'
+    version_added = ''
+
+    def __init__(self, **options):
+        python3 = get_bool_opt(options, 'python3', True)
+        if python3:
+            pylexer = PythonLexer
+            tblexer = PythonTracebackLexer
+        else:
+            pylexer = Python2Lexer
+            tblexer = Python2TracebackLexer
+        # We have two auxiliary lexers. Use DelegatingLexer twice with
+        # different tokens.  TODO: DelegatingLexer should support this
+        # directly, by accepting a tuplet of auxiliary lexers and a tuple of
+        # distinguishing tokens. Then we wouldn't need this intermediary
+        # class.
+        class _ReplaceInnerCode(DelegatingLexer):
+            def __init__(self, **options):
+                super().__init__(pylexer, _PythonConsoleLexerBase, Other.Code, **options)
+        super().__init__(tblexer, _ReplaceInnerCode, Other.Traceback, **options)
+
+
+class PythonTracebackLexer(RegexLexer):
+    """
+    For Python 3.x tracebacks, with support for chained exceptions.
+
+    .. versionchanged:: 2.5
+       This is now the default ``PythonTracebackLexer``.  It is still available
+       as the alias ``Python3TracebackLexer``.
+    """
+
+    name = 'Python Traceback'
+    aliases = ['pytb', 'py3tb']
+    filenames = ['*.pytb', '*.py3tb']
+    mimetypes = ['text/x-python-traceback', 'text/x-python3-traceback']
+    url = 'https://python.org'
+    version_added = '1.0'
+
+    tokens = {
+        'root': [
+            (r'\n', Whitespace),
+            (r'^(\^C)?Traceback \(most recent call last\):\n', Generic.Traceback, 'intb'),
+            (r'^During handling of the above exception, another '
+             r'exception occurred:\n\n', Generic.Traceback),
+            (r'^The above exception was the direct cause of the '
+             r'following exception:\n\n', Generic.Traceback),
+            (r'^(?=  File "[^"]+", line \d+)', Generic.Traceback, 'intb'),
+            (r'^.*\n', Other),
+        ],
+        'intb': [
+            (r'^(  File )("[^"]+")(, line )(\d+)(, in )(.+)(\n)',
+             bygroups(Text, Name.Builtin, Text, Number, Text, Name, Whitespace)),
+            (r'^(  File )("[^"]+")(, line )(\d+)(\n)',
+             bygroups(Text, Name.Builtin, Text, Number, Whitespace)),
+            (r'^(    )(.+)(\n)',
+             bygroups(Whitespace, using(PythonLexer), Whitespace), 'markers'),
+            (r'^([ \t]*)(\.\.\.)(\n)',
+             bygroups(Whitespace, Comment, Whitespace)),  # for doctests...
+            (r'^([^:]+)(: )(.+)(\n)',
+             bygroups(Generic.Error, Text, Name, Whitespace), '#pop'),
+            (r'^([a-zA-Z_][\w.]*)(:?\n)',
+             bygroups(Generic.Error, Whitespace), '#pop'),
+            default('#pop'),
+        ],
+        'markers': [
+            # Either `PEP 657 `
+            # error locations in Python 3.11+, or single-caret markers
+            # for syntax errors before that.
+            (r'^( {4,})([~^]+)(\n)',
+             bygroups(Whitespace, Punctuation.Marker, Whitespace),
+             '#pop'),
+            default('#pop'),
+        ],
+    }
+
+
+Python3TracebackLexer = PythonTracebackLexer
+
+
+class Python2TracebackLexer(RegexLexer):
+    """
+    For Python tracebacks.
+
+    .. versionchanged:: 2.5
+       This class has been renamed from ``PythonTracebackLexer``.
+       ``PythonTracebackLexer`` now refers to the Python 3 variant.
+    """
+
+    name = 'Python 2.x Traceback'
+    aliases = ['py2tb']
+    filenames = ['*.py2tb']
+    mimetypes = ['text/x-python2-traceback']
+    url = 'https://python.org'
+    version_added = '0.7'
+
+    tokens = {
+        'root': [
+            # Cover both (most recent call last) and (innermost last)
+            # The optional ^C allows us to catch keyboard interrupt signals.
+            (r'^(\^C)?(Traceback.*\n)',
+             bygroups(Text, Generic.Traceback), 'intb'),
+            # SyntaxError starts with this.
+            (r'^(?=  File "[^"]+", line \d+)', Generic.Traceback, 'intb'),
+            (r'^.*\n', Other),
+        ],
+        'intb': [
+            (r'^(  File )("[^"]+")(, line )(\d+)(, in )(.+)(\n)',
+             bygroups(Text, Name.Builtin, Text, Number, Text, Name, Whitespace)),
+            (r'^(  File )("[^"]+")(, line )(\d+)(\n)',
+             bygroups(Text, Name.Builtin, Text, Number, Whitespace)),
+            (r'^(    )(.+)(\n)',
+             bygroups(Text, using(Python2Lexer), Whitespace), 'marker'),
+            (r'^([ \t]*)(\.\.\.)(\n)',
+             bygroups(Text, Comment, Whitespace)),  # for doctests...
+            (r'^([^:]+)(: )(.+)(\n)',
+             bygroups(Generic.Error, Text, Name, Whitespace), '#pop'),
+            (r'^([a-zA-Z_]\w*)(:?\n)',
+             bygroups(Generic.Error, Whitespace), '#pop')
+        ],
+        'marker': [
+            # For syntax errors.
+            (r'( {4,})(\^)', bygroups(Text, Punctuation.Marker), '#pop'),
+            default('#pop'),
+        ],
+    }
+
+
+class CythonLexer(RegexLexer):
+    """
+    For Pyrex and Cython source code.
+    """
+
+    name = 'Cython'
+    url = 'https://cython.org'
+    aliases = ['cython', 'pyx', 'pyrex']
+    filenames = ['*.pyx', '*.pxd', '*.pxi']
+    mimetypes = ['text/x-cython', 'application/x-cython']
+    version_added = '1.1'
+
+    tokens = {
+        'root': [
+            (r'\n', Whitespace),
+            (r'^(\s*)("""(?:.|\n)*?""")', bygroups(Whitespace, String.Doc)),
+            (r"^(\s*)('''(?:.|\n)*?''')", bygroups(Whitespace, String.Doc)),
+            (r'[^\S\n]+', Text),
+            (r'#.*$', Comment),
+            (r'[]{}:(),;[]', Punctuation),
+            (r'\\\n', Whitespace),
+            (r'\\', Text),
+            (r'(in|is|and|or|not)\b', Operator.Word),
+            (r'(<)([a-zA-Z0-9.?]+)(>)',
+             bygroups(Punctuation, Keyword.Type, Punctuation)),
+            (r'!=|==|<<|>>|[-~+/*%=<>&^|.?]', Operator),
+            (r'(from)(\d+)(<=)(\s+)(<)(\d+)(:)',
+             bygroups(Keyword, Number.Integer, Operator, Whitespace, Operator,
+                      Name, Punctuation)),
+            include('keywords'),
+            (r'(def|property)(\s+)', bygroups(Keyword, Whitespace), 'funcname'),
+            (r'(cp?def)(\s+)', bygroups(Keyword, Whitespace), 'cdef'),
+            # (should actually start a block with only cdefs)
+            (r'(cdef)(:)', bygroups(Keyword, Punctuation)),
+            (r'(class|struct)(\s+)', bygroups(Keyword, Whitespace), 'classname'),
+            (r'(from)(\s+)', bygroups(Keyword, Whitespace), 'fromimport'),
+            (r'(c?import)(\s+)', bygroups(Keyword, Whitespace), 'import'),
+            include('builtins'),
+            include('backtick'),
+            ('(?:[rR]|[uU][rR]|[rR][uU])"""', String, 'tdqs'),
+            ("(?:[rR]|[uU][rR]|[rR][uU])'''", String, 'tsqs'),
+            ('(?:[rR]|[uU][rR]|[rR][uU])"', String, 'dqs'),
+            ("(?:[rR]|[uU][rR]|[rR][uU])'", String, 'sqs'),
+            ('[uU]?"""', String, combined('stringescape', 'tdqs')),
+            ("[uU]?'''", String, combined('stringescape', 'tsqs')),
+            ('[uU]?"', String, combined('stringescape', 'dqs')),
+            ("[uU]?'", String, combined('stringescape', 'sqs')),
+            include('name'),
+            include('numbers'),
+        ],
+        'keywords': [
+            (words((
+                'assert', 'async', 'await', 'break', 'by', 'continue', 'ctypedef', 'del', 'elif',
+                'else', 'except', 'except?', 'exec', 'finally', 'for', 'fused', 'gil',
+                'global', 'if', 'include', 'lambda', 'nogil', 'pass', 'print',
+                'raise', 'return', 'try', 'while', 'yield', 'as', 'with'), suffix=r'\b'),
+             Keyword),
+            (r'(DEF|IF|ELIF|ELSE)\b', Comment.Preproc),
+        ],
+        'builtins': [
+            (words((
+                '__import__', 'abs', 'all', 'any', 'apply', 'basestring', 'bin', 'bint',
+                'bool', 'buffer', 'bytearray', 'bytes', 'callable', 'chr',
+                'classmethod', 'cmp', 'coerce', 'compile', 'complex', 'delattr',
+                'dict', 'dir', 'divmod', 'enumerate', 'eval', 'execfile', 'exit',
+                'file', 'filter', 'float', 'frozenset', 'getattr', 'globals',
+                'hasattr', 'hash', 'hex', 'id', 'input', 'int', 'intern', 'isinstance',
+                'issubclass', 'iter', 'len', 'list', 'locals', 'long', 'map', 'max',
+                'min', 'next', 'object', 'oct', 'open', 'ord', 'pow', 'property', 'Py_ssize_t',
+                'range', 'raw_input', 'reduce', 'reload', 'repr', 'reversed',
+                'round', 'set', 'setattr', 'slice', 'sorted', 'staticmethod',
+                'str', 'sum', 'super', 'tuple', 'type', 'unichr', 'unicode', 'unsigned',
+                'vars', 'xrange', 'zip'), prefix=r'(??/\\:']?:)(\s*)(\{)",
+             bygroups(Name.Function, Whitespace, Operator, Whitespace, Punctuation),
+             "functions"),
+            # Variable Names
+            (r"([.]?[a-zA-Z][\w.]*)(\s*)([-.~=!@#$%^&*_+|,<>?/\\:']?:)",
+             bygroups(Name.Variable, Whitespace, Operator)),
+            # Functions
+            (r"\{", Punctuation, "functions"),
+            # Parentheses
+            (r"\(", Punctuation, "parentheses"),
+            # Brackets
+            (r"\[", Punctuation, "brackets"),
+            # Errors
+            (r"'`([a-zA-Z][\w.]*)?", Name.Exception),
+            # File Symbols
+            (r"`:([a-zA-Z/][\w./]*)?", String.Symbol),
+            # Symbols
+            (r"`([a-zA-Z][\w.]*)?", String.Symbol),
+            # Numbers
+            include("numbers"),
+            # Variable Names
+            (r"[a-zA-Z][\w.]*", Name),
+            # Operators
+            (r"[-=+*#$%@!~^&:.,<>'\\|/?_]", Operator),
+            # Punctuation
+            (r";", Punctuation),
+        ],
+        "functions": [
+            include("root"),
+            (r"\}", Punctuation, "#pop"),
+        ],
+        "parentheses": [
+            include("root"),
+            (r"\)", Punctuation, "#pop"),
+        ],
+        "brackets": [
+            include("root"),
+            (r"\]", Punctuation, "#pop"),
+        ],
+        "numbers": [
+            # Binary Values
+            (r"[01]+b", Number.Bin),
+            # Nulls/Infinities
+            (r"0[nNwW][cefghijmndzuvtp]?", Number),
+            # Timestamps
+            ((r"(?:[0-9]{4}[.][0-9]{2}[.][0-9]{2}|[0-9]+)"
+              "D(?:[0-9](?:[0-9](?::[0-9]{2}"
+              "(?::[0-9]{2}(?:[.][0-9]*)?)?)?)?)?"), Literal.Date),
+            # Datetimes
+            ((r"[0-9]{4}[.][0-9]{2}"
+              "(?:m|[.][0-9]{2}(?:T(?:[0-9]{2}:[0-9]{2}"
+              "(?::[0-9]{2}(?:[.][0-9]*)?)?)?)?)"), Literal.Date),
+            # Times
+            (r"[0-9]{2}:[0-9]{2}(?::[0-9]{2}(?:[.][0-9]{1,3})?)?",
+             Literal.Date),
+            # GUIDs
+            (r"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}",
+             Number.Hex),
+            # Byte Vectors
+            (r"0x[0-9a-fA-F]+", Number.Hex),
+            # Floats
+            (r"([0-9]*[.]?[0-9]+|[0-9]+[.]?[0-9]*)[eE][+-]?[0-9]+[ef]?",
+             Number.Float),
+            (r"([0-9]*[.][0-9]+|[0-9]+[.][0-9]*)[ef]?", Number.Float),
+            (r"[0-9]+[ef]", Number.Float),
+            # Characters
+            (r"[0-9]+c", Number),
+            # Integers
+            (r"[0-9]+[ihtuv]", Number.Integer),
+            # Long Integers
+            (r"[0-9]+[jnp]?", Number.Integer.Long),
+        ],
+        "comments": [
+            (r"[^\\]+", Comment.Multiline),
+            (r"^\\", Comment.Multiline, "#pop"),
+            (r"\\", Comment.Multiline),
+        ],
+        "strings": [
+            (r'[^"\\]+', String.Double),
+            (r"\\.", String.Escape),
+            (r'"', String.Double, "#pop"),
+        ],
+    }
+
+
+class QLexer(KLexer):
+    """
+    For `Q `_ source code.
+    """
+
+    name = "Q"
+    aliases = ["q"]
+    filenames = ["*.q"]
+    version_added = '2.12'
+
+    tokens = {
+        "root": [
+            (words(("aj", "aj0", "ajf", "ajf0", "all", "and", "any", "asc",
+                    "asof", "attr", "avgs", "ceiling", "cols", "count", "cross",
+                    "csv", "cut", "deltas", "desc", "differ", "distinct", "dsave",
+                    "each", "ej", "ema", "eval", "except", "fby", "fills", "first",
+                    "fkeys", "flip", "floor", "get", "group", "gtime", "hclose",
+                    "hcount", "hdel", "hsym", "iasc", "idesc", "ij", "ijf",
+                    "inter", "inv", "key", "keys", "lj", "ljf", "load", "lower",
+                    "lsq", "ltime", "ltrim", "mavg", "maxs", "mcount", "md5",
+                    "mdev", "med", "meta", "mins", "mmax", "mmin", "mmu", "mod",
+                    "msum", "neg", "next", "not", "null", "or", "over", "parse",
+                    "peach", "pj", "prds", "prior", "prev", "rand", "rank", "ratios",
+                    "raze", "read0", "read1", "reciprocal", "reval", "reverse",
+                    "rload", "rotate", "rsave", "rtrim", "save", "scan", "scov",
+                    "sdev", "set", "show", "signum", "ssr", "string", "sublist",
+                    "sums", "sv", "svar", "system", "tables", "til", "trim", "txf",
+                    "type", "uj", "ujf", "ungroup", "union", "upper", "upsert",
+                    "value", "view", "views", "vs", "where", "wj", "wj1", "ww",
+                    "xasc", "xbar", "xcol", "xcols", "xdesc", "xgroup", "xkey",
+                    "xlog", "xprev", "xrank"),
+                    suffix=r"\b"), Name.Builtin,
+            ),
+            inherit,
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/qlik.py b/env/lib/python3.12/site-packages/pygments/lexers/qlik.py
new file mode 100644
index 0000000..a29f89f
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/qlik.py
@@ -0,0 +1,117 @@
+"""
+    pygments.lexers.qlik
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for the qlik scripting language
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, include, bygroups, words
+from pygments.token import Comment, Keyword, Name, Number, Operator, \
+    Punctuation, String, Text
+from pygments.lexers._qlik_builtins import OPERATORS_LIST, STATEMENT_LIST, \
+    SCRIPT_FUNCTIONS, CONSTANT_LIST
+
+__all__ = ["QlikLexer"]
+
+
+class QlikLexer(RegexLexer):
+    """
+    Lexer for qlik code, including .qvs files
+    """
+
+    name = "Qlik"
+    aliases = ["qlik", "qlikview", "qliksense", "qlikscript"]
+    filenames = ["*.qvs", "*.qvw"]
+    url = "https://qlik.com"
+    version_added = '2.12'
+
+    flags = re.IGNORECASE
+
+    tokens = {
+        # Handle multi-line comments
+        "comment": [
+            (r"\*/", Comment.Multiline, "#pop"),
+            (r"[^*]+", Comment.Multiline),
+        ],
+        # Handle numbers
+        "numerics": [
+            (r"\b\d+\.\d+(e\d+)?[fd]?\b", Number.Float),
+            (r"\b\d+\b", Number.Integer),
+        ],
+        # Handle variable names in things
+        "interp": [
+            (
+                r"(\$\()(\w+)(\))",
+                bygroups(String.Interpol, Name.Variable, String.Interpol),
+            ),
+        ],
+        # Handle strings
+        "string": [
+            (r"'", String, "#pop"),
+            include("interp"),
+            (r"[^'$]+", String),
+            (r"\$", String),
+        ],
+        #
+        "assignment": [
+            (r";", Punctuation, "#pop"),
+            include("root"),
+        ],
+        "field_name_quote": [
+            (r'"', String.Symbol, "#pop"),
+            include("interp"),
+            (r"[^\"$]+", String.Symbol),
+            (r"\$", String.Symbol),
+        ],
+        "field_name_bracket": [
+            (r"\]", String.Symbol, "#pop"),
+            include("interp"),
+            (r"[^\]$]+", String.Symbol),
+            (r"\$", String.Symbol),
+        ],
+        "function": [(r"\)", Punctuation, "#pop"), include("root")],
+        "root": [
+            # Whitespace and comments
+            (r"\s+", Text.Whitespace),
+            (r"/\*", Comment.Multiline, "comment"),
+            (r"//.*\n", Comment.Single),
+            # variable assignment
+            (r"(let|set)(\s+)", bygroups(Keyword.Declaration, Text.Whitespace),
+             "assignment"),
+            # Word operators
+            (words(OPERATORS_LIST["words"], prefix=r"\b", suffix=r"\b"),
+             Operator.Word),
+            # Statements
+            (words(STATEMENT_LIST, suffix=r"\b"), Keyword),
+            # Table names
+            (r"[a-z]\w*:", Keyword.Declaration),
+            # Constants
+            (words(CONSTANT_LIST, suffix=r"\b"), Keyword.Constant),
+            # Functions
+            (words(SCRIPT_FUNCTIONS, suffix=r"(?=\s*\()"), Name.Builtin,
+             "function"),
+            # interpolation - e.g. $(variableName)
+            include("interp"),
+            # Quotes denote a field/file name
+            (r'"', String.Symbol, "field_name_quote"),
+            # Square brackets denote a field/file name
+            (r"\[", String.Symbol, "field_name_bracket"),
+            # Strings
+            (r"'", String, "string"),
+            # Numbers
+            include("numerics"),
+            # Operator symbols
+            (words(OPERATORS_LIST["symbols"]), Operator),
+            # Strings denoted by single quotes
+            (r"'.+?'", String),
+            # Words as text
+            (r"\b\w+\b", Text),
+            # Basic punctuation
+            (r"[,;.()\\/]", Punctuation),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/qvt.py b/env/lib/python3.12/site-packages/pygments/lexers/qvt.py
new file mode 100644
index 0000000..302d1b6
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/qvt.py
@@ -0,0 +1,153 @@
+"""
+    pygments.lexers.qvt
+    ~~~~~~~~~~~~~~~~~~~
+
+    Lexer for QVT Operational language.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups, include, combined, default, \
+    words
+from pygments.token import Text, Comment, Operator, Keyword, Punctuation, \
+    Name, String, Number
+
+__all__ = ['QVToLexer']
+
+
+class QVToLexer(RegexLexer):
+    """
+    For the QVT Operational Mapping language.
+
+    Reference for implementing this: «Meta Object Facility (MOF) 2.0
+    Query/View/Transformation Specification», Version 1.1 - January 2011
+    (https://www.omg.org/spec/QVT/1.1/), see §8.4, «Concrete Syntax» in
+    particular.
+
+    Notable tokens assignments:
+
+    - Name.Class is assigned to the identifier following any of the following
+      keywords: metamodel, class, exception, primitive, enum, transformation
+      or library
+
+    - Name.Function is assigned to the names of mappings and queries
+
+    - Name.Builtin.Pseudo is assigned to the pre-defined variables 'this',
+      'self' and 'result'.
+    """
+    # With obvious borrowings & inspiration from the Java, Python and C lexers
+
+    name = 'QVTO'
+    aliases = ['qvto', 'qvt']
+    filenames = ['*.qvto']
+    url = 'https://www.omg.org/spec/QVT/1.1'
+    version_added = ''
+
+    tokens = {
+        'root': [
+            (r'\n', Text),
+            (r'[^\S\n]+', Text),
+            (r'(--|//)(\s*)(directive:)?(.*)$',
+             bygroups(Comment, Comment, Comment.Preproc, Comment)),
+            # Uncomment the following if you want to distinguish between
+            # '/*' and '/**', à la javadoc
+            # (r'/[*]{2}(.|\n)*?[*]/', Comment.Multiline),
+            (r'/[*](.|\n)*?[*]/', Comment.Multiline),
+            (r'\\\n', Text),
+            (r'(and|not|or|xor|##?)\b', Operator.Word),
+            (r'(:{1,2}=|[-+]=)\b', Operator.Word),
+            (r'(@|<<|>>)\b', Keyword),  # stereotypes
+            (r'!=|<>|==|=|!->|->|>=|<=|[.]{3}|[+/*%=<>&|.~]', Operator),
+            (r'[]{}:(),;[]', Punctuation),
+            (r'(true|false|unlimited|null)\b', Keyword.Constant),
+            (r'(this|self|result)\b', Name.Builtin.Pseudo),
+            (r'(var)\b', Keyword.Declaration),
+            (r'(from|import)\b', Keyword.Namespace, 'fromimport'),
+            (r'(metamodel|class|exception|primitive|enum|transformation|'
+             r'library)(\s+)(\w+)',
+             bygroups(Keyword.Word, Text, Name.Class)),
+            (r'(exception)(\s+)(\w+)',
+             bygroups(Keyword.Word, Text, Name.Exception)),
+            (r'(main)\b', Name.Function),
+            (r'(mapping|helper|query)(\s+)',
+             bygroups(Keyword.Declaration, Text), 'operation'),
+            (r'(assert)(\s+)\b', bygroups(Keyword, Text), 'assert'),
+            (r'(Bag|Collection|Dict|OrderedSet|Sequence|Set|Tuple|List)\b',
+             Keyword.Type),
+            include('keywords'),
+            ('"', String, combined('stringescape', 'dqs')),
+            ("'", String, combined('stringescape', 'sqs')),
+            include('name'),
+            include('numbers'),
+            # (r'([a-zA-Z_]\w*)(::)([a-zA-Z_]\w*)',
+            # bygroups(Text, Text, Text)),
+        ],
+
+        'fromimport': [
+            (r'(?:[ \t]|\\\n)+', Text),
+            (r'[a-zA-Z_][\w.]*', Name.Namespace),
+            default('#pop'),
+        ],
+
+        'operation': [
+            (r'::', Text),
+            (r'(.*::)([a-zA-Z_]\w*)([ \t]*)(\()',
+             bygroups(Text, Name.Function, Text, Punctuation), '#pop')
+        ],
+
+        'assert': [
+            (r'(warning|error|fatal)\b', Keyword, '#pop'),
+            default('#pop'),  # all else: go back
+        ],
+
+        'keywords': [
+            (words((
+                'abstract', 'access', 'any', 'assert', 'blackbox', 'break',
+                'case', 'collect', 'collectNested', 'collectOne', 'collectselect',
+                'collectselectOne', 'composes', 'compute', 'configuration',
+                'constructor', 'continue', 'datatype', 'default', 'derived',
+                'disjuncts', 'do', 'elif', 'else', 'end', 'endif', 'except',
+                'exists', 'extends', 'forAll', 'forEach', 'forOne', 'from', 'if',
+                'implies', 'in', 'inherits', 'init', 'inout', 'intermediate',
+                'invresolve', 'invresolveIn', 'invresolveone', 'invresolveoneIn',
+                'isUnique', 'iterate', 'late', 'let', 'literal', 'log', 'map',
+                'merges', 'modeltype', 'new', 'object', 'one', 'ordered', 'out',
+                'package', 'population', 'property', 'raise', 'readonly',
+                'references', 'refines', 'reject', 'resolve', 'resolveIn',
+                'resolveone', 'resolveoneIn', 'return', 'select', 'selectOne',
+                'sortedBy', 'static', 'switch', 'tag', 'then', 'try', 'typedef',
+                'unlimited', 'uses', 'when', 'where', 'while', 'with', 'xcollect',
+                'xmap', 'xselect'), suffix=r'\b'), Keyword),
+        ],
+
+        # There is no need to distinguish between String.Single and
+        # String.Double: 'strings' is factorised for 'dqs' and 'sqs'
+        'strings': [
+            (r'[^\\\'"\n]+', String),
+            # quotes, percents and backslashes must be parsed one at a time
+            (r'[\'"\\]', String),
+        ],
+        'stringescape': [
+            (r'\\([\\btnfr"\']|u[0-3][0-7]{2}|u[0-7]{1,2})', String.Escape)
+        ],
+        'dqs': [  # double-quoted string
+            (r'"', String, '#pop'),
+            (r'\\\\|\\"', String.Escape),
+            include('strings')
+        ],
+        'sqs': [  # single-quoted string
+            (r"'", String, '#pop'),
+            (r"\\\\|\\'", String.Escape),
+            include('strings')
+        ],
+        'name': [
+            (r'[a-zA-Z_]\w*', Name),
+        ],
+        # numbers: excerpt taken from the python lexer
+        'numbers': [
+            (r'(\d+\.\d*|\d*\.\d+)([eE][+-]?[0-9]+)?', Number.Float),
+            (r'\d+[eE][+-]?[0-9]+', Number.Float),
+            (r'\d+', Number.Integer)
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/r.py b/env/lib/python3.12/site-packages/pygments/lexers/r.py
new file mode 100644
index 0000000..d3f65ba
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/r.py
@@ -0,0 +1,196 @@
+"""
+    pygments.lexers.r
+    ~~~~~~~~~~~~~~~~~
+
+    Lexers for the R/S languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import Lexer, RegexLexer, include, do_insertions
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Generic, Whitespace
+
+__all__ = ['RConsoleLexer', 'SLexer', 'RdLexer']
+
+
+line_re  = re.compile('.*?\n')
+
+
+class RConsoleLexer(Lexer):
+    """
+    For R console transcripts or R CMD BATCH output files.
+    """
+
+    name = 'RConsole'
+    aliases = ['rconsole', 'rout']
+    filenames = ['*.Rout']
+    url = 'https://www.r-project.org'
+    version_added = ''
+    _example = "rconsole/r-console-transcript.Rout"
+
+    def get_tokens_unprocessed(self, text):
+        slexer = SLexer(**self.options)
+
+        current_code_block = ''
+        insertions = []
+
+        for match in line_re.finditer(text):
+            line = match.group()
+            if line.startswith('>') or line.startswith('+'):
+                # Colorize the prompt as such,
+                # then put rest of line into current_code_block
+                insertions.append((len(current_code_block),
+                                   [(0, Generic.Prompt, line[:2])]))
+                current_code_block += line[2:]
+            else:
+                # We have reached a non-prompt line!
+                # If we have stored prompt lines, need to process them first.
+                if current_code_block:
+                    # Weave together the prompts and highlight code.
+                    yield from do_insertions(
+                        insertions, slexer.get_tokens_unprocessed(current_code_block))
+                    # Reset vars for next code block.
+                    current_code_block = ''
+                    insertions = []
+                # Now process the actual line itself, this is output from R.
+                yield match.start(), Generic.Output, line
+
+        # If we happen to end on a code block with nothing after it, need to
+        # process the last code block. This is neither elegant nor DRY so
+        # should be changed.
+        if current_code_block:
+            yield from do_insertions(
+                insertions, slexer.get_tokens_unprocessed(current_code_block))
+
+
+class SLexer(RegexLexer):
+    """
+    For S, S-plus, and R source code.
+    """
+
+    name = 'S'
+    aliases = ['splus', 's', 'r']
+    filenames = ['*.S', '*.R', '.Rhistory', '.Rprofile', '.Renviron']
+    mimetypes = ['text/S-plus', 'text/S', 'text/x-r-source', 'text/x-r',
+                 'text/x-R', 'text/x-r-history', 'text/x-r-profile']
+    url = 'https://www.r-project.org'
+    version_added = '0.10'
+
+    valid_name = r'`[^`\\]*(?:\\.[^`\\]*)*`|(?:[a-zA-Z]|\.[A-Za-z_.])[\w.]*|\.'
+    tokens = {
+        'comments': [
+            (r'#.*$', Comment.Single),
+        ],
+        'valid_name': [
+            (valid_name, Name),
+        ],
+        'function_name': [
+            (rf'({valid_name})\s*(?=\()', Name.Function),
+        ],
+        'punctuation': [
+            (r'\[{1,2}|\]{1,2}|\(|\)|;|,', Punctuation),
+        ],
+        'keywords': [
+            (r'(if|else|for|while|repeat|in|next|break|return|switch|function)'
+             r'(?![\w.])',
+             Keyword.Reserved),
+        ],
+        'operators': [
+            (r'<>?|-|==|<=|>=|\|>|<|>|&&?|!=|\|\|?|\?', Operator),
+            (r'\*|\+|\^|/|!|%[^%]*%|=|~|\$|@|:{1,3}', Operator),
+        ],
+        'builtin_symbols': [
+            (r'(NULL|NA(_(integer|real|complex|character)_)?|'
+             r'letters|LETTERS|Inf|TRUE|FALSE|NaN|pi|\.\.(\.|[0-9]+))'
+             r'(?![\w.])',
+             Keyword.Constant),
+            (r'(T|F)\b', Name.Builtin.Pseudo),
+        ],
+        'numbers': [
+            # hex number
+            (r'0[xX][a-fA-F0-9]+([pP][0-9]+)?[Li]?', Number.Hex),
+            # decimal number
+            (r'[+-]?([0-9]+(\.[0-9]+)?|\.[0-9]+|\.)([eE][+-]?[0-9]+)?[Li]?',
+             Number),
+        ],
+        'statements': [
+            include('comments'),
+            # whitespaces
+            (r'\s+', Whitespace),
+            (r'\'', String, 'string_squote'),
+            (r'\"', String, 'string_dquote'),
+            include('builtin_symbols'),
+            include('keywords'),
+            include('function_name'),
+            include('valid_name'),
+            include('numbers'),
+            include('punctuation'),
+            include('operators'),
+        ],
+        'root': [
+            # calls:
+            include('statements'),
+            # blocks:
+            (r'\{|\}', Punctuation),
+            # (r'\{', Punctuation, 'block'),
+            (r'.', Text),
+        ],
+        # 'block': [
+        #    include('statements'),
+        #    ('\{', Punctuation, '#push'),
+        #    ('\}', Punctuation, '#pop')
+        # ],
+        'string_squote': [
+            (r'([^\'\\]|\\.)*\'', String, '#pop'),
+        ],
+        'string_dquote': [
+            (r'([^"\\]|\\.)*"', String, '#pop'),
+        ],
+    }
+
+    def analyse_text(text):
+        if re.search(r'[a-z0-9_\])\s]<-(?!-)', text):
+            return 0.11
+
+
+class RdLexer(RegexLexer):
+    """
+    Pygments Lexer for R documentation (Rd) files
+
+    This is a very minimal implementation, highlighting little more
+    than the macros. A description of Rd syntax is found in `Writing R
+    Extensions `_
+    and `Parsing Rd files `_.
+    """
+    name = 'Rd'
+    aliases = ['rd']
+    filenames = ['*.Rd']
+    mimetypes = ['text/x-r-doc']
+    url = 'http://cran.r-project.org/doc/manuals/R-exts.html'
+    version_added = '1.6'
+
+    # To account for verbatim / LaTeX-like / and R-like areas
+    # would require parsing.
+    tokens = {
+        'root': [
+            # catch escaped brackets and percent sign
+            (r'\\[\\{}%]', String.Escape),
+            # comments
+            (r'%.*$', Comment),
+            # special macros with no arguments
+            (r'\\(?:cr|l?dots|R|tab)\b', Keyword.Constant),
+            # macros
+            (r'\\[a-zA-Z]+\b', Keyword),
+            # special preprocessor macros
+            (r'^\s*#(?:ifn?def|endif).*\b', Comment.Preproc),
+            # non-escaped brackets
+            (r'[{}]', Name.Builtin),
+            # everything else
+            (r'[^\\%\n{}]+', Text),
+            (r'.', Text),
+        ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/rdf.py b/env/lib/python3.12/site-packages/pygments/lexers/rdf.py
new file mode 100644
index 0000000..4930c1b
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/rdf.py
@@ -0,0 +1,468 @@
+"""
+    pygments.lexers.rdf
+    ~~~~~~~~~~~~~~~~~~~
+
+    Lexers for semantic web and RDF query languages and markup.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, bygroups, default
+from pygments.token import Keyword, Punctuation, String, Number, Operator, \
+    Generic, Whitespace, Name, Literal, Comment, Text
+
+__all__ = ['SparqlLexer', 'TurtleLexer', 'ShExCLexer']
+
+
+class SparqlLexer(RegexLexer):
+    """
+    Lexer for SPARQL query language.
+    """
+    name = 'SPARQL'
+    aliases = ['sparql']
+    filenames = ['*.rq', '*.sparql']
+    mimetypes = ['application/sparql-query']
+    url = 'https://www.w3.org/TR/sparql11-query'
+    version_added = '2.0'
+
+    # character group definitions ::
+
+    PN_CHARS_BASE_GRP = ('a-zA-Z'
+                         '\u00c0-\u00d6'
+                         '\u00d8-\u00f6'
+                         '\u00f8-\u02ff'
+                         '\u0370-\u037d'
+                         '\u037f-\u1fff'
+                         '\u200c-\u200d'
+                         '\u2070-\u218f'
+                         '\u2c00-\u2fef'
+                         '\u3001-\ud7ff'
+                         '\uf900-\ufdcf'
+                         '\ufdf0-\ufffd')
+
+    PN_CHARS_U_GRP = (PN_CHARS_BASE_GRP + '_')
+
+    PN_CHARS_GRP = (PN_CHARS_U_GRP +
+                    r'\-' +
+                    r'0-9' +
+                    '\u00b7' +
+                    '\u0300-\u036f' +
+                    '\u203f-\u2040')
+
+    HEX_GRP = '0-9A-Fa-f'
+
+    PN_LOCAL_ESC_CHARS_GRP = r' _~.\-!$&"()*+,;=/?#@%'
+
+    # terminal productions ::
+
+    PN_CHARS_BASE = '[' + PN_CHARS_BASE_GRP + ']'
+
+    PN_CHARS_U = '[' + PN_CHARS_U_GRP + ']'
+
+    PN_CHARS = '[' + PN_CHARS_GRP + ']'
+
+    HEX = '[' + HEX_GRP + ']'
+
+    PN_LOCAL_ESC_CHARS = '[' + PN_LOCAL_ESC_CHARS_GRP + ']'
+
+    IRIREF = r'<(?:[^<>"{}|^`\\\x00-\x20])*>'
+
+    BLANK_NODE_LABEL = '_:[0-9' + PN_CHARS_U_GRP + '](?:[' + PN_CHARS_GRP + \
+                       '.]*' + PN_CHARS + ')?'
+
+    PN_PREFIX = PN_CHARS_BASE + '(?:[' + PN_CHARS_GRP + '.]*' + PN_CHARS + ')?'
+
+    VARNAME = '[0-9' + PN_CHARS_U_GRP + '][' + PN_CHARS_U_GRP + \
+              '0-9\u00b7\u0300-\u036f\u203f-\u2040]*'
+
+    PERCENT = '%' + HEX + HEX
+
+    PN_LOCAL_ESC = r'\\' + PN_LOCAL_ESC_CHARS
+
+    PLX = '(?:' + PERCENT + ')|(?:' + PN_LOCAL_ESC + ')'
+
+    PN_LOCAL = ('(?:[' + PN_CHARS_U_GRP + ':0-9' + ']|' + PLX + ')' +
+                '(?:(?:[' + PN_CHARS_GRP + '.:]|' + PLX + ')*(?:[' +
+                PN_CHARS_GRP + ':]|' + PLX + '))?')
+
+    EXPONENT = r'[eE][+-]?\d+'
+
+    # Lexer token definitions ::
+
+    tokens = {
+        'root': [
+            (r'\s+', Text),
+            # keywords ::
+            (r'(?i)(select|construct|describe|ask|where|filter|group\s+by|minus|'
+             r'distinct|reduced|from\s+named|from|order\s+by|desc|asc|limit|'
+             r'offset|values|bindings|load|into|clear|drop|create|add|move|copy|'
+             r'insert\s+data|delete\s+data|delete\s+where|with|delete|insert|'
+             r'using\s+named|using|graph|default|named|all|optional|service|'
+             r'silent|bind|undef|union|not\s+in|in|as|having|to|prefix|base)\b', Keyword),
+            (r'(a)\b', Keyword),
+            # IRIs ::
+            ('(' + IRIREF + ')', Name.Label),
+            # blank nodes ::
+            ('(' + BLANK_NODE_LABEL + ')', Name.Label),
+            #  # variables ::
+            ('[?$]' + VARNAME, Name.Variable),
+            # prefixed names ::
+            (r'(' + PN_PREFIX + r')?(\:)(' + PN_LOCAL + r')?',
+             bygroups(Name.Namespace, Punctuation, Name.Tag)),
+            # function names ::
+            (r'(?i)(str|lang|langmatches|datatype|bound|iri|uri|bnode|rand|abs|'
+             r'ceil|floor|round|concat|strlen|ucase|lcase|encode_for_uri|'
+             r'contains|strstarts|strends|strbefore|strafter|year|month|day|'
+             r'hours|minutes|seconds|timezone|tz|now|uuid|struuid|md5|sha1|sha256|sha384|'
+             r'sha512|coalesce|if|strlang|strdt|sameterm|isiri|isuri|isblank|'
+             r'isliteral|isnumeric|regex|substr|replace|exists|not\s+exists|'
+             r'count|sum|min|max|avg|sample|group_concat|separator)\b',
+             Name.Function),
+            # boolean literals ::
+            (r'(true|false)', Keyword.Constant),
+            # double literals ::
+            (r'[+\-]?(\d+\.\d*' + EXPONENT + r'|\.?\d+' + EXPONENT + ')', Number.Float),
+            # decimal literals ::
+            (r'[+\-]?(\d+\.\d*|\.\d+)', Number.Float),
+            # integer literals ::
+            (r'[+\-]?\d+', Number.Integer),
+            # operators ::
+            (r'(\|\||&&|=|\*|\-|\+|/|!=|<=|>=|!|<|>)', Operator),
+            # punctuation characters ::
+            (r'[(){}.;,:^\[\]]', Punctuation),
+            # line comments ::
+            (r'#[^\n]*', Comment),
+            # strings ::
+            (r'"""', String, 'triple-double-quoted-string'),
+            (r'"', String, 'single-double-quoted-string'),
+            (r"'''", String, 'triple-single-quoted-string'),
+            (r"'", String, 'single-single-quoted-string'),
+        ],
+        'triple-double-quoted-string': [
+            (r'"""', String, 'end-of-string'),
+            (r'[^\\]+', String),
+            (r'\\', String, 'string-escape'),
+        ],
+        'single-double-quoted-string': [
+            (r'"', String, 'end-of-string'),
+            (r'[^"\\\n]+', String),
+            (r'\\', String, 'string-escape'),
+        ],
+        'triple-single-quoted-string': [
+            (r"'''", String, 'end-of-string'),
+            (r'[^\\]+', String),
+            (r'\\', String.Escape, 'string-escape'),
+        ],
+        'single-single-quoted-string': [
+            (r"'", String, 'end-of-string'),
+            (r"[^'\\\n]+", String),
+            (r'\\', String, 'string-escape'),
+        ],
+        'string-escape': [
+            (r'u' + HEX + '{4}', String.Escape, '#pop'),
+            (r'U' + HEX + '{8}', String.Escape, '#pop'),
+            (r'.', String.Escape, '#pop'),
+        ],
+        'end-of-string': [
+            (r'(@)([a-zA-Z]+(?:-[a-zA-Z0-9]+)*)',
+             bygroups(Operator, Name.Function), '#pop:2'),
+            (r'\^\^', Operator, '#pop:2'),
+            default('#pop:2'),
+        ],
+    }
+
+
+class TurtleLexer(RegexLexer):
+    """
+    Lexer for Turtle data language.
+    """
+    name = 'Turtle'
+    aliases = ['turtle']
+    filenames = ['*.ttl']
+    mimetypes = ['text/turtle', 'application/x-turtle']
+    url = 'https://www.w3.org/TR/turtle'
+    version_added = '2.1'
+
+    # character group definitions ::
+    PN_CHARS_BASE_GRP = ('a-zA-Z'
+                         '\u00c0-\u00d6'
+                         '\u00d8-\u00f6'
+                         '\u00f8-\u02ff'
+                         '\u0370-\u037d'
+                         '\u037f-\u1fff'
+                         '\u200c-\u200d'
+                         '\u2070-\u218f'
+                         '\u2c00-\u2fef'
+                         '\u3001-\ud7ff'
+                         '\uf900-\ufdcf'
+                         '\ufdf0-\ufffd')
+
+    PN_CHARS_U_GRP = (PN_CHARS_BASE_GRP + '_')
+
+    PN_CHARS_GRP = (PN_CHARS_U_GRP +
+                    r'\-' +
+                    r'0-9' +
+                    '\u00b7' +
+                    '\u0300-\u036f' +
+                    '\u203f-\u2040')
+
+    PN_CHARS = '[' + PN_CHARS_GRP + ']'
+
+    PN_CHARS_BASE = '[' + PN_CHARS_BASE_GRP + ']'
+
+    PN_PREFIX = PN_CHARS_BASE + '(?:[' + PN_CHARS_GRP + '.]*' + PN_CHARS + ')?'
+
+    HEX_GRP = '0-9A-Fa-f'
+
+    HEX = '[' + HEX_GRP + ']'
+
+    PERCENT = '%' + HEX + HEX
+
+    PN_LOCAL_ESC_CHARS_GRP = r' _~.\-!$&"()*+,;=/?#@%'
+
+    PN_LOCAL_ESC_CHARS = '[' + PN_LOCAL_ESC_CHARS_GRP + ']'
+
+    PN_LOCAL_ESC = r'\\' + PN_LOCAL_ESC_CHARS
+
+    PLX = '(?:' + PERCENT + ')|(?:' + PN_LOCAL_ESC + ')'
+
+    PN_LOCAL = ('(?:[' + PN_CHARS_U_GRP + ':0-9' + ']|' + PLX + ')' +
+                '(?:(?:[' + PN_CHARS_GRP + '.:]|' + PLX + ')*(?:[' +
+                PN_CHARS_GRP + ':]|' + PLX + '))?')
+
+    patterns = {
+        'PNAME_NS': r'((?:[a-zA-Z][\w-]*)?\:)',  # Simplified character range
+        'IRIREF': r'(<[^<>"{}|^`\\\x00-\x20]*>)'
+    }
+
+    tokens = {
+        'root': [
+            (r'\s+', Text),
+
+            # Base / prefix
+            (r'(@base|BASE)(\s+){IRIREF}(\s*)(\.?)'.format(**patterns),
+             bygroups(Keyword, Whitespace, Name.Variable, Whitespace,
+                      Punctuation)),
+            (r'(@prefix|PREFIX)(\s+){PNAME_NS}(\s+){IRIREF}(\s*)(\.?)'.format(**patterns),
+             bygroups(Keyword, Whitespace, Name.Namespace, Whitespace,
+                      Name.Variable, Whitespace, Punctuation)),
+
+            # The shorthand predicate 'a'
+            (r'(?<=\s)a(?=\s)', Keyword.Type),
+
+            # IRIREF
+            (r'{IRIREF}'.format(**patterns), Name.Variable),
+
+            # PrefixedName
+            (r'(' + PN_PREFIX + r')?(\:)(' + PN_LOCAL + r')?',
+             bygroups(Name.Namespace, Punctuation, Name.Tag)),
+
+            # BlankNodeLabel
+            (r'(_)(:)([' + PN_CHARS_U_GRP + r'0-9]([' + PN_CHARS_GRP + r'.]*' + PN_CHARS + ')?)',
+             bygroups(Name.Namespace, Punctuation, Name.Tag)),
+
+            # Comment
+            (r'#[^\n]+', Comment),
+
+            (r'\b(true|false)\b', Literal),
+            (r'[+\-]?\d*\.\d+', Number.Float),
+            (r'[+\-]?\d*(:?\.\d+)?E[+\-]?\d+', Number.Float),
+            (r'[+\-]?\d+', Number.Integer),
+            (r'[\[\](){}.;,:^]', Punctuation),
+
+            (r'"""', String, 'triple-double-quoted-string'),
+            (r'"', String, 'single-double-quoted-string'),
+            (r"'''", String, 'triple-single-quoted-string'),
+            (r"'", String, 'single-single-quoted-string'),
+        ],
+        'triple-double-quoted-string': [
+            (r'"""', String, 'end-of-string'),
+            (r'[^\\]+(?=""")', String),
+            (r'\\', String, 'string-escape'),
+        ],
+        'single-double-quoted-string': [
+            (r'"', String, 'end-of-string'),
+            (r'[^"\\\n]+', String),
+            (r'\\', String, 'string-escape'),
+        ],
+        'triple-single-quoted-string': [
+            (r"'''", String, 'end-of-string'),
+            (r"[^\\]+(?=''')", String),
+            (r'\\', String, 'string-escape'),
+        ],
+        'single-single-quoted-string': [
+            (r"'", String, 'end-of-string'),
+            (r"[^'\\\n]+", String),
+            (r'\\', String, 'string-escape'),
+        ],
+        'string-escape': [
+            (r'.', String, '#pop'),
+        ],
+        'end-of-string': [
+            (r'(@)([a-zA-Z]+(?:-[a-zA-Z0-9]+)*)',
+             bygroups(Operator, Generic.Emph), '#pop:2'),
+
+            (r'(\^\^){IRIREF}'.format(**patterns), bygroups(Operator, Generic.Emph), '#pop:2'),
+
+            default('#pop:2'),
+
+        ],
+    }
+
+    # Turtle and Tera Term macro files share the same file extension
+    # but each has a recognizable and distinct syntax.
+    def analyse_text(text):
+        for t in ('@base ', 'BASE ', '@prefix ', 'PREFIX '):
+            if re.search(rf'^\s*{t}', text):
+                return 0.80
+
+
+class ShExCLexer(RegexLexer):
+    """
+    Lexer for ShExC shape expressions language syntax.
+    """
+    name = 'ShExC'
+    aliases = ['shexc', 'shex']
+    filenames = ['*.shex']
+    mimetypes = ['text/shex']
+    url = 'https://shex.io/shex-semantics/#shexc'
+    version_added = ''
+
+    # character group definitions ::
+
+    PN_CHARS_BASE_GRP = ('a-zA-Z'
+                         '\u00c0-\u00d6'
+                         '\u00d8-\u00f6'
+                         '\u00f8-\u02ff'
+                         '\u0370-\u037d'
+                         '\u037f-\u1fff'
+                         '\u200c-\u200d'
+                         '\u2070-\u218f'
+                         '\u2c00-\u2fef'
+                         '\u3001-\ud7ff'
+                         '\uf900-\ufdcf'
+                         '\ufdf0-\ufffd')
+
+    PN_CHARS_U_GRP = (PN_CHARS_BASE_GRP + '_')
+
+    PN_CHARS_GRP = (PN_CHARS_U_GRP +
+                    r'\-' +
+                    r'0-9' +
+                    '\u00b7' +
+                    '\u0300-\u036f' +
+                    '\u203f-\u2040')
+
+    HEX_GRP = '0-9A-Fa-f'
+
+    PN_LOCAL_ESC_CHARS_GRP = r"_~.\-!$&'()*+,;=/?#@%"
+
+    # terminal productions ::
+
+    PN_CHARS_BASE = '[' + PN_CHARS_BASE_GRP + ']'
+
+    PN_CHARS_U = '[' + PN_CHARS_U_GRP + ']'
+
+    PN_CHARS = '[' + PN_CHARS_GRP + ']'
+
+    HEX = '[' + HEX_GRP + ']'
+
+    PN_LOCAL_ESC_CHARS = '[' + PN_LOCAL_ESC_CHARS_GRP + ']'
+
+    UCHAR_NO_BACKSLASH = '(?:u' + HEX + '{4}|U' + HEX + '{8})'
+
+    UCHAR = r'\\' + UCHAR_NO_BACKSLASH
+
+    IRIREF = r'<(?:[^\x00-\x20<>"{}|^`\\]|' + UCHAR + ')*>'
+
+    BLANK_NODE_LABEL = '_:[0-9' + PN_CHARS_U_GRP + '](?:[' + PN_CHARS_GRP + \
+                       '.]*' + PN_CHARS + ')?'
+
+    PN_PREFIX = PN_CHARS_BASE + '(?:[' + PN_CHARS_GRP + '.]*' + PN_CHARS + ')?'
+
+    PERCENT = '%' + HEX + HEX
+
+    PN_LOCAL_ESC = r'\\' + PN_LOCAL_ESC_CHARS
+
+    PLX = '(?:' + PERCENT + ')|(?:' + PN_LOCAL_ESC + ')'
+
+    PN_LOCAL = ('(?:[' + PN_CHARS_U_GRP + ':0-9' + ']|' + PLX + ')' +
+                '(?:(?:[' + PN_CHARS_GRP + '.:]|' + PLX + ')*(?:[' +
+                PN_CHARS_GRP + ':]|' + PLX + '))?')
+
+    EXPONENT = r'[eE][+-]?\d+'
+
+    # Lexer token definitions ::
+
+    tokens = {
+        'root': [
+            (r'\s+', Text),
+            # keywords ::
+            (r'(?i)(base|prefix|start|external|'
+             r'literal|iri|bnode|nonliteral|length|minlength|maxlength|'
+             r'mininclusive|minexclusive|maxinclusive|maxexclusive|'
+             r'totaldigits|fractiondigits|'
+             r'closed|extra)\b', Keyword),
+            (r'(a)\b', Keyword),
+            # IRIs ::
+            ('(' + IRIREF + ')', Name.Label),
+            # blank nodes ::
+            ('(' + BLANK_NODE_LABEL + ')', Name.Label),
+            # prefixed names ::
+            (r'(' + PN_PREFIX + r')?(\:)(' + PN_LOCAL + ')?',
+             bygroups(Name.Namespace, Punctuation, Name.Tag)),
+            # boolean literals ::
+            (r'(true|false)', Keyword.Constant),
+            # double literals ::
+            (r'[+\-]?(\d+\.\d*' + EXPONENT + r'|\.?\d+' + EXPONENT + ')', Number.Float),
+            # decimal literals ::
+            (r'[+\-]?(\d+\.\d*|\.\d+)', Number.Float),
+            # integer literals ::
+            (r'[+\-]?\d+', Number.Integer),
+            # operators ::
+            (r'[@|$&=*+?^\-~]', Operator),
+            # operator keywords ::
+            (r'(?i)(and|or|not)\b', Operator.Word),
+            # punctuation characters ::
+            (r'[(){}.;,:^\[\]]', Punctuation),
+            # line comments ::
+            (r'#[^\n]*', Comment),
+            # strings ::
+            (r'"""', String, 'triple-double-quoted-string'),
+            (r'"', String, 'single-double-quoted-string'),
+            (r"'''", String, 'triple-single-quoted-string'),
+            (r"'", String, 'single-single-quoted-string'),
+        ],
+        'triple-double-quoted-string': [
+            (r'"""', String, 'end-of-string'),
+            (r'[^\\]+', String),
+            (r'\\', String, 'string-escape'),
+        ],
+        'single-double-quoted-string': [
+            (r'"', String, 'end-of-string'),
+            (r'[^"\\\n]+', String),
+            (r'\\', String, 'string-escape'),
+        ],
+        'triple-single-quoted-string': [
+            (r"'''", String, 'end-of-string'),
+            (r'[^\\]+', String),
+            (r'\\', String.Escape, 'string-escape'),
+        ],
+        'single-single-quoted-string': [
+            (r"'", String, 'end-of-string'),
+            (r"[^'\\\n]+", String),
+            (r'\\', String, 'string-escape'),
+        ],
+        'string-escape': [
+            (UCHAR_NO_BACKSLASH, String.Escape, '#pop'),
+            (r'.', String.Escape, '#pop'),
+        ],
+        'end-of-string': [
+            (r'(@)([a-zA-Z]+(?:-[a-zA-Z0-9]+)*)',
+             bygroups(Operator, Name.Function), '#pop:2'),
+            (r'\^\^', Operator, '#pop:2'),
+            default('#pop:2'),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/rebol.py b/env/lib/python3.12/site-packages/pygments/lexers/rebol.py
new file mode 100644
index 0000000..4b37a74
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/rebol.py
@@ -0,0 +1,419 @@
+"""
+    pygments.lexers.rebol
+    ~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for the REBOL and related languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, bygroups
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Generic, Whitespace
+
+__all__ = ['RebolLexer', 'RedLexer']
+
+
+class RebolLexer(RegexLexer):
+    """
+    A REBOL lexer.
+    """
+    name = 'REBOL'
+    aliases = ['rebol']
+    filenames = ['*.r', '*.r3', '*.reb']
+    mimetypes = ['text/x-rebol']
+    url = 'http://www.rebol.com'
+    version_added = '1.1'
+
+    flags = re.IGNORECASE | re.MULTILINE
+
+    escape_re = r'(?:\^\([0-9a-f]{1,4}\)*)'
+
+    def word_callback(lexer, match):
+        word = match.group()
+
+        if re.match(".*:$", word):
+            yield match.start(), Generic.Subheading, word
+        elif re.match(
+            r'(native|alias|all|any|as-string|as-binary|bind|bound\?|case|'
+            r'catch|checksum|comment|debase|dehex|exclude|difference|disarm|'
+            r'either|else|enbase|foreach|remove-each|form|free|get|get-env|if|'
+            r'in|intersect|loop|minimum-of|maximum-of|mold|new-line|'
+            r'new-line\?|not|now|prin|print|reduce|compose|construct|repeat|'
+            r'reverse|save|script\?|set|shift|switch|throw|to-hex|trace|try|'
+            r'type\?|union|unique|unless|unprotect|unset|until|use|value\?|'
+            r'while|compress|decompress|secure|open|close|read|read-io|'
+            r'write-io|write|update|query|wait|input\?|exp|log-10|log-2|'
+            r'log-e|square-root|cosine|sine|tangent|arccosine|arcsine|'
+            r'arctangent|protect|lowercase|uppercase|entab|detab|connected\?|'
+            r'browse|launch|stats|get-modes|set-modes|to-local-file|'
+            r'to-rebol-file|encloak|decloak|create-link|do-browser|bind\?|'
+            r'hide|draw|show|size-text|textinfo|offset-to-caret|'
+            r'caret-to-offset|local-request-file|rgb-to-hsv|hsv-to-rgb|'
+            r'crypt-strength\?|dh-make-key|dh-generate-key|dh-compute-key|'
+            r'dsa-make-key|dsa-generate-key|dsa-make-signature|'
+            r'dsa-verify-signature|rsa-make-key|rsa-generate-key|'
+            r'rsa-encrypt)$', word):
+            yield match.start(), Name.Builtin, word
+        elif re.match(
+            r'(add|subtract|multiply|divide|remainder|power|and~|or~|xor~|'
+            r'minimum|maximum|negate|complement|absolute|random|head|tail|'
+            r'next|back|skip|at|pick|first|second|third|fourth|fifth|sixth|'
+            r'seventh|eighth|ninth|tenth|last|path|find|select|make|to|copy\*|'
+            r'insert|remove|change|poke|clear|trim|sort|min|max|abs|cp|'
+            r'copy)$', word):
+            yield match.start(), Name.Function, word
+        elif re.match(
+            r'(error|source|input|license|help|install|echo|Usage|with|func|'
+            r'throw-on-error|function|does|has|context|probe|\?\?|as-pair|'
+            r'mod|modulo|round|repend|about|set-net|append|join|rejoin|reform|'
+            r'remold|charset|array|replace|move|extract|forskip|forall|alter|'
+            r'first+|also|take|for|forever|dispatch|attempt|what-dir|'
+            r'change-dir|clean-path|list-dir|dirize|rename|split-path|delete|'
+            r'make-dir|delete-dir|in-dir|confirm|dump-obj|upgrade|what|'
+            r'build-tag|process-source|build-markup|decode-cgi|read-cgi|'
+            r'write-user|save-user|set-user-name|protect-system|parse-xml|'
+            r'cvs-date|cvs-version|do-boot|get-net-info|desktop|layout|'
+            r'scroll-para|get-face|alert|set-face|uninstall|unfocus|'
+            r'request-dir|center-face|do-events|net-error|decode-url|'
+            r'parse-header|parse-header-date|parse-email-addrs|import-email|'
+            r'send|build-attach-body|resend|show-popup|hide-popup|open-events|'
+            r'find-key-face|do-face|viewtop|confine|find-window|'
+            r'insert-event-func|remove-event-func|inform|dump-pane|dump-face|'
+            r'flag-face|deflag-face|clear-fields|read-net|vbug|path-thru|'
+            r'read-thru|load-thru|do-thru|launch-thru|load-image|'
+            r'request-download|do-face-alt|set-font|set-para|get-style|'
+            r'set-style|make-face|stylize|choose|hilight-text|hilight-all|'
+            r'unlight-text|focus|scroll-drag|clear-face|reset-face|scroll-face|'
+            r'resize-face|load-stock|load-stock-block|notify|request|flash|'
+            r'request-color|request-pass|request-text|request-list|'
+            r'request-date|request-file|dbug|editor|link-relative-path|'
+            r'emailer|parse-error)$', word):
+            yield match.start(), Keyword.Namespace, word
+        elif re.match(
+            r'(halt|quit|do|load|q|recycle|call|run|ask|parse|view|unview|'
+            r'return|exit|break)$', word):
+            yield match.start(), Name.Exception, word
+        elif re.match('REBOL$', word):
+            yield match.start(), Generic.Heading, word
+        elif re.match("to-.*", word):
+            yield match.start(), Keyword, word
+        elif re.match(r'(\+|-|\*|/|//|\*\*|and|or|xor|=\?|=|==|<>|<|>|<=|>=)$',
+                      word):
+            yield match.start(), Operator, word
+        elif re.match(r".*\?$", word):
+            yield match.start(), Keyword, word
+        elif re.match(r".*\!$", word):
+            yield match.start(), Keyword.Type, word
+        elif re.match("'.*", word):
+            yield match.start(), Name.Variable.Instance, word  # lit-word
+        elif re.match("#.*", word):
+            yield match.start(), Name.Label, word  # issue
+        elif re.match("%.*", word):
+            yield match.start(), Name.Decorator, word  # file
+        else:
+            yield match.start(), Name.Variable, word
+
+    tokens = {
+        'root': [
+            (r'\s+', Text),
+            (r'#"', String.Char, 'char'),
+            (r'#\{[0-9a-f]*\}', Number.Hex),
+            (r'2#\{', Number.Hex, 'bin2'),
+            (r'64#\{[0-9a-z+/=\s]*\}', Number.Hex),
+            (r'"', String, 'string'),
+            (r'\{', String, 'string2'),
+            (r';#+.*\n', Comment.Special),
+            (r';\*+.*\n', Comment.Preproc),
+            (r';.*\n', Comment),
+            (r'%"', Name.Decorator, 'stringFile'),
+            (r'%[^(^{")\s\[\]]+', Name.Decorator),
+            (r'[+-]?([a-z]{1,3})?\$\d+(\.\d+)?', Number.Float),  # money
+            (r'[+-]?\d+\:\d+(\:\d+)?(\.\d+)?', String.Other),    # time
+            (r'\d+[\-/][0-9a-z]+[\-/]\d+(\/\d+\:\d+((\:\d+)?'
+             r'([.\d+]?([+-]?\d+:\d+)?)?)?)?', String.Other),   # date
+            (r'\d+(\.\d+)+\.\d+', Keyword.Constant),             # tuple
+            (r'\d+X\d+', Keyword.Constant),                   # pair
+            (r'[+-]?\d+(\'\d+)?([.,]\d*)?E[+-]?\d+', Number.Float),
+            (r'[+-]?\d+(\'\d+)?[.,]\d*', Number.Float),
+            (r'[+-]?\d+(\'\d+)?', Number),
+            (r'[\[\]()]', Generic.Strong),
+            (r'[a-z]+[^(^{"\s:)]*://[^(^{"\s)]*', Name.Decorator),  # url
+            (r'mailto:[^(^{"@\s)]+@[^(^{"@\s)]+', Name.Decorator),  # url
+            (r'[^(^{"@\s)]+@[^(^{"@\s)]+', Name.Decorator),         # email
+            (r'comment\s"', Comment, 'commentString1'),
+            (r'comment\s\{', Comment, 'commentString2'),
+            (r'comment\s\[', Comment, 'commentBlock'),
+            (r'comment\s[^(\s{"\[]+', Comment),
+            (r'/[^(^{")\s/[\]]*', Name.Attribute),
+            (r'([^(^{")\s/[\]]+)(?=[:({"\s/\[\]])', word_callback),
+            (r'<[\w:.-]*>', Name.Tag),
+            (r'<[^(<>\s")]+', Name.Tag, 'tag'),
+            (r'([^(^{")\s]+)', Text),
+        ],
+        'string': [
+            (r'[^(^")]+', String),
+            (escape_re, String.Escape),
+            (r'[(|)]+', String),
+            (r'\^.', String.Escape),
+            (r'"', String, '#pop'),
+        ],
+        'string2': [
+            (r'[^(^{})]+', String),
+            (escape_re, String.Escape),
+            (r'[(|)]+', String),
+            (r'\^.', String.Escape),
+            (r'\{', String, '#push'),
+            (r'\}', String, '#pop'),
+        ],
+        'stringFile': [
+            (r'[^(^")]+', Name.Decorator),
+            (escape_re, Name.Decorator),
+            (r'\^.', Name.Decorator),
+            (r'"', Name.Decorator, '#pop'),
+        ],
+        'char': [
+            (escape_re + '"', String.Char, '#pop'),
+            (r'\^."', String.Char, '#pop'),
+            (r'."', String.Char, '#pop'),
+        ],
+        'tag': [
+            (escape_re, Name.Tag),
+            (r'"', Name.Tag, 'tagString'),
+            (r'[^(<>\r\n")]+', Name.Tag),
+            (r'>', Name.Tag, '#pop'),
+        ],
+        'tagString': [
+            (r'[^(^")]+', Name.Tag),
+            (escape_re, Name.Tag),
+            (r'[(|)]+', Name.Tag),
+            (r'\^.', Name.Tag),
+            (r'"', Name.Tag, '#pop'),
+        ],
+        'tuple': [
+            (r'(\d+\.)+', Keyword.Constant),
+            (r'\d+', Keyword.Constant, '#pop'),
+        ],
+        'bin2': [
+            (r'\s+', Number.Hex),
+            (r'([01]\s*){8}', Number.Hex),
+            (r'\}', Number.Hex, '#pop'),
+        ],
+        'commentString1': [
+            (r'[^(^")]+', Comment),
+            (escape_re, Comment),
+            (r'[(|)]+', Comment),
+            (r'\^.', Comment),
+            (r'"', Comment, '#pop'),
+        ],
+        'commentString2': [
+            (r'[^(^{})]+', Comment),
+            (escape_re, Comment),
+            (r'[(|)]+', Comment),
+            (r'\^.', Comment),
+            (r'\{', Comment, '#push'),
+            (r'\}', Comment, '#pop'),
+        ],
+        'commentBlock': [
+            (r'\[', Comment, '#push'),
+            (r'\]', Comment, '#pop'),
+            (r'"', Comment, "commentString1"),
+            (r'\{', Comment, "commentString2"),
+            (r'[^(\[\]"{)]+', Comment),
+        ],
+    }
+
+    def analyse_text(text):
+        """
+        Check if code contains REBOL header and so it probably not R code
+        """
+        if re.match(r'^\s*REBOL\s*\[', text, re.IGNORECASE):
+            # The code starts with REBOL header
+            return 1.0
+        elif re.search(r'\s*REBOL\s*\[', text, re.IGNORECASE):
+            # The code contains REBOL header but also some text before it
+            return 0.5
+
+
+class RedLexer(RegexLexer):
+    """
+    A Red-language lexer.
+    """
+    name = 'Red'
+    aliases = ['red', 'red/system']
+    filenames = ['*.red', '*.reds']
+    mimetypes = ['text/x-red', 'text/x-red-system']
+    url = 'https://www.red-lang.org'
+    version_added = '2.0'
+
+    flags = re.IGNORECASE | re.MULTILINE
+
+    escape_re = r'(?:\^\([0-9a-f]{1,4}\)*)'
+
+    def word_callback(lexer, match):
+        word = match.group()
+
+        if re.match(".*:$", word):
+            yield match.start(), Generic.Subheading, word
+        elif re.match(r'(if|unless|either|any|all|while|until|loop|repeat|'
+                      r'foreach|forall|func|function|does|has|switch|'
+                      r'case|reduce|compose|get|set|print|prin|equal\?|'
+                      r'not-equal\?|strict-equal\?|lesser\?|greater\?|lesser-or-equal\?|'
+                      r'greater-or-equal\?|same\?|not|type\?|stats|'
+                      r'bind|union|replace|charset|routine)$', word):
+            yield match.start(), Name.Builtin, word
+        elif re.match(r'(make|random|reflect|to|form|mold|absolute|add|divide|multiply|negate|'
+                      r'power|remainder|round|subtract|even\?|odd\?|and~|complement|or~|xor~|'
+                      r'append|at|back|change|clear|copy|find|head|head\?|index\?|insert|'
+                      r'length\?|next|pick|poke|remove|reverse|select|sort|skip|swap|tail|tail\?|'
+                      r'take|trim|create|close|delete|modify|open|open\?|query|read|rename|'
+                      r'update|write)$', word):
+            yield match.start(), Name.Function, word
+        elif re.match(r'(yes|on|no|off|true|false|tab|cr|lf|newline|escape|slash|sp|space|null|'
+                      r'none|crlf|dot|null-byte)$', word):
+            yield match.start(), Name.Builtin.Pseudo, word
+        elif re.match(r'(#system-global|#include|#enum|#define|#either|#if|#import|#export|'
+                      r'#switch|#default|#get-definition)$', word):
+            yield match.start(), Keyword.Namespace, word
+        elif re.match(r'(system|halt|quit|quit-return|do|load|q|recycle|call|run|ask|parse|'
+                      r'raise-error|return|exit|break|alias|push|pop|probe|\?\?|spec-of|body-of|'
+                      r'quote|forever)$', word):
+            yield match.start(), Name.Exception, word
+        elif re.match(r'(action\?|block\?|char\?|datatype\?|file\?|function\?|get-path\?|zero\?|'
+                      r'get-word\?|integer\?|issue\?|lit-path\?|lit-word\?|logic\?|native\?|'
+                      r'op\?|paren\?|path\?|refinement\?|set-path\?|set-word\?|string\?|unset\?|'
+                      r'any-struct\?|none\?|word\?|any-series\?)$', word):
+            yield match.start(), Keyword, word
+        elif re.match(r'(JNICALL|stdcall|cdecl|infix)$', word):
+            yield match.start(), Keyword.Namespace, word
+        elif re.match("to-.*", word):
+            yield match.start(), Keyword, word
+        elif re.match(r'(\+|-\*\*|-|\*\*|//|/|\*|and|or|xor|=\?|===|==|=|<>|<=|>=|'
+                      r'<<<|>>>|<<|>>|<|>%)$', word):
+            yield match.start(), Operator, word
+        elif re.match(r".*\!$", word):
+            yield match.start(), Keyword.Type, word
+        elif re.match("'.*", word):
+            yield match.start(), Name.Variable.Instance, word  # lit-word
+        elif re.match("#.*", word):
+            yield match.start(), Name.Label, word  # issue
+        elif re.match("%.*", word):
+            yield match.start(), Name.Decorator, word  # file
+        elif re.match(":.*", word):
+            yield match.start(), Generic.Subheading, word  # get-word
+        else:
+            yield match.start(), Name.Variable, word
+
+    tokens = {
+        'root': [
+            (r'\s+', Text),
+            (r'#"', String.Char, 'char'),
+            (r'#\{[0-9a-f\s]*\}', Number.Hex),
+            (r'2#\{', Number.Hex, 'bin2'),
+            (r'64#\{[0-9a-z+/=\s]*\}', Number.Hex),
+            (r'([0-9a-f]+)(h)((\s)|(?=[\[\]{}"()]))',
+             bygroups(Number.Hex, Name.Variable, Whitespace)),
+            (r'"', String, 'string'),
+            (r'\{', String, 'string2'),
+            (r';#+.*\n', Comment.Special),
+            (r';\*+.*\n', Comment.Preproc),
+            (r';.*\n', Comment),
+            (r'%"', Name.Decorator, 'stringFile'),
+            (r'%[^(^{")\s\[\]]+', Name.Decorator),
+            (r'[+-]?([a-z]{1,3})?\$\d+(\.\d+)?', Number.Float),  # money
+            (r'[+-]?\d+\:\d+(\:\d+)?(\.\d+)?', String.Other),    # time
+            (r'\d+[\-/][0-9a-z]+[\-/]\d+(/\d+:\d+((:\d+)?'
+             r'([\.\d+]?([+-]?\d+:\d+)?)?)?)?', String.Other),   # date
+            (r'\d+(\.\d+)+\.\d+', Keyword.Constant),             # tuple
+            (r'\d+X\d+', Keyword.Constant),                   # pair
+            (r'[+-]?\d+(\'\d+)?([.,]\d*)?E[+-]?\d+', Number.Float),
+            (r'[+-]?\d+(\'\d+)?[.,]\d*', Number.Float),
+            (r'[+-]?\d+(\'\d+)?', Number),
+            (r'[\[\]()]', Generic.Strong),
+            (r'[a-z]+[^(^{"\s:)]*://[^(^{"\s)]*', Name.Decorator),  # url
+            (r'mailto:[^(^{"@\s)]+@[^(^{"@\s)]+', Name.Decorator),  # url
+            (r'[^(^{"@\s)]+@[^(^{"@\s)]+', Name.Decorator),         # email
+            (r'comment\s"', Comment, 'commentString1'),
+            (r'comment\s\{', Comment, 'commentString2'),
+            (r'comment\s\[', Comment, 'commentBlock'),
+            (r'comment\s[^(\s{"\[]+', Comment),
+            (r'/[^(^{^")\s/[\]]*', Name.Attribute),
+            (r'([^(^{^")\s/[\]]+)(?=[:({"\s/\[\]])', word_callback),
+            (r'<[\w:.-]*>', Name.Tag),
+            (r'<[^(<>\s")]+', Name.Tag, 'tag'),
+            (r'([^(^{")\s]+)', Text),
+        ],
+        'string': [
+            (r'[^(^")]+', String),
+            (escape_re, String.Escape),
+            (r'[(|)]+', String),
+            (r'\^.', String.Escape),
+            (r'"', String, '#pop'),
+        ],
+        'string2': [
+            (r'[^(^{})]+', String),
+            (escape_re, String.Escape),
+            (r'[(|)]+', String),
+            (r'\^.', String.Escape),
+            (r'\{', String, '#push'),
+            (r'\}', String, '#pop'),
+        ],
+        'stringFile': [
+            (r'[^(^")]+', Name.Decorator),
+            (escape_re, Name.Decorator),
+            (r'\^.', Name.Decorator),
+            (r'"', Name.Decorator, '#pop'),
+        ],
+        'char': [
+            (escape_re + '"', String.Char, '#pop'),
+            (r'\^."', String.Char, '#pop'),
+            (r'."', String.Char, '#pop'),
+        ],
+        'tag': [
+            (escape_re, Name.Tag),
+            (r'"', Name.Tag, 'tagString'),
+            (r'[^(<>\r\n")]+', Name.Tag),
+            (r'>', Name.Tag, '#pop'),
+        ],
+        'tagString': [
+            (r'[^(^")]+', Name.Tag),
+            (escape_re, Name.Tag),
+            (r'[(|)]+', Name.Tag),
+            (r'\^.', Name.Tag),
+            (r'"', Name.Tag, '#pop'),
+        ],
+        'tuple': [
+            (r'(\d+\.)+', Keyword.Constant),
+            (r'\d+', Keyword.Constant, '#pop'),
+        ],
+        'bin2': [
+            (r'\s+', Number.Hex),
+            (r'([01]\s*){8}', Number.Hex),
+            (r'\}', Number.Hex, '#pop'),
+        ],
+        'commentString1': [
+            (r'[^(^")]+', Comment),
+            (escape_re, Comment),
+            (r'[(|)]+', Comment),
+            (r'\^.', Comment),
+            (r'"', Comment, '#pop'),
+        ],
+        'commentString2': [
+            (r'[^(^{})]+', Comment),
+            (escape_re, Comment),
+            (r'[(|)]+', Comment),
+            (r'\^.', Comment),
+            (r'\{', Comment, '#push'),
+            (r'\}', Comment, '#pop'),
+        ],
+        'commentBlock': [
+            (r'\[', Comment, '#push'),
+            (r'\]', Comment, '#pop'),
+            (r'"', Comment, "commentString1"),
+            (r'\{', Comment, "commentString2"),
+            (r'[^(\[\]"{)]+', Comment),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/rego.py b/env/lib/python3.12/site-packages/pygments/lexers/rego.py
new file mode 100644
index 0000000..6f2e3e9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/rego.py
@@ -0,0 +1,57 @@
+"""
+    pygments.lexers.rego
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for the Rego policy languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, words
+from pygments.token import Comment, Operator, Keyword, Name, String, Number, Punctuation, Whitespace
+
+class RegoLexer(RegexLexer):
+    """
+    For Rego source.
+    """
+    name = 'Rego'
+    url = 'https://www.openpolicyagent.org/docs/latest/policy-language/'
+    filenames = ['*.rego']
+    aliases = ['rego']
+    mimetypes = ['text/x-rego']
+    version_added = '2.19'
+
+    reserved_words = (
+        'as', 'contains', 'data', 'default', 'else', 'every', 'false',
+        'if', 'in', 'import', 'package', 'not', 'null',
+        'some', 'true', 'with'
+    )
+
+    builtins = (
+        # https://www.openpolicyagent.org/docs/latest/philosophy/#the-opa-document-model
+        'data',  # Global variable for accessing base and virtual documents
+        'input', # Represents synchronously pushed base documents
+    )
+
+    tokens = {
+        'root': [
+            (r'\n', Whitespace),
+            (r'\s+', Whitespace),
+            (r'#.*?$', Comment.Single),
+            (words(reserved_words, suffix=r'\b'), Keyword),
+            (words(builtins, suffix=r'\b'), Name.Builtin),
+            (r'[a-zA-Z_][a-zA-Z0-9_]*', Name),
+            (r'"(\\\\|\\"|[^"])*"', String.Double),
+            (r'`[^`]*`', String.Backtick),
+            (r'-?\d+(\.\d+)?', Number),
+            (r'(==|!=|<=|>=|:=)', Operator),  # Compound operators
+            (r'[=<>+\-*/%&|]', Operator),     # Single-character operators
+            (r'[\[\]{}(),.:;]', Punctuation),
+        ]
+    }
+
+__all__ = ['RegoLexer']
+
+
+
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/resource.py b/env/lib/python3.12/site-packages/pygments/lexers/resource.py
new file mode 100644
index 0000000..9593c21
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/resource.py
@@ -0,0 +1,83 @@
+"""
+    pygments.lexers.resource
+    ~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for resource definition files.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, bygroups, words
+from pygments.token import Comment, String, Number, Operator, Text, \
+    Keyword, Name
+
+__all__ = ['ResourceLexer']
+
+
+class ResourceLexer(RegexLexer):
+    """Lexer for ICU Resource bundles.
+    """
+    name = 'ResourceBundle'
+    aliases = ['resourcebundle', 'resource']
+    filenames = []
+    url = 'https://unicode-org.github.io/icu/userguide/locale/resources.html'
+    version_added = '2.0'
+
+    _types = (':table', ':array', ':string', ':bin', ':import', ':intvector',
+              ':int', ':alias')
+
+    flags = re.MULTILINE | re.IGNORECASE
+    tokens = {
+        'root': [
+            (r'//.*?$', Comment),
+            (r'"', String, 'string'),
+            (r'-?\d+', Number.Integer),
+            (r'[,{}]', Operator),
+            (r'([^\s{{:]+)(\s*)({}?)'.format('|'.join(_types)),
+             bygroups(Name, Text, Keyword)),
+            (r'\s+', Text),
+            (words(_types), Keyword),
+        ],
+        'string': [
+            (r'(\\x[0-9a-f]{2}|\\u[0-9a-f]{4}|\\U00[0-9a-f]{6}|'
+             r'\\[0-7]{1,3}|\\c.|\\[abtnvfre\'"?\\]|\\\{|[^"{\\])+', String),
+            (r'\{', String.Escape, 'msgname'),
+            (r'"', String, '#pop')
+        ],
+        'msgname': [
+            (r'([^{},]+)(\s*)', bygroups(Name, String.Escape), ('#pop', 'message'))
+        ],
+        'message': [
+            (r'\{', String.Escape, 'msgname'),
+            (r'\}', String.Escape, '#pop'),
+            (r'(,)(\s*)([a-z]+)(\s*\})',
+             bygroups(Operator, String.Escape, Keyword, String.Escape), '#pop'),
+            (r'(,)(\s*)([a-z]+)(\s*)(,)(\s*)(offset)(\s*)(:)(\s*)(-?\d+)(\s*)',
+             bygroups(Operator, String.Escape, Keyword, String.Escape, Operator,
+                      String.Escape, Operator.Word, String.Escape, Operator,
+                      String.Escape, Number.Integer, String.Escape), 'choice'),
+            (r'(,)(\s*)([a-z]+)(\s*)(,)(\s*)',
+             bygroups(Operator, String.Escape, Keyword, String.Escape, Operator,
+                      String.Escape), 'choice'),
+            (r'\s+', String.Escape)
+        ],
+        'choice': [
+            (r'(=|<|>|<=|>=|!=)(-?\d+)(\s*\{)',
+             bygroups(Operator, Number.Integer, String.Escape), 'message'),
+            (r'([a-z]+)(\s*\{)', bygroups(Keyword.Type, String.Escape), 'str'),
+            (r'\}', String.Escape, ('#pop', '#pop')),
+            (r'\s+', String.Escape)
+        ],
+        'str': [
+            (r'\}', String.Escape, '#pop'),
+            (r'\{', String.Escape, 'msgname'),
+            (r'[^{}]+', String)
+        ]
+    }
+
+    def analyse_text(text):
+        if text.startswith('root:table'):
+            return 1.0
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/ride.py b/env/lib/python3.12/site-packages/pygments/lexers/ride.py
new file mode 100644
index 0000000..4d60c29
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/ride.py
@@ -0,0 +1,138 @@
+"""
+    pygments.lexers.ride
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for the Ride programming language.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, words, include
+from pygments.token import Comment, Keyword, Name, Number, Punctuation, \
+    String, Text
+
+__all__ = ['RideLexer']
+
+
+class RideLexer(RegexLexer):
+    """
+    For Ride source code.
+    """
+
+    name = 'Ride'
+    aliases = ['ride']
+    filenames = ['*.ride']
+    mimetypes = ['text/x-ride']
+    url = 'https://docs.waves.tech/en/ride'
+    version_added = '2.6'
+
+    validName = r'[a-zA-Z_][a-zA-Z0-9_\']*'
+
+    builtinOps = (
+        '||', '|', '>=', '>', '==', '!',
+        '=', '<=', '<', '::', ':+', ':', '!=', '/',
+        '.', '=>', '-', '+', '*', '&&', '%', '++',
+    )
+
+    globalVariablesName = (
+        'NOALG', 'MD5', 'SHA1', 'SHA224', 'SHA256', 'SHA384', 'SHA512',
+        'SHA3224', 'SHA3256', 'SHA3384', 'SHA3512', 'nil', 'this', 'unit',
+        'height', 'lastBlock', 'Buy', 'Sell', 'CEILING', 'FLOOR', 'DOWN',
+        'HALFDOWN', 'HALFEVEN', 'HALFUP', 'UP',
+    )
+
+    typesName = (
+        'Unit', 'Int', 'Boolean', 'ByteVector', 'String', 'Address', 'Alias',
+        'Transfer', 'AssetPair', 'DataEntry', 'Order', 'Transaction',
+        'GenesisTransaction', 'PaymentTransaction', 'ReissueTransaction',
+        'BurnTransaction', 'MassTransferTransaction', 'ExchangeTransaction',
+        'TransferTransaction', 'SetAssetScriptTransaction',
+        'InvokeScriptTransaction', 'IssueTransaction', 'LeaseTransaction',
+        'LeaseCancelTransaction', 'CreateAliasTransaction',
+        'SetScriptTransaction', 'SponsorFeeTransaction', 'DataTransaction',
+        'WriteSet', 'AttachedPayment', 'ScriptTransfer', 'TransferSet',
+        'ScriptResult', 'Invocation', 'Asset', 'BlockInfo', 'Issue', 'Reissue',
+        'Burn', 'NoAlg', 'Md5', 'Sha1', 'Sha224', 'Sha256', 'Sha384', 'Sha512',
+        'Sha3224', 'Sha3256', 'Sha3384', 'Sha3512', 'BinaryEntry',
+        'BooleanEntry', 'IntegerEntry', 'StringEntry', 'List', 'Ceiling',
+        'Down', 'Floor', 'HalfDown', 'HalfEven', 'HalfUp', 'Up',
+    )
+
+    functionsName = (
+        'fraction', 'size', 'toBytes', 'take', 'drop', 'takeRight', 'dropRight',
+        'toString', 'isDefined', 'extract', 'throw', 'getElement', 'value',
+        'cons', 'toUtf8String', 'toInt', 'indexOf', 'lastIndexOf', 'split',
+        'parseInt', 'parseIntValue', 'keccak256', 'blake2b256', 'sha256',
+        'sigVerify', 'toBase58String', 'fromBase58String', 'toBase64String',
+        'fromBase64String', 'transactionById', 'transactionHeightById',
+        'getInteger', 'getBoolean', 'getBinary', 'getString',
+        'addressFromPublicKey', 'addressFromString', 'addressFromRecipient',
+        'assetBalance', 'wavesBalance', 'getIntegerValue', 'getBooleanValue',
+        'getBinaryValue', 'getStringValue', 'addressFromStringValue',
+        'assetInfo', 'rsaVerify', 'checkMerkleProof', 'median',
+        'valueOrElse', 'valueOrErrorMessage', 'contains', 'log', 'pow',
+        'toBase16String', 'fromBase16String', 'blockInfoByHeight',
+        'transferTransactionById',
+    )
+
+    reservedWords = words((
+        'match', 'case', 'else', 'func', 'if',
+        'let', 'then', '@Callable', '@Verifier',
+    ), suffix=r'\b')
+
+    tokens = {
+        'root': [
+            # Comments
+            (r'#.*', Comment.Single),
+            # Whitespace
+            (r'\s+', Text),
+            # Strings
+            (r'"', String, 'doublequote'),
+            (r'utf8\'', String, 'utf8quote'),
+            (r'base(58|64|16)\'', String, 'singlequote'),
+            # Keywords
+            (reservedWords, Keyword.Reserved),
+            (r'\{-#.*?#-\}', Keyword.Reserved),
+            (r'FOLD<\d+>', Keyword.Reserved),
+            # Types
+            (words(typesName), Keyword.Type),
+            # Main
+            # (specialName, Keyword.Reserved),
+            # Prefix Operators
+            (words(builtinOps, prefix=r'\(', suffix=r'\)'), Name.Function),
+            # Infix Operators
+            (words(builtinOps), Name.Function),
+            (words(globalVariablesName), Name.Function),
+            (words(functionsName), Name.Function),
+            # Numbers
+            include('numbers'),
+            # Variable Names
+            (validName, Name.Variable),
+            # Parens
+            (r'[,()\[\]{}]', Punctuation),
+        ],
+
+        'doublequote': [
+            (r'\\u[0-9a-fA-F]{4}', String.Escape),
+            (r'\\[nrfvb\\"]', String.Escape),
+            (r'[^"]', String),
+            (r'"', String, '#pop'),
+        ],
+
+        'utf8quote': [
+            (r'\\u[0-9a-fA-F]{4}', String.Escape),
+            (r'\\[nrfvb\\\']', String.Escape),
+            (r'[^\']', String),
+            (r'\'', String, '#pop'),
+        ],
+
+        'singlequote': [
+            (r'[^\']', String),
+            (r'\'', String, '#pop'),
+        ],
+
+        'numbers': [
+            (r'_?\d+', Number.Integer),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/rita.py b/env/lib/python3.12/site-packages/pygments/lexers/rita.py
new file mode 100644
index 0000000..536aaff
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/rita.py
@@ -0,0 +1,42 @@
+"""
+    pygments.lexers.rita
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for RITA language
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer
+from pygments.token import Comment, Operator, Keyword, Name, Literal, \
+    Punctuation, Whitespace
+
+__all__ = ['RitaLexer']
+
+
+class RitaLexer(RegexLexer):
+    """
+    Lexer for RITA.
+    """
+    name = 'Rita'
+    url = 'https://github.com/zaibacu/rita-dsl'
+    filenames = ['*.rita']
+    aliases = ['rita']
+    mimetypes = ['text/rita']
+    version_added = '2.11'
+
+    tokens = {
+        'root': [
+            (r'\n', Whitespace),
+            (r'\s+', Whitespace),
+            (r'#(.*?)\n', Comment.Single),
+            (r'@(.*?)\n', Operator),  # Yes, whole line as an operator
+            (r'"(\w|\d|\s|(\\")|[\'_\-./,\?\!])+?"', Literal),
+            (r'\'(\w|\d|\s|(\\\')|["_\-./,\?\!])+?\'', Literal),
+            (r'([A-Z_]+)', Keyword),
+            (r'([a-z0-9_]+)', Name),
+            (r'((->)|[!?+*|=])', Operator),
+            (r'[\(\),\{\}]', Punctuation)
+        ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/rnc.py b/env/lib/python3.12/site-packages/pygments/lexers/rnc.py
new file mode 100644
index 0000000..b7a06bb
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/rnc.py
@@ -0,0 +1,66 @@
+"""
+    pygments.lexers.rnc
+    ~~~~~~~~~~~~~~~~~~~
+
+    Lexer for Relax-NG Compact syntax
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Punctuation
+
+__all__ = ['RNCCompactLexer']
+
+
+class RNCCompactLexer(RegexLexer):
+    """
+    For RelaxNG-compact syntax.
+    """
+
+    name = 'Relax-NG Compact'
+    url = 'http://relaxng.org'
+    aliases = ['rng-compact', 'rnc']
+    filenames = ['*.rnc']
+    version_added = '2.2'
+
+    tokens = {
+        'root': [
+            (r'namespace\b', Keyword.Namespace),
+            (r'(?:default|datatypes)\b', Keyword.Declaration),
+            (r'##.*$', Comment.Preproc),
+            (r'#.*$', Comment.Single),
+            (r'"[^"]*"', String.Double),
+            # TODO single quoted strings and escape sequences outside of
+            # double-quoted strings
+            (r'(?:element|attribute|mixed)\b', Keyword.Declaration, 'variable'),
+            (r'(text\b|xsd:[^ ]+)', Keyword.Type, 'maybe_xsdattributes'),
+            (r'[,?&*=|~]|>>', Operator),
+            (r'[(){}]', Punctuation),
+            (r'.', Text),
+        ],
+
+        # a variable has been declared using `element` or `attribute`
+        'variable': [
+            (r'[^{]+', Name.Variable),
+            (r'\{', Punctuation, '#pop'),
+        ],
+
+        # after an xsd: declaration there may be attributes
+        'maybe_xsdattributes': [
+            (r'\{', Punctuation, 'xsdattributes'),
+            (r'\}', Punctuation, '#pop'),
+            (r'.', Text),
+        ],
+
+        # attributes take the form { key1 = value1 key2 = value2 ... }
+        'xsdattributes': [
+            (r'[^ =}]', Name.Attribute),
+            (r'=', Operator),
+            (r'"[^"]*"', String.Double),
+            (r'\}', Punctuation, '#pop'),
+            (r'.', Text),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/roboconf.py b/env/lib/python3.12/site-packages/pygments/lexers/roboconf.py
new file mode 100644
index 0000000..31adba9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/roboconf.py
@@ -0,0 +1,81 @@
+"""
+    pygments.lexers.roboconf
+    ~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Roboconf DSL.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, words, re
+from pygments.token import Text, Operator, Keyword, Name, Comment
+
+__all__ = ['RoboconfGraphLexer', 'RoboconfInstancesLexer']
+
+
+class RoboconfGraphLexer(RegexLexer):
+    """
+    Lexer for Roboconf graph files.
+    """
+    name = 'Roboconf Graph'
+    aliases = ['roboconf-graph']
+    filenames = ['*.graph']
+    url = 'https://roboconf.github.io/en/user-guide/graph-definition.html'
+    version_added = '2.1'
+
+    flags = re.IGNORECASE | re.MULTILINE
+    tokens = {
+        'root': [
+            # Skip white spaces
+            (r'\s+', Text),
+
+            # There is one operator
+            (r'=', Operator),
+
+            # Keywords
+            (words(('facet', 'import'), suffix=r'\s*\b', prefix=r'\b'), Keyword),
+            (words((
+                'installer', 'extends', 'exports', 'imports', 'facets',
+                'children'), suffix=r'\s*:?', prefix=r'\b'), Name),
+
+            # Comments
+            (r'#.*\n', Comment),
+
+            # Default
+            (r'[^#]', Text),
+            (r'.*\n', Text)
+        ]
+    }
+
+
+class RoboconfInstancesLexer(RegexLexer):
+    """
+    Lexer for Roboconf instances files.
+    """
+    name = 'Roboconf Instances'
+    aliases = ['roboconf-instances']
+    filenames = ['*.instances']
+    url = 'https://roboconf.github.io'
+    version_added = '2.1'
+
+    flags = re.IGNORECASE | re.MULTILINE
+    tokens = {
+        'root': [
+
+            # Skip white spaces
+            (r'\s+', Text),
+
+            # Keywords
+            (words(('instance of', 'import'), suffix=r'\s*\b', prefix=r'\b'), Keyword),
+            (words(('name', 'count'), suffix=r's*:?', prefix=r'\b'), Name),
+            (r'\s*[\w.-]+\s*:', Name),
+
+            # Comments
+            (r'#.*\n', Comment),
+
+            # Default
+            (r'[^#]', Text),
+            (r'.*\n', Text)
+        ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/robotframework.py b/env/lib/python3.12/site-packages/pygments/lexers/robotframework.py
new file mode 100644
index 0000000..f92d567
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/robotframework.py
@@ -0,0 +1,551 @@
+"""
+    pygments.lexers.robotframework
+    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for Robot Framework.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+#  Copyright 2012 Nokia Siemens Networks Oyj
+#
+#  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 re
+
+from pygments.lexer import Lexer
+from pygments.token import Token
+
+__all__ = ['RobotFrameworkLexer']
+
+
+HEADING = Token.Generic.Heading
+SETTING = Token.Keyword.Namespace
+IMPORT = Token.Name.Namespace
+TC_KW_NAME = Token.Generic.Subheading
+KEYWORD = Token.Name.Function
+ARGUMENT = Token.String
+VARIABLE = Token.Name.Variable
+COMMENT = Token.Comment
+SEPARATOR = Token.Punctuation
+SYNTAX = Token.Punctuation
+GHERKIN = Token.Generic.Emph
+ERROR = Token.Error
+
+
+def normalize(string, remove=''):
+    string = string.lower()
+    for char in remove + ' ':
+        if char in string:
+            string = string.replace(char, '')
+    return string
+
+
+class RobotFrameworkLexer(Lexer):
+    """
+    For Robot Framework test data.
+
+    Supports both space and pipe separated plain text formats.
+    """
+    name = 'RobotFramework'
+    url = 'http://robotframework.org'
+    aliases = ['robotframework']
+    filenames = ['*.robot', '*.resource']
+    mimetypes = ['text/x-robotframework']
+    version_added = '1.6'
+
+    def __init__(self, **options):
+        options['tabsize'] = 2
+        options['encoding'] = 'UTF-8'
+        Lexer.__init__(self, **options)
+
+    def get_tokens_unprocessed(self, text):
+        row_tokenizer = RowTokenizer()
+        var_tokenizer = VariableTokenizer()
+        index = 0
+        for row in text.splitlines():
+            for value, token in row_tokenizer.tokenize(row):
+                for value, token in var_tokenizer.tokenize(value, token):
+                    if value:
+                        yield index, token, str(value)
+                        index += len(value)
+
+
+class VariableTokenizer:
+
+    def tokenize(self, string, token):
+        var = VariableSplitter(string, identifiers='$@%&')
+        if var.start < 0 or token in (COMMENT, ERROR):
+            yield string, token
+            return
+        for value, token in self._tokenize(var, string, token):
+            if value:
+                yield value, token
+
+    def _tokenize(self, var, string, orig_token):
+        before = string[:var.start]
+        yield before, orig_token
+        yield var.identifier + '{', SYNTAX
+        yield from self.tokenize(var.base, VARIABLE)
+        yield '}', SYNTAX
+        if var.index is not None:
+            yield '[', SYNTAX
+            yield from self.tokenize(var.index, VARIABLE)
+            yield ']', SYNTAX
+        yield from self.tokenize(string[var.end:], orig_token)
+
+
+class RowTokenizer:
+
+    def __init__(self):
+        self._table = UnknownTable()
+        self._splitter = RowSplitter()
+        testcases = TestCaseTable()
+        settings = SettingTable(testcases.set_default_template)
+        variables = VariableTable()
+        keywords = KeywordTable()
+        self._tables = {'settings': settings, 'setting': settings,
+                        'metadata': settings,
+                        'variables': variables, 'variable': variables,
+                        'testcases': testcases, 'testcase': testcases,
+                        'tasks': testcases, 'task': testcases,
+                        'keywords': keywords, 'keyword': keywords,
+                        'userkeywords': keywords, 'userkeyword': keywords}
+
+    def tokenize(self, row):
+        commented = False
+        heading = False
+        for index, value in enumerate(self._splitter.split(row)):
+            # First value, and every second after that, is a separator.
+            index, separator = divmod(index-1, 2)
+            if value.startswith('#'):
+                commented = True
+            elif index == 0 and value.startswith('*'):
+                self._table = self._start_table(value)
+                heading = True
+            yield from self._tokenize(value, index, commented,
+                                      separator, heading)
+        self._table.end_row()
+
+    def _start_table(self, header):
+        name = normalize(header, remove='*')
+        return self._tables.get(name, UnknownTable())
+
+    def _tokenize(self, value, index, commented, separator, heading):
+        if commented:
+            yield value, COMMENT
+        elif separator:
+            yield value, SEPARATOR
+        elif heading:
+            yield value, HEADING
+        else:
+            yield from self._table.tokenize(value, index)
+
+
+class RowSplitter:
+    _space_splitter = re.compile('( {2,})')
+    _pipe_splitter = re.compile(r'((?:^| +)\|(?: +|$))')
+
+    def split(self, row):
+        splitter = (row.startswith('| ') and self._split_from_pipes
+                    or self._split_from_spaces)
+        yield from splitter(row)
+        yield '\n'
+
+    def _split_from_spaces(self, row):
+        yield ''  # Start with (pseudo)separator similarly as with pipes
+        yield from self._space_splitter.split(row)
+
+    def _split_from_pipes(self, row):
+        _, separator, rest = self._pipe_splitter.split(row, 1)
+        yield separator
+        while self._pipe_splitter.search(rest):
+            cell, separator, rest = self._pipe_splitter.split(rest, 1)
+            yield cell
+            yield separator
+        yield rest
+
+
+class Tokenizer:
+    _tokens = None
+
+    def __init__(self):
+        self._index = 0
+
+    def tokenize(self, value):
+        values_and_tokens = self._tokenize(value, self._index)
+        self._index += 1
+        if isinstance(values_and_tokens, type(Token)):
+            values_and_tokens = [(value, values_and_tokens)]
+        return values_and_tokens
+
+    def _tokenize(self, value, index):
+        index = min(index, len(self._tokens) - 1)
+        return self._tokens[index]
+
+    def _is_assign(self, value):
+        if value.endswith('='):
+            value = value[:-1].strip()
+        var = VariableSplitter(value, identifiers='$@&')
+        return var.start == 0 and var.end == len(value)
+
+
+class Comment(Tokenizer):
+    _tokens = (COMMENT,)
+
+
+class Setting(Tokenizer):
+    _tokens = (SETTING, ARGUMENT)
+    _keyword_settings = ('suitesetup', 'suiteprecondition', 'suiteteardown',
+                         'suitepostcondition', 'testsetup', 'tasksetup', 'testprecondition',
+                         'testteardown','taskteardown', 'testpostcondition', 'testtemplate', 'tasktemplate')
+    _import_settings = ('library', 'resource', 'variables')
+    _other_settings = ('documentation', 'metadata', 'forcetags', 'defaulttags',
+                       'testtimeout','tasktimeout')
+    _custom_tokenizer = None
+
+    def __init__(self, template_setter=None):
+        Tokenizer.__init__(self)
+        self._template_setter = template_setter
+
+    def _tokenize(self, value, index):
+        if index == 1 and self._template_setter:
+            self._template_setter(value)
+        if index == 0:
+            normalized = normalize(value)
+            if normalized in self._keyword_settings:
+                self._custom_tokenizer = KeywordCall(support_assign=False)
+            elif normalized in self._import_settings:
+                self._custom_tokenizer = ImportSetting()
+            elif normalized not in self._other_settings:
+                return ERROR
+        elif self._custom_tokenizer:
+            return self._custom_tokenizer.tokenize(value)
+        return Tokenizer._tokenize(self, value, index)
+
+
+class ImportSetting(Tokenizer):
+    _tokens = (IMPORT, ARGUMENT)
+
+
+class TestCaseSetting(Setting):
+    _keyword_settings = ('setup', 'precondition', 'teardown', 'postcondition',
+                         'template')
+    _import_settings = ()
+    _other_settings = ('documentation', 'tags', 'timeout')
+
+    def _tokenize(self, value, index):
+        if index == 0:
+            type = Setting._tokenize(self, value[1:-1], index)
+            return [('[', SYNTAX), (value[1:-1], type), (']', SYNTAX)]
+        return Setting._tokenize(self, value, index)
+
+
+class KeywordSetting(TestCaseSetting):
+    _keyword_settings = ('teardown',)
+    _other_settings = ('documentation', 'arguments', 'return', 'timeout', 'tags')
+
+
+class Variable(Tokenizer):
+    _tokens = (SYNTAX, ARGUMENT)
+
+    def _tokenize(self, value, index):
+        if index == 0 and not self._is_assign(value):
+            return ERROR
+        return Tokenizer._tokenize(self, value, index)
+
+
+class KeywordCall(Tokenizer):
+    _tokens = (KEYWORD, ARGUMENT)
+
+    def __init__(self, support_assign=True):
+        Tokenizer.__init__(self)
+        self._keyword_found = not support_assign
+        self._assigns = 0
+
+    def _tokenize(self, value, index):
+        if not self._keyword_found and self._is_assign(value):
+            self._assigns += 1
+            return SYNTAX  # VariableTokenizer tokenizes this later.
+        if self._keyword_found:
+            return Tokenizer._tokenize(self, value, index - self._assigns)
+        self._keyword_found = True
+        return GherkinTokenizer().tokenize(value, KEYWORD)
+
+
+class GherkinTokenizer:
+    _gherkin_prefix = re.compile('^(Given|When|Then|And|But) ', re.IGNORECASE)
+
+    def tokenize(self, value, token):
+        match = self._gherkin_prefix.match(value)
+        if not match:
+            return [(value, token)]
+        end = match.end()
+        return [(value[:end], GHERKIN), (value[end:], token)]
+
+
+class TemplatedKeywordCall(Tokenizer):
+    _tokens = (ARGUMENT,)
+
+
+class ForLoop(Tokenizer):
+
+    def __init__(self):
+        Tokenizer.__init__(self)
+        self._in_arguments = False
+
+    def _tokenize(self, value, index):
+        token = self._in_arguments and ARGUMENT or SYNTAX
+        if value.upper() in ('IN', 'IN RANGE'):
+            self._in_arguments = True
+        return token
+
+
+class _Table:
+    _tokenizer_class = None
+
+    def __init__(self, prev_tokenizer=None):
+        self._tokenizer = self._tokenizer_class()
+        self._prev_tokenizer = prev_tokenizer
+        self._prev_values_on_row = []
+
+    def tokenize(self, value, index):
+        if self._continues(value, index):
+            self._tokenizer = self._prev_tokenizer
+            yield value, SYNTAX
+        else:
+            yield from self._tokenize(value, index)
+        self._prev_values_on_row.append(value)
+
+    def _continues(self, value, index):
+        return value == '...' and all(self._is_empty(t)
+                                      for t in self._prev_values_on_row)
+
+    def _is_empty(self, value):
+        return value in ('', '\\')
+
+    def _tokenize(self, value, index):
+        return self._tokenizer.tokenize(value)
+
+    def end_row(self):
+        self.__init__(prev_tokenizer=self._tokenizer)
+
+
+class UnknownTable(_Table):
+    _tokenizer_class = Comment
+
+    def _continues(self, value, index):
+        return False
+
+
+class VariableTable(_Table):
+    _tokenizer_class = Variable
+
+
+class SettingTable(_Table):
+    _tokenizer_class = Setting
+
+    def __init__(self, template_setter, prev_tokenizer=None):
+        _Table.__init__(self, prev_tokenizer)
+        self._template_setter = template_setter
+
+    def _tokenize(self, value, index):
+        if index == 0 and normalize(value) == 'testtemplate':
+            self._tokenizer = Setting(self._template_setter)
+        return _Table._tokenize(self, value, index)
+
+    def end_row(self):
+        self.__init__(self._template_setter, prev_tokenizer=self._tokenizer)
+
+
+class TestCaseTable(_Table):
+    _setting_class = TestCaseSetting
+    _test_template = None
+    _default_template = None
+
+    @property
+    def _tokenizer_class(self):
+        if self._test_template or (self._default_template and
+                                   self._test_template is not False):
+            return TemplatedKeywordCall
+        return KeywordCall
+
+    def _continues(self, value, index):
+        return index > 0 and _Table._continues(self, value, index)
+
+    def _tokenize(self, value, index):
+        if index == 0:
+            if value:
+                self._test_template = None
+            return GherkinTokenizer().tokenize(value, TC_KW_NAME)
+        if index == 1 and self._is_setting(value):
+            if self._is_template(value):
+                self._test_template = False
+                self._tokenizer = self._setting_class(self.set_test_template)
+            else:
+                self._tokenizer = self._setting_class()
+        if index == 1 and self._is_for_loop(value):
+            self._tokenizer = ForLoop()
+        if index == 1 and self._is_empty(value):
+            return [(value, SYNTAX)]
+        return _Table._tokenize(self, value, index)
+
+    def _is_setting(self, value):
+        return value.startswith('[') and value.endswith(']')
+
+    def _is_template(self, value):
+        return normalize(value) == '[template]'
+
+    def _is_for_loop(self, value):
+        return value.startswith(':') and normalize(value, remove=':') == 'for'
+
+    def set_test_template(self, template):
+        self._test_template = self._is_template_set(template)
+
+    def set_default_template(self, template):
+        self._default_template = self._is_template_set(template)
+
+    def _is_template_set(self, template):
+        return normalize(template) not in ('', '\\', 'none', '${empty}')
+
+
+class KeywordTable(TestCaseTable):
+    _tokenizer_class = KeywordCall
+    _setting_class = KeywordSetting
+
+    def _is_template(self, value):
+        return False
+
+
+# Following code copied directly from Robot Framework 2.7.5.
+
+class VariableSplitter:
+
+    def __init__(self, string, identifiers):
+        self.identifier = None
+        self.base = None
+        self.index = None
+        self.start = -1
+        self.end = -1
+        self._identifiers = identifiers
+        self._may_have_internal_variables = False
+        try:
+            self._split(string)
+        except ValueError:
+            pass
+        else:
+            self._finalize()
+
+    def get_replaced_base(self, variables):
+        if self._may_have_internal_variables:
+            return variables.replace_string(self.base)
+        return self.base
+
+    def _finalize(self):
+        self.identifier = self._variable_chars[0]
+        self.base = ''.join(self._variable_chars[2:-1])
+        self.end = self.start + len(self._variable_chars)
+        if self._has_list_or_dict_variable_index():
+            self.index = ''.join(self._list_and_dict_variable_index_chars[1:-1])
+            self.end += len(self._list_and_dict_variable_index_chars)
+
+    def _has_list_or_dict_variable_index(self):
+        return self._list_and_dict_variable_index_chars\
+        and self._list_and_dict_variable_index_chars[-1] == ']'
+
+    def _split(self, string):
+        start_index, max_index = self._find_variable(string)
+        self.start = start_index
+        self._open_curly = 1
+        self._state = self._variable_state
+        self._variable_chars = [string[start_index], '{']
+        self._list_and_dict_variable_index_chars = []
+        self._string = string
+        start_index += 2
+        for index, char in enumerate(string[start_index:]):
+            index += start_index  # Giving start to enumerate only in Py 2.6+
+            try:
+                self._state(char, index)
+            except StopIteration:
+                return
+            if index  == max_index and not self._scanning_list_variable_index():
+                return
+
+    def _scanning_list_variable_index(self):
+        return self._state in [self._waiting_list_variable_index_state,
+                               self._list_variable_index_state]
+
+    def _find_variable(self, string):
+        max_end_index = string.rfind('}')
+        if max_end_index == -1:
+            raise ValueError('No variable end found')
+        if self._is_escaped(string, max_end_index):
+            return self._find_variable(string[:max_end_index])
+        start_index = self._find_start_index(string, 1, max_end_index)
+        if start_index == -1:
+            raise ValueError('No variable start found')
+        return start_index, max_end_index
+
+    def _find_start_index(self, string, start, end):
+        index = string.find('{', start, end) - 1
+        if index < 0:
+            return -1
+        if self._start_index_is_ok(string, index):
+            return index
+        return self._find_start_index(string, index+2, end)
+
+    def _start_index_is_ok(self, string, index):
+        return string[index] in self._identifiers\
+        and not self._is_escaped(string, index)
+
+    def _is_escaped(self, string, index):
+        escaped = False
+        while index > 0 and string[index-1] == '\\':
+            index -= 1
+            escaped = not escaped
+        return escaped
+
+    def _variable_state(self, char, index):
+        self._variable_chars.append(char)
+        if char == '}' and not self._is_escaped(self._string, index):
+            self._open_curly -= 1
+            if self._open_curly == 0:
+                if not self._is_list_or_dict_variable():
+                    raise StopIteration
+                self._state = self._waiting_list_variable_index_state
+        elif char in self._identifiers:
+            self._state = self._internal_variable_start_state
+
+    def _is_list_or_dict_variable(self):
+        return self._variable_chars[0] in ('@','&')
+
+    def _internal_variable_start_state(self, char, index):
+        self._state = self._variable_state
+        if char == '{':
+            self._variable_chars.append(char)
+            self._open_curly += 1
+            self._may_have_internal_variables = True
+        else:
+            self._variable_state(char, index)
+
+    def _waiting_list_variable_index_state(self, char, index):
+        if char != '[':
+            raise StopIteration
+        self._list_and_dict_variable_index_chars.append(char)
+        self._state = self._list_variable_index_state
+
+    def _list_variable_index_state(self, char, index):
+        self._list_and_dict_variable_index_chars.append(char)
+        if char == ']':
+            raise StopIteration
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/ruby.py b/env/lib/python3.12/site-packages/pygments/lexers/ruby.py
new file mode 100644
index 0000000..72aaeb5
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/ruby.py
@@ -0,0 +1,518 @@
+"""
+    pygments.lexers.ruby
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Ruby and related languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import Lexer, RegexLexer, ExtendedRegexLexer, include, \
+    bygroups, default, LexerContext, do_insertions, words, line_re
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Error, Generic, Whitespace
+from pygments.util import shebang_matches
+
+__all__ = ['RubyLexer', 'RubyConsoleLexer', 'FancyLexer']
+
+
+RUBY_OPERATORS = (
+    '*', '**', '-', '+', '-@', '+@', '/', '%', '&', '|', '^', '`', '~',
+    '[]', '[]=', '<<', '>>', '<', '<>', '<=>', '>', '>=', '==', '==='
+)
+
+
+class RubyLexer(ExtendedRegexLexer):
+    """
+    For Ruby source code.
+    """
+
+    name = 'Ruby'
+    url = 'http://www.ruby-lang.org'
+    aliases = ['ruby', 'rb', 'duby']
+    filenames = ['*.rb', '*.rbw', 'Rakefile', '*.rake', '*.gemspec',
+                 '*.rbx', '*.duby', 'Gemfile', 'Vagrantfile']
+    mimetypes = ['text/x-ruby', 'application/x-ruby']
+    version_added = ''
+
+    flags = re.DOTALL | re.MULTILINE
+
+    def heredoc_callback(self, match, ctx):
+        # okay, this is the hardest part of parsing Ruby...
+        # match: 1 = <<[-~]?, 2 = quote? 3 = name 4 = quote? 5 = rest of line
+
+        start = match.start(1)
+        yield start, Operator, match.group(1)        # <<[-~]?
+        yield match.start(2), String.Heredoc, match.group(2)   # quote ", ', `
+        yield match.start(3), String.Delimiter, match.group(3) # heredoc name
+        yield match.start(4), String.Heredoc, match.group(4)   # quote again
+
+        heredocstack = ctx.__dict__.setdefault('heredocstack', [])
+        outermost = not bool(heredocstack)
+        heredocstack.append((match.group(1) in ('<<-', '<<~'), match.group(3)))
+
+        ctx.pos = match.start(5)
+        ctx.end = match.end(5)
+        # this may find other heredocs, so limit the recursion depth
+        if len(heredocstack) < 100:
+            yield from self.get_tokens_unprocessed(context=ctx)
+        else:
+            yield ctx.pos, String.Heredoc, match.group(5)
+        ctx.pos = match.end()
+
+        if outermost:
+            # this is the outer heredoc again, now we can process them all
+            for tolerant, hdname in heredocstack:
+                lines = []
+                for match in line_re.finditer(ctx.text, ctx.pos):
+                    if tolerant:
+                        check = match.group().strip()
+                    else:
+                        check = match.group().rstrip()
+                    if check == hdname:
+                        for amatch in lines:
+                            yield amatch.start(), String.Heredoc, amatch.group()
+                        yield match.start(), String.Delimiter, match.group()
+                        ctx.pos = match.end()
+                        break
+                    else:
+                        lines.append(match)
+                else:
+                    # end of heredoc not found -- error!
+                    for amatch in lines:
+                        yield amatch.start(), Error, amatch.group()
+            ctx.end = len(ctx.text)
+            del heredocstack[:]
+
+    def gen_rubystrings_rules():
+        def intp_regex_callback(self, match, ctx):
+            yield match.start(1), String.Regex, match.group(1)  # begin
+            nctx = LexerContext(match.group(3), 0, ['interpolated-regex'])
+            for i, t, v in self.get_tokens_unprocessed(context=nctx):
+                yield match.start(3)+i, t, v
+            yield match.start(4), String.Regex, match.group(4)  # end[mixounse]*
+            ctx.pos = match.end()
+
+        def intp_string_callback(self, match, ctx):
+            yield match.start(1), String.Other, match.group(1)
+            nctx = LexerContext(match.group(3), 0, ['interpolated-string'])
+            for i, t, v in self.get_tokens_unprocessed(context=nctx):
+                yield match.start(3)+i, t, v
+            yield match.start(4), String.Other, match.group(4)  # end
+            ctx.pos = match.end()
+
+        states = {}
+        states['strings'] = [
+            # easy ones
+            (r'\:@{0,2}[a-zA-Z_]\w*[!?]?', String.Symbol),
+            (words(RUBY_OPERATORS, prefix=r'\:@{0,2}'), String.Symbol),
+            (r":'(\\\\|\\[^\\]|[^'\\])*'", String.Symbol),
+            (r':"', String.Symbol, 'simple-sym'),
+            (r'([a-zA-Z_]\w*)(:)(?!:)',
+             bygroups(String.Symbol, Punctuation)),  # Since Ruby 1.9
+            (r'"', String.Double, 'simple-string-double'),
+            (r"'", String.Single, 'simple-string-single'),
+            (r'(?', '<>', 'ab'):
+            states[name+'-intp-string'] = [
+                (r'\\[\\' + bracecc + ']', String.Other),
+                (lbrace, String.Other, '#push'),
+                (rbrace, String.Other, '#pop'),
+                include('string-intp-escaped'),
+                (r'[\\#' + bracecc + ']', String.Other),
+                (r'[^\\#' + bracecc + ']+', String.Other),
+            ]
+            states['strings'].append((r'%[QWx]?' + lbrace, String.Other,
+                                      name+'-intp-string'))
+            states[name+'-string'] = [
+                (r'\\[\\' + bracecc + ']', String.Other),
+                (lbrace, String.Other, '#push'),
+                (rbrace, String.Other, '#pop'),
+                (r'[\\#' + bracecc + ']', String.Other),
+                (r'[^\\#' + bracecc + ']+', String.Other),
+            ]
+            states['strings'].append((r'%[qsw]' + lbrace, String.Other,
+                                      name+'-string'))
+            states[name+'-regex'] = [
+                (r'\\[\\' + bracecc + ']', String.Regex),
+                (lbrace, String.Regex, '#push'),
+                (rbrace + '[mixounse]*', String.Regex, '#pop'),
+                include('string-intp'),
+                (r'[\\#' + bracecc + ']', String.Regex),
+                (r'[^\\#' + bracecc + ']+', String.Regex),
+            ]
+            states['strings'].append((r'%r' + lbrace, String.Regex,
+                                      name+'-regex'))
+
+        # these must come after %!
+        states['strings'] += [
+            # %r regex
+            (r'(%r([\W_]))((?:\\\2|(?!\2).)*)(\2[mixounse]*)',
+             intp_regex_callback),
+            # regular fancy strings with qsw
+            (r'%[qsw]([\W_])((?:\\\1|(?!\1).)*)\1', String.Other),
+            (r'(%[QWx]([\W_]))((?:\\\2|(?!\2).)*)(\2)',
+             intp_string_callback),
+            # special forms of fancy strings after operators or
+            # in method calls with braces
+            (r'(?<=[-+/*%=<>&!^|~,(])(\s*)(%([\t ])(?:(?:\\\3|(?!\3).)*)\3)',
+             bygroups(Whitespace, String.Other, None)),
+            # and because of fixed width lookbehinds the whole thing a
+            # second time for line startings...
+            (r'^(\s*)(%([\t ])(?:(?:\\\3|(?!\3).)*)\3)',
+             bygroups(Whitespace, String.Other, None)),
+            # all regular fancy strings without qsw
+            (r'(%([^a-zA-Z0-9\s]))((?:\\\2|(?!\2).)*)(\2)',
+             intp_string_callback),
+        ]
+
+        return states
+
+    tokens = {
+        'root': [
+            (r'\A#!.+?$', Comment.Hashbang),
+            (r'#.*?$', Comment.Single),
+            (r'=begin\s.*?\n=end.*?$', Comment.Multiline),
+            # keywords
+            (words((
+                'BEGIN', 'END', 'alias', 'begin', 'break', 'case', 'defined?',
+                'do', 'else', 'elsif', 'end', 'ensure', 'for', 'if', 'in', 'next', 'redo',
+                'rescue', 'raise', 'retry', 'return', 'super', 'then', 'undef',
+                'unless', 'until', 'when', 'while', 'yield'), suffix=r'\b'),
+             Keyword),
+            # start of function, class and module names
+            (r'(module)(\s+)([a-zA-Z_]\w*'
+             r'(?:::[a-zA-Z_]\w*)*)',
+             bygroups(Keyword, Whitespace, Name.Namespace)),
+            (r'(def)(\s+)', bygroups(Keyword, Whitespace), 'funcname'),
+            (r'def(?=[*%&^`~+-/\[<>=])', Keyword, 'funcname'),
+            (r'(class)(\s+)', bygroups(Keyword, Whitespace), 'classname'),
+            # special methods
+            (words((
+                'initialize', 'new', 'loop', 'include', 'extend', 'raise', 'attr_reader',
+                'attr_writer', 'attr_accessor', 'attr', 'catch', 'throw', 'private',
+                'module_function', 'public', 'protected', 'true', 'false', 'nil'),
+                suffix=r'\b'),
+             Keyword.Pseudo),
+            (r'(not|and|or)\b', Operator.Word),
+            (words((
+                'autoload', 'block_given', 'const_defined', 'eql', 'equal', 'frozen', 'include',
+                'instance_of', 'is_a', 'iterator', 'kind_of', 'method_defined', 'nil',
+                'private_method_defined', 'protected_method_defined',
+                'public_method_defined', 'respond_to', 'tainted'), suffix=r'\?'),
+             Name.Builtin),
+            (r'(chomp|chop|exit|gsub|sub)!', Name.Builtin),
+            (words((
+                'Array', 'Float', 'Integer', 'String', '__id__', '__send__', 'abort',
+                'ancestors', 'at_exit', 'autoload', 'binding', 'callcc', 'caller',
+                'catch', 'chomp', 'chop', 'class_eval', 'class_variables',
+                'clone', 'const_defined?', 'const_get', 'const_missing', 'const_set',
+                'constants', 'display', 'dup', 'eval', 'exec', 'exit', 'extend', 'fail', 'fork',
+                'format', 'freeze', 'getc', 'gets', 'global_variables', 'gsub',
+                'hash', 'id', 'included_modules', 'inspect', 'instance_eval',
+                'instance_method', 'instance_methods',
+                'instance_variable_get', 'instance_variable_set', 'instance_variables',
+                'lambda', 'load', 'local_variables', 'loop',
+                'method', 'method_missing', 'methods', 'module_eval', 'name',
+                'object_id', 'open', 'p', 'print', 'printf', 'private_class_method',
+                'private_instance_methods',
+                'private_methods', 'proc', 'protected_instance_methods',
+                'protected_methods', 'public_class_method',
+                'public_instance_methods', 'public_methods',
+                'putc', 'puts', 'raise', 'rand', 'readline', 'readlines', 'require',
+                'scan', 'select', 'self', 'send', 'set_trace_func', 'singleton_methods', 'sleep',
+                'split', 'sprintf', 'srand', 'sub', 'syscall', 'system', 'taint',
+                'test', 'throw', 'to_a', 'to_s', 'trace_var', 'trap', 'untaint',
+                'untrace_var', 'warn'), prefix=r'(?~!:])|'
+             r'(?<=(?:\s|;)when\s)|'
+             r'(?<=(?:\s|;)or\s)|'
+             r'(?<=(?:\s|;)and\s)|'
+             r'(?<=\.index\s)|'
+             r'(?<=\.scan\s)|'
+             r'(?<=\.sub\s)|'
+             r'(?<=\.sub!\s)|'
+             r'(?<=\.gsub\s)|'
+             r'(?<=\.gsub!\s)|'
+             r'(?<=\.match\s)|'
+             r'(?<=(?:\s|;)if\s)|'
+             r'(?<=(?:\s|;)elsif\s)|'
+             r'(?<=^when\s)|'
+             r'(?<=^index\s)|'
+             r'(?<=^scan\s)|'
+             r'(?<=^sub\s)|'
+             r'(?<=^gsub\s)|'
+             r'(?<=^sub!\s)|'
+             r'(?<=^gsub!\s)|'
+             r'(?<=^match\s)|'
+             r'(?<=^if\s)|'
+             r'(?<=^elsif\s)'
+             r')(\s*)(/)', bygroups(Text, String.Regex), 'multiline-regex'),
+            # multiline regex (in method calls or subscripts)
+            (r'(?<=\(|,|\[)/', String.Regex, 'multiline-regex'),
+            # multiline regex (this time the funny no whitespace rule)
+            (r'(\s+)(/)(?![\s=])', bygroups(Whitespace, String.Regex),
+             'multiline-regex'),
+            # lex numbers and ignore following regular expressions which
+            # are division operators in fact (grrrr. i hate that. any
+            # better ideas?)
+            # since pygments 0.7 we also eat a "?" operator after numbers
+            # so that the char operator does not work. Chars are not allowed
+            # there so that you can use the ternary operator.
+            # stupid example:
+            #   x>=0?n[x]:""
+            (r'(0_?[0-7]+(?:_[0-7]+)*)(\s*)([/?])?',
+             bygroups(Number.Oct, Whitespace, Operator)),
+            (r'(0x[0-9A-Fa-f]+(?:_[0-9A-Fa-f]+)*)(\s*)([/?])?',
+             bygroups(Number.Hex, Whitespace, Operator)),
+            (r'(0b[01]+(?:_[01]+)*)(\s*)([/?])?',
+             bygroups(Number.Bin, Whitespace, Operator)),
+            (r'([\d]+(?:_\d+)*)(\s*)([/?])?',
+             bygroups(Number.Integer, Whitespace, Operator)),
+            # Names
+            (r'@@[a-zA-Z_]\w*', Name.Variable.Class),
+            (r'@[a-zA-Z_]\w*', Name.Variable.Instance),
+            (r'\$\w+', Name.Variable.Global),
+            (r'\$[!@&`\'+~=/\\,;.<>_*$?:"^-]', Name.Variable.Global),
+            (r'\$-[0adFiIlpvw]', Name.Variable.Global),
+            (r'::', Operator),
+            include('strings'),
+            # chars
+            (r'\?(\\[MC]-)*'  # modifiers
+             r'(\\([\\abefnrstv#"\']|x[a-fA-F0-9]{1,2}|[0-7]{1,3})|\S)'
+             r'(?!\w)',
+             String.Char),
+            (r'[A-Z]\w+', Name.Constant),
+            # this is needed because ruby attributes can look
+            # like keywords (class) or like this: ` ?!?
+            (words(RUBY_OPERATORS, prefix=r'(\.|::)'),
+             bygroups(Operator, Name.Operator)),
+            (r'(\.|::)([a-zA-Z_]\w*[!?]?|[*%&^`~+\-/\[<>=])',
+             bygroups(Operator, Name)),
+            (r'[a-zA-Z_]\w*[!?]?', Name),
+            (r'(\[|\]|\*\*|<>?|>=|<=|<=>|=~|={3}|'
+             r'!~|&&?|\|\||\.{1,3})', Operator),
+            (r'[-+/*%=<>&!^|~]=?', Operator),
+            (r'[(){};,/?:\\]', Punctuation),
+            (r'\s+', Whitespace)
+        ],
+        'funcname': [
+            (r'\(', Punctuation, 'defexpr'),
+            (r'(?:([a-zA-Z_]\w*)(\.))?'  # optional scope name, like "self."
+             r'('
+                r'[a-zA-Z\u0080-\uffff][a-zA-Z0-9_\u0080-\uffff]*[!?=]?'  # method name
+                r'|!=|!~|=~|\*\*?|[-+!~]@?|[/%&|^]|<=>|<[<=]?|>[>=]?|===?'  # or operator override
+                r'|\[\]=?'  # or element reference/assignment override
+                r'|`'  # or the undocumented backtick override
+             r')',
+             bygroups(Name.Class, Operator, Name.Function), '#pop'),
+            default('#pop')
+        ],
+        'classname': [
+            (r'\(', Punctuation, 'defexpr'),
+            (r'<<', Operator, '#pop'),
+            (r'[A-Z_]\w*', Name.Class, '#pop'),
+            default('#pop')
+        ],
+        'defexpr': [
+            (r'(\))(\.|::)?', bygroups(Punctuation, Operator), '#pop'),
+            (r'\(', Operator, '#push'),
+            include('root')
+        ],
+        'in-intp': [
+            (r'\{', String.Interpol, '#push'),
+            (r'\}', String.Interpol, '#pop'),
+            include('root'),
+        ],
+        'string-intp': [
+            (r'#\{', String.Interpol, 'in-intp'),
+            (r'#@@?[a-zA-Z_]\w*', String.Interpol),
+            (r'#\$[a-zA-Z_]\w*', String.Interpol)
+        ],
+        'string-intp-escaped': [
+            include('string-intp'),
+            (r'\\([\\abefnrstv#"\']|x[a-fA-F0-9]{1,2}|[0-7]{1,3})',
+             String.Escape)
+        ],
+        'interpolated-regex': [
+            include('string-intp'),
+            (r'[\\#]', String.Regex),
+            (r'[^\\#]+', String.Regex),
+        ],
+        'interpolated-string': [
+            include('string-intp'),
+            (r'[\\#]', String.Other),
+            (r'[^\\#]+', String.Other),
+        ],
+        'multiline-regex': [
+            include('string-intp'),
+            (r'\\\\', String.Regex),
+            (r'\\/', String.Regex),
+            (r'[\\#]', String.Regex),
+            (r'[^\\/#]+', String.Regex),
+            (r'/[mixounse]*', String.Regex, '#pop'),
+        ],
+        'end-part': [
+            (r'.+', Comment.Preproc, '#pop')
+        ]
+    }
+    tokens.update(gen_rubystrings_rules())
+
+    def analyse_text(text):
+        return shebang_matches(text, r'ruby(1\.\d)?')
+
+
+class RubyConsoleLexer(Lexer):
+    """
+    For Ruby interactive console (**irb**) output.
+    """
+    name = 'Ruby irb session'
+    aliases = ['rbcon', 'irb']
+    mimetypes = ['text/x-ruby-shellsession']
+    url = 'https://www.ruby-lang.org'
+    version_added = ''
+    _example = 'rbcon/console'
+
+    _prompt_re = re.compile(r'irb\([a-zA-Z_]\w*\):\d{3}:\d+[>*"\'] '
+                            r'|>> |\?> ')
+
+    def get_tokens_unprocessed(self, text):
+        rblexer = RubyLexer(**self.options)
+
+        curcode = ''
+        insertions = []
+        for match in line_re.finditer(text):
+            line = match.group()
+            m = self._prompt_re.match(line)
+            if m is not None:
+                end = m.end()
+                insertions.append((len(curcode),
+                                   [(0, Generic.Prompt, line[:end])]))
+                curcode += line[end:]
+            else:
+                if curcode:
+                    yield from do_insertions(
+                        insertions, rblexer.get_tokens_unprocessed(curcode))
+                    curcode = ''
+                    insertions = []
+                yield match.start(), Generic.Output, line
+        if curcode:
+            yield from do_insertions(
+                insertions, rblexer.get_tokens_unprocessed(curcode))
+
+
+class FancyLexer(RegexLexer):
+    """
+    Pygments Lexer For Fancy.
+
+    Fancy is a self-hosted, pure object-oriented, dynamic,
+    class-based, concurrent general-purpose programming language
+    running on Rubinius, the Ruby VM.
+    """
+    name = 'Fancy'
+    url = 'https://github.com/bakkdoor/fancy'
+    filenames = ['*.fy', '*.fancypack']
+    aliases = ['fancy', 'fy']
+    mimetypes = ['text/x-fancysrc']
+    version_added = '1.5'
+
+    tokens = {
+        # copied from PerlLexer:
+        'balanced-regex': [
+            (r'/(\\\\|\\[^\\]|[^/\\])*/[egimosx]*', String.Regex, '#pop'),
+            (r'!(\\\\|\\[^\\]|[^!\\])*![egimosx]*', String.Regex, '#pop'),
+            (r'\\(\\\\|[^\\])*\\[egimosx]*', String.Regex, '#pop'),
+            (r'\{(\\\\|\\[^\\]|[^}\\])*\}[egimosx]*', String.Regex, '#pop'),
+            (r'<(\\\\|\\[^\\]|[^>\\])*>[egimosx]*', String.Regex, '#pop'),
+            (r'\[(\\\\|\\[^\\]|[^\]\\])*\][egimosx]*', String.Regex, '#pop'),
+            (r'\((\\\\|\\[^\\]|[^)\\])*\)[egimosx]*', String.Regex, '#pop'),
+            (r'@(\\\\|\\[^\\]|[^@\\])*@[egimosx]*', String.Regex, '#pop'),
+            (r'%(\\\\|\\[^\\]|[^%\\])*%[egimosx]*', String.Regex, '#pop'),
+            (r'\$(\\\\|\\[^\\]|[^$\\])*\$[egimosx]*', String.Regex, '#pop'),
+        ],
+        'root': [
+            (r'\s+', Whitespace),
+
+            # balanced delimiters (copied from PerlLexer):
+            (r's\{(\\\\|\\[^\\]|[^}\\])*\}\s*', String.Regex, 'balanced-regex'),
+            (r's<(\\\\|\\[^\\]|[^>\\])*>\s*', String.Regex, 'balanced-regex'),
+            (r's\[(\\\\|\\[^\\]|[^\]\\])*\]\s*', String.Regex, 'balanced-regex'),
+            (r's\((\\\\|\\[^\\]|[^)\\])*\)\s*', String.Regex, 'balanced-regex'),
+            (r'm?/(\\\\|\\[^\\]|[^///\n])*/[gcimosx]*', String.Regex),
+            (r'm(?=[/!\\{<\[(@%$])', String.Regex, 'balanced-regex'),
+
+            # Comments
+            (r'#(.*?)\n', Comment.Single),
+            # Symbols
+            (r'\'([^\'\s\[\](){}]+|\[\])', String.Symbol),
+            # Multi-line DoubleQuotedString
+            (r'"""(\\\\|\\[^\\]|[^\\])*?"""', String),
+            # DoubleQuotedString
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String),
+            # keywords
+            (r'(def|class|try|catch|finally|retry|return|return_local|match|'
+             r'case|->|=>)\b', Keyword),
+            # constants
+            (r'(self|super|nil|false|true)\b', Name.Constant),
+            (r'[(){};,/?|:\\]', Punctuation),
+            # names
+            (words((
+                'Object', 'Array', 'Hash', 'Directory', 'File', 'Class', 'String',
+                'Number', 'Enumerable', 'FancyEnumerable', 'Block', 'TrueClass',
+                'NilClass', 'FalseClass', 'Tuple', 'Symbol', 'Stack', 'Set',
+                'FancySpec', 'Method', 'Package', 'Range'), suffix=r'\b'),
+             Name.Builtin),
+            # functions
+            (r'[a-zA-Z](\w|[-+?!=*/^><%])*:', Name.Function),
+            # operators, must be below functions
+            (r'[-+*/~,<>=&!?%^\[\].$]+', Operator),
+            (r'[A-Z]\w*', Name.Constant),
+            (r'@[a-zA-Z_]\w*', Name.Variable.Instance),
+            (r'@@[a-zA-Z_]\w*', Name.Variable.Class),
+            ('@@?', Operator),
+            (r'[a-zA-Z_]\w*', Name),
+            # numbers - / checks are necessary to avoid mismarking regexes,
+            # see comment in RubyLexer
+            (r'(0[oO]?[0-7]+(?:_[0-7]+)*)(\s*)([/?])?',
+             bygroups(Number.Oct, Whitespace, Operator)),
+            (r'(0[xX][0-9A-Fa-f]+(?:_[0-9A-Fa-f]+)*)(\s*)([/?])?',
+             bygroups(Number.Hex, Whitespace, Operator)),
+            (r'(0[bB][01]+(?:_[01]+)*)(\s*)([/?])?',
+             bygroups(Number.Bin, Whitespace, Operator)),
+            (r'([\d]+(?:_\d+)*)(\s*)([/?])?',
+             bygroups(Number.Integer, Whitespace, Operator)),
+            (r'\d+([eE][+-]?[0-9]+)|\d+\.\d+([eE][+-]?[0-9]+)?', Number.Float),
+            (r'\d+', Number.Integer)
+        ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/rust.py b/env/lib/python3.12/site-packages/pygments/lexers/rust.py
new file mode 100644
index 0000000..6341047
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/rust.py
@@ -0,0 +1,222 @@
+"""
+    pygments.lexers.rust
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for the Rust language.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, include, bygroups, words, default
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Whitespace
+
+__all__ = ['RustLexer']
+
+
+class RustLexer(RegexLexer):
+    """
+    Lexer for the Rust programming language (version 1.47).
+    """
+    name = 'Rust'
+    url = 'https://www.rust-lang.org/'
+    filenames = ['*.rs', '*.rs.in']
+    aliases = ['rust', 'rs']
+    mimetypes = ['text/rust', 'text/x-rust']
+    version_added = '1.6'
+
+    keyword_types = (words((
+        'u8', 'u16', 'u32', 'u64', 'u128', 'i8', 'i16', 'i32', 'i64', 'i128',
+        'usize', 'isize', 'f32', 'f64', 'char', 'str', 'bool',
+    ), suffix=r'\b'), Keyword.Type)
+
+    builtin_funcs_types = (words((
+        'Copy', 'Send', 'Sized', 'Sync', 'Unpin',
+        'Drop', 'Fn', 'FnMut', 'FnOnce', 'drop',
+        'Box', 'ToOwned', 'Clone',
+        'PartialEq', 'PartialOrd', 'Eq', 'Ord',
+        'AsRef', 'AsMut', 'Into', 'From', 'Default',
+        'Iterator', 'Extend', 'IntoIterator', 'DoubleEndedIterator',
+        'ExactSizeIterator',
+        'Option', 'Some', 'None',
+        'Result', 'Ok', 'Err',
+        'String', 'ToString', 'Vec',
+    ), suffix=r'\b'), Name.Builtin)
+
+    builtin_macros = (words((
+        'asm', 'assert', 'assert_eq', 'assert_ne', 'cfg', 'column',
+        'compile_error', 'concat', 'concat_idents', 'dbg', 'debug_assert',
+        'debug_assert_eq', 'debug_assert_ne', 'env', 'eprint', 'eprintln',
+        'file', 'format', 'format_args', 'format_args_nl', 'global_asm',
+        'include', 'include_bytes', 'include_str',
+        'is_aarch64_feature_detected',
+        'is_arm_feature_detected',
+        'is_mips64_feature_detected',
+        'is_mips_feature_detected',
+        'is_powerpc64_feature_detected',
+        'is_powerpc_feature_detected',
+        'is_x86_feature_detected',
+        'line', 'llvm_asm', 'log_syntax', 'macro_rules', 'matches',
+        'module_path', 'option_env', 'panic', 'print', 'println', 'stringify',
+        'thread_local', 'todo', 'trace_macros', 'unimplemented', 'unreachable',
+        'vec', 'write', 'writeln',
+    ), suffix=r'!'), Name.Function.Magic)
+
+    tokens = {
+        'root': [
+            # rust allows a file to start with a shebang, but if the first line
+            # starts with #![ then it's not a shebang but a crate attribute.
+            (r'#![^[\r\n].*$', Comment.Preproc),
+            default('base'),
+        ],
+        'base': [
+            # Whitespace and Comments
+            (r'\n', Whitespace),
+            (r'\s+', Whitespace),
+            (r'//!.*?\n', String.Doc),
+            (r'///(\n|[^/].*?\n)', String.Doc),
+            (r'//(.*?)\n', Comment.Single),
+            (r'/\*\*(\n|[^/*])', String.Doc, 'doccomment'),
+            (r'/\*!', String.Doc, 'doccomment'),
+            (r'/\*', Comment.Multiline, 'comment'),
+
+            # Macro parameters
+            (r"""\$([a-zA-Z_]\w*|\(,?|\),?|,?)""", Comment.Preproc),
+            # Keywords
+            (words(('as', 'async', 'await', 'box', 'const', 'crate', 'dyn',
+                    'else', 'extern', 'for', 'if', 'impl', 'in', 'loop',
+                    'match', 'move', 'mut', 'pub', 'ref', 'return', 'static',
+                    'super', 'trait', 'unsafe', 'use', 'where', 'while'),
+                   suffix=r'\b'), Keyword),
+            (words(('abstract', 'become', 'do', 'final', 'macro', 'override',
+                    'priv', 'typeof', 'try', 'unsized', 'virtual', 'yield'),
+                   suffix=r'\b'), Keyword.Reserved),
+            (r'(true|false)\b', Keyword.Constant),
+            (r'self\b', Name.Builtin.Pseudo),
+            (r'mod\b', Keyword, 'modname'),
+            (r'let\b', Keyword.Declaration),
+            (r'fn\b', Keyword, 'funcname'),
+            (r'(struct|enum|type|union)\b', Keyword, 'typename'),
+            (r'(default)(\s+)(type|fn)\b', bygroups(Keyword, Whitespace, Keyword)),
+            keyword_types,
+            (r'[sS]elf\b', Name.Builtin.Pseudo),
+            # Prelude (taken from Rust's src/libstd/prelude.rs)
+            builtin_funcs_types,
+            builtin_macros,
+            # Path separators, so types don't catch them.
+            (r'::\b', Punctuation),
+            # Types in positions.
+            (r'(?::|->)', Punctuation, 'typename'),
+            # Labels
+            (r'(break|continue)(\b\s*)(\'[A-Za-z_]\w*)?',
+             bygroups(Keyword, Text.Whitespace, Name.Label)),
+
+            # Character literals
+            (r"""'(\\['"\\nrt]|\\x[0-7][0-9a-fA-F]|\\0"""
+             r"""|\\u\{[0-9a-fA-F]{1,6}\}|.)'""",
+             String.Char),
+            (r"""b'(\\['"\\nrt]|\\x[0-9a-fA-F]{2}|\\0"""
+             r"""|\\u\{[0-9a-fA-F]{1,6}\}|.)'""",
+             String.Char),
+
+            # Binary literals
+            (r'0b[01_]+', Number.Bin, 'number_lit'),
+            # Octal literals
+            (r'0o[0-7_]+', Number.Oct, 'number_lit'),
+            # Hexadecimal literals
+            (r'0[xX][0-9a-fA-F_]+', Number.Hex, 'number_lit'),
+            # Decimal literals
+            (r'[0-9][0-9_]*(\.[0-9_]+[eE][+\-]?[0-9_]+|'
+             r'\.[0-9_]*(?!\.)|[eE][+\-]?[0-9_]+)', Number.Float,
+             'number_lit'),
+            (r'[0-9][0-9_]*', Number.Integer, 'number_lit'),
+
+            # String literals
+            (r'b"', String, 'bytestring'),
+            (r'"', String, 'string'),
+            (r'(?s)b?r(#*)".*?"\1', String),
+
+            # Lifetime names
+            (r"'", Operator, 'lifetime'),
+
+            # Operators and Punctuation
+            (r'\.\.=?', Operator),
+            (r'[{}()\[\],.;]', Punctuation),
+            (r'[+\-*/%&|<>^!~@=:?]', Operator),
+
+            # Identifiers
+            (r'[a-zA-Z_]\w*', Name),
+            # Raw identifiers
+            (r'r#[a-zA-Z_]\w*', Name),
+
+            # Attributes
+            (r'#!?\[', Comment.Preproc, 'attribute['),
+
+            # Misc
+            # Lone hashes: not used in Rust syntax, but allowed in macro
+            # arguments, most famously for quote::quote!()
+            (r'#', Punctuation),
+        ],
+        'comment': [
+            (r'[^*/]+', Comment.Multiline),
+            (r'/\*', Comment.Multiline, '#push'),
+            (r'\*/', Comment.Multiline, '#pop'),
+            (r'[*/]', Comment.Multiline),
+        ],
+        'doccomment': [
+            (r'[^*/]+', String.Doc),
+            (r'/\*', String.Doc, '#push'),
+            (r'\*/', String.Doc, '#pop'),
+            (r'[*/]', String.Doc),
+        ],
+        'modname': [
+            (r'\s+', Whitespace),
+            (r'[a-zA-Z_]\w*', Name.Namespace, '#pop'),
+            default('#pop'),
+        ],
+        'funcname': [
+            (r'\s+', Whitespace),
+            (r'[a-zA-Z_]\w*', Name.Function, '#pop'),
+            default('#pop'),
+        ],
+        'typename': [
+            (r'\s+', Whitespace),
+            (r'&', Keyword.Pseudo),
+            (r"'", Operator, 'lifetime'),
+            builtin_funcs_types,
+            keyword_types,
+            (r'[a-zA-Z_]\w*', Name.Class, '#pop'),
+            default('#pop'),
+        ],
+        'lifetime': [
+            (r"(static|_)", Name.Builtin),
+            (r"[a-zA-Z_]+\w*", Name.Attribute),
+            default('#pop'),
+        ],
+        'number_lit': [
+            (r'[ui](8|16|32|64|size)', Keyword, '#pop'),
+            (r'f(32|64)', Keyword, '#pop'),
+            default('#pop'),
+        ],
+        'string': [
+            (r'"', String, '#pop'),
+            (r"""\\['"\\nrt]|\\x[0-7][0-9a-fA-F]|\\0"""
+             r"""|\\u\{[0-9a-fA-F]{1,6}\}""", String.Escape),
+            (r'[^\\"]+', String),
+            (r'\\', String),
+        ],
+        'bytestring': [
+            (r"""\\x[89a-fA-F][0-9a-fA-F]""", String.Escape),
+            include('string'),
+        ],
+        'attribute_common': [
+            (r'"', String, 'string'),
+            (r'\[', Comment.Preproc, 'attribute['),
+        ],
+        'attribute[': [
+            include('attribute_common'),
+            (r'\]', Comment.Preproc, '#pop'),
+            (r'[^"\]\[]+', Comment.Preproc),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/sas.py b/env/lib/python3.12/site-packages/pygments/lexers/sas.py
new file mode 100644
index 0000000..1b2ad43
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/sas.py
@@ -0,0 +1,227 @@
+"""
+    pygments.lexers.sas
+    ~~~~~~~~~~~~~~~~~~~
+
+    Lexer for SAS.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+from pygments.lexer import RegexLexer, include, words
+from pygments.token import Comment, Keyword, Name, Number, String, Text, \
+    Other, Generic
+
+__all__ = ['SASLexer']
+
+
+class SASLexer(RegexLexer):
+    """
+    For SAS files.
+    """
+    # Syntax from syntax/sas.vim by James Kidd 
+
+    name      = 'SAS'
+    aliases   = ['sas']
+    filenames = ['*.SAS', '*.sas']
+    mimetypes = ['text/x-sas', 'text/sas', 'application/x-sas']
+    url = 'https://en.wikipedia.org/wiki/SAS_(software)'
+    version_added = '2.2'
+    flags     = re.IGNORECASE | re.MULTILINE
+
+    builtins_macros = (
+        "bquote", "nrbquote", "cmpres", "qcmpres", "compstor", "datatyp",
+        "display", "do", "else", "end", "eval", "global", "goto", "if",
+        "index", "input", "keydef", "label", "left", "length", "let",
+        "local", "lowcase", "macro", "mend", "nrquote",
+        "nrstr", "put", "qleft", "qlowcase", "qscan",
+        "qsubstr", "qsysfunc", "qtrim", "quote", "qupcase", "scan",
+        "str", "substr", "superq", "syscall", "sysevalf", "sysexec",
+        "sysfunc", "sysget", "syslput", "sysprod", "sysrc", "sysrput",
+        "then", "to", "trim", "unquote", "until", "upcase", "verify",
+        "while", "window"
+    )
+
+    builtins_conditionals = (
+        "do", "if", "then", "else", "end", "until", "while"
+    )
+
+    builtins_statements = (
+        "abort", "array", "attrib", "by", "call", "cards", "cards4",
+        "catname", "continue", "datalines", "datalines4", "delete", "delim",
+        "delimiter", "display", "dm", "drop", "endsas", "error", "file",
+        "filename", "footnote", "format", "goto", "in", "infile", "informat",
+        "input", "keep", "label", "leave", "length", "libname", "link",
+        "list", "lostcard", "merge", "missing", "modify", "options", "output",
+        "out", "page", "put", "redirect", "remove", "rename", "replace",
+        "retain", "return", "select", "set", "skip", "startsas", "stop",
+        "title", "update", "waitsas", "where", "window", "x", "systask"
+    )
+
+    builtins_sql = (
+        "add", "and", "alter", "as", "cascade", "check", "create",
+        "delete", "describe", "distinct", "drop", "foreign", "from",
+        "group", "having", "index", "insert", "into", "in", "key", "like",
+        "message", "modify", "msgtype", "not", "null", "on", "or",
+        "order", "primary", "references", "reset", "restrict", "select",
+        "set", "table", "unique", "update", "validate", "view", "where"
+    )
+
+    builtins_functions = (
+        "abs", "addr", "airy", "arcos", "arsin", "atan", "attrc",
+        "attrn", "band", "betainv", "blshift", "bnot", "bor",
+        "brshift", "bxor", "byte", "cdf", "ceil", "cexist", "cinv",
+        "close", "cnonct", "collate", "compbl", "compound",
+        "compress", "cos", "cosh", "css", "curobs", "cv", "daccdb",
+        "daccdbsl", "daccsl", "daccsyd", "dacctab", "dairy", "date",
+        "datejul", "datepart", "datetime", "day", "dclose", "depdb",
+        "depdbsl", "depsl", "depsyd",
+        "deptab", "dequote", "dhms", "dif", "digamma",
+        "dim", "dinfo", "dnum", "dopen", "doptname", "doptnum",
+        "dread", "dropnote", "dsname", "erf", "erfc", "exist", "exp",
+        "fappend", "fclose", "fcol", "fdelete", "fetch", "fetchobs",
+        "fexist", "fget", "fileexist", "filename", "fileref",
+        "finfo", "finv", "fipname", "fipnamel", "fipstate", "floor",
+        "fnonct", "fnote", "fopen", "foptname", "foptnum", "fpoint",
+        "fpos", "fput", "fread", "frewind", "frlen", "fsep", "fuzz",
+        "fwrite", "gaminv", "gamma", "getoption", "getvarc", "getvarn",
+        "hbound", "hms", "hosthelp", "hour", "ibessel", "index",
+        "indexc", "indexw", "input", "inputc", "inputn", "int",
+        "intck", "intnx", "intrr", "irr", "jbessel", "juldate",
+        "kurtosis", "lag", "lbound", "left", "length", "lgamma",
+        "libname", "libref", "log", "log10", "log2", "logpdf", "logpmf",
+        "logsdf", "lowcase", "max", "mdy", "mean", "min", "minute",
+        "mod", "month", "mopen", "mort", "n", "netpv", "nmiss",
+        "normal", "note", "npv", "open", "ordinal", "pathname",
+        "pdf", "peek", "peekc", "pmf", "point", "poisson", "poke",
+        "probbeta", "probbnml", "probchi", "probf", "probgam",
+        "probhypr", "probit", "probnegb", "probnorm", "probt",
+        "put", "putc", "putn", "qtr", "quote", "ranbin", "rancau",
+        "ranexp", "rangam", "range", "rank", "rannor", "ranpoi",
+        "rantbl", "rantri", "ranuni", "repeat", "resolve", "reverse",
+        "rewind", "right", "round", "saving", "scan", "sdf", "second",
+        "sign", "sin", "sinh", "skewness", "soundex", "spedis",
+        "sqrt", "std", "stderr", "stfips", "stname", "stnamel",
+        "substr", "sum", "symget", "sysget", "sysmsg", "sysprod",
+        "sysrc", "system", "tan", "tanh", "time", "timepart", "tinv",
+        "tnonct", "today", "translate", "tranwrd", "trigamma",
+        "trim", "trimn", "trunc", "uniform", "upcase", "uss", "var",
+        "varfmt", "varinfmt", "varlabel", "varlen", "varname",
+        "varnum", "varray", "varrayx", "vartype", "verify", "vformat",
+        "vformatd", "vformatdx", "vformatn", "vformatnx", "vformatw",
+        "vformatwx", "vformatx", "vinarray", "vinarrayx", "vinformat",
+        "vinformatd", "vinformatdx", "vinformatn", "vinformatnx",
+        "vinformatw", "vinformatwx", "vinformatx", "vlabel",
+        "vlabelx", "vlength", "vlengthx", "vname", "vnamex", "vtype",
+        "vtypex", "weekday", "year", "yyq", "zipfips", "zipname",
+        "zipnamel", "zipstate"
+    )
+
+    tokens = {
+        'root': [
+            include('comments'),
+            include('proc-data'),
+            include('cards-datalines'),
+            include('logs'),
+            include('general'),
+            (r'.', Text),
+        ],
+        # SAS is multi-line regardless, but * is ended by ;
+        'comments': [
+            (r'^\s*\*.*?;', Comment),
+            (r'/\*.*?\*/', Comment),
+            (r'^\s*\*(.|\n)*?;', Comment.Multiline),
+            (r'/[*](.|\n)*?[*]/', Comment.Multiline),
+        ],
+        # Special highlight for proc, data, quit, run
+        'proc-data': [
+            (r'(^|;)\s*(proc \w+|data|run|quit)[\s;]',
+             Keyword.Reserved),
+        ],
+        # Special highlight cards and datalines
+        'cards-datalines': [
+            (r'^\s*(datalines|cards)\s*;\s*$', Keyword, 'data'),
+        ],
+        'data': [
+            (r'(.|\n)*^\s*;\s*$', Other, '#pop'),
+        ],
+        # Special highlight for put NOTE|ERROR|WARNING (order matters)
+        'logs': [
+            (r'\n?^\s*%?put ', Keyword, 'log-messages'),
+        ],
+        'log-messages': [
+            (r'NOTE(:|-).*', Generic, '#pop'),
+            (r'WARNING(:|-).*', Generic.Emph, '#pop'),
+            (r'ERROR(:|-).*', Generic.Error, '#pop'),
+            include('general'),
+        ],
+        'general': [
+            include('keywords'),
+            include('vars-strings'),
+            include('special'),
+            include('numbers'),
+        ],
+        # Keywords, statements, functions, macros
+        'keywords': [
+            (words(builtins_statements,
+                   prefix = r'\b',
+                   suffix = r'\b'),
+             Keyword),
+            (words(builtins_sql,
+                   prefix = r'\b',
+                   suffix = r'\b'),
+             Keyword),
+            (words(builtins_conditionals,
+                   prefix = r'\b',
+                   suffix = r'\b'),
+             Keyword),
+            (words(builtins_macros,
+                   prefix = r'%',
+                   suffix = r'\b'),
+             Name.Builtin),
+            (words(builtins_functions,
+                   prefix = r'\b',
+                   suffix = r'\('),
+             Name.Builtin),
+        ],
+        # Strings and user-defined variables and macros (order matters)
+        'vars-strings': [
+            (r'&[a-z_]\w{0,31}\.?', Name.Variable),
+            (r'%[a-z_]\w{0,31}', Name.Function),
+            (r'\'', String, 'string_squote'),
+            (r'"', String, 'string_dquote'),
+        ],
+        'string_squote': [
+            ('\'', String, '#pop'),
+            (r'\\\\|\\"|\\\n', String.Escape),
+            # AFAIK, macro variables are not evaluated in single quotes
+            # (r'&', Name.Variable, 'validvar'),
+            (r'[^$\'\\]+', String),
+            (r'[$\'\\]', String),
+        ],
+        'string_dquote': [
+            (r'"', String, '#pop'),
+            (r'\\\\|\\"|\\\n', String.Escape),
+            (r'&', Name.Variable, 'validvar'),
+            (r'[^$&"\\]+', String),
+            (r'[$"\\]', String),
+        ],
+        'validvar': [
+            (r'[a-z_]\w{0,31}\.?', Name.Variable, '#pop'),
+        ],
+        # SAS numbers and special variables
+        'numbers': [
+            (r'\b[+-]?([0-9]+(\.[0-9]+)?|\.[0-9]+|\.)(E[+-]?[0-9]+)?i?\b',
+             Number),
+        ],
+        'special': [
+            (r'(null|missing|_all_|_automatic_|_character_|_n_|'
+             r'_infile_|_name_|_null_|_numeric_|_user_|_webout_)',
+             Keyword.Constant),
+        ],
+        # 'operators': [
+        #     (r'(-|=|<=|>=|<|>|<>|&|!=|'
+        #      r'\||\*|\+|\^|/|!|~|~=)', Operator)
+        # ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/savi.py b/env/lib/python3.12/site-packages/pygments/lexers/savi.py
new file mode 100644
index 0000000..1e443ae
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/savi.py
@@ -0,0 +1,171 @@
+"""
+    pygments.lexers.savi
+    ~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for Savi.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups, include
+from pygments.token import Whitespace, Keyword, Name, String, Number, \
+  Operator, Punctuation, Comment, Generic, Error
+
+__all__ = ['SaviLexer']
+
+
+# The canonical version of this file can be found in the following repository,
+# where it is kept in sync with any language changes, as well as the other
+# pygments-like lexers that are maintained for use with other tools:
+# - https://github.com/savi-lang/savi/blob/main/tooling/pygments/lexers/savi.py
+#
+# If you're changing this file in the pygments repository, please ensure that
+# any changes you make are also propagated to the official Savi repository,
+# in order to avoid accidental clobbering of your changes later when an update
+# from the Savi repository flows forward into the pygments repository.
+#
+# If you're changing this file in the Savi repository, please ensure that
+# any changes you make are also reflected in the other pygments-like lexers
+# (rouge, vscode, etc) so that all of the lexers can be kept cleanly in sync.
+
+class SaviLexer(RegexLexer):
+    """
+    For Savi source code.
+
+    .. versionadded: 2.10
+    """
+
+    name = 'Savi'
+    url = 'https://github.com/savi-lang/savi'
+    aliases = ['savi']
+    filenames = ['*.savi']
+    version_added = ''
+
+    tokens = {
+      "root": [
+        # Line Comment
+        (r'//.*?$', Comment.Single),
+
+        # Doc Comment
+        (r'::.*?$', Comment.Single),
+
+        # Capability Operator
+        (r'(\')(\w+)(?=[^\'])', bygroups(Operator, Name)),
+
+        # Double-Quote String
+        (r'\w?"', String.Double, "string.double"),
+
+        # Single-Char String
+        (r"'", String.Char, "string.char"),
+
+        # Type Name
+        (r'(_?[A-Z]\w*)', Name.Class),
+
+        # Nested Type Name
+        (r'(\.)(\s*)(_?[A-Z]\w*)', bygroups(Punctuation, Whitespace, Name.Class)),
+
+        # Declare
+        (r'^([ \t]*)(:\w+)',
+          bygroups(Whitespace, Name.Tag),
+          "decl"),
+
+        # Error-Raising Calls/Names
+        (r'((\w+|\+|\-|\*)\!)', Generic.Deleted),
+
+        # Numeric Values
+        (r'\b\d([\d_]*(\.[\d_]+)?)\b', Number),
+
+        # Hex Numeric Values
+        (r'\b0x([0-9a-fA-F_]+)\b', Number.Hex),
+
+        # Binary Numeric Values
+        (r'\b0b([01_]+)\b', Number.Bin),
+
+        # Function Call (with braces)
+        (r'\w+(?=\()', Name.Function),
+
+        # Function Call (with receiver)
+        (r'(\.)(\s*)(\w+)', bygroups(Punctuation, Whitespace, Name.Function)),
+
+        # Function Call (with self receiver)
+        (r'(@)(\w+)', bygroups(Punctuation, Name.Function)),
+
+        # Parenthesis
+        (r'\(', Punctuation, "root"),
+        (r'\)', Punctuation, "#pop"),
+
+        # Brace
+        (r'\{', Punctuation, "root"),
+        (r'\}', Punctuation, "#pop"),
+
+        # Bracket
+        (r'\[', Punctuation, "root"),
+        (r'(\])(\!)', bygroups(Punctuation, Generic.Deleted), "#pop"),
+        (r'\]', Punctuation, "#pop"),
+
+        # Punctuation
+        (r'[,;:\.@]', Punctuation),
+
+        # Piping Operators
+        (r'(\|\>)', Operator),
+
+        # Branching Operators
+        (r'(\&\&|\|\||\?\?|\&\?|\|\?|\.\?)', Operator),
+
+        # Comparison Operators
+        (r'(\<\=\>|\=\~|\=\=|\<\=|\>\=|\<|\>)', Operator),
+
+        # Arithmetic Operators
+        (r'(\+|\-|\/|\*|\%)', Operator),
+
+        # Assignment Operators
+        (r'(\=)', Operator),
+
+        # Other Operators
+        (r'(\!|\<\<|\<|\&|\|)', Operator),
+
+        # Identifiers
+        (r'\b\w+\b', Name),
+
+        # Whitespace
+        (r'[ \t\r]+\n*|\n+', Whitespace),
+      ],
+
+      # Declare (nested rules)
+      "decl": [
+        (r'\b[a-z_]\w*\b(?!\!)', Keyword.Declaration),
+        (r':', Punctuation, "#pop"),
+        (r'\n', Whitespace, "#pop"),
+        include("root"),
+      ],
+
+      # Double-Quote String (nested rules)
+      "string.double": [
+        (r'\\\(', String.Interpol, "string.interpolation"),
+        (r'\\u[0-9a-fA-F]{4}', String.Escape),
+        (r'\\x[0-9a-fA-F]{2}', String.Escape),
+        (r'\\[bfnrt\\\']', String.Escape),
+        (r'\\"', String.Escape),
+        (r'"', String.Double, "#pop"),
+        (r'[^\\"]+', String.Double),
+        (r'.', Error),
+      ],
+
+      # Single-Char String (nested rules)
+      "string.char": [
+        (r'\\u[0-9a-fA-F]{4}', String.Escape),
+        (r'\\x[0-9a-fA-F]{2}', String.Escape),
+        (r'\\[bfnrt\\\']', String.Escape),
+        (r"\\'", String.Escape),
+        (r"'", String.Char, "#pop"),
+        (r"[^\\']+", String.Char),
+        (r'.', Error),
+      ],
+
+      # Interpolation inside String (nested rules)
+      "string.interpolation": [
+        (r"\)", String.Interpol, "#pop"),
+        include("root"),
+      ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/scdoc.py b/env/lib/python3.12/site-packages/pygments/lexers/scdoc.py
new file mode 100644
index 0000000..8e850d0
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/scdoc.py
@@ -0,0 +1,85 @@
+"""
+    pygments.lexers.scdoc
+    ~~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for scdoc, a simple man page generator.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, include, bygroups, using, this
+from pygments.token import Text, Comment, Keyword, String, Generic
+
+__all__ = ['ScdocLexer']
+
+
+class ScdocLexer(RegexLexer):
+    """
+    `scdoc` is a simple man page generator for POSIX systems written in C99.
+    """
+    name = 'scdoc'
+    url = 'https://git.sr.ht/~sircmpwn/scdoc'
+    aliases = ['scdoc', 'scd']
+    filenames = ['*.scd', '*.scdoc']
+    version_added = '2.5'
+    flags = re.MULTILINE
+
+    tokens = {
+        'root': [
+            # comment
+            (r'^(;.+\n)', bygroups(Comment)),
+
+            # heading with pound prefix
+            (r'^(#)([^#].+\n)', bygroups(Generic.Heading, Text)),
+            (r'^(#{2})(.+\n)', bygroups(Generic.Subheading, Text)),
+            # bulleted lists
+            (r'^(\s*)([*-])(\s)(.+\n)',
+            bygroups(Text, Keyword, Text, using(this, state='inline'))),
+            # numbered lists
+            (r'^(\s*)(\.+\.)( .+\n)',
+            bygroups(Text, Keyword, using(this, state='inline'))),
+            # quote
+            (r'^(\s*>\s)(.+\n)', bygroups(Keyword, Generic.Emph)),
+            # text block
+            (r'^(```\n)([\w\W]*?)(^```$)', bygroups(String, Text, String)),
+
+            include('inline'),
+        ],
+        'inline': [
+            # escape
+            (r'\\.', Text),
+            # underlines
+            (r'(\s)(_[^_]+_)(\W|\n)', bygroups(Text, Generic.Emph, Text)),
+            # bold
+            (r'(\s)(\*[^*]+\*)(\W|\n)', bygroups(Text, Generic.Strong, Text)),
+            # inline code
+            (r'`[^`]+`', String.Backtick),
+
+            # general text, must come last!
+            (r'[^\\\s]+', Text),
+            (r'.', Text),
+        ],
+    }
+
+    def analyse_text(text):
+        """We checks for bold and underline text with * and _. Also
+        every scdoc file must start with a strictly defined first line."""
+        result = 0
+
+        if '*' in text:
+            result += 0.01
+
+        if '_' in text:
+            result += 0.01
+
+        # name(section) ["left_footer" ["center_header"]]
+        first_line = text.partition('\n')[0]
+        scdoc_preamble_pattern = r'^.*\([1-7]\)( "[^"]+"){0,2}$'
+
+        if re.search(scdoc_preamble_pattern, first_line):
+            result += 0.5
+
+        return result
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/scripting.py b/env/lib/python3.12/site-packages/pygments/lexers/scripting.py
new file mode 100644
index 0000000..6e494c3
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/scripting.py
@@ -0,0 +1,1616 @@
+"""
+    pygments.lexers.scripting
+    ~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for scripting and embedded languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import RegexLexer, include, bygroups, default, combined, \
+    words
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Error, Whitespace, Other
+from pygments.util import get_bool_opt, get_list_opt
+
+__all__ = ['LuaLexer', 'LuauLexer', 'MoonScriptLexer', 'ChaiscriptLexer', 'LSLLexer',
+           'AppleScriptLexer', 'RexxLexer', 'MOOCodeLexer', 'HybrisLexer',
+           'EasytrieveLexer', 'JclLexer', 'MiniScriptLexer']
+
+
+def all_lua_builtins():
+    from pygments.lexers._lua_builtins import MODULES
+    return [w for values in MODULES.values() for w in values]
+
+class LuaLexer(RegexLexer):
+    """
+    For Lua source code.
+
+    Additional options accepted:
+
+    `func_name_highlighting`
+        If given and ``True``, highlight builtin function names
+        (default: ``True``).
+    `disabled_modules`
+        If given, must be a list of module names whose function names
+        should not be highlighted. By default all modules are highlighted.
+
+        To get a list of allowed modules have a look into the
+        `_lua_builtins` module:
+
+        .. sourcecode:: pycon
+
+            >>> from pygments.lexers._lua_builtins import MODULES
+            >>> MODULES.keys()
+            ['string', 'coroutine', 'modules', 'io', 'basic', ...]
+    """
+
+    name = 'Lua'
+    url = 'https://www.lua.org/'
+    aliases = ['lua']
+    filenames = ['*.lua', '*.wlua']
+    mimetypes = ['text/x-lua', 'application/x-lua']
+    version_added = ''
+
+    _comment_multiline = r'(?:--\[(?P=*)\[[\w\W]*?\](?P=level)\])'
+    _comment_single = r'(?:--.*$)'
+    _space = r'(?:\s+(?!\s))'
+    _s = rf'(?:{_comment_multiline}|{_comment_single}|{_space})'
+    _name = r'(?:[^\W\d]\w*)'
+
+    tokens = {
+        'root': [
+            # Lua allows a file to start with a shebang.
+            (r'#!.*', Comment.Preproc),
+            default('base'),
+        ],
+        'ws': [
+            (_comment_multiline, Comment.Multiline),
+            (_comment_single, Comment.Single),
+            (_space, Whitespace),
+        ],
+        'base': [
+            include('ws'),
+
+            (r'(?i)0x[\da-f]*(\.[\da-f]*)?(p[+-]?\d+)?', Number.Hex),
+            (r'(?i)(\d*\.\d+|\d+\.\d*)(e[+-]?\d+)?', Number.Float),
+            (r'(?i)\d+e[+-]?\d+', Number.Float),
+            (r'\d+', Number.Integer),
+
+            # multiline strings
+            (r'(?s)\[(=*)\[.*?\]\1\]', String),
+
+            (r'::', Punctuation, 'label'),
+            (r'\.{3}', Punctuation),
+            (r'[=<>|~&+\-*/%#^]+|\.\.', Operator),
+            (r'[\[\]{}().,:;]+', Punctuation),
+            (r'(and|or|not)\b', Operator.Word),
+
+            (words([
+                'break', 'do', 'else', 'elseif', 'end', 'for', 'if', 'in',
+                'repeat', 'return', 'then', 'until', 'while'
+            ], suffix=r'\b'), Keyword.Reserved),
+            (r'goto\b', Keyword.Reserved, 'goto'),
+            (r'(local)\b', Keyword.Declaration),
+            (r'(true|false|nil)\b', Keyword.Constant),
+
+            (r'(function)\b', Keyword.Reserved, 'funcname'),
+
+            (words(all_lua_builtins(), suffix=r"\b"), Name.Builtin),
+            (fr'[A-Za-z_]\w*(?={_s}*[.:])', Name.Variable, 'varname'),
+            (fr'[A-Za-z_]\w*(?={_s}*\()', Name.Function),
+            (r'[A-Za-z_]\w*', Name.Variable),
+
+            ("'", String.Single, combined('stringescape', 'sqs')),
+            ('"', String.Double, combined('stringescape', 'dqs'))
+        ],
+
+        'varname': [
+            include('ws'),
+            (r'\.\.', Operator, '#pop'),
+            (r'[.:]', Punctuation),
+            (rf'{_name}(?={_s}*[.:])', Name.Property),
+            (rf'{_name}(?={_s}*\()', Name.Function, '#pop'),
+            (_name, Name.Property, '#pop'),
+        ],
+
+        'funcname': [
+            include('ws'),
+            (r'[.:]', Punctuation),
+            (rf'{_name}(?={_s}*[.:])', Name.Class),
+            (_name, Name.Function, '#pop'),
+            # inline function
+            (r'\(', Punctuation, '#pop'),
+        ],
+
+        'goto': [
+            include('ws'),
+            (_name, Name.Label, '#pop'),
+        ],
+
+        'label': [
+            include('ws'),
+            (r'::', Punctuation, '#pop'),
+            (_name, Name.Label),
+        ],
+
+        'stringescape': [
+            (r'\\([abfnrtv\\"\']|[\r\n]{1,2}|z\s*|x[0-9a-fA-F]{2}|\d{1,3}|'
+             r'u\{[0-9a-fA-F]+\})', String.Escape),
+        ],
+
+        'sqs': [
+            (r"'", String.Single, '#pop'),
+            (r"[^\\']+", String.Single),
+        ],
+
+        'dqs': [
+            (r'"', String.Double, '#pop'),
+            (r'[^\\"]+', String.Double),
+        ]
+    }
+
+    def __init__(self, **options):
+        self.func_name_highlighting = get_bool_opt(
+            options, 'func_name_highlighting', True)
+        self.disabled_modules = get_list_opt(options, 'disabled_modules', [])
+
+        self._functions = set()
+        if self.func_name_highlighting:
+            from pygments.lexers._lua_builtins import MODULES
+            for mod, func in MODULES.items():
+                if mod not in self.disabled_modules:
+                    self._functions.update(func)
+        RegexLexer.__init__(self, **options)
+
+    def get_tokens_unprocessed(self, text):
+        for index, token, value in \
+                RegexLexer.get_tokens_unprocessed(self, text):
+            if token is Name.Builtin and value not in self._functions:
+                if '.' in value:
+                    a, b = value.split('.')
+                    yield index, Name, a
+                    yield index + len(a), Punctuation, '.'
+                    yield index + len(a) + 1, Name, b
+                else:
+                    yield index, Name, value
+                continue
+            yield index, token, value
+
+def _luau_make_expression(should_pop, _s):
+    temp_list = [
+        (r'0[xX][\da-fA-F_]*', Number.Hex, '#pop'),
+        (r'0[bB][\d_]*', Number.Bin, '#pop'),
+        (r'\.?\d[\d_]*(?:\.[\d_]*)?(?:[eE][+-]?[\d_]+)?', Number.Float, '#pop'),
+
+        (words((
+            'true', 'false', 'nil'
+        ), suffix=r'\b'), Keyword.Constant, '#pop'),
+
+        (r'\[(=*)\[[.\n]*?\]\1\]', String, '#pop'),
+
+        (r'(\.)([a-zA-Z_]\w*)(?=%s*[({"\'])', bygroups(Punctuation, Name.Function), '#pop'),
+        (r'(\.)([a-zA-Z_]\w*)', bygroups(Punctuation, Name.Variable), '#pop'),
+
+        (rf'[a-zA-Z_]\w*(?:\.[a-zA-Z_]\w*)*(?={_s}*[({{"\'])', Name.Other, '#pop'),
+        (r'[a-zA-Z_]\w*(?:\.[a-zA-Z_]\w*)*', Name, '#pop'),
+    ]
+    if should_pop:
+        return temp_list
+    return [entry[:2] for entry in temp_list]
+
+def _luau_make_expression_special(should_pop):
+    temp_list = [
+        (r'\{', Punctuation, ('#pop', 'closing_brace_base', 'expression')),
+        (r'\(', Punctuation, ('#pop', 'closing_parenthesis_base', 'expression')),
+
+        (r'::?', Punctuation, ('#pop', 'type_end', 'type_start')),
+
+        (r"'", String.Single, ('#pop', 'string_single')),
+        (r'"', String.Double, ('#pop', 'string_double')),
+        (r'`', String.Backtick, ('#pop', 'string_interpolated')),
+    ]
+    if should_pop:
+        return temp_list
+    return [(entry[0], entry[1], entry[2][1:]) for entry in temp_list]
+
+class LuauLexer(RegexLexer):
+    """
+    For Luau source code.
+
+    Additional options accepted:
+
+    `include_luau_builtins`
+        If given and ``True``, automatically highlight Luau builtins
+        (default: ``True``).
+    `include_roblox_builtins`
+        If given and ``True``, automatically highlight Roblox-specific builtins
+        (default: ``False``).
+    `additional_builtins`
+        If given, must be a list of additional builtins to highlight.
+    `disabled_builtins`
+        If given, must be a list of builtins that will not be highlighted.
+    """
+
+    name = 'Luau'
+    url = 'https://luau-lang.org/'
+    aliases = ['luau']
+    filenames = ['*.luau']
+    version_added = '2.18'
+
+    _comment_multiline = r'(?:--\[(?P=*)\[[\w\W]*?\](?P=level)\])'
+    _comment_single = r'(?:--.*$)'
+    _s = r'(?:{}|{}|{})'.format(_comment_multiline, _comment_single, r'\s+')
+
+    tokens = {
+        'root': [
+            (r'#!.*', Comment.Hashbang, 'base'),
+            default('base'),
+        ],
+
+        'ws': [
+            (_comment_multiline, Comment.Multiline),
+            (_comment_single, Comment.Single),
+            (r'\s+', Whitespace),
+        ],
+
+        'base': [
+            include('ws'),
+
+            *_luau_make_expression_special(False),
+            (r'\.\.\.', Punctuation),
+
+            (rf'type\b(?={_s}+[a-zA-Z_])', Keyword.Reserved, 'type_declaration'),
+            (rf'export\b(?={_s}+[a-zA-Z_])', Keyword.Reserved),
+
+            (r'(?:\.\.|//|[+\-*\/%^<>=])=?', Operator, 'expression'),
+            (r'~=', Operator, 'expression'),
+
+            (words((
+                'and', 'or', 'not'
+            ), suffix=r'\b'), Operator.Word, 'expression'),
+
+            (words((
+                'elseif', 'for', 'if', 'in', 'repeat', 'return', 'until',
+                'while'), suffix=r'\b'), Keyword.Reserved, 'expression'),
+            (r'local\b', Keyword.Declaration, 'expression'),
+
+            (r'function\b', Keyword.Reserved, ('expression', 'func_name')),
+
+            (r'[\])};]+', Punctuation),
+
+            include('expression_static'),
+            *_luau_make_expression(False, _s),
+
+            (r'[\[.,]', Punctuation, 'expression'),
+        ],
+        'expression_static': [
+            (words((
+                'break', 'continue', 'do', 'else', 'elseif', 'end', 'for',
+                'if', 'in', 'repeat', 'return', 'then', 'until', 'while'),
+                suffix=r'\b'), Keyword.Reserved),
+        ],
+        'expression': [
+            include('ws'),
+
+            (r'if\b', Keyword.Reserved, ('ternary', 'expression')),
+
+            (r'local\b', Keyword.Declaration),
+            *_luau_make_expression_special(True),
+            (r'\.\.\.', Punctuation, '#pop'),
+
+            (r'function\b', Keyword.Reserved, 'func_name'),
+
+            include('expression_static'),
+            *_luau_make_expression(True, _s),
+
+            default('#pop'),
+        ],
+        'ternary': [
+            include('ws'),
+
+            (r'else\b', Keyword.Reserved, '#pop'),
+            (words((
+                'then', 'elseif',
+            ), suffix=r'\b'), Operator.Reserved, 'expression'),
+
+            default('#pop'),
+        ],
+
+        'closing_brace_pop': [
+            (r'\}', Punctuation, '#pop'),
+        ],
+        'closing_parenthesis_pop': [
+            (r'\)', Punctuation, '#pop'),
+        ],
+        'closing_gt_pop': [
+            (r'>', Punctuation, '#pop'),
+        ],
+
+        'closing_parenthesis_base': [
+            include('closing_parenthesis_pop'),
+            include('base'),
+        ],
+        'closing_parenthesis_type': [
+            include('closing_parenthesis_pop'),
+            include('type'),
+        ],
+        'closing_brace_base': [
+            include('closing_brace_pop'),
+            include('base'),
+        ],
+        'closing_brace_type': [
+            include('closing_brace_pop'),
+            include('type'),
+        ],
+        'closing_gt_type': [
+            include('closing_gt_pop'),
+            include('type'),
+        ],
+
+        'string_escape': [
+            (r'\\z\s*', String.Escape),
+            (r'\\(?:[abfnrtvz\\"\'`\{\n])|[\r\n]{1,2}|x[\da-fA-F]{2}|\d{1,3}|'
+             r'u\{\}[\da-fA-F]*\}', String.Escape),
+        ],
+        'string_single': [
+            include('string_escape'),
+
+            (r"'", String.Single, "#pop"),
+            (r"[^\\']+", String.Single),
+        ],
+        'string_double': [
+            include('string_escape'),
+
+            (r'"', String.Double, "#pop"),
+            (r'[^\\"]+', String.Double),
+        ],
+        'string_interpolated': [
+            include('string_escape'),
+
+            (r'\{', Punctuation, ('closing_brace_base', 'expression')),
+
+            (r'`', String.Backtick, "#pop"),
+            (r'[^\\`\{]+', String.Backtick),
+        ],
+
+        'func_name': [
+            include('ws'),
+
+            (r'[.:]', Punctuation),
+            (rf'[a-zA-Z_]\w*(?={_s}*[.:])', Name.Class),
+            (r'[a-zA-Z_]\w*', Name.Function),
+
+            (r'<', Punctuation, 'closing_gt_type'),
+
+            (r'\(', Punctuation, '#pop'),
+        ],
+
+        'type': [
+            include('ws'),
+
+            (r'\(', Punctuation, 'closing_parenthesis_type'),
+            (r'\{', Punctuation, 'closing_brace_type'),
+            (r'<', Punctuation, 'closing_gt_type'),
+
+            (r"'", String.Single, 'string_single'),
+            (r'"', String.Double, 'string_double'),
+
+            (r'[|&\.,\[\]:=]+', Punctuation),
+            (r'->', Punctuation),
+
+            (r'typeof\(', Name.Builtin, ('closing_parenthesis_base',
+                                         'expression')),
+            (r'[a-zA-Z_]\w*', Name.Class),
+        ],
+        'type_start': [
+            include('ws'),
+
+            (r'\(', Punctuation, ('#pop', 'closing_parenthesis_type')),
+            (r'\{', Punctuation, ('#pop', 'closing_brace_type')),
+            (r'<', Punctuation, ('#pop', 'closing_gt_type')),
+
+            (r"'", String.Single, ('#pop', 'string_single')),
+            (r'"', String.Double, ('#pop', 'string_double')),
+
+            (r'typeof\(', Name.Builtin, ('#pop', 'closing_parenthesis_base',
+                                         'expression')),
+            (r'[a-zA-Z_]\w*', Name.Class, '#pop'),
+        ],
+        'type_end': [
+            include('ws'),
+
+            (r'[|&\.]', Punctuation, 'type_start'),
+            (r'->', Punctuation, 'type_start'),
+
+            (r'<', Punctuation, 'closing_gt_type'),
+
+            default('#pop'),
+        ],
+        'type_declaration': [
+            include('ws'),
+
+            (r'[a-zA-Z_]\w*', Name.Class),
+            (r'<', Punctuation, 'closing_gt_type'),
+
+            (r'=', Punctuation, ('#pop', 'type_end', 'type_start')),
+        ],
+    }
+
+    def __init__(self, **options):
+        self.include_luau_builtins = get_bool_opt(
+            options, 'include_luau_builtins', True)
+        self.include_roblox_builtins = get_bool_opt(
+            options, 'include_roblox_builtins', False)
+        self.additional_builtins = get_list_opt(options, 'additional_builtins', [])
+        self.disabled_builtins = get_list_opt(options, 'disabled_builtins', [])
+
+        self._builtins = set(self.additional_builtins)
+        if self.include_luau_builtins:
+            from pygments.lexers._luau_builtins import LUAU_BUILTINS
+            self._builtins.update(LUAU_BUILTINS)
+        if self.include_roblox_builtins:
+            from pygments.lexers._luau_builtins import ROBLOX_BUILTINS
+            self._builtins.update(ROBLOX_BUILTINS)
+        if self.additional_builtins:
+            self._builtins.update(self.additional_builtins)
+        self._builtins.difference_update(self.disabled_builtins)
+
+        RegexLexer.__init__(self, **options)
+
+    def get_tokens_unprocessed(self, text):
+        for index, token, value in \
+                RegexLexer.get_tokens_unprocessed(self, text):
+            if token is Name or token is Name.Other:
+                split_value = value.split('.')
+                complete_value = []
+                new_index = index
+                for position in range(len(split_value), 0, -1):
+                    potential_string = '.'.join(split_value[:position])
+                    if potential_string in self._builtins:
+                        yield index, Name.Builtin, potential_string
+                        new_index += len(potential_string)
+
+                        if complete_value:
+                            yield new_index, Punctuation, '.'
+                            new_index += 1
+                        break
+                    complete_value.insert(0, split_value[position - 1])
+
+                for position, substring in enumerate(complete_value):
+                    if position + 1 == len(complete_value):
+                        if token is Name:
+                            yield new_index, Name.Variable, substring
+                            continue
+                        yield new_index, Name.Function, substring
+                        continue
+                    yield new_index, Name.Variable, substring
+                    new_index += len(substring)
+                    yield new_index, Punctuation, '.'
+                    new_index += 1
+
+                continue
+            yield index, token, value
+
+class MoonScriptLexer(LuaLexer):
+    """
+    For MoonScript source code.
+    """
+
+    name = 'MoonScript'
+    url = 'http://moonscript.org'
+    aliases = ['moonscript', 'moon']
+    filenames = ['*.moon']
+    mimetypes = ['text/x-moonscript', 'application/x-moonscript']
+    version_added = '1.5'
+
+    tokens = {
+        'root': [
+            (r'#!(.*?)$', Comment.Preproc),
+            default('base'),
+        ],
+        'base': [
+            ('--.*$', Comment.Single),
+            (r'(?i)(\d*\.\d+|\d+\.\d*)(e[+-]?\d+)?', Number.Float),
+            (r'(?i)\d+e[+-]?\d+', Number.Float),
+            (r'(?i)0x[0-9a-f]*', Number.Hex),
+            (r'\d+', Number.Integer),
+            (r'\n', Whitespace),
+            (r'[^\S\n]+', Text),
+            (r'(?s)\[(=*)\[.*?\]\1\]', String),
+            (r'(->|=>)', Name.Function),
+            (r':[a-zA-Z_]\w*', Name.Variable),
+            (r'(==|!=|~=|<=|>=|\.\.\.|\.\.|[=+\-*/%^<>#!.\\:])', Operator),
+            (r'[;,]', Punctuation),
+            (r'[\[\]{}()]', Keyword.Type),
+            (r'[a-zA-Z_]\w*:', Name.Variable),
+            (words((
+                'class', 'extends', 'if', 'then', 'super', 'do', 'with',
+                'import', 'export', 'while', 'elseif', 'return', 'for', 'in',
+                'from', 'when', 'using', 'else', 'and', 'or', 'not', 'switch',
+                'break'), suffix=r'\b'),
+             Keyword),
+            (r'(true|false|nil)\b', Keyword.Constant),
+            (r'(and|or|not)\b', Operator.Word),
+            (r'(self)\b', Name.Builtin.Pseudo),
+            (r'@@?([a-zA-Z_]\w*)?', Name.Variable.Class),
+            (r'[A-Z]\w*', Name.Class),  # proper name
+            (words(all_lua_builtins(), suffix=r"\b"), Name.Builtin),
+            (r'[A-Za-z_]\w*', Name),
+            ("'", String.Single, combined('stringescape', 'sqs')),
+            ('"', String.Double, combined('stringescape', 'dqs'))
+        ],
+        'stringescape': [
+            (r'''\\([abfnrtv\\"']|\d{1,3})''', String.Escape)
+        ],
+        'sqs': [
+            ("'", String.Single, '#pop'),
+            ("[^']+", String)
+        ],
+        'dqs': [
+            ('"', String.Double, '#pop'),
+            ('[^"]+', String)
+        ]
+    }
+
+    def get_tokens_unprocessed(self, text):
+        # set . as Operator instead of Punctuation
+        for index, token, value in LuaLexer.get_tokens_unprocessed(self, text):
+            if token == Punctuation and value == ".":
+                token = Operator
+            yield index, token, value
+
+
+class ChaiscriptLexer(RegexLexer):
+    """
+    For ChaiScript source code.
+    """
+
+    name = 'ChaiScript'
+    url = 'http://chaiscript.com/'
+    aliases = ['chaiscript', 'chai']
+    filenames = ['*.chai']
+    mimetypes = ['text/x-chaiscript', 'application/x-chaiscript']
+    version_added = '2.0'
+
+    flags = re.DOTALL | re.MULTILINE
+
+    tokens = {
+        'commentsandwhitespace': [
+            (r'\s+', Text),
+            (r'//.*?\n', Comment.Single),
+            (r'/\*.*?\*/', Comment.Multiline),
+            (r'^\#.*?\n', Comment.Single)
+        ],
+        'slashstartsregex': [
+            include('commentsandwhitespace'),
+            (r'/(\\.|[^[/\\\n]|\[(\\.|[^\]\\\n])*])+/'
+             r'([gim]+\b|\B)', String.Regex, '#pop'),
+            (r'(?=/)', Text, ('#pop', 'badregex')),
+            default('#pop')
+        ],
+        'badregex': [
+            (r'\n', Text, '#pop')
+        ],
+        'root': [
+            include('commentsandwhitespace'),
+            (r'\n', Text),
+            (r'[^\S\n]+', Text),
+            (r'\+\+|--|~|&&|\?|:|\|\||\\(?=\n)|\.\.'
+             r'(<<|>>>?|==?|!=?|[-<>+*%&|^/])=?', Operator, 'slashstartsregex'),
+            (r'[{(\[;,]', Punctuation, 'slashstartsregex'),
+            (r'[})\].]', Punctuation),
+            (r'[=+\-*/]', Operator),
+            (r'(for|in|while|do|break|return|continue|if|else|'
+             r'throw|try|catch'
+             r')\b', Keyword, 'slashstartsregex'),
+            (r'(var)\b', Keyword.Declaration, 'slashstartsregex'),
+            (r'(attr|def|fun)\b', Keyword.Reserved),
+            (r'(true|false)\b', Keyword.Constant),
+            (r'(eval|throw)\b', Name.Builtin),
+            (r'`\S+`', Name.Builtin),
+            (r'[$a-zA-Z_]\w*', Name.Other),
+            (r'[0-9][0-9]*\.[0-9]+([eE][0-9]+)?[fd]?', Number.Float),
+            (r'0x[0-9a-fA-F]+', Number.Hex),
+            (r'[0-9]+', Number.Integer),
+            (r'"', String.Double, 'dqstring'),
+            (r"'(\\\\|\\[^\\]|[^'\\])*'", String.Single),
+        ],
+        'dqstring': [
+            (r'\$\{[^"}]+?\}', String.Interpol),
+            (r'\$', String.Double),
+            (r'\\\\', String.Double),
+            (r'\\"', String.Double),
+            (r'[^\\"$]+', String.Double),
+            (r'"', String.Double, '#pop'),
+        ],
+    }
+
+
+class LSLLexer(RegexLexer):
+    """
+    For Second Life's Linden Scripting Language source code.
+    """
+
+    name = 'LSL'
+    aliases = ['lsl']
+    filenames = ['*.lsl']
+    mimetypes = ['text/x-lsl']
+    url = 'https://wiki.secondlife.com/wiki/Linden_Scripting_Language'
+    version_added = '2.0'
+
+    flags = re.MULTILINE
+
+    lsl_keywords = r'\b(?:do|else|for|if|jump|return|while)\b'
+    lsl_types = r'\b(?:float|integer|key|list|quaternion|rotation|string|vector)\b'
+    lsl_states = r'\b(?:(?:state)\s+\w+|default)\b'
+    lsl_events = r'\b(?:state_(?:entry|exit)|touch(?:_(?:start|end))?|(?:land_)?collision(?:_(?:start|end))?|timer|listen|(?:no_)?sensor|control|(?:not_)?at_(?:rot_)?target|money|email|run_time_permissions|changed|attach|dataserver|moving_(?:start|end)|link_message|(?:on|object)_rez|remote_data|http_re(?:sponse|quest)|path_update|transaction_result)\b'
+    lsl_functions_builtin = r'\b(?:ll(?:ReturnObjectsBy(?:ID|Owner)|Json(?:2List|[GS]etValue|ValueType)|Sin|Cos|Tan|Atan2|Sqrt|Pow|Abs|Fabs|Frand|Floor|Ceil|Round|Vec(?:Mag|Norm|Dist)|Rot(?:Between|2(?:Euler|Fwd|Left|Up))|(?:Euler|Axes)2Rot|Whisper|(?:Region|Owner)?Say|Shout|Listen(?:Control|Remove)?|Sensor(?:Repeat|Remove)?|Detected(?:Name|Key|Owner|Type|Pos|Vel|Grab|Rot|Group|LinkNumber)|Die|Ground|Wind|(?:[GS]et)(?:AnimationOverride|MemoryLimit|PrimMediaParams|ParcelMusicURL|Object(?:Desc|Name)|PhysicsMaterial|Status|Scale|Color|Alpha|Texture|Pos|Rot|Force|Torque)|ResetAnimationOverride|(?:Scale|Offset|Rotate)Texture|(?:Rot)?Target(?:Remove)?|(?:Stop)?MoveToTarget|Apply(?:Rotational)?Impulse|Set(?:KeyframedMotion|ContentType|RegionPos|(?:Angular)?Velocity|Buoyancy|HoverHeight|ForceAndTorque|TimerEvent|ScriptState|Damage|TextureAnim|Sound(?:Queueing|Radius)|Vehicle(?:Type|(?:Float|Vector|Rotation)Param)|(?:Touch|Sit)?Text|Camera(?:Eye|At)Offset|PrimitiveParams|ClickAction|Link(?:Alpha|Color|PrimitiveParams(?:Fast)?|Texture(?:Anim)?|Camera|Media)|RemoteScriptAccessPin|PayPrice|LocalRot)|ScaleByFactor|Get(?:(?:Max|Min)ScaleFactor|ClosestNavPoint|StaticPath|SimStats|Env|PrimitiveParams|Link(?:PrimitiveParams|Number(?:OfSides)?|Key|Name|Media)|HTTPHeader|FreeURLs|Object(?:Details|PermMask|PrimCount)|Parcel(?:MaxPrims|Details|Prim(?:Count|Owners))|Attached|(?:SPMax|Free|Used)Memory|Region(?:Name|TimeDilation|FPS|Corner|AgentCount)|Root(?:Position|Rotation)|UnixTime|(?:Parcel|Region)Flags|(?:Wall|GMT)clock|SimulatorHostname|BoundingBox|GeometricCenter|Creator|NumberOf(?:Prims|NotecardLines|Sides)|Animation(?:List)?|(?:Camera|Local)(?:Pos|Rot)|Vel|Accel|Omega|Time(?:stamp|OfDay)|(?:Object|CenterOf)?Mass|MassMKS|Energy|Owner|(?:Owner)?Key|SunDirection|Texture(?:Offset|Scale|Rot)|Inventory(?:Number|Name|Key|Type|Creator|PermMask)|Permissions(?:Key)?|StartParameter|List(?:Length|EntryType)|Date|Agent(?:Size|Info|Language|List)|LandOwnerAt|NotecardLine|Script(?:Name|State))|(?:Get|Reset|GetAndReset)Time|PlaySound(?:Slave)?|LoopSound(?:Master|Slave)?|(?:Trigger|Stop|Preload)Sound|(?:(?:Get|Delete)Sub|Insert)String|To(?:Upper|Lower)|Give(?:InventoryList|Money)|RezObject|(?:Stop)?LookAt|Sleep|CollisionFilter|(?:Take|Release)Controls|DetachFromAvatar|AttachToAvatar(?:Temp)?|InstantMessage|(?:GetNext)?Email|StopHover|MinEventDelay|RotLookAt|String(?:Length|Trim)|(?:Start|Stop)Animation|TargetOmega|RequestPermissions|(?:Create|Break)Link|BreakAllLinks|(?:Give|Remove)Inventory|Water|PassTouches|Request(?:Agent|Inventory)Data|TeleportAgent(?:Home|GlobalCoords)?|ModifyLand|CollisionSound|ResetScript|MessageLinked|PushObject|PassCollisions|AxisAngle2Rot|Rot2(?:Axis|Angle)|A(?:cos|sin)|AngleBetween|AllowInventoryDrop|SubStringIndex|List2(?:CSV|Integer|Json|Float|String|Key|Vector|Rot|List(?:Strided)?)|DeleteSubList|List(?:Statistics|Sort|Randomize|(?:Insert|Find|Replace)List)|EdgeOfWorld|AdjustSoundVolume|Key2Name|TriggerSoundLimited|EjectFromLand|(?:CSV|ParseString)2List|OverMyLand|SameGroup|UnSit|Ground(?:Slope|Normal|Contour)|GroundRepel|(?:Set|Remove)VehicleFlags|(?:AvatarOn)?(?:Link)?SitTarget|Script(?:Danger|Profiler)|Dialog|VolumeDetect|ResetOtherScript|RemoteLoadScriptPin|(?:Open|Close)RemoteDataChannel|SendRemoteData|RemoteDataReply|(?:Integer|String)ToBase64|XorBase64|Log(?:10)?|Base64To(?:String|Integer)|ParseStringKeepNulls|RezAtRoot|RequestSimulatorData|ForceMouselook|(?:Load|Release|(?:E|Une)scape)URL|ParcelMedia(?:CommandList|Query)|ModPow|MapDestination|(?:RemoveFrom|AddTo|Reset)Land(?:Pass|Ban)List|(?:Set|Clear)CameraParams|HTTP(?:Request|Response)|TextBox|DetectedTouch(?:UV|Face|Pos|(?:N|Bin)ormal|ST)|(?:MD5|SHA1|DumpList2)String|Request(?:Secure)?URL|Clear(?:Prim|Link)Media|(?:Link)?ParticleSystem|(?:Get|Request)(?:Username|DisplayName)|RegionSayTo|CastRay|GenerateKey|TransferLindenDollars|ManageEstateAccess|(?:Create|Delete)Character|ExecCharacterCmd|Evade|FleeFrom|NavigateTo|PatrolPoints|Pursue|UpdateCharacter|WanderWithin))\b'
+    lsl_constants_float = r'\b(?:DEG_TO_RAD|PI(?:_BY_TWO)?|RAD_TO_DEG|SQRT2|TWO_PI)\b'
+    lsl_constants_integer = r'\b(?:JSON_APPEND|STATUS_(?:PHYSICS|ROTATE_[XYZ]|PHANTOM|SANDBOX|BLOCK_GRAB(?:_OBJECT)?|(?:DIE|RETURN)_AT_EDGE|CAST_SHADOWS|OK|MALFORMED_PARAMS|TYPE_MISMATCH|BOUNDS_ERROR|NOT_(?:FOUND|SUPPORTED)|INTERNAL_ERROR|WHITELIST_FAILED)|AGENT(?:_(?:BY_(?:LEGACY_|USER)NAME|FLYING|ATTACHMENTS|SCRIPTED|MOUSELOOK|SITTING|ON_OBJECT|AWAY|WALKING|IN_AIR|TYPING|CROUCHING|BUSY|ALWAYS_RUN|AUTOPILOT|LIST_(?:PARCEL(?:_OWNER)?|REGION)))?|CAMERA_(?:PITCH|DISTANCE|BEHINDNESS_(?:ANGLE|LAG)|(?:FOCUS|POSITION)(?:_(?:THRESHOLD|LOCKED|LAG))?|FOCUS_OFFSET|ACTIVE)|ANIM_ON|LOOP|REVERSE|PING_PONG|SMOOTH|ROTATE|SCALE|ALL_SIDES|LINK_(?:ROOT|SET|ALL_(?:OTHERS|CHILDREN)|THIS)|ACTIVE|PASSIVE|SCRIPTED|CONTROL_(?:FWD|BACK|(?:ROT_)?(?:LEFT|RIGHT)|UP|DOWN|(?:ML_)?LBUTTON)|PERMISSION_(?:RETURN_OBJECTS|DEBIT|OVERRIDE_ANIMATIONS|SILENT_ESTATE_MANAGEMENT|TAKE_CONTROLS|TRIGGER_ANIMATION|ATTACH|CHANGE_LINKS|(?:CONTROL|TRACK)_CAMERA|TELEPORT)|INVENTORY_(?:TEXTURE|SOUND|OBJECT|SCRIPT|LANDMARK|CLOTHING|NOTECARD|BODYPART|ANIMATION|GESTURE|ALL|NONE)|CHANGED_(?:INVENTORY|COLOR|SHAPE|SCALE|TEXTURE|LINK|ALLOWED_DROP|OWNER|REGION(?:_START)?|TELEPORT|MEDIA)|OBJECT_(?:(?:PHYSICS|SERVER|STREAMING)_COST|UNKNOWN_DETAIL|CHARACTER_TIME|PHANTOM|PHYSICS|TEMP_ON_REZ|NAME|DESC|POS|PRIM_EQUIVALENCE|RETURN_(?:PARCEL(?:_OWNER)?|REGION)|ROO?T|VELOCITY|OWNER|GROUP|CREATOR|ATTACHED_POINT|RENDER_WEIGHT|PATHFINDING_TYPE|(?:RUNNING|TOTAL)_SCRIPT_COUNT|SCRIPT_(?:MEMORY|TIME))|TYPE_(?:INTEGER|FLOAT|STRING|KEY|VECTOR|ROTATION|INVALID)|(?:DEBUG|PUBLIC)_CHANNEL|ATTACH_(?:AVATAR_CENTER|CHEST|HEAD|BACK|PELVIS|MOUTH|CHIN|NECK|NOSE|BELLY|[LR](?:SHOULDER|HAND|FOOT|EAR|EYE|[UL](?:ARM|LEG)|HIP)|(?:LEFT|RIGHT)_PEC|HUD_(?:CENTER_[12]|TOP_(?:RIGHT|CENTER|LEFT)|BOTTOM(?:_(?:RIGHT|LEFT))?))|LAND_(?:LEVEL|RAISE|LOWER|SMOOTH|NOISE|REVERT)|DATA_(?:ONLINE|NAME|BORN|SIM_(?:POS|STATUS|RATING)|PAYINFO)|PAYMENT_INFO_(?:ON_FILE|USED)|REMOTE_DATA_(?:CHANNEL|REQUEST|REPLY)|PSYS_(?:PART_(?:BF_(?:ZERO|ONE(?:_MINUS_(?:DEST_COLOR|SOURCE_(ALPHA|COLOR)))?|DEST_COLOR|SOURCE_(ALPHA|COLOR))|BLEND_FUNC_(DEST|SOURCE)|FLAGS|(?:START|END)_(?:COLOR|ALPHA|SCALE|GLOW)|MAX_AGE|(?:RIBBON|WIND|INTERP_(?:COLOR|SCALE)|BOUNCE|FOLLOW_(?:SRC|VELOCITY)|TARGET_(?:POS|LINEAR)|EMISSIVE)_MASK)|SRC_(?:MAX_AGE|PATTERN|ANGLE_(?:BEGIN|END)|BURST_(?:RATE|PART_COUNT|RADIUS|SPEED_(?:MIN|MAX))|ACCEL|TEXTURE|TARGET_KEY|OMEGA|PATTERN_(?:DROP|EXPLODE|ANGLE(?:_CONE(?:_EMPTY)?)?)))|VEHICLE_(?:REFERENCE_FRAME|TYPE_(?:NONE|SLED|CAR|BOAT|AIRPLANE|BALLOON)|(?:LINEAR|ANGULAR)_(?:FRICTION_TIMESCALE|MOTOR_DIRECTION)|LINEAR_MOTOR_OFFSET|HOVER_(?:HEIGHT|EFFICIENCY|TIMESCALE)|BUOYANCY|(?:LINEAR|ANGULAR)_(?:DEFLECTION_(?:EFFICIENCY|TIMESCALE)|MOTOR_(?:DECAY_)?TIMESCALE)|VERTICAL_ATTRACTION_(?:EFFICIENCY|TIMESCALE)|BANKING_(?:EFFICIENCY|MIX|TIMESCALE)|FLAG_(?:NO_DEFLECTION_UP|LIMIT_(?:ROLL_ONLY|MOTOR_UP)|HOVER_(?:(?:WATER|TERRAIN|UP)_ONLY|GLOBAL_HEIGHT)|MOUSELOOK_(?:STEER|BANK)|CAMERA_DECOUPLED))|PRIM_(?:TYPE(?:_(?:BOX|CYLINDER|PRISM|SPHERE|TORUS|TUBE|RING|SCULPT))?|HOLE_(?:DEFAULT|CIRCLE|SQUARE|TRIANGLE)|MATERIAL(?:_(?:STONE|METAL|GLASS|WOOD|FLESH|PLASTIC|RUBBER))?|SHINY_(?:NONE|LOW|MEDIUM|HIGH)|BUMP_(?:NONE|BRIGHT|DARK|WOOD|BARK|BRICKS|CHECKER|CONCRETE|TILE|STONE|DISKS|GRAVEL|BLOBS|SIDING|LARGETILE|STUCCO|SUCTION|WEAVE)|TEXGEN_(?:DEFAULT|PLANAR)|SCULPT_(?:TYPE_(?:SPHERE|TORUS|PLANE|CYLINDER|MASK)|FLAG_(?:MIRROR|INVERT))|PHYSICS(?:_(?:SHAPE_(?:CONVEX|NONE|PRIM|TYPE)))?|(?:POS|ROT)_LOCAL|SLICE|TEXT|FLEXIBLE|POINT_LIGHT|TEMP_ON_REZ|PHANTOM|POSITION|SIZE|ROTATION|TEXTURE|NAME|OMEGA|DESC|LINK_TARGET|COLOR|BUMP_SHINY|FULLBRIGHT|TEXGEN|GLOW|MEDIA_(?:ALT_IMAGE_ENABLE|CONTROLS|(?:CURRENT|HOME)_URL|AUTO_(?:LOOP|PLAY|SCALE|ZOOM)|FIRST_CLICK_INTERACT|(?:WIDTH|HEIGHT)_PIXELS|WHITELIST(?:_ENABLE)?|PERMS_(?:INTERACT|CONTROL)|PARAM_MAX|CONTROLS_(?:STANDARD|MINI)|PERM_(?:NONE|OWNER|GROUP|ANYONE)|MAX_(?:URL_LENGTH|WHITELIST_(?:SIZE|COUNT)|(?:WIDTH|HEIGHT)_PIXELS)))|MASK_(?:BASE|OWNER|GROUP|EVERYONE|NEXT)|PERM_(?:TRANSFER|MODIFY|COPY|MOVE|ALL)|PARCEL_(?:MEDIA_COMMAND_(?:STOP|PAUSE|PLAY|LOOP|TEXTURE|URL|TIME|AGENT|UNLOAD|AUTO_ALIGN|TYPE|SIZE|DESC|LOOP_SET)|FLAG_(?:ALLOW_(?:FLY|(?:GROUP_)?SCRIPTS|LANDMARK|TERRAFORM|DAMAGE|CREATE_(?:GROUP_)?OBJECTS)|USE_(?:ACCESS_(?:GROUP|LIST)|BAN_LIST|LAND_PASS_LIST)|LOCAL_SOUND_ONLY|RESTRICT_PUSHOBJECT|ALLOW_(?:GROUP|ALL)_OBJECT_ENTRY)|COUNT_(?:TOTAL|OWNER|GROUP|OTHER|SELECTED|TEMP)|DETAILS_(?:NAME|DESC|OWNER|GROUP|AREA|ID|SEE_AVATARS))|LIST_STAT_(?:MAX|MIN|MEAN|MEDIAN|STD_DEV|SUM(?:_SQUARES)?|NUM_COUNT|GEOMETRIC_MEAN|RANGE)|PAY_(?:HIDE|DEFAULT)|REGION_FLAG_(?:ALLOW_DAMAGE|FIXED_SUN|BLOCK_TERRAFORM|SANDBOX|DISABLE_(?:COLLISIONS|PHYSICS)|BLOCK_FLY|ALLOW_DIRECT_TELEPORT|RESTRICT_PUSHOBJECT)|HTTP_(?:METHOD|MIMETYPE|BODY_(?:MAXLENGTH|TRUNCATED)|CUSTOM_HEADER|PRAGMA_NO_CACHE|VERBOSE_THROTTLE|VERIFY_CERT)|STRING_(?:TRIM(?:_(?:HEAD|TAIL))?)|CLICK_ACTION_(?:NONE|TOUCH|SIT|BUY|PAY|OPEN(?:_MEDIA)?|PLAY|ZOOM)|TOUCH_INVALID_FACE|PROFILE_(?:NONE|SCRIPT_MEMORY)|RC_(?:DATA_FLAGS|DETECT_PHANTOM|GET_(?:LINK_NUM|NORMAL|ROOT_KEY)|MAX_HITS|REJECT_(?:TYPES|AGENTS|(?:NON)?PHYSICAL|LAND))|RCERR_(?:CAST_TIME_EXCEEDED|SIM_PERF_LOW|UNKNOWN)|ESTATE_ACCESS_(?:ALLOWED_(?:AGENT|GROUP)_(?:ADD|REMOVE)|BANNED_AGENT_(?:ADD|REMOVE))|DENSITY|FRICTION|RESTITUTION|GRAVITY_MULTIPLIER|KFM_(?:COMMAND|CMD_(?:PLAY|STOP|PAUSE|SET_MODE)|MODE|FORWARD|LOOP|PING_PONG|REVERSE|DATA|ROTATION|TRANSLATION)|ERR_(?:GENERIC|PARCEL_PERMISSIONS|MALFORMED_PARAMS|RUNTIME_PERMISSIONS|THROTTLED)|CHARACTER_(?:CMD_(?:(?:SMOOTH_)?STOP|JUMP)|DESIRED_(?:TURN_)?SPEED|RADIUS|STAY_WITHIN_PARCEL|LENGTH|ORIENTATION|ACCOUNT_FOR_SKIPPED_FRAMES|AVOIDANCE_MODE|TYPE(?:_(?:[A-D]|NONE))?|MAX_(?:DECEL|TURN_RADIUS|(?:ACCEL|SPEED)))|PURSUIT_(?:OFFSET|FUZZ_FACTOR|GOAL_TOLERANCE|INTERCEPT)|REQUIRE_LINE_OF_SIGHT|FORCE_DIRECT_PATH|VERTICAL|HORIZONTAL|AVOID_(?:CHARACTERS|DYNAMIC_OBSTACLES|NONE)|PU_(?:EVADE_(?:HIDDEN|SPOTTED)|FAILURE_(?:DYNAMIC_PATHFINDING_DISABLED|INVALID_(?:GOAL|START)|NO_(?:NAVMESH|VALID_DESTINATION)|OTHER|TARGET_GONE|(?:PARCEL_)?UNREACHABLE)|(?:GOAL|SLOWDOWN_DISTANCE)_REACHED)|TRAVERSAL_TYPE(?:_(?:FAST|NONE|SLOW))?|CONTENT_TYPE_(?:ATOM|FORM|HTML|JSON|LLSD|RSS|TEXT|XHTML|XML)|GCNP_(?:RADIUS|STATIC)|(?:PATROL|WANDER)_PAUSE_AT_WAYPOINTS|OPT_(?:AVATAR|CHARACTER|EXCLUSION_VOLUME|LEGACY_LINKSET|MATERIAL_VOLUME|OTHER|STATIC_OBSTACLE|WALKABLE)|SIM_STAT_PCT_CHARS_STEPPED)\b'
+    lsl_constants_integer_boolean = r'\b(?:FALSE|TRUE)\b'
+    lsl_constants_rotation = r'\b(?:ZERO_ROTATION)\b'
+    lsl_constants_string = r'\b(?:EOF|JSON_(?:ARRAY|DELETE|FALSE|INVALID|NULL|NUMBER|OBJECT|STRING|TRUE)|NULL_KEY|TEXTURE_(?:BLANK|DEFAULT|MEDIA|PLYWOOD|TRANSPARENT)|URL_REQUEST_(?:GRANTED|DENIED))\b'
+    lsl_constants_vector = r'\b(?:TOUCH_INVALID_(?:TEXCOORD|VECTOR)|ZERO_VECTOR)\b'
+    lsl_invalid_broken = r'\b(?:LAND_(?:LARGE|MEDIUM|SMALL)_BRUSH)\b'
+    lsl_invalid_deprecated = r'\b(?:ATTACH_[LR]PEC|DATA_RATING|OBJECT_ATTACHMENT_(?:GEOMETRY_BYTES|SURFACE_AREA)|PRIM_(?:CAST_SHADOWS|MATERIAL_LIGHT|TYPE_LEGACY)|PSYS_SRC_(?:INNER|OUTER)ANGLE|VEHICLE_FLAG_NO_FLY_UP|ll(?:Cloud|Make(?:Explosion|Fountain|Smoke|Fire)|RemoteDataSetRegion|Sound(?:Preload)?|XorBase64Strings(?:Correct)?))\b'
+    lsl_invalid_illegal = r'\b(?:event)\b'
+    lsl_invalid_unimplemented = r'\b(?:CHARACTER_(?:MAX_ANGULAR_(?:ACCEL|SPEED)|TURN_SPEED_MULTIPLIER)|PERMISSION_(?:CHANGE_(?:JOINTS|PERMISSIONS)|RELEASE_OWNERSHIP|REMAP_CONTROLS)|PRIM_PHYSICS_MATERIAL|PSYS_SRC_OBJ_REL_MASK|ll(?:CollisionSprite|(?:Stop)?PointAt|(?:(?:Refresh|Set)Prim)URL|(?:Take|Release)Camera|RemoteLoadScript))\b'
+    lsl_reserved_godmode = r'\b(?:ll(?:GodLikeRezObject|Set(?:Inventory|Object)PermMask))\b'
+    lsl_reserved_log = r'\b(?:print)\b'
+    lsl_operators = r'\+\+|\-\-|<<|>>|&&?|\|\|?|\^|~|[!%<>=*+\-/]=?'
+
+    tokens = {
+        'root':
+        [
+            (r'//.*?\n',                          Comment.Single),
+            (r'/\*',                              Comment.Multiline, 'comment'),
+            (r'"',                                String.Double, 'string'),
+            (lsl_keywords,                        Keyword),
+            (lsl_types,                           Keyword.Type),
+            (lsl_states,                          Name.Class),
+            (lsl_events,                          Name.Builtin),
+            (lsl_functions_builtin,               Name.Function),
+            (lsl_constants_float,                 Keyword.Constant),
+            (lsl_constants_integer,               Keyword.Constant),
+            (lsl_constants_integer_boolean,       Keyword.Constant),
+            (lsl_constants_rotation,              Keyword.Constant),
+            (lsl_constants_string,                Keyword.Constant),
+            (lsl_constants_vector,                Keyword.Constant),
+            (lsl_invalid_broken,                  Error),
+            (lsl_invalid_deprecated,              Error),
+            (lsl_invalid_illegal,                 Error),
+            (lsl_invalid_unimplemented,           Error),
+            (lsl_reserved_godmode,                Keyword.Reserved),
+            (lsl_reserved_log,                    Keyword.Reserved),
+            (r'\b([a-zA-Z_]\w*)\b',     Name.Variable),
+            (r'(\d+\.\d*|\.\d+|\d+)[eE][+-]?\d*', Number.Float),
+            (r'(\d+\.\d*|\.\d+)',                 Number.Float),
+            (r'0[xX][0-9a-fA-F]+',                Number.Hex),
+            (r'\d+',                              Number.Integer),
+            (lsl_operators,                       Operator),
+            (r':=?',                              Error),
+            (r'[,;{}()\[\]]',                     Punctuation),
+            (r'\n+',                              Whitespace),
+            (r'\s+',                              Whitespace)
+        ],
+        'comment':
+        [
+            (r'[^*/]+',                           Comment.Multiline),
+            (r'/\*',                              Comment.Multiline, '#push'),
+            (r'\*/',                              Comment.Multiline, '#pop'),
+            (r'[*/]',                             Comment.Multiline)
+        ],
+        'string':
+        [
+            (r'\\([nt"\\])',                      String.Escape),
+            (r'"',                                String.Double, '#pop'),
+            (r'\\.',                              Error),
+            (r'[^"\\]+',                          String.Double),
+        ]
+    }
+
+
+class AppleScriptLexer(RegexLexer):
+    """
+    For AppleScript source code,
+    including `AppleScript Studio
+    `_.
+    Contributed by Andreas Amann .
+    """
+
+    name = 'AppleScript'
+    url = 'https://developer.apple.com/library/archive/documentation/AppleScript/Conceptual/AppleScriptLangGuide/introduction/ASLR_intro.html'
+    aliases = ['applescript']
+    filenames = ['*.applescript']
+    version_added = '1.0'
+
+    flags = re.MULTILINE | re.DOTALL
+
+    Identifiers = r'[a-zA-Z]\w*'
+
+    # XXX: use words() for all of these
+    Literals = ('AppleScript', 'current application', 'false', 'linefeed',
+                'missing value', 'pi', 'quote', 'result', 'return', 'space',
+                'tab', 'text item delimiters', 'true', 'version')
+    Classes = ('alias ', 'application ', 'boolean ', 'class ', 'constant ',
+               'date ', 'file ', 'integer ', 'list ', 'number ', 'POSIX file ',
+               'real ', 'record ', 'reference ', 'RGB color ', 'script ',
+               'text ', 'unit types', '(?:Unicode )?text', 'string')
+    BuiltIn = ('attachment', 'attribute run', 'character', 'day', 'month',
+               'paragraph', 'word', 'year')
+    HandlerParams = ('about', 'above', 'against', 'apart from', 'around',
+                     'aside from', 'at', 'below', 'beneath', 'beside',
+                     'between', 'for', 'given', 'instead of', 'on', 'onto',
+                     'out of', 'over', 'since')
+    Commands = ('ASCII (character|number)', 'activate', 'beep', 'choose URL',
+                'choose application', 'choose color', 'choose file( name)?',
+                'choose folder', 'choose from list',
+                'choose remote application', 'clipboard info',
+                'close( access)?', 'copy', 'count', 'current date', 'delay',
+                'delete', 'display (alert|dialog)', 'do shell script',
+                'duplicate', 'exists', 'get eof', 'get volume settings',
+                'info for', 'launch', 'list (disks|folder)', 'load script',
+                'log', 'make', 'mount volume', 'new', 'offset',
+                'open( (for access|location))?', 'path to', 'print', 'quit',
+                'random number', 'read', 'round', 'run( script)?',
+                'say', 'scripting components',
+                'set (eof|the clipboard to|volume)', 'store script',
+                'summarize', 'system attribute', 'system info',
+                'the clipboard', 'time to GMT', 'write', 'quoted form')
+    References = ('(in )?back of', '(in )?front of', '[0-9]+(st|nd|rd|th)',
+                  'first', 'second', 'third', 'fourth', 'fifth', 'sixth',
+                  'seventh', 'eighth', 'ninth', 'tenth', 'after', 'back',
+                  'before', 'behind', 'every', 'front', 'index', 'last',
+                  'middle', 'some', 'that', 'through', 'thru', 'where', 'whose')
+    Operators = ("and", "or", "is equal", "equals", "(is )?equal to", "is not",
+                 "isn't", "isn't equal( to)?", "is not equal( to)?",
+                 "doesn't equal", "does not equal", "(is )?greater than",
+                 "comes after", "is not less than or equal( to)?",
+                 "isn't less than or equal( to)?", "(is )?less than",
+                 "comes before", "is not greater than or equal( to)?",
+                 "isn't greater than or equal( to)?",
+                 "(is  )?greater than or equal( to)?", "is not less than",
+                 "isn't less than", "does not come before",
+                 "doesn't come before", "(is )?less than or equal( to)?",
+                 "is not greater than", "isn't greater than",
+                 "does not come after", "doesn't come after", "starts? with",
+                 "begins? with", "ends? with", "contains?", "does not contain",
+                 "doesn't contain", "is in", "is contained by", "is not in",
+                 "is not contained by", "isn't contained by", "div", "mod",
+                 "not", "(a  )?(ref( to)?|reference to)", "is", "does")
+    Control = ('considering', 'else', 'error', 'exit', 'from', 'if',
+               'ignoring', 'in', 'repeat', 'tell', 'then', 'times', 'to',
+               'try', 'until', 'using terms from', 'while', 'whith',
+               'with timeout( of)?', 'with transaction', 'by', 'continue',
+               'end', 'its?', 'me', 'my', 'return', 'of', 'as')
+    Declarations = ('global', 'local', 'prop(erty)?', 'set', 'get')
+    Reserved = ('but', 'put', 'returning', 'the')
+    StudioClasses = ('action cell', 'alert reply', 'application', 'box',
+                     'browser( cell)?', 'bundle', 'button( cell)?', 'cell',
+                     'clip view', 'color well', 'color-panel',
+                     'combo box( item)?', 'control',
+                     'data( (cell|column|item|row|source))?', 'default entry',
+                     'dialog reply', 'document', 'drag info', 'drawer',
+                     'event', 'font(-panel)?', 'formatter',
+                     'image( (cell|view))?', 'matrix', 'menu( item)?', 'item',
+                     'movie( view)?', 'open-panel', 'outline view', 'panel',
+                     'pasteboard', 'plugin', 'popup button',
+                     'progress indicator', 'responder', 'save-panel',
+                     'scroll view', 'secure text field( cell)?', 'slider',
+                     'sound', 'split view', 'stepper', 'tab view( item)?',
+                     'table( (column|header cell|header view|view))',
+                     'text( (field( cell)?|view))?', 'toolbar( item)?',
+                     'user-defaults', 'view', 'window')
+    StudioEvents = ('accept outline drop', 'accept table drop', 'action',
+                    'activated', 'alert ended', 'awake from nib', 'became key',
+                    'became main', 'begin editing', 'bounds changed',
+                    'cell value', 'cell value changed', 'change cell value',
+                    'change item value', 'changed', 'child of item',
+                    'choose menu item', 'clicked', 'clicked toolbar item',
+                    'closed', 'column clicked', 'column moved',
+                    'column resized', 'conclude drop', 'data representation',
+                    'deminiaturized', 'dialog ended', 'document nib name',
+                    'double clicked', 'drag( (entered|exited|updated))?',
+                    'drop', 'end editing', 'exposed', 'idle', 'item expandable',
+                    'item value', 'item value changed', 'items changed',
+                    'keyboard down', 'keyboard up', 'launched',
+                    'load data representation', 'miniaturized', 'mouse down',
+                    'mouse dragged', 'mouse entered', 'mouse exited',
+                    'mouse moved', 'mouse up', 'moved',
+                    'number of browser rows', 'number of items',
+                    'number of rows', 'open untitled', 'opened', 'panel ended',
+                    'parameters updated', 'plugin loaded', 'prepare drop',
+                    'prepare outline drag', 'prepare outline drop',
+                    'prepare table drag', 'prepare table drop',
+                    'read from file', 'resigned active', 'resigned key',
+                    'resigned main', 'resized( sub views)?',
+                    'right mouse down', 'right mouse dragged',
+                    'right mouse up', 'rows changed', 'scroll wheel',
+                    'selected tab view item', 'selection changed',
+                    'selection changing', 'should begin editing',
+                    'should close', 'should collapse item',
+                    'should end editing', 'should expand item',
+                    'should open( untitled)?',
+                    'should quit( after last window closed)?',
+                    'should select column', 'should select item',
+                    'should select row', 'should select tab view item',
+                    'should selection change', 'should zoom', 'shown',
+                    'update menu item', 'update parameters',
+                    'update toolbar item', 'was hidden', 'was miniaturized',
+                    'will become active', 'will close', 'will dismiss',
+                    'will display browser cell', 'will display cell',
+                    'will display item cell', 'will display outline cell',
+                    'will finish launching', 'will hide', 'will miniaturize',
+                    'will move', 'will open', 'will pop up', 'will quit',
+                    'will resign active', 'will resize( sub views)?',
+                    'will select tab view item', 'will show', 'will zoom',
+                    'write to file', 'zoomed')
+    StudioCommands = ('animate', 'append', 'call method', 'center',
+                      'close drawer', 'close panel', 'display',
+                      'display alert', 'display dialog', 'display panel', 'go',
+                      'hide', 'highlight', 'increment', 'item for',
+                      'load image', 'load movie', 'load nib', 'load panel',
+                      'load sound', 'localized string', 'lock focus', 'log',
+                      'open drawer', 'path for', 'pause', 'perform action',
+                      'play', 'register', 'resume', 'scroll', 'select( all)?',
+                      'show', 'size to fit', 'start', 'step back',
+                      'step forward', 'stop', 'synchronize', 'unlock focus',
+                      'update')
+    StudioProperties = ('accepts arrow key', 'action method', 'active',
+                        'alignment', 'allowed identifiers',
+                        'allows branch selection', 'allows column reordering',
+                        'allows column resizing', 'allows column selection',
+                        'allows customization',
+                        'allows editing text attributes',
+                        'allows empty selection', 'allows mixed state',
+                        'allows multiple selection', 'allows reordering',
+                        'allows undo', 'alpha( value)?', 'alternate image',
+                        'alternate increment value', 'alternate title',
+                        'animation delay', 'associated file name',
+                        'associated object', 'auto completes', 'auto display',
+                        'auto enables items', 'auto repeat',
+                        'auto resizes( outline column)?',
+                        'auto save expanded items', 'auto save name',
+                        'auto save table columns', 'auto saves configuration',
+                        'auto scroll', 'auto sizes all columns to fit',
+                        'auto sizes cells', 'background color', 'bezel state',
+                        'bezel style', 'bezeled', 'border rect', 'border type',
+                        'bordered', 'bounds( rotation)?', 'box type',
+                        'button returned', 'button type',
+                        'can choose directories', 'can choose files',
+                        'can draw', 'can hide',
+                        'cell( (background color|size|type))?', 'characters',
+                        'class', 'click count', 'clicked( data)? column',
+                        'clicked data item', 'clicked( data)? row',
+                        'closeable', 'collating', 'color( (mode|panel))',
+                        'command key down', 'configuration',
+                        'content(s| (size|view( margins)?))?', 'context',
+                        'continuous', 'control key down', 'control size',
+                        'control tint', 'control view',
+                        'controller visible', 'coordinate system',
+                        'copies( on scroll)?', 'corner view', 'current cell',
+                        'current column', 'current( field)?  editor',
+                        'current( menu)? item', 'current row',
+                        'current tab view item', 'data source',
+                        'default identifiers', 'delta (x|y|z)',
+                        'destination window', 'directory', 'display mode',
+                        'displayed cell', 'document( (edited|rect|view))?',
+                        'double value', 'dragged column', 'dragged distance',
+                        'dragged items', 'draws( cell)? background',
+                        'draws grid', 'dynamically scrolls', 'echos bullets',
+                        'edge', 'editable', 'edited( data)? column',
+                        'edited data item', 'edited( data)? row', 'enabled',
+                        'enclosing scroll view', 'ending page',
+                        'error handling', 'event number', 'event type',
+                        'excluded from windows menu', 'executable path',
+                        'expanded', 'fax number', 'field editor', 'file kind',
+                        'file name', 'file type', 'first responder',
+                        'first visible column', 'flipped', 'floating',
+                        'font( panel)?', 'formatter', 'frameworks path',
+                        'frontmost', 'gave up', 'grid color', 'has data items',
+                        'has horizontal ruler', 'has horizontal scroller',
+                        'has parent data item', 'has resize indicator',
+                        'has shadow', 'has sub menu', 'has vertical ruler',
+                        'has vertical scroller', 'header cell', 'header view',
+                        'hidden', 'hides when deactivated', 'highlights by',
+                        'horizontal line scroll', 'horizontal page scroll',
+                        'horizontal ruler view', 'horizontally resizable',
+                        'icon image', 'id', 'identifier',
+                        'ignores multiple clicks',
+                        'image( (alignment|dims when disabled|frame style|scaling))?',
+                        'imports graphics', 'increment value',
+                        'indentation per level', 'indeterminate', 'index',
+                        'integer value', 'intercell spacing', 'item height',
+                        'key( (code|equivalent( modifier)?|window))?',
+                        'knob thickness', 'label', 'last( visible)? column',
+                        'leading offset', 'leaf', 'level', 'line scroll',
+                        'loaded', 'localized sort', 'location', 'loop mode',
+                        'main( (bunde|menu|window))?', 'marker follows cell',
+                        'matrix mode', 'maximum( content)? size',
+                        'maximum visible columns',
+                        'menu( form representation)?', 'miniaturizable',
+                        'miniaturized', 'minimized image', 'minimized title',
+                        'minimum column width', 'minimum( content)? size',
+                        'modal', 'modified', 'mouse down state',
+                        'movie( (controller|file|rect))?', 'muted', 'name',
+                        'needs display', 'next state', 'next text',
+                        'number of tick marks', 'only tick mark values',
+                        'opaque', 'open panel', 'option key down',
+                        'outline table column', 'page scroll', 'pages across',
+                        'pages down', 'palette label', 'pane splitter',
+                        'parent data item', 'parent window', 'pasteboard',
+                        'path( (names|separator))?', 'playing',
+                        'plays every frame', 'plays selection only', 'position',
+                        'preferred edge', 'preferred type', 'pressure',
+                        'previous text', 'prompt', 'properties',
+                        'prototype cell', 'pulls down', 'rate',
+                        'released when closed', 'repeated',
+                        'requested print time', 'required file type',
+                        'resizable', 'resized column', 'resource path',
+                        'returns records', 'reuses columns', 'rich text',
+                        'roll over', 'row height', 'rulers visible',
+                        'save panel', 'scripts path', 'scrollable',
+                        'selectable( identifiers)?', 'selected cell',
+                        'selected( data)? columns?', 'selected data items?',
+                        'selected( data)? rows?', 'selected item identifier',
+                        'selection by rect', 'send action on arrow key',
+                        'sends action when done editing', 'separates columns',
+                        'separator item', 'sequence number', 'services menu',
+                        'shared frameworks path', 'shared support path',
+                        'sheet', 'shift key down', 'shows alpha',
+                        'shows state by', 'size( mode)?',
+                        'smart insert delete enabled', 'sort case sensitivity',
+                        'sort column', 'sort order', 'sort type',
+                        'sorted( data rows)?', 'sound', 'source( mask)?',
+                        'spell checking enabled', 'starting page', 'state',
+                        'string value', 'sub menu', 'super menu', 'super view',
+                        'tab key traverses cells', 'tab state', 'tab type',
+                        'tab view', 'table view', 'tag', 'target( printer)?',
+                        'text color', 'text container insert',
+                        'text container origin', 'text returned',
+                        'tick mark position', 'time stamp',
+                        'title(d| (cell|font|height|position|rect))?',
+                        'tool tip', 'toolbar', 'trailing offset', 'transparent',
+                        'treat packages as directories', 'truncated labels',
+                        'types', 'unmodified characters', 'update views',
+                        'use sort indicator', 'user defaults',
+                        'uses data source', 'uses ruler',
+                        'uses threaded animation',
+                        'uses title from previous column', 'value wraps',
+                        'version',
+                        'vertical( (line scroll|page scroll|ruler view))?',
+                        'vertically resizable', 'view',
+                        'visible( document rect)?', 'volume', 'width', 'window',
+                        'windows menu', 'wraps', 'zoomable', 'zoomed')
+
+    tokens = {
+        'root': [
+            (r'\s+', Text),
+            (r'¬\n', String.Escape),
+            (r"'s\s+", Text),  # This is a possessive, consider moving
+            (r'(--|#).*?$', Comment),
+            (r'\(\*', Comment.Multiline, 'comment'),
+            (r'[(){}!,.:]', Punctuation),
+            (r'(«)([^»]+)(»)',
+             bygroups(Text, Name.Builtin, Text)),
+            (r'\b((?:considering|ignoring)\s*)'
+             r'(application responses|case|diacriticals|hyphens|'
+             r'numeric strings|punctuation|white space)',
+             bygroups(Keyword, Name.Builtin)),
+            (r'(-|\*|\+|&|≠|>=?|<=?|=|≥|≤|/|÷|\^)', Operator),
+            (r"\b({})\b".format('|'.join(Operators)), Operator.Word),
+            (r'^(\s*(?:on|end)\s+)'
+             r'({})'.format('|'.join(StudioEvents[::-1])),
+             bygroups(Keyword, Name.Function)),
+            (r'^(\s*)(in|on|script|to)(\s+)', bygroups(Text, Keyword, Text)),
+            (r'\b(as )({})\b'.format('|'.join(Classes)),
+             bygroups(Keyword, Name.Class)),
+            (r'\b({})\b'.format('|'.join(Literals)), Name.Constant),
+            (r'\b({})\b'.format('|'.join(Commands)), Name.Builtin),
+            (r'\b({})\b'.format('|'.join(Control)), Keyword),
+            (r'\b({})\b'.format('|'.join(Declarations)), Keyword),
+            (r'\b({})\b'.format('|'.join(Reserved)), Name.Builtin),
+            (r'\b({})s?\b'.format('|'.join(BuiltIn)), Name.Builtin),
+            (r'\b({})\b'.format('|'.join(HandlerParams)), Name.Builtin),
+            (r'\b({})\b'.format('|'.join(StudioProperties)), Name.Attribute),
+            (r'\b({})s?\b'.format('|'.join(StudioClasses)), Name.Builtin),
+            (r'\b({})\b'.format('|'.join(StudioCommands)), Name.Builtin),
+            (r'\b({})\b'.format('|'.join(References)), Name.Builtin),
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String.Double),
+            (rf'\b({Identifiers})\b', Name.Variable),
+            (r'[-+]?(\d+\.\d*|\d*\.\d+)(E[-+][0-9]+)?', Number.Float),
+            (r'[-+]?\d+', Number.Integer),
+        ],
+        'comment': [
+            (r'\(\*', Comment.Multiline, '#push'),
+            (r'\*\)', Comment.Multiline, '#pop'),
+            ('[^*(]+', Comment.Multiline),
+            ('[*(]', Comment.Multiline),
+        ],
+    }
+
+
+class RexxLexer(RegexLexer):
+    """
+    Rexx is a scripting language available for
+    a wide range of different platforms with its roots found on mainframe
+    systems. It is popular for I/O- and data based tasks and can act as glue
+    language to bind different applications together.
+    """
+    name = 'Rexx'
+    url = 'http://www.rexxinfo.org/'
+    aliases = ['rexx', 'arexx']
+    filenames = ['*.rexx', '*.rex', '*.rx', '*.arexx']
+    mimetypes = ['text/x-rexx']
+    version_added = '2.0'
+    flags = re.IGNORECASE
+
+    tokens = {
+        'root': [
+            (r'\s+', Whitespace),
+            (r'/\*', Comment.Multiline, 'comment'),
+            (r'"', String, 'string_double'),
+            (r"'", String, 'string_single'),
+            (r'[0-9]+(\.[0-9]+)?(e[+-]?[0-9])?', Number),
+            (r'([a-z_]\w*)(\s*)(:)(\s*)(procedure)\b',
+             bygroups(Name.Function, Whitespace, Operator, Whitespace,
+                      Keyword.Declaration)),
+            (r'([a-z_]\w*)(\s*)(:)',
+             bygroups(Name.Label, Whitespace, Operator)),
+            include('function'),
+            include('keyword'),
+            include('operator'),
+            (r'[a-z_]\w*', Text),
+        ],
+        'function': [
+            (words((
+                'abbrev', 'abs', 'address', 'arg', 'b2x', 'bitand', 'bitor', 'bitxor',
+                'c2d', 'c2x', 'center', 'charin', 'charout', 'chars', 'compare',
+                'condition', 'copies', 'd2c', 'd2x', 'datatype', 'date', 'delstr',
+                'delword', 'digits', 'errortext', 'form', 'format', 'fuzz', 'insert',
+                'lastpos', 'left', 'length', 'linein', 'lineout', 'lines', 'max',
+                'min', 'overlay', 'pos', 'queued', 'random', 'reverse', 'right', 'sign',
+                'sourceline', 'space', 'stream', 'strip', 'substr', 'subword', 'symbol',
+                'time', 'trace', 'translate', 'trunc', 'value', 'verify', 'word',
+                'wordindex', 'wordlength', 'wordpos', 'words', 'x2b', 'x2c', 'x2d',
+                'xrange'), suffix=r'(\s*)(\()'),
+             bygroups(Name.Builtin, Whitespace, Operator)),
+        ],
+        'keyword': [
+            (r'(address|arg|by|call|do|drop|else|end|exit|for|forever|if|'
+             r'interpret|iterate|leave|nop|numeric|off|on|options|parse|'
+             r'pull|push|queue|return|say|select|signal|to|then|trace|until|'
+             r'while)\b', Keyword.Reserved),
+        ],
+        'operator': [
+            (r'(-|//|/|\(|\)|\*\*|\*|\\<<|\\<|\\==|\\=|\\>>|\\>|\\|\|\||\||'
+             r'&&|&|%|\+|<<=|<<|<=|<>|<|==|=|><|>=|>>=|>>|>|¬<<|¬<|¬==|¬=|'
+             r'¬>>|¬>|¬|\.|,)', Operator),
+        ],
+        'string_double': [
+            (r'[^"\n]+', String),
+            (r'""', String),
+            (r'"', String, '#pop'),
+            (r'\n', Text, '#pop'),  # Stray linefeed also terminates strings.
+        ],
+        'string_single': [
+            (r'[^\'\n]+', String),
+            (r'\'\'', String),
+            (r'\'', String, '#pop'),
+            (r'\n', Text, '#pop'),  # Stray linefeed also terminates strings.
+        ],
+        'comment': [
+            (r'[^*]+', Comment.Multiline),
+            (r'\*/', Comment.Multiline, '#pop'),
+            (r'\*', Comment.Multiline),
+        ]
+    }
+
+    def _c(s):
+        return re.compile(s, re.MULTILINE)
+    _ADDRESS_COMMAND_PATTERN = _c(r'^\s*address\s+command\b')
+    _ADDRESS_PATTERN = _c(r'^\s*address\s+')
+    _DO_WHILE_PATTERN = _c(r'^\s*do\s+while\b')
+    _IF_THEN_DO_PATTERN = _c(r'^\s*if\b.+\bthen\s+do\s*$')
+    _PROCEDURE_PATTERN = _c(r'^\s*([a-z_]\w*)(\s*)(:)(\s*)(procedure)\b')
+    _ELSE_DO_PATTERN = _c(r'\belse\s+do\s*$')
+    _PARSE_ARG_PATTERN = _c(r'^\s*parse\s+(upper\s+)?(arg|value)\b')
+    PATTERNS_AND_WEIGHTS = (
+        (_ADDRESS_COMMAND_PATTERN, 0.2),
+        (_ADDRESS_PATTERN, 0.05),
+        (_DO_WHILE_PATTERN, 0.1),
+        (_ELSE_DO_PATTERN, 0.1),
+        (_IF_THEN_DO_PATTERN, 0.1),
+        (_PROCEDURE_PATTERN, 0.5),
+        (_PARSE_ARG_PATTERN, 0.2),
+    )
+
+    def analyse_text(text):
+        """
+        Check for initial comment and patterns that distinguish Rexx from other
+        C-like languages.
+        """
+        if re.search(r'/\*\**\s*rexx', text, re.IGNORECASE):
+            # Header matches MVS Rexx requirements, this is certainly a Rexx
+            # script.
+            return 1.0
+        elif text.startswith('/*'):
+            # Header matches general Rexx requirements; the source code might
+            # still be any language using C comments such as C++, C# or Java.
+            lowerText = text.lower()
+            result = sum(weight
+                         for (pattern, weight) in RexxLexer.PATTERNS_AND_WEIGHTS
+                         if pattern.search(lowerText)) + 0.01
+            return min(result, 1.0)
+
+
+class MOOCodeLexer(RegexLexer):
+    """
+    For MOOCode (the MOO scripting language).
+    """
+    name = 'MOOCode'
+    url = 'http://www.moo.mud.org/'
+    filenames = ['*.moo']
+    aliases = ['moocode', 'moo']
+    mimetypes = ['text/x-moocode']
+    version_added = '0.9'
+
+    tokens = {
+        'root': [
+            # Numbers
+            (r'(0|[1-9][0-9_]*)', Number.Integer),
+            # Strings
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String),
+            # exceptions
+            (r'(E_PERM|E_DIV)', Name.Exception),
+            # db-refs
+            (r'((#[-0-9]+)|(\$\w+))', Name.Entity),
+            # Keywords
+            (r'\b(if|else|elseif|endif|for|endfor|fork|endfork|while'
+             r'|endwhile|break|continue|return|try'
+             r'|except|endtry|finally|in)\b', Keyword),
+            # builtins
+            (r'(random|length)', Name.Builtin),
+            # special variables
+            (r'(player|caller|this|args)', Name.Variable.Instance),
+            # skip whitespace
+            (r'\s+', Text),
+            (r'\n', Text),
+            # other operators
+            (r'([!;=,{}&|:.\[\]@()<>?]+)', Operator),
+            # function call
+            (r'(\w+)(\()', bygroups(Name.Function, Operator)),
+            # variables
+            (r'(\w+)', Text),
+        ]
+    }
+
+
+class HybrisLexer(RegexLexer):
+    """
+    For Hybris source code.
+    """
+
+    name = 'Hybris'
+    aliases = ['hybris']
+    filenames = ['*.hyb']
+    mimetypes = ['text/x-hybris', 'application/x-hybris']
+    url = 'https://github.com/evilsocket/hybris'
+    version_added = '1.4'
+
+    flags = re.MULTILINE | re.DOTALL
+
+    tokens = {
+        'root': [
+            # method names
+            (r'^(\s*(?:function|method|operator\s+)+?)'
+             r'([a-zA-Z_]\w*)'
+             r'(\s*)(\()', bygroups(Keyword, Name.Function, Text, Operator)),
+            (r'[^\S\n]+', Text),
+            (r'//.*?\n', Comment.Single),
+            (r'/\*.*?\*/', Comment.Multiline),
+            (r'@[a-zA-Z_][\w.]*', Name.Decorator),
+            (r'(break|case|catch|next|default|do|else|finally|for|foreach|of|'
+             r'unless|if|new|return|switch|me|throw|try|while)\b', Keyword),
+            (r'(extends|private|protected|public|static|throws|function|method|'
+             r'operator)\b', Keyword.Declaration),
+            (r'(true|false|null|__FILE__|__LINE__|__VERSION__|__LIB_PATH__|'
+             r'__INC_PATH__)\b', Keyword.Constant),
+            (r'(class|struct)(\s+)',
+             bygroups(Keyword.Declaration, Text), 'class'),
+            (r'(import|include)(\s+)',
+             bygroups(Keyword.Namespace, Text), 'import'),
+            (words((
+                'gc_collect', 'gc_mm_items', 'gc_mm_usage', 'gc_collect_threshold',
+                'urlencode', 'urldecode', 'base64encode', 'base64decode', 'sha1', 'crc32',
+                'sha2', 'md5', 'md5_file', 'acos', 'asin', 'atan', 'atan2', 'ceil', 'cos',
+                'cosh', 'exp', 'fabs', 'floor', 'fmod', 'log', 'log10', 'pow', 'sin',
+                'sinh', 'sqrt', 'tan', 'tanh', 'isint', 'isfloat', 'ischar', 'isstring',
+                'isarray', 'ismap', 'isalias', 'typeof', 'sizeof', 'toint', 'tostring',
+                'fromxml', 'toxml', 'binary', 'pack', 'load', 'eval', 'var_names',
+                'var_values', 'user_functions', 'dyn_functions', 'methods', 'call',
+                'call_method', 'mknod', 'mkfifo', 'mount', 'umount2', 'umount', 'ticks',
+                'usleep', 'sleep', 'time', 'strtime', 'strdate', 'dllopen', 'dlllink',
+                'dllcall', 'dllcall_argv', 'dllclose', 'env', 'exec', 'fork', 'getpid',
+                'wait', 'popen', 'pclose', 'exit', 'kill', 'pthread_create',
+                'pthread_create_argv', 'pthread_exit', 'pthread_join', 'pthread_kill',
+                'smtp_send', 'http_get', 'http_post', 'http_download', 'socket', 'bind',
+                'listen', 'accept', 'getsockname', 'getpeername', 'settimeout', 'connect',
+                'server', 'recv', 'send', 'close', 'print', 'println', 'printf', 'input',
+                'readline', 'serial_open', 'serial_fcntl', 'serial_get_attr',
+                'serial_get_ispeed', 'serial_get_ospeed', 'serial_set_attr',
+                'serial_set_ispeed', 'serial_set_ospeed', 'serial_write', 'serial_read',
+                'serial_close', 'xml_load', 'xml_parse', 'fopen', 'fseek', 'ftell',
+                'fsize', 'fread', 'fwrite', 'fgets', 'fclose', 'file', 'readdir',
+                'pcre_replace', 'size', 'pop', 'unmap', 'has', 'keys', 'values',
+                'length', 'find', 'substr', 'replace', 'split', 'trim', 'remove',
+                'contains', 'join'), suffix=r'\b'),
+             Name.Builtin),
+            (words((
+                'MethodReference', 'Runner', 'Dll', 'Thread', 'Pipe', 'Process',
+                'Runnable', 'CGI', 'ClientSocket', 'Socket', 'ServerSocket',
+                'File', 'Console', 'Directory', 'Exception'), suffix=r'\b'),
+             Keyword.Type),
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String),
+            (r"'\\.'|'[^\\]'|'\\u[0-9a-f]{4}'", String.Char),
+            (r'(\.)([a-zA-Z_]\w*)',
+             bygroups(Operator, Name.Attribute)),
+            (r'[a-zA-Z_]\w*:', Name.Label),
+            (r'[a-zA-Z_$]\w*', Name),
+            (r'[~^*!%&\[\](){}<>|+=:;,./?\-@]+', Operator),
+            (r'[0-9][0-9]*\.[0-9]+([eE][0-9]+)?[fd]?', Number.Float),
+            (r'0x[0-9a-f]+', Number.Hex),
+            (r'[0-9]+L?', Number.Integer),
+            (r'\n', Text),
+        ],
+        'class': [
+            (r'[a-zA-Z_]\w*', Name.Class, '#pop')
+        ],
+        'import': [
+            (r'[\w.]+\*?', Name.Namespace, '#pop')
+        ],
+    }
+
+    def analyse_text(text):
+        """public method and private method don't seem to be quite common
+        elsewhere."""
+        result = 0
+        if re.search(r'\b(?:public|private)\s+method\b', text):
+            result += 0.01
+        return result
+
+
+
+class EasytrieveLexer(RegexLexer):
+    """
+    Easytrieve Plus is a programming language for extracting, filtering and
+    converting sequential data. Furthermore it can layout data for reports.
+    It is mainly used on mainframe platforms and can access several of the
+    mainframe's native file formats. It is somewhat comparable to awk.
+    """
+    name = 'Easytrieve'
+    aliases = ['easytrieve']
+    filenames = ['*.ezt', '*.mac']
+    mimetypes = ['text/x-easytrieve']
+    url = 'https://www.broadcom.com/products/mainframe/application-development/easytrieve-report-generator'
+    version_added = '2.1'
+    flags = 0
+
+    # Note: We cannot use r'\b' at the start and end of keywords because
+    # Easytrieve Plus delimiter characters are:
+    #
+    #   * space ( )
+    #   * apostrophe (')
+    #   * period (.)
+    #   * comma (,)
+    #   * parenthesis ( and )
+    #   * colon (:)
+    #
+    # Additionally words end once a '*' appears, indicatins a comment.
+    _DELIMITERS = r' \'.,():\n'
+    _DELIMITERS_OR_COMENT = _DELIMITERS + '*'
+    _DELIMITER_PATTERN = '[' + _DELIMITERS + ']'
+    _DELIMITER_PATTERN_CAPTURE = '(' + _DELIMITER_PATTERN + ')'
+    _NON_DELIMITER_OR_COMMENT_PATTERN = '[^' + _DELIMITERS_OR_COMENT + ']'
+    _OPERATORS_PATTERN = '[.+\\-/=\\[\\](){}<>;,&%¬]'
+    _KEYWORDS = [
+        'AFTER-BREAK', 'AFTER-LINE', 'AFTER-SCREEN', 'AIM', 'AND', 'ATTR',
+        'BEFORE', 'BEFORE-BREAK', 'BEFORE-LINE', 'BEFORE-SCREEN', 'BUSHU',
+        'BY', 'CALL', 'CASE', 'CHECKPOINT', 'CHKP', 'CHKP-STATUS', 'CLEAR',
+        'CLOSE', 'COL', 'COLOR', 'COMMIT', 'CONTROL', 'COPY', 'CURSOR', 'D',
+        'DECLARE', 'DEFAULT', 'DEFINE', 'DELETE', 'DENWA', 'DISPLAY', 'DLI',
+        'DO', 'DUPLICATE', 'E', 'ELSE', 'ELSE-IF', 'END', 'END-CASE',
+        'END-DO', 'END-IF', 'END-PROC', 'ENDPAGE', 'ENDTABLE', 'ENTER', 'EOF',
+        'EQ', 'ERROR', 'EXIT', 'EXTERNAL', 'EZLIB', 'F1', 'F10', 'F11', 'F12',
+        'F13', 'F14', 'F15', 'F16', 'F17', 'F18', 'F19', 'F2', 'F20', 'F21',
+        'F22', 'F23', 'F24', 'F25', 'F26', 'F27', 'F28', 'F29', 'F3', 'F30',
+        'F31', 'F32', 'F33', 'F34', 'F35', 'F36', 'F4', 'F5', 'F6', 'F7',
+        'F8', 'F9', 'FETCH', 'FILE-STATUS', 'FILL', 'FINAL', 'FIRST',
+        'FIRST-DUP', 'FOR', 'GE', 'GET', 'GO', 'GOTO', 'GQ', 'GR', 'GT',
+        'HEADING', 'HEX', 'HIGH-VALUES', 'IDD', 'IDMS', 'IF', 'IN', 'INSERT',
+        'JUSTIFY', 'KANJI-DATE', 'KANJI-DATE-LONG', 'KANJI-TIME', 'KEY',
+        'KEY-PRESSED', 'KOKUGO', 'KUN', 'LAST-DUP', 'LE', 'LEVEL', 'LIKE',
+        'LINE', 'LINE-COUNT', 'LINE-NUMBER', 'LINK', 'LIST', 'LOW-VALUES',
+        'LQ', 'LS', 'LT', 'MACRO', 'MASK', 'MATCHED', 'MEND', 'MESSAGE',
+        'MOVE', 'MSTART', 'NE', 'NEWPAGE', 'NOMASK', 'NOPRINT', 'NOT',
+        'NOTE', 'NOVERIFY', 'NQ', 'NULL', 'OF', 'OR', 'OTHERWISE', 'PA1',
+        'PA2', 'PA3', 'PAGE-COUNT', 'PAGE-NUMBER', 'PARM-REGISTER',
+        'PATH-ID', 'PATTERN', 'PERFORM', 'POINT', 'POS', 'PRIMARY', 'PRINT',
+        'PROCEDURE', 'PROGRAM', 'PUT', 'READ', 'RECORD', 'RECORD-COUNT',
+        'RECORD-LENGTH', 'REFRESH', 'RELEASE', 'RENUM', 'REPEAT', 'REPORT',
+        'REPORT-INPUT', 'RESHOW', 'RESTART', 'RETRIEVE', 'RETURN-CODE',
+        'ROLLBACK', 'ROW', 'S', 'SCREEN', 'SEARCH', 'SECONDARY', 'SELECT',
+        'SEQUENCE', 'SIZE', 'SKIP', 'SOKAKU', 'SORT', 'SQL', 'STOP', 'SUM',
+        'SYSDATE', 'SYSDATE-LONG', 'SYSIN', 'SYSIPT', 'SYSLST', 'SYSPRINT',
+        'SYSSNAP', 'SYSTIME', 'TALLY', 'TERM-COLUMNS', 'TERM-NAME',
+        'TERM-ROWS', 'TERMINATION', 'TITLE', 'TO', 'TRANSFER', 'TRC',
+        'UNIQUE', 'UNTIL', 'UPDATE', 'UPPERCASE', 'USER', 'USERID', 'VALUE',
+        'VERIFY', 'W', 'WHEN', 'WHILE', 'WORK', 'WRITE', 'X', 'XDM', 'XRST'
+    ]
+
+    tokens = {
+        'root': [
+            (r'\*.*\n', Comment.Single),
+            (r'\n+', Whitespace),
+            # Macro argument
+            (r'&' + _NON_DELIMITER_OR_COMMENT_PATTERN + r'+\.', Name.Variable,
+             'after_macro_argument'),
+            # Macro call
+            (r'%' + _NON_DELIMITER_OR_COMMENT_PATTERN + r'+', Name.Variable),
+            (r'(FILE|MACRO|REPORT)(\s+)',
+             bygroups(Keyword.Declaration, Whitespace), 'after_declaration'),
+            (r'(JOB|PARM)' + r'(' + _DELIMITER_PATTERN + r')',
+             bygroups(Keyword.Declaration, Operator)),
+            (words(_KEYWORDS, suffix=_DELIMITER_PATTERN_CAPTURE),
+             bygroups(Keyword.Reserved, Operator)),
+            (_OPERATORS_PATTERN, Operator),
+            # Procedure declaration
+            (r'(' + _NON_DELIMITER_OR_COMMENT_PATTERN + r'+)(\s*)(\.?)(\s*)(PROC)(\s*\n)',
+             bygroups(Name.Function, Whitespace, Operator, Whitespace,
+                      Keyword.Declaration, Whitespace)),
+            (r'[0-9]+\.[0-9]*', Number.Float),
+            (r'[0-9]+', Number.Integer),
+            (r"'(''|[^'])*'", String),
+            (r'\s+', Whitespace),
+            # Everything else just belongs to a name
+            (_NON_DELIMITER_OR_COMMENT_PATTERN + r'+', Name),
+         ],
+        'after_declaration': [
+            (_NON_DELIMITER_OR_COMMENT_PATTERN + r'+', Name.Function),
+            default('#pop'),
+        ],
+        'after_macro_argument': [
+            (r'\*.*\n', Comment.Single, '#pop'),
+            (r'\s+', Whitespace, '#pop'),
+            (_OPERATORS_PATTERN, Operator, '#pop'),
+            (r"'(''|[^'])*'", String, '#pop'),
+            # Everything else just belongs to a name
+            (_NON_DELIMITER_OR_COMMENT_PATTERN + r'+', Name),
+        ],
+    }
+    _COMMENT_LINE_REGEX = re.compile(r'^\s*\*')
+    _MACRO_HEADER_REGEX = re.compile(r'^\s*MACRO')
+
+    def analyse_text(text):
+        """
+        Perform a structural analysis for basic Easytrieve constructs.
+        """
+        result = 0.0
+        lines = text.split('\n')
+        hasEndProc = False
+        hasHeaderComment = False
+        hasFile = False
+        hasJob = False
+        hasProc = False
+        hasParm = False
+        hasReport = False
+
+        def isCommentLine(line):
+            return EasytrieveLexer._COMMENT_LINE_REGEX.match(lines[0]) is not None
+
+        def isEmptyLine(line):
+            return not bool(line.strip())
+
+        # Remove possible empty lines and header comments.
+        while lines and (isEmptyLine(lines[0]) or isCommentLine(lines[0])):
+            if not isEmptyLine(lines[0]):
+                hasHeaderComment = True
+            del lines[0]
+
+        if EasytrieveLexer._MACRO_HEADER_REGEX.match(lines[0]):
+            # Looks like an Easytrieve macro.
+            result = 0.4
+            if hasHeaderComment:
+                result += 0.4
+        else:
+            # Scan the source for lines starting with indicators.
+            for line in lines:
+                words = line.split()
+                if (len(words) >= 2):
+                    firstWord = words[0]
+                    if not hasReport:
+                        if not hasJob:
+                            if not hasFile:
+                                if not hasParm:
+                                    if firstWord == 'PARM':
+                                        hasParm = True
+                                if firstWord == 'FILE':
+                                    hasFile = True
+                            if firstWord == 'JOB':
+                                hasJob = True
+                        elif firstWord == 'PROC':
+                            hasProc = True
+                        elif firstWord == 'END-PROC':
+                            hasEndProc = True
+                        elif firstWord == 'REPORT':
+                            hasReport = True
+
+            # Weight the findings.
+            if hasJob and (hasProc == hasEndProc):
+                if hasHeaderComment:
+                    result += 0.1
+                if hasParm:
+                    if hasProc:
+                        # Found PARM, JOB and PROC/END-PROC:
+                        # pretty sure this is Easytrieve.
+                        result += 0.8
+                    else:
+                        # Found PARAM and  JOB: probably this is Easytrieve
+                        result += 0.5
+                else:
+                    # Found JOB and possibly other keywords: might be Easytrieve
+                    result += 0.11
+                    if hasParm:
+                        # Note: PARAM is not a proper English word, so this is
+                        # regarded a much better indicator for Easytrieve than
+                        # the other words.
+                        result += 0.2
+                    if hasFile:
+                        result += 0.01
+                    if hasReport:
+                        result += 0.01
+        assert 0.0 <= result <= 1.0
+        return result
+
+
+class JclLexer(RegexLexer):
+    """
+    Job Control Language (JCL)
+    is a scripting language used on mainframe platforms to instruct the system
+    on how to run a batch job or start a subsystem. It is somewhat
+    comparable to MS DOS batch and Unix shell scripts.
+    """
+    name = 'JCL'
+    aliases = ['jcl']
+    filenames = ['*.jcl']
+    mimetypes = ['text/x-jcl']
+    url = 'https://en.wikipedia.org/wiki/Job_Control_Language'
+    version_added = '2.1'
+
+    flags = re.IGNORECASE
+
+    tokens = {
+        'root': [
+            (r'//\*.*\n', Comment.Single),
+            (r'//', Keyword.Pseudo, 'statement'),
+            (r'/\*', Keyword.Pseudo, 'jes2_statement'),
+            # TODO: JES3 statement
+            (r'.*\n', Other)  # Input text or inline code in any language.
+        ],
+        'statement': [
+            (r'\s*\n', Whitespace, '#pop'),
+            (r'([a-z]\w*)(\s+)(exec|job)(\s*)',
+             bygroups(Name.Label, Whitespace, Keyword.Reserved, Whitespace),
+             'option'),
+            (r'[a-z]\w*', Name.Variable, 'statement_command'),
+            (r'\s+', Whitespace, 'statement_command'),
+        ],
+        'statement_command': [
+            (r'\s+(command|cntl|dd|endctl|endif|else|include|jcllib|'
+             r'output|pend|proc|set|then|xmit)\s+', Keyword.Reserved, 'option'),
+            include('option')
+        ],
+        'jes2_statement': [
+            (r'\s*\n', Whitespace, '#pop'),
+            (r'\$', Keyword, 'option'),
+            (r'\b(jobparam|message|netacct|notify|output|priority|route|'
+             r'setup|signoff|xeq|xmit)\b', Keyword, 'option'),
+        ],
+        'option': [
+            # (r'\n', Text, 'root'),
+            (r'\*', Name.Builtin),
+            (r'[\[\](){}<>;,]', Punctuation),
+            (r'[-+*/=&%]', Operator),
+            (r'[a-z_]\w*', Name),
+            (r'\d+\.\d*', Number.Float),
+            (r'\.\d+', Number.Float),
+            (r'\d+', Number.Integer),
+            (r"'", String, 'option_string'),
+            (r'[ \t]+', Whitespace, 'option_comment'),
+            (r'\.', Punctuation),
+        ],
+        'option_string': [
+            (r"(\n)(//)", bygroups(Text, Keyword.Pseudo)),
+            (r"''", String),
+            (r"[^']", String),
+            (r"'", String, '#pop'),
+        ],
+        'option_comment': [
+            # (r'\n', Text, 'root'),
+            (r'.+', Comment.Single),
+        ]
+    }
+
+    _JOB_HEADER_PATTERN = re.compile(r'^//[a-z#$@][a-z0-9#$@]{0,7}\s+job(\s+.*)?$',
+                                     re.IGNORECASE)
+
+    def analyse_text(text):
+        """
+        Recognize JCL job by header.
+        """
+        result = 0.0
+        lines = text.split('\n')
+        if len(lines) > 0:
+            if JclLexer._JOB_HEADER_PATTERN.match(lines[0]):
+                result = 1.0
+        assert 0.0 <= result <= 1.0
+        return result
+
+
+class MiniScriptLexer(RegexLexer):
+    """
+    For MiniScript source code.
+    """
+
+    name = 'MiniScript'
+    url = 'https://miniscript.org'
+    aliases = ['miniscript', 'ms']
+    filenames = ['*.ms']
+    mimetypes = ['text/x-minicript', 'application/x-miniscript']
+    version_added = '2.6'
+
+    tokens = {
+        'root': [
+            (r'#!(.*?)$', Comment.Preproc),
+            default('base'),
+        ],
+        'base': [
+            ('//.*$', Comment.Single),
+            (r'(?i)(\d*\.\d+|\d+\.\d*)(e[+-]?\d+)?', Number),
+            (r'(?i)\d+e[+-]?\d+', Number),
+            (r'\d+', Number),
+            (r'\n', Text),
+            (r'[^\S\n]+', Text),
+            (r'"', String, 'string_double'),
+            (r'(==|!=|<=|>=|[=+\-*/%^<>.:])', Operator),
+            (r'[;,\[\]{}()]', Punctuation),
+            (words((
+                'break', 'continue', 'else', 'end', 'for', 'function', 'if',
+                'in', 'isa', 'then', 'repeat', 'return', 'while'), suffix=r'\b'),
+             Keyword),
+            (words((
+                'abs', 'acos', 'asin', 'atan', 'ceil', 'char', 'cos', 'floor',
+                'log', 'round', 'rnd', 'pi', 'sign', 'sin', 'sqrt', 'str', 'tan',
+                'hasIndex', 'indexOf', 'len', 'val', 'code', 'remove', 'lower',
+                'upper', 'replace', 'split', 'indexes', 'values', 'join', 'sum',
+                'sort', 'shuffle', 'push', 'pop', 'pull', 'range',
+                'print', 'input', 'time', 'wait', 'locals', 'globals', 'outer',
+                'yield'), suffix=r'\b'),
+             Name.Builtin),
+            (r'(true|false|null)\b', Keyword.Constant),
+            (r'(and|or|not|new)\b', Operator.Word),
+            (r'(self|super|__isa)\b', Name.Builtin.Pseudo),
+            (r'[a-zA-Z_]\w*', Name.Variable)
+        ],
+        'string_double': [
+            (r'[^"\n]+', String),
+            (r'""', String),
+            (r'"', String, '#pop'),
+            (r'\n', Text, '#pop'),  # Stray linefeed also terminates strings.
+        ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/sgf.py b/env/lib/python3.12/site-packages/pygments/lexers/sgf.py
new file mode 100644
index 0000000..f0e56cb
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/sgf.py
@@ -0,0 +1,59 @@
+"""
+    pygments.lexers.sgf
+    ~~~~~~~~~~~~~~~~~~~
+
+    Lexer for Smart Game Format (sgf) file format.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups
+from pygments.token import Name, Literal, String, Punctuation, Whitespace
+
+__all__ = ["SmartGameFormatLexer"]
+
+
+class SmartGameFormatLexer(RegexLexer):
+    """
+    Lexer for Smart Game Format (sgf) file format.
+
+    The format is used to store game records of board games for two players
+    (mainly Go game).
+    """
+    name = 'SmartGameFormat'
+    url = 'https://www.red-bean.com/sgf/'
+    aliases = ['sgf']
+    filenames = ['*.sgf']
+    version_added = '2.4'
+
+    tokens = {
+        'root': [
+            (r'[():;]+', Punctuation),
+            # tokens:
+            (r'(A[BW]|AE|AN|AP|AR|AS|[BW]L|BM|[BW]R|[BW]S|[BW]T|CA|CH|CP|CR|'
+             r'DD|DM|DO|DT|EL|EV|EX|FF|FG|G[BW]|GC|GM|GN|HA|HO|ID|IP|IT|IY|KM|'
+             r'KO|LB|LN|LT|L|MA|MN|M|N|OB|OM|ON|OP|OT|OV|P[BW]|PC|PL|PM|RE|RG|'
+             r'RO|RU|SO|SC|SE|SI|SL|SO|SQ|ST|SU|SZ|T[BW]|TC|TE|TM|TR|UC|US|VW|'
+             r'V|[BW]|C)',
+             Name.Builtin),
+            # number:
+            (r'(\[)([0-9.]+)(\])',
+             bygroups(Punctuation, Literal.Number, Punctuation)),
+            # date:
+            (r'(\[)([0-9]{4}-[0-9]{2}-[0-9]{2})(\])',
+             bygroups(Punctuation, Literal.Date, Punctuation)),
+            # point:
+            (r'(\[)([a-z]{2})(\])',
+             bygroups(Punctuation, String, Punctuation)),
+            # double points:
+            (r'(\[)([a-z]{2})(:)([a-z]{2})(\])',
+             bygroups(Punctuation, String, Punctuation, String, Punctuation)),
+
+            (r'(\[)([\w\s#()+,\-.:?]+)(\])',
+             bygroups(Punctuation, String, Punctuation)),
+            (r'(\[)(\s.*)(\])',
+             bygroups(Punctuation, Whitespace, Punctuation)),
+            (r'\s+', Whitespace)
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/shell.py b/env/lib/python3.12/site-packages/pygments/lexers/shell.py
new file mode 100644
index 0000000..744767a
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/shell.py
@@ -0,0 +1,902 @@
+"""
+    pygments.lexers.shell
+    ~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for various shells.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pygments.lexer import Lexer, RegexLexer, do_insertions, bygroups, \
+    include, default, this, using, words, line_re
+from pygments.token import Punctuation, Whitespace, \
+    Text, Comment, Operator, Keyword, Name, String, Number, Generic
+from pygments.util import shebang_matches
+
+__all__ = ['BashLexer', 'BashSessionLexer', 'TcshLexer', 'BatchLexer',
+           'SlurmBashLexer', 'MSDOSSessionLexer', 'PowerShellLexer',
+           'PowerShellSessionLexer', 'TcshSessionLexer', 'FishShellLexer',
+           'ExeclineLexer']
+
+
+class BashLexer(RegexLexer):
+    """
+    Lexer for (ba|k|z|)sh shell scripts.
+    """
+
+    name = 'Bash'
+    aliases = ['bash', 'sh', 'ksh', 'zsh', 'shell', 'openrc']
+    filenames = ['*.sh', '*.ksh', '*.bash', '*.ebuild', '*.eclass',
+                 '*.exheres-0', '*.exlib', '*.zsh',
+                 '.bashrc', 'bashrc', '.bash_*', 'bash_*', 'zshrc', '.zshrc',
+                 '.kshrc', 'kshrc',
+                 'PKGBUILD']
+    mimetypes = ['application/x-sh', 'application/x-shellscript', 'text/x-shellscript']
+    url = 'https://en.wikipedia.org/wiki/Unix_shell'
+    version_added = '0.6'
+
+    tokens = {
+        'root': [
+            include('basic'),
+            (r'`', String.Backtick, 'backticks'),
+            include('data'),
+            include('interp'),
+        ],
+        'interp': [
+            (r'\$\(\(', Keyword, 'math'),
+            (r'\$\(', Keyword, 'paren'),
+            (r'\$\{#?', String.Interpol, 'curly'),
+            (r'\$[a-zA-Z_]\w*', Name.Variable),  # user variable
+            (r'\$(?:\d+|[#$?!_*@-])', Name.Variable),      # builtin
+            (r'\$', Text),
+        ],
+        'basic': [
+            (r'\b(if|fi|else|while|in|do|done|for|then|return|function|case|'
+             r'select|break|continue|until|esac|elif)(\s*)\b',
+             bygroups(Keyword, Whitespace)),
+            (r'\b(alias|bg|bind|builtin|caller|cd|command|compgen|'
+             r'complete|declare|dirs|disown|echo|enable|eval|exec|exit|'
+             r'export|false|fc|fg|getopts|hash|help|history|jobs|kill|let|'
+             r'local|logout|popd|printf|pushd|pwd|read|readonly|set|shift|'
+             r'shopt|source|suspend|test|time|times|trap|true|type|typeset|'
+             r'ulimit|umask|unalias|unset|wait)(?=[\s)`])',
+             Name.Builtin),
+            (r'\A#!.+\n', Comment.Hashbang),
+            (r'#.*\n', Comment.Single),
+            (r'\\[\w\W]', String.Escape),
+            (r'(\b\w+)(\s*)(\+?=)', bygroups(Name.Variable, Whitespace, Operator)),
+            (r'[\[\]{}()=]', Operator),
+            (r'<<<', Operator),  # here-string
+            (r'<<-?\s*(\'?)\\?(\w+)[\w\W]+?\2', String),
+            (r'&&|\|\|', Operator),
+        ],
+        'data': [
+            (r'(?s)\$?"(\\.|[^"\\$])*"', String.Double),
+            (r'"', String.Double, 'string'),
+            (r"(?s)\$'(\\\\|\\[0-7]+|\\.|[^'\\])*'", String.Single),
+            (r"(?s)'.*?'", String.Single),
+            (r';', Punctuation),
+            (r'&', Punctuation),
+            (r'\|', Punctuation),
+            (r'\s+', Whitespace),
+            (r'\d+\b', Number),
+            (r'[^=\s\[\]{}()$"\'`\\<&|;]+', Text),
+            (r'<', Text),
+        ],
+        'string': [
+            (r'"', String.Double, '#pop'),
+            (r'(?s)(\\\\|\\[0-7]+|\\.|[^"\\$])+', String.Double),
+            include('interp'),
+        ],
+        'curly': [
+            (r'\}', String.Interpol, '#pop'),
+            (r':-', Keyword),
+            (r'\w+', Name.Variable),
+            (r'[^}:"\'`$\\]+', Punctuation),
+            (r':', Punctuation),
+            include('root'),
+        ],
+        'paren': [
+            (r'\)', Keyword, '#pop'),
+            include('root'),
+        ],
+        'math': [
+            (r'\)\)', Keyword, '#pop'),
+            (r'\*\*|\|\||<<|>>|[-+*/%^|&<>]', Operator),
+            (r'\d+#[\da-zA-Z]+', Number),
+            (r'\d+#(?! )', Number),
+            (r'0[xX][\da-fA-F]+', Number),
+            (r'\d+', Number),
+            (r'[a-zA-Z_]\w*', Name.Variable),  # user variable
+            include('root'),
+        ],
+        'backticks': [
+            (r'`', String.Backtick, '#pop'),
+            include('root'),
+        ],
+    }
+
+    def analyse_text(text):
+        if shebang_matches(text, r'(ba|z|)sh'):
+            return 1
+        if text.startswith('$ '):
+            return 0.2
+
+
+class SlurmBashLexer(BashLexer):
+    """
+    Lexer for (ba|k|z|)sh Slurm scripts.
+    """
+
+    name = 'Slurm'
+    aliases = ['slurm', 'sbatch']
+    filenames = ['*.sl']
+    mimetypes = []
+    version_added = '2.4'
+    EXTRA_KEYWORDS = {'srun'}
+
+    def get_tokens_unprocessed(self, text):
+        for index, token, value in BashLexer.get_tokens_unprocessed(self, text):
+            if token is Text and value in self.EXTRA_KEYWORDS:
+                yield index, Name.Builtin, value
+            elif token is Comment.Single and 'SBATCH' in value:
+                yield index, Keyword.Pseudo, value
+            else:
+                yield index, token, value
+
+
+class ShellSessionBaseLexer(Lexer):
+    """
+    Base lexer for shell sessions.
+
+    .. versionadded:: 2.1
+    """
+
+    _bare_continuation = False
+    _venv = re.compile(r'^(\([^)]*\))(\s*)')
+
+    def get_tokens_unprocessed(self, text):
+        innerlexer = self._innerLexerCls(**self.options)
+
+        pos = 0
+        curcode = ''
+        insertions = []
+        backslash_continuation = False
+
+        for match in line_re.finditer(text):
+            line = match.group()
+
+            venv_match = self._venv.match(line)
+            if venv_match:
+                venv = venv_match.group(1)
+                venv_whitespace = venv_match.group(2)
+                insertions.append((len(curcode),
+                                   [(0, Generic.Prompt.VirtualEnv, venv)]))
+                if venv_whitespace:
+                    insertions.append((len(curcode),
+                                       [(0, Text, venv_whitespace)]))
+                line = line[venv_match.end():]
+
+            m = self._ps1rgx.match(line)
+            if m:
+                # To support output lexers (say diff output), the output
+                # needs to be broken by prompts whenever the output lexer
+                # changes.
+                if not insertions:
+                    pos = match.start()
+
+                insertions.append((len(curcode),
+                                   [(0, Generic.Prompt, m.group(1))]))
+                curcode += m.group(2)
+                backslash_continuation = curcode.endswith('\\\n')
+            elif backslash_continuation:
+                if line.startswith(self._ps2):
+                    insertions.append((len(curcode),
+                                       [(0, Generic.Prompt,
+                                         line[:len(self._ps2)])]))
+                    curcode += line[len(self._ps2):]
+                else:
+                    curcode += line
+                backslash_continuation = curcode.endswith('\\\n')
+            elif self._bare_continuation and line.startswith(self._ps2):
+                insertions.append((len(curcode),
+                                   [(0, Generic.Prompt,
+                                     line[:len(self._ps2)])]))
+                curcode += line[len(self._ps2):]
+            else:
+                if insertions:
+                    toks = innerlexer.get_tokens_unprocessed(curcode)
+                    for i, t, v in do_insertions(insertions, toks):
+                        yield pos+i, t, v
+                yield match.start(), Generic.Output, line
+                insertions = []
+                curcode = ''
+        if insertions:
+            for i, t, v in do_insertions(insertions,
+                                         innerlexer.get_tokens_unprocessed(curcode)):
+                yield pos+i, t, v
+
+
+class BashSessionLexer(ShellSessionBaseLexer):
+    """
+    Lexer for Bash shell sessions, i.e. command lines, including a
+    prompt, interspersed with output.
+    """
+
+    name = 'Bash Session'
+    aliases = ['console', 'shell-session']
+    filenames = ['*.sh-session', '*.shell-session']
+    mimetypes = ['application/x-shell-session', 'application/x-sh-session']
+    url = 'https://en.wikipedia.org/wiki/Unix_shell'
+    version_added = '1.1'
+    _example = "console/example.sh-session"
+
+    _innerLexerCls = BashLexer
+    _ps1rgx = re.compile(
+        r'^((?:(?:\[.*?\])|(?:\(\S+\))?(?:| |sh\S*?|\w+\S+[@:]\S+(?:\s+\S+)' \
+        r'?|\[\S+[@:][^\n]+\].+))\s*[$#%]\s*)(.*\n?)')
+    _ps2 = '> '
+
+
+class BatchLexer(RegexLexer):
+    """
+    Lexer for the DOS/Windows Batch file format.
+    """
+    name = 'Batchfile'
+    aliases = ['batch', 'bat', 'dosbatch', 'winbatch']
+    filenames = ['*.bat', '*.cmd']
+    mimetypes = ['application/x-dos-batch']
+    url = 'https://en.wikipedia.org/wiki/Batch_file'
+    version_added = '0.7'
+
+    flags = re.MULTILINE | re.IGNORECASE
+
+    _nl = r'\n\x1a'
+    _punct = r'&<>|'
+    _ws = r'\t\v\f\r ,;=\xa0'
+    _nlws = r'\s\x1a\xa0,;='
+    _space = rf'(?:(?:(?:\^[{_nl}])?[{_ws}])+)'
+    _keyword_terminator = (rf'(?=(?:\^[{_nl}]?)?[{_ws}+./:[\\\]]|[{_nl}{_punct}(])')
+    _token_terminator = rf'(?=\^?[{_ws}]|[{_punct}{_nl}])'
+    _start_label = rf'((?:(?<=^[^:])|^[^:]?)[{_ws}]*)(:)'
+    _label = rf'(?:(?:[^{_nlws}{_punct}+:^]|\^[{_nl}]?[\w\W])*)'
+    _label_compound = rf'(?:(?:[^{_nlws}{_punct}+:^)]|\^[{_nl}]?[^)])*)'
+    _number = rf'(?:-?(?:0[0-7]+|0x[\da-f]+|\d+){_token_terminator})'
+    _opword = r'(?:equ|geq|gtr|leq|lss|neq)'
+    _string = rf'(?:"[^{_nl}"]*(?:"|(?=[{_nl}])))'
+    _variable = (r'(?:(?:%(?:\*|(?:~[a-z]*(?:\$[^:]+:)?)?\d|'
+                 rf'[^%:{_nl}]+(?::(?:~(?:-?\d+)?(?:,(?:-?\d+)?)?|(?:[^%{_nl}^]|'
+                 rf'\^[^%{_nl}])[^={_nl}]*=(?:[^%{_nl}^]|\^[^%{_nl}])*)?)?%))|'
+                 rf'(?:\^?![^!:{_nl}]+(?::(?:~(?:-?\d+)?(?:,(?:-?\d+)?)?|(?:'
+                 rf'[^!{_nl}^]|\^[^!{_nl}])[^={_nl}]*=(?:[^!{_nl}^]|\^[^!{_nl}])*)?)?\^?!))')
+    _core_token = rf'(?:(?:(?:\^[{_nl}]?)?[^"{_nlws}{_punct}])+)'
+    _core_token_compound = rf'(?:(?:(?:\^[{_nl}]?)?[^"{_nlws}{_punct})])+)'
+    _token = rf'(?:[{_punct}]+|{_core_token})'
+    _token_compound = rf'(?:[{_punct}]+|{_core_token_compound})'
+    _stoken = (rf'(?:[{_punct}]+|(?:{_string}|{_variable}|{_core_token})+)')
+
+    def _make_begin_state(compound, _core_token=_core_token,
+                          _core_token_compound=_core_token_compound,
+                          _keyword_terminator=_keyword_terminator,
+                          _nl=_nl, _punct=_punct, _string=_string,
+                          _space=_space, _start_label=_start_label,
+                          _stoken=_stoken, _token_terminator=_token_terminator,
+                          _variable=_variable, _ws=_ws):
+        rest = '(?:{}|{}|[^"%{}{}{}])*'.format(_string, _variable, _nl, _punct,
+                                            ')' if compound else '')
+        rest_of_line = rf'(?:(?:[^{_nl}^]|\^[{_nl}]?[\w\W])*)'
+        rest_of_line_compound = rf'(?:(?:[^{_nl}^)]|\^[{_nl}]?[^)])*)'
+        set_space = rf'((?:(?:\^[{_nl}]?)?[^\S\n])*)'
+        suffix = ''
+        if compound:
+            _keyword_terminator = rf'(?:(?=\))|{_keyword_terminator})'
+            _token_terminator = rf'(?:(?=\))|{_token_terminator})'
+            suffix = '/compound'
+        return [
+            ((r'\)', Punctuation, '#pop') if compound else
+             (rf'\)((?=\()|{_token_terminator}){rest_of_line}',
+              Comment.Single)),
+            (rf'(?={_start_label})', Text, f'follow{suffix}'),
+            (_space, using(this, state='text')),
+            include(f'redirect{suffix}'),
+            (rf'[{_nl}]+', Text),
+            (r'\(', Punctuation, 'root/compound'),
+            (r'@+', Punctuation),
+            (rf'((?:for|if|rem)(?:(?=(?:\^[{_nl}]?)?/)|(?:(?!\^)|'
+             rf'(?<=m))(?:(?=\()|{_token_terminator})))({_space}?{_core_token_compound if compound else _core_token}?(?:\^[{_nl}]?)?/(?:\^[{_nl}]?)?\?)',
+             bygroups(Keyword, using(this, state='text')),
+             f'follow{suffix}'),
+            (rf'(goto{_keyword_terminator})({rest}(?:\^[{_nl}]?)?/(?:\^[{_nl}]?)?\?{rest})',
+             bygroups(Keyword, using(this, state='text')),
+             f'follow{suffix}'),
+            (words(('assoc', 'break', 'cd', 'chdir', 'cls', 'color', 'copy',
+                    'date', 'del', 'dir', 'dpath', 'echo', 'endlocal', 'erase',
+                    'exit', 'ftype', 'keys', 'md', 'mkdir', 'mklink', 'move',
+                    'path', 'pause', 'popd', 'prompt', 'pushd', 'rd', 'ren',
+                    'rename', 'rmdir', 'setlocal', 'shift', 'start', 'time',
+                    'title', 'type', 'ver', 'verify', 'vol'),
+                   suffix=_keyword_terminator), Keyword, f'follow{suffix}'),
+            (rf'(call)({_space}?)(:)',
+             bygroups(Keyword, using(this, state='text'), Punctuation),
+             f'call{suffix}'),
+            (rf'call{_keyword_terminator}', Keyword),
+            (rf'(for{_token_terminator}(?!\^))({_space})(/f{_token_terminator})',
+             bygroups(Keyword, using(this, state='text'), Keyword),
+             ('for/f', 'for')),
+            (rf'(for{_token_terminator}(?!\^))({_space})(/l{_token_terminator})',
+             bygroups(Keyword, using(this, state='text'), Keyword),
+             ('for/l', 'for')),
+            (rf'for{_token_terminator}(?!\^)', Keyword, ('for2', 'for')),
+            (rf'(goto{_keyword_terminator})({_space}?)(:?)',
+             bygroups(Keyword, using(this, state='text'), Punctuation),
+             f'label{suffix}'),
+            (rf'(if(?:(?=\()|{_token_terminator})(?!\^))({_space}?)((?:/i{_token_terminator})?)({_space}?)((?:not{_token_terminator})?)({_space}?)',
+             bygroups(Keyword, using(this, state='text'), Keyword,
+                      using(this, state='text'), Keyword,
+                      using(this, state='text')), ('(?', 'if')),
+            (rf'rem(((?=\()|{_token_terminator}){_space}?{_stoken}?.*|{_keyword_terminator}{rest_of_line_compound if compound else rest_of_line})',
+             Comment.Single, f'follow{suffix}'),
+            (rf'(set{_keyword_terminator}){set_space}(/a)',
+             bygroups(Keyword, using(this, state='text'), Keyword),
+             f'arithmetic{suffix}'),
+            (r'(set{}){}((?:/p)?){}((?:(?:(?:\^[{}]?)?[^"{}{}^={}]|'
+             r'\^[{}]?[^"=])+)?)((?:(?:\^[{}]?)?=)?)'.format(_keyword_terminator, set_space, set_space, _nl, _nl, _punct,
+              ')' if compound else '', _nl, _nl),
+             bygroups(Keyword, using(this, state='text'), Keyword,
+                      using(this, state='text'), using(this, state='variable'),
+                      Punctuation),
+             f'follow{suffix}'),
+            default(f'follow{suffix}')
+        ]
+
+    def _make_follow_state(compound, _label=_label,
+                           _label_compound=_label_compound, _nl=_nl,
+                           _space=_space, _start_label=_start_label,
+                           _token=_token, _token_compound=_token_compound,
+                           _ws=_ws):
+        suffix = '/compound' if compound else ''
+        state = []
+        if compound:
+            state.append((r'(?=\))', Text, '#pop'))
+        state += [
+            (rf'{_start_label}([{_ws}]*)({_label_compound if compound else _label})(.*)',
+             bygroups(Text, Punctuation, Text, Name.Label, Comment.Single)),
+            include(f'redirect{suffix}'),
+            (rf'(?=[{_nl}])', Text, '#pop'),
+            (r'\|\|?|&&?', Punctuation, '#pop'),
+            include('text')
+        ]
+        return state
+
+    def _make_arithmetic_state(compound, _nl=_nl, _punct=_punct,
+                               _string=_string, _variable=_variable,
+                               _ws=_ws, _nlws=_nlws):
+        op = r'=+\-*/!~'
+        state = []
+        if compound:
+            state.append((r'(?=\))', Text, '#pop'))
+        state += [
+            (r'0[0-7]+', Number.Oct),
+            (r'0x[\da-f]+', Number.Hex),
+            (r'\d+', Number.Integer),
+            (r'[(),]+', Punctuation),
+            (rf'([{op}]|%|\^\^)+', Operator),
+            (r'({}|{}|(\^[{}]?)?[^(){}%\^"{}{}]|\^[{}]?{})+'.format(_string, _variable, _nl, op, _nlws, _punct, _nlws,
+              r'[^)]' if compound else r'[\w\W]'),
+             using(this, state='variable')),
+            (r'(?=[\x00|&])', Text, '#pop'),
+            include('follow')
+        ]
+        return state
+
+    def _make_call_state(compound, _label=_label,
+                         _label_compound=_label_compound):
+        state = []
+        if compound:
+            state.append((r'(?=\))', Text, '#pop'))
+        state.append((r'(:?)(%s)' % (_label_compound if compound else _label),
+                      bygroups(Punctuation, Name.Label), '#pop'))
+        return state
+
+    def _make_label_state(compound, _label=_label,
+                          _label_compound=_label_compound, _nl=_nl,
+                          _punct=_punct, _string=_string, _variable=_variable):
+        state = []
+        if compound:
+            state.append((r'(?=\))', Text, '#pop'))
+        state.append((r'({}?)((?:{}|{}|\^[{}]?{}|[^"%^{}{}{}])*)'.format(_label_compound if compound else _label, _string,
+                       _variable, _nl, r'[^)]' if compound else r'[\w\W]', _nl,
+                       _punct, r')' if compound else ''),
+                      bygroups(Name.Label, Comment.Single), '#pop'))
+        return state
+
+    def _make_redirect_state(compound,
+                             _core_token_compound=_core_token_compound,
+                             _nl=_nl, _punct=_punct, _stoken=_stoken,
+                             _string=_string, _space=_space,
+                             _variable=_variable, _nlws=_nlws):
+        stoken_compound = (rf'(?:[{_punct}]+|(?:{_string}|{_variable}|{_core_token_compound})+)')
+        return [
+            (rf'((?:(?<=[{_nlws}])\d)?)(>>?&|<&)([{_nlws}]*)(\d)',
+             bygroups(Number.Integer, Punctuation, Text, Number.Integer)),
+            (rf'((?:(?<=[{_nlws}])(?>?|<)({_space}?{stoken_compound if compound else _stoken})',
+             bygroups(Number.Integer, Punctuation, using(this, state='text')))
+        ]
+
+    tokens = {
+        'root': _make_begin_state(False),
+        'follow': _make_follow_state(False),
+        'arithmetic': _make_arithmetic_state(False),
+        'call': _make_call_state(False),
+        'label': _make_label_state(False),
+        'redirect': _make_redirect_state(False),
+        'root/compound': _make_begin_state(True),
+        'follow/compound': _make_follow_state(True),
+        'arithmetic/compound': _make_arithmetic_state(True),
+        'call/compound': _make_call_state(True),
+        'label/compound': _make_label_state(True),
+        'redirect/compound': _make_redirect_state(True),
+        'variable-or-escape': [
+            (_variable, Name.Variable),
+            (rf'%%|\^[{_nl}]?(\^!|[\w\W])', String.Escape)
+        ],
+        'string': [
+            (r'"', String.Double, '#pop'),
+            (_variable, Name.Variable),
+            (r'\^!|%%', String.Escape),
+            (rf'[^"%^{_nl}]+|[%^]', String.Double),
+            default('#pop')
+        ],
+        'sqstring': [
+            include('variable-or-escape'),
+            (r'[^%]+|%', String.Single)
+        ],
+        'bqstring': [
+            include('variable-or-escape'),
+            (r'[^%]+|%', String.Backtick)
+        ],
+        'text': [
+            (r'"', String.Double, 'string'),
+            include('variable-or-escape'),
+            (rf'[^"%^{_nlws}{_punct}\d)]+|.', Text)
+        ],
+        'variable': [
+            (r'"', String.Double, 'string'),
+            include('variable-or-escape'),
+            (rf'[^"%^{_nl}]+|.', Name.Variable)
+        ],
+        'for': [
+            (rf'({_space})(in)({_space})(\()',
+             bygroups(using(this, state='text'), Keyword,
+                      using(this, state='text'), Punctuation), '#pop'),
+            include('follow')
+        ],
+        'for2': [
+            (r'\)', Punctuation),
+            (rf'({_space})(do{_token_terminator})',
+             bygroups(using(this, state='text'), Keyword), '#pop'),
+            (rf'[{_nl}]+', Text),
+            include('follow')
+        ],
+        'for/f': [
+            (rf'(")((?:{_variable}|[^"])*?")([{_nlws}]*)(\))',
+             bygroups(String.Double, using(this, state='string'), Text,
+                      Punctuation)),
+            (r'"', String.Double, ('#pop', 'for2', 'string')),
+            (rf"('(?:%%|{_variable}|[\w\W])*?')([{_nlws}]*)(\))",
+             bygroups(using(this, state='sqstring'), Text, Punctuation)),
+            (rf'(`(?:%%|{_variable}|[\w\W])*?`)([{_nlws}]*)(\))',
+             bygroups(using(this, state='bqstring'), Text, Punctuation)),
+            include('for2')
+        ],
+        'for/l': [
+            (r'-?\d+', Number.Integer),
+            include('for2')
+        ],
+        'if': [
+            (rf'((?:cmdextversion|errorlevel){_token_terminator})({_space})(\d+)',
+             bygroups(Keyword, using(this, state='text'),
+                      Number.Integer), '#pop'),
+            (rf'(defined{_token_terminator})({_space})({_stoken})',
+             bygroups(Keyword, using(this, state='text'),
+                      using(this, state='variable')), '#pop'),
+            (rf'(exist{_token_terminator})({_space}{_stoken})',
+             bygroups(Keyword, using(this, state='text')), '#pop'),
+            (rf'({_number}{_space})({_opword})({_space}{_number})',
+             bygroups(using(this, state='arithmetic'), Operator.Word,
+                      using(this, state='arithmetic')), '#pop'),
+            (_stoken, using(this, state='text'), ('#pop', 'if2')),
+        ],
+        'if2': [
+            (rf'({_space}?)(==)({_space}?{_stoken})',
+             bygroups(using(this, state='text'), Operator,
+                      using(this, state='text')), '#pop'),
+            (rf'({_space})({_opword})({_space}{_stoken})',
+             bygroups(using(this, state='text'), Operator.Word,
+                      using(this, state='text')), '#pop')
+        ],
+        '(?': [
+            (_space, using(this, state='text')),
+            (r'\(', Punctuation, ('#pop', 'else?', 'root/compound')),
+            default('#pop')
+        ],
+        'else?': [
+            (_space, using(this, state='text')),
+            (rf'else{_token_terminator}', Keyword, '#pop'),
+            default('#pop')
+        ]
+    }
+
+
+class MSDOSSessionLexer(ShellSessionBaseLexer):
+    """
+    Lexer for MS DOS shell sessions, i.e. command lines, including a
+    prompt, interspersed with output.
+    """
+
+    name = 'MSDOS Session'
+    aliases = ['doscon']
+    filenames = []
+    mimetypes = []
+    url = 'https://en.wikipedia.org/wiki/MS-DOS'
+    version_added = '2.1'
+    _example = "doscon/session"
+
+    _innerLexerCls = BatchLexer
+    _ps1rgx = re.compile(r'^([^>]*>)(.*\n?)')
+    _ps2 = 'More? '
+
+
+class TcshLexer(RegexLexer):
+    """
+    Lexer for tcsh scripts.
+    """
+
+    name = 'Tcsh'
+    aliases = ['tcsh', 'csh']
+    filenames = ['*.tcsh', '*.csh']
+    mimetypes = ['application/x-csh']
+    url = 'https://www.tcsh.org'
+    version_added = '0.10'
+
+    tokens = {
+        'root': [
+            include('basic'),
+            (r'\$\(', Keyword, 'paren'),
+            (r'\$\{#?', Keyword, 'curly'),
+            (r'`', String.Backtick, 'backticks'),
+            include('data'),
+        ],
+        'basic': [
+            (r'\b(if|endif|else|while|then|foreach|case|default|'
+             r'break|continue|goto|breaksw|end|switch|endsw)\s*\b',
+             Keyword),
+            (r'\b(alias|alloc|bg|bindkey|builtins|bye|caller|cd|chdir|'
+             r'complete|dirs|echo|echotc|eval|exec|exit|fg|filetest|getxvers|'
+             r'glob|getspath|hashstat|history|hup|inlib|jobs|kill|'
+             r'limit|log|login|logout|ls-F|migrate|newgrp|nice|nohup|notify|'
+             r'onintr|popd|printenv|pushd|rehash|repeat|rootnode|popd|pushd|'
+             r'set|shift|sched|setenv|setpath|settc|setty|setxvers|shift|'
+             r'source|stop|suspend|source|suspend|telltc|time|'
+             r'umask|unalias|uncomplete|unhash|universe|unlimit|unset|unsetenv|'
+             r'ver|wait|warp|watchlog|where|which)\s*\b',
+             Name.Builtin),
+            (r'#.*', Comment),
+            (r'\\[\w\W]', String.Escape),
+            (r'(\b\w+)(\s*)(=)', bygroups(Name.Variable, Text, Operator)),
+            (r'[\[\]{}()=]+', Operator),
+            (r'<<\s*(\'?)\\?(\w+)[\w\W]+?\2', String),
+            (r';', Punctuation),
+        ],
+        'data': [
+            (r'(?s)"(\\\\|\\[0-7]+|\\.|[^"\\])*"', String.Double),
+            (r"(?s)'(\\\\|\\[0-7]+|\\.|[^'\\])*'", String.Single),
+            (r'\s+', Text),
+            (r'[^=\s\[\]{}()$"\'`\\;#]+', Text),
+            (r'\d+(?= |\Z)', Number),
+            (r'\$#?(\w+|.)', Name.Variable),
+        ],
+        'curly': [
+            (r'\}', Keyword, '#pop'),
+            (r':-', Keyword),
+            (r'\w+', Name.Variable),
+            (r'[^}:"\'`$]+', Punctuation),
+            (r':', Punctuation),
+            include('root'),
+        ],
+        'paren': [
+            (r'\)', Keyword, '#pop'),
+            include('root'),
+        ],
+        'backticks': [
+            (r'`', String.Backtick, '#pop'),
+            include('root'),
+        ],
+    }
+
+
+class TcshSessionLexer(ShellSessionBaseLexer):
+    """
+    Lexer for Tcsh sessions, i.e. command lines, including a
+    prompt, interspersed with output.
+    """
+
+    name = 'Tcsh Session'
+    aliases = ['tcshcon']
+    filenames = []
+    mimetypes = []
+    url = 'https://www.tcsh.org'
+    version_added = '2.1'
+    _example = "tcshcon/session"
+
+    _innerLexerCls = TcshLexer
+    _ps1rgx = re.compile(r'^([^>]+>)(.*\n?)')
+    _ps2 = '? '
+
+
+class PowerShellLexer(RegexLexer):
+    """
+    For Windows PowerShell code.
+    """
+    name = 'PowerShell'
+    aliases = ['powershell', 'pwsh', 'posh', 'ps1', 'psm1']
+    filenames = ['*.ps1', '*.psm1']
+    mimetypes = ['text/x-powershell']
+    url = 'https://learn.microsoft.com/en-us/powershell'
+    version_added = '1.5'
+
+    flags = re.DOTALL | re.IGNORECASE | re.MULTILINE
+
+    keywords = (
+        'while validateset validaterange validatepattern validatelength '
+        'validatecount until trap switch return ref process param parameter in '
+        'if global: local: function foreach for finally filter end elseif else '
+        'dynamicparam do default continue cmdletbinding break begin alias \\? '
+        '% #script #private #local #global mandatory parametersetname position '
+        'valuefrompipeline valuefrompipelinebypropertyname '
+        'valuefromremainingarguments helpmessage try catch throw').split()
+
+    operators = (
+        'and as band bnot bor bxor casesensitive ccontains ceq cge cgt cle '
+        'clike clt cmatch cne cnotcontains cnotlike cnotmatch contains '
+        'creplace eq exact f file ge gt icontains ieq ige igt ile ilike ilt '
+        'imatch ine inotcontains inotlike inotmatch ireplace is isnot le like '
+        'lt match ne not notcontains notlike notmatch or regex replace '
+        'wildcard').split()
+
+    verbs = (
+        'write where watch wait use update unregister unpublish unprotect '
+        'unlock uninstall undo unblock trace test tee take sync switch '
+        'suspend submit stop step start split sort skip show set send select '
+        'search scroll save revoke resume restore restart resolve resize '
+        'reset request repair rename remove register redo receive read push '
+        'publish protect pop ping out optimize open new move mount merge '
+        'measure lock limit join invoke install initialize import hide group '
+        'grant get format foreach find export expand exit enter enable edit '
+        'dismount disconnect disable deny debug cxnew copy convertto '
+        'convertfrom convert connect confirm compress complete compare close '
+        'clear checkpoint block backup assert approve aggregate add').split()
+
+    aliases_ = (
+        'ac asnp cat cd cfs chdir clc clear clhy cli clp cls clv cnsn '
+        'compare copy cp cpi cpp curl cvpa dbp del diff dir dnsn ebp echo epal '
+        'epcsv epsn erase etsn exsn fc fhx fl foreach ft fw gal gbp gc gci gcm '
+        'gcs gdr ghy gi gjb gl gm gmo gp gps gpv group gsn gsnp gsv gu gv gwmi '
+        'h history icm iex ihy ii ipal ipcsv ipmo ipsn irm ise iwmi iwr kill lp '
+        'ls man md measure mi mount move mp mv nal ndr ni nmo npssc nsn nv ogv '
+        'oh popd ps pushd pwd r rbp rcjb rcsn rd rdr ren ri rjb rm rmdir rmo '
+        'rni rnp rp rsn rsnp rujb rv rvpa rwmi sajb sal saps sasv sbp sc select '
+        'set shcm si sl sleep sls sort sp spjb spps spsv start sujb sv swmi tee '
+        'trcm type wget where wjb write').split()
+
+    commenthelp = (
+        'component description example externalhelp forwardhelpcategory '
+        'forwardhelptargetname functionality inputs link '
+        'notes outputs parameter remotehelprunspace role synopsis').split()
+
+    tokens = {
+        'root': [
+            # we need to count pairs of parentheses for correct highlight
+            # of '$(...)' blocks in strings
+            (r'\(', Punctuation, 'child'),
+            (r'\s+', Text),
+            (r'^(\s*#[#\s]*)(\.(?:{}))([^\n]*$)'.format('|'.join(commenthelp)),
+             bygroups(Comment, String.Doc, Comment)),
+            (r'#[^\n]*?$', Comment),
+            (r'(<|<)#', Comment.Multiline, 'multline'),
+            (r'@"\n', String.Heredoc, 'heredoc-double'),
+            (r"@'\n.*?\n'@", String.Heredoc),
+            # escaped syntax
+            (r'`[\'"$@-]', Punctuation),
+            (r'"', String.Double, 'string'),
+            (r"'([^']|'')*'", String.Single),
+            (r'(\$|@@|@)((global|script|private|env):)?\w+',
+             Name.Variable),
+            (r'({})\b'.format('|'.join(keywords)), Keyword),
+            (r'-({})\b'.format('|'.join(operators)), Operator),
+            (r'({})-[a-z_]\w*\b'.format('|'.join(verbs)), Name.Builtin),
+            (r'({})\s'.format('|'.join(aliases_)), Name.Builtin),
+            (r'\[[a-z_\[][\w. `,\[\]]*\]', Name.Constant),  # .net [type]s
+            (r'-[a-z_]\w*', Name),
+            (r'\w+', Name),
+            (r'[.,;:@{}\[\]$()=+*/\\&%!~?^`|<>-]', Punctuation),
+        ],
+        'child': [
+            (r'\)', Punctuation, '#pop'),
+            include('root'),
+        ],
+        'multline': [
+            (r'[^#&.]+', Comment.Multiline),
+            (r'#(>|>)', Comment.Multiline, '#pop'),
+            (r'\.({})'.format('|'.join(commenthelp)), String.Doc),
+            (r'[#&.]', Comment.Multiline),
+        ],
+        'string': [
+            (r"`[0abfnrtv'\"$`]", String.Escape),
+            (r'[^$`"]+', String.Double),
+            (r'\$\(', Punctuation, 'child'),
+            (r'""', String.Double),
+            (r'[`$]', String.Double),
+            (r'"', String.Double, '#pop'),
+        ],
+        'heredoc-double': [
+            (r'\n"@', String.Heredoc, '#pop'),
+            (r'\$\(', Punctuation, 'child'),
+            (r'[^@\n]+"]', String.Heredoc),
+            (r".", String.Heredoc),
+        ]
+    }
+
+
+class PowerShellSessionLexer(ShellSessionBaseLexer):
+    """
+    Lexer for PowerShell sessions, i.e. command lines, including a
+    prompt, interspersed with output.
+    """
+
+    name = 'PowerShell Session'
+    aliases = ['pwsh-session', 'ps1con']
+    filenames = []
+    mimetypes = []
+    url = 'https://learn.microsoft.com/en-us/powershell'
+    version_added = '2.1'
+    _example = "pwsh-session/session"
+
+    _innerLexerCls = PowerShellLexer
+    _bare_continuation = True
+    _ps1rgx = re.compile(r'^((?:\[[^]]+\]: )?PS[^>]*> ?)(.*\n?)')
+    _ps2 = '> '
+
+
+class FishShellLexer(RegexLexer):
+    """
+    Lexer for Fish shell scripts.
+    """
+
+    name = 'Fish'
+    aliases = ['fish', 'fishshell']
+    filenames = ['*.fish', '*.load']
+    mimetypes = ['application/x-fish']
+    url = 'https://fishshell.com'
+    version_added = '2.1'
+
+    tokens = {
+        'root': [
+            include('basic'),
+            include('data'),
+            include('interp'),
+        ],
+        'interp': [
+            (r'\$\(\(', Keyword, 'math'),
+            (r'\(', Keyword, 'paren'),
+            (r'\$#?(\w+|.)', Name.Variable),
+        ],
+        'basic': [
+            (r'\b(begin|end|if|else|while|break|for|in|return|function|block|'
+             r'case|continue|switch|not|and|or|set|echo|exit|pwd|true|false|'
+             r'cd|count|test)(\s*)\b',
+             bygroups(Keyword, Text)),
+            (r'\b(alias|bg|bind|breakpoint|builtin|command|commandline|'
+             r'complete|contains|dirh|dirs|emit|eval|exec|fg|fish|fish_config|'
+             r'fish_indent|fish_pager|fish_prompt|fish_right_prompt|'
+             r'fish_update_completions|fishd|funced|funcsave|functions|help|'
+             r'history|isatty|jobs|math|mimedb|nextd|open|popd|prevd|psub|'
+             r'pushd|random|read|set_color|source|status|trap|type|ulimit|'
+             r'umask|vared|fc|getopts|hash|kill|printf|time|wait)\s*\b(?!\.)',
+             Name.Builtin),
+            (r'#.*\n', Comment),
+            (r'\\[\w\W]', String.Escape),
+            (r'(\b\w+)(\s*)(=)', bygroups(Name.Variable, Whitespace, Operator)),
+            (r'[\[\]()=]', Operator),
+            (r'<<-?\s*(\'?)\\?(\w+)[\w\W]+?\2', String),
+        ],
+        'data': [
+            (r'(?s)\$?"(\\\\|\\[0-7]+|\\.|[^"\\$])*"', String.Double),
+            (r'"', String.Double, 'string'),
+            (r"(?s)\$'(\\\\|\\[0-7]+|\\.|[^'\\])*'", String.Single),
+            (r"(?s)'.*?'", String.Single),
+            (r';', Punctuation),
+            (r'&|\||\^|<|>', Operator),
+            (r'\s+', Text),
+            (r'\d+(?= |\Z)', Number),
+            (r'[^=\s\[\]{}()$"\'`\\<&|;]+', Text),
+        ],
+        'string': [
+            (r'"', String.Double, '#pop'),
+            (r'(?s)(\\\\|\\[0-7]+|\\.|[^"\\$])+', String.Double),
+            include('interp'),
+        ],
+        'paren': [
+            (r'\)', Keyword, '#pop'),
+            include('root'),
+        ],
+        'math': [
+            (r'\)\)', Keyword, '#pop'),
+            (r'[-+*/%^|&]|\*\*|\|\|', Operator),
+            (r'\d+#\d+', Number),
+            (r'\d+#(?! )', Number),
+            (r'\d+', Number),
+            include('root'),
+        ],
+    }
+
+class ExeclineLexer(RegexLexer):
+    """
+    Lexer for Laurent Bercot's execline language.
+    """
+
+    name = 'execline'
+    aliases = ['execline']
+    filenames = ['*.exec']
+    url = 'https://skarnet.org/software/execline'
+    version_added = '2.7'
+
+    tokens = {
+        'root': [
+            include('basic'),
+            include('data'),
+            include('interp')
+        ],
+        'interp': [
+            (r'\$\{', String.Interpol, 'curly'),
+            (r'\$[\w@#]+', Name.Variable),  # user variable
+            (r'\$', Text),
+        ],
+        'basic': [
+            (r'\b(background|backtick|cd|define|dollarat|elgetopt|'
+             r'elgetpositionals|elglob|emptyenv|envfile|exec|execlineb|'
+             r'exit|export|fdblock|fdclose|fdmove|fdreserve|fdswap|'
+             r'forbacktickx|foreground|forstdin|forx|getcwd|getpid|heredoc|'
+             r'homeof|if|ifelse|ifte|ifthenelse|importas|loopwhilex|'
+             r'multidefine|multisubstitute|pipeline|piperw|posix-cd|'
+             r'redirfd|runblock|shift|trap|tryexec|umask|unexport|wait|'
+             r'withstdinas)\b', Name.Builtin),
+            (r'\A#!.+\n', Comment.Hashbang),
+            (r'#.*\n', Comment.Single),
+            (r'[{}]', Operator)
+        ],
+        'data': [
+            (r'(?s)"(\\.|[^"\\$])*"', String.Double),
+            (r'"', String.Double, 'string'),
+            (r'\s+', Text),
+            (r'[^\s{}$"\\]+', Text)
+        ],
+        'string': [
+            (r'"', String.Double, '#pop'),
+            (r'(?s)(\\\\|\\.|[^"\\$])+', String.Double),
+            include('interp'),
+        ],
+        'curly': [
+            (r'\}', String.Interpol, '#pop'),
+            (r'[\w#@]+', Name.Variable),
+            include('root')
+        ]
+
+    }
+
+    def analyse_text(text):
+        if shebang_matches(text, r'execlineb'):
+            return 1
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/sieve.py b/env/lib/python3.12/site-packages/pygments/lexers/sieve.py
new file mode 100644
index 0000000..fc48980
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/sieve.py
@@ -0,0 +1,78 @@
+"""
+    pygments.lexers.sieve
+    ~~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for Sieve file format.
+
+    https://tools.ietf.org/html/rfc5228
+    https://tools.ietf.org/html/rfc5173
+    https://tools.ietf.org/html/rfc5229
+    https://tools.ietf.org/html/rfc5230
+    https://tools.ietf.org/html/rfc5232
+    https://tools.ietf.org/html/rfc5235
+    https://tools.ietf.org/html/rfc5429
+    https://tools.ietf.org/html/rfc8580
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups
+from pygments.token import Comment, Name, Literal, String, Text, Punctuation, \
+    Keyword
+
+__all__ = ["SieveLexer"]
+
+
+class SieveLexer(RegexLexer):
+    """
+    Lexer for sieve format.
+    """
+    name = 'Sieve'
+    filenames = ['*.siv', '*.sieve']
+    aliases = ['sieve']
+    url = 'https://en.wikipedia.org/wiki/Sieve_(mail_filtering_language)'
+    version_added = '2.6'
+
+    tokens = {
+        'root': [
+            (r'\s+', Text),
+            (r'[();,{}\[\]]', Punctuation),
+            # import:
+            (r'(?i)require',
+             Keyword.Namespace),
+            # tags:
+            (r'(?i)(:)(addresses|all|contains|content|create|copy|comparator|'
+             r'count|days|detail|domain|fcc|flags|from|handle|importance|is|'
+             r'localpart|length|lowerfirst|lower|matches|message|mime|options|'
+             r'over|percent|quotewildcard|raw|regex|specialuse|subject|text|'
+             r'under|upperfirst|upper|value)',
+             bygroups(Name.Tag, Name.Tag)),
+            # tokens:
+            (r'(?i)(address|addflag|allof|anyof|body|discard|elsif|else|envelope|'
+             r'ereject|exists|false|fileinto|if|hasflag|header|keep|'
+             r'notify_method_capability|notify|not|redirect|reject|removeflag|'
+             r'setflag|size|spamtest|stop|string|true|vacation|virustest)',
+             Name.Builtin),
+            (r'(?i)set',
+             Keyword.Declaration),
+            # number:
+            (r'([0-9.]+)([kmgKMG])?',
+             bygroups(Literal.Number, Literal.Number)),
+            # comment:
+            (r'#.*$',
+             Comment.Single),
+            (r'/\*.*\*/',
+             Comment.Multiline),
+            # string:
+            (r'"[^"]*?"',
+             String),
+            # text block:
+            (r'text:',
+             Name.Tag, 'text'),
+        ],
+        'text': [
+            (r'[^.].*?\n', String),
+            (r'^\.', Punctuation, "#pop"),
+        ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/slash.py b/env/lib/python3.12/site-packages/pygments/lexers/slash.py
new file mode 100644
index 0000000..1c439d0
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/slash.py
@@ -0,0 +1,183 @@
+"""
+    pygments.lexers.slash
+    ~~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for the Slash programming language.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import ExtendedRegexLexer, bygroups, DelegatingLexer
+from pygments.token import Name, Number, String, Comment, Punctuation, \
+    Other, Keyword, Operator, Whitespace
+
+__all__ = ['SlashLexer']
+
+
+class SlashLanguageLexer(ExtendedRegexLexer):
+    _nkw = r'(?=[^a-zA-Z_0-9])'
+
+    def move_state(new_state):
+        return ("#pop", new_state)
+
+    def right_angle_bracket(lexer, match, ctx):
+        if len(ctx.stack) > 1 and ctx.stack[-2] == "string":
+            ctx.stack.pop()
+        yield match.start(), String.Interpol, '}'
+        ctx.pos = match.end()
+        pass
+
+    tokens = {
+        "root": [
+            (r"<%=",        Comment.Preproc,    move_state("slash")),
+            (r"<%!!",       Comment.Preproc,    move_state("slash")),
+            (r"<%#.*?%>",   Comment.Multiline),
+            (r"<%",         Comment.Preproc,    move_state("slash")),
+            (r".|\n",       Other),
+        ],
+        "string": [
+            (r"\\",         String.Escape,      move_state("string_e")),
+            (r"\"",         String,             move_state("slash")),
+            (r"#\{",        String.Interpol,    "slash"),
+            (r'.|\n',       String),
+        ],
+        "string_e": [
+            (r'n',                  String.Escape,      move_state("string")),
+            (r't',                  String.Escape,      move_state("string")),
+            (r'r',                  String.Escape,      move_state("string")),
+            (r'e',                  String.Escape,      move_state("string")),
+            (r'x[a-fA-F0-9]{2}',    String.Escape,      move_state("string")),
+            (r'.',                  String.Escape,      move_state("string")),
+        ],
+        "regexp": [
+            (r'}[a-z]*',            String.Regex,       move_state("slash")),
+            (r'\\(.|\n)',           String.Regex),
+            (r'{',                  String.Regex,       "regexp_r"),
+            (r'.|\n',               String.Regex),
+        ],
+        "regexp_r": [
+            (r'}[a-z]*',            String.Regex,       "#pop"),
+            (r'\\(.|\n)',           String.Regex),
+            (r'{',                  String.Regex,       "regexp_r"),
+        ],
+        "slash": [
+            (r"%>",                     Comment.Preproc,    move_state("root")),
+            (r"\"",                     String,             move_state("string")),
+            (r"'[a-zA-Z0-9_]+",         String),
+            (r'%r{',                    String.Regex,       move_state("regexp")),
+            (r'/\*.*?\*/',              Comment.Multiline),
+            (r"(#|//).*?\n",            Comment.Single),
+            (r'-?[0-9]+e[+-]?[0-9]+',   Number.Float),
+            (r'-?[0-9]+\.[0-9]+(e[+-]?[0-9]+)?', Number.Float),
+            (r'-?[0-9]+',               Number.Integer),
+            (r'nil'+_nkw,               Name.Builtin),
+            (r'true'+_nkw,              Name.Builtin),
+            (r'false'+_nkw,             Name.Builtin),
+            (r'self'+_nkw,              Name.Builtin),
+            (r'(class)(\s+)([A-Z][a-zA-Z0-9_\']*)',
+                bygroups(Keyword, Whitespace, Name.Class)),
+            (r'class'+_nkw,             Keyword),
+            (r'extends'+_nkw,           Keyword),
+            (r'(def)(\s+)(self)(\s*)(\.)(\s*)([a-z_][a-zA-Z0-9_\']*=?|<<|>>|==|<=>|<=|<|>=|>|\+|-(self)?|~(self)?|\*|/|%|^|&&|&|\||\[\]=?)',
+                bygroups(Keyword, Whitespace, Name.Builtin, Whitespace, Punctuation, Whitespace, Name.Function)),
+            (r'(def)(\s+)([a-z_][a-zA-Z0-9_\']*=?|<<|>>|==|<=>|<=|<|>=|>|\+|-(self)?|~(self)?|\*|/|%|^|&&|&|\||\[\]=?)',
+                bygroups(Keyword, Whitespace, Name.Function)),
+            (r'def'+_nkw,               Keyword),
+            (r'if'+_nkw,                Keyword),
+            (r'elsif'+_nkw,             Keyword),
+            (r'else'+_nkw,              Keyword),
+            (r'unless'+_nkw,            Keyword),
+            (r'for'+_nkw,               Keyword),
+            (r'in'+_nkw,                Keyword),
+            (r'while'+_nkw,             Keyword),
+            (r'until'+_nkw,             Keyword),
+            (r'and'+_nkw,               Keyword),
+            (r'or'+_nkw,                Keyword),
+            (r'not'+_nkw,               Keyword),
+            (r'lambda'+_nkw,            Keyword),
+            (r'try'+_nkw,               Keyword),
+            (r'catch'+_nkw,             Keyword),
+            (r'return'+_nkw,            Keyword),
+            (r'next'+_nkw,              Keyword),
+            (r'last'+_nkw,              Keyword),
+            (r'throw'+_nkw,             Keyword),
+            (r'use'+_nkw,               Keyword),
+            (r'switch'+_nkw,            Keyword),
+            (r'\\',                     Keyword),
+            (r'λ',                      Keyword),
+            (r'__FILE__'+_nkw,          Name.Builtin.Pseudo),
+            (r'__LINE__'+_nkw,          Name.Builtin.Pseudo),
+            (r'[A-Z][a-zA-Z0-9_\']*'+_nkw, Name.Constant),
+            (r'[a-z_][a-zA-Z0-9_\']*'+_nkw, Name),
+            (r'@[a-z_][a-zA-Z0-9_\']*'+_nkw, Name.Variable.Instance),
+            (r'@@[a-z_][a-zA-Z0-9_\']*'+_nkw, Name.Variable.Class),
+            (r'\(',                     Punctuation),
+            (r'\)',                     Punctuation),
+            (r'\[',                     Punctuation),
+            (r'\]',                     Punctuation),
+            (r'\{',                     Punctuation),
+            (r'\}',                     right_angle_bracket),
+            (r';',                      Punctuation),
+            (r',',                      Punctuation),
+            (r'<<=',                    Operator),
+            (r'>>=',                    Operator),
+            (r'<<',                     Operator),
+            (r'>>',                     Operator),
+            (r'==',                     Operator),
+            (r'!=',                     Operator),
+            (r'=>',                     Operator),
+            (r'=',                      Operator),
+            (r'<=>',                    Operator),
+            (r'<=',                     Operator),
+            (r'>=',                     Operator),
+            (r'<',                      Operator),
+            (r'>',                      Operator),
+            (r'\+\+',                   Operator),
+            (r'\+=',                    Operator),
+            (r'-=',                     Operator),
+            (r'\*\*=',                  Operator),
+            (r'\*=',                    Operator),
+            (r'\*\*',                   Operator),
+            (r'\*',                     Operator),
+            (r'/=',                     Operator),
+            (r'\+',                     Operator),
+            (r'-',                      Operator),
+            (r'/',                      Operator),
+            (r'%=',                     Operator),
+            (r'%',                      Operator),
+            (r'^=',                     Operator),
+            (r'&&=',                    Operator),
+            (r'&=',                     Operator),
+            (r'&&',                     Operator),
+            (r'&',                      Operator),
+            (r'\|\|=',                  Operator),
+            (r'\|=',                    Operator),
+            (r'\|\|',                   Operator),
+            (r'\|',                     Operator),
+            (r'!',                      Operator),
+            (r'\.\.\.',                 Operator),
+            (r'\.\.',                   Operator),
+            (r'\.',                     Operator),
+            (r'::',                     Operator),
+            (r':',                      Operator),
+            (r'(\s|\n)+',               Whitespace),
+            (r'[a-z_][a-zA-Z0-9_\']*',  Name.Variable),
+        ],
+    }
+
+
+class SlashLexer(DelegatingLexer):
+    """
+    Lexer for the Slash programming language.
+    """
+
+    name = 'Slash'
+    aliases = ['slash']
+    filenames = ['*.sla']
+    url = 'https://github.com/arturadib/Slash-A'
+    version_added = '2.4'
+
+    def __init__(self, **options):
+        from pygments.lexers.web import HtmlLexer
+        super().__init__(HtmlLexer, SlashLanguageLexer, **options)
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/smalltalk.py b/env/lib/python3.12/site-packages/pygments/lexers/smalltalk.py
new file mode 100644
index 0000000..674b7b4
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/smalltalk.py
@@ -0,0 +1,194 @@
+"""
+    pygments.lexers.smalltalk
+    ~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Smalltalk and related languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, include, bygroups, default
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation
+
+__all__ = ['SmalltalkLexer', 'NewspeakLexer']
+
+
+class SmalltalkLexer(RegexLexer):
+    """
+    For Smalltalk syntax.
+    Contributed by Stefan Matthias Aust.
+    Rewritten by Nils Winter.
+    """
+    name = 'Smalltalk'
+    url = 'http://www.smalltalk.org/'
+    filenames = ['*.st']
+    aliases = ['smalltalk', 'squeak', 'st']
+    mimetypes = ['text/x-smalltalk']
+    version_added = '0.10'
+
+    tokens = {
+        'root': [
+            (r'(<)(\w+:)(.*?)(>)', bygroups(Text, Keyword, Text, Text)),
+            include('squeak fileout'),
+            include('whitespaces'),
+            include('method definition'),
+            (r'(\|)([\w\s]*)(\|)', bygroups(Operator, Name.Variable, Operator)),
+            include('objects'),
+            (r'\^|\:=|\_', Operator),
+            # temporaries
+            (r'[\]({}.;!]', Text),
+        ],
+        'method definition': [
+            # Not perfect can't allow whitespaces at the beginning and the
+            # without breaking everything
+            (r'([a-zA-Z]+\w*:)(\s*)(\w+)',
+             bygroups(Name.Function, Text, Name.Variable)),
+            (r'^(\b[a-zA-Z]+\w*\b)(\s*)$', bygroups(Name.Function, Text)),
+            (r'^([-+*/\\~<>=|&!?,@%]+)(\s*)(\w+)(\s*)$',
+             bygroups(Name.Function, Text, Name.Variable, Text)),
+        ],
+        'blockvariables': [
+            include('whitespaces'),
+            (r'(:)(\s*)(\w+)',
+             bygroups(Operator, Text, Name.Variable)),
+            (r'\|', Operator, '#pop'),
+            default('#pop'),  # else pop
+        ],
+        'literals': [
+            (r"'(''|[^'])*'", String, 'afterobject'),
+            (r'\$.', String.Char, 'afterobject'),
+            (r'#\(', String.Symbol, 'parenth'),
+            (r'\)', Text, 'afterobject'),
+            (r'(\d+r)?-?\d+(\.\d+)?(e-?\d+)?', Number, 'afterobject'),
+        ],
+        '_parenth_helper': [
+            include('whitespaces'),
+            (r'(\d+r)?-?\d+(\.\d+)?(e-?\d+)?', Number),
+            (r'[-+*/\\~<>=|&#!?,@%\w:]+', String.Symbol),
+            # literals
+            (r"'(''|[^'])*'", String),
+            (r'\$.', String.Char),
+            (r'#*\(', String.Symbol, 'inner_parenth'),
+        ],
+        'parenth': [
+            # This state is a bit tricky since
+            # we can't just pop this state
+            (r'\)', String.Symbol, ('root', 'afterobject')),
+            include('_parenth_helper'),
+        ],
+        'inner_parenth': [
+            (r'\)', String.Symbol, '#pop'),
+            include('_parenth_helper'),
+        ],
+        'whitespaces': [
+            # skip whitespace and comments
+            (r'\s+', Text),
+            (r'"(""|[^"])*"', Comment),
+        ],
+        'objects': [
+            (r'\[', Text, 'blockvariables'),
+            (r'\]', Text, 'afterobject'),
+            (r'\b(self|super|true|false|nil|thisContext)\b',
+             Name.Builtin.Pseudo, 'afterobject'),
+            (r'\b[A-Z]\w*(?!:)\b', Name.Class, 'afterobject'),
+            (r'\b[a-z]\w*(?!:)\b', Name.Variable, 'afterobject'),
+            (r'#("(""|[^"])*"|[-+*/\\~<>=|&!?,@%]+|[\w:]+)',
+             String.Symbol, 'afterobject'),
+            include('literals'),
+        ],
+        'afterobject': [
+            (r'! !$', Keyword, '#pop'),  # squeak chunk delimiter
+            include('whitespaces'),
+            (r'\b(ifTrue:|ifFalse:|whileTrue:|whileFalse:|timesRepeat:)',
+             Name.Builtin, '#pop'),
+            (r'\b(new\b(?!:))', Name.Builtin),
+            (r'\:=|\_', Operator, '#pop'),
+            (r'\b[a-zA-Z]+\w*:', Name.Function, '#pop'),
+            (r'\b[a-zA-Z]+\w*', Name.Function),
+            (r'\w+:?|[-+*/\\~<>=|&!?,@%]+', Name.Function, '#pop'),
+            (r'\.', Punctuation, '#pop'),
+            (r';', Punctuation),
+            (r'[\])}]', Text),
+            (r'[\[({]', Text, '#pop'),
+        ],
+        'squeak fileout': [
+            # Squeak fileout format (optional)
+            (r'^"(""|[^"])*"!', Keyword),
+            (r"^'(''|[^'])*'!", Keyword),
+            (r'^(!)(\w+)( commentStamp: )(.*?)( prior: .*?!\n)(.*?)(!)',
+                bygroups(Keyword, Name.Class, Keyword, String, Keyword, Text, Keyword)),
+            (r"^(!)(\w+(?: class)?)( methodsFor: )('(?:''|[^'])*')(.*?!)",
+                bygroups(Keyword, Name.Class, Keyword, String, Keyword)),
+            (r'^(\w+)( subclass: )(#\w+)'
+             r'(\s+instanceVariableNames: )(.*?)'
+             r'(\s+classVariableNames: )(.*?)'
+             r'(\s+poolDictionaries: )(.*?)'
+             r'(\s+category: )(.*?)(!)',
+                bygroups(Name.Class, Keyword, String.Symbol, Keyword, String, Keyword,
+                         String, Keyword, String, Keyword, String, Keyword)),
+            (r'^(\w+(?: class)?)(\s+instanceVariableNames: )(.*?)(!)',
+                bygroups(Name.Class, Keyword, String, Keyword)),
+            (r'(!\n)(\].*)(! !)$', bygroups(Keyword, Text, Keyword)),
+            (r'! !$', Keyword),
+        ],
+    }
+
+
+class NewspeakLexer(RegexLexer):
+    """
+    For Newspeak syntax.
+    """
+    name = 'Newspeak'
+    url = 'http://newspeaklanguage.org/'
+    filenames = ['*.ns2']
+    aliases = ['newspeak', ]
+    mimetypes = ['text/x-newspeak']
+    version_added = '1.1'
+
+    tokens = {
+        'root': [
+            (r'\b(Newsqueak2)\b', Keyword.Declaration),
+            (r"'[^']*'", String),
+            (r'\b(class)(\s+)(\w+)(\s*)',
+             bygroups(Keyword.Declaration, Text, Name.Class, Text)),
+            (r'\b(mixin|self|super|private|public|protected|nil|true|false)\b',
+             Keyword),
+            (r'(\w+\:)(\s*)([a-zA-Z_]\w+)',
+             bygroups(Name.Function, Text, Name.Variable)),
+            (r'(\w+)(\s*)(=)',
+             bygroups(Name.Attribute, Text, Operator)),
+            (r'<\w+>', Comment.Special),
+            include('expressionstat'),
+            include('whitespace')
+        ],
+
+        'expressionstat': [
+            (r'(\d+\.\d*|\.\d+|\d+[fF])[fF]?', Number.Float),
+            (r'\d+', Number.Integer),
+            (r':\w+', Name.Variable),
+            (r'(\w+)(::)', bygroups(Name.Variable, Operator)),
+            (r'\w+:', Name.Function),
+            (r'\w+', Name.Variable),
+            (r'\(|\)', Punctuation),
+            (r'\[|\]', Punctuation),
+            (r'\{|\}', Punctuation),
+
+            (r'(\^|\+|\/|~|\*|<|>|=|@|%|\||&|\?|!|,|-|:)', Operator),
+            (r'\.|;', Punctuation),
+            include('whitespace'),
+            include('literals'),
+        ],
+        'literals': [
+            (r'\$.', String),
+            (r"'[^']*'", String),
+            (r"#'[^']*'", String.Symbol),
+            (r"#\w+:?", String.Symbol),
+            (r"#(\+|\/|~|\*|<|>|=|@|%|\||&|\?|!|,|-)+", String.Symbol)
+        ],
+        'whitespace': [
+            (r'\s+', Text),
+            (r'"[^"]*"', Comment)
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/smithy.py b/env/lib/python3.12/site-packages/pygments/lexers/smithy.py
new file mode 100644
index 0000000..bd479ae
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/smithy.py
@@ -0,0 +1,77 @@
+"""
+    pygments.lexers.smithy
+    ~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for the Smithy IDL.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups, words
+from pygments.token import Text, Comment, Keyword, Name, String, \
+    Number, Whitespace, Punctuation
+
+__all__ = ['SmithyLexer']
+
+
+class SmithyLexer(RegexLexer):
+    """
+    For Smithy IDL
+    """
+    name = 'Smithy'
+    url = 'https://awslabs.github.io/smithy/'
+    filenames = ['*.smithy']
+    aliases = ['smithy']
+    version_added = '2.10'
+
+    unquoted = r'[A-Za-z0-9_\.#$-]+'
+    identifier = r"[A-Za-z0-9_\.#$-]+"
+
+    simple_shapes = (
+        'use', 'byte', 'short', 'integer', 'long', 'float', 'document',
+        'double', 'bigInteger', 'bigDecimal', 'boolean', 'blob', 'string',
+        'timestamp',
+    )
+
+    aggregate_shapes = (
+       'apply', 'list', 'map', 'set', 'structure', 'union', 'resource',
+       'operation', 'service', 'trait'
+    )
+
+    tokens = {
+        'root': [
+            (r'///.*$', Comment.Multiline),
+            (r'//.*$', Comment),
+            (r'@[0-9a-zA-Z\.#-]*', Name.Decorator),
+            (r'(=)', Name.Decorator),
+            (r'^(\$version)(:)(.+)',
+                bygroups(Keyword.Declaration, Name.Decorator, Name.Class)),
+            (r'^(namespace)(\s+' + identifier + r')\b',
+                bygroups(Keyword.Declaration, Name.Class)),
+            (words(simple_shapes,
+                   prefix=r'^', suffix=r'(\s+' + identifier + r')\b'),
+                bygroups(Keyword.Declaration, Name.Class)),
+            (words(aggregate_shapes,
+                   prefix=r'^', suffix=r'(\s+' + identifier + r')'),
+                bygroups(Keyword.Declaration, Name.Class)),
+            (r'^(metadata)(\s+)((?:\S+)|(?:\"[^"]+\"))(\s*)(=)',
+                bygroups(Keyword.Declaration, Whitespace, Name.Class,
+                         Whitespace, Name.Decorator)),
+            (r"(true|false|null)", Keyword.Constant),
+            (r"(-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?)", Number),
+            (identifier + ":", Name.Label),
+            (identifier, Name.Variable.Class),
+            (r'\[', Text, "#push"),
+            (r'\]', Text, "#pop"),
+            (r'\(', Text, "#push"),
+            (r'\)', Text, "#pop"),
+            (r'\{', Text, "#push"),
+            (r'\}', Text, "#pop"),
+            (r'"{3}(\\\\|\n|\\")*"{3}', String.Doc),
+            (r'"(\\\\|\n|\\"|[^"])*"', String.Double),
+            (r"'(\\\\|\n|\\'|[^'])*'", String.Single),
+            (r'[:,]+', Punctuation),
+            (r'\s+', Whitespace),
+        ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/smv.py b/env/lib/python3.12/site-packages/pygments/lexers/smv.py
new file mode 100644
index 0000000..bf97b52
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/smv.py
@@ -0,0 +1,78 @@
+"""
+    pygments.lexers.smv
+    ~~~~~~~~~~~~~~~~~~~
+
+    Lexers for the SMV languages.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, words
+from pygments.token import Comment, Keyword, Name, Number, Operator, \
+    Punctuation, Text
+
+__all__ = ['NuSMVLexer']
+
+
+class NuSMVLexer(RegexLexer):
+    """
+    Lexer for the NuSMV language.
+    """
+
+    name = 'NuSMV'
+    aliases = ['nusmv']
+    filenames = ['*.smv']
+    mimetypes = []
+    url = 'https://nusmv.fbk.eu'
+    version_added = '2.2'
+
+    tokens = {
+        'root': [
+            # Comments
+            (r'(?s)\/\-\-.*?\-\-/', Comment),
+            (r'--.*\n', Comment),
+
+            # Reserved
+            (words(('MODULE', 'DEFINE', 'MDEFINE', 'CONSTANTS', 'VAR', 'IVAR',
+                    'FROZENVAR', 'INIT', 'TRANS', 'INVAR', 'SPEC', 'CTLSPEC',
+                    'LTLSPEC', 'PSLSPEC', 'COMPUTE', 'NAME', 'INVARSPEC',
+                    'FAIRNESS', 'JUSTICE', 'COMPASSION', 'ISA', 'ASSIGN',
+                    'CONSTRAINT', 'SIMPWFF', 'CTLWFF', 'LTLWFF', 'PSLWFF',
+                    'COMPWFF', 'IN', 'MIN', 'MAX', 'MIRROR', 'PRED',
+                    'PREDICATES'), suffix=r'(?![\w$#-])'),
+             Keyword.Declaration),
+            (r'process(?![\w$#-])', Keyword),
+            (words(('array', 'of', 'boolean', 'integer', 'real', 'word'),
+                   suffix=r'(?![\w$#-])'), Keyword.Type),
+            (words(('case', 'esac'), suffix=r'(?![\w$#-])'), Keyword),
+            (words(('word1', 'bool', 'signed', 'unsigned', 'extend', 'resize',
+                    'sizeof', 'uwconst', 'swconst', 'init', 'self', 'count',
+                    'abs', 'max', 'min'), suffix=r'(?![\w$#-])'),
+             Name.Builtin),
+            (words(('EX', 'AX', 'EF', 'AF', 'EG', 'AG', 'E', 'F', 'O', 'G',
+                    'H', 'X', 'Y', 'Z', 'A', 'U', 'S', 'V', 'T', 'BU', 'EBF',
+                    'ABF', 'EBG', 'ABG', 'next', 'mod', 'union', 'in', 'xor',
+                    'xnor'), suffix=r'(?![\w$#-])'),
+                Operator.Word),
+            (words(('TRUE', 'FALSE'), suffix=r'(?![\w$#-])'), Keyword.Constant),
+
+            # Names
+            (r'[a-zA-Z_][\w$#-]*', Name.Variable),
+
+            # Operators
+            (r':=', Operator),
+            (r'[-&|+*/<>!=]', Operator),
+
+            # Literals
+            (r'\-?\d+\b', Number.Integer),
+            (r'0[su][bB]\d*_[01_]+', Number.Bin),
+            (r'0[su][oO]\d*_[0-7_]+', Number.Oct),
+            (r'0[su][dD]\d*_[\d_]+', Number.Decimal),
+            (r'0[su][hH]\d*_[\da-fA-F_]+', Number.Hex),
+
+            # Whitespace, punctuation and the rest
+            (r'\s+', Text.Whitespace),
+            (r'[()\[\]{};?:.,]', Punctuation),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/snobol.py b/env/lib/python3.12/site-packages/pygments/lexers/snobol.py
new file mode 100644
index 0000000..bab51e9
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/snobol.py
@@ -0,0 +1,82 @@
+"""
+    pygments.lexers.snobol
+    ~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for the SNOBOL language.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation
+
+__all__ = ['SnobolLexer']
+
+
+class SnobolLexer(RegexLexer):
+    """
+    Lexer for the SNOBOL4 programming language.
+
+    Recognizes the common ASCII equivalents of the original SNOBOL4 operators.
+    Does not require spaces around binary operators.
+    """
+
+    name = "Snobol"
+    aliases = ["snobol"]
+    filenames = ['*.snobol']
+    mimetypes = ['text/x-snobol']
+    url = 'https://www.regressive.org/snobol4'
+    version_added = '1.5'
+
+    tokens = {
+        # root state, start of line
+        # comments, continuation lines, and directives start in column 1
+        # as do labels
+        'root': [
+            (r'\*.*\n', Comment),
+            (r'[+.] ', Punctuation, 'statement'),
+            (r'-.*\n', Comment),
+            (r'END\s*\n', Name.Label, 'heredoc'),
+            (r'[A-Za-z$][\w$]*', Name.Label, 'statement'),
+            (r'\s+', Text, 'statement'),
+        ],
+        # statement state, line after continuation or label
+        'statement': [
+            (r'\s*\n', Text, '#pop'),
+            (r'\s+', Text),
+            (r'(?<=[^\w.])(LT|LE|EQ|NE|GE|GT|INTEGER|IDENT|DIFFER|LGT|SIZE|'
+             r'REPLACE|TRIM|DUPL|REMDR|DATE|TIME|EVAL|APPLY|OPSYN|LOAD|UNLOAD|'
+             r'LEN|SPAN|BREAK|ANY|NOTANY|TAB|RTAB|REM|POS|RPOS|FAIL|FENCE|'
+             r'ABORT|ARB|ARBNO|BAL|SUCCEED|INPUT|OUTPUT|TERMINAL)(?=[^\w.])',
+             Name.Builtin),
+            (r'[A-Za-z][\w.]*', Name),
+            # ASCII equivalents of original operators
+            # | for the EBCDIC equivalent, ! likewise
+            # \ for EBCDIC negation
+            (r'\*\*|[?$.!%*/#+\-@|&\\=]', Operator),
+            (r'"[^"]*"', String),
+            (r"'[^']*'", String),
+            # Accept SPITBOL syntax for real numbers
+            # as well as Macro SNOBOL4
+            (r'[0-9]+(?=[^.EeDd])', Number.Integer),
+            (r'[0-9]+(\.[0-9]*)?([EDed][-+]?[0-9]+)?', Number.Float),
+            # Goto
+            (r':', Punctuation, 'goto'),
+            (r'[()<>,;]', Punctuation),
+        ],
+        # Goto block
+        'goto': [
+            (r'\s*\n', Text, "#pop:2"),
+            (r'\s+', Text),
+            (r'F|S', Keyword),
+            (r'(\()([A-Za-z][\w.]*)(\))',
+             bygroups(Punctuation, Name.Label, Punctuation))
+        ],
+        # everything after the END statement is basically one
+        # big heredoc.
+        'heredoc': [
+            (r'.*\n', String.Heredoc)
+        ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/solidity.py b/env/lib/python3.12/site-packages/pygments/lexers/solidity.py
new file mode 100644
index 0000000..3182a14
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/solidity.py
@@ -0,0 +1,87 @@
+"""
+    pygments.lexers.solidity
+    ~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Solidity.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups, include, words
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Whitespace
+
+__all__ = ['SolidityLexer']
+
+
+class SolidityLexer(RegexLexer):
+    """
+    For Solidity source code.
+    """
+
+    name = 'Solidity'
+    aliases = ['solidity']
+    filenames = ['*.sol']
+    mimetypes = []
+    url = 'https://soliditylang.org'
+    version_added = '2.5'
+
+    datatype = (
+        r'\b(address|bool|(?:(?:bytes|hash|int|string|uint)(?:8|16|24|32|40|48|56|64'
+        r'|72|80|88|96|104|112|120|128|136|144|152|160|168|176|184|192|200|208'
+        r'|216|224|232|240|248|256)?))\b'
+    )
+
+    tokens = {
+        'root': [
+            include('whitespace'),
+            include('comments'),
+            (r'\bpragma\s+solidity\b', Keyword, 'pragma'),
+            (r'\b(contract)(\s+)([a-zA-Z_]\w*)',
+             bygroups(Keyword, Whitespace, Name.Entity)),
+            (datatype + r'(\s+)((?:external|public|internal|private)\s+)?' +
+             r'([a-zA-Z_]\w*)',
+             bygroups(Keyword.Type, Whitespace, Keyword, Name.Variable)),
+            (r'\b(enum|event|function|struct)(\s+)([a-zA-Z_]\w*)',
+             bygroups(Keyword.Type, Whitespace, Name.Variable)),
+            (r'\b(msg|block|tx)\.([A-Za-z_][a-zA-Z0-9_]*)\b', Keyword),
+            (words((
+                'block', 'break', 'constant', 'constructor', 'continue',
+                'contract', 'do', 'else', 'external', 'false', 'for',
+                'function', 'if', 'import', 'inherited', 'internal', 'is',
+                'library', 'mapping', 'memory', 'modifier', 'msg', 'new',
+                'payable', 'private', 'public', 'require', 'return',
+                'returns', 'struct', 'suicide', 'throw', 'this', 'true',
+                'tx', 'var', 'while'), prefix=r'\b', suffix=r'\b'),
+             Keyword.Type),
+            (words(('keccak256',), prefix=r'\b', suffix=r'\b'), Name.Builtin),
+            (datatype, Keyword.Type),
+            include('constants'),
+            (r'[a-zA-Z_]\w*', Text),
+            (r'[~!%^&*+=|?:<>/-]', Operator),
+            (r'[.;{}(),\[\]]', Punctuation)
+        ],
+        'comments': [
+            (r'//(\n|[\w\W]*?[^\\]\n)', Comment.Single),
+            (r'/(\\\n)?[*][\w\W]*?[*](\\\n)?/', Comment.Multiline),
+            (r'/(\\\n)?[*][\w\W]*', Comment.Multiline)
+        ],
+        'constants': [
+            (r'("(\\"|.)*?")', String.Double),
+            (r"('(\\'|.)*?')", String.Single),
+            (r'\b0[xX][0-9a-fA-F]+\b', Number.Hex),
+            (r'\b\d+\b', Number.Decimal),
+        ],
+        'pragma': [
+            include('whitespace'),
+            include('comments'),
+            (r'(\^|>=|<)(\s*)(\d+\.\d+\.\d+)',
+             bygroups(Operator, Whitespace, Keyword)),
+            (r';', Punctuation, '#pop')
+        ],
+        'whitespace': [
+            (r'\s+', Whitespace),
+            (r'\n', Whitespace)
+        ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/soong.py b/env/lib/python3.12/site-packages/pygments/lexers/soong.py
new file mode 100644
index 0000000..bbf204d
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/soong.py
@@ -0,0 +1,78 @@
+"""
+    pygments.lexers.soong
+    ~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for Soong (Android.bp Blueprint) files.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups, include
+from pygments.token import Comment, Name, Number, Operator, Punctuation, \
+        String, Whitespace
+
+__all__ = ['SoongLexer']
+
+class SoongLexer(RegexLexer):
+    name = 'Soong'
+    version_added = '2.18'
+    url = 'https://source.android.com/docs/setup/reference/androidbp'
+    aliases = ['androidbp', 'bp', 'soong']
+    filenames = ['Android.bp']
+
+    tokens = {
+        'root': [
+            # A variable assignment
+            (r'(\w*)(\s*)(\+?=)(\s*)',
+             bygroups(Name.Variable, Whitespace, Operator, Whitespace),
+             'assign-rhs'),
+
+            # A top-level module
+            (r'(\w*)(\s*)(\{)',
+             bygroups(Name.Function, Whitespace, Punctuation),
+             'in-rule'),
+
+            # Everything else
+            include('comments'),
+            (r'\s+', Whitespace),  # newlines okay
+        ],
+        'assign-rhs': [
+            include('expr'),
+            (r'\n', Whitespace, '#pop'),
+        ],
+        'in-list': [
+            include('expr'),
+            include('comments'),
+            (r'\s+', Whitespace),  # newlines okay in a list
+            (r',', Punctuation),
+            (r'\]', Punctuation, '#pop'),
+        ],
+        'in-map': [
+            # A map key
+            (r'(\w+)(:)(\s*)', bygroups(Name, Punctuation, Whitespace)),
+
+            include('expr'),
+            include('comments'),
+            (r'\s+', Whitespace),  # newlines okay in a map
+            (r',', Punctuation),
+            (r'\}', Punctuation, '#pop'),
+        ],
+        'in-rule': [
+            # Just re-use map syntax
+            include('in-map'),
+        ],
+        'comments': [
+            (r'//.*', Comment.Single),
+            (r'/(\\\n)?[*](.|\n)*?[*](\\\n)?/', Comment.Multiline),
+        ],
+        'expr': [
+            (r'(true|false)\b', Name.Builtin),
+            (r'0x[0-9a-fA-F]+', Number.Hex),
+            (r'\d+', Number.Integer),
+            (r'".*?"', String),
+            (r'\{', Punctuation, 'in-map'),
+            (r'\[', Punctuation, 'in-list'),
+            (r'\w+', Name),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/sophia.py b/env/lib/python3.12/site-packages/pygments/lexers/sophia.py
new file mode 100644
index 0000000..37fcec5
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/sophia.py
@@ -0,0 +1,102 @@
+"""
+    pygments.lexers.sophia
+    ~~~~~~~~~~~~~~~~~~~~~~
+
+    Lexer for Sophia.
+
+    Derived from pygments/lexers/reason.py.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, include, default, words
+from pygments.token import Comment, Keyword, Name, Number, Operator, \
+    Punctuation, String, Text
+
+__all__ = ['SophiaLexer']
+
+class SophiaLexer(RegexLexer):
+    """
+    A Sophia lexer.
+    """
+
+    name = 'Sophia'
+    aliases = ['sophia']
+    filenames = ['*.aes']
+    mimetypes = []
+    url = 'https://docs.aeternity.com/aesophia'
+    version_added = '2.11'
+
+    keywords = (
+        'contract', 'include', 'let', 'switch', 'type', 'record', 'datatype',
+        'if', 'elif', 'else', 'function', 'stateful', 'payable', 'public',
+        'entrypoint', 'private', 'indexed', 'namespace', 'interface', 'main',
+        'using', 'as', 'for', 'hiding',
+    )
+
+    builtins = ('state', 'put', 'abort', 'require')
+
+    word_operators = ('mod', 'band', 'bor', 'bxor', 'bnot')
+
+    primitive_types = ('int', 'address', 'bool', 'bits', 'bytes', 'string',
+                       'list', 'option', 'char', 'unit', 'map', 'event',
+                       'hash', 'signature', 'oracle', 'oracle_query')
+
+    tokens = {
+        'escape-sequence': [
+            (r'\\[\\"\'ntbr]', String.Escape),
+            (r'\\[0-9]{3}', String.Escape),
+            (r'\\x[0-9a-fA-F]{2}', String.Escape),
+        ],
+        'root': [
+            (r'\s+', Text.Whitespace),
+            (r'(true|false)\b', Keyword.Constant),
+            (r'\b([A-Z][\w\']*)(?=\s*\.)', Name.Class, 'dotted'),
+            (r'\b([A-Z][\w\']*)', Name.Function),
+            (r'//.*?\n', Comment.Single),
+            (r'\/\*(?!/)', Comment.Multiline, 'comment'),
+
+            (r'0[xX][\da-fA-F][\da-fA-F_]*', Number.Hex),
+            (r'#[\da-fA-F][\da-fA-F_]*', Name.Label),
+            (r'\d[\d_]*', Number.Integer),
+
+            (words(keywords, suffix=r'\b'), Keyword),
+            (words(builtins, suffix=r'\b'), Name.Builtin),
+            (words(word_operators, prefix=r'\b', suffix=r'\b'), Operator.Word),
+            (words(primitive_types, prefix=r'\b', suffix=r'\b'), Keyword.Type),
+
+            (r'[=!<>+\\*/:&|?~@^-]', Operator.Word),
+            (r'[.;:{}(),\[\]]', Punctuation),
+
+            (r"(ak_|ok_|oq_|ct_)[\w']*", Name.Label),
+            (r"[^\W\d][\w']*", Name),
+
+            (r"'(?:(\\[\\\"'ntbr ])|(\\[0-9]{3})|(\\x[0-9a-fA-F]{2}))'",
+             String.Char),
+            (r"'.'", String.Char),
+            (r"'[a-z][\w]*", Name.Variable),
+
+            (r'"', String.Double, 'string')
+        ],
+        'comment': [
+            (r'[^/*]+', Comment.Multiline),
+            (r'\/\*', Comment.Multiline, '#push'),
+            (r'\*\/', Comment.Multiline, '#pop'),
+            (r'\*', Comment.Multiline),
+        ],
+        'string': [
+            (r'[^\\"]+', String.Double),
+            include('escape-sequence'),
+            (r'\\\n', String.Double),
+            (r'"', String.Double, '#pop'),
+        ],
+        'dotted': [
+            (r'\s+', Text),
+            (r'\.', Punctuation),
+            (r'[A-Z][\w\']*(?=\s*\.)', Name.Function),
+            (r'[A-Z][\w\']*', Name.Function, '#pop'),
+            (r'[a-z_][\w\']*', Name, '#pop'),
+            default('#pop'),
+        ],
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/special.py b/env/lib/python3.12/site-packages/pygments/lexers/special.py
new file mode 100644
index 0000000..524946f
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/special.py
@@ -0,0 +1,122 @@
+"""
+    pygments.lexers.special
+    ~~~~~~~~~~~~~~~~~~~~~~~
+
+    Special lexers.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import ast
+
+from pygments.lexer import Lexer, line_re
+from pygments.token import Token, Error, Text, Generic
+from pygments.util import get_choice_opt
+
+
+__all__ = ['TextLexer', 'OutputLexer', 'RawTokenLexer']
+
+
+class TextLexer(Lexer):
+    """
+    "Null" lexer, doesn't highlight anything.
+    """
+    name = 'Text only'
+    aliases = ['text']
+    filenames = ['*.txt']
+    mimetypes = ['text/plain']
+    url = ""
+    version_added = ''
+
+    priority = 0.01
+
+    def get_tokens_unprocessed(self, text):
+        yield 0, Text, text
+
+    def analyse_text(text):
+        return TextLexer.priority
+
+
+class OutputLexer(Lexer):
+    """
+    Simple lexer that highlights everything as ``Token.Generic.Output``.
+    """
+    name = 'Text output'
+    aliases = ['output']
+    url = ""
+    version_added = '2.10'
+    _example = "output/output"
+
+    def get_tokens_unprocessed(self, text):
+        yield 0, Generic.Output, text
+
+
+_ttype_cache = {}
+
+
+class RawTokenLexer(Lexer):
+    """
+    Recreate a token stream formatted with the `RawTokenFormatter`.
+
+    Additional options accepted:
+
+    `compress`
+        If set to ``"gz"`` or ``"bz2"``, decompress the token stream with
+        the given compression algorithm before lexing (default: ``""``).
+    """
+    name = 'Raw token data'
+    aliases = []
+    filenames = []
+    mimetypes = ['application/x-pygments-tokens']
+    url = 'https://pygments.org/docs/formatters/#RawTokenFormatter'
+    version_added = ''
+
+    def __init__(self, **options):
+        self.compress = get_choice_opt(options, 'compress',
+                                       ['', 'none', 'gz', 'bz2'], '')
+        Lexer.__init__(self, **options)
+
+    def get_tokens(self, text):
+        if self.compress:
+            if isinstance(text, str):
+                text = text.encode('latin1')
+            try:
+                if self.compress == 'gz':
+                    import gzip
+                    text = gzip.decompress(text)
+                elif self.compress == 'bz2':
+                    import bz2
+                    text = bz2.decompress(text)
+            except OSError:
+                yield Error, text.decode('latin1')
+        if isinstance(text, bytes):
+            text = text.decode('latin1')
+
+        # do not call Lexer.get_tokens() because stripping is not optional.
+        text = text.strip('\n') + '\n'
+        for i, t, v in self.get_tokens_unprocessed(text):
+            yield t, v
+
+    def get_tokens_unprocessed(self, text):
+        length = 0
+        for match in line_re.finditer(text):
+            try:
+                ttypestr, val = match.group().rstrip().split('\t', 1)
+                ttype = _ttype_cache.get(ttypestr)
+                if not ttype:
+                    ttype = Token
+                    ttypes = ttypestr.split('.')[1:]
+                    for ttype_ in ttypes:
+                        if not ttype_ or not ttype_[0].isupper():
+                            raise ValueError('malformed token name')
+                        ttype = getattr(ttype, ttype_)
+                    _ttype_cache[ttypestr] = ttype
+                val = ast.literal_eval(val)
+                if not isinstance(val, str):
+                    raise ValueError('expected str')
+            except (SyntaxError, ValueError):
+                val = match.group()
+                ttype = Error
+            yield length, ttype, val
+            length += len(val)
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/spice.py b/env/lib/python3.12/site-packages/pygments/lexers/spice.py
new file mode 100644
index 0000000..9d2b1a1
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/spice.py
@@ -0,0 +1,70 @@
+"""
+    pygments.lexers.spice
+    ~~~~~~~~~~~~~~~~~~~~~
+
+    Lexers for the Spice programming language.
+
+    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+from pygments.lexer import RegexLexer, bygroups, words
+from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
+    Number, Punctuation, Whitespace
+
+__all__ = ['SpiceLexer']
+
+
+class SpiceLexer(RegexLexer):
+    """
+    For Spice source.
+    """
+    name = 'Spice'
+    url = 'https://www.spicelang.com'
+    filenames = ['*.spice']
+    aliases = ['spice', 'spicelang']
+    mimetypes = ['text/x-spice']
+    version_added = '2.11'
+
+    tokens = {
+        'root': [
+            (r'\n', Whitespace),
+            (r'\s+', Whitespace),
+            (r'\\\n', Text),
+            # comments
+            (r'//(.*?)\n', Comment.Single),
+            (r'/(\\\n)?[*]{2}(.|\n)*?[*](\\\n)?/', String.Doc),
+            (r'/(\\\n)?[*](.|\n)*?[*](\\\n)?/', Comment.Multiline),
+            # keywords
+            (r'(import|as)\b', Keyword.Namespace),
+            (r'(f|p|type|struct|interface|enum|alias|operator)\b', Keyword.Declaration),
+            (words(('if', 'else', 'switch', 'case', 'default', 'for', 'foreach', 'do',
+                    'while', 'break', 'continue', 'fallthrough', 'return', 'assert',
+                    'unsafe', 'ext'), suffix=r'\b'), Keyword),
+            (words(('const', 'signed', 'unsigned', 'inline', 'public', 'heap', 'compose'),
+                   suffix=r'\b'), Keyword.Pseudo),
+            (words(('new', 'yield', 'stash', 'pick', 'sync', 'class'), suffix=r'\b'),
+                   Keyword.Reserved),
+            (r'(true|false|nil)\b', Keyword.Constant),
+            (words(('double', 'int', 'short', 'long', 'byte', 'char', 'string',
+                    'bool', 'dyn'), suffix=r'\b'), Keyword.Type),
+            (words(('printf', 'sizeof', 'alignof', 'len', 'panic'), suffix=r'\b(\()'),
+             bygroups(Name.Builtin, Punctuation)),
+            # numeric literals
+            (r'[-]?[0-9]*[.][0-9]+([eE][+-]?[0-9]+)?', Number.Double),
+            (r'0[bB][01]+[slu]?', Number.Bin),
+            (r'0[oO][0-7]+[slu]?', Number.Oct),
+            (r'0[xXhH][0-9a-fA-F]+[slu]?', Number.Hex),
+            (r'(0[dD])?[0-9]+[slu]?', Number.Integer),
+            # string literal
+            (r'"(\\\\|\\[^\\]|[^"\\])*"', String),
+            # char literal
+            (r'\'(\\\\|\\[^\\]|[^\'\\])\'', String.Char),
+            # tokens
+            (r'<<=|>>=|<<|>>|<=|>=|\+=|-=|\*=|/=|\%=|\|=|&=|\^=|&&|\|\||&|\||'
+             r'\+\+|--|\%|\^|\~|==|!=|->|::|[.]{3}|#!|#|[+\-*/&]', Operator),
+            (r'[|<>=!()\[\]{}.,;:\?]', Punctuation),
+            # identifiers
+            (r'[^\W\d]\w*', Name.Other),
+        ]
+    }
diff --git a/env/lib/python3.12/site-packages/pygments/lexers/sql.py b/env/lib/python3.12/site-packages/pygments/lexers/sql.py
new file mode 100644
index 0000000..d3e6f17
--- /dev/null
+++ b/env/lib/python3.12/site-packages/pygments/lexers/sql.py
@@ -0,0 +1,1109 @@
+"""
+    pygments.lexers.sql
+    ~~~~~~~~~~~~~~~~~~~
+
+    Lexers for various SQL dialects and related interactive sessions.
+
+    Postgres specific lexers:
+
+    `PostgresLexer`
+        A SQL lexer for the PostgreSQL dialect. Differences w.r.t. the SQL
+        lexer are:
+
+        - keywords and data types list parsed from the PG docs (run the
+          `_postgres_builtins` module to update them);
+        - Content of $-strings parsed using a specific lexer, e.g. the content
+          of a PL/Python function is parsed using the Python lexer;
+        - parse PG specific constructs: E-strings, $-strings, U&-strings,
+          different operators and punctuation.
+
+    `PlPgsqlLexer`
+        A lexer for the PL/pgSQL language. Adds a few specific construct on
+        top of the PG SQL lexer (such as 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≺yK9=%m>A{%rFq*!W4%DsfnHO8!
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
z
ziV9%{!ix~Pl8&wAX{2LcmyY#@dEVo4g(GZXR$Em|&(#gzq-Y6)6M~{lxEJ0v<+AZ3
z>~^dYa!bNv^?=T94-9{2eTlRtBQ02-ex+b$8m)Y=e>j$00^f{-`4ZekP3`dVF{SV7
z_%7}Rix$!Oa<0b@4`n^)P$fQRbsf6I4wd)^I7x{!g>;macm>~Wpu_=|cr}VqtbDLM
zd{mU6Pa2M);LqqRjV3ub^=2ZReb8wJyw;(RP3G6YBy5FQjqnVlaF9juO9{l`giE7B
z$oG*!S-br3vt@^D^K_AbMH=8^G3tIM!ojYh!Ht%Y;SnYWX49OFveG+L@c+<4s-CK)
z>h+x4@GX7VlZhn835MAZ_ezfNBA2&Iqgr=_qb;M@uUJcO63OI6TuNx~G)Be=q>WJm
z9muQ%!%?T0^Fm_)Z!+(|&=$S3@OG2?;UZ2HM2wPgqoUC>_};<(@V_+~j!QdJr44j*
z(zd=c*6h|2K~Iu5S~L!VooBhDwN9M!FT9ROzr&?G+UkxQ?)peM4#NEi66kl8b=b%r{o0Ucx$b|_2mv%N|
z+)949KRsOOZlv8o;ec_K
zl1G>MI=6+yYgfW|mY|N%pY3dXR7lJOdogt>B&OQs0C%vfPuxoU?q1icRAk(Bc_C4C
z-B2$s@beSaeR?E?_6ohG`|9P6hqK5~+jKaefE$ypZ@B4-KvU^7n?w&iPN_
zhe=s-2JzREhi?e4UKn+PZvtNZ02s|C;MFbP7he5C68{I_)$h0jn)CkzUj5)VsK=X+
zSD!Ou3tk;Nt2Q2uZR@`kum0YT{w;X*HD8k{_)o;EJJIcb3a?HJ@A>b-s~6oNk^yeY
z@#=RY8C&q`B0k{&jV*Zf7QC97$<2XR@6Uk!KM}9~jy%a|X3xe_Tkz^h%qnlet2Yl`
zomwLC8jM%(W6uW+P`vCGyc%xBL;5XvHL&y+ym~0S`Y8~w3cUKSbT0tTb)W{eKj%K7c`Hg^#rbuTKAa@ams`S1qvxuMRgqUVZ$Josd_+
z%3g$5PsRKX!mBSewP1RO`PWE8Dn5?z>ajNtk+JaVj_(ZhLU?t{M}=3{2?Q_4tNXw>
z2I19D@X+w;Kb|*4b{oR0XZXRNb%sVNf7Df}eAm+CjP~HZGL<{MJ{4RtAK*I`9JSQ%YrB*;RV&)ABG!b1<}TzWd02a}Y+51l0|D^_
zq!M`b2EC{gTMN})Hj0J{h+Jc-)*JaW3G_sx=3HNUF_#hU+U+lUhD@C
zrWBf(ze#oCSuU%Rqac!B1bW)GvN)~KmGtwUS{+4*B#%rUmHb5V=%a2HE+3Kf7@vf5
zjQE!diKk7C$};HOu8{bQ(QtGBA8eN4WIU7-!oMiySCLP_ZwX27p*ATv)f(jID(~FX
zIzKqQ+Yf%;A!>6IvR7*f-P9gG$j`LGvzmN>kMsC}zxzb|?Sj8u^@YTUD}-VxeP4U-
ztW{*MD0JFk{nRWG#)oPKY>A5U^KDDTd$E`6t5P}3GINg~7^hM>D~Z?e&dQEk%+DEd
zUgjriimo2m3&9U2X}4#tRV&<$G|i;RKJEuoFK!QhUuv}63>xOBMQXR)QI|&h12XCS
zJ`Sy{^_w65{1@7D+xyMWpS)dr@QK>Kny*p<73f;pp4&PVK=V$!7CL4QZqLWh8Q7l3
zY^Xge3EsYkRy`1QEb@cj5kfoeo>cIXKla(R@7q~(%-i=bq_Cbs;`MJ2D4-Kwe?dby
zrk{RaDN4lV{o-4C!&K8r2(pWJE1oyQVuU+r`L$NF3E%svQcfq7j+oIgey|TGY;z#m
zaei(uYgs?I!s6mmT3#@Qm<*v+F!l6m0j>{pYhs9;`pjUusfH4T~+
zuO%c)3^?MbSl4c*>^Vq52e>T7&y0$1&rfe4qL+xxl-KsC(Gi|Za}mFjzq(;5S!gO~
zk$%fp7VrTRnviw1y*nts&jGwva{W`>!01BaP$rVvk3DSG)Zmp=?h1>7Y#)pG!_a%Y
z^JI>)_e}Nt2intTjIQ!BC&M;PE{;AZKXOMzB^5j|?nUj=-n6zVA=SOY%F+h?O;Z&f
zaWE0#ht(aDAGsJ-C3B~+i|mBs}~5tzH8xh5u1ALjV4(enJLp~T(k3ae*OxRh*bW4y&rx{l}89U
zeuOe=Z-&#H3+r9byW4W+g-_@{y{hKaUA=4C;BRZTDpkFY!
z;2^HtP7SKjJiV?>1v@n~_F}B`s5aI7xVE3@N{cmaZ#AXrpl9(iIyj_|_!#fP=eSfo
zUz|j|c4m87+-v!xf8NyG`n@(v(MDrRiGt$JfY}LZCM3hngnZd}bN})`_C=S838=Vf#(vDnq3
z$~46+M|^yL?6S4*+EH&^Yljm_I(tzH4RY%E)|+!h*^d
zSKLXDG*xpktGV#=i)+X!g_;DvE+l?$UAN0M{4U=_@muZi
z)UQSmk@&ENNV#HMS41B|(!sQEbzAP>2EUmFJl92}EQKR1Yw;F_$kl=Q1((%K4n|(4
zbxx{Z9|51D@E)({GBm2VjK!OJ?BrQ!%wm7+@|3`}xi5-55q~u~cMAYJOZ))&k1<2i*}w-*X(ol%hM;`h*Xj?b?5lRjnw;
zPF^NJsgvXDD6}ekmX>n&*x0#FhKR6I&mRR`6%wylIE@nsgo9MP46Ct5E{|g|ttE%M
zD2F#kQ8-troTLk(6<;aHcif>M_2VrrvWqxV9kJO|NCfs}Y(7XXF1P6Pn5OVv6D`XJ
zDvAWVEDDK(%L;XLevbGt+1uO>!Or26);V-T5$%g}lRK=2r{ArR|KM3i9ZXn3yps($
z94+CWDcse$wa7PjKenic?*6$VpDnYg!FuFK+W8~P&$V@URFQ`>$nTfdB1_3Bw^gup
zIG;yJIz$NEmvn{1LOHjC{JYF92m$eMUmD_N*W+|!FMU|u*y+(Ac{NopI)`0^Qe_qo
z_2G~G{Jyg$j#M|8W=K1(m-7sMKu1W#*MRP_D@~dUt&Fz~Rfd;68sbUwSxfVR8}#;X
zj{|S5$2wN)Sx^`Jw5XG*pwi3kq8#MbU!)QkSU&?p22tW=U(n5EBAiSG2epsu}sf~^w4(k?$
zz4DB=j33@${IKJfH`n-~w{{c94+kJR|3%}6b?1xR!Q+R;@Bfb(KeTNv4gS}UAND;}
ztQmUz@HXCU#__`$`^xavT=s7qKRhx*T>g(3KYZhKG5-JK@x%2CoQ)XZcm12k4|^C@
zf6w?~I|Cm!ar|(`@PE1#0y=+Ryx#P>2U^c!K_QA8vi0YJ8BDWaEbxY)v6CjK4#SAKrcP5LB1O55dY*u&j;03}0EI-RTwfI3{b8
z6B!Lds|tI3ShvOa-*~=?xxGcn8BFY@7$~_3D?eB=-$p{G_b^)$s`g{Ap%&yVQB8}^12FucRaS%dSNQ|Rz`oz)c^#^$8T}gbH=186IxS)kom6eU#aETl^|Qe^>TH<%{Nf@BTG`xZSL=|IZ4S>VBpzKjs;VCh`k6xFJyh88_|U*SI`=3f#)=&k
z8TS_wb2H-6&HXF&=QQAo;5aM
z*fqsZ-!g~wxn*-}!kygG+y2X9d@y+fx>nWyRUHMAIDh`YY&4(!RXw%&%>c~fJAeWu
z^8o+-{FFL1fX(~QU|REUHun!?hgv;dwo%$~4Kv$=JN;m5zi&#dSlTxQ#iss_=cW(+
z`P8yld887U1EVy|&@o?Rcx3<8BzFCc!zZ6EeeWQ~ukpZe?@~>llLc_fAVqe9|H7yB
zutM<1Nbvn&b(!FE{)6F><>@-x3W=LcPy70Zd5HN>NuttL8(%Y&)_>Q4tnUKN+wXtW
z8~;j*3;ltxeK@U@5G-%;^au5nHH`ya$wokx~Qm?
zm(`+DEzV8s{P6O*F5-MofPHV{v;ZK4EI`YjyQ>{dYxMCeAm3V7^$t=qI!4i*28>6xhX8_E5VG
zGM?_W8{7J8LeGh+t(nVA!%BN`bwf9WYfHs3DbRIauV!X%t
zLJRIjA@PJf#DL8i&vv;gEM_144niWvS~_#xQlI6>Jq%Hb+Rju?jcHa-FJN|facjfQ
z?5n4ZJ(xjX3}yPq_AR%nMzzr{EKjj#plZ@Hx1p(xuE6#d+MQ3eiCgv>z4ES^+px1H
zTN~TPz2-ObEi>oL_$kX|{jK`6#mhW|3CptOTH0o1P)3VQN#)09Rjj0hsE)muN8T!#
z>#AaAdund`@q2ig??}%;((_`f7A?0xmMGtjdEh3d=l7sA
z_A!k8%a&FQOGaZZ`))sV-W_Z&^A|pg(==KdX*I5z>OiLkxz*7QD9YZ;{t3MfA2;Q8
z`mg#kF=ceTHZj-PTmzxA%7Qq?w|SWZ;KBGqyv%<5x=hn+_ZUC@)UWvY#IbJ&M7*Y#
zEg={B)vF3?iu1kk>VZ$z=p#0SGiv;bofl8y9lJ5H6IPSa>1BRT#feX*yTVlGeNa{JJY8*{xf-4mw=f@x6$Immp&%7q
z75iZ1PU7SZ(+E*)LrgXHJz!?=6e#ywT4^dI=nDt)b0(raC-eKVU74v$aR
zM=)bfZgJ_xYf3+GH-_<;ve@3(I7IO&GgD|lV^zg$cy+==N#o
zunn}>Ps_F0+0-ta!XG0wJVJe0WItoB&wndbb^9B6nQ7EJR*aTpGy684Kp{Ly<|5^h
z!WG%{6K4Gf?Tz#uT$!l+>~R$B1Ty>v*UAE$*aB
zvAiXJg>>WZ4eeBhYpz0Y2&UC;QvYP9>kbd395Dm%gRi+%UIXr}w^Q5Vef
zZYk39t=?xBt)_yy=vfiE$rK_;m~=HXJ6ibC&xxHOw5UX
zruXt6{_wrQ-OFBnm%nWNZev&GYg(4A88((EH$0r6!-ie6W}j7CTNA!h-xJeL#I{84?F%{$Fr@=
zVi$HpeY*KXl~gMf607G>$#WZS;f6|*ja3rg;bfvnFrydi1^w-uAjx(@I9^nvt|pwp
zTitG=L|H`;k2!PrGi$yCNHySho`~dkkqY9sM-9Pmw^~Lem~brRMy-979+qT74c}|8
zzTx%_MpV|={kbMj5|k<$-rD^5?ZumoHTcM*bV^QUK#R8#VV3=rwtcE-@(UZmQzMqFdu57)YDhlRT-kD_X?2q$4fHct!hd_1h$Pz%2}
z8{gG6Ep;}lji4jQNDKaYz&(|9DGV^(DDW2Z<%VA*#|
zP_p>Tgomw4&cI?2!uqhZM7z{=$jzElVH?-(s9mYBg&0EQO|pc+Aigo%23g7OL#k`S
z{jCO@LvoJYnB>$Shuyk*pxt6$$Lnp|u2jRUNPK3WwM}2Fwh|BI;rm3+VBgu
z_1Hg8-tajmVS6{GYDa8{!WY?*ZV-jRn0NpLGqlz9XC@&v!HQu+_(JwJ}LOWA=z%WZ8y0C?nJA&t(~0&3iDxa(Jq>=?T^}kO*awHQvrSe_risT%8sDcCw{Qp=Vfd#eUDY6Xi=OWTh!7DezGv%nBSr4HDasU
zgL@rcXX444pW_OYaG)HK(-S;0HF&v@*ba}K^)o=o-1SJw0-tHbL^UT!+-!-qGUqq*N16}eMqo~v+=bD$T
zsl)L(pelGJy|M*`ZaVAHn+m;!ZB_-<;Vb>3|DWghu;VvM?ITAxXTQ=eo3lUPDA*9a
z^^V?0VtNlGb(vrB!uDl;#Y^FL%<118wHd!L-tS6A1jnCo07U7GK1p&BNl2
z`e+M2UNN?0vad9}+{s9Q$KCDKTN&VfIp*2y(GlQaW(to5eT+?EW@m09mmuG9TzY+*
zmtuTv1Jj+t6=4j2Wbc(HdV^4$@C7tD9&mMppX07Ac#XYR9}17Q7LHJrU`4pVBs50l
zhEdc2xBK(zvDBA7jh%~tmOG%+U=}i5Takewo&yogw^^qbm+>ec4+5qR7dTKf(LW{$
zU3hD-whZuE9j-9%u?!Kq%*t-Vb{Q1(u-(RWTOL+ZZ}C;0ai=|c6s
zwASQ9-5%YCdJ*>Q;u-j0_-9g$dnl^!F+6mzl2mkXmR&TU%TkykWU~nNy7!Wwf(>2*
zq4#cFm7ln3{5IY>A2insUgQoM-J1X8D!+N9mwrSo9IalA;KTe*7bNpLO~-i4cd%5K
zD^(Te3VE4>)J|%Y@4%^u$Slv2={w84$601DyN{`UExZF%&d&kJ?BBsYRX>H`+%TBy
zWo-LvvdW%Iim3BF&l1NC_7^1<^vF6y2NCYVPn2}>_mIE4kRVYrOM?}(GnwY#=|zDEvl#_GfI3KrEAq;%eaS19>QlORRi(Srd3{MIY3}C
z{Tjpz6_!7c-AyWT7(OUoC?JGOQxMphC0IaWf){fcyhd3G@IEAq1+iZ
zfrx&t9Noab3a1$RN^-cP-DhF|zQzIYnU6s->)&V6`5~Skw%T=$t@LL)zo;gKu804u
z_CwNDwyh>?Whw1L;cDOt`?70A|Glxwi@0|fRR+&4D8aJ}!e0pAD4%NTYwgkMzn;fb
zKty!7y}0vG_((DFxQAS_V@M{foE@mKJR)TK=qo44B5VLRCzkv7rEHtH0Vu6Xhh%F@%6*U&1e?Q
z-;vNH9)}mvc!k8ASwzJ!KiwX@7>Ap%9^Mwxr=J8WiBViz2E#IAO->6`)pRps4JLqy
z401bBXyoCuQ2x&cYfAV5i;-BeinOI!W(|0Yv&_eE!$~c<#H-eJ`|iT@FmX&rOVV-u
zCtBK;x>SC8!}xZKs#4(4crv8)7rAWJB}1F~Y7S#s6)fwT5BKWq(3R*Uo8GReO}BSx25p#M
zJWnN9n+l%tce~Hu28WylY{eBg%mvC}-^1)7A7BB1nmg0z5
zXIt04|K!mp@0wG;E>rqB+93d{}X%=vBX}@e=
zZU53r+7#@xD+8@UVje?*cz$Mcw|~moAK={2ZCd+V1kk>_5ZXZd%gx_}_7|)X%fK78
z|K~T@{zU)%pKJd^t^FB{ykYx;Zf0!eM_Rws^iCms(*=?+>&r_wfF!zu`@Oi=7*dv@
z!YE)yCX6=aUM@UatK{rxJesf;Yp}{jrN=i^T8Sx5cfWy^VDphEme9+}iZY&^GssFTie20?`|!OD
z*oXN=`*6~x*$3^u;LO8L4gKGibtus!>rmAp={S^;NohWu$+a;wsPjn7<`d@&J4eFZ
zoy29a8_3>GB>Aw{{ZCv^$fZF!j6>)rqM!mIsz4c7mbv&4w{B{Pc+>g5cBMhsa?zw#
zuBFA_f5dXS7Ol&cn9-YG-O$TLS*X)-4ReI8tmJ9ZyYWuYsPSI*L?lbV6yEfNFB56&
zFn(ew>xoYWCKrxRQxm;Z+|;KimA5#l>}w-O&TG|d1X5{VXvK0plGib=w=MHnis)6&
z$@?P-6dBvf3+(^>so=p@N}8@6c7oqY{0QJYl3oaoS@*@SiF0zgI6AW^;$T^4M6#DD*>%>ebD+(P=l+-QSfJg_cuEDY7a5spEg)=&glIg5#
zc-q?ZXy?aDeOPO-Zffvw`)>EQZ?i(8K$LG$JRc-EMb1xYUGsBgo!IO}dBtPeLAzZ)MMzUaqzEf?6<@t7+g2V6_&^(bflM
zPAIfgoX(>y>cc5ff4Q7`cv*Q@{W;d}wiA!nu6Vo;ls
z&h|oL=cy9DZp!9+WX)QJFibc~?^$AR|Boo2=+q;vV@(A+5$w%tZo_#HP)PjG;pMtw
z@xX`s96KwQie|H@ziC9=ueNFm>0l72umNqk)2Jng}-U*
zbj{l<4T35FAGR~kjaJF&YC!|`vf+X_D|WW#-w$k?Lg1HvM*4gp7`ucP-=I>=_rmz%
z(`L3)YaA(4s65L;#kgEbhWaO4S=XK$-UlhVLnEPcetYx1UgiU2;O9o{eh`LoK|{*;
zNQhs*=%1%#9g6X*4S&j);wSz~i#xP3ctk7UIk-~0%(P^BCBQ-saLC-bsON#^wFXbe
zj&e&fw~uU?aM0ld+3~7*txi>Pesp8y>qf$avfnfS*ZEdn`gQV?uiqZgm`
z2}oUg^DSQH*WxsHqjOc71=d-}HZokiEbMXwxf+n*KltBAPmGrM2bt;0ow3Uz%g<3Y2HVIQ3H>OO2kR>EhQ90%i
zQ)<10yir2dl*%2~(9|Bh#`}~BT>Eas?UJN@8zM5-u*p~o`Qm%|(r))2@`>DT;(TmE
z;9_VJ=h8FJxYxV>fGoz8
zETe6QdFE!1WVwD-lVN#JT5@ufR8M4ACyMI>U^8uUm~Ge@%3A|cE^<#^J$H34X~Rb8hw
zq1s-iiD4z!>x*G!ylVMmfgw|3&1Sf|PM|
z+-?kv#_=VuB5!y^~5nYt@JY5??Pl}jz-ZO$})qi5=E!!OD3J}bEThK
zEHrE+-6F<2HrDAVeqo1i$BzjcyVd2|PHOrCqui7H$P{^*7r8WGPUEPDk&ejj%LqvW
zS@B^Sc#4UX?1+?*pkOqxOy4qhVwSucvA4mpXp%?mKNCmfkFuK`8i&g&0@h`FO;=+j
zl*uk_ujq75is_Wl2BeWyZ$#^)Z0Kks%4Px<>6#Q4S)8Ld@opN(X|L2(L^e5HU60Mb
z;#jn4x0Qnx6ZHaQE+qB`4L3L3<`cW!7`@CF?}~NH9G*VPQfUOWcK}4Fj~>^H;I&kB
zj>7!hV6SDP*TnN$sr=%G@A5bmJj(~NPg8@nn#Q`COZ6^#sefEv;jXIWp}Vvx>L=$|
ze)<4oadi}?>bA>?jK>UoI5CEBgL})22wbN1;>oyryeT14VrYwVnHcadZ>`6XIGnaZ
zW(@nS1>N0?dpjb$wP}r){gyzK3;0uvXDo_gT9(=QB$_;hAhIf{qzrm2GLgFx7*s!^ro=D8E
zK+T-4hVLiGlK&2udm=6y>J+wN51^~8@yh#-BrK|p+AaJUIZ17PK!Ndiu~h%-s6;V7
z_Z)8GZg^lXtx)$bfYO#ey|VPFbzsW9dLVWNmIu+NP+Ds?vYDSLJuhn5juAZ09
z>wCkSGp$^5;M~Ec*{$Z!Nwu}=OE?IZ;p}pL#fGCJd=>a}cG14bkYGQ?BnR7RRf
zo8X2?TW=H-F)=vbbahcTYDr8rl}?HM-JatoB`2;iwapW9CF@PoQ^D=(fX9$P{${-z
zw$a~)hfxZr$bRrF!v+Qq%-2Wqdw6pCU}aFxxvC`a;fpY@h^Kymn#Jv<_B)h&ej`!Y
zo;x>H@f(x97=V8-&W=O;vjMr8A$^`o7r)GYna6H@TR5-8Z|8q|>0R`_HOk`N@J8g(
z&-qLy_)I4BlTEHVcF*&Y)!<%Hw$PFx{e4w*16AR{lt2shOmCQj)mKACXcqmSn({o-
z~DTUDY5_ymu6-2u*c
zb%ck}CWG7z?S*<`i%b_NWk#$~n`FPp1&0BT;HQxI-hq_^5Q5&O)Wz!oSsJ*4C4pt$
z$m~TdLz?F2PGT^?vckSPKiEH&`yW63ns@5H{H?|h$v)L}kRO~-yP{@qb7|PE7rjb)
z*T};>p|)pIUD+Fq?^?H+VD_w+Sn_##bs=#X@DeG>o9>j&e%z9~6DII9$9m3+oU4-4
z*?yRnQLl*_py%KE!RcUtFLrI?D|YTc<(mGRcj|upt?qmqvol=>v)3)uy(^}!o0f~|
zJF2#)4f=}jAY`?p@A+=gcN+9vW?>{Q83R
z$OHMczmYSDU$E$J-~$uI;?+mo%y?>RYscpGog=ACVUG_sYHV9Ys~KPX{2^3you5C2
z9~LDZw$5*Uu9N*gaX8WZ;P5(rk%q(h&*Iz`99uSzZjsbPaYr4ssr*D%^Q^Bu`2)!p
zduzPx=_DZ-pz}8GnvS}j!|QlDtn=Eopm(D8i|JdvK6_#?z4~=!+y4XT>!@qzd|?V|
zWzlCYH3~=}wZnQpe>lrW9$oK`y*pXGvVH9B$@H4_D#TlO0)nkO)`SJOrI*znl6&X2
z2M6!mwzYZL=bs9v@|HX)jVveTrf>DCisLwQ4vO5Dccre+=$B|s^Yd*~^?3^v&m900
zYW>`YSn=rRC)IUM@SE3lGG6VX^|ej(3|>ytZynfV=V#FnKR5`Tnq;g&-dAj`@k;Fx
zwvV+weusT5Nhq=m?%c^wzf#@Fs>DxzSaLRvQY33LkmQ}E82y(x
zezOQt`(u08Y}K=MoUH$WqW|FsFB$d_+jq>!4ibiRUlV>kWKUUH*kf;C-njj9Bc4r;
zs*>3F`7=vt65EjmZ}*789@X#1hLq)Z*_46#J@V1=`~uz&&hL8Cxcq+dzOwu*VeZTp
za7FODV3J?Hn38&y-hY7iEShaOLQ*_}i3;O~-UE4cy(h;4?DYkNJa=k~&ItX}v{6-k
zlYCmdP@W~*Op`|;am&!Jkw<9RW7K{|B6iK)Z&kdX2D};kjrQ7ZTrUlVL&tQwQ0vpk
z^Z}^iy02HIl4jd+_mtLsD#48eZQ8Tqeh(YX@0>Tv@1()`sUeM@w~rl)pV2~7WM1J|
z(8!?T1)Sq?5B2Y8_*Bq(3DRZT$hD^I
zCFRZgpk+^a-$d$2@dH`Zit_$IF;?F1K{=soKzZMvtk){<>M@n&IeHFbW`%sGD4ErA
zcx*S^P7ik_rzdfPg8N+Z_mDi5KY32@1WSVX&f`10$>>wgN2Yr6E)%EhZ>NlI8$(Yw
zFA7eW4vw)feUv%UK#jh^j2(>vRn
zdz-hzqJGe|Goq1FYNI{^tdD;bfj|%dz?3}*gx3)>rL^!?12f7
zb*9qE5non^-Zw=^ihczJx>oL+vc|6IlXTgBlMS|XDe
zHFe}?l*p4k!nQkK26^4hK0aR`n_S`1<|eh!&Mj6-(AJWh#GQ4MkrkJ9D(QD+ejhnZ
z`Mp5~xIpInbgKxRRB~!laz-kDQj=|QU_B2`YR=ivBT
zOw>3c4DG0;vDtFSw#a!EBSX4E;;rqfVp|KoRSWJ{OAebIOlrxsal?f#kO;ElZC~C(
z6Vw&;fql|HP%bU9CsSI=`RNq+Bd$>oz!%>XefLOSuJ2p(UAexWvu~s?XXB@ARA2sp
zN!|?l{tseAhyF8cWKAdChCr93
z9eY*S<2r~dJ#zZ~P3N-8A2fa69)`Q|&k*_^sC)W{_5HVdO8!QCLlW|L>-+cju#b<{
z$D2dnw|bBA`)}6wdl}r=OgZ{KTGlJl_mOsuzP}rT@K5OblNuZq&E;Ty_jA~z=ELhx
z21HSBu=R~{p9>vx@Hd$PkpX8njh9x(e%H9(GHZc6{{R~Kb8y~lx1eugW!X&cP(OG5O3{=%VYI&|2nhr7De$<^F(%tP|2>xUA(BSP*pbOz
zw)n@cROP?wzx1+SjR!-2MOEDRy6;xCPyZ9d)nZHy-x*x~t{W(S*=xf@!=wQ;9KOjk
zEb^oBpDrXqjNu}c?PatgpWYMKqWh*FQej%*Z!SuR$m1XM8Vl$vo2S%z>E*i1cMwx@
zIP>N$geZd#b{@$@_+iANcv%H+bYHJ;;LD`Ct`D)^?WA5mf1zeu{CxUyepaM=`CILc
z;<%e&+GuZw^i|wjLj1s9{J`23<|0V5d}O10
zQwPUSyDzf`W#?(7pHzHrP2|4e6^-k4(mItnmvTAvbstOIlsfiS;sO5EXuo-tx9~>0
zxo{~wyOzsXSveZU_a<=)3cCr;B21h%7-v(DXm=wE5VN0TzO1PKPUXGxE+L21vFoOK
zSN>J8bGe_bA;(nidO6oDk82?aeE^^K~$TA?rFv#?M_YN1pT|H$ItRt<8QNYe(Le41rHQsBT<_nh2NOOC!2<_d|PAKDm
zD1U#ew|D+c;wEEi4m;r-2HYDaG5{{v6GqueL^8|B3DT`XxeJZR;Zc?C$JOsS&f7tj
z9FhC#6YVVXMIH?{1;+XfngFt3p~|5UWJuV?@pSs7>90u5lD
z(b7QH2ClHT-0^6{>r
zC5WhIRIrn2gO}|#uH7;^9vLK$F5=};kA=jxXlv2V5wFu1g&$Qu=pQ0$QWTvbH+Ds;
z`7iC>l)o~pWY&ZIvLMzEm?QiR4V1hQ<}gOwoAEM?Fu|lv11CY*r_P*Zq5!~DobLl)
z7Bn(|+`DO~9Q&V47_pOf+j|5&rHBKuO`*vJr{sKEKnO#A$;F>2`HY`L>@Qh&HEA`S
zs=X4GQqx2hH&#S30!1HFqz8{MYFnyAHW7_aE632WU3zziMM
zlT`3CnSpQ@Ci$HG`+J2p>@Zs6A~=g)MH-{(ltVFSq|4x-Yl?IcZ01|8KLK
zO|kzoD(t`F3kKQ$Kcf(-W7lH;pX4OWm{XBX$^O5X8v8=3d7X5=%HOE{*Lha$gb1Gh
z6Y{jks&1apmzd}{`_DmSY%g~G8Zu*3!0%b672SXga(0$|cTg?DzzlL^CQt4h_muhf
z&K_*Q{*N7K|NCVB3)uhdtooXBU7i|yyTX8%y*`Xr^aQhbl_Jn+ac_%yf+lX&6ExZv
zW?oF`N*#e;))72NZKd$^S>T5@3UwX9$Mv~&1jnLfo6--|TR$LTKgAc&(%Jp@suLBW
z59ov@*9W+*WLwqp75xA~R{vN((1p5!hg(lz)_qV_=9L
z@~Z3!zGiHz=n0&iFSD!CGvcqzuBKs?cmDSgCC)R|Oxu9`4kSM_)gNcEH0zf@9yiu+
z5NK@uhB^0~ZM7`qV87i(Q?V0K*H2EbyiJ8gj={Rf4kPzx?qX7;;|Igf(4x*RYWDp+
zTZrixFH=9D7qBki!2C{EMP0zEQWu~h1zo_etz+tz+PH4uQdk(}AN2!997fZ11bda<
z$0NVEAD!#^(QVAOwqVIIjo;c)eC;#k6-O)W{tj>*<#l%daCOeZTdLu}1E?9gN)AYN>$;;W+f2*!PJr-i=S4{UPk0
z{m0(In-k)Gr4a53_0+ZNa+$634z>OSE_~Hx8?u-40IE9oFC_Ndbx?1B;-3hCI_;~X
z@3;s0JGT@4FA5jRPk4{rgxpY>jGD13>Khb2@?0H%)y^R*T-sOr7Q-
zn4htyg*~2md(r=i4HojfLz$G2gn%_{LUx!`_H@ZG(8H
z^KgxSSH9z)<6i+&68Vq+2>-s!*!zw7cRN@o{Im6`uS@JS!vwtkTS;E`O}((D%FEoz
zUoiMOaI{)BR?R+i#y0ZXGdqc`%`ABMisT}>;_P022t|GT`J{J-9Te%t0PVxizKR#^
z!C`I;&>q-5CT)4r+hH4GaBp**^~9v#rZjeLx_NoW%L4ZJ85I>1wlbaP&2
zBRQ&0raUIKN$>v2#c4bdUeBL{YpE|wk(Ei~YGNJfKW9nTP0gJ&x_#^mU6ZEfPny$T=j;|W8hdl+?(I4&mVhb-J(#9Z
zvLpBuoyXJnb+Lx}p|1D0^?YB0i12SVKEMPrB%NCQ4EoGI{dmBsvHer4Ppa$xw&gph
z+63@ztj7II3yE2py~s~!-+ClHX(92fW?>MIslltRUXNkE3yI_3?c}SSoq1TVbAP#I
z8@&Pf!um$?r6Y1B4>@xxVl9ZA3xbQiYp|w6`V}_ZjE9&xgJuUxmxcs;#=ftN>enf)
zHFxY#(v^mn^cHa3W@;bPkieu1WUo@Xx=9)P?VT+HpTHqr=zUwvQu
z*!xrY6Xx{q82Jg+IQ1*YBR~EeS4|VFU#XfBtP>?z52{z(x3%XxCRh^NVtoL%ym2nulnA_-Qi}m-p?#FJN)R(MsLfOAR@k>y
zSSvqwk!%?ab3>TLDPiBF
z`Fg<8gt2%cBwJvg_Zf<2Z~Dx$k1m($m+@3z`chr-FVZPyF;=?=WMWFkkIXMWYxpT7
zj$tC-RyIs(a;uALgy<-V1zR}#S2^GPiD44M5s!ex)6*-3i1T*P^l(m0c2#TZFq#!F
znwvDo?`xaIE6QpkEP2vA>O4pHD<;k3*%IYKW&#O&+UDgZ&F7hJB3B}4LyIS|;l`4s
zJoJ8Xq3Y=ed6hQqw%NfF-Fw$uDD8`R7ql&)`bwdHW%D_+gPf8_a9Gb0eZ;qtIjSy7
zdY0Ht?m|f(&y12_iQTy|583HX{~+pGe#oI$cYSHy>0i&1Uj9;pmHfmF5-iaj4_EO+
z!{TQ}Oa3ohtrvYZ*5FF{+LH)XEVU#r*64li!nOM8OY2Vmco99(kN#1B1{FGu0`Cr8
zQSImj|HI-BTJc)q`N$r^bmIBQ1$NDR=H;f%
z@0m0&*ETn_WsEoyPzMU5Ou-NmpeZuwl+-7T@7
z$hi$nwD@kRrCj2EtY`AB$zIAsBtkzuCY(`=_n3zAm70G*(+3W#%w?_FD_cJ>J?6VL
z?mPR51Rz2-b6IPACj*o%vrY~45Q22qvqXP+C5iuk?0pG%6jj=8A~cIKHV(9cqDBb{
zt}wU|6-^|8Y7L44Dy}#vGH#%BD~=*KNi=QSisRrmijEsDjJP6h7z7eTMZ{5YkBXYu
zqPQW7TK9dwQ>W@wb#>V9{P%w@&!e60v(!1?e!k^Yt%R!3B430FutpMftwf{nEPlZn
z)rZhKew@u89VYNoeo81GGuCkuA^zGb{v9|m1+zoubcE1zqs5{ZtC&x;I7VT}Jo?Em
z5Re7Q?U2Lx0+E1atx0U-=H-E~C(Ezt7w*KT9ecLbw%|Ap!t1jHQD(a96a)-qLe7GU
zd6|+SO87mu*%_4Pi48Rgc3}EOSMYS`F{&e)i8cOnM63Bg$j{GojEHHNmQjCv-a-_x
zIp;w!if^Kk}D%Ea~^`4crV!N))k+q7lXaE?k@(5
z*6=+*&a{=8%Hn8crlJn-JBs7oVtBRJ?8;Qdlz65?x61U+@ywItoyx+6crObww{I>x
zen^=;v?E_tR(R2%s@1KO$sW&41cR#DfQS14OeM=0&`%FvXv6_#avPa5mz|^%=E_c!
z)KB2KGF>ryaOTW0sfv4$mxM?)-t&e<++W!XDNyg)v6E%SdC3RTgYQA#`>Q@KOx*5l
zAf6uFb1>gip1c_#0<>}I0N>~~ybd*;CyuCEy+s1n;VIaZOzh0KC1z|s9=4CrnR-!L
zbF=sajF*Zfc0iuQ)*^zqkJb{;NaBTHC((zV>0kcqRv@}nu)`I-y7@1X-5^JOK^v-g
z2cSST5iL*E?FrLQNoD3oIPs5kBSFL3ZP5>vdomUSeD?#gTZwqsQy4lZ&$a(qOf}Zd
zD@qyE6NGk%thN#bm}FhNs0;>D(Rif#s-u#W;EaJ)SPExEnLbH%iz^R>P~<8uN{(o$
zd00Kp_p0vD1x2*xb9T96J|F8dpcOpmt&Tj;hJTUHRvt*bA3VQ@RY!Oeb|Y
z&m5dusooJKd63wB7eO8f4FzHyF8Wi>%A-@~8O65nH>EykKEbqSX)yP+dVLB19DEV5
zr(r^0#;X93P|%LvT(rXoe=%8)I!
z6y@+PC~@@Iu?|1Sm{iiQ&nmpkMJ2%F{-(K~7ZHDPqJw6)UAfELlTNYP|4epBy=1lj
z)=DiByVio8i26FIv?-v_0h*Fqa<=SKl#{G_e~3$<2ugi3I;DiZA|7k*iXv^GgQ8N(
zT1crFW%>q+QJ4lrI9b64VeQ7yF3qP3CltVA5FW?aCR$y9L;d6zs7NS;Q$Hpy-%#tj
z(Qkdvr}b@R9#?u8`Lm}&h{K}fcQ@f-)Jo)U@^?T2E^rZ*IU>>Vn?Ua
z+C5+}!efR;d50prXT4BRgK6J}u|d!Off%gMZ{d!taX6^n$$e7BjdC1W<%Mu$4e0H8
zu=u<~7*_GSxIdABbaBrEf4lQs+@0m@Z80c$iQ^3GQkVfZ<|d!JD7wu_?eM)Pm-a6XsY6DJRW+bzVe?R6c!~li
zcoA9ffXD)zI#Mr6EP*f2`4hT0lQ#2a!qHQ>F8sGNd!1UR3On!;6Wo8(UfqW#o&cTa
z3+i!HnxW}XH!gP-0C8CYC*2keq5H3`y1C5A7g4
zndc3i2a#%Bj9U^giDPHH*a)x5p@
zhOK+?Zb{pC977EeHh9!3$AGJh&iv7d67qD*pbAO}#i~-L+cc$!rWY?fPwH3*(?{8E
zqzs;JsZDr_YF%87Ivm-3_0<>;od`m((j9OO5B%Ky3$UfsTew?#?$<@l*Fzh+`$nzj
z72bF4W!;_A!jXuH9r#77mx&TRrzcX-ike@RG1#|rl%ijmy-~*p3bIBuWgFoCZ$p01
z>2W-J+#D~gZ{{5cqNlZ}HS+iVwUs2l4R(N)9A@zXypQ;rC6p
zKQ21y6px0=POjXg-fI6lz@UZiWPk-nOIL1ZUy`_FE&?P3)-nPJe2P~hp!p1JLUO);
z6g`pdKM00}9eamlM7IFTrg&uL?E-r(v11Fjl#NYtU>&WVgoSAWqMM5^^%CveQ)J?;
zXmiM
zNnkT(i$f<)dt#A@mp0!~3r1_0WI!VECer%TS!QMW?j>B7(gC!UApRTq3-25Hgw~Ll
zLh;OgtA7BFsR6rzO!iF>$
z(yn8(Q_g{Ds8R7j#X}7#b;v?@8qHd*DtQ}H3)1{52;Mu>V1L{g_F%{QeIF|jN{0Un
zm{)dZTAWkq<0r^!vBEkk!&NV~!|?>()19rtl~!s{mp+J+;Ik+GD`F16KKE38vJIOP
zAF&4bUAVmN8y{%JjGNtXTSYte#j`AU$I_)(Q|DH8EJ-d#iX(o&
zy-lr%f1OH%q8r>3UtWyRgIxLKj$&mZ$R>7yFCGW~$NsxNAA{jmnVHEXUymcjQ+nyI
zF|n!oERAOd_Jm#4h(2fmoiyPue5}R?XoO<{9YlGnmf=tSE{O(q7Ys*4-(LuF=EM;we$jKn3u4cD;~
z=5+uDQwN8Nx>76E$yu8nEB!r&2j0zP8^BtSMd9;;K6O~6T5n_|woHIahP>z_&A#KR8Yg
zk`1o(QY3UKYM{jhhBA8f8m2fd*8z$I24vpyZo%+6y`(4#@{U}5Pouv4Qpdc^t
z!k|JFT=H(dEqJB{7sU(T5*Di3F#wFapaVS~YUksj>S9tn|Hae8!9yArE)%KE$4Psc
zQ3x4);p3hIfnb+=?g`a7?vUQ9{q*;KlO~mFRQVF0KXiGgH9ish#)8&
zLxg0>Ih3n~!Y?cF0h;7k(Kv9Q;1~WQoIr+}PsSlk4L(_jR^gK=fU?0S0Ev%JI6ePi
zZcb?O2_fLD1$<(`o8;#Yt_AO7UL*X$d3^lQ2K+(pNJj=@a~@}?QG0yra7I@I#J~@z
zr=>vsRZdRi2TQ~zf`unES%r8lG@>-$<3%ZU?EYUcQb|o=tw&lbxgdLhF@7h%D|U!y
zl9)>T!to65t%5IZ8M?tVY?R(AOI5Lg;si8(jHcQuc5s-WR(PPciVY^ke*v}Z=xfk>
zy8yk9vwIu`Kfki~LGSo}sQX=IyP-f@IXXb$N`F9?y845H7%Nr^gp%D;AcG50UIqnH
z1DnTGAot>6=MaA!hm$U*+Ax$!xbgs16+wAm5VQccO0Mrow8^_xsX~Uef_?+nr-%18
zh#WulQ+;T44TtP>bqAU(HrcT?s}0@>XdV_&z?ucF?AQPhE2s|dTSsWi)BmDo+L1i@
zK4UTbgrL5{kdCYTtV2Ol5o;M;LqSBK+4BSe1@7zW;Hpfi{d0%S~{|r9BOJDXq(KCF-q~=Ad3^A)&C@%
z#d$rtV|8p69!p%*6}eZ=835flz@eSceS~t@V>V8P_gt@Vm~94hDE%IRvu2C>ryo{f
z5?N^>iO$eJ`|<}@|8z0*4`l5BHT^T<8^8YP;^)V2CfhycK$B~JX_)89=0p
zfd=EJkD!INqP8)`&!jy#0~tSM;-4EqwbBwGMQk3nuNbK+Krca6=a88jLIrMb0XpS?
z!;;?(j-S2OwLL1C9TJ`*AIQjACo&2da
zOwp7?4V>6ugA}c>Nr&&eC>+?4u*Ang_0fnA#1G)GSkHKB8dfNuZSC2vk&8Cg7{z_j$$y(y8
z!|MVu)|TR{4`Rl3i?7aJN%dz0T^V0pBZsB_%Rgj%^+tSA^s9|%CbjC&xx^=(`093*
zsXEIEurljcQeWWj*M3HZRT*SWlaQQPYaIP>Zp#~M^*Bo9*NP4L|KqK&fYvYGdb6a&
ztxvpl+Sf5)e4OI#3-6
z85?!{-)?*~dewAnIE7o@86w@<3z0qxI&i(>K+Wz0UD#Xn%cZ
zcsE+jtQsRU8@=)$_yLC+)+>}>fqeTwm=^(OD8W=y^IrI%Ue)vG#A#3UX5k@e9pbdn
z>Mod+!|GB9)z)E$15g6rJQu20;;*=`mj(O+FKR^mw=_E)_s{_dI=9G>i<>C^dISh!
zb6@MLsN!&Q37k_P{TN9)it=`1(SILhv8~eP2=^I#!2RKcWKYlCkIPAj&%%LZ$4U^!u)^ZAJ#l)+M*km<&wltJcMz?q2VB-O
zKIHG}_v=?0R2WayIm(o`@0x)HWHOXgm)|Jco9lbVCxS#oqnOKOKK}{&?-nAYm#+#+=|ihEtBdYJ99c
zOzZj38HlP!{TVi9#G@K{7&YUzhz1#6bU@MPMdx$*4|0Z%_cBCy8}U_zYY~@JfODd_
zwemFh{*HVP(#3SC2ZFdez+ba2LEJPV5)*T;Xp`Xj&p
zd^YTGA5~4~53c__G=7VaE`i{NEL9qNnR2^G^j4_Kqp})BWmEZ~qqpks@aXLh9|Qlc
zMw${Hzr7qrtlGbd-=6P&cjLEIV>*5-5j+*Yl?WcgLt6llX8acKWCL+X3WR|8pA0sr
z6bMGJ%=oQk=0FTb?x{+FPz9{>qquUgqYnaj$YgOjR13nB{EaF_~j09&^>?s$Zi
z4fqH@HQbp$o_i_i(a%o|G=ZNan3Fe*TVM4)$=}O`kf3f~mH&Wfg&Ef!hq#x)M{A4g
zx_l&DW$+QBytVRN@X_6n17Shl_rxK3cMCz@V|?ikD#%;$hQm4gG1Bjn7wePPJ>EO}
zeLsmzK!A(#gp|!g%ou)eG2ZJG0I3oX#X5>}5bY&XsQM2?d-tCnvg?Bvy#p{s^^Cy^Q#8_rn{C64YArhaaI8GM5-eF%a
zUq~sjugHcvqhcrcWI=Im9C#H1{|4u+Ee`B*9#xyE!59^;t>UA=c^B|>U}~^DLE&Q%
z7lbCu9~3Snv>8ulPg
z@e}1TWOn%UTLXV^^;>9sc(d!bgWm;pxB`g!EhIiXtg(Wxm+>_-*{N+(Nuv$K=pSc-tLy6)OaO`#CM2ak}^Z7gJ(
zmlm1cc*w_Lm6@}~NG=RtZ0ozsSlw0m9jpqbq247^bt@K8_(22wIlMdDDdBX2u6C>#
z3x#FqSo0t|ZQvtZs}{^CZ{S{TSYT?QP9i6+uR}7Y9h(lYlurJwFxd-L&@BH#zKC1N
zlEf=h<|CVBnIyVue@FI%0tkk?L%0zZXcRSXV
z6ilJe5xz$kBv54X;FBXR|pR?sH-cx~<2k`FN+2T+{PVPt?Qjs^(vgK@w6
zd3YjLV8_lCkLfgUh`Qh1$qndBt(l#N`g+OgB&sEisFfH&Z__BQ!n+py44{>&E?0kYRQq+V6s3cgw
zrN^Dy=XCd~0bSD9;R;tr6(IfZ`6Y+!p
zFp2zWYWSP#kIX~aln3jO$>a`NALo_r`6pKnep(KDE|>E
zr;+cja^It~R6>f*bcNTb5j!ZWRelsSe~hoS0%ftt`IW8wWR#*-(%<1hXcy<}wWI>#
zCdw6X1g?No!oqvs&id@H>D9pgzIhw-8a|MZ_}$$f>}7X<$fw+l`+Lga`271*cVUSw
zkv~7X9rkB#r=x7oJFgeW_8bmyaTa(!+POLBgc`r=9&)o%Xq7fKf2
z{~zVOe-x+(89vQ&Fuv26VU|~rQYeC~N_DDMQ6JcK7lH`;)M&*SkYvqJ6WwxY@%TTGyV^KR^dHD`+cJHGh);yRV{99_vkJ^
zIOCyO8ld7a{{2Pa<9~n~k^0>o|Ec_-lpkJxSJlu3_b28IhB1nVKP7!-z3%wCz46Za
z?bvB~#$OyVev~<0){k>Vp795UjPLG^SBw7yri>qQon-O9@T};<-(CNw_?h%~Tv=){
zg~XfsTGWTDs3Ey*i^Ahr8*I)sn}jaY7Z;IiVqf8?;(|d4y`;7hfd{}X0YF8n9LG{njtriGzBoZFD{(~(bTyaeE1
z4=E<_e-cN*mf?SVWv2h}f5Yh;f`y0x7N+w&?7UnKvnXTX?zs*Ua1=+#**uD)k9!oy
z%UfGKiZ6dc7CjY41nYI_G6|_XJ?c}gUy0zyFoGAE;O?Dopb72R2wI~);BHUizVKcA
z>>k_7PQ@z%pno)d56f+3InkE>ovL!~kHP>9Gwt)7N0v0s>s$r#6Q7*icZ?
zNpJ%5r}R~pWvN%RJci98CDC|A1xu1!&~a})&aG%4nLk)}1Pl-nrpPvRd}Pzny&To-
z9xMhE`94^Pej1H)qf2N$d0J_<@c0>_YJyJ#`|0wE+H8I|+h}lxr|ZR^LHgNl^4jTV
z)C-%0e(rgU8;%Trt3~?R8peyJp9?V}^(B~7(@$66)DJVEpFi<%m6v`x=eCB?&zrEY
zO!}$7u7mW`i&9?Tjclonqn{fe90s1)$-9bMFEdEf(PNt#|`q}O6eDu@7
zYzffMGUe>Tf@nm9xoLNU!4*P3H(l^dHX&!b<4o7uaz5>E`|1RzKY+*1KK2
zXa{43ov=@jV$`yJqR=G8d=8Z#fL|W@!%c?zyhqLCF2YIXZ5ROolGzX44Uq#dyo&|;
zNoEI%-|ulwbVZK0MlFB;V>Soq=1%1_3!xi3_QPl9j+s9Xd2`lfYp0j*p#nF8UJiMf
zyNnD5xwk+s_lav%(aV+?;mH{Q>QNX$en1JmEOHL78d!ckH6yn*j9$)zfk!Qsj(nKZ|)+TUZ%rn3D8SxbT>o{!0_O+K`;ot
z%!Bo)L0}ZDYI?cHY!1-NIK(B$BDrz~?<0lf;O!XoMAXGN{Np|-nhiL>MR@lkmu{b6R@y0-p>Mt>ac&t6;q*I}#w7Au{4F+U7=cJQwh@|6NfNMJ5Gl7OvS!XYXuIu@I94+J|BGlMVmlYZPVyM+$?9+hpJV7bP;IY+)tMM!>^PL1f!j{=CXPIBmKv$xE
z!D24+ClGJ;R*zamu0=|)$o%jeMb0+i`54U_S*ZA{(~&+o3q4vbv^N*(z)`PP;Cb2;
zXi#V;Jn>!uStsAm-uWRu4lC{?E3V**uQ%?i^TYRYIw(WoJAg)z$bp;+H`pgNY
zi}~Cc$y{>zwyb0+*aY|Cb0v>?C^yyvCogjyxSo~fdhjK3p1Gbn8YTj|oz!{`Q|mE6
zcS@f1X!sfHI!M-aE*L2Lpzw1u*wT=ffXVTAp^Uoag9@h(>-m7Jn^zC*tQH7>O@uB(
z_i5?}17OeLsle@y#BIX>DhlFQ>!VC$7#mUpxc9jbH4d5`)inJ9HUhhsgH`OLW*IZiUH^_PuKzTeJeg-FV^MbOnK$qy9eGcFyL5c0tN}{VTVPqbyZC{cBpr$6?4qyQ#Xl}Ud+06}u|;;#FJ~7!>0SJY
zqoW<$U3TFSw~}YKfWIAj%8QQ-Wk6nfdhKbnYJBXWc5fl|0cL7dxas(L-ZxtH$VNo&E~xH*Ht#>a8Y6jx~3yj)rJi&
zdK_!PHae^Qg<$Onwg~;rhK%xI?GD)xv3A})?1ZhIi?b;7Kj<=B6_EG1A5Y6y*jAORd;BrbQc55a;f}Q2KY=!!CcDR9!XN^CJj-WAix=
z!ZJXN_-}Y1zYuwPWFLPZbt`rkT4dp_KcCZvoTmpa_W-Z+Ie&xFl>M9elFVsSJeVh+
z^QM30Ut;?1oF$H7_dH8HIqwp2?vTYX2`DUI95>pnHJ|hAJ7uAHW3h`>d%KN@ZU0ly
z<%?}k;H>`ru3J9mSg1@mTwvFWS&aA}^EtNx_#|#H1kL*V>Ev^Mb`Csrx%r%@LKM-3
z8%H)LQwq%}5|oUW4CoZottFT={SJaLVuAWV8@$}qJ3n@E<2BdII#rxBi4m^XiEgEk
zyw201*UY@m3l`!jZh%c4aL&X$0ukz6k7ePXbn-jh{nO+WeNTVfsSpAF{p*ZQNn-TC
z;gmyR4;&xN^PD+N_Pr7dB~Rq+n`2loudrFS+UOww|es}j5n(w(8_Sb$L_P0*?o?U2C80cCiW|)`n
zxsczT@-KZCuRq^&gX=SK4<8Q_J}hZ_Nu|<+p)1@mVQfJq$=&u(T*7(C~}fO6q^EuJRu
ze3j?j{P1M`oQ9__-}4Wr=h&@y@4&5_)@CiZ0gKB-jv1NHX8q{zTzzB=fVB=b>s;Bi
zI?vpTkp}s;p$E?gZpk}r06Dqf_UC=hFq?Ao4u{_+EBjmy1Ww*(S8gXAIg#4UJtQbI
z_$Vw#%wX2fh2|aVG(#ufGjm!9{QKRqY2iQldaN`PdHvLU@IQ?m(vc?k2iF1qW!S$y
zGxWengWRvAXC@c^gFt?H;J=sIlnehiL5f(}Xkf`bLfoQO`z~F*0r)ST;=up;7xTfN
z`7?t~_UF&=OdHI%dK|J+9oz=tsD7~Ts16i+=eTt{s{eYOY~*&*ZvMQ_&#^U~x3>r*
zy!x1Am7fc0y0L0=xO?>9X9`FnZb%++)(y-tZF#>1h{kf%Mezg-u0I
zH(tXnh11j3LTgag9zC6f?nbf}V6s457CH2ECGZ|jPv@E~0eb2J^MISqPfy#<38kmA
zPVmzcJy1dU)Cp49PfwmJP2`g<6>r&hl=FbZ~3aHX_^e2q)yYx^c#9&vNw`JkL5
z56K)aG^?+tEW^81DYwJyncGDGM0?PoRz=%!H=Y#80xvE{HjyxE+5
z&;yTKJH31gak>fUWxo`68%ZiX1|Lai9`R0~5lt^!V1y@k0I<{H_6ebvUFqz}tH)aB
zwuaFQ?Ln0n`s|~*^fI#+k08BFgLiZT>7_5{$U`r?3oZHRr8T-6A_m+4GrcB0b`g5%
z4iavGURs;Y0eX2vtcGxUc>-3FNiX7xmweDKsb5>l2fZGoX5@oDv$p=H8~u^qarN5z
z_hEm~(xX=f;(J3lQsR4;1BvKy)gAJKj_=vAIS=3mNjG?+hJPV&{W!Fl9s3N#7R(2I
z3E+`!hvb9qk7wskFKD2}Bk2V{K7zl}k>97u52ea3Vm|18TuCPK$2lZS$%x27VjpbCp
znaG*P@WX)TSO3Nj-b(G*r}8A`E<9R=CX&D-P(*g@ldG`gJo%t=6sU6GyN^tk2flM@
zr^u?mA-K|!)wjtH1{Lh1Ry}hF8;n&S5M1@%?yA@P4Sl)lU!Xs5KZ>kc^2aU#%pLd|
ziIzGav`ThskA!>Oe)bfmMw(9^G0CmXG_|Rz*Wh0T&vUSb3O#
zp?2&5c?gNM^%WRHw6~HK@6Q$I&j&r9G9whem&rT^e0Ok{9Va%^kz;vu&RlB1w-%2C
zeB*=p5t0vD`yd)T_#*#F9>Qf0o{T0gyAs+9d4nM1^~wi*mE&dVwsveB)ub@gGy*Ce
znU2#ZekfHvC{{nfW5jM|;*uo(Am7KI5BlO=T*(h0)D6f7?QgE95uzB62M2Af*0Y^j
zj{&;DdDf%JRO}WedDyW%WL+n7T`C{+dhnwmFGKSw|2+vy$SXGwQwtnt$Ic^)(vgdB
zQuPCD2A&GsuBgO^&TsQ1Q6^GMq^mTye^D7IG}DX*c5jlWW9{evi!i+t)N15|z7G0#
z)}J^3aK+`EK3^TcBuF$+++;ir^)S?!$ZMxBI%6h+HRIvf!X9c1?a-NnB%@8`AC6>;
zWU_rod8@X-c5LB4vH)!1p*y*S4?wvg`JinSE9c7x-CZWhmk;{12s>vNl7E_xtiZX+
zzl-i_7iS!a22CBlUEInR*@eW%eY@CN@8UC9Ja%k5*@b7mseI5fF!tK;amqwKBp*J$
z5wYUzWP6fBI?_F7CnEq!;N#XK_@VHiH>B{fge|g@qo`oKo!GGoc|Ijar_0z0i20*z
zsT_>AwtUc$!hYe2$JH`jzKw0G582!kd*$x?-7U{~|w{0PYhUBd>&C=)2=
zJx0MjYJ50Y9cKvUgZ8_WU9q(Trx9C!0T-<$AM{GaxB2LAx=fgl{z{-LTrN6;5Jz4+
z&S8G~yBll4{+3(PS-8iKwe4ktECacj`oP56b@F^-?UcWwiCa4v78>&ZL6;kp5BetO
zkw>((V-uh?+zs4K;HD!paMty2;1k+}beXuKf0N~dUI$5x_p5+5-F#3i;a?DUdW}7<
z!Gb-86MO6e%6?}LJOxb6;`JI1&3`_
zFa+<9g$*yiZ*_4I?hCrrjiW5WB~G@VJ7v2}FTRgL&VxfbSG>6ubkRkI>-^yG>C3KBa-XH|?)
zZ~d*87yTAGJ(Yhz+y&bug(QKzA-%1GWBnj1XBT14M8h0@u+P%$v$%f{#|w{m1inZD
z#9M2f#aO8|iEW+rl-54fh_O8KW8rv}^K`CjaLw|>(Pfh_E5^#Y;eN96;t|fOg8i9}
zI4QyC3*U|{>$(%dPOa-@Sr^=ZSl0`7?3-&{{9-)>p@PACiDOEmv%bca;Cq%pjpC(4
z-QjUBOZ_MH9jvZW>)^=>Q%J-`j=
z`w8xAz=Mcx+($&cnU1`T5Bj(mtN}3j52=GfF5pf4NqYx!1$EKt=I@hWvI!lz^yStQ
zNv?bU^MGnQb}_|vy8k%pl+=sL`%{WdwO)b*MS>Fb2dc}C6lXbI_*gsEhh1{oc;Ip%
zAn^p`Ps+_kDl0BCYYCTJ^;O3+D$~V1dg4oE>I~eOmikXT^%?Xm^;-%Fb6?0CIDY5(
zmXvWjo+U9l+!mHf;m7np1q?OsCHhom#v`*H1Hd~Gj#m+E-aCdA(w{I4b&C%;6RCZb
zoA>WKR+T2fC8wE4QpITmgA06Aeuq?Vw
z>(-)jOO_;8q$|4M*9!QW@8&F%pZ^&DFGxLJ$Nvw&+qwjhxOoyLg92prKG;!tbk@C%
z=rZ|P=^w5B7GEke4+%r*thF!7YwuX6}j_Lo9LYx-jyid*DX?6On9EskCpwHhx2#f51{UWj3%rq*F%
zxOJ_nFAFF1GvH$UDfndvs{x%kF=}laN-13M_b+zxQzEgsgzx2XiJ~(75Cs%)8m+zq
zf0T*RD|3`e^H=g_t8xG){copV;!@S8q9Qu$%n{|a0>pZ`6|=B;rrV!xbo)H&ABNjX
zp%){hhs3>(>iNcAlD%d06v&3M=Zf%P)ZzGhe+TKExYO%hhJ54e{QxA9y$5T}j_nOW
zAp7^{3*Sh~N#l}!eX%gT48&{s-Isy5@fS_H!g?}x<<-MNU)Zs)VMv+sYir~A8^`aO
zKQ^^Jc>4Zg4<H%^2kzPYoqPKckTibv^@yZYdP^m
z(`&2rRgL)5x&Pt?(mN&D_P8=Y$j}}#1j!uuwNP6Jc8u`_kDDOhJ$2>Goam;eO^H3{
zP={;(;2o>_IXj0u#~g#YLf^v_zkB1`V|;YZQhVe`*yi2PRoTz({9B@(rkFi)2s*3*
z>A|j4_R;55Qt-1ujtA@`2`Q^un#JRbpIwf
ztB2c5#j1<)D+aqLd#R9JHnF`FyM}YR_R?aIy$JgA@GNaFZ6iwyx0l{bb7zR~A^ps>
zm;OLs2{ne=mudYZ!|kOt5PxDfP!0yf9_*#%6WHvtmzr@f4%ioMlIUgFOUGd@v5h>m
z!b;Lu^$eW6c2i*fhoPK&_7cwnxzjoJ5-k;wj`3_|aoe%q&&E3ac2oCrxIxJ5KVn-R
zhxzTbX*5rb{auv7_k8w~^L`&8Xy=taKJ$s3t=ZGnkKU7&US|E0oRMg9huTlaL#MB&
z{dBP`JI8)%1P=%8r!#ow-puwB0kIDDQ`#|~q;&(gt92B%Rp9+9c
zVTSF%ZQ6W#7M$amPiLaVZ$5SBAm0l`qBWmlYG4e94bOaX^pd6Rr>*{iahuP6g4wI(
zx0Nfuo3q*;veM7%ennQ>>dGF`Pt!d*L&;MMGmg+|D9Q$U2_z|wlk^}jW*e3_zL%&o7
z*GF5aK~2zM-=7b0fm<|Qq|h;LY{30ZJzg7)Hjkr4KjOYqPLzrLUCrm1%P4P9^WELT
ze3L@v!}UU$*g(vs7SU<~?)HdW$+=T)vAkiJj`agrIq3m^=d7|9XVvh<;5Y^k#iZZv
z&q>y(c{;eu%1mluve^4)au9uu51xT(r(nLHF%Ream!6N;p+ugA^{tl7G>E*bi={bX
z=F*jz@dV5WXOY~el!+aS>6|^|Zlz4*?=n68$RjZ|hG3cM^&^2j^Dd43-DS4oGF|b@
z_1;3@Wnzc(BLv@&o$9fELOq|tHze%3;QODP
zP~m$FX7up=*nWBf-ldg^e24GilaGv~5!EujE8Jyv;xavar&b%j3)rW|`;X-d
zD0rdp(xD+uVQtXF9IZr4(dt?
zgc1gH6bB}v8xmy*zo>H}>>RPb<$aIS|AhQHxf=MaE?OWmu@g2zWqR)s<8TVjRE&vd
zhL;lJi}*jjw|r5wSBGN6g`lBmMDZm)1AF48V3H(WGQb%c#C=FXf%m3jZ7vVN@TO-F
zA06>w$7Y-y<4Zy!&%MzZu#c?hLu7CYK5Q8tHV+OEFj_VG;awpeim@VyOxW>9qL^#G
z>{;9o7Vi4(fd4T&mrsNnGja!3DEom!0c)^hSDw!4VVou5&-Ab-@kiXR1j1)b{x|@)
zGyWb3s15=e22w^Vbfk|1CWf`;kL|qvm>vBc9>wD=V-ND}Ow)S<|E%U8+eLhptUCCrOJ%ypsgTlfyvGN)A66WS{BzIp
zkYB-TqeUwK-%`Ep5Cf~uTfqGzCo0_6y)L-_c3&9z^8P13>Qm_EpuW7=zGJ^Zi?6yAZwVXwQ^ZVeI`UpUXuL1aglP
z+%6G$3SN6L+N(7fdkU1AT(SBR#=tWze2x3o_90B27g44a7pKX^f@4NDJu1LYV89Bv
z-$vqPIA1}c*|7&`N@pJDX$te&v6o;3#+_He0KWjQ|Gmk40{=O&h_dKY>YX>vim(Gn
zl?nwh3IqTwAP^t|Zo^(==b8|zC`0-93vnFwM1b?EfOzUx9oc~Z7z1H|_xV6g6#hnP
zD*PU2Y&*6ZhK^~y%KcG>^|%s(Gt_#;+gTgchDZ+DFD{kdX!;nx`JCjn@=l+4dU!kK
zBaibK5l?|A<0(KJ=g!Jhqr(Kw`+C-?zPVpu{iR&5vHsqhc>P$g-hg`hP&|c=D1jxH
z$bcU=h5j7pNYK3c^XQgE=sM`n{xD}e{rS{hE$Pof1bs~XDQvdL)1SR)LCB>kd_#HP
z2H`W%0LU|-L+h)4Rln!gqX|crUiON}(jWIEm51ojN>7-syB-}>70{!HVisYdy1SXXo>x(10CqCtV9N)`;
zpg6_m_32Z-c#P^4N&(7&Z%Ip!Yr=Gc3qh&~$X)q2!tIITB_MZs3iEYbeOg^i-NAox
zQ=zJtiIur8gDxub-Wo42PcN%g7i1_Ut2M^v)35Eg=oa*A?^6L(=+mA;0#vf=t5!Yo
zP%n2D@u2l=8F6Ol*{+umh6+mSqG!>y5inMI-+jAtt;nEtQ@Y#1;p0=fTOTK6g!j!L
zP^{$Vdb}^a7PgzIZ!P+e4Sm&*-#3xBNNHQT23yj$d>^K~|8Jf2?Lxt~cRfn&#s2kA
z;P*|oe$lpS1NpQq&L=R9P6wIlLko`ju%7C8&{>J5(Ku}>+qtdXOL-9r20S_H3_PRd5tNX9-
z!&Eq_V;a{p!-D}HGQ*vPr^XxIY0khj-fG}qzO`FAQv9|DRmyJu~(Jmh0^Qn2`N{I2_HP`@hYdMfUGba|WjIR>S%_
zCnCVZ0ds;7FzgM~fXzc$%D<{SYkRPvwigYW2_O<_@VJ>EHX*1>YcA&&+T*yfp}GCmvJj3M_jK+XNQ
zKO82X6Vt_qy0qdLJj^la7hs;hV|v&Wimk~UmmEzV!%1)q6(;Z3*7hr`l%PMy{@mjp
z(zBLFj_>X*3Cw$4-1i~mYq!#a+8G{0dB3u8@}wJTMq7aZvX(|NxdrwVv<+-5@adev
z1Jv;k@6TeyR`IFbV;^V|1z*|Nfk$#<6$MXkDWH^OmZ2b##EWy}7i@k>bk4%;RNquDcDGCGT#V&9fYWvApxzAgn60}?wh4xEe=ZyfpP@xB1Ss%SK9fRH(q}p_X
z+Ejpp1?55Ri3_nWC(+Y+mx4p+>a-)?7Z<3G_XQX0n;Yv%J0tTrSA@9{m%|yv*cjbB
z{1@05Ck@+}5GT}xqCF&>lF9bQ>OIR3i0ND@m_l6`PQxAu#D4mbPV#l|x73QZ^X#W7
zVh?)J!pZy|WJ*@z;oNhDp@ifcYD_r(%saN-wwh&*#)v5x^sEL95SS8wH>Xw
z4I{ZNnwP1Mu$QXETQv6;6QLSST$s}znL9Fq_D1#uk`Y#mSnF0K0y1Z
zV*!{kje5M=1L8CC_=nhpgd4mMa9%cQ$Nov3z`V~3VaMCCYxLJq_-gRy@IFhe)MsVK
zDT8(5d$19UkgC03kDl0JWh&W(w@QjL^bL%gJn_APX!TXH_f`!R@8b_3)Pm>tox$nr
z>Bk*hvou=$4Sq(jD18Mn4b767*l49*FPn`G*_G|*TB$`=>RT&SA5U*_JR09WzB2W;
zjdH1UMdPXI_!z>XqUj84&(^Zqo4tz|P7bzXdm@&U
z1L8K6ZsxNR$KX9iWOs!iCV&|W`P7ab0$zumCTn!?<(LSur-2IOx5be`l6=4UEJ5?U
z>{fQHiM@fnop3HftAEbx1ey0jXW6kAf~|>9n$N{Nu+P^SpRI7TQuwSPn9?oaa|JqV
z06tH^1{$%&6M;{pF$+G+8rtx0Ks|uX1bx*$Ao{Qgq$&OcK5cu_q>c)muV!aEcm_T(
zH`_3`hs{$M9||%|KNyU@XAzryri1EBFy
zbkn9FaTp2<5@!>*i0C2wjLU*(V?Ni4ylBUsKNNC$7F!_c`&KVabe5c^Y=0NN7`~@J
z!6!Ky!XC$NfFE#{QOX0_8=|YTU^H6uJjXMvrSt34ZI#YSzG_un+O9z0p4djPWu%N4`ev)~
zMW93EEr^`WP7{@Ns2w{I*l<}ugK>Y*9O{B9pbNac(_WQ_C7%;)W$!|st~pv`@26ZK
zZVfsUS1KrEX7#?`mH?J47@yqd}YB$eiqO;K~5~u0{NYA
zaFQ%nd+8EJq7lSo{Hux9+@Vn5P`cJ1w1Gl!x^oClYby$}X?L8)-^U7nth|WUBtf!*
z%I0$@DX4S6B2UR`0&4y5IRHx>20adC?*JJra=AHB<8}lFLjMmyM^a9-dJWI-K2eX@00`XU<}$YBof8#%2JD6
zFM-0A=$~B-KffHw0tU`90M(D9M3Eg^3ax9Hw;eHqBIM>Fc%~iul2aL^`EF@&
zmgF-+n*V}x4)4v%X@VE`mQy*@@y`dAo#5@%vZ4KQYw5QVyfggPwYygg*YJ
zzNZ&Q@rBalmDJ>AsW&xWDCMJ=6(s0*dPZxS1=t!CRRxY>tMCn^oT`WKx2$AA;t(r6pr>{4
zfZpQ=mDctK#r7sf5pjX!6&igYO<2qHRnI|+6*Msa>J3yRp
zbWedm1@3J+EJ&}3!|mAn%D98Oba7QRTq;|KdErx_xfZ;w*+3>hshP0?wd=kYkt^O)!soiluZ=Wn!o)IwCc
z@TEhk;Q+-C&lvv3PvI~~ykz#8{bGT5#Cq9Rr(s8m1&aJTj@C>e&K#MKvmPK4
z(9=ldJ9to+@!Ki##5c$A%04N60mOM6`wFR=+RdT-0l0^01Ps`W*3MlSY6_kqe#iwg
z4A`%!vt0wW5hB7JsI~L67znv}F!0N`1L`i>%aD7Ypvk}6q%vS1zzHAk4bEv616Je5
zg>R9s`U6JI8ZBgKD8XkB`_;ybfbVv&5nd1;2#4Vg)NWK+uDzN(1F$cGtqS`SaJ0zG
zAK+3zuv`bL)rn22tQ5W#*dZt2WQ3oy&ue(T1n9b8(I(|Rhp1ii8Lh=8P8^7ONLqz1
zJg0;WJO=~e7d|LfP_@u*9xfoggB=Z!UWZnK)SEncx3J7{f8pS9In4m+-!#9d&@aH}
z*ffDtSg7p25AzD)CLpRI@Wg%ZGa~`DQj6|eNXqU3bf2sVTivZN8K@z^9DkD#DQYeb
z2g79-XrLwl<{Y3Nol7eq(m0Je7pMoD12vIui-EA4N
zj@&7ynM5k~5M04OKm@HHJdeYyN)YT0jRYUR|M0{YVi0D^|L*X2ke0hxdk*TDM6?5-
z?}y{><$LiK%MzreKmr`gGjb`#Jcm)v4dH<+BVM
z2c<=QE=p5G8BMm7c$~J
z9APjR2!q;<-?#LjF?O;S$<~r&YtwK^js+Hj=P%TR&ic_Fasp)x&;qm~z*G1x{G#b`
zMWAEc41@X%EGzq%W`?sENC@KK@P0u^(dBRm%}AFS_Av))9JI$k)VV|FH4hdXl(LtB
zgWhNg#lcT!aO5^Q&59X>ujQfx1^aFy_N>&&bnbZ4+5rC1NHvgSt_S=>&eXt%*9Nc&
z0e+d11;wg9S(H3pL~CM23>V{Q6ym@hvX%zp^iB0vo!UZHTUzP_-raP{(`7L$6JHKhaQxY=qS7*4(d)vUg~pjsd81fI1+T
zB0!4$X?D0k-8XFDmKcaQ_n$zD`*P8-GWIgy+6PSmxGG(^8omnD2j?^^QmiHvq<+ZJ
zhd3B2L7>itj+ggMrekU8dlXX{NT!|uI2g_i1$)Htv;bIDRuoCX^bi>=ru>%zIicL1
z)Mbg?ob#>U`7=UG0%dxX5{{`Rw{y1)Siep)%Z2qkbD(DX
zX&7k78hZoQqXgD(vX=qt1!xL|HS0d?*nK(8gthNH?$$~0AWnGu?j>Rj)PVPg^tSoo
z{W2cZGQ4qJHvH}$yo)vt-X~%W9=xxilQjtMv-$*~Le+LUjSd&yL(PF2-uqx6?B9J|
zc%R8$2E2!(DHPt_B))Y(PID06(OGSc^cUt+3hBx*wCby#K9d8Q|2INA3h?2caXbNl
zjus>(9^u*U(VD}Rd!wg&i4&dXil4-vkU1G~VBU{34wk~#))n4B)KiYW$YlZfIy#GXkbo%rAZT`ugLJx|%0;{Cvn
z@P3?xuyZ_pS+N(ezI>SqSRYJb$D!$=3|C+H64{Dw5PI>Fm&u|9C*SBJDDU5FZjE8C
z-$M;hVd><}*_TChC$S5JxACe!VaPM>*f}axS>QS+tU{dFD;z|5P)wljVPYMsWi=lp
zYxEtGKCoj6&qlpHo|+F=Z}v*uR~Gt^#(hXlyY7vZA0eI&iE93leL+&)?O0nh5#Zh`
zqBR%su>|*`lQ??$UcoMKUmWYfVQuj+rNDQC&qSCsxwD^oqczuo6d>drD|3p-H$%Vc
zn9X*Ef1iGR9cL5?Dp+flq0FODc?39;%|t9Pd#x6Y9}Bq!y!y{MAYkmrIp=~^XHnz3
zta`sWP_t?k2IBo5djhz<01i9$40{=@`XHM8n|1sK7o5nE>6~V=>J+=jUx77GLfSpf
z_I;m53gnMX<>1h*A?u~n%
z`oT++cy~?_hOv1G9og3~Fv|E>8m^JmlGs@IbNdUr7{bdrS8n$ck^ps&T>?EgzUphN
zQg`TMSN-1Z;w@1web;AO6{HV&EPYIus!yJ5|4ZtaF3NAUoiz#>7U+*NXezOtnJp-O
ztw4K6--?3q{!as87cYOK(+IG{#7_$nCxUJpDwbpOVYwSK@v}eHzdT>=M%i&Haii#j
z6Vu7%NF?eGIc8)*jPR#pX!)$|iLIE#F%gkON4X*QVx~At0~~Yp9;9ny;>1z7|C1Jm
zVwl`$eVw?3{%lUBxu`!TLw$8maFGR~CjTJuVl2Dj&z2u4}N-X1b#k%1J1)wRN}q?{Ct@M6X54F8e;kIQzYJ{
z7wIe2mW;;F?U>AteYBe&Kd*^fRq!((O=0-C24`~Ef5Fxe{9L_@Deu-9KX2dxn+HE#
zHUdBW;mh;zGnVdB4N~n{J!1C&#K=El59GtoWN|v}YEGu{^BVvRyP=04Kl`$);-6wP
zh2iHboZn$L1Y1M!a~HVR8QXI~n-LH^mYH~=y7PlRS_KKzu5^Xd}`P&>%h_<0@xM%)D=$kadIh!axe
z+j2C8;b+DW4y+HhhTvy=h|mqd&-Zx1=D|x@YCUF4%{u+8iJoc;*hWb_!)`^Y##iS
zZUlawhp_hW^Nj>W1M+QA4orZb1vDD+;imweNIQ0yIhn@KL`;UfyPf>_nJKPO;h%fZ
z6o#L32Xo++!PXG`Y!BAn0Q@|T2W%evSQ~+#9bsyD_&FNb%Hf|qb`C&{{L_O*Lq7bB
z6tB@1=42W_9{|91Z08;Q_=&Qs;-A)N3d7GU@ORj;&$|U$L-2DrWZ(wirxV-|n+HEb
zHUd8rVQP8!nJIzj0RLPagc$KtL!%)de(K=tf&a{$Oyj3NCd2t>2S0wsif2}xf6x?$
zpS|F1!1*WG8iJp*Vft?Xe#YYgn+HE9Yy^HjfT`u-CrXcM&_4Jw2PVMJXEdbp;ipLa
zWG_lQGGHIvj>&NT>FUSNYwW7{XFi(3@Nx
zz&63w5d8evXTPmmz3r);fm88MmF3pkJ^-3>F2QA8Y&ufA9WTNCfgT{E&QVurnwL9u
zvUtUcQ+^w)yKU~|tGnH@f1vKR5Q~!Z$(0pG{@8!J{?^HVLx5f7<2c2)2#CS=h@uKy
z6(&h+@Xh0u6fB@feUzHZ%o4lDAdnK`DzGh$cmpy@TCAUa@sB3I1?y)!U`n}M4?e(e
zfSa#kn*=w5@ldQ;*U_GTu%H6DaEObrCi+aYOC9Yn9Nj%>fcOmKV;fda`zW=%aa~6W
zX0}mw%J2#Q1>ruYCZAEcNs*}EOWeK5Z)YaY(JJr}=OLevG2I;E~*&rW9_ck|KcFH_eWIMYg
zP-Hu^qr*|taG-bieLe11=}Adw+{WAVCqKfL@q1W(>IU4#yE*Px8AI)6tiNYq{arTc
z`jKL$2oI41T*NjU{~=e&K$4QT=G$)8qrUbBqSB46ueH8*0T3?F+kpDog`ll8F8Y*L
z7$Hs)t!9=rU%1gDdt#cENv(O=Tt{XFlzPPt<15o0(J8SvBPVXKWJt&Ay2RNmU_kjU
zQbI4B!xUy!VViy4tbbLJOeteU9K-E}0A}`nhR6~pqmE0$k^vhi4sD9}W&l7=Ua#_G
zN-DQGjR(Hwo#BH=UJ*StN~uqS{cFyxouMnlH8Y7#(AT4KL9_Un9CSjD=vFn1ZFuT^bUbZhh-~WT^WuG`S
zxZzDwFS|GWnn7&NhMw~Qm)L9tBQh^G55*ZBc{~zw4siE5;@tVILr%Tym+Y;u`4L)u
z4|K3O9SRtA6Twy&o8{|TFFP8N0{H=Jua~_Y{*29DFWUseDeKnDK1kOkP|%ttftFkQ
zi)w@Z@udw+g0bk}0L6e8m;*KQ{3^bhYq!FIMb*nzv6q&8JKM4GXbMdmIOre(dst4h
zKf|Y`{6L*P?B-Q|gHxAE%a|agiHTz*9nzmd8LfFw8AGUrrJjgZ--++Yf9$2;g4`c0
zSn@9H*p9NjnOmZXwT{V|Zn39=oD{{@f^4!=mAxcNBP8GBK&1#-qDwvKmWwo>2F*e}
zBt^I^;!OTaijw#`anPH}2g$ySIt~c@9M+lGI|$vxHmIM$$w}c&uBSrX2*(;o`LKO(
zSn?$aL*LtvNO>Wr8A!Qb=_g6AT910!lfbG9CoR>>R)84%R1&SZm56XNX>>jaZJPCf
zZwk3J_qp(8ae1Oz6=(ewfOqOkh9KJsl)zHiYb2T(aFJ~%s@}&PhvA&|M-AmHxMQd}
zP?OJx;)xm84jomgEYnh(JK=w*n-&+SVt=kSELXw_0YB#ns%qiR$tT_^Qzo`&BPUupIkD(n-NWH;o=
zjUVd`L80lyab&K2%S%=!&WTseZ(RnH`d16KH4@{HS2wiFg-?+|-ORYz$j=(=-={F2
zRr6A`x-+n(NM%d>WzZjoTiIIK51;o!08kkF2J+LIzhIJ@^Ej({S4<*Qb`at?Dkd99
zqI*P?qmRsvv}3;$C(;}0(B=jJrW-VQc-08y54Vt{2dLycE++Vz_ANRt|pba_o@HN
zE8UP;tX|aUT^J*D`34)dznFqV
zG_b6sKG7Atg?iYE-lS773JX`qaQ4SQViSfAW;t)Px(9ICTp~0Helf`Tfzeag?5ta>JX%>QdM=V6nJa=1o~(H8RUypee;*3d&*N#`XNxs
zJXE>qqEgFRFS^#mL1KU0fAR;D(zgg5c@0LQ{;L)2jctXdJE5DY+FGH>FO8D-3TZDA
zRla%rSqdGNIRPNfTq|L#S;?)+&mHR@xxHP3WY*2{j`
z7Y-Cf!bScqL~Cvbap8e-2SI2(s&f~}VVckac1HGL!#?qnN>O392&P|lii=+sJq*c;
zWkh{=nM79u`mim{37@KBKKL;-<<$8L`fz|bQ0v3R(0Mrj76N-afPU@RaP~3`lL|EX
zXLgcIJHXI^+{|hATZ^MTc&|%+>I*nA0^ZvdBzvN`)6q|69cr{jE-zBGs7`yp{&4Dm
zcTX3PPwT>qR7ZpM0Iv?&JH?)}@S0!8-smRL(Exm><19!hczMi(@3*wdT=;$}q2|EA
z^D)ql6%+uzdkTDiWG@50pV_$D+c&cV-x*@5)aNt@;mf-QHlV%|hdCka%~-Fx1t`R;
zSDi0W%>a0g7PadWJAmsgw5(jXrp86_w}>s9HIqp%Q{w!!zN-8`s^+#gi3Byon-Yl$^?^%ksI?Y)jQs~J~b
zfa;?)yt0LwMZrtg7>ol=HJ^+o@w2fkHv3Oa_r(&458!7eqnbH#?hI;ba`W}IZ(s?7aZ_#ZdwD_vyKAqw`VT{_7|YZ
zKeGe-esC4ov14dw|dq=2mmOe>?rX1FW0l)3~iDF)b3(m_<#y>JdXyL3)IuX
z27U?E2)pqokfW++y@0(8xSo!t09;i)YfrIW4$o;e<$+;;tV2EP*YvUYr7`{d3ikh(
z>RHdm8k`go*wcH_r5YsQr$iYBVORAUU_s06xv$lhn!fVQ#q0e!@fOtDY>RG>{vB?60_+&_rWis+%6Zs0Az~)j&a^6s9#-Yq&7Q$2B@2PyOyfA
zbNnOOr(}`$U>in3>j`%3Rwysd;(92gptV?3wC@OpzUMo3qIWP$erd-Z@eI@lof_5~
zaDPtdystom+p$x>0|gz2B~mV;K9ntknxDCWaV3momHIE3^y=&-+?dU
z$N8P}*{VanY4)qfD3uGby#4V-r!KSLm%(T;xhC&bS8odQs_%KZ84E$(?i
z`4?P&dpDu6z&T*LDC;19ehUl7l?Q}FHVD>w(kz1e4}9XlQ;%;>B{@y_vd
zo6_1uakR90RkZq1awRTQsVw}qGW{2Lb{4~V7rpjf{9IXrKVD~h=G@{Ur@<-4YU<
z>_1#KYD1TS4@fRWa8i0T<{u!CB;B7BD0RS94Y*j3S4=)v$ULbyEZ#V-FN;>akB5|}
zd&jF*6!uwx=TADY`8)jN+P8`i1RxL(>_Uk
zp}HO07upl?->*R5AuoiTbH@
zEAzcK@zjdu-9p#kiqs_c!mGaI6gW9%Qle2fM9QTrf
z_~qvBDdzm*F?EJ8(x}1JycfDV5F}Vyv&}hIHk5Y~kT$nNAOFLfufmED#}bMRf#%1e
z56X)Tz*PSYQ`@oK#l$l=!mVfa@s`n0CQl_Awp3o|T0BfSv@geBBzbS%sqGG
ze6NfW6n$1Sw~{Y--^ZKHU*J_Uj==o@%94NL(txF3DUsk!7p)n=%~GdL6@@=DrwfEG
zuVDo~bbb2H6uWlp37%%n`txB@ea_U+HAdz6a=@V=@yD{1Q+ckc&T-#eJpG*1oAXvH
z5MNv2BJhUMljY|eUnuS!JJttwqRX$FufF{7>HppOavX#=Pk#8u)R$*KA6|a=(e%)2
zoup5v?}~;q@}i{vg@&NAH6gx@#^k5)kHZkPV_TS$X$6@|8Wr;)DxP7f
zuV{@X|AeZ(T-hC;HwRin^23h+BY7u)Kt5Uv_2n40dGNC__2nyI#(DUe*){|}2Z@R_
zP$2a$G_&&Ir%u9_e>Nx6_*nskgZh^yKYqrtE2ItU|IrkNpS?t(4-B@3;OE`XI&TPm
z-hgX=^WbM=>dObi9QN=Nr6C>UpIb#+2k;|yTt561K?cMBL)WFAOyg%TCPV$p=YIUW
zCSFd#&wMn6;pZAL4ekrJhT!KD*pM5*KYhXUn+HD|Q(yjX_-;J>jBRazRLi$ts7g%{
zCiO4hw7@@;;c!I#i#eIb&%ZGl>R&+OrhMC%T^0WnqsjL)=l+bZU~HiNCDi<9W
z`KqsjL)2S1fKcccD4*cyVLBOpRI06*X3bhvr&voZDM=YcFe{On5`Rf{Ce
zKhH4y7{pJ67H2;BRtkR~?gOWLP*0}ua~>u`{r|^){Cp#xM8VH;H2I$9;Ae&y7WKi_
z5d6G|r*8m$hJxug4}LbLzWh}1Un{zI@e1V4Ynd29pl^EjA(^WbM=>dW^AS$g>S1_54|
zzkcY)&rEhz__+s7VfZ;$42vs+ts(fi
z5Ir{lKb^pKn+HD|Q(vBeu=enCw75qD{PQj&m_hm0BotHMufH2I$9$hTL-u=xD_Kx+toKG`t&HXcmBdGNC__2nxd3_SeIqz6^249!0W
ziJlMePYn&JeEd@f;|}#t=42W_E1=`rizG>%+bfs11yfD7U4=}vE)zjY^83A?Sw$F#E_P5LaEOS3tU)=j1d75V-J%8~h
z{_%b4{P!&ezx!Itad%>!Rr1#OK8A=LM=$x&sxpi$VzCNdLp;hu-@++*Rz*tWS
zd0VgN8XvY~zg^!l+Rx2xzka#VUYXn8{y#?hUb*dM^nK~)cgSsz)ArTvU**6%(#vdr
zCAa+;bNw@N+xwX9*W|W$#r{+bjn(YPEFXhD@CKh`_ZYp@#GZ;TMw+o-U;ln?{{zDM
z9|PX?^>63)Zxh!4Y5eHxzYMMdwVtM
z|7O77*MG=IdOZVk`m-bKR&juF#$sO&#a~#SZ@$%HZn5{OB_aFk73{yz?Oz|(zbuHK
zo8A65hV|bj*nf=Me{@*?_K+X4{>&sqwn#IBR@$-eT_E(lv;$bXOY1aDgD
zu|;|@v5#oA;Ue6v@m85cdkHWeLS{@~+L7@J+*E-iPn7Rm+6DWE6AmG;cHAbC-~5B*4&Y_UlOG6l`HjZ^^48kvj5pX!%vQXhYht#R!9GK
z&rYil*;!+i{678=E7SS_tE9n-9=^=V3@E{CWD#__sE1YZ;rOB+b`;9$ih2CW>NU@D
zr?E=rS?WwR+C$wuQm2lNbe7}X05WY3GAg>^S57}YQs52RdM^&w9pL|b^e-x;Y@f?FWI4oMj_g6Pp
z;D4AB`&3;oe>JQt-?SkGiCDMlci;PA{d%(BcZl1${VoTU?Y9hF
zn(uP^&97?eUA4M>^u{{hMjm6Y%cPgPk5fTUx$`j;*?g=!A3*ys;wriQMzY@?X1{%4
zKjrr8$9`Lw{T6Ff`BuodX7jrUVtN9B_oI%L
zetLZ;7uM|dwulbWH*RarP-i7i!?gkQp4?LR>G|Et@70{fTz
zlo%zK)}V^A1{n?)Y)=95JzhKB3$N_@sOg_;@EX6=d@Ez&jhkx<6T4Y>3rPyE5BeJS
z(bLjM&8?l4J%Mt_R2NUj-oSL=mUt8=hT|E?r$y
zH|fdj3(onVp;WH9sr*0ey$N`f)!Fc$V1S_L6Dy;sb%{FIq+$)Oi9pT3j68!AO)Dtw
z_@cbj4JwJySJ1%B=sX=qqhd>~eM?(yskJSwinw7wNWeAXhD!zOHe+0HLvWk#ci-ok
zH3^IDd%gYtzmMx8^DO5%=RWtj_j8|foTlwB9!$
zrH4NKqA02of9!l!UoNCsdZSg2)4VUERCM{H+jyMDYgS-!Tl418z8p3|eo(?YAXId&cjCh%`JVtFby2r2hcImVI4p{TI2JE#ED`mh#z)!2AjM4#273
z8{CE{-Mlu7y-9+-s{9_f`1Qw>vt@O8tMHrZBGQy{T~gN5E**z5GhKSyn)l#dg3^ye
ziHrJ^o-}RajDYA+3X@#}sUP{6fHOkI-wuCS+I+4#l#YIiagrs0+digKa{gR~1ma`a
znSKO_Sw(f1{#9En-5jdlaOrKqnlCaG_S~add$9D2Oam>yVwa;bZ;VBH8S)BJck``T
z6u1PG*OuA?_ZAGD(Dl>0fTI2dYu;OX>afvGyT0SnL3Uy==Wcv3V+_phyrAaJ(B}aJ
zGGf`y979HXLOzVC&`Emeo?^eddQhR0$B=o0(77Eyj(+aOvYTZ0pR)4K*=W~nhG@Yj
zN2XUP9h^>`Y0nQImQK$p%s;Xd49ST8XW^4J|E6=SGK=k;lk6zlzoh$m>?0xVy#>T)
zwUP+-wp7wBDqr=Qi!~nIDe_!k;_%qR_TqWO`{G+IT!)M*P!Px8iEcbNE-c0NSHjZIu<(1
zDSZ%y-+MN4byy(sZnM?l_Z|i-UnDS-8Y?d?DA-#Ya-Q@#?}f-Bs<0Cw@38w?`50>B
z%kN65-MBcEbK2s7hhvqD`oDtSoD1s&{l#2HnrHflnNd)~uNUOJTTtcVyz
z%j8lDuhl{+S)p#T^_QSOn|;>a1X~vIdlcuQ^l4KaUfiIBg+P81g
zH`x#j@(T*3cP2YO&eLfy^Jvv+95M-`AA!McblMA;-7Ux1&Mv}Y#phf~>31O6=%x7ktn%M|_&?9e{ouj>K-&#|iu;UD`^-}t{%^oGKJ8t`om|Mg!7e*X=E
zf3c(cfZy%`ztBM;{8xY2H~b%oqEPsM{@&K%|1s}(82^#$1^(kPrTT!s7y9o3f9D5%
z!+%5;{ui(#w}$_FdB4N(uWVEL$5QG8{$A)`#<_rh2W|!a8KO!J{ci*QEy&v)hQCbV
z@4y=A1O8sl>YmMzZd$KaV~)W>i7GG
z|0D5^4E^KeZ4Le(^L~f%AGucPA5*9g{P#ltJ>c(ruW$H|$in}Ec$iz0|GeK}_*W*B
z{!vMNz~2k~%QzR{f8bW&pRqcF|8H&s{w=Am0e_jo-+@Z%1O8s6+Dlrw-F!Jp9;voC$g#Q
z8Fo5DmNSrl-<21-Q2W&_|Li&`pZNizzTs)n^3$^Ad%$xIo`KjsZv6o*e_XbFpYSl>6Ws)i&RB`a
zULnHUght)-$uzE5kqZduysyoOS$`oqI+BKU3|2(>-b}^Zr}I^w0v5oi)HO$&Ei2a2~!rTK>sw
z`9AUO!gKe1I{roF`yT(OmYwTr-xA6N*miF?!8BVtfzR%rLg?`U=OB#cM4!NwvcPMe`5qLVrRvDN&$5zW5rp$)7
zPjSW`K+#%#&^flw{cUi6ZTGiHemlobbZ^g;-;S}sN
z^_%iAF?{XtO$G~f;;6e579O>)B);KpjxDQ5zRirE?uLClA~~O7@Pi8KUu!!vE5LHD
z?w42O)xDRpe_`E^;v#C@Z{toAzbmMZqmi>CXJEZ1zrIefrHWv^JX7DzS|9Wvw1te{
z`A%efh0JeQdGq;&0-!K8{Vj-qU$)vlTXFS20)Mf%{pwu%FEg~+_Mc2`fBOe*NBa`TpMi`hZoe+q{+aph
zpR@z*|CVsWw)!u@{}G6c;`Z%a`!7Q-x&9}2p#P?QLoZ@OJc40n=p{cNq?lezd7JVd
zGEJH(pPN7Ey?hhp*Fx->^0|DH;_`+3(>uRc$Xv&kPkZQ4G{C=0R
zq?>r~mS$=c^7~8JNLu%2Q2w_0{k;78e%4EU@l1WUYkfI>zn#h6EdOTncZ%_qzZ+^c>GGH_Oe$JcQPj7cF+cv!mzu!m$#qHObCptxU-1vz=P!l#FQ^+B&DSqoAb{A5udXAWpOO!
z(_00)f?_RZM&nNCJtv}=PgZ;wWZ3cV_E5_i>tu}hBj3Y}rFu?qQ3Sc&XP*R=8?PV2
z1jt9pfr^rSir_dmixRP46GuIMv5Su+x&?f6Ib4BdaxbkUk!~$i>IHSBvT6Dr9aR
zKJF3WAo#cpch{wlJ!HnJprb+`x7{lx^XMbO7lp-KeB21b_r%9`(#M-hus!KxHvu%>
zKb>`F3`(|-KK^u}i;vYHwvaw9Q!3B$%kM>42|lKP1eZQ`k~#Sv__#?NqkMcc_duJA
zk1#BmhmWoMCrAIe5C5bu-w40S?zlQ8eh|}!GGA9<&llJuuJ`eq#{oSfixNWTMb^k4
z=&@Q1t7Sf@puViX;nsCZeqFv^>N+b^*KF$2d7Ps9iv5kU{2JdEsw;wSmrRY{p+?E?
z%J>`evibpkBb#5_xBZcm_mt1(-xinOs=Y7%#tigyvHr{RH{KDt$k-q2|GoqIZ^^dx
zuh<{Eh#6I6|K!;p7v;Bq&JMJHC$93g?0vC6K8IwB+t0H<-eI_M{eO7}`fu8I^~?6j
zQxo;lJDbD<)g%_DA}(Fj(lw^@w&uOXH9YOF$>ZIA5Y})aqzQJvx|@6(v0Av5=+dL
zrV|JX6gD8*Wvo2S$H&2ZQCQ5y$5E)ALVOg+lYDt+Y_ItOQAXOGgiR?k*6VF&Ocm$z
za9b>1?jR1R!tYTSNAO)xe@6bfah&|RKYE~`?u&YVsxmn+Z&NChK9Gx#Y3jhK
zkXtA*y;M88_ia+!hni>9nf8SLBDF1Na-9L$h1vaXl5=1Ay*$KPN)VP*+w%@6Kkd0z
zjmgWaBrA0nyZ%ebB{&^BI_D)
zkN36aeO-_Dd6nh0*U)4;12nJ3t-ry1Z}<4#eLqp(H%+pgQ?Of`rt&LbPv=*1EoSjs
zWyjlO2)V4bzfJay($;At?I0*`Gj1)e5zDez1*mjcfu
zb1CplHJ1X9BpU;oz%$ES3OucPnFo*BTYB1L=hgC3{=sb6OmbtGY=eZBb_b8h34W_=
zXCObd{BPiY6aOdif4a5%)vfaN?pMob^0UzV$bfOzZhi#++-)#Ff?@7TXpA4hAwN~-
zM=--(gZYuZb2rKSNbi(h6@CCVke;muk@}JDe2(wbfYT`{;%r!?X{V1%@(Xm$e3>1;
z#oG!1w$tpb3dQg88X6@niy5xhU{guas*H{I)}=kKt83I@$D`5#Sd*`ZZ6t1IMSe_%
zcc}g&zvMYF2qAA3Gd9m#kpaNyCylo*=selIubUqjkgfR!@
z?8D(}LYy5}9*C_HfJ4sP!Fa!r^Ss2czkf=|`O1&-wk3NCqNL~Pt{~`kx+b13eT&Mb
zaUo|5O2n2LoYiMg11Wqyj=J=n!vNCrBiIA2n$6Q{t?+u9ZHTdX+SuyS)JtS%PiYG!
zPUzQI|3ve>bnc9P*0M)J&ZBfOvajGO6PSrp*DZtjUkAO|$pL-+Ut>~>(
z$tMjFQjHI%(CF9$`e{lIeV~0miD}i=vJXT@zi%_%Rlf97I+UhEDM?PJ9N1vFz?#&1
zdfTAi)zX^zPzVKCtY1H^U)SbvlDbyEi2#Xg=4Li$lT#>s*8KL=$K;>8a2y8+!`FtK
zGrhG^pHvD$wYuX%ah}py!L(Fe<$UUH$u|!}FsJhU)-sOz!|In=L!rJ3eZnFLO&~9x
zVO0IPHp@TXV{*V%qb~mlf92lq*X#S-eCojqi@yhw^rYhX)XE&Z`o5~@zPjkXw&=bt
zcW>5z80HQ+tB5>(1b@SZqYi}HO%nZJ&N~!TdiH-vlrHm|5yR^7)*Ler?$SeQj$-3G
zKlm+YtMCxngN)I`emG#3FT5pf&0oQyk-+dY`Jm3T&E=7`R`hlTwGk_CP$2S>6@8F9
z|M0(uMm*qc<YuZ&dyXfW-94@F
z`O+#2XM*8Q7SFKfXM9YhT|b7z&;)PvxEJ5Oa6+1$-Hzsm{n8pLgY^v+*1S4ygK?E$
zvqDZMV(>73>`ZT^A6#OdfTEC7=H=ubL6f3Lwys|y#jGWiYp~{b2qtNhvco^&t?28L
zkmYaB;%D9l;qu&Ya^6bXx@m>KzS%q7`tSD03h+t-c;YDO2gBAz1>y2C-GFdqoqeBF
zDB#-%bcF`34vNLM?u@e#GI=tlRSM-$@)>v5l4|Ge)LhyYzL0W&_SjU63XUpOtC2fWB;yIlEt;v%m
zJ>D1k6FJH9v7{Mg{FH|<$(5RmVjmW!ZGh2s~6!|PVxQ&ewV?X2@LM8uIw(FP4D(Aanx<6
zx_)arks>78tD(f?3iXF(5_VK4R`1TmbKre-{W&^4^i$?w
zT>Hn4bKf~Xd#^TG4&L)cfyDd2$v~RX-U_^*oZ`Y;Q4DV<###>EzfxHNycHUp1m1zY
z!0T*e8I1FsnZt-zlSlq51?l7>kaklP>aq*5WAOXW&%o0P^?|?Fv-mrv0GjVFTdeNqtON36^B~`_QjlxZ?fq$XXT4>JET-ldZy!_Bz7mK~R0VdLlM#DU5)bkf~lobzv}Prv3D(i+3FPJMO=
z{`Y*RPda##KVS{Uo-**C%ydr{es4bfX`yn}#{J*hE3(>559c6
z40twQFRJCQ%a-pmU(1E(@kIj9IYs6B&L8`wmOm_8z6U&^LU=CL@@b7bO8(on;Cc6#
z0?(60<@<)`K`sBQZ22DWJn)AC{3Nvev~2lp!7~9iV4uID@_oZIRLfi0@;%@gRtV20
zkSY6|Flzbq(09IP3!kSwe<>>8H#`9?e`U6O4|r~2fb!_aqvcP^mfseBqCXXQ_Ae^m
zH#`%x{QDwYde4U(TnNu9E&q^|kMCi}&FZTec=5XOO3oql?0u`eJZcZ5?C>@0#jrOq
z!ztKHXXI&c&RY}d93R!9^-U|P@8C>*`wl0)(6jotTI2F1(zi!{$4!RYE|I#8yf^g?
z)%x}?s*fGH4SWY^eX~q`KhpXxr@k|&5J@chP2kMK{~V&A(7y;T#gD;%-}r3Q^1sTK
z?=ij)&|F^q`)c`V+49>O-w9|c=)b6Z-|!68@>aHd4|s+Z!t)7(2mNE==J&U6`hSC2
zALzfReBbcgt>v%GmhS=2EdZQ{pQx5UDO*}-d7((p+Uc)lm71p(~oG_F)Egcx%K7390LDF6j=W$$OpMiX}llf}qxA}qv>wIy=
zKEayhjrHp;eL;(amzU;>UG_pKac;UXF)90VeX@lZ%-d8RDt!cZyxG_0k9~s>k)61pRQCA4_BQcw+Vd*Fg&tfQ3-x2u1-6H%
z-`Mh=ouIm4>GELsozfZY;+mh8SDyL^A04^Boj6@;yy7H(;`sFNc5;66Yt8BOqWU{p
z-W!(~zfeoNy;Z>Qu$WV#cq|Dc)m>z@ZZ9~M`2
z_!`g~>|80=sgyW=xS|#}%CEjtY-b~3C0%D2avnc993f8=5PhJBSTfQ|qQFgeTU@O*vgx>Nb
z4txJ|f(6qUY0n>!5x)2kufOK)?#DCpdySLXRzBOBv@?!&YLb0a*M`+5;PVNPKPt?k
zOP?>2sFj?mFnLZ%V`4D#5|~jXB93a-anywxu4jpy@txXOv)bo;DyKr|D%wV8C3QZl
zwNX`kY~|3!5J7lzl@$>mG`zW@`8%8$E9+sSf964`rrU}xaO|o>>io7o+tR>OwxvN`YMb--su>AkqfSbWDA;eEv{i@dFA`CTw
zJ~EoBLZxp=2cRc862o!V(@WSiJv2REgh4CSQs0`ELv$_hu6(3lBxdg`aZsr?GvM;k
zIBF-JD&zfxHg_+z=$CT1a`#GuA6>!vv#Vt3EW=_}%`QcoEIpLQtmv+$OMBL>Xbu?s
zM14Hcug)#}YMy*`h<^1De?bIawH%hmiy~iQ0YnU2YjJ{wPvaMRmZ>GV*8}cQ(Tzs8z{yfzqFZ3o
z{ceGjpT`2{GU|#+syTTity8uvcxCktid#RI^?VfI_ok#RTY}t2pxCb
zLZtJo3=`#jon1=O>ob)%L1#ha^?QVA2a{*#;A|WY|XHHkR|uw_e+DHzGg3f
zo6Q3T-(Z)n3D&G0V=W2wD~nmSgE)B34sRJW^C`cxx@NQRxwAUFVH`W`G=FdIt0fJv
z@s?8io9%XZ!$#zHzad%tQomFl-eB3w-z#H_f_|}qEpK<yvz`1VB0~59WY8UX%X0l@nw^N
zk;p=(O)ed%(-xQ{l20?^zmYxBUzW+Uu`Ga}&H_RX-}ya-G}Q1d^(kcaJ4&BYW(EAJ
zy9-v}S&@~z%B+Ill=d9jCT+{kE>B~VS<##N%j=N0A(S|eKk*+WLpn+4e46$+hybRg
zSS-g8FEY(fI5g=e7Af(y20MOeo0xS8wgIVs--;eWO-#A~y=3FGAo#85UkLIW=xvq{
za=iQ{0|a^vX+N3vOvFti(x)A=VRAyfg%gbq@(uxezeh}Bw6oDtwp2^qI
zxGBA|nBMGX;NCc3yhSpT*a
zouqw~!Encc?H(A1(w;r2Og_K?lZ8F_i9#y_An9PkTBQejA{pHQVErsTa6pm_K%MsB
zc?K}kgKmnN9?ZQn*8}EM-5$hw@AiO?F?AV(^$F7h%nZ|mDca3!4*=dD?t%WgWcnTh
zJQdBT#3dp`193MqH(SE-(j(_sKV=t=fw2>+=u8Ej8GEI4CWQi&&R8ttiH$kHjFzm}
zX%(A2DxrDz^?|W5xP*{vFuoU+Gs7q*ku#=NE}*F~%v&)X$pvK0h;TtXUhF<+3^NF$
zWm@PXtTZb+!L5{3Z)XfVJz7?9)Z!GFhPrT=>W
zef`$GpHrE7Pz&q5PPuHfmN#u?TJ}1bSx$SZAj1^Lg-Lsb?^p04cDB5~N9!nhe;y5|
zJsYmz{b>fi!tWpcOy0N4`=wk;e{%b0W%e0Kovg3S`1#ypvl^Yl$8`7)uPjMLs5qyK
z-Git?&hXJ4{^7iSHB+xSYApBNPXJiw8@534vc9<@?b%O4nFSQq4DnW9!&B$s)NciU
zY`Z(LdyD)K!hN{=L9JqmTLm%gmt?XcOl>7Cw|CzuMZPV6j@NS6YPoz0Zds_V%HQ#{
zyC0O;xw55lD}1aUohBbqV`T|BUcgB{*kx`bLlw9ttp@b5qYZa*$ctb2)EPUvXLd;mh(YG3x$Csd-K>HQ#Rv
z+^hx8?4`iXrofN2zz7PYe##TW583?}^X!XCWNR<>#jk$_>^T|JhkY^m4iQs*+ZXqv
z!DZs9(7rhTPg}Py9!GH+`(lO!Hn(bD)XeFj8Y+^n|J9Xv*cY`_krjG{_QkF@O6}XQ
zFE$f<&ZxJXees(+a_Vg>_Qg)plkKoCCeQBCi}K`t*fZtyGVkS}0t=JdU#B2ZM_Qh++kv{B;h4`6$+ZR9iiM%be
zFa8^wL+y*(L~!SLzu3Nb#SxCm*%wRT1(9R_lzrh~e*HiD;$L82v|onE-->;)P~LCF
zzG#*ATd^-D$@~93`{L*LJFb1POzhkO#Vhv3YV;ZEdn@+EDQ*?m7ne&Fec2b^)pEVq
z7jqC>ec2aV@Menai#^>&cG$kSJ0MoTOwpkQ-OSh*M@d^nZ;XBME#7R+zBof`-nW;U
zUHjr#E${`(qqqUrzWAmVc!>gAu`lq4MomRTVPA}N;}`5!7!-fh_cN*%86&=CIqA8$
zFeKjnLi}&D`K~yiuOVuzsHFMvFt>r<_3D5!C4L4%Rra41`y!q7J^SA#_C<$?6WNZ{
ziZrW7`J~ynFzvY*6I<j?6=`8Ug6XN!yXFyjM314o)T?h%5_n
zGdpN7Iqwh54Yb?g%dsPO#ce3_x;|%nY)qBg0SUkyD>GBkXT-144!8lB4`@-{@|#Jm
zkVH7?z-~ZkoM->7(t&ocExGnTywiNgFILtnGYv@88>(iE)dvC>nzf?KLd
zu9&@US8CIqFK1|1aA2{h-L7;b?^z_`TjIwWblLo4si$8S;s$~)05_hBH3yCC!nEf#
z@Rk94Y!>f{--=c7B|#UpyWOD6K!sgH768r?kM}Uy#3;gJ?zBhjdL5Rg75%l80&u+N
z+44tfh_julb9n>)zX7~K4R#msRmrb@p9Ng}`;$}`YF0L=ww5&5F>%PXW8&ant+X^q
z-ClhkjE!Nb*{I*co@vitiLduUk8dd+`tKrfqQnW~WFAMoYHzX~BE#90SK(hK9SUP
z;ljE+PhH{^cAIMBY
zS87%6KG7^=(JVvtsch;@6^u?w;`7EIZWc;whRCw-A-j~LO*DxAEE_!^UzutXzf%0|
z67i=8xZiV+Ki*K88mS)${BsF+((}rcP7K8R|48rY&%qSAPu!}kKb@o&;_1^6L4Vf@
zi~Qv!`hKyz|6_0OBl^Bg-v8LV_jQ`B>>HhG{NZXG-o?H9!!`KBHM|~Y;P!PMU%|*S
zXL>N-9n6bAsV_g$)lhjO7pY<7IR8<204Hvs?l04^isUx9o
z_0QZ()YmoYD6LO>p1xjZhnfeek9%8O?l#FClJ;kMhittRbm_EAlqae4xD!1o%LoLL
zpB6%5vh>rQr?CH}*aC`mKUrMn2r5Z?{zMtP^CA-6OBzUw+W0-`&EF(sRa9UTNTV2NnSP4QRM~m8~0XRfZD7k{WequG*3*
zJi~%IpZri8SW0`2TA*5~v!R?@u=fgdT>}KcOgM&7k~A`Qe)U!%N6Wl2$Be|2;&M@)
zxsd56eNvaXXpoC3KIEefS}IQ
zUi@lYkNK)MGBE-6eI_a(n~Be|od;!p)K1*nMeVjTA?A0Y%{HtkmdbPsVW?wp?wr7_r=J$ye3W&q!xtob4Pt5nNIa|fR})!sI!(2AvJT#Mr%LfexmP
zLL97Vx5IC44Armf2{8|W_)P=x$FhxH^f|E&;(-Mrq`DR4!*Pirb#m}Qh%Su8%1BT^
zRy^&h1;sFvX^dZ8D*CxbpV6iI51ZM>{WBFUUVH(84WM-LX&8l^##Xl6UOI$}^u%b>ljRu_qbIL!ttYRV0eeiAw?q?QLpJQTpzT|A8rgXv7=DA4
zjk|>#n?mtM$V`E1bdqV$-3Y3Qp~)?`o*r^8ZcDvOe~es9dyZwKggY`!qm(HeQ_L-c
zW*X`|&3C%;%V}shzhRi*KgTeVP>~%G!7BT*Ag3582&M&sfv^LM{LY6tR+$adu*x~U
ziK(Yh#BGL3qWe;lKQ72WxdNmMy05ujq`vuYbi4w2{<>JomcU(x&w
z45d@3X!Jk9k#JP%dM)Y)t>Ms-n@dvrXYRvW`dQcB#hp}uC0shP-nvfCiV?1`mR#8{
zF|(^7Hm9|r^(&So{goFZ53{cQ1HY*&_zI$lfFm@Ivm7;>dN)%q?F^=!scQ9@c44*D
zCps&TyWi7{h2XVJ-9A}KU5g*Zxym>#IUM-z4bh4$eoGH+CFo@I5sJke6I7s*CbXi2
zF49p@ivQ5sJS|G
za^_@|(nusq+VdR4@}X4`XhQ*@_Jo>^QfiFdCy6Jv6P>Q`cPa^{J-@`QfxN?;hgsK3
z+L1poOB7RZG6!OOeZ@2|qnL79X=EN`e&{IP7!&#w2o)5Bh(MP1>|!9wj6eEG=I_&<
z8`aSKchOHC)kPWol)g~(lh_5?r+obsfg|%+Fkp!Wd
zB(u>@^rEMXgqaiL9NM#0PeJWB>BFp^dSa^RsV4!oS3UKT_Mw%*$>^s#26HR=DORkX
zcD+bBY6tbxTE$Gheu^3WbT2PNKZ&0DTKeg|BK@?N8G}Oo)ON85x_@B)-2
zormfL)ruEX&3fK-Ax>zq{LWceMlXgR_U+WbZ-q8;!
z5@3aN#DTDa%$8MzCU3;Bntf*0X$?5{-QTa{|hYr0{eIxowH7-hf4mxj0$!YPx%Ci}og{ZGZIx?wC
zAyBmsKYh3ajblYF;DLHr=W-FAb4x?>Sl{yQ-NNnt?C^X2eBswh$=@8mUx=}dk<(0K
z^NF!NQ%7nw#x4`Ptt;?3|_^bjaf*=Ge8)IV#EZ|-X)gnycM2e;sO!U@BEkDP-h49)rV{*{=cEGZpU=^fBGuzc^g0Z-%wx8
zI4j3D|6cm)smWP=wP#iz`6dVlnf+$m;C5yFhm}rp=-m&c)4P_VTOD5|`$b_L*o5Jk
z*_F*oWFs2Xskgkg-MNs1O;=XhgSyT*iwHL{Bj1^_VTpu=8gMu>=Y7az^(B`We*7u5
zZH*tljz0X4x3c{Bzo`#*`C*Pd|DQfIQQ95QheJq``?u7Gzc?+&*Z*GnaLYM8^x+lg
z2*Y0)e@s^&Dx16h*erki`;`Swm;@C!ttf37&*IT1Rj+!ErXGCw#Tl-juoNR;X>B{q
zF1ZcyK+Zw5qUT9i2!|U90RI<+hmiwjri=ikc-nsFCYe4<{`oa{Hj?(o_0}KPmn|p6
z?FKx7ihz>}#V6K
zs!dh1?+&`N(c-PKX(8Skvo)+5H4a-Rw(xQ+(x+6?oz)t2*d~2KjIPHrT~Em_O;Ug1
z{L%N+*d#vUk0mao1V$Fiy*6O#{c@7&wh7M?IME)v@lNuX|ASyu{3d;CkdXl~6gQt*
zOH7S(|FKxSsmUMu!k<+&Pp4+VWFWGprCz6B?-u-Ky-&WD*Epe8R2Fe=tFLXQuSCEn
zEXekCh#F@m-YpG%w`VOa|Iu6H^~`bRV{)OXeG#=U%GSOFqb|?iHF5fTGWMYFUQk++
zI-O3K%kIVObAyh}?!S}KFOtCW=ZMiSS0IFY*DvNgTO!Y&vWCw+{8XoOs|l2w6=XIm
z$ST=;Em;+j361qe?J;EUC3oXVWBfmpa?G_!f)a)Id1L7p!O~UT#}NMz8uGlQsSEGh
zrR;?Cl3bVK%DmjNbFh9@b2V4ZKa#6v*@4hbOvS;*n|Vd23*W`3^f{eOoG+1FfN~OH
zZa^Zsi7qYQw`I0QGlkc)c`+p_voi=xhRFbjSK^~>&P#eRcqc@Fewx8=(fc@lue=W%NJzI3JTQlR&=kNd0H}GFwC60m
zLrFMbc{h0Z&sK&dZ^BDyY
zncfO3vPRLy?v
zn=d5)5WOiBP$hquy60vlQ<#?}7AnJ%OGh9+!}?Mj;VtBNQ0^a1Qf{`ELse$d7RZkACL7};
zy&9~Nbs^GU5;qA`E*X0sEAR&e?g-YKQGOy;kLHSPi
zc$Aa?#xPj_?xi)|b$Ju0d6!v!7l#_*GuT>Ev8n9(a`u;iH)`H(`Cca6F5t|{Qiv7Z
zO}itL#F+aWQ!NAT9)P`)`W)z+DWX7g&BjBXHFE6
z$Cewi*jjT%uKgLc2IDg;A^BKLkRq7;2^S|M*suYRCdnoq@ZqN{;!h?$t-|-Sy_16R
zlPcM~VkjSss20W%>2I}mlm$8EN2o)cJV$sTYbiv4kjawKr4kZ1-Qn#rUHn40zsQ+B_wf{g0giV(>$v+TsKGY0Ka!d{#Vpmjt0
z0W1V%xMM8GXss)=u9gis87zD9kn8QzN7Dar<#~K8eJ`L6+a|Fz82&rr!jMRlOD+|f
zD)AzER$2(}fo^Sd-s#?5?3ZA8CBp6vE3%o_;BSa`czPL8xsv3iKTfAf5I`@z0e!Hq
zF9md=pjq#zDdARh2$PC=WJaD3n{(E;ThRuQTSD1(cyp%t2YezX}sW
z8mh!#6HcBeeklYd6g!f=KK$M$d0lQhBVp^e)b5a{j_h9{JO{@a`idJN?2fr_Dq)k&
znmUk?&b0r~bbv^EqA(E_egEG9`*Ab|a
zWW2xuJg=5w{MNd^ZpvPu!M(TL-zNF>bp|H7_h;&TM_?L|yry}I_e;Z?%ZG}cC_Q7W
zQ-9N0tX3&4WK)fR7G#CrCU)OZnyghk<t!&lC8e3AAH4M7mLAU(RN
z1y%8O(0PZA_CaLwMQTaCuB%V|vg<9X86o#pvL6GNI+2PDe+Z?>pa|LMFj>oL)1JrC
zm8p%=D%st&RGO;NWub_h4}Xx6Q+!ox*K{GTQfKp)BAvILEAi29d5!g6a
z3S&;qA=GOVMrgi9Xx@|al(2+E8$YYscowC*Urc)zxh7yvd$c@5UaM;Y9wDmvn8LbR
zICbDd5?udWxwGsvm^kY4L6QplsjJ8j)3I1X1;EF;U8$)67RyZ+!KT{PKt16$Moqk$IvujT&l(El=O+tUBX|BLiLUhVekf3<_Zj{b+p
zzn=cTcq{rpAOu>Z|F16nchvts`rp_8B((pJ>i<(S`k#v()&Ib@z52hUNdNyVy>s9C
zpS;x_)&JBlaxts_kCFO&=zl2h>+64*s6hYUDsJ5WhWL@T*3iZFU
zIz+}Uf3cFvCCJTAVY{S<4#lZgyDdHR8<>8%ut6q%9!j(SftR%C=^
zXKo|qsYz0vZ1|4V2^#u#S_n?F)zuYZ_9W)C6RU4$uD%stIg}W6Z;5OaJtuZw17K*%
zI2q)+;Ny6ENXgmfgf|~&U3a;-DwA1S%7P8qe=rmuRYg1{m^cZSwXr=eQ9;XD#T()i
ztgs__sXdrz_LPh)ZQfUwLaY^cB3_2KrE4K>^nuCfCp-+*zbES;2rxXE_Ur?Xw$7Q)
znJ&u$py~yZtztmBkmFnyka)1D`INM0Au%yosu~ZpGgBd9t5AK~ims8m#QrN6)D_M-
zd?wKMKIdTkr?h7@Y|_0bWB)O3t+Yq--#j%HC$#FZBUyh-R+o|zJ)t%Ej~|LuodAN{
zWwoFk{*3h>he~@=h4ZA8j7o4l?RkhMLUFy3FJ!f8eAJ8QBbDkmTamjlvNOx(f{rX{
zs;DeU{fei=ixW+Rf8Vqxv#+G&GiS5Bc4!rZ#vO$y+*t*g70HmsWDqZ8VP+MCFjz$Z
zi6|0UDupZvk{*R!cKT_lkFfrYA7ncTGm(IAdbjjadY$$(9wkGduk5&aPKQ%ppySC
zsd*^tb;S)uQm{xN?@h~_Y0n5zP`r6q!-wxeTFT!V^0%EY;o%B9eq4A?IZ==KERW`x
zj&^_52ASOWUigY~&PHk1hbyX9v>fiMTPgS9l@(@Z)SP_q$u!tl&LA0EG2`UG@YlQB
zUHoMp?l!!gXW5`PQ45W0$A-vJBkUFn-!yy6IZUMGIlEIH^J`Wf24qZ0KI=dq&iwL`WqI_TI?zn>MDv9HeQpg}l;A&*k$rtpyVDbf!
ziSAFPZg8{2V2H{{65u4(>kAcySJpB}64g+JYfK-tqxiyvF$e3+0lR1l=Z1@x12+(-
zqjCvYf(+^q6p{a^1otXNp$NF2D-67(L)D_2IXOpYCcN2y<-ltKr9wTiCQ;VvOGNzVZN}qwYn1t<
z>;X3t2ZX><@4_>=Ay-K6fqMlw_r#aCY|?0}n0nNfJ>PH8w}Ufh?9`jq32qNgUMvud
zmvz|EX9>j(mc^BnNGFEeknlHk2`p*Pv(OKk^83N;LDp5v`B1Q#
z2SaM6bczQu%=gUQs#Jtaj7=8>0JxXtO>nf#%c|m3M2Ll@)ciF4~DUDUeK&90V|o*qL->
zF;GwCc|5SxXe>Lfz2M*>uH+3pUTpN2BW4L-#6d^ly06Q2mc|S6=_$F8g)yehsLXK3
z1B;yKnOv}bTSRlbaWUDv*0ObKAvg(X%z4Euo|WKEQzwG$J=WSs>Aco;d4fE*j=l(9OERfc~}{%H!o
zNV;lAxqA&o_2ausH=vw#K*NCr?4rN|&$y4BAAFTo_y;PdC7qim^`BdjY4U&_7Q&~>
zg-Zx=j`gW;;ykSf%SuW*jeVo|e|?#-ZCm(39bHZlv%?R{h|B4URqHs$$%@L6hQ7L&
zt%#o46@E|vDQO-g8=Xh5;T?-I#gcG7%DNU+u|Q02gb0WHwT>o{E#wI_F}01^BG4<5eB!F4@2?u
zS>k&nL^&X|lb1a(-8v!1V*|04U+B?*^`Bq*SSYSw1jA{jFoq*`Le55}P8yxBm}u6K
zkIME3@PPC+xjzV@2_`|neq;PNnq&ZWN4CTm9Bba2==U5>~E2vt9t
zI*UgpKJC&;mOKuJ^w@g>t&tlYw_gkrHV$Mo7BYGnVzHK0rUF_MbfaC@$ruDZ{jGnv
z89>)r^Zvj%=6ajDnuxSZWu1Yg^p!g!y)qI+#EwFXI9eE2F@oeJzRygmPvk1n#wipt
zl2IOgPM9zLOA$llrpMIayA`FuNW0x(V0oIMCgRuXCQeu!Z(N!y|0V*Yx-stU2-UyJw4%RmZA&u9rqko%Lr8oX(s2U6L4HMGtkazQ^Awx`
zLg$yAaZ+ONSHZ+($gC&rnoq-Tl{bGU7{3fjvk|G&!J7&>0pQ5|)^qlV9pBTg@1h{X
z#ZkKMWw=AWY59j;&tlu~J&<=;SEw3mFDoh389P8dF@_>CnRW3OnZ-u$E~GR%#%{ReZ2OP89_-Wuyobj<>*7MxIPk(1o0!>Bd%(
zB9IW~`SMUbE5E`WRFf6L0pziCOz?=usE{LZ10r#sQI==5PgYDH7-(}IX8%22SWC`o
zt9!wU%+fxv;eqoOq}a?s6RL)*GIco*yS05R9~t>AMU3vQTh}~Vc)sXsrhE+~*{`4O
z*9Bt5hWq0Lf!Lo`
z!023NLfFPaoH|LbgtG7hUMlsJE}z~inCY5~T#
zWUmqO5d;oaAxcZ)dCo*CU}G+pWmUsp!ueyzp75MS!tKj_;m^}@Bq=77YhtYiE)K_$
zWDiapt$GBXmnR&{+EDkL6_JfBwXCX4*>5{QhMIJ7i9pRBsAi{8L41mE*{|?fQ
z<+DrI&>hT#kD4!H*ef_G8LoOmi_5vLD@%iLJa0I*l|9JA5|bp<7F}b6z3+aZV7G&j
z{khHqSp8)mV!_9Uvd`P_wbJ)!8O8Jjji?yK&voen1`p+3k@^{Lv-rb1VeDIRRivx_n8b}67o_Dt)y4%B
zZ){`mTeIDtCp&xRzR8uhv*lrP`NSupUH1Jpcv7{-isaP0@RRg2{CPiexu{LMAC*O?
zzW4wnnCK5@#UT?aM+7RZ#ubj~jscS3Ut?R^bL!C&-!ycn0WbIgIUvp2rS0(50xNPR
z?LeU+M;CqvFtXV)2OS+0+x}tj+Db@KtmN+fHSY-18`r<7!dKTR$B7{sF?u8|b|@B9
zHxkxg_f^Xayl6Y#8MZK6KRm)4zP;1ES$sh-a7;83!VWh!yvvM0DFX*M9bN+(l
zyzwHIBx+BP!392X)^{Jn
zBFooP?{EjH`bFk(=5KT&&k1$oXZ$BuF;#__zGA83bhJ{xOTN-Zo3*4x^r%>@YRfJ$
z<#9>mYg(1+WKZ$N1;f{-rqC7#ke|a3qgyEN4?ax9@~nF7evM~t%A9vECrFvZO%u3@
zcsGmWa0sK4lSdZi1Ky21keFtmzI0Vo^%`
zHcjM@J(WKVv-q<}!Up^<6fmY()4t+*fp&wy*03p7$Csu2d8gE>ArsE3xyakV?Q8Pv
zMfvj-FV6EeakW}*JGed5JISgU&&kp?*LYj0)T)W-iPB9IE*L0rA{(hfU6K|?)NZ`D
zO5(3J`(jqnh49KMF@l`syd7pc&(fvnRa9aMv!S7Ld?km5<3O0;cvY9rVHLq|DMB#T
z4UoUoTt<%I=^TVq<_lZ>atByD#Ax2N4|vudM0`A=n9oM$tmq%9gj7=PJehpX>b!(f
zLx0p(*4--h8z)x~Pn}V5>CLjlfRG>qyWWJ)C8k;~F?2C?h^sO)n~}p3l*e%p6*8}p
z#~Mc`r#CG%zQ#$^jWUd5%Jpcn@^t&
zJm`Zym6qe9?4i=wXeQEn(C2X|l`MT8&W+ONb%!f`#t5UPJvRuk3VrUOWqYB|MPexk
zA+9sO3zFuyP1@&qOkn4?wUS?}<_@JP?w3wA&lk_q=eK$nN_oFEt&RL}y@*L~t(sfB
zi`_S^6ZOGt?{q1*pqe`&%wc|^+Xnug>8<5&$lJtUl6<#=v*@L%6*^lqr2W3b2IFGU`dZFw;P^6f$CvB6m1!sAbt&42tt`rPPj%opAi{2Bu
zPF%#ywm;hTis%k5X_r(`o@ek68V$^C0fI@
zy`(lah~RF@TblNOR|rn`L_YL;Lg_aa3T=2Z#}xbPjb}C*1d-h`TDGlceU)$s)lO2*
z_GX@E3Y0C)wxI318Q;VlPm_Igs;rlFfZXPJ3i+%Yo+PR?gVjbv+ZTX8&Mj1ojvm
zi)b-tMeAont;o%Mf$u+oCN8gCRz>wpf>kAFu<%4wMx>pIqFOWG27z+$nZuM$m3GSK
ztYqIj&@Xzol`naRD@id*Fge%EdL_;8xm(
z;&blFeUazZvfZ=T7L`_&ETeHzXW+Z#n$*s8
zFk^=??h*l8-C`WS^ZGgSpP&zS#)i4f1k|Y3Ujvtf(=278Dz(=QSL?BWM*RLSMZp1BtVy^_Fex;
zq(BuUvr+q;eoAbYDh(+Zd}x#1^SKd;F7@Z(r=Q}dU)po_K|@?5TqV1`=ULzxn#z3N
z=)9-d-&)*0+x)goG{3Q_=C@VkpekIU
zLAi*j>gJ+V^pNUUQSKs>gmtW%2UKmMT<5D!=HeFbLf&w3jcQmf5Y$@sF14LS;g`^k
zRdcIXC`i7j(%<>sTK&DoD>jUL*TipAn)LGvDy7M#RMR9Q-o`};N)Q6I<9B%%>hFBl
z0H5uh8cJNFrODG^nvfEANeN6+BBDO$8QF_fcF?vbyLBL+f7t%V+i(Al^VIS!``gPm
zA5gP8QP!}0L%$j%H|oX_>4MsrGPk_EEOoGa%WVeXQ^g3MBu4lGAxeJR1T=nQi_CAU
zz|Q^jiP8~+yE_zRf`@iqifOV?e{XT|HD7Tnh}@{pBZ@bJkKLr2uY-?6a7&P;Mfku<
z{ecis0X}Z@25)fjk*q51TE4j-NEy5eSW0SiNzBBWM;vC21TU@S{ZbW5hGM&Wq6drK
zapk?WtScEIc|p=DrZLOQzzLQd^CP(((wSR$BzS_GcP~ukaC6GKq^~I+KQS+;I;!+l7tWQ2G8%2Q|-+2B`6?EMp
z=n^Rj4Q>ZRByW_!ZAxyB3)YHodYJ$!Vjo^yiA#;6vu~=kex@2UEI^>c;qUpTw=71G~v6UW%q)w#;!LAU-RFR?S=}oB{g~xmJY^SL*
zKs!vHZ&Voaq*p*8>@QLXet3CHA$f9!h2z^tDYO+q^B}K#0@3e+!8;7W*m{+UOD8)#k?
zT|>hZ+q$A%RK-GY+A8Ny|AaEuH#WO;rSlsv_F1Jk@O4@
z<&N$_D}F?e$o+sU>+9#j+60M~rat~u%*zHyyQj32zE?@Q-q0$Qm?C=Qf32-RaBF@5y+?6H@2_t77
ze(+&-3}ntiL@ZFODH*N(M+Vi=Sn4T9>AFF<_zpc;=cmM}Mo(
zL=z`A^SKrI1K7ewn^MQqW>&x|DtFrICo%KMdGZP8%+ONCxFVA<6F!1jL^@-S!^2`7
zPYQ|A-BZIGi@cF3Y=^|mEuhU@3r5stcRE0dC|ua5I$LY6BFU6Xd+wwbV*`q&N!_(E
zi;SARbBNS5UWPu4jAcx7x8nI9~F3uP#G?iRjj15Czw8kA$zpjT`^>sS*znD5boBXe6n2yqC2F6CA4?}cIwqaI&~#+y(FuQT
zrdOIA&bs0KBxjj;aqsgBdhmV5HT5a}$xbay=0>L$j$|;2qaJ#we0PjQ*JWzKuVouZoFDHU8FW%iec4QdjRaA6MVq+v
z%OzG|mG1{3;)%6l*j4*Zm2gh2Ohr`-4jb4HgUGMQYz>0SvudWI$ec}k_9i-OqV%$>
z3Q4A2l4E)e)e`foFlzzK^wSC32+}hVmK*A*kPa!5<6a(Y0-v9QEf2A3Jgd^jR%-Wvu7wbPm1KS$^sy@e`
z+28*Q#~(M4@rUbj|G`mhbs(l3z-k
zA|<5g1mCGLfpR8_?PLvxyEE6#vb6;pp|IWy38Y)55XliqB9g;-Htl(rnOPAlGOwq(
zka&0!`QON9Y9P@VQveYFQbaVZ$BlNq|WUCVS#9dlGm#U`>ME72x8c4{L@
zxEtK3{>;-%eo_2Ljy|*FCo-#WA~Htyvare9L8c;@NT5Ngb7=&VE}JuSW5-8VB4zCQ
z(R?IIl-xR2HoE1_ymyLb0?t?DVysuCmfus6MGNuIu#5J}pA>}ts-YdT#71?D?Au|M
z4Gj?l$N&$P3w7niRMY>SF=9HZphpyDX9HUL^Q@X|m?LQ`qwjnZ8lA^|9#;~;*LSOh$lBNqt;Y>*G274Sc5J%|@b;`+)syNXf(|ujmCrfKFj73wNC>G~rK63N*h_y^$
z=QRPUp{2Dj7*dqO#-{~usoL(^M{*{m5(f~$IE7oR&-|;4ds0*DOZJGRn(C=
z_86sdxoelvoMib0B^8g^w+A7hbf~_WY>UV^W+g>$RmV%jF&@FKVLDdsm_?MUB^B+6
zGMLMGl!A2-C%7Qjef|o`&Jw=tlH8+eEwZ-mMJsX)m#i<|kN=T<^?*|66=uTN=qx~E
z4NPM8-y7v)MZFZ11tpO?Az5GSE-mbA966NvO`Zf3XOo(Eroj0bePCYnMA`R0va6XF
zeWIw&4&ULgEeT1HYk4Dp
zWct_#Jgx~hYX5Oqm@op|0PQQMbjTBK_ybc;
z46-0C5%G#iCCoaB{|zBHN!TFcl%+jC5eopug`}hzIRmKEdDe>j7ieLE%Zj|9l*$tJ
zMe<}egvpv`u%Sc}F7Fpg%wS1^&`xwEaml>NIL*J*xGp-#c{lAjc(@Vc*iX`X*bF;X
zK$mkt@q)H*N=>_gQQN6zqG4w}0QpMbrB1nquJ)v#|PP^C8JV9{W
z(CB>ZW8pf8Dp%wRzn#=Q7Ic8-cRn$AYINRI9z03>
zvIgPF31ZAdt_227QGAIDgRJOpndArpC>gInYt6e+@7*MOTg}E+9+6!s(gR+8w)>#W
zd?j^BhCUN1hog!Eb&qfkF=eGt7Pv)+nAwmKTCYjDoiQcL-`R<6IcZm6+m8!{P5GXq
zj`hPFfFBY9%&r1Z03(~|PU=OTyLyXrVN#bsx0(6SrtY8Vyt7b0lr98cl3{?yJ
z0ckMf!`@nV^KqNj%Mue8^>Vg%QP1uWs%Ge-UoZ7zQ9WCAk-kDk#Xo=3Hc{SJ|+hK)+K{=)GWn+NuAIz2kgsK7
z!_Ns&=KLE>7Ay}Ns{AJPu_(pBY>=pMm-1ZUZppzd+a(IP^3Jtmtz{pG>TSp$5V3Z0
z9G^HW}hr(YVEmMzEEC*kvJWCk51f0l?;9A(kMcM1APXvZMe=U=89@f#S
zO})-MK>qtIoy{8ox(bOQTFoQIE+xM@4%#PV!3TZyYenjFI>I*!Q0g9917=m=SyZCT
z6_vX}zJj(+EmY=JvBT;BH4#L}yZ+>fiv9+^QIbYS$@zl<*J8d@xLmG4440%9fUzPv
zf0mY{Yswk4K;>pX0)F$xR`|*1td*L7%caP_K44$A(Tbi!WN(=$E9rxT`CKZNC|>@M
z@cKR}mO5P#?6N^-4a)fZTE=pd&-ywp}Y3c<-B2wlN
z0$ZG$PRs=+5LJ(nLp;az=Qz93>_Xeqr4y>cJ|(6j`!y`&JN4i)J{{In){`rY@l3?Z
z-9i*A?b!*leQTbaq#<<%1SHp$+gbQw>#iJIY{DI`D@U^Pn^|v;4d1hlT%Ko_=g>`X
zeL0Q#9F3Qo@5Z6y>%_+3JRA}cMen2X#hcTe7CK~enw&S60%RyFn}Mv`K?seBFK4!c
zSSsBT5>uz{ZD)I7OApj<b!>Q`o-~{fY`z+Yb
zEw06Qi+X3t7s9lkz@D_(8wJ;p&&9^$OPhrAw8w!y@o*x$LvVJy|KEso%G3|>_K>uK
zX92TS%4x?EpBC&{(YyHzU1@+(ygGSmhc8c-G@lqs+@ZIAXRw#_IPXXlKIds~mN7F0
z{qezG*33dub1I}1#G3Ye1PRIuJOWlEKo^}QA}j@=)pp`?>~8^yKF^Z3(`8&{+4WCa
z(JAOQ@i$#-bFjO=$aY;AW*?j_@qN7PLcqoe
zAlGK)SY&PUpt{DO6*(4A>l$qT=k`oRPdM0gK{0f@n+b*6VJ`;QW;1bdANDF!-TH90wl0If_znBmlkBI33H?5qHQSn9v1MD2cr
z+p=0Pp7t!=v!!{IYe_mW`?y2oFxvI(PYoz^BRQc;c*u24)Vr6?
z6CZ=+rAAp<2W*@0NpleQ0p&uR(Q~Q!A(>`busB51YyL5=ks@kz_}HHk-CtV#vaMzh8(>u`EU;<_Eb9x@*$bw
zXgF4y5`mI>jBk4<(6Gi|KP&~GTKO>Y9YFYZ8(WkO`
zMsUROSl>S&f`RE$=To%#5@U64=^^@xtPRN-0g3Mu8)(Yz>pxTkc9kTQ)^ZkvD~LJj
z$oW7pi_0kLvq}WD$OKxiB(jOaHD-RRXlXm?RR`ghSN1@>CLKeeX;lBzGYVhQE
zHrn99Y90`Ebkmc?U~g~(lgIOhb#7L~LnSiJ5fz#5_TV8du{JjO>*m0#zrexq*FD%u
zf0}pYLOdud`ndc>DIXi&SXu>yR^)!3XrGpy&y^DO#E%S7x9-a*3dJZ(Bi=GhZ3K>T
zHiOLkfTXWTm`r7m$Vk!;L9fA;NT;-C48ct$eTKa*FwKhG(4WQhLR!ZL5JV1lI_tr%
zL%3qcwtmLOJu@I`m0QO~TPbKokEDmi@qj$xZbdG}h+_-v5hX3V@N+C|zAH~M)S5b&
z8zVRJjKq1XsT=c4tuvP$j14z@ld8&}0EP-Cv1{jWqjv28?VZRlNs5N5-0_^}qeLFP
z4al^vMM;!iu9bd^Qb=+v7G{XlEn6Wgriea|X5{2?WC0hx%&4Yh@3Sdwoei6TmT_v5
za~8@uXJIkSlT*=#7E*6eIMc2urK%inzxduB8Kx23R#}k_m|P^TooKvNIY(4?gPpj>
z+e%X|8&NX#0Jp9`D4lPRnk72<>3w8@A_vi<^C1PPmaWhcd;3AJp_(LACFQFU(ucZoT8p^R
z07AgJAnr>QtxLve#SL&{{@>qo?wz?aNdPUpef$3F=Oeju?^&MnoM%7JIY$IvW5zt)*7!AIdQnDxv(NSL({Sxyj+GRt>=iOs9
zWITk&JaE!lts?Nf__7ITaKPjl_^LMpU`)^*Oo0%iuyX*6%(T41GA$i)H@Xv^-io9h
z$J3NF#&#BjSwP2t?$%8bMx{4_B(8!2%cpVxN=;)u=PtYgT0k^>t(9M!Wd7N+OtHRft=+4%7-Gp&n
z1k*JgidXjqt$K-g#`IrQ4oKM%*#Sqmx5L9;19who{Jf2I>Sh9#V=tr$=8ugtqatH4
z(JR;2k^l_VMjjOb2#(;ho8YEdXx3*`t2_H5e
zcPo}_E!pcdCgL&0?#BNmQn!U=<`4x3iMWxr!P~lA7~w@3;Edl2%jb5@L+GQ
zZ3lTyg43&5q1uFX1*1mix@NO0pdfU8x@Bc(2Iy4M)RObIHCI4w$U88H#q$SezpV@|
zoP^HtJcOdXyP=12gBB2pN$@(ad8&XZbWu!`hF}?Ens*aRHBuw{J^nGm2C^Vf`6R)L
z?6zR~PUMb^#Fmvf$(JeQ+UReF*YM2W0+a73URmWls)8nNLwRPOV}yy0MH+LqojEa~
zfA~kTfJy@Dty6OGOU*Q@$jNt-c^*QHv1gVZ7GJ2C^2Tsz_L*`CJvz>(>nT!OFk(!?
zpphXVBC@SOZ4~>pt)m|6jPU%AWaeDX;|(vg(=nI0O-(F`oI3*_hLilRS``!U$IUqM2->@r|EK5TD-qK?b)k2=bOW0^Wt9d`WegqE(q8J0bFZ}{(=40i
zm(WGWxmU|%;3y8;OFglEvG!7LzCmH_hl2yt<7RMZ*>rD5pdCAl>-W6OnLXZK-)tj2
zn*cJa(XrG8MvY^&lRk7x=jv7e=T@Z8wtdxSSDk(-v^{+sV^ErlSa9aJYqgvD45nZP
zNWGS=Sn1%foeK}NdFdt)?9R@y@?+aucV`v(t9+Zy|02iJR$|Rw_I)co?nX{RxHcE}
zUJzMyI8bB6n{6(8G6GM*o+ghx+H&f*$^|q91zL&@da)
zLluFD^-B+%6T&UXhe?RmHOYrV(R8Ks@MP}*^zbGLk?V&Z#wk_%UqwFD{dFzq;VwdF
z2$5p>u>3V)Hl&9^Nb`^$T)bVE3%bqgH=2-ihY5tC2an`e$swt%2I)QNYxzu56z;T;
zBvIr1iLZBC_Gu6{?de73Hl|OiPTW~(wb+RK^8SgAj~iOI;@`@Ixl*&L_|_O}L~P4W
z&jfKve+bc>R)rs)x1e1v{(YjfLG)}0ZZ}riq*!VeexnJ#hY&LLc-NTaq2bV&9#Ttu
z?TW_QleA4o!yw9s>7IHUhh0IHJF#!;o4nS^G=V2x*+{QFZJ&|tp{`|EM^bIMSKAzW
z3*ZR^8RV6*)F?)$npQp+ZvqnY4(PrBitFE>gY|c!&MI#5AI}FJ&mtgTLB}y9&?xBG
zc`(Dm=b@zkHu*06qTVDO@)!_SsWDB
z>bQ53*)>zsoas9#r8%hchAqpqe9*Bn7CUHea^&u{u?x4R-6XNHN;OdBT|GAThv&Ru
ze0=)A%3vERNWeA_e4hl@HKGAmLr>!=nC=
zEEV65<|u`i3}Rg_=b}!lu{F3@6n*Sz7x!Y$w0}toq+R1i=pZQU4
znu57I4zx98_8krhZ4$fekBoUn`}@1aEd
z7|55(y2>OL`}d97_y=v7#5JQTVi$i&#RT)=26Klp01N()HJ3i5I&lwU=Qv-26cZ>Q
zcO^iqZm}fF>ag3$N)G$kTf%Cfldp|XSxuJov)l}B#K>v^DU_eEt>%bZ0(DU^tg
z^pfe{)V5PKJc!=YF}Xj5_#~aL=0n~(Bm@eUS$Mfo#of)*c1C~V*u-)3xL+^C0#1<#
zQXD~c5r*cz&xs)2su1@-=i)CA`)|ba6lMPwq=!Rgd~I9W*f_h&hTXY6sN&6JFt8<$
zTq7OpwDXl2&;;?>c<&D0>%a586;FC27V64cjoRTM`;MWwQJt)IqGXTT?6`@N?@bc?
zBKW}(%s6mjJ((Lg;+Yv8uO-?)fNG8=dTvznjqDb3X?^aCUWHuUg9^>ZFKF`L6KhJY
zesyp^ay1`6@G?&JNt`)%N;(9NHf7)>$oQw7SgSH!A&rzh8Q;?Q6QViEG{uNTa6Z3I
zWXQo}2l~ncekw){Ewt2c%|s^dk-|*espsqHsF%@SQyyPac#(UyM+~8*S0CsT3I~T_Kwp7C
z0}U(W2V4Qj=+95a53y7yvww#~AE{zz@vJ*!M|3sY{R{2(o0HI-hLIq|2y*-n6%QvW
z$X(ec5HT1=bQz;5Dp=RC3NM%v#&wfpsXb`PU#yglU3e1S8P8-cHsO~WpBWnXz5D9A
zoXf@$+Tq;lB?RmC=aF$)c?=5lRdyD&?6(k+y@_8o>f21PiqTGHc4QbsLhu#bJesH<7a%L7nAHwGZt(~%}
zx3K{
zDa}g}jWU9xYg+;bL`$mHR8^9et9y?6j{Fg;=uIEaf2)NnOrP&3?b6xbC0oX8R#veLp>sb>gi&u^%CjPoBDod4L^)H8|LmG?H)
z+#gHr#+xSp{zU!j++WVKEXYck>eut5k$f_aXCmn$QC~lV<)$mu{_9PZA8|CVi6G2fQh1#aEc-9C%uFX=1O~mmPHRZS
ze!PI~DQ)L8`pcU9p2VG+OzC+Y{l_6~S`Q&L%UI%vZOzswmE5lr=Fm9+C(?*q@`bl}l3wqpd#3?!B4
zOfIXk6YIoQHR2>>6~~>}aehe7I`Kt~*reKBL>StWL4D8aV-Km3QQ`zz4EAKyOlR#K
z$tOvS2gO2V$4YZn%}$j}Ruvhp4eHQi<&arKN}Y-RvzauEXx?L;hl?aMhZ??SE8&;d
zW~ZV(o!kbW%)8YZ@dn7$j)~cfwD-Q?yXx9!8tA=;^^n2RBVN*tzd@jn66nCsumQcs
z_z?JwnKTFoe}I(Xq7i}bQeWj!ranW5O$^{Krql!c8=e~iJdF~bhO4t8jC+P*!!(L9};ud(OtCA(++Sr8W@3G(@zAxbn9>wG}7UMN1JAvSY<
zSyy%@udV8}dJv9AydeZF4Vo$IeLNSR@DwR$Lx1&`t%~?*qa
zxL|0N!dz9`X1SrKsE*0=+|oklh5bQ=c#fO_3Eai{%QQ?0a@EYX<(xr#9Zg(oDT?Gs
z#D=nVn`=oF%YsCV5wdYn&HUrdY5@n(Q*ZnSZ56et)AaH(;gsL_v75es{6@*3oT7Ptoiar)s
z7J1w-{p8xJg#SR&pU)W$oCXI30_a#4+b@BSc=BSMqsSBBiD1s53=b>ySUjT7(i?lX
z*j>`-XGgrz$YOaN=)?KghKkL{&zI*h9M3~}UwY=^dKb}Y2kSP{i4?@5!m3*WUVfrk
zT0sPbvX%CI61n}lVro^Ms{-;Ihiuo
zbS283=WxHo#_XN~-5wVVbo`i#(jd*6DSMNqhq0-yytez068_?b`X0_OV)T~z{sd*L
zjpn_SgVUk-4|k-5p8dxJBYs1*_790g^n#s+`sZSozQ{vI@9>F@BMDf=Iu2nPT^oWf
zaTg=Ro#)aRt)XZQTQZh;_cAVxLvBq2;%0c`^rLHc(d?QSuCnYEfOmt$8-in1DmGKa
z7-)?NWtXndAbKLeayPX&t?XXAd?=8qiY>
z><74MA&E%eF!rgb}3$30zTQWB6|+4lH`nBCKeUSJR^we5_~MxgMgMrl#N2N3lRc%uO}3E^tVKaz<(+`0bd^#9e|CiAn7
zbJA+WGYBSzJI%0Zk}7*Gr4Tj98Iv-I9EAs~oV2+Wnu$o8{YhpNAVtzp$-GNBS%PMZY9?HOpr@hs)3+IN3N2W4V8~eARHU(%o4u{H5kq&
zr?;DR*3MeEA=RWi|ohz%bljlqZ}PvP^(m%Dh`^*E6$KBk=z@Ris)Dgy%v+mXpw~bY
z3CeyQQZ+iWFQ&cx`B8evUP%|wQNU$dvc96WovJ~gQl|mw(6UXLCBaUdQioj1Txl7x
ze4>v&!ensKIb@5AQPu}BN>4FLc}p%K+`3PK8WO^ZOAfPkO0p$lshhgM!$aMIJc_}5;vDU!WM$<8k0Do30y
zp*3_5MU~CamC7?LsCM0CYMLb0c@K|9Zy`Og=SKsP
zqO|v)9u6Y7QBbh>oa%d!5hA!YIq!#eX$A~Y_<>m+k5{mPon8Z&?B@UlPvltT>u2K_
z^&v_gn{|*88*Inn-N2GW%r;6|~AZ%(BpZ1z|J24e{@E&aWw(
z%EWBtIfsk$%iN}=%+b!B!<;4vi!|nb
zDB_Wdeoye{Xc}*kWM_$>v9_G^iyx9F*I0Xs47a>8#B%fJ%auDyj(&OTrYeFj_ZeBN
zog7DbC;~?BJZ@;Ub@}q17r5Cs2%F#mKpE2{2XgTv!rrYZ0q{LqAs$d3#8GEGs0l6Z
z-OBp&p|&Gs4q%{K#{%T!T70-&8G|0Z)@uF1gS(YCXvQN4#Zq&5lPVF0ulCGU#aZA8>$6X@&?r-X;`;#yW>nrGdjb
zWIdTFPoTpBH{{bdGMQ?-%2EI}RO7>X@~i)iBTud^k9BMV3N;+JtJN)+vxlE|EEWc4
zjoUXUcQ0Gbr!c-In!=$|@~$~_!gM8uuv;fjWLj7pUx`1edn%+)8`?j{DLoH@YN&rL
zc4?a)VzcM7LhfL>Q2R-Wkxp=!J6%RsIoxmjpqD-Xr)goV}A7N)3n&nvNV2HrpcDZAEKCp_V566
z$|@|HDWzfXN7<4ORbN;Xr@Xh
zoeO525jIdmZuyq#))1N>p^*9_E!iYodKsg?hhO2M4()ej6YcNg@V*X$+|a&Z0n~7Q
zfu&MO@elEx9n(=(aURx52;Y$5vptISnZ1G_ILZkLMP%@z!ZIcy961}qr()ERH&$of
z*evtLHsqZX2fG1su{d~}HKsn|fKCJa1bSNfyx#OVf{Sax3F;#d0_NN1ZpRdC?ck&E
zU7o$o9IOaU=(HGUB71?xl((OS*dsgM4%d4t=Q0~dy8WV(Yf~J5;%q!c^>DeDg>dIb
zJ;+PMZ_mV@RkqSQp&%(tLV$)q2tP_J(?kPO|Hw`z;ALoA;2vp`*RYtFEng)>tYJA}
z_{*cy;W>LddbP05cGRHkI9|AU3f5~^k#e;)J%o)F7HtvxJ-5HQCUA#_;O2FP&rl;e
zqjTYaIwLC=E}TCbm<`dN69Qu+3x@K9m2LP$d=N{$%H)Qtw(|4~^BG;geTFZbH^7V%
zX?0=`|C2$~M42^Mx-}-_lP%p+BbNF()%_lMBSq(4XbCoSiUQ|QDkfm8lv28+25}HS
zHvYyz?B+qNj{WC6M1thz9}SN>h%y%Xbr5xHLLY-GmUzuE41+-^W*j0SwcNbJ
zBMaW)V8oIs^$(DCEZDUU)%Zb$Auwims5{EaG*RlI(5p6VDK^}Bx5$KSXS4in%@^*7j%ycSu(6N=W7v=kMt
zB|Wz9C-OR`ctIE_SV=U;gM`szxq(VrXNqr*#}iInfwM~PkDMDg9%679`RBFm0N^m`
ze2+p#aOi&Qft6)Ut+RTZ`|(}pepL2+hgh!EA08IbxT2KcCrD&5Fsv)IU+PL4LJ-j{
zWpnX8fW`G(1WcG%Vt&YEDKk4FFlsg@8B(zyavyIHz{;(An#a%&k#A8TZY8dr$vT#Z
zdwjTjBoE(4x3iUf-0SW#VH0{Gw#%C!Ho?Iamf6c<5)R3kfkX1`fgF++@uwO$R?7Z{
zr@Vb5=eODtbRSEG9?1}vkBU8#7gRY+8AXhGhG>^t7D+3MVqJZaTy^xrVktMb0VRZ3
z)jZrK2cnRldkQ8)zuw7r3*O1TRKc<|@1#XSsYc#OJr^G3;@30L5@T9g;M_tr9`R0+
zcqgn>Z46RNy_3(|yL>96vaD*v#CRv0@u{F60{^64{>iKSBmblto3hkDQSxrVKe-fg
zGyf!|2j`zSXv{w;orF2yKk!h7u)bIDP<|Vo2YDzTgRr91-Mojg6Eq|b9-x?mm+W1`UW?FCz(+s+$x#lMm_5T~_Bg_OUM3I0V0?`d
z|Ad4BzGRij(!YP=Wn5;NHRy*8wW^`eKdG~@XyBjJ(US8|u3_w^A5CeGcqZbXd<1&j
z!20+nLqt2z^F8oSLe7C8IQ``>x0(huL6Ch~w!Fz{G|fqY2(hrgJ4-Ymd_GQwE?ruo
z^HSczxRXwD>7vd{>EWI8QuYDxVquYdvL9i=ctX||BY2^If*)x9iLL*@gj4_E*n*T4
zj40u|GArv+_49c$^%^n$NpXIK5IecVKOv#;9_XUjKlzaAef*PUyo8N<7Chq&{wYpC
z4d%VrvQZR3(5&&E@sWO$S*5bxU$P86ZJ?RVTk?2-B&=dzpcxs(=>m
z@A|Jke#_C_u$rQRmBwq%Z>e*BOE4B}6fUfB2nqa_$pycKtQhCFyloH5Tep`JB9tK3
z&|BmN1UdNl{J9zIt&QYYo5M08nRi$kKBd1RcZdAn>+x5*c*I{BQkH#X4gN}yr3}Kz
z{|)tL=&zhCf2B6!uT-zjU#ScIm0!#%NL!uf?+l5M4+1_3T$a29$X?^TmTIg|&0l5S
zYbi3dLeXiKiplnaZYuFwh+1*M&o$s0dq5{>SEf;lQB>Pf((3r$Q84gkQ=kj6lVC09Y)+_ViWIwhAD5K3o
z?s2|M(QcF0y*LjS1tub%OtZK%cOgn7ZA07^(y0Rh`pv+pxk2_&{Ddc>-poY&o6GTP
z3-&<%bU?RZvE%icMEb;PPO0AA&Kc9GWSmRH;k~5HF8x!-!pel7;O<3Y*gC>@Jm>Pz
zTw&`ts~#F6F@YZ04%KF@?zqrDshTWcvy!kfoBa*P6UJgr^2JVC)WP2?a#dB{(-#WVvSinJMUiptL@Kx08he&
z2`w@kar}#i_;q+A@Su%BqWd#{dUHX6{Cj_9WPj$YtN+>iGgsj-;i9ao{h8mxep!e6
zGh1#E;gq=k+MjvxZ$Ih&%
z(R$ABSVWSdD+)6FUt7=lA#0UI)_fsepqRxvUe9@)@Xx>3a~f)ho&9?~CwA%jSkL(o
zB^nBX|H1W~bFk_92#d8{&$;1B#}@yz^_=B%1~TiSOTeuE6U;NS?tjO6&OU1i_6>yl
z0&A4$vE*9Gdd`NwT7!Q1_j=C1;(E@TSM*uW`Qh(jwf`gQIn#gmPhZb@;Fkqy`-#_c
zJj}jNw4QVRjCHe~^AKjpKYKl=p558co#ept>;W8^j>&V>fh)l
z%jr1e#p@$`sLp`?%~=0IZH{3hlJ1Lohl6bvYV9oj&DejsG1*Q=4zbi)Rg#ktrw2=G
z6Xd-qp;b9;VH(CX-njy9Be`zDm_#DmF1Enr`8V68!dyG0)-cC8OZs+25Of{tMT@QD
z2J*hj7fbzm7AcQ!W#BBkOjitDLSa^x3WcjVv#^Jww^hE<${)vOC&d;kIZgWn?rdqG
zb#AYWr5>!by`NM0TJf`)bQ&BCaIJMqh4yJRgIc%NvD12G>ymb2^t4p01fkz9C-b0A%{GLj;rV~h#ebF75}ADp=z=>Urf+Rr~^urr6|#CvJxLIg_^|mM~sR6EPgcu4HcQBI-`vw-ZVJ
z!d}&B0c;>=i8j`;l-VI&U3f_;IYIFa!hWQ*56&D|2AkHuE6O@nmJ6gES7v`kQ$e1IXl>H+hR<%mN&6xNN0k?U
zg=f_h_IKo2r&)C#%l%OuD>q>Gj&*p2az#
zPTLz^Ccz>33yWtYw%M7
zu}0D?kOrikvCjTO(FnNUvM+A!;T)l9Bq*<9O#wzhe325;QCV*F-T4h(rn9!4UZ9g9
z$sl<}5(~L#JTv@EUj^5Y}jjr
zSe;Z(rrnXkx?6xV-LGSjJ(l_k#9*TBKB8el!7O^nug}L)BR&IWF1U9gZ#g57od2Se
z!Zc~Mg<&}OlnB^P`4G-PiZX(vUjp*Wq^<<{cHvo^&|fW5!}bY6r4UFBHzT>018u>!
zLNb?%MZp|#cX{Wcw(s~4=EZ=ndzniHQ6mR3a%1fcN+yz6(#_7P6Zxe{L%YOgFLAji
z>1o4zUbtc}J2!XxD@ukn6PFZSo;NwObtvwcXXh@Bxw
z8k@wgU+jbpiA#={bsYll#c9k%1b0Cjg-%Iqwt^vH_nmkMm$MH
zT}NtA_9^}e_rnO#mgbQQVyRn6J1l8MHBP0lQ<7O#?hfx)nxy-c>bYOZav1ab#|ngW
zOu*e9V;bj73xvk-p2@cw*`==fSowa|BZnYlk5xKTvHX7AWPer{{uI{dL}18g=--P;%MVm(0jk^1s4!0v95P3ynZA0a5S=KH~+AL|EWYQuzHJFAvmLNkVHrnFE8gbh#)3JLi@$818OLFSH0`Aiudm1C{A+|GUqd>fCu?{$C_9xV
z#DDz_gIOBTSj+eN8ykM!X#3kQ@_ZHY6ON!+Kp&goP-OXt5CSv2(|^|yMj-Z6XYxC8
zUKDcvP@OxQ$7CNQ@)`Vb=acaFcrdOK&CfktPPey#--KZiy*^32WOV#z`KjDjiowgN
zmfZ~~H#sKw$d^y!Rri=Gy^xUU=&IspwSG3cL&_&57L2JGG%?{HzN449WwAbVkEyc)
z-D8Faf9r$44Z&Y8_}iktiS9AugWpHn?*(H{1)7~@B7mt$80ATBTuskXm1nVR|oG{h!I`PGACo!7ZvI{OM~rhN&Te2l?C*|V0FUW7FVr03#~GuG@(
z&4*IuF9xMZYy67N8+pur2R7FB;4`URDtAKD>2?H$*^pt{e?2dXNOe#A$UyD|W_J2u
zPo%mW$U^1ePS`9KEksmCba9-n7i)Yn`x%<;Pj)H)+r*dhzdHa_>{UJDnS{SM`xys!
zA9?4ESQ6Hv?WeQbQZ8?lXP+?gjCjNBZ@EZAaN;T}W3dl5*dxUmtg*(YY;$;#>z0ex
zN2^y`b#X(1={e_8tWn)Led;>fFR~y
ziiq50@`#O6hpF>Fn2uch{!WI<7Sjs-!x_ZjAs7E1fh#l9kL96H)wV^_BJrDk*Wb6_
zhqOSXXUV9I>ETzbofBQkP6ntxZN*Y&@;Vp)#idp#7as-GSzY^(i=W6NP;qYRS^e}B
z>-+(QvU~DRK^sk+q5Ovd+h4qN=Vy{-{
zQ9*PA#Rva%rZ7>lA9cbBbB<-uK&S!jFVxmx@xk-07R^e~KtAgwKDgmG{v9982L|j8
z#!ng_Ty_CyEbVfMptq58gCgBPmsP>p4C+pWw~_uDi|=`=`VQ
z=WrIe0+j!X@xk~RPS~s=K6uf8XzI0J9*q=iZ4LbI|Ml^~{S^RwN+k(%3@%Z53r)vnGIzCt(t-kvB;9sx!^zp&#`qV9o4=zcG
zh}IMzym<;kEsYP3IXj3C?#)9VUn__YUP9JN-*3_Q;H`Cv4_-);>>A^P=PCrKL5PY%%jBz8z%PC(*W_oai0IOVuZ;|+pNU6X8*Cop@(=Kuh%Ej+mEzhXHyl2ONM5$x)a9kmo#kc5c5!_H!T((ReTz;u@y^m-Zo=AY
zYbd(fyX`nH^W7(dQz#NgCyvpjuE)&NI${V;E#7bTWP+kWe#f0W<~TP}%U|c;nu|X=
zVXHyCHzoZQx%dU9GfHj_zuSNdZw_C8CtirIsvn2HCjX)Q!5l*0c&>l1^89nJWvJ~W
zVqQcY!+vqCWQ!U7+<3qT|G?%U24U
z<{(un9VT7zQ!KY+y6I{!J$8ndrcq**EI+a*x?SjW7g!`S=XQbEYZHevH#dMn&wm&q
zVWqC;NT8V2>_1zWnDn?=o`1|Onw#`7UEv8JqkHJJ^-S8lR@Y}QFl4=Sq_}1C^ua5c
zk!w>+V!quloo>?@ySS^WKAG8laQg?W#ONq#B^TadV>y=s+a%Nb)+hI>xEOiPZMD2_
z9{C)1iK&499FbyfCCSA%K1pN@9GSC~_H+}Ao3YgW)<|TM+||MZ(m~Pqw_zb7s{?=v
zb7+IP%Jj$P8cBAf(TV|-I+f?%cDL^9j|I^H4;FIqiAM`Gy`hHALyP2doD0dn%`g%<
z5(x6pzs@R9tdmn8quCX#N6zAn=y9~|JN<%w#T$+V%x!pL`HlP5f1ti1BW{IChMugM
z6j?^Uw7rsxAFtwCkJy$Z2HnS3v7>3t_-k5)>F8$Fv8&3<>|Z_6i=8q@|16vsJ9$oQ
zi!m#6L;p_CMGNxu%)P|%|5Dw-uwlC55eb*Dde~k`GdIvoKA)=MI@L(WC({P$$sc-|
z^H&E$d@_|8z)`uO^~b0N08l9%|B}HlUN9UKzyM`fQ>8;0oQv1yTX~zgD$F;v%gD8&
zz0*(S&l>RY91!$}k3Ce^;p2}2YYq6gie?Jk
zDvflbY{kzNL(jA{NazUtUHWGUlr%RstelkaM~|nM*s0~U6Ju{KBIDEV=rQgl-R)Jc
zyJIOo^j~a?^fLEHYf!N*n7J>|F^3CPDPM6O%dB*E9A=nx4dwcyIootU@t+Q){5le?
zFu9grgBb|PHb5tbReJuAjph}7&%F};*-*eI#9j7$?s3n5@~B9S8F_pU@ZFQyxsjuV
z{VJ8B3hs_OEI;3g!^U};Q!8zv{Wk;T9fyox9rCXFP7(4V_)-UN2FUCOcdv}g|
z*KKd?(eKd5*zKvM`~f2U0f5S*WHhw%V?cVp84bR=DSHV!A|Q36dPnaNZSgE2t_9mt
zb;W-g3Pf+C+0ue0qwqi2WU_K*s$+kX?ULb
zV*%&|Sf6QFpMIqQJ@dye@M*eXA~rK+KdyAI^e;A@@&63y;bZ9G9XJPifYBU;5VTRo
zbFAw##3*LlZRxQOHgtH
zLFj5MZFb*R;mo&KN+}Y6TqhwZj%ifJ#A^gP7~&&d`kruz-T5K5-K`LQ>4?(;%{LOLeE$DH*IEZrb|H8`U9`f-(#8IW>sgV;Y@Mv5f!|AJ
zPS7=rt4zF{feFJRY1N?ClfBd%ty9%s=Fr-hbcJcp+l)kV@h=?&Fj|-S9kY+V0OtY0
z2XxZ93Hf;7kSz=c>vLUX7sBry#SAx!L7&f{ueQ4)CRKoM$kK>l)2SG@l?sc(;tdJs;Z~;UYzRkw+3a$9?!7*wq4#JqKf4aCx%grxuNYv_(0xd9
z&FMS+xgqTbhm_U`Xz2I&-nsZ?K`-h%7!dg^^pcC;OcU8Z7ij3`D(YzH
zM||qNHm`re`Ku|KziR(IX3mphxC6yt?97b|CG0$gGi#N-H|FbY)a-K+<;?eTEt8aW
zmXb4WfERK75GvUPvf+%4W;XlG*bav~{1GfDks15uxM0TaJ-D<+Fk>HLgXQ9X
zrQ3WjA=l4hLUQpB4lSOs*HqNa*zV@0C1RlKC;4wZUjfn>D2B
zU{K;I#qsZbr11oA|KgBferj7vYXtLi6qaT#{>^AF
z;rvw7OD=vSO=LL+GnC5vtEiiwefX50ADbL$%^IRDwWcz4RVNp|ePk0ed9orI<+aJd
z6M7QMN#v^FhIb*<|Jxl^{B?U`mN&CVme-jz1X1R^R>SG3Bf7jfFV=Xf;0_SpahbRA
zLcc2vo>S;%i9?n^9UtG625!;6xpq)v!_s{jHLHj6LEiQN1NoA!)CaR#qWZ|P%aHX-#eYC
zwvk63%I>M-MqPZKDmpPs+x_&N&KAjGgm7jn6QT
zxW*YTYg|{pQ-G0uxvQwdh1F@_#HD+#14IhA=XrF|=-$SkP%z
z%X;S%<;7$A2Jkk^^K+n%hgDji&Tmd%-1{K*0Zx|e7J{RmztYoY*|PUHKCLt^O8rSy8@{tYa0k?RbzdIXI?KpD`(;Up>4jM@MC$j;^
ze=HYYMDzzswTAfV3eAEudXkyi!ObLbV$iZNsd?lBvCQ}~^f9lhFL>b=3i5tP$NM$0
z&Y$yMcP&;XhrN-X)>x-c7@b4RZnL@V-6vv{_Wx-3Z=60nu&SKt)$s-q?r&HJp-<(E
zu+txdmN;{KxwCuFYJ$7S=Ba^XdFu%7*@U)orN_sm$VQCv8?-=aVMW+
zqJS@?z(>ru`?W^UaWCk_RSTC!<|!VWmzVb!^a&eQxu=KUQG5CV$h7x{K%W%UAJe7X
zxA?FVy!2Md^mpKvXPZZI&3y~P(?)?JG0$}$rxSt!=7*9UPQjpEO{3)Uj#nyWGZ_XhSbQCQe&(qU=t)b$h?MCiPYUP5cnSV!?{m*}3_x3ygfS-L90MYZ!WN4ZwB)PoW+^sJfQSqyN8bW1fHgrxoqG`IL
zR#1@_G8%aHypPoi@h+w0uogukHocVpAH
z1wst+yBcCkw4X=RGw>vDW8g>obscE7ars
z-v2Z!^1HeCF>VHnef#<
zC9eG=`^$)oH!}s-vCk(L-$bCG+c(iao9drka`E>(*{OUzr>V3b_NP(J6xAOH2q32@
z+qux;n){2+&{!0{V=*lkKh-scTIdPmHsW=YMsJ4h
z^X1>Qrt^h5nZiL@-|VOTFBZ2STbuU3`U%=!V77c7{y$7B1`Rsz3;z=6%xP#hNC&@g
zBV-qa%NXN_!agX-V}Dm+e%5PD8)LIAXzQgjX2@g1aCnLT0#=QeV%rk|v@EB&
ze4klGTu98gO80O#w7K$clV#vwrmP;pB
zB?M00TOxI%#H<=xV7mu)XFN^t!G5>i709?;ZV7nnazZYal5>unGE9`X%Lnb}&=VPd
z=L{>})W=hku)A0RD+Ci^&7&J7m|*q4HI%l|)@6jbt$4HuxotOazqBaolqz(hj+aG|zq${gjKpp;GjG5&z`k&-0=8f~?-0R8-a84_NPV4Qb
z(?@Hd*F-^HFCo@x^m^()D6bLL7;^U)3+$@?2{sd$Q~e0+4ZtS^yKBjWrE-#meFS!B
zFGu_hf>xotzN^3Z)fV*KdtK-ktP6SlXAoa1ub(+$t?2b$LqrL^Ucg4bm=rLkH>aysdxvc?RfOzw+|}I$yW)
zbGJSE(&GWJ`C7=&-4zQ9#Z5l#z1~>r0P!;bE=?J^scpQ6eAD?<3nndTi^X
z=|zvXk9AamJ^RCv0X=R7kMv8A`^!J?W6!o)6A^mcGzwTKA79y1^jJq90X=T7Qh9oe
z@gYx-mlGH$*t3blCpO2<>sEGe@e-fAZ_nK@7L8wIh}gKcm-Ex{FnIeg8E1v@DwbW#mDi44V9MG1_9Oj|NcL=2z$aE3ShK
z_4Vxj^!2ytxc4`Cef=lrUlBoa{*@v~@~`$=oqttP@UQS?Vk1P48y5LjUxv+#>2XDW
z{?!oHZ2QQ^H|tADCZxxg`)G2}5zp^9Y5QC
zM-T$|vm?+8ma0JdG8Y06f#%wXF}|8>t8x^Y^xwBAK*RVW`lr!76eLNL%J0GeWG047
zp*Mp?NVKjfk2#iliyoEJtvFX0y;jB%V9XX69*I=N@oV-D6ubX(A)MYDlj;A?)8((I
z=pvhWx=c*Jc&VCGZ1ZA`8qa?UVUg#W{T11bAx^W|rtaF8E`Ll~%xdZKN?IdsXd^F?
zlZP|E#RKllSm^^zp+|DP+j_~rlWpm!a^mg*RlYI2q=hze=7~lPJ-+n)O}TiBHDEIG
z+YBiee^o|hXiS7Ma_-kfljZb~J=kdSeU+l$>HL$6_reFg9h_f%;iuHs8^B!aO<#Nc
z)7@-YEB(vHuYsxctFIGuzHasPn_up$uQ!FKi|Mf6_|vUN5nq2a6
zBUzP>5}!p>8*dyBZDwUUy
z$MGRAA76uK3i8n#D4+eAugE7KG*CYK3H#8&YVz63;SS4Zw-Z}mRjTiTj@Mz@XgY5p
z>9{!S*Yetr1ON*l7xLPt9wsD`QXl5EpQ18aF+PTPLl6)9Uy#p!%`W+PM!)&&J4
z26^2~XJIqI@@N9I|7HPc0Ydx1-3|Z{;4aK--^(;+B(MFelrf6j@mN!iF5dD9^V^R>
zv94|;AAdD6lE^sLJP5aTp#0Fsf;AwVh}Gw}4}v_RnaoeZ>S3aFp~K>g@F$_jv<0(W
zc00M%FY#)6hyDcyrMefmh4aA%*xzv|{^9Bn@h&VVCXlJBg!ke}Q*uTGJIdM)xyAoG
z+)#j?eM*|h%pV1~Y>N2XmRS;J@k@E@zv59Y`Z
zJP`r7D8W1(O@9x-4YS`h9mO+rWnrGe?04jqTYp<^
z{yQWY1@BfFu@UforQiLf=YMMO0x}BZ)9UlzLGeGD|9&D7=6@*veG0T}mdEkO8)%ztlY0&s>p;VA6;watG&ijcrs
z<-hN_7r?AB{~a7+O|F~#_i2QvKSlm~f@%Zizgs-8#QbXy78!9Czg%uh+?M~2WS6NG
z$)Mm|O1ohu5tx-*jgpYs}tG
z#q1GF{Z`{3CpSoq^51EqDF0nW
z-Q4WMCvj9G@=yUH7ZVyF|NUEEms9yaoBz((`tsX9n*W}Fn)CeDZ~preyNJ?@rbqej
zyp80)AB;Bn6#4I)O7-TWYX4yVJCT=u@beGmzwZdv^Y}4P3)!gTzi+_jLVowngc|yy
z>c8|B8VmB@u@2Tc|Gigc>VWw9g!%8x(YnV^8CYKpeqN;00)Bodv#Jj%U24Wwh@Yzo
z5tin^yPdXfvu674Ap1SnT0`*Cve|PjEksZJ1^7i{wi=|&_uSA)pBKMh0)b7meD*X+G$++4g&fQ0?8zkK!6U)*?I=c_CJ!&x`cr5sNyIF+kUKp&274HD3w5~@VS
zmL7(iOD1Mk$B$Pj13I%e(erdu_0U@=#>?$GR+4^xIX{x=6Kbo*4tu@*9-E0+=k6P@
z_LKh8Qoi+W4_u8tn?MVeir3unI*H|KFU+9uvyH^I0_*1VhnTBIlAu~9k%aA~Co7c?
zP_S~^?v3Ov&)`fMd|k`N-Vt&vaA5j0OE!NM0KD!*6@U2HZ;JWG7;tbK*GWWEa$~8l
zG6bw6Fc?iS&)YkBJE?RxaGj_#vTxI;eR)Ie4hC0`H0H`^p1Io*@s#D6Cy8MLK8M8E
zxSFY77*{x$?5>pJzLas62L4%o1iO)RO-iBZ0W!{M|as+>S1i5bd#<-
zOD*8B&$M2}7#h>RU&^1}FDO5^vB(0Ab>7AoH@6qbtO~O6HMe=o_4L2k+{zj(n%myl
z&Nk@^c1FH
zHZAD2LHk73v2dlR=~4(oGj%6Ys7ffN^Ope3IrdnNfjM+faf!AUbMapX#%g`uDQUYu
z7tioE7vC+~QD_a_NhVk>p8Om@?WJL&p2F$6e$8p+>Aa75F$w~wZ8H&MyrQ1}e(j9T~fk-ohjuF1}Nmzx{V)dL(~)MYUC{Ty6gLzOp?D@P&ms)h*{>1sa+xZf!2Pf_G-Iv)noX
z_X5Mmo5ft}zt1N}E{$EN68mRH$@c**n{A^q3r0M{>R{_|?H_64{;k=q+k;PYyDCEM
z@qI|q6i4|ly^eWh$&r6+V=%-`l
zM$6^m!)3nt^P2rfdpFO;&$3v#c|0*|_$@i7Tq@x&HNyNtE}r`aZvfa)rfWVI_xI6!
ze-1B_{lEQ|_@0$`ABeNx0xu#5yAL9ki@&6)5Y^m;5+?o;{=C_Avd)tkAm2PdS6<^E
z&4`sm4$9CJ<;Jx^I{IKX1MDVhDlep?zq_@Da%eOi9oM$7KfqvmRdIN7(K*kDoa;OT
zwX&Z5?v4U?KQLIZ6~x!Y+OUs{kk209g+PzFZ>PiQ{b!GV3uTqpZ}&qzjV|WtrLRYUqFg#C!8gabC}rU+)+9&=|4SS2KmVrmSQx0GssT^<)L0GxVEv>y>td@Y9e~6
z-~91Xy+jv9dg(3NkLsno+|>?j@8*N=i5<}o|Cv5GezLGLOhc9UjI(FVmgi#>z
z2>?bsJ`Nk4DRD2!nv1`vqC8$eexp8}!x#%Rl^c4~&QTgOz8)|i{5+L4IcRyarxsNW
z<09gUzWLeCnKBTCO(s;Hyqjr6IMo|nK{1^PBR{WGs3ba#vWEYi1unNT86BiY^0
z?iA3UQgJ@5JVlryNF`5Qf_ITX9U#N|a~4tRmjG+PEdq6yVj&Sr&Fe>?7W}`woxc!X
zcLy7_Vb}FNpWr&0@BMYb&R+-ebO%K}OD)genNIJI{@&bH#iL(DeK9%z!Lz4SD)EOwC+8Wmarp5{L9x1z_C&R0WZpRgkBbtEi*Di}k6P
z{#?HH-qPDHo>%0(me5xuTl*aJ{d$#e17vL99VFKEBj4tLy7j5A6Lh_f<=br8n5Fd9
zY)U*zMWKAVOx9pAML=Ho^#f8SAX=in>hi|FOpxU$x3wkbHB|3`g#M)tb`IBeU)o9b9MB!6Rok&
zST<%z_#u6@02ub)rp5HNBrr#@2fOvDl)j!ult$@G`P2)dAvi7c?QYADMcLGMZWmBk
zt7*vovZ;0PcHZN#{i-D%2MQ4l`Kp#Tlu*6EO9d)&Zqi?pYZ)M;dZlpGKaG8iZ3B%B
zE5>as)zz+CJcL&j)(P}uSAY8P0=n(J{vXnh+O8V)H&(fY^kVzWH>DY+qELQ4
zg#A-IGSSx-JBVb=K6_s<+Gz7wCv~uL~wV!#ALHUdJg|Kri0|@pEwtnh{sz2!I2~F$c;2lMuQ$Nn3{dKG#_qMogiGEyUO0z%t6^m)IqhBPy4puDI$*(U~1p4s-ETNK;
zT^28S>1!&y8u>Mt)^hRR;=c7EtKk5~xhv(6RU}?=tBN}Lb%Q>Y%C9ArQTpOM*(z`3
zn94Ku?pT#;9TuC}l3PBep{lK-q5kc*FL@b{Fw8+!{Aew2m_8-vFAL+RM43E)Ox1`k
z7gx4(YZ!jpM=HG8zuzlcY-f5^d+CEJy@lzG0dM5WSm#Y9WzJ@lZ^kavwufY9m*LI+BCqW6=3#F&kG%Jclg6eNweFG}
zIk$D^=1gmR&;glqDp)jmp9QgVRi1b$3pn?29>Pakva-gnu^g%zZ|+!G)_Q8vN7BAx
zN^0RIHc6g;Qssj3I>iL5-C0PH3|OxWh?kz8$)0%7yE=y_sSqWxuiG%Sdgo4@@#h#l
zW_7Yr5T}~C;q;Bv-SxefS^P9Mv%EGjy=hSIm4+V>TiNV0_($7eY_`inttwY@R?yR-V{S^Yix)UQ_ktyJ2ZvvPwd{IsLDYD-^&Gyj-V7mrwd
zd+EagZ0;G`#%9uH02d9BMD$W%hXiz#Pl(_|@i{P&#W$iE-@N~CL>_QVQ98R_2;gN#
zPjGh&5Zgb$#T(hJNc49;-V)ZS__D-$=In+-@_REbtCy+x*>il)oIS-3`>r?vNgNcJ
z!j%AHS8W+Rkbh$Se0J%ZbcOiaOP}3Rl)23Ntqrt8`U7on0M=iiB}!g_3tkM?tun7O
z6@!bwdO#hyw0(g!lQ9MOOIIwyaP1F2cgSX1Gk*4UfV?9Mz6d|V93V%&5XH~#Qd$K-
zz9K*h+Nu;ky8>E&_}RfgTP=S6^FzbW(S5+W98VDZ%v%}->lZ_d!1@Ve%H!vP!Tsas
zG&Q|u{CvRy(klsGgrAKaAV)qM1*8^{8{&uap@mz!TjJRdwj_jCIRD?#&np{Hx*z&^
ze273>Eq>B82>l$|2dvX&K7*fUqF`mfK>@6(8j^w4L@R~qv-RGJGqFqiqo)(aL2Jg>
z+wU7-zt$8N;p-_ZaRA%o`6ys7Nm~W()I
z>jT!l4y-eZ_-$+vSYz^F#c8D!U!R3f0(@07lm?XAG-hT?qw#Ir;E_BnMP1DC48U)-=Sx9|TPloKpHa
zPb8W?n~qxo&_)Zisax{e-zw}h0@l|ZSgUZXi^1B?f%W?*`vYsYVz8~Axp{@*=NKooBl!8TO!iDgx#PML{QN{By?~#~7|m+&vxnoqQv94R
zrs@|zaR=4{C$%GBeFW10*7qIPm4KC#BrSlol13u<5nuF!pCv}q1L5a~%MCx{WO5YI
z&lwJo@+bP6sEcyE4FJi-r)V(7ZF|$2lb2z>n3GR?i#Phx&o>OT{^;ku_YADrIL^gj
zJuA)yKackZ)|+VA0$5LJXa?2|v=$|Ai*Hn1FsNUA-6vKWke-fqfPF?pSA?(84zSz$
z<+uIBKY4sL
z@+HN`A@gR6Kk=4=GM)cX%#V8mIm2A=<`#4Bqt{|@Yj37nM7zXN-vh_hd?cg=(Sk>q(1*l*LS
z&HqnPGONMwed^Xt}26kje={=8+4GaxI{)|k>I+~jK7LI9^!i+
z!S#;bI>Nn0dO0B6T>NK3LWlAa-_&h2$J2Vm1}v5jI|%xL>Ej?H?KR4WL2dwxuuF>3
z{;HXY6)PXq0Gv20M*FTd2#K}VrNpCXe?*NM+OK;(Lf;e}S)?!e@Z;RUfU$P;GKQ9E
zaAhBPysHEJ^GgN-e4M@*z3e3I5(RwQJm5XOed*;KNo08={m@ILLB2+M`4Plx*zuvF#4Am~6ef@1WvWipPaugdk`nAqWnf0l;|FSvh}#RQ!_~kh%kbpeg0-
z0c_nm1w=Q;!nN?|<^&*5-#8DS#Va|2dyH-;z`t-t7e6syy11k?dObnG%8NX44dsG_
zR*zp7Tw`aff=m`wB+m`Fi!G2u(&FXLy%d_z&-RU!voM$~muR=#3hW6k3+OSlKo91gyut+Ml(
zSm)0eZsW#JCGk4OGA4HX9LFp?(^`=n`N$btH>DP}eMSrAb3<$=aXZvmtn)4*%Ad!N
z4Pu=?Q8Sg#wN}vAnI{J^XWE(8*tw{+ft7%2VRGbC=j=}J!#$1|_xz`F@jsh``(*D9
zh56!pjiB46^O?4-f`&#cDbQbABK%SYtA?)g;9aktK#S8AM;>S>+@Hth1BqmD`LILF)g
zeHJq|e#`UkbL%gRudD4I)(qP2p`F%Q$@D>WOhC0fsz%L1#n_Seow28~^L15n(m$xW
zw=U#Y6;{E`U5zEJ`%(Dx1g*uU+hsL0)I4nN*pZ84mmLLU6x~!{8v@2ub-Y;BmgM5h
zIlVRhbJ->e1bE^`xm`5VbJSfp+tzBFLe0bGj2*c!c9~AV>b*;TszK$;K63L3gK#ez
zO0xI5KF#!Y73P<L?
z^|294n*AOlNDwz7kRJ43_O|DrfiZCiYaS<6GdVB0X&~=^uI!7WfJt#vZ3LLhz7T#&
zhOiKIQZUZZl|gG7S7MeHczQ1i@$FA-7_q41mBFp$P%)5B^*HTp=;l2p!jVTNxH)Pc
z%3pFOaw^=%0nR-nrb)jMixz0>#8atC)^k5!x0lqVrZDG-j?3=XBU6)=Xt{(@%*D}huc1pd$qYMeSV#86majs_lMrF
zcT~h{P9HNoc-8=Qep@ZVY_3zjJLUzFx9la#;
zPX#{29CPRC$SzBdqMII`66vOf1X8X!Gu3O(oC_b0L)(mLaCu$aL{VGG6)bI@R09jE
zXeK5TGG*(Zdj_1w+6MOw6>(phT~+m2ZBCisag)nwEy%?m#Aj6*usD@q8drXO
z-fHU180|Gw>k2hDLUs0REmjp;gcFjr9zzUUJjYt>H1dvQ!^}Y2dKcU)ZirlWBRRnR
zIa<9%ayQm`;X{=@K)9&`*)o=G;h!+?N~GFNGb*opYFKYyrsq0)cEk(BSTVe;b_JkZ
z#}}y6kStqzud(=^XxTQ5P`tqvU#Y6~k@g@e*Is45y#dI4XMy`U1J~JeYHEVj;z8=p
z2C8^huJ?g8jGr2Aggm(6@nA#B?)_14@4;%?*C#h39^7zvupwm6r+zMeKCVZSn+6gB
z%U_wj#FA|qYbW(?&^yG4bDa2vT=7ZlKbPI_L%9jw^}ZI)heQB6^7Eh^OGSnw@zH|4
z=mq%;VctXZyrf+Gz^6rj72B`?;$_C7gLKeZ)1dU|2G1YsdFey=)nG=l0-K&cPVcao
z$BpN23xD~4G;-ZpwPsX1Gd5z+Q!aCQ8Mkbm@ii`UEpIy;?Jz$!^N{h=$BpO32CcXG
z%VW16I(*ec|IiVu)Nb$f1$nOin#r)DOaE;!QMJv(Y`W>ndO&BGRU
zyt0xWVi$fFO!7Qp5qn?fRE|w=R-g1Y+jHbwr@xuqpHDRAFQ=*Wp~F9-w~y3Y_UnAe
z!#gqd13KeA;=?>y)4EujzjlTD5+3T_iJiA!4feod;d-(Q9;WxR?@!0JKCp^U&tM2o
zjD7eQV2f>W5ULmh!i$|ZhqFLizvHD3#JJgSxN5$DrA7IBlZZwt%#{_cW|Q8?g=mU7
zrV93J!4__ijy|tTA9n?$I$E(7dgy}|P~HbcTWFh~x1YHoeqrzH1$-v8k8liveu|Sf
zq|F^(xS;;Q*w$k-1d>hOo)~*{PP5-qorrDG03HBMo2R+0&e@q3PLZvHu|_^nAkaPz
zoYQ>&rTfVtoKtA+Kq=$GMP{CDx#YH8FZ}~hz*Q@UBCwj%D*h9LUZP+r;FRzuZA;m@tTqb?2^9bqGkspA}C%j?zp@v#?r>L0d
zP^~wm3-xc6NRNa155R(I0058bvCa)8KK(;HUO@d&WLlJeNK3PS
zt|wchxx2|Mo5X@9{K}4xbFFc#x8|~Uo6FeUc@o(;$D@JHsBZ4a<+#U4`xJq~OK(;S
z;*w>nIQJ2ExH(O0{;Cm+biy&ZYL=FGk^NpokjrhtJR4sm#j(32Y)rH?cXvb2NI4Xz
z{_2viK|EwP;2-Qm;qM9Q_B1*g{BIo@>mb{#WNAdqeaM7nCbb{_
zCO^yZcfwx;gCCS0QhA_1WD^+t@7eG1ZAK{`ipQ77iW_A1?`R6WGG
z(3la*Ru)HyPD1PPSf%009d-j
z$1#Q%Op`bAp;+gE8Y=ya2dY@-B>nQoz`Ydq56ASz6yU{pGo&xEujgR2GoJCfgfDPX
zMl9iia!Xdm*yEmWmdc%(_914Poory2$$4e(H2cR@I%Xg1f3Iq+Kh?}M+$an>GyLjg
zrqx8uw8un0fH5t?+KT}M8%;Bs^j8)!c!TkGomf-^Zstp#(lrICP6#o3G5>^ifhIDv
ztITGRb3$1aP!omv(rLsw(cNILJdWTY=*YIY!}^+
z<&JdCiq|~yzF6m_qE4)nxYzMPS?fu;__!B^MCQvTkGWV-z6~$He)d9YBcJ>gz5gB9
zWx;q2ihhR8VBEmMQDrYK*r~CZb)ZLU!nDEH9Z+kt&rX0znS!3=KN+oGb2zQ
z4xAXcLClJQZ5#r{=m|c+p45|Z_9Q)lK>QWXeR;QZPFqk7e1z=#=Zld;dd6
zDP3Une>J=TE8G3JSXzVuj>ojuC9C`K|AAE_mUD+zkLPdX`I~Kn^IQowfpJ=oSB3`L
zRsmvjgvKFnNXb!nnYwcJ_3s98IoK!$jn0yqX
zNzJ7zer6)yB}IgYbI2?~-v49nT;QXsuKiDdKvZ<1GCy?*~31jt_hxDl-4?
zZ|!r=oS8g`w)cN8pAVUtbN1P1@3q%n@3r;|jMG64QR6M1yp@>;FpGeZVTSO7zA><1
z&r`yoEgR>LVd)Q$sYb7G^8$LM=hDAAHetQ)f?RwS{yfvDC*vP1<`+aEbHp-Y|NFHq
z50p7HW3IhMv%kn0)GeAVdzHJN8O{C*No7J;Fu?#|5%|=nPHT+9$cy0E=QXMT$4&uW
z2+{C{Ip%5!aBM>tI5q+uKMx|}8!YkVz-2eWR8;Es0^b2(D0?vKQGjs`g$T#}5aCAl
zgm4QUv^id-K(zvdTM!~#%Y$X+Vp1$#A275x!|!!nYFoR<9wxZ8X;u;C>uUG!IOZPlRZ;V-3L~
zwYiZp2BUhE{z1+p>q>@=f*8ZOA{_XCUgkrfaxWytaJo@emenV5P!JQhTT
zL2sabCsZSmxoN~&XbzWi@jo)uMEb{1@H^3NC7DHz675SzY}6P2dFiQ`%l>_Yn$*Vr
zYUPbZY;=6{s5!OVS#PaQ;H2y`Wd<6R2napvp4OSugLaqTV)<3yhlXJb8E(e5st0^s
zhe0E(-zzqR0EZ;5^Oj+-NLiagb;wteU|e)i<6oBPAhz_aA}#5}*@0Ac(0y8w_y=Mp
znFVv5hBTub0~tGW0g~7BS<-?sClV(5NNnlRycg9;*XQy%m(SUJBFvu%hoF7?|zAH6xXsijT!6YzXcN%c1DCkJy2`7D4>WPU~BXaIq5>K)gcnl*iHDhE=elSgi4
zuv=}g&v8fV17SiZlEwrOk?nO2iXnNPZvf4g#D?peNn(}yHaizjLr&w0Zb^7y2lcZ0tQk6!DVM>Z^*?z!VL|7uzGmO%sChMm3Q^7
zme)Jc6i}}OHte_sZG7fH5X+aY!{JgOg=mZ|D=NVlCMHoO6l6gEGHF2~J0+i>15t-b
zT4Lre9!N{Kx%fEc5jc_~dC_QAp7hX{#2x*^u`l^3pgDkcR4}M?JdRsBkv^x8;AEx@
zV~5vxshwDxS&ZcZGsVc{5D*LytR0*{@6eC*hd{-WsH)QuG60t5Dhhj=3v(F3D_%wc#SUi
zj(j};!Ra_ndc8LHr5`~;LSAJ4R~+!pml>XMpt7ZQY{%S<5>b%MgvpSKGJ>26#FLmb
zg~-VaIg__dT!EdJC(=tzF2VR&9>^%MTTDdpQYOuS21`vqscm(F3b$VXP26$Nc2_@j
zSD%>E%UbP#Xe_a1m|I2PQ0)HdYlKOiudZZl8IhfT#;?8?kr@XjRXj93z*T2O@OsO{
zgI779j>Ss2=@=;-#dHehySFa*M>%AgnV*xp5GI+QO`9RRi6l~P?p#>5-lkylw)<{M
z{=~WOe%r)hF=e%_Oa0j*9z(D_IRHalBv)}PC=|}m%P6HWTvELj_iRZ`>Kp99*^T@Ds(YgtV){$ee!xI{`vF!1Ddg!%G9#2c
zj}?J)tyT!R8~AS~11NpSERnl!Q?5*VT{+Nj5_+K5Neu|h2Z4SPXd~@)ru||+aeB@J
z2xM(_v)NQK8O#d$YOnLuuW1xyJ@ScRC2umArhx?@%$p2;`mBu?7!{igi0^_gVkZjp
zx8F*C6L9DG_5uJ=o=jJaLCr~EE^s~$X8EWL|7aF+z{vZuDpn;Ib3N@wuYi4XV#~-m
zDdWhAOhcua7T~Jlzc!gv-8{~6k)?qTSr$3h{w^)}IrtxVQ4QDzVC&|=opBxYlSB~P
zwXU51!}*WhcO|b1KxFoTE0|^gpa{&Oz{bvyEW-}4m
zyctCsOaNXK3{jlfL!%0CCT{{b&1hU#CIHSaRIp397oEO1GnqMT@^8Q%0F%s|IWMpO
zI}AGT9kw%=5F*eI#S1zkP(M_q0D%q-5oi(!BnsU#0!_aoL?F3aFRE#I5T+s&I=gEW
zTExpzXL~?Pou^A@YSKRH2(|px$E@J?S}y+je;c&&=pzmmGnF5{bC9X{htktvdRCuK
z_Xd4FUde;vO|RhyAs#HRSF&
zJqhqd`n|1ggnDYf2lc7*KV->{Sv
zFp;Mi-e=P3@$ht^)5C?%uapfZugf=@E^mGZMdK-urh8rfP)H2A{HShq`LPAM{IkVk
zHQ^>;AnW(F+XdwK$R`E;1+#r!z6@QSEw-Q$L9S6A&diA{7rOj7-iuhR>$6RVH6sS#b?s5`p+?9RG;xf830MRfV$5{e)+#XgZxmtToZ4`4Nhy8Nv|J#mQ|j4)m6
z@*6eELh;(^(GfYaOZobFB)N_k_|t`aZLkic%!r=bgM1w>LPWlv<@tJik$im%Z$-|S
zKD+gp*-nqYk}E~>^{kG|xoGmWfxk$;#){RY{w^;=H}ds3>o0^$WL`z;M=*0WwJCSp
z=H%{dyXb`^@Xq>skr)n>o(^%67=9#EL37V8LjpJ4{uVTu?VY_X
z7q5FOO5^kT`@HSy@3k;W)8ALnr%%D9zyHGYcgOKt#PLJ@9m`?eyeMst=*DqKWY#g
zO+Qbh-XoIRbT9NS(_g*xEF85M@nCT8Qmj4~pSwzPx>?=>lc?rNRF9lQI9tC9P9l`o
zy$tmn$;c>2?3N#`x2Id=Pw-XOR?}R$^#a#gThzc;T3em6-l7}SaTPm7q{?gIlBXE|
z`@tcP+Zq2g>L4=y8zj3&#($;B@@6esHjNw|%s4U@j!y>EWepS6+=
z!=*jq6?S5~=Uf
z5}B+5y0Y><+v?`AwWP1lwKnvDE-{Snyn)yP
zcwDM(winUYe|ZD1H0j)2`~+2GOXai1vf99qurA~$6L|N34?~1UqyNfMK=d0Zl8Zk8
z&X{(Z=ClGbTLGJml3jKYtszJyK
z3s88RHC}2wOgiANrqN>wm$lZMoR*i(b*}!z>oTRU{21*{Q3eKc
zjQ3v39?QjlL<47Fh@CTNgx;tHW&XN2*Db6yjqQ3&Xav9zP(yqlLkwUq38?gPAQM17
zvKY}-pgy-o)DmX>BLZc2l`u4lZ&A1H6lr_`!Sn}v&`tgtd>+3&i!n9zI&{IvPU(@_
zy;_!eEX!fA%Ul)mu8?)JdtG%yoMr!COH4$!)Gvjc8nfP%9{_4I%?7ze0zHaRuHAEo5
z>L+=mD~bv~s(ws3Ar4<9Bt$ly-DA0SY`XNz$nHiPtW_PcVdp=p8&SIlqN2jLLfjwD
zT<9JCLAb7$I^K9ld9Y86(9*sz4kFLKgipP+m++GF7^`0}4_+R3W)LKkzN2rvk3fu)-zosoexA{_A+XFwwDGpB7i$Pw7rZMhws_;@{&ebs47L`1G;eB$*=hms(Z&P{0ZbY
z#j9*!E-Zz?Ij}xN>=QlMUBU&3*j?rZc9){~iQ9Rr>@M?KkD2G}E?04-$nG+?<40V~
zZy`W$OHgEgxu6^S%W*v1js4{a_50c4CvJB3mwB?k%!}Ax=61Xq*k4@egn}qOr33O9
z(Je{qDPl^Gl7>>KQz1${aVuBRsboQtr15edC)VZ?cakJ76@XZcwxwdF_VZyCnsD{)P&Vv$^1oD6B}EpyeDDQ#4xNc
zh{j>S7JW(R(?6mnBq$bHUu<0I_^(9o(&r2p845|0tT3sayv&rjE_fonm~H}UV+NVU
zbQn;Z9t<*7)~p+91F4!EAUhc{L~Xs^HMK#&zThfNHePG|X8Y7;H1F*-wdrJ#=>@eJ
zuITql*lrL&@i+)oKy4oSgShc;%(zy7ez9dajjoW&Sl%FXBD7nE0b6AXShtjy4sf+Y
z87WaZ4!7ajHONKm
zPA4__8p`*s)~y1o&Ow~xh2A0xv=4KXL1$-aJ$LY@<5U(L%t}a+nad{6{>a3;2~SFz
zu7^c_iuj3p;duq(%)@e-L<}Bx>9?aIuyG8mVf;iGFkpfmRFz{=ljwD0Z3Wp7S*!}un{D5^Kpc?bdwC1>*B
zKwluyQ#oD#bMp0*4zT->_f0Moz}2TYzb5t0J`c6LShmk2k@_?wst#*z`V0kXpbwJ~xBU7v
zcdDPl0yTAEftqRwWh(%*m4ewnoL5nOnrW&}ldwuMD$%L3HPoj`Fh8qNGmC5FiF0u7
zilQE@#8)^L*Xrzt=R>ja-_FWAmLSJ@J~>MA=GH_u5itZj&Og3*r3R_
zvwjcdUXB!Cn##%g1+5_Uz00~acMW1CvP+kDU9aYk7$04nfD!)f)~ji!Gg*VrlhM*j
z)&%j3Gl<{wNKk7js8@68wcXdNIYjRcsi4!Bf*8-BUJZfa>FLVnb>}`MQ#XxhWdI3E
zv#3^-FzxJq+TWJ79+1>HC%byfvs}V{dY`Y|cXgo8~3bix?bl*pD|P
z2tD)@^sDYoXaL%{41zT#Cz{&`6{`}YafBXXsIlB)mR+YI}d9zr1S;|i%6tcUzH(x;U=@`MEsQ#$B33_mpJqY9B
zyHl>%b)j12Z$B0bQA*qI1MMk8Rq9u;0rGn)`y<2oyZnA@T)$h?mn#_K`gLlp-!BLV
z(rM>>iKT^*DW_QzPM@e#pcv;s${JA`7EI7;52Ah)WLD5f1(72b#SK2ndR!>d?f2e
z3cRo8TK2U(DRprgpRyi~f`(I^{hoR^7a#kddP(VMXGha9n=$BWJ#s_fhOMf6mkW;(NJgg`(_=1D>>Nb~O^+nCtU
z&bgrf#o8it&{m+pJ`ngvoKE@rTvwmQifQEQ)67zR8o!tZ(5F7lQiuzr*{@IY4{zls
zeIfjbs=p_y9#5>?+SeGKYA}qnhRr|(o#ZhUP7p*?N(1kOxS|Sah$$kcsiH=?v9b-K
zU13EHaZd4BbCZGjmtSFs+A6smp^IP(A5r^>sC%i4@EX-HI*MUX{z7&|F2J2ZRC4wC
z6jKa~)^M#+SY6vr@f!Y_i4Tw4;A>=9ost=RrGzp*Z{?E`HXMbXHAd#C)%a*-#$aEpkCBY&!Lu?ZQrW3voh
z!TPDF(%H<&;Ok1?_?`nnJE&#T=79c?1G?Z3&cIquoC*Iwarh6vk8FV9!CJVIGGip8
z7Ht5Vveom8PxvWQqnZp7m#Zd|)FZUzEHq0AtZ7
zZ`|yI>Sew}s>_@>>)qPeB3>M+FY|a;^<`>fLs(p#Sdfaz9yPNjBQTRpcb(=ho}Und
zPJqpgw#QtVr}lyRVY1ntP$skS7l=jWxcp2aa$*w)&avCB;3E5wDpMwCL9G$I*o@bx
zz>Eo6NBzQ~M6|rjGun1tmzVMRcct5Rq1|}6ev2F}({X(ri}|zM7S-9&5e8UPZBUa1
z{Bkk+?KX&3n~kT{X5-mvhdVF7+Sy+k-!7~#63&48euHJwu%du(!Jd;iPbI<#A;V4j{(e};qWOr9x(
zN9Qs${Wd!?-8SX!U}2jbXs_VCYKZ|3&P
z_09(VTk@FaVarrtf~z-kx;)%L!kAer>xMf36Ti^Dy?Qf$)OJpn{uOQ!sWlVSOrg6V
zE+uxQ%$Tlx61ww9CGY0RU?IyB$-zRmayaq@z)Alt1&^AWaD6r!EE?vMi7hju+lm<~)U)<8nK%+OYxzef2E>5ZSi_{uqocuW@6pZODUU=HINaG#EhV4P)@b;3C$IjRYS
zfsFE6<3@Ldk3LS@T;J1_3lMIB_NVRD?(5K8YC2ahaPAdG9IZq1iUb@VrU9-AaU=UU
z7oW}00%4F?x=1OSMNpM!Oye9Ezv#3wl|DK}vl4+z;x!SzbsMh*IkoyTGc+O_0y;%u
z{h5s^Zlz0q209ps{DJ1;4=dcSAWn-Jbc(wQ=&OsUW+4B-I5-JG?qe16iiQg-cnQAl
z61f}tSfQDD8xaE%B_#B1&c*jb3Muf+eF7y*q%VDf-A=GZd7|CEYVQ}sSwWh^#OCy+
z>$zP^p0j<%Zm|QZmAw429+O!~^~Ty8%J|8qjiM^`_*h7zu*$u<%Ic^@mZ+V_v7>cS
zZiDlEF-PS|s>L%7{HEd=ldgz{v(~#K#UEN8AowH@{4J0*g0qIrf_jwDDzdMkPag9H
z!;s=0nkac4{*jBnD&`s~nsFzF?Z8{>;O9KInmOI;rS{e3{np~wUC-~7#SG)hcOVnE
z08^{ccktxeAMz3(d}s^9z^WP%W;S6i{@>j6OF~58c29N?_$`b+lx9q&^xrKYF+xGp
zt@J94z7Q84@#mkye_h5q3$Uggavk+w|5d+3|20B;=)XqJbiUqnLHfTBh@ean&TZjN
zYMG!D!bREty6jo@zmHsHW+Alf|Iwn+5XyYsK^{FUAGvVP_K^So1I^F!Cu9zdZ-mqq
z%=d9!2>sX0FZ5qCKj**Zk_MmOC2lUMeD=R45ZN`$?02h8967?W|J`g^zb>->7eGWJ
z^TU7rY4ZQ4{$M-#|Dxad?hEr1Kv424d&vL)V42oG6yd|Cvsx3f=TZ69RE00yN}&-UF!ex!jV`!cqWJU~sM!z*w=Z
zP&z|xIG6`bI{N~08zM+OnEqMn0kmk~-J#LHNjLe-XmphmQ;8&kcst7VanF?}wf#e$`DqfE}f%N9qBbB@Z#89JqFc*K}I|j8pI!OczO9OliRnYj;
zr5$h&i3zR)&}qFM6d`^XcI(@h3Tb&4^#LB0s%KqHW>Xi`2bjB;rsq*Y=P?tx{(^`Q
z<&|lqKwsi=S$KJoi^x%nzJUxN10h(tS~*VO3YnvcTdl@EBy4%AvcYD|liXbVr!1Gz
zK&jC#!95}@bR}fv;-}phMOf-rg0E+u?#ow7a*oPZ-@43@a77{$$X6EJ>OyNp!fYGo
zX`Pd%jKJj))P$--O|JUB1c*pd^BnC3Uy4AkDw8lO8CCzl_#owq{0~vnyj-QY+)#cH
z+cLRI?`8e36(1^)r@*yuu$}yr-3W;8$%0{2trU7rL06EwF+|VWOXx@FISLsouowIC
zRH8Tenzu?6i-iAOAk`s~?>JY#d(78NN7FUaCTciIgKSL+5vi8-{3TmcKb(xw+M@5+
zuZ*ljr6!+V``Ep8`}w9@SpDeuZxtPkjQ<*=i#_FQe&+G#sc^31t8D8~-$fpZ9#OWv
ze9Z~1+sW5_S$sQ;rYMw$d|3$9YkSFR&n?tScAu|#r@JpHWE7<7pUc;*mI~hPo5X~z
zy~@{2i|L~;m|hX)YC_wGfi6P&cG9KvwVRa9k1yi+fH!_6NLlMSW%C0B2zF*JzFB-k
zo*t!a{tRH46!8SNrPdwz!E9gpDoRyTzUDY{e3aJzySQc~UvsSlu=|Mb^Yb2`Dp;5xkJ(8VczB-O*d1zGb8IdZ!>$L1|-3-Q_>p7R%jA*
z-QLhSZ?lidKczdMj+o%)mLM>1I1<#wYT)PQovgtyN5NFJxa-u-OW-}?6+(_6&vXIL
z+FE=KQvhEqb@MCEZklWMmq)3aAJI^$n@fcaQTfjIaDv3WNnyVK+w|GPmiU9aAK4QB
zME>S}VD+cp5*JARNSA&G<8P2e7%al}_e1sq9uD?HFH<--m;?kzc~x6D*bgZnVJmYl
zw~ZffI7J&nhR<&DH}_Kd@(T!jMA{uj#%3tu<^|tGfuyS`)E0`n
zwNBpEM3wiOkn>(tNOD<_$m%DtI>M2chIu9c5-?;>6x?D}>dL9_E|E?~gBm7NBrrow
z!!5a)6*Am7tRUQ9{vG&Lkeim5l!Xnsc#XJxrnKtc+^(}hTiRK1E}G*!&NLb9NCwE1
zWSR^Zl@q3oSp{~}xa;d12lPm_O>S-742
zn=$b0eD{`rQ;TFPwt44^71V*Wp|-dCC!e%WF1Ov#K3Os^I6ir}|5@pO
znm5#B)00g+DV-ncUrt53w*Cjh;Lfh8ZFwbf1gV1A3CAi2|3jrTh_i{^(tkv2-K^|g&d%ngHhL>J
z9@TsRk%hz+HU9_WA|^}mp{cWHd8yY-zdl@2Yx*KDo01J?XD>6M^`J78!S9>qd69=-
zK@&=s?u-b^Jl!_zhkyS^>W?j0k4CO%pXS-&U)Hn#QLrg%XUZZSh=OfEl>uN%FYZ<^q0)Xw?F3N?^<3Td%BnIU!lcRoI~a46`Xcm9$UJe3#s>sJBuxS
zg|ErXdfr4SGz-ji4s&0<|up+!@cw|Oo+JK$Gz$g<{#yeI@EGA&(*Y6c`bF7
zC9DJtvXY3j!S=4$vin3hTUL(^7LkawKz_DJvF8(+!DDQJJ`c^@Tvt=pq&GqD>xL;?
zVzo}a$|U=jZ~=aN%&=t1dM-)B(ec_VDfgnbl{KxE9p5IV20nCWj1hGt_~GDit72`e
z5VZR}dPT=ft}OTL2H%b*eWvNjTXi6}SF%|rY2nj&nTyHP0R)(D;P9j6B~e+0YA10)vEKe4TTR0*hdmqi=^{j`!ep7+w6(mRs3jhq2@eNEgX
zP5gTGTd}1J2vI>F`UWMn=JGX4;!{lV?LQ*BO#a>54Q}&!+HPJi
z6Ndt0!uZ0bov8DQ3PkQx_8G&v(J)gz*Y;Xi^$NM!>2uXOl7svG<#cPE12`SFAQ
zv%r5iS>$$z|CidX1^+Q|`S{<}c#s-9jc2$UPi5ERS;kq{krx(>r;)t=uE%puFrHm{
z9#2gd;~C|~Gq&sTynj~r{
zM8hPawY(0#m2PE*$@F0jlKr9WiOe+f_}CugG|r&R^C{d9s`QQvtMpE`D!p$-Z1m9P
zPVSv+&k(zwRAVllWJbA4b@S>|>s#)nu9MYyhG-4Ow*|PM>itKs?YR?_eZEgaX_qS;>hn=1Sa!rPz;+-)>5621dRqFTlXBTOH~&PRIV0JY=n;xd|p@`FdOscm_=
zA3n%gIz$a-qBFUVfebEa)B%!^S?#Z&1W6VfF(9ujpm8vRR>vEfB`R=8V6*4cCNlf47iKGPGd2(bFhWlgf2yT$UXvVJ9mGvw)2gP
z-jn?uR}MW+SFQ(<_0}80{SJTO@KC3XKOm*4A+Hh1uUc
zPw$BTgn1>>hYKe{d{_kuRb2}W4ajmJy~Bw|3|qj7(+wwP8ctls#X@|jCkng}ApqnY
zqyPQnRSQmQd-Q9Jpewu>Ahh^{j}Ohq`a#hbmT1+{9{z&u!nlG5!zjiI?w@Vw?ogt<
zL#ZJ$cO~>^Z~MlY{h>l@_GcLvGZW@>s2uvb(=RwT&s4pxopz^6&o;EW9>B3S+f3S1
z6urrH!mB+Il(KhHk3{riQb<2I#-%g;$i*AJC4%G5mLqW>@BC1pRdAS#(6omLtJGI*
zEVqNuV1tRMP>C?QDs*WC7(rJ?Jy_q}!3I)3OApsP0!-0VLTo{<$oS$SOrGmCtT^y$
zV&FV@f4md9aU*GB$^FXndMWJ
zedgw=%8#+H7GaO$YmTnW&0bebR}``vp)22z5yht~3{!MvZl12}XWN7E8(ldiN>`?V
z0C3vtY~rP#$dp8W5Q$>4nM%Fg1MiI@ZM0@(fau6?M#&2yI{QG+jl7hjg&TRI7&LXgiMBc(4PAO%=0r#Aa@guGC`0hJYC(
zHnZ}?=I@3?5Sud%RlaPf@?9<#q6x&N2u~n39}2$d0%9}gD_kljHj6a{o!416H+xOD
z^v1=3LV5yv6U7#m`(u{ZGLAu&@(!VjsLb?`-b`l^$L*sCbVmR|FscWh4E%^i-c(Z*wGzN=H;PtrS>bP#K}q~J$zpF_l_=w@{N0u45cRDyli^4ex~Xe
zr|8f;(IKop#1sDVY|T#s8&^6`_K}N{r>nDL#k6zr5r#gc&6olNen*9d<>LP?aWC)`
zJb#|*!0^rc9rl&3fkPuQ-zN&pcoUhKHO?pJM@IRMxi6hr#2N#Or^O(L
zg;XK4Jv!vh{x@EeDgAkkoDUj=@U3MygyFp3?6fBuJWiUxZ}6&?2-Ex
zV+8-E15Gx9Wb1j33wA=kJQq}A9*7snQPV)b=1Y2kdS8Uin^4U<{^ZMoUEt93aZb?o
zd9ml}-jERp(Lg%_mx6~#FHM4&#B{*ur7Q5_J|W%+a$k#33MT_71)F
zN?yBml3qK-OijLYe{;xTv%h!tUT4p7h}Ms@&1C_bvt8#K^>WQSOr;dTGFgl$q#*+kleqjS;KI>F!+s^+@rOcp+pj%mBH^|V!3niYat?e`NZO(AOp22(|+}Ni(vl>It(W>QTE-AAMTv2a(#hCu#udr$
z1lt8P%MTT2F}h8ZSSLc2F1;UpS>W-fosUOKy{4ya<{RMl0V()TJywVuT9&=^#}wfm
z-24&j!ac)l#2>%FP8jk(zhO;P`F+ks#LgMkD)dcu2(+V7HH(v
zuYzb>TSea&M|};^Ud{y&LII4f*J)nMeN6Xgj1R#&y*sPRbsAE%PW^4tGE2Mz5zVjA
zyj;9PJ!plVKxU9xs!+PiyJV5^d)QlNshb`oyD9FzFWE_|!`K?#e>^-ER74=Q)vk%`
zB`$gOhN#TGRw78@{(SSqqQ%}(QpX7WspMI@R9IsuLIzuNLrS1v7r!bd5=b>E1`2?3
z@q4-L;vdHIMZO&8$0;mf4cy=}|H80_eV7cA#TR+0EH|A?wD(bibm^bjP+&>`NbTrO
zp3x9!g9t|wMbkR3m>GeVU^G0SX3xQh==qZ4d~hh@;6nGdzc~W!Btf6S{)vtZQon@t
zt0RQ~h1nq4HI{$qMf@{Gz8Rlm%0zv{_FOb7`>=5vb{7#P-%UgR&Oh^g4K9B@uune>
z8MXD@hFRUo%aQsB-TG%X!ZCgS%o}_y_RriVhHCzq8KV%Qhdciag(S9E`grxG`9~_5
zw`HZe!9}yOKQ5HY&R!ZzU@r91%vtVLeTZ}BCXkW+p%ilP9pcixj|LklTc&#-O{$V5
zV+3{1RdZ)QM%7_8w@kiqewwes;2nJM(;V-9`20Wc*Tm$nd8B85jZ&rQKJT)LS-Atd
z6u4~OHItol+3eBDWn-&6?9{H@Hqz3iubA6r_QccyH%OoeT{i9YH}uzwI2TaZE1#L~
zwedYR=Dkr-3d%E~C!4Hd-kYWYx%eIaGaXa$-dLVzC%?@PFI2bqZI+tf#^87^pt22c
zhU`Y2{5I$4YUsE5HcX26=A!)o$qRiWMf(BPFPCN4E*pc?o7e>+c<=TD3jLymytwmz
zxC^6)bUz;0KzH!z(Pd-f
zc?i`u@?Hm@*_>C>^>}^-AvgFu1dDO-iMWDozfjI6a*6%gz5*P`jb5iCVC%uqqTi!e
zM4I#d;@`HtB2BjUJJR(3#CYHq$7(CJw2yVHVe-AXigREift{562TA+|_oo-!-<9Xh
zfvr1lBxHRzPzeuz3O|s*mO=k$`a6!D0w3nKLcqrQ9>n?MD=rv
zaH?Z?#C4pmnd^-!{rZ&M`ZSYg@~7y*}+@&RUQ`*H~X0e4WnN^!Mj6m<=@eEMpOi#%coXvz4+ur`jk5!=Mp8S
zR8Fnlu;|arE!D)q_h-j5p`qH&$<+D)#%2{`-_@oMm)X;x{7j-{HBfHr-|;QR7~3f?
z&`bX?@0sDl38UW-cq79XKD>XiT#ks07znF2H61iH^&UMZs$M5JBN>~%K3VcgGWFur
z5{kv2C`qy8wDLstn~U1~{hvn4Y;5$##did4n}_?0`{M*Z#+^jejGY%vh)J;i1l+6>
zYP{s0uWd#61wn))9R#I>_1b7>llz<4TI?2-{#7j7jPmS*`RNJYBJ0&K`V9%JTYFxw
zPcHs;!qu>A!WdosTvO7kdN*9Ljgb{Qlog9D`H8ShtM;s0HN@vrXZWi|WxJ`>Z!P+L
zen@VA7(mX2DK%4R$*}W#Y*$w=GYmsBbCb4;!Q0A*q~PZlpKh
zN5Ne85WU3JXuZ!?EvD=R(0^)K9r02u;r5=keANZIan43L2I^WV?vvESppyZPFPg#__
z;$cX8IG)1%FTpbce&J6+ys38@r`Mlf&UF0wrp|{ZPzEbCT{{AJPaa!Y##i}`CT-h(p}Bz(1z@nmm#qRtc9|ySD$md2rH}ScN&nQO@0sOH=k4(Pf^q{
zJ*|@8e4fbX^h$n@;y0fs@;ROV_>gAufxF~RjI}{o-M-&8e&fk+xA_8n$27GwGO+Yb
z#x}CQjg4p;KlS8p+8rC{FQUgq<0orvAm<7ntsa<97&qEnYD>pCemouEXHWcem_{ji
z$N1?Ui1B%Tn$$>57l`)-{Isv|l$Gd?pFVXi_df+c
z{Sth=x9!DGU#rvmyX2?Bi0ZXXI}tN0laSljqSIrsJdTSG$M4cTf92V6Ck|UM$%!_i
z4H6IcH$ttAyK@>o8`5+yWMW66W_7_o3;6MylDed?Na5H)4;)>@j|=(dI@{KIKReJT
z90#TQWFOA&?>sNN+2>^^`cj#Op1nIiz@LG$O$Z3aVFUaMyB!j!HpX7_{TqL46o1p$
z*-bX~sq_`_*R?(H*F8f18tvZjybJbfbkLvX0KgpbKk?V6z|+shU#TW54mr4b-d6O(
zmW}9dz6@df*apJ9V3MU5!^E3jwnYf}VV=KkP1kG{REyW&`18ar`F~gZmGOwX4o<;b
zrA$t)Ea0!fc*JBYCNrKF3dYlkpH_>02f;s|iJxA=R{kgW>B?8B$!|Orc>W9csq0TX
zwZ>}l_nM#D!WQ$>3(tw*?T_J7pN^mQH)PH4hx}xnJd_`-FCUd&D}z1U@1NtRC1J1l|dLwEeNA3AV1
z{B$l)hxBgQ<_mVB5NNJKe9!bHd@P3(>EQRDIwG>Wxeq=^E-Z(fMt*X?s2)?N-<(Sl
zc|gyr%eMZbMBdmhJnxMg82fi$FZ6CRfn5In^Z-&#=8wbWUxM#{!5$um&!BDXhI50^
z71emxzZx&KORl1Mj;1L1q)-Hi2B|oWE4c8l_-J4s48Xr2n$4FpkIq$0AE#f7^|8NtU(TOedx|ACS-NJ01a
zolY1Zy^eTWSsiitDb`5Mv2bPoIA?iH>%rYT?%*H0b6u`t{|G%Qw)YnOj=4Kc**B4+F&$
z5geke9lt8WOvS>G5wq%Ut?%sw0#R$YZT^m4zsWqmDfYuv5cmLpiM!uJu|clBc&_4y
z@Qp~P#4ScK%tF};+V?%8=l0vI|IL2?u{&2$O`Y>2Dt?cCJZE|9&;p22@%FD6@7aiPp9_l>U$hdr}qE#DcjHAPWunEVwZT|(Z0FllEHid{EHV3Fu}CXt@;s}
zviaAKw^}FV$mLFU_Y}{HXjuJ0(;><9!O6_|9Ev;#y!n{;{;Ab(#+E8a0!0De*NgKH
zP{`p7%JY}iwbfVXI#1{IfQ4*_Xze2$i6cfBwQJRuOpi;X?nzW{lh>=ArIbs{jt!UN
zy;-NPmNb0{lNdHm&WAz9O{Pa?e+cq8dBo)_H8WR#zuYoFCQBN1kRn44)I|l$XYuOe
zhqzfMGiR1Z0;npz)F5P0?T>po8YW+ze%MrM;NVRaRFbI`lA=rQ)vxm8xcy^GKlEYY
zvDM2>bNCZnRX*QkZ!~?*OCPF8sMylqtC?a3+R4vBjrCf_kLc5M@KhRoDUlg}5Cx}c
z^>gb?=aalfTocVA)?lYEGYAo)y{BXr9@r<@Z(Op3G(~9ADMsz>^pff79>7*_6;#hX
zT)#A0>iAeZL;VPJus~0n%=$#LRw8g5&~YLlG&+LcU|{RO?6q1REIq9QJCq|fXSsua
ziGjKt%mkkQ;2270hEz-%JD%eKsvg0<&P<1kl4kl3<;)_hCJoH*v(sG0AF4qrkbHNq
zY9qshCG-^~B^nG$O1vNMRDWlPzD
zLuxm#=pS2lF-;m+vNf?=8p~TxEaz(9rdu0QD<;PNdi;QGb0(&aFWIJUvsXhe8_7F-
zM=z>RtxBeoL$)MS$z8X28MOG87qwuIEQoPH59o?6qgvTS;K
zuN|kQ_S&%?Zuv&XRPNFzZ==hJ>Ej1%)$6wEbsdLk2}9M*jbC#=pNSFxL7Zn}`Ma@2
zH4yFlnkr&L(5rz-3V`S5t@AUY5KqJw-90r^=Kzp!0QjK~05B&Hfb)C+lo$X80Dv<0
zF2D0Rlo2m$E0I`We8uDC(*ep#fU={2vI{`LtkLoUKzXRPWD}%20LuK&89+AIrrvI8
zE1Q-c3_u3&P!A7!BX~{rr%|Ys2r2`BiW@`6`9Q{h??B{MRGuxI8OGMF*cU_v9~sqR
zW@U~)^8X+*CTvn~NvEA;2=Ph1ix2@mBe=*Yb2x{UlVVcdGyx9SG|NjhgYQ#mMmVhn
z2An_!Nv`P}PYD&r0Ag2n2M42{th9x7z3)
z$6<)9PnX>BMe@)`>8>%HeT`@b#x92&c2
zXzPsfYx>5P?ZTDteYtpFMy}%QM!IWHu06#M+xGEc+}Y&|UP`3i#E(`IYrURcEy7_n
zM)0J`0!dN7cH?80A(!L8Z6dT2PJZpd>Ubm(z6`n`N?34B4^0SfW|S*NB{_6UB9$Br
zftW!!+6zA66y3ZRLTOZU21sp0GxZQOb831J(Hnyffn>hbF*btlVtaMv9TfpRAnyq~
zV4i5EheB9ql&6m$xV1KQeE+Q-9}}>XS^;4nxNVNEZ0pcb$;`-0t;N<-(maTB$1rG8
z9|X5nF8(y%XXU-e$eZGXDU7Bc9-=Q8BG(cTAMPjf9DZNMQea^6b->=*K+NS{%Oz!f
zoc6RB*g_A^FGKKVmy~QW{L^x0c0Tt#h)O2@+?UGw-1$O(nvt(_fP$M(KOj0g_Gj16
zk9N-=#WQ!l@19>ZQqPYleqPq;>c^jtr;1Jhi5FZyxvT940v_>Nl#J%7A={z7~HnJ>BL
zYpJ=5#9*ba@%bvZ9J4+W$-n5F8k+jKmXJ34`1%~f9Ln#hfLr7`!(lW{5b-i|F81b7frl|
zw~EJZkH5NRJ@HqwkE4U2px24>wS1Io`jY9#Z1`b!dsT0nyB4E|7n}45`puC7AB@6o
z!_O!#BzwvsT7B9>O*0eT%nc;c%gY@0w@m{<&LfDE4eTArE2f|WXeY3Y+#AbOF21kz
ztKg5-WnKw5GM*ZDUj$UI?M}Muc*4Z29EU%Y+Xk4}}p#LU+bes-5VvE+h
zyiREAxa_5XyL#C?05MjmiUvTHXI>_c*nNf4pIDZws3^YA!z>
z;3IazN7P9l8i7~PXfWzOcqgy^-Y0tXa~K_?-P?H)pJ)KL$p|DIBiBbu?qk`_2Dm7e
zMIUE=lFt$;P7_-NdL^sxOT;EWf($%=$A;LQE3otF`P9ne7{QK=fKl0?`ft=|8W{~w
zsiimah+Kt7W6=}F)28X#m_`%jb+GmF#7W3^lHYC4sYg1Gc3`K`n*6Bo48_2;U?(xT
zz?$jSCxCydjfq#S%vIc75e3n5!E?B6M@Jv?_BNGNNTePBh0QvHr^zswdLXeSB|uXg
zfP5=#GMP)tJr08^c@Qlnw)A#kclsiv*0*9ye!-7q=73R&)EckkF%BUlXl%jRQz=h#
z0Ot)h?N90Dc%Nf33rjJye2DoWqxR0u0a{X)?n&azSBZzrw)^{9(wQ!q0+XB{^GY5Gki1c(Epynq
z*9P`EmQEhQBn%EoBKZQsSQG(kxbZe;Ee1~x;mN}LAw5*FsMite(}b0nswKLa>R@sV
z=cLh_Ibrz;BaB_+^MG8%ZMyAn`6wHb!{xEBXpT!8ojf4?Ef`aLi9H7L8a?PVo{zN&
zr22IpkH?dV)V;;qd$e`vZ|~cIFfh9QLk%KFoJn;0wm+v+25}-Zob$(xM647_zcE&G
z@%uQ>_3?G<<8K9haQ=8L&+j1N*eq}NiHlUP!g#z^{UQ0U$yNL++FPaTZBOg%n+3f=
z&%#JMFZH-KF!fpyv(dESQBTe{Wx)I{C$TE0j9yoJa;~D*dVdOxc6O>`2C^&bkpU8e3$pW7<75-2M!KpHZ(_{dfDF_2u1!7F9`da>-Tpn
zK9gX-2J7#JsKJheghr+3c3`@A4-S5<3fHI$r%OX>t?cz`N2K?
zLNM9;H@nI1Nka8+D2lm#yHH{vZdq!A+p#Z@sJQ1
z-g44#uHwPNga#7LX4rd~R3k$n?lT#EJ@LQ2Tfd9x&xdzeIHfJ`yD53}nTL0;@ZrFG
zf48m=Ky;1Y-cS=i6$nuI7@-7gs&6
zdz&EMCSu;h^>mTs`z(Y6G%%}gY@idE?Q
zNv4`PY#P1tmRfsDF8%{`pL)j)>k#hQu=cfKHJb|;`V0Kl8c#4enu*E2en4Lg9|!=C
zH#M4V5#10!11#JtX*VvOV63@#B|0Xeqxd&`TO}9;4`*+O$H2OjnB7LbH*Gs)%zp&-
zrRziaQgua4{=ChXcS8A_C|4SI5Yq3Pp?bgI9ol
zcC*zt8R8@e>HXqTnF$_!QV&jSpd0=N^7p2{i(G$Oo>qU0!v3P;2?sGy4h#GW{ADhPlUn>>k@gk45Vb%1m6)exn#uX2Kb+{c9rZ(e`=x-sKvOcMVsn
zVX)tYpSDM**+4{^)*?b8M&sUl1RN}R%(DO+B(9^qkuuh-;wlSZTjLDt`LGwCGR(aC
zZAVZ(m}~=kfUCLqaRm$ql@)X(jrJigJ&VrnpMQi`b-!2rD8%q7rCIFe^&7=$^Cci-
z>M8U*(LGoElxRuF=^b^E^yw)$Giy-oI6e1wl2B7XW(td8P6KU?1O--?B
zIT1SrIYA1}`^;j?e%PM}L7b9sI1#BwfULtR7JNj=VBI88g5+9R22q`xU;9T%GAk({X(fG~VSOD(U(9H1$3c>%Lnlu%y{o!zNZmIr
zee$kbrln3Ex+O`fZUTK6_tMm=M;l6>OjbQvi(5tSnt!vtHH?0`KJ|2M%iYk{F`t{7
z8nZ_OEBku(isc4M;8mO2G%cMRxMg}O*^dq<;xm0Rfqivq)yn#khmutfx4gPVpja}5
z;qbj-^qTtA{k520>2Ys*999cSe7)lXjHQl`PXYe-iE5oZHRF{`Rk^-r0iy;LYuSf6
zIv|W7@lik+7Q4kOZ=K@9;6ko?=}`hHtH}{}zQbxjpN`SIArB8!q2`*=YdUu4YJGaw
zh7`kU#7~yo0gq5JwpDQNxY2Ibl&3b=Gu8CMBe3-@Jd}GiWgR+!I*~cI#MW6QcicK(
z#{gO9Jy@EFtaFXO&VS)DnCP$!KVtht=Rhp!)A6%U=!hhmL~6a4dI?Fhw&f#cx~mp>
z^wYJQSM_fiRG;3vKDB4<-@rbmzp8K3E|X$^9kchGNvSb=CR*<9%e9iG9VW(Z8Nc_$
z*718fSWTt}2dfu-gdv*#sG8Plhc0Icl=iA`TEkUf)(EaO;6$R~pb@RR=vA?0CveeN
zD_f)ECCYFBEIgRW9pu1E#SJt7&v)QGT(T`u^>KhCPXbiFkIvPmwzRb4(HzuoT53=UGPdUSNI<)tmP
zsgJom4V;_~230>l|II{Zud!aq!yRjA#U5r`Pr+xnhN4z6Tmnry@k)dM`c726Ync9g
zfa$R%_cKcUk|XtAFcZJwK>UUS>Z{k_NWI?XaFoRVRCRso;bi*cqnO3X)u8*A%My%+
zZ3C^VFIht$!qO$b)imgjX?*C$xfA2usrq52k+K02aFE)iKJ^G0e`RX1q03W*+q-P7OC@*0+i4r5<0;m%K0VRUyQVyy9KAJ_Jc7H1rX9!oE1Dd=
zZ4TG*)4J>9xt<<0q9L^|wM$((S+4yuWNXJ$T=o%Tmu++O9-eUTnIGcJLT+hj+d7t5
z^L2ILQMuvKkZm15=KEX0ByznGsSFHcJif>qR>~S-K
zbHoFI5m;1s>4O0PL2aA8%)+?jrCj_-Nh>nDy~cE@(({y)zhnuHj0YR5%Mc6ftkx|$
zMs)`gTNU;X^mv)7S7I4$-c^109swt>5niN4ASrzpX9q<@KrqghBr*#>&--27?)~s`
zE?d#eq@KwBw`=F#N(f!Z+T8U3KI716yM)hcM0s?E&me1F194{Tu5T4_M!4u8r7WC7
zIu?n?iGB_6HFnEj+PBNoS2OmVCOnl}a?P)4QGNNa2w%hat9Ez(Iqw{oOrKMRKW724
zS4S9d9`sU=2Jj(aH(8x++8@*Mm@gQ7@B)9I(F-ZDrTN~TKrRVZJ90e=G3M*z(`h5S
zf!FP|UBPRNHLvL-oXJ&e8)70Sa*(W+X0HTGPsOVLbkkIiL+qJWgI3jFZYK_A%h7$@6_vv1iYA6CJfqWBoj=l;FBna^t&*E_HO&#iedpCP-2
z^HKd7W)!T+G?v0msCjT9u-*E)CCh`jV3{^Z>t|wZO1owin_t+@@(3UO^;s~ioB8a~
z<$UU`InT?mCaHey0%F@@*!5lDZ
zYy{J>ITPur@Yp{T
zQiD=(IQli`3bNf8?_OS2R%$B2mLKcmlAZVh*I2x8htv~}(%o(Gmf3g0{U7PS`rY}n
zNp1GhUuSuoe#E6vv@^y&NJ@e1d5Z&;SRre&TA4GM8sz>2M=Kg4}-`Hdc
zrhagrTh9u2ca4d0x%M|ISwIahyYfaT@Ij*UydjmGHMuzwM|S5j+-k
z0T4^1wk6mbsfT^gQHNWBIyN3^5(VSgJ&`_2w!;!Kz9;%4N>;tpHBt=@=$#IP2=I?cv)v$0#&pFqP1`IbCa_}jtPEiVB}>9g3AA0*R{>X5k#*1&79j%SoZi*r44$>oMV!$O73gz@%cm40XjZ=(y@43;yeV7~zW
zs&{0{X9XVB3J~c%!YoJ0)afHIl_85#BUE)u>$L$m7NGf1SL7Bm=U(toMR}Zp!&5P5
z_0d50dVyHNt@wy`(Bs)X!RJ?H!TyB=G@Xl!Xh;M#Us(+454re%4d#~LbM~rS{65K2
zp-?Mq31AAA3VTB-R
z(1ZV_`FtYDtn2yoEt=1ldNUvBj+;-X^*ctl!sY$nTECsUpYLwSzEONU68y{$Sn?zR
zX`bTYXR__d$yzmk=VZyML}pB%Tt#LV9?l&0rw5#C{X8tv=Ekw)q7{l45I(D}<|Oy<
zTC6cT+-D5#ihHpUuk?42+z}TPm-RP6&Ak=GZ5jtLI$}+
zf^CZgVtIj?SwDF$zV14E(SmhOrmy^T;D3To2?7sWy~Y|A?f;Qn%s+tqWBOJY%R3gL
zg)!VEuXrgcLy?d{aBpnsju0qJtO
zQ=tgLl!$y!^@|N5Tg47_A|k%dOL3k_DoJilaNd$4;yL8RPC7ao$s4;@KTbLt!#DbC
zs&jos`q2PvWF!)0ZB
z-~Y<~N?#D3THQDH;8MJ^`R%6hmtL#c2luZl;0D3`yrS_XBfm?(ZB$`}$Y8GGCWNDC
z|HbwAihoCi<#1ExJ6MjRjA-l8Q5`pbS9pEeF5b!&|BcS~{|rio&nG+I|3UQr0iEx!!SvExlCj~&GpVcgw{0yN
z&#jUWY`#OfYX37hYC->N`v>h`Wom`?Uv38YKj!nD@c--FFPKj`ZCr123VQS5RZ`N`_};Ay
z9;%9tFVI}!gQZs*^FL>JFqrry+IesjA};SC=R$Sto&i`EjS43p0OQHw^vqnu!5u$R
z|0Wy3WpWj(`Kj@^`7atCy!@t*JI(*L9rdJ7KbLl+j0FE;TBFEjoZdx_a)CJ*-}^r5Qoc^{*r$S$Kg
zWsP%|TT&GU$a@p%QP`q4>a@=#2Wn7NEBzbjH2KQ%
z{YrlT(XjO?*bgmcG7%BIjc?(80L{MIW&0VfJ$ZEDgRLJ*EGZq`W&3@D_Wu^PpQZLh
z#H2YrVUubgq>p8Ot71#OevIa~$`8EM{3?n0|Bg)%zn_1CUoEYYN(tQr!wU9qFyHim
z+7x+$)c5oybYf2y2(gxN%4(JMkA?7k?1mip%9$AmrW@zs_f+Nc%)DVr25&l4x#7du
zP_fqcr|4b8nLcOPa*KFla$Lpp5Z2}iC*g7oj8n_g{b~u{9+rI}$eT!)-bO14a_YDC
z6dFhEhqXbC?5T*z{5W8kRxA65U_OkVgznpeO_F!+kPub7(E%y8WG=(Ah`o1{nGpk$
z)nDB-e_*4bF8}etu70WA$ZReO
zC$fO&&Ax-?unu&zs-teCBQ+6@77QoiCu*^RimbHbW;ICl)%v&+3oZ*$TNn%TtVa|xH
zbm|U9u`qD_>SBg4Ebyg+ncxF5O}yJ^iA8Ql?HY9|daqWk*v
zu=HB)tBdS2j0cloL!a7KZMD_nBjG+uXdks{A7yVsbGzvtSyj(NB6I8P<6lqXPng{@
zI{pn1b9oKA8vkjK0yq90wln??G_+4W{`XdE{I?+C^m_cMeKn%!`1kK&{J)VlW$;fh
zzMkM;^;yP0#>T(di7@cBi2TCwaP4h`q!1@Gca#%bB(c1MjD&@K8KZh@;{-4VgG7iC
zcX#uAP5${CqtAcB%zN{EWB&R1(dX~z<@1s89}<23;$A)<8UH)TNcs8q^7+X4Z;U?w
z$(G*DzcMoa=<|2<^7*m(=MRZKe{u2i-fab}Omyy1BVyH0#+IzCGd3nC07MvSI%v6~
z+IN9SVOE2i)#6LvD4O!5@wCh2*?@x$H?M#g8cMya`p$0h1T3!>Lsx2`e*1Ej3lE|S
zqe6rdB2wgv@Z?u`68ergL7nC0pA5xC$CbX%qBh;uKG~R?mpT=S{wq=R>~8};s6MER
z^mG$mM>;y$*zLs}(dzG88%OpA7ZQbU5;lls5IO8!?>n!LwXnnqckL<0h8JTAsH@#uF2SG-TG;IGH1)$y8_F>=YdGH)*isn?0L7NxK=VX;
zz?~I*BL9%k_j0bW5jm%P^ooY1xuzIGjHGi!fc4zmki04
z)vHatarec}e|gy6_1`jn
zZJ*eWS47_7>Yb)1>cGhv(@dP;d7NT#=VMZX)1e$OiUJv;xq@O|F`g?&{s|GtLUEyR=7l;_sV
zo+dqMZ2o!sT~qWsG9G{Z;)qb>(@BBu)q213zS=(=w(kVr*Aemq{h9T?+1mdqY`?wr
zZf5gw4tP=f?$^7)+8-UZ?=+s13&#_;_OY;ix8o^<|LpiVmLQTTk9_`>pm
zG6CI8547Jw{dRjEhpXx4;2mF0BXan6IHrZR$-^B^v`-!(nu8gaMx*R&`{c3yXN~{q
z`Javc=PZ4;PoC}nJYAn{mtCO`7(|U5f4A?S`TDN^!|$)1IeLZRs3g>7Iz%~u#OQUS
zH#;cILctFVF!8kHPiZq~mBBezAK=0^x;mu5I%RTlLI3N>mM#a%`M$S;H(}ogchUEM
z27TWSN=d(tj(1IDyl$-5Mf-c+EcbFKJ*A}=y$hDo0$8BJpV(Uwu%>B!lDwezVynj
zeVP-3LzmKe{oCr;m)0+T(@C3!v)etKo$OCGk7sl7(-;x+>hb;ZYwe3XQvCjiw7hy#
zNMEbq@^q$+-YMB1*8zW;KtK-xyH=I`F`@VAB+z4$IK^6@?Ie=Ejc
z*WRQ3d}vY7KJTCFx_u+IT9%(Xx|(9bKizu
z(Vyc-uLx{Bm{$grd>woQ&b2)xm~?UH)w;4e8SV(8}1gev2>eQ`cOv
z_~H^fZ>oUx$`b5?2A!Tx%tz+e3Qocjbqx{-`rL!c!lrZznGrKZP10jV=nBCiF}+FG
zC+$r2l;7I5N1;!J44`TMT)g>BwY(?$jKl^#dOS}QHfwe^jnmlMd6G$dn!!V%s>?Wi
z;h;_;OCY_ebZhBRvb|8@u$?GeNiS~tx%eEj7?)lqWQl;}iw2UtipKHP5G2Bn%wZQ_
z>BHj+1QOt}HV=(&t78_y<1eIfFTMVXS`7ak9wXcZ05sb2Jq|*
z4@5NwlHTCQ3bcj@evB4kq)Wf{Y#}gujUV6ql@E_r+^vQ9akxb(h4|4fcnco;!ApGn
z_*gus6Fg4Pn4QH2YT%SKfa)Wrc0+k!^fw_k5hi>!{Y)_
zw-7(}Gb|6`@mHyng2xb6#K(`UI726RG#KO}`(*@A6gKnWaVT3d0*{{c$3LRbMD)i>
z+a%l9AKNao24U@m^Ms6ml*^ko*oB#sN%J%#;+`k3EW
zn>JL?*Vnt~Yv-V^1L&(O`6{nJI$GHj?Qv)qJ^qdOSR36_;Br(R`Uu(*(EEIRRrm7H
zcUi)qeLnuGxP7nmu~T6+J;_5q6>=2lV~4HpULN}MtHMHgoK9q}y_bioX#KB}htAl@
z7%~%v{6X^26H+(*_>&&>A?af?H0C0GEMmRC=_PgS>ti{f&|7)rQP^{@=XbrM@BS{i(!_c{7_81%Qt7{opF~L6{>JL|DIy_x?jOKk{QqYG
z|7Qn4&+gCjyO}}(_?>aKCq?W<%{M
zL~nY-|2I>v9rAsJNNE?;eUx#f((j0+L_jjaK=Os6aYVU4{yOphD+2xxH3uFK<>4_&
z4wwKQYeeh?kFi){eCmDz(sSVp#Qo32rcl7`Cdo?F6+BL0XBWbwTl(wh+xPMoOYEu0
zxU$bY@1^R7Q*TG3Eh5GbVE8w3mxYpcqVEAcc72bE_Pu*y-w$A4FYbF@(D&um_hNAy
z@uxMlGm+YAgUVKaH+k2+;=v9e{Li4N!Q3b~JiGf=)RpR7pJr5@{u4Coq8tL}{Vi
zq?`h$a*;w4sX{SjW+0E#fgFU_>hV%NC{;m2pwDKJtLxP(zt7
zBlO!7KW~})*-qJtk?ZJ+Z1t?S?R`Unb7HcsjXQeZysdmZg}&f>&9D5-M}zXE$MzZeQT=kwc;$o6Rpxok{idwT8i=%xw)3hnjv
z*;}gYlWCbxsI_m2yQJbi1y;Da`IT-LeE1eeOHLV-@eYOu?rXEL^F
zYAC`(vSW$}o+ejV@HD$i!PDw41&>rIY7;!2?o#l~beDo>mb(-@bKIrind>eE&wO_&
zczW!z3?9?}&h=i#ad5R>>L0|m?&@CMI3nx&1)^?W@B(JYZ$rW#!%q|cTlwF~|5^N>
z>+O4WkG|gbYRx7;OWcnpjJtmKqw(i%i~G?Cb5})U{AdjMX>dOp8SYx$kNVEtEcc_{
zmHZC?>>%A8p%}7((EnBNA3uWsICLMUUVtnv$F-X6ih{7Xk8wbC5%?3w|Jo>jG88>d
zdS6!WI2R?mP*6i}_>8A)?T{1r6aYvb*%h7drC0MV=~Gt+Iqo@P*XnE-+~4RK7p<4p
zSx@b$^)<Llu$azSQ^t2c+MYXxct#f6iI#YDe%D+|#Il#xOxom%
zkp81T*0a6MOMjWqNzu}?{e&?8DSJ5TV!iB1CfM%zb`o3S5I8x>vE!W_JrQk;BPc+Q
zWV9*2k;E1LBQsAGn52LyK$Our-*Dq*t7S8_6c{7NgNN(g~srgs92)l%!6E|9f**x6)sXynv>sP1V(j2Xu^dd*k
z`>%q%U3;{qU-L3zNQ!^Bp}%2s%wO$g`gsuZpGY2gc66?ndYZd<^W$FnF)LU2Y8r?S
z;neG3`8y8gl{`G1vvQpqd*0Z?yZUCHwkg`_Xr>;
zBBF=iRBeq-LG}WoGqkrWt1L)1G4g^be{q$-vg4Qt4LxvUVvhlb{#mxp+72tFUJGMh
zAt{5iFdX_m+vINrQpvNbq!-^Fe4VHtM^DO{OrEVZ)kKgKN9xK)dEaiY@|}qx1D1Kn
zK6d@HZP#s+^1(aoA)O)$#cvD_24Kniwn?uAdzF=kRJF7F0O&Q|dwTSJz0;%n(}cI2
zXXFOsiMO0b!HxD!E8{KrDB-UQKB7^GyaQ#mG$jP>JX_$w#PHy%{R8+tKk2tEBU-jG
znQem)pMyx5v6NF{mJmy{H0gKr@V+nMxAm3<^eor_rT7aLLmKPNj@YpxAGy$M^{d*M
zsuBf6p@83c>7~1C4%_P4(wxkmu_D{CnAX^^ShM!s46|rweAQN_jf}Oar?)0r{z!_y
zg)dk@dTLR0yAnI|uzPUf(-t#N(sku@J8(CqhXpbcIoGI-cQ0`up-`@o5SVc
z`;5LEUN*%!fT*64SkazZTiwn+kLa=4n!zm3U+aFH=ZlZ_Co)Rmd+3ZZ-M%Kbc%
z+VVCiH{M~~8ihygo=7EYwu5tLM?E#gAhSa@^}DTL2HPE;WC+x97$0)n?3#PnYf41b
zFSA(x?6>f7u*u&N3ibF+7SfAdB!y^_XF
z!Wpu@!Cj0rw!+u%QkRDB_}tiU^O%L@q}K-bA*_F0HNuFTLYwCu(Vm;W7On36^8yaI
zyDB;R0FEZxd`!!@y~1_=9^R(>ruF`Z%#%O?$GY&u676)xq
z2s9*9JddV21Wj7!=y6r+WlrK*Fq>OV`J>mk&;0Kx_;`jz^^(!&x3Yq@%#|
zV*c9TI_p#!_wGWy>tfC2=ISL{ArCd)7qeHBB9J3MWDL=gCh0$jNc|adOOzmu#Vu4x
z3F4MGcSW_tvLh0tlISe^DPaiDT~S+AXQwtjAdAHNWnvu~__`;A$QLf~^(~NU5}|~V
zW6TF}*c_ZN`N$=5f+*_sx4hQU12t_TZ9*Q85taG}@1kYB-0|BvlRt?${Ar!fpQVf4
z<0S&)T<@a4@NBVlBS#JAdh6b*=Fbb&-h|7eP2PkHqOIIMqi2un&%?YpJKD+B2HkQx
z*M!s2;wDT-d7ZE*+C!z@gmkoz-_9B5jo~n)Xo4j$bt%NQQF>WJk`UWOK5~Gpkf}8d
zSaUG#@OC1h#&jtoUgip;@%l&ChpM!~fKA@V{B>UDKPiN&T8kv_N2!3IYtsGQ=aNpZ
zyC#d~6gxFST~?mr$2m68q5B
zWcQp^u(y12bnqL)fR;V${*A(d{hrtfe%2axq@&K9QHGyd-|qlF4VSZ1`|eW36~UEI6KEIGR9Rd2lsUyUvc-}K0CBZQu-*NYpu
z6Jkz`3vXNbdwR5qzsYDPf8#>uA4hxm)|+sBwBLRgnW8Jq-oibYJ@)M|yUje5BVhI-
zJ}$%Tx)Cv3c`k-y_SrkfY)xDlX8)91Fk8dOHl|9<4)M_N+MQzALusbZsRi?nFXDCY
z4)FTaB3^gy7_STT^LF_CCE<4k=)&*k9~2f%+3fJU(w^{JAzFpKpz{4a!`@f=FH4q(
z)6v$#nuxQ8A!CBa;8q#?c>)Yq)}Y9zS^UEi;;1(j_Wk={OU@EDw!FSucTis*bBERU
zzG8hN+B?eP)fN7TIc9kHW4;qD8uX2YydqwD%
zsUnmR#ri27Cu#P6`Pt1$V|U*q*22D&ixitwq(@E}1-NV@2C1~P4f{iG+e?40-i3I}
z{mZbN0$x|b`;#pO?{_pIhBt2m?_mXaI|*;AfOkv&txza@IuZ)IVG#<0%>0WcCh97Vf^zn@gaHXkQKfJJ90)R4e1TkA;TzW!pBWDQ1M
zM=nyI9i7#M=MfFX|GyF6e*(lK;=A#O*mNKh9t(*ba1%?wLH`>9XgASvMg*8==U^Q01fjW`yh49W!ie-zRr8|qH?FU_#>c}Y_%FJC}{?Iy+j
zOZ&lZH6LO9<@azwHke_Tw`5nXaBIuZpoKP%3
zY^hfBk*_aL@EtVovZVJ9Li
zC*4O{j8hSc=aS!vQwl#+(7w(s?AN>dZq;||kopcP)VIH>@mrp@8mp->AK8oQiq!T4
z)$RDbqvs2)zB7l^cW|M;1FgP3SKn<=eLiw0YTapC7qFiY`6f8a#=jeNk9bwpw@dt?
z&B{N?-yPvU&6U+3vGTVT%kOM{pIs(+K0l=Vj_3C$R{n%y`C;>WK_xsHD}O+-{LbKc
zgp%Mtp%J?_KHs+T_ZG_!gXhyD(qnatT!7I;@*qPyH#&f?TRc(B8xcI;=z<@O`535RgKLM8u_
zSou1iKX%3VSnkAp&l?La-H(G+zoxZG`-GJpoDuneEXsrTyYD-4=j1zbGs)-ob1(gG
z*5G}}`U$U8xTjjHvg3C5r;nCMuOXXW_g1ZkI4HFGe&tU2__=-lN4(|#mdKq~Bjfxv
z_h==w^7o@A^_Nvse%Tkxj;;2SqiS4*Tf52HNcHX2E89~qRL{Fj=h2)~_5t-zV=YfU
z;8WGY6*F^3=hXlBuFk@#76v&%23}8#bDU3o>F|
z!lv%Q-%D@wpARl(S;jACh;?BR`bE1-&TbaJ{`U22c$*I%#L}m-f8w{CUvOT7zZK``
z^bY?4tX*rRkKu)nN1GDa({XDvY8SNoFQT}2OjxVLH0`q=?8uGnby++)9~=~dV{t(H
zge~z2&nL8zefB0Lryxtt!N9BpAl*n|Qfq9!owB>dCk(`^x40Y%QkN`~Km1`Z5Pl|R
z@1?fNS{OwORIZvUKiW&>9r!0EvC$D$Wob0Xaj6b8BxZM1l~;5-JUKCe)G}1m28Jl(
z%Iet39TPUhiZ0@U)o-oUNOjp`>c`8tklNnRb$)7lotM6!J3PG_nf(&@ap<3yk)faA
zjT50Dz3w0sB=UB5oq0lT@^?CN7u>?jFsIFRDoNW+Al5rdyD`unaq^0;DDYh!$+};X
zWJFf|8HVupllR@Kzm{UO-)%>rmAcdLujg9;ocC~hP(UY#i3>*@{tuNgTZyYhaO@~ZRmDMt*r@8;wh$m
zI7w~nF6>i!zde>cx`y93gJ#~6FB=uw1DSewEqrigO!
zY~T=`E9-pEPTqTz!=?AQ6i?j-9VPu_9Ot>EeF)rt3Tjv)@$
z)T(i;_g&?wEgX0YExuGk0*WjBG2PD%{wU-l)_7{m7+&rc%f@MPOm{GNLm87O0$cX1
zz`y>l?SH|(Q1AyJ18psldLf}TZ$p`(|8j-@Onu(es43{Zh-}>aP6SV62?O?CDJL(U
z5gsaN`hDLAOpTTYs&+~hPj1M7bz<_%9yX6FtRQ^_5W
zY}x8v`3er>V{=n}BIK11vx)s|w@5`KrjnomKDSVbfe)w-@%3bO>QBW#a`Ok0EtsuO
zrGgMN?Jt|gn#9XoI25!wtrDR782j1s6M;rdH+KVvlwg}v0o#Cg<)`R1u-ziqI2SPl
z3j<{Vth#|kKMcVt!t=aqT0^D%W`9OA_A+bDwp<*lM0S3sVm?`5Pa%`=2>^sD8YL;)
z)dOEqjT$V=nN`TU$0?#4I44`vfH|H#SvuJopzgX^pN@;7z!ssZA9(Gyp-_!0LDc|M
zqhXa^=FAYPB!_9iuu)7HOT`Zn<@QiM(uex*PKWZ+zl0sTt=R`JgZHKK9DPGMoe;~G
zMlYRKRmwtTA#!hUQf)r67!+{66zvWe-2&_JGJ{r-V6$ZQv$#9pU$28q0IwP6JDcvt
zf$6luA!mZ*vU=HU<^dr=vgF-!dfNZ$$BkaqJFOwXNni9Ri{kRJ_cMS7WB6reW`A(n$Mb@Pjg9X*Xy~L4I
zH=`gF+99N`XleB_O9WbKO`;@03;Y-3=r^TTFp0rAh!Z2hFe}_fYa=)YmorLiS_sEP
zS;DyR)hYNMoqk*Se3|_p={KSIxu
z4~6@&cF%tP>R4}UeUJq-@bM5aalaDklMc(R2zG3fmavbMm>-|Gq
z4tsw+4qVR3y@~f&mxsTvvF|tP{p;?1Y<+8;#;wC|p0+ODTwfLBDWiccn;%OEl#eVC
z8{p)y!}t^2XM?>uI8sx`{WjfKeAfM7KC%|O#2~8U>cRJmNDOnqWnF>Y&ynYw0tp4m
zRS{s0bCb~3_n0x90N3yl-sIiGN44Q2Y@dHv&4(53c^Sp@m`QLSI77&+2U%GUEjLN!
za#MRR)oz?)SxygrNnJQ!kB3ybJI{!Zhe-~7^McLQBB~EQMVa7f?$y!v4lTIa3eKjW
z^;rJAAgV8x@xmV6YwP~XAy;zspx4!Dg}$Qi@;nIU^QVCCicK?r`cCENo^Tn)+f17~
zlb`vt8k++uQ=hZi>>n8hlMSd>*&It1JneV&7m;Ai+Himl#^7FKB3bePCpG)9p
zMfo|XdL3*#k)Qj9U{%P^WC5%qJVWH?2SBx*$xjb}it_W+0zkVYKQI5bJ{>AQmwzuD
ztRhrHaTBQa?l%Gef)2kiI&n@udf?O-e&);F6GWnT>?99fb74yjQv;RjF
z*#-HzST@a2PFFCCx0j!1@!9`V@^kAFIOW^O&y9NjHu7_s-oK6f?9=LLdR|ysdTQnJ-w0SQGd^736%*zjL@8U`Jpp4d
z^BoaAH=#efMN9X8!*toHgPN<cuwF^97-4_vH#8h463>8_*cM(iIPfi+KnF`*hN`tUYG_Tguu!o@ime8;c7EC#
zh?{C(ToBTa#?k`yC=|$|fc?UaPQW&@Xe?Wx0!ou*R6kXqu6%A(KCN?wzPHYnF
zjapGDU$DTh8+aP{!bOSJ$thGmFY~o<%@XFK0*vMo7%P~kA{e`cV6X%k0!FKWF{TK{
z1OtNzwi8
zr0f)!yYi9irPmHemZ#l{=_M?+aQseI2exQp@N*{-tj4No^y3U}BA4A_`gPgs_ZAja
zNnc?f^H_PF-z@pRE~O}~>O^+`qYy-imM6W;;RckV1hw+glbY~JgFQKNYSP51ohvki
z2^_7GL)T&q$LRO)iOCUSt%~}ml6*F?xB^$T?qN8C%TP~C>oMLpmcMTde(4rv;d+fo
z2Jn~f712NqpmU(W)X+X;>!;vbu1Z_471mSp^sJB{?dbYo3+tA1`zqH{4Jgt1$d<1_
z`4O&$t(O!>%=x!^|0I{g-kWtJvPAE1aqna6j}F&M2eDo{i1kvpt*O#z%#|#t>m=fw
zG$C+&q7~K;K5ia^*NiGTFH=Ha(K*NRrOZ-$7oVq4=8WsZ?Kn!FwBv
zlVofd@^ZOe=B7UJDG8geNtYQ?Knw7E07YSX&)}<}NlqQcgquY^~;@P^L
zkE8(HfGoiWQU!~if0dzIAN27X`fI}dO0ntf{vR=^{*0c_PxuRZ61m$q(nP|a(Hr+O
zT?`sRZlVQKC;baIwD}JX{G2gMW-qH{GGNpz*np(n2uUxoJ&|L>lWl5R$6>;ck^)_2=7Cz0WUK{QciHPt*tcLw`d~(r`#oV>hFbp2$JON1vjDt9Nm!2
z&gf%`du@t*hTZkJs)Ct^O3LKp|u`QGyT|9*-zs1gT?I=`V-lV
z>hG~_Mpeh>YI<-0B{+`5OaF*(ak#$axukKGMkF=ZV$cH~Z|$yO(GAIBMmRgw;8k59H|Kf{L2lj={V
zdp)sFcpw#^*M;4LS|d55;MjWzP}GKUJt%57}U&PaSW1`VN?VS5?&C)~cX
z3dH~Vw+!)Pr^HS*)c-ny@*jixUFv25^<@+=>_0q&4GKtdXkH2VOPIfx1L@4z%%Bcv
zI9M;^W*bBKqltx2yZvInO0e57!2yILY*Bm@GW@+m;y)_+bY?RHX)*u~dGPcg;M3$6h^e
zd8~R$i+An2RCM`gN98Wv*xI|GueIkd?EkIi;gmzYYhI^t5aUll4@o7*vLkE>!ruIP
z9scWxnm`-5>^==mtmUR{Qh%_gJq-05x0CEUW^I-Jl1fgdp8e^E^AEcB3uzWCEA4<(
z7(cVrdxsq1(17+fK?6oz$bXhL
zaQ@WxiQYBZxAKoc{$qyo{V8RTIsV^U;Qs~+LO_ra*X1B8*kj@M0m=n>j_G&*Y<_>n
z$o$?0?QQveTdy(usUtG`TYp^1?6po6_jSx(mG>;@t>pB}nT&rnr|)r`UhV&NoZhfs
z%zmFQy*;!4kYn~ee;>2g&eGw`-tmKc-^w~OAGr>Vv($bYXLF1nbB~yP4`o_a7rRrXB4R-GC4ozwP?=-0e#!86zb{YC8@-ge{4$4qVmdZ;bcO_KTHR#%|
zEHTO1TiaV6z5G<&j;RpZeM=<9bYb|4+R{!1CfvYg7Q!1$A6{b
z{m}fAj(*xnE@TGVOjT`FRaYIu&4G5)i$fj~+dzBEBbQ%NMr?0#`cFt~cu7TU
zod3NOV%szlv2jk*jLvY9ld}hGo~=<@TyRZk75q07;Y1@s(wtNf;qOI+OC1p|Mw)PL
z58Aav2}JnXslmP=np>Csqv-I*B|5~IUQUM{tVL&t4wr;{DoA1v&%+
zx|fL#Zw*?YhLU_J(qlW1nN%;`%EhkH;|$T`z7#Lf<9&8lqDLjTVyY_X@wdo3ka
znFEk;I-j+>c-CHZcf_-aR!nqt$!uqH$L!bJTYj~mBRSy>Qq7j+!n)8pDy!0j^)f7d
zW@zp!x8H%vn!?H&U1gX5s6F)I#Qi|ZW5kq4LOUNV=#T5Y8&-PDAGThf(bMje#eYUG
zo$oDlKKM(4PgYv4K5DYAXh3$B>lJiZ|BljG$Jc(0B7V-+HEvN8S6u83vnY`8Z_wbd
z?-^fr*2=^g_^drG0G-TQ*@aI@H&4!fHT8N!*LhT6t73Z7Y)%bJ9aGeZ`9`l%jJ?eF
z`D~;P_hU@+mSeqSrq94eHe+!Umfi;vK8A0ba7$*>rvdxm@bA0N8mU?0r?rE*RPR#i
zU0SGjNm%a>wcsl1-_Abv)57?gauH~B>}v2f;sbN6h6?)$oc^aM+UqdHNZxF^yd3{W
zmNz3Qe@lhoXnr@Ma4oB}l4Yl!ag~;4_hJqO_1m+>Y;E<&=cWvFWREb(s{=XFA%#8ZvkhU!;!s75`>&gpxTK)>c{i+eORGLp7}vJ>18!OMLl)+R
zWmO-h`o-b0s$2zpiOFXMy>tXn%ay#DMI{fqUJ>)xVB~g-s$JIeW`-P~g7&cw6dW3V
zvnqGnj#WA4O6#emrpoQh?36^uA)w4Za6L7}fH-}~dg__tdP*LXj@)sz(&3hdIvnn!
z{fQknnPI*Y95cZJr*DOR#i@#<@YfamirLX`g2nB*A6t@?BFX#PRpcR?+%x3V%bd;?b?)eL}ynbyq1s0Q}vySTQuOwR5Pbm@$kxA2}qA!#R6IFwHC)
zRk3aB-TF>SUV>CtEcJfDWop5a)~>eL%9l&4yXUH>WvAa!xw>0wwK)Az_VRdvjzhbM
zPJ+u)Y!^loM1IB>xqZD?vsM^S}xp1Sdw$rCVWfexpts#p=8FB33;34v3Y6WFFkrf)(_%=Nai*`
zzPyfH^lCn)%xM`5BY&!PDOkT=aQGb*-`K01E~Z69&oq*q*CNw?F)rrY*5T!6W=b
zH`wf5xskq?_VX;HpG;=be`fGMO7c-yeeXhz_kO8F%YIQWtw?8fPFs|fN!871Kd@HdINd?0l$&9tEWFgcjdxUBijak
z{dr8T%4l1d&tfz0P&0;L!mJ~w{yTWu-C8+?-De7!lK$2*WOD2G^{w00!=yh;=h`pP
zwIzAR%2mLpqlHhm64&<`@Z~0cF&tG^-*r$v@_hzJjK_uWZTA}TvoL^_HFp0XA2~%&!MT0(=Y7V$uK1iQSgXV?1&safcg3xtxFuXvR^w%6
z+bDtyAK+yPXZu{PTDKWMY4v*PxJ&k{O?3%>ax@M-v|5(%G9`z+-gvGKMS|udk0B*0
zBNdX_FeUB7W5m&>-pkbFBez*O76OHc1`DL=;52Qs3$ChBS;#+`ZHi@&xq$7gU7zLR
z?2hb3qKGaSRI4r;F;Nb*=f+;;oa!V=ef1u!QdRlR#^eNcZ?0)y`6m0?pY1-s;FeLf
z^UJu(ZI&q)aDtl
z8SPT|@qBU%Cv&4ar`95zUh=N%KX6s=^yo1?Ej5?^EBmP0XV>&3tNZO7VxmI5%&m-h
zMfgoC!e%Ah@Tu;fwWr>y_O5yTMBzOC^ar&{Oo!
zV^WhX&wE#%rJ0jr4~x|4xy0G^x>28FHK$MHGcBHMKlz1}W^)5%hKBW71p%r}Z#kI=
z6SH4T-`9PB1v(}aQ$cJICjW=9r6yV+CY8Hkr6#C>C8$Vurj!kkm538If@sV-^}06c
zkBi!ZRFB{sbm+*@Q?3v%KUaOw9EZ`K2kB}0ZiG!`eB}2fej@!B6VK-&8>(KL_MTB*
zT06->B+?V$eUZ)vCO2946>ppvIOuc8>PCyRxIB6c+=7Q*x*sV3TL&Fl-B3+&HhWl66sMln0oo#*XQSHK7
z`z#-sgh45gHQDM@U`_{KO^Zn1Vq;~|+YITzyRXoIA2Tb{Z$s=|^Lq*gpXJlO5;CBk
z9sq;2q{*fE(gzMsoBC`MaiaJKgAE1}`9=^{{+M7Ti0bq)=GBDa7gcHsO*naP0OccR
zeAZ3#tYCt9U>Tt4+C6TFUy^QhFvy*(T3uo>kRJ;OVjoBHU-
z#wY_@?y&#MtKby%m$#ss3_1CMhfUe?ot`9DRDY{&KFK?ofZJ`V`FeuhL)6y?9skmkThQ
z7xb53e|XpRm&s+{-Kg(&pufBzNOnPgxzV)EUDIEBX?uwN@(9uT75dAs#oqrv(q9I!
zR41|(`pdU3+PVI6+eMm+UDsbOz8bXHCH>`O5|ZzV{&FU}XLhc?yw1?>Tz~n6N)6Lr
zzBX4wgW|qJ{pB(%@z>}t-@UM0e>q=$*s1<<%Q-;j^q232m{(FvyikAX)1qxB`peG`
zk)Z!Nu{)JoLAUgm+wA2+URLTax5~00oh=`^(Jn{OUk))@-!>e$P=7gYfdPlT67Eph
zcBTGuKWMV6`pdgM66!C{9IS4gi8LCbzxW%H{>nD~qFC0FwaUwn|1tqOMf)A`OS&!Q
z3n}<#6FJ;2>{TK!nhwxnY0O>=9i8K^_d6D`ouQZGg%+R9;hUkov3o;%ZkbyGv@Oj?
z7RgMNoq8cUO+NB&x?~y<5q@km;n25@W|H}lR=;l>@|Sv{6H9$G0dG+3jNGff`4ZVn
zL|$5{f_@uQ*Va$K;~lN&tjXMAXE7K&?g3V9RqAGq{E9XRV0C?wFFtu@YWq>n@tK^x
zMJLZ>*6G9SVb_Z4bDyUCh5fN?n;9(r%k*H^rk%}1R9XMAxp4=vYo%wwA_Wc7&|`6J
z$*_$swo_$^cH1>!oKR_*j4-g|$luel&C7gB%Tl~D`N*%t^eRIEzoM6H%-E6Nn*Ghx
zI=HlGk7nBl`^V6lf|F2n`(&1RZs4H*kfFC9J88Im_gQt2kv409wuo|Ahg`6zKKcSH
z>TK|rGlcA6_OJ}=g$~@M=~r0Mlyb5(Oj{pcQcqn~!De2tZg%m%zb|fdDuyWj72AZm
zKR4p+wlf?0DO6DW8&Jr_m@P~1Km+_oAVJKJIVpg-$A}>O@4@XDGP83k(54#7kt7;7g0hzE}5V(O37h83%(#@NNNqXmestU>_3ci=rgH~s+!ar
z;pp4>U=aR`w61IgCdli;14r^*a7uR$3DeMB!Q5rw
zR7KLLbNdu{Tc^!K4OWAOi11po7(CUrZtq@?m>G?+mcU>;txlxeiBaa}ukxr+m6*m?<4#(kx7hvUAvEa25
zT!eS1X;B(e&sFeYDkZ;Fc8mkbJ^YP*5f{J1TD%@Pq!zR}Rs-((VZ93b!GV}tVqn?E
zDSLQVeV>n2b=jN*=zQQx`F3ILjCvQ#t$bt-tAc|3G}(#2V}ng@Tb+VAkeJKd;e5y@
z4(lV9WeErKElv74jR>2ITKPeyP6=fy8=|sP4`%T5kzdN8to{4NP!Ggtcr@kSV}(F%
z_ye9wtlXm1wKTUbvGDh9uiGn$mK|+39bY;Z&C5K*Fw4rV5Y=Tm5G|3@F?pGU!G)2
zZia!{wirO_CvD=$En>m2NCN&DJ;~hU4N3ne5{B*mql4p0{IZ?%&5|wM^-u4R$KTf>PdJfmMYjBR_&I6ZhNn~?EhD6FBt!Dn*n8pxUF%G3W+qgN&nth(M
z{F#KZdO${qRF^JXFqzAB@iB_`juw-1c$KqfqFc!?IfWuz*GCMXjz(BXt3ZUmNW2D%V&SbP_Lh7bxV!QhExPY(u&d$cpQY
z0)Au*2r*yfp`qPLs@cl%$DA(96NVv{e>g-3ZS%M6C&GxyDqm0b@$h)pgx3}_8T$#Q
z(HeSb*lA+tBofG8T$nmQ2iZBoQUMN&nA1{cgO6cGr<_L1eQ3;QecK8iz@Ejpj1MKU
z#s+z^By0Q#CQcm4g-91;Y)d%)7X@FOsV)74e}mAAbwXdrqY{2jW9A#edKn$Fg%_x6
z54006{R8f@KhYP4g1KgW>u;O%M7;NFnr-kPWQt&12&_QMM*<9J!dc^p!`b2PpfVBr
zR!K5z^@h7y9a2-j;vR&|2qZN{wG5sSa{G}rPtKcGiKM)%*<6XCEp5GCx*L)jfegI#
z>AWZ)?@a((>L8uCmg@`QkOs)A-^(pzmn-hz_Ymj
zOwcZTTW|OVXA1LJ-wCW$!H3){<73?WTZ1Dj3p=J29LH0g7=q8ZXKJ*yx10IZb8mTfUodf4Y2&}a96VLSnD$H~
z>Cy?zLrGMw%p$Ae>w4OA91B;kJmQXb{dk+|7F&dxJ9@;f3?XZXX+SczxZ@~Or!WE`
z?>DX4NeM35Bv)efBtCwCaU^`TARXNLOXqa|(Ox{${Fs*>t3kFlEe2fjeR6Lo;0x9H
zt0geSK2)s3#_)#uB5;i%a#2cBQwTFQrQ$kfOR2UM
zTviRm7Uh5`cGWm}VN60{jMU0(wL%5iRO&BM>e4^){d(iusy>LQXc^I2fZy%(yefD~
zBEIx07(b+G(a0F^RIf_3yy|6cksTFuQF%Vn
zGY11{;rz^#*~?oDUzeBk53G9TFq{dNDogcC_)U{+1M`#FA4e^-GK;xRyw+N@L52Q_jW}O
z#r7c6567DS4t~_Y$rNk7%zRiNXLd6Vs;I5`B`3%zgbrdj$Un^j;vsG&?daxIvGKb<5yABxqm!zb+w_;0IQC0ajP5w)KRVdRG
zYgyNIF59=&Em&Jkv^sbS>TvcdOhwj(k7c_i)d0*a22w^M{hQL}rJo0$DJOX8r}?#S
zQv>6tOuuwlA{Tk?-L+L5xRRJ%b0w!9So~GV&hdtZPRGNjy@XDu3y;F|Qin=VH8MM%
zXjx&0IL7NQ)=AK{}SoLVJu>sxP){cH57{
zuI6!843+4pT4SC`FTMpUR=jz@OSjcjRcW{S85N-Hrbg@hjfF1~UVL*fg(A+rS6=nj
zLe*Y+0hcsfhLV{J;TE#DOd$+R_}@a}yzUzGSPtpkhn}7uohvMyi@|TcP?tZ8jAqMB
zX7k=b7Z_wt|LU`U$}2iHO4x7!wCRs?!Q4Dar2@Ka)aE-
z@YXwBVSmq=ZpLMh=et7vh4DxbM)fV87w&PRh}^2IXq-_G#|<7AD9uFSd#fMLP^h2F
z;El5PrSH}TtC0p_H{Qu$PkO?FkAjzZ4D3$>t#W?NHB=B5NDGQg!|EyH+g!13MqWI2
zjP*C9938@*%q@y8Vh9pB#{-l8+0j|Vn_8H#IBjib9-KRGpZsC7Vbn?RQmi6@fa$Z}
z%Ozm0k1pnhxTX`#R+RA5_SSdLG1WH6FiX7ztW7_&94w+-XUPOC9vI^MUTK4f)8nbr
zdh%I|5iRw^aXLFN$4<*x*EP|~eSG9{hX^*Es)K>zD+1am#{aEGsx!&x)Nxi5KZzOG
zyWcH)_vye2sU<{6>ZZD_9;&BHt%fH%v{AD0G|4VqtIJF5%{qE*Wr$CY%}|v`s>+co
z%153(RaLCUYn58l1QpNGmUswnIpsGwR;ya`QLeFNCxv17FPuaye|BUD^^s@
zK-QI~95-miE5H!z%;#E$nBQgf?ssXU`(4uPeitX)Z=a++<$A>{`0bgmU!4uTnf}??
z&;#K`&-UmU%=0jMKZFbDp0;!!%R5Cpg9japqaOQyXIL4%abSQJY
zDk2|!o29<3P?eDz(Tu<@r5g|mS=W>haCe|9j!F{PV`B@j*VP0Aw&Z(zjG3bY?`P@2
z`^CM~&TpTHfZtvXE5AJgf#10^1;3OH9WuVees8py)&z@!G@6^fKhXbl^XdU3kW6tzb<%ESW2;(IQ8oo@7C6H6W$g5q9P4$JloW!O$P7e
zGw&VS^=^AS+t?;!YF>-7aB_xl2LsIw{HR?W_)oWM;J-R_;8ETF7Y)VXk3y9;MUQ9H
zGC(JK64lkVIJ7uV2Lz}evMJ}q9FYj{J(h?dkr`+
zJMmu9L9_-ne-Lwz*KXFyMRfPlF*Lp+x`(~Vb)KEt-sUA?v&O2%fj3SP9u+oWs4w&n
z9zw|*f$dJmGgzz^bthC3#v5%q;Xgk`*$Nz>PX(x
zhFs*PH+Oey#8(ozOE~)$n}^d}ixejo7&|H0CX4N^cWBB^$N5qgDAF5-bO^oSS1(oK
z1jD(8M`cj=>^7zZ^&2imWY=M15wH_k_5|zbk!X18P{jwu
zRH072y?$I95_ENNmA>5d@nPMylkvH;W90GKpN7h**^h-lH2fu~=AEn&CER=e8@tO4
z;Slc?CB)Xs&jIR|gtq#H>l0XVl1brRVEJc0PiK+8LpjYtQdPxzI$-&ia%K8YxQ?F$
zWWnLE=Yl<;&HoeI3!eylja$)XurBzHO?9YI{`4rm>PIBndiN~C7%Zm7w^7k@G-i`b&IJtsN(_l54eBH
zqiOr2?Yy+YNyHC^nIF(B!i5&5bF@;dYe~ent^3i&>tqF~FN+nrTy}w}KRHUq>ziZ%
z$lkC~vZZJbmzXTt!_VTz&TxN#$-*N3BIXbBaWJ%I3RhAfiIrq-dUOigbqR1yFdtK>
z5Hx*_%eXEjbz+}L0$`KWkjB`_ipOgTqvI}*wi34_v%XY7G#OOQ%L(uDA0aR$A9);i
zxr_fi?2R@S6
zgJ4K=3moF6*2`!qNP9E!FR~Z0!l>Az&kH8LdB=ybb1MhGA^Wq^Qnnv?bp58cPHZpacbLrUxZ@DO
zmVh~kQA}1TevM(oK9R^lq+%2GViWa_O~4YSyS=^5`N%C!JvTN1T(nzY6F*|R#4t3u
zIK?r*6&d0d9nWTkIh-s5hN@v)!J^
z=$F0GjAe4zvJhc{lm1w298>4QROG;I^a+$CnSnm7B@%qHiQ%OGW3yhHF!&Q}BAMkY
znI#t%5VRQKdb2Ig`C47?3h`7u?*a%R+U5Gy@XTy)dB96sb}U+()8RkY;lI$~|EWN4
zsXxmVi@)_ni~raFDrXu;D=_4KBuOJ)F)EqtT@S5MWck===$6Guzp_R~g1vF1m;
z^k(klEQuoyTIHj9E|xvQbOxNPt#Yz{8LCo=SoYmkh$7}B#3n~I6bc=!J{~#Xk!u)@
z|Ic*9|E<0=7fdU)s%{smj2G7bZMIS8xIM?QS6Bm^@rH#hTZv?)a3
ztNM~m7ALAp9Jn#D$7Vy*1RP1ixQO9i=5>L=S5%_!7p@VeRfuTOSpn$jlrH-3bX;Ar
z%frTm5%JP{)2Gtc@zU4gi&aT4J`k*@ccC2b$X!~KZ0RC%R(f7Ilan@)q@l(}eU==~
znin~o7xG)?i$*_8p!D@nsr7>lD61Vffv=faR?CSz?Y8xk5w4)79^gHlpi9HB@
zF$L~)4dUr;HvuK=>U5DEsuV;#6RoRVY7EElIVIC9
zyZ?e5S*;?v%zA)OzM|cGrbMf{KOJv|#L{zV+9#m6##Li;U~cr2c~P3wZ_w2u9v2bi
zn>@|dL)ZjQs(|dvI;YRDoP71JznQUA1+X}HMG`d(O37`W06WZWzQIfXPF_ta%bX8F
z3FP#@S76o~RE-1u7uH}$p`G9;3Ta#l(O#WJu&+GReGe~WbTIZ
zPl@8;r1>CcF!WHm(A{s-Lz}1ILTf}p2EiY#SX#v(F`QdRb~0l#)ZQq;oB0q0C}?9R
z&we<=Iw`@0x0M!Hr5XP~0p709t*ePv1?-fu_=PqiaU^&&H=yj;Xz=^8_Dk~_tfG4s
z$5xm}|M6g(6^&bPL~tkmPQd>SKR_2w=nZ^j6B_JKSz4~9hzqML3^M$O^Ia(?T4EJ(
z0>GHW2$vEkIB^klGFXC#B9nnZV233pJHRiZfClg$LEyilOLz89Yt^I|q5NQOSVP!@
zb-_2R)etj-Z}3_$xWNcE4lR8vrNj8agLr2YppY<4MCLj!ptj&(Js8UTrQW=9gw&g9
zsKBM^3G;*5;)gArGm=t4Y**P#s#qcfkX(`OtLQQ5Z9Za$caj}aOeAA?R9m6-YAO6G
zDh20+;bYx_*85Emg803d+ZI=$_13D&CMmh~ruCX0>$Kilt%;+&o(y|djw-Z|C@`>{
zJ%HUelVXV{6ZOO?zC1x`@6dLhF#6U}wr2dq;xDdkNQ*-e!Wb
z)@_4=q&At#vfW?TUDSUqB1@~}W8%$!kpjHWsD#Nokeis=UjmJPU*f=3i9PNYQ4>H{
zTq*w$2x)UB+d|7^a8ds~*LXuKVQYgo8sBh1qFNtIhKLNwJcB=D88
zH!*ZL{gp(t(ie+qS{A+_ln@4*8i~>}SK~WhV9k;`I>+?HvK@(TGom&nZsyB@Q?8*|
z1%|+?rEl^%TD3lEwOl$ASYs>1>pg})qpvg7_44T4IDpfNw4zjhea~eLAfD3`yv*HH
z3|chv1J>Rc?cui_4lz*0?vR}Gg2mCAy?eT(Co4|oL(+&{$+$G*>^!uE%j#4L%LeDP
z9WA5r*eH{~mquyk`YJIJiRk+F992u_o*Spv^YwbJl$H5*_Ugk@2to~_xH9lERr~OG
z;Tnxz8A251sSL=XsE_>R;C+kT5-dRjQx@VuTplWHK!)J}Fo%(uLciowxbt^3lH~1N
zf1NgCEuYq4qvx+;gLGPPXDvV4LJ=?B&NZ=5ade_7lU^ieoJ@a>=}ldG##^Q(k=FEu
zs|5NCtDtyGYO6lWJi<*Yk(RdQM;n|{YpdJYGwY?E=e^S*j)AQJfz&M#u^Af;Vsm%K
zne;jN$dn^B4TafdtUqeDN5L~E24!~dp`GlRQv{~JK^?JJCV!P8@01kLwq}+XULrgC
zEY`ZHR!sAVsB#`v_1vkj7rMU@nUP4%AAq~8@zM=2-QYnUmFl~viE^-W`j?M*6BP%0
z3|c=uz4BeOj$UAnj7|$V7S?`AzHQN
z2cDiF>J#Q`77GKEj~x6FhyMFf5xw~$>&(&s?VwK&0%QUG?O38a)V<&X^e4nGMO&Q%
z!1pLDDt;srn$fB{s4^K8b}986z09&$>xTiY;6{4=_CVXZZ>MyAYs_1jjBY2;Qj3240kKqWp@Q1rFUY8nUyX>@2Q@m{3OXrh5nT?XCo};Hd@QHg5;?s5uikpg0<>ZK72(VsB92=y{wB5<3tgeZ#FHg$~j1SrSwCIne%is)buu&8xUt1PPmUm%iy1=>
zc*`%39?@ERd6d0lg+);3fS1{?meQF`UHcjbOZtD3g*0--1R*5*A4oRao|{{pXqj8g
z1N%Pl;sz^849esv=W!pTIb!pi0MlnCG?a;QT}|DG?12)*w%qT|8y8&FhVI#u+0M1m
zOT8wLZJm1zn+tjH0Ct0tmM>h9K!fj2k=u#c#jkSl$M!E#*b0We03pH4AiCS~0nds1iI5EEj%#ax+K5wfzk
z5IlQkVgii&Wrl@7uTiyMSULuL)wp_
z0l0h4p%=z3{tKik4bh9E%VvOSY%~_j2L=A&I0`dAi?_IMU@hFhXn%oN*R8ga&nc0I
z)W1fCZi*Pht<+w|be9QSe?vAUY2qzEu_4|9gA;?Nb6fN*eHcaH#F_K?QkY%s1}`|1
zp|SB0J|8Z8KElg%QV6J;We8cxHQpaXPZ0Shpr%nqk&9uIqy_`Iv9y_`NmaOn3tncK
z7zH0R0t!>UO1PD|k%whl%N*tu1ie!Uyz~+Ht(cP|s=5_ze>ffal>*2@!Vk7`Q{bDM
zx+fZMO7G7U8}~Gr!L8~L=0cwzhL`m@sd+jy@9=Xh08e_2fs-7N3>fUUaY=9L{-vu|
z`&x_z4t|IJu6KEi6aL(RkFASWRlD=XOY*1yV@Z+u+<3BW+-IW|FQ=w&3Wnjl{6iv`
zB2$JcjJFjDX3_i0cvwg`US^6Gt+{lxhk>?fk{oJ?|7YqNf1zHks-ZD3aDtcfmG*)+Xv8?G|@6%GVAq+^7r|U(MvpUe#*8NMq(o_IuX6Z8RD#K=B}R~
zzouq6w2|6c9cw_#xQGWf3?(98j`WmH@bd%p3XC=~Hrg%`cBtzaVLO`6Pty2le-9Mg
zD8epKvdep`p%w?oM?Q!$YeWwtZgKRSR(}ogjtq%;JP+tuy!UK?Rrd}BS4?jVd*x*g
z60`dOh+eQ)IR58`#zrFZhDe|O9Fj`MoBn>L->}IPmBRYQGE@|H
zFW&-E73p1Z{^j&;>9j&Rg+bexRi$(#RKyVyVgN5(lWAar+W>h$%z@I{XlVolI`N7O?6B=yh
zU^%K!_zU_NB=TA;NoKq2LcKKH2dZ=y${W_!b2eNx%yBYf1N-uhZ==!Nv3%aKA|F}0
zpO^uM(XxqD{;9{<6~2UchWYeAb`oit$d&Oxi@==Gcj_tBw}k(_PZVwkld-zR;ZZE9^I*~S0LTPiC`3*vo@xVn$l^
zbj^e54ot(mCoLQw0p8k#@0!L5s8%Hu@{t}yc?eno1c4(kZlF@xUoa{2HFgM$de*vZ
zFFXu)#)X~W{5AC8die-}q-#&0NP6kfI0p@${ee|8(8v4Zc**F&f>lRr%ux
zn^<98%;!I!sNSF_b%|}H09)D0VRD(pxR`-r3{XVqr>s2rSZ-bu;=j!@eZ^9L-qX7l
z6%F9t3w{y?4z=xv=za$(GkS{)hr@bQdSRTN!OdI7}d|Oup5-Zhd?8dI|Fw
z3Bh7}yn$&R8`O3$<=iUaR&PCcFLh=yCuxPvQF%;yExo}#((njMD0AA{{FaygF&Elv
zp0>;%#eK**L6*gCw54G1bW528ySA+t*L;M5FpzCU6c6vdk=j1myZTZp)w}PiJE=*$
zbNUCc#>@h1=ejtxl5Nzi&%mriZc%gzJ!iP_9{C7^ZDqf#
z9u%CbHQt;!j)z%xG>CAh6{VfhW`okY(@-Wem4!oan-(kueaA-O7J6y3+7kjE
z^qWZJJ~vPxoVf4kRrVe$X4FnGWHL2mHm3-+9BkZWYw;D1Vb9gcF?w+SfN&pc6{;
zAPaQV#?Z+A3NB#-asP4i<8F@O(#fRZRq^Jhz4VuOYYgBMJSnXbe#_%Z24JLblN&t3
zaEEfU07Z=Rdt?;8l$j5GtK~$k0i3lXVx|uoB^!%buy=NwwRjOil>TmFG
zEGQj^mvOd|!_PMzdN}m$R_bQttMCFU`Ct1;qvKvorcQI&
z96Zh%-SBUslU#TS-Ols+s-Rcz+`5K(XQ|h%s;}8Lq;3;=6xs!0=7=t>CG+pzR~I4;
zW@vqac~scZs==8R>}_Li@~K`Hvs8Xhgetnm
z^conf0BIUXVVg7bqm9M_7b+9qCflXP^f1gOg+i5v_3`_5DA#kqVD*P`{gDr2E|oww
z;XZ;~HxRtcc&sHs2Y-_Oc31_UOvJU;wq1;(GwC-6cQMa4Upxp|YA^@;2lPL&D)=o1
zX*b@e0s{bS`pXMkc$w97U&GRGXyS(IcAgb9irBq%lnb75<7!V0ScXiB)KHj%o7Gm)
z9#*0h9h^0sQi5-4_wfN(Yr)~XrK~W#aC|1X2}B9+e^+9BQK~8~y*~-p@}Gz61=G1Q
zy#pi7$CMoW+UNK@AE_IIh5Of56LB`di4OVF^olGyBXq&K7yJ&ult1OK6uiQVw-dNu
zWO(RrJ4w?({W(b~upJh*Qe>)pomgj$D^O*jl;tCM1)2yp>Jn9QrF
zq_y{g=$NqD7lSUIQ0ftgWrRUCpob4`8PMf}`ekJ3-_&!)Qj}ZJvbHce)FUQ3G2}4y
zOsN>*#08?1{v;AWiy{qpa|pZA!4unbaS9ErvdrxmpG3)-2I}0v%*lXKcEr
zf&f}ugeb@d;g0+9t6HThEuHibf72U3b>J+52;F(t#M
zwantTT#_ZVX8!Q_nYigBNUzp#@u@f+s|jTgnKtmur{v2(H`LL&+16G(xJ~FQE^io%
zpzHgwIeO_nSd&!8S}-?}SBfZZwBu}0^KMwv*6@IrIg}@?LSxM@c%V=dSr@$ln
z;#x>f0iHG&f)s0Xuh+-@w^DzqjyL?t%RFc`ztC3urk9>XQDfJTqsy{%soDy)B|8TE
zD#3l^#jP>#i|a_S*nN52->L(}@6ZHF75<5FVwOB7&<`
z$Cq|$w$@cu$JW|zfj*+3b0~~eI4cg;cCaWjTZF;rrWV!(r}8Z}a7NyGpn3Ar
zH)#s94qT0H%*T5qPjfg<%1tVlcVRum?UhEW-}7KoQ`q$Nc5l{(MB&6%u7MdakJ<{$!|l?WrOIpUJKN^
z;7%J6=V(-kHEhRb7uifk1+SFIGmV
zOGOQpxROehk;RNA@&+fCR!~|MZBc678zw?qmB7p(uhY@g+G_1)cf0+x8{z^cYysR@
z>ISa3ZUs8nbJ!dKyr2;0
zv`L{nHB4%%wq`FXZgwx@y;hYRVp*@M4Fb?t%+eLNKbsAGp*MWEDLe2sqA2+m2o%JG
zE9s=*OZ~aib52jRae!|)S3~dYzzI@E^{B4y56@o~vFF@O^*SXr0aE~eiLmy|ZT@h>
zLcn`BOJ-^kKHL5*cO6{NAO2pB(|`=QMTu8OCw5iG`zCf3dhuwcTr)aj@Pq4QRT(;p
z+r=DPW~Vu#Oa$drqK0ty%LUq(P@^ww%}U)44N5Y*=dXK#p1SbYT^#V&ji!jYvHmQq
z(eu}ltX)$vq3xD#0)4udy%pCn1_nP>cpLdII9vH*x=%JM0!(0}eXW#Di;9I*&~}LH
zN|Y`?a`79Q8VGvDM1=GND!q*s?Y!XO+oJ*J-P2fW#)e)(LQ>9w_Y-3=Pi)6sm6`>JyN{nnfztr#%p9P%={^cx-44*(0G3$KD=!=
zRFqS;j5C>2^Y*W7I<@D1vq<<>dDucROrB
z=~o>tsahC}`v8BM1ONk>pe_*kr~to!zxZl#)f%uwoK%epS#{BgA5C3!J9rSR!bK;i
z=ZO+Ev})@l2hIuI8wVYzVBB;4J@?#TweO#W~m9Cs-=Mb#c+DXYPHFUZ?*6Z?cn|vH%3sS1Nu^Ke=QmbIkeQzR7B+
z|E+4NAY*DWzeT^(hPVS^4mj!GYQ#JRrHudW7YtE;Ep;D7EGxy0g38qh&AZ_GqE?~W
zik@j~A7@K|Tbu%t3V;ko8NM-Er>;sY2SDM46RXD-wYXaK`jrGm6k2MAm?L%%mO7Qs
zDu+^jHAtLqIk%fn(Z6LX9z~=1LDBOg*8SVUPg_5m4?XAnZi3X~jNk1$)X38_ez$gd
zDxl|6046zjH3K+u`(jpM=xQtZh)P9vc%7)r;uG`~DO%ukS5g)xYryTkL`7deF{AMP
z>A2oROU%=!N1V{90C2njsRLb(>#v}|q7b4q^f;6@lpe)=sSfzt{QH#Q?-!dj%=x`0
z6uILt)QpQvbe#c)eH*rYER%{(%(3m~B_FyY+ZKH#ldNb2m_i@p)gLF42R4IN?`bY&
zQV%LA-c>FO3_F)D2YEb&YHm-4;pu-eX=n3eB(W2{`ee$M;aB=4oQ
zLB{n)1Fq%sC+Tkj-^wvS5<7g?+Z&8HwLx=xcZln)y6kC5D4Jj;Kf}uU8UoE}I%!+!
zuHCHA4Hbi6KYhhoxWt#ko^VD>K-Mx%EW^|GM=*=?m`PqDTtj5mjZmAa5OD&TDlnxz
zPmfSU5$EoA@DaFk_><@7HO_W*uU!o2jC*b9q#FEd?<>fvl{t7E(fy_IuU*V-0MdrX
zpF8^3<}yR|ufd|rxxz|)k@I+|Dgbkq>8pz^3lNQ7AesZ}j=-0xO*Iaw{&dnL!qSMf
z7NPl0RNxll{t&+NurM(9P1W>k;PV<-b9btjh~GgzwjN;R+-XT_XzYotVpFxYpd01I
z!zMfE%sl5v^Ep4;Cx8xq&n@LeZm9waIQeQD3JOy(Qy9nKe7Y=l)MxOdoiPbff^CAs
zw&$Jktc5|w^=0IuAhIFBYDGYIn)b$g@&vsP0#~qT4}$hC1)r?*2N2--_98~TE0Epd
zqRKayG0H$!{6=P`ZjU^lk(C#cu#F;+-f=4-5x>HzWOo}+AoyN=49
zqil^^L^W*Ck*uJdCYjOzU3s4EJZWSDD*~NE*v5(yb|~x)p}{*>PGtVT^8g?o%N)aK
zbb=n+b8S6sk?oz*qv%QeJ3t0BLAsYNrQZQsX9DfGeHj2#I8(>b<3YUaS~bT7mGKqm
zxjrjXj;I`L{k!Ewk;b{A?6St}WYdnUlmvz%bL6@$<86cJVVrIWV-%7sE*SYOxYd-6
z8wMU=+XER?C$^2CZm5A^RMXzJOB#k8QZfdat?;XZSRL)hy^XeWLgf(|&?Hjq%iQ%~
zk@8IKScq|xF69lv>fb06bEAW{C9b@~cb7As1?|R_cML)$&+3dlIPeSW%L6Yv+LHsY
zC!gJ3-oc*yl+-cxUk)}{&3P5Rf6!!xXpEMTEf;u$Us!j#*Y88vlV3hhpgy_(L#VrA
zO-2%LjIQM#qQq_zL-^alru6m(nvH^L(vcEULcV6N9s(?%J#}eSUQ=jQ-cOJJ#Hy^I
zh+0)Yf-S36+2E1*gtnpYh&c1D%DgD!jFiv~C3`e0kEBVZ2@GtGu@Jfl{hHLNz}WX{
zSK{WAS_7ialL1xnPv{v&LHt?Ju#D#o%dcTWfY>o-2Uw;i-h9UzVDS*&%ZO;0}|H7IofEYw}WAGII7B%HpazBB{n4{kq7q{g!!C8lVj
zwhe9N!90FA1M*S9xsEK&N{!#E0a?8_`%zA8QS))u=JLXvj$=?EVeo8M5pkEd9yL$H
zvzfcF9{U1RLFwN7tJdS2;I=n;Ua^Qd>)G9{3UYOU-X-VSLzmK52Qz!t-#j|(%3d5n8%lpU(eCAE+@}g`wHO0k
z*o!v>btV|Ha%0)UR>+O-4RyhdJv}>WKSdFMjInJ=lwVl^kkJ9^nMB6=9ynG+IY5o~^j6&{jM}
zL`T(DmH)<2d~toiP?YUXT^NcYJ((evVma0;Ga_w-g1|#9#ROWI6v>97ggy6YDn5vU
z=Dxun-)`<~CyJTa50lWWbAa|A(3b{&y3X!-G-TGNb3TTchQ?mRn`=PQ!Yk1Zb@pm1
zzVE|NU#mvY$zF`miNR-egYLmzJVp&3-(Fm=79Z>4*^B!rdh&aZ_M$@#-(I{?Yc~p>
z7<=*2J=lv!(=7WRUdLYSuRX8?zCs3?=j_Fs7@UX4>5s%-yw#u22NJM(`%cKBz_|On
zg0GtK`wU_q1a`hX%$iP3{+uTB&FzKXbYU;P%=|joi=#jTQ6AM^T*M0P(O!I;$~k+n
zoN5?b=lsX)MfH{WZZeR<{rbOVFMeCn#-RE#j|=uD4&5OvVtdRoZ!XS#GiWZ#o_rdx
zQr`x{30DhKH+&qWzDx=8*iHtc41Km3b>iF;tvaAaZ?(E$++r?96H9Umw8K$S9n8fF
z7Dp(**nKc)E_y@C4Q4x-q&B0Ni<|T2;{7|Z3OnjnVlKV~zs{SB+sS<;-pDScyp7k<
zJ{*L7ICWh|`*4EP`QNq=Bka1`lYJNx`!JHSXAAMotpXpPA$4gXCJQaZ
zr!WluiG_FuMbtw49m-Y*3-RDLkYf^ZR5P*ALi`eg!D)|wlelLt@HkcikEhdQM+-5r
z-@j@hEJo3{6~#DewlStV{sM_s&V4s5kcTNXe+5&sBv~Q7SCkY(uB5@iYO@1fM7ut(4KIP@bK8PPrPu-inC_7XF_F^5zh`WG4A5FZmD|<1p
zCE&vujH?B$Ix;mYHGQuJ<38Do<6rAwFK&C!SCtFx#Ze_P1QTQ37khCV7_RmrlLz2k
z7>osaS3$f{vUGy>;g(P7yn7T(Gc*@m8!7Im4J6b
zz>?qJwaM5i&bWmoDWKnxpowoXeiitO$tdTJDgldyktg73Qgp8-G@*eERQs4g3c;kn*AAkDd2eBWQzqMEUu~+xK
z*pEL(V{@1A$Fm=EdHfgW^7zS>8|s#-tyryW!H+Zku9N*Zl!gr6b+#WDgTo!{$ECdb
z;P&IubkdZkhCSGiz0?5m?Z=nY0>ob2=Xm1{)bQ=c>$G;G;K|Y-s2+*pI!G
z5P+AjuBnFY#TzeSa6Ww&OMsD3mz^;TnqUO^z4>_K*nI3O=SThb#~Xj4;FIP}o-jK~W({9pp(!m^vOa8NRLPzT5#^#j*ZN;Bd+X!_s3pMJ~JCWwlbbpsgP)qeWH`Jw%@
z{qz@+8>PN~-F@Rv#6J`OuN)Nd5$~tpPebvd{d~Ni{^R}h;?NjG!1e#P{q((`>R?O%
zVS}gQYbMUe`|0K6jt{+`ez!^aWRJZ#sz2UOkGV-wsO(j#7LAi#KEcB=KI;ASgOK~8
zZ4_|$0&^NYKeI3U>Cbu+k2(qoG{MF}S<8Rpe)?~$@F?)#x}W}JF5s0Z$!+z6x)9&u
z`9@7kRy3lzsf^FM-yMY8Lvp*VfVifU!A>V&+*lr&wilz>e1+{fw6yx4BU?<
zzWR`c>N_MbnE0~#`9F@YTDN>0UrpxnasP|stJ@cMunF%#;e*q6%E$dUzKT9U(4xzH
z+-^jtR6GXqaX*f)lG!R}A)4SU;OVfxYN)umk04%^b9H-pxgSY28?#J;}J(A+1j<2pG%jyH?=N|s>zazeSF+=(9jIX}`gjgS4
zZ1fzmP(+Qt(Q~AmvkwRE#Fw~d`?4DQa?YAg_NCO>gMC@&JZZLgMxDpTaks>l-1*-l
zj*uWPquVGhJm+>j{6n0tQ;k=YFS6B64hV15f6XmZe2vL|ezY3S5<1>H3H*67%z;HS7tF`B8pDw?>_rcGRuR%#RZnuPtXqKzIGt)(mCbdkmz2k_mTFdjcx
z?pmv>9!dEVC|~f=5Ax~$*G$r!RZKs)pgBij61C|5Izs-vX--E_9!b|;
zPXAXF(cQ0jDfs~Mk$=a^zoMcHmIn%534T(y@!=9FSz_J%I7zS8?4TY8sm9zakX{F;_9Oasawfm^o4Z2vdBse;4zx6tER{p
z?><>JqHv*>oM6X=UUK|g4=zJ*xVSF$ns+@L*R)S(Bpl5rf%L)LTW%%p=0)vL4#m5J
z2dUIcZ&3dsLv`LhBRu>8D<$XE`a7fWtNDKdZ@qVwsqDLIlW?8
z)zWO}60|B0lqblHzwI2T0?JRwIWyMm
z<2m@-8(7+Ivol{WxRLM}FV{T?ce1$pXF~_i7AoXXCO078#+bJ1S;vD$UYl||;jqwj
z5*0c2mO&-}B4=&;NH#%6rpezy)RQF9^dQB%X*^af_0di*64moc1susuk_%dZfBi|H
z_wesBNUCZjpi0S^&;b*Gh3lQz-rf5Ce9#O2(A$+{y*$5G24$rd;nU%9JoW9IiHAEf47O|B#)Dh#&50uWH&4INkJGTf9vKx
zJj)PdVTyT{Lp76sVcZFpBehPV2eXqEzooC?C06n!Mlrm*-g$QwoiFF7a4>o(a<9@P
zMQLn|KRk)@H1f@i*^%?1JpL(%x8ykc)NJVbMQHwU?+__T%p>hT`E^+#;aI}En1E@_
zlL+7u9d?1OCGe$7J7DU~48p_IKgxK76)C1ZO_Dtaa)YbY{?N?sAh~`=W6?KA`5cCv
zqM-AR56`{*vaItUMF&Nbp`@JW(Ik%{-+<=?`O{X)dH4~MDvBQ$Qz(ERxy9}8E{4dO
zYQqf`R`LKIRWw=2G>^PQeof~|xr3Fuo<~-qOqO*fP2*zCaUrhjv@=&gSeNH+)~oa<
zuQ^h-^OmIP2}{a`9{!73i2Rh3qo6O3mqDKF9p$C>I|I26>+@+e39hI&cmZk#U^n9z
zAQPu8=DXr5BP?@|_-6dDi_bPk2Ev9?vowm;DD5ef^;lI-sx)`f>w9nFH&O&SdP%DJ
zrUn6k$WtM!vF?@1@B?f47uK>SJ(v?rIZtkmw5>d=#@T9fd4uvT?%jCa<623`RyfQc
zI~}T?CtPb|fNQz6iv2YnF$zT`whIyFSdU!N2__h#WUz7tN0`hz0NvlcmIp5{*ya?i
z)E!WiE_|+`X4wbRi()Fr-H|*Q{mf_e-1oS+hKnoQL52=-#Vdw+Cr`P5FAYtY3PlvpokLpyHmTBb9pTx-sq=OL=bS=cm5X7FYg=q4JrH4nIO0tSF2RZ1|upea)9uFc`1DB8$6n6D9Ia!&DUq;`z
zTlkVFTC)MYYA9}okE%}#Pzrc>4juxjK<@##$hj#9xz9JNdt_>|S*vz`7M!?{V2uVIgmSzsAK%*;*6-ArfpMwj9@*f3cD8e7w6OE6PqXIhLMV`*L
zgiZVAl0MEft{vKHB_p(Bhc{b^q4JPZ_ilr-xZ!WG^LBW6la+c%3C$O|7s04hND7Rq09KL+?~B@fajvhKOc1;F1to}Vrqb-;5O
zuZ%YNg+gvD=eu(3@*y%oR&u<7XS|}fHM{zg%gIPB7V*0~Abt;2)>Tb^9XOx+FzYd?
zDM!DTL%-$F?*c!cy}O8S5X#31QGUuL?Y1|3)0)k{qU@B5t}H>({_Ydx?ly7SoO^{L
zTM|IaJiBuo@6`qEXx6o$l<;5qA)1pM#(TBRGPqMkL-F-N#aB;`LlgdBJnU5RhP@)f
z|2nq|5&n{npg?eY*f8yHyzw-?1)_B@rD|tVYOPhDs@XnqC
z^yI(O?eH0GR`Rci9HG>qMl`If+Uk!q8(ML{P_a<~7Z;u2KLUAaz`aOPo`u5v8cO=Z
z@kK_{AS8+tGAMg)HXPa@CBd
z6|vw0SS&diUe@<&SyqlL=8bzl>EOygI^vNXaTdG70EQ<&9=RKkXG0+wh_k4*+7rS(
z9{w#aT5HSs%2`ftLv!W)>@Pp%ZcWAJ$l}@oQm8`S+L`;7%g5H*!Sa)ThkE~3d;i+r
zzhk_A$IHKw*4j(F-qZ-1O4?Po))|5RRtS?*rFQRu-J
z?ZXv^tD*bX+?oJB%kR53$#j#_ESk+m6oEKz5UQe-4nzJmKCA|Gcg`a>zkWkW6x$>C
zB?>D{vB-Uh{-m{PUK*BS4p^hPPx5MxAV=-N<#id_Uhk
z5X_b?BTiDS2=MM8AW#12k5m_Efnt8~1OFTe!*CJ#rau%6Nqd!okR#WNQ!W+EdUmF~Ltl}COIoymn7^&zTBYv$6{~8_h)p?%g7QsyS
z&H)*-@I7IJvKv6CS}v!_85V9x*n@BupGvc#S$`HxHhjvh2UqsJ3r?t#E}8^Q3L8B+
z*k~^rMF!agY#Z-I+lJqwT!6vF5K`~Cf})-fe;!nz#`sP(9_myhDEog+wQOkHLSc5b
z!Wgn+RHwfO3d!ZL7za)^wESM?jgPTHSZG0s1}?_h??HhIfXar>=TWVPbM#%u!hdIw
z+0b3M={h&`Lm$jIvF3lZC;Z{IRi@Wp;yH82FkJPZ)i7jNq;od(bsiZO_XhmBix%Uz
zxo1!+$1l#`i~sWC$4mnonf<@Pe|aB%p?&aQR^jo+Hu
zr~gC#%lCfrLHw7K$VB^p%73|mL}BGxLH}jr?}Tf8?7#fz{g?mq#}DMc+=huY@DOCIc
z{g*e881=#ZmuHz;|9SuAI2lOLe|aGq7Cy*wREqzQ|MDy723`3t5BcH$HU7)eroH$t
z*WLQD|MLG2|K*Y&3nqWW{>#b1M)&ByJmGsE)PK3_wvIJA`!7!w=J3z`m*qcV-h1?4
zj#lrX`Y-R`QT>;<=)11{m#euKd++|sZs&^sa;0Po&}*UpGKnwM^I!hixK+772lDLH
zVh8`_INNz$?%0TB8s>N><($hYIozOm`0q3ov9_GUa)xUXWz4y8Ni2Qi06TqA|GLb%
zT#z|#j%45^Z-t3Q&Wk!N=Vn6}{9T5(*mjnG>5H~gdk-h&q{rP8b>7JzqGLM^cXMct
zIWdPgGz^cD%^X8H$IjF>+s^8kvpXC58o_&ZTJUbF#NZEMI1SajSdw!jH(YFIE_>EH
zRVQ*`?DC>j%C7)flK_Lpp^CS6|C{(D`VO)3`y
z&C6cP<8^Qg+Fwu~^C`5J&!v)n4E$la
z(QA&Bti97t*EMle;4Jaaa*3{;rc1zSCGVqhEOTQsfW0SjK5O&HUj@=Dz#f8TZC_#(
zbE3}k`GrZ3nzOKzPX1*Yh<{E^}JO>u1Eet@h6Wialm`w9RdPb&w??%LHs~`W)evFJi00cbPzTpbM1q^%LvM?3TAi#(NUyp>8&`Oq$Q%
zXYZW4ApeVe0B1^B-~|g?8u-cg%&79fi_X8DDTUuz6`E`<5o9P@pylmhrCj?5nbd$s
z8hRA^u+t;C&ZK^n9o{*)%r0JOho7lG(3Z^EmN&a)2Oh+%B=0Z0eDb08BhncERohO_
z?7;2hboucR+c}tIn&S3l#9I#I98l7%k0fZ5he!JK?7$~)mI{s1!Z_zCa=v##GZ2Ox
z)|=SfeadNe`g9w>rnbgE$&2Fn*9db+(&ztx5TY|d55sKdOr|BNctj=^_P@Z;z2w4_
zRjtg1z9&uzr#ob1DoFZosyV(??)j!w#T%wgynp`WpUYyJ_^)%4UaZ*ub8mdvfy-bE
z`4zIA?E&!1dKLZ-d^GUwxL)bcmC4k?o9c_XQD{WXg*}VTvz@1zU{!NAlmV3a&II21
z^(kI#A2+3pgf6M+JPBl5;Q+zXvYzQtW#WqoFSo5x^I7k7Kb??NJ3v2XN@m#Mjn-{~
z0M&qQXL0-}!Saxg<)6$BJm3~xGTNh1qkuTw(jByrCzE2Y$?v9|5HEZ_9$9%Gv!;;_ZHb
zWVo(1yervU(6!%XbpqG~ydvk@nUaH}T=Rv>Go{>IRc#p1Alu;#f9NynJdR+l
z@N}L_EBeQdSG
zr|tB~(L|PHk@)~dPH9DuSgCjQ$4;*F%7%XaZAvGGR}{rhWIplA(U}|ODjcljPqmoB
zf_szsVW)=xEdX+rR7wwH^GSS&uFmH&y^paoLv9|OsmW0L{o;5$=D0#@R!W#8j4z;@&v5-;J!khQa1E57GdFXsQ&bnUA)GaRBEKOvUs
z{oPomjGqd_Rn$1ec6P>`Ct|YwrJo|!nbh3hu52@cVLEdb94%A9KoakP5k~fM
z$Noj0+O4BZT9Z@SI!ZkPd3@fd?@noU;4cXb2!4%?WhRxQ6~2$?EZ6N!&W(V$XEeN!
z`Dkj?SwLGh5T6M)9c{Os>2+RP)_SJ)E&%uWuAM%MQg7IqF~!-?lvyY@t$ExD37c)L`h7lgM{_P|0%X;c@A&&1z8@@D
zpXvK;8}S%iekuRYzH42n=h17&-yO&ILHqC6-lz`xYlq)CeTL}@{}B2Mm&Qw>d=%HF
zIU+v-bBv4~XJ@VzLJ}PjY!DrB*h%pzBCYIUV=Kz)d;5}z7Qqfq0iq0fK0lLHMA|G=
zB!+-wr9UUC&f&hQbB^uoCLxS_EmK<94!7*OwmvZ}~RWNy?j`1l!YoD2ucj?lI
zQ&K^_h9&Kfp&#YsFXK(09?MKDkA~liA7`hpgv{RWKIJ4kGme35h~MOQ{fne_oee#3
zgBXcN`|Q?(&#)`YC$GmkFOGSZM%`%N(g;oaEmcLqJsFuw4rDeo&NL={GLNrni^$e1
z^OD-v=SmT{?cZ*SdbY{>yTvv+5yyu#h`p0&D{knG{RCi-Wo&t47V2&}EqKc|%y8Ed3b=_Nd+tbRX35%&Rasd7Kl@dXl5odfuydl5(Mo6k+WUZO;p3fJ|IKF7w
z899S?Y}3x_DKd`Xv}5?wUh99-)PGCrk2Ur0()#aBG4&&m^ZDhGu@UDT+3YJs4XCdb
zaK|!Nvx{hXJSL?B9YsRb)R3b)@j}bBVfWMbxyHvarZ>jQi
zh1l`w?(OsSyP?-V=jioc?myRgQbyE8|LdTnJ@;?q;RJCt{a+&wiy&}M7K&o=ugOC(
z^u-3o06t5kT4HB5ek@G6p$Dtme}P@ONv`7K`wI5Jt{`twbvt;meukg)GyaUf2=q-A
zXEW%&E7r3J6DRZ8B_jl1Yk;uetLPhg9RPqg3deCr;K#CCc6ZB$j?uPJiv+KV!7J5I
z-o-x8qb7th4U775JJb6CK`|=Y;brk-?8^BfYg%^F&P(dn?Jmt+U>CPt6yR~TGr6ol
zW9rC16#u6{lUvbO5^ojjV6&m`NRzY&mN)85GkxX`R~~Vf@Q6lqMkbA0iMie#m$@2z
z%=-&O64}MeMSwbwpQ|vhTw;gYtQm4$PSjZs$wi%aZLFYZeJAAkRqVDs=V!A}OD+Y|&v;bVdk0VMr|iu53o=9^&r@bjp+bm!wKiG`O%tx+pj
z!g}0t&xv*Iw0wc?UyL#eXS0sz*&#BN3WlQd!#{G|se;Bz5(9rlrC|F)2<(ZF>6@(-
ztWl#jj5hDt9|8ksMc1PrD`n*_iX4gMThGZ8#@i1&Wik$`0&k`2bGkmxVgOUwk{wvm
zVSEDcIVf*k;QzSDSdNr{1Q0Yn*Qs0*3pZOc2B^ti8Y4v?5tNx$ZdYQ3J}%ceCszx~
zrN4z%`nEM=E9mVRj2G
z{7&llw6H*b)QIC?8FmofXFZ3v4iWt6C~h$;`E4!HY)I#J{V^YlPjcr&Gry?_jsl12
zAsO<@@$w>&_0N>diiKacW=M=9=DgyQ#$m*!+80hD%J7Pk%2?>I{cn?+9#Og&kfRH+
zTVyalbgz+jO%dEN;z4Pj1=`#D}a0%2hbFK>rC`9Xv+xA6KwwP=A7Ag9rdtZi+g~{aU9`EBIOY_q)oBoozxGoWt=g
z0m->)wAwg0oR^|b^95B~FTxLvlW1@BAfF9AJaJZ@9+p(eB>SrQUR`AR3XCcA3$3Qu
zZs@geJb%?C>T*1nQxiaSC>N7j-}5)KSJzms)xt0
ze=<9;Pq2-iri~qJamlJgBW(PhZJ|UlD
z&0*0Q(I2$6_d%oJg5ckXI{y%+#a$pm@!8N{(4YxHA+evUCnN~Ey@*@u0#@ZB?&7-;
zeyFXl1{*FiO^=~zL590&+>1HN*)Q7YlhUYJ=`VT>M$C+x}>W8t^Z37(dY4ikP-
z*qP{r*@5p6{~>@#XB$t_dAwRd3djiRkj#ZV}!#T5)z@gBb<*bES3-=q_g{+0fs9Xyi?PKG8~=M476bALXo$JuO2;
z!L$xD)3Us2T}-2Ugx9{czfgQVIj}u^f`aYdGYr_WcXn!D=$S>9wN_0~Nm9lBH@%j0
zStpx@CectfG>2w<`SgM3UogJIOtY3ZzKc7L?}N6#aAv{$k2mwjS{4G$BCa~XSMVg3
z9t|gfuYE$0t+FK+Zi!iEwM4@$(4{~|Lrk0MaXi4R1WB?3FVubzY(h=veMZ^`NzS4p
z&NHSP)_~uqXvdT|nSo?O)ArQ==jnfWOtMgW)j7+NM0MdMb=D|`u(JLb@fUZ=>^?2M
z>u8=pV~C+OWj?#?IGyoa>{gj^pWIOXpl>K~4<)jpcYa{-cN}_eMg+0&DM4HTh^TAI
zSJbW$N6|W@qqtVjEwA
z=;L8s{pljKk3a#RBU(h9c)n^74dZ}HHgrzC^hxkDs5byJF>wsvLhg#myjzunQ*YDa
z?N9ptt)Jxdb^Q7L+V9WDNAvcDeH@;E@N(gmFUjI&M*MM*#(S$o0{Qq3mnoE&iOG~@
z<#K*N`#5n@FR%ZEER8YZFMyG!O`GFsGaGtQ#E|mCPVJq%kL?XJ?UiYJx8&Ljjw3f8
z%anco7@g0TP2r@hdN3ZFK97Z`j(DyW4A06+XGZ+mR6ACxH3i!5RQ?`QzQL5=DLgt@
zJ`dk%reMqzTw$2GHy-drbqsL>pCVLQxf~T2Gk|d4iuwvdLO;j_yDj@T@ovqp$E%5x
zU+A(zoBr&kPb(SB#&#Am=y|)&WDRf8|APHtNM5YOAAYp{b9UvUc6b%K#A?Y98HjBj
z#Z<@)`L>&!a~-3F8TIY{n#*qri*Ppd6I
z^?P~#ne(r5lUG4}vp*GxZ$@Kj7{IkSir*F0K7C4E`1SagB;XLkp2f(pl48$7kQ6yJ
z=3GYSqsn7WLpiSiA&MM%1?1@P91Mk7sdL3<;1Vz218V$FcxI`2epxiUHGXa^eHj6m
z`M7G?kT>*v}s
z_lJZ6y{nqtjD`i5Lcw|aqEmdNLwuq`zJ=tjNf6f@9_X2Q8WxswLh#f~W;6Cl7%0w`
zSmvq>`&3pCxb1CcZumZDwY^gRxrm+sR9E>1x^b*{b9^M*=J0!$d|!0;R&kXcPry}`
zS}=G6t}tGGF`AiHBH`7_9d^r(ZZtHx*;`L@3pI#BMv9-37QlA_40QQy#{xdTj8+ox
zCc?SBTl+)CK32lc4qSsajQ$$Xzqc9v`!lShKf<>!K;+Ubc}iNmniUhSHou;`_nJY0
ztnW{Pj*pN)c4qkZAUo_Ip?GFy*_F>;Al>_N!c-Gmzfmy53z(~Pf)T(4E)p)_U^{z^
zV5#192VxcYX)&V3M+8jYiFH4zy*xMH#D)?((avEl>wKfvnWiv)5T4TTvT!N8b%6{$
z-(sG9G@1C1G7i8#fX?(IM-H*%4y(3CD%eG3jhGFNI)gRbCLgkvB
zSWs*ayQpmPiNY{2c?e6ThuoPBeM@9B3-h8vA^=pM{|kI{X+6($0Uj>M!RLD@(p|!5
z^Oaq}=Ta?RO*-3AUqdeCjFJxP58JPk#Rqh?vW!vZeM$8+xX@mPJmY2kv64)yD{SWU
zTkT*8+__`FA`7E2hhxxD^lUbit;xtMvZ3uN7T%+Kx
zdZ?Hqe$$es_Fmv0Gs~3RnH~&|DQ8_KS+`8C*foWieKO=;s*_6GPx^Od;b8E>UTY5a(TQoJY;%&Gx4|_8!-6Oc|9kXb;J>zBWO=G
z%M-NF4W2p=4tKU62-11@*a;pFlJz0*cu3lv{8HDj$l+HGUtgWH2Y8$TK6a+(ziIJK
z^n6@^o{1bl((MNYASC$NR$SjBJY+`vU8Ps`6(alLZRu-ZVyo@&3siebA{0m4mF-?K
z7UyY@jJ3Z#eHS>LIyN
z(+}e&sxV!0e=@_TXG2Nk7f7R8sxev&ewpzTp?1am%Y1g>(cbuXVN+&9b;h@1=5~+&
z?IrzI#kVG5#qS$doS&BHYV9D99e!2@k5||_Yq_j=)gA|bsy}!QMdm>kC2s^lmJKZ+
zV9EsM8OVD9%W9Lahhx^K7hijkXs93^NboIy8g+IfGURq?16}-jU5&4DkK;SZmlOm|
zgbzg1JyFF7yxg4)4KhPp;43I1uMAut%i+aUM|p7lrMgGo#SP)xUj_J3e>I~OKe~qn
z&iq(-0pMFD;3H(T2Z9;wgO9#FzIrMPKU0x*)|7&^*M80TP&7Qeee6hYeBE_?6{*nojXk@Hp(11J|N-wvWP%M3v?Ua%z)7#Iyut^{BGTXAD%}Bz)@WN-7#YxDb
zv_>AaFRRlGh#S@q2+VQA^)y0Oj5mt~{tSNCUuJNUnZb|s$5H+aTE6PdU?Xqx_%Gx4
zq>!!#i*gNfIK@oEpTcN?er^sY7R~_=f`IsQ0T9PzfSr~pIE7=SL>G(jMn9RtRpMaJ
zjCf9eT&&)97Gbv#p)A4)I)xha;q!2)3sZR-rh-RsT%G6dko?tJ27VnXD;vT
zJ>_f2h$xBe4MQc~;*`!QL5ygoLrE!5aKoBFzHP%d1=Im*rC&L%dTabKl75uiTyzOS
zF?~EL0KwT3$>uF;zt`voPmy~oeyACU0z2Ios~iIp26}F}v|tgC{l)_U|4ydl`%;^&
zEPBLgHgqg=&hs}}Eq_hGvh2W#7Y9F+|MXu0k2*&6PvB9Hg!wS=IOMY6gcTm**>T8V
z>q(9t9A|NM;7`8j@yq`bc#N3vPvP+uq{4@R$A0k54*1a-9^=M(@aTj;!}yY~{@;Q>
zeJ=W^@cN7}$qzwKtG^PQu!Yfn_-?!!4xONY`@
z0RH>f-rvXTuu8o4Zpyd!D27QF?WMMo;DbuAALID}aU!ih;tBkF>|+^)*6Ha1q=$_v
zH<}rTUyD@a7{aWWqJLju+#?f)W!FH
zukcdg=7Vxc^;YT<<4GKvlRg2BMbcud2bE3%vK@M?-Y_+mL1|Zr|va=
zbBmyKr}&NJrxnC)rcKpi?a$;f-sC&(Iers4pP;;Vqo+V*`ud@qUW%q-FgoV^v0{*%
z@hlFG8!E`PdodfbuhR3|`pJ;ym9P>G5j#D#%`Sdv|0x5qp|FGyI8Q?A1+e^TesV0f
zG@nCs*`JHX58OC=K~dIDU&rzBS8-BVPFdra32MA;7rzK|EN`VgEu@y(*5_L6>5G>u
zCX@)CUnl*J*oj_49BE^w8R>tyLS^#|wQq8>5NE#Wl_i$pKO;v51Qux~kbuJJi%er->v)64`A0
zoB4+2o(uULKE5J8Q9oX!N0B-^^;kqnK9`FD8b(E@?{1`Q!^{96j>EH`*gnmgStTq0
z9eu!qQU*6u+wGkHYFyV<&F*{i*L7mk*W#^+3hrjWn68y
zo}n90?C|4Oq6#|Ffz}8`r;g&MF1lOB6aEGKKICWWS(McAu2)0V!vgbBJ)O
z+l#mGUwGkF^EeW_$X!CeQs4XDL~|^2)duz@qt45@tZ+QsF;+^_53`{^>-u(A|GeFO
ze4Cmkl84+G*^*1N#vr3kJ3q1Ubdf9jvwy%Z
zr!K5apRasEIC^OJIC5xTkZEQ{9DAND_=VA+YLJInl>AQ|_Z!u5A4$A&dc)xa+)uY|
zeu&x^=y-^?nd@mteV77a9nJUW%@o->%3YOypAIv3A=uj5Pf=R
zjU+BKqxbBzSFNqVakuI%yBD62G25fz`3-Ao$hunfwhHizL5xX>T_fYyTlX)Jn1XY|
zqM}L8Ph?Qu!L^NytjN0m`|>L0EU;VJv0Hi{L?Z9VDb)A_r(K_9C96
z8wLWV)F`3UwQ@BPEcN^g0a~$X+sOE$3#yt6;E@Y`NYdE5o|^)JysiF#_8Ra{o#f#c
z;=`zpkdVsGa=ZXkuY;j1cid5o;dC
zxp-Q>?2X_xX*cG)PE4&$LwVvSGvjTq@7q4p;J3gy{DPI70?hn59O1RF)~%K0$T_#A
zex`@}kmaQrLUE6ji+qCE`q=5emhqeoJqMFuAQxl@eh$}vur_kD#zT1P{+YUd;pX}a
zNy8N1M{|2$_-(p(D^|&3NUQ!#i8P)fzW1o`Rnh|LU-szWa!cvp7ETnIcMsedIyg#C
z7a4n&um${-3_L6Qu|SgGeyoo4?F|PqkwxpZxTowGXPmO3j=N%H<4b6?i37{|gBEuZiUS~<#1EW1^ri6HOiiiTy(;j`^jXkH
z$MhiMnD>a6+SJuSA^Z`K3?OUy&2htkiG#yTvN+v3ib7@r>@Z$(8Xkd9jEW
zTO!th(0@yOV&gZv4{ErG41*FdJ3iKa1RNE?+r52&KmWvAk?O|X;VGxu)-ShBu99p7
zDLcrT{Tbd@TFD3KN=i(7ioYjKdoh4bg7Ha96;W8RCEn=($%_8GuWFveO^SkxlM*{eS~q{;hntWBH&hJJpe~kE$y30tC>qXA
z?i0=QF15o?S~Jd~P+j=_$p=I;u^xQm)ycd{Y%e1p+-Z?3K4jC3+kK1uYk1d>wS5%W
z(V5Ccz=ah(y^IiNSCqpCG6Q#xEG;@aUGh%V(n-#DD#~dKE@CAYP@awbBd4Tdq7R>w
z>HWSy$Ikq*VgOU9;k
z*h*tSr>3Ikq?+zY?S!$I2S)m=mFz{EQOS>Tu>)Qxs`Bk=J6#;zww7xd4Se8*EvO04
z*x@G(dzAXY1|J7wvdF|TnzN04!=}|5jF2|%G=>x^=kx2Mp!q`!2%H+
z5tt}#wAL&t0<1auFn|(ta98pNKhQZrk&%aL{z^i8n-yAGN1
zBNCDJ%j^1x*iSP9G_7X~dw(81IhFxtsQ5nr75~t-S90{((@rcF`izD*8v49P`?rz@
z1I{kTz+UscbNao0RsUtwd2bvmAgbT=-LeYS%)20e=iON5gu_l_E&AuXn7%>R<9%H$
z*5fT*4>a?(zi`KhtcPgDRn4BV-IRF$5Nqa8p}pL~1h9|&MArSu3SkA_3dLCBXlD3A
zxT(<-IT=IN$K&rFeAvRa&A`W7pKtrHi8_53!mhugZ6-DxO8>0ShK5f^oYjd}Pq$Ld
z%rBbQiG_9^y~<#fPQCH6c2|UD?S`~<9N9d!lhkGUF63sgzzpE8Du0>-_=83i3$HNa
zo8_(F8_(AQ4p95WtOg3Xa;vo}J@eh}bD2!z%^?x#
z>jwnfnpaiWl2FkKPJk8Z>OpqqFpzC~=}qj9!~+i9;y8R@u=ihkKc9any{?vBQ;D6W
zHw|QO<>X#5(uik_ZQ2C)Ts#>)AD2paxi#YqeRBZDet1j6L2iHU1;jpCi~_pFO76$6
z#*u^LZ|Sf1aDGM~k&~R{e=sh`FPzngysD*OA$`U&2vh0Uy2WfH+$@4ue$PB!6p^nj
zEqdkM9_(0R>tsgmFygky84umcz+~8&^R}}ibaF4gTQhzwZy#L#r1{V8ejXY_b6NBu
z0Z92VEKa86HoIjV%2jRAIhm3(NUy0ol0?*X<*_4oMy-2SMIXA9qSa?uMRnG_3u49d
z>(F2MKEN&}ohS#PPemSNZjj*iax0~0_XQUWJsw!}qf?b#2k>CcKts2Q{>MT5FU2Z^qs{Q~i}m`~#*@wE+~7DG#31G&)`Kj55$RVNjzTeu>HB
zJXIH7UB6bnV2t5C4uLv@%mNwM`GvC@8k|*dsgl5z8he@_=bHHQvry}M=^g~U>AR(*40kZ0AzaKrT?tcDkW06R}&`@KQ8U
zTSRE0ros-yUT_PD=o=rfdg`3z?lf^R%l`h8z$F8Z#-UtCE;2>&7OmthF+}fm`|wKf
zQNSKcj~|R{CVnUIAIdF@;B4l2Zo?bLxbj>qCT_5LX*rKZ$e%We=fKX`wqN7+)rFt4X0&}9+bOZ2ESfnJmbS!uyOOu|
z9G|5{yPpY511dR|239n(3jum3pp+SM9g-q;B#L$$EDb;Ly$kFdOXJrT7Acy!4wlvi
zO9RGjj8`SZp^-Vl(m06{mL@lb1tzGIJ_f{y$xWr7;sHk@TegIuL5E^p&^u!L#uQC5tY^6PG6I1A@8r?)5ETO1{n_gVh)%$KhSkve_9(W_Vg3g
zpHx4={);+mgaI6?3?ME{XrXYZ2s9aFbK^YJu0kQ%*nUhw58xzM(A(Ynwkp~M*c+m+
zVXY#swyegq$KI5I3Sd&Z5#a8{q7(T1*q=6vSn)}vVuT3{unxb+BPe7Ry0t_#Dd4P&?OxAE1X{!4ZVPh=z*tvHWWF$3)qmX2=p~AI
zw!(eGQrqM2Lxr^{*^#Is!UG5o4M6x{!?z0IeA7U{D?I#JYsSMfJHq()`ey(5qu^x2
zq3)CPpTkF?%xJjXN)D0fH4Ymb-{4l7nZg2kLo5-WR@_6dfP{!TVwwBv?Rn5pV56X*
zFCB6q`V`%AB#OH%KUrj$C(*2ASfO$*A!w8yPnzBO8M)UHB_}nGukOLp0#oSk_U0)E
z2ORq_-W@VHGyXqAaJiK-8i!e>aKVSZtvF}I0i++#$sDH2y8ASRRJ?L*nh0Afbs2=|
z{*d-LCk^jIp1be;N%>RceDtw^19H5uchVr!r=pw>S3h0MdAPzBNrKx-wlYlLX`zo^
zKhl2W>@Ut7`t+i!hXn8`@M!p-c&Aq+7MIxD-b5KCBY#Ks<#&5bc@y%Rczu6fbxSPn
zX3tsh?w|{Ao&WA28)q5s_}Z%`GpSgT9L79wIvlsgI_r(94J^=u#o{$26rH)SVvMA~
z4B~6i7W)sjXcPoy+GcG5zR0lRSepEwi1Uxy%Joyvso@~?>F*iy`ZpkZEc4k%j>Wjf
zlBmJM5wNSRnKR|Pv(@u;ywrByI<>7=yKh6LTD~^(v!X_XNn+Pl>pRy0ok-@^{dr+a
zA~gSPoHl*OZZtaUmeoSpB36Y`2DABCepFBHg$vM{u>;gMJjxMT3O^z55vZ>SNq89-
zRuL!Qmle%>To6;-
zhAJqR){IjrqQ|xD&nFyg?T3p$c*rVTjW`6wsJR5COXr!A2k~ir0yB$v5H{ERdferG
zroGbx=!AYfG#}^+^PCM`d7Q?->5)OwK6ICNVGwV{v2gvj)PK;A?o)724C7=8D-KPz7@gJgG%XzCc`$y6(q$!IWj!HBGad?W
z65qhpsB+PX??n=?;oKN3sF}#(-1rmiX*}&wc_5Y8N-h;BrEA`?xuWTvYIRb-COW@0
z7u9O>=@Dlo07^+d4e>^TUZ@PayIs!?;l5i0WiDy&t?^BXr7iPgX&cS?Y5cS^SapE~&85ZmeIm3}JV(`w8VvB^5q7Fd{=Et3~CN
zUJPB_RQiAn5-U0%&e>|C{b?x2PJhSmv$q#3I8ZQX`a#u05<*E5>w+YJQ+QMVHD%yU>NcRY1i(c9+}2dU|`_{h!H
z?3FB#dmkUkh>AEb)L`tEvn`oJC2+`z!}Ud`V>lP+YCqz;#A}@wVPg?zOI|R`5X`J+
zQAf5-se>B#c#_||5&!0!o$OPN^f3HuoKB}jY^!^d&DU^gNmI&`5X8R(6W-N2*XM@@=`6Y4)0r@*be#P;$J-X`U8pj2N>UupJ
zbE>gsUv60AtdJ${FDHYQd(PODpoJ3n%p*XAXp7skt{4XJ7~U|L$23UfoXqjBOQ$*<
z-54cVIE0^c
zdUI+2o?)Q(GAMXK;$am>MON~=+!yaYh>8vCfLGJjB!1W<9!!
zK2EuPS?hvsG^JJK;wsKUbPv@j^_kVKicSURN%@&=V|ZrY&rt*nRUEAMh8K{X2=>I<
zVz-?(q7$E1M#|O$rLGww%mle3vJnxlv@E+~xgs2CAEby4!!a65cT@bHPqNfva&{EI
z-B_$EDg5yj_Q2ZC%P!AVCTqjSX3%J1ihU@r?4R5YK!3MTv|aOldWV@8LmF
zU#h4{JeDGA5+BJYF^P}L$>E?~obc`9zx#IakPde7S6^3gkzwPOp8$F!&)Lwqhvn^J
z8Aum)u{CoVU^o6JVHu(({Cn)<>H_=tee`zaNHQ)uR{J;;w2y}X9%U*w-w$S~eY{2<
z)INSfK$af+4tLwtyn|;8IV&C%YzsoF8!;^A!--RmQVLzZ+WJ1BJnZA6G1}BV9^=`^
zZP>?4xa=Y^m0Z(}kI=lo>4GOlMNS(JU`J6Awz7RB2O+H+B*rp+yu`UOK$7_E5q!pG
zmzgA5ZnD`+H7(nIO-K7!K8v0$>>*$uS2dt#SM$fSk0)Z8ztRr|I>4-Y%##eW7r&JzL6cIZJt%*kBzkKkxCc#avZ=Lb?*_{$WfWt
z%YOt?1~k|5DF8FyULGVO*({iEC|3efWQ62&Nd;fh7(+Q~)h%|fLb-tbJ$!J$P%bN@
z{mzDRhkpr-RQS`;R9uiZy(6jcff`VKzt$%1~Kv4Jn&sSvd5!h-hgKN*7J
zp4o-)5!uh$X=l2=`0LR1SNM|$se(We(fAB+UnsI<@Ak8_uJ-dUjbb*nZ{B{EZyf2W
z8h%nf@4Njxj^bU|&pIB@ewNnV6QrCEKl?vrKMSWd_Ok^Vd@%d@XMOi*KMP0B@fqKK
zR)C9fFlu`>pQRn_=S#(Y{yl1c&VD|RAHMxOnrHVI+UaaR
zOE!#dsb94Yi+MT)r>V3Q%XtDd#BwfSSf1rvmb0A2R|b_L(T}21&T>8k9_h1YHPCJC
zz_*;mBqBs`&hx4Ytve!bIUhVgR3RI<8Nu+PSI<*ERni*E`4!seXgN=z^uN_|{x(v;
zSk5nEt8}!Se~IMDqrpzkcvj0fl6ak+99YkD4+JH|=R~eqv(utUF@5*1;SiP0zHIdD
zW?54~?KnLlr##d7bozibb*^j*5J0R#Fi
zrr{gVD`-Ov=p{UO2DJEW{C35FmPU;MEg*E?mMWeB{RJ^9bY8}QzCjVO$MOTZG@!po
z!+Cz{`CweZ?VK5WqX@!3(2APN@f?FfPj~`z*%0)GcX;YxXU}C+?p-Wx0Ls${AO#`p
z+sZ$tN6w4D?-J0FgcRIA(Ll}suV5JTJ4oi+?0%I>d1;n^^5sJ&vfGaiC$=AD-Mn7d
zowHMNtejQOlVo{V$vXwz8&5l-&RG%B((@1
zI1SoL-bPDY5Qsng;Q<_L0XRFK|MwpYj)3!y`1bl_O9IW5HBK?>%Z}A
zZPfD#$~Iif1FWAmyH_&$-1>~l
z)@4Q)N6itOz&j=Tw!QSQ8eIh0BCE?HU+d-T+x+qDQeBEtMjA^GoQfyXtjJtl5z%`K
z*JHSuH}mLSBFk|+zay0!zJb$ut1QQ9{5H!W@zh%O6Q*{tw#B6GZQ)<+;lFwPQbE9f
zxGVS&&`V`+L!G3JPUQWWjl-*e|Jj)#Rq`$)NBlC*BbTRAR)m2NQ6Bm#sWPQJ-VPuVSXw=!xk=@<6bKsQ2?FWveru>gTeT6mSr-Wx>
z;a9EX>sTR-SOUVytpK$05r
z2|j=;HUl(se4feDYDq=n<(Gz!u~LumJ4!MWi7&h2eIkuK9oNu9-gK*(6{{Ga>B*89
zZL?-Ivv5D!&TtM$~*p2Rt~=jw_3?Fd(*qbVgE$qiJeDT$tKoZQjIwx
zHoQ5oFS=W!cH^^~6q21bIr@*@{3Y7l1U!536Mn
zl7Bi7ARtg9+ZNG$F-JzM*Z_ZLd(4Bv^rr7t_wcQfAqA{f5SWUzZ0Ogrwru(n)w0c{wJk%&g|=5qdwd#R*wy7j1j3RypkaUZ_9!y?d;4Yp`iEl~Ni`-u})L2>+`A1^`cWWSZoi7CC
z(*dkRxAtXnWLV65mJE7G^M8z?$d!q_CeON~UN34-othz}7|x4u%vv}5*JN;^aGTFu
zBVGcK-PGuciq-zW80Y^3^6ImOo#F>oCy5CfAEs%rXT7x9zh`(X
zffd>xsvUa*BoK-mYUD5F7i;rOS%u2+jZPx-Ak(7s=Pdai;iBc4Px3y%#;~iE4CONz
z6&To6T;*BC5~Aq0(l&n5&1L_ZYvO^S0>Z_V{E2m}Exglh-B4e2BvqT;oBN`6vY}{P
z*yNd~_g=)?$QL+Yp7*7Pp(9*~a0+0ER_W-ObgAQ;`FvCLlb$ICIAs)owQLe*MH>!|_@##QnJS2#)ud8yhn)Vk|p
z$yL*&Ph9iBEs3tGBk9&{J%>twxMz*mx?!exzs;NLyzHKOE-3^udlHs&E(dj>llWX>
z3L%<*PUAC{fn$H2vA!u{;lRx|9Ckm76YrBnbYoDZ9yJEO0B(^erZ7#PbyNtER#L|V
zbqxH0Mg|U?O6~`R{M!4UtQmo#)x2&)V}-`lgkB1dB$lRV`G?gCt!OMO8>_0pOq7
zsO(juMo{xfI*2sawQ}BSdUAbXH<#9b{b6l%{b6lPl{T>cH{G<72N+F&7R+wKfXP4}
zWx}KUiW-oEScJRCfMia=u_+DR*npXhu2YI!c#<)#=PSP8ai+A4&*&4k2#7EWlS2%V
zf2d_#Ty+#*r9GB6aj4g`$!m>fHn(c?HaYLPr(W%23t={oo;wwXjm98>3>*qmcmdZ&
z;}=LDM)30!zU!u7DDX02H~9
zXs`}MXPCZOcoxnK8~wIOPDCS>jf`xF(3X-0&;!T_`C<|f0gT!jS-18<5eLd02WTmf
z1ypJDtBbBMzbQ%)S;wLK9mp3>mdPYwrGvZ>&wl`K>3tUnm(Sjc5#5_P+Q?odY{c!b
z5rlkXj1xAZN!SQ)<{0X<;slDkoD2gGu~cbkBK?~H{{Sv)p*!i2!VkWv5~)F>g|d(h
zgb+`yUu&J6)yh)8~euQhYM-@OM!
z(}K$W1=nbw#Rx5L@1fR>7lY*>HRv71>-l4;R64RKCZfhvD&=IM>A3WC!CSVsXFuS7
zjht2s2Eq*y>j4h3?QQKqG6~V@x5f~6QU^anE~HnP@{-fJfL9>X)=^*8?y~}^`|KC#
zgg&v_S&D~!aH!`Jem%6REgk>kTeR6fWsK(LWT92O1ugQ_L5kG!EU%skSfm4zggVb8
ztA?bz;vR4D_{Ag6DWWAra+t*a;7?^M1L=)2uwPy$y>Zhe+t|y^RXR&qd?Kf@2vOF{
z^psqNVmOe`$!JcGg#i|U!I}hlXemhax?2=y@Bt{n9L;+ggp)15q+K>d;py+ABqFm9
zmZgBwMQxcSWi%xlZ;-!gEg@?pc}4{*>JKEt?(sz=ea)Vu|$Vl{;i@!72Jr219PIl+lTg
z9x`#^XFjNAqT#{$`e@RO!K#TXohHhq3Fm!(uS98}n>0|UMP5!W{9Im6(W^ecK*YOI
z`mEJ(P%}GAd5_*3C*|Fyq`Z8JykYf2)tZ?P#O!tIuBD)dZaq3vR?rthvdtYb
zCND(BZx27nl0(i%KtGcwW?Z4x*9-6nilvr=vB92~tCZ4h+bLkrYzKRmbQA2kwM~Q3
z`AErL2$TybtLOU!kdjryZ6h#0u6H&U8C=4C~HC=w!6n6ZX-^B7WfdB)tg`wFuA@~&T>s&*sAuJpC^^u
z&jKSvr>{TQDJ_gV0LO
zpc*{{-*eQA#rvhhX-)W@uv|+L0r)nc3Fg1WbvR>Z3zDn31LjiA&wY@6`%-@NmQ^sn
zckYxReKblh|2#UIQf*@ZqeqXidDwpZSm4o4(4Vh!tqeu@?9*9
zZDZ3g>$X#ddbUJ)@%c}K#}P}=YT4c9T_u|kd|hZcHHs5?hYLF#<5#F6bj4dkid5q#+6QWgIy!KN)?gZRWi$^d1lj^)qlw70M{X!=a&)wAT)UpTKG
zP7sJ$PSfW*^{uSzia$H`jjH}v)Pp%fS4u9UO_IuO`C2AzWs(xmCHx;U+$*!F-BU23
zsQuo8o<>>PqLg%3QBKbp+MK;iW<;7V+-Pr?JF^D1yK#2_J~9+wjTylmCu}bl;f${m
z#qhI(j}-C|rbtcKr?Trwq;ne&*|ppWb#~jo6`T{L=Xs#@pw%F`q55RgKoUj9k>OX|wG
zel70$t+;D3KFB|@2#D1{EBP7hm}3zjUh+Ta|G$(czpMX$iQHl8_
zjg&fRC*_Vh$q+$6w3?18D5ll?yEGBiYW|TM;1ShodU^>MM63BxhETYeR&(k!bdF53
zc(!`sto|?RGZz8=IDObld_8Vp44~j5r}Jyjqs8gMLXY!e9Kpa3m*gG@Hd@KqqNp%8
z1z@U4Nvh2|A}T0t;mvLq%FPMv;RfRPJMIZpmPv=-5YYj`D{_S;n7|@Fmd}
z_PN4ueul?~HuFwpAt~l-Vj*FzM=d1#DI!3`_rGBxc`?pJB2=S9_(`8KkqlNQ5^vN*
zB4Ip;jDGs)4EGm|n^}pONXWYVeI}AiVkQ!QXA_C%5M;WuiR6-~iDWL=qq>z&1DUlj7|dH^2w`tv51@)N2t_#s7{tDz?AO
zN5qbi6-O8%{3H+laQnqu0JXz@Av=@UFV@0~G07#|3hX2Hi+*TzBa<%ni*9WC%5LD8
zA}d&I+RLf9kD^hdO20aUbv%a^M0wq2&p
zeuXRFtoGLhY7xW4PUwv2N4D^ns=*+-HqVkpeKOmGktX5s=r*6HB^D53u~wq!v$9Vp
z6M9Uka?Ns-Didfh&ORaj4e|DgC*i-8eL|EO_CcwQ*eBE%PHLan^*#2950=3-iyeiY
z{c!sPS={QCiK6~*l7w3;@q=cL9(ygMI^Hyq`aPzJCxvJ$>%_l#i}&4A&+%C!IjOj-
zaUuijtU^KTBO;>B75qwkhjFOE&%n|@vo3|U(f$eb25>iq!OTH0tryZkvnRZzw=nC&)_%YK&6Q}<=Rc57o}5?
zd}K-@-Wr3yxrxs=4~^I-Hi->lLexINzKsHXs$cf)h<##`vQLbq$Zy_5T3zMhE^shE
zP}JKtlqC|nZnzzN$7U1+9pY5*5bm*u9uBrn^rkkXw$IwR9Y7UU!9jPQ;ido9b&tN)
zNkZ>}e-LNCJMjv#jiXP%jN{}_SFQN0pQRKe@tY_d^wEd9xnk^e3pa|Lro*p7k77_=
z1Ys8GCG@Aregkyu-hh|QMxYqAr<4eyER8C4BxuwTlSR!G}~ccIfqph&F9k>
z3F?4WybU2$bR36bRu&bmWhH;JixG*H1q~NgmXz_BS<>%}3JsW9TI>qZq_JUqXYZUZ
zIrU`WzIwj1aHswZT7!I9#E9h|@=tVo(G`~J6;k|N+v7;KJ=Agce-Smd44}V)X{Emq
z(h=>riV*Ii8QRIJ(Sj1ME1alOxI4y{RMu_O*b-Z*^Pl3un7u`2CTedvS8zLOZ;7nK
ztJqR8wmiK`j4iAwShXK!Y}v)kD`8f$ZX?TWBjFlpW{w6@zpxwVLCo0F?6dCZY-w$_*jg_8LADmh@8Un1TNb}7>XnsIbIS%mjW$*7A@_hn(r4*#KRPUO
zhgI&-J7sP;q!^&-=;1^xSOfkEM^o}96iSH(zo8^zZfRD^x~REjIV(ljiFbuvim(&&
z1F&++;;l@xzK>ZgIf7Ctx<(lW6*+Mwj;_E1UfjKIX^hB3z{y
zT@*hVF}k4X?_zX0H*RIdUH%~Z%Wq}nSZR|ED;4daZ*@^r*LGgUp^lc(dzH1-#<@%ha@nZ~R&GHo%Nz)S!TB~2w7Q;7|RdU2;c
z4XP#lA@&y+DAr|*5&O$tWq;WfZ-3dNu)nkYMR+=CP{o49*>hqz#RF1m5O|+gu)=JU(oR;G7~rE;uQVaKkuA2w#f^i__KWDsK}lIk_GWNd
zjFp;hJtHeg7S7Xv0D)QhD}vxCy9YX1nV+SRwT53jeNl@|6Fbc_vKVm;)UBt^bQ+lv
zP%H0hmVuHbej-q{($0BJA>Hyrpi#sSleJfnZp~*J(Clhpxd2tUeGNZo7Zh8Zms;zo
z54K&U&FjNvFFIXW-?u`Y9Ma8;A?k+nKe0Iz{a}-xlda8pS}L@c
ztF&MlSK=(7o}a-DJFq*4gHs*@6gk;5*XCS4bGtoGp6_bnsoEoi82io+E%YM*s_Z-G
zaG|)sKPk|o`epa^f%r=G`vSH0wcJJd6UW}u?K8F8{XD7OPJ;?`vG?4H5*c|d&fcR_
zVy{Gv-w7nj=;J`)S*1eXi!sSzsc=7O+-J9QAkTj3E(a8DrHLcs)CV9qoM^brvj}C&{wj){jOus_~sQgx8*i-8?pH;
z=Q^CR5BFWizB5OtqNrxFR~5dkmV>s`9;|ST*6dekNbwnhd}1L&2(4wWvLE4xfP{#t
z=RGk0Kbd+`yO?@nvdw%iZ*{Wv{1~Q4&CfV$l(0O83;SP8QgnX0?COpS#qSl4Vek0^
z7vHt_{7#T12HD7Hwa~*-Y^9y;0BIStGivp@e2)NW^;Qk?_oR?NOswxn(_L&p!X;H6
z5*yGKXtL`0wPF|%8_+I$7nh2{x&E3QlRr*o|JjZmp(}lhxBs+&5kjJb3@Q7ML!xfd
z<46=dH2SR^DN?a8E?3)3QF7hmvd?u4fT!$J$k522s2OO4LWa+`C^OK7PW?MlA29=6
zqUx)tM_KH)57d(b+$i?;`D
z5lfiZgVu8q&e&+Hukn#G`G~Um{GNB9v?XP%RQo)3KV<^i0*)vXkY8!AA5#>&r9;uu
zhpAJYP80wvrg8oOE}_%?n*6DCqCXg=to8PbLl1__^*beFk(F~MX9jrI%b5XaqDB)}!R%zShqN
zdn+oy(M6o?$w7~j*Q+=FG6i_hOi6K0_?7r`^(e`LRYYdlZeSu08bSPVTm@GXzEr?j
zI3)B!Si%xq9eqO*(UA=kru9GLOoSqnlnzUi*Pm%RUM6bT94R{G{|RMO)}9?QY*p73Z(DOgkS!
zhGRrqnl@(#{5#=kT~U_&f)F
z*(;|!5Fnw+W&Z5yf=hf>L5Ax_0VST~%)<1@EYS3taK@t>oJmWO$;yy@1r9kEAUkJl0?Ji$?wYfY3*Q88=bn`QgJbGs|oKhl{*jyYRFP7M7QG35cYvX;|
z!>h=?o2fEiO03Ufp5t7eQ8&_E6F)CR!`CR1e{%g+bKplzLDs67mhnbBYhW^+2MLzgOZW=Wk>k=J>SGRJP$D
z8Q}99m^;5V5tk&jJ4RtAXMO_ZLw}=!WlP#{N6wxuy*MVM$mERnD-TM`2;hSn
zg2$5#;(Jk|)fw&&?JB-r-dY8rW~5C5BD|7cP@CeTY;+Z?WN_AXSL~Fv{!t^`FLa|r
zYbNRGKNF2`u|KSx_(5QsR7)|bRk}q88W4^%BB@Cx
z1dUSV+}s{V>ePA)XWVj1x~nW*wkC;u6%tLtcY!41z)4tjs?JD7?aUb!a@socBnSEk
zct^{e=c+lE+<4**rHHFa@2c7dMq0_Md>%u$iouyLkv0ms#2VHBHl@neW+hjwLusQZ
zIGAOq8TGq41NOGezJhD)SsTL{-yW7>QY5{x1}7B#l!$@eG_TO-3NC`j3HWH?8z{B4
zk^$<1qZ~frB4D;EH}&5zH&Obe1}KU~r5BPRcT9nOHn)*^Q1Qzm0x7I2nx2ROJ5y#C1OQuu>uWg$Y
z4h9&B^tD9jivSrEe2j&lQ1C6-5-0v@Br_JV!yLy2Gui!nwnUR-hY)u1>Tt@L$jK#5
zqfI*C*+hJ_jq$_zj`VsEtV$m!ysVFO`(?Vod1DK^L9>K9j@vO>1nWg4?iSA23Ig(`qA35vSDX&Mtw8N{#xTjSCb{ET2RZ?rsukiR
z1VnuAHKA%=kS
zG`w${QcIP124R70>5GN9@nkVi3dP5%Q`R7RA&0H8E#(T1Ge|+`zD?)B(h8L5)hHQF
zUq9hqp0+^^O^MVf+)~}g_qm%)=nEgQC}ghe!wN$bS{Y7v@1Uey(I~H^ytw5PCLq+J
zXp%rn2%B-9n3vGg<
zwO{S%hrCK(A}{_CDj0jd`Q>oN3o`YlglyQ$Zba5FYvpn?myvPUM`4{i*g-k}&1}cl
z(cH*Me7DXzA*uDX+54CPuXvW=czf596qmm2XJ;*1-)x9|?^g-ppjrHew7G~pCV52M
zbBg69$0f;YcC{A#t<0W0B3Y_)cxl6aq^<)}96%#TUdLNFR9M-dcUjbUa0
z29p8!O-yW%kUr0+WZ0irc|oZ8X6i1odbu8~9P3$Sc?WPVozL?%AG^VN=n@POgh$*j
zWQQ*XALPPsO`wN+wcyXWv6I!%bLmjM7JNjWqgs6Ng1?mN-8TqiSYJeGIP~^N{-dL?
z&2@a*%ZI(5Dsv6uzm@Fgs26tw?(yzwFOI83vKpQPl2kame)5eBU*x~Zd;q5ZNojl0
z>Eq3GOV0`(NqzJzHx94Kr_ch@8p2XK&L=6QcP89@Pic33jDAne2=~C)dBoNvS~)bO
z!X8dD_D`ez)I0dM;MddGV0#Dwy-&8E7FLq^X~fZfP91mtvhIF4&mBwj1fb6S_;i2S
z)hf92Vzr>;5|rZDgYj$-as)ux^}VHJ2yBL|o5%ybd4O`o&DBf2VYJ>4+rZpyKrWOU
z)DOfmq`DIKB}i?b76Mrh{ziDTih&Uh%((2A=ml{nMffcd#p?iz%M`LR6F
zSDxsv6+gohVgUHi&*?qEMi?o!twg_kWQ?@?khCDA9LMB9Dlz$WqOCGgIUsL(=4cY5
z)nEZwolD4ts9(}0ew1{iLW%rmaBn0QWab*djjljyd%#@ByVZfz&v>PQ%MbXw)$iWm
z@421P8HBrYDxGqYX;)S;GTX`l0rWY$&Uf~9Em*?ZA={~!)!oDB$vMhfgU4rTv)>1(
zvyK<>tCdJVplMt86cKX4`fc5evpq^H?UmY=s$A@eS{|%b-nRkmO>(2}@-^BmALItK
zyej^GB%y!1I6T{*y3XkpNjgZYq7|=~MmNjJdm9by&3Y^;yhStB{NDidQoj@pp1C%5
zB4ZWCWr?r4&oHkv%*Vlr8^I(b#^B0notPzOzcKA)()&T|`!)3JYfm$3wA_|e(z7qk
z&3-M9!%o*R4rbUdLs4Hp;nVV3{HeSBsr%_Sy6tGETgdUQ6<@3%!9D}p$Z#2}G-+;*
z40jzssb&{x+~G7=&tO#G4Q*EXQ`ZDizm}Pf9x^FIvin0Gkhdh--=3m&ed#wS#*1Jc
zsb|z|`pmp>d&{vmAs^_QzpJY3645RmP6-hmD
zrCd7o>Occ4ZTjz$T}vO~U6}v+&x9$yE<_RMy`s)w`y3%bbt@GWPuG-+lfzdH#w{?cW@Ge&>nrw14=wJTLwwwBNW*^(Q;_{M((LkDc<^
zdn>d+c)`+syto-MM+o(|Y}-xRlh;tPb%35N+xJ#`+vchI)&Ymr-S&gqI3j2S_3YVa
z@L!AUo7*-y`$Nre
zaC#b^?zSISxLG9kIv&}9{9V56W7@o_0wMDZy2isdMjn>V#&im~imh59ESJQ2xNO-u
zBYZRczkvS3rPTxCiW;aPNakfa!x=xXVNN=pTU(y&vd<9ADL1lh+47PGsg3x#;h11#
zOe(jF$Y-1PIUv@a{HH9U(7XIPAcACFBod7fR>QMj=&GE!6Ficj&7Vi#;C|+P#$UzH
zCo?pqUwM~{$av?c(*qF@Zl-L-fGp{+oX_|~ypM{w1*jLVRV^S)NpdvdI6S0D+R2$S
z>K4U<0FBQn2zLTnk(83WrSMkiN=XBEBdoDW0(O7)SK3?@X3~w2IHT3%xw1(6AINW#
zt=X`qB~;KaS52;aAZF}vM&4!^Hfl&y-rpWe|D$8^(g>Gp9$nf22|Oq#QzG+F(NS8cKw7esckEkLHT(~t#{|S^
zmO*+#m4)jfBe9q9nD}#88QbQ89of#|hfcza*F~LerPZklPTdpsulQ*SYhB|m&B_Ay
zNy=NF_i3MqQrf?p_M8708xQS18P{&2@(jJjX}6$LyVp^;WYVPqOaK$COdM|-$L%Xr
z_rPl_?Z{Szy{Gf1;sUT6?48YZIOC-cVB1gRcJl0x!c+2ZhodSnZyBtFQgXt!S(4uSx*Uz3|CYeKGti*5}`>oPF18{%dbEDn9AL$`{+8ga|-}+{Sq8nLON=VqG!=Q2&vH$E%lb;R}EM2mkDms54
z&+3r_Q=u=%(2plew1-|esBet-qurDUqOZwv(LwJG+4?!-d4rs&K`>i&RMQfdUx{9O=KKG}-)?I$H85T#55cX?t*!XeU?qFq>vA$U^
z)!lj7A58uoUt>zXhW|R?TO92p-+YZW5Le|x<(_VTdT
z`jtE2J`r4%;LBgN6m)bU4d;b+J(i-k{(I>FfoA?kdQG=+`cgpy$5C0(q7;r1iKot3
z5k(B&vgnX}RY!&z%c6aZb5AHoQ|jXg42CL^wG9;(l?!SCT@zU>MS9OaBO1-K9U
z+%*a^U-%fHBx`R4!YyuN{eGRZue6e@A$laZ!(Y}oyKVCCmB6iMS9`T#^}{T0hRYfi
zZtfq~jgwyrU16}C#(Dqv@uc3}U3KCDqw2_oo`d9LG1qb?j+>O6-{AJXhn!}BQ!njt
zjh_8!;hIj2VG&?rv5s)pbRY0O=!tG$enr~Y5#d)}6y1v2e~cATm~~(xLzOdXI^*H@
zApu}&jUWLpIw`s%m>|4#)o#{ajlu-O-2yr*Ot6nb2+H-P(l>j9B0JDc&c7r&yYLR;
z{SxWFwy+*bRB591aJNItlsJevkh92U=0Gg7*H1y4lJ+VOC`$K$6fW~UJbvQC6AKmKCJiOuPOVSU`K(A&*!bqi6;ZW}G
zag8bXb?`@uH~N;rX#MN7+tLyTiKaw&ByHeo?Mca>rwvTI{mO2xsXx*#Pn*DnR(w9C
z-{pXm9@a{Ghx8TWwHcKiyicg|v6(V04%XR`$qAw9<=X3rlW+w$GE1pG?)JL~?VYg(9zm2m0#O%mE
z{r@d~=l1&l|MEL~LtXiuiXn>M*`z9>{LbGf{NLhto{wwS;djP6?Ur=(GYx{jZ!Lx2Ii1&Ky?5py`px=(0GLIkojca6^}i&3{U`4Tvi{GFt^Xz=#l4{E_;dX8YPJ5;
zT=w9&^$$290IL-N_&^bWQ3rqo;mJgH01s@LWNvjN9icL^_&?#VTKtl)R4xA38C`Vo
zpDBwUYlaA>ofd!j{|oE=IflT;e~^4Ljy!`Wm2YmN5s`0*XZ(TkjpR3pjo<0Q|B-xi
zpCjLVDDq9q$>f{kBxvj`-_#FQ>%B=;MA!Q=3QxA)?{nmv2friVydKxCv)-pU?LO71
z-FynacfFszPT}iP{zTXNU)Ku0RxV_{XYzUnoBl(u@OQy@=g2?kv2Hg%zSU4kO#6dr
z_y7!!_yD|{*_#60+)%Q*phup0Kr&C1j$%nk&cD9!+G^eV&E4U5GeuD&HdW`U=>c5S
zM&CuKe3q*qTbQc8Vt~YrX0B=zV`~rf5iKNVN)WLppN?Z&oOQqTjm-Nf7mHB(*6C
RZ?JyjwjSX4vpw3#{VN!r%j^EOb&IYU=;_7OGV}5kcq-$r
z{S~mBd7+#=LMF}pnY{;vIe|D=d$BfHn;6G^m%EQglBDGC6)VPE=^LtyKt3m_wQF-f
z=GJfSlt715^qQp10g?pB?JYgUpeI6S`T(+;VeWz4C&(nuQ)lN2V^PPegIbp4&;!4f
zF>EI0I0cO6p>f}jzf^P-O9;6N$$_I|&^W#HPV~B*zqwPAp!MT~*L!G`RHveEY1|WR
z*B)I5LsdINA@bio29XajZUpsh9||J3z9WRUh#nBCvA6I>nU_$zjL=FebY3cumx`R1
zUQ;hs^HK-8iyvN=u*tzMScrD|poo1(Tw<0)rdNMIp)wrqm}H%Nde$!i{Y_R6ml`vO
zBXLqBHH;%`%lU~sUj@|zsQziZZi6DP~_?x
zkvi;UA`_J}r=|VabM_4UF1Jm
zEr_u1Ur~J{q1<)Oe96Hz%z*CsSa}85KrFgkjp%Z0fyj_d~LSm{hoD1mL11cu_!8J>8S&^XB}~jpwlP?M|}AAm@mDh_H+?xfHj;TKgMkDR|WievGMw-+G%r
z6%(8lyt`Ir+x3*)PU5!giUqp*(NS9Yn7!a7>Nqf31h)~f!yu$J}ZUTx_>)Zat2i%Ge9X|CJ;
z816>#s7ry0%PwX3ikFt`cP{%eZoOzY$VY3KXOR`L4f|_%e%kP6^t$miX$!WcXvNop
z`dnkY%rn>M!K#!S%w9e9?5fEJ?7md7-0mh*A`>vEjtOXWCSY8ROu)>4FacItDHYWB
zl=?QOK2O!(EA{3kMfPMlK$hoSN1Jv!J(pQjYoL8sSq4%+|1Ujz9B&)P4eHth)OA+9Wj`9x`)3*tC1@}poo+WV(il#6A{
zMCHa2yI#%MVGRpQzKuD50$kz3-q@C{!k6T{+p@yaaAA6$xdZ)I(-$OsEPCQCm;N*T
zu7W{ES>8)V+3l|xWr4al4#a~6z_7+`x?9Zg`p@-y?}^&uxBd!sOJ4cbC(6aWwRn}#
zh6*9e!fnvX0;qdGxcoKHc#R`djjEk69OCpvE@|O6LJ7RGbZ9OImZYI2)R(@mQr(Oz
z;)oBVB}r`06}BQ3ah3g1ZC>?2hN){KKf*V`EUbajhknWsYeUoJv;12uyoz3N8oz!k
z`PHe+Ua(R#Oq9sg#zijisrKNzxbuL48*c{wp2RKi$lOfatGLMirm&f#+POA7pKwZ8
z0f*E3d$qwogeLF>pZS$(P2vLlSPoaOuKi`IPWI(udMx0E(L%u(2GUrrA}^dz{K8#7
zb6(L2OCTZf+-e9cV<;KQd(05Nmv{sIO8g9QtdMnIQZG0stcWCM@#TL*SV+MITE*?v
z0jt+F>Ug}5cp{E?iN2%kiBj1YJ$PUo(B|erfc*LI353x8itqK@E2M}`r}$=o$Gn${
zzAV_vCycUtN_`x;&OV_PH}!|tcOO=G^F*ogg6<73P^O?As+`fwnWu+%&zYxTG)Jh>
zCO}C)fP{2K8CAXJPN32BCjwpdyYIFaI7G072RRR8mK)w|{dKAfp-*W~?}Q+53#ec7YIM&>Uh@?hydX=J
zwAl$oW)vdHZj$cA@*QJndP}iO11Yw@xC9|W?VlB5KkPUS!eKtj#uafO1PMNb|EPih
zFz^1d_eTq~&CTAjR|Ib$Oy06Lr^!{>3-|HI&)k%~H%bbEZEXHNh(=BKfll(?9BvHH
zT8@1s5uCyvW`NY!L-B0yj&Dsh{<(hxM;u%-FcC0FaKldIMc_UtY=-0`;f&uwq?m=W
zrv+zOjb-miZY5eGU?Z%8E8M!fMz;uDx!KXM$afMG|*XIg?DD~M#~gJ+>ADpLh&*%{!Z
zQ*T&LR4ZNxbvX7jJdBH;sEIsE1_E%F?ILH28pk;@j$&sVXR2{zF^;JIwCIWIflL<>
zXFx#3dEFqOh%9R518J%mW0u4_-;7|B!WWV&q1y-YGLtIpwn8Yw{LpJE3=81l<8Ff7
z6^tl*&!JWSvsT=pYZ*|%l_DzPhA7^B->lbUy_MX+RQs%%m~(b0nz3n0MI1pHUmitb
z2X!Ne9K~@5i|taN8y%lv^|{8Ejl<3d6xuImM%Ry}YhLTur*#l(V*%Kb2)3xq;!KW1
z4-}t`uel`0bRQ09WG>T$suV}@#k6GXYQDSS3J#G*|I#x;ubHLmau=J`e|hp4#Sz>o~0_^QZge|lg4^|N4!a`vzs#m@*Lk+wF
zvB|jnJ^VKD8m7N?88GAeT;6D2)IneW%T=8I1&>JLRlb2CI({pAwP-=eBG*UhMhw#Z
zivq@MME`QCZf+toM`=F@g&!CGz7gFEmROXgt>iVp@w6$C$S0+AA^8FK1y_Hs>cu#z
z>P7ZfQMjlkQMthQ_|@7c_q&giw~7aHH{Q@@RO1G|7}OE$aj5`O#TVgw>O(0)rg!pC
z2uB2&BtH~tl3IP%ZYM%rovB0;waTSrML{96PoiN-jbaZbgX8k5sz0_
z*%*^BZa$tT%&I}pu0a+nw8c~C|hc-6QVlvOh>)amOrxx
z>Xo*rdPR31SJVKn4Z=m5w7HvP8F{!pf|*U5yP8{kI#luqM|YX$E=@74X?#rR5k$bsQm=*jhk2E)oC;qFl@IhAMqcC2K`F2)c
zRQ>a}B{Jp@{v=~|acGhCEF2jIb{oI^7=4zsruYkrKBb;fmUn0*#1(W$oIYhY)#O(~
z-v9(0n25?DXrHRI4r|pGDeg3b8kPy11U;3Kuu(G)GDiCj>Xbgl0v4=}`LFQTbEqK4
zSS(VJ{PX8m2isA`NS=?DYIHHnxPbHSfhwk@8cj?M_Xy4%@RFmmmT@;O+p^eM8AJEYdAX5}iX0kfk+nfa6`K9-)|4XaN~>kyOe-=;h!+rP&R
zTGWdkJTcZhXiZky7A5Du5qV0<`Tyj`)8?+!JSCY$Oo=rAcgk3rQdAx(dQH7klKE1X
zd)aQ}m1uosm;3rI_dB}WABew?i2LMC%ZZBiIa$`^6QU>y9yta7Az8|Cx)Dj_EBK#w
z-UAByzhM$8ob1cjtz9V4Z~CKz1t{Pty@*;#^mkg%u6mJ2DT%@EvB-^r*YwDZg4axS
z(*djKeH2j9`5IMjtP9L%yQXmJ8
zbVs|6Q;0_F391m$gLu}u4+VFUzZvyM4a=8nl5v`cf;A{Vl6q!un0(0o2ju|y-U$lG
z8PJTV?qlM60_5NetSBpOE;1)e;9Jl>s{8P%`h4n{gig8-Nx5xj(Mz+zQGL{U&vG;$
zxzxZ{zp1&*hVhh&-b3=|>gHy(bLpP-wob+Z?!{K1DDRRiz(s{v4eV?xJ68YqUkQJu
z-vMb8BQFXPhjmcqo4z31e>2~lEwo0=H;R9Nhf@5*ehy~vX7*@m+!o;{J&i)_+oZRN|byYn9p&WLsMAaxTCecAJV|Tgy7go<^hLu_!KM;@KvyU
zD&!@~Ipn`BtKf;}Wfx_>1d=6-=%YlGyu;r?ElSh{)Q750BzO+!aDkR2mDS%b2G^|~
zr(1eBwZ2~+`Pooqcn)GQY24GeQ+pYMsgmy+cet70D!aEz@eZ$$0^)(S_=Qzv4Yzt_
zdCgY1!EpGPJwj-r>W465!Ow+Hxb-afggAZ0Z6t6KH>hhVk6}`9q3{c9u!l4hPG_Ja
z#;SqNV+lvuh2Q*32Kv-^`4aRR-F+z;@e8h?sBj{;30a^H)|!Bufb_bKu`w*4
zdmmb!fSf(rgYg5?--0P1&rjY3rV%dT;pXr9Qgb
zsru+{x5%3`biApvOtVURGIRDECSA!_Y3E^j1g<*)Z*2enhrqSz8MY?1^UqN0;*sPT
z9Pr_8(3b#37p~zk7(GgP3`UPdZk+u;a^vj(>LzagkKC6>MldsS|5BIxC`6+5m0jwi
z5Q*0B=u#hrh^mi5M9d%f`6|1T-NXPvu_gB@P;6wWMtA8C-V{)5ds^+%yZ@=`7fF4@
zLh-Vyf1i5YiJeFGnm1AihvbP5XOtnS%Suz!O3V*tja{r1I7Rf5^IN0N-^kpexWhS`
z5EzbmlW4QPNZ?5k37lA4w2Fws6O=eSL4y4_qUkn5aD^PbdphJOV$+3bMkvN0K$sWF
zj71$^wP!H8cBJfRX0{nTA0jmDscK2+F-lG$*ZZ!~LgQ7r78=gt7rl-+OlYNr&<$_d
z*v!#2t}HAcTFJXKCA*BiLT~|xiqXcz>g;)63}JQj!*ljBCf
zg!2u_-lPR@Po)o5Qm%mu$0)BgzexH-KMnp;aa~_Y@oEjOHLAWO^}uOtxhk4bg8You
z&$%TXrwS+}-^ulOSCirNOFejGrZz8=tgIL%-=!UG{s?Y{TLoEeU;chC9qR9^c=nZd
zuh#FKWYYSherv$g87b_^Jz7;nvEe@MGxytnmv`m7;wch`sTJoU^GP(PZk}Pb%h^!b
zq$`{OVExF^#pgM-zF>2bFZgv5Pu-T8Bu6xdL~X-9R~nF<-#NOtXTq4I>Nvm!uK@s*
zW+9{w;o$F7U$8dS>#h{o3>Hfidr+>gjN+=^fwG&iF5&0QxVeao+gGNysc~cS;b2{#
zdkv;VoMU=!4T$_rLA9}XP}b9JrKe07wG;wp@a}vzk3JBcizNG
z*P7?A)jidW>@qdXQgAh3-P=82-Jfh&d1Q`aL(E6>;5FB;kicRu9{Sop*P++txT*mY
z8zlgk0qN!z&j##x6B``!^qz~XoYNm{80*+HxAb77LA(In)WD^OB
zsATuk4u-9zAB&8uEd|8}6CTL?4-rYeG@tdw!W;6DHuo8#^Sv?$lG3X53Myvp$%Mm!
zAf0zh3L6t9w26mwGA36wC25Ot^s0TQ2W!s8Z0;<$ef@&_+*Z<0jRlvU>7ctb0oJ3IU?=ehjPKCz#3pbmmbkDIfB8rq9ax
zkh2F2Gl#RbuAB3CimTah_&tb8=n-g$OtRS6loDBDV2BjHzR3vg>rK=!SV8c{4i(c8
z>zOP$((Zm9Fo`c+Er{1Y;9eQ%`EkJf8kLLBy)q7qdVVTVwc49s6Yl9C-|?5D%o?s^
zHz-nKKuXqV!Rv&SY&a$2M<%lx>_HLYUP1r_2!@5%SQxGE*gk89r(_vsqJ1t8cgQae
zC=@)11DA<%EI^Sdx(ID1g`>UhHjcQqJMxnd^u}Hf7+kg-@EWrpNepAK7^Q)v9Uxto
z7A)k(zW5~l$&>!%x$FW_F+}|JIGk#S&!R99Fb2_M1H;1E7eQZEsVqNcAw?H;snt%TCsR=OX!SB=HSP<(w~io
zr%L89C>0h==1&%v!ThM_B*fJ|lPX2;By#LB*;w&jIx6_|s83cr=}N6zIZ#|W>UTGE
zO8>BFEGA>p3qt{%6c5Qd%%7^yIX!$bM
zE%PS7_HZyPI-gz$M}J7fXb4uN=L2(#y^sB`1OKR2Rq8qRU9;U&?P>E`xv9Z6PL7fA
zz(JKN#>$by%@#No19wFUnX20NBX4$PVKV^J{s~*w^dl>$$gFdRJ-8qxYbAT7PujE9
zlJtN*K9tHDR-657`k-4kvGZg9|Bc#hzdZ)
z3RZzw-M!hXowO?E0kbs@Hy>;oYt|57VQ#aMhLSbGLk^ZrI8O9usnkw>mss;D%M6w8
zWdD@6?bExF-|#iQ+9nj@4UopjKS;j~!t;Vh&_fhRk@T|0HHd=&Nt4C((k$GN#+$ve
zx^7AKzi3AHtj=CP`F`EK(LRH>Io;BUB~)>IK$8TJCZ*U@0kXVt
zHvK}Or!2Cn)1s1C0O7JTqtn0u?aLxJ9lK%SC^){~-$Jf|eCe8X)uNY0+`Mi9Md6Ga
zaAy;U#65p8&p#;7k9D4(<2?Us_53+JAI|9Uto(N4xAVJN=x^$sw1B+-vGe|m&ihgn
z&e%c}S_I}BVN^$RSP~(UNoQqgC8j*S0Nx-0-e4eo8nPsvqUTzVED=IJsG)U}Swr#Y
z)`KFSHFg(^2m;t;$Y$6`lM>*9b9As{ph_6~4JkG88bs68Uy`VH9%HYjvnzm9#&DDo
z!e7|k*nYwpgSic74CGh#smCa?-%cb^&71P`n*6*hKYx^;=j7)p`I#?2Px2Gnf8ykC
z^4W;EoGUW*ebPhOg;F|6;1e7Pe6*6lN5>>^WN{?$!L-{&0++ma{i>DKnU*2>%IK`m
zI^o!!lXyeyWjzEXv(PsmPB<8bc;*n23`xXP@WpWBf-k`8L
z>ypA=*CAx`w>J;V-#+|_iQMkS)&_H%*Sf61YaVVMrRWusM#)=HZ)w0}=b*
zB48jJTj%ZgdpDQxkxIt427h3bbrVUg?0VRF1W2T~N=I;prQaPS#(iE3Xf!MA$QS4L
zq(dTAvU~Y^eyA=b=GNRUtbT8akd5)|M$e5TG1uNaVKnZCyEn8v;%oDcs;Jz~+`YuC
zFYXXjB1}GAi7@#cm5SH@sw=PWsZngb5O93%tudLY*-VsHybC}G<~raLXUUS!nG(Ns
zJ*@v7$&QHRx5mS_omcuWLLC{MiK7=Ug8fPca0CGIJk^;;#P6sh0hE(_Dk1|2ffW|;
z-|Q4I8DKh~f>da~Q`~S-GV@wfjQg6kh1oA4OpG
zg8F{&OH?IFc+DEDaPVVxpor9Z33J8l4q;0zJ(F+YI^hVd$rDIqfs9I2!XdqCcalEw
zgvhR5ZBegLRr^m5)*`uv9m#cnzuHr)%1a@ZKh+5C#qktP
zWoPA(1O2@IC=ygs38fsWQw!JEbF(9{!-TNL2DL;oCOJ}h6)K^%*aDPbj$dyj${?=g
zBC7rQf}8}PCOHP=xt>&i!R9JC0pld{N?E3%hh^UuXP8_@qjOZF68Wx1Std71&bwBj
zZkr?Loeznn#*y=Em^p47Id3o<8#j)e_o8#-$a%w29d9GZ&iVmo9
z7DdNy<2*!>+H2ItgG9~!N%tIk4qOoO8_TOgG*3$66t1XGoSZuzN@G}~kQ*Dcpd>rA
z4;($x6?47@N3u@WBsqM6wmmnV_y6Z0NzB8ax3q
zOjH-(g3v~lp;P2rZ~<(56Z}yCW+HP?fP)B7(a;L!GFX!(Iv4iX+|n%elRjQ+LhE&H
zYP0={emR@1R(u()k{fKRlLW?LyCQN^hp+|wBk~iO=pFefyRPtSj(Rui-K#N)iO?hw
zaO96%h1bYl)hW~}g=`asV{0rwz`T76>abaFvWCSdZsNWAL5S^^HqxKFP>oD
zJBB3V7e*wW2`Oi_4cZC|vKt<=mt7zkCZqC~Zsn!0VWp=~)km8xgV2`?lPX}Ru@tZQ
zRiwQU*7Qr*tKNykN7j|*0A{YUl0JuDtA5-`9cjJ
z5lUc4>!;AVG$^U{jE-%DyeEByNA6`mC9a|HWOP!oax(d`@$eEVIK^i;`ZdvAx>2q@
zI3HHnO1gk$-hVtB0xLh)2yHFs29EVHuT`^Rk>5A}0K#?xDX3RmO8dg;xwr6apU~FF
zPHo+~VgQ9~`Xq&h6%6E8l1L`E^d~o1If?R6@M!*wLi00~t_O@dBoeuKi2Z1xyCIM4
zlKBl@&xdR=Btp*KIOTCUYC)wL`I5yTJCQUB4h1Wd$D3yjD=kP&kXYOa=mUF2VsL-T
zlix|*=T%g#4|nA@8&{til6-V1~Zn`4nl$M7KEbjvqo+QH3oa7UMYS$*?fz6o;0
zKX6wEa>-NnA9+M1gbA!1b4$eho^NSz0BMiLW-xX#-`{zbcIW=*7PKD!2
zE)YZXC)EjXtO1=4{jpR@w0&WA^u`!4cfBPb+aMhVKLW@v~IiLgfF{#
z^4n;Gr!4VXqtWzYv!%3tW|ep
zmGwQ|5Ia^i*jfQLQ-eT0xluoL;<_{*C1=uV-v#x}D2c6w)=n8N(LR)mtkT6@Z?N@!3gyGS%8FMZAGT!tY#VY!1
zwyoa5<|6*|#pJJx(B^5h!=!(J4~ie1qST2pI(2m(6fM45E%;pwVu`vs!P;W5AAi?3*~8r(Dkws>56HuQo-n~pLS>i
z|2AJ?+LIK8Gjd*s%y+@gGw2KN{7l{%tKPq=(0S)x^-c=!#CJnsme4@ufN5vY4dnr)
zcCq*e6^=A0DjUBZ3Qui%;&p(R@oKRs7wBu6!bOm^vt?ylBN
zMn3XjuTz|9o_SM+n%-LW18~PnQn>|8vsdsLhf?dRcX@|dz^&tY&rz9aYI<40B8JIi
zkL0c|lYKhJ@q{ya(-CzjPak_f3dL|ncM3WKt58&@w_Mku`uxj01zag2ANp%Dp7pcj
z_d|XmYJ&F;m)!!nv_FE<*u(c9ATzf7WXsQB`MF$vek?y1@iV^Mi7)nX!15jX?LPCk
zew!QyGdeD^=AJt9Lls(F#i~=jj-jm>gf(MRG_ZI9@F!yREpt7QHxeLfo*>Q!r`Eg$
zO>ev{Va1hld}iJP6<7Qgam9~qzp5w#UFOh
zS*3Z4@f;F3hpwS&#WP&$6~C6>;4wCX=PBe0Gl}F=l6XJEB+2$JJ^M4ScGF=35PRfV
zBXO7}G#LK{16Lg}xzGCC2@pmd@yW@8gFh*3zQ~CUUWw*O#Rey}Arw0+j&A?OYX;`(
z+D*i6j>)9SaYcu087TLf8@=Z33!2U$5XoB>nCmUOeL-2ETt|_K4Q%eM
zEWNV4zXaQkX>+Ht60jj!kMI{Rru0tgaE&Atz}H-93vXXcoYNU@T~4bA9b-wGfg&Tn
z-p7ebOoa5qYu>{LZ(k73NPGlb%g_6Zx9pzsK@HAFi}0E3HjuALKZ0#zITD*}hr_Jf
z&N=F}?&7Stye;6prz(##@aBVvcwx@C!9$VYj3h#*w?eAxN?PpF2<;#6^^a=nri
z@XcC`p33dyQ;TvEvI@T8tpqqE=1AhU{houm=R?2Q=F4v+x=7STbJsFszU*yU@HiI%
zYkCG6!=qX;dRtVlpQ(dM{%5)bt{D=_BUU67^)%r(cXb5fmP1Kn-&gd|+|smbJqzSf
zY9jnqaL-JwbU$rOY>?1nt5~+urJ@;tDUv{AaN}Yx=S%3>8@!tTkl?@Fw>{1~e8P!kX
z6c~x8ofi@^^4hO7B56OR8GLxu06cY`jlrf=fBu20HsWeqByXj!>coZOAQ-GU$9|ng
zo$+LE$52uzot72lIg0S`Q@8Z{2-tGK@3DRPHP~{epDrr#{6-11N3CZ)AzOeGgwGP}
zh{Km4e0hXGSULZoYb<{Amr;I=Oh)EDSx8Mgaf#NmS8AcZ3vT4^3b?-}#%-8RP~XvU
zKGxi^!ese#wCLJ#TBw^~n7I={k*L?t0`6}N&z5jT%YzcU;CKeB1C3S{sc43HunJ5G
z=e|Ml;;xe=1W*|T0_D!~9=D*WZUbtevb+TlxpHv_pDQOWp+S~q-9rH2sS=PN9L_z?
zV13zNYQZOYBw+aoOwIm?^a%_J&sHL#aw&f;Nej)E66lN^?v$eAE%zGHP!dQ5sx$09
z28$av=ZKJXVy0{;w=Y0Z?{jmOK%M<#mWIePKu;c35bR4oRsYlpMRfP}1*!|p|LDL^
zrBuCNa0wJ;!6rtijD#~m0esdSh>ZR#j}~Q*6W<%?j{6|jTIgFDsCW+47vwADnk~Up
z78u>!t%?MGow5)wJY-;JvOCA_uxb
z@(eSu!0>RuSOz*~p>*_Yfl9E!dT`HH>)~zER#yB{D2a954C1rH84Gw=hAC+2-lQ$W
z@-PXeG4C&^#*OSRwBlK6Oq)s?3cA-M4nRrnR@PtWt3)>{*rUZRQ>4GV6>HW#3*b4!
z8IR0Ry;$H-*m8)hjw7V*!DMv;^TMreuQqav{TzEX-FxpU)x9&MdzDW2w$GC89hs;?
zv_p5(3wd9T2eo9Q=cNHGXx8{=46Wh~=Osz27S347OTMxcpY;Ux2$EfVg+F9~62FTJ
ze{!48bNmLYM}NO(AF+yfuD)Xb9U|q={#u~j0~gJYwc^CD1lr)HJ%KvDwxUFRZIXPA
zwD1DK9QCz3_!{*o&JadP{c5MakE*}gsejd(fh?&%Ap3=N-LWF+?U_#fy-xe-Qh&Mg
z{=Zdy%LLW_F9)mdA7IcG)1CU|s(yo0KiR3Tm-;_C^?y+H3!VCRu2k>8CH0z9KV8*7
z?c%!Mo>HNhynAmsq46rD5`$Pms%Honp9LEbmAz7XqT#c8s|8cSBr47v&pB)bc@<$EB)?sO2>{+FqpW#-V$8ZK?3fE8H>!37=K$N{J-R=L%kI
z47KQy6)U#en+=aK5+QH|x$}za#dmk^AY`y8o7NjtDl1$d
zdvh9>!l_+FwaOGQuZ=4|F=SPH`r`dVTv<;j=@Tv(wwpxT9_831kv3k~d8N{gaK`Q9
z9BxfGHT8Y^kyonMc#~biuSI#aDtNV@z;*mac(r!e2zDP&eIAKi=0DAMNzXD`wB`#C
z(G|D$P*1ou_3?D7#pY%W&eoM{%J=eX4<)!UCBd*|Fg|F8?rFsrRaDiUO^RWALRK?e
zV(<+v{8r`}{_M}S;)~P>#WWty_+s*R`L!K>ESIswDYrsoI`eB@v%Tr?3Rcq)r^@Sc
z4UjN+tyFk5Ct1vrtJq3sRVxjMlNtt4UrbiN>~)&|h@fA=jSBTbAsSgBPy5YHdN#+h
zjts-xF)Nk2hxFx)(cVn64xa<+ELN7wZ)G(f{T$v+>1BA4T!;8z3*LIdty?q$m6lB_
ztF2$d#T8^H%-Unn3#T9y4B>g$`KsM{JSZj|5q
z!E^(a;!?m-IqANjVYX>;Jv`|2Mm`XTrlp!Q_xk}n!TnxLXI)WivAN(M
z&$ATSlaD|hbJ;8)7wH7ZU3{ApOdc7UoI4dprf_+*THUUI-|Ob<@MLAQZuN6yb2A}&
z;0|Dn={^@E3@?52v%vsiPT{4WaqbXN6fZsBxkKKxpflSk+$uh^*fez78q~mIW2GNp
zgaIpE$78Y5vVs;XJ;<3oq;;tHXdPUDf&`+U698HY+K89_b7KH=<}=tXUb>mVMe<0r
zF<)4!jYAQt!a$~!><-lBPh?2gVxS{v5N#jP_{4=Pun_mz3>tE=Z!C|jOFhrZ@uYFU5Po*v<
zZk_ShLoC?W&{wx`uw6COl<0e}=edIQ{B=P+*oviIZ_QQA`j+;w$XC;S
zeg|t0lDhduLsEx9Fd`;==M6$qLob%IB+C(!N?399a0RS5roxbvU0Q5!v9aPYSn+tk
ziqmwfc=338GskUW#SM8tP~pdo7Z?38KD^GzdAu4Qf=^(=&leNE%Wp$lP4`A2D8oK1IKnEcqcZ2O=frkjMpe80A5)cwQ{!I~
z6+B4{-R=LG3j7DwAtd}tKR@NCdo!~Slz-;~SrzVx{4f(F6`c0YeSlNKYp!~Ly_?81
zSFN@EKr-Y6@d4zP83c`Xy*sK}c{O@T3n}Z?)jIbqa?4iWOIcg_d~GWyGL5G$s_Ye=Z)bc)K#lCc(VDHd-Md`1B|Ly!p?l
z<<3GLU&0~mGPc(!9P7Of=HMabpn7-q)Ew8M3DyTZD)p|2`$Y9Jr}fx_h2z&!`{1S}gR3SH4T}HeGuItCUia?ep`h4Lne8lt4a6i
z1O9f#l%L+i6%mXl^&=`1hr{igj>=9imGID9HI-5z7;j5^XEAET!;*JZ3HOsR6F1Zi
zeZg#TgoT#U185^N%FRr~@vXMp%}f~{pO(|d&YhpoZTWwe^2C(fw?C$VWDcxK(ZF)b
z$O^bYRD}bj@ffPgO>UGN>c;TW{6)vv1xFAQtr#A;@>L@-`C7f;pGseD7jQWl{M@kF
z;Potf$?NSK{M~H&<;@ZC1lQRXcQzIV;?OY#!I(
z@+LpXEu?F7ra#9h$Y2;-A?86j(xbM><22-DXZmk6?t(rbeg@8S&h(%0iZdAUSf;#(
zu}*+;VyTy2L99b_>BQ!4oiqJ>O37A}F>f8+CfnaBru!uxUTVlztafYY)AH1aEt5)=
zu#oe>vS&y?fE0lGhY#?l8-g|BV#2TshTI`9#j_VrO(|VAT?ITQW`15ZmCNkU2Ur0L
z+USe#us#7hdh1fkCIV-@RM~EQKa0o8b3z`>T0$a{-_tT(#@?4(ND3#^ZK<;LDu61@
zG9OwpPINMD^&_6Aw`5%GF=Mf1+I-enkUi6Ra61Viu~(Em<3tRNl^${{a}#B(Gz;YU
zJY1Ecd&||$vJSV*430)&z366+t|IN1tm~1)J8*Gcqm^UM!>M|Tk<;IN=A7Jvd!)W&CKb7>HzFASy(c7j<9zbMt52f#zAQD$ZNMg%-gC2KAy
zT&&zxa0&$gBo`!Z1s3|pB0AHTfkbeRU%!7bxx!fiXXtsIzG|1YJ8iHuJ
zSP}k1&=Qnr#4;rZRX#$;)e!-G*>a$xt-fp>8;+}XfCS*wpCz(7FWW6h5ghe~mJRhI
zxVf;r9_0##ae
zC_2M>U3yNc?)e~Zb)<#hS9@%-&dEm3un17y!
zA)Yj-q#|P4&L`b1CA)z}-4f8KN6z#*-u+9U*^fg113;5vz(Zb=O~d5|F4`UcBe3EM
zM*hBc82JYd%zMDdivf(J1M*1HxPNeCdt2ukJ{aj_)Z|s((rH;UVH#c3*rkoj>igRDz3L
z;tIspkPB}ID$8ADv2|B$O2szI5yFFB%Ilv@513FQ6_BRz^(0t;G=)jh6rP?f=_A>{
znv{ea6jK#PG+Lo=syH8<)mjZ1AR#KKlvd4^!T#lsARUK~skLpTpcidLlTl#xKRQNk~Zt
z%nFqAU3bwUT?M2gq#7T(+t;|;iBkDN^5BoH?(Ry5r@Zl{aF2X*o7KGlOBmy?K=Pc^
z8Gi*|1+SH7vm(|?6rzm<7T-4)|Br~(ipO?F+*W-1I(J^g_~Cgyl(2oEM?Re~YuC?&c8=+O>`fB$N*)~661J_eI%|ap6y#DEWad3(C+^M^XkXF58
zbS@6y!7hVZ?_I={xT`j%%3c$V1dKeAj67znq03nli4n=%<9ZJplPGu)ZFC;k+9y@E
z!C<2CGh}=k{jTwkLYQr8mhx&=2G^}Wr<+*s7fl6hXO82>o%8%h%|ET=EHpVGz{fyK
z`+K9&z7`XPtDT@s7BZy4B1T`hA3KaSM`FEtTt8B4<{48ZzWmci-r7WU8;%=CWgi}+
z{07-mzS^53T^@3z%M(bOEjLIflNl3nq^a!Wn7Gm~v-X{r)5DYy{tK>-9D`Nl%l^cdb3KF8N1Voe=h1*~bk*A;T55OIqI
z60oIj4AX#jiCj(u^%cXEyF=l~L-Q?MQjLMYjWXgMvbRi4mUY0~Puv@OIydAXs(tYg
z8W<9vdMxfjV}bFVN~E2tK7kvCTMYqEu{`2MiI8KwDBP>@qQWD#)9aab1v3IEVJk6}-%a5*ih>7AbHHS(itsNrOF
zeWgsvN9LO=gt6WNi8K8nJ`#*eq}4hLmgLDS@6;jCvPO-RNC7DSDJg(@$wW?K6$zja
zIydA2N-(JY17>)Kjd#n|7J!m4S*0-9NP%qTu|TRE0-}4u#-EBU6H_;p(HOT>=DXgD
z0-t2rE0SfLdlxvfaiygcadH5OR2iZWby9@aZfsc~a=~c{%-d2U{uaV`H%8(s$+&yS
zGyuy7z1dZsMeHhs^Q#fBTF*(8y8MXx3A_uT)_cC&&3O`ImB@cVYGv_m0iy>$(ntBI
z#hty4h8}LuO}|>C)BUFd&Jx~IS`Zk6KP^h(pbvG>9jsz(xy~D$hw(IkK@?w!iB1Uu
zIFZkk!5OAfF|0!N)%ePMbIRnLtlpALuPcJk@8EyCF|2LkH9(Zcwf15xm#fcWED59a
z2Uxc5?AD{-CAvvI%`)y_qq+u#=NER)vB-V=C*eP&W!PCMSW0PBNtNd_B70O-1+WLB
z($;YvUXHHq;rWb?L@NvORg7>)ta`jJ^XuH*R*7kUGcn6wb?(u1Wj&FE(#s`&rMx!V
zI)%edRxhuw?m!u0k)U80cd85gM_3}ZN2mGZbcU((%Fj5
z^|4NjqiAGrEiev21h#hY+OSUW>*DA=aL%7r1!G;FAEYf^lEJMYjrYg4bm7|dcs
ztWT0FsAT~jtEmiuRBE2B_u5kjq^e4t>B=L5F2e;J|b_RSRtqOCqXX@>h_0_BEN37R^i)PcjHFzLqZ}gT>T5Guodv8rWve`W*K%}?C
z$cDtS%x=SBI0<_5Ybb-T*UZ)kkWric4a9{WBCf<*BIselVasXq1?qn^$UhG;*kgg<
zoOf?Z<`caWufWt@E0{aPTezOWEe2{rCFWK`Ik4}AZYWK>$O!YhlDT`{wieL`@Q4Bq
zF_6U0!EhINT>`PH1#wB06jskVz40+J40v*@4yLHP`dQ){;8UI&u}o`5qr%@P_qT6E
zGpx#`J0|X3J7K5M9=y)tVX89lXWCKNH423;MZ+gCT&%tJx8!h^SMFAX3=;xo{iYA+
z;KlZW(>!mBq}0VIec79Dr^?vlo1Nw^&cMum0-!;_k5;U4|Iuwzca}Im&ackT_?&YY
zRTgU+vaQ)xG1j;?#FI&^VQm$!56Vfop=fcX?o&}>_T-#smuWE>E^`V&4u*hKqG2y}
z^L}U;g}5W|Bm6-zLZ0*(>~raI#V;WOYkHx?%}be}lt{UBR^EDWX$k~BCT>a6;$oIT
zmyr9EcL`|y;0V6t%qtXBv&$WUJ;1Xv2SV&YoKl#F58RlqwUi!6T9Hc_hvcT7pu(vq
zT}H#fT7rW{ydnOelochr4BP2X%aeqILJ1gK#i?#^bg?c~_IhJF;cc$-K9X*}QsU%D
zeK$%pWlX&0qkl?#{=HlgY|+2pD9_M@K)mP
z%ENKtLtt!Ga#d$My@Bkjn~sVTj60PLYOUUNO7{36uDq6FSk88I&Y8pxfrV3(V&&AF
z)Y57|tD-vnEt_p0pihw&2~IIQEQ^B!Icf|}%<8I__fVs3lqQ8>SvZJ{UY8pEHmS0l
zds#_;n|VPc5H858$mlB;e!U;MnvQt8-#7jG=Loz}qS1_}W&JxVGjM4zzRSZWdONY;
zdP;bmTm^Y#L$qtO`kaZ_nSPx~*nCv=F3xGcfeCOp?zZm*<5n?^TXk#Ps#oJyo&I`e0{es@Pqd>X9>v&j`Y0i*+Vrb|x2lQLKvTPRo3!Wps&*xU{oV
zH7}+{ygcc4?JYu9Dj9H_bVbG>VvE2=D)*noC?nJ_MrwmSbgoQ9r6vRe>)2{hoZhKY^%-@WKn#W2HZ6K10thS7N7Ei7<5>C#5|+wdihv>=gk#7JZ}
zDt6QD99XOZi9*oU+c6jGsPhWLaFO~}ZB*~<=Hy-ENi`aB^IjJV(P0cdIP!Hvb$OmX
zAc}cK@d}Vgq$q~$?tx3Kf@;=TOTiAM<)EEC;ReThq_E-B1eNjmjfN6qh
zX>bt`tLVB@7yQ%KX|t=~THvgI{w;VW36?8m`wP5}V)^413r?hEq(FZRj{xzm!4W;l
z6OTOQ_;mQzp6Nk3{(bm9SzRG6gOM&seAlEI0&vI(9izJ95=f%j#|JrmkYt^90uaDI}+R%KT>$7P?V{x5Hm+Rxj5i9Z*~^
zdyuA$7(CoojC105Sq5m-#b@=E$;**_WxsRsL=0t2N$(Hs!YD3q{&*W$GR=bD&Q(0P
z{1KNX*89_;CZ^J$!Xp24yKAnR%8flJ3115Wi~Q9Pi=cvC
zSL?0EkMoFp_xh~h=%g(=I$;}gZo(Nt&bfEKw+73UC&HtWMc!_wRS^oObSMw;dHo
z*)mA=7wYd@l*QeQpoIJkg)@&zs5FZhYyIxrz
zzllH~K|;zciq^+IB09SsSEk4+IXz}Y30^}KGpgf=6)}Pf?65kim&EiO%#kyVXe!S1
z7e)Yy%u=a^S^W;8PTT}zGHYbdfQ3~B{C}Qr55>OhPz;&VUxaiLxuBFlNw>mNnI5p7
zgzr#g`f~_zF`lmTp2x_`Y5q03!vvxpVbaMitDvaTX^-qm6{t}DJC}~^$m2>~v!leB
zv23^|SnHlkHuH)O)Xho)om?29dqtHbQ3DLV(uQ>AKr!fCTvF|bFs)lSVx4vuyB5Ah~X
z@4;#zz?Xyoe?C2>wT2Mr$uK&4NjK#CSN^DQkD_39())l}{9ivJe{@Drf+oH63P6y*
zBlQ?lw$g~_pY};Ik1}eE~Q@v*DZr+BWl7=zEg5zBQpm9XJ
zISDsCeIiA$)qFye>FpA*0Z|JDQHr2-XJ2MgQE|t}9DE}4N{qUg0hN{{u;`8!Cf$#P
zA?U8Xj^_J{l~!|Gowstu(rLSFseUv+e(;O6%{lyt@0pKwas@CGKX^HLg2QEI+Z~!f
zizs6$X>i)>VlOAE*Q-}Rz@*<>GDMQV68mX-{qoq8%Z=;
zNNz$Z!KM)cn|S)eSfZ>m?mZJvzZFZw-V^>eWm{{aYFrpdZN>>qs)$=Jp#2Rex1DF<
z^cCuH$P>kGNdd>B{!eV+TGp40L}@fgGX~K@T#A0y8I@-HrbCeL>aJL!amT0avJJd~
zag^d$#-Gac@*Jpp7?;DN-3;Ii3nJ*ib2Ep;_z$pDKiP*|mUk*IxFqP#5^tNZh?SRW
zM_{4V0QdT~0*aDVvv|@A*^=1_rkt3;WMR}^2N~Zp-*l5P$Pa>|CKA>0B~{}xq`dGp
zMiJ=_7g5{ZX;gtc(td1^WOsSzMzA4nAqzg3@C;;l-$`V7x6W=di#<=*XP2@Xtbdxv6@w
z#V*sSpS(sk@qRld#*1;Ez2hR&clkhRl&Y*gHb)Vitt>h
z<%%UgHT%Uwg?`F4{{=1!>@Iyc`wRi9J`E-g%I7`)z25F;fdDNPN|X_;#XWE_Pbv91k}3kEJm5
zi!YTc<#?jGU$IlX5~k%P?VE?jvp0`Dp185k#!BUWJpdjF%ASKq`Y8v$FlV%13G!a6
zeF|NN?mU}4YeNcE?kYfpxT`o9whW=H9e2T`_=jc(dW1=Q-v36o|4rt=s_Yp9(>vKi
zB!LR%)!#@LL%f!4C{DNavH4#=IGF#<{IwA7a~VO-ze#hOMzQpRO}F*8
z@4rp`TEFk99X4^%Tn-a+{@5PhLs}XKYy&$popb0W>T&<_g8JgISK{e~F>k(kP@1>%
zv|WZ6?mUiVPkHa3oE=u_V%`FmsfY=3J7c>#&58rlQCDWrUCJr%Mq&`T^T7
z!bjd9T?Y{|AF=BoVCpcYAi_t@TpK?6v0X5cFM+wzihJ1+Gtq~@fP)YYD#llo7BSy(
z!mQL!Ad~%hge}~bjCIE69>HwHK0-O|tpjAfKgfjK_}n9TT)ocX5XL)-E|n`oY*V6j
zFnNhm3NgBw5xc|-RbGwhw{Rejr^r5X`Mb>9Cm~OPf%F+GxL9W)SPP~JP%-TTgTG;9
zOIaA({?ce7=udEd)kfSwe>QU#u0N1!{6rn+10i=HCNSNXnnQ;&k7X*@ul>_){cOG8
z2S01Q%ix18oxognP|iOC;Od4KcI+q49XIfT9V^5$^RqNwfUsLHWc5$YUR?>I2PTf^
z>w-PJ*16+!o(OGDXENqdk3OFJ```WUciEDu*+fyF5H%efTb|xA%$fNCOWlpWIRs4A
zeCRYM8ICIX1>^%D8Rcf{@f^DS}KSVs9i!l$`@?liF5Qbr6K9#?DnfRUi#{Qk%`^dnlN&Ch4T{cyPU10Yj0mx;{zM+j%;%R{&o
zs!Tr4hMz68tRh<_ElwB<&m9a_8sUPznjhzL0*sRU>s2|L%~W-T
zDD=tIh7qFuZ#4LPmc}qP_^uEyd)M-@1$@iHkLz`HuTJ(NR_6n3R@stTos*cQj^a@+
z;pE*3SUgNvp2~i)*v;NtjAHM-T*di^Yk^K7rDI*uQNb$3Nh{W@@QEzZeW%(IRrBYm
zeVKHY=r0yX?0LQm;T`l{2~Hk4tzEdd-5*;0JdcK_7mWq|A}m(&(b|pu4NHUdD=Rsy
zb4r~%`x5gQr7%brd@RY3Ye@?Fx>AyC$nQ^OD29-YenbfQiM&2N+fb5jE4KBMN=Fp2nL2?C
zIvmDc!ze6!4o61#W!^~Nb~@=xG`4lWE_C6u*a26obd+!BVikIfLN+c5E_PT=nDuquvh?YoLa>DAm*n1s`ilU?Z6M;R8(iOKjlahF{72aTiu}Awo
zwv7z5M`h29C93D+1wL?})>H*#Y4)%$pWJ%RprWongm9pssJFW;5`k@<^o<(h^82^s
za9Cg1-~SBDZH!47fONxPp7ryUCPP5H)ljAX7;wQ9xE`5&yu@)ksA?Zs9LRmOdS@I@
zx%SRt7J}T0{x5-NY|+9vP#0$TQYpjk5HFuie74Acjk=T7yCq4?s0IpIc0+^7xo2E3
zW6bJjt~t7^ChT{Vh<%x)lbyy5%y^b-cyb^JrURoC#ODFic8Y7bVSu-SZ0?hn@G?d~
zQ^nz$>CzqLM~&Uv7gt!q!^UV7R5d(w|qb1x2P#vqVtAuW(TmGjxH^#Nce0m-_n+KCf8pHtt2
zhl+6t0(|!Cu~U_`bmFP4!yLOva6+8+`<%=@qJ}1U@?W_Kk5)K(AFXh7AFXh7AFZ(67q0Nh@N@+$j6B5pZYfyb_*FYEsovoc
zM9@~3OydpRt2+RtK*_}X>XrbRVss-50K3o3?KEZqWK|(fYNCa3JI#
z7QbpoxPBd|JYuY$tMy9_WOpLChYJ`Fwr8R**==kE=R_-bv2cM_unF7>>i1`Z?F^SA
z6$iMyuYVj{GQi~^j3U2N5pla!G_99&Uf0d>pN?UaUq&tSz}J9+e*Il=HCAi?sMZqy
z@9#&o0v<*FUDP^{jm{_f^%wC8OyJ$bBS8yM#h<6{rXc*>BS(u*UwR;Z`~$1f?ft~P
z%s89RAw0!?HeW43QRI&eI?Jn=e*>>jxEihSH-c>DX*^*zwDV~%wvBjqhSFNk=WpZD
z6a55)i^r#O%U)iLpjy=@s|5T!nU_~ON}4$pJW~izOD
zJW1mYa;^oGd2>JF6|bisyi@1nPwF>#w@U98@Q$ok{z-I7EPy`_0?$RUe-;<%MaBMM
zywTrRVWCy>#ekLmkBudo#n+Bw76&qDX7S3eXcn6f5DPvi9lU=^?>mB7KHc75!uvX}
zZBZYkV>)?JqR+>=@ITU7Yj)5!%2Vy_`s~f%v!V9ck*c=07PhI9PX^G^yu%q5XG(t^
zt8aMpKIIMyEWgEIH&8yC*F@S)V$GrHXex@|wZE;jz(m5n7K
z07>PGHPIeMh1En(eJwO_#+DU16odLdVY!P0V>XCbR?0?pJ+`l}#V~x0qi=GWS2OZt
z4F}e1-4Qz`{fxXy8JlZ#_fP(vzGesRPc~bk*P>xpUK306GeXOk-pS_|gI1nmJLIZY
za|Ce5eY{9>05fwY7aU`?9>FJx*e=fHj>Bf!O>d2*%3gAsMeR}8B`2&P{;MhL%I(QY
zd#mhL^^yns02)c>$)(w0Pd{aPopbh;QfD=E{NUKq^sW<}nd|8Q4yt7m{EsA*R;*r1
zogb8|{^cpmU0WQ)JiQ&2G|kTXgqOXaf%VYu>;P9JGWI-F^Q5Ha*_A+QY97QG*bwI&
zYy0RgUu7SKYM$>MrG1pyPdbF6U~Pe9sgJh-!kwEg&gCxnmOqa9k$zdp$bZbW@87NS
z%k1}x#nRlq8o*$xyoYI~Wr^7^IA;=?bQ@9gs&}58P1VG_tl58{1SCDs9dGf0w|o0*
zijrGx)Aom142W4MPiE^(1#+b8wdk3f$?8u^!Bx(~Q!|>A2ce4{F*xZ9P^XY*el;PS
zB5lgsxr(xiNSjhpC2b0mQFE`lz!8P~JqtADp-Qn4;tyL#zf&p0?&^{%JrbgEsyV^xJOac+
z0+&kVo_A34xDyr-62w;&eaQ=Zf^|zZ%}mSP1`={+t_Fy`-PQ?jCk`#`yZaFV^Q3yH
z36=&EwgFM66C2SzblCfi97y^|+bdG&Cua7ekNzj!^GRA{=Z?*+d74x8nQw>Cau6K~
zp@qr;n0WP0>Q2Ofn4`rY%lGx!ODc-$Yu
  • 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	>rK(C)L4iX4Lr)k3-y
zb|>Uv7cSfdJ6qr(zB*GtS@4B-vRNI?DhvLjhyebw$INT<4sSh{8K>80hAs3i>e>PA
z&|%ijUgi(B@f0Gn+=J!`5xtALiE^_%#Oz>{K7|#+G}bTo*01Al-><27wWZ1D$1pfY
z3r<{Yc$&7lgpg@d?(>kFwak5N<|nt>(ku5d#5C)pZw@OIuT`3F{$IJ__~yaETbWDS
z;ELC~Hz!oiYIJY16lJ5oGugV>ZbfP9cRED+Vi7YpgN)5q{{QDTEU-_54!$9g5Nar}
z_V&*^@+oEMMVN4~Q6vV0oN2VZJ};WKRti65TyQIhKTGUYMyFuCwiJu350;^iFh0dN
z*uH1jxDyU?ou%zpLkt)COJ*xf
z{F2~@>$S8^3lS;O}?eWeW>-+QmsbOkKc7y(muFX7?8y3+nWX&(v!RHI_~<
z!+B-}ADqZQ&MOYqw92v&n~F<$6dGv)?_~s=pGbEUt|~6`hzu!50df>=1zeh;l_28+
zCK0J;ri#e-s@CJ6f2UqZoULCzHfq)hF*AdA{mVu_G|C=bOEB%^`L08Kh;U3J*b)DAQtp+v){psR8LeL)p
z$hP22-~o~rAs`o60tl*R{WA$L4D7=}(b;?|j+3NGuy1H-cGXTJ`*CHi*H$Ixh-*qB
zj%ZRowuP|}*Mm(o0P#{5KybL(m6NG87lx-xt(t=OCY}a@W+z`1&zE_i2cQpT@li6X??alxwuy__S^`G4`7jUF6^ql#3(>fCvh`@e04z
zX~eEJg4X6hB!ADdp;Z;^0C(trB>5ER9M4F80zS=}Eg1;D%rI~?ZB*7sGNvZ|x2Ue~
z{z8A4&1w_u4luzkyl!hS$0(uRy`{U6gBz=|?GY~xUAsv;+;*jsb*q4Wk!RZmDIMgh
zCL)`d#}>|g<*eQ3{#0C%MMUvYa)Z<4)ff_Fqd&L)@UGc)xQyXj1#&p8%$!F=#1ch0
z9OF|kQR`0VZ&DO5tFz=T!>f3&)r
z`3j()7kC8d8;qNPoo@vvvpks}itCXL#>hW6#<;)EIKjiV>#0bl@^IJ?N&ZZg(7j>~
z5NF51bs`S&h#hcDYZVzocA$&eU|=^^ppf@&L{zKopv_E;VO-;FY~GfdmHLF+y87
zfl#ly2yVos*-nfoWLiZGsv~TqQ`LchwPs2BQrO7Md?VMYkzI|ZlYA@!xUN{EU5PiI
zWBDsc4&x3y4Wd}wft!FTIckZ7u|u5#q(rz?Ops=Pou$>um!D8OV$1IKG&dK)Wr%M@
z{3kQ?D}Oe7&qnUp$k}_29wy7lvNc@h)`X12rRw5xN!2Xut
z3T+2h0n|L6b9pihtO^#GR(z478~XA=MwXT@rxlKh*ez}Kl-^3CLrK!bN+q|nl_H_7
zJc@ZxsTd4{&<*>gpGL=FIKl@RO_|B`spa8?Z$-ci6a~VPsY@5oSzW~$GGxGyY2#2^
zvC4uDOyI$ecZ$O=3g+Blzedr)lkO#0$FJ5^1>ntH*mePu9Zr!ef&g%^6=4sR5}Zm6OCbJg7q2B`*c0*#UWbI}3-Z^+a5#R`2HIrI&EYWP
z{1%9vb>TCN_bMcf+;}gx=lpnIe}4<(y$qOaeY^?V*z7mnqpiqR#(T1rfQ+{>-l5@m
zZ@b;i^)L7>9WRG%Y|NhjLFkdT0d&I^tuAy$yT_u2a;{&Kjgk@KXfDhu-i12eJP}c7
zGCb^KEdaXW^mX{-J42C_I=&OiC8tyiN12XYESlzf5~#V^1|BpSlM;!c)U7kcV8}$P
zR=UCkbV!Ihnf$O*7Q#+_;UD*xvBdZ7RT$F9Z2Ncq4`*irA7y#%|7<`&@C`~ZdR<~0
z+eEnniiLK2%Z@^&1X+tx0(*7EOat*v%b+iPh8Lcms8
zyj7}IaL;S1MqI#k{@>qu-dTe7Zuxv*X5Qsl&U5y2p7U@Fj-BKO;yoS7qfQell~WXD-lXj)yb08ysgqx-ZyO>Nhj9(C%w0(NvX2MAD~
zv#8!xU$8f|rE;ozH_qUyOpoF~5prI0dekjZ`9Nn+NSo4xr3wmurcnLW@F^Msx}re@
zTv7A-i_EI+e9afT;kJJ3FE0j*w3a{Za6|9WeK?ijUQv70FEPC)f{Vj1pmDRk_h1AK
znU*=T$_8cJ>g!4>1!CQ_ZTXiu3-oJ9aoHDpv1;yQK90!dyZG~bEd+$Ivp^QYn1gH-
zru^?lWUpck|1%<^ng0=q^&0bzDi#$%=l{JS=sXy$jL=-s!CR5wTJDvCna%WPB))`K
zMS6L@ewos_RKIN0NL7mRQXk@Ii|UsxwR2Vf!G)m(%%0>5^nFeQi3FyIwERX-I%mW@
zz^8lFb55yAw}OSva1dqO24!G$&cwp|HD95lnWfjiE2lQGbU5RdGU%=HWn1v*zZ(XMu=+KB5*~F1YNZN9haX<9VFFXDFv#LzB-<-rmx-sb3D*EX6L=gbZYj;3|@da1iX^Jv{34Rtnee*Oh)kRO&{
z25aycy(>iUQcK0ogaZQdw6Gbg#P&B)55(#ZF0BfN6d+_%^(Pb{{3&i%r=WhU?A|Th
z0zSY~b8s{zrk%5YKPAKSEuGFLuTv
ziseiq#yU9i6oxBCz1evYqwj6ie-e1Sj;v;m2+?4QKlo`Emqt8D(y
z=zafxPVc2g@3Mon9?rkuR4=E5ga^aLx+NJ<5r>=Y4IBF(nZcV`%70=8>u{)l4wIFP
z4qw0}Ms|qD9U)Z5BG~UGCg7%l>gE(-I1!
zHC|R%RphI=J1VmNNIaN2bW0g9IniXK-jeHv!<GiIRR-GCiy
zBbfqa&y!{qon$zuj?Fm`JeMmG83)w1DU1Ue73S;IGho-^SmQ@t>U0{8H*V)R2fjEt
zXX%ja3rpFf`MqJS8Umz(HgSt<1Z((e8go0uBC`@bp9Yh?h6`Gb1$q#q|fZ9bbHJuhIfXhSw`0f#Wj^Wqqt3_#MuJu~nm
z@xB*%hXDJ@Hw$6ch6hBShwGWjyJ7N1^bbDEIi6fC4U7$f-ZWszQV
zsUqN7u^iprrrFr+peT=Yen$eEW7c>K?npw&W%8zvf%?_QV^1<-=v7GE=Q4IJn
z8}%nma^FvyD)Wb00@R$5&^#wU4#MUg{_zHCk87K-0u+-G6Y@OsZ
zi5?01LzTkgJtm#_bb;=o$reBQdN@w969vH%X56{!R{V96jnNRMXtN~H37->>
zw%`%4-&KX*YYJZt&Z|0sTK15)$ux-IKI~!{<;flhe?<0>yK(dvUV(q6hsC&WuJh=b
z>J^rPux(X6O`V-R89f(+ZYxV>{e-rl=7VurLgZD@OE4ry=tQDZ|rpE^ZPvH`q(g&p&34`KJ^
z&kg8@`;Glxax_dSp1u+cUNhiDbVb=~PJCQ?MRVsd2Tn{3#x#(|0WT^0(QkOVEpyC)
zt0wBZ*gi=48(WOkamsOb_4s`~!c^aDWwR1F&QJP{2)fN}u(nFyoB2pHQmcxZ$gS)}
z9bIR~dJY_9aBc3qzP3Ep*Q%lb*~DbO>(!1r$(hML%`0$OCLcl{+dd>c!{HB`EB@Y=
z?x<|;yzcPq#Et}&Vh)e>Rn##;_Hg5Ma$OF5J?Cc%o>Ud0#;2EDtf@?XH5zhwD*ble
zP>TqiX=CuBMDJHSR$}9BzTIr>@uk?f|00o;IrcfevoG-xRwXlLwY&ehGVY7_aQ`cO
z&sP6d_f;(INk4Pcmw1Zfgfho|vqbmW<)%)4RPNpMO2LeV7e6=+VdF1ot)RU5
zS2asNb8cnVmK#pWoB)PYH2GHR>Vjd@1RqoH3ewIbNMUnZ-!cO_))~fps#_y78q3bX%wWd
z^@I1LK5s;VhJPEOVv0
zICM%_CPxqObLhPMN_5!mAEc|0fn&5GxNu+9&@y8V{<^K@D)4aC1#T^$%$9?b6@T8H
zpZ|~A+l+$_AJOA#Pr(`CzqR+Ga%iGIcG7kPeHQgVzxJd-{nX
zxKKntZz}4O!@r1bTz^B?19@v_16ZaO#sbSXN(hhvzequa)q$B=iPTgeROF&dVfrDlGVxQ%5^+qY93ge+R{PwyY~9rwI;4v&}ie|
zEd-c4gO=>VDtDplaGq#>2TO>E(3iQ%UWKP{YTDSnR1a6AFV)rV+(MgP>L4Cxb9C3_
z3IN&oXD_u6Px$FeE8Ef+QWN$?`K!H|f0a&ofEi4Z+Owy
z?)dDD-dC5&dA96Bu6BC2JVFmaKjr4TtTs9L0>5wkn|E7JxPm7Zc56#32c8$8^Ia|j
zoqdX+vx^q<__++1o4VQ0x_RGqvrye^?Ru(%qgn~7-2>NWJK^+jTR}hWdMZJR%;%(;
z1lXi0qE8zA=Xru5C3idf7qF7VdXcr`rDWwiK)2a}#|;dPPfLD9kQtS&o@$MC{N8UE
z2+!s*^nD%N1Desup>Pns_&R%G;p6(=>o>0H*xPpOb&G@qkknlI@a~^cyK~c>ziwFiGWro7|TSo$2DiTyhr;^BwDQ=9$78v;_TvL)VwNx^t@_(WOmL
z;UfNX>wgLBzoas}*)F)nxRhq&%3GBkWTT5SIy;IwKe_`2HH{9JE+hQLYoLmYtaR;3
zQ}LovZq&lKQC@eD$cSPN3OTY)ocqm?ZtK~(HQdUjh21g|I>W!{HVmWdQCp
zd>)KfEKcwLJFh81J6}mh=py8`lGlOs^X`L_+QBYG;dB$yZu
z#B|Q^n;^aXf0GO&%>6fT(ZcR{!y862+RBEo$WVV*B1t}o?z
zcLt5EhmHMtuECkw`S_%HKR{L`Ninr0MkZdWUe5ss7}KTn$&Q3q=+o4M@lp{OAbI_t
zqElg>Qg-7FuiCWpO2Ug`AWliR?ii;aY|$l1Y?8scg+ApIYIK%8MCr)jdc0t{U#A3X2R>qW2cX}H8EAaKH
zzFV+br7L@1E5kW5+%FxBm-e$sI5wHgE^WL^w6~@x-**p9yVJwaIe#gCE-KDi{Lkh|
z|GgAfX&HBFXhHwLH$@L9Ry18KyPQ0+S8mF^VyAHB_BONujU4{OGgs7_&b4=s@o0^w
zIe4f!`2zaFjdWx;kE0z(6L-Jqd^{7r3-46_nKA2bHrx6u1LgVs7LT&oit|tZgC;X$
z8lJcNv-!y7XZ+IcPjmN2M)&o8v_IljyI;fo*2yn~oz|7ZcU9u^#*WD2w^AP>AEIvg
z+7d9c(i=-c#4K#}?vFn|qGsG|1Hs05)=Cr74Fs8pG&Z}b$s&@I|<_bdDb
zCseMXf8q@zcJDWDb89pjif|gYS9>L8*7#bV0SUZcjp}$ahwulw8|Vtkcaew--_TDii9mk={SNYSA`puRxC3(m4>3(8WGlmYG_luU^3c-6G2m`h&Tr+X_f~)jSZ&J%3A3jn(73uSdn!~ZS}1-#
zdN^DC%6~FP-5$6Hd^Gq(iynFLC=jJdiIY)(`TChJQRpE{fM;|#Dum+f?^3ugn`
z8o@)~vxnS79}Z3~crWKqdf3WW)$Q@*||N
z(?{h*C(hk!j3ui9*p+NM34-~@JM3}fftj#7A0vtW*GA_~KD;DK3bw791b`Xt%LMbI
z^~s&hL_FYaPFPz@|JwRo<1YZsFh(*Hno!YVI6Y&T>nmfWuV$;SQJ9-V|IEBfzfWt-
zFAT1h;OYua+3WDbpK>Y3KVr!bP)~IfV_Vk?9T&!f1x&xA_Jnm6pM~}n0Nn3EL8%oe
zt(|1%W-wzHN=gEK`a+)N%ov%I!E{>kuDsXOF|q68iOnvVuM&bdBVSUKn<1$X{Q{J5
z(iSip?tDlsPapUS>yD{Ce8r5a@LJ<-O3tSW==iPpxrz`^aw_H1+3J7OgYqVG3R@lw!Su8d(qGU
zUF1(Q`MB&K>y@1jL%uRiH|G60oL`E5S+m#zL1rkKTF<7{S-0T?G|NRP!CvK~vZH}q{;
zoA{3A`=ou|%ZQ6~711wMWl)M&5XGe*WM!PR7qtbpBbTH0=w9t{R$Tvzwq4okonVD}
zUTkk;z6|Z(T8qZuHPE~UvVegQ7V5Y)#saKrvM#oN5DUbP1^MxqqP$pxo(Z;2i!1!i
zv2em$`5PX*Z;TeERz8Qe;7#?;v3yDtSip&p%6`r(XqS~$4jhxCZ#i1M`^MG9l55~c
zqF~(OBR3KI8x%r91+5%{J*zfZf*JZ0dG8F26Qgj?>^(bEFwUl8S5~vsX`+#RnOi@vS
zXszCT3jt_(EIod9W&+@T1lo=ud+-H<>^2~q$AkW-pH*{W%jMYQQaV%SZ9=1?ss9vq
z_`#+1Zage?TuVKpHd^60o8zmzTN@ZtOb$bQrT8B>f=ZTm*CGe`A9ot$zuOPwH#x|E
zpH;|K$9^@Y1bs_L`%oI9h4Xdw+%Tso^nsJMV%iV_gWU{`f2K|UJqh+VQp@MOx}=)+Xq+QA*|igS#jGBlF72op*uQ8%
z(ieMhl&($;?>uJs#KapBBVyt1c1f3T81XLCGuW*xRf}iTepxt&mRWbFXoo-ef|h4Z
z_$NLK21!m{$AS;$p2oqw64mL6$cu_dUV!*G0fSd#1Y#9cy0U^`V@2cE>#tCFB3Rw~
z%0Z>8H@{c9sd0@L-@5F5Q28M5t8$w83)XOMA>rAVEBs_1evEFS6nP21I+$1C3scqR
z$W~-BPU4QH7~&!pi~}p2*cfSIeKpZ%Y+7zIv!E(eA;5HQ2-{i0i&J)ZSL`@n5l#IG{t3KDYZU?b8
zNqD7O$#{`w@p^)g65FacZ&*>-#{Q1)TFYqMoQ1h`<~zO0GUsJ-(z+FlDOpkWPH$PF
zGuR-f=@^n%T1JsS+FBW2ZpuWbdh*lb>RN&$!he`8(gcsAZ3Y>X1?yuRZ%^lmGSY2k
zz$Mvl+_1Wo6Z4+Poxgc74e9*NEy3eSOYEHrQ<&8F@RHZV;i8%$pzJt=^IuVTOuthk
zIoJ@CHK$v~e89lSx?x~{Wfa-!?W_WN-7Zrp%rM`Kf#0#eq4^&22KWm`b#3UFo>vu`
zN-+OB;N1J64T+AzrU
zUdVx4|EvoO_AWRgF57!6E^`aMk8`GhiGZj65TTysnq)X|y7384Y)*Hu;x>4d#eKwI*Cr2xQ@u-{Zv!=*?n9sQl61YO-|1Mrdy#`hfSy0{VLxbxKc3we_2V4odHIk&
zWm7boYc^5x*P)@{H`|me`V6&u8xeHRwZ;g`UW5_;RK$@vcKowqgiUvAaZ^kfo?f(H
zdm3auAtH0mfktDO_m5PR7fm7kk|w20#+Tzk9g-AVSy{Zb{gr>$ya;Vgd{|GQ2(FT|
zDwps_3LxyG&R4$QTDr8P#~1iAG?BMO>2guN-*34q^T2kf%8_rziJjX`C`uP1I0Anyy!fXpP(k)Bg<;xyoe$2!JYTH0kl)Fb6-|;*Rzmku$%B9N!
zwdn&-VGjx8VAL0#>lpSTJ|Pabeg%85@uS3NSu!8V%zpZx@s2`+CTnM{R|~8hI{0al
zV9AHzbR+|>>E6G@}-gNYv-_Z<*XEIqT}asAMQ1Rhs{h{ZeMy{@nfd`dpFC>nJ0
zxwc{3^ab@D0|NV!nyJ#M$#V%XHIT*81yy
zCk(tkmOdTMwc1<$
zVr5W5ttWs}cu(|tt!Y{W*F>*T`J(gfX@vyvDHRugxN@tS5%3gxIoSBBAYtTuCO5+|
zToWGJZbiso4(uRQwZh0x0WWe@q7MeM@hFH<=^B1hEd5oO-8ryKw?{c$Xa-V7Gh{qr
zrBSc(g~7yc1RKFg0CKCOMZ=H`x7#py&d^(!!RY0%!EPvgET2>kz$vU&W*q6;ne+sDh1?dpK`9SVs<1Te{^a_Ig%)u5s6r
z*EmdhI8NSypIFeuYVq2lP7jY|sMJBg9t)p2QygV&m~o$m3E@}x@o|0d|3-fYLd?uE
zTYU(ULBZ3tV2TJ*?BlA#wDR-vOct%^6KT-+t@QTfw9*^?5)&DUMBvkA!8oen+>Z5r
zdHbD4IP?JAAsdLx_hxN^kop(=^}isXU;bYS=vahqfq?qt22;RGwtt>}Le|shr;1*7
zmwARGR^V6ErO`t~@&6qW`IwZSOhliv0SzUh{p{&aAfm~CEheJ*V3!(=h-e%)!?
zJi*aV$j-H;jg#N8GXIk!@}bPXQP1Q&^{CK)gNAuu#bgoB0XF2OlAv$$1`*JsoKsLB
zpm&Xc_KcT?13!)kC^w++5~H6N1Vu>aq0^0o9O?Yf{Rsb!&yV{*$%jt;uXn|9#0m4~Gf^dTIPe7-zB@_7=VZO#26@YvQKMX(C;Ye5h$=*KCD%%eh==CP7H@qzxv;Ua(6m8#j9=ZHALikzU-PMi;yX
zPC|B^IuBV@#$>|bDXBU!Gj3{3f*W-)9=zGc;j|R_2|mOh7tNpG?*Zr<+hj$Nr?XPh
z@9B;Z*GVnNg$%REF{%!&`NWXx34-5p5To+GdW5)vj8@BX6WiU
za0gJFZ*qFcwf61YBUTU?g?8XvpXwBq(85FNSl>&$t~>Odm)WZ~E0Sp_8Zq__B0vGc
z)*oruaW0V@!I2xd(tC|dVH(WZr4kkO)Fx!j)QH~W`tiQbQ*2`CS!rn`n033nD?1DR
zb+w50v))_&>(ihi_3zsO7}t<49YYC4Wr+p_W|+o|_MWXi0`-e5hHy4?i2cqZxZX;d
zSInvkr*cWy>@NVdu;iNZP$GF2EW+|1SJ{?nsgTyihA;z?sKEjZ@!*)V6|V`7en1ioXP1atn<&^S12TOV0;SEzSQC!e}Q~YP%5G
zX3Gz?xxSB!li7$@HvA`!j;dBNdP@HSReCAy5AaFlSIp+z*_nzX{D$5H7UwI8gW{z-
z$>iV1FU6rlw(*S^;N+d(ZW9n45j5LZ&yX#WIHB2Fg`<^J-!>CLq!=!!v`|uxpJLx^
ziv|6YH<+N>h!Q0u?GJ?&Xjw5)SJvh1vj+r^@B-ng!6yfgft%cK=8XN-Jjdx*QB5s{
z_ddZ2+hneXd{%H-;#1=4MTyg=<_$ZY5Qw4LB&gJ~=9SG4Xj97McPtKS{1`uaa($W1
z=l-k2cv$Vc?Niv_gBJ|)#co>)>*mWRTRnGxId+7J!e3_jxa8__eKHC@hir`b#dbxF4hu!C~i28KaQYp
zNn9QDc*~!$4yK=+L6K~vw5ONapz%54@Rna@4fhaJEJcdS(owlfJ3NUazaRgpA+)-h
zOmfsm`7o-VTu}Q#w)!3DCZ4{wHnw0yPPC8+whz+hf)SNo*AoCXmT4KW)lXiHU`btJ
zJxAq!ysjpR2pC=J30)_Snpp(PcY7O9psFepi{inHLl|%gndg|v1ZWY!65ray$Df&n703q$1xfkvtOw`u+ddJTkI+@ENvh*W;
zC7wR&Z{H_#+ESZC?evWB%gM^rzY2fTM>5Mg77(4(j&PHhUf&i;F=REf8s7iLdcqVu
zg3KDvcw#VgB-Na{ePSSCy&<6sW~poxL^`9kE%<-|hRV&%@sIe(R}z;tC;LjnA8IVf
zySbIIk$?44M>7zdsb1GzCV0v1)sXU|F%Oy|FE96BTo{MwC6+`Y8(`XSAk?cv<$dP#
zHKFf8-x3-alE%{n)E$oYdMS%iHZG|0l9w|Y99rGf7K%H$zWFsP(Rbt$ciyx&UYWThCTBo
z+<*t0(~Fl1paEeyT`R_y^+=}FNP97}ycg2v~YY_-;
zKT0A_`yKb9AlP!hc`tsvAAqj~*~4`cKm8+iiHO8|3qojUXBgFsQ88UpchZ!}psB2y
zwh^Refgot&?U9t3#?Ks@?TzO%{45s)!NJ+Z+L7=p@8z`ZK934U(TtzGlkYhpn4hnU
zhsAL`Mlw25uE^mo@|7==uly7Ij|VCtLK&AGpB1((Dl*oN(s7<2D;)s5T5FM3+H0YW
zGx+K}OZzjSg(xCdZ*I%c*VTFOb>S9UC(}A*Z&z7j5&xHVur;YvN7tp63$+3gfT6vQ
zjIX;Ak)ycYn&L#0kT1!;(}u7{2v=n%Ay
z+Z}gMFDoql19>J-&ztI=#WxvzI?>~zRQl)mNjm8{@R-i)s
zZ8grj_Ov;|9_{+;#+S&lml#HBuJ%$_6Nj%tc3AyjLK$YR7Q=MhUGVjT9n$?OnWi2LeW
zy90{3AD^_i4C6&o(xN**NZ>jJ7ec5L81s6XRFRp=A9WF;8;%wl*eNfTck9l#$&7jY
zJYyiss58Cll3|+au}|}z{YhU_V5ifG7G>&o>CjL%*8b>Z-Uzn!@A(ppb%_{oo}Nu!
zKJ)*gwLU=b1_fnY+s>3Y_swy=)R@yc-IUU^z&LQ0eVV)~EHyAz>2^4mdxiFadmha7
z(W(qx5DY!zy19iReuna=v~kuBKs6b&&R3&w;6Dv1t(C|_-b?ML$r|(x@Sm59cestE
z2^fvJ<6HyV7kU9(bPn539uU|j{aYa(#&hp-5&piPzPNzdt|ov
zX#a(gxo_-o-2&lnJ?NOnbp0J*C9=XIhXTNEYKDh_;#TqZ=Uapn<)uyvol8q(atv}Uo
zw6se%Od?8Nxz$d0Mc=V8a_O4dXvB;$Tm3I)`dX|=!!$;kZlov}I?zrm$~0e~Mqb7x
zXuG_tYw+<3usqE*5?8(ZPw0000nIy@AK3vmvWR^#vN1NYDh^#^7;}`^zr-}L1Jy$<
z)f{YO4CzyS)+UTJo*-R9kJv{+W=giZDcY)H?85+;sM6iPrE
z7_f^Xq5?bY)e{B{`MUN+jdX0zyqWal)P$Ry(V<$KbLDO$+eY8Kx1Z?B4@*Cw2`e|gzBwc$o?}l
z3YOeykNA3|THT0&H3_)xzLXTk52JqDG$>PA_#N)AXNIox-;Q_dj9K($4xBE$`rLhP
zomqE-qOCK^j}`A`od>?<2TzB+!YtT?ufWc}0%!snFvsmR*0)8+faGa#HBK?x)7DlE
z7E6o7gSjF~F38Mk8K|4WXJ}s$8LK_y+8X$^RQ=-^clc!+{MzuY=<^4B7Hm!FS>pJ-=cU)!`nI}c%Vw~DSvc)vCYlMsCcf6J1J8=fk
zo6I#jh9F0vSwCfhukxq*)4lW04OrS
z^7Y}&?z%#5pWtO!6nUdx;0JZAt2zKX^E-{7=<;Jsi4^nQLmZ+P7KEiL7jD=Bpvp5L*Q&Q|R
z?ZvXJC8GXPxwc`-KvG+&E!HUehFfUV+(WsRr|}5NeGQsdJ@=S!O{v;oP#Tg|y5OKO
zqepQ?EUjAI2xBapW&?`u}YppwmN6F|`EvPIBCV`x;g)=M3l}
z$52dti2Qmh;K^RsSR2<#jBE0S+=6LvwOU+TChxw>>gt0(+kr|2nv5J|=UUtNUTv(Z
z5|EEEg}-8U1$)JUDvbo#6HL>_b#OFztk(^!5gyYvdc~Rr7c9=(w1S=$l0mG#Y6;RU
zL>gO!WU9t74UF5T@VG*RdA&y4vY<7O%^NL7lgrh1#oualapJPz|{XY!VJTB%mjbrG+c_?B`=YHl1I`+(bvBhK^Wh2zU1ijRwyy~rZ1Hq$B
z8!HVyj)g9a>Vh7AxTepK72E`nN}>K59{@g%j5TmRg(@?^1_9^X{2sI>$k0K@fKWa^
z&`rE{v|-rKz?Yn}>5E32&LOjdCycE@(e)roVomrgW?O{aGqCA#3E1pqcn?!6=rvHv
z!%RN>h?#TR>4mk;ooty*skpG)!buiD%h4AIwY8VudE~oBv2fvI{1yhMp5aT3wjvCE
zhj$GNzCibWGA!*F6HAY)V*{+0YT=UbIGnC~5mSIy{RnN;tyrZ7CLSUl0WIo`C+aE4
zW_Fxqg5G2m+}_QiHszf)Vb
zCggK-A>FsL)%T_ukvv0*gQd?_=B0YaL3kEXS(V|LvvVUa=Q-%c1Do+fn6F}OxYv;0
z3g?B!l>hIuRu?%*OOd_z>3MeWpufrm1Y*QIVWUY&4z}$LiBu~q#Zk$l(rL;df
z#(oL!rY^2g;v*OI@NP|Lg1n2(J!AvR{<7?-os(HgpmAq$0>csb+?2E0ocv-*sT}LX
z246#}A5+$`X8|8=50*ObVuKU)nhYFlK+tw5vOP%pctD`y?|2J&5|RAQQA%#5tP@iw
zJ7fY15Fz`sXN>Bh*U~*Aa5I|4PQ8}4LY|=Lgs&JPLap7@>!Zzo<8V4pL0;E3&Lz<%K|nmTvZB+Q
zY~DJ`u-hKEyRMT@8I!Up^IM>XPl47mx4WAPQf}*i>Tby$$6TCTHft_rf~d*6k0>>M
z8VMgM>iRRM)X09HU3@F`lSyD*th1o;pMj#!wm}Ihor%<`&)|u8V@Sao?zwbB7$|d}
zfp-2^h1Bb-ywkhQy@U+8e>IlA`qdrZz5wbi@-#M+(O$HF;1
zdaQ^KgnQ9Tj-RrzL)2z9ae|HX5sv0=H%i-7j(tbd`HD21$ilzl9w}|>zpUwFQMUzy
zqJG@L8EI~c?OzJ*oKx3Cz`Z^q?jNW#=uxB^k>mMHfRb}5cQ{ff&;vOrS()xYy;Y2S
z#&*Sr$>H0C+i+7GW$5#$SS?gkK=}3kd3OP<%(a8$e}9|qlP3g#Q+
z9ed-xRoo^Ct&X3r_dd9b{k|>D{+uIp;SG9f=G-!)@c8aVMiX<
zaySz{jXnVX%#8V+l-5l3ui37%$`?6ij{V%#!k2FY55YGN@ACfd-I;^%8flQp6DbO7
zOUI^3Me<8**exYdoLmRdxcN18W*KALpwNn}#yVlOwQQ5Z`EcueyheEBa0pNx3I0Uc
zRgQZdknexSkpAPrwd&u`w8Gsh>JnGeMteM<5Q~cr6HPc3tt$K@lXm&s#dM{zd^x%*
z+Ju^JDcfb_eOr%rA0@{aEO-utCGNv7fScy%`aHuA*B$QiiRd$2Bu%Rzh8*rV0L%se
zxr`ZQKUm7l;)!U*N`sWLalolxu(VD(89pg%MhC~{#M4R{YY`CxR7b<<
z)=fZptAp@r^9urNG8L81P#%sFbsyA(#3jGMFzz6Y8dly3snBcUFkE1cf0`TBSav*c
zf~FvN`oojVgBFPZcjkz1j?C1Pv_!3(_c-C?BfeVU@9!~gJaZ7HJ0efDzxVXI*4uOw
z5)*}%r~!cG&w;Dcn4aV6;dVypaxUD#ZN_r{E9u|+uaf>1NPn^+W10QI55T(%h>BGs
z{h#!fE8kb}Jxk`WHp;6hX_G0rrv%LRa_tHiarZoWY`HbB)j%MIN)`VZjf;g@;a4ZA!)
zffv+J@Qhs^_%8UTWeUbOr{}27`*3!g7U5;6z;i@2fFb0U@(rOX>-BH;J1PM`oL#iV
zuc}U2^l3T+ao3$x?Fmhzj@JW_l{S9pP#2eD9>YQmZTNvXrix0*g!l3Py-PJPgT%
zpLM#yzEfhNh=UGHDe!O84!23hrb}omk*yxYE~Zr0T6+VOfCC=&mSjs|^&O8i3>Ym~
zxGnBDvbFwb>p!lfL(3sVSszsIs-Sp0U!3Z~EWj#qhI7%&U(t%nmLNplkn3fhkz|{W
z0$@MYtt*6#r&a1^Fc?oC25nGA^Wiwh6QQimw@qW&E**
z9*F^(-szXFw;~;a+M>xlROgV^AqPe
z_kJe#dma9s?c4#zDLehgzSG4t_9rS$2!_+6+aRl2^zL&foKa5WZhKy;_zFD$|E$M5
z6P+%E*;muFB2l-*TpC`(ggPbSq~>Yq>AcpGVC1I6FEz;PY^l)1nsk0|xOSJ<;11HuR=;T}LGCS@i%x^vZ9+Em
z660UD)a{~CuVGxBb*|y%I`rSjk1Ts2=R8O?-)<1~df_U-vbvfpV3B0L>IIC2x^Ab-I)3OFCYR@~uS=
znbS~i$zYWeMCZ^1PfXr|PK`@_DS3WNP&?BLu)QnT)ttAzmtsF(R)Ot(G0Vf&k&3M`
ztDTo>7S`j#Z^Az27Gs=3Nt3s{eb6okj>_pV>DIxRoG{Q~Y$Rzj3?m+}^__YpLQ#~Z
zc;f|XV>Ob_F=L*wL{+l@<&PlfL76TJW8lnIGCWgfF0Gpk27K90Ynuux{u>RVT!5kd
zZcFbFd%hke|2vrct%`;$66?;4x$IceHxKOmo(X>?%5Tc0UHRL9UcFWg8eoCh*3@I&$fc6Y&@b-jZ1&U8%%TOzg#PNb%PMYC~ibH
z>E1Tx-@2w`hT4?gHdD>@uj6hkpyr^U9pb}nBM-w7tM?D9Fvncv5nA?;1VAB69S>ZK
zu_Ac7cheHtP~y$?;YEDy#^2#&^-|GIRHXG}>wWr=b0n$jhx*fGL`1H)(GeR;u)Lt3
zi+g^4*IjoNh@_OdGm?`Bl?bP_1+|GwgXo+F{w&~%JOg&-lP2c&s=B4kEjh+wcoTxs
z@7iPi_6~u1
z9|8^W^aTnXiJ{rRpn*>MV3$g);UR4yV;<&VccmW`rPoPz;d!6Q?-zus$&0^mlI6Lh
zCyrJ&;(Q{DuN@-d#)sohOpBMk(%=2>0=FV3_nACZrKCA^ODRrLPp?>q218n6I5Sv;
z7iA%yU=|{y*n+xEcs|xUCUMq`>;Y=zaJxbphtFui}sas3>
zOY-CSjEzS!*OKsqRzPg47p{x!9;&UCU-<<*Yfe#NSKi#+w%#paH2-Al-Oaennv)ai
z*a7-#_$83Appm)!@VVGq&hCZZ{dAh~yZ8QI!5_2d9pZP>F18Zs6?HDd{0Lr>J${>e
z{s%we`35Kh{y6@7dcKn9g%u(fy^@DixS3U?4h%Y#^0yEDv=qiQ;jPi&2H(0hAsHsC&B&klEzV5ny99iI9o1h
zJZe)W#LjB0@o#Tvj9}JtFNgPog^IG1)%kF393@_*4n;iq6
zcKNRKOP{3QG6G-t%F~l57T2Q}aA8%gn?deVa@}62zwzL(d{xHkWebI-N-N)sx11{~
zGv>|DX^DE@>Iev;TOvw*-y|?@c`jfri3S+z=R*LK
z+}){m7j{)7%hT%TG
ztH>F-FWe~dL)s!n?u*5_cIhpg>g2Er!1wka=T53cm@>B*=A8%-nSn$io@BM&KZ0MO
z*sA?n-K{tB4EKxpZys}0*DvSDdg4nqk*MHpCm0LAi}v5#@8%`wRu=8=)CO*Cn7rLy
zMePp<5ikXQjD#P7^h7F(?;-i$c{tW_$qf3vI%yw%+r+-b=xc4Z`hy$Q>kw45
zm_GXxqSY)QX~!#wrV*bO-^+XqgF7DK<|TG>@yBo8%gskVr8iI0P2|yaG7g4x+>z#?
zJME#vqldIHYv@B>*B5jxbL@@w;INN%<#jc?2cEG9Ua&-;A@l1}JqTJj)*e`+2V_p%Eh4AB8rPGMh3{jRd31)m
zesH^$Fcjy^++J73a%&cT%L-=~sQD&21A2Hkw{Ow4hlYQ*U5?|ddBEDjeE{7FVks0k`AC?)lBssDbQ
zc{PP!Q6IAV7zQqzpbc5F7WU<)g*_zf)u`m9(SR)OHFt1DtGQ@;xZ?5vbHkvWs7xf&
z5olB-Rt?Daqz2@2+OFStXr!8IA{zJCC2=V#+O>p*Y70Kpd?<4O7S>9slCsRaZXU6yr7SRwNl^GA&qlu*oOcP6%ndLH
z`W(oe569!NL0%rP`X0^6hsZi+UkMzb9aexlXC*gFI$lyw)E(8ZpO(=;KU3!!i;+tDbg;~fTmr`*BD5}b)U1b1^A#8y%->1Tv89kIPFs#)LX72>V<1CCUQ1h|a!@!mg!{
z#2Y?D?{{{hwwGOLotqMleqK`eBGsHI*Ct_2{6sjb+d6|4|Q5w1QO7m9qe#tgqn
z0X?n0tneO&F=UyeRV8m-*?%CT5P+6%w?|nvtts%#;mi=?GmHAaBEBwd4RCgX%N~+27~*B=REN%-WN8+MpTRKfc6!Df*@%%paQKQ5p>`Cw-$E$MRj2bTF*pJQvw&WEQ;r+>N?#e28CnEMIZYczG4^*
z@|>)o0fxNX3|ACI_4A$vMe{ja&f(4c*_kPm*e5wpFX8J4VDp`|#I4Hoi
zj=)U|cI$6+rv*a1n4i+98nL5gwea!@)h?1zH9IrT>g>w=NA2w&%ki$pr>5blusxD}
zSBT@NT2Nb+NW$8H7aIo10eYP=$%`U}sAyAE#Hij3=G<_^mx`N_q}h{!D=jg`uGW**G)$k=t^qzT4%qsS0ZMfen{JiGSQvJk*6C|
zJHj8}fywb*^Ojm=B6&+ol08k~7r|TMm(pOrp@{kd_-}MHX1b+n_gsNQctufr*iAb(
z>2#yze;x;RWkw$+<-uwkyX^ipP|>tZJ)E&E+(c=FSfo_D`YyVw@)pqhYYEaVJ^HWvHf!x`a6^F4Pdw
z8#&6S>LffC78>5k6QosO`EK!+&*6s%U`l}ip5>C2T^G5F3aC-2B9EmPXc=2oz>spN
z=r1?~=CYH~Ev&IONTZ5;MTA8Ko$NY{d03Uo|aM1|V;4qlm1+Lye?FlR+pj
z`>P84|6M8Qz3<{RyXVoC%;!sm_hsN`bMO}hh`pO^^AzOKQeGRDu>vNO@+l_D1pklcs6MwZ|KGk&ZQ1n9Q->m`-GWOqJ{9BCt`W(~?&6LS#!5R01%ReGhx|^R6Fv
z4mi0U?=j;jWk9C0#BMaj){^iDyJVxKy0s1T=xCq=e>B-Y@XevG4E%(At_Adg&3m)Q
z;BeHw8hyUTXZTc=F0KtPv5RZNOPN8zpOKIATm6Xfm(mc2Kqbz{)J&XZCXzM^SR85r
z8@2MqtM}Y$8yPZo(gAK-DJ2)|xm)Md~-d=C_rrAA&u=dHx56VU;9QKeg
zdkYiQmUhUh{@G)3l^$@8glUxHy&XR_t}7Z=0(d0nEHJ-$>CeMoGrz)oK#eeh_q2MTDV(@U3*DfyH7GQy4N(M9ru
z1r(2OsXJbK>*gzt2Y+hv)5BW+R*u*D+Qo`ny0)az#Wx;u^UvYK_bmIj*CK(@NYJ;hLPN0FUS
zw^yDw@USJaE9|ydSFhG9Xoj8oBvWoa%`DRQbu$**G}%LV_sR5{K5dcghJt51GiLu<
zt;BiKW{Op%Mdnc5j^|ofn!a{^TW0i>n06%$&@MXK;zYm^*V=qWY>T6|fs!IA=djNq$xxN`#DSQuFS32mG
zTR5YyRj@;fz2&7!VV3dW!WA?}VHXNItUy0El0y?t&s`xsziq(_embL3_zjx@NAJ63
zG4Gzgkkzd7yS}#Cry9=kUFrzo!?NuS#=3wpa>Hu#KxT4jcAP;JSj7J
z8jbh?n=o)kv~{1VPSMM+F&VwI@~ktdE7om|XlGC?*cd--dXl(C*Z0*S5BrSS+jsW8;*U2y6W%HQcx}xI}7Tc{KAZ&zTGlYl*tjtzl
zZJy57^+hQ5w0g{3xK%7owe3`#TYFom?A9Z`zpei__Yg?cVFnJ5D2U^A$vI`*@h6wq
zVr^t*LweeC_ntbgqAtsMR#Yw;UuH~oweiP8Pl7*Aa{Td|aZ%;2xSD%6Hw3@ojsAbt
zD73rMx}E5{ows|p-!f-;(F7BFP)Fh%jE7*|z*$^)x*C
zSJs;HuJ4g3;IV|+$Z%i<^(?ICfmTu9sRK8_A|SsYw$G+mZ}(11xH
z3Uv3^X3t)Wfj6!$Jec;#hd2xVGTjB^HFs_?`#TJ#NFV9&HV%^{3-aXN&l6Pr?#;)=XLMgKFJc0-t2>T=Sg
zR-4R0c5c5SZbk*H%+;{16D*`-x2_fDG67V@JXUyJk6339Eh@qc)t4Ji>Db!vbA}jA
zz&65*XGc1`U|y<&fYp?(-qxYs`6|q)0g}QD1`1}_{coMF3E#+Veumn1*`051?@_Kj
zN+7xRn9WzC_84k{UE9H|X|6qA?QwsWYj2u4ovrwFG+saan`IoF2QG$xw~?+5gXr_p
z=(8>QJetq&LH-jR6y%-d7=Un(p{7YF`N1E3fZ(T(orJbglxA?@`dILnZ1rB!tF;le
z0>Ws*om02T!o!PbnJQ6a611+M84+b?Uu(C%`hCXo^)=S`jF;M`wdMVI@H^$A!Fj04
ziQwzZwl|qPNoRCD*;7jC;-G7uhLh>iC4RZ881AC#Dev?f9>p>m^h+OCPEzu0txf9+
zi}{=`Y)a4V^fQ^ouA_L`HIVt8gb=dtE_}kv{q${aAokcPe(*OCsR32`EH|9r>FqOx
zm#K0!d00oM-}_NnEO^`G;5NzjAq@R*rrI(yrW-NLpUibn>bZf(
zkwjq?FbVtUr@$&5p9VfU0X45L?Do6pY|#JH^Si(Q-~GnAvFPH%*+Z5w36@O1vxodA
z)FJw6pGWyxIO%WYXU|8C3*USN3wBXT8C9+V-Rj2U)+{XC{cpc^#~Y~oJ+n%?vvK?1
zZ~y`%ws{xg!|#2mg406$#_>y@ic=k`Yr~Dtb6#uIU++idPA{U%8xB(Uo8OIRD%Qsu
ztCo&~kYX7&Zzf-(&3A5mR(cgG$G~Iy{C&Y6VI!v{sP2vYdeGjXgkWisao~miD2~G~
zGkU$>cuLjMvGE21cg~1U?n|IIV-2ArOaJa3|W`FZX8joN42IJZ2Pj9aBmbZzD
z8+K3>i!sqx*OnW%#2VlAQYL@WXY7)vZTUXNKCbGYof%E+>``y|aC>djuUBtOdq1bNV7+tmHXo@?&y9}Yig!G)6<_qd-P<#*xxG|%bIP5!}%
z{W4CM-w~`{*!xPkcmI}VwIbg^bMN-@R(4{`6WvHM-zFJMp6w_N`P
zKg4M*X-+B*-fT&qJi4{<&t9?=mvl?8HJ<)#6b>w>b}4o<^*P?>d@$#?DVLw5k0+5-
zL1}u%XnY%f?{l?isAkYL2hCL2L?!Hfk8`R|A={uCcRHDB{IxayC2?#F-K&Nyxtc_S
zZJHSvUrf}*>w7q_a6P5hiP@x8c=q9?1G3e-9>%n2POd3!Ay*)$qO9qr%0>lgw=bh|
zV>rLle;NM57*beOP$gdq@uGOJ9(5?*u&J#hzrZmOU!~Y<%53bD?uC;?z8#pSl
z+3@XIaBVZVHd|M{`~4lsXIYC43j=?LpL`uph#XhQ&VDe(_geZO{)!rQ&)SH4Y9wJK
z!w>-JFOLqcX3Sr%3TA^S3^%x%As_7r6gspST-~4kGW=?k#`Urzk@aqXBj0Uaw%tbU
z52j~V=0@Ec%m!6_jrxR9!Nz7bDjKTvEex*S5o}~ahAPjF82PUMryR5w2D3*oKsT&8
zkN3wLUJ)m9QHG5|ms@`(gwOHQbo=P$^!32M2d1{RhB@Hh-_;zu_~Hj}P*@pJm9+W0S+~k?-Z^(LUImo|`B2)iekE+jq25pks%Se#lIo;8@JLJMvi1
z!vH@7_}aIeZXNym9FD=eKsiw`hnI6hh>e3yIC^N0u=t=gV6hN3XdON98K*C%%lc-G
zRtq^)UDd-6;VSNE5S45#cS!jf4k<4`IWu}f_;^wLe1~^VucHC)54(;JcjV$!2)R2(
znGoB;UhY*V8c7`ck)8G3bF^F+gVuj@`qa^2ODw|gX7F3s5wrv6Q#sXUHgFYwx9{RN
zaGu={e()18p9=mORy-bo_u*xf_Z4eBbx^=JMmlmw0IldVY8~5f%w!e-ICv-Y+S7|L(=xKX6#{kl(~csL{I1zj@ffy6&|9%jMv^d6;KT7O6{lO90o)yEq;5?b&fB
zc=OV;a5S8S2N%an<2v6vVNeG}C7&ORXBM7}z0KJ>FZ9H48!z7iBsd)k2S|2PEEBKe
z!Rx0%&$xTx>$mH!_s6H~h^S}$wOe%WHOT3B0hW(>o6Z
zbl2&b>?Xgj
z>2-aPJ~_frtM5usYXc9VPyU7qH`(frsk`CBTvJvfKbkz?93)f4wu5zq^e8X21Xyxf
zZ198}Z#%ce8v5~-jnDcA!^-;nhMh6a&YK{ML7q=ct$>|uME3RtzV&`XsBoNJLkG6n
zO3c?~3mvcbUHfuuD
z5BrZ%JnlIF{;sxiqRC|zbM6Ih(DoW$>)2#~E;Qc_K79xK+D(`kTJlCV>jxte!?V?&
zhh`a4Jz=FuHXmif3X9?L1|`6O$m$PYWvf5p=d6Bnw9Gp0aT{&aK!RU6vl!%f
zFZ1gi`XhU_-o3Wozp?cezC3tW4qwD02kv!vf;Bbp<8DWPr^~Ge{WUQwClD&1`8%uFz!DQ@#6p
zc!NEdlVZV+SaL@;vED=C7d)mO3No>>@r{nf62C)VIicv46RJ9{HSMMGy~L?VZ$14_2E6nM
zKYhf<2iyAzgYEc=ZKbCkNzZQM@wz5LGvO5e6P$}!kB!^Kx;~1I{ndGN@_nbTVu9z>
z)i`@GcoY9~MHE6aYy1G0AiHL+9nlFuIBF+cY(-P3!pF7dAm*^zeih^r34_J$8PgCdEOT7w=G;=X}VvbPAfuTD&5
ziAxfA0>;dGpXgYodT%ydu8Ik*GRI!DSiGd+NcnT3ROrXHGplU_-Lo?leLe@kQg_R|
zbV$Ab2+(h`lb`xy69bHA>WYsH>*i!KPD#T7bS*fH3EtnZzI07n`|dLBSiBV6-mL2AilTR8%6Mi4dI8iJ~H6
ztxDah)hdM<#iA0NOl3Nbq^-2tR*Os3wpMMcNL7@u1!z@3MclzPV+3&lA};fLf39=S
zmPBix-}C+bos)kWBk1)FCLbNZra|qKP9JQoD`)0Kd{+3MRr+lE%lj;k0_V450w~exG0RTF
z#bxojA&aq(9$)gP8_b5!iR7Tqm8pwuGdAjdXPhSokexz
zDcjs|O%NibWR>fJf*G#D6PX8NFAbRV59H!&%?VPQkf
z1}`>S05?V(eD>`IGWo=ArNmfj&BsdA`jTvc(d`4g8}HHs;pNmrZ0PjOsH2-Ox};D~
z197tG!Ri@(q83e5>|cK9^!nU>xW&O`k>FC=)8MkxrGm>Un#{?M{XcZ|eye)@T)lTL
zQN4TBb+Z58zBB^$Q$6qRo-ecKvv?jUB`r`bmyM%Ayp}p0#L5W+##ghdxJe$|l`VhN
zc{pHo&-9VDO^4Mo4^wx1wR}wC1X$yedf9svx)w@&3wly^@53x~eA!Se00Rcy$&b26
zix^KR*=y_Gy^8`1sHuOA?cdIg!BHM8LqP~{eC+3A6!t398U`c#{ujOn6I?GA!XSC#
z0FxBAeHds3kpNliSPA+?kIJ5ARO{G9EPT*AZgHSxLkW!^xNzEdBZYijaiLfB62$LC
zK377x{)LX$0s&m&T^9i`l;F8^BXPqT+UAcacA4$;^}g6ThR#-}vduzQSG3=W3aoPM
zfvJ{NM$A2gDQtA@osb;!
zW0yS|&atcxY7CZj6koAZ0LGPNoo|!;rjq+;VVKwth?`rB|15kU^dOkH0*Q2Mc;|*h
zpE`_jxIYO!uG7|Ms-c>XBd-P%dsS*TAF9@!cFbO;7Hy#*_wg0vU~A7x!CG{{fNs8tWhCha64YPwxp7Yt?HcK|fjD84BA7QJAr6XqtqDK`)raAd$CFjv@_LcEY
zeTl{c6-=cF(|kD@=8r(@O8Ef^?-__63n-Rk$qn3y&Cuew_1>4U8InC%kL0L-UZl-3
z{UF;c|8UO->v^eDvTw2HXS(Op-Sb<2%=2?WUf#dTo{!);@O10RnX%lGqINADXAW^A
z2#=2Kj~DFQSWY)?0uJOuW|;}qWX%yw$Jvk5z?0)S`g1OGy0|oP{BZ3g-G(>x`7Or?#4!+ImzLLj
zZ}_zbX+D+*u0Fov_~giE5IT^y*B=w!;h(ik15F5Vj#XOF{#VVCAewa9r^G5bZ|=L~
zB(Q~lw1Ub~Rb1HCz9*WQ;H0k0I`>nfarZ+XpHNzCmgPEImb8jiL1&)0MOi5uECnfzOKS}1w>IAbkeFlt@FjBxhO7=KNlp_>6gp^GX7X>Hi-+E*;#=+a5tl1fy?Md^?`KRyC*w{
z*mirj6GYAmNP&BXRvEw+ywwK8&xs*IrW~GQDUL6K`d5>$5IkO46
z*zZtmbL8FE*RGH|8+~mSEmCJ2zUT}e1ipzGv^D*3s<7L8Dp)|X^ZES*JRW|eog!XP
zc~1>^qxt+SP;)vSx^Ibyo<}4^a#Zu~aGB&VA}m_khT$T>=Y{4GZ26+3UinRDs%G+%
zadpuzkO8LhOY)L1GtI=K9Xp0UvVGf^>1&ODqWTgfmw(3%?OVa~xUBjeky!MRRc({$
zgCldX4#7$7oWtDp=8{ao{a}H$`Ebg$DJ8|)46Dt=nE@iWM0<~JIB(-g$xDA+B%@&=
zzDzGw_~mXER2wQL^6s6sZJ4Ra?bVkCB!@*_vfeiwZ>Vv6Mmz_AwJ_f+#|7h0Sx`Ym
zW;EZi(L}I)(YSP__hcO^n}q6Q6@Ozbh3A1(-`Q$N_4fHWWa)c>km{fVj2>FgKXmnf
z*8Vi|Z2wQT*eg9Q&f(!&UMEg!5OYrUuXRnHtLM4~fR!6~o}RCB&mVH{|5?wK6o%)&
zw)f}jIrurXEr*|u49^G@c};QZVm4uWePP1N6BQKr1V{E+Hc}vtQo1-@c7UNPCL7-q
z$EQi}Lckxhp)D4FD1=DJVv{D9&)bcxw*1nKbE?BKUKZ&JKELT>Mf@pEG2c@yPF8e;g9&w_|u?C%r|nH
zo9k!Y&s7(}0EwmPvZEB}5{Lb?)|=On&+J@>`d7c_`DbCFpV<0M(ReO!M4hxl>4lf=_+}(GN
z@%P>~iXoY!0)DF4KkYAo5JZ?zwZDM$JUvdTXK7B+JslD>z!ub(>j9Uu;3(+Ue?3OXi!?&4FWL*yRrd6ucfTyS;6SY%A&{>0qiE2R*D1XNiOa1W`7&G)Nj(4I&m|a??+X!9@kp)
zV1<)E@L88;Vu#a%rgHj4{36-^>$ggx)5
z;CZ4~3ij!=R#0F3bYYf_KA|Hv@z-II!L^%XSKa$rO3yA&ef0rBO^cUPw4?1|<6F2Qu+9SWM{d
z;`tg)AkjC73AnY7p+)lKW6aPFD)&V1S{CTL3SHNtW25gZ#6rY1id1BOq{F=c)|5!7
zW{dN$aI}svnCkcP_&Pv$^ilU#^@5)D8$QQE6Q`9MruvqI>i49!
z5$+KxezPGS8NgSW7VlB533oA?Eg+jA@SO~3j03AYlFm+Fh<%HpQunC?bgUPZ=j
z!3%3na>6m0&Fug$hXx2OIJX#_v0%Z#Fw+27FV?2z7o0Ivk|KAm{angkx}+j7;u0=^
z`-4gnkq+5p%tTH68sT9wfuWW}zmyehvs?I3f;jEObXX<%7vpRQA~HK@e88211X}h)
z#&7e6?608u3<7(5L&F1!ODfuD2b13;9APB{tL@}<0F6)^;^etDM@
zyT#8809{bRTCnGg-5iLY!T%?B1Z%cO)&;q7vZ46dTmZ|_EMz8t#qZ+kTh)J@Qz09A
zLiyBFF#fM#^|KAA>tlk+shfwU^KjJXM|u6H{Qftof8f0b-IwA5i@X?YS>Lmvda=64
zG`9-XkE<3yB7l(EgOP}63$;?GQfPLkWdFWxhL?AUPd?w16+;dLN3nl>tAL+A&~Ej%
za}iz!f8Uv?diPRKrp@?Ed85wzs(t`i54*EZzOF^=^FW8Ub1iV2!v8qSYZgadN$nzZ
zN60#}j)`QpdJS8V2
z$Nv~?N7YCk46tdn6-5G}LtXjj$1rK3KUins3*eEPQ?_RJvrZWqXpODeCwn-)CN0}8
z!KS%c2t1}G?dK24nH|Mb-hlMcAB>g$OacB30TI6QJIQNRS$T~MplljTh7*I}IE}9t
z+j#Ar@V`^aJ(Q8>w3!9XAC)s#bWS^iivE%*zfR?diK+L%j@xfV0=X|
z`XO5B-+3bU-3ok-D+2LS{1&(x!&j*>44N(P_8yz8^zbw`cn_=(m0UQW?{Y<4rhdwM
zZoek`huyxq4jP}4Qzx9R{W486O7WGR0Q2Ees!ku4@X)T6%Cf^4LVbLf0B
zZUA`*!RTu8>OzV!tDj#h=v(115n^9asmq>ERhfw$LJ_y(=|Q)#Aer@5wrJhfmo97G
z8-bd2s?V(x_A5Z~_3JeC`tH|A8O^&{qd~bfIyQN*)(9VPTcG5!%o-ied(ByRMpm{z
zE&gmQF*$?n^NR){qM_gD+SCSH(Jubj&i+~RPo)R_5iQ2n|B1=$*z}+|+26JHJC^w!
zm`^a0{vC6w!lSR-|7EQpwv;cYjzlUXb3iM>BlSyCHy+lbZgA)IcpajgzaIOVk?|X?M@GJ5
za#s$Kqk%NaGlp>Q9Sh`wNe2G_#uP|SYYWtT5P?AA7<1L8S8(r(tHxH&KF5tlj1=)G
zGY{as&J!@vezVsyu7gngzoYsg)-40`?g9|)cU;)~RnMFJ=R{5^p69d7P}z64>llho
zyfTClqy7O3NBU;*ub{n@`a9D)9CR2Bf+w<7csut2WgI^Ix4#1fAR@90)%7a+U?4HJ
z)Y}<_`#9pjnmf0L)S5>Eq+cCVghx5se}DrLC>!8Z-^8({I(4MeFxhZ24KJLNpnov9kkIdv4
z6QzvT&ksO%ebSRE6pxY{o#^5Jg+~EAvi?IOaMAYz@nMw(;^%P0PtJ=$-{GNk86TZA
z+jQA)C{;3zF^XhrZ55Is27DM0JM`+~N16b4hl!Q=&T4mUoW3h}8oo#^?x8O7V$bj`
z(_~#@_XZOpX^+sKo^?(yPM6(5bJ%ry(j=llU3_6HopObgL@}ZRfk1K(&-ln
z8ABJQZsx|nQSH}&Ox6?`N(bn#k+u
zc>#UIsIk^jt$Iz``DvnhkXlSGU1V};efgMKmsSqp)!3S=`n1+|XbtUrC*ka|6%-xo
z7ey*$pkAcGRwy}Ql~PGmsX8g5;4)h|c5lhQ|0dB2>A6DV(Pt=58;8LbV_-mG2{P8nFm|1y+M!2DbQu2A3
zAb#skxYQT?@%P0v6?!UcbA^td`52e_fYziB*vL;}3RwWAbcaq>J{!8VtuG09QW~V{
z^ZQdWLZ$veqxy{j{l(9F6_MuZ;2x=Wtgul_V(lJL(C&J=bmN~uJvaW4ebZ2T@GUip
zKW_Y+qqQBysd=4#=bmSFPHSzOx?4v6sQnmXfxO_&zJ#J2Ajg3?sfjj`qC$Z0Q&6u;
z^>%diWcZjtBBki|ES^s0CpIta6;KZ1*0Oj?K7cd>Huv6sQM~cV`1FE;f?Aa*odl+^KtJ)5F2ASEp;NLf@WAu&(yYQg>?HohG
zpCJEJg46qnAGPUDpQguvCi2wQ<0?wR$CA~WxX7b~`KOl0TN6{-sy7W?LDWzMcA7JT
zCQ(ZHK*$d5hiUKA_=-SZY;!BK@=GZBLnt6*_Aln_Te@|0MM>l+E7>6Pdd<@C_f_V_
z6eMKjGtF&y8uI0$@FX^JTOe^!o1eJ>eCz)L#8!TrlhJp7AL+WoINBs+2{rj!{aO%@u-=X&0+PlI%ztNtT>$!Y_>R%T|ATrjs^Mw;awCp}Ptfv#4heUVWPY_Pi-R;UBshZI?=}4nT1@2QD*YVpHGN+{
zr3+|byqMzagHVids8el$;xF66_zrX%1j>T)H9%{QRfCdc*vuF9*Q(SP8F$SSV|J_T
z!e2{$DTdpZ5n}LK^G6GU5QEWkYq-CScB9-+iJq0h3O*cWc(Zj?dw|T7u>%>Og)+R~
zPZfn85?E|tfAimUdy2~IcuTRa19X2yMFX{mG~igQBIhpF?bpJ?rIZ`kufTDLmfRJaS>?GBZ&QLClOF{PyP6PR!yrVP*=Q!x9oW=-4Wm(zz|WIPYYCbd_jPV<2(t
z5NZrJpP}~vXH|zyrmTW8&SK+#y7scU|%)G@JO_E6tC&b^(
zTZ3OC!ag!4h-Bba%`2(Hz|{VzPZ#TaD^oE3<08ymgE4pA
z%cK@OCr{xFIDd}S7=1!mIESgc%uU@oDW8O_nMV#_u~S!vz0J|8;&64=-XcQ`;c@=y
zc{>8Ef-`|}d3rte1M`mGjYZdu&)WBmBwy1_sdcmenb(a2Leqn6l%ao#3&udwA?&@c662V+Ulk_B%50
zkkq4bw7Q_B!uejseA8ts02su~^;dVgps$2)mT#*r{@iJGtFZcgaccb8y69WQ(Klw!2gbS0%KLOSW<(q+e+
zmPGD${hp|&_)BT^yOd*58G@PRBCeG7npQ*3bUj=x+Po4zKUvGHxE}!DqO^oWubZPf
zpLRL@OA6Fe9$;-w^t!eh+1cBflbr<3xxWU8-1J3MDE`ahsR`g5my?K
zgW`P5VW8y@vd7`0Mkd~YWhZ*LX$QS4wTH|Dp*S(Ba^P>ICtbhR^l!cx42CGvI~BtW
z1yOcK>Fek_Z%HE6h&2?O&Tp+f-D8}oh9!7`U(IH3)l9ypjapxw+|@+%F_qJ@Tf&PS
zq1nt_B5ZRW)||X*ZQP@-G7wM6>d-75AVA_7leE9n(T}^gDb8(bhB`!s*~7s6)DIRa
z>amgLwc@tlgScmcNftSe-mDE9z42o5#9PC6qyD6H6=JiEV;c=*#xXH3){~Xh}!(#-p^oGy6j@mK2aY1tbe4hT|cAqo7{WbhjW?S)hMhQo+>gc4|I&U
zTB^ri*CA{$oGi3J`G=qPD@yRqj<3dd$YL#ub!I$;GWB?dkdw#PgVm`ziaP1@-fTt9
z*xXI|=af6R
zrM5gF>byAh?I*MG0TV33(3z1O39kmrum?uiXJ_H3_`Gh_rn=}m#eorLp@!OJ=p)WT
z1O2Yy_0-KQ^ePxj#@VQwQeI~QXv}Sa#NbclG<3!iFZO|ZWxaL+e#z
z*y>DQVj3g3h;K6XM?c^UI1DsU3I;49vVc24A}8V%
z`<}E&W1nnR+Cc0b(XH6)HBDyH#x(YnL~9|Fb!VpsJ++I}0`Q9vm%nF<#g~JLgBjCV
zC?Y_`HUip3D|Z2-T?FdTE(U3s$x$OKq+Q&&wVy8^KVfQ#WWux6YGWBO+eyCM`%sP?JJ^}6#{{T4stK@3wrk0VC@@8hMMrb$QNnc8r
zor`vh7GeSh7gzWPE9=g7`b^>eN*CB^8^Mj#`_4{VSnsofdJ|Qz&DHC=qJzI;MU{BX
zR+KY#fV%`k6zc{*g!F2>`ls=x1~J>Opa+i@?8{XEICYQPmxbe%cAldL_p07~R@AL>
zBVuQ%jlV+o0sEw0$sC4?m393(`O9geLy)%$V)v^Ggsuxs9?&Ubh#?G^`R_<<1;l=U
zxY_i_WW*{ExB4P(4H1HK8e=)8k_>&!`a30LBWj#Z&#>aeNqDI)2Rn5oBi6W5o&-Y4
z$xvUr6!CI;w!kbp36hg0`U{|qpz`+q$X2;2UD(`^IJzNuk5GywV4uNnDvUfRg)R3@
z0Lq}{R`I#%ebl6mv&m8imirS|r!>oPg~y!Z_bJHAUNjMH9nw(qdE|D@np7;yup=#-
z5;eXMsNpa*@t@+YJS~?=`x1tFl!n?&*s2?k^VRjDFE%ZrgFl{i^hF&v9_lcj4V6|W
zH=fy6hgfH4D6U~Z9NdGPaT`?Rwh$ks;fv{Uxx(r){RPc8IES`~jmq`6kIl{Rk2;#a
ztCQ={xPbk~n^H-jO=75!%7)^QvA(+wF)UGYLg1F*}f(k5J6}(2^h1%kQ-`4vK&DuK5wS`ndZEZ$LeRqbVYu4s$+Vn?KnmQF+y|9@>73{k!t8y08
zhWM6X^%kxu43bYzS7Yg<1ylaj*@^)29B`9V@W6xphLV1(k4fB>=vfGjeAbU69SwJEMgj7EKFn~mC0dCT}!)SR&^?Uge%eeq@K5x
zETCuJ>~ok(j;5{0(wI_&Ll=GRnF9HAzUn>h;MWa&PUA^dzU=0CDj$CN^wpcKOPh1!
z8K-{ka{Uz6yRx8OmFk_Zda+%MM-l;e9Qg;8P
zK;NXqJZI-!m9k)Po(&6Gy6jOnM=)`unZ*Lo|9D$;eeKBNJ=S!#jGcke&@5vlCG;(0
z@;jJitW0DMsx&T?IDDpXhAh6YF*Am7Z`Ikzz~8UL2sBDefoGHT`yyXD#uzq;atvY9
zifWrSdhzdQOJNBchb3$}X!Yb|L&mvSInbU1iC#BOmL=?ig=Qjyl^9#XuMN)iI_e9$
z;QX=-95RP-CblBLX{UQ
z8I@L#uiCX-EP2UA?A#U0Mqi9=`)c@7oZ}9&MC*ddvE{0RhfTNl#Yayvzpc0P35?=t
zYt4<|1b+kv0#;63)k4QBFpX`oO93v>RwN$1X*{qF)JzX}O>Y=bJ{UrHU%Kp7EJ+w`
zhdMbh$rbd8Nl;w=n^-Ck&bo;PXeoSZDE?-i_=7yzjn~O*Qcez2*1m1Z$^Kbb8_~+HnXJds2IoV04>_
z7yB-2n>va=PA)JYn_a|!+}{QSm&G(GD{n1b($WVA9Ahdm=3cN3ix!V$ua#Xb6~134
zyIMy5m8#}b)XUPJAa?o@mrU}SB=aWfL9uJvPzh&AuQJHJpp{RIo|J{r?J9_0GAT8f
zH^{H%n{cs{Ls1i@3IN1Dx6zBu1Z_dqD()GDC$kYd2=QRQ2qQK8i4H#bJCl539|__H
zH(Nj3nx?Y?#@Rdsn`~oZ$E)&YDdC$!54o3s9b!8)b~gPAz(U;Evp_pl^FY>)nJ(L(
zVPY3VMp-7khWmlq42Gq3@qyXdSY(KUBe#X+**SI)#RR^E^!9eGX*Sk4-QL!Z&Sm!?hx7KOuW
z5OlJ`+e6(RMG>wrV)FLo8+PiCa~Qfe0dd-8#E4zK&c>J8V5Uui-Y~71DE2y;C!LT^~Fu(_6zg7-kbMUpk}+*
zRHaQ+BMae|+C3QyAsICe05M6OgPA`z6^U!?abye48>kzI+ooiP4
zH0QuA+5sh*S!=E_9Zl-w={l!dPnXxEOl3wn$y82c$6jCdD{4P1$D%vi?KZLc!e{vU
z=6(f!K{lbnetY_1zc-1aMwbMf3(mi?YjLv~0xaZb5%Ufv#*#JZBB%)YjpGvn!DP&M
zP~u@3C>!FJ;o%xvOR1S;d=T~zCKu>&y6h2)af-=)2_RP>e`JC57ON0UJiL%cf~DTk
zckYRC?_}(kMzdbG$_vzqSvCG@D85=K-U+a;uzgZ@7z~<3TIsO=&VRLiIOV|HKKvP}
zpUHo+UJV48;Z+?OWD7d`Cpg!118u=DkL!RD21attN+a!!EQ$24+q$$kG9j<))DNiY
z(|hFq`>enH528QcN<7f|yNLcUX|>r|sAutWfT|oExvTx5+x$Bxa!HvgVqDN`wHjwx2RAE?Q>a$TyGyS)znE86;>)Vdp)H}X7>8J
zu5=M?VJq(!balO2(G6IImF5;yI#-pFDiU2AgJhOEnP0>+Z)98I#45XYQ(EWwuuH>H
z_VPK39oxu@KR8oD2=S;0(k52CPQIU4*$CK^v=ch+>0%03R&=1pR{!DY{{O$|7Omb5NHwJM}+e`hNVkAFKrc*^_
z3|G970`G{HbJs{HVvg&Lu{scrA@?`Py^8z80jZcG*;WOaA)&;#1)K`n3lf7#4Cs@py%yIA*+;?vOU>5nKd&e`HR+`HLT2Xp;2kNbt}a#l
zlzlIFVNgKT;7n<2k><+hwvDQY8V#kQ>3)?54j;4n4tC{#6=_Iz~q*&jv$Y1rL3-NcR
z`ze&$bmA9TDrp`!v1^cc2=W(>-A1V_D#J-#vaTT+X+u88e)&^EhMV@ZXUK7whqA%k
z-mDQS9x-ZUUl{||GF|PPiQMFe{gBP~_?r^#2k*^e@}h7REy-Z~qdRC{8L5zXmv`7>
zVT&%ARutPB`EEv^ev>A_J(O111Q5p0h`mP0_aQwah}B`FimY5#$cgSQ;IHct#Ztebs0+Wov!LFCs@Lr5fiKHB
z$w@T88sUp+_{mWddJA6~S&pw|)ko^U(n`6_bj;A3ZQ5>DEDEZdD}4M)m%V|uX!NTF
zTIxtwkqC0?abR2+4xQ?=y)(~!j&^b~z$S#iR0~Cg;P`n#r4_1lB}INL1N3ShMSjG5
zMj04i83;ISAmFrtpcs-^MJ?q{AMn`*!3n-Xa5qy6Bz%Qn@O&JX*?lZ80xd}i(Aw)A
zeJ8HVy^~W2z|*I!a!w)m=cmGfh3|p`_w$v-+3R*&oLl$J3E{sWZ*#ir&F9!Fd9Xi0
z^|P>l3g2yNI7RtY3Z=0>tBRzt{3_K2tz54v13R^{FGI|AbiS(eqbOZg!vg2GWqH%G
zBO0NKN_;MnX#F3Yy8e#;x!>*Zp*(YKEw_-Ca$1{B$@v``6jL{V#NycO?1u&
zain#a%Lj1@WBICl5Pdd?o+%&1U-5PRr+g4``9l?V|Nk~0#5zNF;(os}AH-#*8B#;}
zAa>T+z9JvQmg4^ZT|NlqUo%^}r8KT1=UXVg6j}3GIa2Ko_7F63Vz6d2b`G}}ye7$g
zL`lG*zr44^Yq}fk7hjGp8^ArIt6{ua$^iv)F5T
zRU0w7n6!dlc(F5B>bkARm6k;21ZoJ(3g7H%k28V(HN6lULmjr~;VwV$ggw}v{+Yf<
zNt25nuv)wpJl0r3iOG10e^vy;36ZyDk~ru^_5{Pb@zcpEQcGhDqxtloU;@jT8C==`~QKHfdw$)4ZL
zbJ@Qd;>+^WR#kmm=aB+le;sVGdR;A#1lhuo)ye}%+>>U7DtFg(5Gg$itgSh?(ra2P
za7vs!O)DOMe`|dy>wSZ*tFkX1lqbmjR&_^=nu?I<#bnQC0fOwF6&t4yr1#h`WKBOStI3+sK4So;bSn=HZX$Ch0dy8n?3x7g5x-CVU7k
zz_he$|we*POdf!km3$77Ru5@pc>e&jjx=ABjwtiq!N
zt=L-Qv33GgA|A(xFQdO@+tuHnGyN&!9BH8fbZ1dpqT>*-HfwxOq&cGa!skfv+`MfS
zoG;c$s{&o*E~~N)O-WTohT>ZqfN*=#ZBN~>#DKZQGu{4c0Q`*05PS130Qdq&!9yIs
zz;3fr3)%l3mqB>Bp8GraV0%7~=dQ^RO|nPZd$e=24Iy(Ml($vitZmDhHj4!N{833L
zR|FDAaCax6zV$;F4qZW9(I@d$7p{JfymURHZxmBLYkcKainpLPeWILoX;O&Y0p|lB
zm0Ih0qO{aPy6nd+5P{D7an1%M)YO3QB61{P&li-&&oXxm+@Bz`o+#CwZoQovW`a?CU~(9n04`yW6ntaryh(S%|;0+6nA&
zJ?gxhmP9*tBjFR7XzKbdsoVBSJ?F12D&?WdW~!&lo`=LUz+s0$22|Yy7+<@;4dPG~Pf>&&tT1`ek7q
z#@ugO*#0Z_rMvsc36rUEFxIC7YLupWc-MT^NZri0gxhs9KNog~=OM44
z%0iP=QcKBh{-pdH(ilklFPb$)e3mf)Ffzx}qr#jA=|{&qy5WIPfX<@eYAW6iyH2Xrg9{xvFMQ#q7%
z)Uq90eh4V!s3-PG-Z|yT(BRY0s2k6vlBZ$t56u6^O=}Nm+wqW{<@*?tNBqq9@oZol
zS6UKM*TDsU+xJxb;Khq<4Asl7+A*Lzjb|>?Zw%DEk^~`2=@{ULUy->>d7=_ShpzCd
zxwW$Fp-=i1#g~GwM*mR;Q6hE&tevrVBcWiS{q&9bsz{$Vl*QYY;+P;c7
z9l(^Eob7ve9@ZU(1&(Nf^mTl?>{4~X;jbRbN12B8!3c19NF7BiBzcX0ULHMznnPc9
z&$yE6EK~`XWYO9eLQbRx<#vLtQwv3P4B*2@b)TtmDn#jS+)3Mj{ci*_9#ewVn>9>*v-@w*brE`tO+Vw
z&W#~>f)Jz+e?|EEnu!g2Z03bsV{0O#ymn2E?
zv`CJRC16Sg_D^^`R1P~C&5ub`=p9})a(Q7h=jm0frk3Vf%bLWRIbVOpLL_@7$!J_fU9^lf>9
z!Lh!`BD^!<0KcJqog|4wd3;PraJec>P;eHZQAG=>FlTXeaUb1WPx{z&+0hJ5CfQQ1
zxvB8xkuC7x%2407u4HjamMmJTirgl4V}DF=YkwHLdQ9Z8{kH6SJthX-eq-*pG3M!1
zck_JA7_y9j{%>Q%XR5ujS^y@hx0yZ4#>{Ztd~fgXeJbS?Y}(F*+eYP>(h3B*S`f%rHl5RY>L@fl7aKDRp@{~p6l
z{Rp5NJRE+$kzF5$pM=5t`q^W`&-O*R-@?!Kzvq4nKilu%{!`}7c!R=WM0w+|Y>$k+?_Xo$AFfUnFCP>Cv?bL8-cnk;oFuSe0CyllN^6Oub;u0Hw6e#D
zvi*_vi(BE@tU8DreH#tBcYI6us(Kj#jRg7J_)KOWWhZGb5uP&{n7O5CW8vDwslN5rW#@
zJ^f$~L<PGKkw3C{$a}L>Mh4_jCLs!sccvJIMT8ua|v&uf6Ei(HFPBvylC&9*1??2JUProZvs_BR1ao9XYQ|J2{#
zmNP%3m2L#YJZx$IpbNH4!%~&$?@atZvo%{pbDAx9begMk>wpbL0(QyB{v0m)sn`Nq@I&>H^VU!{{^pHGX}6lEePH
z{;Iq7w-bZT^ta;c`%84w-+$ci^EP(38v;+ztG^riCA;i~d@55$uMS_vpO(GpVMyMY
zoAWEHAhS6NGsb#^j*5&r8UtlTPZnhTK2QGoK5wV$H(9?I-|w=1M~klbczKugQh=BF
zGaErK`RnKC3m4xPQ0#z=^GUJ==4N=Vb;}G*yF;V$2`S?ImGj&rO^cKL?AmhaOMTIo
zoE}#{^sV;e44%^LuBV36?B0@QS7n;rknp!GqY?KpEo6ScO!)~-of{r`TWZu0ey_Zy<_Oh?N6o4jzH;54FgcALj^4q
zvft~+68_|1^Iy@6G4iB!;V_5zfYGdPQBRsyZj6QW{`SS0_5Y9fz4pECdMgrj@^P)L
zYj62ja5#Ns@Ed(mCkeiee_q&af9qb)^*8j!F0<>$3JmdA0AjodozLv;-C9}lDE_B}
z7Il&jdh@Pw2{l5a
z!RZtuR_=^4oW7bzP6^yg_$;kRdav>k?yJbiaQ~re+UFR2(0k^vAJAqfx=!(XeKJ=X
z=*&o9MA@Uz>Ig|Gxy5)y*H9R?zC+Ico
z<8MOG`r@MNwBDQ604blI_4xWVxP)GEYtHz|`oA??njZA$H-v9_u0e+n#Dhq?fb3ye
z$SA_=1RczFrBL``zWL#yO4${NS)U1-yE9jP44(ceNY--!4-}Y=4-Mkfm*qvxY)F^=
z0Y(E+;a)?@U#J@Aa5xGta+5Wg-Txe#LHj{vbKU2AX0!6Nh+2HnprQwhipXn*J=&Ql
zZdy2VyRNG7ZffbfJo)n?3~uBpeh{VXrk2v>ky4({#YBz1v8%?S@W$3+ryJFkS{^!I
z-w;KbqywECljqb)F<3aiQPAK#F*&Q+r~360qdT}n?O@V3Z{}w1Dd)Q1dj$@fD(_)i
zuU9zo#C?FV$MtS}aVU9Fn?MtaZ#PZlDPR+->6l8^5GuW^O3~>=&Bi|GYj9@T=5l>2
zSlUpW4%JNGJoQGRXWHjBTm3)e>MLKE?#7FdgL$~%uSnzBZwt&e%Q(mTe^9Eonv_v|
zzA%xvKaJj-ty`pQ1~4zXRpmsMHg!IwS$O}`f8hknuc5<*dcjy7^K@^O^OoRNp3-q(
zUL8Z2_~;Hsrh}?&`dn60lscY=%_w?p{)rwbU+Rld(H1&TP`_^9>*
zzl_Uy533_Tt*|$1y*gl9xTO8wtcCVFVgVUnaW8_!_7QJj#?YJnac3_^aGv5Bm)N17
z2h^G}+uZVydJQuy7Zb{`&d$8)!UwlS&QF(}LKvNoSiH%rAl4oPYdUz~pLxtyXMQCQ
z%@bsBqN~U`nG=i^?Kif%>m5?VfQaatA75aXl@-Ji+?b0cxcOC9O(w5yf)S3QxZu5C
z<=&g5_Zq2yT^Lp=w%;fvO!inlQ#boRPVqm_a7AL`@
zU@p(+=5iAnf(*)+0_7a}%bcg+j#JUM&!KNmkysH^-z>Hk7O@NCyHzUAd>kq4m`uhl
z&{R2%=Qawe$cAr)`k4
zuDU$izJ+x&wjkfadKP9)vp9K8KgFWyTUhV0uX8nm=j`i3J3c|E-QN7nwHhAoY*$0$
zFUDUocX4z>#f3B9Xmrho_i)CnU7Rs%M>A%5P5t_6QYDx+T65_;+poytE33#Fo~W4?
zOmL<>@S65D%=z{P7JEQ+`)=V&quYCge+WR+W%tXHz_p*aQ@EO{egE8wkhhd)#tc&H
zjY@I9DS=~R27-BZ-M!dRr7RKI2q|^86+atcBM_BbcM{P
zrNQ>0t8hIZx*883*20osDB+W
z5wfAvf2XkIBhwA>4np_pI0ITV>-&|p;wcT@81AJ_5z}#Oh>K4lh_#%Lc!0g_a)~uE
z3WHbvTy)0D2b3~%7~;@DQD)w$MU>hEv@+{?B1h6VujyqbRg3T5Ytp?j%{Bv%Z(A3a
zMs~R{_OcgiqsF6RVA@>f?+L_HL)X}q^Bdv5c5r2Yx65+EvaVfj=SUPOL7a;c=_0eq
zu~nhq{zD~SY>pmBc}{4P7+15}Yg)(px>I&-4BRvc?POkD=tl%{g8{4qNn~H-U`RQ<
z(Jt&My<2ihHa3WuUPZyrI-Uk0LU$m0da+B?CYG_#S)z%RzS8XQM7`8}I17Gb##Ve?Vai*d`C;^S1|k^5Ej{w3r)aT5c_sB@2j7BSX-*-|zcD#UAVdw^
z;MOnpONzjMtOG2?&NO99G28lXcE&I8n^pIBEac$HXtX^LHb$8sj(5Gu0bJ#gzLvw5Q&fP>qI0D#AL2bZZsQuO>CYC
zuh4Ar!~EGjET9)1CNepC(T@(Zgx~<1Q73w_(yyJR7ftte6dn?}ncq2y>0E*(QZb55
z4i(j?@()x!_>2YvAvP**byowC&Fe0`K(xsyXbHn?XlW%ShK_b4i?B%H|g`yMk%
z?L-k6^4ilZxRPLQjuscEZeaPPJ7W_{4dr_$WjfV^ipbGuIj&BBtDkD&{;5EGWTjq3
z`6La|PFC>;km>w$Eh~lP*>f%DX&A~tv^m26~
z(Gv=Hso$CO`;GlUim&Txk38V6
zTz?&1``byLlbp?zbIh7*R+f`KVzW)|{q}C!?dMgX6x9~Yn%BR;W?UiI5SOY^KrpI^
z;Z2v_Y-SO=A1QVh&y@(1DEG)4PxREU6;^f4U#W_+3?qFWTid{NSt%tN+ivPj
zqiTN~d(oJ@G#!yDAW-WE$y=PSNkQqd7?>*(fk3n@rE@o&_n%&Rd!J{#)*~Zqf-aPXX)QlYXYM$U26hI`cKwJ@G??D(`n(~$r=no{U;St{~3W;*NH>DYTH4Xm}XGSNPTS?nr
zRtU~O#U#5Q)45C%&KfZrbP<4bv*Uldo{<<29XsgO4pFU1BI=Pg5wcY_z<^1Y3XZ4w
z3K4oF(%CPtFqQ~#9wRp1+uufzvqb>+HNLIi-m=>Bc@6tA#JJ9-z9dOXse@JV#tdj4
zvqcAmUZS28j?-noMwlX@7KyAmfsfc{MB(*x*@=Irjs(o7jItieD?~yOu(E&n9?m@)
z^TMQ7A3s1{*@5lkRp3T(y6m7oS@Yz%r0tX}SH9hYW0boyt<34}iqyBjqE7eo9YIl!
zWIrguL#Gpw2bF7^d_s)v4Wt!o#GP3dXn`RCV({`hyHBc|PW?ojdg=rBItmS3FZ0C@
zOS_-8#G~PS${=p5GeroiMc0e=LQF4E0)6wnD_+bp0a2zvi$I>b+Kox(FkqOamoyj&
zXJ9bE(l#4>9%Y(2Hv0mv
z$m4XcX3yG!O8uC3c72r)?kbd;6Yinzazl&Fw$w{gW!E@Pw)JZF`MLl3DxW?j=n_?$
z=YQynh}g;geHoNeOCS{7pw{@2$B#OBRxV;3nf@9X
z<~;9~f;$Ar2r$|7M66S~11&NtUG@TVZOz$A4A1g#!17B*msDjrh8Zj}_LT3gvX_CO
zwzA}K{0!_Ir6!nXkfji3DF(C|CgPNIrZQb`Pn(*tb#}cyjYJW4c^dP0aHZC;)8%P1
z&N5v7xebSf{>L9wDGUN4z~k#t!fVuK
z&T__kR<_@o#rJ%)n?c}zMs$3R#c0318(cjHEG&5G&$*ZWpqGA&zm;{7==AgH`J#~R
zqi-sY+$1X6#b5a}7?8oc(`dXC-gS`=Hc`Kme30*0N$$O%pZLiok`o94+?P%Zt^_o(
zVCFo{#)$WACPVlH@^9*U#He3lVen#hJYEt}W{=y4{gOw;{_ww_g@K{eAA~E_!-{B%jZ&auU#c
zd~)#JYq|$0IoFyctY%~N!rl@f({bh$B&lv-m-V*!xVb`SQMc1xAR!{aU&pj&><4Um
zFuh2vvA*>03^s%?XZ`tHiLqg^;POFaWWcr`B4Y{m!2GIX@Xz=+OSfk4$8En)@+=KC
zGTK5rJHFG*K0TO~X}>$SzM`-G9>d9twP}dU-+xX8nWu+K(5tYVpgbXeKlfkZ+9C1P
z4~aapAUo)Iu;!_$r?76-jGKJ@*TBsmknmyatovb%8M~w0Z_|B{D*=-~btW;1awOj$
zp!4O=X?K!*e<{0V=@iDS4mdGfudV9OKmdh-AcK}MAlef1brrTCza^tV!
znFd8cAmDQ2UkrTUwaSe@$ngz3>_>il0R+3cE$uhWkKah`jQ>uThm$HB0v$+9+3fsw
zlX#wbf}(ts_Ga5r!|Z~OP^FqqMA)0Ht9f!*F;JCENI_xBlYTTkR)du6J!k=#)#LZf
zJCSrD@aqKs63{ycv+_Y0VL=`2OC!&w9`7{R8E@pq@Jp7XeNEkj`M3>GL&M1?o
zRhCZby=sBaf*(?>E4ojb@yn7sy^Mw@xm5^=Z@}y3kJWn_zNQ
z=DqQm_YMNHT|Dw??f9%mO@2TQ^qdX`lV#p+$9q0djfb#JY2X`@V|o>zkn9OTTIWUO
zQVmrv4y$krVhi!;`$`GZEC@S@0X9p>4%iUZ#Y8f&v+TN!j0V=CZtNaeDHC&C
zH|@X4@TX8sJ4asv-e_F-;gVb~afP3-Rr_U9iGwAfxYX5`aX^N^U#L$%0tSTNRo%_m
zrL!Tyc&PX@KgamBKe83tnK9@oOQcweOoH*hBXTuh=4#*s75G(>+RSEXj%*>BHV5y;
zBvP+Y;?wWQt5#l;lGTfKvn1SmrprEgNXuAT6uH$sZ=aKqPxoiz73k|T-8YB~SFXsi3AVXzy6feg}=
z-K+xsdDTsobNx^A$;(!V+Yf6V8#PDANMQ9t;=XQ2d(KDV`fZ<2g?K1t8~Ry=3ZYORp>H`
zK=sN%%lclbTFxoMo;t?J8$+zz{T$T>ig?!_y`vj(1x8hy!uLQI`KuclUm&`PBcfV5FUOs++7{=Ub^sXCo4V@utb1djnn8KjGFa+SNaKDJMxZ*;RsVRk|!Fp1?Xc
z^3bF<_tlAR-t0RvuvrQWY*4ko)C&(;i!|iLUggcyJN(JXS0lmud*p{HaelDIqYfc4
z9ebM9H6?Yr8DIWqXLdQL+1<<%gCj%_WF~k!1GmM$8MLyoo%4%=38IUzE`lF;nb)La
z^8L~|XifK1H-3Mb*KDLTrd?VU#`%%~vej{S+?71ixoq=?ZwU-a1r5H?&
zW`pq#oDP?-@oP@Xf>Zgd1>is^?o&x>j?)Ga>C}^2{Sf8V4^&Q{Wb$K(ei+H*2fN-U
znf$2GkLCV52){nbHdBP=Itr|g3=L6PUEVbhblX$5==H#3jV?5eU)m(iJFKcI|X61s)1dX
z(FCC#_B_K!t}*-|2sZUMf1Iqx#oSgx9RsA6HMSAvjv3zZw2+#QKDzs5!Hfj{*L%POWxInma1f-yD9$g6LFG!Zk_sB
zmskqjbCtuQ#bSC_QdEd)&ljNDZK|}0qQXiqDx@H5!MRG6mQmErz#e8-kpBXWv$dp>
z?H15E+$Gd4Z19s{3r9(zdnKL)q$E1r(DBvUCucK4%(flWiIpF
z*V=2@*eg);-jowa(HK75Qa7~s^Ywih4CwkL<2iwCFNKl^uflIDwI{l`*f>qit5aXZ
z2!gfP;SI`{hLoFvC
z=)SG`fPoE|ts@@~3YFu`ql*=d@oGNIn*BJ|L2%yo`+-x_1EP?JupF=|537$R;5X}nlFPb|sZZ{fx=u}hZ^*1R6RprPi2F!4+L
z#~vMtuhopFt@Y?8up-^(9zQ)}6Q6-Ca_Ie5r6@54q&bbP_tUo6)@y$qO7uFCo0
zzNDRIr8{r=5<>)@%w$ip9=*eNyA)7)YFpmu8A#4FX)8H$=RlnN`{c3Jh*I*#BbPj(
zT@9(5(gC<a6ZdNiJ-2(3$}d0D*oHf
ziC2B>U0!VX;O(-CDPOxxe_k-WP;NQNS@91QR#W|{QJVNu=8t-pXTh3{LGMIV)3#vC
z`ktZq!UmEJZ(A1>K@xg!D`=>CpF&X}cgt=VO-
z%e?PUb>|{w?q!VL&b6H}75nUbL#Q!c%h-;3)@Al~1|3LT;k$H_0#Ks=Yk=1-!NI@6
zs1{UcN{Let9{+Cgy6#E$NdvJA;7R4)n5k1TH*_I-h;i&yPx*dy|+O)O(MeqZG~N1%syDXI;gFe
zY*Zt`;+8-nDX@p)gh17mhT`H1KPhjhdCt4xS=r1IQvnB;J|<462qi{W1t9`zf_W6L
z_GZn>^f&u5jHeB8E^$gKB_c$Ci(k}Ju=qnb4h_#ycEV8dg1PC3HI?+k8hhP@^urqb
zI3}^sO7-^X=qjOjQk$r4-aX7PVKelH3dyYv#i!!>wHnBoj4-CwLJ8}Hk_t);VDZsa
zfkbgAQ77y%XeF$pkONwoW$uo80&4Dk(6#sGI2FbJBP
zOIr_;ACDFoi>tUmi|*gH4CVtJ+0TvN3nv?eiNeX*cY~clF(>v#sCuO5T4{P_ft-2j+N+0kEJ`zft$@;w(s{Ycp5Lq`vHEX@=
z>div?bf|c(H>_1aMNqEP&=LNB(gt)5V}w_3C<@;mF%-y$R7l-g~FN^H*TaL_loz&1*9ysisa
z;8uK&p;p3&q1%~pA~2JB9Ex8K$2bX`Od6=;Cy`Qqt#{)VXk93A!Vq>7-W^?HdP1Nf
z{_kM*bCS#&s-N>_ZD&Bi=;uIv0IW<<2Ni>H$i!Nsgb%w0ztn~TAsJ5;i3AOPl@qBp83>X1A%>&eyPG9P-7JwkC;(H6EQa
zi`TQ~&SD$=gb=|TlKW$7z)aCl^F_EePc{`lfsZ2)eARwApr9$<*M6C!j4dj4htCo*HDkgX`*|OIPt4IK2ek(9(YERje2*?EPqV-}gzzpzK<%d^&8(WxG##1c
zZ-{h+mG^1BP*ybGF!5!G0$mv<66|4A_8Z`xzestjgQk-(I>RVzW(71T7~kAB?pD_1
zdUhc6r=j|dpxux)8sldmx+$T{}J;*0}IMJ>)$6U7OlIY;yM
zcm#X3*H&w7Z@u-l*4kEa)-VS3RuP9{9YC#mULqPN#PR$--?iWO41wN%pZ{|&&qK~R
z@4JV!*Is)~d+oKY0q|bSl`?M9ej$wZW~Kt9*KoTHz9H3Ozox_YPruvSR$I6!6^Q23
zv3?suh_`Intu_^FX-v~<;#EQ~FItDl)Nnnt9+NZWsP(vo^tObrZqW<;JPG~sCb&Q&(o@6hAf+sdr!?S5=W!g|X;e}?{cC_fQPSSkJPF&gv3J07U3G1*
zn`XEO%P_bsD%at^8UN(@IG!m!4$lk^$n-g)BVEt~uo6VOz^hz?3gHu7|;G+On5?
zM7s=`(PtcFe)Glm;Wt0tcCsd(_Y--AHlC%3oj0-AM+C0{yXIZvUG({gU|S&5Z(Z@T
z=+hAxiBDlTGV&d5Cy9y6JgAX#MfO;&6$#%CEoHn_+!$Eg1~_&#n``=Kh)yoif2rIBP>Ylcia
zSh4QXRfLejz}N&#w_p{7{LM650I+4(tvvy(nOwEsT?G7()$$OU>dDIP>eIAG9nkR9
zq7Fjs`9{atTnD>a2cx?Vw28PAzv!c*=uVEu9^BQj^ojL=XxyCm!mHNXV2TBlT@A#2mlso*
z>^)oQj{+wLnse2y)vv^FYz3jzCJLJsojhqbm|D6LkKPff4${
z+2(oYY|^F)9C_*|-z+pwA6laG_26DwS>XIZiOjr8ovSf7Ko|@fdWY`NYH+GnQF_4B
zS0vJ7VmAVD#`at|U;}*Kg@PkA*zpbG7(A&h6uI88>BWwY07xK2J~+zRniD+~t|{rLs-ka2HA|A2Nl{$e9`XKuXS
zE38jb#w|9?>pjt)
zdxTmCN}JyxAi^t@(02r|xNb-QhKpc0&^Wy?^uGr`116J;X+wUv!|3L~znqr?&%1pq
zY8Jv&bikvqh1h!o!cABg-%sD`FavF^1Ux7w+1K@hJc-q`D*=LT3qoH1C=Y&rIkMN#
zXvfnF`bz1(=v-kiztLKye$Tc6fQ(5$&$k9KPUCT5Zd$v)%ynJ|70#w#SO^7fQd1(t
z{cxPe?A%Am5z`x0bZDGnfgJS~a-73QtlvI>zmy#R3-B1XwWC8N&Rh(Ghn6xmHb)o8
ziIjds;2?)2@zVENt04vHJN%*0R-S^shSSMiRBW}0((Sh{1V}MV4ej0Xlkq?FajkG`
z-f)pV_cn)**}_NK4aiT;v0wP_!iAh}@8xT^d%A$H#(>l9H}Q3WdwK_7d)?Q&`Fg+m
zdOu&qx552X;mS|V(k~(Y2Xkz&(|FvnVL3N$Jt6%ow8HvRw^7c9VzG%gr0!6?{?yd)
z@$!`Nrj@&z{~_Ej%;-sznetxpW!ISNEpkg5P*Lpd2H`2RtkV`j>gJ|*7pmIa48y_1
zbgZOV?NI8TJx+44(yvC-)czbV3*g@eE9ibiV6rbW9p}VygV}+Yny%5OGXg)>Y;FKA
zxxZk{JfbGp2fZA0G~2MfJwniK|u##fwA8{fFm05YJ1Q@63bWHh9!ZyObVx&fl082~w_816Mb$YV`<#o{5
z5&$~GDH`EMI?GkhaBU5$=cplNqbeFpa-Cc5t0|LiA~}9)TPxt;Ok+bjtu^h~h|eAu
zL>Bry`ddL40my9K0Tkz~O=Gw&pe;koou)B3jV5jECFWNK&k7t1@c%+xS%CjDDwzp4
zRn~;_YdNrPVOO8o7kn0cu$12u@SiC^8Z~4xgqj(_%2Zrw1>uq(&M-u(Voy_9S6$B^
zjPDVp4t26$0VfJofc|n#wzL2`GCyP}Li8Q}Vn=OUPazg9p0_x9=nD0k=NEUgCWEth
zB)Lvo+d>;Q{Wz3!)lXQkYlxM?44b`~eng@o)RWJ2OM8K}4RAe+z!Ku*&DwQc)AxPNSA*X~Zw;crOe^S6pb
z-Jzmf*&|>7fiw+%7++P=&GA(bKuR
z3)A+2+d)z22s*u6D0*+&sIt;Vp2MS4And>SG_r_CrG;jeNXtK~&{Q6|kkXGfAJF$#
zX3JvPM;Mre1^z7Nv(mTiVU30cR+&NwQp%4;yu}$sE7u(%K!5+7_L%(aq7JPmCJhQ|9h`N8`~f5ZFmj@h&9{YS@@CShtT8PltHk%C4ZwR7)BjIXIP!+g$=Bgc7472v~$RyxpkeLiKl1iy7Mx$g?^)mfJgY5{>geasY%bL(|_<
zAB#7oADLxz1(`l%N@$pKVMJrjpCemdQp_pcBN{jO7w{-lxf>s6>FF&>xAY}Ah(1F5
zZ%b$YF=KRUZJ5HXZxN-}BcE)1KQeA^fMEZftSU|@huqR>WAA{eu&unzkvdA@Cbb$C
z*7scXW3KSnusd~=+)pm>+ccZ$?L#vHjJNqmZVZn^F$F?CTT)vqBBd`hZW)o+VBXPz
zf3qxIJ3)BGJo=Z`W^_J$)HTeg5_uIDnJw2)o{a|>@WJ#Ut-M-NWVwnw$)jBL&4_)&
z)5%D+NOKS(1BI3r_wv3tLB5wBHK7BMjjI|Thp>ERz>j5v-x>ji=JrBpUU|(4b`&O8
zS_|P+{LY*c_liJZMA`lO)Oz@CH`_BPE&pvZ-5uGbty(tsSW%r1q{^i&*u`Je{aQtD
zW+qL$n?K0~w>+hvC`F4;v~&8Y^7MdO!G?bs-L-0nrw3tQTO<{fI;F2yxucazyb(%(6_T6A7mZ12%OCD
zZJ_sC_2s_jsT-qRs;PM|?
zU?7B&KI5=v;y*Za2#H>7loJv9cW}`Lr#apug$7J%G~^>XPxBlOEu2i7bzLA_XGONa
zF@r1DA~529Un|tmIg0fsQVmWJK=@txPyn9AE-jAT|NGy$e=+ZmD}!n)W5j5uXD>3x
zOP*G*dBlb;(&hdx%-Wy_zUj=rvS7;l;$v1{SqXfug9mEO*Fo!pj>PHp-(8UgwDjup&~hJt4SM@{8-3I_hb#LTu5
zY(Z;}t|00g*bp-viy}_iJM!@}bAD17i>!+ieCwJ2l#Ac-Dcc5Z9^)3X{??BUX
zCZ*qT2Vd{Ejyvw=YoGgyrghaRwq9q`M*^<|?=%8v&Gl2PcWEvinL9lEANVVR$%g&@
z;PHc$T%iw}&rBho8^b=knk-
z3gH_GriRax{4V&yr^XrU5E^L}#=T?q#DI8N;$kX(p2*{$mPMhS{xsEv*(tjcU
z2uZz7Anv_(E`1RtO>EdX9M9s|29D9w3WwNF;^-)eScr0MA)n1jD!hig)Wl)i=~C~S
zEo4B2r=H0!qk~Qq9&28r6IDJvxl+v7Glsf-tmjga&E3#ew;T7mEN`pZy*x%*y(WO6
zl>`SXIfPZC^7G->-oixPZcT~0-MwU$RR;D&@x@i*emYZ&dx1$c41Mn;XtW(WX
zrA=UY+7&YwYPX1K(fLOEj1-tjf?hzrXbOyF)IaYS6)rwYT0{JI)PibS4PEEvvaTzO
zvibdY!0YL-fAy!r8$GrR9mytxLuMrET1;EflxQT=G=LVbAyGF~7*Ekt_vLlF;Q`x&
zuT0Kv<>JE^v6Rh^tgJ3gl(V_g-SgkUT(OKLSBVG&hR)a)&5nO6bsIMn;Lp}viZ*hL
zwaBn8By19A^LNl&;<}}Ha;3kh2XW7|M@RQ~{V;Z%NX4eNNu`37Fhy7uJzBysFI6it
zfcl^hW_iQp%8Je=Zy`fyqN104pVvwNa0C-!1CyoBq*WPcac!_HM2Atmt`*@pb%rC6
z(Y^P)Z2|@x>Kam{{}I&{tGs{?;jgP6x;X!ziGH@7iS2MR8^ppMf*Gk~L+
zJvSujIYlud2ZxBPR5Ev(E{eQAV}a2FJFWTkHY2zjJmmd{2Izcj7X$QNf$zTsaCX&%
z?dw9CVKQ#10*qoRLFTq3S`1?FHptrF>pL)eVSrE2Qr3EqCkYEd9
z`jI6I0&<^~tFDb&h!#Y0M~LS^1WjQ_V>nL=%Ire)&ES2}ha0LUB^oMuElsmzQ47ee
z!*%C-8;
zn$=fIugIGK-QXoSk4M)3=vLRx*EF8cMqNHz&e}mG{gl}x7+u1
z+%#;maV}Q8_`2oAw97l->&F|}N&ckwK3Dd&BebqIm9&!_(KR3YT1g#tHB#(4OoUk^
z=cf_A)|AhhXnAIfaWn6(!kpfTHp}(D`5e3@<`=RpT-4rS$&
z1UeWRR>M*1VvW&N2MPlFuSb~Fu=jS<4lKo_g2cp9cv2bqz9sv>nz9=Vz*Nl-@U==Y
z32Ql*U=TGX$0y`EPb0H7lFFELJFG`!7zryR?(amRbYv}BOH)m8X{#$1RzK9a4kxEL
zuv;Xm!uYFP^;t01{&oRsvKy_CggB9oScBlvu%@z)YpmZXinp2w+&)IeM5`AmjQg;z
z_uY)PXxins08iTDzG#d4c*#m>11O5MHVA2B4l})%M3`AAw=Al{3=`Vsd_DJYXclDg
zh&<3HOn+@r0h{PjI`aDeUr~e|9A^7Tn^6>%Z^-c70(=I-l<&FOnUxn<$cC+=`Wly&
zpC;`W;HMhtYzG-h-T4d*a*Pm~Na~DRK|#vnC7NWB&1tk@jqPNUZ9;hk^2-XlO;ig=
z5ncQXR4Dz%nrjuVrEKM@FR|u|#V^>H5UJzQXp-k{!tqZmkru1a)q)t0LcNszuloQ#
zba??^Fp`(#19JB=Ymh_rnoTD4|64)c1+<_b?}LJT1Ye=YeaeHm21U0>)ds6PQF%CK
z*bZeRFAe={^-Dv|dgr4EUrOZy2N6=o=9ddA#U{tOU~wihedpA*m}m+(ohhK75Glk<6{_-rYSzA6?J_kFz7F`^?W%@s7PRckBFDemp2
z;v|KxA#VO#OI${S#FqqV9-)uqsvkte#?qteY`5}b(Un2;RIoilKd)aH{s%xq9{(*t
z(x%7tSA>DLrF@~==c-Rp(+r;bkc8qiqhWq(gT?gixB+as#m*4hnEp6hphN`a^{!zc
z1%BZ5K4!n+rvHkH468lF+)Sd8a&u}zBnXJdS&{g3{`}G-m
zE27hkTFs0;lubSK_h0|GU`HH&y7cbV6KORw`oH+W`zKNb{eB;Ne?RY?KE7MNp9s-K
zs`P)kmu@|5=Ka(7aZA_J^kO(?1iv?%CtOdN(K|bMKJW{6!mXzX-g@9E#oOB@c&ozm
z8$9RmR$A_$l5$yMSc5tqZ3fso7))th+g!}+wRfuSAkdFCh!^+8o{H|LO&=e
zbgBv+&ZEshF&$dj%;T$IJf%(kR6HjSoTnyrp;T$1>r47w$397*z&ZA*&;!KY%Yu)z
zA4)2QytgAbXLqNN9v^--ho5u#EQlA*$0st1MO6?gr{g&m@9Xm3X(*^Ko&|X+S*Day
zvLYepOZ3%PjN|aWi$qPu+;Wod1~roPg*0|rM#{F?s9lTy%~VWM5-0#wF=Ma5t=#%b
zS-Nbb*;qSUg+xSB9crpU6jVAEvJ+b!YyLQ|x5|F!WB3r1@?bUPormFOB5nt8HDKFI
zl#%8qp{g}54d>6SNLzhpsyX$VZFPfba_SWvtcm63SZ>;afj}g;yqnmqDe>m;%VyS`Ni1a5b@&h{>y(r
zAm$ekzCu!TX!9TE)c^-@yQw{7JswR91#;|$0D@K?!T(Ds@~Dz>(^RfybLCzsq1>@5
z7v@vl%DxZFoTlwxJ66-k9H`vql}$GF0C!eD(=nSNm4}&d>;g-
z8T_{&0;mfh5XnDiK{IXl7DAchV?S;TD+
z|E4cm(38HqnL&(*>gNZsJ>^3V(`M8du0%YrAnkcnVGX*l4j%%udQyBj$vd=xiv@GuY+&R~Y`E6j6MAkk>OZfA8`=o$(rU9X=YHS+7#+VcwSNiEf3
zg{Z&Mb-I7a`nj9k`arwBo2=)T3^S4Mr&r}xSffMM{kwot;14rY?j=*EBYiMdq*okE
z3!95?y@VQhePT0w;2{KH{(b3q{=EdwwRl5=>xC
zr?){D@ReWH4&f){Nvh?LP;Hdwf9QSSk80a0H>RDY%npsEM?4_^O-~;TV2j+CFK|W{
zW*`53dc@Co@5HVvQ@xrpaFIu~%1_LV`Sdh9DqOa6uKHvJ
zC;HPW`&%eR=Svol&*+&`xiDdi@LcNs>YIE#Q`mEyH(*(#GP8HijX4@1P2P+@VB3Vo
zlR2fTbGKM}E*9$ne{7;z(%0i&G>LRA}z%o)5bz-;bi?N$Eh|!vvu~7%)x>%}F9!zyX?Kk>`zl(A;~6&k$5e=FSAa1-};scT){wo6Uf
z!2N{@UEmZblps4AeIaSt$7kKv_V&<|HJ4gNVk^#KckU_BG8ZCt9yNwciAAyTd;dVN
zeH(s*Exy98ra<0%3n$m`uAO(iB!x+D-}!2Py8%L>7-^rDw^i4ONmWv#2%cE;L7hhl
zTT1%_m3=6{(uZ<=`5a925g%*9oBO+_#bEUAR)~IXjP|ETO%WU2z>G_`OpoZNba;Lw
zny-i+Ceh+N4pT*UBeX#@1NWV=V6f-VjpYNsD&Q~lhkoqtlU8CbDCE$pSU(Z+kVC)A
zXS94u6%cI1S>w*t?87Z(Ue74_UP2c}a16_%N${fVY`X5@{MPOX-`uxzFz!$1(ux7E
zXNg*Cc%>sV;hT@{tM3xOtn40hXp%e{e7Zmh>*S9#k#zp8Aail4*5W0-l2bG
zg6pctjNe`r_ea&)ErkQSTEDH`SJYO-nF7`CY$T&xSDom;v9Gnay;k#(@Yj|oZH|5j
z@O-(0%Su|iFW)D(udc2dwNE^BYsQsq)O9)VZ_#;G|L;1k-2BP~XKE;o>qC%(Bk8w$
zZf!-Z|4@U$b0M6-aT_+_uf8g0I;-D06&vj9U@exJ_~)6j!G5!^h@%YWu{;s#Tu5&MA{H}@-rtLMC3EHJCn;)_Bt}Q=*
    yP1IdA3#eY1o2}
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
    -4VH
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
    @p1nIOfkJqxe>D}Zm?CJPw
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
z0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4ea
zAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&
z00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY
z0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4ea
zAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&
z00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY
z0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4ea
zAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&
z00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY
z0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4ea
zAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&
z00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY
z0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4ea
zAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&
z00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY
z0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4ea
zAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&
z00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY
z0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4ea
zAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&
z00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY
z0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4ea
zAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&
z00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY
z0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4ea
zAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&
z00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY
z0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4ea
zAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&
z00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY
z0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4ea
zAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&00JNY0w4eaAOHd&u#yP$!T&%21V8`;
zKmY_lz)nDEO=r`6l)C1zN-|YQwWW)tRH1q7h)gbH8!PN)G$?~OZ-_H
z(h@JG6G}Q)tV=YNB9TOUyr7f{@pOp-VzKH(CKWHlC?=}Z<%;}YDPCgR=x1W8l4zf*
zw8qnvpRm1!3Y=9E@lv8al=?_S8LJdiC85+U7Y0&DmD&rrZZ(TkHmPMWKHHt9zZz4;
z&JHq(N?eLms^uw`3aNNUUAMhV-LaSzQn(~0kWodF442T8wwq<1w7F=ensQ4UgmPkY
z-MB~vS5r^CCEXQ?R4Ynru8>G2l}^DiMu6LTdX#*sP|R@?EcGf~6%uQWqENf)pfqEs
zLDTQaltQ3WRmJXjo*Gw$(iBnrMQf>1Ws9w;LaZT-_~1gSiwsG{)OPA=L3=JYRjBmO
zzNRxPBm>k5ise~KP{&dm4Q1_M5)Ena5E8Z8JVa6ArCdikQ4xvAUzFBNye$$frKnEg
zmfe2?)ioMiv
zbttJqAy=UOOf*3E{7sG4lCQ}`#cZLH>d9x)iFB!tSwi$PMwBonLJcyLZlM;d#EZpL
zp(MJRhWbRBTTlfxI2DNCpmbBGWzt}Yqn573lgUD=SmeUgQ@2pTrIrP(>TZvhw3cR$
z7#S6z%@eHhDvwl8B9$+tb6Hi4`yZ3mkr7vw6(Tg5Y3S<1ofHG+UoxpIsm*qG2<62p
z>elj99ZgEABTt@KNad-^%@yKpDRNXxRZ+^eQoAe(!4a_$YAmuMGr2bE-$gbuk_%te
z9xt}nH5FrtOst8Ca5t$OM1e|6FI84UeOHGtM3-%>SEZ$&>)}l;ZhdT1ypB3rp}kV{
z3%We%2})6IO~Fuw`AUMi9ifw}Ui9`=Y6J~QZPemNn5xSb<&nUsBAdLaO6@V;X=K%s
z!PTn!&`2l@6TJ>Gh}d*RE0d|#cxQ&%Ew=+IVK$lO78O%{u2Pv0jnuTIvZ(^qqNYx3
zS0dJ)myC4Dj4&SEneK{Hdnv`zR1svSEnC?V9Qk>fZ_y|enrezlAm#*wpog4Ynb_RK
zRcUw~2h}-)CRm0k?vaXVC6S>XKq>X+l@1Cn<+AAnTS)zZt7K(1*G;w5mMWFf
z9jRPvGT!SWJ%rR!UmQ>Nsyd@ly_qOo@j{wsmDK%ft)F|LTBig}0@bn4Gku_h$thfN
zF#0>M91Mv_CCxrMOH7vM5rf4fE>o)OiizPgNh4Yz*Q;4kAL
zSM1=1rb;Ci>uPLL4rx|K<_~GEP-5dVT`>x5Y^qgamYykL+B>2
z^$fDDRZYpIvuXnxQc4v%=;^PNQa#lU(oLPGPtg>>#aM|yWYOGxtGUS~x!EPTg!HuG
z-|~cznTgDLX+v9~oyw?~&j7qaS6FCLd+8Uw{Jz5_akWQD^E@JQs}c
z$|9DaCmowufl|^4qfSQDq%FBZNl!@qb1|Pvq+8PoJ&e~Rv@ki1k?u+l73yrJsWg~|
zdbu#c({`Tz3{gWAp6-mJDR^79lOMPvwF(V9w6v0KV>0
zR@_1laMai35|&35BUo?GW?44E{I}L7En%_&^4!eOMhV62O3ziT&`6C45w0YkIxOZm
zqfKTxBc*xHaKlWOIAN}smI?MW1t2gcgS1H}v*JG5GC}0orlSaI3au)|EY(FwxKFgg
z$S<4fR$L&si`TB=kJH5EV)lQ!#r8fF?n
zhGlw~YK-}B&Oaj1a(|UhT1+rUn5-}dOGC^dhAoy*!yI$4YLP8yT)n-MwRKWF3o&AUbDQTrQspLCbXf;GB780=xJ$6$UN)P=}@qinkMTHU6mue`2v`IFB
zw!4+OzN>K@navYm*~QaxMUkFrW4y4D=*Wj*!seL=64Own4=Djfpfze%k)#K8I
z6F)z8wkT7HHIGkJNA+DawQs6cq|LOjs3y>jb{&UpmG3bQJEU3*DH?kw@^X)3gh<9k
zbKxI6`14P@4BHl`B|qVr0;4fpL}>)4=e$HGJ@xRDj`3t|@}GK>JQdX}FW3DXD`2Js
zo*C$VXd2|a&0$ud1hu9b$^^B&nq+;-=W4Kzyxn9UQ5U2Aq#b5gQVW%1nYnU|$`lhb
znogSv>RB%~vn$CVoT|Daw|+^Ni~F)
z$cr@lRJX=PifMC9Tc@VHX`rp8`Fy;yt=*)ZM=gpO;*2S(kD|s(o7Ub*o;KT(hKah5
zIbyiXjzCQhPjB^NntLus3R9#x%}CXy9P(O(1-E_M%XJiW2&rou{+d)fEJExfv?EK~
zfDTaBX5cF5maVIx%zAWlNj$;nI90}uaD${8Wv@z^v3sPESUff8nNcl^$+NXpa465a
zouRg8T|0B`Z0yg&ZeS}`
zMsOo-j_0zpa!JpgnuC(`$apDkmu^axMmOq0^jBSj{ud<~Ll2Ujv=h{%KBBS;b9`Mx
zoj54KK3&n7r46@KqLfOKD~s+zbVx=pVX!tu8a0eqtxFOfOnCI_<{l|hY5lX7)?$nC
zR$7_Oghr>d+w!4X%&^;)VZkhj!F*ICqWdbcAAax
zG@Sr3&0ehi6m`UUB83*$k{LQ(!d^%b>dIS`R&?oPMoX@ka*@@tr`0|qR-J+gYdON`
z3bh!E6%5f3F_|IImO5xxF%{2t(lf9KpwnR`C0|H)#OZ*B4$vsEILkyQH)umlU6GPq
zws^=h)rFXYI(lxJ&Ze@R9f9lI4mp9%GI4Q;XigCzC1)b`f!m?YZPa!ZvMxw4ZGAmj
zU)*N5b6Kc1Tk4)rpRzit)R~C`k%vl`Ih%*1D=K$c7hK+g*20M0zig6@4`xg8Oiv)?i~P~lpoOb{Yr*v+
zlbXEzMgC3lYPkBh7F<8FRg;&$$iGQm4Ojoxg6l`BR%*Yqm~Nsp`?P
z(0|uMDWM){{Mw`kQaz0vRT(ujXus>BtU(JjekBcRpwJMB*7DLRBOf_R|HJr|mFU5y
z-${)YEcDb=8EUlO*;WxM%c2Sxp~i2rEQSVJhY?1xt-1y+P?SZ6n&R2~8bgEjyB;bE
zq6rwG#%}^Z4IfoiVW_{egb0-yQ~@K@_^qK{Ym)M(__wJ+4U~VWVf9*Llt0D4O$}3#%RxdVL
zNvHfNw_F?4K>3#%Rxg&7NK*cki%bn_p!`b>tLN=bwp0ET|28$Kf$}dkte*G#SW^BJ
z|28$Kf$}dktX`a#B1!pE{M*!^2FkzGuzEhd$2#Rt@o!Uu8Yur#!|M4+HcQH%;@_qQ
zHBkPghSk%z+9#lKArYM}f}4HKsgStp-5Y_1dkHZ{mUV=Mt{qcR*<(bXcF(7wKdt9X!bAis>GOPGXBdPUnzus);+)h+J*D9qD*i
z%O*n^x`eu>bjg#qz+4nML!AnF6U~{_`t-mDf%1Ib(3l1Dqk}dB6z{F5n}q5q7V{&7
zOKQDUS*F}Bg2F+Al({@PxTw4o
zEO#DQcf;W!>DId3b-Dp@SL!?&A=;7cv;r5yd{!bN&Pr4%O*MR0BBIbkh|5_CYlXPy
z&!L_NUev0w852|Y0W95|yLS7L6c2?oFO$Wf=3zUgLemawkL8|`OQ+>6NHYrKw58U{
zEn&tC!VskKlixNn2Z&bJm7+5smX$;iLT?1A&65A5c|+9tr}eK&)1QfiHEq)Nr`S0*
zYqK1|9lSiMQKC3tHbfihDX=zF6``*-Q_f_767J
zUp`90=RdN1x{ME*djpSh?N5dmbyf`*+V|rFQ@B
zS*+ad-#w3&*ZsTe|BJeR_sss9?%zGHmEQfkXS33~e~)a+?EV`%mU}KwNz3n=IX~+>
zI~sbPO=-*MHd(riPLRaQ?9wPjxg8WGDX+U>tIC@@Qi?LV0+KcyJF3uJOTNk#VnR$;5FR4l?8wmNQM9%?rdeMG
zrdR0sS_Zl+rkR%+d8M(QZdzy-x6F*5V4gjiR7B-5N_nMGtSeSa*W`%njc6jc97#O$
zQIBhiw_Fr9p7Nrn_a-C2JHt?EO_O7zczlT3)aw{c#}LuZk@6EYZFlP2$L0UvotAm@k@zN9NkH~#$giCu~NR@&%;7-^1)QK
zu2g85RLxh_LmU6eR8N@Pot?I84q9&=P@|-cx+!_BQ;?`Q`5j8sWl7C#ElgX$4anGY
zTy!nCNm`!82&xO~2$~SpxNp(ZJ(ujr1gSYOc{3*A?cb>;UJWS@Uu
z!KaM;+b5}5-oB#SWrF9@nn_HZ+4(jap)FirAvA^+4b@k4$3pcL-QII(*MgVXS5O*tL5Jk!X1g^Xymn_y)fmC*}^cOj=CQwz_yL$e2~y7oNqL4_hM3
zG}Jz8aLL3rXSVe^E(y5X(kD2H_Rj3oSVtot)->0?OFFK5x*v;g>!i29Ls-V08{g_1
zQk)Cko}xW9xA~{j9)256PI4Vo={-lIDrjTQWnSeFarToA5%>9&L(F|HWfybl8yzCf
zr*ht5wiM0ifgH0HZ&Bw=#V+gJ^VlWLy^hNa#V&62IKp02|74f+?ZEBA^5KndJ?66#
z_O|JewsiG!TIgws>riXe=sL_gM8Y&5&*9asEwK3*!>V~yva2zgk7EGy7Ih9@cGj;seR^e=ETj3*@F6dEh|a?CWI-A4K3I=xI7XtnEj;$wtCj&4SYEa7M7a
zzY%<$n!I~ac5*z3(shH1TJYGI7OA7jUJ&a-59MN3w;dCstnFomThLz3QQ?MnU@Nc|vb)ymG|XgVQa0>f6^|x!5X&4y`xv
zT_qM4bk47XZad}UEp-X15~uBv>FF1zY=ppLnXz00r5IY=+RF3}x}_r6TE#plhI
zvz%hsUwQgmI{4+b&E)}Wxpg`ERZBAo<-okEYxG3ol2`IVaug16HRBwx2DK%_;
zK(u$x%inTn2}V99P+__dO&Gd@9pRaeXL|-pY
zm%p!t*Q+@b&U^twe4PU-$B(vMjXvkz8moh9-+2m8Z8HKPq2yNI#;>
zKL+#n3=&x
z<|VIR4UvF}#xvdV-XeXwhStivg3}D4B&vRcq}&-WndV^Nk&`Kjz3{46^QnK&7QyK0
zdU~2w(bpTQTj`iE@1r(pj|@tJk1)k_vqGho9fh_OO&2`W%uM+?V1RUh}8*x36&OdYpL(U&yO9`3%3;
zk;rA}2I7QJ*U_h&wnsX0T`BR4czcC=c#jNRzV{}-uw=7S{diQ_YFzB>COf;uN>Nj(
zP^@cp`#2zdp~L>YJ$ZJA-)W&ps5dtZ*#~MPcf~Xjm_F5MQ;jXDM_>i@z^NFeKMP#B8?L>d|Nd4(!#)GSPR7|
zCHIojml!S9B~8|eOj3VACUl5OMs2h(I?Z!SW1%bR
zp3d5d%9nNMmZr>-lQ-HMx0_arC8C}!mZaR${6APC8iQtuxnrp|cYrOOt=@g0J~dmu
zA^g&LK9Mw)pOp5izQg398#@XL!s3bOc8XiS$Ofe{rhQ564kdRrFKM53jkPZ)Z
z=}26w+poYOJk%u{*O_$vpql)H^+RVo!$Bs=tev8s+n0;7kwhU)~XyJ<0qZz-jR;qHXEO+o%j%gG|N
zsymV93q0wP0$s977pzKXa+Okymn$mins@oVVDa%?x{9H|UvTCQ-4bj1ny@v3dSLmX
zVfmVgHBr#VfMwrpNkjUAQprVfX}fU^0H6J!o0sW|1%8!7Er3pPFn`CMJ~Co_-hkSH
zBi200b402gfFsc7<|2%a?Q}7O+JYLZEsd%tz!e@!)v`3u_oVo7nM7!Z
zK|Nq%6_By=V}PcV`qgy7-|8a`bbF4AiK0{H??5_=W(Or(x14*Kt)oy2sb@mXm1kgXU)pvhX-uN3TQl_HzufHzXS6ki
zUUU3OYx?l12`gWEX)au)#OX(p+H6CuQg?_ls%{K_sJ>FEqqceoeGRCCw!+j!Hq-Fw
zGHs7l7m`#_0drzgE!)g;!(FafZaVzTGR+Nio_xAiOzzd~0d>+XzbBwh*>z#pDTBHB
z(*a?6XN->B==a?eW3(e*o$BImeRD-o4;lbA!N+-oHC9=-(i*bl-1NiUgRfCUOrZ##k_2hKI2T)OTH{$H1bU(KLbHG{Hsru48_wPhSZ+RO%>YJ
z4#ZQKNB7RG5Lc^+R!QBeoKB-_SgEK4DZnb4N;%fp-wbS*nMLeko
z*<(WKWs(yhc_pvH4;fPHu-~Pr_(+?nn%ap^3OisQ(JEUL@e#FA_mQ;o4`;PoRrq9L
zsub;8EM>1UwYe^ro3i4pC?~S?$@U}MHWJjMXP=_{a
za?VG7<=4Pea}?5bAkXlcn7MWdEAiaJPD
zVHF!XyjpB7X``&i!;s5hCfA^-ZHkkz+BUFeE5As=->_}V71H#HJ+&8CW5w5#w6z^I
zOuQzR%@z3S-)XerB-8fBc+MhcfO5~HK=UY`28&Ckd6B(
zOm1CXjtQix
zv_hpgpG@mg^nHvBO`Yj<1%IQOPOp+S@rx|D6$XvDO-iXdoz2p8QzWw2k&254wqh}-
z(2<%BL$9?uO`?fhw~MG=9?4fdQ7v~CHH*b@A=PZFXUS5s$LqV1TH{c^iK>^^Eg_#T
z*6<|aiFUemiSejZc-|%+04yztVTq5xJ41QB))8uixwk#;7vwh%t<_LTb!H8z?MM}i
z^mQ~@9eP%^9dt~B-b?DWN>{NfSc7QaGLzxGUki)D^kJP;!QOAkjYg|vRhDv6gQ&+*
z_=`NW`kJCqkFE}2|D<=LGPyXNucG#=&+-})>Z2Mxr_yX7-P)_P6>^<1*AI%%fGGvHoPQtqWiv`d^ADw3(zIDH^k$;V6d2`60z6^g4P&tIIU{)<{#
zo%+@V2TvpYTBUON?V{ppMe<3DC=rfCXi
z7@eFYW9<%TQV>n%I^t>iBBbS(e|voRL{n9+7h?i8(?mi8;)afmMk~IX$&2xmJZ93ffZUQbf%WnsRfPS-BN@ujb
z!Y1-GH(qN>OZ&CvX=$mpROW_hO=WFU)?~Igi;d<6V@+j=v81sz0c$dQq$Q=jQmsiH
zv3gqZkyvxJQ~MF0h_#2&;XG?qYl4t5lP=RHmleQjNN#xdJsw
zYxQWN&QQ+ZTq&BQJ&fgSwV;W*1hcdqye94vF4{G%Ez0FZT2>oE-;hX5<;7$1(BO>M
zdj;)bClWQMuc6cLVs$PdH+-r7%+Z63snpb5Yile+c1FeGUlWBS(*^q5x)?}SJ8~Dv
z=>P#O9ago{&pMjen~u$g(ow^2nbUiXV)c@(Fxy9Kg#~>H%oJ{t>9Z*QQD{D&Y8qSLZ;!S&b?~5IQ
zIuJUtF?Hq^vrV&_3SOqB|I&Rw|?tSL7_
z+>|?F$I-&5n`$GFtE<^8C2~q?QwGCyBZ*f2_AE`q-Ey#o$rVJl%M`5cmS~-+DaPo6Ifc=lsc5>i
zDb#4kR@sI`n$o)tDP}<~XBa_CF^uf(#V}&*!;C3Yql5yADUEfAG5P?b?4~fio>Rn#c44B+owjw1^~nd`N|7cO-b
zZ_VoN5h}wW#r9k`ePN@w%ycz9MOshFn!1Nj*;RM)^J;k}QdV>Vkg}2;3lG8OE`%wI
zAWIFAOs&$`LM7Z|k
zeu~eh(9fP^x{WRfNEhQ7T6q;e^X+l^Dek4EpPl)9sz5&z*-}A{e(Ax~sxxU?wWV=S
zeZQoJPLJm3YTAt4KH&vN^&AF$RZ_flLa$rs!=(Pg3GW%Gu3xDhxs`Kb*V7wDzTKH_
z`7Tg9eF8`H93hhHHu4u{oA^Z?&t0ZQLTb~f9?>1lU-$AlE=q@Io9Oj_I^4*mA~6-z
zUzw3SuxrZ8Z-QS?EeUVb%9p0F+|shsQU5wQ$6YDd4PA9!x$XG^)?
z=BCl5Fd;S4{sDjFGhQgfd-=ptrmiE_)zGZ)s=wL`SVTB?AyQ8=e4;`&tXfS6#nIG4
zUH`X)>MwR$LdAJBS1n>~$1O&iM9?;eDOc@blHA-JY`QPp8lhgmP1MN=+lq9B41K|q
zUvj4lbGh&qEp+3y+PhJ!u94Do=!j)g1um~6fp$LJAxs#&go~D4+ZAv7Fr7d`UCFypAR9+nYOLgQ+y}ZLo
zPMj;y4xs3Wsd;D{dNebnT`W2&rQSMDQwzSIom`%G{20DXm@iF~CwOSrj>ZN`(81z8
ztp(vWW^umo%c8rRb$2J|J7Z4WVpq$eyPMy)WO0*jeJ7I)=a+-2?~SF?X=;;Vjhq|4
zw%1AfWL62EBeJp^pb3s5cI?c%Z3%IAmg==)`Nmr+SdIRS;+L1P72uH--H#T+Ad>Po
zh}8rd#6tcCb%!D(rF;xh)%Y8v3I!Szf)J_lCnN;|2&qDbK^4ZHuW&*A9%_AOHz9Vl
z`AJC1iq=*q+ZnC+$y1Q>vN=<8qzekj*HnJCgj9~@OGr1LnH!Q#EycR$$H|O(a;7ph
z7+a*RUYxP+8FDhu3^~%yUow@gWjWBuT3x<`K1`)OE=80P9z|3mJ&WkWRF=a%LvN-s
zm9|#Q>i{18kZd4gVZvX+M+ccf_W9{hCA@S(be&iOf
zR)SlUsoq_qjhc5x(`}{33z~ew#b%hi(v_;vEy_1z(yV7(t7)ZSH_B50KB%pBQCbvr
zP_m3>VUuy@U>8B%z0GoN7SQGI;VrP>F*Ivb%pnF0OQ>WZ_fs8o#gR$TcAa=-9Je@U
zoXFoJ9mgr+-VSk4siQ?nbQbt>Cz=Ws=mb(rpN?T+?J}kF*6lT=v+6b`Y_=&Kou>Tm;dLX9i+eSGvoKmW;($23gyg#q${rG|Pw*Gh*`
za@g`mTvH}jPbf&ImnC0U@E5`te#AjZxA?a;V(a^wunoVq%HJd?`Z*H
zUOo%Nz)CFW?M=SakZxz-Ww9>04T<0TqziF)eN>*ap%?9VE1|KT<}E~{lxrmxE=lR8
z>AZwu2&^rUo
z?eXjgu{0Prk#1O-y2`}lXIHvBRDP;5D^FF=%2QQl3y&&?be3G2IQ3LRsPj{Ib(FN~
z0d5;uu`;Wt+$>#Y-?1`V7j3rE25qk6z(j&t?25W`fVOhI+Fu>_Wi*V+7u1Y;pfQ8)
zhYUAPXBKi)pz^tg#7;$_W#j@a=S?X+M|sSw@#$0kmJie#V9Vm_}ZE(CECTS
znRL*rks`%Ev>8M~yk9MLXpFH@rtcObc0hXZ!oF{M+UlV%oY5;hbc9??XYKi@b~@yY
z6^yV?`|4ME%~vhBc@bX|?s(3$UdQ8kHlVC5nrhX3WNqpnwjg|ZRGbNk$uH29kAhC}
z^A%*Va4b61{eyDtr0KNro+QoU$lT>sr5aop&S08|H4ULVn3@h;PQqdXQhmddtfrn-
z?jF+mms_IpGgASZ
z9&^L`!gA%cd=*uGR?FMk%g?Ea-t`^4oQ=Kw+<2z3yslM#Zqyi;yQ?few{dh=avc|t
zM}el{{!Crwp>kLZIS}yGR9D>pAbW<(QL-|=K6=D57h
zQ9j2IJM0E!-p3p)HwNBSdCzfLdB%Ydh<(ijF^YH?`
zKbgwVB_F9$iSKQ$47@`GyX<-?4+=0~wi)(L1(upgc(j
z0(z_!|Q&s)pQ~-uir!AlIf6ik&ZGYJ2Q0mpm1u}9O*q2
zS{LRQYV`x-9=g)0M0NELKV8-B@giOC$V)5qC7`08agho`)=%YN7ULU~=`IPnfMi^J
zoS$?hOVe66-8B**8D+_ImhK@*m$a)`T=`V-7oKRroG$&y(%~_`+@oeuKfx+~WDl#;
zBHH|QTbFt9+2^F%f*n+NOGZ_u^0<*#$qglGg6LWoKflua7MP?a4>&oUR*cmCeFwQ6&Lx3}C
zGy)xs3=1I>hHSXuS-xJ#nHr*AZHuJB`ydI2
zb3qae<$)v@(g9gx82=L*O+MxAenO*3(wmUK^QD4)kFpBkdb0lgJx{|BT@T?ns}n*6t3Gg~b8P4lk
z!+9Nvh4s4D0IzEe;dPW<2(Ocx{JoA1H(bfr>o`+G)T>RARCuo=;c#9@f}y;QTc^!#`
z^}1Yu*X2TZ9c357>!c=suVcdvSMv2b&eRa~YEvW?-s?y>oY#?HD6b>AkY2|c!+4$0
zX!0d*uM-+glHP>;y)GB*b(B>Iuaouf?{yl6AeSPef<*$nj!}m5x@_T{*)a37VY`Eb{zFxsVtLuM-+gzU1w7
zLZeC2n~=ZPWrMwrvI^mKvi|+OPQwu7Qe;%HNPyQd%5YxS8_w%UEUee{26$a>2(P2;
zLU^6jaBp1@_SYsHk6BRVoY#?9Sg-2|@VcH5UPsx5@H(l<
z-|N_L!h4(rV4(D|w7|QENE~MA7#xPzdG@5+L+v|izlcYBxf3NEa
z_BzTcgxAUX_xCytLy$|6QNbbsUdJfId0j_1uOqRrUe^)ebsZtRj`&g)1pl-H45NUvj!VZ2UgH2IRZ*9na#NpC{_Ue^)qb(B>I
zuaouf?{yl6AeSPef<*$nj!}m5x=c8)BeAevmkIE?ObD-|>_T{*)a37VY`Eb{zFxsVtLuM-+gzU1w7LZeC2n~=ZPWrDqqvI^mKvi|+O
zPQwu7Qe;%HNPyQd%5YvcC7johSXi%{65w@HLUt3Gg~b8P4lMo}ebNuwIuA@VayeucPcjc%9Vb?{#dr;Yz+<$C(2<6zjMoW`CSUUQI-$`d=}pMr>q^01M_GmNI$8hzUZ-IQaw#$@SR}yf7-cxG
zqvO+I-WDRUuwEDRdP11D6DYe7UKi%w1UB4oC10=OObt=5Hbqk5y^e&#c^wIc@;Z_W
z>2<6zjMoW`CSUUQI-$`d=}pMr>q5McKv{+Gx-hRJXc&TAD#XhOMY?RBKeFQaq8XzM
z=XG>#Y8bC0v9Mm(9Wd5)hZyVl=2x;m;Qc(Q$$zY4!wpyR^*YYf5cO(PBo*H4NI0C=
zkzgpVBe{@X#~Qa
zBp1@_SYsHk6BnOVrUMDsAdmS5YxRS5eai)f-SDPZK@Los4;k=FnLwOy^h4ebs
z7{=>_Mw2gjd!5i|lJq9z?{)EDucNF&c%7_&f3MRp1i2I$6)Y0qb&N8c*U?9x!pty9
zEUech0=zB}!t3}`RKYV$smb5#*l@#@e7%k{HAKDI6iJ2mIuZ`&btD+d>qsu7*RjSh
zUMDn~e97DEghrF3Hz9woO9XozWfj8fWc~YlorWRErO2pYkpQn_l;OOtC7johSXi%X
z3Glj>5MD>wh44D5$=~bPaKn{+y^b?AM7`P+Nrm@15)S8eBpAx;NG_z;vBof7Cp4OT
z$=mCMMw6sBA%CxH3HCb5Duma``uF!b4MUJikx{`S0ba)_UA>OKT57%YNTF}errgFm
zFHsNg^ANXOx8fn=xN*fp&czcwBw3@y8$IN_Jkm?t>6KoRo}THIz|}jwgxx&UOV-^>
zy`awIS5sQD@-)nh$mEne#(W51ZiL(Ii{JtQ4>C3(on&dlbb9nWKt(k)w)xiK7Y?xK(_Voxd?dR|D20+6%dCu2Pv0jYNyR#Zsz6Nzj*h
zrdDQi-E_&H_?Sz%k&QW;xlRm-QnJu=bTjjNb4T&bYc%J^_Vp7s5eVYm8m
zB5_-&TdCbm@)Y;AiE6eio4n*bZ1NH}Dmp!~)6%Rx>@gA)%T3^Dg{}oQWngc${2lXn
zraRtSq;JLWcg@1KKc9r|RZh*yJB>SH-z2_OPtDOgGx`LYxwqDOd~RgkiQFypPvdJM
zH6QQXyiD{>_c@Mk;5E4U@{zY{MjSbeombc6o7xZr5%rwd)PnFwR+|
zz$DJ{1SWA5CNPCF6U$IYmn=7o?6gjI{0bGA*t=nPnCg*$9HguSw-tk6p0=i~Xp#mh;EPX1I
zjn@lkptg4#<}AG{(4NX(f%bSKXOGHBhp51`ww&Nzfuuq&pBH;eHr_)16==!GkGM5A
zf5{LPXwKKDKu0egt_B^+>{aLxFz6bYJBGG!nLCo%Gj|BMW$x%D^v@c5G&1r4UBs*M
zEi!&pW)?I7vCV9a3_Wb3N)5EhBI9S1ShLDrEF63^x{y|*vtz=i16yGYQ
z#UM`wy1#l#=tg+dm&FQC8DD=kKIThfmiwHXL<~cGD!^)uuVAphTkP`Hr5R^g%5qfb
z5Spi|b5#C-MngSK?y3~=#YF#v)s!%u6<^&@6E#x8hLLId{!}CV$3^ki!1HSQ44tMT
zP06K-PA?UXHXGJ@M?zcP#SnSheAr7v!fJfL2(4?eJc|=h-6ESlcb}kPylhQ|m)pBc
zOV#p+#ALM;%PN_s#8xm*b)E%VNs7|mg!GmdiZy-KU2C|uvhg=^1S*>zzc#RPwb3KL
zmvQ8n?$&vLrMG%HspGjN*izRd7E4_vES9=TkPi1=nEDshEZ=x8smCy+EASU!4L<#)VMhol@6w2s
zHQ}PJ&+#;PacO-@qbu+#jiJG>G=`dBDbLb~RR{0F$Y}4f=*c~bVx;%6(NGd7G{NlH
z_D+_uTLj!Z-y-1ZaTW=;md+pZRC{dtgr=7u$u2HwZ`gL+^OvEcD
z-sBZS+79tj<{m-1jEKrYXO@qgxtV5*vlwTMvzlj(vlwWLig;RLG15klKJl)$8%sna
zW<*4jxsEs=r&ob{#hBC3N4UG_L$66CUTC9_=w?e~xslEpYfc-L3yE&|Sz;_{Xa!Ko
zwJL>pwvGMR$SZ1zF{iQdGbge|nNvkX7B0qFBFrhOa`cVk)(kaiCqa9hIbAh>%hxNR
zBhs8Qswl-`PW2$7K`v5MYuOql5{VTU@+*6kHI?C#q)>B3N@5B(R@|-Ob^|O)d~%^m
zG}&fJA$E4$JsaTq7va;IQQI3cx^r30`G;ku7=V7hb&_$HEJF9CRt2B;}
zP`c60rEHv-a!5z2Ba!cIEFH?-#zljDo2!U)lwADCbxS!Ioy#?-Cz;a#Pp*e3e?Xss$>>0T`&R4%R|w=T?7)a;==
zXt~L1zV8;t&4#Bi)YN-=B9Taxo;qpxk;7A6g0oGu#|sLbLEw*sCt^);`X|P-S~qpv
zKv$kRb?ee4BemhW#mMa@ib-Y!V3whlXTew1-5!@8Ojk8nM**$3agDUmw5MFr@>}(-
zI8Tc{D^P2c?DyP?tZtI2QQpIwr+^Kan}!v|=G3|3=o~t&_?*!egwANaWs3gRb+p&;
zTOw`vtTTuecVMf&6~|`LXGLa>vf#2tSy8!8ax_$yNINP^FPlayGJB+jnmy72&ht4(
zCFh8@p>xEqI6H^R6^Cb6X{G0gwcvBaN`5?}t4@@9^C_B*@_tG-PS5Y%v4r}(ug95A
z)#+h0ccl?n|5G)`2(p|-QpM!5B&`PW3#uYx#d1;g{P?M$vW;
zmqO9wq;Za5hmi@>!7ANG?Kl(pq+PETP#4MB;?hPv|SrLeCmOYf^!Pf
zqqYq#%F^t77elU~NUq*u>O6k}7mt%~)ChWc)9LR0L~
z!m?r_o>kJ6T1q)&_{}IGLyNMWLi{R)2Ebv36+k!TXuAAJ5`m9m?PQ>@qD{m
zL_9-RXt+ew^oUylTw<#8o!LamEy6QJJdkEn-)gs|C|pWvuMk9(mqK`XB+irP4QMjpQ3$`Y=Zi8
z>Op8tZLD0#5&I#cTMSMWABnlRJ2+a>aGgzRg(T9L~P*=1Gk{=6R~J
z5UC~O3aMgB9r%K4C{k$@NA6j9H783xE)=|*lryDw{aPBWPyJeSa{a0RLt5d{B3yE>
zcV%eFo+PN5m+2Z2t}0VIGTbUmjy%obA&NHa^6^57_Z=$4-dqT4U3vm*mUIX~bRe{a
zN;`zsqH^o!C1cu_EzwpL4b4vCl@&65XEs-$eU+5h#Ff&rFA8jPK^pw~m7vt3S5upy
zEF)K5nH^0~CXs3)WzNLMx1HTskakf7we^H7f};Zos%BH;BsR`!4obiLPVS@G*VO~k
zNrNo);NtKW4+^RWQOo9fuxPiqju_spjz+y`jJJAuJE?=LOBF2pPdw~ZDkFJJ=PepV
zJ--p8gF6W?jX-GG9BK%wwDj7SSOeS}YLMP-NMQnxHUjYv)G!v86r?91U
zw2c>wbu}c?WOB27sis^NnH5#gv7!pdcBz8i8yAI;YYlW*h4$84=v0or_sQJ?Mb;{O
zl0}WA<&Su;l1+81FDgkH8t_aq{7jins;TL4olI>${~)WJbXRGy_LB~}gr45K7%gMR
z(NQ>_8S{=J9pWlx<=k1xkZ;Bs5*;MfKu$&{lPIW2=W*g~qC|WkP}*cVg`j6ho60iM
zdf-5hCxtTJcCbLTi5`<9gBfEhKaKFgC>m%p#&Rz`EV;y+S8AN8**)Bo8EZezRO(6$
zQ6@OjWQSc`N#cp$nVe&2k-^1SX%4pwnyq)xE^aG7ckm@lbb^Xz1mc;5J98P%C$cEA
zl+MH&rc7y}lBgFy)h0V>zE6niGW2vQeytmmiNyFn`rkNugr}HFMGLIZ{>QQO+(aE=
zmR^{nnT)y#POAN_qFr*QRkR7sH(9M*PBYAm>Yal8AGSwlzc9ePV~m2F}fv*%9czQ^ErBW;(FyKQ)AY`^->o`i9C^~DRDbX
zp|)4fB1&cGEU3q|%8@6FYezV=Vv!H3G3xVgW2)Ghk#`r2
zkn6h56WBOELG78`PllH5!sKbf;it`1U|%tH?b&I6rP5U5XLT+$UE4;_Ch@5$dMKpk
z%Pm`fHY_t`lR}3=V*1g*avKfx;{0TqNs(1bh7Lh0o%BnBE=$zmm8()TW>uw7Lf)j0
z1m*_E=XkiHEr(WCU@Ji`f0}dP47gLbG+m=Vm+Ppu1kFuh8eel=Xel=zl#|ZjvrfaS
z#gQ9v=Rd$qhW4qK;VR6zk~VtpPswU7OC)2Z^ZRvvHDzwBCQ)3OIy66d^I@QHw8=I80tOrvD)V0y9mZxPrH7&-{
z{Gdq{pwDgCFkVumzFD1`m{N;5ygFFuxfUI!86B2xt+u~oQpWS^4w@~op*9Srhk1@-
zXVEqB-*k%G{I{84Wh$$kY1c(66P*Q7XQpJ8EvYtp7+r`=voCvSB~2miVNrVZ(q?l_
zOPY3>dhNlL)bTpQ@_BpM;I>>Y*+Sb>HnoGfGF-xIQn^;QV4ADB1V<|93~an4pWtjc
z4B>X@8WV}clT$j29?8U-HXUAf6mKw{w=cDHw%UtQQ=FR4cZ>I9%r!Q+*q-aA>4#l>
zhzw6tQ?^-L%Q64Q-Mcn7lH=&Y^^+{w^5x@Bk9NbSdaE5}$Ha;AB}0~FThqFYBwOYE
z_3s1Tk{6IkGSlwacVlMOr6eu{K@bE%khu0gjLr`8C3JuJybOkMvR}Tu2B^-rCiZXC
zI_*m?bAMbxSf2GR=?lhh}FMlmUHAF2^zva#2cDpj?37Cjin1Dwt&8VuX
z5>S;VaVdg2i%E04-mQM~&n)Ltaa8!vM|Jq9GbXQb93l=la1gByS;V~){7jo$kwS^O
zse&Sg%!Ky1+)DDE$y#020sG{4Z;HI?a1r@(U_+jIpz=v^>t(fqm?>ve^)39;o=s`6
z(b*aoK|YjRe}6oiYS~)2{YKcFa4g&iR25_4F>_xaUu_cvoiF-$>2VTJ-TCM%787&3OhxD6&N@x(?z}<*pRm@fw3~^
zT*S&4u~}e_0XgMZ88qs)GG*fQ7`CiT86Hk93R$_3d8W$ow2JJSjFVVQc`I|$Gs6er
zdf1wWGHH1otVLs3vaO8Zq;N8{HmVG|6>w-}gpi|F#-0$4=OZ>Sl*fgDGj4rM?s@~ohD`|W&n(nO+(u%7cak}Henoj2Oi}5gk)|#n3QP8{+C^)6*;KH$CbI*qP
zA6wf6{_W++l8X_ctsq8(_K&Ry%jRB7%o1Tw6unH7?QHtXfFnZ3{5vAF<>E{a%Avt_
zACpIKH{uZI18A-|K;d~A2y
zE+@K;ytBu42a_1l4P|{yf+YEtIHWV1DA&ZxEfyW(MXgrQ#Kj=jl_Z9siQ6@b-q^
    r$s>LE^mRRmSxKtGXv
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�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
  • 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

literal 0
HcmV?d00001

diff --git a/env/lib/python3.12/site-packages/pyzmq.libs/libzmq-bea72b92.so.5.2.5 b/env/lib/python3.12/site-packages/pyzmq.libs/libzmq-bea72b92.so.5.2.5
new file mode 100755
index 0000000000000000000000000000000000000000..23ee459fe8409d244a83586551d38a0c95081298
GIT binary patch
literal 965585
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%0AGAifJ7A~o|gj6Fw{8HW;E@|BE@Sg
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%0Aj6AS*rA6+T^cWDj-S
z9IVUdli3cw3reNqRgW|T0iiO2Wk6Zw;A8^x8JGBkGo`(4q!hHHd)OS&|ns>E!OH;6U;S&YWce
z4&E#{H~A?BoP~ahA8%#B`R|ni4l2MMIcPqxN9qO}zQiRR6Nc1&5uQ`LLMVF@^MJ}r
zrkG(t$CKZRUJBkL-dsI-Lp4TA3NC7#_Z5UV^@{3$eIc`>qDE}sBYOs%V5d}hd~ynQ
zlms)SdIf@29FJVDg;?z&OmQL|xagCw6Sg(@J2gTQX8J4Rr-B9R(hA?9eu@#kGyIg)zVJo1_J!hzm715}40W>}qAX2D2xT>e$?GgU
z+yMQ?g@sS24IU)`G7#KotEr_=6*+t>WeJ)J1vl<e`hd-XO(qCKL{?JLyi@~P2a^Pu={Wx-zGj>(r7xA;XMZt>%u;uf22++vOC
z`MEO6{C3ZuXiZE6Elz&1IvR2Z)0(cB-K6*G(WxS&dcNI|YLJp@;c=E!8~EfDBqYI*
zYE>^GRh1SZsSag|6IrUc+~fNTshZ>E6f~z8QZ>0bHkU84=$d$R4URcra9vLsCa=NA
zCY?Ip^a0dWBH9MP=$3Z*yE2Na1Z3R;#vn~br&?q|?ZP!;?!D>$3GAt!`~ghZ4?O7*
zY*)Dk+x=K4w(yr&Z2Ks-?@5Be_M=R}_BJgfx{WC~wMKKfXZBNUeVx%H5Uh3&03B)o
zAk8Z8h^EcZH#+M6rmgJM3R-4`=AQTIXl{cE(Pj+VTv_4}2Q?-Rwma;lsmK_z_J^eJ
zB}+dy#L&a0a-W}IiSaX^oPt%7V2JTnh7e<}79uf@WQr4cU30mUw)Ti&U~e_VcvX7~
zm}OO~CDTP9Aj!m8hDWB=zx)hk72IX_8zaSwti`v&hNBmt>GZQXk5)fzMQtTSg}P0+
z$10GmJ~fYLN({GM>;u9}p6et}VHWQA&|BWIm(F||%}+{pWEIo=DYSsu$#OaW1g!F!
z{;M|KX-s*We-4s8an;4AlQ7ceNgO^rp5s(zw>#Fd=|ny`1$#+?Vbi|dBwl2lg!=>h
zgj)-#1Dp2NT<+srflUVJC($BKcg+dR9;BN*pr!430l9U@*e1L9>PHkPEFPb9yX-Tyc&qqA0x@bd9Hi>524|_
z{c6s8P0++C82)APlIuA&sxqKGI6GYJHjA3Ytcj~V9+z4*wG~{#|D00^S3f{9tcRmC
z2`65{1&IlG7NOb}8Vel6XWX}{9{vgVOjn2d)c1rAJ<-I&t%0rT{!^6(tj{+Qzd@nl&P?E>%o-Jb1e?zfw>d)iJI>V{{(z7BfO?E(h%_j1W
zY6a&vZYh!hL~$byktbHXy+jdT1SM1*O+cw8JSi=`&O&=XViZ%>!me^(_|8DPoN|fI
z1Zc;3(7Hv9=PR^FD7269$3irqg*&-jm*_V
zPR4$d2CQlBU<=kT1*;QaHGCrK5Ex@q>MRB8p>aaQ+#p!Z0z_nv$qrCPC|I2Y>o|ZV
z(|Obrnp0=~6qN7bJ?W^>9=qxxWP@zAqclNSF}7t9Be(q@gizveH5X?6CX!dO?W@^3
z_V|@NTWB774rO5$O(fjanSRd-do7{Mo|e3Wf^~+Wdj>KD=)zT2{z{eERfk}n!~EE#
z4YV9Zt25+0r5fD!V>4RK71reTJDQ@x)!qs|IR(2(f|2w+e-@pzrcHSYy#5aQLk*s!
zx!ec)$Y>=z8}kl(+6FmQDB7aZekfL7((-ZCk3l}>fRFH-V%p%%2F`)D^XJw{=S1cs
zKj&i*Vfu*aEX6&9Fu(2Xao)Vtd>ajH17n-t9?Go(<$C%yCR{GqE`*))!DyFUStOn5
z{Trprc=u&|grkIds<|(q_59(Y5^t91Y{g~!UxDer$mdfA+8t1cpBN}dh{&C{bqx1Ayl%MQ*8VOTpPh0MysD9!ztW4k*``_X#)K1JUf@LrF6jUWsD=k67u
z^G6)eB!-ho&^sJ07*iv6BQY#fvaLZj^wk5kq&e@E2g0LBw^V_}j1r84(c8?Lz^UiR
zQFlp8yrq{F+iQjp0f~YV$*%i*4v~7W&WBrs{IPKjwqZ)Jpf(~Z8Eg#3y*z^1b&|7B_mxA@ZH>4pRVMK?|(p*yI*PfN)X@z_f(h{N_dkCd$m>=jA%s#l{zuYV0kUEoQ|
z+|aJT;9^5vMk-fTZ0BfTtMq~oH_D!wz=R0}@DWTgbE<Jg53MJBClZp1`HfOpir><#0So{L;SrSUh~XZIl$<23CA|`(
zwR8%>Wt|W{l(ZY__WGKy1590%(mbn{P>~2U<|&XFE)B}-{UEf8rBOn5Y49LH)|U^|
zZnYijoq>Am!QeV{p<49IlpAAV6FSWZ`urbp-I(@=9|z;ixJ(%|I(qS%_o~wll~i$A3GvjZUU@%zV^`Q
z4ah(z=VPfiC#6%}7|Uqq$B)S(_F^-l(r>91_0AdIW(DCA3Uwk+XfD05-Pe--SPkKl
zSp?L9=sYWb-o0sdbc8&^Mm0Cz1)+oS&J$0k0wC=J4@&nY@xcpA{QXarBdkGxiZm*M
zBgy1%l1>tB>BzAu|1>EunOZW+?gNP61G|t&$D!8l3ibDh`){{L`h!e4fXW-u^1ZH1
z&B-BAdZ<)ivW_}|y^iJs6{{rgN0|6Zt4xpe#V6cS)q`a`#^bf6U^6J#gepK4>>rRW
z=>>J{p-co_gpMFK&{aCQHJoz#x;qf}gB-}2aM!Cs1#CjuP6%)pdH}@*D1L;dDtoC!+Qo9q21JEnqYBy4abc;x#)hS5p#_LnY_#NHMB-eBzHwD6jvSR5YnFB{MMP
zNFB!bLB=0(W4)-eST9zgu={&>Kmq7h+;>CZ#H;>gZaj(J9V?cOTDaJ6_g+vb%gjP&vNINRg=x
z^Nvz13;4s>WsnhkYC|$TGv4WR{aHM;vBQkX;St)KVf4s7kky|~MYOd}(lFTC-5>j$
zvtvKt4!6Y%F;Y_Otj9$A0Ttn>amNM5ppq_p(;HBYx}FDJV#gqRKj{oGycS%n0T-*m
z#c~wFv$=mN;{fSx<>bxgFRh>>A7a$-s+>c1^l)4eHa_+;N~1RLRR)`A-GtbM^%G*#
z!CX=2!t;e*MM%b)A76QwU<{p|_DO7N3#zHZb1Qz4wsL76#yR&gIUR^&cMHp1}k)P`Bxmw*P=`VY-L7-sSf(&L&!lm$mgS9;!bv
zYQav^W&5J@c)dNx>sbI6v1PVR&mt{r0|kgN>O^O49Dnm*{?`i^54L6BY+|!@sdZp+
zqkg=(55Ha(aleA}y05O4&Wd`%FeTj1_kZ?%LVBlq*_p
z8Mr$%3wMXw+xq-FhYEpeGc9b@3pfa|zB;-BTE7)&bA)fec8G()q3k716d{ce9OnPj$fqsK-XFyo*+@Tfueg;t;o&5Nt|{usO&
z2=|z-D2~srr(OWKjcBlWeC#J&2W;k46P}y{NTDiRi
zu=WYon*G16_0U^+O#0N;jv1)(sg;U84?}ccT>Za9zW~&hDs$at)M1V#BIVm<^LoYX
z)_v9eoa~URJ_3ABWGBt#e%ua3Fe0|s
zqY@~N(EV$zFAHLvF7AafjrXsihDRXO$vL0!b8f_Ele0Wc&PqS$TYk=y(&YTJpYtI<
z=YDuJ147{LBWo9+la{ripT$aWHck}x@Rs2CRR#pP&}GdKJ76F-a^?+YxysSFF`4mT
zcw6mG|6VA9Ff|Du1H$8m3w`_IFm!hw|LT!|G%b609}&kV86U7^jLpcRSB*ZrB5
zuw|Z05#zV2MPw0S+OU3&-6C^!jt~q``bJO
zmyrJJ8$&)k$13DJJKE1SG8yNFFj$d&pxwoDiVcfmEzASUbqRGQ>nwv>k}6nC&Q)Y<
z9ZBmjc0C6LE0+f^RY6g`;)%wtRba9}$z=`D4Xo3`Sq@ZKFho3J?wN
ziJ07}x!jl63!WHQ(@W(tEm_oP;tA$?%?;D$*&U7^1b=Txx9f
zskW84BDJ^IN|v_rvX)n2yii-&+i&Fqj&V-p1Jg?9I*SxNT{TolWQ4_$K9V`hMSrQM
z=lQ4nJImnqRgGZz;1Pyr90V&t)#7T{_gNdxl)N%L!2P5p6wcIv^&i@33HP?OJbck!
z6hzaltGb4&P*4odtVH1>M;i;CZVUE8kKtJelDeUIlL@J!vrUqI^pcXnGA9P;&SdFv
zLZLtpREp8hEf{{XFx~kB*_D;rwWPTWxQAlV?H$)zNUlPz+gL^p#a
zy!+>V;duXp2aE9TzE?nat7vA#BS)C*K>piznZo&G!rl6lO&WUAk>g&2RsvCDNtUnA
zNsdL(gxG~XUP@em#v9>W?CuyT)f!#tFN7cWwB_vpcZYBz9l8n3Yb#%d1Pslni3-cK
zB~s(P%i4j^^u`{gCf9xJ4Wi=#*WM7I^XVT31V=V4Zx?Kk60%6tn{eg)RcX0$EEQvuGwe9`l3sS8r3U%!ZX53vPIOjexh{$r>
zHQ0|Q5v+#$`rm^6BU*@ZIE^VzKVYq~=&VnDIhO!w9x;_i~-0Sg4lhuqDCAHK@*{MH`0L;
z{ecqZ3jSEa>@H-8v^IK#ao!S%enNA(_pTAz5D7Dq%8{*O1lEwb-{o6>f03_Y>+ie`
zT9L8-I*v>w4Q{s~x%^p!oH5*0oI;Wlf04jM841SCwn};jmIe^!K#CBRV3JPM20eq5
zXSY)IaIT?de|{RX-$2An{3ovvnd7gOUd`q>Z$b539AI^3G%d3y71>dTr}`iQQkaVh
z7HvxPF`^c%i}Um%I~VHmj)=S*4MH(mv-1j=m*EH=Z=4JA$(NbmFNsE=DovDW8uA~w
zN0LOM8Lp#bQKiKr@kK_b?kFlQ_oQ8{1U|ego}7a3CBZ1FJ29}L&`DZ|-EnKCIFW0a
z8L#>8Z|atlmJNZ0UqL-C*9rKP&#tVnj56FnCGXW^GcyilC5u7?@(v%^Cs@7A0?{9H
zf{C1ebPNloNVbvbvi0EwB|f`w8+dq@ke*wWVrLV`6p`mFDx?Jr&2JK1BReiMG~Zuo
z{>eZ~^8ymvDVVdfP*ZK_p|Aiz^G}}jdi`y$3(d2XGwx%!v#W!vHC_k7SUn{8E~q0V
zl|n(hvtV6?W=Dc|^7V3emIX
zo;hOXby@syA
zUGq$)IFW(ME%$O>tr%CD;Kny0jUtH)_xP5mnus4@iM?u7Q_N$cYNYox+B~hS8o{TP
zRfq7W*m3w;>?~l;VrL<1DaN5G`~ete)gm^%Y8Sj!Eau;U5jDe|`jRml&Zf}Es`6PV
z9{KDkmHqevCKNTEDU#U#5d?_>?*&2#BYzuT6}+D{CD7n`lA=}N^{=>0tvJ3wpt9(j
zAwMJ_$hyB+gQ3*;0+Ex@oOJK|IJ}r_3rMNr_`*8;JSW6MML+LB??BZ+EP+z>juY^!
z&R|Y_orSB+d!)#*%dP#-juopKBGpI!jT6r}4#pQSp{P+-hMoSkI|xN8NEmB1w7()0
zx!06HgC|RhR)yD@{{}^H91SX3Qb=|q?OC`)Je;)0I13bDnG;?85KnE|8AX5>fBYRZ
z^pF*3V?~XZsLseBTw>R3R-WB035I9m6v7N2!iCL%*@?WRc(|{=D!rdHz56<)*c;nhioK~ky)ZYx(_GRA
z=U+adQh>%Q5<;+oV`Xv(7)U5S(Is;mA2h{_l9Zw59W;itQ!uc<0txJyj#VCnID
zo}LDcF2)L~t1ic1@8t@-K-n@4%Jxe6!3wP$Uxg^Uo2h2cMry@k{tc@(blC
zX3p!5T=$q&Dmduk6O}z{Sa+Hiu(QQmW1yy^I2o
zaL;Ccrjpd$kEYMPjmbR%xk0$_F6XbCC=$U~IMH{p&e-J6>gadUp+k#BG*`_8EW2_u
z0cW2FFdt%Bna{@PQ;&>DJal0zd&>jI(j-k>@tp0k6IM*Cg#!
z%Flr=9r_%w86U4Vy-2R_b#kxV#`dCHuuBJ>ddF<(A3D=mO7_MhS85@0Vt=MMk#m?C
zuVYqi>V_i6^x}`0(^cOFo>jP+ba(tsmIHjAfnMAiA?zFu?&x&RpMakrA3gq;<^|q8
zzA-GO`(=`78iITMrbKy~mUr+6-}xILw2>)e!b{;S^T
z{X0Dr+iytgp%5>NN2j$Hz?C_e5Q2#6w_pI2C-&fJ<%i@cR|anUyXld@mg|H8Y)^jB
zVEcn&yGK8Z?eml`tba;^!S+1jhV@S^L~K_t5o{e1My!9nVz70p>%mrBq4az{+Sc8{
zkK@j51(!es!PWJP<=Kng)}@aHFi8zI#_LdKc`8Ii!{wNJm@HPHtl)(N>KIfN_8o%r
zXfNOIkTjx>f56aT8%FLqxdXShbaa-ABo~$hwn3m5sEgOaG
z3Cx%WtsjewY44z)mGgDRHw=OEzI7=X<^F3C>c`-L<=uYrC>zIGQQL6vjAphOGFv$)
zGvHA|iU3u_%PS##P(5XI@_22lA3oBf{Yim~?dq67)ICwUFrUdwBRLK?pfmTTQn?
z<6K^EEe<xCL!PmZ}ybR3ynl1e;NYa_;
zM?sDjoowU3=4_}YrfRXrI;*QD!Qu>B?#+k|RqF|j)AbXcVE+3a(*cgru6OsAwga5Y
zuHY0Lfjyz1pbl)GJx{D7cWWVbfJsboB8N)9fsf#2vcnivYOuyn$Tw1Z1JCnSOC87d
z($Ee>KCw5Bv%nm$zzpz!`Gk__6g(vf2AES6m;pX8iRT2Eg(9{Icg+d_lc<`-hD02!
z5h=Y%Bz)c$#7-pqPE1rO(VwzygF>W+iWz7=j+(`M%C0;?zDI7U1K|)H#}EwnuBXs&
z?4_a?*-p`7{$-%tRV%AbMB|w&t4`pLtrhkCv=y)aN|=-hPJ=Y$RGo)>#n{MQQ&aRJ
zng-4bB#Gvv)BmFgp_M+qjQU;_itn(h{vcy5YvVIEt>nfcPVq5X%AXd@oERdcd|
zW0?XSthwAXUZNmGE@TE!sdZ~m>BmCjmTrf<3CI?;^Wk`1mCJ9dt3z4uyG-dac;j?GDV8m
zCTPV$*PZaBN2_DQv|1dZRYMZ3!gMMM24Zf+5!i-2?FR(lGNVh38o#nPX(9c=frf+9
zy$p1Fh#_!*jO&E%(@*?AhioX%mr=&GFQC+04Wi?oK=x%X53+CJ$^&Fr*ogEGLYDXc
z97^Jr#8s`Og>6c(To_10pSJNoB@OT#
zb3<7N^pG`R)y|QSK!j_>l@b#KJg&v=qaCh85)4gl;V>JIOwdB4NhVXA$j>5*33rF3
zqDl5-25OQhWbhAHn>T_
zd>}&@_6&clHu&Kg0q#l7N#M?AiW7NCbGcV7+0?zV>U?M%xa}|CPZGVhDa+9h7z89+
z2Nsb-6wS6dPy=&hcH}4J7*MuNs1BUz>o6y7vSpJN>A2Aa3}#5UqppU0w~C6Hi9HCo|KuM+4mx*=8s)-2r~lu(dsB$74btS3r-deWnCxh3qNH#m
z17ai>`w~o&m%>Shtqv8-b2=h=3Q>F^{Vbk?WlwjLWF8K-p?HGZWm8NlYn+Z|Wt
zJS7Qs{8vB*_<$rh3_Fq24RhAKh&9xDXu9#Sm7&3KcML=&vG0?|!x4oT4@+Vj$`^CE
z&M4ivd@+abjM4!h&waHbf3(dz(PqZ?2M
z{9Thbz-VZ}z64m&2o8^zby{m7;okQa`izr1cP8bXo)yM1&%4mR**NB>{S=9tl&L=B
zTDjC4jzYkBrJ>4>^ow%7hw7*MDYi29mb$lPi@OQ2?RdllI&|CmxU&Xxg2I?E`hNW>$fOm-mpB?W;ohIroMIU5AIy#VK*!aw{!3|~q*IVDRZ#Zd6H
zR;8d~O-6dF=1y+RBzHS(l>w__(n*D=vh8*m`l=JuRSBLBDj1Pltfy$
zO2#&vU+ml#EV)M
zqUS<+#asYZws+)Bz7fnZ?+Y4n&;WAZhj?DbLh!TQru&T!TqW)*35%XxV|5@Ff?rHj
zPOmM06dl-?KUN1`E7BevV!%vwQ10RicbUU{3XYjbhkbgk!q%H^T*b;Mrsy4%7CMoU!)}{Wbpr=L0#okSgHfh
zH+cPFvLh7Z9EzrDNR%(`q{;)4BfZLH1@50fc?uq*J!y3nDi1z4P%vW6=b}60M3UI!
z2$}anhFkuVvbrJ}Tk*2HlNtJ4=ekIxhzHg#o$fA|MAYMbC}d$B=KpWCjKMvzoG5@0
zY}PJ}*_uC=F;@s1qJs@MkbFx1(&@6aov|fctHuye^V#@EIwh#D+$JyKPv=B
zFVsvVdl#lS(ft+5Jpi@Hn;ZMAwz4@VxW17^9bk(>lmwUyKK-vPYDX<HM7n0B8kCoNeg}~@!0}hghDambY^y8jHCqCaJ+NvGdjc}Z1DXxF!mw;0i4mK1?*~6%5T%tOY;$ofP~$e{5^*pas8^P&!d?l7eA0
z%Y(Coh4pCy_D>ZsB#VGG09*wu*dHpDXU!nDIYjPjcN;#vMd79=f%VU(e0V}QQe4T6
zD7ig@DNOJK2_(?v5M)1sWU;&?3VgbU<9Zk!wCQ3mgIKcsztG
z@&1fOSZiS(j0_=_=%8WZ1$9-GQP_+~)ScQ3__cwJsXVg!5(~$AP4o
zz&ZmSa&1uQiN7F+(9A`H)!~E(r*tj`)H7fV>rDiE$Szm|sE55GNn&nw9hm1a2iH7%
zA6XYeew;;wBPD<%wA|&$)*@XlgUl)SMnIce{WQyi%#vlf&706v%imxL8AL
zF{;-IQ@!SrPGW#z*4`+nG`v{gIgX2I^RkabRN9JbOY0E@{T07#|=`
zlZ?F)I2GfDue*AuVqA`Adn(4=lc7uyh#m~z-+g!*N$x-vdZP5jLs}P57
zYPpF4p=9&~gJmd2OYZ5Lie>O821~JG+0tN%z(aSp-Bc`F;+QL;r
zHTv%jS|gz)XH&5(M4Vi(d?G7Wqq7Z`(WK?Ye{3RO93ds@!<8H;`b3
zk~y(SEOyH^(qVCc&t-T>pV9dP%T^nIHcX>AmZt>{b~@yj6Ftb`KIBVTAQ$d
zERc8kke}hRDgEzRATRbI=lPJuSs-IR`S0C~c
zAM$&2z4W@TzuK$&5kBPWSs<7Cko|nf``Mi}4zEX1F~S<~BH=2-O{W_#9EN{UPYBISETMKndul0wQepF#mU1q(`1
z1%f8>@iyQj`)21R_xDo-ms4=6pJL9XLdkYT=HaWUvPeri{YI3tn)j_r3ReR&r3bDi
zWJ*dLYx>oETT*c2l8Srzrqs;9
zBdK|gQDoAWs+b*s#cN&gHCk`rKfGDtG4uOubxkueGo
z!JZ@oh1X&M9YT@Q77|BwjqL0qHm9~kjBBiZ!4U@ZLIJfKlJs~KRm=q?(zf*rdK%Ef
z!dS5sMrbsH70$`l6B6^DSBm_;)PPraL;{p%8DJ>8w1H)?cZO_dp~%#Zwbf5r1LQ4y
z$(wwx`b{gZpiE(rj+}$x6dd|7O&miaAMwc<(kuxkB=Qw4F4lo*Ci3W1reGb6Lb;dT
zgQXUmE9$EVg#prR(m%P{qrXpZfW&naCAejZK1-S%X5{x^OWt?n3D#w=w&b0w9d$@Oeo^4|$1+x~df
zr7Bgpbjko8?WNehpW~%i{qXOPLddK#YHo%yl2Wb0`sGopuw-2W=s4&yQy`vCIDr1J
z#0Tilb1I&bnSt~C5Sl53`fP{#Y(ucgb)UPDZrSPJq69iMM(eFtPme`81rL`{Y#D=~
zV$3_qVlFk6vJ&NN-uv!k!t
zvQUxL`^m!i@CLfs)R__wvVL%glGb&{06=LOe;cT5V^
zq%~@G&yz(s*Xkxr4ol$EU%qlSj#r0fH(Y!3580#IKR_E2!%nQdfD6J)fG|r8{8a<}
z4Jzf%z%V+O-c@EJpxb8sm
zH2Gip>zAF)mpT5Ip86$yNpWxYr3&(I4BB6`zU*lvC0F}-^AOC0eWr$GJXdzjlb^vV>7A{Y2o~0hD+lBt0o+johdBu{SU@6$YT@ec%84r@Wm~wd
z*Xi8oHf7P|n3XswLWsDsFNQ>#Ew(tZ#69jOt`=O$^%VH7?Co_VLhoZ%qH{Ep88dKf
zPj06ZKRjQly=OJLt@}7%y#8S4gnlOv;dY2XEIKY54-4GSCx&>~a)vm>
zbTGlj{Ef1)kxRwE#)p7{bB5cLi6F6!IaWfy=ZrKWsY>@hys&
zCyfDdUS3rTa$J_KcoVj#
zyE6m~RQy{MAH*UV-TUuqvg9J;r7YL!m3$lO$r*Awf2@TYF`4Zi{rLjV!aXgLptAMa
zt;T-^@@_aXgPeR3ECwf4g{xq@^#|%VSy^dLz1(b3;{7y+Tr-ZGZk-5j6qd6~v)hT2
z6lUCQUqb2^wUz?zIJtc@&>S0U$?X+C4^ac=^uF{wR?a6D!2r@7#>)F+H_~qe;s`)w
z={J+0B#Gb=m=L#&FQI-j0J;a+!&8I0lB~&>Dk`0(PLdt`@V^uz?LRB8&i&VwaqyIPRvSd`CE@OYSE^h%m
zozSp4dy)v#L89&#P^hd+Z`S2QzWnC8ga-{R=NVV=8|gj;BbTw?aL7M+xpbs2CBY2&
ze-c56KC78X$oWihqFo7$*XxqTF;`2Y>RZ&~smn+#TGr?je?9Z#y)fc8dj4#M3M}di
zvt8EloyNt3EkRV!k6DFtzoV#Ki65}5Hi*t~uuuhZn!
zaRew?#R?jeScCggFb%Uq+?i%RDifpvudn0B4DZntJUmdaQ}E`0C>@gRLX4akwOc|b
z&af#_RYQs_(@Oe+MoGb%bd&A+PuMtytJ4(R36T0Z&w&lHqWl;OjxDgPQZfks&N42l
zw~eH>$JAUr)T!lOaZ4&15b4ZGPA7*gVUU^WD}L-~`70t8mcLHHH#p1B(0ii{g7PL8
zafGe~p_#=W?_GxDBW=SQ552(sxQvZXpIa^bdTjl*6xteiTf!%h{6y6ZQdBvgKM{-+
z|0yVb@lebW6w$)7&{Yvwlr7hL0mcMI4+sSo4Kq-&sW=Immy9_^FpTs_xO5qYaM*G>
zQw!!#+Dzb!XNq2U{xJG*PQgy(h%;m#VT@4*P1lgO(c2Z0-R}sdIMKZn%01;qDud`a
z0)TEAoiX+o-VpL`<&SlR
zhADa9o*@+>dH=pz$h$?M+<8?bPm4=Rag;B#E+gI}^5!%Ldf2sK_lU%5aXV%3v&wxF
z)P^LrZ2x#tIchH{_yQ)wyQJWJ+OU)q2Sym*^8>7ZvC@I9-Z=12YHtNaBm;NJctfSg
zU67PS)og7y{sh`>oO{k?W|84|F%wmFgiA)h8ml}=PGdrG-Lb;8UVnLAxV9sIEZ4e{
zN6F|slLK74^eUz(D!kq}S-2)$F;Uef1t>jAmsv=MVtRfzB?W2livIs|!xtfO<
zP8UA7m=;!>2I}TqVxdQ7vM~r9gjXxYY1qoEU|w
zdSXgOzc}6UfCXO{HTWb^7#rvm90hG|bo9sYg=mU6ohk5PRy81QaaATfG!a5gGr
zWS%=b)Yxm^+|Z#`?9Xccq-4{4lNM?`Tts!D>o>0vWh*l(>gTei(_V_;`%uy2QFJyTcv#r2{)|&_^kPp4nxHW$1Oo{GyLYk*K`w=0{RRJ<
z5KR21Xo6}L0{)~4K@CfR5Y(#>tXm{P&_$>+LNE)x5%ip^kQ9RLnS#6L6v`buQG`GW
z@r9tf$gMbRug;(*xI~12e^m$sKD!VIp%jAqAxWJG!5L?DDg=)qiemiQ-M3_fRZ|dH^f*x&i_a8kQI-U)lBY7JZ5yKT5T5_$
zo2FsZ{Jv=#-63a9id_q8l-5(wFmIkDO^CZJv<(L@q)0I~u(P)2TasW}a}^ad)`4m!
zw&p0NIMH6iK>#sDO)9pV|T+BGP(WpzgK*-Yk|#Pk~X@{#_{
zAbl_+_wLMnOGa`YYj|Zk#uvHtNR4l
z#e8EJBOSr0rF#mv8VFpj0YrLmCLGmTNF3=PQTJ!j&G3&{kv6_$iQmlTFgP)PDB=~E
zDIScU%=isIriWol&IyNM_Sp(}l2rr^hhY+XFbp#i>6P>OH!}?LZ9cMM9DIM;|Ys{G`*y+rsXu6
zxqw8~Xx0ibCYBRI*DrvspQ0O`j;`Qh0&?#59bthyz0>k^^}V`cd{vSP-Q0WN_#S3WuQ@giKB&qjBys{;K=^)o6(&
zvMOjjawB;>E{Bm;O&--(fnEhrhJ225FF4Z-doP6s28U({lIVA`VhHj+jS0ndd(ww<
zdL8?sI4QgG#}0dQrQbzgHaSp%%g<*|R8)9PmeC^HM$fBSPR<*4I|%k^wT$_$K2Yjn
znzV*iFaT-{z8@DnZz+qKF5phpkt9A*H4{JLJ;-~~5qXA51;b32n)3yFpree}aH9P#
zZqs!OAoex|`sF-=8}uo6#1Cq`ggR7kN4(b5mYB1f3x8L?}il#Ac(NQHHl{g(ceA
zrL2EiN)C^T3c+;6sT^PqPibLIs;lCHQhuN~?6p0nUbV7T%C=9{?Cj02ttBCjxvsRQ
zrbvSqjD$>b^{O}aMV$tzo>r-XxAr}neewro=HiwPEK#)$t-UVpAKLlWJPA!)0#bPH
z9ex;^`1!POXkwnAh+a2JoCl52CICY(0l~oZ2(7dd==ydJkuyS@PkFJ1MJh5_eE;cJ
zYQg+T8+L5V!Z7T(UV3!F#JSR=ll-wgdjE4N6w$9o3MAFxL&Aw@LZRH}FAr^$C@Jac}o5PE>f%*M2xN5k3XnOj$&>=`K^wSSI
zMZ|71;4@k&@;jBAet`4xaaz2?8!S!N>DLzq9Gn{oW%;TNr?%>My&GPQxIS8<~
zJ+)kRHZ>9*<;CtXr&3(G;sGjFB+5pp=HX}eXdeL9BKkx>6_o`F8{*V#*pCv~+XdxQ;7b>$w{&yix
zi2bW7_BXO{XUJ5c!HmxiJxj#C{U}fDXTdneo#+&Wau;4GhD^&qu;IMD)ya%1De%=ZjNVA{p@kSJt^(=L=c(<~>>
zVjv{wq)(O!{WQV87_#g&%~xkyu23c5e-HO)WZK(T4=Rv~`mNabT63h}d}
zJLjW&?I!ba3~_>wIJ1L%eEBKi<5K=u-F>wf^yr@zl6-WjA)M%&3WYIKn2){?FO|j?
zEAsS2a_a;UV*bq{#4*T_$En5aI_W};)zzR@dndajXt}kLL9wa|pu`vcPc
zy88&*B1|Z*+h1Gch9{&&PUMg6J_nAG7Fl<==0FoXLe-AR6QaWFg7a|j(wu3+`J@dm
zvhLz{6XKl}EY!?=N!vga$WbJUD5qhSc%h
zCm#yD__Ssqp#}9G#SZUKNI-~C;6>4;bkKZ*aKzA@a`(bPX((HVm@057`iA-8%x3KchDtifv3F5wGhIVTPcY!DgNjx1y~#0vcC4}mhcd3-)DRn
zOV;*CYw6;lQ*Ry@Uu8izh3Hz|flQ|d?z$X?me#=Cu~3wZFFu(C?1N$tY=8l)&I0zV
z50;}~t!Jl~SmVQdh~CaUPDSCc;NwsGVL@Bj2Vg7%wbn8{#UO8apINxfk#?
zttAiwTm;?4c4~#ZyL0$5X)yz3UI;L}d$R1U@3J?MhGo7!`~*^hm!y}
ze$0yI{(r(%)zB$M*N5Y4eiNZVE|`JTLr<-ltIR
ze>m5HdYJVcd2_J(64#vJz{|kCiynwvCt~v|C(euHRs9nbBi>m{7*n?&cBY93GrXOo
z-yAGV=!8YH^lLhc-a)b&!A|G_>sU4S3h>0x!>t)1TK=xIG-9+{)@y-WfQKAispW8l
zArM&N(cYqnTrwXk@cfg(Vy%ay3-ybKc>N<6sJP1++XKBx2}s;=(9NWc{=7SaFUi~$;gM9!=?wRdw&tcJi<#1neAT*Bd)Dkyfkn6?@^O?KKSu@~kre1x;S9TODLhwufM%iMfCGBmGBuQ3!*H5saW52rRc@mI=sp*4>Kr&8I;bnH0N@P6n+06bF0bM?
z^}+%ZeZ{N?jv;FuBpsXJunS1Y62l&Lg7W1IC{W5(U=3r`?Z=OPO#1}xe2R$1o8OMp
zGZD{j!%qfRs`wES+YFZ;0+Sz4N=n9h#C#4jm2tb{j!*-JjG^_2M;=2r%G=}6f;F2M
zcF$+Yfeu&T?j&&j0{KVO-6AdFfca=dr4v;+c?m-#{>==SU&O3VRgut_a)$sjUdNi(
z-Q{(fygH5mC96n|Y22n)y@0v-sLT>^-ujJ=1oz{OxGscHaz#Olg>(vdRchC>M>
zUGk2QrNEG*Pt;~fnYhFEVd@zvlOYJS!?CsA5&Xu!v;Q0Eyq#
z14Cip;}Y}H+h_5m1em8Qn>`%=RIozh3S7%eq~evDyi#ny(IzCHRTRRg*D|_
zqA4fN_SIzhACPah^qM2&Xl%2SEHu#7G%QY(-p~*yQmg?tk+m&Ft;XtP*`O!Z-Qc_>
zVvDg?CR3ZPq^>}*3#6liNmrfpGY*k{yt26qWQaGK`=5s6lO=J-(ehjeA1WR#MCN!h
z7iN7nzJrMrSnNO1GO;lU1V&meMNy#P7jM~Z-ejInDuwZ&+Nx~?4NkzUzz9FWP`=p?
zB}{o@6gRr1)#7ybl_Sl#?hUFMIixju-2UR+fu6?Vx{q{3H+u$Dt}|pZf2@ahK1B-m
z{~2)9{#{CkIkEiflf}K0!q1CkEj(@uKUNEG0=5-HY~eUCv{?)PvliYXSom5gD*CVi
zN8x|d!kZ`pm!WWF+i>v0U3CO&iL<`_WvOO0{q_MCmZQ)6?6Vuf*0X1N>F};AC)P)<
zu0ykP+Vo+Is$>X8W35O$8&$7SmFLuC_;B8Up$|Ss~~=-)<9c}a$nRpyVm%8
zL|AJK*@)J7t9TQ&#uP#7YmH{r0qA!;MaC)Nfm%4lg)e;4UT*s?&lVeu2jFs#`-RXYa
z+fsVC!L9T`zi}*^-g|dJsFTZR(tEGpd_sD4Y-z>Br4j5Wj(L4NIm&cy_!3Lq_n@yj
ztL5{-&b{%rEAP*eeRg2*5~^N4s@Hm+yV+rx&8iBZWJzpkj*QxG{R`cREQ(+df?!q=
z2vhQI+XIoF!}huOJs?3mxo~oG@HdVKkEQ#dPfpFQ5Q`9zX-42fU0)w%8jjDxtsbxHTH~
z6>ZHHi1r#J(TbO_dn@AhJ(P^d9$ad=SLCt|$3wY>E>Izl=t17SXeR>a%ln8+fNSez
zf~cT>Eu9dq1>OEG@k(Bi1T)>WT!brni)Law6f?z%ex*?EiN}c~u+mZ-AdbSm4^%qH
z3LGpDPfk$)k&j8sGqUyPb`c(i3=~)Q76~L)G)1Mkn3`kGhQ0-UQ
zgHBG7RF%ek4mPC$_4(fzXA#fG!9+tH1Y<@gw;rD!GrDPSX$7u3T>;0LflyrwskHuQ
zD=W95IMQY?6RgS~k;UBr<&y2Zq&4*jl+;s~C9ds1AW_!8f1G-Q*i9d_@eU9+z~&s3zg*>h?`c-<_q#*n{!K|Ra{mEaFBzSxnb?j;F~y1Y
zATVA}JBA_!vd!2E&PZ?fl>@DZB=xqgYjUczVKBS45k!d!
zyFQvq!U88r-MO9Edz?SYU|5dTw`&wG5Ty%i+r|8zscruXx>&ty(97K;_>!q@<+HIO|a=3-4Uvv>!x
zG@BsJZu}1U0D;f`Ni;+jpoju_BhH5~6Bn<fgqINmHgBI3`-?~
zQT(;&ho)rd3Kh^s9Pa=n;oTp?n)QW!a4|k_7MvjGK(suAvWSZsx&H18s^l@vTp(3I
z-BAtwy`YeF#>;^)WCkf`Fo-h_oDINP-}x~x_ynCp6T?e-ctU)#d^X-2iqV^MBG1Fu
z6z1Fymj-3e_R8*Z*M^P-aZ~n7aJf--ID-4PLxOGX->ub^!b+vJSMe##&6yNA
z!ErZI1LwQEulw{+b_p-os&^>2cDMH*s|q~;*^4VTsEF!3S%%!LnsK
z^5XFKcFz!m{@7})Jy|!Lt9f_kjy2n(YV6rQ5JHLfz0dDdYP>Z}de(@2MNXP1Cryx(
z=JHo$(3{>#ynZB>>e}1c@Dy)$wLZH+j^NX}n;*>Nl>29B4fhvlB%}TPQ^N`=LWy!-
zt@nqrp7`50uj($gkhxe3RJcA9w$kdfxAIsg*Y6o^raGH@)p3)@_l+kl()s!?rOB(H!bd;8~UJ{H=>!BspYbKUdt|j#|CEeV4
zNl9DMm0HqQj;+%w7U2xJEm+cY;>G;O_2MWyW_I-w-;`n?J
zbiLbyFJd?BL502G429b<8U5ofrVVdX&Q86>a<+;*c7_ZQR+~0FoOUJ|-LSJ{Vo^^G
zM~V|2tx)cgm`IDgYIKV93L~HFo5^Us<}I$9ss--q71&1$Tr3Huz-2_Aj3)g8i?qPc
z70N9Q7kFD*{p5T%9&rf=X(ZK#@6zKj=%kko7AGC4xZh7z@@6$+i}8xHAn)>@A8wID
z7K3$z;cQd%hykCPy7z))5KO;?9ng-(Mr_moj-M@u|HX9GPzX~jC;l4nQfRN
z^21K#mB#w_89=E{xr??%nl6lhbxgSqY_1G&^CrvGiW#MK-(Ip3saZP#Xeq9GM?rwD
z0#l%Ohc=ovU9IKe6~_5s+xb$=z`3zuvDs?rx3Qld=ciN=4Qr%z51V=sQ~j%RP?8w&
z{g8}h$TO8AxJB<1ISg?N`=0z%oVoA?G^atSd!o^DEv6N-NJkqP@$?}-W4^k+vbiWO
zktqoEc%W{_Ab^`B!e?SA8AK>q1yKBWeMror|`$xf%6ZLj<$R7A=dR;l)8g&xM4J>r?QxakS|eYZYDjhO2ukWp5if8
zaY}2R2kOWIY%rwUx;O5NsAp_y<;1BS<(!?XULaZUr3)%4B$%v8Oy(=&zD3hy&+{Mn
z^vN+(Z5y8aCuz?aENGNILnu@3<~IUCQ`p}=zV&FG!L296PJx_TNjxK%1UF
z>YnmPCa2s=^g{O-z68g;gVB#%=;G!?>B?ZYfjY+Rws9clv8km{=`te3ZFi7@h_}+R
zHzE#bv#`=>8SF&>;MM*15;)fLN|=py$tdBb-&q3N+ADz@Ff&Tn?RS=t8!TZhrjs&C
zSOgLC#|^)oOIX3<*Wu=DC7kg)ODGJMFd$nA9T557Q-`8p2}{uK8C;tFJ4>htmT-2q
z5)S;GB_JN)w?mg~CAhR3ozmrQvffBCHR>E<=w*+)Kk4t^CmGJdmUL9=Qs|m`r5zZp~$5Hho6S2CWmNm0i
zzH`!SY{|0gsizUF(Wp~=S9rm&w>!m?6B`lDsE3hgfJ&|-%u$JU>i3gC5G)KZ;3RL&
z-f4*Retyq16@x)OvyX2oIbS7MOaC<$iF_Yp(@neNm~tm{ao;0`PT~
z!r!sBtS7asMH6jVyK7lz2g|xl%i7B?tC=iyqU#mP{eFKbOOAO@_H}oF^OvZP4{OR&
z%g=h7TF%yzkMc@hOk~cGFC@X#vR#@k`jlp3wa(R&?=&S}qb1W-J2w&I&PgQ#>z5|S
z;dL&6_ay9Cup23k%^;3lU=raD)a1=AMUGg_xwy&#KRCy}OENY&(FIt5u6g1
z0P2y6kK>7ti1~wErJ!_DK#3(~Jv4sHwxEp&7SK{N-*O@~7!MF)b>T8=xv`2p25ccj
zHwO@X#g9o{C;MxN&LnIq#=%Xb^^6e81BjA-uhZuheg;L-U{1d-gd_QrrKGLnzgEfy
zD00jhR3rSUQa&tJec2Se*p_J>2!K#aJg*$J0IvZ+8pF%dmjHfytVa=kdmOzBY2O$J
z&nHQSfXezp*5=#{BK8XqVStLmgqYMM%kzmDA0lSK&RK~Oo~oR#M6bnyGL{Ao;+c^SPVJ0C&haWPW-0d<5yGz=W=$;www%ztFENs-Hv;4JSsPdMYWIuu64uvp
zU@=P)hQhAjDYKY1X1kv2^(TGJ8n%3?&#XzyYCLDeI$2%=fq-iPF8UGzjztgj!b_dr
zE@SRa3e2BWPF#0z`F@CixRJ8G@zWg98#3ZfwX_os%SSmFmm=i0)P1Dij~yZ>ty|T&
z2kp?w%nL_QO?0+`JyD~Im<_e;DA*2FNN}EscVS@VJd7@i3P8NKtw6L%Ku%y{%#$qY
z>)jAtzMIY7g`XTo0*OxS)|<$WINd@9Gs0h;b#Z9c
z4tzn-oIRFo)JWN6x?d9K^|&~AWBtcNfEr5}e3ANZROf-dGj|*9I}rRfum>Gj+VDjH
zBc9wtJ24b2zu;a;Li4mIOp63(m>=0OC@H^~!5u=qz+?<5)Xe@#lceb_;gC556iF&QFrB}9}VMi-#h
zponG$Ju$AO7;Iq|8a#lWuQjQ|prJ!2;{%VVn|K__q9P0)%ewI;7yKypw&C;4}
zoJvHT1Dip&9rw8+(lbwB6JE~nd19};C8Agm$GPAhA7PaJ`6r&^_>2L
zOeAdqqqbyOLC6{gIR?6^rep0o3L)^vPf$dy)Z%6pY|aSqJH)Rqs7exCu4OIgWlS-W
za^}ySOVR!t{1&Hv>nq}GI}XMwgMg)(gBBb%fd^;wQ2+KJ$au=VqvNLzReINHnedC?
z$*B=|4j*B-0@{hS29f1$7#RR?EdpAse7j7=5Z@R~@p!sSYw68}Ly;@qy-<{Gvvj+c
z^q?xUKpCD4mq!0}Au>AEquR(2=t#MT$v7il*~}l|$JOY2s#;LZl3X+yap(#(q5%-p
zQUba(Ifja&iKwDLrLhitO1Y(Po58dglmC*hm5U4gJ$0TA$>hxQn^3W7f!^WE5fxy{
zy?;B39hWR1wv*N0Qn;<5#BB@s-4IP_`4Q+9thTgyCq3{}s7H&-wx(&Pp+Eoh>(a0p
z)K+?aa;9=(TSVj*kM)pSZ`}C=jow*}+HzvenBw&=Qp@sF9H&NXzqgbr&qV^bCrX$_
zo{(QGNVMZ;EP-s~m&0gbV4$s*AU~{)0LRjMex2m?dw$=uJMZ~DNkJmm^QUNT@H^#>
zMZmzTm8IWs_6xw7ewMwynQewTYwJ>hQno#N>q`+z1!B;Ya;f&hC1inDX)5=LNh5PU
zl_-!gs+gu0SP>dyd_7$93xB1jEv^8ItI^Z&E9VpheIW_J>*)o_Q5EoC>Ww9cvMhOx
z%|NrvAm;6*{MbzUt^qNuFG(T|k$p5W{zuS76;lIsf`&MelydLhoaDp3;_6n1VNVga
z`(V5=Ui_2hOu2KJO+KgGl%PP9j;ce_orbohNELS)Iqmt3c%KkAQ8tuy2tZVcpw=mO
ziQqxN6wxH#ZF`BSNz6`wX4!3y%LHthvDziEJF(=t^iG7KOeTrrM!;TVK&H~B)?EPv
zVl#mBaufyP;>)00_j+$=mCCghUK|ZCgV97yXrioRchGb{3*}5Sb)2#Cq>FFM1M2SU?JGkuRu6X+Qp
z4e3P~>*Mz>?JW=c(!LQ(FnyDt_6_LqwEM2XK4_^?YyfBz5rikHZp=vT5sYzc{lKU+
zeecrDwH}4M%_3kjAflea2k8Qh>K(~fjup|==*~60cET|>E}vt5*}-;5lQ5*Mr#q@83qC$AfY0q
zA$fZ{&yzR$Rzp!d@`VRxIva>&oK(WF6oS}-9p0j7o+T)-UX$L6C#1913!D@w`7VO!
zgM?=E2>g$9C2gl4Bqp^x{0x$hWZYDY5T%-ndNWe}XT6+}!QIV*4E2e$b`y9sf3WxT
zKy3nZgQ!p;Dg+RJW1fyO(KUI-1kIW>F+W1Qj%g;RW0>+0htg&zf{IHs&_W35d=3Wvi}G}mJ2ru$uHv-LTaN{k1voW$KEAn)n2MmXSb}N
zAO&*AJq{taxT2S8R&HU-^atWrv8=TKuF$YzE|hrp}wd_^6(`joGZhDuM36SrAp9NF*EP
z+M(%|7C(}VqXm~)6-nApR9pr|={W{tx^??<^H2+VI+?1=Oi&#Lf;{)7P~@FjUo=dH
zmfe@s8!bB!L+F5(MWx!|^OzB5`iRY?aNPgRPmD#61*p82x8nwM7!Hi#x(EGW=vrmM
z5_pLgI4;0_<(0}Y5y
zd`l=-KtKUySi+$K_p6rhAJ`Uw9ucyH&q-ERxZdct3!xt1L2iO2{JBSZeIMf7evHrz()xA3B7TYWIA{5#MmwDCmf4X
zg522w$Xc`d39GuNbI0!+MjP%A$~}3yEKtn(FT*Wm`QRY$|yQSz#wM*PT5_^SDerz&#?LfVJy*K!p#&#&8#l&eEcF&
z2Cxbjb*R(z?JwMhfS#fw7E9q>KjUVIww%B;9Wvk}I*-x)gg_<^9NSDCB3g$w#Vs}c
zQ0aHmsXZwgq_zZH1|xJkX3(v$GXtpo(dYuoPVsxdYAIk@nUDbvv#&_f0+fj=7K02R
zMbJ)jf^rx$pW0f@iJFtWl5?`=3`Nfkvjo#k_})64MR}{QSFnN!c2(Pwrzu|J*$LiT
z1aJA08i3IW*TW*Pb+M$I?OPl3SfN6FvS&>|g|l?isE^7RJWh6m%?48P)8oOSr(rk5
zUyN8jtSd4&u0TUM{|E7cP-Ad2Z;
z;lVhg24pva^G&TA@d{5CxR6(P1d}o`wvv!eyux>L!g|oQDI$b^n+`>{Y(lq0zt`2G
z!LA99zZFx4vbh@o2orJrnlv0(WZn4>pEkRh%C-|y)Z-TTv&1yuK$?90l5!6PrGH6CI
zQq`2|P6X|uj`dJio-b}aR;f6+fbyG62H=2tqCg{lPTT`%>#L
zx(W}S^_3tgo%f%TVE?(o^K!v>X_*;MO3P&Q9ISC-n*@3etf{1E&v^v34ECH~#4e*F
zrS+U;Kc}@#q4XT~kp#zm>Oa@v#&@z!W(&FqL&1*+f~gR7uLbi3hv|I{aMipoCHT?+
zcA$Etb(u|xPgpS^z8(6P&gVB9UjOMc(4Y@U)5fiQU+tdIl4clnD3?5nN_5$LeMLjk-8T?6EI5#G0c{B4?Re074>KVe
zGawqZ>1T>=z^%p6%hp64&#fjD@_CcHXHShSOd>SohA&UH`VOhs9bd+&|?3yjru1{b-+fA
zgIu6RI*kcN)JDy=4VR0(ThL&2OJYyvv>u1l*?dFYYxOzhE*39}Jq`^o+VBG4sE$2Z
zG4aWWjDwK{%bGxk7%O>OLq&&3pCEy;`WMmFF|
z)Bt&*f`J|n+1hj4>9~O!F?QjJtS;>#`N?8yFG3IZ^zmTr%x%Bd*1kW(wY6vc
zKsD$`h|~u#V+ha!3j=rPcX*&R(yhsKw1M?N|BNUVMzY|0h8^W;gdjX%M{UY)^FVLL
zk=TKL8{|7gf$NM6&soQ;9_as#+D}0_8UFW>wVl@f)%DU@0=0kGq-3xCpT3rXClq_w
z|Gwq>jn%#pZKAcedVXViqKOANX$O|>*{r^7<|y%D2KCZMiSbtHU*6oo+wF=iW0ZKF
zZyAC)`3d+)mCru7fRd!s{mr9jJ^YYR1LTWcz^C-iL_Ss
zxq}Tl4w`}P54*-a7oPSh7OSn@zjY&{#40SGH_C5@(P@`4DHG$@B%~9C^3->>Y14b{
z0JTbpT9iO`8-B&BD_$#FHr=ahY(e{ky}BygYa8_H{;E0Q(S^LaJ2Yp|t2nGh;VXzfJe*z=dWY1F?wqiNzJ9dwmHm>I5=X
z9L%mHpUU%a_{xaCQ=-p_k^$D04k?R#K(=){zi+(l8%`vfSs$nwDWfM-j8>(DjxLtf
zIx%);jAOPygG|kqV9(YL20+
z?g!RSkWNa;ml#763L|&%&I0MrK)2Fk<+8-!ID0T?1~i6UW}x0vF)9#NYTOZmGvwrQ5^_WL`HrA(HwW6+Yxeo+pa
zv&K^T$W(0Rh_L=^+u=8v?h-J+NjaNxpAmPH5?F7%wv{uok71XoW)E1OCrnEAG3=SD
ze<1;3>$7EuViQGeN9(r*$FSSTVvY1MY$TZKk6}X{17XmFjT6}zt@Lxq5J-x&ZUyZO
z=}EcuoSUtLWEqu)MCpSQF^GTyA&<;Dcq{!Xq?89Es1Fl`iZ^;j%1y4aJpyuzjiiq;
z-~{fLQJ2m-Gic>f;FjWYeI{F29)TK9pkdl
z;uMa{cwT$?;lL>LJ_Rd^JxO((UKqn#)sgIT;DhLF-fX_!1}|7PV~STl?>>=_klL<}
ztrCn*JQurH@C+v&Q|rjvwwCfq%PTrFM++_)01*1<&4%T@P$E8M2+L|_uUuRdT-bB}@8(APA4hz_nydmf?H}2+Al6C9pNx0_t8A
zcA8%~>oPs`p3ZH^cIXwqZbRnTm3_Z%Lq3H7aVeNb
z=N;d#qcNf(l&>#t>$P-GNzNPm9_Dvh-<76?#ixImrjx!wkqFxAGr#in-u
zmW4QMS*dKTyqYa?swpXkG*C=_!{+OL
z`&=nSn}s;D+zpf}mugB}P*%u7^2D!rY<&RcBC)=*kJ@tY87Re;6D8f}-V>e|5Fqoc
zkCcIO$)OHJLJYi6_SN|e^qThs*&^Fn^KKceghbFNS%!79R?&@&P$svtAvdy4T6Ecm
zB35I;H?(HTJ)OGF@@-&%Z}6%^e7grrFp#Mcg4EPH23C`dWrwg#yF3uvO
zj~%h$NC_QxoBN;udU$!9GxBzFHBsewk+x3lag1knCB)rqVAZZ#NpYqOqL7rEgPLdB
z;}T}dW{=!Iv@_A~`keNQkK}Vv+k8+Ksa-04-rs<>Ik$;ETr;pO)^FYm_QYDtSL*
zz{iF(dhJ{Y#%I;aP?x^*KJ0zzP;KlM!8PaqXwHx)uBZ(Yg%rC8$F49n@^Zl@$jcF+
z-FlM6rK*d^btWxwHc)ptbw_X0d+qIzv>Y$uu^4O?X&Ld}FF|SffL%Nh%PK9CJVYWb
zn*mYh(jp4&r2!=7DxRa`+solVqXt0aWFcOC1F$Qricn7F;&IZtcAXM?s>aMa8-wM8
zA?#^@!)@}b)(3Z$v4u5%0(wDWQ;qSLo4eq$GyHT@ZPjL6*xsMAL4*3yd(R1-
z65dG}U9}8cUqX#&%Xk8+#FP;@i4y$|{fzb+wWzyG|K;#t{IsLDwu{&OS^stA*9lQ~
z*6Q^gZuLjfg_^l8Fj%{k`^0-8ehj9>gP(v5mYBMFHt#uLX4fO@d;
zjg4X*FPcrT);CJW6|4)OqrzDG0&8IaDoC*j;~G(xI^$0*`I`f@l!sB~Smw}RPL
zDA8CQTZvCAwdraIz9iNWY26KptWR@1XCWdOSZIt5%8>MgqPy|O;1nyIml;jxvM
zEvvy)cu?xh-cF@M*RJ>w+Ip0g%6dp8NF}+vye(1Mz9bTrVv|C>3;?}v)wxSzKSWx0
zN3lPEn&xBXHma*t}S&gVBF?g!KWPz<36D(qXo4Ac7lJI+|cD~QRLAG5>;
zWLh1JMw{p&ax9<4{X~mm#m_+Y2800OnvqF4FDGMbFi=9{Z;yF$bH2fKeKl)IZZft3
z=f37>M!2wex1O-=`Fj2Vcp*FBrg(dZ?RS3(5MU%a-wx7!uKF$SHFdZ}yk^K=Khy$8
zKIGkLP6L#4Ru(PdPW?!6-6%?tQ?Pt+S4cAt0(_TG&X8tFFo$Wpy^>uZdaGt)M>w1*
zPV`ZQaz}s8I2~9AmgzZmWTl*6rJN10@#_E^_w0;~OwXGWIVcLR8@32%_X=Y}^=9+%
z48-&^3$j{G(EJkcgx3uVE9w>+R-C4+XxP`X;zvF?L*AAI!;06$A&6FLCbD8EQ=I6V
z3gwRaOj&`Ggs?=p5w`jV4MGfp5i{}~GSzOAr*+dL!b)rwokCWln<(bbmWhU9?5Yrq
zgHC~pdDmU4$$&z8k;sEPP(x1+{DZdUylglyUOBL2kmbM@%7NvQU^vk5K1+*E(o96Y
zKU19ODur^7{!};sGO%EepR$yjH~A)(m5dIzWnZXe|HUhNHlLg!Ck4wMsbxp~vR{Bk
zN7(oN%>9{!t9M;31MJwRc03;Z%?d}g@gH(NM@A29I^r(WhYxGQy
zw5@^qnQ0tVc4!gm4pDaQ65POKJkSPEDB8~ZSe6C=`F>eVqR(k122#rvf
zz3JNZ_B(wx{;GD(`G2on|2E&SVy?2{f;}xO?&Xs+fRO6}HjJm>J5rP66!
z9P`?IE+)vC37sXEq%S4uS#)37<*4Fe^9)~>C|`~rX!-IkpPV75OM>Cc2}Ff^AT<+_
zFI*vfc~qg?cUM90?da=0Az(+;-Ke=|pz(~F3)#>VO7BF=*_$KgUkSSzPds-Ce$v85
zadXzNsqjanDO-hkeAjU=nhG~+h0nkl>FROx&=zhE@V3ufj1p5Z
z9;uJctcNO_ik7}f#-~1}CL_2%j0E
zi(?!crj(Xq285=Yc%rq?t(CFbZY@nHSJ2=}M}wwk`Jn+cGs9@Q;dQ3So*A4ZaTG-Y
z&hv3_lVY{`EoyOtJnEWOuN_chGc%)htd^!KRP`UlbRfzTN*(bA8Db_a?2O0tud@w9
zaPycuCsr%<;yV5sHtqgorvm29EgEp{%WiHbRPb|_Pa>g|0#5r3go#qQpq0`m<6@%$
z!bbs)m+ouFZZ>N6n{8JPBu{cHB=6SQhB@(M4OyPV
z*xnyUN|F}IF;Gt#1GQ9mSuFE&F6S*%FjGZ22jyO8hDxUfX@KtWV7ka82Gn>*>(DSv
z*US4GJZPxzDkgrHQ?@n!b}j3Lzuf{}!a6TL1kW1Lnm}zU+q>G^WOrp_cnuGZ;x-`f
zYGgsD$SlF$$1oZno1w$oHklcP
z-H{7miSkTt4q+}l-}f5P6CYL}{SC7#Y5Mob)*^Z=2Ko{}+ben`i^D7#TNk44T&xZz
z%2iO_?xTF6;qxMJo$E4kIxb>sgN)cqhg&8ZMq)-R8OyJZ&0`~tz$hILm{hd8E^wVs
zEb+3rI^qd93D7jR*O2$rtoeAm=63t0XK(XEG*_l*Q|>%n@`Dr}_D#|c!gQl#jt({{
zvRy=S#bv2O%DwzM3p3iJ9LALu0&|J19Z9)G_5=#IuKcklvsP0olF?$#M6&+NHguxzN;cf=^tK)DRA_~uRVOWM6oO<1rXC~J*2Ar{
z>(ymnHEyV#t?v#<2@U+;VB6_*&Hd6FytSE>4ftkIX->hMTWw>qX=mUR
z_GkpsL0S8PCeyxOqCb1tTHi>|6A}xY|7?pt@f9HmDVD?$Nb!6F&(HAIEw(Er%!-gR
za58EHmCPiFpzJ4YEMEjAg;qsqJAAR2IcH?AJ)b`ml}Xcnsj3nr@?Shz#qUXxQdz$d
z@Bw~!!ie8tDt?#kKxw1+y~-zN$U~A~wBTkUCDDbNiQ;z!x$i{pRVeqCWiqnx%Y&}Z
zt6C#<6)I3&>Bp8P9s{qHn}{s}i7GZ%<$V5)lx?OD9keT&83po`la@Ac&!%~Lp&!<#
za0QZV?lKv?kK5v7b=5Ishoe8h#WSsfMTSf2&5~|JNqKW5$3b1n^OURfZCb|Ti@rh&
zMOw!ABq^sW+q>sgy%wsuXs67YuZBX?+iWW5kG3`ELztc$KyAx^#XC@LM6I@~z_JY1
z{Jm@+CvtmLdd>St%~^&P87`?WOS%Qf0`;5d>Lt+Ktl#<&H|49WvJ=JjB~BiLIh;YM+#0BYC58(c#)4`B
zxR7Hhm75V7%r!(C@p)vjFrJ)FSvFsi)pGxW6RVK9e_a8#rjM61S)t!cD=5;diaS<-
zpb8SyxR6>xnk^+jti6}eXw8Qqe|Mm4%`=~w{U!iZ&S!^?=2g)pvfrFqv4Mtgr$!Zq
z>1oxXSOllIA7668iM*0JcRV_rzNXw2vUAYnGpbtOk`)bNJVZ71(!hbR#OWL?-v?9M
zC>^F3dWcq{M_v_g8beRi)$Fjv^VWBqn-VGYD`yO;6EBQA(@fXZ3?OEy%bmKF?H#g;
zvMi_~PKJSRdEMvINM{DUfV{baKW}am&6+j@&81=
zEr4XoQS}n;g(7MyFiDR(fLWr9U^wVMJ<-lzVlhVHhoJsIn
z^drfef${)@@^l(W*gux%otm;8KTcZAy2(mzYs0s|{x#ZTTD+lD5Q+J`ASBJ=#gkP`
zwc4qRKWf?~?bAj^Q0bsiA4~cuI~}w~C!hgqoA|e}wzshP;Nop#t?dhqRKL4sNlnYkybsq><
z%lQb?*&I%-c;1$m^o3<6u8Ldsbjs}CSZ@q@)IEHnN`_&NmO-E*i?u>P}Adc8IoY6GD@B%qYE?>xjbRMaCy8m4#wLJ9+}{>u}`dxnn(5adSOpkqH2Y3
znSX`LdNp8KOit%el+lXBV2xnBXrX*HUif1jt8c)jDcvR<%mET
zQ9Gs_52rEog+h0DOwqcmHm-cxsEfW_4_|h1_Z}!`52i~-|M=#OE9vm&d~L-YSk%nwM;<8
z?*4#bK5w^%ioG9wPzN+Slk3iq<&t2SKlDXm{x|naCNlqD;t538ZN+RU_r+Jpd|j2f
z2tG?9c5mgxdn4tiNup&EiSgUw{1wc@6`wbV@5JmrBm$fPkLpu_ja3KKW-o}E`_j|v
zJCbm3CgfGgJZKn4u(Y3+Z+dB0gi1qopuIp`vbGJ{%)MvM`i|nnVpB7T8HlqZ9#Y+-
zCSR${Tpxey`j&x+R)K@5_2kP@XN|LMFAdQ^Wbi#96TSoD`a3$!1Z_>IkPw_
zd2`V)fIon`CCyFv4s>EU;U)fVFB5^sq8CJIHwQeT_z{fPdT97CT89o{u63~yE`d!4
z2(4n+2t+WJ;I%9!0fH^-$WR!=c+}#l{=xwS32a#F0K28j8=)S+O$Q7Jcq;Bv+F41l
z1HDUOCN;&Xpv`nM6>{0Z5>Eyoj7k)mm~AXnEZSKXol4I-(XKiz1Va$4i#2!+=eseS
zdVJ?T)1Q9Q{&ZX~+n+w$Quve}Z+`!y4*ej-zx=<@`|>)#hje?o~SK2;Rw
zey9CNL0Vd`1qZQ6WIA4YsSl7U;*wa@D>|43VL>$^-2nVxJ=+g>GQqNW)l~)nc8|eS^iDr6t2>ukRR@XqI@eSzRs{jh=iZi7#zP+#uu2U}KdZ
z62y~KZu*?-OKlclt>K*XhnC5#Sm2}P_L;!ufA?O~{97s)j^Eri|G{i`XUJqpFwNic
zobclT%|w2j#1to*uR`LEuUCE;1%~BCm^4bK!5(am?1xN}!=R1_NE6ZJ;~gz*-quv0
z0twEX8tF}N`V?R}vpA8wqH^Mj4w-#wVBWoVjzqNLNr;BUaU*c}7*FdAW8M=MW5gP$tz$|67?uiA_To?a`*yJzEFn#;z(S@?rT
z=(57_!gq7dXVB>3#LQG|4bVqYF_(@XE1+z|?kYrHOV{A)PFT7Z_)$i%sPh1rkwk25
z<;1le}!C2?*1lmoS&FJ5bEb{
zWq>Z)7|`0slv|f>3@BxQ&e<5y0|w~qjR8$GK-+WzWP1AP?g;`2W}U*mE3?4S=DS4f
z(dpWX>&Ajjn8-N^hZ{lQ$M<9pFaqBW{-SN4GT=aRuB7O`t?TCh)S=RFj^A2CW=o!Cx7jE0FNzcG$UgkyNMti<)QFv3G`Gy8ZDe>23ele@
z8wX84lk;R)P@J(_m9s!8o@U>%U^s;f#a#Q0u%ixp!RtE83*5aQrG#&TuP+j=Wj~UJ
zZ#kFm4_aq>OFtGrwH|9VBL|&Qz9Z7>FpJI}j*`WX_?P)Q2BZT);8u}?;a=2(<8^ZE
z7X%q!g^<5K3qrVyFc|~wf@L;oGjm^MsAcP+rl?;ONjZvp>jmOxO?qb{xHy2|&$Js#
zDfal224qjY%t|u%iU4RWc)+v>FeVlvQ?1@jU7I&IaxM<0>g{%aB*Z0qZ|cP$;tzE|y|CatP_X+gU;H_{pf_R`*^C7iJ5zwknSAT@V2Mj1(G;;1;}-1K
zIczRr`{;KYfa%L-Pt12Qwn#jOUD+LpX^aE}b(L&?mJnOg;kRU!z)>@ghCxbHZ9rn>
zeE!wp9+9!AVKWihdH}7KoW_rFN3MF0J5`0!781ogxeVnyRT0xV-H|2kOp{j&Cn9n&
zji&jKtkM$XLpQWg0KpJ2v-OYSk$OmX7H+4tQ`Eg0YK~++pnW_viaCwnOgYjt;!E1~
zt}gmrbE0%*Vib_Z+~laHBzG5Zy9VyZxQSIQSX@S(!^s}boDI6%zG*8BXS0P}bD#@wBr7t87{shBANL||T0@rZqlrz!?>JcfTPb4kTezPbHMxU&LlVs1DH
z@A_pV8k{~gfRcF35gMbjfr-TL_z3O{ltL(68hSnQ(#61)o
zKj?hoaZm~>&~_ERN~}}x@{8ut%+j9G6nX-qUVwf_@Pccm4+?=6p_+vsXQY^It
zycA35E+7;%ipyLC8qtsJJ;tX~=*&IFf7NG}(Q+i7!<3u+g9wD@1>9!9O5X$*Pw+9{
zuiaw|p=nDrRF|%;2FG}>SlBl^@E_y`_95)SR&)w(>_*GPxw|BvoFO+$f-zO2L_nk6
zH4|xh5rz-G*=Y*pHqQA8dYh|oLbvZ6%R_cp9j8V(y{Ge#wt{
zb42n@B&iBRVsv83Wr#|TFD#M83SfG%GJUJAmg&R!a1TIC>aG176EE`=`sh!_p1Vb=A?P=j)}N#Ff65d3#bNr(gjy_Rz(Mn1
zrQb;U$Ai9fDqFK^gj_Q0PeeWUFZwM}jd9gh>VcWge2Oh|Ai~j4A`i?+PZ>E#KZZ=(
z57;u*xI#F{x6Pw0x~#$ti+-OvBl-jAHq!Ar6#Ye6>_O4jmDZzOrs(su=m+!1ivG>V
zMD#Zra1{42NdXc(pZrWj^vmw=lKxW<8v4&k48~PUu@OG~S*7(?DE*3#ZmfoL`D5uH
zr}TRT^j~^ZR6mRKS3NECMKpmCt1`~)B({W8L)94X_WsPDad_zsSoL%R$1$+fG2%Ud
z{nP73x;fZeE68mi^uM9eOvkG#%c~;xUjKk8^h-2ex#BN2%C+`ZTUsw@+`i5)Qs`Is
zV+(z{6fst4z`@FEk4T|wS?G^vM}&UzeWYJqSzaBXKitwkOzF>t(3jj~>CY~$PpQy*
zEB$zw{(C|#R%5_H^G`~DHtC-O`XXW&4+E*K^)hBZ7;Ylay;sqvb&A8jfqUWS--9Xd
zQ@-Tf@>j%om-n%8b8vc03s#LDoh*{3#jWPT2DEW4c*RF?lVke*+>sq1-{nJ@=P)xy
zgQrXTAG9iK#{)G4*yV}1XiOMu(Q6+kMB>ij)y;J`$<^a
zE6my=VI+2y0S7z#Dr?PT?I@o$iCncJzC*8w9R)yY_^dMF2&6e%SeD%cI39MnHwng-
zjz3&k{xGg$tw(L`Xsr>iiv0%S5l!cxBV6C7h3C?GGh0(aekF>kRL)09f@#nt`D6p%eSC%4!mg
z>KxVN9wgxwj}Pa91xeOt2}KU5?UI+w-G-Mp
zXuWb4YwQG{7c{WC6{_z&KMF4^_+t(JLgi(*fR}gCW`VXeuwUcG12J$v^mk^F8*T=~
zwG>ma7#v4M2WCH=Uk%^?nrfmgEymE>5LHP>rkbVt*FzihyaO4meFY^T8o%vcfl!8o
zwIjyvldW`J_`jG}2$yS)!qDC0Itx|;zf+&v$p(AA&w-)C=j63c(TdWDXI2!%dbXnA
z(N+{lL@G)NtR)>^Qdz!)6@^(^_t%Qj*r}o{yWUik6~ycoZrg4R^;AB&#oJ4QG1L#x
zT*EN#(o7W7Xr{QaeH6+&n-fap&)3J@2s}c;Z*D~yZRx+G^zZt?(*K-KZt=a6VCbKz
z^tTP@FQZ`H*aC&}K6+f}i*39#O)3i24=Im{*7cYt4Jz#*kQBt=KN4^GRZw$pzz3{tl#ak-U
z`oN0uD8mV2cF|TG=ilE8EV(B!38a6E;Ec7k6ilR(mTsy_T?BWXW9UocYoK6VO84XB
z4ILE=2qXe9-Ia`Y%2iw>m^-RiFq13!5VJ}AC8KcC-hTL3gm7k1?gW|&s|hHPg$!7X$cC5{#L?fL0U+Fj+IP
zn(WRLH#UmEcs=+rn5p6HMmTEIP)o6$YL3#le`3dp06I4s8v=9G8ffOj?-4WuoN)!=ZH+FJ%Y)E?(
z;C{1PYXT^scYzF%)oMo)L+7CK{#vR%#_
zOHf-dXu`$=L8VIfzQb8?B>S_&_#%}vkDVR2u;UzB2?J1$YkhRCeKV^E1tDBhwG3(j
zE)!ZcijNtYX@-F*l9(>=$2}Uik#F@LTfR=YG624g)BB``;hiN_)$QhOX~mCtk`I}R
z4S0kJDc8J%AYGluEg0m{EX2%>oaR*+OW#c`ecdIZLDBUn-(^3wV)q1)W)MgaS$0KWg)3Sb|W$t~`w
zMU#frTP8LYOKBzw;9#b>u{R$v_syqLPUmuLgbFIwR*~d~%ELmIUKj
z&QNmO1mylrLAkLf6v}J)yOPsMM6RUux0x|6eg9fhxP6t{0H50BN^MA(+E=24*euP&
z!kwYijx^M!7;0ErP4ff5{2H-UjKx~Ljr*4o0KV>3^0OIv<=56@F&)t52R3pvvNT3WkJDhQ-Pb|ziN{M5G4B%>XL=KSisgkKX&MZ-
z>vd6_u!Qm4{0}LKF2dn#8Wt}BBNii7Q8rHeKA9n-Us~?Xmhk|8F_6Mli>?A!{p|HW
zVXpW-^~>U>*PIi$>5sk;^;Kz^^CQcAUg5XSPIu7lumPxGEL;J536Uw4-u&2kE(P%w
zXTHxfg}fgHGc)7*fu0Q3EJMkFqcAY#jVl6}t(ITC&+sR`c+uxOYH8$Srfq
zes1q!m@#~HvvZrUt8C|oCV
z9?6e(*;;2`=2Wm!BH9|j!>%xskH$|@(yKa}pbso1kmX@Q`vf_YbN3+
z96mSWENUCLstlYtghAP>UxbelUp#Ooiz|T~{2HhEP$ABRZkA7jZm__r4&K#Uoo4Z5
zfz^JI1y&aSNQ0CN#sN6BtCU9Ji
zt#8x}E&5hZY_K`lB2k{bB6nHQP_n2}z8bOl==7TGp1Cl+0+^Exj7-EDI)h0^d^1Uz
zf!LULlS^%9yysBuyy<+=QP$7_on~bLT11SnhPJ6Qez;#Ir}IkdpHwk7dz3F{CvR&N
zfoCPb)a`%WA_AYNnMigArns^52~64DBf^L_s9m?#c82y8SUD>T2LPw*SW09*UXDr(
zZUha-@9!PBvG~2@QSjjwJ~)n+0p~37`(ID7Z#G&)z|PPel%a76*y)M*pS)^-O>Zl&
zeoQp{286i3XB`vVSPOoTAGz)=&aRVZcMG>tUJy{QFY$%{W_dw$L0&pVct6R4188VR
zvgHnW&PhX%lYjbcI5nNi_u17O$HdzTRZX?WE*3_sJct
z__oA&I)@Oq!1%~vDP7C$3$
z;fdgOMQKiSAPQ92uK(?R=Ytg=Er_UKYMf`PX{UM~{7C!u`^*LYh$t_+a3C8CfBK8vd?lQ?lNk2}hyRpRz
zsNOn!Vu#nZn|ge5~aOe3SG{IY_$gwnMV<7{<%4dF2hft73wMFOcF5;4%@+{3>EQpfl>-KzAazRjp
zYb0WGFNMX}py-tfilWP)NEmf(P$cC+189SylMd=CC`t_jlUaxq)c=pFqahCJPMn~PMD45thg`}v&9&nDQLV2m%
zXlO=JHL9=Ui;SE5`}-V!OAV(oD&^>c5C^Qq=PKUP`cssJ4?ZGoMh;cV%ukYFYH?Du
z6dM{av*voLF?O0^rv27{88?CG+VEAaHA)yMm5Si6h*F
zgIQJ6sRZGi*b^74BXMe&P+EVcu-|tla_bgf8)mwJEIP5jnjDbeP)Si#cs)Xy77p;b
z$1sT;RgyKDDs9H3$OozuRfgYfGvlqHxNVuGgJ&vA5Oj{hX8eQ+1_#RC?RXG$7R-DF
zShTVbx=LcaKWi-Q=Jdy1Rcl}|4igr*-}3V*|1N^U7m@f&g7
zRZhj#@YP8X6h@8Y_c56Td%=6<0{+!ytv1vCGcazy7l`P`{DRaDc*&$j0upBtz&cz$
zCfu4)_))xOF+a9i`-}NcLlI;QmJ1C2Bl%L3nGXz1r-b3U1Wn=m4_RZxKu)@rLRjpi
z68MysA?Sxh8$6!o4uO-zp%!km4|lZ>cToVhnS~>(if=1*n^-!^A}B{fyBB5d*2o7~
zAipb9`II6oNm4T2GmwvE9%b2TCSDQ$2K}D#*;9<|nH&|!;oF``dk^fIQD0wOIr=&+`dSfvt%|-@M_+5BuXWMaS)tdZ6|?z9ewS7}Z66URnvi9-DdUuDq<;k<
z_L&WQe(=~WcCg?ZCx+K$OVZVY@Wn`J7&G`thuiE+D@NckUs=N>
zgb$D90`i~9j^%;=E9OfYs;X;|A|GQVe1cjBU&)!^_bSWZi!6!h^;gp_{Eil^t99c%AuGeM#%4dm^n#!Sz|y;{XAMP&G4C?g
zUwpos9wJgxV_unfNOn_YjLXiQHNx<_tqWI!=lnOV28gk!tk8tVsS`wYrS(aXTj76K
zQ(z1Pdi+NuxH*5U1TR9Xj5c+5%|!NA(^uhaEXjs>?sQm)GHh8*#9_G}1n#l_tg^g0
zqS;|r8qFRgZ3>j)#O9wL(ySS_jFXgGe2P-kd7l;J!il*C9DE%vDL{hfQw>uY(JUHn
z(R0E#wW@2nG_?n>Fbq8^9*(2Lu^~P~UTM9Y0^#<3?pYM<_!Z&Qt!u#M7cP
zj%H-MSF2P?=*F{Vb5$b`QEjyE0BOJsD#i!Rrp;Of`_I%uw&88JZ0J}xTnzI=?`|^3
zycxlTRJAOpg6@c@G1QJDTNn3CIQ>Dq<1GWt&mm}fx=lbw93eKAZW@}OecXPv8G5y0
z)vq!AW&b*uH*@>cCI14pJ38k|J@7
zdx&I=q9?J~PHY#=L~*Y|lLSQ`7n;Du_CF{JO@
zCeqi~($^KraI*A60fjU7NDlu&1Gb(aLJRH}x`a_A5q9B}jMlOlo0Bz^^K#-ai5R!O
zM8>U#F>>tGi-+DnkcwbGf_?J&@w^6
z2Pu@-o3mQ*xFE!EM+p_oyoJcciF1Z&vYI5qQFvU){V)8a@sWYDJ~VlXLB<#ekbhDn
z>KZ`Zo6Tw?m<_oR>9g4A*wI>{J-n9?a0N`k#HK5z2QelrP`1LOB(u
z`#~sM^2fGkms12zY;Vm(p?rka5klEVp}ci7e4#KrMLG7>a`1-cu;38+-8jyE&$W}x%S-FiQ;D<7&wDSVL`^hW#P
z7v7+8a7(E3w90`ir8qdJd;O7anQFo5zy94=;sQ@R-5A66q=&^)P1YDrdQ*%cpFh?Z
zCM3lecG65Vh80uA7zQhp*E(Hw43b9Fyv@l-#ut8wpTYJcWg&s#OfIIt6Xw0S9^J^G
zmY-Yl=|GHmRn$@EY0Zy|$z)Lp%349tM5UL{o5Y*}S?;bxa;+q*UP3uXySsJkB<4W@
zG7+=HPI56{$J-jec5pL_7$Ny)JD%bqnruEcc{FzyPtw}UZtYS@B
zUe}9SJR7K_3kAOmj>C25YuC!v_YMOe_@zTkknL_T!W{GVy9_F+Trw;;!KLdH4?wiJ
zv&%ft2kDrvZ)fAt&df|)mpn}|IsQ-Nr(4^`&=;4`;?Pj2xEVdm<|3fBK>CUUcf
zGFPoo-XUPFbzk*BxHG0=A~+P)Kr)uOu+s?=v4qckhTwJ|J-rUs^KksJ7_P-2$er6Xr;^Hl4ND@M6EhZ-Kvd$-u#|!QE^bMi
zTIj8wq!u`_AT<%}v?k!F454WxBn2CwmQFI77{#c427Ik%Sxs)yBkER~{i0k!se=me
zan(&8_adJAjh5j?$vzl6gT9fYHLN2Bx;DhBx!Z7`JK31y@v8CCW!4;<`Q#R#EeXaP
zmrfRqPuEP;_yJ78vOI<%GA$*-sRHOEA#P<_I#kMPVUyc&#eMOkNuf0Cqf;Se
ztEF4LuD3dXu#|wFabL3z*RXB_5yqb}N!!Y*udryTX5qybosT}@RQYnZa>9zK%JNS-
zl3ZXX$ky$M1yYwNCMf_<^*0ChcTpz&I+$)VT&PG$Gj%6LXREBP_9EwL63ef~=k{O#
zG3G6Vw~NkV5+dSUl1G>%4qTZKZCfT0?J^AZ@;MmRYLD0_fjZs-Vbhzdkyue@F*gwn
z&IT#piAZyIewi^R*{9|fe)Fm|r(0eVbL!6@+uU7=kN^&3m}VlQpI$8HbdExK>!(HC
zvJ4=H;?H#_8gi~$Z>3LeUnTdDBpB=MspJ-ECX%~C$#pa2oPeCPOS$B3u;gx5a$Ec4
z-sF>8d_b7o-9+xhjt|IfuH+t8C~sguj*Vx?i=lP;zt;S6V6dYg#Zz3ob?2E@Hn{`L
zhg?bT6O#MoPSZNJ&Q`yNkDF+MTW=)P#$wL@aoB~^C&;#_H-_3@o$`#fQ|94>*Mp{kS1=0RL8g_}^JBM9I*|6)q
zj^u9Mr{`FM7?5KSU)=FaN2?60KsClQp`Gk1I)h5+18j6Qg$9@G3Q%H&0Ptv%3=Ps#
zQ3H##4;M1cbHRx)htGR{ZO?|>TtmTFmm%Gm7eL)Mq?0j@4dxU_EE_A5{&E_dC)j89
zN9cl>ik-fT#u|fLqz3on5^HdoSH$49gNmgY(Hr
z-5RdJgr7*s@P1DTNOlwMfGHvImh{Nb!m>=w_H1XG=hC`+t={Ig^t(VMAXH#Sm~lJOpz(uH(k(7#fWg4DymU4}+2
z3?pQqMJ05R#X9li2${WjXX5O1|Iq#qJ%XLT1DtCS}Wm@;&Pj{
z*<*}!|Esq9$Hi8t1hq?w%wPjW=CND`xWwX=iqMunvmrSsDj$xr8Q?@1*pGBtc{Z|)
zW!lj+89_fo2em)rmr`@uWMn;1cyugS3FK5PL*+{~TzjNhvj9zT_)mxY_VX7q$f6SG
zMgq^RfJsU0>1CyFFY7y&N;br^@&+ts1Ph&Fv;M
zvFl>|q4$a2Qvw59d5$&FEKYG^2OgtU)R9#orS<(7CAfX(za(bY#2@Q2k3lGcO5MZc
z0ICplMBsX##&CHKkEVE2x&r|=mB_9bnS1#aRmVDJ|p_0E0
zZR)4cFNU8)g!&UlL%w|57Fs||d
z(N|&r1ymHLuD<1yTfDy{7*~1M*sk
zHN^TdD;Dbw$E!Es6k3oh*4r_%gTZ2u?FxGz9~gI9r#F2`*)sX-PI*-9(?>~}UOY&P
zbl7|;$RXi^yn#3XkT)nK3o?=^Zft}p$Z;3a=UewmODgJ=^Au>83P)qH^jCD@c
zG)PC6+qpN^L-=OsN6t98bU*0S7Bl1R_B^Kk%W@ZEwHztJ;zaH~@D^N*r3OOOGS^zuZSzD4pGbnSrlS!HKndM66Zw7NOr&6!0fF(lY?3I!P!xxr+tj}j
zHx%Pa@pzx&FMM)~r-Ui4B7P@Ut(iz7t`y%?DDTt=MQL9EG;YQ-`Aw{Oy)Ea*DCf1<{-ZUoNja~V1S6{*l=GFNq`2hV
zp&s4XLx%IZi4vrsEkty*VYB@Bsr4pF}kAx`jnB2!4L{JgIJB
zp(7p(wW8rKZW&P8=$M5>M|&m_0V9!(JFSb-pXFUz#&!nZuVAgyCE7n7p+%D=+Q*4Z
z`p&Eu9oF*4wjNut+)iwn0SA&9Xp5nMS`xhb0(;2oXjE2VH6sK3lgO2yQitlu|7?mx
zoD(Hr*5%1|n~;_bnvV{d|3c4Yk2$jQko{x^(?4^s>ngIf@?BbgnyUS8FIcr-s)b!7
z2}bRENYP>+9`39C4m7_|`{61Q@9_zu_IBG{q^jDaU|oBoKexnuKi
z11H8VawyV{12b!)oq6w^SvQa6jO6`_1o~@XO6w=61Ri|eO5kD^-7S7e5{v|PV|lUv
zxzv}yZKsL^N>onXW9R!42#PT1Hx$7fMZ}e$6aj+L@ErM4d6O>-XHcLpuF**)1<>%!
z`%-yR(CZB7&I;PbY{#B$PEzS+e1^pQ5HAPsD}+->SVlJ0+>Ay{<0c1-0NQRK0#1T?
z7Xht-6xT@A`?2n(Reyl@#c?*$+gWh9g}V#qCNe_yAS|k9bZB6mk`8O>s&F}B+PA6w}Y7DtSTPs*@
zyR^??Vy~t3cd3!jebyTJ`sc*RS4)C1^25f7k+&b}8~IZwi;=%hVCZ`BIbwNLj_Cow
zlBS*o#Z|!+&CD0Nl4F=+IYO?}uY=<^p18-K#ajH&QETy&Lk_*Nd}iL%5`$8z7KpOH
zPT-)b4cC6CpUA!|rZIBQlRnR565X4gArwIo2o#T*(PaVNX>8~520eUkE-`BOK;
z-)_kPBgahl7}s~oW~L>GUBg4F$Sn_`jN)y7OBz2pSDJK^D|;}=SzYyy4TPM!?RXuCNeghDQ@g+0^@becy)J9
z#S$F_7zF0vh;R?|jZB$a0wt)*@+K?jQi*~&?ZS};uI6v2drdFsiD8LEdQKjGI@O|-
zeDv4;eRHC0uQN;~g(f*RCVt@<%HjR&8f6g>zZj;?RkZ|aL5km{NmMgoyV_ce-D
zK7h!MpMVH@JeH0ujSm-LtYGMy9~2?=jub&YOSg>w=Ih>5AtI%
zEe9(UX0nJP;}t{LIVvVM-)>I2J|xCAIpNGe@MXy
z7AXKyPUr&5#eyYZa^Db)rS4Dxoe51fgziHe>s`Q?VAlX5G-*3@M|4SY?*!~uO_a_9
zrW~5#X~z%+O%?7-u6v(R{#^wUlDtPpmaM^C^fEVjt;Q?=3-G{C^^-TE&}7z>oI$ab
z=pncA!a3l-4nIkHR50bQ)!P_T*;A2YMkt5BWN)K62B9*~|0gT+qPba=4zK$^#n+{H
z`j>pbePNJw(5esfTlF+nC%_juvJx7V9&d7>5>)sDy7hK2yubJNqdBBo1kN;2=pJsn
zi~N{4EtBTh{X9thz6X45aM8ebQ$b#yX|472pFIcCkwMPse%0oLGOJ5X#^{)ILwV8+
z2-DK$!IEt`fJLT7Y+k%~iKo+Y#Vyh8hx5{i-XB3Nfv$DOx|D{D#WI4rqyj=iyO+eTocq?v|LbXR
z&X@|sDh;O5j**tU#_OQ+I%3{l=<}#yeIKXqv++I)oydBK1^?K_N_<>F=O}$kZFcX}
zcirdhvb!i?cOw}C?fYv^oIfN!ReO{3Bny^4jHw4RcNyL;{n_jQr)xEFF`}=_6SmWc
zjcHq~*8{=zY_Nr<*SL^Nj8!4==4X@GGRmlSjqO%_+7aFqUP^&uu-4y}?^9(5Z=!w1<|2YP{*siO#(t4MCBR9}5>--@i^JegbfAJPm(pv|!o#OU-nREmwHr`_FGvmF^
z{07$$j^De`p}dQ7*6l9JxwRSuB4JVapQ4`L)>Wru5JzV2Xi)ps6(2rDsBXgx>e+OZ(%3zWOn!a|jk38b7L
zDdkLzpxkI^4Jt~}^+=54z!V@w@tqz6Mz&$~WOUf%_4v3*{RzcdKATyOPPg;x6R@Hz
zX45cx>2lqUQ2EPH;NvnL_`UD~z+v#D>}F(u
zss~iYyKcP^9Ik5-1-{GFmqPkIb{|_vR%wusLY_QK3JG0EgVW4HVhz+7v2evCaQjN`
zm!(js!xVxPs)pOCbhCBy_-MjA}+LDmgqs$Hse4oJ)!oL~tu-f@3MC^3*Pe%!sO
zlS-hTekhL^(}OW96UaQ{UGgI_LPyl09qZqX6iJ|S%@lau-&f)X~IvYxyn@+u`N%MHO_^qwz5@BGIa4tn7VK?vhZL-WQkmD?k^)@DyAh-?aIfIl
zdvq4v$t!rR<<}W_1)p`J(-+SgojxC8g{2w|P4N*SIpdX*XQvFJ#^p*pYdL)e>Oi~>
z&oI?9koLh#C1fUjyHGUO=^4x09mtd}GG@H*)^Wbza}iMxwBi`C;VcL&)1az?J$kDblKW8u3bZ1
zgVxR|!7&cw3U6+AvL$~s~|-N4&1`Rt$mmVM0&)$w1Ri<
zbkoNwJhGb`9s6|)`$i~T8Q_({Jhw0vq!>z11SyshIUf!Rz;Eul$=2Ef$8Ny`;j-6v
z74KcbkO;gk%tKgAG>?dDw|SOXbpH8ea|O$cwbif?#%UPkGGSUG?M?=^uj<0N2_{{aa0D0p5G-B1dH2IPF>qfN%kaAT
ze4T#g<*vbeVQr2sMTO%W&(&p5(yod)wc;;iq^yf9$-$e@4;p
zVs{vD$mVECp>NB0XCJErY=}R=qWHR%Sabju^@PRQnl?9$BXK|~(tLgmlg_mS*rb;p
zN%5Rz#S_HevU1B0B#P4IYjdQWiSwp86rrpQ2MCtdW7Z!9(JRyzqWi?DlhZ&o9sdre
z^#DYUJ@^9#VQ}(S-qe^A|1OJe*mt>{9wnR_!y(-?{G(guMTp?wH~)}>btNRS!71Bd
ziM(+s4xNl|@Z
zCkpO1^oT5ndjmJug-`8?)!4180gENfKsL1$h;Z3rNS+j>m1l236qe^2EWi+X0?~J^
zw+f;bB03a^S|W(3Ad6@*TxpueD79OT?h!=oqL}vVG1&cMv7nqGc2KQ-EY}E@u;fn^
zEE@#N27fp{s!WJ2)i8Z?T^e{`C&Bd(5!k*Hfp4+wBCJ{}1^FO!I)#QXSNIqny|WEKUw<+g_ZyBj
ziCg%I(ZN-8*$TZq4bUl@0_tXfw%ioZ`@@y_zibMq-TlWKf>%}pwm>GmLD84je=A!YWeDeRKkHmp}+|yag(|!H9(t`=s*Ls
zF^T%Z`u0H6hOB2Kf{F@ZP2W8vtZl{R^sTy2gyr(b3hORJCjcL7z#*WRq^PiVIQpj!
z?+!uFU4ebPD)Y=6X|KVvUcwa!GF`sGjN9NTo#Ysmsm{Y}k2T$h_`j*D?7b=mf$EO!<%=xL&=e#USS+5>S|W@_^?j`^9-cfe^DywEULTplp62^oJj@0)02
zRZJdSfkPJL5COq&##hope_gW4x;E_AUb3~XW|HPy7JM;A}=m(5o
zQ5?);1tuFTFNXbRs0hRUJ7`bH52^wv_kt~g{~$)7mfR6s7hEv_gB@@}Fd=7bPe!uo{6zY=p4lM*XfFZX
zo}lzsW7>qG38g>YKaf_=h-IsmMppNe+54tqO}
z7BgV99-oEjDfU8#$WSIiirI(*DiF#y$SB@=%H^#6C>I?x_*;fELT>yXeptqRCU~~n
zp}p^s;9J1>EAawKC^AluCTMzb!Sli^dxNXI?qPtf@j@a6FO=O=@WPn;5{o|Sm)PP>
zygrav^l?#Qi`Pux{DRQRS3T8fvVzl1JvS7f^0M@_K_0-?TVoEkX^uddP*UTQOkp6^rrHcu@hfMZ=
zvl<1|*6}EX9KJBmm^9G$1KOL&7dy0V#*b#Kokm+uFQ}3k&p8$N=~NL?`Vl;1BL!;a
z)a?_FpSBLm|IzYvYVL4HL5kQYv=3lr+6NW~8f2aW;wVIrz?JOCk#JKj%v-s(=U?(m
zrLojg4`1vMDKAcc;5|N!#aYrXow^U8l?(V+Z`rYAF92CbzP1hk-c0IEfJ{Ai^1+$Z
z3OpUW@4k5xGO1;J%uCes!@m2T2J$KH62O-?@N>q&OH)nwg@^Ww++B;TjqO?HL%|Cr
z-3ng7&}*s=;0bpDb0=JvxDxIh7RL-em!k`raBBq2%1FA@Hy}u}`60CgTBGb48$(aF
zfu2Q*qMw1-q)YUJqUc+x6i5>#3y%fIyb?MEe{2^z=qD`-r1Y
zFXpS-@tSM*W@*rIds8b~DdT*0WWD;reFYKLs|-aNePLyJMc&l$V4xx~#4KsY
z5G!t!r-tHnrak&*FQNbp2Y>~w=ziXifJy;4MwB(gn}EddE%v=6Vyy`^_!CWk>Jwq;`GPK9UGPE;Q5L-5()s$WOU
zwb8-XXiXs<99!Y9@SlRNIivB-=Mpd*n_EP9{hl5>uyqk%ncXc+R5PX#xm}GQ4~TG=
zo*;q&0W7ce4hsyUErV$1a$MY(*X{d=wyU7+s=RAQgqZjOOBcvQuf&Y
zFg=au+-BhT>@nI>NX}(Aq#@GKd_?;->Uu|PxjEM(43*@JcM@6!1$+TqHLy#oMJ~Sl;<7{5u*Q8@IpT_&8Tz4VtcXRDz-yf
z6wH_2{Ib3RR=ZiLG;{&32L`Fw!H$2%pJF5qL1d;+-?S%rlNwz|f*Qc5_HDv3OB?cO0W2
zeJY-UCD*oNZbh8IFCd4$n;Dop)4@1r)1vmB7I{15FRuJ}^TCVjIbJ%rX)as;^rE*v
zhRcqxsVHBQ#|dAvIyk?n;CXZqWG=WJ2Z0nkpSNG*F7Y*}T?Vmk1`e76%pt%REU0A@
znx0dQpL7$(^%*{lPN$~fXF@uK3*S1m44Kqyq;fnm;YxIXn4umiaC6LzI?K1Y94a;?
zJbe%7x>Axi$7j-_oZlIQC<%XJyOJ;gv#g3AQHU@N
z^xME$F(y%D(v$0UQ#Tz%1$k-xy?i*Hbm~d4P`QAA^9mj?H8I&=Q)0Mt=vV6I=`u}&
ztu22Mp%mVS0|2z^c#k6n_lzVMl9xy`8rxGdQ4sG*8y35mzx%izg)g>&&<4Qmap
zofwhbU!0{6)b?W6as2NgHnMs+YO&XsFNT~SIWgM!KW$7En
z=hsba9&>kTV$Z`piUz8zh2;kp_8g*_91E*U=UUiH@@|Ll*X{cRh~68iXZS{n7}R3rC>S6!G*T(-(QoMLlr~@7LpP;g9>_?S>!Z
z=v%zmO%>kKik@O>oSHT_ET(xV_fI!aoH81*H#)5T=`d)H;CH7aoY>(7MsE@?<8(~P
z!9k@wD$Fh3DXg~>=@6Y*U(G~CE#6b~_O@ih8Ik)Vd1q?+SH*RV8K0rNMvCsESd~%B~P>$4z-bXH-Sea%b
zGrg4Wvkc!mfp2&k(8T@WU|A=xIqlubaNZ1T_Y3#5hBLB8mW424vDqJB)UWz;)An{3
z$rIf3$6`SA9DlX<{BZ=Cbe||y9s*?sx0z&a5uV6Lu+pZ}${H+nF_JPQW|^x5Es2DZ
zm=%ziManzeCPk6w-e}9y@%feI^Kq~nxSVA-FXSTxIKrEIs~WqFL?iiPmbcymKX>jD&&n5PbK%H}h_hWdX%pIFDGBf%vK!Qm`HHTTwl#Umk%
zERRkDX>1#60@Be=5iDy~0=)=l%zW9as|^)!xJ=
z30Kg`=7#4nZ}~1v#=>DS{%~s)^Pc55yXeQPa%epX&05%EbOm>}B#s>5LJV6~#n}E{
ztyV+=D?`uczzDNEt0S<1ckT$=W%hm)qp%Wys}Yh3AjD9j
ztyfi!T(6`K;+H?t{J4DRx<=T&KvKLdG*1VujG)8%@3O?^oMHrNng-XQULgZuZ2+k(wQ
zHF^q~2;)j{oIROk(V}xIyN@ZFcM|N%K7V`@Do9J2_>b2rT2olFr@Px;9bCD(=^#gXsLT@nH<=%Lan>8J~KP6cGH4NI1tb3I+
zFyi%o5u?42W4AD_vxb^=3)jzJBSDux={j+pd-KP}pJ&s;o!IX+6N|bWtti@-kqYH~
zvbSie9{Q6-K~716s~~xzcWzqWg(FE4IR3pmu?7H{k_5iM&SH&PB^ti?L&u86xApO!PZT$w1$T>Ykn)?zWC{z1
z^UoEMthP{#ZY-rx-uFWy#U1U8SF-N70b%l$4MoiS?C*c<7?W<1TY}6Edbt_>t&hok
zS-pR0R-mlpp)uT1)X#Ij+rcDTez2LE%8}&b`Qut}QRsX^Yk;gv#
zvFbmErFUZ6YbF+{X(y4#tqSFRx|hnsxDteJqap&rYRW`{3j)nr#}~4^TfJcB8c@%~
z8^Ew|tl8HQSmg!Oz7>V=~!^UAmbR5aMkrt>?%P
zrUbWPA>HDirL0EPH?SZMPRCbp6zzL7Zs4TFB5+eZ@MnlC`}f}
z0&L|rmd6h4Af!UFXW3%^C4%DcjiLA!2N9M2w_dkVv;F_cbPKJPJzXmq+InkDA7ZI42O`vLgut>KFvy%pSRgE1t!7!Y!F
zXCL&5)pVJ73mL=+gRJo4aE#v8=Z^UVifl30&dBN_su?ss0eTEdRF-=k$zI+bQZ6hJ
zcj7G=gqYb5An$ifENe;k^ENldj;y)(rch;ZdQh`-Vg@YCc-;VPY&nH2znNu#CT#?h
z2{zC2rVAjrzg~Pj2YO|TS+qA2Zp99iRIVLF<)o7b~YdbCs^Yhl)Hye)N+VwUz?8tFt3o1{zA8{gkLfVhG
zRO)Tc%Ja#ah=4`|DfXmPme+P9$D)J`Di~^b-=nr|G^lvC5ByjpsCcb42r5c0$4w*m1Cq{t5To43eq+CjM!^M>>opm_`s;m?u=HROE<-H
zNAFyow+Zol6XplA*QfwY+^i=JRN>ePiNrhJ%$^>Kc}_!yE@GaAV1Y{djK&SWD1lhU
z+ox;jY6D#_RUsN7P31QmA=&VGPYxiN_?dpk<1)T<*?Z|RxgH2b@!$ZRG4E-x|L`QX
zs?oz*e@7C4Gb=mnntb^6=!Ki+`XvOHVuNh0c-n`)hEzVaz8_e*8>ggmSHZo0J%SfvDLv=!);8YN2rMG!LF0EYEUV<6Mj@$ot=
zHmS91$>hRG0Ec@oGBUF-gIrUGzTH}^6)5c`owdOwozc9~^VzazZiVky6F8}RvFKKU
z2oxqHuIRO#R{*GsO8)Lv-~>9$M^oc1<4dLNny|Z4XRK|Zig48(>^&zkNH}tilwT`?
z7M20%a@;fzk(JiZA_BK?@fEaE_CMa`lUuw-5=@l#k!Ut{k7goA$1=r@J*iOMc|{a~
zTpK9!i~d~TL4eDohJ(Ed5(@K_aBG;3nR!lRLPI?novcHBNT)_3#T+VEkmAw8-nD%-
z=I9;tqXv4DOk$59F((k2I?x+sfG*e+&`t*Es7(Q_@1s0S+7!?`2B^=bfMy$@0h%oSe;mQy>Uu%hkR-M5>a*ERZ~U5pYq50r93hD*o!6y
zP+dZ6a}*U`D|a+eQY*6MIiesWw;x82r3aS9^6-VWF$urs%(f9wojr;%Bd7C$2Wtii
zKgVf}v~yVykVSBy_}pqiXb<(1YKlwYL1K|(EXUkaDIN6N(VK%?*h0zWX9r-QpT_}W
z3z;4Zc!=On)?s}ZPXsg^-UWXA;%xCd8XvFQ#LbTQ8}j=Ty$!vL-|vog0o;xQ0HmCf
z+y79e8YYz1x3GY2-^(r+DNpB*mGV9PDbv^qCI>{-Q&RjH@EvxrQr;4R^V#}(nh2gcza06tEdjAH0EW@pk
z2N?dl$pMB>mK6W=xQhnb;CZ}Jn^Q3gtYho}J22G&RWreqg$+=DnN&8;DUl1zgb?rv
zhj0#p?f~vH5`Hh(GQ4M|tG*Fhj%M29J4;!7GdGO)a((yE^0y^ijMnP_=z)|&4v}#}
zMB*T`f)q&GwWV*vn!y+*QFR3lW10arPy!IJX1x7|V_TZT0H%enyU1%^V#LdE#-Wzd
zUq9p)PXCa~;TSl>^Rrv*n+?zL0c#>>LHc2H)3~hZ*D5eYFf8nQBIdB1(eQIln>PI
z=1&&8Tf!e}cb6f~fZgq7a)986Py`H0>KtCb+b(EtfCf32zQkW|6>MG^bA&z2jlvc$
z&=+JpN?D@igTSjY=RuaVDzp%l+jp?Cv|pH|4}^i(T_y)mjaHTf6<*IKOV(K#7wo&w
z;q+U9H+88K^UC9HKC#rX5s;Zj1XXO;IjMr}f?^0+<|p`M4HS-4`N&y-2EBN0W*^Im}cvvc6q
z45Nv=^2MmTHw-qN+5k{T{`z%;N#K15Yh60kPwU20-x#^oFrl=bYtB$N`d%!mE#!|?
z?P8YSiCt}S0M#%_QB-)1ZzFYstUDzKFyN=ro7c4P=*VB3-9ELyee4!pFk6-S0r@Ky
z@NeGKJ{h_5oQ2Nr^zeLa@bB%6ct{F7XD<*V~@8rLSZ=yX3BDD
zE2m*FtDA2`abH>s!ro96M!BwBK>e{-Pht{Ntk)*q?7
zAFR9|9_IZk%F2n&GC9EP8Iq!?@H&OlJ<1!_TMd^wjNup)RoyC>B}|xG0iON(x~F2H
z>TR|&+38EC@`Ohzzx~n%g!s}EUs_YZ0&^B9kUs*MoV-7F;OELyLg_;!y|U%7x!?e3
z-$q?{drb(SmjFapTvfK9j$^7`!y3KVYYTL$(F6-YpZgg&lm%6b4EZRf3mC@-1ZSyJ
z@x}WC+CQm-CQMqqkRqU|z4|Mr_P96_4SzBJ@s(BAAfPR+KUvk~AihSRb~}HpsgFHP`#tpiPV|db#U2~?vm8|oEiwlhaP2Bj%KsC*&oW&gxuQhRRD`Y7BXt0Gv
z6C4zP6>h7CBj8=~aL_b?9VhkFzRqSB;aeTjX5)7je(Nog+@2!ua}lJ6;5-+TsljAw
zL@^^L@BB=S5?VIuYI6UQqnB^Dv{LytA35A<|IRS`N$I@^hNh#TT^q8^{EZSMB&bQH{
z9eWMRn;ruz$AKZT_=)tzM)wyRjkf?B{-MweCn*c3WB_%+y=5YpGha4>5j2FCa#zzw
z^3ay_;Ve9UW%^OF{86&Rn_4SH$(?9FABeOOI1uTIx>49o@Ue1nm=C}zAL6S8hwuSh
z0UvWD3yL9YuTxWm<#4^-S2>)W*ef=Hy>cpIu!TpZ!c-U5h}Lv{c?he_d@HcaAH
z8=p(*aVJ548V2rrXl6#NS|@{o7ZJdUj?H?rQqoRb*d)
z{;|z^yO>Pp3hXVqtfDxEadO#~wA>DUJ$EW#$Tf_Tx6Two0@8HygVm*{+Y3#Vr)7feGn$-@Ni+8^36
z3%(_C)+5D4Xq?zHg&K-MYt+~ZUN~tE(Q`_A=$TGc>9IY)OBE8hWt4k;&}t)IA#yy<
z#^YpttS1~o5V$#<^P)%DH5eyVMmfn!GO@=;@yf;?)jgPxk9oImU`_VDsr7)3>Ex2I
zM@8wJvL!&bLMuuFF$-unTBTe?V$vY^Ni!sA5$Aldwpw}e?#rdg8D_MSt(ooGch^1E1#u^q=irRc!
zk(dk)9t72iYBs(x8EdSQDM%@lZ;;BNixyN*>SCw+1JSzq(xuU1OfGD6`=PKBQfB*k
z?|v6iWUe9hk|rgHw{5)($$irT$D-pd1%5v~N{+xk6VM!iWA2~%a|Ql5iol`e2SWm{
zrw)1W+^-5;s;rUn!5kXra#UOAyAtu$A@k_EUYD~xLA`zhuU5oYe7i{zKh|zdTUsR6
z^>J`)vpUHY-p25Jy^M~d#^OF~*bW^rzYU<{ts^70?_koVXd3;}Y+mU1tOQb!#&xh
zg%UQ*Rs)BVfzNTr%u>xr;CwE*3v9PPM}7_Cvq;gEekAzQ&<{yuYyk8oooUF$uM=D%
zEl|8j3mH*wVVasWn@Q?UktC{{ha{;cxw^aU`>^h8ZvtiZpo@0=wo|OVz<6~RQ3k(F
zh1~o&A{5o|+cL1ev2Ry}^XV8U$>GSc(7DWvOH2<^!$E{7xZT*sCprAK0YMx2)@@1T
z;I%z}X07$CWEzRf~L`AqeiX>GA?_pdjRF)#iN#4@3XAZxZ
zdk|{<6a#-CMch*(c;PRT5NJNyq@IcNk@$BKAWHG?IN1M@_;*r~#m_o~1YKH#s^tMy
z3sG$^s6?g8n{6?2%TfoxF8c65@mBbYUkaRY$OFYP9*51+kb&$lgdD_hM?n9fPQPjd
zg<%ofq#8wZG7PLYv+EId0op4?GHU6$9K2&raVAYh+PkoNu!9nvd^_cPbB-tsh9@GU
z_et}P%=rELoA&UiM3)TKAgHzLmiqa6XI0L4f0Y78zxqfx7$N3xSr10-J$k*|~;
z;@$w{AYqRc4)$JI-jbJ`y)nOYBtSzl7BTt~58iZtbt8Cd=wyu;T?j(%W}jaG3%~26
zva#Y(${1e=fO&Bv*lu7!|1B9IJVGT~5-w~Xji%WmHcud<*1AI*tu-RMPQ0-ipgjr3
zZ?4zY7nLT8tm!M?^v$eTSGb~MK?iRH*USj6&PPXr9UR(+ee%c;BXTj}Cz9&V_s%Cm
z7KhOdvnGP2f;k*kW8oOg*cgI%90o19CH?G6TT;KDmaA5~N)SBm$TFHf8D4)DEpd>p
zf!YZM>3Rwr9T8JAUd5T>oS?@@kL>L>dZFYV@Wzb*6+c$_CBqn+I1E9Y^5tKMui`zn
zg6t1KCUqR>qe0VlC`_p58S&p{bHX0r%=h6GABcAHsnV*WtH{ku!qlTOM+@hwUbM*=
zbIW>J*P`=4GH#9x_((fbC$RfZoVt(@v(03}(Pdx~{!eg=s-FT%Fo-sGAB#ooX%vnQY(IH580TF{)-6Q0%!_$Cw$CKf%6|M{#n
zG2bt0OVkz;px-vJm1AS$!}>ln*wF}^PJ%TAwm5YD*Ut`LL|f@}cKC5%SMlieXE`o{7!-UQbAIFwND&8!UeH)d03uFNibvirz>dz?(s-t8O{3?Pl
z)=!S6M=JR)5?as~L@Vn>%x{0uoRtcZY`PoFPvjjv
zZ5k%vvZ`P=!ViGeii~%ufZHMoHnTHP01WJGwCm%x5phPyjQnX!8lbH+XHma4CUc|n0qWS9FIM+jgXdj+5tP)TQ`eWAs
zjdXS(&>$3fQhXmBotO;G2N=c<@;ye*Jq%$HX{-wi!*-8$aSbs|F3O{Vc$itA+K}kAvi_|s2PGjvjOP4n11@5
zpprUeEe{;Q%NQs4p~&xLWfXIhV2QSa^XqAUFj9zA?aQlXx6dET1!u#+nVPX_8|6|+
zid1v7VZf!`b|*}i$1{$V+F6e`TBn2=4xKP0|ULOPo#_QfL
z#C!?n=(Nx38w+iNo`cC-wQQOcF>CY{B&xzLoJQp2C;x`o%@rKQnh_cerdUo
zh?v$irWoz8L!-0$PYxc)E_3|Q&i54?S4!@
zLy`J*PuOiU+i!*EkHNF8dqMP3kHXIeTeH9cewV(K0GQW2jCFy7Um34NTqd0bzGu9L
zzT>HZOYn-U8E>LeZopL;jpqJ~CZ_jdE}1{((n#?q4fv&(!28md29eBVBqQC47Uo$=
z|LqJ*IMaG2(wG#!x@W?f4EvfkAd$YjAKp>FN>J`2is+SW=+HT~GF}Q&M%!d=MH8LY
zXD%Da|ML@v#9J^#84BES>O%d^Ylidx?)-Xr%)1aq=^gp8SSIj9HHO<<-*5NFuJknM
zG*9;5u&8A~dNFKcQA?jKntI2-Q(FTBzj-Fk*4M-$ug~rsSRopQF$uOOi*lRMw91Aa
zb2&flw>N)cBMVAPMX_DPJZSpcfzTW|z9y@hO6xg8hE>szjOv!BdsSxh$t|8Q
z31+WKu`m()@>PE+)I$`R8>>_(ul@^}+NPh+;r~XFtvy|L$K>zj9uT-7H_-#-Y7=+3
z+(6`o(}Ie~J;3_r@dy0Qo{RP$^65MG2ntLp-L^0i^fHdbXOPKwhe@0oub+Tf
z=^dG=erd^O-T9j->0|KV5wmZC5??phG3M5lY#-bt;+-)#%|qr8W*?nKkF@w$A!pQa
zU`sm}i;0~htHJ#$vJYTxst)GGrXmm@SA~Z^_IIa`EZe8Q^oH01&twlEJohcy_4jnk$qBruq
zUeV_zuZAez%Mk@6Yeccd;nbxO?zW^FbL!A<+OGuz-Ii_QZv>zQj+Nf!^P3g8HS&5lPVqO6hGp$*B%op+jpGGV{QpX)&GFH
zGY>Y`(fSo*B`mo#A1-NTrP7Sgqk`nip_77#uiXk#eZ=52LuCWP&cfcMl!Y`>hrLUa
z;&DsAlrRwkHLJY6OroN7N_uMY<&c`CtcaFL9znE@d;pQn(?|0h)+tYIkY{mDo_?CA
zH}eQjmj*oDNmw^k!eYBMT6!UTzfh==4_03C;SSUwn*$Ood#}Bt^#QTwKw8~>X;H}6
zK+~PO3I#Kd?%4GctrHE!dHpn`qi>w#2K&q3(v2?PB#bV?c?{nHI6cX;WKgw@56t%ngw}8WyI7Q1n89_!>=WTarC=Ju@xRha{9#P@vjO=k)l
zJE`gt;RbW(=A^2+ciK08sKkO-ff!Tr!AVulBf);{>@cj9-{|pFFF@16GemX7;n4a}
zslo9&%5FBYc2Rw|l3Jbd4xtmuQP&S(6zZBR7Zx&NW^Ek={XpsVFp^5_1*x%{JGgnf
z|4XLgoS+rw_=8#1SaI&+lUqDR5=_O}jYj0e-d`x0$meb1_+o!iDDSb4B_IaH;P5Cw
z9f&R?T9HDpdsAe|P3vo*DjhjF7wDxOsn(N!5@j{}XDOM3RKUAEj^TDyw>@D6<|}zP
z5F4R89Ico1!E!(J#RnaNv^dPc2Zw_}vmwET)q@cebtHH6j#{qf)+5>9I|R?6V|y^m
z%s?dM73^qIxN1o3-2&GCM`!F*tRP2TrJk{~_zg0FPA7suE^a*>Rl<9UiE_ryL-M(@
z{n9|o1HGF~;=~{^cjyoM-wn_un*thTfG*n<&`t*E{7nI^e_e%n-bR4T{-d+JHw6$j
z)GQ7RJtrr2#(cFuOwW|or)djr-@6YIbNz-tHl|IoMmVvd1{_G%K$xfv=ze9qpFUjQ
zA!^J14^Qj4`7Jw&!82#uNk6@Si^J1%dhl-zcNT>e&p;Ld8d4pX-<*`d@t}=!(GI6m
z1Cdy{fPeFnSY9mKl*r;J6u$NEAmG&SW5RWbB;lH^Q_>A<;fNYS4}L(F-ysW#$*YBv
z*sltM8}@^xARh{#uMmO~l+Fed7U|wd>%tqQ;DAX};P8~onXArj%m4tJ3mYv
z>L?|`??>#L_22D8JoVuJ!R}<9!^ljB!6m&K-JNVbq2~{q_#0ivG@epM$T1?7li`kJJ1L?34
zl9P?LhrikA$wu$KoZASs)dh{v1RQ*p{j(y=JtgQq>G9x{pm5Vu%#+eOM~<~%fg);<
zN)?S1uHiS^^mK|8!edsy>D-^cNyj!ig|Hn-z{X7Pk+SrUEEyoSKc^pla;u$_l8^Qj
zAhV5Bf`WIxL|skojZBpb_&3j<1M?EQlP05oRL*}`ebTAnB$fN^WMI;{D@O1H!JfBn
zGB5-89J-ag(ChYUv;jN;v~nB3lfGjESVP9`kwj7oZQDZ4;5J<``q~$4YYS%1pkGo>
zHKTDsGQ0DN$glFC31
zQ+krHHH7T)Jf)y>NL(o0@gUbl6`%8Ot>W*)cYCw=GGj>#%*c-@QRQaStn@;ca9!gJ
zrdu-^_+^CaMRpo7Zt`v7iHsDog713hf+Has%sAL)%t*BAIcd~O>#rlITUa^FMxwXy
z$t}KH5=L9#m-SEZ--`9B01$j2^#Z98%i!QhKW1}FxpFb^|WGT-C?s>^6bb}I$W
zTwG~`uFV_~JX+t#%FO-XAcNVZelkPg79N7d>+t>v3fLg;@PK`@4YEWF*u%|P3)B8&
zH+`0gjTU}~q6T^Nly5T*l0i9XwY=o7hx}s1S2i5P+wp{fYz)v#U)aVMh$DElNy%my
zti*k5vI&BdLQV-coks1w_Gx49TZ=dg^C(W~d39I8ZY~MN-v9BM2=-jfM0+2=6gReV
z9}&N|&pWht(!yRmoUdERMHS;=(hCO=KVJ4^oJR<=)y!;}3>dy5IUy7O673Z?4GGh@
z&hASbO(T%1BJmY!!p;>S*UEmmdY?D4#GQ3
zr8;ykij!k0_wvatE|vsSquIVA)2*6`@;#C%ZtN0;@=kkmJtjWlAD{@$+1*1DZjMSA
zFwL+Ef`#PVoP53Y+^8TpQDbTYu2zb_myi1`SsfY%i^2RhN!ONXDDSu?kpyP4a+KqYfhI14*^EKCjz*RG
z5hjBYy_y(|8Nfa~Ss^cx|Fsy|a_`Q??KIfcFxap-S9cQUY8B^dT>tF!
zN;`oVaNK#B3U&FOBFel$l&ukEC0cMmj#NmB@@skoOl1)mubVBGW`eb`XHWxr8pG)+
z?N(%f@aumFQ5+efR8J8^H0rmM{&>YKVV~Ds>Ce|pBzT$9f5gzg{tcxs(&3J$%Fp2)
z#=x^L!WE~|&G;6wXkBVdSKR=u6f&{a8}38uKQGKKQac>UKE
z<=^2(?~_nerS)ei)!Dm~92Ir2(tkk`jG>&W^tTG=H!c$TeGUEhmsv&q7728%$-xkJ
zHQXj=6}H}e5ct9+sbj@~*cD)moW`NWujfJqS*uf7J}WQD-SXHqhvv7J7*^|Zh_*Bh
zH$3t|ntcIbt8aF>&z4r7mQpVj5{FCh^xAqhAj9L0Q;JY)^{d1LKA>s*uQ9}qGQ@19
z#wCM5LX*v6JwKnMZ3(E2@!4a^BDL#t83RO%mQpbu@ALK^pWNb8!n|!*2%$N#Ihu)b`wLUt*uNCYo6dP7
zRauwf5y@^(k7l>{5?HM`c?5IP1`P(rt`ZhidOf-94jzdsUL}XbtfH;_CZh)gSlRtI
zRS_z^{1JDTkgEk05bOzB(M;^X{N&BW55%oI2Fx+=ER=ROf2?zCI7ubc}btV#Nkq8>F>G`zypCmfa^)Cb`e{mmxGxHFg2@LMAYv#OeNr`Qv8}#
zcxu&7V3oKsZi0Hpt#kkYBI6j>Y$|?J%ehj<#3f3(ajezQwY6oSzKJj6t168zg9WZ-
ztyy+LJSS2SZpw~ST-=!5j0w6ncg1OcKaT#;4Wq+}@CqOUY=$?&pf_Pv;tI6y936d&
z7c%gZ%!814yGcHsrJV{ztRbNOl_^`yvNN!79}E4hVxyTXNE#+bk%b+h?vBI6m8U47
z{o*=-L3pNz_%~uzbVJS!cWJYYI82->rhTX>gAPc7`FG49j{&}{=9iED*a{8gYZ9wO
zuP6h*c-|h{Q{3o?|8WOA#Ru#y2}U&*iO_^@)l*8SdDQCa|ZDvOXYqA!SD6{G)
zne#$qW0;V&Scd3tq#@pOUtCaXsz&d+HrTr!p5YUxTH{w|D=ZwmbJ1*RlfZ%C3J$_s
zO`LlH8n&wA@U^T=&>s|Dn^Sc@L=NX$`1U~Y%u(ua9&ojw9Xl0P=Dt|
zH)5}|vSy0tN@k48jSN^FIN>6^R?Cz^67lDUPG8i0lzbt0fD1vB$l`ho%)Svr%t!oDK<6gv)?u*R*EH|>*
zBD_w9x)ekVH52ouyXgy9fBSSPizM^bA))ffdn|X7mEmKhkZHGK9
zXEhV3D%FP%P5O8xKEgG-wY)5zRRZ@;$O_9oRM#5hIkTn*7~6b_uK^qe0SkJoqBRpW
zH81i+gq2{UW)Fxii6iypRNmla0Jj9bn_7ScWbuAcW?f~Zw4No92Uh`DvsX0?l>)7k
z_~RNsBhP-gcGOB(xfQm(vBE$ai_OxXBSGAg`$wWh5Ne#(7CZ6)ybr-UZ0hl_sah>I
zT9Te0egk;9K0wMEB<3Lz_aw;XkRDF?qXD9|98x};{Ld=Ey`3(Fp#=rzRiyf=9!^Bc
zZ4DX;H{E5~)J@!khXsg9MmVSP5oB(b#Rh=M7@M3!Xl#>HmcbxSbR9wMW!~k(BxhTMRs1}%k^*2YRg1_y4_hq+^d_D
zkMgA)c`L=Ghwyg1nmz;cOWL(W;c|V(TU+M@eU8_ZYnCQ6nI(5sp!EFm#bNz|$M^Y&P1Tf6RBYOQYh&4}?gCzQ
zIu!@s0oVCN3cSPPF!4Iwk%ZYp4V*5&&X3{y?weu=_Kd<<8dJ|Qa{t4f%nZl$kAy0o
zx7k*-{B%rv@F_kZPZEq{I#7Dv&<}S=Awuy81tlK(GMB{?&MPm_c7>f-;dxxlQ7Ov;
z^c`O}L#Kn=6e`MA`Y!Z1%jxovtZKn`@D@Eb+=|exrU|SBD5@PGuywzfjl>5`)wVfg`9L9}nZ9;x^~xA``>
zp{d${3di9C+nv)0uCj%Hz$MW_E$`S81y-`*{S+^+Ce!^}7KJ5u-fmcOh_Yl{j%CU7
ze2NdaK@tp09tKT8uRm)cw!1Y`;-MQgm(yn!dqte5Zg)tOY=c+Fdkr|nKGE3R!f~j=
z@!ggdjsp~q)skS~*h%5|pvD!A*kc06rUs5FGetBoSOwxW)B;iqZ%%a$6+w8$!&Raq
zuGHs3{1!%t(zU;~wY|I*z!2XW2}j9HNO5cQa5#<_FN?Ury@%0mYuVZ)A>UWX7qAxg
zOw6)sjJqKS(#(DEM
zCv!BHGyZv@MK#O|9ieLAIfjct0<&x}+vW+{=HJ{lU)MIT_P2RITfqG%UYnb1n|GNu
z3)rSPUN;!G>17)->-|G+L+5EjTlpJ0KpXn@R+rJ!&dZB;}~JanD9&|B>QuwR*#~b!S`LhVAcN3E0Vm8NsitiYaL_iB@Dy%2sR_3QZ%K&j9f$I*hD(l_nkXmmxrQ5ni@Hnr&AkF7v5*wiJ*d^8
zn2^cQ!$@lJUdz@F{Y)H5I58>#<8-5le)h=|am1@pMH90Rf
z&>7NtK1PDNM&T(fUA49F6uD+~8&>7I2r*#NEO8wUMgUO>A!27NZzEZcoJqsh?b^}B
z_qAq}sS_3%nG$J5g?-t=WV{I?@JxY71SFU92dZ`aR;K6(d^BAid@W$PMC&|pEa3tm
z*b4|(?1W2=KD{$Xn{~NS0*^T*SFy>(fLBFbM1w+||Y%a%lch&DtQR2Mg5HI?6XBBWQ2`OT8tM0j~$AdT=IedCrb@lJ~1y%&DU%NAz^
z51NUhBa9DsVEtpI%VXgsdSNQ)w=DqS{YyM)V2P;h_wTI6ZOJP^fxr^MEs@bXD*~s^
zMOQ?Nm!X3#=Rx(G;hYEp)Uqia2uUPfybK2w;yIX0FYt^&f!77D(UeHvxuEORYh(mSPi0ZNKoqxk0!ctl$!7`%)X7HNp~5i)vM
z6$sTpvLtMTf&nLiCvOP+KI*})xEHyf?E^qbI4C^;BLx6^lEd$6AE!#V?SD4eBY?L5
z68wNP1ZYG?S87IqtF_V6nOt#@L;~Gx
zxiko~8f~%fe>CjFY9*c6&7J~wee*(oGgWUdRkJ6cjg`3o
z1Iv@B6mv8cWeeMK?yK|pZ71Gje3kyN|8V3F3|U`gGN0lD4wnSutDFy6gWs^T79uw9
zfhp+DFVkF(^SBt72Ay0k?23-A2_$l2;e{#(*meelWW_2F;_no#E@x9kP}+i_aeIeFpUAPlNT}9$*C_P5csV1BYstla6
z{41XK)J7K0Jr&NEB*DPBgiyso6SNTFJVxRCO>;SCJtmC6!sAgC55UE<#@tR|Sgn3$
z$y;AE&lu%l&OSF%F|VuKPXk+T2Qow8DjUrkLCJ?d95|wo^D}TqD9MN$fnV=q;s&i0+MZz+T&hIz#A21Z)CYM#ypqhjZn@5R%QdH#V5zH
zN<+R=mCb+aV#&9PPw@d)OM+?XenJTUR|}B{n=>UITA;a{g6T$%@u_K|pwkEh8?oXo
z7Jeg}i)bmU5YBTU>-12>SAFHqUyYgt#;nIqFk{wY>JL>S7W%kC00v*0u;NO9?*3A?
zfch5f{%KkL&Q^T{m
z5!V1B;uFc{XZ+(*KIrNEtb>6ck%|xh(U*T1F~En3w!nO>UB~ypq}q%3xIF~-R!tY)
zN^C3=oyC>p7(tE1kKbN$?!+wa4{;w%@DQJ>NdPkuE=NsJtJy4^#bIw1pQ2UQuui=%
z)1>K9=+&57td_A7ragxotfrPru;9Ri%Ukj)o?^-DirM@jrx40qh{1I^uM(MhXCS=S
ze4+5B>MFK{$hk}qlw*QG5yAw)1o;$G46&8lnu~K
z_rvWYSUv;x0o-!jIG=4Bkno+I-+J|qK+V7Q(Fuq;vVFvOe8X=oM0#|z>S_Q!x?(ne
zvas=Z9!l!{9vX!lXUIP~A-ih2WaYdlMNq*(Y$PUoHbzHpcp2P@2zrR$6EWm?9~x_N
zL~p<*S(qA`%7~To1wkD&czjZW_B0BOMs7{zGPQ1s=cG_$PGtIdG*&b^}A$!d-I{f1o%@d0P?$6BNF
z$gWsuCsP7dy-UL3)Da?!*RQ9+yD>;qeagYN593UPz!aO<&x}+U<7{q0@1dX%6yk=)
zUu&%B1SS;K@+LX#EV^`!fc_AFEa;C3prLb23BbCof-Y6zbuWMp3DdbloOdya)>G#v
zOz8b&O_Cjpik2DX)7{dh-Qqvr!{T#6RM`M&sG!#OV+@gk{I2Y+R>n5|-FS2)=_O)}
z({`)rPBx+X=~d-mN_Cl~#R#Frvr3Eeeid3w$
zF^6+9!je=l}rENaaoIH5MKw6xGgDcowe~c)I%G>8|k1HzfeT-=%}n
zs_ilLfC{^^
zsUM0h6pA-Z2|#f*yBKfV-))oW=m=9{wHgsKmb6-fO@{L`4Cl!`#9_c}^0kO3metD|
zAyj?IZRltG%5_z-BDHx5R>Ei-2>nfq&tbNgTuE>llVZS&Rdcarp;mXaYV%fjME<
zwHt+Ga&&erCOG_EBK*8WRXq~RMFp$)JrbX>cz020zL8t;IJ3axq1Xl%b`{8=_hI-F
z(W=GBQ!$%=v#vT!A2!da%$23?QZcHEP2hLo-Z!&Fbl8T=y*WQ%wbG}uv|CE}?D!M_
z2p@&Ejo{h6x78L;R06d$m)B$#2wfwzlpeSd}O0hsj=
zL?99mRcS8grAYuyv5f@I+Nfa=KoE^qEd=0+ss^Hq|C)!Az%eCYNa&~bs|guQIz8moO`Q{WuZR|qb|23$3nXqTw)WL
zP*l4cZF0PO+e*QH|9_Jl2K#};H5U3|oQwS<5E_6eRe>0<+)L~QB9}26!CYE!u|Ueb
z;`vcn9_dc21W(3SvAhT8UlL3q)L=m}=hn?(u{8yLbU#T{8fvv1xd|~X4XxTZAZ|oF
zG?7gv$K`Hnt2`M<1rLqH3wUT}-bCV6w63#<)>{gKHvQ;(N2^w#X3+4dQfo<>P*jU8
z>ZE!UQw)%~+5E9opU1uj_n(^*sH(rDXjOO(-$M^g`Ca)ek@l#3#VzefMD>kEB5tEt
zyO)q}<-$f2i1}BA?OPlq4cK<|!}bS-ZE1-s5#!m{85;`N9-HW@DlE71!8K3IG1hI~
z8xDsL;Q6t30RFJb0Q@N>QLlCfX-1jmV-s41m_rocAqw!N{ISF=74SlPdjNldt_}dR
zByu^ecOyh48k(YA&s4Mn+7Juc5eixsNC(i~yxj7c2}QMsDri%G5L&*^9}C*Y0!Zji
zQv$F=6f~&{uV?x|!??y++!`8&m@2@;Ve#Hwe8fEBHtN{N!=hgiwNnA2Ew-LIQrQ?3
zul$?aAxYm#!>#_b5>Y*9B^G*atR+dVkmN`u$*n7dB=h)VNs@>W;!wFM0UQQMiaE0d
zF|xaS;$?cvI#K&vKc+g#p#)2j!qE>y3MI7RsZC+D9lVamFc=4J;Z`n6zuq7ZC_lc;
z;?-5~I#%&|;d{aB8~#|lzQ0-Unr=#vx02$X@-%ir5HIBTZRT&d2ZrZ>M3Sa!wt~gP
zY902|=~wHZ_t0rNnHXxtkQo15EgbR?+hRbGP6FtL|M5ne$r5yR3R)f)Zw6kDOsE?d
zr$tvbAQk5xaI&c7dr2uO){~6}!u6>~Xt55Vs9IE8kGAnFoz;B^f}@)~J)3017g=S?
z3(h#hpTx`eE_icL!mMW}_m&$y+7H7UGtXVbSm5Cg6sq
zm+_UHb-n{W_Sh$2lW;B|g1TB~GQq2OV<7lbbf#VV1n1v5J;(o?<@$$OGNR`N;(#n9d+JD~gm9h70X^XnagG~j^c
zhWCYFvGHMZ8I`x$4i(#mwJtRV^`!vB_`&2n7G?E!8Lu0$3(J3LEA20f&Ep|zysqr$
zZteJGh4cfW4M#`oUIxjsoQF6SkA+7f7YM8u!okgRKE94|uA`8l7VWn+!!uFAiIt1A
zRMlO1AO(p95Fla9O+vX4Da|lw-nDtoc&X(yx0YvYEr#YtR*~jQD$15*mGp_kLsx%G
z>dk%m0HPWX4U^aTcq)}A%$J}OWwQvlMv|JJXjXrXD|742soWF|I$Ht?x)WRYh546j
z4PUcp3^b@*b+P3ug31R84BhLO3tt!W$MW@lfg*IW$qxQ)u5dMxm%H7r!fXZWZk*w3
zkn{s^r3K(Rsz#K7i(K06QuG?_Z?wqS2eByFn#*o>sHE&Djps
zC$f0%w=l5fAd(CE^#C~C3H`!~6LSG&#T)&7dSq=4RHke?Y|Ru@I~|xps(6|R&)i33
zvZAbxvET`1K_SXlDVuI(1VY5^!FAv!x$345YPdYl87YN5+4)3e2bo8Y^wk?LeB0pHDYF?sCKjhuoUa~
z0YD3Xtf0@7=0X>H0Q6D-8VSI`0Kj?n@2PS&9dbtXapi1!MmzooIHc0Y!C*&>!IshR
z$yU;64AER^1Mt>O7l1nFg%eI3LZ0lY-G%7o|@uje9;5;LqPEkKbq~xV-(Gq(4
znO_S#7x2fj^GkH#$T?Yal7%NSB_68RT+WzVWbvh4L8+LEw}J+deLMuxosYGB6oB#8
zAlnm}ghuM;SWFGoQgT3iwS3C@VmA2`uV{_ubt@)zv~P5nxGh<3*U@a5fNqdtpQf*#PcpWNk9X4
z2paeB^kLC&v<>%tx_!sDv8dLiW77Vf$pQ=d`$7QEioS=+`Qu)cJj^vlqV>brlh>*2
zMX{HKc7bPUS}_`tZ=R8PL;)6`L2|e;9eK=helUaDX3x(;KHmmOgGi15uEark2Pa&i
zE{}NK`5o)~@5DSHSM4*0vdvS5fP6_XX8T%ny->4*v=CXioH`s2H7yfmbh4vj
zxzU)=sa`h?fC*|-4Ij;wsojz=9h=!L{lr76D>5A1;W^;>F
zT0rAdSqecFE7^RK?V2&Dq0`4*xqp<1RjE-W4p?2u
zCj-Ct8KsTqP5Vhs&_hooo#W(Xs|#GME4gy6P)Mq$Krf}U>GVe*#YGH;3v4zN`Swu
z6r2GEMu~8~J(~tKO*0y#fH3bO0Aegome0g=FpzFajMZ`|n{LgqC6<3Q@B=o>pG7
zYtwEE%_N*{>SVA24q`WX@Cr8gq$sSh71s|f1RH9hX)|EkrlX=-jABGnFp9y}HSc{e
zwlCWIzc4nbxs(p_X{b_1(h2QpYOSOlK8}(m%eG_;eD6}q%-okxLJ5%QB6;O_`&2^7<)Xvl}D*FenNDn`YSq
zMy%-7xtO{ZwtNhJfxp=DE&nEP%Uv1xHj>|@`fqpo&A8g~x)85qYYg*fvGDZa(H}6E
z2yvO#gFvCGrOvY#NmbH_(ZBxXzslxWTj}Gh#WXM!C3Q6wyCE6k_q!y`&}$n>1pYfw
z^K|Gn?M$nz75z@A$N5FfQ2kk0IL5b0F3941z?Z@@Z%W@FB*N+c6xYztsFzI15v$y
zh<~XNP`LzYC>({rjPhzZLJ)ANYGF`$c%3z<;He?^D_7a!k(*Qk3z&X*#2}pZPZe(z
zy2GPD?8+M*oy+Y+XcJZe?q{lsU(Cv=>_%JNv6bt@c1<&47~}b^`C`bea)UN=caRZ7
zp?o|AA9d5Hw4ZQp*xnsRWM4_a
zO7(7W;YUOOZdHI=?KoommeR8OzFHwcHmqVsy&aAtMw0l*{3z^(^{FkD>85SKafI7b
z!K3#$1ezory)AeVTu(m5HUNXnVORSxH
z4N8*Yy%8M@7bQYC3UIkyAZ$Xy`6ue<@655b8PT
z>&u+AXz2<%rA|~vz||unwvI2zKcJc@!CJJYZ2SG_7Q_&F)=oslzoISze~%DB2*lqT
zJX1Dt3-pssB{u{sIUbA6o4Wb19B1;a{TC6D{d7%IZInKDapU}@3IdN;dJ5aPBI2FaF*FzoTMkzvu#I8VqO0kTvL(}hH|8e&LkEAUBM(nyIo
zVrOZd_zljofMl<0q;Y;>AA;x*4n%JH3l6CL=nG(2gxY9K!e0zl7J^tNd*Q%9NcRHR
z`G21vcK)S3m?@t3m&MW}T)`jfCib|9_A2xb%}F%M|B4jMm}xF&!nmZX^fu|~`XZ%p
zkZZI<40vzxyf3~GB7lIoKmcPTK!>`=!{d~9JkQxWv+wb=)yW7UM`rrxR)0I=d&qr;
z%d}}meQeyDzQPEA1Xt3FWai@_k^<&MG-Fxyh(0O)Vyv)Gy%A{RrO?LduxnE=jGO3R
zVyDr;DeOde>@Dh>PPAJ##gnA!mYn1a{gELao~V6Kqm%-^Wh8)EE{MbB$mQkSa2AUCJ4hE
z44VlLHNl*P-u;j7itLo}$I8wJ($|G00A3#>0w((S2_{yAL`F@T!yZZUeX&nM
zSfHvkU5;O+$TBfMDfX#pvLE;a6kzNV1rVb^s1s9`^;xA@qZpoIB;XiROD@L9jbpjB
z6y-$@r>Iu2I&>=-^zxH8yx?;#Iga%DX7>(?ejFV$u!+oZ$gpfk5zBhXCqx=#5#NQ?
zc9lRZL#f$>5(HgQ8s!neG>s}eCZY+c7Vs3Ve#jQ3@nh03Z-h($qmmbPJH}oZrJ!1={g@9?+^?n+u98
zK%<@ZdlJwl>-YHAg_x+xu@Wl6d1`+Vj|10`xE@J8#+ng`pF@=9tKgC$JD4Jq5Z>S-
zkEU#xG(Eh}g}yRQ${4nD2p8Sv+|3vgPdwEkU80mrUyrYK#w-*(Jq(?fOJr|r_s1QL!W@#
z15#}UL|VE7?nVIww~-u;7in>&aa;1WMV=bqcU$T`FGsS!X|ivs*^|8-$xa#LY7L&o
z<9a!Wnq~BIHbJG7t-x9hH+Bg#<$AwMU;u2D>UJGq0D9qqfcJ|7WT~yrUq`p^{l;LH
zMXZC~Z(1Mgoz2C^TJ}jmi+skDPLVa9e9i{}RN)eZ1@<|UkM-r5Fd!-?FnR+)Lsn5}
zi@{i=`dGJ1m?+EoSfPbtskY{iwNy`|kAPk`dC}R
zsMVzPv6gkG(X25?F*>dB=4DLz(0%(l*%{{KD}9Ikctv0nUhS{LV^BaMsm
z{<)Md@v%-jD%Hn&>n)L;?H2fCXY44Eoqi@ec-nN9@VANlZM`t)V_kG|S^$Py08UZ>
zV5dVL9ccmZe5{B9Fp)o2cz=-QLXVs5X!I-vz##xvSOAQg{LlJWo4-q{gDf5SSW{0C
z_WY-PtOcj9pO5wVP+`04V-+XJYx-DE^C>=HjwG0P;Yu1r?0?WgWcWEuiHEM&T+S6^
z{@>(dUBa$Ap7-S7DQVd8>c^+&ceU#qbk(}a)2@nGDINZcyvDV`Be_EHBe
z#n*b(lswRsyx)8tpr09sYTVSiSmV+;ew}u|-kjQ@`?ZT{{hohFkcrVG
zcuErSYQmu4WeG^dyBEAkO_9mr*(X8?aE5xfmLn_*JgbYe8LO3Gf;w0U))zoDyTA8_
zTgjEC62=GUs&UP-^{X&&%j~L!(3H`qJ+-e76VqoswbNf0d-oUq*v@X_Q^nrR)||pmbe*tw
z7icc$rgM`#wbm@xQ@h}dOrF|=MQJ^?8)3u2eDTy~pq@-tB*jzP2`yQR^Z$El>*J|)
zFHY+y^*+vcYW+^5e2J$v;}Gj8dC{<4=8EiG!XGO;^(Tw$TyL^NtqznFRD$PY&klNO
z^M<7b;K5@J0FP4=H5#^$3xMaTO|BCFzT=Mt;3x$k%L8Cmu?U!WYHyD+0Q|3eYG>CI
zX^^EOPi@t3q0WEWQ!6-O{XDgSgM*&h6WFAyp4!H*3G;jM$1?vI8pK#=BP~RUt7ZQZ
z4}B=baOTLL|Er!_U`4QA8V^(F;PQ}I@e-^BgD#=JBmB;!*QBRt>_dDp;zndFo_F}3
z_D!z{j^~Z=Qsl<&c-}ZKr49?dq;RMYdRo?cBBBnO5-}-7Zps*wQq@Ojg43O+NdJu1
z=a*0Q9;bPa4|@Fb1RFMrs3d<2g&-8H}bQ7?76eH@+heO=C0<+XUnPrd#$>W`y8
zt@u%hnTt4tw$l_-xGUDcp>V$b^wFPz_%V3$38h*P^U#!uCgtC5iepmRY)Ybh1{&jk
zEHb}*7=kgIX=ygc`nHYy+Sbg4d3Kdb$ky`ZPKasA;pXI9$Tl|`TiSfd5mV3C+Xs>@
zl4F3RFSq5*zI)h%)1~f+AxZstznb&ZCAp7Dem0N{pr4!P_RH^xYPhR5D4Amr&k9W5
z=p7=(e-NRYs3Q2<9`?Bou)PK?BBgfw#2kxYUQ0pUPo
z-rI?50EvF<@W0~1qi-X2geDY181T>IgHkj
zEXQTyWL0w)O!u0L#hZWT6vp-6lVQ!@;5jf;Vf?XonFr5v1|o1vLOv#D+!SkBXzFco
zZ!3RUYk8xbqJ{av8Z4$RzNI=`ojga#yFYLwnh6_o-s9K-6tpayDJPfhT4h7VC;JTc!EDPC>2s8L2;~@+YDPAz>jfyE{;J+C5G!!A)`;QO
zdt{7J83Pk8$KVD)8RZr+MkWI&y#PwI>I|YVn}55MBHUw%MOO^W2y|}MRTR~hKXgOARuZTuD2Mefc-1S0lX%Bz{6mY_
z0~qE_l+M)@D;rF&N7lsOwv7NZ3NTanak8v?q}Zzm`#GwviTNn&32xM)VtwK@?BM5D
zolM$A;__=4zZ3gz)9~AXxA`Abx*(adb1G+fsgbyaR+Rt7KLL&?>_}YflvE}0wW@3{+7Li~9S$Kub6%50B!T(**-)uhR4HDJ
z0@AhY-fInlqd8SqVE1mz8G5WG08Tjbb|6-bF!^*z+-tM98_Mo3;S?RiUtR|!xyPr^
z-ExHH-kQ0SoSS#}t-V#qw%cD}7?ocT*p*wz$=qn^Vk}^)=N3mC)6u7-7ycewvLpVU
zQ?d>IhD&ns_o$L?_rIHoPQs}4Fn*S*_!e+%oOtXDV51^
zX3Cks7+qs^4ONX#W_;CLrdf|IqjB`h<#}+
zw6zurmu~O2G~NKkF4k6LQ8|*{EX(=q?9pmz#v0F
zSeC>1%6&e_ME|MsCanVN4Xy8m&(-o-?zLn*e7tg
zospcX7ST!o=lXc7iy*f=cp;~fJ&`~jSEr8qDRmL&sW2T;+)q=sJmAzVA8eeupN^#5
zGV&6-Qby;fr+7tC?MJLJ-u)&J3Qpa#{IO15jfivTXp_Jd#8_cCj0~4{2>PnPS
z%hFmS-mt%AP_Qa2f|L-5_{$)!0RvmEWR@_?z;J>KL$b9wWBY)$$%VB+gu4_X0kLq0
zBuJ9JW{d6G$?byOD$1Fr_}lqXT;@Pd;>f;$#tqFipt%ML&@PBx_~yl`!!7ti6=iTo
z+@_q$eXRzC#!yjF>N6eClkMumwF7=sish+n@n5Wdlx(H~2$+@rj0u
z0`Fz$ZH|tNKAhuL%2&}OkjOO;!Z&VW`hO*HP6X)>#QZd%?;>J
zm=(mKXdn;80wrxs<0+I>$dmBSsf<#W1DPKeQs+t{c21+h;P;Q^JF0g(5#Do%cb9tZ
zCne&Uc{pE?1B?`*gbRpro}l2hj9P5&2vtWAFvjsd!WQj;Bx>?tXb4LlznAqUT_Q%o(v|3*ylb?2>AHX+?D`=^EM
z+5rZ#szQOR2~Bl#Awy*OJcVpKh3p7FWW5x!Pj*v8&|VEX4M5Vwwx=H@vgH$l#yu6P
z>RhXqzK^e%k7f9%!BHXT)rZM6Y9#t8>#PB^im8o{E@m;Ap}@8cUU{<%okeAb_?AmG
zsDd6Q;q0>y>UN1GUMo^RLlsy)2|GfrFLnN;C48{uSiy1QaW}asww9leqWudN{)wvS
z>Mz?vN#|$z^JE_pYoj}~wIiW9wa}ay+|isApa3@0p&>F>!XRL8wXic}ab%pPO%SDz
z15X&Q31?sqheY%;XJlclZc=+8RR==FGf*d*1HSJ#gAWj*PWMI>Qb*a|?)YbdVv8Ia
zd^HQ_Q7@ET%+0CTJx(x@g9Mq6mG!=_hjr7ho|3~`n_6Mkf49yr%;ii5(hB96Ah(<2Hg2SfE9*uu
z14hntY}gAFy0So2?4?1pdGWly4~v=Dk3ZH-Oc+FzLdR-OV!jbm;-UVU%gG;_#yb$8
zaqBbc%`{_P5BxKI>xtzanZAv}$`{|a0th(u5{gK?Ni3Wri9W3cnaBldLB5v>r`C&V
z`))S95efES3DM`N>@)RXi37#*FiNelW8Xd9LgSJm!-WXcrmH?j`Y0UY@9wG+4AAUn
z&83d%pX^rv-4Ct$U>*aQQ|3P;K8YK5SWH9}2D*5n(bT6^oTvDbE|w%t4`4Hl6#j_x
zsncdrFyZhB?;3my1m|0YO|T?{OJA`ZEMxj%5$Hi
z+M#m}fdv2Dy_b6-ArqZPi#q=fc}`#gM8rF-JpW+7t{a_)?2AfM9Z8=c4OpN`JG
znHrSmFIc}!D+cVwfy~(+oj>fKOy^vfu~u(vDch9ruJJjoF2gBc7)r|4N}GF?!8yqk
zOP7g`QB1#7y926)du>-=CDGoRY1^mLuZPvZHm^bRO7}D``K~orNLwtut<-C2Uj#ud
zmFdsf=R|;bt$1E^iDH5ZehUjRG0~N0VDXGECiI6LK}HC*?lYT#-v)dWFXUDXh48%|
z-y4zMgmmVkCC2;w*WeUoIe&qVp}uVsE&6Fv1`4%NO^w@zqK$S&^yh`X)>9LLoeAua
zGsPEKU5EHybxi=@v!%>B;Cp??_+CcQ4B-1Wq`)+Y
zo#y;sBYmd8{9hzGVW4;p@&5Q38pT8t4;@VQy1jc#u0RYC^L-5#nw$PyfWQyESJM=6ZzXUga_r*fH&qahozxPc*Kd5-IiJ*pdL
zvL(d%15PIAzU}}bm~bKuq`p$##wz6@q{C4v%>cO9uvnE4QEt(d+m?VjDWsviB5dRI
zD(R|~?4?QG3X0LEU886Xw5FYR&nIr!V`oX*$c3ZIJdgX{P0XnWhIM5-N;|t
zj1bj9h#DwFG#(&-Aq2qeQI(lfkb@*)^gt}WU$U-3HO;33gq#<{Ge%mdH$lcKvixR?|7mIN(;=7T#
zpKm04J~cA`F4lQuL@KpN5X&^!O@f#-m!VPsM7i+O{Tw8N?m1P9RYVNoaGxONwkh31
zkwL+QMpb=+BiA5nZzHTQr+_8!vb}VM6g+o}Tg~W1VGk{r^Wun}72jl!j*jSQn(he#
zyZgR#D!<_DS1h!+hsae??P?XQJtk73xEo|3pW*|W@Aiq3u%Lltc-u#wWEOaInRTd-E?xE^jA>hURg|m{dbnd)
zuEMF`%Ftp{@dNXA5Y$PFBl#2`@UOdkwD@>Wp~anAh_r|>B_7&NDdwCxz^a?eik9;z
zwY-Fr;s6E1XgPZxOyYBR7&NbJYY}SpgYq@I0ivIw#Pd?(+B7AeX9?)uXc%A8OlpJ5
zj~+B{>@K4d;Tcv!kVF~0tImwsFK^i)Rn^~zKsLX~n13wvXs#hpKPAxW38V)JbSNnk
zAMmOqm^Cvm^%Vk*)j}lD9!$ZeMn^0W57LF!Tpm9?t^@a59sa(x0{0dx)x%ySN0Kb$7wDn
zzCUg*M^lzNXwE&PkKz-x%?;M(mW;R58LrJumIOncNvu2;I>~EpGi|QGG`F)fN6GL>
zOTA?#=#^bRXkO0!mU)C=QwzZmh2S(7f^Yd0AF!hzg6$N7cefNO5#gKI3&lfqn#;Lw
zKjjbH%Y2nlZC>TJ@7&0_b0c$`tO+&Ck1A$!!9mjcw!di`MYV@3U~})Zq`6)JtB?dk
znsR~>3k~uB`|b|{*hvPkjaMK@r&AMIfXI
zEV-Q+83aDsT@biK3lV{%m=X^)Dw@t2{o7ZVk+!*$wYevxcAAqNSwnol#s20l)aG{c
znrrMW&3&)AoNxCr=0xOEl}0@sF|leegB<$+cU8grEUG<4A?WKuaGpZYQsYC|VSBOA
zR4qh=PgV#HG6??_5ExFlLQ*l0kyP9FCu?l61weYlc;0krk0jVZ0l3f)zy%6Gfd|0*
zy9o)tGbH$CZwmkn-J=ybCpingepGZg4=x5SwK)?p$g5(S_dj{=W8x!IDqrFAMg1ldUxm}ZCt8l
ziEkmF;oQmEzwEg#a2njaxq$8IM>IBA)QSD3sCvt$HRkpmZ}?G&b$dGWsM?oT!&}cE
z>kUM3-EqpP*qVdZd@;*`E&ECY$<1;gv!urF2M{Pgb0(m1`Ur$}+`EBBbyK-yY6Fbw
zeggu@qq@OZ1-0&@y0cIUOkAf?-A!z1okw+7pw#ak)$OO1q>Sonj`oe}W{alLK;Tj|E*EoL1@d`h2-(Ue`ZwoCd6c&M|IP%VkzUOZq>fN(aX?Yv});G
zU8Z(+RJV3x)32FP-SIb5qS&pR!zbL5DG8<{&!zQ`h2GLa6tQb}5)m7qxtu$(OKL-m
z>L!KPWmLDczmG0^?P}S73FMs>Y$-k}Q17(T@Ze1$cOu08r<2O-dX
zT8IQXo+wfH~OgaCM%DHuJxMRUzMEr{BD}3aaHJoCBNT!)S;ABz{Oopu@Hd*vnU5_%YBGQCsBWUR
z;g0HBsz?a}_5|CC4|qxvjAlJfFk+!|J;3r6uxkxqe{=!UQQcptc;b-$A05>_*T${;
z7$cZbUC70V8;j5I8}d_n`tW
z*|d)$u!$dmjTC`bwGa`wY+FH~i$UPVUhON)4YoNms(Zh}O2v_ECqCeANib3|o|R+&
zm)BeuZEiaS%GnmpN!Qo;QC*gWz>MlnbRoD^A;|MX&_f~k$8SOocNT#H>NlZ6=LCV!8`bG5I833I
z)?pg87SmrdhGA1<^1K{ZUSfu|c_5XLiw$+s>q7gC>W|6CC!L*@&qz9b6HbhV8@X5O
zOiZQewC!MKM0w7A$Shggd-hX4&y9=oIAdm&xuxeMmR>ps>*{K=aw^}@@k|qEfjA{l
z`GP-zlR=z_gQVpWGzO^==&TxVGMNdUrk1~?WExwdNf^;H_##DhU@vW%h-Dc!NC3SN
z3^t$@7O;S5B#>Pd)Cp{QVV2HfQ=0~xAvqQs(6JNs4fzxS7(<H!C>SGOi2}6Y03rvpSb^Ua_-z$L
zkdknE0BxH)u$IPez_6uUm-|e4585c?nPJuw{{(}{OK_FU6?I+kjBNzrIxY`FXHySF
z1}lUZM{LY9{&ST)BPfQTrTNty3%F@i)+BY&ubP=Fjr*aAMUI_Q;*tUK)p!(mZscse
zm^!&|i=RPtSqR%lx`
z;?cX76q`pk-n|dcPAf_>6zU9SF_WhIyCtrE!q=gmW@qNYTLY2ur&9`h(nnPT5{vo4j1aE9~pt
zl5_VLv@~}(DK}RWqGfl-&*Z9NoT`^M+E3~9QYf+ZpXv1yhp{(Avg>FhI<25Rv#BPT
z6!h`VE9l@&pmYarK@EJ}d3sa+rYPvP$U_A^4B4D+eDV9K{X46lb>!3r(NC$VWBok;
z4?g`I#+MYi9}?=Me%>Tv)>-{LH7R$peqIWiO^1F?fi0TIm553D31c%+-Au7Z-BiY>
zAZdm%QLET{$8nQEeE19q0xFaKWN+k5LGlz>bI%TTpxw80R=e4YI(shsJ=*>D8p=|x
z2(n(`P@B~2ju5Tl@N`3J_tREagT3w!vRnvCm8#vcdsy`?-+-%NyS;9~KhkUWI`q1S
z{kEzdrCx_#cXSsh>e(>qRO*j5;%|ylAC5d!>I;$08NiqI>vcb;Y;F*(mYO=&>fLwq
zY4sL-NfG$bu#Ul1=4rSioBfc@`E4y*_K%x7-5ai?0pB2cBQ-
zujtsZliq4PDR**jIAUGB)f-_befn+3oT3e_5!r>Z!gM5fm0=v;sVscwFW+g&`JRsx
zF5IoDT3M^A7INVp&UskV?%TtX?>amjd+2RvtO}tl*6g504ngo~WLM|Yo?x@**70L*
zjpsiFtON?xQnX%S85zpT>j!+rWuS7r0M1=S-_WU+Ed4WuB>HKd`b;4S>HRn1AwOP7VpTKiWlJJjwjZrU
z=pz!Tm}T$CR2knc{Q0P@BLM2GO0C*CNne8WUW-_(quo$
z);>+P)I9Ce|fPz;~A>u4Kvp&+N2meZ%j%)mhfiywEi$5(S9ij{d;e&|5TS6I?_;;jfR|4E<
zlIUl`*#h#LWS97bWKB3xoC1+z4DgYLAe`a>#U@r4$#S`K0d{mr2Z#Lh-reH1#CqsWT`3CowTr)a^+wK
zSOHQKDLMBYFBlwvdlS{zOmN3w3|3?&oPp&C
z+WdE=Lf5{{TaF2~4s8Bp&6Cl-Nfe{U(13lrkY%EBl*gRrH8u>bP9R_k82)qZ_$q^u
z>(mU)wNyGY1G5)#G|wONcD|(9m_PqJ;3tRyr5Q-=VN!RZ=2YI`v!A_%%I$X#S(+y!
z`J~Hy@9+Tm7RqT<;C#@4c2%+P2k@scXTX3?ma-~7k4W1zpzDX3BjaPR!Vxu=2jxE*M{6
zS2bPH!QuL`pSB#t?;kB^jXbtzc!QRa$kDA%TbuJodQTYpJWMNtu@ABzBMz0NJloHQ
z?LzGc$alj3-IYwt?Ej*={-{pS(bCH_QyQXZ8&;#de{Q;#h?Eo
z2NT!`zgrXXpd4m!*Y09f75Ul%#e;Y56N
zUb;{`L?-Bm`DIr6#NIDb-&WTDtU1gz(
z!H{7`o#s9v7l-uf<7UB`cM(Y#bZK~?G^__=Q<#p@Iuv>AK8owp(ZC&h&7;LLK!aKU
zKLfzyUFukgdjxo`mJ3LiATKhUYu3I^d0u@_
z*QPv(_upqz{?vg@*^T!n`1`&q*<=Sc<)pNELe7&dRP2Pa_y^dO2l%p1Hl;5Qmv5)<
z``4GOF~z2IrA^rvP12@3#{N+LYA3YOm)zt@r0|PtMvN$7eyn{RU!ufSN-}
zh6BmS)K~e}g|#mU`{-cFm4sdJzV4n6Hid(tnLVG^a0yC)`^U1G4!FN(+B_lW>1L8X
z;e3G3#F@&Mb>jXN9e6%VzhI3i+&}yqaDRXHU*P@|>~)m;Bit@+y?T^C5E_kNgQ1yw
z5D+-a`FuvFB`Ifx9>-+8jsDhuvXV51Yu^5QJqU@TuG>yPBKhn-MpA6-n4?0qbE5&G
zrwh5RzXaZAF_?hge@GTq?t1&yN7H+%;SEO6PtY^GG@`#*k-iv-u87QS#oa!5s*m(t
z5gF8QdA@NRTm3%!*J!|6Ml-XcXq^0v@B&P;p67715nkahJnAF3p1!D)3@t53JbY3y
zuYu@iz{b9OgUmWOcar3~MY8+{W%e;NU=_~FtoYv3pAagwtF7~p6NOXtGnNZ_LAeXL
zZZ&Yu84~e93HXHUx@Nu+nm=lafmI_YMaU>A$p(S+NUIg^QEoh~_>QlBtq7f{TJiSM
zB(3<$6}X^Q^k?+T(~8ngXvOgzXoZBUdh@g%Pb+qkGSojALD!m<5|IBupzqyfQ6uV@|;0iC{v8mI#7Syhp5F+|7mm>
z_PLSPDvA0(LrjCR?=1}tM&%NP7-yq0>Wn!6%1pj$-}~{SbRmMBi+!{45OgyI;xW)4
zkSGzxQQm4>YxbUnuWxnU$i#X;B{pX0hJ$Jcfr==-CRH~-;`vPL4W;#;Jj$&jt*WFe
zQ0Z8ID6CzU{xlbeK~CDW%e7c_ZH&5h!k;{xLXGvt=~;ODMkwu|2?FEPaHdsON7J6?
zLlRfO{^v*fO29%qN6u2>BNDOCNY9YQ*PLe-X}WPb(Pv=S4_8&g+l+6)^=YU{dIE#;p;BKkjC%{yo)g;Y4
zV~HgK`=OE6JB#9kt|!p~4EG57&iF0t(@g^4rQ?pbY!PR9q7o^mj9rR9MAEwYC#$ux#j(J
z(UJZio80Z{NH^p%I$}L1RTB0Osbl-60ig9bY?mX01Kc7a9wIJA29@2;z*RV4#T9m3
zHUlmFT~Uo)(SSEj@}TY9NN4MBg)9If%}9qPC~2f)v1G^kwyfshwj&nL7o1{+>)o-=
z{bi#_?Gumdf9QPYX6R$*t`6p#7ui7FZL$6rO55Ge;>x$w?)KZouFv^D(ck_EiCzy|
z!u3KO*^)&IJFq3$U;GDc$#(79k_+En7h7@*0i|7P*OrV%u8g*%bK3cLHF4>+6RDZB
zQ#6tu0`jyU>DaER9sN(+LVq|7@JUMHjKC>0^Xs0kiiHPF?s22=rEv_}_U_kR`1SIT
zbISV&_wVeNp=e)g&V*_hCdmfRtgB}K}
zqK*Gg^v@?F{JtLj^Mx$dfv>;sn;rDe&woZy`45eU%W!TnM5h*GR{TpI4>xkxp?-zA
zV9&;kFeGWm!-sxua<|(*=Ob5*Hy);Vq%|*B5i-vvTqv(eHsM@>zC%m3cd)8m(p7bX
zTU7@=p>Y46vxH#7kilU
z<-=fH()urZQIK?_$gbf#E-*6DL7%Sx+m3Y)s6(#}1^;*yMu5EA;8ku6l^Y59#{MAA
zZb5q2eVO9FF0-AM7T|bxUrVp>w04h?PvX^UsYO2eTS_p+-%_VBT!@msc4te~oPCh4
zj#p26?eZ;%;ag1cx7!Ye=OC}Ir4ywxx22(Y^;)WskA4i#Vv4_|j5<&ftoVF+P11os
zGtpf;ld-D4!K$`TR~4_^_NwYM-DjYfj~Y{hE!}}vj~aXn()}r>_^Htj-H$|GUrPr`
zWiH+O;MHsC0{Q5t`w>j>w-m(C?VpYE?J!xc7PPY>R6P?TPnj2i_o^#qp|ui7+!jrl
zzL#Nsv!J5W#Y4g3>(cTn1Z{su%U=eIyDhiFl%*)*V@d;~#-6&*#jD2@z6II8geiWe
zw9`^4^7>lBP7QxcJk8H*33o^&wKSF~{+3eMUmz*&Y*z|bFF_5zgSKaS#XFXub;>+*
zU25*-30KEpT;*jp^HrS|;*Www*Hs7D4;W&14CXpz-Wh$FTXXVgj8hIcVu%Zy&<9tP
z;R2Kg>dZ;^yGr-#j_+_rjf|T_<9C?1stwoiu>fzHqU^YxXM~+6t%_R|pRya)3x@rY
zDr%K+{3`U*+AqjC_~`I3L-CGt<6Ho>vjVlP02Ck5ieLTyq4NxAEcJ2Y0PEnWd%Zzx
zk34JYGLwf^U7+}Hlji~g)ed={qQxNJGLokwi-9wbJyGi@GY#o_$wYgEuXrsp;Wzs~
zMfmULv`_d;J0QHTPu2NQbg{W+eS>SmWkAd^i~nP4_+@<+eox|%LE+!FOE3Q05C;q^2nvElWx;)Rh|X+x1tM`Psic0V3Lnz!HG
zJY1GGG8b?6O|)+{(;2df=RNMF)M`qDmr}GrxQWQq1GC-earx_>1?r+I#%fdmIK40N{M^!m74d7V`WHhFZt?p>rPAgND(C6xCueJ802;(Oy_66(8^+
zf9%P-S3~|HvC#e|J1TL&d_W|lovgQhX=^!4{V;%NDR2Q67`32lqtEOk)mL{Sx0h^b
zn#W4qWVCSYKHP)~mL;4?fY>*TcSoJ^yi+F#D**->`}$q>%`$e8mtq*Z%1befbs`~4
zzRFifzLgbaD?Rd+oaIcKWk@#-MqK*pSZI%jEa_T{Y73Nfcj44}knTSISkfIPgbKAj
zsM&$dQ?Cl?T8Y`43E?0>uvF6>R3NM?TeI%4c`U7(Z7I}n3ND#PC^~Ze_e8LH3C^R%
zGv&IuL7$0c^BZ`U(S@De6H}FNo@5?8&#_Cij{}NQ9gDRrH1)Qy0an`bvZ=-GV50Ta
z#mlP!a7EdQq^q_zQlyJ&_Z0f%joXui;c4Ghe2NdKlmv6UbDq#8^v`K7r7B(lrQ)HH
zn#-9uUkCx$rbZ|sL3>#pF(0mhoI>$`%9803@6#
zlYaHjP~`e7e42J0wCkG(NY0%E%gz(p&7Fi(tA}k;J=M^l%&jKj`79^J)I(dS>rn*H
z+Is_d3OA#rD`kQtI=l%Qa8c=DU}@9FrL;UwEUT*Ssvgem&#h`pWZ~?eEQ#l~>}9{@
zOrSg0T3ti4CFZv!*Eu(sJLqpjOP9&?QgnC&%vDM0{;bN=gW~~gv`&>R+!{sg!yAwT
z_CQ?VTPFY3h8D6jv``4X)uVf;LlIPxaHh}3(ctbf@q}~UtMX3IxjyHG@>W2N>zJy;
zAKL<@bv$XkuA(WM>&1v%eRU19m6v^-RkEWgM{H4!;PE@nH*ROrI{6}3JeBOi6i+q*
zkVx&1;A8W7>K6%+5BL2ASF@D%Alx;PeQ|+cUExIe2()oFCDh9O_@a-zoepU
zNx;Ux_>8gfb6yr3zXJW;5tFTrUr|&$O>O*hyNl(j<&U-Tr@u&x9_nebL)_j%XNv|!
z)jpdmW=lwU>QiYOKiD>2q>W?T6qq-IOMv$9MN+r%>pQ}V`1j%cWgs%-IK>Owk#A10x+42Ah
zOP)3){QFBnLSm8S$6}UZaY=6>VJUws3G)?;MfbVJ|3-AWXj8D5Tqh)iGi5y}fRb<)
zL5YJp+E`sfZ%Qz3#(H}~O$3Z>MJds|>UqBa0jHwO!74_vWX*ptnLz;70O{^)=)rN7
z=vXO+wb;8ZMo0qHKR|a=?*Ma8u@@Ns*glNUctlQuaTz#gV02wM_#!z^86s~}D@3N8
zPMTyz1#&7=K=JO~b`v7!^2ZYS`I#hX=pvIH6x>x(R89xICPWsfuYe=uQML}^P<1jE
zvo=2kcfm@M-S4PUqeKHWL9MLj#U3?Poa~2J%m?F4bJ6Mb^F+Kf_WvC?ZA7c&TBp~O
zM7E-Jb3X;TOCo^pNwt$x1VZ=RYbgL_X;Crj+Dj;~C4Vdho_$^@aG}YLN_LSH6|;lp
z7-ebh>A~-@pXYA-v;kd_NCBHmCk2lf)~e8ED`8$Si5c++6Vj;Gc25|t7f?@RCu!*6
zdo0f2`Y(!e&s_!Q?fGMIo{c^dTpwq$1LuB{qFg^>wyKur1pob|6y6_0-iJNjdvQ|`
z0f#ROT_zd_O9W^jOoWC{<@Mhfmq@%6>bKO{3VKr={@&;pF0;xS82%nC4n|Dv=Jm2_
zv{4?3PPh_Kr0k3`JF~-6pqtfj63TV?uQ&-;Jxx1xUq#t{0XwzuF+M2G#cE9b{
zw(9UC+}1KlJL)YIz=X5yGl==4WZ-P+a@bJUPs$bVQ@nGs7Y+P{=YG;C%9eeMjJ{k;
zS1`r1H=m!@&vurv!1ZRM5;KHH%XNwJyuvt%uYa|c_ZrIVpSy2w8#F8OYgT%@Eq12H
zbH7VdW7h{)uYZld{=C*_g*pSnW2@5B2_zjcZ?&bkjYt^kB(gB2&K_h%A`4MfJ~@dj
z41%(3_y>cjXxW-rcn#{g^rc@+JS_1)lpgk4xWY4gNa|+N(WFaVGMh*wrLg!%>3yipPATl66
z5nh9^c2>zI6=iES##!^*VNb5J13wk7iRMD`UC~qJkjw-?{DeoaDk&2HA3Picpt~*9
z59^zfbO<9M?h}p|uZUqxgvwtMNdP%OOfPOKlII&WfgAwcg(klpXd+3_K;Liz5meDM
zNYa0h7O`nZykaq@*dtD;4-Y8X0AzUCLJ!{VL70$v1pli
zk5}&Iu6ZP}4oYh{`DG{n7oy2QA0kGy
zqE>uGdir$#Eh8x>K1foIr1%ns79M=!$)eQC0j*mh>W77YD>HA7k_ts1q(a8k3Dk;M
z@iIKFP#(RAtv&*2N^6=u;q*qQXmDxG!iWs7Z7o|7Izn*w*}qx$-}DjvNdVv2+twq2
zBc+K~4>^h6y|^(3+)R}#dr82lgX-dpD|M#2=G{`NLwDcA&_Hzf;-R{EN~n2ox+-^$
zl{LhMFD8tL{6d4mtwm8mecD)m#UkFQctx~$c`Up&gTm7YTpCi`Fm^<6D5YPb0bD^^ez;j?g*s|VP@&GkB`(}}&R!Olmv?d$
zFPp=SrL5`oU4LtneS6|)i^A+3L!7&H>yjSMng>|bSx8mgBrU;S!XOU%xUqhuz8F#tP)nyq-cPRKAg+)|do_BHGy{RxHDAJ6FkNWOfxvOM*ijV*0=UzZ
z1A#*^97MGG2>#fCfc8(J0+SsmzmG;hUdhn9xMXK6m%
z#S5nx5+B&x1qQG%HWSM#^|I<^wSQEPLXHkOqWRRTA*
z@Wy1rD|A9k-De<2REk&3mP$%;v^G@O)_hE+T870&VH}vY`g}+bYRA|XPPn(^DFV1b
z8lsJx0dY2UxVm)Hiib(S-(nN^0~O!H|L5x-Nqj)PtT)DWWUH{
z2U5FA3M#?#peG?uGwz{0l}B?uvbAi()9V;4uZ|2BjB{?d6t+k4fJQt1!(3jQj5e-+
zV+wGRv)=rE61{+E@se2a5}3axR0w}S0u|1QwB##e;gv2~ATJ?CvB1^hfSaoG3g_IHysKsY$WW(i<)BYKm&VQ{Me^OX1yn{IR@Sg-#yXXPE3D
z$oY~&0mEH)kN?u+o_^mlokj}Ldq
z6Ye%642Eml3qR&UmeHb`7A4==fXil@h3+gPeXhLAu=YA?6g&P{Xk&wLtawUMZ5I)e
z?mulItZn6wW$lhajnMm*E`4rBQ^0EqSvzeySPNPt`ERGd0IBHHrq`=LM`(AVvkK*B
z!a)2);|Jic-$_xMt~nFVmp`zC9z$6%`%>g}#kw23QIMIncxJpb9|U3&H;Td|9dFm`
z192uC&A$Ol`X)Zgf{=xj&nQV8I=;ecV>xE+m1TvS3(La%u`K%wg)A28
zWwL`!A4-RSO7Q&sBh*F`UONGE?Xj4;JX
zYwt8@gcJ=(aOmb6EE?z#`YRe&brUqM<&Q;UngAU--DC&oxr&B#2z`Kt^8l-#Kxo(}
zjKnYhYyO&QWn2TdPZqh0@7TqXzXD2uORv$jssRmVWanLoZ+aXnmPO3{Y-7BcO12^)
zKZk6{2~e5J2W2qN`QZ)<6P#&{vNa!>5lps@Gc$~!Y$vpX0m$4?^kdUm4F^TE96CgH
ziU9Pesew6zY7tUf`8DWMGqUe6KrB*tBz0cS7G04{ITr&0u_VX
z_nGW~<9JEYKH)D9ac09+B-x6uZ_(Te;UuQZ1>fxQ*;J~m5{w*`0E0#Aa&CBj4f}a=
zJ-MI%ki2!bLL{%}zw9ugW9Z7}Zc!(ZmyEVGQq2g1Pjvvz_HTK$qryrPMn$h0ywlWF6;dsB*=FV{{=_r;A%-Uhx0
zTrLN}G%R4*sN@{}&AIJHC?B4(OS=(5k&wO~Lb
zXsO0aZEC5a(t2WOMWqlBo&SB;-us+0lT1RO&-eY`^E3~`n%QSx)@`r7_S%-jKEj+dpY9GvA}hiofU-=jP6Z&<0rG%D6Wu
z%DAmO^$8#stXhNV(Q0rTqx7;hR_HQx$2G7ykKs{0&W}cOA47KlY4nM
zWyp_jmugn4q(=K5W!O-@(O!ExE@VZ$tFaUTF0V!y`rfF+O=&dF@xQn=i;Ff=Iqug-
zO=>fvpo2FSNOjoF7+1(=|3HM^Xg>?j*skFZ$E47$fw6;ntV@Oc2|wM7Rw#UL8$8+s
zePMrSQ|VZE=yZ2+-Q>%sbyMGgAG3d
zjF=9p!!Nen%SY9MiB*|yhoyc-uT}kv`8ZlDmvW-eZP=s$pF~_I6RlBziasf-)y{E0R1L(N!Q>$JA$
zy{tsur~KJ^5=9N@U5DU(TTH#7tFI!n3WvFq)|B>4)=~3o8$x}!$H8j#2~U$?l@F}u
zhv)Qa+3aH8o>C0ZNy?v&^5FrUqJo`k;SHVUNWt#5UPpAEXT^rL9@X1>g#U2Fi%C#f
zahf8fTI7|Ya!nA8OshQ?s5;_F1jQO}7yO}zu-o40-e
zcVRFx8)d
z*H4!~RWCt-(3_+x{CwxWeX+*cGf)qC(8A-k5&7AHiqCJ%f*K}$Y|fetWN_9RPsUS-HA$mUuT$6$yY!jpy%I;)Uq!1y~H6+@N4W~j;
zpULVCVr2&?_CSRWnMi3(Ga<2|Ic`I}%o4{TH{|7JVnd(cJt3MRh!4Sy!=WhEBeukb
zZg(1L>y!55!)m6Nrr$Czv4WgfT%sh6`^7y0n@np!n76#1f^|
zu3|6HW8l)`tJcv@S!p#jNLEJ6YQ0gXhA#FDZ~v4~whV8Wu+eNmV>#H#y?`>-nS=@Q
zE0ksGJI7Paquy#%d6m7Qe@io_$#pGn@c-66b*;VXT2tyG4-ju>;KZC8Z@5VGDaK;|
zF&z;-x;ENRB2&Ao`+fEachb<|{ok-sc3=K*JP&=oqD}8?h>J=dXMeB8xEA%mCf0hX
zoR)CnAcNpE*<6SQ6V+a5+wmoO)|wMTR^@SaKq}&Jt19xz4kO1&&4Lry3@4B$eE60R
zug`;^RYOE+28yT;ux|L*Q|W>-gq%WV_+vqYvIvzt|Yr^iS@cf?hu1
zUH$&~FTm7UId6WH6W*6|#HTsoqu@v3%v2qBHeptQYd@oZpfyy7NyC!f!d3AOXk^36
zE{3i!?Y@93VBDiS^Uf3R^F>Cjwh+=uZW>V?&5tl#`+Y4^&;Q8A30RIx3H8jahy%-;cjxEKVf
zD(O`RcBUZDguvFcTC6XigHxgSSBI~0G2_0svnTN7S+ZQg9U{BT;S7Wpwk!|qsKSx5
z&>6_I#l3JDU$bz$M3ip}W?gM9T&)rVu(U5%p!uxzdK7As%T+hnJ#(IWZSSlPAGvRn
zKWFa;yoPIotroOUZpKEWqSX>(r_TvdKKFWn0k)Y5jBb-AQOZEUHJ8q-<#1Q71rnH(b
z#d@K3@fJU6Z_7GuL3xO@fM|3}j;~60_P38~-`P=7oT2OA)B)1yw${Q^!AqfJ(eA_kT=2h)l6ak(OB$s$c)whtN&KJWl5!k7)DLkPWq6HP>VDP+
z1cZ&Td@HSXD?CPVUlP}xKCJS@{xTS{^lbiQ2zDwCv%&mfYnVO<(EtNT|HvGFkcC%f
zSjrP*Jl(|&P5g>LfV9~XMG^Pe41C>A884M3G3;^+_dpT?Ni>#i>Wb_pWjb}D^kKaD
zLPrC$SedE4l~+1QeM35`PZuqZTg*~}g4#P#C3bh+a&Rd8bPYXgY|9rAEd%iSXcDiJ
zhmok{jMPdoiNxLeZ&Xlw4~j(O|JsIIj#S@TceVK%
zt=-N{(WumOuWICJHbRCyjV4r;nBbZnNWFpo=Gq@33*r$gOhu6>>x3)MRuG-w^R%^a
z&ek%8#V1Qr^A7}*7*ao<CL|1uHe3km?jD%{9Dd1a--D)55RO@&v>AK>7;(WFTSLgY^k*=l?8e`q1|Aut8
z>WjTqSLrOzC041^A4;rJ+tNEFeRCwRotM+&rGCQhd&%4>;g_d`o2G`}&k4T+#xBQX
zAzXVu9#pU6|BTD2O*CmW>{RyN>vf>VU9}%*f1neOa1-NHTW`Zb{6{jPodyhI5O2L8
z;+s6*#DAEOU4J7s|10TVe-UnyR$9H4u54C8tKECqPN5wWzK^RY&DTvr7P`g*Rxe
z&G{mR1%kAiW8nuzMDY_N(S2?LwzqC#2Y2?ZWV>e+fMSQnAK*SvYgCIeG2?WJw?9$Ufh3`}!v=YYiJz;r$7VcWTEko74iS*$U_{ts3X
zd-NGKO^ur-_v08K2H)NFzZ|blOtv9^W_(?Vr)m0y+vei{MA{2D1kskZ_&EDC$?xnA
zYnNY|mvt7d&|ymq^b6Kb#jN!PqHN%|OPxx9Pmj6My9bi)a(^;JTIU#AJ8X|bo?a@$
zF`RbIos8iwhS~iBsp^PMt1|UG(Lp`V@r)4aa2EO#JHgZLJ(>n&*Vb|rOLO4zO{
z3-tpV-vYfW)o(K#s#jHrX0S814nooGoV%pG;A|srQ`I%ve&~nWwx8_QBYv1oV^6N|
zLInr@>}hxx8vbVI4G%zryVwgoCq9<&m8DJu#Gy6ZgvPLEERN1LbY;j|=-h_p>ecUL
zboyO7W&4??QAXoi`Tkm`Sy5_`DXqqnxZBevNxZQ0Hjhtx0VimtDIQ5n`{G(6LzOV&
zNjq6p8>hzfmqborgT`INeFuV#?QxG2%%l#gi$4l;1!AynB@W+Z3hbUN0IIJ)hmp%-
zH@XB+4l5n7mX1Of!-4&C1Vv>%_!X05s+dZ3-jTE&bFTq#jspjtLlwAIA#J+5htFvm
z+XOMIgFmLM*e=X%$`VKv|rHYR%-?c3jr5L(*OAaWVrgvZn7IMwmEQ$N)C+
z@<$irZhr4^rr)5ZWQJ{N0t)>hB`7zol1M3nvPl`NNW5|@Se3X1;Tuv147{%myqbzH
zA`aO+iMpv%*|8>FbNq01^LN#7wFCw2aB1@4s&(;KXjl(dj$0AB1Vi3r))BFuy%y_!
z2qKR82SMgN1ZLb1!gD~*0V*do&pCYeB*;i6o_9*(HDp-aC^!iv*ON^g1*fz5gi$bV%=0^gP8hL5>^(_Ple0R(
zV`c&#xO|qPWXw?=#v%VwP=Tu}#u_EGvZ*pTwL2HZQybsc?~bcps4=s+czw_7q=|4s
z6UUQ?I7>I-`h%e2t59+(zLC&GJQcH-w5vXWLk}gbyTAQPvEfioV}lHX&Tt!C+Ev9<
zl2&}2eVtRWis?Jm&b`4~ZM+T%+xr0hU0fCzmQck2r5_wCooz^Ce9{I!tXE7RbsPb7v>o@V*k_*j!rcWVDk|7T)Azp5ZX`DEUN~>H
z&Lt@q>kRL>8A5Rxl&OoRSAO8sFe@&D@?0D~PBB6uy+j%M%5|>P0(Hb_dG3?-timk<%XR1{es3VA})2
z=WRYCN$*BO^re1jw?9I9Mdv|m8mh!!JP2{kYR!rfH4#
zZ#WW1eIb?0-gE=5eM2x#d^*#1g7sIZxLA$b7&<*3Jw5x<=t8y~1x@tw<=3!IP;U&85PyO>XT#*$qg@+UHs<=KhnkR=0nP)RANTw)_0
zxsKJF-0ny;@%?+YL;Wu?wt@OnRWAF5C3KN^X0x(cu#X;X9<2((ITMN#Z{BClX3*!@
zz`VK43M9?-2fMG`7h6wyNW%4`9!E^^lj~omHpCM$oLPu^+f8#ddIwe}((Q)}IdF&r
z&0=!P6xKxey)m#`0s5s@%PRZ_)^6CI3L6KX25aUBEr)Y=;|jAB++l@1PYo%%APhV}
z^%xc^8v_S^TQjg{YY^pRCa|~iKzKv=mHG`04GnlV)t@AiOcLu%4k*-lrGi&^*jQbJ}e*r?SDA5oMT>
z?LD~ov%&6>Gj2m@Fq(Q~8~L{3xf?+levXx&JU?=ud_#l^ZUy(1;C
zEi$bc(juZpTH%erGu#AbrZf$KC~M!S%*H5zT2flijs&)8F>e+VajZ=4s`PvUx48T4QU^dN38
zFZOTP8;-&o%%kY^at298p?uU6#yd>aIo}n}`H6_yy1Sf;5|s&Yoj1J<>GmC{D#CZ4
z#vkz>jc1OhG8cHP1|BQDYZSy|9Pz*rCE(GdN5f0d@718^#)&c$aNWy13enYGgx&+A
z?L9{xh}8pmD04hYKgUzIj|_lS{PT2WcT;|tMYj!c4&MbVquKH
zJ)o3O;2)xkVFX@9V2tkz7|qbk5|xvEZYWc5KuqPbCs)Y)6lT<86XEGes4Fgxa>Whq
zOA3s$0psOtjoW7<^{5j9PU!69oZF_YZZO`i;
zOTO?7zq$6uv>=lMr+r=9LA1hovs;^oSEP!s4ge|U&ZZ1VLJf6_d*JCfgqDoPxHi96pCRQYys@6*}$p%3wn1dzPrktGiQI2XbV@Cm4nu3kCe`bpJ3%M(BYA5hb>VW{*6mO#5g4G*y!1r
zei!wy%K_s?`@2#PwcAa*TcvGR`>Ny(NqCzQHX*W?Kqt?`pao@aw2#$k_&RUX0h-y<
z%%eT5gWB9^{}r>(L<{WA`Ujnr@05@E1_
zb;!&U_`S{?jH+>E*m*(L>_~wl8M3rRtn(;yXuCV-lV@iAOyi9xIaL%ypz*VTGDnMW
zk9sNsmIJ^49mm%J!CJT6$n#uODeex!2+L)WsKzV(W?m@4L)=Q{PXd4Rh&A4{2PKUv
z=487-k{ZEuEE}gk*Pn%6r&$iaYtQ_eRIw6LS%VBKwa`|f2t=E1zcZk>;(&;_1gcU1Q(taZ*$
z`=lXlNMH>FdsOys0eLQK!|Y-g5QcSj$|}7Jkuw9zWEU@3`j9(3MR^W%ddDQN3wy
z+`WFZSPP-StHYJ6puj6cf#W=8WxiG$1^!fNAC=lk`V3JRQ#?P{(9
z`><0?gb~ecP>dI=^C5~rfseCK0m*6-E*jK2O$(GlZNeOh0*wS#8S&x5Fo<&{#Mvwu
zC~-FE*y9&O1c=3p({q7GMQgDm2~V=m{^$xNfi&@maH20)BvEhQj4xhEOafzDS5pk5
zh2KCU{)UhTbWJb8*|+QX!|}Yy{~Yjt3n$L9{`z~b_0VI7VSY&XNJcvb@#~UAMuV5>
zb^W}IK1P1U4=^JnKNeQwZThbb^M5|uFkgkv2cRlxDK-x7ODfjK<=He<>w;MIJR6QNk-y-5k?rcybJ@FDDm$~{&p(;
z4!9+3dG)e*wwz01J75a~^mqg=30q?7XL3c~Ow$~v2kgo9?TM}5oHc|s*EeRJ!x4pF
z(R~DZJ)nB|0q*a-k~IhFG4y4a0>%amc6Gkqq+O-bwzsTg?OK;VK_WIs58#0jIr?>j
zdGaS_SN^2qG|GNP!VSwqyCGpD5_47>OO^^vS|)W+KS@Qich
zGRpWQ)A9ti9B+AcLca7S18SINIRs1lifL)#OE-1>a_k1Li)pmiL(SC`wI0*D3_jOf
ztUTF%e>#QDVN&4-BgOHeeU1$wyHe=A-O1tzGxDU7$(f>asyFRs;MGVxcC+Dq%<*4gwx6Oc5|gN*RxO!WV~M>YSHo#c)hhw@++=ZQcu+DK^qCurKw`^oz*6f=lFQ$=oMw+Iy8h!dCPNj$GOi}C@iRNx`
zjxewOBW4h0&!awea-XO2J!p}tk@f-(Wo#MLr0ri?&1g@i*O7@Q{mkh#A5?A)`wDGf
zk4Rvvm+g4aq?v0d_(9V0S^aXtlR2Xhl`PW8gf{}0@auy%bWpWu*MRE4)|8eXcr3#(
zUDO!xw3-Uf(|$xCYoK$cUD!VZ22D-J^2ZU%T4$-#HnEsvjceiN>`}PH6_ad&2?WJijr3Ca@24vz);R`Q}$o
z+mxby^BA4{?xB9Ohsy6%`Q6rMvHa>azk1mwEW+F&>e@~WTKf$meThg1Vx+B@oN99I
z=+kj73>zY>_A=RsDaEGw;mINuQ_V6|lhDJ5AqnG18fusjczjvHn3-04Bzit;PnZ!z
zE{*T^YE7~Y9c`EFMlcur$PO7j7FK~FvSnr|-{6h+wyUc0}bp9Zzi)9^IwFqTBT`5~qSw-7MSL6UJ@C$q@E(7*XgRwt?uF+omcQh84iK
zE}VN8_Jmb=jRO{0P>&PL$bpQ2>M=mR$}(5hIJ~ZIGhurjq$Ko`&VNF;rHkEF_d2xKz+(=@tmqeImva`y${f(Ck
zps6b7@bX2#OF0jEyau}(?G=phHU^YAZwxe`8f$alu@o#SJ_c-$XjC`Uv}P$B_?t$#
zH3Nm3@Z}ch0@+h9`#CTksueLz0A5tJS=rhCpbXqDIcmj^zM4&Xh
zsYfI$`-CGnWfKlORlV#fD|9OVzqx-T_o>J<&KdoZX}`dStu{8?we8lVzT-ohP_+vbhQ#J*(~vD}xOpyMD`&fNjn
zlG~awHB!hitvM$$0JZ=Raqg!#8N~P5XUE<`V`rKNb9$125->$Zk?9dgLY8N7q93)`
z2*UW?6BoFlR=t5ZzRh8#O}EK!pvjI}{D(*`uEifC2`xU~ofbQy@^?J`(ovh`?b|$E
zwb>z+Fcz>&ddDa2N??~8mc=u3!~l=r{LA|kV8O=)cE@jScjCByR0vZ>QMgN2IMr`)
z1C`z+2+OWlQXnorr0=XOB&@$NLg;zst$P>RfJF|p;dUu$4Hu_Dn4a8jD-pfC2pWbU
zP>a14ZQ5&V%Za3-I5;4x{x&s48*1KK
zB-wz1lqlIF@CS$_RJPF$s%kykB{5TvsDL@k(m-Q$h>|!d{h-1L6~=dt4`3@DjtXbm
z)dL}LJDXeA%p`UF$f=7eKR`stZl)PKPKph{&+R1PEcpplc@dsXypIghNj|z67Bq#C
z{RrBv66qBpww8m|>Y;&akg;BGssqIEk9!bm?uB-!2UrB))FTWNt>TMo0Gsfvi8w95
zNQUQIlw|;(5-kA(gzcMOpqAOs$b~|TXb2snScb39#zgtDRNn0vo`puTf%0YG!3F*B
zdw{4H@c|!&CZI4QwG|x!PAM@~Qre6zRu>;~Ko#f-9yWd^!`J}R{D<;W*mzHaTNEro
z!%nB%Md~=hEBBxceu2?Sa&IiMg6PT)Lw6{Ndt5;y=v8(Pyc4B*T9Q?42f0e%3n3RH
zQO(Mz*ng57Tx~}6QszuroCI&_Y8Y^@2I%*Ywbw*c+i0hYWrk+!zOYVg7_}7rMXa|p
zG@jWKw0-x5jCKY$>J$A5-qBN
zWWf$3OD}Fi=O(rgqu7VpXvVQ)8V`?dD>I4${RAs{HMMHFeO}d13}!~&+{M66)AE$Y
zMAbx#pcc`A5rz}&moW5s-u%XX2hV+i5JZKQ?Mir^5DnCnehC&Tk+vo9mkn*a?`}1j
z8Ji^w}gapG?A%`w+@qC)kKFp~fz!+|RE94fK{
zx9lLP$&>VToVP)_g}?xc(v%ZbUzJiWQ!2FFdaS793?C@|Ncw@g3p$LwN^}Urxa}~4MJzo2n^?zO
zq|sV2MjK$BEr9r~Ez!_Ax_az?4J`8umN^(pq&SWeH%O0#?aBpp@Uw8pROoKBeTr!K
z_<JE$i7Tw+w^Q>xHn#S*MW<>ZS6T`&L&d{ZnG~vIG`FBL$rVJ&Zd$%fFMd
zjd?iu@eY@^S*T}Mq6PRY%UFO8$Ectb8-SAA$!zxtT>f;FtxkSu`XXSm|`1t3`}Z
z6}1Ehl@Xgb7kS~rXQEY9*=YBYvJ9NLMNgBW&5wkDV*(h(c-v+pa2rSHOyt
zk)Wz>0U}LEgCam7#OMdM%h*_N4BU=!87DZ;MoAkO!w|4bb3C4gPyE@R2t^Wq
zG}@7j$K*hQmAfDp)W^ZK{W-V4VX!k16f+i!w)R7dD9z!vgOQws52o@9+G@)>aBZ}A
z$>2%*jz^95`|^`L6EZM86B~K0c;Cs7s$5iA*0Hp}UW7Suve9vq*TKyAje;=t9#NcV
zTaiX)B$-4jtQze{QGj<)Xo3A$$~z=1SJmMuOvDCt_k?{b6TNe0K?(>cr>LU_wd?mp
zd}H$B8PR0nR~??Z*ITHEdgG&TfhT|C+f|n^ZSnRy8uNOXME=3G7xT77cL6Gt4O-9|
z6wJv5gC}0FtjU5-Y3!^u>~RoP{QPU)_&7;8MC-8yHA9n?O0bnSw-t6W^mJ@(hr6bN
z!zVgV`$!k`*$<x}S(R%1(i~JMMJ>Yn+D(3XJ|1e{uRO>1Nc$
zM3VtlnfK>8Dt9LYr_G}~XLqLwqr{>Z8w9p@)jDj2i)sew@XDwit5V$S4E-+8zz;cr
zh<+?Hf`MbP!{kJ=Hif|vQp`Rsii5pj&>F+-B%CyJ29Q6P`RN5#!p^0rIce{l@a3uQ
zob)2F|MCIt1|e|0G6mvN)
zK?&Po;L%(*FA0MgL%WTdGX%fC$aY&DogK@IuENb%}RQIJyf{fT`hHTR@aI
zS9pyH2XXjXtaZ?Eyvew>KMGf`Ui$Gew4_r
zA5Kw6kAC%+1ep&Kn2_#Ip;0I?OP4@Zsgk0q!q1a0KvdW3_boi1`>oYAz44+oSNG!Z
zU=ybWQBGGxH)rNyi8&b&=Ncj=(b-V9LLM(H#{e}MSVv~MbOgM?7sn#INt9(ulu}z
zJJ<>DpC6`4-8fE29Sh1p>V+C{bwM}Q1Qe-J%+f*X)dWU?z9WSBj&n(E#IONUr7DoO
zEh|BR9yq5H-k)U<8le!%QV9KSpiu@UWY%Q9wlP@2tnS3?7mUG4UdnXy1a)hSIil)JernW~t
zH0_pA()Vj!0*KF(6z7WZ>(2+1JMWafl`s!l|I<=L8f^MvU-zTw+}kdHWd64%MD
zzeF)_=p(|sFIRa)zYil5dgPP31h8HpDLM?&Xy0_6%e?9a45@gv6&W7(N_fbSP9(hc
zEREzkb`z&ck^|9N6NB(s2|N01uz
zpMqf?c|9}QE3ZES(KvZ+L-)<;T)+H|YNoE5z_9O%
z;|-UV2$!x@TzdHD!leoV!=+M=#u49OT>@DD4TBXZW=Rt9**Hp8-3sr@?uj##$}VV6
zFj!3%tQeg3HHt3_`;dz_u>}=AUsL#exYC2qd(ygZh0YEHrb!Aa!S_NUBUs?wsUyg1
zxccVCdP^`CA7d#nz)kq{K&{ZRaWc3$v->hw`0b=J2-?%Wp=B_eog~bci244~Ukf02
zd3Jq)qV`OZiDQI6^HBRK4SB@(OPw7Q1|>zkh3xvVptiAg0O&#$R?Akp-s&wCInn+v
zF%3WIZ8OA*6%$uJ$DGlLeC|6_WBd?1gnCEWHyw=ej%sNy}rUX0II7`J^*
z5eSTb&GAN72XIH^xnc&$cl8=oLB1kh0tZHk1V~nUGNwlS?MdXkLP#8-NNlu2m_WGE
zjXOaQN~N;Kj;&97@BNrTJ8
zKI@vX>eD<-%;xGX>iz@z%ctH4*LSXpwCC9snZ>=r?4Z2oR
zR8{y{l_@MDR(PY`I>O#*w@;&R8*6tFA^f#mr8)ztPn5Z&u}A0`+r5g;D9d8gFzA#`
z!)WUCSyTd-)L7+kd)aBEu)6I?bLsKX;GSmIdLRL+an7ssi&)F<-p&JXQPu8nu@}q}
zxW*m48$ku1`tbG;Bq2u49Xx3@KOmDLwFf~0T3iB;Oaj#hnZJ1Iff!?ae!by;$G!tG
z`{#qWS?FRBj!54jC{hA~PA5Ut!eertID_*)qKLJ!0Fj|X(S4m=r`@9AsVloj!|F>w
z1CTW|_({Xx{K;r&Tm%||GD%meUEPpHVcm$iSx$9Z&q_>*;vNjc6u~n|o&Qsi&*KrV
z*=-oQxqCYPy47xq>?Js5-4WTd-vYUqFdK45w1M1zotli?=3Y24Jz=NXk)
z#4#y7B;_!9(+J0{JJNqX2fTqa4R1#60dIDloJ{)fTm#<7Mm23gqH_kfW7D+3`$eO`
zGpO}@b_%KknMo~akVGO$%!hj_)!gzEygpofmnJ}gmK^T9h
zZZ_7o!D`~0l`zOM*)zzt$RN7|iPh`)f7~Fu|0F%grqGWK*Y=~DM|{@6v(D*QZYm<+PSil&~>46+{mz|5N)ag@S@
z8)I*Dc+TTKSY)^;^hd-+an^GY=w8;WU)_&YAHRXTJL{VZ*LLv>qbXgL16
zWn^{R=+Hp?cgx`FwvlNywa8lCHmdSO)Nu}!ruA5S;lfsHD!%X)<#d-YKZ_5>J$_beq0&`Sx8SvkTr6pG}&6`nEGtX_1mv;IQ4CknMk
zGavqGPw30C?P|Rxcb7)vIHD0vKluwjb@*?YR~CC_&}*hiE+yPlm02>t7B
zs>|#6c7Wfanf-q#`lB{)uc7Kid_}4d)#?SVK??qJHAzkxm?Re7~|`iZUCNxU#&r=E_O5oze7WSU<&;fAAYly-0%I(*9G7sNl*hRfxE!
zG9~JJR^_r!K1*{2kA8)tcb*$Qav+>7yaH49UQJsAY_~vx0CVdjm7B7~BVv_l_kT$>
z`kqpwEmWFldKR|zN(prx5w63i^22?`aW+YAtXj>fi2k*?>T&*J{>Cc4td)OKI+{N2
z6nqWWEeDq*rLn4x40AJ_a;jul;bvIr&EVTkUlwSt?T^_^U>onfbQLXV|M+-qVjqM{
zoFkh$e5d=gea+pTU4Jf{iXJ^#v3I(cy%SCm_U`VbvZIk-$hgWq7I=5YVBsxZv9nU6
zFsfq|`WqBZQYhFE*-Bj}mgAfSiWlmLN#<4pW8dqgLEm*Q3g1vD*hFEHMj=wQ70y#_
z!_BkE!$@5dT`7DE*QrS@H%=0xOw
z^?l(QDN$Ohk82v`fq{@8LwZ
zU0)ByWP%SEsWPpvwd=FY(0eoZLsJv2TgWo}8m?QY6ch$%jr+B#jH$Tq5WNbS?v$S?
zyEa==0gnc8>WFuUtdIW)B4@{xcYklr#
z-7EdWD49#^e$4mCk<6h4Mxt-PxS~)*6(Wzbm=g89FU1<|+%sLF^5PP8KO_%O;RoJn
zi2tgW9bm^_9{7TIrLCaRR1d_M}F{?*toi}iK`N%S@yQZUN^Uv69su61Gyp6!08WKf6>9GUi%^z
zf9gy&U)Y-iUsx@lp{Qg8<9#dTN2>bG-4RdHq(U+5$lWxj;XmgL`HGuQB9-WY>j%rj
zN;|Sv9`4CW!NbPb>xMTY?fZ_^5e~VT2o+MgbCq;$6Rd`>$KkOBb7DayQpf6WiZ(@v
z4a-mB1eUVNiLp>`;GWX@9VRMWsBSxA@erM71oEhO2)Lkf4i}QZ^s#6|ALdD-M7RA5
z9&gpMFRb`UnX85FNFDKXImLFtxGl%GkesP*=nJi^RQFfM%SG(Oz*n{YA5?$s2@={2
zv3=8Szfze`bjPl+IFfy%_G~AAoQ4P{cmGjg0tQn{v8$1Hv9;-+6H_YB(?6%eCkQw4
z$H5qxtmR`{o`QdNu=zJzuu`nLJw;8tyUB7q`rlzdV^;73^-G8d5=X2^T{fqZ5twkt
z;e_}~e7+tBna|@u#?`0WrrDYDCC4EvyZ(37=4g6x7yw-xm;3QsG;^&aX!q$#p~Kf-
z6{6XB8N(9H&XX#a{jOiRPlnJ+?kP^fAI;n$>
z4eHn+%}X6CSVvVt9X%@%<4A@FeNWU;?bb0Hb+n%EMWTmz0Z9naNKA1n_!=ru4Vtls
zcizR1Jsl~HAE-D=b94X1O8kkHC?7HlrF4Iv6>bXeU!J=&{MqtcTVCe5)4~bd=+R4&
zN3OMMErdn45%UY3ga2;1gt0s@In=K;3)yNwi^_)6mPh{xolE`7K%pHlPpqmT&7_`)
zUr!usejSBhE6p!n=gXbP&h2dO&1o~>5UudW<(u`nVW`tlub^iGUWE82x;3xLUlC`8
zR~Yu_8F$NYhWR3RlP~lb2O#EvPP^tva1QPn?xQ5=fiTb{)a@p%oX8-X0ff;};99PSJyRU=outaQOTgo`E5ya(Sph5h(sTnsRztHhU9t6iB5APOL0lrf
z2UH=lb*94ZG>zSYfns)6z`>NM1(49LqIL!cq$WXRib3Qng-Ef3$Y#Z+wUS`$pF*U+
zi^$9UgiSwD=-Tg|q!3Z9HJBdTTYnVD2KoO$-$^X}
z@xPtY=XPAWN|#=Z(sl)ZRBxIQcSoOVG3mllmzvpJ%O+(aPrt}9k$C2DRGSk`T
zqwjT3do{@?_>_Yvi-*4c^b@Yl~Bbr=j2LS+Ks
zzeZ0=%=ue4=T~^Fb5^s@CB7;uiGIAiQRzp|3lCO5nn-lSH%2wB^dq~M!|}u+G*Lem
zKjN@i51~o*$R`-eRpY$qlRq0KNQhy`JWwMBYRQf;~V`wkghX-j`i#yCaBSVhL=w|K}Hp~(37
zQz4jS{EWkV)Hhq@vY$#%sx7}}A!T~@qqk@sxCLJmwWZq4+2rQTWfyCwE#G$aWq?F7
zcP+=&ij01lNlEPqq6mm;`owToHykC?82EMDNTPDm_ks?17_}dR@eq`yPf{)(WomTc00md3A}_y^Ehjd70Sa5(1+5D%#pnpntzS;0r#VRw?ccN2
z$MtSqtgcE88xU!geD%0IX*IiK>gX#0gkgO4A|<7}Z$jy4=9*;yM%f}V_WCYVIf>4`
zRFTpXDwlms|9!ERl~SK!6sKvmHznm%qm-1X$RANVIW=8pj#NDkcL@&nE#TXhPn7-&
z-`=#k&9@KMC-Cj$LFo4f!?)I4G(SZ*za5OUXS>ZOnpcQzu857yDUmim(7M^&9}S8W
zS9B_lJP?f*-}{#m$7MYZWVnliOKCf%YMV2}!IRB)YX!=PKsyD77Gpy7ZWaw^r6IsQ|#^?&}5m)eJ5~b|%
zHR#gX9)ALLO3e9rtCKU!&H0ka>2WV#c5@!@=DbhktXlS>#pYwu{DW@RRy^0umzhdE
zh=$yp8{C{1;VXuN0ou9D4(ijU?s%a6OW$Z!UU>lLA8>T9D-R&_fHQP<<_ZyXyYEi(HsPF44m%a2D@c?dT2IB$z;0p)aL-qi!yu%@5
zt{PvG`isYDGHzF7j8SCFzTQK|a7BjQA_S9+2RJ%LeKS=q`^lqap44pO%64uW7G2x<
zjz41sO8a)AlWFl^hp&m=K&6{=qnq<$_RMzPfaitZGPm%JRfS)eiw
z%3)epvi}>-%+ZW|Pcbc}Qe=NBd1pp|{V5{*->IBr+Crw_{b?$fz3eEF{hiEUWPk5I
z2irrIeX!Ocqbu1TugSPukug3bWXvHohKx~)jGZ4jvi~`U*r@MvmCIgxq?SFn&0_X<
zaLHYJ*+0w*lH<
z+JkLHfgOB3p&Kj++BdZAQ6~^@6_1A>)-6L{+uOX
zitM?74VTcY6yC2>CpDhtsTXflQm*TeV;q=4@akP|OnsI`B67}UeU=nQtg<)IaSwb<
z!TUuSy}5OxEt&gb2Q2GWjOA)m6|Wz3xSCeO2%qiWt2z5k@u3;V@jd=`#VXlY{ix#X
zAFdP5HWL`mZlaqI@h#KY!J?6p!U#*F{jDS5G#$m#3UQ{@9N@08n}AmJI{xpXgF6H7
z-J?;tpK7f3?GJKL!M^=pC{(f(D$~5Ej8mw5w!;zfV_%AVmb2LxQYmETn9%6monVn>
zusB{}Q3nd|)79c)n(X>tDJ-5V6NWSr7>4{#+VmB>SPW8F)Dequ3Jb~|qUBBtiuNq2
zF0jTi$2&e}7pSRTRujja>;J8}bF+BOftA3kr-RqZ?E0q^UZ*L%hI{ckN#XU@hYokb
z9AzV@1bF?t54a<5q(E#Swht#25%F>k5`Fq)qF(VuAktf@RPFG5ZMVkrZSiDzA&c)y
z-Ebs#b#}d6$q_yJhEn0*9R!Ad6@r!T92d{`Ill5%7vQicZHuqt4a#v1cz=mj0n!D55P4hyGTt+?+MrPN)C_GPp0;dmD82K8-
z{WeL^p{ECg2H)kX5Ggs5DN)~fN=CL{2n#f=mv-^|{ZBizf}zhfYi|_)ocq>%maY|>
z+_LL8D-}4Etw%G@@ggxmA@TbAjtbn)!Iqof(BOkUv4TzOF~^}e?3NT77n)_8k(g}Cei#UmPifCoy@JVV+A|HvUh>(V7%u1iz!blN#iKKPxZ?JM`QaYS
zZ}=+iwO?IV=qBQlB1gS;NcL#@pOpWscOQ98thB$jst4xwYMp-!Q`9yZY_u7y+RJT@
z+{rCA&)o_lR6t=l=Gc6=S<2!%YP1!vFtcGBTWl2L
zG9{DuBta`i4IPMx?>tqAtp1FHO4N6TlAPTK_ssxBY$B+W-BWUTfsB(6@1usa+pRP6
zQ>`K25igockG^-`Qz8d(+4X-@8uI0}q9J{~*zA!3&G#Ff9oQ78A+C*>-PBW~qAB-^
z&S8gK<3{{w8Fnko(@*5KG$(9sdqzjREY!2lZ4RPC=;s~XEG1^@9;hS@W*^SOak;H@
zmc~FsKh;?!&%gEq%jyQ`8s4iBcn&Iu50!EVNKq-d&*>LvM*G*Iq?N+gY4Q=!T@AaO
z;waKE7RPPap)=*tGr6eimFI4A6zF0^1^8sMl!46*2o4W^K^*KpIlLcD-CDFodpA#A
zLstYHj9mamP3?)}g(cM+ah-`s_V53sWPe}1?Duizf5|6WvbTtj%-f56y>K}ws{`A!
z>wA$c(W6hlMkJd-V9e@3=rOYY3AeaO>y7rE803J#c1rf46h(%@#<2h&vD>;xBI6IB
za~?aef;vPe@iqHCAcyNhnyt`S!-WE7j?UqQ(S}Y`ajB%{;P!KHAZ#uTx{Ae_ud#|9
z{3lAF{OOrRV;tdP!vM8H#Q`D7=H~~+D0y}VXEE#u#cDts4WxKW+dgh|ULJT4dZg}v
zhtWTR&El#%?ce?zJ-wOnH`ZPS>
zLc#g!gsZ90Rf<7(h}i4SW?$Lyr*|R4y4FDoSHC!8&WkAa-@pHI;J+OBF9-h1f&X&g
zza0242mZ@}|8n5J9OwoIib~4LOY^NzewkHSP-YdC;XD5uKYX~Al9FO2d*1tk>`N~Q
zOtp@fl{3zR*XNhU`St!S%UsS=lL(qojTR>K4I&Yb?K-Z7F{<^R~rlk3~AlPtGKAJ
zBqV4_i(O!)+GbnQ{@8pe&gQYuB7X*EO-_^FLVR&){6~hV_m4%l22M_6junH@GQNgg#(y~JTdFT1_OBXH5D=7$u
z#*Z&3Eh%J+-@?|wXR#lQyIJqWhrjQ{e!xHC!|&$P*Yn+^{ZGOJz|9&CMxI%5#k9-j
zE#Md8UytK{*Wz^DWWV}s!S|6!OUIeY(rc~7h54b<^6}%#3!#*YLGir2ilY2rMX0=}
zWWjhaqy%3p^Od@mmoD;`R2CQeiz@sjr6K>~yyBt)r;6aTU_s&hyvpKGFt4nvuq5uu
z{G#IGU{MJ*-&>%(Fs~R&VhTXbI*@NNg}9&+7=zfHz|^VJhYlTT`Q)30Zu0HG)C;Ch
z3k+3#kokf}WlKwoD@5nY^C|L-E)?YQ>A4r=uyWJdluM_~o{~M=bi9h98_-`-(TEYF
z{Ac?|j2w&q^UIf(g-V0-N|yvDPoHx|VCMA6-COid2LO#*bGz;xEoCUr<=?55c1O7v(Jpl5+GfcI1k}{L1pepvW>0
z`Xu~S6<(A*JA0~MNEz>+o;%w={UZOgz_jTzzvJ4xIIwFz`4^t}H
z^JI7~D9>9YYIpG7SDZIu+7&#{Enszr#IK@?h3)L}!EmnEx28|I)bdRYWGfZx{`hPt
z5VNA~jB*TkJ
zSy)zDtXyqxy^8MSW6VK~L!Bb$=<&INf$&qcs`Yzh#`UG;*A|usi6DSyOqyO+Se_^D
zm9`x73jKNca74?BA)>+pe^H4a#=0EdI!0rR$-3g%3k&_2sf0@NOC5iVrBK(r;zIxR
zMWKZlsxg9#KkTQ6Yh6%U0*5=~zdo@k&~v?pSKt@l01~Ra!M;g
z{>l=hVjN{cGQKD2ck{0kZ9jBv7!+JoT3*<>uSiyO6R!n%V9LSUEl2H)IJLb})pTaB
zsEx!l^n=*?^^bKB`E{1`8KM
zZz?!8CF7IEQ(-1}DpC)#zf74v{LIQYL#l}AeDZ4u4laTo(tCyvR{-Vnh{2^_GgGWp
za{6XZn{nZknbz!phSO$<$68d@&KidnmCcbqYq;t(!U)|f58fZvxF+LwUdd980IXa^
zY4KvMjT!VPPOB`bs4OchEl0QX=M@wnM+Kq;i;9Yuo@Sk8Wmvk1fdwpt`B@1|ll0(_II$MZ
z&vP1P)&H6CX%rgMw3buDMN7*tPgFb+*;V8P{onY89{{KZ{gb+!%86u>$t8&$L+A&d
zpPDo&v!VGXs0^Ltm|zIPd=Hl7Eh-#8o>8ODMG>r^{K^YMMdgJB!TAMojMaLi^gS~U
zkIw8)Cv;#y2^E%TeM8#_GI`qW9MyIM>Y>V6(KDL#7<@V-$Laaqlw0vU(UC(Rf4Um*
zsgWJWujGlcUxLFRgjqUgE;6vt((5VFe=H{S)q}mg0sqCbSmMj6$Hyd<%pY=73bv_PMHZRj?!38Ci!TcplMvM$jg`daavnYRQV5En|N*<$)z{#*gmmv<5S)mbQ
zyzNtjQx38%R)q57SbkC7wS~cog?Y4Wp}Yl78+bk6pnSsmjnPFWR$etRQY0X5y3t$FA
z`7?57`RDs$i}1<+*}mBC@aeg7U+g-3zQX4{
zeAeMvALJuG(6?^JpPeCs#kK!C!jYR%_GEh0f!w7+hk}`F`(W-q>s$VutwoSK64ES;?)s$(bP|$-v=`RwXClV+#ef`PXRuw@Y#V+(@FbdJMlT=t2%bDe(dh5KXQ
z!pD@Y_Iy7Oz_W|?$D;T&;dA-L`(t0j$K-um=Y1(>f9&ij`(y9m^X#|w$45)9OvTM(1bR!}$ItJ}J1?U^qUPAk{62B!{@9cF?8k>`Zv&n(Yk%w!)b$cRm*YFr9|YW}zw`G$Jl|iL
zy+8IZe2&ZA9~*-YpPz@{g#4uA`xQvP8J|t~e1y-?%b^eW{0N_C@iBP`x8ZkRo%U)1
z&fa|Hd#`V+@_C*%%`?Kmcs>K45I#TCc`pK;*Jzqe-WxnLnY0&me*XRl-}?fN#D~AH
z(2(D2(Dq|V+BbC(eh+PS>bxg2Fk(%vFHy6NVCnT3YPuLs1_e!!75;-IKZ1Gr*H(z3
zmKqA&Z3@Olh<(UJ_1fkoLnn#7E6XcVVTyxa?lAsAN6`mukH@fDg-|kl$exbp!?fxh
zj!Qza&^xBA5K(cNjIy5ppkJR1-Hyh|e0q(YE|TJT8cTP6fuJ>#$T*5*mTZ
zh>QHWbx0miD0w<5K2kf3iRC-O>-xMRI^DtfrRCUEqH#G(Nj{5o>d@$(VR^A7ArvOc1>(C
zJ>Ur;{w4a6-<3@*NLP;?e^dHEab8i0-l)@VzOD0DV%p6)t7j=bZsyu~SG26Myow4e
z#uX$hZ|tycPV2*H1YjK0L}35_^U<^A;)Xni)32*!oSD7-LUSq9M~ca>Gt2=k+0aVgd})xM3cwtRWB%bbe3
zFes>&a5>o`b+SZ*`e;t|lOjZ7)Jm;h=p(BggtbDc{y8dPAvhT|Zs}w>I?zM1fP+Nh
z#>!ckE*G>A$Fa;Ia9&Cfs-WV2B4R*Udy?>*-?O~gR*!OO>SDsf;RC>?^#%&Ub>%NB&
zujIL#pC2L@f&-7pLbma>P|{O)u^Z2K)Pien`OrE0$t+&#nqhmPpN
zSSRWK<$2&6m|UQj`@Blwc5<*%+aphY-66g9YFv@2%vqmF(yr_%M4Pld@^_f=G~nt*
z9b+(7Sr>rQ;{BSiVdwTnQ=))}UX5!9^o|&9o-y#KyuT5n$Rm>;G7gp02ma^>4u87c
z-&yy9q7v0r4m%F%L|>iIYUez1bVBiGq@tDhX!dlMp29qAY!UN+9pq(!&Nc7mWeh7MppdS_ad6>;B!VcDTaFr9^lzq|F
zbcTTL!QIqf&m_TNM>jc+&_q#)jP+JfBJ+$vMF?}?a6oBE!7w$=kL!_Sh$9h=zv6e-
z6M-b-kJ-{H3q}m59On3A^?UP+nE4$0hWp*5C4&o)cU_YF2Njze6y&UpEV2e+X2B>6
z_iI8+Y5m$OyJU5^sn3yNfK=(2rbrPE2TsK@dGS=N`oZWss|mcdH!$Dr1*(lYLNt#Hm=;Sf&{%jU!<`EyxI?=;J-0QTX}WUNdL
zrS5{`AU(KR*eI7*fi2JE0|#x6aO1~AL3u2Od!Y-<%S+4IN{1OkMT-hy3cASUYy^|a
zB$8LcV;1;Evr~+(9Bfcmxm8pkxOmfGg|PLLf=9TRF+0oII%-)RvF^etvvP=XN6%(v
zUpQrYvWFL5Jd=A6_=gU2NbBy>Uq_5vScr36L5A8)4^+d7_Af`9ROL@OUXn9DVZSN}
zcJ`|#vtk^LDvB1AIEN3s=3WIzyKQwBnFQ{C!XsKGY?ZS={
zgKoyT1!=XD!!b*TZI`~^??CKN_?&d?fmj|skKyxAd`2C2Ahr~r7x3|Y?Lh1je13q>
zpYb`l|AAOOKEJ@{6MQn$55#W7X9GUHjz17HPF5FFjztz`12`5~x)htoE6a=AZpK5h
zW|K2_8tI5H92aq~jN~lzi;_~ZJCJ>GHrQ_z7eVO7L3b>sUW%mD-U6OQ!@9RD@k>a!
zVqzt>!C=2qXc7Y8c}r**B{Z+M#He$5ti>|vS7ux-n_839HEN`{F7JS5j+3gPj;9+t
z7~E)iWCOsV^e4}>5&TLx7749XEA!IdMvgE{(%XjIZl(I;sCMa!3#Pw~Oo%UMnCXnn
z+gZ3m`C@8{4SWh@LfpCAiM>b_d6+;myPUm6qb6P(9H#e%$VQ_nm(Ct58;zWJY?9{-
zaSlPky&adPJ-;qEtjk=Mm4}^G)VPc#86#*8J-G-i?US1^*xH9YvW054IehQp|rb;uD9>$@P$B5C4gn-z)k*|H-ot7{Nbe@U9>`Dpn
zxQuGIJ6kw+xc(&L7vL~AvJai4x47c~dcN9R@Az-tam{pnX+C7zAw+|<#tHvEFQ^PFq=5A(|$;xhbE{1~bE5l08v
zk+eT{pikq~;HxxB&tM#Wc*(&0Q5*BFn4;ZoY^GG9AIvLs$w5I(D%AYM#C8!gFU?0r
z#L}^(%G(;So6{1;Vk7spoWPW*y(=&>m;_Z|&uAG&6yx$c-PKg+CODe~y-DgO1P;ow
z7f|WfVd}HlBw=vUQ!Xk8X@H8#tZN2lp+mFPVInKYqc@VS<{xqU6d-^@nis|Qmkg~R
z9;u3UXn$<1nTmEh{@BqvpUgM(dYsdXMNc!a-?y_)%90q0#C~}d4z+YPu9(pax+6uq
zeKHICR?X2a%t0!yrIrjGAv@r)9T-1kXEP6bVfHMCy>Kqgdw>mI6w|pSo=VH}YT!8T
zEs^uD9BhZsdBC5k0a}+NClr4Sb};LfI?acpaK@p+P|m(VocVR4e=w#dL;QnzQw9(8
zp|_M1cP=#Hnh+<-Iz5lpwZDkbxWmDy-57*653`>de7o%d
zDgP&vD(4P9-H+R|yfN18)V-T$vpZlBc6vltiz2H&zfZ2
zcxL4}@^6`yb!O!-`FCc%HPL(@e`e(*xy_36^c$^n{MIsSqBYDKZ%s18S$D=Oxfjd9
z-jRk7*unJWH0D383y-LsswJ2q&EGMsD_#L~Kj?0M@*YG~m>>GVNGgKSPj9`B0^nGJ
zYUAKfBphZxQ)eGSa)ciW?>%yW?R=gDo-_bMagaz2@t#L8ff<$@pWtddqR_O+gqHa|
zN&R%noAjY>HdQqX$~WsQE~E3j37wAi*R7pp6jJeX6z*a({X-3$$qFX1n=G#eUlG8;
zdQe{N)7>)&X9`z@aY8HMDtH*}yeu4w&M)LCE-c?WPaW3_V}^_f7!Ayj;ryQHAEOi*
zE8WH(U?@^&!09SwUlg2jX<)WtkJh)5E`5qU$=2EQo&fi%CUqCqVcT<>fyE<1k&78j+#D=zljeC5Q^lIY>$kx6+ZQtWM_NG|5^G+9s>Q|GG;&W|4sRiUOXz;u?8fUe_|PMAlV>=e%;9=>a-|@Mqm(+Lurzy9@Yy_!L*9fUABt)u~zOa
zkw8g%L{$-`Hx4t}+mBaS`u!94azFMsLhOwD?
z?7&g+yz*elymC6O%6mJ@pXnd&AMIpReiqsn|IcI%@%AAJ;gEFT~N;cYkdU$4)qV*sLwCUV(%NS7O`SZIEM-loi}BH}hxb-Ik)
z?S9fxd~w7u#Ow66&z9cS6L*e>8<*5|yFwYoCg(`x3R>@KqdJ#@O^sc2DMx#?-5EK~
zZ36SjMT@X;#}nf9Y%ekMBTs&{F{PXGx?xc$ZUX5Y@`S#=^1o#rsiC``8MlP)CbK_u
zK{l%jn!OQj2pye?8>S>C%JtWzIc7}7<_cMPO`7EbUR~OGmWy%k@Qf*P5rri+S~^9_
zYH|N#QHot8EESj%d@bx&+8zCT#EC$=4M;1Bl1
zQX{Z&ckhX104}|EPizk00l>LiIfmf-n~fGYq$1N=Q;{}reY
za5bQH7xuLLWKZl2z}o=F0)7v0D&S86=K{V2SOxeh;5~qU23!re9q{*n_xyBEY#ZPv
zzypA90S=5>)(*glfXCgxCw3L!mIwF5ZUXG_vpuo<0Ve`B0FGR_CuRda4Vd~p%h~`q
z5b%$H8G!EqUI^&>`JPw-;4y$p08aqC3(ya^67X%n2EZ{7fj+>A4}-q%Th>*8e!!am
zvjBeyI2W)PunN$>3grR63)ld7%_AreIQmhPud}R~fRF#svhD^v=SPDTs1@Kd;5mT)29yJwzX9z4+Ao1`fQuV}C*XR(?SN~ypgp|7ZRg8q5AcjX?1{|)
z%-Xsq*6RVws(Tgn0EU`S4`9<9s0VQT+xY#dW#t0i12`AZ4|>Z1vjA@eoD2AUz$(Cc
zz?Fa>05$-o{u%89&IauD1Jnz62H=s+kQbmIumJEvz#71XfU5w13b+aI0N@V5s&`QS
zZt&r+z#q`shIi8e)&MR9d=hXuU=!fufS&+v1)Tf0J+YmDHGoG!KJ|d-0B!@E3fKl%
z4A}o&=m}s3;8wt5z@3200gt-JvK|LK2XG7ERKOj8#ek{rp&Z~DfR6)a0d55>0Ne>!
z1$flGmUTbiIe-m-QvtUD76Y~c-UZlyJIVu&1>6ca8*nFJ8Q@XSm%9M#0iOh10=c~k
zxB~EFrUQmPfL;OK1K0*w4>;hbmh~>+SioK%!VUl~1Y81m7vKuOCjsjLn*o~vC+y8xCAikh`q5DfDZxI1KNPifGhj%jU52&edOMl
zf0boT155OwGZymKawi57Tz%79Nj|SawFFumucJM{(*QRCP6XTm
zI3FU$$R{+ZZ-v+D$oOlxC3wSwT6JQPCF2FYc`~M2#EZ}IsV+QVx
z%?3OXFa)>|@E*X$fKLIg0(=W_4d8CTuK@c$j=SOTu8z@w;{j&_UIZ8dya(_ez=r^z
z0(=7SEx_jhcLVzIevkgYMmfOIfENMI27DYa1h^US9>BBk4v?n+-vxXNa2Mciz#e{-
ze**mga5Uf(fU^Pj1BL(x3_^LpiGWW5UIq9T;LU)$0UrYF{~OC{1sn}{%4sMMm<1RD
zEC9R*a5>;pfUg6-1=#C!ln0yy*nbV^1RM?c)|q=_R{>u14aght{&OI2KpSui;Auml
z-+)U1Q-2G8WH|H$a1-EEzy~uRH^6@Y)&Y(j0l5K|05$;Z6TvsY|3}ds$5nZi4*lBV)#ljJZ1_M@Ei}?21?3
z-`BssAGr5<&pFTYob$fm?l{dpMmfq=H_F?K_6yT^f_aRxjMEp1XA;|3!#>t?l*btN
z3;AUl|IIvxZW7Nj*0GXpJitDlHbS1*XzMkitVd8Dh8Rji@9`Zr<^HGj*7vsBKm+3sie5Ty)JY_oTxq)xqfFaYj~6`O!~BbXE{f>
zfw3?7`G#ry5A&E>sNYz{dOpT>wzB`CpD}NaGvR>ey1UGq8(6^KvVyO$ftP$%zwmMn
zFrVXmmI=Srhj%-l7-b=+uW-KcgKXpic3$)z{lblmu!l*#?qAGeT(SEZSF(!DEB_ZX
zbBf)}{rvxeVGfr#Cw`|tnZmd)=r_(}3FofTZ(Pe(*0Gn{Il@-P9#mJRvbI#-xSeHe
z{*ryleQaYN`|zwm0t|6V^coh4tkZmwk|tJ%mfyEwDVy1C~o?#JwBa-ZjuHR{b$
z7IQtTIq$3L%{=yS6~p`mLobIyuQ7#hF^4hb*3E3za2Z=z!XB<;nC%Q5avx_3N0`Go
z_ljpVYxo3Pc$hsr&M+ek{h$1-l{dCCmjz#wH?CnFXH@97i{EEIpXC^T!}xyZ9Mf6!
zb^XSztl-LZ^2Ta*a*~6Lzt8=U#Z3HzI#lWx9%M16e?#7QBU^Yodw4g)EMw@f^)i)p
z-%@XG-C*84#yY0mZ{EC*{oKSczQFiD>KCT-Kg?%Lwex}3v!09D&Snm9l;an_|84Ug
zFdj46&O+{EC6gb}=bXoG=5d%S7-c1sUojtM^B*kc|5(kE8u9!+yZI`Ix#&Uh{4$e|
z`1yp{Y-KS!Sk1$1<}kbYkxk-R!YJ1=`A>chV-7EUNWbvotYHmX_$+(a!!Qri4=17d
zwerp!=5iTJFZvyM=MJ{<1pAn}+5M3BGVWEs|6v;UFpr53s~hLAj#+GD9sAhMQAQYd
z)bnPYc&=m~H?xc_tm6RN__ptgXCg=0&-gz(ueLZJd4L5RVFfe3=X~V7>|_H6d5ROv
zsaN+Q<1mZkEMn&Ooo_5=6BlolcNTD%C5&u#)Q>a#paO8`;i!_H%+`
zyt7$+*zc;D&b7?v<1A-C>v@jtyzD9QT*5Kl$M`q&3DY^ne12)Cc;3f)4zvB@>+EOp
z)8aXo@h6-!%wRhUxQ`X=V*?Xf+|OCS0q%H4-PpzCzj+Q}HiuZuldNX!v+Bmn+06_N
zvyGt<*L_aiSj8NMS;F*Ibz?bO`Sa(E%inUG$C>bV`;{4-wadIYr_H#`VKX
z=NJbWKW1Jpi02K==dCPfCF{AF?Hp%6XLgF`wLka#_peas7H09MEaniax%5SOXE%Ep
zKRfvt2l*T)_`&_|2mdxMGkFgSSwos$fahBCp5zc`yyAJDvzT;7ewoF^EMf_(ct4vs
z=ZJU?aEMpGYJUGQ&p)dt7aq6&xtbN+#s=?_u=jm_+1H%B@DZ>|?{-Y|nhEa0Uh=EG_>v58%LjYFLMcX{9%CY@71
zX7MbGxaOohu#HU&vzv3?)St{`l+{e0G#_U3FD&NUN7aYB*us$9MhHy19yR(NO5eOk>)Z{@|S~;||twAKN*~eqQx2{mR=I
zf5CGq)A?iO^9aisWF=G`8>pO#=a$Q3q@GK6=&3$53zyuY~}a=BVXLXVU97%;}h!T
zzXyt*^Sr_h=k=xQHZj5LFS5<|yDsPx4h8ZYGcB|-6baH8W*)~_%(JZEHPa$N1Lv}p
z8SLUEF_B=12^{0;OCmwSCDTHaOy$M*TI+h#>GMRjh`LJPjB&cQ|%gjIh+DK5xI=1+JU1}ug<7FR+1f#ryQC`c0x0yFn
zc@J}0$|By&a;|3$w|vm`n3fg^dbpfnRx@pa
zihujGP|kxykyNe6#g&7n9?sh5o~AMp?j1
z7aN}+Wi1!7iMed&x?3W_0F!Qu1QT4$9(m|vm}3lCXWUZtWGZu*!^C$^3vFa3yI92Z
z+ap00m$QjS*u^mp@zVTA5MdgVW>_z?xRyoSz$%8>#7TBBW|?>vFv_?)toL2|pE;aU
zpl-}#4IA0Qz3gEx!#v7Rg8g`>^>8+GxNo^Uv7fa($yQE&+J51pLiJ`5sY}PY~;MV?RVyIkPV#RFcaT1
zEi}bUE?%KexQ3N{nvLAUPOiR3-k4M@Z!BhV;+hNN1=CqnV!do(1Lu9gd>OmSe7TAdhQ4UN
zS4<0)Gn=(6=8;n4@x?Ex6UW%gyH?vzto%wOh)tRns$nWy*QgUiUzKmyO=g*|b6Ce>
zwy}zRY~(0UG5&q#Rc_u~%>vf2f>rm*H+Qj<{TyV%TJ_>0CSK{j#4PS$5vN$i*UHsTCST>8V>WlQnDf7G{VZV%%h|(y3^UA7vVFEry;#W{cCdt}Si_wA
z#B<{}wujVjw)xfCZ_N9S{l-#OvVx6F`mS{u
zFN<|t$2RU{9}jSp#~J6klk60iw#9f{&j|aOe69L_PrX^fVm7my-E8JzcC)Tty}5^>
zRObUzILaI@_`Z5Gmo;3)7FMu_yBTI^tN0J-*9P@w2lIH8WgKB0|Mmm<=A3Qv&98Bc
z-)8(AaZKkM%;z}EdHJL2#gDO_O&s9NM)hGT6FxXC^gU+q2^KKsG5d`5Y~ZtO=WdSk
zBoor~_jdK+F&1&{^Y{t(6msGmFbu#C5D>~dWf6bG
zD(+=HUt>E@vWIh{>c=j|E_Qx1m2DT)iJ>XyHs`XA;c4fBHnzl^3r0U_-(GSqNXV7n
z*mFT9t69h$tYp&L&IOGue*3wglN;D4ek(`W$vD?J%QR-ioeT1~oMqg|IySM5N7%E@)>y`?;25e3tRIn)kcU1?eneK08>>qpWBA<>I-M1MKBEm%m5;^5m5n
ztV@(XX1(`ZP{lJ$zRh}>pYQ%~g}m|rn|PXCOinr%4DmRl482d>r}WvC^1+9%@_yHg
zu$wcJ&jrIwW0bcr+c=dh=5ws(0Glt4&u(7%esN4=l&hG$)N?DdnKVm07hf%&1#D&o
zyIId+CZwDTVsF9RQlb6W{vpM@(@m$4fHn5p{*uzr{Ga=RAOua+hK49Kl$2^{3858E{SFU6`
zJ2}9$AJnJZ$HW5tnr6RnAq%;lm26=n=U=C;EaDKW7~yxBbf@1#%sm%m@d_4kKC4*3
zCaz@{cW{XL9}>@XOj@oE%wivlI6YlF=d+o`?B<_1!V`@BwBHkc_*{_6M&|OwJbliD
zkEj=u+0HfWXBEe|m+^(}Ga2f|CG*b(1^gl__+vKk7&|!10cKoppKu)$KI8d=8Qh;K
zZ_N0ZdGirAF?E4?vy#Ky%qaiOk$F7LGDdH-ZpJUNZhnaa`~%0i;3n(7
z+jBvVe&M|=WHl?flZ||dolL!1z4;kN_(dkIa6M*o_G0VidRDWM%{x>;dAWaUWPfw&`SAb3X}81^W!XG1#7sGEsVKMJU_%R7c%tu
zX`wQvu#q_&X353xFBQ*2Y~cudc!pt4G3N`ef4lc{f;CLZ_kP~R9xIPdu*mNT=!{$j_S_7}tK=b=yQ6VCsPbLETf`*-ORUcN$}Igi!+{^#`HYW>Sx
zUa?aDvY4R~`-CZMVh(q+gl(TUZ=PZc6HCmSUtpLW3|*W*Q#i_IW-oVjgETYrkk5?qmSm{R6>gyrnx7LM`+|&ThjQfUjg0q?QRbQ`H7tUlc*RzHP*up{fFv>8`eADw&x&2t>e#pz2
z$Kr1}pSYJzjN2fN1q?HEzdYaTIh<)c!!pjRmS1lEw)2p?IKV#UF?OSV=XFe2>-=E`
zXFXuO%wQ!KvyqeRVtkGDau$=mCXQK5c+mZiD_O<;o6MKR4~gU1T5;^(EKj`rVeu8t
zCuVUcieucsOxW-FjdK}at?s|E-&o56?qmhq*}y~W;3x-pmgBsk$A0~`=OAXV;wAf)
z+gZtOHnQ%w_78V(h%LSPhNqdl(RzQUZp>#fn_0~xZ04+k>dqVvvzAe|Gx-7gg4sOJ
zVov|Pc&4(M#q8!b4)Y|VjO`O&bMf~#>c$N(%RBe8mSMIs{gD03uW*$0jC;^^n8xh?
zlXos<8OvD5&1_>M`#8)|o?_f4^XnJS`OITJ%ea|!Y+)P2>|?_p)QvHR)$Jj5WIAUt
zpAD>F<{#CKp#gbkF^BjwM!1jhwbMd>XF5+ahqn$|KMPsKYyK>MoW~As;s7Uy{M^IO
z{l&ihj^9%f#~9}N6XNTfpMMk2YUVI;L_9aKhM~WU=SKGM
z%9G;xB17L*$2Y}u8*`X6DxTX}!-Ri`=SKE0$}nqAiQgh`OkwFi#q$VDm^CJzJK4gx
ze~IThhB?g8_ndR5#j~9`ocWe`*0F|@Y+=c`cphY!^ZzZrUcQ*Z*fZj}h9w+i4Hx}K
zJX_hr=@a5v!O-`eYs_IEOZeXZ+COYyD`U^vKitj{zWaa9y{+cQR1RJI`VrT=;A=Jp
zo{yP#`DD<@#H;+BdoE>WgSxPg``E>+lP7~A)-uKQ+nDRRy)0#zwT!ZrN$>af+nLD`
z7BJuSt2xNsoZu)EU3caze{-GLY`pmO)ssPlbxiqz`(TRkc#NgYzh*M1<7T#Tn0=g|
zIvI>{8RNIP4>6suF`r{B=iCoW2K5)6GZ}PnJqNg-;|zUpGDvt--!g+aEZ{~~a&ww_
za*$m-cHLwU=IptXL8#IGVhUF=hZQX0AZuBkZr-f<@TAXsPYeB)V?4t6$MpX^^XB8s
z=kqM*%#Tb44P3#3vB{u}0_Lb>C3@hoRAH*lXWGr{@P|a)gCE!%D{8s@}|J
z7guwLm5gvJlb*JpnZ>g#=HfhcVIiB@%5EOxFn8Q0?=9-J)VkToT!vZ7nA_!z%h<{`
z_VNNpn36AV&p3~n%6jH<7fbn9*76iv8DTFk{gim7GWJ>fovGZwTsE?lhgr)R%fxd(
z``FJ>F1lkfhcQZjBQmXrgDn8oUz<|
zIOo&m!>xtp!#?&h<}>R4yys%(bJJbMWj{x~e(7h;)7Ken0{1fIp^<@cb;M=FYVB;T*?Rse>NE;ce&nP*ZZaQ
zzaWoX&RkZol-;c5U7hmCc|Vs&u6R)%*~++m&ReFj>KF3Jxn1(e0_GTJKTCLmHJoA#
zul%L_Z~?=tW1YBzY-4Dj^)sJi+{pM}IX9Tjz0Btz%Nb=oul&`d&%=BEV?S4Lj1`RU
z)~`%w9rJmb<&5hV&zWpzD*HK~V?4t6U(55a#d8hwS;ulN*e{;T*v=C6a~;Rn&iMWE
z!E|o@jry~N72L-L_OXM*J@yOFa)Jpj*)P9Q2WGOCg*?J4&N`rfn87aAaEQAY;VCBd
z*hjy0{&69Tn8zyK#U@s=i<>#bMn*Wyq?hEUS3EOV#0pk1^LP55i`mT=80Lb5`t^W+
z?_mya_`QDM2Vd3?{A#~*n(+hrk$c(4j92s-A7R{Y)t$+Fh8f(=T)xUu9%mKbWIe~(
z!tF=&8M_!}A49$R=}-EWZ!wP%7BhBGJ($2+euAycWfwoie%{3}&oK16X`z%?t&_``
z!woFq4%V>XsJ`Y)?BgL0^C-u8g0Tmuh2HsR`;jx5#jBamG?s9HHJoA#(}%2&MGUiw
zHNSW6{Ka^@;+XMxEr<#(BU$nOi7!Di+%?oHIH!bvOW^z3Xxs#RbW+P9qlTi+G=0EK}E@NW9
z=Nx9TlZ9L|rti3#OpJ0A>jAEO*$%B%XGIb0NTJ}6-kYuL;d?qd(9
z7-sS%=Y!Bu_Z_Bi19P~CB|OU-ZjTku+_#+%dbyROJkIz(tNW$rgLJNa`}rWBT`cDi
z>lunWAGGsL_Vd!|=YugWW&Du)71Mc$1T`YLrzL}@b
zSo)FkK{FfJ&7&OVREGC?f6_;d!(2A-E_Set1FYjXcQ8TRZf3BTIbnT0|9nu&Qr5D8
zt($Jxpjc5yfRS#^*8;j?TwCGVf}I={ctIDCTR
ze4erYbbn%=alie>#A^GMb6CMOO#GMMpD>f7EM)$-&5PG;bbnz6
zyBPa`b+Uj_URq;br>BKdn9YSOW-+T-%Vs{yZgz8+BaAZRLGf?-d5GEUV=+&%nxReN
zc_q7<#xRdFZruKR=zNgIB4)Fc1*~8xpJXjt*~Fi)oiDP7D{Ebk^$h*nzF-Oyza!7g
zWSC1g8}E$&Zu4RLn|CsYpJO4{u#Atfjyu`RAF_iT>}BzH&j%x{+v0lvF%PD3L%sVH
zS3Kf6oc#mW;bOLNIZMoAJ!`m)E!@K%9%7&O#cgx{y%@*%3F9%Ho0-oxmh(l{^G|H&
zf7#E(NA(T&HR_xHdTwO~Ct1Mc$Mg*svw=nI;5rU)2gljPgtN{EW^nFy@yulfi`l?6
z>|hlK_!P(4!-W6Y$IRd)3z+n{cvi5Ho$Tc1Cg%>1Fv6NA?7N6_hFLttB1T!o89Vd?
z^Vr1|9O5oUxtGc3ASVGgmB+0E+0b!_AGo$|&sj&T>`C(WPfJi>f#dD^_$$_7rd
zgNZHH%~hP>9wwew?^g5XUKTUvdHaD&*vz%;X5lXV$yE$R<%KEiW)2Utgkje33|lz=
zhx&$TZTf{v7+`(LSu#{oeGW&pi!j0_b&~Me7YkzMZF)^Wq
zhs=YS{pP_N|6m?m$~tziotyrs-mEz$-)-%K)!`K5VNipGj|z@pG?vap0fw
z&FV4vW)oYvhrOIQD{pbG7qu>yF!>!`pHeUGV-XLsoJUy03vA(~fj;89*vBLea~`8y
z%H-)Wp=YN>eGcDsVxm5WufCT=eGWe+v^O>ywDZ*4qro6wjEe?QZhA*FNWIK_r$>W)
z?zt@L^Y`+e91U8y_WjYIk9#ws!35`A9}QCCV?v8Fqd^{PZiogIeDTJp&)LU>_TL;0
zdboRWG#KR(#=SEpG|4osxg{DDvf@_bFext@G;;~NnQ~h+2(yy0Gh#xqOU1GD_GnPR
zlziiH0UKDt4sPK9cW|8DOn8?%F@vXBz=ThU=X^G>nH{`znRr%koS(fT8YCqcm+5?&
z`8>iBE-Z)!HOyrr_pp<1aFC}s%J<)C{qL4HCi8w~vz8T%E;kRxeL5PnvX{L~_-xeY
z=VLVGy6Hnah_ws`^^9A*2i2H
za1|?9!v^kQ2m3g{(;Vmgb>gp#3FR?^4J_bcRxs{9ea_kJWEKaxiW975;#JO9X7Z;j
z(z;$V1z4~l|_91!W^jdl2XBgp^nKaw|lUeL!5f8G8b(`&1?qD~UKWzWAoS|#w
zl_@;MT&C3NcaF1;GrlWt{2u#wjH9gIV%@3kn@r~^=5zde*3D1UTQ@(&c9yW8J2=L6
z#(%(h!3@TJU%xVWt9f%So4A$T?By_v8_au-^)iJK=5YEC>~AKshJ$S7Y4$R1n|;nJ
z8T&!^0j6<`dEC=z-t1vL4?bqzylT67a}mdQKNHf_hZ&5pfXg4ZPcD9+jqG424{(r!
zoZv|&Ugv#H>cxU5qCqhmS?0t{v*d9SqIYA5S`;xRbf;U@7;rmeZT9o9XQ3
zS2)Ug#(l{6Ok?&_*3IoK=Lyzx^E1vDp5!1GJZs+Ez{GUVC(LBsbNYC#k$E$dglPt}*Fn_9qwY
zwQlZYKlgKtBaFY^eU0gy`GUOhEX$eDDQ_HLJ4e~i;h$SKrX;ol76HuKniCBP`+R9`okrmyFA8?BTB&=0Q#{?tt+ZI3L-_
zr7znLyo&=|_($*K62^U8eO|F2xq}7lW(AM4fh|Y$H5VOqj<8`!U$Xp|y1Gt13)#g=
z{+X#+<}vJgT=bfC^G|H%>+Ik^*~%;YFyRxdv~e=FdJ3a8AU$`B^4qdq2~8a#G#-;Cbuk_gP__CN}tbRn$DV^MZMBH^=!Z6K<4$
zrm}jx)AiTbl!zvl&e2-A&6V-{_s)jVK?&_
zWf`;QU+_75&nKDkz^ac~2O}T95KJ)bh6_RBCw-rp+|42R>ScuEOp>?I!V5tb<5|Q7
ztm0BOaV5j7VxjBoVkLXn$W!cO{3k91gS?Ux{5TVHV?uW`lT|F_tQ%dQC)mtMc60e6
z~)&&f}#KWE*g4{!6l&2%njJ}X$xt*mDY+qsYZJjF3CS|R^S
zV?zHemVXv~ULLsb3;Kpbt1bi`tp1|9v5upBfpNE+7n7M#dLhW>o-gTJ?qd}bSL+YX
zVmtf4>^e*;Q-5wMx9)teueEOOU>Q@srhfcag}if;{ap5S^JeCK_RXg}A5`i~?);X%
zWXuNRayFZ|l3jd)LwuHF`~%~c=?A88lsT-gmUmWuTizMJQQn!&Fl!jP!~Jj5g&>u4
z9#RkAFJP{(57f##hgr{aY-ike%%3wk#tz08=rd+;<7R!&L#$+aoxW!yyE*5(#^-`9
z=5?q0HCx!r9u70i{_mN`a$ncWBMY~h2fH3oM<)D0{@K6HI=p|JDU5&A`kBTO<}%j%
zikZr4M!1hjpLRYmn}v<~g_~K;7B+JqyLpAc{{_ro1xG8d59_e7IRq75*}m?huFflX6H2bafE}6Es6=9U@Ff(<=kPyPIcle
z)-jiDY-b<$bCd&&yW9SI+CJyA%x8qA+;s7%^&P7bP$GOQ2KE*=zu##7{I_H_jPA=gfi#Wm6Oe}UjFq8c(=dU`f`}6J(Oy!!r^3Ibl$Q%2AE^my!Xk32$7sh1{$M{vom*_L5
zaFTiadzW~gVJ(;Z(tU>A-OdTl{f&5jiSb|X{K*tP!5luzA`Y^O$uF5dXS}TM7}1&+`hz=98i#F+|B~m@H}yB$na@q5uEUsr=AfAJ{WILvN75^+ATiQ_B`O$CWx7SBxXW|#H-
zl0)p_82^v)=6!^DW%_X1R8Yy5n5m$N{p{kRw@vvxzI?uYDv14xuj8hIbk;D>^|!K&
zY44cw{{is(HMVgD`?#8;tYVz&)G>`anD07ErW=`3Ih52`|fmL@}Hyb%{
z@%tQSKNHMz^y1gz;+OmS8}1v-Vh@X0@M-g8C0j0jpM6X#)VJ(n!g~9f8BF_(I5x0~
zDR+ruE_*J1pQDU0?wj`2XT|YF7VvMZV0@AJb1geq!vQY3dn%Y<1rw|6lNIL65*Bem
znfWq)y}YpfoBEqaImS?x{{EJAF`b85z**liF4wYw``N*~4fZn+GQ!;Z_1OmZiE8y=
zF-y3WHSA^!J2%P`qa5YN2dwvg^I;l~F^{7x09(6S1`2EI85Po
z=5UZDyykn>&0Myyk-coIw{HIG`||yOeq}m$Z#8fBvVw20ftNgD-kie$W^tT7OssL<
zGm|4MWL1NCGxUS0pqX{-Vav9uV1!Y|K4?EaIu)ey6!UnfaVjWh!ediGJ$u>7-0k)+
z8|jbShK@6ZNsn7ESF?oetYH^hSl*=09OF3io-p5s{QirX>}Mgb+~FMOz9*ey3^hB)
z7|$X0FjN~8%6UqEa0~O;%Q8;isXw@%9bELZIBsE-gG~O8=a3fXAMar?%UR9sY-Sg`
zdF3Z
z7t7eg^$c^%E_JH&e8N;tFqd&{*3DAZaVOijhkfkkDEk=qUC%{KW9E9&l1-0DYkJB``FD<_A%~ze%@pnAN;X+PO*&d-=oj?
zJli?@r_LiT{+WJZITPxgAI#u53%Go*{c-VYHgN3=>dvh{cOG5*J}0>RMg8`DeZ@@9
z{)K+yJ*?y=Hu4lZncO9w4{?HrnY1+~^uAxJJ4;!@4%YIDeeT!%0ed;)SN0b_{A=re
z#6Dy?ds)ED{pQVk*}(hR!M}5mcl^eA#LqFQ!M~?5n;-2lE~{C4@%wD!tL)=VFFC*Y
zBPRU7e@DU$9$^8)tl&Ej7?)SGgZUib3Xbz(CT#OO&kP=90S8&ZMZc9Vwy}#Za)^Ip
zg#TsIqw?JA9OWG>Vl}JyBR26UyEwujzWaCLc`cI~-G7+HZ?lNIS;ct=#q(u$@l(GS
z&rwGB-ahe<=^tkCAdC2gm&J1-5gS?lcT+b+r|LFW^vY(mFE*3L1;QU}No4J?WOnk-p!;C@k%wh5q?rTTI
zbN!Hb9%Ic#|6;x7J^h&VaxSY_%_bgZ7ejxwUe0HP`Apd%&&**XOZW_HxPI8au
zWv}ToZeaYAF`+k^&Lzh^kMjkV^Bn8>p4Y|m!|dln9OJ(k->jZt@%%RP+0Sx*;0^J-
zhwXft{rnrp_`wt6pYn4o)A`B2iRZ&C=l`*u3rEEBOYG;%e;3aWzbSsFbLSuWoN=f0
zIj?60FZq{!!iWFuT;MYtHXZx
zG+r{(yjjdLzQ8(8yCMkMSjav;$Wi`}al6zhDF|BZlN|Q2fMKp=NIzGzRGv=0&p6&c
z{Yv9-m}Q)Om2tR)ZCuGdzQIvmmTa6K#)NKQ8qYAFIqwgG3O+U~2pYIEB?vk>=b9iG
ztm5lz;^o)MFDp631B~!ElYeACe;^35`67!MW;JKb34&(M
zXE#SV%t=O>@WCJ`+3nn5n9Yp)v2|Y;1Q}e&0&Zpnm!-QN4}Vynv16V*u;C*?5Z~_p
zkRgsu9}WC{d3pSpb#ToB>)_xG=E2&9=D~Yz)Sr7|LVsjFZ(d{^{+uc1^9pkqb5ju1
zaL)e|c0O=*mG$GlyIdzJO`K#naULg4oH%iz;hKsYDo&g+}A6
zKF{a*Jb%w~o_j9WPOi(j4sgAV>oM%KaLxKY{ex>E*StdNm1{lMCa!~AySPTKz;CV=
z*Dc>6OF!dUz}32%dg5BmwSnt)t{q&{iir=`Nv@+@FS~|z`UB<<
zt`^syb1mfh2G>fiZ*y(r`oAkFAJ=8qQa-Mq=Q_sqajvl)j9*-{xsGuy;`$cXDz2B6
z(7w5@=i1G61J`|AJGma=nsOcW`a|YvuDM(v;9ANx&b5~7>{YaHt{>;xE1c^v*TY;V
zxF)!!_i^8JJ?(<)gIvqFZs%Gj>7~S-Yc1D4t{b=>;yTGS&b9nQ#O+74ORfc67v4_X
zxbDA;a&vvMnsRepd^hFh+QoH@>+iY7cH#%uOs=0@hd$R9t|eUKTx+;)_!xe3-T86y
z<@(9>v?s3jb4`Did4g*m*B-7#Tzfx3+_=77OS|HF@jc|vb>V&F&vk(75w34NkVs_g
zqTg3*Od=54sb1f1V4Yw`e-wLa-IEU+85WgkI}xk4z!`i
zwPp+P#y|PXu>U_2nRWl_$gKMGS*NERpW4b-II>C4;$QpJKNAD*=EI!ytL9{`Jn6(w
zr#40|pZCE<@6TQ!sv=XwzqS)66K6}p6?4)zMOVCg_H7vAKZRHE@2l_ut{#v6#1;_V
z#J>-uO(vFT{&8Pll4sptT4H;6{MY~e8b^$@pW^Gz<0caia*e&Xm;u1`;mU_nqW3y>
zM5cs)X|pF2S5dy$v&nKP%VybvB3H-1MaNGj-kXBl<4Ughp_G&pQarzxVdu0HCKC@K
z@8ucY;PDFhW0d>uBwl56i?jy#AK;(XTzq!RE;60SEG9N*X_*S!grwN<9YiJ1)8sO
z@)kY{AAp~v`AVNhsAJJLaSPrFKc5(S`KRRAjYaGi!k?ZqnP9k3yf-R22(N?}ojjSi
zgwLLSos+*sQX~8}0~Zx(k1=HGkm098BeBzS{rZ!(@`hiQA>@|N4Q`JT^KtmM;ku3^
zu}I__Gtx3h`-)1Fa^#S*Y#Q9>gcpu(jHQBV!Mg7deVNxXD>$4Ub|qz
zyWn$9nM~ZC#BcHVAbb^kc2XV9^6F>|o}V$9u(bY1{J6!A3+LG`KVR!t`}#%j<=8jz
zDtIaUYONn#?)l#YuZLf%dA)DH3%&(@Vp92Ld*vI1Z+y>W;ul&!I_TLSgXf+)nV7Hn
z&A$EEY<_$5s>#G$&9C!$HhdA>)JKZor@`lF{cC*vD){m6b2WE{LA#GM!P7%{7knQ4
zeOkZLv2T%<4Y%Oe@;N34MZIz2DqBd}&=F*ck$Hg6KEKc7smIgK;2+f7!M2Y%@aN$6
zd^v6ZdcTat@ILt2T3^k9)$m;*ycymPPnrYi-_p#)|8DpJ_#N7Q)R_o`?}MjbP2W#y
zBOB~CV!?~yb;XkjepWUTJ9>_a(WDoHG$!nlYl6oQ$s-ru8^TNA87qVPf%q_l4-4SZ
z4r6u72h|o^v5|$$naFtcYI2iyfH+-6~2wJ@N#Yce&2pCyaIhwI~|7ChuEKh*TGHY
zOFto8KMyYYrt+1-CB7#6wf{lC)zvrI?}bbKn(Pn%2mJ|G-()}i#0bAzV78wJm;6oo
zrLMk-*TSnp^jqPTA^G?I2mN7J-<1CZT-r|%mzdVVZ%b#aW<3-8-P!&)!B~`XroF7O
z`(Xi#h)UY2j0;{ry~$~(7D>A#ANWOL=ZDHpN}jhiYQV;N<~5P`Y^Zs;13tufvrzLp
zoIJ$WEchy!SDD{pH>f;H@b%*3Y(bGLl6+2^OsrsRj9sqeq)eCCLuAB4E{*$~hv!Wu
z#`IcFWL|N~Ei!q?tUO~f@#mQ`zw={LhD@q8nW#tJE0=pCl0(u#{HcV0JBB|$Tj0m|
z+RZ7C##)YhXm-k1Vt6mUN3iuu_GIE!@%?v7R{T2X_%3oe$h9ti)FY4H&G}#%5em}g8Io&i@j=0=zN7Hq!=CWh(
zcJzb#m)OtZreRwMUk2}j--)c(7NX9gNAxS;N8qOX8{p$1_B-Hjh46lOJS6`S_%g%z
zA^shMFAw2aC$nyXo65Hg-U2t3uL9m0V!r{tC4_gtJ3{RD!#hLtN8nExxFzL>_rR}V
zPW0+e`o!fYczw&_rr@O;7*`PSWIkhTCuZ?zR&A>
zBC+-vc7ErN5xbC!FPThyMDqKhl3Ur5@=z?LL~^vS*GPW37fmMCrSKoqeN^VJoBe&J
zE@bY*CsR8cgx?Q;FD5)2tNl6}gWnUvW8BoNg9qJzT9|A?zZouj7_q;e;n#t?k0E`j
z7#rU}<~%-oKDc{8!mHuka8ntY;XUx6xQl+bt8e1_;9UlN3;kkvC;Ub}$Iek@h*R+wk*gMCR4$e2&*Lem+H~
zvTnG;+XDg8J$QBVVZR@Y!|#Ec
z?hVuEK=;9=9zA_`Ju2F?88HX=~
zvwZjajoPP7V{*xWoBB;I{Nxb(CGb<=LHn#0S=PYk!k^Op;%a+6uvI#b#JUxkw!6)-
z?1gWIQxv}pYK$9p^-VFDfNw$HRK|3i2+KbY9+rQpt8dD`7B2Y*ja?Q+692ZrZ{&0A
zr|c->^;R`T-3
zT4|RzIPK0NxeGhh$k_As8QP9BkAfrB*m(>YZn=Cr>N!+1d}9djhTmi07AE(>*T8Sp
z_GkE6f=mZ8E0BqOCc}@d^T;wHbyAB=KQbSojmBub&9
zWIlW?+~jK+e02z~gI@+;8{yAeL*HR{D2YWIya^suR^ff{4e+2?f+G3+UklvskF!-d
z-F3Ryh$FKT8Pi;lc^3T|z8G20$Ge?AFZu=W9dJ_&%HiAKtF(U9nQTPA9zGP3e>;44
zNdCLv`$F7o)==j9=-@3v?h}F(GFh^?@MYw&v<=g7d(28
z`I+q@_)+xPhVa|3dZrtPzXrcu^Qiw!J(B@rA@)m>_|;zi1@P4&yd1s(9<&y++dsSk
zjvKyz>Un89yb*3`uGXx(TuwFm`syC(5PV~Z{WyFR{2HwvE%M5j$z<>he2M1jOi}@S
zFWi)WIeaiA|9beo5Z(?Sf}8x?1^*}9b;YRrP}{b`Quj{z5p)kEN^^s*FA(L
zQV%bOUmm5OJfG&zCo)%Dw#xBn9DQ-Ujh#*lZE|pcs2Y|%H)+<_WztmQuaKXeoiFvxedYd
zg4oD|*TP@nvu8urJHvi#%aB?4S@ZLXI`}HMsc*Hx?}vYIMjoGZMjthCe*hMx$R>k#kwQJv5m(eilO0
zYmt*7G$2)`9ycvnMk~=;BUc;lequt^XB%@
z1-}YzY7c|(JK(0Z%ozOo5FTUEcp02->c_x6UnBl!!;9eDn)zIvc_@Mx!dbriT|2-|gy+M{wS8xeZ?|eG!x3bvky)W--1{Djv{W{(Tj0Oe
zT
zq#<|*+_dH%hwl&3PveGSX9&-Qe-myhUkSVwZt}kdekjC#3w#i6^1lcE7TmOE8iG&4
zgZz_uxCA~1zm?Ci%a2Q%)2H_{B+eO&8IPLH<5fO
za7g*#_l59-@M^dz|D*73_?f!?)ET>sJcrNG+}$UYb|n67LEmmiDJjNwRDqo#foD`5U!>I4H;vJ?@OJc9X??XX(h7eb&QjgC
z?@VF#TB{d66vBt$FNN?4_@NM<{(kl~;B$5U>b^M-J{-bJ;d|k-H|?z_)pO2T_(+I;
zEBrtR?}ZP9@L~9lko+g$5a(TrxnDA`Rcqmk;V0?%sD1EO
z_i+(=*b$HOY
zW5LVdhv0W=eP=ytpO6$A^~k)p)tpB=ybf;4V;6i4JS>k9WWI?^(7IdvJOxkNxnQ|%_=hA^5b2EO!{NyHc@}BLwlY3tkGpVFq`H
z4SQVJhfE_frg$BJuZLed)5aBkInqAB_g;`$tYy^LmJ9zDoFUZj+wSvVi=+~GA3V&@
zT4ctMG2JV*!v736m7^Cv3^&!8w5@~4^gM2^kE8HIa8n=8D8NWtaDCYAAHD#74PxFH
z7xnkf%HY?+gUTTKb?{5z48^{_+FNV;5Bh!ZrRbaXCl12P;5Taf>Y3hA_`~q9{fSHl
z@F%yJ>!|?V2{)Co9KJb3zaIXGLEpmfcKH49uzK!C=Ekp@>v06W0Up$^q#lmJJK?4>
zWD(%aa8sO@0lML)I9I@5g@^68H6j!Ln)wVwCw%GF;Ij!5rvZ2+ynW`{Y_q>M8$;&c
z*UjTkjE$A&;q$QPwP$r-oDCm<2gONzD1tu?KSlfCtm}@SUe{G4v#ld||3T`a8NL^8
z@}V2v4-fJ|^!LHHhwvltc6iXZBV|Zk#+n`;w#LmxCV!hbjwSGgaMSnjYT#*41pAPM
z4=wN$;6Y^+AA8_&?1zov!^l|JFs(l);3vX!u;E
ztoP^mZK~i>cxSM$S(q+|zZFuJdiW?jY5taZRecw#0~w1vn7VvlWfPeHwD{K#zZf3Y
z_D7M~{!R0qROB-HF#JL6d1X~=9Sc7DNprg_gh${(bGrqqgujLTU3~WJOF7*$N)oFk
zWHyE5(FJb|;e+t|;UCs{M4c}+i2X76GjP*AMeOoOH`@yUjFz^~BdYw*`iMesfFpm{*z
zR|P)`KSS%Q{oy9~Kj17!{rJ`T_PgM-zh%B>7=%xvA2fDam>h#oz{BntQYl=mArG;U
z1FwXK*(gC~6d98rHSkydgN;^XZs{_|x)yMT*{XP#kbAlQW^YI_%LFgkJ9I#_v^GCnZ3x&*D`ACYZpJ@rg3Q(eEw7B
zK6?nB4!>U8k2*J+7HM&KA>1@BiA>fC)(yz);B!(roGp9%zM~MCHQ$*`6ls~y`eXC}
z`D}u7+Z~CW#*db&`9y9lq|TbK@fBo(<~`wE@P|V9ApDaCZlOO0uY^CqXD@%}e$@Wv
ztH`8MfL+LRr6?Jh^R}kgg%Lk;ktz6|d44Z}&+nNrKS!MnddZ^(z7l>NpFKaMU99li
zMJqCO1{>l-FZ>C(Y5!mtz8M~Lk0$yP|3N?f%5eQWcv$|W|3SYtMBl={R#*RKJ}1RU
zeb>AXnL$I0#KuAR1U$?}9GQjR53VbTQ|47XD}tNGkpg%rJgCiPqrVILm%-P}qTQdv
zj}EJLpHl9xqZ+YO|FpRucf!}fgT_?xa{yiyqCX11F+@LdHRXT@l|$@X@XO$L@!2aw
zbdA?13gMp*(XWKx3%@%_-+A~c_8Z~-A@)1rDbJYw8-V{K#QrFJDf&TsK$3riO@I~f
z^R$0!{r+gdSHVqdqe6Hg+_c`Vgy+Id<9s805!@92PIx9fX-_4(%8UO1{93rFzmLKz
z4E8N4Gn*JI;p=qyow3nAjU+M3My3^+#ac$~3l+h)h4@efe+G^#stq}Vp4e}KAA&E?
zT%Bd=g1-Vc^~FI~KPZM4Hpk%4qkpHiKVv^KbtP-8UUNOi|Xlt(fAFg&62kg?s}
zOO$ffAhU-&Onb*I@Yms{IQ78i{=mGSF$B+tQ(P5ie_v`Gek(kv4B}rJH_w4gOKh)w!Ayco+O+&DFV@8u%8tsV}v_o8dug7V)nKz6*Y~wy)024Z-{2rudG-
zkHAgsEDgoi;Y^W!{M@ySO(3%inXolo1`Cv{erS$EK71YA6vr}n4VWQ{E`ztiP3@%u-UrXodANHm7HJLee)wyeJLA$TQV@wlCo&s;
z6kO-R2jDgEp!J{yAB9)IDQ4n#a=nuo!8T7@^
zQg{{I_VYJ~jecf+h&g?i+0O!aE8OH~IsD-e{d#yqh<-c#K7+oLBNJW?x65&!xg4X&
zJ^5pEIU=ih)B`t_!-8)P(JzEIhUizq?}wY(Wh1;9ZfcjE@E^c~+NDJt2H<<(m3%gh
zV`Ip?jZDxuWuX>haXEi?_&Ah<%qTLZb!;*GRrp-(hdMV<4IhTj(fk^}e>KDRz~8Sq
zeMh>mMOrufCAjGxUi!`uGK+o^JdOz;hu;V{`IuJ5?LY|6g)a@^CGcE$P@EzoPKO26L_D}8Q*1`+mLH$|$YlUA4H?`4T_y^!T&hq1XpWly$
z;j2UJPrz@7KdAN9^N#eJ2p`-OpFH?>_+3f*{(e9y{2w9uweUZ|?@rS9_XAqtIsX;h
zMKV{%N}!CA`BF5a8rA;;G5v4
zvKGSYLU<*7O-TNY@X8SVPWUQ=zD4;4;3e=+^Vu73WNoVMTgQ;;M8-5`#BO2j8p5;T
zdCvvwiw{NcdU(?MS$w#{@0ZocbRuJ_(m!cF6SjcwY$rRfv8i{3meJc;5(*4Vv3WC;T1sgZhm{%m(1|(SKUU&$)+wQd&V4>0`)r
zhvX5vjW!y>v*8_ZQyVRU?+nqeg7?BrZMX^E4>z@eF8IrEQymP#&-nR_H34mK`ulQY
z@B+BR%NrxrcS&QnJKWR;vf&HSKUwR$`+8!t2>xC;Lzr)0#y_<`P>oCpGNyjg48H?z
z@}V1E8lt}sz81bp`=HKMAAz?S>|5xhR`PvW_&TjWV;?*hnSBNu(#}fYJ41L4ybErc
z_gmmYaGI+hM|bUNkGyiH^q1YJ`lpw*RU3VpFvr@_^GoR
zdGNo4|uLIT*
z(SJ{mi^q^n*%!Rlw#X}sMe=d*BwuFqi9%$qMaFbLR0%JGe-e9MJfqGHq3q*~;=@xe
zj~%c4mGR>)e;)6~&IEFoYdh|m*dlEoJpC8p^T0SVTagK}A?unN_-?ozyDtof#;%}>
zIbpxKACDItq`%
z7wLS|JEI~z%t?a>jqPIJg8w_D9EI=`&^L`ImGC(FwK{+GzVb$RG5Tj}?tT|b;t+B9
zMn1;Qe$lTJiG#Z@B62y%J&7GVUdPXnQ}LQW?hnYB>Lqv&%x(uuGa9o;6H|&;(iGJ9e9)0k2(*tB+oef
z#9x{1XR_EhE`%4r6WBMkn{xP`v3~}BXWAnFdiamwCu;wkqcW0WuiHA1S@Ayi
z(YMX};qyZH2z(CwB(1N$YjX_#&a39JIIEg5CxkD9ABNA@_SG4#3iv4ebj{WCr3UyP
z;NR0c`jj`AQ@~9_Qgxq@%PbPjRa`R`%
z?f2zskb8cN{ma?NouK5L_f%Xo8;jC*@>$Fuetj~LtNl`Abs7B45MBp=JA}8vXTQPs
z@tMQCzL8?thh`-IK6u)=d7t$lJP%%_{d3O
zh1P*Y+z0q=t+t<~NA;dFTV$0Cux!QUnN{E1FB
zX@^M*Dy!%e1?ZH!I_+X)`s`Emal2rmQxCso$p0-Ki?kNfR+DxU?bOpD9x2y3ZB+Dn
zk@@@qUr+oSBy9s}t$g@3nMNh>E!_H{hp>@`%%rP829rU{u1!;^{M^4XJ-cJNE59psRlicH?GxsR4U
zymz19UZ&sq_7T4y=OerRH2?n<8HGb4cHk$&Q#tG_#ya}I-jWX{!`KEhyOc-kH8l&1{Eji`{%BX!B@gf
z<;?m7&nDrEwZ3|$z6`zvey`^0y{Hv%86z*%++DL-q=|p2f16BvfX}fHKkwIzqcHC>}pYTG>)&8LcuZNrN2Mgh!f(OOO
z!e%A>A@~#8zO=`$IDK1uXhP#9^`}AAA_F@XKAY1v;RJ%7>nKY
z@SuJr`q?fIx>pfi1n)#YXk3*3ApZRb{xv?w9^%*frso5R!$%ekS||&DB}SarkQZHJamt3_((kw0k0v2jCBCuAYtM!VkgE)m*I!O5lGs
z*tgIT|4x{2;vDh~$W2(zucn19a+6U)V#LoN=KPN(nO5wM`P5rSJUJ{ajEBvD&`S-%thu9y6SHMmEbpn1f{C(Pg
z^{%J%I>-M-nydTeJa~0T{-y96;imZ3!fW9tY5VG)q!oTU{2a~K`0?$9uZ7>Lxq7}m
z4DW)Uthu{aEA49nz6HKXbM@}=^iT1mh9zdf1YO*E0%?mfOQGEdZVud|nX
zojp!fi+mRL4pEP1iu|``$hRWD1Nq-L@{<2J^85a6Zu@EVJWG4Wc~7$+%Li=(68~Iy
zD?E+Q@+WD9q&1T^U6+zi8EG3x3!10w`iFl}=}20$tHZ6g{U>%hNUKHeHEhB9yX}avCq~(!jvQrE1nqjAjv<_uQ+GQLcA0zE=G3xd&{eD|;+U2Wq4AJS-
z-__A+rKJ5YK2E2J?JCmVB<&P^pP4epzF`&K1V4P%RN@K{JBEEz
z+o^&dkIrgco<(*A*+=`^w3N!n|q{gBUo+j!b*8w2qBv3-H&>-^Y_!XJj4
z)>{!aE=1qNE%-XP%rRd6Df7IxTPS?tRH8bm|KDl%fAPN(zT=#!!1a&?Z-fsSIM`m#
zbRlzp;Z)-DlHkn)jb01};iGUFw>*BkAA>RY82oh2)jo9WvyQ%rXTwJf`jV&kx12J_
z@36;C+~v0~nRj+O>jMk9A>>}onR4DO5mj<2r`ST$E?UX!rE`1599EblLKHa_~zeuB_qth}-dq&BL?Htm&NZZF}FUHZId38_>FIi+B1FGS-
zgz#o~HQY2tbi-TWLHAu!2RZO9@U61goi6CGAt{%P|ehIR%t$lubQfJeaJ;d4z8E&b4U-kYU
zya#T&*KUCCfYU9NzVlFDeC&YFy==<(474Af7Q#p1v*8Q0ef7Q4WAIeCtPQaos0{%ATTdR5W4zG_jzzflzr@4B@+W}t+H@%y?
zAHLx78EseAj4S*yj3QHl%(FTV_ubrboU_aG9S>d<=d7E^XPXXVs2lY=#^$=v$~{
z!(V}iy=SNxnN`cpK2*aC;X!pRc{Ib9!cWoTnA7jQcWCt>vuMRs;5)pf9)`pRcu*d~
z$Kl0r)81U#7kHl%JgB{kkGb%Cc-T9#N|AY~$Q*}S_#oW$j;vPr_AAZ$z3>hL7axb=
zo8i0o?A5ijXJ^T1_v@p`EV#-Xr;KLC&JdmtKh?m+hcb9N{N|ZHsPmBZ$XtcYwOS_X
z3?5Qf?eKfxrZ&9`UIo8CN#EH>6#YZ+Hn^$J#^D2SQ=iTJBI_%7k+!d%)fK>BgXd_j
z#?Es1oA8S?ryi!yMc2bqt`2UC7CPismM$Yd0o%Mp2)
zwG2EcPLf9>`c?2t`5gPn_x*X$eU2ruF2cqJWRmJzednqQz6<_gWIaFC`?;Fne}kLq
zx(oiN5IzWh32y4wWAK3x9(#m$Cc#bPZ#KLqM862W6<(ZFK4%h=_*B97!cF5+6TBau
zr}d?w@ZX}}1s{T6uDN^mPugELd>n3{+dI9-uOsjKF#egx31kmk6C5iGTj?$M0>4Y=
z<-YGklEj~UWV*}D_fuu?QEXhDWW#ypXpwdhA5vFNB_8E-?2+&J{zjYaLW@j0HtsHzqPD`1#e*|9rq2RTeg-YsX#%*}^|1C$RltW^XD>AF65*2**%HbZy6kY=F
zfoE&3?!#-~y>Qcgc8jZT;yv(ggT6(cx$rLdjeL%M;Jd0_eMrJ!*Y^Z6FC!Dw7sW>U
zmzYE0YxwMyQQDna_vRxr=LWNlGI%OHKGVjVwi~t|^~j7MvslZhvjy$&*WvHeTs^1T
z1)qSg(A@n!6RC?s@C^Fs`I@_Xb{1*n@CESe_#8W_Tg9r_i&a)Db&AX!Z9|~w)%!{s;2YtYnycRc>VV%5->tdSMXw*n0c6rYY~I@(b-AewkuP)h
zfIN64=GS-B>39-H3too(lQl1K^0!DUgkJ@3)?9p4by0=Pc4SO--2~qSKT+FI_fcK&
zF8C_V)pt7v;V;1#YVO=-*==nMeh6NyxqFi&WsE(>|J@k81`wVN&xLr=+*@7EN;
zi{VQ(SKnc)g0F!~zx4W)dLMHWyd56)p5Sg|c9hTPmr>_tR(#wCKMKDxDUU+0EgylO
zcC&fECiQXpEIerKFZOfbv*D(8R1BB=gSdr$HT*CS@t~GbXJks@OFm+bVJ+N(2d%Hfek=SggT4jtg?|`+cT)cDAso_V
z?#)MLq+%+up3kulJn4_^(%xKAk*h%N9&CM6UT
zRMtSTbHAA!w|AU)Sje>@_ZD&yk;_nW(SO-O5{vS$;_I#Eved(0fhV0ONU4{lmOW;-
z!wYVoN@VEuSjtHr-v!UDoJzb%US2Gs`@Q@R!AC-P9Nuz=SwFL#=i6({yZ}B94~nH-
ze)ti%X-=z$AB1-&tyjP0tykOOm)&JvzleV&aC`mI{)Asw?pYd(uq;F7K4fm>bF5y=
z`0K&Q*J!iIn8s8KJ`6XF$%XJ^aMRpa3D2ZWia%aGsb{Z^E)NyIM1^vj@eRoX%oydQ2Fmz&_bL-f1g
zGOjGu`K$HCAY8@`sb??7YJD*VkHbyt3k$VsWafTs%K07B(r>8t35g|CL2=I~+o1Mnapqzn`AyWyreJiUYGGH}xz
zoCkjteiF94SgZ4UrLMkdj;@7oKtJf7z`|rJ{B!WIIk*p*0c1>b@ImJ-t!Z+Mwj#cCd$^f6I_1$Ms7HJl|4!%ZniG$h?C_-jOh>a?E4?I58
zhT0EkMy8QEU94r)7~Kt*I$xo=y2sonKEO?Lz!CT^xU@g7-@5nO(q>aTSzE$Q^H2`_
zNx11gSJqEGF1?XEh{VJ$9AY?WPV}ZODBRIZwv@f=W6`ZScRq-zA(s
zN$c)py+m4?B=9F`{hh4$RGO4yn6&+*1+5`PX9E7)8Mb5JbaZrnnWR0Z(I
zget$ccx|l&p7*KXHH+xiz%L8oE$|Y!>Df>Ze93+0wZsrS{eh{(Y1+RsKkno36W~Fy
z5&zPj3EnUA06YCqij4#}quo&z`e(FV_l|F71M
z9`)kf2cPrlsl*qO_(qQ(gx?2Wq`5l7eiYsq!ZW_b_#MLY;cX$j48ARd*TK6(cpH2N
z{6g)&x)1Jy55h0dT*dz&{2<(PAAS@*uinfvx>)DHtF?Xi9dkLPiGQh|VGR(a9o*37
zw*&8aLrP+L&$tp>k%K(dmQV0H4ig`4gReq+Lat
z%xV6Z;>>5lkHGujr)#dxfTez$@ee*%bM=fp2mU1dEX~ziSPbuiubzd#^thLDoqfM1
zK3BtEZb&X?18GB~eN@|Y_e(^l1Ag*@$>r=NEk;^U-H6UGykv&X7-^T0mNa%pAM*N3
z>?!UK;5(B1_`b)p;RPF}5-%k2y&f-u{|P>r#Gmtc75t&kP9^py@t=FV34VU#RN~9D
zCqH&A-W=Zr-?owcjHKA!?cECx!p9$)O8#w@=r+&(82l4W!RtYbEMwnc-wU2JAIY4h
zzSEt9%ywi<_ejO?ufUJjWn6B%V7Jd|cmq5=sSGE2WoU-ie10l%g4Vy%*YAek2){Kc
zM&)*lveC(bKmG;Ic%)FCS6lr)>73VIBsbR54cH|a3;@(?tRdViqm*iE^%~}%~`RvuJ`+ZjNc?27!@W1joc8jv%tP%ep
zr5D{U?4-At=ewpIMbMS?l-{Hrh1O7bRv?lI{AB10{_0@j%2>jn6`5%MN{*w7#HtT!T
zLx}z|cmf_&Pj>m?e}hY#@#wuTT&(`|4`SIz8e*}Js=IUJ62)qt{
zo#yJhX2;;)gqz}<)x+7(5dCHFHQzL^H!I*3@bh&3YCpFD-hurL&D9y94tOj4X3f>P
zl79Gp__aygKSMMEpM;z0=NNnpZt^ed`;3?H8_TBtGcz3itu|
zQq9%ARRjD8{0z<2ePsvyHTZnZ)w#fa_*e)ZfgcXx$KazOJnL!BtB3Gq@DX^>xNEn6
zxRl?trfPr>gzygdju74t?+W1~@GT+y7`z!Cw2qc>wgKJ_e@`mo>|ej=kNM7=Iy;q`
zmU0$7!#S+>sl<1*?}i7pGpVO+_*S@_9gTH1`}HLA;k%sqP~=LG+r)VE2A^Y(C^=`n
z@h2&8IxOP{{4CIu{$7KWA&0cbz7srFi0y7{FF@zr)NyS2Oxr25q_QpKYO#~r#d$m(
z3-NQQKX11olk@GV#J{ynO57HZyu`l?@nw~i_l+<3<&`t=_NgQ1o@fNQ^6ub$Kq==j
z_`UFV@mc<)oax*IRFf7oCW=lTe5Ov3tFuvzOyB!No$rl`zk}qnADedES1EsI#JvSO
zkA62f?wzD(9>_?qR
zU-Wz7Z-?j)!;iujXnl3&e*!)kVn4l)Gd<6m{m+BvhwxJPVz_C}u7y{_O>vc+noO~_zCbiT3?-S
z%X*gQhS;C0x!Mz227euXyXH}6VwSP80)8&`_4ry#+I-SX<7;bxPM52*Lg(Y&Pg&izCSNAY-~$NTne?4<{skdy4+RYx6nqil2l(%PB#o6`4ia
zhT3w!mq9&BIcxLkPe9?lTU
zy5ONkza7Z>;yh=4VIfzB+#cfm89vAAm7M#+GVwKYH|van;Jkzvz%6*t_$0g>J|F%d
zpS|%(os+7EH^5gU&9j$z^K3i3bFbO{F8BgNEF~5N@GSU$^EuZ3*`!!R?UkOh-iiE#
zdmMuuDTf6=1UJ=bA$$z}1!VnlZuI(1CA@?>8`fOL>E~?`dp>DGCXURLGiBNx8S$eV
znfsnMf5&|vJo3VfJy6N#Yrc(fWEzoqLFW_QYYRvoY5lA__XY2>S@2w!-$DEG$|`N^
zCV%Z(ip<(ynCFyQcs1PAM_b|R;ifU97hVrP3l}^e)IR(${C@cRHDB+?U;@4w{uRxm
ztzHb$|BLprKR5BD<`ya$duVTPwr72P@!=be4_Ud&#+Qlq*#Z_x4e-Cd6u$4?iA?@)%xkp)_!9WZIuCd6SL$mNo*kke
zd5%2_d^}O>t9x4uJ`4Q|G*{2s3gPJ?yb^vU{Curn?Z>DQo(o^Bxq9y331137U32x^
zY5;yQ+_Z)ng-iJ_(fVpmi45>;2yQB$1z!c5p
zU##_uRr%pP@G~`6dmEiD4=TTm^A@}t{fGD*``Krb$NA4V`B<=G_N_P;zKL^Ww@z5_QLmu
z=nup9z$G?bzjU8ti2aHGpr5|i(GM!4*cAV^Gk#t%i#Xm{pA_$u5BO`0UC0eG27L~l
z*bPc9>MW?lmj?1$z&K-ycL#hiJgDzj==Z~y!O6-mtHk?RKi;Fryn@VGT1L$mk)Ls&
z0G~5U*>E?F#77IhpYeef68nvJ?NXtI)opM@axczeMb4A&MZ$LvmKcmMdoHL
zg!2+la2PgC?=ae4aH1yg+mJy298Xx=NyWu}b
z^1sKc!x4DN?}Ph=lpnnYOR`-7@0
zzf8Hz*s@-kqb__P+H#u{pg*eZN13
zr2Zlj`6v8d&E0poh#$@97r)}}x&Qr>epzG;DRSmLiD@Zz*8jo0o~wm7z)kaeE4&)M
zD#;K3nR+jL3*1!BVR#dKsn%D|94Fx0;4;2=aZqRF)A#dC9d0@+FJ;U}=FLBv+jSZI
z4R~=<9{$);2S4RibBx;H3*e?Q_QBKPCi@5B1@NSHNj**P^BjfW0$-ElpR-ABk(TjG
zo=e03TXSh|?!JM@v}0qYyz>daJ-Cfh;#7g1USw|9cHI3zvC#nkJG@PE$>(9e
zU3MZ)o0p>e+QawtHuJB`&i%bzRH|sLE=P_iA>>-a0aQi(JZ`SyI
z0y`-w{uo(@ovOc>&)u}a%iuxzNG$u{kHV{y{J7J0RQN&oZw=gnABE3iqFIogK%e8VE`7<>hMo#sv+wkMK@#m40qk@>KeQSWXkgztghki`8n
zGL`VR;Ih8=;-uF0jqnNhEt*H28zjlU6Taw(S$_bY6T(N~3*n}I75Oz~gqy}s3qCi5
z7s6BErnXoKzZU*rQu$;ia`vAa;ob0{Iy_85!cm%@YQdGWsr
z-T)7Zq3|a7!|+dP`|e>|yZrD!z>VdH?}snd`fANL1|Nf;q`4ZaVh0&B;b&^D_TaKz
zZrVdAg1?Bq>0Yr4egtmvzX|>_yh-P;eygnuzV!9rdr67UAbbVfWPc341a69d?6&$+YVrEp{WhcAb}qxGZz>y2?$a4TVcuG%E}
z@I_i*JvZ)xm%y*nT%BVbgntHpeG+#XxRh@U-VHak-`MXMV?uZ~d?)R*G0DEO$tCuS
z;HOf*pGxBXJ7lWhHE>h=YJ%6pFVgzznNSyeGd!l(e$G4{mmtg9D+ihNv;po+dG>p!
zzxI+dVO9RxYXZ4l4#Xy!F#kX(eHS5nFlZUn|Zz{gF&
z{YH4vzn%B%dE8kZ*key8d=1>xHwNG}aMRp23SSR5jUAC!xKD+f_NXlQ%^~&+;U9qq
zt?w+#R|&rbo^;>h)Yn$24T(V$G9!#1^Z4w=z*z!1^FRFM5IzVWhMQtA27d{jqwPDl
z3%32(A9zLpH^m?ueh6-=gCh9hko>FQV{lU)G{MC`Q~q7>7enk1!ha1n)xj8C;uBT}
zsU!UU_>}qmNjdOMA-ov=y%1gve~U5Jw3piqkHbxEpxf0q)$u;~(U39x2z&x=igD^6
z*~c(&i*}O(ABUIgHsp-K_DV2|^b%w&O0h!AxaYKl*T9S5C7QbnW#KLG+7R9Y?|_@?
zc?iB0Zt~G0j|pTBAakwuLDuV6*h944A2MF$jA)1-`S1m^;(_Z889V#PV-7r%@i#Vp
zt3P(i7_8oH-hiEVkPGS;;%f(d9G-L!EWWDy#{pz=qw&Cd2eB~Nn=>FIuer)#V
zg4my!-&2C)D)o{L?}Ik3__-lOj>^pt>
z70E^F-ug4KK*rQY3*kH9mD*s;YcgYatjGnz|Y?pY*}IfBel
zWPYV(oVxz$bX}+YKc0=ui3je^81P1
z1DnD-;2m(@(4+Lf;_3IpPkm3^_}d>N@S#)V#&=>KgTEERvltjN-)q)i2EPox4fnkA
zDgP_r{UN*ozB)G^xbI|PvI9OZGoGl9D*Mt`Zj0J=ATk5U+%_+s;I`KHLE7rCoVF@5
zW5~=sJ)Ynjd`U7XpS442_qo)+(k8RwiF_@Sa)B4?9C*ta^!+669C(ttDu#E@k0<{&
zKuW)-UkzVrncH$Rd>K3&TV5>Hxvg$^A>6cwun%4WH|^0JfnNrHRNHsYgj%Gf9^t+p
zp7bn0;;7DBXSB{_B!WD&St%(`&-K8c4rfw3xD-}<~CLWABGob|J0eG8u$@-
z(0WYlx4;j>bF{v?Pw#=h4!=zE&-m?c2%fqyp135b{P}+Q;S0`*Cpxr#^s8R{(%v9{
z_!pA+Mvv#hSLT@gFM$`qPuKctJzN7XgfG!tJp*omuZCZ%xw}r3aUl)90bWP>VkhyY
znd!BVjEU>)Vn!_F4kEYz+<0Q=@%)FD={epmi`Xhhrs6`z_7k!7!iRiYvR_zmqE}{X
zob&X{%x$_5UJt(jn_gb)Y<0U&SHhd&YcyByZEl3`hnr&734b1L8W#utgZ`+iZ?Yfx
z8|#=5`xadCH|ZC;`X*ip-(%3Xh>7^O8-59&W7n7Z^`OpZcVXj2WESZds{Qdn_$%;B
zHCKCxWAHfqUd`3-RK?z8?zl8=d_Iy5zXg7d)?ee-aS?nCJZS$~`gIk&9&Up$8q=oJX3S^4#c#7@N5Kbx~Iv7Zx7)m@D8~2Wp6B0{kR6c
z)1Ysm(gN>>hwan$BC}|@*~ejc7Cfk}OCA&OQ{kuTw&v`|pCAoR;*{|g^XLlmK4v~V
z7ao*{=$FA4!sqbWi-UXaM0g!M10K{Cgtx)x!cFU_K6rYF{e$p#DB}v9zuJdA3O~!B
zZ=sX%KaTwz9V3}z=R0$(_*j5UMp4{&CaoMk&%h;*dbkB2(s?-bFfd&Y9mwpv(p=a5
z@ZIp)+D6JOZ`>GxcU~1fZbXhU{~~iOK6!QJt~sQf7JL#uS9A4jxDb8>e!b@EJJ^-*
z%&UX=zvuf|jLe*C%=J(WUjjGP
zV>3J-9@GxRhg5haT-G?T^RD*SNot)lgv@6`@)(CVz)kCnv?<1C_=m~Ei-kJtmJ1(;
zo9em*{t7%O*3wpM;Dhh^`LTPdKNJH|^g&&5S
z`br6WB*cCVd@@A81wH}4T>Iyq(YHwJfv2yGCwet^+G>}yM2Yb*G9Ac#Qp>2bR1@$w
z;ifuF|6j^r;1)LX;QI~sB}?(444KSp3;2;v;;B&#^ms6VPXk3h#nnRmf=!oQxRzr`;g_v{EOhd
za8voJ;B#(|C+<(ucP3uD{P1eH$-gf6PPobbAUvZoo@h$4?<|7t`iIxUKb6G&^NF#@
ztjGblDgSJE)*WVE1YZaLXp((r14i<%g7=2-Cio=$?j(KxjCvQmaE+M{!XFOdWAKA;
zlYg;Uvm*2EG~3UHSB3B*_|tIHnxhIHsWS5>_-eSxzb<%t2p@#M3jbJA{G3VMu7CKV
zkDALDi_VJF!K;(>@ATStHoPBh@~;RUU2C>q1uqHVP4F#nll?CENC+Q@vXA&15
zn&D$`(;UzZFQ|?u9!t`H)T^U?@a=Gu{Uh+>?vC5vqxIGpQRhZe@=xV(aRuCTAD<(9
zvw07<7+xO2tKnrKycu2^!n@%mA$%XaID{X84-udC<0$O(8Y|`T<0OExCa;DUt)~sJ
zR*n6+z+aO)=Y2C|#VT>iCsS^fTF1nnV6U>spCJ
z0eoQyFNbf%{`++P?w-6wT0LC+|Gnn)$>@s`0cTy@fy~oHJv^!15pTIAve2o8Z-KKU@nazM@lU_r
z+mN~E@!-86@v#rS4PLBmsAm-i;m^ZOG4GMuX1ce+sw~&>fx`$O>>5{-(%#H@fGKJerz`OEgc>T+d*C4juLe3PAG5EYK
z=DoMr39RqnXOO3tN4al58!q}m@v=}Uf~Ugo)cVf8jQx;KWU7%VMy7pcA9K&)icAYK
z{a=mS?{W70aQ4KHm!2qf--}F7yLoSa82%zW$XC&yfbW5uVwHa4tjKHd2a)xBP-lJf
z;48isY~Mnq6n-H*X)UP68}XqInGMJU?R5%ogKviy@!9i1?P>SH55RLYcb04R+;I^8
zGCU{-7CJ}agYX||eW$*@E43~%nQ5~kAKn^Iez(1p<2k=wEJNmPWP3|b2ksCrT{e1XFc+kG1@G|%=_=Q@(#wnjg
zS{-~pyjgRpSM`jp9ht@7h$n)c$%~C$@H+U$nKslIJc7(i$h=3(l=^-ggYSb^&K#3&
z^yhu+q*;;J6XvrIh43`^6FQIRRxj3-@D_Mb+p^GUgg3*pXZkSD_n}KMiY!AWXuT$Nngd@BH?13r;alMIkoDT^hn-l9
zel@%`gg3(P&MtyajF=^Y+2p;HEk32>h{-{8LYM><878U4D3Th<-7ABRpt*
zXqO+pK7=>JZ-EE3chT>LcZTG@555)ttd5^L`)~xlIs86&*g2C1
zWU9N(Yq<`13*6*GKYSBB$OkFI2)r&t{}_C|flC>(-sAWe)+Y*)c?=t-xw;a*2OiWO
z#K%T>FWj{6(g`1h2R$1S9|z!*@Bu!1?a^7wdC%|1ka_I8GuC@D->T>LsZ><6rQwZBF59_M5^J}!%c0q8Gcy^?}q1w@O|)kaMRd&1fCh9pPD%<
zG8-JO{p1>#MzuYWQ;a<(jK!`_1q*@LtWGcI-Xd??L8GWK1y}
zf{(zH?!DBr|8e-@o_OMMokw)DT}F$v8u*j&1ALCX{~UjQiT=Wtk!Qepr?C(Deg7G-
zq!p1?G$XB?v}Gzy`g#p%`J@G{+r>@`{Brp8^Lk0^baixEA8F?*IkCNuwE3j{kk8&Y
z;Qknh@FVaY@C!6o=d@G#F~Pm?lQdWFh{=JAzKIvZpM(=aKY#aq3X*>{eCyLZV@Tq6
z+KXJ_&G5s|1kbA$yc>SZz`^!?;1Dt+KQP-UfltEaIc@Bw_xbg!&QhnJ&b>AH1g+=g
z9{rqgdo+QStPK+&>_&0#u)gt$_
zl2hLe9Ti`Y>C(PnC&hmI1kbk7twN^i5Aj4dGO=~aj>v6u?!zR%+%vE>GUGXy_;kDD
zli2FT)}lYg6W`@??80PQ(I*_aJlG-R%4kQ=$B>(+>~!Yd2z{(?kBR
z^>IE$m&I8-Hi?%aGmOmYoz8beymlw$aK9fSK9(W#pU<(MD>?TC+tO|d=d)Jbo!m~#NIP#vS~Y2wN|ScbK-#IKnc8Uw{4DrvWaUrt
z>m}`!8EJ#09jDU7_94>Z_-@(*iNn{SW8#@-GM2zi_k#uSLvZOQUYyl$SC+$v;HKv@
z_3&3h^xNSF;M;Xwr+nKRFL%Mq`x$SkLoff7Q|!vK%MUNzGh=_m{Y^IEarh4SPqhEh
zopu8io@vnspNl6xo|J#Jmwy4gW5B#mS`L33{)r^}&V(cO>)|VZYTi$1hi`*7B$e;e
zUio&3{hyh?Z+Qsb@pJlplD^ZM?DE5{edaScnP<_D;X%)QMZW+p`sXFtU+DQ)4$s|h
zUN6l(ISY=y5HxA38qeA!qCo
ze~%zvI}}g+hR>dC^nh32sdVq`Uxn=dz!$-Tfcp<-niDzO=X45<2&EJY;-!=XY7#mm-&kotH#zo|5y%
zUFQU*lqrj0`DJ8H_dLts(F4KXC$!M7fNy~Rp3j~?&YJdD5_pkmL?-`5_FZ&8lks|m
zUw2)|ET?RzX*=%uJ}G-Pd>Ooo&oLR?b=jRIg+0%eAXksve~Vnf47oqqO~IbuGuVt=
z%A6@N@N79>w{qrx_{DI^+vDyWC^}`XevrSy>)`q52aWr}+u(&E_WR&PaFhLm@XJE%
zABC?Bv7f=RPSzhL`}y$V5c_5DvJm|`*S@j*@SD*$-HZ0Y?|_@`gAT$=;nE(w`f(R2
z65pfnHuwuke6KeaWGtjTy<+~ZSU$W9ZfSk@yIzu3=JGpdw&|PwHeHX*7;CNt+J@Ti
zZHK=GU#R&VejD8dABTTXbNY=Oo0T#if~T@pvou%VM~l1sCe5R(y%=P2`&Wp*=}cz<
zd?nnpUtSI`4dM0h8{z+-x$}?jYq}r*egA6HiZ;3+2;M5J$cQeh%!(o^Dk>_otjnq@
zDyyil&N9L>g0Rer=+er_2+A_cx~{@9!h#~R%%bbahzjfIDzmUOdC&X%eBFEB_n!OS
zJ=f>YZyyg2H|P0!z0T{r&d+=9x%chaFHoMbw8CrPKl1q3{E`zSHN{`FlP>XV*&a_@FtCZoIESwE%5u*{ADa|wdzo0>XDiC=6LeqbeW%8GE$H2
z$gD#~*3)iVHn#-K@v|2me``GO_ti#_=||=P)rR=8-t{HpDCVDG{WoO9mwaTlBXgW;
zN4bYCh3|xaPUY6CIOe!n10RC>J&zLm&G1*@o;GbA5i|8W;k)6wIk+Ew$lLlg%`W&H
z_!Fvs_U~~?{+UO!2LS(~%B`azX8!r`ZSccXuKboxDSSKJ@0_vB6*cg(9cgQBsfSyv
zdJwbXM+X7~vFD3x2sMNR!d_-?qaZI8hx;J2#!;YQPboV4s?
zSZln)`^M_p4nHGH%;lY#M-eh@@A^OEl(Ke{$7ArtoOzGF#hq}f9OiE{N1VJGurs)G
zJo&oni^OEWiiwoB1DV_Y;ot7!@ILqk_y_4W-nMLr%uZxhywCf!>0|P>)|hP84>Elp
zutq~BdWPb&l)c22Ye8=JF502U6{N|XVabW#l{})^Z@2#am3sIRxZj?x-0QW$Z-Gza
zTK7CTb@$SZw!V&cz?TH*_rVv#{q8N|xKs?Ur;I=2I@-$vz*L=t+noBy;Ia4wGJfq!
zVlW3jWkP?yRsxU0{q7aShiZ5MT=uk_{H34U`&p7lGcpe$vt5-5|Jm`e6TWP6JV_IC
zZA3nAHVD!0hp$TL_Z)Y@Ti}PP_U-!v(a$Wf_-2)df9d3(51;ejaqaI7mBOEd>(*>F
z@bORe=M==h{gT$2C7R0v>r_1{>y|ETmawT#L+
zg{LG~ZY_f^hwIkvweV`V?wrC}_)55LUD*Y%f$RJqu=REO7NhV=^!HNB
zZ=Yk8_+-sx-59_N;Dzv&s($z)r;U`suLf2`^#Q!dM
za{wQJUk}%<`$yre8vQu-vkF;jzz5X)Wt@86EP^>76e2S(r1!BLJ_oLAqif)^;eKsE
zd}x7Z!9S;tbJjk$a}Kl{86&LEV>^5zz=v`87+lv6bH2oxTDafZM0_lQ&msSyvjLUJ
zEJ5aMo#~TT({oufw#kT*^_Y9_vB4
z=N^@|kb0&)AO1SruO6kXR>HRi@OtaY!CTykLU3Vz=d+9CHsj(@TqKEb^YYC`7eX?v1CQ)MD;mH=v!PbV@v_TH1c
zo@>WW*!lpR@P7CL%Bg#%x(oh&c%bL6x-V5Ktb#&`gcU>jp
zdZ#-cWS+=6dZvF{lk()l?}Mx5SwLC~X_;{OCvxSaH7jWnziQGNNz=uz3I5|W+ikXv
znqL=b-&5qob{}c0NxO$@r~Kh{PWv8#zYo_vi;I4Rb!h<4gHOrYlgwA`+wTua{>AWF
z@VLtDy+(<@_$SlIGdR3*Ya=zY1Qmk3Rm5@CyQX2fPZdi+>-y
z79OXZPW>x;y(93Qhw1N6qbISK4A7$2jnqu%;Yy8W*i
zJFilXyVY{oH;88a!_S=Mt?ORWPDx7}B<%zx&8&aY3P{t||H&caD{!^0b4e2&HLZZO
zBa}3={z*HKv=2Ofzh@TAEI)a_2S1PfwCE2aZuw;nD0cVMnz56$ufCmh!ViJ3_T*!I
zryx#RKfDIMN}Y!o<08wgJrnVz44F;)?J>V89G$87B69Y3g{4e6r?CFZVGYW))25WY
z+#>jUaNU?(0pAJt89yvlV~w
zrxuyHhwRbr-L8dihRYdmC+^C-3|a73;c|Zytq!?u$=)M~lRk*dPGmf5b8Fpossvd4
z7)NH-p?kFV**T|%jQ!!d`YnPV2-n@`SHNe(b@vx_@OVJ}t?(n^y0vGwt*_(T;o@Hr
zWp(0cf0xEAKYT9yD=McCq@JJUoW@!Jew51XJ@z!Xz8U29y9
z!}3lK85`q!lFy{K>&M-8U4qQQ+4_5#YIreRw=d8He-&Ozeom~yXFB7-M);=zd@KCu
z!}a$%JK;;<$ExoO{wb=_@nR@D!0G$8z-$Az6<^j
zl}nu8vf?Z@nvwZcp8kHX6aGK|?}x90>-Ii&!Mim2;$!9+?9IS0PWMrHN2LIn9mvd6
zW$bS?iH$P&IDA0mQch+6WDPPMN9fy1i}(S*PPL)DgSr`R9I21fAp9fr{q_yS$1(V9
z^t)C2;^Sj(o6lLuy*V
zWn7jj;{Yh>Feph%K{PX#He7|cIhxfpn;fuNU^qXRL92-Vv3o?G|7*Uga
zqG!`4kkQpu9$aiJ5QWtK+O=-qEQW6j(653I!2SBJv|NK
zmyp?kyz9%~%#5TgS?AEEj?=Hx3g8D8r1@cIAo^wSV)&t|edQTzt<81!4Qt`0=>J{S
z5ASgN>w{*TO_luQpY@1Mr~CL&HgQs0}+aGCS-Ffxs&?@7L*#>;Fsk!NM1modKz
znPbn`WB$Hw^c(;7+M2LzNxAaRrJpR+-_MlVe5#sP#QKiE=-0sig}&eOh&a3%e!!Xf
z^@iB!LS_LnH*oEgSvl7~0KXqTTjk2R%29X+T-QFc%2;E==c@Y3Iqm}Z7P#)2QyIJm
z?l&jIu~`d$6dp8(w;(f$jBei944+=I$NOCn`#VWepM~%R@Lbwo^ud3*aiVQRW?B19
z;!7oRg^R5Hr05-rT-e=Hil4{x7i2v51lF3vJP|E*QjE;+knto5Q9DVRsICrp~vZ~)y+KJ4!&-OnfBR*y<2^kN<{d|bS=fF3?FX7s0chc9C
z`}tC2#*op)p$5JKuG`0LhVRzsiw~XfA@~#NK3GRo%<+8ynX5|mZD$nT48K6Np?qU2
z>wL~Y!sn=Cm+W&Lf_V`{}g>)AKMI%
zqAzXTsf!EUacU5r0l!h@%JaZ6_+{{YR9@=pXP0x|6~GJO4=vfFJs)2VZ-@KsIhy5%
zcfxh~x4`d(`?Yt`-wa<1*NtI=HrMHo!EZocw>O*pRoW2z05v}4R(vGp;@@KGC(1Y<
z{pLU2I*|Tg&lhpzdXPJsI6ldBv_z2$|Hd>XWoaO+k|oKTc9F
z{3H11)j7wS-wu-bP4XB)X3F{g1Av)`2<
z^9nM4>ukxR8onLwmxsi(2|fb%?0LBFb2B}T
zek=U-3-%;;aqZgwyIJp&Bzg28vvisNx?cA2hv4VJWtk=aL}!$=(@4`j*T|}1eHg$C
z;714WGWa0@ycRwSu4^Z2;kg043w|VAcP}#lzn!?1OMz2sPkS@QEI<5NxZl3G#4PLU
zR@~K?<&oBpj$hjqonrW3;3*wh+jo=COQa1(X@?j7!}VqH?U5fvn`1Xli98dv`)4Ei
zSA9c29(BN1z<-Qgw@kO0Z9)1@AN*B#gUV$rvfmw$WbvsKIpdpqlHZhdQAqL0>1UC1
zWR{aSSkc{0kSm@iEI!+U&HnQquNU(!}<1(lSZYwTXr_
z9kJbF>!jM2q-`WElxDk!v`_H68Scj0dH^MP55ZTUBliIgkL+(QynX}b6hr|C#6$7~%nzl>!e<7ZXC6D%oX5n!T1~r0MFZ3I2hi
zBevUYos?~{(?!}g1iDz#FghpI^b|crb>{_O*MGA4!5UNB+}^N%nH?
z(eKdj0TjY};JWpDIs7rW-pbeg&k7j+$0X
z+AT_&*sdV0p0pD^W6zhIv8N8c?mK(D-@}dEWforaTj4XlyT|uiMZ&w`H^BYsP-0vJ
zFRx?XWdAI>>TNg1);`<1snm8HIb#KDhwtx6R>inZwFT?`p(2Kiq?XmP@my*>QH{)px9IoSo8a%mJ@?Gk(N1%$&46b#?MaT1U-Xy5
zt{*bizHYi=$`v5jhujI2CwjLcC*#)9QX;Dlj3c-B$7%aI_U{8pnR70tp5eM@0!8p<
zjeZ>c3its0HLjhQiLWnPzDgeT$oznQ=(k@Ihqu9N;e%XzY`o;!=tU+@U(=l%7>1X^
zf1}z6cR6t|s@Ri(>&h924+ZcA@NMwfs(od@aXEZDe2&VkC6PH6HNc1Ay60T&@HYeU
z@BIw>!?yji)%@*euTlrbC9F^G)W0H)#)Z?fQMc
z(}w%tS7Y06?^5(f;Ee%1dMSM!zSLvidMQlw^WgpPxXP7%&tmxd_v!cJs^Gify63Eo
zw!V&cz~9s8oAnPb#Xob;@k+c!gIz8*2
zhn;oLR(S0?@>aQ&|1fJkAvSg)Q}+{nJIVYO-xG!ZUbPW<%9)e%;YY9ElYC2^=OV8=
zb9yQK{d@K#U-0OgkD1J|t_FVRPxbAn+2*=^$xiqL`X^BqrynS1BlF=o_u6M8_j=ux
zvCl?I3`UVT78%`ml(mZYn&3yPd0gVoHwEyyaNT%c1}}vBjaQO?EqpdyH{P#>9~xl4
z3w{{fZ@i6Te*hkbKcv=ywH7hI_$EG#A#*?d=?Jc!INHBWB0T#t&ilc2F)Dk&58ARrERmT4QeVnvb_&EGeDwp~E1-G7hka?(G
zzjhgdzY70_Y9s8vi<*Eh|CwGtcQx$*?$_6(4D;c)!F79gmGJriUJqXl*X_Z#!J9Pt
zaq{nhUjz57?IcF0x-l9?=6+=S+Pci0%i*`fa~Ln8Z?Mu%t&3#tnBmSHbFN??@_zp|
zE54M#Yv31it=b4HYrz_1I+4+x9c_j`3vX4&F7duTJCGEP!7R*PR^|AIp)M^`JhFHSkRMS3N#j2a-g;1%8@FKMvmv
zpAYx!$wF?l+dl;qCB8;qP(n=v!lndDkm8`jDx4)W2;CAAv6o
z;L)piKMU>`E78w`uYvou3E{=?l>xj8UJ<|>;fvs>V9P1vHCA0pAMJpzf`6=XpEH^L
z$QAuu-#2!_=fQR5$ow{IAGmH_%7^aR-C2%)xgWK|1Rs>=-YpE>%x6L^jc~^r)Ujl
zg*ACeopobt_b+%3C*$hliY@75i`;Rw0Xql&(*OC5*fHS8!VU512WfUbvFylw#8%{{
z{K|XZGDO;^U2dAhc$BnHNb`$>
zJ<%VB&w$TW?JMWJa;|0_9l(p=bK$F~7dQV)oO_`Pc>UwdLmpmda*1gj{I5@V>!z8s
zS4q3y6O*5sF%g|kc=>O=I=!TolD11NNBHk%oJ40Bp3~#i86z!=v~PKItY`P4ll@)3
zzX(_Bdk$%fN!wS|QO?koz>DF>soefHoV4Su;ye5sQQGnE`rVkxzT{%}dCFSsH1+OD
zo~qiZxB95mTNnIMxID^r<6dsYNb)Iwk37RO8|JlWU0Oa(*4$>+KXOZ+V-Ma_KhHb$
zms3aId0|g-!jsR(PWvo^Z-0>(d3e;Rs|xrtFS&7#<68}BPm*>C*N*QpZ`*q*BC{5m
z1Tue8?aG+(f@#{2XK~rcJlek}`RR1Z`0JNlTV=|(Z$lBjo_%=eSR?YBoEMcc??SKk
zFZ5Zio&3W$IDIPfdz1<8Syw3UT;{`L+ue2{ZDj#z6X>XIrJS@;(sX0Y8u+B5BX*i>
zos^w8X>Fvvhg?*Rg*Eq&i_=o3USyufrz5#`%5;(2UWVcMf8CS(zRJVaYgq5W
zgZ7y7keUCwe%>sGAFJV#M-@B{@8#O@(JF^|Qdi2+giKF>jg9cfG+fMzjeca>knxMV
zS^x0MM*P=W!ZWYsjAQ`MhhK{Qze$Fv`-Jdzr~Q<|^WM;(EfoKj!Z)HGz2im2#siLx
zwb*zQ8NX+1arC<21Mm;Ic6^XN^sZIsA~T3g+YswHwQoxwI@RpnW~|1M>0|yLQrlMK
zFHZl?sSg?cpev1@fsD^{zRz=V~L*ZZG)+IS;S`M4>%W%Trr0?qjMBF*XHq`!=}gR8N1vZao)klFr6OmYDL7X8oY>opT*enBlJla-
zU7^THUFTbCU6C6?ZolIvk{KemG)?YPx2~f%aQ{^}VXpC`XL#l8SEI}^xF5MEzci8j
zJhq)Nb_GuHr}Twg@Mkq#Vpaox34Vpd>_er_+?ZV`F%w%wH`4x!CXz8^oxCE3*h3_0(eP>-c8)CiG{j`gU2xzd`u@@YyO?&LoV%I|B5xZ{nL)
z0s4jTbpgB_-WtHyz&F6ZrTQ1P0wDgkz()f3X85ru`|C?R7Q*Y`f9E=S$?v`OZN2Jf
zKF3cWcfu(X&a-{VJL_ilut>XvYp0!rt%qYWFBQPQ15eFMqEk%TD$=SwIv1M_OLVH>
zo6>aZNZUx-Dvyr!piykL!ast0-Z{0;^@`1Icx-{!kABi70(5r4_fFF>*uV*s_EnD`
z){VX76NjIWrc+4T@HZxW=X3GB9G-~|x0`MZBi}X$Qn9%PUUjNB?oFgslGX!v<8FQ?
z&^rGFABUI9y!gN~u8fS)r&wd97+v}?#bc<$Hr_gTg8INWcIDfX*ueI0Lv=LG0?z#pX?KgE_)R{Mt}
z;w0t4=ivV&*U@L6Qe@n7Ejy7(B9n=X{F8o|AniYCX<0wy?1_>l{^yallQiA>y%_#)
zcxp@(+ZDEsnpQ*F-xN8q-9Xx_q+QIlTef9pMGJ3-?^iaF{Do&M*=Sat@LqVwd5jAl
z{WBf?VfX<2aFtu;jku&WGv~u~`w3?Gk!fEtq1`JkhHrxV{qBS4SHX`y-=B*Qjqv;7
z9b7vxkoLa8YVTrWBQmqgCz3CzGIoa$z7_uA1^PLEC;TJ0?u=N*j|lMB^lf|&JPJQR
z&EI|}Q1UN_j`%kR{$+SHyT^@#a(1T^8z&><*N@`p^}|nu
zuTb-lI99lE97U!MnPXKMzZ0%|23Bk9>(*v#;kTn-
ztmd!0@6rX|1o!OGT6>A7N+~7QgUAd8_&5fC8?N&q`^T)m;Brskv`1?>W7;o-?}8t!
zawW#)@b?4w8u(7Qt}V8}KY{CFxEVeQ*VWOWt$(`epMADO;xh(6utL8+&tA*(5%`&^
ze)u$JOeusH!F6p}{JQ{dw&kauaAT;n+9-x9A1sS?pbfn9ab51bzB5LAAOzu3iwyyerIRm_*@4shd-o_>(+gib55-dnQhFA
zetY*)k3H~tOZDww2>ung&c_7&*{DeT=aGJE8z>^x)|2m`nq=9X6LWt
zJ@7@?mv-j#Q>Bd!!K>hVseGY37AD|j@Rcf8&bj5@#eE)JTYmUjxbB==CAU7gx43bXdE;FxR^scN
z7GhaB5%>+nQe?u*{M)>=*BZD1*VR`u{6M(w*+(Zl6W)X^r@qBcWo#QjrWP4pJVxQm
z;JP-EbvJD)fEU2$!F6q>3|J$oUEHWW$4O%tt1^T;JX+;fKH<$DY$(!<(FWv>v_%{tFLx&u6y5
zi!Yk+{S8=i{D&XCVnTavYY6^TxbD1D0)A!y&uwKr3D@=4`S5a$ew;E@!WY7yQRg`N
zYee~OY6CJO7yJ7tHrnCa;6djN`;b}1^CDfJ8-dI7BtI^BMAtJWz&-b1GOj3RH|HR8
zFEYBbnObuBiYcjucLWR_o|Z!gW_2i$MIkoxX~{}z6(nuoo~8z-$F{yuz@
z%Ebq(Ntx@SQDo{?`me9e{=b3w0PYtn;RWz@@F{AYMnca0Xc@fzQhl4Og+C0}waK;c
z^#QyK-VE2Z$pQF78hwe;D7+PZc6yA=y9etzLH0e&smS=v5i)1CV51YBLkyy){?b$5
z>Y3q6?6g(;kA>n(J^VI!P`hhK<|Slw?XDL-45x{E{ZP&fk04XNO5g6HZ9KDt>)Kr&
zybG?Yvts!D8ZPCmg15kf`fw96b1u`jyN&SK0emYw7w+ey_^=Z`10Li<=1(byCJ(WZ
z4{w79jb~-ZoOrpvAJTtn;rVb~|5*#4wc39_TJ*c%XTtr~+~Q*ad=dO4uA`54x^2SV
zYY-b_$Xu+kAw2tD?!Dk&=h_*|!q#R-oTNf{dpehKM)~G#1v1-^@$@tM{I%p!2M=GN
zk5emr41K@)6#Z`adjWhqe7lBA8OGr+!FBCHWODCgJjTaOTsv_{8&4M?vkMu&{R;7O
zIXtUY->w_r)8Qp*9^uo?Nh3~LJA5vDxyr={<=eo0$gD=j&j+zF0>2afo@&F|GjYz4
zXS6d$T&W);=D?T0b@fpKFNW*Zebw-}aNT`O6MPw5*RC_*%i(6bKK)U*K9qLdkIeTp
zHl!|g!Rz6E?OJ%|&sdMa{hkHI;rZ}g>H2Byz6_b!SNXSlu~7?O3=ewmpaq#%z7t&M
z-N;P8+J7w|W!Vlt5$@L}gpb3Q!Tt8Q#Lt}j83W)!ZDu|)bH1yu^Gf)Ba9x|Jhi3%v
zHuwZS__ZnVu?M~r9@IaFk-3^Y{Nf-smcuu|&35(S!@lh*?}3o*j^E@NDes+DsRGN&p{#k7M627I~C!6rO|r
z$6PzH@_Cme=RxL|fP9MJ+u^!8t$;rd*WG8=!JmbnsQRJ2OVSD-3b5Y|e<{HJb~}Ha
z{c-p(`d6y?hple`NIS@3V{+~_{yYvZf;Yl1Q1xXjw7(-Mv93gBOMr~1n(ZIC5#)4x
z3LWs>@Cr4r@cGVtbRYc4YxVte1U?5&%XjNs`F*PB!>n)NmwLE$a7g^igO9@xRryl)
zzOLBjN2>fHmsi0*MPJuv8g2dkRsAKdeg}LM{b7}d-*C$h@2b~7n;L;X3h(vk|JKou
zZe-1P-9*waf2l|D?=<*jGJYKTfEz>VJ93eE>u1(uDRyqY-oGB=*r|ax!4FQqSNWW4
zV=Xc_d|zJ|UGSISy1E#!xvnlo;RERF>LTkA%f4SMq%9P{pGAL|YiImW>Y@yOLxa99
zYT@aUcZi)Zf27V2
z$XSxVn@8Bp`pkWlXKju8x|k22fa~g_(&oClsD~Rj>F0trcs^WLS3U3};rpp&i0oq)
zK@>b*`P5OTFE0)tj6fSc}Z7$YhEP|D+rpq`gGiF_Ms~tCg-!
zAN)0V>a2n2Y`1kzRdtm2h{oZ&(9x|~aymH&)}gQ4BAfg9B>7js=WFyOX5!!TTQ2Ji%U`EZJc&m;c5c4YjYpic&7@sV+DME)Qt^Zqp|`*+Q8jhN3#?;ej>+Mw7Of*%e~
z^$STGwRP0A=r1`JsK|-!9MZz1dG0O3zcA}acoDn>zMN~P4cITT39o<;!u_7{o9!Pz
zcECTS4M)e@TpLzf{771|*lEX3_s=JiU-RT+Ee_(O^}K5NcE%xeGG+V>g#{^=mL
z=KW?O`MR{9;}u)deg@q3lR$3gmWd=wRU7%
zGvcsX?DRe{ku0Q4PCioZqpfmFUMN{CEzE(Q*n@b7XR`|yIJb_uNzz+-LdEDRGXQq3E$t{&Bj(GJoL0%Hzb+k
z#~^taq{~^ZXp54E#H!bgmH2l*a`UB}*DG?76WsbIk0*QGJfz%%q-`QiTmSIi!BgcH
zos3^wIzQ#wsTcc{p>SNQXYI0e4e`Avf8cr
zMNP@K1ev~Vw13*IVsD@{~p?|NS3I0`h$}h>cjkFTdCRLkOz8{KVbNol<
z&|zUGq>+x?d#$0H)jjscfI4yvxKxJ()`-G
zS^w~Qc&dET*N5<9HEH{k7=3!38#lMFM`ax>vDk?I(tof|NgH<
zj7=nu^OV(^WF;2k@XSxR_v6~JVSm$Bc+L~tzrg3JT=_mm5j^)l`g61u@T1`es`}P+
zVaBQso(I>RUu=aR3!km(EAKFM!wcZL{m1R_L*NIi`pOyAari+2_H&*L83)64V?q&J
z%FouC8$YW(n&%heBv&GH@AyRW_o@#v$3Nk=nFeG|-s68BN^G>l=fNvf8)iQ4x77NO
zS%r+QtRwJh_>-y)`!`smO;y3e6ZZ4`q87J2(l+gHfW?u^|1D?8k-J#6Bjr)X$}(i;
zG8cXBf8#P$I-1y7gUswi+P#C=v7hP5*f5Sy%aAz>JJDklpWJnrxo0o_=V7n@zt&!D
z^b|!_Y+6eYv(4>7?s?>HMaOOPjb>#?o6lr%Qt;`7_ICjC;a9+?i9Y{iTw6d|Ra#m(
zX&LXEY{l@O!xwt^sZLz0;C~9>jqv}#Pxbge-|@c#o)en%zTc_*
zrb!>X6fXNuj(?H;%)wCn8-br0nbgK7`V{+H(aGd=)&DcxKAHz#3g27hB`z<9p9$~t
z})XC%*JmsHbmS5U;6h1p+GC5P$Z`a=8meCq-_{Oc(ulkXj
zzSm?jPxV9Q1?wjt%swzGGJ8*I$K|Z2dCwz&7r;Nwob(+RCDvu|L;$aaPr!B0x7NaU
z!FBUS7yLbVfm#=rS#=??Du90iKVM??owaVPBn}I$wXXO%j@<05$>if|tRkDtIuko}
z@F!+XCNG9Zi_`2}V9m2KPPHR9mOYtVA#%s3$$iz5L(E)<_al4s{=`nkv;!4c8E3Q2
z>NeuYjv*J%nKa)AipCVV@O@@MvykcTON^dX|1H`#+Y632jHpkMB-pPW9gL3
zb!shP_brJ-13LZa+$%m`_hVPaYI}Ez*WynJc1}Cc>rW+VCz9rO&nPzjlgVqr4wt#b{@rs)7T-I`^XS==$(y*2wkvsxti4VYxk2Qb
zko$v_u}P7$V){%frfuZ=g*nRp{Ga^4nu>Am?^!Q@elj^#z3+*H%}r*B+kE)R`IE^iu3cX)G<^|X3BLgz
zSNS(gY>q|sHvfvs@m0bq`fc!g(f9DHEq!S}J@6;ssrDl}1Ef7hnywFw`shUaEFImL
zlm~CeCXdeDaz^em11fnI!}E@vG=B%jjl(-m9ID{E;GX9m;kz8(2(LOWZA>E$EA2RR
zz?T(HYWErX;N|ESb
z6E>pwaFw*#1Df4@q-|AOZA)TNhMmP<(vRP@@DjLgt-2O|27HF<$602mOh3Eeg#mm3
zJ{!J4)eqlo8i?EewZV_#I=cLaZaJ!~JVYk@dG_6qd4Ovto|H4Z-u0shnc4IF#~+DT
zH-0RJuaI~pZ}ZrRRJieKz)sT%lfK^$h-0T6J^*Ld_t*&E;`-8u%*jQp4?OL2y3;;K
z;C-jEE>LY)-PDX}^aZ|U1wTmT%K5rHxajM6F}yc`SHT~{KfgIf+Ds#S2mH%w{>pny
z9q2O~~eAAAh{p~`9B>bFsLB2$Eqy64&%TUq~GFhR@NM4IwnQmkX
zPo6aQQyqUrW|Ji&aUDXYe!-;nJ;h4+2DrpMdTo*ACkuc
z_$b`7PkPvsJF_6AZ&M;on!e
z{rx}DH(uhKcmeux_-eRryjlRSfghpTSKb$14!;U6YZ51Z7rTA80e%hKZ@v=$+Tk|`
z8`qo1Lu^)%Ot>JO_
z0(jQxlY#F^RUz{fGJbnWl1C%F2d;Y$ssp~LSU*1Y!7qmEVmtyrFMvl`h@Jx1u7BXi
z2k>He9$YtmSHVx#=t~S6;RWykuAM%@7^1#Av=NyhjSY$6R`@G$-8ixnz7_5lqd58*
zukfq}uG_bgJo1rw=nQ=xrSNvRUml`g1HT=9B-c(kt*&Iw!_Dv(c(uyI)?gv}o$w*J
zuAchguV{E2{ax^0c(-a_;{2F99%cQJwd6v584KWx;eKbt#m6#uBYcWFcPZ~j)xuYu
zIq7@;ReW3vUk5)Y-N(~iA2%b@tFa+I48nK8b#WSlzX{j%`RoDSl_~LGPmBFR_*}TI
zt(C*`;a^HCgKSfX{u=mcaNV5Q0xyT_{ND^;7{CYNMQ~j^9D^ST_nR~0wtsWrCvhFU
zw83qw%DV
z#zbr1zfXFC_}GI?*;)D+4#7``>&`eQ;A`Q2?Lh43{+YD{d?wdU9V*Yq=fi&h-&f_z
zH^D36SHt&FxqUub?AODq;RPzU_wt0d!Rz3ESGm2YH_H!Sut?tqhTwDIy8ILHJh-;}
zgY*;l&%!v6+8c|sIeUcS-^Nnz&1A3f^y^$1S)m`9yCc)A^}fjEBR7nl4@Bp6Mb2tBZ;3;)Z!(751LwK>N}^j$S{rHi
zGj2zJm986EC%MFtD|n6PljpM+rjGC8$CZ{JQr>c8R+mpE-&18GZ<_*=*C2TnUO>G|
zUSC)8lDOGt?Zi$ScIJOAVE+gHHMnR0hqO}C{MOS__R%yQ@u$kxG576;uJy!M-M4E-
z?on);@$FOO(&Agbjq_C%ZhWOI)ugQ?&2QgMeAtQY4e+a_EnTD7w$6iIDy>QEbYW-b
zHzt#pd)j2R*(QY#z~?Q~$7~dS9$bxC^e@aOr1`}x8=HA>Rfi;V{FzVsY3Lm<390^J
zy+UE`Gxm^IIlM&b`IT#28EG#kTkR!|Y9n^mTsWEhXsTjIWOhz9`;f?Nl)NsTOunCy
zCNrF2%1GJ!k;$l?Ob&DH_@kUn-v!?azuLpCO+|D!OD<{q0+HmwElcuA>^WmRf
z<$tdwb=Zmh%x_z3pXiS7xjs;qaKd!cjN2OQypNpjo~;Ew4)?1M$tN2gT{D?{k$u@{
zlai0sR-R0qog6~$q3`ME&;+~#uA4)1|H@h{fX|0F!FA(nCH$HI{d#x}{8-B5#9R3m
zR~!8OHve%^`f?BauW*i!nE%Z7Pg*}|dr3;FP1^UfX8(sjuIQNkpR`%{ksg`jj-r|^RM(!izszq*zA{V*XY$Ia7>~;Fzwch?!MOr>-e)TCjjqnrTYB^d-JDRi`
z$jd25-JWsxSGZ75q&99J~~M2z)*IPWi(v
zPTQz~x55uqx$+)av(0tmQ78O1^!@s_l&K$nHC#6y?Sfas{nlBcpZO+j8}66C?B9uh
zH?&SB510P`lkd1?wBMhM>}xhtBaUo0veyv5N4bt(r^tpMbmCD@e#Qp>aY1af!874k
zs_nAmN0H`eq)J+yj9tCREM+{aR%KHDEVbIE$n8XK!@ZN5`(O_*iXH0
zGI<);P90unx@^wrYq7JieKOezjy|%+m65UXeoId5RAA>NxLJ>?@_ti3jcWKtxL;cXn`LcAruMPPB%_5J53|3A<#CER
zhjbzHEHX!_GWN4eDa!!7AMO_mslQS9b~tydZXQnkh0PP5aZt`X^1E}4<#a=*o~^N`
zSz4{wYQt7X*QE8k+uLhhIqER=n-Stu6}ImDm41J?5#9;+^I7ye;N9?VaqajLwhAr0
z4<6p+-w%b4z{k)pP}^+e81n{QcyxsI^lv78e?u(}&w~%ZgX*OOnb}+P^->Mbhx?UL
z@@Rq=!9BmHV8wep74J@D4(txDJE@mK!kAee&l>n{%D0|6j~-X!`Y8S9$L8|DTnn`!xBLb6Eu^0n
zr^)TK=5|?2SMB6p?nQS$NYd&^o1K={Oxl4;n#7`=v{|J2)wS5^g&z!`#d|%J_o8^qZjqv3l311?v*<7WKE~nI@RQ;Dt1+-_?3G$G
zHH#mwbAO@wVSlS$>LU|A58fc{ZJgeny2q4ud9~Hv#Fs(jMu+^*`-q)#_!wNCnMeD)
zcI?kwn{mzkfPVTn|L2inrwu#H;Xf8TO=)&+vf?NHRAFZ;a-!q-Y@a`pv=Qv|!%csR
z)9jq)+Udm3Xn;TY@S-F3X6g<6NT5qt@xzbQR35&Tsv|)e@fvyQ~qS6*-`w-{wM8y
zSl?d?;mZPeIs7vC95pT%yY;vRz6QQRa@QO^c0jcsV@CM(%Fr0gVl*t2S&HJ0_Fc_NM*!u5{agjE^twZ5CMM`jC6<
zLtAd6znu8gOn#OBolLf4R&8_E(-&*cy$hM`pX%q<0r-vpJ__FjFCz;l5Bt5ZI7wL_
zayB@bww96DTCaPU<3b@aS0m$RLths+LS{GM}2d5hs=0lW%6C7kfx@0a#5f}h#&|H!z0
zPnBCQlqd2}cUs;(?7C)!x<1h&Cfa~Hg2A?uj
zABSufblCyC5I!5Oi$gg)3w|xWy7gckTo?b>z-u)2B@W`>HE^>%{FzZwnSa#w(1V>t
z)AVr|f?oyK#UTM7gzL(Y`)~Fd;JW&p4*Nq4~xtG2i
z9q=7+T{-&T#hLzoNW4ejO9FUwjCBlL7l%CfVz@32#qb*VIppQkmHoTfl7AI^J$$yx
z?K7%z(i-7yaL;%uW10QjN@O-7vlW@orOyra^M8@)N2Ysky^Q!Wip;|^{L3mfvOcDd
z!r$WBDU0~>nmd0NBC}*>LVLEQ99{}PShb;S$Qz8J1s9}L15
zz?;-k;}+VBpXETm^3+SC^h1+
zUh-RxoUZSPPb0`QBXbtlPT7?Gv+T29X;>t`a$?ykblFrs6m<
z`TOZ(lCy_;gzI8b1h0kr#UxI)74UoE_o;2xdIq^xMt+G)Ju(O8=;PJ~UjW|=S*INK
zm?&|}h3CV~xSdI9m3dN)TQPFo$Tgr7JuXeoj+^+CIYB)fppQvD{6x4eCZ+IlxL-RE
zfBW&{8o252)8EkgJBHkp18sjFPLosWxrh9gAt(2Rp0X?Vgu}?(jEt`B8_??^=dOC7*Zfzv>yc3!057Eac<5Sk4a9tjA;2YsVd6Xj4dZ<2+
z8u%bwcV@U5z8kLVOP%mH;eI|!8T;Y=aKG_V_%3)iTz4OvnWV47b^hhUN8mdDO5svI
zoqsj(XW=^kn&FSZb^dk2pAN{sAKnGm`M(P;<$&IJPN9SKYyaTTDuN1x|ApaWp
z09-c~G{gT1*TuIJ9$5eI!1{*=)_*8$yh#3@b#wSeXC0FdKR%we=MuICvpDUm6n;DW
z&@g`}b8%!}*(JC3uWFIGb+$f_weWwzufv36L&>8HzWDIqJO+_jbcB998-tg_b>mrf
zIBZ-1*NsPo@YVoc4u2hfucr*w%fr$S*T5@|)R(aZz6Bl>$8Kac&C&a~9X=Mo$Kmsi
zN@&0Nof8Qg*9Y(-`15exx}gI87W_yx1{b;Of;#wn0rp$r#~!WkYu)e#@Jm(u;T2{E
zaniQKZ-Jk!a#;gg%X0JHA%VEhK<)gL#7y+M1YLcc{MV5$N2jzya|38oKw)T8m8@rG>_}Ji>WN`qYI6y{xDMY3QnOd&hK5D(VA-o*k
z1J|{UHSpKqe&cW){TBG|;j6fI>|1B-&8J}^(~Zou+2#*n!~laKK1sbS;$
z@PoK^;(vkLcMIXy1n8H;tKnZz_01DZ)*P?~{vEjP{6P!+(g6L<@HGMX55iXj=#Rm#
z2*^J>BWzq0pkD}It;s)5nakmo@Su9CL+1Vf8L5XhWOi!u5#9se2G_-T2>uRS7v}{0
zwE+FxX<=hW0G|*4Fo0LW69K#)KJ9qD|84O7;C}trEI&LNpg#oP2d*tYJQARvJ3VY<
z1@QUsg9CUa{AhS1b>;LU`yrP2Uk|?>evgN*bJj|2@M&}P`aST=;X3^x_)fU4eI(!?
z2k_jz!bbRu`uyj^SHgAqSHjh{=1bJ_htF~9w;n!(zK*xSXB6w#Kt1p{e6DI=`9|ju
zd@lSzm4DS5$7MgN5sPYyUY~p~yw7A1;ymm6E-~
zM*F;k^F1<2t0b*8Ev=TcwMv@wgGSPtNIQmW$A^`cpJJy2eiwY2aQ;bJx2>b5^^-s-woH@i}b<^ikPd_b48K;~Tw;D&Bqy_LYSeu`!?`L`NFTr)+4l0J{!}nJ0msssr
z&cKL&2f$yGymHwcPPG&F-1T#*`dW*vXOaDZYAbC0aEbWZ1wZ_>gzxVm2p@nih3BjK
zms-9EABC@kU#@cNc)8hLvi1oZzlLAv;qLc-3g90F=$FAyVNCPe1DE`3;g`Vu#w6iu
z;THz*F8J5sp5NUHpXaot0r-#My8bi@{~P=ywS3BcY}Tx>F#$hU<@Rq3i+=_1qZm_l
zybN9e|GG!N-0`m#eg}M>%B@#W&G@f{KMXHcxqa?M^6!Gb9KZ+Q9|rJI_~*{h+t2!3
z*f;^cUClrIXUG2n_=f@dW$@1})Z4EW`|v9~_E$Of*TQdx`^^Pr`QdlKtJJY1a-q2y
zE_?v~+L``54j+Xda8@E&r;c~lbE$91peHu6vsqW2o$!9=IBXrn6kZ7Lg6n)NhyNBn
zpym;I*&I{Fhc)oa7PGF3@<(bckTYZ7jXH5?Mdsxt`hL<4e-3^GCL9~ecc-?)UxMq_
ze&g`Jz;*o~XJ7V@;EPoI;WHfnir|Nwujdu;61c9P*TGMN>-=wppBccr;iUogx5F0(
z@NxJ8xNhy1!;fm60)O07e)qTQi{RVfvW{}%Z=Y$EHc|n99X?y-_L&dib?_m$E6UiIZ^4JF|q&y|?tnVh0-}3a!DyLso!_P+lI?p<#&RM54!8a~Xc)z0+?swYT
zM)=n+((|qG=_{BwJ@)Gz`#a&6U6M$C3r
zy;miYcXA!Q<779c?mT{j7!-RI*!woJ&0IU}Lt<}ASo+tV-^sjRC>)~B+&pt``5{I|JC*ZpKqaJwv<%#4O9{UR%{UP{y@M}HXdVp@0AKnRX
z^l)pk6`p$_ZF;qS?L8m91isXxZ{1)?dlCPd;csvqy?nmg4&3(gvN#)uH(~25SEM}`
zk@lk8D|8}rA2PbRvmd@2u3Nk9f`6e_zXzRp5c_Iyoqj(2*Kpn1rWC#l{x!wUSvFVC^E&CjKrxN
znXSltHN+pO^-ZMAoD1S4t%3jdYUU<&eT0oj(iAa$ZAE5BU0Q!oo<(-U7kw|0ybF6y
z9`+AON*>$czk_@Bro>O>{qO`bh1cloJNFRQs_;YAJe2Ph%!ki|AE$C_DQlLY5`G3;
zH^O6AJ=p5^dLxL=zS`wj3_@WWMoYpHF<
zupPb{{u`BtyPQ7P3y)sszsDO#XBhqo`unQ-_BYBTNqmUL!^V$V5=pss%4i*(Gvv$S{n
z-e2TOk!wcoCh9tRs8=p>t=spq4+|Ub6I0zdR0!Vz_d8D{^WJ9inZbU`R{D4Jw_kGo
zapt{9x7-YgPs7MQ+K{l`Y5Tn*E8~IvPFozgjpP}=A(4EWYft(9V)Yl1=|`p)nPILy
zGTU64QDo|G)Ssn|qnbTCY}7U;lB4N%tXB#RktsrE{!Q%bMfpRCcjU|NJzOO+mA596
zx2tx-x0=p~je7V?@NcPWPAT_==Cajl|Hx$hD3Sc7$Ht?k4Qa2v@OJoL)Uh=3s(G&|
zd>Fp;PX9SG4qpzhhM&WA^fJD(oGOcbeqCf5k+~C@3q(z-})yOvNa-nBfJnE=i0Gvf1g|UR-5mma{F6@ang3e&;4;C
z$rnppeQTf6d@?CAnR&D^^7yMNBYo(PW--iqFF@v6>|CYFSa!@EYq3*~%!>heiNAHo
zToF*-R`_jjzj0Oa=!Unz@8H^rhxmGn<*Vc|giM%mrAn0vTQ{k~6Yzy_-PoLa1bf@?
zy;Obs{H^HEhcAHp%|F5`;j7^@RDElDGTU}Nyb`W^KGOzY8lc|;FM<2jxmkYriSQHE
z{H-GuX8sAdluz2V6GMA1F-}tMk<@{3wQtFN@mXf~GHonCre~eL-7klaz)w^2pq^yQ
zQG9HGPx*=e94|h!!%N`*NYf9$<<@f_GBaBBK8(QU!F7Ev`gxw0!@rW2N2>4T!LNhs
z&hiw)Z-o2Rvy`Cvr92OU>}7;4@Xe
z$kp$(^=GSGd5@?c-i7|fD!0Zab2TGz7)9noWc=b3hi4td{y5xoPj1;TS7lvGHupX5i*C}<8MRCPys&{euHWw?7oXx2VV;>R=KtHV9qnG@Xc_)7>bJI
z(Syvr$msT0hTxyTSEzX?_YVnpQJda}++!G@;kWILfz-Od+7r8WZ<=MCn-}fAd&$a`U-A+w4Bm7M%jpib%W6qhmd+j+0gf
zZ-n3E;SH7}q=}6+$PB*ae@`N7;xYVs9vekr)?06JH=pv2m_?4Y=AO9N!p^oW3G-Wr
z(U%pu@D?*aDZ?-_mp|?;_ZVp_NIM4Z*tUvbK3mWJf~7M>IRC`wIixK|CmQ09lt1=H
zvhWgkaW~_$%9Y=@!ATY>Dh-?N^S7;o~G&5}rqY$LKSJ;ypp
zWFPdEJw#;lk?lgZ{{_}01TWgE$e#1#$nDV|#hRzwI5mqs5
zMc(y!m)x0&Y$gs||3_Q4NiQ2mc000*|CI24hu<2I%XMQY_8M<*hGI|g
zJ-m<$O=ZhwJe%azv3DcJuS2m%BgQ{Mu@A$>zeCHnGo(gcm8^LuvF{kVJLA^r#^cki
z^qI%=|3^Y6-NtTcm`fvh&q<-VN3pW_{^38L8rm#5-W`tpB*XYkxSe9Hi^g8d-~jJ~
zc>LF?vC*lGM!*t`21
z4^4}`vcK{CwAkbO8}ChvweN4-JUw>n{>CfQV;}8j?4BNbV?X2ey<&Y_XU2ZP_1>{{
z`x!r;8Dm4{>8#k!eT{!-#s0Lfao0YvC-*gey-)0ceT_fw6KmerXqpxKINSK$tk|2`
z#z(VaFJv1($suz}a@g7Y|JG1!Bx2kXiVZ}JWaye7MU5LHu{{yv3A^(4U4qbMv5gU9
zW9WCGmWVNEhxN!sfcn_qBgPLyv277!G8DTlYTOo%qr5p1Yl|AsDfKV;eb#@OhhniL
zc9C&4|3`lM**iTtmhS>u|Al=kw{q1W+49&a(Up@@Q
z?qGM%u02W4dNRbrilK1qlZbI&s+hFj<3mR^i@(1PPlk6*GuBPv;nqV_ZwYOf9{M2T
zmo(Hn_PXx&Ort9k8ME1nv5a}KlMD%S+VzYw(kka|2^nwMF_=+9O5N$a=GtyMGozf8
z<)^>JOVla%uyfDBp?!}5T=t{TBjM1~;ps2(kXpEt=V!}&mW|KiQs2nz!@%+HP^2Rq
zdxS%Rwhz}ykG1^#O#V(dmIy~)h{XCM#%^hQltI;hEEIb@6xkVy@o^a1pobINMX~dY
zm86=!1j}X~j@*f{Q;iEm9^G%mRv6#4uFVFdu=KxYUWwcd;n-bK<7vA+WPS4#!+1M<
zSNNWo@j}cpllOpl_=E7xJiavk7>zx*mvLt-wtFvQls@@SjZNsMoBy%37M!WRSW3eP%)`SQWg8{wZvjX^u_{j1j!rhCJ&^%=&^k)h~g
z8OA#qsADM~wBM*xw??%i$}ZiWqm<#oyZL5*ybGL<7w|j{+45GpSeEc#T=vc081jb6sP|f`s$4t
z#*>lQ-=^|?mHWbcXTLKQRiDE674Uzeh+~qLns0~A`S!(-@v&X&b}SFF=i>(=G9Ncb
zjK7Djd54v{9S$*(bzW>TW_-c=Pt&&k1JKw0b@;XR{!RpvwA_o568^LUQ=vn?}$1SHZ^iJqMG2`Ay
z?3I{tNA$vXV#WjZGRUv`rY~6d5Z^FJWuy$;;?rL1Ltp$GuZi0ov*`NRwwW?9eLTbX
zWjJ=*OyjliouT_?8okk27k|Wl8HTrH42PbZX}mjqM})tUGcCXWPZcrq41{kAUB>5O
zZn5*6dBifq_;D!G9x`6Ez1-&rK0jz|2*;j@7+b>+bB(Jr&)}f#FU>(SwNROH1p8K(
z$IxsGu?9mZ?}FG{8AfwxL+FWV#&hA1qYq9qUYZ)aW18`gsmF8OJdMndJ80!CEXgJ!
zu@9ogCh3BG(b)PJuOC^B&?m3|Q}M)f>c0c##_s0kH`c&YGFf}AxO5x8Az~L=gl5i-
z(QB5(HuGw4s(QW{TcnP1+4ExUY}Cen7&g9p8J}$ZjiPQAqb$}GrjatewuEGD*BO%Q
zU!_9(zd5A5lkx7J!$Mi{SW!e4wTl>Dzs8UnHbVAPWo+%VLRBv1xHQ%nCdx6sd--@s
zuAfp|nO+?GbIACw6hiD0UKzNWnC4i(hGOf(#?v8j^le+`P+In{rts%WpY<&
z%=Jm|IGDap*mo|s826cL)lH1!VdDk67SkjA*+G;x_Zj7v{`1*mb-Isc1Gp=+CHvO>
zjNj}>+oM6G{+n?ef1elI7~=QNEi$V=6#GrYm@w}nJ~D6AkU!z!@H!rM^kr=fy>Ynl
z;H;PVTh|*t%t?>^NiNRV!zGf;TXfSnY9er&a%zTTG)(J
zVdtFQZ_kfb|Cn(EiKoXN<)wDpr~glGux1>NV}%W74gO^BCr@lBdfyV
zu`HruM2sjN5s}3c78MZ{v+5#V@PF0s_mW8`vk5`>zkW=A-^{P;RlQeLuU}QYs;=&~
znnY9KMukXDq3tX5-0WkTvZG%iz6pP!F&i{5xOP@X^`cQr2HiHN66NA9K^o=g1g6tR816}&W<*2k5z9+@8U_nxrXo;hp~$MP578P>vmI(=j?j&{5N_)(Dnd#wy4T^
zDu?rpJI`38N0c2z3$1G%{v&9!60MY-ipRtyb7~+OCUM>)?*G)iF=ordH6J
zCi;wyx-nj8JVHw?Hs9^^tS{(2Cp<`Z(^neCwej>U?Dw|!{n$y^b4;7BI+?jyP4kA^R^pl^mphz5hSuxZ*nGPc3l~zXvXvB
zD0;2q=d8)le4Fm$NK(UDuojUphQtMr-K1X_$;uSLiBIaO`RjJ$?K(G4$F&`#xUrsS+_^8u~FdR
zm<4rXYj^fCABxg0)%+;+FPrhDLp^U_YNNobFqpP|sGv)2#zvd^5C!O@Ni&T{9kjew
zW}D+sl`vji;CAzEGZk5Zu`5A+YhT*h)N9<>v`6XXAmGm!-|web^^|S4?WtI`)bWIa
zLi?k;ZH-lLwlZF#^@kXP&ez2lME^O)*h9s}+M8&rk?Sl|5qfbLSvE}&Zia4z$1)I8
zQM;|M8LMdJ$ZotBrQWq0*BRBhi>eO3X-5;Yi
z$wW#|0frd0t*7f5m1N5|8pe`nnnib1>QlpbEn3|h?Kbr>>Pq@1h1%e7J=tDeXV9g(
zC)#+ZgZeO<_9v`~F+T2~KGT9X#~MpJs@b~oU&a~RJJM?s*HXb&Bp840q`pX~iLTck
zq@se&vQtTHqA9NJ2!m|oLgNOTT8|5MosHJpUT&i&1^;TJ7dICrsQ2y0O9^!KjIR^a
zXAa}OwrWL`@nT!`ZItmZNGoi$ryEE90Ja>aAAB^X=5VF~;ZZ
z)Q2&~UG3GfSmU|&>hoCRv-aw*amF1T)W745XF8~7;*C!`r~~oF?H$#Ptyj@Rm#)}g
zeLX6vFN{^+*o}p;>Me(HZLIp*amkl4>OsSJFowFoWIF#xw6QTpmA6W#^Cv=#r*nXm
zy~bwHeTEv_o3{I-)WRrs_Y<_cdigcvWj}>W-PWXh8+Fj&6;;YV;T%fjrRk7*2C8XD
zX`4HgmJVooUpJ*{g!Df$*1v9ZQ;lY(Jky=#V)Jbax>H{`VdHUXebjV1|HbIO{W!A9
zWIA8j%9z_t{oLwhLr1hR-sz_9PcUBSrd~`iR&-Mjw;e(BwTZ^h-PD1^#ahy;_QtZ~
z)#vSd(fOktjJ3zBFFI)E=Q|p29j~tKWF{g{ZU6CVZ)cro)ltUnNvh^3ooGWBV_A}#
zceI&k?J>s7N$T5Ubi}f*#kV$x|dpKJZ^uthgwPlOAqxzjIp$bx-a%Q8DNh
zZMrY+sh&^R7e#^H9gG)y(t83oYAK&~Hum&XPagHM4y-uZxUHA^>F76FQQ*7o#(TZg
zttS{&z0~6;7*F(4kLYy-Dp;Z(K4~B#o7-jkp8FT;pxbshbpT}FG?S8*guYHU+k|2M{}XB}6(Olwk6gO|jrzZKKnAqK0`eVpTKm7g9fdAi02zmtKl1L
zG{YEgvTA|)*RThZn6OTx)!WnzR+=@e(}Wc$IX1GQ)c6=*&rK!C)^J0vh9gtcbEL!d
zZDoR@=UGjybsyqfu?JoEA;zn;8J~PhaxuwOHLq&?!?xr%>2-iGqE5Z(Ci>$x<4(JJ
z%Vx}`eN;%-@TxbW`%a@s=#|c&9BPC87Tacrnh$^FjMAkPvo3o4g4XKcR*oB5tD08l
zDD_f|QPo=Q*Eeaek2}AtjoKY&T;E20A7^~mTCI*hnJ6!`p3AnJ==m!(Pa4{2h4xj)
zFthN9m(ajLPTObE>Q(#8G`7=~O+1V4p{cLz1}$&C=HN=osu8VIigVVn4@J$?3n)+8
zM$tRiLf3!V-D)c`eYW-S>LdG|v8LQ(C-nQ4oKoA&xAbkT%jtYsl(92PEyi+uCp||v
z&sa;hyKGx+^!ed8k-08Z+W|CHzlH8<+SJ?7bmD2W`bXnk=X|?
z`q)0RDoT9~EhcE!Ff(*=YF0RR8wuKEH)c5$O)Jd8_PLbizqE8m_cb5086ULL^OL3I
zZ#wkt$B!NFI6jY|H|K}{)O$A8tcTYG;27lz-Bc$Ye!}c
zH|)ktN{O)@tM%Fj4!7TG2LEC9XLa}9Fmi<4KRaQD@oAL0%QoX7L#?zMcatHQQ^&tY
z8E+fvc7wJB(>3dGgY7fhZPDsBN16Q>L%oP$uib7N?MP7HJM`6l4OZXoGm}U+h?YdD
zO(2>p)YG^kN;*6J?ovC%q8P&I{X#ms4Lwvzmo5G^-)+
zRhOxeeyR1z6m^;5Q8PHnF}#w#h2F+syM;1ZYBy+ZS8bnc3P`+QG0|uW{g7R~fy^5b
z8b8}^JWbCBNU@u9&1Ed29`#Zx%3|B*sCS~(YZ>Td
zx^P?cR>w{8sw$3bgk>H_$?4_~O{~pTbCRHC9=lF=3^&@1f9O8hxY3|Ro{}X7O%o@W
zY&y+NX7RrUeXG)=H^YW2QVEufB@yMvDV+#%J;B*|>Mv
z7!$SY^Puf|8{Jvif#S#XGEP>*>Z)?6VV!U5J8iFbS=d!ob!9pA!sfN^ZtF}#m{RZS
z?NT&?>v4?c{<1;Cnr6S<_6pshq^WlJG|iFoh28e7L*EDdxV{{2FtKBd>3X@2awq*S
zqL1(<8)w?GjVY?Qu4Gib|F3jfwcTM8+s*sn8}+Uv<8cS=beOTwp}y0#qD1=FrY)V1
zHI~@a6qiZtpsm?ykl*ap``P|%V{*HpePW{Lo>%9A#S{)mv{lGj2E3
z6?T6Y@&2%GlI6Y^(v*P)w72cXPQ6^Hze%m5PoQX87JuHM-qq0??8fH~b*Dpb
ztqX~M9nqWZ#`g{ytr492>Fa^4)Ix{>}G{UG_7ML|Fa6;UZv{A2~esC&tvD8Owpypwpc+Q*IHk
z27I%CW+eTkMkko3a|*~CrDIMZ`nVie4K#`LHzOU4=UgA#
z=rIg^bg|PS3>`Cm1V89KX~AC~m54V3^p~2zRERvgZXVO-yqQMKjtHNeS<
z9G;J`$gKpu^()Mm42+{41NtZeZUqi~pXrYPJAT078Ng3~V?JbhB{2OX4le*60A9YG
z>05xO?%?nPz}Elda0zfYtvBf71BA^0{mnXx>vz@FG})qKHE`ri4(|cpc@2k8oyFLC
zHsdOw$xMF>Aa5t+91H%*b2$Bc;Df-mz(YhGx2}Zg+kg_^2k{d?_gdly
zA%2gZ^V1Q9_-fEAk7oJh$1o;#WgLp|WW-B;MTmd4oaJ4%w0?P2GV|{|Hrixad>rFO
z;O65woY0N25@C@)3H<&f@B^3h;P4yCjFP?x>7PA;>HC1;(pR6x<(u~>T1ukh0iej6
zJc8qg|G@D>e`f5cXrl!kc?M%@GNV6*^YtU$dk4W6$MIWY8Kc@Wp4@>kn8di`IL1DG
z7zY7wgWLyztAVcqC->&`tAI5J`H=DtM0utHZvfwg2e^D~P@g}xWjTXU-X195P@w2#
z$2qK*wHrA7Zs3Sb9F}yc=W@D~8m4apj{X6B!1h0Kxbpk@{N><3^#Id%0V@o;1xUy6
zXvPBIHx3R<{?*`rBbMp=f&CLWoYSs;`rSxBt_{;~0ftMj#&G?r+H?9E;DVz#yz!X&
z^1C4Y>dr_H43|C?=}$bC(@y{n@6KU=&-(I5BK_nfrY{6q({CKd+z&`UKQ;sHrip(3v4NZ}TtC0C2g{ua
zc_a0*A03mx7q*{20qKUY{N<-IE!Rb>8yV?A7&CnKO^iQ-uQlRNM>$>tJ?f8~Z!&PwkKB$$?`xs&wn#tH62B7h(TKkt
z^|PT~e&A3GUlsU%0UnL|UI2U&*nb$8&#V;vmCuhePfO8{3VlBOz{_vrdbhuw@kq0i
zNvOBgPVT;g^^u?-%Nzxtl?WBmSVb(?et-(BD$rH4rgpMIkGSZV(W;h#I1{|`A>02e8nTp3EdPz7Oc7tBhflbLRzlZI_TJB2F
zw8#;H)oW!L*I&!gS3>mc*v$p3!S%G)cazi(
z@C~)LE6kTuFJieHCNY-n3yJM0t}@jw)ag%JX;BuN_eA+N!tI3)s%AdXw@CTJo1D^uk1pE$o!cm+~{H?JFhx4}-^nM=leF!N2mc*Y4`eI;H{+94v
zg7kL*o9k~C-N$xh^~?L%*-jqm!u4EyG~qmSco73f=m
zVkcz?hqDvW`*q0oU7*;B#Fv6z4Q$Fzgl|65zYJ`yopf2)xSeb>*iJq=h3kEKDx<9D
z?tYZ#!7|TZy^6!X)_ShY^ZjdBuFUhpt>?~phSPn3dHy`Tmz<8V1G(I5mvemHBaD+#
z{?rN%UxoTT(vQ;@tYx~)zeOJ>A)Oy+y#WRzWzv`5Bw9#F#+Xx1-Js`Gz(9E
zHMkBHNnEa--5HOx_S)wJuD7+lK5`<{=K+_W%;B{N*MP5E52oJ@91UCxOzO??a=k_G
zuR`C)LylZmiC>5K&WLZSy$at}@U;P7bKC0<`n9N8)~%qzi|GXfv)p
ztm(&sF6;clUxfQ-Ik&Rj_5qJHyFB$auD{hT*JC|!v#blw=XCvVXWRz9Em-H1aU>e?
z;l>fs`$y1sKgbcgl=ycLec#;FY9&C0>0^<;6exNr
zzn`y%4(qvt+@FF%@IzCM;jpu%5{$?)M7NGb6RsZDmVDSTFz5mzt
z16uFoe46qDYVYe>{D8}LF@Lwu85ba2wTbKX#;c6d|4Y3$p}q%!w}bC#@I4KAqQUtO
zpdAda-#@Qu&EYw;_f{W!fTG8zzWnd#G2yGj)8ia^Dor1o-(}4Bn&sW}c76RxegBDi
zcG|=7#o!OOzhd$-)?f9R_4PNeP5rQ0h{O0>&_a1T9^~>h;D3ne)^ZL7U5Z*{33tJI
zrhg!>7ncKH19lt)I#A?{1fPVh_&_4_S?RMXxSUr0YS0_h>tRk`WXW$R=puizB`oW-
z5+4qmyWS)Gm4D&#SeHMRWB-YDJ?rjutcP!a$h23(pq0xPqWrn%73_Mt&il_lw50l!mZzloLMVi
zk64cs`s9^NmvDJIZvT&U=Xu?Jp!Azop}l)MwTcTt69?g}$)^*E8;P
z&gW;~k>*zqKZEOU^{dsHOwSt1ST&sSvSEzLpl1NZuigiF;rwdR`zO%%V5AqnTH?1M
zJ{9pz`PIT#1HRtiYp!3N_$1qjbsev!6Wd8%Cf9o>@JO?hwIjIxRy&z-4X@ukF@y19
zgzvnX!RLQP9(k>@tqOhl${9QyWl$>e9g6!BG^gZ
zfckz?CH5b7)-Ri;V=vI!Z-$#6t<*1Lp`)9Al@lFz0>|WYSoUQmT*~3<%NT<$#>3s0
zDf1wy$NMOMuk%^{HjL8}zZvnzBYvYL{u9I>jd-(C^tTFnlJMbT<=?p7Hjulzar#iu
zCEvV|u=WIGoRImO?BkUAo9z3v_hAXLPt;DIGYmaug~-+Pa!a_<5-!KS(C@BieRrG7
zcs6hgFx!vPC%2*ARzJ?Vj{d}pte?5S6M@!s^huzHvlG#KD)PM^
zD0U+8y+OYU*p!_J->FC+05;c7w!u!U{{D{cY$x+JaQ%;Y>BzK`$*8y0PUcs!K5~HH
z;l9gA++VpI7=w7}Pcje=XD6a}JMz5{D0U+8Kj6BIL3~qoB76x*p9yTPos4{z`xC33
z%O8j|pJ%CNMSK*t2^!Eds+g_8NrbB76MgOI!}_X766C&((f|a%5z1
zd1~*!;
z`elhn3v6z`JaRqy$uzbLv9E0@93F8N*Y`o-@6C@|HHypMlpnPd
z^@}Oz^j1Gg^l=B$Z38ytM+x6Tq<<6GTtBJ?*CFauF4s)pk0ufkW1^nU?1x4l-Qy;}XK
z-Jr|9d1=R8(5@@aVSVfw&3L5PPgDK<8`-RndE*#&IvG!uKKgI)Sgb_LH~)ewO8V<)Qt!zwdkn*L%6(5%ygBUew#VzA`$%diloB
z7;b%~4DsR@Y(O|%KO=gdk9oJ_ZGo_E;+jW?@?9i@5I6uBtAJ9Vyu&L`Hd>Kez2yE_kNF7{%ekJ}{b20T5Zf8;s
z;TsFO4(lDpvQJRpaU$Jg9`-rB!QJ&sg+u#Wr9wFm2cTG3-TdkCj@
zv4?Q+P1!>@zUJCP`D=}j`<0;Udg*;z*8WJ|Hz)m3?Q=Njk81lT>@N`g>MPH`$@5#*c9!%u>rczmKA5%tv-)F_ul0E^p^JWhFVDwGxo6-xJ9$1%^ct?7R{z`j
z-r>|OEz|1)yuVb+^=skSt@X=OdtH%%EqB3H9Hzj>8-JvpyaGKCyx6rRy2*evWZHa1i)v5DwS>iry9SI}a%Ruf%_k>ym}|
zrutvui$(g=fX(fHx4}LZ;Qgev)-#grB=LOKMGNOG|9&%`>mkn}
zPn^Kvk>ePpzfh?6Q^@xVp!CDLAZIlAMPKFgr5=4)`|+WpSdV3SoX>ke(c|x>pG|ji
z`5W}Jm)6&x)b}ma)5z!eUf`E;%-Y`$eUJ5L?XTyZ&HC&A5X&hAivIpvcKBO853lH3
z?fQsWQeTf!Zy)Nr3@CQ^Ez(>4f%5kox5JHie{}W=&Zhz>di=fE;fW7(`K@-CUQu6v
zQr|zLo^Jt<1AkaMq|YPj!)k}~KV-TYNq=ibvt7=3jr0BTb;jyljFsCF#`g?%?&Wa#
zn~XK@GTs7uNAT@O_~%cN4$o6bemjxRQEzbkzmR_G77jo99^(g~zYMvKubG~Ju+(GK
zM|Jfw_x0fYAF`eo&aW7W_jZdM!Eo;xmw3VI?VN7|IXjqc-AA`3On%|sOD_2cRzq$B
zIsa@tKedzT@_urWlLWeT-<|pxa>lS-)TRf$LHbWPy}UoXHa+Op^zt0T{@(0=B%H{2
zr1@sMeB2&^4w)pa;?vGhI?m!WiUts*RyoaP3be&GWT3eo1miKWB|GbGj&hEX0T7KCF-d%mPjX<^oHAbAe^R3gBvB6>uwX7jPdi`U-xrerI4ZFawwcoCwSXmH_7h
z%YYTY)xav?R^Tq+K47#T`2&-I8Ne*yL|`tk1UMI12CM+C237&L0(SxT0iy%RAD9fx
z0A>Lv0&{^Sz`4LOUpxC^)s7#&3Zz+_+sFbg;lm6eU1>6UWEiz$)NY;4a`kVD#0<
zAD9fx0A>Lv0&{^Sz`4LOUJL;iT`Y3CjsbLPQ=aq+F&B(zOz*Sk3Fv2@k!lJ
z=yBe`u?G*Hb>^8vlKKoQD9ZPGlG6I8q^G3*0jN|;ATJQ~2VL1J#p?@tQl@x|Q;Ph)
zB9A{fJ%p59oL`XBH$O+23G!TlJe86&-5Z!*$QblazZnx7@>h=@`omAoi56f`6
z{C*b|R?CocEk|ccBFzH23iI8>@1v|Zi|jx^rMP{Cg&uD(`h;te{1=#0RM0ZOuCR$3eM}u5t`bLepdb~iKgRtS23Ny
z&lTji^%5P2ltaQLbP~#+2!6pz{!FAKSF#O2aJGfN8vUQ(=lGtd2oOFA-(cZ?`a15H
z1e+@Vt>72^D}2XLFyk`Gi7}~uP~AgeU4P*pgn6#uu{YIc;J3Nf(Uw{GCzWbzrteq+
z%TE!>Cb{L&;&{<8XMq
zM|FDtEeSiWO8@bPKV5p~x2LT?KK{IgQ@^ArrN_%H^wZ;@mi2gIucV=B&albzQg5)g
zKUxiKGufUsOIGvu9cF|8CyXp5i{r1rB3;JoFF!b0<
zfv-adHFW+j`u!WUeT3iB?+5z*L_h75>EodOBL&&$=b)cKzgF~%pG^jq>h0~jdtl~0
zi>?^3%n^+H>ZTV1+uu9zr+D9%)_u!gdbs8h47cx}P}4|K#$$7nGHh-`sI_ueZN{?%J}mX7{?k-D6)3x~=%>A10M{A>1m8B#mewqJfA8A{vNjAfkbY
z1|k}WXdt42hz24Wh-e_9frtho8i;5hqJfA8A{vNjAfkbY1|k}WXdt2iiw5{EW#s?&
zssX(xQy)dxzb3bvOD*AhEa5~;_z8ruD^6XAaBCJ{yI+`hiz+4iZjVO1>?Z|V?fzfc
zk0<*@WuK$$ulx6bgFY=n_5;?wr5F42WWTcP^X6T@O38jb-bGut&s*DjJ8zS~K0`Q9m`+~b33Y3@9i-x>6~@`Hgyl`BS`^
z)L|7WSI}qH<Y(4Eu6B@fTsDnj9^HuCevf{&>DYQ?uP?{r
zq-&;!qVYl9_Dmad(ik}SE~5b*wo69=d?EG+hc;k;_fpab`;$jM`#YU5sW9V`Kp1oo-*zbQ-^0{s7g6Y>9k^
zmRYuGPSl0NICZVeKF;rvevvGAaEQeR=#|Az7xjRCPqwST<#l_q!&v|LROh(yX0ci@
z3=X811{b;fbh+UiQZecpUTxmaT%VuJliFICLU0L8X0*a=8q~~J89Tk6X{a`PYiZ=W
za!WPS=;om#Xkg%0QI~&?rx^{u(T;*t5kjx)DX4cU^p)ryW5OsJglY?*-2UlBL7y|*
zSE?utU8xX?lU^Y04Gm{|NFN?=q4Lue@)c%J4|)Qj@l!q1i(L8sP?8qmbmh{7f!G4R
zoc!WK^6)(#Id^F_@T;HMGKz}*9%o6uKUnN42o>aU1*X>usw=fwMrXaqhVDt4(^*p3
zh=0-`rM^TBy%<(eKwp%gRupotB{a~J)VF0GLE3
zw$C3_xo$6!$#2nqB~PeY(rc6dtOpKH35_|qIa;2_OKwBZMb1h~6i&?v((Fywqy;@rT0c^!lg&NoYw;9^=d4{M3t+JLDuUOLyt!
zM2LJ#zdO(0GF#A21i5PBMzrJ_^rv-*oJ?}}T6PID0>#;ScG^-8A-}Z6qxt}UNYM}d
zx~02b7CRHSMihl~7xZL^+0R0uY
zZTY268hdCKI>lQ%A#?l42hh{S9J8CN@974nlh8u;8{xL64bmL>dVcCGaryK0vJ_bi
zoS?>H>t+s(#ipgwL@hs;hMa`^_DbBI9A~k)
zE|sZBbu@^YS3*xg$d5I{X3m53id&FYA&74@T?=QePoN#eJfClB=2-HixR~J+YX`a5
zYbGx-FZGN;18Ab^rm0A6kh~ThY+2i?b;t?}^$=8V9e`#-)2V_}&7Aa*r~=vn5f{Q-
zIGENz;lK6{6q}(7Xf#kCx@JM
zS79xcG76!3^WAmpLlou8)gKX|B`t4JD2MK~G)ebZ=CX3Y?ega8pdORBKcc~lMrj(^
zTzsZ`J*6*N&_~AQF3I)#3eD>$pGYz7foAJ^(#;n(SgJk$+H>-JnZr#HfxO~ij&BrvrO&CVCYNc?T5dg7S;W#2S}A0XVt{O#&O#qmT1w&bdOdEISM05|P?{!FH(48_
z&9l~4buEct7NOQmbqY3Bv!axQ=7!z?3)YdkuyrP``SN|-Luhr0Je^X9P2sgC!e2`j
zRvlqZS9GR2py#7zDvt5jwJuSbj?ikUO=a358J1{4k0t&l;ax9O6PH2OA7>jMbq?hqh6+_xkG)L
zSuq-Q^Jy)_5~UeU66Hw!Y#ld;>&(PmOfIHVCWBf&Q;LeS3+MwrGJSH>{N7(!ToB~N
zES-*);ph`Tbh(SQerqq5g)C~ekZHNhES`l-!%|~px_HH0!v^W8N1%1&g8Xcrucici
zDd`zzIGE!;=_DOCgYJ|<@}K&a4$5$5^w-ohok)M)C{P=sTIurvioW0E?3a?NPALxf
zPtkMUf>S85W}qZ}vpueX>DhzR&9wAwrva+xdE-W%HEK*dMr2K+eGQ+`;JswSbJ2)RcbxYRl3$)txh-UwU>97fS9~{vU4GplJXA

literal 0
HcmV?d00001

diff --git a/env/lib/python3.12/site-packages/rpds.libs/libgcc_s-98a1ef30.so.1 b/env/lib/python3.12/site-packages/rpds.libs/libgcc_s-98a1ef30.so.1
new file mode 100755
index 0000000000000000000000000000000000000000..c7d1060a196388a31536829de6f8fb2c217040f6
GIT binary patch
literal 433441
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%0A|Nqt)+^rs5mA?3oXo186p+rygBe6MQ3$DOEg
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

literal 0
HcmV?d00001

diff --git a/env/lib/python3.12/site-packages/rpds/__init__.py b/env/lib/python3.12/site-packages/rpds/__init__.py
new file mode 100644
index 0000000..257da6a
--- /dev/null
+++ b/env/lib/python3.12/site-packages/rpds/__init__.py
@@ -0,0 +1,5 @@
+from .rpds import *
+
+__doc__ = rpds.__doc__
+if hasattr(rpds, "__all__"):
+    __all__ = rpds.__all__
\ No newline at end of file
diff --git a/env/lib/python3.12/site-packages/rpds/__init__.pyi b/env/lib/python3.12/site-packages/rpds/__init__.pyi
new file mode 100644
index 0000000..51f03b0
--- /dev/null
+++ b/env/lib/python3.12/site-packages/rpds/__init__.pyi
@@ -0,0 +1,79 @@
+from collections.abc import (
+    ItemsView,
+    Iterable,
+    Iterator,
+    KeysView,
+    Mapping,
+    ValuesView,
+)
+from typing import (
+    TypeVar,
+)
+
+_T = TypeVar("_T")
+_KT_co = TypeVar("_KT_co", covariant=True)
+_VT_co = TypeVar("_VT_co", covariant=True)
+_KU_co = TypeVar("_KU_co", covariant=True)
+_VU_co = TypeVar("_VU_co", covariant=True)
+
+class HashTrieMap(Mapping[_KT_co, _VT_co]):
+    def __init__(
+        self,
+        value: Mapping[_KT_co, _VT_co] | Iterable[tuple[_KT_co, _VT_co]] = {},
+        **kwds: Mapping[_KT_co, _VT_co],
+    ): ...
+    def __getitem__(self, key: _KT_co) -> _VT_co: ...
+    def __iter__(self) -> Iterator[_KT_co]: ...
+    def __len__(self) -> int: ...
+    def discard(self, key: _KT_co) -> HashTrieMap[_KT_co, _VT_co]: ...
+    def items(self) -> ItemsView[_KT_co, _VT_co]: ...
+    def keys(self) -> KeysView[_KT_co]: ...
+    def values(self) -> ValuesView[_VT_co]: ...
+    def remove(self, key: _KT_co) -> HashTrieMap[_KT_co, _VT_co]: ...
+    def insert(
+        self,
+        key: _KT_co,
+        val: _VT_co,
+    ) -> HashTrieMap[_KT_co, _VT_co]: ...
+    def update(
+        self,
+        *args: Mapping[_KU_co, _VU_co] | Iterable[tuple[_KU_co, _VU_co]],
+    ) -> HashTrieMap[_KT_co | _KU_co, _VT_co | _VU_co]: ...
+    @classmethod
+    def convert(
+        cls,
+        value: Mapping[_KT_co, _VT_co] | Iterable[tuple[_KT_co, _VT_co]],
+    ) -> HashTrieMap[_KT_co, _VT_co]: ...
+    @classmethod
+    def fromkeys(
+        cls,
+        keys: Iterable[_KT_co],
+        value: _VT_co = None,
+    ) -> HashTrieMap[_KT_co, _VT_co]: ...
+
+class HashTrieSet(frozenset[_T]):
+    def __init__(self, value: Iterable[_T] = ()): ...
+    def __iter__(self) -> Iterator[_T]: ...
+    def __len__(self) -> int: ...
+    def discard(self, value: _T) -> HashTrieSet[_T]: ...
+    def remove(self, value: _T) -> HashTrieSet[_T]: ...
+    def insert(self, value: _T) -> HashTrieSet[_T]: ...
+    def update(self, *args: Iterable[_T]) -> HashTrieSet[_T]: ...
+
+class List(Iterable[_T]):
+    def __init__(self, value: Iterable[_T] = (), *more: _T): ...
+    def __iter__(self) -> Iterator[_T]: ...
+    def __len__(self) -> int: ...
+    def push_front(self, value: _T) -> List[_T]: ...
+    def drop_first(self) -> List[_T]: ...
+
+class Queue(Iterable[_T]):
+    def __init__(self, value: Iterable[_T] = (), *more: _T): ...
+    def __iter__(self) -> Iterator[_T]: ...
+    def __len__(self) -> int: ...
+    def enqueue(self, value: _T) -> Queue[_T]: ...
+    def dequeue(self, value: _T) -> Queue[_T]: ...
+    @property
+    def is_empty(self) -> _T: ...
+    @property
+    def peek(self) -> _T: ...
diff --git a/env/lib/python3.12/site-packages/rpds/py.typed b/env/lib/python3.12/site-packages/rpds/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/env/lib/python3.12/site-packages/rpds/rpds.cpython-312-x86_64-linux-musl.so b/env/lib/python3.12/site-packages/rpds/rpds.cpython-312-x86_64-linux-musl.so
new file mode 100755
index 0000000000000000000000000000000000000000..395e492ff2f6bcd1d2448b96e3878437c9421487
GIT binary patch
literal 1035209
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
    jB?98=T#t
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

literal 0
HcmV?d00001

diff --git a/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/INSTALLER b/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/METADATA b/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/METADATA
new file mode 100644
index 0000000..fbf44b7
--- /dev/null
+++ b/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/METADATA
@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: rpds-py
+Version: 0.30.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+License-File: LICENSE
+Summary: Python bindings to Rust's persistent data structures (rpds)
+Keywords: data structures,rust,persistent
+Author-email: Julian Berman 
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst; charset=UTF-8
+Project-URL: Documentation, https://rpds.readthedocs.io/
+Project-URL: Homepage, https://github.com/crate-py/rpds
+Project-URL: Issues, https://github.com/crate-py/rpds/issues/
+Project-URL: Funding, https://github.com/sponsors/Julian
+Project-URL: Tidelift, https://tidelift.com/subscription/pkg/pypi-rpds-py?utm_source=pypi-rpds-py&utm_medium=referral&utm_campaign=pypi-link
+Project-URL: Source, https://github.com/crate-py/rpds
+Project-URL: Upstream, https://github.com/orium/rpds
+
+===========
+``rpds.py``
+===========
+
+|PyPI| |Pythons| |CI|
+
+.. |PyPI| image:: https://img.shields.io/pypi/v/rpds-py.svg
+  :alt: PyPI version
+  :target: https://pypi.org/project/rpds-py/
+
+.. |Pythons| image:: https://img.shields.io/pypi/pyversions/rpds-py.svg
+  :alt: Supported Python versions
+  :target: https://pypi.org/project/rpds-py/
+
+.. |CI| image:: https://github.com/crate-py/rpds/workflows/CI/badge.svg
+  :alt: Build status
+  :target: https://github.com/crate-py/rpds/actions?query=workflow%3ACI
+
+.. |ReadTheDocs| image:: https://readthedocs.org/projects/referencing/badge/?version=stable&style=flat
+   :alt: ReadTheDocs status
+   :target: https://referencing.readthedocs.io/en/stable/
+
+
+Python bindings to the `Rust rpds crate `_ for persistent data structures.
+
+What's here is quite minimal (in transparency, it was written initially to support replacing ``pyrsistent`` in the `referencing library `_).
+If you see something missing (which is very likely), a PR is definitely welcome to add it.
+
+Installation
+------------
+
+The distribution on PyPI is named ``rpds.py`` (equivalently ``rpds-py``), and thus can be installed via e.g.:
+
+.. code:: sh
+
+    $ pip install rpds-py
+
+Note that if you install ``rpds-py`` from source, you will need a Rust toolchain installed, as it is a build-time dependency.
+An example of how to do so in a ``Dockerfile`` can be found `here `_.
+
+If you believe you are on a common platform which should have wheels built (i.e. and not need to compile from source), feel free to file an issue or pull request modifying the GitHub action used here to build wheels via ``maturin``.
+
+Usage
+-----
+
+Methods in general are named similarly to their ``rpds`` counterparts (rather than ``pyrsistent``\ 's conventions, though probably a full drop-in ``pyrsistent``\ -compatible wrapper module is a good addition at some point).
+
+.. code:: python
+
+    >>> from rpds import HashTrieMap, HashTrieSet, List
+
+    >>> m = HashTrieMap({"foo": "bar", "baz": "quux"})
+    >>> m.insert("spam", 37) == HashTrieMap({"foo": "bar", "baz": "quux", "spam": 37})
+    True
+    >>> m.remove("foo") == HashTrieMap({"baz": "quux"})
+    True
+
+    >>> s = HashTrieSet({"foo", "bar", "baz", "quux"})
+    >>> s.insert("spam") == HashTrieSet({"foo", "bar", "baz", "quux", "spam"})
+    True
+    >>> s.remove("foo") == HashTrieSet({"bar", "baz", "quux"})
+    True
+
+    >>> L = List([1, 3, 5])
+    >>> L.push_front(-1) == List([-1, 1, 3, 5])
+    True
+    >>> L.rest == List([3, 5])
+    True
+
diff --git a/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/RECORD b/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/RECORD
new file mode 100644
index 0000000..e522e16
--- /dev/null
+++ b/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/RECORD
@@ -0,0 +1,11 @@
+rpds.libs/libgcc_s-98a1ef30.so.1,sha256=XOVRhHznCIpbSdhFoozhla-OfRqBtXftKPQ4cSMKjrs,433441
+rpds/__init__.py,sha256=w3MgXW7lpTCICw0KXbw20QX573_kbsEnWIeMsCAugvM,99
+rpds/__init__.pyi,sha256=am7x6oMa_pu_kv1NlolqJbPr6_UvCvoyxGKrDGSMKEk,2602
+rpds/__pycache__/__init__.cpython-312.pyc,,
+rpds/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rpds/rpds.cpython-312-x86_64-linux-musl.so,sha256=LGqkqus-wdJrHTMJup7SK5fMzVHDZPxxKqBDYkZ3ytU,1035209
+rpds_py-0.30.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+rpds_py-0.30.0.dist-info/METADATA,sha256=zAHQl925x-B6KclVPujdNc-SDoX7V097DCPWgTinFr8,4145
+rpds_py-0.30.0.dist-info/RECORD,,
+rpds_py-0.30.0.dist-info/WHEEL,sha256=Ap6nlw0cH0rhF7wSMkRKCr81qRCCUY4y7-Tz6vs1yZ4,108
+rpds_py-0.30.0.dist-info/licenses/LICENSE,sha256=MU5Okb47qpPA-0vMyeTpfNZD64ObBlr5IXgsIXX-mQk,1057
diff --git a/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/WHEEL b/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/WHEEL
new file mode 100644
index 0000000..1d14e88
--- /dev/null
+++ b/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.10.2)
+Root-Is-Purelib: false
+Tag: cp312-cp312-musllinux_1_2_x86_64
diff --git a/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/licenses/LICENSE b/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/licenses/LICENSE
new file mode 100644
index 0000000..119a1f2
--- /dev/null
+++ b/env/lib/python3.12/site-packages/rpds_py-0.30.0.dist-info/licenses/LICENSE
@@ -0,0 +1,19 @@
+Copyright (c) 2023 Julian Berman
+
+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/env/lib/python3.12/site-packages/six-1.17.0.dist-info/INSTALLER b/env/lib/python3.12/site-packages/six-1.17.0.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/six-1.17.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/env/lib/python3.12/site-packages/six-1.17.0.dist-info/LICENSE b/env/lib/python3.12/site-packages/six-1.17.0.dist-info/LICENSE
new file mode 100644
index 0000000..1cc22a5
--- /dev/null
+++ b/env/lib/python3.12/site-packages/six-1.17.0.dist-info/LICENSE
@@ -0,0 +1,18 @@
+Copyright (c) 2010-2024 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.
diff --git a/env/lib/python3.12/site-packages/six-1.17.0.dist-info/METADATA b/env/lib/python3.12/site-packages/six-1.17.0.dist-info/METADATA
new file mode 100644
index 0000000..cfde03c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/six-1.17.0.dist-info/METADATA
@@ -0,0 +1,43 @@
+Metadata-Version: 2.1
+Name: six
+Version: 1.17.0
+Summary: Python 2 and 3 compatibility utilities
+Home-page: https://github.com/benjaminp/six
+Author: Benjamin Peterson
+Author-email: benjamin@python.org
+License: MIT
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*
+License-File: LICENSE
+
+.. image:: https://img.shields.io/pypi/v/six.svg
+   :target: https://pypi.org/project/six/
+   :alt: six on PyPI
+
+.. image:: https://readthedocs.org/projects/six/badge/?version=latest
+   :target: https://six.readthedocs.io/
+   :alt: six's documentation on Read the Docs
+
+.. image:: https://img.shields.io/badge/license-MIT-green.svg
+   :target: https://github.com/benjaminp/six/blob/master/LICENSE
+   :alt: MIT License badge
+
+Six is a Python 2 and 3 compatibility library.  It provides utility functions
+for smoothing over the differences between the Python versions with the goal of
+writing Python code that is compatible on both Python versions.  See the
+documentation for more information on what is provided.
+
+Six supports Python 2.7 and 3.3+.  It is contained in only one Python
+file, so it can be easily copied into your project. (The copyright and license
+notice must be retained.)
+
+Online documentation is at https://six.readthedocs.io/.
+
+Bugs can be reported to https://github.com/benjaminp/six.  The code can also
+be found there.
diff --git a/env/lib/python3.12/site-packages/six-1.17.0.dist-info/RECORD b/env/lib/python3.12/site-packages/six-1.17.0.dist-info/RECORD
new file mode 100644
index 0000000..bb90c1a
--- /dev/null
+++ b/env/lib/python3.12/site-packages/six-1.17.0.dist-info/RECORD
@@ -0,0 +1,8 @@
+__pycache__/six.cpython-312.pyc,,
+six-1.17.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+six-1.17.0.dist-info/LICENSE,sha256=Q3W6IOK5xsTnytKUCmKP2Q6VzD1Q7pKq51VxXYuh-9A,1066
+six-1.17.0.dist-info/METADATA,sha256=ViBCB4wnUlSfbYp8htvF3XCAiKe-bYBnLsewcQC3JGg,1658
+six-1.17.0.dist-info/RECORD,,
+six-1.17.0.dist-info/WHEEL,sha256=pxeNX5JdtCe58PUSYP9upmc7jdRPgvT0Gm9kb1SHlVw,109
+six-1.17.0.dist-info/top_level.txt,sha256=_iVH_iYEtEXnD8nYGQYpYFUvkUW9sEO1GYbkeKSAais,4
+six.py,sha256=xRyR9wPT1LNpbJI8tf7CE-BeddkhU5O--sfy-mo5BN8,34703
diff --git a/env/lib/python3.12/site-packages/six-1.17.0.dist-info/WHEEL b/env/lib/python3.12/site-packages/six-1.17.0.dist-info/WHEEL
new file mode 100644
index 0000000..104f387
--- /dev/null
+++ b/env/lib/python3.12/site-packages/six-1.17.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.6.0)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/env/lib/python3.12/site-packages/six-1.17.0.dist-info/top_level.txt b/env/lib/python3.12/site-packages/six-1.17.0.dist-info/top_level.txt
new file mode 100644
index 0000000..ffe2fce
--- /dev/null
+++ b/env/lib/python3.12/site-packages/six-1.17.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+six
diff --git a/env/lib/python3.12/site-packages/six.py b/env/lib/python3.12/site-packages/six.py
new file mode 100644
index 0000000..3de5969
--- /dev/null
+++ b/env/lib/python3.12/site-packages/six.py
@@ -0,0 +1,1003 @@
+# Copyright (c) 2010-2024 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 "
+__version__ = "1.17.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", "IterableUserDict", "UserDict"),
+    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("proxy_bypass", "urllib", "urllib.request"),
+    MovedAttribute("parse_http_list", "urllib2", "urllib.request"),
+    MovedAttribute("parse_keqv_list", "urllib2", "urllib.request"),
+]
+if sys.version_info[:2] < (3, 14):
+    _urllib_request_moved_attributes.extend(
+        [
+            MovedAttribute("URLopener", "urllib", "urllib.request"),
+            MovedAttribute("FancyURLopener", "urllib", "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/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/INSTALLER b/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/METADATA b/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/METADATA
new file mode 100644
index 0000000..6c9dccf
--- /dev/null
+++ b/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/METADATA
@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: soupsieve
+Version: 2.8.3
+Summary: A modern CSS selector implementation for Beautiful Soup.
+Project-URL: Homepage, https://github.com/facelessuser/soupsieve
+Author-email: Isaac Muse 
+License-Expression: MIT
+License-File: LICENSE.md
+Keywords: CSS,HTML,XML,filter,query,selector,soup
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+[![Donate via PayPal][donate-image]][donate-link]
+[![Build][github-ci-image]][github-ci-link]
+[![Coverage Status][codecov-image]][codecov-link]
+[![PyPI Version][pypi-image]][pypi-link]
+[![PyPI Downloads][pypi-down]][pypi-link]
+[![PyPI - Python Version][python-image]][pypi-link]
+[![License][license-image-mit]][license-link]
+
+# Soup Sieve
+
+## Overview
+
+Soup Sieve is a CSS selector library designed to be used with [Beautiful Soup 4][bs4]. It aims to provide selecting,
+matching, and filtering using modern CSS selectors. Soup Sieve currently provides selectors from the CSS level 1
+specifications up through the latest CSS level 4 drafts and beyond (though some are not yet implemented).
+
+Soup Sieve was written with the intent to replace Beautiful Soup's builtin select feature, and as of Beautiful Soup
+version 4.7.0, it now is :confetti_ball:. Soup Sieve can also be imported in order to use its API directly for
+more controlled, specialized parsing.
+
+Soup Sieve has implemented most of the CSS selectors up through the latest CSS draft specifications, though there are a
+number that don't make sense in a non-browser environment. Selectors that cannot provide meaningful functionality simply
+do not match anything. Some of the supported selectors are:
+
+- `.classes`
+- `#ids`
+- `[attributes=value]`
+- `parent child`
+- `parent > child`
+- `sibling ~ sibling`
+- `sibling + sibling`
+- `:not(element.class, element2.class)`
+- `:is(element.class, element2.class)`
+- `parent:has(> child)`
+- and [many more](https://facelessuser.github.io/soupsieve/selectors/)
+
+
+## Installation
+
+You must have Beautiful Soup already installed:
+
+```
+pip install beautifulsoup4
+```
+
+In most cases, assuming you've installed version 4.7.0, that should be all you need to do, but if you've installed via
+some alternative method, and Soup Sieve is not automatically installed, you can install it directly:
+
+```
+pip install soupsieve
+```
+
+If you want to manually install it from source, first ensure that [`build`](https://pypi.org/project/build/) is
+installed:
+
+```
+pip install build
+```
+
+Then navigate to the root of the project and build the wheel and install (replacing `` with the current version):
+
+```
+python -m build -w
+pip install dist/soupsieve--py3-none-any.whl
+```
+
+## Documentation
+
+Documentation is found here: https://facelessuser.github.io/soupsieve/.
+
+## License
+
+MIT
+
+[bs4]: https://beautiful-soup-4.readthedocs.io/en/latest/#
+
+[github-ci-image]: https://github.com/facelessuser/soupsieve/workflows/build/badge.svg
+[github-ci-link]: https://github.com/facelessuser/soupsieve/actions?query=workflow%3Abuild+branch%3Amain
+[codecov-image]: https://img.shields.io/codecov/c/github/facelessuser/soupsieve/master.svg?logo=codecov&logoColor=aaaaaa&labelColor=333333
+[codecov-link]: https://codecov.io/github/facelessuser/soupsieve
+[pypi-image]: https://img.shields.io/pypi/v/soupsieve.svg?logo=pypi&logoColor=aaaaaa&labelColor=333333
+[pypi-down]: https://img.shields.io/pypi/dm/soupsieve.svg?logo=pypi&logoColor=aaaaaa&labelColor=333333
+[pypi-link]: https://pypi.python.org/pypi/soupsieve
+[python-image]: https://img.shields.io/pypi/pyversions/soupsieve?logo=python&logoColor=aaaaaa&labelColor=333333
+[license-image-mit]: https://img.shields.io/badge/license-MIT-blue.svg?labelColor=333333
+[license-link]: https://github.com/facelessuser/soupsieve/blob/main/LICENSE.md
+[donate-image]: https://img.shields.io/badge/Donate-PayPal-3fabd1?logo=paypal
+[donate-link]: https://www.paypal.me/facelessuser
diff --git a/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/RECORD b/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/RECORD
new file mode 100644
index 0000000..9cd3fe5
--- /dev/null
+++ b/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/RECORD
@@ -0,0 +1,20 @@
+soupsieve-2.8.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+soupsieve-2.8.3.dist-info/METADATA,sha256=T4dV61JnwfNOYmmGwPM1amvWh0emCXp-UWjhQR299CA,4635
+soupsieve-2.8.3.dist-info/RECORD,,
+soupsieve-2.8.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+soupsieve-2.8.3.dist-info/licenses/LICENSE.md,sha256=dqCs25jDpjaB4gtvCWaZ74ytX7NdVu74OH4Ppx15epo,1096
+soupsieve/__init__.py,sha256=FV4Ol2FRldy7rG94nQHNHoJTZIdQbUJdZkGhXkI3tiE,4581
+soupsieve/__meta__.py,sha256=E3T-7sMnV7LDz3ldOR8FmijqLcBMPhGPZgk_OIPQEUc,6766
+soupsieve/__pycache__/__init__.cpython-312.pyc,,
+soupsieve/__pycache__/__meta__.cpython-312.pyc,,
+soupsieve/__pycache__/css_match.cpython-312.pyc,,
+soupsieve/__pycache__/css_parser.cpython-312.pyc,,
+soupsieve/__pycache__/css_types.cpython-312.pyc,,
+soupsieve/__pycache__/pretty.cpython-312.pyc,,
+soupsieve/__pycache__/util.cpython-312.pyc,,
+soupsieve/css_match.py,sha256=QmLmHPDYS8ye_YnRmVOK_Ei1BX_JrCFGiygW2RV9coE,61404
+soupsieve/css_parser.py,sha256=BUdCC03nPuaiRE2Ol3jVlwbV5TDcML4Zr_AGg5tEGNo,47222
+soupsieve/css_types.py,sha256=ycysGoIIBLQxOzbqEv90HKRUH2WO3OsLJ25cjovDd1o,9940
+soupsieve/pretty.py,sha256=iSM-NKCzruJQCwEriQT72LrF4slxsib7TB552H2bsqA,4362
+soupsieve/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+soupsieve/util.py,sha256=Q0MVH77cUBXMtKV0D2f8Syf90remPe0EfLqe6-msAeI,3352
diff --git a/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/WHEEL b/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/WHEEL
new file mode 100644
index 0000000..ae8ec1b
--- /dev/null
+++ b/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/licenses/LICENSE.md b/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/licenses/LICENSE.md
new file mode 100644
index 0000000..128c534
--- /dev/null
+++ b/env/lib/python3.12/site-packages/soupsieve-2.8.3.dist-info/licenses/LICENSE.md
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 - 2026 Isaac Muse 
+
+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/env/lib/python3.12/site-packages/soupsieve/__init__.py b/env/lib/python3.12/site-packages/soupsieve/__init__.py
new file mode 100644
index 0000000..e170c71
--- /dev/null
+++ b/env/lib/python3.12/site-packages/soupsieve/__init__.py
@@ -0,0 +1,168 @@
+"""
+Soup Sieve.
+
+A CSS selector filter for BeautifulSoup4.
+
+MIT License
+
+Copyright (c) 2018 Isaac Muse
+
+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.
+"""
+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
+from typing import Any, Iterator, Iterable
+
+__all__ = (
+    'DEBUG', 'SelectorSyntaxError', 'SoupSieve',
+    'closest', 'compile', 'filter', 'iselect',
+    'match', 'select', 'select_one'
+)
+
+SoupSieve = cm.SoupSieve
+
+
+def compile(  # noqa: A001
+    pattern: str,
+    namespaces: dict[str, str] | None = None,
+    flags: int = 0,
+    *,
+    custom: dict[str, str] | None = None,
+    **kwargs: Any
+) -> cm.SoupSieve:
+    """Compile CSS pattern."""
+
+    if isinstance(pattern, SoupSieve):
+        if flags:
+            raise ValueError("Cannot process 'flags' argument on a compiled selector list")
+        elif namespaces is not None:
+            raise ValueError("Cannot process 'namespaces' argument on a compiled selector list")
+        elif custom is not None:
+            raise ValueError("Cannot process 'custom' argument on a compiled selector list")
+        return pattern
+
+    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:
+    """Purge cached patterns."""
+
+    cp._purge_cache()
+
+
+def closest(
+    select: str,
+    tag: bs4.Tag,
+    namespaces: dict[str, str] | None = None,
+    flags: int = 0,
+    *,
+    custom: dict[str, str] | None = None,
+    **kwargs: Any
+) -> bs4.Tag | None:
+    """Match closest ancestor."""
+
+    return compile(select, namespaces, flags, **kwargs).closest(tag)
+
+
+def match(
+    select: str,
+    tag: bs4.Tag,
+    namespaces: dict[str, str] | None = None,
+    flags: int = 0,
+    *,
+    custom: dict[str, str] | None = None,
+    **kwargs: Any
+) -> bool:
+    """Match node."""
+
+    return compile(select, namespaces, flags, **kwargs).match(tag)
+
+
+def filter(  # noqa: A001
+    select: str,
+    iterable: Iterable[bs4.Tag],
+    namespaces: dict[str, str] | None = None,
+    flags: int = 0,
+    *,
+    custom: dict[str, str] | None = None,
+    **kwargs: Any
+) -> list[bs4.Tag]:
+    """Filter list of nodes."""
+
+    return compile(select, namespaces, flags, **kwargs).filter(iterable)
+
+
+def select_one(
+    select: str,
+    tag: bs4.Tag,
+    namespaces: dict[str, str] | None = None,
+    flags: int = 0,
+    *,
+    custom: dict[str, str] | None = None,
+    **kwargs: Any
+) -> bs4.Tag | None:
+    """Select a single tag."""
+
+    return compile(select, namespaces, flags, **kwargs).select_one(tag)
+
+
+def select(
+    select: str,
+    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]:
+    """Select the specified tags."""
+
+    return compile(select, namespaces, flags, **kwargs).select(tag, limit)
+
+
+def iselect(
+    select: str,
+    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]:
+    """Iterate the specified tags."""
+
+    yield from compile(select, namespaces, flags, **kwargs).iselect(tag, limit)
+
+
+def escape(ident: str) -> str:
+    """Escape identifier."""
+
+    return cp.escape(ident)
diff --git a/env/lib/python3.12/site-packages/soupsieve/__meta__.py b/env/lib/python3.12/site-packages/soupsieve/__meta__.py
new file mode 100644
index 0000000..c472d5c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/soupsieve/__meta__.py
@@ -0,0 +1,197 @@
+"""Meta related things."""
+from __future__ import annotations
+from collections import namedtuple
+import re
+
+RE_VER = re.compile(
+    r'''(?x)
+    (?P\d+)(?:\.(?P\d+))?(?:\.(?P\d+))?
+    (?:(?Pa|b|rc)(?P
    \d+))?
+    (?:\.post(?P\d+))?
+    (?:\.dev(?P\d+))?
+    '''
+)
+
+REL_MAP = {
+    ".dev": "",
+    ".dev-alpha": "a",
+    ".dev-beta": "b",
+    ".dev-candidate": "rc",
+    "alpha": "a",
+    "beta": "b",
+    "candidate": "rc",
+    "final": ""
+}
+
+DEV_STATUS = {
+    ".dev": "2 - Pre-Alpha",
+    ".dev-alpha": "2 - Pre-Alpha",
+    ".dev-beta": "2 - Pre-Alpha",
+    ".dev-candidate": "2 - Pre-Alpha",
+    "alpha": "3 - Alpha",
+    "beta": "4 - Beta",
+    "candidate": "4 - Beta",
+    "final": "5 - Production/Stable"
+}
+
+PRE_REL_MAP = {"a": 'alpha', "b": 'beta', "rc": 'candidate'}
+
+
+class Version(namedtuple("Version", ["major", "minor", "micro", "release", "pre", "post", "dev"])):
+    """
+    Get the version (PEP 440).
+
+    A biased approach to the PEP 440 semantic version.
+
+    Provides a tuple structure which is sorted for comparisons `v1 > v2` etc.
+      (major, minor, micro, release type, pre-release build, post-release build, development release build)
+    Release types are named in is such a way they are comparable with ease.
+    Accessors to check if a development, pre-release, or post-release build. Also provides accessor to get
+    development status for setup files.
+
+    How it works (currently):
+
+    - You must specify a release type as either `final`, `alpha`, `beta`, or `candidate`.
+    - To define a development release, you can use either `.dev`, `.dev-alpha`, `.dev-beta`, or `.dev-candidate`.
+      The dot is used to ensure all development specifiers are sorted before `alpha`.
+      You can specify a `dev` number for development builds, but do not have to as implicit development releases
+      are allowed.
+    - You must specify a `pre` value greater than zero if using a prerelease as this project (not PEP 440) does not
+      allow implicit prereleases.
+    - You can optionally set `post` to a value greater than zero to make the build a post release. While post releases
+      are technically allowed in prereleases, it is strongly discouraged, so we are rejecting them. It should be
+      noted that we do not allow `post0` even though PEP 440 does not restrict this. This project specifically
+      does not allow implicit post releases.
+    - It should be noted that we do not support epochs `1!` or local versions `+some-custom.version-1`.
+
+    Acceptable version releases:
+
+    ```
+    Version(1, 0, 0, "final")                    1.0
+    Version(1, 2, 0, "final")                    1.2
+    Version(1, 2, 3, "final")                    1.2.3
+    Version(1, 2, 0, ".dev-alpha", pre=4)        1.2a4
+    Version(1, 2, 0, ".dev-beta", pre=4)         1.2b4
+    Version(1, 2, 0, ".dev-candidate", pre=4)    1.2rc4
+    Version(1, 2, 0, "final", post=1)            1.2.post1
+    Version(1, 2, 3, ".dev")                     1.2.3.dev0
+    Version(1, 2, 3, ".dev", dev=1)              1.2.3.dev1
+    ```
+
+    """
+
+    def __new__(
+        cls,
+        major: int, minor: int, micro: int, release: str = "final",
+        pre: int = 0, post: int = 0, dev: int = 0
+    ) -> Version:
+        """Validate version info."""
+
+        # Ensure all parts are positive integers.
+        for value in (major, minor, micro, pre, post):
+            if not (isinstance(value, int) and value >= 0):
+                raise ValueError("All version parts except 'release' should be integers.")
+
+        if release not in REL_MAP:
+            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":
+            if pre == 0:
+                raise ValueError("Implicit pre-releases not allowed.")
+            elif dev:
+                raise ValueError("Version is not a development release.")
+            elif post:
+                raise ValueError("Post-releases are not allowed with pre-releases.")
+
+        # Ensure valid development or development/pre release
+        elif release < "alpha":
+            if release > ".dev" and pre == 0:
+                raise ValueError("Implicit pre-release not allowed.")
+            elif post:
+                raise ValueError("Post-releases are not allowed with pre-releases.")
+
+        # Ensure a valid normal release
+        else:
+            if pre:
+                raise ValueError("Version is not a pre-release.")
+            elif dev:
+                raise ValueError("Version is not a development release.")
+
+        return super().__new__(cls, major, minor, micro, release, pre, post, dev)
+
+    def _is_pre(self) -> bool:
+        """Is prerelease."""
+
+        return bool(self.pre > 0)
+
+    def _is_dev(self) -> bool:
+        """Is development."""
+
+        return bool(self.release < "alpha")
+
+    def _is_post(self) -> bool:
+        """Is post."""
+
+        return bool(self.post > 0)
+
+    def _get_dev_status(self) -> str:  # pragma: no cover
+        """Get development status string."""
+
+        return DEV_STATUS[self.release]
+
+    def _get_canonical(self) -> str:
+        """Get the canonical output string."""
+
+        # Assemble major, minor, micro version and append `pre`, `post`, or `dev` if needed..
+        if self.micro == 0:
+            ver = f"{self.major}.{self.minor}"
+        else:
+            ver = f"{self.major}.{self.minor}.{self.micro}"
+        if self._is_pre():
+            ver += f'{REL_MAP[self.release]}{self.pre}'
+        if self._is_post():
+            ver += f".post{self.post}"
+        if self._is_dev():
+            ver += f".dev{self.dev}"
+
+        return ver
+
+
+def parse_version(ver: str) -> Version:
+    """Parse version into a comparable Version tuple."""
+
+    m = RE_VER.match(ver)
+
+    if m is None:
+        raise ValueError(f"'{ver}' is not a valid version")
+
+    # Handle major, minor, micro
+    major = int(m.group('major'))
+    minor = int(m.group('minor')) if m.group('minor') else 0
+    micro = int(m.group('micro')) if m.group('micro') else 0
+
+    # Handle pre releases
+    if m.group('type'):
+        release = PRE_REL_MAP[m.group('type')]
+        pre = int(m.group('pre'))
+    else:
+        release = "final"
+        pre = 0
+
+    # Handle development releases
+    dev = m.group('dev') if m.group('dev') else 0
+    if m.group('dev'):
+        dev = int(m.group('dev'))
+        release = '.dev-' + release if pre else '.dev'
+    else:
+        dev = 0
+
+    # Handle post
+    post = int(m.group('post')) if m.group('post') else 0
+
+    return Version(major, minor, micro, release, pre, post, dev)
+
+
+__version_info__ = Version(2, 8, 3, "final")
+__version__ = __version_info__._get_canonical()
diff --git a/env/lib/python3.12/site-packages/soupsieve/css_match.py b/env/lib/python3.12/site-packages/soupsieve/css_match.py
new file mode 100644
index 0000000..15e3917
--- /dev/null
+++ b/env/lib/python3.12/site-packages/soupsieve/css_match.py
@@ -0,0 +1,1654 @@
+"""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
+from typing import Iterator, Iterable, Any, Callable, Sequence, Any, cast  # noqa: F401, F811
+
+# Empty tag pattern (whitespace okay)
+RE_NOT_EMPTY = re.compile('[^ \t\r\n\f]')
+
+RE_NOT_WS = re.compile('[^ \t\r\n\f]+')
+
+# Relationships
+REL_PARENT = ' '
+REL_CLOSE_PARENT = '>'
+REL_SIBLING = '~'
+REL_CLOSE_SIBLING = '+'
+
+# Relationships for :has() (forward looking)
+REL_HAS_PARENT = ': '
+REL_HAS_CLOSE_PARENT = ':>'
+REL_HAS_SIBLING = ':~'
+REL_HAS_CLOSE_SIBLING = ':+'
+
+NS_XHTML = 'http://www.w3.org/1999/xhtml'
+NS_XML = 'http://www.w3.org/XML/1998/namespace'
+
+DIR_FLAGS = ct.SEL_DIR_LTR | ct.SEL_DIR_RTL
+RANGES = ct.SEL_IN_RANGE | ct.SEL_OUT_OF_RANGE
+
+DIR_MAP = {
+    'ltr': ct.SEL_DIR_LTR,
+    'rtl': ct.SEL_DIR_RTL,
+    'auto': 0
+}
+
+RE_NUM = re.compile(r"^(?P-?(?:[0-9]{1,}(\.[0-9]+)?|\.[0-9]+))$")
+RE_TIME = re.compile(r'^(?P[0-9]{2}):(?P[0-9]{2})$')
+RE_MONTH = re.compile(r'^(?P[0-9]{4,})-(?P[0-9]{2})$')
+RE_WEEK = re.compile(r'^(?P[0-9]{4,})-W(?P[0-9]{2})$')
+RE_DATE = re.compile(r'^(?P[0-9]{4,})-(?P[0-9]{2})-(?P[0-9]{2})$')
+RE_DATETIME = re.compile(
+    r'^(?P[0-9]{4,})-(?P[0-9]{2})-(?P[0-9]{2})T(?P[0-9]{2}):(?P[0-9]{2})$'
+)
+RE_WILD_STRIP = re.compile(r'(?:(?:-\*-)(?:\*(?:-|$))*|-\*$)')
+
+MONTHS_30 = (4, 6, 9, 11)  # April, June, September, and November
+FEB = 2
+SHORT_MONTH = 30
+LONG_MONTH = 31
+FEB_MONTH = 28
+FEB_LEAP_MONTH = 29
+DAYS_IN_WEEK = 7
+
+
+class _FakeParent:
+    """
+    Fake parent class.
+
+    When we have a fragment with no `BeautifulSoup` document object,
+    we can't evaluate `nth` selectors properly.  Create a temporary
+    fake parent so we can traverse the root element as a child.
+    """
+
+    def __init__(self, element: bs4.Tag) -> None:
+        """Initialize."""
+
+        self.contents = [element]
+
+    def __len__(self) -> int:
+        """Length."""
+
+        return len(self.contents)
+
+
+class _DocumentNav:
+    """Navigate a Beautiful Soup document."""
+
+    @classmethod
+    def assert_valid_input(cls, tag: Any) -> None:
+        """Check if valid input tag or document."""
+
+        # Fail on unexpected types.
+        if not cls.is_tag(tag):
+            raise TypeError(f"Expected a BeautifulSoup 'Tag', but instead received type {type(tag)}")
+
+    @staticmethod
+    def is_doc(obj: bs4.element.PageElement | None) -> bool:
+        """Is `BeautifulSoup` object."""
+        return isinstance(obj, bs4.BeautifulSoup)
+
+    @staticmethod
+    def is_tag(obj: bs4.element.PageElement | None) -> bool:
+        """Is tag."""
+        return isinstance(obj, bs4.Tag)
+
+    @staticmethod
+    def is_declaration(obj: bs4.element.PageElement | None) -> bool:  # pragma: no cover
+        """Is declaration."""
+        return isinstance(obj, bs4.Declaration)
+
+    @staticmethod
+    def is_cdata(obj: bs4.element.PageElement | None) -> bool:
+        """Is CDATA."""
+        return isinstance(obj, bs4.CData)
+
+    @staticmethod
+    def is_processing_instruction(obj: bs4.element.PageElement | None) -> bool:  # pragma: no cover
+        """Is processing instruction."""
+        return isinstance(obj, bs4.ProcessingInstruction)
+
+    @staticmethod
+    def is_navigable_string(obj: bs4.element.PageElement | None) -> bool:
+        """Is navigable string."""
+        return isinstance(obj, bs4.element.NavigableString)
+
+    @staticmethod
+    def is_special_string(obj: bs4.element.PageElement | None) -> 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.element.PageElement | None) -> 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:
+        """Create fake parent for a given element."""
+
+        return _FakeParent(el)
+
+    @staticmethod
+    def is_xml_tree(el: bs4.Tag | None) -> bool:
+        """Check if element (or document) is from a XML tree."""
+
+        return el is not None and bool(el._is_xml)
+
+    def is_iframe(self, el: bs4.Tag | None) -> bool:
+        """Check if element is an `iframe`."""
+
+        if el is None:  # pragma: no cover
+            return False
+
+        return bool(
+            ((el.name if self.is_xml_tree(el) else util.lower(el.name)) == 'iframe') and
+            self.is_html_tag(el)  # type: ignore[attr-defined]
+        )
+
+    def is_root(self, el: bs4.Tag) -> bool:
+        """
+        Return whether element is a root element.
+
+        We check that the element is the root of the tree (which we have already pre-calculated),
+        and we check if it is the root element under an `iframe`.
+        """
+
+        root = self.root and self.root is el  # type: ignore[attr-defined]
+        if not root:
+            parent = self.get_parent(el)
+            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 | None, no_iframe: bool = False) -> Iterator[bs4.element.PageElement]:
+        """Get contents or contents in reverse."""
+
+        if el is not None:
+            if not no_iframe or not self.is_iframe(el):
+                yield from el.contents
+
+    def get_tag_children(
+        self,
+        el: bs4.Tag | None,
+        start: int | None = None,
+        reverse: bool = False,
+        no_iframe: bool = False
+    ) -> Iterator[bs4.Tag]:
+        """Get tag children."""
+
+        return self.get_children(el, start, reverse, True, no_iframe)  # type: ignore[return-value]
+
+    def get_children(
+        self,
+        el: bs4.Tag | None,
+        start: int | None = None,
+        reverse: bool = False,
+        tags: bool = False,
+        no_iframe: bool = False
+    ) -> Iterator[bs4.element.PageElement]:
+        """Get children."""
+
+        if el is not None and (not no_iframe or not self.is_iframe(el)):
+            last = len(el.contents) - 1
+            if start is None:
+                index = last if reverse else 0
+            else:
+                index = start
+            end = -1 if reverse else last + 1
+            incr = -1 if reverse else 1
+
+            if 0 <= index <= last:
+                while index != end:
+                    node = el.contents[index]
+                    index += incr
+                    if not tags or self.is_tag(node):
+                        yield node
+
+    def get_tag_descendants(
+        self,
+        el: bs4.Tag | None,
+        no_iframe: bool = False
+    ) -> Iterator[bs4.Tag]:
+        """Specifically get tag descendants."""
+
+        yield from self.get_descendants(el, tags=True, no_iframe=no_iframe)  # type: ignore[misc]
+
+    def get_descendants(
+        self,
+        el: bs4.Tag | None,
+        tags: bool = False,
+        no_iframe: bool = False
+    ) -> Iterator[bs4.element.PageElement]:
+        """Get descendants."""
+
+        if el is not None and (not no_iframe or not self.is_iframe(el)):
+            next_good = None
+            for child in el.descendants:
+
+                if next_good is not None:
+                    if child is not next_good:
+                        continue
+                    next_good = None
+
+                if isinstance(child, bs4.Tag):
+                    if no_iframe and self.is_iframe(child):
+                        if child.next_sibling is not None:
+                            next_good = child.next_sibling
+                        else:
+                            last_child = child  # type: bs4.element.PageElement
+                            while isinstance(last_child, bs4.Tag) and last_child.contents:
+                                last_child = last_child.contents[-1]
+                            next_good = last_child.next_element
+                        yield child
+                        if next_good is None:
+                            break
+                        # Coverage isn't seeing this even though it's executed
+                        continue  # pragma: no cover
+                    yield child
+
+                elif not tags:
+                    yield child
+
+    def get_parent(self, el: bs4.Tag | None, no_iframe: bool = False) -> bs4.Tag | None:
+        """Get parent."""
+
+        parent = el.parent if el is not None else None
+        if no_iframe and parent is not None and self.is_iframe(parent):  # pragma: no cover
+            parent = None
+        return parent
+
+    @staticmethod
+    def get_tag_name(el: bs4.Tag | None) -> str | None:
+        """Get tag."""
+
+        return el.name if el is not None else None
+
+    @staticmethod
+    def get_prefix_name(el: bs4.Tag) -> str | None:
+        """Get prefix."""
+
+        return el.prefix
+
+    @staticmethod
+    def get_uri(el: bs4.Tag | None) -> str | None:
+        """Get namespace `URI`."""
+
+        return el.namespace if el is not None else None
+
+    @classmethod
+    def get_next_tag(cls, el: bs4.Tag) -> bs4.Tag | None:
+        """Get next sibling tag."""
+
+        return cls.get_next(el, tags=True)  # type: ignore[return-value]
+
+    @classmethod
+    def get_next(cls, el: bs4.Tag, tags: bool = False) -> bs4.element.PageElement | None:
+        """Get next sibling tag."""
+
+        sibling = el.next_sibling
+        while tags and not isinstance(sibling, bs4.Tag) and sibling is not None:
+            sibling = sibling.next_sibling
+
+        if tags and not isinstance(sibling, bs4.Tag):
+            sibling = None
+
+        return sibling
+
+    @classmethod
+    def get_previous_tag(cls, el: bs4.Tag, tags: bool = True) -> bs4.Tag | None:
+        """Get previous sibling tag."""
+
+        return cls.get_previous(el, True)  # type: ignore[return-value]
+
+    @classmethod
+    def get_previous(cls, el: bs4.Tag, tags: bool = False) -> bs4.element.PageElement | None:
+        """Get previous sibling tag."""
+
+        sibling = el.previous_sibling
+        while tags and not isinstance(sibling, bs4.Tag) and sibling is not None:
+            sibling = sibling.previous_sibling
+
+        if tags and not isinstance(sibling, bs4.Tag):
+            sibling = None
+
+        return sibling
+
+    @staticmethod
+    def has_html_ns(el: bs4.Tag | None) -> bool:
+        """
+        Check if element has an HTML namespace.
+
+        This is a bit different than whether a element is treated as having an HTML namespace,
+        like we do in the case of `is_html_tag`.
+        """
+
+        ns = getattr(el, 'namespace') if el is not None else None  # noqa: B009
+        return bool(ns and ns == NS_XHTML)
+
+    @staticmethod
+    def split_namespace(el: bs4.Tag | None, attr_name: str) -> tuple[str | None, str | None]:
+        """Return namespace and attribute name without the prefix."""
+
+        if el is None:  # pragma: no cover
+            return None, None
+
+        return getattr(attr_name, 'namespace', None), getattr(attr_name, 'name', None)
+
+    @classmethod
+    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.
+        if value is None:
+            return ''
+
+        # Pass through strings
+        if (isinstance(value, str)):
+            return value
+
+        # If it's a byte string, convert it to Unicode, treating it as UTF-8.
+        if isinstance(value, bytes):
+            return value.decode("utf8")
+
+        # BeautifulSoup supports sequences of attribute values, so make sure the children are strings.
+        if isinstance(value, Sequence):
+            new_value = []
+            for v in value:
+                if not isinstance(v, (str, bytes)) and isinstance(v, Sequence):
+                    # This is most certainly a user error and will crash and burn later.
+                    # To keep things working, we'll do what we do with all objects,
+                    # And convert them to strings.
+                    new_value.append(str(v))
+                else:
+                    # Convert the child to a string
+                    new_value.append(cast(str, cls.normalize_value(v)))
+            return new_value
+
+        # Try and make anything else a string
+        return str(value)
+
+    @classmethod
+    def get_attribute_by_name(
+        cls,
+        el: bs4.Tag,
+        name: str,
+        default: str | Sequence[str] | None = None
+    ) -> str | Sequence[str] | None:
+        """Get attribute by name."""
+
+        value = default
+        if el._is_xml:
+            try:
+                value = cls.normalize_value(el.attrs[name])
+            except KeyError:
+                pass
+        else:
+            for k, v in el.attrs.items():
+                if util.lower(k) == name:
+                    value = cls.normalize_value(v)
+                    break
+        return value
+
+    @classmethod
+    def iter_attributes(cls, el: bs4.Tag | None) -> Iterator[tuple[str, str | Sequence[str] | None]]:
+        """Iterate attributes."""
+
+        if el is not None:
+            for k, v in el.attrs.items():
+                yield k, cls.normalize_value(v)
+
+    @classmethod
+    def get_classes(cls, el: bs4.Tag) -> Sequence[str]:
+        """Get classes."""
+
+        classes = cls.get_attribute_by_name(el, 'class', [])
+        if isinstance(classes, str):
+            classes = RE_NOT_WS.findall(classes)
+        return cast(Sequence[str], classes)
+
+    def get_text(self, el: bs4.Tag, no_iframe: bool = False) -> str:
+        """Get text."""
+
+        return ''.join(
+            [
+                node for node in self.get_descendants(el, no_iframe=no_iframe)  # type: ignore[misc]
+                if self.is_content_string(node)
+            ]
+        )
+
+    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)  # type: ignore[misc]
+        ]
+
+
+class Inputs:
+    """Class for parsing and validating input items."""
+
+    @staticmethod
+    def validate_day(year: int, month: int, day: int) -> bool:
+        """Validate day."""
+
+        max_days = LONG_MONTH
+        if month == FEB:
+            max_days = FEB_LEAP_MONTH if ((year % 4 == 0) and (year % 100 != 0)) or (year % 400 == 0) else FEB_MONTH
+        elif month in MONTHS_30:
+            max_days = SHORT_MONTH
+        return 1 <= day <= max_days
+
+    @staticmethod
+    def validate_week(year: int, week: int) -> bool:
+        """Validate week."""
+
+        # Validate an ISO week number for `year`.
+        #
+        # Per ISO 8601 rules, the last ISO week of a year is the week
+        # containing Dec 28. Using Dec 28 guarantees we obtain the
+        # correct ISO week-number for the final week of `year`, even in
+        # years where Dec 31 falls in ISO week 01 of the following year.
+        #
+        # Example: if Dec 31 is a Thursday the year's last ISO week will
+        # be week 53; if Dec 31 is a Monday and that week is counted as
+        # week 1 of the next year, Dec 28 still belongs to the final
+        # week of the current ISO year and yields the correct max week.
+        max_week = datetime(year, 12, 28).isocalendar()[1]
+        return 1 <= week <= max_week
+
+    @staticmethod
+    def validate_month(month: int) -> bool:
+        """Validate month."""
+
+        return 1 <= month <= 12
+
+    @staticmethod
+    def validate_year(year: int) -> bool:
+        """Validate year."""
+
+        return 1 <= year
+
+    @staticmethod
+    def validate_hour(hour: int) -> bool:
+        """Validate hour."""
+
+        return 0 <= hour <= 23
+
+    @staticmethod
+    def validate_minutes(minutes: int) -> bool:
+        """Validate minutes."""
+
+        return 0 <= minutes <= 59
+
+    @classmethod
+    def parse_value(cls, itype: str, value: str | None) -> tuple[float, ...] | None:
+        """Parse the input value."""
+
+        parsed = None  # type: tuple[float, ...] | None
+        if value is None:
+            return value
+        if itype == "date":
+            m = RE_DATE.match(value)
+            if m:
+                year = int(m.group('year'), 10)
+                month = int(m.group('month'), 10)
+                day = int(m.group('day'), 10)
+                if cls.validate_year(year) and cls.validate_month(month) and cls.validate_day(year, month, day):
+                    parsed = (year, month, day)
+        elif itype == "month":
+            m = RE_MONTH.match(value)
+            if m:
+                year = int(m.group('year'), 10)
+                month = int(m.group('month'), 10)
+                if cls.validate_year(year) and cls.validate_month(month):
+                    parsed = (year, month)
+        elif itype == "week":
+            m = RE_WEEK.match(value)
+            if m:
+                year = int(m.group('year'), 10)
+                week = int(m.group('week'), 10)
+                if cls.validate_year(year) and cls.validate_week(year, week):
+                    parsed = (year, week)
+        elif itype == "time":
+            m = RE_TIME.match(value)
+            if m:
+                hour = int(m.group('hour'), 10)
+                minutes = int(m.group('minutes'), 10)
+                if cls.validate_hour(hour) and cls.validate_minutes(minutes):
+                    parsed = (hour, minutes)
+        elif itype == "datetime-local":
+            m = RE_DATETIME.match(value)
+            if m:
+                year = int(m.group('year'), 10)
+                month = int(m.group('month'), 10)
+                day = int(m.group('day'), 10)
+                hour = int(m.group('hour'), 10)
+                minutes = int(m.group('minutes'), 10)
+                if (
+                    cls.validate_year(year) and cls.validate_month(month) and cls.validate_day(year, month, day) and
+                    cls.validate_hour(hour) and cls.validate_minutes(minutes)
+                ):
+                    parsed = (year, month, day, hour, minutes)
+        elif itype in ("number", "range"):
+            m = RE_NUM.match(value)
+            if m:
+                parsed = (float(m.group('value')),)
+        return parsed
+
+
+class CSSMatch(_DocumentNav):
+    """Perform CSS matching."""
+
+    def __init__(
+        self,
+        selectors: ct.SelectorList,
+        scope: bs4.Tag | None,
+        namespaces: ct.Namespaces | None,
+        flags: int
+    ) -> None:
+        """Initialize."""
+
+        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.selectors = selectors
+        self.namespaces = {} if namespaces is None else namespaces  # type: ct.Namespaces | dict[str, str]
+        self.flags = flags
+        self.iframe_restrict = False
+
+        # Find the root element for the whole tree
+        doc = scope
+        parent = self.get_parent(doc)
+        while parent:
+            doc = parent
+            parent = self.get_parent(doc)
+        root = None  # type: bs4.Tag | None
+        if not self.is_doc(doc):
+            root = doc
+        else:
+            for child in self.get_tag_children(doc):
+                root = child
+                break
+
+        self.root = root
+        self.scope = scope if scope is not doc else root
+        self.has_html_namespace = self.has_html_ns(root)
+
+        # A document can be both XML and HTML (XHTML)
+        self.is_xml = self.is_xml_tree(doc)
+        self.is_html = not self.is_xml or self.has_html_namespace
+
+    def supports_namespaces(self) -> bool:
+        """Check if namespaces are supported in the HTML type."""
+
+        return self.is_xml or self.has_html_namespace
+
+    def get_tag_ns(self, el: bs4.Tag | None) -> str:
+        """Get tag namespace."""
+
+        namespace = ''
+        if el is None:  # pragma: no cover
+            return namespace
+
+        if self.supports_namespaces():
+            ns = self.get_uri(el)
+            if ns:
+                namespace = ns
+        else:
+            namespace = NS_XHTML
+        return namespace
+
+    def is_html_tag(self, el: bs4.Tag | None) -> bool:
+        """Check if tag is in HTML namespace."""
+
+        return self.get_tag_ns(el) == NS_XHTML
+
+    def get_tag(self, el: bs4.Tag | None) -> 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) -> 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) -> int | None:
+        """Get directionality from element text."""
+
+        for node in self.get_children(el):
+
+            # Analyze child text nodes
+            if self.is_tag(node):
+
+                # Avoid analyzing certain elements specified in the specification.
+                direction = DIR_MAP.get(util.lower(self.get_attribute_by_name(node, 'dir', '')), None)  # type: ignore[arg-type]
+                name = self.get_tag(node)  # type: ignore[arg-type]
+                if (
+                    (name and name in ('bdi', 'script', 'style', 'textarea', 'iframe')) or
+                    not self.is_html_tag(node) or  # type: ignore[arg-type]
+                    direction is not None
+                ):
+                    continue  # pragma: no cover
+
+                # Check directionality of this node's text
+                value = self.find_bidi(node)  # type: ignore[arg-type]
+                if value is not None:
+                    return value
+
+                # Direction could not be determined
+                continue  # pragma: no cover
+
+            # Skip `doctype` comments, etc.
+            if self.is_special_string(node):
+                continue
+
+            # Analyze text nodes for directionality.
+            for c in node:  # type: ignore[attr-defined]
+                bidi = unicodedata.bidirectional(c)
+                if bidi in ('AL', 'R', 'L'):
+                    return ct.SEL_DIR_LTR if bidi == 'L' else ct.SEL_DIR_RTL
+        return None
+
+    def extended_language_filter(self, lang_range: str, lang_tag: str) -> bool:
+        """Filter the language tags."""
+
+        match = True
+        lang_range = RE_WILD_STRIP.sub('-', lang_range).lower()
+        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) or (r == '*' and slength == 1 and not s):
+            match = False
+
+        rindex += 1
+        sindex += 1
+
+        # Match until we run out of ranges
+        while match and rindex < length:
+            r = ranges[rindex]
+            try:
+                s = subtags[sindex]
+            except IndexError:
+                # Ran out of subtags,
+                # but we still have ranges
+                match = False
+                continue
+
+            # Empty range
+            if not r:
+                match = False
+                continue
+
+            # Matched range
+            elif s == r:
+                rindex += 1
+
+            # Implicit wildcard cannot match
+            # singletons
+            elif len(s) == 1:
+                match = False
+                continue
+
+            # Implicitly matched, so grab next subtag
+            sindex += 1
+
+        return match
+
+    def match_attribute_name(
+        self,
+        el: bs4.Tag,
+        attr: str,
+        prefix: str | None
+    ) -> str | Sequence[str] | None:
+        """Match attribute name and return value if it exists."""
+
+        value = None
+        if self.supports_namespaces():
+            value = None
+            # If we have not defined namespaces, we can't very well find them, so don't bother trying.
+            if prefix:
+                ns = self.namespaces.get(prefix)
+                if ns is None and prefix != '*':
+                    return None
+            else:
+                ns = None
+
+            for k, v in self.iter_attributes(el):
+
+                # Get attribute parts
+                namespace, name = self.split_namespace(el, k)
+
+                # Can't match a prefix attribute as we haven't specified one to match
+                # Try to match it normally as a whole `p:a` as selector may be trying `p\:a`.
+                if ns is None:
+                    if (self.is_xml and attr == k) or (not self.is_xml and util.lower(attr) == util.lower(k)):
+                        value = v
+                        break
+                    # Coverage is not finding this even though it is executed.
+                    # Adding a print statement before this (and erasing coverage) causes coverage to find the line.
+                    # Ignore the false positive message.
+                    continue  # pragma: no cover
+
+                # We can't match our desired prefix attribute as the attribute doesn't have a prefix
+                if namespace is None or (ns != namespace and prefix != '*'):
+                    continue
+
+                # The attribute doesn't match.
+                if (util.lower(attr) != util.lower(name)) if not self.is_xml else (attr != name):
+                    continue
+
+                value = v
+                break
+        else:
+            for k, v in self.iter_attributes(el):
+                if util.lower(attr) != util.lower(k):
+                    continue
+                value = v
+                break
+        return value
+
+    def match_namespace(self, el: bs4.Tag, tag: ct.SelectorTag) -> bool:
+        """Match the namespace of the element."""
+
+        match = True
+        namespace = self.get_tag_ns(el)
+        default_namespace = self.namespaces.get('')
+        tag_ns = '' if tag.prefix is None else self.namespaces.get(tag.prefix)
+        # We must match the default namespace if one is not provided
+        if tag.prefix is None and (default_namespace is not None and namespace != default_namespace):
+            match = False
+        # If we specified `|tag`, we must not have a namespace.
+        elif (tag.prefix is not None and tag.prefix == '' and namespace):
+            match = False
+        # Verify prefix matches
+        elif (
+            tag.prefix and
+            tag.prefix != '*' and (tag_ns is None or namespace != tag_ns)
+        ):
+            match = False
+        return match
+
+    def match_attributes(self, el: bs4.Tag, attributes: tuple[ct.SelectorAttribute, ...]) -> bool:
+        """Match attributes."""
+
+        match = True
+        if attributes:
+            for a in attributes:
+                temp = self.match_attribute_name(el, a.attribute, a.prefix)
+                pattern = a.xml_type_pattern if self.is_xml and a.xml_type_pattern else a.pattern
+                if temp is None:
+                    match = False
+                    break
+                value = temp if isinstance(temp, str) else ' '.join(temp)
+                if pattern is None:
+                    continue
+                elif pattern.match(value) is None:
+                    match = False
+                    break
+        return match
+
+    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)
+        return not (
+            name is not None and
+            name not in (self.get_tag(el), '*')
+        )
+
+    def match_tag(self, el: bs4.Tag, tag: ct.SelectorTag | None) -> bool:
+        """Match the tag."""
+
+        match = True
+        if tag is not None:
+            # Verify namespace
+            if not self.match_namespace(el, tag):
+                match = False
+            if not self.match_tagname(el, tag):
+                match = False
+        return match
+
+    def match_past_relations(self, el: bs4.Tag, relation: ct.SelectorList) -> bool:
+        """Match past relationship."""
+
+        found = False
+        # I don't think this can ever happen, but it makes `mypy` happy
+        if isinstance(relation[0], ct.SelectorNull):  # pragma: no cover
+            return found
+
+        if relation[0].rel_type == REL_PARENT:
+            parent = self.get_parent(el, no_iframe=self.iframe_restrict)
+            while not found and parent:
+                found = self.match_selectors(parent, relation)
+                parent = self.get_parent(parent, no_iframe=self.iframe_restrict)
+        elif relation[0].rel_type == REL_CLOSE_PARENT:
+            parent = self.get_parent(el, no_iframe=self.iframe_restrict)
+            if parent:
+                found = self.match_selectors(parent, relation)
+        elif relation[0].rel_type == REL_SIBLING:
+            sibling = self.get_previous_tag(el)
+            while not found and sibling:
+                found = self.match_selectors(sibling, relation)
+                sibling = self.get_previous_tag(sibling)
+        elif relation[0].rel_type == REL_CLOSE_SIBLING:
+            sibling = self.get_previous_tag(el)
+            if sibling and self.is_tag(sibling):
+                found = self.match_selectors(sibling, relation)
+        return found
+
+    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_tag_descendants  # type: Callable[..., Iterator[bs4.Tag]]
+        else:
+            children = self.get_tag_children
+        for child in children(parent, no_iframe=self.iframe_restrict):
+            match = self.match_selectors(child, relation)
+            if match:
+                break
+        return match
+
+    def match_future_relations(self, el: bs4.Tag, relation: ct.SelectorList) -> bool:
+        """Match future relationship."""
+
+        found = False
+        # I don't think this can ever happen, but it makes `mypy` happy
+        if isinstance(relation[0], ct.SelectorNull):  # pragma: no cover
+            return found
+
+        if relation[0].rel_type == REL_HAS_PARENT:
+            found = self.match_future_child(el, relation, True)
+        elif relation[0].rel_type == REL_HAS_CLOSE_PARENT:
+            found = self.match_future_child(el, relation)
+        elif relation[0].rel_type == REL_HAS_SIBLING:
+            sibling = self.get_next_tag(el)
+            while not found and sibling:
+                found = self.match_selectors(sibling, relation)
+                sibling = self.get_next_tag(sibling)
+        elif relation[0].rel_type == REL_HAS_CLOSE_SIBLING:
+            sibling = self.get_next_tag(el)
+            if sibling and self.is_tag(sibling):
+                found = self.match_selectors(sibling, relation)
+        return found
+
+    def match_relations(self, el: bs4.Tag, relation: ct.SelectorList) -> bool:
+        """Match relationship to other elements."""
+
+        found = False
+
+        if isinstance(relation[0], ct.SelectorNull) or relation[0].rel_type is None:
+            return found
+
+        if relation[0].rel_type.startswith(':'):
+            found = self.match_future_relations(el, relation)
+        else:
+            found = self.match_past_relations(el, relation)
+
+        return found
+
+    def match_id(self, el: bs4.Tag, ids: tuple[str, ...]) -> bool:
+        """Match element's ID."""
+
+        found = True
+        for i in ids:
+            if i != self.get_attribute_by_name(el, 'id', ''):
+                found = False
+                break
+        return found
+
+    def match_classes(self, el: bs4.Tag, classes: tuple[str, ...]) -> bool:
+        """Match element's classes."""
+
+        current_classes = self.get_classes(el)
+        found = True
+        for c in classes:
+            if c not in current_classes:
+                found = False
+                break
+        return found
+
+    def match_root(self, el: bs4.Tag) -> bool:
+        """Match element as root."""
+
+        is_root = self.is_root(el)
+        if is_root:
+            sibling = self.get_previous(el)  # type: Any
+            while is_root and sibling is not None:
+                if (
+                    self.is_tag(sibling) or (self.is_content_string(sibling) and sibling.strip()) or
+                    self.is_cdata(sibling)
+                ):
+                    is_root = False
+                else:
+                    sibling = self.get_previous(sibling)
+        if is_root:
+            sibling = self.get_next(el)
+            while is_root and sibling is not None:
+                if (
+                    self.is_tag(sibling) or (self.is_content_string(sibling) and sibling.strip()) or
+                    self.is_cdata(sibling)
+                ):
+                    is_root = False
+                else:
+                    sibling = self.get_next(sibling)
+        return is_root
+
+    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:
+        """Match tag type for `nth` matches."""
+
+        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: tuple[ct.SelectorNth, ...]) -> bool:
+        """Match `nth` elements."""
+
+        matched = True
+
+        for n in nth:
+            matched = False
+            if n.selectors and not self.match_selectors(el, n.selectors):
+                break
+            parent = self.get_parent(el)  # type: bs4.Tag | None
+            if parent is None:
+                parent = cast('bs4.Tag', self.create_fake_parent(el))
+            last = n.last
+            last_index = len(parent) - 1
+            index = last_index if last else 0
+            relative_index = 0
+            a = n.a
+            b = n.b
+            var = n.n
+            count = 0
+            count_incr = 1
+            factor = -1 if last else 1
+            idx = last_idx = a * count + b if var else a
+
+            # We can only adjust bounds within a variable index
+            if var:
+                # Abort if our nth index is out of bounds and only getting further out of bounds as we increment.
+                # Otherwise, increment to try to get in bounds.
+                adjust = None
+                while idx < 1 or idx > last_index:
+                    if idx < 0:
+                        diff_low = 0 - idx
+                        if adjust is not None and adjust == 1:
+                            break
+                        adjust = -1
+                        count += count_incr
+                        idx = last_idx = a * count + b if var else a
+                        diff = 0 - idx
+                        if diff >= diff_low:
+                            break
+                    else:
+                        diff_high = idx - last_index
+                        if adjust is not None and adjust == -1:
+                            break
+                        adjust = 1
+                        count += count_incr
+                        idx = last_idx = a * count + b if var else a
+                        diff = idx - last_index
+                        if diff >= diff_high:
+                            break
+                        diff_high = diff
+
+                # If a < 0, our count is working backwards, so floor the index by increasing the count.
+                # Find the count that yields the lowest, in bound value and use that.
+                # Lastly reverse count increment so that we'll increase our index.
+                lowest = count
+                if a < 0:
+                    while idx >= 1:
+                        lowest = count
+                        count += count_incr
+                        idx = last_idx = a * count + b if var else a
+                    count_incr = -1
+                count = lowest
+                idx = last_idx = a * count + b if var else a
+
+            # Evaluate elements while our calculated nth index is still in range
+            while 1 <= idx <= last_index + 1:
+                child = None  # type: bs4.element.PageElement | None
+                # Evaluate while our child index is still in range.
+                for child in self.get_children(parent, start=index, reverse=factor < 0):
+                    index += factor
+                    if not isinstance(child, bs4.Tag):
+                        continue
+                    # Handle `of S` in `nth-child`
+                    if n.selectors and not self.match_selectors(child, n.selectors):
+                        continue
+                    # Handle `of-type`
+                    if n.of_type and not self.match_nth_tag_type(el, child):
+                        continue
+                    relative_index += 1
+                    if relative_index == idx:
+                        if child is el:
+                            matched = True
+                        else:
+                            break
+                    if child is el:
+                        break
+                if child is el:
+                    break
+                last_idx = idx
+                count += count_incr
+                if count < 0:
+                    # Count is counting down and has now ventured into invalid territory.
+                    break
+                idx = a * count + b if var else a
+                if last_idx == idx:
+                    break
+            if not matched:
+                break
+        return matched
+
+    def match_empty(self, el: bs4.Tag) -> bool:
+        """Check if element is empty (if requested)."""
+
+        is_empty = True
+        for child in self.get_children(el):
+            if self.is_tag(child):
+                is_empty = False
+                break
+            elif self.is_content_string(child) and RE_NOT_EMPTY.search(child):  # type: ignore[call-overload]
+                is_empty = False
+                break
+        return is_empty
+
+    def match_subselectors(self, el: bs4.Tag, selectors: tuple[ct.SelectorList, ...]) -> bool:
+        """Match selectors."""
+
+        match = True
+        for sel in selectors:
+            if not self.match_selectors(el, sel):
+                match = False
+        return match
+
+    def match_contains(self, el: bs4.Tag, contains: tuple[ct.SelectorContains, ...]) -> bool:
+        """Match element if it contains text."""
+
+        match = True
+        content = None  # type: str | Sequence[str] | None
+        for contain_list in contains:
+            if content is None:
+                if contain_list.own:
+                    content = self.get_own_text(el, no_iframe=self.is_html)
+                else:
+                    content = self.get_text(el, no_iframe=self.is_html)
+            found = False
+            for text in contain_list.text:
+                if contain_list.own:
+                    for c in content:
+                        if text in c:
+                            found = True
+                            break
+                    if found:
+                        break
+                else:
+                    if text in content:
+                        found = True
+                        break
+            if not found:
+                match = False
+        return match
+
+    def match_default(self, el: bs4.Tag) -> bool:
+        """Match default."""
+
+        match = False
+
+        # Find this input's form
+        form = None  # type: bs4.Tag | None
+        parent = self.get_parent(el, no_iframe=True)
+        while parent and form is None:
+            if self.get_tag(parent) == 'form' and self.is_html_tag(parent):
+                form = parent
+            else:
+                parent = self.get_parent(parent, no_iframe=True)
+
+        if form is not None:
+            # Look in form cache to see if we've already located its default button
+            found_form = False
+            for f, t in self.cached_default_forms:
+                if f is form:
+                    found_form = True
+                    if t is el:
+                        match = True
+                    break
+
+            # We didn't have the form cached, so look for its default button
+            if not found_form:
+                for child in self.get_tag_descendants(form, no_iframe=True):
+                    name = self.get_tag(child)
+                    # Can't do nested forms (haven't figured out why we never hit this)
+                    if name == 'form':  # pragma: no cover
+                        break
+                    if name in ('input', 'button'):
+                        v = self.get_attribute_by_name(child, 'type', '')
+                        if v and util.lower(v) == 'submit':
+                            self.cached_default_forms.append((form, child))
+                            if el is child:
+                                match = True
+                            break
+        return match
+
+    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) -> bs4.Tag | None:
+            """Find this input's form."""
+            form = None
+            parent = self.get_parent(el, no_iframe=True)
+            while form is None:
+                if self.get_tag(parent) == 'form' and self.is_html_tag(parent):
+                    form = parent
+                    break
+                last_parent = parent
+                parent = self.get_parent(parent, no_iframe=True)
+                if parent is None:
+                    form = last_parent
+                    break
+            return form
+
+        form = get_parent_form(el)
+
+        # Look in form cache to see if we've already evaluated that its fellow radio buttons are indeterminate
+        if form is not None:
+            found_form = False
+            for f, n, i in self.cached_indeterminate_forms:
+                if f is form and n == name:
+                    found_form = True
+                    if i is True:
+                        match = True
+                    break
+
+            # We didn't have the form cached, so validate that the radio button is indeterminate
+            if not found_form:
+                checked = False
+                for child in self.get_tag_descendants(form, no_iframe=True):
+                    if child is el:
+                        continue
+                    tag_name = self.get_tag(child)
+                    if tag_name == 'input':
+                        is_radio = False
+                        check = False
+                        has_name = False
+                        for k, v in self.iter_attributes(child):
+                            if util.lower(k) == 'type' and util.lower(v) == 'radio':
+                                is_radio = True
+                            elif util.lower(k) == 'name' and v == name:
+                                has_name = True
+                            elif util.lower(k) == 'checked':
+                                check = True
+                            if is_radio and check and has_name and get_parent_form(child) is form:
+                                checked = True
+                                break
+                    if checked:
+                        break
+                if not checked:
+                    match = True
+                self.cached_indeterminate_forms.append((form, name, match))
+
+        return match
+
+    def match_lang(self, el: bs4.Tag, langs: tuple[ct.SelectorLang, ...]) -> bool:
+        """Match languages."""
+
+        match = False
+        has_ns = self.supports_namespaces()
+        root = self.root
+        has_html_namespace = self.has_html_namespace
+
+        # Walk parents looking for `lang` (HTML) or `xml:lang` XML property.
+        parent = el  # type: bs4.Tag | None
+        found_lang = None
+        last = None
+        while not found_lang:
+            has_html_ns = self.has_html_ns(parent)
+            for k, v in self.iter_attributes(parent):
+                attr_ns, attr = self.split_namespace(parent, k)
+                if (
+                    ((not has_ns or has_html_ns) and (util.lower(k) if not self.is_xml else k) == 'lang') or
+                    (
+                        has_ns and not has_html_ns and attr_ns == NS_XML and
+                        (util.lower(attr) if not self.is_xml and attr is not None else attr) == 'lang'
+                    )
+                ):
+                    found_lang = v
+                    break
+            last = parent
+            parent = self.get_parent(parent, no_iframe=self.is_html)
+
+            if parent is None:
+                root = last
+                has_html_namespace = self.has_html_ns(root)
+                parent = last
+                break
+
+        # Use cached meta language.
+        if found_lang is None and self.cached_meta_lang:
+            for cache in self.cached_meta_lang:
+                if root is not None and cast(str, root) is cache[0]:
+                    found_lang = cache[1]
+
+        # If we couldn't find a language, and the document is HTML, look to meta to determine language.
+        if found_lang is None and (not self.is_xml or (has_html_namespace and root and root.name == 'html')):
+            # Find head
+            found = False
+            for tag in ('html', 'head'):
+                found = False
+                for child in self.get_tag_children(parent, no_iframe=self.is_html):
+                    if self.get_tag(child) == tag and self.is_html_tag(child):
+                        found = True
+                        parent = child
+                        break
+                if not found:  # pragma: no cover
+                    break
+
+            # Search meta tags
+            if found and parent is not None:
+                for child2 in parent:
+                    if isinstance(child2, bs4.Tag) and self.get_tag(child2) == 'meta' and self.is_html_tag(parent):
+                        c_lang = False
+                        content = None
+                        for k, v in self.iter_attributes(child2):
+                            if util.lower(k) == 'http-equiv' and util.lower(v) == 'content-language':
+                                c_lang = True
+                            if util.lower(k) == 'content':
+                                content = v
+                            if c_lang and content:
+                                found_lang = content
+                                self.cached_meta_lang.append((cast(str, root), cast(str, found_lang)))
+                                break
+                    if found_lang is not None:
+                        break
+                if found_lang is None:
+                    self.cached_meta_lang.append((cast(str, root), ''))
+
+        # If we determined a language, compare.
+        if found_lang is not None:
+            for patterns in langs:
+                match = False
+                for pattern in patterns:
+                    if self.extended_language_filter(pattern, cast(str, found_lang)):
+                        match = True
+                if not match:
+                    break
+
+        return match
+
+    def match_dir(self, el: bs4.Tag | None, directionality: int) -> bool:
+        """Check directionality."""
+
+        # If we have to match both left and right, we can't match either.
+        if directionality & ct.SEL_DIR_LTR and directionality & ct.SEL_DIR_RTL:
+            return False
+
+        if el is None or not self.is_html_tag(el):
+            return False
+
+        # Element has defined direction of left to right or right to left
+        direction = DIR_MAP.get(util.lower(self.get_attribute_by_name(el, 'dir', '')), None)
+        if direction not in (None, 0):
+            return direction == directionality
+
+        # Element is the document element (the root) and no direction assigned, assume left to right.
+        is_root = self.is_root(el)
+        if is_root and direction is None:
+            return ct.SEL_DIR_LTR == directionality
+
+        # If `input[type=telephone]` and no direction is assigned, assume left to right.
+        name = self.get_tag(el)
+        is_input = name == 'input'
+        is_textarea = name == 'textarea'
+        is_bdi = name == 'bdi'
+        itype = util.lower(self.get_attribute_by_name(el, 'type', '')) if is_input else ''
+        if is_input and itype == 'tel' and direction is None:
+            return ct.SEL_DIR_LTR == directionality
+
+        # 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:
+                value = ''.join(node for node in self.get_contents(el, no_iframe=True) if self.is_content_string(node))  # type: ignore[misc]
+            else:
+                value = cast(str, self.get_attribute_by_name(el, 'value', ''))
+            if value:
+                for c in value:
+                    bidi = unicodedata.bidirectional(c)
+                    if bidi in ('AL', 'R', 'L'):
+                        direction = ct.SEL_DIR_LTR if bidi == 'L' else ct.SEL_DIR_RTL
+                        return direction == directionality
+                # Assume left to right
+                return ct.SEL_DIR_LTR == directionality
+            elif is_root:
+                return ct.SEL_DIR_LTR == directionality
+            return self.match_dir(self.get_parent(el, no_iframe=True), directionality)
+
+        # Auto handling for `bdi` and other non text inputs.
+        if (is_bdi and direction is None) or direction == 0:
+            direction = self.find_bidi(el)
+            if direction is not None:
+                return direction == directionality
+            elif is_root:
+                return ct.SEL_DIR_LTR == directionality
+            return self.match_dir(self.get_parent(el, no_iframe=True), directionality)
+
+        # 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:
+        """
+        Match range.
+
+        Behavior is modeled after what we see in browsers. Browsers seem to evaluate
+        if the value is out of range, and if not, it is in range. So a missing value
+        will not evaluate out of range; therefore, value is in range. Personally, I
+        feel like this should evaluate as neither in or out of range.
+        """
+
+        out_of_range = False
+
+        itype = util.lower(self.get_attribute_by_name(el, 'type'))
+        mn = Inputs.parse_value(itype, cast(str, self.get_attribute_by_name(el, 'min', None)))
+        mx = Inputs.parse_value(itype, cast(str, self.get_attribute_by_name(el, 'max', None)))
+
+        # There is no valid min or max, so we cannot evaluate a range
+        if mn is None and mx is None:
+            return False
+
+        value = Inputs.parse_value(itype, cast(str, self.get_attribute_by_name(el, 'value', None)))
+        if value is not None:
+            if itype in ("date", "datetime-local", "month", "week", "number", "range"):
+                if mn is not None and value < mn:
+                    out_of_range = True
+                if not out_of_range and mx is not None and value > mx:
+                    out_of_range = True
+            elif itype == "time":
+                if mn is not None and mx is not None and mn > mx:
+                    # Time is periodic, so this is a reversed/discontinuous range
+                    if value < mn and value > mx:
+                        out_of_range = True
+                else:
+                    if mn is not None and value < mn:
+                        out_of_range = True
+                    if not out_of_range and mx is not None and value > mx:
+                        out_of_range = True
+
+        return not out_of_range if condition & ct.SEL_IN_RANGE else out_of_range
+
+    def match_defined(self, el: bs4.Tag) -> bool:
+        """
+        Match defined.
+
+        `:defined` is related to custom elements in a browser.
+
+        - If the document is XML (not XHTML), all tags will match.
+        - Tags that are not custom (don't have a hyphen) are marked defined.
+        - If the tag has a prefix (without or without a namespace), it will not match.
+
+        This is of course requires the parser to provide us with the proper prefix and namespace info,
+        if it doesn't, there is nothing we can do.
+        """
+
+        name = self.get_tag(el)
+        return (
+            name is not None and (
+                name.find('-') == -1 or
+                name.find(':') != -1 or
+                self.get_prefix(el) is not None
+            )
+        )
+
+    def match_placeholder_shown(self, el: bs4.Tag) -> bool:
+        """
+        Match placeholder shown according to HTML spec.
+
+        - text area should be checked if they have content. A single newline does not count as content.
+
+        """
+
+        match = False
+        content = self.get_text(el)
+        if content in ('', '\n'):
+            match = True
+
+        return match
+
+    def match_selectors(self, el: bs4.Tag, selectors: ct.SelectorList) -> bool:
+        """Check if element matches one of the selectors."""
+
+        match = False
+        is_not = selectors.is_not
+        is_html = selectors.is_html
+
+        # Internal selector lists that use the HTML flag, will automatically get the `html` namespace.
+        if is_html:
+            namespaces = self.namespaces
+            iframe_restrict = self.iframe_restrict
+            self.namespaces = {'html': NS_XHTML}
+            self.iframe_restrict = True
+
+        if not is_html or self.is_html:
+            for selector in selectors:
+                match = is_not
+                # We have a un-matchable situation (like `:focus` as you can focus an element in this environment)
+                if isinstance(selector, ct.SelectorNull):
+                    continue
+                # Verify tag matches
+                if not self.match_tag(el, selector.tag):
+                    continue
+                # Verify tag is defined
+                if selector.flags & ct.SEL_DEFINED and not self.match_defined(el):
+                    continue
+                # Verify element is root
+                if selector.flags & ct.SEL_ROOT and not self.match_root(el):
+                    continue
+                # Verify element is scope
+                if selector.flags & ct.SEL_SCOPE and not self.match_scope(el):
+                    continue
+                # Verify element has placeholder shown
+                if selector.flags & ct.SEL_PLACEHOLDER_SHOWN and not self.match_placeholder_shown(el):
+                    continue
+                # Verify `nth` matches
+                if not self.match_nth(el, selector.nth):
+                    continue
+                if selector.flags & ct.SEL_EMPTY and not self.match_empty(el):
+                    continue
+                # Verify id matches
+                if selector.ids and not self.match_id(el, selector.ids):
+                    continue
+                # Verify classes match
+                if selector.classes and not self.match_classes(el, selector.classes):
+                    continue
+                # Verify attribute(s) match
+                if not self.match_attributes(el, selector.attributes):
+                    continue
+                # Verify ranges
+                if selector.flags & RANGES and not self.match_range(el, selector.flags & RANGES):
+                    continue
+                # Verify language patterns
+                if selector.lang and not self.match_lang(el, selector.lang):
+                    continue
+                # Verify pseudo selector patterns
+                if selector.selectors and not self.match_subselectors(el, selector.selectors):
+                    continue
+                # Verify relationship selectors
+                if selector.relation and not self.match_relations(el, selector.relation):
+                    continue
+                # Validate that the current default selector match corresponds to the first submit button in the form
+                if selector.flags & ct.SEL_DEFAULT and not self.match_default(el):
+                    continue
+                # Validate that the unset radio button is among radio buttons with the same name in a form that are
+                # also not set.
+                if selector.flags & ct.SEL_INDETERMINATE and not self.match_indeterminate(el):
+                    continue
+                # Validate element directionality
+                if selector.flags & DIR_FLAGS and not self.match_dir(el, selector.flags & DIR_FLAGS):
+                    continue
+                # Validate that the tag contains the specified text.
+                if selector.contains and not self.match_contains(el, selector.contains):
+                    continue
+                match = not is_not
+                break
+
+        # Restore actual namespaces being used for external selector lists
+        if is_html:
+            self.namespaces = namespaces
+            self.iframe_restrict = iframe_restrict
+
+        return match
+
+    def select(self, limit: int = 0) -> Iterator[bs4.Tag]:
+        """Match all tags under the targeted tag."""
+
+        lim = None if limit < 1 else limit
+
+        for child in self.get_tag_descendants(self.tag):
+            if self.match(child):
+                yield child
+                if lim is not None:
+                    lim -= 1
+                    if lim < 1:
+                        break
+
+    def closest(self) -> bs4.Tag | None:
+        """Match closest ancestor."""
+
+        current = self.tag  # type: bs4.Tag | None
+        closest = None
+        while closest is None and current is not None:
+            if self.match(current):
+                closest = current
+            else:
+                current = self.get_parent(current)
+        return closest
+
+    def filter(self) -> list[bs4.Tag]:  # noqa A001
+        """Filter tag's children."""
+
+        return [
+            tag for tag in self.get_contents(self.tag)
+            if isinstance(tag, bs4.Tag) and self.match(tag)
+        ]
+
+    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)
+
+
+class SoupSieve(ct.Immutable):
+    """Compiled Soup Sieve selector matching object."""
+
+    pattern: str
+    selectors: ct.SelectorList
+    namespaces: ct.Namespaces | None
+    custom: dict[str, str]
+    flags: int
+
+    __slots__ = ("pattern", "selectors", "namespaces", "custom", "flags", "_hash")
+
+    def __init__(
+        self,
+        pattern: str,
+        selectors: ct.SelectorList,
+        namespaces: ct.Namespaces | None,
+        custom: ct.CustomSelectors | None,
+        flags: int
+    ):
+        """Initialize."""
+
+        super().__init__(
+            pattern=pattern,
+            selectors=selectors,
+            namespaces=namespaces,
+            custom=custom,
+            flags=flags
+        )
+
+    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 | None:
+        """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
+        """
+        Filter.
+
+        `CSSMatch` can cache certain searches for tags of the same document,
+        so if we are given a tag, all tags are from the same document,
+        and we can take advantage of the optimization.
+
+        Any other kind of iterable could have tags from different documents or detached tags,
+        so for those, we use a new `CSSMatch` for each item in the iterable.
+        """
+
+        if isinstance(iterable, bs4.Tag):
+            return CSSMatch(self.selectors, iterable, self.namespaces, self.flags).filter()
+        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 | None:
+        """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]:
+        """Select the specified tags."""
+
+        return list(self.iselect(tag, limit))
+
+    def iselect(self, tag: bs4.Tag, limit: int = 0) -> Iterator[bs4.Tag]:
+        """Iterate the specified tags."""
+
+        yield from CSSMatch(self.selectors, tag, self.namespaces, self.flags).select(limit)
+
+    def __repr__(self) -> str:  # pragma: no cover
+        """Representation."""
+
+        return (
+            f"SoupSieve(pattern={self.pattern!r}, namespaces={self.namespaces!r}, "
+            f"custom={self.custom!r}, flags={self.flags!r})"
+        )
+
+    __str__ = __repr__
+
+
+ct.pickle_register(SoupSieve)
diff --git a/env/lib/python3.12/site-packages/soupsieve/css_parser.py b/env/lib/python3.12/site-packages/soupsieve/css_parser.py
new file mode 100644
index 0000000..3140ba8
--- /dev/null
+++ b/env/lib/python3.12/site-packages/soupsieve/css_parser.py
@@ -0,0 +1,1318 @@
+"""CSS selector parser."""
+from __future__ import annotations
+import re
+from functools import lru_cache
+from . import util
+from . import css_match as cm
+from . import css_types as ct
+from .util import SelectorSyntaxError
+import warnings
+from typing import Match, Any, Iterator, cast
+
+UNICODE_REPLACEMENT_CHAR = 0xFFFD
+
+# Simple pseudo classes that take no parameters
+PSEUDO_SIMPLE = {
+    ":any-link",
+    ":empty",
+    ":first-child",
+    ":first-of-type",
+    ":in-range",
+    ":open",
+    ":out-of-range",
+    ":last-child",
+    ":last-of-type",
+    ":link",
+    ":only-child",
+    ":only-of-type",
+    ":root",
+    ':checked',
+    ':default',
+    ':disabled',
+    ':enabled',
+    ':indeterminate',
+    ':optional',
+    ':placeholder-shown',
+    ':read-only',
+    ':read-write',
+    ':required',
+    ':scope',
+    ':defined',
+    ':muted'
+}
+
+# Supported, simple pseudo classes that match nothing in the Soup Sieve environment
+PSEUDO_SIMPLE_NO_MATCH = {
+    ':active',
+    ':autofill',
+    ':buffering',
+    ':current',
+    ':focus',
+    ':focus-visible',
+    ':focus-within',
+    ':fullscreen',
+    ':future',
+    ':host',
+    ':hover',
+    ':local-link',
+    ':past',
+    ':paused',
+    ':picture-in-picture',
+    ':playing',
+    ':popover-open',
+    ':seeking',
+    ':stalled',
+    ':target',
+    ':target-within',
+    ':user-invalid',
+    ':volume-locked',
+    ':visited'
+}
+
+# Complex pseudo classes that take selector lists
+PSEUDO_COMPLEX = {
+    ':contains',
+    ':-soup-contains',
+    ':-soup-contains-own',
+    ':has',
+    ':is',
+    ':matches',
+    ':not',
+    ':where'
+}
+
+PSEUDO_COMPLEX_NO_MATCH = {
+    ':current',
+    ':host',
+    ':host-context'
+}
+
+# Complex pseudo classes that take very specific parameters and are handled special
+PSEUDO_SPECIAL = {
+    ':dir',
+    ':lang',
+    ':nth-child',
+    ':nth-last-child',
+    ':nth-last-of-type',
+    ':nth-of-type'
+}
+
+PSEUDO_SUPPORTED = PSEUDO_SIMPLE | PSEUDO_SIMPLE_NO_MATCH | PSEUDO_COMPLEX | PSEUDO_COMPLEX_NO_MATCH | PSEUDO_SPECIAL
+
+# Sub-patterns parts
+# Whitespace
+NEWLINE = r'(?:\r\n|(?!\r\n)[\n\f\r])'
+WS = fr'(?:[ \t]|{NEWLINE})'
+# Comments
+COMMENTS = r'(?:/\*[^*]*\*+(?:[^/*][^*]*\*+)*/)'
+# Whitespace with comments included
+WSC = fr'(?:{WS}|{COMMENTS})'
+# CSS escapes
+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 = 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 = fr'(?:[-+])?(?:[0-9]+n?|n)(?:(?<=n){WSC}*(?:[-+]){WSC}*(?:[0-9]+))?'
+# Value: quoted string or identifier
+VALUE = fr'''(?:"(?:\\(?:.|{NEWLINE})|[^\\"\r\n\f]+)*?"|'(?:\\(?:.|{NEWLINE})|[^\\'\r\n\f]+)*?'|{IDENTIFIER})'''
+# Attribute value comparison. `!=` is handled special as it is non-standard.
+ATTR = fr'(?:{WSC}*(?P[!~^|*$]?=){WSC}*(?P{VALUE})(?:{WSC}*(?P[is]))?)?{WSC}*'
+
+# Selector patterns
+# IDs (`#id`)
+PAT_ID = fr'\#{IDENTIFIER}'
+# Classes (`.class`)
+PAT_CLASS = fr'\.{IDENTIFIER}'
+# Prefix:Tag (`prefix|tag`)
+PAT_TAG = fr'(?P(?:{IDENTIFIER}|\*)?\|)?(?P{IDENTIFIER}|\*)'
+# Attributes (`[attr]`, `[attr=value]`, etc.)
+PAT_ATTR = fr'\[{WSC}*(?P(?:{IDENTIFIER}|\*)?\|)?(?P{IDENTIFIER}){ATTR}\]'
+# Pseudo class (`:pseudo-class`, `:pseudo-class(`)
+PAT_PSEUDO_CLASS = fr'(?P:{IDENTIFIER})(?P\({WSC}*)?'
+# Pseudo class special patterns. Matches `:pseudo-class(` for special case pseudo classes.
+PAT_PSEUDO_CLASS_SPECIAL = fr'(?P:{IDENTIFIER})(?P\({WSC}*)'
+# Custom pseudo class (`:--custom-pseudo`)
+PAT_PSEUDO_CLASS_CUSTOM = fr'(?P:(?=--){IDENTIFIER})'
+# Nesting ampersand selector. Matches `&`
+PAT_AMP = r'&'
+# Closing pseudo group (`)`)
+PAT_PSEUDO_CLOSE = fr'{WSC}*\)'
+# Pseudo element (`::pseudo-element`)
+PAT_PSEUDO_ELEMENT = fr':{PAT_PSEUDO_CLASS}'
+# At rule (`@page`, etc.) (not supported)
+PAT_AT_RULE = fr'@P{IDENTIFIER}'
+# Pseudo class `nth-child` (`:nth-child(an+b [of S]?)`, `:first-child`, etc.)
+PAT_PSEUDO_NTH_CHILD = fr'''
+(?P{PAT_PSEUDO_CLASS_SPECIAL}
+(?P{NTH}|even|odd))(?:{WSC}*\)|(?P{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 = fr'''
+(?P{PAT_PSEUDO_CLASS_SPECIAL}
+(?P{NTH}|even|odd)){WSC}*\)
+'''
+# Pseudo class language (`:lang("*-de", en)`)
+PAT_PSEUDO_LANG = fr'{PAT_PSEUDO_CLASS_SPECIAL}(?P{VALUE}(?:{WSC}*,{WSC}*{VALUE})*){WSC}*\)'
+# Pseudo class direction (`:dir(ltr)`)
+PAT_PSEUDO_DIR = fr'{PAT_PSEUDO_CLASS_SPECIAL}(?Pltr|rtl){WSC}*\)'
+# Combining characters (`>`, `~`, ` `, `+`, `,`)
+PAT_COMBINE = fr'{WSC}*?(?P[,+>~]|{WS}(?![,+>~])){WSC}*'
+# Extra: Contains (`:contains(text)`)
+PAT_PSEUDO_CONTAINS = fr'{PAT_PSEUDO_CLASS_SPECIAL}(?P{VALUE}(?:{WSC}*,{WSC}*{VALUE})*){WSC}*\)'
+
+# Regular expressions
+# CSS escape pattern
+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(fr'(?P[-+])?(?P[0-9]+n?|n)(?:(?<=n){WSC}*(?P[-+]){WSC}*(?P[0-9]+))?', re.I)
+# Pattern to iterate multiple values.
+RE_VALUES = re.compile(fr'(?:(?P{VALUE})|(?P{WSC}*,{WSC}*))', re.X)
+# Whitespace checks
+RE_WS = re.compile(WS)
+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
+COMMA_COMBINATOR = ','
+# Relation token for descendant
+WS_COMBINATOR = " "
+
+# Parse flags
+FLG_PSEUDO = 0x01
+FLG_NOT = 0x02
+FLG_RELATIVE = 0x04
+FLG_DEFAULT = 0x08
+FLG_HTML = 0x10
+FLG_INDETERMINATE = 0x20
+FLG_OPEN = 0x40
+FLG_IN_RANGE = 0x80
+FLG_OUT_OF_RANGE = 0x100
+FLG_PLACEHOLDER_SHOWN = 0x200
+FLG_FORGIVE = 0x400
+
+# Maximum cached patterns to store
+_MAXCACHE = 500
+
+
+@lru_cache(maxsize=_MAXCACHE)
+def _cached_css_compile(
+    pattern: str,
+    namespaces: ct.Namespaces | None,
+    custom: ct.CustomSelectors | None,
+    flags: int
+) -> cm.SoupSieve:
+    """Cached CSS compile."""
+
+    custom_selectors = process_custom(custom)
+    return cm.SoupSieve(
+        pattern,
+        CSSParser(
+            pattern,
+            custom=custom_selectors,
+            flags=flags
+        ).process_selectors(),
+        namespaces,
+        custom,
+        flags
+    )
+
+
+def _purge_cache() -> None:
+    """Purge the cache."""
+
+    _cached_css_compile.cache_clear()
+
+
+def process_custom(custom: ct.CustomSelectors | None) -> dict[str, str | ct.SelectorList]:
+    """Process custom."""
+
+    custom_selectors = {}
+    if custom is not None:
+        for key, value in custom.items():
+            name = util.lower(key)
+            if RE_CUSTOM.match(name) is None:
+                raise SelectorSyntaxError(f"The name '{name}' is not a valid custom pseudo-class name")
+            if name in custom_selectors:
+                raise KeyError(f"The custom selector '{name}' has already been registered")
+            custom_selectors[css_unescape(name)] = value
+    return custom_selectors
+
+
+def css_unescape(content: str, string: bool = False) -> str:
+    """
+    Unescape CSS value.
+
+    Strings allow for spanning the value on multiple strings by escaping a new line.
+    """
+
+    def replace(m: Match[str]) -> str:
+        """Replace with the appropriate substitute."""
+
+        if m.group(1):
+            codepoint = int(m.group(1)[1:], 16)
+            if codepoint == 0:
+                codepoint = UNICODE_REPLACEMENT_CHAR
+            value = chr(codepoint)
+        elif m.group(2):
+            value = m.group(2)[1:]
+        elif m.group(3):
+            value = '\ufffd'
+        else:
+            value = ''
+
+        return value
+
+    return (RE_CSS_ESC if not string else RE_CSS_STR_ESC).sub(replace, content)
+
+
+def escape(ident: str) -> str:
+    """Escape identifier."""
+
+    string = []
+    length = len(ident)
+    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(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(f'\\{codepoint:x} ')
+            elif (index == 0 or (start_dash and index == 1)) and (0x30 <= codepoint <= 0x39):
+                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(f'\\{c}')
+    return ''.join(string)
+
+
+class SelectorPattern:
+    """Selector pattern."""
+
+    def __init__(self, name: str, pattern: str) -> None:
+        """Initialize."""
+
+        self.name = name
+        self.re_pattern = re.compile(pattern, re.I | re.X | re.U)
+
+    def get_name(self) -> str:
+        """Get name."""
+
+        return self.name
+
+    def match(self, selector: str, index: int, flags: int) -> Match[str] | None:
+        """Match the selector."""
+
+        return self.re_pattern.match(selector, index)
+
+
+class SpecialPseudoPattern(SelectorPattern):
+    """Selector pattern."""
+
+    def __init__(self, patterns: tuple[tuple[str, tuple[str, ...], str, type[SelectorPattern]], ...]) -> None:
+        """Initialize."""
+
+        self.patterns = {}
+        for p in patterns:
+            name = p[0]
+            pattern = p[3](name, p[2])
+            for pseudo in p[1]:
+                self.patterns[pseudo] = pattern
+
+        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:
+        """Get name."""
+
+        return '' if self.matched_name is None else self.matched_name.get_name()
+
+    def match(self, selector: str, index: int, flags: int) -> Match[str] | None:
+        """Match the selector."""
+
+        pseudo = None
+        m = self.re_pseudo_name.match(selector, index)
+        if m:
+            name = util.lower(css_unescape(m.group('name')))
+            pattern = self.patterns.get(name)
+            if pattern:
+                pseudo = pattern.match(selector, index, flags)
+                if pseudo:
+                    self.matched_name = pattern
+
+        return pseudo
+
+
+class _Selector:
+    """
+    Intermediate selector class.
+
+    This stores selector data for a compound selector as we are acquiring them.
+    Once we are done collecting the data for a compound selector, we freeze
+    the data in an object that can be pickled and hashed.
+    """
+
+    def __init__(self, **kwargs: Any) -> None:
+        """Initialize."""
+
+        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: 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
+        self.no_match = kwargs.get('no_match', False)  # type: bool
+
+    def _freeze_relations(self, relations: list[_Selector]) -> ct.SelectorList:
+        """Freeze relation."""
+
+        if relations:
+            sel = relations[0]
+            sel.relations.extend(relations[1:])
+            return ct.SelectorList([sel.freeze()])
+        else:
+            return ct.SelectorList()
+
+    def freeze(self) -> ct.Selector | ct.SelectorNull:
+        """Freeze self."""
+
+        if self.no_match:
+            return ct.SelectorNull()
+        else:
+            return ct.Selector(
+                self.tag,
+                tuple(self.ids),
+                tuple(self.classes),
+                tuple(self.attributes),
+                tuple(self.nth),
+                tuple(self.selectors),
+                self._freeze_relations(self.relations),
+                self.rel_type,
+                tuple(self.contains),
+                tuple(self.lang),
+                self.flags
+            )
+
+    def __str__(self) -> str:  # pragma: no cover
+        """String representation."""
+
+        return (
+            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__
+
+
+class CSSParser:
+    """Parse CSS selectors."""
+
+    css_tokens = (
+        SelectorPattern("pseudo_close", PAT_PSEUDO_CLOSE),
+        SpecialPseudoPattern(
+            (
+                (
+                    "pseudo_contains",
+                    (':contains', ':-soup-contains', ':-soup-contains-own'),
+                    PAT_PSEUDO_CONTAINS,
+                    SelectorPattern
+                ),
+                ("pseudo_nth_child", (':nth-child', ':nth-last-child'), PAT_PSEUDO_NTH_CHILD, SelectorPattern),
+                ("pseudo_nth_type", (':nth-of-type', ':nth-last-of-type'), PAT_PSEUDO_NTH_TYPE, SelectorPattern),
+                ("pseudo_lang", (':lang',), PAT_PSEUDO_LANG, SelectorPattern),
+                ("pseudo_dir", (':dir',), PAT_PSEUDO_DIR, SelectorPattern)
+            )
+        ),
+        SelectorPattern("pseudo_class_custom", PAT_PSEUDO_CLASS_CUSTOM),
+        SelectorPattern("pseudo_class", PAT_PSEUDO_CLASS),
+        SelectorPattern("pseudo_element", PAT_PSEUDO_ELEMENT),
+        SelectorPattern("amp", PAT_AMP),
+        SelectorPattern("at_rule", PAT_AT_RULE),
+        SelectorPattern("id", PAT_ID),
+        SelectorPattern("class", PAT_CLASS),
+        SelectorPattern("tag", PAT_TAG),
+        SelectorPattern("attribute", PAT_ATTR),
+        SelectorPattern("combine", PAT_COMBINE)
+    )
+
+    def __init__(
+        self,
+        selector: str,
+        custom: dict[str, str | ct.SelectorList] | None = None,
+        flags: int = 0
+    ) -> None:
+        """Initialize."""
+
+        self.pattern = selector.replace('\x00', '\ufffd')
+        self.flags = flags
+        self.debug = self.flags & util.DEBUG
+        self.custom = {} if custom is None else custom
+
+    def parse_attribute_selector(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:
+        """Create attribute selector from the returned regex match."""
+
+        inverse = False
+        op = m.group('cmp')
+        case = util.lower(m.group('case')) if m.group('case') else None
+        ns = css_unescape(m.group('attr_ns')[:-1]) if m.group('attr_ns') else ''
+        attr = css_unescape(m.group('attr_name'))
+        is_type = False
+        pattern2 = None
+        value = ''
+
+        if case:
+            flags = (re.I if case == 'i' else 0) | re.DOTALL
+        elif util.lower(attr) == 'type':
+            flags = re.I | re.DOTALL
+            is_type = True
+        else:
+            flags = re.DOTALL
+
+        if op:
+            if m.group('value').startswith(('"', "'")):
+                value = css_unescape(m.group('value')[1:-1], True)
+            else:
+                value = css_unescape(m.group('value'))
+
+        if not op:
+            # Attribute name
+            pattern = None
+        elif op.startswith('^'):
+            # Value start with
+            pattern = re.compile(r'^%s.*' % re.escape(value), flags)
+        elif op.startswith('$'):
+            # Value ends with
+            pattern = re.compile(r'.*?%s$' % re.escape(value), flags)
+        elif op.startswith('*'):
+            # Value contains
+            pattern = re.compile(r'.*?%s.*' % re.escape(value), flags)
+        elif op.startswith('~'):
+            # Value contains word within space separated list
+            # `~=` should match nothing if it is empty or contains whitespace,
+            # so if either of these cases is present, use `[^\s\S]` which cannot be matched.
+            value = r'[^\s\S]' if not value or RE_WS.search(value) else re.escape(value)
+            pattern = re.compile(r'.*?(?:(?<=^)|(?<=[ \t\r\n\f]))%s(?=(?:[ \t\r\n\f]|$)).*' % value, flags)
+        elif op.startswith('|'):
+            # Value starts with word in dash separated list
+            pattern = re.compile(r'^%s(?:-.*)?$' % re.escape(value), flags)
+        else:
+            # Value matches
+            pattern = re.compile(r'^%s$' % re.escape(value), flags)
+            if op.startswith('!'):
+                # Equivalent to `:not([attr=value])`
+                inverse = True
+        if is_type and pattern:
+            pattern2 = re.compile(pattern.pattern)
+
+        # Append the attribute selector
+        sel_attr = ct.SelectorAttribute(attr, ns, pattern, pattern2)
+        if inverse:
+            # If we are using `!=`, we need to nest the pattern under a `:not()`.
+            sub_sel = _Selector()
+            sub_sel.attributes.append(sel_attr)
+            not_list = ct.SelectorList([sub_sel.freeze()], True, False)
+            sel.selectors.append(not_list)
+        else:
+            sel.attributes.append(sel_attr)
+
+        has_selector = True
+        return has_selector
+
+    def parse_tag_pattern(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:
+        """Parse tag pattern from regex match."""
+
+        prefix = css_unescape(m.group('tag_ns')[:-1]) if m.group('tag_ns') else None
+        tag = css_unescape(m.group('tag_name'))
+        sel.tag = ct.SelectorTag(tag, prefix)
+        has_selector = True
+        return has_selector
+
+    def parse_pseudo_class_custom(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:
+        """
+        Parse custom pseudo class alias.
+
+        Compile custom selectors as we need them. When compiling a custom selector,
+        set it to `None` in the dictionary so we can avoid an infinite loop.
+        """
+
+        pseudo = util.lower(css_unescape(m.group('name')))
+        selector = self.custom.get(pseudo)
+        if selector is None:
+            raise SelectorSyntaxError(
+                f"Undefined custom selector '{pseudo}' found at position {m.end(0)}",
+                self.pattern,
+                m.end(0)
+            )
+
+        if not isinstance(selector, ct.SelectorList):
+            del self.custom[pseudo]
+            selector = CSSParser(
+                selector, custom=self.custom, flags=self.flags
+            ).process_selectors(flags=FLG_PSEUDO)
+            self.custom[pseudo] = selector
+
+        sel.selectors.append(selector)
+        has_selector = True
+        return has_selector
+
+    def parse_pseudo_class(
+        self,
+        sel: _Selector,
+        m: Match[str],
+        has_selector: bool,
+        iselector: Iterator[tuple[str, Match[str]]],
+        is_html: bool
+    ) -> tuple[bool, bool]:
+        """Parse pseudo class."""
+
+        complex_pseudo = False
+        pseudo = util.lower(css_unescape(m.group('name')))
+        if m.group('open'):
+            complex_pseudo = True
+        if complex_pseudo and pseudo in PSEUDO_COMPLEX:
+            has_selector = self.parse_pseudo_open(sel, pseudo, has_selector, iselector, m.end(0))
+        elif not complex_pseudo and pseudo in PSEUDO_SIMPLE:
+            if pseudo == ':root':
+                sel.flags |= ct.SEL_ROOT
+            elif pseudo == ':defined':
+                sel.flags |= ct.SEL_DEFINED
+                is_html = True
+            elif pseudo == ':scope':
+                sel.flags |= ct.SEL_SCOPE
+            elif pseudo == ':empty':
+                sel.flags |= ct.SEL_EMPTY
+            elif pseudo in (':link', ':any-link'):
+                sel.selectors.append(CSS_LINK)
+            elif pseudo == ':checked':
+                sel.selectors.append(CSS_CHECKED)
+            elif pseudo == ':default':
+                sel.selectors.append(CSS_DEFAULT)
+            elif pseudo == ':indeterminate':
+                sel.selectors.append(CSS_INDETERMINATE)
+            elif pseudo == ":disabled":
+                sel.selectors.append(CSS_DISABLED)
+            elif pseudo == ":enabled":
+                sel.selectors.append(CSS_ENABLED)
+            elif pseudo == ":required":
+                sel.selectors.append(CSS_REQUIRED)
+            elif pseudo == ":muted":
+                sel.selectors.append(CSS_MUTED)
+            elif pseudo == ":open":
+                sel.selectors.append(CSS_OPEN)
+            elif pseudo == ":optional":
+                sel.selectors.append(CSS_OPTIONAL)
+            elif pseudo == ":read-only":
+                sel.selectors.append(CSS_READ_ONLY)
+            elif pseudo == ":read-write":
+                sel.selectors.append(CSS_READ_WRITE)
+            elif pseudo == ":in-range":
+                sel.selectors.append(CSS_IN_RANGE)
+            elif pseudo == ":out-of-range":
+                sel.selectors.append(CSS_OUT_OF_RANGE)
+            elif pseudo == ":placeholder-shown":
+                sel.selectors.append(CSS_PLACEHOLDER_SHOWN)
+            elif pseudo == ':first-child':
+                sel.nth.append(ct.SelectorNth(1, False, 0, False, False, ct.SelectorList()))
+            elif pseudo == ':last-child':
+                sel.nth.append(ct.SelectorNth(1, False, 0, False, True, ct.SelectorList()))
+            elif pseudo == ':first-of-type':
+                sel.nth.append(ct.SelectorNth(1, False, 0, True, False, ct.SelectorList()))
+            elif pseudo == ':last-of-type':
+                sel.nth.append(ct.SelectorNth(1, False, 0, True, True, ct.SelectorList()))
+            elif pseudo == ':only-child':
+                sel.nth.extend(
+                    [
+                        ct.SelectorNth(1, False, 0, False, False, ct.SelectorList()),
+                        ct.SelectorNth(1, False, 0, False, True, ct.SelectorList())
+                    ]
+                )
+            elif pseudo == ':only-of-type':
+                sel.nth.extend(
+                    [
+                        ct.SelectorNth(1, False, 0, True, False, ct.SelectorList()),
+                        ct.SelectorNth(1, False, 0, True, True, ct.SelectorList())
+                    ]
+                )
+            has_selector = True
+        elif complex_pseudo and pseudo in PSEUDO_COMPLEX_NO_MATCH:
+            self.parse_selectors(iselector, m.end(0), FLG_PSEUDO | FLG_OPEN)
+            sel.no_match = True
+            has_selector = True
+        elif not complex_pseudo and pseudo in PSEUDO_SIMPLE_NO_MATCH:
+            sel.no_match = True
+            has_selector = True
+        elif pseudo in PSEUDO_SUPPORTED:
+            raise SelectorSyntaxError(
+                f"Invalid syntax for pseudo class '{pseudo}'",
+                self.pattern,
+                m.start(0)
+            )
+        else:
+            raise SelectorSyntaxError(
+                f"'{pseudo}' was detected as a pseudo-class and is either unsupported or invalid. "
+                "If the syntax was not intended to be recognized as a pseudo-class, please escape the colon.",
+                self.pattern,
+                m.start(0)
+            )
+
+        return has_selector, is_html
+
+    def parse_pseudo_nth(
+        self,
+        sel: _Selector,
+        m: Match[str],
+        has_selector: bool,
+        iselector: Iterator[tuple[str, Match[str]]]
+    ) -> bool:
+        """Parse `nth` pseudo."""
+
+        mdict = m.groupdict()
+        if mdict.get('pseudo_nth_child'):
+            postfix = '_child'
+        else:
+            postfix = '_type'
+        mdict['name'] = util.lower(css_unescape(mdict['name']))
+        content = util.lower(mdict.get('nth' + postfix))
+        if content == 'even':
+            # 2n
+            s1 = 2
+            s2 = 0
+            var = True
+        elif content == 'odd':
+            # 2n+1
+            s1 = 2
+            s2 = 1
+            var = True
+        else:
+            nth_parts = cast(Match[str], RE_NTH.match(content))
+            _s1 = '-' if nth_parts.group('s1') and nth_parts.group('s1') == '-' else ''
+            a = nth_parts.group('a')
+            var = a.endswith('n')
+            if a.startswith('n'):
+                _s1 += '1'
+            elif var:
+                _s1 += a[:-1]
+            else:
+                _s1 += a
+            _s2 = '-' if nth_parts.group('s2') and nth_parts.group('s2') == '-' else ''
+            if nth_parts.group('b'):
+                _s2 += nth_parts.group('b')
+            else:
+                _s2 = '0'
+            s1 = int(_s1, 10)
+            s2 = int(_s2, 10)
+
+        pseudo_sel = mdict['name']
+        if postfix == '_child':
+            if m.group('of'):
+                # Parse the rest of `of S`.
+                nth_sel = self.parse_selectors(iselector, m.end(0), FLG_PSEUDO | FLG_OPEN)
+            else:
+                # Use default `*|*` for `of S`.
+                nth_sel = CSS_NTH_OF_S_DEFAULT
+            if pseudo_sel == ':nth-child':
+                sel.nth.append(ct.SelectorNth(s1, var, s2, False, False, nth_sel))
+            elif pseudo_sel == ':nth-last-child':
+                sel.nth.append(ct.SelectorNth(s1, var, s2, False, True, nth_sel))
+        else:
+            if pseudo_sel == ':nth-of-type':
+                sel.nth.append(ct.SelectorNth(s1, var, s2, True, False, ct.SelectorList()))
+            elif pseudo_sel == ':nth-last-of-type':
+                sel.nth.append(ct.SelectorNth(s1, var, s2, True, True, ct.SelectorList()))
+        has_selector = True
+        return has_selector
+
+    def parse_pseudo_open(
+        self,
+        sel: _Selector,
+        name: str,
+        has_selector: bool,
+        iselector: Iterator[tuple[str, Match[str]]],
+        index: int
+    ) -> bool:
+        """Parse pseudo with opening bracket."""
+
+        flags = FLG_PSEUDO | FLG_OPEN
+        if name == ':not':
+            flags |= FLG_NOT
+        elif name == ':has':
+            flags |= FLG_RELATIVE
+        elif name in (':where', ':is'):
+            flags |= FLG_FORGIVE
+
+        sel.selectors.append(self.parse_selectors(iselector, index, flags))
+        has_selector = True
+
+        return has_selector
+
+    def parse_has_combinator(
+        self,
+        sel: _Selector,
+        m: Match[str],
+        has_selector: bool,
+        selectors: list[_Selector],
+        rel_type: str,
+        index: int
+    ) -> tuple[bool, _Selector, str]:
+        """Parse combinator tokens."""
+
+        combinator = m.group('relation').strip()
+        if not combinator:
+            combinator = WS_COMBINATOR
+        if combinator == COMMA_COMBINATOR:
+            sel.rel_type = rel_type
+            selectors[-1].relations.append(sel)
+            rel_type = ":" + WS_COMBINATOR
+            selectors.append(_Selector())
+        else:
+            if has_selector:
+                # End the current selector and associate the leading combinator with this selector.
+                sel.rel_type = rel_type
+                selectors[-1].relations.append(sel)
+            elif rel_type[1:] != WS_COMBINATOR:
+                # It's impossible to have two whitespace combinators after each other as the patterns
+                # will gobble up trailing whitespace. It is also impossible to have a whitespace
+                # combinator after any other kind for the same reason. But we could have
+                # 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(
+                    f'The multiple combinators at position {index}',
+                    self.pattern,
+                    index
+                )
+
+            # Set the leading combinator for the next selector.
+            rel_type = ':' + combinator
+
+        sel = _Selector()
+        has_selector = False
+        return has_selector, sel, rel_type
+
+    def parse_combinator(
+        self,
+        sel: _Selector,
+        m: Match[str],
+        has_selector: bool,
+        selectors: list[_Selector],
+        relations: list[_Selector],
+        is_pseudo: bool,
+        is_forgive: bool,
+        index: int
+    ) -> tuple[bool, _Selector]:
+        """Parse combinator tokens."""
+
+        combinator = m.group('relation').strip()
+        if not combinator:
+            combinator = WS_COMBINATOR
+        if not has_selector:
+            if not is_forgive or combinator != COMMA_COMBINATOR:
+                raise SelectorSyntaxError(
+                    f"The combinator '{combinator}' at position {index}, must have a selector before it",
+                    self.pattern,
+                    index
+                )
+
+            # If we are in a forgiving pseudo class, just make the selector a "no match"
+            if combinator == COMMA_COMBINATOR:
+                sel.no_match = True
+                del relations[:]
+                selectors.append(sel)
+        else:
+            if combinator == COMMA_COMBINATOR:
+                if not sel.tag and not is_pseudo:
+                    # Implied `*`
+                    sel.tag = ct.SelectorTag('*', None)
+                sel.relations.extend(relations)
+                selectors.append(sel)
+                del relations[:]
+            else:
+                sel.relations.extend(relations)
+                sel.rel_type = combinator
+                del relations[:]
+                relations.append(sel)
+
+        sel = _Selector()
+        has_selector = False
+
+        return has_selector, sel
+
+    def parse_class_id(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:
+        """Parse HTML classes and ids."""
+
+        selector = m.group(0)
+        if selector.startswith('.'):
+            sel.classes.append(css_unescape(selector[1:]))
+        else:
+            sel.ids.append(css_unescape(selector[1:]))
+        has_selector = True
+        return has_selector
+
+    def parse_pseudo_contains(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:
+        """Parse contains."""
+
+        pseudo = util.lower(css_unescape(m.group('name')))
+        if pseudo == ":contains":
+            warnings.warn(  # noqa: B028
+                "The pseudo class ':contains' is deprecated, ':-soup-contains' should be used moving forward.",
+                FutureWarning
+            )
+        contains_own = pseudo == ":-soup-contains-own"
+        values = css_unescape(m.group('values'))
+        patterns = []
+        for token in RE_VALUES.finditer(values):
+            if token.group('split'):
+                continue
+            value = token.group('value')
+            if value.startswith(("'", '"')):
+                value = css_unescape(value[1:-1], True)
+            else:
+                value = css_unescape(value)
+            patterns.append(value)
+        sel.contains.append(ct.SelectorContains(patterns, contains_own))
+        has_selector = True
+        return has_selector
+
+    def parse_pseudo_lang(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:
+        """Parse pseudo language."""
+
+        values = m.group('values')
+        patterns = []
+        for token in RE_VALUES.finditer(values):
+            if token.group('split'):
+                continue
+            value = token.group('value')
+            if value.startswith(('"', "'")):
+                value = css_unescape(value[1:-1], True)
+            else:
+                value = css_unescape(value)
+
+            patterns.append(value)
+
+        sel.lang.append(ct.SelectorLang(patterns))
+        has_selector = True
+
+        return has_selector
+
+    def parse_pseudo_dir(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:
+        """Parse pseudo direction."""
+
+        value = ct.SEL_DIR_LTR if util.lower(m.group('dir')) == 'ltr' else ct.SEL_DIR_RTL
+        sel.flags |= value
+        has_selector = True
+        return has_selector
+
+    def parse_selectors(
+        self,
+        iselector: Iterator[tuple[str, Match[str]]],
+        index: int = 0,
+        flags: int = 0
+    ) -> ct.SelectorList:
+        """Parse selectors."""
+
+        # Initialize important variables
+        sel = _Selector()
+        selectors = []
+        has_selector = False
+        closed = False
+        relations = []  # type: list[_Selector]
+        rel_type = ":" + WS_COMBINATOR
+
+        # Setup various flags
+        is_open = bool(flags & FLG_OPEN)
+        is_pseudo = bool(flags & FLG_PSEUDO)
+        is_relative = bool(flags & FLG_RELATIVE)
+        is_not = bool(flags & FLG_NOT)
+        is_html = bool(flags & FLG_HTML)
+        is_default = bool(flags & FLG_DEFAULT)
+        is_indeterminate = bool(flags & FLG_INDETERMINATE)
+        is_in_range = bool(flags & FLG_IN_RANGE)
+        is_out_of_range = bool(flags & FLG_OUT_OF_RANGE)
+        is_placeholder_shown = bool(flags & FLG_PLACEHOLDER_SHOWN)
+        is_forgive = bool(flags & FLG_FORGIVE)
+
+        # Print out useful debug stuff
+        if self.debug:  # pragma: no cover
+            if is_pseudo:
+                print('    is_pseudo: True')
+            if is_open:
+                print('    is_open: True')
+            if is_relative:
+                print('    is_relative: True')
+            if is_not:
+                print('    is_not: True')
+            if is_html:
+                print('    is_html: True')
+            if is_default:
+                print('    is_default: True')
+            if is_indeterminate:
+                print('    is_indeterminate: True')
+            if is_in_range:
+                print('    is_in_range: True')
+            if is_out_of_range:
+                print('    is_out_of_range: True')
+            if is_placeholder_shown:
+                print('    is_placeholder_shown: True')
+            if is_forgive:
+                print('    is_forgive: True')
+
+        # The algorithm for relative selectors require an initial selector in the selector list
+        if is_relative:
+            selectors.append(_Selector())
+
+        try:
+            while True:
+                key, m = next(iselector)
+
+                # Handle parts
+                if key == "at_rule":
+                    raise NotImplementedError(f"At-rules found at position {m.start(0)}")
+                elif key == "amp":
+                    sel.flags |= ct.SEL_SCOPE
+                    has_selector = True
+                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(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'):
+                    has_selector = self.parse_pseudo_nth(sel, m, has_selector, iselector)
+                elif key == 'pseudo_lang':
+                    has_selector = self.parse_pseudo_lang(sel, m, has_selector)
+                elif key == 'pseudo_dir':
+                    has_selector = self.parse_pseudo_dir(sel, m, has_selector)
+                    # Currently only supports HTML
+                    is_html = True
+                elif key == 'pseudo_close':
+                    if not has_selector:
+                        if not is_forgive:
+                            raise SelectorSyntaxError(
+                                f"Expected a selector at position {m.start(0)}",
+                                self.pattern,
+                                m.start(0)
+                            )
+                        sel.no_match = True
+                    if is_open:
+                        closed = True
+                        break
+                    else:
+                        raise SelectorSyntaxError(
+                            f"Unmatched pseudo-class close at position {m.start(0)}",
+                            self.pattern,
+                            m.start(0)
+                        )
+                elif key == 'combine':
+                    if is_relative:
+                        has_selector, sel, rel_type = self.parse_has_combinator(
+                            sel, m, has_selector, selectors, rel_type, index
+                        )
+                    else:
+                        has_selector, sel = self.parse_combinator(
+                            sel, m, has_selector, selectors, relations, is_pseudo, is_forgive, index
+                        )
+                elif key == 'attribute':
+                    has_selector = self.parse_attribute_selector(sel, m, has_selector)
+                elif key == 'tag':
+                    if has_selector:
+                        raise SelectorSyntaxError(
+                            f"Tag name found at position {m.start(0)} instead of at the start",
+                            self.pattern,
+                            m.start(0)
+                        )
+                    has_selector = self.parse_tag_pattern(sel, m, has_selector)
+                elif key in ('class', 'id'):
+                    has_selector = self.parse_class_id(sel, m, has_selector)
+
+                index = m.end(0)
+        except StopIteration:
+            pass
+
+        # Handle selectors that are not closed
+        if is_open and not closed:
+            raise SelectorSyntaxError(
+                f"Unclosed pseudo-class at position {index}",
+                self.pattern,
+                index
+            )
+
+        # Cleanup completed selector piece
+        if has_selector:
+            if not sel.tag and not is_pseudo:
+                # Implied `*`
+                sel.tag = ct.SelectorTag('*', None)
+            if is_relative:
+                sel.rel_type = rel_type
+                selectors[-1].relations.append(sel)
+            else:
+                sel.relations.extend(relations)
+                del relations[:]
+                selectors.append(sel)
+
+        # Forgive empty slots in pseudo-classes that have lists (and are forgiving)
+        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.
+            # May apply to others as well.
+            raise SelectorSyntaxError(
+                f'Expected a selector at position {index}',
+                self.pattern,
+                index
+            )
+
+        # Some patterns require additional logic, such as default. We try to make these the
+        # last pattern, and append the appropriate flag to that selector which communicates
+        # to the matcher what additional logic is required.
+        if is_default:
+            selectors[-1].flags = ct.SEL_DEFAULT
+        if is_indeterminate:
+            selectors[-1].flags = ct.SEL_INDETERMINATE
+        if is_in_range:
+            selectors[-1].flags = ct.SEL_IN_RANGE
+        if is_out_of_range:
+            selectors[-1].flags = ct.SEL_OUT_OF_RANGE
+        if is_placeholder_shown:
+            selectors[-1].flags = ct.SEL_PLACEHOLDER_SHOWN
+
+        # 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]]]:
+        """Iterate selector tokens."""
+
+        # Ignore whitespace and comments at start and end of pattern
+        m = RE_WS_BEGIN.search(pattern)
+        index = m.end(0) if m else 0
+        m = RE_WS_END.search(pattern)
+        end = (m.start(0) - 1) if m else (len(pattern) - 1)
+
+        if self.debug:  # pragma: no cover
+            print(f'## PARSING: {pattern!r}')
+        while index <= end:
+            m = None
+            for v in self.css_tokens:
+                m = v.match(pattern, index, self.flags)
+                if m:
+                    name = v.get_name()
+                    if self.debug:  # pragma: no cover
+                        print(f"TOKEN: '{name}' --> {m.group(0)!r} at position {m.start(0)}")
+                    index = m.end(0)
+                    yield name, m
+                    break
+            if m is None:
+                c = pattern[index]
+                # If the character represents the start of one of the known selector types,
+                # throw an exception mentioning that the known selector type is in error;
+                # otherwise, report the invalid character.
+                if c == '[':
+                    msg = f"Malformed attribute selector at position {index}"
+                elif c == '.':
+                    msg = f"Malformed class selector at position {index}"
+                elif c == '#':
+                    msg = f"Malformed id selector at position {index}"
+                elif c == ':':
+                    msg = f"Malformed pseudo-class selector at position {index}"
+                else:
+                    msg = f"Invalid character {c!r} position {index}"
+                raise SelectorSyntaxError(msg, self.pattern, index)
+        if self.debug:  # pragma: no cover
+            print('## END PARSING')
+
+    def process_selectors(self, index: int = 0, flags: int = 0) -> ct.SelectorList:
+        """Process selectors."""
+
+        return self.parse_selectors(self.selector_iter(self.pattern), index, flags)
+
+
+# Precompile CSS selector lists for pseudo-classes (additional logic may be required beyond the pattern)
+# A few patterns are order dependent as they use patterns previous compiled.
+
+# CSS pattern for `:link` and `:any-link`
+CSS_LINK = CSSParser(
+    'html|*:is(a, area)[href]'
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML)
+# CSS pattern for `:checked`
+CSS_CHECKED = CSSParser(
+    '''
+    html|*:is(input[type=checkbox], input[type=radio])[checked], html|option[selected]
+    '''
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML)
+# CSS pattern for `:default` (must compile CSS_CHECKED first)
+CSS_DEFAULT = CSSParser(
+    '''
+    :checked,
+
+    /*
+    This pattern must be at the end.
+    Special logic is applied to the last selector.
+    */
+    html|form html|*:is(button, input)[type="submit"]
+    '''
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML | FLG_DEFAULT)
+# CSS pattern for `:indeterminate`
+CSS_INDETERMINATE = CSSParser(
+    '''
+    html|input[type="checkbox"][indeterminate],
+    html|input[type="radio"]:is(:not([name]), [name=""]):not([checked]),
+    html|progress:not([value]),
+
+    /*
+    This pattern must be at the end.
+    Special logic is applied to the last selector.
+    */
+    html|input[type="radio"][name]:not([name='']):not([checked])
+    '''
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML | FLG_INDETERMINATE)
+# CSS pattern for `:disabled`
+CSS_DISABLED = CSSParser(
+    '''
+    html|*:is(input:not([type=hidden]), button, select, textarea, fieldset, optgroup, option, fieldset)[disabled],
+    html|optgroup[disabled] > html|option,
+    html|fieldset[disabled] > html|*:is(input:not([type=hidden]), button, select, textarea, fieldset),
+    html|fieldset[disabled] >
+        html|*:not(legend:nth-of-type(1)) html|*:is(input:not([type=hidden]), button, select, textarea, fieldset)
+    '''
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML)
+# CSS pattern for `:enabled`
+CSS_ENABLED = CSSParser(
+    '''
+    html|*:is(input:not([type=hidden]), button, select, textarea, fieldset, optgroup, option, fieldset):not(:disabled)
+    '''
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML)
+# CSS pattern for `:required`
+CSS_REQUIRED = CSSParser(
+    'html|*:is(input, textarea, select)[required]'
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML)
+# CSS pattern for `:optional`
+CSS_OPTIONAL = CSSParser(
+    'html|*:is(input, textarea, select):not([required])'
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML)
+# CSS pattern for `:placeholder-shown`
+CSS_PLACEHOLDER_SHOWN = CSSParser(
+    '''
+    html|input:is(
+        :not([type]),
+        [type=""],
+        [type=text],
+        [type=search],
+        [type=url],
+        [type=tel],
+        [type=email],
+        [type=password],
+        [type=number]
+    )[placeholder]:not([placeholder='']):is(:not([value]), [value=""]),
+    html|textarea[placeholder]:not([placeholder=''])
+    '''
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML | FLG_PLACEHOLDER_SHOWN)
+# CSS pattern default for `:nth-child` "of S" feature
+CSS_NTH_OF_S_DEFAULT = CSSParser(
+    '*|*'
+).process_selectors(flags=FLG_PSEUDO)
+# CSS pattern for `:read-write` (CSS_DISABLED must be compiled first)
+CSS_READ_WRITE = CSSParser(
+    '''
+    html|*:is(
+        textarea,
+        input:is(
+            :not([type]),
+            [type=""],
+            [type=text],
+            [type=search],
+            [type=url],
+            [type=tel],
+            [type=email],
+            [type=number],
+            [type=password],
+            [type=date],
+            [type=datetime-local],
+            [type=month],
+            [type=time],
+            [type=week]
+        )
+    ):not([readonly], :disabled),
+    html|*:is([contenteditable=""], [contenteditable="true" i])
+    '''
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML)
+# CSS pattern for `:read-only`
+CSS_READ_ONLY = CSSParser(
+    '''
+    html|*:not(:read-write)
+    '''
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML)
+# CSS pattern for `:in-range`
+CSS_IN_RANGE = CSSParser(
+    '''
+    html|input:is(
+        [type="date"],
+        [type="month"],
+        [type="week"],
+        [type="time"],
+        [type="datetime-local"],
+        [type="number"],
+        [type="range"]
+    ):is(
+        [min],
+        [max]
+    )
+    '''
+).process_selectors(flags=FLG_PSEUDO | FLG_IN_RANGE | FLG_HTML)
+# CSS pattern for `:out-of-range`
+CSS_OUT_OF_RANGE = CSSParser(
+    '''
+    html|input:is(
+        [type="date"],
+        [type="month"],
+        [type="week"],
+        [type="time"],
+        [type="datetime-local"],
+        [type="number"],
+        [type="range"]
+    ):is(
+        [min],
+        [max]
+    )
+    '''
+).process_selectors(flags=FLG_PSEUDO | FLG_OUT_OF_RANGE | FLG_HTML)
+
+# CSS pattern for :open
+CSS_OPEN = CSSParser(
+    '''
+    html|*:is(details, dialog)[open]
+    '''
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML)
+
+
+# CSS pattern for :muted
+CSS_MUTED = CSSParser(
+    '''
+    html|*:is(video, audio)[muted]
+    '''
+).process_selectors(flags=FLG_PSEUDO | FLG_HTML)
diff --git a/env/lib/python3.12/site-packages/soupsieve/css_types.py b/env/lib/python3.12/site-packages/soupsieve/css_types.py
new file mode 100644
index 0000000..b69fe8c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/soupsieve/css_types.py
@@ -0,0 +1,407 @@
+"""CSS selector structure items."""
+from __future__ import annotations
+import copyreg
+from .pretty import pretty
+from typing import Any, Iterator, Hashable, Pattern, Iterable, Mapping
+
+__all__ = (
+    'Selector',
+    'SelectorNull',
+    'SelectorTag',
+    'SelectorAttribute',
+    'SelectorContains',
+    'SelectorNth',
+    'SelectorLang',
+    'SelectorList',
+    'Namespaces',
+    'CustomSelectors'
+)
+
+
+SEL_EMPTY = 0x1
+SEL_ROOT = 0x2
+SEL_DEFAULT = 0x4
+SEL_INDETERMINATE = 0x8
+SEL_SCOPE = 0x10
+SEL_DIR_LTR = 0x20
+SEL_DIR_RTL = 0x40
+SEL_IN_RANGE = 0x80
+SEL_OUT_OF_RANGE = 0x100
+SEL_DEFINED = 0x200
+SEL_PLACEHOLDER_SHOWN = 0x400
+
+
+class Immutable:
+    """Immutable."""
+
+    __slots__: tuple[str, ...] = ('_hash',)
+
+    _hash: int
+
+    def __init__(self, **kwargs: Any) -> None:
+        """Initialize."""
+
+        temp = []
+        for k, v in kwargs.items():
+            temp.append(type(v))
+            temp.append(v)
+            super().__setattr__(k, v)
+        super().__setattr__('_hash', hash(tuple(temp)))
+
+    @classmethod
+    def __base__(cls) -> type[Immutable]:
+        """Get base class."""
+
+        return cls
+
+    def __eq__(self, other: Any) -> bool:
+        """Equal."""
+
+        return (
+            isinstance(other, self.__base__()) and
+            all(getattr(other, key) == getattr(self, key) for key in self.__slots__ if key != '_hash')
+        )
+
+    def __ne__(self, other: Any) -> bool:
+        """Equal."""
+
+        return (
+            not isinstance(other, self.__base__()) or
+            any(getattr(other, key) != getattr(self, key) for key in self.__slots__ if key != '_hash')
+        )
+
+    def __hash__(self) -> int:
+        """Hash."""
+
+        return self._hash
+
+    def __setattr__(self, name: str, value: Any) -> None:
+        """Prevent mutability."""
+
+        raise AttributeError(f"'{self.__class__.__name__}' is immutable")
+
+    def __repr__(self) -> str:  # pragma: no cover
+        """Representation."""
+
+        r = ', '.join([f"{k}={getattr(self, k)!r}" for k in self.__slots__[:-1]])
+        return f"{self.__class__.__name__}({r})"
+
+    __str__ = __repr__
+
+    def pretty(self) -> None:  # pragma: no cover
+        """Pretty print."""
+
+        print(pretty(self))
+
+
+class ImmutableDict(Mapping[Any, Any]):
+    """Hashable, immutable dictionary."""
+
+    def __init__(
+        self,
+        arg: dict[Any, Any] | Iterable[tuple[Any, Any]]
+    ) -> None:
+        """Initialize."""
+
+        self._validate(arg)
+        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: dict[Any, Any] | Iterable[tuple[Any, Any]]) -> None:
+        """Validate arguments."""
+
+        if isinstance(arg, dict):
+            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."""
+
+        return iter(self._d)
+
+    def __len__(self) -> int:
+        """Length."""
+
+        return len(self._d)
+
+    def __getitem__(self, key: Any) -> Any:
+        """Get item: `namespace['key']`."""
+
+        return self._d[key]
+
+    def __hash__(self) -> int:
+        """Hash."""
+
+        return self._hash
+
+    def __repr__(self) -> str:  # pragma: no cover
+        """Representation."""
+
+        return f"{self._d!r}"
+
+    __str__ = __repr__
+
+
+class Namespaces(ImmutableDict):
+    """Namespaces."""
+
+    def __init__(self, arg: dict[str, str] | Iterable[tuple[str, str]]) -> None:
+        """Initialize."""
+
+        super().__init__(arg)
+
+    def _validate(self, arg: dict[str, str] | Iterable[tuple[str, str]]) -> None:
+        """Validate arguments."""
+
+        if not all(
+            isinstance(k, str) and isinstance(v, str)
+            for k, v in (arg.items() if isinstance(arg, dict) else arg)
+        ):
+            raise TypeError(f'{self.__class__.__name__} values must be hashable')
+
+
+class CustomSelectors(ImmutableDict):
+    """Custom selectors."""
+
+    def __init__(self, arg: dict[str, str] | Iterable[tuple[str, str]]) -> None:
+        """Initialize."""
+
+        super().__init__(arg)
+
+    def _validate(self, arg: dict[str, str] | Iterable[tuple[str, str]]) -> None:
+        """Validate arguments."""
+
+        if not all(
+            isinstance(k, str) and isinstance(v, str)
+            for k, v in (arg.items() if isinstance(arg, dict) else arg)
+        ):
+            raise TypeError(f'{self.__class__.__name__} values must be hashable')
+
+
+class Selector(Immutable):
+    """Selector."""
+
+    __slots__ = (
+        'tag', 'ids', 'classes', 'attributes', 'nth', 'selectors',
+        'relation', 'rel_type', 'contains', 'lang', 'flags', '_hash'
+    )
+
+    tag: SelectorTag | None
+    ids: tuple[str, ...]
+    classes: tuple[str, ...]
+    attributes: tuple[SelectorAttribute, ...]
+    nth: tuple[SelectorNth, ...]
+    selectors: tuple[SelectorList, ...]
+    relation: SelectorList
+    rel_type: str | None
+    contains: tuple[SelectorContains, ...]
+    lang: tuple[SelectorLang, ...]
+    flags: int
+
+    def __init__(
+        self,
+        tag: SelectorTag | None,
+        ids: tuple[str, ...],
+        classes: tuple[str, ...],
+        attributes: tuple[SelectorAttribute, ...],
+        nth: tuple[SelectorNth, ...],
+        selectors: tuple[SelectorList, ...],
+        relation: SelectorList,
+        rel_type: str | None,
+        contains: tuple[SelectorContains, ...],
+        lang: tuple[SelectorLang, ...],
+        flags: int
+    ):
+        """Initialize."""
+
+        super().__init__(
+            tag=tag,
+            ids=ids,
+            classes=classes,
+            attributes=attributes,
+            nth=nth,
+            selectors=selectors,
+            relation=relation,
+            rel_type=rel_type,
+            contains=contains,
+            lang=lang,
+            flags=flags
+        )
+
+
+class SelectorNull(Immutable):
+    """Null Selector."""
+
+    def __init__(self) -> None:
+        """Initialize."""
+
+        super().__init__()
+
+
+class SelectorTag(Immutable):
+    """Selector tag."""
+
+    __slots__ = ("name", "prefix", "_hash")
+
+    name: str
+    prefix: str | None
+
+    def __init__(self, name: str, prefix: str | None) -> None:
+        """Initialize."""
+
+        super().__init__(name=name, prefix=prefix)
+
+
+class SelectorAttribute(Immutable):
+    """Selector attribute rule."""
+
+    __slots__ = ("attribute", "prefix", "pattern", "xml_type_pattern", "_hash")
+
+    attribute: str
+    prefix: str
+    pattern: Pattern[str] | None
+    xml_type_pattern: Pattern[str] | None
+
+    def __init__(
+        self,
+        attribute: str,
+        prefix: str,
+        pattern: Pattern[str] | None,
+        xml_type_pattern: Pattern[str] | None
+    ) -> None:
+        """Initialize."""
+
+        super().__init__(
+            attribute=attribute,
+            prefix=prefix,
+            pattern=pattern,
+            xml_type_pattern=xml_type_pattern
+        )
+
+
+class SelectorContains(Immutable):
+    """Selector contains rule."""
+
+    __slots__ = ("text", "own", "_hash")
+
+    text: tuple[str, ...]
+    own: bool
+
+    def __init__(self, text: Iterable[str], own: bool) -> None:
+        """Initialize."""
+
+        super().__init__(text=tuple(text), own=own)
+
+
+class SelectorNth(Immutable):
+    """Selector nth type."""
+
+    __slots__ = ("a", "n", "b", "of_type", "last", "selectors", "_hash")
+
+    a: int
+    n: bool
+    b: int
+    of_type: bool
+    last: bool
+    selectors: SelectorList
+
+    def __init__(self, a: int, n: bool, b: int, of_type: bool, last: bool, selectors: SelectorList) -> None:
+        """Initialize."""
+
+        super().__init__(
+            a=a,
+            n=n,
+            b=b,
+            of_type=of_type,
+            last=last,
+            selectors=selectors
+        )
+
+
+class SelectorLang(Immutable):
+    """Selector language rules."""
+
+    __slots__ = ("languages", "_hash",)
+
+    languages: tuple[str, ...]
+
+    def __init__(self, languages: Iterable[str]):
+        """Initialize."""
+
+        super().__init__(languages=tuple(languages))
+
+    def __iter__(self) -> Iterator[str]:
+        """Iterator."""
+
+        return iter(self.languages)
+
+    def __len__(self) -> int:  # pragma: no cover
+        """Length."""
+
+        return len(self.languages)
+
+    def __getitem__(self, index: int) -> str:  # pragma: no cover
+        """Get item."""
+
+        return self.languages[index]
+
+
+class SelectorList(Immutable):
+    """Selector list."""
+
+    __slots__ = ("selectors", "is_not", "is_html", "_hash")
+
+    selectors: tuple[Selector | SelectorNull, ...]
+    is_not: bool
+    is_html: bool
+
+    def __init__(
+        self,
+        selectors: Iterable[Selector | SelectorNull] | None = None,
+        is_not: bool = False,
+        is_html: bool = False
+    ) -> None:
+        """Initialize."""
+
+        super().__init__(
+            selectors=tuple(selectors) if selectors is not None else (),
+            is_not=is_not,
+            is_html=is_html
+        )
+
+    def __iter__(self) -> Iterator[Selector | SelectorNull]:
+        """Iterator."""
+
+        return iter(self.selectors)
+
+    def __len__(self) -> int:
+        """Length."""
+
+        return len(self.selectors)
+
+    def __getitem__(self, index: int) -> Selector | SelectorNull:
+        """Get item."""
+
+        return self.selectors[index]
+
+
+def _pickle(p: Any) -> Any:
+    return p.__base__(), tuple([getattr(p, s) for s in p.__slots__[:-1]])
+
+
+def pickle_register(obj: Any) -> None:
+    """Allow object to be pickled."""
+
+    copyreg.pickle(obj, _pickle)
+
+
+pickle_register(Selector)
+pickle_register(SelectorNull)
+pickle_register(SelectorTag)
+pickle_register(SelectorAttribute)
+pickle_register(SelectorContains)
+pickle_register(SelectorNth)
+pickle_register(SelectorLang)
+pickle_register(SelectorList)
diff --git a/env/lib/python3.12/site-packages/soupsieve/pretty.py b/env/lib/python3.12/site-packages/soupsieve/pretty.py
new file mode 100644
index 0000000..37d51d8
--- /dev/null
+++ b/env/lib/python3.12/site-packages/soupsieve/pretty.py
@@ -0,0 +1,148 @@
+"""
+Format a pretty string of a `SoupSieve` object for easy debugging.
+
+This won't necessarily support all types and such, and definitely
+not support custom outputs.
+
+It is mainly geared towards our types as the `SelectorList`
+object is a beast to look at without some indentation and newlines.
+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()
+SelectorList(
+    selectors=(
+        Selector(
+            tag=SelectorTag(
+                name='that',
+                prefix=None),
+            ids=(),
+            classes=(
+                'class',
+                ),
+            attributes=(
+                SelectorAttribute(
+                    attribute='name',
+                    prefix='',
+                    pattern=re.compile(
+                        '^value$'),
+                    xml_type_pattern=None),
+                ),
+            nth=(),
+            selectors=(),
+            relation=SelectorList(
+                selectors=(
+                    Selector(
+                        tag=SelectorTag(
+                            name='this',
+                            prefix=None),
+                        ids=(),
+                        classes=(),
+                        attributes=(),
+                        nth=(),
+                        selectors=(),
+                        relation=SelectorList(
+                            selectors=(),
+                            is_not=False,
+                            is_html=False),
+                        rel_type='>',
+                        contains=(),
+                        lang=(),
+                        flags=0),
+                    ),
+                is_not=False,
+                is_html=False),
+            rel_type=None,
+            contains=(),
+            lang=(),
+            flags=0),
+        ),
+    is_not=False,
+    is_html=False)
+```
+
+"""
+from __future__ import annotations
+import re
+from typing import Any
+
+RE_CLASS = re.compile(r'(?i)[a-z_][_a-z\d.]+\(')
+RE_PARAM = re.compile(r'(?i)[_a-z][_a-z\d]+=')
+RE_EMPTY = re.compile(r'\(\)|\[\]|\{\}')
+RE_LSTRT = re.compile(r'\[')
+RE_DSTRT = re.compile(r'\{')
+RE_TSTRT = re.compile(r'\(')
+RE_LEND = re.compile(r'\]')
+RE_DEND = re.compile(r'\}')
+RE_TEND = re.compile(r'\)')
+RE_INT = re.compile(r'\d+')
+RE_KWORD = re.compile(r'(?i)[_a-z][_a-z\d.]+')
+RE_DQSTR = re.compile(r'"(?:\\.|[^"\\])*"')
+RE_SQSTR = re.compile(r"'(?:\\.|[^'\\])*'")
+RE_SEP = re.compile(r'\s*(,)\s*')
+RE_DSEP = re.compile(r'\s*(:)\s*')
+RE_PSEP = re.compile(r'\s*(\|)\s*')
+
+TOKENS = {
+    'class': RE_CLASS,
+    'param': RE_PARAM,
+    'empty': RE_EMPTY,
+    'lstrt': RE_LSTRT,
+    'dstrt': RE_DSTRT,
+    'tstrt': RE_TSTRT,
+    'lend': RE_LEND,
+    'dend': RE_DEND,
+    'tend': RE_TEND,
+    'sqstr': RE_SQSTR,
+    'sep': RE_SEP,
+    'dsep': RE_DSEP,
+    'psep': RE_PSEP,
+    'int': RE_INT,
+    'kword': RE_KWORD,
+    'dqstr': RE_DQSTR
+}
+
+
+def pretty(obj: Any) -> str:  # pragma: no cover
+    """Make the object output string pretty."""
+
+    sel = str(obj)
+    index = 0
+    end = len(sel) - 1
+    indent = 0
+    output = []
+
+    while index <= end:
+        m = None
+        for k, v in TOKENS.items():
+            m = v.match(sel, index)
+
+            if m:
+                name = k
+                index = m.end(0)
+                if name in ('class', 'lstrt', 'dstrt', 'tstrt'):
+                    indent += 4
+                    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(f'{m.group(1)}\n{" " * indent}')
+                elif name in ('dsep',):
+                    output.append(f'{m.group(1)} ')
+                elif name in ('psep'):
+                    output.append(f' {m.group(1)} ')
+                break
+
+        # We shouldn't hit this, but if we do, store unrecognized character
+        if m is None:  # pragma: no cover
+            output.append(sel[index])
+            index += 1
+
+    return ''.join(output)
diff --git a/env/lib/python3.12/site-packages/soupsieve/py.typed b/env/lib/python3.12/site-packages/soupsieve/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/env/lib/python3.12/site-packages/soupsieve/util.py b/env/lib/python3.12/site-packages/soupsieve/util.py
new file mode 100644
index 0000000..9b2e64d
--- /dev/null
+++ b/env/lib/python3.12/site-packages/soupsieve/util.py
@@ -0,0 +1,117 @@
+"""Utility."""
+from __future__ import annotations
+from functools import wraps, lru_cache
+import warnings
+import re
+from typing import Callable, Any
+
+DEBUG = 0x00001
+
+RE_PATTERN_LINE_SPLIT = re.compile(r'(?:\r\n|(?!\r\n)[\n\r])|$')
+
+UC_A = ord('A')
+UC_Z = ord('Z')
+
+
+@lru_cache(maxsize=512)
+def lower(string: str) -> str:
+    """Lower."""
+
+    new_string = []
+    for c in string:
+        o = ord(c)
+        new_string.append(chr(o + 32) if UC_A <= o <= UC_Z else c)
+    return ''.join(new_string)
+
+
+class SelectorSyntaxError(Exception):
+    """Syntax error in a CSS selector."""
+
+    def __init__(self, msg: str, pattern: str | None = None, index: int | None = None) -> None:
+        """Initialize."""
+
+        self.line = None
+        self.col = None
+        self.context = None
+
+        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 = f'{msg}\n  line {self.line}:\n{self.context}'
+
+        super().__init__(msg)
+
+
+def deprecated(message: str, stacklevel: int = 2) -> Callable[..., Any]:  # pragma: no cover
+    """
+    Raise a `DeprecationWarning` when wrapped function/method is called.
+
+    Usage:
+
+        @deprecated("This method will be removed in version X; use Y instead.")
+        def some_method()"
+            pass
+    """
+
+    def _wrapper(func: Callable[..., Any]) -> Callable[..., Any]:
+        @wraps(func)
+        def _deprecated_func(*args: Any, **kwargs: Any) -> Any:
+            warnings.warn(
+                f"'{func.__name__}' is deprecated. {message}",
+                category=DeprecationWarning,
+                stacklevel=stacklevel
+            )
+            return func(*args, **kwargs)
+        return _deprecated_func
+    return _wrapper
+
+
+def warn_deprecated(message: str, stacklevel: int = 2) -> None:  # pragma: no cover
+    """Warn deprecated."""
+
+    warnings.warn(
+        message,
+        category=DeprecationWarning,
+        stacklevel=stacklevel
+    )
+
+
+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]
+    line = 1
+    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):
+        linetext = pattern[last:m.start(0)]
+        if not len(m.group(0)) and not len(text):
+            indent = ''
+            offset = -1
+            col = index - last + 1
+        elif last <= index < m.end(0):
+            indent = '--> '
+            offset = (-1 if index > m.start(0) else 0) + 3
+            col = index - last + 1
+        else:
+            indent = '    '
+            offset = None
+        if len(text):
+            # Regardless of whether we are presented with `\r\n`, `\r`, or `\n`,
+            # we will render the output with just `\n`. We will still log the column
+            # correctly though.
+            text.append('\n')
+        text.append(f'{indent}{linetext}')
+        if offset is not None:
+            text.append('\n')
+            text.append(' ' * (col + offset) + '^')
+            line = current_line
+
+        current_line += 1
+        last = m.end(0)
+
+    return ''.join(text), line, col
diff --git a/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/INSTALLER b/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/LICENSE b/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/LICENSE
new file mode 100644
index 0000000..f4b5452
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/LICENSE
@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2013-2020, Simon Sapin and contributors.
+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 the name of the copyright holder nor the names of its
+  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 COPYRIGHT HOLDER 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/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/METADATA b/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/METADATA
new file mode 100644
index 0000000..95868fd
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/METADATA
@@ -0,0 +1,65 @@
+Metadata-Version: 2.1
+Name: tinycss2
+Version: 1.4.0
+Summary: A tiny CSS parser
+Keywords: css,parser
+Author-email: Simon Sapin 
+Maintainer-email: CourtBouillon 
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Text Processing
+Requires-Dist: webencodings >=0.4
+Requires-Dist: sphinx ; extra == "doc"
+Requires-Dist: sphinx_rtd_theme ; extra == "doc"
+Requires-Dist: pytest ; extra == "test"
+Requires-Dist: ruff ; extra == "test"
+Project-URL: Changelog, https://github.com/Kozea/tinycss2/releases
+Project-URL: Code, https://github.com/Kozea/tinycss2/
+Project-URL: Documentation, https://doc.courtbouillon.org/tinycss2/
+Project-URL: Donation, https://opencollective.com/courtbouillon
+Project-URL: Homepage, https://www.courtbouillon.org/tinycss2
+Project-URL: Issues, https://github.com/Kozea/tinycss2/issues
+Provides-Extra: doc
+Provides-Extra: test
+
+tinycss2 is a low-level CSS parser and generator written in Python: it can
+parse strings, return objects representing tokens and blocks, and generate CSS
+strings corresponding to these objects.
+
+Based on the CSS Syntax Level 3 specification, tinycss2 knows the grammar of
+CSS but doesn't know specific rules, properties or values supported in various
+CSS modules.
+
+* Free software: BSD license
+* For Python 3.8+, tested on CPython and PyPy
+* Documentation: https://doc.courtbouillon.org/tinycss2
+* Changelog: https://github.com/Kozea/tinycss2/releases
+* Code, issues, tests: https://github.com/Kozea/tinycss2
+* Code of conduct: https://www.courtbouillon.org/code-of-conduct
+* Professional support: https://www.courtbouillon.org
+* Donation: https://opencollective.com/courtbouillon
+
+tinycss2 has been created and developed by Kozea (https://kozea.fr).
+Professional support, maintenance and community management is provided by
+CourtBouillon (https://www.courtbouillon.org).
+
+Copyrights are retained by their contributors, no copyright assignment is
+required to contribute to tinycss2. Unless explicitly stated otherwise, any
+contribution intentionally submitted for inclusion is licensed under the BSD
+3-clause license, without any additional terms or conditions. For full
+authorship information, see the version control history.
+
diff --git a/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/RECORD b/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/RECORD
new file mode 100644
index 0000000..3f074ca
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/RECORD
@@ -0,0 +1,23 @@
+tinycss2-1.4.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+tinycss2-1.4.0.dist-info/LICENSE,sha256=a5Ss7iDsnycJMzE087pwMiU1-0IK8M6MFFXZy-KX8dU,1534
+tinycss2-1.4.0.dist-info/METADATA,sha256=tgGsLeN7tzqnNWLkB714mhimO3pYc3hdOz2f2EAAh8o,2993
+tinycss2-1.4.0.dist-info/RECORD,,
+tinycss2-1.4.0.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+tinycss2/__init__.py,sha256=t2MI08yUCG1hW6w3LqpCVcYeHEDhMjJgwMmXhNEW-Ak,603
+tinycss2/__pycache__/__init__.cpython-312.pyc,,
+tinycss2/__pycache__/ast.cpython-312.pyc,,
+tinycss2/__pycache__/bytes.cpython-312.pyc,,
+tinycss2/__pycache__/color3.cpython-312.pyc,,
+tinycss2/__pycache__/color4.cpython-312.pyc,,
+tinycss2/__pycache__/nth.cpython-312.pyc,,
+tinycss2/__pycache__/parser.cpython-312.pyc,,
+tinycss2/__pycache__/serializer.cpython-312.pyc,,
+tinycss2/__pycache__/tokenizer.cpython-312.pyc,,
+tinycss2/ast.py,sha256=hnqlRtDE11NOj2C5kdbsedXE4sKWoTTq0YB-0DOwwd0,23462
+tinycss2/bytes.py,sha256=P-8GD4_j8Gap2YsySxXl1qB16TCqS4LtKro5U4wHesU,4768
+tinycss2/color3.py,sha256=vVMPB0CJQv2aURfgnsQPbKdNnOJooaSbmrxscj5YXpc,11150
+tinycss2/color4.py,sha256=28dO6_lZcsjRCrpyCzzkA3V7uk5hoBYmIER2_mal83o,16604
+tinycss2/nth.py,sha256=f06rk4uuyDBf7TfRe8B5CzC3F2NqlKhH4AXkO_hcyPA,3488
+tinycss2/parser.py,sha256=3gkyQYeRRcrNBJfBMbi7nVDFt8IoN5_ZWXcwG9GPcsw,19071
+tinycss2/serializer.py,sha256=31IwfZKDPg8-1RTR9y48580HFtzNVlxMmIQhoPNvNTg,4197
+tinycss2/tokenizer.py,sha256=fkjg1xrcwOXATCH4fbwWaIQN0smd2V2XBkIbRhEr3cw,15293
diff --git a/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/WHEEL b/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/WHEEL
new file mode 100644
index 0000000..3b5e64b
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tinycss2-1.4.0.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.9.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/env/lib/python3.12/site-packages/tinycss2/__init__.py b/env/lib/python3.12/site-packages/tinycss2/__init__.py
new file mode 100644
index 0000000..dabb74c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tinycss2/__init__.py
@@ -0,0 +1,18 @@
+"""
+tinycss2
+========
+
+tinycss2 is a low-level CSS parser and generator: it can parse strings, return
+Python objects representing tokens and blocks, and generate CSS strings
+corresponding to these objects.
+
+"""
+
+from .bytes import parse_stylesheet_bytes  # noqa
+from .parser import (  # noqa
+    parse_blocks_contents, parse_declaration_list, parse_one_component_value,
+    parse_one_declaration, parse_one_rule, parse_rule_list, parse_stylesheet)
+from .serializer import serialize, serialize_identifier  # noqa
+from .tokenizer import parse_component_value_list  # noqa
+
+VERSION = __version__ = '1.4.0'
diff --git a/env/lib/python3.12/site-packages/tinycss2/ast.py b/env/lib/python3.12/site-packages/tinycss2/ast.py
new file mode 100644
index 0000000..0919d18
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tinycss2/ast.py
@@ -0,0 +1,874 @@
+"""
+
+Data structures for the CSS abstract syntax tree.
+
+"""
+
+
+from webencodings import ascii_lower
+
+from .serializer import _serialize_to, serialize_identifier, serialize_name
+
+
+class Node:
+    """Every node type inherits from this class,
+    which is never instantiated directly.
+
+    .. attribute:: type
+
+        Each child class has a :attr:`type` class attribute
+        with a unique string value.
+        This allows checking for the node type with code like:
+
+        .. code-block:: python
+
+            if node.type == 'whitespace':
+
+        instead of the more verbose:
+
+        .. code-block:: python
+
+            from tinycss2.ast import WhitespaceToken
+            if isinstance(node, WhitespaceToken):
+
+    Every node also has these attributes and methods,
+    which are not repeated for brevity:
+
+    .. attribute:: source_line
+
+        The line number of the start of the node in the CSS source.
+        Starts at 1.
+
+    .. attribute:: source_column
+
+        The column number within :attr:`source_line` of the start of the node
+        in the CSS source.
+        Starts at 1.
+
+    .. automethod:: serialize
+
+    """
+    __slots__ = ['source_line', 'source_column']
+
+    def __init__(self, source_line, source_column):
+        self.source_line = source_line
+        self.source_column = source_column
+
+    def __repr__(self):
+        return self.repr_format.format(self=self)
+
+    def serialize(self):
+        """Serialize this node to CSS syntax and return a Unicode string."""
+        chunks = []
+        self._serialize_to(chunks.append)
+        return ''.join(chunks)
+
+    def _serialize_to(self, write):
+        """Serialize this node to CSS syntax, writing chunks as Unicode string
+        by calling the provided :obj:`write` callback.
+
+        """
+        raise NotImplementedError  # pragma: no cover
+
+
+class ParseError(Node):
+    """A syntax error of some sort. May occur anywhere in the tree.
+
+    Syntax errors are not fatal in the parser
+    to allow for different error handling behaviors.
+    For example, an error in a Selector list makes the whole rule invalid,
+    but an error in a Media Query list only replaces one comma-separated query
+    with ``not all``.
+
+    .. autoattribute:: type
+
+    .. attribute:: kind
+
+        Machine-readable string indicating the type of error.
+        Example: ``'bad-url'``.
+
+    .. attribute:: message
+
+        Human-readable explanation of the error, as a string.
+        Could be translated, expanded to include details, etc.
+
+    """
+    __slots__ = ['kind', 'message']
+    type = 'error'
+    repr_format = '<{self.__class__.__name__} {self.kind}>'
+
+    def __init__(self, line, column, kind, message):
+        Node.__init__(self, line, column)
+        self.kind = kind
+        self.message = message
+
+    def _serialize_to(self, write):
+        if self.kind == 'bad-string':
+            write('"[bad string]\n')
+        elif self.kind == 'bad-url':
+            write('url([bad url])')
+        elif self.kind in ')]}':
+            write(self.kind)
+        elif self.kind in ('eof-in-string', 'eof-in-url'):
+            pass
+        else:  # pragma: no cover
+            raise TypeError('Can not serialize %r' % self)
+
+
+class Comment(Node):
+    """A CSS comment.
+
+    Comments can be ignored by passing ``skip_comments=True``
+    to functions such as :func:`~tinycss2.parse_component_value_list`.
+
+    .. autoattribute:: type
+
+    .. attribute:: value
+
+        The content of the comment, between ``/*`` and ``*/``, as a string.
+
+    """
+    __slots__ = ['value']
+    type = 'comment'
+    repr_format = '<{self.__class__.__name__} {self.value}>'
+
+    def __init__(self, line, column, value):
+        Node.__init__(self, line, column)
+        self.value = value
+
+    def _serialize_to(self, write):
+        write('/*')
+        write(self.value)
+        write('*/')
+
+
+class WhitespaceToken(Node):
+    """A :diagram:`whitespace-token`.
+
+    .. autoattribute:: type
+
+    .. attribute:: value
+
+        The whitespace sequence, as a string, as in the original CSS source.
+
+
+    """
+    __slots__ = ['value']
+    type = 'whitespace'
+    repr_format = '<{self.__class__.__name__}>'
+
+    def __init__(self, line, column, value):
+        Node.__init__(self, line, column)
+        self.value = value
+
+    def _serialize_to(self, write):
+        write(self.value)
+
+
+class LiteralToken(Node):
+    r"""Token that represents one or more characters as in the CSS source.
+
+    .. autoattribute:: type
+
+    .. attribute:: value
+
+        A string of one to four characters.
+
+    Instances compare equal to their :attr:`value`,
+    so that these are equivalent:
+
+    .. code-block:: python
+
+        if node == ';':
+        if node.type == 'literal' and node.value == ';':
+
+    This regroups what `the specification`_ defines as separate token types:
+
+    .. _the specification: https://drafts.csswg.org/css-syntax-3/
+
+    * ** ``:``
+    * ** ``;``
+    * ** ``,``
+    * ** ``-->``
+    * ** ```` tokens are not ignored.
+
+    :type input: :obj:`str` or :term:`iterable`
+    :param input: A string or an iterable of :term:`component values`.
+    :type skip_comments: :obj:`bool`
+    :param skip_comments:
+        Ignore CSS comments at the top-level of the list.
+        If the input is a string, ignore all comments.
+    :type skip_whitespace: :obj:`bool`
+    :param skip_whitespace:
+        Ignore whitespace at the top-level of the list.
+        Whitespace is still preserved
+        in the :attr:`~tinycss2.ast.QualifiedRule.prelude`
+        and the :attr:`~tinycss2.ast.QualifiedRule.content` of rules.
+    :returns:
+        A list of
+        :class:`~tinycss2.ast.QualifiedRule`,
+        :class:`~tinycss2.ast.AtRule`,
+        :class:`~tinycss2.ast.Comment` (if ``skip_comments`` is false),
+        :class:`~tinycss2.ast.WhitespaceToken`
+        (if ``skip_whitespace`` is false),
+        and :class:`~tinycss2.ast.ParseError` objects.
+
+    """
+    tokens = _to_token_iterator(input, skip_comments)
+    result = []
+    for token in tokens:
+        if token.type == 'whitespace':
+            if not skip_whitespace:
+                result.append(token)
+        elif token.type == 'comment':
+            if not skip_comments:
+                result.append(token)
+        else:
+            result.append(_consume_rule(token, tokens))
+    return result
+
+
+def parse_stylesheet(input, skip_comments=False, skip_whitespace=False):
+    """Parse :diagram:`stylesheet` from text.
+
+    This is used e.g. for a ``
+
+
+
+
+
    ...
    
+
+
+
    ...
    
+
+
+
+")
+        self.assertEqual(response.code, 400)
+        self.assertEqual(response.reason, "Unknown")
+        self.assertNotIn(b"script", response.body)
+        self.assertIn(b"Unknown", response.body)
+
+
+class DateHeaderTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            self.write("hello")
+
+    def test_date_header(self):
+        response = self.fetch("/")
+        header_date = email.utils.parsedate_to_datetime(response.headers["Date"])
+        self.assertLess(
+            header_date - datetime.datetime.now(datetime.timezone.utc),
+            datetime.timedelta(seconds=2),
+        )
+
+
+class RaiseWithReasonTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            raise HTTPError(682, reason="Foo")
+
+    def get_http_client(self):
+        # simple_httpclient only: curl doesn't expose the reason string
+        return SimpleAsyncHTTPClient()
+
+    def test_raise_with_reason(self):
+        response = self.fetch("/")
+        self.assertEqual(response.code, 682)
+        self.assertEqual(response.reason, "Foo")
+        self.assertIn(b"682: Foo", response.body)
+
+    def test_httperror_str(self):
+        self.assertEqual(str(HTTPError(682, reason="Foo")), "HTTP 682: Foo")
+
+    def test_httperror_str_from_httputil(self):
+        self.assertEqual(str(HTTPError(682)), "HTTP 682: Unknown")
+
+
+class ErrorHandlerXSRFTest(WebTestCase):
+    def get_handlers(self):
+        # note that if the handlers list is empty we get the default_host
+        # redirect fallback instead of a 404, so test with both an
+        # explicitly defined error handler and an implicit 404.
+        return [("/error", ErrorHandler, dict(status_code=417))]
+
+    def get_app_kwargs(self):
+        return dict(xsrf_cookies=True)
+
+    def test_error_xsrf(self):
+        response = self.fetch("/error", method="POST", body="")
+        self.assertEqual(response.code, 417)
+
+    def test_404_xsrf(self):
+        response = self.fetch("/404", method="POST", body="")
+        self.assertEqual(response.code, 404)
+
+
+class GzipTestCase(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            for v in self.get_arguments("vary"):
+                self.add_header("Vary", v)
+            # Must write at least MIN_LENGTH bytes to activate compression.
+            self.write("hello world" + ("!" * GZipContentEncoding.MIN_LENGTH))
+
+    def get_app_kwargs(self):
+        return dict(
+            gzip=True, static_path=os.path.join(os.path.dirname(__file__), "static")
+        )
+
+    def assert_compressed(self, response):
+        # simple_httpclient renames the content-encoding header;
+        # curl_httpclient doesn't.
+        self.assertEqual(
+            response.headers.get(
+                "Content-Encoding", response.headers.get("X-Consumed-Content-Encoding")
+            ),
+            "gzip",
+        )
+
+    def test_gzip(self):
+        response = self.fetch("/")
+        self.assert_compressed(response)
+        self.assertEqual(response.headers["Vary"], "Accept-Encoding")
+
+    def test_gzip_static(self):
+        # The streaming responses in StaticFileHandler have subtle
+        # interactions with the gzip output so test this case separately.
+        response = self.fetch("/robots.txt")
+        self.assert_compressed(response)
+        self.assertEqual(response.headers["Vary"], "Accept-Encoding")
+
+    def test_gzip_not_requested(self):
+        response = self.fetch("/", use_gzip=False)
+        self.assertNotIn("Content-Encoding", response.headers)
+        self.assertEqual(response.headers["Vary"], "Accept-Encoding")
+
+    def test_vary_already_present(self):
+        response = self.fetch("/?vary=Accept-Language")
+        self.assert_compressed(response)
+        self.assertEqual(
+            [s.strip() for s in response.headers["Vary"].split(",")],
+            ["Accept-Language", "Accept-Encoding"],
+        )
+
+    def test_vary_already_present_multiple(self):
+        # Regression test for https://github.com/tornadoweb/tornado/issues/1670
+        response = self.fetch("/?vary=Accept-Language&vary=Cookie")
+        self.assert_compressed(response)
+        self.assertEqual(
+            [s.strip() for s in response.headers["Vary"].split(",")],
+            ["Accept-Language", "Cookie", "Accept-Encoding"],
+        )
+
+
+class PathArgsInPrepareTest(WebTestCase):
+    class Handler(RequestHandler):
+        def prepare(self):
+            self.write(dict(args=self.path_args, kwargs=self.path_kwargs))
+
+        def get(self, path):
+            assert path == "foo"
+            self.finish()
+
+    def get_handlers(self):
+        return [("/pos/(.*)", self.Handler), ("/kw/(?P.*)", self.Handler)]
+
+    def test_pos(self):
+        response = self.fetch("/pos/foo")
+        response.rethrow()
+        data = json_decode(response.body)
+        self.assertEqual(data, {"args": ["foo"], "kwargs": {}})
+
+    def test_kw(self):
+        response = self.fetch("/kw/foo")
+        response.rethrow()
+        data = json_decode(response.body)
+        self.assertEqual(data, {"args": [], "kwargs": {"path": "foo"}})
+
+
+class ClearAllCookiesTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            self.clear_all_cookies()
+            self.write("ok")
+
+    def test_clear_all_cookies(self):
+        response = self.fetch("/", headers={"Cookie": "foo=bar; baz=xyzzy"})
+        set_cookies = sorted(response.headers.get_list("Set-Cookie"))
+        # Python 3.5 sends 'baz="";'; older versions use 'baz=;'
+        self.assertTrue(set_cookies[0].startswith('baz="";'))
+        self.assertTrue(set_cookies[1].startswith('foo="";'))
+
+
+class PermissionError(Exception):
+    pass
+
+
+class ExceptionHandlerTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            exc = self.get_argument("exc")
+            if exc == "http":
+                raise HTTPError(410, "no longer here")
+            elif exc == "zero":
+                1 / 0
+            elif exc == "permission":
+                raise PermissionError("not allowed")
+
+        def write_error(self, status_code, **kwargs):
+            if "exc_info" in kwargs:
+                typ, value, tb = kwargs["exc_info"]
+                if isinstance(value, PermissionError):
+                    self.set_status(403)
+                    self.write("PermissionError")
+                    return
+            RequestHandler.write_error(self, status_code, **kwargs)
+
+        def log_exception(self, typ, value, tb):
+            if isinstance(value, PermissionError):
+                app_log.warning("custom logging for PermissionError: %s", value.args[0])
+            else:
+                RequestHandler.log_exception(self, typ, value, tb)
+
+    def test_http_error(self):
+        # HTTPErrors are logged as warnings with no stack trace.
+        # TODO: extend ExpectLog to test this more precisely
+        with ExpectLog(gen_log, ".*no longer here"):
+            response = self.fetch("/?exc=http")
+            self.assertEqual(response.code, 410)
+
+    def test_unknown_error(self):
+        # Unknown errors are logged as errors with a stack trace.
+        with ExpectLog(app_log, "Uncaught exception"):
+            response = self.fetch("/?exc=zero")
+            self.assertEqual(response.code, 500)
+
+    def test_known_error(self):
+        # log_exception can override logging behavior, and write_error
+        # can override the response.
+        with ExpectLog(app_log, "custom logging for PermissionError: not allowed"):
+            response = self.fetch("/?exc=permission")
+            self.assertEqual(response.code, 403)
+
+
+class BuggyLoggingTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            1 / 0
+
+        def log_exception(self, typ, value, tb):
+            1 / 0
+
+    def test_buggy_log_exception(self):
+        # Something gets logged even though the application's
+        # logger is broken.
+        with ExpectLog(app_log, ".*"):
+            self.fetch("/")
+
+
+class UIMethodUIModuleTest(SimpleHandlerTestCase):
+    """Test that UI methods and modules are created correctly and
+    associated with the handler.
+    """
+
+    class Handler(RequestHandler):
+        def get(self):
+            self.render("foo.html")
+
+        def value(self):
+            return self.get_argument("value")
+
+    def get_app_kwargs(self):
+        def my_ui_method(handler, x):
+            return f"In my_ui_method({x}) with handler value {handler.value()}."
+
+        class MyModule(UIModule):
+            def render(self, x):
+                return "In MyModule({}) with handler value {}.".format(
+                    x,
+                    typing.cast(UIMethodUIModuleTest.Handler, self.handler).value(),
+                )
+
+        loader = DictLoader(
+            {"foo.html": "{{ my_ui_method(42) }} {% module MyModule(123) %}"}
+        )
+        return dict(
+            template_loader=loader,
+            ui_methods={"my_ui_method": my_ui_method},
+            ui_modules={"MyModule": MyModule},
+        )
+
+    def tearDown(self):
+        super().tearDown()
+        # TODO: fix template loader caching so this isn't necessary.
+        RequestHandler._template_loaders.clear()
+
+    def test_ui_method(self):
+        response = self.fetch("/?value=asdf")
+        self.assertEqual(
+            response.body,
+            b"In my_ui_method(42) with handler value asdf. "
+            b"In MyModule(123) with handler value asdf.",
+        )
+
+
+class GetArgumentErrorTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            try:
+                self.get_argument("foo")
+                self.write({})
+            except MissingArgumentError as e:
+                self.write({"arg_name": e.arg_name, "log_message": e.log_message})
+
+    def test_catch_error(self):
+        response = self.fetch("/")
+        self.assertEqual(
+            json_decode(response.body),
+            {"arg_name": "foo", "log_message": "Missing argument foo"},
+        )
+
+
+class SetLazyPropertiesTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def prepare(self):
+            self.current_user = "Ben"
+            self.locale = locale.get("en_US")
+
+        def get_user_locale(self):
+            raise NotImplementedError()
+
+        def get_current_user(self):
+            raise NotImplementedError()
+
+        def get(self):
+            self.write(f"Hello {self.current_user} ({self.locale.code})")
+
+    def test_set_properties(self):
+        # Ensure that current_user can be assigned to normally for apps
+        # that want to forgo the lazy get_current_user property
+        response = self.fetch("/")
+        self.assertEqual(response.body, b"Hello Ben (en_US)")
+
+
+class GetCurrentUserTest(WebTestCase):
+    def get_app_kwargs(self):
+        class WithoutUserModule(UIModule):
+            def render(self):
+                return ""
+
+        class WithUserModule(UIModule):
+            def render(self):
+                return str(self.current_user)
+
+        loader = DictLoader(
+            {
+                "without_user.html": "",
+                "with_user.html": "{{ current_user }}",
+                "without_user_module.html": "{% module WithoutUserModule() %}",
+                "with_user_module.html": "{% module WithUserModule() %}",
+            }
+        )
+        return dict(
+            template_loader=loader,
+            ui_modules={
+                "WithUserModule": WithUserModule,
+                "WithoutUserModule": WithoutUserModule,
+            },
+        )
+
+    def tearDown(self):
+        super().tearDown()
+        RequestHandler._template_loaders.clear()
+
+    def get_handlers(self):
+        class CurrentUserHandler(RequestHandler):
+            def prepare(self):
+                self.has_loaded_current_user = False
+
+            def get_current_user(self):
+                self.has_loaded_current_user = True
+                return ""
+
+        class WithoutUserHandler(CurrentUserHandler):
+            def get(self):
+                self.render_string("without_user.html")
+                self.finish(str(self.has_loaded_current_user))
+
+        class WithUserHandler(CurrentUserHandler):
+            def get(self):
+                self.render_string("with_user.html")
+                self.finish(str(self.has_loaded_current_user))
+
+        class CurrentUserModuleHandler(CurrentUserHandler):
+            def get_template_namespace(self):
+                # If RequestHandler.get_template_namespace is called, then
+                # get_current_user is evaluated. Until #820 is fixed, this
+                # is a small hack to circumvent the issue.
+                return self.ui
+
+        class WithoutUserModuleHandler(CurrentUserModuleHandler):
+            def get(self):
+                self.render_string("without_user_module.html")
+                self.finish(str(self.has_loaded_current_user))
+
+        class WithUserModuleHandler(CurrentUserModuleHandler):
+            def get(self):
+                self.render_string("with_user_module.html")
+                self.finish(str(self.has_loaded_current_user))
+
+        return [
+            ("/without_user", WithoutUserHandler),
+            ("/with_user", WithUserHandler),
+            ("/without_user_module", WithoutUserModuleHandler),
+            ("/with_user_module", WithUserModuleHandler),
+        ]
+
+    @unittest.skip("needs fix")
+    def test_get_current_user_is_lazy(self):
+        # TODO: Make this test pass. See #820.
+        response = self.fetch("/without_user")
+        self.assertEqual(response.body, b"False")
+
+    def test_get_current_user_works(self):
+        response = self.fetch("/with_user")
+        self.assertEqual(response.body, b"True")
+
+    def test_get_current_user_from_ui_module_is_lazy(self):
+        response = self.fetch("/without_user_module")
+        self.assertEqual(response.body, b"False")
+
+    def test_get_current_user_from_ui_module_works(self):
+        response = self.fetch("/with_user_module")
+        self.assertEqual(response.body, b"True")
+
+
+class UnimplementedHTTPMethodsTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        pass
+
+    def test_unimplemented_standard_methods(self):
+        for method in ["HEAD", "GET", "DELETE", "OPTIONS"]:
+            response = self.fetch("/", method=method)
+            self.assertEqual(response.code, 405)
+        for method in ["POST", "PUT"]:
+            response = self.fetch("/", method=method, body=b"")
+            self.assertEqual(response.code, 405)
+
+
+class UnimplementedNonStandardMethodsTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def other(self):
+            # Even though this method exists, it won't get called automatically
+            # because it is not in SUPPORTED_METHODS.
+            self.write("other")
+
+    def test_unimplemented_patch(self):
+        # PATCH is recently standardized; Tornado supports it by default
+        # but wsgiref.validate doesn't like it.
+        response = self.fetch("/", method="PATCH", body=b"")
+        self.assertEqual(response.code, 405)
+
+    def test_unimplemented_other(self):
+        response = self.fetch("/", method="OTHER", allow_nonstandard_methods=True)
+        self.assertEqual(response.code, 405)
+
+
+class AllHTTPMethodsTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def method(self):
+            assert self.request.method is not None
+            self.write(self.request.method)
+
+        get = delete = options = post = put = method  # type: ignore
+
+    def test_standard_methods(self):
+        response = self.fetch("/", method="HEAD")
+        self.assertEqual(response.body, b"")
+        for method in ["GET", "DELETE", "OPTIONS"]:
+            response = self.fetch("/", method=method)
+            self.assertEqual(response.body, utf8(method))
+        for method in ["POST", "PUT"]:
+            response = self.fetch("/", method=method, body=b"")
+            self.assertEqual(response.body, utf8(method))
+
+
+class PatchMethodTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        SUPPORTED_METHODS = RequestHandler.SUPPORTED_METHODS + (  # type: ignore
+            "OTHER",
+        )
+
+        def patch(self):
+            self.write("patch")
+
+        def other(self):
+            self.write("other")
+
+    def test_patch(self):
+        response = self.fetch("/", method="PATCH", body=b"")
+        self.assertEqual(response.body, b"patch")
+
+    def test_other(self):
+        response = self.fetch("/", method="OTHER", allow_nonstandard_methods=True)
+        self.assertEqual(response.body, b"other")
+
+
+class FinishInPrepareTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def prepare(self):
+            self.finish("done")
+
+        def get(self):
+            # It's difficult to assert for certain that a method did not
+            # or will not be called in an asynchronous context, but this
+            # will be logged noisily if it is reached.
+            raise Exception("should not reach this method")
+
+    def test_finish_in_prepare(self):
+        response = self.fetch("/")
+        self.assertEqual(response.body, b"done")
+
+
+class Default404Test(WebTestCase):
+    def get_handlers(self):
+        # If there are no handlers at all a default redirect handler gets added.
+        return [("/foo", RequestHandler)]
+
+    def test_404(self):
+        response = self.fetch("/")
+        self.assertEqual(response.code, 404)
+        self.assertEqual(
+            response.body,
+            b"404: Not Found"
+            b"404: Not Found",
+        )
+
+
+class Custom404Test(WebTestCase):
+    def get_handlers(self):
+        return [("/foo", RequestHandler)]
+
+    def get_app_kwargs(self):
+        class Custom404Handler(RequestHandler):
+            def get(self):
+                self.set_status(404)
+                self.write("custom 404 response")
+
+        return dict(default_handler_class=Custom404Handler)
+
+    def test_404(self):
+        response = self.fetch("/")
+        self.assertEqual(response.code, 404)
+        self.assertEqual(response.body, b"custom 404 response")
+
+
+class DefaultHandlerArgumentsTest(WebTestCase):
+    def get_handlers(self):
+        return [("/foo", RequestHandler)]
+
+    def get_app_kwargs(self):
+        return dict(
+            default_handler_class=ErrorHandler,
+            default_handler_args=dict(status_code=403),
+        )
+
+    def test_403(self):
+        response = self.fetch("/")
+        self.assertEqual(response.code, 403)
+
+
+class HandlerByNameTest(WebTestCase):
+    def get_handlers(self):
+        # All three are equivalent.
+        return [
+            ("/hello1", HelloHandler),
+            ("/hello2", "tornado.test.web_test.HelloHandler"),
+            url("/hello3", "tornado.test.web_test.HelloHandler"),
+        ]
+
+    def test_handler_by_name(self):
+        resp = self.fetch("/hello1")
+        self.assertEqual(resp.body, b"hello")
+        resp = self.fetch("/hello2")
+        self.assertEqual(resp.body, b"hello")
+        resp = self.fetch("/hello3")
+        self.assertEqual(resp.body, b"hello")
+
+
+class StreamingRequestBodyTest(WebTestCase):
+    def get_handlers(self):
+        @stream_request_body
+        class StreamingBodyHandler(RequestHandler):
+            def initialize(self, test):
+                self.test = test
+
+            def prepare(self):
+                self.test.prepared.set_result(None)
+
+            def data_received(self, data):
+                self.test.data.set_result(data)
+
+            def get(self):
+                self.test.finished.set_result(None)
+                self.write({})
+
+        @stream_request_body
+        class EarlyReturnHandler(RequestHandler):
+            def prepare(self):
+                # If we finish the response in prepare, it won't continue to
+                # the (non-existent) data_received.
+                raise HTTPError(401)
+
+        @stream_request_body
+        class CloseDetectionHandler(RequestHandler):
+            def initialize(self, test):
+                self.test = test
+
+            def on_connection_close(self):
+                super().on_connection_close()
+                self.test.close_future.set_result(None)
+
+        return [
+            ("/stream_body", StreamingBodyHandler, dict(test=self)),
+            ("/early_return", EarlyReturnHandler),
+            ("/close_detection", CloseDetectionHandler, dict(test=self)),
+        ]
+
+    def connect(self, url, connection_close):
+        # Use a raw connection so we can control the sending of data.
+        s = socket.socket(socket.AF_INET, socket.SOCK_STREAM, 0)
+        s.connect(("127.0.0.1", self.get_http_port()))
+        stream = IOStream(s)
+        stream.write(b"GET " + url + b" HTTP/1.1\r\nHost: 127.0.0.1\r\n")
+        if connection_close:
+            stream.write(b"Connection: close\r\n")
+        stream.write(b"Transfer-Encoding: chunked\r\n\r\n")
+        return stream
+
+    @gen_test
+    def test_streaming_body(self):
+        self.prepared = Future()  # type: Future[None]
+        self.data = Future()  # type: Future[bytes]
+        self.finished = Future()  # type: Future[None]
+
+        stream = self.connect(b"/stream_body", connection_close=True)
+        yield self.prepared
+        stream.write(b"4\r\nasdf\r\n")
+        # Ensure the first chunk is received before we send the second.
+        data = yield self.data
+        self.assertEqual(data, b"asdf")
+        self.data = Future()
+        stream.write(b"4\r\nqwer\r\n")
+        data = yield self.data
+        self.assertEqual(data, b"qwer")
+        stream.write(b"0\r\n\r\n")
+        yield self.finished
+        data = yield stream.read_until_close()
+        # This would ideally use an HTTP1Connection to read the response.
+        self.assertTrue(data.endswith(b"{}"))
+        stream.close()
+
+    @gen_test
+    def test_early_return(self):
+        stream = self.connect(b"/early_return", connection_close=False)
+        data = yield stream.read_until_close()
+        self.assertTrue(data.startswith(b"HTTP/1.1 401"))
+
+    @gen_test
+    def test_early_return_with_data(self):
+        stream = self.connect(b"/early_return", connection_close=False)
+        stream.write(b"4\r\nasdf\r\n")
+        data = yield stream.read_until_close()
+        self.assertTrue(data.startswith(b"HTTP/1.1 401"))
+
+    @gen_test
+    def test_close_during_upload(self):
+        self.close_future = Future()  # type: Future[None]
+        stream = self.connect(b"/close_detection", connection_close=False)
+        stream.close()
+        yield self.close_future
+
+
+# Each method in this handler returns a yieldable object and yields to the
+# IOLoop so the future is not immediately ready.  Ensure that the
+# yieldables are respected and no method is called before the previous
+# one has completed.
+@stream_request_body
+class BaseFlowControlHandler(RequestHandler):
+    def initialize(self, test):
+        self.test = test
+        self.method = None
+        self.methods = []  # type: typing.List[str]
+
+    @contextlib.contextmanager
+    def in_method(self, method):
+        if self.method is not None:
+            self.test.fail(f"entered method {method} while in {self.method}")
+        self.method = method
+        self.methods.append(method)
+        try:
+            yield
+        finally:
+            self.method = None
+
+    @gen.coroutine
+    def prepare(self):
+        # Note that asynchronous prepare() does not block data_received,
+        # so we don't use in_method here.
+        self.methods.append("prepare")
+        yield gen.moment
+
+    @gen.coroutine
+    def post(self):
+        with self.in_method("post"):
+            yield gen.moment
+        self.write(dict(methods=self.methods))
+
+
+class BaseStreamingRequestFlowControlTest:
+    def get_httpserver_options(self):
+        # Use a small chunk size so flow control is relevant even though
+        # all the data arrives at once.
+        return dict(chunk_size=10, decompress_request=True)
+
+    def get_http_client(self):
+        # simple_httpclient only: curl doesn't support body_producer.
+        return SimpleAsyncHTTPClient()
+
+    # Test all the slightly different code paths for fixed, chunked, etc bodies.
+    def test_flow_control_fixed_body(self: typing.Any):
+        response = self.fetch("/", body="abcdefghijklmnopqrstuvwxyz", method="POST")
+        response.rethrow()
+        self.assertEqual(
+            json_decode(response.body),
+            dict(
+                methods=[
+                    "prepare",
+                    "data_received",
+                    "data_received",
+                    "data_received",
+                    "post",
+                ]
+            ),
+        )
+
+    def test_flow_control_chunked_body(self: typing.Any):
+        chunks = [b"abcd", b"efgh", b"ijkl"]
+
+        @gen.coroutine
+        def body_producer(write):
+            for i in chunks:
+                yield write(i)
+
+        response = self.fetch("/", body_producer=body_producer, method="POST")
+        response.rethrow()
+        self.assertEqual(
+            json_decode(response.body),
+            dict(
+                methods=[
+                    "prepare",
+                    "data_received",
+                    "data_received",
+                    "data_received",
+                    "post",
+                ]
+            ),
+        )
+
+    def test_flow_control_compressed_body(self: typing.Any):
+        bytesio = BytesIO()
+        gzip_file = gzip.GzipFile(mode="w", fileobj=bytesio)
+        gzip_file.write(b"abcdefghijklmnopqrstuvwxyz")
+        gzip_file.close()
+        compressed_body = bytesio.getvalue()
+        response = self.fetch(
+            "/",
+            body=compressed_body,
+            method="POST",
+            headers={"Content-Encoding": "gzip"},
+        )
+        response.rethrow()
+        self.assertEqual(
+            json_decode(response.body),
+            dict(
+                methods=[
+                    "prepare",
+                    "data_received",
+                    "data_received",
+                    "data_received",
+                    "post",
+                ]
+            ),
+        )
+
+
+class DecoratedStreamingRequestFlowControlTest(
+    BaseStreamingRequestFlowControlTest, WebTestCase
+):
+    def get_handlers(self):
+        class DecoratedFlowControlHandler(BaseFlowControlHandler):
+            @gen.coroutine
+            def data_received(self, data):
+                with self.in_method("data_received"):
+                    yield gen.moment
+
+        return [("/", DecoratedFlowControlHandler, dict(test=self))]
+
+
+class NativeStreamingRequestFlowControlTest(
+    BaseStreamingRequestFlowControlTest, WebTestCase
+):
+    def get_handlers(self):
+        class NativeFlowControlHandler(BaseFlowControlHandler):
+            async def data_received(self, data):
+                with self.in_method("data_received"):
+                    import asyncio
+
+                    await asyncio.sleep(0)
+
+        return [("/", NativeFlowControlHandler, dict(test=self))]
+
+
+class IncorrectContentLengthTest(SimpleHandlerTestCase):
+    def get_handlers(self):
+        test = self
+        self.server_error = None
+
+        # Manually set a content-length that doesn't match the actual content.
+        class TooHigh(RequestHandler):
+            def get(self):
+                self.set_header("Content-Length", "42")
+                try:
+                    self.finish("ok")
+                except Exception as e:
+                    test.server_error = e
+                    raise
+
+        class TooLow(RequestHandler):
+            def get(self):
+                self.set_header("Content-Length", "2")
+                try:
+                    self.finish("hello")
+                except Exception as e:
+                    test.server_error = e
+                    raise
+
+        return [("/high", TooHigh), ("/low", TooLow)]
+
+    def test_content_length_too_high(self):
+        # When the content-length is too high, the connection is simply
+        # closed without completing the response.  An error is logged on
+        # the server.
+        with ExpectLog(app_log, "(Uncaught exception|Exception in callback)"):
+            with ExpectLog(
+                gen_log,
+                "(Cannot send error response after headers written"
+                "|Failed to flush partial response)",
+            ):
+                with self.assertRaises(HTTPClientError):
+                    self.fetch("/high", raise_error=True)
+        self.assertEqual(
+            str(self.server_error), "Tried to write 40 bytes less than Content-Length"
+        )
+
+    def test_content_length_too_low(self):
+        # When the content-length is too low, the connection is closed
+        # without writing the last chunk, so the client never sees the request
+        # complete (which would be a framing error).
+        with ExpectLog(app_log, "(Uncaught exception|Exception in callback)"):
+            with ExpectLog(
+                gen_log,
+                "(Cannot send error response after headers written"
+                "|Failed to flush partial response)",
+            ):
+                with self.assertRaises(HTTPClientError):
+                    self.fetch("/low", raise_error=True)
+        self.assertEqual(
+            str(self.server_error), "Tried to write more data than Content-Length"
+        )
+
+
+class ClientCloseTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            if self.request.version.startswith("HTTP/1"):
+                # Simulate a connection closed by the client during
+                # request processing.  The client will see an error, but the
+                # server should respond gracefully (without logging errors
+                # because we were unable to write out as many bytes as
+                # Content-Length said we would)
+                self.request.connection.stream.close()  # type: ignore
+                self.write("hello")
+            else:
+                # TODO: add a HTTP2-compatible version of this test.
+                self.write("requires HTTP/1.x")
+
+    def test_client_close(self):
+        with self.assertRaises((HTTPClientError, unittest.SkipTest)):  # type: ignore
+            response = self.fetch("/", raise_error=True)
+            if response.body == b"requires HTTP/1.x":
+                self.skipTest("requires HTTP/1.x")
+            self.assertEqual(response.code, 599)
+
+
+class SignedValueTest(unittest.TestCase):
+    SECRET = "It's a secret to everybody"
+    SECRET_DICT = {0: "asdfbasdf", 1: "12312312", 2: "2342342"}
+
+    def past(self):
+        return self.present() - 86400 * 32
+
+    def present(self):
+        return 1300000000
+
+    def test_known_values(self):
+        signed_v1 = create_signed_value(
+            SignedValueTest.SECRET, "key", "value", version=1, clock=self.present
+        )
+        self.assertEqual(
+            signed_v1, b"dmFsdWU=|1300000000|31c934969f53e48164c50768b40cbd7e2daaaa4f"
+        )
+
+        signed_v2 = create_signed_value(
+            SignedValueTest.SECRET, "key", "value", version=2, clock=self.present
+        )
+        self.assertEqual(
+            signed_v2,
+            b"2|1:0|10:1300000000|3:key|8:dmFsdWU=|"
+            b"3d4e60b996ff9c5d5788e333a0cba6f238a22c6c0f94788870e1a9ecd482e152",
+        )
+
+        signed_default = create_signed_value(
+            SignedValueTest.SECRET, "key", "value", clock=self.present
+        )
+        self.assertEqual(signed_default, signed_v2)
+
+        decoded_v1 = decode_signed_value(
+            SignedValueTest.SECRET, "key", signed_v1, min_version=1, clock=self.present
+        )
+        self.assertEqual(decoded_v1, b"value")
+
+        decoded_v2 = decode_signed_value(
+            SignedValueTest.SECRET, "key", signed_v2, min_version=2, clock=self.present
+        )
+        self.assertEqual(decoded_v2, b"value")
+
+    def test_name_swap(self):
+        signed1 = create_signed_value(
+            SignedValueTest.SECRET, "key1", "value", clock=self.present
+        )
+        signed2 = create_signed_value(
+            SignedValueTest.SECRET, "key2", "value", clock=self.present
+        )
+        # Try decoding each string with the other's "name"
+        decoded1 = decode_signed_value(
+            SignedValueTest.SECRET, "key2", signed1, clock=self.present
+        )
+        self.assertIsNone(decoded1)
+        decoded2 = decode_signed_value(
+            SignedValueTest.SECRET, "key1", signed2, clock=self.present
+        )
+        self.assertIsNone(decoded2)
+
+    def test_expired(self):
+        signed = create_signed_value(
+            SignedValueTest.SECRET, "key1", "value", clock=self.past
+        )
+        decoded_past = decode_signed_value(
+            SignedValueTest.SECRET, "key1", signed, clock=self.past
+        )
+        self.assertEqual(decoded_past, b"value")
+        decoded_present = decode_signed_value(
+            SignedValueTest.SECRET, "key1", signed, clock=self.present
+        )
+        self.assertIsNone(decoded_present)
+
+    def test_payload_tampering(self):
+        # These cookies are variants of the one in test_known_values.
+        sig = "3d4e60b996ff9c5d5788e333a0cba6f238a22c6c0f94788870e1a9ecd482e152"
+
+        def validate(prefix):
+            return b"value" == decode_signed_value(
+                SignedValueTest.SECRET, "key", prefix + sig, clock=self.present
+            )
+
+        self.assertTrue(validate("2|1:0|10:1300000000|3:key|8:dmFsdWU=|"))
+        # Change key version
+        self.assertFalse(validate("2|1:1|10:1300000000|3:key|8:dmFsdWU=|"))
+        # length mismatch (field too short)
+        self.assertFalse(validate("2|1:0|10:130000000|3:key|8:dmFsdWU=|"))
+        # length mismatch (field too long)
+        self.assertFalse(validate("2|1:0|10:1300000000|3:keey|8:dmFsdWU=|"))
+
+    def test_signature_tampering(self):
+        prefix = "2|1:0|10:1300000000|3:key|8:dmFsdWU=|"
+
+        def validate(sig):
+            return b"value" == decode_signed_value(
+                SignedValueTest.SECRET, "key", prefix + sig, clock=self.present
+            )
+
+        self.assertTrue(
+            validate("3d4e60b996ff9c5d5788e333a0cba6f238a22c6c0f94788870e1a9ecd482e152")
+        )
+        # All zeros
+        self.assertFalse(validate("0" * 32))
+        # Change one character
+        self.assertFalse(
+            validate("4d4e60b996ff9c5d5788e333a0cba6f238a22c6c0f94788870e1a9ecd482e152")
+        )
+        # Change another character
+        self.assertFalse(
+            validate("3d4e60b996ff9c5d5788e333a0cba6f238a22c6c0f94788870e1a9ecd482e153")
+        )
+        # Truncate
+        self.assertFalse(
+            validate("3d4e60b996ff9c5d5788e333a0cba6f238a22c6c0f94788870e1a9ecd482e15")
+        )
+        # Lengthen
+        self.assertFalse(
+            validate(
+                "3d4e60b996ff9c5d5788e333a0cba6f238a22c6c0f94788870e1a9ecd482e1538"
+            )
+        )
+
+    def test_non_ascii(self):
+        value = b"\xe9"
+        signed = create_signed_value(
+            SignedValueTest.SECRET, "key", value, clock=self.present
+        )
+        decoded = decode_signed_value(
+            SignedValueTest.SECRET, "key", signed, clock=self.present
+        )
+        self.assertEqual(value, decoded)
+
+    def test_key_versioning_read_write_default_key(self):
+        value = b"\xe9"
+        signed = create_signed_value(
+            SignedValueTest.SECRET_DICT, "key", value, clock=self.present, key_version=0
+        )
+        decoded = decode_signed_value(
+            SignedValueTest.SECRET_DICT, "key", signed, clock=self.present
+        )
+        self.assertEqual(value, decoded)
+
+    def test_key_versioning_read_write_non_default_key(self):
+        value = b"\xe9"
+        signed = create_signed_value(
+            SignedValueTest.SECRET_DICT, "key", value, clock=self.present, key_version=1
+        )
+        decoded = decode_signed_value(
+            SignedValueTest.SECRET_DICT, "key", signed, clock=self.present
+        )
+        self.assertEqual(value, decoded)
+
+    def test_key_versioning_invalid_key(self):
+        value = b"\xe9"
+        signed = create_signed_value(
+            SignedValueTest.SECRET_DICT, "key", value, clock=self.present, key_version=0
+        )
+        newkeys = SignedValueTest.SECRET_DICT.copy()
+        newkeys.pop(0)
+        decoded = decode_signed_value(newkeys, "key", signed, clock=self.present)
+        self.assertIsNone(decoded)
+
+    def test_key_version_retrieval(self):
+        value = b"\xe9"
+        signed = create_signed_value(
+            SignedValueTest.SECRET_DICT, "key", value, clock=self.present, key_version=1
+        )
+        key_version = get_signature_key_version(signed)
+        self.assertEqual(1, key_version)
+
+
+class XSRFTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            version = int(self.get_argument("version", "2"))
+            # This would be a bad idea in a real app, but in this test
+            # it's fine.
+            self.settings["xsrf_cookie_version"] = version
+            self.write(self.xsrf_token)
+
+        def post(self):
+            self.write("ok")
+
+    def get_app_kwargs(self):
+        return dict(xsrf_cookies=True)
+
+    def setUp(self):
+        super().setUp()
+        self.xsrf_token = self.get_token()
+
+    def get_token(self, old_token=None, version=None):
+        if old_token is not None:
+            headers = self.cookie_headers(old_token)
+        else:
+            headers = None
+        response = self.fetch(
+            "/" if version is None else ("/?version=%d" % version), headers=headers
+        )
+        response.rethrow()
+        return native_str(response.body)
+
+    def cookie_headers(self, token=None):
+        if token is None:
+            token = self.xsrf_token
+        return {"Cookie": "_xsrf=" + token}
+
+    def test_xsrf_fail_no_token(self):
+        with ExpectLog(gen_log, ".*'_xsrf' argument missing"):
+            response = self.fetch("/", method="POST", body=b"")
+        self.assertEqual(response.code, 403)
+
+    def test_xsrf_fail_body_no_cookie(self):
+        with ExpectLog(gen_log, ".*XSRF cookie does not match POST"):
+            response = self.fetch(
+                "/",
+                method="POST",
+                body=urllib.parse.urlencode(dict(_xsrf=self.xsrf_token)),
+            )
+        self.assertEqual(response.code, 403)
+
+    def test_xsrf_fail_argument_invalid_format(self):
+        with ExpectLog(gen_log, ".*'_xsrf' argument has invalid format"):
+            response = self.fetch(
+                "/",
+                method="POST",
+                headers=self.cookie_headers(),
+                body=urllib.parse.urlencode(dict(_xsrf="3|")),
+            )
+        self.assertEqual(response.code, 403)
+
+    def test_xsrf_fail_cookie_invalid_format(self):
+        with ExpectLog(gen_log, ".*XSRF cookie does not match POST"):
+            response = self.fetch(
+                "/",
+                method="POST",
+                headers=self.cookie_headers(token="3|"),
+                body=urllib.parse.urlencode(dict(_xsrf=self.xsrf_token)),
+            )
+        self.assertEqual(response.code, 403)
+
+    def test_xsrf_fail_cookie_no_body(self):
+        with ExpectLog(gen_log, ".*'_xsrf' argument missing"):
+            response = self.fetch(
+                "/", method="POST", body=b"", headers=self.cookie_headers()
+            )
+        self.assertEqual(response.code, 403)
+
+    def test_xsrf_success_short_token(self):
+        response = self.fetch(
+            "/",
+            method="POST",
+            body=urllib.parse.urlencode(dict(_xsrf="deadbeef")),
+            headers=self.cookie_headers(token="deadbeef"),
+        )
+        self.assertEqual(response.code, 200)
+
+    def test_xsrf_success_non_hex_token(self):
+        response = self.fetch(
+            "/",
+            method="POST",
+            body=urllib.parse.urlencode(dict(_xsrf="xoxo")),
+            headers=self.cookie_headers(token="xoxo"),
+        )
+        self.assertEqual(response.code, 200)
+
+    def test_xsrf_success_post_body(self):
+        response = self.fetch(
+            "/",
+            method="POST",
+            body=urllib.parse.urlencode(dict(_xsrf=self.xsrf_token)),
+            headers=self.cookie_headers(),
+        )
+        self.assertEqual(response.code, 200)
+
+    def test_xsrf_success_query_string(self):
+        response = self.fetch(
+            "/?" + urllib.parse.urlencode(dict(_xsrf=self.xsrf_token)),
+            method="POST",
+            body=b"",
+            headers=self.cookie_headers(),
+        )
+        self.assertEqual(response.code, 200)
+
+    def test_xsrf_success_header(self):
+        response = self.fetch(
+            "/",
+            method="POST",
+            body=b"",
+            headers=dict(
+                {"X-Xsrftoken": self.xsrf_token},  # type: ignore
+                **self.cookie_headers(),
+            ),
+        )
+        self.assertEqual(response.code, 200)
+
+    def test_distinct_tokens(self):
+        # Every request gets a distinct token.
+        NUM_TOKENS = 10
+        tokens = set()
+        for i in range(NUM_TOKENS):
+            tokens.add(self.get_token())
+        self.assertEqual(len(tokens), NUM_TOKENS)
+
+    def test_cross_user(self):
+        token2 = self.get_token()
+        # Each token can be used to authenticate its own request.
+        for token in (self.xsrf_token, token2):
+            response = self.fetch(
+                "/",
+                method="POST",
+                body=urllib.parse.urlencode(dict(_xsrf=token)),
+                headers=self.cookie_headers(token),
+            )
+            self.assertEqual(response.code, 200)
+        # Sending one in the cookie and the other in the body is not allowed.
+        for cookie_token, body_token in (
+            (self.xsrf_token, token2),
+            (token2, self.xsrf_token),
+        ):
+            with ExpectLog(gen_log, ".*XSRF cookie does not match POST"):
+                response = self.fetch(
+                    "/",
+                    method="POST",
+                    body=urllib.parse.urlencode(dict(_xsrf=body_token)),
+                    headers=self.cookie_headers(cookie_token),
+                )
+            self.assertEqual(response.code, 403)
+
+    def test_refresh_token(self):
+        token = self.xsrf_token
+        tokens_seen = {token}
+        # A user's token is stable over time.  Refreshing the page in one tab
+        # might update the cookie while an older tab still has the old cookie
+        # in its DOM.  Simulate this scenario by passing a constant token
+        # in the body and re-querying for the token.
+        for i in range(5):
+            token = self.get_token(token)
+            # Tokens are encoded uniquely each time
+            tokens_seen.add(token)
+            response = self.fetch(
+                "/",
+                method="POST",
+                body=urllib.parse.urlencode(dict(_xsrf=self.xsrf_token)),
+                headers=self.cookie_headers(token),
+            )
+            self.assertEqual(response.code, 200)
+        self.assertEqual(len(tokens_seen), 6)
+
+    def test_versioning(self):
+        # Version 1 still produces distinct tokens per request.
+        self.assertNotEqual(self.get_token(version=1), self.get_token(version=1))
+
+        # Refreshed v1 tokens are all identical.
+        v1_token = self.get_token(version=1)
+        for i in range(5):
+            self.assertEqual(self.get_token(v1_token, version=1), v1_token)
+
+        # Upgrade to a v2 version of the same token
+        v2_token = self.get_token(v1_token)
+        self.assertNotEqual(v1_token, v2_token)
+        # Each v1 token can map to many v2 tokens.
+        self.assertNotEqual(v2_token, self.get_token(v1_token))
+
+        # The tokens are cross-compatible.
+        for cookie_token, body_token in ((v1_token, v2_token), (v2_token, v1_token)):
+            response = self.fetch(
+                "/",
+                method="POST",
+                body=urllib.parse.urlencode(dict(_xsrf=body_token)),
+                headers=self.cookie_headers(cookie_token),
+            )
+            self.assertEqual(response.code, 200)
+
+
+# A subset of the previous test with a different cookie name
+class XSRFCookieNameTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            self.write(self.xsrf_token)
+
+        def post(self):
+            self.write("ok")
+
+    def get_app_kwargs(self):
+        return dict(
+            xsrf_cookies=True,
+            xsrf_cookie_name="__Host-xsrf",
+            xsrf_cookie_kwargs={"secure": True},
+        )
+
+    def setUp(self):
+        super().setUp()
+        self.xsrf_token = self.get_token()
+
+    def get_token(self, old_token=None):
+        if old_token is not None:
+            headers = self.cookie_headers(old_token)
+        else:
+            headers = None
+        response = self.fetch("/", headers=headers)
+        response.rethrow()
+        return native_str(response.body)
+
+    def cookie_headers(self, token=None):
+        if token is None:
+            token = self.xsrf_token
+        return {"Cookie": "__Host-xsrf=" + token}
+
+    def test_xsrf_fail_no_token(self):
+        with ExpectLog(gen_log, ".*'_xsrf' argument missing"):
+            response = self.fetch("/", method="POST", body=b"")
+        self.assertEqual(response.code, 403)
+
+    def test_xsrf_fail_body_no_cookie(self):
+        with ExpectLog(gen_log, ".*XSRF cookie does not match POST"):
+            response = self.fetch(
+                "/",
+                method="POST",
+                body=urllib.parse.urlencode(dict(_xsrf=self.xsrf_token)),
+            )
+        self.assertEqual(response.code, 403)
+
+    def test_xsrf_success_post_body(self):
+        response = self.fetch(
+            "/",
+            method="POST",
+            # Note that renaming the cookie doesn't rename the POST param
+            body=urllib.parse.urlencode(dict(_xsrf=self.xsrf_token)),
+            headers=self.cookie_headers(),
+        )
+        self.assertEqual(response.code, 200)
+
+
+class XSRFCookieKwargsTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            self.write(self.xsrf_token)
+
+    def get_app_kwargs(self):
+        return dict(
+            xsrf_cookies=True, xsrf_cookie_kwargs=dict(httponly=True, expires_days=2)
+        )
+
+    def test_xsrf_httponly(self):
+        response = self.fetch("/")
+        self.assertIn("httponly;", response.headers["Set-Cookie"].lower())
+        self.assertIn("expires=", response.headers["Set-Cookie"].lower())
+        header = response.headers.get("Set-Cookie")
+        assert header is not None
+        match = re.match(".*; expires=(?P.+);.*", header)
+        assert match is not None
+
+        expires = datetime.datetime.now(datetime.timezone.utc) + datetime.timedelta(
+            days=2
+        )
+        header_expires = email.utils.parsedate_to_datetime(match.groupdict()["expires"])
+        if header_expires.tzinfo is None:
+            header_expires = header_expires.replace(tzinfo=datetime.timezone.utc)
+        self.assertTrue(abs((expires - header_expires).total_seconds()) < 10)
+
+
+class FinishExceptionTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            self.set_status(401)
+            self.set_header("WWW-Authenticate", 'Basic realm="something"')
+            if self.get_argument("finish_value", ""):
+                raise Finish("authentication required")
+            else:
+                self.write("authentication required")
+                raise Finish()
+
+    def test_finish_exception(self):
+        for u in ["/", "/?finish_value=1"]:
+            response = self.fetch(u)
+            self.assertEqual(response.code, 401)
+            self.assertEqual(
+                'Basic realm="something"', response.headers.get("WWW-Authenticate")
+            )
+            self.assertEqual(b"authentication required", response.body)
+
+
+class DecoratorTest(WebTestCase):
+    def get_handlers(self):
+        class RemoveSlashHandler(RequestHandler):
+            @removeslash
+            def get(self):
+                pass
+
+        class AddSlashHandler(RequestHandler):
+            @addslash
+            def get(self):
+                pass
+
+        return [("/removeslash/", RemoveSlashHandler), ("/addslash", AddSlashHandler)]
+
+    def test_removeslash(self):
+        response = self.fetch("/removeslash/", follow_redirects=False)
+        self.assertEqual(response.code, 301)
+        self.assertEqual(response.headers["Location"], "/removeslash")
+
+        response = self.fetch("/removeslash/?foo=bar", follow_redirects=False)
+        self.assertEqual(response.code, 301)
+        self.assertEqual(response.headers["Location"], "/removeslash?foo=bar")
+
+    def test_addslash(self):
+        response = self.fetch("/addslash", follow_redirects=False)
+        self.assertEqual(response.code, 301)
+        self.assertEqual(response.headers["Location"], "/addslash/")
+
+        response = self.fetch("/addslash?foo=bar", follow_redirects=False)
+        self.assertEqual(response.code, 301)
+        self.assertEqual(response.headers["Location"], "/addslash/?foo=bar")
+
+
+class CacheTest(WebTestCase):
+    def get_handlers(self):
+        class EtagHandler(RequestHandler):
+            def get(self, computed_etag):
+                self.write(computed_etag)
+
+            def compute_etag(self):
+                return self._write_buffer[0]
+
+        return [("/etag/(.*)", EtagHandler)]
+
+    def test_wildcard_etag(self):
+        computed_etag = '"xyzzy"'
+        etags = "*"
+        self._test_etag(computed_etag, etags, 304)
+
+    def test_strong_etag_match(self):
+        computed_etag = '"xyzzy"'
+        etags = '"xyzzy"'
+        self._test_etag(computed_etag, etags, 304)
+
+    def test_multiple_strong_etag_match(self):
+        computed_etag = '"xyzzy1"'
+        etags = '"xyzzy1", "xyzzy2"'
+        self._test_etag(computed_etag, etags, 304)
+
+    def test_strong_etag_not_match(self):
+        computed_etag = '"xyzzy"'
+        etags = '"xyzzy1"'
+        self._test_etag(computed_etag, etags, 200)
+
+    def test_multiple_strong_etag_not_match(self):
+        computed_etag = '"xyzzy"'
+        etags = '"xyzzy1", "xyzzy2"'
+        self._test_etag(computed_etag, etags, 200)
+
+    def test_weak_etag_match(self):
+        computed_etag = '"xyzzy1"'
+        etags = 'W/"xyzzy1"'
+        self._test_etag(computed_etag, etags, 304)
+
+    def test_multiple_weak_etag_match(self):
+        computed_etag = '"xyzzy2"'
+        etags = 'W/"xyzzy1", W/"xyzzy2"'
+        self._test_etag(computed_etag, etags, 304)
+
+    def test_weak_etag_not_match(self):
+        computed_etag = '"xyzzy2"'
+        etags = 'W/"xyzzy1"'
+        self._test_etag(computed_etag, etags, 200)
+
+    def test_multiple_weak_etag_not_match(self):
+        computed_etag = '"xyzzy3"'
+        etags = 'W/"xyzzy1", W/"xyzzy2"'
+        self._test_etag(computed_etag, etags, 200)
+
+    def _test_etag(self, computed_etag, etags, status_code):
+        response = self.fetch(
+            "/etag/" + computed_etag, headers={"If-None-Match": etags}
+        )
+        self.assertEqual(response.code, status_code)
+
+
+class RequestSummaryTest(SimpleHandlerTestCase):
+    class Handler(RequestHandler):
+        def get(self):
+            # remote_ip is optional, although it's set by
+            # both HTTPServer and WSGIAdapter.
+            # Clobber it to make sure it doesn't break logging.
+            self.request.remote_ip = None
+            self.finish(self._request_summary())
+
+    def test_missing_remote_ip(self):
+        resp = self.fetch("/")
+        self.assertEqual(resp.body, b"GET / (None)")
+
+
+class HTTPErrorTest(unittest.TestCase):
+    def test_copy(self):
+        e = HTTPError(403, reason="Go away")
+        e2 = copy.copy(e)
+        self.assertIsNot(e, e2)
+        self.assertEqual(e.status_code, e2.status_code)
+        self.assertEqual(e.reason, e2.reason)
+
+
+class ApplicationTest(AsyncTestCase):
+    def test_listen(self):
+        app = Application([])
+        server = app.listen(0, address="127.0.0.1")
+        server.stop()
+
+
+class URLSpecReverseTest(unittest.TestCase):
+    def test_reverse(self):
+        self.assertEqual("/favicon.ico", url(r"/favicon\.ico", None).reverse())
+        self.assertEqual("/favicon.ico", url(r"^/favicon\.ico$", None).reverse())
+
+    def test_non_reversible(self):
+        # URLSpecs are non-reversible if they include non-constant
+        # regex features outside capturing groups. Currently, this is
+        # only strictly enforced for backslash-escaped character
+        # classes.
+        paths = [r"^/api/v\d+/foo/(\w+)$"]
+        for path in paths:
+            # A URLSpec can still be created even if it cannot be reversed.
+            url_spec = url(path, None)
+            try:
+                result = url_spec.reverse()
+                self.fail(
+                    "did not get expected exception when reversing %s. "
+                    "result: %s" % (path, result)
+                )
+            except ValueError:
+                pass
+
+    def test_reverse_arguments(self):
+        self.assertEqual(
+            "/api/v1/foo/bar", url(r"^/api/v1/foo/(\w+)$", None).reverse("bar")
+        )
+        self.assertEqual(
+            "/api.v1/foo/5/icon.png",
+            url(r"/api\.v1/foo/([0-9]+)/icon\.png", None).reverse(5),
+        )
+
+
+class RedirectHandlerTest(WebTestCase):
+    def get_handlers(self):
+        return [
+            ("/src", WebRedirectHandler, {"url": "/dst"}),
+            ("/src2", WebRedirectHandler, {"url": "/dst2?foo=bar"}),
+            (r"/(.*?)/(.*?)/(.*)", WebRedirectHandler, {"url": "/{1}/{0}/{2}"}),
+        ]
+
+    def test_basic_redirect(self):
+        response = self.fetch("/src", follow_redirects=False)
+        self.assertEqual(response.code, 301)
+        self.assertEqual(response.headers["Location"], "/dst")
+
+    def test_redirect_with_argument(self):
+        response = self.fetch("/src?foo=bar", follow_redirects=False)
+        self.assertEqual(response.code, 301)
+        self.assertEqual(response.headers["Location"], "/dst?foo=bar")
+
+    def test_redirect_with_appending_argument(self):
+        response = self.fetch("/src2?foo2=bar2", follow_redirects=False)
+        self.assertEqual(response.code, 301)
+        self.assertEqual(response.headers["Location"], "/dst2?foo=bar&foo2=bar2")
+
+    def test_redirect_pattern(self):
+        response = self.fetch("/a/b/c", follow_redirects=False)
+        self.assertEqual(response.code, 301)
+        self.assertEqual(response.headers["Location"], "/b/a/c")
+
+
+class AcceptLanguageTest(WebTestCase):
+    """Test evaluation of Accept-Language header"""
+
+    def get_handlers(self):
+        locale.load_gettext_translations(
+            os.path.join(os.path.dirname(__file__), "gettext_translations"),
+            "tornado_test",
+        )
+
+        class AcceptLanguageHandler(RequestHandler):
+            def get(self):
+                self.set_header(
+                    "Content-Language", self.get_browser_locale().code.replace("_", "-")
+                )
+                self.finish(b"")
+
+        return [
+            ("/", AcceptLanguageHandler),
+        ]
+
+    def test_accept_language(self):
+        response = self.fetch("/", headers={"Accept-Language": "fr-FR;q=0.9"})
+        self.assertEqual(response.headers["Content-Language"], "fr-FR")
+
+        response = self.fetch("/", headers={"Accept-Language": "fr-FR; q=0.9"})
+        self.assertEqual(response.headers["Content-Language"], "fr-FR")
+
+    def test_accept_language_ignore(self):
+        response = self.fetch("/", headers={"Accept-Language": "fr-FR;q=0"})
+        self.assertEqual(response.headers["Content-Language"], "en-US")
+
+    def test_accept_language_invalid(self):
+        response = self.fetch("/", headers={"Accept-Language": "fr-FR;q=-1"})
+        self.assertEqual(response.headers["Content-Language"], "en-US")
diff --git a/env/lib/python3.12/site-packages/tornado/test/websocket_test.py b/env/lib/python3.12/site-packages/tornado/test/websocket_test.py
new file mode 100644
index 0000000..494c4bf
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tornado/test/websocket_test.py
@@ -0,0 +1,989 @@
+import asyncio
+import contextlib
+import datetime
+import functools
+import socket
+import traceback
+import typing
+import unittest
+
+from tornado.concurrent import Future
+from tornado import gen
+from tornado.httpclient import HTTPError, HTTPRequest
+from tornado.locks import Event
+from tornado.log import gen_log, app_log
+from tornado.netutil import Resolver
+from tornado.simple_httpclient import SimpleAsyncHTTPClient
+from tornado.template import DictLoader
+from tornado.test.util import abstract_base_test, ignore_deprecation
+from tornado.testing import AsyncHTTPTestCase, gen_test, bind_unused_port, ExpectLog
+from tornado.web import Application, RequestHandler
+
+try:
+    import tornado.websocket  # noqa: F401
+    from tornado.util import _websocket_mask_python
+except ImportError:
+    # The unittest module presents misleading errors on ImportError
+    # (it acts as if websocket_test could not be found, hiding the underlying
+    # error).  If we get an ImportError here (which could happen due to
+    # TORNADO_EXTENSION=1), print some extra information before failing.
+    traceback.print_exc()
+    raise
+
+from tornado.websocket import (
+    WebSocketHandler,
+    websocket_connect,
+    WebSocketError,
+    WebSocketClosedError,
+)
+
+try:
+    from tornado import speedups
+except ImportError:
+    speedups = None  # type: ignore
+
+
+class TestWebSocketHandler(WebSocketHandler):
+    """Base class for testing handlers that exposes the on_close event.
+
+    This allows for tests to see the close code and reason on the
+    server side.
+
+    """
+
+    def initialize(self, close_future=None, compression_options=None):
+        self.close_future = close_future
+        self.compression_options = compression_options
+
+    def get_compression_options(self):
+        return self.compression_options
+
+    def on_close(self):
+        if self.close_future is not None:
+            self.close_future.set_result((self.close_code, self.close_reason))
+
+
+class EchoHandler(TestWebSocketHandler):
+    @gen.coroutine
+    def on_message(self, message):
+        try:
+            yield self.write_message(message, isinstance(message, bytes))
+        except asyncio.CancelledError:
+            pass
+        except WebSocketClosedError:
+            pass
+
+
+class ErrorInOnMessageHandler(TestWebSocketHandler):
+    def on_message(self, message):
+        1 / 0
+
+
+class HeaderHandler(TestWebSocketHandler):
+    def open(self):
+        methods_to_test = [
+            functools.partial(self.write, "This should not work"),
+            functools.partial(self.redirect, "http://localhost/elsewhere"),
+            functools.partial(self.set_header, "X-Test", ""),
+            functools.partial(self.set_cookie, "Chocolate", "Chip"),
+            functools.partial(self.set_status, 503),
+            self.flush,
+            self.finish,
+        ]
+        for method in methods_to_test:
+            try:
+                # In a websocket context, many RequestHandler methods
+                # raise RuntimeErrors.
+                method()  # type: ignore
+                raise Exception("did not get expected exception")
+            except RuntimeError:
+                pass
+        self.write_message(self.request.headers.get("X-Test", ""))
+
+
+class HeaderEchoHandler(TestWebSocketHandler):
+    def set_default_headers(self):
+        self.set_header("X-Extra-Response-Header", "Extra-Response-Value")
+
+    def prepare(self):
+        for k, v in self.request.headers.get_all():
+            if k.lower().startswith("x-test"):
+                self.set_header(k, v)
+
+
+class NonWebSocketHandler(RequestHandler):
+    def get(self):
+        self.write("ok")
+
+
+class RedirectHandler(RequestHandler):
+    def get(self):
+        self.redirect("/echo")
+
+
+class CloseReasonHandler(TestWebSocketHandler):
+    def open(self):
+        self.on_close_called = False
+        self.close(1001, "goodbye")
+
+
+class AsyncPrepareHandler(TestWebSocketHandler):
+    @gen.coroutine
+    def prepare(self):
+        yield gen.moment
+
+    def on_message(self, message):
+        self.write_message(message)
+
+
+class PathArgsHandler(TestWebSocketHandler):
+    def open(self, arg):
+        self.write_message(arg)
+
+
+class CoroutineOnMessageHandler(TestWebSocketHandler):
+    def initialize(self, **kwargs):
+        super().initialize(**kwargs)
+        self.sleeping = 0
+
+    @gen.coroutine
+    def on_message(self, message):
+        if self.sleeping > 0:
+            self.write_message("another coroutine is already sleeping")
+        self.sleeping += 1
+        yield gen.sleep(0.01)
+        self.sleeping -= 1
+        self.write_message(message)
+
+
+class RenderMessageHandler(TestWebSocketHandler):
+    def on_message(self, message):
+        self.write_message(self.render_string("message.html", message=message))
+
+
+class SubprotocolHandler(TestWebSocketHandler):
+    def initialize(self, **kwargs):
+        super().initialize(**kwargs)
+        self.select_subprotocol_called = False
+
+    def select_subprotocol(self, subprotocols):
+        if self.select_subprotocol_called:
+            raise Exception("select_subprotocol called twice")
+        self.select_subprotocol_called = True
+        if "goodproto" in subprotocols:
+            return "goodproto"
+        return None
+
+    def open(self):
+        if not self.select_subprotocol_called:
+            raise Exception("select_subprotocol not called")
+        self.write_message("subprotocol=%s" % self.selected_subprotocol)
+
+
+class OpenCoroutineHandler(TestWebSocketHandler):
+    def initialize(self, test, **kwargs):
+        super().initialize(**kwargs)
+        self.test = test
+        self.open_finished = False
+
+    @gen.coroutine
+    def open(self):
+        yield self.test.message_sent.wait()
+        yield gen.sleep(0.010)
+        self.open_finished = True
+
+    def on_message(self, message):
+        if not self.open_finished:
+            raise Exception("on_message called before open finished")
+        self.write_message("ok")
+
+
+class ErrorInOpenHandler(TestWebSocketHandler):
+    def open(self):
+        raise Exception("boom")
+
+
+class ErrorInAsyncOpenHandler(TestWebSocketHandler):
+    async def open(self):
+        await asyncio.sleep(0)
+        raise Exception("boom")
+
+
+class NoDelayHandler(TestWebSocketHandler):
+    def open(self):
+        self.set_nodelay(True)
+        self.write_message("hello")
+
+
+class WebSocketBaseTestCase(AsyncHTTPTestCase):
+    def setUp(self):
+        super().setUp()
+        self.conns_to_close = []
+
+    def tearDown(self):
+        for conn in self.conns_to_close:
+            conn.close()
+        super().tearDown()
+
+    @gen.coroutine
+    def ws_connect(self, path, **kwargs):
+        ws = yield websocket_connect(
+            "ws://127.0.0.1:%d%s" % (self.get_http_port(), path), **kwargs
+        )
+        self.conns_to_close.append(ws)
+        raise gen.Return(ws)
+
+
+class WebSocketTest(WebSocketBaseTestCase):
+    def get_app(self):
+        self.close_future = Future()  # type: Future[None]
+        return Application(
+            [
+                ("/echo", EchoHandler, dict(close_future=self.close_future)),
+                ("/non_ws", NonWebSocketHandler),
+                ("/redirect", RedirectHandler),
+                ("/header", HeaderHandler, dict(close_future=self.close_future)),
+                (
+                    "/header_echo",
+                    HeaderEchoHandler,
+                    dict(close_future=self.close_future),
+                ),
+                (
+                    "/close_reason",
+                    CloseReasonHandler,
+                    dict(close_future=self.close_future),
+                ),
+                (
+                    "/error_in_on_message",
+                    ErrorInOnMessageHandler,
+                    dict(close_future=self.close_future),
+                ),
+                (
+                    "/async_prepare",
+                    AsyncPrepareHandler,
+                    dict(close_future=self.close_future),
+                ),
+                (
+                    "/path_args/(.*)",
+                    PathArgsHandler,
+                    dict(close_future=self.close_future),
+                ),
+                (
+                    "/coroutine",
+                    CoroutineOnMessageHandler,
+                    dict(close_future=self.close_future),
+                ),
+                ("/render", RenderMessageHandler, dict(close_future=self.close_future)),
+                (
+                    "/subprotocol",
+                    SubprotocolHandler,
+                    dict(close_future=self.close_future),
+                ),
+                (
+                    "/open_coroutine",
+                    OpenCoroutineHandler,
+                    dict(close_future=self.close_future, test=self),
+                ),
+                ("/error_in_open", ErrorInOpenHandler),
+                ("/error_in_async_open", ErrorInAsyncOpenHandler),
+                ("/nodelay", NoDelayHandler),
+            ],
+            template_loader=DictLoader({"message.html": "{{ message }}"}),
+        )
+
+    def get_http_client(self):
+        # These tests require HTTP/1; force the use of SimpleAsyncHTTPClient.
+        return SimpleAsyncHTTPClient()
+
+    def tearDown(self):
+        super().tearDown()
+        RequestHandler._template_loaders.clear()
+
+    def test_http_request(self):
+        # WS server, HTTP client.
+        response = self.fetch("/echo")
+        self.assertEqual(response.code, 400)
+
+    def test_missing_websocket_key(self):
+        response = self.fetch(
+            "/echo",
+            headers={
+                "Connection": "Upgrade",
+                "Upgrade": "WebSocket",
+                "Sec-WebSocket-Version": "13",
+            },
+        )
+        self.assertEqual(response.code, 400)
+
+    def test_bad_websocket_version(self):
+        response = self.fetch(
+            "/echo",
+            headers={
+                "Connection": "Upgrade",
+                "Upgrade": "WebSocket",
+                "Sec-WebSocket-Version": "12",
+            },
+        )
+        self.assertEqual(response.code, 426)
+
+    @gen_test
+    def test_websocket_gen(self):
+        ws = yield self.ws_connect("/echo")
+        yield ws.write_message("hello")
+        response = yield ws.read_message()
+        self.assertEqual(response, "hello")
+
+    def test_websocket_callbacks(self):
+        with ignore_deprecation():
+            websocket_connect(
+                "ws://127.0.0.1:%d/echo" % self.get_http_port(), callback=self.stop
+            )
+        ws = self.wait().result()
+        ws.write_message("hello")
+        ws.read_message(self.stop)
+        response = self.wait().result()
+        self.assertEqual(response, "hello")
+        self.close_future.add_done_callback(lambda f: self.stop())
+        ws.close()
+        self.wait()
+
+    @gen_test
+    def test_binary_message(self):
+        ws = yield self.ws_connect("/echo")
+        ws.write_message(b"hello \xe9", binary=True)
+        response = yield ws.read_message()
+        self.assertEqual(response, b"hello \xe9")
+
+    @gen_test
+    def test_unicode_message(self):
+        ws = yield self.ws_connect("/echo")
+        ws.write_message("hello \u00e9")
+        response = yield ws.read_message()
+        self.assertEqual(response, "hello \u00e9")
+
+    @gen_test
+    def test_error_in_closed_client_write_message(self):
+        ws = yield self.ws_connect("/echo")
+        ws.close()
+        with self.assertRaises(WebSocketClosedError):
+            ws.write_message("hello \u00e9")
+
+    @gen_test
+    def test_render_message(self):
+        ws = yield self.ws_connect("/render")
+        ws.write_message("hello")
+        response = yield ws.read_message()
+        self.assertEqual(response, "hello")
+
+    @gen_test
+    def test_error_in_on_message(self):
+        ws = yield self.ws_connect("/error_in_on_message")
+        ws.write_message("hello")
+        with ExpectLog(app_log, "Uncaught exception"):
+            response = yield ws.read_message()
+        self.assertIsNone(response)
+
+    @gen_test
+    def test_websocket_http_fail(self):
+        with self.assertRaises(HTTPError) as cm:
+            yield self.ws_connect("/notfound")
+        self.assertEqual(cm.exception.code, 404)
+
+    @gen_test
+    def test_websocket_http_success(self):
+        with self.assertRaises(WebSocketError):
+            yield self.ws_connect("/non_ws")
+
+    @gen_test
+    def test_websocket_http_redirect(self):
+        with self.assertRaises(HTTPError):
+            yield self.ws_connect("/redirect")
+
+    @gen_test
+    def test_websocket_network_fail(self):
+        sock, port = bind_unused_port()
+        sock.close()
+        with self.assertRaises(IOError):
+            with ExpectLog(gen_log, ".*", required=False):
+                yield websocket_connect(
+                    "ws://127.0.0.1:%d/" % port, connect_timeout=3600
+                )
+
+    @gen_test
+    def test_websocket_close_buffered_data(self):
+        with contextlib.closing(
+            (yield websocket_connect("ws://127.0.0.1:%d/echo" % self.get_http_port()))
+        ) as ws:
+            ws.write_message("hello")
+            ws.write_message("world")
+            # Close the underlying stream.
+            ws.stream.close()
+
+    @gen_test
+    def test_websocket_headers(self):
+        # Ensure that arbitrary headers can be passed through websocket_connect.
+        with contextlib.closing(
+            (
+                yield websocket_connect(
+                    HTTPRequest(
+                        "ws://127.0.0.1:%d/header" % self.get_http_port(),
+                        headers={"X-Test": "hello"},
+                    )
+                )
+            )
+        ) as ws:
+            response = yield ws.read_message()
+            self.assertEqual(response, "hello")
+
+    @gen_test
+    def test_websocket_header_echo(self):
+        # Ensure that headers can be returned in the response.
+        # Specifically, that arbitrary headers passed through websocket_connect
+        # can be returned.
+        with contextlib.closing(
+            (
+                yield websocket_connect(
+                    HTTPRequest(
+                        "ws://127.0.0.1:%d/header_echo" % self.get_http_port(),
+                        headers={"X-Test-Hello": "hello"},
+                    )
+                )
+            )
+        ) as ws:
+            self.assertEqual(ws.headers.get("X-Test-Hello"), "hello")
+            self.assertEqual(
+                ws.headers.get("X-Extra-Response-Header"), "Extra-Response-Value"
+            )
+
+    @gen_test
+    def test_server_close_reason(self):
+        ws = yield self.ws_connect("/close_reason")
+        msg = yield ws.read_message()
+        # A message of None means the other side closed the connection.
+        self.assertIs(msg, None)
+        self.assertEqual(ws.close_code, 1001)
+        self.assertEqual(ws.close_reason, "goodbye")
+        # The on_close callback is called no matter which side closed.
+        code, reason = yield self.close_future
+        # The client echoed the close code it received to the server,
+        # so the server's close code (returned via close_future) is
+        # the same.
+        self.assertEqual(code, 1001)
+
+    @gen_test
+    def test_client_close_reason(self):
+        ws = yield self.ws_connect("/echo")
+        ws.close(1001, "goodbye")
+        code, reason = yield self.close_future
+        self.assertEqual(code, 1001)
+        self.assertEqual(reason, "goodbye")
+
+    @gen_test
+    def test_write_after_close(self):
+        ws = yield self.ws_connect("/close_reason")
+        msg = yield ws.read_message()
+        self.assertIs(msg, None)
+        with self.assertRaises(WebSocketClosedError):
+            ws.write_message("hello")
+
+    @gen_test
+    def test_async_prepare(self):
+        # Previously, an async prepare method triggered a bug that would
+        # result in a timeout on test shutdown (and a memory leak).
+        ws = yield self.ws_connect("/async_prepare")
+        ws.write_message("hello")
+        res = yield ws.read_message()
+        self.assertEqual(res, "hello")
+
+    @gen_test
+    def test_path_args(self):
+        ws = yield self.ws_connect("/path_args/hello")
+        res = yield ws.read_message()
+        self.assertEqual(res, "hello")
+
+    @gen_test
+    def test_coroutine(self):
+        ws = yield self.ws_connect("/coroutine")
+        # Send both messages immediately, coroutine must process one at a time.
+        yield ws.write_message("hello1")
+        yield ws.write_message("hello2")
+        res = yield ws.read_message()
+        self.assertEqual(res, "hello1")
+        res = yield ws.read_message()
+        self.assertEqual(res, "hello2")
+
+    @gen_test
+    def test_check_origin_valid_no_path(self):
+        port = self.get_http_port()
+
+        url = "ws://127.0.0.1:%d/echo" % port
+        headers = {"Origin": "http://127.0.0.1:%d" % port}
+
+        with contextlib.closing(
+            (yield websocket_connect(HTTPRequest(url, headers=headers)))
+        ) as ws:
+            ws.write_message("hello")
+            response = yield ws.read_message()
+            self.assertEqual(response, "hello")
+
+    @gen_test
+    def test_check_origin_valid_with_path(self):
+        port = self.get_http_port()
+
+        url = "ws://127.0.0.1:%d/echo" % port
+        headers = {"Origin": "http://127.0.0.1:%d/something" % port}
+
+        with contextlib.closing(
+            (yield websocket_connect(HTTPRequest(url, headers=headers)))
+        ) as ws:
+            ws.write_message("hello")
+            response = yield ws.read_message()
+            self.assertEqual(response, "hello")
+
+    @gen_test
+    def test_check_origin_invalid_partial_url(self):
+        port = self.get_http_port()
+
+        url = "ws://127.0.0.1:%d/echo" % port
+        headers = {"Origin": "127.0.0.1:%d" % port}
+
+        with self.assertRaises(HTTPError) as cm:
+            yield websocket_connect(HTTPRequest(url, headers=headers))
+        self.assertEqual(cm.exception.code, 403)
+
+    @gen_test
+    def test_check_origin_invalid(self):
+        port = self.get_http_port()
+
+        url = "ws://127.0.0.1:%d/echo" % port
+        # Host is 127.0.0.1, which should not be accessible from some other
+        # domain
+        headers = {"Origin": "http://somewhereelse.com"}
+
+        with self.assertRaises(HTTPError) as cm:
+            yield websocket_connect(HTTPRequest(url, headers=headers))
+
+        self.assertEqual(cm.exception.code, 403)
+
+    @gen_test
+    def test_check_origin_invalid_subdomains(self):
+        port = self.get_http_port()
+
+        # CaresResolver may return ipv6-only results for localhost, but our
+        # server is only running on ipv4. Test for this edge case and skip
+        # the test if it happens.
+        addrinfo = yield Resolver().resolve("localhost", port)
+        families = {addr[0] for addr in addrinfo}
+        if socket.AF_INET not in families:
+            self.skipTest("localhost does not resolve to ipv4")
+            return
+
+        url = "ws://localhost:%d/echo" % port
+        # Subdomains should be disallowed by default.  If we could pass a
+        # resolver to websocket_connect we could test sibling domains as well.
+        headers = {"Origin": "http://subtenant.localhost"}
+
+        with self.assertRaises(HTTPError) as cm:
+            yield websocket_connect(HTTPRequest(url, headers=headers))
+
+        self.assertEqual(cm.exception.code, 403)
+
+    @gen_test
+    def test_subprotocols(self):
+        ws = yield self.ws_connect(
+            "/subprotocol", subprotocols=["badproto", "goodproto"]
+        )
+        self.assertEqual(ws.selected_subprotocol, "goodproto")
+        res = yield ws.read_message()
+        self.assertEqual(res, "subprotocol=goodproto")
+
+    @gen_test
+    def test_subprotocols_not_offered(self):
+        ws = yield self.ws_connect("/subprotocol")
+        self.assertIs(ws.selected_subprotocol, None)
+        res = yield ws.read_message()
+        self.assertEqual(res, "subprotocol=None")
+
+    @gen_test
+    def test_open_coroutine(self):
+        self.message_sent = Event()
+        ws = yield self.ws_connect("/open_coroutine")
+        yield ws.write_message("hello")
+        self.message_sent.set()
+        res = yield ws.read_message()
+        self.assertEqual(res, "ok")
+
+    @gen_test
+    def test_error_in_open(self):
+        with ExpectLog(app_log, "Uncaught exception"):
+            ws = yield self.ws_connect("/error_in_open")
+            res = yield ws.read_message()
+        self.assertIsNone(res)
+
+    @gen_test
+    def test_error_in_async_open(self):
+        with ExpectLog(app_log, "Uncaught exception"):
+            ws = yield self.ws_connect("/error_in_async_open")
+            res = yield ws.read_message()
+        self.assertIsNone(res)
+
+    @gen_test
+    def test_nodelay(self):
+        ws = yield self.ws_connect("/nodelay")
+        res = yield ws.read_message()
+        self.assertEqual(res, "hello")
+
+
+class NativeCoroutineOnMessageHandler(TestWebSocketHandler):
+    def initialize(self, **kwargs):
+        super().initialize(**kwargs)
+        self.sleeping = 0
+
+    async def on_message(self, message):
+        if self.sleeping > 0:
+            self.write_message("another coroutine is already sleeping")
+        self.sleeping += 1
+        await gen.sleep(0.01)
+        self.sleeping -= 1
+        self.write_message(message)
+
+
+class WebSocketNativeCoroutineTest(WebSocketBaseTestCase):
+    def get_app(self):
+        return Application([("/native", NativeCoroutineOnMessageHandler)])
+
+    @gen_test
+    def test_native_coroutine(self):
+        ws = yield self.ws_connect("/native")
+        # Send both messages immediately, coroutine must process one at a time.
+        yield ws.write_message("hello1")
+        yield ws.write_message("hello2")
+        res = yield ws.read_message()
+        self.assertEqual(res, "hello1")
+        res = yield ws.read_message()
+        self.assertEqual(res, "hello2")
+
+
+@abstract_base_test
+class CompressionTestMixin(WebSocketBaseTestCase):
+    MESSAGE = "Hello world. Testing 123 123"
+
+    def get_app(self):
+        class LimitedHandler(TestWebSocketHandler):
+            @property
+            def max_message_size(self):
+                return 1024
+
+            def on_message(self, message):
+                self.write_message(str(len(message)))
+
+        return Application(
+            [
+                (
+                    "/echo",
+                    EchoHandler,
+                    dict(compression_options=self.get_server_compression_options()),
+                ),
+                (
+                    "/limited",
+                    LimitedHandler,
+                    dict(compression_options=self.get_server_compression_options()),
+                ),
+            ]
+        )
+
+    def get_server_compression_options(self):
+        return None
+
+    def get_client_compression_options(self):
+        return None
+
+    def verify_wire_bytes(self, bytes_in: int, bytes_out: int) -> None:
+        raise NotImplementedError()
+
+    @gen_test
+    def test_message_sizes(self):
+        ws = yield self.ws_connect(
+            "/echo", compression_options=self.get_client_compression_options()
+        )
+        # Send the same message three times so we can measure the
+        # effect of the context_takeover options.
+        for i in range(3):
+            ws.write_message(self.MESSAGE)
+            response = yield ws.read_message()
+            self.assertEqual(response, self.MESSAGE)
+        self.assertEqual(ws.protocol._message_bytes_out, len(self.MESSAGE) * 3)
+        self.assertEqual(ws.protocol._message_bytes_in, len(self.MESSAGE) * 3)
+        self.verify_wire_bytes(ws.protocol._wire_bytes_in, ws.protocol._wire_bytes_out)
+
+    @gen_test
+    def test_size_limit(self):
+        ws = yield self.ws_connect(
+            "/limited", compression_options=self.get_client_compression_options()
+        )
+        # Small messages pass through.
+        ws.write_message("a" * 128)
+        response = yield ws.read_message()
+        self.assertEqual(response, "128")
+        # This message is too big after decompression, but it compresses
+        # down to a size that will pass the initial checks.
+        ws.write_message("a" * 2048)
+        response = yield ws.read_message()
+        self.assertIsNone(response)
+
+
+@abstract_base_test
+class UncompressedTestMixin(CompressionTestMixin):
+    """Specialization of CompressionTestMixin when we expect no compression."""
+
+    def verify_wire_bytes(self, bytes_in, bytes_out):
+        # Bytes out includes the 4-byte mask key per message.
+        self.assertEqual(bytes_out, 3 * (len(self.MESSAGE) + 6))
+        self.assertEqual(bytes_in, 3 * (len(self.MESSAGE) + 2))
+
+
+class NoCompressionTest(UncompressedTestMixin):
+    pass
+
+
+# If only one side tries to compress, the extension is not negotiated.
+class ServerOnlyCompressionTest(UncompressedTestMixin):
+    def get_server_compression_options(self):
+        return {}
+
+
+class ClientOnlyCompressionTest(UncompressedTestMixin):
+    def get_client_compression_options(self):
+        return {}
+
+
+class DefaultCompressionTest(CompressionTestMixin):
+    def get_server_compression_options(self):
+        return {}
+
+    def get_client_compression_options(self):
+        return {}
+
+    def verify_wire_bytes(self, bytes_in, bytes_out):
+        self.assertLess(bytes_out, 3 * (len(self.MESSAGE) + 6))
+        self.assertLess(bytes_in, 3 * (len(self.MESSAGE) + 2))
+        # Bytes out includes the 4 bytes mask key per message.
+        self.assertEqual(bytes_out, bytes_in + 12)
+
+
+@abstract_base_test
+class MaskFunctionMixin(unittest.TestCase):
+    # Subclasses should define self.mask(mask, data)
+    def mask(self, mask: bytes, data: bytes) -> bytes:
+        raise NotImplementedError()
+
+    def test_mask(self: typing.Any):
+        self.assertEqual(self.mask(b"abcd", b""), b"")
+        self.assertEqual(self.mask(b"abcd", b"b"), b"\x03")
+        self.assertEqual(self.mask(b"abcd", b"54321"), b"TVPVP")
+        self.assertEqual(self.mask(b"ZXCV", b"98765432"), b"c`t`olpd")
+        # Include test cases with \x00 bytes (to ensure that the C
+        # extension isn't depending on null-terminated strings) and
+        # bytes with the high bit set (to smoke out signedness issues).
+        self.assertEqual(
+            self.mask(b"\x00\x01\x02\x03", b"\xff\xfb\xfd\xfc\xfe\xfa"),
+            b"\xff\xfa\xff\xff\xfe\xfb",
+        )
+        self.assertEqual(
+            self.mask(b"\xff\xfb\xfd\xfc", b"\x00\x01\x02\x03\x04\x05"),
+            b"\xff\xfa\xff\xff\xfb\xfe",
+        )
+
+
+class PythonMaskFunctionTest(MaskFunctionMixin):
+    def mask(self, mask, data):
+        return _websocket_mask_python(mask, data)
+
+
+@unittest.skipIf(speedups is None, "tornado.speedups module not present")
+class CythonMaskFunctionTest(MaskFunctionMixin):
+    def mask(self, mask, data):
+        return speedups.websocket_mask(mask, data)
+
+
+class ServerPeriodicPingTest(WebSocketBaseTestCase):
+    def get_app(self):
+        class PingHandler(TestWebSocketHandler):
+            def on_pong(self, data):
+                self.write_message("got pong")
+
+        return Application(
+            [("/", PingHandler)],
+            websocket_ping_interval=0.01,
+            websocket_ping_timeout=0,
+        )
+
+    @gen_test
+    def test_server_ping(self):
+        ws = yield self.ws_connect("/")
+        for i in range(3):
+            response = yield ws.read_message()
+            self.assertEqual(response, "got pong")
+        # TODO: test that the connection gets closed if ping responses stop.
+
+
+class ClientPeriodicPingTest(WebSocketBaseTestCase):
+    def get_app(self):
+        class PingHandler(TestWebSocketHandler):
+            def on_ping(self, data):
+                self.write_message("got ping")
+
+        return Application([("/", PingHandler)])
+
+    @gen_test
+    def test_client_ping(self):
+        ws = yield self.ws_connect("/", ping_interval=0.01, ping_timeout=0)
+        for i in range(3):
+            response = yield ws.read_message()
+            self.assertEqual(response, "got ping")
+        ws.close()
+
+
+class ServerPingTimeoutTest(WebSocketBaseTestCase):
+    def get_app(self):
+        self.handlers: list[WebSocketHandler] = []
+        test = self
+
+        class PingHandler(TestWebSocketHandler):
+            def initialize(self, close_future=None, compression_options=None):
+                self.handlers = test.handlers
+                # capture the handler instance so we can interrogate it later
+                self.handlers.append(self)
+                return super().initialize(
+                    close_future=close_future, compression_options=compression_options
+                )
+
+        app = Application([("/", PingHandler)])
+        return app
+
+    @staticmethod
+    def install_hook(ws):
+        """Optionally suppress the client's "pong" response."""
+
+        ws.drop_pongs = False
+        ws.pongs_received = 0
+
+        def wrapper(fcn):
+            def _inner(opcode: int, data: bytes):
+                if opcode == 0xA:  # NOTE: 0x9=ping, 0xA=pong
+                    ws.pongs_received += 1
+                    if ws.drop_pongs:
+                        # prevent pong responses
+                        return
+                # leave all other responses unchanged
+                return fcn(opcode, data)
+
+            return _inner
+
+        ws.protocol._handle_message = wrapper(ws.protocol._handle_message)
+
+    @gen_test
+    def test_client_ping_timeout(self):
+        # websocket client
+        interval = 0.2
+        ws = yield self.ws_connect(
+            "/", ping_interval=interval, ping_timeout=interval / 4
+        )
+        self.install_hook(ws)
+
+        # websocket handler (server side)
+        handler = self.handlers[0]
+
+        for _ in range(5):
+            # wait for the ping period
+            yield gen.sleep(interval)
+
+            # connection should still be open from the server end
+            self.assertIsNone(handler.close_code)
+            self.assertIsNone(handler.close_reason)
+
+            # connection should still be open from the client end
+            assert ws.protocol.close_code is None
+
+        # Check that our hook is intercepting messages; allow for
+        # some variance in timing (due to e.g. cpu load)
+        self.assertGreaterEqual(ws.pongs_received, 4)
+
+        # suppress the pong response message
+        ws.drop_pongs = True
+
+        # give the server time to register this
+        yield gen.sleep(interval * 1.5)
+
+        # connection should be closed from the server side
+        self.assertEqual(handler.close_code, 1000)
+        self.assertEqual(handler.close_reason, "ping timed out")
+
+        # client should have received a close operation
+        self.assertEqual(ws.protocol.close_code, 1000)
+
+
+class PingCalculationTest(unittest.TestCase):
+    def test_ping_sleep_time(self):
+        from tornado.websocket import WebSocketProtocol13
+
+        now = datetime.datetime(2025, 1, 1, 12, 0, 0, tzinfo=datetime.timezone.utc)
+        interval = 10  # seconds
+        last_ping_time = datetime.datetime(
+            2025, 1, 1, 11, 59, 54, tzinfo=datetime.timezone.utc
+        )
+        sleep_time = WebSocketProtocol13.ping_sleep_time(
+            last_ping_time=last_ping_time.timestamp(),
+            interval=interval,
+            now=now.timestamp(),
+        )
+        self.assertEqual(sleep_time, 4)
+
+
+class ManualPingTest(WebSocketBaseTestCase):
+    def get_app(self):
+        class PingHandler(TestWebSocketHandler):
+            def on_ping(self, data):
+                self.write_message(data, binary=isinstance(data, bytes))
+
+        return Application([("/", PingHandler)])
+
+    @gen_test
+    def test_manual_ping(self):
+        ws = yield self.ws_connect("/")
+
+        self.assertRaises(ValueError, ws.ping, "a" * 126)
+
+        ws.ping("hello")
+        resp = yield ws.read_message()
+        # on_ping always sees bytes.
+        self.assertEqual(resp, b"hello")
+
+        ws.ping(b"binary hello")
+        resp = yield ws.read_message()
+        self.assertEqual(resp, b"binary hello")
+
+
+class MaxMessageSizeTest(WebSocketBaseTestCase):
+    def get_app(self):
+        return Application([("/", EchoHandler)], websocket_max_message_size=1024)
+
+    @gen_test
+    def test_large_message(self):
+        ws = yield self.ws_connect("/")
+
+        # Write a message that is allowed.
+        msg = "a" * 1024
+        ws.write_message(msg)
+        resp = yield ws.read_message()
+        self.assertEqual(resp, msg)
+
+        # Write a message that is too large.
+        ws.write_message(msg + "b")
+        resp = yield ws.read_message()
+        # A message of None means the other side closed the connection.
+        self.assertIs(resp, None)
+        self.assertEqual(ws.close_code, 1009)
+        self.assertEqual(ws.close_reason, "message too big")
+        # TODO: Needs tests of messages split over multiple
+        # continuation frames.
diff --git a/env/lib/python3.12/site-packages/tornado/test/wsgi_test.py b/env/lib/python3.12/site-packages/tornado/test/wsgi_test.py
new file mode 100644
index 0000000..9fbc744
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tornado/test/wsgi_test.py
@@ -0,0 +1,116 @@
+import asyncio
+import concurrent.futures
+import threading
+
+from wsgiref.validate import validator
+
+from tornado.routing import RuleRouter
+from tornado.testing import AsyncHTTPTestCase, gen_test
+from tornado.wsgi import WSGIContainer
+
+
+class WSGIAppMixin:
+    # TODO: Now that WSGIAdapter is gone, this is a pretty weak test.
+    def get_executor(self):
+        raise NotImplementedError()
+
+    def get_app(self):
+        executor = self.get_executor()
+        # The barrier test in DummyExecutorTest will always wait the full
+        # value of this timeout, so we don't want it to be too high.
+        self.barrier = threading.Barrier(2, timeout=0.3)
+
+        def make_container(app):
+            return WSGIContainer(validator(app), executor=executor)
+
+        return RuleRouter(
+            [
+                ("/simple", make_container(self.simple_wsgi_app)),
+                ("/barrier", make_container(self.barrier_wsgi_app)),
+                ("/streaming_barrier", make_container(self.streaming_barrier_wsgi_app)),
+            ]
+        )
+
+    def respond_plain(self, start_response):
+        status = "200 OK"
+        response_headers = [("Content-Type", "text/plain")]
+        start_response(status, response_headers)
+
+    def simple_wsgi_app(self, environ, start_response):
+        self.respond_plain(start_response)
+        return [b"Hello world!"]
+
+    def barrier_wsgi_app(self, environ, start_response):
+        self.respond_plain(start_response)
+        try:
+            n = self.barrier.wait()
+        except threading.BrokenBarrierError:
+            return [b"broken barrier"]
+        else:
+            return [b"ok %d" % n]
+
+    def streaming_barrier_wsgi_app(self, environ, start_response):
+        self.respond_plain(start_response)
+        yield b"ok "
+        try:
+            n = self.barrier.wait()
+        except threading.BrokenBarrierError:
+            yield b"broken barrier"
+        else:
+            yield b"%d" % n
+
+
+class WSGIContainerDummyExecutorTest(WSGIAppMixin, AsyncHTTPTestCase):
+    def get_executor(self):
+        return None
+
+    def test_simple(self):
+        response = self.fetch("/simple")
+        self.assertEqual(response.body, b"Hello world!")
+
+    @gen_test
+    async def test_concurrent_barrier(self):
+        self.barrier.reset()
+        resps = await asyncio.gather(
+            self.http_client.fetch(self.get_url("/barrier")),
+            self.http_client.fetch(self.get_url("/barrier")),
+        )
+        for resp in resps:
+            self.assertEqual(resp.body, b"broken barrier")
+
+    @gen_test
+    async def test_concurrent_streaming_barrier(self):
+        self.barrier.reset()
+        resps = await asyncio.gather(
+            self.http_client.fetch(self.get_url("/streaming_barrier")),
+            self.http_client.fetch(self.get_url("/streaming_barrier")),
+        )
+        for resp in resps:
+            self.assertEqual(resp.body, b"ok broken barrier")
+
+
+class WSGIContainerThreadPoolTest(WSGIAppMixin, AsyncHTTPTestCase):
+    def get_executor(self):
+        return concurrent.futures.ThreadPoolExecutor()
+
+    def test_simple(self):
+        response = self.fetch("/simple")
+        self.assertEqual(response.body, b"Hello world!")
+
+    @gen_test
+    async def test_concurrent_barrier(self):
+        self.barrier.reset()
+        resps = await asyncio.gather(
+            self.http_client.fetch(self.get_url("/barrier")),
+            self.http_client.fetch(self.get_url("/barrier")),
+        )
+        self.assertEqual([b"ok 0", b"ok 1"], sorted([resp.body for resp in resps]))
+
+    @gen_test
+    async def test_concurrent_streaming_barrier(self):
+        self.barrier.reset()
+        resps = await asyncio.gather(
+            self.http_client.fetch(self.get_url("/streaming_barrier")),
+            self.http_client.fetch(self.get_url("/streaming_barrier")),
+        )
+        self.assertEqual([b"ok 0", b"ok 1"], sorted([resp.body for resp in resps]))
diff --git a/env/lib/python3.12/site-packages/tornado/testing.py b/env/lib/python3.12/site-packages/tornado/testing.py
new file mode 100644
index 0000000..a397e3f
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tornado/testing.py
@@ -0,0 +1,866 @@
+"""Support classes for automated testing.
+
+* `AsyncTestCase` and `AsyncHTTPTestCase`:  Subclasses of unittest.TestCase
+  with additional support for testing asynchronous (`.IOLoop`-based) code.
+
+* `ExpectLog`: Make test logs less spammy.
+
+* `main()`: A simple test runner (wrapper around unittest.main()) with support
+  for the tornado.autoreload module to rerun the tests when code changes.
+"""
+
+import asyncio
+from collections.abc import Generator
+import functools
+import inspect
+import logging
+import os
+import re
+import signal
+import socket
+import sys
+import unittest
+import warnings
+
+from tornado import gen
+from tornado.httpclient import AsyncHTTPClient, HTTPResponse
+from tornado.httpserver import HTTPServer
+from tornado.ioloop import IOLoop, TimeoutError
+from tornado import netutil
+from tornado.platform.asyncio import AsyncIOMainLoop
+from tornado.process import Subprocess
+from tornado.log import app_log
+from tornado.util import raise_exc_info, basestring_type
+from tornado.web import Application
+
+import typing
+from typing import Tuple, Any, Callable, Type, Dict, Union, Optional, Coroutine
+from types import TracebackType
+
+if typing.TYPE_CHECKING:
+    _ExcInfoTuple = Tuple[
+        Optional[Type[BaseException]], Optional[BaseException], Optional[TracebackType]
+    ]
+
+
+_NON_OWNED_IOLOOPS = AsyncIOMainLoop
+
+
+def bind_unused_port(
+    reuse_port: bool = False, address: str = "127.0.0.1"
+) -> Tuple[socket.socket, int]:
+    """Binds a server socket to an available port on localhost.
+
+    Returns a tuple (socket, port).
+
+    .. versionchanged:: 4.4
+       Always binds to ``127.0.0.1`` without resolving the name
+       ``localhost``.
+
+    .. versionchanged:: 6.2
+       Added optional ``address`` argument to
+       override the default "127.0.0.1".
+    """
+    sock = netutil.bind_sockets(
+        0, address, family=socket.AF_INET, reuse_port=reuse_port
+    )[0]
+    port = sock.getsockname()[1]
+    return sock, port
+
+
+def get_async_test_timeout() -> float:
+    """Get the global timeout setting for async tests.
+
+    Returns a float, the timeout in seconds.
+
+    .. versionadded:: 3.1
+    """
+    env = os.environ.get("ASYNC_TEST_TIMEOUT")
+    if env is not None:
+        try:
+            return float(env)
+        except ValueError:
+            pass
+    return 5
+
+
+class AsyncTestCase(unittest.TestCase):
+    """`~unittest.TestCase` subclass for testing `.IOLoop`-based
+    asynchronous code.
+
+    The unittest framework is synchronous, so the test must be
+    complete by the time the test method returns. This means that
+    asynchronous code cannot be used in quite the same way as usual
+    and must be adapted to fit. To write your tests with coroutines,
+    decorate your test methods with `tornado.testing.gen_test` instead
+    of `tornado.gen.coroutine`.
+
+    This class also provides the (deprecated) `stop()` and `wait()`
+    methods for a more manual style of testing. The test method itself
+    must call ``self.wait()``, and asynchronous callbacks should call
+    ``self.stop()`` to signal completion.
+
+    By default, a new `.IOLoop` is constructed for each test and is available
+    as ``self.io_loop``.  If the code being tested requires a
+    reused global `.IOLoop`, subclasses should override `get_new_ioloop` to return it,
+    although this is deprecated as of Tornado 6.3.
+
+    The `.IOLoop`'s ``start`` and ``stop`` methods should not be
+    called directly.  Instead, use `self.stop ` and `self.wait
+    `.  Arguments passed to ``self.stop`` are returned from
+    ``self.wait``.  It is possible to have multiple ``wait``/``stop``
+    cycles in the same test.
+
+    Example::
+
+        # This test uses coroutine style.
+        class MyTestCase(AsyncTestCase):
+            @tornado.testing.gen_test
+            def test_http_fetch(self):
+                client = AsyncHTTPClient()
+                response = yield client.fetch("http://www.tornadoweb.org")
+                # Test contents of response
+                self.assertIn("FriendFeed", response.body)
+
+        # This test uses argument passing between self.stop and self.wait.
+        class MyTestCase2(AsyncTestCase):
+            def test_http_fetch(self):
+                client = AsyncHTTPClient()
+                client.fetch("http://www.tornadoweb.org/", self.stop)
+                response = self.wait()
+                # Test contents of response
+                self.assertIn("FriendFeed", response.body)
+    """
+
+    def __init__(self, methodName: str = "runTest") -> None:
+        super().__init__(methodName)
+        self.__stopped = False
+        self.__running = False
+        self.__failure = None  # type: Optional[_ExcInfoTuple]
+        self.__stop_args = None  # type: Any
+        self.__timeout = None  # type: Optional[object]
+
+        # Not used in this class itself, but used by @gen_test
+        self._test_generator = None  # type: Optional[Union[Generator, Coroutine]]
+
+    def setUp(self) -> None:
+        py_ver = sys.version_info
+        if ((3, 10, 0) <= py_ver < (3, 10, 9)) or ((3, 11, 0) <= py_ver <= (3, 11, 1)):
+            # Early releases in the Python 3.10 and 3.1 series had deprecation
+            # warnings that were later reverted; we must suppress them here.
+            setup_with_context_manager(self, warnings.catch_warnings())
+            warnings.filterwarnings(
+                "ignore",
+                message="There is no current event loop",
+                category=DeprecationWarning,
+                module=r"tornado\..*",
+            )
+        super().setUp()
+        if type(self).get_new_ioloop is not AsyncTestCase.get_new_ioloop:
+            warnings.warn("get_new_ioloop is deprecated", DeprecationWarning)
+        self.io_loop = self.get_new_ioloop()
+        asyncio.set_event_loop(self.io_loop.asyncio_loop)  # type: ignore[attr-defined]
+
+    def tearDown(self) -> None:
+        # Native coroutines tend to produce warnings if they're not
+        # allowed to run to completion. It's difficult to ensure that
+        # this always happens in tests, so cancel any tasks that are
+        # still pending by the time we get here.
+        asyncio_loop = self.io_loop.asyncio_loop  # type: ignore
+        tasks = asyncio.all_tasks(asyncio_loop)
+        # Tasks that are done may still appear here and may contain
+        # non-cancellation exceptions, so filter them out.
+        tasks = [t for t in tasks if not t.done()]  # type: ignore
+        for t in tasks:
+            t.cancel()
+        # Allow the tasks to run and finalize themselves (which means
+        # raising a CancelledError inside the coroutine). This may
+        # just transform the "task was destroyed but it is pending"
+        # warning into a "uncaught CancelledError" warning, but
+        # catching CancelledErrors in coroutines that may leak is
+        # simpler than ensuring that no coroutines leak.
+        if tasks:
+            done, pending = self.io_loop.run_sync(lambda: asyncio.wait(tasks))
+            assert not pending
+            # If any task failed with anything but a CancelledError, raise it.
+            for f in done:
+                try:
+                    f.result()
+                except asyncio.CancelledError:
+                    pass
+
+        # Clean up Subprocess, so it can be used again with a new ioloop.
+        Subprocess.uninitialize()
+        asyncio.set_event_loop(None)
+        if not isinstance(self.io_loop, _NON_OWNED_IOLOOPS):
+            # Try to clean up any file descriptors left open in the ioloop.
+            # This avoids leaks, especially when tests are run repeatedly
+            # in the same process with autoreload (because curl does not
+            # set FD_CLOEXEC on its file descriptors)
+            self.io_loop.close(all_fds=True)
+        super().tearDown()
+        # In case an exception escaped or the StackContext caught an exception
+        # when there wasn't a wait() to re-raise it, do so here.
+        # This is our last chance to raise an exception in a way that the
+        # unittest machinery understands.
+        self.__rethrow()
+
+    def get_new_ioloop(self) -> IOLoop:
+        """Returns the `.IOLoop` to use for this test.
+
+        By default, a new `.IOLoop` is created for each test.
+        Subclasses may override this method to return
+        `.IOLoop.current()` if it is not appropriate to use a new
+        `.IOLoop` in each tests (for example, if there are global
+        singletons using the default `.IOLoop`) or if a per-test event
+        loop is being provided by another system (such as
+        ``pytest-asyncio``).
+
+        .. deprecated:: 6.3
+           This method will be removed in Tornado 7.0.
+        """
+        return IOLoop(make_current=False)
+
+    def _handle_exception(
+        self, typ: Type[Exception], value: Exception, tb: TracebackType
+    ) -> bool:
+        if self.__failure is None:
+            self.__failure = (typ, value, tb)
+        else:
+            app_log.error(
+                "multiple unhandled exceptions in test", exc_info=(typ, value, tb)
+            )
+        self.stop()
+        return True
+
+    def __rethrow(self) -> None:
+        if self.__failure is not None:
+            failure = self.__failure
+            self.__failure = None
+            raise_exc_info(failure)
+
+    def run(
+        self, result: Optional[unittest.TestResult] = None
+    ) -> Optional[unittest.TestResult]:
+        ret = super().run(result)
+        # As a last resort, if an exception escaped super.run() and wasn't
+        # re-raised in tearDown, raise it here.  This will cause the
+        # unittest run to fail messily, but that's better than silently
+        # ignoring an error.
+        self.__rethrow()
+        return ret
+
+    def _callTestMethod(self, method: Callable) -> None:
+        """Run the given test method, raising an error if it returns non-None.
+
+        Failure to decorate asynchronous test methods with ``@gen_test`` can lead to tests
+        incorrectly passing.
+
+        Remove this override when Python 3.10 support is dropped. This check (in the form of a
+        DeprecationWarning) became a part of the standard library in 3.11.
+
+        Note that ``_callTestMethod`` is not documented as a public interface. However, it is
+        present in all supported versions of Python (3.8+), and if it goes away in the future that's
+        OK because we can just remove this override as noted above.
+        """
+        # Calling super()._callTestMethod would hide the return value, even in python 3.8-3.10
+        # where the check isn't being done for us.
+        result = method()
+        if isinstance(result, Generator) or inspect.iscoroutine(result):
+            raise TypeError(
+                "Generator and coroutine test methods should be"
+                " decorated with tornado.testing.gen_test"
+            )
+        elif result is not None:
+            raise ValueError("Return value from test method ignored: %r" % result)
+
+    def stop(self, _arg: Any = None, **kwargs: Any) -> None:
+        """Stops the `.IOLoop`, causing one pending (or future) call to `wait()`
+        to return.
+
+        Keyword arguments or a single positional argument passed to `stop()` are
+        saved and will be returned by `wait()`.
+
+        .. deprecated:: 5.1
+
+           `stop` and `wait` are deprecated; use ``@gen_test`` instead.
+        """
+        assert _arg is None or not kwargs
+        self.__stop_args = kwargs or _arg
+        if self.__running:
+            self.io_loop.stop()
+            self.__running = False
+        self.__stopped = True
+
+    def wait(
+        self,
+        condition: Optional[Callable[..., bool]] = None,
+        timeout: Optional[float] = None,
+    ) -> Any:
+        """Runs the `.IOLoop` until stop is called or timeout has passed.
+
+        In the event of a timeout, an exception will be thrown. The
+        default timeout is 5 seconds; it may be overridden with a
+        ``timeout`` keyword argument or globally with the
+        ``ASYNC_TEST_TIMEOUT`` environment variable.
+
+        If ``condition`` is not ``None``, the `.IOLoop` will be restarted
+        after `stop()` until ``condition()`` returns ``True``.
+
+        .. versionchanged:: 3.1
+           Added the ``ASYNC_TEST_TIMEOUT`` environment variable.
+
+        .. deprecated:: 5.1
+
+           `stop` and `wait` are deprecated; use ``@gen_test`` instead.
+        """
+        if timeout is None:
+            timeout = get_async_test_timeout()
+
+        if not self.__stopped:
+            if timeout:
+
+                def timeout_func() -> None:
+                    try:
+                        raise self.failureException(
+                            "Async operation timed out after %s seconds" % timeout
+                        )
+                    except Exception:
+                        self.__failure = sys.exc_info()
+                    self.stop()
+
+                self.__timeout = self.io_loop.add_timeout(
+                    self.io_loop.time() + timeout, timeout_func
+                )
+            while True:
+                self.__running = True
+                self.io_loop.start()
+                if self.__failure is not None or condition is None or condition():
+                    break
+            if self.__timeout is not None:
+                self.io_loop.remove_timeout(self.__timeout)
+                self.__timeout = None
+        assert self.__stopped
+        self.__stopped = False
+        self.__rethrow()
+        result = self.__stop_args
+        self.__stop_args = None
+        return result
+
+
+class AsyncHTTPTestCase(AsyncTestCase):
+    """A test case that starts up an HTTP server.
+
+    Subclasses must override `get_app()`, which returns the
+    `tornado.web.Application` (or other `.HTTPServer` callback) to be tested.
+    Tests will typically use the provided ``self.http_client`` to fetch
+    URLs from this server.
+
+    Example, assuming the "Hello, world" example from the user guide is in
+    ``hello.py``::
+
+        import hello
+
+        class TestHelloApp(AsyncHTTPTestCase):
+            def get_app(self):
+                return hello.make_app()
+
+            def test_homepage(self):
+                response = self.fetch('/')
+                self.assertEqual(response.code, 200)
+                self.assertEqual(response.body, 'Hello, world')
+
+    That call to ``self.fetch()`` is equivalent to ::
+
+        self.http_client.fetch(self.get_url('/'), self.stop)
+        response = self.wait()
+
+    which illustrates how AsyncTestCase can turn an asynchronous operation,
+    like ``http_client.fetch()``, into a synchronous operation. If you need
+    to do other asynchronous operations in tests, you'll probably need to use
+    ``stop()`` and ``wait()`` yourself.
+    """
+
+    def setUp(self) -> None:
+        super().setUp()
+        sock, port = bind_unused_port()
+        self.__port = port
+
+        self.http_client = self.get_http_client()
+        self._app = self.get_app()
+        self.http_server = self.get_http_server()
+        self.http_server.add_sockets([sock])
+
+    def get_http_client(self) -> AsyncHTTPClient:
+        return AsyncHTTPClient()
+
+    def get_http_server(self) -> HTTPServer:
+        return HTTPServer(self._app, **self.get_httpserver_options())
+
+    def get_app(self) -> Application:
+        """Should be overridden by subclasses to return a
+        `tornado.web.Application` or other `.HTTPServer` callback.
+        """
+        raise NotImplementedError()
+
+    def fetch(
+        self, path: str, raise_error: bool = False, **kwargs: Any
+    ) -> HTTPResponse:
+        """Convenience method to synchronously fetch a URL.
+
+        The given path will be appended to the local server's host and
+        port.  Any additional keyword arguments will be passed directly to
+        `.AsyncHTTPClient.fetch` (and so could be used to pass
+        ``method="POST"``, ``body="..."``, etc).
+
+        If the path begins with http:// or https://, it will be treated as a
+        full URL and will be fetched as-is.
+
+        If ``raise_error`` is ``True``, a `tornado.httpclient.HTTPError` will
+        be raised if the response code is not 200. This is the same behavior
+        as the ``raise_error`` argument to `.AsyncHTTPClient.fetch`, but
+        the default is ``False`` here (it's ``True`` in `.AsyncHTTPClient`)
+        because tests often need to deal with non-200 response codes.
+
+        .. versionchanged:: 5.0
+           Added support for absolute URLs.
+
+        .. versionchanged:: 5.1
+
+           Added the ``raise_error`` argument.
+
+        .. deprecated:: 5.1
+
+           This method currently turns any exception into an
+           `.HTTPResponse` with status code 599. In Tornado 6.0,
+           errors other than `tornado.httpclient.HTTPError` will be
+           passed through, and ``raise_error=False`` will only
+           suppress errors that would be raised due to non-200
+           response codes.
+
+        """
+        if path.lower().startswith(("http://", "https://")):
+            url = path
+        else:
+            url = self.get_url(path)
+        return self.io_loop.run_sync(
+            lambda: self.http_client.fetch(url, raise_error=raise_error, **kwargs),
+            timeout=get_async_test_timeout(),
+        )
+
+    def get_httpserver_options(self) -> Dict[str, Any]:
+        """May be overridden by subclasses to return additional
+        keyword arguments for the server.
+        """
+        return {}
+
+    def get_http_port(self) -> int:
+        """Returns the port used by the server.
+
+        A new port is chosen for each test.
+        """
+        return self.__port
+
+    def get_protocol(self) -> str:
+        return "http"
+
+    def get_url(self, path: str) -> str:
+        """Returns an absolute url for the given path on the test server."""
+        return f"{self.get_protocol()}://127.0.0.1:{self.get_http_port()}{path}"
+
+    def tearDown(self) -> None:
+        self.http_server.stop()
+        self.io_loop.run_sync(
+            self.http_server.close_all_connections, timeout=get_async_test_timeout()
+        )
+        self.http_client.close()
+        del self.http_server
+        del self._app
+        super().tearDown()
+
+
+class AsyncHTTPSTestCase(AsyncHTTPTestCase):
+    """A test case that starts an HTTPS server.
+
+    Interface is generally the same as `AsyncHTTPTestCase`.
+    """
+
+    def get_http_client(self) -> AsyncHTTPClient:
+        return AsyncHTTPClient(force_instance=True, defaults=dict(validate_cert=False))
+
+    def get_httpserver_options(self) -> Dict[str, Any]:
+        return dict(ssl_options=self.get_ssl_options())
+
+    def get_ssl_options(self) -> Dict[str, Any]:
+        """May be overridden by subclasses to select SSL options.
+
+        By default includes a self-signed testing certificate.
+        """
+        return AsyncHTTPSTestCase.default_ssl_options()
+
+    @staticmethod
+    def default_ssl_options() -> Dict[str, Any]:
+        # Testing keys were generated with:
+        # openssl req -new -keyout tornado/test/test.key \
+        #     -out tornado/test/test.crt \
+        #     -nodes -days 3650 -x509 \
+        #     -subj "/CN=foo.example.com" -addext "subjectAltName = DNS:foo.example.com"
+        module_dir = os.path.dirname(__file__)
+        return dict(
+            certfile=os.path.join(module_dir, "test", "test.crt"),
+            keyfile=os.path.join(module_dir, "test", "test.key"),
+        )
+
+    def get_protocol(self) -> str:
+        return "https"
+
+
+@typing.overload
+def gen_test(
+    *, timeout: Optional[float] = None
+) -> Callable[[Callable[..., Union[Generator, "Coroutine"]]], Callable[..., None]]:
+    pass
+
+
+@typing.overload  # noqa: F811
+def gen_test(func: Callable[..., Union[Generator, "Coroutine"]]) -> Callable[..., None]:
+    pass
+
+
+def gen_test(  # noqa: F811
+    func: Optional[Callable[..., Union[Generator, "Coroutine"]]] = None,
+    timeout: Optional[float] = None,
+) -> Union[
+    Callable[..., None],
+    Callable[[Callable[..., Union[Generator, "Coroutine"]]], Callable[..., None]],
+]:
+    """Testing equivalent of ``@gen.coroutine``, to be applied to test methods.
+
+    ``@gen.coroutine`` cannot be used on tests because the `.IOLoop` is not
+    already running.  ``@gen_test`` should be applied to test methods
+    on subclasses of `AsyncTestCase`.
+
+    Example::
+
+        class MyTest(AsyncHTTPTestCase):
+            @gen_test
+            def test_something(self):
+                response = yield self.http_client.fetch(self.get_url('/'))
+
+    By default, ``@gen_test`` times out after 5 seconds. The timeout may be
+    overridden globally with the ``ASYNC_TEST_TIMEOUT`` environment variable,
+    or for each test with the ``timeout`` keyword argument::
+
+        class MyTest(AsyncHTTPTestCase):
+            @gen_test(timeout=10)
+            def test_something_slow(self):
+                response = yield self.http_client.fetch(self.get_url('/'))
+
+    Note that ``@gen_test`` is incompatible with `AsyncTestCase.stop`,
+    `AsyncTestCase.wait`, and `AsyncHTTPTestCase.fetch`. Use ``yield
+    self.http_client.fetch(self.get_url())`` as shown above instead.
+
+    .. versionadded:: 3.1
+       The ``timeout`` argument and ``ASYNC_TEST_TIMEOUT`` environment
+       variable.
+
+    .. versionchanged:: 4.0
+       The wrapper now passes along ``*args, **kwargs`` so it can be used
+       on functions with arguments.
+
+    """
+    if timeout is None:
+        timeout = get_async_test_timeout()
+
+    def wrap(f: Callable[..., Union[Generator, "Coroutine"]]) -> Callable[..., None]:
+        # Stack up several decorators to allow us to access the generator
+        # object itself.  In the innermost wrapper, we capture the generator
+        # and save it in an attribute of self.  Next, we run the wrapped
+        # function through @gen.coroutine.  Finally, the coroutine is
+        # wrapped again to make it synchronous with run_sync.
+        #
+        # This is a good case study arguing for either some sort of
+        # extensibility in the gen decorators or cancellation support.
+        @functools.wraps(f)
+        def pre_coroutine(self, *args, **kwargs):
+            # type: (AsyncTestCase, *Any, **Any) -> Union[Generator, Coroutine]
+            # Type comments used to avoid pypy3 bug.
+            result = f(self, *args, **kwargs)
+            if isinstance(result, Generator) or inspect.iscoroutine(result):
+                self._test_generator = result
+            else:
+                self._test_generator = None
+            return result
+
+        if inspect.iscoroutinefunction(f):
+            coro = pre_coroutine
+        else:
+            coro = gen.coroutine(pre_coroutine)  # type: ignore[assignment]
+
+        @functools.wraps(coro)
+        def post_coroutine(self, *args, **kwargs):
+            # type: (AsyncTestCase, *Any, **Any) -> None
+            try:
+                return self.io_loop.run_sync(
+                    functools.partial(coro, self, *args, **kwargs), timeout=timeout
+                )
+            except TimeoutError as e:
+                # run_sync raises an error with an unhelpful traceback.
+                # If the underlying generator is still running, we can throw the
+                # exception back into it so the stack trace is replaced by the
+                # point where the test is stopped. The only reason the generator
+                # would not be running would be if it were cancelled, which means
+                # a native coroutine, so we can rely on the cr_running attribute.
+                if self._test_generator is not None and getattr(
+                    self._test_generator, "cr_running", True
+                ):
+                    self._test_generator.throw(e)
+                    # In case the test contains an overly broad except
+                    # clause, we may get back here.
+                # Coroutine was stopped or didn't raise a useful stack trace,
+                # so re-raise the original exception which is better than nothing.
+                raise
+
+        return post_coroutine
+
+    if func is not None:
+        # Used like:
+        #     @gen_test
+        #     def f(self):
+        #         pass
+        return wrap(func)
+    else:
+        # Used like @gen_test(timeout=10)
+        return wrap
+
+
+# Without this attribute, nosetests will try to run gen_test as a test
+# anywhere it is imported.
+gen_test.__test__ = False  # type: ignore
+
+
+class ExpectLog(logging.Filter):
+    """Context manager to capture and suppress expected log output.
+
+    Useful to make tests of error conditions less noisy, while still
+    leaving unexpected log entries visible.  *Not thread safe.*
+
+    The attribute ``logged_stack`` is set to ``True`` if any exception
+    stack trace was logged.
+
+    Usage::
+
+        with ExpectLog('tornado.application', "Uncaught exception"):
+            error_response = self.fetch("/some_page")
+
+    .. versionchanged:: 4.3
+       Added the ``logged_stack`` attribute.
+    """
+
+    def __init__(
+        self,
+        logger: Union[logging.Logger, basestring_type],
+        regex: str,
+        required: bool = True,
+        level: Optional[int] = None,
+    ) -> None:
+        """Constructs an ExpectLog context manager.
+
+        :param logger: Logger object (or name of logger) to watch.  Pass an
+            empty string to watch the root logger.
+        :param regex: Regular expression to match.  Any log entries on the
+            specified logger that match this regex will be suppressed.
+        :param required: If true, an exception will be raised if the end of the
+            ``with`` statement is reached without matching any log entries.
+        :param level: A constant from the ``logging`` module indicating the
+            expected log level. If this parameter is provided, only log messages
+            at this level will be considered to match. Additionally, the
+            supplied ``logger`` will have its level adjusted if necessary (for
+            the duration of the ``ExpectLog`` to enable the expected message.
+
+        .. versionchanged:: 6.1
+           Added the ``level`` parameter.
+
+        .. deprecated:: 6.3
+           In Tornado 7.0, only ``WARNING`` and higher logging levels will be
+           matched by default. To match ``INFO`` and lower levels, the ``level``
+           argument must be used. This is changing to minimize differences
+           between ``tornado.testing.main`` (which enables ``INFO`` logs by
+           default) and most other test runners (including those in IDEs)
+           which have ``INFO`` logs disabled by default.
+        """
+        if isinstance(logger, basestring_type):
+            logger = logging.getLogger(logger)
+        self.logger = logger
+        self.regex = re.compile(regex)
+        self.required = required
+        # matched and deprecated_level_matched are a counter for the respective event.
+        self.matched = 0
+        self.deprecated_level_matched = 0
+        self.logged_stack = False
+        self.level = level
+        self.orig_level = None  # type: Optional[int]
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        if record.exc_info:
+            self.logged_stack = True
+        message = record.getMessage()
+        if self.regex.match(message):
+            if self.level is None and record.levelno < logging.WARNING:
+                # We're inside the logging machinery here so generating a DeprecationWarning
+                # here won't be reported cleanly (if warnings-as-errors is enabled, the error
+                # just gets swallowed by the logging module), and even if it were it would
+                # have the wrong stack trace. Just remember this fact and report it in
+                # __exit__ instead.
+                self.deprecated_level_matched += 1
+            if self.level is not None and record.levelno != self.level:
+                app_log.warning(
+                    "Got expected log message %r at unexpected level (%s vs %s)"
+                    % (message, logging.getLevelName(self.level), record.levelname)
+                )
+                return True
+            self.matched += 1
+            return False
+        return True
+
+    def __enter__(self) -> "ExpectLog":
+        if self.level is not None and self.level < self.logger.getEffectiveLevel():
+            self.orig_level = self.logger.level
+            self.logger.setLevel(self.level)
+        self.logger.addFilter(self)
+        return self
+
+    def __exit__(
+        self,
+        typ: "Optional[Type[BaseException]]",
+        value: Optional[BaseException],
+        tb: Optional[TracebackType],
+    ) -> None:
+        if self.orig_level is not None:
+            self.logger.setLevel(self.orig_level)
+        self.logger.removeFilter(self)
+        if not typ and self.required and not self.matched:
+            raise Exception("did not get expected log message")
+        if (
+            not typ
+            and self.required
+            and (self.deprecated_level_matched >= self.matched)
+        ):
+            warnings.warn(
+                "ExpectLog matched at INFO or below without level argument",
+                DeprecationWarning,
+            )
+
+
+# From https://nedbatchelder.com/blog/201508/using_context_managers_in_test_setup.html
+def setup_with_context_manager(testcase: unittest.TestCase, cm: Any) -> Any:
+    """Use a context manager to setUp a test case.
+
+    Example::
+
+        def setUp(self):
+            setup_with_context_manager(self, warnings.catch_warnings())
+            warnings.filterwarnings("ignore", category=DeprecationWarning)
+            # The catch_warnings context manager will be deactivated
+            # automatically in tearDown.
+
+    """
+    val = cm.__enter__()
+    testcase.addCleanup(cm.__exit__, None, None, None)
+    return val
+
+
+def main(**kwargs: Any) -> None:
+    """A simple test runner.
+
+    This test runner is essentially equivalent to `unittest.main` from
+    the standard library, but adds support for Tornado-style option
+    parsing and log formatting. It is *not* necessary to use this
+    `main` function to run tests using `AsyncTestCase`; these tests
+    are self-contained and can run with any test runner.
+
+    The easiest way to run a test is via the command line::
+
+        python -m tornado.testing tornado.test.web_test
+
+    See the standard library ``unittest`` module for ways in which
+    tests can be specified.
+
+    Projects with many tests may wish to define a test script like
+    ``tornado/test/runtests.py``.  This script should define a method
+    ``all()`` which returns a test suite and then call
+    `tornado.testing.main()`.  Note that even when a test script is
+    used, the ``all()`` test suite may be overridden by naming a
+    single test on the command line::
+
+        # Runs all tests
+        python -m tornado.test.runtests
+        # Runs one test
+        python -m tornado.test.runtests tornado.test.web_test
+
+    Additional keyword arguments passed through to ``unittest.main()``.
+    For example, use ``tornado.testing.main(verbosity=2)``
+    to show many test details as they are run.
+    See http://docs.python.org/library/unittest.html#unittest.main
+    for full argument list.
+
+    .. versionchanged:: 5.0
+
+       This function produces no output of its own; only that produced
+       by the `unittest` module (previously it would add a PASS or FAIL
+       log message).
+    """
+    from tornado.options import define, options, parse_command_line
+
+    define(
+        "exception_on_interrupt",
+        type=bool,
+        default=True,
+        help=(
+            "If true (default), ctrl-c raises a KeyboardInterrupt "
+            "exception.  This prints a stack trace but cannot interrupt "
+            "certain operations.  If false, the process is more reliably "
+            "killed, but does not print a stack trace."
+        ),
+    )
+
+    # support the same options as unittest's command-line interface
+    define("verbose", type=bool)
+    define("quiet", type=bool)
+    define("failfast", type=bool)
+    define("catch", type=bool)
+    define("buffer", type=bool)
+
+    argv = [sys.argv[0]] + parse_command_line(sys.argv)
+
+    if not options.exception_on_interrupt:
+        signal.signal(signal.SIGINT, signal.SIG_DFL)
+
+    if options.verbose is not None:
+        kwargs["verbosity"] = 2
+    if options.quiet is not None:
+        kwargs["verbosity"] = 0
+    if options.failfast is not None:
+        kwargs["failfast"] = True
+    if options.catch is not None:
+        kwargs["catchbreak"] = True
+    if options.buffer is not None:
+        kwargs["buffer"] = True
+
+    if __name__ == "__main__" and len(argv) == 1:
+        print("No tests specified", file=sys.stderr)
+        sys.exit(1)
+    # In order to be able to run tests by their fully-qualified name
+    # on the command line without importing all tests here,
+    # module must be set to None.  Python 3.2's unittest.main ignores
+    # defaultTest if no module is given (it tries to do its own
+    # test discovery, which is incompatible with auto2to3), so don't
+    # set module if we're not asking for a specific test.
+    if len(argv) > 1:
+        unittest.main(module=None, argv=argv, **kwargs)  # type: ignore
+    else:
+        unittest.main(defaultTest="all", argv=argv, **kwargs)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/env/lib/python3.12/site-packages/tornado/util.py b/env/lib/python3.12/site-packages/tornado/util.py
new file mode 100644
index 0000000..2e5eee7
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tornado/util.py
@@ -0,0 +1,445 @@
+"""Miscellaneous utility functions and classes.
+
+This module is used internally by Tornado.  It is not necessarily expected
+that the functions and classes defined here will be useful to other
+applications, but they are documented here in case they are.
+
+The one public-facing part of this module is the `Configurable` class
+and its `~Configurable.configure` method, which becomes a part of the
+interface of its subclasses, including `.AsyncHTTPClient`, `.IOLoop`,
+and `.Resolver`.
+"""
+
+import array
+import asyncio
+from inspect import getfullargspec
+import os
+import re
+import typing
+import zlib
+
+from typing import (
+    Any,
+    Optional,
+    Dict,
+    Mapping,
+    List,
+    Tuple,
+    Match,
+    Callable,
+    Type,
+    Sequence,
+)
+
+if typing.TYPE_CHECKING:
+    # Additional imports only used in type comments.
+    # This lets us make these imports lazy.
+    import datetime  # noqa: F401
+    from types import TracebackType  # noqa: F401
+    from typing import Union  # noqa: F401
+    import unittest  # noqa: F401
+
+# Aliases for types that are spelled differently in different Python
+# versions. bytes_type is deprecated and no longer used in Tornado
+# itself but is left in case anyone outside Tornado is using it.
+bytes_type = bytes
+unicode_type = str
+basestring_type = str
+
+
+# versionchanged:: 6.2
+# no longer our own TimeoutError, use standard asyncio class
+TimeoutError = asyncio.TimeoutError
+
+
+class ObjectDict(Dict[str, Any]):
+    """Makes a dictionary behave like an object, with attribute-style access."""
+
+    def __getattr__(self, name: str) -> Any:
+        try:
+            return self[name]
+        except KeyError:
+            raise AttributeError(name)
+
+    def __setattr__(self, name: str, value: Any) -> None:
+        self[name] = value
+
+
+class GzipDecompressor:
+    """Streaming gzip decompressor.
+
+    The interface is like that of `zlib.decompressobj` (without some of the
+    optional arguments, but it understands gzip headers and checksums.
+    """
+
+    def __init__(self) -> None:
+        # Magic parameter makes zlib module understand gzip header
+        # http://stackoverflow.com/questions/1838699/how-can-i-decompress-a-gzip-stream-with-zlib
+        # This works on cpython and pypy, but not jython.
+        self.decompressobj = zlib.decompressobj(16 + zlib.MAX_WBITS)
+
+    def decompress(self, value: bytes, max_length: int = 0) -> bytes:
+        """Decompress a chunk, returning newly-available data.
+
+        Some data may be buffered for later processing; `flush` must
+        be called when there is no more input data to ensure that
+        all data was processed.
+
+        If ``max_length`` is given, some input data may be left over
+        in ``unconsumed_tail``; you must retrieve this value and pass
+        it back to a future call to `decompress` if it is not empty.
+        """
+        return self.decompressobj.decompress(value, max_length)
+
+    @property
+    def unconsumed_tail(self) -> bytes:
+        """Returns the unconsumed portion left over"""
+        return self.decompressobj.unconsumed_tail
+
+    def flush(self) -> bytes:
+        """Return any remaining buffered data not yet returned by decompress.
+
+        Also checks for errors such as truncated input.
+        No other methods may be called on this object after `flush`.
+        """
+        return self.decompressobj.flush()
+
+
+def import_object(name: str) -> Any:
+    """Imports an object by name.
+
+    ``import_object('x')`` is equivalent to ``import x``.
+    ``import_object('x.y.z')`` is equivalent to ``from x.y import z``.
+
+    >>> import tornado.escape
+    >>> import_object('tornado.escape') is tornado.escape
+    True
+    >>> import_object('tornado.escape.utf8') is tornado.escape.utf8
+    True
+    >>> import_object('tornado') is tornado
+    True
+    >>> import_object('tornado.missing_module')
+    Traceback (most recent call last):
+        ...
+    ImportError: No module named missing_module
+    """
+    if name.count(".") == 0:
+        return __import__(name)
+
+    parts = name.split(".")
+    obj = __import__(".".join(parts[:-1]), fromlist=[parts[-1]])
+    try:
+        return getattr(obj, parts[-1])
+    except AttributeError:
+        raise ImportError("No module named %s" % parts[-1])
+
+
+def exec_in(
+    code: Any, glob: Dict[str, Any], loc: Optional[Optional[Mapping[str, Any]]] = None
+) -> None:
+    if isinstance(code, str):
+        # exec(string) inherits the caller's future imports; compile
+        # the string first to prevent that.
+        code = compile(code, "", "exec", dont_inherit=True)
+    exec(code, glob, loc)
+
+
+def raise_exc_info(
+    exc_info: Tuple[Optional[type], Optional[BaseException], Optional["TracebackType"]]
+) -> typing.NoReturn:
+    try:
+        if exc_info[1] is not None:
+            raise exc_info[1].with_traceback(exc_info[2])
+        else:
+            raise TypeError("raise_exc_info called with no exception")
+    finally:
+        # Clear the traceback reference from our stack frame to
+        # minimize circular references that slow down GC.
+        exc_info = (None, None, None)
+
+
+def errno_from_exception(e: BaseException) -> Optional[int]:
+    """Provides the errno from an Exception object.
+
+    There are cases that the errno attribute was not set so we pull
+    the errno out of the args but if someone instantiates an Exception
+    without any args you will get a tuple error. So this function
+    abstracts all that behavior to give you a safe way to get the
+    errno.
+    """
+
+    if hasattr(e, "errno"):
+        return e.errno  # type: ignore
+    elif e.args:
+        return e.args[0]
+    else:
+        return None
+
+
+_alphanum = frozenset("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789")
+
+
+def _re_unescape_replacement(match: Match[str]) -> str:
+    group = match.group(1)
+    if group[0] in _alphanum:
+        raise ValueError("cannot unescape '\\\\%s'" % group[0])
+    return group
+
+
+_re_unescape_pattern = re.compile(r"\\(.)", re.DOTALL)
+
+
+def re_unescape(s: str) -> str:
+    r"""Unescape a string escaped by `re.escape`.
+
+    May raise ``ValueError`` for regular expressions which could not
+    have been produced by `re.escape` (for example, strings containing
+    ``\d`` cannot be unescaped).
+
+    .. versionadded:: 4.4
+    """
+    return _re_unescape_pattern.sub(_re_unescape_replacement, s)
+
+
+class Configurable:
+    """Base class for configurable interfaces.
+
+    A configurable interface is an (abstract) class whose constructor
+    acts as a factory function for one of its implementation subclasses.
+    The implementation subclass as well as optional keyword arguments to
+    its initializer can be set globally at runtime with `configure`.
+
+    By using the constructor as the factory method, the interface
+    looks like a normal class, `isinstance` works as usual, etc.  This
+    pattern is most useful when the choice of implementation is likely
+    to be a global decision (e.g. when `~select.epoll` is available,
+    always use it instead of `~select.select`), or when a
+    previously-monolithic class has been split into specialized
+    subclasses.
+
+    Configurable subclasses must define the class methods
+    `configurable_base` and `configurable_default`, and use the instance
+    method `initialize` instead of ``__init__``.
+
+    .. versionchanged:: 5.0
+
+       It is now possible for configuration to be specified at
+       multiple levels of a class hierarchy.
+
+    """
+
+    # Type annotations on this class are mostly done with comments
+    # because they need to refer to Configurable, which isn't defined
+    # until after the class definition block. These can use regular
+    # annotations when our minimum python version is 3.7.
+    #
+    # There may be a clever way to use generics here to get more
+    # precise types (i.e. for a particular Configurable subclass T,
+    # all the types are subclasses of T, not just Configurable).
+    __impl_class = None  # type: Optional[Type[Configurable]]
+    __impl_kwargs = None  # type: Dict[str, Any]
+
+    def __new__(cls, *args: Any, **kwargs: Any) -> Any:
+        base = cls.configurable_base()
+        init_kwargs = {}  # type: Dict[str, Any]
+        if cls is base:
+            impl = cls.configured_class()
+            if base.__impl_kwargs:
+                init_kwargs.update(base.__impl_kwargs)
+        else:
+            impl = cls
+        init_kwargs.update(kwargs)
+        if impl.configurable_base() is not base:
+            # The impl class is itself configurable, so recurse.
+            return impl(*args, **init_kwargs)
+        instance = super().__new__(impl)
+        # initialize vs __init__ chosen for compatibility with AsyncHTTPClient
+        # singleton magic.  If we get rid of that we can switch to __init__
+        # here too.
+        instance.initialize(*args, **init_kwargs)
+        return instance
+
+    @classmethod
+    def configurable_base(cls):
+        # type: () -> Type[Configurable]
+        """Returns the base class of a configurable hierarchy.
+
+        This will normally return the class in which it is defined.
+        (which is *not* necessarily the same as the ``cls`` classmethod
+        parameter).
+
+        """
+        raise NotImplementedError()
+
+    @classmethod
+    def configurable_default(cls):
+        # type: () -> Type[Configurable]
+        """Returns the implementation class to be used if none is configured."""
+        raise NotImplementedError()
+
+    def _initialize(self) -> None:
+        pass
+
+    initialize = _initialize  # type: Callable[..., None]
+    """Initialize a `Configurable` subclass instance.
+
+    Configurable classes should use `initialize` instead of ``__init__``.
+
+    .. versionchanged:: 4.2
+       Now accepts positional arguments in addition to keyword arguments.
+    """
+
+    @classmethod
+    def configure(cls, impl, **kwargs):
+        # type: (Union[None, str, Type[Configurable]], Any) -> None
+        """Sets the class to use when the base class is instantiated.
+
+        Keyword arguments will be saved and added to the arguments passed
+        to the constructor.  This can be used to set global defaults for
+        some parameters.
+        """
+        base = cls.configurable_base()
+        if isinstance(impl, str):
+            impl = typing.cast(Type[Configurable], import_object(impl))
+        if impl is not None and not issubclass(impl, cls):
+            raise ValueError("Invalid subclass of %s" % cls)
+        base.__impl_class = impl
+        base.__impl_kwargs = kwargs
+
+    @classmethod
+    def configured_class(cls):
+        # type: () -> Type[Configurable]
+        """Returns the currently configured class."""
+        base = cls.configurable_base()
+        # Manually mangle the private name to see whether this base
+        # has been configured (and not another base higher in the
+        # hierarchy).
+        if base.__dict__.get("_Configurable__impl_class") is None:
+            base.__impl_class = cls.configurable_default()
+        if base.__impl_class is not None:
+            return base.__impl_class
+        else:
+            # Should be impossible, but mypy wants an explicit check.
+            raise ValueError("configured class not found")
+
+    @classmethod
+    def _save_configuration(cls):
+        # type: () -> Tuple[Optional[Type[Configurable]], Dict[str, Any]]
+        base = cls.configurable_base()
+        return (base.__impl_class, base.__impl_kwargs)
+
+    @classmethod
+    def _restore_configuration(cls, saved):
+        # type: (Tuple[Optional[Type[Configurable]], Dict[str, Any]]) -> None
+        base = cls.configurable_base()
+        base.__impl_class = saved[0]
+        base.__impl_kwargs = saved[1]
+
+
+class ArgReplacer:
+    """Replaces one value in an ``args, kwargs`` pair.
+
+    Inspects the function signature to find an argument by name
+    whether it is passed by position or keyword.  For use in decorators
+    and similar wrappers.
+    """
+
+    def __init__(self, func: Callable, name: str) -> None:
+        self.name = name
+        try:
+            self.arg_pos = self._getargnames(func).index(name)  # type: Optional[int]
+        except ValueError:
+            # Not a positional parameter
+            self.arg_pos = None
+
+    def _getargnames(self, func: Callable) -> List[str]:
+        try:
+            return getfullargspec(func).args
+        except TypeError:
+            if hasattr(func, "func_code"):
+                # Cython-generated code has all the attributes needed
+                # by inspect.getfullargspec, but the inspect module only
+                # works with ordinary functions. Inline the portion of
+                # getfullargspec that we need here. Note that for static
+                # functions the @cython.binding(True) decorator must
+                # be used (for methods it works out of the box).
+                code = func.func_code  # type: ignore
+                return code.co_varnames[: code.co_argcount]
+            raise
+
+    def get_old_value(
+        self, args: Sequence[Any], kwargs: Dict[str, Any], default: Any = None
+    ) -> Any:
+        """Returns the old value of the named argument without replacing it.
+
+        Returns ``default`` if the argument is not present.
+        """
+        if self.arg_pos is not None and len(args) > self.arg_pos:
+            return args[self.arg_pos]
+        else:
+            return kwargs.get(self.name, default)
+
+    def replace(
+        self, new_value: Any, args: Sequence[Any], kwargs: Dict[str, Any]
+    ) -> Tuple[Any, Sequence[Any], Dict[str, Any]]:
+        """Replace the named argument in ``args, kwargs`` with ``new_value``.
+
+        Returns ``(old_value, args, kwargs)``.  The returned ``args`` and
+        ``kwargs`` objects may not be the same as the input objects, or
+        the input objects may be mutated.
+
+        If the named argument was not found, ``new_value`` will be added
+        to ``kwargs`` and None will be returned as ``old_value``.
+        """
+        if self.arg_pos is not None and len(args) > self.arg_pos:
+            # The arg to replace is passed positionally
+            old_value = args[self.arg_pos]
+            args = list(args)  # *args is normally a tuple
+            args[self.arg_pos] = new_value
+        else:
+            # The arg to replace is either omitted or passed by keyword.
+            old_value = kwargs.get(self.name)
+            kwargs[self.name] = new_value
+        return old_value, args, kwargs
+
+
+def timedelta_to_seconds(td):
+    # type: (datetime.timedelta) -> float
+    """Equivalent to ``td.total_seconds()`` (introduced in Python 2.7)."""
+    return td.total_seconds()
+
+
+def _websocket_mask_python(mask: bytes, data: bytes) -> bytes:
+    """Websocket masking function.
+
+    `mask` is a `bytes` object of length 4; `data` is a `bytes` object of any length.
+    Returns a `bytes` object of the same length as `data` with the mask applied
+    as specified in section 5.3 of RFC 6455.
+
+    This pure-python implementation may be replaced by an optimized version when available.
+    """
+    mask_arr = array.array("B", mask)
+    unmasked_arr = array.array("B", data)
+    for i in range(len(data)):
+        unmasked_arr[i] = unmasked_arr[i] ^ mask_arr[i % 4]
+    return unmasked_arr.tobytes()
+
+
+if os.environ.get("TORNADO_NO_EXTENSION") or os.environ.get("TORNADO_EXTENSION") == "0":
+    # These environment variables exist to make it easier to do performance
+    # comparisons; they are not guaranteed to remain supported in the future.
+    _websocket_mask = _websocket_mask_python
+else:
+    try:
+        from tornado.speedups import websocket_mask as _websocket_mask
+    except ImportError:
+        if os.environ.get("TORNADO_EXTENSION") == "1":
+            raise
+        _websocket_mask = _websocket_mask_python
+
+
+def doctests():
+    # type: () -> unittest.TestSuite
+    import doctest
+
+    return doctest.DocTestSuite()
diff --git a/env/lib/python3.12/site-packages/tornado/web.py b/env/lib/python3.12/site-packages/tornado/web.py
new file mode 100644
index 0000000..2351afd
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tornado/web.py
@@ -0,0 +1,3803 @@
+#
+# Copyright 2009 Facebook
+#
+# 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.
+
+"""``tornado.web`` provides a simple web framework with asynchronous
+features that allow it to scale to large numbers of open connections,
+making it ideal for `long polling
+`_.
+
+Here is a simple "Hello, world" example app:
+
+.. testcode::
+
+    import asyncio
+    import tornado
+
+    class MainHandler(tornado.web.RequestHandler):
+        def get(self):
+            self.write("Hello, world")
+
+    async def main():
+        application = tornado.web.Application([
+            (r"/", MainHandler),
+        ])
+        application.listen(8888)
+        await asyncio.Event().wait()
+
+    if __name__ == "__main__":
+        asyncio.run(main())
+
+See the :doc:`guide` for additional information.
+
+Thread-safety notes
+-------------------
+
+In general, methods on `RequestHandler` and elsewhere in Tornado are
+not thread-safe. In particular, methods such as
+`~RequestHandler.write()`, `~RequestHandler.finish()`, and
+`~RequestHandler.flush()` must only be called from the main thread. If
+you use multiple threads it is important to use `.IOLoop.add_callback`
+to transfer control back to the main thread before finishing the
+request, or to limit your use of other threads to
+`.IOLoop.run_in_executor` and ensure that your callbacks running in
+the executor do not refer to Tornado objects.
+
+"""
+
+import base64
+import binascii
+import datetime
+import email.utils
+import functools
+import gzip
+import hashlib
+import hmac
+import http.cookies
+from inspect import isclass
+from io import BytesIO
+import mimetypes
+import numbers
+import os.path
+import re
+import socket
+import sys
+import threading
+import time
+import warnings
+import tornado
+import traceback
+import types
+import urllib.parse
+from urllib.parse import urlencode
+
+from tornado.concurrent import Future, future_set_result_unless_cancelled
+from tornado import escape
+from tornado import gen
+from tornado.httpserver import HTTPServer
+from tornado import httputil
+from tornado import iostream
+from tornado import locale
+from tornado.log import access_log, app_log, gen_log
+from tornado import template
+from tornado.escape import utf8, _unicode
+from tornado.routing import (
+    AnyMatches,
+    DefaultHostMatches,
+    HostMatches,
+    ReversibleRouter,
+    Rule,
+    ReversibleRuleRouter,
+    URLSpec,
+    _RuleList,
+)
+from tornado.util import ObjectDict, unicode_type, _websocket_mask
+
+url = URLSpec
+
+from typing import (
+    Dict,
+    Any,
+    Union,
+    Optional,
+    Awaitable,
+    Tuple,
+    List,
+    Callable,
+    Iterable,
+    Generator,
+    Type,
+    TypeVar,
+    cast,
+    overload,
+)
+from types import TracebackType
+import typing
+
+if typing.TYPE_CHECKING:
+    from typing import Set  # noqa: F401
+
+
+# The following types are accepted by RequestHandler.set_header
+# and related methods.
+_HeaderTypes = Union[bytes, unicode_type, int, numbers.Integral, datetime.datetime]
+
+_CookieSecretTypes = Union[str, bytes, Dict[int, str], Dict[int, bytes]]
+
+
+MIN_SUPPORTED_SIGNED_VALUE_VERSION = 1
+"""The oldest signed value version supported by this version of Tornado.
+
+Signed values older than this version cannot be decoded.
+
+.. versionadded:: 3.2.1
+"""
+
+MAX_SUPPORTED_SIGNED_VALUE_VERSION = 2
+"""The newest signed value version supported by this version of Tornado.
+
+Signed values newer than this version cannot be decoded.
+
+.. versionadded:: 3.2.1
+"""
+
+DEFAULT_SIGNED_VALUE_VERSION = 2
+"""The signed value version produced by `.RequestHandler.create_signed_value`.
+
+May be overridden by passing a ``version`` keyword argument.
+
+.. versionadded:: 3.2.1
+"""
+
+DEFAULT_SIGNED_VALUE_MIN_VERSION = 1
+"""The oldest signed value accepted by `.RequestHandler.get_signed_cookie`.
+
+May be overridden by passing a ``min_version`` keyword argument.
+
+.. versionadded:: 3.2.1
+"""
+
+
+class _ArgDefaultMarker:
+    pass
+
+
+_ARG_DEFAULT = _ArgDefaultMarker()
+
+
+class RequestHandler:
+    """Base class for HTTP request handlers.
+
+    Subclasses must define at least one of the methods defined in the
+    "Entry points" section below.
+
+    Applications should not construct `RequestHandler` objects
+    directly and subclasses should not override ``__init__`` (override
+    `~RequestHandler.initialize` instead).
+
+    """
+
+    SUPPORTED_METHODS: Tuple[str, ...] = (
+        "GET",
+        "HEAD",
+        "POST",
+        "DELETE",
+        "PATCH",
+        "PUT",
+        "OPTIONS",
+    )
+
+    _template_loaders = {}  # type: Dict[str, template.BaseLoader]
+    _template_loader_lock = threading.Lock()
+    _remove_control_chars_regex = re.compile(r"[\x00-\x08\x0e-\x1f]")
+
+    _stream_request_body = False
+
+    # Will be set in _execute.
+    _transforms = None  # type: List[OutputTransform]
+    path_args = None  # type: List[str]
+    path_kwargs = None  # type: Dict[str, str]
+
+    def __init__(
+        self,
+        application: "Application",
+        request: httputil.HTTPServerRequest,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__()
+
+        self.application = application
+        self.request = request
+        self._headers_written = False
+        self._finished = False
+        self._auto_finish = True
+        self._prepared_future = None
+        self.ui = ObjectDict(
+            (n, self._ui_method(m)) for n, m in application.ui_methods.items()
+        )
+        # UIModules are available as both `modules` and `_tt_modules` in the
+        # template namespace.  Historically only `modules` was available
+        # but could be clobbered by user additions to the namespace.
+        # The template {% module %} directive looks in `_tt_modules` to avoid
+        # possible conflicts.
+        self.ui["_tt_modules"] = _UIModuleNamespace(self, application.ui_modules)
+        self.ui["modules"] = self.ui["_tt_modules"]
+        self.clear()
+        assert self.request.connection is not None
+        # TODO: need to add set_close_callback to HTTPConnection interface
+        self.request.connection.set_close_callback(  # type: ignore
+            self.on_connection_close
+        )
+        self.initialize(**kwargs)  # type: ignore
+
+    def _initialize(self) -> None:
+        pass
+
+    initialize = _initialize  # type: Callable[..., None]
+    """Hook for subclass initialization. Called for each request.
+
+    A dictionary passed as the third argument of a ``URLSpec`` will be
+    supplied as keyword arguments to ``initialize()``.
+
+    Example::
+
+        class ProfileHandler(RequestHandler):
+            def initialize(self, database):
+                self.database = database
+
+            def get(self, username):
+                ...
+
+        app = Application([
+            (r'/user/(.*)', ProfileHandler, dict(database=database)),
+            ])
+    """
+
+    @property
+    def settings(self) -> Dict[str, Any]:
+        """An alias for `self.application.settings `."""
+        return self.application.settings
+
+    def _unimplemented_method(self, *args: str, **kwargs: str) -> None:
+        raise HTTPError(405)
+
+    head = _unimplemented_method  # type: Callable[..., Optional[Awaitable[None]]]
+    get = _unimplemented_method  # type: Callable[..., Optional[Awaitable[None]]]
+    post = _unimplemented_method  # type: Callable[..., Optional[Awaitable[None]]]
+    delete = _unimplemented_method  # type: Callable[..., Optional[Awaitable[None]]]
+    patch = _unimplemented_method  # type: Callable[..., Optional[Awaitable[None]]]
+    put = _unimplemented_method  # type: Callable[..., Optional[Awaitable[None]]]
+    options = _unimplemented_method  # type: Callable[..., Optional[Awaitable[None]]]
+
+    def prepare(self) -> Optional[Awaitable[None]]:
+        """Called at the beginning of a request before  `get`/`post`/etc.
+
+        Override this method to perform common initialization regardless
+        of the request method. There is no guarantee that ``prepare`` will
+        be called if an error occurs that is handled by the framework.
+
+        Asynchronous support: Use ``async def`` or decorate this method with
+        `.gen.coroutine` to make it asynchronous.
+        If this method returns an  ``Awaitable`` execution will not proceed
+        until the ``Awaitable`` is done.
+
+        .. versionadded:: 3.1
+           Asynchronous support.
+        """
+        pass
+
+    def on_finish(self) -> None:
+        """Called after the end of a request.
+
+        Override this method to perform cleanup, logging, etc. This method is primarily intended as
+        a counterpart to `prepare`. However, there are a few error cases where ``on_finish`` may be
+        called when ``prepare`` has not. (These are considered bugs and may be fixed in the future,
+        but for now you may need to check to see if the initialization work done in ``prepare`` has
+        occurred)
+
+        ``on_finish`` may not produce any output, as it is called after the response has been sent
+        to the client.
+        """
+        pass
+
+    def on_connection_close(self) -> None:
+        """Called in async handlers if the client closed the connection.
+
+        Override this to clean up resources associated with
+        long-lived connections.  Note that this method is called only if
+        the connection was closed during asynchronous processing; if you
+        need to do cleanup after every request override `on_finish`
+        instead.
+
+        Proxies may keep a connection open for a time (perhaps
+        indefinitely) after the client has gone away, so this method
+        may not be called promptly after the end user closes their
+        connection.
+        """
+        if _has_stream_request_body(self.__class__):
+            if not self.request._body_future.done():
+                self.request._body_future.set_exception(iostream.StreamClosedError())
+                self.request._body_future.exception()
+
+    def clear(self) -> None:
+        """Resets all headers and content for this response."""
+        self._headers = httputil.HTTPHeaders(
+            {
+                "Server": "TornadoServer/%s" % tornado.version,
+                "Content-Type": "text/html; charset=UTF-8",
+                "Date": httputil.format_timestamp(time.time()),
+            }
+        )
+        self.set_default_headers()
+        self._write_buffer = []  # type: List[bytes]
+        self._status_code = 200
+        self._reason = httputil.responses[200]
+
+    def set_default_headers(self) -> None:
+        """Override this to set HTTP headers at the beginning of the request.
+
+        For example, this is the place to set a custom ``Server`` header.
+        Note that setting such headers in the normal flow of request
+        processing may not do what you want, since headers may be reset
+        during error handling.
+        """
+        pass
+
+    def set_status(self, status_code: int, reason: Optional[str] = None) -> None:
+        """Sets the status code for our response.
+
+        :arg int status_code: Response status code.
+        :arg str reason: Human-readable reason phrase describing the status
+            code (for example, the "Not Found" in ``HTTP/1.1 404 Not Found``).
+            Normally determined automatically from `http.client.responses`; this
+            argument should only be used if you need to use a non-standard
+            status code.
+
+        .. versionchanged:: 5.0
+
+           No longer validates that the response code is in
+           `http.client.responses`.
+        """
+        self._status_code = status_code
+        if reason is not None:
+            if "<" in reason or not httputil._ABNF.reason_phrase.fullmatch(reason):
+                # Logically this would be better as an exception, but this method
+                # is called on error-handling paths that would need some refactoring
+                # to tolerate internal errors cleanly.
+                #
+                # The check for "<" is a defense-in-depth against XSS attacks (we also
+                # escape the reason when rendering error pages).
+                reason = "Unknown"
+            self._reason = escape.native_str(reason)
+        else:
+            self._reason = httputil.responses.get(status_code, "Unknown")
+
+    def get_status(self) -> int:
+        """Returns the status code for our response."""
+        return self._status_code
+
+    def set_header(self, name: str, value: _HeaderTypes) -> None:
+        """Sets the given response header name and value.
+
+        All header values are converted to strings (`datetime` objects
+        are formatted according to the HTTP specification for the
+        ``Date`` header).
+
+        """
+        self._headers[name] = self._convert_header_value(value)
+
+    def add_header(self, name: str, value: _HeaderTypes) -> None:
+        """Adds the given response header and value.
+
+        Unlike `set_header`, `add_header` may be called multiple times
+        to return multiple values for the same header.
+        """
+        self._headers.add(name, self._convert_header_value(value))
+
+    def clear_header(self, name: str) -> None:
+        """Clears an outgoing header, undoing a previous `set_header` call.
+
+        Note that this method does not apply to multi-valued headers
+        set by `add_header`.
+        """
+        if name in self._headers:
+            del self._headers[name]
+
+    # https://www.rfc-editor.org/rfc/rfc9110#name-field-values
+    _VALID_HEADER_CHARS = re.compile(r"[\x09\x20-\x7e\x80-\xff]*")
+
+    def _convert_header_value(self, value: _HeaderTypes) -> str:
+        # Convert the input value to a str. This type check is a bit
+        # subtle: The bytes case only executes on python 3, and the
+        # unicode case only executes on python 2, because the other
+        # cases are covered by the first match for str.
+        if isinstance(value, str):
+            retval = value
+        elif isinstance(value, bytes):
+            # Non-ascii characters in headers are not well supported,
+            # but if you pass bytes, use latin1 so they pass through as-is.
+            retval = value.decode("latin1")
+        elif isinstance(value, numbers.Integral):
+            # return immediately since we know the converted value will be safe
+            return str(value)
+        elif isinstance(value, datetime.datetime):
+            return httputil.format_timestamp(value)
+        else:
+            raise TypeError("Unsupported header value %r" % value)
+        # If \n is allowed into the header, it is possible to inject
+        # additional headers or split the request.
+        if RequestHandler._VALID_HEADER_CHARS.fullmatch(retval) is None:
+            raise ValueError("Unsafe header value %r", retval)
+        return retval
+
+    @overload
+    def get_argument(self, name: str, default: str, strip: bool = True) -> str:
+        pass
+
+    @overload
+    def get_argument(  # noqa: F811
+        self, name: str, default: _ArgDefaultMarker = _ARG_DEFAULT, strip: bool = True
+    ) -> str:
+        pass
+
+    @overload
+    def get_argument(  # noqa: F811
+        self, name: str, default: None, strip: bool = True
+    ) -> Optional[str]:
+        pass
+
+    def get_argument(  # noqa: F811
+        self,
+        name: str,
+        default: Union[None, str, _ArgDefaultMarker] = _ARG_DEFAULT,
+        strip: bool = True,
+    ) -> Optional[str]:
+        """Returns the value of the argument with the given name.
+
+        If default is not provided, the argument is considered to be
+        required, and we raise a `MissingArgumentError` if it is missing.
+
+        If the argument appears in the request more than once, we return the
+        last value.
+
+        This method searches both the query and body arguments.
+        """
+        return self._get_argument(name, default, self.request.arguments, strip)
+
+    def get_arguments(self, name: str, strip: bool = True) -> List[str]:
+        """Returns a list of the arguments with the given name.
+
+        If the argument is not present, returns an empty list.
+
+        This method searches both the query and body arguments.
+        """
+
+        # Make sure `get_arguments` isn't accidentally being called with a
+        # positional argument that's assumed to be a default (like in
+        # `get_argument`.)
+        assert isinstance(strip, bool)
+
+        return self._get_arguments(name, self.request.arguments, strip)
+
+    @overload
+    def get_body_argument(self, name: str, default: str, strip: bool = True) -> str:
+        pass
+
+    @overload
+    def get_body_argument(  # noqa: F811
+        self, name: str, default: _ArgDefaultMarker = _ARG_DEFAULT, strip: bool = True
+    ) -> str:
+        pass
+
+    @overload
+    def get_body_argument(  # noqa: F811
+        self, name: str, default: None, strip: bool = True
+    ) -> Optional[str]:
+        pass
+
+    def get_body_argument(  # noqa: F811
+        self,
+        name: str,
+        default: Union[None, str, _ArgDefaultMarker] = _ARG_DEFAULT,
+        strip: bool = True,
+    ) -> Optional[str]:
+        """Returns the value of the argument with the given name
+        from the request body.
+
+        If default is not provided, the argument is considered to be
+        required, and we raise a `MissingArgumentError` if it is missing.
+
+        If the argument appears in the url more than once, we return the
+        last value.
+
+        .. versionadded:: 3.2
+        """
+        return self._get_argument(name, default, self.request.body_arguments, strip)
+
+    def get_body_arguments(self, name: str, strip: bool = True) -> List[str]:
+        """Returns a list of the body arguments with the given name.
+
+        If the argument is not present, returns an empty list.
+
+        .. versionadded:: 3.2
+        """
+        return self._get_arguments(name, self.request.body_arguments, strip)
+
+    @overload
+    def get_query_argument(self, name: str, default: str, strip: bool = True) -> str:
+        pass
+
+    @overload
+    def get_query_argument(  # noqa: F811
+        self, name: str, default: _ArgDefaultMarker = _ARG_DEFAULT, strip: bool = True
+    ) -> str:
+        pass
+
+    @overload
+    def get_query_argument(  # noqa: F811
+        self, name: str, default: None, strip: bool = True
+    ) -> Optional[str]:
+        pass
+
+    def get_query_argument(  # noqa: F811
+        self,
+        name: str,
+        default: Union[None, str, _ArgDefaultMarker] = _ARG_DEFAULT,
+        strip: bool = True,
+    ) -> Optional[str]:
+        """Returns the value of the argument with the given name
+        from the request query string.
+
+        If default is not provided, the argument is considered to be
+        required, and we raise a `MissingArgumentError` if it is missing.
+
+        If the argument appears in the url more than once, we return the
+        last value.
+
+        .. versionadded:: 3.2
+        """
+        return self._get_argument(name, default, self.request.query_arguments, strip)
+
+    def get_query_arguments(self, name: str, strip: bool = True) -> List[str]:
+        """Returns a list of the query arguments with the given name.
+
+        If the argument is not present, returns an empty list.
+
+        .. versionadded:: 3.2
+        """
+        return self._get_arguments(name, self.request.query_arguments, strip)
+
+    def _get_argument(
+        self,
+        name: str,
+        default: Union[None, str, _ArgDefaultMarker],
+        source: Dict[str, List[bytes]],
+        strip: bool = True,
+    ) -> Optional[str]:
+        args = self._get_arguments(name, source, strip=strip)
+        if not args:
+            if isinstance(default, _ArgDefaultMarker):
+                raise MissingArgumentError(name)
+            return default
+        return args[-1]
+
+    def _get_arguments(
+        self, name: str, source: Dict[str, List[bytes]], strip: bool = True
+    ) -> List[str]:
+        values = []
+        for v in source.get(name, []):
+            s = self.decode_argument(v, name=name)
+            if isinstance(s, unicode_type):
+                # Get rid of any weird control chars (unless decoding gave
+                # us bytes, in which case leave it alone)
+                s = RequestHandler._remove_control_chars_regex.sub(" ", s)
+            if strip:
+                s = s.strip()
+            values.append(s)
+        return values
+
+    def decode_argument(self, value: bytes, name: Optional[str] = None) -> str:
+        """Decodes an argument from the request.
+
+        The argument has been percent-decoded and is now a byte string.
+        By default, this method decodes the argument as utf-8 and returns
+        a unicode string, but this may be overridden in subclasses.
+
+        This method is used as a filter for both `get_argument()` and for
+        values extracted from the url and passed to `get()`/`post()`/etc.
+
+        The name of the argument is provided if known, but may be None
+        (e.g. for unnamed groups in the url regex).
+        """
+        try:
+            return _unicode(value)
+        except UnicodeDecodeError:
+            raise HTTPError(
+                400, "Invalid unicode in {}: {!r}".format(name or "url", value[:40])
+            )
+
+    @property
+    def cookies(self) -> Dict[str, http.cookies.Morsel]:
+        """An alias for
+        `self.request.cookies <.httputil.HTTPServerRequest.cookies>`."""
+        return self.request.cookies
+
+    @overload
+    def get_cookie(self, name: str, default: str) -> str:
+        pass
+
+    @overload
+    def get_cookie(self, name: str, default: None = None) -> Optional[str]:
+        pass
+
+    def get_cookie(self, name: str, default: Optional[str] = None) -> Optional[str]:
+        """Returns the value of the request cookie with the given name.
+
+        If the named cookie is not present, returns ``default``.
+
+        This method only returns cookies that were present in the request.
+        It does not see the outgoing cookies set by `set_cookie` in this
+        handler.
+        """
+        if self.request.cookies is not None and name in self.request.cookies:
+            return self.request.cookies[name].value
+        return default
+
+    def set_cookie(
+        self,
+        name: str,
+        value: Union[str, bytes],
+        domain: Optional[str] = None,
+        expires: Optional[Union[float, Tuple, datetime.datetime]] = None,
+        path: str = "/",
+        expires_days: Optional[float] = None,
+        # Keyword-only args start here for historical reasons.
+        *,
+        max_age: Optional[int] = None,
+        httponly: bool = False,
+        secure: bool = False,
+        samesite: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Sets an outgoing cookie name/value with the given options.
+
+        Newly-set cookies are not immediately visible via `get_cookie`;
+        they are not present until the next request.
+
+        Most arguments are passed directly to `http.cookies.Morsel` directly.
+        See https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie
+        for more information.
+
+        ``expires`` may be a numeric timestamp as returned by `time.time`,
+        a time tuple as returned by `time.gmtime`, or a
+        `datetime.datetime` object. ``expires_days`` is provided as a convenience
+        to set an expiration time in days from today (if both are set, ``expires``
+        is used).
+
+        .. deprecated:: 6.3
+           Keyword arguments are currently accepted case-insensitively.
+           In Tornado 7.0 this will be changed to only accept lowercase
+           arguments.
+        """
+        # The cookie library only accepts type str, in both python 2 and 3
+        name = escape.native_str(name)
+        value = escape.native_str(value)
+        if re.search(r"[\x00-\x20]", name + value):
+            # Don't let us accidentally inject bad stuff
+            raise ValueError(f"Invalid cookie {name!r}: {value!r}")
+        if not hasattr(self, "_new_cookie"):
+            self._new_cookie = (
+                http.cookies.SimpleCookie()
+            )  # type: http.cookies.SimpleCookie
+        if name in self._new_cookie:
+            del self._new_cookie[name]
+        self._new_cookie[name] = value
+        morsel = self._new_cookie[name]
+        if domain:
+            morsel["domain"] = domain
+        if expires_days is not None and not expires:
+            expires = datetime.datetime.now(datetime.timezone.utc) + datetime.timedelta(
+                days=expires_days
+            )
+        if expires:
+            morsel["expires"] = httputil.format_timestamp(expires)
+        if path:
+            morsel["path"] = path
+        if max_age:
+            # Note change from _ to -.
+            morsel["max-age"] = str(max_age)
+        if httponly:
+            # Note that SimpleCookie ignores the value here. The presense of an
+            # httponly (or secure) key is treated as true.
+            morsel["httponly"] = True
+        if secure:
+            morsel["secure"] = True
+        if samesite:
+            morsel["samesite"] = samesite
+        if kwargs:
+            # The setitem interface is case-insensitive, so continue to support
+            # kwargs for backwards compatibility until we can remove deprecated
+            # features.
+            for k, v in kwargs.items():
+                morsel[k] = v
+            warnings.warn(
+                f"Deprecated arguments to set_cookie: {set(kwargs.keys())} "
+                "(should be lowercase)",
+                DeprecationWarning,
+            )
+
+    def clear_cookie(self, name: str, **kwargs: Any) -> None:
+        """Deletes the cookie with the given name.
+
+        This method accepts the same arguments as `set_cookie`, except for
+        ``expires`` and ``max_age``. Clearing a cookie requires the same
+        ``domain`` and ``path`` arguments as when it was set. In some cases the
+        ``samesite`` and ``secure`` arguments are also required to match. Other
+        arguments are ignored.
+
+        Similar to `set_cookie`, the effect of this method will not be
+        seen until the following request.
+
+        .. versionchanged:: 6.3
+
+           Now accepts all keyword arguments that ``set_cookie`` does.
+           The ``samesite`` and ``secure`` flags have recently become
+           required for clearing ``samesite="none"`` cookies.
+        """
+        for excluded_arg in ["expires", "max_age"]:
+            if excluded_arg in kwargs:
+                raise TypeError(
+                    f"clear_cookie() got an unexpected keyword argument '{excluded_arg}'"
+                )
+        expires = datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(
+            days=365
+        )
+        self.set_cookie(name, value="", expires=expires, **kwargs)
+
+    def clear_all_cookies(self, **kwargs: Any) -> None:
+        """Attempt to delete all the cookies the user sent with this request.
+
+        See `clear_cookie` for more information on keyword arguments. Due to
+        limitations of the cookie protocol, it is impossible to determine on the
+        server side which values are necessary for the ``domain``, ``path``,
+        ``samesite``, or ``secure`` arguments, this method can only be
+        successful if you consistently use the same values for these arguments
+        when setting cookies.
+
+        Similar to `set_cookie`, the effect of this method will not be seen
+        until the following request.
+
+        .. versionchanged:: 3.2
+
+           Added the ``path`` and ``domain`` parameters.
+
+        .. versionchanged:: 6.3
+
+           Now accepts all keyword arguments that ``set_cookie`` does.
+
+        .. deprecated:: 6.3
+
+           The increasingly complex rules governing cookies have made it
+           impossible for a ``clear_all_cookies`` method to work reliably
+           since all we know about cookies are their names. Applications
+           should generally use ``clear_cookie`` one at a time instead.
+        """
+        for name in self.request.cookies:
+            self.clear_cookie(name, **kwargs)
+
+    def set_signed_cookie(
+        self,
+        name: str,
+        value: Union[str, bytes],
+        expires_days: Optional[float] = 30,
+        version: Optional[int] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Signs and timestamps a cookie so it cannot be forged.
+
+        You must specify the ``cookie_secret`` setting in your Application
+        to use this method. It should be a long, random sequence of bytes
+        to be used as the HMAC secret for the signature.
+
+        To read a cookie set with this method, use `get_signed_cookie()`.
+
+        Note that the ``expires_days`` parameter sets the lifetime of the
+        cookie in the browser, but is independent of the ``max_age_days``
+        parameter to `get_signed_cookie`.
+        A value of None limits the lifetime to the current browser session.
+
+        Secure cookies may contain arbitrary byte values, not just unicode
+        strings (unlike regular cookies)
+
+        Similar to `set_cookie`, the effect of this method will not be
+        seen until the following request.
+
+        .. versionchanged:: 3.2.1
+
+           Added the ``version`` argument.  Introduced cookie version 2
+           and made it the default.
+
+        .. versionchanged:: 6.3
+
+           Renamed from ``set_secure_cookie`` to ``set_signed_cookie`` to
+           avoid confusion with other uses of "secure" in cookie attributes
+           and prefixes. The old name remains as an alias.
+        """
+        self.set_cookie(
+            name,
+            self.create_signed_value(name, value, version=version),
+            expires_days=expires_days,
+            **kwargs,
+        )
+
+    set_secure_cookie = set_signed_cookie
+
+    def create_signed_value(
+        self, name: str, value: Union[str, bytes], version: Optional[int] = None
+    ) -> bytes:
+        """Signs and timestamps a string so it cannot be forged.
+
+        Normally used via set_signed_cookie, but provided as a separate
+        method for non-cookie uses.  To decode a value not stored
+        as a cookie use the optional value argument to get_signed_cookie.
+
+        .. versionchanged:: 3.2.1
+
+           Added the ``version`` argument.  Introduced cookie version 2
+           and made it the default.
+        """
+        self.require_setting("cookie_secret", "secure cookies")
+        secret = self.application.settings["cookie_secret"]
+        key_version = None
+        if isinstance(secret, dict):
+            if self.application.settings.get("key_version") is None:
+                raise Exception("key_version setting must be used for secret_key dicts")
+            key_version = self.application.settings["key_version"]
+
+        return create_signed_value(
+            secret, name, value, version=version, key_version=key_version
+        )
+
+    def get_signed_cookie(
+        self,
+        name: str,
+        value: Optional[str] = None,
+        max_age_days: float = 31,
+        min_version: Optional[int] = None,
+    ) -> Optional[bytes]:
+        """Returns the given signed cookie if it validates, or None.
+
+        The decoded cookie value is returned as a byte string (unlike
+        `get_cookie`).
+
+        Similar to `get_cookie`, this method only returns cookies that
+        were present in the request. It does not see outgoing cookies set by
+        `set_signed_cookie` in this handler.
+
+        .. versionchanged:: 3.2.1
+
+           Added the ``min_version`` argument.  Introduced cookie version 2;
+           both versions 1 and 2 are accepted by default.
+
+         .. versionchanged:: 6.3
+
+           Renamed from ``get_secure_cookie`` to ``get_signed_cookie`` to
+           avoid confusion with other uses of "secure" in cookie attributes
+           and prefixes. The old name remains as an alias.
+
+        """
+        self.require_setting("cookie_secret", "secure cookies")
+        if value is None:
+            value = self.get_cookie(name)
+        return decode_signed_value(
+            self.application.settings["cookie_secret"],
+            name,
+            value,
+            max_age_days=max_age_days,
+            min_version=min_version,
+        )
+
+    get_secure_cookie = get_signed_cookie
+
+    def get_signed_cookie_key_version(
+        self, name: str, value: Optional[str] = None
+    ) -> Optional[int]:
+        """Returns the signing key version of the secure cookie.
+
+        The version is returned as int.
+
+        .. versionchanged:: 6.3
+
+           Renamed from ``get_secure_cookie_key_version`` to
+           ``set_signed_cookie_key_version`` to avoid confusion with other
+           uses of "secure" in cookie attributes and prefixes. The old name
+           remains as an alias.
+
+        """
+        self.require_setting("cookie_secret", "secure cookies")
+        if value is None:
+            value = self.get_cookie(name)
+        if value is None:
+            return None
+        return get_signature_key_version(value)
+
+    get_secure_cookie_key_version = get_signed_cookie_key_version
+
+    def redirect(
+        self, url: str, permanent: bool = False, status: Optional[int] = None
+    ) -> None:
+        """Sends a redirect to the given (optionally relative) URL.
+
+        If the ``status`` argument is specified, that value is used as the
+        HTTP status code; otherwise either 301 (permanent) or 302
+        (temporary) is chosen based on the ``permanent`` argument.
+        The default is 302 (temporary).
+        """
+        if self._headers_written:
+            raise Exception("Cannot redirect after headers have been written")
+        if status is None:
+            status = 301 if permanent else 302
+        else:
+            assert isinstance(status, int) and 300 <= status <= 399
+        self.set_status(status)
+        self.set_header("Location", utf8(url))
+        self.finish()
+
+    def write(self, chunk: Union[str, bytes, dict]) -> None:
+        """Writes the given chunk to the output buffer.
+
+        To write the output to the network, use the `flush()` method below.
+
+        If the given chunk is a dictionary, we write it as JSON and set
+        the Content-Type of the response to be ``application/json``.
+        (if you want to send JSON as a different ``Content-Type``, call
+        ``set_header`` *after* calling ``write()``).
+
+        Note that lists are not converted to JSON because of a potential
+        cross-site security vulnerability.  All JSON output should be
+        wrapped in a dictionary.  More details at
+        http://haacked.com/archive/2009/06/25/json-hijacking.aspx/ and
+        https://github.com/facebook/tornado/issues/1009
+        """
+        if self._finished:
+            raise RuntimeError("Cannot write() after finish()")
+        if not isinstance(chunk, (bytes, unicode_type, dict)):
+            message = "write() only accepts bytes, unicode, and dict objects"
+            if isinstance(chunk, list):
+                message += (
+                    ". Lists not accepted for security reasons; see "
+                    + "http://www.tornadoweb.org/en/stable/web.html#tornado.web.RequestHandler.write"  # noqa: E501
+                )
+            raise TypeError(message)
+        if isinstance(chunk, dict):
+            chunk = escape.json_encode(chunk)
+            self.set_header("Content-Type", "application/json; charset=UTF-8")
+        chunk = utf8(chunk)
+        self._write_buffer.append(chunk)
+
+    def render(self, template_name: str, **kwargs: Any) -> "Future[None]":
+        """Renders the template with the given arguments as the response.
+
+        ``render()`` calls ``finish()``, so no other output methods can be called
+        after it.
+
+        Returns a `.Future` with the same semantics as the one returned by `finish`.
+        Awaiting this `.Future` is optional.
+
+        .. versionchanged:: 5.1
+
+           Now returns a `.Future` instead of ``None``.
+        """
+        if self._finished:
+            raise RuntimeError("Cannot render() after finish()")
+        html = self.render_string(template_name, **kwargs)
+
+        # Insert the additional JS and CSS added by the modules on the page
+        js_embed = []
+        js_files = []
+        css_embed = []
+        css_files = []
+        html_heads = []
+        html_bodies = []
+        for module in getattr(self, "_active_modules", {}).values():
+            embed_part = module.embedded_javascript()
+            if embed_part:
+                js_embed.append(utf8(embed_part))
+            file_part = module.javascript_files()
+            if file_part:
+                if isinstance(file_part, (unicode_type, bytes)):
+                    js_files.append(_unicode(file_part))
+                else:
+                    js_files.extend(file_part)
+            embed_part = module.embedded_css()
+            if embed_part:
+                css_embed.append(utf8(embed_part))
+            file_part = module.css_files()
+            if file_part:
+                if isinstance(file_part, (unicode_type, bytes)):
+                    css_files.append(_unicode(file_part))
+                else:
+                    css_files.extend(file_part)
+            head_part = module.html_head()
+            if head_part:
+                html_heads.append(utf8(head_part))
+            body_part = module.html_body()
+            if body_part:
+                html_bodies.append(utf8(body_part))
+
+        if js_files:
+            # Maintain order of JavaScript files given by modules
+            js = self.render_linked_js(js_files)
+            sloc = html.rindex(b"")
+            html = html[:sloc] + utf8(js) + b"\n" + html[sloc:]
+        if js_embed:
+            js_bytes = self.render_embed_js(js_embed)
+            sloc = html.rindex(b"")
+            html = html[:sloc] + js_bytes + b"\n" + html[sloc:]
+        if css_files:
+            css = self.render_linked_css(css_files)
+            hloc = html.index(b"")
+            html = html[:hloc] + utf8(css) + b"\n" + html[hloc:]
+        if css_embed:
+            css_bytes = self.render_embed_css(css_embed)
+            hloc = html.index(b"")
+            html = html[:hloc] + css_bytes + b"\n" + html[hloc:]
+        if html_heads:
+            hloc = html.index(b"")
+            html = html[:hloc] + b"".join(html_heads) + b"\n" + html[hloc:]
+        if html_bodies:
+            hloc = html.index(b"")
+            html = html[:hloc] + b"".join(html_bodies) + b"\n" + html[hloc:]
+        return self.finish(html)
+
+    def render_linked_js(self, js_files: Iterable[str]) -> str:
+        """Default method used to render the final js links for the
+        rendered webpage.
+
+        Override this method in a sub-classed controller to change the output.
+        """
+        paths = []
+        unique_paths = set()  # type: Set[str]
+
+        for path in js_files:
+            if not is_absolute(path):
+                path = self.static_url(path)
+            if path not in unique_paths:
+                paths.append(path)
+                unique_paths.add(path)
+
+        return "".join(
+            ''
+            for p in paths
+        )
+
+    def render_embed_js(self, js_embed: Iterable[bytes]) -> bytes:
+        """Default method used to render the final embedded js for the
+        rendered webpage.
+
+        Override this method in a sub-classed controller to change the output.
+        """
+        return (
+            b'"
+        )
+
+    def render_linked_css(self, css_files: Iterable[str]) -> str:
+        """Default method used to render the final css links for the
+        rendered webpage.
+
+        Override this method in a sub-classed controller to change the output.
+        """
+        paths = []
+        unique_paths = set()  # type: Set[str]
+
+        for path in css_files:
+            if not is_absolute(path):
+                path = self.static_url(path)
+            if path not in unique_paths:
+                paths.append(path)
+                unique_paths.add(path)
+
+        return "".join(
+            ''
+            for p in paths
+        )
+
+    def render_embed_css(self, css_embed: Iterable[bytes]) -> bytes:
+        """Default method used to render the final embedded css for the
+        rendered webpage.
+
+        Override this method in a sub-classed controller to change the output.
+        """
+        return b'"
+
+    def render_string(self, template_name: str, **kwargs: Any) -> bytes:
+        """Generate the given template with the given arguments.
+
+        We return the generated byte string (in utf8). To generate and
+        write a template as a response, use render() above.
+        """
+        # If no template_path is specified, use the path of the calling file
+        template_path = self.get_template_path()
+        if not template_path:
+            frame = sys._getframe(0)
+            web_file = frame.f_code.co_filename
+            while frame.f_code.co_filename == web_file and frame.f_back is not None:
+                frame = frame.f_back
+            assert frame.f_code.co_filename is not None
+            template_path = os.path.dirname(frame.f_code.co_filename)
+        with RequestHandler._template_loader_lock:
+            if template_path not in RequestHandler._template_loaders:
+                loader = self.create_template_loader(template_path)
+                RequestHandler._template_loaders[template_path] = loader
+            else:
+                loader = RequestHandler._template_loaders[template_path]
+        t = loader.load(template_name)
+        namespace = self.get_template_namespace()
+        namespace.update(kwargs)
+        return t.generate(**namespace)
+
+    def get_template_namespace(self) -> Dict[str, Any]:
+        """Returns a dictionary to be used as the default template namespace.
+
+        May be overridden by subclasses to add or modify values.
+
+        The results of this method will be combined with additional
+        defaults in the `tornado.template` module and keyword arguments
+        to `render` or `render_string`.
+        """
+        namespace = dict(
+            handler=self,
+            request=self.request,
+            current_user=self.current_user,
+            locale=self.locale,
+            _=self.locale.translate,
+            pgettext=self.locale.pgettext,
+            static_url=self.static_url,
+            xsrf_form_html=self.xsrf_form_html,
+            reverse_url=self.reverse_url,
+        )
+        namespace.update(self.ui)
+        return namespace
+
+    def create_template_loader(self, template_path: str) -> template.BaseLoader:
+        """Returns a new template loader for the given path.
+
+        May be overridden by subclasses.  By default returns a
+        directory-based loader on the given path, using the
+        ``autoescape`` and ``template_whitespace`` application
+        settings.  If a ``template_loader`` application setting is
+        supplied, uses that instead.
+        """
+        settings = self.application.settings
+        if "template_loader" in settings:
+            return settings["template_loader"]
+        kwargs = {}
+        if "autoescape" in settings:
+            # autoescape=None means "no escaping", so we have to be sure
+            # to only pass this kwarg if the user asked for it.
+            kwargs["autoescape"] = settings["autoescape"]
+        if "template_whitespace" in settings:
+            kwargs["whitespace"] = settings["template_whitespace"]
+        return template.Loader(template_path, **kwargs)
+
+    def flush(self, include_footers: bool = False) -> "Future[None]":
+        """Flushes the current output buffer to the network.
+
+        .. versionchanged:: 4.0
+           Now returns a `.Future` if no callback is given.
+
+        .. versionchanged:: 6.0
+
+           The ``callback`` argument was removed.
+        """
+        assert self.request.connection is not None
+        chunk = b"".join(self._write_buffer)
+        self._write_buffer = []
+        if not self._headers_written:
+            self._headers_written = True
+            for transform in self._transforms:
+                assert chunk is not None
+                (
+                    self._status_code,
+                    self._headers,
+                    chunk,
+                ) = transform.transform_first_chunk(
+                    self._status_code, self._headers, chunk, include_footers
+                )
+            # Ignore the chunk and only write the headers for HEAD requests
+            if self.request.method == "HEAD":
+                chunk = b""
+
+            # Finalize the cookie headers (which have been stored in a side
+            # object so an outgoing cookie could be overwritten before it
+            # is sent).
+            if hasattr(self, "_new_cookie"):
+                for cookie in self._new_cookie.values():
+                    self.add_header("Set-Cookie", cookie.OutputString(None))
+
+            start_line = httputil.ResponseStartLine("", self._status_code, self._reason)
+            return self.request.connection.write_headers(
+                start_line, self._headers, chunk
+            )
+        else:
+            for transform in self._transforms:
+                chunk = transform.transform_chunk(chunk, include_footers)
+            # Ignore the chunk and only write the headers for HEAD requests
+            if self.request.method != "HEAD":
+                return self.request.connection.write(chunk)
+            else:
+                future = Future()  # type: Future[None]
+                future.set_result(None)
+                return future
+
+    def finish(self, chunk: Optional[Union[str, bytes, dict]] = None) -> "Future[None]":
+        """Finishes this response, ending the HTTP request.
+
+        Passing a ``chunk`` to ``finish()`` is equivalent to passing that
+        chunk to ``write()`` and then calling ``finish()`` with no arguments.
+
+        Returns a `.Future` which may optionally be awaited to track the sending
+        of the response to the client. This `.Future` resolves when all the response
+        data has been sent, and raises an error if the connection is closed before all
+        data can be sent.
+
+        .. versionchanged:: 5.1
+
+           Now returns a `.Future` instead of ``None``.
+        """
+        if self._finished:
+            raise RuntimeError("finish() called twice")
+
+        if chunk is not None:
+            self.write(chunk)
+
+        # Automatically support ETags and add the Content-Length header if
+        # we have not flushed any content yet.
+        if not self._headers_written:
+            if (
+                self._status_code == 200
+                and self.request.method in ("GET", "HEAD")
+                and "Etag" not in self._headers
+            ):
+                self.set_etag_header()
+                if self.check_etag_header():
+                    self._write_buffer = []
+                    self.set_status(304)
+            if self._status_code in (204, 304) or (100 <= self._status_code < 200):
+                assert not self._write_buffer, (
+                    "Cannot send body with %s" % self._status_code
+                )
+                self._clear_representation_headers()
+            elif "Content-Length" not in self._headers:
+                content_length = sum(len(part) for part in self._write_buffer)
+                self.set_header("Content-Length", content_length)
+
+        assert self.request.connection is not None
+        # Now that the request is finished, clear the callback we
+        # set on the HTTPConnection (which would otherwise prevent the
+        # garbage collection of the RequestHandler when there
+        # are keepalive connections)
+        self.request.connection.set_close_callback(None)  # type: ignore
+
+        future = self.flush(include_footers=True)
+        self.request.connection.finish()
+        self._log()
+        self._finished = True
+        self.on_finish()
+        self._break_cycles()
+        return future
+
+    def detach(self) -> iostream.IOStream:
+        """Take control of the underlying stream.
+
+        Returns the underlying `.IOStream` object and stops all
+        further HTTP processing. Intended for implementing protocols
+        like websockets that tunnel over an HTTP handshake.
+
+        This method is only supported when HTTP/1.1 is used.
+
+        .. versionadded:: 5.1
+        """
+        self._finished = True
+        # TODO: add detach to HTTPConnection?
+        return self.request.connection.detach()  # type: ignore
+
+    def _break_cycles(self) -> None:
+        # Break up a reference cycle between this handler and the
+        # _ui_module closures to allow for faster GC on CPython.
+        self.ui = None  # type: ignore
+
+    def send_error(self, status_code: int = 500, **kwargs: Any) -> None:
+        """Sends the given HTTP error code to the browser.
+
+        If `flush()` has already been called, it is not possible to send
+        an error, so this method will simply terminate the response.
+        If output has been written but not yet flushed, it will be discarded
+        and replaced with the error page.
+
+        Override `write_error()` to customize the error page that is returned.
+        Additional keyword arguments are passed through to `write_error`.
+        """
+        if self._headers_written:
+            gen_log.error("Cannot send error response after headers written")
+            if not self._finished:
+                # If we get an error between writing headers and finishing,
+                # we are unlikely to be able to finish due to a
+                # Content-Length mismatch. Try anyway to release the
+                # socket.
+                try:
+                    self.finish()
+                except Exception:
+                    gen_log.error("Failed to flush partial response", exc_info=True)
+            return
+        self.clear()
+
+        reason = kwargs.get("reason")
+        if "exc_info" in kwargs:
+            exception = kwargs["exc_info"][1]
+            if isinstance(exception, HTTPError) and exception.reason:
+                reason = exception.reason
+        self.set_status(status_code, reason=reason)
+        try:
+            if status_code != 304:
+                self.write_error(status_code, **kwargs)
+        except Exception:
+            app_log.error("Uncaught exception in write_error", exc_info=True)
+        if not self._finished:
+            self.finish()
+
+    def write_error(self, status_code: int, **kwargs: Any) -> None:
+        """Override to implement custom error pages.
+
+        ``write_error`` may call `write`, `render`, `set_header`, etc
+        to produce output as usual.
+
+        If this error was caused by an uncaught exception (including
+        HTTPError), an ``exc_info`` triple will be available as
+        ``kwargs["exc_info"]``.  Note that this exception may not be
+        the "current" exception for purposes of methods like
+        ``sys.exc_info()`` or ``traceback.format_exc``.
+        """
+        if self.settings.get("serve_traceback") and "exc_info" in kwargs:
+            # in debug mode, try to send a traceback
+            self.set_header("Content-Type", "text/plain")
+            for line in traceback.format_exception(*kwargs["exc_info"]):
+                self.write(line)
+            self.finish()
+        else:
+            self.finish(
+                "%(code)d: %(message)s"
+                "%(code)d: %(message)s"
+                % {"code": status_code, "message": escape.xhtml_escape(self._reason)}
+            )
+
+    @property
+    def locale(self) -> tornado.locale.Locale:
+        """The locale for the current session.
+
+        Determined by either `get_user_locale`, which you can override to
+        set the locale based on, e.g., a user preference stored in a
+        database, or `get_browser_locale`, which uses the ``Accept-Language``
+        header.
+
+        .. versionchanged: 4.1
+           Added a property setter.
+        """
+        if not hasattr(self, "_locale"):
+            loc = self.get_user_locale()
+            if loc is not None:
+                self._locale = loc
+            else:
+                self._locale = self.get_browser_locale()
+                assert self._locale
+        return self._locale
+
+    @locale.setter
+    def locale(self, value: tornado.locale.Locale) -> None:
+        self._locale = value
+
+    def get_user_locale(self) -> Optional[tornado.locale.Locale]:
+        """Override to determine the locale from the authenticated user.
+
+        If None is returned, we fall back to `get_browser_locale()`.
+
+        This method should return a `tornado.locale.Locale` object,
+        most likely obtained via a call like ``tornado.locale.get("en")``
+        """
+        return None
+
+    def get_browser_locale(self, default: str = "en_US") -> tornado.locale.Locale:
+        """Determines the user's locale from ``Accept-Language`` header.
+
+        See http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.4
+        """
+        if "Accept-Language" in self.request.headers:
+            languages = self.request.headers["Accept-Language"].split(",")
+            locales = []
+            for language in languages:
+                parts = language.strip().split(";")
+                if len(parts) > 1 and parts[1].strip().startswith("q="):
+                    try:
+                        score = float(parts[1].strip()[2:])
+                        if score < 0:
+                            raise ValueError()
+                    except (ValueError, TypeError):
+                        score = 0.0
+                else:
+                    score = 1.0
+                if score > 0:
+                    locales.append((parts[0], score))
+            if locales:
+                locales.sort(key=lambda pair: pair[1], reverse=True)
+                codes = [loc[0] for loc in locales]
+                return locale.get(*codes)
+        return locale.get(default)
+
+    @property
+    def current_user(self) -> Any:
+        """The authenticated user for this request.
+
+        This is set in one of two ways:
+
+        * A subclass may override `get_current_user()`, which will be called
+          automatically the first time ``self.current_user`` is accessed.
+          `get_current_user()` will only be called once per request,
+          and is cached for future access::
+
+              def get_current_user(self):
+                  user_cookie = self.get_signed_cookie("user")
+                  if user_cookie:
+                      return json.loads(user_cookie)
+                  return None
+
+        * It may be set as a normal variable, typically from an overridden
+          `prepare()`::
+
+              @gen.coroutine
+              def prepare(self):
+                  user_id_cookie = self.get_signed_cookie("user_id")
+                  if user_id_cookie:
+                      self.current_user = yield load_user(user_id_cookie)
+
+        Note that `prepare()` may be a coroutine while `get_current_user()`
+        may not, so the latter form is necessary if loading the user requires
+        asynchronous operations.
+
+        The user object may be any type of the application's choosing.
+        """
+        if not hasattr(self, "_current_user"):
+            self._current_user = self.get_current_user()
+        return self._current_user
+
+    @current_user.setter
+    def current_user(self, value: Any) -> None:
+        self._current_user = value
+
+    def get_current_user(self) -> Any:
+        """Override to determine the current user from, e.g., a cookie.
+
+        This method may not be a coroutine.
+        """
+        return None
+
+    def get_login_url(self) -> str:
+        """Override to customize the login URL based on the request.
+
+        By default, we use the ``login_url`` application setting.
+        """
+        self.require_setting("login_url", "@tornado.web.authenticated")
+        return self.application.settings["login_url"]
+
+    def get_template_path(self) -> Optional[str]:
+        """Override to customize template path for each handler.
+
+        By default, we use the ``template_path`` application setting.
+        Return None to load templates relative to the calling file.
+        """
+        return self.application.settings.get("template_path")
+
+    @property
+    def xsrf_token(self) -> bytes:
+        """The XSRF-prevention token for the current user/session.
+
+        To prevent cross-site request forgery, we set an '_xsrf' cookie
+        and include the same '_xsrf' value as an argument with all POST
+        requests. If the two do not match, we reject the form submission
+        as a potential forgery.
+
+        See http://en.wikipedia.org/wiki/Cross-site_request_forgery
+
+        This property is of type `bytes`, but it contains only ASCII
+        characters. If a character string is required, there is no
+        need to base64-encode it; just decode the byte string as
+        UTF-8.
+
+        .. versionchanged:: 3.2.2
+           The xsrf token will now be have a random mask applied in every
+           request, which makes it safe to include the token in pages
+           that are compressed.  See http://breachattack.com for more
+           information on the issue fixed by this change.  Old (version 1)
+           cookies will be converted to version 2 when this method is called
+           unless the ``xsrf_cookie_version`` `Application` setting is
+           set to 1.
+
+        .. versionchanged:: 4.3
+           The ``xsrf_cookie_kwargs`` `Application` setting may be
+           used to supply additional cookie options (which will be
+           passed directly to `set_cookie`). For example,
+           ``xsrf_cookie_kwargs=dict(httponly=True, secure=True)``
+           will set the ``secure`` and ``httponly`` flags on the
+           ``_xsrf`` cookie.
+        """
+        if not hasattr(self, "_xsrf_token"):
+            version, token, timestamp = self._get_raw_xsrf_token()
+            output_version = self.settings.get("xsrf_cookie_version", 2)
+            cookie_kwargs = self.settings.get("xsrf_cookie_kwargs", {})
+            if output_version == 1:
+                self._xsrf_token = binascii.b2a_hex(token)
+            elif output_version == 2:
+                mask = os.urandom(4)
+                self._xsrf_token = b"|".join(
+                    [
+                        b"2",
+                        binascii.b2a_hex(mask),
+                        binascii.b2a_hex(_websocket_mask(mask, token)),
+                        utf8(str(int(timestamp))),
+                    ]
+                )
+            else:
+                raise ValueError("unknown xsrf cookie version %d", output_version)
+            if version is None:
+                if self.current_user and "expires_days" not in cookie_kwargs:
+                    cookie_kwargs["expires_days"] = 30
+                cookie_name = self.settings.get("xsrf_cookie_name", "_xsrf")
+                self.set_cookie(cookie_name, self._xsrf_token, **cookie_kwargs)
+        return self._xsrf_token
+
+    def _get_raw_xsrf_token(self) -> Tuple[Optional[int], bytes, float]:
+        """Read or generate the xsrf token in its raw form.
+
+        The raw_xsrf_token is a tuple containing:
+
+        * version: the version of the cookie from which this token was read,
+          or None if we generated a new token in this request.
+        * token: the raw token data; random (non-ascii) bytes.
+        * timestamp: the time this token was generated (will not be accurate
+          for version 1 cookies)
+        """
+        if not hasattr(self, "_raw_xsrf_token"):
+            cookie_name = self.settings.get("xsrf_cookie_name", "_xsrf")
+            cookie = self.get_cookie(cookie_name)
+            if cookie:
+                version, token, timestamp = self._decode_xsrf_token(cookie)
+            else:
+                version, token, timestamp = None, None, None
+            if token is None:
+                version = None
+                token = os.urandom(16)
+                timestamp = time.time()
+            assert token is not None
+            assert timestamp is not None
+            self._raw_xsrf_token = (version, token, timestamp)
+        return self._raw_xsrf_token
+
+    def _decode_xsrf_token(
+        self, cookie: str
+    ) -> Tuple[Optional[int], Optional[bytes], Optional[float]]:
+        """Convert a cookie string into a the tuple form returned by
+        _get_raw_xsrf_token.
+        """
+
+        try:
+            m = _signed_value_version_re.match(utf8(cookie))
+
+            if m:
+                version = int(m.group(1))
+                if version == 2:
+                    _, mask_str, masked_token, timestamp_str = cookie.split("|")
+
+                    mask = binascii.a2b_hex(utf8(mask_str))
+                    token = _websocket_mask(mask, binascii.a2b_hex(utf8(masked_token)))
+                    timestamp = int(timestamp_str)
+                    return version, token, timestamp
+                else:
+                    # Treat unknown versions as not present instead of failing.
+                    raise Exception("Unknown xsrf cookie version")
+            else:
+                version = 1
+                try:
+                    token = binascii.a2b_hex(utf8(cookie))
+                except (binascii.Error, TypeError):
+                    token = utf8(cookie)
+                # We don't have a usable timestamp in older versions.
+                timestamp = int(time.time())
+                return (version, token, timestamp)
+        except Exception:
+            # Catch exceptions and return nothing instead of failing.
+            gen_log.debug("Uncaught exception in _decode_xsrf_token", exc_info=True)
+            return None, None, None
+
+    def check_xsrf_cookie(self) -> None:
+        """Verifies that the ``_xsrf`` cookie matches the ``_xsrf`` argument.
+
+        To prevent cross-site request forgery, we set an ``_xsrf``
+        cookie and include the same value as a non-cookie
+        field with all ``POST`` requests. If the two do not match, we
+        reject the form submission as a potential forgery.
+
+        The ``_xsrf`` value may be set as either a form field named ``_xsrf``
+        or in a custom HTTP header named ``X-XSRFToken`` or ``X-CSRFToken``
+        (the latter is accepted for compatibility with Django).
+
+        See http://en.wikipedia.org/wiki/Cross-site_request_forgery
+
+        .. versionchanged:: 3.2.2
+           Added support for cookie version 2.  Both versions 1 and 2 are
+           supported.
+        """
+        # Prior to release 1.1.1, this check was ignored if the HTTP header
+        # ``X-Requested-With: XMLHTTPRequest`` was present.  This exception
+        # has been shown to be insecure and has been removed.  For more
+        # information please see
+        # http://www.djangoproject.com/weblog/2011/feb/08/security/
+        # http://weblog.rubyonrails.org/2011/2/8/csrf-protection-bypass-in-ruby-on-rails
+        input_token = (
+            self.get_argument("_xsrf", None)
+            or self.request.headers.get("X-Xsrftoken")
+            or self.request.headers.get("X-Csrftoken")
+        )
+        if not input_token:
+            raise HTTPError(403, "'_xsrf' argument missing from POST")
+        _, token, _ = self._decode_xsrf_token(input_token)
+        _, expected_token, _ = self._get_raw_xsrf_token()
+        if not token:
+            raise HTTPError(403, "'_xsrf' argument has invalid format")
+        if not hmac.compare_digest(utf8(token), utf8(expected_token)):
+            raise HTTPError(403, "XSRF cookie does not match POST argument")
+
+    def xsrf_form_html(self) -> str:
+        """An HTML ```` element to be included with all POST forms.
+
+        It defines the ``_xsrf`` input value, which we check on all POST
+        requests to prevent cross-site request forgery. If you have set
+        the ``xsrf_cookies`` application setting, you must include this
+        HTML within all of your HTML forms.
+
+        In a template, this method should be called with ``{% module
+        xsrf_form_html() %}``
+
+        See `check_xsrf_cookie()` above for more information.
+        """
+        return (
+            ''
+        )
+
+    def static_url(
+        self, path: str, include_host: Optional[bool] = None, **kwargs: Any
+    ) -> str:
+        """Returns a static URL for the given relative static file path.
+
+        This method requires you set the ``static_path`` setting in your
+        application (which specifies the root directory of your static
+        files).
+
+        This method returns a versioned url (by default appending
+        ``?v=``), which allows the static files to be
+        cached indefinitely.  This can be disabled by passing
+        ``include_version=False`` (in the default implementation;
+        other static file implementations are not required to support
+        this, but they may support other options).
+
+        By default this method returns URLs relative to the current
+        host, but if ``include_host`` is true the URL returned will be
+        absolute.  If this handler has an ``include_host`` attribute,
+        that value will be used as the default for all `static_url`
+        calls that do not pass ``include_host`` as a keyword argument.
+
+        """
+        self.require_setting("static_path", "static_url")
+        get_url = self.settings.get(
+            "static_handler_class", StaticFileHandler
+        ).make_static_url
+
+        if include_host is None:
+            include_host = getattr(self, "include_host", False)
+
+        if include_host:
+            base = self.request.protocol + "://" + self.request.host
+        else:
+            base = ""
+
+        return base + get_url(self.settings, path, **kwargs)
+
+    def require_setting(self, name: str, feature: str = "this feature") -> None:
+        """Raises an exception if the given app setting is not defined."""
+        if not self.application.settings.get(name):
+            raise Exception(
+                "You must define the '%s' setting in your "
+                "application to use %s" % (name, feature)
+            )
+
+    def reverse_url(self, name: str, *args: Any) -> str:
+        """Alias for `Application.reverse_url`."""
+        return self.application.reverse_url(name, *args)
+
+    def compute_etag(self) -> Optional[str]:
+        """Computes the etag header to be used for this request.
+
+        By default uses a hash of the content written so far.
+
+        May be overridden to provide custom etag implementations,
+        or may return None to disable tornado's default etag support.
+        """
+        hasher = hashlib.sha1()
+        for part in self._write_buffer:
+            hasher.update(part)
+        return '"%s"' % hasher.hexdigest()
+
+    def set_etag_header(self) -> None:
+        """Sets the response's Etag header using ``self.compute_etag()``.
+
+        Note: no header will be set if ``compute_etag()`` returns ``None``.
+
+        This method is called automatically when the request is finished.
+        """
+        etag = self.compute_etag()
+        if etag is not None:
+            self.set_header("Etag", etag)
+
+    def check_etag_header(self) -> bool:
+        """Checks the ``Etag`` header against requests's ``If-None-Match``.
+
+        Returns ``True`` if the request's Etag matches and a 304 should be
+        returned. For example::
+
+            self.set_etag_header()
+            if self.check_etag_header():
+                self.set_status(304)
+                return
+
+        This method is called automatically when the request is finished,
+        but may be called earlier for applications that override
+        `compute_etag` and want to do an early check for ``If-None-Match``
+        before completing the request.  The ``Etag`` header should be set
+        (perhaps with `set_etag_header`) before calling this method.
+        """
+        computed_etag = utf8(self._headers.get("Etag", ""))
+        # Find all weak and strong etag values from If-None-Match header
+        # because RFC 7232 allows multiple etag values in a single header.
+        etags = re.findall(
+            rb'\*|(?:W/)?"[^"]*"', utf8(self.request.headers.get("If-None-Match", ""))
+        )
+        if not computed_etag or not etags:
+            return False
+
+        match = False
+        if etags[0] == b"*":
+            match = True
+        else:
+            # Use a weak comparison when comparing entity-tags.
+            def val(x: bytes) -> bytes:
+                return x[2:] if x.startswith(b"W/") else x
+
+            for etag in etags:
+                if val(etag) == val(computed_etag):
+                    match = True
+                    break
+        return match
+
+    async def _execute(
+        self, transforms: List["OutputTransform"], *args: bytes, **kwargs: bytes
+    ) -> None:
+        """Executes this request with the given output transforms."""
+        self._transforms = transforms
+        try:
+            if self.request.method not in self.SUPPORTED_METHODS:
+                raise HTTPError(405)
+
+            # If we're not in stream_request_body mode, this is the place where we parse the body.
+            if not _has_stream_request_body(self.__class__):
+                try:
+                    self.request._parse_body()
+                except httputil.HTTPInputError as e:
+                    raise HTTPError(400, "Invalid body: %s" % e) from e
+
+            self.path_args = [self.decode_argument(arg) for arg in args]
+            self.path_kwargs = {
+                k: self.decode_argument(v, name=k) for (k, v) in kwargs.items()
+            }
+            # If XSRF cookies are turned on, reject form submissions without
+            # the proper cookie
+            if self.request.method not in (
+                "GET",
+                "HEAD",
+                "OPTIONS",
+            ) and self.application.settings.get("xsrf_cookies"):
+                self.check_xsrf_cookie()
+
+            result = self.prepare()
+            if result is not None:
+                result = await result  # type: ignore
+            if self._prepared_future is not None:
+                # Tell the Application we've finished with prepare()
+                # and are ready for the body to arrive.
+                future_set_result_unless_cancelled(self._prepared_future, None)
+            if self._finished:
+                return
+
+            if _has_stream_request_body(self.__class__):
+                # In streaming mode request.body is a Future that signals
+                # the body has been completely received.  The Future has no
+                # result; the data has been passed to self.data_received
+                # instead.
+                try:
+                    await self.request._body_future
+                except iostream.StreamClosedError:
+                    return
+
+            method = getattr(self, self.request.method.lower())
+            result = method(*self.path_args, **self.path_kwargs)
+            if result is not None:
+                result = await result
+            if self._auto_finish and not self._finished:
+                self.finish()
+        except Exception as e:
+            try:
+                self._handle_request_exception(e)
+            except Exception:
+                app_log.error("Exception in exception handler", exc_info=True)
+            finally:
+                # Unset result to avoid circular references
+                result = None
+            if self._prepared_future is not None and not self._prepared_future.done():
+                # In case we failed before setting _prepared_future, do it
+                # now (to unblock the HTTP server).  Note that this is not
+                # in a finally block to avoid GC issues prior to Python 3.4.
+                self._prepared_future.set_result(None)
+
+    def data_received(self, chunk: bytes) -> Optional[Awaitable[None]]:
+        """Implement this method to handle streamed request data.
+
+        Requires the `.stream_request_body` decorator.
+
+        May be a coroutine for flow control.
+        """
+        raise NotImplementedError()
+
+    def _log(self) -> None:
+        """Logs the current request.
+
+        Sort of deprecated since this functionality was moved to the
+        Application, but left in place for the benefit of existing apps
+        that have overridden this method.
+        """
+        self.application.log_request(self)
+
+    def _request_summary(self) -> str:
+        return "{} {} ({})".format(
+            self.request.method,
+            self.request.uri,
+            self.request.remote_ip,
+        )
+
+    def _handle_request_exception(self, e: BaseException) -> None:
+        if isinstance(e, Finish):
+            # Not an error; just finish the request without logging.
+            if not self._finished:
+                self.finish(*e.args)
+            return
+        try:
+            self.log_exception(*sys.exc_info())
+        except Exception:
+            # An error here should still get a best-effort send_error()
+            # to avoid leaking the connection.
+            app_log.error("Error in exception logger", exc_info=True)
+        if self._finished:
+            # Extra errors after the request has been finished should
+            # be logged, but there is no reason to continue to try and
+            # send a response.
+            return
+        if isinstance(e, HTTPError):
+            self.send_error(e.status_code, exc_info=sys.exc_info())
+        else:
+            self.send_error(500, exc_info=sys.exc_info())
+
+    def log_exception(
+        self,
+        typ: "Optional[Type[BaseException]]",
+        value: Optional[BaseException],
+        tb: Optional[TracebackType],
+    ) -> None:
+        """Override to customize logging of uncaught exceptions.
+
+        By default logs instances of `HTTPError` as warnings without
+        stack traces (on the ``tornado.general`` logger), and all
+        other exceptions as errors with stack traces (on the
+        ``tornado.application`` logger).
+
+        .. versionadded:: 3.1
+        """
+        if isinstance(value, HTTPError):
+            log_message = value.get_message()
+            if log_message:
+                format = "%d %s: %s"
+                args = [value.status_code, self._request_summary(), log_message]
+                gen_log.warning(format, *args)
+        else:
+            app_log.error(
+                "Uncaught exception %s\n%r",
+                self._request_summary(),
+                self.request,
+                exc_info=(typ, value, tb),  # type: ignore
+            )
+
+    def _ui_module(self, name: str, module: Type["UIModule"]) -> Callable[..., str]:
+        def render(*args, **kwargs) -> str:  # type: ignore
+            if not hasattr(self, "_active_modules"):
+                self._active_modules = {}  # type: Dict[str, UIModule]
+            if name not in self._active_modules:
+                self._active_modules[name] = module(self)
+            rendered = self._active_modules[name].render(*args, **kwargs)
+            return _unicode(rendered)
+
+        return render
+
+    def _ui_method(self, method: Callable[..., str]) -> Callable[..., str]:
+        return lambda *args, **kwargs: method(self, *args, **kwargs)
+
+    def _clear_representation_headers(self) -> None:
+        # 304 responses should not contain representation metadata
+        # headers (defined in
+        # https://tools.ietf.org/html/rfc7231#section-3.1)
+        # not explicitly allowed by
+        # https://tools.ietf.org/html/rfc7232#section-4.1
+        headers = ["Content-Encoding", "Content-Language", "Content-Type"]
+        for h in headers:
+            self.clear_header(h)
+
+
+_RequestHandlerType = TypeVar("_RequestHandlerType", bound=RequestHandler)
+
+
+def stream_request_body(cls: Type[_RequestHandlerType]) -> Type[_RequestHandlerType]:
+    """Apply to `RequestHandler` subclasses to enable streaming body support.
+
+    This decorator implies the following changes:
+
+    * `.HTTPServerRequest.body` is undefined, and body arguments will not
+      be included in `RequestHandler.get_argument`.
+    * `RequestHandler.prepare` is called when the request headers have been
+      read instead of after the entire body has been read.
+    * The subclass must define a method ``data_received(self, data):``, which
+      will be called zero or more times as data is available.  Note that
+      if the request has an empty body, ``data_received`` may not be called.
+    * ``prepare`` and ``data_received`` may return Futures (such as via
+      ``@gen.coroutine``, in which case the next method will not be called
+      until those futures have completed.
+    * The regular HTTP method (``post``, ``put``, etc) will be called after
+      the entire body has been read.
+
+    See the `file receiver demo `_
+    for example usage.
+    """  # noqa: E501
+    if not issubclass(cls, RequestHandler):
+        raise TypeError("expected subclass of RequestHandler, got %r", cls)
+    cls._stream_request_body = True
+    return cls
+
+
+def _has_stream_request_body(cls: Type[RequestHandler]) -> bool:
+    if not issubclass(cls, RequestHandler):
+        raise TypeError("expected subclass of RequestHandler, got %r", cls)
+    return cls._stream_request_body
+
+
+def removeslash(
+    method: Callable[..., Optional[Awaitable[None]]],
+) -> Callable[..., Optional[Awaitable[None]]]:
+    """Use this decorator to remove trailing slashes from the request path.
+
+    For example, a request to ``/foo/`` would redirect to ``/foo`` with this
+    decorator. Your request handler mapping should use a regular expression
+    like ``r'/foo/*'`` in conjunction with using the decorator.
+    """
+
+    @functools.wraps(method)
+    def wrapper(  # type: ignore
+        self: RequestHandler, *args, **kwargs
+    ) -> Optional[Awaitable[None]]:
+        if self.request.path.endswith("/"):
+            if self.request.method in ("GET", "HEAD"):
+                uri = self.request.path.rstrip("/")
+                if uri:  # don't try to redirect '/' to ''
+                    if self.request.query:
+                        uri += "?" + self.request.query
+                    self.redirect(uri, permanent=True)
+                    return None
+            else:
+                raise HTTPError(404)
+        return method(self, *args, **kwargs)
+
+    return wrapper
+
+
+def addslash(
+    method: Callable[..., Optional[Awaitable[None]]],
+) -> Callable[..., Optional[Awaitable[None]]]:
+    """Use this decorator to add a missing trailing slash to the request path.
+
+    For example, a request to ``/foo`` would redirect to ``/foo/`` with this
+    decorator. Your request handler mapping should use a regular expression
+    like ``r'/foo/?'`` in conjunction with using the decorator.
+    """
+
+    @functools.wraps(method)
+    def wrapper(  # type: ignore
+        self: RequestHandler, *args, **kwargs
+    ) -> Optional[Awaitable[None]]:
+        if not self.request.path.endswith("/"):
+            if self.request.method in ("GET", "HEAD"):
+                uri = self.request.path + "/"
+                if self.request.query:
+                    uri += "?" + self.request.query
+                self.redirect(uri, permanent=True)
+                return None
+            raise HTTPError(404)
+        return method(self, *args, **kwargs)
+
+    return wrapper
+
+
+class _ApplicationRouter(ReversibleRuleRouter):
+    """Routing implementation used internally by `Application`.
+
+    Provides a binding between `Application` and `RequestHandler`.
+    This implementation extends `~.routing.ReversibleRuleRouter` in a couple of ways:
+        * it allows to use `RequestHandler` subclasses as `~.routing.Rule` target and
+        * it allows to use a list/tuple of rules as `~.routing.Rule` target.
+        ``process_rule`` implementation will substitute this list with an appropriate
+        `_ApplicationRouter` instance.
+    """
+
+    def __init__(
+        self, application: "Application", rules: Optional[_RuleList] = None
+    ) -> None:
+        assert isinstance(application, Application)
+        self.application = application
+        super().__init__(rules)
+
+    def process_rule(self, rule: Rule) -> Rule:
+        rule = super().process_rule(rule)
+
+        if isinstance(rule.target, (list, tuple)):
+            rule.target = _ApplicationRouter(
+                self.application, rule.target  # type: ignore
+            )
+
+        return rule
+
+    def get_target_delegate(
+        self, target: Any, request: httputil.HTTPServerRequest, **target_params: Any
+    ) -> Optional[httputil.HTTPMessageDelegate]:
+        if isclass(target) and issubclass(target, RequestHandler):
+            return self.application.get_handler_delegate(
+                request, target, **target_params
+            )
+
+        return super().get_target_delegate(target, request, **target_params)
+
+
+class Application(ReversibleRouter):
+    r"""A collection of request handlers that make up a web application.
+
+    Instances of this class are callable and can be passed directly to
+    HTTPServer to serve the application::
+
+        application = web.Application([
+            (r"/", MainPageHandler),
+        ])
+        http_server = httpserver.HTTPServer(application)
+        http_server.listen(8080)
+
+    The constructor for this class takes in a list of `~.routing.Rule`
+    objects or tuples of values corresponding to the arguments of
+    `~.routing.Rule` constructor: ``(matcher, target, [target_kwargs], [name])``,
+    the values in square brackets being optional. The default matcher is
+    `~.routing.PathMatches`, so ``(regexp, target)`` tuples can also be used
+    instead of ``(PathMatches(regexp), target)``.
+
+    A common routing target is a `RequestHandler` subclass, but you can also
+    use lists of rules as a target, which create a nested routing configuration::
+
+        application = web.Application([
+            (HostMatches("example.com"), [
+                (r"/", MainPageHandler),
+                (r"/feed", FeedHandler),
+            ]),
+        ])
+
+    In addition to this you can use nested `~.routing.Router` instances,
+    `~.httputil.HTTPMessageDelegate` subclasses and callables as routing targets
+    (see `~.routing` module docs for more information).
+
+    When we receive requests, we iterate over the list in order and
+    instantiate an instance of the first request class whose regexp
+    matches the request path. The request class can be specified as
+    either a class object or a (fully-qualified) name.
+
+    A dictionary may be passed as the third element (``target_kwargs``)
+    of the tuple, which will be used as keyword arguments to the handler's
+    constructor and `~RequestHandler.initialize` method. This pattern
+    is used for the `StaticFileHandler` in this example (note that a
+    `StaticFileHandler` can be installed automatically with the
+    static_path setting described below)::
+
+        application = web.Application([
+            (r"/static/(.*)", web.StaticFileHandler, {"path": "/var/www"}),
+        ])
+
+    We support virtual hosts with the `add_handlers` method, which takes in
+    a host regular expression as the first argument::
+
+        application.add_handlers(r"www\.myhost\.com", [
+            (r"/article/([0-9]+)", ArticleHandler),
+        ])
+
+    If there's no match for the current request's host, then ``default_host``
+    parameter value is matched against host regular expressions.
+
+
+    .. warning::
+
+       Applications that do not use TLS may be vulnerable to :ref:`DNS
+       rebinding ` attacks. This attack is especially
+       relevant to applications that only listen on ``127.0.0.1`` or
+       other private networks. Appropriate host patterns must be used
+       (instead of the default of ``r'.*'``) to prevent this risk. The
+       ``default_host`` argument must not be used in applications that
+       may be vulnerable to DNS rebinding.
+
+    You can serve static files by sending the ``static_path`` setting
+    as a keyword argument. We will serve those files from the
+    ``/static/`` URI (this is configurable with the
+    ``static_url_prefix`` setting), and we will serve ``/favicon.ico``
+    and ``/robots.txt`` from the same directory.  A custom subclass of
+    `StaticFileHandler` can be specified with the
+    ``static_handler_class`` setting.
+
+    .. versionchanged:: 4.5
+       Integration with the new `tornado.routing` module.
+
+    """
+
+    def __init__(
+        self,
+        handlers: Optional[_RuleList] = None,
+        default_host: Optional[str] = None,
+        transforms: Optional[List[Type["OutputTransform"]]] = None,
+        **settings: Any,
+    ) -> None:
+        if transforms is None:
+            self.transforms = []  # type: List[Type[OutputTransform]]
+            if settings.get("compress_response") or settings.get("gzip"):
+                self.transforms.append(GZipContentEncoding)
+        else:
+            self.transforms = transforms
+        self.default_host = default_host
+        self.settings = settings
+        self.ui_modules = {
+            "linkify": _linkify,
+            "xsrf_form_html": _xsrf_form_html,
+            "Template": TemplateModule,
+        }
+        self.ui_methods = {}  # type: Dict[str, Callable[..., str]]
+        self._load_ui_modules(settings.get("ui_modules", {}))
+        self._load_ui_methods(settings.get("ui_methods", {}))
+        if self.settings.get("static_path"):
+            path = self.settings["static_path"]
+            handlers = list(handlers or [])
+            static_url_prefix = settings.get("static_url_prefix", "/static/")
+            static_handler_class = settings.get(
+                "static_handler_class", StaticFileHandler
+            )
+            static_handler_args = settings.get("static_handler_args", {})
+            static_handler_args["path"] = path
+            for pattern in [
+                re.escape(static_url_prefix) + r"(.*)",
+                r"/(favicon\.ico)",
+                r"/(robots\.txt)",
+            ]:
+                handlers.insert(0, (pattern, static_handler_class, static_handler_args))
+
+        if self.settings.get("debug"):
+            self.settings.setdefault("autoreload", True)
+            self.settings.setdefault("compiled_template_cache", False)
+            self.settings.setdefault("static_hash_cache", False)
+            self.settings.setdefault("serve_traceback", True)
+
+        self.wildcard_router = _ApplicationRouter(self, handlers)
+        self.default_router = _ApplicationRouter(
+            self, [Rule(AnyMatches(), self.wildcard_router)]
+        )
+
+        # Automatically reload modified modules
+        if self.settings.get("autoreload"):
+            from tornado import autoreload
+
+            autoreload.start()
+
+    def listen(
+        self,
+        port: int,
+        address: Optional[str] = None,
+        *,
+        family: socket.AddressFamily = socket.AF_UNSPEC,
+        backlog: int = tornado.netutil._DEFAULT_BACKLOG,
+        flags: Optional[int] = None,
+        reuse_port: bool = False,
+        **kwargs: Any,
+    ) -> HTTPServer:
+        """Starts an HTTP server for this application on the given port.
+
+        This is a convenience alias for creating an `.HTTPServer` object and
+        calling its listen method.  Keyword arguments not supported by
+        `HTTPServer.listen <.TCPServer.listen>` are passed to the `.HTTPServer`
+        constructor.  For advanced uses (e.g. multi-process mode), do not use
+        this method; create an `.HTTPServer` and call its
+        `.TCPServer.bind`/`.TCPServer.start` methods directly.
+
+        Note that after calling this method you still need to call
+        ``IOLoop.current().start()`` (or run within ``asyncio.run``) to start
+        the server.
+
+        Returns the `.HTTPServer` object.
+
+        .. versionchanged:: 4.3
+           Now returns the `.HTTPServer` object.
+
+        .. versionchanged:: 6.2
+           Added support for new keyword arguments in `.TCPServer.listen`,
+           including ``reuse_port``.
+        """
+        server = HTTPServer(self, **kwargs)
+        server.listen(
+            port,
+            address=address,
+            family=family,
+            backlog=backlog,
+            flags=flags,
+            reuse_port=reuse_port,
+        )
+        return server
+
+    def add_handlers(self, host_pattern: str, host_handlers: _RuleList) -> None:
+        """Appends the given handlers to our handler list.
+
+        Host patterns are processed sequentially in the order they were
+        added. All matching patterns will be considered.
+        """
+        host_matcher = HostMatches(host_pattern)
+        rule = Rule(host_matcher, _ApplicationRouter(self, host_handlers))
+
+        self.default_router.rules.insert(-1, rule)
+
+        if self.default_host is not None:
+            self.wildcard_router.add_rules(
+                [(DefaultHostMatches(self, host_matcher.host_pattern), host_handlers)]
+            )
+
+    def add_transform(self, transform_class: Type["OutputTransform"]) -> None:
+        self.transforms.append(transform_class)
+
+    def _load_ui_methods(self, methods: Any) -> None:
+        if isinstance(methods, types.ModuleType):
+            self._load_ui_methods({n: getattr(methods, n) for n in dir(methods)})
+        elif isinstance(methods, list):
+            for m in methods:
+                self._load_ui_methods(m)
+        else:
+            for name, fn in methods.items():
+                if (
+                    not name.startswith("_")
+                    and hasattr(fn, "__call__")
+                    and name[0].lower() == name[0]
+                ):
+                    self.ui_methods[name] = fn
+
+    def _load_ui_modules(self, modules: Any) -> None:
+        if isinstance(modules, types.ModuleType):
+            self._load_ui_modules({n: getattr(modules, n) for n in dir(modules)})
+        elif isinstance(modules, list):
+            for m in modules:
+                self._load_ui_modules(m)
+        else:
+            assert isinstance(modules, dict)
+            for name, cls in modules.items():
+                try:
+                    if issubclass(cls, UIModule):
+                        self.ui_modules[name] = cls
+                except TypeError:
+                    pass
+
+    def __call__(
+        self, request: httputil.HTTPServerRequest
+    ) -> Optional[Awaitable[None]]:
+        # Legacy HTTPServer interface
+        dispatcher = self.find_handler(request)
+        return dispatcher.execute()
+
+    def find_handler(
+        self, request: httputil.HTTPServerRequest, **kwargs: Any
+    ) -> "_HandlerDelegate":
+        route = self.default_router.find_handler(request)
+        if route is not None:
+            return cast("_HandlerDelegate", route)
+
+        if self.settings.get("default_handler_class"):
+            return self.get_handler_delegate(
+                request,
+                self.settings["default_handler_class"],
+                self.settings.get("default_handler_args", {}),
+            )
+
+        return self.get_handler_delegate(request, ErrorHandler, {"status_code": 404})
+
+    def get_handler_delegate(
+        self,
+        request: httputil.HTTPServerRequest,
+        target_class: Type[RequestHandler],
+        target_kwargs: Optional[Dict[str, Any]] = None,
+        path_args: Optional[List[bytes]] = None,
+        path_kwargs: Optional[Dict[str, bytes]] = None,
+    ) -> "_HandlerDelegate":
+        """Returns `~.httputil.HTTPMessageDelegate` that can serve a request
+        for application and `RequestHandler` subclass.
+
+        :arg httputil.HTTPServerRequest request: current HTTP request.
+        :arg RequestHandler target_class: a `RequestHandler` class.
+        :arg dict target_kwargs: keyword arguments for ``target_class`` constructor.
+        :arg list path_args: positional arguments for ``target_class`` HTTP method that
+            will be executed while handling a request (``get``, ``post`` or any other).
+        :arg dict path_kwargs: keyword arguments for ``target_class`` HTTP method.
+        """
+        return _HandlerDelegate(
+            self, request, target_class, target_kwargs, path_args, path_kwargs
+        )
+
+    def reverse_url(self, name: str, *args: Any) -> str:
+        """Returns a URL path for handler named ``name``
+
+        The handler must be added to the application as a named `URLSpec`.
+
+        Args will be substituted for capturing groups in the `URLSpec` regex.
+        They will be converted to strings if necessary, encoded as utf8,
+        and url-escaped.
+        """
+        reversed_url = self.default_router.reverse_url(name, *args)
+        if reversed_url is not None:
+            return reversed_url
+
+        raise KeyError("%s not found in named urls" % name)
+
+    def log_request(self, handler: RequestHandler) -> None:
+        """Writes a completed HTTP request to the logs.
+
+        By default writes to the python root logger.  To change
+        this behavior either subclass Application and override this method,
+        or pass a function in the application settings dictionary as
+        ``log_function``.
+        """
+        if "log_function" in self.settings:
+            self.settings["log_function"](handler)
+            return
+        if handler.get_status() < 400:
+            log_method = access_log.info
+        elif handler.get_status() < 500:
+            log_method = access_log.warning
+        else:
+            log_method = access_log.error
+        request_time = 1000.0 * handler.request.request_time()
+        log_method(
+            "%d %s %.2fms",
+            handler.get_status(),
+            handler._request_summary(),
+            request_time,
+        )
+
+
+class _HandlerDelegate(httputil.HTTPMessageDelegate):
+    def __init__(
+        self,
+        application: Application,
+        request: httputil.HTTPServerRequest,
+        handler_class: Type[RequestHandler],
+        handler_kwargs: Optional[Dict[str, Any]],
+        path_args: Optional[List[bytes]],
+        path_kwargs: Optional[Dict[str, bytes]],
+    ) -> None:
+        self.application = application
+        self.connection = request.connection
+        self.request = request
+        self.handler_class = handler_class
+        self.handler_kwargs = handler_kwargs or {}
+        self.path_args = path_args or []
+        self.path_kwargs = path_kwargs or {}
+        self.chunks = []  # type: List[bytes]
+        self.stream_request_body = _has_stream_request_body(self.handler_class)
+
+    def headers_received(
+        self,
+        start_line: Union[httputil.RequestStartLine, httputil.ResponseStartLine],
+        headers: httputil.HTTPHeaders,
+    ) -> Optional[Awaitable[None]]:
+        if self.stream_request_body:
+            self.request._body_future = Future()
+            return self.execute()
+        return None
+
+    def data_received(self, data: bytes) -> Optional[Awaitable[None]]:
+        if self.stream_request_body:
+            return self.handler.data_received(data)
+        else:
+            self.chunks.append(data)
+            return None
+
+    def finish(self) -> None:
+        if self.stream_request_body:
+            future_set_result_unless_cancelled(self.request._body_future, None)
+        else:
+            # Note that the body gets parsed in RequestHandler._execute so it can be in
+            # the right exception handler scope.
+            self.request.body = b"".join(self.chunks)
+            self.execute()
+
+    def on_connection_close(self) -> None:
+        if self.stream_request_body:
+            self.handler.on_connection_close()
+        else:
+            self.chunks = None  # type: ignore
+
+    def execute(self) -> Optional[Awaitable[None]]:
+        # If template cache is disabled (usually in the debug mode),
+        # re-compile templates and reload static files on every
+        # request so you don't need to restart to see changes
+        if not self.application.settings.get("compiled_template_cache", True):
+            with RequestHandler._template_loader_lock:
+                for loader in RequestHandler._template_loaders.values():
+                    loader.reset()
+        if not self.application.settings.get("static_hash_cache", True):
+            static_handler_class = self.application.settings.get(
+                "static_handler_class", StaticFileHandler
+            )
+            static_handler_class.reset()
+
+        self.handler = self.handler_class(
+            self.application, self.request, **self.handler_kwargs
+        )
+        transforms = [t(self.request) for t in self.application.transforms]
+
+        if self.stream_request_body:
+            self.handler._prepared_future = Future()
+        # Note that if an exception escapes handler._execute it will be
+        # trapped in the Future it returns (which we are ignoring here,
+        # leaving it to be logged when the Future is GC'd).
+        # However, that shouldn't happen because _execute has a blanket
+        # except handler, and we cannot easily access the IOLoop here to
+        # call add_future (because of the requirement to remain compatible
+        # with WSGI)
+        fut = gen.convert_yielded(
+            self.handler._execute(transforms, *self.path_args, **self.path_kwargs)
+        )
+        fut.add_done_callback(lambda f: f.result())
+        # If we are streaming the request body, then execute() is finished
+        # when the handler has prepared to receive the body.  If not,
+        # it doesn't matter when execute() finishes (so we return None)
+        return self.handler._prepared_future
+
+
+class HTTPError(Exception):
+    """An exception that will turn into an HTTP error response.
+
+    Raising an `HTTPError` is a convenient alternative to calling
+    `RequestHandler.send_error` since it automatically ends the
+    current function.
+
+    To customize the response sent with an `HTTPError`, override
+    `RequestHandler.write_error`.
+
+    :arg int status_code: HTTP status code.  Must be listed in
+        `httplib.responses ` unless the ``reason``
+        keyword argument is given.
+    :arg str log_message: Message to be written to the log for this error
+        (will not be shown to the user unless the `Application` is in debug
+        mode).  May contain ``%s``-style placeholders, which will be filled
+        in with remaining positional parameters.
+    :arg str reason: Keyword-only argument.  The HTTP "reason" phrase
+        to pass in the status line along with ``status_code`` (for example,
+        the "Not Found" in ``HTTP/1.1 404 Not Found``).  Normally
+        determined automatically from ``status_code``, but can be used
+        to use a non-standard numeric code. This is not a general-purpose
+        error message.
+    """
+
+    def __init__(
+        self,
+        status_code: int = 500,
+        log_message: Optional[str] = None,
+        *args: Any,
+        **kwargs: Any,
+    ) -> None:
+        self.status_code = status_code
+        self._log_message = log_message
+        self.args = args
+        self.reason = kwargs.get("reason", None)
+
+    @property
+    def log_message(self) -> Optional[str]:
+        """
+        A backwards compatible way of accessing log_message.
+        """
+        if self._log_message and not self.args:
+            return self._log_message.replace("%", "%%")
+        return self._log_message
+
+    def get_message(self) -> Optional[str]:
+        if self._log_message and self.args:
+            return self._log_message % self.args
+        return self._log_message
+
+    def __str__(self) -> str:
+        message = "HTTP %d: %s" % (
+            self.status_code,
+            self.reason or httputil.responses.get(self.status_code, "Unknown"),
+        )
+        log_message = self.get_message()
+        if log_message:
+            return message + " (" + log_message + ")"
+        else:
+            return message
+
+
+class Finish(Exception):
+    """An exception that ends the request without producing an error response.
+
+    When `Finish` is raised in a `RequestHandler`, the request will
+    end (calling `RequestHandler.finish` if it hasn't already been
+    called), but the error-handling methods (including
+    `RequestHandler.write_error`) will not be called.
+
+    If `Finish()` was created with no arguments, the pending response
+    will be sent as-is. If `Finish()` was given an argument, that
+    argument will be passed to `RequestHandler.finish()`.
+
+    This can be a more convenient way to implement custom error pages
+    than overriding ``write_error`` (especially in library code)::
+
+        if self.current_user is None:
+            self.set_status(401)
+            self.set_header('WWW-Authenticate', 'Basic realm="something"')
+            raise Finish()
+
+    .. versionchanged:: 4.3
+       Arguments passed to ``Finish()`` will be passed on to
+       `RequestHandler.finish`.
+    """
+
+    pass
+
+
+class MissingArgumentError(HTTPError):
+    """Exception raised by `RequestHandler.get_argument`.
+
+    This is a subclass of `HTTPError`, so if it is uncaught a 400 response
+    code will be used instead of 500 (and a stack trace will not be logged).
+
+    .. versionadded:: 3.1
+    """
+
+    def __init__(self, arg_name: str) -> None:
+        super().__init__(400, "Missing argument %s" % arg_name)
+        self.arg_name = arg_name
+
+
+class ErrorHandler(RequestHandler):
+    """Generates an error response with ``status_code`` for all requests."""
+
+    def initialize(self, status_code: int) -> None:
+        self.set_status(status_code)
+
+    def prepare(self) -> None:
+        raise HTTPError(self._status_code)
+
+    def check_xsrf_cookie(self) -> None:
+        # POSTs to an ErrorHandler don't actually have side effects,
+        # so we don't need to check the xsrf token.  This allows POSTs
+        # to the wrong url to return a 404 instead of 403.
+        pass
+
+
+class RedirectHandler(RequestHandler):
+    """Redirects the client to the given URL for all GET requests.
+
+    You should provide the keyword argument ``url`` to the handler, e.g.::
+
+        application = web.Application([
+            (r"/oldpath", web.RedirectHandler, {"url": "/newpath"}),
+        ])
+
+    `RedirectHandler` supports regular expression substitutions. E.g., to
+    swap the first and second parts of a path while preserving the remainder::
+
+        application = web.Application([
+            (r"/(.*?)/(.*?)/(.*)", web.RedirectHandler, {"url": "/{1}/{0}/{2}"}),
+        ])
+
+    The final URL is formatted with `str.format` and the substrings that match
+    the capturing groups. In the above example, a request to "/a/b/c" would be
+    formatted like::
+
+        str.format("/{1}/{0}/{2}", "a", "b", "c")  # -> "/b/a/c"
+
+    Use Python's :ref:`format string syntax ` to customize how
+    values are substituted.
+
+    .. versionchanged:: 4.5
+       Added support for substitutions into the destination URL.
+
+    .. versionchanged:: 5.0
+       If any query arguments are present, they will be copied to the
+       destination URL.
+    """
+
+    def initialize(self, url: str, permanent: bool = True) -> None:
+        self._url = url
+        self._permanent = permanent
+
+    def get(self, *args: Any, **kwargs: Any) -> None:
+        to_url = self._url.format(*args, **kwargs)
+        if self.request.query_arguments:
+            # TODO: figure out typing for the next line.
+            to_url = httputil.url_concat(
+                to_url,
+                list(httputil.qs_to_qsl(self.request.query_arguments)),  # type: ignore
+            )
+        self.redirect(to_url, permanent=self._permanent)
+
+
+class StaticFileHandler(RequestHandler):
+    """A simple handler that can serve static content from a directory.
+
+    A `StaticFileHandler` is configured automatically if you pass the
+    ``static_path`` keyword argument to `Application`.  This handler
+    can be customized with the ``static_url_prefix``, ``static_handler_class``,
+    and ``static_handler_args`` settings.
+
+    To map an additional path to this handler for a static data directory
+    you would add a line to your application like::
+
+        application = web.Application([
+            (r"/content/(.*)", web.StaticFileHandler, {"path": "/var/www"}),
+        ])
+
+    The handler constructor requires a ``path`` argument, which specifies the
+    local root directory of the content to be served.
+
+    Note that a capture group in the regex is required to parse the value for
+    the ``path`` argument to the get() method (different than the constructor
+    argument above); see `URLSpec` for details.
+
+    To serve a file like ``index.html`` automatically when a directory is
+    requested, set ``static_handler_args=dict(default_filename="index.html")``
+    in your application settings, or add ``default_filename`` as an initializer
+    argument for your ``StaticFileHandler``.
+
+    To maximize the effectiveness of browser caching, this class supports
+    versioned urls (by default using the argument ``?v=``).  If a version
+    is given, we instruct the browser to cache this file indefinitely.
+    `make_static_url` (also available as `RequestHandler.static_url`) can
+    be used to construct a versioned url.
+
+    This handler is intended primarily for use in development and light-duty
+    file serving; for heavy traffic it will be more efficient to use
+    a dedicated static file server (such as nginx or Apache).  We support
+    the HTTP ``Accept-Ranges`` mechanism to return partial content (because
+    some browsers require this functionality to be present to seek in
+    HTML5 audio or video).
+
+    **Subclassing notes**
+
+    This class is designed to be extensible by subclassing, but because
+    of the way static urls are generated with class methods rather than
+    instance methods, the inheritance patterns are somewhat unusual.
+    Be sure to use the ``@classmethod`` decorator when overriding a
+    class method.  Instance methods may use the attributes ``self.path``
+    ``self.absolute_path``, and ``self.modified``.
+
+    Subclasses should only override methods discussed in this section;
+    overriding other methods is error-prone.  Overriding
+    ``StaticFileHandler.get`` is particularly problematic due to the
+    tight coupling with ``compute_etag`` and other methods.
+
+    To change the way static urls are generated (e.g. to match the behavior
+    of another server or CDN), override `make_static_url`, `parse_url_path`,
+    `get_cache_time`, and/or `get_version`.
+
+    To replace all interaction with the filesystem (e.g. to serve
+    static content from a database), override `get_content`,
+    `get_content_size`, `get_modified_time`, `get_absolute_path`, and
+    `validate_absolute_path`.
+
+    .. versionchanged:: 3.1
+       Many of the methods for subclasses were added in Tornado 3.1.
+    """
+
+    CACHE_MAX_AGE = 86400 * 365 * 10  # 10 years
+
+    _static_hashes = {}  # type: Dict[str, Optional[str]]
+    _lock = threading.Lock()  # protects _static_hashes
+
+    def initialize(self, path: str, default_filename: Optional[str] = None) -> None:
+        self.root = path
+        self.default_filename = default_filename
+
+    @classmethod
+    def reset(cls) -> None:
+        with cls._lock:
+            cls._static_hashes = {}
+
+    def head(self, path: str) -> Awaitable[None]:
+        return self.get(path, include_body=False)
+
+    async def get(self, path: str, include_body: bool = True) -> None:
+        # Set up our path instance variables.
+        self.path = self.parse_url_path(path)
+        del path  # make sure we don't refer to path instead of self.path again
+        absolute_path = self.get_absolute_path(self.root, self.path)
+        self.absolute_path = self.validate_absolute_path(self.root, absolute_path)
+        if self.absolute_path is None:
+            return
+
+        self.modified = self.get_modified_time()
+        self.set_headers()
+
+        if self.should_return_304():
+            self.set_status(304)
+            return
+
+        request_range = None
+        range_header = self.request.headers.get("Range")
+        if range_header:
+            # As per RFC 2616 14.16, if an invalid Range header is specified,
+            # the request will be treated as if the header didn't exist.
+            request_range = httputil._parse_request_range(range_header)
+
+        size = self.get_content_size()
+        if request_range:
+            start, end = request_range
+            if start is not None and start < 0:
+                start += size
+                if start < 0:
+                    start = 0
+            if (
+                start is not None
+                and (start >= size or (end is not None and start >= end))
+            ) or end == 0:
+                # As per RFC 2616 14.35.1, a range is not satisfiable only: if
+                # the first requested byte is equal to or greater than the
+                # content, or when a suffix with length 0 is specified.
+                # https://tools.ietf.org/html/rfc7233#section-2.1
+                # A byte-range-spec is invalid if the last-byte-pos value is present
+                # and less than the first-byte-pos.
+                self.set_status(416)  # Range Not Satisfiable
+                self.set_header("Content-Type", "text/plain")
+                self.set_header("Content-Range", f"bytes */{size}")
+                return
+            if end is not None and end > size:
+                # Clients sometimes blindly use a large range to limit their
+                # download size; cap the endpoint at the actual file size.
+                end = size
+            # Note: only return HTTP 206 if less than the entire range has been
+            # requested. Not only is this semantically correct, but Chrome
+            # refuses to play audio if it gets an HTTP 206 in response to
+            # ``Range: bytes=0-``.
+            if size != (end or size) - (start or 0):
+                self.set_status(206)  # Partial Content
+                self.set_header(
+                    "Content-Range", httputil._get_content_range(start, end, size)
+                )
+        else:
+            start = end = None
+
+        if start is not None and end is not None:
+            content_length = end - start
+        elif end is not None:
+            content_length = end
+        elif start is not None:
+            content_length = size - start
+        else:
+            content_length = size
+        self.set_header("Content-Length", content_length)
+
+        if include_body:
+            content = self.get_content(self.absolute_path, start, end)
+            if isinstance(content, bytes):
+                content = [content]
+            for chunk in content:
+                try:
+                    self.write(chunk)
+                    await self.flush()
+                except iostream.StreamClosedError:
+                    return
+        else:
+            assert self.request.method == "HEAD"
+
+    def compute_etag(self) -> Optional[str]:
+        """Sets the ``Etag`` header based on static url version.
+
+        This allows efficient ``If-None-Match`` checks against cached
+        versions, and sends the correct ``Etag`` for a partial response
+        (i.e. the same ``Etag`` as the full file).
+
+        .. versionadded:: 3.1
+        """
+        assert self.absolute_path is not None
+        version_hash = self._get_cached_version(self.absolute_path)
+        if not version_hash:
+            return None
+        return f'"{version_hash}"'
+
+    def set_headers(self) -> None:
+        """Sets the content and caching headers on the response.
+
+        .. versionadded:: 3.1
+        """
+        self.set_header("Accept-Ranges", "bytes")
+        self.set_etag_header()
+
+        if self.modified is not None:
+            self.set_header("Last-Modified", self.modified)
+
+        content_type = self.get_content_type()
+        if content_type:
+            self.set_header("Content-Type", content_type)
+
+        cache_time = self.get_cache_time(self.path, self.modified, content_type)
+        if cache_time > 0:
+            self.set_header(
+                "Expires",
+                datetime.datetime.now(datetime.timezone.utc)
+                + datetime.timedelta(seconds=cache_time),
+            )
+            self.set_header("Cache-Control", "max-age=" + str(cache_time))
+
+        self.set_extra_headers(self.path)
+
+    def should_return_304(self) -> bool:
+        """Returns True if the headers indicate that we should return 304.
+
+        .. versionadded:: 3.1
+        """
+        # If client sent If-None-Match, use it, ignore If-Modified-Since
+        if self.request.headers.get("If-None-Match"):
+            return self.check_etag_header()
+
+        # Check the If-Modified-Since, and don't send the result if the
+        # content has not been modified
+        ims_value = self.request.headers.get("If-Modified-Since")
+        if ims_value is not None:
+            try:
+                if_since = email.utils.parsedate_to_datetime(ims_value)
+            except Exception:
+                return False
+            if if_since.tzinfo is None:
+                if_since = if_since.replace(tzinfo=datetime.timezone.utc)
+            assert self.modified is not None
+            if if_since >= self.modified:
+                return True
+
+        return False
+
+    @classmethod
+    def get_absolute_path(cls, root: str, path: str) -> str:
+        """Returns the absolute location of ``path`` relative to ``root``.
+
+        ``root`` is the path configured for this `StaticFileHandler`
+        (in most cases the ``static_path`` `Application` setting).
+
+        This class method may be overridden in subclasses.  By default
+        it returns a filesystem path, but other strings may be used
+        as long as they are unique and understood by the subclass's
+        overridden `get_content`.
+
+        .. versionadded:: 3.1
+        """
+        abspath = os.path.abspath(os.path.join(root, path))
+        return abspath
+
+    def validate_absolute_path(self, root: str, absolute_path: str) -> Optional[str]:
+        """Validate and return the absolute path.
+
+        ``root`` is the configured path for the `StaticFileHandler`,
+        and ``path`` is the result of `get_absolute_path`
+
+        This is an instance method called during request processing,
+        so it may raise `HTTPError` or use methods like
+        `RequestHandler.redirect` (return None after redirecting to
+        halt further processing).  This is where 404 errors for missing files
+        are generated.
+
+        This method may modify the path before returning it, but note that
+        any such modifications will not be understood by `make_static_url`.
+
+        In instance methods, this method's result is available as
+        ``self.absolute_path``.
+
+        .. versionadded:: 3.1
+        """
+        # os.path.abspath strips a trailing /.
+        # We must add it back to `root` so that we only match files
+        # in a directory named `root` instead of files starting with
+        # that prefix.
+        root = os.path.abspath(root)
+        if not root.endswith(os.path.sep):
+            # abspath always removes a trailing slash, except when
+            # root is '/'. This is an unusual case, but several projects
+            # have independently discovered this technique to disable
+            # Tornado's path validation and (hopefully) do their own,
+            # so we need to support it.
+            root += os.path.sep
+        # The trailing slash also needs to be temporarily added back
+        # the requested path so a request to root/ will match.
+        if not (absolute_path + os.path.sep).startswith(root):
+            raise HTTPError(403, "%s is not in root static directory", self.path)
+        if os.path.isdir(absolute_path) and self.default_filename is not None:
+            # need to look at the request.path here for when path is empty
+            # but there is some prefix to the path that was already
+            # trimmed by the routing
+            if not self.request.path.endswith("/"):
+                if self.request.path.startswith("//"):
+                    # A redirect with two initial slashes is a "protocol-relative" URL.
+                    # This means the next path segment is treated as a hostname instead
+                    # of a part of the path, making this effectively an open redirect.
+                    # Reject paths starting with two slashes to prevent this.
+                    # This is only reachable under certain configurations.
+                    raise HTTPError(
+                        403, "cannot redirect path with two initial slashes"
+                    )
+                self.redirect(self.request.path + "/", permanent=True)
+                return None
+            absolute_path = os.path.join(absolute_path, self.default_filename)
+        if not os.path.exists(absolute_path):
+            raise HTTPError(404)
+        if not os.path.isfile(absolute_path):
+            raise HTTPError(403, "%s is not a file", self.path)
+        return absolute_path
+
+    @classmethod
+    def get_content(
+        cls, abspath: str, start: Optional[int] = None, end: Optional[int] = None
+    ) -> Generator[bytes, None, None]:
+        """Retrieve the content of the requested resource which is located
+        at the given absolute path.
+
+        This class method may be overridden by subclasses.  Note that its
+        signature is different from other overridable class methods
+        (no ``settings`` argument); this is deliberate to ensure that
+        ``abspath`` is able to stand on its own as a cache key.
+
+        This method should either return a byte string or an iterator
+        of byte strings.  The latter is preferred for large files
+        as it helps reduce memory fragmentation.
+
+        .. versionadded:: 3.1
+        """
+        with open(abspath, "rb") as file:
+            if start is not None:
+                file.seek(start)
+            if end is not None:
+                remaining = end - (start or 0)  # type: Optional[int]
+            else:
+                remaining = None
+            while True:
+                chunk_size = 64 * 1024
+                if remaining is not None and remaining < chunk_size:
+                    chunk_size = remaining
+                chunk = file.read(chunk_size)
+                if chunk:
+                    if remaining is not None:
+                        remaining -= len(chunk)
+                    yield chunk
+                else:
+                    if remaining is not None:
+                        assert remaining == 0
+                    return
+
+    @classmethod
+    def get_content_version(cls, abspath: str) -> str:
+        """Returns a version string for the resource at the given path.
+
+        This class method may be overridden by subclasses.  The
+        default implementation is a SHA-512 hash of the file's contents.
+
+        .. versionadded:: 3.1
+        """
+        data = cls.get_content(abspath)
+        hasher = hashlib.sha512()
+        if isinstance(data, bytes):
+            hasher.update(data)
+        else:
+            for chunk in data:
+                hasher.update(chunk)
+        return hasher.hexdigest()
+
+    def _stat(self) -> os.stat_result:
+        assert self.absolute_path is not None
+        if not hasattr(self, "_stat_result"):
+            self._stat_result = os.stat(self.absolute_path)
+        return self._stat_result
+
+    def get_content_size(self) -> int:
+        """Retrieve the total size of the resource at the given path.
+
+        This method may be overridden by subclasses.
+
+        .. versionadded:: 3.1
+
+        .. versionchanged:: 4.0
+           This method is now always called, instead of only when
+           partial results are requested.
+        """
+        stat_result = self._stat()
+        return stat_result.st_size
+
+    def get_modified_time(self) -> Optional[datetime.datetime]:
+        """Returns the time that ``self.absolute_path`` was last modified.
+
+        May be overridden in subclasses.  Should return a `~datetime.datetime`
+        object or None.
+
+        .. versionadded:: 3.1
+
+        .. versionchanged:: 6.4
+           Now returns an aware datetime object instead of a naive one.
+           Subclasses that override this method may return either kind.
+        """
+        stat_result = self._stat()
+        # NOTE: Historically, this used stat_result[stat.ST_MTIME],
+        # which truncates the fractional portion of the timestamp. It
+        # was changed from that form to stat_result.st_mtime to
+        # satisfy mypy (which disallows the bracket operator), but the
+        # latter form returns a float instead of an int. For
+        # consistency with the past (and because we have a unit test
+        # that relies on this), we truncate the float here, although
+        # I'm not sure that's the right thing to do.
+        modified = datetime.datetime.fromtimestamp(
+            int(stat_result.st_mtime), datetime.timezone.utc
+        )
+        return modified
+
+    def get_content_type(self) -> str:
+        """Returns the ``Content-Type`` header to be used for this request.
+
+        .. versionadded:: 3.1
+        """
+        assert self.absolute_path is not None
+        mime_type, encoding = mimetypes.guess_type(self.absolute_path)
+        # per RFC 6713, use the appropriate type for a gzip compressed file
+        if encoding == "gzip":
+            return "application/gzip"
+        # As of 2015-07-21 there is no bzip2 encoding defined at
+        # http://www.iana.org/assignments/media-types/media-types.xhtml
+        # So for that (and any other encoding), use octet-stream.
+        elif encoding is not None:
+            return "application/octet-stream"
+        elif mime_type is not None:
+            return mime_type
+        # if mime_type not detected, use application/octet-stream
+        else:
+            return "application/octet-stream"
+
+    def set_extra_headers(self, path: str) -> None:
+        """For subclass to add extra headers to the response"""
+        pass
+
+    def get_cache_time(
+        self, path: str, modified: Optional[datetime.datetime], mime_type: str
+    ) -> int:
+        """Override to customize cache control behavior.
+
+        Return a positive number of seconds to make the result
+        cacheable for that amount of time or 0 to mark resource as
+        cacheable for an unspecified amount of time (subject to
+        browser heuristics).
+
+        By default returns cache expiry of 10 years for resources requested
+        with ``v`` argument.
+        """
+        return self.CACHE_MAX_AGE if "v" in self.request.arguments else 0
+
+    @classmethod
+    def make_static_url(
+        cls, settings: Dict[str, Any], path: str, include_version: bool = True
+    ) -> str:
+        """Constructs a versioned url for the given path.
+
+        This method may be overridden in subclasses (but note that it
+        is a class method rather than an instance method).  Subclasses
+        are only required to implement the signature
+        ``make_static_url(cls, settings, path)``; other keyword
+        arguments may be passed through `~RequestHandler.static_url`
+        but are not standard.
+
+        ``settings`` is the `Application.settings` dictionary.  ``path``
+        is the static path being requested.  The url returned should be
+        relative to the current host.
+
+        ``include_version`` determines whether the generated URL should
+        include the query string containing the version hash of the
+        file corresponding to the given ``path``.
+
+        """
+        url = settings.get("static_url_prefix", "/static/") + path
+        if not include_version:
+            return url
+
+        version_hash = cls.get_version(settings, path)
+        if not version_hash:
+            return url
+
+        return f"{url}?v={version_hash}"
+
+    def parse_url_path(self, url_path: str) -> str:
+        """Converts a static URL path into a filesystem path.
+
+        ``url_path`` is the path component of the URL with
+        ``static_url_prefix`` removed.  The return value should be
+        filesystem path relative to ``static_path``.
+
+        This is the inverse of `make_static_url`.
+        """
+        if os.path.sep != "/":
+            url_path = url_path.replace("/", os.path.sep)
+        return url_path
+
+    @classmethod
+    def get_version(cls, settings: Dict[str, Any], path: str) -> Optional[str]:
+        """Generate the version string to be used in static URLs.
+
+        ``settings`` is the `Application.settings` dictionary and ``path``
+        is the relative location of the requested asset on the filesystem.
+        The returned value should be a string, or ``None`` if no version
+        could be determined.
+
+        .. versionchanged:: 3.1
+           This method was previously recommended for subclasses to override;
+           `get_content_version` is now preferred as it allows the base
+           class to handle caching of the result.
+        """
+        abs_path = cls.get_absolute_path(settings["static_path"], path)
+        return cls._get_cached_version(abs_path)
+
+    @classmethod
+    def _get_cached_version(cls, abs_path: str) -> Optional[str]:
+        with cls._lock:
+            hashes = cls._static_hashes
+            if abs_path not in hashes:
+                try:
+                    hashes[abs_path] = cls.get_content_version(abs_path)
+                except Exception:
+                    gen_log.error("Could not open static file %r", abs_path)
+                    hashes[abs_path] = None
+            hsh = hashes.get(abs_path)
+            if hsh:
+                return hsh
+        return None
+
+
+class FallbackHandler(RequestHandler):
+    """A `RequestHandler` that wraps another HTTP server callback.
+
+    The fallback is a callable object that accepts an
+    `~.httputil.HTTPServerRequest`, such as an `Application` or
+    `tornado.wsgi.WSGIContainer`.  This is most useful to use both
+    Tornado ``RequestHandlers`` and WSGI in the same server.  Typical
+    usage::
+
+        wsgi_app = tornado.wsgi.WSGIContainer(
+            django.core.handlers.wsgi.WSGIHandler())
+        application = tornado.web.Application([
+            (r"/foo", FooHandler),
+            (r".*", FallbackHandler, dict(fallback=wsgi_app)),
+        ])
+    """
+
+    def initialize(
+        self, fallback: Callable[[httputil.HTTPServerRequest], None]
+    ) -> None:
+        self.fallback = fallback
+
+    def prepare(self) -> None:
+        self.fallback(self.request)
+        self._finished = True
+        self.on_finish()
+
+
+class OutputTransform:
+    """A transform modifies the result of an HTTP request (e.g., GZip encoding)
+
+    Applications are not expected to create their own OutputTransforms
+    or interact with them directly; the framework chooses which transforms
+    (if any) to apply.
+    """
+
+    def __init__(self, request: httputil.HTTPServerRequest) -> None:
+        pass
+
+    def transform_first_chunk(
+        self,
+        status_code: int,
+        headers: httputil.HTTPHeaders,
+        chunk: bytes,
+        finishing: bool,
+    ) -> Tuple[int, httputil.HTTPHeaders, bytes]:
+        return status_code, headers, chunk
+
+    def transform_chunk(self, chunk: bytes, finishing: bool) -> bytes:
+        return chunk
+
+
+class GZipContentEncoding(OutputTransform):
+    """Applies the gzip content encoding to the response.
+
+    See http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11
+
+    .. versionchanged:: 4.0
+        Now compresses all mime types beginning with ``text/``, instead
+        of just a whitelist. (the whitelist is still used for certain
+        non-text mime types).
+    """
+
+    # Whitelist of compressible mime types (in addition to any types
+    # beginning with "text/").
+    CONTENT_TYPES = {
+        "application/javascript",
+        "application/x-javascript",
+        "application/xml",
+        "application/atom+xml",
+        "application/json",
+        "application/xhtml+xml",
+        "image/svg+xml",
+    }
+    # Python's GzipFile defaults to level 9, while most other gzip
+    # tools (including gzip itself) default to 6, which is probably a
+    # better CPU/size tradeoff.
+    GZIP_LEVEL = 6
+    # Responses that are too short are unlikely to benefit from gzipping
+    # after considering the "Content-Encoding: gzip" header and the header
+    # inside the gzip encoding.
+    # Note that responses written in multiple chunks will be compressed
+    # regardless of size.
+    MIN_LENGTH = 1024
+
+    def __init__(self, request: httputil.HTTPServerRequest) -> None:
+        self._gzipping = "gzip" in request.headers.get("Accept-Encoding", "")
+
+    def _compressible_type(self, ctype: str) -> bool:
+        return ctype.startswith("text/") or ctype in self.CONTENT_TYPES
+
+    def transform_first_chunk(
+        self,
+        status_code: int,
+        headers: httputil.HTTPHeaders,
+        chunk: bytes,
+        finishing: bool,
+    ) -> Tuple[int, httputil.HTTPHeaders, bytes]:
+        # TODO: can/should this type be inherited from the superclass?
+        if "Vary" in headers:
+            headers["Vary"] += ", Accept-Encoding"
+        else:
+            headers["Vary"] = "Accept-Encoding"
+        if self._gzipping:
+            ctype = _unicode(headers.get("Content-Type", "")).split(";")[0]
+            self._gzipping = (
+                self._compressible_type(ctype)
+                and (not finishing or len(chunk) >= self.MIN_LENGTH)
+                and ("Content-Encoding" not in headers)
+            )
+        if self._gzipping:
+            headers["Content-Encoding"] = "gzip"
+            self._gzip_value = BytesIO()
+            self._gzip_file = gzip.GzipFile(
+                mode="w", fileobj=self._gzip_value, compresslevel=self.GZIP_LEVEL
+            )
+            chunk = self.transform_chunk(chunk, finishing)
+            if "Content-Length" in headers:
+                # The original content length is no longer correct.
+                # If this is the last (and only) chunk, we can set the new
+                # content-length; otherwise we remove it and fall back to
+                # chunked encoding.
+                if finishing:
+                    headers["Content-Length"] = str(len(chunk))
+                else:
+                    del headers["Content-Length"]
+        return status_code, headers, chunk
+
+    def transform_chunk(self, chunk: bytes, finishing: bool) -> bytes:
+        if self._gzipping:
+            self._gzip_file.write(chunk)
+            if finishing:
+                self._gzip_file.close()
+            else:
+                self._gzip_file.flush()
+            chunk = self._gzip_value.getvalue()
+            self._gzip_value.truncate(0)
+            self._gzip_value.seek(0)
+        return chunk
+
+
+def authenticated(
+    method: Callable[..., Optional[Awaitable[None]]],
+) -> Callable[..., Optional[Awaitable[None]]]:
+    """Decorate methods with this to require that the user be logged in.
+
+    If the user is not logged in, they will be redirected to the configured
+    `login url `.
+
+    If you configure a login url with a query parameter, Tornado will
+    assume you know what you're doing and use it as-is.  If not, it
+    will add a `next` parameter so the login page knows where to send
+    you once you're logged in.
+    """
+
+    @functools.wraps(method)
+    def wrapper(  # type: ignore
+        self: RequestHandler, *args, **kwargs
+    ) -> Optional[Awaitable[None]]:
+        if not self.current_user:
+            if self.request.method in ("GET", "HEAD"):
+                url = self.get_login_url()
+                if "?" not in url:
+                    if urllib.parse.urlsplit(url).scheme:
+                        # if login url is absolute, make next absolute too
+                        next_url = self.request.full_url()
+                    else:
+                        assert self.request.uri is not None
+                        next_url = self.request.uri
+                    url += "?" + urlencode(dict(next=next_url))
+                self.redirect(url)
+                return None
+            raise HTTPError(403)
+        return method(self, *args, **kwargs)
+
+    return wrapper
+
+
+class UIModule:
+    """A re-usable, modular UI unit on a page.
+
+    UI modules often execute additional queries, and they can include
+    additional CSS and JavaScript that will be included in the output
+    page, which is automatically inserted on page render.
+
+    Subclasses of UIModule must override the `render` method.
+    """
+
+    def __init__(self, handler: RequestHandler) -> None:
+        self.handler = handler
+        self.request = handler.request
+        self.ui = handler.ui
+        self.locale = handler.locale
+
+    @property
+    def current_user(self) -> Any:
+        return self.handler.current_user
+
+    def render(self, *args: Any, **kwargs: Any) -> Union[str, bytes]:
+        """Override in subclasses to return this module's output."""
+        raise NotImplementedError()
+
+    def embedded_javascript(self) -> Optional[str]:
+        """Override to return a JavaScript string
+        to be embedded in the page."""
+        return None
+
+    def javascript_files(self) -> Optional[Iterable[str]]:
+        """Override to return a list of JavaScript files needed by this module.
+
+        If the return values are relative paths, they will be passed to
+        `RequestHandler.static_url`; otherwise they will be used as-is.
+        """
+        return None
+
+    def embedded_css(self) -> Optional[str]:
+        """Override to return a CSS string
+        that will be embedded in the page."""
+        return None
+
+    def css_files(self) -> Optional[Iterable[str]]:
+        """Override to returns a list of CSS files required by this module.
+
+        If the return values are relative paths, they will be passed to
+        `RequestHandler.static_url`; otherwise they will be used as-is.
+        """
+        return None
+
+    def html_head(self) -> Optional[str]:
+        """Override to return an HTML string that will be put in the 
+        element.
+        """
+        return None
+
+    def html_body(self) -> Optional[str]:
+        """Override to return an HTML string that will be put at the end of
+        the  element.
+        """
+        return None
+
+    def render_string(self, path: str, **kwargs: Any) -> bytes:
+        """Renders a template and returns it as a string."""
+        return self.handler.render_string(path, **kwargs)
+
+
+class _linkify(UIModule):
+    def render(self, text: str, **kwargs: Any) -> str:
+        return escape.linkify(text, **kwargs)
+
+
+class _xsrf_form_html(UIModule):
+    def render(self) -> str:
+        return self.handler.xsrf_form_html()
+
+
+class TemplateModule(UIModule):
+    """UIModule that simply renders the given template.
+
+    {% module Template("foo.html") %} is similar to {% include "foo.html" %},
+    but the module version gets its own namespace (with kwargs passed to
+    Template()) instead of inheriting the outer template's namespace.
+
+    Templates rendered through this module also get access to UIModule's
+    automatic JavaScript/CSS features.  Simply call set_resources
+    inside the template and give it keyword arguments corresponding to
+    the methods on UIModule: {{ set_resources(js_files=static_url("my.js")) }}
+    Note that these resources are output once per template file, not once
+    per instantiation of the template, so they must not depend on
+    any arguments to the template.
+    """
+
+    def __init__(self, handler: RequestHandler) -> None:
+        super().__init__(handler)
+        # keep resources in both a list and a dict to preserve order
+        self._resource_list = []  # type: List[Dict[str, Any]]
+        self._resource_dict = {}  # type: Dict[str, Dict[str, Any]]
+
+    def render(self, path: str, **kwargs: Any) -> bytes:
+        def set_resources(**kwargs) -> str:  # type: ignore
+            if path not in self._resource_dict:
+                self._resource_list.append(kwargs)
+                self._resource_dict[path] = kwargs
+            else:
+                if self._resource_dict[path] != kwargs:
+                    raise ValueError(
+                        "set_resources called with different "
+                        "resources for the same template"
+                    )
+            return ""
+
+        return self.render_string(path, set_resources=set_resources, **kwargs)
+
+    def _get_resources(self, key: str) -> Iterable[str]:
+        return (r[key] for r in self._resource_list if key in r)
+
+    def embedded_javascript(self) -> str:
+        return "\n".join(self._get_resources("embedded_javascript"))
+
+    def javascript_files(self) -> Iterable[str]:
+        result = []
+        for f in self._get_resources("javascript_files"):
+            if isinstance(f, (unicode_type, bytes)):
+                result.append(f)
+            else:
+                result.extend(f)
+        return result
+
+    def embedded_css(self) -> str:
+        return "\n".join(self._get_resources("embedded_css"))
+
+    def css_files(self) -> Iterable[str]:
+        result = []
+        for f in self._get_resources("css_files"):
+            if isinstance(f, (unicode_type, bytes)):
+                result.append(f)
+            else:
+                result.extend(f)
+        return result
+
+    def html_head(self) -> str:
+        return "".join(self._get_resources("html_head"))
+
+    def html_body(self) -> str:
+        return "".join(self._get_resources("html_body"))
+
+
+class _UIModuleNamespace:
+    """Lazy namespace which creates UIModule proxies bound to a handler."""
+
+    def __init__(
+        self, handler: RequestHandler, ui_modules: Dict[str, Type[UIModule]]
+    ) -> None:
+        self.handler = handler
+        self.ui_modules = ui_modules
+
+    def __getitem__(self, key: str) -> Callable[..., str]:
+        return self.handler._ui_module(key, self.ui_modules[key])
+
+    def __getattr__(self, key: str) -> Callable[..., str]:
+        try:
+            return self[key]
+        except KeyError as e:
+            raise AttributeError(str(e))
+
+
+def create_signed_value(
+    secret: _CookieSecretTypes,
+    name: str,
+    value: Union[str, bytes],
+    version: Optional[int] = None,
+    clock: Optional[Callable[[], float]] = None,
+    key_version: Optional[int] = None,
+) -> bytes:
+    if version is None:
+        version = DEFAULT_SIGNED_VALUE_VERSION
+    if clock is None:
+        clock = time.time
+
+    timestamp = utf8(str(int(clock())))
+    value = base64.b64encode(utf8(value))
+    if version == 1:
+        assert not isinstance(secret, dict)
+        signature = _create_signature_v1(secret, name, value, timestamp)
+        value = b"|".join([value, timestamp, signature])
+        return value
+    elif version == 2:
+        # The v2 format consists of a version number and a series of
+        # length-prefixed fields "%d:%s", the last of which is a
+        # signature, all separated by pipes.  All numbers are in
+        # decimal format with no leading zeros.  The signature is an
+        # HMAC-SHA256 of the whole string up to that point, including
+        # the final pipe.
+        #
+        # The fields are:
+        # - format version (i.e. 2; no length prefix)
+        # - key version (integer, default is 0)
+        # - timestamp (integer seconds since epoch)
+        # - name (not encoded; assumed to be ~alphanumeric)
+        # - value (base64-encoded)
+        # - signature (hex-encoded; no length prefix)
+        def format_field(s: Union[str, bytes]) -> bytes:
+            return utf8("%d:" % len(s)) + utf8(s)
+
+        to_sign = b"|".join(
+            [
+                b"2",
+                format_field(str(key_version or 0)),
+                format_field(timestamp),
+                format_field(name),
+                format_field(value),
+                b"",
+            ]
+        )
+
+        if isinstance(secret, dict):
+            assert (
+                key_version is not None
+            ), "Key version must be set when sign key dict is used"
+            assert version >= 2, "Version must be at least 2 for key version support"
+            secret = secret[key_version]
+
+        signature = _create_signature_v2(secret, to_sign)
+        return to_sign + signature
+    else:
+        raise ValueError("Unsupported version %d" % version)
+
+
+# A leading version number in decimal
+# with no leading zeros, followed by a pipe.
+_signed_value_version_re = re.compile(rb"^([1-9][0-9]*)\|(.*)$")
+
+
+def _get_version(value: bytes) -> int:
+    # Figures out what version value is.  Version 1 did not include an
+    # explicit version field and started with arbitrary base64 data,
+    # which makes this tricky.
+    m = _signed_value_version_re.match(value)
+    if m is None:
+        version = 1
+    else:
+        try:
+            version = int(m.group(1))
+            if version > 999:
+                # Certain payloads from the version-less v1 format may
+                # be parsed as valid integers.  Due to base64 padding
+                # restrictions, this can only happen for numbers whose
+                # length is a multiple of 4, so we can treat all
+                # numbers up to 999 as versions, and for the rest we
+                # fall back to v1 format.
+                version = 1
+        except ValueError:
+            version = 1
+    return version
+
+
+def decode_signed_value(
+    secret: _CookieSecretTypes,
+    name: str,
+    value: Union[None, str, bytes],
+    max_age_days: float = 31,
+    clock: Optional[Callable[[], float]] = None,
+    min_version: Optional[int] = None,
+) -> Optional[bytes]:
+    if clock is None:
+        clock = time.time
+    if min_version is None:
+        min_version = DEFAULT_SIGNED_VALUE_MIN_VERSION
+    if min_version > 2:
+        raise ValueError("Unsupported min_version %d" % min_version)
+    if not value:
+        return None
+
+    value = utf8(value)
+    version = _get_version(value)
+
+    if version < min_version:
+        return None
+    if version == 1:
+        assert not isinstance(secret, dict)
+        return _decode_signed_value_v1(secret, name, value, max_age_days, clock)
+    elif version == 2:
+        return _decode_signed_value_v2(secret, name, value, max_age_days, clock)
+    else:
+        return None
+
+
+def _decode_signed_value_v1(
+    secret: Union[str, bytes],
+    name: str,
+    value: bytes,
+    max_age_days: float,
+    clock: Callable[[], float],
+) -> Optional[bytes]:
+    parts = utf8(value).split(b"|")
+    if len(parts) != 3:
+        return None
+    signature = _create_signature_v1(secret, name, parts[0], parts[1])
+    if not hmac.compare_digest(parts[2], signature):
+        gen_log.warning("Invalid cookie signature %r", value)
+        return None
+    timestamp = int(parts[1])
+    if timestamp < clock() - max_age_days * 86400:
+        gen_log.warning("Expired cookie %r", value)
+        return None
+    if timestamp > clock() + 31 * 86400:
+        # _cookie_signature does not hash a delimiter between the
+        # parts of the cookie, so an attacker could transfer trailing
+        # digits from the payload to the timestamp without altering the
+        # signature.  For backwards compatibility, sanity-check timestamp
+        # here instead of modifying _cookie_signature.
+        gen_log.warning("Cookie timestamp in future; possible tampering %r", value)
+        return None
+    if parts[1].startswith(b"0"):
+        gen_log.warning("Tampered cookie %r", value)
+        return None
+    try:
+        return base64.b64decode(parts[0])
+    except Exception:
+        return None
+
+
+def _decode_fields_v2(value: bytes) -> Tuple[int, bytes, bytes, bytes, bytes]:
+    def _consume_field(s: bytes) -> Tuple[bytes, bytes]:
+        length, _, rest = s.partition(b":")
+        n = int(length)
+        field_value = rest[:n]
+        # In python 3, indexing bytes returns small integers; we must
+        # use a slice to get a byte string as in python 2.
+        if rest[n : n + 1] != b"|":
+            raise ValueError("malformed v2 signed value field")
+        rest = rest[n + 1 :]
+        return field_value, rest
+
+    rest = value[2:]  # remove version number
+    key_version, rest = _consume_field(rest)
+    timestamp, rest = _consume_field(rest)
+    name_field, rest = _consume_field(rest)
+    value_field, passed_sig = _consume_field(rest)
+    return int(key_version), timestamp, name_field, value_field, passed_sig
+
+
+def _decode_signed_value_v2(
+    secret: _CookieSecretTypes,
+    name: str,
+    value: bytes,
+    max_age_days: float,
+    clock: Callable[[], float],
+) -> Optional[bytes]:
+    try:
+        (
+            key_version,
+            timestamp_bytes,
+            name_field,
+            value_field,
+            passed_sig,
+        ) = _decode_fields_v2(value)
+    except ValueError:
+        return None
+    signed_string = value[: -len(passed_sig)]
+
+    if isinstance(secret, dict):
+        try:
+            secret = secret[key_version]
+        except KeyError:
+            return None
+
+    expected_sig = _create_signature_v2(secret, signed_string)
+    if not hmac.compare_digest(passed_sig, expected_sig):
+        return None
+    if name_field != utf8(name):
+        return None
+    timestamp = int(timestamp_bytes)
+    if timestamp < clock() - max_age_days * 86400:
+        # The signature has expired.
+        return None
+    try:
+        return base64.b64decode(value_field)
+    except Exception:
+        return None
+
+
+def get_signature_key_version(value: Union[str, bytes]) -> Optional[int]:
+    value = utf8(value)
+    version = _get_version(value)
+    if version < 2:
+        return None
+    try:
+        key_version, _, _, _, _ = _decode_fields_v2(value)
+    except ValueError:
+        return None
+
+    return key_version
+
+
+def _create_signature_v1(secret: Union[str, bytes], *parts: Union[str, bytes]) -> bytes:
+    hash = hmac.new(utf8(secret), digestmod=hashlib.sha1)
+    for part in parts:
+        hash.update(utf8(part))
+    return utf8(hash.hexdigest())
+
+
+def _create_signature_v2(secret: Union[str, bytes], s: bytes) -> bytes:
+    hash = hmac.new(utf8(secret), digestmod=hashlib.sha256)
+    hash.update(utf8(s))
+    return utf8(hash.hexdigest())
+
+
+def is_absolute(path: str) -> bool:
+    return any(path.startswith(x) for x in ["/", "http:", "https:"])
diff --git a/env/lib/python3.12/site-packages/tornado/websocket.py b/env/lib/python3.12/site-packages/tornado/websocket.py
new file mode 100644
index 0000000..c2e18d2
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tornado/websocket.py
@@ -0,0 +1,1725 @@
+"""Implementation of the WebSocket protocol.
+
+`WebSockets `_ allow for bidirectional
+communication between the browser and server. WebSockets are supported in the
+current versions of all major browsers.
+
+This module implements the final version of the WebSocket protocol as
+defined in `RFC 6455 `_.
+
+.. versionchanged:: 4.0
+   Removed support for the draft 76 protocol version.
+"""
+
+import abc
+import asyncio
+import base64
+import functools
+import hashlib
+import logging
+import os
+import sys
+import struct
+import tornado
+from urllib.parse import urlparse
+import warnings
+import zlib
+
+from tornado.concurrent import Future, future_set_result_unless_cancelled
+from tornado.escape import utf8, native_str, to_unicode
+from tornado import gen, httpclient, httputil
+from tornado.ioloop import IOLoop
+from tornado.iostream import StreamClosedError, IOStream
+from tornado.log import gen_log, app_log
+from tornado.netutil import Resolver
+from tornado import simple_httpclient
+from tornado.queues import Queue
+from tornado.tcpclient import TCPClient
+from tornado.util import _websocket_mask
+
+from typing import (
+    TYPE_CHECKING,
+    cast,
+    Any,
+    Optional,
+    Dict,
+    Union,
+    List,
+    Awaitable,
+    Callable,
+    Tuple,
+    Type,
+)
+from types import TracebackType
+
+if TYPE_CHECKING:
+    from typing_extensions import Protocol
+
+    # The zlib compressor types aren't actually exposed anywhere
+    # publicly, so declare protocols for the portions we use.
+    class _Compressor(Protocol):
+        def compress(self, data: bytes) -> bytes:
+            pass
+
+        def flush(self, mode: int) -> bytes:
+            pass
+
+    class _Decompressor(Protocol):
+        unconsumed_tail = b""  # type: bytes
+
+        def decompress(self, data: bytes, max_length: int) -> bytes:
+            pass
+
+    class _WebSocketDelegate(Protocol):
+        # The common base interface implemented by WebSocketHandler on
+        # the server side and WebSocketClientConnection on the client
+        # side.
+        def on_ws_connection_close(
+            self, close_code: Optional[int] = None, close_reason: Optional[str] = None
+        ) -> None:
+            pass
+
+        def on_message(self, message: Union[str, bytes]) -> Optional["Awaitable[None]"]:
+            pass
+
+        def on_ping(self, data: bytes) -> None:
+            pass
+
+        def on_pong(self, data: bytes) -> None:
+            pass
+
+        def log_exception(
+            self,
+            typ: Optional[Type[BaseException]],
+            value: Optional[BaseException],
+            tb: Optional[TracebackType],
+        ) -> None:
+            pass
+
+
+_default_max_message_size = 10 * 1024 * 1024
+
+# log to "gen_log" but suppress duplicate log messages
+de_dupe_gen_log = functools.lru_cache(gen_log.log)
+
+
+class WebSocketError(Exception):
+    pass
+
+
+class WebSocketClosedError(WebSocketError):
+    """Raised by operations on a closed connection.
+
+    .. versionadded:: 3.2
+    """
+
+    pass
+
+
+class _DecompressTooLargeError(Exception):
+    pass
+
+
+class _WebSocketParams:
+    def __init__(
+        self,
+        ping_interval: Optional[float] = None,
+        ping_timeout: Optional[float] = None,
+        max_message_size: int = _default_max_message_size,
+        compression_options: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        self.ping_interval = ping_interval
+        self.ping_timeout = ping_timeout
+        self.max_message_size = max_message_size
+        self.compression_options = compression_options
+
+
+class WebSocketHandler(tornado.web.RequestHandler):
+    """Subclass this class to create a basic WebSocket handler.
+
+    Override `on_message` to handle incoming messages, and use
+    `write_message` to send messages to the client. You can also
+    override `open` and `on_close` to handle opened and closed
+    connections.
+
+    Custom upgrade response headers can be sent by overriding
+    `~tornado.web.RequestHandler.set_default_headers` or
+    `~tornado.web.RequestHandler.prepare`.
+
+    See http://dev.w3.org/html5/websockets/ for details on the
+    JavaScript interface.  The protocol is specified at
+    http://tools.ietf.org/html/rfc6455.
+
+    Here is an example WebSocket handler that echos back all received messages
+    back to the client:
+
+    .. testcode::
+
+      class EchoWebSocket(tornado.websocket.WebSocketHandler):
+          def open(self):
+              print("WebSocket opened")
+
+          def on_message(self, message):
+              self.write_message(u"You said: " + message)
+
+          def on_close(self):
+              print("WebSocket closed")
+
+    WebSockets are not standard HTTP connections. The "handshake" is
+    HTTP, but after the handshake, the protocol is
+    message-based. Consequently, most of the Tornado HTTP facilities
+    are not available in handlers of this type. The only communication
+    methods available to you are `write_message()`, `ping()`, and
+    `close()`. Likewise, your request handler class should implement
+    `open()` method rather than ``get()`` or ``post()``.
+
+    If you map the handler above to ``/websocket`` in your application, you can
+    invoke it in JavaScript with::
+
+      var ws = new WebSocket("ws://localhost:8888/websocket");
+      ws.onopen = function() {
+         ws.send("Hello, world");
+      };
+      ws.onmessage = function (evt) {
+         alert(evt.data);
+      };
+
+    This script pops up an alert box that says "You said: Hello, world".
+
+    Web browsers allow any site to open a websocket connection to any other,
+    instead of using the same-origin policy that governs other network
+    access from JavaScript.  This can be surprising and is a potential
+    security hole, so since Tornado 4.0 `WebSocketHandler` requires
+    applications that wish to receive cross-origin websockets to opt in
+    by overriding the `~WebSocketHandler.check_origin` method (see that
+    method's docs for details).  Failure to do so is the most likely
+    cause of 403 errors when making a websocket connection.
+
+    When using a secure websocket connection (``wss://``) with a self-signed
+    certificate, the connection from a browser may fail because it wants
+    to show the "accept this certificate" dialog but has nowhere to show it.
+    You must first visit a regular HTML page using the same certificate
+    to accept it before the websocket connection will succeed.
+
+    If the application setting ``websocket_ping_interval`` has a non-zero
+    value, a ping will be sent periodically, and the connection will be
+    closed if a response is not received before the ``websocket_ping_timeout``.
+    Both settings are in seconds; floating point values are allowed.
+    The default timeout is equal to the interval.
+
+    Messages larger than the ``websocket_max_message_size`` application setting
+    (default 10MiB) will not be accepted.
+
+    .. versionchanged:: 4.5
+       Added ``websocket_ping_interval``, ``websocket_ping_timeout``, and
+       ``websocket_max_message_size``.
+    """
+
+    def __init__(
+        self,
+        application: tornado.web.Application,
+        request: httputil.HTTPServerRequest,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(application, request, **kwargs)
+        self.ws_connection = None  # type: Optional[WebSocketProtocol]
+        self.close_code = None  # type: Optional[int]
+        self.close_reason = None  # type: Optional[str]
+        self._on_close_called = False
+
+    async def get(self, *args: Any, **kwargs: Any) -> None:
+        self.open_args = args
+        self.open_kwargs = kwargs
+
+        # Upgrade header should be present and should be equal to WebSocket
+        if self.request.headers.get("Upgrade", "").lower() != "websocket":
+            self.set_status(400)
+            log_msg = 'Can "Upgrade" only to "WebSocket".'
+            self.finish(log_msg)
+            gen_log.debug(log_msg)
+            return
+
+        # Connection header should be upgrade.
+        # Some proxy servers/load balancers
+        # might mess with it.
+        headers = self.request.headers
+        connection = map(
+            lambda s: s.strip().lower(), headers.get("Connection", "").split(",")
+        )
+        if "upgrade" not in connection:
+            self.set_status(400)
+            log_msg = '"Connection" must be "Upgrade".'
+            self.finish(log_msg)
+            gen_log.debug(log_msg)
+            return
+
+        # Handle WebSocket Origin naming convention differences
+        # The difference between version 8 and 13 is that in 8 the
+        # client sends a "Sec-Websocket-Origin" header and in 13 it's
+        # simply "Origin".
+        if "Origin" in self.request.headers:
+            origin = self.request.headers.get("Origin")
+        else:
+            origin = self.request.headers.get("Sec-Websocket-Origin", None)
+
+        # If there was an origin header, check to make sure it matches
+        # according to check_origin. When the origin is None, we assume it
+        # did not come from a browser and that it can be passed on.
+        if origin is not None and not self.check_origin(origin):
+            self.set_status(403)
+            log_msg = "Cross origin websockets not allowed"
+            self.finish(log_msg)
+            gen_log.debug(log_msg)
+            return
+
+        self.ws_connection = self.get_websocket_protocol()
+        if self.ws_connection:
+            await self.ws_connection.accept_connection(self)
+        else:
+            self.set_status(426, "Upgrade Required")
+            self.set_header("Sec-WebSocket-Version", "7, 8, 13")
+
+    @property
+    def ping_interval(self) -> Optional[float]:
+        """The interval for sending websocket pings.
+
+        If this is non-zero, the websocket will send a ping every
+        ping_interval seconds.
+        The client will respond with a "pong". The connection can be configured
+        to timeout on late pong delivery using ``websocket_ping_timeout``.
+
+        Set ``websocket_ping_interval = 0`` to disable pings.
+
+        Default: ``0``
+        """
+        return self.settings.get("websocket_ping_interval", None)
+
+    @property
+    def ping_timeout(self) -> Optional[float]:
+        """Timeout if no pong is received in this many seconds.
+
+        To be used in combination with ``websocket_ping_interval > 0``.
+        If a ping response (a "pong") is not received within
+        ``websocket_ping_timeout`` seconds, then the websocket connection
+        will be closed.
+
+        This can help to clean up clients which have disconnected without
+        cleanly closing the websocket connection.
+
+        Note, the ping timeout cannot be longer than the ping interval.
+
+        Set ``websocket_ping_timeout = 0`` to disable the ping timeout.
+
+        Default: equal to the ``ping_interval``.
+
+        .. versionchanged:: 6.5.0
+           Default changed from the max of 3 pings or 30 seconds.
+           The ping timeout can no longer be configured longer than the
+           ping interval.
+        """
+        return self.settings.get("websocket_ping_timeout", None)
+
+    @property
+    def max_message_size(self) -> int:
+        """Maximum allowed message size.
+
+        If the remote peer sends a message larger than this, the connection
+        will be closed.
+
+        Default is 10MiB.
+        """
+        return self.settings.get(
+            "websocket_max_message_size", _default_max_message_size
+        )
+
+    def write_message(
+        self, message: Union[bytes, str, Dict[str, Any]], binary: bool = False
+    ) -> "Future[None]":
+        """Sends the given message to the client of this Web Socket.
+
+        The message may be either a string or a dict (which will be
+        encoded as json).  If the ``binary`` argument is false, the
+        message will be sent as utf8; in binary mode any byte string
+        is allowed.
+
+        If the connection is already closed, raises `WebSocketClosedError`.
+        Returns a `.Future` which can be used for flow control.
+
+        .. versionchanged:: 3.2
+           `WebSocketClosedError` was added (previously a closed connection
+           would raise an `AttributeError`)
+
+        .. versionchanged:: 4.3
+           Returns a `.Future` which can be used for flow control.
+
+        .. versionchanged:: 5.0
+           Consistently raises `WebSocketClosedError`. Previously could
+           sometimes raise `.StreamClosedError`.
+        """
+        if self.ws_connection is None or self.ws_connection.is_closing():
+            raise WebSocketClosedError()
+        if isinstance(message, dict):
+            message = tornado.escape.json_encode(message)
+        return self.ws_connection.write_message(message, binary=binary)
+
+    def select_subprotocol(self, subprotocols: List[str]) -> Optional[str]:
+        """Override to implement subprotocol negotiation.
+
+        ``subprotocols`` is a list of strings identifying the
+        subprotocols proposed by the client.  This method may be
+        overridden to return one of those strings to select it, or
+        ``None`` to not select a subprotocol.
+
+        Failure to select a subprotocol does not automatically abort
+        the connection, although clients may close the connection if
+        none of their proposed subprotocols was selected.
+
+        The list may be empty, in which case this method must return
+        None. This method is always called exactly once even if no
+        subprotocols were proposed so that the handler can be advised
+        of this fact.
+
+        .. versionchanged:: 5.1
+
+           Previously, this method was called with a list containing
+           an empty string instead of an empty list if no subprotocols
+           were proposed by the client.
+        """
+        return None
+
+    @property
+    def selected_subprotocol(self) -> Optional[str]:
+        """The subprotocol returned by `select_subprotocol`.
+
+        .. versionadded:: 5.1
+        """
+        assert self.ws_connection is not None
+        return self.ws_connection.selected_subprotocol
+
+    def get_compression_options(self) -> Optional[Dict[str, Any]]:
+        """Override to return compression options for the connection.
+
+        If this method returns None (the default), compression will
+        be disabled.  If it returns a dict (even an empty one), it
+        will be enabled.  The contents of the dict may be used to
+        control the following compression options:
+
+        ``compression_level`` specifies the compression level.
+
+        ``mem_level`` specifies the amount of memory used for the internal compression state.
+
+         These parameters are documented in detail here:
+         https://docs.python.org/3.13/library/zlib.html#zlib.compressobj
+
+        .. versionadded:: 4.1
+
+        .. versionchanged:: 4.5
+
+           Added ``compression_level`` and ``mem_level``.
+        """
+        # TODO: Add wbits option.
+        return None
+
+    def open(self, *args: str, **kwargs: str) -> Optional[Awaitable[None]]:
+        """Invoked when a new WebSocket is opened.
+
+        The arguments to `open` are extracted from the `tornado.web.URLSpec`
+        regular expression, just like the arguments to
+        `tornado.web.RequestHandler.get`.
+
+        `open` may be a coroutine. `on_message` will not be called until
+        `open` has returned.
+
+        .. versionchanged:: 5.1
+
+           ``open`` may be a coroutine.
+        """
+        pass
+
+    def on_message(self, message: Union[str, bytes]) -> Optional[Awaitable[None]]:
+        """Handle incoming messages on the WebSocket
+
+        This method must be overridden.
+
+        .. versionchanged:: 4.5
+
+           ``on_message`` can be a coroutine.
+        """
+        raise NotImplementedError
+
+    def ping(self, data: Union[str, bytes] = b"") -> None:
+        """Send ping frame to the remote end.
+
+        The data argument allows a small amount of data (up to 125
+        bytes) to be sent as a part of the ping message. Note that not
+        all websocket implementations expose this data to
+        applications.
+
+        Consider using the ``websocket_ping_interval`` application
+        setting instead of sending pings manually.
+
+        .. versionchanged:: 5.1
+
+           The data argument is now optional.
+
+        """
+        data = utf8(data)
+        if self.ws_connection is None or self.ws_connection.is_closing():
+            raise WebSocketClosedError()
+        self.ws_connection.write_ping(data)
+
+    def on_pong(self, data: bytes) -> None:
+        """Invoked when the response to a ping frame is received."""
+        pass
+
+    def on_ping(self, data: bytes) -> None:
+        """Invoked when the a ping frame is received."""
+        pass
+
+    def on_close(self) -> None:
+        """Invoked when the WebSocket is closed.
+
+        If the connection was closed cleanly and a status code or reason
+        phrase was supplied, these values will be available as the attributes
+        ``self.close_code`` and ``self.close_reason``.
+
+        .. versionchanged:: 4.0
+
+           Added ``close_code`` and ``close_reason`` attributes.
+        """
+        pass
+
+    def close(self, code: Optional[int] = None, reason: Optional[str] = None) -> None:
+        """Closes this Web Socket.
+
+        Once the close handshake is successful the socket will be closed.
+
+        ``code`` may be a numeric status code, taken from the values
+        defined in `RFC 6455 section 7.4.1
+        `_.
+        ``reason`` may be a textual message about why the connection is
+        closing.  These values are made available to the client, but are
+        not otherwise interpreted by the websocket protocol.
+
+        .. versionchanged:: 4.0
+
+           Added the ``code`` and ``reason`` arguments.
+        """
+        if self.ws_connection:
+            self.ws_connection.close(code, reason)
+            self.ws_connection = None
+
+    def check_origin(self, origin: str) -> bool:
+        """Override to enable support for allowing alternate origins.
+
+        The ``origin`` argument is the value of the ``Origin`` HTTP
+        header, the url responsible for initiating this request.  This
+        method is not called for clients that do not send this header;
+        such requests are always allowed (because all browsers that
+        implement WebSockets support this header, and non-browser
+        clients do not have the same cross-site security concerns).
+
+        Should return ``True`` to accept the request or ``False`` to
+        reject it. By default, rejects all requests with an origin on
+        a host other than this one.
+
+        This is a security protection against cross site scripting attacks on
+        browsers, since WebSockets are allowed to bypass the usual same-origin
+        policies and don't use CORS headers.
+
+        .. warning::
+
+           This is an important security measure; don't disable it
+           without understanding the security implications. In
+           particular, if your authentication is cookie-based, you
+           must either restrict the origins allowed by
+           ``check_origin()`` or implement your own XSRF-like
+           protection for websocket connections. See `these
+           `_
+           `articles
+           `_
+           for more.
+
+        To accept all cross-origin traffic (which was the default prior to
+        Tornado 4.0), simply override this method to always return ``True``::
+
+            def check_origin(self, origin):
+                return True
+
+        To allow connections from any subdomain of your site, you might
+        do something like::
+
+            def check_origin(self, origin):
+                parsed_origin = urllib.parse.urlparse(origin)
+                return parsed_origin.netloc.endswith(".mydomain.com")
+
+        .. versionadded:: 4.0
+
+        """
+        parsed_origin = urlparse(origin)
+        origin = parsed_origin.netloc
+        origin = origin.lower()
+
+        host = self.request.headers.get("Host")
+
+        # Check to see that origin matches host directly, including ports
+        return origin == host
+
+    def set_nodelay(self, value: bool) -> None:
+        """Set the no-delay flag for this stream.
+
+        By default, small messages may be delayed and/or combined to minimize
+        the number of packets sent.  This can sometimes cause 200-500ms delays
+        due to the interaction between Nagle's algorithm and TCP delayed
+        ACKs.  To reduce this delay (at the expense of possibly increasing
+        bandwidth usage), call ``self.set_nodelay(True)`` once the websocket
+        connection is established.
+
+        See `.BaseIOStream.set_nodelay` for additional details.
+
+        .. versionadded:: 3.1
+        """
+        assert self.ws_connection is not None
+        self.ws_connection.set_nodelay(value)
+
+    def on_connection_close(self) -> None:
+        if self.ws_connection:
+            self.ws_connection.on_connection_close()
+            self.ws_connection = None
+        if not self._on_close_called:
+            self._on_close_called = True
+            self.on_close()
+            self._break_cycles()
+
+    def on_ws_connection_close(
+        self, close_code: Optional[int] = None, close_reason: Optional[str] = None
+    ) -> None:
+        self.close_code = close_code
+        self.close_reason = close_reason
+        self.on_connection_close()
+
+    def _break_cycles(self) -> None:
+        # WebSocketHandlers call finish() early, but we don't want to
+        # break up reference cycles (which makes it impossible to call
+        # self.render_string) until after we've really closed the
+        # connection (if it was established in the first place,
+        # indicated by status code 101).
+        if self.get_status() != 101 or self._on_close_called:
+            super()._break_cycles()
+
+    def get_websocket_protocol(self) -> Optional["WebSocketProtocol"]:
+        websocket_version = self.request.headers.get("Sec-WebSocket-Version")
+        if websocket_version in ("7", "8", "13"):
+            params = _WebSocketParams(
+                ping_interval=self.ping_interval,
+                ping_timeout=self.ping_timeout,
+                max_message_size=self.max_message_size,
+                compression_options=self.get_compression_options(),
+            )
+            return WebSocketProtocol13(self, False, params)
+        return None
+
+    def _detach_stream(self) -> IOStream:
+        # disable non-WS methods
+        for method in [
+            "write",
+            "redirect",
+            "set_header",
+            "set_cookie",
+            "set_status",
+            "flush",
+            "finish",
+        ]:
+            setattr(self, method, _raise_not_supported_for_websockets)
+        return self.detach()
+
+
+def _raise_not_supported_for_websockets(*args: Any, **kwargs: Any) -> None:
+    raise RuntimeError("Method not supported for Web Sockets")
+
+
+class WebSocketProtocol(abc.ABC):
+    """Base class for WebSocket protocol versions."""
+
+    def __init__(self, handler: "_WebSocketDelegate") -> None:
+        self.handler = handler
+        self.stream = None  # type: Optional[IOStream]
+        self.client_terminated = False
+        self.server_terminated = False
+
+    def _run_callback(
+        self, callback: Callable, *args: Any, **kwargs: Any
+    ) -> "Optional[Future[Any]]":
+        """Runs the given callback with exception handling.
+
+        If the callback is a coroutine, returns its Future. On error, aborts the
+        websocket connection and returns None.
+        """
+        try:
+            result = callback(*args, **kwargs)
+        except Exception:
+            self.handler.log_exception(*sys.exc_info())
+            self._abort()
+            return None
+        else:
+            if result is not None:
+                result = gen.convert_yielded(result)
+                assert self.stream is not None
+                self.stream.io_loop.add_future(result, lambda f: f.result())
+            return result
+
+    def on_connection_close(self) -> None:
+        self._abort()
+
+    def _abort(self) -> None:
+        """Instantly aborts the WebSocket connection by closing the socket"""
+        self.client_terminated = True
+        self.server_terminated = True
+        if self.stream is not None:
+            self.stream.close()  # forcibly tear down the connection
+        self.close()  # let the subclass cleanup
+
+    @abc.abstractmethod
+    def close(self, code: Optional[int] = None, reason: Optional[str] = None) -> None:
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def is_closing(self) -> bool:
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    async def accept_connection(self, handler: WebSocketHandler) -> None:
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def write_message(
+        self, message: Union[str, bytes, Dict[str, Any]], binary: bool = False
+    ) -> "Future[None]":
+        raise NotImplementedError()
+
+    @property
+    @abc.abstractmethod
+    def selected_subprotocol(self) -> Optional[str]:
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def write_ping(self, data: bytes) -> None:
+        raise NotImplementedError()
+
+    # The entry points below are used by WebSocketClientConnection,
+    # which was introduced after we only supported a single version of
+    # WebSocketProtocol. The WebSocketProtocol/WebSocketProtocol13
+    # boundary is currently pretty ad-hoc.
+    @abc.abstractmethod
+    def _process_server_headers(
+        self, key: Union[str, bytes], headers: httputil.HTTPHeaders
+    ) -> None:
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def start_pinging(self) -> None:
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    async def _receive_frame_loop(self) -> None:
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def set_nodelay(self, x: bool) -> None:
+        raise NotImplementedError()
+
+
+class _PerMessageDeflateCompressor:
+    def __init__(
+        self,
+        persistent: bool,
+        max_wbits: Optional[int],
+        compression_options: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        if max_wbits is None:
+            max_wbits = zlib.MAX_WBITS
+        # There is no symbolic constant for the minimum wbits value.
+        if not (8 <= max_wbits <= zlib.MAX_WBITS):
+            raise ValueError(
+                "Invalid max_wbits value %r; allowed range 8-%d",
+                max_wbits,
+                zlib.MAX_WBITS,
+            )
+        self._max_wbits = max_wbits
+
+        if (
+            compression_options is None
+            or "compression_level" not in compression_options
+        ):
+            self._compression_level = tornado.web.GZipContentEncoding.GZIP_LEVEL
+        else:
+            self._compression_level = compression_options["compression_level"]
+
+        if compression_options is None or "mem_level" not in compression_options:
+            self._mem_level = 8
+        else:
+            self._mem_level = compression_options["mem_level"]
+
+        if persistent:
+            self._compressor = self._create_compressor()  # type: Optional[_Compressor]
+        else:
+            self._compressor = None
+
+    def _create_compressor(self) -> "_Compressor":
+        return zlib.compressobj(
+            self._compression_level, zlib.DEFLATED, -self._max_wbits, self._mem_level
+        )
+
+    def compress(self, data: bytes) -> bytes:
+        compressor = self._compressor or self._create_compressor()
+        data = compressor.compress(data) + compressor.flush(zlib.Z_SYNC_FLUSH)
+        assert data.endswith(b"\x00\x00\xff\xff")
+        return data[:-4]
+
+
+class _PerMessageDeflateDecompressor:
+    def __init__(
+        self,
+        persistent: bool,
+        max_wbits: Optional[int],
+        max_message_size: int,
+        compression_options: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        self._max_message_size = max_message_size
+        if max_wbits is None:
+            max_wbits = zlib.MAX_WBITS
+        if not (8 <= max_wbits <= zlib.MAX_WBITS):
+            raise ValueError(
+                "Invalid max_wbits value %r; allowed range 8-%d",
+                max_wbits,
+                zlib.MAX_WBITS,
+            )
+        self._max_wbits = max_wbits
+        if persistent:
+            self._decompressor = (
+                self._create_decompressor()
+            )  # type: Optional[_Decompressor]
+        else:
+            self._decompressor = None
+
+    def _create_decompressor(self) -> "_Decompressor":
+        return zlib.decompressobj(-self._max_wbits)
+
+    def decompress(self, data: bytes) -> bytes:
+        decompressor = self._decompressor or self._create_decompressor()
+        result = decompressor.decompress(
+            data + b"\x00\x00\xff\xff", self._max_message_size
+        )
+        if decompressor.unconsumed_tail:
+            raise _DecompressTooLargeError()
+        return result
+
+
+class WebSocketProtocol13(WebSocketProtocol):
+    """Implementation of the WebSocket protocol from RFC 6455.
+
+    This class supports versions 7 and 8 of the protocol in addition to the
+    final version 13.
+    """
+
+    # Bit masks for the first byte of a frame.
+    FIN = 0x80
+    RSV1 = 0x40
+    RSV2 = 0x20
+    RSV3 = 0x10
+    RSV_MASK = RSV1 | RSV2 | RSV3
+    OPCODE_MASK = 0x0F
+
+    stream = None  # type: IOStream
+
+    def __init__(
+        self,
+        handler: "_WebSocketDelegate",
+        mask_outgoing: bool,
+        params: _WebSocketParams,
+    ) -> None:
+        WebSocketProtocol.__init__(self, handler)
+        self.mask_outgoing = mask_outgoing
+        self.params = params
+        self._final_frame = False
+        self._frame_opcode = None
+        self._masked_frame = None
+        self._frame_mask = None  # type: Optional[bytes]
+        self._frame_length = None
+        self._fragmented_message_buffer = None  # type: Optional[bytearray]
+        self._fragmented_message_opcode = None
+        self._waiting = None  # type: object
+        self._compression_options = params.compression_options
+        self._decompressor = None  # type: Optional[_PerMessageDeflateDecompressor]
+        self._compressor = None  # type: Optional[_PerMessageDeflateCompressor]
+        self._frame_compressed = None  # type: Optional[bool]
+        # The total uncompressed size of all messages received or sent.
+        # Unicode messages are encoded to utf8.
+        # Only for testing; subject to change.
+        self._message_bytes_in = 0
+        self._message_bytes_out = 0
+        # The total size of all packets received or sent.  Includes
+        # the effect of compression, frame overhead, and control frames.
+        self._wire_bytes_in = 0
+        self._wire_bytes_out = 0
+        self._received_pong = False  # type: bool
+        self.close_code = None  # type: Optional[int]
+        self.close_reason = None  # type: Optional[str]
+        self._ping_coroutine = None  # type: Optional[asyncio.Task]
+
+    # Use a property for this to satisfy the abc.
+    @property
+    def selected_subprotocol(self) -> Optional[str]:
+        return self._selected_subprotocol
+
+    @selected_subprotocol.setter
+    def selected_subprotocol(self, value: Optional[str]) -> None:
+        self._selected_subprotocol = value
+
+    async def accept_connection(self, handler: WebSocketHandler) -> None:
+        try:
+            self._handle_websocket_headers(handler)
+        except ValueError:
+            handler.set_status(400)
+            log_msg = "Missing/Invalid WebSocket headers"
+            handler.finish(log_msg)
+            gen_log.debug(log_msg)
+            return
+
+        try:
+            await self._accept_connection(handler)
+        except asyncio.CancelledError:
+            self._abort()
+            return
+        except ValueError:
+            gen_log.debug("Malformed WebSocket request received", exc_info=True)
+            self._abort()
+            return
+
+    def _handle_websocket_headers(self, handler: WebSocketHandler) -> None:
+        """Verifies all invariant- and required headers
+
+        If a header is missing or have an incorrect value ValueError will be
+        raised
+        """
+        fields = ("Host", "Sec-Websocket-Key", "Sec-Websocket-Version")
+        if not all(map(lambda f: handler.request.headers.get(f), fields)):
+            raise ValueError("Missing/Invalid WebSocket headers")
+
+    @staticmethod
+    def compute_accept_value(key: Union[str, bytes]) -> str:
+        """Computes the value for the Sec-WebSocket-Accept header,
+        given the value for Sec-WebSocket-Key.
+        """
+        sha1 = hashlib.sha1()
+        sha1.update(utf8(key))
+        sha1.update(b"258EAFA5-E914-47DA-95CA-C5AB0DC85B11")  # Magic value
+        return native_str(base64.b64encode(sha1.digest()))
+
+    def _challenge_response(self, handler: WebSocketHandler) -> str:
+        return WebSocketProtocol13.compute_accept_value(
+            cast(str, handler.request.headers.get("Sec-Websocket-Key"))
+        )
+
+    async def _accept_connection(self, handler: WebSocketHandler) -> None:
+        subprotocol_header = handler.request.headers.get("Sec-WebSocket-Protocol")
+        if subprotocol_header:
+            subprotocols = [s.strip() for s in subprotocol_header.split(",")]
+        else:
+            subprotocols = []
+        self.selected_subprotocol = handler.select_subprotocol(subprotocols)
+        if self.selected_subprotocol:
+            assert self.selected_subprotocol in subprotocols
+            handler.set_header("Sec-WebSocket-Protocol", self.selected_subprotocol)
+
+        extensions = self._parse_extensions_header(handler.request.headers)
+        for ext in extensions:
+            if ext[0] == "permessage-deflate" and self._compression_options is not None:
+                # TODO: negotiate parameters if compression_options
+                # specifies limits.
+                self._create_compressors("server", ext[1], self._compression_options)
+                if (
+                    "client_max_window_bits" in ext[1]
+                    and ext[1]["client_max_window_bits"] is None
+                ):
+                    # Don't echo an offered client_max_window_bits
+                    # parameter with no value.
+                    del ext[1]["client_max_window_bits"]
+                handler.set_header(
+                    "Sec-WebSocket-Extensions",
+                    httputil._encode_header("permessage-deflate", ext[1]),
+                )
+                break
+
+        handler.clear_header("Content-Type")
+        handler.set_status(101)
+        handler.set_header("Upgrade", "websocket")
+        handler.set_header("Connection", "Upgrade")
+        handler.set_header("Sec-WebSocket-Accept", self._challenge_response(handler))
+        handler.finish()
+
+        self.stream = handler._detach_stream()
+
+        self.start_pinging()
+        try:
+            open_result = handler.open(*handler.open_args, **handler.open_kwargs)
+            if open_result is not None:
+                await open_result
+        except Exception:
+            handler.log_exception(*sys.exc_info())
+            self._abort()
+            return
+
+        await self._receive_frame_loop()
+
+    def _parse_extensions_header(
+        self, headers: httputil.HTTPHeaders
+    ) -> List[Tuple[str, Dict[str, str]]]:
+        extensions = headers.get("Sec-WebSocket-Extensions", "")
+        if extensions:
+            return [httputil._parse_header(e.strip()) for e in extensions.split(",")]
+        return []
+
+    def _process_server_headers(
+        self, key: Union[str, bytes], headers: httputil.HTTPHeaders
+    ) -> None:
+        """Process the headers sent by the server to this client connection.
+
+        'key' is the websocket handshake challenge/response key.
+        """
+        assert headers["Upgrade"].lower() == "websocket"
+        assert headers["Connection"].lower() == "upgrade"
+        accept = self.compute_accept_value(key)
+        assert headers["Sec-Websocket-Accept"] == accept
+
+        extensions = self._parse_extensions_header(headers)
+        for ext in extensions:
+            if ext[0] == "permessage-deflate" and self._compression_options is not None:
+                self._create_compressors("client", ext[1])
+            else:
+                raise ValueError("unsupported extension %r", ext)
+
+        self.selected_subprotocol = headers.get("Sec-WebSocket-Protocol", None)
+
+    def _get_compressor_options(
+        self,
+        side: str,
+        agreed_parameters: Dict[str, Any],
+        compression_options: Optional[Dict[str, Any]] = None,
+    ) -> Dict[str, Any]:
+        """Converts a websocket agreed_parameters set to keyword arguments
+        for our compressor objects.
+        """
+        options = dict(
+            persistent=(side + "_no_context_takeover") not in agreed_parameters
+        )  # type: Dict[str, Any]
+        wbits_header = agreed_parameters.get(side + "_max_window_bits", None)
+        if wbits_header is None:
+            options["max_wbits"] = zlib.MAX_WBITS
+        else:
+            options["max_wbits"] = int(wbits_header)
+        options["compression_options"] = compression_options
+        return options
+
+    def _create_compressors(
+        self,
+        side: str,
+        agreed_parameters: Dict[str, Any],
+        compression_options: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        # TODO: handle invalid parameters gracefully
+        allowed_keys = {
+            "server_no_context_takeover",
+            "client_no_context_takeover",
+            "server_max_window_bits",
+            "client_max_window_bits",
+        }
+        for key in agreed_parameters:
+            if key not in allowed_keys:
+                raise ValueError("unsupported compression parameter %r" % key)
+        other_side = "client" if (side == "server") else "server"
+        self._compressor = _PerMessageDeflateCompressor(
+            **self._get_compressor_options(side, agreed_parameters, compression_options)
+        )
+        self._decompressor = _PerMessageDeflateDecompressor(
+            max_message_size=self.params.max_message_size,
+            **self._get_compressor_options(
+                other_side, agreed_parameters, compression_options
+            ),
+        )
+
+    def _write_frame(
+        self, fin: bool, opcode: int, data: bytes, flags: int = 0
+    ) -> "Future[None]":
+        data_len = len(data)
+        if opcode & 0x8:
+            # All control frames MUST have a payload length of 125
+            # bytes or less and MUST NOT be fragmented.
+            if not fin:
+                raise ValueError("control frames may not be fragmented")
+            if data_len > 125:
+                raise ValueError("control frame payloads may not exceed 125 bytes")
+        if fin:
+            finbit = self.FIN
+        else:
+            finbit = 0
+        frame = struct.pack("B", finbit | opcode | flags)
+        if self.mask_outgoing:
+            mask_bit = 0x80
+        else:
+            mask_bit = 0
+        if data_len < 126:
+            frame += struct.pack("B", data_len | mask_bit)
+        elif data_len <= 0xFFFF:
+            frame += struct.pack("!BH", 126 | mask_bit, data_len)
+        else:
+            frame += struct.pack("!BQ", 127 | mask_bit, data_len)
+        if self.mask_outgoing:
+            mask = os.urandom(4)
+            data = mask + _websocket_mask(mask, data)
+        frame += data
+        self._wire_bytes_out += len(frame)
+        return self.stream.write(frame)
+
+    def write_message(
+        self, message: Union[str, bytes, Dict[str, Any]], binary: bool = False
+    ) -> "Future[None]":
+        """Sends the given message to the client of this Web Socket."""
+        if binary:
+            opcode = 0x2
+        else:
+            opcode = 0x1
+        if isinstance(message, dict):
+            message = tornado.escape.json_encode(message)
+        message = tornado.escape.utf8(message)
+        assert isinstance(message, bytes)
+        self._message_bytes_out += len(message)
+        flags = 0
+        if self._compressor:
+            message = self._compressor.compress(message)
+            flags |= self.RSV1
+        # For historical reasons, write methods in Tornado operate in a semi-synchronous
+        # mode in which awaiting the Future they return is optional (But errors can
+        # still be raised). This requires us to go through an awkward dance here
+        # to transform the errors that may be returned while presenting the same
+        # semi-synchronous interface.
+        try:
+            fut = self._write_frame(True, opcode, message, flags=flags)
+        except StreamClosedError:
+            raise WebSocketClosedError()
+
+        async def wrapper() -> None:
+            try:
+                await fut
+            except StreamClosedError:
+                raise WebSocketClosedError()
+
+        return asyncio.ensure_future(wrapper())
+
+    def write_ping(self, data: bytes) -> None:
+        """Send ping frame."""
+        assert isinstance(data, bytes)
+        self._write_frame(True, 0x9, data)
+
+    async def _receive_frame_loop(self) -> None:
+        try:
+            while not self.client_terminated:
+                await self._receive_frame()
+        except StreamClosedError:
+            self._abort()
+        self.handler.on_ws_connection_close(self.close_code, self.close_reason)
+
+    async def _read_bytes(self, n: int) -> bytes:
+        data = await self.stream.read_bytes(n)
+        self._wire_bytes_in += n
+        return data
+
+    async def _receive_frame(self) -> None:
+        # Read the frame header.
+        data = await self._read_bytes(2)
+        header, mask_payloadlen = struct.unpack("BB", data)
+        is_final_frame = header & self.FIN
+        reserved_bits = header & self.RSV_MASK
+        opcode = header & self.OPCODE_MASK
+        opcode_is_control = opcode & 0x8
+        if self._decompressor is not None and opcode != 0:
+            # Compression flag is present in the first frame's header,
+            # but we can't decompress until we have all the frames of
+            # the message.
+            self._frame_compressed = bool(reserved_bits & self.RSV1)
+            reserved_bits &= ~self.RSV1
+        if reserved_bits:
+            # client is using as-yet-undefined extensions; abort
+            self._abort()
+            return
+        is_masked = bool(mask_payloadlen & 0x80)
+        payloadlen = mask_payloadlen & 0x7F
+
+        # Parse and validate the length.
+        if opcode_is_control and payloadlen >= 126:
+            # control frames must have payload < 126
+            self._abort()
+            return
+        if payloadlen < 126:
+            self._frame_length = payloadlen
+        elif payloadlen == 126:
+            data = await self._read_bytes(2)
+            payloadlen = struct.unpack("!H", data)[0]
+        elif payloadlen == 127:
+            data = await self._read_bytes(8)
+            payloadlen = struct.unpack("!Q", data)[0]
+        new_len = payloadlen
+        if self._fragmented_message_buffer is not None:
+            new_len += len(self._fragmented_message_buffer)
+        if new_len > self.params.max_message_size:
+            self.close(1009, "message too big")
+            self._abort()
+            return
+
+        # Read the payload, unmasking if necessary.
+        if is_masked:
+            self._frame_mask = await self._read_bytes(4)
+        data = await self._read_bytes(payloadlen)
+        if is_masked:
+            assert self._frame_mask is not None
+            data = _websocket_mask(self._frame_mask, data)
+
+        # Decide what to do with this frame.
+        if opcode_is_control:
+            # control frames may be interleaved with a series of fragmented
+            # data frames, so control frames must not interact with
+            # self._fragmented_*
+            if not is_final_frame:
+                # control frames must not be fragmented
+                self._abort()
+                return
+        elif opcode == 0:  # continuation frame
+            if self._fragmented_message_buffer is None:
+                # nothing to continue
+                self._abort()
+                return
+            self._fragmented_message_buffer.extend(data)
+            if is_final_frame:
+                opcode = self._fragmented_message_opcode
+                data = bytes(self._fragmented_message_buffer)
+                self._fragmented_message_buffer = None
+        else:  # start of new data message
+            if self._fragmented_message_buffer is not None:
+                # can't start new message until the old one is finished
+                self._abort()
+                return
+            if not is_final_frame:
+                self._fragmented_message_opcode = opcode
+                self._fragmented_message_buffer = bytearray(data)
+
+        if is_final_frame:
+            handled_future = self._handle_message(opcode, data)
+            if handled_future is not None:
+                await handled_future
+
+    def _handle_message(self, opcode: int, data: bytes) -> "Optional[Future[None]]":
+        """Execute on_message, returning its Future if it is a coroutine."""
+        if self.client_terminated:
+            return None
+
+        if self._frame_compressed:
+            assert self._decompressor is not None
+            try:
+                data = self._decompressor.decompress(data)
+            except _DecompressTooLargeError:
+                self.close(1009, "message too big after decompression")
+                self._abort()
+                return None
+
+        if opcode == 0x1:
+            # UTF-8 data
+            self._message_bytes_in += len(data)
+            try:
+                decoded = data.decode("utf-8")
+            except UnicodeDecodeError:
+                self._abort()
+                return None
+            return self._run_callback(self.handler.on_message, decoded)
+        elif opcode == 0x2:
+            # Binary data
+            self._message_bytes_in += len(data)
+            return self._run_callback(self.handler.on_message, data)
+        elif opcode == 0x8:
+            # Close
+            self.client_terminated = True
+            if len(data) >= 2:
+                self.close_code = struct.unpack(">H", data[:2])[0]
+            if len(data) > 2:
+                self.close_reason = to_unicode(data[2:])
+            # Echo the received close code, if any (RFC 6455 section 5.5.1).
+            self.close(self.close_code)
+        elif opcode == 0x9:
+            # Ping
+            try:
+                self._write_frame(True, 0xA, data)
+            except StreamClosedError:
+                self._abort()
+            self._run_callback(self.handler.on_ping, data)
+        elif opcode == 0xA:
+            # Pong
+            self._received_pong = True
+            return self._run_callback(self.handler.on_pong, data)
+        else:
+            self._abort()
+        return None
+
+    def close(self, code: Optional[int] = None, reason: Optional[str] = None) -> None:
+        """Closes the WebSocket connection."""
+        if not self.server_terminated:
+            if not self.stream.closed():
+                if code is None and reason is not None:
+                    code = 1000  # "normal closure" status code
+                if code is None:
+                    close_data = b""
+                else:
+                    close_data = struct.pack(">H", code)
+                if reason is not None:
+                    close_data += utf8(reason)
+                try:
+                    self._write_frame(True, 0x8, close_data)
+                except StreamClosedError:
+                    self._abort()
+            self.server_terminated = True
+        if self.client_terminated:
+            if self._waiting is not None:
+                self.stream.io_loop.remove_timeout(self._waiting)
+                self._waiting = None
+            self.stream.close()
+        elif self._waiting is None:
+            # Give the client a few seconds to complete a clean shutdown,
+            # otherwise just close the connection.
+            self._waiting = self.stream.io_loop.add_timeout(
+                self.stream.io_loop.time() + 5, self._abort
+            )
+        if self._ping_coroutine:
+            self._ping_coroutine.cancel()
+            self._ping_coroutine = None
+
+    def is_closing(self) -> bool:
+        """Return ``True`` if this connection is closing.
+
+        The connection is considered closing if either side has
+        initiated its closing handshake or if the stream has been
+        shut down uncleanly.
+        """
+        return self.stream.closed() or self.client_terminated or self.server_terminated
+
+    def set_nodelay(self, x: bool) -> None:
+        self.stream.set_nodelay(x)
+
+    @property
+    def ping_interval(self) -> float:
+        interval = self.params.ping_interval
+        if interval is not None:
+            return interval
+        return 0
+
+    @property
+    def ping_timeout(self) -> float:
+        timeout = self.params.ping_timeout
+        if timeout is not None:
+            if self.ping_interval and timeout > self.ping_interval:
+                de_dupe_gen_log(
+                    # Note: using de_dupe_gen_log to prevent this message from
+                    # being duplicated for each connection
+                    logging.WARNING,
+                    f"The websocket_ping_timeout ({timeout}) cannot be longer"
+                    f" than the websocket_ping_interval ({self.ping_interval})."
+                    f"\nSetting websocket_ping_timeout={self.ping_interval}",
+                )
+                return self.ping_interval
+            return timeout
+        return self.ping_interval
+
+    def start_pinging(self) -> None:
+        """Start sending periodic pings to keep the connection alive"""
+        if (
+            # prevent multiple ping coroutines being run in parallel
+            not self._ping_coroutine
+            # only run the ping coroutine if a ping interval is configured
+            and self.ping_interval > 0
+        ):
+            self._ping_coroutine = asyncio.create_task(self.periodic_ping())
+
+    @staticmethod
+    def ping_sleep_time(*, last_ping_time: float, interval: float, now: float) -> float:
+        """Calculate the sleep time until the next ping should be sent."""
+        return max(0, last_ping_time + interval - now)
+
+    async def periodic_ping(self) -> None:
+        """Send a ping and wait for a pong if ping_timeout is configured.
+
+        Called periodically if the websocket_ping_interval is set and non-zero.
+        """
+        interval = self.ping_interval
+        timeout = self.ping_timeout
+
+        await asyncio.sleep(interval)
+
+        while True:
+            # send a ping
+            self._received_pong = False
+            ping_time = IOLoop.current().time()
+            self.write_ping(b"")
+
+            # wait until the ping timeout
+            await asyncio.sleep(timeout)
+
+            # make sure we received a pong within the timeout
+            if timeout > 0 and not self._received_pong:
+                self.close(reason="ping timed out")
+                return
+
+            # wait until the next scheduled ping
+            await asyncio.sleep(
+                self.ping_sleep_time(
+                    last_ping_time=ping_time,
+                    interval=interval,
+                    now=IOLoop.current().time(),
+                )
+            )
+
+
+class WebSocketClientConnection(simple_httpclient._HTTPConnection):
+    """WebSocket client connection.
+
+    This class should not be instantiated directly; use the
+    `websocket_connect` function instead.
+    """
+
+    protocol = None  # type: WebSocketProtocol
+
+    def __init__(
+        self,
+        request: httpclient.HTTPRequest,
+        on_message_callback: Optional[Callable[[Union[None, str, bytes]], None]] = None,
+        compression_options: Optional[Dict[str, Any]] = None,
+        ping_interval: Optional[float] = None,
+        ping_timeout: Optional[float] = None,
+        max_message_size: int = _default_max_message_size,
+        subprotocols: Optional[List[str]] = None,
+        resolver: Optional[Resolver] = None,
+    ) -> None:
+        self.connect_future = Future()  # type: Future[WebSocketClientConnection]
+        self.read_queue = Queue(1)  # type: Queue[Union[None, str, bytes]]
+        self.key = base64.b64encode(os.urandom(16))
+        self._on_message_callback = on_message_callback
+        self.close_code = None  # type: Optional[int]
+        self.close_reason = None  # type: Optional[str]
+        self.params = _WebSocketParams(
+            ping_interval=ping_interval,
+            ping_timeout=ping_timeout,
+            max_message_size=max_message_size,
+            compression_options=compression_options,
+        )
+
+        scheme, sep, rest = request.url.partition(":")
+        scheme = {"ws": "http", "wss": "https"}[scheme]
+        request.url = scheme + sep + rest
+        request.headers.update(
+            {
+                "Upgrade": "websocket",
+                "Connection": "Upgrade",
+                "Sec-WebSocket-Key": to_unicode(self.key),
+                "Sec-WebSocket-Version": "13",
+            }
+        )
+        if subprotocols is not None:
+            request.headers["Sec-WebSocket-Protocol"] = ",".join(subprotocols)
+        if compression_options is not None:
+            # Always offer to let the server set our max_wbits (and even though
+            # we don't offer it, we will accept a client_no_context_takeover
+            # from the server).
+            # TODO: set server parameters for deflate extension
+            # if requested in self.compression_options.
+            request.headers["Sec-WebSocket-Extensions"] = (
+                "permessage-deflate; client_max_window_bits"
+            )
+
+        # Websocket connection is currently unable to follow redirects
+        request.follow_redirects = False
+
+        self.tcp_client = TCPClient(resolver=resolver)
+        super().__init__(
+            None,
+            request,
+            lambda: None,
+            self._on_http_response,
+            104857600,
+            self.tcp_client,
+            65536,
+            104857600,
+        )
+
+    def __del__(self) -> None:
+        if self.protocol is not None:
+            # Unclosed client connections can sometimes log "task was destroyed but
+            # was pending" warnings if shutdown strikes at the wrong time (such as
+            # while a ping is being processed due to ping_interval). Log our own
+            # warning to make it a little more deterministic (although it's still
+            # dependent on GC timing).
+            warnings.warn("Unclosed WebSocketClientConnection", ResourceWarning)
+
+    def close(self, code: Optional[int] = None, reason: Optional[str] = None) -> None:
+        """Closes the websocket connection.
+
+        ``code`` and ``reason`` are documented under
+        `WebSocketHandler.close`.
+
+        .. versionadded:: 3.2
+
+        .. versionchanged:: 4.0
+
+           Added the ``code`` and ``reason`` arguments.
+        """
+        if self.protocol is not None:
+            self.protocol.close(code, reason)
+            self.protocol = None  # type: ignore
+
+    def on_connection_close(self) -> None:
+        if not self.connect_future.done():
+            self.connect_future.set_exception(StreamClosedError())
+        self._on_message(None)
+        self.tcp_client.close()
+        super().on_connection_close()
+
+    def on_ws_connection_close(
+        self, close_code: Optional[int] = None, close_reason: Optional[str] = None
+    ) -> None:
+        self.close_code = close_code
+        self.close_reason = close_reason
+        self.on_connection_close()
+
+    def _on_http_response(self, response: httpclient.HTTPResponse) -> None:
+        if not self.connect_future.done():
+            if response.error:
+                self.connect_future.set_exception(response.error)
+            else:
+                self.connect_future.set_exception(
+                    WebSocketError("Non-websocket response")
+                )
+
+    async def headers_received(
+        self,
+        start_line: Union[httputil.RequestStartLine, httputil.ResponseStartLine],
+        headers: httputil.HTTPHeaders,
+    ) -> None:
+        assert isinstance(start_line, httputil.ResponseStartLine)
+        if start_line.code != 101:
+            await super().headers_received(start_line, headers)
+            return
+
+        if self._timeout is not None:
+            self.io_loop.remove_timeout(self._timeout)
+            self._timeout = None
+
+        self.headers = headers
+        self.protocol = self.get_websocket_protocol()
+        self.protocol._process_server_headers(self.key, self.headers)
+        self.protocol.stream = self.connection.detach()
+
+        IOLoop.current().add_callback(self.protocol._receive_frame_loop)
+        self.protocol.start_pinging()
+
+        # Once we've taken over the connection, clear the final callback
+        # we set on the http request.  This deactivates the error handling
+        # in simple_httpclient that would otherwise interfere with our
+        # ability to see exceptions.
+        self.final_callback = None  # type: ignore
+
+        future_set_result_unless_cancelled(self.connect_future, self)
+
+    def write_message(
+        self, message: Union[str, bytes, Dict[str, Any]], binary: bool = False
+    ) -> "Future[None]":
+        """Sends a message to the WebSocket server.
+
+        If the stream is closed, raises `WebSocketClosedError`.
+        Returns a `.Future` which can be used for flow control.
+
+        .. versionchanged:: 5.0
+           Exception raised on a closed stream changed from `.StreamClosedError`
+           to `WebSocketClosedError`.
+        """
+        if self.protocol is None:
+            raise WebSocketClosedError("Client connection has been closed")
+        return self.protocol.write_message(message, binary=binary)
+
+    def read_message(
+        self,
+        callback: Optional[Callable[["Future[Union[None, str, bytes]]"], None]] = None,
+    ) -> Awaitable[Union[None, str, bytes]]:
+        """Reads a message from the WebSocket server.
+
+        If on_message_callback was specified at WebSocket
+        initialization, this function will never return messages
+
+        Returns a future whose result is the message, or None
+        if the connection is closed.  If a callback argument
+        is given it will be called with the future when it is
+        ready.
+        """
+
+        awaitable = self.read_queue.get()
+        if callback is not None:
+            self.io_loop.add_future(asyncio.ensure_future(awaitable), callback)
+        return awaitable
+
+    def on_message(self, message: Union[str, bytes]) -> Optional[Awaitable[None]]:
+        return self._on_message(message)
+
+    def _on_message(
+        self, message: Union[None, str, bytes]
+    ) -> Optional[Awaitable[None]]:
+        if self._on_message_callback:
+            self._on_message_callback(message)
+            return None
+        else:
+            return self.read_queue.put(message)
+
+    def ping(self, data: bytes = b"") -> None:
+        """Send ping frame to the remote end.
+
+        The data argument allows a small amount of data (up to 125
+        bytes) to be sent as a part of the ping message. Note that not
+        all websocket implementations expose this data to
+        applications.
+
+        Consider using the ``ping_interval`` argument to
+        `websocket_connect` instead of sending pings manually.
+
+        .. versionadded:: 5.1
+
+        """
+        data = utf8(data)
+        if self.protocol is None:
+            raise WebSocketClosedError()
+        self.protocol.write_ping(data)
+
+    def on_pong(self, data: bytes) -> None:
+        pass
+
+    def on_ping(self, data: bytes) -> None:
+        pass
+
+    def get_websocket_protocol(self) -> WebSocketProtocol:
+        return WebSocketProtocol13(self, mask_outgoing=True, params=self.params)
+
+    @property
+    def selected_subprotocol(self) -> Optional[str]:
+        """The subprotocol selected by the server.
+
+        .. versionadded:: 5.1
+        """
+        return self.protocol.selected_subprotocol
+
+    def log_exception(
+        self,
+        typ: "Optional[Type[BaseException]]",
+        value: Optional[BaseException],
+        tb: Optional[TracebackType],
+    ) -> None:
+        assert typ is not None
+        assert value is not None
+        app_log.error("Uncaught exception %s", value, exc_info=(typ, value, tb))
+
+
+def websocket_connect(
+    url: Union[str, httpclient.HTTPRequest],
+    callback: Optional[Callable[["Future[WebSocketClientConnection]"], None]] = None,
+    connect_timeout: Optional[float] = None,
+    on_message_callback: Optional[Callable[[Union[None, str, bytes]], None]] = None,
+    compression_options: Optional[Dict[str, Any]] = None,
+    ping_interval: Optional[float] = None,
+    ping_timeout: Optional[float] = None,
+    max_message_size: int = _default_max_message_size,
+    subprotocols: Optional[List[str]] = None,
+    resolver: Optional[Resolver] = None,
+) -> "Awaitable[WebSocketClientConnection]":
+    """Client-side websocket support.
+
+    Takes a url and returns a Future whose result is a
+    `WebSocketClientConnection`.
+
+    ``compression_options`` is interpreted in the same way as the
+    return value of `.WebSocketHandler.get_compression_options`.
+
+    The connection supports two styles of operation. In the coroutine
+    style, the application typically calls
+    `~.WebSocketClientConnection.read_message` in a loop::
+
+        conn = yield websocket_connect(url)
+        while True:
+            msg = yield conn.read_message()
+            if msg is None: break
+            # Do something with msg
+
+    In the callback style, pass an ``on_message_callback`` to
+    ``websocket_connect``. In both styles, a message of ``None``
+    indicates that the connection has been closed.
+
+    ``subprotocols`` may be a list of strings specifying proposed
+    subprotocols. The selected protocol may be found on the
+    ``selected_subprotocol`` attribute of the connection object
+    when the connection is complete.
+
+    .. versionchanged:: 3.2
+       Also accepts ``HTTPRequest`` objects in place of urls.
+
+    .. versionchanged:: 4.1
+       Added ``compression_options`` and ``on_message_callback``.
+
+    .. versionchanged:: 4.5
+       Added the ``ping_interval``, ``ping_timeout``, and ``max_message_size``
+       arguments, which have the same meaning as in `WebSocketHandler`.
+
+    .. versionchanged:: 5.0
+       The ``io_loop`` argument (deprecated since version 4.1) has been removed.
+
+    .. versionchanged:: 5.1
+       Added the ``subprotocols`` argument.
+
+    .. versionchanged:: 6.3
+       Added the ``resolver`` argument.
+
+    .. deprecated:: 6.5
+       The ``callback`` argument is deprecated and will be removed in Tornado 7.0.
+       Use the returned Future instead. Note that ``on_message_callback`` is not
+       deprecated and may still be used.
+    """
+    if isinstance(url, httpclient.HTTPRequest):
+        assert connect_timeout is None
+        request = url
+        # Copy and convert the headers dict/object (see comments in
+        # AsyncHTTPClient.fetch)
+        request.headers = httputil.HTTPHeaders(request.headers)
+    else:
+        request = httpclient.HTTPRequest(url, connect_timeout=connect_timeout)
+    request = cast(
+        httpclient.HTTPRequest,
+        httpclient._RequestProxy(request, httpclient.HTTPRequest._DEFAULTS),
+    )
+    conn = WebSocketClientConnection(
+        request,
+        on_message_callback=on_message_callback,
+        compression_options=compression_options,
+        ping_interval=ping_interval,
+        ping_timeout=ping_timeout,
+        max_message_size=max_message_size,
+        subprotocols=subprotocols,
+        resolver=resolver,
+    )
+    if callback is not None:
+        warnings.warn(
+            "The callback argument to websocket_connect is deprecated. "
+            "Use the returned Future instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        IOLoop.current().add_future(conn.connect_future, callback)
+    return conn.connect_future
diff --git a/env/lib/python3.12/site-packages/tornado/wsgi.py b/env/lib/python3.12/site-packages/tornado/wsgi.py
new file mode 100644
index 0000000..c189562
--- /dev/null
+++ b/env/lib/python3.12/site-packages/tornado/wsgi.py
@@ -0,0 +1,268 @@
+#
+# Copyright 2009 Facebook
+#
+# 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.
+
+"""WSGI support for the Tornado web framework.
+
+WSGI is the Python standard for web servers, and allows for interoperability
+between Tornado and other Python web frameworks and servers.
+
+This module provides WSGI support via the `WSGIContainer` class, which
+makes it possible to run applications using other WSGI frameworks on
+the Tornado HTTP server. The reverse is not supported; the Tornado
+`.Application` and `.RequestHandler` classes are designed for use with
+the Tornado `.HTTPServer` and cannot be used in a generic WSGI
+container.
+
+"""
+
+import concurrent.futures
+from io import BytesIO
+import tornado
+import sys
+
+from tornado.concurrent import dummy_executor
+from tornado import escape
+from tornado import httputil
+from tornado.ioloop import IOLoop
+from tornado.log import access_log
+
+from typing import List, Tuple, Optional, Callable, Any, Dict
+from types import TracebackType
+import typing
+
+if typing.TYPE_CHECKING:
+    from typing import Type  # noqa: F401
+    from _typeshed.wsgi import WSGIApplication as WSGIAppType  # noqa: F401
+
+
+# PEP 3333 specifies that WSGI on python 3 generally deals with byte strings
+# that are smuggled inside objects of type unicode (via the latin1 encoding).
+# This function is like those in the tornado.escape module, but defined
+# here to minimize the temptation to use it in non-wsgi contexts.
+def to_wsgi_str(s: bytes) -> str:
+    assert isinstance(s, bytes)
+    return s.decode("latin1")
+
+
+class WSGIContainer:
+    r"""Makes a WSGI-compatible application runnable on Tornado's HTTP server.
+
+    .. warning::
+
+       WSGI is a *synchronous* interface, while Tornado's concurrency model
+       is based on single-threaded *asynchronous* execution.  Many of Tornado's
+       distinguishing features are not available in WSGI mode, including efficient
+       long-polling and websockets. The primary purpose of `WSGIContainer` is
+       to support both WSGI applications and native Tornado ``RequestHandlers`` in
+       a single process. WSGI-only applications are likely to be better off
+       with a dedicated WSGI server such as ``gunicorn`` or ``uwsgi``.
+
+    Wrap a WSGI application in a `WSGIContainer` to make it implement the Tornado
+    `.HTTPServer` ``request_callback`` interface.  The `WSGIContainer` object can
+    then be passed to classes from the `tornado.routing` module,
+    `tornado.web.FallbackHandler`, or to `.HTTPServer` directly.
+
+    This class is intended to let other frameworks (Django, Flask, etc)
+    run on the Tornado HTTP server and I/O loop.
+
+    Realistic usage will be more complicated, but the simplest possible example uses a
+    hand-written WSGI application with `.HTTPServer`::
+
+        def simple_app(environ, start_response):
+            status = "200 OK"
+            response_headers = [("Content-type", "text/plain")]
+            start_response(status, response_headers)
+            return [b"Hello world!\n"]
+
+        async def main():
+            container = tornado.wsgi.WSGIContainer(simple_app)
+            http_server = tornado.httpserver.HTTPServer(container)
+            http_server.listen(8888)
+            await asyncio.Event().wait()
+
+        asyncio.run(main())
+
+    The recommended pattern is to use the `tornado.routing` module to set up routing
+    rules between your WSGI application and, typically, a `tornado.web.Application`.
+    Alternatively, `tornado.web.Application` can be used as the top-level router
+    and `tornado.web.FallbackHandler` can embed a `WSGIContainer` within it.
+
+    If the ``executor`` argument is provided, the WSGI application will be executed
+    on that executor. This must be an instance of `concurrent.futures.Executor`,
+    typically a ``ThreadPoolExecutor`` (``ProcessPoolExecutor`` is not supported).
+    If no ``executor`` is given, the application will run on the event loop thread in
+    Tornado 6.3; this will change to use an internal thread pool by default in
+    Tornado 7.0.
+
+    .. warning::
+       By default, the WSGI application is executed on the event loop's thread. This
+       limits the server to one request at a time (per process), making it less scalable
+       than most other WSGI servers. It is therefore highly recommended that you pass
+       a ``ThreadPoolExecutor`` when constructing the `WSGIContainer`, after verifying
+       that your application is thread-safe. The default will change to use a
+       ``ThreadPoolExecutor`` in Tornado 7.0.
+
+    .. versionadded:: 6.3
+       The ``executor`` parameter.
+
+    .. deprecated:: 6.3
+       The default behavior of running the WSGI application on the event loop thread
+       is deprecated and will change in Tornado 7.0 to use a thread pool by default.
+    """
+
+    def __init__(
+        self,
+        wsgi_application: "WSGIAppType",
+        executor: Optional[concurrent.futures.Executor] = None,
+    ) -> None:
+        self.wsgi_application = wsgi_application
+        self.executor = dummy_executor if executor is None else executor
+
+    def __call__(self, request: httputil.HTTPServerRequest) -> None:
+        IOLoop.current().spawn_callback(self.handle_request, request)
+
+    async def handle_request(self, request: httputil.HTTPServerRequest) -> None:
+        data = {}  # type: Dict[str, Any]
+        response = []  # type: List[bytes]
+
+        def start_response(
+            status: str,
+            headers: List[Tuple[str, str]],
+            exc_info: Optional[
+                Tuple[
+                    "Optional[Type[BaseException]]",
+                    Optional[BaseException],
+                    Optional[TracebackType],
+                ]
+            ] = None,
+        ) -> Callable[[bytes], Any]:
+            data["status"] = status
+            data["headers"] = headers
+            return response.append
+
+        loop = IOLoop.current()
+        app_response = await loop.run_in_executor(
+            self.executor,
+            self.wsgi_application,
+            self.environ(request),
+            start_response,
+        )
+        try:
+            app_response_iter = iter(app_response)
+
+            def next_chunk() -> Optional[bytes]:
+                try:
+                    return next(app_response_iter)
+                except StopIteration:
+                    # StopIteration is special and is not allowed to pass through
+                    # coroutines normally.
+                    return None
+
+            while True:
+                chunk = await loop.run_in_executor(self.executor, next_chunk)
+                if chunk is None:
+                    break
+                response.append(chunk)
+        finally:
+            if hasattr(app_response, "close"):
+                app_response.close()  # type: ignore
+        body = b"".join(response)
+        if not data:
+            raise Exception("WSGI app did not call start_response")
+
+        status_code_str, reason = data["status"].split(" ", 1)
+        status_code = int(status_code_str)
+        headers = data["headers"]  # type: List[Tuple[str, str]]
+        header_set = {k.lower() for (k, v) in headers}
+        body = escape.utf8(body)
+        if status_code != 304:
+            if "content-length" not in header_set:
+                headers.append(("Content-Length", str(len(body))))
+            if "content-type" not in header_set:
+                headers.append(("Content-Type", "text/html; charset=UTF-8"))
+        if "server" not in header_set:
+            headers.append(("Server", "TornadoServer/%s" % tornado.version))
+
+        start_line = httputil.ResponseStartLine("HTTP/1.1", status_code, reason)
+        header_obj = httputil.HTTPHeaders()
+        for key, value in headers:
+            header_obj.add(key, value)
+        assert request.connection is not None
+        request.connection.write_headers(start_line, header_obj, chunk=body)
+        request.connection.finish()
+        self._log(status_code, request)
+
+    def environ(self, request: httputil.HTTPServerRequest) -> Dict[str, Any]:
+        """Converts a `tornado.httputil.HTTPServerRequest` to a WSGI environment.
+
+        .. versionchanged:: 6.3
+           No longer a static method.
+        """
+        hostport = request.host.split(":")
+        if len(hostport) == 2:
+            host = hostport[0]
+            port = int(hostport[1])
+        else:
+            host = request.host
+            port = 443 if request.protocol == "https" else 80
+        environ = {
+            "REQUEST_METHOD": request.method,
+            "SCRIPT_NAME": "",
+            "PATH_INFO": to_wsgi_str(
+                escape.url_unescape(request.path, encoding=None, plus=False)
+            ),
+            "QUERY_STRING": request.query,
+            "REMOTE_ADDR": request.remote_ip,
+            "SERVER_NAME": host,
+            "SERVER_PORT": str(port),
+            "SERVER_PROTOCOL": request.version,
+            "wsgi.version": (1, 0),
+            "wsgi.url_scheme": request.protocol,
+            "wsgi.input": BytesIO(escape.utf8(request.body)),
+            "wsgi.errors": sys.stderr,
+            "wsgi.multithread": self.executor is not dummy_executor,
+            "wsgi.multiprocess": True,
+            "wsgi.run_once": False,
+        }
+        if "Content-Type" in request.headers:
+            environ["CONTENT_TYPE"] = request.headers.pop("Content-Type")
+        if "Content-Length" in request.headers:
+            environ["CONTENT_LENGTH"] = request.headers.pop("Content-Length")
+        for key, value in request.headers.items():
+            environ["HTTP_" + key.replace("-", "_").upper()] = value
+        return environ
+
+    def _log(self, status_code: int, request: httputil.HTTPServerRequest) -> None:
+        if status_code < 400:
+            log_method = access_log.info
+        elif status_code < 500:
+            log_method = access_log.warning
+        else:
+            log_method = access_log.error
+        request_time = 1000.0 * request.request_time()
+        assert request.method is not None
+        assert request.uri is not None
+        summary = (
+            request.method  # type: ignore[operator]
+            + " "
+            + request.uri
+            + " ("
+            + request.remote_ip
+            + ")"
+        )
+        log_method("%d %s %.2fms", status_code, summary, request_time)
+
+
+HTTPRequest = httputil.HTTPServerRequest
diff --git a/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/INSTALLER b/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/METADATA b/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/METADATA
new file mode 100644
index 0000000..7778225
--- /dev/null
+++ b/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/METADATA
@@ -0,0 +1,282 @@
+Metadata-Version: 2.3
+Name: traitlets
+Version: 5.14.3
+Summary: Traitlets Python configuration system
+Project-URL: Homepage, https://github.com/ipython/traitlets
+Project-URL: Documentation, https://traitlets.readthedocs.io
+Project-URL: Source, https://github.com/ipython/traitlets
+Project-URL: Funding, https://numfocus.org
+Project-URL: Tracker, https://github.com/ipython/traitlets/issues
+Author-email: IPython Development Team 
+License: BSD 3-Clause License
+        
+        - Copyright (c) 2001-, IPython Development Team
+        
+        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.
+        
+        2. 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.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           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 COPYRIGHT HOLDER 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.
+License-File: LICENSE
+Keywords: Interactive,Interpreter,Shell,Web
+Classifier: Framework :: IPython
+Classifier: Framework :: Jupyter
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Provides-Extra: docs
+Requires-Dist: myst-parser; extra == 'docs'
+Requires-Dist: pydata-sphinx-theme; extra == 'docs'
+Requires-Dist: sphinx; extra == 'docs'
+Provides-Extra: test
+Requires-Dist: argcomplete>=3.0.3; extra == 'test'
+Requires-Dist: mypy>=1.7.0; extra == 'test'
+Requires-Dist: pre-commit; extra == 'test'
+Requires-Dist: pytest-mock; extra == 'test'
+Requires-Dist: pytest-mypy-testing; extra == 'test'
+Requires-Dist: pytest<8.2,>=7.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Traitlets
+
+[![Tests](https://github.com/ipython/traitlets/actions/workflows/tests.yml/badge.svg)](https://github.com/ipython/traitlets/actions/workflows/tests.yml)
+[![Documentation Status](https://readthedocs.org/projects/traitlets/badge/?version=latest)](https://traitlets.readthedocs.io/en/latest/?badge=latest)
+[![Tidelift](https://tidelift.com/subscription/pkg/pypi-traitlets)](https://tidelift.com/badges/package/pypi/traitlets)
+
+|               |                                      |
+| ------------- | ------------------------------------ |
+| **home**      | https://github.com/ipython/traitlets |
+| **pypi-repo** | https://pypi.org/project/traitlets/  |
+| **docs**      | https://traitlets.readthedocs.io/    |
+| **license**   | Modified BSD License                 |
+
+Traitlets is a pure Python library enabling:
+
+- the enforcement of strong typing for attributes of Python objects
+  (typed attributes are called _"traits"_);
+- dynamically calculated default values;
+- automatic validation and coercion of trait attributes when attempting a
+  change;
+- registering for receiving notifications when trait values change;
+- reading configuring values from files or from command line
+  arguments - a distinct layer on top of traitlets, so you may use
+  traitlets without the configuration machinery.
+
+Its implementation relies on the [descriptor](https://docs.python.org/howto/descriptor.html)
+pattern, and it is a lightweight pure-python alternative of the
+[_traits_ library](https://docs.enthought.com/traits/).
+
+Traitlets powers the configuration system of IPython and Jupyter
+and the declarative API of IPython interactive widgets.
+
+## Installation
+
+For a local installation, make sure you have
+[pip installed](https://pip.pypa.io/en/stable/installing/) and run:
+
+```bash
+pip install traitlets
+```
+
+For a **development installation**, clone this repository, change into the
+`traitlets` root directory, and run pip:
+
+```bash
+git clone https://github.com/ipython/traitlets.git
+cd traitlets
+pip install -e .
+```
+
+## Running the tests
+
+```bash
+pip install "traitlets[test]"
+py.test traitlets
+```
+
+## Code Styling
+
+`traitlets` has adopted automatic code formatting so you shouldn't
+need to worry too much about your code style.
+As long as your code is valid,
+the pre-commit hook should take care of how it should look.
+
+To install `pre-commit` locally, run the following::
+
+```
+pip install pre-commit
+pre-commit install
+```
+
+You can invoke the pre-commit hook by hand at any time with::
+
+```
+pre-commit run
+```
+
+which should run any autoformatting on your code
+and tell you about any errors it couldn't fix automatically.
+You may also install [black integration](https://github.com/psf/black#editor-integration)
+into your text editor to format code automatically.
+
+If you have already committed files before setting up the pre-commit
+hook with `pre-commit install`, you can fix everything up using
+`pre-commit run --all-files`. You need to make the fixing commit
+yourself after that.
+
+Some of the hooks only run on CI by default, but you can invoke them by
+running with the `--hook-stage manual` argument.
+
+## Usage
+
+Any class with trait attributes must inherit from `HasTraits`.
+For the list of available trait types and their properties, see the
+[Trait Types](https://traitlets.readthedocs.io/en/latest/trait_types.html)
+section of the documentation.
+
+### Dynamic default values
+
+To calculate a default value dynamically, decorate a method of your class with
+`@default({traitname})`. This method will be called on the instance, and
+should return the default value. In this example, the `_username_default`
+method is decorated with `@default('username')`:
+
+```Python
+import getpass
+from traitlets import HasTraits, Unicode, default
+
+class Identity(HasTraits):
+    username = Unicode()
+
+    @default('username')
+    def _username_default(self):
+        return getpass.getuser()
+```
+
+### Callbacks when a trait attribute changes
+
+When a trait changes, an application can follow this trait change with
+additional actions.
+
+To do something when a trait attribute is changed, decorate a method with
+[`traitlets.observe()`](https://traitlets.readthedocs.io/en/latest/api.html?highlight=observe#traitlets.observe).
+The method will be called with a single argument, a dictionary which contains
+an owner, new value, old value, name of the changed trait, and the event type.
+
+In this example, the `_num_changed` method is decorated with `` @observe(`num`) ``:
+
+```Python
+from traitlets import HasTraits, Integer, observe
+
+class TraitletsExample(HasTraits):
+    num = Integer(5, help="a number").tag(config=True)
+
+    @observe('num')
+    def _num_changed(self, change):
+        print("{name} changed from {old} to {new}".format(**change))
+```
+
+and is passed the following dictionary when called:
+
+```Python
+{
+  'owner': object,  # The HasTraits instance
+  'new': 6,         # The new value
+  'old': 5,         # The old value
+  'name': "foo",    # The name of the changed trait
+  'type': 'change', # The event type of the notification, usually 'change'
+}
+```
+
+### Validation and coercion
+
+Each trait type (`Int`, `Unicode`, `Dict` etc.) may have its own validation or
+coercion logic. In addition, we can register custom cross-validators
+that may depend on the state of other attributes. For example:
+
+```Python
+from traitlets import HasTraits, TraitError, Int, Bool, validate
+
+class Parity(HasTraits):
+    value = Int()
+    parity = Int()
+
+    @validate('value')
+    def _valid_value(self, proposal):
+        if proposal['value'] % 2 != self.parity:
+            raise TraitError('value and parity should be consistent')
+        return proposal['value']
+
+    @validate('parity')
+    def _valid_parity(self, proposal):
+        parity = proposal['value']
+        if parity not in [0, 1]:
+            raise TraitError('parity should be 0 or 1')
+        if self.value % 2 != parity:
+            raise TraitError('value and parity should be consistent')
+        return proposal['value']
+
+parity_check = Parity(value=2)
+
+# Changing required parity and value together while holding cross validation
+with parity_check.hold_trait_notifications():
+    parity_check.value = 1
+    parity_check.parity = 1
+```
+
+However, we **recommend** that custom cross-validators don't modify the state
+of the HasTraits instance.
+
+## About the IPython Development Team
+
+The IPython Development Team is the set of all contributors to the IPython project.
+This includes all of the IPython subprojects.
+
+The core team that coordinates development on GitHub can be found here:
+https://github.com/jupyter/.
+
+## Our Copyright Policy
+
+IPython uses a shared copyright model. Each contributor maintains copyright
+over their contributions to IPython. But, it is important to note that these
+contributions are typically only changes to the repositories. Thus, the IPython
+source code, in its entirety is not the copyright of any single person or
+institution. Instead, it is the collective copyright of the entire IPython
+Development Team. If individual contributors want to maintain a record of what
+changes/contributions they have specific copyright on, they should indicate
+their copyright in the commit message of the change, when they commit the
+change to one of the IPython repositories.
+
+With this in mind, the following banner should be used in any source code file
+to indicate the copyright and license terms:
+
+```
+# Copyright (c) IPython Development Team.
+# Distributed under the terms of the Modified BSD License.
+```
diff --git a/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/RECORD b/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/RECORD
new file mode 100644
index 0000000..8234031
--- /dev/null
+++ b/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/RECORD
@@ -0,0 +1,54 @@
+traitlets-5.14.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+traitlets-5.14.3.dist-info/METADATA,sha256=ygcH3YjC-Lv9mYAIE98LLNGbiEkh785y3Mm_YE_uXVY,10691
+traitlets-5.14.3.dist-info/RECORD,,
+traitlets-5.14.3.dist-info/WHEEL,sha256=osohxoshIHTFJFVPhsi1UkZuLRGMHRXZzwEBW2ezjrc,87
+traitlets-5.14.3.dist-info/licenses/LICENSE,sha256=L1FyfZBjtUhWdzy1E4i9t58pNu5KG2ku9VPYxCATEas,1536
+traitlets/__init__.py,sha256=ogQL6bHHdDlghRJfnYA1_EUzlNl5A2jR2NVDwr9QXn4,938
+traitlets/__pycache__/__init__.cpython-312.pyc,,
+traitlets/__pycache__/_version.cpython-312.pyc,,
+traitlets/__pycache__/log.cpython-312.pyc,,
+traitlets/__pycache__/traitlets.cpython-312.pyc,,
+traitlets/_version.py,sha256=t9-XC-SX5_j7OUrhkjCG_4z-op3ggTaNhBEq5dXUzHg,557
+traitlets/config/__init__.py,sha256=rUNq_Pig7jyrhmREJqubumXFtwLsMCcaWgxyX_PDYw0,477
+traitlets/config/__pycache__/__init__.cpython-312.pyc,,
+traitlets/config/__pycache__/application.cpython-312.pyc,,
+traitlets/config/__pycache__/argcomplete_config.cpython-312.pyc,,
+traitlets/config/__pycache__/configurable.cpython-312.pyc,,
+traitlets/config/__pycache__/loader.cpython-312.pyc,,
+traitlets/config/__pycache__/manager.cpython-312.pyc,,
+traitlets/config/__pycache__/sphinxdoc.cpython-312.pyc,,
+traitlets/config/application.py,sha256=U6FRtFy_NOsviE-yYQlPFACP7xbHHC23mF6mSTzBxSY,42761
+traitlets/config/argcomplete_config.py,sha256=ECKvIqSOTLzw1OBhfVDVghiUPrBV_dkvQKRPs5OuhUw,10337
+traitlets/config/configurable.py,sha256=8kq24E9Py2iYk1vlh8k6RmA8pKsZnZ_6SIB1n2HCsis,22453
+traitlets/config/loader.py,sha256=L0VjQqIQkmS4KpFh86MGNzTTfz9TRkDMerhnJ8GpA6o,40101
+traitlets/config/manager.py,sha256=t30P4Ji_FbJBMoAh32o19NnlXgLqf_WmcPDCQXskuac,2470
+traitlets/config/sphinxdoc.py,sha256=7yK9ELMScWtmRITdUCB3bWqVpARHD8RMdyTD2wC7xO4,5252
+traitlets/log.py,sha256=iyzTKjfo1XTvwZbe0Q6-lgnXqxFa1pLW-t3SBDOuBzw,955
+traitlets/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+traitlets/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+traitlets/tests/__pycache__/__init__.cpython-312.pyc,,
+traitlets/tests/__pycache__/test_traitlets.cpython-312.pyc,,
+traitlets/tests/__pycache__/utils.cpython-312.pyc,,
+traitlets/tests/test_traitlets.py,sha256=brCQ8Nz_r1neuIpd_AGqWQz75GDQ9Xt_Diu1xd5H75k,2103
+traitlets/tests/utils.py,sha256=PFDeY_2PJ8TSGZTn9pR5-FS2xFRmNb9sCo2zFZbF3RQ,1381
+traitlets/traitlets.py,sha256=prK8Vmj7kmzYQWWZ6kXCgtb0TxZauRT464px0RI3KmU,151849
+traitlets/utils/__init__.py,sha256=Y53m1APot2AAtCfwpVUOvYRX6AMpKqOiKhroM0CdTWw,3144
+traitlets/utils/__pycache__/__init__.cpython-312.pyc,,
+traitlets/utils/__pycache__/bunch.cpython-312.pyc,,
+traitlets/utils/__pycache__/decorators.cpython-312.pyc,,
+traitlets/utils/__pycache__/descriptions.cpython-312.pyc,,
+traitlets/utils/__pycache__/getargspec.cpython-312.pyc,,
+traitlets/utils/__pycache__/importstring.cpython-312.pyc,,
+traitlets/utils/__pycache__/nested_update.cpython-312.pyc,,
+traitlets/utils/__pycache__/sentinel.cpython-312.pyc,,
+traitlets/utils/__pycache__/text.cpython-312.pyc,,
+traitlets/utils/__pycache__/warnings.cpython-312.pyc,,
+traitlets/utils/bunch.py,sha256=QVioeWqH5EZH-h_rqhPeymz6iGYHf7CeZMAQ0eN-b7s,784
+traitlets/utils/decorators.py,sha256=cMpUy3vlkez5iHWYD0zFGtz2icrel1CboTJdUJKNyCQ,3084
+traitlets/utils/descriptions.py,sha256=8DqdCJlcnuBxTUEFJe5SNxSQ6fuB7QdI5I02NTZ6igg,5571
+traitlets/utils/getargspec.py,sha256=4ff5ALw3S_Em36Olxe7A3t5VQzzuYq_YlsGqjcsgW1A,1643
+traitlets/utils/importstring.py,sha256=Tr-O3GO-pX4GgZKiwA3JBqasJEYQkggoGR5LBl86QlM,1210
+traitlets/utils/nested_update.py,sha256=RB_Aswp-ssZZHK26VTpEEHnNalcUNjvOX4E-y1b3B00,1114
+traitlets/utils/sentinel.py,sha256=b31f5z6soaZWlrdq2CRQPOt_1j31r2MsRf6GdO2WpAo,642
+traitlets/utils/text.py,sha256=nXjUcpvJGmoXhVDf_O-crBCmE1oHkbWb6bYojA2w9Q0,1139
+traitlets/utils/warnings.py,sha256=Z34ArRKUjcX7Bs8QvvvDi3W60Ia1iM_d-d5ttYWhJfQ,1964
diff --git a/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/WHEEL b/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/WHEEL
new file mode 100644
index 0000000..642b257
--- /dev/null
+++ b/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.24.1
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/licenses/LICENSE b/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/licenses/LICENSE
new file mode 100644
index 0000000..76910b0
--- /dev/null
+++ b/env/lib/python3.12/site-packages/traitlets-5.14.3.dist-info/licenses/LICENSE
@@ -0,0 +1,30 @@
+BSD 3-Clause License
+
+- Copyright (c) 2001-, IPython Development Team
+
+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.
+
+2. 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.
+
+3. Neither the name of the copyright holder nor the names of its
+   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 COPYRIGHT HOLDER 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/env/lib/python3.12/site-packages/traitlets/__init__.py b/env/lib/python3.12/site-packages/traitlets/__init__.py
new file mode 100644
index 0000000..e27ecf1
--- /dev/null
+++ b/env/lib/python3.12/site-packages/traitlets/__init__.py
@@ -0,0 +1,35 @@
+"""Traitlets Python configuration system"""
+from __future__ import annotations
+
+import typing as _t
+
+from . import traitlets
+from ._version import __version__, version_info
+from .traitlets import *
+from .utils.bunch import Bunch
+from .utils.decorators import signature_has_traits
+from .utils.importstring import import_item
+from .utils.warnings import warn
+
+__all__ = [
+    "traitlets",
+    "__version__",
+    "version_info",
+    "Bunch",
+    "signature_has_traits",
+    "import_item",
+    "Sentinel",
+]
+
+
+class Sentinel(traitlets.Sentinel):  # type:ignore[name-defined, misc]
+    def __init__(self, *args: _t.Any, **kwargs: _t.Any) -> None:
+        super().__init__(*args, **kwargs)
+        warn(
+            """
+            Sentinel is not a public part of the traitlets API.
+            It was published by mistake, and may be removed in the future.
+            """,
+            DeprecationWarning,
+            stacklevel=2,
+        )
diff --git a/env/lib/python3.12/site-packages/traitlets/_version.py b/env/lib/python3.12/site-packages/traitlets/_version.py
new file mode 100644
index 0000000..fea66b5
--- /dev/null
+++ b/env/lib/python3.12/site-packages/traitlets/_version.py
@@ -0,0 +1,19 @@
+"""
+handle the current version info of traitlets.
+"""
+from __future__ import annotations
+
+import re
+from typing import List
+
+# Version string must appear intact for hatch versioning
+__version__ = "5.14.3"
+
+# Build up version_info tuple for backwards compatibility
+pattern = r"(?P\d+).(?P\d+).(?P\d+)(?P.*)"
+match = re.match(pattern, __version__)
+assert match is not None
+parts: List[object] = [int(match[part]) for part in ["major", "minor", "patch"]]
+if match["rest"]:
+    parts.append(match["rest"])
+version_info = tuple(parts)
diff --git a/env/lib/python3.12/site-packages/traitlets/config/__init__.py b/env/lib/python3.12/site-packages/traitlets/config/__init__.py
new file mode 100644
index 0000000..e51a421
--- /dev/null
+++ b/env/lib/python3.12/site-packages/traitlets/config/__init__.py
@@ -0,0 +1,20 @@
+# Copyright (c) IPython Development Team.
+# Distributed under the terms of the Modified BSD License.
+from __future__ import annotations
+
+from .application import *
+from .configurable import *
+from .loader import Config
+
+__all__ = [  # noqa: F405
+    "Config",
+    "Application",
+    "ApplicationError",
+    "LevelFormatter",
+    "configurable",
+    "Configurable",
+    "ConfigurableError",
+    "MultipleInstanceError",
+    "LoggingConfigurable",
+    "SingletonConfigurable",
+]
diff --git a/env/lib/python3.12/site-packages/traitlets/config/application.py b/env/lib/python3.12/site-packages/traitlets/config/application.py
new file mode 100644
index 0000000..b01a11e
--- /dev/null
+++ b/env/lib/python3.12/site-packages/traitlets/config/application.py
@@ -0,0 +1,1129 @@
+"""A base class for a configurable application."""
+
+# Copyright (c) IPython Development Team.
+# Distributed under the terms of the Modified BSD License.
+from __future__ import annotations
+
+import functools
+import json
+import logging
+import os
+import pprint
+import re
+import sys
+import typing as t
+from collections import OrderedDict, defaultdict
+from contextlib import suppress
+from copy import deepcopy
+from logging.config import dictConfig
+from textwrap import dedent
+
+from traitlets.config.configurable import Configurable, SingletonConfigurable
+from traitlets.config.loader import (
+    ArgumentError,
+    Config,
+    ConfigFileNotFound,
+    DeferredConfigString,
+    JSONFileConfigLoader,
+    KVArgParseConfigLoader,
+    PyFileConfigLoader,
+)
+from traitlets.traitlets import (
+    Bool,
+    Dict,
+    Enum,
+    Instance,
+    List,
+    TraitError,
+    Unicode,
+    default,
+    observe,
+    observe_compat,
+)
+from traitlets.utils.bunch import Bunch
+from traitlets.utils.nested_update import nested_update
+from traitlets.utils.text import indent, wrap_paragraphs
+
+from ..utils import cast_unicode
+from ..utils.importstring import import_item
+
+# -----------------------------------------------------------------------------
+# Descriptions for the various sections
+# -----------------------------------------------------------------------------
+# merge flags&aliases into options
+option_description = """
+The options below are convenience aliases to configurable class-options,
+as listed in the "Equivalent to" description-line of the aliases.
+To see all configurable class-options for some , use:
+     --help-all
+""".strip()  # trim newlines of front and back
+
+keyvalue_description = """
+The command-line option below sets the respective configurable class-parameter:
+    --Class.parameter=value
+This line is evaluated in Python, so simple expressions are allowed.
+For instance, to set `C.a=[0,1,2]`, you may type this:
+    --C.a='range(3)'
+""".strip()  # trim newlines of front and back
+
+# sys.argv can be missing, for example when python is embedded. See the docs
+# for details: http://docs.python.org/2/c-api/intro.html#embedding-python
+if not hasattr(sys, "argv"):
+    sys.argv = [""]
+
+subcommand_description = """
+Subcommands are launched as `{app} cmd [args]`. For information on using
+subcommand 'cmd', do: `{app} cmd -h`.
+"""
+# get running program name
+
+# -----------------------------------------------------------------------------
+# Application class
+# -----------------------------------------------------------------------------
+
+
+_envvar = os.environ.get("TRAITLETS_APPLICATION_RAISE_CONFIG_FILE_ERROR", "")
+if _envvar.lower() in {"1", "true"}:
+    TRAITLETS_APPLICATION_RAISE_CONFIG_FILE_ERROR = True
+elif _envvar.lower() in {"0", "false", ""}:
+    TRAITLETS_APPLICATION_RAISE_CONFIG_FILE_ERROR = False
+else:
+    raise ValueError(
+        "Unsupported value for environment variable: 'TRAITLETS_APPLICATION_RAISE_CONFIG_FILE_ERROR' is set to '%s' which is none of  {'0', '1', 'false', 'true', ''}."
+        % _envvar
+    )
+
+
+IS_PYTHONW = sys.executable and sys.executable.endswith("pythonw.exe")
+
+T = t.TypeVar("T", bound=t.Callable[..., t.Any])
+AnyLogger = t.Union[logging.Logger, "logging.LoggerAdapter[t.Any]"]
+StrDict = t.Dict[str, t.Any]
+ArgvType = t.Optional[t.List[str]]
+ClassesType = t.List[t.Type[Configurable]]
+
+
+def catch_config_error(method: T) -> T:
+    """Method decorator for catching invalid config (Trait/ArgumentErrors) during init.
+
+    On a TraitError (generally caused by bad config), this will print the trait's
+    message, and exit the app.
+
+    For use on init methods, to prevent invoking excepthook on invalid input.
+    """
+
+    @functools.wraps(method)
+    def inner(app: Application, *args: t.Any, **kwargs: t.Any) -> t.Any:
+        try:
+            return method(app, *args, **kwargs)
+        except (TraitError, ArgumentError) as e:
+            app.log.fatal("Bad config encountered during initialization: %s", e)
+            app.log.debug("Config at the time: %s", app.config)
+            app.exit(1)
+
+    return t.cast(T, inner)
+
+
+class ApplicationError(Exception):
+    pass
+
+
+class LevelFormatter(logging.Formatter):
+    """Formatter with additional `highlevel` record
+
+    This field is empty if log level is less than highlevel_limit,
+    otherwise it is formatted with self.highlevel_format.
+
+    Useful for adding 'WARNING' to warning messages,
+    without adding 'INFO' to info, etc.
+    """
+
+    highlevel_limit = logging.WARN
+    highlevel_format = " %(levelname)s |"
+
+    def format(self, record: logging.LogRecord) -> str:
+        if record.levelno >= self.highlevel_limit:
+            record.highlevel = self.highlevel_format % record.__dict__
+        else:
+            record.highlevel = ""
+        return super().format(record)
+
+
+class Application(SingletonConfigurable):
+    """A singleton application with full configuration support."""
+
+    # The name of the application, will usually match the name of the command
+    # line application
+    name: str | Unicode[str, str | bytes] = Unicode("application")
+
+    # The description of the application that is printed at the beginning
+    # of the help.
+    description: str | Unicode[str, str | bytes] = Unicode("This is an application.")
+    # default section descriptions
+    option_description: str | Unicode[str, str | bytes] = Unicode(option_description)
+    keyvalue_description: str | Unicode[str, str | bytes] = Unicode(keyvalue_description)
+    subcommand_description: str | Unicode[str, str | bytes] = Unicode(subcommand_description)
+
+    python_config_loader_class = PyFileConfigLoader
+    json_config_loader_class = JSONFileConfigLoader
+
+    # The usage and example string that goes at the end of the help string.
+    examples: str | Unicode[str, str | bytes] = Unicode()
+
+    # A sequence of Configurable subclasses whose config=True attributes will
+    # be exposed at the command line.
+    classes: ClassesType = []
+
+    def _classes_inc_parents(
+        self, classes: ClassesType | None = None
+    ) -> t.Generator[type[Configurable], None, None]:
+        """Iterate through configurable classes, including configurable parents
+
+        :param classes:
+            The list of classes to iterate; if not set, uses :attr:`classes`.
+
+        Children should always be after parents, and each class should only be
+        yielded once.
+        """
+        if classes is None:
+            classes = self.classes
+
+        seen = set()
+        for c in classes:
+            # We want to sort parents before children, so we reverse the MRO
+            for parent in reversed(c.mro()):
+                if issubclass(parent, Configurable) and (parent not in seen):
+                    seen.add(parent)
+                    yield parent
+
+    # The version string of this application.
+    version: str | Unicode[str, str | bytes] = Unicode("0.0")
+
+    # the argv used to initialize the application
+    argv: list[str] | List[str] = List()
+
+    # Whether failing to load config files should prevent startup
+    raise_config_file_errors = Bool(TRAITLETS_APPLICATION_RAISE_CONFIG_FILE_ERROR)
+
+    # The log level for the application
+    log_level = Enum(
+        (0, 10, 20, 30, 40, 50, "DEBUG", "INFO", "WARN", "ERROR", "CRITICAL"),
+        default_value=logging.WARN,
+        help="Set the log level by value or name.",
+    ).tag(config=True)
+
+    _log_formatter_cls = LevelFormatter
+
+    log_datefmt = Unicode(
+        "%Y-%m-%d %H:%M:%S", help="The date format used by logging formatters for %(asctime)s"
+    ).tag(config=True)
+
+    log_format = Unicode(
+        "[%(name)s]%(highlevel)s %(message)s",
+        help="The Logging format template",
+    ).tag(config=True)
+
+    def get_default_logging_config(self) -> StrDict:
+        """Return the base logging configuration.
+
+        The default is to log to stderr using a StreamHandler, if no default
+        handler already exists.
+
+        The log handler level starts at logging.WARN, but this can be adjusted
+        by setting the ``log_level`` attribute.
+
+        The ``logging_config`` trait is merged into this allowing for finer
+        control of logging.
+
+        """
+        config: StrDict = {
+            "version": 1,
+            "handlers": {
+                "console": {
+                    "class": "logging.StreamHandler",
+                    "formatter": "console",
+                    "level": logging.getLevelName(self.log_level),  # type:ignore[arg-type]
+                    "stream": "ext://sys.stderr",
+                },
+            },
+            "formatters": {
+                "console": {
+                    "class": (
+                        f"{self._log_formatter_cls.__module__}"
+                        f".{self._log_formatter_cls.__name__}"
+                    ),
+                    "format": self.log_format,
+                    "datefmt": self.log_datefmt,
+                },
+            },
+            "loggers": {
+                self.__class__.__name__: {
+                    "level": "DEBUG",
+                    "handlers": ["console"],
+                }
+            },
+            "disable_existing_loggers": False,
+        }
+
+        if IS_PYTHONW:
+            # disable logging
+            # (this should really go to a file, but file-logging is only
+            # hooked up in parallel applications)
+            del config["handlers"]
+            del config["loggers"]
+
+        return config
+
+    @observe("log_datefmt", "log_format", "log_level", "logging_config")
+    def _observe_logging_change(self, change: Bunch) -> None:
+        # convert log level strings to ints
+        log_level = self.log_level
+        if isinstance(log_level, str):
+            self.log_level = t.cast(int, getattr(logging, log_level))
+        self._configure_logging()
+
+    @observe("log", type="default")
+    def _observe_logging_default(self, change: Bunch) -> None:
+        self._configure_logging()
+
+    def _configure_logging(self) -> None:
+        config = self.get_default_logging_config()
+        nested_update(config, self.logging_config or {})
+        dictConfig(config)
+        # make a note that we have configured logging
+        self._logging_configured = True
+
+    @default("log")
+    def _log_default(self) -> AnyLogger:
+        """Start logging for this application."""
+        log = logging.getLogger(self.__class__.__name__)
+        log.propagate = False
+        _log = log  # copied from Logger.hasHandlers() (new in Python 3.2)
+        while _log is not None:
+            if _log.handlers:
+                return log
+            if not _log.propagate:
+                break
+            _log = _log.parent  # type:ignore[assignment]
+        return log
+
+    logging_config = Dict(
+        help="""
+            Configure additional log handlers.
+
+            The default stderr logs handler is configured by the
+            log_level, log_datefmt and log_format settings.
+
+            This configuration can be used to configure additional handlers
+            (e.g. to output the log to a file) or for finer control over the
+            default handlers.
+
+            If provided this should be a logging configuration dictionary, for
+            more information see:
+            https://docs.python.org/3/library/logging.config.html#logging-config-dictschema
+
+            This dictionary is merged with the base logging configuration which
+            defines the following:
+
+            * A logging formatter intended for interactive use called
+              ``console``.
+            * A logging handler that writes to stderr called
+              ``console`` which uses the formatter ``console``.
+            * A logger with the name of this application set to ``DEBUG``
+              level.
+
+            This example adds a new handler that writes to a file:
+
+            .. code-block:: python
+
+               c.Application.logging_config = {
+                   "handlers": {
+                       "file": {
+                           "class": "logging.FileHandler",
+                           "level": "DEBUG",
+                           "filename": "",
+                       }
+                   },
+                   "loggers": {
+                       "": {
+                           "level": "DEBUG",
+                           # NOTE: if you don't list the default "console"
+                           # handler here then it will be disabled
+                           "handlers": ["console", "file"],
+                       },
+                   },
+               }
+
+        """,
+    ).tag(config=True)
+
+    #: the alias map for configurables
+    #: Keys might strings or tuples for additional options; single-letter alias accessed like `-v`.
+    #: Values might be like "Class.trait" strings of two-tuples: (Class.trait, help-text),
+    #  or just the "Class.trait" string, in which case the help text is inferred from the
+    #  corresponding trait
+    aliases: StrDict = {"log-level": "Application.log_level"}
+
+    # flags for loading Configurables or store_const style flags
+    # flags are loaded from this dict by '--key' flags
+    # this must be a dict of two-tuples, the first element being the Config/dict
+    # and the second being the help string for the flag
+    flags: StrDict = {
+        "debug": (
+            {
+                "Application": {
+                    "log_level": logging.DEBUG,
+                },
+            },
+            "Set log-level to debug, for the most verbose logging.",
+        ),
+        "show-config": (
+            {
+                "Application": {
+                    "show_config": True,
+                },
+            },
+            "Show the application's configuration (human-readable format)",
+        ),
+        "show-config-json": (
+            {
+                "Application": {
+                    "show_config_json": True,
+                },
+            },
+            "Show the application's configuration (json format)",
+        ),
+    }
+
+    # subcommands for launching other applications
+    # if this is not empty, this will be a parent Application
+    # this must be a dict of two-tuples,
+    # the first element being the application class/import string
+    # and the second being the help string for the subcommand
+    subcommands: dict[str, t.Any] | Dict[str, t.Any] = Dict()
+    # parse_command_line will initialize a subapp, if requested
+    subapp = Instance("traitlets.config.application.Application", allow_none=True)
+
+    # extra command-line arguments that don't set config values
+    extra_args = List(Unicode())
+
+    cli_config = Instance(
+        Config,
+        (),
+        {},
+        help="""The subset of our configuration that came from the command-line
+
+        We re-load this configuration after loading config files,
+        to ensure that it maintains highest priority.
+        """,
+    )
+
+    _loaded_config_files: List[str] = List()
+
+    show_config = Bool(
+        help="Instead of starting the Application, dump configuration to stdout"
+    ).tag(config=True)
+
+    show_config_json = Bool(
+        help="Instead of starting the Application, dump configuration to stdout (as JSON)"
+    ).tag(config=True)
+
+    @observe("show_config_json")
+    def _show_config_json_changed(self, change: Bunch) -> None:
+        self.show_config = change.new
+
+    @observe("show_config")
+    def _show_config_changed(self, change: Bunch) -> None:
+        if change.new:
+            self._save_start = self.start
+            self.start = self.start_show_config  # type:ignore[method-assign]
+
+    def __init__(self, **kwargs: t.Any) -> None:
+        SingletonConfigurable.__init__(self, **kwargs)
+        # Ensure my class is in self.classes, so my attributes appear in command line
+        # options and config files.
+        cls = self.__class__
+        if cls not in self.classes:
+            if self.classes is cls.classes:
+                # class attr, assign instead of insert
+                self.classes = [cls, *self.classes]
+            else:
+                self.classes.insert(0, self.__class__)
+
+    @observe("config")
+    @observe_compat
+    def _config_changed(self, change: Bunch) -> None:
+        super()._config_changed(change)
+        self.log.debug("Config changed: %r", change.new)
+
+    @catch_config_error
+    def initialize(self, argv: ArgvType = None) -> None:
+        """Do the basic steps to configure me.
+
+        Override in subclasses.
+        """
+        self.parse_command_line(argv)
+
+    def start(self) -> None:
+        """Start the app mainloop.
+
+        Override in subclasses.
+        """
+        if self.subapp is not None:
+            assert isinstance(self.subapp, Application)
+            return self.subapp.start()
+
+    def start_show_config(self) -> None:
+        """start function used when show_config is True"""
+        config = self.config.copy()
+        # exclude show_config flags from displayed config
+        for cls in self.__class__.mro():
+            if cls.__name__ in config:
+                cls_config = config[cls.__name__]
+                cls_config.pop("show_config", None)
+                cls_config.pop("show_config_json", None)
+
+        if self.show_config_json:
+            json.dump(config, sys.stdout, indent=1, sort_keys=True, default=repr)
+            # add trailing newline
+            sys.stdout.write("\n")
+            return
+
+        if self._loaded_config_files:
+            print("Loaded config files:")
+            for f in self._loaded_config_files:
+                print("  " + f)
+            print()
+
+        for classname in sorted(config):
+            class_config = config[classname]
+            if not class_config:
+                continue
+            print(classname)
+            pformat_kwargs: StrDict = dict(indent=4, compact=True)  # noqa: C408
+
+            for traitname in sorted(class_config):
+                value = class_config[traitname]
+                print(f"  .{traitname} = {pprint.pformat(value, **pformat_kwargs)}")
+
+    def print_alias_help(self) -> None:
+        """Print the alias parts of the help."""
+        print("\n".join(self.emit_alias_help()))
+
+    def emit_alias_help(self) -> t.Generator[str, None, None]:
+        """Yield the lines for alias part of the help."""
+        if not self.aliases:
+            return
+
+        classdict: dict[str, type[Configurable]] = {}
+        for cls in self.classes:
+            # include all parents (up to, but excluding Configurable) in available names
+            for c in cls.mro()[:-3]:
+                classdict[c.__name__] = t.cast(t.Type[Configurable], c)
+
+        fhelp: str | None
+        for alias, longname in self.aliases.items():
+            try:
+                if isinstance(longname, tuple):
+                    longname, fhelp = longname
+                else:
+                    fhelp = None
+                classname, traitname = longname.split(".")[-2:]
+                longname = classname + "." + traitname
+                cls = classdict[classname]
+
+                trait = cls.class_traits(config=True)[traitname]
+                fhelp_lines = cls.class_get_trait_help(trait, helptext=fhelp).splitlines()
+
+                if not isinstance(alias, tuple):  # type:ignore[unreachable]
+                    alias = (alias,)  # type:ignore[assignment]
+                alias = sorted(alias, key=len)  # type:ignore[assignment]
+                alias = ", ".join(("--%s" if len(m) > 1 else "-%s") % m for m in alias)
+
+                # reformat first line
+                fhelp_lines[0] = fhelp_lines[0].replace("--" + longname, alias)
+                yield from fhelp_lines
+                yield indent("Equivalent to: [--%s]" % longname)
+            except Exception as ex:
+                self.log.error("Failed collecting help-message for alias %r, due to: %s", alias, ex)
+                raise
+
+    def print_flag_help(self) -> None:
+        """Print the flag part of the help."""
+        print("\n".join(self.emit_flag_help()))
+
+    def emit_flag_help(self) -> t.Generator[str, None, None]:
+        """Yield the lines for the flag part of the help."""
+        if not self.flags:
+            return
+
+        for flags, (cfg, fhelp) in self.flags.items():
+            try:
+                if not isinstance(flags, tuple):  # type:ignore[unreachable]
+                    flags = (flags,)  # type:ignore[assignment]
+                flags = sorted(flags, key=len)  # type:ignore[assignment]
+                flags = ", ".join(("--%s" if len(m) > 1 else "-%s") % m for m in flags)
+                yield flags
+                yield indent(dedent(fhelp.strip()))
+                cfg_list = " ".join(
+                    f"--{clname}.{prop}={val}"
+                    for clname, props_dict in cfg.items()
+                    for prop, val in props_dict.items()
+                )
+                cfg_txt = "Equivalent to: [%s]" % cfg_list
+                yield indent(dedent(cfg_txt))
+            except Exception as ex:
+                self.log.error("Failed collecting help-message for flag %r, due to: %s", flags, ex)
+                raise
+
+    def print_options(self) -> None:
+        """Print the options part of the help."""
+        print("\n".join(self.emit_options_help()))
+
+    def emit_options_help(self) -> t.Generator[str, None, None]:
+        """Yield the lines for the options part of the help."""
+        if not self.flags and not self.aliases:
+            return
+        header = "Options"
+        yield header
+        yield "=" * len(header)
+        for p in wrap_paragraphs(self.option_description):
+            yield p
+            yield ""
+
+        yield from self.emit_flag_help()
+        yield from self.emit_alias_help()
+        yield ""
+
+    def print_subcommands(self) -> None:
+        """Print the subcommand part of the help."""
+        print("\n".join(self.emit_subcommands_help()))
+
+    def emit_subcommands_help(self) -> t.Generator[str, None, None]:
+        """Yield the lines for the subcommand part of the help."""
+        if not self.subcommands:
+            return
+
+        header = "Subcommands"
+        yield header
+        yield "=" * len(header)
+        for p in wrap_paragraphs(self.subcommand_description.format(app=self.name)):
+            yield p
+            yield ""
+        for subc, (_, help) in self.subcommands.items():
+            yield subc
+            if help:
+                yield indent(dedent(help.strip()))
+        yield ""
+
+    def emit_help_epilogue(self, classes: bool) -> t.Generator[str, None, None]:
+        """Yield the very bottom lines of the help message.
+
+        If classes=False (the default), print `--help-all` msg.
+        """
+        if not classes:
+            yield "To see all available configurables, use `--help-all`."
+            yield ""
+
+    def print_help(self, classes: bool = False) -> None:
+        """Print the help for each Configurable class in self.classes.
+
+        If classes=False (the default), only flags and aliases are printed.
+        """
+        print("\n".join(self.emit_help(classes=classes)))
+
+    def emit_help(self, classes: bool = False) -> t.Generator[str, None, None]:
+        """Yield the help-lines for each Configurable class in self.classes.
+
+        If classes=False (the default), only flags and aliases are printed.
+        """
+        yield from self.emit_description()
+        yield from self.emit_subcommands_help()
+        yield from self.emit_options_help()
+
+        if classes:
+            help_classes = self._classes_with_config_traits()
+            if help_classes is not None:
+                yield "Class options"
+                yield "============="
+                for p in wrap_paragraphs(self.keyvalue_description):
+                    yield p
+                    yield ""
+
+            for cls in help_classes:
+                yield cls.class_get_help()
+                yield ""
+        yield from self.emit_examples()
+
+        yield from self.emit_help_epilogue(classes)
+
+    def document_config_options(self) -> str:
+        """Generate rST format documentation for the config options this application
+
+        Returns a multiline string.
+        """
+        return "\n".join(c.class_config_rst_doc() for c in self._classes_inc_parents())
+
+    def print_description(self) -> None:
+        """Print the application description."""
+        print("\n".join(self.emit_description()))
+
+    def emit_description(self) -> t.Generator[str, None, None]:
+        """Yield lines with the application description."""
+        for p in wrap_paragraphs(self.description or self.__doc__ or ""):
+            yield p
+            yield ""
+
+    def print_examples(self) -> None:
+        """Print usage and examples (see `emit_examples()`)."""
+        print("\n".join(self.emit_examples()))
+
+    def emit_examples(self) -> t.Generator[str, None, None]:
+        """Yield lines with the usage and examples.
+
+        This usage string goes at the end of the command line help string
+        and should contain examples of the application's usage.
+        """
+        if self.examples:
+            yield "Examples"
+            yield "--------"
+            yield ""
+            yield indent(dedent(self.examples.strip()))
+            yield ""
+
+    def print_version(self) -> None:
+        """Print the version string."""
+        print(self.version)
+
+    @catch_config_error
+    def initialize_subcommand(self, subc: str, argv: ArgvType = None) -> None:
+        """Initialize a subcommand with argv."""
+        val = self.subcommands.get(subc)
+        assert val is not None
+        subapp, _ = val
+
+        if isinstance(subapp, str):
+            subapp = import_item(subapp)
+
+        # Cannot issubclass() on a non-type (SOhttp://stackoverflow.com/questions/8692430)
+        if isinstance(subapp, type) and issubclass(subapp, Application):
+            # Clear existing instances before...
+            self.__class__.clear_instance()
+            # instantiating subapp...
+            self.subapp = subapp.instance(parent=self)
+        elif callable(subapp):
+            # or ask factory to create it...
+            self.subapp = subapp(self)
+        else:
+            raise AssertionError("Invalid mappings for subcommand '%s'!" % subc)
+
+        # ... and finally initialize subapp.
+        self.subapp.initialize(argv)
+
+    def flatten_flags(self) -> tuple[dict[str, t.Any], dict[str, t.Any]]:
+        """Flatten flags and aliases for loaders, so cl-args override as expected.
+
+        This prevents issues such as an alias pointing to InteractiveShell,
+        but a config file setting the same trait in TerminalInteraciveShell
+        getting inappropriate priority over the command-line arg.
+        Also, loaders expect ``(key: longname)`` and not ``key: (longname, help)`` items.
+
+        Only aliases with exactly one descendent in the class list
+        will be promoted.
+
+        """
+        # build a tree of classes in our list that inherit from a particular
+        # it will be a dict by parent classname of classes in our list
+        # that are descendents
+        mro_tree = defaultdict(list)
+        for cls in self.classes:
+            clsname = cls.__name__
+            for parent in cls.mro()[1:-3]:
+                # exclude cls itself and Configurable,HasTraits,object
+                mro_tree[parent.__name__].append(clsname)
+        # flatten aliases, which have the form:
+        # { 'alias' : 'Class.trait' }
+        aliases: dict[str, str] = {}
+        for alias, longname in self.aliases.items():
+            if isinstance(longname, tuple):
+                longname, _ = longname
+            cls, trait = longname.split(".", 1)
+            children = mro_tree[cls]  # type:ignore[index]
+            if len(children) == 1:
+                # exactly one descendent, promote alias
+                cls = children[0]  # type:ignore[assignment]
+            if not isinstance(aliases, tuple):  # type:ignore[unreachable]
+                alias = (alias,)  # type:ignore[assignment]
+            for al in alias:
+                aliases[al] = ".".join([cls, trait])  # type:ignore[list-item]
+
+        # flatten flags, which are of the form:
+        # { 'key' : ({'Cls' : {'trait' : value}}, 'help')}
+        flags = {}
+        for key, (flagdict, help) in self.flags.items():
+            newflag: dict[t.Any, t.Any] = {}
+            for cls, subdict in flagdict.items():
+                children = mro_tree[cls]  # type:ignore[index]
+                # exactly one descendent, promote flag section
+                if len(children) == 1:
+                    cls = children[0]  # type:ignore[assignment]
+
+                if cls in newflag:
+                    newflag[cls].update(subdict)
+                else:
+                    newflag[cls] = subdict
+
+            if not isinstance(key, tuple):  # type:ignore[unreachable]
+                key = (key,)  # type:ignore[assignment]
+            for k in key:
+                flags[k] = (newflag, help)
+        return flags, aliases
+
+    def _create_loader(
+        self,
+        argv: list[str] | None,
+        aliases: StrDict,
+        flags: StrDict,
+        classes: ClassesType | None,
+    ) -> KVArgParseConfigLoader:
+        return KVArgParseConfigLoader(
+            argv, aliases, flags, classes=classes, log=self.log, subcommands=self.subcommands
+        )
+
+    @classmethod
+    def _get_sys_argv(cls, check_argcomplete: bool = False) -> list[str]:
+        """Get `sys.argv` or equivalent from `argcomplete`
+
+        `argcomplete`'s strategy is to call the python script with no arguments,
+        so ``len(sys.argv) == 1``, and run until the `ArgumentParser` is constructed
+        and determine what completions are available.
+
+        On the other hand, `traitlet`'s subcommand-handling strategy is to check
+        ``sys.argv[1]`` and see if it matches a subcommand, and if so then dynamically
+        load the subcommand app and initialize it with ``sys.argv[1:]``.
+
+        This helper method helps to take the current tokens for `argcomplete` and pass
+        them through as `argv`.
+        """
+        if check_argcomplete and "_ARGCOMPLETE" in os.environ:
+            try:
+                from traitlets.config.argcomplete_config import get_argcomplete_cwords
+
+                cwords = get_argcomplete_cwords()
+                assert cwords is not None
+                return cwords
+            except (ImportError, ModuleNotFoundError):
+                pass
+        return sys.argv
+
+    @classmethod
+    def _handle_argcomplete_for_subcommand(cls) -> None:
+        """Helper for `argcomplete` to recognize `traitlets` subcommands
+
+        `argcomplete` does not know that `traitlets` has already consumed subcommands,
+        as it only "sees" the final `argparse.ArgumentParser` that is constructed.
+        (Indeed `KVArgParseConfigLoader` does not get passed subcommands at all currently.)
+        We explicitly manipulate the environment variables used internally by `argcomplete`
+        to get it to skip over the subcommand tokens.
+        """
+        if "_ARGCOMPLETE" not in os.environ:
+            return
+
+        try:
+            from traitlets.config.argcomplete_config import increment_argcomplete_index
+
+            increment_argcomplete_index()
+        except (ImportError, ModuleNotFoundError):
+            pass
+
+    @catch_config_error
+    def parse_command_line(self, argv: ArgvType = None) -> None:
+        """Parse the command line arguments."""
+        assert not isinstance(argv, str)
+        if argv is None:
+            argv = self._get_sys_argv(check_argcomplete=bool(self.subcommands))[1:]
+        self.argv = [cast_unicode(arg) for arg in argv]
+
+        if argv and argv[0] == "help":
+            # turn `ipython help notebook` into `ipython notebook -h`
+            argv = argv[1:] + ["-h"]
+
+        if self.subcommands and len(argv) > 0:
+            # we have subcommands, and one may have been specified
+            subc, subargv = argv[0], argv[1:]
+            if re.match(r"^\w(\-?\w)*$", subc) and subc in self.subcommands:
+                # it's a subcommand, and *not* a flag or class parameter
+                self._handle_argcomplete_for_subcommand()
+                return self.initialize_subcommand(subc, subargv)
+
+        # Arguments after a '--' argument are for the script IPython may be
+        # about to run, not IPython iteslf. For arguments parsed here (help and
+        # version), we want to only search the arguments up to the first
+        # occurrence of '--', which we're calling interpreted_argv.
+        try:
+            interpreted_argv = argv[: argv.index("--")]
+        except ValueError:
+            interpreted_argv = argv
+
+        if any(x in interpreted_argv for x in ("-h", "--help-all", "--help")):
+            self.print_help("--help-all" in interpreted_argv)
+            self.exit(0)
+
+        if "--version" in interpreted_argv or "-V" in interpreted_argv:
+            self.print_version()
+            self.exit(0)
+
+        # flatten flags&aliases, so cl-args get appropriate priority:
+        flags, aliases = self.flatten_flags()
+        classes = list(self._classes_with_config_traits())
+        loader = self._create_loader(argv, aliases, flags, classes=classes)
+        try:
+            self.cli_config = deepcopy(loader.load_config())
+        except SystemExit:
+            # traitlets 5: no longer print help output on error
+            # help output is huge, and comes after the error
+            raise
+        self.update_config(self.cli_config)
+        # store unparsed args in extra_args
+        self.extra_args = loader.extra_args
+
+    @classmethod
+    def _load_config_files(
+        cls,
+        basefilename: str,
+        path: str | t.Sequence[str | None] | None,
+        log: AnyLogger | None = None,
+        raise_config_file_errors: bool = False,
+    ) -> t.Generator[t.Any, None, None]:
+        """Load config files (py,json) by filename and path.
+
+        yield each config object in turn.
+        """
+        if isinstance(path, str) or path is None:
+            path = [path]
+        for current in reversed(path):
+            # path list is in descending priority order, so load files backwards:
+            pyloader = cls.python_config_loader_class(basefilename + ".py", path=current, log=log)
+            if log:
+                log.debug("Looking for %s in %s", basefilename, current or os.getcwd())
+            jsonloader = cls.json_config_loader_class(basefilename + ".json", path=current, log=log)
+            loaded: list[t.Any] = []
+            filenames: list[str] = []
+            for loader in [pyloader, jsonloader]:
+                config = None
+                try:
+                    config = loader.load_config()
+                except ConfigFileNotFound:
+                    pass
+                except Exception:
+                    # try to get the full filename, but it will be empty in the
+                    # unlikely event that the error raised before filefind finished
+                    filename = loader.full_filename or basefilename
+                    # problem while running the file
+                    if raise_config_file_errors:
+                        raise
+                    if log:
+                        log.error("Exception while loading config file %s", filename, exc_info=True)  # noqa: G201
+                else:
+                    if log:
+                        log.debug("Loaded config file: %s", loader.full_filename)
+                if config:
+                    for filename, earlier_config in zip(filenames, loaded):
+                        collisions = earlier_config.collisions(config)
+                        if collisions and log:
+                            log.warning(
+                                "Collisions detected in {0} and {1} config files."  # noqa: G001
+                                " {1} has higher priority: {2}".format(
+                                    filename,
+                                    loader.full_filename,
+                                    json.dumps(collisions, indent=2),
+                                )
+                            )
+                    yield (config, loader.full_filename)
+                    loaded.append(config)
+                    filenames.append(loader.full_filename)
+
+    @property
+    def loaded_config_files(self) -> list[str]:
+        """Currently loaded configuration files"""
+        return self._loaded_config_files[:]
+
+    @catch_config_error
+    def load_config_file(
+        self, filename: str, path: str | t.Sequence[str | None] | None = None
+    ) -> None:
+        """Load config files by filename and path."""
+        filename, ext = os.path.splitext(filename)
+        new_config = Config()
+        for config, fname in self._load_config_files(
+            filename,
+            path=path,
+            log=self.log,
+            raise_config_file_errors=self.raise_config_file_errors,
+        ):
+            new_config.merge(config)
+            if (
+                fname not in self._loaded_config_files
+            ):  # only add to list of loaded files if not previously loaded
+                self._loaded_config_files.append(fname)
+        # add self.cli_config to preserve CLI config priority
+        new_config.merge(self.cli_config)
+        self.update_config(new_config)
+
+    @catch_config_error
+    def load_config_environ(self) -> None:
+        """Load config files by environment."""
+        PREFIX = self.name.upper().replace("-", "_")
+        new_config = Config()
+
+        self.log.debug('Looping through config variables with prefix "%s"', PREFIX)
+
+        for k, v in os.environ.items():
+            if k.startswith(PREFIX):
+                self.log.debug('Seeing environ "%s"="%s"', k, v)
+                # use __ instead of . as separator in env variable.
+                # Warning, case sensitive !
+                _, *path, key = k.split("__")
+                section = new_config
+                for p in path:
+                    section = section[p]
+                setattr(section, key, DeferredConfigString(v))
+
+        new_config.merge(self.cli_config)
+        self.update_config(new_config)
+
+    def _classes_with_config_traits(
+        self, classes: ClassesType | None = None
+    ) -> t.Generator[type[Configurable], None, None]:
+        """
+        Yields only classes with configurable traits, and their subclasses.
+
+        :param classes:
+            The list of classes to iterate; if not set, uses :attr:`classes`.
+
+        Thus, produced sample config-file will contain all classes
+        on which a trait-value may be overridden:
+
+        - either on the class owning the trait,
+        - or on its subclasses, even if those subclasses do not define
+          any traits themselves.
+        """
+        if classes is None:
+            classes = self.classes
+
+        cls_to_config = OrderedDict(
+            (cls, bool(cls.class_own_traits(config=True)))
+            for cls in self._classes_inc_parents(classes)
+        )
+
+        def is_any_parent_included(cls: t.Any) -> bool:
+            return any(b in cls_to_config and cls_to_config[b] for b in cls.__bases__)
+
+        # Mark "empty" classes for inclusion if their parents own-traits,
+        #  and loop until no more classes gets marked.
+        #
+        while True:
+            to_incl_orig = cls_to_config.copy()
+            cls_to_config = OrderedDict(
+                (cls, inc_yes or is_any_parent_included(cls))
+                for cls, inc_yes in cls_to_config.items()
+            )
+            if cls_to_config == to_incl_orig:
+                break
+        for cl, inc_yes in cls_to_config.items():
+            if inc_yes:
+                yield cl
+
+    def generate_config_file(self, classes: ClassesType | None = None) -> str:
+        """generate default config file from Configurables"""
+        lines = ["# Configuration file for %s." % self.name]
+        lines.append("")
+        lines.append("c = get_config()  #" + "noqa")
+        lines.append("")
+        classes = self.classes if classes is None else classes
+        config_classes = list(self._classes_with_config_traits(classes))
+        for cls in config_classes:
+            lines.append(cls.class_config_section(config_classes))
+        return "\n".join(lines)
+
+    def close_handlers(self) -> None:
+        if getattr(self, "_logging_configured", False):
+            # don't attempt to close handlers unless they have been opened
+            # (note accessing self.log.handlers will create handlers if they
+            # have not yet been initialised)
+            for handler in self.log.handlers:
+                with suppress(Exception):
+                    handler.close()
+            self._logging_configured = False
+
+    def exit(self, exit_status: int | str | None = 0) -> None:
+        self.log.debug("Exiting application: %s", self.name)
+        self.close_handlers()
+        sys.exit(exit_status)
+
+    def __del__(self) -> None:
+        self.close_handlers()
+
+    @classmethod
+    def launch_instance(cls, argv: ArgvType = None, **kwargs: t.Any) -> None:
+        """Launch a global instance of this Application
+
+        If a global instance already exists, this reinitializes and starts it
+        """
+        app = cls.instance(**kwargs)
+        app.initialize(argv)
+        app.start()
+
+
+# -----------------------------------------------------------------------------
+# utility functions, for convenience
+# -----------------------------------------------------------------------------
+
+default_aliases = Application.aliases
+default_flags = Application.flags
+
+
+def boolean_flag(name: str, configurable: str, set_help: str = "", unset_help: str = "") -> StrDict:
+    """Helper for building basic --trait, --no-trait flags.
+
+    Parameters
+    ----------
+    name : str
+        The name of the flag.
+    configurable : str
+        The 'Class.trait' string of the trait to be set/unset with the flag
+    set_help : unicode
+        help string for --name flag
+    unset_help : unicode
+        help string for --no-name flag
+
+    Returns
+    -------
+    cfg : dict
+        A dict with two keys: 'name', and 'no-name', for setting and unsetting
+        the trait, respectively.
+    """
+    # default helpstrings
+    set_help = set_help or "set %s=True" % configurable
+    unset_help = unset_help or "set %s=False" % configurable
+
+    cls, trait = configurable.split(".")
+
+    setter = {cls: {trait: True}}
+    unsetter = {cls: {trait: False}}
+    return {name: (setter, set_help), "no-" + name: (unsetter, unset_help)}
+
+
+def get_config() -> Config:
+    """Get the config object for the global Application instance, if there is one
+
+    otherwise return an empty config object
+    """
+    if Application.initialized():
+        return Application.instance().config
+    else:
+        return Config()
+
+
+if __name__ == "__main__":
+    Application.launch_instance()
diff --git a/env/lib/python3.12/site-packages/traitlets/config/argcomplete_config.py b/env/lib/python3.12/site-packages/traitlets/config/argcomplete_config.py
new file mode 100644
index 0000000..1f4cf1c
--- /dev/null
+++ b/env/lib/python3.12/site-packages/traitlets/config/argcomplete_config.py
@@ -0,0 +1,220 @@
+"""Helper utilities for integrating argcomplete with traitlets"""
+
+# Copyright (c) IPython Development Team.
+# Distributed under the terms of the Modified BSD License.
+from __future__ import annotations
+
+import argparse
+import os
+import typing as t
+
+try:
+    import argcomplete
+    from argcomplete import CompletionFinder  # type:ignore[attr-defined]
+except ImportError:
+    # This module and its utility methods are written to not crash even
+    # if argcomplete is not installed.
+    class StubModule:
+        def __getattr__(self, attr: str) -> t.Any:
+            if not attr.startswith("__"):
+                raise ModuleNotFoundError("No module named 'argcomplete'")
+            raise AttributeError(f"argcomplete stub module has no attribute '{attr}'")
+
+    argcomplete = StubModule()  # type:ignore[assignment]
+    CompletionFinder = object  # type:ignore[assignment, misc]
+
+
+def get_argcomplete_cwords() -> t.Optional[t.List[str]]:
+    """Get current words prior to completion point
+
+    This is normally done in the `argcomplete.CompletionFinder` constructor,
+    but is exposed here to allow `traitlets` to follow dynamic code-paths such
+    as determining whether to evaluate a subcommand.
+    """
+    if "_ARGCOMPLETE" not in os.environ:
+        return None
+
+    comp_line = os.environ["COMP_LINE"]
+    comp_point = int(os.environ["COMP_POINT"])
+    # argcomplete.debug("splitting COMP_LINE for:", comp_line, comp_point)
+    comp_words: t.List[str]
+    try:
+        (
+            cword_prequote,
+            cword_prefix,
+            cword_suffix,
+            comp_words,
+            last_wordbreak_pos,
+        ) = argcomplete.split_line(comp_line, comp_point)  # type:ignore[attr-defined,no-untyped-call]
+    except ModuleNotFoundError:
+        return None
+
+    # _ARGCOMPLETE is set by the shell script to tell us where comp_words
+    # should start, based on what we're completing.
+    # 1: 
    9(?^DFsMqJ@qP7mc{Lq8;pUH%+
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�pnOIIvgUOumI{<+JS
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
    • '                    : '\U0001d4ab',
+        '\\'                    : '\U0001d4ac',
+        '\\'                    : '\U0000211b',
+        '\\'                    : '\U0001d4ae',
+        '\\'                    : '\U0001d4af',
+        '\\'                    : '\U0001d4b0',
+        '\\'                    : '\U0001d4b1',
+        '\\'                    : '\U0001d4b2',
+        '\\'                    : '\U0001d4b3',
+        '\\'                    : '\U0001d4b4',
+        '\\'                    : '\U0001d4b5',
+        '\\'                    : '\U0001d5ba',
+        '\\'                    : '\U0001d5bb',
+        '\\'                    : '\U0001d5bc',
+        '\\'                    : '\U0001d5bd',
+        '\\'                    : '\U0001d5be',
+        '\\'                    : '\U0001d5bf',
+        '\\'                    : '\U0001d5c0',
+        '\\'                    : '\U0001d5c1',
+        '\\'                    : '\U0001d5c2',
+        '\\'                    : '\U0001d5c3',
+        '\\'                    : '\U0001d5c4',
+        '\\'                    : '\U0001d5c5',
+        '\\'                    : '\U0001d5c6',
+        '\\'                    : '\U0001d5c7',
+        '\\'                    : '\U0001d5c8',
+        '\\

    naW_ylAU3p|-3k=5TS*$}1mJ(s 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 literal 0 HcmV?d00001 diff --git a/env/lib/python3.12/site-packages/frozenlist/_frozenlist.pyx b/env/lib/python3.12/site-packages/frozenlist/_frozenlist.pyx new file mode 100644 index 0000000..a82d8c8 --- /dev/null +++ b/env/lib/python3.12/site-packages/frozenlist/_frozenlist.pyx @@ -0,0 +1,148 @@ +# cython: freethreading_compatible = True +# distutils: language = c++ + +from cpython.bool cimport PyBool_FromLong +from libcpp.atomic cimport atomic + +import copy +import types +from collections.abc import MutableSequence + + +cdef class FrozenList: + __class_getitem__ = classmethod(types.GenericAlias) + + cdef atomic[bint] _frozen + cdef list _items + + def __init__(self, items=None): + self._frozen.store(False) + if items is not None: + items = list(items) + else: + items = [] + self._items = items + + @property + def frozen(self): + return PyBool_FromLong(self._frozen.load()) + + cdef object _check_frozen(self): + if self._frozen.load(): + raise RuntimeError("Cannot modify frozen list.") + + cdef inline object _fast_len(self): + return len(self._items) + + def freeze(self): + self._frozen.store(True) + + def __getitem__(self, index): + return self._items[index] + + def __setitem__(self, index, value): + self._check_frozen() + self._items[index] = value + + def __delitem__(self, index): + self._check_frozen() + del self._items[index] + + def __len__(self): + return self._fast_len() + + def __iter__(self): + return self._items.__iter__() + + def __reversed__(self): + return self._items.__reversed__() + + def __richcmp__(self, other, op): + if op == 0: # < + return list(self) < other + if op == 1: # <= + return list(self) <= other + if op == 2: # == + return list(self) == other + if op == 3: # != + return list(self) != other + if op == 4: # > + return list(self) > other + if op == 5: # => + return list(self) >= other + + def insert(self, pos, item): + self._check_frozen() + self._items.insert(pos, item) + + def __contains__(self, item): + return item in self._items + + def __iadd__(self, items): + self._check_frozen() + self._items += list(items) + return self + + def index(self, item): + return self._items.index(item) + + def remove(self, item): + self._check_frozen() + self._items.remove(item) + + def clear(self): + self._check_frozen() + self._items.clear() + + def extend(self, items): + self._check_frozen() + self._items += list(items) + + def reverse(self): + self._check_frozen() + self._items.reverse() + + def pop(self, index=-1): + self._check_frozen() + return self._items.pop(index) + + def append(self, item): + self._check_frozen() + return self._items.append(item) + + def count(self, item): + return self._items.count(item) + + def __repr__(self): + return ''.format(self._frozen.load(), + self._items) + + def __hash__(self): + if self._frozen.load(): + return hash(tuple(self._items)) + else: + raise RuntimeError("Cannot hash unfrozen list.") + + def __deepcopy__(self, memo): + cdef FrozenList new_list + obj_id = id(self) + + # Return existing copy if already processed (circular reference) + if obj_id in memo: + return memo[obj_id] + + # Create new instance and register immediately + new_list = self.__class__([]) + memo[obj_id] = new_list + + # Deep copy items + new_list._items[:] = [copy.deepcopy(item, memo) for item in self._items] + + # Preserve frozen state + if self._frozen.load(): + new_list.freeze() + + return new_list + + +MutableSequence.register(FrozenList) diff --git a/env/lib/python3.12/site-packages/frozenlist/py.typed b/env/lib/python3.12/site-packages/frozenlist/py.typed new file mode 100644 index 0000000..f5642f7 --- /dev/null +++ b/env/lib/python3.12/site-packages/frozenlist/py.typed @@ -0,0 +1 @@ +Marker diff --git a/env/lib/python3.12/site-packages/idna-3.11.dist-info/INSTALLER b/env/lib/python3.12/site-packages/idna-3.11.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/idna-3.11.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/idna-3.11.dist-info/METADATA b/env/lib/python3.12/site-packages/idna-3.11.dist-info/METADATA new file mode 100644 index 0000000..7a4a4b7 --- /dev/null +++ b/env/lib/python3.12/site-packages/idna-3.11.dist-info/METADATA @@ -0,0 +1,209 @@ +Metadata-Version: 2.4 +Name: idna +Version: 3.11 +Summary: Internationalized Domain Names in Applications (IDNA) +Author-email: Kim Davies +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +License-Expression: BSD-3-Clause +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: Intended Audience :: System Administrators +Classifier: Operating System :: OS Independent +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Programming Language :: Python :: 3.14 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Topic :: Internet :: Name Service (DNS) +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Topic :: Utilities +License-File: LICENSE.md +Requires-Dist: ruff >= 0.6.2 ; extra == "all" +Requires-Dist: mypy >= 1.11.2 ; extra == "all" +Requires-Dist: pytest >= 8.3.2 ; extra == "all" +Requires-Dist: flake8 >= 7.1.1 ; extra == "all" +Project-URL: Changelog, https://github.com/kjd/idna/blob/master/HISTORY.rst +Project-URL: Issue tracker, https://github.com/kjd/idna/issues +Project-URL: Source, https://github.com/kjd/idna +Provides-Extra: all + +Internationalized Domain Names in Applications (IDNA) +===================================================== + +Support for `Internationalized Domain Names in +Applications (IDNA) `_ +and `Unicode IDNA Compatibility Processing +`_. + +The latest versions of these standards supplied here provide +more comprehensive language coverage and reduce the potential of +allowing domains with known security vulnerabilities. This library +is a suitable replacement for the “encodings.idna” +module that comes with the Python standard library, but which +only supports an older superseded IDNA specification from 2003. + +Basic functions are simply executed: + +.. code-block:: pycon + + >>> import idna + >>> idna.encode('ドメイン.テスト') + b'xn--eckwd4c7c.xn--zckzah' + >>> print(idna.decode('xn--eckwd4c7c.xn--zckzah')) + ドメイン.テスト + + +Installation +------------ + +This package is available for installation from PyPI via the +typical mechanisms, such as: + +.. code-block:: bash + + $ python3 -m pip install idna + + +Usage +----- + +For typical usage, the ``encode`` and ``decode`` functions will take a +domain name argument and perform a conversion to ASCII compatible encoding +(known as A-labels), or to Unicode strings (known as U-labels) +respectively. + +.. code-block:: pycon + + >>> import idna + >>> idna.encode('ドメイン.テスト') + b'xn--eckwd4c7c.xn--zckzah' + >>> print(idna.decode('xn--eckwd4c7c.xn--zckzah')) + ドメイン.テスト + +Conversions can be applied at a per-label basis using the ``ulabel`` or +``alabel`` functions if necessary: + +.. code-block:: pycon + + >>> idna.alabel('测试') + b'xn--0zwm56d' + + +Compatibility Mapping (UTS #46) ++++++++++++++++++++++++++++++++ + +This library provides support for `Unicode IDNA Compatibility +Processing `_ which normalizes input from +different potential ways a user may input a domain prior to performing the IDNA +conversion operations. This functionality, known as a +`mapping `_, is considered by the +specification to be a local user-interface issue distinct from IDNA +conversion functionality. + +For example, “Königsgäßchen” is not a permissible label as *LATIN +CAPITAL LETTER K* is not allowed (nor are capital letters in general). +UTS 46 will convert this into lower case prior to applying the IDNA +conversion. + +.. code-block:: pycon + + >>> import idna + >>> idna.encode('Königsgäßchen') + ... + idna.core.InvalidCodepoint: Codepoint U+004B at position 1 of 'Königsgäßchen' not allowed + >>> idna.encode('Königsgäßchen', uts46=True) + b'xn--knigsgchen-b4a3dun' + >>> print(idna.decode('xn--knigsgchen-b4a3dun')) + königsgäßchen + + +Exceptions +---------- + +All errors raised during the conversion following the specification +should raise an exception derived from the ``idna.IDNAError`` base +class. + +More specific exceptions that may be generated as ``idna.IDNABidiError`` +when the error reflects an illegal combination of left-to-right and +right-to-left characters in a label; ``idna.InvalidCodepoint`` when +a specific codepoint is an illegal character in an IDN label (i.e. +INVALID); and ``idna.InvalidCodepointContext`` when the codepoint is +illegal based on its position in the string (i.e. it is CONTEXTO or CONTEXTJ +but the contextual requirements are not satisfied.) + +Building and Diagnostics +------------------------ + +The IDNA and UTS 46 functionality relies upon pre-calculated lookup +tables for performance. These tables are derived from computing against +eligibility criteria in the respective standards using the command-line +script ``tools/idna-data``. + +This tool will fetch relevant codepoint data from the Unicode repository +and perform the required calculations to identify eligibility. There are +three main modes: + +* ``idna-data make-libdata``. Generates ``idnadata.py`` and + ``uts46data.py``, the pre-calculated lookup tables used for IDNA and + UTS 46 conversions. Implementers who wish to track this library against + a different Unicode version may use this tool to manually generate a + different version of the ``idnadata.py`` and ``uts46data.py`` files. + +* ``idna-data make-table``. Generate a table of the IDNA disposition + (e.g. PVALID, CONTEXTJ, CONTEXTO) in the format found in Appendix + B.1 of RFC 5892 and the pre-computed tables published by `IANA + `_. + +* ``idna-data U+0061``. Prints debugging output on the various + properties associated with an individual Unicode codepoint (in this + case, U+0061), that are used to assess the IDNA and UTS 46 status of a + codepoint. This is helpful in debugging or analysis. + +The tool accepts a number of arguments, described using ``idna-data +-h``. Most notably, the ``--version`` argument allows the specification +of the version of Unicode to be used in computing the table data. For +example, ``idna-data --version 9.0.0 make-libdata`` will generate +library data against Unicode 9.0.0. + + +Additional Notes +---------------- + +* **Packages**. The latest tagged release version is published in the + `Python Package Index `_. + +* **Version support**. This library supports Python 3.8 and higher. + As this library serves as a low-level toolkit for a variety of + applications, many of which strive for broad compatibility with older + Python versions, there is no rush to remove older interpreter support. + Support for older versions are likely to be removed from new releases + as automated tests can no longer easily be run, i.e. once the Python + version is officially end-of-life. + +* **Testing**. The library has a test suite based on each rule of the + IDNA specification, as well as tests that are provided as part of the + Unicode Technical Standard 46, `Unicode IDNA Compatibility Processing + `_. + +* **Emoji**. It is an occasional request to support emoji domains in + this library. Encoding of symbols like emoji is expressly prohibited by + the technical standard IDNA 2008 and emoji domains are broadly phased + out across the domain industry due to associated security risks. For + now, applications that need to support these non-compliant labels + may wish to consider trying the encode/decode operation in this library + first, and then falling back to using `encodings.idna`. See `the Github + project `_ for more discussion. + +* **Transitional processing**. Unicode 16.0.0 removed transitional + processing so the `transitional` argument for the encode() method + no longer has any effect and will be removed at a later date. + diff --git a/env/lib/python3.12/site-packages/idna-3.11.dist-info/RECORD b/env/lib/python3.12/site-packages/idna-3.11.dist-info/RECORD new file mode 100644 index 0000000..8525b6d --- /dev/null +++ b/env/lib/python3.12/site-packages/idna-3.11.dist-info/RECORD @@ -0,0 +1,22 @@ +idna-3.11.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +idna-3.11.dist-info/METADATA,sha256=fCwSww9SuiN8TIHllFSASUQCW55hAs8dzKnr9RaEEbA,8378 +idna-3.11.dist-info/RECORD,, +idna-3.11.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82 +idna-3.11.dist-info/licenses/LICENSE.md,sha256=t6M2q_OwThgOwGXN0W5wXQeeHMehT5EKpukYfza5zYc,1541 +idna/__init__.py,sha256=MPqNDLZbXqGaNdXxAFhiqFPKEQXju2jNQhCey6-5eJM,868 +idna/__pycache__/__init__.cpython-312.pyc,, +idna/__pycache__/codec.cpython-312.pyc,, +idna/__pycache__/compat.cpython-312.pyc,, +idna/__pycache__/core.cpython-312.pyc,, +idna/__pycache__/idnadata.cpython-312.pyc,, +idna/__pycache__/intranges.cpython-312.pyc,, +idna/__pycache__/package_data.cpython-312.pyc,, +idna/__pycache__/uts46data.cpython-312.pyc,, +idna/codec.py,sha256=M2SGWN7cs_6B32QmKTyTN6xQGZeYQgQ2wiX3_DR6loE,3438 +idna/compat.py,sha256=RzLy6QQCdl9784aFhb2EX9EKGCJjg0P3PilGdeXXcx8,316 +idna/core.py,sha256=P26_XVycuMTZ1R2mNK1ZREVzM5mvTzdabBXfyZVU1Lc,13246 +idna/idnadata.py,sha256=SG8jhaGE53iiD6B49pt2pwTv_UvClciWE-N54oR2p4U,79623 +idna/intranges.py,sha256=amUtkdhYcQG8Zr-CoMM_kVRacxkivC1WgxN1b63KKdU,1898 +idna/package_data.py,sha256=_CUavOxobnbyNG2FLyHoN8QHP3QM9W1tKuw7eq9QwBk,21 +idna/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +idna/uts46data.py,sha256=H9J35VkD0F9L9mKOqjeNGd2A-Va6FlPoz6Jz4K7h-ps,243725 diff --git a/env/lib/python3.12/site-packages/idna-3.11.dist-info/WHEEL b/env/lib/python3.12/site-packages/idna-3.11.dist-info/WHEEL new file mode 100644 index 0000000..d8b9936 --- /dev/null +++ b/env/lib/python3.12/site-packages/idna-3.11.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: flit 3.12.0 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/env/lib/python3.12/site-packages/idna-3.11.dist-info/licenses/LICENSE.md b/env/lib/python3.12/site-packages/idna-3.11.dist-info/licenses/LICENSE.md new file mode 100644 index 0000000..256ba90 --- /dev/null +++ b/env/lib/python3.12/site-packages/idna-3.11.dist-info/licenses/LICENSE.md @@ -0,0 +1,31 @@ +BSD 3-Clause License + +Copyright (c) 2013-2025, Kim Davies and contributors. +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. + +2. 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. + +3. Neither the name of the copyright holder nor the names of its + 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 COPYRIGHT +HOLDER 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/env/lib/python3.12/site-packages/idna/__init__.py b/env/lib/python3.12/site-packages/idna/__init__.py new file mode 100644 index 0000000..cfdc030 --- /dev/null +++ b/env/lib/python3.12/site-packages/idna/__init__.py @@ -0,0 +1,45 @@ +from .core import ( + IDNABidiError, + IDNAError, + InvalidCodepoint, + InvalidCodepointContext, + alabel, + check_bidi, + check_hyphen_ok, + check_initial_combiner, + check_label, + check_nfc, + decode, + encode, + ulabel, + uts46_remap, + valid_contextj, + valid_contexto, + valid_label_length, + valid_string_length, +) +from .intranges import intranges_contain +from .package_data import __version__ + +__all__ = [ + "__version__", + "IDNABidiError", + "IDNAError", + "InvalidCodepoint", + "InvalidCodepointContext", + "alabel", + "check_bidi", + "check_hyphen_ok", + "check_initial_combiner", + "check_label", + "check_nfc", + "decode", + "encode", + "intranges_contain", + "ulabel", + "uts46_remap", + "valid_contextj", + "valid_contexto", + "valid_label_length", + "valid_string_length", +] diff --git a/env/lib/python3.12/site-packages/idna/codec.py b/env/lib/python3.12/site-packages/idna/codec.py new file mode 100644 index 0000000..cbc2e4f --- /dev/null +++ b/env/lib/python3.12/site-packages/idna/codec.py @@ -0,0 +1,122 @@ +import codecs +import re +from typing import Any, Optional, Tuple + +from .core import IDNAError, alabel, decode, encode, ulabel + +_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)) + + 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)) + + if not data: + 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 not data: + return b"", 0 + + labels = _unicode_dots_re.split(data) + trailing_dot = b"" + if labels: + if not labels[-1]: + 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"." + + result = [] + size = 0 + for label in labels: + result.append(alabel(label)) + if size: + size += 1 + size += len(label) + + # Join with U+002E + 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 not data: + return ("", 0) + + if not isinstance(data, str): + data = str(data, "ascii") + + labels = _unicode_dots_re.split(data) + trailing_dot = "" + if labels: + if not labels[-1]: + trailing_dot = "." + del labels[-1] + elif not final: + # Keep potentially unfinished label until the next call + del labels[-1] + if labels: + trailing_dot = "." + + result = [] + size = 0 + for label in labels: + result.append(ulabel(label)) + if size: + size += 1 + size += len(label) + + result_str = ".".join(result) + trailing_dot + size += len(trailing_dot) + return (result_str, size) + + +class StreamWriter(Codec, codecs.StreamWriter): + pass + + +class StreamReader(Codec, codecs.StreamReader): + pass + + +def search_function(name: str) -> Optional[codecs.CodecInfo]: + if name != "idna2008": + return None + return codecs.CodecInfo( + name=name, + encode=Codec().encode, + decode=Codec().decode, # type: ignore + incrementalencoder=IncrementalEncoder, + incrementaldecoder=IncrementalDecoder, + streamwriter=StreamWriter, + streamreader=StreamReader, + ) + + +codecs.register(search_function) diff --git a/env/lib/python3.12/site-packages/idna/compat.py b/env/lib/python3.12/site-packages/idna/compat.py new file mode 100644 index 0000000..1df9f2a --- /dev/null +++ b/env/lib/python3.12/site-packages/idna/compat.py @@ -0,0 +1,15 @@ +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") diff --git a/env/lib/python3.12/site-packages/idna/core.py b/env/lib/python3.12/site-packages/idna/core.py new file mode 100644 index 0000000..8177bf7 --- /dev/null +++ b/env/lib/python3.12/site-packages/idna/core.py @@ -0,0 +1,437 @@ +import bisect +import re +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]") + + +class IDNAError(UnicodeError): + """Base exception for all IDNA-encoding related problems""" + + pass + + +class IDNABidiError(IDNAError): + """Exception when bidirectional requirements are not satisfied""" + + pass + + +class InvalidCodepoint(IDNAError): + """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""" + + pass + + +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") + 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") + + +def _unot(s: int) -> str: + return "U+{:04X}".format(s) + + +def valid_label_length(label: Union[bytes, str]) -> bool: + if len(label) > 63: + return False + return True + + +def valid_string_length(label: Union[bytes, str], trailing_dot: bool) -> bool: + if len(label) > (254 if trailing_dot else 253): + return False + return True + + +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): + direction = unicodedata.bidirectional(cp) + 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"]: + 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"]: + rtl = True + elif direction == "L": + rtl = False + else: + raise IDNABidiError("First codepoint in label {} must be directionality L, R or AL".format(repr(label))) + + valid_ending = False + number_type: Optional[str] = None + for idx, cp in enumerate(label, 1): + direction = unicodedata.bidirectional(cp) + + if rtl: + # Bidi rule 2 + 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"]: + valid_ending = True + elif direction != "NSM": + valid_ending = False + # Bidi rule 4 + 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") + else: + # Bidi rule 5 + 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"]: + valid_ending = True + elif direction != "NSM": + valid_ending = False + + if not valid_ending: + 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") + 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") + return True + + +def check_nfc(label: str) -> None: + 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 pos > 0: + if _combining_class(ord(label[pos - 1])) == _virama_combining_class: + return True + + ok = False + for i in range(pos - 1, -1, -1): + joining_type = idnadata.joining_types.get(ord(label[i])) + if joining_type == ord("T"): + continue + elif joining_type in [ord("L"), ord("D")]: + ok = True + break + else: + break + + if not ok: + return False + + ok = False + for i in range(pos + 1, len(label)): + joining_type = idnadata.joining_types.get(ord(label[i])) + if joining_type == ord("T"): + continue + elif joining_type in [ord("R"), ord("D")]: + ok = True + break + else: + break + return ok + + 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: + return True + return False + + elif cp_value == 0x0375: + 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: + if pos > 0: + return _is_script(label[pos - 1], "Hebrew") + return False + + elif cp_value == 0x30FB: + for cp in label: + if cp == "\u30fb": + continue + 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: + return False + return True + + elif 0x6F0 <= cp_value <= 0x6F9: + for cp in label: + if 0x660 <= ord(cp) <= 0x0669: + return False + return True + + return False + + +def check_label(label: Union[str, bytes, bytearray]) -> None: + if isinstance(label, (bytes, bytearray)): + label = label.decode("utf-8") + if len(label) == 0: + raise IDNAError("Empty Label") + + check_nfc(label) + check_hyphen_ok(label) + check_initial_combiner(label) + + for pos, cp in enumerate(label): + cp_value = ord(cp) + 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( + _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)) + ) + else: + 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") + ulabel(label_bytes) + if not valid_label_length(label_bytes): + raise IDNAError("Label too long") + return label_bytes + except UnicodeEncodeError: + pass + + check_label(label) + label_bytes = _alabel_prefix + _punycode(label) + + if not valid_label_length(label_bytes): + raise IDNAError("Label too long") + + return label_bytes + + +def ulabel(label: Union[str, bytes, bytearray]) -> str: + if not isinstance(label, (bytes, bytearray)): + try: + label_bytes = label.encode("ascii") + except UnicodeEncodeError: + check_label(label) + return label + else: + label_bytes = bytes(label) + + label_bytes = label_bytes.lower() + if label_bytes.startswith(_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") + else: + check_label(label_bytes) + return label_bytes.decode("ascii") + + try: + label = label_bytes.decode("punycode") + except UnicodeError: + raise IDNAError("Invalid A-label") + check_label(label) + return label + + +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 = "" + + 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] + status = uts46row[1] + 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) + ): + output += char + 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": + raise IndexError() + except IndexError: + raise InvalidCodepoint( + "Codepoint {} not allowed at position {} in {}".format(_unot(code_point), pos + 1, repr(domain)) + ) + + 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: + if not isinstance(s, str): + try: + s = str(s, "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 + result = [] + if strict: + labels = s.split(".") + else: + labels = _unicode_dots_re.split(s) + if not labels or labels == [""]: + raise IDNAError("Empty domain") + if labels[-1] == "": + del labels[-1] + trailing_dot = True + for label in labels: + s = alabel(label) + if s: + result.append(s) + else: + raise IDNAError("Empty label") + if trailing_dot: + result.append(b"") + s = b".".join(result) + if not valid_string_length(s, trailing_dot): + 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: + try: + if not isinstance(s, str): + s = str(s, "ascii") + except UnicodeDecodeError: + raise IDNAError("Invalid ASCII in A-label") + if uts46: + s = uts46_remap(s, std3_rules, False) + trailing_dot = False + result = [] + if not strict: + labels = _unicode_dots_re.split(s) + else: + labels = s.split(".") + if not labels or labels == [""]: + raise IDNAError("Empty domain") + if not labels[-1]: + del labels[-1] + trailing_dot = True + for label in labels: + s = ulabel(label) + if s: + result.append(s) + else: + raise IDNAError("Empty label") + if trailing_dot: + result.append("") + return ".".join(result) diff --git a/env/lib/python3.12/site-packages/idna/idnadata.py b/env/lib/python3.12/site-packages/idna/idnadata.py new file mode 100644 index 0000000..ded47ca --- /dev/null +++ b/env/lib/python3.12/site-packages/idna/idnadata.py @@ -0,0 +1,4309 @@ +# This file is automatically generated by tools/idna-data + +__version__ = "16.0.0" + +scripts = { + "Greek": ( + 0x37000000374, + 0x37500000378, + 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, + 0x212600002127, + 0xAB650000AB66, + 0x101400001018F, + 0x101A0000101A1, + 0x1D2000001D246, + ), + "Han": ( + 0x2E8000002E9A, + 0x2E9B00002EF4, + 0x2F0000002FD6, + 0x300500003006, + 0x300700003008, + 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, + ), + "Hiragana": ( + 0x304100003097, + 0x309D000030A0, + 0x1B0010001B120, + 0x1B1320001B133, + 0x1B1500001B153, + 0x1F2000001F201, + ), + "Katakana": ( + 0x30A1000030FB, + 0x30FD00003100, + 0x31F000003200, + 0x32D0000032FF, + 0x330000003358, + 0xFF660000FF70, + 0xFF710000FF9E, + 0x1AFF00001AFF4, + 0x1AFF50001AFFC, + 0x1AFFD0001AFFF, + 0x1B0000001B001, + 0x1B1200001B123, + 0x1B1550001B156, + 0x1B1640001B168, + ), +} +joining_types = { + 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, + 0x622: 82, + 0x623: 82, + 0x624: 82, + 0x625: 82, + 0x626: 68, + 0x627: 82, + 0x628: 68, + 0x629: 82, + 0x62A: 68, + 0x62B: 68, + 0x62C: 68, + 0x62D: 68, + 0x62E: 68, + 0x62F: 82, + 0x630: 82, + 0x631: 82, + 0x632: 82, + 0x633: 68, + 0x634: 68, + 0x635: 68, + 0x636: 68, + 0x637: 68, + 0x638: 68, + 0x639: 68, + 0x63A: 68, + 0x63B: 68, + 0x63C: 68, + 0x63D: 68, + 0x63E: 68, + 0x63F: 68, + 0x640: 67, + 0x641: 68, + 0x642: 68, + 0x643: 68, + 0x644: 68, + 0x645: 68, + 0x646: 68, + 0x647: 68, + 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, + 0x675: 82, + 0x676: 82, + 0x677: 82, + 0x678: 68, + 0x679: 68, + 0x67A: 68, + 0x67B: 68, + 0x67C: 68, + 0x67D: 68, + 0x67E: 68, + 0x67F: 68, + 0x680: 68, + 0x681: 68, + 0x682: 68, + 0x683: 68, + 0x684: 68, + 0x685: 68, + 0x686: 68, + 0x687: 68, + 0x688: 82, + 0x689: 82, + 0x68A: 82, + 0x68B: 82, + 0x68C: 82, + 0x68D: 82, + 0x68E: 82, + 0x68F: 82, + 0x690: 82, + 0x691: 82, + 0x692: 82, + 0x693: 82, + 0x694: 82, + 0x695: 82, + 0x696: 82, + 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, + 0x710: 82, + 0x711: 84, + 0x712: 68, + 0x713: 68, + 0x714: 68, + 0x715: 82, + 0x716: 82, + 0x717: 82, + 0x718: 82, + 0x719: 82, + 0x71A: 68, + 0x71B: 68, + 0x71C: 68, + 0x71D: 68, + 0x71E: 82, + 0x71F: 68, + 0x720: 68, + 0x721: 68, + 0x722: 68, + 0x723: 68, + 0x724: 68, + 0x725: 68, + 0x726: 68, + 0x727: 68, + 0x728: 82, + 0x729: 68, + 0x72A: 82, + 0x72B: 68, + 0x72C: 82, + 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, + 0x750: 68, + 0x751: 68, + 0x752: 68, + 0x753: 68, + 0x754: 68, + 0x755: 68, + 0x756: 68, + 0x757: 68, + 0x758: 68, + 0x759: 82, + 0x75A: 82, + 0x75B: 82, + 0x75C: 68, + 0x75D: 68, + 0x75E: 68, + 0x75F: 68, + 0x760: 68, + 0x761: 68, + 0x762: 68, + 0x763: 68, + 0x764: 68, + 0x765: 68, + 0x766: 68, + 0x767: 68, + 0x768: 68, + 0x769: 68, + 0x76A: 68, + 0x76B: 82, + 0x76C: 82, + 0x76D: 68, + 0x76E: 68, + 0x76F: 68, + 0x770: 68, + 0x771: 82, + 0x772: 68, + 0x773: 82, + 0x774: 82, + 0x775: 68, + 0x776: 68, + 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, + 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, + 0x843: 68, + 0x844: 68, + 0x845: 68, + 0x846: 82, + 0x847: 82, + 0x848: 68, + 0x849: 82, + 0x84A: 68, + 0x84B: 68, + 0x84C: 68, + 0x84D: 68, + 0x84E: 68, + 0x84F: 68, + 0x850: 68, + 0x851: 68, + 0x852: 68, + 0x853: 68, + 0x854: 82, + 0x855: 68, + 0x856: 82, + 0x857: 82, + 0x858: 82, + 0x859: 84, + 0x85A: 84, + 0x85B: 84, + 0x860: 68, + 0x862: 68, + 0x863: 68, + 0x864: 68, + 0x865: 68, + 0x867: 82, + 0x868: 68, + 0x869: 82, + 0x86A: 82, + 0x870: 82, + 0x871: 82, + 0x872: 82, + 0x873: 82, + 0x874: 82, + 0x875: 82, + 0x876: 82, + 0x877: 82, + 0x878: 82, + 0x879: 82, + 0x87A: 82, + 0x87B: 82, + 0x87C: 82, + 0x87D: 82, + 0x87E: 82, + 0x87F: 82, + 0x880: 82, + 0x881: 82, + 0x882: 82, + 0x883: 67, + 0x884: 67, + 0x885: 67, + 0x886: 68, + 0x889: 68, + 0x88A: 68, + 0x88B: 68, + 0x88C: 68, + 0x88D: 68, + 0x88E: 82, + 0x897: 84, + 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, + 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, + 0x180B: 84, + 0x180C: 84, + 0x180D: 84, + 0x180F: 84, + 0x1820: 68, + 0x1821: 68, + 0x1822: 68, + 0x1823: 68, + 0x1824: 68, + 0x1825: 68, + 0x1826: 68, + 0x1827: 68, + 0x1828: 68, + 0x1829: 68, + 0x182A: 68, + 0x182B: 68, + 0x182C: 68, + 0x182D: 68, + 0x182E: 68, + 0x182F: 68, + 0x1830: 68, + 0x1831: 68, + 0x1832: 68, + 0x1833: 68, + 0x1834: 68, + 0x1835: 68, + 0x1836: 68, + 0x1837: 68, + 0x1838: 68, + 0x1839: 68, + 0x183A: 68, + 0x183B: 68, + 0x183C: 68, + 0x183D: 68, + 0x183E: 68, + 0x183F: 68, + 0x1840: 68, + 0x1841: 68, + 0x1842: 68, + 0x1843: 68, + 0x1844: 68, + 0x1845: 68, + 0x1846: 68, + 0x1847: 68, + 0x1848: 68, + 0x1849: 68, + 0x184A: 68, + 0x184B: 68, + 0x184C: 68, + 0x184D: 68, + 0x184E: 68, + 0x184F: 68, + 0x1850: 68, + 0x1851: 68, + 0x1852: 68, + 0x1853: 68, + 0x1854: 68, + 0x1855: 68, + 0x1856: 68, + 0x1857: 68, + 0x1858: 68, + 0x1859: 68, + 0x185A: 68, + 0x185B: 68, + 0x185C: 68, + 0x185D: 68, + 0x185E: 68, + 0x185F: 68, + 0x1860: 68, + 0x1861: 68, + 0x1862: 68, + 0x1863: 68, + 0x1864: 68, + 0x1865: 68, + 0x1866: 68, + 0x1867: 68, + 0x1868: 68, + 0x1869: 68, + 0x186A: 68, + 0x186B: 68, + 0x186C: 68, + 0x186D: 68, + 0x186E: 68, + 0x186F: 68, + 0x1870: 68, + 0x1871: 68, + 0x1872: 68, + 0x1873: 68, + 0x1874: 68, + 0x1875: 68, + 0x1876: 68, + 0x1877: 68, + 0x1878: 68, + 0x1885: 84, + 0x1886: 84, + 0x1887: 68, + 0x1888: 68, + 0x1889: 68, + 0x188A: 68, + 0x188B: 68, + 0x188C: 68, + 0x188D: 68, + 0x188E: 68, + 0x188F: 68, + 0x1890: 68, + 0x1891: 68, + 0x1892: 68, + 0x1893: 68, + 0x1894: 68, + 0x1895: 68, + 0x1896: 68, + 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, + 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, + 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, + 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, + 0x10D69: 84, + 0x10D6A: 84, + 0x10D6B: 84, + 0x10D6C: 84, + 0x10D6D: 84, + 0x10EAB: 84, + 0x10EAC: 84, + 0x10EC2: 82, + 0x10EC3: 68, + 0x10EC4: 68, + 0x10EFC: 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, + 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, + 0x113BB: 84, + 0x113BC: 84, + 0x113BD: 84, + 0x113BE: 84, + 0x113BF: 84, + 0x113C0: 84, + 0x113CE: 84, + 0x113D0: 84, + 0x113D2: 84, + 0x113E1: 84, + 0x113E2: 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, + 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, + 0x11F5A: 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, + 0x1611E: 84, + 0x1611F: 84, + 0x16120: 84, + 0x16121: 84, + 0x16122: 84, + 0x16123: 84, + 0x16124: 84, + 0x16125: 84, + 0x16126: 84, + 0x16127: 84, + 0x16128: 84, + 0x16129: 84, + 0x1612D: 84, + 0x1612E: 84, + 0x1612F: 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, + 0x1E5EE: 84, + 0x1E5EF: 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, + 0x10100000102, + 0x10300000104, + 0x10500000106, + 0x10700000108, + 0x1090000010A, + 0x10B0000010C, + 0x10D0000010E, + 0x10F00000110, + 0x11100000112, + 0x11300000114, + 0x11500000116, + 0x11700000118, + 0x1190000011A, + 0x11B0000011C, + 0x11D0000011E, + 0x11F00000120, + 0x12100000122, + 0x12300000124, + 0x12500000126, + 0x12700000128, + 0x1290000012A, + 0x12B0000012C, + 0x12D0000012E, + 0x12F00000130, + 0x13100000132, + 0x13500000136, + 0x13700000139, + 0x13A0000013B, + 0x13C0000013D, + 0x13E0000013F, + 0x14200000143, + 0x14400000145, + 0x14600000147, + 0x14800000149, + 0x14B0000014C, + 0x14D0000014E, + 0x14F00000150, + 0x15100000152, + 0x15300000154, + 0x15500000156, + 0x15700000158, + 0x1590000015A, + 0x15B0000015C, + 0x15D0000015E, + 0x15F00000160, + 0x16100000162, + 0x16300000164, + 0x16500000166, + 0x16700000168, + 0x1690000016A, + 0x16B0000016C, + 0x16D0000016E, + 0x16F00000170, + 0x17100000172, + 0x17300000174, + 0x17500000176, + 0x17700000178, + 0x17A0000017B, + 0x17C0000017D, + 0x17E0000017F, + 0x18000000181, + 0x18300000184, + 0x18500000186, + 0x18800000189, + 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, + 0x20100000202, + 0x20300000204, + 0x20500000206, + 0x20700000208, + 0x2090000020A, + 0x20B0000020C, + 0x20D0000020E, + 0x20F00000210, + 0x21100000212, + 0x21300000214, + 0x21500000216, + 0x21700000218, + 0x2190000021A, + 0x21B0000021C, + 0x21D0000021E, + 0x21F00000220, + 0x22100000222, + 0x22300000224, + 0x22500000226, + 0x22700000228, + 0x2290000022A, + 0x22B0000022C, + 0x22D0000022E, + 0x22F00000230, + 0x23100000232, + 0x2330000023A, + 0x23C0000023D, + 0x23F00000241, + 0x24200000243, + 0x24700000248, + 0x2490000024A, + 0x24B0000024C, + 0x24D0000024E, + 0x24F000002B0, + 0x2B9000002C2, + 0x2C6000002D2, + 0x2EC000002ED, + 0x2EE000002EF, + 0x30000000340, + 0x34200000343, + 0x3460000034F, + 0x35000000370, + 0x37100000372, + 0x37300000374, + 0x37700000378, + 0x37B0000037E, + 0x39000000391, + 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, + 0x47100000472, + 0x47300000474, + 0x47500000476, + 0x47700000478, + 0x4790000047A, + 0x47B0000047C, + 0x47D0000047E, + 0x47F00000480, + 0x48100000482, + 0x48300000488, + 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, + 0x50100000502, + 0x50300000504, + 0x50500000506, + 0x50700000508, + 0x5090000050A, + 0x50B0000050C, + 0x50D0000050E, + 0x50F00000510, + 0x51100000512, + 0x51300000514, + 0x51500000516, + 0x51700000518, + 0x5190000051A, + 0x51B0000051C, + 0x51D0000051E, + 0x51F00000520, + 0x52100000522, + 0x52300000524, + 0x52500000526, + 0x52700000528, + 0x5290000052A, + 0x52B0000052C, + 0x52D0000052E, + 0x52F00000530, + 0x5590000055A, + 0x56000000587, + 0x58800000589, + 0x591000005BE, + 0x5BF000005C0, + 0x5C1000005C3, + 0x5C4000005C6, + 0x5C7000005C8, + 0x5D0000005EB, + 0x5EF000005F3, + 0x6100000061B, + 0x62000000640, + 0x64100000660, + 0x66E00000675, + 0x679000006D4, + 0x6D5000006DD, + 0x6DF000006E9, + 0x6EA000006F0, + 0x6FA00000700, + 0x7100000074B, + 0x74D000007B2, + 0x7C0000007F6, + 0x7FD000007FE, + 0x8000000082E, + 0x8400000085C, + 0x8600000086B, + 0x87000000888, + 0x8890000088F, + 0x897000008E2, + 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, + 0x120000001249, + 0x124A0000124E, + 0x125000001257, + 0x125800001259, + 0x125A0000125E, + 0x126000001289, + 0x128A0000128E, + 0x1290000012B1, + 0x12B2000012B6, + 0x12B8000012BF, + 0x12C0000012C1, + 0x12C2000012C6, + 0x12C8000012D7, + 0x12D800001311, + 0x131200001316, + 0x13180000135B, + 0x135D00001360, + 0x138000001390, + 0x13A0000013F6, + 0x14010000166D, + 0x166F00001680, + 0x16810000169B, + 0x16A0000016EB, + 0x16F1000016F9, + 0x170000001716, + 0x171F00001735, + 0x174000001754, + 0x17600000176D, + 0x176E00001771, + 0x177200001774, + 0x1780000017B4, + 0x17B6000017D4, + 0x17D7000017D8, + 0x17DC000017DE, + 0x17E0000017EA, + 0x18100000181A, + 0x182000001879, + 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, + 0x1C8A00001C8B, + 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, + 0x300500003008, + 0x302A0000302E, + 0x303C0000303D, + 0x304100003097, + 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, + 0xA7CD0000A7CE, + 0xA7D10000A7D2, + 0xA7D30000A7D4, + 0xA7D50000A7D6, + 0xA7D70000A7D8, + 0xA7D90000A7DA, + 0xA7DB0000A7DC, + 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, + 0x1050000010528, + 0x1053000010564, + 0x10597000105A2, + 0x105A3000105B2, + 0x105B3000105BA, + 0x105BB000105BD, + 0x105C0000105F4, + 0x1060000010737, + 0x1074000010756, + 0x1076000010768, + 0x1078000010781, + 0x1080000010806, + 0x1080800010809, + 0x1080A00010836, + 0x1083700010839, + 0x1083C0001083D, + 0x1083F00010856, + 0x1086000010877, + 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, + 0x10D4000010D50, + 0x10D6900010D6E, + 0x10D6F00010D86, + 0x10E8000010EAA, + 0x10EAB00010EAD, + 0x10EB000010EB2, + 0x10EC200010EC5, + 0x10EFC00010F1D, + 0x10F2700010F28, + 0x10F3000010F51, + 0x10F7000010F86, + 0x10FB000010FC5, + 0x10FE000010FF7, + 0x1100000011047, + 0x1106600011076, + 0x1107F000110BB, + 0x110C2000110C3, + 0x110D0000110E9, + 0x110F0000110FA, + 0x1110000011135, + 0x1113600011140, + 0x1114400011148, + 0x1115000011174, + 0x1117600011177, + 0x11180000111C5, + 0x111C9000111CD, + 0x111CE000111DB, + 0x111DC000111DD, + 0x1120000011212, + 0x1121300011238, + 0x1123E00011242, + 0x1128000011287, + 0x1128800011289, + 0x1128A0001128E, + 0x1128F0001129E, + 0x1129F000112A9, + 0x112B0000112EB, + 0x112F0000112FA, + 0x1130000011304, + 0x113050001130D, + 0x1130F00011311, + 0x1131300011329, + 0x1132A00011331, + 0x1133200011334, + 0x113350001133A, + 0x1133B00011345, + 0x1134700011349, + 0x1134B0001134E, + 0x1135000011351, + 0x1135700011358, + 0x1135D00011364, + 0x113660001136D, + 0x1137000011375, + 0x113800001138A, + 0x1138B0001138C, + 0x1138E0001138F, + 0x11390000113B6, + 0x113B7000113C1, + 0x113C2000113C3, + 0x113C5000113C6, + 0x113C7000113CB, + 0x113CC000113D4, + 0x113E1000113E3, + 0x114000001144B, + 0x114500001145A, + 0x1145E00011462, + 0x11480000114C6, + 0x114C7000114C8, + 0x114D0000114DA, + 0x11580000115B6, + 0x115B8000115C1, + 0x115D8000115DE, + 0x1160000011641, + 0x1164400011645, + 0x116500001165A, + 0x11680000116B9, + 0x116C0000116CA, + 0x116D0000116E4, + 0x117000001171B, + 0x1171D0001172C, + 0x117300001173A, + 0x1174000011747, + 0x118000001183B, + 0x118C0000118EA, + 0x118FF00011907, + 0x119090001190A, + 0x1190C00011914, + 0x1191500011917, + 0x1191800011936, + 0x1193700011939, + 0x1193B00011944, + 0x119500001195A, + 0x119A0000119A8, + 0x119AA000119D8, + 0x119DA000119E2, + 0x119E3000119E5, + 0x11A0000011A3F, + 0x11A4700011A48, + 0x11A5000011A9A, + 0x11A9D00011A9E, + 0x11AB000011AF9, + 0x11BC000011BE1, + 0x11BF000011BFA, + 0x11C0000011C09, + 0x11C0A00011C37, + 0x11C3800011C41, + 0x11C5000011C5A, + 0x11C7200011C90, + 0x11C9200011CA8, + 0x11CA900011CB7, + 0x11D0000011D07, + 0x11D0800011D0A, + 0x11D0B00011D37, + 0x11D3A00011D3B, + 0x11D3C00011D3E, + 0x11D3F00011D48, + 0x11D5000011D5A, + 0x11D6000011D66, + 0x11D6700011D69, + 0x11D6A00011D8F, + 0x11D9000011D92, + 0x11D9300011D99, + 0x11DA000011DAA, + 0x11EE000011EF7, + 0x11F0000011F11, + 0x11F1200011F3B, + 0x11F3E00011F43, + 0x11F5000011F5B, + 0x11FB000011FB1, + 0x120000001239A, + 0x1248000012544, + 0x12F9000012FF1, + 0x1300000013430, + 0x1344000013456, + 0x13460000143FB, + 0x1440000014647, + 0x161000001613A, + 0x1680000016A39, + 0x16A4000016A5F, + 0x16A6000016A6A, + 0x16A7000016ABF, + 0x16AC000016ACA, + 0x16AD000016AEE, + 0x16AF000016AF5, + 0x16B0000016B37, + 0x16B4000016B44, + 0x16B5000016B5A, + 0x16B6300016B78, + 0x16B7D00016B90, + 0x16D4000016D6D, + 0x16D7000016D7A, + 0x16E6000016E80, + 0x16F0000016F4B, + 0x16F4F00016F88, + 0x16F8F00016FA0, + 0x16FE000016FE2, + 0x16FE300016FE5, + 0x16FF000016FF2, + 0x17000000187F8, + 0x1880000018CD6, + 0x18CFF00018D09, + 0x1AFF00001AFF4, + 0x1AFF50001AFFC, + 0x1AFFD0001AFFF, + 0x1B0000001B123, + 0x1B1320001B133, + 0x1B1500001B153, + 0x1B1550001B156, + 0x1B1640001B168, + 0x1B1700001B2FC, + 0x1BC000001BC6B, + 0x1BC700001BC7D, + 0x1BC800001BC89, + 0x1BC900001BC9A, + 0x1BC9D0001BC9F, + 0x1CCF00001CCFA, + 0x1CF000001CF2E, + 0x1CF300001CF47, + 0x1DA000001DA37, + 0x1DA3B0001DA6D, + 0x1DA750001DA76, + 0x1DA840001DA85, + 0x1DA9B0001DAA0, + 0x1DAA10001DAB0, + 0x1DF000001DF1F, + 0x1DF250001DF2B, + 0x1E0000001E007, + 0x1E0080001E019, + 0x1E01B0001E022, + 0x1E0230001E025, + 0x1E0260001E02B, + 0x1E08F0001E090, + 0x1E1000001E12D, + 0x1E1300001E13E, + 0x1E1400001E14A, + 0x1E14E0001E14F, + 0x1E2900001E2AF, + 0x1E2C00001E2FA, + 0x1E4D00001E4FA, + 0x1E5D00001E5FB, + 0x1E7E00001E7E7, + 0x1E7E80001E7EC, + 0x1E7ED0001E7EF, + 0x1E7F00001E7FF, + 0x1E8000001E8C5, + 0x1E8D00001E8D7, + 0x1E9220001E94C, + 0x1E9500001E95A, + 0x200000002A6E0, + 0x2A7000002B73A, + 0x2B7400002B81E, + 0x2B8200002CEA2, + 0x2CEB00002EBE1, + 0x2EBF00002EE5E, + 0x300000003134B, + 0x31350000323B0, + ), + "CONTEXTJ": (0x200C0000200E,), + "CONTEXTO": ( + 0xB7000000B8, + 0x37500000376, + 0x5F3000005F5, + 0x6600000066A, + 0x6F0000006FA, + 0x30FB000030FC, + ), +} diff --git a/env/lib/python3.12/site-packages/idna/intranges.py b/env/lib/python3.12/site-packages/idna/intranges.py new file mode 100644 index 0000000..7bfaa8d --- /dev/null +++ b/env/lib/python3.12/site-packages/idna/intranges.py @@ -0,0 +1,57 @@ +""" +Given a list of integers, made up of (hopefully) a small number of long runs +of consecutive integers, compute a representation of the form +((start1, end1), (start2, end2) ...). Then answer the question "was x present +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 + integers are exactly those x such that start_i <= x < end_i for some i. + + Ranges are encoded as single integers (start << 32 | end), not as tuples. + """ + + sorted_list = sorted(list_) + 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: + continue + 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)) + + +def intranges_contain(int_: int, ranges: Tuple[int, ...]) -> bool: + """Determine if `int_` falls into one of the ranges in `ranges`.""" + tuple_ = _encode_range(int_, 0) + pos = bisect.bisect_left(ranges, tuple_) + # we could be immediately ahead of a tuple (start, end) + # with start < int_ <= end + if pos > 0: + left, right = _decode_range(ranges[pos - 1]) + if left <= int_ < right: + return True + # or we could be immediately behind a tuple (int_, end) + if pos < len(ranges): + left, _ = _decode_range(ranges[pos]) + if left == int_: + return True + return False diff --git a/env/lib/python3.12/site-packages/idna/package_data.py b/env/lib/python3.12/site-packages/idna/package_data.py new file mode 100644 index 0000000..7272c8d --- /dev/null +++ b/env/lib/python3.12/site-packages/idna/package_data.py @@ -0,0 +1 @@ +__version__ = "3.11" diff --git a/env/lib/python3.12/site-packages/idna/py.typed b/env/lib/python3.12/site-packages/idna/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/lib/python3.12/site-packages/idna/uts46data.py b/env/lib/python3.12/site-packages/idna/uts46data.py new file mode 100644 index 0000000..4610b71 --- /dev/null +++ b/env/lib/python3.12/site-packages/idna/uts46data.py @@ -0,0 +1,8841 @@ +# This file is automatically generated by tools/idna-data +# vim: set fileencoding=utf-8 : + +from typing import List, Tuple, Union + +"""IDNA Mapping Table from UTS46.""" + + +__version__ = "16.0.0" + + +def _seg_0() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x0, "V"), + (0x1, "V"), + (0x2, "V"), + (0x3, "V"), + (0x4, "V"), + (0x5, "V"), + (0x6, "V"), + (0x7, "V"), + (0x8, "V"), + (0x9, "V"), + (0xA, "V"), + (0xB, "V"), + (0xC, "V"), + (0xD, "V"), + (0xE, "V"), + (0xF, "V"), + (0x10, "V"), + (0x11, "V"), + (0x12, "V"), + (0x13, "V"), + (0x14, "V"), + (0x15, "V"), + (0x16, "V"), + (0x17, "V"), + (0x18, "V"), + (0x19, "V"), + (0x1A, "V"), + (0x1B, "V"), + (0x1C, "V"), + (0x1D, "V"), + (0x1E, "V"), + (0x1F, "V"), + (0x20, "V"), + (0x21, "V"), + (0x22, "V"), + (0x23, "V"), + (0x24, "V"), + (0x25, "V"), + (0x26, "V"), + (0x27, "V"), + (0x28, "V"), + (0x29, "V"), + (0x2A, "V"), + (0x2B, "V"), + (0x2C, "V"), + (0x2D, "V"), + (0x2E, "V"), + (0x2F, "V"), + (0x30, "V"), + (0x31, "V"), + (0x32, "V"), + (0x33, "V"), + (0x34, "V"), + (0x35, "V"), + (0x36, "V"), + (0x37, "V"), + (0x38, "V"), + (0x39, "V"), + (0x3A, "V"), + (0x3B, "V"), + (0x3C, "V"), + (0x3D, "V"), + (0x3E, "V"), + (0x3F, "V"), + (0x40, "V"), + (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, "V"), + (0x5C, "V"), + (0x5D, "V"), + (0x5E, "V"), + (0x5F, "V"), + (0x60, "V"), + (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, "V"), + (0x7C, "V"), + (0x7D, "V"), + (0x7E, "V"), + (0x7F, "V"), + (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, "M", " "), + (0xA1, "V"), + (0xA2, "V"), + (0xA3, "V"), + (0xA4, "V"), + (0xA5, "V"), + (0xA6, "V"), + (0xA7, "V"), + (0xA8, "M", " ̈"), + (0xA9, "V"), + (0xAA, "M", "a"), + (0xAB, "V"), + (0xAC, "V"), + (0xAD, "I"), + (0xAE, "V"), + (0xAF, "M", " ̄"), + (0xB0, "V"), + (0xB1, "V"), + (0xB2, "M", "2"), + (0xB3, "M", "3"), + (0xB4, "M", " ́"), + (0xB5, "M", "μ"), + (0xB6, "V"), + (0xB7, "V"), + (0xB8, "M", " ̧"), + (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"), + ] + + +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", "ɠ"), + ] + + +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", "ȍ"), + ] + + +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, "M", " ̆"), + (0x2D9, "M", " ̇"), + (0x2DA, "M", " ̊"), + (0x2DB, "M", " ̨"), + (0x2DC, "M", " ̃"), + (0x2DD, "M", " ̋"), + (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, "M", " ι"), + (0x37B, "V"), + (0x37E, "M", ";"), + (0x37F, "M", "ϳ"), + (0x380, "X"), + (0x384, "M", " ́"), + (0x385, "M", " ̈́"), + (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"), + ] + + +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, "M", "ӏ"), + (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"), + ] + + +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"), + (0x897, "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"), + ] + + +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"), + ] + + +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, "M", "ⴀ"), + (0x10A1, "M", "ⴁ"), + (0x10A2, "M", "ⴂ"), + (0x10A3, "M", "ⴃ"), + (0x10A4, "M", "ⴄ"), + (0x10A5, "M", "ⴅ"), + (0x10A6, "M", "ⴆ"), + (0x10A7, "M", "ⴇ"), + (0x10A8, "M", "ⴈ"), + (0x10A9, "M", "ⴉ"), + (0x10AA, "M", "ⴊ"), + (0x10AB, "M", "ⴋ"), + (0x10AC, "M", "ⴌ"), + (0x10AD, "M", "ⴍ"), + (0x10AE, "M", "ⴎ"), + (0x10AF, "M", "ⴏ"), + (0x10B0, "M", "ⴐ"), + (0x10B1, "M", "ⴑ"), + (0x10B2, "M", "ⴒ"), + (0x10B3, "M", "ⴓ"), + (0x10B4, "M", "ⴔ"), + (0x10B5, "M", "ⴕ"), + (0x10B6, "M", "ⴖ"), + (0x10B7, "M", "ⴗ"), + (0x10B8, "M", "ⴘ"), + (0x10B9, "M", "ⴙ"), + (0x10BA, "M", "ⴚ"), + (0x10BB, "M", "ⴛ"), + (0x10BC, "M", "ⴜ"), + (0x10BD, "M", "ⴝ"), + (0x10BE, "M", "ⴞ"), + (0x10BF, "M", "ⴟ"), + (0x10C0, "M", "ⴠ"), + (0x10C1, "M", "ⴡ"), + (0x10C2, "M", "ⴢ"), + (0x10C3, "M", "ⴣ"), + (0x10C4, "M", "ⴤ"), + (0x10C5, "M", "ⴥ"), + ] + + +def _seg_14() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x10C6, "X"), + (0x10C7, "M", "ⴧ"), + (0x10C8, "X"), + (0x10CD, "M", "ⴭ"), + (0x10CE, "X"), + (0x10D0, "V"), + (0x10FC, "M", "ნ"), + (0x10FD, "V"), + (0x115F, "I"), + (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"), + (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, "I"), + (0x17B6, "V"), + (0x17DE, "X"), + (0x17E0, "V"), + (0x17EA, "X"), + (0x17F0, "V"), + (0x17FA, "X"), + (0x1800, "V"), + (0x180B, "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"), + ] + + +def _seg_15() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (0x1B4E, "V"), + (0x1BF4, "X"), + (0x1BFC, "V"), + (0x1C38, "X"), + (0x1C3B, "V"), + (0x1C4A, "X"), + (0x1C4D, "V"), + (0x1C80, "M", "в"), + (0x1C81, "M", "д"), + (0x1C82, "M", "о"), + (0x1C83, "M", "с"), + (0x1C84, "M", "т"), + (0x1C86, "M", "ъ"), + (0x1C87, "M", "ѣ"), + (0x1C88, "M", "ꙋ"), + (0x1C89, "M", "ᲊ"), + (0x1C8A, "V"), + (0x1C8B, "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"), + ] + + +def _seg_16() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "ɔ"), + (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"), + ] + + +def _seg_17() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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"), + ] + + +def _seg_18() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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", "ỏ"), + ] + + +def _seg_19() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "ự"), + (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", "ὕ"), + ] + + +def _seg_20() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "ἇι"), + (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, "M", " ̓"), + (0x1FBE, "M", "ι"), + (0x1FBF, "M", " ̓"), + (0x1FC0, "M", " ͂"), + (0x1FC1, "M", " ̈͂"), + (0x1FC2, "M", "ὴι"), + (0x1FC3, "M", "ηι"), + (0x1FC4, "M", "ήι"), + (0x1FC5, "X"), + (0x1FC6, "V"), + (0x1FC7, "M", "ῆι"), + (0x1FC8, "M", "ὲ"), + (0x1FC9, "M", "έ"), + (0x1FCA, "M", "ὴ"), + ] + + +def _seg_21() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1FCB, "M", "ή"), + (0x1FCC, "M", "ηι"), + (0x1FCD, "M", " ̓̀"), + (0x1FCE, "M", " ̓́"), + (0x1FCF, "M", " ̓͂"), + (0x1FD0, "V"), + (0x1FD3, "M", "ΐ"), + (0x1FD4, "X"), + (0x1FD6, "V"), + (0x1FD8, "M", "ῐ"), + (0x1FD9, "M", "ῑ"), + (0x1FDA, "M", "ὶ"), + (0x1FDB, "M", "ί"), + (0x1FDC, "X"), + (0x1FDD, "M", " ̔̀"), + (0x1FDE, "M", " ̔́"), + (0x1FDF, "M", " ̔͂"), + (0x1FE0, "V"), + (0x1FE3, "M", "ΰ"), + (0x1FE4, "V"), + (0x1FE8, "M", "ῠ"), + (0x1FE9, "M", "ῡ"), + (0x1FEA, "M", "ὺ"), + (0x1FEB, "M", "ύ"), + (0x1FEC, "M", "ῥ"), + (0x1FED, "M", " ̈̀"), + (0x1FEE, "M", " ̈́"), + (0x1FEF, "M", "`"), + (0x1FF0, "X"), + (0x1FF2, "M", "ὼι"), + (0x1FF3, "M", "ωι"), + (0x1FF4, "M", "ώι"), + (0x1FF5, "X"), + (0x1FF6, "V"), + (0x1FF7, "M", "ῶι"), + (0x1FF8, "M", "ὸ"), + (0x1FF9, "M", "ό"), + (0x1FFA, "M", "ὼ"), + (0x1FFB, "M", "ώ"), + (0x1FFC, "M", "ωι"), + (0x1FFD, "M", " ́"), + (0x1FFE, "M", " ̔"), + (0x1FFF, "X"), + (0x2000, "M", " "), + (0x200B, "I"), + (0x200C, "D", ""), + (0x200E, "X"), + (0x2010, "V"), + (0x2011, "M", "‐"), + (0x2012, "V"), + (0x2017, "M", " ̳"), + (0x2018, "V"), + (0x2024, "X"), + (0x2027, "V"), + (0x2028, "X"), + (0x202F, "M", " "), + (0x2030, "V"), + (0x2033, "M", "′′"), + (0x2034, "M", "′′′"), + (0x2035, "V"), + (0x2036, "M", "‵‵"), + (0x2037, "M", "‵‵‵"), + (0x2038, "V"), + (0x203C, "M", "!!"), + (0x203D, "V"), + (0x203E, "M", " ̅"), + (0x203F, "V"), + (0x2047, "M", "??"), + (0x2048, "M", "?!"), + (0x2049, "M", "!?"), + (0x204A, "V"), + (0x2057, "M", "′′′′"), + (0x2058, "V"), + (0x205F, "M", " "), + (0x2060, "I"), + (0x2065, "X"), + (0x206A, "I"), + (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, "M", "+"), + (0x207B, "M", "−"), + (0x207C, "M", "="), + (0x207D, "M", "("), + (0x207E, "M", ")"), + (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"), + ] + + +def _seg_22() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2088, "M", "8"), + (0x2089, "M", "9"), + (0x208A, "M", "+"), + (0x208B, "M", "−"), + (0x208C, "M", "="), + (0x208D, "M", "("), + (0x208E, "M", ")"), + (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, "M", "a/c"), + (0x2101, "M", "a/s"), + (0x2102, "M", "c"), + (0x2103, "M", "°c"), + (0x2104, "V"), + (0x2105, "M", "c/o"), + (0x2106, "M", "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, "M", "ⅎ"), + (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"), + ] + + +def _seg_23() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (0x217D, "M", "c"), + (0x217E, "M", "d"), + (0x217F, "M", "m"), + (0x2180, "V"), + (0x2183, "M", "ↄ"), + (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"), + (0x242A, "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, "M", "(1)"), + (0x2475, "M", "(2)"), + (0x2476, "M", "(3)"), + (0x2477, "M", "(4)"), + (0x2478, "M", "(5)"), + (0x2479, "M", "(6)"), + (0x247A, "M", "(7)"), + (0x247B, "M", "(8)"), + (0x247C, "M", "(9)"), + (0x247D, "M", "(10)"), + (0x247E, "M", "(11)"), + (0x247F, "M", "(12)"), + (0x2480, "M", "(13)"), + (0x2481, "M", "(14)"), + (0x2482, "M", "(15)"), + (0x2483, "M", "(16)"), + (0x2484, "M", "(17)"), + (0x2485, "M", "(18)"), + (0x2486, "M", "(19)"), + (0x2487, "M", "(20)"), + (0x2488, "X"), + (0x249C, "M", "(a)"), + (0x249D, "M", "(b)"), + (0x249E, "M", "(c)"), + (0x249F, "M", "(d)"), + ] + + +def _seg_24() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x24A0, "M", "(e)"), + (0x24A1, "M", "(f)"), + (0x24A2, "M", "(g)"), + (0x24A3, "M", "(h)"), + (0x24A4, "M", "(i)"), + (0x24A5, "M", "(j)"), + (0x24A6, "M", "(k)"), + (0x24A7, "M", "(l)"), + (0x24A8, "M", "(m)"), + (0x24A9, "M", "(n)"), + (0x24AA, "M", "(o)"), + (0x24AB, "M", "(p)"), + (0x24AC, "M", "(q)"), + (0x24AD, "M", "(r)"), + (0x24AE, "M", "(s)"), + (0x24AF, "M", "(t)"), + (0x24B0, "M", "(u)"), + (0x24B1, "M", "(v)"), + (0x24B2, "M", "(w)"), + (0x24B3, "M", "(x)"), + (0x24B4, "M", "(y)"), + (0x24B5, "M", "(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"), + (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, "M", "::="), + (0x2A75, "M", "=="), + (0x2A76, "M", "==="), + (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", "ⰻ"), + ] + + +def _seg_25() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "ⱜ"), + (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"), + ] + + +def _seg_26() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "ⳇ"), + (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"), + ] + + +def _seg_27() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "卩"), + (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", "牛"), + ] + + +def _seg_28() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "而"), + (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", "鬲"), + ] + + +def _seg_29() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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, "M", " "), + (0x3001, "V"), + (0x3002, "M", "."), + (0x3003, "V"), + (0x3036, "M", "〒"), + (0x3037, "V"), + (0x3038, "M", "十"), + (0x3039, "M", "卄"), + (0x303A, "M", "卅"), + (0x303B, "V"), + (0x3040, "X"), + (0x3041, "V"), + (0x3097, "X"), + (0x3099, "V"), + (0x309B, "M", " ゙"), + (0x309C, "M", " ゚"), + (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, "I"), + (0x3165, "M", "ᄔ"), + (0x3166, "M", "ᄕ"), + (0x3167, "M", "ᇇ"), + ] + + +def _seg_30() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "ᆅ"), + (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"), + (0x31E6, "X"), + (0x31F0, "V"), + (0x3200, "M", "(ᄀ)"), + (0x3201, "M", "(ᄂ)"), + (0x3202, "M", "(ᄃ)"), + (0x3203, "M", "(ᄅ)"), + (0x3204, "M", "(ᄆ)"), + (0x3205, "M", "(ᄇ)"), + (0x3206, "M", "(ᄉ)"), + (0x3207, "M", "(ᄋ)"), + (0x3208, "M", "(ᄌ)"), + (0x3209, "M", "(ᄎ)"), + (0x320A, "M", "(ᄏ)"), + (0x320B, "M", "(ᄐ)"), + (0x320C, "M", "(ᄑ)"), + (0x320D, "M", "(ᄒ)"), + (0x320E, "M", "(가)"), + (0x320F, "M", "(나)"), + (0x3210, "M", "(다)"), + (0x3211, "M", "(라)"), + (0x3212, "M", "(마)"), + (0x3213, "M", "(바)"), + (0x3214, "M", "(사)"), + (0x3215, "M", "(아)"), + (0x3216, "M", "(자)"), + (0x3217, "M", "(차)"), + (0x3218, "M", "(카)"), + (0x3219, "M", "(타)"), + (0x321A, "M", "(파)"), + (0x321B, "M", "(하)"), + (0x321C, "M", "(주)"), + (0x321D, "M", "(오전)"), + (0x321E, "M", "(오후)"), + (0x321F, "X"), + (0x3220, "M", "(一)"), + (0x3221, "M", "(二)"), + (0x3222, "M", "(三)"), + (0x3223, "M", "(四)"), + (0x3224, "M", "(五)"), + (0x3225, "M", "(六)"), + (0x3226, "M", "(七)"), + (0x3227, "M", "(八)"), + (0x3228, "M", "(九)"), + (0x3229, "M", "(十)"), + ] + + +def _seg_31() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x322A, "M", "(月)"), + (0x322B, "M", "(火)"), + (0x322C, "M", "(水)"), + (0x322D, "M", "(木)"), + (0x322E, "M", "(金)"), + (0x322F, "M", "(土)"), + (0x3230, "M", "(日)"), + (0x3231, "M", "(株)"), + (0x3232, "M", "(有)"), + (0x3233, "M", "(社)"), + (0x3234, "M", "(名)"), + (0x3235, "M", "(特)"), + (0x3236, "M", "(財)"), + (0x3237, "M", "(祝)"), + (0x3238, "M", "(労)"), + (0x3239, "M", "(代)"), + (0x323A, "M", "(呼)"), + (0x323B, "M", "(学)"), + (0x323C, "M", "(監)"), + (0x323D, "M", "(企)"), + (0x323E, "M", "(資)"), + (0x323F, "M", "(協)"), + (0x3240, "M", "(祭)"), + (0x3241, "M", "(休)"), + (0x3242, "M", "(自)"), + (0x3243, "M", "(至)"), + (0x3244, "M", "問"), + (0x3245, "M", "幼"), + (0x3246, "M", "文"), + (0x3247, "M", "箏"), + (0x3248, "V"), + (0x3250, "M", "pte"), + (0x3251, "M", "21"), + (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", "名"), + ] + + +def _seg_32() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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", "ル"), + ] + + +def _seg_33() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "グラムトン"), + (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点"), + ] + + +def _seg_34() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "大正"), + (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ω"), + ] + + +def _seg_35() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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日"), + (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", "ꙟ"), + ] + + +def _seg_36() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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"), + ] + + +def _seg_37() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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"), + ] + + +def _seg_38() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA7C9, "M", "ꟊ"), + (0xA7CA, "V"), + (0xA7CB, "M", "ɤ"), + (0xA7CC, "M", "ꟍ"), + (0xA7CD, "V"), + (0xA7CE, "X"), + (0xA7D0, "M", "ꟑ"), + (0xA7D1, "V"), + (0xA7D2, "X"), + (0xA7D3, "V"), + (0xA7D4, "X"), + (0xA7D5, "V"), + (0xA7D6, "M", "ꟗ"), + (0xA7D7, "V"), + (0xA7D8, "M", "ꟙ"), + (0xA7D9, "V"), + (0xA7DA, "M", "ꟛ"), + (0xA7DB, "V"), + (0xA7DC, "M", "ƛ"), + (0xA7DD, "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"), + (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", "Ꮇ"), + ] + + +def _seg_39() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "Ꮮ"), + (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", "濫"), + ] + + +def _seg_40() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "雷"), + (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", "閭"), + ] + + +def _seg_41() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "玲"), + (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", "離"), + ] + + +def _seg_42() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "晴"), + (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", "禎"), + ] + + +def _seg_43() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "塚"), + (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", "調"), + ] + + +def _seg_44() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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, "M", "+"), + (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", "پ"), + ] + + +def _seg_45() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "ى"), + (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", "قح"), + ] + + +def _seg_46() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "يي"), + (0xFC5B, "M", "ذٰ"), + (0xFC5C, "M", "رٰ"), + (0xFC5D, "M", "ىٰ"), + (0xFC5E, "M", " ٌّ"), + (0xFC5F, "M", " ٍّ"), + (0xFC60, "M", " َّ"), + (0xFC61, "M", " ُّ"), + (0xFC62, "M", " ِّ"), + (0xFC63, "M", " ّٰ"), + (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", "ئج"), + ] + + +def _seg_47() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "فج"), + (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", "سى"), + ] + + +def _seg_48() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "صي"), + (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", "فخم"), + ] + + +def _seg_49() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "شحي"), + (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, "M", "صلى الله عليه وسلم"), + (0xFDFB, "M", "جل جلاله"), + (0xFDFC, "M", "ریال"), + (0xFDFD, "V"), + (0xFE00, "I"), + (0xFE10, "M", ","), + (0xFE11, "M", "、"), + (0xFE12, "X"), + (0xFE13, "M", ":"), + (0xFE14, "M", ";"), + (0xFE15, "M", "!"), + (0xFE16, "M", "?"), + (0xFE17, "M", "〖"), + (0xFE18, "M", "〗"), + (0xFE19, "X"), + (0xFE20, "V"), + (0xFE30, "X"), + (0xFE31, "M", "—"), + (0xFE32, "M", "–"), + ] + + +def _seg_50() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFE33, "M", "_"), + (0xFE35, "M", "("), + (0xFE36, "M", ")"), + (0xFE37, "M", "{"), + (0xFE38, "M", "}"), + (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, "M", "["), + (0xFE48, "M", "]"), + (0xFE49, "M", " ̅"), + (0xFE4D, "M", "_"), + (0xFE50, "M", ","), + (0xFE51, "M", "、"), + (0xFE52, "X"), + (0xFE54, "M", ";"), + (0xFE55, "M", ":"), + (0xFE56, "M", "?"), + (0xFE57, "M", "!"), + (0xFE58, "M", "—"), + (0xFE59, "M", "("), + (0xFE5A, "M", ")"), + (0xFE5B, "M", "{"), + (0xFE5C, "M", "}"), + (0xFE5D, "M", "〔"), + (0xFE5E, "M", "〕"), + (0xFE5F, "M", "#"), + (0xFE60, "M", "&"), + (0xFE61, "M", "*"), + (0xFE62, "M", "+"), + (0xFE63, "M", "-"), + (0xFE64, "M", "<"), + (0xFE65, "M", ">"), + (0xFE66, "M", "="), + (0xFE67, "X"), + (0xFE68, "M", "\\"), + (0xFE69, "M", "$"), + (0xFE6A, "M", "%"), + (0xFE6B, "M", "@"), + (0xFE6C, "X"), + (0xFE70, "M", " ً"), + (0xFE71, "M", "ـً"), + (0xFE72, "M", " ٌ"), + (0xFE73, "V"), + (0xFE74, "M", " ٍ"), + (0xFE75, "X"), + (0xFE76, "M", " َ"), + (0xFE77, "M", "ـَ"), + (0xFE78, "M", " ُ"), + (0xFE79, "M", "ـُ"), + (0xFE7A, "M", " ِ"), + (0xFE7B, "M", "ـِ"), + (0xFE7C, "M", " ّ"), + (0xFE7D, "M", "ـّ"), + (0xFE7E, "M", " ْ"), + (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", "و"), + ] + + +def _seg_51() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFEEF, "M", "ى"), + (0xFEF1, "M", "ي"), + (0xFEF5, "M", "لآ"), + (0xFEF7, "M", "لأ"), + (0xFEF9, "M", "لإ"), + (0xFEFB, "M", "لا"), + (0xFEFD, "X"), + (0xFEFF, "I"), + (0xFF00, "X"), + (0xFF01, "M", "!"), + (0xFF02, "M", '"'), + (0xFF03, "M", "#"), + (0xFF04, "M", "$"), + (0xFF05, "M", "%"), + (0xFF06, "M", "&"), + (0xFF07, "M", "'"), + (0xFF08, "M", "("), + (0xFF09, "M", ")"), + (0xFF0A, "M", "*"), + (0xFF0B, "M", "+"), + (0xFF0C, "M", ","), + (0xFF0D, "M", "-"), + (0xFF0E, "M", "."), + (0xFF0F, "M", "/"), + (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, "M", ":"), + (0xFF1B, "M", ";"), + (0xFF1C, "M", "<"), + (0xFF1D, "M", "="), + (0xFF1E, "M", ">"), + (0xFF1F, "M", "?"), + (0xFF20, "M", "@"), + (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, "M", "["), + (0xFF3C, "M", "\\"), + (0xFF3D, "M", "]"), + (0xFF3E, "M", "^"), + (0xFF3F, "M", "_"), + (0xFF40, "M", "`"), + (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, "M", "{"), + ] + + +def _seg_52() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFF5C, "M", "|"), + (0xFF5D, "M", "}"), + (0xFF5E, "M", "~"), + (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", "ツ"), + (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, "I"), + (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"), + ] + + +def _seg_53() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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, "M", " ̄"), + (0xFFE4, "M", "¦"), + (0xFFE5, "M", "¥"), + (0xFFE6, "M", "₩"), + (0xFFE7, "X"), + (0xFFE8, "M", "│"), + (0xFFE9, "M", "←"), + (0xFFEA, "M", "↑"), + (0xFFEB, "M", "→"), + (0xFFEC, "M", "↓"), + (0xFFED, "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", "𐐶"), + ] + + +def _seg_54() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "𐓡"), + (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", "𐖱"), + ] + + +def _seg_55() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (0x105C0, "V"), + (0x105F4, "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", "ɗ"), + (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"), + ] + + +def _seg_56() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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", "𐳭"), + ] + + +def _seg_57() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x10CAE, "M", "𐳮"), + (0x10CAF, "M", "𐳯"), + (0x10CB0, "M", "𐳰"), + (0x10CB1, "M", "𐳱"), + (0x10CB2, "M", "𐳲"), + (0x10CB3, "X"), + (0x10CC0, "V"), + (0x10CF3, "X"), + (0x10CFA, "V"), + (0x10D28, "X"), + (0x10D30, "V"), + (0x10D3A, "X"), + (0x10D40, "V"), + (0x10D50, "M", "𐵰"), + (0x10D51, "M", "𐵱"), + (0x10D52, "M", "𐵲"), + (0x10D53, "M", "𐵳"), + (0x10D54, "M", "𐵴"), + (0x10D55, "M", "𐵵"), + (0x10D56, "M", "𐵶"), + (0x10D57, "M", "𐵷"), + (0x10D58, "M", "𐵸"), + (0x10D59, "M", "𐵹"), + (0x10D5A, "M", "𐵺"), + (0x10D5B, "M", "𐵻"), + (0x10D5C, "M", "𐵼"), + (0x10D5D, "M", "𐵽"), + (0x10D5E, "M", "𐵾"), + (0x10D5F, "M", "𐵿"), + (0x10D60, "M", "𐶀"), + (0x10D61, "M", "𐶁"), + (0x10D62, "M", "𐶂"), + (0x10D63, "M", "𐶃"), + (0x10D64, "M", "𐶄"), + (0x10D65, "M", "𐶅"), + (0x10D66, "X"), + (0x10D69, "V"), + (0x10D86, "X"), + (0x10D8E, "V"), + (0x10D90, "X"), + (0x10E60, "V"), + (0x10E7F, "X"), + (0x10E80, "V"), + (0x10EAA, "X"), + (0x10EAB, "V"), + (0x10EAE, "X"), + (0x10EB0, "V"), + (0x10EB2, "X"), + (0x10EC2, "V"), + (0x10EC5, "X"), + (0x10EFC, "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"), + (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"), + ] + + +def _seg_58() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (0x11380, "V"), + (0x1138A, "X"), + (0x1138B, "V"), + (0x1138C, "X"), + (0x1138E, "V"), + (0x1138F, "X"), + (0x11390, "V"), + (0x113B6, "X"), + (0x113B7, "V"), + (0x113C1, "X"), + (0x113C2, "V"), + (0x113C3, "X"), + (0x113C5, "V"), + (0x113C6, "X"), + (0x113C7, "V"), + (0x113CB, "X"), + (0x113CC, "V"), + (0x113D6, "X"), + (0x113D7, "V"), + (0x113D9, "X"), + (0x113E1, "V"), + (0x113E3, "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"), + (0x116D0, "V"), + (0x116E4, "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", "𑣊"), + (0x118AB, "M", "𑣋"), + (0x118AC, "M", "𑣌"), + (0x118AD, "M", "𑣍"), + (0x118AE, "M", "𑣎"), + (0x118AF, "M", "𑣏"), + ] + + +def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (0x11BC0, "V"), + (0x11BE2, "X"), + (0x11BF0, "V"), + (0x11BFA, "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"), + (0x11F5B, "X"), + ] + + +def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (0x13460, "V"), + (0x143FB, "X"), + (0x14400, "V"), + (0x14647, "X"), + (0x16100, "V"), + (0x1613A, "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"), + (0x16D40, "V"), + (0x16D7A, "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"), + (0x18CFF, "V"), + (0x18D09, "X"), + ] + + +def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1AFF0, "V"), + (0x1AFF4, "X"), + (0x1AFF5, "V"), + (0x1AFFC, "X"), + (0x1AFFD, "V"), + (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"), + (0x1CC00, "V"), + (0x1CCD6, "M", "a"), + (0x1CCD7, "M", "b"), + (0x1CCD8, "M", "c"), + (0x1CCD9, "M", "d"), + (0x1CCDA, "M", "e"), + (0x1CCDB, "M", "f"), + (0x1CCDC, "M", "g"), + (0x1CCDD, "M", "h"), + (0x1CCDE, "M", "i"), + (0x1CCDF, "M", "j"), + (0x1CCE0, "M", "k"), + (0x1CCE1, "M", "l"), + (0x1CCE2, "M", "m"), + (0x1CCE3, "M", "n"), + (0x1CCE4, "M", "o"), + (0x1CCE5, "M", "p"), + (0x1CCE6, "M", "q"), + (0x1CCE7, "M", "r"), + (0x1CCE8, "M", "s"), + (0x1CCE9, "M", "t"), + (0x1CCEA, "M", "u"), + (0x1CCEB, "M", "v"), + (0x1CCEC, "M", "w"), + (0x1CCED, "M", "x"), + (0x1CCEE, "M", "y"), + (0x1CCEF, "M", "z"), + (0x1CCF0, "M", "0"), + (0x1CCF1, "M", "1"), + (0x1CCF2, "M", "2"), + (0x1CCF3, "M", "3"), + (0x1CCF4, "M", "4"), + (0x1CCF5, "M", "5"), + (0x1CCF6, "M", "6"), + (0x1CCF7, "M", "7"), + (0x1CCF8, "M", "8"), + (0x1CCF9, "M", "9"), + (0x1CCFA, "X"), + (0x1CD00, "V"), + (0x1CEB4, "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, "I"), + (0x1D17B, "V"), + (0x1D1BB, "M", "𝆹𝅥"), + (0x1D1BC, "M", "𝆺𝅥"), + (0x1D1BD, "M", "𝆹𝅥𝅮"), + (0x1D1BE, "M", "𝆺𝅥𝅮"), + (0x1D1BF, "M", "𝆹𝅥𝅯"), + (0x1D1C0, "M", "𝆺𝅥𝅯"), + (0x1D1C1, "V"), + (0x1D1EB, "X"), + (0x1D200, "V"), + (0x1D246, "X"), + ] + + +def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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"), + ] + + +def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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"), + ] + + +def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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"), + ] + + +def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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"), + ] + + +def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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"), + ] + + +def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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"), + ] + + +def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (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", "σ"), + ] + + +def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "η"), + (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", "ε"), + ] + + +def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "ω"), + (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", "χ"), + ] + + +def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "κ"), + (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"), + ] + + +def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "ж"), + (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", "ұ"), + ] + + +def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (0x1E5D0, "V"), + (0x1E5FB, "X"), + (0x1E5FF, "V"), + (0x1E600, "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", "𞤯"), + (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", "ش"), + ] + + +def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "س"), + (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", "د"), + ] + + +def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "ذ"), + (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, "M", "0,"), + (0x1F102, "M", "1,"), + (0x1F103, "M", "2,"), + (0x1F104, "M", "3,"), + (0x1F105, "M", "4,"), + (0x1F106, "M", "5,"), + (0x1F107, "M", "6,"), + (0x1F108, "M", "7,"), + (0x1F109, "M", "8,"), + (0x1F10A, "M", "9,"), + (0x1F10B, "V"), + (0x1F110, "M", "(a)"), + (0x1F111, "M", "(b)"), + (0x1F112, "M", "(c)"), + (0x1F113, "M", "(d)"), + (0x1F114, "M", "(e)"), + (0x1F115, "M", "(f)"), + (0x1F116, "M", "(g)"), + (0x1F117, "M", "(h)"), + (0x1F118, "M", "(i)"), + (0x1F119, "M", "(j)"), + (0x1F11A, "M", "(k)"), + (0x1F11B, "M", "(l)"), + (0x1F11C, "M", "(m)"), + (0x1F11D, "M", "(n)"), + (0x1F11E, "M", "(o)"), + (0x1F11F, "M", "(p)"), + (0x1F120, "M", "(q)"), + (0x1F121, "M", "(r)"), + (0x1F122, "M", "(s)"), + (0x1F123, "M", "(t)"), + (0x1F124, "M", "(u)"), + (0x1F125, "M", "(v)"), + ] + + +def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1F126, "M", "(w)"), + (0x1F127, "M", "(x)"), + (0x1F128, "M", "(y)"), + (0x1F129, "M", "(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"), + (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"), + ] + + +def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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"), + (0x1F8BC, "X"), + (0x1F8C0, "V"), + (0x1F8C2, "X"), + (0x1F900, "V"), + (0x1FA54, "X"), + (0x1FA60, "V"), + (0x1FA6E, "X"), + (0x1FA70, "V"), + (0x1FA7D, "X"), + (0x1FA80, "V"), + (0x1FA8A, "X"), + (0x1FA8F, "V"), + (0x1FAC7, "X"), + (0x1FACE, "V"), + (0x1FADD, "X"), + (0x1FADF, "V"), + (0x1FAEA, "X"), + (0x1FAF0, "V"), + (0x1FAF9, "X"), + (0x1FB00, "V"), + (0x1FB93, "X"), + (0x1FB94, "V"), + (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", "免"), + ] + + +def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "咢"), + (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, "M", "㛼"), + (0x2F869, "M", "嬈"), + (0x2F86A, "M", "嬾"), + (0x2F86C, "M", "𡧈"), + (0x2F86D, "M", "寃"), + (0x2F86E, "M", "寘"), + (0x2F86F, "M", "寧"), + (0x2F870, "M", "寳"), + (0x2F871, "M", "𡬘"), + (0x2F872, "M", "寿"), + (0x2F873, "M", "将"), + (0x2F874, "M", "当"), + (0x2F875, "M", "尢"), + (0x2F876, "M", "㞁"), + ] + + +def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "慎"), + (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", "杓"), + ] + + +def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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", "滇"), + (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, "M", "𤎫"), + (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", "𥃳"), + ] + + +def _seg_81() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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, "M", "竮"), + (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", "𦉇"), + (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", "䔫"), + ] + + +def _seg_82() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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, "M", "䗗"), + (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", "起"), + (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", "鳽"), + ] + + +def _seg_83() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (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() + + _seg_2() + + _seg_3() + + _seg_4() + + _seg_5() + + _seg_6() + + _seg_7() + + _seg_8() + + _seg_9() + + _seg_10() + + _seg_11() + + _seg_12() + + _seg_13() + + _seg_14() + + _seg_15() + + _seg_16() + + _seg_17() + + _seg_18() + + _seg_19() + + _seg_20() + + _seg_21() + + _seg_22() + + _seg_23() + + _seg_24() + + _seg_25() + + _seg_26() + + _seg_27() + + _seg_28() + + _seg_29() + + _seg_30() + + _seg_31() + + _seg_32() + + _seg_33() + + _seg_34() + + _seg_35() + + _seg_36() + + _seg_37() + + _seg_38() + + _seg_39() + + _seg_40() + + _seg_41() + + _seg_42() + + _seg_43() + + _seg_44() + + _seg_45() + + _seg_46() + + _seg_47() + + _seg_48() + + _seg_49() + + _seg_50() + + _seg_51() + + _seg_52() + + _seg_53() + + _seg_54() + + _seg_55() + + _seg_56() + + _seg_57() + + _seg_58() + + _seg_59() + + _seg_60() + + _seg_61() + + _seg_62() + + _seg_63() + + _seg_64() + + _seg_65() + + _seg_66() + + _seg_67() + + _seg_68() + + _seg_69() + + _seg_70() + + _seg_71() + + _seg_72() + + _seg_73() + + _seg_74() + + _seg_75() + + _seg_76() + + _seg_77() + + _seg_78() + + _seg_79() + + _seg_80() + + _seg_81() + + _seg_82() + + _seg_83() +) # type: Tuple[Union[Tuple[int, str], Tuple[int, str, str]], ...] diff --git a/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/INSTALLER b/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/METADATA b/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/METADATA new file mode 100644 index 0000000..bb82e71 --- /dev/null +++ b/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/METADATA @@ -0,0 +1,149 @@ +Metadata-Version: 2.4 +Name: multidict +Version: 6.7.1 +Summary: multidict implementation +Home-page: https://github.com/aio-libs/multidict +Author: Andrew Svetlov +Author-email: andrew.svetlov@gmail.com +License: Apache License 2.0 +Project-URL: Chat: Matrix, https://matrix.to/#/#aio-libs:matrix.org +Project-URL: Chat: Matrix Space, https://matrix.to/#/#aio-libs-space:matrix.org +Project-URL: CI: GitHub, https://github.com/aio-libs/multidict/actions +Project-URL: Code of Conduct, https://github.com/aio-libs/.github/blob/master/CODE_OF_CONDUCT.md +Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/multidict +Project-URL: Docs: Changelog, https://multidict.aio-libs.org/en/latest/changes/ +Project-URL: Docs: RTD, https://multidict.aio-libs.org +Project-URL: GitHub: issues, https://github.com/aio-libs/multidict/issues +Project-URL: GitHub: repo, https://github.com/aio-libs/multidict +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Programming Language :: Python :: 3.14 +Requires-Python: >=3.9 +Description-Content-Type: text/x-rst +License-File: LICENSE +Requires-Dist: typing-extensions>=4.1.0; python_version < "3.11" +Dynamic: license-file + +========= +multidict +========= + +.. image:: https://github.com/aio-libs/multidict/actions/workflows/ci-cd.yml/badge.svg + :target: https://github.com/aio-libs/multidict/actions + :alt: GitHub status for master branch + +.. image:: https://codecov.io/gh/aio-libs/multidict/branch/master/graph/badge.svg?flag=pytest + :target: https://codecov.io/gh/aio-libs/multidict?flags[]=pytest + :alt: Coverage metrics + +.. image:: https://img.shields.io/pypi/v/multidict.svg + :target: https://pypi.org/project/multidict + :alt: PyPI + +.. image:: https://readthedocs.org/projects/multidict/badge/?version=latest + :target: https://multidict.aio-libs.org + :alt: Read The Docs build status badge + +.. image:: https://img.shields.io/endpoint?url=https://codspeed.io/badge.json + :target: https://codspeed.io/aio-libs/multidict + :alt: CodSpeed + +.. image:: https://img.shields.io/pypi/pyversions/multidict.svg + :target: https://pypi.org/project/multidict + :alt: Python versions + +.. image:: https://img.shields.io/matrix/aio-libs:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat + :target: https://matrix.to/#/%23aio-libs:matrix.org + :alt: Matrix Room — #aio-libs:matrix.org + +.. image:: https://img.shields.io/matrix/aio-libs-space:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs-space%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat + :target: https://matrix.to/#/%23aio-libs-space:matrix.org + :alt: Matrix Space — #aio-libs-space:matrix.org + +Multidict is dict-like collection of *key-value pairs* where key +might occur more than once in the container. + +Introduction +------------ + +*HTTP Headers* and *URL query string* require specific data structure: +*multidict*. It behaves mostly like a regular ``dict`` but it may have +several *values* for the same *key* and *preserves insertion ordering*. + +The *key* is ``str`` (or ``istr`` for case-insensitive dictionaries). + +``multidict`` has four multidict classes: +``MultiDict``, ``MultiDictProxy``, ``CIMultiDict`` +and ``CIMultiDictProxy``. + +Immutable proxies (``MultiDictProxy`` and +``CIMultiDictProxy``) provide a dynamic view for the +proxied multidict, the view reflects underlying collection changes. They +implement the ``collections.abc.Mapping`` interface. + +Regular mutable (``MultiDict`` and ``CIMultiDict``) classes +implement ``collections.abc.MutableMapping`` and allows them to change +their own content. + + +*Case insensitive* (``CIMultiDict`` and +``CIMultiDictProxy``) assume the *keys* are case +insensitive, e.g.:: + + >>> dct = CIMultiDict(key='val') + >>> 'Key' in dct + True + >>> dct['Key'] + 'val' + +*Keys* should be ``str`` or ``istr`` instances. + +The library has optional C Extensions for speed. + + +License +------- + +Apache 2 + +Library Installation +-------------------- + +.. code-block:: bash + + $ pip install multidict + +The library is Python 3 only! + +PyPI contains binary wheels for Linux, Windows and MacOS. If you want to install +``multidict`` on another operating system (or *Alpine Linux* inside a Docker) the +tarball will be used to compile the library from source. It requires a C compiler and +Python headers to be installed. + +To skip the compilation, please use the `MULTIDICT_NO_EXTENSIONS` environment variable, +e.g.: + +.. code-block:: bash + + $ MULTIDICT_NO_EXTENSIONS=1 pip install multidict + +Please note, the pure Python (uncompiled) version is about 20-50 times slower depending on +the usage scenario!!! + +For extension development, set the ``MULTIDICT_DEBUG_BUILD`` environment variable to compile +the extensions in debug mode: + +.. code-block:: console + + $ MULTIDICT_DEBUG_BUILD=1 pip install multidict + +Changelog +--------- +See `RTD page `_. diff --git a/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/RECORD b/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/RECORD new file mode 100644 index 0000000..ab69283 --- /dev/null +++ b/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/RECORD @@ -0,0 +1,16 @@ +multidict-6.7.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +multidict-6.7.1.dist-info/METADATA,sha256=SRP9quk2ownCm4m5jC2-vSNyA_snq55orl5OwXujAk8,5321 +multidict-6.7.1.dist-info/RECORD,, +multidict-6.7.1.dist-info/WHEEL,sha256=4yNgi9-maKfC_ROhWPN87DmWE_u5IcFuE670Rxa5uRI,113 +multidict-6.7.1.dist-info/licenses/LICENSE,sha256=k9Ealo4vDzY3PECBH_bSDhc_WMPKtYhM1mF7v9eVSSo,611 +multidict-6.7.1.dist-info/top_level.txt,sha256=-euDElkk5_qkmfIJ7WiqCab02ZlSFZWynejKg59qZQQ,10 +multidict/__init__.py,sha256=DM56VUoHEyx7pKsLrT9EEeIjTlgWmPyQQuC5juLzbhY,1228 +multidict/__pycache__/__init__.cpython-312.pyc,, +multidict/__pycache__/_abc.cpython-312.pyc,, +multidict/__pycache__/_compat.cpython-312.pyc,, +multidict/__pycache__/_multidict_py.cpython-312.pyc,, +multidict/_abc.py,sha256=e_0JDJi7E6LWS0A3gUJ17SkgDLlmg8ffjfylTu_vboc,2402 +multidict/_compat.py,sha256=TcRjCStk2iIY1_DwDNj8kNpJRQ9rtLj92Xvk1z2G_ak,422 +multidict/_multidict.cpython-312-x86_64-linux-musl.so,sha256=kWVDdPadAhT_NAQvi3zmbxyS8OyMrOICKPIC3VH8on4,608848 +multidict/_multidict_py.py,sha256=VGQ58P7VOd6lRf3WVAinb62aD16DPdAWRt68qmiJMXE,39955 +multidict/py.typed,sha256=e9bmbH3UFxsabQrnNFPG9qxIXztwbcM6IKDYnvZwprY,15 diff --git a/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/WHEEL b/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/WHEEL new file mode 100644 index 0000000..d158b55 --- /dev/null +++ b/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (80.10.2) +Root-Is-Purelib: false +Tag: cp312-cp312-musllinux_1_2_x86_64 + diff --git a/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/licenses/LICENSE b/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/licenses/LICENSE new file mode 100644 index 0000000..8727172 --- /dev/null +++ b/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/licenses/LICENSE @@ -0,0 +1,13 @@ + Copyright 2016 Andrew Svetlov and aio-libs contributors + + 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. diff --git a/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/top_level.txt b/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/top_level.txt new file mode 100644 index 0000000..afcecdf --- /dev/null +++ b/env/lib/python3.12/site-packages/multidict-6.7.1.dist-info/top_level.txt @@ -0,0 +1 @@ +multidict diff --git a/env/lib/python3.12/site-packages/multidict/__init__.py b/env/lib/python3.12/site-packages/multidict/__init__.py new file mode 100644 index 0000000..e3db9e1 --- /dev/null +++ b/env/lib/python3.12/site-packages/multidict/__init__.py @@ -0,0 +1,60 @@ +""" +Multidict implementation. + +HTTP Headers and URL query string require specific data structure: +multidict. It behaves mostly like a dict but it can have +several values for the same key. +""" + +from typing import TYPE_CHECKING + +from ._abc import MultiMapping, MutableMultiMapping +from ._compat import USE_EXTENSIONS + +__all__ = ( + "CIMultiDict", + "CIMultiDictProxy", + "MultiDict", + "MultiDictProxy", + "MultiMapping", + "MutableMultiMapping", + "getversion", + "istr", + "upstr", +) + +__version__ = "6.7.1" + + +if TYPE_CHECKING or not USE_EXTENSIONS: + from ._multidict_py import ( + CIMultiDict, + CIMultiDictProxy, + MultiDict, + MultiDictProxy, + getversion, + istr, + ) +else: + from collections.abc import ItemsView, KeysView, ValuesView + + from ._multidict import ( + CIMultiDict, + CIMultiDictProxy, + MultiDict, + MultiDictProxy, + _ItemsView, + _KeysView, + _ValuesView, + getversion, + istr, + ) + + MultiMapping.register(MultiDictProxy) + MutableMultiMapping.register(MultiDict) + KeysView.register(_KeysView) + ItemsView.register(_ItemsView) + ValuesView.register(_ValuesView) + + +upstr = istr diff --git a/env/lib/python3.12/site-packages/multidict/_abc.py b/env/lib/python3.12/site-packages/multidict/_abc.py new file mode 100644 index 0000000..54253e9 --- /dev/null +++ b/env/lib/python3.12/site-packages/multidict/_abc.py @@ -0,0 +1,73 @@ +import abc +from collections.abc import Iterable, Mapping, MutableMapping +from typing import TYPE_CHECKING, Protocol, TypeVar, Union, overload + +if TYPE_CHECKING: + from ._multidict_py import istr +else: + istr = str + +_V = TypeVar("_V") +_V_co = TypeVar("_V_co", covariant=True) +_T = TypeVar("_T") + + +class SupportsKeys(Protocol[_V_co]): + def keys(self) -> Iterable[str]: ... + def __getitem__(self, key: str, /) -> _V_co: ... + + +class SupportsIKeys(Protocol[_V_co]): + def keys(self) -> Iterable[istr]: ... + def __getitem__(self, key: istr, /) -> _V_co: ... + + +MDArg = Union[SupportsKeys[_V], SupportsIKeys[_V], Iterable[tuple[str, _V]], None] + + +class MultiMapping(Mapping[str, _V_co]): + @overload + def getall(self, key: str) -> list[_V_co]: ... + @overload + def getall(self, key: str, default: _T) -> Union[list[_V_co], _T]: ... + @abc.abstractmethod + def getall(self, key: str, default: _T = ...) -> Union[list[_V_co], _T]: + """Return all values for key.""" + + @overload + def getone(self, key: str) -> _V_co: ... + @overload + def getone(self, key: str, default: _T) -> Union[_V_co, _T]: ... + @abc.abstractmethod + def getone(self, key: str, default: _T = ...) -> Union[_V_co, _T]: + """Return first value for key.""" + + +class MutableMultiMapping(MultiMapping[_V], MutableMapping[str, _V]): + @abc.abstractmethod + def add(self, key: str, value: _V) -> None: + """Add value to list.""" + + @abc.abstractmethod + def extend(self, arg: MDArg[_V] = None, /, **kwargs: _V) -> None: + """Add everything from arg and kwargs to the mapping.""" + + @abc.abstractmethod + def merge(self, arg: MDArg[_V] = None, /, **kwargs: _V) -> None: + """Merge into the mapping, adding non-existing keys.""" + + @overload + def popone(self, key: str) -> _V: ... + @overload + def popone(self, key: str, default: _T) -> Union[_V, _T]: ... + @abc.abstractmethod + def popone(self, key: str, default: _T = ...) -> Union[_V, _T]: + """Remove specified key and return the corresponding value.""" + + @overload + def popall(self, key: str) -> list[_V]: ... + @overload + def popall(self, key: str, default: _T) -> Union[list[_V], _T]: ... + @abc.abstractmethod + def popall(self, key: str, default: _T = ...) -> Union[list[_V], _T]: + """Remove all occurrences of key and return the list of corresponding values.""" diff --git a/env/lib/python3.12/site-packages/multidict/_compat.py b/env/lib/python3.12/site-packages/multidict/_compat.py new file mode 100644 index 0000000..264d327 --- /dev/null +++ b/env/lib/python3.12/site-packages/multidict/_compat.py @@ -0,0 +1,15 @@ +import os +import platform + +NO_EXTENSIONS = bool(os.environ.get("MULTIDICT_NO_EXTENSIONS")) + +PYPY = platform.python_implementation() == "PyPy" + +USE_EXTENSIONS = not NO_EXTENSIONS and not PYPY + +if USE_EXTENSIONS: + try: + from . import _multidict # type: ignore[attr-defined] # noqa: F401 + except ImportError: # pragma: no cover + # FIXME: Refactor for coverage. See #837. + USE_EXTENSIONS = False diff --git a/env/lib/python3.12/site-packages/multidict/_multidict.cpython-312-x86_64-linux-musl.so b/env/lib/python3.12/site-packages/multidict/_multidict.cpython-312-x86_64-linux-musl.so new file mode 100755 index 0000000000000000000000000000000000000000..b75198f040ae36e3772ef01f49209e0716332506 GIT binary patch literal 608848 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%0Av-MjIq!5KJl zCCpG97zn}@FlRuV0<_#7a}Rr-Dnu8DMS6EHCjLU84S<))H=fF^ba^DAclt);uLmY- zzk5lgW{FpMzfVf>J$K)Vc`7Y&T+sz#(OF_Dk6XJMGk1WXI?R(0^4Wr*A`9%*cEi6vsZ$o|38Rg~uLpWkXM=Nz-4qN}<3>^G z#Z*FjQb$6vCw1OIWgF0wI!`;bl=%c9PU=iSOHb;2g2=}pBN2L1=Nq`MLBR`7$(_`B z!m1 zkDinzDSnIhl1k4rF+7V@N|7o7di10Rg(b_)Sc7jH+BCCdARsXvo(y z)X|<0`vX0xy*}^;VvXF zp2~<>uDE9uH#-ZTWJ&rsw2uK=hbBOrD2&vhX%MFYTTDw6Pm1$w9#0e#;>o25T@2Kt zr4UO%!SY;>@?{g#oi2nuc4DGyRQn1sA=}$;LgPkY(%-r#L{8{DO|&#g?u5=L*VW4) zhZ>gH8>iU*o`I&Qk)&4YWAqO+=Ay0PzTeUw8^_K~E5b(AHYSsQU)E)JW zyBJdk*sA?ms8xFq0eyk3+MkDdz$aX^c6Q-Vnv?j8P`|Z*4iZyAAN?}ff5U0a+2ktK zZ<>7*>hGfT=|;B|{}%4cyJNZPoWwlh${8f6U*7sX)RRE+>5-d&J<~#xSy;LWJ==atNVfev5EH$Cwx8Ra8hfn}qWxSgsmV9R|8{X80OBq(^_DY^D@t7HGE{meh=U8X?Wqy(f4ZWG_W39Ef`F5D!dCSq?K2&Ti# zfjCE)xiCv1t`z2Sn0q1qCCs%jTOnQp8L<}LO32r6pM&oA!tD1je;$;m^$_W9Xn~St zRQ86>5zY`fidIgq_~oLf&p}d}$CijU7q$CfIze;*+KzjztR=7So64Su?hi;%PF!|L z67*D&P0x^E4Jia^s}4n>KhU=72#DdJpoi1dCSBb>II-p_pM1QzM)P1kTLf#(P_wLU`^laeVKQ2koQ#HK%n@e8v?q7t$JfQAh39$$ijLmgFk~b-G z$sSN?J>~eDJ+V(yzW;Fc>^gBy70EO5W0?7CHYNuVbqnUM7yC!UybiHRmFrPwv1oF=39PpfN*3lrL3T=Ri zdIUA^Vjvn^iP-PR{|Ze03oO$-j=W1 zV1_{S7be99(+ePGfPC46>TSmSGB~!1gSxH6rffug0Gay$-ve>p%09(((c9Kj`PA@8 zWTl*^mr6P3|3&vC-$zI{a5Cj=U_8&tq^EOSt!Xn6)SZF4q0u+jc0*&8{Yh2!63G>q z);JUm2ugzi1V4czkAntB=E#JmuQ>fxVK9Nv%|yQ_BGYn2^31U!@ zhb~)ROyfMv9G4UK#7ItNK@ZJ@>qgn}D{m5||1s%~Z(9R(Z%mnqPEQY7T8*H6i*w)O zRwRn1V2yh&Z9h7b<-YjnP#W=9hgnm@?LUUd-Ouy==+R*_=|@X?FdYT9-#ga!d#wp* z0dyzwr_M-VJjL)(ulTsIU26>LPUQWO-xugk4XaH;{PM~QpF!bW^26DcNzfbgAA|h4X zi&Wv47!h$*y!n2NWC2&y!DDWNDY&<^kpjn) zNq^xqq}rdT8nS|8I~Zv$qzM=rbaa*9Yny@v&I?=l<;_MMXx(Z5y1JQDch+9y>rP-R z|0r^DB(QZS2s_C`b14DyB~a^55FRLjcM`A?*t!$$QFkI+ceWt#IL&|+j?-voNJ6@!USt%l} z?xYUjMKdB&cdEFu_@}xv-j#;bok_Ux_qub}9(Ctory+G`rE2_B-Ra=!j@RaEC(a97 zcizjR?0-+m&0mNSx#T;Mas|uBU+U}5@2PU>cLtD~E+GHDzPyTa@_{+7Dn|ZH6+UqZ zTF(&m7BWwPjKqYm5wd?zG(q?Q%sPmBh4~8RV~8!n?1Jf7$%q$(ale#V0CAo$HDF$W zSOfIk)5av}8%Q7;9F^WRpQPp8)5pCyunsa3qwk)+f%_WhyQe=Oeghcl#E7;zYWBKc z3>_8KiZ8~{K}0p{P3A!`1ZFbCSYeKXxe8(-sM3Jp;4JSH~XA$TcPECkvfP6lPb-9u^ zC*A!wNLXuY%>DX?(zuSY49j3TqSRKb>#nacN=t+zLD&t7rRJ#6?~zMOkM|@bb(9Z?sMqV zUF^9S(5XbU%@t2_?`FEDg;Wc^bE-0VP1kjj;=)(fj_mwX7Y^(0BJ*e^2-5?hb}*2> zDCY*0X*7G{IfrV}f91sV*e#|t_T>_o(YD!|%b+>lrp?y&hpfa^ zq5U5$Kl@7GY;8;Fc>iQ-cygWxEb?GRgp84uIuVERFj5uI=J&+{03%R5{x{3HjK-;5T5c0K}jEHD^ zRPPWTbD-_feh^&&SM|qu5^6PJ?#eS5J`QsN5l4#TOE9-V+zfQvg;}pEB+(Its8v*R z??ogiTNj>0W&_Y|7ypL%1Y|@^w_W@W_Z`q}7wr=>o@!|A%0|hH7h*(i-rk3D{0V5Y z?*&7XrL2zJ$a6$TZe(xdD*@}iE)BU|MmI{%NmAWMoF5ky<9p7w3kl8HcHyK$qtd%= zyKqr#yGVqxz8JA8zTiX7BZELx$B8G~E_n8(k?csMb_*{#0b@K>XbqdFdsKgnl(lpV z1IgiGlFNMQ_zPVsv`vz)im2ABA}GE6Q3xFgs>qv9FUNEgxul0bk@yopMnbilp9*&> z&~E;6h>HPNdW~~W-rasl8d^EzbW{3y7bAU4KF<*`EI>);a1MGuyI6Uv+t|j+4+=DQ zj>|8Lc~hv!yV~?Iu2Rb@>|<4hj~B4#&VIb$TqJ6^S|D$D&$LEuW0G!=6SK(2h?~*D zF6JNhOfkLW($`yST-t&0l)nq{x2d8O9g4o*x`R@=O^Qig5kCNNpD^-z>q&@>fcFQ^ zl)NGyf+E?>gx9+smc0J|+fSdKcg^t7@Qv0$o;u|47&P3cx1&>nGT??5tU z-qydkzC3RUU0SM4CCX$V|1Pe+0c?->K&qSci0Q+~46r@o1F3$}BQ_zRp#*A=_+YB8 z^mY3Z&<)rgah>fEc}Z+L#C5hqOfBkHuKnRU+l?~g*RsC$K8o!h(I{7MB z)`w$%2+*<~4RNe6Qr0se&IBfXurnoPy#Yln>o@;z${J@|wA{Yi+xYZoXDxn>e%M;m z6^LQFCNV@;EY>?2xgEPyMq+t0?ZWNN*i}GLFV>q;{I{EN<<cimU~k4^ zJ3M)wfTtx;_imLN{0`_Js+2dv`+2dv`+5Kj$ckTtoQ_0P^ zBUSV}&y7C#B?CCs4)kU;g=i#<+>HGox&xCw(V3E)(Vsl(&Di|^dNa;**5qbPvDW@} zGv0ABax>0|}T1w3rNnVBndo!k_ z4v?C0Isqq3px%s=Q%$61TuQ)v3Dlc$a!MCrZzW(Qus7q>J;#ct`2fa>UtuFYJ*7Wm zE}wPU0PJTL&#+Q^52X5mI-46Y{9fu8a4t<{OGyMu#neq!7u@S|XFSC^ zk6tli*+m>58zypC&`Ubltt99can?A4x#J*{KchdRoqL>ykzWOm=ch8i-M}MrDN*zA z?Q9S%gLxg|Sz&I0sWpgR7XNv^pJhcnRjz`)mT?R+yIweG!Bo z!~6vCmN4JK{C6B%6i5}EEm2WjIW#(|88=^$+;+-X1uX~yM-2h&k>Dta+Us}PGaNL!8g9Y6>zE03t_q}&W{To^}fG~#!JBNk(Jo&V9jf>#3x$0 zgEb!&8BgWNMfuy)Y>Hh1a^M*e-T<=tRS+nb!PX5H@`<=K`b9}SBR;nrxG$ae&G z04)2GF_5I}lqyMnrUO@(0|{K<6f9!`NQ}xbj{fnld{Rlb&M!s#o-E zm|1^4RzE?kFDeItU?s)l#>u^_G#cg5UeC~Oc5GJ1RkVv{gp z?sJHL18c6}UaKAQ9cN1=<{l5?i!hfx{`)6dzj`xuc%@hia7M)`HYdkCQSR`%tlK27 zRdnRc3)qN*8BE7@yK|*e<0XXL@=amf_6D4nTHhACt$;q^UM@6Q%6ck2M;+0TC%hN( zJ=LF%_uJ^)9z;*}4s$7n##42yq={Y%t1ZV;k<4oJ>Gl%w-(=(H;YF zl=#5PfV)jH!Ptmpib4xPCm8m`cKU25Bh!UXRA#qh7P9shopqme(QP!f4Zj|D{@lf| zP}_*^@Vr#XEh{JsIU9TiK1=}_iP3|?wI8r%^tkh{PE!lTGb!UK{{YBw=O=E&q!h|k zm|G0AaJ*#nH=U&F-;V69K%c+IAl3^b&)+tPHvzX-jyrqLcp>zF^|7Y?r^lUJt>7JY za@^TV*yGN7Ir;zNapz0i10lzqdt#7>RQ49%loLF{1+y9WF&7*leTEIz##ttg=`Ai& zjyo^hBQpBTMdluNPFHa^Sw^ZqT8&J&`2S|4`cFrm3w#mS;pV)0-1#v&+-&bk<48JG zxq{_GR#8J!Wh$X>@_!i4zI#yRM?M$pk-D3gN%gMtU-uMALpzG zEV%Pjjz|Y8eHfAli*y;Gp-7(uHv#B+gV*9y$WFgdeZ#`h>6)+KgqO13a0T+00Xv>K z(}}WzBuO2cF0H>3K^f0nhtM@3BQZLjxee|XpyQbbAnpV5RsdHHLZ~Wb5SGC_L%4iJ zZoj=@hKYJRh%X8G7*szRMt*JJ9g+%1!PGy3u`mdyz;uP^2=pz&JxNi_K_MEGwww3| z5Z@nYo8@IflcmHjqG_{Ul>A7WH3s=nfZzLiP-Bf99aNu5qE}#j;>~z)4$P@Yodm)K zFqc4F1k{~36L)S9cg8w*RuX>$PIbr~E74sx=?TG|X5Q#OvNT70NhC-a&O&2Egj z>^5JW4z*M1`dFz6?CkB(l)l{WOTd8=s4w>qP3g=1aReL-?92TDe%99UA?G`^H8=2DWuGb@Z4X`sZ0%b;~55zL37nois#zbXjVLmQ2 zo^q2@eJ+nC5jP7fe%)r@_n|DaQ6FC8=7+a>PmZ;otiy}@fql78pm_2c0h@t(^mXFV zXBgmHv^gI6xX^ei*Q5VrJu3SrkM!k!pTzvnV*c<{rWUtKU+! z?t7)sh*I)$KOD)oWkf+Hlzk7aJEP85 zH%;H9E4uhDUw3+>bWQL#a}%HqhY>Is z*p-j{{X)mO*}bQa=6A36_v=uV`OAm!R@?c*Z79OY15=s3@h4bA)X5k*5d`aDmO?BN z<~f-AAXbBn=!9Dcc?0eR(BUJP85h_*hF`+`O6V^j`~@a`G!}p^5A1MB^DTbNMBfFq zo7_RPEDtn8rXk2kj4lrx2)7T=<$+Ny0eT2W{cU+*3bNyYT^^X?#QdZV4`h1tALl{J zoGu>x6jWPuCmzU@W*)ld1D(=b0dbiyGNri&VyQ4PrMVg6CShbsvl`+qpi>)fJ4#Z? z*ivD_8pJP2PGv6g5b_TI9Sc4M@whND7JM6GE3oE%cCJz<9fikwMNDn#i`!yuCko$) z1)19X0kKOMF<0XldVFBbh5i;9PbKD<+D!81_Cld0P;*@%ItU}?4u$9oOw`1ga#I|) zMyor<^oYlivK`h=Yg#0!o-5`3OA!AeDao|v1Z<50`nu4|#pW{Pq#yoRs#>78|d`}9u1Z7va8`Oj=cy{eyThkFaR@P{jVwB+@BedVujclOL9Z|4GA`Rk|j zb2<+Zuv!AOxR1MT4saQcB6 zh=CXpyLv_Z9Y9AoUM4hI%BCte|3ebhoBt&88-Xd<-+64ugmsR^@`BagwJz4RSCD)O zSl0*?*FGfRU7)U=<*YC?7uOI`*M27cd!Vj)nb2gZtZOq!R9!1Lj@Am8f~C8;rbkOQ zy8BKMv>}~_snX_a7*6PqXh}%+Xh|JR)B<|6{BNF$&}OOAjTB#ay_SqL#- z7&%(tf9Jvzc z@Y>7pyGFEjet3N|(Km{S46nUNo@p;4Zg~9?(VKu?=^tE!A%p0}JO-K*{>pv>>2BT8 zlJ!aV>5i5(buP+K`e~>4Pe)6t#Ks2_bep$E2Fe z>%(vG_Y&Pg{Ju!UfqC7*}NF}`M|E{yycQ&vM))op7WIm%6iV#2wep-5~J%m zE8$iEUC&tyu?D#Hoc|*9!2`s}dd^0|*8^S8DJmmW)^k23kZ6_|a>@XxR3^dr6x&<@hegeFUg4$<`8*O7>JkjEl_G~kOU z&S=hhPQNmG8gXCNb0#A-9_V_`g%ERry3;jr=Li&%^_=U8zXqr~UM4hIid4D8oz^6x z?%a#~T0k}3%^h9O8S8?Ys~(=ndd`zbZveWUvmN3CpzAr461P0n$SFpCJ?Cp=zXa-{ zmkLdmvI^qj%ihIZ$o~vX!R*~!bn7`wl2kp#@J6p>JtsPW>In+2cd|L_Ilq)r6MhY3 zSo&&TtGC?#qdIk2=d07NK`W_FC0MBn>~G8c8g!T6mg_{o-oXC0+^@kwCu3kJ0rI1v zUA}Zy{j_Hz&$|6>x!(i*Z8?5&)Jz7WzIBpzDOt907(H3;{R&M#f@0LZz=obIKNG!a zz!cxet@*(j2ovg5qU4JI;8f2&h@6M;Y!EyOa|y%(VK%`mfw&TcZ^7IIaXrYBZy{>3 z){Z#9#XMfGsDHZj3d&S#>PF-r69e+oOPe5`7e;=1=}m|&zzp~V+tr+rq0UJ7DS;mo z{Q=nTdzizC34eh2nUL>6Yr~Hnws(5IApc9kd{Qo8Wt8RtwCds{q!E_V8&H$j-g~Hp zB?Q(&yr!u1-9truI^voFO6;3pyIo4**^y9kxmQ%xTaj5S}!^ z8@E-{M z1~L+(_crfDM1bDg8W6?6HNb-qI-Y!K11uk(s0XwGK1$T30q#jiH=qshDTKCJPmDCc z69_#4XahVOVkXcQ?>pyTU}m6@G{B3AzZ__D;$=dUrNl3yX-*oDh_-k)BYzVx1+q>d zS55;w59{m29ch5?M(Qr04X}KK;YpzG)OMPISt#!K1@*Uy-wMS5&3ytrAHo(Q>X^?<6zylMvJk``GCJk^sWJ`g%=%x6Q zfzu3~yp-6$M_h@OBi|Ho6x)f}5_1jkq9j#M<@;3qf_gi&+kygFG?FW6fVF|Eba$7x zHxy_5V-RnWwB^$oJ<#eZX{Y~kweg(hj1q`W##@;%si+0{&eF*UrE5E8C`>)-rfBHL zHl%S#`}!!qDB01)5`NeKr*&{PY=|uX$<Sar?Cpkx zKB&H&I?;v=vj1r9PI%0>b`J)6+-eXvqCco2zgOwy*%_XPk#%%1@*9;W5kCQBBvgN> zayHydpg&Z3xl4r~WFej(s;ndt{h`Xmh+GczhbnJ|xC!VFReBvhqVBY5pY`I0DyxdV zEcvZQ{4SttbPq#3AdIZhZH9Oe*dMCAKJj3#c;J4h^54XN0`!L}zk`rZ*z&+$=%n=r zIUaD#?AG>vo}o^Zy~4kEtqvguKdV6u(Crm0-;xyKT04aJ3&Xzy`%9H;gYI%O>Q11j zLI2^-fc>RPeURwQWRGt42P=Q%HpjQxA4GCM&~9cJ(( zK8*k}A{I6xWCq;nphFv&AAhuF!p<-^6M7Q}d%@fTv09jcFxw!W73OG|S(7mUbai~B z^CQqN0YyzywfEgf(y}`KE;4U`jC>Rzbx8+iB=O0Hxo*UF02v9j z%iw{IlcwqG;+JCpTxKx`N<|O-Bk9TrU$sPl|}Iuq?Fyr zf0m1pT{edhBaL)Q8jEXvK6QL zsVqqXTW1b)Vp3ET4_E#++?nHp&F|vD>ZsaFoABUEqB^5n4uYRyu7p@1OxQPNwnFG9 zVT)mEoklVsXb5u{!~q~9*230=tb$tx!fr6(>3nbnrb8c?0(TR`0WjC_Xf6TaQ84d7 zYytY2UGHI@*}DrKo*89+d79MZGrNBw^DEHL>^7T92MqKxyF(!k16s=0?zBY{m?Omk zpV{3a7NnGCB6B9lNQ{>9wQ!4pmhu{>$(n_uima(@DZha1bHJAJgHBAJ;*GXtinhDJ ze>g(onlEj;qVKHj(8wpWqM1=?C{y9wekkP#jIes3)qb%E^nd&j~Z3)I~P z&fUOlM?=2f`>l8PQDhzl8HrJMUx#}YsJkCSd;nL_H6 z1R06Zq16Pq6Mzn_W<#6{XsPvlmvb^Sg^sFjy*Bc8_F->yF&YcSguI_5v|8VA>Pf7K9hU9177F z=-Idx?pfnRixln!QPJ1pxNMjlh0Jk4&&GMVQ00;mypG6SRW$A zay85*q@D%g%`l%rd;~P}uP5$&Chp9OioOu@lKJ0|*#$K7UM@5umt;O~21+0!p_=&; zxMHB0Zwt{HaB1d0Pg48YrKXwhg~NJS>aqTrZ|&BUoV;3?c8bRRV(q%E1X`B}DLBQ2+qV`ERih+U=tQ&3 zeN6U@lvNCtzxJA+v#bdAk~zzrxU>S;Im?P*ADNzfLcj+=f9__8GZL7`24Q(+Q1}!^ zvOjl|KNDYp{v<7TeR{P9dVk-H$n{$yn4d~C^JP+|0 z$cU)^+)d+iSPupIb2p}YpqbL2yO~7j1fV~6b0Nf3VdUp-TAoY040JegVv?2buqi)x z)8u7Rli|c6$n*gjiP7Q2scaHO>8N5`q}k!bDr9c}b~y1LCngWtbQRUE z_nO3m^k6*T$8IKx2QpH465Wj;BQe_bz5@3W(60AAh;4u-v66f>MCjj}iIX3@`IYc* zRS>4lEbb=I<3Xo7H`snC>G5MXzq~?vay+OXGL=A&2b}^j1!P1_j|ZI(cQ(-DL6;|H zJk`WypW{IT#iCS;2N1spXtnTyEG0PQ+^IyR=t#BLg#7cs6x{8^wD#K{yK%ReA5#_Q z#|7_s-?yQ$1=!<35}Q39)ZRZBRx9^-kdKOur*eII3G427&@^YmwnQeH=6v(VgXBw9 zImd%4oj6~?6-W80n~B^SEt7BY@++Wa;^iWfrEED$Q!z|*q)Z}4`8v{%F3s`7KS_E# zXoQR4`_7K?!`tMCZi=x|73diOFGX{^hkVilG(ff<(8gcBTi8Mv>D#+ObOKyDaNF!2 zV$Rn{cKM;3(XZmV4BSQ_HW=u@?X%=zKOebd;C2b|Gl34=K8AP?WJE*49@Bi;}_jB$!=ia7!(?A+D zsiaX#lc*@ZX^;kl%8-OK2~8xDv5*WAnfoF`gA5fRgrtcKWhNCR`YFEu_gZ`J=bU@< zKd(Nwwf0_Xug|le{p@G&{Y=SQ6Z!_0s-rF#W0H3|#V@?xozOe6-NGx1oX2Q8?IpxT zdN%BJgQT!-;=A(118p~kv*ATXqU+d8K)*FT&KJW6mc3NoxSySu-1mtT@>Rkdjd??$A5!j!&>rY#CWDua z{R@M?{~C8UOiu#ZCG8N7>$>f&UMaC|o4*f_S7Ww8^1)2<>O{F- zvdwZ8;#vxwECr|K;M*8GZI{ZKkVtM3LpkJhgQpRn1xSZJWKx5KyUF3 zHu18IB7qmf&cJz zAQWXef4M#979r5kI{|8Z%g|E6$^4tB?APl$B~ z1@b-nV9$`5z9~7BK1RM_KZ5*WAS0>zA^XW_*8u$n`J|z)_=E{keB|&U`<6u1LuVHD zw*ftL<|8}|^w0@zHZGv_q4Nx;3xFOvFC#1xMGhUg|NVWyp)+o%TOJS*g-xN_ztdlJxfE0{L~u3JH9543KA7taoP|I&5S4bzi=>sAnYiK5*K z!i9jk$@k7$H}$+ys&4M7#AcnLbu-V`Ubb%J-N)_@f-~ItWEure1_kmB`(V!)MjB3k z>PEg>{|NaHf{di<$LklNJrA_uyzZkg7xGeEH+;N)1QE4zR%5>kXyts0unB181UK&4 z@&%NxoNqAQ2DEZ^A#4{#DknLO5&@O7*gI?GZ176S%Bj)e2)3)GJGokUm$y5)woK?F zAC>jI)iR;4f2pi5w`iHr*S=KNM>~#5=<8mp>Wj~gbtgh@wxGz?Ug5I6Nw!JoODx<8 zxkrf;GM^OAUI|5UC*&IMM!41VwB+6Sj#f=~a64Kx6Z)PuN2^vs-_Pb~)k^3K)*P+c zxwL90^j&PGUVUj4`?XQ*p!k}3wM5rJN=@D9{aScU-R1*Yc1_*n16p*QR0jKhbez#r zxBj2%LcNY|{6CF!GwS`fHb#3iNaZad$eyDgI|2E%l;oW-f^tl~#T8Mus^OWj;Z_~r zwAAsy*BWW4esW>QQ5C6Fes%6`gxe4L$rV#CB`x$Fy$ZQn%DA9{=(VRXMsi#CPFoo- z)%-F~(!0vF>4t+xU1XB0j}W#s^&bA!%|v!F-_uLm=j)dowp6d97sA&ZCS|~QU`9hPJE5ZZou9HP+2&sn>{`C`VJ{ zqN*JD^YXPK?9CKWxow@S+5Ektp~ zWAfeo4N`OV8t18pvAxzQZd`4r=4Z#%qDX9pzPDEA6rZV&?}&U!I`4EzrYm>B+UCX zw!9OQ)rh6HHuT1%2hdv^h9H~=^wx&pV@;4k&&#b1KYfXdEO3v&d^phFcRa!vQKa|1 z4Pgdww>I1sGuS8${H+a-kv|{ktqltio)rgEc%`@2?)q`Bl<2N&99n}ogZwVLn9Zri z0YZY_s#29NB-wNG50|}XY7H;Iw6fNEueYRpE~UBusP%nchgz?kf2`QQ4TWW(k{so@ z=|^HxjKwS{qp#kn>UQ{1Bvc2@q;=ZEUE&lHE(2BS)Z-6@Hn!a?F67> z*&Cdqlq8zB31hyMSX$qOg6L zghfC{+b{dV@{JT=F;RwV$zKDMVX#S?Akii0Pe$9F391ag!~Pp!q7HAn?7(n>s8xCr zV1LZ8o@2NNhh4xiBvBY1GM%~v%CLejEZ;~0787N76!}L2Wf*MICP=vqzY7dIVc!v$ z=;VK67~SV9!`({Lm$^WE3r&@C2>vqd#J&D5pauO~9%6_XaGT%r6 z787NE1NqkhWgl$PCP=yL=Mz-x_kQf}1tx0wZ|qYS_)z!OH)b79Oitu3Ad|YmXIw|d z&n|ZL7%RfxP0Xzun9XnnG&1p12dJ_YW$U!T;E!5tuB zAJ8ZG?8c;?87tq!p$XiPy(y{Zg^nZ~D~U2lvA-ns%yJ0{=Ylem5>VOU68}rWeUdm; z5_h^pJA*fXlGtq2Fx+>!#C{}p1Nso4P33<&(Xp>`CtdN!-%^D37}m9s+pwGgTpJ-# z+Qb(;^>R5X4^e;?Q;9ozai*9DF(iNdxO2`z#4x}k`)2~sG`Vy?`O z$F>7d=E15Uw$JT#t3W`RcgOx@V4@d2$56Mf*L}Irm@P5ev}1b)4!wb6OQNtHMZ#r3 z>o&BQd?N)|OqAg?@~;KD$AeAUtine2_%ngk9Bl3aCM8!(n5bbX=GrQXhhnI=(b_`CR9ACF5r!tco@=@r zeAkyWqYA0WEy?oZf1>zr$*M-thl0efDD@EPfQ*_QAmtde7Qm*sP;op$2XM%tC?kED z+-e(_PCS08(PffSynJ1)JLV^ge=C&J5qg8dvEDH14ulo zWreJg97G9cfr`SfqVOu*?R{D_pz!@(c@f1#+q~wVtd#~!{m)@=dX>-Nl3grmL}R~6 z7W^z*Adj++Ak=W6&w`Fa7z6ZK(BPI^lq(=S$~pzpNx(;(>fOJ?w(!PZ3h|2&DlqbyqoT$&>(dmnP{%h zE3uPORegW+SzY>HVuTgbrapZ->8Ja2_Zb|Hh}20rxmUzq?xs+a8su|F;Cs8zjc>Xy zlncl56ON|Vc~#i_SM@Mj!KhAti0er-~HgMVwWe&SK5(VzYT7qF@TI@ zYyIjj>P=D)pvUH4zKnzkQqu94WAou(*y(a?UWobmK#$E)2qQt^|Gcjro4Uh$F^qG+ zw+YD(-$x1A9XtaJIPWL!y+99@ClDS3dZ+|9-nJbVG9FNux*bXS?BlHpF6qMBn%S7pqQsWMW0HFE#C>0nW$*-vFU;J%GvAZxU zhjJ|@6M?OU@(99%Ku>ALGo&SZshO66?UJNBr7gvFG0;<5uque{{qdqh3PV6WrLDsL z4ZvkuUu+oY=<%nQzQ*_*KG5zZADQ)=WVutND7o~tmSR4XqVnZ?F~Ky-k(`@2-6u}+ z!I;l+_zdU=V}3&T0q6%~_96TMOru+=vN=9-Emwx=_A6$y$jHp(H~{t`l*16J0pw?Im?3)1-Ei6@IItVEG03PL=aRZVtT!+#L zEuQIG+45Kv@MFrntV<K&A>$ec(bq{9jhJ0 zt^unlzd>X-%3O@^0rr0=A0n&<%Brp}AgvB|v1j!w`SKop9i#@E0&@(7${@ARZ@zwt zXE8DZCeQ z1?Q`SeZe#ALH?;g83voQ8R!}Q9vBY9rav&zq8x^v9lYE4{VEgc+PfWZhNh`*K3z_N zZFACx`E;3Q_wng$Q|dOKF0T`AaZqkkDDV~fw%wcS-U6ZV^VIRArJz1B`;+YPR=#Fw9!W|%^X8lOnjJ6)wp(yrF z#tSH&M~cGdE$u{v>qs33>+o#vk}yGP?0k)# zl+1Z;d&sr1T`tR82;^TFIH44~$x>WVt^L#~b=Kw&NYq1-k3$$>TcET?Xb!Z_;+AQi zmjmJk-$M)_zc0`_3pVMv9p|#CO%UCamtubjFwu{tdJDHFI}v*YLEaNqT~Q`td?m1b zP#!|K7ic}Li|Z*!@e=Wk$(+|1hFoj15(M~3Px}&qd_DdAuk~~uaW}$f1oze23s9Cr z;5A`13S}+Ahd}Eo6p%K*NIgyW_4GCQp8@SjgAJ48=8i!}3f8(QJDc7LnACpXe@QEs zN07pT#FkQZrn8HpDe$OCVRs3`Yf+A-kcPnChH@IhDN<@9gLbAbp^0oizZ2=%Y?6$j zm<$%5Vw5omqkz_PaLGT&*-rIaI0f5DKwCnvPsjF=hH_imSh`XXSotkH!)O0y-$n7R_R+;Z} z<>c_T_i`r(j*`MNJTrH4NZsN?9D7}!`NI_@Q=a-V>(sU2Hs3pLddpmmPuY9+wxql8 zCMOnm;qA6$Gg*?=CyvS1+rr#cxI5geNv~(ynQocXU4@(Fl%!svxzj1f$aPEmQZi92 zLprxo@^CWyz_CTqm6Bo^47hxTYVl=w8MnFo58`}I{@HvKm%k&RM{)Tw@OI@h zyvgRHXuiL8$iO(L7VDX;~_(t7;2hb1n9|l>0yN zz`P0xKmYHV)H?>2a*)mjZvNjjskaW?b`Oh3z|H?pE-y}`9CFO=l>h=S_d+cn=}6(;N5hnd8t?Y{Qqko&X&)mz#06JV*4$Sim6S3st zQ9u2d|A&Z`@Tdqh;t>cnfkq4k*nVUIp2uA=zpiwfP*jN0sJ1a@ zm;{&IP?lrz3eZ8cyaPaf2@@ozQ{<;nxyApGBZKJm*slX_5FJc;D#g2p)0a3U|A&(d zqPODkCD1|i4utJM2hj%*{sN{^bqMV&RmepYP_Z@{6`S&>Zw+=(X%qWJR94>$-FL;m zh|7bg1-$Y`dJgkH!8NV4@1X&@de5L`>WJ#c%U+PO8eWbM7MS(_O}BQtyrbG@l;#4w&*@$p98D030OUZ@({-N1N&c; z6$q~aWtI1aDiTqE14iJM)ff+-g!sJ{ERwg^K`5Ex^ODQH3rQAl#q!xTm z=obq)^6V>Q*az5qz^+C)1fdw{057ZI^L%@gq2e@3mS)4gNxkIL zWvDpUr!&n+t@i0MR9xiKslmd_S2%jwu}|=dbnJzfd;WfvK+ch!d^657Q`t|pf3m{2 z<=Ia!kaZGUek@2VM|lk4c92oCHKd$2m-8mDpNj2+jCg?k9%aZwEYSnI2W99y)(!wK zw&R-z5A#GVN}IAMwlaU#k+KSCPj{CmlQ2OFHEqi$%gwV8lb){mBfOIYxSnoK>=Yz& z^e0Zc#7TO(4mh*}+S7GMI2mY9Hvpj@FzFFI%JGaZ&X_lAV^A@9$gTMlF^Q~U7@ZFi zGf-|qxCRs~=DD+FF^8SCY1dbA=k41he?Xz`JBjszIL=4!l9sWwfD%rHFd2|VZGH$q28jaGG&sKCMV+~ajpl-%3D+Ql$f>7 zN{&T1CAP%AIe@k-;BNE9Ct}H&v&|DSXG$Qc>f>?f0JN%4Md%K+s?S6i0Ne+^5Al5@ zs+Y?9;-V`nd@7~MlfJ{SzYyp%U%`+ESWCIY&wP!+b`;Rt-KHQ+5=CxzyB*A(EY>LKxM1gDV_^_&NUE?~r%qa4D|C72p)dPB)aD6!tT)XP}gSl%@f+hpywx$yWz^ zSXkO7zc$eGMzBenAXyh&d+V|U(LS&p_QwGet@bq@&XSYGywOl%w_YJ4vvv2M`B)eZ zBjaQoy8=5FWdK4ypuKf)Ngw2Ft9iEPV><*W+hAW1+vl=#(Q=vCksNZ^EiI%4Ce?gB-RC%C87t17#IjNO^Osu#Ypo0J=I<*v&Nm6dnDB?B7sZ{|? zu0*MeaaCZiN129j6;LMctq>1Fs)Ie=Gg(dkt3a6qn*!6{GuaiG6h3Lp|FAQuwr^-T zIxUNf5>l`X}5f|wP}g5Pxn*(A*GMCnF=6M>zFauvd8phv+^D_p_c zVBw`BU4pTl{8r4tb~e!V7ObM!KJxammsb){>-JIX9|61=q|`C1BdnsS9F22ecxfRF zr=u*z_*r1@MoB(JeV}OF_V!i61v4CMEzhbxHnoAW3N~pIBu`4)UVnnPo&@{jfQigo z&LA9{y2taM>B%*3AC4~HOJ#gnwoWqnoD{VTvy&;NE6|&gPe|m5q<$w`g@$0I{7xqN9(*4COOfByvkMBGCh4|7SOJNp1y)* z@*to1^i>Jlia<|abr5QbBB!qo2*&}+tL!7nY3f)aF(=B{_?0t-y?pjVr{`f^v`E@i zJuWg}X_uj#O)34P*mqEFMYs`YYrDdG=BtA})}INUA^$0$tu5H3O^~dR;wQ(zTe9IY zyL$us6@cgcR%xyt)pA6;K6eAL4}sMc(pEO2ti^Z@u-~BkhOh%Dt7)E9S{-a_&no?2 z3J1z6*c6x`<+3`9Aj+yb_SFEaN*x2*|E4bSp&q3P+>Vp*jTdsGSA1^CNu_u;+70QA zzHK#f+iM0elDB`7(U6Eo0vpi*wMA$Hv;zt*se_#DasE(03EM6}H#690V*AJklgd9) zrVdj1eX#EZOtjB)3WvIOK&fti{3BDEkvRGBPwH%+E>ocCKAlcAb$O2cLoQvul{eid z%M56VH>WR2Ra@amNj+`w>2WO>mqjQzR0c3%bJy2b>0{0?b2>-eqW@wNxMb&zaqWqIk}OMw%zX( zw@`n;=X6e!^S95@8>Rnoid(2}mrPV0dHHB#YxC~RYD~X7)4tpia)sO_XcV`^J2cK` z6q;S)MREC4<9x<_*?bh2KR?dr+>^~marx5l-F1ihNqv5!SdMJRi2ft%fubIMQJJGS zn}?!#rns0&bk4N@tO1G(*CNhmK$y)(aru4Xe1>M(d=!^ID$ZxXl+8zR`Lp7DhB4WE z6wUYK860HuP&CifsKdc%SNrC$i6sfw99HKxht;k*xSjr9?tXsXw*b95vnF?^{~9HV zW&Oj|^VZ1Kv#i>=s$!)tO9v&FDl2r^JQPQ@`0Ci11(K`*iW(H(7w5C+mCZ+S`OD&b zmY=fuD7nE|_{rv>xZt%KR-~R5Mxu54!W~%GP<8T4JkaZiaOGfOq<0QpO-FV%a90i% zMtbL9t7mwM1-L5*FGTv(LH5qU7bAV*;4>`N0lji?p%2A79=UF5UyRE4ti<>uzHv77 zEa5>$va?qXnvv8P=#_)3eHpyT+Dl2tTdo{zIfU+4t{im5yfe@%2fYz`g2Kt(BYWjw ztxsVyn$WjhlxR_c(7AY>1u~MGbLHSi@1_e(e|yDWIT+>D|L>K9>2b`gnm?EV*(p%STMaQgE;Pa`}DG-4>g9#lYxxERxy0DD@R&%&=H-vgQwsFfh?0 zK0t|6ebIlRdnpXxtqQ~EQJ%;683`h9(D>c^Bx1>PGWM>h+$;$qD}HZdze5lt;^t&e~`0%*k6%29NWWy)@86y$M(6S!>b6Wb=d&>`oKiZwmLGQF5T#` zoKKZ&4$tBw*CMjdrA0UU>@YlxZx1s?)o2Y<*$d|$%C^-)IhHUjfIS+eKf>uiN4ueI zrPRSb<=e((?E5IsA>0d^Z$@e6=@xB6F-^G+TLZuEQ4W8JWgnp3 z#h92-kQ_mZydWyKvKr*{0s;0-f$J`UX=JjJa}%cuhvTFd2ykczw7WP3p&QWdVjx0) zU>fa#(6ydJO&|Jo3b6ag7>>y>@k!Q6m}?NO0@_^!m;8gA?S+xMpYTR(rvW{@f_*x+ z&po`J6vonI?!(7pka_%P#xi+@TW%)UQ{C#ohjR2H#*aWNJ2du`X(yF^jqfQ= zBmWejl^tv{@u88s84C!al|2;u!N5erO7$9}Ni;=w5c?E@oX#81?A<7%F}@VoM^NrY zxE*K(_wn1ttMa{6Rf^zeC-`fa$}HsC*e;h@2LkyD9`1`NQNcwEiF+Q5_6nm#D2pKQ zqA+>`5~T}5Ctw=&Li=p1l*>Ko?mzRs z_?$t;Kur3J&k&U12*ZHZb8yK&$k~qfTR0BeF+l4(*r#LrFxru=T|_|L+Uu~N0!(yZ zt0NQYUAHQAoNw52{`dwbUk9n)K3&cqf4Ouye+=`Faz?PjOqPRI?v5c6UGiUOw0g4(F%h<)`GeXMd zqqzLD;(W#`*?g4T;EcSpc_=P;jj2_rr_+5s?Vts@dOAI~o=(rLr!#!j=naJZax1NW zZlw*#t+cDDG-<=G(k}LuCMONIU7VV-+)&(hN%!sYIZ0&mQF6D7E;*Zr;8`$9t}p{ENSV})(cGePo|U~KoOaXsom$5_26<}@iP^|CLj6+K87vh`{} z(RqyHdHT|=RH~>_T zZwMXc?U`tKslE5KCr0jjLL;%g4CtqXCLoLl`o5i}-h~qoS1I_E(9Ois_wC3h>23!4 zzMXjp4+4GPPVliNNQFKi@7ozD{_?(^r!jvL=p~fJ2rq~tmr&LqtOo9VI~`*ND};f6 z-_AGWZv%R1YbU}l;$RAo^w#>moqk>^`M#asY7?iq?=?P!j=pcFd89AJ*7xnSjQsm{ zUayB~zSerP-fkPhmB+*b{f?y8<&9rhG?rI>9e~0h*Fd5VNfCGq>}BrdbM)P3bETzd!2I`N7fXOL_e$bQm$-q1cY%B9$FFuH7oFr+CGU7+ zjyRU-jJ{B4mDPpP`mb{e1+C_BK}UWK^e+RLhM_Nb*J@XLBUaOZ>kCMfO_keFX9FEP zgd*}ykV0V=bL|%%#r6@P{X(!x$M(7X!tMsXUs#C!v%o|vJjc*4OcJhD{?o~rc`@7d zj_nE@mI23>L}B|U3EP48Tt9N{MSk2uK>-#MW!Qc>mkogq;DSxs48cZ*G}8&By_H-I zIun?v8y7<4=UMshl$a`4bmGc-qfm>V*&^xlN8oZHaJ)zqUUNyf2Pm&GzPNlN1z1d! z*GlqV16p&zCT+434EPDh#spQ4o3Y;rOmse%9po2kZnP*>rgY+2+nC`N$M9zyz6FjU ziNdhj3feeOhPQf#EY?wg#Y7plBfm9JhQX%51Sxmlei#_`!u~X1qAN-xo z{Dl0EfN~5r1tv(j9BUC&IsT0OkHAE8O4X>_=T$p#B{^pJz15-6UpV{$977UypRZ&G z0A<+A_aZDRQh>!o8MYw53DBb@*rZJpY^3HE2UaIz(-m;*Qz=$%KX<@k!qK7LesHW# z$DucHtVk4A=aVo5=zbpTSy>aLct2yV3`b!*5@;O;t7L4STZiXEK|X{ZnqQhbpYtGHzZ7+Vn^oMe{_*V24{X^Zno@v#De8Tk-vRoisBaOz z6r~FHiWIy76`-GXs97eV1#nq_668x!{|E*7v_nH|>VS;o=%*ddKsy!aryW-NUYzR< zUOL2ci9cj_JGQq1_i2Ys-i&Ep_ymWEdiePN^3wHaCSP)c=IHf&Y1(fn3kO1Gm92PL z3urz;*24t2AC#SnlDM5etI<|~#Qi9H5O#?2B1+vi8S{dSma?3b-e^66eII2o!dc)D zxoi+ZMzQ2KkISD0tEHM{8E`V@6M?&THTa}rpD>Tcr*boVWEJpc>~8|P3OEO0HqceT zClDS3?%vf|@!kzm7z)~tE8Q)n$<3onv0n`I?wer96)Eo=T;jWLR$(i566(-#9m0pA z$k6c@gdYK;SGoJ=$vFHlsq;-0^P2mRsZ~7E1@yx>!Hm0TF^j`gB)Bg;Hy+r$4GA+B;a*T%I0lzYECpw~&5b%1WBL+M zuED%8HqSlM3#9!D*HzfR0Zep+rxf>6?nqBv@9XAbZn|lUo2--2-=^01borD)A5HHq z+gCW(A85Md-pm&&i}4&x^0l-p{4rN5h{=g}Sm*{`MTMUzjW>0M|y#XZY>qR7|Ms<$MH+=X`P+uW}WGLoZrp$$Om z2lOtqVF>2~8jyS~?PZKwLQub!b_eM*#BeS-3laVc^ph=h{6H{aK9YDJ_FHKGGeBmZ22GBpFls^(lIV3NVSCtKR(%#kP@X)Hh70Q2+$oJ46VsZ z>YQ6 z~5Zrm}?m=Yf7q4=i^%vIUpPQQ?+~*>s#1xpz4>gQrmn@&Eg;|WbUS?K=)ZLooBdejlwLT#8s%&vfE`_tt^qZpZOPT&@Lqfmz+63z~Oynocw>LqR;~wmP115T*Bu9DZf&KStC-!ffz;KUa zn0%Mpka2PhNfd_1lGqF=!|HK#DZpZ)4EvGa2Pnf}Q(%IWdw}f;3@^d{Vql`jN-=bU z=l2P)AZGZxV|Wz~V}WBxqA+}bgxNqDw(|_>yoDhq%5VkwuL5NlY$6k+T!wcORO@gP z_8WkSZZ5^p)!|PB=)u~FYl(Xu!yj8^hvDF?1`(fA~EtuN}82!ipo*pEBhN#SPfX5jtPqS$nR} zkZTe1Tt+lg8h0wRIyop`_AWDjon#6>_6+1QMd4nrxK9A}EhgxNwh19uB;5eJOcI4( z;(_bBgw>}DZ7W%QI)@GF0*<_V$Z&D%DqR02;TzzVkA}HLp@-gQ@dmh8O<(L1JFel5 z4&c_5hP%Y~Nq9vPbxr9Km)PI~u5$yobTq>1{bSQf7%z!>Bj%+p@p}^11Gn~dnOpn1 z_(Nk(0A1t-`1Tn)x4>;$l|3C<|7sW7#e;6@)MqUn5^(K;MA@pTBuoU_F7mv8zL5ef zCfY9Mlm8IVb`fmSCPO$0QF$mt ze(^AGsp~^G5aOAb<3h*r7F?zS$B{(g_#6pO0p*xTyW-MD3b2?c#|`9v1e9a2DPYnP ztd)auyqlm}i+^Ij7w|ow(j2!c$5w}VcWK%3yQo8`)93y1whj)!@g-6CRwm&PpcCd$ zMA`%?6lO73?zOS41(bWRDv0fKTR?9JDEB7VHwGqZ?>UARFj0u6{kMO4|Gm;^m-O$fX>OrAPff?^^rN*J7}+f?3}D{19NqtbF!X3O2V`!ip-bwR53GV>+frQ3ZA658{gfD;_ZXWGMmSs279|1SqJkbqI z+mg@(xDObgsv{J-lt6PfV);Y$Y!Rvt*Ek})z95s z!w_Yl8=?%tav*R+6cS~Kay1F#fDWl$KMhdW)=&UHnjR5X64ogCPn<=F1U zc@J=GNffrxXIzH|I?M}2a3^P}!Yt;>yd1V=fHDtOTo?29xf8%P5K!h-v9AnF^o=(Q z%sH5;+asu&12Nlk9NW4$)B=tziNf{-5;_2_+t6b2jTB%pQHFiV?*(*^2OAy%$42(} zhk?~a*bD_GRdb5aaP|2;+0xCh*Q3X$XmVW7t|hdlpr^Zqx;@viy_$l?0mqg^VS5h= zcLJ^35F~AabeJohuN`^jPhtB6(7Fv)1+jf@tGEjSTDLD^|2#0!aZ_A*p>AEP2&wd- z`a8dSV1Axs{u<7&0LPp}VZMfh_kc1FMWjuTLSYtjt@Dl8t_R9ISQW(fxvkasp?Dd@+ehR%;jr%`Y2Ux zgj%5RG4HF7Qt1a04)qMVWa6b_x3ThA)l^E$KIhe#5*mS=C#q_DAGr`vc$8Q4iK?i` zYbD;jug^6-9 zBe^;I=sWMG`zSO>-A5++z~`0NNvUpr*U7E5{fH5UHRt+t`9Q)LpPv0d!nmB=S+SSg zImeNny4B~(2ND+g-0TMu4)|Q*$O{s&vBf%e82P7EDOYyNx&IRn*pcBe$6{MYj9Db(Bre>R;EB8de!^N z@u@SuJ7hAa2Wo|Vt_JAzymY8fpd~ae!LlYrRR=kZpqBU1M$phJ?m%7OW0q(Gdf2S+ zIgE~C$;Grs*vw1B)C08{p_%|aY}zBV1$x*7H@-k#s(^6Vbi?!{;1AUIyjj8oNwVZ; z>(~nQd-{ldw=%B;8u2`YbAUz+ZuX!8Lc|f64hQUUX-cdAPef|lbZSkMy0${!bBI!j ztl3*RXM#j+l)>9LyMv6HH6^9z*R(xg+oRn64f9%HyQ4h%Evp~E_Cq=KJ9Y-JLq++X zr|*FsiSjJMbWtXvJpKdYMPO&3eEOp?GePrvP>%UW_|ZV-p*#)A&jvC_ehj7IFWh|v z^lpa!e>pQA|C0^boL8~#>1>GH&2Tj~BSH3VhL_Qv0eUyXUkJa7B6l;Kx`XWm87)Qb zX1EJ&7SOvHoq8rTURWOUgTuJ^| zkWpuu=-!BSEznp`B0LTxSPe2?i+6Af3AQD9LLatIE*!sx)yqIfH^I!t4!NV7#^NJa zX4hfAR!WcdSf)b!!nkZQa*^E4Z~|dAW3P8Ge2wkrK<{9vw2Q_B4i{eO$oUtjL%3_< zB(ggJjHIMBmtoT1?FFjphGfz}cGHxkwSG)szNu7S1S2op`3X-M3Ne~$WbSdyv zgqK8-d!4o;`~Y+*P~O)qzl6Dv5@adxTRH4xDX`41B!G9B-O0}_VAW^Mp&VX=9JvtNB-AEz}4|0;AC&cx1EH>PkB|Meh`#Jz+VWn z73d;htKWDJ8qh_+83>a=Mtx)va0l8~AiD_IdN-3gpo@SH#MQ8fD6$CnEEQQ+76CJo zqKkj0VBHPq;@_DF{Q!+kZpe5aqY-EL#lO*{Un+*O`1cUPT%fBx&-|@*#-AXS^$D{0 zcLoLM5x)R?`PhUW@xhXJBzo`Q6Ca98uw4Z7h<_7dr6_X5uS56{uu(UA?|AV~cZDwg zZSb4V^-|e<7XN+_Dzf;u2j}fT7yq`$)$}KJ@#0_OJ>2;Lbn$N>LT``}6J7kf0c{e{ z#lPnf764%sP7VLI_*YbX1vk@Ni-npu)nxKXgt zD5B5z0grYyU^WWJ(PT`-^%`KOpxlOV3()yya49&*+5XS-eE{40fbtFYWn%kWzOM(q zPhrQ>ossXdUPL3#gX!2EcI>%2Lc11N$w?y9n<9t;deOQ|G0!Qjfdx++D*P z$o~ZB9t}1ba}74KM^B+(t-Ed5d<9H&cB!+&M5(8u-Nc)L)APdQPn6#<-VQ28)Rr>% z(jP7PYG`-oxtA(O?Mrs;EHCnF^a5oZ<2&odlEUv?8Rsk^qsCs^7qF{Pnj#zxbXNqI z{DYkB);xFnTsv%!1G+1MeLA+!JvnwKpl<%j*mngc>gzd`Xwa!c{SK1HX(!_phUzle zk<-!1K3~>I=eT^g%Dcu_$}G-DuLVcWZQ>|zJ&+aFsIiafAJ&a#G70b{o1*8a-+QU~ zQD;&)FQE*AXK!FvqO3r80q7nW;s=iT<~3;pX}=ay{tx;VpcN8qc#6SW=eEr=38EF! z9Q&q#+e}Kf2Y)}UDf)=$YY0eC!9&B)efEBB*B zYfAT!k_yY7a5;wpe-W0wP(Gv}`A~-)gi`+hC=}?SxWTiuCP+t7g8Xb*&$t7&?SR%~ zuu8`E+yJ6KVZT1GKNb7#z(oJ&1H`?e&W#y8(7vvL<8_1Jco)h*%;ht6_F~pCQ zS|-eBvIm<2`vS@p zoEy3VyBy^*8hbZj*P!&^gir_APf_Gs3r7R{JxV*;-ci8rLD_)t7-(ZgCrnX>KYQC6 zQ|kh<%b~oT$17ogt`@BK8;~%y+EMWIyoy7HvH`MM@FzCAKz6mD5&cFjpsNMvAq)^j zRtp|RxEEx!6j?3!9PKlps|7m|z6ZKm5JK{02Or$+JHoFnSalvH%4$I+nrKC7ruyFQ zV3~@2a#jn92je5F1xH|C6X_HEjSJP{{Wpk z1j9TNq~H?I9nQpd0MNO^Fog3(k-5Wl2$O&hUqFj>zaWLC$;v^6AwK+E9PS4iJ{a9iyv$Ja&6J!fgJN*8a)q^HDNjE%+^rL*u z$m+pKn(kH)9`nqkHz=%Ur6yg6PH$MBZIW}7{30_%nBSULH1>R`981=X(3lDmC!#!p z@SrHCp}dT+2xQdfOj6dNtpWBzl;06{0$uWvlal=C93;Tr~4NV$Bs#uDOBkjc-VF*a?9LsV7s9_jBr0til5LG$}i6Z zskZ7=^3ptab#W!O%Yjl1R#9x9+gAS@D1Lzb`@lqdeSknw+iFoic+7_3g%?8VER-!6 zZvu80$^nFZKu0xY{iLF-c~M%)%bwMtDULdzS$@6l-Z-G)Lhzo9Iz{#{3sS<$jd^!+bBWPol`Z zpOt~`-A;a!S^oD@Eg#dq;yE_Qwkc4K!77UFb2-i+pdM<+W8VRoXi!d_QlDWZv*-^F zg~Q<3Wf-*fqYT9SRAAF^d=KGOpmlezZy+ht6$iW6^E!kZcgg_WzriMBhF~N0Re6}_ z(gB;}fJw=zSbnk}n~*L0cOo2z(BFh~pGGZKhQ}2Y_8FG88p@dz(hJxIC<_oC2FmcI z_!zlc7%uS)x03%k(3%T2k;zILRoSizZ1-Zn2bgGj4qIV0POQ`Nvh~+|_hrnZ5^hdj zvckn|th``7QNVN$cYO;*S(HLxirP@Y%dmYMJKF)J0m+90dkV_62or&B%Y0vWzB<_1 zep}{{e;3eg2{vgHq}*ft4k05Q?lagg0K8GGR1NF46b&HuyRiE9GKdU9S&s1%ps#)Z z$P=+$B)KLL)rNj{=1(>_BaPO3StosZ`FYR_Ms>tPp@e*w^j9Bk4iNVyGpAVIVt%k$+E zfQhP>Iw&U!*P=PZ9tW%Br4X5mavR3efqfcfIl{|8S*3he!Mo99*oWmP?9B@T9> zXVsScV}Y^?HawB#t#esTBZ$^jPwaaD6UmTIekD%qI&kb2_m_7`xTo_fJ#`uGGH@J( zt30iw1IO_QV?>dGqr6uCW{^=I88|+P_6X2{ab(A7{a;sIN2m+*j2~Q52RYjpeP4eJwk^b7KDQR^GqIFgM_NDf`G8Jwpa8S zuy?$fKIXOB=jdCE-t~&U=jgpWeb1456Mw!<6w8{OdwtvHJbl+tv0U45chj+OpM3)w zir!6EELR*{KG!m``6w=5u6DV6t~6xxQCz-UgL3%?SY4#OxV!aGTz;Q8pKDIpd=!^2 z*NU9~Ke_oRn(yDx#`T}9FN)@wVp+6z&MY}*4NzR+vUu+DS)|YAqqzKCaXyRX*?bh2 zFN@sHzaTds#pTOlv&&~uJL`|)@@1LV<+He)%}3FEzi}+%X7f-q&(wHG8rlfo&^}>k z=o;FH+=ezHx1n9;n})u_>T=(L^sR{_eU3J?D}0W&tx-Nlzw$8J=jitw#^&kw9NcFj zu5>xBq490O;x-)quAxnL4b5*0v&-zZptx-*9)P*42*!O`0~A+L(&xD1?)Sx29W!zS zE6sUT#GqJCgwCJSZPp*f`O7KE<#Xc8=A&r7C&%e0n}?!#lrD1y=S@$QwLo#D%ZT0O zGe^kgqqzKI<9tTw*?bh2-!IN*W}D4NarxuoeCC+hd=!^IJI-f*m(53U`HSOx=2qE! z6wUWr|7va?isqSGf6>3%zImdp?d(phi6Yn6CLYMUKim}9H&4HPa94Rg^a$KdfqnCu zi(j82mLh?>DX?FjK2Y#bG1FAwZVK$5r_ZmhBjIhJi{7@23&+bk`of`qUimY|<*p-F ztjMJhkdf@{O@VDlY6f(XyP_|HvyzwKqd#ui{dz1XT3O^CjQJp-i`?T7#(=1r_wY9b z%9PyQ5;)RlaCeuNs)j-@N*rH;<8>4?1>~%CPxd}~Dw*yTcS~TQ*TTa0L@8Ep39RXJ zc(H6OxtMk+udpSi-V%5xp=JWTK~Fx)Iv3~-dciI4paQ}TdJ8ap3iyZ(eH_-VN=LjP zuflOx`iM*LSOhfUn+Pj`MhtHDpaMd~k1+iJFujz9)Tvw8-$%&)zA&#szv&cw2wA^j z^(jakfpYaBtayNonl&Niq)JTcfo&(nRHm;0wi`;*DmVdq21@IyG#FrqpcEgPFn@@0 zIm)Xjvw@v}a^GPLqJg~$<%DXC{z04BC`AwPXBOmsoIv)YDD@9dm|8#=_aF5ekT9>w z22{(d*!mj6%i?|yY`TK%;{Fu0aX=UM7b83?%8S_kiLeV~v=mv~Z&95l4Rmq;B!u=r z7xzQR$OOr?3c{~0cz8S|%HsYc%qIZ1xF0N2u}>IKuT}1&hzg&X-BB1lTV94D^-Z{9$^Sd{(T?ur4_c6i; zqR9MiJHijZhu<8B4^o&bvbet^gwLW_WRQOqHdji4(SZNBvf|~w z>9VY*OZxd|@Qe>0x}<*-)>DBl=`TZg3FwmkdA@`KBMxCn|1+{T0-bsUlQJeqVdo30 zPXeo5*zW))YTl;=D|g>W>NQ{OvZSA&k^6}a$jftAI4d3$*e zpmVYw@h++>1@BG%B?qPKqOq7<0kmR*nKeNQX9}s9U&Kdt*Dcu30H$z4k8H)5R7)R4 zCREiS9?!`p>zs_9JPPH;bFwMAitp-&b^Pb=XFc2((@Yu_Kl=iS_YrRnu**>vAUp+h zQWebe4|c5U*YTHNy9nq;2K#hupS$-zhPQ6yo7k@eCYt5>gt@fN@J&(UxvW7^oA*qF zRdbY2vHk$qjwtPGB}@~bQ~W)?1gj4AG(XpyLH-1whexnUnhPjY>icX8Rw^5@c@LPv zvZrM0JN3tDS>;-6rTxj0`7qzG0$(|2o1*_f>JCb7Ithk7P%0il(*pKPlr9Jzfzs{d z_bRK1(pq|Yx)+gu0nl0uHY`Sa>)cx?st`n}kHvm8FwuoMO$DaWO!mC+y5#{*J%o8n zc+Et)3G-`#eGp|e!W%$&-Qf?Pl=)P6b@#k}BL6#}yn+p1S@G7nd-u7(>mTe706s=o z>ezPcH~%H}j|91BGDMz7IixoG3E0h&r<0x2bXa_dm0h1b=!=yLavOl@H6(vs3?q{Dyy{&=ASrqoSF#H(husZUoW0Wr? z2jO&}4Bw6!ju(cfdWJWUe;v?z3pSC-O6(qf!uE&2_I~W|1t$8vcS%;`#J1=cV&6!R z8>c|zHx&6=!DGPwgK|t=Mhie$eHXJ@Aguo5Sxq2+9MF0THj!D0jWD@_g0g;h9vd#{mMANwA4b zL4U_&e_+xQo2Gyp!Ac!@dd08kLwc-3ae6|Se1g&k5(6e>f!bOUMu=ol;ba7&T*4nFZ1>kw>MGAFtq%4?&uSw1R{>=eYzj<}a!)}m2%@ZJVSfkU!)2vdjic60(P_l~ z0#;uNtDY$GGVuq1JsV{u!fQZT-5#?N2iw`R+D!g>psa#TfeBJBtJQ(k4(zuB6W!2P z_I~yfg6>zngs{Sg<0%da*CDUc*Ei%2Q}^TlC(vPPaifGO2Qq3a!_=eD>H!_5_C`1r z=rHvMUvR?gmxA{uAEsO#rjEwsa-f?M%&ZAg?lARE@sVNb4D6=^Q}{s6xyq#0`6x0> zU4=2{jND5HGE5ES`e7==DjIzlq^3^HDIj@cP663*?pfX>zHs11JB>!L>t_4oiD`rW zKA;GD1sQW7I~&+ZC{H0g0d$NTTv7))+mrk`VhOg3fYwm3&&2k*qq9W>)EasV`!|7! zmU&L`yvy+|T-n7n0=<>ATQ{f3b%fn+yY>0nvwgZ;cPN4?a#qEbdLP+-6W#5#5({DJiy6GE^*MRwP^pLW z^D6v)A4IPqYdj_P1BvM7J&T*W#2J$>%jhsQs+2so@kRW&HqOE?G(2si}D|2 zo({?NcVkwF(y}e4KwlEI_#|g$P2NB@WJ97#-CN);&xg&#W-8F8rLp&KWPJRkPq3>k^Y^I?*rC;ua`t_k$y-xT2} zKrbxMhh2x!EjN>Q2g+%rpD2d%eAx2{@`^hhBV6D&+L$24=V+b}8%qH?MtB?hRY1?t z!7}e4pZFZT4%@Xr&(U8Zd@hQdqjw?&Cv2f>o(!%|Yo z@_bmi4p0aBd{_f-$4$si*p`h3_+X#WNJeArhAp8{bNn!vw3 zAEqmX!@D|OxJY5E5*4q!gWVFp^}MhnrvVDn#layceSt0{euD6pD6&%6<#-mOKt@ZE zmBOdco&dU1_%gzaKvxPw$jAgqsLGF3zxSn9WTkKm=AQz$QWz{#u}?T};&bS&_{d7( z57>VPbfxfjgxx?_3T-D+fqQCqw%=%ayEBRUaitri1Q|M3#-8o(r?MDKsI! z5y+^sJhj^e?L?sMp%=nwfZri9Xr1eWrD7>utG4TllDGN5L-05oXnPDUnS)$n64SB0 z4rqIP7U4-zq&}GRU8#U7N0;kpxYYEm_O%kYYp-b2N`viZEb?q z0BEe92t9xVt3l@XacgQQ!L}s7lVGyKbv{<-0X;DWGaEbPju<}_A6<~d{z@r5dM;<^ zz(B#hO3N)swjt1j+u`#Ejcyv&Q-Ll>&PKQk=z?VAOQ7ozX8z6UPm=uzP*%Z&dxyPo z?ttceVkoQkuwM;KRI9IUxrtBL?s=3(n_zOapAOfPy5V;eN0t4YjLo=i1olUipAdck z`r_^2l0L}Ue(8qYe`2~9DBWOQ5S!=Htw=njn>>+Nz(fy~oT2+lG^we6r^yOxXWV4= zE(3>cK3!H&&(d^vQ}pgr-Db;Zq_DBCDm`1eN2(9^Jw0#Lkg8srD0}8i$jBqr)gV#? z^pWa;2)#wA!hCW%!u3EOsXjhFS1h1}h)1ehO9}Ew^;6h93^J0Vk5unOTMzV+>KA)B zZrpD~e*8%Fq|U7IfsCZON2*`*mfD=$ZKH&`%t!v$N2*uoD){&Z+5Z&tE0pX+lshPR z2Cy?wRwBFtbVl&D@67Yn!Ty+VPt|TC{|lhIG1#O{kV4NU3oW0?cFVEw2ll@M78XnH zMt4_a(HvrLg4Og{5SfdTC&Lq9pGJ{OjzvIOeePLVvjYeFlV??re7QEKtb$F_1Sz+1 zjUFkW*fJJ+HJn*q=SG zdF0;*lvl7RFhR=Yl_rStdIS3vz(fs7^V+Hlo{csWy__Ebw=nLvRycl2h79dK1onHB zZ3tfhodN`x^g+&cyXU(L+Z{mp2K$28K9}#(!1r(L_X88P^qfldDMf8yQg{}hHo6O1 z9Yo>i%m8}|%Hary0jM z|8Y4?2K6^kMyl1xxPpQ&2euK)bqG^{?uy`&e~`0XlW_gzZP?xdbXNrXbZnn{pmipo zZvK7P&jBWC?KuUux*(7m=v%2wO0U96`;VpWDG2E`XZU=1c5ar-caPp(?<-{%-R6?u z=pXEjpZqQBW5!ozvL&0MN)Iszq~=G=ralfsc>$h}0(&G%J-V(+K=(jH-$&=0q0$C^ zPq^n4CX;^^&qQ$}8AJCP=xXgI@x#r?Gz$m}qNhUamVYI)mts z5#|BmbtcLx%ohWD5lU;0v?GD?8Xog{S9ty5dCesMW}v)+4dYgCoy+Tbf@poci2d_` zH-D7o<@%nYu|(fYm}BNZj;*Yudz0pazh=QWZ1D}nL~HjxQZ zF0aE0qP!l$elFm7t&+!e{4~eiL@zv>r!PLPbpuB=jWP+5->!rZ!66`Mq-0xqKmt1yX?zf289SPF!UWhD1nT+vRVBbMmi|{s3 zR`1E?{Xf3W1YW1=`~Ukq=REhhk9)`gUTg1tor5WOXw(cI!eZ(ADyAN7hY+%$vz^*2}BzzzI+UGE$UZ+ z@N1ZdAs&$U&34dP&2pWcUtntaC~CV9Oh@HeiIXAD0*LuQyEGpq?_ZI_?Jh6xqWcce z688G}v3~OIQjG*PU!S7?2{6$odv?IlXq&H0S~@&_vUYR~(PRjC6P;OY7cOf}=ecm{ zRH0ZFG_ARodz?xW35k*`PNv@rfE(NW972R zXuW6qGAD%_Ja?S+gkR%{Y;Ct)$F-s zHG3{u&7KeRl(jurJ<~F2tywQPMh{lca%x)5UUZCBrk9+W9;|*j(1X?X@ar5avDNJ7 zASjl8$kvM`fjwm{<49Xp43cvBfw5&FqdO~S+?bQYSow9aoKam)4rArxVmY&&oE*l= z=f-m89XUCSm9L5AjQ?|T7?rzg!B{&dgHf3&u1fJ+=jkqU3NY4qyI9VEC?|)p@}9Ar zfk{pdW98Szas~)FIgFK$iRIj=b8;9fe>s+O!_3KHto)-`&aEpahf%r9{H~-7MrEe# zB%bLD$7pxAy{hdWCsoy6-2@XVz3-35jtTUgng4J<*a+jB{v23cfmDd9V#|%GV5(#6@!0(w=XVA4aE~63Jv2@-N7*#P$wBs8$%wq# zww$D7Z(a|pwt;8`^suUrmNK4lE*pPXwG*m#OI=g!;!@<{uQ+X&;?qIpGoElMb|KcW zKvV1qaVpRheYEgj27HRWQ9U1UJXR{wfLi`~H?=m8vBWi-4|F?Ni5E;CvMpWTk4uljzAx)kbvIgRDq& zrK;IEjPro5RE3Rw%$t$ND^>H5&jnctwJTK>ou;2@>cx!?uVdr?$4XV|dbv{9e8~1m zZJ)>}aiUjH(({?*>i);1^d`{N{dVWl(1EV*KMZlVFnSIcVhhNs6C} zFNNp>TwaI9d0i%X{iNiir(Ishqx1;Syn3~i5w$p(DafA!S&b}teHrcrplL0KSOz39 zS>1m=u1%jxVr$cjB{5mu-+-OPxV3%=<0q6L=n){{hhvvn7_p{x4K`BxE@fiyh>y|F!V7-CNKf4tRl=b19y(>T0#g9OW*WtnTlNn=-XyVx4)`h0E&x z!5VH?_nXzXS<}`1GIwR%>b`vD^(NQvM5f|V6!jHB^{1y%cCuSM2}kY&x?5baH%pqr z$ZqkyFgJj##*y9PdVN@H0J+`b5pcHy-7TKvQsE3GsmN~epZI8ZizP&Ni=RRJX`s8s zb0KB{w_AK2O8elL?iQ~j{6kTc-Qx5GI0f|cuD9-MbIU^ok`AAD9sMj~`7COEbZUw2 zE|?P`x`V8!>E~T9fIAcD=UtzU&3MXRTt4r*X(~pfm5f1sG|&s|6+@GwaGsyk$JG)? zTFJBMKLbqku1mu&N6P9*P1$K)S?=@jq~xJ*FpwumD+640K~Yo-6C zA9rDIpt}fYPq_kOxiHdGu7~&(@Y5amPhFMbvpZ5u?7)wZiYq(tf1~yr&>i^gan*Yt zy?6)y;0qa~0o{Qg3~?pMii+;QPllTSbO(MF#5;grpEZ;;hq~Q{%aHd4y0+zY@=fKVZ9S@mVXa5^pfdvS zw&%S&ib-~DtCSS$5p9|H(g0>G>SI9I8s-^@r-Ax1!ub-Kc0>q=IbY@>e+g*)_Bv_f zsbmK>%lows{m%fkXYc-&+Cu>rbtd(rNT$zoxN;=SR@66x@FbW@7jYGU`t^kKD_<1P1Gmmc(3hwe zfUrNzAc%oL*Z6#t{C`CbZ+8CPhVCsu{q_14V*RAQyS%>-pg#(jf{o56X`I}y7E;Ap z*GIt5KO8tw++2)c5;6VO;fuw zEz4T zJ=qY-+~g9IbBy;9hx@CZWAq=k)`tgt0`azv+xO8erJ~Q@mwhh2TtAcCd<}CQ$qfYI zc9=&X#sID1wVexj8X>&SU5c5=rvuHG*U2}YN_OMTNksFt6#d13mzV8X!|l3zMjrE% zpDePTO(Zg=3$0N_=Ywoy5g3hTV3gvmC3^0X*Vme&@l^WZWT@&3s8(CbdyWKMP0OXef&5+m0H#tgO(+l+%zG;RYKz|f4(fmKLVq5U{@2-GjH6B$n>3wjKRs9(L& zKOdOr(55!Ct^!4)T^F~O)W0Q}qi5mDmoS4-zZ`@=z$}AU2-L3$v0oLA!LNIrU;A9j zEdZ!rUMDi1O8V7;MAWa==(hwW>eh5Gziby*w42mxlFWMX%dFyg3Di4+up-PO5F>&5 zH81w7llV2#`L!PTCqVu3I+5{I(yyi7uYb`03-H;cz5TL7@S@tJ-i>6gc@bC2V5(k5 zUjV`uFc(3b1Jth%V!sB6U-vn`#v>mK)Gx2Y3)`G_(ywz#M9XU?`ZEAeQSIrMZ7@Y0 zNP8HG)O-m?4ue^Q@;nfBhuH?P1*lh>;&kp1ukLqVW%{#z3G`;}b<$=GIx;BS^T9qT8{@hKA2a-4|%V}OlFmw@k3?UOn;QtMvF!~I{z zso^lwP@W1(M#5418nue%kuT8x@aYDm<=#$N3jK+oDqAYEcnW; zp6Ma$XWSB(Y>1ss6v|bua%O=GmkqHiY`DC{rIwpa$$r>fHrN(;!9T7S)!nTsF2B;H z&ai5BbIkW^B6uq)xXxWg5qy~t6kOz-*Zr`I_OrzyTE3em+w#6%zi!Exo+1q=1eFTs za2@2d_Cktu9?;X;A3>}FSyhwM+P}j64D_^icsXxXgVD9x1@Vfbr_xf){8+1fT9yL! z`(s3@26U~qAw+#p@P><vo>5{tB-x;Q#Rjb3)# z9_zCC*HN*zJ4woXA?5H?Pz zIUtNyv!r$tZwvr!ieT2cno?8?=H_Gh*vdPo)q|OY%ELexFfXZLFFfPC(R z5YPq858N<-ZxkXAItPKq>N}K?FUU%$UBF!LG_`YjMo0A|HQ%ND9}Af7u~c2coL1dt zk+l(Vqc|w3v4A=eA5gxPw5|fWgt-l3gD~=@gI>cpi~w{Aa}~s5kX0+Pgn8g_9)$$< zRR$1;0bRoMNk+y~wsw>J+ZFo1f<;-vyae@&fL+4$nwdC`A50Qwp2U$Q%z@}%4Ri_f zW{6=xmoP^`+z0Fu<|i)GoU)Qkud3R39+6}T^GS3j0$tYgYAIEV=fv}o&jDGDEX#VU z;NAyzVhphs@Y5yC&s|~}jmZN&Hv=)~MBX8#o>cB1OdOwNE#%sW7|6GkTH zS3+D2Twec<^EyxR`bkO2e3#dWC_M%=uU;)>L@iEc8uFi&)-wl;l-BqsNcpV0aN=sm=%g>i)Bo$N}9BU6LCTiAU9EEYD_G)z3Q(-D*| zVXh&ey07AoEMXR-T^Z;SW&?ecD!_XLaq5_dRld|&34Fpayjlv@jCxwt3?l=~9(0-#HngCGV1UBdKHNOiBsehKq7 zRBr+5u2-rMt0&!k$-Dai`lEn}%AM6c3(;hjxEdl$nBNf1-;A5Niz!Q(e`>g0!VK%% zi=j)H54mzpEMflT;)UifDeAJI`df=ByQAqf7vjkOfUajgdMl@ffi7X*a~nf)kkvS{ zggNwf-u?n|OPCGs2uvB!CCpkitrwg~??UES!hB6SE`8udLUal9ShSA@x`cTq#Hqk7 zVNOA*6^`i=<_N;C6-8OX+zjyz&?U^WeQi1^vqREh3G(AI^xo`%kAz`vGOI(_YIojdt&WULUU`EUOTkf$+b%_VyV!XO!`t&tm@ijLC?mv zxa_Ep1Gmnnc+rv@l>H0~BPe;AwrT@kz6D)zab2qFtT)Kn3y2;kS0h2N0H(%W^i&`# zYT+_ME`&P+Jp52GAGj``BS@$6a0%P0pSzuE-7QE!3Av z{O4glfLI0e2K5!hm%!dLTF1V4%Dst;@55C7OsvVxYCHNr0=;K=#n5=lM~OT0KhfO< z^q!G_H`NSiKVBW81d#7H8`6{X0$5T~Y=|m3(_RxMebi0bataf>=FhSV}(i3Z~KLg#<06%>$?NXNn3rddi z!(5Kd7FLuhB}H~2QTj+S?McRKa^iHaIB}6(h3=I=i)<*wO~S}+b|l0I!24W&C%?~> z+fr&`{p8H11R{T0BBZHouRzQJS|VOO^RI}}7*`@o(OnF*FYx-=Sl^F-q(mN<>`D7u zh5q}%6fAT8xOQkN%d=89x@_{{El2%pgJ3<^(AZxEb^{4}5&1ouGP z3bLZ28w7LVW&+(H*a)#6@QeIVKd#R^S^syxqI((f&&9;4ONcodrt-ab0mA>m91YPy z0%T~j)47$W5yCd^Dh)$^JyPKxV^ zwncn-0cINNQ$e^8=2eJ!Kz%86)8x?nBKhCn`LY7}+dylK*GU^sC5Hzec)zxz|06I_ z*JgY9Wv3EF%Skf#g$bsW+b;0qJ*ErG=QlK)UR^qSH4CF+d99xAU_hQUtXtz z@l?{U%Sc4a>oWBF0TZ3Rw_k39U@NJ2b_x1NOq#ukTR$MUo~VOCxC`cPh`WHcJRc?h zUy;KDoWJAHeHf^}UcW-DpY*pj397$Oqdys#g1*it+wz(<$AQZ3p6SkunMLAe8w4*A zV-^TI!z_hZ4Ae~@CGTI6!|HBT`U7-ViN181UZ1@wmsrwGb#Vi_UjTkZ-AJ#9i`w}u z5K{t#SHU#AkB1mQI25KQ#EC$?nCraA*9hT$F7MYOzY3@~UZ;ZbRMMM;B%=Ah8~wY0 ziN4*l3A#7mH)3@DrAv;f4E}|Uf~u?ECNr{WQc=D%qMIe-F!B({s*Y@yyZ|>1gtA%k z3B)R(Goq|30P3n3+>yQ?dpg$p1C<>>v*6W2Onpne_c{NlkG z@vF1*Ybf&TfcoWiBIBv#7`U87)UQeC{}1r_jJ^GGJ!(Hve~M&262Gp1nT`5%5Z(xr z9nGu)M*Zp?`}KzSb*S^}1ayuA>X+AvjHi-*E%1H~K>rHB5OQz7+@#`?>SHS~33IfzGuM?RZ#YN;N*RdywXnB>PUkZ4$ z)SiC1&SENQ|0Rhm$B`K@2cX;xg!5tUgt!r?SMu&W`SFx>HzFMFyjqU@O`u+Rok-ub zC)&xDw#9q(Bl=qbA7|OqE1v7sS$@$wq~4Td9udD*z@#2zcukaWEzFTH9f0~ZJND}s z@#_fZ*A>Vw1?rdAiA;_X?`&z^N+McXx1xVDU>vchU-qj8Mc;iu2TCI4@8QUgFb|?U z5`?>97C|fo>Q%c^TUre@LU^R}Y6bG;Ku0uQr;)h~qjKFUVpu&{ht6k!eI#cnZhv;) ztyz}N(98U*Sz}th`h|DlM9!9iM$oIe`R0d zQ5P)x5@j~nZaQXsxk+z&u$9=Y2;ZfN;FN@*ppwh9?l?5v&z8WRI}Qa4-Oc30{qSkK zW2DcY=a$#XY4V`vLYTjV?jrUHDxBeHXrc80dKS#DzZp)6G3` zp-*XacZ@!zae`CRr!-DT+Z^?_?#2U$ziNq&eT{rXLoXP7%P{vEmqDMnw%U) z}u&t(e67Kn_7t(-A-P7Y(`_r`KYzd1RKl~0f5 zOiFWd7%N{M%b6(V?k)(Eqnr#zWu~|(J+XD3{x+uoV~ux-<&5=m zau_S`7t0xQ<>W9{J|dPg_Q}a%tbA%LXAF{)!&vz{v7FIBP7Y(`-^Ft7$~ifVmCHTM z=8yYhP7b4TS2#x{WiTo;+$3x5n+(!t8(0!^>!I}pB#NSkV{{81kks;4#aM}0=9 zt$yxcyRErejegZ9f=u}u7PP{}YOL}{zUnV-FCQCeYQHaXoEWY*l)gG#(p-G4cmF;@ zAE9&~ya<Sh){l{}xFMiBt;It2zqG{E7h+7Y+Kka*#OPsoisg5pUIJGdCk48&Wn}hI8m_r~A z1T|N~yzk<&-^q#GRKxTrQVP~1>5fVl5Nw7y58@n9MV1qNoG_*eTzaXh>GLH1(P&+Q z`b9t&%mzXX5Jncv?uNJnm^$*>($8ZLwu%Qe()yOt$B|D2`j*n^5YI{kQ}CA49@UKT z*l&&*1|uVwYs8K6^2U_oIK4!l;Y`!ZFNAG2zZO;C@3XSDvyM{St$Rv5 zV^)#A{DKK1*8Ae_*jBVxkoauSNxR;TM@p=&W7zcoXJ1Jd*r`nF{!6ek!0}oW4%M3Q zDg1k&MIIxM@Gz~4l^3!H#Rt)mnX~K6CjqdOv~|TD#BGM=vXl^vjU!!zw0 zKFSc60v#B8m3%W26&V;eTEk_LNqRGMngAw%&W;-x+Y3>A7K*mMpIud2rmgR1SJg&V zd|fO(Khe<6w+*fOlO$H~sn5=>nw@Br+QD{Xi!~UWHGQI_2c5&O@ZAr9B?~M}R4~G~pgE`(1+JBR=y*H9`w> z3W`qx>(>Y^)FtqXfciDS*~l1)9*(dtI{5_g2SEMuDp}*Hq+iWRQT^JC{}y9FA}#~!o>$2?om0o~2^2J(%k zys2=sb^8od<*gIywpXeUt0znK7E;$z?SpC%KICSs2l~yy!3V^q^Y>SyA<3jsqapsjqHv+Q{2n=g2a%L>^Fd z@j4QbJ=~EbFal_{yjo~HC2q=344x@*#OVLfpCFDEY)o7YlR4F;QphoaVJJ)W8N}T0 z;Y9e@MEFVp0d5?sQU_8yDW{&c8Eo@(?73CSO#nW;< z%sB^8ZNpY_8!P+VkGfj55NmGG(k8u#lx-*8CN1|L9Z#5udv$Q04 z#^X*HKFOsBdhqXLg8NQoED+W^>_+v$bhiJvrO*AsJ5#TfWU2{?)B-iXXTPw!Q#Ym- zLz%FC`YN=8-(?>am0my>l1_1I9DqPAuQaqf#(WA9Z8xsD=rR}nI{ACThLh!rQmHttjp z^?FUHbcIcd6f8Xi&H9!0QH@!W(KzGzN4-#F-Lx^tss4lKN^?xe$}la9Mg*AuEC zcuWoO$s76ko%dkEEm+a2o_ef-&<}BGM}aER42@IIQN9_bCKe7v+crhipOzYNaz&?K zhf8g0jbLU{eg);8dRQG^C=N?oPd!{NN!iw!8kcLG(5`j9K`lt#FU@6uYb|6{f5C(k zzw$2M-$d-ZOxiC1ZJnw6+e_rCB$w6xCM@H@a|!<>l}c*KhW0cbwZP))K9%l8L=y^^Jesi0aNg@GwNFB2**n6Y>c*Vozq;nw9dn9 zxNV&a6N0#Pb}gg1qy|Y<8h*P?{&oA0j%vv_z9@kQu7RW5W;bg3<>$sQ`vU!JLl=l6 zg^|xTTmsQY82N02mt@6QD4%T@gJ>kkeYRmf+#H~vZP*3z8?evdI$zkuBD#FG;VyNC zH#QeM#x{^ZBzlmoDqIQBgKYak)B|*jjqb1oBxtuO7qt)#S%BDwaUg)CL1F4oePS8-npY-#t?(jE){ zAkfmD>&zN6PD;C9rJJ#;r7bVxo(iDeZDX>w&Bo)6zZ# zt}Dou_H}RrftL0hh!=sD_6N=v_8DDi|F%(_p|syd=S`3miI(SRM!A15|RbF2G9Va z9^e<9=2H5vlPd+SoX}p%LFlKt$faB~TH>+;pf+UEelF`2wh!*oQZFUu+XLHhj@L^$ z68>gjFK;&uTM7TR=*c=ws=J1zCh?*L8%6^=Q7`#HgtZ05`)_jd+Efo+D%2qnwB8zu zPl}~I6VjemTKyvKJloLFX?p5xonoAb(e6N}7=($PKJe!OoejP8fX!>3k?3gX`1^Xq z*8=U>yh^_Dl)uNwu;Wuw)Q;^w^zQ{GN6zb@fr= zjsw=!bJW#o@Kb@#hP(k@L%Wx$)H&AeIjFu2)NQX+Ay!Y0mPV1fy1f|v*8vBlomKBP zqh@9~(&fGHDugkIOCgAX)%gk~G4H9+3RW&r|+xD-CkD7?lRul^DkXJ34;MfwR4YVoSiE9RWu}aNo`3)l}lRdu&MOhQhYxxqob|x(Jg_gjbjAV z7IFGr?k3T>nSDf1w}!l_8tMRN#LL|4QzWmnx#+DoIur8+>6mXQUb>k za64!%!=dQAJngP)PUfLV0t@A?9er;Dw-dMw6pq`Mz^!=|B>DqS@klW!?8-qI;-`}EZO!bpUU>#b8ve+E8vR*$(0wY18tTs!ac)yTYNO-S zW=Lw;OwnAQ+K;Gh2AZ1Jj>&x8OmlfhmrA*OE@5>J)t?#xGU$W1V8IW0;@MY|tsg;>bkAyET?=6i!|8HN) zD3?dM1z*x%iii?4pNlU|GDW}r#DeH_M8PZkX+iqsAS>eVO+rqC>k7gTV8%d<0QquS zdW5sZ!BUhf&Q7QA!j@L+<>)LCJy~S+dZEduRY>E!T=b-I{)EmCz!XeQRMUcv1FV8%a^dd#Rx^j?namN+q{Lg3ix-{k!X;jOxj5599Nd%I zv&a>3j;d%KGEtRG(J4Q>nv^$%8z{n$oS31Ibgnfr zMTh>v75D`a=O|OA6dScbR>WaNLfXQ$0AVedQz5zoy#l|*wn|a1I5nNlVoR^UmFQds zbg1d|LgOja^(R+jx8z5z#x3X%2d3cO#MLmF^)8ur$-}-RAi1J5jJ&b`yCAE(+DLEj zsERJ(sCK4kyf`aO@;(y17id9_gLoK34gb3;y7%FRywo`rwEwnq(lpJmzyclx2|JiFrmNYv9}$pw{?kJ8(41%6mOdo z&e6?fvd%YT2P~ ze8%=5EuFDWy`jGm{Xs-05cN2a70I2!B!b$9&++$K0xt*QJeWrz9srr6oTVE3@rng( zND1Y)H<>eBc-Vxc7Z=XlAT!W~e?{HBG7guO`wAwKDM9`)Q&8@Td>@RuYB=1*i;Sn@ zD*kg`_A~Kbn$IivGzVz&Sq$+yh(@}|dsT7HM`%AZ#)+xHQW`t*vTy&63F(Jc5&b=} zC;id45MP3ZMc)v zr6kWJ<M}DB)3D{3QXSH_+VVVsppQW?9Fwgm5I5JP`jT9BS9wLmlH+u8d50|DqU3Bh4&!b zh1rgCrt6>B8r!>b+dq?S&G=u-;t`CG1zHwQLOc$l1^?Z-F;CWVUh2e*s`j?sE|b02 z+kPHX&w1OgK+F-_tN+_JOXZb&kmJu{+n$P_Fl?VG3@$=tDP|Uf@EVv^5buG^S1w{- zN@4>p_!9cjg(pkM)cS!*Zt0aWj-Q?vw4~_6vfXZSIX$m|PA=sr4AM5zyXi~FqZxMI zmENE07d`Ko)9^2v>6nbnooD6gffqY6Mbgs;wN_b z+0pxXiP;g1q-=`ch~=yD64PuLEB`8%f1H%VSb2(!*=hRPq25i7ulc-PWZHprfv#fDOY*fIOJQ1u@UG| z>FCnD;HbwX?Thjbnqf<*`VJOT23I6nyL}KGnOD-9ME9A)=mJzfhLV`_7p~}Zw|kzR zMrw>?Utn+Z1WFm6LBJ_M2PL;XW3A^IF%Y4mcY*7W4+MH^_d5B;Q^`TeXcE;s!btS* z0gRQWTciGtU?=1~NubN$-oq2DhvSJb7FZ7n6c1k|U@lM(A9Wt)8!-@}q8@&L{C%Jv zdYuZ!Q^~3Y8FwvKLd8mVr>KBs0me|7+t%tu6;b&kyBv3r8K9^|$P!DIs z9*Tho74@(s@@7Ci^g0!cr;;9i*1+H=nkxh z1d4~Z5ik^}hxbjh7bMS!fe01#a5C~qKt1$2`Hb?dcJe9@CQ&WJSJ0mWOjP!qRon9_ z-$DYdq;hLLJl}fw77-Q$>mh;S;bsE90qWsomu9{Z0}(3f;XlZC1NG4BR4|@OmSIg2 zRS&DY!onsn(HVPrI8+>NH`gWA#JX?3i@oh-y)7ehDX`uWDBiXqpcT-;u{V*=tioFH z#v;_!^G@h?0P4Bd;-N^VpY;3#?|B#Wj|IGS)~WfjwO9WFy2Y`9FWU=jcYih!P6gIm z0>#@21Uv+6**;}`9=g;W;2slXetTiNF z-Hcf7&y;DDzgJzgL;3z3D>(US8^f4eWZANFUX{`avqKTp<0c|ElHhKb*CED$3bT2a zgK@sF?!Wd;p~hnHrtC&BDDR-S9;Iu6zJp>E#JwOZTKXc2=isIS_a=%euKZyg zRb+iP(csD#hS-#imN$v81n5SKS4{mYO1wU}8r_vZ7wbNUSSO5ZwEO_^9UvRB(bL{F zr<6HRvT;M@RX)iI3#jNo7Y4mrq-t?8`y#IkvJzR-Y7ch+(6o9&bO-!09bI`1Vl?s{ zX}EfpY50uIu7n5FBMGOjMaR1O7thucugTCif1MOxfTP9pBlBv_kZLGz{<@nq?*Lhm z=$pUhz&!@^&0lA^m>iHn9>4jk%|e!XKvqKa&0pOvcAAem$GGV=Io3HWj_OU2Ih~Ai zR>%I_Fa8{oSFv*;{yc@~9IPG%f|)QsK)fT&0+?rBypqWEpPWUg2I5~X#bSX5Ajuc$DvJ~oddAB8ag5c~@W zYr^z-gP|VKE^Pht_R6PBM_JAPC2dzArXimKw3GEZWY=jYJK6RmqTSgd^cMnCkeO+X zN_U3e9jM|fr`jN%2b6R^Ojn#D@s3Bdf;h`SRwUtRglvJ^0P3uxXnf4H#@wetVX&3Z zx{K+5fY_HNw9(l&rnlJtG+k6RgMDeX2cXs(XdCi+9EU|OZbQc-KNe&qRNK%+aOVMS zLytg=20pc&acV;)wa?NexBAppptcNXYF>}6)nsZLk#7K53Dwm8gxd);wVF#VK&b-DF)DDc1614!`|#}to#AgZ01ew>cFTo$HlRBNUV?36^ko4XKJEU z1T@wW5S>A$yNe)s+)e_T&%GRqh9{K%OM%@SGPpEOyQYjNH>WEOlC;|)I+LV&O4^6P zTmjJ^MDOoy_L*EkWW#>Fe5stGg{WE<0qx1WR)ttU*^{M6PS~~+um$2f5c#y@TDC_iT)S5(WOlkcS?@+1|G=`lC1>*84WKLG z({th7>bvlzaTr&SC!xEwcY@FN5VSFwA#QvoDg5Sy3_3F-UAUyMPhmVr=r+ZLH;%(> z3QZO`fh`~jY{M1EYfm@b&53wq!chfsb@)XM^NL1dNq17sTP)R6NZOtYVJZM^&$S_{ z1Ctr=3Z(qhl$qmP(6@6i07wO=FkVgtXUMu==1r$5$M08JO+HU58)7%QVZ(cEQfBvm z*pRo6tBr!oT`wi66>M}&{vjzg-KNb&8HIQ8Yw;w+_O^Md;|EF2d)O8hd^xw4e z3ln8FA=7prKQp;FPq#!4q(BY;c4k7L%uKova5T_{;Z5WjPkCbz>N-p5gYJ1i8-~}) zkM)xcqc#p`!?+&(!GQM_Igi~uDjI#4ZXQ-2O=I{d_V+UD?^vST3aq~biofmO<`pVH zhava663&=4(wb0FA15Lo57bAmlQo`7&ZA%RKE8y$ydB0wAMG_uwW}qYNZ^J_zC`<5 z50?>PA+R12C?2+WhqGBgJv`YBg?YJNU2LPG9^QofYM^sHuM?S0=*V2JCkbiEy@bvT zU8$nP?Lv=hLMH$5Jj4zF+e1s@JukuhyQ3mu= zi7^G}SpH>*7lEeeqvge>ya7M1e;w7=0Nwa^lljX}p4A$QZOTv{C@=+AJ#7WDu#lPR zm<~)`SE*KyaP-V!4BZNfZXWJ_u&2l?)>k@Zndfe?CZo~gDt6^@bA4pp`PPikYFvZQvVxA_dI74%6|jm%ib$RzuAYcuh7l7bnoi?Ht?Il3Y> z>&>)o%LFnGsm-GKo9Wv1D6(q0CjVwy57kwZr{a+uERWn&>qCh}Z>4JsQ{xH~y_42$ z7`rC^Q#vS?DWly8Vc;ZM_PipDG#1YN>8c~s!<-C8W#+h0`s`QJfee$ypI6hR>W?1s zdo|tSF1cRE^_QkKD;>zNT(oAT>xfou+?kbbCZsuTGl@l0)4@GXXR5Vi%Bs-VqRVxM zW5AnYjzs`*j9)NeN&~mUae2Ct>~MTQ1$q}$J(x;PtOLZ)e+bwObcf^e^pUc|QFl2? z;0Qgqccm?qkQ!n4CkEL4i8IkSTD0`k;Z-&;96f1RLp^bLwGVh^m_07|MA|H~u2sLh zoYC99^hdh2FeI&83$I~o0Vp0`)ff65>D+g6BN#2%;z_am&ZHbh<<--Tj9E~JDVscU z9^I3!+LC17!}2>oj}X82mUV=EKu5*nuY1z9J6EH{%EW6U`d#? zYPG0=A5#(ih0YET%!WDOeR?X86}50NA@{-E0m79q^0}iIg;@(D@5d?;dcRj zZRkmHJ{mSA`c=U`!LJvm%mU;u1AT4i_Yhx!tf=T~L#waib- z)`vmx2Fzg)?S)wma}7jakd-*$Cxk47n+>ok#|tiUp7M~1Se+JBTP{}RNWo^bzLmHl z(Q^gA!u<^NTtVssj0jBrtrzkwd1uI&cf`=Fpk#*_dJs`vwB&tTrowTjrObyeAAwmT zicj!9#Hc zD*`Q)tKhB#S|~#xZUj`ek1@J0N`DeH`~+qU;dhEG|97h1ly_0$#~OkpkqxqUki{U& z>h2dPtp!0fn4J(m3sWDa)3=2Fpft>$vX@*WnB_8yDn;gZC05JLzX3_A9JnJl3_A)Y4WQ4scl z*$VL$D7qYG9x8{CvG59*h97hK5NI3uIWB-tB;9j@@`}>jv~8S?(y1UTqLK=@tZm{h zf`$Wr6{Jb*yIe@wmEJ8TdIi~v(j2rIe1qQSK$}6{Cqx2S(JPT=V1Jo$&I#!iCgY|Z zOES$)<^N+MUo;Iraf6o4@(wg+{<3&w_lt_pO_}QNS!-mOVMbIfsJC4%Wqm{qNwmHs zo__|3dd0|;ImH(A*cC59ROi}+JY!lR4?ZZYc)Pk9?dMYXnrb92%B);o#l}ykq*tx5 z9vI^(#sm6`?n~P@W3K0tCv9^fCf2209fO_m28x@{AaWP|>NtEy#xgbq4UH z+F10*023YNDuK9WFCU4to9>e8Xj3%BrQX{K*4rnE{5Y`Q5-8rzB48%aLS5`kunX)c z1|0f}P*=|vqWdaP&%IU{>nA-AaX>v^hW^{Y6nyD@)I!adHJz$&xg^ZfBo|vI#Vc7@h9%es? zzCiad4{?zgB4{MHhj|C`;SxdiFegJi0jkIz=8#)sqC#nuYpIi7)$^ ziy#()g5z9V-NLLQQ@4{`NRIL|7`8Jn!CGz-r{6{Q`cWLy>$4N&W^?*#{oZlDJmtJJ zY-`RIH)UIMIbJOjH|5p(Yal)bx}&)XVk5Ax)?fFwkL{^=+&8##J1J!u_Q~6CegQh{ z^NK0sDIX;s_648vSSR{=Wh=tSOM3Lm)`6%2+=k{F*B7MBZ*q}tsQds)R+J=lY2S+@ z6^r?bQhTzZthNurR6B3`7>Fa(w#f`~r6g0TXR+xTQ*@qdVE?sInKz7XeN6|YKPaw`OZH&hTY7622%_CiN7fAgLvE^fC+A1h_Z`KPc0#s@RObQPQ4lB{#ZLrm z0oqac841nZja$l``w{BeQ51c~C=qB!;kDASezK!zjsx0J)J4BG;LwUQyGIvS{ZhPL zAA395dfS2sje+%+K=Jkr0!{(i3Ac^MR>Lt6p`spMhkPJV54}!ka+J-IEWEAo9*#u+ z9$*U2-{by}$#>VMoZD(8CXkf2dx0n~66M{lToL#A%~RZG*mk)_r7Hn#+=Y^rfUX*y zXkTiy|5$i9&1p-$?PC+uSKQp_!ll%1NQ4{btJLR5to7uYz&Iz?HG#5u^(do8IyWBv zKU)MPdG>!WVOvW#H*S<}D0AbdD2uV6svhBNls;GjcMz}z=-jwbx{J(>+pguwNMIjo zYhvfdg9*3{*!gVJbfwmm>_P%&N}wL8d9-rtAI&QLvpq;TPNj zuo3(PQwydV2r4k&ZUfOmnCdXcK^z5iz~F82%0RKXAV}Za2y@cq_eSSjkQIq`{X^jf z0==!wgO~*vFv!TGu5&Il8^zGVApMayv<0nAAS)6zl=mfjN`$DPgJIeLXQ)wZ=vOiH zT9B?LxzwAGgs6e5(Z3X^fu|rIQv;cUU1V9`Xh}5brf zE^tbuA(!)zbdC8TY0~2XxF+Hi_u`7#&L_e{QQi^8JC1c}|1q z0d&mMbdu`x$5V+hPuN5fq&P1?y|=`dG0y;qD?mX@7dJQNInaf0Jjqdh48xe`9IWj% z=E-U0C|u#U*O=$nNg7JNJY{+EcvJRSaZ|=TH{sO{;--vw?t-`j=$L0L#28@5JXN0X zu|4GnFdX7)Dy1v~kf+dp64*mrE((XZ9Oa|LW1bh#eI96)SO76!7+LCC4)Hc{W1cd% zT+LxNxkxuuzJnxlV;(P#RGb_0h_c$=gsF|*_HPhBt8J4xXOhjA+&lh%iO4~%qOZ8`10C};fT#_0%yWZ_#=Xf={~GgjMfW&h z$2@mBHRmFAUcOp2E;e(Pl+2OolIQj#ZTV_dFQWDU`qiq55MzaruU4&uSOWB`Ra2Y= zav~P|SE~xX=41oVuU0jLC=*7$TGavKAfQ8QA3HRjGVT{m&K8L)Qq4|6{RD|G)$AOI zvw&8!%OLszTg_gIeesm9GtpC(M~OA5X4j)X7-%)~ilOn8j}lk2+tIxhXjK>ualbH9 z%_c!i0Ob3QC#>K9b;UE2UAH8o%cZ#Cx~0rFE?h>G>l5LJJ7c0BH23;@bXievr{hPX zew^yNwCdBj94m=z_uDQ?>oXd!;q5EH-qZ+`o7#2)z6W|!^BE~HVjx0AZ)(Ng5DDl$ zrPrxw-atpjbWf0w-f9m(rzJ3%r=5dxtDWaEA#J0FYm9r|g4bYZXbbP{#n#(1Fmw{I z-V!L@K0?4~pkwDVcc z)+ei8a^pE(FYBmEwhHi&WxB?DVoH`l*J9>Vpo@K*AT|mkPgd=K_yw4P+a9+ub@ckG zV`TK2VT8zv(f_?`w!tY&2UJg$?c>K$qVNyOg%`ZGcP$tD*iK8H!&Q}l)Ca0@mv2E-xA&lv=s0>r z(4P2FVLBL26_VdQl$-p53DQXPJr;%OePzI$*~l=6Vl8Z&CCWbON{u;Cy&r*%LE%5m z2&|MYY)9PA1RNrP`sRqrc68g5fbO9BH0s(J*e*O-o|Gy|7fFucIw)XYBhFwhBj$|va^_)Pd=b3M* zCqP@}RRblnGR&wfxk5$jb}i)9fYxoV6Pg^Qk+g*#MWR}__d~xaFa_T`qjDXo)H0QB z=z>g4m0A-#m7K1(N^Hn|sU7j#0=+LC3egGZed&ASZ$Vx~zBx(4Mp>N0=@-> z@{;RlTU6YfHdARc4M_sEdHfXVXk9pKsm{iNyq z*o3FzW$P=lgW7V*y*!sUF1L(I6`lt*?*6JqEPC z&V`r_FeG17Jm5a-5pR7EL%&3gc8VeSn&R7Ny#cgA9`E!Rr=b^rP4O?}KLFjY>G3_| zJCGF>-OC&VHvs6q%{Yh$fFzw}ZhJ{=a!Ur6MYk;pKM1uG8MfA{oz2zgrgwt6Gp~_ z6CoZ0*4z;1YG^#=4;DomgY?hd+$o*`43M1y$L3{?Rx%*>to{G(V8>A0E z(0R9w2tSAgG4~I|Zehe+&8^&nfT?f>Ie$Dh_o5W!CKl{3CAcLD%|I{+=2VEog}D`G zD#TO5jDlGLu}GN5V7`D@3$kJ_`G)xL zeo(7A^J#ETf<3nX*TqHhfSB^z|7+3v0H~?_?f3+;qN1h_hHC+| z$=m>OHIScf|35xTX%m_SM2J=f>06|jWxsO@dJ}=}dwvM9To~E@&-_FQ!(=6nZvUS` zNLS!`lSVGn9IY3ttAlFqidE@NZbIt@kQIscCh`KFJAn2k4?{czsMxaof3Y)UVye*k z%kv^ZiIL_lM*&_S#`6-ZLQ}RfXSzIbQio;`E#oLa2ZCQiVLr&0&DDiYhg*i|lm+#= zi!s?;{SckiVoWzzy<%hcxNDd{)db9j88(i<)huXi(#l2Q$04d&xXP?Jt~|yK9p*%JW#~{F532(^beI$E*BXzHA)vJc z>d;|M)IkOWFA(q?utSHrQ8fu%M!=h*sY8dkQMm+uO~4nx4jty%p+nv;JToJKI&^r| z4jpbG@Fq~0SAx$AB3)sAjezHX9ZzhEg6i)vU>tjxA5Sc{!uG3&Iw<5zEi<)ThL>mS;zFGO=5uvsTivi>On9|3(PYkcflM{y06sg$2C zkNk+vR-oH~UN1DF7cYtILcSAZB~WIHU`TXRHEpusN|~7#M{OY>@4E+06MN5 z3UL$2ikglqAA}nLbX>V0HsdM0)?ai*c7=E%U{9{&%BcQpVlCc0_HsHP__;crYvV2T#N^h5uyLkWBXrWTTF zAbcOD9Yh+IaE2JDilNt{MrR+6A(>(n{!ZZl9eQ0BCpZVac#3g2@-{%nOXDCO09jGd@zOlF zmw=9!)Bx#vqeCb*aZ+nyC`YNi}iF>I|G5$ntC(tQIgPn}sfKD+6K=cI{6ZZF?KYy#HY?{Opd z6yp+Wjwwb@Z|+Yb>=Fxdmn!^&`v6dLjUXBVYc4z9M&?7%j*87O#hC2P9ZZCS#DbXX z0&%o3;@t%hy@8!#)Q-(fmxA-i?QFTfsC zjI(1?4~Qv0#i;%l`%OSi9R<-5WJN_y-2it5&?fT=#EU?Fc8U>S>e)n)DaJ-AW|?BF zNADw`Q;Z6K^Oh^1Q;bd!tw2`d=oI5FxZ%L{Cf_=%+z-SmQ;e2JV^w;SS!m6axFXTs zWFg$EKzozr5X%4+Tc#K-To1^@V~&bPdrUDd5Ti21*hGwt5=*BTOHCmp{rd&FCOa>x;oMqXV=z*u8x}L61v*XSE}jc z<(jCvO4R-}c6yW6*~Ycjep5I_Aj>oyIb+K8qKAhxy z&}UvwiS$7r`||QrokUCEEL)(q=+3iDT9q%**3`g=^8L#z@ zp?zP*^W<ygc0U7HJ6tPO0j z+7fSK=X8|QMGPOK4?|nmZs_95>BG=YVYL8047ILV_dX2Oy|h-mk3+3%w&Ja^jJ?o- zcW-^D70E6se+?$u*cX=JJYAo1rbrD_v1)o4GpFHe($hm~?z>7!=PS9s3yC-C^Qge=u6* zTy-2DCaNQhtB&WET5nC+FFSA~k_WqGZAf>aPCvZ~p8S#;{-aguDt8Kg!GxA4 za4=ji;xDN(VNT~Raw@Q^GrLk+>8~K*QqV4cn~g{hslVIFzun9HC#4NS-o6RxH~tsD-lgZX)FkCf>{l*T$m9szd`&6boBI?v%nh!u@H<5imQkP z89kL69&HfFww%`s&3e&uqo-zwn*eUu-*6*c7#rIvN~3}jeRS#&G!6hdusH|fG>{b) z9oXCjcOB4y&02_$06*R6UlZrhQ%oWB7wt;bm@U4_Xk<50eis`@z*Gr%aS+gfNEt*a zFcppR#Y?>Q{f%~ znu|XnegpEWCAYiMmzlOlucU0hI-Pn@O)JGKsoGL0>_e%qq*_W%uGWWG=pL&5zTO1p zr?hK0ptn@B%_(=&Txu(i>(Jk|6~y)>@27l^If%W?=!H~Jk2(`Bj}v|&RVoRa(qk#l z=vgP<8q1$e)wS}^%aBiSj>{)yv^h>lX^(5~{1Z~P$JHE7NF8G%Rwcoxmy7s}kJu}v z-@B--H`!jPCL*XNAFW2Uz2;t@&+VP6k}Hbdsq$P=T#zh^`+QLhutj0-9amY#)RLE| z9#2^*{QDrHoU%c+ADZTNT(n`|R)ONX%1r#lY z+Nqklw5#{U+Ns9UsoIXHZYnYC>W-V*1JzI2yPpn=8mDv-*4_%6rV_Wp=6hV&{gW5= z!1%&G(h!ddokzR8M};YUmuWRUH&K{s-Hy6cO%Fp9rVf?E5XG`+Vs96$$w;}{Cz@fB zw+j|SaxxfqyI3q$^Pj+0;|V9bV)!S}QnHEu6Ew*s`cH6>B%0RaAVErxgA|`nJnKQ2 zOa(?$DIONfqof=r>0vr4gK-}2Uy6rYoQJZSpciUOkhoA=0=-anu)HNWP-5Dv_Ct`k zYJUXos{Irs2Fp7FH(0JJLy-+GA=%K=gf;~ArAAcK%e^6JEsOlNm23zOlZ5Ob<*T5! zFxG{yf@bP`=@%TikCr%-a_U%3E(!Eixz^;8phM2&(x6e!}2{QE&-V7ofd+m9(Ns*h-%OIZ%;YRdBhJsNLQo)_$&OL<;!L@wp|L0w^N%JT!g zH=EL8sh{JWNx5sP$?-v}T=|R-I^|4G2=w`UTRsy4{Rp`=`Iwd1%uGyX=9y$>ruobq z&7w(kcVNf*@~uft`R>4WS=t!x4q8gRw6AEs&tCQ7-*M8;A|4FvOOFzC+B!4+XZ@Gs3sp8McPze3R>-RI%b%5@{OWu zTcm?-7aS{2q$|{e=@^u3#&o)pFr9*G`-!Ak8BFJ(qKy2~mkV>Ktudx_p_pssQvTYf z+{$%cFGuILx-Y3pg4zci90 z8))CULz{SmX>zmsO1(86{$c57M1Pm+*KNzYCwA*6nvA(S z*neLn3pDY{*WxU{QH){a7fjfEcFLSB?krGunx&{DppzEI&1pceU=tGF^!oR1Rw1DmEt}l9z~12PSi;OII4<6NqVq*&&7(yyVqy zP{U*vII%n%{iYQ&Q%UKw(Xy9KyNo_`I`#=^`(!jvdg=SB^hx?J-Itw3OqmOfMQ04qxscb(Gm}Km&4nIEJQ293?x#r-^3?tR zqwYPxtSXZJ|8u7AxpObWkY>nf00#sWL=;5_!AvkO=pf=^0JEYXAX!kv446<6F}sRk zjfinw17c2?P+4U$CyZ;@{eQl7`kcALz^?1>ec$K#-{+~Bs_yFQ>Qr4F&N=rG_9wue zx_?xmdg}g5LOuZOsr#;3hCX0V-Mzxyex$gtmrtp;@7Xx|m`sZJJx#a1z|!=BC?PYijCh9{+9T>a@4LklW(vP9}!j zxNXGONuO%ZjgMvNbI`d7h99Szn-y16?sQw>ST%tw8BeU9#<@gpcM*+-D1gT&;(yF~ z?ME`56;+7As(T$BZ4EHkv>0GH?2uzd5ts%8E$lStlN6?1$lM?cTLJwrU>Xf={sW!; z*F#{@>!flAm}WtqNkqxyX%Z%-`ViI=uxkkWdkwRJlEYzFBMu?@0Kgs=Nmz10eWpkq zS-(Ioc4R#rp2+~O3iEPwWc?x08Wdw`&*cT-J}d~DH%HLIKPIXkXsXUf&iO#B>Vc-} z?a;RXrs`o{lnc6$Ja=HM>R*X|1hA9#ge3|RjApl=)SgX_ruM7wzYGMKrR%9@*0KCY zPC<9@F}x7pV_s5_8`9uKNz&`$-bKnPNh)sRx%42%M?|ZzQwZMu}WEzsBcOS||L zW%Y`J20&jfp}}W1Vn^uSz~JLgJR-))Cpl8)y?R$5qdgcAB4_rW?@U9 zuK^C1VaoL%Ff1-*%a)_y^F`-=f?9l&7DpXQy>}(%RZ_eR>`CRY1wUKG8n( zL>}bOizV*%K|JZ>v7}q%dNzAgGWB-Ak4U{12=$))bs%2>_M(X-RgI)1ee%ljUts+S zAVa+uX@S7TOY!?y2lvc zv9vyoua&gh;i@EYCrNt%q6f$pK>jV&&r^i-f!Y?xIA6nhJW0;ny#92$x{uZ4FX^%1 zZ9F$;s%nC*@}DX{U2oVEVS|)~BJ37HHPius-69wTawxzM=;yUQmJ&6h^Jr-3LM0!X zA95w1+Y6#&v`Z;j)5)P&czSCJx2V) zfSI*~hquOgZmQgVGHW9wR~N!wf&V2SDEZE_#TSSU{lb$}Ja2g%%6{^%4D-sTS*;eI zX1kS(kztc!@o6n(0)oo69O4yE3`M-E$f63-6|zXovO)2rGMS!UG9|^6Z6pVkr?rIV zNSme08Ip0DBh4Ol)vQ^3k~y=HAiy@ z40j646&|$e$Bxi|KQP^dy~9xJ)z(KGE4;ZhX4AVVG4;bxlxuV(B^pIXCZyc9PY&+@ z(a7(ywUm^`eq+U2p+mB<(iD@*32(gj)mLIHJ`>t%J~A=cSWHkkq!i|lLuH`%YIUWm zKJI9nE|oKI(Zd%kO0U#vKbS5PzR)R-+_pKy66>H^C3mHvmbB9#4=R_oCh9uNUW*)w zyw2XC8H~6KOBv44;Z%FmX+|5BwJY^I!**}Fs=;UMpe#D=t*V=8J4Zp~R~(FnN14oy zML^^PkLp#E}6e`N;(}>MFp$Z|^S8Q*ybW&u4JK9+lFgdc%mq%6` zGot4EbRo|H7qMz7JuV7ANV7XG>L!^%yX#buU;Fza{h5QCZB4xs()LJFZt@;IuJoHs zGsQ3y-cAyJTmOtdRoXm?w%&@tQrad8&kfI}%|;s6f+J(Dz^+g1OPI}3`Cv1xRmEd; zgP^zK+AYS2m#*{YJ8~uB)>~IpscN^KU!v_5uFbTtfY?<>HbLccRAqj+)#R(BGgF=) zZpqr~)wB8G@giwFMmX;~Ugcp7l#*>)saO9@qON@Ju4EgN-irlhN$;|@^yXm1k2F?; zZoQ9-8ePF{ z`5p`y$qbck?Cj3E#WYT01~8pvmljpZ1+$o?MSav{!GN8yDcLbam2xvJW=tFt-7a-c zD{5R!?MHcxdp*)MH02bJ@w-RxSc_#YD)YvUuG%JXQv?AvW6 zq?`qm$$z_tm93AiBLsUOk>4@#KfJ6@U>mCI2;tD7x`=>P(-nmGO4ybHY}?KGR6IdN zI$c4ylvK9u_BlMC0=Dgz@Hs9Mz~{H!z9ae@fIcBB-ys#YgP4*l2(CVN1mLp6`wEB_ zKwd0%c)uIeHh>-8PXaj^;MYf8qS0PLsowY>rJ8gClH?6u2-^jKd4o+oAGfS&#?%|U zh4||M^9B7_3( zljeD#N^f#0CB3^2;xV*M}tsn8pc<3u-XS)^-!x zDrafj7XH>iP;z%Ije|Zqvl{7-hB}bHe&NEGP9ovWL~TK$N+7%!VkpR7K-FI%#!3Ij zK~5#)6u`X%aW2Rl5${4=333IHlkc*`XTsx$q|A&An|~wiIudmwJl6wx#kd}X+y!+z zP*1)@lF|id6CY;7mbTmeDe)fz{OoRh)*oc?5VkTnGHg{fh75H7B-4PU5s+7mZDcoq zst?#kb}Nt;0DHrqqV~;V`U+$l!g>N(*_Tbcc&3-+#7tT9%N!k+zO1Yo!?p+fy8-rO zRM%9c1d}1qFI&!PL~FhM;N1tXW!`X*VIp){{3wtk0GO43?==4e!v@egouHz3IScJ&_d01E%T}5Pi}kFRq%$my*<&M5Qi#d?|^_ z1PNBCng zEQyj`r7eiw3?M|)edb_aNOMfEv;gGTPtB+T z98ZcP0V}{9kl8>+KWlQIJJY{o?^bO@^SZcLT;bsZwJ8`AM&%$ zDqQ%?L}b4~)I-Sqvocx(@hiyJBEEv?*BHYNgug({1Q{nHw<-vp0C@;-T4H|>@{x!N zi0zxO0svadF+RiR$|Du(iE~RI9*+Qhx8!74#sGOm*vCswhnfV~$L5lR8B3Uau;dP+ zZv*(1YfZ4gi?6|w=8qmM{g<*@1J^QAECt+`5RZdACK2WGuM_@4#LUMGw-iIXJh({69TyAm*ay#{2p2-)kOK)wgaUj6?sY4s#ns{d7`A1Zr| z*~Vo>K|{d49b?@-;dZHnBwf<&+rZxn@D1?Z?7N(omDmheYQnueX>*caBlB{e86@*;m_ zd3_1uFtmCzRDBfIJ2a?FUgb zFBm%5{^y2v;eS1seB|z`#s@+_McpOMh_dp$;CVSJ@mMnH*5AL)xync7 z`2w+@DIb;RN09G z5=XPj{Rv^(_GhoX_yHfjH{s1EC*g4iEdIbpZbjrag^@ZID;errO-YN#dP1xtJ*yon z=#8Moa|&3e77F4Ss^Y5)k}fQabn^l}SoC>8^aFLHx9~+*#%~p79H-vdM@z{c3R9DF zW@tg$xI!qny~4EHDYU{^AKfQzj9`X(@^~UzQ0L{U_ZvM&+WB5wzf-hvgGa{w(f#NL z?6qO_R^2z{G3zpYgHN3%Q|{Y4m9t=dIW?b;WQ^-_aD`9OCzj3_|K~KiMg9F4ny9u5 z5VnB059DeQl@MK8U_$}76~tK}rzxNx#Ao!g^QIEBE5w6@-XOO9AhvADEC$$;c!19} z41OR%h8w=-4(~#IKfv7KgvYU`64)>4{c?w=k%_s(L*U;Zz?nESW{a1^jdh#2h&`t^ zl*b(baROWi1MVb<7eSr{Or7I>2CR)qkl{kHsq+Ex?*XPx!sCJ(EY45rl&aF?oqr4e zI)F{G+Un@?atoy2B6Vg!G-y>6e@Emzh%pey0jAFURGm&zhda!s&Me}m1Ex;G6mb>~@XM$8jx+e6r-D=R&W8e<5Jcg+2}P7ZG~(%oiYQfxP(b zxzM()@t^>HeRO+uq|ar37%LMl>^+mjXA^ZWY&!$??%tXuYu1L+{=32+|DiA(CdKMZwBcHl+5#K zYhKxVu@B*jlgH?n_T!bk?PnlBe#2lA>w8Q!enSm+4HlkI5Rc=2J1 z#q5-OO8$6dq<5?Skpv?Ed$;P*AV&iBZq@N1{w{0z<*yrkS?i7Z~{d#u_}*)Jo( zQoyoL7+swtY4(r9`xs!^zXq&ugM19`C9V6 zPh>CJ+}AVe%=}H0z`6Op8$35JKHl>xx3A;eY}z~9hs)&T>FCLHxVAuvO)Z>r@gKc0 z4ocSfXgitiqodg1@VF)qivMAThs>h-z9K4O3+`vtz%LLzA$kC=n6+$QkUl`ThM2uU z_5{kc0B+&MF~@j}fn~qqvGrfkh}2qm1nk2BTLvEqG72bZ>r>cWi*hNqr4QlddLF}* zjHMkJZYMpZz)2)N5iq4^f=mO-q;#2-E!o|t-HOB|2Y5n0X^?5;DP1OD>de<%Aqe{D z34umO#@Ve3z4L0ehwLw;-PYrH2q>uTt*nQ*viWDQ9p9y7|Ez!?dTCfzn+e>=nv8 zLTwM&Fi%psAi-kIk#Jpph_co&-v{=+02}7RKn?_Kn2!cI0tn6vwW`|5D?xz$cysbK z2(g#E4B3v6u|9(alf9nZ-te-E22Z#znNK?^7O;WQ5p;Wlq{f!o`FWIh&UN- z#z?)7A*O*$0qoT&L(&>bFpef-HF-qBrmi{g&KAFp9}+HCfW`cpNo^LL5AR%npS=|7 zxU~EUmXA{enM=d^uc4z^nuR2}T-m5f63$GDC23Mib0fUh17>ON1i3?mD(exD2LN9G zpr=0u)AZGJIrk&P8-%|q#)v-h9mv;!P2Bx`?Pe{39s;q_=PK~=0K0jY@ZxB;&9?GP?}bq>YYji@S$&<$|= zL!1jTN5mf?ZUnhP#BmVsg1ic3f28QylVUl%jm2YLZV;Uxc0Tq@MC)o^rUT^#g2tyJ zpdx;Tv8ss6-Q0p?C6Jh>pjlKEdP^r`Y! z3+)HLzI_v9CVHW2Ayth0Z%hq&k4y_N2>l`+{W&P9nGqx%2ILh}rs^qEwUntk29ELR zZmBehd3U_`_z_(Ei?8m#5P34<{6tgI+$Uork(4jU%<<_J?lTDbobyf)RGh5R1wlD9=#_mVWlxi5{6|#OKFZTQ!Y~;;-q#F4^#P~KS-ra|D5j_}h;Y^W@lipE$sE<~& zFNmXkgY!*0Yw)C)YS=q!1ZS4|l(ibX(QAB7#YfaMxZY|KRuFXuHL?hBn?nShSi^|e z4x%-LJ`Ch`h1eft0ATlS*Lrch&)8#WgWtFLfOC9%PlSCu5H#Kw0W+w*cZhQPL7YzT z48VrT_|R!R z+Te#4GtPreXQ)rZ@)VF)gq@+j0`(GLXQ=OhybaKA^m)$xVY-5(_Ib{42>-j{?DL!_ zooa;(_`Pkzu|yHCOYX(6w+}0oX3Va*#)Xym$*A6uNFwT>n9kU~PRs z`k>H}_d1Ald?XvDw?wCP1AC*xS;s1Gz|q-j? zA@X7|QCkwS31ByRMuCg~^s~36g)?LIT<`-4^gZUX`Ks9?v0CuW1Z-FAc90uIXjkkl zkY|Cs(%7z8^DUSO0i^0V$KAcAx(S0+zQ=s9q{_DSfooeJuNbp!yFl#(m~Gn!WG{gE zZPpP*!6{x)kYeO$KYg2do`mXcY5HQyXr;1mGdJ>ODhfI)_iOyOna9B}2C%oKJ(}|L z6c1m!eOJQtwzMGBrN{)KU|pOq|r;liCRM~yy2 ztw8>xK)5?ZQFnF?Mf?Gx4MYnd90}1IWGi5o<00I<8Pj)}WXPQ9xkmVubA1NXbQ7HT z9%218%#C3MQ3sG}Pl?$a;!=?FL~IA~I>>WCUTNH}gp~E5BLFS+&Zk5sTegz9Wqt>V ze219cuxtv1A4ALoIYY$v5O0CJ4CIx>xxpMKZpkQc{#uzvuU^O-QR-|3S$ zpF|7GU6n@8=P&U81Oz3oc{W@6+ohh7X|nrU$#ylV}{Pl`iPnLHcS7 zDB;Vb7|yf(R4WH5jcR2e{CfaF=D`9@YI;*6?TwwER!@R4``a%w!j;>;(1FMp3fR6- z!c~(p;ZOI44u|(p!1jes0y$oU_Jz&@ITPS#Z^LcqYlMkk1>WCvK6(Ml@53ax7`Dp+ zoA)|uIdtW>6ShrWR^b~g*(1qx^TI!&Wglz67ARhsFB`K55ZKKV8%cXJlxpVDwkp__rUc@8n7aTQ5A#He-6{ zE~|MpYI?mPC|TvRiH`zCV7O*HV4?ziar=b}TV6$BPb6wvl-mLbCqtY9axCC3hPWN% zPe9LWARc`%PU-H1c#hC##P$fp2OzJDcot&s-b}qf=^Th*I-EM+XN^&{Ux};t5k)N3 zUUjKH^H=sDe**g`)t8=^mkxNWl~0u^cg@CJftH$5P9lS20h>)O200I~+2kKS86Qvb zSR*eWolPEvcNq}RCRtxBb*p&0P0m$69~uS+cA(i>yB7B=Z%rldl5`c2SBy<1pFn*C z*i`Z($hQDf$(w_D<{74Yt|aa)h=$wZ+XL=Hh|VA#0h>y`O0)>(DZfgd7$A{NB|E{h z17K6hA3;U{d9m44G7jn(z^0NW55ASaA2O;TvK zFHjl{b=UYt?RtyB9hCDN84fUNN#5Q^t7`*3twu+ zw}+=2U}k(C$T>h>EM~^oTQL$?Nr@&jP%`%V$zp^5PHtu#-W5fixI&8Lt|9zNt?od;X0v)VAkS zF^9`NkL-B~cFNal$ql})W4ktRRS+zGJ}%cVE4zI5R@bBGFrwO_WH}Iyf*1y}kBE~X zE&@4Q#90t8fII=Xiy-Q4j~u`)hS(ouJD}$hh-+SqGYY3dyhP{=fZYy!*Q>zcgU6D3 zi}ookT}(DQ<$oXc)qq`&{Q~4Oz-|d9sW2_;rB6=#e}eT#fCF;f?)@&!Fu@X!nGA<3 z!)b73ci?0LuuBR}KpFuhKl!vZmlU!u#08`0cq~BtVFT?Q_}>PC%%;BYB?FBi!UoMe>e5ewcOqb3-yD$BMI1s&uK`&EV9cKOL+&ZI3Ev zxDHPz`0zjR&4Kdk3R}(IZ=hByp6_|SWMg3Slm}rLa!bkgX>2qBgUaJ=s&-OgZclkzm78l50o$>@FN$u*^M)5}lOc9pcTmH-s z1>rs{=p)DW4mMcyJ4bcRFI>3k&9tT*+rLu(4*=%aeh>1Q2>GR3^~GEO=H(s=GF*fl z+tWa%i;!b`Dabh@&`lNZ1c^H^dqQ=fJcyyJk_rycCssHkLxVH+f~Q%!E#g3*Fkdx3J7 zS9>{$7XW$1m{)rP)OCP)wReNu0eG+WVVJJCi8y(+&k_EV80FP|4)QTzUhTdZ1N}H@ zP=0u|?MP%^ZLS|R3Yb^BIY>7kFE;aPcY@j$Ft2u;7sGc%Jk~ars|}K|HzGv7%vjh@ z1k7?Ij4n-5=s}KB8u>E%ve0aR%X?n3d6Kq4@~98tJy249R2U|@UqXucK4K2My(Z}f3F~9bw|%V1?#jIA8MuJzv9y8` zANO|jy%n(9Nw_j8f8pYNmddHxc?kXo0IqO*v3>$dJC(fL+mp@~e4-NL~h0_5es zK;owX^Kzd|J73Vfz{}0_XT1cEdAY+Oh5~u9n3p>hY64(h?$scd0sPF%eJd52U}?GW zaxak@>KV&P@+4qoPdHtWV1;F$t~4t9O88$@R+%4sCbi36+}Q`q&wY$k*u#j8i;KcS zhd2I4NAU@sS1#{b?-yIawsxYQx2Okr=!*kyZg8pk& zIlOVzPn6-p)^|~&Yl!-u(!39Zw?iDd6YEGId=O$X$OI8jLtG3p57=cTgl%DeV91>5 z?kkW7h`I%Ezd|(G84Cs2=Jx$QYi$fOpYIhmz3>iXYIA#Yc-jEA(Q+2ZnIg2&aw*8g zKwfEVbNhCvYXRHbPGm;GFv;99-$)|0x&1RNp8~eIUA+sh69Q~=`vj09fV`5}=Jr!i z_W-uJeaA;uLGk8xmtC>DfNgH?0@722Hn-P+tOjgzdzCL*7)(W`Hn)qGkejS_em4*x zuNX7kJ40;=nCYJDb7Sw{W2JHSL29~hfOjzvo9@d!n>Byo=62bKaY8;yE*;q19xNSX zyPqWW<3L_9X1ia8dJ!<&y&7Z{;5WCgf$5psh|}iwuY`YNj1WC`XTuRN+g*_;5Tpb z5t=Y^Mc*eWw38i_Mk90u{L6u$WRz#CvE47GxjrZ5M}-e1y6b~BuL7~{R&0&!PEz6U zDOI8EPNJe9!3uS{73tn~kNP++UShj@c}-H=UHG9rxx{Nc18t;C+1%cn#<5!Y4n4mF ztX2}fOqwF+D^kAjwo0Q~X}$+vfB=F_|4(W(sp(C&xgB~XF~c6qds*q`b|o@80p|M;p0nzK1E?&U#m2#>$BmXBk`G&eYK=>gpJ(dXT06e9PuitYBoWB_A#0fek6tl zso$)s4Cdb?7) z;A_ozBgwA^tQqeGxf{^0aXsAM&QxL9pNTDjc$%1}fU*`4w%4{at?McnqkY1Bsp{G4 zH;Lo;Y6JEAGd4aRO_?F<*DD`6C;yyYq0`96ak!`qb`Q%RzLSRej;K{=vJ%KErf17z zFj;;u^y~=H!KbuKzzISK2OW^cDrQmEo_5`x&tDkfh0^qLMV}cxXJ3?Ownt zvI|Hj5gHFWf%F6LVN{GnGv4Irb>wKletIF$P88`d6{%J!wo@rGBRv1ouD0=*cgZV% za7FU&t5KnsQ~Zc8Z<}u1H%1_xO_z6HD+oT(2Xl{eoevJ-J~s}weN;X5S)B8Et|iYu ztrwYT?IT|#GR_0P<`Uo2b+S>4FG57#Jw7s44o&~dlZ~X3Vwb0x9IGa=tUY~s!-bvh zqtWD_9Yi(n54f!$&IOq%VlRltL6!k_kuZ@!n|N8i=7Q+`rt{=K>6Y-fu&)DxmU_oX zXV1yoe|DnxeUzVkFMN8%NCxlZpYYi$MmB+{0PGbbm2lcCM*0%6Enu%0838g(#JeOu z8DtEQ)hkAZ`8>iDtMZEJbt4DgO&)sP$Taw;NPylnaxTamz}_^H2;dzyWSzcgWI6Fq z0t_Ubbv&46GYBrdXykf{mS^z+Tz>=diZRdPOQ_EQ^DKS^`5C|>=tUzVVXC4U>}4aZ za44Dq_Og#x(|S#?21!YH*+{>8$WAZZ*b@HkfDN)YQ?(K-@6)6&8>xbKd%ytVn%lp?f?*yxp_oMJW3|QXUpI9M6Wq%vwb%0;-m0plu z+&+Y+(L6Ji@Oyl?-b{U*g~wk{*i0X!;TL~B!QM`p1i9cu+BfCf@>P z?-RDHv8C@LYO^QZ05H3s@Z>nxj`Jz>qJGv0(!9Do{M!LR$so@bdsCTKUhD3Z2GbF8 z6WOls^qIq~GglvE;MX~_e{2N3{U`z#5H$c{y8_{L5Ql<{5TTu;$siL%JP2_y$UMMl zcjtbPTYz0&g>ds$Pupd+As-5Q7&F=zV(^tQ~r#qkZD%>6!4E|0ol!5MyL-c4f4 z^+NmSJR6(iQfrzk+vY*k-=C;G$zW$7+zsL^5Iy}G{t@CukSBq>(zxRY>9jvZ1-3gC z!l^<>K^+R1&HKC0g|`CiMJ`ViwYcnlWXa}T1J5ELuNbp=_d(qQn9X|%cXsWBOxUb;-0x$#n z3&>9*WME5}>xuz>wxZc%i&$Iwm+I%KqV6r!WwoN|2HPfpt!PGgzA%^oU%H|hO8h>6 zt!O5IoCM^>Vk?@4$7SZ&|anNn$f8 zU!i6z$;dBlW_dBHPnkozd(!xP^8E~rW{f7820jsBkCl@4Gp*F{niPcl?0Qi9*^M)6iXf;KJ%<2`LkEKQ+!HSa#INg=L zD^XdRwHacX0AXW@%|P@uqp&T+b|Ae0*A-%Skez{`ct>xEwMGseQNQ8>*c*ixz>@CS zWKVVljbo^r_tmtZc!lp>irA_!BI$POf&=3SEnfEVRWAO+3i+#jg!re#5%IiLe26dg z$D0Ph<#9~B7_yVJWj;2;g6GdZA68KR@WIMwMPWWkw^crCYUR_*_fIAHwIE5R%10+<7$93MmXSh;VKs4Of!LjH(e$v2#O9;S-l4?@r7j1nP3HXh_;ASnLIJ5O4r z-9E9}}RNQW00{pK(d|IiRzUbLL{T-y8N#iAI1=J;pzL*sdXo99ml*^%?TdHz zU>KUb3t>7FFnOPYJSRf(t{R4s1@huIp>IRI2{;M;8szUlZUMFSMk@SS34bokul);R zbj_gKL0pUg?3P4tkgWlGZCjFvOZ_BDt{Ci0bbo*lUF`TYm7HLuRwZ#R+dPKgX|U~0 ziai0l8gURvHBj=EPi$8s?6qybq~a1R8T}F8<-1Yhr1WS~A0csfL7WUS2C%CgNitm$ ziW?~rkQ87VtWyAAfU@L;FF}H(1t7=olLDMgiaCH4;1ZCFfRYwIu@#{48mj$ms%qpj zw87sYZiZ(uU=Mp%cwQGIn6IcHdL?YM+h37wYj*hc@gY8S#rR2Bv%$aAa4?=PM%_aU zhU2rtXwS@-LX-e`vDt(3ZJ=5K2>Rt8VbIg(9tI8eL(qF+*_;)mZSYeVYzxknhID&F3>rZU;D$pS1u_K4>eXHQr&%Xh zQt-?p+5C==le6C6^#%N&0YUaw{QiS|q8hBePnCH*8_iInWw8B3f**nKNr>zr3^yQX zd=xtLp#WLR=#GZyN^n!ajfc1bWFC;y*IJMA8S%Ui2{KP*%eH$GdD{}DFTp$wgu6g| z4f3goeIYvjkud^_eLg3Q~#g8xPQKLD%XgeMo2>>pR~oJ588hx6IQkXhw*nL+#%z^W$UsTU+z zVbxTSiB-+T@Lvc7nb&LUrGY_1UPC>M_A%^a+i#6Dypf2jNq80D?uNJ%+0D+AASVk$JT^r`gpPF ztKKR`$AgD_s@5?H>%GtJ8<4fgUkx-49twi(2<`I>)v5c}#Ycb$8bEXd*#xk_L?9*Z$&Q+wvWph276GJ==reWkIx}~E273A`WPVG5n?{bxjsUW`Udr zd z8t~4)TKy=h`mgofxHLsvwk^lhh+RcO=+SR!-n6zNUf<~ehu5Ffc49=BT*j6i_QAwwop0{vVJ)V zWP}Ly%L_ry5utwhKFC{uHS$^#fA<10YUG}%(-p8rJ_O_d5o+XfK+XiLk(+t9fR}>( zA#UWqA;B8?YIv>!tdVa8xdq6J%^LY3sQUoh+59-|D+$&pskIaGyGx?X!`raG3D_H- z5=Ix)U~w9G2xb~Sg!k_Nhj#LW%A_I- zd(wlF8uz50>-D4xuR*PzG~5Tq#@~99nTe@8Bt|L0e3b+l%tSYJ1eu9%DB#yBWUWM* zU;~Mo|1nAQFB1H!L}n%~@HquRUlkQIag!KjCQ6T{%>;_E4qFM;0k95R1+qQBL6VFdPDq?&=G*! z1!6kL(IWPR*bzT}d%#Xm?(+JC!JewMcU-fUFO#cIQ1nvm;Xqz7b}eiH)Y*WYs5J7q zQEMJcRtM>c%363=1M!JUE6>IhmR!D!Tkg|Thr^`98rR}5>7bU&GGKK0nOBU}b`z*Z zfYo*dNE-kHKZ24?gsJaq#2o^$1L3{Icr3&bAR_@A?u+}!^~CX}^83=2ef@JBK?w2D~@}?sJaa_aJkZ*DXEJD7eyVYtAvLstJ}nuaNoLH9hH7N~<+zXLQ~Kur+7G z$qtTBouopOAB- z$x1TU3&c&<4Ef8+(=B6B!p>*f`^sk0Raw@$&Pydr=QH;s=Ptm`XSVTtyr~Ml^nB(E z;@<`Ad}g;3xV;19#bW0(M?xJ6*!j#kAhQ5vt!f;Yid?I#|LLO5S0YK(crR>s09K6& zpG#8|R%278Q8m5+|4NC^yt2V+JV@Kb-zg`TiS8m*sg7D~>9u9rpo&kARX#!5nna6) z$ED`5P>U-PE$W|$Od!at-k=t|(A!%jZR)>AG8$z=m!oN}p!gNft8-z8J*OcH&xUm{ zQWEYQ8wuMrz99S&A6RgFuZ}E9fa6bP^Y}zhk-rrQF1M6737QS1BxC znsv?gB|AiYN(Mq^+lD>M_79it95oJ`6jzrFiw-Oa2``TMh2~P0q0MU;@+IL=GOJf7 zlEMxM;=Jk?=H<2HP0~FP+MqO6qeNZUoSPMf1wnHaK%!cpWv-@1TBahcxL#nZhCxY(oHT5Wm;&}Tb=bMP zUP5EH>mDW*-KFKgvI?u#_Fe}ob`VsgJRSI^0S=f)c*E8LQd5v-PQMYxOmT3olGl=jqek7b&Uo?VDOFs9-zzG?tx$CC4IYkHW0_wXAB%<)O5fQQZ}B7Z|8Uo*A~3 zNf?xNlDfTcaA8gR((b9WD(7BFp9q4zH>C;MkUvM1X`^>&(gg*?xo;Y3Z5{{iCp+PF z*uRYQQuYsNnan;7QMdO!9@E4tF3r+WF9!g@foajCy7-c|to8+*6~Z?xmC_-TSh#}} zR%p?N7j}4G)PvWn8kJ>4tuSAohp6i)_K&_RM14BsMURvoro^FMqaZj;WoXj@{SWtz zThb?P+#?F;AQ)9Er^3>W_OhniC_K{Iyh9eFu8t75`cav1$C8o`nSo`oZId!bcjr3- zjK~hH>3JPm#DgygjJCU!=TQ)}2&)JcUSjB9e9Ovm$-rh$qd1XE?gf?!%YW?_+l z=@|wwHApwC(RN1YYtSapr2bB;2{lV6?PrE*m$$GpLq8N|)kN4>sBQI6C$@0fkS1q@ z)(DoREWm7L`^2mcEK_rx8OmB{_{|B^u3j?Criim@NsK$u6syj&lNeJl(IbvK2Z=Qn zN_m{CkOl+Gwr(lvy!G;tp64Sk9<2Ra#8NJ>ii!IRO;p!!If&3G$mwCZfFtgoaSQlI z8SzzxwZ})};clP^ykXG}im^XIz9{Gq#jl(%eZWk}XG4^fy^=WObi5}?Zy5`#E4^6$ z)M3DJzzpC{;4|Q#faSQwP_R(*c~QCkwAPc&J-Z~kQDQD*khpMw>q zTkJ)rik!`#XdZvu<@$4@{@klSPw3Ap{K-gO=5PA*slvWb{_qhB$j163@lNub@^I}G zwmE-_dI{^VKT^Z(C5#jQAj=_C;P9dYCn=e+!cNnlOZXE+s<>beFn;cA7e-N8)F{ip zY~Lt!PfZ0Y2RX_9R}j&%Dk^hN6jetp-2+nxMHN92L#4Dz{{}_P-Tg&j)JVkkh!~v6 z8jOfHVp*lJ@bV}JlFtr~>RW)TKe`O0v5C7FA)#X2yHiI;4Qn&jtIJp~>)xNbD3a(J ziHFpYm(RKnr&jq44_ZGuQ*^8nb_+Qk(OI7-;l7`h$qXylrnD?C$R#bG)x*5^jq~>N%va+a# zlgj%sQVnNa7gcXud3R5Q%U9lt;&74G-n|p6RC`u$?is!$tQ=#NH&k^Y^)fh$wusrN zuktu)yC^)WB1WxVmeEa2%U43RUZ$A#x%L!ksWN2UTlGT1D%}mIEUH%a?j0X+?I~3n za`Z{{j<@S!(2_cgwVDY{BVvXKFQ{N2&PDV8k?{X#`M$yH$k}K|h|5(+|KBZ#mfAD& zy|kJ-ZyGmG+bBHRx722;D!NHiwba8&GtDVzrtf^KoO4P=+)O|EfH}3A>3f>VH`F+K zRi(R99kN-piMwkGNK*}_swk)I+zOf2>|SMzmN3c0YgF0d^`aNRS)G5^b z-y>#i9c||Q9x)%*5i|Gqi20~aq0aw3Vm_&(&3V5^%%^q4oco)_*obG$GBiJxCuL-m(R z_uQ!j)*c2MQE$-bntA;eytTTzw2xas5&ub-4jaA-Lhx(b;uaN5OJmON_}kvc8h9`ppHCL8!r2k@~cM>zMz=a8=RY&onTf8^KilRWRMfFWL%YxVX5=%B+1bDZxl6K5jE5* zXt4FL1~ICE-8e>@ff_?!t?}^b=)~K*8>g>}dR4Ii#L&JK%+=z`T_-E8RrDf5r~vmj zOmVMlD%y7ZZOjX`BR_#aWD&0z|uci*Fv}m(R;Qy}lH?%qr(?owz zA92st4`=yaICBbFoV;lLOovzDP<<=RDgi+MJ~7R3!2)z7R*Bc;ipL7H*1?#;>JFx3<(&dX6J zH)rbT_w3k>>9^nih<+b?{Vv^*ejnB7cXNI8yMJ6A{l1yDG5t>bAJOj_uirfz(r-nL zezP#0RJSQ;P4IW~7HrF@$nPdyHqBO+gESjw-A&W!+ht{VC}FlVDmj$~iRa|{!$C)@ zJ>|?KoqxDl(=#PiI}^F6fmx9sr`c}98WA!BJJy~q-&aSdJzZ{O6^TvD>`(#d`v z_*>o78<}iJt4!{)$)>|e|BVjHQZ>@holhqYT|+te^v$)ImB|7f6FV$B)9c5uz8EKw zEa1z#PjD!$Iu}fyDJLCM|52uDL)@Bw&d6Gw+wNp;P}FE_lpE#^RW)S|-3{olf$3p; zriWftHbboRGlXV^Me(eViMOs^w=ObF4L8%w7|Vq%wK>hty{9R)EZ+Bf+;$^lOSg2Y z8SMscc~PzjLCv+3Ya{lFBDTexs^S5RtNhZWgGAYju=}NKHgCcPuSK}Q)rGRv?W(=B zc>Hf%8uoabxh7^4>rsDTf7LzB>_^1VToW1Ub>MxCr4)CU9I5E~Zgx1XiaZ**pO}mq zGyBOXFR$HYP;Mi8E;2f=P}`+$U-p08mQ~8{J|x;M9 zy4un<;C63hpw2~>IvfMx#dsh{e?MYxtgV##;zmX+dL79yQ8T=ZTJ;AqIZMYQm;Ku+ zn_0Wch9yXjajzO@&!}CqiZ z%9kl61zC<2i+2Ql-P~SV#J{PV(UK5X@zYw6HbzrBNU{CjbvU8t)E0f$e-fQ4NZGE+ zj;8l50&>;-sYc(do5@sSHgtH7n5gNzC>+b?x|W&of-PCEJ*187hB8u>8soXBo@1TW z(4D$SyV>WF#CEQ8S*Dh#UbcDE@Fl|L*~tz6nQrRIVYE?c%f4%DVT2DBFOq4;GAfVF zQhc(u?ogR6bE3$qOg+uL#(FiIbwvw@x=!gjq$!&OS4B<7l5e~^t&d;XC|eda zJP;|Ghb!HRx(&XO;fgJ9Vm2C6fPnpjs@keqi7%Fa^&QwQ~A(_#B4?CUrAN0HIr$i)ORv)8La zK;B(`iu{{l8_ph%$X#|yu0qjS_xF1A$L5wd-9PJYIN97j%-b@0+OZxKv~r#Sm)P`G#GQWl<8Url5SH9c8l&tssm<9Ncj)#Q7{Yn>BDm1W7C#8k7uTi6!w=D zatBq}%#dZ%!=2Buv1T{-Sgk#d?uG07-g4ir4mtZq@whg>WIvt@2dYX6q?~KdUdgHS zE^3|m@l=Ka8^gC%9gZgYn3UD-Rg7j(9V=zghvB7`hB^piipw!}nH79qTzxeKCu&`= zEOyY}P<`4}1Xkfu)X!Zvjp-PUqpGrl7O?>~Nmh=4S=P4o)r{v)#}AL1*;0`kCs8hU zY1DRJ73F1L3TCQ2sns$ZG7dY3N@C?Ad1n${%Xvp%SC3sTtuMXr+mzh2#o3xm1WdNt zw{Dt!09Vfq)9`*a=x%dw)*TjK*~n)X_zYcxTzB(O8cLmbC#*Dkv@e5OGCeo0t`ey~ zg#*%^CYf|Kn|B(`-4SUHh4_Zi5djP;Qp|P+c=|oAM3JEHe+K8oI_*Nt3eS z*PCVTQCIuTla*gn{B_#;lhxh7 zN6h1O#N73p#mKqw+B|_6n_+&^@mD!D%fIYF$yVs#vg~Lvb6ZGzrxrPk8Y!!;=-!=l znBy5!XC}9n%Cgm-`aRa>O$Sn;yf?Q%AeC)>4xmZe-B?-T& zn=tD>pEeUMbMvuN4OmxdcRJ)28YVBB)3Jb?i`C1yuPmeoaX-uFqP*&^Hm5SH%-*=` zZ7Tm_8@Xj}hN^r$JDBkc@+;Mmvd^GL=>DpTD{rp3B#tg}cVlMq*{99Eh3?ldSB1km zi_JC>RTV~5%=EH2eaprZqWg}{8!rVAMR9(bx>7QT$F$$GVbd;;E#1Bj-M6NFiF-D~ z{k~M8Cr%v{wS3wZ5Bm>VwkDHtJ(s^!jYaB?EUp@LkHsGeHUJ+JA>+sbellQMhJ`R4R(X3DWt+9}q}8(kAm zwzyhmHTJzvwTs14TWO%<5rI!rz5D)E#{Cj4wxHX z#Up@9&c&YLDu1-foTujHj$C>YWUJ_iRrIeWq0-G_J?0nD8vTf=$Bf$WBm!sI;yLd0 zI;op&4MjhTvX}UFzgWv_x)-B##Rh%9*r|La=b4_Hh(f71sqP_Pte(58xI0oBxFra& z@r1jhH5sdG^P(TX8B7lmy$k#J24&TE51Xu5%3~8#DU8ksQCJ0nCIc|Myqsa)p@16_CM9e8Oc5|-G5%T$~y;ZC(G5& z4%ebm$9CH53wvuo5|xfVGk@BW|0Xxe8=8FgleQh*Tj5HE#SPOiL~q(w0>0@7 z(>CO?kXdOD}#GJFnKj`G zs2Z|*K7z2k`(a9*5|2y^{J(v2t_GRqR5vT5!n(1e{VOyR%BQb$iQ)fN!ME`>7-Fy6 z;eMI9tEEu`_I^sE-tPRVgW|p9&$U`Plb*IG;h{U-mL1K@A|`$UlhcQX%l*b5-5Ytf zOJb)8v;8f&!I(cX`=}@^H#yguoEDlPG#X;>=QWMf>>0+eBwpXhwnf=ny%%+nmTYDN zR*YW)TSIqmUi&}s6}1a$-yfA#)M#^c?saD@_@10ZUud~qxgmAlHgyUfzZacK z=|V&Id5 L^$@fw&Q;h4DSVY*{Jb5PD$hNuxQbbpT_?Y>?hK&iOmd-Sf7!-( z!_AE0TR1p6%dutMwHr>4p-R(pA*WXQRo?N`1t)d4vud}CZHu}uX_wOMUdAwcLk#P9 z+>Dx&zwUSvy4GpmKkIIF|C<)@+YLYE>}G+4`lk4`u9%H91>Im+R;^he%T&L^tkx{; zj$_7|ZS6TNHo{pRYBAV-G;C_WBKO3Ub^4!MqXV{wCxzLWnme1ihd7>7FIz${i%QE1 zYQ&s^^#+bse{zs2-OSn}MSY-V#?h!KcnE@7N9A@OFz6ub>I7eye3Q3T^0b>~<9!?RLmxtNlGZ z30dp!%%ZK=l=wkuTd&&?!)#+X^FJ7`w7>m!+a(7kwOtxR?y?E%vg5MV%j^%a%nx6C z-9MSCKnN`~Qn5 zE<^F>DR$G+G-1|?2l`7Bmc&|WlZ1Uw$5{!UuJ$;tFT6GVCX;2~`SJJ|q@}klDd(B5 z)N~lxb5q&er(B2i=0H{+>vJaUtD#3L)@J)WptJ&Xe{(+h0cuHDc{|ra4Qxt zPoJu**;)t;iW>Gsfy6yL!~1VNtq{*^<&mte?~G?>j4KB{@$&))$7<)e)x873ebdA0 z*Z^!`HMfx&-1K~X>gYjwDD`;Og)Oy0;1s%%8&^Ti)*mN~tJ`K@@1_2239)kOOj4+M zPOY%(Ah=z+fLI~Bdq>2Uw{MLLlWhVmyFN`!)t*s!a@;5fC2bPdLsMPgOxlD6r8z0y zpZG+br?z9bu_jSwbJHgI+Bb z{-R5iO`4>~hMVLbb<5h?Z>&kA=M%+h673uQ>l7}zwA7Y0M*?iLMl{Im@l-TiKjpQB zE4r|SjP>#2jkHkK{b`)F&wng+<$8r4zR@xd+i;nG($N3yWu7r5Df8p_T1lC?LSbcm zCXCB`&$PJA&+r66O|P^v|7-F_$}IQsxm;Rmj<;I62ghrdDRhtLM|)b^1){5>hFtF9 zKwN!#sqKH;WvZ6;v;j@>6wRQx6@G8rF38Bu@hhFXwDawqRXO`yPt{!Q-WfmFrfWpl zdjiOh&;@X764#k{XZ|>wmEt-Lutc>>}luajM~ zDd)UfhN6DZ?gy1-cU(_N>o1(|hptIDv%4}nWoGT$Jd1z3nWen$vB_3k z-B-fST*BobYljc59m5-f;WE*;$i{kz_I~9 zO{Kd1yFaY6YL0dPU?a0;_~w~pbpWYXa+I28y2x^Al-H5EyMPQDxvz06xD?DINV-|k zPbJA>Z9;dhX+<9{@ zcVN<(NhpefY+Q6D2-cNE7ZH>MgcXDdmiZ5pnPeoHiBr;xOaufJ6GIV8LJ?F*kfwA2 zX#oWrgd(8mpn^RJs4VjT{+{TPBzng zS9gW5fRSIr17Jq99shDRQsJNoAt!Or6eDQgop%AvZ)&y-Z&P)|J)&}y!KIybxJw9Q zC~oJ@s@n-59lNCjTsAndYb-VcbOq_J9p3slyXvE`#7nhAi=x@g@|0T#yF6aDaEghZ zM;uayi;6#u&xu3}o?LzhuH@X_;yfOM+^=i&QW+8fuAR&FvyuHEhM9c0NK`hAM^maCJuF2SmfKSQAWAlYq1?m|a zH5~4*VDkq>`vfYoalptrA2>FasIx$8NXT9OGd%COJ}Y^{xI&ZLAs4*`#lL;lv_q!n z-wzAq9A+T_j%K;D8fLM6{ED}%TrUw8xtoa8(|1Ig493$uON)8g$t#VSR%B)k!(e9e zn7tHcMhN%_@UV<0j+&VX!XBk=T9s>>Hg&4fMBzl=rSs76mNYagniik-(5z^ngm$Yl zk-sx5D$(bPoM<2xI#-n}U9zi;UkKb{0-^k4Uf*NX?#hX7DuGGyj zY+@n-&eP3N+vxu6Bcr_78eugFhJ{D`3|DUsZ7F)Cw)hJOM0-MNSX{kDSO3Mb920!Pf0o_t6?LJWX8azxSbds zXe<-uVfHUk6A`;r1kjhG;Nc)g#G&9O)8=Qb*39m|mcN9FElB4lR%c^3cYV>Dd<$(XjNCJ5zQ?@{lwrr5!f9Q+UQA$=jkvIhou?r}<#2H5O)X zVKKUC@HsNM{81=|#K8h*drKD?Hqr$5YevesH%?_I@Uh2x3p0GyF=IZdNu-(Z8#+R9 zWQA8%8F>w(%=9C$>EAHI1ZlCHpPMQ-ziZwiX(?(hUW}YA8Eb)E!R%O9{)LiXcmt@Q zF>EF0#Ss8-`u37QCAoiJmmOL33GiOU8_4ydKj46wM~J1|_yS7s1S!HYHHMZ`#g~#A z=C-n7t}GuW>rgte81t|er`~{8a~UhU6viU+7=~b@fs)lyt8b9 zU&{_O$UaNQ+FUl)rR8H)-7Enfo3&p#G7W;bJScE6*d|A?wy;ld?);^wf-#wHUOF_H zDqt!@rZ+FELZ*)*`C~G@Nlu0eWU4gOie!47?*4rA+VIHqTdb={rl&1Uk?Bo}@k+?_ z8^w`_O{TXp!ry{Szd)X!$aG*#1v34y)awzE={acHSrmCJJH{X=k|I+n?Ac)+Egz;T z<|br%5?0F)WcqM++~Jbx7t0p-P&wP^uzaklo2@{mEG`SYl1+|aZDF6N zVmWuy^0;~gUJbjpz)vBD4A6-AyvPic14J}D{G{EO@*(AOA@_w4GjGyNmsUQ}9Yj#N z`w@jqv$a>@r)S}t31%Im_$dD1&akkk)gAa(v>uqq(Uptu|ET|uyvcQ~ABzN&h$W|hCKu)$N44L+N*RENzB zR{JV>??_4CpFd_suVCVGtYC-UPsb*kV%&Ik&`n0$lPbnOKcY*EynC5YhcZThnb&ge zo3>9N#2@$;Wi(8Z!Zk}DqB>y2Sx>U+O1g=y#bqaVCc%sNlH3hcQ5riV+HxE@t`F^gpG8{64=RCR#~7G z&U~JWW8KynzTIO0PF!uqWC#&5;2$I)qm>e$ueDc=t>&~Yv*g+-j@#DMgC)T)I@Zg> zgO?BW;1w(k@NxSi=PVl|BXpYf38m<+dWyS6LkultfrSpwt(J{PDW^V#ygj?3z-@%x z$gH0h{Og+-Pu5U$ zTsvm{WHNKbz_kb;M<-re9*1X_DM^0R_B-=1QJSfMI_~6FTBt7Icyt+o;<^0J`Nc6* zc8|ut!-M7LDX>KO3ze6tl=znjmco*1aH*#Rp8@66UPgUCNw6I!WMq5XD#9q zCTiU$OxnJk?;G6)-8-9vFRLvoTsB%NiFj>iAfR_+sN=T2`UobUs|=#^c?=F;HmzRD z>TyZacX zyetJR!8q@T;IZ$9+CPi=58dYRum|T4Yt7}XrT>T9ga!Z>t#e!R3f<2?Eh365$%{X| z=5oI6HFk2U&lC#mM2Y&S0b(icw8h@*|IBt`KJxnGTi|g9dxd*;yTD^sN0X=s1K024q!9gj}L1ei!mk5QB5FO8P^?j%=~}I`9`q1V|p&Q9Yv}U*JABvczlwZ!e_O z(%xwLFn)x|{2m~`l0j-G+6injn^aULFq>Yq-;C%jo)~lPd$Gct zs77{$$xt>OoS!@{JDat3HukOiogLZ@07;{Mt*GRl>C+xKDwTRP?bbahpB@UX(K(Sj zD{{53-qEl1soKK&(Ja<{?RKYFVWB6d7W(JytTK_r)y&aM_7 z38?Po#TyHjF>|?LyJ9*fxv{#~|Clh+UC4nc-}A-=4N>zd#`>3s6fAD0Jt_&KLK z0-pxD?h#nc1b6m!$|ibpG0|TaZWl-Dk!wK)yF=SRT_d(ZkpIderDrrYvLKSUgvX5v zCYeF}Kw3;m$A2d1M5cciW>_eD-hFb6#iyVgoxW6~+La{bU7MPk!kyl!p7dna2>ryr z;0_^*2m>!rbW}Gd@U{;`ui}{t- z4Fy6r8;bQ8uLT%Jyvi+*Hyl+pHE-m0R9@i}cc0{NQBl>@RXwg&t>ig&Hgs^50Lk$qyF_WT;W-*`$T^5TDRM6 zD|uf+o)?y2434HW6>fft=NZtgQthySE}MrJaoOndotL>nKD?qvEZhy*k*4raNXx$g z=ue9_7Xf6EP(NQu9)&8cnM&er<5C9rJxOvQbV7U(ah$~Po?D>5ge3NF7Gl18EMHgG zv_2sDlOam3Ubj(kh}@Yd@QJvpbI(&-2TTwe#*uMBy8KB=4HeMezAB>sd2(+zBD_F< zn%+Q6!$JRId|cLNQapA|AGrzbocv>&!W)yHESi23QKzVR#yy8}PWiXfQ_%y#N~GLf zY);yvn^KP|GaPv0^Rx3lb?8UsYRtJ0X(47hXrn1d+=YgsR!)C#Pn;+&asxHq6}NuX z-_jSiVQ6o|aD8!i2VdMLyiVc?)H~h&7<_T3#lE;n?m2{@{rDchQt$YMU3+WcnOa4+ zWqorKkBugD^KI;*TiaOFTE0^1ntPyVdymYY>rgV1|q;lQvtQ<`}eXN1QzOjS*A z-Ssi+OYu4m133nFIzAf04=*#67{u#%lX)G#FF}^_I-bW7U1i@vi^jQ!;i0?R;*xeI zwu$~p#p=sh!*kj_F*Fqg1>OAGiSIJ)vnz!a z^N({Wr=3a1PqS1^u=VmkA{2Cika!hG;%-#|oR{isEnP4!U3$hK06pkwiAV@5Q}y0$75#b zA{v3kIsRn%Mp2C%%DO-u!lCST*eJCEaPR8Q9HSxX-LIC(rL4cD)aY*lby3(blgpKT zsY|oa`jPPjn^>EIZLIA-;dOwN(p^d08ARD1zP1y*fum9OtERpt%D%KWz}QFmPhxpZ zpSeaj;9c&f`pf}>>#Q<|`VSyHs9+z2hbiCfqGMRjQy4y369C^%MsU6a8z6`=*#H|^ z#Y-~*dSl0X+5{*}-N2d3_kKJ3%dL}&_w|*vdxN&y-XN%QFoI;6LBN$uiHkfr7E@li zd;|LXQ&%~*lCnmC-5xONUzX;e2FwNpZ2S>Gx()d?qDpuF5?Okes09D@!iMiIkqON$ z*C3ZZ{{v{0@-~9VKWQ}B>i_F#)O|^n2Z0Pwin3Vr4+M3)%&aNIxq=NTl#r}-t;kuN!?H+}q zC(iER(Ane~d_um@te2{arl$pJ2$XcLjZqkRpClMuQ2N3Bz|!uts0Y0-GgF8nE2=o& zv~ufL<}S=EY+%F-Lt?2B)x<`X2JWXa-yAc6rXa*}?#1fvpR`X0aOv3pUhbc@|84G{ zYQD3Qs1uCG%JD|~49lP`@eHNIjVc(2pnW#pXe#k1ZUBpRn}vgwx}b=CP-8OhgnEV= zlSNlk{9S)E=}_-?QjX6^oKB{(!68CCSVgB3jx91DcXZF7dl40;&}4|}dDEeFB}*kIw&xq@Nrs%(uP=KP_CDRCa@QiQtAr|VKgME*zxBKMrqGP!a=^-e-X8OJ?kHB@Y=!KB6zKoWQ<_Zz;hBTtwbG9wyS zyQk`&72;kKy33P#!Nu?0)B+v@@UEsJ9+G_A4Bw7IMd-;ko`exKF|WexzfjCXrLZ;n~@DqbX1Jf6`)n6Cql3; zf941#smpJwHn0x^DGuu7@FRk~c{h>OK~NYmCSUR?Fp&3zwH$S%ge^i$KsD=UV^>NPV3T(0~<#lz;ok z7%dxFRktfAeP~qo9#FjSuY=)u1=OvK;}uYMq&SYHWJr=i^0Bcr4VSbJNyH9Ynu;)h zG1ixNkv%w~w|#}!KXSA~5g2juo-L_b;m-Ks$3k^EcY`lC7@zIHO7le1YJ$sr3g=I2 z*YZ?HpQHDaJyR{7q*_t=bsC~K+D#d9sw}^;LZk*1AdBQWAuEp!Ufw>bM>C1itbv?9jKruGL@z2%yGzGT@XjXE1KNt%BStW*rvpqce7g}d_?!{-g zySM?fU=+o}c%a=w)LSYDC$8R^D&k9xD~zPol<|d=6dp*&;Y{6JjKh%we6TnicDI^K zdj+@XB91>#uTy6<@s|d*X4IoEwdQK*882ZkUIDHQp)Ig?)A-Oxfs6J#_)YD z@D+F(1Y{P0M2_6$3$4}2dC9u6PobW#qxim*w?Uc;l;8jwn&5IZ_H+^k#Ik%a*~yWG z$V(K`v}EKbp0(jiPh3E1^0fQ?p>QWVlJwsOW%n8=uOdcTX%Fh*WvAFrh2WffHO%4D z^c1INjrKUs{j5*!7r)Dkx5p5z&)@6Y_5k3z{CBNG5FgCxai;eC@oDZpQk29*M0SGzW#5LKQru!x1hRuKtL5ZqE z?(OJn_HYPXQ@Y8%a>qm(ci`D(qR#@wPb%Pkk_wMExJw~0zID>|9;Z*>ebw*X%{^0m-ggu{ zHGWxTjO~08i*Nio*!a)c8(* zW5XEr&H98@Sd(Q~?3<-nH(M)B>qzm^?kL$&@5c6v=Z_^YR41jbM?2fU8^YgiiMLR{ zBg{xrJ`#06!HNKfo(TU}P8hbJkmi3lo*-u%%Nhwwz=J?md7WE$ofX_^@O3>*Nox{T zbeC|4UzKx*s)37Mf*{>LwO#3T_EY7<6mc3X%T@yxDKpIJWy3r# z9`Cd370Bk6P?7OJVs70pdnKw0?k{deZ?sp3r0fAJfp$gXOA=eRZC{1l8Cg3OVCWk$4#64!BXS68UHn-$#U_UOsI|Y z2Rzh6slcquzZ5v(wcF8ge$_@}ns=vm8aEqEG0lNWJN;4RwIw@cy3&f{7o_+0aOL-l zd(%Neh$;=3NN)2Ry1Ihph?u<5d~QMsa^F)<9)l2T@JwFfsVu+7h^~}yzg<3LmT=Pw zeqolWx2*n@%<4U!J-2wHe*T|`Xm@~_lCuBE2y=fLwA$=cFuPK>&?2okS$2%Pdn?jaL`mx z7A{=4gLN{8L;6#O8XDYry<`ybW2X>iwDUVn&ke^$#Fvcx5*`}z4ewi=^H38n-$hw` zu=4d*9dBnLi+MiZxCI2%Ujc2tKh!~G2|}}T8_jjqG%}BTl_OJHp;?_XF$` z4}hzgxAMJQ+|UY}H|E$IyXuYE_D0is8lIsBX{YWJO9he0{fXQx*6}K=)13RDe@Hct8f~{^O;v=So2kxdq^@*&g(jr z8=yYBQdlE*%rsSqbg#9&A7y*Dwfq|&Nz1lvXE(dW^Of6mfj$^lN+z_BP;Fcg;KIT5 zsycV?lBtHXd3Uj?#rgFrEAp{bQq$a#YAWoe7K&$WtI|pD#F{ix0Qwz6t>fFpvQLy) zNs$S4F6>y>lP5OfgUxc_)Lyf5#Oh26VYuGSO;UF5Ul;XC3cL{{SlWJFRQF+hkb?L$ zjDb+(Bl)=2B3AfUB~EzS5Z9_JD9}##EZe(o-4}Cz!4XFJvm1c)u4EmNKtVL88=za3 z;$y#1t9V)cEeLQ7pH=HrN>`8rr}v79+A`wKRIo*{-l>rZsi8>*+@(vHEaV3LfLpdW z1MXrU?4!HUVg}qM4jerTbvr~BRm=eTxI6;u2^%7;+6>8`+8Rch0~AWim_iz-z@=u6 zT%(eI=w({@%1xjsxk;;V9buQy=`fLSJ6GXCqS~Y3+N}wvnP)~Pv1x@QOJ@I8*$;!! zR#s+{>s1@B;eTSu4-Ap&8J=B2FK7^fUUDFLw{XtgQoB(UWfuQj) zBv7kzQsC8qMA-ky@}$5g_yLHqL^nlAfdFxWyOd*60)Vi4%Q9|0M;+z$LSSa*(;4=` z!y$>FQKR!(-?Mh9cavD@f3>s zzW$`>Ul)SMOQ%M!UmQ(Yz)OX1Hb(!-0;d?R@`Z)b^X~`Y8aaPiqtXGzuV2U4s^;r2 zLW$}Kn@lUiE6vmjU!lal(K^2wJGiGu+c3=mEVztr zDv(L&KK$1{=#Tmv9z!0ep>RX!gl?qf=yh+uQzmPbinADg+{cNOJn2e$veiyzWq{`>Gl=K@O{F@EISIq+BG9pB6iq!5Gd5u{?f2WVb_%osuT6DlBU z+0}h1XmfOO7Df?*AZ-o?9<;f#Bqv`Lq_nEmeHbD+_gme3HnI}0h!8}r-R{Lzj)>{c zV*gnpP8l^knbJj!^-rbe34_&3VVAv4OK9D@r80+9MAxUN80*|xlOu>qrokP{<81sS z73UsSBf&e~Szl@Q?`t;1`8elMJjV{^>$L?c@|xOl%VGh9LhIWpCT&l5%VMF9{xEd>~uvSJ1|?Rm?01-+k30R)P7Cl@J+g zQbgF=bQH6+z@=LGQfk%JM#%UXikwtDGyUw23W2ZmpCuV4(zfqf5fZ(k+=m40iK>sn z!#lVeslXNcDQ{m%Si*$09Q7Nf)=nX}B=3%xCce^Jp;F4lrW+<~g>#7`(vl)}-=m6* z*PPD}GrzjXH%6XDzZL%eW|YwAO-40721;q7teXv}7_VV|W!fvL zDe;`wV=L5@P|oE@N~)yhjoePYq{_#|+s1n(++H3`t^KD(5 zX%I4EGSqQ{k8}e7`=+?HLxC=lFp6(eZ>1nq*R4{Cco2d0^WV>}nrgjma_+DEjTigm zF#|@$l;d1j*ipsYbM6u8=3tPov%W!^qAv|C$4gup?^GTvt1usJZ^U@7N`9g>+6?#C zErt)rZI;3Rj`F{O}ZMpmEFc7S!{HBGL6>i-Q9%ie)+JZ0X@U&zRjPF>M zyHnI~B>xn4W}>IfX8;jPY!}OMo~@K}I9M>sL#Rz7JbBWm19r5Pp&@Ore?t%H%NIR;FYH|pJI7jNb_l~|zLE)qI+%>Hzl=1q>B8Rl^1 z!ijDGNi{=V{(9StqVlz=y8Ovmui$s(;K`Dsx=uh(Pbf3XohO{b!NsmcQ|VnZUUAn- zaRz!q4)2=?V3>d+;IIp{m=Z92$Db~igd%hkNEj}7Fx&|k>hj-_#LzXc9!jEgVcl!6 z;w^rYN&i6tJv`{n7D5@c3mwKJlAWKJh5q_-=x0TLaC`Z2;HIs|5-ub^OF7@ZdbF(-!$S#6+`>!~r z!Q&}Ps~-IAWbuN5-810MDTBeE%ZJIzl?0Tjs_QQnhgsuS^QWPPNmc`9Zotg}KPAa< z$an_%SuF@+nuqG?V6z05HzodPv7mpCkdl)u{BmtmzFmxhQ+Hni52VZ)ciAWwW9)J> z3#Ot$7GLkoA{uY`^_Nr?O+onbB8206i0l|5l%Wsmg=84YKW5i73bEVc3s>a|rWL_=NP7TQAlIZYus_if-tsp% zW^4egGgcq`wU;SKsyqi+P>OFh(jh^4_dVo)C^4)g=D0x3S(8B&jNkJpl_wMW$4lGu zGfj#iML!qic1~-nymwfT4R6T8wLgnbdT0{)?=cV zxto^GxQ;Ji2=XLk8N!U9(&^fhD&Etw3;(Zjgs8G`Ln(0>Y`&QN4_|o1Z-YZAcChB9 zu>%!q_u)-LL^!1G224GIfde;U9DcqqE@7-713J6VL`DW@BCDSFXJpa)V8q9XqzJ#c z%g6MWEMK)#QnHkn*zTX@G!aEg7d&}!kum*wJM%`HktC_jz|8QMf^Im2$d)PW@|K$* z$X6D+Y35}TAYLI!%svq!_3q#dR}ZT8xw0t|5L{MwO?h42zz^0~JK~HgJxiK3cjEbd zvP5~#P`CYwI>fuPbXGQ>dyKn&<4>u}0?$~^E+4Uq+-_&z6WqffRn9d|Re@isL8kT9 zPmgG*aQ07XWkn$!MIWFe0PU6GSc^(Hl67CtDx`xfb*%e2poO+Lw$Cr|Bn%nD%5(1b zE4YF6rxp(F|J@P#;87VhIZsg4PIN*1TB2P`m zW-)N#Gn4#tzrYiYoH}QFA2ph%tO(f?#@he1L}WctX`(oaQVdDP{?qWIJma}DmvUdo zOzh@YEHUR^kf~j)`8{AYzf*}2yz~!ZJ!#D^q--bCbZ(KESPZcM(8r~cIeFt+^B9Oj zo`;P}_=n1WkV2!1$h)}n#At>upM! z;?VKO`|1839e?JSs2(&!yrh=Iusi-l=@Jk3h7u3-`~kOoiHCdHC-$TI0P&r#FnX`A zFseQb+>-AfO?nS-JCvXt*i^dR4=<3@u!al1o!0VwJ@m0=u=YOy|4`_KgMDDT+)lV7 ze8-}nl0-37D7gqF$)p2c{>b6>2F?ET5gT5Geh$~|W9@aSCw+49>MgAeB6_Ww&^b9! z;^gbHFyAi@TZ@u&KE&t#$b_>+4uVVG z8(Jd=*8S7sGD9(rGlm)~5l`A}y?a8OY*y{R?5OgbaMQc`+Jjb|tzbOdDl9L#{_2~3 z1WerYiIY_)B;B_s9iO6?)15|dZwQOmj%?H@JX&$0&^8fGa_XwdG?rrBD<`bkajaeCH=$|omrg{!|eCVv|-x|3HLA&60z z^|IdsPQI&(D+m;mD9^5DSktX>eds!_l33}s^+;zK$gWPpQz}=|MjefV`#io;$MM%l z5EH)aTbIABWDt5u#dic1dY4PGPv(tt&97`Vd}E}h_d8{#a4kWA3XNw=aq2N^`cs^G z{2KJCv{$YvPr{I0Pka}~=%*fS<(1cNi^?k{WRj{qQqnezLRjzgJ}B!1#wOGRO!1WL z_qH0H&QKl2*e|>)-7`$o0}rcp1KF~~s`P?SpH}Gjo+QI~^O{v?TJfoJsTsXyMl?R| z3!OPv&GY&ot`X_ zZKA@^80icD;D%Q%y*u}^S4312` zHT8P+qFq2)DGgaGJiDnDCNBln0SV2+l1&i$Jr-opKc#ym5O`N7zQ5HfZsCSQ8) zRjox;PKFV~jq0Y-gwkZqyLp;!30&qZQ}f$OmOGHL|Ciq=kJmn}0KnC3#`zynBY5ZDLy8yD-QI z#NOG>ASV|YKSv8+1AM_2wL z<@$3o3Cqo0H(K~#OKZtx!<7AA4^SQbazPCY>8t0M@7;6&Z`fn@3c&RE`_J%FDu zVTA+W-eLsjT<`9SBQ7?rN*%xtYwQ5NIa=s{`tJ<==ZAv+XGR2;i1ND`=)bV61p3ca zhW_aznue10G4#($L;ooceO!5!eMw8gnO=HsLz!sc?0o?FJT zyyV|tE+#LbUso#mHHVk{^ps8u{;y%13?}%0AbB1O{?}F-*2`!DGty#zQ?+3g&CibL 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

  • {html_escape(file_name)}